xytara 2.10.0 → 2.12.0

package/RELEASE_NOTES.md

@@ -1,11 +1,9 @@
-# xytara 2.10.0 Release Notes
-
-`xytara` 2.10.0 is the release-hygiene and launch-polish line for current-release-only package notes, safer first-contact docs, and stronger release-candidate packaging checks.
+`xytara` 2.12.0 is the full-catalog public truth line for aligned npm, GitHub, website, code, documentation, and public-copy surfaces.
 
 Highlights:
 
-- keeps `RELEASE_NOTES.md` scoped to the current release so npm and GitHub release notes do not read like a rolling changelog
-- adds a release-candidate guard that fails when package release notes contain prior release headings or drift from the package version
-- replaces the remaining soft-launch wallet-secret and txid example with the quote-first public first-run path
-- keeps the canonical `https://naxytra.com/xytara` public product URL and website polish intact
-- prepares the synchronized Naxytra 2.10.0 line for a cleaner npm, GitHub, website, and post-deploy verification pass
+- normalizes visible `xytara`, `xoonya`, and `naxytra` product references to the lowercase convention across package docs, CLI copy, release history, and public-facing strings
+- preserves the quote-first first-run path, provider-runtime journeys, revenue-launch paths, adapter-depth boundaries, pricing guardrails, treasury public-claim safety, and read-only operator observability boundaries
+- keeps `RELEASE_NOTES.md` scoped to the current release so npm and GitHub release notes stay clean
+- keeps the canonical `https://naxytra.com/xytara` public product URL and synchronized naxytra release posture intact
+- verifies the lowercase convention through the release candidate, full package verifier, umbrella pre-deploy gates, and clean-consumer release smoke

package/START_HERE.md

@@ -40,7 +40,7 @@ xytara first-run --run-quote --account ACCOUNT_REF --pretty
 The underlying command is:
 
 ```bash
-xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json "{\"tool_name\":\"summarize\",\"arguments\":{\"text\":\"Summarize the Naxytra first-run path in one sentence.\"}}" --quote-only --pretty
+xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json "{\"tool_name\":\"summarize\",\"arguments\":{\"text\":\"Summarize the naxytra first-run path in one sentence.\"}}" --quote-only --pretty
 ```
 
 Then execute with direct signed payment or a credits-first funded account:

package/bin/xytara-first-run.js

@@ -6,7 +6,7 @@ const { spawnSync } = require("child_process");
 
 const DEFAULT_SERVICE_URL = "https://xytara.onrender.com";
 const DEFAULT_KIT_URL = "https://www.naxytra.com/v1/first-run-kit";
-const DEFAULT_TEXT = "Summarize the Naxytra first-run path in one sentence.";
+const DEFAULT_TEXT = "Summarize the naxytra first-run path in one sentence.";
 const ACCOUNT_PLACEHOLDER = "ACCOUNT_REF";
 
 function buildDefaultMcpBody(text) {
@@ -126,7 +126,7 @@ function printUsage() {
     "  --run-quote               Execute the safe quote-only path",
     "  --execute-with-credits    Execute the default task with account credits",
     "  --account ACCOUNT_REF     Account ref for quote or credits-first execution",
-    `  --url <service_url>       Xytara service URL, default ${DEFAULT_SERVICE_URL}`,
+    `  --url <service_url>       xytara service URL, default ${DEFAULT_SERVICE_URL}`,
     "  --text <text>             Text for the default summarize task",
     "  --pretty                  Pretty-print JSON output",
     "  --help                    Show this help message"

package/bin/xytara.js

@@ -40,7 +40,7 @@ function printStartHere() {
     "1. Open https://www.naxytra.com/v1/first-run-path",
     "2. Open https://www.naxytra.com/v1/first-run-kit for copyable commands.",
     "3. Quote safely first:",
-    "   xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json \"{\\\"tool_name\\\":\\\"summarize\\\",\\\"arguments\\\":{\\\"text\\\":\\\"Summarize the Naxytra first-run path in one sentence.\\\"}}\" --quote-only --pretty",
+    "   xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json \"{\\\"tool_name\\\":\\\"summarize\\\",\\\"arguments\\\":{\\\"text\\\":\\\"Summarize the naxytra first-run path in one sentence.\\\"}}\" --quote-only --pretty",
     "4. Execute with direct signed payment or credits-first on a funded account.",
     "5. Hand the result into xoonya for proof review and verification.",
     "",

package/fixtures/catalog.js

@@ -1,6 +1,9 @@
 "use strict";
 
+const { decorateTaskMetadata } = require("../lib/catalog_family_model");
+
 function makeTask(definition) {
+  const metadata = decorateTaskMetadata(definition);
   return {
     task_ref: definition.task_ref,
     public_task_ref: definition.public_task_ref,
@@ -15,7 +18,12 @@ function makeTask(definition) {
     failure_posture: definition.failure_posture,
     input_schema: definition.input_schema,
     capabilities: definition.capabilities,
-    adapters: definition.adapters
+    adapters: definition.adapters,
+    task_family: metadata.task_family,
+    lifecycle_stage: metadata.lifecycle_stage,
+    market_class: metadata.market_class,
+    claim_status: metadata.claim_status,
+    evidence_status: metadata.evidence_status
   };
 }
 

package/index.js

@@ -35,6 +35,30 @@ const {
   buildAdapterPack,
   summarizeAdapterPack
 } = require("./lib/adapter_pack");
+const {
+  buildProviderLanePack,
+  getProviderProfileDetail,
+  summarizeProviderLanePack
+} = require("./lib/provider_lane_contract");
+const {
+  buildProviderRuntimeJourneyPack,
+  getProviderRuntimeJourneyDetail,
+  summarizeProviderRuntimeJourneyPack
+} = require("./lib/provider_runtime_journey_contract");
+const {
+  buildFirstRunConversionPack,
+  getFirstRunConversionDetail,
+  summarizeFirstRunConversionPack
+} = require("./lib/first_run_conversion_contract");
+const {
+  buildDeliverySummaryPack,
+  summarizeDeliveryState
+} = require("./lib/delivery_summary_contract");
+const {
+  buildRevenueLaunchPathPack,
+  getRevenueLaunchPathDetail,
+  summarizeRevenueLaunchPathPack
+} = require("./lib/revenue_launch_path_contract");
 const {
   buildFrameworkProviderPromotionPack,
   summarizeFrameworkProviderPromotionPack
@@ -43,6 +67,35 @@ const {
   buildPricingExperimentPlan,
   summarizePricingExperimentPlan
 } = require("./lib/pricing_optimization_contract");
+const {
+  buildFullCatalogPack,
+  summarizeFullCatalogPack,
+  buildFamilyPromotionPack,
+  summarizeFamilyPromotionPack
+} = require("./lib/full_catalog_contract");
+const {
+  buildMarketLaneActivationPack,
+  buildMarketLanePack,
+  getMarketLaneDetail,
+  summarizeMarketLaneActivationPack,
+  summarizeMarketLanePack
+} = require("./lib/market_lane_contract");
+const {
+  buildMarketLaneDepthPack,
+  getMarketLaneDepthDetail,
+  summarizeMarketLaneDepthPack
+} = require("./lib/market_lane_depth_contract");
+const {
+  buildMarketLaneTracePack,
+  getMarketLaneTraceDetail,
+  summarizeMarketLaneTracePack
+} = require("./lib/market_lane_trace_contract");
+const {
+  buildMarketLanePromotionPack,
+  getMarketLanePromotionDetail,
+  summarizeMarketLanePromotionPack,
+  validateMarketLanePromotionEvidence
+} = require("./lib/market_lane_promotion_contract");
 const {
   buildPublishPlan,
   summarizePublishPlan
@@ -167,10 +220,43 @@ module.exports = {
   summarizeReleaseHistory,
   buildAdapterPack,
   summarizeAdapterPack,
+  buildProviderLanePack,
+  getProviderProfileDetail,
+  summarizeProviderLanePack,
+  buildProviderRuntimeJourneyPack,
+  getProviderRuntimeJourneyDetail,
+  summarizeProviderRuntimeJourneyPack,
+  buildFirstRunConversionPack,
+  getFirstRunConversionDetail,
+  summarizeFirstRunConversionPack,
+  buildDeliverySummaryPack,
+  summarizeDeliveryState,
+  buildRevenueLaunchPathPack,
+  getRevenueLaunchPathDetail,
+  summarizeRevenueLaunchPathPack,
   buildFrameworkProviderPromotionPack,
   summarizeFrameworkProviderPromotionPack,
   buildPricingExperimentPlan,
   summarizePricingExperimentPlan,
+  buildFullCatalogPack,
+  summarizeFullCatalogPack,
+  buildFamilyPromotionPack,
+  summarizeFamilyPromotionPack,
+  buildMarketLanePack,
+  buildMarketLaneActivationPack,
+  buildMarketLaneDepthPack,
+  buildMarketLaneTracePack,
+  buildMarketLanePromotionPack,
+  getMarketLaneDetail,
+  getMarketLaneDepthDetail,
+  getMarketLaneTraceDetail,
+  getMarketLanePromotionDetail,
+  summarizeMarketLanePack,
+  summarizeMarketLaneActivationPack,
+  summarizeMarketLaneDepthPack,
+  summarizeMarketLaneTracePack,
+  summarizeMarketLanePromotionPack,
+  validateMarketLanePromotionEvidence,
   buildPublishPlan,
   summarizePublishPlan,
   buildEcosystemEntryPack,

package/lib/capability_registry.js

@@ -39,6 +39,10 @@ const {
   summarizeCapabilityExecutionTruthBundle,
   buildCapabilityCommercializationSummary
 } = require("./capability_execution_truth");
+const {
+  summarizeFullCatalogPack,
+  summarizeFamilyPromotionPack
+} = require("./full_catalog_contract");
 
 function buildCapabilityRegistrySummary() {
   const catalogSummary = summarizeCatalog();
@@ -77,12 +81,15 @@ function buildCapabilityRegistrySummary() {
       catalog_state: "task_and_workflow_registry_present",
       execution_pack_state: "task_class_precommit_and_loop_packs_present",
       continuation_state: "result_package_and_continuation_registry_present",
-      adapter_state: "adapter_registration_promotion_and_partner_registry_present"
+      adapter_state: "adapter_registration_promotion_and_partner_registry_present",
+      full_catalog_state: "family_lifecycle_market_registry_present"
     },
     linked_surfaces: {
       capability_registry_ref: "/v1/capability-registry",
       execution_truth_summary_ref: "/v1/capability-registry/execution-truth/summary",
       commercialization_summary_ref: "/v1/capability-registry/commercialization-summary",
+      full_catalog_summary_ref: "/v1/full-catalog/summary",
+      family_promotion_summary_ref: "/v1/full-catalog/family-promotions/summary",
       catalog_summary_ref: "/v1/catalog/summary",
       task_packs_summary_ref: "/v1/transaction-center/task-packs/summary",
       class_packs_summary_ref: "/v1/transaction-center/transaction-class-packs/summary",
@@ -103,6 +110,8 @@ function buildCapabilityRegistryBundle() {
     capability_registry_summary: buildCapabilityRegistrySummary(),
     capability_execution_truth: buildCapabilityExecutionTruthBundle(),
     capability_commercialization_summary: buildCapabilityCommercializationSummary(),
+    full_catalog_summary: summarizeFullCatalogPack(),
+    family_promotion_summary: summarizeFamilyPromotionPack(),
     catalog: getCatalog(),
     catalog_summary: summarizeCatalog(),
     task_pack_catalog: buildDefaultTransactionTaskPackCatalog(),
@@ -129,6 +138,8 @@ function buildCapabilityRegistryBundle() {
       capability_registry_summary_ref: "/v1/capability-registry/summary",
       capability_execution_truth_ref: "/v1/capability-registry/execution-truth",
       capability_commercialization_summary_ref: "/v1/capability-registry/commercialization-summary",
+      full_catalog_summary_ref: "/v1/full-catalog/summary",
+      family_promotion_summary_ref: "/v1/full-catalog/family-promotions/summary",
       catalog_ref: "/v1/catalog",
       task_pack_catalog_ref: "/v1/transaction-center/task-packs",
       class_pack_catalog_ref: "/v1/transaction-center/transaction-class-packs",
@@ -146,14 +157,23 @@ function buildCapabilityRegistryClassificationSummary() {
   const workflowCategories = new Map();
   const taskLatencies = new Map();
   const taskFailurePostures = new Map();
+  const taskFamilies = new Map();
+  const lifecycleStages = new Map();
+  const marketClasses = new Map();
 
   for (const task of Array.isArray(catalog.tasks) ? catalog.tasks : []) {
     const category = task && task.public_category ? task.public_category : "unknown";
     const latency = task && task.latency_class ? task.latency_class : "unknown";
     const failurePosture = task && task.failure_posture ? task.failure_posture : "unknown";
+    const taskFamily = task && task.task_family ? task.task_family : "unknown";
+    const lifecycleStage = task && task.lifecycle_stage ? task.lifecycle_stage : "unknown";
+    const marketClass = task && task.market_class ? task.market_class : "unknown";
     taskCategories.set(category, Number(taskCategories.get(category) || 0) + 1);
     taskLatencies.set(latency, Number(taskLatencies.get(latency) || 0) + 1);
     taskFailurePostures.set(failurePosture, Number(taskFailurePostures.get(failurePosture) || 0) + 1);
+    taskFamilies.set(taskFamily, Number(taskFamilies.get(taskFamily) || 0) + 1);
+    lifecycleStages.set(lifecycleStage, Number(lifecycleStages.get(lifecycleStage) || 0) + 1);
+    marketClasses.set(marketClass, Number(marketClasses.get(marketClass) || 0) + 1);
   }
 
   for (const workflow of Array.isArray(catalog.workflows) ? catalog.workflows : []) {
@@ -177,6 +197,9 @@ function buildCapabilityRegistryClassificationSummary() {
     category: "machine-commerce-capability-registry-classification-summary",
     summary_version: "xytara-capability-registry-classification-summary-v1",
     task_categories: Array.from(taskCategories.entries()).map(([category, task_count]) => ({ category, task_count })),
+    task_families: Array.from(taskFamilies.entries()).map(([task_family, task_count]) => ({ task_family, task_count })),
+    lifecycle_stages: Array.from(lifecycleStages.entries()).map(([lifecycle_stage, task_count]) => ({ lifecycle_stage, task_count })),
+    market_classes: Array.from(marketClasses.entries()).map(([market_class, task_count]) => ({ market_class, task_count })),
     workflow_categories: Array.from(workflowCategories.entries()).map(([category, workflow_count]) => ({ category, workflow_count })),
     task_latency_classes: Array.from(taskLatencies.entries()).map(([latency_class, task_count]) => ({ latency_class, task_count })),
     task_failure_postures: Array.from(taskFailurePostures.entries()).map(([failure_posture, task_count]) => ({ failure_posture, task_count })),
@@ -186,6 +209,7 @@ function buildCapabilityRegistryClassificationSummary() {
       capability_registry_ref: "/v1/capability-registry",
       capability_execution_truth_ref: "/v1/capability-registry/execution-truth",
       capability_commercialization_summary_ref: "/v1/capability-registry/commercialization-summary",
+      full_catalog_summary_ref: "/v1/full-catalog/summary",
       capability_registry_lineage_summary_ref: "/v1/capability-registry/lineage-summary",
       catalog_summary_ref: "/v1/catalog/summary"
     }

package/lib/catalog_contract.js

@@ -791,6 +791,11 @@ function summarizeCatalog() {
       pricing_note: task.pricing_note,
       latency_class: task.latency_class,
       failure_posture: task.failure_posture,
+      task_family: task.task_family,
+      lifecycle_stage: task.lifecycle_stage,
+      market_class: task.market_class,
+      claim_status: task.claim_status,
+      evidence_status: task.evidence_status,
       capabilities: task.capabilities,
       adapters: task.adapters
     })),
@@ -828,6 +833,11 @@ function getTaskDetail(ref) {
     pricing_note: task.pricing_note,
     latency_class: task.latency_class,
     failure_posture: task.failure_posture,
+    task_family: task.task_family,
+    lifecycle_stage: task.lifecycle_stage,
+    market_class: task.market_class,
+    claim_status: task.claim_status,
+    evidence_status: task.evidence_status,
     input_schema: task.input_schema,
     capabilities: task.capabilities,
     adapters: task.adapters
@@ -845,6 +855,11 @@ function buildWorkflowShape(workflow) {
       category: task.public_category,
       latency_class: task.latency_class,
       failure_posture: task.failure_posture,
+      task_family: task.task_family,
+      lifecycle_stage: task.lifecycle_stage,
+      market_class: task.market_class,
+      claim_status: task.claim_status,
+      evidence_status: task.evidence_status,
       pricing_band: task.pricing_band,
       public_launch_price: task.public_launch_price
     }));

package/lib/catalog_family_model.js

@@ -0,0 +1,190 @@
+"use strict";
+
+const FAMILY_DEFINITIONS = Object.freeze([
+  { family_id: "identity", label: "identity" },
+  { family_id: "discovery", label: "discovery" },
+  { family_id: "negotiation", label: "negotiation" },
+  { family_id: "invocation", label: "invocation" },
+  { family_id: "sessions_messaging", label: "sessions/messaging" },
+  { family_id: "payments_metering", label: "payments/metering" },
+  { family_id: "delivery", label: "delivery" },
+  { family_id: "disputes", label: "disputes" },
+  { family_id: "anchoring_finality", label: "anchoring/finality" }
+]);
+
+const LIFECYCLE_STAGE_DEFINITIONS = Object.freeze([
+  { lifecycle_stage: "discover", label: "discover" },
+  { lifecycle_stage: "negotiate", label: "negotiate" },
+  { lifecycle_stage: "quote_commit", label: "quote/commit" },
+  { lifecycle_stage: "invoke", label: "invoke" },
+  { lifecycle_stage: "session_send_close", label: "session/send/close" },
+  { lifecycle_stage: "meter", label: "meter" },
+  { lifecycle_stage: "deliver", label: "deliver" },
+  { lifecycle_stage: "settlement_intent", label: "settlement-intent" },
+  { lifecycle_stage: "settle_reconcile", label: "settle/reconcile" },
+  { lifecycle_stage: "anchor", label: "anchor" },
+  { lifecycle_stage: "dispute_open", label: "dispute-open" },
+  { lifecycle_stage: "dispute_fetch", label: "dispute-fetch" },
+  { lifecycle_stage: "verify", label: "verify" }
+]);
+
+const MARKET_CLASS_DEFINITIONS = Object.freeze([
+  { market_class: "compute", label: "compute" },
+  { market_class: "data", label: "data" },
+  { market_class: "storage", label: "storage" },
+  { market_class: "messaging", label: "messaging" },
+  { market_class: "device_robotics", label: "device/robotics" },
+  { market_class: "treasury_payments", label: "treasury/payments" }
+]);
+
+function mapCategoryDefaults(publicCategory) {
+  switch (String(publicCategory || "").trim()) {
+    case "trust":
+      return { task_family: "identity", lifecycle_stage: "verify", market_class: "data" };
+    case "receipt":
+      return { task_family: "delivery", lifecycle_stage: "verify", market_class: "data" };
+    case "runtime":
+      return { task_family: "delivery", lifecycle_stage: "deliver", market_class: "compute" };
+    case "jobs":
+      return { task_family: "invocation", lifecycle_stage: "quote_commit", market_class: "compute" };
+    case "credits":
+      return { task_family: "payments_metering", lifecycle_stage: "meter", market_class: "treasury_payments" };
+    case "a2a":
+      return { task_family: "negotiation", lifecycle_stage: "negotiate", market_class: "messaging" };
+    case "a2c":
+      return { task_family: "sessions_messaging", lifecycle_stage: "session_send_close", market_class: "messaging" };
+    case "policy":
+      return { task_family: "payments_metering", lifecycle_stage: "settlement_intent", market_class: "treasury_payments" };
+    case "identity":
+      return { task_family: "identity", lifecycle_stage: "verify", market_class: "data" };
+    case "registry":
+      return { task_family: "identity", lifecycle_stage: "deliver", market_class: "storage" };
+    case "anchoring":
+      return { task_family: "anchoring_finality", lifecycle_stage: "anchor", market_class: "storage" };
+    case "discovery":
+      return { task_family: "discovery", lifecycle_stage: "discover", market_class: "data" };
+    case "admission":
+      return { task_family: "negotiation", lifecycle_stage: "settlement_intent", market_class: "treasury_payments" };
+    case "settlement":
+      return { task_family: "payments_metering", lifecycle_stage: "settle_reconcile", market_class: "treasury_payments" };
+    case "adapter":
+      return { task_family: "invocation", lifecycle_stage: "invoke", market_class: "compute" };
+    default:
+      return { task_family: "discovery", lifecycle_stage: "discover", market_class: "data" };
+  }
+}
+
+function decorateTaskMetadata(definition = {}) {
+  const defaults = mapCategoryDefaults(definition.public_category);
+  const publicTaskRef = String(definition.public_task_ref || "").trim();
+  let task_family = defaults.task_family;
+  let lifecycle_stage = defaults.lifecycle_stage;
+  let market_class = defaults.market_class;
+  let claim_status = "bounded_live";
+  let evidence_status = "first_party_runtime";
+
+  switch (publicTaskRef) {
+    case "trust.handoff.emit":
+    case "execution_receipt.handoff.emit":
+    case "receipt_ledger.handoff.emit":
+    case "identity.registry.link":
+    case "registry.pack.bundle":
+    case "jobs.release":
+      lifecycle_stage = "deliver";
+      evidence_status = "proof_handoff_ready";
+      break;
+    case "trust.handoff.validate":
+    case "execution_receipt.handoff.validate":
+    case "receipt_ledger.handoff.validate":
+    case "receipt.validate":
+      lifecycle_stage = "verify";
+      break;
+    case "runtime.anchor":
+    case "runtime.emit_anchor":
+      task_family = "anchoring_finality";
+      lifecycle_stage = "anchor";
+      break;
+    case "jobs.quote":
+      lifecycle_stage = "quote_commit";
+      break;
+    case "jobs.reserve":
+    case "jobs.commit":
+      task_family = "invocation";
+      lifecycle_stage = "quote_commit";
+      break;
+    case "credits.apply":
+      lifecycle_stage = "settle_reconcile";
+      evidence_status = "first_party_ledger";
+      break;
+    case "a2a.commit":
+      lifecycle_stage = "quote_commit";
+      break;
+    case "policy.simulate":
+    case "admission.preview":
+      lifecycle_stage = "settlement_intent";
+      evidence_status = "first_party_policy_preview";
+      break;
+    case "settlement.submit":
+      lifecycle_stage = "settle_reconcile";
+      evidence_status = "first_party_settlement";
+      break;
+    case "adapter.mcp.invoke":
+      claim_status = "live";
+      evidence_status = "provider_live";
+      break;
+    default:
+      break;
+  }
+
+  return {
+    task_family,
+    lifecycle_stage,
+    market_class,
+    claim_status,
+    evidence_status
+  };
+}
+
+function decorateAdapterMetadata(adapterId) {
+  switch (String(adapterId || "").trim()) {
+    case "mcp":
+      return {
+        task_family: "invocation",
+        lifecycle_stage: "invoke",
+        market_class: "compute",
+        claim_status: "live",
+        evidence_status: "provider_live"
+      };
+    case "chain":
+      return {
+        task_family: "payments_metering",
+        lifecycle_stage: "settle_reconcile",
+        market_class: "treasury_payments",
+        claim_status: "bounded_live",
+        evidence_status: "first_party_settlement"
+      };
+    case "http":
+    default:
+      return {
+        task_family: "discovery",
+        lifecycle_stage: "discover",
+        market_class: "data",
+        claim_status: "bounded_live",
+        evidence_status: "first_party_runtime"
+      };
+  }
+}
+
+function definitionLabel(definitions, field, value) {
+  const entry = definitions.find((item) => item[field] === value);
+  return entry ? entry.label : value;
+}
+
+module.exports = {
+  FAMILY_DEFINITIONS,
+  LIFECYCLE_STAGE_DEFINITIONS,
+  MARKET_CLASS_DEFINITIONS,
+  decorateAdapterMetadata,
+  decorateTaskMetadata,
+  definitionLabel
+};

package/lib/delivery_summary_contract.js

@@ -0,0 +1,95 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { loadRuntimeOperationsConfig } = require("./runtime_operations_worker");
+
+function listDeliveries(state) {
+  if (!state || !state.deliveries) return [];
+  if (state.deliveries instanceof Map) {
+    return Array.from(state.deliveries.values()).filter(Boolean);
+  }
+  return Array.isArray(state.deliveries) ? state.deliveries.filter(Boolean) : [];
+}
+
+function summarizeDeliveryState(state) {
+  const config = loadRuntimeOperationsConfig();
+  const deliveries = listDeliveries(state);
+  const callbackDeliveries = deliveries.filter((delivery) => delivery && delivery.callback_url);
+  const directDeliveries = deliveries.filter((delivery) => delivery && !delivery.callback_url);
+  const deliveredDeliveries = deliveries.filter((delivery) => delivery && delivery.status === "delivered");
+  const pendingDeliveries = deliveries.filter((delivery) => delivery && delivery.status === "pending_delivery");
+  const retryingCallbackDeliveries = callbackDeliveries.filter((delivery) => {
+    const callbackDelivery = delivery.callback_delivery || {};
+    return callbackDelivery.status === "retrying";
+  });
+  const queuedCallbackDeliveries = callbackDeliveries.filter((delivery) => {
+    const callbackDelivery = delivery.callback_delivery || {};
+    return callbackDelivery.status === "queued";
+  });
+  const inProgressCallbackDeliveries = callbackDeliveries.filter((delivery) => {
+    const callbackDelivery = delivery.callback_delivery || {};
+    return callbackDelivery.status === "in_progress";
+  });
+  const failedCallbackDeliveries = callbackDeliveries.filter((delivery) => {
+    const callbackDelivery = delivery.callback_delivery || {};
+    return callbackDelivery.status === "failed";
+  });
+  const signedCallbackDeliveries = callbackDeliveries.filter((delivery) => {
+    const callbackDelivery = delivery.callback_delivery || {};
+    return callbackDelivery.signature_mode === "hmac_sha256";
+  });
+  const callbackSignalingConfigured = config.callback_delivery_enabled === true;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-delivery-summary",
+    summary_version: "xytara-delivery-summary-v1",
+    callback_delivery_enabled: config.callback_delivery_enabled,
+    callback_signing_secret_configured: Boolean(config.callback_signing_secret),
+    callback_timeout_ms: config.callback_timeout_ms,
+    callback_max_attempts: config.callback_max_attempts,
+    callback_retry_base_ms: config.callback_retry_base_ms,
+    worker_interval_ms: config.worker_interval_ms,
+    settlement_refresh_interval_ms: config.settlement_refresh_interval_ms,
+    delivery_count: deliveries.length,
+    callback_delivery_count: callbackDeliveries.length,
+    direct_delivery_count: directDeliveries.length,
+    delivered_delivery_count: deliveredDeliveries.length,
+    pending_delivery_count: pendingDeliveries.length,
+    queued_callback_delivery_count: queuedCallbackDeliveries.length,
+    in_progress_callback_delivery_count: inProgressCallbackDeliveries.length,
+    retrying_callback_delivery_count: retryingCallbackDeliveries.length,
+    failed_callback_delivery_count: failedCallbackDeliveries.length,
+    signed_callback_delivery_count: signedCallbackDeliveries.length,
+    delivery_posture: callbackSignalingConfigured ? "callback_enabled" : "callback_disabled",
+    ready: callbackSignalingConfigured,
+    blockers: callbackSignalingConfigured ? [] : ["callback_delivery_disabled"],
+    linked_surfaces: {
+      deliveries_ref: "/v1/deliveries",
+      go_live_ref: "/v1/go-live",
+      go_live_summary_ref: "/v1/go-live/summary",
+      runtime_durability_ref: "/v1/runtime/durability"
+    }
+  };
+}
+
+function buildDeliverySummaryPack(state) {
+  const summary = summarizeDeliveryState(state);
+  return {
+    ...summary,
+    delivery_statuses: {
+      delivered: summary.delivered_delivery_count,
+      pending: summary.pending_delivery_count,
+      callback_queued: summary.queued_callback_delivery_count,
+      callback_in_progress: summary.in_progress_callback_delivery_count,
+      callback_retrying: summary.retrying_callback_delivery_count,
+      callback_failed: summary.failed_callback_delivery_count
+    }
+  };
+}
+
+module.exports = {
+  buildDeliverySummaryPack,
+  summarizeDeliveryState
+};