WIP: Wave R4 — akh doctor (read-only, 7 sections, --json) + akh seeds status|apply + errored-akh lifecycle + stale-help purge #252

Draft
toasterson wants to merge 2 commits from claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections into main
Owner

Anima work item 019f85d6-99f8-7771-a98b-f4abba3f1190.

Release-gated. Wave R4 of the akh-medu bring-up UX HANDOFF (effort akh-medu-bringup-ux). Depends on Waves R1–R3.

Scope

  • akh doctor: strictly read-only; 7 sections in dependency order; ✓/✗/⚠ + remedy lines; exit codes 0/1/2; --json; useful even when the daemon is down; onboarding wizard stage 1 consumes it.
  • Seeds: fail-closed at birth, degraded-but-visible on re-open; akh seeds status|apply as top-level verbs.
  • Errored-akh lifecycle: fail-closed akhs surface as POWER_STATE_ERRORED; akh wake is the retry (no separate reload verb).
  • Stale help-text purge (enumerated list in the spec).

Source documents (Anima doc ID / Seshat corpus ID)

  • Spec: akh doctor019f85ca-8ebf-78a3-86e6-3141c60a94ef / seshat bafdbcec-a44e-410d-9de0-6a00db6cdb2b (slug akh-medu-bringup-ux-doctor-spec)
  • Ticket 10 rationale in Decision tickets bundle019f85d2-183b-7632-b1f8-c06b40fe401f / seshat 2fa0ccb7-327f-4075-8302-6a57091dedef
  • Orientation: Factbase: first start019f85cc-c6ba-7b53-a421-61ea048cb80d / seshat 63bcf279-72b2-4165-a2b0-00d25feb714d
  • Slicing context: HANDOFF019f85c4-8459-76d1-b496-fc3d2f3ee4fc / seshat 9760b5f1-7aa9-40db-974c-bbe0d923dca6

Local backup: scratchpad:.scratch/akh-medu-bringup-ux/assets/10-doctor/doctor-spec.md.

Anima work item `019f85d6-99f8-7771-a98b-f4abba3f1190`. **Release-gated. Wave R4 of the akh-medu bring-up UX HANDOFF (effort `akh-medu-bringup-ux`). Depends on Waves R1–R3.** ## Scope - **`akh doctor`**: strictly read-only; 7 sections in dependency order; ✓/✗/⚠ + remedy lines; exit codes 0/1/2; `--json`; useful even when the daemon is down; onboarding wizard stage 1 consumes it. - Seeds: **fail-closed at birth, degraded-but-visible on re-open**; `akh seeds status|apply` as top-level verbs. - Errored-akh lifecycle: fail-closed akhs surface as `POWER_STATE_ERRORED`; **`akh wake` is the retry** (no separate reload verb). - Stale help-text purge (enumerated list in the spec). ## Source documents (Anima doc ID / Seshat corpus ID) - **Spec: akh doctor** — `019f85ca-8ebf-78a3-86e6-3141c60a94ef` / seshat `bafdbcec-a44e-410d-9de0-6a00db6cdb2b` (slug `akh-medu-bringup-ux-doctor-spec`) - Ticket 10 rationale in **Decision tickets bundle** — `019f85d2-183b-7632-b1f8-c06b40fe401f` / seshat `2fa0ccb7-327f-4075-8302-6a57091dedef` - Orientation: **Factbase: first start** — `019f85cc-c6ba-7b53-a421-61ea048cb80d` / seshat `63bcf279-72b2-4165-a2b0-00d25feb714d` - Slicing context: **HANDOFF** — `019f85c4-8459-76d1-b496-fc3d2f3ee4fc` / seshat `9760b5f1-7aa9-40db-974c-bbe0d923dca6` Local backup: `scratchpad:.scratch/akh-medu-bringup-ux/assets/10-doctor/doctor-spec.md`.
Wave R4 — akh doctor (read-only, 7 sections, --json) + akh seeds status|apply + errored-akh lifecycle + stale-help purge
Some checks failed
CI / publish-chart (pull_request) Failing after 12m35s
CI / check-seshat (pull_request) Successful in 19m17s
CI / publish-chart (push) Failing after 20m41s
CI / check-seshat (push) Successful in 21m44s
CI / docker-seshd (pull_request) Failing after 28m0s
CI / docker-seshd (push) Failing after 28m52s
200872f7ae
Anima implementation session.
toasterson force-pushed claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections from 200872f7ae
Some checks failed
CI / publish-chart (pull_request) Failing after 12m35s
CI / check-seshat (pull_request) Successful in 19m17s
CI / publish-chart (push) Failing after 20m41s
CI / check-seshat (push) Successful in 21m44s
CI / docker-seshd (pull_request) Failing after 28m0s
CI / docker-seshd (push) Failing after 28m52s
to 79b6cd16cc
Some checks failed
CI / publish-chart (push) Failing after 21m45s
CI / publish-chart (pull_request) Failing after 19m12s
CI / check-seshat (push) Successful in 27m50s
CI / check-seshat (pull_request) Successful in 29m17s
CI / docker-seshd (push) Successful in 33m8s
CI / docker-seshd (pull_request) Successful in 35m8s
2026-07-24 10:11:53 +00:00
Compare
toasterson force-pushed claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections from 79b6cd16cc
Some checks failed
CI / publish-chart (push) Failing after 21m45s
CI / publish-chart (pull_request) Failing after 19m12s
CI / check-seshat (push) Successful in 27m50s
CI / check-seshat (pull_request) Successful in 29m17s
CI / docker-seshd (push) Successful in 33m8s
CI / docker-seshd (pull_request) Successful in 35m8s
to b066fd79be
Some checks failed
CI / publish-chart (push) Failing after 8m55s
CI / publish-chart (pull_request) Failing after 9m47s
CI / check-seshat (push) Successful in 9m57s
CI / check-seshat (pull_request) Successful in 9m59s
CI / docker-seshd (push) Successful in 15m48s
CI / docker-seshd (pull_request) Successful in 15m50s
2026-07-24 11:19:22 +00:00
Compare
ci: adopt exit-0-free chart-publish workflow (Solstice failure fix)
All checks were successful
CI / publish-chart (push) Successful in 13m58s
CI / check-seshat (push) Successful in 22m31s
CI / publish-chart (pull_request) Successful in 16m53s
CI / check-seshat (pull_request) Successful in 19m16s
CI / docker-seshd (push) Successful in 27m48s
CI / docker-seshd (pull_request) Successful in 24m11s
838de2721f
The publish-chart skip path's mid-script exit 0 is mis-mapped to
exit_code=1 by the Solstice runner, reddening this branch's CI and
blocking merge. Adopt the develop/main if-else fall-through version.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
All checks were successful
CI / publish-chart (push) Successful in 13m58s
CI / check-seshat (push) Successful in 22m31s
CI / publish-chart (pull_request) Successful in 16m53s
CI / check-seshat (pull_request) Successful in 19m16s
CI / docker-seshd (push) Successful in 27m48s
CI / docker-seshd (pull_request) Successful in 24m11s
This pull request is marked as a work in progress.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections:claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git switch claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git switch claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git rebase main
git switch main
git merge --ff-only claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git switch claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git rebase main
git switch main
git merge --no-ff claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git switch main
git merge --squash claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git switch main
git merge --ff-only claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git switch main
git merge claude/wi-019f85d6-wave-r4-akh-doctor-read-only-7-sections
git push origin main
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
toasterson/akh-medu!252
No description provided.