@ornexus/neocortex 4.60.61 → 4.60.63

package/packages/client/dist/cli.js

@@ -16,6 +16,11 @@ Commands:
   story-checkpoint Root-owned direct-*yolo commit/checkpoint boundary
   legacy-story-branch Root-owned setup and C01 checkpoint for recorded story-branch projects
   legacy-story-pr     Root-owned legacy C08/C09 checkpoint, C10 PR, C11 review and C12 merge boundary
+  legacy-epic-terminal  Physical C12 preflight and root QA acceptance; never releases quota
+  mutation-qa   Root-owned mutation-test scope, Stryker checkpoint and local QA decision
+  property-qa   Local-only property-test preflight, sandbox proof and root semantic QA review
+  qa-scan-review  Root-only loopback browser capture, physical QA review and multi-surface reconciliation
+  refactor-root  Root-only scope, Node characterization, semantic QA and Git checkpoint
   native-agent   Reserve and observe authorized native child dispatches
   architecture-answers  Save explicit Pact decisions in the local private store
   config         Inspect or change managed subagent approval mode
@@ -107,15 +112,60 @@ Examples:
   neocortex-client legacy-story-pr plan --story P174.03.913359 --project-root . --format json
   neocortex-client legacy-story-pr create --story P174.03.913359 --project-root . --body-file /tmp/reviewed-pr-body.md --authorize-pr-create --format json
   neocortex-client legacy-story-pr review-plan --story P174.03.913359 --pr-number 41 --project-root . --format json
+  neocortex-client legacy-story-pr review-observe --story P174.03.913359 --pr-number 41 --project-root . --format json
   neocortex-client legacy-story-pr review-accept --story P174.03.913359 --pr-number 41 --project-root . --report-file /tmp/review-report.json --authorize-review --format json
   neocortex-client legacy-story-pr merge-plan --story P174.03.913359 --pr-number 41 --project-root . --format json
+  neocortex-client legacy-story-pr merge-debt-plan --story P174.03.913359 --pr-number 41 --project-root . --format json
   neocortex-client legacy-story-pr merge-prepare --story P174.03.913359 --pr-number 41 --authorize-pr-update --project-root . --format json
+  neocortex-client legacy-story-pr merge-prepare --story P174.03.913359 --pr-number 41 --authorize-pr-update --record-remote-debt --project-root . --format json
   neocortex-client legacy-story-pr merge-decision --story P174.03.913359 --pr-number 41 --project-root . --format json
   neocortex-client legacy-story-pr merge-debt-record --story P174.03.913359 --pr-number 41 --project-root . --format json
   neocortex-client legacy-story-pr merge-execute --story P174.03.913359 --pr-number 41 --authorize-merge --project-root . --format json
   neocortex-client legacy-story-pr merge-reconcile --story P174.03.913359 --pr-number 41 --project-root . --format json
   neocortex-client legacy-story-pr post-merge-plan --story P174.03.913359 --pr-number 41 --project-root . --format json
   neocortex-client legacy-story-pr post-merge-accept --story P174.03.913359 --pr-number 41 --authorize-post-merge --project-root . --format json
+  neocortex-client legacy-epic-terminal plan --epic P174 --project-root . --format json
+  neocortex-client legacy-epic-terminal accept --epic P174 --authorize-root-qa --project-root . --format json
+  neocortex-client legacy-epic-terminal status --epic P174 --project-root . --format json
+  neocortex-client mutation-qa plan --project-root . --base-ref refs/remotes/origin/main --format json
+  neocortex-client mutation-qa execute --project-root . --base-ref refs/remotes/origin/main --plan-sha <PLAN_SHA256> --authorize-run --format json
+  neocortex-client mutation-qa run --project-root . --base-ref refs/remotes/origin/main --plan-sha <PLAN_SHA256> --authorize-run --record-checkpoint --format json
+  neocortex-client mutation-qa checkpoint --project-root . --base-ref refs/remotes/origin/main --plan-sha <PLAN_SHA256> --format json
+  neocortex-client mutation-qa gate --project-root . --base-ref refs/remotes/origin/main --plan-sha <PLAN_SHA256> --format json
+  # For a root-committed private snapshot, use --base-sha <EXACT_ANCESTOR_SHA> instead of --base-ref.
+  # mutation-qa gate exits 0 only for passed or not-applicable; all other decisions exit 1.
+  # execute exits 0 for passed/not-applicable, 2 for debt-backed continuation without QA pass, 1 for blocked/invalid.
+  neocortex-client property-qa inspect --project-root . --format json
+  neocortex-client property-qa confirm --project-root . --format json < choices.json
+  neocortex-client property-qa candidate --project-root . --format json
+  neocortex-client property-qa verify --project-root . --authorize-run --format json
+  neocortex-client property-qa review-plan --project-root . --format json
+  neocortex-client property-qa review-accept --project-root . --authorize-review --format json < /owner-only/path/root-review.json
+  neocortex-client property-qa review-status --project-root . --format json
+  neocortex-client qa-scan-review plan --project-root . --surface portal --target-url http://127.0.0.1:3000 --format json
+  neocortex-client qa-scan-review capture --project-root . --surface portal --target-url http://127.0.0.1:3000 --authorize-capture --format json
+  neocortex-client qa-scan-review interact --project-root . --surface portal --target-url http://127.0.0.1:3000 --action-id button-updates-status --expected-status done --authorize-interaction --format json
+  neocortex-client qa-scan-review accept --project-root . --surface portal --target-url http://127.0.0.1:3000 --authorize-review --format json < /owner-only/path/root-qa-report.json
+  neocortex-client qa-scan-review status --project-root . --surface portal --target-url http://127.0.0.1:3000 --format json
+  neocortex-client qa-scan-review discover --project-root . --target-url http://127.0.0.1:3000 --authorize-discovery --format json
+  neocortex-client qa-scan-review discovery-status --project-root . --discovery-sha <DISCOVERY_SHA256> --format json
+  neocortex-client qa-scan-review aggregate --project-root . --format json < /owner-only/path/surface-targets.json
+  neocortex-client qa-scan-review discovered-phase-checkpoint --project-root . --discovery-sha <DISCOVERY_SHA256> --authorize-root-checkpoint --format json < /owner-only/path/surface-targets.json
+  neocortex-client qa-scan-review discovered-phase-status --project-root . --discovery-sha <DISCOVERY_SHA256> --format json < /owner-only/path/surface-targets.json
+  neocortex-client refactor-root plan --project-root . --story P222.26 --format json
+  neocortex-client refactor-root admit --project-root . --story P222.26 --plan-sha <PLAN_SHA256> --path src/example.ts --authorize-root-edit --format json
+  neocortex-client refactor-root admit --project-root . --story P222.26 --plan-sha <PLAN_SHA256> --path src/example.ts --new-path src/example.test.ts --authorize-root-edit --format json
+  neocortex-client refactor-root verify --project-root . --admission-sha <ADMISSION_SHA256> --format json
+  neocortex-client refactor-root characterize --project-root . --admission-sha <ADMISSION_SHA256> --phase baseline --test-path src/example.test.mjs --causal-path src/example.mjs --authorize-run --format json
+  neocortex-client refactor-root characterize --project-root . --admission-sha <ADMISSION_SHA256> --phase after --baseline-sha <BASELINE_SHA256> --test-path src/example.test.mjs --causal-path src/example.mjs --authorize-run --format json
+  neocortex-client refactor-root characterize --project-root . --admission-sha <ADMISSION_SHA256> --phase baseline --runner vitest --test-path src/example.test.ts --causal-path src/example.ts --dependency package.json --dependency package-lock.json --authorize-run --format json
+  neocortex-client refactor-root review-accept --project-root . --admission-sha <ADMISSION_SHA256> --baseline-sha <BASELINE_SHA256> --authorize-run --authorize-root-review --format json < private-review.json
+  neocortex-client refactor-root review-status --project-root . --admission-sha <ADMISSION_SHA256> --baseline-sha <BASELINE_SHA256> --authorize-run --format json
+  neocortex-client refactor-root commit-plan --project-root . --admission-sha <ADMISSION_SHA256> --baseline-sha <BASELINE_SHA256> --authorize-run --authorize-root-commit-plan --format json
+  neocortex-client refactor-root commit-staged --project-root . --plan-sha <PLAN_SHA256> --format json
+  neocortex-client refactor-root commit-seal --project-root . --plan-sha <PLAN_SHA256> --authorize-root-seal --format json
+  neocortex-client refactor-root commit-status --project-root . --plan-sha <PLAN_SHA256> --format json
+  # Keep the review report outside the project in an owner-only file; review-accept reruns causal QA.
   neocortex-client architecture-answers save --project-root .  # JSON via stdin; never pass private URLs in argv
 
 Command-level watch inside --args:
@@ -146,5 +196,5 @@ Invocation payload boundary:
 
 License:
   Licensed under BSL-1.1 (Business Source License 1.1)
-`.trim(),d=new Set(["pm","install","postinstall","preinstall","prepublish","postpublish","preuninstall","postuninstall","preprepare","prepare","postprepare"]);async function m(){const s=process.argv.slice(2),a=s[0];a&&d.has(a.toLowerCase())&&process.exit(0),(!a||a==="--help"||a==="-h")&&(console.log(l),process.exit(0)),(a==="--version"||a==="-v")&&(console.log(p()),process.stderr.write(`Licensed under BSL-1.1 (Business Source License 1.1)
-`),process.exit(0));const o=s.slice(1);switch(a){case"invoke":{const{invokeCliHandler:t}=await import("./commands/invoke.js"),e=await t(o);process.exit(e);break}case"activate":{const{activate:t}=await import("./commands/activate.js");let e,i,c=!1;for(let r=0;r<o.length;r++){const n=o[r];n==="--server-url"?i=o[++r]:n==="--non-interactive"?c=!0:n==="--help"||n==="-h"?(console.log(l),process.exit(0)):n.startsWith("-")||(e=n)}e||(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 r=await t({licenseKey:e,serverUrl:i,nonInteractive:c});r.success?(console.log(r.message),process.exit(0)):(console.error(r.message),process.exit(1))}catch(r){const n=r instanceof Error?r.message:String(r);console.error(`Activation failed: ${n}`),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"config":{const{configCliHandler:t}=await import("./commands/config.js"),e=await t(o);process.exit(e);break}case"refresh-memory":{const{refreshMemoryCliHandler:t}=await import("./commands/refresh-memory.js"),e=await t(o);process.exit(e);break}case"architecture-memory":{const{architectureMemoryTerminalCliHandler:t}=await import("./commands/architecture-memory-terminal.js"),e=await t(o);process.exit(e);break}case"planning-diagnosis":{const{planningDiagnosisCliHandler:t}=await import("./commands/planning-diagnosis.js"),e=await t(o);process.exit(e);break}case"planning-research":{const{planningResearchCliHandler:t}=await import("./commands/planning-research.js"),e=await t(o);process.exit(e);break}case"planning-generation":{const{planningGenerationCliHandler:t}=await import("./commands/planning-generation.js"),e=await t(o);process.exit(e);break}case"story-checkpoint":{const{storyCheckpointCliHandler:t}=await import("./commands/story-checkpoint.js"),e=await t(o);process.exit(e);break}case"legacy-story-branch":{const{legacyStoryBranchCliHandler:t}=await import("./commands/legacy-story-branch.js"),e=await t(o);process.exit(e);break}case"legacy-story-pr":{const{legacyStoryPrCliHandler:t}=await import("./commands/legacy-story-pr.js"),e=await t(o);process.exit(e);break}case"native-agent":{const{nativeAgentCliHandler:t}=await import("./commands/native-agent.js"),e=await t(o);process.exit(e);break}case"architecture-answers":{const{architectureAnswersCliHandler:t}=await import("./commands/architecture-answers.js"),e=await t(o);process.exit(e);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)}}m().catch(s=>{console.error(`Fatal error: ${s instanceof Error?s.message:String(s)}`),process.exit(1)});
+`.trim(),m=new Set(["pm","install","postinstall","preinstall","prepublish","postpublish","preuninstall","postuninstall","preprepare","prepare","postprepare"]);async function d(){const c=process.argv.slice(2),a=c[0];a&&m.has(a.toLowerCase())&&process.exit(0),(!a||a==="--help"||a==="-h")&&(console.log(l),process.exit(0)),(a==="--version"||a==="-v")&&(console.log(p()),process.stderr.write(`Licensed under BSL-1.1 (Business Source License 1.1)
+`),process.exit(0));const t=c.slice(1);switch(a){case"invoke":{const{invokeCliHandler:o}=await import("./commands/invoke.js"),e=await o(t);process.exit(e);break}case"activate":{const{activate:o}=await import("./commands/activate.js");let e,n,i=!1;for(let r=0;r<t.length;r++){const s=t[r];s==="--server-url"?n=t[++r]:s==="--non-interactive"?i=!0:s==="--help"||s==="-h"?(console.log(l),process.exit(0)):s.startsWith("-")||(e=s)}e||(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 r=await o({licenseKey:e,serverUrl:n,nonInteractive:i});r.success?(console.log(r.message),process.exit(0)):(console.error(r.message),process.exit(1))}catch(r){const s=r instanceof Error?r.message:String(r);console.error(`Activation failed: ${s}`),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"config":{const{configCliHandler:o}=await import("./commands/config.js"),e=await o(t);process.exit(e);break}case"refresh-memory":{const{refreshMemoryCliHandler:o}=await import("./commands/refresh-memory.js"),e=await o(t);process.exit(e);break}case"architecture-memory":{const{architectureMemoryTerminalCliHandler:o}=await import("./commands/architecture-memory-terminal.js"),e=await o(t);process.exit(e);break}case"planning-diagnosis":{const{planningDiagnosisCliHandler:o}=await import("./commands/planning-diagnosis.js"),e=await o(t);process.exit(e);break}case"planning-research":{const{planningResearchCliHandler:o}=await import("./commands/planning-research.js"),e=await o(t);process.exit(e);break}case"planning-generation":{const{planningGenerationCliHandler:o}=await import("./commands/planning-generation.js"),e=await o(t);process.exit(e);break}case"story-checkpoint":{const{storyCheckpointCliHandler:o}=await import("./commands/story-checkpoint.js"),e=await o(t);process.exit(e);break}case"legacy-story-branch":{const{legacyStoryBranchCliHandler:o}=await import("./commands/legacy-story-branch.js"),e=await o(t);process.exit(e);break}case"legacy-story-pr":{const{legacyStoryPrCliHandler:o}=await import("./commands/legacy-story-pr.js"),e=await o(t);process.exit(e);break}case"legacy-epic-terminal":{const{legacyEpicTerminalCliHandler:o}=await import("./commands/legacy-epic-terminal.js"),e=await o(t);process.exit(e);break}case"mutation-qa":{const{mutationQaCliHandler:o}=await import("./commands/mutation-qa.js"),e=await o(t);process.exit(e);break}case"property-qa":{const{propertyQaCliHandler:o}=await import("./commands/property-qa.js"),e=await o(t);process.exit(e);break}case"qa-scan-review":{const{qaScanReviewCliHandler:o}=await import("./commands/qa-scan-review.js"),e=await o(t);process.exit(e);break}case"refactor-root":{if(t[0]==="characterize"){const{refactorCharacterizationCliHandler:n}=await import("./commands/refactor-characterization.js");process.exit(n(t))}if(t[0]==="review-accept"||t[0]==="review-status"){const{refactorReviewCliHandler:n}=await import("./commands/refactor-review.js");process.exit(await n(t))}if(t[0]?.startsWith("commit-")){const{refactorCommitCliHandler:n}=await import("./commands/refactor-commit.js");process.exit(n(t))}const{refactorRootCliHandler:o}=await import("./commands/refactor-root.js"),e=o(t);process.exit(e);break}case"native-agent":{const{nativeAgentCliHandler:o}=await import("./commands/native-agent.js"),e=await o(t);process.exit(e);break}case"architecture-answers":{const{architectureAnswersCliHandler:o}=await import("./commands/architecture-answers.js"),e=await o(t);process.exit(e);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)}}d().catch(c=>{console.error(`Fatal error: ${c instanceof Error?c.message:String(c)}`),process.exit(1)});

package/packages/client/dist/commands/invoke.d.ts

@@ -508,6 +508,7 @@ interface InvokeRequestBodyBase {
         readonly pathCount: number;
         readonly publicSafe: true;
     };
+    readonly propertyTestExecutionInput?: import('../private-execution/property-test-plan.js').PropertyTestExecutionInput;
     readonly platformTarget?: string;
     readonly nativeHostAttestation?: ReturnType<typeof detectNativeHostAttestation>;
     readonly privateExecution?: {