pi-multica-doctor

Multica workspace health, one command.

pi-multica-doctor is a Pi extension that runs read-only Multica workspace diagnostics in a single compact JSON report. It checks auth context, CLI syntax drift, registry table integrity, feedback JSONL well-formedness, and stuck in-progress runs.

This repository currently ships a walking skeleton: the multica_doctor_check tool and CLI expose the stable JSON contract while probe logic is being added slice by slice. Auth context, CLI syntax, and registry table checks are implemented; the remaining probes are still being added.

Install

pi install npm:pi-multica-doctor

Install into the current project:

pi install npm:pi-multica-doctor -l

Usage

Pi slash command

/multica-doctor-check

Pi tool

Agents can call multica_doctor_check directly. The tool returns JSON like:

{
  "checks": [
    "auth_context",
    "cli_syntax",
    "registry_tables",
    "feedback_jsonl",
    "stuck_runs"
  ],
  "pass": true,
  "fail_count": 0,
  "failures": []
}

CLI

npx multica-doctor-check

Development

npm install
npm run ci
pi -e .

Scope

• Read-only diagnostics only
• No secret handling beyond token presence checks (implemented in slice 02)
• No auto-repair or status mutations
• Designed to delegate to upstream multica doctor when it ships

Related docs

• Vault PRD: 4_Project/OSS/pi-multica-doctor/Docs/PRD.md
• Incubator decision: 4_Project/Multica-Agent-Strategy/Incubations/2026-W27-pi-multica-doctor/DECISION.md

License

MIT