desk-doctor
Run pumpgrok doctor to prove prompt SHA, skills, roster, registry grants, and effective mode before any trading claim.
SKILL.mdskills/desk-doctor/SKILL.md
GitHubDesk Doctor
L1 - Summary
Run pumpgrok doctor before claiming the desk is healthy. The doctor checks the installed prompt SHA, the skill set, the seat roster, the registry grants, and the effective mode, and it refuses to bless a desk that cannot prove paper-only operation. No ticket moves until the doctor passes.
doctor exit 0 -> desk proven: prompt SHA pinned, 35 skills parse, roster grants hold, mode == paper
doctor exit != 0 -> STOP: read the failing check, fix the cause, re-run; never trade on a sick desk
L2 - Method
- S1 - Prove the prompt: run
pumpgrok doctorand confirm the installed prompt SHA matches the pinned SHA in the receipt. A mismatch means the seat is running unreviewed instructions; stop and reinstall fromprompts/. - S2 - Prove the skills: confirm all 35
skills/*/SKILL.mdfiles parse toSkillManifestwithname == dirnameandmax_side_effect != live-write. A parse failure names the file and the field; fix the frontmatter, never skip the skill. - S3 - Prove the roster: confirm the seat resolves its core tools through
desk.briefand that no seat resolves a tool outside its roster (PermissionDenied, never silent). The roster files undercontracts/tool-rosters/are the only grant source. - S4 - Prove the mode: confirm the effective mode is
paper(orresearch). If any check reports a live path, treat it as a failure: halt new tickets and escalate to CHIEF and RISK. - S5 - Attach the receipt: store the passing doctor output with
desk.receipt_checkbefore the first ticket of the session, so the receipt chain shows a healthy desk at start.
Failure modes
| Symptom | Cause | Action |
|---|---|---|
| Prompt SHA mismatch | Seat installed from an unreviewed prompt build | Reinstall from prompts/ via scripts/assemble-prompts.sh; never trade on the mismatch |
| Skill parse error | Bad frontmatter (name, bots, required_tools) |
Fix the named field in skills/<name>/SKILL.md; re-run the doctor |
| Tool resolves outside roster | Stale roster or code bypassing the registry | Refuse the run; reconcile contracts/tool-rosters/ with the registry |
| Mode reports live | Misconfiguration or an unmet live-gate precondition | Halt tickets; escalate to CHIEF and RISK; stay in paper |
| Doctor passes but receipt missing | Operator skipped the receipt step | Re-run with desk.receipt_check attached; unreceipted health is unproven |
References
- CLI:
pumpgrok doctor(health proof entry point) - Skill contract:
src/pumpgrok/core/skill.py:32-52(SkillManifest,SkillPermissions) - Rosters:
contracts/tool-rosters/bot-00-chief.yaml(seat grants plus core merge) - Gate G-7: setup and doctor gate for desk changes
- Companion skills:
verification-receipts(receipt chain),pumpgrok-setup(bootstrap)