xytara 3.1.16 → 3.2.0

package/lib/adapter_pack.js

@@ -1,118 +0,0 @@
-"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

@@ -1,89 +0,0 @@
-"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

@@ -1,89 +0,0 @@
-"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/adapter_protocol_truth_contract.js

@@ -1,229 +0,0 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const { summarizeProtocolLanePack } = require("./protocol_lane_contract");
-const { summarizeMcpLanePack } = require("./mcp_lane_contract");
-const { summarizeA2ALanePack } = require("./a2a_lane_contract");
-const { summarizeA2CLanePack } = require("./a2c_lane_contract");
-const { summarizeAdapterDepthPack } = require("./adapter_depth_contract");
-const { summarizeProviderLanePack } = require("./provider_lane_contract");
-const { summarizeIntegrationClasses, summarizeIntegrationProtocols, summarizeIntegrations } = require("../integrations/registry");
-
-function uniqueSorted(values) {
-  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
-}
-
-function buildFrontProfile(entry) {
-  return {
-    profile_id: entry.profile_id,
-    profile_kind: "protocol_or_adapter_front",
-    profile_label: entry.profile_label,
-    actor_fit: uniqueSorted(entry.actor_fit),
-    launch_role: entry.launch_role,
-    first_party_callable: Boolean(entry.first_party_callable),
-    launch_default: Boolean(entry.launch_default),
-    provider_live_dependency: entry.provider_live_dependency,
-    claim_status: entry.claim_status,
-    linked_surfaces: entry.linked_surfaces,
-    summary: entry.summary,
-    claim_boundary: entry.claim_boundary
-  };
-}
-
-function buildAdapterProtocolTruthPack() {
-  const protocolLaneSummary = summarizeProtocolLanePack();
-  const mcpSummary = summarizeMcpLanePack();
-  const a2aSummary = summarizeA2ALanePack();
-  const a2cSummary = summarizeA2CLanePack();
-  const adapterDepthSummary = summarizeAdapterDepthPack();
-  const providerLaneSummary = summarizeProviderLanePack();
-  const integrationSummary = summarizeIntegrations();
-  const integrationProtocolSummary = summarizeIntegrationProtocols();
-  const integrationClassSummary = summarizeIntegrationClasses();
-
-  const frontProfiles = [
-    buildFrontProfile({
-      profile_id: "mcp_primary_tool_front",
-      profile_label: "MCP primary tool front",
-      actor_fit: ["agent", "machine", "developer", "human", "enterprise"],
-      launch_role: "primary_default_protocol_front",
-      first_party_callable: true,
-      launch_default: true,
-      provider_live_dependency: "provider_live_depth_applies_only_to_listed_tool_bindings_in_adapter_depth_pack",
-      claim_status: "bounded_live_first_party_default",
-      linked_surfaces: {
-        lane_ref: "/v1/mcp",
-        invoke_ref: "/v1/mcp/tools/invoke",
-        paid_invoke_ref: "/x402/mcp/tools/invoke",
-        adapter_depth_ref: "/v1/adapter-depth",
-        providers_ref: "/v1/providers"
-      },
-      summary: mcpSummary,
-      claim_boundary: "claim_mcp_as_the_primary_first_party_tool_front_without_claiming_unbounded_provider_control_plane_ownership_or_unlisted_tool_depth"
-    }),
-    buildFrontProfile({
-      profile_id: "a2a_negotiation_front",
-      profile_label: "A2A negotiation and settlement front",
-      actor_fit: ["agent", "machine", "enterprise"],
-      launch_role: "first_party_supported_protocol_front",
-      first_party_callable: true,
-      launch_default: false,
-      provider_live_dependency: "no_external_provider_live_depth_required_for_first_party_a2a_claim",
-      claim_status: "bounded_live_first_party_supported",
-      linked_surfaces: {
-        lane_ref: "/v1/a2a",
-        negotiate_ref: "/v1/a2a/negotiate",
-        commit_ref: "/v1/a2a/commit",
-        flow_ref: "/v1/a2a/flows/settlement"
-      },
-      summary: a2aSummary,
-      claim_boundary: "claim_a2a_only_for_the_first_party_negotiation_commit_and_settlement_surfaces_listed_here_not_as_generic_unbounded_agent_network_coverage"
-    }),
-    buildFrontProfile({
-      profile_id: "a2c_tooling_front",
-      profile_label: "A2C tooling and session front",
-      actor_fit: ["agent", "human", "machine", "enterprise"],
-      launch_role: "first_party_supported_protocol_front",
-      first_party_callable: true,
-      launch_default: false,
-      provider_live_dependency: "mcp_backed_tool_depth_follows_listed_adapter_depth_and_provider_gates",
-      claim_status: "bounded_live_first_party_supported",
-      linked_surfaces: {
-        lane_ref: "/v1/a2c",
-        session_open_ref: "/v1/a2c/sessions/open",
-        pack_preview_ref: "/v1/a2c/packs/preview",
-        tooling_flow_ref: "/v1/a2c/flows/tooling"
-      },
-      summary: a2cSummary,
-      claim_boundary: "claim_a2c_only_for_the_first_party_session_preview_and_tooling_surfaces_listed_here_not_as_unbounded_client_messaging_platform_coverage"
-    }),
-    buildFrontProfile({
-      profile_id: "built_in_supported_bridge_protocols",
-      profile_label: "built-in supported bridge protocols",
-      actor_fit: ["machine", "enterprise", "operator", "agent"],
-      launch_role: "built_in_supported_nondefault_breadth",
-      first_party_callable: true,
-      launch_default: false,
-      provider_live_dependency: "integration_registry_and_protocol_lane_summary_define_current_supported_breadth",
-      claim_status: "built_in_supported_but_nondefault",
-      linked_surfaces: {
-        protocols_ref: "/v1/protocols",
-        event_systems_ref: "/v1/event-systems",
-        integration_protocols_ref: "/v1/integrations/protocols",
-        integration_matrix_ref: "/v1/integration-matrix"
-      },
-      summary: {
-        product: packageJson.name,
-        category: "machine-commerce-built-in-supported-bridge-protocols-summary",
-        summary_version: "xytara-built-in-supported-bridge-protocols-summary-v1",
-        protocol_ids: ["acp", "grpc", "mqtt", "kafka", "nats", "ros2", "webhook_event_bus"],
-        protocol_count: 7
-      },
-      claim_boundary: "claim_only_the_named_built_in_supported_bridge_protocols_as_supported_interop_surfaces_not_as_first_party_default_entry_lanes"
-    }),
-    buildFrontProfile({
-      profile_id: "third_party_staging_fronts",
-      profile_label: "third-party staging protocol fronts",
-      actor_fit: ["partner", "adapter_author", "enterprise", "operator"],
-      launch_role: "discoverable_partner_extension_surface",
-      first_party_callable: false,
-      launch_default: false,
-      provider_live_dependency: "third_party_staging_fronts_require_registry_selection_and_must_not_be_implicitly_claimed_as_defaults",
-      claim_status: "staging_registered_not_default",
-      linked_surfaces: {
-        integrations_ref: "/v1/integrations",
-        adapter_pack_ref: "/v1/adapter-pack",
-        adapter_promotion_ref: "/v1/adapter-promotion",
-        adapter_partners_ref: "/v1/adapter-partners"
-      },
-      summary: {
-        product: packageJson.name,
-        category: "machine-commerce-third-party-staging-fronts-summary",
-        summary_version: "xytara-third-party-staging-fronts-summary-v1",
-        staging_protocol_examples: ["partner.protocol.acme_mcp"],
-        staging_registered_count: (integrationSummary.integrations || []).filter((entry) => entry.registration_state === "staging_registered").length
-      },
-      claim_boundary: "claim_third_party_fronts_only_as_discoverable_staging_or_reviewable_partner_surfaces_until_their_registry_and_promotion_state_supports_stronger_claims"
-    })
-  ];
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-adapter-protocol-truth-model",
-    pack_version: "xytara-adapter-protocol-truth-model-v1",
-    posture: "first_party_protocol_defaults_plus_bounded_adapter_breadth",
-    model_state: "frozen_for_3_0_0_closeout",
-    doctrine: "protocol_and_adapter_breadth_must_improve_fit_without_blurring_default_entry_lanes_unlisted_provider_depth_or_staging_partner_extensions_into_launch_defaults",
-    core_claim: "xytara has first-party protocol entry fronts and adapter-extensible breadth, but the public claim must remain bounded to named default lanes, listed built-in supported surfaces, and explicit staging boundaries",
-    defaults: {
-      primary_default_protocol_front: "mcp_primary_tool_front",
-      first_party_supported_protocol_fronts: ["a2a_negotiation_front", "a2c_tooling_front"],
-      adapter_depth_state: adapterDepthSummary.adapter_depth_state,
-      provider_breadth_state: providerLaneSummary.breadth_state
-    },
-    front_profile_count: frontProfiles.length,
-    first_party_callable_front_count: frontProfiles.filter((entry) => entry.first_party_callable).length,
-    launch_default_front_count: frontProfiles.filter((entry) => entry.launch_default).length,
-    built_in_supported_protocol_count: 7,
-    staging_registered_integration_count: (integrationSummary.integrations || []).filter((entry) => entry.registration_state === "staging_registered").length,
-    front_profiles: frontProfiles,
-    operator_rules: [
-      "only_claim_provider_live_or_tool_live_depth_for_bindings_listed_in_adapter_depth_and_provider_lane_surfaces",
-      "do_not_promote_staging_partner_fronts_into_launch_defaults",
-      "keep_bridge_and_event_protocols_subordinate_to_the_default_runtime_and_payment_spine",
-      "keep_first_party_default_claims_separate_from_adapter_ready_or_partner_extension_claims"
-    ],
-    linked_summaries: {
-      protocol_lane_summary: protocolLaneSummary,
-      adapter_depth_summary: adapterDepthSummary,
-      provider_lane_summary: providerLaneSummary,
-      integration_summary: integrationSummary,
-      integration_protocol_summary: integrationProtocolSummary,
-      integration_class_summary: integrationClassSummary
-    },
-    linked_surfaces: {
-      protocols_ref: "/v1/protocols",
-      mcp_ref: "/v1/mcp",
-      a2a_ref: "/v1/a2a",
-      a2c_ref: "/v1/a2c",
-      adapter_depth_ref: "/v1/adapter-depth",
-      providers_ref: "/v1/providers",
-      integrations_ref: "/v1/integrations",
-      adapter_pack_ref: "/v1/adapter-pack",
-      adapter_promotion_ref: "/v1/adapter-promotion",
-      adapter_partners_ref: "/v1/adapter-partners",
-      integration_matrix_ref: "/v1/integration-matrix"
-    },
-    claim_boundary: "claim_only_the_named_first_party_default_and_supported_protocol_fronts_the_listed_built_in_supported_bridge_protocols_and_explicit_staging_partner_surfaces_without_implying_unbounded_protocol_or_adapter_coverage"
-  };
-}
-
-function summarizeAdapterProtocolTruthPack() {
-  const pack = buildAdapterProtocolTruthPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    summary_version: "xytara-adapter-protocol-truth-model-summary-v1",
-    pack_version: pack.pack_version,
-    model_state: pack.model_state,
-    front_profile_count: pack.front_profile_count,
-    first_party_callable_front_count: pack.first_party_callable_front_count,
-    launch_default_front_count: pack.launch_default_front_count,
-    built_in_supported_protocol_count: pack.built_in_supported_protocol_count,
-    staging_registered_integration_count: pack.staging_registered_integration_count,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-function getAdapterProtocolTruthProfileDetail(profileId) {
-  const normalized = String(profileId || "").trim().toLowerCase();
-  return (buildAdapterProtocolTruthPack().front_profiles || []).find((entry) => entry.profile_id === normalized) || null;
-}
-
-module.exports = {
-  buildAdapterProtocolTruthPack,
-  summarizeAdapterProtocolTruthPack,
-  getAdapterProtocolTruthProfileDetail
-};