xoonya 3.0.0 → 3.1.0

package/lib/operational_receipt_contract.js

@@ -0,0 +1,165 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildOperationalReceiptContractPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "naxytra-operational-receipt-contract",
+    pack_version: "naxytra-operational-receipt-contract-v1",
+    doctrine: "xoonya_verifies_shared_operational_receipts_as_proof_side_input_without_reabsorbing_runtime_or_treasury_ownership",
+    model_state: "core_now",
+    core_claim: "operational receipts are the shared evidence record that can be reviewed, verified, and carried into proof followthrough",
+    canonical_objects: [
+      {
+        object_id: "operational_receipt",
+        role: "signed_minimal_evidence_record_for_one_important_action",
+        required_fields: [
+          "version",
+          "receipt_id",
+          "timestamp_ns",
+          "actor_id",
+          "action_type",
+          "payload_hash",
+          "signature"
+        ],
+        recommended_fields: [
+          "signature_suite",
+          "source_system",
+          "correlation_id",
+          "parent_receipt_id",
+          "reference_kind",
+          "reference_id"
+        ],
+        optional_fields: [
+          "proof_ref",
+          "anchor_ref",
+          "settlement_ref",
+          "ledger_ref",
+          "payload_uri",
+          "payload_hash_alg",
+          "actor_role",
+          "metadata"
+        ],
+        primary_surfaces: [
+          "/v1/receipts/emit",
+          "/v1/receipts/verify",
+          "/v1/proof-bundles/build",
+          "/v1/proof-bundles/verify",
+          "/v1/proof-center/result-package-handoff/review"
+        ]
+      }
+    ],
+    receipt_kinds: [
+      {
+        receipt_kind: "document_published",
+        description: "binds a published document or release artifact to a signed evidence record"
+      },
+      {
+        receipt_kind: "api_request_completed",
+        description: "binds a completed machine request or API call to a signed evidence record"
+      },
+      {
+        receipt_kind: "payment_received",
+        description: "binds an incoming payment or credited admission event to a signed evidence record"
+      },
+      {
+        receipt_kind: "file_generated",
+        description: "binds a generated file or artifact to a signed evidence record"
+      },
+      {
+        receipt_kind: "agent_task_executed",
+        description: "binds an executed agent task or workflow step to a signed evidence record"
+      },
+      {
+        receipt_kind: "repo_release_created",
+        description: "binds a release tag or package release event to a signed evidence record"
+      },
+      {
+        receipt_kind: "proposal_sent",
+        description: "binds a proposal or offer dispatch to a signed evidence record"
+      },
+      {
+        receipt_kind: "invoice_issued",
+        description: "binds an issued invoice or billable statement to a signed evidence record"
+      },
+      {
+        receipt_kind: "partner_handoff_completed",
+        description: "binds a partner handoff or transfer completion to a signed evidence record"
+      }
+    ],
+    lineage_model: [
+      {
+        layer_id: "receipt_verification",
+        order_index: 1,
+        objects: ["operational_receipt"],
+        invariants: [
+          "the_receipt_can_be_verified_as_minimal_evidence",
+          "the_receipt_does_not_need_a_full_proof_bundle_to_be_valid"
+        ]
+      },
+      {
+        layer_id: "proof_portability",
+        order_index: 2,
+        objects: ["operational_receipt"],
+        invariants: [
+          "the_receipt_can_be_captured_into_a_proof_bundle_or_review_flow",
+          "proof_layers_may_add_anchors_attestations_and_settlement_refs_without_changing_the_receipt_core"
+        ]
+      },
+      {
+        layer_id: "followthrough",
+        order_index: 3,
+        objects: ["operational_receipt"],
+        invariants: [
+          "xoonya_can_preserve_reviewable_context_without_claiming_runtime_ownership",
+          "optional_external_refs_are_followthrough_not_core_validity"
+        ]
+      }
+    ],
+    invariants: [
+      "payload_hash_is_bound_to_the_canonical_payload_or_source_artifact",
+      "signature_covers_the_canonical_receipt_body_without_the_signature_field",
+      "timestamp_ns_is_capture_time_not_authoritative_ordering",
+      "optional_reference_fields_do_not_change_base_receipt_validity",
+      "operational_receipts_are_a_shared_evidence_substrate_not_a_new_proof_standard"
+    ],
+    linked_surfaces: {
+      receipt_emit_ref: "/v1/receipts/emit",
+      receipt_verify_ref: "/v1/receipts/verify",
+      proof_bundle_build_ref: "/v1/proof-bundles/build",
+      proof_bundle_verify_ref: "/v1/proof-bundles/verify",
+      proof_result_package_review_ref: "/v1/proof-center/result-package-handoff/review"
+    },
+    claim_boundary: "claim_the_shared_operational_receipt_review_and_verification_contract_only_without_claiming_runtime_ownership_treasury_ownership_or_universal_identity_truth"
+  };
+}
+
+function summarizeOperationalReceiptContractPack() {
+  const pack = buildOperationalReceiptContractPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    summary_version: "naxytra-operational-receipt-contract-summary-v1",
+    pack_version: pack.pack_version,
+    model_state: pack.model_state,
+    receipt_kind_count: pack.receipt_kinds.length,
+    canonical_object_count: pack.canonical_objects.length,
+    layer_count: pack.lineage_model.length,
+    invariant_count: pack.invariants.length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+function getOperationalReceiptKindDetail(receiptKind) {
+  const normalized = String(receiptKind || "").trim().toLowerCase();
+  return (buildOperationalReceiptContractPack().receipt_kinds || []).find((entry) => entry.receipt_kind === normalized) || null;
+}
+
+module.exports = {
+  buildOperationalReceiptContractPack,
+  summarizeOperationalReceiptContractPack,
+  getOperationalReceiptKindDetail
+};

package/lib/outreach_proof.js

@@ -1,71 +1,71 @@
-"use strict";
-
-const packageJson = require("../package.json");
-
-function buildOutreachProofPack() {
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-outreach-proof",
-    proven_live_today: [
-      "carried runtime handoff review with economic and settlement carry",
-      "proof-side review path aligned with real runtime and settlement evidence",
-      "handoff and governance surfaces exposed for operator inspection",
-      "portable proof-bundle contract packaged for public release posture"
-    ],
-    live_rails: [
-      {
-        rail_ref: "carried_handoff_review",
-        status: "proven_live",
-        trust_signal: "runtime output can be reviewed as proof-side intake rather than opaque logs"
-      },
-      {
-        rail_ref: "proof_center_followthrough",
-        status: "launch_ready",
-        trust_signal: "default proof loops, governance surfaces, and result-package followthrough are publicly exposed"
-      },
-      {
-        rail_ref: "economic_and_settlement_carry",
-        status: "proven_live",
-        trust_signal: "settlement and economic refs survive into proof-side review summaries"
-      }
-    ],
-    credible_public_proof_path: {
-      path_ref: "scenario.carried_handoff.review",
-      why_credible: "smallest public run that matches the already-demonstrated runtime-to-proof carry and review posture",
-      cli: "xoonya-review --file ./handoff.json --summary"
-    },
-    trust_today_vs_later: {
-      trust_today: [
-        "proof-side review for carried handoff bundles",
-        "handoff and governance inspection surfaces",
-        "portable proof-bundle contract",
-        "runtime-to-proof continuation posture"
-      ],
-      later_depth: [
-        "broader third-party runtime adoption after release",
-        "expanded proof ecosystem integrations after public package launch",
-        "continued release-line expansion after public proof-spine adoption"
-      ]
-    }
-  };
-}
-
-function summarizeOutreachProofPack() {
-  const pack = buildOutreachProofPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    proven_count: pack.proven_live_today.length,
-    live_rail_count: pack.live_rails.length,
-    trust_today_count: pack.trust_today_vs_later.trust_today.length,
-    later_depth_count: pack.trust_today_vs_later.later_depth.length,
-    first_path_ref: pack.credible_public_proof_path.path_ref
-  };
-}
-
-module.exports = {
-  buildOutreachProofPack,
-  summarizeOutreachProofPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildOutreachProofPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-outreach-proof",
+    proven_live_today: [
+      "carried runtime handoff review with economic and settlement carry",
+      "proof-side review path aligned with real runtime and settlement evidence",
+      "handoff and governance surfaces exposed for operator inspection",
+      "portable proof-bundle contract packaged for public release posture"
+    ],
+    live_rails: [
+      {
+        rail_ref: "carried_handoff_review",
+        status: "proven_live",
+        trust_signal: "runtime output can be reviewed as proof-side intake rather than opaque logs"
+      },
+      {
+        rail_ref: "proof_center_followthrough",
+        status: "launch_ready",
+        trust_signal: "default proof loops, governance surfaces, and result-package followthrough are publicly exposed"
+      },
+      {
+        rail_ref: "economic_and_settlement_carry",
+        status: "proven_live",
+        trust_signal: "settlement and economic refs survive into proof-side review summaries"
+      }
+    ],
+    credible_public_proof_path: {
+      path_ref: "scenario.carried_handoff.review",
+      why_credible: "smallest public run that matches the already-demonstrated runtime-to-proof carry and review posture",
+      cli: "xoonya-review --file ./handoff.json --summary"
+    },
+    trust_today_vs_later: {
+      trust_today: [
+        "proof-side review for carried handoff bundles",
+        "handoff and governance inspection surfaces",
+        "portable proof-bundle contract",
+        "runtime-to-proof continuation posture"
+      ],
+      later_depth: [
+        "broader third-party runtime adoption after release",
+        "expanded proof ecosystem integrations after public package launch",
+        "continued release-line expansion after public proof-spine adoption"
+      ]
+    }
+  };
+}
+
+function summarizeOutreachProofPack() {
+  const pack = buildOutreachProofPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    proven_count: pack.proven_live_today.length,
+    live_rail_count: pack.live_rails.length,
+    trust_today_count: pack.trust_today_vs_later.trust_today.length,
+    later_depth_count: pack.trust_today_vs_later.later_depth.length,
+    first_path_ref: pack.credible_public_proof_path.path_ref
+  };
+}
+
+module.exports = {
+  buildOutreachProofPack,
+  summarizeOutreachProofPack
+};

package/lib/phase_10_closeout_pack.js

@@ -1,45 +1,45 @@
-"use strict";
-
-const packageJson = require("../package.json");
-
-function buildPhase10CloseoutPack() {
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-phase-10-closeout-pack",
-    phase_ref: "phase_10",
-    posture: "closeout_plan",
-    current_decision: "ready_for_program_closeout",
-    blocking_actions: [],
-    action_steps: [
-      "confirm the current long-tail proof lane family is the intended final Phase 10 shape",
-      "record the terminal program closeout review",
-      "recheck phase-10 gate summary for zero unsatisfied conditions",
-      "advance only once phase-10 gate resolves to ready_for_program_closeout"
-    ],
-    completion_signals: [
-      "phase-10 completion shows no remaining focus",
-      "phase-10 decision record shows no pending records",
-      "phase-10 gate resolves to ready_for_program_closeout"
-    ]
-  };
-}
-
-function summarizePhase10CloseoutPack() {
-  const pack = buildPhase10CloseoutPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    phase_ref: pack.phase_ref,
-    blocking_action_count: pack.blocking_actions.length,
-    action_step_count: pack.action_steps.length,
-    completion_signal_count: pack.completion_signals.length,
-    current_decision: pack.current_decision
-  };
-}
-
-module.exports = {
-  buildPhase10CloseoutPack,
-  summarizePhase10CloseoutPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-10-closeout-pack",
+    phase_ref: "phase_10",
+    posture: "closeout_plan",
+    current_decision: "ready_for_program_closeout",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current long-tail proof lane family is the intended final Phase 10 shape",
+      "record the terminal program closeout review",
+      "recheck phase-10 gate summary for zero unsatisfied conditions",
+      "advance only once phase-10 gate resolves to ready_for_program_closeout"
+    ],
+    completion_signals: [
+      "phase-10 completion shows no remaining focus",
+      "phase-10 decision record shows no pending records",
+      "phase-10 gate resolves to ready_for_program_closeout"
+    ]
+  };
+}
+
+function summarizePhase10CloseoutPack() {
+  const pack = buildPhase10CloseoutPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    blocking_action_count: pack.blocking_actions.length,
+    action_step_count: pack.action_steps.length,
+    completion_signal_count: pack.completion_signals.length,
+    current_decision: pack.current_decision
+  };
+}
+
+module.exports = {
+  buildPhase10CloseoutPack,
+  summarizePhase10CloseoutPack
+};

package/lib/phase_10_completion_pack.js

@@ -1,76 +1,76 @@
-"use strict";
-
-const packageJson = require("../package.json");
-
-function buildPhase10CompletionPack() {
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-phase-10-completion-pack",
-    phase_ref: "phase_10",
-    posture: "completion_review",
-    coverage: {
-      ecosystem_refs: ["demand_signal_adapters", "niche_extension_registry", "ecosystem_backlog_triage"],
-      lane_refs: [
-        "/v1/phases/phase-10/demand-signal-adapters/proof/summary",
-        "/v1/phases/phase-10/niche-extension-registry/proof/summary",
-        "/v1/phases/phase-10/ecosystem-backlog-triage/proof/summary"
-      ],
-      proof_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
-      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
-      proof_artifacts: ["demand_signal_bundle", "extension_registry_bundle", "triage_queue_bundle"],
-      proof_surfaces: [
-        "/v1/proof-center/bridge/summary",
-        "/v1/release-center/summary",
-        "/v1/phases/phase-10/long-tail-continuity/summary"
-      ]
-    },
-    completion: {
-      checks: [
-        "broad Phase 10 long-tail ecosystem pack is public and inspectable",
-        "all current Phase 10 long-tail proof lanes are public and inspectable",
-        "extension posture is visible at phase level",
-        "long-tail continuity is explicit across the proof lane family",
-        "release-center summary reflects Phase 10 breadth and proof-lane coverage",
-        "Phase 10 closeout criteria are explicit before final program closeout"
-      ],
-      readiness_criteria: [
-        { ref: "criterion.phase_surface_public", label: "Phase 10 broad summary is live and inspectable", satisfied: true },
-        { ref: "criterion.long_tail_lane_coverage", label: "All current long-tail proof lanes are live and inspectable", satisfied: true },
-        { ref: "criterion.long_tail_continuity_visible", label: "Long-tail continuity is visible at phase level", satisfied: true },
-        { ref: "criterion.proof_surfaces_attached", label: "Proof surfaces remain attached to the long-tail family", satisfied: true },
-        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 10 long-tail lane shape is explicitly frozen", satisfied: true },
-        { ref: "criterion.program_closeout_reviewed", label: "A final program closeout review has been recorded", satisfied: true }
-      ],
-      ready_for_next_phase: false,
-      remaining_focus: []
-    }
-  };
-}
-
-function summarizePhase10CompletionPack() {
-  const pack = buildPhase10CompletionPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    phase_ref: pack.phase_ref,
-    ecosystem_count: pack.coverage.ecosystem_refs.length,
-    lane_count: pack.coverage.lane_refs.length,
-    proof_mode_count: pack.coverage.proof_modes.length,
-    demand_mode_count: pack.coverage.demand_modes.length,
-    proof_artifact_count: pack.coverage.proof_artifacts.length,
-    proof_surface_count: pack.coverage.proof_surfaces.length,
-    completion_check_count: pack.completion.checks.length,
-    readiness_criteria_count: pack.completion.readiness_criteria.length,
-    satisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied === true).length,
-    unsatisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied !== true).length,
-    remaining_focus_count: pack.completion.remaining_focus.length,
-    ready_for_next_phase: pack.completion.ready_for_next_phase
-  };
-}
-
-module.exports = {
-  buildPhase10CompletionPack,
-  summarizePhase10CompletionPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-10-completion-pack",
+    phase_ref: "phase_10",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["demand_signal_adapters", "niche_extension_registry", "ecosystem_backlog_triage"],
+      lane_refs: [
+        "/v1/phases/phase-10/demand-signal-adapters/proof/summary",
+        "/v1/phases/phase-10/niche-extension-registry/proof/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/proof/summary"
+      ],
+      proof_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      proof_artifacts: ["demand_signal_bundle", "extension_registry_bundle", "triage_queue_bundle"],
+      proof_surfaces: [
+        "/v1/proof-center/bridge/summary",
+        "/v1/release-center/summary",
+        "/v1/phases/phase-10/long-tail-continuity/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 10 long-tail ecosystem pack is public and inspectable",
+        "all current Phase 10 long-tail proof lanes are public and inspectable",
+        "extension posture is visible at phase level",
+        "long-tail continuity is explicit across the proof lane family",
+        "release-center summary reflects Phase 10 breadth and proof-lane coverage",
+        "Phase 10 closeout criteria are explicit before final program closeout"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 10 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.long_tail_lane_coverage", label: "All current long-tail proof lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.long_tail_continuity_visible", label: "Long-tail continuity is visible at phase level", satisfied: true },
+        { ref: "criterion.proof_surfaces_attached", label: "Proof surfaces remain attached to the long-tail family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 10 long-tail lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.program_closeout_reviewed", label: "A final program closeout review has been recorded", satisfied: true }
+      ],
+      ready_for_next_phase: false,
+      remaining_focus: []
+    }
+  };
+}
+
+function summarizePhase10CompletionPack() {
+  const pack = buildPhase10CompletionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.coverage.ecosystem_refs.length,
+    lane_count: pack.coverage.lane_refs.length,
+    proof_mode_count: pack.coverage.proof_modes.length,
+    demand_mode_count: pack.coverage.demand_modes.length,
+    proof_artifact_count: pack.coverage.proof_artifacts.length,
+    proof_surface_count: pack.coverage.proof_surfaces.length,
+    completion_check_count: pack.completion.checks.length,
+    readiness_criteria_count: pack.completion.readiness_criteria.length,
+    satisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied === true).length,
+    unsatisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied !== true).length,
+    remaining_focus_count: pack.completion.remaining_focus.length,
+    ready_for_next_phase: pack.completion.ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase10CompletionPack,
+  summarizePhase10CompletionPack
+};

package/lib/phase_10_decision_record_pack.js

@@ -1,54 +1,54 @@
-"use strict";
-
-const packageJson = require("../package.json");
-
-function buildPhase10DecisionRecordPack() {
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-phase-10-decision-record-pack",
-    phase_ref: "phase_10",
-    posture: "decision_record",
-    records: {
-      freeze_decision: {
-        status: "recorded",
-        description: "record the final long-tail proof lane shape as the frozen Phase 10 baseline"
-      },
-      program_closeout_review: {
-        status: "recorded",
-        description: "record the final review that authorizes terminal program closeout"
-      }
-    },
-    record_steps: [
-      "confirm the current long-tail proof lane family matches the intended final Phase 10 shape",
-      "record the freeze decision outcome",
-      "record the program closeout review outcome",
-      "recheck phase-10 gate summary for the remaining terminal blockers"
-    ],
-    outputs: [
-      "freeze decision status is recorded and inspectable",
-      "program closeout review status is recorded and inspectable",
-      "phase-10 terminal gate can be flipped deliberately"
-    ]
-  };
-}
-
-function summarizePhase10DecisionRecordPack() {
-  const pack = buildPhase10DecisionRecordPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    phase_ref: pack.phase_ref,
-    pending_record_count: Object.values(pack.records).filter((record) => record.status === "pending_record").length,
-    record_step_count: pack.record_steps.length,
-    output_count: pack.outputs.length,
-    freeze_decision_status: pack.records.freeze_decision.status,
-    program_closeout_review_status: pack.records.program_closeout_review.status
-  };
-}
-
-module.exports = {
-  buildPhase10DecisionRecordPack,
-  summarizePhase10DecisionRecordPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-10-decision-record-pack",
+    phase_ref: "phase_10",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final long-tail proof lane shape as the frozen Phase 10 baseline"
+      },
+      program_closeout_review: {
+        status: "recorded",
+        description: "record the final review that authorizes terminal program closeout"
+      }
+    },
+    record_steps: [
+      "confirm the current long-tail proof lane family matches the intended final Phase 10 shape",
+      "record the freeze decision outcome",
+      "record the program closeout review outcome",
+      "recheck phase-10 gate summary for the remaining terminal blockers"
+    ],
+    outputs: [
+      "freeze decision status is recorded and inspectable",
+      "program closeout review status is recorded and inspectable",
+      "phase-10 terminal gate can be flipped deliberately"
+    ]
+  };
+}
+
+function summarizePhase10DecisionRecordPack() {
+  const pack = buildPhase10DecisionRecordPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    pending_record_count: Object.values(pack.records).filter((record) => record.status === "pending_record").length,
+    record_step_count: pack.record_steps.length,
+    output_count: pack.outputs.length,
+    freeze_decision_status: pack.records.freeze_decision.status,
+    program_closeout_review_status: pack.records.program_closeout_review.status
+  };
+}
+
+module.exports = {
+  buildPhase10DecisionRecordPack,
+  summarizePhase10DecisionRecordPack
+};