@monoes/monomindcli 2.16.12 → 2.16.14

package/dist/src/commands/doctor-helpers-checks.js

@@ -0,0 +1,292 @@
+/**
+ * Doctor — hook helper checks: installed helpers vs the bundled copies
+ * (freshness and --fix) and guidance gate wiring.
+ * Extracted from doctor-project-checks.ts.
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isKeptUserEdit } from '../init/file-guard.js';
+import { DOCTOR_TRACKED_HELPERS, OBSOLETE_HELPER_NAMES } from '../init/helpers-generator.js';
+import { MAX_DOCTOR_CONFIG_BYTES, MAX_DOCTOR_HELPER_BYTES, MAX_DOCTOR_PKG_BYTES, } from './doctor-env-checks.js';
+function _resolveBundledHelper(relativePath) {
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        let dir = dirname(thisFile);
+        for (;;) {
+            const candidate = join(dir, 'package.json');
+            if (existsSync(candidate) && statSync(candidate).size <= MAX_DOCTOR_PKG_BYTES) {
+                try {
+                    const pkg = JSON.parse(readFileSync(candidate, 'utf8'));
+                    if (pkg.name === '@monomind/cli' ||
+                        pkg.name === 'monomind' ||
+                        pkg.name === '@monoes/monomindcli') {
+                        const helperPath = join(dir, relativePath);
+                        return existsSync(helperPath) ? helperPath : null;
+                    }
+                }
+                catch {
+                    /* keep walking */
+                }
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+// Top-level critical helpers, plus every file bundled under handlers/ and utils/
+// (capture-handler.cjs, gates-handler.cjs, route-handler.cjs, session-handler.cjs,
+// etc. — where most actual hook-behavior fixes live). Subdir membership is
+// discovered from the bundled package itself, not hardcoded, so a helper added
+// upstream is picked up automatically instead of silently never syncing.
+function _allTrackedHelperNames() {
+    const names = [...DOCTOR_TRACKED_HELPERS];
+    for (const sub of ['handlers', 'utils']) {
+        const bundledSubDir = _resolveBundledHelper(join('.claude', 'helpers', sub));
+        if (!bundledSubDir)
+            continue;
+        try {
+            for (const f of readdirSync(bundledSubDir)) {
+                if (f.startsWith('._'))
+                    continue;
+                if (statSync(join(bundledSubDir, f)).isDirectory())
+                    continue;
+                names.push(join(sub, f));
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return names;
+}
+// Top-level helpers the bundle ships. Their mere ABSENCE is a defect no
+// matter which one it is — handlers/ scripts require() some of them at module
+// load, and a missing one fails the hook closed (issue #225: doctor reported
+// "helpers match bundled version" while audit-log-writer.cjs was absent and
+// every PreToolUse hook was crashing). Existence is checked for all of them;
+// content is still only hash-compared for _allTrackedHelperNames(), because
+// the rest are user-editable scaffolds (memory.cjs, session.cjs) whose local
+// edits are legitimate and must not be reported as staleness.
+function _bundledTopLevelHelperNames() {
+    const bundledDir = _resolveBundledHelper(join('.claude', 'helpers'));
+    if (!bundledDir)
+        return [];
+    try {
+        return readdirSync(bundledDir, { withFileTypes: true })
+            .filter((e) => e.isFile() && !e.name.startsWith('._'))
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+// The installed helper copies doctor compares against the bundle: the Claude
+// Code tree, plus the copy init writes to .gemini/helpers (Antigravity's status
+// bar runs .gemini/helpers/statusline.cjs), which is only checked when present.
+const CLAUDE_HELPERS = join('.claude', 'helpers');
+const GEMINI_HELPERS = join('.gemini', 'helpers');
+async function _detectStaleHelpers(helpersDir = CLAUDE_HELPERS) {
+    const stale = [];
+    const missing = [];
+    // Helpers this product shipped under a name it has since renamed away from
+    // (e.g. graphify-freshen.cjs -> monograph-freshen.cjs). Reported separately
+    // from `stale`/`missing`: unlike those, doctor --fix does not delete these
+    // on its own — settings.json may still have a hook command pointing at one,
+    // and only `init --force` (which also refreshes settings.json in the same
+    // pass) can safely remove it. See writeHelpers/writeSettings.
+    const orphaned = OBSOLETE_HELPER_NAMES.filter((name) => existsSync(join(process.cwd(), '.claude', 'helpers', name)));
+    const crypto = await import('node:crypto');
+    const hashChecked = new Set(_allTrackedHelperNames());
+    for (const name of new Set([..._allTrackedHelperNames(), ..._bundledTopLevelHelperNames()])) {
+        const bundled = _resolveBundledHelper(join('.claude', 'helpers', name));
+        // Oversized-bundled is reported the same as missing-bundled: doctor can't
+        // verify freshness either way, and silently excluding it from both `stale`
+        // and `missing` would let checkHelpersFresh() report "pass" without ever
+        // having actually compared this file.
+        if (!bundled || statSync(bundled).size > MAX_DOCTOR_HELPER_BYTES) {
+            missing.push(name);
+            continue;
+        }
+        const local = join(process.cwd(), helpersDir, name);
+        if (!existsSync(local)) {
+            stale.push(name);
+            continue;
+        } // bundled has it, project doesn't — needs creating
+        if (!hashChecked.has(name))
+            continue; // existence-only (see above)
+        if (statSync(local).size > MAX_DOCTOR_HELPER_BYTES)
+            continue;
+        try {
+            const hashLocal = crypto.createHash('sha256').update(readFileSync(local)).digest('hex');
+            const hashBundled = crypto.createHash('sha256').update(readFileSync(bundled)).digest('hex');
+            if (hashLocal !== hashBundled)
+                stale.push(name);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return { stale, missing, orphaned };
+}
+/** Stale helpers in the Gemini copy, as `.gemini/helpers/<name>`; none if not installed. */
+async function _detectStaleGeminiHelpers() {
+    if (!existsSync(join(process.cwd(), GEMINI_HELPERS)))
+        return [];
+    const { stale } = await _detectStaleHelpers(GEMINI_HELPERS);
+    return stale.map((name) => `.gemini/helpers/${name.split(sep).join('/')}`);
+}
+export async function fixStaleHelpers() {
+    const { stale } = await _detectStaleHelpers();
+    const targets = stale.map((name) => ({ name, local: join(process.cwd(), CLAUDE_HELPERS, name) }));
+    if (existsSync(join(process.cwd(), GEMINI_HELPERS))) {
+        for (const name of (await _detectStaleHelpers(GEMINI_HELPERS)).stale) {
+            targets.push({ name, local: join(process.cwd(), GEMINI_HELPERS, name) });
+        }
+    }
+    let fixed = 0;
+    for (const { name, local } of targets) {
+        // A helper `monomind init` kept because the user edited it is theirs.
+        if (isKeptUserEdit(process.cwd(), local))
+            continue;
+        const bundled = _resolveBundledHelper(join('.claude', 'helpers', name));
+        if (bundled) {
+            try {
+                mkdirSync(dirname(local), { recursive: true });
+                copyFileSync(bundled, local);
+                fixed++;
+            }
+            catch (e) {
+                if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
+                    console.error(`[fixStaleHelpers] failed to copy ${name}:`, e);
+            }
+        }
+    }
+    return fixed > 0;
+}
+export async function checkHelpersFresh() {
+    try {
+        const { stale: claudeStale, missing, orphaned } = await _detectStaleHelpers();
+        const stale = [...claudeStale, ...(await _detectStaleGeminiHelpers())];
+        if (orphaned.length > 0) {
+            return {
+                name: 'Helper Files',
+                status: 'warn',
+                message: `Found ${orphaned.length} hook(s) from before a rename, still on disk: ${orphaned.join(', ')}. Run \`monomind init --force\` to update your hooks and rebuild the Monograph graph.`,
+                fix: 'monomind init --force',
+                // `--fix` only copies stale helpers; it never removes these.
+                fixSafety: 'manual',
+            };
+        }
+        if (stale.length === 0 && missing.length === 0) {
+            return {
+                name: 'Helper Files',
+                status: 'pass',
+                message: 'Project helpers match bundled version',
+            };
+        }
+        if (stale.length > 0) {
+            return {
+                name: 'Helper Files',
+                status: 'warn',
+                message: `${stale.length} stale helper(s): ${stale.join(', ')}`,
+                fix: 'monomind init upgrade',
+                fixSafety: 'auto',
+            };
+        }
+        return {
+            name: 'Helper Files',
+            status: 'warn',
+            message: `Could not locate bundled copies of: ${missing.join(', ')}`,
+            fix: 'Reinstall monomind or run `monomind init upgrade`',
+            fixSafety: 'manual',
+        };
+    }
+    catch (e) {
+        return {
+            name: 'Helper Files',
+            status: 'warn',
+            message: `check failed: ${e instanceof Error ? e.message : 'unknown'}`,
+        };
+    }
+}
+export async function checkGuidanceGates() {
+    const settingsPath = join(process.cwd(), '.claude', 'settings.json');
+    const gatesHandlerPath = join(process.cwd(), '.claude', 'helpers', 'handlers', 'gates-handler.cjs');
+    if (!existsSync(gatesHandlerPath)) {
+        return {
+            name: 'Guidance Gates',
+            status: 'warn',
+            message: 'gates-handler.cjs not found — enforcement gates not installed',
+            fix: 'monomind init  (then monomind guidance setup)',
+        };
+    }
+    if (!existsSync(settingsPath)) {
+        return {
+            name: 'Guidance Gates',
+            status: 'warn',
+            message: 'gates-handler.cjs present but .claude/settings.json missing',
+            fix: 'monomind guidance setup',
+        };
+    }
+    try {
+        if (statSync(settingsPath).size > MAX_DOCTOR_CONFIG_BYTES) {
+            return {
+                name: 'Guidance Gates',
+                status: 'warn',
+                message: 'settings.json too large to parse',
+            };
+        }
+        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        const preToolUse = settings?.hooks?.PreToolUse ?? [];
+        // Match on capability, not on an exact matcher string. The matcher is a
+        // regex alternation that legitimately changes as tools are added — it
+        // gained `|NotebookEdit` when that tool turned out to bypass the secret
+        // gate — and an `=== 'Write|Edit|MultiEdit'` test reported the gate as
+        // INACTIVE the moment it did, telling users their secrets gate was off
+        // while it was demonstrably blocking secrets, and sending them to
+        // `guidance setup`, which would then add a duplicate entry.
+        const hasPreWrite = preToolUse.some((e) => /\bWrite\b/.test(e.matcher ?? '') && e.hooks.some((h) => h.command?.includes('pre-write')));
+        const hasPreBash = preToolUse.some((e) => e.matcher === 'Bash' && e.hooks.some((h) => h.command?.includes('pre-bash')));
+        if (!hasPreWrite && !hasPreBash)
+            return {
+                name: 'Guidance Gates',
+                status: 'warn',
+                message: 'gates-handler.cjs present but no gates registered',
+                fix: 'monomind guidance setup',
+            };
+        if (!hasPreWrite)
+            return {
+                name: 'Guidance Gates',
+                status: 'warn',
+                message: 'pre-write hook not registered — secrets gate inactive',
+                fix: 'monomind guidance setup',
+            };
+        if (!hasPreBash)
+            return {
+                name: 'Guidance Gates',
+                status: 'warn',
+                message: 'pre-bash hook not registered — destructive-ops gate inactive',
+                fix: 'monomind guidance setup',
+            };
+        return {
+            name: 'Guidance Gates',
+            status: 'pass',
+            message: 'destructive-ops (pre-bash) + secrets (pre-write) gates active',
+        };
+    }
+    catch {
+        return {
+            name: 'Guidance Gates',
+            status: 'warn',
+            message: 'Could not parse .claude/settings.json',
+            fix: 'monomind guidance setup --force',
+        };
+    }
+}
+//# sourceMappingURL=doctor-helpers-checks.js.map

package/dist/src/commands/doctor-helpers-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-helpers-checks.js","sourceRoot":"","sources":["../../../src/commands/doctor-helpers-checks.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/doctor-memory-checks.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Doctor — memory checks: project root resolution, memory database, knowledge
+ * graph, Second Brain model and document extractors, memory proficiency.
+ * Extracted from doctor-project-checks.ts.
+ */
+import type { HealthCheck } from './doctor-env-checks.js';
+/** o-16 (AC-6): the marker walk that resolves "this project" for the Memory
+ *  & Knowledge store can silently adopt a wrong ancestor — the incident that
+ *  motivated this check was a shared scratch parent's bare `.monomind`
+ *  capturing an unrelated fixture, with no visible symptom until a search
+ *  came back empty. Disclose the resolved root and why it was chosen, so a
+ *  user can see which directory their brain is keyed to without reading code
+ *  or debug logs. Always 'info': the resolution itself is never a health
+ *  problem, only the failure to see it was.
+ *
+ *  Named/scoped to "Memory Project Root", not a bare "Project Root" (o-16
+ *  revision 1, reviewer MAJOR 2): `MONOMIND_PROJECT_ROOT` has a SECOND,
+ *  independent consumer — `mcp-tools/guidance-tools.ts:findProjectRoot()`,
+ *  which uses a different marker (`.claude`) and can legitimately resolve a
+ *  different directory (see the divergence explained at
+ *  `memory-bridge.ts`'s `getProjectRoot()` doc comment). A generic "Project
+ *  Root" label would claim there is one true answer when this commit is
+ *  what creates a state where two resolvers can disagree — this check must
+ *  not be the thing that misleads about that. */
+export declare function checkProjectRoot(): Promise<HealthCheck>;
+export declare function checkMemoryDatabase(): Promise<HealthCheck>;
+/** Memory knowledge graph (cognee port): entities/relations/rules distilled
+ * from sessions and org runs. Informational — an empty graph on a fresh
+ * project is normal, so it never fails. */
+export declare function checkMemoryKnowledgeGraph(): Promise<HealthCheck>;
+/** Second Brain: when there is any indexed knowledge — ingested docs in this
+ * project, the personal global brain, or the monograph god-node chunk —
+ * semantic search needs the local embedding model. Its absence is silent
+ * (search degrades to keyword matching), so surface it here instead. */
+export declare function checkSecondBrainModel(): Promise<HealthCheck>;
+/**
+ * AutoMem proficiency check — reports memory learning health
+ */
+export declare function checkMemoryProficiency(): Promise<HealthCheck>;
+/** Per-extractor health for Second Brain document ingestion (MEM-8/MEM-9):
+ * one check per format family (PDF, DOCX, XLSX/XLS/ODS, PPTX/ODT/ODP/EPUB,
+ * legacy DOC/PPT/Pages) instead of a single blanket "documents" check, so
+ * `doctor` can report exactly which formats are functional vs broken.
+ * No-op (empty array) when the documents capability isn't active — nothing
+ * to report if this project doesn't ingest documents. */
+export declare function checkDocumentExtractors(): Promise<HealthCheck[]>;
+//# sourceMappingURL=doctor-memory-checks.d.ts.map

package/dist/src/commands/doctor-memory-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-memory-checks.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor-memory-checks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;;iDAiBiD;AACjD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CA2B7D;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAAC,CAkBhE;AAED;;2CAE2C;AAC3C,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,WAAW,CAAC,CAqDtE;AAeD;;;wEAGwE;AACxE,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,CAuElE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC,CA6BnE;AAiBD;;;;;yDAKyD;AACzD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBtE"}

package/dist/src/commands/doctor-memory-checks.js

@@ -0,0 +1,298 @@
+/**
+ * Doctor — memory checks: project root resolution, memory database, knowledge
+ * graph, Second Brain model and document extractors, memory proficiency.
+ * Extracted from doctor-project-checks.ts.
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { MEMORY_DB_CANDIDATE_PATHS } from '../utils/paths.js';
+/** o-16 (AC-6): the marker walk that resolves "this project" for the Memory
+ *  & Knowledge store can silently adopt a wrong ancestor — the incident that
+ *  motivated this check was a shared scratch parent's bare `.monomind`
+ *  capturing an unrelated fixture, with no visible symptom until a search
+ *  came back empty. Disclose the resolved root and why it was chosen, so a
+ *  user can see which directory their brain is keyed to without reading code
+ *  or debug logs. Always 'info': the resolution itself is never a health
+ *  problem, only the failure to see it was.
+ *
+ *  Named/scoped to "Memory Project Root", not a bare "Project Root" (o-16
+ *  revision 1, reviewer MAJOR 2): `MONOMIND_PROJECT_ROOT` has a SECOND,
+ *  independent consumer — `mcp-tools/guidance-tools.ts:findProjectRoot()`,
+ *  which uses a different marker (`.claude`) and can legitimately resolve a
+ *  different directory (see the divergence explained at
+ *  `memory-bridge.ts`'s `getProjectRoot()` doc comment). A generic "Project
+ *  Root" label would claim there is one true answer when this commit is
+ *  what creates a state where two resolvers can disagree — this check must
+ *  not be the thing that misleads about that. */
+export async function checkProjectRoot() {
+    const name = 'Memory Project Root';
+    const { getProjectRootResolution } = await import('../memory/memory-bridge.js');
+    const { root, reason, ignoredBareMonomind, invalidAnchor } = getProjectRootResolution();
+    const reasonText = {
+        'explicit-anchor': 'MONOMIND_PROJECT_ROOT anchor',
+        git: 'nearest .git ancestor',
+        'monomind-at-start': 'starting directory carries .monomind',
+        'monomind-with-marker': '.monomind ancestor confirmed by a project manifest',
+        'start-fallback': 'no adoptable marker found — using the current directory',
+    };
+    // o-16 revision 1 (dev-lead Addition 1): the anchor's own disclosure must
+    // cover the ambiguous case it exists to resolve — a SET-but-INVALID
+    // anchor — not just the happy path, or a typo'd MONOMIND_PROJECT_ROOT
+    // silently does nothing and the user has no way to find out why. Appended
+    // regardless of which `reason` the walk ultimately fell back to.
+    const invalidAnchorNote = invalidAnchor
+        ? ` [MONOMIND_PROJECT_ROOT="${invalidAnchor.value}" ignored — ${invalidAnchor.problem}]`
+        : '';
+    if (reason === 'start-fallback' && ignoredBareMonomind) {
+        return {
+            name,
+            status: 'info',
+            message: `${root} (${reasonText[reason]}; ignored bare .monomind at ${ignoredBareMonomind} — add a project marker there, or set MONOMIND_PROJECT_ROOT, to adopt it)${invalidAnchorNote}`,
+        };
+    }
+    return { name, status: 'info', message: `${root} (${reasonText[reason]})${invalidAnchorNote}` };
+}
+export async function checkMemoryDatabase() {
+    const dbPaths = MEMORY_DB_CANDIDATE_PATHS;
+    for (const dbPath of dbPaths) {
+        if (existsSync(dbPath)) {
+            try {
+                const sizeMB = (statSync(dbPath).size / 1024 / 1024).toFixed(2);
+                return { name: 'Memory Database', status: 'pass', message: `${dbPath} (${sizeMB} MB)` };
+            }
+            catch {
+                return { name: 'Memory Database', status: 'warn', message: `${dbPath} (unable to stat)` };
+            }
+        }
+    }
+    return {
+        name: 'Memory Database',
+        status: 'warn',
+        message: 'Not initialized',
+        fix: 'monomind memory init',
+    };
+}
+/** Memory knowledge graph (cognee port): entities/relations/rules distilled
+ * from sessions and org runs. Informational — an empty graph on a fresh
+ * project is normal, so it never fails. */
+export async function checkMemoryKnowledgeGraph() {
+    const name = 'Memory Knowledge Graph';
+    try {
+        const kg = await import('../memory/memory-kg.js');
+        const bridge = await import('../memory/memory-bridge.js');
+        const project = await kg.kgStats();
+        // Org KG facts are namespaced per org (kg:nodes:org:<name> etc.), so an
+        // unscoped kgStats against the org store reads the now-unused flat
+        // namespaces and reports zero for every org. Sum each org's own scope
+        // instead — the org store holds all of them, keyed by scope.
+        const orgDb = join(process.cwd(), '.monomind', 'org-memory');
+        let org = null;
+        if (existsSync(orgDb)) {
+            const { orgKgScope } = await import('../orgrt/org-memory.js');
+            const { listOrgConfigFiles } = await import('./org.js');
+            const orgsDir = join(process.cwd(), '.monomind', 'orgs');
+            const orgNames = existsSync(orgsDir)
+                ? listOrgConfigFiles(orgsDir).map((f) => f.replace(/\.json$/, ''))
+                : [];
+            org = { nodes: 0, edges: 0, rules: 0 };
+            for (const orgName of orgNames) {
+                const s = await kg.kgStats({ dbPath: orgDb, scope: orgKgScope(orgName) });
+                org.nodes += s.nodes;
+                org.edges += s.edges;
+                org.rules += s.rules;
+            }
+        }
+        await bridge.shutdownBridge().catch(() => {
+            /* best effort */
+        });
+        const total = project.nodes + (org?.nodes ?? 0);
+        const fmt = (s) => `${s.nodes}n/${s.edges}e/${s.rules}r`;
+        if (total === 0) {
+            return {
+                name,
+                status: 'warn',
+                message: 'Empty — sessions/org runs have not distilled knowledge yet',
+                fix: 'org runs call org_learn automatically; sessions use memory_kg_ingest',
+            };
+        }
+        return {
+            name,
+            status: 'pass',
+            message: `project ${fmt(project)}${org ? ` · org ${fmt(org)}` : ''}`,
+        };
+    }
+    catch (err) {
+        return {
+            name,
+            status: 'warn',
+            message: `Check failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/** Count live (non-tombstoned) ingested documents under a brain root, without
+ * creating the directory — `listDocuments` mkdir's its metadata dir, which
+ * would materialize an empty global brain just by running doctor. */
+async function countBrainDocs(root) {
+    if (!existsSync(join(root, '.monomind', 'knowledge', 'doc-metadata.jsonl')))
+        return 0;
+    try {
+        const { listDocuments } = await import('../knowledge/document-pipeline.js');
+        return listDocuments(root).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Second Brain: when there is any indexed knowledge — ingested docs in this
+ * project, the personal global brain, or the monograph god-node chunk —
+ * semantic search needs the local embedding model. Its absence is silent
+ * (search degrades to keyword matching), so surface it here instead. */
+export async function checkSecondBrainModel() {
+    const name = 'Second Brain Model';
+    const { BRIDGE_EMBEDDING_MODEL, getGlobalBrainDir, getProjectRoot } = await import('../memory/memory-bridge.js');
+    const projectDocs = await countBrainDocs(getProjectRoot());
+    const globalDocs = await countBrainDocs(getGlobalBrainDir());
+    // chunks.jsonl holds the monograph god-node chunk — knowledge with no doc
+    // ingest. Unlike the document store it is written per-CWD by the session
+    // hook, not at the project root, so check both rather than assuming.
+    const chunksIn = (root) => existsSync(join(root, '.monomind', 'knowledge', 'chunks.jsonl'));
+    const hasChunks = chunksIn(getProjectRoot()) || chunksIn(process.cwd());
+    if (!projectDocs && !globalDocs && !hasChunks) {
+        return { name, status: 'pass', message: 'No knowledge indexed (nothing to check)' };
+    }
+    const indexed = [
+        projectDocs ? `${projectDocs} project doc${projectDocs === 1 ? '' : 's'}` : null,
+        globalDocs ? `${globalDocs} global doc${globalDocs === 1 ? '' : 's'}` : null,
+        !projectDocs && !globalDocs ? 'monograph god-nodes' : null,
+    ]
+        .filter(Boolean)
+        .join(' · ');
+    let entryPath = null;
+    try {
+        // exports map blocks package.json — resolve the entry file, then walk UP
+        // with path ops (no separator-sensitive regex: '/dist/'.replace broke on
+        // Windows paths, and any install layout without a dist segment).
+        // import.meta.resolve is missing on Node 20.0–20.5; fall back to CJS resolve.
+        const viaEsm = import.meta.resolve?.('@huggingface/transformers');
+        if (viaEsm)
+            entryPath = fileURLToPath(await viaEsm);
+    }
+    catch {
+        /* try CJS below */
+    }
+    if (!entryPath) {
+        try {
+            const { createRequire } = await import('node:module');
+            entryPath = createRequire(import.meta.url).resolve('@huggingface/transformers');
+        }
+        catch {
+            return {
+                name,
+                status: 'warn',
+                message: '@huggingface/transformers not installed — semantic search degraded to keyword matching',
+                fix: 'reinstall monomind (the model dependency is optional and may have failed to build)',
+            };
+        }
+    }
+    // Walk up from the entry file to the package root (the dir named 'transformers').
+    let pkgDir = dirname(entryPath);
+    while (pkgDir !== dirname(pkgDir) && !pkgDir.endsWith('transformers'))
+        pkgDir = dirname(pkgDir);
+    // The cached model is whichever one the bridge actually loads. This used to
+    // look for '.cache/Xenova', a model the bridge stopped using — so the check
+    // reported "not downloaded" with a fully provisioned cache sitting on disk.
+    const modelCache = join(pkgDir, '.cache', ...BRIDGE_EMBEDDING_MODEL.split('/'));
+    if (pkgDir.endsWith('transformers') && existsSync(modelCache)) {
+        return {
+            name,
+            status: 'pass',
+            message: `Local embedding model cached — semantic search active (${indexed})`,
+        };
+    }
+    return {
+        name,
+        status: 'warn',
+        message: 'Embedding model not downloaded yet — searches use keyword matching until it is',
+        // Query-time paths all pass local_files_only and never fetch; this is the
+        // one command that downloads the weights.
+        fix: 'run once while online: monomind doc eval --provision-model (downloads ~270MB locally, one time)',
+    };
+}
+/**
+ * AutoMem proficiency check — reports memory learning health
+ */
+export async function checkMemoryProficiency() {
+    try {
+        const intelligenceMod = await import('../memory/intelligence.js');
+        const stats = intelligenceMod.getMemoryProficiencyStats();
+        const bankStats = intelligenceMod.getIntelligenceStats();
+        if (stats.totalDecisions === 0) {
+            return {
+                name: 'Memory Proficiency',
+                status: 'pass',
+                message: 'AutoMem active — no decisions recorded yet (builds up over sessions)',
+            };
+        }
+        const successPct = Math.round(stats.successRate * 100);
+        const hitPct = Math.round(stats.patternHitRate * 100);
+        const msg = `${stats.totalDecisions} decisions, ${successPct}% success, ${stats.proficiencyPatterns} patterns, ${hitPct}% hit rate (bank: ${bankStats.patternsLearned} total)`;
+        if (stats.successRate < 0.5) {
+            return { name: 'Memory Proficiency', status: 'warn', message: msg };
+        }
+        return { name: 'Memory Proficiency', status: 'pass', message: msg };
+    }
+    catch {
+        return {
+            name: 'Memory Proficiency',
+            status: 'warn',
+            message: 'Could not load intelligence module',
+        };
+    }
+}
+/** Second Brain document ingestion: whether the "documents" capability is
+ * active for this project. Read directly from capabilities.json rather than
+ * re-running the directory scan — doctor should report on what's actually
+ * activated, not re-detect. */
+function isDocumentsCapabilityActive(cwd) {
+    try {
+        const capsPath = join(cwd, '.monomind', 'capabilities.json');
+        if (!existsSync(capsPath))
+            return false;
+        const parsed = JSON.parse(readFileSync(capsPath, 'utf8'));
+        return Array.isArray(parsed.active) && parsed.active.includes('documents');
+    }
+    catch {
+        return false;
+    }
+}
+/** Per-extractor health for Second Brain document ingestion (MEM-8/MEM-9):
+ * one check per format family (PDF, DOCX, XLSX/XLS/ODS, PPTX/ODT/ODP/EPUB,
+ * legacy DOC/PPT/Pages) instead of a single blanket "documents" check, so
+ * `doctor` can report exactly which formats are functional vs broken.
+ * No-op (empty array) when the documents capability isn't active — nothing
+ * to report if this project doesn't ingest documents. */
+export async function checkDocumentExtractors() {
+    if (!isDocumentsCapabilityActive(process.cwd()))
+        return [];
+    try {
+        const { documentsCapability } = await import('../capabilities/cap-documents.js');
+        const checks = (await documentsCapability.healthChecks?.()) ?? [];
+        return checks.map((c) => ({
+            name: c.name,
+            status: c.status,
+            message: c.message,
+            fix: c.hint ?? c.fix,
+        }));
+    }
+    catch (err) {
+        return [
+            {
+                name: 'Document Extractors',
+                status: 'warn',
+                message: `Check failed: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        ];
+    }
+}
+//# sourceMappingURL=doctor-memory-checks.js.map