@nimiplatform/nimi-coding 0.1.0

package/spec/_meta/spec-authority-cutover-readiness.yaml

@@ -0,0 +1,104 @@
+version: 1
+spec_authority_cutover_readiness:
+  posture: readiness_only_not_physical_migration
+  current_authority_root: spec
+  canonical_generation_root: .nimi/spec
+  benchmark_posture: benchmark_oracle_to_generated_canonical_tree
+  overall_status_enum:
+    - no_go
+    - ready_for_admission
+  gate_families:
+    - id: canonical_generation_gate
+      posture: generic_methodology
+      objective: prove that the generated canonical tree is stable, auditable, and fully reconstructed
+      required_evidence:
+        commands:
+          - pnpm nimicoding:validate-spec-tree
+          - pnpm nimicoding:validate-spec-audit
+        artifacts:
+          - .nimi/local/handoff-results/spec_reconstruction.json
+          - .nimi/local/handoff-results/doc_spec_audit.json
+      pass_criteria:
+        - validate_spec_tree_passes
+        - validate_spec_audit_passes
+        - spec_reconstruction_closeout_outcome_is_completed
+        - spec_reconstruction_closeout_summary_status_is_reconstructed
+        - doc_spec_audit_closeout_outcome_is_completed
+        - doc_spec_audit_closeout_summary_status_is_aligned
+      failure_meaning:
+        - canonical_tree_is_not_yet_a_stable_cutover_candidate
+    - id: benchmark_parity_gate
+      posture: repo_local_special_case_when_blueprint_declared
+      objective: prove that the repo-local benchmark oracle and generated canonical tree are parity-checked without redefining authority
+      required_evidence:
+        commands:
+          - pnpm nimicoding:blueprint-audit
+        files:
+          - .nimi/spec/_meta/blueprint-reference.yaml
+          - .nimi/spec/_meta/direct-copy-validation-checklist.yaml
+      pass_criteria:
+        - blueprint_reference_still_declares_spec_as_benchmark_oracle
+        - blueprint_audit_passes_when_repo_local_blueprint_is_declared
+        - direct_copy_remains_support_only_not_cutover
+      failure_meaning:
+        - benchmark_parity_is_missing_or_is_trying_to_define_authority
+    - id: drift_pipeline_gate
+      posture: repo_local_special_case
+      objective: prove that all spec-root drift and generation pipelines have an explicit root-flip readiness mapping before any authority change
+      required_evidence:
+        files:
+          - .nimi/spec/_meta/generate-drift-migration-checklist.yaml
+        commands:
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc --check
+          - pnpm check:spec-semantic-completeness
+          - pnpm check:runtime-proto-spec-linkage
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope runtime-consistency
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope cognition-consistency
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope sdk-consistency
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope desktop-consistency
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope platform-consistency
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope realm-consistency
+          - pnpm exec nimicoding validate-spec-governance --profile nimi --scope future-consistency
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope runtime --check
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope cognition --check
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope sdk --check
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope desktop --check
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope platform --check
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope realm --check
+          - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope future --check
+      pass_criteria:
+        - every_required_drift_or_generation_command_is_mapped
+        - no_required_command_is_left_without_a_post_cutover_root
+      failure_meaning:
+        - root_flip_would_break_existing_spec_generation_or_drift_gates
+    - id: governance_routing_gate
+      posture: repo_local_special_case
+      objective: prove that every authority-routing surface states the current authority root, generated canonical root, and non-cutover posture consistently
+      required_evidence:
+        files:
+          - AGENTS.md
+          - CLAUDE.md
+          - spec/AGENTS.md
+          - nimi-coding/README.md
+          - nimi-coding/adapters/oh-my-codex/README.md
+          - nimi-coding/cli/lib/entrypoints.mjs
+          - .nimi/spec/_meta/governance-routing-cutover-checklist.yaml
+      pass_criteria:
+        - docs_state_that_spec_remains_current_authority
+        - docs_state_that_dot_nimi_spec_is_generated_canonical_tree
+        - docs_state_that_readiness_is_not_cutover
+      failure_meaning:
+        - humans_or_external_hosts_could_misread_readiness_as_authority_flip
+    - id: authority_admission_gate
+      posture: repo_local_special_case
+      objective: prove that an explicit redesign admission packet exists under spec authority before any cutover execution is considered
+      required_evidence:
+        files:
+          - spec/canonical-authority-cutover-admission.md
+      pass_criteria:
+        - redesign_admission_doc_exists_under_spec_authority
+        - redesign_admission_doc_declares_required_metadata
+        - redesign_admission_doc_states_current_and_future_authority_posture
+        - redesign_admission_doc_forbids_long_lived_parallel_truth
+      failure_meaning:
+        - authority_cutover_has_not_been_preflighted_under_current_spec_authority

package/spec/_meta/spec-tree-model.yaml

@@ -0,0 +1,72 @@
+version: 1
+spec_tree_model:
+  profile: minimal
+  canonical_root: .nimi/spec
+  authority_mode: external_authority_active
+  domains:
+    - id: project
+      root: .nimi/spec/project
+      normative_root: .nimi/spec/project/kernel
+      tables_root: .nimi/spec/project/kernel/tables
+      guide_paths: []
+  normative_classes:
+    - id: kernel_markdown
+      path_patterns:
+        - .nimi/spec/**/kernel/*.md
+      allowed_extensions:
+        - .md
+      normative: true
+    - id: kernel_tables
+      path_patterns:
+        - .nimi/spec/**/kernel/tables/**/*.yaml
+        - .nimi/spec/**/kernel/tables/**/*.yml
+      allowed_extensions:
+        - .yaml
+        - .yml
+      normative: true
+  derived_classes:
+    - id: kernel_generated
+      path_patterns:
+        - .nimi/spec/**/kernel/generated/**/*.md
+      generator_refs:
+        - pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc
+      normative: false
+  guidance_classes:
+    - id: domain_guides
+      path_patterns:
+        - .nimi/spec/**/*.md
+      excluded_path_patterns:
+        - .nimi/spec/**/kernel/*.md
+        - .nimi/spec/**/kernel/generated/**/*.md
+      must_reference_normative_ids: true
+      normative: false
+  required_files:
+    minimal:
+      - .nimi/spec/INDEX.md
+      - .nimi/spec/_meta/spec-tree-model.yaml
+      - .nimi/spec/project/kernel/index.md
+      - .nimi/spec/project/kernel/core-rules.md
+      - .nimi/spec/project/kernel/tables/rule-catalog.yaml
+    standard:
+      - .nimi/spec/INDEX.md
+      - .nimi/spec/_meta/spec-tree-model.yaml
+    mature:
+      - .nimi/spec/INDEX.md
+      - .nimi/spec/_meta/spec-tree-model.yaml
+  generated_pipelines:
+    - id: spec_human_doc
+      owner_surface: repository_root_scripts
+      input_roots:
+        - .nimi/spec
+      output_roots:
+        - spec/generated
+      generate_command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc
+      drift_check_command: pnpm exec nimicoding generate-spec-derived-docs --profile nimi --scope spec-human-doc --check
+  fail_closed_rules:
+    - unknown_profile_is_invalid
+    - canonical_root_outside_.nimi/spec_is_invalid
+    - domain_roots_must_not_escape_canonical_root
+    - normative_and_derived_path_overlap_is_invalid
+    - required_files_must_stay_under_declared_domain_roots
+    - generated_outputs_must_not_overlap_normative_roots
+    - canonical_active_requires_no_other_active_normative_root

package/spec/bootstrap-state.yaml

@@ -0,0 +1,99 @@
+version: 2
+state:
+  mode: bootstrap_only
+  tree_state: bootstrap_only
+  authority_mode: external_authority_active
+  blueprint_mode: none
+  reconstruction_required: true
+  reconstruction_owner: ai_skills
+lifecycle_contract:
+  id: nimicoding.spec-bootstrap-state.v2
+  state_carrier_ref: .nimi/spec/bootstrap-state.yaml
+  posture_carrier_ref: .nimi/spec/product-scope.yaml
+  tree_state_enum:
+    - bootstrap_only
+    - spec_tree_seeded
+    - canonical_tree_in_progress
+    - canonical_tree_ready
+  authority_mode_enum:
+    - external_authority_active
+    - canonical_cutover_ready
+    - canonical_active
+  blueprint_mode_enum:
+    - none
+    - repo_spec_blueprint
+    - custom_blueprint
+  blueprint_mode_semantics:
+    none: external_blueprint_reference_is_not_declared_in_project_local_truth
+    repo_spec_blueprint: project_local_blueprint_reference_declares_repo_spec_root_for_redesign_or_audit
+    custom_blueprint: project_local_blueprint_reference_declares_a_non_repo_blueprint_root
+  legacy_mode_mapping:
+    - legacy_mode: bootstrap_only
+      tree_state: bootstrap_only
+      authority_mode: external_authority_active
+      blueprint_mode: none
+      reconstruction_required: true
+      ready_for_ai_reconstruction: true
+    - legacy_mode: reconstruction_seeded
+      tree_state: canonical_tree_in_progress
+      authority_mode: external_authority_active
+      blueprint_mode: none
+      reconstruction_required: false
+      ready_for_ai_reconstruction: false
+  fail_closed_rules:
+    - unknown_tree_state_is_invalid
+    - unknown_authority_mode_is_invalid
+    - unknown_blueprint_mode_is_invalid
+    - legacy_mode_must_map_to_declared_multi_axis_state
+    - canonical_active_requires_explicit_cutover_readiness
+current_truth:
+  admitted_files:
+    - .nimi/methodology/core.yaml
+    - .nimi/methodology/spec-reconstruction.yaml
+    - .nimi/methodology/skill-runtime.yaml
+    - .nimi/methodology/skill-installer-result.yaml
+    - .nimi/methodology/skill-installer-summary-projection.yaml
+    - .nimi/methodology/skill-exchange-projection.yaml
+    - .nimi/methodology/skill-handoff.yaml
+    - .nimi/spec/_meta/spec-tree-model.yaml
+    - .nimi/spec/_meta/command-gating-matrix.yaml
+    - .nimi/spec/_meta/spec-authority-cutover-readiness.yaml
+    - .nimi/spec/_meta/generate-drift-migration-checklist.yaml
+    - .nimi/spec/_meta/governance-routing-cutover-checklist.yaml
+    - .nimi/spec/_meta/phase2-impacted-surface-matrix.yaml
+    - .nimi/spec/product-scope.yaml
+    - .nimi/spec/bootstrap-state.yaml
+    - .nimi/config/bootstrap.yaml
+    - .nimi/config/skills.yaml
+    - .nimi/config/skill-manifest.yaml
+    - .nimi/config/host-profile.yaml
+    - .nimi/config/host-adapter.yaml
+    - .nimi/config/external-execution-artifacts.yaml
+    - .nimi/config/skill-installer.yaml
+    - .nimi/config/installer-evidence.yaml
+    - .nimi/contracts/spec-reconstruction-result.yaml
+    - .nimi/contracts/doc-spec-audit-result.yaml
+    - .nimi/contracts/high-risk-execution-result.yaml
+    - .nimi/contracts/high-risk-admission.schema.yaml
+    - .nimi/contracts/external-host-compatibility.yaml
+    - .nimi/contracts/execution-packet.schema.yaml
+    - .nimi/contracts/orchestration-state.schema.yaml
+    - .nimi/contracts/prompt.schema.yaml
+    - .nimi/contracts/worker-output.schema.yaml
+    - .nimi/contracts/acceptance.schema.yaml
+status:
+  bootstrap_contract_version: 1
+  ready_for_ai_reconstruction: true
+  external_handoff_required: true
+  human_projection_mode: derived_only
+  canonical_root_candidate: .nimi/spec
+  active_authority_root: external_authority
+cutover_readiness:
+  authority_contract_ref: .nimi/spec/_meta/spec-authority-cutover-readiness.yaml
+  overall_status: no_go
+  gate_status:
+    canonical_generation_gate: pending
+    benchmark_parity_gate: pending
+    drift_pipeline_gate: pending
+    governance_routing_gate: pending
+    authority_admission_gate: pending

package/spec/product-scope.yaml

@@ -0,0 +1,56 @@
+version: 2
+product:
+  package_name: "@nimiplatform/nimi-coding"
+  mission: ai_native_coding_governance_toolkit
+target_experience:
+  install_step: "npm install -D @nimiplatform/nimi-coding"
+  bootstrap_step: "npx nimicoding start"
+  reconstruction_owner: ai_skills
+  canonical_spec_root: ".nimi/spec"
+  phase_one_posture: contract_and_checklist_only
+methodology_posture:
+  risk_shape: authority_bearing_or_high_risk_only
+  execution_default: inline_manager_worker
+  continuity_model: continuity_agnostic
+standalone_completion:
+  profile: boundary_complete
+  completed_surfaces:
+    - bootstrap
+    - doctor
+    - handoff
+    - validators
+    - topic_lifecycle_report_methodology
+    - closeout
+    - ingest
+    - review
+    - decision
+    - admission
+    - host_overlay_recognition
+  deferred_execution_surfaces:
+    - packet_bound_run_kernel
+    - provider_backed_execution
+    - scheduler
+    - notification
+    - automation_backend
+    - multi_topic_orchestration
+  promoted_parity_gap_summary:
+    - packet_bound_run_kernel
+    - provider_backed_execution
+    - scheduler_automation_notification
+canonical_spec_model:
+  state_carrier_ref: .nimi/spec/bootstrap-state.yaml
+  posture_carrier_ref: .nimi/spec/product-scope.yaml
+  phase_one_contracts:
+    - .nimi/spec/_meta/spec-tree-model.yaml
+    - .nimi/spec/_meta/command-gating-matrix.yaml
+    - .nimi/spec/_meta/spec-authority-cutover-readiness.yaml
+    - .nimi/spec/_meta/generate-drift-migration-checklist.yaml
+    - .nimi/spec/_meta/governance-routing-cutover-checklist.yaml
+    - .nimi/spec/_meta/phase2-impacted-surface-matrix.yaml
+    - .nimi/spec/bootstrap-state.yaml
+    - .nimi/spec/product-scope.yaml
+  blocked_until_phase_two:
+    - command_behavior_rewrites_not_admitted
+    - authority_cutover_not_admitted
+    - physical_spec_tree_migration_not_admitted
+  high_risk_admissions_truth: .nimi/spec/high-risk-admissions.yaml