@nimiplatform/nimi-coding 0.1.0 → 0.2.0

package/contracts/projection-edge.schema.yaml

@@ -0,0 +1,130 @@
+version: 1
+contract:
+  id: nimicoding.projection-edge.v1
+  owner: nimi-coding
+  purpose: Declare allowed projections between package, host, product, and derived surfaces.
+required_top_level_fields:
+  - version
+  - projection_edges
+  - edge_kind_enum
+  - semantic_constraints
+projection_edge_required_fields:
+  - edge_id
+  - edge_kind
+  - source_ref
+  - source_class
+  - source_owner
+  - target_ref
+  - target_class
+  - target_owner
+  - allowed_fields
+  - forbidden_promoted_fields
+  - drift_check_command
+  - failure_disposition
+shared_enum_ref: shared-enums.yaml
+projection_edges:
+  - edge_id: nimi_coding_package_to_host_anchor
+    edge_kind: package_to_host_anchor
+    source_ref: package://@nimiplatform/nimi-coding/{spec,methodology,contracts,config}/**
+    source_class: methodology_authority
+    source_owner: nimi_coding_package
+    target_ref: .nimi/spec/_meta/nimi-coding-admission-anchor.yaml
+    target_class: host_projection_anchor
+    target_owner: nimi_host
+    allowed_fields: [package_id, package_version, package_truth_root, projection_edges, must_not_override]
+    forbidden_promoted_fields: [package_methodology_body, product_rule_body, lifecycle_status, run_ledger, private_evidence]
+    drift_check_command: pnpm exec nimicoding validate-projection-edges --profile nimi
+    failure_disposition: fail_closed
+  - edge_id: nimi_coding_package_to_managed_projection
+    edge_kind: package_to_managed_projection
+    source_ref: package://@nimiplatform/nimi-coding/{config,contracts,methodology,spec}/**
+    source_class: methodology_authority
+    source_owner: nimi_coding_package
+    target_ref: .nimi/{config,contracts,methodology}/**
+    target_class: nimicoding_managed_projection
+    target_owner: nimi_host
+    allowed_fields: [projected_package_file_body]
+    forbidden_promoted_fields: [product_rule_body, lifecycle_status, run_ledger, private_evidence]
+    drift_check_command: pnpm exec nimicoding sync --check
+    failure_disposition: fail_closed
+  - edge_id: product_authority_to_derived_view
+    edge_kind: product_to_derived_view
+    source_ref: .nimi/spec/<domain>/kernel/**
+    source_class: product_authority
+    source_owner: product_domain
+    target_ref: stdout_view
+    target_class: derived_view
+    target_owner: generator
+    allowed_fields: [rendered_summary, source_refs, generator_id]
+    forbidden_promoted_fields: [product_rule_body_without_source_ref, audit_coverage_status, lifecycle_status]
+    drift_check_command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --check
+    failure_disposition: fail_closed
+  - edge_id: product_authority_to_support_registry
+    edge_kind: product_to_support_registry
+    source_ref: .nimi/spec/<domain>/kernel/**
+    source_class: product_authority
+    source_owner: product_domain
+    target_ref: .nimi/spec/<domain>/kernel/tables/*.yaml
+    target_class: support_registry
+    target_owner: product_domain
+    allowed_fields: [registry_id, owner, schema_ref, authority_refs, command_refs, evidence_class]
+    forbidden_promoted_fields: [audit_coverage_status, audit_date, lifecycle_status, roadmap_status, run_ledger]
+    drift_check_command: pnpm exec nimicoding validate-table-family --profile nimi
+    failure_disposition: fail_closed
+  - edge_id: authority_to_local_audit_evidence
+    edge_kind: authority_to_audit_evidence
+    source_ref: .nimi/spec/<domain>/kernel/**
+    source_class: product_authority
+    source_owner: product_domain
+    target_ref: .nimi/local/audit/**
+    target_class: audit_evidence_state
+    target_owner: audit_workflow
+    allowed_fields: [authority_refs, evidence_refs, finding_refs, coverage_scope, audit_validity]
+    forbidden_promoted_fields: [product_rule_body, package_methodology_body]
+    drift_check_command: pnpm exec nimicoding validate-placement --profile nimi
+    failure_disposition: fail_closed
+  - edge_id: topic_to_local_lifecycle_state
+    edge_kind: topic_to_local_state
+    source_ref: .nimi/topics/**
+    source_class: lifecycle_progress_state
+    source_owner: topic_lifecycle
+    target_ref: .nimi/local/state/**
+    target_class: lifecycle_progress_state
+    target_owner: execution_workflow
+    allowed_fields: [topic_id, wave_id, status, packet_ref, result_ref, closeout_ref]
+    forbidden_promoted_fields: [product_rule_body, package_methodology_body, private_evidence]
+    drift_check_command: pnpm exec nimicoding topic validate --profile nimi
+    failure_disposition: fail_closed
+edge_kind_enum:
+  - package_to_host_anchor
+  - package_to_managed_projection
+  - product_to_derived_view
+  - product_to_support_registry
+  - authority_to_audit_evidence
+  - topic_to_local_state
+failure_disposition_enum:
+  - fail_closed
+  - block
+allowed_target_classes:
+  - host_projection_anchor
+  - nimicoding_managed_projection
+  - derived_view
+  - support_registry
+  - audit_evidence_state
+  - lifecycle_progress_state
+forbidden_promoted_fields_catalog:
+  - package_methodology_body
+  - product_rule_body
+  - generated_rendered_body
+  - audit_coverage_status
+  - audit_date
+  - lifecycle_status
+  - roadmap_status
+  - run_ledger
+  - private_evidence
+semantic_constraints:
+  - host_projection_anchor_must_not_copy_package_methodology_body
+  - nimicoding_managed_projection_is_project_local_cli_projection_not_product_authority
+  - derived_view_projection_must_be_reproducible
+  - audit_evidence_may_cite_authority_but_never_override_it
+  - missing_projection_edge_is_a_validation_failure

package/contracts/shared-enums.yaml

@@ -0,0 +1,68 @@
+version: 1
+contract:
+  id: nimicoding.spec-surface-shared-enums.v1
+  owner: nimi-coding
+surface_class_enum:
+  - product_authority
+  - product_authority_table
+  - product_admission_registry
+  - thin_guidance
+  - derived_view
+  - spec_generation_state
+  - audit_evidence_state
+  - operational_local_artifact
+  - methodology_authority
+  - nimicoding_managed_projection
+  - host_projection_anchor
+  - candidate_roadmap
+  - support_registry
+  - lifecycle_progress_state
+authority_rank_enum:
+  - active_product_canonical
+  - package_canonical
+  - package_projection_support
+  - support_only
+  - guidance_only
+  - derived_non_authority
+  - evidence_only
+  - lifecycle_state
+  - operational_local
+  - candidate_only
+tracking_policy_enum:
+  - tracked_required
+  - tracked_forbidden
+  - local_only
+  - tracked_only_with_explicit_admission
+mutability_enum:
+  - human_admitted
+  - package_admitted
+  - package_projected
+  - generated_reproducible
+  - operational_snapshot
+  - disposable
+disposition_enum:
+  - keep
+  - move_package
+  - move_local
+  - split
+  - rewrite
+  - delete
+  - block
+confirmation_reason_enum:
+  - none
+  - product_semantic_fork
+  - owner_ambiguity
+  - package_boundary_ambiguity
+  - destructive_deletion
+artifact_class_enum:
+  - derived_manifest
+  - derived_summary
+  - state_manifest
+  - audit_index
+  - audit_summary
+  - roadmap_index
+  - roadmap_summary
+semantic_constraints:
+  - all_contracts_must_use_underscore_enum_values
+  - hyphenated_dispositions_are_forbidden
+  - missing_enum_ref_fails_contract_validation

package/contracts/spec-generation-audit.schema.yaml

@@ -1,16 +1,27 @@
-version: 1
+version: 2
 audit_contract:
   id: canonical_spec_generation_audit
-  target_ref: .nimi/spec/_meta/spec-generation-audit.yaml
+  owner: nimi-coding
+  target_ref: .nimi/local/state/spec-generation/spec-generation-audit.yaml
+  output_class: spec_generation_state
 required_top_level_fields:
   - generation_mode
   - canonical_target_root
   - declared_profile
   - input_roots
+  - placement_report_ref
   - files
+optional_top_level_fields:
+  - file_entry_refs
+file_entry_ref_contract:
+  shard_root: .nimi/local/state/spec-generation/spec-generation-audit
+  shard_payload_field: spec_generation_audit_file_entries
+  required_shard_fields:
+    - parent_ref
+    - files
 required_file_entry_fields:
   - canonical_path
-  - file_class
+  - surface_class
   - source_refs
   - source_basis
   - coverage_status
@@ -25,7 +36,11 @@ coverage_status_enum:
   - placeholder_not_allowed
 hard_constraints:
   - every_generated_canonical_file_requires_a_matching_audit_entry
+  - file_entry_refs_must_stay_under_local_spec_generation_state_root
+  - file_entry_ref_shards_must_point_back_to_parent_audit
   - required_canonical_files_must_not_be_placeholder_not_allowed
   - unresolved_or_inferred_content_must_be_explicit
-  - source_refs_must_stay_within_declared_inputs_or_optional_benchmark_root
+  - source_refs_must_stay_within_class_filtered_declared_inputs
   - no_empty_success_looking_audit_entries
+  - generation_audit_must_not_be_written_under_.nimi/spec
+  - generation_audit_must_not_be_used_as_product_authority

package/contracts/spec-generation-inputs.schema.yaml

@@ -1,39 +1,140 @@
-version: 1
+version: 2
 input_contract:
   id: canonical_spec_generation_inputs
-  target_root: .nimi/spec
-  mode_enum:
-    - mixed
-  benchmark_mode_enum:
-    - none
-    - repo_spec_blueprint
-    - custom_blueprint
-  acceptance_mode_enum:
-    - canonical_tree_validity_without_blueprint
-    - semantic_and_structural_parity_when_blueprint_exists
+  owner: nimi-coding
+  replaces_version: 1
+  purpose: Replace blanket docs_roots ingestion with class-filtered generation inputs.
 required_fields:
   - mode
   - canonical_target_root
-  - code_roots
-  - docs_roots
-  - structure_roots
-  - human_note_paths
-  - benchmark_blueprint_root
-  - benchmark_mode
-  - acceptance_mode
+  - code_inputs
+  - docs_inputs
+  - structure_inputs
+  - topic_inputs
+  - local_inputs
+  - forbidden_source_classes
   - generation_order
   - inference_rules
+  - acceptance_mode
+document_instance:
+  mode: class_filtered
+  canonical_target_root: .nimi/spec
+  code_inputs: []
+  docs_inputs:
+    - root: .nimi/spec
+      class_filter: product_authority_only
+      allowed_surface_classes: [product_authority, product_authority_table, product_admission_registry, thin_guidance, host_projection_anchor, support_registry]
+      forbidden_surface_classes: [derived_view, spec_generation_state, audit_evidence_state, operational_local_artifact, nimicoding_managed_projection, candidate_roadmap, lifecycle_progress_state, methodology_authority]
+      owner: nimi_host
+      use_as_authority: true
+      projection_edge_ref: null
+  structure_inputs: []
+  topic_inputs:
+    - root: .nimi/topics
+      owner: topic_lifecycle
+      allowed_surface_classes: [lifecycle_progress_state, candidate_roadmap]
+      use_as_authority: false
+  local_inputs:
+    - root: .nimi/local
+      owner: local_execution
+      allowed_surface_classes: [spec_generation_state, audit_evidence_state, operational_local_artifact, lifecycle_progress_state]
+      use_as_authority: false
+  forbidden_source_classes:
+    - derived_view
+    - spec_generation_state
+    - audit_evidence_state
+    - operational_local_artifact
+    - nimicoding_managed_projection
+    - candidate_roadmap
+    - lifecycle_progress_state
+  generation_order: [classify_inputs, validate_placement, product_authority, product_authority_tables, thin_guides, derived_views, generation_audit]
+  inference_rules: [no_blanket_docs_roots, no_generated_as_authority, no_derived_views_written_to_local, no_audit_or_lifecycle_state_as_authority]
+  acceptance_mode: placement_validity_before_generation
+docs_input_required_fields:
+  - root
+  - class_filter
+  - allowed_surface_classes
+  - forbidden_surface_classes
+  - owner
+  - use_as_authority
+  - projection_edge_ref
+shared_enum_ref: shared-enums.yaml
+generic_input_required_fields:
+  - root
+  - owner
+  - allowed_surface_classes
+  - forbidden_surface_classes
+  - use_as_authority
+code_input_required_fields:
+  - root
+  - owner
+  - projection_edge_ref
+structure_input_required_fields:
+  - root
+  - owner
+  - allowed_surface_classes
+topic_input_required_fields:
+  - root
+  - owner
+  - allowed_surface_classes
+  - use_as_authority
+local_input_required_fields:
+  - root
+  - owner
+  - allowed_surface_classes
+  - use_as_authority
+input_item_schemas:
+  code_inputs: code_input_required_fields
+  docs_inputs: docs_input_required_fields
+  structure_inputs: structure_input_required_fields
+  topic_inputs: topic_input_required_fields
+  local_inputs: local_input_required_fields
+baseline_inputs:
+  docs_inputs:
+    - root: .nimi/spec
+      class_filter: product_authority_only
+      allowed_surface_classes: [product_authority, product_authority_table, product_admission_registry, thin_guidance, host_projection_anchor, support_registry]
+      forbidden_surface_classes: [derived_view, spec_generation_state, audit_evidence_state, operational_local_artifact, nimicoding_managed_projection, candidate_roadmap, lifecycle_progress_state, methodology_authority]
+      owner: nimi_host
+      use_as_authority: true
+      projection_edge_ref: null
+  topic_inputs:
+    - root: .nimi/topics
+      owner: topic_lifecycle
+      allowed_surface_classes: [lifecycle_progress_state, candidate_roadmap]
+      use_as_authority: false
+  local_inputs:
+    - root: .nimi/local
+      owner: local_execution
+      allowed_surface_classes: [spec_generation_state, audit_evidence_state, operational_local_artifact, lifecycle_progress_state]
+      use_as_authority: false
+mode_enum:
+  - class_filtered
+acceptance_mode_enum:
+  - placement_validity_before_generation
+  - semantic_and_structural_parity_when_blueprint_exists
 generation_order_enum:
-  - index
-  - kernel_markdown
-  - kernel_tables
-  - generated_views
+  - classify_inputs
+  - validate_placement
+  - product_authority
+  - product_authority_tables
   - thin_guides
+  - derived_views
+  - generation_audit
+forbidden_source_classes:
+  - derived_view
+  - spec_generation_state
+  - audit_evidence_state
+  - operational_local_artifact
+  - nimicoding_managed_projection
+  - candidate_roadmap
+  - lifecycle_progress_state
 hard_constraints:
-  - canonical_target_root_must_be_.nimi/spec
-  - benchmark_blueprint_root_is_optional
-  - benchmark_blueprint_root_must_not_be_required_for_ordinary_projects
-  - mixed_inputs_may_include_code_docs_structure_and_human_notes
-  - kernel_markdown_and_kernel_tables_take_priority_over_generated_views_and_guides
-  - local_report_markdown_paths_must_use_topic_lifecycle_shape
-  - human_authored_topic_reports_must_use_.nimi/topics_as_canonical_root
+  - docs_roots_blanket_ingestion_is_forbidden
+  - canonical_target_root_must_be_.nimi/spec_for_product_authority_outputs_only
+  - each_input_file_must_have_an_accepted_surface_class_before_render
+  - generated_views_must_not_be_used_as_authority_inputs
+  - generated_views_must_render_to_stdout_only
+  - audit_state_and_lifecycle_state_must_not_be_used_as_product_authority_inputs
+  - nimicoding_managed_projections_may_be_read_as_project_context_but_not_as_product_authority_inputs
+  - generation_audit_outputs_must_default_to_.nimi/local/state/spec-generation

package/contracts/spec-reconstruction-result.yaml

@@ -1,9 +1,11 @@
-version: 1
+version: 2
 result_contract:
   id: delegated_spec_reconstruction_result
+  owner: nimi-coding
 summary_required_fields:
   - generated_paths
   - audit_ref
+  - placement_report_ref
   - coverage_summary
   - unresolved_file_count
   - inferred_file_count
@@ -15,17 +17,18 @@ summary_status_enum:
   - partial
   - blocked
 canonical_tree_completion:
-  profile_ref: .nimi/spec/_meta/spec-tree-model.yaml
+  profile_ref: .nimi/contracts/surface-taxonomy.schema.yaml
   generation_inputs_ref: .nimi/config/spec-generation-inputs.yaml
   audit_contract_ref: .nimi/contracts/spec-generation-audit.schema.yaml
-  audit_ref: .nimi/spec/_meta/spec-generation-audit.yaml
+  audit_ref: .nimi/local/state/spec-generation/spec-generation-audit.yaml
   required_tree_state: canonical_tree_ready
   required_files_valid: true
 completion_requirements:
   - canonical_tree_ready
   - declared_profile_required_files_valid
-  - declared_file_class_constraints_valid
-  - spec_generation_audit_present_and_valid
+  - declared_surface_class_constraints_valid
+  - placement_report_present_and_valid
+  - spec_generation_audit_present_and_valid_as_local_state
   - required_canonical_files_have_matching_audit_entries
   - unresolved_gaps_must_remain_explicit
   - blocked_must_be_reported_by_the_external_host
@@ -33,5 +36,6 @@ completion_requirements:
 locality: local_only
 semantic_constraints:
   - do_not_promote_closeout_summary_to_project_truth
+  - do_not_promote_generation_audit_to_product_truth
   - treat_declared_blueprint_as_benchmark_only_not_canonical_output_root
   - completed_reconstruction_means_reconstructed_or_partial_only

package/contracts/surface-taxonomy.schema.yaml

@@ -0,0 +1,201 @@
+version: 1
+contract:
+  id: nimicoding.surface-taxonomy.v1
+  owner: nimi-coding
+  purpose: Define every spec surface class before placement validation or migration.
+required_top_level_fields:
+  - version
+  - taxonomy
+  - class_enum
+  - authority_rank_enum
+  - tracking_policy_enum
+  - mutability_enum
+  - semantic_constraints
+class_required_fields:
+  - class_id
+  - owner_kind
+  - authority_rank
+  - allowed_roots
+  - tracking_policy
+  - mutability
+  - reference_rules
+  - promotion_rules
+  - fail_closed_cases
+shared_enum_ref: shared-enums.yaml
+taxonomy:
+  - class_id: product_authority
+    owner_kind: product_domain
+    authority_rank: active_product_canonical
+    allowed_roots: [".nimi/spec/<domain>/kernel/*.md"]
+    tracking_policy: tracked_required
+    mutability: human_admitted
+    reference_rules: [may_reference_product_authority_table, may_reference_thin_guidance, may_reference_minimal_host_projection_anchor]
+    promotion_rules: [only_admitted_topic_wave_may_change_product_authority]
+    fail_closed_cases: [contains_lifecycle_status, contains_audit_coverage, contains_package_methodology_body]
+  - class_id: product_authority_table
+    owner_kind: product_domain
+    authority_rank: active_product_canonical
+    allowed_roots: [".nimi/spec/<domain>/kernel/tables/*.yaml"]
+    tracking_policy: tracked_required
+    mutability: human_admitted
+    reference_rules: [must_declare_table_family, may_reference_product_authority]
+    promotion_rules: [table_family_must_be_product_authority_family]
+    fail_closed_cases: [missing_table_family, contains_status_or_coverage_fields, unknown_table_family]
+  - class_id: product_admission_registry
+    owner_kind: product_governance
+    authority_rank: support_only
+    allowed_roots: [".nimi/spec/high-risk-admissions.yaml"]
+    tracking_policy: tracked_required
+    mutability: human_admitted
+    reference_rules: [may_reference_topic_packets, must_use_packaged_schema, must_not_copy_package_mechanics]
+    promotion_rules: [only_explicit_manager_owned_decision_may_append_rows]
+    fail_closed_cases: [contains_package_methodology_body, contains_operational_runtime_state, missing_packaged_schema_ref]
+  - class_id: thin_guidance
+    owner_kind: product_domain
+    authority_rank: guidance_only
+    allowed_roots: [".nimi/spec/<domain>/*.md", ".nimi/spec/INDEX.md"]
+    tracking_policy: tracked_required
+    mutability: human_admitted
+    reference_rules: [may_reference_product_authority, must_not_define_rule_body]
+    promotion_rules: [normative_content_must_move_to_product_authority]
+    fail_closed_cases: [contains_must_rule_body, defines_new_rule_id, defines_acceptance_gate]
+  - class_id: derived_view
+    owner_kind: generator
+    authority_rank: derived_non_authority
+    allowed_roots: ["stdout_view"]
+    tracking_policy: untracked_stdout_only
+    mutability: generated_reproducible
+    reference_rules: [may_reference_declared_inputs, must_not_be_referenced_as_authority]
+    promotion_rules: [never_promote_derived_output]
+    fail_closed_cases: [referenced_as_authority, stored_under_product_authority_root, written_to_local_derived]
+  - class_id: spec_generation_state
+    owner_kind: spec_generator
+    authority_rank: lifecycle_state
+    allowed_roots: [".nimi/local/state/spec-generation/**"]
+    tracking_policy: local_only
+    mutability: operational_snapshot
+    reference_rules: [may_cite_inputs_and_generation_command]
+    promotion_rules: [never_promote_generation_state]
+    fail_closed_cases: [stored_under_.nimi/spec_meta, used_as_product_authority_input]
+  - class_id: audit_evidence_state
+    owner_kind: audit_workflow
+    authority_rank: evidence_only
+    allowed_roots: [".nimi/local/audit/**"]
+    tracking_policy: local_only
+    mutability: operational_snapshot
+    reference_rules: [may_cite_authority_refs, must_not_override_authority]
+    promotion_rules: [may_justify_change_packet_only]
+    fail_closed_cases: [stored_under_product_authority_root, contains_private_material_in_tracked_root]
+  - class_id: operational_local_artifact
+    owner_kind: host_adapter
+    authority_rank: operational_local
+    allowed_roots: [".nimi/local/**"]
+    tracking_policy: local_only
+    mutability: disposable
+    reference_rules: [may_be_cited_as_evidence]
+    promotion_rules: [never_promote_operational_artifact]
+    fail_closed_cases: [stored_under_.nimi/spec]
+  - class_id: methodology_authority
+    owner_kind: nimi_coding_package
+    authority_rank: package_canonical
+    allowed_roots: ["package://@nimiplatform/nimi-coding/{spec,methodology,contracts,config}/**"]
+    tracking_policy: tracked_required
+    mutability: package_admitted
+    reference_rules: [may_project_through_declared_projection_edge]
+    promotion_rules: [may_be_consumed_by_host_anchor_only]
+    fail_closed_cases: [copied_to_host_product_authority, stranded_in_host_spec]
+  - class_id: nimicoding_managed_projection
+    owner_kind: nimi_coding_package_projection
+    authority_rank: package_projection_support
+    allowed_roots: [".nimi/methodology/**", ".nimi/contracts/**", ".nimi/config/**"]
+    tracking_policy: tracked_required
+    mutability: package_projected
+    reference_rules: [may_be_read_as_project_local_nimicoding_context, must_not_override_product_authority]
+    promotion_rules: [created_or_refreshed_only_by_nimicoding_init_or_sync]
+    fail_closed_cases: [copied_to_host_product_authority, promoted_to_product_spec, drift_without_sync_policy]
+  - class_id: host_projection_anchor
+    owner_kind: host_projection
+    authority_rank: support_only
+    allowed_roots: [".nimi/spec/_meta/<package>-admission-anchor.yaml", ".nimi/config/host-overlay.yaml"]
+    tracking_policy: tracked_only_with_explicit_admission
+    mutability: human_admitted
+    reference_rules: [may_point_to_methodology_authority, must_be_minimal]
+    promotion_rules: [never_promote_to_product_authority]
+    fail_closed_cases: [contains_package_methodology_body, contains_lifecycle_status]
+  - class_id: candidate_roadmap
+    owner_kind: planning_owner
+    authority_rank: candidate_only
+    allowed_roots: [".nimi/topics/**"]
+    tracking_policy: local_only
+    mutability: human_admitted
+    reference_rules: [may_cite_product_authority, must_not_authorize_implementation]
+    promotion_rules: [must_move_to_product_authority_through_admitted_wave]
+    fail_closed_cases: [stored_under_.nimi/spec, referenced_as_active_authority]
+  - class_id: support_registry
+    owner_kind: package_or_product_owner
+    authority_rank: support_only
+    allowed_roots: ["package://@nimiplatform/nimi-coding/{config,contracts,spec}/**", ".nimi/spec/<domain>/kernel/tables/*.yaml"]
+    tracking_policy: tracked_only_with_explicit_admission
+    mutability: human_admitted
+    reference_rules: [may_register_evidence_commands, may_reference_product_authority]
+    promotion_rules: [semantic_rows_move_to_product_authority]
+    fail_closed_cases: [contains_status_field, contains_coverage_field, contains_audit_date, contains_progress_field]
+  - class_id: lifecycle_progress_state
+    owner_kind: topic_or_execution_workflow
+    authority_rank: lifecycle_state
+    allowed_roots: [".nimi/topics/**", ".nimi/local/state/**"]
+    tracking_policy: local_only
+    mutability: operational_snapshot
+    reference_rules: [may_cite_topic_packets_and_results]
+    promotion_rules: [never_promote_lifecycle_state]
+    fail_closed_cases: [stored_under_.nimi/spec, used_as_product_authority]
+class_enum:
+  - product_authority
+  - product_authority_table
+  - product_admission_registry
+  - thin_guidance
+  - derived_view
+  - spec_generation_state
+  - audit_evidence_state
+  - operational_local_artifact
+  - methodology_authority
+  - nimicoding_managed_projection
+  - host_projection_anchor
+  - candidate_roadmap
+  - support_registry
+  - lifecycle_progress_state
+authority_rank_enum:
+  - active_product_canonical
+  - package_canonical
+  - package_projection_support
+  - support_only
+  - guidance_only
+  - derived_non_authority
+  - evidence_only
+  - lifecycle_state
+  - operational_local
+  - candidate_only
+tracking_policy_enum:
+  - tracked_required
+  - tracked_forbidden
+  - local_only
+  - tracked_only_with_explicit_admission
+mutability_enum:
+  - human_admitted
+  - package_admitted
+  - package_projected
+  - generated_reproducible
+  - operational_snapshot
+  - disposable
+semantic_constraints:
+  - every_candidate_file_gets_exactly_one_surface_class
+  - unclassified_files_fail_closed
+  - product_authority_classes_must_not_contain_lifecycle_state_or_audit_coverage
+  - product_admission_registry_may_store_compact_semantic_admissions_but_not_package_mechanics
+  - generated_and_derived_classes_are_never_authority
+  - package_methodology_and_package_spec_remain_package_owned
+  - nimicoding_managed_projection_may_exist_in_host_project_but_is_not_product_authority
+  - host_projection_anchor_must_be_minimal_and_must_not_copy_package_body
+  - support_registry_must_not_store_run_or_coverage_status
+  - candidate_roadmap_must_not_live_under_.nimi/spec
+  - tracked_non_product_outputs_require_tracked_output_admission