xytara 3.1.0 → 3.1.2

package/lib/execution_truth_contract.js

@@ -1,234 +1,234 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const { summarizeCapabilityExecutionTruthBundle } = require("./capability_execution_truth");
-const { summarizeLifecycleContinuityPack } = require("./lifecycle_continuity_contract");
-const { summarizeDeliveryState } = require("./delivery_summary_contract");
-const { summarizeRevenueLaunchPathPack } = require("./revenue_launch_path_contract");
-const { summarizeProviderRuntimeJourneyPack } = require("./provider_runtime_journey_contract");
-
-function buildExecutionTruthModelPack() {
-  const capabilityExecutionTruth = summarizeCapabilityExecutionTruthBundle();
-  const lifecycleContinuity = summarizeLifecycleContinuityPack();
-  const deliverySummary = summarizeDeliveryState();
-  const revenueLaunchPathSummary = summarizeRevenueLaunchPathPack();
-  const providerJourneySummary = summarizeProviderRuntimeJourneyPack();
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-execution-truth-model",
-    pack_version: "xytara-execution-truth-model-v1",
-    coined_standard: {
-      id: "XT1",
-      name: "xytara execution truth standard",
-      version: "xt1/v1",
-      role: "canonical_runtime_side_execution_transcript_and_fact_spine",
-      boundary: "xt1_names_the_xytara_runtime_truth_standard_without_claiming_xoonya_proof_validity_or_external_chain_truth"
-    },
-    doctrine: "xytara_owns_hot_state_execution_truth_and_emits_proof_compatible_facts_without_collapsing_into_xoonya_proof_semantics",
-    model_state: "frozen_for_3_0_0_closeout",
-    core_claim: "XT1 is the canonical xytara runtime-side fact model linking quote, payment, execution, delivery, settlement, and proof handoff",
-    canonical_objects: [
-      {
-        object_id: "quote",
-        role: "priced_pre_execution_offer",
-        required_fields: [
-          "quote_id",
-          "account_id",
-          "amount_minor",
-          "currency",
-          "capabilities",
-          "adapters",
-          "settlement_mode"
-        ],
-        primary_surfaces: ["/v1/payment-quotes", "/v1/payment-quotes/:quote_id"]
-      },
-      {
-        object_id: "transaction",
-        role: "hot_state_execution_record",
-        required_fields: [
-          "transaction_id",
-          "account_id",
-          "status",
-          "quote_id",
-          "payment",
-          "settlement",
-          "treasury",
-          "default_path",
-          "execution",
-          "timing",
-          "remediation"
-        ],
-        primary_surfaces: ["/v1/transactions", "/v1/transactions/:transaction_id"]
-      },
-      {
-        object_id: "receipt",
-        role: "runtime_completion_record_with_proof_pointer",
-        required_fields: [
-          "receipt_id",
-          "transaction_id",
-          "status",
-          "payment",
-          "settlement",
-          "treasury",
-          "default_path",
-          "proof_ref",
-          "execution_summary",
-          "timing",
-          "remediation"
-        ],
-        primary_surfaces: ["/v1/receipts", "/v1/receipts/:receipt_id"]
-      },
-      {
-        object_id: "delivery",
-        role: "deliverable_and_callback_state_record",
-        required_fields: [
-          "delivery_id",
-          "transaction_id",
-          "receipt_id",
-          "status",
-          "output_ref",
-          "proof_ref",
-          "delivery_target_kind"
-        ],
-        primary_surfaces: ["/v1/deliveries", "/v1/deliveries/:delivery_id"]
-      },
-      {
-        object_id: "settlement",
-        role: "external_finality_and_reconciliation_binding",
-        required_fields: [
-          "settlement_id",
-          "mode",
-          "adapter",
-          "binding_hash",
-          "status"
-        ],
-        primary_surfaces: ["/v1/settlement/bsv-teranode", "/v1/settlement/bsv-teranode/:settlement_id"]
-      },
-      {
-        object_id: "proof_handoff",
-        role: "xytara_to_xoonya_followthrough_boundary",
-        required_fields: [
-          "receipt.proof_ref",
-          "receipt.execution_summary",
-          "transaction.execution.results_by_task_id",
-          "delivery.proof_ref"
-        ],
-        primary_surfaces: [
-          "/v1/transaction-center/result-packages/export",
-          "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run"
-        ]
-      }
-    ],
-    layer_model: [
-      {
-        layer_id: "priced_intent",
-        order_index: 1,
-        objects: ["quote"],
-        invariants: [
-          "quote_must_exist_before_irreversible_paid_execution",
-          "quote_must_bind_amount_currency_and_settlement_posture"
-        ]
-      },
-      {
-        layer_id: "runtime_execution",
-        order_index: 2,
-        objects: ["transaction"],
-        invariants: [
-          "transaction_is_the_primary_hot_state_execution_record",
-          "execution_success_and_settlement_finality_must_remain_distinct"
-        ]
-      },
-      {
-        layer_id: "runtime_completion",
-        order_index: 3,
-        objects: ["receipt"],
-        invariants: [
-          "receipt_carries_execution_summary_and_proof_pointer",
-          "receipt_must_not_redefine_xoonya_proof_validity"
-        ]
-      },
-      {
-        layer_id: "deliverable_state",
-        order_index: 4,
-        objects: ["delivery"],
-        invariants: [
-          "delivery_tracks_where_the_result_went",
-          "callback_state_is_runtime_truth_not_external_proof_semantics"
-        ]
-      },
-      {
-        layer_id: "settlement_and_treasury",
-        order_index: 5,
-        objects: ["settlement"],
-        invariants: [
-          "settlement_records_external_finality_posture_without_becoming_execution_truth",
-          "treasury_and_settlement_must_stay_reconcilable_from_runtime_artifacts"
-        ]
-      },
-      {
-        layer_id: "proof_followthrough",
-        order_index: 6,
-        objects: ["proof_handoff"],
-        invariants: [
-          "xytara_emits_proof_compatible_facts_and_handoff_refs",
-          "xoonya_owns_proof_semantics_and_verification_truth"
-        ]
-      }
-    ],
-    execution_truth_invariants: [
-      "quote_precedes_paid_execution",
-      "transaction_is_the_canonical_hot_state_execution_record",
-      "receipt_is_the_runtime_completion_record_not_the_proof_core",
-      "delivery_truth_and_callback_truth_remain_first_class_runtime_artifacts",
-      "settlement_truth_is_linked_but_not_collapsed_into_execution_success",
-      "treasury_consequence_remains_reconstructible_from_runtime_artifacts",
-      "xytara_emits_proof_compatible_facts_without_redefining_xoonya_proof_semantics"
-    ],
-    linked_summaries: {
-      capability_execution_truth: capabilityExecutionTruth,
-      lifecycle_continuity: lifecycleContinuity,
-      delivery_summary: deliverySummary,
-      revenue_launch_path_summary: revenueLaunchPathSummary,
-      provider_runtime_journey_summary: providerJourneySummary
-    },
-    linked_surfaces: {
-      xt1_ref: "/v1/xt1",
-      xt1_summary_ref: "/v1/xt1/summary",
-      capability_execution_truth_ref: "/v1/capability-registry/execution-truth",
-      execution_truth_ref: "/v1/execution-truth",
-      execution_truth_summary_ref: "/v1/execution-truth/summary",
-      lifecycle_continuity_ref: "/v1/lifecycle-continuity",
-      deliveries_ref: "/v1/deliveries",
-      revenue_launch_paths_ref: "/v1/revenue-launch/paths",
-      providers_journeys_ref: "/v1/providers/journeys",
-      result_package_export_ref: "/v1/transaction-center/result-packages/export",
-      xoonya_result_package_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run"
-    },
-    claim_boundary: "claim_the_runtime_side_fact_model_and_handoff_boundary_only_without_claiming_xoonya_proof_validity_or_external_chain_truth_inside_xytara"
-  };
-}
-
-function summarizeExecutionTruthModelPack() {
-  const pack = buildExecutionTruthModelPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    summary_version: "xytara-execution-truth-model-summary-v1",
-    pack_version: pack.pack_version,
-    coined_standard_id: pack.coined_standard.id,
-    coined_standard_version: pack.coined_standard.version,
-    model_state: pack.model_state,
-    canonical_object_count: pack.canonical_objects.length,
-    layer_count: pack.layer_model.length,
-    invariant_count: pack.execution_truth_invariants.length,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-module.exports = {
-  buildExecutionTruthModelPack,
-  summarizeExecutionTruthModelPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizeCapabilityExecutionTruthBundle } = require("./capability_execution_truth");
+const { summarizeLifecycleContinuityPack } = require("./lifecycle_continuity_contract");
+const { summarizeDeliveryState } = require("./delivery_summary_contract");
+const { summarizeRevenueLaunchPathPack } = require("./revenue_launch_path_contract");
+const { summarizeProviderRuntimeJourneyPack } = require("./provider_runtime_journey_contract");
+
+function buildExecutionTruthModelPack() {
+  const capabilityExecutionTruth = summarizeCapabilityExecutionTruthBundle();
+  const lifecycleContinuity = summarizeLifecycleContinuityPack();
+  const deliverySummary = summarizeDeliveryState();
+  const revenueLaunchPathSummary = summarizeRevenueLaunchPathPack();
+  const providerJourneySummary = summarizeProviderRuntimeJourneyPack();
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-execution-truth-model",
+    pack_version: "xytara-execution-truth-model-v1",
+    coined_standard: {
+      id: "XT1",
+      name: "xytara execution truth standard",
+      version: "xt1/v1",
+      role: "canonical_runtime_side_execution_transcript_and_fact_spine",
+      boundary: "xt1_names_the_xytara_runtime_truth_standard_without_claiming_xoonya_proof_validity_or_external_chain_truth"
+    },
+    doctrine: "xytara_owns_hot_state_execution_truth_and_emits_proof_compatible_facts_without_collapsing_into_xoonya_proof_semantics",
+    model_state: "frozen_for_3_0_0_closeout",
+    core_claim: "XT1 is the canonical xytara runtime-side fact model linking quote, payment, execution, delivery, settlement, and proof handoff",
+    canonical_objects: [
+      {
+        object_id: "quote",
+        role: "priced_pre_execution_offer",
+        required_fields: [
+          "quote_id",
+          "account_id",
+          "amount_minor",
+          "currency",
+          "capabilities",
+          "adapters",
+          "settlement_mode"
+        ],
+        primary_surfaces: ["/v1/payment-quotes", "/v1/payment-quotes/:quote_id"]
+      },
+      {
+        object_id: "transaction",
+        role: "hot_state_execution_record",
+        required_fields: [
+          "transaction_id",
+          "account_id",
+          "status",
+          "quote_id",
+          "payment",
+          "settlement",
+          "treasury",
+          "default_path",
+          "execution",
+          "timing",
+          "remediation"
+        ],
+        primary_surfaces: ["/v1/transactions", "/v1/transactions/:transaction_id"]
+      },
+      {
+        object_id: "receipt",
+        role: "runtime_completion_record_with_proof_pointer",
+        required_fields: [
+          "receipt_id",
+          "transaction_id",
+          "status",
+          "payment",
+          "settlement",
+          "treasury",
+          "default_path",
+          "proof_ref",
+          "execution_summary",
+          "timing",
+          "remediation"
+        ],
+        primary_surfaces: ["/v1/receipts", "/v1/receipts/:receipt_id"]
+      },
+      {
+        object_id: "delivery",
+        role: "deliverable_and_callback_state_record",
+        required_fields: [
+          "delivery_id",
+          "transaction_id",
+          "receipt_id",
+          "status",
+          "output_ref",
+          "proof_ref",
+          "delivery_target_kind"
+        ],
+        primary_surfaces: ["/v1/deliveries", "/v1/deliveries/:delivery_id"]
+      },
+      {
+        object_id: "settlement",
+        role: "external_finality_and_reconciliation_binding",
+        required_fields: [
+          "settlement_id",
+          "mode",
+          "adapter",
+          "binding_hash",
+          "status"
+        ],
+        primary_surfaces: ["/v1/settlement/bsv-teranode", "/v1/settlement/bsv-teranode/:settlement_id"]
+      },
+      {
+        object_id: "proof_handoff",
+        role: "xytara_to_xoonya_followthrough_boundary",
+        required_fields: [
+          "receipt.proof_ref",
+          "receipt.execution_summary",
+          "transaction.execution.results_by_task_id",
+          "delivery.proof_ref"
+        ],
+        primary_surfaces: [
+          "/v1/transaction-center/result-packages/export",
+          "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run"
+        ]
+      }
+    ],
+    layer_model: [
+      {
+        layer_id: "priced_intent",
+        order_index: 1,
+        objects: ["quote"],
+        invariants: [
+          "quote_must_exist_before_irreversible_paid_execution",
+          "quote_must_bind_amount_currency_and_settlement_posture"
+        ]
+      },
+      {
+        layer_id: "runtime_execution",
+        order_index: 2,
+        objects: ["transaction"],
+        invariants: [
+          "transaction_is_the_primary_hot_state_execution_record",
+          "execution_success_and_settlement_finality_must_remain_distinct"
+        ]
+      },
+      {
+        layer_id: "runtime_completion",
+        order_index: 3,
+        objects: ["receipt"],
+        invariants: [
+          "receipt_carries_execution_summary_and_proof_pointer",
+          "receipt_must_not_redefine_xoonya_proof_validity"
+        ]
+      },
+      {
+        layer_id: "deliverable_state",
+        order_index: 4,
+        objects: ["delivery"],
+        invariants: [
+          "delivery_tracks_where_the_result_went",
+          "callback_state_is_runtime_truth_not_external_proof_semantics"
+        ]
+      },
+      {
+        layer_id: "settlement_and_treasury",
+        order_index: 5,
+        objects: ["settlement"],
+        invariants: [
+          "settlement_records_external_finality_posture_without_becoming_execution_truth",
+          "treasury_and_settlement_must_stay_reconcilable_from_runtime_artifacts"
+        ]
+      },
+      {
+        layer_id: "proof_followthrough",
+        order_index: 6,
+        objects: ["proof_handoff"],
+        invariants: [
+          "xytara_emits_proof_compatible_facts_and_handoff_refs",
+          "xoonya_owns_proof_semantics_and_verification_truth"
+        ]
+      }
+    ],
+    execution_truth_invariants: [
+      "quote_precedes_paid_execution",
+      "transaction_is_the_canonical_hot_state_execution_record",
+      "receipt_is_the_runtime_completion_record_not_the_proof_core",
+      "delivery_truth_and_callback_truth_remain_first_class_runtime_artifacts",
+      "settlement_truth_is_linked_but_not_collapsed_into_execution_success",
+      "treasury_consequence_remains_reconstructible_from_runtime_artifacts",
+      "xytara_emits_proof_compatible_facts_without_redefining_xoonya_proof_semantics"
+    ],
+    linked_summaries: {
+      capability_execution_truth: capabilityExecutionTruth,
+      lifecycle_continuity: lifecycleContinuity,
+      delivery_summary: deliverySummary,
+      revenue_launch_path_summary: revenueLaunchPathSummary,
+      provider_runtime_journey_summary: providerJourneySummary
+    },
+    linked_surfaces: {
+      xt1_ref: "/v1/xt1",
+      xt1_summary_ref: "/v1/xt1/summary",
+      capability_execution_truth_ref: "/v1/capability-registry/execution-truth",
+      execution_truth_ref: "/v1/execution-truth",
+      execution_truth_summary_ref: "/v1/execution-truth/summary",
+      lifecycle_continuity_ref: "/v1/lifecycle-continuity",
+      deliveries_ref: "/v1/deliveries",
+      revenue_launch_paths_ref: "/v1/revenue-launch/paths",
+      providers_journeys_ref: "/v1/providers/journeys",
+      result_package_export_ref: "/v1/transaction-center/result-packages/export",
+      xoonya_result_package_handoff_ref: "https://xoonya.onrender.com/v1/proof-center/result-package-handoff/run"
+    },
+    claim_boundary: "claim_the_runtime_side_fact_model_and_handoff_boundary_only_without_claiming_xoonya_proof_validity_or_external_chain_truth_inside_xytara"
+  };
+}
+
+function summarizeExecutionTruthModelPack() {
+  const pack = buildExecutionTruthModelPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    summary_version: "xytara-execution-truth-model-summary-v1",
+    pack_version: pack.pack_version,
+    coined_standard_id: pack.coined_standard.id,
+    coined_standard_version: pack.coined_standard.version,
+    model_state: pack.model_state,
+    canonical_object_count: pack.canonical_objects.length,
+    layer_count: pack.layer_model.length,
+    invariant_count: pack.execution_truth_invariants.length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+module.exports = {
+  buildExecutionTruthModelPack,
+  summarizeExecutionTruthModelPack
+};