@nimiplatform/nimi-coding 0.2.8 → 0.3.0

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

@@ -1,15 +1,11 @@
 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;
-  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";
+  let targetPath = ".nimi/local/state/spec-generation/spec-generation-audit.yaml";
 
   if (normalized.length > 1) {
     process.stderr.write(localize(

package/cli/constants.mjs

@@ -1,143 +1,21 @@
-export const VERSION = "0.2.8";
+export const VERSION = "0.3.0";
 export const PACKAGE_NAME = "@nimiplatform/nimi-coding";
 export const BOOTSTRAP_CONTRACT_ID = "nimicoding.bootstrap";
-export const BOOTSTRAP_CONTRACT_VERSION = 1;
-export const HANDOFF_PAYLOAD_CONTRACT_VERSION = "nimicoding.handoff.v1";
-export const CLOSEOUT_PAYLOAD_CONTRACT_VERSION = "nimicoding.closeout.v1";
-export const HIGH_RISK_INGEST_PAYLOAD_CONTRACT_VERSION = "nimicoding.high-risk-ingest.v1";
-export const HIGH_RISK_REVIEW_PAYLOAD_CONTRACT_VERSION = "nimicoding.high-risk-review.v1";
-export const HIGH_RISK_DECISION_PAYLOAD_CONTRACT_VERSION = "nimicoding.high-risk-decision.v1";
-export const HIGH_RISK_ADMISSION_PAYLOAD_CONTRACT_VERSION = "nimicoding.high-risk-admission.v1";
-export const STANDALONE_COMPLETION_PROFILE = "boundary_complete";
-export const STANDALONE_COMPLETION_STATUS = {
-  COMPLETE: "complete",
-  DRIFTED: "drifted",
-  INCOMPLETE: "incomplete",
-};
-export const STANDALONE_COMPLETED_SURFACES = [
-  "bootstrap",
-  "doctor",
-  "handoff",
-  "sweep_audit",
-  "sweep_design",
-  "validators",
-  "topic_lifecycle_report_methodology",
-  "closeout",
-  "ingest",
-  "review",
-  "decision",
-  "admission",
-  "host_overlay_recognition",
-];
-export const STANDALONE_DEFERRED_EXECUTION_SURFACES = [
-  "packet_bound_run_kernel",
-  "provider_backed_execution",
-  "scheduler",
-  "notification",
-  "automation_backend",
-  "multi_topic_orchestration",
-];
-export const STANDALONE_PROMOTED_PARITY_GAP_SUMMARY = [
-  "packet_bound_run_kernel",
-  "provider_backed_execution",
-  "scheduler_automation_notification",
-];
+export const BOOTSTRAP_CONTRACT_VERSION = 2;
 
-export const LOCAL_GITIGNORE_ENTRIES = [".nimi/local/", ".nimi/cache/", ".nimi/topics/"];
+export const LOCAL_GITIGNORE_ENTRIES = [".nimi/local/", ".nimi/cache/"];
+export const REQUIRED_LOCAL_DIRS = [".nimi/local", ".nimi/cache"];
 
 export const AGENTS_BEGIN = "<!-- nimicoding:managed:agents:start -->";
 export const AGENTS_END = "<!-- nimicoding:managed:agents:end -->";
 export const CLAUDE_BEGIN = "<!-- nimicoding:managed:claude:start -->";
 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";
-export const AUDIT_LEDGER_SCHEMA_REF = ".nimi/contracts/audit-ledger.schema.yaml";
-export const AUDIT_REMEDIATION_MAP_SCHEMA_REF = ".nimi/contracts/audit-remediation-map.schema.yaml";
-export const AUDIT_RERUN_SCHEMA_REF = ".nimi/contracts/audit-rerun.schema.yaml";
-export const AUDIT_CLOSEOUT_SCHEMA_REF = ".nimi/contracts/audit-closeout.schema.yaml";
-export const HIGH_RISK_EXECUTION_RESULT_CONTRACT_REF = ".nimi/contracts/high-risk-execution-result.yaml";
-export const HIGH_RISK_ADMISSION_CONTRACT_REF = ".nimi/contracts/high-risk-admission.schema.yaml";
-export const EXTERNAL_HOST_COMPATIBILITY_CONTRACT_REF = ".nimi/contracts/external-host-compatibility.yaml";
-export const HOST_ADAPTER_CONFIG_REF = ".nimi/config/host-adapter.yaml";
-export const EXTERNAL_EXECUTION_ARTIFACTS_CONFIG_REF = ".nimi/config/external-execution-artifacts.yaml";
-export const AUDIT_EXECUTION_ARTIFACTS_CONFIG_REF = ".nimi/config/audit-execution-artifacts.yaml";
-export const EXECUTION_PACKET_SCHEMA_REF = ".nimi/contracts/execution-packet.schema.yaml";
-export const ORCHESTRATION_STATE_SCHEMA_REF = ".nimi/contracts/orchestration-state.schema.yaml";
-export const PROMPT_SCHEMA_REF = ".nimi/contracts/prompt.schema.yaml";
-export const WORKER_OUTPUT_SCHEMA_REF = ".nimi/contracts/worker-output.schema.yaml";
-export const ACCEPTANCE_SCHEMA_REF = ".nimi/contracts/acceptance.schema.yaml";
-export const ADAPTER_PACKAGE_PROFILE_REFS = {
-  codex: "adapters/codex/profile.yaml",
-  oh_my_codex: "adapters/oh-my-codex/profile.yaml",
-  claude: "adapters/claude/profile.yaml",
-};
-export const EXTERNAL_HOST_COMPATIBILITY_REQUIRED_BEHAVIOR = [
-  "consume_handoff_json_as_authoritative_contract",
-  "treat_handoff_prompt_as_human_projection_only",
-  "read_project_local_nimi_truth",
-  "route_declared_external_skills",
-  "fail_closed_on_missing_authority",
-];
-export const EXTERNAL_HOST_COMPATIBILITY_SUPPORTED_POSTURE = [
-  "host_agnostic_external_host",
-];
-export const EXTERNAL_HOST_COMPATIBILITY_FORBIDDEN_BEHAVIOR = [
-  "assume_packaged_run_kernel",
-  "assume_provider_or_scheduler_ownership",
-  "promote_runtime_state_to_semantic_truth",
-  "redefine_acceptance_disposition_or_finding_judgment",
-];
-export const EXTERNAL_HOST_COMPATIBILITY_SUPPORTED_HOST_EXAMPLES = [
-  "oh_my_codex",
-  "codex",
-  "claude",
-  "gemini",
-];
-
-export const HIGH_RISK_ADMISSION_REQUIRED_TOP_LEVEL_KEYS = [
-  "admissions",
-  "admission_rules",
-  "semantic_constraints",
-];
-
-export const HIGH_RISK_ADMISSION_RECORD_REQUIRED_FIELDS = [
-  "topic_id",
-  "packet_id",
-  "disposition",
-  "admitted_at",
-  "manager_review_owner",
-  "summary",
-  "source_decision_contract",
-];
-
-export const HIGH_RISK_ADMISSION_DISPOSITION_ENUM = [
-  "complete",
-  "partial",
-  "deferred",
-];
-
-export const SPEC_RECONSTRUCTION_SUMMARY_REQUIRED_FIELDS = [
-  "generated_paths",
-  "audit_ref",
-  "coverage_summary",
-  "unresolved_file_count",
-  "inferred_file_count",
-  "status",
-  "summary",
-  "verified_at",
-];
-
-export const SPEC_RECONSTRUCTION_SUMMARY_STATUS = [
-  "reconstructed",
-  "partial",
-  "blocked",
-];
+export const SPEC_GENERATION_AUDIT_REF = ".nimi/local/state/spec-generation/spec-generation-audit.yaml";
+export const SPEC_GENERATION_AUDIT_CONTRACT_REF = ".nimi/contracts/spec-generation-audit.schema.yaml";
+export const SPEC_GENERATION_INPUTS_REF = ".nimi/config/spec-generation-inputs.yaml";
+export const SPEC_GENERATION_INPUTS_CONTRACT_REF = ".nimi/contracts/spec-generation-inputs.schema.yaml";
+export const BLUEPRINT_REFERENCE_REF = ".nimi/local/state/spec-generation/blueprint-reference.yaml";
 
 export const SPEC_GENERATION_AUDIT_REQUIRED_TOP_LEVEL_FIELDS = [
   "generation_mode",
@@ -146,16 +24,6 @@ export const SPEC_GENERATION_AUDIT_REQUIRED_TOP_LEVEL_FIELDS = [
   "input_roots",
   "files",
 ];
-
-export const SPEC_GENERATION_AUDIT_FILE_REQUIRED_FIELDS = [
-  "canonical_path",
-  "file_class",
-  "source_refs",
-  "source_basis",
-  "coverage_status",
-  "unresolved_items",
-];
-
 export const SPEC_GENERATION_AUDIT_SOURCE_BASIS_ENUM = [
   "grounded",
   "mixed_grounded_and_inferred",
@@ -167,279 +35,3 @@ export const SPEC_GENERATION_AUDIT_COVERAGE_STATUS_ENUM = [
   "partial",
   "placeholder_not_allowed",
 ];
-
-export const DOC_SPEC_AUDIT_SUMMARY_REQUIRED_FIELDS = [
-  "compared_paths",
-  "finding_count",
-  "status",
-  "summary",
-  "verified_at",
-];
-
-export const DOC_SPEC_AUDIT_SUMMARY_STATUS = [
-  "aligned",
-  "drift_detected",
-  "blocked",
-];
-
-export const AUDIT_SWEEP_SUMMARY_REQUIRED_FIELDS = [
-  "plan_ref",
-  "chunk_refs",
-  "ledger_ref",
-  "report_ref",
-  "remediation_map_ref",
-  "audit_closeout_ref",
-  "evidence_refs",
-  "finding_count",
-  "unresolved_finding_count",
-  "status",
-  "coverage_scope",
-  "coverage_quality",
-  "audit_validity",
-  "summary",
-  "verified_at",
-];
-
-export const AUDIT_SWEEP_SUMMARY_STATUS = [
-  "candidate_ready",
-  "partial",
-  "partial_authority_only",
-  "blocked_evidence_incomplete",
-  "blocked",
-];
-
-export const HIGH_RISK_EXECUTION_SUMMARY_REQUIRED_FIELDS = [
-  "packet_ref",
-  "orchestration_state_ref",
-  "prompt_ref",
-  "worker_output_ref",
-  "evidence_refs",
-  "status",
-  "summary",
-  "verified_at",
-];
-
-export const HIGH_RISK_EXECUTION_SUMMARY_STATUS = [
-  "candidate_ready",
-  "blocked",
-  "failed",
-];
-
-export const HIGH_RISK_EXECUTION_ARTIFACT_ROOTS = {
-  packet_ref: ".nimi/local/packets",
-  orchestration_state_ref: ".nimi/local/orchestration",
-  prompt_ref: ".nimi/local/prompts",
-  worker_output_ref: ".nimi/local/outputs",
-  evidence_refs: ".nimi/local/evidence",
-};
-
-export const AUDIT_SWEEP_ARTIFACT_ROOTS = {
-  plan_ref: ".nimi/local/audit/plans",
-  chunk_refs: ".nimi/local/audit/chunks",
-  ledger_ref: ".nimi/local/audit/ledgers",
-  report_ref: ".nimi/local/audit/reports",
-  remediation_map_ref: ".nimi/local/audit/remediation-maps",
-  audit_closeout_ref: ".nimi/local/audit/closeouts",
-  packet_ref: ".nimi/local/audit/packets",
-  evidence_refs: ".nimi/local/audit/evidence",
-  run_ledger_ref: ".nimi/local/audit/runs",
-};
-
-export const HIGH_RISK_EXECUTION_ARTIFACT_HARD_CONSTRAINTS = [
-  "external_execution_artifacts_remain_operational_only",
-  "imported_refs_must_stay_under_declared_local_roots",
-  "candidate_artifacts_must_not_override_semantic_truth",
-];
-
-export const AUDIT_SWEEP_ARTIFACT_HARD_CONSTRAINTS = [
-  "audit_execution_artifacts_remain_operational_only",
-  "imported_refs_must_stay_under_declared_local_roots",
-  "candidate_artifacts_must_not_override_semantic_truth",
-];
-
-export const DOC_SPEC_AUDIT_DEFAULT_COMPARED_PATHS = [
-  "README.md",
-  ".nimi/spec",
-];
-
-export const SPEC_TREE_MODEL_REF = ".nimi/spec/_meta/spec-tree-model.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";
-export const PHASE2_IMPACTED_SURFACE_MATRIX_REF = ".nimi/spec/_meta/phase2-impacted-surface-matrix.yaml";
-export const SPEC_GENERATION_AUDIT_REF = ".nimi/spec/_meta/spec-generation-audit.yaml";
-export const SPEC_GENERATION_INPUTS_REF = ".nimi/config/spec-generation-inputs.yaml";
-export const SPEC_GENERATION_INPUTS_CONTRACT_REF = ".nimi/contracts/spec-generation-inputs.schema.yaml";
-export const SPEC_GENERATION_AUDIT_CONTRACT_REF = ".nimi/contracts/spec-generation-audit.schema.yaml";
-
-export const SKILL_RESULT_CONTRACT_REFS = {
-  spec_reconstruction: SPEC_RECONSTRUCTION_RESULT_CONTRACT_REF,
-  doc_spec_audit: DOC_SPEC_AUDIT_RESULT_CONTRACT_REF,
-  audit_sweep: AUDIT_SWEEP_RESULT_CONTRACT_REF,
-  high_risk_execution: HIGH_RISK_EXECUTION_RESULT_CONTRACT_REF,
-};
-
-export const REQUIRED_LOCAL_DIRS = [".nimi/local", ".nimi/cache"];
-
-export const REQUIRED_BOOTSTRAP_DIRS = [
-  ".nimi/methodology",
-  ".nimi/spec",
-  ".nimi/config",
-  ".nimi/contracts",
-  ".nimi/local",
-  ".nimi/cache",
-];
-
-export const HIGH_RISK_SCHEMA_SPECS = {
-  [EXECUTION_PACKET_SCHEMA_REF]: {
-    id: "nimi-coding.execution-packet.v1",
-    kind: "execution-packet",
-    listFields: {
-      required: [
-        "packet_id",
-        "topic_id",
-        "status",
-        "owner",
-        "created_at",
-        "updated_at",
-        "baseline_ref",
-        "entry_phase_id",
-        "phases",
-        "escalation_policy",
-        "notification_settings",
-        "resume_policy",
-      ],
-      status_enum: ["draft", "frozen", "superseded", "archived"],
-      phase_required: [
-        "phase_id",
-        "goal",
-        "authority_refs",
-        "write_scope",
-        "read_scope",
-        "required_checks",
-        "completion_criteria",
-        "escalation_conditions",
-        "next_on_success",
-        "stop_on_failure",
-      ],
-      phase_stop_on_failure_enum: ["pause", "stop"],
-      escalation_policy_required: ["pause_conditions", "manager_decision_required"],
-      notification_settings_required: ["on_block", "on_final_completion", "on_progress"],
-      resume_policy_required: ["same_revision_resume_allowed_reasons", "new_packet_required_on"],
-    },
-    requiredRules: [
-      "baseline_ref must resolve to a baseline artifact",
-      "entry_phase_id must exist in phases[].phase_id",
-      "next_on_success must be null or an existing phase_id",
-      "packet must not encode transport secrets, runtime state, or semantic acceptance outcomes",
-    ],
-  },
-  [ORCHESTRATION_STATE_SCHEMA_REF]: {
-    id: "nimi-coding.orchestration-state.v1",
-    kind: "orchestration-state",
-    listFields: {
-      required: [
-        "state_id",
-        "topic_id",
-        "packet_ref",
-        "run_status",
-        "current_phase_id",
-        "last_completed_phase_id",
-        "awaiting_human_action",
-        "updated_at",
-        "owner",
-      ],
-      optional: [
-        "pause_reason",
-        "notification_refs",
-        "current_prompt_ref",
-        "latest_worker_output_ref",
-        "latest_acceptance_ref",
-        "latest_evidence_refs",
-        "started_at",
-      ],
-      run_status_enum: [
-        "running",
-        "paused",
-        "awaiting_confirmation",
-        "completed",
-        "failed",
-        "superseded",
-      ],
-      notification_ref_required: ["event", "correlation_id"],
-    },
-    requiredRules: [
-      "packet_ref must resolve to an execution packet artifact",
-      "current_phase_id and last_completed_phase_id must be null or existing packet phase ids",
-      "running state requires current_phase_id",
-      "paused state requires current_phase_id, pause_reason, and awaiting_human_action",
-      "awaiting_confirmation state requires current_phase_id and awaiting_human_action and is legacy-only for older runs",
-      "failed state requires awaiting_human_action",
-      "completed state requires last_completed_phase_id and must not carry current_phase_id, awaiting_human_action, or pause_reason",
-      "resume_token and transport secrets are forbidden",
-      "notification_refs entries may track event/correlation emission refs, but they must not become notification log state ownership",
-      "orchestration state must not encode semantic acceptance or finding judgments",
-    ],
-  },
-  [PROMPT_SCHEMA_REF]: {
-    id: "nimi-coding.prompt.v1",
-    kind: "prompt",
-    listFields: {
-      required_blocks: [
-        "Task Goal",
-        "Authority Reads",
-        "Confirmed State",
-        "Hard Constraints",
-        "Must Complete",
-        "Explicit Non-Goals",
-        "Required Checks",
-        "Required Final Output Format",
-        "Blocker Escalation Rule",
-      ],
-    },
-    requiredRules: [],
-  },
-  [WORKER_OUTPUT_SCHEMA_REF]: {
-    id: "nimi-coding.worker-output.v1",
-    kind: "worker-output",
-    listFields: {
-      required_blocks: [
-        "Findings",
-        "Implementation summary",
-        "Files changed",
-        "Checks run",
-        "Remaining gaps / risks",
-        "Runner Signal",
-      ],
-      optional_blocks: [
-        "Chosen decision",
-        "Authority / spec impact",
-        "Guard behavior decision",
-        "Next implementation step",
-        "Remaining blockers",
-      ],
-    },
-    requiredRules: [],
-  },
-  [ACCEPTANCE_SCHEMA_REF]: {
-    id: "nimi-coding.acceptance.v1",
-    kind: "acceptance",
-    listFields: {
-      required_order: [
-        "authority alignment",
-        "phase closure",
-        "evidence sufficiency",
-        "disposition",
-        "next step or reopen",
-      ],
-      disposition_enum: ["complete", "partial", "deferred"],
-      required_blocks: [
-        "Findings",
-        "Current Phase Disposition",
-        "Next Step or Reopen Condition",
-      ],
-    },
-    requiredRules: [],
-  },
-};

package/cli/help.mjs

@@ -1,157 +1,40 @@
 import { VERSION } from "./constants.mjs";
-import {
-  localize,
-  styleCommand,
-  styleHeading,
-  styleMuted,
-} from "./lib/ui.mjs";
+import { localize, styleCommand, styleHeading, styleMuted } from "./lib/ui.mjs";
 
 export function helpText() {
-  const lines = [
+  const commands = [
+    "nimicoding start [--yes]",
+    "nimicoding sync [--apply|--check|--dry-run] [--json]",
+    "nimicoding clear [--yes]",
+    "nimicoding doctor [--verbose|--json]",
+    "nimicoding blueprint-audit [--blueprint-root <path>] [--canonical-root <path>] [--json] [--write-local]",
+    "nimicoding validate-spec-tree [.nimi/spec]",
+    "nimicoding validate-spec-audit [.nimi/local/state/spec-generation/spec-generation-audit.yaml]",
+    "nimicoding classify-spec-tree --profile <profile-id> --root .nimi/spec [--emit <path>] [--json]",
+    "nimicoding generate-spec-migration-plan --profile <profile-id> --root .nimi/spec --emit .nimi/local/state/spec-surface/migration-plan.json [--json]",
+    "nimicoding validate-placement --profile <profile-id> --root .nimi/spec [--json]",
+    "nimicoding validate-table-family --profile <profile-id> --root .nimi/spec [--json]",
+    "nimicoding validate-projection-edges --profile <profile-id> --root .nimi/spec [--json]",
+    "nimicoding validate-guidance-bodies --profile <profile-id> --root .nimi/spec [--json]",
+    "nimicoding validate-domain-admission --profile <profile-id> --root .nimi/spec [--json]",
+    "nimicoding validate-tracked-output-admission --profile <profile-id> --root .nimi/spec [--json]",
+    "nimicoding validate-spec-governance --profile <profile-id> --scope <all|host-defined-scope>",
+    "nimicoding generate-spec-derived-docs --profile <profile-id> --scope <all|host-defined-scope> [--check]",
+    "nimicoding validate-ai-governance --profile <profile-id> --scope <all|agents-freshness|context-budget|structure-budget|high-risk-doc-metadata>",
+  ];
+
+  return [
     styleHeading(`nimicoding ${VERSION}`),
     "",
     localize("Usage:", "用法："),
     `  ${styleCommand("nimicoding --help")}`,
     `  ${styleCommand("nimicoding --version")}`,
-    `  ${styleCommand("nimicoding start")}`,
-    `  ${styleCommand("nimicoding start --yes")}`,
-    `  ${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]")}`,
-    `  ${styleCommand("nimicoding topic run-ledger <init|record|build|status> <topic-id> --run-id <id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic-runner <step|run> <topic-id> --run-id <id> --adapter <codex|oh_my_codex|claude> [--execute-host] [--json]")}`,
-    `  ${styleCommand("nimicoding topic validate [<topic-id>|<topic-path>] [--json]")}`,
-    `  ${styleCommand("nimicoding topic validate graph <topic-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic validate admission <topic-id> <wave-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic wave add <topic-id> <wave-id> <slug> --goal <text> --owner-domain <text> [--dep <wave-id>] [--json]")}`,
-    `  ${styleCommand("nimicoding topic wave select <topic-id> <wave-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic wave admit <topic-id> <wave-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic packet freeze <topic-id> --from <draft-path> [--json]")}`,
-    `  ${styleCommand("nimicoding topic worker dispatch <topic-id> --packet <packet-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic audit dispatch <topic-id> --packet <packet-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic result record <topic-id> --kind <worker|implementation|audit|preflight|judgement> --verdict <PASS|NEEDS_REVISION|FAIL|OVERFLOW> --from <path> --verified-at <iso8601> [--json]")}`,
-    `  ${styleCommand("nimicoding topic remediation open <topic-id> --kind <a|b|continuation|execution-state-closure> --reason <token> [--overflowed-packet <packet-id>] [--json]")}`,
-    `  ${styleCommand("nimicoding topic overflow continue <topic-id> --packet <continuation-packet-id> --overflowed-packet <packet-id> --manager-judgement <text> --same-owner-domain [--json]")}`,
-    `  ${styleCommand("nimicoding topic hold <topic-id> --reason <token> --summary <text> [--reopen-criteria <text>] [--close-trigger <text>] [--json]")}`,
-    `  ${styleCommand("nimicoding topic resume <topic-id> --criteria-met <text> [--json]")}`,
-    `  ${styleCommand("nimicoding topic validate closure <topic-id> <wave-id> [--json]")}`,
-    `  ${styleCommand("nimicoding topic closeout wave <topic-id> <wave-id> --authority <open|closed|blocked> --semantic <open|closed|blocked> --consumer <open|closed|blocked> --drift-resistance <open|closed|blocked> --disposition <complete|partial|deferred> [--json]")}`,
-    `  ${styleCommand("nimicoding topic true-close-audit <topic-id> --judgement <text> [--json]")}`,
-    `  ${styleCommand("nimicoding topic closeout topic <topic-id> --authority <open|closed|blocked> --semantic <open|closed|blocked> --consumer <open|closed|blocked> --drift-resistance <open|closed|blocked> --disposition <complete|partial|deferred> [--json]")}`,
-    `  ${styleCommand("nimicoding topic decision-review <topic-id> <slug> --decision <text> --replaced-scope <text> --active-replacement-scope <text> [--disposition <retired|superseded|unchanged>] [--target-wave <wave-id>] [--date <YYYY-MM-DD>] [--json]")}`,
-    `  ${styleCommand("nimicoding doctor")}`,
-    `  ${styleCommand("nimicoding doctor --verbose")}`,
-    `  ${styleCommand("nimicoding doctor --json")}`,
-    `  ${styleCommand("nimicoding blueprint-audit [--blueprint-root <path>] [--canonical-root <path>] [--json] [--write-local]")}`,
-    `  ${styleCommand("nimicoding handoff --skill <skill-id>")}`,
-    `  ${styleCommand("nimicoding handoff --skill <skill-id> --json")}`,
-    `  ${styleCommand("nimicoding handoff --skill <skill-id> --prompt")}`,
-    `  ${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 audit-claude --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-local]")}`,
-    `  ${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")}`,
-    `  ${styleCommand("nimicoding closeout --skill <skill-id> --outcome <completed|blocked|failed> --verified-at <iso8601> --write-local")}`,
-    `  ${styleCommand("nimicoding closeout --from <json> [--json] [--write-local]")}`,
-    `  ${styleCommand("nimicoding decide-high-risk-execution --from <json> --acceptance <path> --verified-at <iso8601> [--json] [--write-local]")}`,
-    `  ${styleCommand("nimicoding ingest-high-risk-execution --from <json> [--json] [--write-local]")}`,
-    `  ${styleCommand("nimicoding review-high-risk-execution --from <json> [--json] [--write-local]")}`,
-    `  ${styleCommand("nimicoding validate-execution-packet <path>")}`,
-    `  ${styleCommand("nimicoding validate-orchestration-state <path>")}`,
-    `  ${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>")}`,
-    `  ${styleCommand("nimicoding validate-worker-output <path>")}`,
-    `  ${styleCommand("nimicoding validate-acceptance <path>")}`,
+    ...commands.map((command) => `  ${styleCommand(command)}`),
     "",
-    localize("Notes:", "说明："),
-    styleMuted(localize(
-      "  - `nimicoding topic` currently implements root control, Wave 2 graph/admission/freeze, Wave 3 dispatch/result/decision-review, Wave 4 remediation/overflow control, Wave 5 closure/true-close gates, Wave 6 read-only golden-fixture audit, and pending hold/resume lifecycle control",
-      "  - `nimicoding topic` 当前实现 root control、Wave 2 graph/admission/freeze、Wave 3 dispatch/result/decision-review、Wave 4 remediation/overflow control、Wave 5 closure/true-close gate、Wave 6 只读 golden fixture 审计，以及 pending hold/resume 生命周期控制",
-    )),
-    styleMuted(localize(
-      "  - `topic create` requires an explicit justification so topic entry does not silently become the default path",
-      "  - `topic create` 要求显式 justification，避免 topic entry 静默变成默认路径",
-    )),
-    styleMuted(localize(
-      "  - `nimicoding start` is the primary entrypoint; it sets up the project and prepares the next AI task",
-      "  - `nimicoding start` 是主入口；它会准备项目并为下一项 AI 任务做好准备",
-    )),
     styleMuted(localize(
-      "  - interactive `nimicoding start` describes one option, asks once, and applies one option at a time",
-      "  - 交互式 `nimicoding start` 会逐项说明、逐项确认、逐项执行",
+      "Nimi Coding defines methodology, canonical spec construction, and deterministic governance checks. AI task planning and execution belong to the host.",
+      "Nimi Coding 只定义方法论、canonical spec 构建和确定性治理校验；AI 任务规划与执行由宿主负责。",
     )),
-    styleMuted(localize(
-      "  - `nimicoding start` can also choose a target host and print a short paste-ready prompt directly in the terminal",
-      "  - `nimicoding start` 还可以选择目标 Host，并直接在终端输出一段可粘贴的短 prompt",
-    )),
-    styleMuted(localize(
-      "  - `nimicoding clear` removes only managed AI blocks plus package-owned .nimi/config, .nimi/contracts, and .nimi/methodology files that still match the packaged seed",
-      "  - `nimicoding clear` 只会移除托管 AI 区块，以及仍与包内 seed 完全一致的 .nimi/config、.nimi/contracts、.nimi/methodology 文件",
-    )),
-    styleMuted(localize(
-      "  - `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` 可查看内部契约细节",
-    )),
-    styleMuted(localize(
-      "  - `nimicoding blueprint-audit` is an optional benchmark parity check when a blueprint root is declared",
-      "  - `nimicoding blueprint-audit` 是可选的 benchmark 等价检查，仅在声明 blueprint root 时使用",
-    )),
-    styleMuted(localize(
-      "  - `nimicoding validate-spec-audit` checks whether the generated canonical files carry explicit file-level evidence, inference, and unresolved-gap tracking",
-      "  - `nimicoding validate-spec-audit` 用于检查生成的 canonical 文件是否携带显式的逐文件证据、推断来源和未解决缺口记录",
-    )),
-    styleMuted(localize(
-      "  - `nimicoding handoff --prompt` writes local prompt/json refs under .nimi/local/handoff/",
-      "  - `nimicoding handoff --prompt` 会把本地 prompt/json ref 写入 .nimi/local/handoff/",
-    )),
-    styleMuted(localize(
-      "  - use `--lang zh` or `--lang en` to switch human-readable output",
-      "  - 使用 `--lang zh` 或 `--lang en` 切换人类可读输出语言",
-    )),
-  ];
-
-  return `${lines.join("\n")}\n`;
+    "",
+  ].join("\n");
 }