xytara 3.1.0 → 3.1.2

package/lib/capability_execution_truth.js

@@ -1,272 +1,272 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const { catalog } = require("../fixtures/catalog");
-const { summarizeAdapterDepthPack } = require("./adapter_depth_contract");
-const { loadExecutionTargetRegistry } = require("./external_execution_runtime");
-const { loadBsvSettlementRuntimeConfig } = require("./settlement_bsv_live");
-const { summarizeTreasuryDestinationsPack } = require("./treasury_destinations_contract");
-
-const NATIVE_RUNTIME_CATEGORIES = new Set([
-  "trust",
-  "receipt",
-  "runtime",
-  "jobs",
-  "credits",
-  "a2a",
-  "a2c",
-  "policy",
-  "identity",
-  "registry",
-  "anchoring",
-  "discovery",
-  "admission"
-]);
-
-function normalizeString(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-
-function hasMerchantIdentity() {
-  return Boolean(
-    normalizeString(process.env.XYTARA_BSV_TERANODE_MERCHANT_ADDRESS)
-    || normalizeString(process.env.XYTARA_BSV_TERANODE_MERCHANT_PAYMAIL)
-  );
-}
-
-function isLiveRuntimeMode(mode) {
-  return normalizeString(mode).toLowerCase() !== "mock";
-}
-
-function buildSettlementReadiness() {
-  const runtimeConfig = loadBsvSettlementRuntimeConfig();
-  const treasurySummary = summarizeTreasuryDestinationsPack();
-  const liveMode = isLiveRuntimeMode(runtimeConfig.mode);
-  const merchantConfigured = hasMerchantIdentity();
-  const treasuryConfigured = Number(treasurySummary.configured_profile_count || 0) > 0;
-  const ready = liveMode && merchantConfigured && treasuryConfigured;
-  return {
-    ready,
-    runtime_mode: runtimeConfig.mode,
-    merchant_identity_configured: merchantConfigured,
-    treasury_configured: treasuryConfigured,
-    configured_profile_count: Number(treasurySummary.configured_profile_count || 0),
-    explicit_per_rail_configured_count: Number(treasurySummary.explicit_per_rail_configured_count || 0)
-  };
-}
-
-function findMatchingExecutionTargets(task) {
-  const targets = loadExecutionTargetRegistry();
-  const taskRefs = new Set(
-    [task && task.task_ref, task && task.public_task_ref]
-      .map((value) => normalizeString(value))
-      .filter(Boolean)
-  );
-  return targets.filter((target) => {
-    const targetTaskRef = normalizeString(target && target.task_ref);
-    if (targetTaskRef && taskRefs.has(targetTaskRef)) return true;
-    if (
-      normalizeString(task && task.public_task_ref) === "adapter.mcp.invoke"
-      || normalizeString(task && task.public_task_ref).startsWith("adapter.mcp.")
-    ) {
-      return Boolean(normalizeString(target && target.tool_name) || normalizeString(target && target.integration_id));
-    }
-    return false;
-  });
-}
-
-function classifyTask(task, settlementReadiness) {
-  const matches = findMatchingExecutionTargets(task);
-  const providerTargets = matches.map((target) => ({
-    target_id: target.target_id,
-    provider: target.provider,
-    task_ref: target.task_ref || null,
-    tool_name: target.tool_name || null,
-    integration_id: target.integration_id || null,
-    enabled: target.enabled !== false
-  }));
-
-  if (normalizeString(task && task.public_category) === "settlement") {
-    return {
-      task_ref: task.public_task_ref,
-      internal_task_ref: task.task_ref,
-      public_title: task.public_title,
-      public_category: task.public_category,
-      execution_mode: task.execution_mode,
-      latency_class: task.latency_class,
-      execution_truth: settlementReadiness.ready ? "native_live" : "operator_inputs_pending",
-      execution_origin: "native_settlement_runtime",
-      commercialization_posture: settlementReadiness.ready ? "sellable_live_now" : "sellable_when_operator_configured",
-      matching_execution_target_count: providerTargets.length,
-      matching_execution_targets: providerTargets,
-      requirements: {
-        bsv_runtime_mode: settlementReadiness.runtime_mode,
-        merchant_identity_configured: settlementReadiness.merchant_identity_configured,
-        treasury_configured: settlementReadiness.treasury_configured
-      }
-    };
-  }
-
-  if (normalizeString(task && task.public_category) === "adapter") {
-    return {
-      task_ref: task.public_task_ref,
-      internal_task_ref: task.task_ref,
-      public_title: task.public_title,
-      public_category: task.public_category,
-      execution_mode: task.execution_mode,
-      latency_class: task.latency_class,
-      execution_truth: providerTargets.length > 0 ? "provider_live" : "provider_wiring_required",
-      execution_origin: providerTargets.length > 0 ? "external_execution_target" : "adapter_lane_without_bound_target",
-      commercialization_posture: providerTargets.length > 0 ? "sellable_live_now" : "sellable_by_integration",
-      matching_execution_target_count: providerTargets.length,
-      matching_execution_targets: providerTargets,
-      requirements: {
-        configured_provider_target_required: true
-      }
-    };
-  }
-
-  if (NATIVE_RUNTIME_CATEGORIES.has(normalizeString(task && task.public_category))) {
-    return {
-      task_ref: task.public_task_ref,
-      internal_task_ref: task.task_ref,
-      public_title: task.public_title,
-      public_category: task.public_category,
-      execution_mode: task.execution_mode,
-      latency_class: task.latency_class,
-      execution_truth: "native_live",
-      execution_origin: "native_runtime_contract",
-      commercialization_posture: "sellable_live_now",
-      matching_execution_target_count: providerTargets.length,
-      matching_execution_targets: providerTargets,
-      requirements: {
-        configured_provider_target_required: false
-      }
-    };
-  }
-
-  return {
-    task_ref: task.public_task_ref,
-    internal_task_ref: task.task_ref,
-    public_title: task.public_title,
-    public_category: task.public_category,
-    execution_mode: task.execution_mode,
-    latency_class: task.latency_class,
-    execution_truth: providerTargets.length > 0 ? "provider_live" : "operator_classification_required",
-    execution_origin: providerTargets.length > 0 ? "external_execution_target" : "uncategorized_runtime_surface",
-    commercialization_posture: providerTargets.length > 0 ? "sellable_live_now" : "hold_until_classified",
-    matching_execution_target_count: providerTargets.length,
-    matching_execution_targets: providerTargets,
-    requirements: {
-      configured_provider_target_required: providerTargets.length < 1
-    }
-  };
-}
-
-function buildCapabilityExecutionTruthBundle() {
-  const settlementReadiness = buildSettlementReadiness();
-  const adapterDepth = summarizeAdapterDepthPack();
-  const tasks = (Array.isArray(catalog.tasks) ? catalog.tasks : []).map((task) => classifyTask(task, settlementReadiness));
-  const counts = {
-    task_count: tasks.length,
-    native_live_count: tasks.filter((task) => task.execution_truth === "native_live").length,
-    provider_live_count: tasks.filter((task) => task.execution_truth === "provider_live").length,
-    operator_inputs_pending_count: tasks.filter((task) => task.execution_truth === "operator_inputs_pending").length,
-    provider_wiring_required_count: tasks.filter((task) => task.execution_truth === "provider_wiring_required").length,
-    operator_classification_required_count: tasks.filter((task) => task.execution_truth === "operator_classification_required").length
-  };
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-capability-execution-truth",
-    bundle_version: "xytara-capability-execution-truth-v1",
-    execution_posture: {
-      native_runtime_categories: Array.from(NATIVE_RUNTIME_CATEGORIES.values()),
-      settlement_readiness: settlementReadiness,
-      configured_execution_target_count: loadExecutionTargetRegistry().length,
-      adapter_depth_state: adapterDepth.adapter_depth_state,
-      adapter_depth_counts: adapterDepth.counts
-    },
-    counts,
-    tasks,
-    linked_surfaces: {
-      capability_registry_ref: "/v1/capability-registry",
-      execution_truth_summary_ref: "/v1/capability-registry/execution-truth/summary",
-      adapter_depth_ref: "/v1/adapter-depth",
-      adapter_depth_summary_ref: "/v1/adapter-depth/summary",
-      treasury_readiness_ref: "/v1/treasury-destinations",
-      native_settlement_readiness_ref: "/v1/settlement/bsv-teranode/readiness"
-    }
-  };
-}
-
-function summarizeCapabilityExecutionTruthBundle() {
-  const bundle = buildCapabilityExecutionTruthBundle();
-  return {
-    ok: true,
-    product: bundle.product,
-    category: bundle.category,
-    bundle_version: bundle.bundle_version,
-    counts: bundle.counts,
-    execution_posture: bundle.execution_posture,
-    linked_surfaces: bundle.linked_surfaces
-  };
-}
-
-function buildCapabilityCommercializationSummary() {
-  const bundle = buildCapabilityExecutionTruthBundle();
-  const tasks = Array.isArray(bundle.tasks) ? bundle.tasks : [];
-  const selfServeLiveNow = tasks.filter((task) =>
-    task.commercialization_posture === "sellable_live_now"
-  );
-  const operatorEnabledAfterConfig = tasks.filter((task) =>
-    task.commercialization_posture === "sellable_when_operator_configured"
-    || task.commercialization_posture === "sellable_by_integration"
-  );
-  const holdUntilClassified = tasks.filter((task) =>
-    task.commercialization_posture === "hold_until_classified"
-  );
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-capability-commercialization-summary",
-    summary_version: "xytara-capability-commercialization-summary-v1",
-    commercialization_posture: {
-      primary_agent_entry_surfaces: ["x402", "mcp", "a2a", "a2c", "http_api"],
-      secondary_human_entry_surfaces: ["hosted_checkout", "web_docs", "npm_package"],
-      primary_payment_surfaces: ["x402", "credits", "hosted_checkout"],
-      discovery_surfaces: ["capability_registry", "catalog", "execution_truth"]
-    },
-    counts: {
-      self_serve_live_now: selfServeLiveNow.length,
-      operator_enabled_after_config: operatorEnabledAfterConfig.length,
-      hold_until_classified: holdUntilClassified.length
-    },
-    sellable_now_task_refs: selfServeLiveNow.map((task) => task.task_ref),
-    operator_enabled_task_refs: operatorEnabledAfterConfig.map((task) => task.task_ref),
-    hold_task_refs: holdUntilClassified.map((task) => task.task_ref),
-    recommendations: [
-      "Use x402 for machine-native pay-per-use access and keep hosted checkout as the human-friendly money-in lane.",
-      "Expose MCP and A2A entry paths for interoperable agent consumption while preserving execution-truth visibility.",
-      "Only market provider-backed capabilities as instant self-serve once execution targets are configured and operator readiness is green."
-    ],
-    linked_surfaces: {
-      capability_registry_ref: "/v1/capability-registry",
-      execution_truth_ref: "/v1/capability-registry/execution-truth",
-      execution_truth_summary_ref: "/v1/capability-registry/execution-truth/summary",
-      x402_ref: "/v1/x402",
-      mcp_ref: "/v1/mcp",
-      a2a_ref: "/v1/a2a",
-      a2c_ref: "/v1/a2c",
-      checkout_ref: "/v1/checkout/purchase-intents"
-    }
-  };
-}
-
-module.exports = {
-  buildCapabilityExecutionTruthBundle,
-  summarizeCapabilityExecutionTruthBundle,
-  buildCapabilityCommercializationSummary
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const { catalog } = require("../fixtures/catalog");
+const { summarizeAdapterDepthPack } = require("./adapter_depth_contract");
+const { loadExecutionTargetRegistry } = require("./external_execution_runtime");
+const { loadBsvSettlementRuntimeConfig } = require("./settlement_bsv_live");
+const { summarizeTreasuryDestinationsPack } = require("./treasury_destinations_contract");
+
+const NATIVE_RUNTIME_CATEGORIES = new Set([
+  "trust",
+  "receipt",
+  "runtime",
+  "jobs",
+  "credits",
+  "a2a",
+  "a2c",
+  "policy",
+  "identity",
+  "registry",
+  "anchoring",
+  "discovery",
+  "admission"
+]);
+
+function normalizeString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function hasMerchantIdentity() {
+  return Boolean(
+    normalizeString(process.env.XYTARA_BSV_TERANODE_MERCHANT_ADDRESS)
+    || normalizeString(process.env.XYTARA_BSV_TERANODE_MERCHANT_PAYMAIL)
+  );
+}
+
+function isLiveRuntimeMode(mode) {
+  return normalizeString(mode).toLowerCase() !== "mock";
+}
+
+function buildSettlementReadiness() {
+  const runtimeConfig = loadBsvSettlementRuntimeConfig();
+  const treasurySummary = summarizeTreasuryDestinationsPack();
+  const liveMode = isLiveRuntimeMode(runtimeConfig.mode);
+  const merchantConfigured = hasMerchantIdentity();
+  const treasuryConfigured = Number(treasurySummary.configured_profile_count || 0) > 0;
+  const ready = liveMode && merchantConfigured && treasuryConfigured;
+  return {
+    ready,
+    runtime_mode: runtimeConfig.mode,
+    merchant_identity_configured: merchantConfigured,
+    treasury_configured: treasuryConfigured,
+    configured_profile_count: Number(treasurySummary.configured_profile_count || 0),
+    explicit_per_rail_configured_count: Number(treasurySummary.explicit_per_rail_configured_count || 0)
+  };
+}
+
+function findMatchingExecutionTargets(task) {
+  const targets = loadExecutionTargetRegistry();
+  const taskRefs = new Set(
+    [task && task.task_ref, task && task.public_task_ref]
+      .map((value) => normalizeString(value))
+      .filter(Boolean)
+  );
+  return targets.filter((target) => {
+    const targetTaskRef = normalizeString(target && target.task_ref);
+    if (targetTaskRef && taskRefs.has(targetTaskRef)) return true;
+    if (
+      normalizeString(task && task.public_task_ref) === "adapter.mcp.invoke"
+      || normalizeString(task && task.public_task_ref).startsWith("adapter.mcp.")
+    ) {
+      return Boolean(normalizeString(target && target.tool_name) || normalizeString(target && target.integration_id));
+    }
+    return false;
+  });
+}
+
+function classifyTask(task, settlementReadiness) {
+  const matches = findMatchingExecutionTargets(task);
+  const providerTargets = matches.map((target) => ({
+    target_id: target.target_id,
+    provider: target.provider,
+    task_ref: target.task_ref || null,
+    tool_name: target.tool_name || null,
+    integration_id: target.integration_id || null,
+    enabled: target.enabled !== false
+  }));
+
+  if (normalizeString(task && task.public_category) === "settlement") {
+    return {
+      task_ref: task.public_task_ref,
+      internal_task_ref: task.task_ref,
+      public_title: task.public_title,
+      public_category: task.public_category,
+      execution_mode: task.execution_mode,
+      latency_class: task.latency_class,
+      execution_truth: settlementReadiness.ready ? "native_live" : "operator_inputs_pending",
+      execution_origin: "native_settlement_runtime",
+      commercialization_posture: settlementReadiness.ready ? "sellable_live_now" : "sellable_when_operator_configured",
+      matching_execution_target_count: providerTargets.length,
+      matching_execution_targets: providerTargets,
+      requirements: {
+        bsv_runtime_mode: settlementReadiness.runtime_mode,
+        merchant_identity_configured: settlementReadiness.merchant_identity_configured,
+        treasury_configured: settlementReadiness.treasury_configured
+      }
+    };
+  }
+
+  if (normalizeString(task && task.public_category) === "adapter") {
+    return {
+      task_ref: task.public_task_ref,
+      internal_task_ref: task.task_ref,
+      public_title: task.public_title,
+      public_category: task.public_category,
+      execution_mode: task.execution_mode,
+      latency_class: task.latency_class,
+      execution_truth: providerTargets.length > 0 ? "provider_live" : "provider_wiring_required",
+      execution_origin: providerTargets.length > 0 ? "external_execution_target" : "adapter_lane_without_bound_target",
+      commercialization_posture: providerTargets.length > 0 ? "sellable_live_now" : "sellable_by_integration",
+      matching_execution_target_count: providerTargets.length,
+      matching_execution_targets: providerTargets,
+      requirements: {
+        configured_provider_target_required: true
+      }
+    };
+  }
+
+  if (NATIVE_RUNTIME_CATEGORIES.has(normalizeString(task && task.public_category))) {
+    return {
+      task_ref: task.public_task_ref,
+      internal_task_ref: task.task_ref,
+      public_title: task.public_title,
+      public_category: task.public_category,
+      execution_mode: task.execution_mode,
+      latency_class: task.latency_class,
+      execution_truth: "native_live",
+      execution_origin: "native_runtime_contract",
+      commercialization_posture: "sellable_live_now",
+      matching_execution_target_count: providerTargets.length,
+      matching_execution_targets: providerTargets,
+      requirements: {
+        configured_provider_target_required: false
+      }
+    };
+  }
+
+  return {
+    task_ref: task.public_task_ref,
+    internal_task_ref: task.task_ref,
+    public_title: task.public_title,
+    public_category: task.public_category,
+    execution_mode: task.execution_mode,
+    latency_class: task.latency_class,
+    execution_truth: providerTargets.length > 0 ? "provider_live" : "operator_classification_required",
+    execution_origin: providerTargets.length > 0 ? "external_execution_target" : "uncategorized_runtime_surface",
+    commercialization_posture: providerTargets.length > 0 ? "sellable_live_now" : "hold_until_classified",
+    matching_execution_target_count: providerTargets.length,
+    matching_execution_targets: providerTargets,
+    requirements: {
+      configured_provider_target_required: providerTargets.length < 1
+    }
+  };
+}
+
+function buildCapabilityExecutionTruthBundle() {
+  const settlementReadiness = buildSettlementReadiness();
+  const adapterDepth = summarizeAdapterDepthPack();
+  const tasks = (Array.isArray(catalog.tasks) ? catalog.tasks : []).map((task) => classifyTask(task, settlementReadiness));
+  const counts = {
+    task_count: tasks.length,
+    native_live_count: tasks.filter((task) => task.execution_truth === "native_live").length,
+    provider_live_count: tasks.filter((task) => task.execution_truth === "provider_live").length,
+    operator_inputs_pending_count: tasks.filter((task) => task.execution_truth === "operator_inputs_pending").length,
+    provider_wiring_required_count: tasks.filter((task) => task.execution_truth === "provider_wiring_required").length,
+    operator_classification_required_count: tasks.filter((task) => task.execution_truth === "operator_classification_required").length
+  };
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-capability-execution-truth",
+    bundle_version: "xytara-capability-execution-truth-v1",
+    execution_posture: {
+      native_runtime_categories: Array.from(NATIVE_RUNTIME_CATEGORIES.values()),
+      settlement_readiness: settlementReadiness,
+      configured_execution_target_count: loadExecutionTargetRegistry().length,
+      adapter_depth_state: adapterDepth.adapter_depth_state,
+      adapter_depth_counts: adapterDepth.counts
+    },
+    counts,
+    tasks,
+    linked_surfaces: {
+      capability_registry_ref: "/v1/capability-registry",
+      execution_truth_summary_ref: "/v1/capability-registry/execution-truth/summary",
+      adapter_depth_ref: "/v1/adapter-depth",
+      adapter_depth_summary_ref: "/v1/adapter-depth/summary",
+      treasury_readiness_ref: "/v1/treasury-destinations",
+      native_settlement_readiness_ref: "/v1/settlement/bsv-teranode/readiness"
+    }
+  };
+}
+
+function summarizeCapabilityExecutionTruthBundle() {
+  const bundle = buildCapabilityExecutionTruthBundle();
+  return {
+    ok: true,
+    product: bundle.product,
+    category: bundle.category,
+    bundle_version: bundle.bundle_version,
+    counts: bundle.counts,
+    execution_posture: bundle.execution_posture,
+    linked_surfaces: bundle.linked_surfaces
+  };
+}
+
+function buildCapabilityCommercializationSummary() {
+  const bundle = buildCapabilityExecutionTruthBundle();
+  const tasks = Array.isArray(bundle.tasks) ? bundle.tasks : [];
+  const selfServeLiveNow = tasks.filter((task) =>
+    task.commercialization_posture === "sellable_live_now"
+  );
+  const operatorEnabledAfterConfig = tasks.filter((task) =>
+    task.commercialization_posture === "sellable_when_operator_configured"
+    || task.commercialization_posture === "sellable_by_integration"
+  );
+  const holdUntilClassified = tasks.filter((task) =>
+    task.commercialization_posture === "hold_until_classified"
+  );
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-capability-commercialization-summary",
+    summary_version: "xytara-capability-commercialization-summary-v1",
+    commercialization_posture: {
+      primary_agent_entry_surfaces: ["x402", "mcp", "a2a", "a2c", "http_api"],
+      secondary_human_entry_surfaces: ["hosted_checkout", "web_docs", "npm_package"],
+      primary_payment_surfaces: ["x402", "credits", "hosted_checkout"],
+      discovery_surfaces: ["capability_registry", "catalog", "execution_truth"]
+    },
+    counts: {
+      self_serve_live_now: selfServeLiveNow.length,
+      operator_enabled_after_config: operatorEnabledAfterConfig.length,
+      hold_until_classified: holdUntilClassified.length
+    },
+    sellable_now_task_refs: selfServeLiveNow.map((task) => task.task_ref),
+    operator_enabled_task_refs: operatorEnabledAfterConfig.map((task) => task.task_ref),
+    hold_task_refs: holdUntilClassified.map((task) => task.task_ref),
+    recommendations: [
+      "Use x402 for machine-native pay-per-use access and keep hosted checkout as the human-friendly money-in lane.",
+      "Expose MCP and A2A entry paths for interoperable agent consumption while preserving execution-truth visibility.",
+      "Only market provider-backed capabilities as instant self-serve once execution targets are configured and operator readiness is green."
+    ],
+    linked_surfaces: {
+      capability_registry_ref: "/v1/capability-registry",
+      execution_truth_ref: "/v1/capability-registry/execution-truth",
+      execution_truth_summary_ref: "/v1/capability-registry/execution-truth/summary",
+      x402_ref: "/v1/x402",
+      mcp_ref: "/v1/mcp",
+      a2a_ref: "/v1/a2a",
+      a2c_ref: "/v1/a2c",
+      checkout_ref: "/v1/checkout/purchase-intents"
+    }
+  };
+}
+
+module.exports = {
+  buildCapabilityExecutionTruthBundle,
+  summarizeCapabilityExecutionTruthBundle,
+  buildCapabilityCommercializationSummary
+};