xytara 3.1.0 → 3.1.2

package/integrations/registry.js

@@ -1,2261 +1,2261 @@
-"use strict";
-
-const executionExampleManifest = require("../adapters/examples/example-execution-adapter.manifest.json");
-const settlementExampleManifest = require("../adapters/examples/example-settlement-adapter.manifest.json");
-const exampleThirdPartyRegistrationRecord = require("../adapters/examples/example-third-party-registration.record.json");
-const exampleThirdPartyIdentityRegistrationRecord = require("../adapters/examples/example-third-party-identity-registration.record.json");
-const exampleThirdPartySettlementRegistrationRecord = require("../adapters/examples/example-third-party-settlement-registration.record.json");
-const { catalog } = require("../fixtures/catalog");
-
-function clone(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-
-function sortStrings(values) {
-  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
-}
-
-function collectTaskRefsByAdapter(adapterName) {
-  return (Array.isArray(catalog.tasks) ? catalog.tasks : [])
-    .filter((task) => Array.isArray(task.adapters) && task.adapters.includes(adapterName))
-    .map((task) => task.public_task_ref);
-}
-
-function collectWorkflowRefsByTaskRefs(taskRefs) {
-  const allowed = new Set(Array.isArray(taskRefs) ? taskRefs : []);
-  return (Array.isArray(catalog.workflows) ? catalog.workflows : [])
-    .filter((workflow) => Array.isArray(workflow.task_refs) && workflow.task_refs.some((taskRef) => allowed.has(taskRef)))
-    .map((workflow) => workflow.workflow_ref);
-}
-
-function createBuiltinBreadthIntegration({
-  integration_id,
-  display_name,
-  description,
-  adapter_class,
-  capabilities = [],
-  protocols = [],
-  settlement_modes = [],
-  execution_backends = [],
-  adapter_lanes = [],
-  task_refs = [],
-  workflow_refs = [],
-  required_secrets = [],
-  required_permissions = [],
-  supported_profiles = ["default"],
-  pricing_basis = "per_task",
-  latency_class = "mixed",
-  proof_mode = "adjacent_reference_only"
-}) {
-  return {
-    integration_id,
-    display_name,
-    description,
-    adapter_class,
-    adapter_version: "1.26.0",
-    interface_version: "commerce-adapter-interface/v1",
-    bundled: true,
-    source: "builtin",
-    status: "available",
-    certification_state: "certified",
-    certification_scope: ["builtin_registry", "service_contract", "sdk_contract"],
-    integration_maturity: "production_supported",
-    selection_priority: 250,
-    capabilities: sortStrings(capabilities),
-    protocols: sortStrings(protocols),
-    settlement_modes: sortStrings(settlement_modes),
-    execution_backends: sortStrings(execution_backends),
-    adapter_lanes: sortStrings(adapter_lanes),
-    task_refs: sortStrings(task_refs),
-    workflow_refs: sortStrings(workflow_refs),
-    required_secrets: sortStrings(required_secrets),
-    required_permissions: sortStrings(required_permissions),
-    supported_profiles: sortStrings(supported_profiles),
-    supported_regions: ["global"],
-    pricing_basis,
-    latency_class,
-    proof_contract: {
-      emits_proof_compatible_facts: true,
-      proof_mode
-    },
-    health_contract: {
-      check_kind: "internal",
-      supports_readiness: true
-    },
-    idempotency_contract: {
-      strategy: "quote_bound_selection",
-      scope: "integration_selection"
-    },
-    failure_contract: {
-      categories: ["invalid_input", "timeout", "upstream_unavailable"],
-      retryable_categories: ["timeout", "upstream_unavailable"]
-    },
-    compatibility: {
-      node: ">=18",
-      commerce_contract: "xytara/v1"
-    },
-    operational_readiness: {
-      supports_default_selection: false,
-      supports_forced_selection: true,
-      lifecycle: "managed_builtin",
-      health_source: "internal"
-    },
-    selection_hints: {
-      default_for_task_refs: [],
-      default_for_protocols: [],
-      default_for_settlement_modes: []
-    }
-  };
-}
-
-function mapManifestToIntegration(manifest, extras = {}) {
-  const taskRefs = sortStrings(extras.task_refs);
-  return {
-    integration_id: manifest.adapter_id,
-    display_name: manifest.display_name,
-    description: manifest.description,
-    adapter_class: manifest.adapter_class,
-    adapter_version: manifest.adapter_version,
-    interface_version: manifest.interface_version,
-    bundled: extras.bundled !== false,
-    source: extras.source || "example",
-    status: extras.status || "available",
-    certification_state: extras.certification_state || "reference_example",
-    certification_scope: sortStrings(extras.certification_scope || ["contract_shape"]),
-    integration_maturity: extras.integration_maturity || "reference_example",
-    selection_priority: Number.isFinite(Number(extras.selection_priority)) ? Number(extras.selection_priority) : 900,
-    capabilities: sortStrings(manifest.capabilities),
-    protocols: sortStrings(extras.protocols),
-    settlement_modes: sortStrings(manifest.supported_settlement_modes),
-    execution_backends: sortStrings(extras.execution_backends),
-    adapter_lanes: sortStrings(extras.adapter_lanes),
-    task_refs: taskRefs,
-    workflow_refs: sortStrings(extras.workflow_refs || collectWorkflowRefsByTaskRefs(taskRefs)),
-    required_secrets: sortStrings(manifest.required_secrets),
-    required_permissions: sortStrings(manifest.required_permissions),
-    supported_profiles: sortStrings(manifest.supported_profiles),
-    supported_regions: sortStrings(manifest.supported_regions),
-    pricing_basis: manifest.pricing_basis || null,
-    latency_class: manifest.latency_class || null,
-    proof_contract: manifest.proof_contract || null,
-    health_contract: manifest.health_contract || null,
-    idempotency_contract: manifest.idempotency_contract || null,
-    failure_contract: manifest.failure_contract || null,
-    compatibility: manifest.compatibility || {},
-    operational_readiness: {
-      supports_default_selection: extras.supports_default_selection === true,
-      supports_forced_selection: extras.supports_forced_selection !== false,
-      lifecycle: extras.lifecycle || "reference",
-      health_source: extras.health_source || "self_reported"
-    },
-    selection_hints: {
-      default_for_task_refs: sortStrings(extras.default_for_task_refs || taskRefs),
-      default_for_protocols: sortStrings(extras.default_for_protocols || extras.protocols),
-      default_for_settlement_modes: sortStrings(extras.default_for_settlement_modes || manifest.supported_settlement_modes)
-    }
-  };
-}
-
-function buildIntegrationRegistrationView(integration, registrationRecord) {
-  const integrationEntry = integration || {};
-  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : null;
-  const selectionPriority = record && Number.isFinite(Number(record.selection_priority))
-    ? Number(record.selection_priority)
-    : integrationEntry.selection_priority;
-  return {
-    registration_state: record ? record.registration_state : "unregistered",
-    bundled: record ? record.bundled : integrationEntry.bundled === true,
-    default_selection_enabled: record
-      ? record.default_selection_enabled === true
-      : !!(
-          integrationEntry.operational_readiness &&
-          integrationEntry.operational_readiness.supports_default_selection
-        ),
-    requires_explicit_selection: record
-      ? record.requires_explicit_selection === true
-      : !(
-          integrationEntry.operational_readiness &&
-          integrationEntry.operational_readiness.supports_default_selection
-        ),
-    selection_priority: selectionPriority,
-    registered_at: record ? record.registered_at : null,
-    registered_by: record ? record.registered_by || null : null,
-    verified_with: sortStrings(record && record.verified_with),
-    notes: record ? record.notes || null : null
-  };
-}
-
-function buildIntegrationView(integration, registrationRecord) {
-  const entry = clone(integration);
-  entry.registration = buildIntegrationRegistrationView(entry, registrationRecord);
-  return entry;
-}
-
-function createRegisteredIntegrationFromManifest(manifest, registrationRecord, extras = {}) {
-  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : {};
-  const integration = mapManifestToIntegration(manifest, {
-    ...extras,
-    bundled: Object.prototype.hasOwnProperty.call(record, "bundled")
-      ? record.bundled
-      : extras.bundled,
-    certification_state: record.certification_state || extras.certification_state,
-    certification_scope: record.certification_scope || extras.certification_scope,
-    integration_maturity: record.integration_maturity || extras.integration_maturity,
-    selection_priority: Object.prototype.hasOwnProperty.call(record, "selection_priority")
-      ? record.selection_priority
-      : extras.selection_priority,
-    supports_default_selection: Object.prototype.hasOwnProperty.call(record, "default_selection_enabled")
-      ? record.default_selection_enabled
-      : extras.supports_default_selection,
-    lifecycle: record.registration_state || extras.lifecycle,
-    default_for_task_refs: record.default_selection_enabled === true
-      ? extras.default_for_task_refs
-      : [],
-    default_for_protocols: record.default_selection_enabled === true
-      ? extras.default_for_protocols
-      : [],
-    default_for_settlement_modes: record.default_selection_enabled === true
-      ? extras.default_for_settlement_modes
-      : []
-  });
-  return buildIntegrationView(integration, record);
-}
-
-function validateIntegrationRegistration(manifest, registrationRecord) {
-  const errors = [];
-  const manifestEntry = manifest && typeof manifest === "object" ? manifest : {};
-  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : {};
-
-  if (!manifestEntry.adapter_id) {
-    errors.push("manifest.adapter_id is required");
-  }
-  if (!record.integration_id) {
-    errors.push("registration_record.integration_id is required");
-  }
-  if (!record.adapter_id) {
-    errors.push("registration_record.adapter_id is required");
-  }
-  if (!record.adapter_class) {
-    errors.push("registration_record.adapter_class is required");
-  }
-  if (manifestEntry.adapter_id && record.adapter_id && manifestEntry.adapter_id !== record.adapter_id) {
-    errors.push("manifest.adapter_id must match registration_record.adapter_id");
-  }
-  if (manifestEntry.adapter_id && record.integration_id && manifestEntry.adapter_id !== record.integration_id) {
-    errors.push("manifest.adapter_id must match registration_record.integration_id");
-  }
-  if (manifestEntry.adapter_class && record.adapter_class && manifestEntry.adapter_class !== record.adapter_class) {
-    errors.push("manifest.adapter_class must match registration_record.adapter_class");
-  }
-
-  return {
-    ok: errors.length === 0,
-    errors
-  };
-}
-
-function validateIntegrationCertificationPack(certificationPack) {
-  const pack = certificationPack && typeof certificationPack === "object" ? certificationPack : {};
-  const errors = [];
-  if (!pack.integration_id) errors.push("certification_pack.integration_id is required");
-  if (!pack.adapter_id) errors.push("certification_pack.adapter_id is required");
-  if (!pack.adapter_class) errors.push("certification_pack.adapter_class is required");
-  if (!pack.certification_state) errors.push("certification_pack.certification_state is required");
-  if (!Array.isArray(pack.certification_scope) || pack.certification_scope.length < 1) {
-    errors.push("certification_pack.certification_scope must contain at least one entry");
-  }
-  if (!Array.isArray(pack.verified_with) || pack.verified_with.length < 1) {
-    errors.push("certification_pack.verified_with must contain at least one entry");
-  }
-  if (!pack.submitted_at) errors.push("certification_pack.submitted_at is required");
-  return {
-    ok: errors.length === 0,
-    errors
-  };
-}
-
-function validateIntegrationSubmission(manifest, registrationRecord, certificationPack) {
-  const registrationValidation = validateIntegrationRegistration(manifest, registrationRecord);
-  const certificationValidation = validateIntegrationCertificationPack(certificationPack);
-  const errors = registrationValidation.errors.concat(certificationValidation.errors);
-  const manifestEntry = manifest && typeof manifest === "object" ? manifest : {};
-  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : {};
-  const pack = certificationPack && typeof certificationPack === "object" ? certificationPack : {};
-
-  if (manifestEntry.adapter_id && pack.adapter_id && manifestEntry.adapter_id !== pack.adapter_id) {
-    errors.push("manifest.adapter_id must match certification_pack.adapter_id");
-  }
-  if (record.integration_id && pack.integration_id && record.integration_id !== pack.integration_id) {
-    errors.push("registration_record.integration_id must match certification_pack.integration_id");
-  }
-  if (record.adapter_class && pack.adapter_class && record.adapter_class !== pack.adapter_class) {
-    errors.push("registration_record.adapter_class must match certification_pack.adapter_class");
-  }
-  if (record.certification_state && pack.certification_state && record.certification_state !== pack.certification_state) {
-    errors.push("registration_record.certification_state must match certification_pack.certification_state");
-  }
-
-  return {
-    ok: errors.length === 0,
-    errors
-  };
-}
-
-function importRegisteredIntegration(manifest, registrationRecord, extras = {}) {
-  const validation = validateIntegrationRegistration(manifest, registrationRecord);
-  if (!validation.ok) {
-    const error = new Error(`invalid integration registration:\n${validation.errors.join("\n")}`);
-    error.code = "invalid_integration_registration";
-    error.validation = validation;
-    throw error;
-  }
-  return createRegisteredIntegrationFromManifest(manifest, registrationRecord, extras);
-}
-
-function createIntegrationRegistrySnapshot(integrations, filters = {}) {
-  const rows = Array.isArray(integrations) ? integrations.map(clone) : [];
-  return {
-    snapshot_version: "xytara/integration-registry-snapshot/v1",
-    generated_at: new Date().toISOString(),
-    integration_count: rows.length,
-    filters: clone(filters || {}),
-    integrations: rows
-  };
-}
-
-function exportIntegrationRegistrySnapshot(filters = {}) {
-  return createIntegrationRegistrySnapshot(listIntegrations(filters), filters);
-}
-
-function validateIntegrationRegistrySnapshot(snapshot) {
-  const entry = snapshot && typeof snapshot === "object" ? snapshot : {};
-  const errors = [];
-  if (!entry.snapshot_version) errors.push("snapshot.snapshot_version is required");
-  if (!entry.generated_at) errors.push("snapshot.generated_at is required");
-  if (!Number.isInteger(entry.integration_count) || entry.integration_count < 0) {
-    errors.push("snapshot.integration_count must be a non-negative integer");
-  }
-  if (!Array.isArray(entry.integrations)) {
-    errors.push("snapshot.integrations must be an array");
-  } else if (entry.integration_count !== entry.integrations.length) {
-    errors.push("snapshot.integration_count must match snapshot.integrations.length");
-  }
-  return {
-    ok: errors.length === 0,
-    errors
-  };
-}
-
-function validateIntegrationSubmissionBundle(bundle) {
-  const entry = bundle && typeof bundle === "object" ? bundle : {};
-  const errors = [];
-  if (!entry.bundle_version) {
-    errors.push("submission_bundle.bundle_version is required");
-  }
-  if (!entry.manifest || typeof entry.manifest !== "object") {
-    errors.push("submission_bundle.manifest is required");
-  }
-  if (!entry.registration_record || typeof entry.registration_record !== "object") {
-    errors.push("submission_bundle.registration_record is required");
-  }
-  if (!entry.certification_pack || typeof entry.certification_pack !== "object") {
-    errors.push("submission_bundle.certification_pack is required");
-  }
-  const submissionValidation = validateIntegrationSubmission(
-    entry.manifest,
-    entry.registration_record,
-    entry.certification_pack
-  );
-  return {
-    ok: errors.length === 0 && submissionValidation.ok,
-    errors: errors.concat(submissionValidation.errors)
-  };
-}
-
-function createIntegrationSubmissionBundle(bundleInput = {}, extras = {}) {
-  const manifest = clone(bundleInput.manifest || {});
-  const registrationRecord = clone(bundleInput.registration_record || {});
-  const certificationPack = clone(bundleInput.certification_pack || {});
-  const importedIntegration = importRegisteredIntegration(manifest, registrationRecord, extras);
-  const snapshotEntry = clone(bundleInput.snapshot_entry || importedIntegration);
-  return {
-    bundle_version: "xytara/integration-submission-bundle/v1",
-    manifest,
-    registration_record: registrationRecord,
-    certification_pack: certificationPack,
-    snapshot_entry: snapshotEntry,
-    notes: typeof bundleInput.notes === "string" ? bundleInput.notes : null
-  };
-}
-
-function importIntegrationSubmissionBundle(bundleInput = {}, extras = {}) {
-  const bundle = createIntegrationSubmissionBundle(bundleInput, extras);
-  const validation = validateIntegrationSubmissionBundle(bundle);
-  if (!validation.ok) {
-    const error = new Error(`invalid integration submission bundle:\n${validation.errors.join("\n")}`);
-    error.code = "invalid_integration_submission_bundle";
-    error.validation = validation;
-    throw error;
-  }
-  return bundle;
-}
-
-function createIntegrationRegistrySnapshotFromBundles(bundles, filters = {}, bundleExtras = {}) {
-  const bundleList = Array.isArray(bundles) ? bundles : [];
-  const integrations = bundleList.map((bundle) => importIntegrationSubmissionBundle(bundle, bundleExtras).snapshot_entry);
-  return createIntegrationRegistrySnapshot(integrations, {
-    ...clone(filters || {}),
-    snapshot_source: "submission_bundle"
-  });
-}
-
-function exportIntegrationSubmissionBundles(filters = {}) {
-  return listIntegrations(filters)
-    .filter((integration) => integration.source === "third_party_example")
-    .map((integration) => {
-      const registrationRecord = clone(INTEGRATION_REGISTRATION_RECORDS[integration.integration_id] || {});
-      const certificationPack = {
-        integration_id: integration.integration_id,
-        adapter_id: integration.integration_id,
-        adapter_class: integration.adapter_class,
-        certification_state: integration.certification_state,
-        certification_scope: clone(integration.certification_scope || []),
-        verified_with: clone(integration.registration.verified_with || []),
-        submitted_at: integration.registration.registered_at || new Date().toISOString(),
-        submitted_by: integration.registration.registered_by || "unknown",
-        last_verified_contract_version: "xytara/v1",
-        notes: integration.registration.notes || null
-      };
-      const manifest = {
-        adapter_id: integration.integration_id,
-        adapter_class: integration.adapter_class,
-        adapter_version: integration.adapter_version,
-        interface_version: integration.interface_version,
-        display_name: integration.display_name,
-        description: integration.description,
-        capabilities: clone(integration.capabilities || []),
-        required_secrets: clone(integration.required_secrets || []),
-        required_permissions: clone(integration.required_permissions || []),
-        supported_profiles: clone(integration.supported_profiles || []),
-        supported_regions: clone(integration.supported_regions || []),
-        supported_settlement_modes: clone(integration.settlement_modes || []),
-        pricing_basis: integration.pricing_basis,
-        latency_class: integration.latency_class,
-        registration_contract: {
-          integration_id: integration.integration_id,
-          integration_maturity: integration.integration_maturity,
-          bundled: integration.registration.bundled,
-          default_selection_enabled: integration.registration.default_selection_enabled,
-          requires_explicit_selection: integration.registration.requires_explicit_selection
-        },
-        certification_contract: {
-          certification_state: integration.certification_state,
-          certification_scope: clone(integration.certification_scope || []),
-          verified_with: clone(integration.registration.verified_with || []),
-          last_verified_contract_version: "xytara/v1"
-        },
-        compatibility: clone(integration.compatibility || {}),
-        health_contract: clone(integration.health_contract || {}),
-        idempotency_contract: clone(integration.idempotency_contract || {}),
-        failure_contract: clone(integration.failure_contract || {}),
-        proof_contract: clone(integration.proof_contract || {})
-      };
-      return createIntegrationSubmissionBundle({
-        manifest,
-        registration_record: registrationRecord,
-        certification_pack: certificationPack,
-        snapshot_entry: integration,
-        notes: integration.registration.notes || null
-      }, {
-        source: integration.source,
-        protocols: clone(integration.protocols || []),
-        execution_backends: clone(integration.execution_backends || []),
-        adapter_lanes: clone(integration.adapter_lanes || []),
-        task_refs: clone(integration.task_refs || []),
-        workflow_refs: clone(integration.workflow_refs || [])
-      });
-    });
-}
-
-function createIntegrationSubmissionBundleSet(bundles, filters = {}, notes = null) {
-  const bundleList = Array.isArray(bundles) ? bundles.map(clone) : [];
-  return {
-    bundle_set_version: "xytara/integration-submission-bundle-set/v1",
-    generated_at: new Date().toISOString(),
-    bundle_count: bundleList.length,
-    filters: clone(filters || {}),
-    bundles: bundleList,
-    notes: typeof notes === "string" ? notes : null
-  };
-}
-
-function validateIntegrationSubmissionBundleSet(bundleSet) {
-  const entry = bundleSet && typeof bundleSet === "object" ? bundleSet : {};
-  const errors = [];
-  if (!entry.bundle_set_version) errors.push("bundle_set.bundle_set_version is required");
-  if (!entry.generated_at) errors.push("bundle_set.generated_at is required");
-  if (!Number.isInteger(entry.bundle_count) || entry.bundle_count < 0) {
-    errors.push("bundle_set.bundle_count must be a non-negative integer");
-  }
-  if (!Array.isArray(entry.bundles)) {
-    errors.push("bundle_set.bundles must be an array");
-  } else if (entry.bundle_count !== entry.bundles.length) {
-    errors.push("bundle_set.bundle_count must match bundle_set.bundles.length");
-  } else {
-    entry.bundles.forEach((bundle, index) => {
-      const validation = validateIntegrationSubmissionBundle(bundle);
-      if (!validation.ok) {
-        validation.errors.forEach((error) => {
-          errors.push(`bundle_set.bundles[${index}]: ${error}`);
-        });
-      }
-    });
-  }
-  return {
-    ok: errors.length === 0,
-    errors
-  };
-}
-
-function exportIntegrationSubmissionBundleSet(filters = {}, notes = null) {
-  return createIntegrationSubmissionBundleSet(
-    exportIntegrationSubmissionBundles(filters),
-    filters,
-    notes
-  );
-}
-
-function summarizeCounts(values, fieldName) {
-  return sortStrings(values).map((value) => ({
-    [fieldName]: value,
-    count: values.filter((entry) => entry === value).length
-  }));
-}
-
-function summarizeStructuredCounts(entries, fields = []) {
-  const rows = Array.isArray(entries) ? entries.filter((entry) => entry && typeof entry === "object") : [];
-  const normalizedFields = Array.isArray(fields) ? fields.filter(Boolean) : [];
-  const seen = new Map();
-
-  rows.forEach((entry) => {
-    const key = normalizedFields.map((field) => String(entry[field] || "")).join("::");
-    if (!seen.has(key)) {
-      const item = {};
-      normalizedFields.forEach((field) => {
-        item[field] = entry[field] || null;
-      });
-      item.count = 0;
-      seen.set(key, item);
-    }
-    seen.get(key).count += 1;
-  });
-
-  return Array.from(seen.values()).sort((left, right) => {
-    const leftKey = normalizedFields.map((field) => String(left[field] || "")).join("::");
-    const rightKey = normalizedFields.map((field) => String(right[field] || "")).join("::");
-    return leftKey.localeCompare(rightKey);
-  });
-}
-
-function buildPromotionReadinessSummary(input = {}) {
-  const registration = input.registration && typeof input.registration === "object" ? input.registration : {};
-  const certification = input.certification && typeof input.certification === "object" ? input.certification : {};
-  const integration = input.integration && typeof input.integration === "object" ? input.integration : {};
-  const blockers = [];
-  const registrationState = registration.registration_state || null;
-  const certificationState = certification.certification_state || integration.certification_state || null;
-  const maturity = integration.integration_maturity || null;
-  const defaultSelectionEnabled = registration.default_selection_enabled === true;
-  const requiresExplicitSelection = registration.requires_explicit_selection === true;
-  const bundled = registration.bundled === true;
-
-  if (!registrationState) blockers.push("registration_state_missing");
-  if (!certificationState) blockers.push("certification_state_missing");
-  if (!maturity) blockers.push("integration_maturity_missing");
-  if (certificationState !== "certified") blockers.push("not_certified");
-  if (maturity !== "production_default") blockers.push("not_marked_production_default");
-  if (!defaultSelectionEnabled) blockers.push("default_selection_disabled");
-  if (requiresExplicitSelection) blockers.push("still_requires_explicit_selection");
-  if (!bundled) blockers.push("not_bundled_for_default_rollout");
-
-  const reviewReady = registrationState === "staging_registered";
-  const selectionReady = defaultSelectionEnabled || requiresExplicitSelection;
-  const explicitSelectionReady = requiresExplicitSelection || defaultSelectionEnabled;
-  const productionDefaultReady = blockers.length === 0;
-
-  let posture = "unknown";
-  if (productionDefaultReady) {
-    posture = "production_default_ready";
-  } else if (reviewReady && certificationState === "certified") {
-    posture = "promotion_candidate";
-  } else if (reviewReady) {
-    posture = "staged_review";
-  } else if (selectionReady) {
-    posture = "selectable_non_default";
-  }
-
-  return {
-    registration_state: registrationState,
-    certification_state: certificationState,
-    integration_maturity: maturity,
-    selection_ready: selectionReady,
-    explicit_selection_ready: explicitSelectionReady,
-    default_eligible: defaultSelectionEnabled,
-    production_default_ready: productionDefaultReady,
-    review_ready: reviewReady,
-    posture,
-    blockers
-  };
-}
-
-function summarizePromotionBlockerCategories(blockers = []) {
-  const values = Array.isArray(blockers) ? blockers : [];
-  const categories = [];
-  if (values.some((entry) => entry === "registration_state_missing")) {
-    categories.push({
-      category: "registration",
-      severity: "high",
-      owner: "integration_author"
-    });
-  }
-  if (values.some((entry) => entry === "certification_state_missing" || entry === "not_certified")) {
-    categories.push({
-      category: "certification",
-      severity: "high",
-      owner: "review_operator"
-    });
-  }
-  if (values.some((entry) => entry === "integration_maturity_missing" || entry === "not_marked_production_default")) {
-    categories.push({
-      category: "maturity",
-      severity: "medium",
-      owner: "review_operator"
-    });
-  }
-  if (values.some((entry) => entry === "default_selection_disabled" || entry === "still_requires_explicit_selection")) {
-    categories.push({
-      category: "selection",
-      severity: "medium",
-      owner: "platform_operator"
-    });
-  }
-  if (values.some((entry) => entry === "not_bundled_for_default_rollout")) {
-    categories.push({
-      category: "rollout",
-      severity: "low",
-      owner: "release_operator"
-    });
-  }
-  return summarizeStructuredCounts(categories, ["category", "severity", "owner"]);
-}
-
-function buildCertificationGapSummary(readiness = {}, integration = {}) {
-  const blockers = Array.isArray(readiness.blockers) ? readiness.blockers : [];
-  const certificationScope = Array.isArray(integration.certification_scope) ? integration.certification_scope.filter(Boolean) : [];
-  const verifiedWith = integration.registration && Array.isArray(integration.registration.verified_with)
-    ? integration.registration.verified_with.filter(Boolean)
-    : [];
-  const missingRequirements = [];
-  const productionReady = readiness.production_default_ready === true;
-
-  if (blockers.includes("certification_state_missing") || blockers.includes("not_certified")) {
-    missingRequirements.push("certification_state");
-  }
-  if (!productionReady && certificationScope.length < 1) {
-    missingRequirements.push("certification_scope");
-  }
-  if (!productionReady && verifiedWith.length < 1) {
-    missingRequirements.push("verified_with");
-  }
-
-  return {
-    certification_state: readiness.certification_state || null,
-    certification_scope_count: certificationScope.length,
-    verified_with_count: verifiedWith.length,
-    missing_requirements: missingRequirements,
-    certifiable: missingRequirements.length === 0
-  };
-}
-
-function buildNextTransitionSummary(readiness = {}) {
-  const blockers = Array.isArray(readiness.blockers) ? readiness.blockers : [];
-  if (readiness.production_default_ready === true) {
-    return {
-      action: "maintain_production_default",
-      reason: "integration already satisfies production-default posture",
-      requirements: [],
-      later_actions: []
-    };
-  }
-  if (blockers.includes("registration_state_missing")) {
-    return {
-      action: "register_integration",
-      reason: "integration is missing a registration state",
-      requirements: ["registration_state"],
-      later_actions: ["complete_certification", "promote_maturity", "enable_default_selection", "bundle_for_default_rollout"]
-    };
-  }
-  if (blockers.includes("not_certified") || blockers.includes("certification_state_missing")) {
-    return {
-      action: "complete_certification",
-      reason: "integration is not yet certified",
-      requirements: ["certification_state"],
-      later_actions: ["promote_maturity", "enable_default_selection", "bundle_for_default_rollout"]
-    };
-  }
-  if (blockers.includes("not_marked_production_default") || blockers.includes("integration_maturity_missing")) {
-    return {
-      action: "promote_maturity",
-      reason: "integration maturity is not yet aligned with production default rollout",
-      requirements: ["integration_maturity"],
-      later_actions: ["enable_default_selection", "bundle_for_default_rollout"]
-    };
-  }
-  if (blockers.includes("default_selection_disabled") || blockers.includes("still_requires_explicit_selection")) {
-    return {
-      action: "enable_default_selection",
-      reason: "integration remains explicit-selection only",
-      requirements: ["default_selection_enabled", "requires_explicit_selection=false"],
-      later_actions: blockers.includes("not_bundled_for_default_rollout") ? ["bundle_for_default_rollout"] : []
-    };
-  }
-  if (blockers.includes("not_bundled_for_default_rollout")) {
-    return {
-      action: "bundle_for_default_rollout",
-      reason: "integration is not yet bundled for production default rollout",
-      requirements: ["bundled=true"],
-      later_actions: []
-    };
-  }
-  return {
-    action: "review_manually",
-    reason: "integration posture needs operator review",
-    requirements: [],
-    later_actions: []
-  };
-}
-
-function buildPromotionRecommendationSummary(readiness = {}) {
-  const nextTransition = buildNextTransitionSummary(readiness);
-  if (readiness.production_default_ready === true) {
-    return {
-      recommendation: "eligible_for_production_default",
-      rationale: "integration is ready for production-default posture"
-    };
-  }
-  if (readiness.review_ready === true && readiness.default_eligible === false) {
-    return {
-      recommendation: "keep_staged_until_requirements_clear",
-      rationale: nextTransition.reason
-    };
-  }
-  if (readiness.review_ready === true) {
-    return {
-      recommendation: "review_for_promotion",
-      rationale: nextTransition.reason
-    };
-  }
-  return {
-    recommendation: "complete_prerequisites_first",
-    rationale: nextTransition.reason
-  };
-}
-
-const PROMOTION_ACTION_DEFINITIONS = {
-  register_integration: {
-    action: "register_integration",
-    title: "Register Integration",
-    stage: "registration",
-    description: "Move an integration into an explicit staged registration posture."
-  },
-  complete_certification: {
-    action: "complete_certification",
-    title: "Complete Certification",
-    stage: "certification",
-    description: "Mark the integration as certified for the current public contract."
-  },
-  promote_maturity: {
-    action: "promote_maturity",
-    title: "Promote Maturity",
-    stage: "maturity",
-    description: "Align integration maturity with production-default rollout posture."
-  },
-  enable_default_selection: {
-    action: "enable_default_selection",
-    title: "Enable Default Selection",
-    stage: "selection",
-    description: "Allow the integration to participate in default selection instead of explicit-only use."
-  },
-  bundle_for_default_rollout: {
-    action: "bundle_for_default_rollout",
-    title: "Bundle For Default Rollout",
-    stage: "rollout",
-    description: "Mark the integration as bundled for production-default rollout."
-  },
-  maintain_production_default: {
-    action: "maintain_production_default",
-    title: "Maintain Production Default",
-    stage: "steady_state",
-    description: "Confirm the integration already satisfies production-default posture."
-  }
-};
-
-function getPromotionActionDefinition(action) {
-  const lookup = String(action || "").trim();
-  return PROMOTION_ACTION_DEFINITIONS[lookup] || null;
-}
-
-function clonePromotionSubject(summary = {}) {
-  return {
-    registration: clone(summary.registration || {}),
-    certification_state: summary.certification_state || null,
-    integration_maturity: summary.integration_maturity || null
-  };
-}
-
-function simulatePromotionActionSubject(summary = {}, action) {
-  const subject = clonePromotionSubject(summary);
-  switch (action) {
-    case "register_integration":
-      subject.registration.registration_state = "staging_registered";
-      if (subject.registration.default_selection_enabled !== true) {
-        subject.registration.default_selection_enabled = false;
-      }
-      if (subject.registration.requires_explicit_selection !== false) {
-        subject.registration.requires_explicit_selection = true;
-      }
-      break;
-    case "complete_certification":
-      subject.certification_state = "certified";
-      break;
-    case "promote_maturity":
-      subject.integration_maturity = "production_default";
-      break;
-    case "enable_default_selection":
-      subject.registration.default_selection_enabled = true;
-      subject.registration.requires_explicit_selection = false;
-      break;
-    case "bundle_for_default_rollout":
-      subject.registration.bundled = true;
-      break;
-    case "maintain_production_default":
-      break;
-    default:
-      break;
-  }
-  return subject;
-}
-
-function buildPromotionActionResultingReadiness(summary = {}, subject = {}) {
-  return buildPromotionReadinessSummary({
-    registration: subject.registration,
-    certification: {
-      certification_state: subject.certification_state || summary.certification_state || null
-    },
-    integration: {
-      integration_maturity: subject.integration_maturity || summary.integration_maturity || null
-    }
-  });
-}
-
-function buildPromotionActionStateChanges(current = {}, simulated = {}) {
-  const changes = [];
-  const currentRegistration = current.registration || {};
-  const simulatedRegistration = simulated.registration || {};
-  const fieldPairs = [
-    ["registration.registration_state", currentRegistration.registration_state, simulatedRegistration.registration_state],
-    ["registration.default_selection_enabled", currentRegistration.default_selection_enabled, simulatedRegistration.default_selection_enabled],
-    ["registration.requires_explicit_selection", currentRegistration.requires_explicit_selection, simulatedRegistration.requires_explicit_selection],
-    ["registration.bundled", currentRegistration.bundled, simulatedRegistration.bundled],
-    ["certification_state", current.certification_state, simulated.certification_state],
-    ["integration_maturity", current.integration_maturity, simulated.integration_maturity]
-  ];
-  fieldPairs.forEach(([field, fromValue, toValue]) => {
-    if (fromValue !== toValue) {
-      changes.push({
-        field,
-        from: fromValue === undefined ? null : fromValue,
-        to: toValue === undefined ? null : toValue
-      });
-    }
-  });
-  return changes;
-}
-
-function validatePromotionActionRequest(request = {}) {
-  const entry = request && typeof request === "object" && !Array.isArray(request) ? request : {};
-  const errors = [];
-  const integrationId = String(entry.integration_id || "").trim();
-  const action = String(entry.action || "").trim();
-  if (!integrationId) {
-    errors.push("promotion_action_request.integration_id is required");
-  }
-  if (!action) {
-    errors.push("promotion_action_request.action is required");
-  } else if (!getPromotionActionDefinition(action)) {
-    errors.push("promotion_action_request.action must be a supported promotion action");
-  }
-  return {
-    ok: errors.length === 0,
-    errors,
-    request: {
-      integration_id: integrationId || null,
-      action: action || null
-    }
-  };
-}
-
-function summarizeIntegrationPromotionActionPreview(request = {}) {
-  const validation = validatePromotionActionRequest(request);
-  if (!validation.ok) {
-    return {
-      ok: false,
-      reason: "invalid_promotion_action_request",
-      errors: validation.errors
-    };
-  }
-  const workflow = summarizeIntegrationPromotionWorkflow(validation.request.integration_id);
-  if (!workflow.ok) {
-    return workflow;
-  }
-
-  const action = validation.request.action;
-  const definition = getPromotionActionDefinition(action);
-  const currentSubject = clonePromotionSubject(workflow);
-  const simulatedSubject = simulatePromotionActionSubject(workflow, action);
-  const resultingReadiness = buildPromotionActionResultingReadiness(workflow, simulatedSubject);
-  const stateChanges = buildPromotionActionStateChanges(currentSubject, simulatedSubject);
-  const currentNextAction = workflow.next_transition && workflow.next_transition.action
-    ? workflow.next_transition.action
-    : null;
-  const currentLaterActions = Array.isArray(workflow.next_transition && workflow.next_transition.later_actions)
-    ? workflow.next_transition.later_actions
-    : [];
-  const validNow = currentNextAction === action || currentLaterActions.includes(action);
-  const invalidReasons = [];
-  if (!validNow) {
-    invalidReasons.push(action === "maintain_production_default"
-      ? "integration_is_not_yet_production_default_ready"
-      : "action_is_not_currently_recommended_from_present_posture");
-  }
-
-  return {
-    ok: true,
-    integration_id: workflow.integration_id,
-    display_name: workflow.display_name,
-    adapter_class: workflow.adapter_class,
-    source: workflow.source,
-    request: clone(validation.request),
-    action: clone(definition),
-    current_posture: {
-      registration_state: workflow.registration.registration_state || null,
-      certification_state: workflow.certification_state || null,
-      integration_maturity: workflow.integration_maturity || null,
-      promotion_readiness: clone(workflow.promotion_readiness || {})
-    },
-    valid_now: validNow,
-    is_recommended_next: currentNextAction === action,
-    invalid_reasons: invalidReasons,
-    requirements: currentNextAction === action
-      ? clone(workflow.next_transition.requirements || [])
-      : clone(buildNextTransitionSummary(resultingReadiness).requirements || []),
-    blockers: clone(workflow.promotion_readiness.blockers || []),
-    blocker_categories: clone(workflow.blocker_categories || []),
-    resulting_posture: {
-      registration_state: simulatedSubject.registration.registration_state || null,
-      certification_state: simulatedSubject.certification_state || null,
-      integration_maturity: simulatedSubject.integration_maturity || null,
-      promotion_readiness: clone(resultingReadiness)
-    },
-    state_changes: stateChanges,
-    current_transition: clone(workflow.next_transition || {}),
-    resulting_transition: buildNextTransitionSummary(resultingReadiness)
-  };
-}
-
-function summarizeIntegrationPromotionActionSet(integrationOrId) {
-  const workflow = summarizeIntegrationPromotionWorkflow(integrationOrId);
-  if (!workflow.ok) {
-    return workflow;
-  }
-  const actionOrder = [
-    workflow.next_transition && workflow.next_transition.action ? workflow.next_transition.action : null,
-    ...(Array.isArray(workflow.next_transition && workflow.next_transition.later_actions)
-      ? workflow.next_transition.later_actions
-      : []),
-    "maintain_production_default"
-  ].filter(Boolean);
-  const actions = sortStrings(actionOrder).map((action) => summarizeIntegrationPromotionActionPreview({
-    integration_id: workflow.integration_id,
-    action
-  }));
-  return {
-    ...workflow,
-    action_count: actions.length,
-    valid_now_count: actions.filter((entry) => entry.valid_now === true).length,
-    actions
-  };
-}
-
-function summarizeIntegrationPromotionActionSetList(filters = {}) {
-  const integrations = listIntegrations(filters).map((integration) => summarizeIntegrationPromotionActionSet(integration));
-  return {
-    ok: true,
-    integration_count: integrations.length,
-    valid_now_count: integrations.reduce((total, entry) => total + Number(entry.valid_now_count || 0), 0),
-    recommended_actions: summarizeCounts(
-      integrations
-        .map((entry) => entry.next_transition && entry.next_transition.action)
-        .filter(Boolean),
-      "action"
-    ),
-    valid_actions: summarizeCounts(
-      integrations
-        .flatMap((entry) => Array.isArray(entry.actions) ? entry.actions : [])
-        .filter((entry) => entry.valid_now === true)
-        .map((entry) => entry.request && entry.request.action)
-        .filter(Boolean),
-      "action"
-    ),
-    integrations
-  };
-}
-
-function buildPromotionActionQueues(integrations = []) {
-  const rows = Array.isArray(integrations) ? integrations.filter((entry) => entry && entry.next_transition) : [];
-  const groups = new Map();
-
-  rows.forEach((entry) => {
-    const action = entry.next_transition && entry.next_transition.action
-      ? entry.next_transition.action
-      : "review_manually";
-    if (!groups.has(action)) {
-      groups.set(action, []);
-    }
-    groups.get(action).push(entry);
-  });
-
-  return Array.from(groups.keys()).sort().map((action) => {
-    const entries = groups.get(action) || [];
-    const blockerEntries = entries.flatMap((entry) => entry.blocker_categories || []);
-    return {
-      action,
-      count: entries.length,
-      recommendation_counts: summarizeCounts(
-        entries.map((entry) => entry.promotion_recommendation && entry.promotion_recommendation.recommendation).filter(Boolean),
-        "recommendation"
-      ),
-      owner_queue: summarizeCounts(
-        blockerEntries.map((entry) => entry.owner).filter(Boolean),
-        "owner"
-      ),
-      severity_queue: summarizeCounts(
-        blockerEntries.map((entry) => entry.severity).filter(Boolean),
-        "severity"
-      ),
-      integration_ids: entries.map((entry) => entry.integration_id).filter(Boolean).sort(),
-      integrations: entries.map((entry) => ({
-        integration_id: entry.integration_id,
-        display_name: entry.display_name,
-        adapter_class: entry.adapter_class,
-        recommendation: entry.promotion_recommendation && entry.promotion_recommendation.recommendation,
-        review_ready: entry.promotion_readiness && entry.promotion_readiness.review_ready === true,
-        production_default_ready: entry.promotion_readiness && entry.promotion_readiness.production_default_ready === true
-      }))
-    };
-  });
-}
-
-function buildSubmissionBundleReviewWarnings(bundle) {
-  const warnings = [];
-  const registrationRecord = bundle && bundle.registration_record && typeof bundle.registration_record === "object"
-    ? bundle.registration_record
-    : {};
-  const certificationPack = bundle && bundle.certification_pack && typeof bundle.certification_pack === "object"
-    ? bundle.certification_pack
-    : {};
-
-  if (registrationRecord.registration_state === "staging_registered") {
-    warnings.push("integration is staging-registered and should be reviewed before broader promotion");
-  }
-  if (registrationRecord.requires_explicit_selection === true) {
-    warnings.push("integration requires explicit selection and should not be treated as default");
-  }
-  if (registrationRecord.default_selection_enabled !== true) {
-    warnings.push("integration is not currently eligible for default selection");
-  }
-  if (certificationPack.certification_state && certificationPack.certification_state !== "certified") {
-    warnings.push("integration is not yet fully certified");
-  }
-
-  return warnings;
-}
-
-function summarizeIntegrationSubmissionBundleReview(bundleInput = {}) {
-  const bundle = clone(bundleInput || {});
-  const validation = validateIntegrationSubmissionBundle(bundle);
-  const snapshotEntry = bundle.snapshot_entry && typeof bundle.snapshot_entry === "object"
-    ? clone(bundle.snapshot_entry)
-    : {};
-  const manifest = bundle.manifest && typeof bundle.manifest === "object" ? bundle.manifest : {};
-  const registrationRecord = bundle.registration_record && typeof bundle.registration_record === "object"
-    ? bundle.registration_record
-    : {};
-  const certificationPack = bundle.certification_pack && typeof bundle.certification_pack === "object"
-    ? bundle.certification_pack
-    : {};
-  const integrationId = registrationRecord.integration_id || manifest.adapter_id || snapshotEntry.integration_id || null;
-  const adapterClass = registrationRecord.adapter_class || manifest.adapter_class || snapshotEntry.adapter_class || null;
-  const protocols = sortStrings(snapshotEntry.protocols);
-  const settlementModes = sortStrings(snapshotEntry.settlement_modes || manifest.supported_settlement_modes);
-  const taskRefs = sortStrings(snapshotEntry.task_refs);
-  const workflowRefs = sortStrings(snapshotEntry.workflow_refs);
-  const warnings = buildSubmissionBundleReviewWarnings(bundle);
-  const promotionReadiness = buildPromotionReadinessSummary({
-    registration: {
-      registration_state: registrationRecord.registration_state || null,
-      bundled: registrationRecord.bundled === true,
-      default_selection_enabled: registrationRecord.default_selection_enabled === true,
-      requires_explicit_selection: registrationRecord.requires_explicit_selection === true
-    },
-    certification: {
-      certification_state: certificationPack.certification_state || snapshotEntry.certification_state || null
-    },
-    integration: {
-      integration_maturity: registrationRecord.integration_maturity || snapshotEntry.integration_maturity || null,
-      certification_state: certificationPack.certification_state || snapshotEntry.certification_state || null
-    }
-  });
-
-  return {
-    ok: validation.ok,
-    review_kind: "integration_submission_bundle",
-    validation,
-    integration: {
-      integration_id: integrationId,
-      display_name: manifest.display_name || snapshotEntry.display_name || null,
-      adapter_id: manifest.adapter_id || registrationRecord.adapter_id || null,
-      adapter_class: adapterClass,
-      adapter_version: manifest.adapter_version || snapshotEntry.adapter_version || null,
-      source: snapshotEntry.source || null,
-      certification_state: certificationPack.certification_state || snapshotEntry.certification_state || null,
-      integration_maturity: registrationRecord.integration_maturity || snapshotEntry.integration_maturity || null,
-      protocols,
-      settlement_modes: settlementModes,
-      task_refs: taskRefs,
-      workflow_refs: workflowRefs
-    },
-    registration: {
-      registration_state: registrationRecord.registration_state || null,
-      bundled: registrationRecord.bundled === true,
-      default_selection_enabled: registrationRecord.default_selection_enabled === true,
-      requires_explicit_selection: registrationRecord.requires_explicit_selection === true,
-      selection_priority: Number.isFinite(Number(registrationRecord.selection_priority))
-        ? Number(registrationRecord.selection_priority)
-        : null,
-      registered_at: registrationRecord.registered_at || null,
-      registered_by: registrationRecord.registered_by || null
-    },
-    certification: {
-      certification_state: certificationPack.certification_state || null,
-      certification_scope: sortStrings(certificationPack.certification_scope),
-      verified_with: sortStrings(certificationPack.verified_with),
-      submitted_at: certificationPack.submitted_at || null,
-      submitted_by: certificationPack.submitted_by || null
-    },
-    promotion_readiness: promotionReadiness,
-    review_summary: {
-      warning_count: warnings.length,
-      warnings,
-      capability_count: Array.isArray(manifest.capabilities) ? manifest.capabilities.length : 0,
-      protocol_count: protocols.length,
-      settlement_mode_count: settlementModes.length,
-      task_count: taskRefs.length,
-      workflow_count: workflowRefs.length,
-      selectable_via_explicit_request: registrationRecord.requires_explicit_selection === true
-        || registrationRecord.default_selection_enabled === true,
-      default_eligible: registrationRecord.default_selection_enabled === true,
-      production_default_ready: promotionReadiness.production_default_ready
-    }
-  };
-}
-
-function summarizeIntegrationSubmissionBundleSetReview(bundleSetInput = {}) {
-  const bundleSet = clone(bundleSetInput || {});
-  const validation = validateIntegrationSubmissionBundleSet(bundleSet);
-  const bundleReviews = (Array.isArray(bundleSet.bundles) ? bundleSet.bundles : []).map((bundle) =>
-    summarizeIntegrationSubmissionBundleReview(bundle)
-  );
-  const adapterClasses = bundleReviews.map((review) => review.integration.adapter_class).filter(Boolean);
-  const registrationStates = bundleReviews.map((review) => review.registration.registration_state).filter(Boolean);
-  const certificationStates = bundleReviews.map((review) => review.certification.certification_state).filter(Boolean);
-
-  return {
-    ok: validation.ok,
-    review_kind: "integration_submission_bundle_set",
-    validation,
-    bundle_set_version: bundleSet.bundle_set_version || null,
-    bundle_count: Array.isArray(bundleSet.bundles) ? bundleSet.bundles.length : 0,
-    generated_at: bundleSet.generated_at || null,
-    filters: clone(bundleSet.filters || {}),
-    notes: typeof bundleSet.notes === "string" ? bundleSet.notes : null,
-    review_summary: {
-      warning_count: bundleReviews.reduce((total, review) => total + review.review_summary.warning_count, 0),
-      explicit_selection_required_count: bundleReviews.filter((review) => review.registration.requires_explicit_selection).length,
-      default_eligible_count: bundleReviews.filter((review) => review.registration.default_selection_enabled).length,
-      production_default_ready_count: bundleReviews.filter((review) => review.promotion_readiness.production_default_ready).length,
-      review_ready_count: bundleReviews.filter((review) => review.promotion_readiness.review_ready).length,
-      bundled_count: bundleReviews.filter((review) => review.registration.bundled).length,
-      adapter_classes: summarizeCounts(adapterClasses, "adapter_class"),
-      registration_states: summarizeCounts(registrationStates, "registration_state"),
-      certification_states: summarizeCounts(certificationStates, "certification_state"),
-      postures: summarizeCounts(bundleReviews.map((review) => review.promotion_readiness.posture).filter(Boolean), "posture")
-    },
-    bundles: bundleReviews
-  };
-}
-
-function summarizeIntegrationRegistrySnapshotReview(snapshotInput = {}) {
-  const snapshot = clone(snapshotInput || {});
-  const validation = validateIntegrationRegistrySnapshot(snapshot);
-  const integrations = Array.isArray(snapshot.integrations) ? snapshot.integrations : [];
-  const adapterClasses = integrations.map((integration) => integration.adapter_class).filter(Boolean);
-  const sources = integrations.map((integration) => integration.source).filter(Boolean);
-  const certificationStates = integrations.map((integration) => integration.certification_state).filter(Boolean);
-  const registrationStates = integrations
-    .map((integration) => integration.registration && integration.registration.registration_state)
-    .filter(Boolean);
-  const promotionReviews = integrations.map((integration) => buildPromotionReadinessSummary({
-    registration: integration.registration,
-    certification: {
-      certification_state: integration.certification_state || null
-    },
-    integration
-  }));
-
-  return {
-    ok: validation.ok,
-    review_kind: "integration_registry_snapshot",
-    validation,
-    snapshot_version: snapshot.snapshot_version || null,
-    integration_count: integrations.length,
-    generated_at: snapshot.generated_at || null,
-    filters: clone(snapshot.filters || {}),
-    review_summary: {
-      production_default_count: integrations.filter((integration) => integration.integration_maturity === "production_default").length,
-      staged_registration_count: integrations.filter((integration) => integration.registration && integration.registration.registration_state === "staging_registered").length,
-      explicit_selection_required_count: integrations.filter((integration) => integration.registration && integration.registration.requires_explicit_selection === true).length,
-      default_selection_enabled_count: integrations.filter((integration) => integration.registration && integration.registration.default_selection_enabled === true).length,
-      production_default_ready_count: promotionReviews.filter((review) => review.production_default_ready).length,
-      review_ready_count: promotionReviews.filter((review) => review.review_ready).length,
-      adapter_classes: summarizeCounts(adapterClasses, "adapter_class"),
-      sources: summarizeCounts(sources, "source"),
-      certification_states: summarizeCounts(certificationStates, "certification_state"),
-      registration_states: summarizeCounts(registrationStates, "registration_state"),
-      postures: summarizeCounts(promotionReviews.map((review) => review.posture).filter(Boolean), "posture")
-    }
-  };
-}
-
-function summarizeIntegrationPromotionReadiness(integrationOrId) {
-  const integration = typeof integrationOrId === "string"
-    ? getIntegration(integrationOrId)
-    : clone(integrationOrId || null);
-  if (!integration) {
-    return {
-      ok: false,
-      reason: "integration_not_found"
-    };
-  }
-  return {
-    ok: true,
-    integration_id: integration.integration_id,
-    display_name: integration.display_name,
-    adapter_class: integration.adapter_class,
-    source: integration.source,
-    registration: clone(integration.registration || {}),
-    certification_state: integration.certification_state || null,
-    integration_maturity: integration.integration_maturity || null,
-    promotion_readiness: buildPromotionReadinessSummary({
-      registration: integration.registration,
-      certification: {
-        certification_state: integration.certification_state || null
-      },
-      integration
-    })
-  };
-}
-
-function summarizeIntegrationPromotionWorkflow(integrationOrId) {
-  const summary = summarizeIntegrationPromotionReadiness(integrationOrId);
-  if (!summary.ok) {
-    return summary;
-  }
-  const readiness = clone(summary.promotion_readiness || {});
-  return {
-    ...summary,
-    certification_gaps: buildCertificationGapSummary(readiness, summary),
-    blocker_categories: summarizePromotionBlockerCategories(readiness.blockers),
-    next_transition: buildNextTransitionSummary(readiness),
-    promotion_recommendation: buildPromotionRecommendationSummary(readiness)
-  };
-}
-
-function summarizeIntegrationPromotionWorkflowList(filters = {}) {
-  const integrations = listIntegrations(filters).map((integration) => summarizeIntegrationPromotionWorkflow(integration));
-  const blockerCategoryEntries = integrations.flatMap((entry) => entry.blocker_categories || []);
-  return {
-    ok: true,
-    integration_count: integrations.length,
-    review_ready_count: integrations.filter((entry) => entry.promotion_readiness.review_ready).length,
-    production_default_ready_count: integrations.filter((entry) => entry.promotion_readiness.production_default_ready).length,
-    certifiable_count: integrations.filter((entry) => entry.certification_gaps.certifiable).length,
-    next_actions: summarizeCounts(
-      integrations.map((entry) => entry.next_transition.action).filter(Boolean),
-      "action"
-    ),
-    recommendations: summarizeCounts(
-      integrations.map((entry) => entry.promotion_recommendation.recommendation).filter(Boolean),
-      "recommendation"
-    ),
-    blocker_categories: summarizeStructuredCounts(
-      blockerCategoryEntries,
-      ["category", "severity", "owner"]
-    ),
-    owner_queue: summarizeCounts(
-      blockerCategoryEntries.map((entry) => entry.owner).filter(Boolean),
-      "owner"
-    ),
-    severity_queue: summarizeCounts(
-      blockerCategoryEntries.map((entry) => entry.severity).filter(Boolean),
-      "severity"
-    ),
-    next_action_queues: buildPromotionActionQueues(integrations),
-    integrations
-  };
-}
-
-function buildBuiltInIntegrations() {
-  const httpTaskRefs = collectTaskRefsByAdapter("http");
-  const mcpTaskRefs = collectTaskRefsByAdapter("mcp");
-  const chainTaskRefs = collectTaskRefsByAdapter("chain");
-  const settlementModes = (Array.isArray(catalog.settlement_profiles) ? catalog.settlement_profiles : []).map((profile) => profile.mode);
-
-  return [
-    {
-      integration_id: "builtin.execution.http",
-      display_name: "Built-In HTTP Execution",
-      description: "Default execution path for task and workflow lanes served directly by xytara.",
-      adapter_class: "execution_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_default",
-      selection_priority: 100,
-      capabilities: sortStrings(
-        (Array.isArray(catalog.tasks) ? catalog.tasks : [])
-          .filter((task) => Array.isArray(task.adapters) && task.adapters.includes("http"))
-          .flatMap((task) => task.capabilities || [])
-      ),
-      protocols: [],
-      settlement_modes: [],
-      execution_backends: ["http"],
-      adapter_lanes: ["http"],
-      task_refs: sortStrings(httpTaskRefs),
-      workflow_refs: sortStrings(collectWorkflowRefsByTaskRefs(httpTaskRefs)),
-      required_secrets: [],
-      required_permissions: [],
-      supported_profiles: ["default"],
-      supported_regions: ["global"],
-      pricing_basis: "per_task",
-      latency_class: "mixed",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "execution_facts_only"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "command_quote_binding",
-        scope: "task_execution"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "timeout", "upstream_unavailable"],
-        retryable_categories: ["timeout", "upstream_unavailable"]
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: true,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: sortStrings(httpTaskRefs),
-        default_for_protocols: [],
-        default_for_settlement_modes: []
-      }
-    },
-    {
-      integration_id: "builtin.protocol.mcp",
-      display_name: "Built-In MCP Protocol Lane",
-      description: "Built-in machine protocol lane for MCP tool discovery and invocation through the commerce flow.",
-      adapter_class: "agent_protocol_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_default",
-      selection_priority: 80,
-      capabilities: ["adapter.mcp.invoke"],
-      protocols: ["mcp"],
-      settlement_modes: [],
-      execution_backends: ["mcp"],
-      adapter_lanes: ["mcp"],
-      task_refs: sortStrings(mcpTaskRefs),
-      workflow_refs: sortStrings(collectWorkflowRefsByTaskRefs(mcpTaskRefs)),
-      required_secrets: [],
-      required_permissions: [],
-      supported_profiles: ["default"],
-      supported_regions: ["global"],
-      pricing_basis: "per_task",
-      latency_class: "near_real_time",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "protocol_invocation_facts"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "quote_bound_invocation",
-        scope: "protocol_invocation"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "timeout", "upstream_unavailable"],
-        retryable_categories: ["timeout", "upstream_unavailable"]
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: true,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: sortStrings(mcpTaskRefs),
-        default_for_protocols: ["mcp"],
-        default_for_settlement_modes: []
-      }
-    },
-    {
-      integration_id: "builtin.payment.x402",
-      display_name: "Built-In x402 Payment Admission",
-      description: "Built-in exact-payment challenge lane for x402-style machine payment admission.",
-      adapter_class: "payment_rail_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_default",
-      selection_priority: 60,
-      capabilities: ["payment.admission", "payment.challenge", "payment.exact"],
-      protocols: ["x402"],
-      settlement_modes: sortStrings(settlementModes),
-      execution_backends: [],
-      adapter_lanes: ["x402"],
-      task_refs: [],
-      workflow_refs: [],
-      required_secrets: [],
-      required_permissions: [],
-      supported_profiles: ["default"],
-      supported_regions: ["global"],
-      pricing_basis: "quote_then_settle",
-      latency_class: "near_real_time",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "payment_admission_facts"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "quote_id",
-        scope: "payment_admission"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "quote_expired", "payment_missing"],
-        retryable_categories: []
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: true,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: [],
-        default_for_protocols: ["x402"],
-        default_for_settlement_modes: sortStrings(settlementModes)
-      }
-    },
-    {
-      integration_id: "builtin.payment.l402",
-      display_name: "Built-In L402 Payment Admission",
-      description: "Built-in L402-style Lightning payment admission through a gateway-signed payment front.",
-      adapter_class: "payment_rail_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_supported",
-      selection_priority: 65,
-      capabilities: ["payment.admission", "payment.challenge", "payment.permissionless_front"],
-      protocols: ["l402"],
-      settlement_modes: sortStrings(settlementModes),
-      execution_backends: [],
-      adapter_lanes: ["l402"],
-      task_refs: [],
-      workflow_refs: [],
-      required_secrets: ["XYTARA_L402_SHARED_SECRET"],
-      required_permissions: [],
-      supported_profiles: ["default"],
-      supported_regions: ["global"],
-      pricing_basis: "quote_then_settle",
-      latency_class: "near_real_time",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "payment_admission_facts"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "quote_id",
-        scope: "payment_admission"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "quote_expired", "payment_missing"],
-        retryable_categories: []
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: false,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: [],
-        default_for_protocols: [],
-        default_for_settlement_modes: sortStrings(settlementModes)
-      }
-    },
-    {
-      integration_id: "builtin.payment.bolt",
-      display_name: "Built-In BOLT Payment Admission",
-      description: "Built-in BOLT-style UTXO/SPV payment admission through a signed proof-carrying payment front.",
-      adapter_class: "payment_rail_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_supported",
-      selection_priority: 66,
-      capabilities: ["payment.admission", "payment.challenge", "payment.permissionless_front", "payment.spv_proof"],
-      protocols: ["bolt"],
-      settlement_modes: sortStrings(settlementModes),
-      execution_backends: [],
-      adapter_lanes: ["bolt"],
-      task_refs: [],
-      workflow_refs: [],
-      required_secrets: ["XYTARA_BOLT_SHARED_SECRET"],
-      required_permissions: [],
-      supported_profiles: ["default"],
-      supported_regions: ["global"],
-      pricing_basis: "quote_then_settle",
-      latency_class: "near_real_time",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "spv_or_block_header_verifiable_payment_facts"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "quote_id",
-        scope: "payment_admission"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "quote_expired", "payment_missing"],
-        retryable_categories: []
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: false,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: [],
-        default_for_protocols: [],
-        default_for_settlement_modes: sortStrings(settlementModes)
-      }
-    },
-    {
-      integration_id: "builtin.settlement.chain",
-      display_name: "Built-In Chain Settlement",
-      description: "Built-in settlement lane spanning the canonical chain-backed settlement profiles bundled in xytara.",
-      adapter_class: "settlement_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_default",
-      selection_priority: 90,
-      capabilities: sortStrings(
-        (Array.isArray(catalog.tasks) ? catalog.tasks : [])
-          .filter((task) => Array.isArray(task.adapters) && task.adapters.includes("chain"))
-          .flatMap((task) => task.capabilities || [])
-      ),
-      protocols: [],
-      settlement_modes: sortStrings(settlementModes),
-      execution_backends: ["chain"],
-      adapter_lanes: ["chain"],
-      task_refs: sortStrings(chainTaskRefs),
-      workflow_refs: sortStrings(collectWorkflowRefsByTaskRefs(chainTaskRefs)),
-      required_secrets: [],
-      required_permissions: [],
-      supported_profiles: ["default", "anchored"],
-      supported_regions: ["global"],
-      pricing_basis: "per_settlement",
-      latency_class: "governed_async",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "settlement_reference_only"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "quote_and_target_binding",
-        scope: "settlement_request"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "timeout", "upstream_unavailable", "settlement_failure"],
-        retryable_categories: ["timeout", "upstream_unavailable"]
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: true,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: sortStrings(chainTaskRefs),
-        default_for_protocols: [],
-        default_for_settlement_modes: sortStrings(settlementModes)
-      }
-    },
-    {
-      integration_id: "builtin.identity.registry",
-      display_name: "Built-In Registry Identity Surface",
-      description: "Built-in registry and anchoring surface used by trust, registry, and lifecycle records.",
-      adapter_class: "identity_registry_adapter",
-      adapter_version: "1.4.0",
-      interface_version: "commerce-adapter-interface/v1",
-      bundled: true,
-      source: "builtin",
-      status: "available",
-      certification_state: "certified",
-      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
-      integration_maturity: "production_default",
-      selection_priority: 70,
-      capabilities: ["registry.register", "anchoring.submit", "trust.handoff.emit", "trust.handoff.validate"],
-      protocols: [],
-      settlement_modes: [],
-      execution_backends: ["http", "chain"],
-      adapter_lanes: ["http", "chain"],
-      task_refs: sortStrings(["registry.register", "anchoring.submit", "trust.handoff.emit", "trust.handoff.validate"]),
-      workflow_refs: sortStrings(["registry.anchor.flow", "trust.flow"]),
-      required_secrets: [],
-      required_permissions: [],
-      supported_profiles: ["registry", "trust"],
-      supported_regions: ["global"],
-      pricing_basis: "per_task",
-      latency_class: "mixed",
-      proof_contract: {
-        emits_proof_compatible_facts: true,
-        proof_mode: "registry_reference_facts"
-      },
-      health_contract: {
-        check_kind: "internal",
-        supports_readiness: true
-      },
-      idempotency_contract: {
-        strategy: "record_ref_binding",
-        scope: "registry_request"
-      },
-      failure_contract: {
-        categories: ["invalid_input", "timeout", "upstream_unavailable"],
-        retryable_categories: ["timeout", "upstream_unavailable"]
-      },
-      compatibility: {
-        node: ">=18",
-        commerce_contract: "xytara/v1"
-      },
-      operational_readiness: {
-        supports_default_selection: true,
-        supports_forced_selection: true,
-        lifecycle: "managed_builtin",
-        health_source: "internal"
-      },
-      selection_hints: {
-        default_for_task_refs: sortStrings(["registry.register", "anchoring.submit", "trust.handoff.emit", "trust.handoff.validate"]),
-        default_for_protocols: [],
-        default_for_settlement_modes: []
-      }
-    },
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.a2a",
-      display_name: "Built-In A2A Protocol Surface",
-      description: "Built-in explicit agent-to-agent protocol surface for negotiation, commit, and settlement flow handoff.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["a2a.negotiate", "a2a.commit"],
-      protocols: ["a2a"],
-      execution_backends: ["a2a"],
-      adapter_lanes: ["a2a"],
-      task_refs: ["a2a.negotiate", "a2a.commit"],
-      workflow_refs: ["a2a.settlement.flow"],
-      supported_profiles: ["interaction"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.acp",
-      display_name: "Built-In ACP Protocol Surface",
-      description: "Built-in explicit ACP integration surface for third-party commerce and agent marketplace bridging.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["protocol.acp.bridge"],
-      protocols: ["acp"],
-      execution_backends: ["acp"],
-      adapter_lanes: ["acp"],
-      supported_profiles: ["marketplace", "interaction"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.mqtt",
-      display_name: "Built-In MQTT Protocol Surface",
-      description: "Built-in MQTT-facing protocol surface for message-driven machine interaction ingestion.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["protocol.mqtt.bridge"],
-      protocols: ["mqtt"],
-      execution_backends: ["mqtt"],
-      adapter_lanes: ["mqtt"],
-      supported_profiles: ["message_bus"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.grpc",
-      display_name: "Built-In gRPC Protocol Surface",
-      description: "Built-in gRPC-facing protocol surface for service-to-service commerce integration.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["protocol.grpc.bridge"],
-      protocols: ["grpc"],
-      execution_backends: ["grpc"],
-      adapter_lanes: ["grpc"],
-      supported_profiles: ["service_mesh"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.kafka",
-      display_name: "Built-In Kafka Protocol Surface",
-      description: "Built-in Kafka-facing protocol surface for streaming commerce/event ingress.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["protocol.kafka.bridge"],
-      protocols: ["kafka"],
-      execution_backends: ["kafka"],
-      adapter_lanes: ["kafka"],
-      supported_profiles: ["streaming"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.nats",
-      display_name: "Built-In NATS Protocol Surface",
-      description: "Built-in NATS-facing protocol surface for lightweight message-bus integration.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["protocol.nats.bridge"],
-      protocols: ["nats"],
-      execution_backends: ["nats"],
-      adapter_lanes: ["nats"],
-      supported_profiles: ["streaming"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.protocol.ros2",
-      display_name: "Built-In ROS2 Protocol Surface",
-      description: "Built-in ROS2-facing protocol surface for robotics-adjacent machine interaction integration.",
-      adapter_class: "agent_protocol_adapter",
-      capabilities: ["protocol.ros2.bridge"],
-      protocols: ["ros2"],
-      execution_backends: ["ros2"],
-      adapter_lanes: ["ros2"],
-      supported_profiles: ["robotics"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.execution.langchain",
-      display_name: "Built-In LangChain Execution Surface",
-      description: "Built-in execution-front surface for LangChain-style orchestration interoperability.",
-      adapter_class: "execution_adapter",
-      capabilities: ["execution.langchain.chain"],
-      execution_backends: ["langchain"],
-      adapter_lanes: ["langchain"],
-      supported_profiles: ["agent_runtime"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.execution.langgraph",
-      display_name: "Built-In LangGraph Execution Surface",
-      description: "Built-in execution-front surface for LangGraph-style graph orchestration interoperability.",
-      adapter_class: "execution_adapter",
-      capabilities: ["execution.langgraph.graph"],
-      execution_backends: ["langgraph"],
-      adapter_lanes: ["langgraph"],
-      supported_profiles: ["agent_runtime"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.execution.semantic_kernel",
-      display_name: "Built-In Semantic Kernel Execution Surface",
-      description: "Built-in execution-front surface for Semantic Kernel-style orchestration interoperability.",
-      adapter_class: "execution_adapter",
-      capabilities: ["execution.semantic_kernel.plan"],
-      execution_backends: ["semantic_kernel"],
-      adapter_lanes: ["semantic_kernel"],
-      supported_profiles: ["agent_runtime"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.execution.autogen",
-      display_name: "Built-In AutoGen Execution Surface",
-      description: "Built-in execution-front surface for AutoGen-style multi-agent orchestration interoperability.",
-      adapter_class: "execution_adapter",
-      capabilities: ["execution.autogen.session"],
-      execution_backends: ["autogen"],
-      adapter_lanes: ["autogen"],
-      supported_profiles: ["agent_runtime"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.execution.crewai",
-      display_name: "Built-In CrewAI Execution Surface",
-      description: "Built-in execution-front surface for CrewAI-style workflow interoperability.",
-      adapter_class: "execution_adapter",
-      capabilities: ["execution.crewai.crew"],
-      execution_backends: ["crewai"],
-      adapter_lanes: ["crewai"],
-      supported_profiles: ["agent_runtime"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.execution.llamaindex",
-      display_name: "Built-In LlamaIndex Execution Surface",
-      description: "Built-in execution-front surface for LlamaIndex-style retrieval and agent interoperability.",
-      adapter_class: "execution_adapter",
-      capabilities: ["execution.llamaindex.workflow"],
-      execution_backends: ["llamaindex"],
-      adapter_lanes: ["llamaindex"],
-      supported_profiles: ["agent_runtime", "retrieval"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.payment.mpp",
-      display_name: "Built-In MPP Payment Surface",
-      description: "Built-in multi-party payment admission surface for broader machine payment interoperability.",
-      adapter_class: "payment_rail_adapter",
-      capabilities: ["payment.mpp.admission"],
-      protocols: ["mpp"],
-      settlement_modes: sortStrings(settlementModes),
-      adapter_lanes: ["mpp"],
-      required_secrets: ["XYTARA_MPP_SHARED_SECRET"],
-      supported_profiles: ["payment"]
-    }),
-    createBuiltinBreadthIntegration({
-      integration_id: "builtin.identity.erc8004",
-      display_name: "Built-In ERC-8004 Identity Surface",
-      description: "Built-in ERC-8004-oriented identity action surface for broader machine identity interoperability.",
-      adapter_class: "identity_registry_adapter",
-      capabilities: ["identity.erc8004.action"],
-      protocols: ["erc8004"],
-      execution_backends: ["erc8004"],
-      adapter_lanes: ["erc8004"],
-      supported_profiles: ["identity", "registry"]
-    })
-  ];
-}
-
-const EXAMPLE_INTEGRATIONS = [
-  mapManifestToIntegration(executionExampleManifest, {
-    source: "example",
-    execution_backends: ["echo"],
-    adapter_lanes: ["http"],
-    certification_state: "reference_example",
-    certification_scope: ["contract_shape"],
-    integration_maturity: "reference_example",
-    selection_priority: 950,
-    supports_default_selection: false,
-    supports_forced_selection: true,
-    lifecycle: "example_only",
-    health_source: "self_reported",
-    default_for_task_refs: [],
-    default_for_protocols: [],
-    default_for_settlement_modes: []
-  }),
-  mapManifestToIntegration(settlementExampleManifest, {
-    source: "example",
-    adapter_lanes: ["chain"],
-    certification_state: "reference_example",
-    certification_scope: ["contract_shape"],
-    integration_maturity: "reference_example",
-    selection_priority: 960,
-    supports_default_selection: false,
-    supports_forced_selection: true,
-    lifecycle: "example_only",
-    health_source: "self_reported",
-    default_for_task_refs: [],
-    default_for_protocols: [],
-    default_for_settlement_modes: []
-  }),
-  createRegisteredIntegrationFromManifest({
-    adapter_id: exampleThirdPartyRegistrationRecord.adapter_id,
-    adapter_class: exampleThirdPartyRegistrationRecord.adapter_class,
-    adapter_version: "0.1.0",
-    interface_version: "commerce-adapter-interface/v1",
-    display_name: "Acme MCP Partner Adapter",
-    description: "Reference third-party MCP integration showing how staged non-bundled registration should appear in discovery.",
-    capabilities: ["adapter.mcp.invoke"],
-    compatibility: {
-      node: ">=18",
-      commerce_contract: "xytara/v1",
-      proof_contract: "xoonya/v1"
-    },
-    health_contract: {
-      check_kind: "self_reported",
-      supports_readiness: true
-    },
-    idempotency_contract: {
-      strategy: "quote_bound_invocation",
-      scope: "protocol_invocation"
-    },
-    failure_contract: {
-      categories: ["invalid_input", "timeout", "upstream_unavailable"],
-      retryable_categories: ["timeout", "upstream_unavailable"]
-    },
-    proof_contract: {
-      emits_proof_compatible_facts: true,
-      proof_mode: "protocol_invocation_facts"
-    },
-    latency_class: "near_real_time",
-    pricing_basis: "per_task",
-    required_secrets: ["ACME_MCP_TOKEN"],
-    required_permissions: ["network:outbound"],
-    supported_profiles: ["partner"],
-    supported_regions: ["global"],
-    supported_settlement_modes: exampleThirdPartyRegistrationRecord.settlement_modes
-  }, exampleThirdPartyRegistrationRecord, {
-    source: "third_party_example",
-    status: "available",
-    certification_scope: ["self_attested_contract_shape", "staging_smoke"],
-    protocols: sortStrings(exampleThirdPartyRegistrationRecord.protocols),
-    execution_backends: ["mcp"],
-    adapter_lanes: ["mcp"],
-    task_refs: sortStrings(exampleThirdPartyRegistrationRecord.task_refs),
-    workflow_refs: [],
-    supports_forced_selection: true,
-    health_source: "self_reported"
-  }),
-  createRegisteredIntegrationFromManifest({
-    adapter_id: exampleThirdPartyIdentityRegistrationRecord.adapter_id,
-    adapter_class: exampleThirdPartyIdentityRegistrationRecord.adapter_class,
-    adapter_version: "0.1.0",
-    interface_version: "commerce-adapter-interface/v1",
-    display_name: "Attest Registry Partner Identity Adapter",
-    description: "Reference third-party identity registry integration showing how staged non-bundled identity registration should appear in discovery.",
-    capabilities: ["registry.register", "trust.handoff.emit", "trust.handoff.validate"],
-    compatibility: {
-      node: ">=18",
-      commerce_contract: "xytara/v1",
-      proof_contract: "xoonya/v1"
-    },
-    health_contract: {
-      check_kind: "self_reported",
-      supports_readiness: true
-    },
-    idempotency_contract: {
-      strategy: "record_ref_binding",
-      scope: "registry_request"
-    },
-    failure_contract: {
-      categories: ["invalid_input", "timeout", "upstream_unavailable"],
-      retryable_categories: ["timeout", "upstream_unavailable"]
-    },
-    proof_contract: {
-      emits_proof_compatible_facts: true,
-      proof_mode: "registry_reference_facts"
-    },
-    latency_class: "near_real_time",
-    pricing_basis: "per_task",
-    required_secrets: ["ATTEST_REGISTRY_TOKEN"],
-    required_permissions: ["network:outbound"],
-    supported_profiles: ["partner", "registry", "trust"],
-    supported_regions: ["global"],
-    supported_settlement_modes: []
-  }, exampleThirdPartyIdentityRegistrationRecord, {
-    source: "third_party_example",
-    status: "available",
-    certification_scope: ["self_attested_contract_shape", "staging_identity_smoke"],
-    protocols: sortStrings(exampleThirdPartyIdentityRegistrationRecord.protocols),
-    execution_backends: ["http", "chain"],
-    adapter_lanes: ["http", "chain"],
-    task_refs: sortStrings(exampleThirdPartyIdentityRegistrationRecord.task_refs),
-    workflow_refs: [],
-    supports_forced_selection: true,
-    health_source: "self_reported"
-  }),
-  createRegisteredIntegrationFromManifest({
-    adapter_id: exampleThirdPartySettlementRegistrationRecord.adapter_id,
-    adapter_class: exampleThirdPartySettlementRegistrationRecord.adapter_class,
-    adapter_version: "0.1.0",
-    interface_version: "commerce-adapter-interface/v1",
-    display_name: "Lattice Anchor Settlement Adapter",
-    description: "Reference third-party settlement integration showing how staged non-bundled settlement registration should appear in discovery.",
-    capabilities: ["anchoring.submit", "settlement.reference"],
-    compatibility: {
-      node: ">=18",
-      commerce_contract: "xytara/v1",
-      proof_contract: "xoonya/v1"
-    },
-    health_contract: {
-      check_kind: "self_reported",
-      supports_readiness: true
-    },
-    idempotency_contract: {
-      strategy: "quote_and_target_binding",
-      scope: "settlement_request"
-    },
-    failure_contract: {
-      categories: ["invalid_input", "timeout", "upstream_unavailable", "settlement_failure"],
-      retryable_categories: ["timeout", "upstream_unavailable"]
-    },
-    proof_contract: {
-      emits_proof_compatible_facts: true,
-      proof_mode: "settlement_reference_only"
-    },
-    latency_class: "governed_async",
-    pricing_basis: "per_settlement",
-    required_secrets: ["LATTICE_SETTLEMENT_TOKEN"],
-    required_permissions: ["network:outbound"],
-    supported_profiles: ["partner", "anchored"],
-    supported_regions: ["global"],
-    supported_settlement_modes: exampleThirdPartySettlementRegistrationRecord.settlement_modes
-  }, exampleThirdPartySettlementRegistrationRecord, {
-    source: "third_party_example",
-    status: "available",
-    certification_scope: ["self_attested_contract_shape", "staging_settlement_smoke"],
-    protocols: sortStrings(exampleThirdPartySettlementRegistrationRecord.protocols),
-    execution_backends: ["chain"],
-    adapter_lanes: ["chain"],
-    task_refs: sortStrings(exampleThirdPartySettlementRegistrationRecord.task_refs),
-    workflow_refs: [],
-    supports_forced_selection: true,
-    health_source: "self_reported"
-  })
-];
-
-const INTEGRATIONS = buildBuiltInIntegrations().concat(EXAMPLE_INTEGRATIONS).map(clone);
-
-const INTEGRATION_REGISTRATION_RECORDS = {
-  [exampleThirdPartyRegistrationRecord.integration_id]: clone(exampleThirdPartyRegistrationRecord),
-  [exampleThirdPartyIdentityRegistrationRecord.integration_id]: clone(exampleThirdPartyIdentityRegistrationRecord),
-  [exampleThirdPartySettlementRegistrationRecord.integration_id]: clone(exampleThirdPartySettlementRegistrationRecord)
-};
-
-function listIntegrations(filters = {}) {
-  const normalized = {
-    adapter_class: String(filters.adapter_class || filters.class || "").trim(),
-    protocol: String(filters.protocol || "").trim(),
-    settlement_mode: String(filters.settlement_mode || "").trim(),
-    capability: String(filters.capability || "").trim(),
-    task_ref: String(filters.task_ref || "").trim(),
-    source: String(filters.source || "").trim(),
-    certification_state: String(filters.certification_state || "").trim(),
-    integration_maturity: String(filters.integration_maturity || filters.maturity || "").trim(),
-    bundled: String(filters.bundled || "").trim()
-  };
-  return INTEGRATIONS.filter((integration) => {
-    if (normalized.adapter_class && integration.adapter_class !== normalized.adapter_class) return false;
-    if (normalized.protocol && !integration.protocols.includes(normalized.protocol)) return false;
-    if (normalized.settlement_mode && !integration.settlement_modes.includes(normalized.settlement_mode)) return false;
-    if (normalized.capability && !integration.capabilities.includes(normalized.capability)) return false;
-    if (normalized.task_ref && !integration.task_refs.includes(normalized.task_ref)) return false;
-    if (normalized.source && integration.source !== normalized.source) return false;
-    if (normalized.certification_state && integration.certification_state !== normalized.certification_state) return false;
-    if (normalized.integration_maturity && integration.integration_maturity !== normalized.integration_maturity) return false;
-    if (normalized.bundled && String(integration.bundled) !== normalized.bundled) return false;
-    return true;
-  }).map((integration) => buildIntegrationView(integration, INTEGRATION_REGISTRATION_RECORDS[integration.integration_id]));
-}
-
-function getIntegration(integrationId) {
-  const lookup = String(integrationId || "").trim();
-  const found = INTEGRATIONS.find((integration) => integration.integration_id === lookup);
-  return found ? buildIntegrationView(found, INTEGRATION_REGISTRATION_RECORDS[found.integration_id]) : null;
-}
-
-function summarizeIntegrations(filters = {}) {
-  const integrations = listIntegrations(filters);
-  return {
-    ok: true,
-    integration_count: integrations.length,
-    integration_ids: integrations.map((integration) => integration.integration_id),
-    class_count: sortStrings(integrations.map((integration) => integration.adapter_class)).length,
-    protocol_count: sortStrings(integrations.flatMap((integration) => integration.protocols)).length,
-    settlement_mode_count: sortStrings(integrations.flatMap((integration) => integration.settlement_modes)).length,
-    certified_integration_count: integrations.filter((integration) => integration.certification_state === "certified").length,
-    production_default_count: integrations.filter((integration) => integration.integration_maturity === "production_default").length,
-    integrations: integrations.map((integration) => ({
-      integration_id: integration.integration_id,
-      display_name: integration.display_name,
-      adapter_class: integration.adapter_class,
-      source: integration.source,
-      certification_state: integration.certification_state,
-      integration_maturity: integration.integration_maturity,
-      registration_state: integration.registration.registration_state,
-      bundled: integration.registration.bundled,
-      selection_priority: integration.selection_priority,
-      protocols: integration.protocols,
-      settlement_modes: integration.settlement_modes,
-      task_count: integration.task_refs.length,
-      workflow_count: integration.workflow_refs.length,
-      capability_count: integration.capabilities.length
-    }))
-  };
-}
-
-function summarizeIntegrationClasses(filters = {}) {
-  const integrations = listIntegrations(filters);
-  const classes = sortStrings(integrations.map((integration) => integration.adapter_class)).map((adapterClass) => ({
-    adapter_class: adapterClass,
-    integration_count: integrations.filter((integration) => integration.adapter_class === adapterClass).length
-  }));
-  return {
-    ok: true,
-    adapter_class_count: classes.length,
-    adapter_classes: classes
-  };
-}
-
-function summarizeIntegrationProtocols(filters = {}) {
-  const integrations = listIntegrations(filters);
-  const protocols = sortStrings(integrations.flatMap((integration) => integration.protocols)).map((protocol) => ({
-    protocol,
-    integration_count: integrations.filter((integration) => integration.protocols.includes(protocol)).length
-  }));
-  return {
-    ok: true,
-    protocol_count: protocols.length,
-    protocols
-  };
-}
-
-function summarizeIntegrationSettlementModes(filters = {}) {
-  const integrations = listIntegrations(filters);
-  const settlementModes = sortStrings(integrations.flatMap((integration) => integration.settlement_modes)).map((settlementMode) => ({
-    settlement_mode: settlementMode,
-    integration_count: integrations.filter((integration) => integration.settlement_modes.includes(settlementMode)).length
-  }));
-  return {
-    ok: true,
-    settlement_mode_count: settlementModes.length,
-    settlement_modes: settlementModes
-  };
-}
-
-// 1.3.0 Phase 1 anchor:
-// The next workflow layer should stay read-only and build on top of
-// summarizeIntegrationPromotionReadiness(...), adding:
-// - promotion recommendation summaries
-// - next eligible transition summaries
-// - normalized blocker categories
-// without introducing mutation flows or persistent registry state.
-
-module.exports = {
-  getIntegration,
-  listIntegrations,
-  summarizeIntegrations,
-  summarizeIntegrationClasses,
-  summarizeIntegrationProtocols,
-  summarizeIntegrationSettlementModes,
-  validateIntegrationRegistration,
-  validateIntegrationCertificationPack,
-  validateIntegrationSubmission,
-  importRegisteredIntegration,
-  createIntegrationRegistrySnapshot,
-  exportIntegrationRegistrySnapshot,
-  validateIntegrationRegistrySnapshot,
-  validateIntegrationSubmissionBundle,
-  createIntegrationSubmissionBundle,
-  importIntegrationSubmissionBundle,
-  createIntegrationRegistrySnapshotFromBundles,
-  exportIntegrationSubmissionBundles,
-  createIntegrationSubmissionBundleSet,
-  validateIntegrationSubmissionBundleSet,
-  exportIntegrationSubmissionBundleSet,
-  summarizeIntegrationSubmissionBundleReview,
-  summarizeIntegrationSubmissionBundleSetReview,
-  summarizeIntegrationRegistrySnapshotReview,
-  summarizeIntegrationPromotionReadiness,
-  summarizeIntegrationPromotionWorkflow,
-  summarizeIntegrationPromotionWorkflowList,
-  validatePromotionActionRequest,
-  summarizeIntegrationPromotionActionPreview,
-  summarizeIntegrationPromotionActionSet,
-  summarizeIntegrationPromotionActionSetList,
-  createRegisteredIntegrationFromManifest,
-  buildIntegrationRegistrationView,
-  buildIntegrationView
-};
+"use strict";
+
+const executionExampleManifest = require("../adapters/examples/example-execution-adapter.manifest.json");
+const settlementExampleManifest = require("../adapters/examples/example-settlement-adapter.manifest.json");
+const exampleThirdPartyRegistrationRecord = require("../adapters/examples/example-third-party-registration.record.json");
+const exampleThirdPartyIdentityRegistrationRecord = require("../adapters/examples/example-third-party-identity-registration.record.json");
+const exampleThirdPartySettlementRegistrationRecord = require("../adapters/examples/example-third-party-settlement-registration.record.json");
+const { catalog } = require("../fixtures/catalog");
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+function sortStrings(values) {
+  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
+}
+
+function collectTaskRefsByAdapter(adapterName) {
+  return (Array.isArray(catalog.tasks) ? catalog.tasks : [])
+    .filter((task) => Array.isArray(task.adapters) && task.adapters.includes(adapterName))
+    .map((task) => task.public_task_ref);
+}
+
+function collectWorkflowRefsByTaskRefs(taskRefs) {
+  const allowed = new Set(Array.isArray(taskRefs) ? taskRefs : []);
+  return (Array.isArray(catalog.workflows) ? catalog.workflows : [])
+    .filter((workflow) => Array.isArray(workflow.task_refs) && workflow.task_refs.some((taskRef) => allowed.has(taskRef)))
+    .map((workflow) => workflow.workflow_ref);
+}
+
+function createBuiltinBreadthIntegration({
+  integration_id,
+  display_name,
+  description,
+  adapter_class,
+  capabilities = [],
+  protocols = [],
+  settlement_modes = [],
+  execution_backends = [],
+  adapter_lanes = [],
+  task_refs = [],
+  workflow_refs = [],
+  required_secrets = [],
+  required_permissions = [],
+  supported_profiles = ["default"],
+  pricing_basis = "per_task",
+  latency_class = "mixed",
+  proof_mode = "adjacent_reference_only"
+}) {
+  return {
+    integration_id,
+    display_name,
+    description,
+    adapter_class,
+    adapter_version: "1.26.0",
+    interface_version: "commerce-adapter-interface/v1",
+    bundled: true,
+    source: "builtin",
+    status: "available",
+    certification_state: "certified",
+    certification_scope: ["builtin_registry", "service_contract", "sdk_contract"],
+    integration_maturity: "production_supported",
+    selection_priority: 250,
+    capabilities: sortStrings(capabilities),
+    protocols: sortStrings(protocols),
+    settlement_modes: sortStrings(settlement_modes),
+    execution_backends: sortStrings(execution_backends),
+    adapter_lanes: sortStrings(adapter_lanes),
+    task_refs: sortStrings(task_refs),
+    workflow_refs: sortStrings(workflow_refs),
+    required_secrets: sortStrings(required_secrets),
+    required_permissions: sortStrings(required_permissions),
+    supported_profiles: sortStrings(supported_profiles),
+    supported_regions: ["global"],
+    pricing_basis,
+    latency_class,
+    proof_contract: {
+      emits_proof_compatible_facts: true,
+      proof_mode
+    },
+    health_contract: {
+      check_kind: "internal",
+      supports_readiness: true
+    },
+    idempotency_contract: {
+      strategy: "quote_bound_selection",
+      scope: "integration_selection"
+    },
+    failure_contract: {
+      categories: ["invalid_input", "timeout", "upstream_unavailable"],
+      retryable_categories: ["timeout", "upstream_unavailable"]
+    },
+    compatibility: {
+      node: ">=18",
+      commerce_contract: "xytara/v1"
+    },
+    operational_readiness: {
+      supports_default_selection: false,
+      supports_forced_selection: true,
+      lifecycle: "managed_builtin",
+      health_source: "internal"
+    },
+    selection_hints: {
+      default_for_task_refs: [],
+      default_for_protocols: [],
+      default_for_settlement_modes: []
+    }
+  };
+}
+
+function mapManifestToIntegration(manifest, extras = {}) {
+  const taskRefs = sortStrings(extras.task_refs);
+  return {
+    integration_id: manifest.adapter_id,
+    display_name: manifest.display_name,
+    description: manifest.description,
+    adapter_class: manifest.adapter_class,
+    adapter_version: manifest.adapter_version,
+    interface_version: manifest.interface_version,
+    bundled: extras.bundled !== false,
+    source: extras.source || "example",
+    status: extras.status || "available",
+    certification_state: extras.certification_state || "reference_example",
+    certification_scope: sortStrings(extras.certification_scope || ["contract_shape"]),
+    integration_maturity: extras.integration_maturity || "reference_example",
+    selection_priority: Number.isFinite(Number(extras.selection_priority)) ? Number(extras.selection_priority) : 900,
+    capabilities: sortStrings(manifest.capabilities),
+    protocols: sortStrings(extras.protocols),
+    settlement_modes: sortStrings(manifest.supported_settlement_modes),
+    execution_backends: sortStrings(extras.execution_backends),
+    adapter_lanes: sortStrings(extras.adapter_lanes),
+    task_refs: taskRefs,
+    workflow_refs: sortStrings(extras.workflow_refs || collectWorkflowRefsByTaskRefs(taskRefs)),
+    required_secrets: sortStrings(manifest.required_secrets),
+    required_permissions: sortStrings(manifest.required_permissions),
+    supported_profiles: sortStrings(manifest.supported_profiles),
+    supported_regions: sortStrings(manifest.supported_regions),
+    pricing_basis: manifest.pricing_basis || null,
+    latency_class: manifest.latency_class || null,
+    proof_contract: manifest.proof_contract || null,
+    health_contract: manifest.health_contract || null,
+    idempotency_contract: manifest.idempotency_contract || null,
+    failure_contract: manifest.failure_contract || null,
+    compatibility: manifest.compatibility || {},
+    operational_readiness: {
+      supports_default_selection: extras.supports_default_selection === true,
+      supports_forced_selection: extras.supports_forced_selection !== false,
+      lifecycle: extras.lifecycle || "reference",
+      health_source: extras.health_source || "self_reported"
+    },
+    selection_hints: {
+      default_for_task_refs: sortStrings(extras.default_for_task_refs || taskRefs),
+      default_for_protocols: sortStrings(extras.default_for_protocols || extras.protocols),
+      default_for_settlement_modes: sortStrings(extras.default_for_settlement_modes || manifest.supported_settlement_modes)
+    }
+  };
+}
+
+function buildIntegrationRegistrationView(integration, registrationRecord) {
+  const integrationEntry = integration || {};
+  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : null;
+  const selectionPriority = record && Number.isFinite(Number(record.selection_priority))
+    ? Number(record.selection_priority)
+    : integrationEntry.selection_priority;
+  return {
+    registration_state: record ? record.registration_state : "unregistered",
+    bundled: record ? record.bundled : integrationEntry.bundled === true,
+    default_selection_enabled: record
+      ? record.default_selection_enabled === true
+      : !!(
+          integrationEntry.operational_readiness &&
+          integrationEntry.operational_readiness.supports_default_selection
+        ),
+    requires_explicit_selection: record
+      ? record.requires_explicit_selection === true
+      : !(
+          integrationEntry.operational_readiness &&
+          integrationEntry.operational_readiness.supports_default_selection
+        ),
+    selection_priority: selectionPriority,
+    registered_at: record ? record.registered_at : null,
+    registered_by: record ? record.registered_by || null : null,
+    verified_with: sortStrings(record && record.verified_with),
+    notes: record ? record.notes || null : null
+  };
+}
+
+function buildIntegrationView(integration, registrationRecord) {
+  const entry = clone(integration);
+  entry.registration = buildIntegrationRegistrationView(entry, registrationRecord);
+  return entry;
+}
+
+function createRegisteredIntegrationFromManifest(manifest, registrationRecord, extras = {}) {
+  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : {};
+  const integration = mapManifestToIntegration(manifest, {
+    ...extras,
+    bundled: Object.prototype.hasOwnProperty.call(record, "bundled")
+      ? record.bundled
+      : extras.bundled,
+    certification_state: record.certification_state || extras.certification_state,
+    certification_scope: record.certification_scope || extras.certification_scope,
+    integration_maturity: record.integration_maturity || extras.integration_maturity,
+    selection_priority: Object.prototype.hasOwnProperty.call(record, "selection_priority")
+      ? record.selection_priority
+      : extras.selection_priority,
+    supports_default_selection: Object.prototype.hasOwnProperty.call(record, "default_selection_enabled")
+      ? record.default_selection_enabled
+      : extras.supports_default_selection,
+    lifecycle: record.registration_state || extras.lifecycle,
+    default_for_task_refs: record.default_selection_enabled === true
+      ? extras.default_for_task_refs
+      : [],
+    default_for_protocols: record.default_selection_enabled === true
+      ? extras.default_for_protocols
+      : [],
+    default_for_settlement_modes: record.default_selection_enabled === true
+      ? extras.default_for_settlement_modes
+      : []
+  });
+  return buildIntegrationView(integration, record);
+}
+
+function validateIntegrationRegistration(manifest, registrationRecord) {
+  const errors = [];
+  const manifestEntry = manifest && typeof manifest === "object" ? manifest : {};
+  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : {};
+
+  if (!manifestEntry.adapter_id) {
+    errors.push("manifest.adapter_id is required");
+  }
+  if (!record.integration_id) {
+    errors.push("registration_record.integration_id is required");
+  }
+  if (!record.adapter_id) {
+    errors.push("registration_record.adapter_id is required");
+  }
+  if (!record.adapter_class) {
+    errors.push("registration_record.adapter_class is required");
+  }
+  if (manifestEntry.adapter_id && record.adapter_id && manifestEntry.adapter_id !== record.adapter_id) {
+    errors.push("manifest.adapter_id must match registration_record.adapter_id");
+  }
+  if (manifestEntry.adapter_id && record.integration_id && manifestEntry.adapter_id !== record.integration_id) {
+    errors.push("manifest.adapter_id must match registration_record.integration_id");
+  }
+  if (manifestEntry.adapter_class && record.adapter_class && manifestEntry.adapter_class !== record.adapter_class) {
+    errors.push("manifest.adapter_class must match registration_record.adapter_class");
+  }
+
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+function validateIntegrationCertificationPack(certificationPack) {
+  const pack = certificationPack && typeof certificationPack === "object" ? certificationPack : {};
+  const errors = [];
+  if (!pack.integration_id) errors.push("certification_pack.integration_id is required");
+  if (!pack.adapter_id) errors.push("certification_pack.adapter_id is required");
+  if (!pack.adapter_class) errors.push("certification_pack.adapter_class is required");
+  if (!pack.certification_state) errors.push("certification_pack.certification_state is required");
+  if (!Array.isArray(pack.certification_scope) || pack.certification_scope.length < 1) {
+    errors.push("certification_pack.certification_scope must contain at least one entry");
+  }
+  if (!Array.isArray(pack.verified_with) || pack.verified_with.length < 1) {
+    errors.push("certification_pack.verified_with must contain at least one entry");
+  }
+  if (!pack.submitted_at) errors.push("certification_pack.submitted_at is required");
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+function validateIntegrationSubmission(manifest, registrationRecord, certificationPack) {
+  const registrationValidation = validateIntegrationRegistration(manifest, registrationRecord);
+  const certificationValidation = validateIntegrationCertificationPack(certificationPack);
+  const errors = registrationValidation.errors.concat(certificationValidation.errors);
+  const manifestEntry = manifest && typeof manifest === "object" ? manifest : {};
+  const record = registrationRecord && typeof registrationRecord === "object" ? registrationRecord : {};
+  const pack = certificationPack && typeof certificationPack === "object" ? certificationPack : {};
+
+  if (manifestEntry.adapter_id && pack.adapter_id && manifestEntry.adapter_id !== pack.adapter_id) {
+    errors.push("manifest.adapter_id must match certification_pack.adapter_id");
+  }
+  if (record.integration_id && pack.integration_id && record.integration_id !== pack.integration_id) {
+    errors.push("registration_record.integration_id must match certification_pack.integration_id");
+  }
+  if (record.adapter_class && pack.adapter_class && record.adapter_class !== pack.adapter_class) {
+    errors.push("registration_record.adapter_class must match certification_pack.adapter_class");
+  }
+  if (record.certification_state && pack.certification_state && record.certification_state !== pack.certification_state) {
+    errors.push("registration_record.certification_state must match certification_pack.certification_state");
+  }
+
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+function importRegisteredIntegration(manifest, registrationRecord, extras = {}) {
+  const validation = validateIntegrationRegistration(manifest, registrationRecord);
+  if (!validation.ok) {
+    const error = new Error(`invalid integration registration:\n${validation.errors.join("\n")}`);
+    error.code = "invalid_integration_registration";
+    error.validation = validation;
+    throw error;
+  }
+  return createRegisteredIntegrationFromManifest(manifest, registrationRecord, extras);
+}
+
+function createIntegrationRegistrySnapshot(integrations, filters = {}) {
+  const rows = Array.isArray(integrations) ? integrations.map(clone) : [];
+  return {
+    snapshot_version: "xytara/integration-registry-snapshot/v1",
+    generated_at: new Date().toISOString(),
+    integration_count: rows.length,
+    filters: clone(filters || {}),
+    integrations: rows
+  };
+}
+
+function exportIntegrationRegistrySnapshot(filters = {}) {
+  return createIntegrationRegistrySnapshot(listIntegrations(filters), filters);
+}
+
+function validateIntegrationRegistrySnapshot(snapshot) {
+  const entry = snapshot && typeof snapshot === "object" ? snapshot : {};
+  const errors = [];
+  if (!entry.snapshot_version) errors.push("snapshot.snapshot_version is required");
+  if (!entry.generated_at) errors.push("snapshot.generated_at is required");
+  if (!Number.isInteger(entry.integration_count) || entry.integration_count < 0) {
+    errors.push("snapshot.integration_count must be a non-negative integer");
+  }
+  if (!Array.isArray(entry.integrations)) {
+    errors.push("snapshot.integrations must be an array");
+  } else if (entry.integration_count !== entry.integrations.length) {
+    errors.push("snapshot.integration_count must match snapshot.integrations.length");
+  }
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+function validateIntegrationSubmissionBundle(bundle) {
+  const entry = bundle && typeof bundle === "object" ? bundle : {};
+  const errors = [];
+  if (!entry.bundle_version) {
+    errors.push("submission_bundle.bundle_version is required");
+  }
+  if (!entry.manifest || typeof entry.manifest !== "object") {
+    errors.push("submission_bundle.manifest is required");
+  }
+  if (!entry.registration_record || typeof entry.registration_record !== "object") {
+    errors.push("submission_bundle.registration_record is required");
+  }
+  if (!entry.certification_pack || typeof entry.certification_pack !== "object") {
+    errors.push("submission_bundle.certification_pack is required");
+  }
+  const submissionValidation = validateIntegrationSubmission(
+    entry.manifest,
+    entry.registration_record,
+    entry.certification_pack
+  );
+  return {
+    ok: errors.length === 0 && submissionValidation.ok,
+    errors: errors.concat(submissionValidation.errors)
+  };
+}
+
+function createIntegrationSubmissionBundle(bundleInput = {}, extras = {}) {
+  const manifest = clone(bundleInput.manifest || {});
+  const registrationRecord = clone(bundleInput.registration_record || {});
+  const certificationPack = clone(bundleInput.certification_pack || {});
+  const importedIntegration = importRegisteredIntegration(manifest, registrationRecord, extras);
+  const snapshotEntry = clone(bundleInput.snapshot_entry || importedIntegration);
+  return {
+    bundle_version: "xytara/integration-submission-bundle/v1",
+    manifest,
+    registration_record: registrationRecord,
+    certification_pack: certificationPack,
+    snapshot_entry: snapshotEntry,
+    notes: typeof bundleInput.notes === "string" ? bundleInput.notes : null
+  };
+}
+
+function importIntegrationSubmissionBundle(bundleInput = {}, extras = {}) {
+  const bundle = createIntegrationSubmissionBundle(bundleInput, extras);
+  const validation = validateIntegrationSubmissionBundle(bundle);
+  if (!validation.ok) {
+    const error = new Error(`invalid integration submission bundle:\n${validation.errors.join("\n")}`);
+    error.code = "invalid_integration_submission_bundle";
+    error.validation = validation;
+    throw error;
+  }
+  return bundle;
+}
+
+function createIntegrationRegistrySnapshotFromBundles(bundles, filters = {}, bundleExtras = {}) {
+  const bundleList = Array.isArray(bundles) ? bundles : [];
+  const integrations = bundleList.map((bundle) => importIntegrationSubmissionBundle(bundle, bundleExtras).snapshot_entry);
+  return createIntegrationRegistrySnapshot(integrations, {
+    ...clone(filters || {}),
+    snapshot_source: "submission_bundle"
+  });
+}
+
+function exportIntegrationSubmissionBundles(filters = {}) {
+  return listIntegrations(filters)
+    .filter((integration) => integration.source === "third_party_example")
+    .map((integration) => {
+      const registrationRecord = clone(INTEGRATION_REGISTRATION_RECORDS[integration.integration_id] || {});
+      const certificationPack = {
+        integration_id: integration.integration_id,
+        adapter_id: integration.integration_id,
+        adapter_class: integration.adapter_class,
+        certification_state: integration.certification_state,
+        certification_scope: clone(integration.certification_scope || []),
+        verified_with: clone(integration.registration.verified_with || []),
+        submitted_at: integration.registration.registered_at || new Date().toISOString(),
+        submitted_by: integration.registration.registered_by || "unknown",
+        last_verified_contract_version: "xytara/v1",
+        notes: integration.registration.notes || null
+      };
+      const manifest = {
+        adapter_id: integration.integration_id,
+        adapter_class: integration.adapter_class,
+        adapter_version: integration.adapter_version,
+        interface_version: integration.interface_version,
+        display_name: integration.display_name,
+        description: integration.description,
+        capabilities: clone(integration.capabilities || []),
+        required_secrets: clone(integration.required_secrets || []),
+        required_permissions: clone(integration.required_permissions || []),
+        supported_profiles: clone(integration.supported_profiles || []),
+        supported_regions: clone(integration.supported_regions || []),
+        supported_settlement_modes: clone(integration.settlement_modes || []),
+        pricing_basis: integration.pricing_basis,
+        latency_class: integration.latency_class,
+        registration_contract: {
+          integration_id: integration.integration_id,
+          integration_maturity: integration.integration_maturity,
+          bundled: integration.registration.bundled,
+          default_selection_enabled: integration.registration.default_selection_enabled,
+          requires_explicit_selection: integration.registration.requires_explicit_selection
+        },
+        certification_contract: {
+          certification_state: integration.certification_state,
+          certification_scope: clone(integration.certification_scope || []),
+          verified_with: clone(integration.registration.verified_with || []),
+          last_verified_contract_version: "xytara/v1"
+        },
+        compatibility: clone(integration.compatibility || {}),
+        health_contract: clone(integration.health_contract || {}),
+        idempotency_contract: clone(integration.idempotency_contract || {}),
+        failure_contract: clone(integration.failure_contract || {}),
+        proof_contract: clone(integration.proof_contract || {})
+      };
+      return createIntegrationSubmissionBundle({
+        manifest,
+        registration_record: registrationRecord,
+        certification_pack: certificationPack,
+        snapshot_entry: integration,
+        notes: integration.registration.notes || null
+      }, {
+        source: integration.source,
+        protocols: clone(integration.protocols || []),
+        execution_backends: clone(integration.execution_backends || []),
+        adapter_lanes: clone(integration.adapter_lanes || []),
+        task_refs: clone(integration.task_refs || []),
+        workflow_refs: clone(integration.workflow_refs || [])
+      });
+    });
+}
+
+function createIntegrationSubmissionBundleSet(bundles, filters = {}, notes = null) {
+  const bundleList = Array.isArray(bundles) ? bundles.map(clone) : [];
+  return {
+    bundle_set_version: "xytara/integration-submission-bundle-set/v1",
+    generated_at: new Date().toISOString(),
+    bundle_count: bundleList.length,
+    filters: clone(filters || {}),
+    bundles: bundleList,
+    notes: typeof notes === "string" ? notes : null
+  };
+}
+
+function validateIntegrationSubmissionBundleSet(bundleSet) {
+  const entry = bundleSet && typeof bundleSet === "object" ? bundleSet : {};
+  const errors = [];
+  if (!entry.bundle_set_version) errors.push("bundle_set.bundle_set_version is required");
+  if (!entry.generated_at) errors.push("bundle_set.generated_at is required");
+  if (!Number.isInteger(entry.bundle_count) || entry.bundle_count < 0) {
+    errors.push("bundle_set.bundle_count must be a non-negative integer");
+  }
+  if (!Array.isArray(entry.bundles)) {
+    errors.push("bundle_set.bundles must be an array");
+  } else if (entry.bundle_count !== entry.bundles.length) {
+    errors.push("bundle_set.bundle_count must match bundle_set.bundles.length");
+  } else {
+    entry.bundles.forEach((bundle, index) => {
+      const validation = validateIntegrationSubmissionBundle(bundle);
+      if (!validation.ok) {
+        validation.errors.forEach((error) => {
+          errors.push(`bundle_set.bundles[${index}]: ${error}`);
+        });
+      }
+    });
+  }
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+function exportIntegrationSubmissionBundleSet(filters = {}, notes = null) {
+  return createIntegrationSubmissionBundleSet(
+    exportIntegrationSubmissionBundles(filters),
+    filters,
+    notes
+  );
+}
+
+function summarizeCounts(values, fieldName) {
+  return sortStrings(values).map((value) => ({
+    [fieldName]: value,
+    count: values.filter((entry) => entry === value).length
+  }));
+}
+
+function summarizeStructuredCounts(entries, fields = []) {
+  const rows = Array.isArray(entries) ? entries.filter((entry) => entry && typeof entry === "object") : [];
+  const normalizedFields = Array.isArray(fields) ? fields.filter(Boolean) : [];
+  const seen = new Map();
+
+  rows.forEach((entry) => {
+    const key = normalizedFields.map((field) => String(entry[field] || "")).join("::");
+    if (!seen.has(key)) {
+      const item = {};
+      normalizedFields.forEach((field) => {
+        item[field] = entry[field] || null;
+      });
+      item.count = 0;
+      seen.set(key, item);
+    }
+    seen.get(key).count += 1;
+  });
+
+  return Array.from(seen.values()).sort((left, right) => {
+    const leftKey = normalizedFields.map((field) => String(left[field] || "")).join("::");
+    const rightKey = normalizedFields.map((field) => String(right[field] || "")).join("::");
+    return leftKey.localeCompare(rightKey);
+  });
+}
+
+function buildPromotionReadinessSummary(input = {}) {
+  const registration = input.registration && typeof input.registration === "object" ? input.registration : {};
+  const certification = input.certification && typeof input.certification === "object" ? input.certification : {};
+  const integration = input.integration && typeof input.integration === "object" ? input.integration : {};
+  const blockers = [];
+  const registrationState = registration.registration_state || null;
+  const certificationState = certification.certification_state || integration.certification_state || null;
+  const maturity = integration.integration_maturity || null;
+  const defaultSelectionEnabled = registration.default_selection_enabled === true;
+  const requiresExplicitSelection = registration.requires_explicit_selection === true;
+  const bundled = registration.bundled === true;
+
+  if (!registrationState) blockers.push("registration_state_missing");
+  if (!certificationState) blockers.push("certification_state_missing");
+  if (!maturity) blockers.push("integration_maturity_missing");
+  if (certificationState !== "certified") blockers.push("not_certified");
+  if (maturity !== "production_default") blockers.push("not_marked_production_default");
+  if (!defaultSelectionEnabled) blockers.push("default_selection_disabled");
+  if (requiresExplicitSelection) blockers.push("still_requires_explicit_selection");
+  if (!bundled) blockers.push("not_bundled_for_default_rollout");
+
+  const reviewReady = registrationState === "staging_registered";
+  const selectionReady = defaultSelectionEnabled || requiresExplicitSelection;
+  const explicitSelectionReady = requiresExplicitSelection || defaultSelectionEnabled;
+  const productionDefaultReady = blockers.length === 0;
+
+  let posture = "unknown";
+  if (productionDefaultReady) {
+    posture = "production_default_ready";
+  } else if (reviewReady && certificationState === "certified") {
+    posture = "promotion_candidate";
+  } else if (reviewReady) {
+    posture = "staged_review";
+  } else if (selectionReady) {
+    posture = "selectable_non_default";
+  }
+
+  return {
+    registration_state: registrationState,
+    certification_state: certificationState,
+    integration_maturity: maturity,
+    selection_ready: selectionReady,
+    explicit_selection_ready: explicitSelectionReady,
+    default_eligible: defaultSelectionEnabled,
+    production_default_ready: productionDefaultReady,
+    review_ready: reviewReady,
+    posture,
+    blockers
+  };
+}
+
+function summarizePromotionBlockerCategories(blockers = []) {
+  const values = Array.isArray(blockers) ? blockers : [];
+  const categories = [];
+  if (values.some((entry) => entry === "registration_state_missing")) {
+    categories.push({
+      category: "registration",
+      severity: "high",
+      owner: "integration_author"
+    });
+  }
+  if (values.some((entry) => entry === "certification_state_missing" || entry === "not_certified")) {
+    categories.push({
+      category: "certification",
+      severity: "high",
+      owner: "review_operator"
+    });
+  }
+  if (values.some((entry) => entry === "integration_maturity_missing" || entry === "not_marked_production_default")) {
+    categories.push({
+      category: "maturity",
+      severity: "medium",
+      owner: "review_operator"
+    });
+  }
+  if (values.some((entry) => entry === "default_selection_disabled" || entry === "still_requires_explicit_selection")) {
+    categories.push({
+      category: "selection",
+      severity: "medium",
+      owner: "platform_operator"
+    });
+  }
+  if (values.some((entry) => entry === "not_bundled_for_default_rollout")) {
+    categories.push({
+      category: "rollout",
+      severity: "low",
+      owner: "release_operator"
+    });
+  }
+  return summarizeStructuredCounts(categories, ["category", "severity", "owner"]);
+}
+
+function buildCertificationGapSummary(readiness = {}, integration = {}) {
+  const blockers = Array.isArray(readiness.blockers) ? readiness.blockers : [];
+  const certificationScope = Array.isArray(integration.certification_scope) ? integration.certification_scope.filter(Boolean) : [];
+  const verifiedWith = integration.registration && Array.isArray(integration.registration.verified_with)
+    ? integration.registration.verified_with.filter(Boolean)
+    : [];
+  const missingRequirements = [];
+  const productionReady = readiness.production_default_ready === true;
+
+  if (blockers.includes("certification_state_missing") || blockers.includes("not_certified")) {
+    missingRequirements.push("certification_state");
+  }
+  if (!productionReady && certificationScope.length < 1) {
+    missingRequirements.push("certification_scope");
+  }
+  if (!productionReady && verifiedWith.length < 1) {
+    missingRequirements.push("verified_with");
+  }
+
+  return {
+    certification_state: readiness.certification_state || null,
+    certification_scope_count: certificationScope.length,
+    verified_with_count: verifiedWith.length,
+    missing_requirements: missingRequirements,
+    certifiable: missingRequirements.length === 0
+  };
+}
+
+function buildNextTransitionSummary(readiness = {}) {
+  const blockers = Array.isArray(readiness.blockers) ? readiness.blockers : [];
+  if (readiness.production_default_ready === true) {
+    return {
+      action: "maintain_production_default",
+      reason: "integration already satisfies production-default posture",
+      requirements: [],
+      later_actions: []
+    };
+  }
+  if (blockers.includes("registration_state_missing")) {
+    return {
+      action: "register_integration",
+      reason: "integration is missing a registration state",
+      requirements: ["registration_state"],
+      later_actions: ["complete_certification", "promote_maturity", "enable_default_selection", "bundle_for_default_rollout"]
+    };
+  }
+  if (blockers.includes("not_certified") || blockers.includes("certification_state_missing")) {
+    return {
+      action: "complete_certification",
+      reason: "integration is not yet certified",
+      requirements: ["certification_state"],
+      later_actions: ["promote_maturity", "enable_default_selection", "bundle_for_default_rollout"]
+    };
+  }
+  if (blockers.includes("not_marked_production_default") || blockers.includes("integration_maturity_missing")) {
+    return {
+      action: "promote_maturity",
+      reason: "integration maturity is not yet aligned with production default rollout",
+      requirements: ["integration_maturity"],
+      later_actions: ["enable_default_selection", "bundle_for_default_rollout"]
+    };
+  }
+  if (blockers.includes("default_selection_disabled") || blockers.includes("still_requires_explicit_selection")) {
+    return {
+      action: "enable_default_selection",
+      reason: "integration remains explicit-selection only",
+      requirements: ["default_selection_enabled", "requires_explicit_selection=false"],
+      later_actions: blockers.includes("not_bundled_for_default_rollout") ? ["bundle_for_default_rollout"] : []
+    };
+  }
+  if (blockers.includes("not_bundled_for_default_rollout")) {
+    return {
+      action: "bundle_for_default_rollout",
+      reason: "integration is not yet bundled for production default rollout",
+      requirements: ["bundled=true"],
+      later_actions: []
+    };
+  }
+  return {
+    action: "review_manually",
+    reason: "integration posture needs operator review",
+    requirements: [],
+    later_actions: []
+  };
+}
+
+function buildPromotionRecommendationSummary(readiness = {}) {
+  const nextTransition = buildNextTransitionSummary(readiness);
+  if (readiness.production_default_ready === true) {
+    return {
+      recommendation: "eligible_for_production_default",
+      rationale: "integration is ready for production-default posture"
+    };
+  }
+  if (readiness.review_ready === true && readiness.default_eligible === false) {
+    return {
+      recommendation: "keep_staged_until_requirements_clear",
+      rationale: nextTransition.reason
+    };
+  }
+  if (readiness.review_ready === true) {
+    return {
+      recommendation: "review_for_promotion",
+      rationale: nextTransition.reason
+    };
+  }
+  return {
+    recommendation: "complete_prerequisites_first",
+    rationale: nextTransition.reason
+  };
+}
+
+const PROMOTION_ACTION_DEFINITIONS = {
+  register_integration: {
+    action: "register_integration",
+    title: "Register Integration",
+    stage: "registration",
+    description: "Move an integration into an explicit staged registration posture."
+  },
+  complete_certification: {
+    action: "complete_certification",
+    title: "Complete Certification",
+    stage: "certification",
+    description: "Mark the integration as certified for the current public contract."
+  },
+  promote_maturity: {
+    action: "promote_maturity",
+    title: "Promote Maturity",
+    stage: "maturity",
+    description: "Align integration maturity with production-default rollout posture."
+  },
+  enable_default_selection: {
+    action: "enable_default_selection",
+    title: "Enable Default Selection",
+    stage: "selection",
+    description: "Allow the integration to participate in default selection instead of explicit-only use."
+  },
+  bundle_for_default_rollout: {
+    action: "bundle_for_default_rollout",
+    title: "Bundle For Default Rollout",
+    stage: "rollout",
+    description: "Mark the integration as bundled for production-default rollout."
+  },
+  maintain_production_default: {
+    action: "maintain_production_default",
+    title: "Maintain Production Default",
+    stage: "steady_state",
+    description: "Confirm the integration already satisfies production-default posture."
+  }
+};
+
+function getPromotionActionDefinition(action) {
+  const lookup = String(action || "").trim();
+  return PROMOTION_ACTION_DEFINITIONS[lookup] || null;
+}
+
+function clonePromotionSubject(summary = {}) {
+  return {
+    registration: clone(summary.registration || {}),
+    certification_state: summary.certification_state || null,
+    integration_maturity: summary.integration_maturity || null
+  };
+}
+
+function simulatePromotionActionSubject(summary = {}, action) {
+  const subject = clonePromotionSubject(summary);
+  switch (action) {
+    case "register_integration":
+      subject.registration.registration_state = "staging_registered";
+      if (subject.registration.default_selection_enabled !== true) {
+        subject.registration.default_selection_enabled = false;
+      }
+      if (subject.registration.requires_explicit_selection !== false) {
+        subject.registration.requires_explicit_selection = true;
+      }
+      break;
+    case "complete_certification":
+      subject.certification_state = "certified";
+      break;
+    case "promote_maturity":
+      subject.integration_maturity = "production_default";
+      break;
+    case "enable_default_selection":
+      subject.registration.default_selection_enabled = true;
+      subject.registration.requires_explicit_selection = false;
+      break;
+    case "bundle_for_default_rollout":
+      subject.registration.bundled = true;
+      break;
+    case "maintain_production_default":
+      break;
+    default:
+      break;
+  }
+  return subject;
+}
+
+function buildPromotionActionResultingReadiness(summary = {}, subject = {}) {
+  return buildPromotionReadinessSummary({
+    registration: subject.registration,
+    certification: {
+      certification_state: subject.certification_state || summary.certification_state || null
+    },
+    integration: {
+      integration_maturity: subject.integration_maturity || summary.integration_maturity || null
+    }
+  });
+}
+
+function buildPromotionActionStateChanges(current = {}, simulated = {}) {
+  const changes = [];
+  const currentRegistration = current.registration || {};
+  const simulatedRegistration = simulated.registration || {};
+  const fieldPairs = [
+    ["registration.registration_state", currentRegistration.registration_state, simulatedRegistration.registration_state],
+    ["registration.default_selection_enabled", currentRegistration.default_selection_enabled, simulatedRegistration.default_selection_enabled],
+    ["registration.requires_explicit_selection", currentRegistration.requires_explicit_selection, simulatedRegistration.requires_explicit_selection],
+    ["registration.bundled", currentRegistration.bundled, simulatedRegistration.bundled],
+    ["certification_state", current.certification_state, simulated.certification_state],
+    ["integration_maturity", current.integration_maturity, simulated.integration_maturity]
+  ];
+  fieldPairs.forEach(([field, fromValue, toValue]) => {
+    if (fromValue !== toValue) {
+      changes.push({
+        field,
+        from: fromValue === undefined ? null : fromValue,
+        to: toValue === undefined ? null : toValue
+      });
+    }
+  });
+  return changes;
+}
+
+function validatePromotionActionRequest(request = {}) {
+  const entry = request && typeof request === "object" && !Array.isArray(request) ? request : {};
+  const errors = [];
+  const integrationId = String(entry.integration_id || "").trim();
+  const action = String(entry.action || "").trim();
+  if (!integrationId) {
+    errors.push("promotion_action_request.integration_id is required");
+  }
+  if (!action) {
+    errors.push("promotion_action_request.action is required");
+  } else if (!getPromotionActionDefinition(action)) {
+    errors.push("promotion_action_request.action must be a supported promotion action");
+  }
+  return {
+    ok: errors.length === 0,
+    errors,
+    request: {
+      integration_id: integrationId || null,
+      action: action || null
+    }
+  };
+}
+
+function summarizeIntegrationPromotionActionPreview(request = {}) {
+  const validation = validatePromotionActionRequest(request);
+  if (!validation.ok) {
+    return {
+      ok: false,
+      reason: "invalid_promotion_action_request",
+      errors: validation.errors
+    };
+  }
+  const workflow = summarizeIntegrationPromotionWorkflow(validation.request.integration_id);
+  if (!workflow.ok) {
+    return workflow;
+  }
+
+  const action = validation.request.action;
+  const definition = getPromotionActionDefinition(action);
+  const currentSubject = clonePromotionSubject(workflow);
+  const simulatedSubject = simulatePromotionActionSubject(workflow, action);
+  const resultingReadiness = buildPromotionActionResultingReadiness(workflow, simulatedSubject);
+  const stateChanges = buildPromotionActionStateChanges(currentSubject, simulatedSubject);
+  const currentNextAction = workflow.next_transition && workflow.next_transition.action
+    ? workflow.next_transition.action
+    : null;
+  const currentLaterActions = Array.isArray(workflow.next_transition && workflow.next_transition.later_actions)
+    ? workflow.next_transition.later_actions
+    : [];
+  const validNow = currentNextAction === action || currentLaterActions.includes(action);
+  const invalidReasons = [];
+  if (!validNow) {
+    invalidReasons.push(action === "maintain_production_default"
+      ? "integration_is_not_yet_production_default_ready"
+      : "action_is_not_currently_recommended_from_present_posture");
+  }
+
+  return {
+    ok: true,
+    integration_id: workflow.integration_id,
+    display_name: workflow.display_name,
+    adapter_class: workflow.adapter_class,
+    source: workflow.source,
+    request: clone(validation.request),
+    action: clone(definition),
+    current_posture: {
+      registration_state: workflow.registration.registration_state || null,
+      certification_state: workflow.certification_state || null,
+      integration_maturity: workflow.integration_maturity || null,
+      promotion_readiness: clone(workflow.promotion_readiness || {})
+    },
+    valid_now: validNow,
+    is_recommended_next: currentNextAction === action,
+    invalid_reasons: invalidReasons,
+    requirements: currentNextAction === action
+      ? clone(workflow.next_transition.requirements || [])
+      : clone(buildNextTransitionSummary(resultingReadiness).requirements || []),
+    blockers: clone(workflow.promotion_readiness.blockers || []),
+    blocker_categories: clone(workflow.blocker_categories || []),
+    resulting_posture: {
+      registration_state: simulatedSubject.registration.registration_state || null,
+      certification_state: simulatedSubject.certification_state || null,
+      integration_maturity: simulatedSubject.integration_maturity || null,
+      promotion_readiness: clone(resultingReadiness)
+    },
+    state_changes: stateChanges,
+    current_transition: clone(workflow.next_transition || {}),
+    resulting_transition: buildNextTransitionSummary(resultingReadiness)
+  };
+}
+
+function summarizeIntegrationPromotionActionSet(integrationOrId) {
+  const workflow = summarizeIntegrationPromotionWorkflow(integrationOrId);
+  if (!workflow.ok) {
+    return workflow;
+  }
+  const actionOrder = [
+    workflow.next_transition && workflow.next_transition.action ? workflow.next_transition.action : null,
+    ...(Array.isArray(workflow.next_transition && workflow.next_transition.later_actions)
+      ? workflow.next_transition.later_actions
+      : []),
+    "maintain_production_default"
+  ].filter(Boolean);
+  const actions = sortStrings(actionOrder).map((action) => summarizeIntegrationPromotionActionPreview({
+    integration_id: workflow.integration_id,
+    action
+  }));
+  return {
+    ...workflow,
+    action_count: actions.length,
+    valid_now_count: actions.filter((entry) => entry.valid_now === true).length,
+    actions
+  };
+}
+
+function summarizeIntegrationPromotionActionSetList(filters = {}) {
+  const integrations = listIntegrations(filters).map((integration) => summarizeIntegrationPromotionActionSet(integration));
+  return {
+    ok: true,
+    integration_count: integrations.length,
+    valid_now_count: integrations.reduce((total, entry) => total + Number(entry.valid_now_count || 0), 0),
+    recommended_actions: summarizeCounts(
+      integrations
+        .map((entry) => entry.next_transition && entry.next_transition.action)
+        .filter(Boolean),
+      "action"
+    ),
+    valid_actions: summarizeCounts(
+      integrations
+        .flatMap((entry) => Array.isArray(entry.actions) ? entry.actions : [])
+        .filter((entry) => entry.valid_now === true)
+        .map((entry) => entry.request && entry.request.action)
+        .filter(Boolean),
+      "action"
+    ),
+    integrations
+  };
+}
+
+function buildPromotionActionQueues(integrations = []) {
+  const rows = Array.isArray(integrations) ? integrations.filter((entry) => entry && entry.next_transition) : [];
+  const groups = new Map();
+
+  rows.forEach((entry) => {
+    const action = entry.next_transition && entry.next_transition.action
+      ? entry.next_transition.action
+      : "review_manually";
+    if (!groups.has(action)) {
+      groups.set(action, []);
+    }
+    groups.get(action).push(entry);
+  });
+
+  return Array.from(groups.keys()).sort().map((action) => {
+    const entries = groups.get(action) || [];
+    const blockerEntries = entries.flatMap((entry) => entry.blocker_categories || []);
+    return {
+      action,
+      count: entries.length,
+      recommendation_counts: summarizeCounts(
+        entries.map((entry) => entry.promotion_recommendation && entry.promotion_recommendation.recommendation).filter(Boolean),
+        "recommendation"
+      ),
+      owner_queue: summarizeCounts(
+        blockerEntries.map((entry) => entry.owner).filter(Boolean),
+        "owner"
+      ),
+      severity_queue: summarizeCounts(
+        blockerEntries.map((entry) => entry.severity).filter(Boolean),
+        "severity"
+      ),
+      integration_ids: entries.map((entry) => entry.integration_id).filter(Boolean).sort(),
+      integrations: entries.map((entry) => ({
+        integration_id: entry.integration_id,
+        display_name: entry.display_name,
+        adapter_class: entry.adapter_class,
+        recommendation: entry.promotion_recommendation && entry.promotion_recommendation.recommendation,
+        review_ready: entry.promotion_readiness && entry.promotion_readiness.review_ready === true,
+        production_default_ready: entry.promotion_readiness && entry.promotion_readiness.production_default_ready === true
+      }))
+    };
+  });
+}
+
+function buildSubmissionBundleReviewWarnings(bundle) {
+  const warnings = [];
+  const registrationRecord = bundle && bundle.registration_record && typeof bundle.registration_record === "object"
+    ? bundle.registration_record
+    : {};
+  const certificationPack = bundle && bundle.certification_pack && typeof bundle.certification_pack === "object"
+    ? bundle.certification_pack
+    : {};
+
+  if (registrationRecord.registration_state === "staging_registered") {
+    warnings.push("integration is staging-registered and should be reviewed before broader promotion");
+  }
+  if (registrationRecord.requires_explicit_selection === true) {
+    warnings.push("integration requires explicit selection and should not be treated as default");
+  }
+  if (registrationRecord.default_selection_enabled !== true) {
+    warnings.push("integration is not currently eligible for default selection");
+  }
+  if (certificationPack.certification_state && certificationPack.certification_state !== "certified") {
+    warnings.push("integration is not yet fully certified");
+  }
+
+  return warnings;
+}
+
+function summarizeIntegrationSubmissionBundleReview(bundleInput = {}) {
+  const bundle = clone(bundleInput || {});
+  const validation = validateIntegrationSubmissionBundle(bundle);
+  const snapshotEntry = bundle.snapshot_entry && typeof bundle.snapshot_entry === "object"
+    ? clone(bundle.snapshot_entry)
+    : {};
+  const manifest = bundle.manifest && typeof bundle.manifest === "object" ? bundle.manifest : {};
+  const registrationRecord = bundle.registration_record && typeof bundle.registration_record === "object"
+    ? bundle.registration_record
+    : {};
+  const certificationPack = bundle.certification_pack && typeof bundle.certification_pack === "object"
+    ? bundle.certification_pack
+    : {};
+  const integrationId = registrationRecord.integration_id || manifest.adapter_id || snapshotEntry.integration_id || null;
+  const adapterClass = registrationRecord.adapter_class || manifest.adapter_class || snapshotEntry.adapter_class || null;
+  const protocols = sortStrings(snapshotEntry.protocols);
+  const settlementModes = sortStrings(snapshotEntry.settlement_modes || manifest.supported_settlement_modes);
+  const taskRefs = sortStrings(snapshotEntry.task_refs);
+  const workflowRefs = sortStrings(snapshotEntry.workflow_refs);
+  const warnings = buildSubmissionBundleReviewWarnings(bundle);
+  const promotionReadiness = buildPromotionReadinessSummary({
+    registration: {
+      registration_state: registrationRecord.registration_state || null,
+      bundled: registrationRecord.bundled === true,
+      default_selection_enabled: registrationRecord.default_selection_enabled === true,
+      requires_explicit_selection: registrationRecord.requires_explicit_selection === true
+    },
+    certification: {
+      certification_state: certificationPack.certification_state || snapshotEntry.certification_state || null
+    },
+    integration: {
+      integration_maturity: registrationRecord.integration_maturity || snapshotEntry.integration_maturity || null,
+      certification_state: certificationPack.certification_state || snapshotEntry.certification_state || null
+    }
+  });
+
+  return {
+    ok: validation.ok,
+    review_kind: "integration_submission_bundle",
+    validation,
+    integration: {
+      integration_id: integrationId,
+      display_name: manifest.display_name || snapshotEntry.display_name || null,
+      adapter_id: manifest.adapter_id || registrationRecord.adapter_id || null,
+      adapter_class: adapterClass,
+      adapter_version: manifest.adapter_version || snapshotEntry.adapter_version || null,
+      source: snapshotEntry.source || null,
+      certification_state: certificationPack.certification_state || snapshotEntry.certification_state || null,
+      integration_maturity: registrationRecord.integration_maturity || snapshotEntry.integration_maturity || null,
+      protocols,
+      settlement_modes: settlementModes,
+      task_refs: taskRefs,
+      workflow_refs: workflowRefs
+    },
+    registration: {
+      registration_state: registrationRecord.registration_state || null,
+      bundled: registrationRecord.bundled === true,
+      default_selection_enabled: registrationRecord.default_selection_enabled === true,
+      requires_explicit_selection: registrationRecord.requires_explicit_selection === true,
+      selection_priority: Number.isFinite(Number(registrationRecord.selection_priority))
+        ? Number(registrationRecord.selection_priority)
+        : null,
+      registered_at: registrationRecord.registered_at || null,
+      registered_by: registrationRecord.registered_by || null
+    },
+    certification: {
+      certification_state: certificationPack.certification_state || null,
+      certification_scope: sortStrings(certificationPack.certification_scope),
+      verified_with: sortStrings(certificationPack.verified_with),
+      submitted_at: certificationPack.submitted_at || null,
+      submitted_by: certificationPack.submitted_by || null
+    },
+    promotion_readiness: promotionReadiness,
+    review_summary: {
+      warning_count: warnings.length,
+      warnings,
+      capability_count: Array.isArray(manifest.capabilities) ? manifest.capabilities.length : 0,
+      protocol_count: protocols.length,
+      settlement_mode_count: settlementModes.length,
+      task_count: taskRefs.length,
+      workflow_count: workflowRefs.length,
+      selectable_via_explicit_request: registrationRecord.requires_explicit_selection === true
+        || registrationRecord.default_selection_enabled === true,
+      default_eligible: registrationRecord.default_selection_enabled === true,
+      production_default_ready: promotionReadiness.production_default_ready
+    }
+  };
+}
+
+function summarizeIntegrationSubmissionBundleSetReview(bundleSetInput = {}) {
+  const bundleSet = clone(bundleSetInput || {});
+  const validation = validateIntegrationSubmissionBundleSet(bundleSet);
+  const bundleReviews = (Array.isArray(bundleSet.bundles) ? bundleSet.bundles : []).map((bundle) =>
+    summarizeIntegrationSubmissionBundleReview(bundle)
+  );
+  const adapterClasses = bundleReviews.map((review) => review.integration.adapter_class).filter(Boolean);
+  const registrationStates = bundleReviews.map((review) => review.registration.registration_state).filter(Boolean);
+  const certificationStates = bundleReviews.map((review) => review.certification.certification_state).filter(Boolean);
+
+  return {
+    ok: validation.ok,
+    review_kind: "integration_submission_bundle_set",
+    validation,
+    bundle_set_version: bundleSet.bundle_set_version || null,
+    bundle_count: Array.isArray(bundleSet.bundles) ? bundleSet.bundles.length : 0,
+    generated_at: bundleSet.generated_at || null,
+    filters: clone(bundleSet.filters || {}),
+    notes: typeof bundleSet.notes === "string" ? bundleSet.notes : null,
+    review_summary: {
+      warning_count: bundleReviews.reduce((total, review) => total + review.review_summary.warning_count, 0),
+      explicit_selection_required_count: bundleReviews.filter((review) => review.registration.requires_explicit_selection).length,
+      default_eligible_count: bundleReviews.filter((review) => review.registration.default_selection_enabled).length,
+      production_default_ready_count: bundleReviews.filter((review) => review.promotion_readiness.production_default_ready).length,
+      review_ready_count: bundleReviews.filter((review) => review.promotion_readiness.review_ready).length,
+      bundled_count: bundleReviews.filter((review) => review.registration.bundled).length,
+      adapter_classes: summarizeCounts(adapterClasses, "adapter_class"),
+      registration_states: summarizeCounts(registrationStates, "registration_state"),
+      certification_states: summarizeCounts(certificationStates, "certification_state"),
+      postures: summarizeCounts(bundleReviews.map((review) => review.promotion_readiness.posture).filter(Boolean), "posture")
+    },
+    bundles: bundleReviews
+  };
+}
+
+function summarizeIntegrationRegistrySnapshotReview(snapshotInput = {}) {
+  const snapshot = clone(snapshotInput || {});
+  const validation = validateIntegrationRegistrySnapshot(snapshot);
+  const integrations = Array.isArray(snapshot.integrations) ? snapshot.integrations : [];
+  const adapterClasses = integrations.map((integration) => integration.adapter_class).filter(Boolean);
+  const sources = integrations.map((integration) => integration.source).filter(Boolean);
+  const certificationStates = integrations.map((integration) => integration.certification_state).filter(Boolean);
+  const registrationStates = integrations
+    .map((integration) => integration.registration && integration.registration.registration_state)
+    .filter(Boolean);
+  const promotionReviews = integrations.map((integration) => buildPromotionReadinessSummary({
+    registration: integration.registration,
+    certification: {
+      certification_state: integration.certification_state || null
+    },
+    integration
+  }));
+
+  return {
+    ok: validation.ok,
+    review_kind: "integration_registry_snapshot",
+    validation,
+    snapshot_version: snapshot.snapshot_version || null,
+    integration_count: integrations.length,
+    generated_at: snapshot.generated_at || null,
+    filters: clone(snapshot.filters || {}),
+    review_summary: {
+      production_default_count: integrations.filter((integration) => integration.integration_maturity === "production_default").length,
+      staged_registration_count: integrations.filter((integration) => integration.registration && integration.registration.registration_state === "staging_registered").length,
+      explicit_selection_required_count: integrations.filter((integration) => integration.registration && integration.registration.requires_explicit_selection === true).length,
+      default_selection_enabled_count: integrations.filter((integration) => integration.registration && integration.registration.default_selection_enabled === true).length,
+      production_default_ready_count: promotionReviews.filter((review) => review.production_default_ready).length,
+      review_ready_count: promotionReviews.filter((review) => review.review_ready).length,
+      adapter_classes: summarizeCounts(adapterClasses, "adapter_class"),
+      sources: summarizeCounts(sources, "source"),
+      certification_states: summarizeCounts(certificationStates, "certification_state"),
+      registration_states: summarizeCounts(registrationStates, "registration_state"),
+      postures: summarizeCounts(promotionReviews.map((review) => review.posture).filter(Boolean), "posture")
+    }
+  };
+}
+
+function summarizeIntegrationPromotionReadiness(integrationOrId) {
+  const integration = typeof integrationOrId === "string"
+    ? getIntegration(integrationOrId)
+    : clone(integrationOrId || null);
+  if (!integration) {
+    return {
+      ok: false,
+      reason: "integration_not_found"
+    };
+  }
+  return {
+    ok: true,
+    integration_id: integration.integration_id,
+    display_name: integration.display_name,
+    adapter_class: integration.adapter_class,
+    source: integration.source,
+    registration: clone(integration.registration || {}),
+    certification_state: integration.certification_state || null,
+    integration_maturity: integration.integration_maturity || null,
+    promotion_readiness: buildPromotionReadinessSummary({
+      registration: integration.registration,
+      certification: {
+        certification_state: integration.certification_state || null
+      },
+      integration
+    })
+  };
+}
+
+function summarizeIntegrationPromotionWorkflow(integrationOrId) {
+  const summary = summarizeIntegrationPromotionReadiness(integrationOrId);
+  if (!summary.ok) {
+    return summary;
+  }
+  const readiness = clone(summary.promotion_readiness || {});
+  return {
+    ...summary,
+    certification_gaps: buildCertificationGapSummary(readiness, summary),
+    blocker_categories: summarizePromotionBlockerCategories(readiness.blockers),
+    next_transition: buildNextTransitionSummary(readiness),
+    promotion_recommendation: buildPromotionRecommendationSummary(readiness)
+  };
+}
+
+function summarizeIntegrationPromotionWorkflowList(filters = {}) {
+  const integrations = listIntegrations(filters).map((integration) => summarizeIntegrationPromotionWorkflow(integration));
+  const blockerCategoryEntries = integrations.flatMap((entry) => entry.blocker_categories || []);
+  return {
+    ok: true,
+    integration_count: integrations.length,
+    review_ready_count: integrations.filter((entry) => entry.promotion_readiness.review_ready).length,
+    production_default_ready_count: integrations.filter((entry) => entry.promotion_readiness.production_default_ready).length,
+    certifiable_count: integrations.filter((entry) => entry.certification_gaps.certifiable).length,
+    next_actions: summarizeCounts(
+      integrations.map((entry) => entry.next_transition.action).filter(Boolean),
+      "action"
+    ),
+    recommendations: summarizeCounts(
+      integrations.map((entry) => entry.promotion_recommendation.recommendation).filter(Boolean),
+      "recommendation"
+    ),
+    blocker_categories: summarizeStructuredCounts(
+      blockerCategoryEntries,
+      ["category", "severity", "owner"]
+    ),
+    owner_queue: summarizeCounts(
+      blockerCategoryEntries.map((entry) => entry.owner).filter(Boolean),
+      "owner"
+    ),
+    severity_queue: summarizeCounts(
+      blockerCategoryEntries.map((entry) => entry.severity).filter(Boolean),
+      "severity"
+    ),
+    next_action_queues: buildPromotionActionQueues(integrations),
+    integrations
+  };
+}
+
+function buildBuiltInIntegrations() {
+  const httpTaskRefs = collectTaskRefsByAdapter("http");
+  const mcpTaskRefs = collectTaskRefsByAdapter("mcp");
+  const chainTaskRefs = collectTaskRefsByAdapter("chain");
+  const settlementModes = (Array.isArray(catalog.settlement_profiles) ? catalog.settlement_profiles : []).map((profile) => profile.mode);
+
+  return [
+    {
+      integration_id: "builtin.execution.http",
+      display_name: "Built-In HTTP Execution",
+      description: "Default execution path for task and workflow lanes served directly by xytara.",
+      adapter_class: "execution_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_default",
+      selection_priority: 100,
+      capabilities: sortStrings(
+        (Array.isArray(catalog.tasks) ? catalog.tasks : [])
+          .filter((task) => Array.isArray(task.adapters) && task.adapters.includes("http"))
+          .flatMap((task) => task.capabilities || [])
+      ),
+      protocols: [],
+      settlement_modes: [],
+      execution_backends: ["http"],
+      adapter_lanes: ["http"],
+      task_refs: sortStrings(httpTaskRefs),
+      workflow_refs: sortStrings(collectWorkflowRefsByTaskRefs(httpTaskRefs)),
+      required_secrets: [],
+      required_permissions: [],
+      supported_profiles: ["default"],
+      supported_regions: ["global"],
+      pricing_basis: "per_task",
+      latency_class: "mixed",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "execution_facts_only"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "command_quote_binding",
+        scope: "task_execution"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "timeout", "upstream_unavailable"],
+        retryable_categories: ["timeout", "upstream_unavailable"]
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: true,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: sortStrings(httpTaskRefs),
+        default_for_protocols: [],
+        default_for_settlement_modes: []
+      }
+    },
+    {
+      integration_id: "builtin.protocol.mcp",
+      display_name: "Built-In MCP Protocol Lane",
+      description: "Built-in machine protocol lane for MCP tool discovery and invocation through the commerce flow.",
+      adapter_class: "agent_protocol_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_default",
+      selection_priority: 80,
+      capabilities: ["adapter.mcp.invoke"],
+      protocols: ["mcp"],
+      settlement_modes: [],
+      execution_backends: ["mcp"],
+      adapter_lanes: ["mcp"],
+      task_refs: sortStrings(mcpTaskRefs),
+      workflow_refs: sortStrings(collectWorkflowRefsByTaskRefs(mcpTaskRefs)),
+      required_secrets: [],
+      required_permissions: [],
+      supported_profiles: ["default"],
+      supported_regions: ["global"],
+      pricing_basis: "per_task",
+      latency_class: "near_real_time",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "protocol_invocation_facts"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "quote_bound_invocation",
+        scope: "protocol_invocation"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "timeout", "upstream_unavailable"],
+        retryable_categories: ["timeout", "upstream_unavailable"]
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: true,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: sortStrings(mcpTaskRefs),
+        default_for_protocols: ["mcp"],
+        default_for_settlement_modes: []
+      }
+    },
+    {
+      integration_id: "builtin.payment.x402",
+      display_name: "Built-In x402 Payment Admission",
+      description: "Built-in exact-payment challenge lane for x402-style machine payment admission.",
+      adapter_class: "payment_rail_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_default",
+      selection_priority: 60,
+      capabilities: ["payment.admission", "payment.challenge", "payment.exact"],
+      protocols: ["x402"],
+      settlement_modes: sortStrings(settlementModes),
+      execution_backends: [],
+      adapter_lanes: ["x402"],
+      task_refs: [],
+      workflow_refs: [],
+      required_secrets: [],
+      required_permissions: [],
+      supported_profiles: ["default"],
+      supported_regions: ["global"],
+      pricing_basis: "quote_then_settle",
+      latency_class: "near_real_time",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "payment_admission_facts"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "quote_id",
+        scope: "payment_admission"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "quote_expired", "payment_missing"],
+        retryable_categories: []
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: true,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: [],
+        default_for_protocols: ["x402"],
+        default_for_settlement_modes: sortStrings(settlementModes)
+      }
+    },
+    {
+      integration_id: "builtin.payment.l402",
+      display_name: "Built-In L402 Payment Admission",
+      description: "Built-in L402-style Lightning payment admission through a gateway-signed payment front.",
+      adapter_class: "payment_rail_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_supported",
+      selection_priority: 65,
+      capabilities: ["payment.admission", "payment.challenge", "payment.permissionless_front"],
+      protocols: ["l402"],
+      settlement_modes: sortStrings(settlementModes),
+      execution_backends: [],
+      adapter_lanes: ["l402"],
+      task_refs: [],
+      workflow_refs: [],
+      required_secrets: ["XYTARA_L402_SHARED_SECRET"],
+      required_permissions: [],
+      supported_profiles: ["default"],
+      supported_regions: ["global"],
+      pricing_basis: "quote_then_settle",
+      latency_class: "near_real_time",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "payment_admission_facts"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "quote_id",
+        scope: "payment_admission"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "quote_expired", "payment_missing"],
+        retryable_categories: []
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: false,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: [],
+        default_for_protocols: [],
+        default_for_settlement_modes: sortStrings(settlementModes)
+      }
+    },
+    {
+      integration_id: "builtin.payment.bolt",
+      display_name: "Built-In BOLT Payment Admission",
+      description: "Built-in BOLT-style UTXO/SPV payment admission through a signed proof-carrying payment front.",
+      adapter_class: "payment_rail_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_supported",
+      selection_priority: 66,
+      capabilities: ["payment.admission", "payment.challenge", "payment.permissionless_front", "payment.spv_proof"],
+      protocols: ["bolt"],
+      settlement_modes: sortStrings(settlementModes),
+      execution_backends: [],
+      adapter_lanes: ["bolt"],
+      task_refs: [],
+      workflow_refs: [],
+      required_secrets: ["XYTARA_BOLT_SHARED_SECRET"],
+      required_permissions: [],
+      supported_profiles: ["default"],
+      supported_regions: ["global"],
+      pricing_basis: "quote_then_settle",
+      latency_class: "near_real_time",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "spv_or_block_header_verifiable_payment_facts"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "quote_id",
+        scope: "payment_admission"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "quote_expired", "payment_missing"],
+        retryable_categories: []
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: false,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: [],
+        default_for_protocols: [],
+        default_for_settlement_modes: sortStrings(settlementModes)
+      }
+    },
+    {
+      integration_id: "builtin.settlement.chain",
+      display_name: "Built-In Chain Settlement",
+      description: "Built-in settlement lane spanning the canonical chain-backed settlement profiles bundled in xytara.",
+      adapter_class: "settlement_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_default",
+      selection_priority: 90,
+      capabilities: sortStrings(
+        (Array.isArray(catalog.tasks) ? catalog.tasks : [])
+          .filter((task) => Array.isArray(task.adapters) && task.adapters.includes("chain"))
+          .flatMap((task) => task.capabilities || [])
+      ),
+      protocols: [],
+      settlement_modes: sortStrings(settlementModes),
+      execution_backends: ["chain"],
+      adapter_lanes: ["chain"],
+      task_refs: sortStrings(chainTaskRefs),
+      workflow_refs: sortStrings(collectWorkflowRefsByTaskRefs(chainTaskRefs)),
+      required_secrets: [],
+      required_permissions: [],
+      supported_profiles: ["default", "anchored"],
+      supported_regions: ["global"],
+      pricing_basis: "per_settlement",
+      latency_class: "governed_async",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "settlement_reference_only"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "quote_and_target_binding",
+        scope: "settlement_request"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "timeout", "upstream_unavailable", "settlement_failure"],
+        retryable_categories: ["timeout", "upstream_unavailable"]
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: true,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: sortStrings(chainTaskRefs),
+        default_for_protocols: [],
+        default_for_settlement_modes: sortStrings(settlementModes)
+      }
+    },
+    {
+      integration_id: "builtin.identity.registry",
+      display_name: "Built-In Registry Identity Surface",
+      description: "Built-in registry and anchoring surface used by trust, registry, and lifecycle records.",
+      adapter_class: "identity_registry_adapter",
+      adapter_version: "1.4.0",
+      interface_version: "commerce-adapter-interface/v1",
+      bundled: true,
+      source: "builtin",
+      status: "available",
+      certification_state: "certified",
+      certification_scope: ["builtin_runtime", "service_contract", "sdk_contract"],
+      integration_maturity: "production_default",
+      selection_priority: 70,
+      capabilities: ["registry.register", "anchoring.submit", "trust.handoff.emit", "trust.handoff.validate"],
+      protocols: [],
+      settlement_modes: [],
+      execution_backends: ["http", "chain"],
+      adapter_lanes: ["http", "chain"],
+      task_refs: sortStrings(["registry.register", "anchoring.submit", "trust.handoff.emit", "trust.handoff.validate"]),
+      workflow_refs: sortStrings(["registry.anchor.flow", "trust.flow"]),
+      required_secrets: [],
+      required_permissions: [],
+      supported_profiles: ["registry", "trust"],
+      supported_regions: ["global"],
+      pricing_basis: "per_task",
+      latency_class: "mixed",
+      proof_contract: {
+        emits_proof_compatible_facts: true,
+        proof_mode: "registry_reference_facts"
+      },
+      health_contract: {
+        check_kind: "internal",
+        supports_readiness: true
+      },
+      idempotency_contract: {
+        strategy: "record_ref_binding",
+        scope: "registry_request"
+      },
+      failure_contract: {
+        categories: ["invalid_input", "timeout", "upstream_unavailable"],
+        retryable_categories: ["timeout", "upstream_unavailable"]
+      },
+      compatibility: {
+        node: ">=18",
+        commerce_contract: "xytara/v1"
+      },
+      operational_readiness: {
+        supports_default_selection: true,
+        supports_forced_selection: true,
+        lifecycle: "managed_builtin",
+        health_source: "internal"
+      },
+      selection_hints: {
+        default_for_task_refs: sortStrings(["registry.register", "anchoring.submit", "trust.handoff.emit", "trust.handoff.validate"]),
+        default_for_protocols: [],
+        default_for_settlement_modes: []
+      }
+    },
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.a2a",
+      display_name: "Built-In A2A Protocol Surface",
+      description: "Built-in explicit agent-to-agent protocol surface for negotiation, commit, and settlement flow handoff.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["a2a.negotiate", "a2a.commit"],
+      protocols: ["a2a"],
+      execution_backends: ["a2a"],
+      adapter_lanes: ["a2a"],
+      task_refs: ["a2a.negotiate", "a2a.commit"],
+      workflow_refs: ["a2a.settlement.flow"],
+      supported_profiles: ["interaction"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.acp",
+      display_name: "Built-In ACP Protocol Surface",
+      description: "Built-in explicit ACP integration surface for third-party commerce and agent marketplace bridging.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["protocol.acp.bridge"],
+      protocols: ["acp"],
+      execution_backends: ["acp"],
+      adapter_lanes: ["acp"],
+      supported_profiles: ["marketplace", "interaction"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.mqtt",
+      display_name: "Built-In MQTT Protocol Surface",
+      description: "Built-in MQTT-facing protocol surface for message-driven machine interaction ingestion.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["protocol.mqtt.bridge"],
+      protocols: ["mqtt"],
+      execution_backends: ["mqtt"],
+      adapter_lanes: ["mqtt"],
+      supported_profiles: ["message_bus"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.grpc",
+      display_name: "Built-In gRPC Protocol Surface",
+      description: "Built-in gRPC-facing protocol surface for service-to-service commerce integration.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["protocol.grpc.bridge"],
+      protocols: ["grpc"],
+      execution_backends: ["grpc"],
+      adapter_lanes: ["grpc"],
+      supported_profiles: ["service_mesh"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.kafka",
+      display_name: "Built-In Kafka Protocol Surface",
+      description: "Built-in Kafka-facing protocol surface for streaming commerce/event ingress.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["protocol.kafka.bridge"],
+      protocols: ["kafka"],
+      execution_backends: ["kafka"],
+      adapter_lanes: ["kafka"],
+      supported_profiles: ["streaming"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.nats",
+      display_name: "Built-In NATS Protocol Surface",
+      description: "Built-in NATS-facing protocol surface for lightweight message-bus integration.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["protocol.nats.bridge"],
+      protocols: ["nats"],
+      execution_backends: ["nats"],
+      adapter_lanes: ["nats"],
+      supported_profiles: ["streaming"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.protocol.ros2",
+      display_name: "Built-In ROS2 Protocol Surface",
+      description: "Built-in ROS2-facing protocol surface for robotics-adjacent machine interaction integration.",
+      adapter_class: "agent_protocol_adapter",
+      capabilities: ["protocol.ros2.bridge"],
+      protocols: ["ros2"],
+      execution_backends: ["ros2"],
+      adapter_lanes: ["ros2"],
+      supported_profiles: ["robotics"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.execution.langchain",
+      display_name: "Built-In LangChain Execution Surface",
+      description: "Built-in execution-front surface for LangChain-style orchestration interoperability.",
+      adapter_class: "execution_adapter",
+      capabilities: ["execution.langchain.chain"],
+      execution_backends: ["langchain"],
+      adapter_lanes: ["langchain"],
+      supported_profiles: ["agent_runtime"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.execution.langgraph",
+      display_name: "Built-In LangGraph Execution Surface",
+      description: "Built-in execution-front surface for LangGraph-style graph orchestration interoperability.",
+      adapter_class: "execution_adapter",
+      capabilities: ["execution.langgraph.graph"],
+      execution_backends: ["langgraph"],
+      adapter_lanes: ["langgraph"],
+      supported_profiles: ["agent_runtime"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.execution.semantic_kernel",
+      display_name: "Built-In Semantic Kernel Execution Surface",
+      description: "Built-in execution-front surface for Semantic Kernel-style orchestration interoperability.",
+      adapter_class: "execution_adapter",
+      capabilities: ["execution.semantic_kernel.plan"],
+      execution_backends: ["semantic_kernel"],
+      adapter_lanes: ["semantic_kernel"],
+      supported_profiles: ["agent_runtime"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.execution.autogen",
+      display_name: "Built-In AutoGen Execution Surface",
+      description: "Built-in execution-front surface for AutoGen-style multi-agent orchestration interoperability.",
+      adapter_class: "execution_adapter",
+      capabilities: ["execution.autogen.session"],
+      execution_backends: ["autogen"],
+      adapter_lanes: ["autogen"],
+      supported_profiles: ["agent_runtime"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.execution.crewai",
+      display_name: "Built-In CrewAI Execution Surface",
+      description: "Built-in execution-front surface for CrewAI-style workflow interoperability.",
+      adapter_class: "execution_adapter",
+      capabilities: ["execution.crewai.crew"],
+      execution_backends: ["crewai"],
+      adapter_lanes: ["crewai"],
+      supported_profiles: ["agent_runtime"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.execution.llamaindex",
+      display_name: "Built-In LlamaIndex Execution Surface",
+      description: "Built-in execution-front surface for LlamaIndex-style retrieval and agent interoperability.",
+      adapter_class: "execution_adapter",
+      capabilities: ["execution.llamaindex.workflow"],
+      execution_backends: ["llamaindex"],
+      adapter_lanes: ["llamaindex"],
+      supported_profiles: ["agent_runtime", "retrieval"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.payment.mpp",
+      display_name: "Built-In MPP Payment Surface",
+      description: "Built-in multi-party payment admission surface for broader machine payment interoperability.",
+      adapter_class: "payment_rail_adapter",
+      capabilities: ["payment.mpp.admission"],
+      protocols: ["mpp"],
+      settlement_modes: sortStrings(settlementModes),
+      adapter_lanes: ["mpp"],
+      required_secrets: ["XYTARA_MPP_SHARED_SECRET"],
+      supported_profiles: ["payment"]
+    }),
+    createBuiltinBreadthIntegration({
+      integration_id: "builtin.identity.erc8004",
+      display_name: "Built-In ERC-8004 Identity Surface",
+      description: "Built-in ERC-8004-oriented identity action surface for broader machine identity interoperability.",
+      adapter_class: "identity_registry_adapter",
+      capabilities: ["identity.erc8004.action"],
+      protocols: ["erc8004"],
+      execution_backends: ["erc8004"],
+      adapter_lanes: ["erc8004"],
+      supported_profiles: ["identity", "registry"]
+    })
+  ];
+}
+
+const EXAMPLE_INTEGRATIONS = [
+  mapManifestToIntegration(executionExampleManifest, {
+    source: "example",
+    execution_backends: ["echo"],
+    adapter_lanes: ["http"],
+    certification_state: "reference_example",
+    certification_scope: ["contract_shape"],
+    integration_maturity: "reference_example",
+    selection_priority: 950,
+    supports_default_selection: false,
+    supports_forced_selection: true,
+    lifecycle: "example_only",
+    health_source: "self_reported",
+    default_for_task_refs: [],
+    default_for_protocols: [],
+    default_for_settlement_modes: []
+  }),
+  mapManifestToIntegration(settlementExampleManifest, {
+    source: "example",
+    adapter_lanes: ["chain"],
+    certification_state: "reference_example",
+    certification_scope: ["contract_shape"],
+    integration_maturity: "reference_example",
+    selection_priority: 960,
+    supports_default_selection: false,
+    supports_forced_selection: true,
+    lifecycle: "example_only",
+    health_source: "self_reported",
+    default_for_task_refs: [],
+    default_for_protocols: [],
+    default_for_settlement_modes: []
+  }),
+  createRegisteredIntegrationFromManifest({
+    adapter_id: exampleThirdPartyRegistrationRecord.adapter_id,
+    adapter_class: exampleThirdPartyRegistrationRecord.adapter_class,
+    adapter_version: "0.1.0",
+    interface_version: "commerce-adapter-interface/v1",
+    display_name: "Acme MCP Partner Adapter",
+    description: "Reference third-party MCP integration showing how staged non-bundled registration should appear in discovery.",
+    capabilities: ["adapter.mcp.invoke"],
+    compatibility: {
+      node: ">=18",
+      commerce_contract: "xytara/v1",
+      proof_contract: "xoonya/v1"
+    },
+    health_contract: {
+      check_kind: "self_reported",
+      supports_readiness: true
+    },
+    idempotency_contract: {
+      strategy: "quote_bound_invocation",
+      scope: "protocol_invocation"
+    },
+    failure_contract: {
+      categories: ["invalid_input", "timeout", "upstream_unavailable"],
+      retryable_categories: ["timeout", "upstream_unavailable"]
+    },
+    proof_contract: {
+      emits_proof_compatible_facts: true,
+      proof_mode: "protocol_invocation_facts"
+    },
+    latency_class: "near_real_time",
+    pricing_basis: "per_task",
+    required_secrets: ["ACME_MCP_TOKEN"],
+    required_permissions: ["network:outbound"],
+    supported_profiles: ["partner"],
+    supported_regions: ["global"],
+    supported_settlement_modes: exampleThirdPartyRegistrationRecord.settlement_modes
+  }, exampleThirdPartyRegistrationRecord, {
+    source: "third_party_example",
+    status: "available",
+    certification_scope: ["self_attested_contract_shape", "staging_smoke"],
+    protocols: sortStrings(exampleThirdPartyRegistrationRecord.protocols),
+    execution_backends: ["mcp"],
+    adapter_lanes: ["mcp"],
+    task_refs: sortStrings(exampleThirdPartyRegistrationRecord.task_refs),
+    workflow_refs: [],
+    supports_forced_selection: true,
+    health_source: "self_reported"
+  }),
+  createRegisteredIntegrationFromManifest({
+    adapter_id: exampleThirdPartyIdentityRegistrationRecord.adapter_id,
+    adapter_class: exampleThirdPartyIdentityRegistrationRecord.adapter_class,
+    adapter_version: "0.1.0",
+    interface_version: "commerce-adapter-interface/v1",
+    display_name: "Attest Registry Partner Identity Adapter",
+    description: "Reference third-party identity registry integration showing how staged non-bundled identity registration should appear in discovery.",
+    capabilities: ["registry.register", "trust.handoff.emit", "trust.handoff.validate"],
+    compatibility: {
+      node: ">=18",
+      commerce_contract: "xytara/v1",
+      proof_contract: "xoonya/v1"
+    },
+    health_contract: {
+      check_kind: "self_reported",
+      supports_readiness: true
+    },
+    idempotency_contract: {
+      strategy: "record_ref_binding",
+      scope: "registry_request"
+    },
+    failure_contract: {
+      categories: ["invalid_input", "timeout", "upstream_unavailable"],
+      retryable_categories: ["timeout", "upstream_unavailable"]
+    },
+    proof_contract: {
+      emits_proof_compatible_facts: true,
+      proof_mode: "registry_reference_facts"
+    },
+    latency_class: "near_real_time",
+    pricing_basis: "per_task",
+    required_secrets: ["ATTEST_REGISTRY_TOKEN"],
+    required_permissions: ["network:outbound"],
+    supported_profiles: ["partner", "registry", "trust"],
+    supported_regions: ["global"],
+    supported_settlement_modes: []
+  }, exampleThirdPartyIdentityRegistrationRecord, {
+    source: "third_party_example",
+    status: "available",
+    certification_scope: ["self_attested_contract_shape", "staging_identity_smoke"],
+    protocols: sortStrings(exampleThirdPartyIdentityRegistrationRecord.protocols),
+    execution_backends: ["http", "chain"],
+    adapter_lanes: ["http", "chain"],
+    task_refs: sortStrings(exampleThirdPartyIdentityRegistrationRecord.task_refs),
+    workflow_refs: [],
+    supports_forced_selection: true,
+    health_source: "self_reported"
+  }),
+  createRegisteredIntegrationFromManifest({
+    adapter_id: exampleThirdPartySettlementRegistrationRecord.adapter_id,
+    adapter_class: exampleThirdPartySettlementRegistrationRecord.adapter_class,
+    adapter_version: "0.1.0",
+    interface_version: "commerce-adapter-interface/v1",
+    display_name: "Lattice Anchor Settlement Adapter",
+    description: "Reference third-party settlement integration showing how staged non-bundled settlement registration should appear in discovery.",
+    capabilities: ["anchoring.submit", "settlement.reference"],
+    compatibility: {
+      node: ">=18",
+      commerce_contract: "xytara/v1",
+      proof_contract: "xoonya/v1"
+    },
+    health_contract: {
+      check_kind: "self_reported",
+      supports_readiness: true
+    },
+    idempotency_contract: {
+      strategy: "quote_and_target_binding",
+      scope: "settlement_request"
+    },
+    failure_contract: {
+      categories: ["invalid_input", "timeout", "upstream_unavailable", "settlement_failure"],
+      retryable_categories: ["timeout", "upstream_unavailable"]
+    },
+    proof_contract: {
+      emits_proof_compatible_facts: true,
+      proof_mode: "settlement_reference_only"
+    },
+    latency_class: "governed_async",
+    pricing_basis: "per_settlement",
+    required_secrets: ["LATTICE_SETTLEMENT_TOKEN"],
+    required_permissions: ["network:outbound"],
+    supported_profiles: ["partner", "anchored"],
+    supported_regions: ["global"],
+    supported_settlement_modes: exampleThirdPartySettlementRegistrationRecord.settlement_modes
+  }, exampleThirdPartySettlementRegistrationRecord, {
+    source: "third_party_example",
+    status: "available",
+    certification_scope: ["self_attested_contract_shape", "staging_settlement_smoke"],
+    protocols: sortStrings(exampleThirdPartySettlementRegistrationRecord.protocols),
+    execution_backends: ["chain"],
+    adapter_lanes: ["chain"],
+    task_refs: sortStrings(exampleThirdPartySettlementRegistrationRecord.task_refs),
+    workflow_refs: [],
+    supports_forced_selection: true,
+    health_source: "self_reported"
+  })
+];
+
+const INTEGRATIONS = buildBuiltInIntegrations().concat(EXAMPLE_INTEGRATIONS).map(clone);
+
+const INTEGRATION_REGISTRATION_RECORDS = {
+  [exampleThirdPartyRegistrationRecord.integration_id]: clone(exampleThirdPartyRegistrationRecord),
+  [exampleThirdPartyIdentityRegistrationRecord.integration_id]: clone(exampleThirdPartyIdentityRegistrationRecord),
+  [exampleThirdPartySettlementRegistrationRecord.integration_id]: clone(exampleThirdPartySettlementRegistrationRecord)
+};
+
+function listIntegrations(filters = {}) {
+  const normalized = {
+    adapter_class: String(filters.adapter_class || filters.class || "").trim(),
+    protocol: String(filters.protocol || "").trim(),
+    settlement_mode: String(filters.settlement_mode || "").trim(),
+    capability: String(filters.capability || "").trim(),
+    task_ref: String(filters.task_ref || "").trim(),
+    source: String(filters.source || "").trim(),
+    certification_state: String(filters.certification_state || "").trim(),
+    integration_maturity: String(filters.integration_maturity || filters.maturity || "").trim(),
+    bundled: String(filters.bundled || "").trim()
+  };
+  return INTEGRATIONS.filter((integration) => {
+    if (normalized.adapter_class && integration.adapter_class !== normalized.adapter_class) return false;
+    if (normalized.protocol && !integration.protocols.includes(normalized.protocol)) return false;
+    if (normalized.settlement_mode && !integration.settlement_modes.includes(normalized.settlement_mode)) return false;
+    if (normalized.capability && !integration.capabilities.includes(normalized.capability)) return false;
+    if (normalized.task_ref && !integration.task_refs.includes(normalized.task_ref)) return false;
+    if (normalized.source && integration.source !== normalized.source) return false;
+    if (normalized.certification_state && integration.certification_state !== normalized.certification_state) return false;
+    if (normalized.integration_maturity && integration.integration_maturity !== normalized.integration_maturity) return false;
+    if (normalized.bundled && String(integration.bundled) !== normalized.bundled) return false;
+    return true;
+  }).map((integration) => buildIntegrationView(integration, INTEGRATION_REGISTRATION_RECORDS[integration.integration_id]));
+}
+
+function getIntegration(integrationId) {
+  const lookup = String(integrationId || "").trim();
+  const found = INTEGRATIONS.find((integration) => integration.integration_id === lookup);
+  return found ? buildIntegrationView(found, INTEGRATION_REGISTRATION_RECORDS[found.integration_id]) : null;
+}
+
+function summarizeIntegrations(filters = {}) {
+  const integrations = listIntegrations(filters);
+  return {
+    ok: true,
+    integration_count: integrations.length,
+    integration_ids: integrations.map((integration) => integration.integration_id),
+    class_count: sortStrings(integrations.map((integration) => integration.adapter_class)).length,
+    protocol_count: sortStrings(integrations.flatMap((integration) => integration.protocols)).length,
+    settlement_mode_count: sortStrings(integrations.flatMap((integration) => integration.settlement_modes)).length,
+    certified_integration_count: integrations.filter((integration) => integration.certification_state === "certified").length,
+    production_default_count: integrations.filter((integration) => integration.integration_maturity === "production_default").length,
+    integrations: integrations.map((integration) => ({
+      integration_id: integration.integration_id,
+      display_name: integration.display_name,
+      adapter_class: integration.adapter_class,
+      source: integration.source,
+      certification_state: integration.certification_state,
+      integration_maturity: integration.integration_maturity,
+      registration_state: integration.registration.registration_state,
+      bundled: integration.registration.bundled,
+      selection_priority: integration.selection_priority,
+      protocols: integration.protocols,
+      settlement_modes: integration.settlement_modes,
+      task_count: integration.task_refs.length,
+      workflow_count: integration.workflow_refs.length,
+      capability_count: integration.capabilities.length
+    }))
+  };
+}
+
+function summarizeIntegrationClasses(filters = {}) {
+  const integrations = listIntegrations(filters);
+  const classes = sortStrings(integrations.map((integration) => integration.adapter_class)).map((adapterClass) => ({
+    adapter_class: adapterClass,
+    integration_count: integrations.filter((integration) => integration.adapter_class === adapterClass).length
+  }));
+  return {
+    ok: true,
+    adapter_class_count: classes.length,
+    adapter_classes: classes
+  };
+}
+
+function summarizeIntegrationProtocols(filters = {}) {
+  const integrations = listIntegrations(filters);
+  const protocols = sortStrings(integrations.flatMap((integration) => integration.protocols)).map((protocol) => ({
+    protocol,
+    integration_count: integrations.filter((integration) => integration.protocols.includes(protocol)).length
+  }));
+  return {
+    ok: true,
+    protocol_count: protocols.length,
+    protocols
+  };
+}
+
+function summarizeIntegrationSettlementModes(filters = {}) {
+  const integrations = listIntegrations(filters);
+  const settlementModes = sortStrings(integrations.flatMap((integration) => integration.settlement_modes)).map((settlementMode) => ({
+    settlement_mode: settlementMode,
+    integration_count: integrations.filter((integration) => integration.settlement_modes.includes(settlementMode)).length
+  }));
+  return {
+    ok: true,
+    settlement_mode_count: settlementModes.length,
+    settlement_modes: settlementModes
+  };
+}
+
+// 1.3.0 Phase 1 anchor:
+// The next workflow layer should stay read-only and build on top of
+// summarizeIntegrationPromotionReadiness(...), adding:
+// - promotion recommendation summaries
+// - next eligible transition summaries
+// - normalized blocker categories
+// without introducing mutation flows or persistent registry state.
+
+module.exports = {
+  getIntegration,
+  listIntegrations,
+  summarizeIntegrations,
+  summarizeIntegrationClasses,
+  summarizeIntegrationProtocols,
+  summarizeIntegrationSettlementModes,
+  validateIntegrationRegistration,
+  validateIntegrationCertificationPack,
+  validateIntegrationSubmission,
+  importRegisteredIntegration,
+  createIntegrationRegistrySnapshot,
+  exportIntegrationRegistrySnapshot,
+  validateIntegrationRegistrySnapshot,
+  validateIntegrationSubmissionBundle,
+  createIntegrationSubmissionBundle,
+  importIntegrationSubmissionBundle,
+  createIntegrationRegistrySnapshotFromBundles,
+  exportIntegrationSubmissionBundles,
+  createIntegrationSubmissionBundleSet,
+  validateIntegrationSubmissionBundleSet,
+  exportIntegrationSubmissionBundleSet,
+  summarizeIntegrationSubmissionBundleReview,
+  summarizeIntegrationSubmissionBundleSetReview,
+  summarizeIntegrationRegistrySnapshotReview,
+  summarizeIntegrationPromotionReadiness,
+  summarizeIntegrationPromotionWorkflow,
+  summarizeIntegrationPromotionWorkflowList,
+  validatePromotionActionRequest,
+  summarizeIntegrationPromotionActionPreview,
+  summarizeIntegrationPromotionActionSet,
+  summarizeIntegrationPromotionActionSetList,
+  createRegisteredIntegrationFromManifest,
+  buildIntegrationRegistrationView,
+  buildIntegrationView
+};