xytara 2.1.0 → 2.3.0

package/index.js

@@ -31,6 +31,10 @@ const {
   buildReleaseHistory,
   summarizeReleaseHistory
 } = require("./lib/release_history");
+const {
+  buildAdapterPack,
+  summarizeAdapterPack
+} = require("./lib/adapter_pack");
 const {
   buildPublishPlan,
   summarizePublishPlan
@@ -90,7 +94,7 @@ const {
 } = require("./integrations/registry");
 
 const COMMERCE_SDK_NAME = "xytara";
-const COMMERCE_SDK_VERSION = "2.1.0";
+const COMMERCE_SDK_VERSION = "2.2.0";
 const COMMERCE_API_VERSION = "v1";
 
 function createClient(options) {
@@ -153,6 +157,8 @@ module.exports = {
   summarizeReleaseCenter,
   buildReleaseHistory,
   summarizeReleaseHistory,
+  buildAdapterPack,
+  summarizeAdapterPack,
   buildPublishPlan,
   summarizePublishPlan,
   buildEcosystemEntryPack,

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/commerce_client.js

@@ -3776,6 +3776,30 @@ class CommerceClient {
     return result && result.data ? result.data : null;
   }
 
+  async getPartnerIntelligenceSummary() {
+    const result = await this.getJson("/v1/partner-intelligence/summary");
+    return result && result.data ? result.data : null;
+  }
+
+  async getPartnerIntelligencePack() {
+    const result = await this.getJson("/v1/partner-intelligence");
+    return result && result.data ? result.data : null;
+  }
+
+  async getOperatorIntelligenceSummary(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    const suffix = resolvedAccountId ? `?account_id=${encodeURIComponent(resolvedAccountId)}` : "";
+    const result = await this.getJson(`/v1/operator-intelligence/summary${suffix}`);
+    return result && result.data ? result.data : null;
+  }
+
+  async getOperatorIntelligencePack(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    const suffix = resolvedAccountId ? `?account_id=${encodeURIComponent(resolvedAccountId)}` : "";
+    const result = await this.getJson(`/v1/operator-intelligence${suffix}`);
+    return result && result.data ? result.data : null;
+  }
+
   async getCreditBalance(accountId) {
     const resolvedAccountId = String(accountId || this.accountId || "").trim();
     if (!resolvedAccountId) throw new Error("getCreditBalance requires accountId");
@@ -3783,6 +3807,20 @@ class CommerceClient {
     return result && result.data ? result.data : null;
   }
 
+  async getEconomicsIntelligenceSummary(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    if (!resolvedAccountId) throw new Error("getEconomicsIntelligenceSummary requires accountId");
+    const result = await this.getJson(`/v1/economics/accounts/${encodeURIComponent(resolvedAccountId)}/intelligence-summary`);
+    return result && result.data ? result.data : null;
+  }
+
+  async getTreasuryIntelligenceSummary(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    if (!resolvedAccountId) throw new Error("getTreasuryIntelligenceSummary requires accountId");
+    const result = await this.getJson(`/v1/economics/accounts/${encodeURIComponent(resolvedAccountId)}/treasury-intelligence-summary`);
+    return result && result.data ? result.data : null;
+  }
+
   async getUsageMeteringSummary(accountId) {
     const resolvedAccountId = String(accountId || this.accountId || "").trim();
     if (!resolvedAccountId) throw new Error("getUsageMeteringSummary requires accountId");