@nimiplatform/nimi-coding 0.1.0 → 0.2.1

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.1";
 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 = [

package/cli/help.mjs

@@ -18,6 +18,7 @@ export function helpText() {
     `  ${styleCommand("nimicoding start --host <generic|codex|claude|oh-my-codex>")}`,
     `  ${styleCommand("nimicoding clear")}`,
     `  ${styleCommand("nimicoding clear --yes")}`,
+    `  ${styleCommand("nimicoding sync [--apply|--check|--dry-run] [--json]")}`,
     `  ${styleCommand("nimicoding topic create <slug> --justification <text> [--title <text>] [--json]")}`,
     `  ${styleCommand("nimicoding topic status [<topic-id>|<topic-path>] [--json]")}`,
     `  ${styleCommand("nimicoding topic run-next-step <topic-id> [--json]")}`,
@@ -49,17 +50,26 @@ export function helpText() {
     `  ${styleCommand("nimicoding handoff --skill <skill-id>")}`,
     `  ${styleCommand("nimicoding handoff --skill <skill-id> --json")}`,
     `  ${styleCommand("nimicoding handoff --skill <skill-id> --prompt")}`,
-    `  ${styleCommand("nimicoding audit-sweep plan --root <dir> [--criteria <csv>] [--exclude <csv>] [--max-files <n>] [--sweep-id <id>] [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep chunk dispatch --sweep-id <id> --chunk-id <chunk-id> --dispatched-at <iso8601> [--auditor <id>] [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep chunk audit-codex --sweep-id <id> --chunk-id <chunk-id> --dispatched-at <iso8601> --verified-at <iso8601> --reviewed-at <iso8601> [--from-raw-output <ref>] [--timeout-ms <ms>] [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep chunk ingest --sweep-id <id> --chunk-id <chunk-id> --from <json> --verified-at <iso8601> [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep chunk review --sweep-id <id> --chunk-id <chunk-id> --verdict <pass|fail> --reviewed-at <iso8601> [--summary <text>] [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep chunk skip --sweep-id <id> --chunk-id <chunk-id> --reason <text> --skipped-at <iso8601> [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep ledger build --sweep-id <id> [--verified-at <iso8601>] [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep remediation-map build --sweep-id <id> [--max-findings <n>] [--verified-at <iso8601>] [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep finding resolve --sweep-id <id> --finding-id <id> --disposition <remediated|accepted-risk|false-positive|deferred-backlog> --from <json> --verified-at <iso8601> [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep closeout summary --sweep-id <id> --verified-at <iso8601> [--json]")}`,
-    `  ${styleCommand("nimicoding audit-sweep status --sweep-id <id> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit plan --root <dir> [--criteria <csv>] [--exclude <csv>] [--max-files <n>] [--sweep-id <id>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit chunk dispatch --sweep-id <id> --chunk-id <chunk-id> --dispatched-at <iso8601> [--auditor <id>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit chunk audit-codex --sweep-id <id> --chunk-id <chunk-id> --dispatched-at <iso8601> --verified-at <iso8601> --reviewed-at <iso8601> [--from-raw-output <ref>] [--timeout-ms <ms>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit chunk ingest --sweep-id <id> --chunk-id <chunk-id> --from <json> --verified-at <iso8601> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit chunk review --sweep-id <id> --chunk-id <chunk-id> --verdict <pass|fail> --reviewed-at <iso8601> [--summary <text>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit chunk skip --sweep-id <id> --chunk-id <chunk-id> --reason <text> --skipped-at <iso8601> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit ledger build --sweep-id <id> [--verified-at <iso8601>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit remediation-map build --sweep-id <id> [--max-findings <n>] [--verified-at <iso8601>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit finding resolve --sweep-id <id> --finding-id <id> --disposition <remediated|accepted-risk|false-positive|deferred-backlog> --from <json> --verified-at <iso8601> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit closeout summary --sweep-id <id> --verified-at <iso8601> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep audit status --sweep-id <id> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design intake --sweep-id <id> [--run-id <id>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design packet-build --run-id <id> --packet-id <id> (--finding-id <id>|--finding-ids <csv>) [--explicit-question <text>] [--prior-design-state-refs <csv>] [--prior-design-state-marker <state>] [--current-cluster-refs <csv>] [--current-wave-refs <csv>] [--authority-only] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design packet-build-batch --run-id <id> --batch-size <n> [--finding-ids <csv>] [--packet-prefix <id>] [--manifest-id <id>] [--explicit-question <text>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design auditor-prompt --run-id <id> --packet-id <id> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design result-ingest --run-id <id> --from <yaml> [--mode <focused|all>] [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design ledger-validate --run-id <id> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design finalize --run-id <id> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design wave-plan --run-id <id> --topic-id <id> [--json]")}`,
+    `  ${styleCommand("nimicoding sweep design fix-topic --run-id <id> [--slug <slug>] [--title <title>] [--admit-first-wave|--admit-wave-id <id>] [--json]")}`,
     `  ${styleCommand("nimicoding admit-high-risk-decision --from <json> --admitted-at <iso8601> [--json] [--write-spec]")}`,
     `  ${styleCommand("nimicoding closeout --skill <skill-id> --outcome <completed|blocked|failed> --verified-at <iso8601>")}`,
     `  ${styleCommand("nimicoding closeout --skill <skill-id> --outcome <completed|blocked|failed> --verified-at <iso8601> --json")}`,
@@ -73,6 +83,14 @@ export function helpText() {
     `  ${styleCommand("nimicoding validate-spec-governance --profile <profile-id> --scope <all|host-defined-scope>")}`,
     `  ${styleCommand("nimicoding validate-spec-audit [.nimi/spec/_meta/spec-generation-audit.yaml]")}`,
     `  ${styleCommand("nimicoding validate-spec-tree [.nimi/spec]")}`,
+    `  ${styleCommand("nimicoding classify-spec-tree --profile <profile-id> --root .nimi/spec [--emit <path>] [--json]")}`,
+    `  ${styleCommand("nimicoding generate-spec-migration-plan --profile <profile-id> --root .nimi/spec --emit .nimi/local/state/spec-surface/migration-plan.json [--json]")}`,
+    `  ${styleCommand("nimicoding validate-placement --profile <profile-id> --root .nimi/spec [--json]")}`,
+    `  ${styleCommand("nimicoding validate-table-family --profile <profile-id> --root .nimi/spec [--json]")}`,
+    `  ${styleCommand("nimicoding validate-projection-edges --profile <profile-id> --root .nimi/spec [--json]")}`,
+    `  ${styleCommand("nimicoding validate-guidance-bodies --profile <profile-id> --root .nimi/spec [--json]")}`,
+    `  ${styleCommand("nimicoding validate-domain-admission --profile <profile-id> --root .nimi/spec [--json]")}`,
+    `  ${styleCommand("nimicoding validate-tracked-output-admission --profile <profile-id> --root .nimi/spec [--json]")}`,
     `  ${styleCommand("nimicoding generate-spec-derived-docs --profile <profile-id> --scope <all|host-defined-scope> [--check]")}`,
     `  ${styleCommand("nimicoding validate-ai-governance --profile <profile-id> --scope <all|agents-freshness|context-budget|structure-budget|high-risk-doc-metadata>")}`,
     `  ${styleCommand("nimicoding validate-prompt <path>")}`,
@@ -108,6 +126,10 @@ export function helpText() {
       "  - `nimicoding clear` does not remove .nimi/spec, .nimi/local, or .nimi/cache for you",
       "  - `nimicoding clear` 不会替你移除 .nimi/spec、.nimi/local 或 .nimi/cache",
     )),
+    styleMuted(localize(
+      "  - `nimicoding sync` is the package-owned seed projection contract: --apply rewrites drifted package_canonical files and seeds missing entries; --check exits non-zero on package_canonical drift or any missing seed; host-owned seed entries are seeded once and never overwritten",
+      "  - `nimicoding sync` 是 package 拥有的 seed 投影契约：--apply 会刷新 drifted package_canonical 文件并补齐缺失 seed；--check 在 package_canonical drift 或 seed 缺失时退出非零；host-owned seed 条目仅初始化一次，之后永不覆盖",
+    )),
     styleMuted(localize(
       "  - `nimicoding doctor` shows the user-facing summary; add `--verbose` for internal contract detail",
       "  - `nimicoding doctor` 默认显示用户视图；加 `--verbose` 可查看内部契约细节",

package/cli/index.mjs

@@ -2,23 +2,32 @@ import { runBlueprintAudit } from "./commands/blueprint-audit.mjs";
 import { runClear } from "./commands/clear.mjs";
 import { runCloseout } from "./commands/closeout.mjs";
 import { runAdmitHighRiskDecision } from "./commands/admit-high-risk-decision.mjs";
-import { runAuditSweep } from "./commands/audit-sweep.mjs";
+import { runSweep } from "./commands/sweep.mjs";
 import { runDecideHighRiskExecution } from "./commands/decide-high-risk-execution.mjs";
 import { runDoctor } from "./commands/doctor.mjs";
 import { runHandoff } from "./commands/handoff.mjs";
 import { runIngestHighRiskExecution } from "./commands/ingest-high-risk-execution.mjs";
 import { runReviewHighRiskExecution } from "./commands/review-high-risk-execution.mjs";
 import { runStart } from "./commands/start.mjs";
+import { runSync } from "./commands/sync.mjs";
 import { runTopic } from "./commands/topic.mjs";
 import { runTopicRunnerCommand } from "./commands/topic-runner.mjs";
 import { runValidateAcceptance } from "./commands/validate-acceptance.mjs";
 import { runGenerateSpecDerivedDocs } from "./commands/generate-spec-derived-docs.mjs";
+import { runGenerateSpecMigrationPlan } from "./commands/generate-spec-migration-plan.mjs";
+import { runClassifySpecTree } from "./commands/classify-spec-tree.mjs";
 import { runValidateAiGovernance } from "./commands/validate-ai-governance.mjs";
+import { runValidateDomainAdmission } from "./commands/validate-domain-admission.mjs";
 import { runValidateExecutionPacket } from "./commands/validate-execution-packet.mjs";
+import { runValidateGuidanceBodies } from "./commands/validate-guidance-bodies.mjs";
 import { runValidateOrchestrationState } from "./commands/validate-orchestration-state.mjs";
+import { runValidatePlacement } from "./commands/validate-placement.mjs";
+import { runValidateProjectionEdges } from "./commands/validate-projection-edges.mjs";
 import { runValidateSpecGovernance } from "./commands/validate-spec-governance.mjs";
 import { runValidateSpecAudit } from "./commands/validate-spec-audit.mjs";
 import { runValidateSpecTree } from "./commands/validate-spec-tree.mjs";
+import { runValidateTableFamily } from "./commands/validate-table-family.mjs";
+import { runValidateTrackedOutputAdmission } from "./commands/validate-tracked-output-admission.mjs";
 import { runValidatePrompt } from "./commands/validate-prompt.mjs";
 import { runValidateWorkerOutput } from "./commands/validate-worker-output.mjs";
 import { helpText } from "./help.mjs";
@@ -27,6 +36,7 @@ import { VERSION } from "./constants.mjs";
 
 const COMMANDS = {
   start: runStart,
+  sync: runSync,
   topic: runTopic,
   "topic-runner": runTopicRunnerCommand,
   clear: runClear,
@@ -34,7 +44,7 @@ const COMMANDS = {
   "blueprint-audit": runBlueprintAudit,
   handoff: runHandoff,
   closeout: runCloseout,
-  "audit-sweep": runAuditSweep,
+  sweep: runSweep,
   "admit-high-risk-decision": runAdmitHighRiskDecision,
   "decide-high-risk-execution": runDecideHighRiskExecution,
   "ingest-high-risk-execution": runIngestHighRiskExecution,
@@ -44,7 +54,15 @@ const COMMANDS = {
   "validate-spec-governance": runValidateSpecGovernance,
   "validate-spec-audit": runValidateSpecAudit,
   "validate-spec-tree": runValidateSpecTree,
+  "classify-spec-tree": runClassifySpecTree,
+  "validate-placement": runValidatePlacement,
+  "validate-table-family": runValidateTableFamily,
+  "validate-projection-edges": runValidateProjectionEdges,
+  "validate-guidance-bodies": runValidateGuidanceBodies,
+  "validate-domain-admission": runValidateDomainAdmission,
+  "validate-tracked-output-admission": runValidateTrackedOutputAdmission,
   "generate-spec-derived-docs": runGenerateSpecDerivedDocs,
+  "generate-spec-migration-plan": runGenerateSpecMigrationPlan,
   "validate-ai-governance": runValidateAiGovernance,
   "validate-prompt": runValidatePrompt,
   "validate-worker-output": runValidateWorkerOutput,