@neurcode-ai/cli 0.19.8 → 0.20.1

package/dist/utils/command-budget.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_BUDGETS = void 0;
+exports.maybeRunBoundedCliCommand = maybeRunBoundedCliCommand;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+const session_start_transaction_1 = require("./session-start-transaction");
+exports.COMMAND_BUDGETS = {
+    run_agent: {
+        budgetMs: 60_000,
+        recoveryCommand: 'neurcode doctor --runtime --json',
+        phases: ['initializing_runtime', 'fingerprinting_profile', 'persisting_deferred_session', 'shaping_session', 'activating_session', 'reconciling_cloud'],
+        sessionStart: true,
+    },
+    session_hook_start: {
+        budgetMs: 45_000,
+        recoveryCommand: 'neurcode doctor --runtime --json',
+        phases: ['initializing_runtime', 'fingerprinting_profile', 'persisting_deferred_session', 'shaping_session', 'activating_session', 'reconciling_cloud'],
+        sessionStart: true,
+    },
+    session_hook_approve: {
+        budgetMs: 12_000,
+        recoveryCommand: 'neurcode session status --local --json',
+        phases: ['loading_session', 'persisting_exact_approval', 'reconciling_cloud'],
+        sessionStart: false,
+    },
+    session_status: {
+        budgetMs: 8_000,
+        recoveryCommand: 'neurcode doctor --runtime --json',
+        phases: ['loading_session', 'checking_profile_fingerprint', 'projecting_runtime_state'],
+        sessionStart: false,
+    },
+    runtime_report: {
+        budgetMs: 12_000,
+        recoveryCommand: 'neurcode report --runtime --since 24h --format json',
+        phases: ['enumerating_session_records', 'building_source_free_report', 'rendering_report'],
+        sessionStart: false,
+    },
+    runtime_doctor: {
+        budgetMs: 12_000,
+        recoveryCommand: 'neurcode doctor --runtime --json',
+        phases: ['checking_installation', 'checking_profile_fingerprint', 'classifying_runtime_state'],
+        sessionStart: false,
+    },
+    cloud_status: {
+        budgetMs: 8_000,
+        recoveryCommand: 'neurcode runtime cloud-status --json',
+        phases: ['loading_local_projection', 'contacting_runtime_backend', 'rendering_cloud_status'],
+        sessionStart: false,
+    },
+};
+function commandKey(argv) {
+    if (argv[0] === 'run')
+        return 'run_agent';
+    if (argv[0] === 'session-hook' && argv.includes('start'))
+        return 'session_hook_start';
+    if (argv[0] === 'session-hook' && argv.includes('approve'))
+        return 'session_hook_approve';
+    if (argv[0] === 'status')
+        return 'session_status';
+    if (argv[0] === 'session' && argv[1] === 'status')
+        return 'session_status';
+    if (argv[0] === 'report' && argv.includes('--runtime'))
+        return 'runtime_report';
+    if (argv[0] === 'doctor' && argv.includes('--runtime'))
+        return 'runtime_doctor';
+    if (argv[0] === 'runtime' && argv[1] === 'cloud-status')
+        return 'cloud_status';
+    return null;
+}
+function optionValue(argv, option) {
+    const index = argv.indexOf(option);
+    if (index < 0 || index + 1 >= argv.length)
+        return null;
+    return argv[index + 1] || null;
+}
+function budgetFor(key) {
+    const envKey = `NEURCODE_COMMAND_BUDGET_MS_${key.toUpperCase()}`;
+    const configured = Number(process.env[envKey]);
+    if (Number.isSafeInteger(configured) && configured >= 100)
+        return configured;
+    return exports.COMMAND_BUDGETS[key].budgetMs;
+}
+function terminateOwnedProcessGroup(pid) {
+    try {
+        process.kill(-pid, 'SIGTERM');
+    }
+    catch {
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch { /* already gone */ }
+    }
+    const timer = setTimeout(() => {
+        try {
+            process.kill(-pid, 'SIGKILL');
+        }
+        catch {
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch { /* already gone */ }
+        }
+    }, 500);
+    timer.unref();
+}
+async function maybeRunBoundedCliCommand(argv) {
+    if (process.env.NEURCODE_BOUNDED_COMMAND_CHILD === '1') {
+        const testHangMs = process.env.NODE_ENV === 'test'
+            ? Number(process.env.NEURCODE_TEST_BOUNDED_COMMAND_HANG_MS)
+            : Number.NaN;
+        if (Number.isSafeInteger(testHangMs) && testHangMs > 0) {
+            await new Promise((resolveDelay) => setTimeout(resolveDelay, testHangMs));
+        }
+        return false;
+    }
+    const key = commandKey(argv);
+    if (!key)
+        return false;
+    const definition = exports.COMMAND_BUDGETS[key];
+    const budgetMs = budgetFor(key);
+    const repoRoot = (0, node_path_1.resolve)(optionValue(argv, '--dir') || process.cwd());
+    const startedAt = Date.now();
+    const maxOutputBytes = 8 * 1024 * 1024;
+    let stdout = Buffer.alloc(0);
+    let stderr = Buffer.alloc(0);
+    let timedOut = false;
+    let outputOverflow = false;
+    const child = (0, node_child_process_1.spawn)(process.execPath, [...process.execArgv, process.argv[1], ...argv], {
+        cwd: process.cwd(),
+        detached: process.platform !== 'win32',
+        stdio: ['inherit', 'pipe', 'pipe'],
+        env: {
+            ...process.env,
+            NEURCODE_BOUNDED_COMMAND_CHILD: '1',
+            NEURCODE_BOUNDED_COMMAND_KEY: key,
+        },
+    });
+    child.stdout.on('data', (chunk) => {
+        if (stdout.length + chunk.length > maxOutputBytes) {
+            outputOverflow = true;
+            terminateOwnedProcessGroup(child.pid);
+            return;
+        }
+        stdout = Buffer.concat([stdout, chunk]);
+    });
+    child.stderr.on('data', (chunk) => {
+        if (stderr.length + chunk.length > maxOutputBytes) {
+            outputOverflow = true;
+            terminateOwnedProcessGroup(child.pid);
+            return;
+        }
+        stderr = Buffer.concat([stderr, chunk]);
+    });
+    const timeout = setTimeout(() => {
+        timedOut = true;
+        if (child.pid)
+            terminateOwnedProcessGroup(child.pid);
+    }, budgetMs);
+    timeout.unref();
+    const exit = await new Promise((done) => {
+        child.once('error', () => done({ code: 1, signal: null }));
+        child.once('exit', (code, signal) => done({ code, signal }));
+    });
+    clearTimeout(timeout);
+    if (!timedOut && !outputOverflow) {
+        if (stdout.length > 0)
+            process.stdout.write(stdout);
+        if (stderr.length > 0)
+            process.stderr.write(stderr);
+        process.exitCode = exit.code ?? (exit.signal ? 1 : 0);
+        return true;
+    }
+    const transaction = (0, session_start_transaction_1.inspectSessionStartTransaction)(repoRoot);
+    const recovery = definition.sessionStart && child.pid
+        ? (0, session_start_transaction_1.recoverTimedOutSessionStart)(repoRoot, child.pid)
+        : { recovered: false, phase: transaction?.phase ?? null };
+    const payload = {
+        ok: false,
+        status: 'attention_required',
+        reasonCode: outputOverflow ? 'command_output_budget_exceeded' : 'command_budget_exceeded',
+        command: key,
+        budgetMs,
+        elapsedMs: Date.now() - startedAt,
+        phases: definition.phases,
+        lastPhase: recovery.phase,
+        recoveryCommand: definition.recoveryCommand,
+        cleanup: {
+            ownedWorkerTerminated: true,
+            partialSessionRecovered: recovery.recovered,
+            unresolvedDecisionsPreserved: true,
+        },
+        privacy: {
+            metadataOnly: true,
+            sourceUploaded: false,
+            sourceIncluded: false,
+        },
+    };
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+    process.exitCode = 2;
+    return true;
+}
+//# sourceMappingURL=command-budget.js.map

package/dist/utils/command-budget.js.map

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

package/dist/utils/mcp-server-pin.d.ts

@@ -1,5 +1,5 @@
 export declare const MCP_SERVER_PACKAGE: "@neurcode-ai/mcp-server";
-export declare const MIN_MCP_SERVER_VERSION: "0.2.5";
+export declare const MIN_MCP_SERVER_VERSION: "0.3.1";
 /** Legacy relative paths fail when Cursor MCP cwd is not the workspace root. */
 export declare const PINNED_MCP_ENTRY_RELATIVE: "mcp-server/node_modules/@neurcode-ai/mcp-server/dist/index.js";
 export declare function pinnedMcpBaseRoot(repoRoot: string, global?: boolean): string;

package/dist/utils/mcp-server-pin.js

@@ -18,7 +18,7 @@ const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 const node_child_process_1 = require("node:child_process");
 exports.MCP_SERVER_PACKAGE = '@neurcode-ai/mcp-server';
-exports.MIN_MCP_SERVER_VERSION = '0.2.5';
+exports.MIN_MCP_SERVER_VERSION = '0.3.1';
 /** Legacy relative paths fail when Cursor MCP cwd is not the workspace root. */
 exports.PINNED_MCP_ENTRY_RELATIVE = 'mcp-server/node_modules/@neurcode-ai/mcp-server/dist/index.js';
 function pinnedMcpBaseRoot(repoRoot, global = false) {
@@ -37,7 +37,7 @@ function ensurePinnedMcpServer(baseRoot) {
     }
     const installDir = mcpServerPinDir(baseRoot);
     (0, node_fs_1.mkdirSync)(installDir, { recursive: true });
-    const versionsToTry = [exports.MIN_MCP_SERVER_VERSION, '0.2.3', '0.2.2'].filter((version, index, all) => all.indexOf(version) === index);
+    const versionsToTry = [exports.MIN_MCP_SERVER_VERSION, '0.3.0', '0.2.5'].filter((version, index, all) => all.indexOf(version) === index);
     let lastMessage = `Failed to install pinned MCP server (${exports.MCP_SERVER_PACKAGE}).`;
     for (const version of versionsToTry) {
         const install = (0, node_child_process_1.spawnSync)('npm', [

package/dist/utils/runtime-authority.d.ts

@@ -0,0 +1,27 @@
+import { type ActivatedRuntimeIntegration, type RuntimeAdapter, type RuntimeAuthorityAssessment } from '@neurcode-ai/cli-runtime';
+import { type BrainLifecycleStatus } from './brain-lifecycle';
+export interface RuntimeAuthorityRepairResult {
+    ok: true;
+    repoRoot: string;
+    manifestPath: string;
+    manifestHash: string;
+    changed: boolean;
+    integrations: ActivatedRuntimeIntegration[];
+    repaired: string[];
+    preserved: string[];
+    brain: BrainLifecycleStatus;
+    restartRequired: boolean;
+    nextCheck: string;
+}
+export declare function recordActivatedRuntime(repoRootInput: string, adapters: RuntimeAdapter[]): Promise<{
+    manifestPath: string;
+    manifestHash: string;
+    changed: boolean;
+    brain: BrainLifecycleStatus;
+}>;
+export declare function repairRuntimeAuthority(repoRootInput: string): Promise<RuntimeAuthorityRepairResult>;
+export declare function inspectRuntimeAuthority(repoRootInput: string, adapter?: RuntimeAdapter, protectedOperation?: boolean): RuntimeAuthorityAssessment;
+export declare function assertProtectedRuntimeAuthority(repoRootInput: string, adapter: RuntimeAdapter | 'neurcode-cli'): RuntimeAuthorityAssessment;
+export declare function runtimeManifestExists(repoRootInput: string): boolean;
+export declare function activeRuntimeEntrypoint(): string;
+//# sourceMappingURL=runtime-authority.d.ts.map

package/dist/utils/runtime-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-authority.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-authority.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAEhC,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGlF,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,2BAA2B,EAAE,CAAC;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmED,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,EAAE,GACzB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAwBxG;AAED,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAqCzG;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,cAAsB,EAC/B,kBAAkB,UAAQ,GACzB,0BAA0B,CAY5B;AAED,wBAAgB,+BAA+B,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,0BAA0B,CAO3I;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/utils/runtime-authority.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordActivatedRuntime = recordActivatedRuntime;
+exports.repairRuntimeAuthority = repairRuntimeAuthority;
+exports.inspectRuntimeAuthority = inspectRuntimeAuthority;
+exports.assertProtectedRuntimeAuthority = assertProtectedRuntimeAuthority;
+exports.runtimeManifestExists = runtimeManifestExists;
+exports.activeRuntimeEntrypoint = activeRuntimeEntrypoint;
+const cli_runtime_1 = require("@neurcode-ai/cli-runtime");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const v0_governance_1 = require("./v0-governance");
+const cli_entry_1 = require("./cli-entry");
+const brain_lifecycle_1 = require("./brain-lifecycle");
+const agent_adapter_setup_1 = require("./agent-adapter-setup");
+const TARGETS = [
+    { adapter: 'cli', enforcementLevel: 'cooperative' },
+    { adapter: 'claude-code-hooks', enforcementLevel: 'hard_hook' },
+    { adapter: 'copilot-hooks', enforcementLevel: 'hard_hook' },
+    { adapter: 'codex-mcp', enforcementLevel: 'cooperative' },
+    { adapter: 'cursor-mcp', enforcementLevel: 'cooperative' },
+    { adapter: 'generic-mcp', enforcementLevel: 'cooperative' },
+    { adapter: 'supervisor', enforcementLevel: 'supervised' },
+    { adapter: 'daemon', enforcementLevel: 'observe_only' },
+    { adapter: 'vscode-extension', enforcementLevel: 'observe_only' },
+    { adapter: 'github-action', enforcementLevel: 'post_pr' },
+];
+function writeRuntimeWiring(repoRoot, entrypoint) {
+    const path = (0, node_path_1.join)(repoRoot, '.neurcode', 'runtime-wiring.json');
+    const payload = {
+        schemaVersion: 'neurcode.runtime-wiring.v1',
+        cliEntrypoint: entrypoint,
+        supervisor: { command: process.execPath, argsPrefix: [entrypoint] },
+        daemon: { command: process.execPath, argsPrefix: [entrypoint, 'daemon'] },
+        vscode: { command: process.execPath, argsPrefix: [entrypoint] },
+        action: { authority: 'post_pr', localRuntimeEntrypoint: entrypoint },
+    };
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    const temporary = `${path}.tmp.${process.pid}`;
+    (0, node_fs_1.writeFileSync)(temporary, `${JSON.stringify(payload, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+    (0, node_fs_1.renameSync)(temporary, path);
+    return path;
+}
+function integrationsForCurrentRuntime(adapters) {
+    const identity = (0, cli_runtime_1.collectCliRuntimeIdentity)({ bundledCliDir: (0, cli_entry_1.bundledCliDir)() });
+    const activatedAt = new Date().toISOString();
+    return TARGETS
+        .filter((target) => adapters.includes(target.adapter))
+        .map((target) => ({
+        adapter: target.adapter,
+        enforcementLevel: target.enforcementLevel,
+        activatedAt,
+        absoluteEntrypoint: identity.entryRealPath,
+        buildHash: identity.buildFingerprint,
+        installationSource: identity.source === 'workspace' ? 'workspace_build' : identity.source === 'packaged' ? 'packaged_artifact' : 'registry',
+        machinePinned: target.adapter === 'claude-code-hooks' || target.adapter === 'copilot-hooks',
+    }));
+}
+function sameActivation(existing, next) {
+    if (!existing)
+        return false;
+    return existing.repositoryHash === next.repositoryHash
+        && existing.profileHash === next.profileHash
+        && existing.runtime.cliVersion === next.runtime.cliVersion
+        && existing.runtime.packageOrBuildHash === next.runtime.packageOrBuildHash
+        && existing.runtime.absoluteEntrypoint === next.runtime.absoluteEntrypoint
+        && JSON.stringify(existing.integrations.map(({ activatedAt: _activatedAt, ...rest }) => rest))
+            === JSON.stringify(next.integrations.map(({ activatedAt: _activatedAt, ...rest }) => rest));
+}
+async function recordActivatedRuntime(repoRootInput, adapters) {
+    const repoRoot = (0, v0_governance_1.resolveRepoRoot)(repoRootInput);
+    const profile = (0, v0_governance_1.ensureFreshGovernanceProfile)(repoRoot).profile;
+    const identity = (0, cli_runtime_1.collectCliRuntimeIdentity)({ bundledCliDir: (0, cli_entry_1.bundledCliDir)() });
+    const existing = (0, cli_runtime_1.readActivatedRuntimeManifest)(repoRoot);
+    const existingAdapters = existing?.integrations.map((integration) => integration.adapter) ?? [];
+    const allAdapters = Array.from(new Set([...existingAdapters, ...adapters, 'cli']));
+    const next = (0, cli_runtime_1.createActivatedRuntimeManifest)({
+        repoRoot,
+        profileHash: profile.profileHash,
+        identity,
+        integrations: integrationsForCurrentRuntime(allAdapters),
+    });
+    const changed = !sameActivation(existing, next);
+    const manifest = changed ? next : existing;
+    if (changed)
+        (0, cli_runtime_1.writeActivatedRuntimeManifest)(repoRoot, manifest);
+    writeRuntimeWiring(repoRoot, identity.entryRealPath);
+    const brain = await (0, brain_lifecycle_1.scheduleBrainIndex)(repoRoot);
+    return {
+        manifestPath: (0, cli_runtime_1.runtimeManifestPath)(repoRoot),
+        manifestHash: manifest.manifestHash,
+        changed,
+        brain,
+    };
+}
+async function repairRuntimeAuthority(repoRootInput) {
+    const repoRoot = (0, v0_governance_1.resolveRepoRoot)(repoRootInput);
+    const repaired = [];
+    const preserved = [];
+    const claudeHooks = (0, v0_governance_1.installClaudeGovernanceHooks)(repoRoot, { force: true });
+    repaired.push(...claudeHooks.repaired, ...claudeHooks.added);
+    preserved.push(...claudeHooks.preserved);
+    const claudeMcp = (0, v0_governance_1.installClaudeMcpConfig)({ force: true });
+    repaired.push(...claudeMcp.repaired, ...claudeMcp.added);
+    preserved.push(...claudeMcp.preserved);
+    const copilot = (0, v0_governance_1.installCopilotGovernanceHooks)(repoRoot, { force: true });
+    repaired.push(...copilot.repaired, ...copilot.added);
+    preserved.push(...copilot.preserved);
+    for (const target of ['codex', 'cursor', 'vscode']) {
+        const result = (0, agent_adapter_setup_1.writeAgentSetup)({ target, repoRoot });
+        if (result.status === 'written')
+            repaired.push(`${target}:${result.configPath ?? 'configuration'}`);
+        else
+            preserved.push(`${target}:${result.configPath ?? 'configuration'}`);
+    }
+    const activation = await recordActivatedRuntime(repoRoot, TARGETS.map((target) => target.adapter));
+    if (activation.changed)
+        repaired.push('runtime-manifest', 'runtime-wiring');
+    else
+        preserved.push('runtime-manifest', 'runtime-wiring');
+    return {
+        ok: true,
+        repoRoot,
+        manifestPath: activation.manifestPath,
+        manifestHash: activation.manifestHash,
+        changed: activation.changed || repaired.length > 0,
+        integrations: (0, cli_runtime_1.readActivatedRuntimeManifest)(repoRoot)?.integrations ?? [],
+        repaired: Array.from(new Set(repaired)).sort(),
+        preserved: Array.from(new Set(preserved)).sort(),
+        brain: activation.brain,
+        restartRequired: claudeHooks.restartRequired || claudeMcp.restartRequired || copilot.restartRequired,
+        nextCheck: 'neurcode runtime identity --json',
+    };
+}
+function inspectRuntimeAuthority(repoRootInput, adapter = 'cli', protectedOperation = false) {
+    const repoRoot = (0, v0_governance_1.resolveRepoRoot)(repoRootInput);
+    const profile = (0, v0_governance_1.ensureFreshGovernanceProfile)(repoRoot).profile;
+    const current = (0, cli_runtime_1.collectCliRuntimeIdentity)({ bundledCliDir: (0, cli_entry_1.bundledCliDir)() });
+    return (0, cli_runtime_1.assessRuntimeAuthority)({
+        repoRoot,
+        profileHash: profile.profileHash,
+        current,
+        adapter,
+        protectedOperation,
+        installations: (0, cli_runtime_1.discoverCliInstallations)({ repoRoot, bundledCliDir: (0, cli_entry_1.bundledCliDir)() }),
+    });
+}
+function assertProtectedRuntimeAuthority(repoRootInput, adapter) {
+    const assessment = inspectRuntimeAuthority(repoRootInput, adapter === 'neurcode-cli' ? 'cli' : adapter, true);
+    if (!assessment.protectedOperationAllowed) {
+        const detail = assessment.mismatches.map((mismatch) => `- ${mismatch.message}`).join('\n');
+        throw new Error(`Protected operation denied by runtime identity authority.\n${detail}\nRun \`${assessment.repairCommand}\`.`);
+    }
+    return assessment;
+}
+function runtimeManifestExists(repoRootInput) {
+    return (0, node_fs_1.existsSync)((0, cli_runtime_1.runtimeManifestPath)((0, v0_governance_1.resolveRepoRoot)(repoRootInput)));
+}
+function activeRuntimeEntrypoint() {
+    return (0, cli_entry_1.getActiveCliEntry)();
+}
+//# sourceMappingURL=runtime-authority.js.map

package/dist/utils/runtime-authority.js.map

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

package/dist/utils/runtime-companion.d.ts

@@ -1,6 +1,9 @@
 import { normalizeArchitectureObligationPolicy, summarizeArchitectureObligations, type AgentPlan, type AgentPlanAmendmentProposal, type ArchitectureObligation, type GovernanceSession, type SessionEvent } from '@neurcode-ai/governance-runtime';
 import { type ProfileFreshnessSignal } from './v0-governance';
 import { type RuntimeOutboxStatus } from './runtime-outbox';
+import { readBrainLifecycle } from './brain-lifecycle';
+import { inspectRuntimeAuthority } from './runtime-authority';
+import { classifyRuntimeState } from './runtime-state';
 export declare const RUNTIME_COMPANION_SCHEMA_VERSION: "neurcode.runtime-companion.v1";
 export interface RuntimeCompanionPlan {
     revision: number;
@@ -64,6 +67,27 @@ export interface RuntimeCompanionSnapshot {
         hardDenyAvailable: false;
         detail: string;
     };
+    runtimeAuthority: ReturnType<typeof inspectRuntimeAuthority>;
+    runtimeState: ReturnType<typeof classifyRuntimeState>;
+    pairing: {
+        repositoryOwnershipBound: boolean;
+        machineAuthenticated: boolean;
+        agentIntegrationActive: boolean;
+        cloudTransportConnected: boolean;
+        repoBrainReady: boolean;
+        governedSessionActive: boolean;
+        evidenceSynchronized: boolean;
+    };
+    topology: null | {
+        artifactHash: string;
+        trackedFileCount: number;
+        deterministicFacts: number;
+        advisoryFacts: number;
+        brainParticipated: boolean;
+        brainFreshness: string | null;
+        limitations: string[];
+    };
+    brain: ReturnType<typeof readBrainLifecycle>;
     profileFreshness: ProfileFreshnessSignal & {
         sessionProfileHash: string | null;
     };
@@ -73,12 +97,20 @@ export interface RuntimeCompanionSnapshot {
     session: null | {
         sessionId: string;
         status: GovernanceSession['status'];
+        completionStatus: GovernanceSession['completionStatus'] | null;
         repoName: string;
         goal: string;
         profileHash: string;
         scopeMode: GovernanceSession['contract']['scopeMode'];
         planCoherenceMode: NonNullable<GovernanceSession['contract']['planCoherenceMode']>;
         allowedGlobs: string[];
+        scopeEvidence: Array<{
+            glob: string;
+            evidenceType: string;
+            authority: 'deterministic' | 'advisory' | 'explicit';
+            confidence: string;
+            reason: string;
+        }>;
         approvalRequiredGlobs: string[];
         approvedPaths: string[];
         launcher: null | {

package/dist/utils/runtime-companion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-companion.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-companion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-companion.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-companion.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,qCAAqC,EACrC,gCAAgC,EAChC,KAAK,SAAS,EACd,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAKL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,eAAO,MAAM,gCAAgC,EAAG,+BAAwC,CAAC;AAGzF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpC,iBAAiB,EAAE,KAAK,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QAC7C,UAAU,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;QACvD,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,UAAU,CAAC,OAAO,qCAAqC,CAAC,CAAC;IACjE,OAAO,EAAE,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;IAC7D,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC7C,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;QAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;KACzD,CAAC,CAAC;IACH,aAAa,EAAE,KAAK,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACP,YAAY,EAAE,IAAI,CAAC;QACnB,cAAc,EAAE,KAAK,CAAC;QACtB,cAAc,EAAE,KAAK,CAAC;KACvB,CAAC;IACF,WAAW,EAAE;QACX,OAAO,EAAE,kBAAkB,CAAC;QAC5B,KAAK,EAAE,cAAc,CAAC;QACtB,SAAS,EAAE,KAAK,CAAC;QACjB,iBAAiB,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,gBAAgB,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAC7D,YAAY,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACtD,OAAO,EAAE;QACP,wBAAwB,EAAE,OAAO,CAAC;QAClC,oBAAoB,EAAE,OAAO,CAAC;QAC9B,sBAAsB,EAAE,OAAO,CAAC;QAChC,uBAAuB,EAAE,OAAO,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;QACxB,qBAAqB,EAAE,OAAO,CAAC;QAC/B,oBAAoB,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,QAAQ,EAAE,IAAI,GAAG;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC7C,gBAAgB,EAAE,sBAAsB,GAAG;QACzC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,SAAS,EAAE,mBAAmB,GAAG;QAC/B,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,IAAI,GAAG;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACpC,gBAAgB,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;QAC/D,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;QACtD,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACnF,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,EAAE,KAAK,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC;YACb,YAAY,EAAE,MAAM,CAAC;YACrB,SAAS,EAAE,eAAe,GAAG,UAAU,GAAG,UAAU,CAAC;YACrD,UAAU,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;QACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAChC,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,IAAI,GAAG;YACf,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,MAAM,CAAC;YAChB,gBAAgB,EAAE,MAAM,CAAC;YACzB,SAAS,EAAE,OAAO,CAAC;YACnB,QAAQ,EAAE,OAAO,CAAC;YAClB,eAAe,EAAE,MAAM,CAAC;YACxB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAC;QAClC,WAAW,EAAE,2BAA2B,CAAC;QACzC,WAAW,EAAE,IAAI,GAAG;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,qBAAqB,EAAE,MAAM,CAAC;YAC9B,iBAAiB,EAAE,OAAO,CAAC;SAC5B,CAAC;QACF,YAAY,EAAE,KAAK,CAAC;YAClB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YAC3B,EAAE,EAAE,MAAM,CAAC;YACX,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACJ,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,OAAO,gCAAgC,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED,UAAU,4BAA4B;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAwJD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,4BAAiC,GACzC,wBAAwB,CAmG1B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,6BAA6B,GACnC,8BAA8B,CAsBhC;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAIzF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAErG"}

package/dist/utils/runtime-companion.js

@@ -11,6 +11,10 @@ const v0_governance_1 = require("./v0-governance");
 const agent_session_launcher_1 = require("./agent-session-launcher");
 const runtime_outbox_1 = require("./runtime-outbox");
 const runtime_connection_1 = require("./runtime-connection");
+const brain_lifecycle_1 = require("./brain-lifecycle");
+const runtime_authority_1 = require("./runtime-authority");
+const v0_governance_2 = require("./v0-governance");
+const runtime_state_1 = require("./runtime-state");
 exports.RUNTIME_COMPANION_SCHEMA_VERSION = 'neurcode.runtime-companion.v1';
 const PROFILE_FRESHNESS_CACHE_MS = 5_000;
 const freshnessCache = new Map();
@@ -158,6 +162,31 @@ function buildRuntimeCompanionSnapshot(repoRoot, options = {}) {
     const session = (0, governance_runtime_1.loadActiveSession)(repoRoot);
     const profileFreshness = freshnessFor(repoRoot, session, options.forceFreshness === true);
     const transport = (0, runtime_outbox_1.inspectRuntimeOutbox)(repoRoot);
+    const connection = (0, runtime_connection_1.loadRuntimeConnection)(repoRoot);
+    const runtimeAuthority = (0, runtime_authority_1.inspectRuntimeAuthority)(repoRoot);
+    const runtimeState = (0, runtime_state_1.classifyRuntimeState)(repoRoot);
+    const profile = (0, v0_governance_2.readGovernanceProfile)(repoRoot).profile;
+    const topology = profile?.repositoryTopology ?? session?.contract.repositoryTopology ?? null;
+    const brain = (0, brain_lifecycle_1.readBrainLifecycle)(repoRoot);
+    const launcher = session ? shapeLauncher(session) : null;
+    const scopeEvidence = (session?.contract.allowedGlobs ?? []).map((glob) => {
+        const fact = topology?.facts.find((candidate) => candidate.glob === glob || candidate.path === glob);
+        return fact
+            ? {
+                glob,
+                evidenceType: fact.evidence.type,
+                authority: fact.evidence.authority,
+                confidence: fact.evidence.confidence,
+                reason: fact.evidence.reason,
+            }
+            : {
+                glob,
+                evidenceType: 'explicit-user-or-plan',
+                authority: 'explicit',
+                confidence: 'high',
+                reason: 'This exact path/glob came from explicit user intent or the accepted agent plan.',
+            };
+    });
     return {
         schemaVersion: exports.RUNTIME_COMPANION_SCHEMA_VERSION,
         generatedAt: new Date().toISOString(),
@@ -174,27 +203,53 @@ function buildRuntimeCompanionSnapshot(repoRoot, options = {}) {
             hardDenyAvailable: false,
             detail: 'The VS Code companion reflects CLI runtime state. Claude Code hooks provide pre-write hard deny; editor observation does not.',
         },
+        runtimeAuthority,
+        runtimeState,
+        pairing: {
+            repositoryOwnershipBound: Boolean(profile),
+            machineAuthenticated: Boolean(connection),
+            agentIntegrationActive: Boolean(launcher || runtimeAuthority.activated?.integrations.length),
+            cloudTransportConnected: Boolean(connection),
+            repoBrainReady: brain?.state === 'fresh' || brain?.state === 'partial',
+            governedSessionActive: Boolean(session),
+            evidenceSynchronized: Boolean(connection)
+                && transport.pendingEvents === 0
+                && transport.deadLetterEvents === 0
+                && transport.quarantinedEvents === 0,
+        },
+        topology: topology ? {
+            artifactHash: topology.artifactHash,
+            trackedFileCount: topology.trackedFileCount,
+            deterministicFacts: topology.facts.filter((fact) => fact.evidence.authority === 'deterministic').length,
+            advisoryFacts: topology.facts.filter((fact) => fact.evidence.authority === 'advisory').length,
+            brainParticipated: topology.brain.participated,
+            brainFreshness: topology.brain.freshness,
+            limitations: [...topology.limitations],
+        } : null,
+        brain,
         profileFreshness: {
             ...profileFreshness,
             sessionProfileHash: session?.profileHash ?? null,
         },
         transport: {
             ...transport,
-            connected: Boolean((0, runtime_connection_1.loadRuntimeConnection)(repoRoot)),
+            connected: Boolean(connection),
         },
         session: session
             ? {
                 sessionId: session.sessionId,
                 status: session.status,
+                completionStatus: session.completionStatus ?? null,
                 repoName: session.repoName,
                 goal: session.contract.goal,
                 profileHash: session.profileHash,
                 scopeMode: session.contract.scopeMode,
                 planCoherenceMode: session.contract.planCoherenceMode ?? 'warn',
                 allowedGlobs: [...session.contract.allowedGlobs],
+                scopeEvidence,
                 approvalRequiredGlobs: [...session.contract.approvalRequiredGlobs],
                 approvedPaths: (0, governance_runtime_1.activeApprovalPaths)(session.contract),
-                launcher: shapeLauncher(session),
+                launcher,
                 plan: shapePlan(session),
                 obligations: shapeObligations(session),
                 latestBlock: shapeLatestBlock(session),