@nimiplatform/nimi-coding 0.3.1 → 0.5.0

package/spec/authority-impact.yaml

@@ -0,0 +1,61 @@
+version: 2
+spec:
+  id: nimicoding.authority-impact.v2
+  owner: nimi-coding
+  status: active
+product_claim: compare_admitted_compiler_outputs_and_report_declared_relation_impact_and_host_owned_follow_up_targets_without_accepting_completion_state
+commands:
+  diff: nimicoding authority diff <before-path> <after-path> --max-bytes <positive-integer> [--json]
+  impact: nimicoding authority impact <before-path> <after-path> --max-bytes <positive-integer> [--json]
+diff:
+  source: two_independently_admitted_compiler_outputs
+  format: nimicoding.authority-diff/v1
+  top_level_fields: [format, changes, summary]
+  summary_fields: [units, changes]
+  record:
+    required_fields: [unitId, operation, pointer, before, after]
+    optional_fields: [beforeSource, afterSource]
+    operation_enum:
+      unit_added: complete_after_unit
+      modified: scalar_field_before_and_after
+      added: scope_value_or_relation_added
+      removed: scope_value_or_relation_removed
+    source_record_fields: [file, range, sourcePointer]
+  unit_removed_operation: forbidden
+  physical_unit_deletion: AUTH_DIFF_TRANSITION_INVALID
+  retirement: active_unit_is_replaced_by_a_valid_same_ID_same_kind_removed_tombstone
+  pure_profile_format_file_rename_unit_order_or_container_regroup_change: empty
+  ordering: [unit_ID, JSON_pointer, operation, values]
+  traceability: changed_values_reference_before_and_or_after_SourceMap
+  byte_budget:
+    measure: UTF-8_bytes_of_compact_JSON.stringify_diff
+    overflow: AUTH_DIFF_BUDGET_with_null_diff_and_partial_false
+impact:
+  format: nimicoding.authority-impact/v2
+  top_level_fields: [format, analysisStatus, changedUnits, impactedUnits, obligations]
+  analysisStatus: completed
+  impacted_unit_fields: [id, kind]
+  obligation_fields: [ruleId, type, target]
+  roots: normative_governance_definition_rule_graph_changes; non_normative_metadata_diff_is_reported_but_creates_no_impact_root
+  direction: reverse_declared_relations_from_changed_units_to_dependents
+  relation_categories: [applies_to, supersedes]
+  unrelated_units: excluded
+  active_rule_obligations:
+    consumer: union_of_before_and_after_declared_scope
+    test: one_host_follow_up_target_per_impacted_active_rule
+  completion_or_disposition_input: forbidden
+  byte_budget:
+    measure: UTF-8_bytes_of_compact_JSON.stringify_object_containing_diff_and_impact
+    overflow: AUTH_IMPACT_BUDGET_with_null_diff_null_impact_and_partial_false
+fail_closed:
+  invalid_before_or_after_authority: compiler_diagnostics
+  identity_reuse_kind_change_or_physical_deletion: AUTH_DIFF_TRANSITION_INVALID_or_compiler_identity_diagnostics
+  dangling_relation_or_illegal_lifecycle: compiler_diagnostics
+  missing_or_invalid_max_bytes: CLI_usage_failure
+boundaries:
+  writes_authority: false
+  durable_artifacts: none
+  git_interpretation: none
+  host_obligation_state_receipt_test_execution_or_completion: not_accepted_or_owned
+  natural_language_contradiction_detection: not_claimed
+  implementation_consumer_test_sync_proof: not_admitted

package/spec/authority-review.yaml

@@ -0,0 +1,71 @@
+version: 2
+spec:
+  id: nimicoding.authority-review.v2
+  owner: nimi-coding
+  status: active
+product_claim: one_explicit_Git_base_commit_and_one_stable_current_worktree_produce_exact_read_only_authority_analysis_with_narrow_component_statuses
+command: nimicoding authority review <repository-path> --base <git-ref> --bindings <file> --max-units <positive-safe-integer> --max-edges <positive-safe-integer> --max-bytes <positive-safe-integer> [--json]
+capture:
+  repository: exact_non_bare_Git_worktree_root
+  base_ref:
+    resolution: once_at_capture_start_to_immutable_full_commit_OID
+    later_use: full_OID_only
+    option_injection: refused
+  base_authority:
+    source: Git_object_database
+    root: .nimi/spec_tree_required
+    admitted_entry_types: [tree, regular_blob_100644_or_100755]
+  worktree_authority:
+    source: complete_live_filesystem_inventory_under_.nimi/spec
+    includes: [tracked_unchanged, tracked_modification, tracked_deletion, untracked_or_ignored_file, unsupported_regular_file]
+    refused: [missing_root, symlink, non_regular_entry, invalid_UTF-8_path, path_escape]
+    race: any_path_type_byte_or_stability_metadata_change_refuses_the_whole_capture
+  materialization:
+    location: independent_0700_temporary_directory
+    cleanup: required_after_success_or_failure
+  Git_mutation: forbidden
+snapshot_identity:
+  format: sha256_colon_lowercase_hex
+  domain: nimicoding.authority-snapshot-content/v1
+  inputs: sorted_repository_relative_regular_file_paths_entry_type_exact_byte_length_and_bytes
+oracles:
+  admission_and_counts: exactly_one_compileAuthorityPath_call_per_materialized_side
+  immutable_read_model: createCompiledAuthoritySnapshot_with_by_ID_owner_scope_container_and_incoming_outgoing_indexes
+  semantic_delta: diffAuthoritySnapshots_on_the_two_admitted_read_models
+  declared_impact: impactAuthorityDiff_on_the_single_computed_semantic_diff
+  configured_audit: auditAuthoritySnapshot_on_the_admitted_worktree_read_model_only
+  component_recompile_or_persistent_cache: forbidden
+product:
+  format: nimicoding.authority-review/v2
+  top_level_fields: [format, operationStatus, analysisComplete, partial, businessSemanticStatus, implementationConformanceStatus, snapshots, components, diff, impact, audit, budgets]
+  operationStatus: completed
+  analysisComplete: snapshot_capture_corpus_admission_diff_impact_and_configured_audit_all_finished
+  partial: false
+  businessSemanticStatus: not_evaluated
+  implementationConformanceStatus: not_evaluated
+  components:
+    snapshotCapture: {fields: [status], status: captured}
+    corpusAdmission: {fields: [status], status: admitted}
+    semanticDiff: {fields: [status], status: computed}
+    declaredImpact: {fields: [status], status: computed}
+    configuredAudit: {fields: [status, blockingStatus], status: evaluated, blockingStatus: [clear, blocked]}
+  no_generic_policy_pass_or_conformance_status: true
+budgets:
+  required: [maxUnits, maxEdges, maxBytes]
+  values: positive_safe_integers
+  component_bytes: same_explicit_maxBytes_passed_to_diff_impact_and_audit
+  review_bytes: UTF-8_bytes_of_compact_JSON.stringify_complete_review
+  overflow: AUTH_REVIEW_BUDGET_or_existing_component_budget_with_review_null_and_partial_false
+outcomes:
+  completed_clear: review_present_analysisComplete_true_configured_audit_clear_exit_0
+  completed_blocked: review_present_analysisComplete_true_configured_audit_blocked_exit_1
+  refused: invalid_Git_corpus_binding_capture_transition_or_budget_returns_review_null_partial_false_exit_1
+  usage_error: missing_repeated_or_invalid_CLI_argument_exit_2_without_review_product
+  failed: uncaught_IO_resource_or_internal_failure_exit_2_without_review_product
+boundaries:
+  writes_authority_or_project_files: false
+  durable_cache_database_history_receipt_or_external_result: none
+  impact_disposition_or_host_completion_state: not_accepted
+  arbitrary_shell_plugin_test_model_embedding_or_semantic_search_execution: forbidden
+  business_semantic_and_implementation_conformance: explicitly_not_evaluated
+  public_AuthorityIR_or_SourceMap_export: none

package/spec/authority-terms.yaml

@@ -0,0 +1,63 @@
+version: 1
+spec:
+  id: nimicoding.authority-terms.v1
+  owner: nimi-coding
+  status: active
+product_claim: bounded_static_index_of_the_identifiers_the_active_authority_corpus_uses_and_optionally_where_one_exact_identifier_appears_in_tracked_text
+command: nimicoding authority terms <repository-path> --spec <corpus-path> [--term <t>] [--code] --max-units <positive-safe-integer> --max-terms <positive-safe-integer> --max-bytes <positive-safe-integer> [--json]
+surface:
+  report_format: nimicoding.authority-terms/v1
+  corpus_root: repository_authority_corpus_only
+  boolean_flags: [json, code]
+  value_flags: [spec, term]
+  integer_flags: [max-units, max-terms, max-bytes]
+  repeatable_flags: []
+  findings_change_exit_code: false
+inputs:
+  repository:
+    shape: exact_non_symlink_Git_worktree_root
+    tracked_files: one_complete_git_ls_files_cached_NUL_inventory
+    writes_or_execution: forbidden
+  corpus:
+    root: exact_repository_relative_.nimi/spec_resolved_realpath
+    units: active_only
+    fields: [title, meaning, statement, condition, failure]
+  term:
+    required_for_code: true
+    admission: must_be_one_exact_term_the_closed_lexical_grammar_admits
+lexical_grammar:
+  classes: [snake_case, camelCase, UPPER_SNAKE, ALL_CAPS, PascalCase, dotted]
+  all_caps_shape: '[A-Z]{2,}'
+  all_caps_semantics: lexical_shape_only_without_acronym_or_product_identity_inference
+  acronym_leading_pascal_shape: '[A-Z]{2,}[a-z][a-z0-9]*([A-Z][a-z0-9]*)*'
+  ordinary_title_words: excluded_unless_they_match_the_existing_multi_segment_PascalCase_shape
+  boundaries: ASCII_identifier_boundaries_required
+  excluded: terms_inside_longer_path_like_tokens_containing_a_slash
+  dotted_exclusion: final_segments_that_are_known_code_extensions
+code_inventory:
+  shape: tracked_text_inventory_v1
+  selection: by_decoded_content_never_by_an_extension_allowlist
+  rationale: a_fixed_extension_list_silently_dropped_whole_languages_while_the_report_claimed_complete
+  binary_detection: NUL_byte_or_undecodable_UTF_8_prefix_probe
+  probe_decoder: one_fresh_decoder_per_file_so_a_straddling_character_cannot_reject_the_next_file
+  exclusions:
+    every_excluded_file_reported: true
+    reasons: [authority-corpus, binary-content, not-utf8]
+    silent_exclusion: forbidden
+  accounting: tracked_files_equals_scanned_files_plus_excluded_files
+budgets:
+  max_units: complete_active_unit_set_must_fit
+  max_terms: complete_distinct_term_set_must_fit
+  max_bytes: inputBytes_complete_decoded_authority_and_optional_code_input_must_fit
+  exceeded: refuse_with_one_diagnostic_and_no_partial_index_or_cross_reference
+result:
+  trackedPathSetDigest: sha256_hex_of_nimicoding.repository-inventory/v1_canonical_tracked_path_set_preimage
+  complete: true_only_when_every_admitted_input_was_read_and_classified
+  byte_counts:
+    scannedBytes: selected_normative_authority_fields_plus_optional_decoded_code_inputs
+    inputBytes: complete_decoded_authority_corpus_plus_optional_decoded_code_inputs
+  partial: never
+  modes: [index, detail]
+  detail_fields: [term, classes, unitCount, units, code, codeReferences, codeInventory]
+  findings_change_exit_code: false
+  determinism: identical_inputs_produce_byte_identical_output

package/spec/product-scope.yaml

@@ -1,27 +1,41 @@
-version: 3
+version: 9
 product:
   package_name: "@nimiplatform/nimi-coding"
-  mission: methodology_spec_construction_and_deterministic_validation
+  mission: canonical_authority_methodology_formatter_compiler_primitives_and_deterministic_gates
 owned_surfaces:
-  - bootstrap_and_sync_of_managed_.nimi_projections
-  - methodology_principles
-  - spec_surface_taxonomy_and_placement_contracts
-  - spec_construction_inputs_and_generation_audit_contracts
-  - deterministic_spec_governance_and_ai_governance_checks
+  - compact_authority_authoring_methodology
+  - exact_authority_guide_projection_and_managed_instruction_blocks
+  - canonical_authority_format_and_complete_root_check
+  - private_compile_bounded_filtered_lexical_discovery_with_field_snippets_optional_direct_authored_relation_preview_exact_query_and_declared_outgoing_context
+  - immutable_per_invocation_compiler_snapshots_with_transient_exact_indexes_and_change_derived_candidate_recall
+  - semantic_diff_and_declared_review_impact
+  - bounded_direct_references_exact_relation_paths_and_local_subgraphs
+  - project_bound_deterministic_graph_and_exact_lexical_authority_audit_and_SARIF_projection
+  - git_aware_exact_read_only_authority_change_review
+  - optional_L3_repository_governance_not_authority_admission
+canonical_boundary:
+  host_product_authority: .nimi/spec/**/*.authority.{yaml,md}
+  sole_conformance_gate: nimicoding_authority_check_complete_.nimi/spec
+  historical_format_inference: forbidden
+  product_semantic_generation: forbidden
+surface_separation:
+  public: [documented_CLI, package_documentation]
+  canonical_project_owned: .nimi/spec/**/*.authority.{yaml,md}
+  projected_AI_visible_package_owned: [.nimi/methodology/authority-authoring.yaml, AGENTS.md#managed-block, CLAUDE.md#managed-block]
+  local_non_authority: .nimi/local/**
+  package_internal: [authority_grammar_contracts, AuthorityIR, SourceMap, compiler_implementation]
 out_of_scope:
-  - planning_or_task_lifecycle
-  - agent_or_provider_orchestration
-  - implementation_execution
-  - review_approval_or_completion_state
-  - host_prompt_or_context_management
-  - scheduling_notifications_and_automation
-integration_contract:
-  host_owns_execution: true
-  nimi_coding_may_emit_non_mutating_analysis: true
-  nimi_coding_may_validate_declared_artifacts: true
-  nimi_coding_must_not_create_host_execution_state: true
-canonical_roots:
-  package_authority: package://@nimiplatform/nimi-coding
-  host_product_authority: .nimi/spec
-  managed_projection_roots: [.nimi/config, .nimi/contracts, .nimi/methodology]
-  local_non_authority_root: .nimi/local
+  - reconstruction_taxonomy_tables_guidance_registries_and_generation_audits
+  - profile_specific_authority_validation
+  - planning_task_lifecycle_delegation_execution_review_or_approval
+  - host_workflow_command_aggregation
+  - external_probe_result_attestation_test_execution_or_proof_packet_aggregation
+  - sqlite_cache_incremental_embedding_semantic_search_visualization_AI_execution_or_Atlas
+claims:
+  discovery: bounded_deterministic_exact_filtered_lexical_candidates_with_SourceMapped_field_snippets_and_optional_M1_direct_authored_relation_preview_not_semantic_search_selection_context_or_absence_proof
+  change_candidates: complete_union_of_caller_requested_exact_channels_with_raw_fields_modality_and_reasons_not_semantic_relevance_conflict_retirement_absence_or_conformance
+  context: complete_declared_outgoing_interpretation_closure_not_complete_task_context
+  impact: declared_relation_impact_and_host_follow_up_targets_not_workflow_state_sync_or_completion_proof
+  graph: complete_bounded_explicit_relation_navigation_not_semantic_inference_or_raw_IR
+  audit: configured_graph_and_exact_case_sensitive_lexical_results_not_prose_predicate_inference_semantic_synonym_or_plugin_execution
+  review: immutable_base_OID_and_stable_worktree_exact_snapshots_composed_through_existing_compiler_diff_impact_and_current_audit_oracles_with_business_and_implementation_status_not_evaluated

package/cli/commands/blueprint-audit.mjs

@@ -1,91 +0,0 @@
-import {
-  buildBlueprintAuditPayload,
-  formatBlueprintAuditPayload,
-  writeBlueprintAuditArtifact,
-} from "../lib/shared.mjs";
-import { localize } from "../lib/ui.mjs";
-
-function parseBlueprintAuditOptions(args) {
-  const options = {
-    json: false,
-    writeLocal: false,
-    blueprintRoot: null,
-    canonicalRoot: null,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--json") {
-      options.json = true;
-      continue;
-    }
-
-    if (arg === "--write-local") {
-      options.writeLocal = true;
-      continue;
-    }
-
-    if (arg === "--blueprint-root" || arg === "--canonical-root") {
-      const next = args[index + 1];
-      if (!next || next.startsWith("--")) {
-        return {
-          ok: false,
-          error: `${localize(
-            `nimicoding blueprint-audit refused: ${arg} requires a value.`,
-            `nimicoding blueprint-audit 已拒绝：${arg} 需要一个值。`,
-          )}\n`,
-        };
-      }
-
-      if (arg === "--blueprint-root") {
-        options.blueprintRoot = next;
-      } else {
-        options.canonicalRoot = next;
-      }
-      index += 1;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: `${localize(
-        `nimicoding blueprint-audit refused: unknown option ${arg}.`,
-        `nimicoding blueprint-audit 已拒绝：未知选项 ${arg}。`,
-      )}\n`,
-    };
-  }
-
-  return {
-    ok: true,
-    options,
-  };
-}
-
-export async function runBlueprintAudit(args) {
-  const parsed = parseBlueprintAuditOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(parsed.error);
-    return 2;
-  }
-
-  const payload = await buildBlueprintAuditPayload(process.cwd(), parsed.options);
-  if (payload.inputError) {
-    process.stderr.write(payload.error);
-    return payload.exitCode;
-  }
-
-  if (parsed.options.writeLocal) {
-    await writeBlueprintAuditArtifact(process.cwd(), payload);
-  }
-
-  if (parsed.options.json) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-  } else {
-    process.stdout.write(formatBlueprintAuditPayload(payload));
-  }
-
-  return payload.exitCode;
-}
-
-export { parseBlueprintAuditOptions };

package/cli/commands/classify-spec-tree.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runClassifySpecTree(args) {
-  return runSurfaceValidatorCommand(args, "classify-spec-tree");
-}

package/cli/commands/generate-spec-derived-docs.mjs

@@ -1,151 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { localize } from "../lib/ui.mjs";
-import { loadGovernanceConfig, requireProfile } from "../lib/internal/governance/config.mjs";
-import { runCommand } from "../lib/internal/governance/runner.mjs";
-import { parseSpecGenerationInputsConfig } from "../lib/internal/contracts-parse.mjs";
-
-const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
-
-function parseOptions(args) {
-  const options = {
-    profile: null,
-    scope: "all",
-    check: false,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--profile") {
-      const value = args[index + 1];
-      if (!value || value.startsWith("--")) {
-        return { ok: false, error: "nimicoding generate-spec-derived-docs refused: --profile requires a value.\n" };
-      }
-      options.profile = value;
-      index += 1;
-      continue;
-    }
-
-    if (arg === "--scope") {
-      const value = args[index + 1];
-      if (!value || value.startsWith("--")) {
-        return { ok: false, error: "nimicoding generate-spec-derived-docs refused: --scope requires a value.\n" };
-      }
-      options.scope = value;
-      index += 1;
-      continue;
-    }
-
-    if (arg === "--check") {
-      options.check = true;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: `nimicoding generate-spec-derived-docs refused: unknown option ${arg}.\n`,
-    };
-  }
-
-  return { ok: true, options };
-}
-
-function resolveScopes(scope, governanceConfig) {
-  const configuredScopes = Object.keys(governanceConfig.specGovernance.generateCommands || {});
-  if (scope === "all") {
-    return {
-      ok: true,
-      scopes: configuredScopes,
-      error: null,
-    };
-  }
-  if (!configuredScopes.includes(scope)) {
-    return {
-      ok: false,
-      scopes: [],
-      error: `nimicoding generate-spec-derived-docs refused: unsupported --scope value ${scope}.\n`,
-    };
-  }
-  return {
-    ok: true,
-    scopes: [scope],
-    error: null,
-  };
-}
-
-export async function runGenerateSpecDerivedDocs(args) {
-  const parsed = parseOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(parsed.error, parsed.error));
-    return 2;
-  }
-
-  const governance = await loadGovernanceConfig(process.cwd());
-  if (!governance.ok) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-derived-docs refused: ${governance.reason} at ${governance.path}.\n`,
-      `nimicoding generate-spec-derived-docs 已拒绝：${governance.path} 的治理配置不可用。\n`,
-    ));
-    return 2;
-  }
-
-  const profileCheck = requireProfile(governance.config, parsed.options.profile);
-  if (!profileCheck.ok) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-derived-docs refused: ${profileCheck.error}.\n`,
-      `nimicoding generate-spec-derived-docs 已拒绝：${profileCheck.error}。\n`,
-    ));
-    return 2;
-  }
-
-  const scopeResolution = resolveScopes(parsed.options.scope, governance.config);
-  if (!scopeResolution.ok) {
-    process.stderr.write(localize(scopeResolution.error, scopeResolution.error));
-    return 2;
-  }
-
-  const packageInputsText = await readFile(
-    path.join(PACKAGE_ROOT, "config", "spec-generation-inputs.yaml"),
-    "utf8",
-  );
-  const packageInputs = parseSpecGenerationInputsConfig(packageInputsText);
-  if (!packageInputs.ok || !packageInputs.generationOrder.includes("validate_placement")) {
-    process.stderr.write(localize(
-      "nimicoding generate-spec-derived-docs refused: package spec generation inputs must be class-filtered and include placement validation.\n",
-      "nimicoding generate-spec-derived-docs 已拒绝：package spec generation inputs 必须按 surface class 过滤并包含 placement validation。\n",
-    ));
-    return 2;
-  }
-
-  let failed = false;
-  for (const scope of scopeResolution.scopes) {
-    const commands = governance.config.specGovernance.generateCommands[scope] || [];
-    if (commands.length === 0) {
-      process.stderr.write(localize(
-        `nimicoding generate-spec-derived-docs refused: scope ${scope} is not configured in .nimi/config/governance.yaml.\n`,
-        `nimicoding generate-spec-derived-docs 已拒绝：.nimi/config/governance.yaml 未配置 ${scope}。\n`,
-      ));
-      return 2;
-    }
-
-    for (const command of commands) {
-      const commandToRun = parsed.options.check ? `${command} --check` : command;
-      const result = runCommand(commandToRun, { cwd: process.cwd() });
-      if (result.stdout) process.stdout.write(result.stdout);
-      if (result.stderr) process.stderr.write(result.stderr);
-      if (!result.ok) {
-        failed = true;
-        break;
-      }
-    }
-
-    if (failed) {
-      break;
-    }
-  }
-
-  return failed ? 1 : 0;
-}

package/cli/commands/generate-spec-migration-plan.mjs

@@ -1,30 +0,0 @@
-import {
-  generateSpecMigrationPlan,
-  parseSurfaceValidatorOptions,
-  writeMigrationPlanIfRequested,
-} from "../lib/internal/surface-taxonomy-validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-export async function runGenerateSpecMigrationPlan(args) {
-  const parsed = parseSurfaceValidatorOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-migration-plan refused: ${parsed.error}\n`,
-      `nimicoding generate-spec-migration-plan 已拒绝：${parsed.error}\n`,
-    ));
-    return 2;
-  }
-
-  try {
-    const report = await generateSpecMigrationPlan(process.cwd(), parsed.options);
-    await writeMigrationPlanIfRequested(report, parsed.options.emit, process.cwd());
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    return report.ok ? 0 : 1;
-  } catch (error) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-migration-plan refused: ${error.message}\n`,
-      `nimicoding generate-spec-migration-plan 已拒绝：${error.message}\n`,
-    ));
-    return 2;
-  }
-}

package/cli/commands/surface-validator-command.mjs

@@ -1,49 +0,0 @@
-import {
-  classifySpecSurface,
-  parseSurfaceValidatorOptions,
-  validateDomainAdmission,
-  validateGuidanceBodies,
-  validatePlacement,
-  validateProjectionEdges,
-  validateTableFamily,
-  validateTrackedOutputAdmission,
-  writeInventoryIfRequested,
-} from "../lib/internal/surface-taxonomy-validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-const VALIDATORS = {
-  "classify-spec-tree": classifySpecSurface,
-  "validate-placement": validatePlacement,
-  "validate-table-family": validateTableFamily,
-  "validate-projection-edges": validateProjectionEdges,
-  "validate-guidance-bodies": validateGuidanceBodies,
-  "validate-domain-admission": validateDomainAdmission,
-  "validate-tracked-output-admission": validateTrackedOutputAdmission,
-};
-
-export async function runSurfaceValidatorCommand(args, validatorName) {
-  const parsed = parseSurfaceValidatorOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(
-      `nimicoding ${validatorName} refused: ${parsed.error}\n`,
-      `nimicoding ${validatorName} 已拒绝：${parsed.error}\n`,
-    ));
-    return 2;
-  }
-
-  const validator = VALIDATORS[validatorName];
-  if (!validator) {
-    process.stderr.write(localize(
-      `nimicoding ${validatorName} refused: unknown surface validator.\n`,
-      `nimicoding ${validatorName} 已拒绝：未知 surface validator。\n`,
-    ));
-    return 2;
-  }
-
-  const report = await validator(process.cwd(), parsed.options);
-  if (validatorName === "classify-spec-tree") {
-    await writeInventoryIfRequested(report, parsed.options.emit, process.cwd());
-  }
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-  return report.ok ? 0 : 1;
-}

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

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

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

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

package/cli/commands/validate-placement.mjs

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

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

@@ -1,5 +0,0 @@
-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,27 +0,0 @@
-import path from "node:path";
-
-import { validateSpecAudit, buildValidatorCliReport } from "../lib/validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-export async function runValidateSpecAudit(args) {
-  const normalized = args[0] === "--" ? args.slice(1) : args;
-  let targetPath = ".nimi/local/state/spec-generation/spec-generation-audit.yaml";
-
-  if (normalized.length > 1) {
-    process.stderr.write(localize(
-      "nimicoding validate-spec-audit refused: expected zero or one path argument.\n",
-      "nimicoding validate-spec-audit 已拒绝：期望零个或一个路径参数。\n",
-    ));
-    return 2;
-  }
-
-  if (normalized.length === 1) {
-    targetPath = normalized[0];
-  }
-
-  const absolutePath = path.resolve(process.cwd(), targetPath);
-  const report = await validateSpecAudit(absolutePath, { projectRoot: process.cwd() });
-  const cliReport = buildValidatorCliReport("validate-spec-audit", absolutePath, report);
-  process.stdout.write(`${JSON.stringify(cliReport, null, 2)}\n`);
-  return report.ok ? 0 : 1;
-}