@nimiplatform/nimi-coding 0.2.7 → 0.3.0

package/contracts/topic.schema.yaml

@@ -1,65 +0,0 @@
-id: nimicoding.topic.v1
-kind: topic
-required:
-  - topic_id
-  - state
-  - created_at
-  - last_transition_at
-  - last_transition_reason
-  - title
-  - mode
-  - posture
-  - design_policy
-  - parallel_truth
-  - layering
-  - risk
-  - applicability
-  - entry_justification
-  - execution_mode
-  - selected_next_target
-  - current_true_close_status
-  - forbidden_shortcuts
-state_enum:
-  - proposal
-  - ongoing
-  - pending
-  - closed
-mode_enum:
-  - greenfield
-  - landed
-  - superseding
-posture_enum:
-  - no_legacy_hard_cut
-  - backward_compat
-design_policy_enum:
-  - complete_contract_first
-  - mvp_incremental
-parallel_truth_enum:
-  - forbidden
-  - admitted
-layering_enum:
-  - ontology
-  - time_phased
-risk_enum:
-  - high
-  - low
-applicability_enum:
-  - authority_bearing
-  - high_risk_refactor
-  - multi_wave_iteration
-  - complex_remediation
-execution_mode_enum:
-  - inline_manager_worker
-  - manager_worker_auditor
-true_close_status_enum:
-  - not_started
-  - pending
-  - true_closed
-  - revoked
-  - superseded
-rules:
-  - topic_id must remain date-first and sortable
-  - state records coarse lifecycle root posture, not every fine-grained machine state
-  - low-risk topics are exceptional and require explicit entry_justification
-  - topic must not exist without a selected_next_target once active execution is admitted
-  - forbidden_shortcuts must use package-owned catalog keys or declared topic-local extensions

package/contracts/true-close.schema.yaml

@@ -1,15 +0,0 @@
-id: nimicoding.true-close.v1
-kind: true-close
-required:
-  - topic_id
-  - status
-  - audit_ref
-  - judgement_ref
-status_enum:
-  - pending
-  - passed
-  - revoked
-  - superseded
-rules:
-  - passed true close may later become revoked
-  - revoked true close must point at the follow-up audit or remediation lineage

package/contracts/wave.schema.yaml

@@ -1,29 +0,0 @@
-id: nimicoding.wave.v1
-kind: wave
-required:
-  - wave_id
-  - slug
-  - state
-  - primary_closure_goal
-  - deps
-  - owner_domain
-  - parallelizable_after
-  - selected
-state_enum:
-  - candidate
-  - preflight_draft
-  - preflight_admitted
-  - implementation_admitted
-  - implementation_active
-  - needs_revision
-  - overflowed
-  - continuation_packet_open
-  - closed
-  - retired
-  - superseded
-rules:
-  - deps must reference only existing wave ids inside the same topic
-  - selected true is allowed for at most one active wave in a topic
-  - retired or superseded waves must not remain dispatchable
-  - overflowed is a lifecycle state and must not be normalized to closed without explicit continuation or trim judgement
-  - continuation_packet_open means overflow continuation has been explicitly admitted and linked to a frozen continuation packet

package/contracts/worker-output.schema.yaml

@@ -1,15 +0,0 @@
-id: nimi-coding.worker-output.v1
-kind: worker-output
-required_blocks:
-  - Findings
-  - Implementation summary
-  - Files changed
-  - Checks run
-  - Remaining gaps / risks
-  - Runner Signal
-optional_blocks:
-  - Chosen decision
-  - Authority / spec impact
-  - Guard behavior decision
-  - Next implementation step
-  - Remaining blockers

package/contracts/workflow-consumer.schema.yaml

@@ -1,110 +0,0 @@
-version: 1
-contract:
-  id: nimicoding.workflow-consumer.v1
-  owner: nimi-coding
-  purpose: Require workflow tools to consume surface classes natively.
-required_top_level_fields:
-  - version
-  - workflow_consumers
-  - semantic_constraints
-workflow_consumer_required_fields:
-  - workflow_id
-  - package_entrypoint
-  - required_inputs
-  - required_surface_classes
-  - forbidden_surface_classes
-  - forbidden_authority_input_classes
-  - required_gates
-  - output_class
-  - fail_closed_cases
-workflow_consumers:
-  - workflow_id: topic_runner
-    package_entrypoint: nimicoding topic-runner
-    required_inputs:
-      - placement_report
-      - selected_wave
-      - packet_ref
-      - topic_lifecycle_state
-    required_surface_classes:
-      - product_authority
-      - methodology_authority
-      - host_projection_anchor
-    forbidden_surface_classes:
-      - unclassified
-      - derived_view
-      - audit_evidence_state
-    forbidden_authority_input_classes:
-      - lifecycle_progress_state
-    required_gates:
-      - block_unclassified_authority_changes
-      - block_forbidden_root_class_combinations
-      - require_human_confirmation_for_product_semantic_fork
-    output_class: lifecycle_progress_state
-    fail_closed_cases:
-      - placement_report_missing
-      - authority_update_without_post_update_review
-  - workflow_id: audit_sweep
-    package_entrypoint: nimicoding sweep audit
-    required_inputs:
-      - authority_inventory
-      - evidence_inventory
-    required_surface_classes:
-      - product_authority
-      - product_authority_table
-      - support_registry
-    forbidden_surface_classes:
-      - derived_view
-      - lifecycle_progress_state
-    forbidden_authority_input_classes: []
-    required_gates:
-      - authority_and_evidence_coverage_separated
-      - raw_outputs_local_only
-    output_class: audit_evidence_state
-    fail_closed_cases:
-      - audit_summary_promoted_to_product_truth
-  - workflow_id: spec_generation
-    package_entrypoint: nimicoding generate-spec-derived-docs
-    required_inputs:
-      - class_filtered_generation_inputs
-      - placement_report
-    required_surface_classes:
-      - product_authority
-      - product_authority_table
-      - thin_guidance
-      - methodology_authority
-      - host_projection_anchor
-    forbidden_surface_classes:
-      - audit_evidence_state
-      - lifecycle_progress_state
-      - spec_generation_state
-      - derived_view
-    forbidden_authority_input_classes: []
-    required_gates:
-      - validate_placement_before_render
-      - reject_blanket_docs_roots
-      - generation_audit_local_state
-    output_class: derived_view
-    fail_closed_cases:
-      - generated_view_used_as_authority
-  - workflow_id: closeout
-    package_entrypoint: nimicoding topic closeout
-    required_inputs:
-      - placement_report
-      - validation_report
-      - result_ref
-    required_surface_classes:
-      - lifecycle_progress_state
-    forbidden_surface_classes:
-      - unclassified
-    forbidden_authority_input_classes: []
-    required_gates:
-      - placement_report_pass_required
-      - no_unresolved_block_disposition
-    output_class: lifecycle_progress_state
-    fail_closed_cases:
-      - closeout_claims_drift_resistance_with_placement_violations
-semantic_constraints:
-  - workflow_must_not_infer_authority_from_path_shape_only
-  - workflow_outputs_must_have_declared_surface_class
-  - workflow_must_fail_closed_when_placement_report_is_missing
-  - workflow_must_not_promote_audit_or_lifecycle_state_to_product_authority

package/methodology/audit-sweep-p0p1-recall.yaml

@@ -1,45 +0,0 @@
-version: 1
-methodology:
-  id: audit_sweep_p0p1_recall
-  owner: nimicoding/audit-sweep
-  purpose: Increase critical/high finding recall without turning every sweep into
-    an unbounded full audit.
-  activation_criteria:
-    - p0p1
-    - p0-p1
-    - p0
-    - p1
-    - critical-high
-    - critical_high
-  strategy:
-    mode: p0_p1_triage_then_deep
-    stages:
-      - triage every selected chunk against priority P0/P1 defect classes
-      - deep-audit only candidate P0/P1 signals, high-risk owner domains, or
-        calibration expected-defect chunks
-      - cluster duplicate symptoms under one canonical root-cause finding
-      - pause discovery when risk budget gates require remediation or admission
-  severity_mapping:
-    p0: critical
-    p1: high
-  priority_defect_classes:
-    - fail_open_or_pseudo_success
-    - authority_boundary_bypass
-    - unadmitted_truth_or_evidence_source
-    - partial_coverage_misrepresented_as_complete
-    - state_divergence_or_lost_update
-    - security_or_permission_bypass
-    - destructive_action_without_gate
-    - package_boundary_violation
-  no_p0p1_finding_requirement:
-    required: true
-    reasoning_field: coverage.p0p1_negative_reasoning
-    evidence_refs_field: coverage.p0p1_evidence_refs
-    evidence_refs_must_include_implementation: true
-    summary: If no critical/high finding is emitted, the auditor must explain why
-      applicable priority defect classes did not produce a P0/P1 issue and cite
-      implementation evidence.
-  non_goals:
-    - exhaustive proof that no issue exists
-    - new finding output format
-    - treating calibration fixture metadata as product findings

package/methodology/authority-convergence-policy.yaml

@@ -1,42 +0,0 @@
-version: 1
-authority_convergence_policy:
-  gate_id: pre_implementation_authority_convergence
-  purpose: >
-    Require an independent auditor pass after authority/spec changes and before
-    implementation dispatch, without making any concrete AI host runtime part of
-    nimicoding semantic truth.
-  trigger_packet_kinds:
-    - authority
-    - spec
-    - redesign
-    - preflight
-  trigger_ref_prefixes:
-    - .nimi/spec/
-  trigger_topic_fields:
-    work_type:
-      - redesign
-  required_result:
-    result_kind: audit
-    pass_verdict: PASS
-  post_update_review:
-    trigger_packet_kinds:
-      - authority
-      - spec
-      - redesign
-    trigger_ref_prefixes:
-      - .nimi/spec/
-    required_result:
-      result_kind: judgement
-      pass_verdict: PASS
-  blocked_verdicts:
-    - NEEDS_REVISION
-    - FAIL
-  dispatch:
-    pre_implementation_role: auditor
-    implementation_role: worker
-  hard_constraints:
-    - auditor_output_is_candidate_evidence_only
-    - manager_records_audit_result_before_implementation_dispatch
-    - unresolved_blocking_findings_fail_closed
-    - deferred_items_must_be_explicitly_non_blocking
-    - concrete_subagent_mechanics_belong_to_adapter_profiles_not_methodology_semantics

package/methodology/overflow-continuation-policy.yaml

@@ -1,14 +0,0 @@
-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/skill-exchange-projection.yaml

@@ -1,114 +0,0 @@
-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

@@ -1,34 +0,0 @@
-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

@@ -1,27 +0,0 @@
-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

@@ -1,181 +0,0 @@
-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