xoonya 3.0.0 → 3.1.0

package/lib/integration_matrix_contract.js

@@ -1,81 +1,81 @@
-"use strict";
-
-const { summarizeProviderLanePack } = require("./provider_lane_contract");
-const { summarizeFrameworkLanePack } = require("./framework_lane_contract");
-const { summarizeMajorRailsProofLanePack } = require("./major_rails_proof_lane_contract");
-const { summarizeTreasuryProofLanePack } = require("./treasury_proof_lane_contract");
-const { summarizeErc8004ProofLanePack } = require("./erc8004_proof_lane_contract");
-const { summarizeProofBridgeLanePack } = require("./proof_bridge_lane_contract");
-const { summarizeExternalProofImportLanePack } = require("./external_proof_import_lane_contract");
-const { summarizeResultPackageTrustLanePack } = require("./result_package_trust_lane_contract");
-const { summarizeEventSystemLanePack } = require("./event_system_lane_contract");
-const { summarizeTelemetryLanePack } = require("./telemetry_lane_contract");
-const { summarizeProvenanceLanePack } = require("./provenance_lane_contract");
-const { summarizeArtifactDistributionLanePack } = require("./artifact_distribution_lane_contract");
-const { summarizeSharedSignalsLanePack } = require("./shared_signals_lane_contract");
-const { summarizeFeatureControlLanePack } = require("./feature_control_lane_contract");
-
-function buildIntegrationMatrixPack(integrations = []) {
-  const rows = Array.isArray(integrations) ? integrations : [];
-  return {
-    product: "xoonya",
-    category: "proof-integration-matrix-pack",
-    pack_version: "xoonya-integration-matrix-pack-v1",
-    posture: "canonical_public_view_of_provider_framework_proof_bridge_registry_and_trust_breadth",
-    counts: {
-      integration_count: rows.length,
-      builtin_count: rows.filter((entry) => entry.source === "builtin").length,
-      third_party_example_count: rows.filter((entry) => entry.source === "third_party_example").length,
-      production_default_count: rows.filter((entry) => entry.integration_maturity === "production_default").length,
-      certified_count: rows.filter((entry) => entry.certification_state === "certified").length
-    },
-    top_level_lanes: {
-      providers: summarizeProviderLanePack(),
-      frameworks: summarizeFrameworkLanePack(),
-      major_rails: summarizeMajorRailsProofLanePack(),
-      treasury: summarizeTreasuryProofLanePack(),
-      erc8004: summarizeErc8004ProofLanePack(),
-      proof_bridge: summarizeProofBridgeLanePack(),
-      external_proof_import: summarizeExternalProofImportLanePack(),
-      result_package_trust: summarizeResultPackageTrustLanePack(),
-      event_systems: summarizeEventSystemLanePack(),
-      telemetry: summarizeTelemetryLanePack(),
-      provenance: summarizeProvenanceLanePack(),
-      artifact_distribution: summarizeArtifactDistributionLanePack(),
-      shared_signals: summarizeSharedSignalsLanePack(),
-      feature_control: summarizeFeatureControlLanePack()
-    },
-    supported_surfaces: {
-      integrations_ref: "/v1/integrations",
-      integration_summary_ref: "/v1/integrations/summary",
-      provider_lane_ref: "/v1/providers",
-      framework_lane_ref: "/v1/frameworks",
-      proof_bridge_ref: "/v1/proof-bridge",
-      external_proof_import_ref: "/v1/external-proof-import",
-      telemetry_lane_ref: "/v1/telemetry",
-      provenance_lane_ref: "/v1/provenance",
-      artifact_distribution_lane_ref: "/v1/artifact-distribution",
-      shared_signals_lane_ref: "/v1/shared-signals",
-      feature_control_lane_ref: "/v1/feature-control"
-    }
-  };
-}
-
-function summarizeIntegrationMatrixPack(integrations = []) {
-  const pack = buildIntegrationMatrixPack(integrations);
-  return {
-    product: "xoonya",
-    category: "proof-integration-matrix-pack-summary",
-    summary_version: "xoonya-integration-matrix-pack-summary-v1",
-    integration_count: pack.counts.integration_count,
-    production_default_count: pack.counts.production_default_count,
-    certified_count: pack.counts.certified_count,
-    lane_count: Object.keys(pack.top_level_lanes).length,
-    linked_surfaces: pack.supported_surfaces
-  };
-}
-
-module.exports = {
-  buildIntegrationMatrixPack,
-  summarizeIntegrationMatrixPack
-};
+"use strict";
+
+const { summarizeProviderLanePack } = require("./provider_lane_contract");
+const { summarizeFrameworkLanePack } = require("./framework_lane_contract");
+const { summarizeMajorRailsProofLanePack } = require("./major_rails_proof_lane_contract");
+const { summarizeTreasuryProofLanePack } = require("./treasury_proof_lane_contract");
+const { summarizeErc8004ProofLanePack } = require("./erc8004_proof_lane_contract");
+const { summarizeProofBridgeLanePack } = require("./proof_bridge_lane_contract");
+const { summarizeExternalProofImportLanePack } = require("./external_proof_import_lane_contract");
+const { summarizeResultPackageTrustLanePack } = require("./result_package_trust_lane_contract");
+const { summarizeEventSystemLanePack } = require("./event_system_lane_contract");
+const { summarizeTelemetryLanePack } = require("./telemetry_lane_contract");
+const { summarizeProvenanceLanePack } = require("./provenance_lane_contract");
+const { summarizeArtifactDistributionLanePack } = require("./artifact_distribution_lane_contract");
+const { summarizeSharedSignalsLanePack } = require("./shared_signals_lane_contract");
+const { summarizeFeatureControlLanePack } = require("./feature_control_lane_contract");
+
+function buildIntegrationMatrixPack(integrations = []) {
+  const rows = Array.isArray(integrations) ? integrations : [];
+  return {
+    product: "xoonya",
+    category: "proof-integration-matrix-pack",
+    pack_version: "xoonya-integration-matrix-pack-v1",
+    posture: "canonical_public_view_of_provider_framework_proof_bridge_registry_and_trust_breadth",
+    counts: {
+      integration_count: rows.length,
+      builtin_count: rows.filter((entry) => entry.source === "builtin").length,
+      third_party_example_count: rows.filter((entry) => entry.source === "third_party_example").length,
+      production_default_count: rows.filter((entry) => entry.integration_maturity === "production_default").length,
+      certified_count: rows.filter((entry) => entry.certification_state === "certified").length
+    },
+    top_level_lanes: {
+      providers: summarizeProviderLanePack(),
+      frameworks: summarizeFrameworkLanePack(),
+      major_rails: summarizeMajorRailsProofLanePack(),
+      treasury: summarizeTreasuryProofLanePack(),
+      erc8004: summarizeErc8004ProofLanePack(),
+      proof_bridge: summarizeProofBridgeLanePack(),
+      external_proof_import: summarizeExternalProofImportLanePack(),
+      result_package_trust: summarizeResultPackageTrustLanePack(),
+      event_systems: summarizeEventSystemLanePack(),
+      telemetry: summarizeTelemetryLanePack(),
+      provenance: summarizeProvenanceLanePack(),
+      artifact_distribution: summarizeArtifactDistributionLanePack(),
+      shared_signals: summarizeSharedSignalsLanePack(),
+      feature_control: summarizeFeatureControlLanePack()
+    },
+    supported_surfaces: {
+      integrations_ref: "/v1/integrations",
+      integration_summary_ref: "/v1/integrations/summary",
+      provider_lane_ref: "/v1/providers",
+      framework_lane_ref: "/v1/frameworks",
+      proof_bridge_ref: "/v1/proof-bridge",
+      external_proof_import_ref: "/v1/external-proof-import",
+      telemetry_lane_ref: "/v1/telemetry",
+      provenance_lane_ref: "/v1/provenance",
+      artifact_distribution_lane_ref: "/v1/artifact-distribution",
+      shared_signals_lane_ref: "/v1/shared-signals",
+      feature_control_lane_ref: "/v1/feature-control"
+    }
+  };
+}
+
+function summarizeIntegrationMatrixPack(integrations = []) {
+  const pack = buildIntegrationMatrixPack(integrations);
+  return {
+    product: "xoonya",
+    category: "proof-integration-matrix-pack-summary",
+    summary_version: "xoonya-integration-matrix-pack-summary-v1",
+    integration_count: pack.counts.integration_count,
+    production_default_count: pack.counts.production_default_count,
+    certified_count: pack.counts.certified_count,
+    lane_count: Object.keys(pack.top_level_lanes).length,
+    linked_surfaces: pack.supported_surfaces
+  };
+}
+
+module.exports = {
+  buildIntegrationMatrixPack,
+  summarizeIntegrationMatrixPack
+};

package/lib/launch_narrative.js

@@ -1,53 +1,53 @@
-"use strict";
-
-const packageJson = require("../package.json");
-
-function buildLaunchNarrativePack() {
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-launch-narrative",
-    why_now: "machine actions increasingly need reviewable evidence after they cross trust boundaries, and opaque logs or narrow receipts are not enough",
-    problem_patchwork_misses: [
-      "runtime logs do not become a stable proof contract by themselves",
-      "receipt-only systems miss reviewable carry, governance posture, and proof-native followthrough",
-      "settlement-specific proof systems do not generalize cleanly across changing runtimes and rails"
-    ],
-    strongest_public_claim: "reviewable proof continuation for machine actions that cross trust boundaries",
-    first_proof_to_run: {
-      path_ref: "scenario.carried_handoff.review",
-      why_this_first: "smallest strong-signal proof-side intake that shows carried runtime context, proof readiness, and operator review posture",
-      cli: "xoonya-review --file ./handoff.json --summary"
-    },
-    first_success_looks_like: [
-      "handoff bundle is accepted and review summary is intelligible",
-      "proof readiness is visible before proof-native continuation",
-      "economic and settlement carry survives into proof-side review",
-      "handoff and governance posture are inspectable instead of hidden"
-    ],
-    immediate_should_care: [
-      "proof operators needing carried handoff review",
-      "runtime builders needing stable verification followthrough",
-      "adapter integrators needing a durable proof contract",
-      "audit and governance teams needing reviewable machine evidence"
-    ]
-  };
-}
-
-function summarizeLaunchNarrativePack() {
-  const pack = buildLaunchNarrativePack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    patchwork_gap_count: pack.problem_patchwork_misses.length,
-    success_signal_count: pack.first_success_looks_like.length,
-    immediate_audience_count: pack.immediate_should_care.length,
-    first_path_ref: pack.first_proof_to_run.path_ref
-  };
-}
-
-module.exports = {
-  buildLaunchNarrativePack,
-  summarizeLaunchNarrativePack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildLaunchNarrativePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-launch-narrative",
+    why_now: "machine actions increasingly need reviewable evidence after they cross trust boundaries, and opaque logs or narrow receipts are not enough",
+    problem_patchwork_misses: [
+      "runtime logs do not become a stable proof contract by themselves",
+      "receipt-only systems miss reviewable carry, governance posture, and proof-native followthrough",
+      "settlement-specific proof systems do not generalize cleanly across changing runtimes and rails"
+    ],
+    strongest_public_claim: "reviewable proof continuation for machine actions that cross trust boundaries",
+    first_proof_to_run: {
+      path_ref: "scenario.carried_handoff.review",
+      why_this_first: "smallest strong-signal proof-side intake that shows carried runtime context, proof readiness, and operator review posture",
+      cli: "xoonya-review --file ./handoff.json --summary"
+    },
+    first_success_looks_like: [
+      "handoff bundle is accepted and review summary is intelligible",
+      "proof readiness is visible before proof-native continuation",
+      "economic and settlement carry survives into proof-side review",
+      "handoff and governance posture are inspectable instead of hidden"
+    ],
+    immediate_should_care: [
+      "proof operators needing carried handoff review",
+      "runtime builders needing stable verification followthrough",
+      "adapter integrators needing a durable proof contract",
+      "audit and governance teams needing reviewable machine evidence"
+    ]
+  };
+}
+
+function summarizeLaunchNarrativePack() {
+  const pack = buildLaunchNarrativePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    patchwork_gap_count: pack.problem_patchwork_misses.length,
+    success_signal_count: pack.first_success_looks_like.length,
+    immediate_audience_count: pack.immediate_should_care.length,
+    first_path_ref: pack.first_proof_to_run.path_ref
+  };
+}
+
+module.exports = {
+  buildLaunchNarrativePack,
+  summarizeLaunchNarrativePack
+};

package/lib/machine_identity_registry_contract.js

@@ -0,0 +1,199 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildMachineIdentityRegistryContractPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "naxytra-machine-identity-registry-contract",
+    pack_version: "naxytra-machine-identity-registry-contract-v1",
+    doctrine: "xoonya_reviews_machine_identity_state_as_proof_linked_followthrough_without_claiming_identity_session_or_custody_truth",
+    model_state: "core_now",
+    core_claim: "the machine identity registry is the proof-linked state machine for subject, key, delegation, attestation, and revocation followthrough",
+    canonical_objects: [
+      {
+        object_id: "machine_identity_record",
+        role: "versioned_commitment_backed_registry_record_for_a_machine_subject",
+        required_fields: [
+          "version",
+          "registry_record_id",
+          "registry_scope",
+          "subject_kind",
+          "subject_id",
+          "record_type",
+          "status",
+          "issuer_id",
+          "issued_at_ns",
+          "commitment_hash"
+        ],
+        recommended_fields: [
+          "updated_at_ns",
+          "public_key_ref",
+          "delegation_ref",
+          "revocation_ref",
+          "proof_ref",
+          "anchor_ref"
+        ],
+        optional_fields: [
+          "controller_id",
+          "parent_record_id",
+          "previous_record_id",
+          "subject_ref",
+          "trust_state",
+          "metadata"
+        ],
+        primary_surfaces: [
+          "/v1/phases/phase-4/identity-registry/proof",
+          "/v1/phases/phase-4/identity-registry/proof/summary",
+          "/v1/phases/phase-4/attestation/proof",
+          "/v1/proof-center/trust-portability",
+          "/v1/proof-center/trust-portability/summary"
+        ]
+      }
+    ],
+    subject_kinds: [
+      {
+        subject_kind: "agent",
+        description: "a software agent or operator-facing autonomous identity"
+      },
+      {
+        subject_kind: "service",
+        description: "a runtime service or machine-facing backend identity"
+      },
+      {
+        subject_kind: "device",
+        description: "a physical or embedded device identity"
+      },
+      {
+        subject_kind: "key",
+        description: "a bound public-key or credential identity"
+      },
+      {
+        subject_kind: "delegation",
+        description: "a delegated authority or capability identity"
+      },
+      {
+        subject_kind: "attestation",
+        description: "an attestation-linked identity or evidence binding"
+      }
+    ],
+    record_types: [
+      {
+        record_type: "identity_attestation",
+        description: "binds a subject to an attested identity state"
+      },
+      {
+        record_type: "registry_link",
+        description: "binds a subject into a registry scope or registry graph"
+      },
+      {
+        record_type: "key_binding",
+        description: "binds a subject to one or more active key references"
+      },
+      {
+        record_type: "delegation_grant",
+        description: "records that authority or capability has been delegated"
+      },
+      {
+        record_type: "delegation_revocation",
+        description: "records that a delegation has been revoked or retired"
+      },
+      {
+        record_type: "trust_state_update",
+        description: "records a trust, access, or permission-state update"
+      },
+      {
+        record_type: "device_registration",
+        description: "records a device subject into the registry"
+      },
+      {
+        record_type: "service_registration",
+        description: "records a service subject into the registry"
+      },
+      {
+        record_type: "agent_registration",
+        description: "records an agent subject into the registry"
+      }
+    ],
+    lineage_model: [
+      {
+        layer_id: "subject_review",
+        order_index: 1,
+        objects: ["machine_identity_record"],
+        invariants: [
+          "the_registry_subject_is_reviewable_in_proof_form",
+          "the_registry_record_is_commitment_backed_and_versioned"
+        ]
+      },
+      {
+        layer_id: "trust_portability",
+        order_index: 2,
+        objects: ["machine_identity_record"],
+        invariants: [
+          "keys_delegations_and_attestations_can_be_reviewed_across_bounded_lanes",
+          "revocation_and_status_changes_remain_explicit"
+        ]
+      },
+      {
+        layer_id: "proof_followthrough",
+        order_index: 3,
+        objects: ["machine_identity_record"],
+        invariants: [
+          "the_registry_record_can_be_carried_into_proof_without_becoming_a_new_identity_standard",
+          "anchor_and_proof_refs_are_followthrough_layers_not_identity_truth_itself"
+        ]
+      }
+    ],
+    invariants: [
+      "commitment_hash_is_derived_from_the_canonical_registry_record",
+      "registry_record_id_is_stable_and_replay_safe",
+      "status_changes_are_explicit_and_versioned",
+      "optional_proof_anchor_and_revocation_refs_do_not_change_base_registry_record_meaning",
+      "machine_identity_is_a_shared_control_plane_substrate_not_a_generic_web_claim_container"
+    ],
+    linked_surfaces: {
+      identity_registry_proof_ref: "/v1/phases/phase-4/identity-registry/proof",
+      identity_registry_proof_summary_ref: "/v1/phases/phase-4/identity-registry/proof/summary",
+      attestation_proof_ref: "/v1/phases/phase-4/attestation/proof",
+      trust_portability_ref: "/v1/proof-center/trust-portability",
+      trust_portability_summary_ref: "/v1/proof-center/trust-portability/summary"
+    },
+    claim_boundary: "claim_the_machine_identity_registry_proof_followthrough_only_without_claiming_universal_external_identity_session_or_custody_truth"
+  };
+}
+
+function summarizeMachineIdentityRegistryContractPack() {
+  const pack = buildMachineIdentityRegistryContractPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    summary_version: "naxytra-machine-identity-registry-contract-summary-v1",
+    pack_version: pack.pack_version,
+    model_state: pack.model_state,
+    subject_kind_count: pack.subject_kinds.length,
+    record_type_count: pack.record_types.length,
+    canonical_object_count: pack.canonical_objects.length,
+    layer_count: pack.lineage_model.length,
+    invariant_count: pack.invariants.length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+function getMachineIdentitySubjectKindDetail(subjectKind) {
+  const normalized = String(subjectKind || "").trim().toLowerCase();
+  return (buildMachineIdentityRegistryContractPack().subject_kinds || []).find((entry) => entry.subject_kind === normalized) || null;
+}
+
+function getMachineIdentityRecordTypeDetail(recordType) {
+  const normalized = String(recordType || "").trim().toLowerCase();
+  return (buildMachineIdentityRegistryContractPack().record_types || []).find((entry) => entry.record_type === normalized) || null;
+}
+
+module.exports = {
+  buildMachineIdentityRegistryContractPack,
+  summarizeMachineIdentityRegistryContractPack,
+  getMachineIdentitySubjectKindDetail,
+  getMachineIdentityRecordTypeDetail
+};

package/lib/major_rails_proof_lane_contract.js

@@ -1,87 +1,87 @@
-"use strict";
-
-const {
-  buildPhase5MajorRailsPack,
-  summarizePhase5MajorRailsPack
-} = require("./phase_5_major_rails_pack");
-const {
-  buildPhase5SolanaProofPack,
-  summarizePhase5SolanaProofPack
-} = require("./phase_5_solana_proof_pack");
-const {
-  buildPhase5AntelopeProofPack,
-  summarizePhase5AntelopeProofPack
-} = require("./phase_5_antelope_proof_pack");
-const {
-  buildPhase5ProtonXprProofPack,
-  summarizePhase5ProtonXprProofPack
-} = require("./phase_5_proton_xpr_proof_pack");
-
-function buildMajorRailsProofLanePack() {
-  return {
-    product: "xoonya",
-    category: "proof-major-rails-lane-pack",
-    pack_version: "xoonya-major-rails-lane-pack-v1",
-    lane_state: "first_party_major_rails_proof_family_present",
-    posture: "practical_settlement_evidence_breadth_lane",
-    family_summary: summarizePhase5MajorRailsPack(),
-    featured_lanes: {
-      solana: {
-        pack: buildPhase5SolanaProofPack(),
-        summary: summarizePhase5SolanaProofPack()
-      },
-      antelope: {
-        pack: buildPhase5AntelopeProofPack(),
-        summary: summarizePhase5AntelopeProofPack()
-      },
-      proton_xpr_and_metal: {
-        pack: buildPhase5ProtonXprProofPack(),
-        summary: summarizePhase5ProtonXprProofPack(),
-        named_family_members: ["proton_xpr", "metal"]
-      }
-    },
-    supported_surfaces: {
-      phase_summary_ref: "/v1/phases/phase-5/summary",
-      major_rails_summary_ref: "/v1/phases/phase-5/major-rails-continuity/summary",
-      solana_proof_summary_ref: "/v1/phases/phase-5/solana/proof/summary",
-      antelope_proof_summary_ref: "/v1/phases/phase-5/antelope/proof/summary",
-      proton_xpr_proof_summary_ref: "/v1/phases/phase-5/proton-xpr/proof/summary",
-      proof_bridge_ref: "/v1/proof-bridge/summary"
-    },
-    first_run_flows: [
-      {
-        flow_ref: "major_rails_proof_selection",
-        recommended_reason: "best first path for understanding practical settlement-evidence breadth across non-default rail families",
-        sequence: [
-          "inspect_major_rails_proof_lane_summary",
-          "inspect_phase_5_major_rails_summary",
-          "inspect_solana_antelope_and_proton_xpr_proof_profiles",
-          "choose_the_proof_lane_that_matches_external_settlement_evidence_shape"
-        ]
-      }
-    ],
-    guardrails: [
-      "major rails proof lanes should strengthen trust and compatibility rather than widen xoonya into a generic chain toolkit",
-      "named ecosystems help adoption only when they remain subordinate to canonical proof review and bridge followthrough"
-    ]
-  };
-}
-
-function summarizeMajorRailsProofLanePack() {
-  const pack = buildMajorRailsProofLanePack();
-  return {
-    product: "xoonya",
-    category: "proof-major-rails-lane-pack-summary",
-    summary_version: "xoonya-major-rails-lane-pack-summary-v1",
-    lane_state: pack.lane_state,
-    posture: pack.posture,
-    featured_lane_count: Object.keys(pack.featured_lanes).length,
-    first_run_flow_count: pack.first_run_flows.length,
-    linked_surfaces: pack.supported_surfaces
-  };
-}
-
-module.exports = {
-  buildMajorRailsProofLanePack,
-  summarizeMajorRailsProofLanePack
-};
+"use strict";
+
+const {
+  buildPhase5MajorRailsPack,
+  summarizePhase5MajorRailsPack
+} = require("./phase_5_major_rails_pack");
+const {
+  buildPhase5SolanaProofPack,
+  summarizePhase5SolanaProofPack
+} = require("./phase_5_solana_proof_pack");
+const {
+  buildPhase5AntelopeProofPack,
+  summarizePhase5AntelopeProofPack
+} = require("./phase_5_antelope_proof_pack");
+const {
+  buildPhase5ProtonXprProofPack,
+  summarizePhase5ProtonXprProofPack
+} = require("./phase_5_proton_xpr_proof_pack");
+
+function buildMajorRailsProofLanePack() {
+  return {
+    product: "xoonya",
+    category: "proof-major-rails-lane-pack",
+    pack_version: "xoonya-major-rails-lane-pack-v1",
+    lane_state: "first_party_major_rails_proof_family_present",
+    posture: "practical_settlement_evidence_breadth_lane",
+    family_summary: summarizePhase5MajorRailsPack(),
+    featured_lanes: {
+      solana: {
+        pack: buildPhase5SolanaProofPack(),
+        summary: summarizePhase5SolanaProofPack()
+      },
+      antelope: {
+        pack: buildPhase5AntelopeProofPack(),
+        summary: summarizePhase5AntelopeProofPack()
+      },
+      proton_xpr_and_metal: {
+        pack: buildPhase5ProtonXprProofPack(),
+        summary: summarizePhase5ProtonXprProofPack(),
+        named_family_members: ["proton_xpr", "metal"]
+      }
+    },
+    supported_surfaces: {
+      phase_summary_ref: "/v1/phases/phase-5/summary",
+      major_rails_summary_ref: "/v1/phases/phase-5/major-rails-continuity/summary",
+      solana_proof_summary_ref: "/v1/phases/phase-5/solana/proof/summary",
+      antelope_proof_summary_ref: "/v1/phases/phase-5/antelope/proof/summary",
+      proton_xpr_proof_summary_ref: "/v1/phases/phase-5/proton-xpr/proof/summary",
+      proof_bridge_ref: "/v1/proof-bridge/summary"
+    },
+    first_run_flows: [
+      {
+        flow_ref: "major_rails_proof_selection",
+        recommended_reason: "best first path for understanding practical settlement-evidence breadth across non-default rail families",
+        sequence: [
+          "inspect_major_rails_proof_lane_summary",
+          "inspect_phase_5_major_rails_summary",
+          "inspect_solana_antelope_and_proton_xpr_proof_profiles",
+          "choose_the_proof_lane_that_matches_external_settlement_evidence_shape"
+        ]
+      }
+    ],
+    guardrails: [
+      "major rails proof lanes should strengthen trust and compatibility rather than widen xoonya into a generic chain toolkit",
+      "named ecosystems help adoption only when they remain subordinate to canonical proof review and bridge followthrough"
+    ]
+  };
+}
+
+function summarizeMajorRailsProofLanePack() {
+  const pack = buildMajorRailsProofLanePack();
+  return {
+    product: "xoonya",
+    category: "proof-major-rails-lane-pack-summary",
+    summary_version: "xoonya-major-rails-lane-pack-summary-v1",
+    lane_state: pack.lane_state,
+    posture: pack.posture,
+    featured_lane_count: Object.keys(pack.featured_lanes).length,
+    first_run_flow_count: pack.first_run_flows.length,
+    linked_surfaces: pack.supported_surfaces
+  };
+}
+
+module.exports = {
+  buildMajorRailsProofLanePack,
+  summarizeMajorRailsProofLanePack
+};