xytara 3.1.0 → 3.1.2

package/lib/lifecycle_continuity_contract.js

@@ -1,115 +1,115 @@
-"use strict";
-
-const packageJson = require("../package.json");
-const { buildFullCatalogPack, summarizeFullCatalogPack } = require("./full_catalog_contract");
-
-function uniqueSorted(values) {
-  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
-}
-
-function buildLifecycleContinuityStages() {
-  const fullCatalogPack = buildFullCatalogPack();
-  const lifecycleMatrix = Array.isArray(fullCatalogPack.lifecycle_matrix) ? fullCatalogPack.lifecycle_matrix : [];
-  const familyOperations = Array.isArray(fullCatalogPack.family_operations) ? fullCatalogPack.family_operations : [];
-  const operationsByStage = new Map();
-
-  for (const operation of familyOperations) {
-    if (!operation || !operation.lifecycle_stage || operationsByStage.has(operation.lifecycle_stage)) {
-      continue;
-    }
-    operationsByStage.set(operation.lifecycle_stage, operation);
-  }
-
-  return lifecycleMatrix.map((entry) => {
-    const operation = operationsByStage.get(entry.lifecycle_stage) || null;
-    const isFollowthrough = entry.lifecycle_stage === "verify" || (operation && operation.evidence_status === "xoonya_followthrough");
-    const callSurface = operation
-      ? operation.call_surface
-      : "https://xoonya.onrender.com/v1/proof-center/verification-services/summary";
-
-    return {
-      lifecycle_stage: entry.lifecycle_stage,
-      lifecycle_label: entry.lifecycle_label,
-      operation_ref: operation ? operation.operation_ref : "xoonya.bundle_verify",
-      claim_status: operation ? operation.claim_status : "bounded_live",
-      evidence_status: operation ? operation.evidence_status : "xoonya_followthrough",
-      call_surface: callSurface,
-      task_refs: uniqueSorted(operation ? operation.task_refs : []),
-      fully_surfaced: Boolean(entry.fully_surfaced),
-      proof_followthrough: isFollowthrough,
-      expected_outcome: operation
-        ? operation.operation_ref === "family.dispute_open"
-          ? "open a reviewable dispute handoff without pretending it is standalone legal judgment"
-          : operation.operation_ref === "family.dispute_fetch"
-            ? "fetch the carried dispute bundle and keep the followthrough visible"
-            : `carry the ${entry.lifecycle_label} stage through the bounded public lifecycle rail`
-        : "verify the carried bundle and proof continuity through xoonya followthrough"
-    };
-  });
-}
-
-function buildLifecycleContinuityPack() {
-  const fullCatalogPack = buildFullCatalogPack();
-  const stages = buildLifecycleContinuityStages();
-  const lifecycleStageCount = stages.length;
-  const fullySurfacedLifecycleCount = stages.filter((entry) => entry.fully_surfaced).length;
-  const firstPartyCallableLifecycleCount = stages.filter((entry) => entry.fully_surfaced && !entry.proof_followthrough).length;
-  const proofFollowthroughLifecycleCount = stages.filter((entry) => entry.proof_followthrough).length;
-  const disputeFollowthroughLifecycleCount = stages.filter((entry) => ["dispute_open", "dispute_fetch"].includes(entry.lifecycle_stage)).length;
-
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "machine-commerce-lifecycle-continuity-pack",
-    pack_version: "xytara-lifecycle-continuity-pack-v1",
-    continuity_state: "full_lifecycle_path_visible_with_cross_package_followthrough",
-    doctrine: "the full lifecycle stays inspectable without overclaiming universal provider or proof ownership",
-    lifecycle_stage_count: lifecycleStageCount,
-    fully_surfaced_lifecycle_count: fullySurfacedLifecycleCount,
-    first_party_callable_lifecycle_count: firstPartyCallableLifecycleCount,
-    proof_followthrough_lifecycle_count: proofFollowthroughLifecycleCount,
-    dispute_followthrough_lifecycle_count: disputeFollowthroughLifecycleCount,
-    lifecycle_stages: stages,
-    lifecycle_stage_refs: stages.map((entry) => entry.lifecycle_stage),
-    lifecycle_summary: summarizeFullCatalogPack(),
-    linked_surfaces: {
-      full_catalog_ref: "/v1/full-catalog",
-      full_catalog_summary_ref: "/v1/full-catalog/summary",
-      xytara_provider_runtime_journeys_summary_ref: "/v1/providers/journeys/summary",
-      xytara_first_run_conversions_summary_ref: "/v1/first-run/conversions/summary",
-      xytara_delivery_summary_ref: "/v1/deliveries/summary",
-      xytara_runtime_durability_summary_ref: "/v1/runtime/durability/summary",
-      xytara_revenue_launch_paths_summary_ref: "/v1/revenue-launch/paths/summary",
-      xoonya_verification_services_summary_ref: "https://xoonya.onrender.com/v1/proof-center/verification-services/summary",
-      xoonya_governance_disputes_summary_ref: "https://xoonya.onrender.com/v1/proof-center/governance/disputes/summary"
-    },
-    claim_boundary: "claim_lifecycle_continuity_only_for_the_listed_first_party_callable_and_xoonya_followthrough_surfaces_without_implying_universal_transaction_control"
-  };
-}
-
-function summarizeLifecycleContinuityPack() {
-  const pack = buildLifecycleContinuityPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: "machine-commerce-lifecycle-continuity-summary",
-    summary_version: "xytara-lifecycle-continuity-summary-v1",
-    lifecycle_stage_count: pack.lifecycle_stage_count,
-    fully_surfaced_lifecycle_count: pack.fully_surfaced_lifecycle_count,
-    first_party_callable_lifecycle_count: pack.first_party_callable_lifecycle_count,
-    proof_followthrough_lifecycle_count: pack.proof_followthrough_lifecycle_count,
-    dispute_followthrough_lifecycle_count: pack.dispute_followthrough_lifecycle_count,
-    linked_surfaces: pack.linked_surfaces
-  };
-}
-
-function getLifecycleContinuityStageDetail(lifecycleStage) {
-  const normalized = String(lifecycleStage || "").trim().toLowerCase();
-  return buildLifecycleContinuityStages().find((entry) => entry.lifecycle_stage === normalized) || null;
-}
-
-module.exports = {
-  buildLifecycleContinuityPack,
-  summarizeLifecycleContinuityPack,
-  getLifecycleContinuityStageDetail
-};
+"use strict";
+
+const packageJson = require("../package.json");
+const { buildFullCatalogPack, summarizeFullCatalogPack } = require("./full_catalog_contract");
+
+function uniqueSorted(values) {
+  return Array.from(new Set((Array.isArray(values) ? values : []).filter(Boolean))).sort();
+}
+
+function buildLifecycleContinuityStages() {
+  const fullCatalogPack = buildFullCatalogPack();
+  const lifecycleMatrix = Array.isArray(fullCatalogPack.lifecycle_matrix) ? fullCatalogPack.lifecycle_matrix : [];
+  const familyOperations = Array.isArray(fullCatalogPack.family_operations) ? fullCatalogPack.family_operations : [];
+  const operationsByStage = new Map();
+
+  for (const operation of familyOperations) {
+    if (!operation || !operation.lifecycle_stage || operationsByStage.has(operation.lifecycle_stage)) {
+      continue;
+    }
+    operationsByStage.set(operation.lifecycle_stage, operation);
+  }
+
+  return lifecycleMatrix.map((entry) => {
+    const operation = operationsByStage.get(entry.lifecycle_stage) || null;
+    const isFollowthrough = entry.lifecycle_stage === "verify" || (operation && operation.evidence_status === "xoonya_followthrough");
+    const callSurface = operation
+      ? operation.call_surface
+      : "https://xoonya.onrender.com/v1/proof-center/verification-services/summary";
+
+    return {
+      lifecycle_stage: entry.lifecycle_stage,
+      lifecycle_label: entry.lifecycle_label,
+      operation_ref: operation ? operation.operation_ref : "xoonya.bundle_verify",
+      claim_status: operation ? operation.claim_status : "bounded_live",
+      evidence_status: operation ? operation.evidence_status : "xoonya_followthrough",
+      call_surface: callSurface,
+      task_refs: uniqueSorted(operation ? operation.task_refs : []),
+      fully_surfaced: Boolean(entry.fully_surfaced),
+      proof_followthrough: isFollowthrough,
+      expected_outcome: operation
+        ? operation.operation_ref === "family.dispute_open"
+          ? "open a reviewable dispute handoff without pretending it is standalone legal judgment"
+          : operation.operation_ref === "family.dispute_fetch"
+            ? "fetch the carried dispute bundle and keep the followthrough visible"
+            : `carry the ${entry.lifecycle_label} stage through the bounded public lifecycle rail`
+        : "verify the carried bundle and proof continuity through xoonya followthrough"
+    };
+  });
+}
+
+function buildLifecycleContinuityPack() {
+  const fullCatalogPack = buildFullCatalogPack();
+  const stages = buildLifecycleContinuityStages();
+  const lifecycleStageCount = stages.length;
+  const fullySurfacedLifecycleCount = stages.filter((entry) => entry.fully_surfaced).length;
+  const firstPartyCallableLifecycleCount = stages.filter((entry) => entry.fully_surfaced && !entry.proof_followthrough).length;
+  const proofFollowthroughLifecycleCount = stages.filter((entry) => entry.proof_followthrough).length;
+  const disputeFollowthroughLifecycleCount = stages.filter((entry) => ["dispute_open", "dispute_fetch"].includes(entry.lifecycle_stage)).length;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-lifecycle-continuity-pack",
+    pack_version: "xytara-lifecycle-continuity-pack-v1",
+    continuity_state: "full_lifecycle_path_visible_with_cross_package_followthrough",
+    doctrine: "the full lifecycle stays inspectable without overclaiming universal provider or proof ownership",
+    lifecycle_stage_count: lifecycleStageCount,
+    fully_surfaced_lifecycle_count: fullySurfacedLifecycleCount,
+    first_party_callable_lifecycle_count: firstPartyCallableLifecycleCount,
+    proof_followthrough_lifecycle_count: proofFollowthroughLifecycleCount,
+    dispute_followthrough_lifecycle_count: disputeFollowthroughLifecycleCount,
+    lifecycle_stages: stages,
+    lifecycle_stage_refs: stages.map((entry) => entry.lifecycle_stage),
+    lifecycle_summary: summarizeFullCatalogPack(),
+    linked_surfaces: {
+      full_catalog_ref: "/v1/full-catalog",
+      full_catalog_summary_ref: "/v1/full-catalog/summary",
+      xytara_provider_runtime_journeys_summary_ref: "/v1/providers/journeys/summary",
+      xytara_first_run_conversions_summary_ref: "/v1/first-run/conversions/summary",
+      xytara_delivery_summary_ref: "/v1/deliveries/summary",
+      xytara_runtime_durability_summary_ref: "/v1/runtime/durability/summary",
+      xytara_revenue_launch_paths_summary_ref: "/v1/revenue-launch/paths/summary",
+      xoonya_verification_services_summary_ref: "https://xoonya.onrender.com/v1/proof-center/verification-services/summary",
+      xoonya_governance_disputes_summary_ref: "https://xoonya.onrender.com/v1/proof-center/governance/disputes/summary"
+    },
+    claim_boundary: "claim_lifecycle_continuity_only_for_the_listed_first_party_callable_and_xoonya_followthrough_surfaces_without_implying_universal_transaction_control"
+  };
+}
+
+function summarizeLifecycleContinuityPack() {
+  const pack = buildLifecycleContinuityPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: "machine-commerce-lifecycle-continuity-summary",
+    summary_version: "xytara-lifecycle-continuity-summary-v1",
+    lifecycle_stage_count: pack.lifecycle_stage_count,
+    fully_surfaced_lifecycle_count: pack.fully_surfaced_lifecycle_count,
+    first_party_callable_lifecycle_count: pack.first_party_callable_lifecycle_count,
+    proof_followthrough_lifecycle_count: pack.proof_followthrough_lifecycle_count,
+    dispute_followthrough_lifecycle_count: pack.dispute_followthrough_lifecycle_count,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+function getLifecycleContinuityStageDetail(lifecycleStage) {
+  const normalized = String(lifecycleStage || "").trim().toLowerCase();
+  return buildLifecycleContinuityStages().find((entry) => entry.lifecycle_stage === normalized) || null;
+}
+
+module.exports = {
+  buildLifecycleContinuityPack,
+  summarizeLifecycleContinuityPack,
+  getLifecycleContinuityStageDetail
+};

package/lib/machine_identity_registry_contract.js

@@ -1,199 +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: "xytara_treats_machine_identity_as_core_control_plane_vocabulary_with_registry_key_and_delegation_state",
-    model_state: "core_now",
-    core_claim: "the machine identity registry is the shared state machine for subject, key, delegation, attestation, and revocation truth across the runtime stack",
-    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",
-          "/v1/phases/phase-4/identity-registry/summary",
-          "/v1/identity/bindings",
-          "/v1/account-auth/authority-bindings",
-          "/v1/account-auth/spend-credentials"
-        ]
-      }
-    ],
-    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_registration",
-        order_index: 1,
-        objects: ["machine_identity_record"],
-        invariants: [
-          "the_registry_can_name_the_subject_unambiguously",
-          "the_registry_record_is_commitment_backed_and_versioned"
-        ]
-      },
-      {
-        layer_id: "authority_binding",
-        order_index: 2,
-        objects: ["machine_identity_record"],
-        invariants: [
-          "keys_delegations_and_attestations_can_bind_to_the_subject",
-          "revocation_and_status_changes_remain_explicit"
-        ]
-      },
-      {
-        layer_id: "proof_followthrough",
-        order_index: 3,
-        objects: ["machine_identity_record"],
-        invariants: [
-          "the_registry_record_can_be_reviewed_or_proved_without_becoming_a_proof_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_control_plane_truth_not_a_generic_web_claim_container"
-    ],
-    linked_surfaces: {
-      identity_registry_ref: "/v1/phases/phase-4/identity-registry",
-      identity_registry_summary_ref: "/v1/phases/phase-4/identity-registry/summary",
-      identity_binding_ref: "/v1/identity/bindings",
-      authority_binding_ref: "/v1/account-auth/authority-bindings",
-      spend_credential_ref: "/v1/account-auth/spend-credentials"
-    },
-    claim_boundary: "claim_the_machine_identity_registry_control_plane_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
-};
+"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: "xytara_treats_machine_identity_as_core_control_plane_vocabulary_with_registry_key_and_delegation_state",
+    model_state: "core_now",
+    core_claim: "the machine identity registry is the shared state machine for subject, key, delegation, attestation, and revocation truth across the runtime stack",
+    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",
+          "/v1/phases/phase-4/identity-registry/summary",
+          "/v1/identity/bindings",
+          "/v1/account-auth/authority-bindings",
+          "/v1/account-auth/spend-credentials"
+        ]
+      }
+    ],
+    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_registration",
+        order_index: 1,
+        objects: ["machine_identity_record"],
+        invariants: [
+          "the_registry_can_name_the_subject_unambiguously",
+          "the_registry_record_is_commitment_backed_and_versioned"
+        ]
+      },
+      {
+        layer_id: "authority_binding",
+        order_index: 2,
+        objects: ["machine_identity_record"],
+        invariants: [
+          "keys_delegations_and_attestations_can_bind_to_the_subject",
+          "revocation_and_status_changes_remain_explicit"
+        ]
+      },
+      {
+        layer_id: "proof_followthrough",
+        order_index: 3,
+        objects: ["machine_identity_record"],
+        invariants: [
+          "the_registry_record_can_be_reviewed_or_proved_without_becoming_a_proof_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_control_plane_truth_not_a_generic_web_claim_container"
+    ],
+    linked_surfaces: {
+      identity_registry_ref: "/v1/phases/phase-4/identity-registry",
+      identity_registry_summary_ref: "/v1/phases/phase-4/identity-registry/summary",
+      identity_binding_ref: "/v1/identity/bindings",
+      authority_binding_ref: "/v1/account-auth/authority-bindings",
+      spend_credential_ref: "/v1/account-auth/spend-credentials"
+    },
+    claim_boundary: "claim_the_machine_identity_registry_control_plane_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
+};