@ornexus/neocortex 4.60.73 → 4.60.74

package/packages/client/dist/checkpoint/checkpoint-client-reader.js

@@ -1,127 +1,2 @@
-/**
- * Epic P109.05: Checkpoint client-side reader (fail-soft).
- *
- * Reads `.neocortex/checkpoint-pending.json` (written by agent per P109.04
- * step prompt instructions), validates shape against ImplementCheckpointSnapshot
- * (P109.02), and consumes (deletes) the file to prevent re-send.
- *
- * Cross-refs: P107.02 (architecture-policy reader pattern), P101.06 (atomic
- * file ops), P63.01 (UTF-8 BOM strip), P103.06 (CRLF normalize).
- */
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { MAX_SNAPSHOT_SIZE_BYTES } from './shared-checkpoint-types.js';
-/**
- * Canonical pending-checkpoint path (relative to projectRoot).
- * Matches P109.04 step prompt instruction literal.
- */
-export const CHECKPOINT_PENDING_PATH = '.neocortex/checkpoint-pending.json';
-/**
- * Size buffer over the server-enforced MAX_SNAPSHOT_SIZE_BYTES to account for
- * JSON structural overhead (field names, quotes, commas). Guards against
- * pathological huge files before parse attempts.
- */
-const SIZE_BUFFER_BYTES = 10000;
-const VALID_PHASES = ['FASE_1', 'FASE_2', 'FASE_3', 'FASE_4'];
-/**
- * Pure validation (zero I/O). Deterministic.
- *
- * Checks all required fields of ImplementCheckpointSnapshot shape. Extra fields
- * are ignored (forward-compat). Does NOT enforce MAX_SNAPSHOT_SIZE_BYTES on
- * snapshotMd length -- that is the reader's responsibility and server's
- * final truncation (P109.06).
- */
-export function validateSnapshot(candidate) {
-    if (candidate === null || typeof candidate !== 'object') {
-        return { valid: false, errors: ['payload must be object'] };
-    }
-    const obj = candidate;
-    const errors = [];
-    if (typeof obj.storyId !== 'string' || obj.storyId.length === 0) {
-        errors.push('storyId must be non-empty string');
-    }
-    if (typeof obj.turn !== 'number' || !Number.isFinite(obj.turn) || obj.turn < 0) {
-        errors.push('turn must be non-negative finite number');
-    }
-    if (!Array.isArray(obj.filesModified) ||
-        !obj.filesModified.every((x) => typeof x === 'string')) {
-        errors.push('filesModified must be string[]');
-    }
-    if (!Array.isArray(obj.testsModified) ||
-        !obj.testsModified.every((x) => typeof x === 'string')) {
-        errors.push('testsModified must be string[]');
-    }
-    if (typeof obj.currentPhase !== 'string' ||
-        !VALID_PHASES.includes(obj.currentPhase)) {
-        errors.push(`currentPhase must be one of ${VALID_PHASES.join('|')}`);
-    }
-    if (typeof obj.snapshotMd !== 'string') {
-        errors.push('snapshotMd must be string');
-    }
-    return { valid: errors.length === 0, errors: Object.freeze(errors) };
-}
-/**
- * Read + validate + consume (delete) the pending checkpoint file.
- *
- * Fail-soft contract:
- * - ENOENT (common case -- no checkpoint pending) -> undefined, silent.
- * - Any other read error -> undefined + console.warn.
- * - Malformed JSON or schema invalid -> undefined + console.warn.
- * - Oversized file -> undefined + console.warn.
- * - Unlink failure -> caller still receives snapshot; warn logged.
- *
- * **File consume is critical (AC4)**: after first successful read (regardless
- * of validation outcome), the file is deleted to prevent re-send on next
- * invoke. This avoids infinite checkpoint-loop scenarios from malformed
- * agent-produced content.
- */
-export async function readAndConsumeCheckpoint(projectRoot) {
-    const fullPath = path.join(projectRoot, CHECKPOINT_PENDING_PATH);
-    let raw;
-    try {
-        raw = await fs.readFile(fullPath, 'utf-8');
-    }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            // Common case: no checkpoint pending. Silent (zero warn).
-            return undefined;
-        }
-        // eslint-disable-next-line no-console
-        console.warn(`[Neocortex] checkpoint read failed: ${err instanceof Error ? err.message : String(err)}`);
-        return undefined;
-    }
-    // Consume before returning so the enclosing capability drains the physical
-    // unlink before an invocation receipt can complete.
-    try {
-        await fs.unlink(fullPath);
-    }
-    catch (unlinkErr) {
-        // eslint-disable-next-line no-console
-        console.warn(`[Neocortex] checkpoint unlink failed: ${unlinkErr instanceof Error ? unlinkErr.message : String(unlinkErr)}`);
-    }
-    // Encoding defense: BOM strip (P63.01) + CRLF normalize (P103.06).
-    const normalized = raw.replace(/^/, '').replace(/\r\n/g, '\n');
-    // Size guard (AC5): reject pathologically large files before parse.
-    if (normalized.length > MAX_SNAPSHOT_SIZE_BYTES + SIZE_BUFFER_BYTES) {
-        // eslint-disable-next-line no-console
-        console.warn(`[Neocortex] checkpoint oversized (${normalized.length} bytes), skipping`);
-        return undefined;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(normalized);
-    }
-    catch (err) {
-        // eslint-disable-next-line no-console
-        console.warn(`[Neocortex] checkpoint malformed JSON: ${err instanceof Error ? err.message : String(err)}`);
-        return undefined;
-    }
-    const validation = validateSnapshot(parsed);
-    if (!validation.valid) {
-        // eslint-disable-next-line no-console
-        console.warn(`[Neocortex] checkpoint schema invalid: ${validation.errors.join('; ')}`);
-        return undefined;
-    }
-    // Safe to cast after validation.
-    return parsed;
-}
+import{promises as a}from"node:fs";import f from"node:path";import{MAX_SNAPSHOT_SIZE_BYTES as u}from"./shared-checkpoint-types.js";const d=".neocortex/checkpoint-pending.json",p=1e4,c=["FASE_1","FASE_2","FASE_3","FASE_4"];function l(o){if(o===null||typeof o!="object")return{valid:!1,errors:["payload must be object"]};const e=o,n=[];return(typeof e.storyId!="string"||e.storyId.length===0)&&n.push("storyId must be non-empty string"),(typeof e.turn!="number"||!Number.isFinite(e.turn)||e.turn<0)&&n.push("turn must be non-negative finite number"),(!Array.isArray(e.filesModified)||!e.filesModified.every(t=>typeof t=="string"))&&n.push("filesModified must be string[]"),(!Array.isArray(e.testsModified)||!e.testsModified.every(t=>typeof t=="string"))&&n.push("testsModified must be string[]"),(typeof e.currentPhase!="string"||!c.includes(e.currentPhase))&&n.push(`currentPhase must be one of ${c.join("|")}`),typeof e.snapshotMd!="string"&&n.push("snapshotMd must be string"),{valid:n.length===0,errors:Object.freeze(n)}}async function y(o){const e=f.join(o,d);let n;try{n=await a.readFile(e,"utf-8")}catch(r){if(r.code==="ENOENT")return;console.warn(`[Neocortex] checkpoint read failed: ${r instanceof Error?r.message:String(r)}`);return}try{await a.unlink(e)}catch(r){console.warn(`[Neocortex] checkpoint unlink failed: ${r instanceof Error?r.message:String(r)}`)}const t=n.replace(/^/,"").replace(/\r\n/g,`
+`);if(t.length>u+p){console.warn(`[Neocortex] checkpoint oversized (${t.length} bytes), skipping`);return}let i;try{i=JSON.parse(t)}catch(r){console.warn(`[Neocortex] checkpoint malformed JSON: ${r instanceof Error?r.message:String(r)}`);return}const s=l(i);if(!s.valid){console.warn(`[Neocortex] checkpoint schema invalid: ${s.errors.join("; ")}`);return}return i}export{d as CHECKPOINT_PENDING_PATH,y as readAndConsumeCheckpoint,l as validateSnapshot};

package/packages/client/dist/checkpoint/index.js

@@ -1,11 +1 @@
-/**
- * Epic P109.05: Checkpoint client-side module barrel.
- *
- * Exports the fail-soft reader + validator + canonical path const.
- * Re-exports wire-format types from local SSoT-Shadow inline (P117.01) so
- * the published client tarball never references `@neocortex/shared` at
- * runtime. Type identity stays in sync with `@neocortex/shared` via
- * `checkpoint-shared-sync.test.ts` drift test.
- */
-export * from './checkpoint-client-reader.js';
-export { MAX_SNAPSHOT_SIZE_BYTES } from './shared-checkpoint-types.js';
+export*from"./checkpoint-client-reader.js";import{MAX_SNAPSHOT_SIZE_BYTES as _}from"./shared-checkpoint-types.js";export{_ as MAX_SNAPSHOT_SIZE_BYTES};

package/packages/client/dist/checkpoint/shared-checkpoint-types.js

@@ -1,32 +1 @@
-/**
- * P117.01: Inlined byte-identical types from `@neocortex/shared/checkpoints`.
- *
- * SSoT-Shadow pattern (P92.01 server precedent — server `shared-types.ts` does
- * the same for tier-config). Client tarball is published standalone via
- * `@ornexus/neocortex` and does NOT include `@neocortex/shared` as a runtime
- * dependency (workspace package, excluded from tarball per `.npmignore` +
- * `tsconfig.build.json`). Any non-erased import of `@neocortex/shared` in
- * `packages/client/dist/**` causes runtime `ERR_MODULE_NOT_FOUND` on globally
- * installed `@ornexus/neocortex`.
- *
- * Live regression reproduced 2026-04-25 (Epic P117 origin):
- *   `[Neocortex] checkpoint hook failed: Cannot find package '@neocortex/shared'
- *    imported from .../checkpoint/checkpoint-client-reader.js. Proceeding without
- *    checkpoint.`
- *
- * Sync responsibility: `shared-types-sync.test.ts` (P117.01 describe block) +
- * `checkpoint-shared-sync.test.ts` (client-side drift test). Drift test fails
- * CI if these diverge from SSoT.
- *
- * Defense-in-depth: `validate-pre-publish.js` ships
- * `validateClientNoSharedImport()` (P117.01) scanning client dist for
- * `@neocortex/shared` runtime references — match = exit 1 (publish blocked).
- *
- * DO NOT EDIT WITHOUT also editing `packages/shared/src/checkpoints/types.ts`.
- */
-/**
- * Snapshot size guard: prevents PG bloat from pathological code-paste scenarios.
- * Truncate snapshot_md at this byte count (P109.06 enforces).
- */
-export const MAX_SNAPSHOT_SIZE_BYTES = 50000;
-// === END P117.01 ===
+const S=5e4;export{S as MAX_SNAPSHOT_SIZE_BYTES};

package/packages/client/dist/cli.js

@@ -1,37 +1,5 @@
 #!/usr/bin/env node
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-/**
- * @neocortex/client - CLI Entry Point
- *
- * Routes subcommands to their respective handlers:
- *   neocortex-client invoke  --args "..."
- *   neocortex-client activate YOUR-LICENSE-KEY
- *   neocortex-client config status
- *   neocortex-client cache-status
- *   neocortex-client doctor [--offline] [--json]
- *   neocortex-client --help
- *   neocortex-client --version
- *
- * Story 46.2 - AC1-AC7
- */
-import { getClientVersion } from './version.js';
-import { spawnSync } from 'node:child_process';
-import { COMMAND_REGISTRY_CHECKSUM, COMMAND_REGISTRY_VERSION, } from './generated/command-registry.generated.js';
-import { readProjectRegistryIdentity, reconcileRegistry, RegistryReconciliationError, REGISTRY_RECONCILIATION_REASON_CODES, } from './registry/registry-reconciliation.js';
-// ── Version Resolution ─────────────────────────────────────────────────────
-// ── Help Text ──────────────────────────────────────────────────────────────
-const HELP_TEXT = `
+import{getClientVersion as l}from"./version.js";import{spawnSync as v}from"node:child_process";import{COMMAND_REGISTRY_CHECKSUM as p,COMMAND_REGISTRY_VERSION as d}from"./generated/command-registry.generated.js";import{readProjectRegistryIdentity as j,reconcileRegistry as m,RegistryReconciliationError as u,REGISTRY_RECONCILIATION_REASON_CODES as h}from"./registry/registry-reconciliation.js";const f=`
 neocortex-client - Neocortex Client CLI
 
 Usage:
@@ -251,328 +219,7 @@ Invocation payload boundary:
 
 License:
   Licensed under BSL-1.1 (Business Source License 1.1)
-`.trim();
-// ── Main ───────────────────────────────────────────────────────────────────
-// ── npm Lifecycle Guard ──────────────────────────────────────────────────
-// Epic 67 - Story 67.2: On Windows, npm lifecycle can invoke bin entries
-// with stray arguments like "pm", "install", "postinstall" etc.
-// Silently ignore these to avoid "Unknown command" warnings during npm install.
-const NPM_LIFECYCLE_ARGS = new Set([
-    'pm', 'install', 'postinstall', 'preinstall', 'prepublish',
-    'postpublish', 'preuninstall', 'postuninstall', 'preprepare',
-    'prepare', 'postprepare',
-]);
-function optionValue(args, name) {
-    const index = args.indexOf(name);
-    return index >= 0 ? args[index + 1] : undefined;
-}
-function printRegistryReconciliationError(error) {
-    if (error instanceof RegistryReconciliationError) {
-        process.stderr.write(`[Neocortex] ${error.reasonCode}: ${error.remediation}\n`);
-        return;
-    }
-    process.stderr.write(`[Neocortex] ${REGISTRY_RECONCILIATION_REASON_CODES.ARTIFACT_UNAVAILABLE}: registry reconciliation could not be completed safely; no invoke request was sent.\n`);
-}
-function installedRegistryIdentity() {
-    return { version: COMMAND_REGISTRY_VERSION, checksum: COMMAND_REGISTRY_CHECKSUM };
-}
-function projectMatchesInstalled(projectRoot) {
-    const project = readProjectRegistryIdentity(projectRoot);
-    return !project || (project.version === COMMAND_REGISTRY_VERSION && project.checksum === COMMAND_REGISTRY_CHECKSUM);
-}
-function runReconciledInvoke(cliArgs, subArgs) {
-    const projectRoot = optionValue(subArgs, '--project-root') || process.cwd();
-    try {
-        if (process.env.NEOCORTEX_REGISTRY_REEXECUTED === '1' && !projectMatchesInstalled(projectRoot)) {
-            throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.ARTIFACT_MISMATCH, 'The reinstalled client still does not match the trusted local projection; no invoke request was sent.');
-        }
-        const result = reconcileRegistry({
-            projectRoot,
-            installedVersion: getClientVersion(),
-            installedIdentity: installedRegistryIdentity(),
-        });
-        if (result.status !== 'updated')
-            return undefined;
-        const child = spawnSync(process.execPath, [process.argv[1], ...cliArgs], {
-            stdio: 'inherit',
-            env: { ...process.env, NEOCORTEX_REGISTRY_REEXECUTED: '1' },
-            shell: false,
-        });
-        return child.error ? 1 : child.status ?? 1;
-    }
-    catch (error) {
-        printRegistryReconciliationError(error);
-        return 1;
-    }
-}
-async function main() {
-    const args = process.argv.slice(2);
-    const command = args[0];
-    // Silently exit if invoked with npm lifecycle arguments (Epic 67 - Story 67.2)
-    if (command && NPM_LIFECYCLE_ARGS.has(command.toLowerCase())) {
-        process.exit(0);
-    }
-    if (!command || command === '--help' || command === '-h') {
-        console.log(HELP_TEXT);
-        process.exit(0);
-    }
-    if (command === '--version' || command === '-v') {
-        // Epic P72 - Story P72.04: include BSL-1.1 license notice in --version output.
-        // Printed to stderr so scripts that parse `neocortex-client --version` continue
-        // to work correctly (they consume stdout only).
-        console.log(getClientVersion());
-        process.stderr.write('Licensed under BSL-1.1 (Business Source License 1.1)\n');
-        process.exit(0);
-    }
-    const subArgs = args.slice(1);
-    switch (command) {
-        case 'invoke': {
-            const reconciledExitCode = runReconciledInvoke(args, subArgs);
-            if (reconciledExitCode !== undefined) {
-                process.exitCode = reconciledExitCode;
-                break;
-            }
-            const { invokeCliHandler, flushInvokeCliOutput } = await import('./commands/invoke.js');
-            const exitCode = await invokeCliHandler(subArgs);
-            const outputComplete = await flushInvokeCliOutput();
-            // Let pending stdout/stderr writes and HTTP handles finish closing.
-            // A forced exit can race libuv's async-handle teardown on Windows.
-            process.exitCode = outputComplete ? exitCode : 1;
-            break;
-        }
-        case 'reconcile-registry': {
-            const projectRoot = optionValue(subArgs, '--project-root') || process.cwd();
-            try {
-                reconcileRegistry({
-                    projectRoot,
-                    installedVersion: getClientVersion(),
-                    installedIdentity: installedRegistryIdentity(),
-                    checkLatest: subArgs.includes('--check-latest'),
-                });
-                process.exitCode = 0;
-            }
-            catch (error) {
-                printRegistryReconciliationError(error);
-                process.exitCode = 1;
-            }
-            break;
-        }
-        case 'activate': {
-            const { activate } = await import('./commands/activate.js');
-            // Parse activate args
-            let licenseKey;
-            let serverUrl;
-            let nonInteractive = false;
-            for (let i = 0; i < subArgs.length; i++) {
-                const arg = subArgs[i];
-                if (arg === '--server-url') {
-                    serverUrl = subArgs[++i];
-                }
-                else if (arg === '--non-interactive') {
-                    nonInteractive = true;
-                }
-                else if (arg === '--help' || arg === '-h') {
-                    console.log(HELP_TEXT);
-                    process.exit(0);
-                }
-                else if (!arg.startsWith('-')) {
-                    licenseKey = arg;
-                }
-            }
-            if (!licenseKey) {
-                console.error('Error: License key is required.');
-                console.error('Usage: neocortex-client activate <license-key>');
-                console.error('Example: neocortex-client activate NX-PRO-ABC-123');
-                process.exit(1);
-            }
-            try {
-                const result = await activate({
-                    licenseKey,
-                    serverUrl,
-                    nonInteractive,
-                });
-                if (result.success) {
-                    console.log(result.message);
-                    process.exit(0);
-                }
-                else {
-                    console.error(result.message);
-                    process.exit(1);
-                }
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : String(err);
-                console.error(`Activation failed: ${message}`);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'cache-status': {
-            // cache-status requires initialized circuit breaker and telemetry queue.
-            // For CLI use, we provide a simplified status report.
-            console.log('Cache status requires an active client session.');
-            console.log('Use this command within a running Neocortex client context.');
-            process.exit(0);
-            break;
-        }
-        case 'doctor': {
-            const { doctorCliHandler } = await import('./commands/doctor.js');
-            const exitCode = await doctorCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'config': {
-            const { configCliHandler } = await import('./commands/config.js');
-            const exitCode = await configCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'refresh-memory': {
-            const { refreshMemoryCliHandler } = await import('./commands/refresh-memory.js');
-            const exitCode = await refreshMemoryCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'architecture-memory': {
-            const { architectureMemoryTerminalCliHandler } = await import('./commands/architecture-memory-terminal.js');
-            const exitCode = await architectureMemoryTerminalCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'planning-diagnosis': {
-            const { planningDiagnosisCliHandler } = await import('./commands/planning-diagnosis.js');
-            const exitCode = await planningDiagnosisCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'planning-research': {
-            const { planningResearchCliHandler } = await import('./commands/planning-research.js');
-            const exitCode = await planningResearchCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'private-session': {
-            const { privateSessionCliHandler } = await import('./commands/private-session.js');
-            const exitCode = await privateSessionCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'planning-memory': {
-            const { planningMemoryCliHandler } = await import('./commands/planning-memory.js');
-            const exitCode = await planningMemoryCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'planning-generation': {
-            const { planningGenerationCliHandler } = await import('./commands/planning-generation.js');
-            const exitCode = await planningGenerationCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'story-checkpoint': {
-            const { storyCheckpointCliHandler } = await import('./commands/story-checkpoint.js');
-            const exitCode = await storyCheckpointCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'legacy-story-branch': {
-            const { legacyStoryBranchCliHandler } = await import('./commands/legacy-story-branch.js');
-            const exitCode = await legacyStoryBranchCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'legacy-story-pr': {
-            const { legacyStoryPrCliHandler } = await import('./commands/legacy-story-pr.js');
-            const exitCode = await legacyStoryPrCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'legacy-epic-terminal': {
-            const { legacyEpicTerminalCliHandler } = await import('./commands/legacy-epic-terminal.js');
-            const exitCode = await legacyEpicTerminalCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'mutation-qa': {
-            const { mutationQaCliHandler } = await import('./commands/mutation-qa.js');
-            const exitCode = await mutationQaCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'property-qa': {
-            const { propertyQaCliHandler } = await import('./commands/property-qa.js');
-            const exitCode = await propertyQaCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'qa-synthetic-backend': {
-            const { syntheticBackendCliHandler } = await import('./commands/qa-synthetic-backend.js');
-            process.exitCode = await syntheticBackendCliHandler(args.slice(1));
-            break;
-        }
-        case 'qa-scan-review': {
-            const { qaScanReviewCliHandler } = await import('./commands/qa-scan-review.js');
-            const exitCode = await qaScanReviewCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'qa-root': {
-            const { qaControlCliHandler } = await import('./commands/qa-control.js');
-            process.exit(await qaControlCliHandler(subArgs));
-            break;
-        }
-        case 'refactor-root': {
-            if (subArgs[0] === 'control') {
-                const { refactorControlCliHandler } = await import('./commands/refactor-control.js');
-                process.exit(await refactorControlCliHandler(subArgs));
-            }
-            if (subArgs[0] === 'characterize') {
-                const { refactorCharacterizationCliHandler } = await import('./commands/refactor-characterization.js');
-                process.exit(refactorCharacterizationCliHandler(subArgs));
-            }
-            if (subArgs[0] === 'review-accept' || subArgs[0] === 'review-status') {
-                const { refactorReviewCliHandler } = await import('./commands/refactor-review.js');
-                process.exit(await refactorReviewCliHandler(subArgs));
-            }
-            if (subArgs[0]?.startsWith('commit-')) {
-                const { refactorCommitCliHandler } = await import('./commands/refactor-commit.js');
-                process.exit(refactorCommitCliHandler(subArgs));
-            }
-            const { refactorRootCliHandler } = await import('./commands/refactor-root.js');
-            const exitCode = refactorRootCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'native-agent': {
-            const { nativeAgentCliHandler } = await import('./commands/native-agent.js');
-            const exitCode = await nativeAgentCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'architecture-answers': {
-            const { architectureAnswersCliHandler } = await import('./commands/architecture-answers.js');
-            const exitCode = await architectureAnswersCliHandler(subArgs);
-            process.exit(exitCode);
-            break;
-        }
-        case 'update': {
-            // P86.08: Redirect to `neocortex update` which handles npm install -g
-            console.log('To update Neocortex, run:');
-            console.log('  neocortex update');
-            console.log('');
-            console.log('Or manually:');
-            console.log('  npm install -g @ornexus/neocortex@latest');
-            process.exit(0);
-            break;
-        }
-        default: {
-            console.error(`Unknown command: ${command}`);
-            console.error('Run "neocortex-client --help" for usage information.');
-            process.exit(1);
-        }
-    }
-}
-main().catch((err) => {
-    console.error(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
-});
+`.trim(),w=new Set(["pm","install","postinstall","preinstall","prepublish","postpublish","preuninstall","postuninstall","preprepare","prepare","postprepare"]);function y(r,a){const o=r.indexOf(a);return o>=0?r[o+1]:void 0}function g(r){if(r instanceof u){process.stderr.write(`[Neocortex] ${r.reasonCode}: ${r.remediation}
+`);return}process.stderr.write(`[Neocortex] ${h.ARTIFACT_UNAVAILABLE}: registry reconciliation could not be completed safely; no invoke request was sent.
+`)}function x(){return{version:d,checksum:p}}function b(r){const a=j(r);return!a||a.version===d&&a.checksum===p}function k(r,a){const o=y(a,"--project-root")||process.cwd();try{if(process.env.NEOCORTEX_REGISTRY_REEXECUTED==="1"&&!b(o))throw new u(h.ARTIFACT_MISMATCH,"The reinstalled client still does not match the trusted local projection; no invoke request was sent.");if(m({projectRoot:o,installedVersion:l(),installedIdentity:x()}).status!=="updated")return;const t=v(process.execPath,[process.argv[1],...r],{stdio:"inherit",env:{...process.env,NEOCORTEX_REGISTRY_REEXECUTED:"1"},shell:!1});return t.error?1:t.status??1}catch(e){return g(e),1}}async function C(){const r=process.argv.slice(2),a=r[0];a&&w.has(a.toLowerCase())&&process.exit(0),(!a||a==="--help"||a==="-h")&&(console.log(f),process.exit(0)),(a==="--version"||a==="-v")&&(console.log(l()),process.stderr.write(`Licensed under BSL-1.1 (Business Source License 1.1)
+`),process.exit(0));const o=r.slice(1);switch(a){case"invoke":{const e=k(r,o);if(e!==void 0){process.exitCode=e;break}const{invokeCliHandler:t,flushInvokeCliOutput:c}=await import("./commands/invoke.js"),s=await t(o),n=await c();process.exitCode=n?s:1;break}case"reconcile-registry":{const e=y(o,"--project-root")||process.cwd();try{m({projectRoot:e,installedVersion:l(),installedIdentity:x(),checkLatest:o.includes("--check-latest")}),process.exitCode=0}catch(t){g(t),process.exitCode=1}break}case"activate":{const{activate:e}=await import("./commands/activate.js");let t,c,s=!1;for(let n=0;n<o.length;n++){const i=o[n];i==="--server-url"?c=o[++n]:i==="--non-interactive"?s=!0:i==="--help"||i==="-h"?(console.log(f),process.exit(0)):i.startsWith("-")||(t=i)}t||(console.error("Error: License key is required."),console.error("Usage: neocortex-client activate <license-key>"),console.error("Example: neocortex-client activate NX-PRO-ABC-123"),process.exit(1));try{const n=await e({licenseKey:t,serverUrl:c,nonInteractive:s});n.success?(console.log(n.message),process.exit(0)):(console.error(n.message),process.exit(1))}catch(n){const i=n instanceof Error?n.message:String(n);console.error(`Activation failed: ${i}`),process.exit(1)}break}case"cache-status":{console.log("Cache status requires an active client session."),console.log("Use this command within a running Neocortex client context."),process.exit(0);break}case"doctor":{const{doctorCliHandler:e}=await import("./commands/doctor.js"),t=await e(o);process.exit(t);break}case"config":{const{configCliHandler:e}=await import("./commands/config.js"),t=await e(o);process.exit(t);break}case"refresh-memory":{const{refreshMemoryCliHandler:e}=await import("./commands/refresh-memory.js"),t=await e(o);process.exit(t);break}case"architecture-memory":{const{architectureMemoryTerminalCliHandler:e}=await import("./commands/architecture-memory-terminal.js"),t=await e(o);process.exit(t);break}case"planning-diagnosis":{const{planningDiagnosisCliHandler:e}=await import("./commands/planning-diagnosis.js"),t=await e(o);process.exit(t);break}case"planning-research":{const{planningResearchCliHandler:e}=await import("./commands/planning-research.js"),t=await e(o);process.exit(t);break}case"private-session":{const{privateSessionCliHandler:e}=await import("./commands/private-session.js"),t=await e(o);process.exit(t);break}case"planning-memory":{const{planningMemoryCliHandler:e}=await import("./commands/planning-memory.js"),t=await e(o);process.exit(t);break}case"planning-generation":{const{planningGenerationCliHandler:e}=await import("./commands/planning-generation.js"),t=await e(o);process.exit(t);break}case"story-checkpoint":{const{storyCheckpointCliHandler:e}=await import("./commands/story-checkpoint.js"),t=await e(o);process.exit(t);break}case"legacy-story-branch":{const{legacyStoryBranchCliHandler:e}=await import("./commands/legacy-story-branch.js"),t=await e(o);process.exit(t);break}case"legacy-story-pr":{const{legacyStoryPrCliHandler:e}=await import("./commands/legacy-story-pr.js"),t=await e(o);process.exit(t);break}case"legacy-epic-terminal":{const{legacyEpicTerminalCliHandler:e}=await import("./commands/legacy-epic-terminal.js"),t=await e(o);process.exit(t);break}case"mutation-qa":{const{mutationQaCliHandler:e}=await import("./commands/mutation-qa.js"),t=await e(o);process.exit(t);break}case"property-qa":{const{propertyQaCliHandler:e}=await import("./commands/property-qa.js"),t=await e(o);process.exit(t);break}case"qa-synthetic-backend":{const{syntheticBackendCliHandler:e}=await import("./commands/qa-synthetic-backend.js");process.exitCode=await e(r.slice(1));break}case"qa-scan-review":{const{qaScanReviewCliHandler:e}=await import("./commands/qa-scan-review.js"),t=await e(o);process.exit(t);break}case"qa-root":{const{qaControlCliHandler:e}=await import("./commands/qa-control.js");process.exit(await e(o));break}case"refactor-root":{if(o[0]==="control"){const{refactorControlCliHandler:c}=await import("./commands/refactor-control.js");process.exit(await c(o))}if(o[0]==="characterize"){const{refactorCharacterizationCliHandler:c}=await import("./commands/refactor-characterization.js");process.exit(c(o))}if(o[0]==="review-accept"||o[0]==="review-status"){const{refactorReviewCliHandler:c}=await import("./commands/refactor-review.js");process.exit(await c(o))}if(o[0]?.startsWith("commit-")){const{refactorCommitCliHandler:c}=await import("./commands/refactor-commit.js");process.exit(c(o))}const{refactorRootCliHandler:e}=await import("./commands/refactor-root.js"),t=e(o);process.exit(t);break}case"native-agent":{const{nativeAgentCliHandler:e}=await import("./commands/native-agent.js"),t=await e(o);process.exit(t);break}case"architecture-answers":{const{architectureAnswersCliHandler:e}=await import("./commands/architecture-answers.js"),t=await e(o);process.exit(t);break}case"update":{console.log("To update Neocortex, run:"),console.log("  neocortex update"),console.log(""),console.log("Or manually:"),console.log("  npm install -g @ornexus/neocortex@latest"),process.exit(0);break}default:console.error(`Unknown command: ${a}`),console.error('Run "neocortex-client --help" for usage information.'),process.exit(1)}}C().catch(r=>{console.error(`Fatal error: ${r instanceof Error?r.message:String(r)}`),process.exit(1)});