Reference / In development
solomonar doctorIn development
Check a Solomonar project's repository, registry, managed files, extensions, runtime adapters, and forge settings with solomonar doctor. In development.
On this page
This command is in development and not in the current build; running it today exits 2 with an unknown-command error. This page describes the planned behavior; the final output may differ in detail.
Read-only. Checks the repository, the registry, the managed files, the installed extensions, the runtime adapters, the forge settings, and the project commands, then prints ok, warn, or fail for each check. It exits 5 when any check fails, else 0.
When to use it
After init and its first commit, after a CLI update, when an agent reports something odd about the project setup, and in CI.
Who runs it
You, or your CI. Agents may run it to diagnose an environment blocker.
Synopsis
solomonar doctor [--json]
Checks
| Area | What fails (exit 5) | What only warns |
|---|---|---|
| git | Git older than 2.40, no repository, no commit on main, unusable worktrees | A .jj/ directory |
| registry | A missing or invalid registry, or a schema or framework newer than this CLI | No remote, or an unpublished local registry |
| files | An invalid manifest, missing managed files, or managed files not committed on main | Managed files modified since installation |
| extensions | A stack extension without an approved decision for its group's full selection, unmet requires or conflicts, stale rendering, an incomplete core; drafts are not checked |
- |
| runtimes | Adapter files out of sync, as sync --check reports |
CLAUDE.md not loading AGENTS.md, or a missing guard hook |
| forge | A repository that does not allow merge commits | gh missing or not authenticated, squash or rebase merges also allowed |
| project | - | Commands in docs/README.md not established |
Example
The specification's ledger project, with four extensions installed:
solomonar doctor
git
ok git 2.47.1 (2.40 or later)
ok main branch "main" has commits
warn .jj/ present: v0.1 supports Git only
registry
ok refs/heads/workflow-state @ 3a5c0d7, schema_version 1, 4 tasks valid
ok origin/workflow-state matches local
files
ok framework 0.1.4, manifest valid
fail 4 framework paths not committed on main: AGENTS.md, CLAUDE.md, .claude/, .solomonar/
warn docs/solomonar/skills/spec/template.md modified since installation (kept by upgrades)
extensions
ok 4 installed: go (P/D-1), htmx, templ (P/D-2), tdd (P/D-3); requirements met; rendering current
runtimes
ok claude: CLAUDE.md imports AGENTS.md; 8 skill stubs, 5 role stubs in sync; guard hook present
warn codex: state guard hook not trusted yet; review it with /hooks
forge
ok gh 2.62.0 authenticated for github.com/acme/ledger
ok merge commits allowed (rules section 11)
warn squash merges also allowed; the orchestrator must use merge commits only
project
warn docs/README.md commands: run, build, test, lint not established
1 failure, 4 warnings