xytara 3.1.0 → 3.1.2

package/lib/operational_receipt_contract.js

@@ -1,165 +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: "xytara_emits_shared_operational_receipts_for_runtime_and_economic_actions_without_collapsing_into_proof_semantics",
-    model_state: "core_now",
-    core_claim: "operational receipts are the shared runtime evidence record for important machine actions across the naxytra stack",
-    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",
-          "/v1/receipts/:receipt_id",
-          "/v1/economics/receipts",
-          "/v1/economics/receipts/:receipt_id/lifecycle",
-          "/v1/economics/receipts/:receipt_id/operator-action"
-        ]
-      }
-    ],
-    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: "runtime_action",
-        order_index: 1,
-        objects: ["operational_receipt"],
-        invariants: [
-          "the_receipt_records_one_action_in_one_versioned_shape",
-          "the_receipt_is_minimal_and_replay_safe"
-        ]
-      },
-      {
-        layer_id: "evidence_portability",
-        order_index: 2,
-        objects: ["operational_receipt"],
-        invariants: [
-          "the_receipt_can_be_exported_or_bundled_without_runtime_lock_in",
-          "the_receipt_can_be_verified_offline_when_the_canonical_inputs_are_available"
-        ]
-      },
-      {
-        layer_id: "proof_followthrough",
-        order_index: 3,
-        objects: ["operational_receipt"],
-        invariants: [
-          "proof_layers_may_wrap_receipts_without_redefining_the_base_receipt_meaning",
-          "settlement_and_anchor_refs_are_followthrough_layers_not_core_validity_requirements"
-        ]
-      }
-    ],
-    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_the_shared_evidence_surface_for_xytara_and_xoonya"
-    ],
-    linked_surfaces: {
-      receipts_ref: "/v1/receipts",
-      receipt_detail_ref: "/v1/receipts/:receipt_id",
-      economics_receipts_ref: "/v1/economics/receipts",
-      economics_receipt_lifecycle_ref: "/v1/economics/receipts/:receipt_id/lifecycle",
-      economics_receipt_operator_action_ref: "/v1/economics/receipts/:receipt_id/operator-action"
-    },
-    claim_boundary: "claim_the_runtime_side_shared_operational_receipt_contract_only_without_claiming_proof_validity_settlement_finality_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
-};
+"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: "xytara_emits_shared_operational_receipts_for_runtime_and_economic_actions_without_collapsing_into_proof_semantics",
+    model_state: "core_now",
+    core_claim: "operational receipts are the shared runtime evidence record for important machine actions across the naxytra stack",
+    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",
+          "/v1/receipts/:receipt_id",
+          "/v1/economics/receipts",
+          "/v1/economics/receipts/:receipt_id/lifecycle",
+          "/v1/economics/receipts/:receipt_id/operator-action"
+        ]
+      }
+    ],
+    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: "runtime_action",
+        order_index: 1,
+        objects: ["operational_receipt"],
+        invariants: [
+          "the_receipt_records_one_action_in_one_versioned_shape",
+          "the_receipt_is_minimal_and_replay_safe"
+        ]
+      },
+      {
+        layer_id: "evidence_portability",
+        order_index: 2,
+        objects: ["operational_receipt"],
+        invariants: [
+          "the_receipt_can_be_exported_or_bundled_without_runtime_lock_in",
+          "the_receipt_can_be_verified_offline_when_the_canonical_inputs_are_available"
+        ]
+      },
+      {
+        layer_id: "proof_followthrough",
+        order_index: 3,
+        objects: ["operational_receipt"],
+        invariants: [
+          "proof_layers_may_wrap_receipts_without_redefining_the_base_receipt_meaning",
+          "settlement_and_anchor_refs_are_followthrough_layers_not_core_validity_requirements"
+        ]
+      }
+    ],
+    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_the_shared_evidence_surface_for_xytara_and_xoonya"
+    ],
+    linked_surfaces: {
+      receipts_ref: "/v1/receipts",
+      receipt_detail_ref: "/v1/receipts/:receipt_id",
+      economics_receipts_ref: "/v1/economics/receipts",
+      economics_receipt_lifecycle_ref: "/v1/economics/receipts/:receipt_id/lifecycle",
+      economics_receipt_operator_action_ref: "/v1/economics/receipts/:receipt_id/operator-action"
+    },
+    claim_boundary: "claim_the_runtime_side_shared_operational_receipt_contract_only_without_claiming_proof_validity_settlement_finality_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
+};