Workspace Doctor

Doctor is the diagnostic layer of Workspace Intelligence. It checks each project in its real workspace context, then explains what passed, what needs attention, and what can be repaired safely.

For one project:

npx workspai doctor project --json

For the whole workspace:

npx workspai doctor --json

Human-readable output is useful in a terminal. JSON output is the durable interface for CI, the VS Code extension, and AI agents.

More than a health score

Doctor records the evidence behind each finding. Depending on the runtime, that can include dependency security, tests, formatting, environment configuration, containers, deployment surfaces, migrations, health probes, lockfiles, and native quality tools.

Every repair capability is classified before execution:

• safe — deterministic and low risk;
• guarded — requires review or approval;
• breaking — may change compatibility and is never silently applied;
• manual — Workspai can explain the gap but cannot make the decision for you.

Graph-aware diagnosis

Doctor can use the current workspace graph to explain affected projects and related surfaces. The graph does not invent a diagnosis: source proofs and runtime checks remain the evidence. Missing or partial extraction stays visible as an unknown instead of being reported as success.

From finding to repair

A blocker is not closed because a manifest changed. Dependency repairs, for example, must reconcile the manifest, lockfile, and installed tree, then run focused audit, tests, build, the intelligence loop, and final verification.

See Verified AI Repair for that full transaction.