@neurcode-ai/cli 0.20.5 → 0.20.6

package/dist/utils/brain-scale-status.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRAIN_SCALE_STATUS_SCHEMA_VERSION = void 0;
+exports.buildBrainScaleStatus = buildBrainScaleStatus;
+/**
+ * Shared honest "scale status" builder (Scale V4 / D3a).
+ *
+ * Single source of truth for what the local repository brain knows, how it is
+ * stored, where caps bind, and what to run next. `readiness --json`,
+ * `repo-status --json`, and the impact projection all read from this builder so
+ * the runtime never reports three different stories about the same graph.
+ *
+ * Everything here is source-free: only counts, reason codes, byte sizes, and
+ * backend identifiers — never paths' contents, diffs, or symbol bodies.
+ */
+const brain_1 = require("@neurcode-ai/brain");
+const brain_lifecycle_1 = require("./brain-lifecycle");
+exports.BRAIN_SCALE_STATUS_SCHEMA_VERSION = 'neurcode.brain-scale-status.v1';
+function uniqueSorted(values) {
+    return [...new Set(values)].sort();
+}
+function scaleRecommendation(input) {
+    if (!input.indexed) {
+        return 'Run `neurcode brain repo-index` to build the source-free local graph.';
+    }
+    if (input.acceleratedFallbackToPortable) {
+        return 'NEURCODE_GRAPH_STORE requested accelerated SQLite but the native probe failed — '
+            + 'using portable JSON (full rewrite each index). Install the native module or run the '
+            + 'authority gate, then re-index.';
+    }
+    const acceleratedRequested = input.resolvedMode === 'sqlite' || input.resolvedMode === 'auto';
+    if (input.backend === 'portable' && acceleratedRequested && input.nativeProbeOk) {
+        return 'Accelerated store requested and native probe succeeds — run '
+            + '`NEURCODE_GRAPH_STORE=sqlite neurcode brain repo-index` to migrate the portable graph to SQLite.';
+    }
+    if (input.backend === 'portable'
+        && input.trackedFiles != null
+        && input.trackedFiles > brain_1.AUTO_STORE_TRACKED_FILE_THRESHOLD) {
+        return `Repository has ${input.trackedFiles} tracked files (> ${brain_1.AUTO_STORE_TRACKED_FILE_THRESHOLD}); `
+            + 'set NEURCODE_GRAPH_STORE=auto for bounded SQLite incremental before large-repo pilots.';
+    }
+    return null;
+}
+function scaleNextCommand(input) {
+    if (!input.indexed || input.acceleratedFallbackToPortable)
+        return 'neurcode brain repo-index';
+    const acceleratedRequested = input.resolvedMode === 'sqlite' || input.resolvedMode === 'auto';
+    if (input.backend === 'portable' && acceleratedRequested && input.nativeProbeOk) {
+        return 'NEURCODE_GRAPH_STORE=sqlite neurcode brain repo-index';
+    }
+    return 'neurcode brain repo-refresh';
+}
+/**
+ * Build the unified scale status. Synchronous and side-effect free: it only
+ * reads the metadata sidecar, the store selection, and the lifecycle record.
+ * Callers that already computed live freshness (readiness / repo-status) pass it
+ * in via `liveFreshness`; otherwise the recorded metadata freshness is used.
+ */
+function buildBrainScaleStatus(repoRoot, opts = {}) {
+    const selection = (0, brain_1.resolveReadStoreSelection)(repoRoot);
+    const metadata = (0, brain_1.readRepositoryGraphMetadata)(repoRoot);
+    const lifecycle = (0, brain_lifecycle_1.readBrainLifecycle)(repoRoot);
+    const probe = (0, brain_1.probeNativeGraphStore)();
+    const resolvedMode = (0, brain_1.resolveRepositoryGraphStoreMode)(repoRoot);
+    const envRaw = (process.env.NEURCODE_GRAPH_STORE ?? '').trim().toLowerCase();
+    const envExplicit = ['sqlite', 'native', 'auto', 'portable', 'json'].includes(envRaw);
+    const modeReason = envExplicit
+        ? 'env_explicit'
+        : resolvedMode === 'auto'
+            ? 'auto_tracked_threshold'
+            : 'portable_default';
+    const ca = metadata?.coverageAuthority ?? null;
+    const limits = metadata?.limits ?? null;
+    const indexed = Boolean(metadata);
+    const acceleratedRequested = resolvedMode === 'sqlite' || resolvedMode === 'auto';
+    const acceleratedFallbackToPortable = acceleratedRequested && selection.backend === 'portable' && !probe.ok;
+    const freshnessSource = opts.liveFreshness ?? metadata?.freshness ?? null;
+    const eligibleFiles = ca?.eligibleFiles ?? null;
+    const indexedFiles = ca?.indexedFiles ?? null;
+    const coveragePercent = eligibleFiles != null && eligibleFiles > 0 && indexedFiles != null
+        ? Number(((indexedFiles / eligibleFiles) * 100).toFixed(1))
+        : null;
+    const incrementalPathUsed = [
+        ...(freshnessSource?.reasonCodes ?? []),
+        ...(lifecycle?.reasonCodes ?? []),
+    ].includes('bounded_sqlite_incremental');
+    const trackedFiles = ca?.trackedFiles ?? null;
+    // When coverage-authority metadata is absent (e.g. a legacy portable artifact),
+    // fall back to freshness/limit reason codes so the caps surface never claims a
+    // cap is "not reached" while freshness already reports it binding (D3a honesty).
+    const capReasonCodes = new Set([
+        ...(freshnessSource?.reasonCodes ?? []),
+        ...(ca?.reasonCodes ?? []),
+    ]);
+    const fileCapReached = ca?.fileCapReached
+        ?? (capReasonCodes.has('file_limit') || capReasonCodes.has('file_cap_reached'));
+    const nodeCapReached = ca?.nodeCapReached
+        ?? (capReasonCodes.has('node_limit_reached') || capReasonCodes.has('node_cap_reached'));
+    const edgeCapReached = ca?.edgeCapReached
+        ?? (capReasonCodes.has('edge_limit_reached') || capReasonCodes.has('edge_cap_reached'));
+    return {
+        schemaVersion: exports.BRAIN_SCALE_STATUS_SCHEMA_VERSION,
+        indexed,
+        storage: {
+            resolvedMode,
+            modeReason,
+            backend: selection.backend,
+            backendReasonCode: selection.reasonCode ?? null,
+            nativeProbeOk: probe.ok,
+            acceleratedFallbackToPortable,
+            autoStoreTrackedFileThreshold: brain_1.AUTO_STORE_TRACKED_FILE_THRESHOLD,
+            bytes: metadata?.graphBytes ?? null,
+            recommendation: scaleRecommendation({
+                indexed,
+                backend: selection.backend,
+                resolvedMode,
+                acceleratedFallbackToPortable,
+                nativeProbeOk: probe.ok,
+                trackedFiles,
+            }),
+        },
+        freshness: {
+            state: freshnessSource?.state ?? null,
+            posture: freshnessSource?.posture ?? null,
+            reasonCodes: [...(freshnessSource?.reasonCodes ?? [])],
+        },
+        coverage: {
+            impactAuthority: ca?.impactAuthority ?? null,
+            coverageComplete: ca?.coverageComplete ?? null,
+            trackedFiles,
+            eligibleFiles,
+            discoveredFiles: ca?.discoveredFiles ?? null,
+            indexedFiles,
+            omittedFiles: ca?.omittedFiles ?? null,
+            coveragePercent,
+            omittedPackages: ca?.omittedPackages ?? [],
+            omittedPathPrefixes: ca?.omittedPathPrefixes?.slice(0, 12) ?? [],
+        },
+        caps: {
+            maxFiles: limits?.maxFiles ?? null,
+            maxNodes: limits?.maxNodes ?? null,
+            maxEdges: limits?.maxEdges ?? null,
+            nodeCount: metadata?.nodeCount ?? null,
+            edgeCount: metadata?.edgeCount ?? null,
+            fileCapReached,
+            nodeCapReached,
+            edgeCapReached,
+        },
+        timings: {
+            lastSource: lifecycle?.source ?? null,
+            lastState: lifecycle?.state ?? null,
+            lastDurationMs: lifecycle?.elapsedMs ?? null,
+            peakRssMb: lifecycle?.peakRssMb ?? null,
+            peakRssMeasurement: lifecycle?.peakRssMeasurement ?? null,
+            incrementalPathUsed,
+        },
+        // Derived from the persisted per-language coverage in the metadata sidecar
+        // (depth + facts only) — no full-graph load, no source. Always emits the
+        // seven roadmap languages; coverageComplete gates per-query authority, not
+        // these per-language capability tiers.
+        languageMatrix: (0, brain_1.buildLanguageCoverageMatrix)({
+            coverageLanguages: metadata?.coverage?.languages ?? null,
+            coverageComplete: ca?.coverageComplete ?? null,
+        }),
+        notEvaluatedReasons: uniqueSorted([
+            ...(ca?.reasonCodes ?? []),
+            ...(freshnessSource?.reasonCodes ?? []),
+        ]),
+        nextCommand: scaleNextCommand({
+            indexed,
+            backend: selection.backend,
+            resolvedMode,
+            acceleratedFallbackToPortable,
+            nativeProbeOk: probe.ok,
+        }),
+    };
+}
+//# sourceMappingURL=brain-scale-status.js.map

package/dist/utils/brain-scale-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-scale-status.js","sourceRoot":"","sources":["../../src/utils/brain-scale-status.ts"],"names":[],"mappings":"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"}

package/dist/utils/integrations-doctor.d.ts

@@ -0,0 +1,20 @@
+import { type IntegrationsCompatibilityReport } from '@neurcode-ai/contracts';
+/** Live-read version sources for the report. All optional / null-safe. */
+export interface IntegrationsVersionSources {
+    cli: string | null;
+    action: string | null;
+    vscodeExtension: string | null;
+    vscodeNewestVsix: string | null;
+}
+export interface IntegrationsDoctorInput {
+    generatedAt: string;
+    versions: IntegrationsVersionSources;
+}
+export declare function buildIntegrationsCompatibilityReport(input: IntegrationsDoctorInput): IntegrationsCompatibilityReport;
+/**
+ * Read the live version sources from repo manifests. `repoRoot` is the monorepo
+ * root; `cliVersion` is passed in (the running CLI's own version) so the report
+ * reflects the actual engine, not a manifest guess.
+ */
+export declare function collectIntegrationsVersionSources(repoRoot: string, cliVersion: string | null): IntegrationsVersionSources;
+//# sourceMappingURL=integrations-doctor.d.ts.map

package/dist/utils/integrations-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations-doctor.d.ts","sourceRoot":"","sources":["../../src/utils/integrations-doctor.ts"],"names":[],"mappings":"AA+BA,OAAO,EAIL,KAAK,+BAA+B,EAUrC,MAAM,wBAAwB,CAAC;AAwGhC,0EAA0E;AAC1E,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAgTD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,uBAAuB,GAC7B,+BAA+B,CAiFjC;AAgCD;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,0BAA0B,CAO5B"}