@cleocode/cleo 2026.4.59 → 2026.4.62

package/dist/cli/commands/nexus.js

@@ -1,2290 +0,0 @@
-/**
- * CLI nexus command group - Cross-project NEXUS operations.
- *
- * Thin CLI wrappers routing through the dispatch layer.
- * All business logic lives in src/dispatch/domains/nexus.ts.
- *
- * `nexus analyze` is implemented directly here because it requires
- * `@cleocode/nexus` pipeline access and `@cleocode/core` DB access together,
- * and routing through the dispatch layer would create awkward coupling.
- *
- * @task T4554, T5323, T5330, T481, T534
- * @epic T4545
- */
-import path from 'node:path';
-import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
-/**
- * Priority score for nexus node kinds when ranking symbol search results.
- *
- * Callable symbols (function, method) rank highest so that `nexus context`
- * and `nexus impact` return meaningful callers/callees instead of
- * file/folder structural nodes which have zero `calls` relations.
- *
- * Lower score = higher priority (sort ascending).
- */
-const NODE_KIND_PRIORITY = {
-    function: 0,
-    method: 1,
-    constructor: 2,
-    class: 3,
-    interface: 4,
-    type_alias: 5,
-    enum: 6,
-    constant: 7,
-    property: 8,
-    variable: 9,
-    static: 10,
-    struct: 11,
-    trait: 12,
-    impl: 13,
-    macro: 14,
-    // Structural/module nodes come last — they have no `calls` relations
-    module: 20,
-    namespace: 21,
-    record: 22,
-    delegate: 23,
-    union: 24,
-    typedef: 25,
-    annotation: 26,
-    template: 27,
-    route: 28,
-    tool: 29,
-    section: 30,
-    import: 31,
-    export: 32,
-    type: 33,
-    file: 40,
-    folder: 41,
-};
-/**
- * Generate GEXF (Gephi Graph Exchange XML Format) from nodes and relations.
- *
- * GEXF is a standard format for graph visualization. Supports node attributes,
- * edge weights (confidence), and color coding by node kind.
- *
- * @param nodes - Array of nexus nodes
- * @param relations - Array of nexus relations
- * @returns GEXF XML string
- */
-function generateGexf(nodes, relations) {
-    // Build node by ID map for edge resolution
-    const nodeById = new Map();
-    for (const n of nodes) {
-        nodeById.set(String(n['id']), n);
-    }
-    // Color map for node kinds (hex colors for visualization)
-    const kindColors = {
-        function: '#3498db', // blue
-        method: '#2980b9', // darker blue
-        class: '#e74c3c', // red
-        interface: '#e67e22', // orange
-        file: '#95a5a6', // gray
-        folder: '#34495e', // dark gray
-        community: '#9b59b6', // purple
-        process: '#1abc9c', // teal
-        import: '#f39c12', // amber
-        default: '#7f8c8d', // medium gray
-    };
-    const getNodeColor = (kind) => {
-        return kindColors[kind] ?? kindColors['default'];
-    };
-    // GEXF XML header
-    let gexf = '<?xml version="1.0" encoding="UTF-8"?>\n';
-    gexf +=
-        '<gexf xmlns="http://www.gexf.net/1.2draft" xmlns:viz="http://www.gexf.net/1.2draft/viz" version="1.2">\n';
-    gexf += '  <meta lastmodifieddate="' + new Date().toISOString().split('T')[0] + '">\n';
-    gexf += '    <creator>CLEO nexus export</creator>\n';
-    gexf += '    <description>Code intelligence graph from CLEO nexus</description>\n';
-    gexf += '  </meta>\n';
-    gexf += '  <graph mode="static" defaultedgetype="directed">\n';
-    // Attributes
-    gexf += '    <attributes class="node">\n';
-    gexf += '      <attribute id="kind" title="Node Kind" type="string" />\n';
-    gexf += '      <attribute id="filePath" title="File Path" type="string" />\n';
-    gexf += '      <attribute id="language" title="Language" type="string" />\n';
-    gexf += '      <attribute id="startLine" title="Start Line" type="integer" />\n';
-    gexf += '      <attribute id="endLine" title="End Line" type="integer" />\n';
-    gexf += '      <attribute id="isExported" title="Is Exported" type="boolean" />\n';
-    gexf += '      <attribute id="projectId" title="Project ID" type="string" />\n';
-    gexf += '    </attributes>\n';
-    gexf += '    <attributes class="edge">\n';
-    gexf += '      <attribute id="relationType" title="Relation Type" type="string" />\n';
-    gexf += '      <attribute id="confidence" title="Confidence" type="double" />\n';
-    gexf += '      <attribute id="reason" title="Reason" type="string" />\n';
-    gexf += '    </attributes>\n';
-    // Nodes
-    gexf += '    <nodes>\n';
-    for (const node of nodes) {
-        const nodeId = String(node['id']).replace(/[<>"'&]/g, (c) => {
-            const map = {
-                '<': '&lt;',
-                '>': '&gt;',
-                '"': '&quot;',
-                "'": '&apos;',
-                '&': '&amp;',
-            };
-            return map[c];
-        });
-        const label = String(node['label'] ?? node['id']);
-        const kind = String(node['kind'] ?? 'unknown');
-        const color = getNodeColor(kind);
-        gexf += `      <node id="${nodeId}" label="${escapeXml(label)}">\n`;
-        gexf += `        <viz:color r="${hexToRgb(color).r}" g="${hexToRgb(color).g}" b="${hexToRgb(color).b}" />\n`;
-        gexf += '        <attvalues>\n';
-        gexf += `          <attvalue id="kind" value="${escapeXml(kind)}" />\n`;
-        if (node['filePath']) {
-            gexf += `          <attvalue id="filePath" value="${escapeXml(String(node['filePath']))}" />\n`;
-        }
-        if (node['language']) {
-            gexf += `          <attvalue id="language" value="${escapeXml(String(node['language']))}" />\n`;
-        }
-        if (node['startLine'] != null) {
-            gexf += `          <attvalue id="startLine" value="${node['startLine']}" />\n`;
-        }
-        if (node['endLine'] != null) {
-            gexf += `          <attvalue id="endLine" value="${node['endLine']}" />\n`;
-        }
-        if (node['isExported'] != null) {
-            gexf += `          <attvalue id="isExported" value="${node['isExported'] ? 'true' : 'false'}" />\n`;
-        }
-        if (node['projectId']) {
-            gexf += `          <attvalue id="projectId" value="${escapeXml(String(node['projectId']))}" />\n`;
-        }
-        gexf += '        </attvalues>\n';
-        gexf += '      </node>\n';
-    }
-    gexf += '    </nodes>\n';
-    // Edges
-    gexf += '    <edges>\n';
-    for (let i = 0; i < relations.length; i++) {
-        const rel = relations[i];
-        const sourceId = String(rel['sourceId']).replace(/[<>"'&]/g, (c) => {
-            const map = {
-                '<': '&lt;',
-                '>': '&gt;',
-                '"': '&quot;',
-                "'": '&apos;',
-                '&': '&amp;',
-            };
-            return map[c];
-        });
-        const targetId = String(rel['targetId']).replace(/[<>"'&]/g, (c) => {
-            const map = {
-                '<': '&lt;',
-                '>': '&gt;',
-                '"': '&quot;',
-                "'": '&apos;',
-                '&': '&amp;',
-            };
-            return map[c];
-        });
-        // Skip edges where source or target don't exist in our node set
-        // (external references or unresolved imports)
-        if (!nodeById.has(String(rel['sourceId'])) || !nodeById.has(String(rel['targetId']))) {
-            continue;
-        }
-        const confidence = typeof rel['confidence'] === 'number' ? rel['confidence'] : 1.0;
-        const relationType = String(rel['type'] ?? 'unknown');
-        const reason = rel['reason'] ? String(rel['reason']) : '';
-        gexf += `      <edge id="e${i}" source="${sourceId}" target="${targetId}" weight="${confidence}">\n`;
-        gexf += '        <attvalues>\n';
-        gexf += `          <attvalue id="relationType" value="${escapeXml(relationType)}" />\n`;
-        gexf += `          <attvalue id="confidence" value="${confidence}" />\n`;
-        if (reason) {
-            gexf += `          <attvalue id="reason" value="${escapeXml(reason)}" />\n`;
-        }
-        gexf += '        </attvalues>\n';
-        gexf += '      </edge>\n';
-    }
-    gexf += '    </edges>\n';
-    gexf += '  </graph>\n';
-    gexf += '</gexf>\n';
-    return gexf;
-}
-/**
- * Escape XML special characters.
- */
-function escapeXml(str) {
-    return String(str).replace(/[<>"'&]/g, (c) => {
-        const map = {
-            '<': '&lt;',
-            '>': '&gt;',
-            '"': '&quot;',
-            "'": '&apos;',
-            '&': '&amp;',
-        };
-        return map[c];
-    });
-}
-/**
- * Convert hex color to RGB object.
- */
-function hexToRgb(hex) {
-    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-    return result
-        ? {
-            r: parseInt(result[1], 16),
-            g: parseInt(result[2], 16),
-            b: parseInt(result[3], 16),
-        }
-        : { r: 127, g: 140, b: 141 };
-}
-/**
- * Sort symbol search results so that callable nodes (function, method, class)
- * appear before structural nodes (file, folder). Within the same kind, prefer
- * exact name matches over partial matches.
- */
-function sortMatchingNodes(nodes, symbolName) {
-    const lowerSymbol = symbolName.toLowerCase();
-    return [...nodes].sort((a, b) => {
-        const kindA = String(a['kind'] ?? '');
-        const kindB = String(b['kind'] ?? '');
-        const prioA = NODE_KIND_PRIORITY[kindA] ?? 15;
-        const prioB = NODE_KIND_PRIORITY[kindB] ?? 15;
-        if (prioA !== prioB)
-            return prioA - prioB;
-        // Within same kind: exact name matches before partial matches
-        const nameA = String(a['name'] ?? '').toLowerCase();
-        const nameB = String(b['name'] ?? '').toLowerCase();
-        const exactA = nameA === lowerSymbol ? 0 : 1;
-        const exactB = nameB === lowerSymbol ? 0 : 1;
-        return exactA - exactB;
-    });
-}
-/**
- * Register the nexus command group.
- * @task T4554
- */
-export function registerNexusCommand(program) {
-    const nexus = program.command('nexus').description('Cross-project NEXUS operations');
-    // ── nexus init ──────────────────────────────────────────────────────
-    nexus
-        .command('init')
-        .description('Initialize NEXUS directory structure and registry')
-        .action(async () => {
-        await dispatchFromCli('mutate', 'nexus', 'init', {}, { command: 'nexus' });
-    });
-    // ── nexus register ──────────────────────────────────────────────────
-    nexus
-        .command('register <path>')
-        .description('Register a project in the global registry')
-        .option('--name <name>', 'Custom project name (default: directory name)')
-        .option('--permissions <perms>', 'Permissions: read|write|execute', 'read')
-        .action(async (projectPath, opts) => {
-        await dispatchFromCli('mutate', 'nexus', 'register', {
-            path: projectPath,
-            name: opts['name'],
-            permission: opts['permissions'],
-        }, { command: 'nexus' });
-    });
-    // ── nexus unregister ────────────────────────────────────────────────
-    nexus
-        .command('unregister <nameOrHash>')
-        .description('Remove a project from the registry')
-        .action(async (nameOrHash) => {
-        await dispatchFromCli('mutate', 'nexus', 'unregister', {
-            name: nameOrHash,
-        }, { command: 'nexus' });
-    });
-    // ── nexus list ──────────────────────────────────────────────────────
-    nexus
-        .command('list')
-        .description('List all registered projects')
-        .action(async () => {
-        await dispatchFromCli('query', 'nexus', 'list', {}, { command: 'nexus' });
-    });
-    // ── nexus status ────────────────────────────────────────────────────
-    // Shows both NEXUS registry status AND code intelligence index freshness.
-    // When invoked with a path, shows index freshness for that project.
-    nexus
-        .command('status [path]')
-        .description('Show code intelligence index freshness: file count, node/relation counts, last indexed time, stale files. Falls back to NEXUS registry status if code-intelligence index is unavailable.')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from path)')
-        .option('--json', 'Output as JSON (LAFS envelope format)')
-        .action(async (targetPath, opts) => {
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        const startTime = Date.now();
-        try {
-            const [{ getNexusDb, nexusSchema }, { getIndexStats }] = await Promise.all([
-                import('@cleocode/core/store/nexus-sqlite'),
-                import('@cleocode/nexus/pipeline'),
-            ]);
-            const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-            const db = await getNexusDb();
-            const tables = {
-                nexusNodes: nexusSchema.nexusNodes,
-                nexusRelations: nexusSchema.nexusRelations,
-            };
-            const stats = await getIndexStats(projectId, repoPath, db, tables);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                const envelope = {
-                    success: true,
-                    data: { projectId, repoPath, ...stats },
-                    meta: {
-                        operation: 'nexus.status',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                };
-                process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-            }
-            else if (!stats.indexed) {
-                process.stdout.write(`[nexus] Index status for: ${repoPath}\n` +
-                    `  Status:     NOT INDEXED\n` +
-                    `  Run 'cleo nexus analyze' to build the index.\n`);
-            }
-            else {
-                const staleLabel = stats.staleFileCount < 0
-                    ? 'unknown'
-                    : stats.staleFileCount === 0
-                        ? 'up to date'
-                        : `${stats.staleFileCount} stale`;
-                process.stdout.write(`[nexus] Index status for: ${repoPath}\n` +
-                    `  Project ID:   ${projectId}\n` +
-                    `  Nodes:        ${stats.nodeCount}\n` +
-                    `  Relations:    ${stats.relationCount}\n` +
-                    `  Files:        ${stats.fileCount}\n` +
-                    `  Last indexed: ${stats.lastIndexedAt ?? 'never'}\n` +
-                    `  Staleness:    ${staleLabel}\n`);
-            }
-        }
-        catch (err) {
-            // Fall back to NEXUS registry status on error
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_STATUS_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.status',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-                await dispatchFromCli('query', 'nexus', 'status', {}, { command: 'nexus' });
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus show ─────────────────────────────────────────────────────
-    nexus
-        .command('show <name>')
-        .description('Show details for a registered project by name')
-        .action(async (name) => {
-        await dispatchFromCli('query', 'nexus', 'show', {
-            name,
-        }, { command: 'nexus' });
-    });
-    // ── nexus resolve ───────────────────────────────────────────────────
-    nexus
-        .command('resolve <taskRef>')
-        .alias('query')
-        .description('Resolve a task reference across projects (project:T### or T###)')
-        .action(async (taskRef) => {
-        await dispatchFromCli('query', 'nexus', 'resolve', {
-            query: taskRef,
-        }, { command: 'nexus' });
-    });
-    // ── nexus discover ──────────────────────────────────────────────────
-    nexus
-        .command('discover <taskQuery>')
-        .description('Find related tasks across projects')
-        .option('--method <method>', 'Discovery method: labels|description|files|auto', 'auto')
-        .option('--limit <n>', 'Max results', parseInt, 10)
-        .action(async (taskQuery, opts) => {
-        await dispatchFromCli('query', 'nexus', 'discover', {
-            query: taskQuery,
-            method: opts['method'],
-            limit: opts['limit'],
-        }, { command: 'nexus' });
-    });
-    // ── nexus search ────────────────────────────────────────────────────
-    nexus
-        .command('search <pattern>')
-        .description('Search tasks across projects by pattern')
-        .option('--project <name>', 'Limit search to specific project')
-        .option('--limit <n>', 'Max results', parseInt, 20)
-        .action(async (pattern, opts) => {
-        await dispatchFromCli('query', 'nexus', 'search', {
-            pattern,
-            project: opts['project'],
-            limit: opts['limit'],
-        }, { command: 'nexus' });
-    });
-    // ── nexus deps ──────────────────────────────────────────────────────
-    nexus
-        .command('deps <taskQuery>')
-        .description('Show cross-project dependencies')
-        .option('--reverse', 'Show reverse dependencies (what depends on this)')
-        .action(async (taskQuery, opts) => {
-        await dispatchFromCli('query', 'nexus', 'deps', {
-            query: taskQuery,
-            direction: opts['reverse'] ? 'reverse' : 'forward',
-        }, { command: 'nexus' });
-    });
-    // ── nexus critical-path ───────────────────────────────────────────
-    nexus
-        .command('critical-path')
-        .description('Show global critical path across all registered projects')
-        .action(async () => {
-        await dispatchFromCli('query', 'nexus', 'path.show', {}, { command: 'nexus' });
-    });
-    // ── nexus blocking ────────────────────────────────────────────────
-    nexus
-        .command('blocking <taskQuery>')
-        .description('Show blocking impact analysis for a task')
-        .action(async (taskQuery) => {
-        await dispatchFromCli('query', 'nexus', 'blockers.show', {
-            query: taskQuery,
-        }, { command: 'nexus' });
-    });
-    // ── nexus orphans ─────────────────────────────────────────────────
-    nexus
-        .command('orphans')
-        .description('Detect broken cross-project dependency references')
-        .action(async () => {
-        await dispatchFromCli('query', 'nexus', 'orphans.list', {}, { command: 'nexus' });
-    });
-    // ── nexus sync ──────────────────────────────────────────────────────
-    nexus
-        .command('sync [project]')
-        .description('Sync project metadata (task count, labels)')
-        .action(async (project) => {
-        if (project) {
-            await dispatchFromCli('mutate', 'nexus', 'sync', {
-                name: project,
-            }, { command: 'nexus' });
-        }
-        else {
-            await dispatchFromCli('mutate', 'nexus', 'sync', {}, { command: 'nexus' });
-        }
-    });
-    // ── nexus reconcile ──────────────────────────────────────────────────
-    nexus
-        .command('reconcile')
-        .description('Reconcile current project with NEXUS registry (auto-register if new, update path if moved)')
-        .option('--path <path>', 'Project path (default: current directory)')
-        .action(async (opts) => {
-        await dispatchFromCli('mutate', 'nexus', 'reconcile', {
-            projectRoot: opts['path'],
-        }, { command: 'nexus' });
-    });
-    // ── nexus graph ───────────────────────────────────────────────────
-    nexus
-        .command('graph')
-        .description('Show full dependency graph across all registered projects')
-        .action(async () => {
-        await dispatchFromCli('query', 'nexus', 'graph', {}, { command: 'nexus' });
-    });
-    // ── nexus share-status ────────────────────────────────────────────
-    nexus
-        .command('share-status')
-        .description('Show multi-contributor sharing status for the current project')
-        .action(async () => {
-        await dispatchFromCli('query', 'nexus', 'share.status', {}, { command: 'nexus' });
-    });
-    // ── nexus transfer-preview ────────────────────────────────────────
-    nexus
-        .command('transfer-preview <taskIds...>')
-        .description('Preview a task transfer between projects (dry-run, no changes made)')
-        .requiredOption('--from <project>', 'Source project name')
-        .requiredOption('--to <project>', 'Target project name')
-        .option('--mode <mode>', 'Transfer mode: copy|move', 'copy')
-        .option('--scope <scope>', 'Transfer scope: single|subtree', 'subtree')
-        .action(async (taskIds, opts) => {
-        await dispatchFromCli('query', 'nexus', 'transfer.preview', {
-            taskIds,
-            sourceProject: opts['from'],
-            targetProject: opts['to'],
-            mode: opts['mode'],
-            scope: opts['scope'],
-        }, { command: 'nexus' });
-    });
-    // ── nexus transfer ────────────────────────────────────────────────
-    nexus
-        .command('transfer <taskIds...>')
-        .description('Transfer tasks from one project to another')
-        .requiredOption('--from <project>', 'Source project name')
-        .requiredOption('--to <project>', 'Target project name')
-        .option('--mode <mode>', 'Transfer mode: copy|move', 'copy')
-        .option('--scope <scope>', 'Transfer scope: single|subtree', 'subtree')
-        .option('--on-conflict <strategy>', 'Conflict strategy: rename|skip|duplicate|fail', 'rename')
-        .option('--transfer-brain', 'Also transfer associated brain memory entries', false)
-        .action(async (taskIds, opts) => {
-        await dispatchFromCli('mutate', 'nexus', 'transfer', {
-            taskIds,
-            sourceProject: opts['from'],
-            targetProject: opts['to'],
-            mode: opts['mode'],
-            scope: opts['scope'],
-            onConflict: opts['onConflict'],
-            transferBrain: opts['transferBrain'],
-        }, { command: 'nexus' });
-    });
-    // ── nexus permission ──────────────────────────────────────────────
-    const permission = nexus
-        .command('permission')
-        .description('Manage permissions for registered projects');
-    permission
-        .command('set <name> <level>')
-        .description('Set permission level for a registered project (read|write|execute)')
-        .action(async (name, level) => {
-        await dispatchFromCli('mutate', 'nexus', 'permission.set', {
-            name,
-            level,
-        }, { command: 'nexus' });
-    });
-    // ── nexus share ───────────────────────────────────────────────────
-    const share = nexus.command('share').description('Multi-contributor sharing operations');
-    share
-        .command('export')
-        .description('Export a snapshot of current project state for sharing')
-        .option('--output <path>', 'Output file path (default: auto-generated in current directory)')
-        .action(async (opts) => {
-        await dispatchFromCli('mutate', 'nexus', 'share.snapshot.export', {
-            outputPath: opts['output'],
-        }, { command: 'nexus' });
-    });
-    share
-        .command('import <file>')
-        .description('Import a shared project snapshot')
-        .action(async (file) => {
-        await dispatchFromCli('mutate', 'nexus', 'share.snapshot.import', {
-            inputPath: file,
-        }, { command: 'nexus' });
-    });
-    // ── nexus clusters ────────────────────────────────────────────────────────
-    nexus
-        .command('clusters [path]')
-        .description('List all detected communities (Louvain clusters) from the last analysis')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from path)')
-        .action(async (targetPath, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-        try {
-            const { getNexusDb, nexusSchema } = await import('@cleocode/core/store/nexus-sqlite');
-            const db = await getNexusDb();
-            // Query all nodes for this project, filter to community kind in-memory
-            // (avoids complex Drizzle where clause on an enum column).
-            // NodeSQLiteDatabase uses sync Drizzle — .all() returns a plain array,
-            // not a Promise, so wrap in try-catch rather than using .catch().
-            let rows = [];
-            try {
-                rows = db.select().from(nexusSchema.nexusNodes).all();
-            }
-            catch {
-                rows = [];
-            }
-            const communities = rows.filter((r) => r['kind'] === 'community' && r['projectId'] === projectId);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: {
-                        projectId,
-                        repoPath,
-                        count: communities.length,
-                        communities: communities.map((c) => {
-                            const meta = typeof c['metaJson'] === 'string'
-                                ? JSON.parse(c['metaJson'])
-                                : {};
-                            return {
-                                id: c['id'],
-                                label: c['label'],
-                                symbolCount: meta['symbolCount'] ?? 0,
-                                cohesion: meta['cohesion'] ?? 0,
-                            };
-                        }),
-                    },
-                    meta: {
-                        operation: 'nexus.clusters',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                if (communities.length === 0) {
-                    process.stdout.write(`[nexus] No communities found for project ${projectId}.\n` +
-                        `  Run 'cleo nexus analyze' first.\n`);
-                }
-                else {
-                    process.stdout.write(`[nexus] Communities for project ${projectId} (${communities.length} total):\n`);
-                    for (const c of communities) {
-                        const meta = typeof c['metaJson'] === 'string'
-                            ? JSON.parse(c['metaJson'])
-                            : {};
-                        const symbolCount = meta['symbolCount'] ?? 0;
-                        const cohesion = typeof meta['cohesion'] === 'number'
-                            ? meta['cohesion'].toFixed(3)
-                            : '0.000';
-                        process.stdout.write(`  ${String(c['id']).padEnd(16)}  label=${String(c['label']).padEnd(24)}  symbols=${String(symbolCount).padStart(5)}  cohesion=${cohesion}\n`);
-                    }
-                }
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_CLUSTERS_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.clusters',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus flows ───────────────────────────────────────────────────────────
-    nexus
-        .command('flows [path]')
-        .description('List all detected execution flows (processes) from the last analysis')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from path)')
-        .action(async (targetPath, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-        try {
-            const { getNexusDb, nexusSchema } = await import('@cleocode/core/store/nexus-sqlite');
-            const db = await getNexusDb();
-            // NodeSQLiteDatabase uses sync Drizzle — .all() returns a plain array,
-            // not a Promise, so wrap in try-catch rather than using .catch().
-            let rows = [];
-            try {
-                rows = db.select().from(nexusSchema.nexusNodes).all();
-            }
-            catch {
-                rows = [];
-            }
-            const processes = rows.filter((r) => r['kind'] === 'process' && r['projectId'] === projectId);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: {
-                        projectId,
-                        repoPath,
-                        count: processes.length,
-                        flows: processes.map((p) => {
-                            const meta = typeof p['metaJson'] === 'string'
-                                ? JSON.parse(p['metaJson'])
-                                : {};
-                            return {
-                                id: p['id'],
-                                label: p['label'],
-                                stepCount: meta['stepCount'] ?? 0,
-                                processType: meta['processType'] ?? 'intra_community',
-                                entryPointId: meta['entryPointId'] ?? null,
-                            };
-                        }),
-                    },
-                    meta: {
-                        operation: 'nexus.flows',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                if (processes.length === 0) {
-                    process.stdout.write(`[nexus] No execution flows found for project ${projectId}.\n` +
-                        `  Run 'cleo nexus analyze' first.\n`);
-                }
-                else {
-                    process.stdout.write(`[nexus] Execution flows for project ${projectId} (${processes.length} total):\n`);
-                    for (const p of processes) {
-                        const meta = typeof p['metaJson'] === 'string'
-                            ? JSON.parse(p['metaJson'])
-                            : {};
-                        const stepCount = meta['stepCount'] ?? 0;
-                        const processType = String(meta['processType'] ?? 'intra').replace('_community', '');
-                        process.stdout.write(`  ${String(p['id']).padEnd(30)}  steps=${String(stepCount).padStart(3)}  type=${processType.padEnd(12)}  ${String(p['label'])}\n`);
-                    }
-                }
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_FLOWS_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.flows',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus context ─────────────────────────────────────────────────────────
-    nexus
-        .command('context <symbol>')
-        .description('Show callers, callees, community membership, and process participation for a code symbol')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from cwd)')
-        .option('--limit <n>', 'Max callers/callees to show per side', parseInt, 20)
-        .action(async (symbolName, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const repoPath = process.cwd();
-        const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-        const limit = opts['limit'] ?? 20;
-        try {
-            const { getNexusDb, nexusSchema } = await import('@cleocode/core/store/nexus-sqlite');
-            const db = await getNexusDb();
-            // Find nodes matching the symbol name (case-insensitive partial match).
-            // NodeSQLiteDatabase uses sync Drizzle — .all() returns a plain array.
-            let allNodes = [];
-            try {
-                allNodes = db.select().from(nexusSchema.nexusNodes).all();
-            }
-            catch {
-                allNodes = [];
-            }
-            const lowerSymbol = symbolName.toLowerCase();
-            const rawMatchingNodes = allNodes.filter((n) => n['projectId'] === projectId &&
-                n['name'] != null &&
-                String(n['name']).toLowerCase().includes(lowerSymbol) &&
-                // Exclude synthetic graph-level nodes from symbol search
-                n['kind'] !== 'community' &&
-                n['kind'] !== 'process');
-            // Sort so callable symbols (function, method, class) rank before
-            // structural nodes (file, folder) — structural nodes have no `calls`
-            // relations and would produce empty callers/callees lists.
-            const matchingNodes = sortMatchingNodes(rawMatchingNodes, symbolName);
-            if (matchingNodes.length === 0) {
-                const durationMs = Date.now() - startTime;
-                if (jsonOutput) {
-                    process.stdout.write(JSON.stringify({
-                        success: false,
-                        error: {
-                            code: 'E_NOT_FOUND',
-                            message: `No symbol found matching '${symbolName}' in project ${projectId}`,
-                        },
-                        meta: {
-                            operation: 'nexus.context',
-                            duration_ms: durationMs,
-                            timestamp: new Date().toISOString(),
-                        },
-                    }, null, 2) + '\n');
-                }
-                else {
-                    process.stdout.write(`[nexus] No symbol found matching '${symbolName}'.\n` +
-                        `  Run 'cleo nexus analyze' first, or check the symbol name.\n`);
-                }
-                process.exitCode = 4;
-                return;
-            }
-            // Load all relations once — cheaper than N queries per node.
-            let allRelations = [];
-            try {
-                allRelations = db.select().from(nexusSchema.nexusRelations).all();
-            }
-            catch {
-                allRelations = [];
-            }
-            // Build a node-by-id index for fast lookups.
-            const nodeById = new Map();
-            for (const n of allNodes) {
-                nodeById.set(String(n['id']), n);
-            }
-            // Build context for each matching node.
-            const results = matchingNodes.slice(0, 5).map((node) => {
-                const nodeId = String(node['id']);
-                // Incoming: who calls/imports/references THIS node (target = nodeId)
-                const incoming = allRelations
-                    .filter((r) => r['targetId'] === nodeId &&
-                    r['projectId'] === projectId &&
-                    (r['type'] === 'calls' || r['type'] === 'imports' || r['type'] === 'accesses'))
-                    .slice(0, limit)
-                    .map((r) => {
-                    const src = nodeById.get(String(r['sourceId']));
-                    return {
-                        relationType: r['type'],
-                        nodeId: r['sourceId'],
-                        name: src?.['name'] ?? r['sourceId'],
-                        kind: src?.['kind'] ?? 'unknown',
-                        filePath: src?.['filePath'] ?? null,
-                    };
-                });
-                // Outgoing: what THIS node calls/imports/accesses (source = nodeId)
-                const outgoing = allRelations
-                    .filter((r) => r['sourceId'] === nodeId &&
-                    r['projectId'] === projectId &&
-                    (r['type'] === 'calls' || r['type'] === 'imports' || r['type'] === 'accesses'))
-                    .slice(0, limit)
-                    .map((r) => {
-                    const tgt = nodeById.get(String(r['targetId']));
-                    return {
-                        relationType: r['type'],
-                        nodeId: r['targetId'],
-                        name: tgt?.['name'] ?? r['targetId'],
-                        kind: tgt?.['kind'] ?? 'unknown',
-                        filePath: tgt?.['filePath'] ?? null,
-                    };
-                });
-                // Community membership
-                const communityId = node['communityId'];
-                const community = communityId ? nodeById.get(communityId) : null;
-                // Process participation (step_in_process or entry_point_of relations)
-                const processRelations = allRelations.filter((r) => r['sourceId'] === nodeId &&
-                    r['projectId'] === projectId &&
-                    (r['type'] === 'step_in_process' || r['type'] === 'entry_point_of'));
-                const processes = processRelations
-                    .map((r) => {
-                    const proc = nodeById.get(String(r['targetId']));
-                    return {
-                        processId: r['targetId'],
-                        label: proc?.['label'] ?? r['targetId'],
-                        role: r['type'] === 'entry_point_of' ? 'entry_point' : 'step',
-                        step: r['step'] ?? null,
-                    };
-                })
-                    .filter((p) => p.label !== p.processId); // filter unresolved
-                return {
-                    nodeId,
-                    name: node['name'],
-                    kind: node['kind'],
-                    filePath: node['filePath'],
-                    startLine: node['startLine'],
-                    endLine: node['endLine'],
-                    isExported: node['isExported'],
-                    docSummary: node['docSummary'],
-                    community: community
-                        ? { id: communityId, label: community['label'] }
-                        : communityId
-                            ? { id: communityId, label: null }
-                            : null,
-                    callers: incoming,
-                    callees: outgoing,
-                    processes,
-                };
-            });
-            const durationMs = Date.now() - startTime;
-            const primary = results[0];
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: {
-                        query: symbolName,
-                        projectId,
-                        matchCount: matchingNodes.length,
-                        results,
-                    },
-                    meta: {
-                        operation: 'nexus.context',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Context for symbol '${symbolName}' (${matchingNodes.length} match${matchingNodes.length !== 1 ? 'es' : ''}):\n`);
-                for (const r of results) {
-                    process.stdout.write(`\n  Symbol:   ${String(r.name)}  (${String(r.kind)})\n` +
-                        `  File:     ${r.filePath ? String(r.filePath) : 'n/a'}` +
-                        (r.startLine ? `:${String(r.startLine)}` : '') +
-                        '\n' +
-                        (r.docSummary ? `  Doc:      ${String(r.docSummary)}\n` : '') +
-                        (r.community
-                            ? `  Community: ${String(r.community.label ?? r.community.id)}\n`
-                            : '') +
-                        `  Callers (${r.callers.length}): ${r.callers.length === 0
-                            ? 'none'
-                            : r.callers.map((c) => `${String(c.name)}[${String(c.kind)}]`).join(', ')}\n` +
-                        `  Callees (${r.callees.length}): ${r.callees.length === 0
-                            ? 'none'
-                            : r.callees.map((c) => `${String(c.name)}[${String(c.kind)}]`).join(', ')}\n` +
-                        (r.processes.length > 0
-                            ? `  Processes: ${r.processes.map((p) => `${String(p.label)}(${String(p.role)})`).join(', ')}\n`
-                            : ''));
-                }
-                if (matchingNodes.length > 5) {
-                    process.stdout.write(`\n  (Showing 5 of ${matchingNodes.length} matches — use --json for full list)\n`);
-                }
-            }
-            void primary; // referenced to satisfy lint
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_CONTEXT_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.context',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus impact ──────────────────────────────────────────────────────────
-    nexus
-        .command('impact <symbol>')
-        .description('Show blast radius for a code symbol — direct callers (d=1), indirect callers (d=2), transitive (d=3)')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from cwd)')
-        .option('--depth <n>', 'Maximum traversal depth (default: 3)', parseInt, 3)
-        .action(async (symbolName, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const repoPath = process.cwd();
-        const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-        const maxDepth = Math.min(opts['depth'] ?? 3, 5);
-        try {
-            const { getNexusDb, nexusSchema } = await import('@cleocode/core/store/nexus-sqlite');
-            const db = await getNexusDb();
-            // Load all nodes and relations for this project once.
-            let allNodes = [];
-            try {
-                allNodes = db.select().from(nexusSchema.nexusNodes).all();
-            }
-            catch {
-                allNodes = [];
-            }
-            const lowerSymbol = symbolName.toLowerCase();
-            const rawMatchingNodes = allNodes.filter((n) => n['projectId'] === projectId &&
-                n['name'] != null &&
-                String(n['name']).toLowerCase().includes(lowerSymbol) &&
-                n['kind'] !== 'community' &&
-                n['kind'] !== 'process');
-            // Sort so callable symbols (function, method, class) rank before
-            // structural nodes (file, folder) — structural nodes have no `calls`
-            // relations and would produce zero impact.
-            const matchingNodes = sortMatchingNodes(rawMatchingNodes, symbolName);
-            if (matchingNodes.length === 0) {
-                const durationMs = Date.now() - startTime;
-                if (jsonOutput) {
-                    process.stdout.write(JSON.stringify({
-                        success: false,
-                        error: {
-                            code: 'E_NOT_FOUND',
-                            message: `No symbol found matching '${symbolName}' in project ${projectId}`,
-                        },
-                        meta: {
-                            operation: 'nexus.impact',
-                            duration_ms: durationMs,
-                            timestamp: new Date().toISOString(),
-                        },
-                    }, null, 2) + '\n');
-                }
-                else {
-                    process.stdout.write(`[nexus] No symbol found matching '${symbolName}'.\n` +
-                        `  Run 'cleo nexus analyze' first, or check the symbol name.\n`);
-                }
-                process.exitCode = 4;
-                return;
-            }
-            let allRelations = [];
-            try {
-                allRelations = db.select().from(nexusSchema.nexusRelations).all();
-            }
-            catch {
-                allRelations = [];
-            }
-            // Build a node-by-id index for fast lookups.
-            const nodeById = new Map();
-            for (const n of allNodes) {
-                nodeById.set(String(n['id']), n);
-            }
-            // BFS upstream: find all nodes that (transitively) call/import the target.
-            const targetNode = matchingNodes[0];
-            const targetId = String(targetNode['id']);
-            // Build reverse adjacency: targetId → [sourceIds that call it]
-            const reverseAdj = new Map();
-            for (const r of allRelations) {
-                if (r['projectId'] === projectId &&
-                    (r['type'] === 'calls' || r['type'] === 'imports' || r['type'] === 'accesses')) {
-                    const tid = String(r['targetId']);
-                    const sid = String(r['sourceId']);
-                    if (!reverseAdj.has(tid))
-                        reverseAdj.set(tid, []);
-                    reverseAdj.get(tid).push(sid);
-                }
-            }
-            // BFS traversal up to maxDepth levels.
-            const visited = new Set([targetId]);
-            const depthMap = new Map(); // nodeId → depth
-            const queue = [{ id: targetId, depth: 0 }];
-            const impactByDepth = [];
-            while (queue.length > 0) {
-                const item = queue.shift();
-                if (item.depth >= maxDepth)
-                    continue;
-                const callers = reverseAdj.get(item.id) ?? [];
-                for (const callerId of callers) {
-                    if (visited.has(callerId))
-                        continue;
-                    visited.add(callerId);
-                    const depth = item.depth + 1;
-                    depthMap.set(callerId, depth);
-                    const callerNode = nodeById.get(callerId);
-                    if (!impactByDepth[depth - 1])
-                        impactByDepth[depth - 1] = [];
-                    impactByDepth[depth - 1].push({
-                        nodeId: callerId,
-                        name: String(callerNode?.['name'] ?? callerId),
-                        kind: String(callerNode?.['kind'] ?? 'unknown'),
-                        filePath: callerNode?.['filePath'] ? String(callerNode['filePath']) : null,
-                    });
-                    queue.push({ id: callerId, depth });
-                }
-            }
-            const totalImpact = visited.size - 1; // exclude the target itself
-            const riskLevel = totalImpact === 0
-                ? 'NONE'
-                : totalImpact <= 3
-                    ? 'LOW'
-                    : totalImpact <= 10
-                        ? 'MEDIUM'
-                        : totalImpact <= 25
-                            ? 'HIGH'
-                            : 'CRITICAL';
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: {
-                        query: symbolName,
-                        projectId,
-                        targetNodeId: targetId,
-                        targetName: targetNode['name'],
-                        targetKind: targetNode['kind'],
-                        targetFilePath: targetNode['filePath'],
-                        riskLevel,
-                        totalImpactedNodes: totalImpact,
-                        maxDepth,
-                        impactByDepth: impactByDepth.map((layer, i) => ({
-                            depth: i + 1,
-                            label: i === 0
-                                ? 'WILL BREAK (direct callers)'
-                                : i === 1
-                                    ? 'LIKELY AFFECTED'
-                                    : 'MAY NEED TESTING',
-                            nodes: layer,
-                        })),
-                    },
-                    meta: {
-                        operation: 'nexus.impact',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Impact analysis for '${symbolName}'\n` +
-                    `  Target:  ${String(targetNode['name'])}  (${String(targetNode['kind'])})\n` +
-                    `  File:    ${targetNode['filePath'] ? String(targetNode['filePath']) : 'n/a'}\n` +
-                    `  Risk:    ${riskLevel}  (${totalImpact} impacted node${totalImpact !== 1 ? 's' : ''})\n`);
-                if (totalImpact === 0) {
-                    process.stdout.write('  No callers found — safe to modify.\n');
-                }
-                else {
-                    for (let i = 0; i < impactByDepth.length; i++) {
-                        const layer = impactByDepth[i];
-                        if (!layer || layer.length === 0)
-                            continue;
-                        const label = i === 0 ? 'WILL BREAK' : i === 1 ? 'LIKELY AFFECTED' : 'MAY NEED TESTING';
-                        process.stdout.write(`\n  d=${i + 1} ${label} (${layer.length}):\n`);
-                        for (const node of layer.slice(0, 15)) {
-                            process.stdout.write(`    ${String(node.name).padEnd(36)}  ${String(node.kind).padEnd(12)}  ${node.filePath ?? ''}\n`);
-                        }
-                        if (layer.length > 15) {
-                            process.stdout.write(`    ... and ${layer.length - 15} more\n`);
-                        }
-                    }
-                }
-                if (matchingNodes.length > 1) {
-                    process.stdout.write(`\n  (Showing analysis for first match — ${matchingNodes.length} total matches for '${symbolName}')\n`);
-                }
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_IMPACT_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.impact',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus analyze ─────────────────────────────────────────────────────────
-    nexus
-        .command('analyze [path]')
-        .description('Run code intelligence pipeline on a repository directory')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected)')
-        .option('--incremental', 'Only re-index files that have changed since the last run (faster)')
-        .action(async (targetPath, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const isIncremental = !!opts['incremental'];
-        // Resolve target path
-        const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        if (!jsonOutput) {
-            process.stderr.write(`[nexus] Analyzing: ${repoPath}${isIncremental ? ' (incremental)' : ''}\n`);
-        }
-        try {
-            // Lazy imports to avoid loading heavy dependencies until needed
-            const [{ getNexusDb, nexusSchema }, { runPipeline }, { getProjectRoot }, { eq }] = await Promise.all([
-                import('@cleocode/core/store/nexus-sqlite'),
-                import('@cleocode/nexus/pipeline'),
-                import('@cleocode/core/internal'),
-                import('drizzle-orm'),
-            ]);
-            // Determine project ID — use override or derive from path
-            const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-            // Get DB and table references
-            const db = await getNexusDb();
-            const tables = {
-                nexusNodes: nexusSchema.nexusNodes,
-                nexusRelations: nexusSchema.nexusRelations,
-            };
-            // For full (non-incremental) runs: delete existing index first.
-            // NodeSQLiteDatabase uses sync Drizzle — no await, wrap in try-catch.
-            if (!isIncremental) {
-                if (!jsonOutput) {
-                    process.stderr.write('[nexus] Clearing existing index for project...\n');
-                }
-                try {
-                    db.delete(nexusSchema.nexusNodes)
-                        .where(eq(nexusSchema.nexusNodes.projectId, projectId))
-                        .run();
-                }
-                catch {
-                    // Table may not have rows — ignore
-                }
-                try {
-                    db.delete(nexusSchema.nexusRelations)
-                        .where(eq(nexusSchema.nexusRelations.projectId, projectId))
-                        .run();
-                }
-                catch {
-                    // Table may not have rows — ignore
-                }
-            }
-            // Run the pipeline (full or incremental)
-            const result = await runPipeline(repoPath, projectId, db, tables, jsonOutput
-                ? undefined
-                : (current, total, filePath) => {
-                    if (current % 50 === 0 || current === total) {
-                        const pct = total > 0 ? Math.round((current / total) * 100) : 100;
-                        process.stderr.write(`[nexus] Progress: ${current}/${total} files (${pct}%) — ${filePath}\n`);
-                    }
-                }, { incremental: isIncremental });
-            const durationMs = Date.now() - startTime;
-            // Write nexus-bridge.md after a successful pipeline run (best-effort)
-            try {
-                const { refreshNexusBridge } = await import('@cleocode/core/internal');
-                await refreshNexusBridge(repoPath, projectId);
-                if (!jsonOutput) {
-                    process.stderr.write(`[nexus] nexus-bridge.md refreshed at ${repoPath}/.cleo/nexus-bridge.md\n`);
-                }
-            }
-            catch {
-                // Non-fatal — bridge refresh failure should not fail the analyze command
-            }
-            // Auto-register project and update index stats in the multi-project registry (best-effort)
-            try {
-                const { nexusUpdateIndexStats } = await import('@cleocode/core/internal');
-                await nexusUpdateIndexStats(repoPath, {
-                    nodeCount: result.nodeCount,
-                    relationCount: result.relationCount,
-                    fileCount: result.fileCount,
-                });
-                if (!jsonOutput) {
-                    process.stderr.write('[nexus] Project registered/updated in multi-project registry.\n');
-                }
-            }
-            catch {
-                // Non-fatal — registry update must never fail the analyze command
-            }
-            if (jsonOutput) {
-                const envelope = {
-                    success: true,
-                    data: {
-                        projectId,
-                        repoPath,
-                        incremental: isIncremental,
-                        nodeCount: result.nodeCount,
-                        relationCount: result.relationCount,
-                        fileCount: result.fileCount,
-                        durationMs,
-                    },
-                    meta: {
-                        operation: 'nexus.analyze',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                };
-                process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Analysis complete${isIncremental ? ' (incremental)' : ''}:\n` +
-                    `  Project ID: ${projectId}\n` +
-                    `  Files:      ${result.fileCount}\n` +
-                    `  Nodes:      ${result.nodeCount}\n` +
-                    `  Relations:  ${result.relationCount}\n` +
-                    `  Duration:   ${durationMs}ms\n`);
-            }
-            void getProjectRoot; // referenced to satisfy import
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                const envelope = {
-                    success: false,
-                    error: { code: 'E_PIPELINE_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.analyze',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                };
-                process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus projects ────────────────────────────────────────────────────────
-    // A focused subcommand group for the multi-project registry (T622).
-    // Maps to the existing nexus.list / nexus.register / nexus.unregister
-    // operations but adds richer output including db paths and index stats.
-    const projects = nexus.command('projects').description('Multi-project registry management');
-    projects
-        .command('list')
-        .description('List all projects registered in the global nexus registry')
-        .option('--json', 'Output as JSON (LAFS envelope format)')
-        .action(async (opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        try {
-            const { nexusList } = await import('@cleocode/core/internal');
-            const list = (await nexusList());
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: { projects: list, count: list.length },
-                    meta: {
-                        operation: 'nexus.projects.list',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else if (list.length === 0) {
-                process.stdout.write('[nexus] No projects registered. Run: cleo nexus projects register\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Registered projects (${list.length}):\n\n`);
-                for (const p of list) {
-                    const nodes = p.stats?.nodeCount ?? 0;
-                    const rels = p.stats?.relationCount ?? 0;
-                    const indexed = p.lastIndexed ? p.lastIndexed.slice(0, 10) : 'never';
-                    process.stdout.write(`  ${p.name.padEnd(28)}  tasks=${String(p.taskCount).padStart(5)}  nodes=${String(nodes).padStart(6)}  relations=${String(rels).padStart(7)}  indexed=${indexed}\n` +
-                        `  ${''.padEnd(28)}  path=${p.path}\n`);
-                }
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`[nexus] Error: ${msg}\n`);
-            process.exitCode = 1;
-        }
-    });
-    projects
-        .command('register [path]')
-        .description('Register a project in the global nexus registry (default: current directory)')
-        .option('--name <name>', 'Custom project name (default: directory name)')
-        .option('--json', 'Output as JSON (LAFS envelope format)')
-        .action(async (targetPath, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        const name = opts['name'];
-        try {
-            const { nexusRegister } = await import('@cleocode/core/internal');
-            const hash = await nexusRegister(repoPath, name);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: { hash, path: repoPath },
-                    meta: {
-                        operation: 'nexus.projects.register',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Registered: ${repoPath} (hash: ${hash})\n`);
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_REGISTER_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.projects.register',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    projects
-        .command('remove <nameOrHash>')
-        .alias('rm')
-        .description('Remove a project from the global nexus registry')
-        .option('--json', 'Output as JSON (LAFS envelope format)')
-        .action(async (nameOrHash, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        try {
-            const { nexusUnregister } = await import('@cleocode/core/internal');
-            await nexusUnregister(nameOrHash);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: { removed: nameOrHash },
-                    meta: {
-                        operation: 'nexus.projects.remove',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Removed: ${nameOrHash}\n`);
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_REMOVE_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.projects.remove',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus projects scan ───────────────────────────────────────────────────
-    // Walk filesystem roots to discover .cleo/ directories not in the registry.
-    projects
-        .command('scan')
-        .description('Walk filesystem roots to discover .cleo/ directories not registered in the global nexus registry')
-        .option('--roots <paths>', 'Comma-separated search roots (default: ~/code,~/projects,/mnt/projects)')
-        .option('--max-depth <n>', 'Maximum directory traversal depth (default: 4)', parseInt, 4)
-        .option('--auto-register', 'Register all discovered unregistered projects automatically')
-        .option('--include-existing', 'Also report projects that are already registered')
-        .option('--json', 'Output as JSON (LAFS envelope format)')
-        .action(async (opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const autoRegister = !!opts['autoRegister'];
-        const includeExisting = !!opts['includeExisting'];
-        const maxDepth = Math.max(1, Math.min(opts['maxDepth'] ?? 4, 20));
-        // Resolve search roots
-        const { homedir } = await import('node:os');
-        const home = homedir();
-        const defaultRoots = [path.join(home, 'code'), path.join(home, 'projects'), '/mnt/projects'];
-        const rawRoots = typeof opts['roots'] === 'string' && opts['roots'].trim().length > 0
-            ? opts['roots']
-                .split(',')
-                .map((r) => r.trim())
-                .filter((r) => r.length > 0)
-                .map((r) => r.startsWith('~') ? path.join(home, r.slice(1)) : path.resolve(r))
-            : defaultRoots;
-        // Filter to roots that actually exist
-        const { existsSync, readdirSync, statSync } = await import('node:fs');
-        const { Dirent } = await import('node:fs');
-        const roots = rawRoots.filter((r) => {
-            try {
-                return existsSync(r) && statSync(r).isDirectory();
-            }
-            catch {
-                return false;
-            }
-        });
-        if (!jsonOutput) {
-            process.stdout.write(`[nexus] Scanning ${roots.length} root(s) up to depth ${maxDepth}:\n` +
-                roots.map((r) => `  ${r}`).join('\n') +
-                '\n');
-        }
-        // ── Filesystem walker ──────────────────────────────────────────────
-        // Walk recursively up to maxDepth. Skip common build/cache directories.
-        // Does NOT follow symlinks. Does NOT cross mount points.
-        const SKIP_DIRS = new Set([
-            'node_modules',
-            '.git',
-            'target', // Rust build
-            'dist',
-            'build',
-            '.svelte-kit',
-            '.next',
-            '.cache',
-            'coverage',
-            '.turbo',
-            '.nx',
-            '__pycache__',
-            '.venv',
-            'venv',
-            '.tox',
-            'vendor',
-        ]);
-        /**
-         * Return the device number for a path, or -1 on error.
-         * Used to detect filesystem boundary crossings.
-         */
-        function getDevice(p) {
-            try {
-                return statSync(p).dev;
-            }
-            catch {
-                return -1;
-            }
-        }
-        /**
-         * Walk a directory tree looking for directories named `.cleo/`.
-         * Candidates are returned as absolute parent directory paths (the project root).
-         *
-         * @param dir     - Absolute directory path to walk.
-         * @param depth   - Current recursion depth (0 = root).
-         * @param rootDev - Device number of the search root for boundary checks.
-         */
-        function walkForCleo(dir, depth, rootDev) {
-            if (depth > maxDepth)
-                return [];
-            let entries;
-            try {
-                // withFileTypes:true + default encoding returns Dirent<string>[]
-                entries = readdirSync(dir, { withFileTypes: true });
-            }
-            catch {
-                return [];
-            }
-            const found = [];
-            for (const entry of entries) {
-                // Only process directories; skip symlinks (security requirement).
-                if (!entry.isDirectory())
-                    continue;
-                if (entry.isSymbolicLink())
-                    continue;
-                const fullPath = path.join(dir, entry.name);
-                if (entry.name === '.cleo') {
-                    // Parent dir is a CLEO project root
-                    found.push(dir);
-                    // Do not recurse into .cleo/ itself
-                    continue;
-                }
-                if (SKIP_DIRS.has(entry.name))
-                    continue;
-                // Filesystem boundary check — don't traverse into different mount points.
-                const childDev = getDevice(fullPath);
-                if (childDev !== rootDev && childDev !== -1)
-                    continue;
-                const nested = walkForCleo(fullPath, depth + 1, rootDev);
-                for (const n of nested)
-                    found.push(n);
-            }
-            return found;
-        }
-        // Collect all candidates
-        const allCandidates = [];
-        for (const root of roots) {
-            const rootDev = getDevice(root);
-            const found = walkForCleo(root, 0, rootDev);
-            for (const f of found)
-                allCandidates.push(f);
-        }
-        // Deduplicate (a root could itself be a .cleo parent)
-        const candidates = [...new Set(allCandidates)];
-        // ── Cross-reference with registry ─────────────────────────────────
-        let registeredPaths = new Set();
-        try {
-            const { nexusList: listProjects } = await import('@cleocode/core/internal');
-            const projects = await listProjects();
-            for (const p of projects) {
-                registeredPaths.add(path.resolve(p.path));
-            }
-        }
-        catch {
-            // Registry unavailable — treat all as unregistered
-            registeredPaths = new Set();
-        }
-        const unregistered = [];
-        const registered = [];
-        for (const candidate of candidates) {
-            const resolved = path.resolve(candidate);
-            if (registeredPaths.has(resolved)) {
-                registered.push(resolved);
-            }
-            else {
-                unregistered.push(resolved);
-            }
-        }
-        const tally = {
-            total: candidates.length,
-            unregistered: unregistered.length,
-            registered: registered.length,
-        };
-        // ── Auto-register ─────────────────────────────────────────────────
-        const autoRegistered = [];
-        const autoRegisterErrors = [];
-        if (autoRegister && unregistered.length > 0) {
-            const { nexusRegister: doRegister } = await import('@cleocode/core/internal');
-            for (const projectPath of unregistered) {
-                try {
-                    await doRegister(projectPath);
-                    autoRegistered.push(projectPath);
-                }
-                catch (err) {
-                    autoRegisterErrors.push({
-                        path: projectPath,
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                }
-            }
-        }
-        // ── Audit log ─────────────────────────────────────────────────────
-        // Best-effort: never let audit failure surface to the user.
-        try {
-            const { getNexusDb } = await import('@cleocode/core/store/nexus-sqlite');
-            const { nexusAuditLog: auditTable } = await import('@cleocode/core/store/nexus-schema');
-            const { randomUUID } = await import('node:crypto');
-            const db = await getNexusDb();
-            await db.insert(auditTable).values({
-                id: randomUUID(),
-                action: 'projects.scan',
-                domain: 'nexus',
-                operation: 'projects.scan',
-                success: 1,
-                detailsJson: JSON.stringify({
-                    roots,
-                    found: candidates.length,
-                    unregistered: unregistered.length,
-                    registered: registered.length,
-                    autoRegistered: autoRegistered.length,
-                }),
-            });
-        }
-        catch {
-            // Audit failure is non-fatal
-        }
-        const durationMs = Date.now() - startTime;
-        // ── Output ────────────────────────────────────────────────────────
-        if (jsonOutput) {
-            const data = {
-                roots,
-                unregistered,
-                tally,
-            };
-            if (includeExisting)
-                data['registered'] = registered;
-            if (autoRegister) {
-                data['autoRegistered'] = autoRegistered;
-                data['autoRegisterErrors'] = autoRegisterErrors;
-            }
-            process.stdout.write(JSON.stringify({
-                success: true,
-                data,
-                meta: {
-                    operation: 'nexus.projects.scan',
-                    duration_ms: durationMs,
-                    timestamp: new Date().toISOString(),
-                },
-            }, null, 2) + '\n');
-        }
-        else {
-            // Human-readable output
-            process.stdout.write(`\n[nexus] Scan complete — ${tally.total} project(s) found ` +
-                `(${tally.unregistered} unregistered, ${tally.registered} registered)\n`);
-            if (unregistered.length > 0) {
-                process.stdout.write('\n  Unregistered:\n');
-                for (const p of unregistered) {
-                    process.stdout.write(`    ${p}\n`);
-                }
-                if (!autoRegister) {
-                    process.stdout.write('\n  Tip: run with --auto-register to register all of the above.\n');
-                }
-            }
-            if (includeExisting && registered.length > 0) {
-                process.stdout.write('\n  Already registered:\n');
-                for (const p of registered) {
-                    process.stdout.write(`    ${p}\n`);
-                }
-            }
-            if (autoRegister) {
-                process.stdout.write(`\n  Auto-registered: ${autoRegistered.length} project(s)` +
-                    (autoRegisterErrors.length > 0 ? `, ${autoRegisterErrors.length} failed` : '') +
-                    '\n');
-                for (const e of autoRegisterErrors) {
-                    process.stdout.write(`    FAILED ${e.path}: ${e.error}\n`);
-                }
-            }
-        }
-    });
-    // ── nexus projects clean ─────────────────────────────────────────────────
-    // Bulk purge project_registry rows matching path criteria.
-    // Provides safety rails: at least one criteria flag required, always shows
-    // a preview before deletion, runs deletion in a single transaction.
-    projects
-        .command('clean')
-        .description('Bulk purge project_registry rows matching path criteria (requires at least one filter flag)')
-        .option('--dry-run', 'List matching projects without deleting anything')
-        .option('--pattern <regex>', 'JS regex matched against project_path')
-        .option('--include-temp', 'Preset: match paths containing a .temp/ segment')
-        .option('--include-tests', 'Preset: match paths containing tmp/test/fixture/scratch/sandbox segments')
-        .option('--unhealthy', 'Also match rows where health_status is "unhealthy"')
-        .option('--never-indexed', 'Also match rows where last_indexed IS NULL')
-        .option('--yes', 'Skip confirmation prompt (still shows preview)')
-        .option('--json', 'Output as JSON (LAFS envelope format)')
-        .action(async (opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const dryRun = !!opts['dryRun'];
-        const skipPrompt = !!opts['yes'];
-        const patternRaw = opts['pattern'];
-        const includeTemp = !!opts['includeTemp'];
-        const includeTests = !!opts['includeTests'];
-        const matchUnhealthy = !!opts['unhealthy'];
-        const matchNeverIndexed = !!opts['neverIndexed'];
-        // Require at least one real criteria flag (not just --dry-run / --yes / --json)
-        const hasCriteria = patternRaw !== undefined ||
-            includeTemp ||
-            includeTests ||
-            matchUnhealthy ||
-            matchNeverIndexed;
-        if (!hasCriteria) {
-            const errMsg = 'No filter criteria provided. Refusing to purge all projects without explicit criteria.\n' +
-                'Use at least one of: --pattern <regex>, --include-temp, --include-tests, --unhealthy, --never-indexed';
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_NO_CRITERIA', message: errMsg },
-                    meta: {
-                        operation: 'nexus.projects.clean',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${errMsg}\n`);
-            }
-            process.exitCode = 6;
-            return;
-        }
-        // Compile user-supplied regex (if any)
-        let patternRegex = null;
-        if (patternRaw !== undefined) {
-            try {
-                patternRegex = new RegExp(patternRaw);
-            }
-            catch (err) {
-                const msg = `Invalid --pattern regex: ${err instanceof Error ? err.message : String(err)}`;
-                if (jsonOutput) {
-                    process.stdout.write(JSON.stringify({
-                        success: false,
-                        error: { code: 'E_INVALID_PATTERN', message: msg },
-                        meta: {
-                            operation: 'nexus.projects.clean',
-                            duration_ms: Date.now() - startTime,
-                            timestamp: new Date().toISOString(),
-                        },
-                    }, null, 2) + '\n');
-                }
-                else {
-                    process.stderr.write(`[nexus] Error: ${msg}\n`);
-                }
-                process.exitCode = 6;
-                return;
-            }
-        }
-        // Preset regexes
-        const TEMP_RE = /(^|\/)\.temp(\/|$)/;
-        const TESTS_RE = /(^|\/)(tmp|test|fixture|scratch|sandbox)(\/|$)/;
-        /**
-         * Return true if a project_path matches any of the active criteria.
-         */
-        function matchesCriteria(projectPath, healthStatus, lastIndexed) {
-            if (patternRegex?.test(projectPath))
-                return true;
-            if (includeTemp && TEMP_RE.test(projectPath))
-                return true;
-            if (includeTests && TESTS_RE.test(projectPath))
-                return true;
-            if (matchUnhealthy && healthStatus === 'unhealthy')
-                return true;
-            if (matchNeverIndexed && lastIndexed === null)
-                return true;
-            return false;
-        }
-        try {
-            const { getNexusDb } = await import('@cleocode/core/store/nexus-sqlite');
-            const { projectRegistry: regTable, nexusAuditLog: auditTable } = await import('@cleocode/core/store/nexus-schema');
-            const { randomUUID } = await import('node:crypto');
-            const { inArray } = await import('drizzle-orm');
-            const db = await getNexusDb();
-            // Fetch all registry rows in one query — avoid N+1.
-            // Cast is required because dynamic imports with `as string` suppress
-            // the real module types; the actual schema column types match this shape.
-            const allRows = (await db
-                .select({
-                projectId: regTable.projectId,
-                projectPath: regTable.projectPath,
-                healthStatus: regTable.healthStatus,
-                lastIndexed: regTable.lastIndexed,
-            })
-                .from(regTable));
-            const matches = allRows.filter((row) => matchesCriteria(row.projectPath, row.healthStatus, row.lastIndexed));
-            const totalCount = allRows.length;
-            const matchCount = matches.length;
-            const samplePaths = matches.slice(0, 10).map((r) => r.projectPath);
-            // Always show preview
-            if (!jsonOutput) {
-                process.stdout.write(`[nexus] Clean preview — ${matchCount} project(s) of ${totalCount} total match criteria:\n`);
-                if (matchCount === 0) {
-                    process.stdout.write('  (no matches)\n');
-                }
-                else {
-                    for (const p of samplePaths) {
-                        process.stdout.write(`  ${p}\n`);
-                    }
-                    if (matchCount > 10) {
-                        process.stdout.write(`  ... and ${matchCount - 10} more\n`);
-                    }
-                }
-            }
-            if (matchCount === 0) {
-                const durationMs = Date.now() - startTime;
-                if (jsonOutput) {
-                    process.stdout.write(JSON.stringify({
-                        success: true,
-                        data: {
-                            dryRun,
-                            matched: 0,
-                            purged: 0,
-                            remaining: totalCount,
-                            sample: [],
-                        },
-                        meta: {
-                            operation: 'nexus.projects.clean',
-                            duration_ms: durationMs,
-                            timestamp: new Date().toISOString(),
-                        },
-                    }, null, 2) + '\n');
-                }
-                return;
-            }
-            // Dry-run: stop here
-            if (dryRun) {
-                const durationMs = Date.now() - startTime;
-                if (jsonOutput) {
-                    process.stdout.write(JSON.stringify({
-                        success: true,
-                        data: {
-                            dryRun: true,
-                            matched: matchCount,
-                            purged: 0,
-                            remaining: totalCount,
-                            sample: samplePaths,
-                        },
-                        meta: {
-                            operation: 'nexus.projects.clean',
-                            duration_ms: durationMs,
-                            timestamp: new Date().toISOString(),
-                        },
-                    }, null, 2) + '\n');
-                }
-                else {
-                    process.stdout.write(`[nexus] Dry-run — ${matchCount} project(s) would be purged. Rerun without --dry-run to delete.\n`);
-                }
-                return;
-            }
-            // Confirmation prompt (skip with --yes)
-            if (!skipPrompt) {
-                const { createInterface } = await import('node:readline');
-                const rl = createInterface({ input: process.stdin, output: process.stdout });
-                const confirmed = await new Promise((resolve) => {
-                    rl.question(`\n[nexus] Delete ${matchCount} project(s) from the registry? [y/N] `, (answer) => {
-                        rl.close();
-                        resolve(answer.trim().toLowerCase() === 'y');
-                    });
-                });
-                if (!confirmed) {
-                    process.stdout.write('[nexus] Aborted — no projects deleted.\n');
-                    return;
-                }
-            }
-            // Delete in a single transaction
-            const idsToDelete = matches.map((r) => r.projectId);
-            await db.delete(regTable).where(inArray(regTable.projectId, idsToDelete));
-            const remaining = totalCount - matchCount;
-            // Audit log (best-effort)
-            try {
-                await db.insert(auditTable).values({
-                    id: randomUUID(),
-                    action: 'projects.clean',
-                    domain: 'nexus',
-                    operation: 'projects.clean',
-                    success: 1,
-                    detailsJson: JSON.stringify({
-                        pattern: patternRaw ?? null,
-                        presets: {
-                            includeTemp,
-                            includeTests,
-                            matchUnhealthy,
-                            matchNeverIndexed,
-                        },
-                        count: matchCount,
-                        sample: samplePaths,
-                    }),
-                });
-            }
-            catch {
-                // Audit failure is non-fatal
-            }
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: {
-                        dryRun: false,
-                        matched: matchCount,
-                        purged: matchCount,
-                        remaining,
-                        sample: samplePaths,
-                    },
-                    meta: {
-                        operation: 'nexus.projects.clean',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Purged ${matchCount} project(s). ${remaining} project(s) remaining in registry.\n`);
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_CLEAN_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.projects.clean',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus refresh-bridge ──────────────────────────────────────────────────
-    nexus
-        .command('refresh-bridge [path]')
-        .description('Regenerate .cleo/nexus-bridge.md from the existing nexus.db index (does not re-index)')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from path)')
-        .action(async (targetPath, opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const projectIdOverride = opts['projectId'];
-        const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
-        const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-        try {
-            const { writeNexusBridge } = await import('@cleocode/core/internal');
-            const result = await writeNexusBridge(repoPath, projectId);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: { path: result.path, written: result.written, projectId, repoPath },
-                    meta: {
-                        operation: 'nexus.refresh-bridge',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else if (result.written) {
-                process.stdout.write(`[nexus] nexus-bridge.md refreshed at ${result.path}\n`);
-            }
-            else {
-                process.stdout.write(`[nexus] nexus-bridge.md unchanged at ${result.path}\n`);
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_BRIDGE_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.refresh-bridge',
-                        duration_ms: Date.now() - startTime,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error refreshing bridge: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus export ──────────────────────────────────────────────────────────
-    /**
-     * Export nexus graph to GEXF (Gephi) or JSON format.
-     *
-     * Queries graph_nodes and graph_edges from nexus.db and emits GEXF format
-     * suitable for visualization in Gephi. Supports optional project filtering.
-     *
-     * @task T626-M7
-     */
-    nexus
-        .command('export')
-        .description('Export nexus graph to GEXF (Gephi) or JSON format')
-        .option('--format <format>', 'Output format: gexf, json', 'gexf')
-        .option('--output <file>', 'Output file path (stdout if omitted)')
-        .option('--project <id>', 'Filter by project ID (exports all projects if omitted)')
-        .action(async (opts) => {
-        const startTime = Date.now();
-        const format = opts['format'] ?? 'gexf';
-        const outputFile = opts['output'];
-        const projectFilter = opts['project'];
-        try {
-            const { getNexusDb, nexusSchema } = await import('@cleocode/core/store/nexus-sqlite');
-            const db = await getNexusDb();
-            // Load all nodes and relations
-            let allNodes = [];
-            let allRelations = [];
-            try {
-                allNodes = db.select().from(nexusSchema.nexusNodes).all();
-                allRelations = db.select().from(nexusSchema.nexusRelations).all();
-            }
-            catch {
-                // DB may be empty
-            }
-            // Filter by project if specified
-            const nodes = projectFilter
-                ? allNodes.filter((n) => n['projectId'] === projectFilter)
-                : allNodes;
-            const relations = projectFilter
-                ? allRelations.filter((r) => r['projectId'] === projectFilter)
-                : allRelations;
-            let output = '';
-            if (format === 'json') {
-                output = JSON.stringify({
-                    nodes: nodes.map((n) => ({
-                        id: n['id'],
-                        kind: n['kind'],
-                        label: n['label'],
-                        name: n['name'],
-                        filePath: n['filePath'],
-                        language: n['language'],
-                        isExported: n['isExported'],
-                        startLine: n['startLine'],
-                        endLine: n['endLine'],
-                        projectId: n['projectId'],
-                    })),
-                    edges: relations.map((r) => ({
-                        id: r['id'],
-                        source: r['sourceId'],
-                        target: r['targetId'],
-                        type: r['type'],
-                        confidence: r['confidence'],
-                        reason: r['reason'],
-                    })),
-                }, null, 2);
-            }
-            else if (format === 'gexf') {
-                // GEXF format (Gephi standard)
-                output = generateGexf(nodes, relations);
-            }
-            else {
-                process.stderr.write(`[nexus] Error: Unknown format '${format}'. Supported: gexf, json\n`);
-                process.exitCode = 1;
-                return;
-            }
-            if (outputFile) {
-                const { writeFileSync } = await import('node:fs');
-                writeFileSync(outputFile, output, 'utf-8');
-                process.stdout.write(`[nexus] Exported to ${outputFile} (${nodes.length} nodes, ${relations.length} edges)\n`);
-            }
-            else {
-                process.stdout.write(output);
-                if (!output.endsWith('\n'))
-                    process.stdout.write('\n');
-            }
-            const durationMs = Date.now() - startTime;
-            if (outputFile) {
-                process.stderr.write(`[nexus] Export completed in ${durationMs}ms\n`);
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`[nexus] Error: ${msg}\n`);
-            process.exitCode = 1;
-        }
-    });
-    // ── nexus diff ────────────────────────────────────────────────────────────
-    /**
-     * Compare NEXUS index state between two git commits.
-     *
-     * Runs an incremental re-analysis against the current working tree state
-     * (representing the "after" snapshot) and compares relation/node counts
-     * against the pre-analysis snapshot. Reports new relations, removed
-     * relations, and any regressions detected.
-     *
-     * @task T625
-     */
-    nexus
-        .command('diff')
-        .description('Compare NEXUS index state between two git commits — shows new/removed relations and broken call chains')
-        .option('--before <sha>', 'Git SHA or ref for the "before" snapshot (default: HEAD~1)')
-        .option('--after <sha>', 'Git SHA or ref for the "after" snapshot (default: HEAD)', 'HEAD')
-        .option('--path <dir>', 'Repository directory to analyze (default: cwd)')
-        .option('--json', 'Output result as JSON (LAFS envelope format)')
-        .option('--project-id <id>', 'Override the project ID (default: auto-detected from path)')
-        .action(async (opts) => {
-        const startTime = Date.now();
-        const jsonOutput = !!opts['json'];
-        const repoPath = opts['path'] ? path.resolve(opts['path']) : process.cwd();
-        const projectIdOverride = opts['projectId'];
-        const projectId = projectIdOverride ?? Buffer.from(repoPath).toString('base64url').slice(0, 32);
-        const beforeRef = opts['before'] ?? 'HEAD~1';
-        const afterRef = opts['after'] ?? 'HEAD';
-        if (!jsonOutput) {
-            process.stderr.write(`[nexus] Diffing relations: ${beforeRef}..${afterRef} in ${repoPath}\n`);
-        }
-        try {
-            const { execFile: execFileNode } = await import('node:child_process');
-            const { promisify } = await import('node:util');
-            const execFileAsync = promisify(execFileNode);
-            /** Resolve a git ref to a short SHA. Falls back to the ref itself on failure. */
-            const resolveSha = async (ref) => {
-                try {
-                    const { stdout } = await execFileAsync('git', ['rev-parse', '--short', ref], {
-                        timeout: 5_000,
-                        cwd: repoPath,
-                    });
-                    return stdout.trim();
-                }
-                catch {
-                    return ref;
-                }
-            };
-            const [beforeSha, afterSha] = await Promise.all([
-                resolveSha(beforeRef),
-                resolveSha(afterRef),
-            ]);
-            // Get files changed between the two refs (TypeScript/JavaScript/Rust only)
-            let changedFiles = [];
-            try {
-                const { stdout: diffOutput } = await execFileAsync('git', ['diff', '--name-only', beforeSha, afterSha], { timeout: 10_000, cwd: repoPath });
-                changedFiles = diffOutput
-                    .split('\n')
-                    .map((f) => f.trim())
-                    .filter((f) => f.length > 0 && (f.endsWith('.ts') || f.endsWith('.js') || f.endsWith('.rs')));
-            }
-            catch {
-                // git diff failed — proceed with full status comparison
-            }
-            // Load nexus DB and snapshot relation/node counts before incremental analysis
-            const { getNexusDb, nexusSchema } = await import('@cleocode/core/store/nexus-sqlite');
-            const db = await getNexusDb();
-            let relationsBefore = 0;
-            let nodesBefore = 0;
-            try {
-                const allRelsBefore = db.select().from(nexusSchema.nexusRelations).all();
-                const allNodesBefore = db.select().from(nexusSchema.nexusNodes).all();
-                relationsBefore = allRelsBefore.filter((r) => r['projectId'] === projectId).length;
-                nodesBefore = allNodesBefore.filter((n) => n['projectId'] === projectId).length;
-            }
-            catch {
-                // DB not yet initialized — start from zero
-            }
-            // Run incremental pipeline to reflect the afterRef state
-            const { runPipeline } = await import('@cleocode/nexus/pipeline');
-            const pipelineResult = await runPipeline(repoPath, projectId, db, {
-                nexusNodes: nexusSchema.nexusNodes,
-                nexusRelations: nexusSchema.nexusRelations,
-            }, undefined, // no progress callback in diff mode
-            { incremental: true });
-            // Snapshot counts after incremental analysis
-            let relationsAfter = 0;
-            let nodesAfter = 0;
-            try {
-                const allRelsAfter = db.select().from(nexusSchema.nexusRelations).all();
-                const allNodesAfter = db.select().from(nexusSchema.nexusNodes).all();
-                relationsAfter = allRelsAfter.filter((r) => r['projectId'] === projectId).length;
-                nodesAfter = allNodesAfter.filter((n) => n['projectId'] === projectId).length;
-            }
-            catch {
-                // Fallback: use pipeline result counts directly
-                relationsAfter = pipelineResult.relationCount;
-                nodesAfter = pipelineResult.nodeCount;
-            }
-            const newRelations = Math.max(0, relationsAfter - relationsBefore);
-            const removedRelations = Math.max(0, relationsBefore - relationsAfter);
-            const newNodes = Math.max(0, nodesAfter - nodesBefore);
-            const removedNodes = Math.max(0, nodesBefore - nodesAfter);
-            const durationMs = Date.now() - startTime;
-            // Classify regressions: significant relation or node loss
-            const regressions = [];
-            if (removedRelations > 5) {
-                regressions.push(`${removedRelations} relations removed — verify no broken call chains`);
-            }
-            if (removedNodes > 0) {
-                regressions.push(`${removedNodes} symbols removed — callers may be broken`);
-            }
-            const diffHealthStatus = regressions.length > 0
-                ? 'REGRESSIONS_DETECTED'
-                : removedRelations > 0
-                    ? 'RELATIONS_REDUCED'
-                    : newRelations > 0
-                        ? 'RELATIONS_ADDED'
-                        : 'STABLE';
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: true,
-                    data: {
-                        beforeRef,
-                        afterRef,
-                        beforeSha,
-                        afterSha,
-                        projectId,
-                        repoPath,
-                        changedFiles,
-                        nodesBefore,
-                        nodesAfter,
-                        newNodes,
-                        removedNodes,
-                        relationsBefore,
-                        relationsAfter,
-                        newRelations,
-                        removedRelations,
-                        healthStatus: diffHealthStatus,
-                        regressions,
-                    },
-                    meta: {
-                        operation: 'nexus.diff',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stdout.write(`[nexus] Diff: ${beforeSha}..${afterSha}\n` +
-                    `  Changed files: ${changedFiles.length > 0 ? changedFiles.join(', ') : 'n/a'}\n` +
-                    `  Nodes:     before=${nodesBefore}  after=${nodesAfter}  new=+${newNodes}  removed=-${removedNodes}\n` +
-                    `  Relations: before=${relationsBefore}  after=${relationsAfter}  new=+${newRelations}  removed=-${removedRelations}\n` +
-                    `  Health:    ${diffHealthStatus}\n`);
-                if (regressions.length > 0) {
-                    process.stdout.write('\n  REGRESSIONS:\n');
-                    for (const reg of regressions) {
-                        process.stdout.write(`    - ${reg}\n`);
-                    }
-                }
-                else {
-                    process.stdout.write('  No regressions detected.\n');
-                }
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            const durationMs = Date.now() - startTime;
-            if (jsonOutput) {
-                process.stdout.write(JSON.stringify({
-                    success: false,
-                    error: { code: 'E_DIFF_FAILED', message: msg },
-                    meta: {
-                        operation: 'nexus.diff',
-                        duration_ms: durationMs,
-                        timestamp: new Date().toISOString(),
-                    },
-                }, null, 2) + '\n');
-            }
-            else {
-                process.stderr.write(`[nexus] Error running diff: ${msg}\n`);
-            }
-            process.exitCode = 1;
-        }
-    });
-}
-//# sourceMappingURL=nexus.js.map