@nimiplatform/nimi-coding 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/README.md +19 -20
  2. package/adapters/oh-my-codex/README.md +8 -9
  3. package/cli/commands/audit-sweep.mjs +10 -10
  4. package/cli/commands/classify-spec-tree.mjs +5 -0
  5. package/cli/commands/closeout.mjs +3 -0
  6. package/cli/commands/generate-spec-derived-docs.mjs +20 -0
  7. package/cli/commands/generate-spec-migration-plan.mjs +30 -0
  8. package/cli/commands/start.mjs +5 -1
  9. package/cli/commands/surface-validator-command.mjs +49 -0
  10. package/cli/commands/sweep-design.mjs +295 -0
  11. package/cli/commands/sweep.mjs +22 -0
  12. package/cli/commands/sync.mjs +132 -0
  13. package/cli/commands/topic-formatters.mjs +8 -8
  14. package/cli/commands/validate-ai-governance.mjs +167 -46
  15. package/cli/commands/validate-domain-admission.mjs +5 -0
  16. package/cli/commands/validate-guidance-bodies.mjs +5 -0
  17. package/cli/commands/validate-placement.mjs +5 -0
  18. package/cli/commands/validate-projection-edges.mjs +5 -0
  19. package/cli/commands/validate-spec-audit.mjs +5 -1
  20. package/cli/commands/validate-table-family.mjs +5 -0
  21. package/cli/commands/validate-tracked-output-admission.mjs +5 -0
  22. package/cli/constants.mjs +5 -49
  23. package/cli/help.mjs +33 -11
  24. package/cli/index.mjs +20 -2
  25. package/cli/lib/audit-sweep-runtime/admissions.mjs +38 -29
  26. package/cli/lib/audit-sweep-runtime/audit-validity.mjs +8 -0
  27. package/cli/lib/audit-sweep-runtime/chunks.mjs +11 -11
  28. package/cli/lib/audit-sweep-runtime/closeout.mjs +8 -8
  29. package/cli/lib/audit-sweep-runtime/codex-auditor-evidence.mjs +3 -3
  30. package/cli/lib/audit-sweep-runtime/codex-auditor.mjs +10 -10
  31. package/cli/lib/audit-sweep-runtime/common.mjs +7 -7
  32. package/cli/lib/audit-sweep-runtime/format.mjs +3 -3
  33. package/cli/lib/audit-sweep-runtime/ingest.mjs +8 -8
  34. package/cli/lib/audit-sweep-runtime/inventory-spec-chunks.mjs +24 -27
  35. package/cli/lib/audit-sweep-runtime/inventory.mjs +58 -18
  36. package/cli/lib/audit-sweep-runtime/ledger.mjs +1 -1
  37. package/cli/lib/audit-sweep-runtime/p0p1-profile.mjs +2 -2
  38. package/cli/lib/audit-sweep-runtime/remediation.mjs +6 -6
  39. package/cli/lib/audit-sweep-runtime/rerun.mjs +6 -6
  40. package/cli/lib/audit-sweep-runtime/status.mjs +1 -1
  41. package/cli/lib/audit-sweep-runtime/validators.mjs +2 -2
  42. package/cli/lib/authority-convergence.mjs +397 -2
  43. package/cli/lib/blueprint-audit.mjs +5 -5
  44. package/cli/lib/closeout.mjs +126 -3
  45. package/cli/lib/contracts.mjs +21 -17
  46. package/cli/lib/handoff.mjs +29 -11
  47. package/cli/lib/high-risk-admission.mjs +60 -11
  48. package/cli/lib/high-risk-decision.mjs +31 -2
  49. package/cli/lib/high-risk-ingest.mjs +5 -1
  50. package/cli/lib/high-risk-review.mjs +5 -1
  51. package/cli/lib/internal/contracts-parse.mjs +195 -24
  52. package/cli/lib/internal/contracts-validators.mjs +3 -2
  53. package/cli/lib/internal/doctor-bootstrap-surface.mjs +82 -35
  54. package/cli/lib/internal/doctor-delegated-surface.mjs +1 -1
  55. package/cli/lib/internal/doctor-finalize.mjs +12 -8
  56. package/cli/lib/internal/doctor-inspectors.mjs +34 -1
  57. package/cli/lib/internal/governance/ai/ai-context-budget-core.mjs +74 -12
  58. package/cli/lib/internal/governance/ai/ai-structure-budget-core.mjs +24 -6
  59. package/cli/lib/internal/governance/ai/check-agents-freshness.mjs +18 -23
  60. package/cli/lib/internal/surface-taxonomy-validators.mjs +931 -0
  61. package/cli/lib/internal/validators-spec.mjs +229 -20
  62. package/cli/lib/sweep-design-runtime/common.mjs +246 -0
  63. package/cli/lib/sweep-design-runtime/engine.mjs +733 -0
  64. package/cli/lib/sweep-design-runtime/fix-topic.mjs +414 -0
  65. package/cli/lib/sweep-design-runtime/lifecycle.mjs +54 -0
  66. package/cli/lib/sweep-design-runtime/results.mjs +324 -0
  67. package/cli/lib/sweep-design.mjs +8 -0
  68. package/cli/lib/sync.mjs +143 -0
  69. package/cli/lib/topic-artifacts.mjs +186 -0
  70. package/cli/lib/topic-authority-coverage.mjs +73 -0
  71. package/cli/lib/topic-closeout.mjs +560 -0
  72. package/cli/lib/topic-common.mjs +404 -0
  73. package/cli/lib/topic-decisions.mjs +332 -0
  74. package/cli/lib/topic-draft-packets.mjs +126 -7
  75. package/cli/lib/topic-execution.mjs +515 -0
  76. package/cli/lib/topic-goal.mjs +112 -33
  77. package/cli/lib/topic-ledger.mjs +281 -0
  78. package/cli/lib/topic-lifecycle-artifacts.mjs +173 -0
  79. package/cli/lib/topic-root-validation.mjs +288 -0
  80. package/cli/lib/topic-runner-commands.mjs +174 -0
  81. package/cli/lib/topic-runner-deferral.mjs +532 -0
  82. package/cli/lib/topic-runner-stale-gates.mjs +114 -0
  83. package/cli/lib/topic-runner-validation.mjs +138 -0
  84. package/cli/lib/topic-runner.mjs +109 -154
  85. package/cli/lib/topic-scaffold.mjs +252 -0
  86. package/cli/lib/topic-waves.mjs +403 -0
  87. package/cli/lib/topic.mjs +81 -93
  88. package/cli/lib/value-helpers.mjs +6 -1
  89. package/cli/seeds/bootstrap.mjs +96 -20
  90. package/cli/seeds/seed-policy.yaml +67 -0
  91. package/config/bootstrap.yaml +1 -1
  92. package/config/skill-manifest.yaml +4 -2
  93. package/config/spec-generation-inputs.yaml +41 -19
  94. package/contracts/audit-remediation-map.schema.yaml +1 -0
  95. package/contracts/audit-sweep-result.yaml +4 -0
  96. package/contracts/domain-admission.schema.yaml +56 -0
  97. package/contracts/migration-inventory.schema.yaml +80 -0
  98. package/contracts/negative-fixtures.yaml +91 -0
  99. package/contracts/placement-contract.schema.yaml +163 -0
  100. package/contracts/projection-edge.schema.yaml +130 -0
  101. package/contracts/shared-enums.yaml +68 -0
  102. package/contracts/spec-generation-audit.schema.yaml +19 -4
  103. package/contracts/spec-generation-inputs.schema.yaml +130 -29
  104. package/contracts/spec-reconstruction-result.yaml +9 -5
  105. package/contracts/surface-taxonomy.schema.yaml +201 -0
  106. package/contracts/sweep-design-result.yaml +349 -0
  107. package/contracts/table-family.schema.yaml +114 -0
  108. package/contracts/topic-goal.schema.yaml +10 -1
  109. package/contracts/tracked-output-admission.schema.yaml +70 -0
  110. package/contracts/workflow-consumer.schema.yaml +112 -0
  111. package/methodology/audit-sweep-p0p1-recall.yaml +1 -1
  112. package/methodology/spec-reconstruction.yaml +53 -30
  113. package/package.json +5 -4
  114. package/spec/_meta/command-gating-matrix.yaml +33 -0
  115. package/spec/_meta/generate-drift-migration-checklist.yaml +44 -62
  116. package/spec/_meta/governance-routing-cutover-checklist.yaml +3 -3
  117. package/spec/_meta/phase2-impacted-surface-matrix.yaml +14 -14
  118. package/spec/_meta/spec-authority-cutover-readiness.yaml +3 -5
  119. package/spec/_meta/spec-tree-model.yaml +104 -36
  120. package/spec/bootstrap-state.yaml +36 -36
  121. package/spec/product-scope.yaml +13 -10
@@ -1,63 +1,86 @@
1
- version: 1
1
+ version: 2
2
2
  reconstruction:
3
3
  required: true
4
- owner: ai_skills
4
+ owner: nimi-coding
5
5
  generation_inputs_ref: .nimi/config/spec-generation-inputs.yaml
6
- spec_tree_model_ref: .nimi/spec/_meta/spec-tree-model.yaml
6
+ surface_taxonomy_ref: .nimi/contracts/surface-taxonomy.schema.yaml
7
+ placement_contract_ref: .nimi/contracts/placement-contract.schema.yaml
8
+ table_family_contract_ref: .nimi/contracts/table-family.schema.yaml
9
+ domain_admission_contract_ref: .nimi/contracts/domain-admission.schema.yaml
10
+ tracked_output_admission_contract_ref: .nimi/contracts/tracked-output-admission.schema.yaml
11
+ spec_tree_model_ref: .nimi/contracts/surface-taxonomy.schema.yaml
7
12
  result_contract_ref: .nimi/contracts/spec-reconstruction-result.yaml
8
13
  trigger:
9
14
  bootstrap_state: bootstrap_only
10
15
  goals:
11
16
  - establish_project_canonical_rule_root
12
- - generate_canonical_tree_under_.nimi/spec
13
- - generate_file_level_audit_metadata_under_.nimi/spec/_meta
14
- - separate_normative_derived_and_guidance_surfaces
15
- - extract_core_rules_without_parallel_truth
16
- - accept_mixed_inputs_from_code_docs_structure_and_human_notes
17
- - preserve_semantic_and_structural_parity_when_blueprint_exists
17
+ - classify_every_spec_surface_before_generation
18
+ - keep_product_authority_under_.nimi/spec
19
+ - keep_package_methodology_under_nimi-coding
20
+ - keep_generation_audit_state_under_.nimi/local/state/spec-generation
21
+ - keep_audit_evidence_under_.nimi/local/audit
22
+ - separate_product_authority_tables_from_support_registries
23
+ - reject_generated_views_as_authority_inputs
24
+ - reject_lifecycle_state_as_product_authority
25
+ - accept_mixed_inputs_only_through_class_filtered_inputs
18
26
  - preserve_authority_explicitness
19
27
  - stop_on_authority_ambiguity
20
28
  target_root: .nimi/spec
21
- audit_root: .nimi/spec/_meta/spec-generation-audit.yaml
29
+ audit_root: .nimi/local/state/spec-generation/spec-generation-audit.yaml
22
30
  target_tree_shape:
23
- required_file_classes:
24
- - index
25
- - kernel_markdown
26
- - kernel_tables
27
- optional_file_classes:
28
- - kernel_generated
29
- - domain_guides
31
+ required_surface_classes:
32
+ - product_authority
33
+ - product_authority_table
34
+ - thin_guidance
35
+ optional_surface_classes:
36
+ - host_projection_anchor
37
+ - support_registry
38
+ forbidden_surface_classes:
39
+ - derived_view
40
+ - spec_generation_state
41
+ - audit_evidence_state
42
+ - operational_local_artifact
43
+ - nimicoding_managed_projection
44
+ - candidate_roadmap
45
+ - lifecycle_progress_state
46
+ - methodology_authority
30
47
  minimal_required_outputs:
31
48
  - .nimi/spec/INDEX.md
32
49
  - .nimi/spec/project/kernel/index.md
33
50
  - .nimi/spec/project/kernel/core-rules.md
34
51
  - .nimi/spec/project/kernel/tables/rule-catalog.yaml
35
52
  minimum_generation_sequence:
36
- - .nimi/spec/INDEX.md
37
- - .nimi/spec/project/kernel/index.md
38
- - .nimi/spec/project/kernel/core-rules.md
39
- - .nimi/spec/project/kernel/tables/rule-catalog.yaml
53
+ - classify_inputs
54
+ - validate_placement
55
+ - write_product_authority
56
+ - write_product_authority_tables
57
+ - write_thin_guidance
58
+ - write_local_generation_audit
40
59
  skeleton_rules:
41
- - generate_minimal_kernel_before_optional_guides_and_generated_views
42
- - keep_first_pass_scope_small_and_explicit
43
- - add_domain_guides_only_after_kernel_markdown_and_tables_exist
60
+ - generate_minimal_kernel_before_optional_guides
61
+ - declare_table_family_before_accepting_kernel_table
62
+ - add_domain_guides_only_as_thin_guidance
44
63
  - treat_missing_rules_as_explicit_gaps_not_implicit_completion
64
+ - treat_unclassified_files_as_fail_closed
45
65
  benchmark_acceptance:
46
66
  mode: semantic_and_structural_parity_when_blueprint_exists
47
67
  blueprint_is_optional: true
48
- benchmark_reference_ref: .nimi/spec/_meta/blueprint-reference.yaml
68
+ benchmark_reference_ref: .nimi/local/state/spec-generation/blueprint-reference.yaml
49
69
  hard_constraints:
50
70
  - no_human_friendly_parallel_truth
51
71
  - no_silent_authority_inference
52
72
  - no_project_source_mutation_during_reconstruction
53
- - write_only_under_.nimi/spec_for_canonical_generation_outputs
54
- - write_file_level_generation_audit_under_.nimi/spec/_meta/spec-generation-audit.yaml
73
+ - write_product_authority_outputs_only_under_.nimi/spec
74
+ - write_file_level_generation_audit_under_.nimi/local/state/spec-generation
75
+ - never_write_generation_audit_under_.nimi/spec/_meta
55
76
  - every_generated_canonical_file_requires_explicit_source_basis_and_unresolved_gap_tracking
56
- - respect_skill_manifest_installer_runtime_result_contract_host_profile_and_handoff_truth
77
+ - every_input_file_requires_surface_class_before_generation
78
+ - package_methodology_and_package_spec_must_not_be_promoted_into_.nimi/spec
79
+ - host_projection_anchors_must_be_minimal_and_admitted
57
80
  - unresolved_ambiguity_must_remain_explicit
58
81
  - do_not_treat_repo_local_support_files_as_canonical_tree_completion
59
- lifecycle_contract_ref: .nimi/spec/bootstrap-state.yaml
82
+ lifecycle_contract_ref: .nimi/contracts/spec-reconstruction-result.yaml
60
83
  completion_gate:
61
84
  bootstrap_state_tree_state: canonical_tree_ready
62
- required_profile: minimal
85
+ required_profile: surface_taxonomy_v1
63
86
  audit_contract_ref: .nimi/contracts/spec-generation-audit.schema.yaml
package/package.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@nimiplatform/nimi-coding",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "private": false,
5
5
  "description": "AI-native coding governance toolkit for bootstrapping .nimi/** into arbitrary projects.",
6
6
  "license": "MIT",
7
7
  "repository": {
8
8
  "type": "git",
9
- "url": "https://github.com/nimiplatform/nimi"
9
+ "url": "git+https://github.com/nimiplatform/nimi-coding.git"
10
10
  },
11
11
  "type": "module",
12
12
  "publishConfig": {
@@ -16,6 +16,7 @@
16
16
  "bin": {
17
17
  "nimicoding": "./bin/nimicoding.mjs"
18
18
  },
19
+ "packageManager": "pnpm@10.32.1",
19
20
  "engines": {
20
21
  "node": ">=24.0.0",
21
22
  "pnpm": ">=10.0.0"
@@ -44,7 +45,7 @@
44
45
  "LICENSE"
45
46
  ],
46
47
  "scripts": {
47
- "test": "node --test",
48
+ "test": "NIMICODING_LANG=en NO_COLOR=1 node --test",
48
49
  "check:pack": "npm pack --dry-run"
49
50
  }
50
- }
51
+ }
@@ -56,6 +56,39 @@ command_gating_matrix:
56
56
  - external_authority_active
57
57
  - canonical_cutover_ready
58
58
  - canonical_active
59
+ - command: sweep audit
60
+ replaces:
61
+ - audit-sweep
62
+ allowed_tree_states:
63
+ - canonical_tree_ready
64
+ allowed_authority_modes:
65
+ - external_authority_active
66
+ - canonical_cutover_ready
67
+ - canonical_active
68
+ writes:
69
+ - .nimi/local/audit/**
70
+ rules:
71
+ - top_level_audit_sweep_is_not_a_canonical_entrypoint
72
+ - audit_findings_remain_local_operational_evidence_until_admitted_through_topic_or_closeout
73
+ - remediation_map_output_is_candidate_planning_input_not_worker_dispatch_authority
74
+ - command: sweep design
75
+ allowed_tree_states:
76
+ - canonical_tree_ready
77
+ allowed_authority_modes:
78
+ - external_authority_active
79
+ - canonical_cutover_ready
80
+ - canonical_active
81
+ reads:
82
+ - .nimi/local/audit/evidence/<sweep-id>/findings.yaml
83
+ writes:
84
+ - .nimi/local/sweep-design/<run-id>/**
85
+ rules:
86
+ - source_audit_findings_are_read_only
87
+ - intake_forks_findings_into_a_design_workset
88
+ - cluster_groups_findings_by_owner_authority_root_cause_contract_and_repair_target
89
+ - fork_review_must_resolve_to_authority_ref_or_mark_authority_alignment_required
90
+ - focused_plan_stops_on_user_decision
91
+ - wave_plan_is_non_mutating_and_worker_dispatch_remains_disallowed_until_topic_admission
59
92
  - command: handoff
60
93
  skill: high_risk_execution
61
94
  allowed_tree_states:
@@ -5,151 +5,133 @@ generate_drift_migration_checklist:
5
5
  entries:
6
6
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope runtime
7
7
  current_canonical_input_root: spec/runtime/kernel
8
- current_generated_output_root: spec/runtime/kernel/generated
8
+ current_generated_output_root: stdout_view
9
9
  post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
10
- post_cutover_generated_output_root: .nimi/spec/runtime/kernel/generated
10
+ post_cutover_generated_output_root: stdout_view
11
11
  update_phase: phase_3_preparation
12
12
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope cognition
13
13
  current_canonical_input_root: spec/cognition/kernel
14
- current_generated_output_root: spec/cognition/kernel/generated
14
+ current_generated_output_root: stdout_view
15
15
  post_cutover_canonical_input_root: .nimi/spec/cognition/kernel
16
- post_cutover_generated_output_root: .nimi/spec/cognition/kernel/generated
16
+ post_cutover_generated_output_root: stdout_view
17
17
  update_phase: phase_3_preparation
18
18
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope sdk
19
19
  current_canonical_input_root: spec/sdk/kernel
20
- current_generated_output_root: spec/sdk/kernel/generated
20
+ current_generated_output_root: stdout_view
21
21
  post_cutover_canonical_input_root: .nimi/spec/sdk/kernel
22
- post_cutover_generated_output_root: .nimi/spec/sdk/kernel/generated
22
+ post_cutover_generated_output_root: stdout_view
23
23
  update_phase: phase_3_preparation
24
24
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope desktop
25
25
  current_canonical_input_root: spec/desktop/kernel
26
- current_generated_output_root: spec/desktop/kernel/generated
26
+ current_generated_output_root: stdout_view
27
27
  post_cutover_canonical_input_root: .nimi/spec/desktop/kernel
28
- post_cutover_generated_output_root: .nimi/spec/desktop/kernel/generated
29
- update_phase: phase_3_preparation
30
- - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope future
31
- current_canonical_input_root: spec/future/kernel
32
- current_generated_output_root: spec/future/kernel/generated
33
- post_cutover_canonical_input_root: .nimi/spec/future/kernel
34
- post_cutover_generated_output_root: .nimi/spec/future/kernel/generated
28
+ post_cutover_generated_output_root: stdout_view
35
29
  update_phase: phase_3_preparation
36
30
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope platform
37
31
  current_canonical_input_root: spec/platform/kernel
38
- current_generated_output_root: spec/platform/kernel/generated
32
+ current_generated_output_root: stdout_view
39
33
  post_cutover_canonical_input_root: .nimi/spec/platform/kernel
40
- post_cutover_generated_output_root: .nimi/spec/platform/kernel/generated
34
+ post_cutover_generated_output_root: stdout_view
41
35
  update_phase: phase_3_preparation
42
36
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope realm
43
37
  current_canonical_input_root: spec/realm/kernel
44
- current_generated_output_root: spec/realm/kernel/generated
38
+ current_generated_output_root: stdout_view
45
39
  post_cutover_canonical_input_root: .nimi/spec/realm/kernel
46
- post_cutover_generated_output_root: .nimi/spec/realm/kernel/generated
40
+ post_cutover_generated_output_root: stdout_view
47
41
  update_phase: phase_3_preparation
48
42
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc
49
43
  current_canonical_input_root: spec
50
- current_generated_output_root: spec/generated/nimi-spec.md
44
+ current_generated_output_root: stdout_view
51
45
  post_cutover_canonical_input_root: .nimi/spec
52
- post_cutover_generated_output_root: spec/generated/nimi-spec.md
46
+ post_cutover_generated_output_root: stdout_view
53
47
  update_phase: phase_5_flip
54
48
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc --check
55
49
  current_canonical_input_root: spec
56
- current_generated_output_root: spec/generated/nimi-spec.md
50
+ current_generated_output_root: stdout_view
57
51
  post_cutover_canonical_input_root: .nimi/spec
58
- post_cutover_generated_output_root: spec/generated/nimi-spec.md
52
+ post_cutover_generated_output_root: stdout_view
59
53
  update_phase: phase_5_flip
60
54
  - command: pnpm check:spec-semantic-completeness
61
55
  current_canonical_input_root: spec
62
- current_generated_output_root: none
56
+ current_generated_output_root: stdout_view
63
57
  post_cutover_canonical_input_root: .nimi/spec
64
- post_cutover_generated_output_root: none
58
+ post_cutover_generated_output_root: stdout_view
65
59
  update_phase: phase_5_flip
66
60
  - command: pnpm check:runtime-proto-spec-linkage
67
61
  current_canonical_input_root: spec/runtime/kernel
68
- current_generated_output_root: none
62
+ current_generated_output_root: stdout_view
69
63
  post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
70
- post_cutover_generated_output_root: none
64
+ post_cutover_generated_output_root: stdout_view
71
65
  update_phase: phase_5_flip
72
66
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope runtime --check
73
67
  current_canonical_input_root: spec/runtime/kernel
74
- current_generated_output_root: spec/runtime/kernel/generated
68
+ current_generated_output_root: stdout_view
75
69
  post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
76
- post_cutover_generated_output_root: .nimi/spec/runtime/kernel/generated
70
+ post_cutover_generated_output_root: stdout_view
77
71
  update_phase: phase_3_preparation
78
72
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope cognition --check
79
73
  current_canonical_input_root: spec/cognition/kernel
80
- current_generated_output_root: spec/cognition/kernel/generated
74
+ current_generated_output_root: stdout_view
81
75
  post_cutover_canonical_input_root: .nimi/spec/cognition/kernel
82
- post_cutover_generated_output_root: .nimi/spec/cognition/kernel/generated
76
+ post_cutover_generated_output_root: stdout_view
83
77
  update_phase: phase_3_preparation
84
78
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope sdk --check
85
79
  current_canonical_input_root: spec/sdk/kernel
86
- current_generated_output_root: spec/sdk/kernel/generated
80
+ current_generated_output_root: stdout_view
87
81
  post_cutover_canonical_input_root: .nimi/spec/sdk/kernel
88
- post_cutover_generated_output_root: .nimi/spec/sdk/kernel/generated
82
+ post_cutover_generated_output_root: stdout_view
89
83
  update_phase: phase_3_preparation
90
84
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope desktop --check
91
85
  current_canonical_input_root: spec/desktop/kernel
92
- current_generated_output_root: spec/desktop/kernel/generated
86
+ current_generated_output_root: stdout_view
93
87
  post_cutover_canonical_input_root: .nimi/spec/desktop/kernel
94
- post_cutover_generated_output_root: .nimi/spec/desktop/kernel/generated
88
+ post_cutover_generated_output_root: stdout_view
95
89
  update_phase: phase_3_preparation
96
90
  - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope desktop-consistency
97
91
  current_canonical_input_root: spec/desktop/kernel
98
- current_generated_output_root: none
92
+ current_generated_output_root: stdout_view
99
93
  post_cutover_canonical_input_root: .nimi/spec/desktop/kernel
100
- post_cutover_generated_output_root: none
94
+ post_cutover_generated_output_root: stdout_view
101
95
  update_phase: phase_5_flip
102
- - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope future --check
103
- current_canonical_input_root: spec/future/kernel
104
- current_generated_output_root: spec/future/kernel/generated
105
- post_cutover_canonical_input_root: .nimi/spec/future/kernel
106
- post_cutover_generated_output_root: .nimi/spec/future/kernel/generated
107
- update_phase: phase_3_preparation
108
96
  - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope runtime-consistency
109
97
  current_canonical_input_root: spec/runtime/kernel
110
- current_generated_output_root: none
98
+ current_generated_output_root: stdout_view
111
99
  post_cutover_canonical_input_root: .nimi/spec/runtime/kernel
112
- post_cutover_generated_output_root: none
100
+ post_cutover_generated_output_root: stdout_view
113
101
  update_phase: phase_5_flip
114
102
  - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope cognition-consistency
115
103
  current_canonical_input_root: spec/cognition/kernel
116
- current_generated_output_root: none
104
+ current_generated_output_root: stdout_view
117
105
  post_cutover_canonical_input_root: .nimi/spec/cognition/kernel
118
- post_cutover_generated_output_root: none
106
+ post_cutover_generated_output_root: stdout_view
119
107
  update_phase: phase_5_flip
120
108
  - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope sdk-consistency
121
109
  current_canonical_input_root: spec/sdk/kernel
122
- current_generated_output_root: none
110
+ current_generated_output_root: stdout_view
123
111
  post_cutover_canonical_input_root: .nimi/spec/sdk/kernel
124
- post_cutover_generated_output_root: none
125
- update_phase: phase_5_flip
126
- - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope future-consistency
127
- current_canonical_input_root: spec/future/kernel
128
- current_generated_output_root: none
129
- post_cutover_canonical_input_root: .nimi/spec/future/kernel
130
- post_cutover_generated_output_root: none
112
+ post_cutover_generated_output_root: stdout_view
131
113
  update_phase: phase_5_flip
132
114
  - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope platform-consistency
133
115
  current_canonical_input_root: spec/platform/kernel
134
- current_generated_output_root: none
116
+ current_generated_output_root: stdout_view
135
117
  post_cutover_canonical_input_root: .nimi/spec/platform/kernel
136
- post_cutover_generated_output_root: none
118
+ post_cutover_generated_output_root: stdout_view
137
119
  update_phase: phase_5_flip
138
120
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope platform --check
139
121
  current_canonical_input_root: spec/platform/kernel
140
- current_generated_output_root: spec/platform/kernel/generated
122
+ current_generated_output_root: stdout_view
141
123
  post_cutover_canonical_input_root: .nimi/spec/platform/kernel
142
- post_cutover_generated_output_root: .nimi/spec/platform/kernel/generated
124
+ post_cutover_generated_output_root: stdout_view
143
125
  update_phase: phase_3_preparation
144
126
  - command: pnpm exec nimicoding validate-spec-governance --profile nimi --scope realm-consistency
145
127
  current_canonical_input_root: spec/realm/kernel
146
- current_generated_output_root: none
128
+ current_generated_output_root: stdout_view
147
129
  post_cutover_canonical_input_root: .nimi/spec/realm/kernel
148
- post_cutover_generated_output_root: none
130
+ post_cutover_generated_output_root: stdout_view
149
131
  update_phase: phase_5_flip
150
132
  - command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope realm --check
151
133
  current_canonical_input_root: spec/realm/kernel
152
- current_generated_output_root: spec/realm/kernel/generated
134
+ current_generated_output_root: stdout_view
153
135
  post_cutover_canonical_input_root: .nimi/spec/realm/kernel
154
- post_cutover_generated_output_root: .nimi/spec/realm/kernel/generated
136
+ post_cutover_generated_output_root: stdout_view
155
137
  update_phase: phase_3_preparation
@@ -18,17 +18,17 @@ governance_routing_cutover_checklist:
18
18
  current_generated_canonical_root: .nimi/spec/**
19
19
  post_cutover_active_authority: archived_or_derived_only
20
20
  update_phase: phase_5_flip
21
- - file: nimi-coding/README.md
21
+ - file: package://@nimiplatform/nimi-coding/README.md
22
22
  current_active_authority: spec/**
23
23
  current_generated_canonical_root: .nimi/spec/**
24
24
  post_cutover_active_authority: canonical_spec_contract_docs
25
25
  update_phase: phase_3_preparation
26
- - file: nimi-coding/adapters/oh-my-codex/README.md
26
+ - file: package://@nimiplatform/nimi-coding/adapters/oh-my-codex/README.md
27
27
  current_active_authority: spec/**
28
28
  current_generated_canonical_root: .nimi/spec/**
29
29
  post_cutover_active_authority: explicit_cutover_doc_required
30
30
  update_phase: phase_3_preparation
31
- - file: nimi-coding/cli/lib/entrypoints.mjs
31
+ - file: package://@nimiplatform/nimi-coding/cli/lib/entrypoints.mjs
32
32
  current_active_authority: spec/**
33
33
  current_generated_canonical_root: .nimi/spec/**
34
34
  post_cutover_active_authority: managed_entrypoint_flip_requires_explicit_redesign_admission
@@ -2,43 +2,43 @@ version: 1
2
2
  phase2_impacted_surface_matrix:
3
3
  - surface: start_command
4
4
  paths:
5
- - nimi-coding/cli/commands/start.mjs
5
+ - package://@nimiplatform/nimi-coding/cli/commands/start.mjs
6
6
  phase_dependency: phase_2
7
7
  rewrite_reason: replace_compact_target_truth_gating_with_canonical_tree_gating
8
8
  - surface: doctor_logic
9
9
  paths:
10
- - nimi-coding/cli/lib/doctor.mjs
11
- - nimi-coding/cli/constants.mjs
10
+ - package://@nimiplatform/nimi-coding/cli/lib/doctor.mjs
11
+ - package://@nimiplatform/nimi-coding/cli/constants.mjs
12
12
  phase_dependency: phase_2
13
13
  rewrite_reason: replace_target_truth_completion_model_with_tree_state_and_authority_mode
14
14
  - surface: handoff_logic
15
15
  paths:
16
- - nimi-coding/cli/lib/handoff.mjs
16
+ - package://@nimiplatform/nimi-coding/cli/lib/handoff.mjs
17
17
  phase_dependency: phase_2
18
18
  rewrite_reason: gate_skill_handoff_on_command_gating_matrix
19
19
  - surface: closeout_logic
20
20
  paths:
21
- - nimi-coding/cli/lib/closeout.mjs
21
+ - package://@nimiplatform/nimi-coding/cli/lib/closeout.mjs
22
22
  phase_dependency: phase_2
23
23
  rewrite_reason: completed_outcomes_must_use_canonical_tree_readiness
24
24
  - surface: high_risk_ingest_review_decision_admission
25
25
  paths:
26
- - nimi-coding/cli/lib/high-risk-ingest.mjs
27
- - nimi-coding/cli/lib/high-risk-review.mjs
28
- - nimi-coding/cli/lib/high-risk-decision.mjs
29
- - nimi-coding/cli/lib/high-risk-admission.mjs
26
+ - package://@nimiplatform/nimi-coding/cli/lib/high-risk-ingest.mjs
27
+ - package://@nimiplatform/nimi-coding/cli/lib/high-risk-review.mjs
28
+ - package://@nimiplatform/nimi-coding/cli/lib/high-risk-decision.mjs
29
+ - package://@nimiplatform/nimi-coding/cli/lib/high-risk-admission.mjs
30
30
  phase_dependency: phase_2
31
31
  rewrite_reason: replace_legacy_target_truth_gates_with_tree_state_gates
32
32
  - surface: contracts_and_methodology
33
33
  paths:
34
- - nimi-coding/contracts/spec-reconstruction-result.yaml
35
- - nimi-coding/methodology/spec-reconstruction.yaml
36
- - nimi-coding/methodology/spec-target-truth-profile.yaml
34
+ - package://@nimiplatform/nimi-coding/contracts/spec-reconstruction-result.yaml
35
+ - package://@nimiplatform/nimi-coding/methodology/spec-reconstruction.yaml
36
+ - package://@nimiplatform/nimi-coding/methodology/spec-target-truth-profile.yaml
37
37
  phase_dependency: historical_transition_note
38
38
  rewrite_reason: repo_local_support_profile_no_longer_defines_default_reconstruction_completion
39
39
  - surface: tests_and_fixtures
40
40
  paths:
41
- - nimi-coding/test/nimicoding.test.mjs
42
- - nimi-coding/test/fixtures/validators/execution-packet.valid.yaml
41
+ - package://@nimiplatform/nimi-coding/test/nimicoding.test.mjs
42
+ - package://@nimiplatform/nimi-coding/test/fixtures/validators/execution-packet.valid.yaml
43
43
  phase_dependency: phase_2
44
44
  rewrite_reason: legacy_helpers_and_assertions_assume_five_file_target_truth
@@ -58,14 +58,12 @@ spec_authority_cutover_readiness:
58
58
  - pnpm exec nimicoding validate-spec-governance --profile nimi --scope desktop-consistency
59
59
  - pnpm exec nimicoding validate-spec-governance --profile nimi --scope platform-consistency
60
60
  - pnpm exec nimicoding validate-spec-governance --profile nimi --scope realm-consistency
61
- - pnpm exec nimicoding validate-spec-governance --profile nimi --scope future-consistency
62
61
  - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope runtime --check
63
62
  - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope cognition --check
64
63
  - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope sdk --check
65
64
  - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope desktop --check
66
65
  - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope platform --check
67
66
  - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope realm --check
68
- - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope future --check
69
67
  pass_criteria:
70
68
  - every_required_drift_or_generation_command_is_mapped
71
69
  - no_required_command_is_left_without_a_post_cutover_root
@@ -79,9 +77,9 @@ spec_authority_cutover_readiness:
79
77
  - AGENTS.md
80
78
  - CLAUDE.md
81
79
  - spec/AGENTS.md
82
- - nimi-coding/README.md
83
- - nimi-coding/adapters/oh-my-codex/README.md
84
- - nimi-coding/cli/lib/entrypoints.mjs
80
+ - package://@nimiplatform/nimi-coding/README.md
81
+ - package://@nimiplatform/nimi-coding/adapters/oh-my-codex/README.md
82
+ - package://@nimiplatform/nimi-coding/cli/lib/entrypoints.mjs
85
83
  - .nimi/spec/_meta/governance-routing-cutover-checklist.yaml
86
84
  pass_criteria:
87
85
  - docs_state_that_spec_remains_current_authority