xoonya 3.0.0 → 3.1.0

package/lib/framework_lane_contract.js

@@ -1,76 +1,76 @@
-"use strict";
-
-const {
-  buildPhase6FrameworkRuntimePack,
-  summarizePhase6FrameworkRuntimePack
-} = require("./phase_6_framework_runtime_pack");
-const {
-  summarizePhase6LanggraphProofPack
-} = require("./phase_6_langgraph_proof_pack");
-const {
-  summarizePhase6LangchainProofPack
-} = require("./phase_6_langchain_proof_pack");
-const {
-  summarizePhase6AutogenProofPack
-} = require("./phase_6_autogen_proof_pack");
-const {
-  summarizePhase6SemanticKernelProofPack
-} = require("./phase_6_semantic_kernel_proof_pack");
-
-function buildFrameworkLanePack() {
-  return {
-    product: "xoonya",
-    category: "proof-framework-lane-pack",
-    pack_version: "xoonya-framework-lane-pack-v1",
-    lane_state: "first_party_framework_family_present",
-    posture: "framework_followthrough_and_proof_carry_family",
-    framework_family: {
-      pack: buildPhase6FrameworkRuntimePack(),
-      summary: summarizePhase6FrameworkRuntimePack()
-    },
-    featured_frameworks: {
-      langgraph: summarizePhase6LanggraphProofPack(),
-      langchain: summarizePhase6LangchainProofPack(),
-      autogen: summarizePhase6AutogenProofPack(),
-      semantic_kernel: summarizePhase6SemanticKernelProofPack()
-    },
-    supported_surfaces: {
-      phase_6_summary_ref: "/v1/phases/phase-6/summary",
-      langgraph_summary_ref: "/v1/phases/phase-6/langgraph/proof/summary",
-      langchain_summary_ref: "/v1/phases/phase-6/langchain/proof/summary",
-      autogen_summary_ref: "/v1/phases/phase-6/autogen/proof/summary",
-      semantic_kernel_summary_ref: "/v1/phases/phase-6/semantic-kernel/proof/summary",
-      integrations_ref: "/v1/integrations"
-    },
-    first_run_flows: [
-      {
-        flow_ref: "framework_family_proof_selection",
-        recommended_reason: "best first path for understanding how orchestration frameworks retain proof continuity instead of becoming isolated compatibility notes",
-        sequence: [
-          "inspect_framework_lane_summary",
-          "inspect_phase_6_framework_summary",
-          "inspect_named_framework_proof_profiles",
-          "choose_framework_followthrough_shape"
-        ]
-      }
-    ]
-  };
-}
-
-function summarizeFrameworkLanePack() {
-  const pack = buildFrameworkLanePack();
-  return {
-    product: "xoonya",
-    category: "proof-framework-lane-pack-summary",
-    summary_version: "xoonya-framework-lane-pack-summary-v1",
-    lane_state: pack.lane_state,
-    featured_framework_count: Object.keys(pack.featured_frameworks).length,
-    first_run_flow_count: pack.first_run_flows.length,
-    linked_surfaces: pack.supported_surfaces
-  };
-}
-
-module.exports = {
-  buildFrameworkLanePack,
-  summarizeFrameworkLanePack
-};
+"use strict";
+
+const {
+  buildPhase6FrameworkRuntimePack,
+  summarizePhase6FrameworkRuntimePack
+} = require("./phase_6_framework_runtime_pack");
+const {
+  summarizePhase6LanggraphProofPack
+} = require("./phase_6_langgraph_proof_pack");
+const {
+  summarizePhase6LangchainProofPack
+} = require("./phase_6_langchain_proof_pack");
+const {
+  summarizePhase6AutogenProofPack
+} = require("./phase_6_autogen_proof_pack");
+const {
+  summarizePhase6SemanticKernelProofPack
+} = require("./phase_6_semantic_kernel_proof_pack");
+
+function buildFrameworkLanePack() {
+  return {
+    product: "xoonya",
+    category: "proof-framework-lane-pack",
+    pack_version: "xoonya-framework-lane-pack-v1",
+    lane_state: "first_party_framework_family_present",
+    posture: "framework_followthrough_and_proof_carry_family",
+    framework_family: {
+      pack: buildPhase6FrameworkRuntimePack(),
+      summary: summarizePhase6FrameworkRuntimePack()
+    },
+    featured_frameworks: {
+      langgraph: summarizePhase6LanggraphProofPack(),
+      langchain: summarizePhase6LangchainProofPack(),
+      autogen: summarizePhase6AutogenProofPack(),
+      semantic_kernel: summarizePhase6SemanticKernelProofPack()
+    },
+    supported_surfaces: {
+      phase_6_summary_ref: "/v1/phases/phase-6/summary",
+      langgraph_summary_ref: "/v1/phases/phase-6/langgraph/proof/summary",
+      langchain_summary_ref: "/v1/phases/phase-6/langchain/proof/summary",
+      autogen_summary_ref: "/v1/phases/phase-6/autogen/proof/summary",
+      semantic_kernel_summary_ref: "/v1/phases/phase-6/semantic-kernel/proof/summary",
+      integrations_ref: "/v1/integrations"
+    },
+    first_run_flows: [
+      {
+        flow_ref: "framework_family_proof_selection",
+        recommended_reason: "best first path for understanding how orchestration frameworks retain proof continuity instead of becoming isolated compatibility notes",
+        sequence: [
+          "inspect_framework_lane_summary",
+          "inspect_phase_6_framework_summary",
+          "inspect_named_framework_proof_profiles",
+          "choose_framework_followthrough_shape"
+        ]
+      }
+    ]
+  };
+}
+
+function summarizeFrameworkLanePack() {
+  const pack = buildFrameworkLanePack();
+  return {
+    product: "xoonya",
+    category: "proof-framework-lane-pack-summary",
+    summary_version: "xoonya-framework-lane-pack-summary-v1",
+    lane_state: pack.lane_state,
+    featured_framework_count: Object.keys(pack.featured_frameworks).length,
+    first_run_flow_count: pack.first_run_flows.length,
+    linked_surfaces: pack.supported_surfaces
+  };
+}
+
+module.exports = {
+  buildFrameworkLanePack,
+  summarizeFrameworkLanePack
+};

package/lib/governance_disputes_summary.js

@@ -1,36 +1,36 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const proofSdk = require("../proof_sdk");
-
-function buildGovernanceDisputesSummaryPack(input) {
-  return {
-    ...proofSdk.summarizeGovernanceDisputes(input),
-    product: packageJson.name,
-    category: "xoonya-governance-disputes-summary-pack",
-    summary_version: "xoonya-governance-disputes-summary-pack-v1",
-    linked_surfaces: {
-      case_review_ref: "/v1/proof-center/governance/disputes/case-review",
-      case_bundle_ref: "/v1/proof-center/governance/disputes/case-bundle",
-      resolution_pack_ref: "/v1/proof-center/governance/disputes/resolution-pack"
-    }
-  };
-}
-
-function summarizeGovernanceDisputesSummaryPack(input) {
-  const pack = buildGovernanceDisputesSummaryPack(input);
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    summary_version: pack.summary_version,
-    case_count: Number(pack.case_count || 0),
-    open_case_count: Number(pack.open_case_count || 0),
-    linked_surface_count: Object.keys(pack.linked_surfaces || {}).length
-  };
-}
-
-module.exports = {
-  buildGovernanceDisputesSummaryPack,
-  summarizeGovernanceDisputesSummaryPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const proofSdk = require("../proof_sdk");
+
+function buildGovernanceDisputesSummaryPack(input) {
+  return {
+    ...proofSdk.summarizeGovernanceDisputes(input),
+    product: packageJson.name,
+    category: "xoonya-governance-disputes-summary-pack",
+    summary_version: "xoonya-governance-disputes-summary-pack-v1",
+    linked_surfaces: {
+      case_review_ref: "/v1/proof-center/governance/disputes/case-review",
+      case_bundle_ref: "/v1/proof-center/governance/disputes/case-bundle",
+      resolution_pack_ref: "/v1/proof-center/governance/disputes/resolution-pack"
+    }
+  };
+}
+
+function summarizeGovernanceDisputesSummaryPack(input) {
+  const pack = buildGovernanceDisputesSummaryPack(input);
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    summary_version: pack.summary_version,
+    case_count: Number(pack.case_count || 0),
+    open_case_count: Number(pack.open_case_count || 0),
+    linked_surface_count: Object.keys(pack.linked_surfaces || {}).length
+  };
+}
+
+module.exports = {
+  buildGovernanceDisputesSummaryPack,
+  summarizeGovernanceDisputesSummaryPack
+};

package/lib/governance_intelligence.js

@@ -1,108 +1,108 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const proofSdk = require("../proof_sdk");
-
-function classifyEscalationReadinessState(adminView, disputesSummary) {
-  const escalationReadyCount = Number(adminView.oversight_summary?.escalation_ready_count || 0);
-  const openCaseCount = Number(disputesSummary.open_case_count || 0);
-  if (escalationReadyCount >= 1 && openCaseCount >= 2) return "active";
-  if (escalationReadyCount >= 1 || openCaseCount >= 1) return "watch";
-  return "quiet";
-}
-
-function classifySignoffMotionState(dashboard, signoffPack) {
-  const signoffReadyCount = Number(dashboard.queue_summary?.signoff_ready_count || 0);
-  if (signoffPack.signoff_status === "review_ready" && signoffReadyCount >= 1) return "review_ready";
-  if (signoffReadyCount >= 1) return "forming";
-  return "early";
-}
-
-function classifyHandoffContinuityState(handoffBundle) {
-  const includedSectionCount = Array.isArray(handoffBundle.included_sections)
-    ? handoffBundle.included_sections.length
-    : 0;
-  if (
-    includedSectionCount >= 4
-    && handoffBundle.review_summary_surface
-    && handoffBundle.handoff_run_surface
-  ) {
-    return "strong";
-  }
-  if (includedSectionCount >= 2) return "working";
-  return "thin";
-}
-
-function buildGovernanceIntelligencePack(input) {
-  const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
-  const dashboard = proofSdk.summarizeGovernanceDashboard(payload);
-  const adminView = proofSdk.summarizeGovernanceAdminView(payload);
-  const disputesSummary = proofSdk.summarizeGovernanceDisputes(payload);
-  const signoffPack = proofSdk.buildGovernanceSignoffPack(payload);
-  const consolePack = proofSdk.buildGovernanceConsolePack(payload);
-  const handoffBundle = proofSdk.buildGovernanceHandoffBundle(payload);
-
-  const escalationReadinessState = classifyEscalationReadinessState(adminView, disputesSummary);
-  const signoffMotionState = classifySignoffMotionState(dashboard, signoffPack);
-  const handoffContinuityState = classifyHandoffContinuityState(handoffBundle);
-
-  let nextBestAction = "continue_governance_flow";
-  if (escalationReadinessState === "active") {
-    nextBestAction = "escalate_governance_attention";
-  } else if (signoffMotionState === "review_ready") {
-    nextBestAction = "advance_signoff_motion";
-  } else if (handoffContinuityState !== "strong") {
-    nextBestAction = "strengthen_handoff_continuity";
-  } else if (escalationReadinessState === "watch") {
-    nextBestAction = "inspect_governance_console";
-  }
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-governance-intelligence-pack",
-    escalation_readiness_state: escalationReadinessState,
-    signoff_motion_state: signoffMotionState,
-    handoff_continuity_state: handoffContinuityState,
-    recommended_governance_motion: "governance_console_and_signoff_followthrough",
-    next_best_action: nextBestAction,
-    explanation_signals: {
-      review_count: Number(dashboard.queue_summary?.review_count || 0),
-      dispute_count: Number(dashboard.queue_summary?.dispute_count || 0),
-      signoff_ready_count: Number(dashboard.queue_summary?.signoff_ready_count || 0),
-      escalation_ready_count: Number(adminView.oversight_summary?.escalation_ready_count || 0),
-      oversight_queue_count: Number(adminView.oversight_summary?.queue_count || 0),
-      open_case_count: Number(disputesSummary.open_case_count || 0),
-      case_count: Number(disputesSummary.case_count || 0),
-      console_section_count: Array.isArray(consolePack.included_sections) ? consolePack.included_sections.length : 0,
-      handoff_section_count: Array.isArray(handoffBundle.included_sections) ? handoffBundle.included_sections.length : 0
-    },
-    linked_surfaces: {
-      governance_dashboard_ref: "/v1/proof-center/governance/dashboard",
-      governance_admin_view_ref: "/v1/proof-center/governance/admin-view",
-      governance_signoff_pack_ref: "/v1/proof-center/governance/signoff-pack",
-      governance_console_pack_ref: "/v1/proof-center/governance/console-pack",
-      governance_handoff_bundle_ref: "/v1/proof-center/governance/handoff-bundle",
-      governance_disputes_summary_ref: "/v1/proof-center/governance/disputes/summary"
-    }
-  };
-}
-
-function summarizeGovernanceIntelligencePack(input) {
-  const pack = buildGovernanceIntelligencePack(input);
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    escalation_readiness_state: pack.escalation_readiness_state,
-    signoff_motion_state: pack.signoff_motion_state,
-    handoff_continuity_state: pack.handoff_continuity_state,
-    next_best_action: pack.next_best_action,
-    signal_count: Object.keys(pack.explanation_signals).length
-  };
-}
-
-module.exports = {
-  buildGovernanceIntelligencePack,
-  summarizeGovernanceIntelligencePack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const proofSdk = require("../proof_sdk");
+
+function classifyEscalationReadinessState(adminView, disputesSummary) {
+  const escalationReadyCount = Number(adminView.oversight_summary?.escalation_ready_count || 0);
+  const openCaseCount = Number(disputesSummary.open_case_count || 0);
+  if (escalationReadyCount >= 1 && openCaseCount >= 2) return "active";
+  if (escalationReadyCount >= 1 || openCaseCount >= 1) return "watch";
+  return "quiet";
+}
+
+function classifySignoffMotionState(dashboard, signoffPack) {
+  const signoffReadyCount = Number(dashboard.queue_summary?.signoff_ready_count || 0);
+  if (signoffPack.signoff_status === "review_ready" && signoffReadyCount >= 1) return "review_ready";
+  if (signoffReadyCount >= 1) return "forming";
+  return "early";
+}
+
+function classifyHandoffContinuityState(handoffBundle) {
+  const includedSectionCount = Array.isArray(handoffBundle.included_sections)
+    ? handoffBundle.included_sections.length
+    : 0;
+  if (
+    includedSectionCount >= 4
+    && handoffBundle.review_summary_surface
+    && handoffBundle.handoff_run_surface
+  ) {
+    return "strong";
+  }
+  if (includedSectionCount >= 2) return "working";
+  return "thin";
+}
+
+function buildGovernanceIntelligencePack(input) {
+  const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+  const dashboard = proofSdk.summarizeGovernanceDashboard(payload);
+  const adminView = proofSdk.summarizeGovernanceAdminView(payload);
+  const disputesSummary = proofSdk.summarizeGovernanceDisputes(payload);
+  const signoffPack = proofSdk.buildGovernanceSignoffPack(payload);
+  const consolePack = proofSdk.buildGovernanceConsolePack(payload);
+  const handoffBundle = proofSdk.buildGovernanceHandoffBundle(payload);
+
+  const escalationReadinessState = classifyEscalationReadinessState(adminView, disputesSummary);
+  const signoffMotionState = classifySignoffMotionState(dashboard, signoffPack);
+  const handoffContinuityState = classifyHandoffContinuityState(handoffBundle);
+
+  let nextBestAction = "continue_governance_flow";
+  if (escalationReadinessState === "active") {
+    nextBestAction = "escalate_governance_attention";
+  } else if (signoffMotionState === "review_ready") {
+    nextBestAction = "advance_signoff_motion";
+  } else if (handoffContinuityState !== "strong") {
+    nextBestAction = "strengthen_handoff_continuity";
+  } else if (escalationReadinessState === "watch") {
+    nextBestAction = "inspect_governance_console";
+  }
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-governance-intelligence-pack",
+    escalation_readiness_state: escalationReadinessState,
+    signoff_motion_state: signoffMotionState,
+    handoff_continuity_state: handoffContinuityState,
+    recommended_governance_motion: "governance_console_and_signoff_followthrough",
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      review_count: Number(dashboard.queue_summary?.review_count || 0),
+      dispute_count: Number(dashboard.queue_summary?.dispute_count || 0),
+      signoff_ready_count: Number(dashboard.queue_summary?.signoff_ready_count || 0),
+      escalation_ready_count: Number(adminView.oversight_summary?.escalation_ready_count || 0),
+      oversight_queue_count: Number(adminView.oversight_summary?.queue_count || 0),
+      open_case_count: Number(disputesSummary.open_case_count || 0),
+      case_count: Number(disputesSummary.case_count || 0),
+      console_section_count: Array.isArray(consolePack.included_sections) ? consolePack.included_sections.length : 0,
+      handoff_section_count: Array.isArray(handoffBundle.included_sections) ? handoffBundle.included_sections.length : 0
+    },
+    linked_surfaces: {
+      governance_dashboard_ref: "/v1/proof-center/governance/dashboard",
+      governance_admin_view_ref: "/v1/proof-center/governance/admin-view",
+      governance_signoff_pack_ref: "/v1/proof-center/governance/signoff-pack",
+      governance_console_pack_ref: "/v1/proof-center/governance/console-pack",
+      governance_handoff_bundle_ref: "/v1/proof-center/governance/handoff-bundle",
+      governance_disputes_summary_ref: "/v1/proof-center/governance/disputes/summary"
+    }
+  };
+}
+
+function summarizeGovernanceIntelligencePack(input) {
+  const pack = buildGovernanceIntelligencePack(input);
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    escalation_readiness_state: pack.escalation_readiness_state,
+    signoff_motion_state: pack.signoff_motion_state,
+    handoff_continuity_state: pack.handoff_continuity_state,
+    next_best_action: pack.next_best_action,
+    signal_count: Object.keys(pack.explanation_signals).length
+  };
+}
+
+module.exports = {
+  buildGovernanceIntelligencePack,
+  summarizeGovernanceIntelligencePack
+};

package/lib/identity_interop_contract.js

@@ -1,83 +1,83 @@
-"use strict";
-
-const pkg = require("../package.json");
-
-function buildIdentityInteropContract() {
-  return {
-    product: "xoonya",
-    category: "proof-identity-interop-contract",
-    contract_version: "xoonya-identity-interop-contract-v1",
-    service_version: pkg.version,
-    primary_posture: "native_proof_and_attestation_followthrough_with_jwt_and_did_vc_interop",
-    supported_interop_profiles: [
-      {
-        profile_id: "jwt_jws_jwk_proof_assertions",
-        standards: ["jwt", "jws", "jwk"],
-        intended_use: "signed proof-side assertions and compact interop around verification and bridge intake",
-        primary_routes: ["/v1/proof-bundles/verify", "/v1/auth-profiles"]
-      },
-      {
-        profile_id: "did_vc_attestation_bridge",
-        standards: ["did_core", "vc_data_model"],
-        intended_use: "portable attestation and proof-bearing identity exchange around proof review and external verification",
-        primary_routes: ["/v1/phases/phase-4/identity-registry/proof", "/v1/phases/phase-4/attestation/proof"]
-      },
-      {
-        profile_id: "sd_jwt_vc_selective_review_disclosure",
-        standards: ["sd-jwt-vc", "jwt", "jws"],
-        intended_use: "bounded selective disclosure for proof-side review and bridge compatibility contexts",
-        primary_routes: ["/v1/proof-center/bridge/compatibility-pack", "/v1/proof-center/bridge/economic-handoff"]
-      },
-      {
-        profile_id: "oidc4vc_oidc4vp_wallet_verifier_optional",
-        standards: ["oidc4vc", "oidc4vp"],
-        intended_use: "optional verifier and wallet interoperability for external proof presentation ecosystems",
-        primary_routes: ["/v1/identity-interop", "/v1/proof-center/bridge/profile-support"]
-      }
-    ],
-    deferred_or_optional_profiles: [
-      { profile_id: "cose_cbor_compact_proof_artifacts", standards: ["cose", "cbor"], status: "later_or_environment_specific" },
-      { profile_id: "json_ld_vc_semantic_attestation_line", standards: ["json-ld-vc"], status: "later_or_ecosystem_specific" }
-    ],
-    native_mapping: {
-      proof_verify: "/v1/proof-bundles/verify",
-      receipt_verify: "/v1/receipts/verify",
-      bridge_economic_handoff: "/v1/proof-center/bridge/economic-handoff",
-      bridge_compatibility_pack: "/v1/proof-center/bridge/compatibility-pack",
-      phase_4_identity_registry_proof: "/v1/phases/phase-4/identity-registry/proof",
-      phase_4_attestation_proof: "/v1/phases/phase-4/attestation/proof"
-    },
-    guardrails: [
-      "proof and attestation semantics remain canonical inside xoonya rather than inside external credential formats",
-      "jwt and vc interop may carry proof-bearing identity claims but must not redefine proof truth",
-      "did or vc interoperability must remain subordinate to proof review and governance checks",
-      "selective disclosure may narrow disclosure scope but must not weaken proof-side reviewability"
-    ],
-    linked_surfaces: {
-      auth_interop_ref: "/v1/auth-profiles",
-      openapi_ref: "/openapi.json",
-      asyncapi_ref: "/asyncapi.json",
-      cloudevents_ref: "/cloudevents.json",
-      service_contract_ref: "SERVICE_CONTRACT.md"
-    }
-  };
-}
-
-function summarizeIdentityInteropContract() {
-  const contract = buildIdentityInteropContract();
-  return {
-    product: "xoonya",
-    category: "proof-identity-interop-contract-summary",
-    summary_version: "xoonya-identity-interop-contract-summary-v1",
-    contract_version: contract.contract_version,
-    profile_count: contract.supported_interop_profiles.length,
-    deferred_profile_count: contract.deferred_or_optional_profiles.length,
-    primary_posture: contract.primary_posture,
-    linked_surfaces: contract.linked_surfaces
-  };
-}
-
-module.exports = {
-  buildIdentityInteropContract,
-  summarizeIdentityInteropContract
-};
+"use strict";
+
+const pkg = require("../package.json");
+
+function buildIdentityInteropContract() {
+  return {
+    product: "xoonya",
+    category: "proof-identity-interop-contract",
+    contract_version: "xoonya-identity-interop-contract-v1",
+    service_version: pkg.version,
+    primary_posture: "native_proof_and_attestation_followthrough_with_jwt_and_did_vc_interop",
+    supported_interop_profiles: [
+      {
+        profile_id: "jwt_jws_jwk_proof_assertions",
+        standards: ["jwt", "jws", "jwk"],
+        intended_use: "signed proof-side assertions and compact interop around verification and bridge intake",
+        primary_routes: ["/v1/proof-bundles/verify", "/v1/auth-profiles"]
+      },
+      {
+        profile_id: "did_vc_attestation_bridge",
+        standards: ["did_core", "vc_data_model"],
+        intended_use: "portable attestation and proof-bearing identity exchange around proof review and external verification",
+        primary_routes: ["/v1/phases/phase-4/identity-registry/proof", "/v1/phases/phase-4/attestation/proof"]
+      },
+      {
+        profile_id: "sd_jwt_vc_selective_review_disclosure",
+        standards: ["sd-jwt-vc", "jwt", "jws"],
+        intended_use: "bounded selective disclosure for proof-side review and bridge compatibility contexts",
+        primary_routes: ["/v1/proof-center/bridge/compatibility-pack", "/v1/proof-center/bridge/economic-handoff"]
+      },
+      {
+        profile_id: "oidc4vc_oidc4vp_wallet_verifier_optional",
+        standards: ["oidc4vc", "oidc4vp"],
+        intended_use: "optional verifier and wallet interoperability for external proof presentation ecosystems",
+        primary_routes: ["/v1/identity-interop", "/v1/proof-center/bridge/profile-support"]
+      }
+    ],
+    deferred_or_optional_profiles: [
+      { profile_id: "cose_cbor_compact_proof_artifacts", standards: ["cose", "cbor"], status: "later_or_environment_specific" },
+      { profile_id: "json_ld_vc_semantic_attestation_line", standards: ["json-ld-vc"], status: "later_or_ecosystem_specific" }
+    ],
+    native_mapping: {
+      proof_verify: "/v1/proof-bundles/verify",
+      receipt_verify: "/v1/receipts/verify",
+      bridge_economic_handoff: "/v1/proof-center/bridge/economic-handoff",
+      bridge_compatibility_pack: "/v1/proof-center/bridge/compatibility-pack",
+      phase_4_identity_registry_proof: "/v1/phases/phase-4/identity-registry/proof",
+      phase_4_attestation_proof: "/v1/phases/phase-4/attestation/proof"
+    },
+    guardrails: [
+      "proof and attestation semantics remain canonical inside xoonya rather than inside external credential formats",
+      "jwt and vc interop may carry proof-bearing identity claims but must not redefine proof truth",
+      "did or vc interoperability must remain subordinate to proof review and governance checks",
+      "selective disclosure may narrow disclosure scope but must not weaken proof-side reviewability"
+    ],
+    linked_surfaces: {
+      auth_interop_ref: "/v1/auth-profiles",
+      openapi_ref: "/openapi.json",
+      asyncapi_ref: "/asyncapi.json",
+      cloudevents_ref: "/cloudevents.json",
+      service_contract_ref: "SERVICE_CONTRACT.md"
+    }
+  };
+}
+
+function summarizeIdentityInteropContract() {
+  const contract = buildIdentityInteropContract();
+  return {
+    product: "xoonya",
+    category: "proof-identity-interop-contract-summary",
+    summary_version: "xoonya-identity-interop-contract-summary-v1",
+    contract_version: contract.contract_version,
+    profile_count: contract.supported_interop_profiles.length,
+    deferred_profile_count: contract.deferred_or_optional_profiles.length,
+    primary_posture: contract.primary_posture,
+    linked_surfaces: contract.linked_surfaces
+  };
+}
+
+module.exports = {
+  buildIdentityInteropContract,
+  summarizeIdentityInteropContract
+};