Skip to content

docs: correct top-level /health status values to healthy/degraded only#192

Merged
jack-arturo merged 1 commit into
mainfrom
docs/fix-status-values-unknown-20260622
Jun 22, 2026
Merged

docs: correct top-level /health status values to healthy/degraded only#192
jack-arturo merged 1 commit into
mainfrom
docs/fix-status-values-unknown-20260622

Conversation

@jack-arturo

Copy link
Copy Markdown
Member

Follow-up to PRs #183 and #185 — corrects an error those PRs introduced.

What was wrong

Both operations/health.md and getting-started/quick-start.md were updated to list "unknown" as a possible value for the top-level status field in the /health response. That was incorrect.

Verified against automem/api/health.py@ebcf5f16: the endpoint only ever assigns "healthy" or "degraded" to status:

if not graph_available or not qdrant_available:
    status = "degraded"
elif sync_status == "drift_detected":
    status = "degraded"
else:
    status = "healthy"

"unknown" is the initial/fallback value for sync_status, not for the top-level status. This was flagged by the Codex P2 review on PR #183.

Files changed

File Fix
operations/health.md Field Definitions: "healthy", "degraded", or "unknown""healthy" or "degraded"; Status Values table: removed unknown
getting-started/quick-start.md Health field table: "healthy", "degraded", or "unknown""healthy" or "degraded"

Generated by Claude Code


Generated by Claude Code

The previous audit PRs (#183, #185) incorrectly introduced "unknown" as
a possible value for the top-level `status` field. The actual code in
automem/api/health.py@ebcf5f16 only ever sets status to "healthy" or
"degraded"; "unknown" is the initial value for sync_status, not status.

Flagged by Codex P2 review on PR #183.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FZm6MjhHYMw2kdTch7hXmV
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying automem-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 917cf32
Status: ✅  Deploy successful!
Preview URL: https://4d5742f4.automem-website.pages.dev
Branch Preview URL: https://docs-fix-status-values-unkno.automem-website.pages.dev

View logs

@jack-arturo jack-arturo added this pull request to the merge queue Jun 22, 2026
Merged via the queue into main with commit 72ef2a2 Jun 22, 2026
4 checks passed
@jack-arturo jack-arturo deleted the docs/fix-status-values-unknown-20260622 branch June 22, 2026 17:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants