Skip to content

Mutation-scope health - #282

Open
davidabram wants to merge 5 commits into
pi-mutation-scope-integrationfrom
doctor-mutation-scope
Open

davidabram wants to merge 5 commits into
pi-mutation-scope-integrationfrom
doctor-mutation-scope

Conversation

@davidabram

Copy link
Copy Markdown
Member

No description provided.

@davidabram
davidabram added this pull request to stack #240 September 18, 2026 21:37
Document the need for `sce doctor` to surface persisted mutation-scope runtime health instead of exposing only hook registration state. Define the shared status contract, adapter-owned classification investigations, doctor rendering requirements, and validation/context synchronization work while keeping recovery behavior unchanged.

Plan: doctor-mutation-scope-health (T01–T06)

Co-authored-by: SCE <sce@crocoder.dev>
@davidabram
davidabram force-pushed the doctor-mutation-scope branch from e7c457b to 67cba70 Compare September 18, 2026 21:52
Define shared Healthy, Recovering, Blocked, and Invalid statuses plus a per-adapter reason and detail record, and register the new module for upcoming doctor classification work. Record completion of T01 in the doctor-mutation-scope-health plan.

Plan: doctor-mutation-scope-health (T01)

Co-authored-by: SCE <sce@crocoder.dev>
@davidabram
davidabram force-pushed the doctor-mutation-scope branch 2 times, most recently from c44dc97 to 4e89f39 Compare September 18, 2026 23:50
Expose a read-only health classifier so doctor checks can distinguish healthy, recovering, blocked, and invalid persisted mutation-scope state. Treat unresolved recovery attempts as blocked because the recovery barrier cannot self-clear while attempts remain, and surface state read errors as invalid.

Ref: context/plans/doctor-mutation-scope-health.md (T02)

Co-authored-by: SCE <sce@crocoder.dev>
@davidabram
davidabram force-pushed the doctor-mutation-scope branch 2 times, most recently from e0c6c1a to 335233a Compare September 19, 2026 00:18
Surface Codex recovery-state combinations through the shared health vocabulary so doctor can distinguish normal lifecycle state, self-healing recovery, persistent admission blockage, and invalid persisted state. The read-only classifier is backed by behavioral tests that drive real admission, recovery, and failed-cleanup paths, including repeated global denial for unresolved attempts and orphaned flush reclamation.

Plan: `context/plans/doctor-mutation-scope-health.md` (T03)

Co-authored-by: SCE <sce@crocoder.dev>
@davidabram
davidabram force-pushed the doctor-mutation-scope branch 4 times, most recently from 485e21f to 41da859 Compare September 19, 2026 16:31
Classify persisted OpenCode adapter state as healthy, recovering, blocked, or invalid, including stale PendingStart and structurally impossible PendingAbandon states. Exercise the real dispatch and recovery paths with focused tests, and document the state mapping for doctor integration.

Ref: doctor-mutation-scope-health T04

Co-authored-by: SCE <sce@crocoder.dev>
@davidabram
davidabram force-pushed the doctor-mutation-scope branch from 41da859 to 2eaf705 Compare September 19, 2026 16:35
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.

1 participant