Lisa Wiki Doctor

lisa-wiki-doctor

The post-migration / post-setup verification checklist. Orchestrates the deterministic scripts and functional smoke tests, then writes wiki/state/migration/doctor-report.json and prints the blocking items.

Verdict

Each item is PASS | WARN | FAIL | SKIP; overall is READY | READY_WITH_WARNINGS | NOT_READY. In hard-enforcement mode (--migration after phase 5) WARN on structure/integrity items is not allowed; earlier phases allow documented legacy warnings. Build checks (group G) are Lisa/release-only and SKIP in downstream repos.

Checklist

• A. Structure & config (deterministic): validate-config.mjs + structure-manifest conformance; required files present; schemaVersion set and rendered kernelVersion matches the installed plugin; README mode recorded (never implicit stub).
• B. Integrity & safety (deterministic): lint-wiki.mjs + diff-guard.mjs; index/log coverage; state-order invariant; no broken/orphan links; secret/tenant/contamination/sensitivity scans; memory sources project-scoped only (no global Codex memory / Chronicle).
• C. No-loss / parity: pre/post manifest maps every legacy page/doc/command/ingest-path/role; nothing dropped; docs absorption idempotent with zero dangling links; old README ingested before rewrite; no leftover project-local machinery except generated overlays + role agents.
• D. Runtime surfaces (both runtimes): canonical commands resolve on Claude; $lisa-wiki-* on Codex; each config.staff[] role has its doc page + both subagents; MCP doctor passes or connector cleanly disabled; external-write connectors skipped unless explicit intent.
• E. Functional smoke (skill-orchestrated): targeted ingest of a small fixture exercises the full ordered pipeline (in the migration branch or dry/scratch mode — no extra PR); /query returns a cited answer; /lint clean (or expected phase warnings); /onboard-me completes read-mostly with no PII; bare /ingest --dry-run lists non-external-write sources; /doctor rerun is idempotent.
• F. Mode-specific: embedded self-ingest at HEAD; wrapper child-docs ingested-not-moved and not staged; standalone/subdir path resolution; no-PR mode does not require PR creation.
• G. Git / CI / distribution (deterministic): clean working tree (only intended changes); no secrets/OAuth committed; PR/auto-merge policy honored; CI validator green if --with-ci; (Lisa only) bun run build:plugins builds both artifacts and check:plugins passes.

Notes

• Deterministic items are run by scripts/verify-migration.mjs (which emits the JSON report); this skill adds the functional smoke tests and interprets phase-allowed warnings.
• Read-mostly: the smoke tests must not open an extra PR or perform external writes.

Related

lisa-wiki-migrate, lisa-wiki-lint, lisa-wiki-setup.