@nimiplatform/nimi-coding 0.1.0

package/methodology/core.yaml

@@ -0,0 +1,25 @@
+version: 1
+product:
+  package_name: "@nimiplatform/nimi-coding"
+  repository_stage: bootstrap
+truth_model:
+  root: ".nimi"
+  methodology_in_project: true
+  ai_native_first: true
+  human_projection: derived_only
+execution_bootstrap:
+  self_hosting: false
+  current_governance_mode: main_repo_nimi_coding
+  local_topic_runtime_admitted: false
+methodology_posture:
+  risk_shape: authority_bearing_or_high_risk_only
+  execution_default: inline_manager_worker
+  continuity_model: continuity_agnostic
+entry_policy:
+  high_risk_work_requires_methodology: true
+  small_low_risk_changes_need_topic: false
+deferred_surfaces:
+  - skill_runtime
+  - skill_installation_runtime
+  - self_hosting_execution
+  - project_local_topic_runtime

package/methodology/four-closure-policy.yaml

@@ -0,0 +1,28 @@
+version: 1
+four_closure_policy:
+  closures:
+    - authority
+    - semantic
+    - consumer
+    - drift_resistance
+  rule:
+    all_four_must_be_explicit_for_wave_closeout: true
+  wave_closeout_evidence:
+    require_packet_lineage: true
+    require_result_lineage: true
+  true_close_audit_evidence:
+    require_wave_closeout_for_closed_waves: true
+    require_packet_lineage_for_closed_waves: true
+    require_result_lineage_for_closed_waves: true
+  authority_examples:
+    - canonical_owner_is_unique
+    - no_parallel_truth_remains
+  semantic_examples:
+    - required_fields_and_failure_modes_are_pinned
+    - complex_cases_are_not_deferred_as_assumptions
+  consumer_examples:
+    - normal_consumers_use_the_correct_seam
+    - shortcuts_cannot_silently_become_mainline_truth
+  drift_resistance_examples:
+    - forbidden_shortcuts_are_explicit
+    - future_implementers_cannot_easily_thin_the_design

package/methodology/overflow-continuation-policy.yaml

@@ -0,0 +1,14 @@
+version: 1
+overflow_continuation_policy:
+  principles:
+    - overflow_is_not_pass
+    - overflow_is_not_automatic_rollback
+    - continuation_requires_same_owner_domain
+  allowed_when:
+    - direction_is_still_correct
+    - scope_has_not_crossed_into_a_new_owner_domain
+    - current_state_is_acceptable_but_packet_boundary_was_too_thin
+  reject_when:
+    - shadow_truth_was_introduced
+    - fallback_or_alias_was_needed
+    - packet_crossed_into_a_new_owner_domain

package/methodology/role-separation-policy.yaml

@@ -0,0 +1,28 @@
+version: 1
+role_separation_policy:
+  roles:
+    manager:
+      owns:
+        - wave_graph
+        - packet_admission
+        - manager_judgement
+        - closeout_sync
+      must_not:
+        - silently_implement_production_scope_while_changing_semantics
+    worker:
+      owns:
+        - one_admitted_packet
+        - bounded_write_set_execution
+      must_not:
+        - widen_owner_domain
+        - weaken_fail_closed_rules
+    auditor:
+      owns:
+        - structural_review
+        - drift_detection
+        - closure_verification
+        - pre_implementation_authority_convergence_evidence
+      must_not:
+        - silently_turn_missing_scope_into_future_follow_up
+        - mutate_authority_or_implementation_while_auditing
+        - decide_semantic_acceptance_or_packet_admission

package/methodology/skill-exchange-projection.yaml

@@ -0,0 +1,114 @@
+version: 1
+projection_contract:
+  id: delegated_skill_exchange_projection
+  owner: package_bootstrap_truth
+  locality: package_truth
+  truth_mode: fail_closed
+  exchange_surfaces:
+    - handoff
+    - closeout
+    - decision
+    - ingest
+    - review
+  output_modes:
+    - human_readable
+    - json
+    - prompt
+  handoff_payload:
+    required_fields:
+      - contractVersion
+      - projectRoot
+      - runtimeOwner
+      - triggerMode
+      - handoffReady
+      - skill.id
+      - skill.required
+      - skill.source
+      - skill.purpose
+      - skill.resultContractRef
+      - skill.readiness.ok
+      - context.orderedPaths
+      - constraints
+      - expectedResults
+      - contracts.exchangeProjectionContractRef
+    optional_fields:
+      - doctor
+      - nextAction
+  closeout_payload:
+    required_fields:
+      - contractVersion
+      - projectRoot
+      - skill.id
+      - outcome
+      - verifiedAt
+      - localOnly
+      - artifactPath
+      - readiness.ok
+      - contracts.exchangeProjectionContractRef
+    optional_fields:
+      - doctor
+      - nextAction
+      - skill.expectedArtifactRoots
+      - summary
+  ingest_payload:
+    required_fields:
+      - contractVersion
+      - projectRoot
+      - sourceCloseoutRef
+      - skill.id
+      - localOnly
+      - artifactPath
+      - readiness.ok
+      - validations.executionPacket.ok
+      - validations.orchestrationState.ok
+      - validations.prompt.ok
+      - validations.workerOutput.ok
+    optional_fields:
+      - doctor
+      - nextAction
+      - artifactRoots
+      - summary
+  review_payload:
+    required_fields:
+      - contractVersion
+      - projectRoot
+      - sourceIngestRef
+      - skill.id
+      - localOnly
+      - artifactPath
+      - reviewStatus
+      - managerReviewOwner
+      - readiness.ok
+      - attachmentRefs.packet_ref
+      - attachmentRefs.worker_output_ref
+    optional_fields:
+      - doctor
+      - nextAction
+      - summary
+      - ingestValidations
+  decision_payload:
+    required_fields:
+      - contractVersion
+      - projectRoot
+      - sourceReviewRef
+      - skill.id
+      - localOnly
+      - artifactPath
+      - verifiedAt
+      - decisionStatus
+      - acceptanceRef
+      - acceptanceDisposition
+      - acceptanceValidation.ok
+      - readiness.ok
+    optional_fields:
+      - doctor
+      - nextAction
+      - summary
+      - attachmentRefs
+  hard_constraints:
+    - do_not_promote_projection_payloads_to_semantic_truth
+    - imported_closeout_summaries_must_match_current_project
+    - missing_required_projection_fields_must_fail_closed
+    - completed_projection_claims_must_match_declared_canonical_tree_state
+    - review_projection_must_not_decide_acceptance_disposition_or_finding_judgment
+    - decision_projection_must_remain_local_only_even_when_manager_owned

package/methodology/skill-handoff.yaml

@@ -0,0 +1,34 @@
+version: 1
+handoff:
+  runtime_owner: external_ai_host
+  runtime_contract_ref: .nimi/methodology/skill-runtime.yaml
+  host_profile_ref: .nimi/config/host-profile.yaml
+  host_compatibility_contract_ref: .nimi/contracts/external-host-compatibility.yaml
+  installer_ref: .nimi/config/skill-installer.yaml
+  installer_result_contract_ref: .nimi/methodology/skill-installer-result.yaml
+  installer_summary_projection_contract_ref: .nimi/methodology/skill-installer-summary-projection.yaml
+  exchange_projection_contract_ref: .nimi/methodology/skill-exchange-projection.yaml
+  reconstruction_guidance_ref: .nimi/methodology/spec-reconstruction.yaml
+  self_hosted_runtime: false
+  trigger_mode: explicit
+  required_context_order:
+    - .nimi/methodology
+    - .nimi/spec
+    - .nimi/contracts
+    - .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/methodology/skill-runtime.yaml
+    - .nimi/methodology/skill-installer-result.yaml
+    - .nimi/methodology/skill-installer-summary-projection.yaml
+    - .nimi/methodology/skill-handoff.yaml
+  hard_constraints:
+    - do_not_assume_runtime_installed
+    - do_not_mutate_project_sources_during_bootstrap_handoff
+    - unresolved_authority_must_fail_closed
+  expected_results:
+    - resolve_against_declared_host_profile
+    - update_.nimi/spec_truth
+    - produce_derived_human_projection_only_when_requested

package/methodology/skill-installer-result.yaml

@@ -0,0 +1,27 @@
+version: 1
+result_contract:
+  id: delegated_skill_installer_result_contract
+  installer_ref: .nimi/config/skill-installer.yaml
+  operational_evidence_home_ref: .nimi/config/installer-evidence.yaml
+  summary_projection_contract_ref: .nimi/methodology/skill-installer-summary-projection.yaml
+  truth_mode: fail_closed
+  semantic_outcome_classes:
+    - requested
+    - verified_installed
+    - verified_unavailable
+    - failed
+  forbidden_outcomes:
+    - installed_without_verification
+    - synthetic_success
+  verification_requirements:
+    - declared_skill_identity_matches_result
+    - declared_source_or_version_matches_verified_outcome
+    - unresolved_installation_cannot_be_reported_as_installed
+    - projected_summary_must_satisfy_summary_projection_contract
+    - intermediate_projection_statuses_must_not_be_reported_as_final_result
+  operational_only_artifacts:
+    - raw_installer_logs
+    - package_manager_output
+    - temp_paths
+    - downloaded_payloads
+    - retry_counters

package/methodology/skill-installer-summary-projection.yaml

@@ -0,0 +1,181 @@
+version: 1
+summary_projection_contract:
+  id: delegated_skill_installer_summary_projection
+  lifecycle_owner: external_ai_host
+  lifecycle_mode: delegated
+  stage_model: collapsed_single_contract
+  evidence_home_ref: .nimi/config/installer-evidence.yaml
+  result_contract_ref: .nimi/methodology/skill-installer-result.yaml
+  truth_mode: fail_closed
+  source_summary_path: .nimi/local/installer-evidence/latest-summary.json
+  required_projected_fields:
+    - skill_id
+    - outcome_class
+    - verified_at
+  optional_projected_fields:
+    - requested_source
+    - requested_version
+    - verifier
+    - evidence_run_id
+  projection_requirements:
+    - local_verified_summary_must_exist_before_projection
+    - projected_skill_identity_must_match_declared_manifest
+    - projected_outcome_class_must_match_result_contract
+    - incomplete_or_ambiguous_summary_must_fail_closed
+  forbidden_projection_fields:
+    - raw_installer_logs
+    - package_manager_output
+    - temp_paths
+    - downloaded_payloads
+    - retry_counters
+    - prompts
+  lifecycle:
+    capture:
+      semantic_outcome_classes:
+        - verified_summary_ready
+        - capture_unavailable
+        - capture_failed
+      forbidden_outcomes:
+        - partial_summary_ready
+        - synthetic_verified_summary
+      required_fields:
+        - skill_id
+        - capture_outcome_class
+        - verified_at
+      optional_fields:
+        - requested_source
+        - requested_version
+        - verifier
+        - evidence_run_id
+      gate_requirements:
+        - complete_verified_summary_must_exist_before_projection
+        - capture_result_must_satisfy_summary_projection_contract
+        - capture_failure_must_not_imply_projection_success
+      operational_only_artifacts:
+        - capture_progress
+        - retry_counters
+        - prompts
+        - raw_installer_logs
+        - package_manager_output
+        - temp_paths
+    production:
+      semantic_outcome_classes:
+        - capture_result_declared
+        - production_unavailable
+        - production_failed
+      forbidden_outcomes:
+        - partial_capture_result_declared
+        - synthetic_capture_result
+      required_fields:
+        - skill_id
+        - production_outcome_class
+        - verified_at
+      optional_fields:
+        - requested_source
+        - requested_version
+        - verifier
+        - evidence_run_id
+      gate_requirements:
+        - complete_verified_summary_must_exist_before_capture_result_declaration
+        - declared_capture_result_must_satisfy_summary_projection_contract
+        - production_failure_must_not_imply_capture_result_success
+      operational_only_artifacts:
+        - production_progress
+        - retry_counters
+        - prompts
+        - raw_installer_logs
+        - package_manager_output
+        - temp_paths
+    status_declaration:
+      semantic_outcome_classes:
+        - status_declared
+        - status_unavailable
+        - status_failed
+      forbidden_outcomes:
+        - partial_status_declared
+        - synthetic_status
+      required_fields:
+        - skill_id
+        - status_outcome_class
+        - verified_at
+      optional_fields:
+        - requested_source
+        - requested_version
+        - verifier
+        - evidence_run_id
+      gate_requirements:
+        - complete_verified_state_must_exist_before_status_declaration
+        - declared_status_must_satisfy_capture_and_production_requirements
+        - status_declaration_failure_must_not_imply_semantic_success
+      operational_only_artifacts:
+        - writing_progress
+        - retry_counters
+        - prompts
+        - raw_installer_logs
+        - package_manager_output
+        - temp_paths
+    semantic_projection:
+      semantic_outcome_classes:
+        - result_ready_for_projection
+        - projection_unavailable
+        - projection_failed
+      forbidden_outcomes:
+        - partial_final_projection
+        - synthetic_final_result
+      required_fields:
+        - skill_id
+        - projection_outcome_class
+        - verified_at
+      optional_fields:
+        - requested_source
+        - requested_version
+        - verifier
+        - evidence_run_id
+      gate_requirements:
+        - complete_verified_state_must_exist_before_semantic_projection
+        - projected_final_result_must_satisfy_prior_projection_stages
+        - projection_failure_must_not_imply_installer_result_success
+      intermediate_only_statuses:
+        - status_declared
+        - capture_result_declared
+      operational_only_artifacts:
+        - projection_progress
+        - retry_counters
+        - prompts
+        - raw_installer_logs
+        - package_manager_output
+        - temp_paths
+    final_result_declaration:
+      semantic_outcome_classes:
+        - installer_result_declared
+        - final_result_unavailable
+        - final_result_failed
+      forbidden_outcomes:
+        - partial_installer_result_declared
+        - synthetic_installer_result
+      required_fields:
+        - skill_id
+        - final_result_outcome_class
+        - verified_at
+      optional_fields:
+        - installer_result_outcome_class
+        - requested_source
+        - requested_version
+        - verifier
+        - evidence_run_id
+      gate_requirements:
+        - complete_projected_verified_state_must_exist_before_final_result_declaration
+        - declared_final_result_must_satisfy_summary_projection_contract
+        - declared_final_result_outcome_class_must_satisfy_result_contract
+        - final_result_declaration_failure_must_not_imply_installer_result_success
+      intermediate_only_outputs:
+        - result_ready_for_projection
+        - projection_unavailable
+        - projection_failed
+      operational_only_artifacts:
+        - writing_progress
+        - retry_counters
+        - prompts
+        - raw_installer_logs
+        - package_manager_output
+        - temp_paths

package/methodology/skill-runtime.yaml

@@ -0,0 +1,23 @@
+version: 1
+runtime_contract:
+  id: external_delegated_skill_runtime
+  runtime_owner: external_ai_host
+  runtime_mode: delegated
+  execution_engine: not_packaged
+  installer_state: deferred
+  self_hosted: false
+  manifest_ref: .nimi/config/skill-manifest.yaml
+  host_profile_ref: .nimi/config/host-profile.yaml
+  installer_ref: .nimi/config/skill-installer.yaml
+  installer_result_contract_ref: .nimi/methodology/skill-installer-result.yaml
+  handoff_ref: .nimi/methodology/skill-handoff.yaml
+  resolution_flow:
+    - load_declared_skill_manifest
+    - resolve_against_declared_host_profile
+    - verify_required_context
+    - delegate_explicit_skill_execution
+  hard_constraints:
+    - do_not_assume_local_runtime_engine
+    - do_not_assume_skill_installation
+    - do_not_claim_self_hosted_execution
+    - unresolved_skill_or_host_capability_must_fail_closed

package/methodology/spec-reconstruction.yaml

@@ -0,0 +1,63 @@
+version: 1
+reconstruction:
+  required: true
+  owner: ai_skills
+  generation_inputs_ref: .nimi/config/spec-generation-inputs.yaml
+  spec_tree_model_ref: .nimi/spec/_meta/spec-tree-model.yaml
+  result_contract_ref: .nimi/contracts/spec-reconstruction-result.yaml
+  trigger:
+    bootstrap_state: bootstrap_only
+  goals:
+    - establish_project_canonical_rule_root
+    - generate_canonical_tree_under_.nimi/spec
+    - generate_file_level_audit_metadata_under_.nimi/spec/_meta
+    - separate_normative_derived_and_guidance_surfaces
+    - extract_core_rules_without_parallel_truth
+    - accept_mixed_inputs_from_code_docs_structure_and_human_notes
+    - preserve_semantic_and_structural_parity_when_blueprint_exists
+    - preserve_authority_explicitness
+    - stop_on_authority_ambiguity
+  target_root: .nimi/spec
+  audit_root: .nimi/spec/_meta/spec-generation-audit.yaml
+  target_tree_shape:
+    required_file_classes:
+      - index
+      - kernel_markdown
+      - kernel_tables
+    optional_file_classes:
+      - kernel_generated
+      - domain_guides
+    minimal_required_outputs:
+      - .nimi/spec/INDEX.md
+      - .nimi/spec/project/kernel/index.md
+      - .nimi/spec/project/kernel/core-rules.md
+      - .nimi/spec/project/kernel/tables/rule-catalog.yaml
+    minimum_generation_sequence:
+      - .nimi/spec/INDEX.md
+      - .nimi/spec/project/kernel/index.md
+      - .nimi/spec/project/kernel/core-rules.md
+      - .nimi/spec/project/kernel/tables/rule-catalog.yaml
+    skeleton_rules:
+      - generate_minimal_kernel_before_optional_guides_and_generated_views
+      - keep_first_pass_scope_small_and_explicit
+      - add_domain_guides_only_after_kernel_markdown_and_tables_exist
+      - treat_missing_rules_as_explicit_gaps_not_implicit_completion
+  benchmark_acceptance:
+    mode: semantic_and_structural_parity_when_blueprint_exists
+    blueprint_is_optional: true
+    benchmark_reference_ref: .nimi/spec/_meta/blueprint-reference.yaml
+  hard_constraints:
+    - no_human_friendly_parallel_truth
+    - no_silent_authority_inference
+    - no_project_source_mutation_during_reconstruction
+    - write_only_under_.nimi/spec_for_canonical_generation_outputs
+    - write_file_level_generation_audit_under_.nimi/spec/_meta/spec-generation-audit.yaml
+    - every_generated_canonical_file_requires_explicit_source_basis_and_unresolved_gap_tracking
+    - respect_skill_manifest_installer_runtime_result_contract_host_profile_and_handoff_truth
+    - unresolved_ambiguity_must_remain_explicit
+    - do_not_treat_repo_local_support_files_as_canonical_tree_completion
+  lifecycle_contract_ref: .nimi/spec/bootstrap-state.yaml
+  completion_gate:
+    bootstrap_state_tree_state: canonical_tree_ready
+    required_profile: minimal
+    audit_contract_ref: .nimi/contracts/spec-generation-audit.schema.yaml

package/methodology/spec-target-truth-profile.yaml

@@ -0,0 +1,53 @@
+version: 1
+target_truth_profile:
+  id: delegated_spec_reconstruction_target_truth_profile
+  owner: package_bootstrap_truth
+  mode: repo_local_support_only
+  generated_files_remain_missing_until_reconstruction: true
+  canonical_completion_authority: .nimi/contracts/spec-reconstruction-result.yaml
+  default_bootstrap_seeded: false
+  posture: historical_transition_note_for_repo_local_governance_support
+  profile_scope:
+    - .nimi/spec/authority-map.yaml
+    - .nimi/spec/boundaries.yaml
+    - .nimi/spec/ownership.yaml
+    - .nimi/spec/change-policy.yaml
+    - .nimi/spec/high-risk-admissions.yaml
+  output_profiles:
+    - path: .nimi/spec/authority-map.yaml
+      purpose: map_project_authority_surfaces_and_declared_owners
+      minimum_sections:
+        - authorities
+        - ownership_rules
+        - escalation_paths
+    - path: .nimi/spec/boundaries.yaml
+      purpose: describe_allowed_and_forbidden_cross-surface_mutation_boundaries
+      minimum_sections:
+        - boundaries
+        - invariants
+        - fail_closed_rules
+    - path: .nimi/spec/ownership.yaml
+      purpose: declare_surface_owners_and_change_approval_modes
+      minimum_sections:
+        - surfaces
+        - ownership_modes
+        - approval_requirements
+    - path: .nimi/spec/change-policy.yaml
+      purpose: define_change_classes_entry_gates_and_parallel_truth_rules
+      minimum_sections:
+        - work_types
+        - authority_gates
+        - parallel_truth_policy
+    - path: .nimi/spec/high-risk-admissions.yaml
+      purpose: record_explicit_high_risk_semantic_admissions_as_canonical_truth
+      minimum_sections:
+        - admissions
+        - admission_rules
+        - semantic_constraints
+  hard_constraints:
+    - do_not_seed_empty_target_truth_files_during_bootstrap
+    - do_not_treat_profile_as_canonical_tree_completion
+    - do_not_treat_profile_as_generated_project_truth
+    - do_not_assume_profile_is_present_in_fresh_host_bootstrap
+    - do_not_allow_vendor_specific_output_contracts
+    - unresolved_target_shape_must_remain_explicit