monomind 2.7.12 → 2.7.14

package/packages/@monomind/cli/dist/src/commands/doctor-project-checks.js

@@ -1,764 +0,0 @@
-/**
- * Doctor — project/monomind health checks
- * Config, memory, API keys, MCP, monograph, helpers, routing, gates, gitignore, worker metrics
- */
-import { existsSync, readFileSync, readdirSync, statSync, mkdirSync, copyFileSync, writeFileSync, appendFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
-import { homedir } from 'os';
-import { MAX_DOCTOR_PKG_BYTES, MAX_DOCTOR_CONFIG_BYTES, MAX_DOCTOR_GITIGNORE_BYTES, MAX_DOCTOR_HELPER_BYTES, } from './doctor-env-checks.js';
-import { DOCTOR_TRACKED_HELPERS } from '../init/helpers-generator.js';
-export async function checkConfigFile() {
-    const jsonPaths = ['.monomind/config.json', 'monomind.config.json', '.monomind.json'];
-    for (const configPath of jsonPaths) {
-        if (existsSync(configPath) && statSync(configPath).size <= MAX_DOCTOR_CONFIG_BYTES) {
-            try {
-                JSON.parse(readFileSync(configPath, 'utf8'));
-                return { name: 'Config File', status: 'pass', message: `Found: ${configPath}` };
-            }
-            catch {
-                return { name: 'Config File', status: 'fail', message: `Invalid JSON: ${configPath}`, fix: 'Fix JSON syntax in config file' };
-            }
-        }
-    }
-    const yamlPaths = ['.monomind/config.yaml', '.monomind/config.yml', 'monomind.config.yaml'];
-    for (const configPath of yamlPaths) {
-        if (existsSync(configPath))
-            return { name: 'Config File', status: 'pass', message: `Found: ${configPath}` };
-    }
-    return { name: 'Config File', status: 'warn', message: 'No config file (using defaults)', fix: 'monomind config init' };
-}
-export async function checkMemoryDatabase() {
-    const dbPaths = ['.monomind/memory.db', '.swarm/memory.db', 'data/memory.db'];
-    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 configure --backend hybrid' };
-}
-/** 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();
-        const orgDb = join(process.cwd(), '.monomind', 'org-memory');
-        const org = existsSync(orgDb) ? await kg.kgStats({ dbPath: orgDb }) : null;
-        await bridge.shutdownBridge().catch(() => { });
-        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)}` };
-    }
-}
-/** Second Brain: when this project has an indexed knowledge base, semantic
- * search needs the local embedding model. Its absence is silent (search
- * degrades to keyword matching) — surface it here instead. */
-export async function checkSecondBrainModel() {
-    const name = 'Second Brain Model';
-    if (!existsSync(join(process.cwd(), '.monomind', 'knowledge', 'chunks.jsonl'))) {
-        return { name, status: 'pass', message: 'No knowledge base in this project (nothing to check)' };
-    }
-    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);
-    const modelCache = join(pkgDir, '.cache', 'Xenova');
-    if (pkgDir.endsWith('transformers') && existsSync(modelCache)) {
-        return { name, status: 'pass', message: 'Local embedding model cached — semantic search active' };
-    }
-    return { name, status: 'warn', message: 'Embedding model not downloaded yet — searches use keyword matching until it is', fix: 'run once while online: monomind doc search -q "warmup" (downloads ~90MB locally, one time)' };
-}
-export async function checkApiKeys() {
-    const keys = ['ANTHROPIC_API_KEY', 'CLAUDE_API_KEY', 'OPENAI_API_KEY'];
-    const found = keys.filter(k => process.env[k]);
-    const inClaudeCode = !!(process.env.CLAUDE_CODE || process.env.CLAUDE_PROJECT_DIR || process.env.MCP_SESSION_ID);
-    let claudeCliAvailable = false;
-    try {
-        execSync('claude --version', { encoding: 'utf-8', stdio: 'pipe', timeout: 5000, windowsHide: true });
-        claudeCliAvailable = true;
-    }
-    catch { /* not on PATH */ }
-    if (found.includes('ANTHROPIC_API_KEY') || found.includes('CLAUDE_API_KEY')) {
-        return { name: 'API Keys', status: 'pass', message: `Found: ${found.join(', ')}` };
-    }
-    else if (inClaudeCode) {
-        return { name: 'API Keys', status: 'pass', message: 'Claude Code manages auth (no direct API key needed)' };
-    }
-    else if (claudeCliAvailable) {
-        return { name: 'API Keys', status: 'pass', message: 'Using Claude Code CLI auth (no direct API key needed)' };
-    }
-    else if (found.length > 0) {
-        return { name: 'API Keys', status: 'warn', message: `Found: ${found.join(', ')} (no Claude key)`, fix: 'export ANTHROPIC_API_KEY=your_key' };
-    }
-    return {
-        name: 'API Keys',
-        status: 'warn',
-        message: 'Claude Code CLI not found — monomind works best on top of Claude Code',
-        fix: 'npm install -g @anthropic-ai/claude-code  # then: claude login',
-    };
-}
-export async function checkMcpServers() {
-    const mcpConfigPaths = [
-        join(homedir(), '.claude/claude_desktop_config.json'),
-        join(homedir(), '.config/claude/mcp.json'),
-        '.mcp.json',
-        '.claude/settings.json',
-        '.claude/settings.local.json',
-        join(homedir(), '.claude/settings.json'),
-    ];
-    for (const configPath of mcpConfigPaths) {
-        if (existsSync(configPath) && statSync(configPath).size <= MAX_DOCTOR_CONFIG_BYTES) {
-            try {
-                const content = JSON.parse(readFileSync(configPath, 'utf8'));
-                const servers = content.mcpServers || content.servers || {};
-                const count = Object.keys(servers).length;
-                const hasMonomind = 'monomind' in servers || 'monomind_alpha' in servers;
-                if (hasMonomind)
-                    return { name: 'MCP Servers', status: 'pass', message: `${count} servers (monomind configured)` };
-                return { name: 'MCP Servers', status: 'warn', message: `${count} servers (monomind not found)`, fix: 'claude mcp add monomind -- npx -y monomind@latest mcp start' };
-            }
-            catch { /* try next */ }
-        }
-    }
-    return { name: 'MCP Servers', status: 'warn', message: 'No MCP config found', fix: 'claude mcp add monomind -- npx -y monomind@latest mcp start' };
-}
-export async function checkMonograph() {
-    try {
-        const __filename = fileURLToPath(import.meta.url);
-        const _base = dirname(__filename);
-        let _globalRoot = '';
-        try {
-            _globalRoot = execSync('npm root -g', { encoding: 'utf8', timeout: 3000 }).trim();
-        }
-        catch { /* no npm */ }
-        const candidates = [
-            join(_base, '..', '..', 'node_modules', '@monomind', 'monograph', 'package.json'),
-            join(_base, '..', '..', '..', '..', 'node_modules', '@monomind', 'monograph', 'package.json'),
-            join(_base, '..', '..', 'node_modules', '@monoes', 'monograph', 'package.json'),
-            join(_base, '..', '..', '..', '..', 'node_modules', '@monoes', 'monograph', 'package.json'),
-            ...(_globalRoot ? [
-                join(_globalRoot, '@monomind', 'monograph', 'package.json'),
-                join(_globalRoot, '@monoes', 'monograph', 'package.json'),
-            ] : []),
-        ];
-        const found = candidates.find(p => existsSync(p) && statSync(p).size <= MAX_DOCTOR_PKG_BYTES);
-        if (found) {
-            try {
-                const pkg = JSON.parse(readFileSync(found, 'utf-8'));
-                return { name: 'Monograph', status: 'pass', message: `v${pkg.version || '?'} available (knowledge graph engine)` };
-            }
-            catch {
-                return { name: 'Monograph', status: 'pass', message: 'available (knowledge graph engine)' };
-            }
-        }
-        return { name: 'Monograph', status: 'warn', message: 'Package not found (knowledge graph disabled)', fix: 'npm install -g monomind@latest' };
-    }
-    catch {
-        return { name: 'Monograph', status: 'warn', message: 'Package check failed', fix: 'npm install -g monomind@latest' };
-    }
-}
-export async function checkMonographFreshness() {
-    try {
-        const cwd = process.cwd();
-        const dbPath = join(cwd, '.monomind', 'monograph.db');
-        const lockPath = join(cwd, '.monomind', 'graph', '.rebuild-lock');
-        const statsPath = join(cwd, '.monomind', 'graph', 'stats.json');
-        const hasDb = existsSync(dbPath);
-        if (!hasDb && !existsSync(statsPath)) {
-            return { name: 'Graph freshness', status: 'warn', message: 'No monograph graph built yet', fix: 'mcp__monomind__monograph_build codeOnly:true' };
-        }
-        let buildMs = 0;
-        if (hasDb) {
-            try {
-                buildMs = Math.max(buildMs, statSync(dbPath).mtimeMs);
-            }
-            catch { /* ignore */ }
-        }
-        try {
-            buildMs = Math.max(buildMs, statSync(lockPath).mtimeMs);
-        }
-        catch { /* ignore */ }
-        try {
-            buildMs = Math.max(buildMs, statSync(statsPath).mtimeMs);
-        }
-        catch { /* ignore */ }
-        if (buildMs === 0)
-            return { name: 'Graph freshness', status: 'warn', message: 'Graph exists but build time unknown' };
-        const buildIso = new Date(buildMs).toISOString();
-        let commitsBehind = 0;
-        try {
-            const out = execSync(`git rev-list --count --since='${buildIso}' HEAD 2>/dev/null`, { encoding: 'utf8', timeout: 2000, cwd }).trim();
-            commitsBehind = parseInt(out, 10) || 0;
-        }
-        catch { /* git unavailable */ }
-        const ageMinutes = Math.floor((Date.now() - buildMs) / 60000);
-        const ageStr = ageMinutes < 60 ? `${ageMinutes}m ago` : `${Math.floor(ageMinutes / 60)}h ago`;
-        if (commitsBehind === 0)
-            return { name: 'Graph freshness', status: 'pass', message: `FRESH — built ${ageStr}, 0 commits behind` };
-        if (commitsBehind <= 5)
-            return { name: 'Graph freshness', status: 'warn', message: `${commitsBehind} commit(s) behind — built ${ageStr}`, fix: 'mcp__monomind__monograph_build codeOnly:true' };
-        return { name: 'Graph freshness', status: 'fail', message: `STALE — ${commitsBehind} commits behind (built ${ageStr})`, fix: 'mcp__monomind__monograph_build codeOnly:true' };
-    }
-    catch {
-        return { name: 'Graph freshness', status: 'warn', message: 'Could not check graph freshness' };
-    }
-}
-export async function checkMonoesMemory() {
-    try {
-        const __filename = fileURLToPath(import.meta.url);
-        const _base = dirname(__filename);
-        let _globalRoot = '';
-        try {
-            _globalRoot = execSync('npm root -g', { encoding: 'utf8', timeout: 3000 }).trim();
-        }
-        catch { /* no npm */ }
-        const candidates = [
-            join(_base, '..', '..', 'node_modules', '@monoes', 'memory', 'package.json'),
-            join(_base, '..', '..', '..', '..', 'node_modules', '@monoes', 'memory', 'package.json'),
-            ...(_globalRoot ? [join(_globalRoot, '@monoes', 'memory', 'package.json')] : []),
-        ];
-        const found = candidates.find(p => existsSync(p) && statSync(p).size <= MAX_DOCTOR_PKG_BYTES);
-        if (found) {
-            try {
-                const pkg = JSON.parse(readFileSync(found, 'utf-8'));
-                return { name: 'Vector Memory', status: 'pass', message: `@monoes/memory v${pkg.version || '?'} (HNSW search enabled)` };
-            }
-            catch {
-                return { name: 'Vector Memory', status: 'pass', message: '@monoes/memory available (HNSW search enabled)' };
-            }
-        }
-        return { name: 'Vector Memory', status: 'warn', message: '@monoes/memory not installed (vector search disabled)', fix: 'npm install @monoes/memory' };
-    }
-    catch {
-        return { name: 'Vector Memory', status: 'warn', message: 'Vector memory check failed' };
-    }
-}
-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;
-}
-async function _detectStaleHelpers() {
-    const stale = [];
-    const missing = [];
-    const crypto = await import('node:crypto');
-    for (const name of _allTrackedHelperNames()) {
-        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(), '.claude', 'helpers', name);
-        if (!existsSync(local)) {
-            stale.push(name);
-            continue;
-        } // bundled has it, project doesn't — needs creating
-        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 };
-}
-export async function fixStaleHelpers() {
-    const { stale } = await _detectStaleHelpers();
-    let fixed = 0;
-    for (const name of stale) {
-        const local = join(process.cwd(), '.claude', 'helpers', name);
-        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, missing } = await _detectStaleHelpers();
-        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' };
-        }
-        return { name: 'Helper Files', status: 'warn', message: `Could not locate bundled copies of: ${missing.join(', ')}`, fix: 'Reinstall monomind or run `monomind init upgrade`' };
-    }
-    catch (e) {
-        return { name: 'Helper Files', status: 'warn', message: `check failed: ${e instanceof Error ? e.message : 'unknown'}` };
-    }
-}
-function fmtPct(v) {
-    return v === null ? 'n/a' : `${Math.round(v * 100)}%`;
-}
-async function routingAccuracyLine() {
-    try {
-        const { computeRoutingAccuracy, computeAdherence } = await import('../monovector/route-outcomes.js');
-        const baseDir = join(process.cwd(), '.monomind');
-        const acc = await computeRoutingAccuracy(baseDir, 100);
-        const adh = await computeAdherence(baseDir);
-        const adhStr = ` | adherence ${fmtPct(adh.adherence)} (n=${adh.sample})`;
-        if (acc.accuracy === null)
-            return `routing accuracy (last 100): no outcome data yet${adhStr}`;
-        const trend = acc.recentVsPrior === null ? '' : ` trend ${acc.recentVsPrior >= 0 ? '+' : ''}${Math.round(acc.recentVsPrior * 100)}%`;
-        return `routing accuracy (last ${acc.window}): ${fmtPct(acc.accuracy)} [native ${fmtPct(acc.byMode.native)} / js ${fmtPct(acc.byMode.js)}]${trend}${adhStr}`;
-    }
-    catch (e) {
-        if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
-            console.error('[routingAccuracyLine] compute failed:', e);
-        return 'routing accuracy (last 100): no outcome data yet';
-    }
-}
-/** Fallback when route-outcomes.jsonl has no data: summarize .monomind/routing-feedback.jsonl honestly. */
-function routingFeedbackFallback() {
-    try {
-        const p = join(process.cwd(), '.monomind', 'routing-feedback.jsonl');
-        if (!existsSync(p) || statSync(p).size > 512 * 1024)
-            return null;
-        const records = readFileSync(p, 'utf-8').trim().split('\n').filter(Boolean).map(l => {
-            try {
-                return JSON.parse(l);
-            }
-            catch {
-                return null;
-            }
-        }).filter((r) => r !== null);
-        if (records.length === 0)
-            return null;
-        const sessions = new Set(records.map(r => r.sessionId).filter(Boolean));
-        const byAgent = new Map();
-        for (const r of records) {
-            const a = typeof r.suggestedAgent === 'string' ? r.suggestedAgent : 'unknown';
-            byAgent.set(a, (byAgent.get(a) ?? 0) + 1);
-        }
-        const top = [...byAgent.entries()].sort((a, b) => b[1] - a[1]).slice(0, 3).map(([a, n]) => `${a}=${n}`).join(', ');
-        const flags = records.map(r => r.intelligenceFeedback).filter((v) => typeof v === 'boolean');
-        const trueCount = flags.filter(Boolean).length;
-        const base = `routing feedback (fallback): ${records.length} decisions across ${sessions.size} sessions; top agents: ${top}`;
-        if (flags.length > 0 && trueCount === flags.length) {
-            return { message: `${base}; success flag is degenerate (100% true — sessionSuccess heuristic never records failure)`, degenerate: true };
-        }
-        if (flags.length === 0)
-            return { message: `${base}; no evidence-based success flags yet`, degenerate: true };
-        return { message: `${base}; success rate ${Math.round((trueCount / flags.length) * 100)}% (n=${flags.length})`, degenerate: false };
-    }
-    catch (e) {
-        if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
-            console.error('[routingFeedbackFallback] parse failed:', e);
-        return null;
-    }
-}
-export async function checkMonoesIntegration() {
-    try {
-        const line = await routingAccuracyLine();
-        if (line.startsWith('routing accuracy (last 100): no outcome data yet')) {
-            const fb = routingFeedbackFallback();
-            if (fb)
-                return { name: 'Routing Learning', status: fb.degenerate ? 'warn' : 'pass', message: fb.message };
-        }
-        return { name: 'Routing Learning', status: 'pass', message: line };
-    }
-    catch (err) {
-        return { name: 'Routing Learning', status: 'warn', message: `Could not compute routing accuracy: ${err instanceof Error ? err.message : String(err)}` };
-    }
-}
-const REQUIRED_GITIGNORE_PATTERNS = [
-    { pattern: '.monomind/sessions/', reason: 'session files contain cwd and machine paths' },
-    { pattern: '.monomind/data/', reason: 'intelligence data with edit file paths' },
-    { pattern: '.monomind/metrics/', reason: 'metrics with file path references' },
-    { pattern: '.monomind/knowledge/', reason: 'knowledge chunks with local file content' },
-    { pattern: '.monomind/*.json', reason: 'root-level runtime JSON (control, registry, routing)' },
-    { pattern: '.monomind/*.jsonl', reason: 'root-level event logs (decisions, routing-feedback)' },
-    { pattern: '**/.monomind/sessions/', reason: 'nested session files in sub-packages' },
-    { pattern: '**/.monomind/*.json', reason: 'nested runtime JSON in sub-packages' },
-    { pattern: 'data/sessions/', reason: 'session files with machine paths' },
-    { pattern: 'data/mastermind-*.json', reason: 'mastermind session data' },
-    { pattern: 'data/mastermind-*.jsonl', reason: 'mastermind event logs' },
-    { pattern: '**/.claude-flow/', reason: 'claude-flow runtime data with paths' },
-    { pattern: '.hive-mind/', reason: 'hive-mind state with session info' },
-    { pattern: '.swarm/', reason: 'swarm state files' },
-];
-/** Strip the parts that don't change what a pattern matches, so `**​/.monomind/`,
- *  `.monomind/` and `.monomind` all compare equal. A gitignore pattern with no
- *  leading slash already matches at every depth, so `**​/` is redundant. */
-function normalizeGitignorePattern(p) {
-    return p.replace(/^\/+/, '').replace(/^\*\*\//, '').replace(/\/+$/, '');
-}
-/** True when ignoring `line` already protects everything `required` covers.
- *  Beyond exact matches this understands directory containment: a repo with a
- *  blanket `.monomind/` is fully covered for `.monomind/sessions/`,
- *  `.monomind/*.json` and friends, and should not be nagged to add each one. */
-function gitignoreLineCovers(line, required) {
-    const l = normalizeGitignorePattern(line);
-    const r = normalizeGitignorePattern(required);
-    if (!l)
-        return false;
-    if (l === r)
-        return true;
-    // A bare directory entry covers every path beneath it, but only when the
-    // entry itself is literal — `.monomind/*.json` must not be treated as an
-    // ancestor of `.monomind/sessions`.
-    return !l.includes('*') && r.startsWith(`${l}/`);
-}
-export async function checkGitignoreCoverage() {
-    const gitignorePath = join(process.cwd(), '.gitignore');
-    if (!existsSync(gitignorePath)) {
-        // The old hint was `echo ".monomind/\n**/.monomind/" >> .gitignore`, which
-        // writes a literal backslash-n (sh/bash echo does not interpret escapes
-        // without -e) — one junk line matching nothing. `--fix` now writes the file
-        // directly, so point at that rather than at a command to copy-paste.
-        return { name: 'Gitignore Coverage', status: 'warn', message: 'No .gitignore found — all monomind runtime paths are unprotected', fix: 'monomind doctor --fix   (creates .gitignore covering .monomind/ and secrets)' };
-    }
-    if (statSync(gitignorePath).size > MAX_DOCTOR_GITIGNORE_BYTES) {
-        return { name: 'Gitignore Coverage', status: 'warn', message: '.gitignore too large to parse' };
-    }
-    const lines = readFileSync(gitignorePath, 'utf-8').split('\n').map(l => l.trim()).filter(l => l && !l.startsWith('#'));
-    const missing = REQUIRED_GITIGNORE_PATTERNS.filter(({ pattern }) => !lines.some(l => gitignoreLineCovers(l, pattern)));
-    if (missing.length === 0)
-        return { name: 'Gitignore Coverage', status: 'pass', message: 'All monomind runtime paths are gitignored' };
-    const missingList = missing.map(m => m.pattern).join(', ');
-    return { name: 'Gitignore Coverage', status: 'warn', message: `${missing.length} runtime path(s) not in .gitignore: ${missingList}`, fix: 'monomind doctor --fix   (appends the missing entries)' };
-}
-/** Patterns written by `doctor --fix` when there is no .gitignore at all.
- *  Covers monomind runtime state plus the standard secrets files, since a repo
- *  with no .gitignore has nothing protecting those either. */
-const GITIGNORE_FIX_PATTERNS = [
-    '# monomind runtime state',
-    '.monomind/',
-    '**/.monomind/',
-    '.hive-mind/',
-    '.swarm/',
-    '**/.claude-flow/',
-    'data/sessions/',
-    'data/mastermind-*.json',
-    'data/mastermind-*.jsonl',
-    '',
-    '# secrets / local env',
-    '.env',
-    '.env.*',
-    '!.env.example',
-    '*.pem',
-    '*.key',
-    '',
-    '# dependencies / build output',
-    'node_modules/',
-    'dist/',
-];
-/** Creates or appends the missing gitignore entries. Returns true if it wrote.
- *  Append-only and idempotent: never rewrites lines the user already has. */
-export async function fixGitignoreCoverage() {
-    const gitignorePath = join(process.cwd(), '.gitignore');
-    try {
-        if (!existsSync(gitignorePath)) {
-            writeFileSync(gitignorePath, GITIGNORE_FIX_PATTERNS.join('\n') + '\n', 'utf-8');
-            return true;
-        }
-        if (statSync(gitignorePath).size > MAX_DOCTOR_GITIGNORE_BYTES)
-            return false;
-        const existing = readFileSync(gitignorePath, 'utf-8');
-        const lines = existing.split('\n').map(l => l.trim()).filter(l => l && !l.startsWith('#'));
-        const missing = REQUIRED_GITIGNORE_PATTERNS
-            .map(m => m.pattern)
-            .filter(pattern => !lines.some(l => gitignoreLineCovers(l, pattern)));
-        if (missing.length === 0)
-            return false;
-        const prefix = existing.endsWith('\n') || existing === '' ? '' : '\n';
-        appendFileSync(gitignorePath, `${prefix}\n# monomind runtime state\n${missing.join('\n')}\n`, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function checkAgentRegistry() {
-    try {
-        const { buildUnifiedRegistry, computeAgentRoots } = await import('../agents/registry-builder.js');
-        const cwd = process.cwd();
-        const roots = computeAgentRoots(cwd);
-        const outDir = join(cwd, '.monomind');
-        mkdirSync(outDir, { recursive: true });
-        // Rebuilds fresh in-memory (and refreshes .monomind/registry.json on disk)
-        // rather than reading a file that a separate, unawaited startup task also
-        // writes — avoids reporting stale results from a race between the two.
-        const registry = buildUnifiedRegistry(roots, join(outDir, 'registry.json'));
-        const entries = registry.agents;
-        if (entries.length === 0) {
-            return { name: 'Agent Registry', status: 'warn', message: 'No agents found under .claude/agents', fix: 'monomind init  (installs agent definitions)' };
-        }
-        let missingSlug = 0, missingName = 0, missingDescription = 0;
-        for (const agent of entries) {
-            if (!agent.slug)
-                missingSlug++;
-            if (!agent.name)
-                missingName++;
-            if (!agent.description)
-                missingDescription++;
-        }
-        const total = missingSlug + missingName + missingDescription;
-        if (total === 0) {
-            return { name: 'Agent Registry', status: 'pass', message: `${entries.length} agent(s), all metadata complete` };
-        }
-        const parts = [
-            missingSlug > 0 ? `${missingSlug} missing slug` : null,
-            missingName > 0 ? `${missingName} missing name` : null,
-            missingDescription > 0 ? `${missingDescription} missing description` : null,
-        ].filter(Boolean).join(', ');
-        return {
-            name: 'Agent Registry',
-            status: 'warn',
-            message: `${total} metadata issue(s) across ${entries.length} agent(s): ${parts}`,
-            fix: 'Add the missing field(s) to frontmatter in .claude/agents/*.md',
-        };
-    }
-    catch {
-        return { name: 'Agent Registry', status: 'warn', message: 'Could not build/parse agent registry' };
-    }
-}
-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' };
-    }
-}
-// Workers refresh at session start when output is >6h old — allow a grace
-// window beyond that before flagging staleness.
-const METRICS_FRESHNESS_MS = 12 * 60 * 60 * 1000; // 12 hours
-const MAX_DOCTOR_METRICS_BYTES = 5 * 1024 * 1024;
-function readMetricsJSON(name) {
-    try {
-        const p = join(process.cwd(), '.monomind', 'metrics', name);
-        if (!existsSync(p) || statSync(p).size > MAX_DOCTOR_METRICS_BYTES)
-            return null;
-        return JSON.parse(readFileSync(p, 'utf-8'));
-    }
-    catch (e) {
-        if (process.env.DEBUG || process.env.MONOMIND_DEBUG)
-            console.error(`[readMetricsJSON] failed to read ${name}:`, e);
-        return null;
-    }
-}
-/**
- * Worker metrics freshness — reports the age of the @monoes/hooks worker
- * output files (written at session start with a 6h staleness gate, or on
- * demand via `monomind hooks worker run <name>`), so missing/stale worker
- * output is visible without digging through .monomind/metrics.
- */
-export async function checkMetricsFreshness() {
-    const metricsDir = join(process.cwd(), '.monomind', 'metrics');
-    const knownOutputs = [
-        'codebase-map.json', 'security-audit.json', 'performance.json',
-        'consolidation.json', 'ddd-progress.json',
-    ];
-    if (!existsSync(metricsDir)) {
-        return { name: 'Worker Metrics', status: 'warn', message: 'No .monomind/metrics — workers have not run yet (they run at session start)', fix: 'monomind hooks worker run map' };
-    }
-    const now = Date.now();
-    const fresh = [];
-    const stale = [];
-    for (const name of knownOutputs) {
-        const p = join(metricsDir, name);
-        if (!existsSync(p))
-            continue;
-        try {
-            const ageMs = now - statSync(p).mtimeMs;
-            if (ageMs <= METRICS_FRESHNESS_MS)
-                fresh.push(name);
-            else
-                stale.push(name);
-        }
-        catch { /* skip unreadable */ }
-    }
-    if (fresh.length === 0 && stale.length === 0) {
-        return { name: 'Worker Metrics', status: 'warn', message: 'No worker output files found yet (they run at session start)', fix: 'monomind hooks worker run map' };
-    }
-    if (stale.length === 0) {
-        return { name: 'Worker Metrics', status: 'pass', message: `${fresh.length} metrics file(s) fresh (<12h)` };
-    }
-    return {
-        name: 'Worker Metrics',
-        status: 'warn',
-        message: `${stale.length} stale (>12h): ${stale.join(', ')}${fresh.length > 0 ? ` — ${fresh.length} fresh` : ''}`,
-        fix: 'monomind hooks worker run <name>  # map, audit, optimize, consolidate, ddd',
-    };
-}
-/**
- * Surfaces critical findings from the security-audit worker output.
- */
-export async function checkSecurityAuditFindings() {
-    const audit = readMetricsJSON('security-audit.json');
-    if (!audit) {
-        return { name: 'Security Audit', status: 'warn', message: 'No security-audit.json yet', fix: 'monomind hooks worker run audit' };
-    }
-    const riskLevel = (audit.riskLevel || 'low').toLowerCase();
-    const recommendations = audit.recommendations || [];
-    const priorityTargets = audit.priorityScanTargets || [];
-    const criticalCount = recommendations.length + (riskLevel === 'high' || riskLevel === 'critical' ? priorityTargets.length : 0);
-    if (riskLevel === 'critical' || riskLevel === 'high') {
-        return {
-            name: 'Security Audit',
-            status: 'fail',
-            message: `risk=${riskLevel}, ${criticalCount} critical finding(s) — ${priorityTargets.length} priority scan target(s)`,
-            fix: 'Review .monomind/metrics/security-audit.json priorityScanTargets and recommendations',
-        };
-    }
-    if (recommendations.length > 0) {
-        return { name: 'Security Audit', status: 'warn', message: `risk=${riskLevel}, ${recommendations.length} recommendation(s)` };
-    }
-    return { name: 'Security Audit', status: 'pass', message: `risk=${riskLevel}, no open findings` };
-}
-/**
- * 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' };
-    }
-}
-//# sourceMappingURL=doctor-project-checks.js.map