xytara 2.0.0 → 2.2.0

package/index.js

@@ -5,6 +5,60 @@ const {
   ADAPTER_INTERFACE_VERSION,
   validateAdapterImplementation
 } = require("./adapters/interfaces");
+const {
+  buildReleasePack,
+  summarizeReleasePack,
+  buildComparisonPack,
+  summarizeComparisonPack,
+  buildAdoptionPack,
+  summarizeAdoptionPack,
+  buildScenarioPack,
+  summarizeScenarioPack,
+  buildLaunchPack,
+  summarizeLaunchPack
+} = require("./lib/release_pack");
+const {
+  buildReleaseManifest,
+  summarizeReleaseManifest,
+  buildLaunchNotes,
+  summarizeLaunchNotes
+} = require("./lib/release_manifest");
+const {
+  buildReleaseCenter,
+  summarizeReleaseCenter
+} = require("./lib/release_center");
+const {
+  buildReleaseHistory,
+  summarizeReleaseHistory
+} = require("./lib/release_history");
+const {
+  buildAdapterPack,
+  summarizeAdapterPack
+} = require("./lib/adapter_pack");
+const {
+  buildPublishPlan,
+  summarizePublishPlan
+} = require("./lib/publish_plan");
+const {
+  buildEcosystemEntryPack,
+  summarizeEcosystemEntryPack
+} = require("./lib/ecosystem_entry");
+const {
+  buildLaunchNarrativePack,
+  summarizeLaunchNarrativePack
+} = require("./lib/launch_narrative");
+const {
+  buildOutreachProofPack,
+  summarizeOutreachProofPack
+} = require("./lib/outreach_proof");
+const {
+  buildAnnouncementPack,
+  summarizeAnnouncementPack
+} = require("./lib/announcement_pack");
+const {
+  buildReleaseCandidatePack,
+  summarizeReleaseCandidatePack
+} = require("./lib/release_candidate");
 const {
   getIntegration,
   listIntegrations,
@@ -40,7 +94,7 @@ const {
 } = require("./integrations/registry");
 
 const COMMERCE_SDK_NAME = "xytara";
-const COMMERCE_SDK_VERSION = "2.0.0";
+const COMMERCE_SDK_VERSION = "2.2.0";
 const COMMERCE_API_VERSION = "v1";
 
 function createClient(options) {
@@ -85,5 +139,37 @@ module.exports = {
   summarizeIntegrationPromotionActionPreview,
   summarizeIntegrationPromotionActionSet,
   summarizeIntegrationPromotionActionSetList,
+  buildReleasePack,
+  summarizeReleasePack,
+  buildComparisonPack,
+  summarizeComparisonPack,
+  buildAdoptionPack,
+  summarizeAdoptionPack,
+  buildScenarioPack,
+  summarizeScenarioPack,
+  buildLaunchPack,
+  summarizeLaunchPack,
+  buildReleaseManifest,
+  summarizeReleaseManifest,
+  buildLaunchNotes,
+  summarizeLaunchNotes,
+  buildReleaseCenter,
+  summarizeReleaseCenter,
+  buildReleaseHistory,
+  summarizeReleaseHistory,
+  buildAdapterPack,
+  summarizeAdapterPack,
+  buildPublishPlan,
+  summarizePublishPlan,
+  buildEcosystemEntryPack,
+  summarizeEcosystemEntryPack,
+  buildLaunchNarrativePack,
+  summarizeLaunchNarrativePack,
+  buildOutreachProofPack,
+  summarizeOutreachProofPack,
+  buildAnnouncementPack,
+  summarizeAnnouncementPack,
+  buildReleaseCandidatePack,
+  summarizeReleaseCandidatePack,
   validateAdapterImplementation
 };

package/lib/adapter_pack.js

@@ -0,0 +1,118 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildAdapterPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-adapter-pack",
+    positioning: {
+      line: "adapter-first machine commerce for third-party execution, settlement, protocol, and identity surfaces",
+      intended_for: [
+        "adapter_authors",
+        "protocol_bridge_builders",
+        "settlement_integrators",
+        "identity_and_registry_integrators"
+      ]
+    },
+    onboarding: {
+      first_docs: [
+        "ADAPTER_START_HERE.md",
+        "adapters/AUTHORING_GUIDE.md",
+        "adapters/ONBOARDING_POSTURE.md",
+        "adapters/THIRD_PARTY_SUBMISSION_PROCESS.md"
+      ],
+      starter_classes: [
+        "execution_adapter",
+        "payment_rail_adapter",
+        "settlement_adapter",
+        "agent_protocol_adapter",
+        "identity_registry_adapter"
+      ],
+      first_commands: [
+        "npm run verify:adapters",
+        "node scripts/registry_cli.js validate-bundle --example protocol",
+        "node scripts/registry_cli.js review-bundle --example protocol",
+        "node scripts/registry_cli.js promotion-readiness --integration partner.protocol.acme_mcp"
+      ]
+    },
+    artifact_stack: [
+      "adapter_manifest",
+      "registration_record",
+      "certification_pack",
+      "submission_bundle",
+      "submission_bundle_set",
+      "registry_snapshot"
+    ],
+    promotion_posture: {
+      explicit_states: [
+        "review_ready",
+        "default_eligible",
+        "production_default_ready"
+      ],
+      default_third_party_posture: {
+        discoverable: true,
+        reviewable: true,
+        explicitly_selectable: true,
+        default_eligible: false,
+        production_default_ready: false
+      }
+    },
+    examples: {
+      canonical_examples: [
+        "adapters/examples/minimal-third-party-execution-adapter.manifest.json",
+        "adapters/examples/minimal-third-party-execution-adapter.js",
+        "adapters/examples/minimal-third-party-execution.submission-bundle.json",
+        "adapters/examples/example-execution-adapter.manifest.json",
+        "adapters/examples/example-execution-adapter.js",
+        "adapters/examples/example-settlement-adapter.manifest.json",
+        "adapters/examples/example-settlement-adapter.js",
+        "adapters/examples/example-third-party-registration.submission-bundle.json",
+        "adapters/examples/example-third-party-identity-registration.submission-bundle.json",
+        "adapters/examples/example-third-party-settlement-registration.submission-bundle.json"
+      ],
+      review_examples: [
+        "minimal_third_party_execution",
+        "protocol",
+        "identity",
+        "settlement"
+      ]
+    },
+    public_surfaces: {
+      integrations_summary: "/v1/integrations/summary",
+      promotion_readiness: "/v1/integrations/promotion-readiness",
+      promotion_actions: "/v1/integrations/promotion-actions",
+      submission_bundle_review: "/v1/integrations/review/submission-bundle",
+      submission_bundle_set_review: "/v1/integrations/review/submission-bundle-set",
+      registry_snapshot_review: "/v1/integrations/review/registry-snapshot"
+    },
+    why_it_matters: [
+      "third-party integrations can be staged and reviewed without becoming defaults",
+      "promotion posture is inspectable as data rather than private process",
+      "submission artifacts stay normalized across adapter classes",
+      "machine-commerce flexibility does not require vendor lock-in"
+    ]
+  };
+}
+
+function summarizeAdapterPack() {
+  const pack = buildAdapterPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    audience_count: pack.positioning.intended_for.length,
+    starter_class_count: pack.onboarding.starter_classes.length,
+    first_command_count: pack.onboarding.first_commands.length,
+    artifact_count: pack.artifact_stack.length,
+    example_count: pack.examples.canonical_examples.length,
+    review_example_count: pack.examples.review_examples.length,
+    first_doc: pack.onboarding.first_docs[0]
+  };
+}
+
+module.exports = {
+  buildAdapterPack,
+  summarizeAdapterPack
+};

package/lib/adapter_partner_pack.js

@@ -0,0 +1,89 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildAdapterPartnerPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-adapter-partner-pack",
+    positioning: {
+      line: "build, review, and promote third-party adapters on top of xytara without giving up explicit trust posture",
+      intended_for: [
+        "ecosystem_partners",
+        "adapter_authors",
+        "marketplace_integrators",
+        "review_operators"
+      ]
+    },
+    partner_value: [
+      "adapter authors can start from a public minimal example instead of reverse-engineering internal flows",
+      "review posture is inspectable through explicit readiness and action surfaces",
+      "default-selection trust is earned through promotion data, not hidden exceptions",
+      "xytara stays flexible without forcing partners into one vendor-specific runtime story"
+    ],
+    start_path: {
+      first_docs: [
+        "ADAPTER_START_HERE.md",
+        "ADAPTER_PROMOTION_START_HERE.md"
+      ],
+      first_commands: [
+        "npm run verify:adapters",
+        "node scripts/registry_cli.js review-bundle --file adapters/examples/minimal-third-party-execution.submission-bundle.json",
+        "node scripts/registry_cli.js promotion-workflow --integration partner.execution.minimal_echo",
+        "xytara-release --adapter-promotion --summary"
+      ],
+      first_examples: [
+        "adapters/examples/minimal-third-party-execution-adapter.manifest.json",
+        "adapters/examples/minimal-third-party-execution.submission-bundle.json"
+      ]
+    },
+    trust_path: {
+      maturity_path: [
+        "starter_example",
+        "staging_registered",
+        "review_ready",
+        "default_eligible",
+        "production_default_ready"
+      ],
+      key_questions: [
+        "what is valid to ship now?",
+        "what still blocks trust or default selection?",
+        "what evidence is still missing?",
+        "what action moves the integration forward next?"
+      ]
+    },
+    public_surfaces: {
+      adapter_pack: "/v1/adapter-pack/summary",
+      adapter_promotion: "/v1/adapter-promotion/summary",
+      promotion_readiness: "/v1/integrations/promotion-readiness",
+      promotion_workflow: "/v1/integrations/promotion-workflow",
+      promotion_actions: "/v1/integrations/promotion-actions",
+      release_center: "/v1/release-center/summary"
+    },
+    adoption_message: {
+      why_build_here: "partners get a machine-commerce spine with explicit review and promotion posture instead of opaque integration trust",
+      first_partner_type: "adapter_author",
+      first_success: "a partner can copy the minimal starter, validate it locally, review the submission bundle, and inspect the next promotion action without private coordination"
+    }
+  };
+}
+
+function summarizeAdapterPartnerPack() {
+  const pack = buildAdapterPartnerPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    audience_count: pack.positioning.intended_for.length,
+    value_count: pack.partner_value.length,
+    first_command_count: pack.start_path.first_commands.length,
+    maturity_step_count: pack.trust_path.maturity_path.length,
+    first_partner_type: pack.adoption_message.first_partner_type
+  };
+}
+
+module.exports = {
+  buildAdapterPartnerPack,
+  summarizeAdapterPartnerPack
+};

package/lib/adapter_promotion_pack.js

@@ -0,0 +1,89 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildAdapterPromotionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-adapter-promotion-pack",
+    positioning: {
+      line: "promotion-first adapter maturity for third-party integrations that need explicit review, certification, and default-selection trust",
+      intended_for: [
+        "adapter_authors",
+        "review_operators",
+        "integration_owners",
+        "ecosystem_partners"
+      ]
+    },
+    maturity_path: [
+      "starter_example",
+      "staging_registered",
+      "review_ready",
+      "default_eligible",
+      "production_default_ready"
+    ],
+    first_docs: [
+      "ADAPTER_PROMOTION_START_HERE.md",
+      "ADAPTER_START_HERE.md",
+      "adapters/ONBOARDING_POSTURE.md",
+      "adapters/THIRD_PARTY_SUBMISSION_PROCESS.md"
+    ],
+    first_commands: [
+      "node scripts/registry_cli.js review-bundle --file adapters/examples/minimal-third-party-execution.submission-bundle.json",
+      "node scripts/registry_cli.js promotion-readiness --integration partner.execution.minimal_echo",
+      "node scripts/registry_cli.js promotion-workflow --integration partner.execution.minimal_echo",
+      "node scripts/registry_cli.js promotion-action-set --integration partner.execution.minimal_echo",
+      "node scripts/registry_cli.js promotion-action-preview --integration partner.execution.minimal_echo --action complete_certification"
+    ],
+    canonical_examples: {
+      starter_bundle: "adapters/examples/minimal-third-party-execution.submission-bundle.json",
+      staged_protocol_bundle: "adapters/examples/example-third-party-registration.submission-bundle.json",
+      staged_identity_bundle: "adapters/examples/example-third-party-identity-registration.submission-bundle.json",
+      staged_settlement_bundle: "adapters/examples/example-third-party-settlement-registration.submission-bundle.json",
+      staged_integration_id: "partner.protocol.acme_mcp",
+      starter_integration_id: "partner.execution.minimal_echo"
+    },
+    public_surfaces: {
+      promotion_readiness_list: "/v1/integrations/promotion-readiness",
+      promotion_workflow_list: "/v1/integrations/promotion-workflow",
+      promotion_action_list: "/v1/integrations/promotion-actions",
+      promotion_readiness_detail: "/v1/integrations/:integration_id/promotion-readiness",
+      promotion_workflow_detail: "/v1/integrations/:integration_id/promotion-workflow",
+      promotion_action_detail: "/v1/integrations/:integration_id/promotion-actions",
+      promotion_action_preview: "/v1/integrations/promotion-actions/preview"
+    },
+    review_questions: [
+      "is the integration review-ready?",
+      "what blockers still prevent default eligibility?",
+      "what certification gaps remain?",
+      "what promotion action is valid now?"
+    ],
+    why_it_matters: [
+      "third-party integrations can advance through explicit review states instead of private judgment",
+      "default selection stays gated behind visible posture and certification data",
+      "review operators and adapter authors can inspect the same promotion model",
+      "adapter flexibility stays compatible with trust and production-default discipline"
+    ]
+  };
+}
+
+function summarizeAdapterPromotionPack() {
+  const pack = buildAdapterPromotionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    audience_count: pack.positioning.intended_for.length,
+    maturity_step_count: pack.maturity_path.length,
+    first_command_count: pack.first_commands.length,
+    review_question_count: pack.review_questions.length,
+    first_doc: pack.first_docs[0],
+    starter_integration_id: pack.canonical_examples.starter_integration_id
+  };
+}
+
+module.exports = {
+  buildAdapterPromotionPack,
+  summarizeAdapterPromotionPack
+};

package/lib/announcement_pack.js

@@ -0,0 +1,61 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildAnnouncementPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-announcement-pack",
+    public_quickstart: {
+      install: "npm install xytara",
+      first_cli: "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID",
+      first_release_view: "xytara-release --center --summary",
+      first_http: "/v1/release-center/summary"
+    },
+    release_candidate: {
+      checks: [
+        "install the package on a clean machine",
+        "run xytara-release --center --summary",
+        "run npm run verify:all",
+        "verify /v1/release-center/summary on the deployed service",
+        "verify /v1/outreach-proof/summary on the deployed service"
+      ]
+    },
+    publish_day: {
+      sequence: [
+        "publish the npm package",
+        "redeploy the service and docs surfaces",
+        "verify release-center, launch-narrative, and outreach-proof summaries live",
+        "run the first public proof path",
+        "share the announcement artifact with the target ecosystem audience"
+      ]
+    },
+    public_message: {
+      headline: "governed machine commerce with direct paid execution, reusable credits, and proof-aware followthrough",
+      who_should_try_first: [
+        "agent builders",
+        "tool and marketplace authors",
+        "repeat-use runtime operators"
+      ]
+    }
+  };
+}
+
+function summarizeAnnouncementPack() {
+  const pack = buildAnnouncementPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    rc_check_count: pack.release_candidate.checks.length,
+    publish_step_count: pack.publish_day.sequence.length,
+    first_cli: pack.public_quickstart.first_cli,
+    audience_count: pack.public_message.who_should_try_first.length
+  };
+}
+
+module.exports = {
+  buildAnnouncementPack,
+  summarizeAnnouncementPack
+};

package/lib/commerce_artifacts.js

@@ -222,6 +222,9 @@ function createCommandArtifacts(payload, quote, options) {
     network: bsvHints ? bsvHints.network : null,
     hints: bsvHints,
     txid: bsvPaymentReference && bsvPaymentReference.txid ? bsvPaymentReference.txid : null,
+    raw_tx: bsvPaymentReference && (bsvPaymentReference.raw_tx || bsvPaymentReference.rawTx)
+      ? (bsvPaymentReference.raw_tx || bsvPaymentReference.rawTx)
+      : null,
     status: deferredCompletion ? "pending_completion" : "recorded",
     recorded_at_iso: deferredCompletion ? null : completedAt.toISOString()
   };

package/lib/commerce_economics.js

@@ -638,6 +638,13 @@ function buildEconomicConsequenceHandoffBundle(state, body) {
     };
   }
   const meterProfileRef = normalizeString(payload.meter_profile_ref, `meter-profile.${usageMeter.pricing_band || "utility"}.v1`);
+  const paymentRef = normalizeString(payload.payment_ref, null);
+  const settlementRef = normalizeString(payload.settlement_ref, null);
+  const settlementTxid = normalizeString(payload.settlement_txid, null);
+  const settlementStatus = normalizeString(payload.settlement_status, null);
+  const settlementFinalityStatus = normalizeString(payload.settlement_finality_status, null);
+  const treasuryReceiptRef = normalizeString(payload.treasury_receipt_ref, null);
+  const proofRef = normalizeString(payload.proof_ref, null);
   const handoffBundle = {
     contract_version: "naxytra-economic-consequence-handoff-v1",
     source_system: "xytara",
@@ -647,6 +654,13 @@ function buildEconomicConsequenceHandoffBundle(state, body) {
     credit_spend_ref: creditSpend.credit_spend_id,
     usage_meter: usageMeter,
     credit_spend: creditSpend,
+    payment_ref: paymentRef,
+    settlement_ref: settlementRef,
+    settlement_txid: settlementTxid,
+    settlement_status: settlementStatus,
+    settlement_finality_status: settlementFinalityStatus,
+    treasury_receipt_ref: treasuryReceiptRef,
+    proof_ref: proofRef,
     handoff_surfaces: {
       proof_bridge_surface: "/v1/proof-center/bridge/economic-handoff",
       proof_conformance_surface: "/v1/proof-center/bridge/economic-conformance-pack"

package/lib/commerce_reports.js

@@ -13690,12 +13690,18 @@ function buildReconciliationReport(state, filters, listRecords) {
   };
 }
 
-function buildOperatorExportPack(state, filters, listRecords) {
+function buildOperatorExportPack(state, filters, listRecords, options = {}) {
   const report = buildReconciliationReport(state, filters, listRecords);
   const accountId = report.summary && report.summary.account_id ? report.summary.account_id : null;
   const transactions = Array.from(state.transactions.values()).map((item) => item.transaction);
   const receipts = Array.from(state.receipts.values()).map((item) => item.receipt);
   const paymentLedger = Array.isArray(state.paymentLedger) ? state.paymentLedger.slice(0, 20) : [];
+  const runtimeDurability = options.runtime_durability && typeof options.runtime_durability === "object"
+    ? options.runtime_durability
+    : null;
+  const nativeSettlementReadiness = options.native_settlement_readiness && typeof options.native_settlement_readiness === "object"
+    ? options.native_settlement_readiness
+    : null;
   return {
     ok: true,
     export_version: "commerce-operator-export-pack-v1",
@@ -13729,6 +13735,25 @@ function buildOperatorExportPack(state, filters, listRecords) {
         metering_summary_ref: report.summary && report.summary.linked_surfaces ? report.summary.linked_surfaces.metering_summary : null,
         usage_meters_ref: report.summary && report.summary.linked_surfaces ? report.summary.linked_surfaces.usage_meters : null
       },
+      runtime_center: {
+        snapshot_enabled: runtimeDurability ? runtimeDurability.enabled === true : false,
+        snapshot_exists: runtimeDurability ? runtimeDurability.snapshot_exists === true : false,
+        snapshot_updated_at_iso: runtimeDurability ? runtimeDurability.snapshot_updated_at_iso || null : null,
+        last_persisted_at_iso: runtimeDurability ? runtimeDurability.last_persisted_at_iso || null : null,
+        last_flush_succeeded: runtimeDurability ? runtimeDurability.last_flush_succeeded === true : false,
+        recovery_posture: runtimeDurability ? runtimeDurability.recovery_posture || null : null,
+        blockers: runtimeDurability ? runtimeDurability.blockers || [] : [],
+        inspect_ref: runtimeDurability ? runtimeDurability.inspect_ref || "/v1/runtime/durability" : "/v1/runtime/durability"
+      },
+      native_settlement_center: {
+        ready: nativeSettlementReadiness ? nativeSettlementReadiness.ready === true : false,
+        runtime_mode: nativeSettlementReadiness ? nativeSettlementReadiness.runtime_mode || null : null,
+        receiving_identity_kind: nativeSettlementReadiness ? nativeSettlementReadiness.receiving_identity_kind || null : null,
+        verification_mode: nativeSettlementReadiness ? nativeSettlementReadiness.payment_verification_mode || null : null,
+        blockers: nativeSettlementReadiness ? nativeSettlementReadiness.blockers || [] : [],
+        next_manual_inputs: nativeSettlementReadiness ? nativeSettlementReadiness.next_manual_inputs || [] : [],
+        readiness_ref: nativeSettlementReadiness ? nativeSettlementReadiness.readiness_ref || "/v1/settlement/bsv-teranode/readiness" : "/v1/settlement/bsv-teranode/readiness"
+      },
       coordination_center: {
         zone_count: report.coordination ? report.coordination.zone_count : 0,
         handoff_count: report.coordination ? report.coordination.handoff_count : 0,

package/lib/commerce_shell.js

@@ -132,6 +132,8 @@ function buildOperatorShellSummary(input) {
   const coordinationAdminView = body.coordination_admin_view || {};
   const hostedCheckoutOperatorSummary = body.hosted_checkout_operator_summary || {};
   const entitlementReplenishmentSummary = body.entitlement_replenishment_summary || {};
+  const runtimeDurability = body.runtime_durability || {};
+  const nativeSettlementReadiness = body.native_settlement_readiness || {};
 
   return {
     ok: true,
@@ -150,6 +152,8 @@ function buildOperatorShellSummary(input) {
       coordination_admin_view: "/v1/coordination-center/admin-view",
       hosted_checkout_purchase_intents: `/v1/checkout/purchase-intents?account_id=${encodeURIComponent(accountId)}`,
       hosted_checkout_runtime_bridge_dispatches: `/v1/runtime-bridge/dispatches?account_id=${encodeURIComponent(accountId)}`,
+      runtime_durability: "/v1/runtime/durability",
+      native_settlement_readiness: "/v1/settlement/bsv-teranode/readiness",
       proof_governance_dashboard: "/v1/proof-center/governance/dashboard",
       proof_bridge_admin_pack: "/v1/proof-center/bridge/admin-pack"
     },
@@ -166,7 +170,17 @@ function buildOperatorShellSummary(input) {
       hosted_checkout_execution_dispatched_count: Number(hostedCheckoutOperatorSummary.execution_dispatched_count || 0)
       ,
       low_balance_entitlement_count: Number(entitlementReplenishmentSummary.low_balance_count || 0),
-      depleted_entitlement_count: Number(entitlementReplenishmentSummary.depleted_count || 0)
+      depleted_entitlement_count: Number(entitlementReplenishmentSummary.depleted_count || 0),
+      runtime_snapshot_enabled: runtimeDurability.enabled === true,
+      runtime_snapshot_exists: runtimeDurability.snapshot_exists === true,
+      runtime_recovery_posture: runtimeDurability.recovery_posture || null,
+      native_settlement_runtime_mode: runtimeDurability.enabled === true || nativeSettlementReadiness.runtime_mode
+        ? nativeSettlementReadiness.runtime_mode || null
+        : null,
+      native_settlement_ready: nativeSettlementReadiness.ready === true,
+      native_settlement_blocker_count: Array.isArray(nativeSettlementReadiness.blockers)
+        ? nativeSettlementReadiness.blockers.length
+        : 0
     },
     linked_refs: {
       operations_dashboard_ref: buildShellRef("operator-shell.operations-dashboard", {
@@ -182,7 +196,9 @@ function buildOperatorShellSummary(input) {
       ,
       entitlement_replenishment_summary_ref: entitlementReplenishmentSummary.entitlement_count != null
         ? `/v1/economics/accounts/${encodeURIComponent(accountId)}/entitlements/replenishment-summary`
-        : null
+        : null,
+      runtime_durability_ref: runtimeDurability.inspect_ref || "/v1/runtime/durability",
+      native_settlement_readiness_ref: nativeSettlementReadiness.readiness_ref || "/v1/settlement/bsv-teranode/readiness"
     }
   };
 }

package/lib/ecosystem_entry.js

@@ -0,0 +1,64 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildEcosystemEntryPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-ecosystem-entry",
+    audiences: [
+      {
+        audience_ref: "agent_builder",
+        why_now: "needs a first paid machine capability path with governed execution and proof-aware followthrough",
+        first_path_ref: "scenario.direct_pay.trust_verify",
+        first_http_entrypoint: "/v1/release-pack/scenarios/summary",
+        first_cli_entrypoint: "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+      },
+      {
+        audience_ref: "marketplace_or_tool_author",
+        why_now: "needs a neutral default path for quoting, payment admission, execution, and operator inspection",
+        first_path_ref: "scenario.direct_pay.trust_verify",
+        first_http_entrypoint: "/v1/release-pack/launch/summary",
+        first_cli_entrypoint: "xytara-release --launch --summary"
+      },
+      {
+        audience_ref: "repeat_usage_operator",
+        why_now: "needs reusable account balance posture without redesigning the public execution surface",
+        first_path_ref: "scenario.credits_first.repeat_run",
+        first_http_entrypoint: "/v1/economics/accounts/:account_id/credit-balance",
+        first_cli_entrypoint: "xytara-release --scenarios --summary"
+      },
+      {
+        audience_ref: "proof_aware_runtime_team",
+        why_now: "needs a runtime result that can continue directly into proof review instead of ending as logs",
+        first_path_ref: "scenario.runtime_to_proof.followthrough",
+        first_http_entrypoint: "/v1/transaction-center/result-packages",
+        first_cli_entrypoint: "xytara-release --center --summary"
+      }
+    ],
+    public_lead_sequence: [
+      "identify the audience and first success path",
+      "show the one-line cli or one-http-entrypoint path",
+      "show the matching comparison and adoption summary",
+      "show the release center when credibility and breadth need one compact artifact"
+    ]
+  };
+}
+
+function summarizeEcosystemEntryPack() {
+  const pack = buildEcosystemEntryPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    audience_count: pack.audiences.length,
+    first_audience: pack.audiences[0] ? pack.audiences[0].audience_ref : null,
+    lead_step_count: pack.public_lead_sequence.length
+  };
+}
+
+module.exports = {
+  buildEcosystemEntryPack,
+  summarizeEcosystemEntryPack
+};