nccgs 2.0.0 → 2.1.1

package/scaffold/.nccgs/project.yaml

@@ -1,108 +1,109 @@
-schema_version: 2
-
-project:
-  name: "[set during migration/onboarding]"
-  stage: existing
-  platforms: []
-
-studio:
-  profile: unity-production
-  enabled_departments: [leadership, design, programming, unity, content, quality, release]
-  orchestration:
-    max_agent_depth: 1
-    max_parallel_agents: 2
-    single_writer_per_path: true
-    independent_verification: true
-
-models:
-  profile: claude-standalone
-  allow_inherit_fallback: false
-  allow_automatic_escalation: false
-  notify_on_escalation: true
-  overrides: {}
-
-# Profile contracts are resolved from this canonical configuration.
-pipeline_policy: .claude/nccgs/pipeline.json
-
-workflow:
-  operating_mode: solo
-  autonomy: high
-  default_classification: auto
-  documentation: targeted
-  traceability: targeted
-  review_intensity: risk_based
-
-context:
-  packet_path: ".nccgs/context/{feature_id}.yaml"
-  full_source_reads: on_demand
-  # Advisory context targets, not measured token/spend limits. Review-round limits
-  # are executable and resolved from pipeline.json contract.taskTiers.
-  budgets: { fast: 4000, standard: 12000, controlled: 24000 }
-
-authority:
-  implementation_details: claude
-  safe_refactor: claude
-  automated_verification: claude
-  technical_docs_sync: claude
-  gameplay_change: product_owner
-  scope_change: product_owner
-  subjective_acceptance: product_owner
-  dependency_or_service: product_owner
-  irreversible_migration: product_owner
-
-canonical_sources:
-  product_decisions: []
-  game_design: []
-  architecture: []
-  planning: []
-  art_direction: []
-  narrative: []
-  audio: []
-  release: []
-
-unity:
-  version: detect
-  render_pipeline: detect
-  ui_system: detect
-  input_system: detect
-  cli: enabled
-  pipeline: enabled
-  connected_editor_preferred: true
-
-architecture:
-  decisions: []
-  forbidden_patterns: []
-  approved_packages: []
-  approved_services: []
-
-ownership:
-  protected_paths: []
-  user_owned_paths: []
-  user_owned_settings: []
-  generated_paths: []
-
-verification:
-  editmode: detect
-  playmode: detect
-  runtime: unity_cli
-  build_targets: []
-  required_regressions: []
-  recurring_manual_gates: []
-  baseline_policy: no_unexplained_reduction
-
-closure:
-  mode: lean
-  canonical_record: ".nccgs/closures/{feature_id}.md"
-  required_artifacts: []
-  done_requires: [implementation, objective_verification, required_artifacts, applicable_manual_gates]
-
-release:
-  protected_branches: [main, master]
-  required_builds: []
-  publishing_requires_product_owner: true
-
-conventions:
-  source_paths: []
-  test_paths: []
-  documentation_paths: []
-  notes: []
+schema_version: 2
+
+project:
+  name: "[set during migration/onboarding]"
+  stage: existing
+  platforms: []
+
+studio:
+  profile: unity-production
+  enabled_departments: [leadership, design, programming, unity, content, quality, release]
+  orchestration:
+    max_agent_depth: 1
+    max_parallel_agents: 2
+    single_writer_per_path: true
+    independent_verification: true
+
+models:
+  profile: claude-standalone
+  allow_inherit_fallback: false
+  allow_automatic_escalation: false
+  notify_on_escalation: true
+  overrides: {}
+
+# Profile contracts are resolved from this canonical configuration.
+pipeline_policy: .claude/nccgs/pipeline.json
+
+workflow:
+  operating_mode: solo
+  autonomy: high
+  default_classification: auto
+  documentation: targeted
+  traceability: targeted
+  review_intensity: risk_based
+
+context:
+  packet_path: ".nccgs/context/{feature_id}.yaml"
+  full_source_reads: on_demand
+  # Advisory context targets, not measured token/spend limits. Review-round limits
+  # are executable and resolved from pipeline.json contract.taskTiers.
+  budgets: { fast: 4000, standard: 12000, controlled: 24000 }
+
+authority:
+  implementation_details: claude
+  safe_refactor: claude
+  automated_verification: claude
+  technical_docs_sync: claude
+  gameplay_change: product_owner
+  scope_change: product_owner
+  subjective_acceptance: product_owner
+  dependency_or_service: product_owner
+  irreversible_migration: product_owner
+
+canonical_sources:
+  product_decisions: []
+  game_design: []
+  architecture: []
+  planning: []
+  art_direction: []
+  narrative: []
+  audio: []
+  release: []
+
+unity:
+  # Enforced package boundary: direct CLI/Pipeline only; no Unity MCP fallback.
+  version: detect
+  render_pipeline: detect
+  ui_system: detect
+  input_system: detect
+  cli: enabled
+  pipeline: enabled
+  connected_editor_preferred: true
+
+architecture:
+  decisions: []
+  forbidden_patterns: []
+  approved_packages: []
+  approved_services: []
+
+ownership:
+  protected_paths: []
+  user_owned_paths: []
+  user_owned_settings: []
+  generated_paths: []
+
+verification:
+  editmode: detect
+  playmode: detect
+  runtime: unity_cli
+  build_targets: []
+  required_regressions: []
+  recurring_manual_gates: []
+  baseline_policy: no_unexplained_reduction
+
+closure:
+  mode: lean
+  canonical_record: ".nccgs/closures/{feature_id}.md"
+  required_artifacts: []
+  done_requires: [implementation, objective_verification, required_artifacts, applicable_manual_gates]
+
+release:
+  protected_branches: [main, master]
+  required_builds: []
+  publishing_requires_product_owner: true
+
+conventions:
+  source_paths: []
+  test_paths: []
+  documentation_paths: []
+  notes: []

package/scripts/benchmark-v15.mjs

@@ -1,173 +1,173 @@
-import assert from "node:assert/strict";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { performance } from "node:perf_hooks";
-import { fileURLToPath } from "node:url";
-import { atomicJson, hash, json } from "../.claude/nccgs/tools/policy.mjs";
-import { initialize, record, snapshot, taskPath } from "../.claude/nccgs/tools/gates.mjs";
-import { reserve, reconcile, status } from "../.claude/nccgs/tools/orchestration.mjs";
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const label = "SYNTHETIC FRAMEWORK BENCHMARK — no provider/model or game execution";
-export const scenarios = [
-  { id: "tiny-fix", name: "Tiny local fix", mode: "implement", scope: "local", target: "fix", expectedRisk: "FAST", objective: "Fix a local display label alignment with a known expected value" },
-  { id: "learning-prototype", name: "Learning prototype", mode: "implement", scope: "feature", target: "learning-prototype", expectedRisk: "STANDARD", objective: "Explore a bounded feedback hypothesis in a synthetic prototype" },
-  { id: "alpha-ready-prototype", name: "Alpha-ready prototype", mode: "implement", scope: "feature", target: "alpha-ready", expectedRisk: "STANDARD", objective: "Prepare a prototype feature for a declared end-to-end readiness check" },
-  { id: "cross-system-design", name: "Cross-system optimization and design plan", mode: "plan", scope: "cross-system", target: "production-change", expectedRisk: "CONTROLLED", objective: "Plan cross-system allocation and update-order optimization from a measured baseline" },
-  { id: "large-system-audit", name: "Large feature and system audit", mode: "audit", scope: "cross-system", target: "production-change", expectedRisk: "CONTROLLED", objective: "Audit dependencies and acceptance coverage across a large feature's systems" }
-];
-const measure = action => {
-  const start = performance.now(), value = action();
-  return { value, ms: performance.now() - start };
-};
-const rounded = value => Math.round(value * 1000) / 1000;
-function distribution(values) {
-  const sorted = [...values].sort((a, b) => a - b), mid = Math.floor(sorted.length / 2);
-  return { samples: sorted.length, min: rounded(sorted[0]), median: rounded(sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2), max: rounded(sorted.at(-1)), total: rounded(sorted.reduce((a, b) => a + b, 0)) };
-}
-function workspace(sourceFiles) {
-  const project = fs.mkdtempSync(path.join(os.tmpdir(), "nccgs-v15-benchmark-"));
-  function write(relative, value) {
-    const file = path.join(project, relative);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, typeof value === "string" ? value : `${JSON.stringify(value, null, 2)}\n`);
-  }
-  for (const file of ["pipeline.json", "studio.json"]) write(`.claude/nccgs/${file}`, fs.readFileSync(path.join(root, ".claude/nccgs", file), "utf8"));
-  write(".nccgs/project.yaml", "schema_version: 2\nmodels:\n  profile: claude-standalone\n");
-  write(".nccgs/execution.json", { schemaVersion: 1, name: "standalone", externalReview: { mode: "off" }, acceptanceRequired: false, requireObservedEffort: false, maxParallelWorkers: 2 });
-  for (let i = 0; i < sourceFiles; i++) write(`SyntheticSource/component-${i}.txt`, `Synthetic framework fixture component ${i}.\n${"Boundary and dependency data only.\n".repeat(24)}`);
-  return { project, write,
-    init(id, scenario, parentId = null) {
-      const relative = `.nccgs/intakes/${id}.json`;
-      write(relative, { schemaVersion: 1, objective: scenario.objective, mode: scenario.mode, scope: scenario.scope, target: scenario.target, readiness: "ready", systems: ["synthetic-component"], requiredChecks: ["fixture-acceptance"] });
-      return initialize(project, id, null, null, null, { intake: relative, parentId });
-    },
-    dispose() {
-      const resolved = path.resolve(project), expectedParent = path.resolve(os.tmpdir());
-      assert.equal(path.dirname(resolved), expectedParent);
-      assert.ok(path.basename(resolved).startsWith("nccgs-v15-benchmark-"));
-      fs.rmSync(resolved, { recursive: true, force: true });
-    } };
-}
-function request(task, key, maxDispatches = null) {
-  // The stress parameter counts ordinary delivery attempts; protected slots stay
-  // inside the actual total ceiling and must remain untouched by this fixture.
-  const protectedSlots = Object.values(task.contract.deliveryReserve ?? {}).reduce((a, b) => a + b, 0);
-  return { kind: task.mode === "implement" ? "implementation" : "analysis", agent: task.mode === "implement" ? "nccgs-gameplay-programmer" : "nccgs-task-scout",
-    requestKey: key, reason: "Synthetic reservation only; no worker/provider is invoked", writePaths: task.mode === "implement" ? ["SyntheticSource"] : [],
-    ...(maxDispatches === null ? {} : { limits: { maxDispatches: maxDispatches + protectedSlots } }) };
-}
-function cancelFixture(project, dispatch) {
-  return reconcile(project, dispatch.id, { status: "cancelled", reason: "Synthetic framework reservation completed without dispatching a model", reference: "benchmark-v15: intentionally no provider invocation" });
-}
-function scenarioRun(scenario, iterations, sourceFiles) {
-  const times = { init: [], snapshot: [], reserve: [], report: [] }, counts = { initialized: 0, snapshots: 0, reservations: 0, reports: 0, providerAttempts: 0 };
-  let source = null, observed = null;
-  for (let i = 0; i < iterations; i++) {
-    const fixture = workspace(sourceFiles);
-    try {
-      const initialized = measure(() => fixture.init(scenario.id, scenario));
-      const task = initialized.value;
-      assert.equal(task.mode, scenario.mode); assert.equal(task.risk, scenario.expectedRisk);
-      assert.equal(task.schemaVersion, 2);
-      const expectedRoute = { FAST: { class: "lightweight", model: "sonnet", effort: "medium" }, STANDARD: { class: "standard", model: "opus", effort: "medium" }, CONTROLLED: { class: "deep", model: "opus", effort: "high" } }[scenario.expectedRisk];
-      assert.deepEqual(task.implementationRoute, expectedRoute);
-      observed = { mode: task.mode, risk: task.risk, implementationRoute: task.implementationRoute };
-      times.init.push(initialized.ms); counts.initialized++;
-      const captured = measure(() => snapshot(fixture.project, task));
-      times.snapshot.push(captured.ms); counts.snapshots++;
-      source = { syntheticFiles: sourceFiles, snapshotFiles: captured.value.files, snapshotBytes: captured.value.bytes };
-      const reserved = measure(() => reserve(fixture.project, task.id, request(task, "measurement")));
-      times.reserve.push(reserved.ms); counts.reservations++;
-      cancelFixture(fixture.project, reserved.value);
-      const reported = measure(() => record(fixture.project, task.id, "report", { outcome: "blocked", summary: `${label}. Classification, snapshot, reservation and reporting were exercised; there is no runtime/model evidence.` }));
-      times.report.push(reported.ms); counts.reports++;
-      const usage = status(fixture.project, task.id);
-      assert.equal(usage.usage.dispatches, 1);
-      assert.equal(usage.telemetry.attempts, 0);
-      assert.equal(reported.value.reviewBudget.used, 0);
-      assert.equal(reported.value.stages.report.verificationState.verified, false);
-      assert.equal(reported.value.outcome, "blocked");
-    } finally { fixture.dispose(); }
-  }
-  return { id: scenario.id, name: scenario.name, expected: { mode: scenario.mode, risk: scenario.expectedRisk }, observed, result: "PASS",
-    counts, source, timingsMs: Object.fromEntries(Object.entries(times).map(([name, values]) => [name, distribution(values)])) };
-}
-function stressQuota(sourceFiles, quota) {
-  const fixture = workspace(sourceFiles), start = performance.now();
-  try {
-    const task = fixture.init("bounded", scenarios[0]);
-    for (let i = 0; i < quota; i++) cancelFixture(fixture.project, reserve(fixture.project, task.id, request(task, `try-${i}`, quota)));
-    assert.throws(() => reserve(fixture.project, task.id, request(task, "over-budget", quota)), /budget reserved for bounded/i);
-    const after = status(fixture.project, task.id);
-    assert.equal(after.usage.dispatches, quota);
-    assert.equal(after.telemetry.attempts, 0);
-    assert.equal(after.active.length, 0);
-    assert.equal(after.deliveryBudget.protectedSlots, 4);
-    return { id: "repeated-reservation-exhaustion", result: "PASS", quota, reservations: after.usage.dispatches, rejectedAdditionalReservation: true,
-      quotaKind: "ordinary-delivery", totalDispatchLimit: after.limits.maxDispatches, protectedRemaining: after.deliveryBudget.remaining,
-      cancelledAttemptsRefunded: false, providerAttempts: 0, durationMs: rounded(performance.now() - start) };
-  } finally { fixture.dispose(); }
-}
-function stressParent(sourceFiles) {
-  const fixture = workspace(sourceFiles), start = performance.now();
-  try {
-    const parent = fixture.init("parent", scenarios[1]);
-    cancelFixture(fixture.project, reserve(fixture.project, parent.id, request(parent, "parent-integration", 4)));
-    const first = fixture.init("child-a", scenarios[0], parent.id);
-    for (let i = 0; i < 2; i++) cancelFixture(fixture.project, reserve(fixture.project, first.id, request(first, `child-a-${i}`, 3)));
-    const second = fixture.init("child-b", scenarios[0], parent.id);
-    cancelFixture(fixture.project, reserve(fixture.project, second.id, request(second, "child-b-0", 3)));
-    assert.throws(() => reserve(fixture.project, second.id, request(second, "child-b-over-parent", 3)), /budget reserved for parent/i);
-    const third = fixture.init("child-c", scenarios[0], parent.id);
-    assert.throws(() => reserve(fixture.project, third.id, request(third, "new-child-no-refund", 3)), /budget reserved for parent/i);
-    const aggregate = status(fixture.project, parent.id);
-    assert.equal(aggregate.usage.dispatches, 4);
-    assert.equal(aggregate.telemetry.attempts, 0);
-    assert.equal(json(taskPath(fixture.project, parent.id)).reviewBudget.used, 0);
-    return { id: "parent-child-aggregate-exhaustion", result: "PASS", parentQuota: 4, aggregateReservations: 4,
-      quotaKind: "ordinary-delivery", totalDispatchLimit: aggregate.limits.maxDispatches, protectedRemaining: aggregate.deliveryBudget.remaining,
-      ownParentReservations: 1, childReservations: { "child-a": 2, "child-b": 1, "child-c": 0 },
-      blockedExistingChildDespiteLocalCapacity: true, blockedNewChildDespiteLocalCapacity: true,
-      providerAttempts: 0, durationMs: rounded(performance.now() - start) };
-  } finally { fixture.dispose(); }
-}
-export function runBenchmark({ iterations = 3, sourceFiles = 40, stressQuota: quota = 6 } = {}) {
-  assert(!(process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT), "Run the synthetic framework benchmark outside Claude Code; it uses explicit fixture reconciliation");
-  assert(Number.isSafeInteger(iterations) && iterations >= 1 && iterations <= 10, "iterations must be 1..10");
-  assert(Number.isSafeInteger(sourceFiles) && sourceFiles >= 1 && sourceFiles <= 1000, "sourceFiles must be 1..1000");
-  assert(Number.isSafeInteger(quota) && quota >= 1 && quota <= 32, "stressQuota must be 1..32");
-  const start = performance.now();
-  const results = scenarios.map(scenario => scenarioRun(scenario, iterations, sourceFiles));
-  const stress = [stressQuota(sourceFiles, quota), stressParent(sourceFiles)];
-  return { schemaVersion: 1, benchmark: "nccgs-v15-framework-only", label, recordedAt: new Date().toISOString(), result: "PASS",
-    environment: { node: process.version, platform: process.platform, architecture: process.arch },
-    framework: { packageVersion: json(path.join(root, "package.json")).version, pipelineSha256: hash(fs.readFileSync(path.join(root, ".claude/nccgs/pipeline.json"))) },
-    parameters: { iterations, sourceFiles, stressQuota: quota },
-    scenarios: results, stress,
-    totals: { scenarioRuns: scenarios.length * iterations, stressCases: stress.length, providerAttempts: 0, frameworkDurationMs: rounded(performance.now() - start) },
-    evidenceBoundary: { evidenceKind: "synthetic-framework-fixtures", modelExecution: "NOT_RUN", gameExecution: "NOT_RUN", tokenCost: "NOT_MEASURED", productivityComparison: "NOT_MEASURED",
-      interpretation: "Timings measure local framework I/O and bookkeeping only; total duration also includes fixture setup and cleanup. Fixture classification and quota assertions do not establish natural-language classification accuracy, model quality or whole-workflow efficiency." } };
-}
-export function run(args) {
-  const accepted = new Set(["--out", "--iterations", "--source-files", "--stress-quota"]);
-  const options = {};
-  for (let i = 0; i < args.length; i += 2) {
-    assert(accepted.has(args[i]) && args[i + 1] && !args[i + 1].startsWith("--"), "Usage: benchmark-v15.mjs [--out FILE] [--iterations 1..10] [--source-files 1..1000] [--stress-quota 1..32]");
-    assert(options[args[i]] === undefined, `Duplicate option: ${args[i]}`);
-    options[args[i]] = args[i + 1];
-  }
-  const result = runBenchmark({ ...(options["--iterations"] ? { iterations: Number(options["--iterations"]) } : {}),
-    ...(options["--source-files"] ? { sourceFiles: Number(options["--source-files"]) } : {}), ...(options["--stress-quota"] ? { stressQuota: Number(options["--stress-quota"]) } : {}) });
-  if (options["--out"]) {
-    const file = path.resolve(options["--out"]);
-    atomicJson(file, result);
-    return { result: result.result, label, output: file, totals: result.totals };
-  }
-  return result;
-}
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  try { console.log(JSON.stringify(run(process.argv.slice(2)), null, 2)); }
-  catch (error) { console.error(error.message); process.exitCode = 1; }
-}
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { performance } from "node:perf_hooks";
+import { fileURLToPath } from "node:url";
+import { atomicJson, hash, json } from "../.claude/nccgs/tools/policy.mjs";
+import { initialize, record, snapshot, taskPath } from "../.claude/nccgs/tools/gates.mjs";
+import { reserve, reconcile, status } from "../.claude/nccgs/tools/orchestration.mjs";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const label = "SYNTHETIC FRAMEWORK BENCHMARK — no provider/model or game execution";
+export const scenarios = [
+  { id: "tiny-fix", name: "Tiny local fix", mode: "implement", scope: "local", target: "fix", expectedRisk: "FAST", objective: "Fix a local display label alignment with a known expected value" },
+  { id: "learning-prototype", name: "Learning prototype", mode: "implement", scope: "feature", target: "learning-prototype", expectedRisk: "STANDARD", objective: "Explore a bounded feedback hypothesis in a synthetic prototype" },
+  { id: "alpha-ready-prototype", name: "Alpha-ready prototype", mode: "implement", scope: "feature", target: "alpha-ready", expectedRisk: "STANDARD", objective: "Prepare a prototype feature for a declared end-to-end readiness check" },
+  { id: "cross-system-design", name: "Cross-system optimization and design plan", mode: "plan", scope: "cross-system", target: "production-change", expectedRisk: "CONTROLLED", objective: "Plan cross-system allocation and update-order optimization from a measured baseline" },
+  { id: "large-system-audit", name: "Large feature and system audit", mode: "audit", scope: "cross-system", target: "production-change", expectedRisk: "CONTROLLED", objective: "Audit dependencies and acceptance coverage across a large feature's systems" }
+];
+const measure = action => {
+  const start = performance.now(), value = action();
+  return { value, ms: performance.now() - start };
+};
+const rounded = value => Math.round(value * 1000) / 1000;
+function distribution(values) {
+  const sorted = [...values].sort((a, b) => a - b), mid = Math.floor(sorted.length / 2);
+  return { samples: sorted.length, min: rounded(sorted[0]), median: rounded(sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2), max: rounded(sorted.at(-1)), total: rounded(sorted.reduce((a, b) => a + b, 0)) };
+}
+function workspace(sourceFiles) {
+  const project = fs.mkdtempSync(path.join(os.tmpdir(), "nccgs-v15-benchmark-"));
+  function write(relative, value) {
+    const file = path.join(project, relative);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, typeof value === "string" ? value : `${JSON.stringify(value, null, 2)}\n`);
+  }
+  for (const file of ["pipeline.json", "studio.json"]) write(`.claude/nccgs/${file}`, fs.readFileSync(path.join(root, ".claude/nccgs", file), "utf8"));
+  write(".nccgs/project.yaml", "schema_version: 2\nmodels:\n  profile: claude-standalone\n");
+  write(".nccgs/execution.json", { schemaVersion: 1, name: "standalone", externalReview: { mode: "off" }, acceptanceRequired: false, requireObservedEffort: false, maxParallelWorkers: 2 });
+  for (let i = 0; i < sourceFiles; i++) write(`SyntheticSource/component-${i}.txt`, `Synthetic framework fixture component ${i}.\n${"Boundary and dependency data only.\n".repeat(24)}`);
+  return { project, write,
+    init(id, scenario, parentId = null) {
+      const relative = `.nccgs/intakes/${id}.json`;
+      write(relative, { schemaVersion: 1, objective: scenario.objective, mode: scenario.mode, scope: scenario.scope, target: scenario.target, readiness: "ready", systems: ["synthetic-component"], requiredChecks: ["fixture-acceptance"] });
+      return initialize(project, id, null, null, null, { intake: relative, parentId });
+    },
+    dispose() {
+      const resolved = path.resolve(project), expectedParent = path.resolve(os.tmpdir());
+      assert.equal(path.dirname(resolved), expectedParent);
+      assert.ok(path.basename(resolved).startsWith("nccgs-v15-benchmark-"));
+      fs.rmSync(resolved, { recursive: true, force: true });
+    } };
+}
+function request(task, key, maxDispatches = null) {
+  // The stress parameter counts ordinary delivery attempts; protected slots stay
+  // inside the actual total ceiling and must remain untouched by this fixture.
+  const protectedSlots = Object.values(task.contract.deliveryReserve ?? {}).reduce((a, b) => a + b, 0);
+  return { kind: task.mode === "implement" ? "implementation" : "analysis", agent: task.mode === "implement" ? "nccgs-gameplay-programmer" : "nccgs-task-scout",
+    requestKey: key, reason: "Synthetic reservation only; no worker/provider is invoked", writePaths: task.mode === "implement" ? ["SyntheticSource"] : [],
+    ...(maxDispatches === null ? {} : { limits: { maxDispatches: maxDispatches + protectedSlots } }) };
+}
+function cancelFixture(project, dispatch) {
+  return reconcile(project, dispatch.id, { status: "cancelled", reason: "Synthetic framework reservation completed without dispatching a model", reference: "benchmark-v15: intentionally no provider invocation" });
+}
+function scenarioRun(scenario, iterations, sourceFiles) {
+  const times = { init: [], snapshot: [], reserve: [], report: [] }, counts = { initialized: 0, snapshots: 0, reservations: 0, reports: 0, providerAttempts: 0 };
+  let source = null, observed = null;
+  for (let i = 0; i < iterations; i++) {
+    const fixture = workspace(sourceFiles);
+    try {
+      const initialized = measure(() => fixture.init(scenario.id, scenario));
+      const task = initialized.value;
+      assert.equal(task.mode, scenario.mode); assert.equal(task.risk, scenario.expectedRisk);
+      assert.equal(task.schemaVersion, 2);
+      const expectedRoute = { FAST: { class: "lightweight", model: "sonnet", effort: "high" }, STANDARD: { class: "standard", model: "opus", effort: "high" }, CONTROLLED: { class: "deep", model: "opus", effort: "xhigh" } }[scenario.expectedRisk];
+      assert.deepEqual(task.implementationRoute, expectedRoute);
+      observed = { mode: task.mode, risk: task.risk, implementationRoute: task.implementationRoute };
+      times.init.push(initialized.ms); counts.initialized++;
+      const captured = measure(() => snapshot(fixture.project, task));
+      times.snapshot.push(captured.ms); counts.snapshots++;
+      source = { syntheticFiles: sourceFiles, snapshotFiles: captured.value.files, snapshotBytes: captured.value.bytes };
+      const reserved = measure(() => reserve(fixture.project, task.id, request(task, "measurement")));
+      times.reserve.push(reserved.ms); counts.reservations++;
+      cancelFixture(fixture.project, reserved.value);
+      const reported = measure(() => record(fixture.project, task.id, "report", { outcome: "blocked", summary: `${label}. Classification, snapshot, reservation and reporting were exercised; there is no runtime/model evidence.` }));
+      times.report.push(reported.ms); counts.reports++;
+      const usage = status(fixture.project, task.id);
+      assert.equal(usage.usage.dispatches, 1);
+      assert.equal(usage.telemetry.attempts, 0);
+      assert.equal(reported.value.reviewBudget.used, 0);
+      assert.equal(reported.value.stages.report.verificationState.verified, false);
+      assert.equal(reported.value.outcome, "blocked");
+    } finally { fixture.dispose(); }
+  }
+  return { id: scenario.id, name: scenario.name, expected: { mode: scenario.mode, risk: scenario.expectedRisk }, observed, result: "PASS",
+    counts, source, timingsMs: Object.fromEntries(Object.entries(times).map(([name, values]) => [name, distribution(values)])) };
+}
+function stressQuota(sourceFiles, quota) {
+  const fixture = workspace(sourceFiles), start = performance.now();
+  try {
+    const task = fixture.init("bounded", scenarios[0]);
+    for (let i = 0; i < quota; i++) cancelFixture(fixture.project, reserve(fixture.project, task.id, request(task, `try-${i}`, quota)));
+    assert.throws(() => reserve(fixture.project, task.id, request(task, "over-budget", quota)), /budget reserved for bounded/i);
+    const after = status(fixture.project, task.id);
+    assert.equal(after.usage.dispatches, quota);
+    assert.equal(after.telemetry.attempts, 0);
+    assert.equal(after.active.length, 0);
+    assert.equal(after.deliveryBudget.protectedSlots, 4);
+    return { id: "repeated-reservation-exhaustion", result: "PASS", quota, reservations: after.usage.dispatches, rejectedAdditionalReservation: true,
+      quotaKind: "ordinary-delivery", totalDispatchLimit: after.limits.maxDispatches, protectedRemaining: after.deliveryBudget.remaining,
+      cancelledAttemptsRefunded: false, providerAttempts: 0, durationMs: rounded(performance.now() - start) };
+  } finally { fixture.dispose(); }
+}
+function stressParent(sourceFiles) {
+  const fixture = workspace(sourceFiles), start = performance.now();
+  try {
+    const parent = fixture.init("parent", scenarios[1]);
+    cancelFixture(fixture.project, reserve(fixture.project, parent.id, request(parent, "parent-integration", 4)));
+    const first = fixture.init("child-a", scenarios[0], parent.id);
+    for (let i = 0; i < 2; i++) cancelFixture(fixture.project, reserve(fixture.project, first.id, request(first, `child-a-${i}`, 3)));
+    const second = fixture.init("child-b", scenarios[0], parent.id);
+    cancelFixture(fixture.project, reserve(fixture.project, second.id, request(second, "child-b-0", 3)));
+    assert.throws(() => reserve(fixture.project, second.id, request(second, "child-b-over-parent", 3)), /budget reserved for parent/i);
+    const third = fixture.init("child-c", scenarios[0], parent.id);
+    assert.throws(() => reserve(fixture.project, third.id, request(third, "new-child-no-refund", 3)), /budget reserved for parent/i);
+    const aggregate = status(fixture.project, parent.id);
+    assert.equal(aggregate.usage.dispatches, 4);
+    assert.equal(aggregate.telemetry.attempts, 0);
+    assert.equal(json(taskPath(fixture.project, parent.id)).reviewBudget.used, 0);
+    return { id: "parent-child-aggregate-exhaustion", result: "PASS", parentQuota: 4, aggregateReservations: 4,
+      quotaKind: "ordinary-delivery", totalDispatchLimit: aggregate.limits.maxDispatches, protectedRemaining: aggregate.deliveryBudget.remaining,
+      ownParentReservations: 1, childReservations: { "child-a": 2, "child-b": 1, "child-c": 0 },
+      blockedExistingChildDespiteLocalCapacity: true, blockedNewChildDespiteLocalCapacity: true,
+      providerAttempts: 0, durationMs: rounded(performance.now() - start) };
+  } finally { fixture.dispose(); }
+}
+export function runBenchmark({ iterations = 3, sourceFiles = 40, stressQuota: quota = 6 } = {}) {
+  assert(!(process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT), "Run the synthetic framework benchmark outside Claude Code; it uses explicit fixture reconciliation");
+  assert(Number.isSafeInteger(iterations) && iterations >= 1 && iterations <= 10, "iterations must be 1..10");
+  assert(Number.isSafeInteger(sourceFiles) && sourceFiles >= 1 && sourceFiles <= 1000, "sourceFiles must be 1..1000");
+  assert(Number.isSafeInteger(quota) && quota >= 1 && quota <= 32, "stressQuota must be 1..32");
+  const start = performance.now();
+  const results = scenarios.map(scenario => scenarioRun(scenario, iterations, sourceFiles));
+  const stress = [stressQuota(sourceFiles, quota), stressParent(sourceFiles)];
+  return { schemaVersion: 1, benchmark: "nccgs-v15-framework-only", label, recordedAt: new Date().toISOString(), result: "PASS",
+    environment: { node: process.version, platform: process.platform, architecture: process.arch },
+    framework: { packageVersion: json(path.join(root, "package.json")).version, pipelineSha256: hash(fs.readFileSync(path.join(root, ".claude/nccgs/pipeline.json"))) },
+    parameters: { iterations, sourceFiles, stressQuota: quota },
+    scenarios: results, stress,
+    totals: { scenarioRuns: scenarios.length * iterations, stressCases: stress.length, providerAttempts: 0, frameworkDurationMs: rounded(performance.now() - start) },
+    evidenceBoundary: { evidenceKind: "synthetic-framework-fixtures", modelExecution: "NOT_RUN", gameExecution: "NOT_RUN", tokenCost: "NOT_MEASURED", productivityComparison: "NOT_MEASURED",
+      interpretation: "Timings measure local framework I/O and bookkeeping only; total duration also includes fixture setup and cleanup. Fixture classification and quota assertions do not establish natural-language classification accuracy, model quality or whole-workflow efficiency." } };
+}
+export function run(args) {
+  const accepted = new Set(["--out", "--iterations", "--source-files", "--stress-quota"]);
+  const options = {};
+  for (let i = 0; i < args.length; i += 2) {
+    assert(accepted.has(args[i]) && args[i + 1] && !args[i + 1].startsWith("--"), "Usage: benchmark-v15.mjs [--out FILE] [--iterations 1..10] [--source-files 1..1000] [--stress-quota 1..32]");
+    assert(options[args[i]] === undefined, `Duplicate option: ${args[i]}`);
+    options[args[i]] = args[i + 1];
+  }
+  const result = runBenchmark({ ...(options["--iterations"] ? { iterations: Number(options["--iterations"]) } : {}),
+    ...(options["--source-files"] ? { sourceFiles: Number(options["--source-files"]) } : {}), ...(options["--stress-quota"] ? { stressQuota: Number(options["--stress-quota"]) } : {}) });
+  if (options["--out"]) {
+    const file = path.resolve(options["--out"]);
+    atomicJson(file, result);
+    return { result: result.result, label, output: file, totals: result.totals };
+  }
+  return result;
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try { console.log(JSON.stringify(run(process.argv.slice(2)), null, 2)); }
+  catch (error) { console.error(error.message); process.exitCode = 1; }
+}

package/scripts/cli.mjs

@@ -6,6 +6,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import crypto from "node:crypto";
 import { atomicJson, contained, executionPolicy, hash, json, profilePolicy, resolveExecution } from "../.claude/nccgs/tools/policy.mjs";
+import { acquireInstallationLease, assertInstallationAvailable } from "../.claude/nccgs/tools/installation-guard.mjs";
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const root = path.resolve(scriptDir, "..");
@@ -29,13 +30,13 @@ if (command === "run") {
   catch (error) { console.error(`Execution migration failed: ${error.message}`); process.exitCode = 1; }
 } else {
 
-if (!new Set(["install", "update", "doctor", "task", "agents", "policy"]).has(command)) {
+if (!new Set(["install", "update", "uninstall", "recover-session", "doctor", "task", "agents", "policy"]).has(command)) {
   console.error(`Unknown command: ${command}`);
   printHelp();
   process.exit(2);
 }
 
-const scripts = { doctor: "doctor.mjs", task: "../.claude/nccgs/tools/task.mjs", agents: "../.claude/nccgs/tools/configure-models.mjs", policy: "../.claude/nccgs/tools/compile-policy.mjs" };
+const scripts = { uninstall: "uninstall.mjs", "recover-session": "recover-session.mjs", doctor: "doctor.mjs", task: "../.claude/nccgs/tools/task.mjs", agents: "../.claude/nccgs/tools/configure-models.mjs", policy: "../.claude/nccgs/tools/compile-policy.mjs" };
 const script = scripts[command] || "install.mjs";
 let forwardedArgs = command === "update" ? ["--update-only", ...args] : args;
 if (command === "agents" && !args.includes("--project")) forwardedArgs = ["--project", process.cwd(), ...args];
@@ -66,6 +67,9 @@ function migrateExecution() {
     if (!allowed.has(args[i])) throw new Error(`Unknown migration option: ${args[i]}`);
     if (args[i] !== "--dry-run") i++;
   }
+  assertInstallationAvailable(target);
+  const lease = dryRun ? null : acquireInstallationLease(target, "nccgs-migrate-execution");
+  try {
   const at = relative => contained(target, relative);
   if (!fs.existsSync(at(".claude/nccgs/install-state.json"))) throw new Error("Install/update NCCGS before migrating execution");
   const studio = json(at(".claude/nccgs/studio.json"));
@@ -158,6 +162,7 @@ function migrateExecution() {
     throw error;
   }
   console.log(`Execution migration ${id} applied. Rollback: nccgs migrate-execution --rollback ${id} --dry-run`);
+  } finally { lease?.release(); }
 }
 
 function printHelp() {
@@ -166,6 +171,10 @@ function printHelp() {
 Usage:
   nccgs install [options]
   nccgs update [options]
+  nccgs uninstall [--project DIR] [--dry-run]
+  nccgs uninstall --rollback UNINSTALL_ID [--project DIR] [--dry-run]
+  nccgs recover-session --id SESSION_UUID [--project DIR] --dry-run
+  nccgs recover-session --id SESSION_UUID --sha256 HASH --confirm-process-tree-stopped --reason TEXT [--project DIR]
   nccgs doctor [options]
   nccgs run [--project DIR] [--claude EXECUTABLE] [--dry-run] -- [Claude arguments/prompt]
   nccgs run --supervise --task ID --prompt-file FILE --session-budget-usd N [--max-resumes 2] [--timeout-ms 3600000] -- [provider options]