@cleocode/cleo 2026.4.42 → 2026.4.44

package/dist/cli/commands/nexus.js

@@ -1,1163 +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,
-};
-/**
- * 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
-            }
-            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 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;
-        }
-    });
-}
-//# sourceMappingURL=nexus.js.map