@nimiplatform/nimi-coding 0.1.0

package/methodology/topic-lifecycle-report.yaml

@@ -0,0 +1,144 @@
+version: 2
+topic_lifecycle_report:
+  canonical_root: .nimi/topics
+  lifecycle_roots:
+    - proposal
+    - ongoing
+    - pending
+    - closed
+  topic_id_pattern: YYYY-MM-DD-topic-slug
+  topic_folder_shape: .nimi/topics/<state>/YYYY-MM-DD-topic-slug/
+  recommended_files:
+    - README.md
+    - design.md
+    - preflight.md
+    - waves.md
+    - packet-*.md
+    - closeout.md
+  state_evidence:
+    file: topic.yaml
+    required_fields:
+      - topic_id
+      - state
+      - created_at
+      - last_transition_at
+      - last_transition_reason
+  canonical_constraints:
+    human_authored_topic_reports_must_use_canonical_root: true
+    flat_topic_root_markdown_is_forbidden: true
+    legacy_local_report_root_allowed_for_human_topics: false
+    legacy_local_execution_workspace_is_primary: false
+  applicability_boundary:
+    default_posture: authority_bearing_or_high_risk_only
+    small_low_risk_changes_need_topic: false
+    recommended_only_when:
+      - authority_bearing
+      - high_risk_refactor
+      - multi_wave_iteration
+      - complex_remediation
+  movement_rules:
+    allowed:
+      - proposal_to_ongoing
+      - ongoing_to_pending
+      - pending_to_ongoing
+      - pending_to_closed
+      - ongoing_to_closed
+      - proposal_to_closed
+      - closed_to_ongoing
+      - ongoing_to_proposal
+    forbid_parallel_topic_copies: true
+  development_rhythm:
+    topic_role:
+      primary_unit: major_iteration_line
+      purpose:
+        - hold_one_canonical_planning_and_execution_home_for_a_large_line_of_work
+        - define_mainline_goal_stop_lines_and_deferred_scope_without_becoming_a_micro_backlog
+      must_not:
+        - scatter_one_iteration_line_across_parallel_sibling_topics
+        - turn_each_small_request_into_a_new_topic_by_default
+        - stay_in_indefinite_planning_without_wave_admission_or_pause
+        - normalize_topic_as_the_default_entrypoint_for_small_low_risk_work
+    wave_role:
+      primary_unit: bounded_execution_slice
+      required_properties:
+        - one_wave_owns_one_primary_closure_goal
+        - each_wave_names_explicit_scope_stop_line_checks_and_out_of_scope_follow_ons
+        - parallelism_is_allowed_only_inside_a_wave_after_its_contract_or_api_is_stable
+      preferred_closure_shapes:
+        - authority_cut
+        - implementation_packet
+        - bounded_reaudit
+        - explicit_pause_or_defer_note
+      pre_implementation_authority_convergence:
+        policy_ref: .nimi/methodology/authority-convergence-policy.yaml
+        audit_contract_ref: .nimi/contracts/authority-convergence-audit.schema.yaml
+        applies_before: implementation_dispatch
+        required_when:
+          - authority_or_spec_packet_is_selected
+          - selected_packet_refs_.nimi/spec_authority
+          - topic_declares_redesign_work_type
+        pass_condition: recorded_audit_result_PASS
+        fail_condition: NEEDS_REVISION_or_FAIL_returns_wave_to_revision
+        execution_projection_owner: host_adapter_profile
+    admission_rules:
+      proposal_stage:
+        allowed:
+          - baseline_design
+          - topic_audit
+          - candidate_wave_plan
+        forbidden:
+          - implementation_tracking
+          - admitted_wave_execution
+          - pseudo_phase_graph_across_sibling_topics
+      ongoing_entry_requires:
+        - exactly_one_selected_next_execution_target
+        - topic_local_preflight
+        - bounded_stop_line
+        - explicit_consumed_contexts_or_inputs
+        - expected_closeout_checks_or_evidence
+        - explicit_forbidden_reopenings
+      pending_stage:
+        allowed:
+          - usage_or_rollout_observation
+          - external_dependency_wait
+          - explicit_pause_note_with_reopen_or_close_criteria
+        forbidden:
+          - active_implementation_tracking
+          - silent_indefinite_dormancy_without_reopen_or_close_criteria
+      pending_entry_requires:
+        - no_active_implementation_wave
+        - explicit_pending_note_or_equivalent_status_record
+        - explicit_reopen_criteria_or_close_trigger
+        - bounded_reason_why_topic_is_not_yet_closed
+    preflight_contract:
+      required_fields:
+        - spec_status
+        - authority_owner
+        - work_type
+        - parallel_truth
+        - selected_wave
+        - consumed_inputs_or_contexts
+        - fixed_authority_surfaces
+        - stop_line
+        - closeout_checks
+        - forbidden_reopenings
+      guarantees:
+        - the_wave_is_admitted_because_a_real_target_is_selected_not_because_planning_continues
+        - local_topic_artifacts_do_not_silently_promote_parallel_truth
+    wave_limits:
+      planning_only:
+        maximum_consecutive_waves: 1
+        rationale: planning_may_harden_one_execution_target_but_must_not_become_an_endless_self_extension_loop
+      follow_on_rule:
+        - if_no_authority_cut_implementation_packet_or_explicit_pause_is_reached_after_a_planning_wave_the_topic_should_pause_or_re-preflight_instead_of_opening_unbounded_new_planning_waves
+    closeout_layers:
+      context_closure: a_context_has_reached_a_stable_planning_stop_line
+      wave_closeout: one_admitted_wave_reached_its_stop_line_with_bounded_evidence
+      pending_hold: a_topic_is_waiting_without_active_development_but_retains_explicit_reopen_or_close_criteria
+      topic_closeout: the_topic_is_no_longer_the_active_workstream
+      must_remain_distinct: true
+    anti_patterns:
+      - local_requirement_trap_where_small_requests_replace_the_mainline_goal
+      - giant_topic_planning_that_never_commits_to_a_bounded_wave
+      - pseudo_progress_where_new_wave_names_exist_without_new_closure
+      - reopening_deferred_scope_without_new_preflight

package/methodology/topic-lifecycle.yaml

@@ -0,0 +1,37 @@
+version: 1
+topic_lifecycle:
+  physical_roots:
+    - proposal
+    - ongoing
+    - pending
+    - closed
+  fine_grained_states:
+    - design_only
+    - implementation_ready
+    - implementation_active
+    - true_close_pending
+    - true_closed
+    - revoked
+    - superseded
+  transition_rules:
+    - proposal_to_ongoing
+    - ongoing_to_pending
+    - pending_to_ongoing
+    - ongoing_to_closed
+    - pending_to_closed
+    - closed_to_ongoing_requires_explicit_reopen
+  wave_states:
+    - candidate
+    - preflight_draft
+    - preflight_admitted
+    - implementation_admitted
+    - implementation_active
+    - needs_revision
+    - overflowed
+    - continuation_packet_open
+    - closed
+    - retired
+    - superseded
+  true_close_rules:
+    - passed_true_close_may_be_revoked_by_later_independent_audit
+    - revoked_true_close_requires_follow_up_lineage

package/methodology/topic-naming-ontology.yaml

@@ -0,0 +1,21 @@
+version: 1
+topic_naming_ontology:
+  topic_id_pattern: YYYY-MM-DD-topic-slug
+  wave_packet_patterns:
+    - packet-wave-<id>-<slug>-preflight.md
+    - packet-wave-<id>-<slug>-implementation.md
+    - packet-wave-<id>-exec-pack-<id>-<slug>.md
+  result_patterns:
+    - result-wave-<id>-<slug>-preflight.md
+    - result-wave-<id>-<slug>-implementation-admission.md
+    - result-wave-<id>-<slug>-implementation.md
+    - result-wave-<id>-<slug>-implementation-audit.md
+  special_patterns:
+    - decision-review-<slug>.md
+    - topic-true-close-audit.md
+    - closeout-topic-true-close.md
+  remediation_kind_enum:
+    - a
+    - b
+    - continuation
+    - execution_state_closure

package/methodology/topic-ontology.yaml

@@ -0,0 +1,38 @@
+version: 1
+topic_ontology:
+  primary_entities:
+    - topic
+    - wave
+    - packet
+    - result
+    - closeout
+  extended_entities:
+    - exec_pack
+    - remediation
+    - decision_review
+    - overflow_continuation
+    - true_close
+  root_artifacts:
+    - topic.yaml
+    - README.md
+    - design.md
+  governance_companions:
+    - preflight.md
+    - waves.md
+    - candidate-wave-plan.md
+    - implementation-doctrine.md
+    - admission-checklists.md
+    - manager-session-protocol.md
+    - manager-prompts.md
+  contract_refs:
+    topic: .nimi/contracts/topic.schema.yaml
+    wave: .nimi/contracts/wave.schema.yaml
+    packet: .nimi/contracts/packet.schema.yaml
+    result: .nimi/contracts/result.schema.yaml
+    closeout: .nimi/contracts/closeout.schema.yaml
+    admission_checklist: .nimi/contracts/admission-checklist.schema.yaml
+    remediation: .nimi/contracts/remediation.schema.yaml
+    decision_review: .nimi/contracts/decision-review.schema.yaml
+    overflow_continuation: .nimi/contracts/overflow-continuation.schema.yaml
+    true_close: .nimi/contracts/true-close.schema.yaml
+    forbidden_shortcuts_catalog: .nimi/contracts/forbidden-shortcuts.catalog.yaml

package/methodology/topic-validation-policy.yaml

@@ -0,0 +1,9 @@
+version: 1
+topic_validation_policy:
+  ignored_topic_validate_semantics:
+    status: report_only
+    canonical_success: false
+  ignore_for_default_validate:
+    - topic_id: 2026-04-20-desktop-agent-live2d-companion-substrate
+      reason: historical_dense_topic_pre_machine_wave_registry
+      posture: report_only_until_hard_cut_migration

package/methodology/wave-dag-policy.yaml

@@ -0,0 +1,14 @@
+version: 1
+wave_dag_policy:
+  principles:
+    - upstream_owner_cut_before_downstream_consumer_fan_out
+    - admitted_preflight_requires_real_dependency_readiness
+    - retired_or_superseded_waves_must_not_remain_dispatchable
+  parallelization:
+    allowed_only_when:
+      - owner_domain_is_already_stable
+      - write_sets_do_not_conflict
+      - manager_explicitly_allows_parallelism
+    forbidden_when:
+      - canonical_truth_is_still_being_defined
+      - downstream_wave_would_infer_upstream_shape

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@nimiplatform/nimi-coding",
+  "version": "0.1.0",
+  "private": false,
+  "description": "AI-native coding governance toolkit for bootstrapping .nimi/** into arbitrary projects.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nimiplatform/nimi"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "nimicoding": "./bin/nimicoding.mjs"
+  },
+  "engines": {
+    "node": ">=24.0.0",
+    "pnpm": ">=10.0.0"
+  },
+  "keywords": [
+    "ai",
+    "coding",
+    "governance",
+    "methodology",
+    "spec",
+    "nimicoding"
+  ],
+  "dependencies": {
+    "@openai/codex-sdk": "^0.124.0",
+    "yaml": "^2.8.1"
+  },
+  "files": [
+    "bin",
+    "cli",
+    "adapters",
+    "config",
+    "contracts",
+    "methodology",
+    "spec",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "check:pack": "npm pack --dry-run"
+  }
+}

package/spec/_meta/command-gating-matrix.yaml

@@ -0,0 +1,110 @@
+version: 1
+command_gating_matrix:
+  - command: start
+    allowed_tree_states:
+      - bootstrap_only
+      - spec_tree_seeded
+      - canonical_tree_in_progress
+      - canonical_tree_ready
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active
+    notes:
+      - seeds_or_continues_canonical_tree_work
+      - must_not_infer_completion_from_compact_target_files
+  - command: doctor
+    allowed_tree_states:
+      - bootstrap_only
+      - spec_tree_seeded
+      - canonical_tree_in_progress
+      - canonical_tree_ready
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active
+    reports:
+      - tree_state
+      - authority_mode
+      - blueprint_mode
+      - file_class_validity
+      - pipeline_readiness
+  - command: handoff
+    skill: spec_reconstruction
+    allowed_tree_states:
+      - bootstrap_only
+      - spec_tree_seeded
+      - canonical_tree_in_progress
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active
+  - command: handoff
+    skill: doc_spec_audit
+    allowed_tree_states:
+      - canonical_tree_in_progress
+      - canonical_tree_ready
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active
+  - command: handoff
+    skill: audit_sweep
+    allowed_tree_states:
+      - canonical_tree_ready
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active
+  - command: handoff
+    skill: high_risk_execution
+    allowed_tree_states:
+      - canonical_tree_ready
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active
+  - command: closeout
+    skill: spec_reconstruction
+    completed_requires:
+      tree_state: canonical_tree_ready
+      canonical_required_files_valid: true
+      spec_generation_audit_valid: true
+  - command: closeout
+    skill: doc_spec_audit
+    completed_requires:
+      tree_state: canonical_tree_ready
+      audit_references_canonical_root: true
+  - command: closeout
+    skill: audit_sweep
+    completed_requires:
+      tree_state: canonical_tree_ready
+      canonical_required_files_valid: true
+      spec_generation_audit_valid: true
+  - command: closeout
+    skill: high_risk_execution
+    completed_requires:
+      tree_state: canonical_tree_ready
+      canonical_required_files_valid: true
+      high_risk_admissions_truth_ref: .nimi/spec/high-risk-admissions.yaml
+  - command: ingest-high-risk-execution
+    requires:
+      tree_state: canonical_tree_ready
+      authority_mode:
+        - external_authority_active
+        - canonical_cutover_ready
+        - canonical_active
+  - command: review-high-risk-execution
+    requires:
+      tree_state: canonical_tree_ready
+  - command: decide-high-risk-execution
+    requires:
+      tree_state: canonical_tree_ready
+  - command: admit-high-risk-decision
+    requires:
+      tree_state: canonical_tree_ready
+      canonical_admissions_truth: .nimi/spec/high-risk-admissions.yaml
+    allowed_authority_modes:
+      - external_authority_active
+      - canonical_cutover_ready
+      - canonical_active

package/spec/_meta/generate-drift-migration-checklist.yaml

@@ -0,0 +1,155 @@
+version: 1
+generate_drift_migration_checklist:
+  posture: subordinate_evidence_table_for_drift_pipeline_gate
+  decision_authority_ref: .nimi/spec/_meta/spec-authority-cutover-readiness.yaml
+  entries:
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope runtime
+      current_canonical_input_root: spec/runtime/kernel
+      current_generated_output_root: spec/runtime/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
+      post_cutover_generated_output_root: .nimi/spec/runtime/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope cognition
+      current_canonical_input_root: spec/cognition/kernel
+      current_generated_output_root: spec/cognition/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/cognition/kernel
+      post_cutover_generated_output_root: .nimi/spec/cognition/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope sdk
+      current_canonical_input_root: spec/sdk/kernel
+      current_generated_output_root: spec/sdk/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/sdk/kernel
+      post_cutover_generated_output_root: .nimi/spec/sdk/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope desktop
+      current_canonical_input_root: spec/desktop/kernel
+      current_generated_output_root: spec/desktop/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/desktop/kernel
+      post_cutover_generated_output_root: .nimi/spec/desktop/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope future
+      current_canonical_input_root: spec/future/kernel
+      current_generated_output_root: spec/future/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/future/kernel
+      post_cutover_generated_output_root: .nimi/spec/future/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope platform
+      current_canonical_input_root: spec/platform/kernel
+      current_generated_output_root: spec/platform/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/platform/kernel
+      post_cutover_generated_output_root: .nimi/spec/platform/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope realm
+      current_canonical_input_root: spec/realm/kernel
+      current_generated_output_root: spec/realm/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/realm/kernel
+      post_cutover_generated_output_root: .nimi/spec/realm/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc
+      current_canonical_input_root: spec
+      current_generated_output_root: spec/generated/nimi-spec.md
+      post_cutover_canonical_input_root: .nimi/spec
+      post_cutover_generated_output_root: spec/generated/nimi-spec.md
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc --check
+      current_canonical_input_root: spec
+      current_generated_output_root: spec/generated/nimi-spec.md
+      post_cutover_canonical_input_root: .nimi/spec
+      post_cutover_generated_output_root: spec/generated/nimi-spec.md
+      update_phase: phase_5_flip
+    - command: pnpm check:spec-semantic-completeness
+      current_canonical_input_root: spec
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm check:runtime-proto-spec-linkage
+      current_canonical_input_root: spec/runtime/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope runtime --check
+      current_canonical_input_root: spec/runtime/kernel
+      current_generated_output_root: spec/runtime/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
+      post_cutover_generated_output_root: .nimi/spec/runtime/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope cognition --check
+      current_canonical_input_root: spec/cognition/kernel
+      current_generated_output_root: spec/cognition/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/cognition/kernel
+      post_cutover_generated_output_root: .nimi/spec/cognition/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope sdk --check
+      current_canonical_input_root: spec/sdk/kernel
+      current_generated_output_root: spec/sdk/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/sdk/kernel
+      post_cutover_generated_output_root: .nimi/spec/sdk/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope desktop --check
+      current_canonical_input_root: spec/desktop/kernel
+      current_generated_output_root: spec/desktop/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/desktop/kernel
+      post_cutover_generated_output_root: .nimi/spec/desktop/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope desktop-consistency
+      current_canonical_input_root: spec/desktop/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/desktop/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope future --check
+      current_canonical_input_root: spec/future/kernel
+      current_generated_output_root: spec/future/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/future/kernel
+      post_cutover_generated_output_root: .nimi/spec/future/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope runtime-consistency
+      current_canonical_input_root: spec/runtime/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope cognition-consistency
+      current_canonical_input_root: spec/cognition/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/cognition/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope sdk-consistency
+      current_canonical_input_root: spec/sdk/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/sdk/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope future-consistency
+      current_canonical_input_root: spec/future/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/future/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope platform-consistency
+      current_canonical_input_root: spec/platform/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/platform/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope platform --check
+      current_canonical_input_root: spec/platform/kernel
+      current_generated_output_root: spec/platform/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/platform/kernel
+      post_cutover_generated_output_root: .nimi/spec/platform/kernel/generated
+      update_phase: phase_3_preparation
+    - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope realm-consistency
+      current_canonical_input_root: spec/realm/kernel
+      current_generated_output_root: none
+      post_cutover_canonical_input_root: .nimi/spec/realm/kernel
+      post_cutover_generated_output_root: none
+      update_phase: phase_5_flip
+    - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope realm --check
+      current_canonical_input_root: spec/realm/kernel
+      current_generated_output_root: spec/realm/kernel/generated
+      post_cutover_canonical_input_root: .nimi/spec/realm/kernel
+      post_cutover_generated_output_root: .nimi/spec/realm/kernel/generated
+      update_phase: phase_3_preparation

package/spec/_meta/governance-routing-cutover-checklist.yaml

@@ -0,0 +1,35 @@
+version: 1
+governance_routing_cutover_checklist:
+  posture: subordinate_evidence_table_for_governance_routing_gate
+  decision_authority_ref: .nimi/spec/_meta/spec-authority-cutover-readiness.yaml
+  entries:
+    - file: CLAUDE.md
+      current_active_authority: spec/**
+      current_generated_canonical_root: .nimi/spec/**
+      post_cutover_active_authority: .nimi/spec/**
+      update_phase: phase_5_flip
+    - file: AGENTS.md
+      current_active_authority: spec/**
+      current_generated_canonical_root: .nimi/spec/**
+      post_cutover_active_authority: .nimi/spec/**
+      update_phase: phase_5_flip
+    - file: spec/AGENTS.md
+      current_active_authority: spec/**
+      current_generated_canonical_root: .nimi/spec/**
+      post_cutover_active_authority: archived_or_derived_only
+      update_phase: phase_5_flip
+    - file: nimi-coding/README.md
+      current_active_authority: spec/**
+      current_generated_canonical_root: .nimi/spec/**
+      post_cutover_active_authority: canonical_spec_contract_docs
+      update_phase: phase_3_preparation
+    - file: nimi-coding/adapters/oh-my-codex/README.md
+      current_active_authority: spec/**
+      current_generated_canonical_root: .nimi/spec/**
+      post_cutover_active_authority: explicit_cutover_doc_required
+      update_phase: phase_3_preparation
+    - file: nimi-coding/cli/lib/entrypoints.mjs
+      current_active_authority: spec/**
+      current_generated_canonical_root: .nimi/spec/**
+      post_cutover_active_authority: managed_entrypoint_flip_requires_explicit_redesign_admission
+      update_phase: phase_3_preparation

package/spec/_meta/phase2-impacted-surface-matrix.yaml

@@ -0,0 +1,44 @@
+version: 1
+phase2_impacted_surface_matrix:
+  - surface: start_command
+    paths:
+      - nimi-coding/cli/commands/start.mjs
+    phase_dependency: phase_2
+    rewrite_reason: replace_compact_target_truth_gating_with_canonical_tree_gating
+  - surface: doctor_logic
+    paths:
+      - nimi-coding/cli/lib/doctor.mjs
+      - nimi-coding/cli/constants.mjs
+    phase_dependency: phase_2
+    rewrite_reason: replace_target_truth_completion_model_with_tree_state_and_authority_mode
+  - surface: handoff_logic
+    paths:
+      - nimi-coding/cli/lib/handoff.mjs
+    phase_dependency: phase_2
+    rewrite_reason: gate_skill_handoff_on_command_gating_matrix
+  - surface: closeout_logic
+    paths:
+      - nimi-coding/cli/lib/closeout.mjs
+    phase_dependency: phase_2
+    rewrite_reason: completed_outcomes_must_use_canonical_tree_readiness
+  - surface: high_risk_ingest_review_decision_admission
+    paths:
+      - nimi-coding/cli/lib/high-risk-ingest.mjs
+      - nimi-coding/cli/lib/high-risk-review.mjs
+      - nimi-coding/cli/lib/high-risk-decision.mjs
+      - nimi-coding/cli/lib/high-risk-admission.mjs
+    phase_dependency: phase_2
+    rewrite_reason: replace_legacy_target_truth_gates_with_tree_state_gates
+  - surface: contracts_and_methodology
+    paths:
+      - nimi-coding/contracts/spec-reconstruction-result.yaml
+      - nimi-coding/methodology/spec-reconstruction.yaml
+      - nimi-coding/methodology/spec-target-truth-profile.yaml
+    phase_dependency: historical_transition_note
+    rewrite_reason: repo_local_support_profile_no_longer_defines_default_reconstruction_completion
+  - surface: tests_and_fixtures
+    paths:
+      - nimi-coding/test/nimicoding.test.mjs
+      - nimi-coding/test/fixtures/validators/execution-packet.valid.yaml
+    phase_dependency: phase_2
+    rewrite_reason: legacy_helpers_and_assertions_assume_five_file_target_truth