@neurcode-ai/cli 0.20.2 → 0.20.4

package/dist/commands/brain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/commands/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAshBpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAglEnD"}
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/commands/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuhBpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqsEnD"}

package/dist/commands/brain.js

@@ -50,6 +50,7 @@ const cli_runtime_1 = require("@neurcode-ai/cli-runtime");
 const brain_cache_1 = require("../utils/brain-cache");
 const local_repo_brain_1 = require("../utils/local-repo-brain");
 const repo_brain_impact_1 = require("../utils/repo-brain-impact");
+const repo_graph_impact_1 = require("../utils/repo-graph-impact");
 const config_1 = require("../config");
 const project_root_1 = require("../utils/project-root");
 const state_1 = require("../utils/state");
@@ -632,6 +633,111 @@ function brainCommand(program) {
             console.log(chalk.dim('Architecture memory not found yet (it will be created automatically on plan runs).'));
         }
     });
+    brain
+        .command('readiness')
+        .description('Repository Brain readiness: languages, parser depth, storage, caps, enforcement posture, and next command')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const scope = getBrainScope();
+        const graph = (0, brain_1.readRepositoryGraph)(scope.cwd);
+        const metadata = (0, brain_1.readRepositoryGraphMetadata)(scope.cwd);
+        const graphMeta = (0, repo_graph_impact_1.readGraphMetadataOnly)(scope.cwd);
+        const freshness = graph ? await (0, brain_1.repositoryGraphStatus)(scope.cwd) : null;
+        const storeMode = process.env.NEURCODE_GRAPH_STORE?.trim() || 'portable (default)';
+        const portableBackend = graphMeta.backend === 'portable';
+        const languages = graph?.coverage.languages ?? [];
+        const caps = metadata?.limits ?? graph?.limits ?? null;
+        const omitted = metadata?.coverageAuthority?.omittedPathPrefixes?.slice(0, 12)
+            ?? graph?.coverageAuthority?.omittedPathPrefixes?.slice(0, 12)
+            ?? [];
+        const nextCommands = graph
+            ? ['neurcode brain impact --path <file>', 'neurcode brain repo-query --help']
+            : ['neurcode brain repo-index', 'neurcode brain readiness --json'];
+        const enforcementPosture = {
+            claude: 'hard_pre_write_deny_when_hook_installed',
+            copilot: 'hard_pre_write_deny_when_hook_installed',
+            cursor: 'cooperative_advisory_mcp_checks',
+            codex: 'cooperative_advisory_mcp_checks',
+        };
+        const payload = {
+            repoRoot: scope.cwd,
+            brainState: graph ? (freshness?.state ?? 'unknown') : 'not_indexed',
+            storage: {
+                mode: storeMode,
+                backend: graphMeta.backend,
+                bytes: graphMeta.bytes,
+                impactAuthority: graphMeta.impactAuthority,
+                enterpriseScale: !portableBackend,
+                incrementalPosture: portableBackend
+                    ? 'portable_json_rewrites_full_graph_on_each_index_not_enterprise_scale'
+                    : 'sqlite_row_incremental_when_native_probe_succeeds',
+                recommendation: portableBackend
+                    ? (graphMeta.bytes && graphMeta.bytes > 32 * 1024 * 1024
+                        ? 'Set NEURCODE_GRAPH_STORE=auto or sqlite after authority proves native probe on this machine'
+                        : 'Portable JSON is fine for small repos; use sqlite/auto before large-repo pilots')
+                    : null,
+            },
+            languages: languages.map((item) => ({
+                language: item.language,
+                parserDepth: item.depth,
+                filesAnalyzed: item.filesAnalyzed,
+                parserId: item.parserId,
+            })),
+            capabilityMatrix: {
+                typescript_javascript: { imports: 'deterministic_structural', references: 'bounded_inference', calls: 'bounded_inference' },
+                python: {
+                    imports: languages.some((l) => l.language === 'python' && l.depth === 'syntax_tree')
+                        ? 'deterministic_structural'
+                        : 'regex_degraded_or_unavailable',
+                    references: 'not_evaluated',
+                    calls: 'not_evaluated',
+                },
+                other: 'path_owner_policy_only',
+            },
+            caps: caps ? {
+                maxFiles: caps.maxFiles,
+                maxNodes: caps.maxNodes,
+                maxEdges: caps.maxEdges,
+                omittedPathPrefixes: omitted,
+                coverageComplete: metadata?.coverageAuthority?.coverageComplete ?? graph?.coverageAuthority?.coverageComplete ?? null,
+            } : null,
+            enforcementPosture,
+            privacy: { metadataOnly: true, sourceUploaded: false, sourceIncluded: false },
+            nextRecommendedCommands: nextCommands,
+            recoveryCommand: graph ? 'neurcode brain repo-refresh' : 'neurcode brain repo-index',
+        };
+        if (options.json) {
+            console.log(JSON.stringify(payload, null, 2));
+            return;
+        }
+        await (0, messages_1.printSuccessBanner)('Repository Brain Readiness');
+        console.log(chalk.dim(`Repo: ${scope.cwd}`));
+        console.log(chalk.white(`State: ${payload.brainState}`));
+        console.log(chalk.white(`Storage: ${payload.storage.backend} (${graphMeta.bytes != null ? formatBytes(graphMeta.bytes) : 'n/a'})`));
+        if (payload.storage.recommendation) {
+            (0, messages_1.printInfo)('Scale recommendation', payload.storage.recommendation);
+        }
+        (0, messages_1.printSection)('Storage posture', '🗄️');
+        if (portableBackend) {
+            console.log(chalk.yellow('Portable JSON backend — not enterprise-scale incremental; full graph rewrite on index'));
+        }
+        else {
+            console.log(chalk.dim(`SQLite backend — queryable segmented store`));
+        }
+        (0, messages_1.printSection)('Languages', '🌐');
+        for (const lang of payload.languages) {
+            console.log(chalk.dim(`- ${lang.language}: ${lang.parserDepth} (${lang.filesAnalyzed} files)`));
+        }
+        if (payload.languages.length === 0) {
+            console.log(chalk.dim('No indexed languages — run neurcode brain repo-index'));
+        }
+        (0, messages_1.printSection)('Enforcement posture', '🛡️');
+        console.log(chalk.dim('Cursor/Codex: cooperative MCP checks (not hard pre-write deny)'));
+        console.log(chalk.dim('Claude/Copilot: hard deny when host hooks are installed'));
+        (0, messages_1.printSection)('Next', '▶️');
+        for (const cmd of nextCommands)
+            console.log(chalk.cyan(`  ${cmd}`));
+    });
     // -- brain index ------------------------------------------------------------
     brain
         .command('index')
@@ -838,6 +944,8 @@ function brainCommand(program) {
                     edgeCount: metadata.edgeCount,
                     graphBytes: metadata.graphBytes,
                     storageFormat: metadata.storageFormat,
+                    coverageAuthority: metadata.coverageAuthority ?? null,
+                    limits: metadata.limits,
                 } : null,
             };
             if (options.json) {
@@ -930,7 +1038,7 @@ function brainCommand(program) {
         const matches = (0, brain_1.explainRepositoryGraph)(graph, query, options.limit);
         const matchIds = new Set(matches.map((node) => node.id));
         const edges = graph.edges.filter((edge) => matchIds.has(edge.fromId) || matchIds.has(edge.toId));
-        const payload = { ok: true, query, matches, edges, freshness: graph.freshness };
+        const payload = { ok: true, query, matches, edges, freshness: graph.freshness, coverageAuthority: graph.coverageAuthority ?? null };
         if (options.json) {
             console.log(JSON.stringify(payload, null, 2));
             return;
@@ -982,7 +1090,13 @@ function brainCommand(program) {
             direction,
             limit: options.limit,
         });
-        const payload = { ok: true, query: options, ...result, freshness: graph.freshness };
+        const payload = {
+            ok: true,
+            query: options,
+            coverageAuthority: graph.coverageAuthority ?? null,
+            ...result,
+            freshness: graph.freshness,
+        };
         if (options.json) {
             console.log(JSON.stringify(payload, null, 2));
             return;
@@ -1326,7 +1440,8 @@ function brainCommand(program) {
             await (0, brain_1.indexRepositoryGraph)({ repoRoot: scope.cwd });
         }
         const report = (0, repo_brain_impact_1.buildRepoBrainImpactForRepo)(scope.cwd, paths, { autoBuild: options.index !== false });
-        const summary = (0, repo_brain_impact_1.summarizeImpact)(report);
+        const graphProjection = (0, repo_graph_impact_1.computeGraphImpactProjection)({ repoRoot: scope.cwd, changedPaths: paths });
+        const summary = (0, repo_brain_impact_1.summarizeImpact)(report, graphProjection);
         const canonicalGraph = (0, brain_1.readRepositoryGraph)(scope.cwd);
         const canonicalFreshness = canonicalGraph ? await (0, brain_1.repositoryGraphStatus)(scope.cwd) : null;
         if (options.json) {
@@ -1342,7 +1457,9 @@ function brainCommand(program) {
                     schemaVersion: canonicalGraph.schemaVersion,
                     freshness: canonicalFreshness,
                     coverage: canonicalGraph.coverage,
+                    coverageAuthority: canonicalGraph.coverageAuthority ?? null,
                 } : null,
+                graphProjection,
                 report,
                 summary,
             }, null, 2));