@nimiplatform/nimi-coding 0.2.8 → 0.3.0

package/cli/lib/topic.mjs

@@ -1,81 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import path from "node:path";
-
-import { pathExists } from "./fs-helpers.mjs";
-import { formatDate, loadTopicRuntimeAuthority, toPortableRelativePath } from "./topic-common.mjs";
-import {
-  buildCreatePayload,
-  deriveTopicId,
-  getTopicStateRoot,
-  titleFromSlug,
-  writeTopicScaffold,
-} from "./topic-scaffold.mjs";
-
-export * from "./topic-common.mjs";
-export * from "./topic-scaffold.mjs";
-export * from "./topic-waves.mjs";
-export * from "./topic-artifacts.mjs";
-export * from "./topic-decisions.mjs";
-export * from "./topic-ledger.mjs";
-export * from "./topic-execution.mjs";
-export * from "./topic-closeout.mjs";
-export * from "./topic-root-validation.mjs";
-
-export async function createTopic(projectRoot, options) {
-  const now = options.now ?? new Date();
-  const topicId = deriveTopicId(options.slug, now);
-  const today = formatDate(now);
-  const topicDir = path.join(getTopicStateRoot(projectRoot, "proposal"), topicId);
-
-  if (await pathExists(topicDir)) {
-    return {
-      ok: false,
-      error: `Topic already exists: ${toPortableRelativePath(path.relative(projectRoot, topicDir))}`,
-    };
-  }
-
-  await mkdir(getTopicStateRoot(projectRoot, "proposal"), { recursive: true });
-  const authority = await loadTopicRuntimeAuthority(projectRoot);
-  const topic = buildCreatePayload(
-    {
-      topicId,
-      today,
-      title: options.title,
-      mode: options.mode,
-      posture: options.posture,
-      designPolicy: options.designPolicy,
-      parallelTruth: options.parallelTruth,
-      layering: options.layering,
-      risk: options.risk,
-      applicability: options.applicability,
-      justification: options.justification,
-      executionMode: options.executionMode,
-    },
-    authority,
-  );
-
-  await writeTopicScaffold(topicDir, topic);
-  return {
-    ok: true,
-    topicId,
-    topicDir,
-    topicRef: toPortableRelativePath(path.relative(projectRoot, topicDir)),
-    state: "proposal",
-    title: topic.title,
-  };
-}
-
-export function deriveCreateDefaults(options) {
-  const mode = options.mode ?? "greenfield";
-  const posture = options.posture ?? (mode === "landed" ? "backward_compat" : "no_legacy_hard_cut");
-  return {
-    mode,
-    posture,
-    designPolicy: options.designPolicy ?? "complete_contract_first",
-    parallelTruth: options.parallelTruth ?? "forbidden",
-    layering: options.layering ?? "ontology",
-    risk: options.risk ?? "high",
-    applicability: options.applicability ?? "authority_bearing",
-    executionMode: options.executionMode ?? "manager_worker_auditor",
-  };
-}

package/config/audit-execution-artifacts.yaml

@@ -1,20 +0,0 @@
-version: 1
-audit_execution_artifacts:
-  skill_id: audit_sweep
-  host_adapter_ref: .nimi/config/host-adapter.yaml
-  result_contract_ref: .nimi/contracts/audit-sweep-result.yaml
-  locality: local_only
-  artifact_roots:
-    plan_ref: .nimi/local/audit/plans
-    chunk_refs: .nimi/local/audit/chunks
-    ledger_ref: .nimi/local/audit/ledgers
-    report_ref: .nimi/local/audit/reports
-    remediation_map_ref: .nimi/local/audit/remediation-maps
-    audit_closeout_ref: .nimi/local/audit/closeouts
-    packet_ref: .nimi/local/audit/packets
-    evidence_refs: .nimi/local/audit/evidence
-    run_ledger_ref: .nimi/local/audit/runs
-  hard_constraints:
-    - audit_execution_artifacts_remain_operational_only
-    - imported_refs_must_stay_under_declared_local_roots
-    - candidate_artifacts_must_not_override_semantic_truth

package/config/external-execution-artifacts.yaml

@@ -1,16 +0,0 @@
-version: 1
-external_execution_artifacts:
-  skill_id: high_risk_execution
-  host_adapter_ref: .nimi/config/host-adapter.yaml
-  result_contract_ref: .nimi/contracts/high-risk-execution-result.yaml
-  locality: local_only
-  artifact_roots:
-    packet_ref: .nimi/local/packets
-    orchestration_state_ref: .nimi/local/orchestration
-    prompt_ref: .nimi/local/prompts
-    worker_output_ref: .nimi/local/outputs
-    evidence_refs: .nimi/local/evidence
-  hard_constraints:
-    - external_execution_artifacts_remain_operational_only
-    - imported_refs_must_stay_under_declared_local_roots
-    - candidate_artifacts_must_not_override_semantic_truth

package/config/host-adapter.yaml

@@ -1,30 +0,0 @@
-version: 1
-host_adapter:
-  runtime_owner: external_ai_host
-  selected_adapter_id: none
-  admitted_adapter_ids:
-    - codex
-    - oh_my_codex
-    - claude
-  handoff_mode: prompt_output_evidence_handoff
-  evidence_mode: candidate_only
-  semantic_review_owner: nimicoding_manager
-  admitted_execution_surfaces:
-    - authority_convergence_audit
-  host_profile_ref: .nimi/config/host-profile.yaml
-  manifest_ref: .nimi/config/skill-manifest.yaml
-  artifact_contract_ref: .nimi/config/external-execution-artifacts.yaml
-  handoff_ref: .nimi/methodology/skill-handoff.yaml
-  operational_state_roots:
-    - .nimi/local
-    - .nimi/cache
-  semantic_owner_roots:
-    - .nimi/methodology
-    - .nimi/spec
-    - .nimi/contracts
-    - .nimi/config
-  hard_constraints:
-    - adapter_must_not_override_semantic_truth
-    - adapter_must_not_define_acceptance_or_disposition
-    - adapter_runtime_state_must_remain_operational_only
-    - authority_convergence_subagent_execution_is_adapter_projection_only

package/config/host-profile.yaml

@@ -1,29 +0,0 @@
-version: 1
-host_profile:
-  id: external_ai_host
-  host_class: ai_native_coding_host
-  runtime_contract_ref: .nimi/methodology/skill-runtime.yaml
-  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
-  ownership_mode: external
-  execution_mode: delegated
-  install_state: not_installed
-  self_hosted: false
-  required_context:
-    - .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/methodology/skill-handoff.yaml
-  required_capabilities:
-    - read_project_local_nimi_truth
-    - route_declared_external_skills
-    - fail_closed_on_missing_authority
-  hard_constraints:
-    - vendor_neutral_profile_only
-    - do_not_assume_local_runtime_install
-    - do_not_claim_packet_orchestration_ownership

package/config/installer-evidence.yaml

@@ -1,31 +0,0 @@
-version: 1
-evidence_home:
-  id: local_skill_installer_operational_evidence
-  locality: local_only
-  root: .nimi/local/installer-evidence
-  runs_dir: .nimi/local/installer-evidence/runs
-  latest_summary_path: .nimi/local/installer-evidence/latest-summary.json
-  payload_cache_dir: .nimi/local/installer-evidence/payloads
-  temp_dir: .nimi/local/installer-evidence/temp
-  retention:
-    summaries: retain_verified_history
-    raw_logs: local_prunable
-    payloads: ephemeral_best_effort
-    temp_paths: delete_after_run
-  semantic_projection:
-    mode: verified_summary_only
-    contract_ref: .nimi/methodology/skill-installer-summary-projection.yaml
-    target_result_contract: .nimi/methodology/skill-installer-result.yaml
-    lifecycle_scope:
-      owner: external_ai_host
-      stage_model: collapsed_single_contract
-      semantic_stages:
-        - capture
-        - production
-        - status_declaration
-        - semantic_projection
-        - final_result_declaration
-  hard_constraints:
-    - do_not_promote_concrete_evidence_artifacts
-    - do_not_require_tracked_evidence_files
-    - missing_local_evidence_must_not_imply_success

package/config/skill-installer.yaml

@@ -1,23 +0,0 @@
-version: 1
-installer:
-  id: external_delegated_skill_installer
-  installer_owner: external_ai_host
-  installer_mode: delegated
-  install_state: not_installed
-  executable_installation: false
-  self_hosted: false
-  manifest_ref: .nimi/config/skill-manifest.yaml
-  runtime_contract_ref: .nimi/methodology/skill-runtime.yaml
-  host_profile_ref: .nimi/config/host-profile.yaml
-  result_contract_ref: .nimi/methodology/skill-installer-result.yaml
-  evidence_home_ref: .nimi/config/installer-evidence.yaml
-  install_flow:
-    - read_declared_skill_manifest
-    - resolve_against_declared_runtime_contract
-    - resolve_against_declared_host_profile
-    - require_explicit_external_install_action
-  hard_constraints:
-    - do_not_assume_local_installer_runtime
-    - do_not_assume_vendor_specific_package_manager
-    - do_not_claim_self_hosted_installation
-    - unresolved_install_requirement_must_fail_closed

package/config/skill-manifest.yaml

@@ -1,48 +0,0 @@
-version: 1
-manifest:
-  runtime_owner: external_ai_host
-  runtime_contract_ref: .nimi/methodology/skill-runtime.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
-  execution_mode: delegated
-  install_state: not_installed
-skills:
-  - id: spec_reconstruction
-    source: external
-    required: true
-    result_contract_ref: .nimi/contracts/spec-reconstruction-result.yaml
-    inputs:
-      - .nimi/config/spec-generation-inputs.yaml
-      - .nimi/methodology/spec-reconstruction.yaml
-      - .nimi/contracts/surface-taxonomy.schema.yaml
-      - .nimi/contracts/placement-contract.schema.yaml
-      - .nimi/contracts/table-family.schema.yaml
-      - .nimi/contracts/domain-admission.schema.yaml
-  - id: doc_spec_audit
-    source: external
-    required: true
-    result_contract_ref: .nimi/contracts/doc-spec-audit-result.yaml
-    inputs:
-      - README.md
-      - .nimi/spec
-  - id: audit_sweep
-    source: external
-    required: false
-    result_contract_ref: .nimi/contracts/audit-sweep-result.yaml
-    inputs:
-      - .nimi/methodology
-      - .nimi/spec
-      - .nimi/contracts
-      - .nimi/local
-      - .nimi/config/audit-execution-artifacts.yaml
-  - id: high_risk_execution
-    source: external
-    required: false
-    result_contract_ref: .nimi/contracts/high-risk-execution-result.yaml
-    inputs:
-      - .nimi/methodology
-      - .nimi/spec
-      - .nimi/contracts
-      - .nimi/local
-      - .nimi/config/external-execution-artifacts.yaml

package/config/skills.yaml

@@ -1,30 +0,0 @@
-version: 1
-bootstrap:
-  runtime_installed: false
-  installation_mode: deferred
-canonical_reconstruction_guidance: .nimi/methodology/spec-reconstruction.yaml
-canonical_contracts_root: .nimi/contracts
-canonical_manifest: .nimi/config/skill-manifest.yaml
-canonical_host_profile: .nimi/config/host-profile.yaml
-canonical_host_adapter: .nimi/config/host-adapter.yaml
-canonical_external_execution_artifacts: .nimi/config/external-execution-artifacts.yaml
-canonical_runtime_contract: .nimi/methodology/skill-runtime.yaml
-canonical_installer: .nimi/config/skill-installer.yaml
-canonical_installer_result_contract: .nimi/methodology/skill-installer-result.yaml
-canonical_installer_operational_evidence: .nimi/config/installer-evidence.yaml
-canonical_installer_summary_projection_contract: .nimi/methodology/skill-installer-summary-projection.yaml
-handoff_contract: .nimi/methodology/skill-handoff.yaml
-runtime_owner: external_ai_host
-expected_skill_surfaces:
-  - id: spec_reconstruction
-    required: true
-    purpose: reconstruct_project_canonical_tree_into_.nimi/spec
-  - id: doc_spec_audit
-    required: true
-    purpose: compare_human_docs_against_.nimi/spec
-  - id: audit_sweep
-    required: false
-    purpose: perform_full_coverage_audit_sweep_and_emit_frozen_findings_ledger
-  - id: high_risk_execution
-    required: false
-    purpose: packetized_execution_after_project_truth_matures

package/contracts/acceptance.schema.yaml

@@ -1,16 +0,0 @@
-id: nimi-coding.acceptance.v1
-kind: acceptance
-required_order:
-  - authority alignment
-  - phase closure
-  - evidence sufficiency
-  - disposition
-  - next step or reopen
-disposition_enum:
-  - complete
-  - partial
-  - deferred
-required_blocks:
-  - Findings
-  - Current Phase Disposition
-  - Next Step or Reopen Condition

package/contracts/admission-checklist.schema.yaml

@@ -1,15 +0,0 @@
-id: nimicoding.admission-checklist.v1
-kind: admission-checklist
-required:
-  - checklist_id
-  - topic_id
-  - scope
-  - gate_items
-  - stop_phrases
-scope_enum:
-  - topic_entry
-  - wave_preflight
-  - implementation_admission
-rules:
-  - every gate item must be answerable as pass or fail
-  - stop phrases must remain explicit manager stop signals rather than hints

package/contracts/audit-chunk.schema.yaml

@@ -1,123 +0,0 @@
-version: 1
-schema:
-  id: nimi-coding.audit-chunk.v1
-  kind: audit-chunk
-required_top_level_fields:
-  - version
-  - kind
-  - sweep_id
-  - chunk_id
-  - state
-  - owner_domain
-  - criteria
-  - files
-  - file_hashes
-  - lifecycle
-  - created_at
-  - updated_at
-optional_top_level_fields:
-  - planning_basis
-  - spec_surface
-  - authority_refs
-  - authority_kind
-  - app_id
-  - package_authority_id
-  - delegated_projection_id
-  - admission_ref
-  - authority_root
-  - source_authority_root
-  - evidence_root_admission_refs
-  - admitted_evidence_roots
-  - host_authority_projection_refs
-  - delegated_evidence_roots
-  - delegated_declared_evidence_prefixes
-  - delegated_declared_evidence_refs
-  - declared_evidence_delegation
-  - required_verification_commands
-  - declared_evidence_targets
-  - declared_evidence_unresolved
-  - evidence_roots
-  - evidence_inventory
-  - evidence_inventory_status
-  - evidence_inventory_empty_reason
-  - coverage_contract
-  - evidence_file_hashes
-  - calibration_expected_defects
-  - coverage_quality
-  - audit_validity
-state_enum:
-  - planned
-  - dispatched
-  - ingested
-  - reviewed
-  - frozen
-  - failed
-  - skipped
-lifecycle_required_fields:
-  - planned_at
-  - dispatched_at
-  - ingested_at
-  - reviewed_at
-  - frozen_at
-  - failed_at
-  - skipped_at
-hard_constraints:
-  - chunk_files_must_match_plan_inventory
-  - spec_authority_chunks_must_declare_authority_refs_and_evidence_roots
-  - spec_authority_chunks_must_declare_evidence_inventory
-  - spec_authority_chunks_with_empty_evidence_inventory_must_declare_explicit_empty_reason
-  - spec_authority_chunks_must_declare_coverage_contract
-  - spec_authority_chunk_files_remain_authority_refs_only
-  - admitted_package_authority_projection_refs_must_be_explicitly_mapped
-  - delegated_projection_authority_must_be_explicitly_admitted
-  - delegated_declared_evidence_must_name_source_authority_boundary
-  - delegated_projection_is_audit_modeling_only_not_source_repo_execution
-  - delegated_projection_must_not_resolve_or_mutate_source_authority_refs
-  - spec_authority_ingest_requires_one_authority_outcome_per_authority_ref
-  - spec_authority_ingest_requires_evidence_files_exactly_matching_evidence_inventory
-  - spec_authority_authority_outcome_evidence_refs_must_belong_to_authority_refs_or_evidence_inventory
-  - no_finding_audited_outcomes_must_declare_negative_reasoning
-  - no_finding_audited_outcomes_with_non_empty_evidence_inventory_must_declare_implementation_evidence_refs_or_not_applicable_reason
-  - p0p1_recall_chunks_without_critical_or_high_findings_must_declare_negative_reasoning_and_implementation_refs
-  - p0p1_recall_chunks_with_implementation_inventory_must_record_rule_specific_checks
-  - p0p1_no_finding_evidence_with_implementation_inventory_must_cite_semantic_auditor_provenance
-  - synthetic_no_finding_generators_must_not_emit_semantic_audit_evidence
-  - calibration_expected_defects_must_be_satisfied_by_finding_evidence_when_present
-  - ingest_requires_dispatch
-  - frozen_requires_manager_review
-  - failed_or_skipped_requires_explicit_reason
-audit_evidence_coverage_fields:
-  - evidence_files
-  - authority_outcomes
-  - no_finding_summary
-  - p0p1_negative_reasoning
-  - p0p1_evidence_refs
-  - p0p1_rule_checks
-  - p0p1_implementation_not_applicable_reason
-auditor_provenance_fields:
-  required_when_p0p1_no_finding_with_implementation_inventory:
-    - kind
-    - packet_ref
-    - session_ref_or_transcript_ref_or_review_ref
-authority_outcome_fields:
-  required:
-    - authority_ref
-    - status
-    - evidence_refs
-  optional:
-    - reason
-    - negative_reasoning
-    - implementation_evidence_refs
-    - implementation_not_applicable_reason
-authority_outcome_status_enum:
-  - audited
-  - blocked
-  - not_applicable
-calibration_expected_defect_fields:
-  required:
-    - id
-  optional:
-    - root_cause_key
-    - location_file
-    - severity
-    - category

package/contracts/audit-closeout.schema.yaml

@@ -1,51 +0,0 @@
-version: 1
-schema:
-  id: nimi-coding.audit-closeout.v1
-  kind: audit-closeout
-required_top_level_fields:
-  - sweep_id
-  - ledger_ref
-  - remediation_map_ref
-  - audit_closeout_ref
-  - coverage_status
-  - coverage_scope
-  - coverage_quality
-  - audit_validity
-  - finding_posture
-  - closeout_posture
-  - verified_at
-coverage_status_enum:
-  - full
-  - partial
-  - blocked
-closeout_posture_enum:
-  - audit_complete_findings_open
-  - audit_complete_all_findings_postured
-  - partial_coverage_all_findings_postured
-  - partial_coverage_findings_open
-  - audit_invalid_no_finding_evidence
-  - blocked
-coverage_quality_required_fields:
-  - scope_label
-  - posture
-  - warnings
-  - blockers
-audit_validity_required_fields:
-  - posture
-  - warnings
-  - blockers
-  - no_finding_posture
-  - p0p1_recall_required_count
-  - p0p1_recall_invalid_count
-  - p0p1_rule_check_count
-  - auditor_provenance_present
-  - calibration_expected_defect_count
-  - calibration_missed_defect_count
-hard_constraints:
-  - closeout_requires_latest_ledger_snapshot
-  - audit_complete_requires_no_active_chunks
-  - all_open_findings_require_remediation_map_coverage
-  - all_closed_findings_require_resolution_evidence
-  - coverage_status_partial_requires_partial_coverage_closeout_posture
-  - audit_validity_invalid_requires_audit_invalid_no_finding_evidence_posture
-  - coverage_quality_and_audit_validity_must_be_nested_objects_not_flattened_root_fields

package/contracts/audit-finding.schema.yaml

@@ -1,61 +0,0 @@
-version: 1
-schema:
-  id: nimi-coding.audit-finding.v1
-  kind: audit-finding
-required_fields:
-  - id
-  - sweep_id
-  - chunk_id
-  - fingerprint
-  - severity
-  - category
-  - actionability
-  - confidence
-  - impact
-  - location
-  - title
-  - description
-  - evidence
-  - disposition
-  - evidence_ref
-optional_fields:
-  - owner_domain
-  - root_cause
-  - cluster_id
-  - detected_at
-severity_enum:
-  - critical
-  - high
-  - medium
-  - low
-actionability_enum:
-  - auto-fix
-  - needs-decision
-  - deferred-backlog
-confidence_enum:
-  - high
-  - medium
-  - low
-disposition_enum:
-  - open
-  - remediated
-  - accepted-risk
-  - false-positive
-  - deferred-backlog
-location_required_fields:
-  - file
-evidence_required_fields:
-  - summary
-  - auditor_reasoning
-root_cause_optional_fields:
-  - key
-  - authority_ref
-  - evidence_root
-  - contract_seam
-  - repair_target
-hard_constraints:
-  - finding_location_file_must_belong_to_source_chunk_or_declared_spec_authority_evidence_roots
-  - finding_fingerprint_must_be_stable_over_semantically_identical_evidence
-  - non_open_disposition_requires_resolution_evidence
-  - duplicate_symptoms_may_cluster_only_when_root_cause_key_and_authority_context_match
-  - unique_critical_or_high_root_causes_must_remain_canonical_findings