@nimiplatform/nimi-coding 0.1.0 → 0.2.0

package/cli/commands/sync.mjs

@@ -0,0 +1,132 @@
+import { runSeedSync, SYNC_MODE, SYNC_RESULT_STATUS } from "../lib/sync.mjs";
+import { localize } from "../lib/ui.mjs";
+
+function parseSyncOptions(args) {
+  const options = {
+    mode: SYNC_MODE.DRY_RUN,
+    json: false,
+  };
+  let modeSet = false;
+
+  for (const arg of args) {
+    if (arg === "--apply") {
+      if (modeSet) {
+        return {
+          ok: false,
+          error: localize(
+            "nimicoding sync refused: --apply, --check, and --dry-run are mutually exclusive.\n",
+            "nimicoding sync 拒绝执行：--apply、--check、--dry-run 互斥。\n",
+          ),
+        };
+      }
+      options.mode = SYNC_MODE.APPLY;
+      modeSet = true;
+      continue;
+    }
+    if (arg === "--check") {
+      if (modeSet) {
+        return {
+          ok: false,
+          error: localize(
+            "nimicoding sync refused: --apply, --check, and --dry-run are mutually exclusive.\n",
+            "nimicoding sync 拒绝执行：--apply、--check、--dry-run 互斥。\n",
+          ),
+        };
+      }
+      options.mode = SYNC_MODE.CHECK;
+      modeSet = true;
+      continue;
+    }
+    if (arg === "--dry-run") {
+      if (modeSet) {
+        return {
+          ok: false,
+          error: localize(
+            "nimicoding sync refused: --apply, --check, and --dry-run are mutually exclusive.\n",
+            "nimicoding sync 拒绝执行：--apply、--check、--dry-run 互斥。\n",
+          ),
+        };
+      }
+      options.mode = SYNC_MODE.DRY_RUN;
+      modeSet = true;
+      continue;
+    }
+    if (arg === "--json") {
+      options.json = true;
+      continue;
+    }
+    return {
+      ok: false,
+      error: localize(
+        `nimicoding sync refused: unknown option ${arg}.\n`,
+        `nimicoding sync 拒绝执行：未知选项 ${arg}。\n`,
+      ),
+    };
+  }
+
+  return { ok: true, options };
+}
+
+function formatHumanReport(result) {
+  const lines = [];
+  lines.push(localize(
+    `nimicoding sync (${result.mode})`,
+    `nimicoding sync (${result.mode})`,
+  ));
+  lines.push("");
+  lines.push(localize("Summary:", "概览："));
+  lines.push(`  total: ${result.summary.total}`);
+  lines.push(`  in_sync: ${result.summary.in_sync}`);
+  if (result.mode === SYNC_MODE.APPLY) {
+    lines.push(`  created: ${result.summary.created}`);
+    lines.push(`  updated: ${result.summary.updated}`);
+  } else {
+    lines.push(`  would_create: ${result.summary.would_create}`);
+    lines.push(`  would_update: ${result.summary.would_update}`);
+  }
+  lines.push(`  drifted_preserved (host-owned seed): ${result.summary.drifted_preserved}`);
+  if (result.mode === SYNC_MODE.CHECK) {
+    lines.push(`  missing_package_canonical: ${result.summary.missing_package_canonical}`);
+    lines.push(`  missing_host_state_seed: ${result.summary.missing_host_state_seed}`);
+    lines.push(`  drifted_package_canonical: ${result.summary.drifted_package_canonical}`);
+  }
+
+  const noteworthy = result.results.filter((entry) => entry.status !== SYNC_RESULT_STATUS.IN_SYNC);
+  if (noteworthy.length > 0) {
+    lines.push("");
+    lines.push(localize("Per-file status:", "逐文件状态："));
+    for (const entry of noteworthy) {
+      lines.push(`  [${entry.status}] (${entry.ownership}) ${entry.outputRelativePath}`);
+    }
+  }
+
+  if (result.mode === SYNC_MODE.CHECK && !result.ok) {
+    lines.push("");
+    lines.push(localize(
+      "FAIL: package_canonical drift or missing seed detected; run `nimicoding sync --apply` to refresh.",
+      "FAIL：检测到 package_canonical drift 或缺失 seed；执行 `nimicoding sync --apply` 以刷新。",
+    ));
+  }
+
+  return `${lines.join("\n")}\n`;
+}
+
+export async function runSync(args) {
+  const parsed = parseSyncOptions(args);
+  if (!parsed.ok) {
+    process.stderr.write(parsed.error);
+    return 2;
+  }
+
+  const result = await runSeedSync(process.cwd(), parsed.options.mode);
+
+  if (parsed.options.json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  } else {
+    process.stdout.write(formatHumanReport(result));
+  }
+
+  return result.ok ? 0 : 1;
+}
+
+export { parseSyncOptions };

package/cli/commands/topic-formatters.mjs

@@ -62,16 +62,16 @@ export function formatTopicStatus(report) {
       ...Object.entries(report.featureFlags).map(([key, value]) => `- ${key}: ${value ? "true" : "false"}`),
     );
   }
-  if (Array.isArray(report.legacyObservedWaves) && report.legacyObservedWaves.length > 0) {
+  if (Array.isArray(report.observedWaves) && report.observedWaves.length > 0) {
     lines.push(
       "",
       styleLabel(localize("Observed Waves", "Observed Waves")),
-      ...report.legacyObservedWaves.slice(0, 8).map((entry) => (
+      ...report.observedWaves.slice(0, 8).map((entry) => (
         `- ${entry.wave_id}: ${entry.observed_lineage} packets=${entry.packets} results=${entry.results} closeouts=${entry.closeouts} exec_packs=${entry.exec_packs}`
       )),
     );
-    if (report.legacyObservedWaves.length > 8) {
-      lines.push(styleMuted(`- ... ${report.legacyObservedWaves.length - 8} more wave observations`));
+    if (report.observedWaves.length > 8) {
+      lines.push(styleMuted(`- ... ${report.observedWaves.length - 8} more wave observations`));
     }
   }
   if (report.warnings.length > 0) {
@@ -119,16 +119,16 @@ export function formatTopicValidate(report) {
       ...Object.entries(report.featureFlags).map(([key, value]) => `- ${key}: ${value ? "true" : "false"}`),
     );
   }
-  if (Array.isArray(report.legacyObservedWaves) && report.legacyObservedWaves.length > 0) {
+  if (Array.isArray(report.observedWaves) && report.observedWaves.length > 0) {
     lines.push(
       "",
       styleLabel(localize("Observed Waves", "Observed Waves")),
-      ...report.legacyObservedWaves.slice(0, 8).map((entry) => (
+      ...report.observedWaves.slice(0, 8).map((entry) => (
         `- ${entry.wave_id}: ${entry.observed_lineage} packets=${entry.packets} results=${entry.results} closeouts=${entry.closeouts} exec_packs=${entry.exec_packs}`
       )),
     );
-    if (report.legacyObservedWaves.length > 8) {
-      lines.push(styleMuted(`- ... ${report.legacyObservedWaves.length - 8} more wave observations`));
+    if (report.observedWaves.length > 8) {
+      lines.push(styleMuted(`- ... ${report.observedWaves.length - 8} more wave observations`));
     }
   }
   if (report.warnings.length > 0) {

package/cli/commands/validate-ai-governance.mjs

@@ -3,7 +3,10 @@ import { loadGovernanceConfig, requireProfile } from "../lib/internal/governance
 import { evaluateAiContextBudget, formatBytes } from "../lib/internal/governance/ai/ai-context-budget-core.mjs";
 import { evaluateAiStructureBudget } from "../lib/internal/governance/ai/ai-structure-budget-core.mjs";
 import { evaluateHighRiskDocMetadata } from "../lib/internal/governance/ai/check-high-risk-doc-metadata-core.mjs";
-import { runAgentsFreshnessCheck } from "../lib/internal/governance/ai/check-agents-freshness.mjs";
+import {
+  evaluateAgentsFreshnessCheck,
+  runAgentsFreshnessCheck,
+} from "../lib/internal/governance/ai/check-agents-freshness.mjs";
 
 const SCOPES = new Set([
   "agents-freshness",
@@ -16,6 +19,7 @@ function parseOptions(args) {
   const options = {
     profile: null,
     scope: "all",
+    json: false,
   };
 
   for (let index = 0; index < args.length; index += 1) {
@@ -41,6 +45,11 @@ function parseOptions(args) {
       continue;
     }
 
+    if (arg === "--json") {
+      options.json = true;
+      continue;
+    }
+
     return {
       ok: false,
       error: `nimicoding validate-ai-governance refused: unknown option ${arg}.\n`,
@@ -57,6 +66,63 @@ function parseOptions(args) {
   return { ok: true, options };
 }
 
+function writeJson(payload) {
+  process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}
+
+function buildContextBudgetReport(governanceConfig) {
+  const report = evaluateAiContextBudget({
+    cwd: process.cwd(),
+    config: governanceConfig.aiGovernance.contextBudget,
+    configPathLabel: ".nimi/config/governance.yaml#ai_governance.context_budget",
+  });
+  const exitCode = report.invalidWaivers.length > 0 || report.expiredWaivers.length > 0 || report.errors.length > 0
+    ? 1
+    : 0;
+  return { exitCode, report };
+}
+
+function buildStructureBudgetReport(governanceConfig) {
+  const report = evaluateAiStructureBudget({
+    cwd: process.cwd(),
+    config: governanceConfig.aiGovernance.structureBudget,
+    configPathLabel: ".nimi/config/governance.yaml#ai_governance.structure_budget",
+  });
+  const exitCode = report.errors.length > 0 || report.expiredWaivers.length > 0 ? 1 : 0;
+  return { exitCode, report };
+}
+
+function buildHighRiskDocMetadataReport(governanceConfig) {
+  const config = governanceConfig.aiGovernance.highRiskDocMetadata;
+  const report = evaluateHighRiskDocMetadata({
+    repoRoot: process.cwd(),
+    docRoots: Array.isArray(config.doc_roots) ? config.doc_roots : [".local"],
+    exemptPaths: Array.isArray(config.exempt_paths) ? config.exempt_paths : [],
+    namePatterns: Array.isArray(config.name_patterns) ? config.name_patterns : [],
+    requiredMetadataKeys: Array.isArray(config.required_metadata_keys)
+      ? config.required_metadata_keys
+      : [],
+  });
+  return {
+    exitCode: report.failures.length > 0 ? 1 : 0,
+    report: {
+      ...report,
+      exemptPaths: [...report.exemptPaths],
+    },
+  };
+}
+
+function buildAgentsFreshnessReport(governanceConfig) {
+  const report = evaluateAgentsFreshnessCheck({
+    projectRoot: process.cwd(),
+    config: governanceConfig.aiGovernance.agentsFreshness,
+  });
+  return {
+    exitCode: report.failures.length > 0 ? 1 : 0,
+    report,
+  };
+}
+
 function formatStructureRow(row) {
   if (row.check === "depth") {
     return `${row.file} [rule=${row.ruleId}] depth=${row.depth} base=${row.depthBase} subject=${row.depthSubject} (threshold warn>=${row.warningDepth} error>=${row.errorDepth})`;
@@ -64,42 +130,37 @@ function formatStructureRow(row) {
   return `${row.file} [rule=${row.ruleId}] basename=${row.basename} (forwarding shell outside allowed basename set)`;
 }
 
+function formatContextBudgetRow(row, thresholdPrefix) {
+  return `${row.file} [${row.profile}] lines=${row.lines} bytes=${formatBytes(row.bytes)} max-line=${formatBytes(row.maxLineBytes)} avg-line=${formatBytes(Math.round(row.averageLineBytes))} `
+    + `(${thresholdPrefix} lines>=${row[`${thresholdPrefix}Lines`] ?? "-"} bytes>=${row[`${thresholdPrefix}Bytes`] ?? "-"} max-line>=${row[`${thresholdPrefix}MaxLineBytes`] ?? "-"} avg-line>=${row[`${thresholdPrefix}AverageLineBytes`] ?? "-"})`;
+}
+
 async function runContextBudget(governanceConfig) {
-  const report = evaluateAiContextBudget({
-    cwd: process.cwd(),
-    config: governanceConfig.aiGovernance.contextBudget,
-    configPathLabel: ".nimi/config/governance.yaml#ai_governance.context_budget",
-  });
+  const { exitCode, report } = buildContextBudgetReport(governanceConfig);
 
   process.stdout.write(`ai-context-budget: config=${report.configPath}\n`);
   process.stdout.write(`ai-context-budget: tracked=${report.totalTrackedFiles}, analyzed=${report.analyzedFiles}\n`);
 
   for (const row of report.warnings) {
-    process.stderr.write(
-      `WARN: ${row.file} [${row.profile}] lines=${row.lines} bytes=${formatBytes(row.bytes)} (threshold warn lines>=${row.warningLines ?? "-"} bytes>=${row.warningBytes ?? "-"})\n`,
-    );
+    process.stderr.write(`WARN: ${formatContextBudgetRow(row, "warning")}\n`);
   }
   for (const row of report.waivedErrors) {
     const until = row.waiver?.until ? row.waiver.until.toISOString().slice(0, 10) : "n/a";
     const reason = row.waiver?.reason || "no reason";
-    process.stderr.write(
-      `WARN: WAIVED error for ${row.file} [${row.profile}] lines=${row.lines} bytes=${formatBytes(row.bytes)} until=${until} reason=${reason}\n`,
-    );
+    process.stderr.write(`WARN: WAIVED error for ${formatContextBudgetRow(row, "error")} until=${until} reason=${reason}\n`);
   }
   for (const row of report.expiredWaivers) {
-    process.stderr.write(`ERROR: waiver expired for ${row.file} [${row.profile}] (lines=${row.lines} bytes=${formatBytes(row.bytes)})\n`);
+    process.stderr.write(`ERROR: waiver expired for ${formatContextBudgetRow(row, "error")}\n`);
   }
   for (const row of report.invalidWaivers) {
     process.stderr.write(`ERROR: invalid waiver for ${row.file}: ${row.detail}\n`);
   }
   for (const row of report.errors) {
-    process.stderr.write(
-      `ERROR: ${row.file} [${row.profile}] lines=${row.lines} bytes=${formatBytes(row.bytes)} (threshold error lines>=${row.errorLines ?? "-"} bytes>=${row.errorBytes ?? "-"})\n`,
-    );
+    process.stderr.write(`ERROR: ${formatContextBudgetRow(row, "error")}\n`);
   }
 
-  if (report.invalidWaivers.length > 0 || report.expiredWaivers.length > 0 || report.errors.length > 0) {
-    return 1;
+  if (exitCode !== 0) {
+    return exitCode;
   }
 
   process.stdout.write("ai-context-budget: OK\n");
@@ -107,11 +168,7 @@ async function runContextBudget(governanceConfig) {
 }
 
 async function runStructureBudget(governanceConfig) {
-  const report = evaluateAiStructureBudget({
-    cwd: process.cwd(),
-    config: governanceConfig.aiGovernance.structureBudget,
-    configPathLabel: ".nimi/config/governance.yaml#ai_governance.structure_budget",
-  });
+  const { exitCode, report } = buildStructureBudgetReport(governanceConfig);
 
   process.stdout.write(`ai-structure-budget: config=${report.configPath}\n`);
   process.stdout.write(`ai-structure-budget: tracked=${report.totalTrackedFiles}, analyzed=${report.analyzedFiles}\n`);
@@ -129,8 +186,8 @@ async function runStructureBudget(governanceConfig) {
   for (const row of report.errors) {
     process.stderr.write(`ERROR: ${formatStructureRow(row)}\n`);
   }
-  if (report.errors.length > 0 || report.expiredWaivers.length > 0) {
-    return 1;
+  if (exitCode !== 0) {
+    return exitCode;
   }
 
   process.stdout.write("ai-structure-budget: OK\n");
@@ -138,51 +195,90 @@ async function runStructureBudget(governanceConfig) {
 }
 
 async function runHighRiskDocMetadata(governanceConfig) {
-  const config = governanceConfig.aiGovernance.highRiskDocMetadata;
-  const report = evaluateHighRiskDocMetadata({
-    repoRoot: process.cwd(),
-    docRoots: Array.isArray(config.doc_roots) ? config.doc_roots : [".local"],
-    exemptPaths: Array.isArray(config.exempt_paths) ? config.exempt_paths : [],
-    namePatterns: Array.isArray(config.name_patterns) ? config.name_patterns : [],
-    requiredMetadataKeys: Array.isArray(config.required_metadata_keys)
-      ? config.required_metadata_keys
-      : [],
-  });
+  const { exitCode, report } = buildHighRiskDocMetadataReport(governanceConfig);
 
-  if (report.failures.length > 0) {
+  if (exitCode !== 0) {
     process.stderr.write("high-risk doc metadata check failed:\n");
     for (const failure of report.failures) {
       process.stderr.write(`- ${failure}\n`);
     }
-    return 1;
+    return exitCode;
   }
 
   process.stdout.write(`high-risk doc metadata check passed (${report.scanned.length} file(s) scanned)\n`);
   return 0;
 }
 
+function runJsonScope(governanceConfig, scope) {
+  if (scope === "agents-freshness") {
+    return buildAgentsFreshnessReport(governanceConfig);
+  }
+  if (scope === "context-budget") {
+    return buildContextBudgetReport(governanceConfig);
+  }
+  if (scope === "structure-budget") {
+    return buildStructureBudgetReport(governanceConfig);
+  }
+  if (scope === "high-risk-doc-metadata") {
+    return buildHighRiskDocMetadataReport(governanceConfig);
+  }
+  return {
+    exitCode: 2,
+    report: { error: `unsupported scope: ${scope}` },
+  };
+}
+
 export async function runValidateAiGovernance(args) {
+  const wantsJson = args.includes("--json");
   const parsed = parseOptions(args);
   if (!parsed.ok) {
-    process.stderr.write(localize(parsed.error, parsed.error));
+    if (wantsJson) {
+      writeJson({
+        ok: false,
+        command: "validate-ai-governance",
+        error: parsed.error.trim(),
+      });
+    } else {
+      process.stderr.write(localize(parsed.error, parsed.error));
+    }
     return 2;
   }
 
   const governance = await loadGovernanceConfig(process.cwd());
   if (!governance.ok) {
-    process.stderr.write(localize(
-      `nimicoding validate-ai-governance refused: ${governance.reason} at ${governance.path}.\n`,
-      `nimicoding validate-ai-governance 已拒绝：${governance.path} 的治理配置不可用。\n`,
-    ));
+    const error = `nimicoding validate-ai-governance refused: ${governance.reason} at ${governance.path}.`;
+    if (parsed.options.json) {
+      writeJson({
+        ok: false,
+        command: "validate-ai-governance",
+        error,
+        governancePath: governance.path,
+      });
+    } else {
+      process.stderr.write(localize(
+        `${error}\n`,
+        `nimicoding validate-ai-governance 已拒绝：${governance.path} 的治理配置不可用。\n`,
+      ));
+    }
     return 2;
   }
 
   const profileCheck = requireProfile(governance.config, parsed.options.profile);
   if (!profileCheck.ok) {
-    process.stderr.write(localize(
-      `nimicoding validate-ai-governance refused: ${profileCheck.error}.\n`,
-      `nimicoding validate-ai-governance 已拒绝：${profileCheck.error}。\n`,
-    ));
+    const error = `nimicoding validate-ai-governance refused: ${profileCheck.error}.`;
+    if (parsed.options.json) {
+      writeJson({
+        ok: false,
+        command: "validate-ai-governance",
+        error,
+        profile: profileCheck.profile,
+      });
+    } else {
+      process.stderr.write(localize(
+        `${error}\n`,
+        `nimicoding validate-ai-governance 已拒绝：${profileCheck.error}。\n`,
+      ));
+    }
     return 2;
   }
 
@@ -190,6 +286,31 @@ export async function runValidateAiGovernance(args) {
     ? ["agents-freshness", "context-budget", "structure-budget", "high-risk-doc-metadata"]
     : [parsed.options.scope];
 
+  if (parsed.options.json) {
+    const results = [];
+    let exitCode = 0;
+    for (const scope of scopes) {
+      const result = runJsonScope(governance.config, scope);
+      if (exitCode === 0 && result.exitCode !== 0) {
+        exitCode = result.exitCode;
+      }
+      results.push({
+        scope,
+        ok: result.exitCode === 0,
+        exitCode: result.exitCode,
+        report: result.report,
+      });
+    }
+    writeJson({
+      ok: exitCode === 0,
+      command: "validate-ai-governance",
+      profile: profileCheck.profile,
+      scope: parsed.options.scope,
+      scopes: results,
+    });
+    return exitCode;
+  }
+
   for (const scope of scopes) {
     let exitCode = 0;
     if (scope === "agents-freshness") {

package/cli/commands/validate-domain-admission.mjs

@@ -0,0 +1,5 @@
+import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
+
+export function runValidateDomainAdmission(args) {
+  return runSurfaceValidatorCommand(args, "validate-domain-admission");
+}

package/cli/commands/validate-guidance-bodies.mjs

@@ -0,0 +1,5 @@
+import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
+
+export function runValidateGuidanceBodies(args) {
+  return runSurfaceValidatorCommand(args, "validate-guidance-bodies");
+}

package/cli/commands/validate-placement.mjs

@@ -0,0 +1,5 @@
+import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
+
+export function runValidatePlacement(args) {
+  return runSurfaceValidatorCommand(args, "validate-placement");
+}

package/cli/commands/validate-projection-edges.mjs

@@ -0,0 +1,5 @@
+import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
+
+export function runValidateProjectionEdges(args) {
+  return runSurfaceValidatorCommand(args, "validate-projection-edges");
+}

package/cli/commands/validate-spec-audit.mjs

@@ -1,11 +1,15 @@
 import path from "node:path";
 
 import { validateSpecAudit, buildValidatorCliReport } from "../lib/validators.mjs";
+import { loadSpecGenerationInputsConfig } from "../lib/contracts.mjs";
 import { localize } from "../lib/ui.mjs";
 
 export async function runValidateSpecAudit(args) {
   const normalized = args[0] === "--" ? args.slice(1) : args;
-  let targetPath = ".nimi/spec/_meta/spec-generation-audit.yaml";
+  const generationInputs = await loadSpecGenerationInputsConfig(process.cwd());
+  let targetPath = generationInputs.ok && generationInputs.mode === "class_filtered"
+    ? ".nimi/local/state/spec-generation/spec-generation-audit.yaml"
+    : ".nimi/spec/_meta/spec-generation-audit.yaml";
 
   if (normalized.length > 1) {
     process.stderr.write(localize(

package/cli/commands/validate-table-family.mjs

@@ -0,0 +1,5 @@
+import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
+
+export function runValidateTableFamily(args) {
+  return runSurfaceValidatorCommand(args, "validate-table-family");
+}

package/cli/commands/validate-tracked-output-admission.mjs

@@ -0,0 +1,5 @@
+import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
+
+export function runValidateTrackedOutputAdmission(args) {
+  return runSurfaceValidatorCommand(args, "validate-tracked-output-admission");
+}

package/cli/constants.mjs

@@ -1,4 +1,4 @@
-export const VERSION = "0.1.0";
+export const VERSION = "0.2.0";
 export const PACKAGE_NAME = "@nimiplatform/nimi-coding";
 export const BOOTSTRAP_CONTRACT_ID = "nimicoding.bootstrap";
 export const BOOTSTRAP_CONTRACT_VERSION = 1;
@@ -18,6 +18,8 @@ export const STANDALONE_COMPLETED_SURFACES = [
   "bootstrap",
   "doctor",
   "handoff",
+  "sweep_audit",
+  "sweep_design",
   "validators",
   "topic_lifecycle_report_methodology",
   "closeout",
@@ -51,6 +53,7 @@ export const CLAUDE_END = "<!-- nimicoding:managed:claude:end -->";
 export const SPEC_RECONSTRUCTION_RESULT_CONTRACT_REF = ".nimi/contracts/spec-reconstruction-result.yaml";
 export const DOC_SPEC_AUDIT_RESULT_CONTRACT_REF = ".nimi/contracts/doc-spec-audit-result.yaml";
 export const AUDIT_SWEEP_RESULT_CONTRACT_REF = ".nimi/contracts/audit-sweep-result.yaml";
+export const SWEEP_DESIGN_RESULT_CONTRACT_REF = ".nimi/contracts/sweep-design-result.yaml";
 export const AUDIT_PLAN_SCHEMA_REF = ".nimi/contracts/audit-plan.schema.yaml";
 export const AUDIT_CHUNK_SCHEMA_REF = ".nimi/contracts/audit-chunk.schema.yaml";
 export const AUDIT_FINDING_SCHEMA_REF = ".nimi/contracts/audit-finding.schema.yaml";
@@ -260,7 +263,7 @@ export const DOC_SPEC_AUDIT_DEFAULT_COMPARED_PATHS = [
 ];
 
 export const SPEC_TREE_MODEL_REF = ".nimi/spec/_meta/spec-tree-model.yaml";
-export const BLUEPRINT_REFERENCE_REF = ".nimi/spec/_meta/blueprint-reference.yaml";
+export const BLUEPRINT_REFERENCE_REF = ".nimi/local/state/spec-generation/blueprint-reference.yaml";
 export const COMMAND_GATING_MATRIX_REF = ".nimi/spec/_meta/command-gating-matrix.yaml";
 export const GENERATE_DRIFT_MIGRATION_CHECKLIST_REF = ".nimi/spec/_meta/generate-drift-migration-checklist.yaml";
 export const GOVERNANCE_ROUTING_CUTOVER_CHECKLIST_REF = ".nimi/spec/_meta/governance-routing-cutover-checklist.yaml";
@@ -277,53 +280,6 @@ export const SKILL_RESULT_CONTRACT_REFS = {
   high_risk_execution: HIGH_RISK_EXECUTION_RESULT_CONTRACT_REF,
 };
 
-export const REQUIRED_BOOTSTRAP_FILES = [
-  ".nimi/methodology/core.yaml",
-  ".nimi/methodology/spec-reconstruction.yaml",
-  ".nimi/methodology/skill-runtime.yaml",
-  ".nimi/methodology/skill-installer-result.yaml",
-  ".nimi/methodology/skill-installer-summary-projection.yaml",
-  ".nimi/methodology/skill-exchange-projection.yaml",
-  ".nimi/methodology/skill-handoff.yaml",
-  SPEC_TREE_MODEL_REF,
-  COMMAND_GATING_MATRIX_REF,
-  GENERATE_DRIFT_MIGRATION_CHECKLIST_REF,
-  GOVERNANCE_ROUTING_CUTOVER_CHECKLIST_REF,
-  PHASE2_IMPACTED_SURFACE_MATRIX_REF,
-  ".nimi/spec/product-scope.yaml",
-  ".nimi/spec/bootstrap-state.yaml",
-  ".nimi/config/bootstrap.yaml",
-  ".nimi/config/skills.yaml",
-  ".nimi/config/skill-manifest.yaml",
-  SPEC_GENERATION_INPUTS_REF,
-  ".nimi/config/host-profile.yaml",
-  HOST_ADAPTER_CONFIG_REF,
-  EXTERNAL_EXECUTION_ARTIFACTS_CONFIG_REF,
-  AUDIT_EXECUTION_ARTIFACTS_CONFIG_REF,
-  ".nimi/config/skill-installer.yaml",
-  ".nimi/config/installer-evidence.yaml",
-  SPEC_RECONSTRUCTION_RESULT_CONTRACT_REF,
-  DOC_SPEC_AUDIT_RESULT_CONTRACT_REF,
-  AUDIT_SWEEP_RESULT_CONTRACT_REF,
-  AUDIT_PLAN_SCHEMA_REF,
-  AUDIT_CHUNK_SCHEMA_REF,
-  AUDIT_FINDING_SCHEMA_REF,
-  AUDIT_LEDGER_SCHEMA_REF,
-  AUDIT_REMEDIATION_MAP_SCHEMA_REF,
-  AUDIT_RERUN_SCHEMA_REF,
-  AUDIT_CLOSEOUT_SCHEMA_REF,
-  HIGH_RISK_EXECUTION_RESULT_CONTRACT_REF,
-  HIGH_RISK_ADMISSION_CONTRACT_REF,
-  SPEC_GENERATION_INPUTS_CONTRACT_REF,
-  SPEC_GENERATION_AUDIT_CONTRACT_REF,
-  EXTERNAL_HOST_COMPATIBILITY_CONTRACT_REF,
-  EXECUTION_PACKET_SCHEMA_REF,
-  ORCHESTRATION_STATE_SCHEMA_REF,
-  PROMPT_SCHEMA_REF,
-  WORKER_OUTPUT_SCHEMA_REF,
-  ACCEPTANCE_SCHEMA_REF,
-];
-
 export const REQUIRED_LOCAL_DIRS = [".nimi/local", ".nimi/cache"];
 
 export const REQUIRED_BOOTSTRAP_DIRS = [