@neurcode-ai/cli 0.19.8 → 0.20.1

package/dist/utils/session-start-transaction.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_START_TRANSACTION_SCHEMA_VERSION = void 0;
+exports.beginSessionStartTransaction = beginSessionStartTransaction;
+exports.updateSessionStartTransaction = updateSessionStartTransaction;
+exports.clearSessionStartTransaction = clearSessionStartTransaction;
+exports.inspectSessionStartTransaction = inspectSessionStartTransaction;
+exports.recoverTimedOutSessionStart = recoverTimedOutSessionStart;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const brain_1 = require("@neurcode-ai/brain");
+const governance_runtime_1 = require("@neurcode-ai/governance-runtime");
+exports.SESSION_START_TRANSACTION_SCHEMA_VERSION = 'neurcode.session-start-transaction.v1';
+function transactionPath(repoRoot) {
+    return (0, node_path_1.join)(repoRoot, '.neurcode', 'session-starting.json');
+}
+function syncParentDirectory(path) {
+    try {
+        const descriptor = (0, node_fs_1.openSync)((0, node_path_1.dirname)(path), 'r');
+        try {
+            (0, node_fs_1.fsyncSync)(descriptor);
+        }
+        finally {
+            (0, node_fs_1.closeSync)(descriptor);
+        }
+    }
+    catch {
+        // Directory fsync is unavailable on some platforms.
+    }
+}
+function atomicWrite(path, value) {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    const temporary = `${path}.tmp.${process.pid}.${(0, node_crypto_1.randomUUID)()}`;
+    let descriptor = null;
+    try {
+        descriptor = (0, node_fs_1.openSync)(temporary, 'w', 0o600);
+        (0, node_fs_1.writeFileSync)(descriptor, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+        (0, node_fs_1.fsyncSync)(descriptor);
+        (0, node_fs_1.closeSync)(descriptor);
+        descriptor = null;
+        (0, node_fs_1.renameSync)(temporary, path);
+        syncParentDirectory(path);
+    }
+    catch (error) {
+        if (descriptor !== null) {
+            try {
+                (0, node_fs_1.closeSync)(descriptor);
+            }
+            catch { /* best effort */ }
+        }
+        try {
+            (0, node_fs_1.rmSync)(temporary, { force: true });
+        }
+        catch { /* best effort */ }
+        throw error;
+    }
+}
+function atomicCreate(path, value) {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    const temporary = `${path}.candidate.${process.pid}.${(0, node_crypto_1.randomUUID)()}`;
+    let descriptor = null;
+    try {
+        descriptor = (0, node_fs_1.openSync)(temporary, 'wx', 0o600);
+        (0, node_fs_1.writeFileSync)(descriptor, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+        (0, node_fs_1.fsyncSync)(descriptor);
+        (0, node_fs_1.closeSync)(descriptor);
+        descriptor = null;
+        // Publishing a fully-written candidate with a hard link gives concurrent
+        // starters an atomic create-if-absent boundary without a partial JSON window.
+        (0, node_fs_1.linkSync)(temporary, path);
+        syncParentDirectory(path);
+    }
+    finally {
+        if (descriptor !== null) {
+            try {
+                (0, node_fs_1.closeSync)(descriptor);
+            }
+            catch { /* best effort */ }
+        }
+        try {
+            (0, node_fs_1.rmSync)(temporary, { force: true });
+        }
+        catch { /* best effort */ }
+    }
+}
+function readTransaction(repoRoot) {
+    const path = transactionPath(repoRoot);
+    if (!(0, node_fs_1.existsSync)(path))
+        return null;
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        if (parsed.schemaVersion !== exports.SESSION_START_TRANSACTION_SCHEMA_VERSION
+            || !Number.isSafeInteger(parsed.pid)
+            || typeof parsed.commandKey !== 'string'
+            || typeof parsed.phase !== 'string') {
+            return null;
+        }
+        return {
+            ...parsed,
+            jobId: typeof parsed.jobId === 'string' && parsed.jobId
+                ? parsed.jobId
+                : `legacy-${parsed.pid}`,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function beginSessionStartTransaction(repoRoot, commandKey) {
+    const path = transactionPath(repoRoot);
+    const existing = readTransaction(repoRoot);
+    if ((0, node_fs_1.existsSync)(path)) {
+        const ownerState = existing
+            ? (0, brain_1.inspectOwnedProcess)(existing.pid, existing.processStartFingerprint)
+            : 'unknown';
+        if (!existing || ownerState === 'alive_same' || ownerState === 'unknown') {
+            throw new Error('session_start_already_running_or_unverifiable');
+        }
+        // Reclaim only a positively abandoned transaction, and only if its owner
+        // identity still matches the value we inspected.
+        const verified = readTransaction(repoRoot);
+        if (!verified
+            || verified.jobId !== existing.jobId
+            || verified.pid !== existing.pid
+            || verified.processStartFingerprint !== existing.processStartFingerprint) {
+            throw new Error('session_start_transaction_changed_during_recovery');
+        }
+        if (verified.sessionId)
+            (0, governance_runtime_1.removeSession)(repoRoot, verified.sessionId);
+        (0, node_fs_1.rmSync)(path, { force: true });
+    }
+    const now = new Date().toISOString();
+    const transaction = {
+        schemaVersion: exports.SESSION_START_TRANSACTION_SCHEMA_VERSION,
+        commandKey,
+        jobId: (0, node_crypto_1.randomUUID)(),
+        pid: process.pid,
+        processStartFingerprint: (0, brain_1.processStartFingerprint)(process.pid),
+        startedAt: now,
+        updatedAt: now,
+        phase: 'initializing_runtime',
+        sessionId: null,
+    };
+    try {
+        atomicCreate(path, transaction);
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : '';
+        if (code === 'EEXIST')
+            throw new Error('session_start_already_running');
+        throw error;
+    }
+    return transaction;
+}
+function updateSessionStartTransaction(repoRoot, update) {
+    const current = readTransaction(repoRoot);
+    if (!current || current.pid !== process.pid)
+        return current;
+    const next = {
+        ...current,
+        updatedAt: new Date().toISOString(),
+        phase: update.phase,
+        sessionId: update.sessionId === undefined ? current.sessionId : update.sessionId,
+    };
+    atomicWrite(transactionPath(repoRoot), next);
+    return next;
+}
+function clearSessionStartTransaction(repoRoot) {
+    const current = readTransaction(repoRoot);
+    if (!current
+        || current.pid !== process.pid
+        || current.processStartFingerprint !== (0, brain_1.processStartFingerprint)(process.pid))
+        return;
+    try {
+        (0, node_fs_1.rmSync)(transactionPath(repoRoot), { force: true });
+    }
+    catch { /* best effort */ }
+}
+function inspectSessionStartTransaction(repoRoot) {
+    const current = readTransaction(repoRoot);
+    return current ? {
+        phase: current.phase,
+        sessionId: current.sessionId,
+        ownerState: (0, brain_1.inspectOwnedProcess)(current.pid, current.processStartFingerprint),
+    } : null;
+}
+function recoverTimedOutSessionStart(repoRoot, childPid) {
+    const current = readTransaction(repoRoot);
+    if (!current || current.pid !== childPid)
+        return { recovered: false, phase: current?.phase ?? null };
+    const identity = (0, brain_1.inspectOwnedProcess)(current.pid, current.processStartFingerprint);
+    if (identity === 'alive_same' || identity === 'unknown') {
+        return { recovered: false, phase: current.phase };
+    }
+    if (current.sessionId) {
+        (0, governance_runtime_1.removeSession)(repoRoot, current.sessionId);
+    }
+    try {
+        (0, node_fs_1.rmSync)(transactionPath(repoRoot), { force: true });
+    }
+    catch { /* best effort */ }
+    return { recovered: true, phase: current.phase };
+}
+//# sourceMappingURL=session-start-transaction.js.map

package/dist/utils/session-start-transaction.js.map

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

package/dist/utils/v0-governance.d.ts

@@ -1,4 +1,4 @@
-import { type ModuleImportRecord, type RepoGovernanceProfile, type RuntimeGovernanceConfig } from '@neurcode-ai/governance-runtime';
+import { type GeneratedProvenanceEvidence, type ModuleImportRecord, type RepositoryManifestEvidence, type RepoGovernanceProfile, type RuntimeGovernanceConfig } from '@neurcode-ai/governance-runtime';
 export declare const CODEOWNERS_CANDIDATES: string[];
 export declare const MANIFEST_CANDIDATES: string[];
 declare const COPILOT_HOOK_EVENTS: readonly ["UserPromptSubmit", "PreToolUse", "Stop"];
@@ -159,6 +159,7 @@ export interface GovernanceConfigReadResult {
 }
 export declare function resolveRepoRoot(cwd?: string): string;
 export declare function gitLsFiles(cwd: string): string[];
+export declare function readGeneratedProvenanceEvidence(repoRoot: string, paths: string[], manifests: RepositoryManifestEvidence[]): GeneratedProvenanceEvidence[];
 export declare function governanceConfigPath(repoRoot: string): string;
 export declare function readRuntimeGovernanceConfig(repoRoot: string): GovernanceConfigReadResult;
 /**

package/dist/utils/v0-governance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v0-governance.d.ts","sourceRoot":"","sources":["../../src/utils/v0-governance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"v0-governance.d.ts","sourceRoot":"","sources":["../../src/utils/v0-governance.ts"],"names":[],"mappings":"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"}

package/dist/utils/v0-governance.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROFILE_STALENESS_CACHE_TTL_MS = exports.CLAUDE_GOVERNANCE_HOOKS = exports.MANIFEST_CANDIDATES = exports.CODEOWNERS_CANDIDATES = void 0;
 exports.resolveRepoRoot = resolveRepoRoot;
 exports.gitLsFiles = gitLsFiles;
+exports.readGeneratedProvenanceEvidence = readGeneratedProvenanceEvidence;
 exports.governanceConfigPath = governanceConfigPath;
 exports.readRuntimeGovernanceConfig = readRuntimeGovernanceConfig;
 exports.readModuleImports = readModuleImports;
@@ -30,11 +31,32 @@ const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
 const governance_runtime_1 = require("@neurcode-ai/governance-runtime");
+const brain_1 = require("@neurcode-ai/brain");
+const glob_match_1 = require("../governance/intent/glob-match");
 exports.CODEOWNERS_CANDIDATES = ['CODEOWNERS', '.github/CODEOWNERS', 'docs/CODEOWNERS'];
-exports.MANIFEST_CANDIDATES = ['package.json', 'pyproject.toml', 'go.mod', 'Cargo.toml', 'pom.xml'];
+exports.MANIFEST_CANDIDATES = [
+    'package.json',
+    'pnpm-workspace.yaml',
+    'lerna.json',
+    'nx.json',
+    'turbo.json',
+    'rush.json',
+    'workspace.json',
+    'pyproject.toml',
+    'setup.py',
+    'setup.cfg',
+    'go.mod',
+    'Cargo.toml',
+    'pom.xml',
+    'build.gradle',
+    'build.gradle.kts',
+    'Gemfile',
+    'composer.json',
+    'Package.swift',
+];
 const CLAUDE_MCP_ENTRY = Object.freeze({
     command: 'npx',
-    args: ['-y', '@neurcode-ai/mcp-server@0.2.4'],
+    args: ['-y', '@neurcode-ai/mcp-server@0.3.1'],
 });
 const CLAUDE_PRE_TOOL_MATCHER = 'Bash|Edit|Write|MultiEdit';
 const COPILOT_HOOK_EVENTS = ['UserPromptSubmit', 'PreToolUse', 'Stop'];
@@ -207,6 +229,169 @@ function readFirstExisting(cwd, candidates) {
     }
     return { path: null, content: null };
 }
+function readManifestBundle(cwd, paths) {
+    const manifestNames = new Set(exports.MANIFEST_CANDIDATES);
+    return paths
+        .filter((pathValue) => manifestNames.has((0, path_1.basename)(pathValue)))
+        .sort()
+        .map((pathValue) => {
+        try {
+            return { path: pathValue, content: (0, fs_1.readFileSync)((0, path_1.join)(cwd, pathValue), 'utf8') };
+        }
+        catch {
+            return { path: pathValue, content: null };
+        }
+    });
+}
+const GENERATED_HEADER_RE = /(?:@generated\b|\b(?:generated (?:file|code)|do not edit|automatically generated)\b)/i;
+const GENERATOR_CONFIG_RE = /(?:^|\/)(?:openapi-generator[^/]*|buf\.gen|orval\.config|graphql-codegen)[^/]*\.(?:json|ya?ml|[cm]?[jt]s)$/i;
+function normalizeGeneratedPath(value) {
+    return value.trim().replace(/^['"]|['"],?$/g, '').replace(/\\/g, '/').replace(/^\.\//, '');
+}
+function nearestGenerationCommand(outputPath, manifests) {
+    const candidates = manifests
+        .filter((manifest) => (0, path_1.basename)(manifest.path) === 'package.json' && manifest.content)
+        .map((manifest) => {
+        try {
+            const parsed = JSON.parse(manifest.content);
+            const script = Object.keys(parsed.scripts ?? {})
+                .filter((name) => /(?:^|:)(?:generate|codegen|gen)(?::|$)/i.test(name))
+                .sort()[0];
+            const root = (0, path_1.dirname)(manifest.path) === '.' ? '' : (0, path_1.dirname)(manifest.path).replace(/\\/g, '/');
+            return script && (!root || outputPath === root || outputPath.startsWith(`${root}/`))
+                ? { root, command: `pnpm${root ? ` --dir ${root}` : ''} run ${script}` }
+                : null;
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((candidate) => Boolean(candidate))
+        .sort((left, right) => right.root.length - left.root.length);
+    return candidates[0]?.command ?? null;
+}
+function resolveGeneratedSource(outputPath, candidate, tracked) {
+    if (!candidate)
+        return null;
+    const normalized = normalizeGeneratedPath(candidate);
+    if (tracked.has(normalized))
+        return normalized;
+    const relativeCandidate = normalizeGeneratedPath((0, path_1.join)((0, path_1.dirname)(outputPath), normalized));
+    return tracked.has(relativeCandidate) ? relativeCandidate : null;
+}
+function readGeneratedProvenanceEvidence(repoRoot, paths, manifests) {
+    const tracked = new Set(paths);
+    const evidence = new Map();
+    const record = (item) => {
+        const outputPath = normalizeGeneratedPath(item.outputPath);
+        if (!tracked.has(outputPath))
+            return;
+        const command = item.command ?? nearestGenerationCommand(outputPath, manifests);
+        evidence.set(`${outputPath}:${item.evidenceType}:${item.sourcePath ?? ''}`, {
+            ...item,
+            outputPath,
+            command,
+        });
+    };
+    const attributesPath = (0, path_1.join)(repoRoot, '.gitattributes');
+    if (tracked.has('.gitattributes') && (0, fs_1.existsSync)(attributesPath)) {
+        try {
+            for (const rawLine of (0, fs_1.readFileSync)(attributesPath, 'utf8').split('\n')) {
+                const line = rawLine.trim();
+                if (!line || line.startsWith('#') || !/\blinguist-generated(?:=true)?\b/i.test(line))
+                    continue;
+                const pattern = normalizeGeneratedPath(line.split(/\s+/)[0] ?? '');
+                for (const pathValue of paths) {
+                    if (pathValue !== '.gitattributes' && (0, glob_match_1.matchesGlob)(pattern, pathValue)) {
+                        record({ outputPath: pathValue, evidenceType: 'gitattributes' });
+                    }
+                }
+            }
+        }
+        catch {
+            // Unreadable attributes are non-authoritative; other provenance still applies.
+        }
+    }
+    for (const outputPath of paths.slice(0, MAX_GRAPH_FILES)) {
+        if (outputPath.endsWith('.sha256')) {
+            const target = outputPath.slice(0, -'.sha256'.length);
+            if (tracked.has(target))
+                record({ outputPath: target, evidenceType: 'checksum' });
+            continue;
+        }
+        const absolute = (0, path_1.join)(repoRoot, outputPath);
+        let head = '';
+        try {
+            if (!(0, fs_1.existsSync)(absolute))
+                continue;
+            head = (0, fs_1.readFileSync)(absolute, 'utf8').slice(0, 12_000);
+        }
+        catch {
+            continue;
+        }
+        if (GENERATED_HEADER_RE.test(head)) {
+            const sourceMatch = head.match(/(?:generated from|source(?: of truth)?)[\s:=]+['"]?([A-Za-z0-9_./-]+\.[A-Za-z0-9_-]+)/i);
+            record({
+                outputPath,
+                sourcePath: resolveGeneratedSource(outputPath, sourceMatch?.[1], tracked),
+                evidenceType: 'generated-header',
+            });
+        }
+        if (GENERATOR_CONFIG_RE.test(outputPath)) {
+            const outputMatch = head.match(/(?:output|outDir|outputDir|outputDirectory)[\s:="'{]+([A-Za-z0-9_./-]+)/i);
+            if (!outputMatch?.[1])
+                continue;
+            const outputRoot = normalizeGeneratedPath((0, path_1.join)((0, path_1.dirname)(outputPath), outputMatch[1]));
+            const sourceMatch = head.match(/(?:inputSpec|schema|source)[\s:="'{]+([A-Za-z0-9_./-]+\.[A-Za-z0-9_-]+)/i);
+            for (const candidate of paths.filter((pathValue) => pathValue === outputRoot || pathValue.startsWith(`${outputRoot}/`))) {
+                record({
+                    outputPath: candidate,
+                    sourcePath: resolveGeneratedSource(outputPath, sourceMatch?.[1], tracked),
+                    evidenceType: 'generator-config',
+                });
+            }
+        }
+    }
+    return Array.from(evidence.values()).sort((left, right) => left.outputPath.localeCompare(right.outputPath) || left.evidenceType.localeCompare(right.evidenceType));
+}
+function readTopologyBrainFacts(repoRoot) {
+    const graph = (0, brain_1.readRepositoryGraph)(repoRoot);
+    if (!graph)
+        return null;
+    const facts = [];
+    const nodesById = new Map(graph.nodes.map((node) => [node.id, node]));
+    for (const node of graph.nodes) {
+        if (!node.path)
+            continue;
+        if (node.kind === 'symbol' || node.kind === 'package' || node.kind === 'test') {
+            facts.push({
+                kind: node.kind,
+                path: node.path,
+                name: node.name,
+            });
+        }
+    }
+    for (const edge of graph.edges) {
+        const from = nodesById.get(edge.fromId);
+        const to = nodesById.get(edge.toId);
+        if (!from?.path || !to?.path)
+            continue;
+        const kind = edge.type === 'imports'
+            ? 'import'
+            : edge.type === 'tests'
+                ? 'test'
+                : 'reference';
+        facts.push({
+            kind,
+            path: from.path,
+            relatedPath: to.path,
+        });
+    }
+    return {
+        freshness: graph.freshness.state,
+        facts: facts.slice(0, 20_000),
+    };
+}
 function prefixCodeownersContent(content, baseDir) {
     const prefix = baseDir.replace(/\\/g, '/').replace(/\/$/, '');
     if (!prefix || prefix === '.')
@@ -443,16 +628,22 @@ function buildCurrentGovernanceProfile(repoRoot, options = {}) {
     const paths = gitLsFiles(root);
     const codeowners = readCodeownersBundle(root, paths);
     const manifest = readFirstExisting(root, exports.MANIFEST_CANDIDATES);
+    const manifests = readManifestBundle(root, paths);
     const governance = readRuntimeGovernanceConfig(root);
     const imports = readModuleImports(root, paths);
+    const brain = readTopologyBrainFacts(root);
+    const generatedEvidence = readGeneratedProvenanceEvidence(root, paths, manifests);
     const profile = (0, governance_runtime_1.buildRepoGovernanceProfile)({
         paths,
         codeownersContent: codeowners.content,
         manifestContent: manifest.content,
+        manifests,
         repoName: (0, path_1.basename)(root),
         source: 'local',
         runtimeConfig: governance.config,
         imports,
+        brain,
+        generatedEvidence,
     });
     if (options.bypassCache !== true && process.env.NEURCODE_PROFILE_CACHE !== '0') {
         writeProfileBuildFileCache(root, profile, stateFingerprint);
@@ -468,10 +659,14 @@ function readProfileBuildFileCache(repoRoot, stateFingerprint) {
         return null;
     try {
         const parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
-        if (!parsed.profile || !parsed.expiresAt || stateFingerprint === null || parsed.stateFingerprint === null)
-            return null;
-        if (Date.now() > Date.parse(parsed.expiresAt))
+        if (!parsed.profile || stateFingerprint === null || parsed.stateFingerprint === null)
             return null;
+        // The repository-state fingerprint, not wall-clock age, is the cache's
+        // correctness boundary. Expiring an unchanged cache forced large repos to
+        // reload their complete repository graph every five minutes, which made
+        // otherwise read-only status commands exceed their budgets. Keep writing
+        // expiresAt for backward compatibility with older readers, but reuse the
+        // persisted profile for as long as the source-free fingerprint matches.
         if (parsed.stateFingerprint !== stateFingerprint)
             return null;
         return parsed.profile;
@@ -570,6 +765,35 @@ function profileFreshnessActionForSession(result, sessionProfileHash) {
 }
 const profileStalenessCache = new Map();
 let lastProfileCacheHit = false;
+function changedPathContentFingerprint(root, path) {
+    const absolutePath = (0, path_1.join)(root, path);
+    try {
+        const stat = (0, fs_1.lstatSync)(absolutePath);
+        if (stat.isSymbolicLink()) {
+            return `${path}\0symlink\0${(0, fs_1.readlinkSync)(absolutePath)}`;
+        }
+        if (!stat.isFile())
+            return `${path}\0${stat.mode}\0${stat.size}`;
+        const hash = (0, crypto_1.createHash)('sha256');
+        const descriptor = (0, fs_1.openSync)(absolutePath, 'r');
+        const buffer = Buffer.allocUnsafe(64 * 1024);
+        try {
+            let bytesRead = 0;
+            do {
+                bytesRead = (0, fs_1.readSync)(descriptor, buffer, 0, buffer.length, null);
+                if (bytesRead > 0)
+                    hash.update(buffer.subarray(0, bytesRead));
+            } while (bytesRead > 0);
+        }
+        finally {
+            (0, fs_1.closeSync)(descriptor);
+        }
+        return `${path}\0file\0${stat.mode}\0${stat.size}\0${hash.digest('hex')}`;
+    }
+    catch {
+        return `${path}\0missing`;
+    }
+}
 function profileCacheStateFingerprint(root) {
     try {
         let head = 'unborn';
@@ -578,32 +802,68 @@ function profileCacheStateFingerprint(root) {
                 cwd: root,
                 encoding: 'utf8',
                 stdio: ['ignore', 'pipe', 'ignore'],
+                timeout: 3_000,
             }).trim();
         }
         catch {
             // `git status` remains authoritative before the first commit. Keep an
             // explicit sentinel so staged topology changes still invalidate caches.
         }
-        const status = (0, child_process_1.execSync)('git status --short --untracked-files=normal', {
+        const internalPathExclusions = [
+            '--',
+            '.',
+            ':(exclude).neurcode/**',
+            ':(exclude).neurcode-admission/**',
+            ':(exclude).cursor/rules/neurcode-*',
+        ];
+        const status = (0, child_process_1.execFileSync)('git', [
+            'status', '--porcelain=v2', '-z', '--untracked-files=all',
+            ...internalPathExclusions,
+        ], {
+            cwd: root,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            maxBuffer: 8 * 1024 * 1024,
+            timeout: 5_000,
+        });
+        const stagedSummary = (0, child_process_1.execFileSync)('git', [
+            'diff', '--cached', '--no-ext-diff', '--numstat', '-z',
+            ...internalPathExclusions,
+        ], {
             cwd: root,
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
             maxBuffer: 4 * 1024 * 1024,
+            timeout: 5_000,
         });
-        const stagedDiff = (0, child_process_1.execSync)('git diff --cached --no-ext-diff --binary', {
+        const worktreeSummary = (0, child_process_1.execFileSync)('git', [
+            'diff', '--no-ext-diff', '--numstat', '-z',
+            ...internalPathExclusions,
+        ], {
             cwd: root,
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
-            maxBuffer: 8 * 1024 * 1024,
+            maxBuffer: 4 * 1024 * 1024,
+            timeout: 5_000,
         });
-        const worktreeDiff = (0, child_process_1.execSync)('git diff --no-ext-diff --binary', {
+        const changedPaths = (0, child_process_1.execFileSync)('git', [
+            'ls-files', '-m', '-o', '--exclude-standard', '-z',
+            ...internalPathExclusions,
+        ], {
             cwd: root,
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
             maxBuffer: 8 * 1024 * 1024,
-        });
+            timeout: 5_000,
+        }).split('\0').filter(Boolean).sort();
+        // Only dirty/untracked paths are content-hashed. This preserves exact
+        // invalidation (including same-size edits with restored mtimes) without
+        // rescanning every tracked file or following repository symlinks.
+        const workingContent = changedPaths
+            .map((path) => changedPathContentFingerprint(root, path))
+            .join('\n');
         return (0, crypto_1.createHash)('sha256')
-            .update(`${head}\n${status}\n${stagedDiff}\n${worktreeDiff}`)
+            .update(`${head}\n${status}\n${stagedSummary}\n${worktreeSummary}\n${workingContent}`)
             .digest('hex')
             .slice(0, 24);
     }