monomind 2.7.12 → 2.7.13

package/packages/@monomind/cli/dist/src/commands/doctor.d.ts

@@ -1,10 +0,0 @@
-/**
- * CLI Doctor Command
- * System diagnostics, dependency checks, config validation
- *
- * github.com/monoes/monomind
- */
-import type { Command } from '../types.js';
-export declare const doctorCommand: Command;
-export default doctorCommand;
-//# sourceMappingURL=doctor.d.ts.map

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

@@ -1,232 +0,0 @@
-/**
- * CLI Doctor Command
- * System diagnostics, dependency checks, config validation
- *
- * github.com/monoes/monomind
- */
-import * as path from 'path';
-import { output } from '../output.js';
-import { checkNodeVersion, checkNpmVersion, checkGit, checkGitRepo, checkDiskSpace, checkBuildTools, checkVersionFreshness, checkClaudeCode, installClaudeCode, } from './doctor-env-checks.js';
-import { checkConfigFile, checkMemoryDatabase, checkApiKeys, checkMcpServers, checkMonograph, checkMonographFreshness, checkMonoesMemory, checkHelpersFresh, fixStaleHelpers, checkMonoesIntegration, checkGuidanceGates, checkGitignoreCoverage, fixGitignoreCoverage, checkAgentRegistry, checkMemoryProficiency, checkMetricsFreshness, checkSecurityAuditFindings, checkSecondBrainModel, checkMemoryKnowledgeGraph, } from './doctor-project-checks.js';
-import { checkMonoesTools, fixMonoesTools } from './doctor-monoes-checks.js';
-function formatCheck(check) {
-    const icon = check.status === 'pass' ? output.success('✓') :
-        check.status === 'warn' ? output.warning('⚠') :
-            output.error('✗');
-    return `${icon} ${check.name}: ${check.message}`;
-}
-export const doctorCommand = {
-    name: 'doctor',
-    description: 'System diagnostics and health checks',
-    options: [
-        { name: 'fix', short: 'f', description: 'Apply local fixes (helper files, monoes tool shims, .gitignore entries) and show fix commands for the rest', type: 'boolean', default: false },
-        { name: 'install', short: 'i', description: 'Auto-install missing dependencies (Claude Code CLI)', type: 'boolean', default: false },
-        {
-            name: 'component', short: 'c',
-            description: 'Check specific component (version, node, npm, config, memory, api, git, mcp, claude, disk, typescript, monograph, graph-freshness, memory-pkg, helpers, monoes, gates, gitignore, registry, memory-proficiency, monoes-tools, metrics-freshness, security-audit)',
-            type: 'string',
-        },
-        { name: 'verbose', short: 'v', description: 'Verbose output', type: 'boolean', default: false },
-    ],
-    examples: [
-        { command: 'monomind doctor', description: 'Run full health check' },
-        { command: 'monomind doctor --fix', description: 'Show fixes for issues' },
-        { command: 'monomind doctor --install', description: 'Auto-install missing dependencies' },
-        { command: 'monomind doctor -c version', description: 'Check for stale npx cache' },
-        { command: 'monomind doctor -c claude', description: 'Check Claude Code CLI only' },
-        { command: 'monomind doctor -c monoes-tools --install', description: 'Check/fix monotask, mono-agent, mono-clip install issues (opt-in, not in the default run)' },
-    ],
-    action: async (ctx) => {
-        const showFix = ctx.flags.fix;
-        const autoInstall = ctx.flags.install;
-        const component = ctx.flags.component;
-        output.writeln();
-        output.writeln(output.bold('MonoMind Doctor'));
-        output.writeln(output.dim('System diagnostics and health check'));
-        output.writeln(output.dim('─'.repeat(50)));
-        output.writeln();
-        // Capability-aware scoping: skip code-specific checks in non-code directories
-        // (e.g. document/media/data-only projects created via `monomind init`).
-        let isCodeProject = true;
-        try {
-            const { loadFingerprint } = await import('../capabilities/index.js');
-            const monomindDir = path.join(process.cwd(), '.monomind');
-            const fingerprint = await loadFingerprint(monomindDir);
-            isCodeProject = !fingerprint || fingerprint.capabilities.code.confidence >= 0.1;
-        }
-        catch {
-            // Fingerprint unavailable — default to treating this as a code project
-            // so existing behavior is unaffected when the capabilities module can't load.
-            isCodeProject = true;
-        }
-        const alwaysOnChecks = [
-            checkVersionFreshness, checkNodeVersion, checkNpmVersion, checkClaudeCode,
-            checkConfigFile, checkMemoryDatabase, checkDiskSpace,
-            checkMonograph, checkMonoesMemory, checkHelpersFresh, checkMonoesIntegration,
-            checkGuidanceGates, checkAgentRegistry, checkGit, checkApiKeys,
-            checkMemoryProficiency, checkMetricsFreshness, checkSecurityAuditFindings,
-            checkSecondBrainModel, checkMemoryKnowledgeGraph,
-        ];
-        const codeOnlyChecks = [
-            checkGitRepo, checkMcpServers,
-            checkBuildTools, checkMonographFreshness, checkGitignoreCoverage,
-        ];
-        const allChecks = isCodeProject
-            ? [...alwaysOnChecks, ...codeOnlyChecks]
-            : alwaysOnChecks;
-        const componentMap = {
-            version: checkVersionFreshness, freshness: checkVersionFreshness,
-            node: checkNodeVersion, npm: checkNpmVersion, claude: checkClaudeCode,
-            config: checkConfigFile, memory: checkMemoryDatabase,
-            api: checkApiKeys, git: checkGit, mcp: checkMcpServers, disk: checkDiskSpace,
-            'second-brain': checkSecondBrainModel, kg: checkMemoryKnowledgeGraph,
-            typescript: checkBuildTools, monograph: checkMonograph,
-            'graph-freshness': checkMonographFreshness, 'memory-pkg': checkMonoesMemory,
-            helpers: checkHelpersFresh, monoes: checkMonoesIntegration,
-            gates: checkGuidanceGates, gitignore: checkGitignoreCoverage,
-            registry: checkAgentRegistry, 'memory-proficiency': checkMemoryProficiency,
-            'monoes-tools': checkMonoesTools,
-            'metrics-freshness': checkMetricsFreshness, 'security-audit': checkSecurityAuditFindings,
-        };
-        if (component && !componentMap[component]) {
-            output.writeln(output.error(`Unknown component: "${component}"`));
-            output.writeln(`Valid components: ${Object.keys(componentMap).sort().join(', ')}`);
-            return { success: false, exitCode: 1, data: { passed: 0, warnings: 0, failed: 1, results: [] } };
-        }
-        const checksToRun = component ? [componentMap[component]] : allChecks;
-        const results = [];
-        const fixes = [];
-        const spinner = output.createSpinner({ text: 'Running health checks in parallel...', spinner: 'dots' });
-        spinner.start();
-        try {
-            const settled = await Promise.allSettled(checksToRun.map(check => check()));
-            spinner.stop();
-            for (const result of settled) {
-                if (result.status === 'fulfilled') {
-                    const r = result.value;
-                    results.push(r);
-                    output.writeln(formatCheck(r));
-                    if (r.fix && r.status === 'fail')
-                        output.writeln(output.dim(`  Fix: ${r.fix}`));
-                    else if (r.fix && r.status === 'warn')
-                        output.writeln(output.dim(`  Hint: ${r.fix}`));
-                    if (r.fix && (r.status === 'fail' || r.status === 'warn'))
-                        fixes.push(`${r.name}: ${r.fix}`);
-                }
-                else {
-                    const err = { name: 'Check', status: 'fail', message: result.reason?.message || 'Unknown error' };
-                    results.push(err);
-                    output.writeln(formatCheck(err));
-                }
-            }
-        }
-        catch {
-            spinner.stop();
-            output.writeln(output.error('Failed to run health checks'));
-        }
-        // `--fix` applies the lightweight, local, no-network fixes (helper files,
-        // monoes CLI tool shims) — its description says "show fix commands" but
-        // silently doing nothing for these two beyond printing a hint is a worse
-        // outcome than just fixing them, and copying a bundled file locally is
-        // nothing like installing a package. `--install` additionally covers the
-        // Claude Code CLI, which is a real install (network fetch + binary setup)
-        // — kept opt-in separately so `--fix` alone never triggers that.
-        if (autoInstall || showFix) {
-            const claudeResult = results.find(r => r.name === 'Claude Code CLI');
-            if (autoInstall && claudeResult && claudeResult.status !== 'pass') {
-                if (await installClaudeCode()) {
-                    const newCheck = await checkClaudeCode();
-                    const idx = results.findIndex(r => r.name === 'Claude Code CLI');
-                    if (idx !== -1) {
-                        results[idx] = newCheck;
-                        const fixIdx = fixes.findIndex(f => f.startsWith('Claude Code CLI:'));
-                        if (fixIdx !== -1 && newCheck.status === 'pass')
-                            fixes.splice(fixIdx, 1);
-                    }
-                    output.writeln(formatCheck(newCheck));
-                }
-            }
-            const monoesToolsResult = results.find(r => r.name === 'monoes Tools');
-            if (monoesToolsResult && monoesToolsResult.status !== 'pass') {
-                if (await fixMonoesTools()) {
-                    const newCheck = await checkMonoesTools();
-                    const idx = results.findIndex(r => r.name === 'monoes Tools');
-                    if (idx !== -1) {
-                        results[idx] = newCheck;
-                        const fixIdx = fixes.findIndex(f => f.startsWith('monoes Tools:'));
-                        if (fixIdx !== -1 && newCheck.status === 'pass')
-                            fixes.splice(fixIdx, 1);
-                    }
-                    output.writeln(formatCheck(newCheck));
-                }
-            }
-            const gitignoreResult = results.find(r => r.name === 'Gitignore Coverage');
-            if (gitignoreResult && gitignoreResult.status !== 'pass') {
-                if (await fixGitignoreCoverage()) {
-                    const newCheck = await checkGitignoreCoverage();
-                    const idx = results.findIndex(r => r.name === 'Gitignore Coverage');
-                    if (idx !== -1) {
-                        results[idx] = newCheck;
-                        const fixIdx = fixes.findIndex(f => f.startsWith('Gitignore Coverage:'));
-                        if (fixIdx !== -1 && newCheck.status === 'pass')
-                            fixes.splice(fixIdx, 1);
-                    }
-                    output.writeln(formatCheck(newCheck));
-                }
-            }
-            const helpersResult = results.find(r => r.name === 'Helper Files');
-            if (helpersResult && helpersResult.status !== 'pass') {
-                if (await fixStaleHelpers()) {
-                    const newCheck = await checkHelpersFresh();
-                    const idx = results.findIndex(r => r.name === 'Helper Files');
-                    if (idx !== -1) {
-                        results[idx] = newCheck;
-                        const fixIdx = fixes.findIndex(f => f.startsWith('Helper Files:'));
-                        if (fixIdx !== -1 && newCheck.status === 'pass')
-                            fixes.splice(fixIdx, 1);
-                    }
-                    output.writeln(formatCheck(newCheck));
-                }
-            }
-        }
-        const passed = results.filter(r => r.status === 'pass').length;
-        const warnings = results.filter(r => r.status === 'warn').length;
-        const failed = results.filter(r => r.status === 'fail').length;
-        output.writeln();
-        output.writeln(output.dim('─'.repeat(50)));
-        output.writeln();
-        const summaryParts = [
-            output.success(`${passed} passed`),
-            warnings > 0 ? output.warning(`${warnings} warnings`) : null,
-            failed > 0 ? output.error(`${failed} failed`) : null,
-        ].filter(Boolean);
-        output.writeln(`Summary: ${summaryParts.join(', ')}`);
-        if (showFix && fixes.length > 0) {
-            output.writeln();
-            output.writeln(output.bold('Suggested Fixes:'));
-            output.writeln();
-            for (const fix of fixes)
-                output.writeln(output.dim(`  ${fix}`));
-        }
-        else if (!showFix) {
-            const warnFixes = results.filter(r => r.status === 'warn' && r.fix).length;
-            if (warnFixes > 0)
-                output.writeln(output.dim(`\nRun with --fix to see ${warnFixes} suggested fix${warnFixes > 1 ? 'es' : ''} for warnings`));
-        }
-        if (failed > 0) {
-            output.writeln();
-            output.writeln(output.error('Some checks failed. Please address the issues above.'));
-            return { success: false, exitCode: 1, data: { passed, warnings, failed, results } };
-        }
-        else if (warnings > 0) {
-            output.writeln();
-            output.writeln(output.warning('All checks passed with some warnings.'));
-            return { success: true, data: { passed, warnings, failed, results } };
-        }
-        output.writeln();
-        output.writeln(output.success('All checks passed! System is healthy.'));
-        return { success: true, data: { passed, warnings, failed, results } };
-    },
-};
-export default doctorCommand;
-//# sourceMappingURL=doctor.js.map

package/packages/@monomind/cli/dist/src/commands/guidance.d.ts

@@ -1,12 +0,0 @@
-/**
- * CLI Guidance Command
- *
- * Wires the enforcement gates (destructive-ops + secrets) into Claude Code hooks.
- * The gates themselves live in .claude/helpers/handlers/gates-handler.cjs — a
- * self-contained regex table that runs on every PreToolUse. This command only
- * registers the hook entries in .claude/settings.json.
- */
-import type { Command } from '../types.js';
-export declare const guidanceCommand: Command;
-export default guidanceCommand;
-//# sourceMappingURL=guidance.d.ts.map

package/packages/@monomind/cli/dist/src/commands/guidance.js

@@ -1,163 +0,0 @@
-/**
- * CLI Guidance Command
- *
- * Wires the enforcement gates (destructive-ops + secrets) into Claude Code hooks.
- * The gates themselves live in .claude/helpers/handlers/gates-handler.cjs — a
- * self-contained regex table that runs on every PreToolUse. This command only
- * registers the hook entries in .claude/settings.json.
- */
-import { output } from '../output.js';
-// setup subcommand
-const setupCommand = {
-    name: 'setup',
-    description: 'Wire enforcement gates into Claude Code hooks (destructive-ops + secrets)',
-    options: [
-        { name: 'dry-run', type: 'boolean', description: 'Show what would change without writing', default: 'false' },
-        { name: 'force', type: 'boolean', description: 'Overwrite existing gate hooks', default: 'false' },
-        { name: 'project-dir', short: 'p', type: 'string', description: 'Project directory (default: cwd)' },
-    ],
-    examples: [
-        { command: 'monomind guidance setup', description: 'Wire gates into .claude/settings.json' },
-        { command: 'monomind guidance setup --dry-run', description: 'Preview changes without writing' },
-    ],
-    action: async (ctx) => {
-        const dryRun = ctx.flags['dry-run'] === true;
-        const force = ctx.flags.force === true;
-        const projectDir = ctx.flags['project-dir'] || ctx.cwd;
-        output.writeln();
-        output.writeln(output.bold('Guidance Gates Setup'));
-        output.writeln(output.dim('─'.repeat(50)));
-        output.writeln();
-        const { readFileSync, writeFileSync, existsSync, statSync } = await import('node:fs');
-        const { join } = await import('node:path');
-        const settingsPath = join(projectDir, '.claude', 'settings.json');
-        const gatesHandlerPath = join(projectDir, '.claude', 'helpers', 'handlers', 'gates-handler.cjs');
-        // Verify the gate handler exists
-        if (!existsSync(gatesHandlerPath)) {
-            output.writeln(output.error('gates-handler.cjs not found. Run `monomind init` first to set up the helpers directory.'));
-            return { success: false, message: 'gates-handler.cjs missing' };
-        }
-        // Load or create settings.json
-        let settings = {};
-        if (existsSync(settingsPath) && statSync(settingsPath).size <= 1024 * 1024) {
-            try {
-                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-            }
-            catch {
-                output.writeln(output.error(`Could not parse ${settingsPath}`));
-                return { success: false, message: 'settings.json parse error' };
-            }
-        }
-        const hooks = (settings.hooks || {});
-        const preToolUse = hooks.PreToolUse || [];
-        const PRE_BASH_MATCHER = 'Bash';
-        const PRE_BASH_COMMAND = 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" pre-bash';
-        // Keep in step with .claude/settings.json and init/settings-generator.ts.
-        // NotebookEdit is listed explicitly: its content field is `new_source`, so
-        // it slipped past the secret gate until the handler learned to read it.
-        const PRE_WRITE_MATCHER = 'Write|Edit|MultiEdit|NotebookEdit';
-        const PRE_WRITE_COMMAND = 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" pre-write';
-        // Find any existing Bash/Write entry (may have different hooks from other tools)
-        const existingBashEntry = preToolUse.find(e => e.matcher === PRE_BASH_MATCHER);
-        const alreadyHasPreBash = existingBashEntry?.hooks.some(h => h.command.includes('pre-bash')) ?? false;
-        // Find by capability, not exact string: a settings.json written before
-        // NotebookEdit was added still says 'Write|Edit|MultiEdit', and an exact
-        // match would miss it and append a second, overlapping entry.
-        const existingWriteEntry = preToolUse.find(e => /\bWrite\b/.test(e.matcher ?? ''));
-        const alreadyHasPreWrite = existingWriteEntry?.hooks.some(h => h.command.includes('pre-write')) ?? false;
-        const changes = [];
-        // Register pre-bash (destructive-ops gate)
-        if (alreadyHasPreBash && !force) {
-            output.writeln(output.dim(`  ✓ PreToolUse[${PRE_BASH_MATCHER}]              → pre-bash   (already registered)`));
-        }
-        else {
-            if (force && existingBashEntry) {
-                // Remove only the old pre-bash hook from an existing Bash entry (preserve other hooks)
-                existingBashEntry.hooks = existingBashEntry.hooks.filter(h => !h.command.includes('pre-bash'));
-            }
-            const newHook = { type: 'command', command: PRE_BASH_COMMAND, timeout: 5000 };
-            if (existingBashEntry) {
-                // Merge into existing Bash entry — avoids creating a duplicate top-level Bash matcher
-                existingBashEntry.hooks.push(newHook);
-            }
-            else {
-                preToolUse.push({ matcher: PRE_BASH_MATCHER, hooks: [newHook] });
-            }
-            changes.push(`PreToolUse[${PRE_BASH_MATCHER}] → pre-bash (destructive-ops gate)`);
-            output.writeln(output.success(`  + PreToolUse[${PRE_BASH_MATCHER}]              → pre-bash   (destructive-ops gate)`));
-        }
-        // Register pre-write (secrets gate)
-        if (alreadyHasPreWrite && !force) {
-            output.writeln(output.dim(`  ✓ PreToolUse[${PRE_WRITE_MATCHER}] → pre-write  (already registered)`));
-        }
-        else {
-            if (force && existingWriteEntry) {
-                // Remove only the old pre-write hook from an existing Write entry (preserve other hooks)
-                existingWriteEntry.hooks = existingWriteEntry.hooks.filter(h => !h.command.includes('pre-write'));
-            }
-            const newWriteHook = { type: 'command', command: PRE_WRITE_COMMAND, timeout: 3000 };
-            if (existingWriteEntry) {
-                // Merge into existing Write entry — avoids creating a duplicate top-level Write|Edit|MultiEdit matcher
-                existingWriteEntry.hooks.push(newWriteHook);
-            }
-            else {
-                preToolUse.push({ matcher: PRE_WRITE_MATCHER, hooks: [newWriteHook] });
-            }
-            changes.push(`PreToolUse[${PRE_WRITE_MATCHER}] → pre-write (secrets detection)`);
-            output.writeln(output.success(`  + PreToolUse[${PRE_WRITE_MATCHER}] → pre-write  (secrets gate)`));
-        }
-        if (changes.length === 0) {
-            output.writeln();
-            output.writeln(output.dim('Nothing to change.'));
-            return { success: true, data: { changes: [] } };
-        }
-        if (dryRun) {
-            output.writeln();
-            output.writeln(output.dim(`Dry run — would write ${settingsPath}`));
-            return { success: true, data: { changes, dryRun: true } };
-        }
-        // Write back
-        hooks.PreToolUse = preToolUse;
-        settings.hooks = hooks;
-        try {
-            writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            return { success: false, message: `Failed to write ${settingsPath}: ${msg}` };
-        }
-        output.writeln();
-        output.writeln(output.success(`Wrote ${settingsPath}`));
-        output.writeln();
-        output.writeln(output.dim('Gates active on next Claude Code session:'));
-        output.writeln(output.dim('  • Bash commands checked for destructive operations (rm -rf, DROP TABLE, git push --force …)'));
-        output.writeln(output.dim('  • Write/Edit/MultiEdit checked for secrets (API keys, tokens, private keys …)'));
-        return { success: true, data: { changes } };
-    },
-};
-// Main guidance command
-export const guidanceCommand = {
-    name: 'guidance',
-    description: 'Wire enforcement gates (destructive-ops + secrets) into Claude Code hooks',
-    aliases: ['guide', 'policy'],
-    subcommands: [setupCommand],
-    options: [],
-    examples: [
-        { command: 'monomind guidance setup', description: 'Wire enforcement gates into Claude Code hooks' },
-        { command: 'monomind guidance setup --dry-run', description: 'Preview changes without writing' },
-    ],
-    action: async (ctx) => {
-        output.writeln();
-        output.writeln(output.bold('Guidance Gates'));
-        output.writeln(output.dim('─'.repeat(50)));
-        output.writeln();
-        output.writeln('Available subcommands:');
-        output.writeln(`  ${output.bold('setup')}     Wire enforcement gates into Claude Code hooks`);
-        output.writeln();
-        output.writeln(output.dim('Gate enforcement runs in .claude/helpers/handlers/gates-handler.cjs on every PreToolUse.'));
-        output.writeln(output.dim('Use monomind guidance setup --help for details'));
-        return { success: true };
-    },
-};
-export default guidanceCommand;
-//# sourceMappingURL=guidance.js.map

package/packages/@monomind/cli/dist/src/commands/hooks-core-commands.d.ts

@@ -1,10 +0,0 @@
-/**
- * Hooks Core Commands
- * Pre/post edit and command hook subcommands extracted from hooks.ts (ARCH-1)
- */
-import type { Command } from '../types.js';
-export declare const preEditCommand: Command;
-export declare const postEditCommand: Command;
-export declare const preCommandCommand: Command;
-export declare const postCommandCommand: Command;
-//# sourceMappingURL=hooks-core-commands.d.ts.map