@nimiplatform/nimi-coding 0.2.7 → 0.3.0

package/contracts/packet.schema.yaml

@@ -1,30 +0,0 @@
-id: nimicoding.topic-packet.v1
-kind: topic-packet
-required:
-  - packet_id
-  - topic_id
-  - wave_id
-  - packet_kind
-  - status
-  - authority_owner
-  - canonical_seams
-  - forbidden_shortcuts
-  - acceptance_invariants
-  - negative_tests
-  - reopen_conditions
-status_enum:
-  - draft
-  - preflight
-  - candidate
-  - admitted
-  - dispatched
-  - closed
-  - superseded
-freeze_allowed_status_enum:
-  - draft
-  - preflight
-  - candidate
-rules:
-  - packet must not be admitted unless all six design fields are explicit
-  - packet must name only one primary wave owner domain
-  - packet must not encode scheduler/runtime transport ownership

package/contracts/pending-note.schema.yaml

@@ -1,17 +0,0 @@
-id: nimicoding.pending-note.v1
-kind: pending-note
-required:
-  - pending_note_id
-  - topic_id
-  - entered_from_state
-  - reason
-  - summary
-  - status
-status_enum:
-  - active
-  - resumed
-  - closed
-rules:
-  - pending note must exist before topic enters pending
-  - pending note must declare explicit reopen criteria or close trigger
-  - pending note must not coexist with active implementation tracking

package/contracts/prompt.schema.yaml

@@ -1,12 +0,0 @@
-id: nimi-coding.prompt.v1
-kind: prompt
-required_blocks:
-  - Task Goal
-  - Authority Reads
-  - Confirmed State
-  - Hard Constraints
-  - Must Complete
-  - Explicit Non-Goals
-  - Required Checks
-  - Required Final Output Format
-  - Blocker Escalation Rule

package/contracts/remediation.schema.yaml

@@ -1,16 +0,0 @@
-id: nimicoding.remediation.v1
-kind: remediation
-required:
-  - remediation_id
-  - topic_id
-  - wave_id
-  - kind
-  - reason
-kind_enum:
-  - a
-  - b
-  - continuation
-  - execution_state_closure
-rules:
-  - remediation kind must use a package-owned enum
-  - continuation remediation must preserve packet lineage to the overflowed scope

package/contracts/result.schema.yaml

@@ -1,24 +0,0 @@
-id: nimicoding.topic-result.v1
-kind: topic-result
-required:
-  - result_id
-  - topic_id
-  - wave_id
-  - result_kind
-  - verdict
-  - verified_at
-verified_at_format: iso8601_utc_timestamp
-verdict_enum:
-  - PASS
-  - NEEDS_REVISION
-  - FAIL
-  - OVERFLOW
-result_kind_enum:
-  - preflight
-  - implementation
-  - audit
-  - judgement
-rules:
-  - OVERFLOW is distinct from PASS and FAIL
-  - audit verdict must not be stronger than attached evidence
-  - result must not silently reopen a retired wave

package/contracts/spec-reconstruction-result.yaml

@@ -1,41 +0,0 @@
-version: 2
-result_contract:
-  id: delegated_spec_reconstruction_result
-  owner: nimi-coding
-summary_required_fields:
-  - generated_paths
-  - audit_ref
-  - placement_report_ref
-  - coverage_summary
-  - unresolved_file_count
-  - inferred_file_count
-  - status
-  - summary
-  - verified_at
-summary_status_enum:
-  - reconstructed
-  - partial
-  - blocked
-canonical_tree_completion:
-  profile_ref: .nimi/contracts/surface-taxonomy.schema.yaml
-  generation_inputs_ref: .nimi/config/spec-generation-inputs.yaml
-  audit_contract_ref: .nimi/contracts/spec-generation-audit.schema.yaml
-  audit_ref: .nimi/local/state/spec-generation/spec-generation-audit.yaml
-  required_tree_state: canonical_tree_ready
-  required_files_valid: true
-completion_requirements:
-  - canonical_tree_ready
-  - declared_profile_required_files_valid
-  - declared_surface_class_constraints_valid
-  - placement_report_present_and_valid
-  - spec_generation_audit_present_and_valid_as_local_state
-  - required_canonical_files_have_matching_audit_entries
-  - unresolved_gaps_must_remain_explicit
-  - blocked_must_be_reported_by_the_external_host
-  - semantic_and_structural_parity_when_blueprint_exists
-locality: local_only
-semantic_constraints:
-  - do_not_promote_closeout_summary_to_project_truth
-  - do_not_promote_generation_audit_to_product_truth
-  - treat_declared_blueprint_as_benchmark_only_not_canonical_output_root
-  - completed_reconstruction_means_reconstructed_or_partial_only

package/contracts/sweep-design-result.yaml

@@ -1,349 +0,0 @@
-version: 2
-result_contract:
-  id: sweep_design_result
-  status: active_contract
-  canonical_entrypoint: "nimicoding sweep design"
-  owner: nimicoding/sweep-design
-artifact_root: ".nimi/local/sweep-design/<run-id>/"
-source_inputs:
-  - ".nimi/local/audit/evidence/<sweep-id>/findings.yaml"
-source_findings_policy: read_only_never_update_from_sweep_design
-source_input_policy:
-  - source_audit_findings_are_read_only
-  - source_findings_sha256_must_be_recorded_at_intake
-  - design_state_is_written_only_to_sweep_design_derived_artifacts
-
-canonical_runtime_phases:
-  - intake
-  - packet-build
-  - packet-build-batch
-  - auditor-prompt
-  - result-ingest
-  - ledger-validate
-  - finalize
-  - wave-plan
-
-retired_runtime_phases:
-  - confirm
-  - cluster
-  - fork-review
-  - plan
-  - preflight
-  - synthesize
-  - decide
-  - extra-audit
-
-artifact_kinds:
-  - name: inventory
-    kind: sweep-design-inventory
-    required_fields:
-      - run_id
-      - source_audit_sweep_id
-      - source_findings_ref
-      - source_findings_sha256
-      - source_findings_mutation_policy
-      - findings
-  - name: design_auditor_packet
-    kind: sweep-design-design-auditor-packet
-    required_fields:
-      - run_id
-      - packet_id
-      - source_audit_sweep_id
-      - included_finding_ids
-      - source_finding_refs
-      - related_finding_refs
-      - related_code_refs
-      - authority_refs
-      - prior_design_state_refs
-      - prior_design_state_marker
-      - revision_ledger_refs
-      - current_cluster_refs
-      - current_wave_refs
-      - explicit_questions
-      - expected_result_shape_ref
-      - evidence_gap_policy
-      - stop_conditions
-  - name: design_auditor_result
-    kind: sweep-design-design-auditor-result
-    required_fields:
-      - run_id
-      - packet_id
-      - result_id
-      - auditor
-      - auditor_family
-      - auditor_mode
-      - auditor_result_origin
-      - methodology_ref
-      - packet_ref
-      - session_ref
-      - transcript_ref
-      - llm_session_ref
-      - llm_transcript_ref
-      - llm_prompt_ref
-      - result_schema_version
-      - provenance
-      - evidence_read
-      - finding_outcomes
-      - cluster_changes
-      - wave_changes
-      - revision_entries
-      - human_decision_requests
-      - extra_audit_requests
-      - validation_recommendations
-      - closeout_recommendations
-      - rejection_status
-  - name: revision_ledger
-    kind: sweep-design-revision-ledger
-    required_fields:
-      - run_id
-      - ledger_id
-      - append_only
-      - entries
-      - ledger_snapshot_hash
-      - entries_root_hash
-      - previous_ledger_snapshot_hash
-  - name: revision_entry
-    kind: sweep-design-revision-entry
-    required_fields:
-      - revision_entry_id
-      - entry_index
-      - revision_type
-      - created_at
-      - previous_entry_hash
-      - entry_hash
-      - previous_artifact_refs
-      - replacement_artifact_refs
-      - affected_finding_ids
-      - affected_cluster_ids
-      - affected_wave_ids
-      - reason_code
-      - evidence_refs
-      - auditor_provenance
-      - human_gate_status
-      - projection_refs_changed
-  - name: decision_queue
-    kind: sweep-design-decision-queue
-  - name: auditor_prompt
-    kind: sweep-design-auditor-prompt
-    required_fields:
-      - run_id
-      - packet_id
-      - packet_ref
-      - expected_result_shape_ref
-      - required_result_origin
-      - synthetic_result_policy
-      - required_llm_provenance_fields
-      - task
-  - name: batch_manifest
-    kind: sweep-design-batch-manifest
-    required_fields:
-      - run_id
-      - manifest_id
-      - source_inventory_ref
-      - source_findings_ref
-      - source_findings_sha256
-      - batch_size
-      - packet_count
-      - packets
-      - generated_artifact_policy
-  - name: final_state_report
-    kind: sweep-design-final-state-report
-  - name: wave_plan
-    kind: sweep-design-wave-plan
-
-prior_design_state_marker_enum:
-  - empty
-  - present
-  - partial
-  - superseded_by_later_audit
-  - evidence_gap
-
-auditor_family_enum:
-  - anthropic_claude
-  - openai_gpt
-  - openai_codex
-  - google_gemini
-  - xai_grok
-  - meta_llama
-  - mistral
-  - other
-
-auditor_mode_enum:
-  - focused
-  - all
-  - degraded
-
-auditor_result_origin_enum:
-  - llm_session
-  - external_llm_session
-  - synthetic_trial
-llm_closeout_policy:
-  closeout_eligible_origins:
-    - llm_session
-    - external_llm_session
-  synthetic_trial_policy: allowed_only_with_explicit_flag_for_load_tests
-  synthetic_trial_must_not_satisfy_true_llm_closeout: true
-  llm_origins_require_fields:
-    - llm_session_ref
-    - llm_transcript_ref
-    - llm_prompt_ref
-
-revision_type_enum:
-  - finding_state_revision
-  - duplicate_judgement
-  - superseded_judgement
-  - cluster_create
-  - cluster_merge
-  - cluster_split
-  - cluster_retire
-  - cluster_reopen
-  - finding_move
-  - wave_create
-  - wave_merge
-  - wave_split
-  - wave_retract
-  - wave_demote
-  - wave_block
-  - wave_implementation_ready
-  - wave_dependency_rewrite
-  - wave_validation_or_closeout_strengthening
-  - decision_packet_create
-  - extra_audit_request_create
-  - extra_audit_request_close
-  - human_decision_request_create
-  - human_decision_request_resolve
-  - final_state_projection_update
-  - user_decision_queue_rewrite
-
-finding_lifecycle_states:
-  - raw
-  - confirmed
-  - needs_design
-  - duplicate
-  - superseded
-  - false_positive
-  - needs_more_audit
-  - needs_user_decision
-  - needs_authority_alignment
-  - ready_for_implementation_wave
-  - blocked
-transient_states:
-  - raw
-  - confirmed
-  - needs_design
-final_outcome_states:
-  - duplicate
-  - superseded
-  - false_positive
-  - needs_more_audit
-  - needs_user_decision
-  - needs_authority_alignment
-  - ready_for_implementation_wave
-  - blocked
-
-packet_input_floor:
-  source_finding_refs_min: 1
-  related_code_refs_min_unless:
-    authority_only_packet: 1
-  authority_refs_min_when:
-    authority_bearing_finding: 1
-  related_finding_refs_min_when_available: 3
-  prior_design_state_marker_required: true
-  prior_design_state_refs_empty_allowed_only_when_marker_empty: true
-  evidence_gap_result_required_when_any_material_input_missing: true
-
-required_final_outcome_provenance:
-  applies_to:
-    - ready_for_implementation_wave
-    - needs_user_decision
-    - needs_more_audit
-    - needs_authority_alignment
-    - blocked
-    - duplicate
-    - superseded
-    - false_positive
-  required_refs:
-    - design_auditor_packet_ref
-    - design_auditor_result_ref
-    - revision_ledger_entry_refs
-    - related_finding_ids_considered
-    - code_refs_considered
-    - authority_refs_considered
-  terminal_extra_requirements:
-    duplicate:
-      - canonical_finding_or_cluster_ref
-    superseded:
-      - superseding_finding_or_cluster_ref
-    false_positive:
-      - human_gate_ref
-  non_terminal_extra_requirements:
-    ready_for_implementation_wave:
-      - wave_id_ref
-      - preflight_ref
-      - validation_command_refs
-      - closeout_criteria_ref
-    needs_user_decision:
-      - decision_queue_item_ref
-      - decision_packet_ref
-      - recommended_decision
-      - queue_status
-      - blocked_downstream_wave_refs
-    needs_more_audit:
-      - extra_audit_request_ref
-    needs_authority_alignment:
-      - authority_convergence_ref
-    blocked:
-      - blocking_cause_refs
-  decision_outcome_policy:
-    accepted_or_closed_needs_user_decision_requires_human_gate_decision_ref: true
-
-required_wave_fields:
-  - wave_id
-  - scope
-  - owner_domain
-  - authority_owner
-  - dependencies
-  - preflight_ref
-  - non_goals
-  - validation_commands
-  - negative_checks
-  - drift_resistance_checks
-  - closeout_criteria
-  - source_design_packet_refs
-  - design_auditor_result_refs
-  - revision_ledger_entry_refs
-  - blocked_gate_refs
-  - merged_cluster_ids
-  - merged_root_cause_keys
-conditional_wave_fields:
-  consolidation_rationale_required_when: included_findings_or_clusters_count > 1
-  isolation_justification_required_when: included_findings_or_clusters_count == 1
-  not_applicable_value_allowed: "n/a"
-wave_authority_coverage:
-  authority_owner_must_cover_source_authority_refs: true
-  source_authority_ref_sources:
-    - authority_owner
-    - authority_refs
-    - authority_refs_considered
-    - path_like_merged_root_cause_keys
-  generated_fix_topic_packets_must_copy_union_to:
-    - authority_owner
-    - canonical_seams
-
-semantic_constraints:
-  - llm_auditor_judgement_is_required_for_material_findings
-  - deterministic_grouping_must_not_be_final_judgement
-  - projection_write_requires_same_ingest_revision_entry
-  - revision_ledger_is_append_only_and_hash_chained
-  - every_final_outcome_requires_packet_result_and_ledger_provenance
-  - raw_confirmed_and_needs_design_are_transient_only
-  - implementation_ready_wave_requires_non_empty_validation_commands
-  - source_findings_mutation_is_forbidden
-
-forbidden_contract_shortcuts:
-  - mechanical_classifier_as_final_judgement
-  - projection_write_without_revision_entry
-  - final_outcome_without_llm_packet_result_refs
-  - implementation_ready_wave_with_empty_validation_commands
-  - one_finding_per_wave_default_without_isolation_justification
-  - source_findings_mutation

package/contracts/topic-goal.schema.yaml

@@ -1,87 +0,0 @@
-id: nimicoding.topic-goal.v1
-kind: topic-goal-readiness-result
-canonical_owner: .nimi/contracts/topic-goal.schema.yaml
-host_projection_ref: .nimi/contracts/topic-goal.schema.yaml
-projection_rule: host projection must be byte-aligned with this package contract
-output_contract:
-  required:
-    - ok
-    - topic_id
-    - topic_ref
-    - topic_state
-    - true_close_status
-    - profile
-    - selected_next_target
-    - selected_wave_id
-    - execution_start_wave_id
-    - topic_state_hash
-    - readiness
-    - goal_command
-    - source_artifacts
-    - validation_commands
-    - human_gates
-    - refusal_reasons
-  nullable:
-    - selected_wave_id
-    - execution_start_wave_id
-    - goal_command
-readiness_check_shape:
-  required:
-    - id
-    - status
-    - severity
-    - message
-  status_enum:
-    - pass
-    - fail
-  severity_enum:
-    - info
-    - blocking
-validation_command_shape:
-  required:
-    - command
-    - cwd
-    - profile
-    - scope
-    - required
-    - expected_exit_code
-refusal_reason_enum:
-  - topic_validate_failed
-  - topic_graph_validate_failed
-  - topic_not_ongoing
-  - true_close_not_started_required
-  - strict_policy_ignored
-  - parallel_truth_not_forbidden
-  - unknown_profile
-  - selected_target_not_wave
-  - selected_wave_mismatch
-  - wave_override_forbidden
-  - selected_wave_not_executable
-  - dependency_not_terminal
-  - missing_primary_closure_goal
-  - forbidden_shortcuts_incomplete
-  - forbidden_shortcuts_catalog_drift
-  - required_artifact_missing
-  - unresolved_placeholder
-  - stop_line_missing
-  - human_gates_missing
-  - validation_commands_missing
-  - closeout_criteria_missing
-  - authority_owner_missing
-  - work_type_missing
-  - authority_alignment_missing
-  - host_projection_drift
-  - goal_too_large
-rules:
-  - slash output is emitted only when ok=true
-  - json output is emitted for ready and refused cases
-  - goal_command must be null whenever ok=false
-  - topic-goal output is a projection and must not mutate topic state
-  - host projection drift is a readiness refusal when the host projection exists
-  - topic goal is the bridge from accepted topic design into Codex /goal execution ownership
-  - topic goal targets topic completion, not selected-wave completion
-  - selected_wave_id and execution_start_wave_id are execution cursors only
-  - ordinary wave admission, preflight, implementation, validation, result recording, and closeout transitions are non-final
-  - /goal may complete only after all waves are terminal and topic true-close/closeout evidence is recorded
-  - preflight_admitted is an execution-stage wave state for topic goal because wave preflight is part of execution, not a separate human design phase
-  - candidate and preflight_draft wave states may be deterministic topic-runner cursors when selected_next_target is empty and dependencies are terminal

package/contracts/topic-run-ledger.schema.yaml

@@ -1,72 +0,0 @@
-id: nimicoding.topic-run-ledger.v1
-kind: topic-run-ledger
-ledger_required:
-  - ledger_id
-  - topic_id
-  - run_id
-  - kind
-  - run_status
-  - event_count
-  - event_refs
-  - latest_event_ref
-  - current_wave_id
-  - latest_decision_ref
-  - latest_packet_ref
-  - latest_prompt_ref
-  - latest_result_ref
-  - latest_closeout_ref
-  - current_human_gate
-  - retry_posture
-  - updated_at
-event_required:
-  - event_id
-  - topic_id
-  - run_id
-  - event_index
-  - event_kind
-  - stop_class
-  - recommended_action
-  - source_ref
-  - summary
-  - recorded_at
-  - artifact_refs
-event_kind_enum:
-  - decision_emitted
-  - wave_admitted
-  - packet_frozen
-  - worker_dispatched
-  - audit_dispatched
-  - result_recorded
-  - human_gate_opened
-  - human_gate_resolved
-  - wave_closed
-  - topic_closed
-  - runner_blocked
-run_status_enum:
-  - running
-  - awaiting_human_confirmation
-  - awaiting_external_evidence
-  - blocked
-  - completed
-artifact_ref_keys:
-  - decision_ref
-  - packet_ref
-  - prompt_ref
-  - worker_output_ref
-  - audit_output_ref
-  - result_ref
-  - closeout_ref
-  - evidence_ref
-retry_posture_enum:
-  - not_applicable
-  - retry_allowed_same_command
-  - retry_requires_new_packet
-  - retry_forbidden_until_human_gate
-rules:
-  - run events are append-only topic artifacts
-  - the ledger is a rebuildable projection from run events
-  - event stop_class and recommended_action must use the topic-step-decision contract enums
-  - continue events may record mechanically executed wave admission, packet freeze, and dispatch lineage without opening a human gate
-  - require_human_confirmation opens current_human_gate unless resolved by a later human_gate_resolved event
-  - completed must not imply semantic promotion or true-close
-  - no event may encode transport secrets or host resume tokens

package/contracts/topic-step-decision.schema.yaml

@@ -1,45 +0,0 @@
-id: nimicoding.topic-step-decision.v1
-kind: topic-step-decision
-required:
-  - decision_id
-  - topic_id
-  - wave_id
-  - decision_kind
-  - stop_class
-  - recommended_action
-  - reason_code
-  - requires_human_confirmation
-  - recommended_decision
-  - recommendation_rationale
-  - expected_artifacts
-  - next_command_ref
-stop_class_enum:
-  - continue
-  - require_human_confirmation
-  - await_external_evidence
-  - blocked
-  - completed
-recommended_action_enum:
-  - admit_wave
-  - freeze_packet
-  - dispatch_worker
-  - dispatch_audit
-  - record_result
-  - open_remediation
-  - continue_overflow
-  - hold_topic
-  - resume_topic
-  - closeout_wave
-  - closeout_topic
-  - no_action
-rules:
-  - continue must carry a concrete placeholder-free next_command_ref for a mechanically executable package-owned command
-  - continue may represent a lifecycle transition when the selected target and command inputs are uniquely determined
-  - require_human_confirmation must carry a recommended_decision and recommendation_rationale
-  - require_human_confirmation is reserved for manager judgement, branch selection, ambiguous input, overflow continuation, or other non-mechanical gates
-  - phase transitions must use continue when selected target and command inputs are uniquely determined, including lineage-backed wave closeout and dependency-ready next-wave admission
-  - post-spec-update review is the exception to mechanical phase transition continuation; after a spec/authority/redesign implementation PASS, run-next-step must use require_human_confirmation with reason_code=spec_update_review_required until a fresh judgement PASS is recorded
-  - await_external_evidence must be used when worker, audit, or result evidence is not yet available
-  - blocked must carry blocking_checks or a reason_code that names the failed gate
-  - completed must not imply semantic promotion or true-close
-  - decision output must not mutate topic state