xytara 2.0.0 → 2.2.0

package/lib/phase_8_freeze_baseline_pack.js

@@ -0,0 +1,71 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8FreezeBaselinePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-freeze-baseline-pack",
+    phase_ref: "phase_8",
+    posture: "frozen_baseline",
+    baseline: {
+      lane_refs: [
+        "/v1/phases/phase-8/external-result-import/summary",
+        "/v1/phases/phase-8/external-receipt-import/summary",
+        "/v1/phases/phase-8/proof-bundle-normalization/summary"
+      ],
+      import_modes: ["result_fact_capture", "receipt_handoff_capture", "proof_bundle_normalization"],
+      result_modes: ["result_ingest_flow", "result_mapping_flow", "result_handoff_flow"],
+      receipt_modes: ["receipt_ingest_flow", "settlement_mapping_flow", "receipt_handoff_flow"],
+      normalization_modes: ["bundle_merge_flow", "shape_alignment_flow", "continuation_export_flow"],
+      baseline_status: "recorded",
+      frozen_outputs: [
+        "current proof-bridge lane family is the recorded Phase 8 baseline",
+        "proof-bridge family can now be judged against a stable shape rather than an open expansion set",
+        "only the final gate review remains before Phase 9"
+      ]
+    },
+    first_path: {
+      purpose: "show that the Phase 8 proof-bridge lane family is now treated as a frozen baseline",
+      first_http_sequence: [
+        "/v1/phases/phase-8/summary",
+        "/v1/phases/phase-8/freeze-baseline/summary",
+        "/v1/phases/phase-8/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-8-freeze-baseline --summary",
+        "xytara-release --phase-8 --summary"
+      ],
+      expected_signals: [
+        "the proof-bridge lane family is now explicitly frozen",
+        "lane freeze is no longer part of the remaining Phase 8 uncertainty",
+        "the final open work is narrowed to gate review rather than shape definition"
+      ]
+    }
+  };
+}
+
+function summarizePhase8FreezeBaselinePack() {
+  const pack = buildPhase8FreezeBaselinePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.baseline.lane_refs.length,
+    import_mode_count: pack.baseline.import_modes.length,
+    result_mode_count: pack.baseline.result_modes.length,
+    receipt_mode_count: pack.baseline.receipt_modes.length,
+    normalization_mode_count: pack.baseline.normalization_modes.length,
+    baseline_status: pack.baseline.baseline_status,
+    frozen_output_count: pack.baseline.frozen_outputs.length,
+    signal_count: pack.first_path.expected_signals.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase8FreezeBaselinePack,
+  summarizePhase8FreezeBaselinePack
+};

package/lib/phase_8_freeze_review_pack.js

@@ -0,0 +1,64 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8FreezeReviewPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-freeze-review-pack",
+    phase_ref: "phase_8",
+    posture: "freeze_review",
+    freeze_review: {
+      lane_refs: [
+        "/v1/phases/phase-8/external-result-import/summary",
+        "/v1/phases/phase-8/external-receipt-import/summary",
+        "/v1/phases/phase-8/proof-bundle-normalization/summary"
+      ],
+      import_modes: ["result_fact_capture", "receipt_handoff_capture", "proof_bundle_normalization"],
+      review_questions: [
+        "Is the current proof-bridge lane family the intended final Phase 8 breadth?",
+        "Are import and normalization roles coherent across result, receipt, and bundle lanes?",
+        "Do operator surfaces expose enough review posture for the proof-bridge family?",
+        "Is the family ready to freeze before opening Phase 9?"
+      ],
+      resolution_criteria: [
+        { ref: "criterion.bridge_breadth_confirmed", label: "The final proof-bridge lane breadth is confirmed", satisfied: true },
+        { ref: "criterion.bridge_roles_confirmed", label: "Import and normalization roles are coherent across the family", satisfied: true },
+        { ref: "criterion.freeze_decision_recorded", label: "The freeze decision is explicitly recorded", satisfied: true },
+        { ref: "criterion.gate_review_recorded", label: "The next-phase gate review is explicitly recorded", satisfied: true }
+      ],
+      blockers: [],
+      outputs: [
+        "the final Phase 8 proof-bridge lane shape is frozen",
+        "the remaining gate blockers are explicit and inspectable",
+        "Phase 8 can be closed deliberately rather than implicitly"
+      ],
+      decision_posture: "freeze_review_recorded"
+    }
+  };
+}
+
+function summarizePhase8FreezeReviewPack() {
+  const pack = buildPhase8FreezeReviewPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.freeze_review.lane_refs.length,
+    import_mode_count: pack.freeze_review.import_modes.length,
+    review_question_count: pack.freeze_review.review_questions.length,
+    resolution_criteria_count: pack.freeze_review.resolution_criteria.length,
+    satisfied_resolution_count: pack.freeze_review.resolution_criteria.filter((criterion) => criterion.satisfied === true).length,
+    unsatisfied_resolution_count: pack.freeze_review.resolution_criteria.filter((criterion) => criterion.satisfied !== true).length,
+    blocker_count: pack.freeze_review.blockers.length,
+    freeze_output_count: pack.freeze_review.outputs.length,
+    decision_posture: pack.freeze_review.decision_posture
+  };
+}
+
+module.exports = {
+  buildPhase8FreezeReviewPack,
+  summarizePhase8FreezeReviewPack
+};

package/lib/phase_8_gate_pack.js

@@ -0,0 +1,58 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizePhase8CompletionPack } = require("./phase_8_completion_pack");
+const { summarizePhase8FreezeReviewPack } = require("./phase_8_freeze_review_pack");
+
+function buildPhase8GatePack() {
+  const completion = summarizePhase8CompletionPack();
+  const freezeReview = summarizePhase8FreezeReviewPack();
+  const unsatisfiedGateCount =
+    completion.unsatisfied_criteria_count +
+    freezeReview.unsatisfied_resolution_count;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-gate-pack",
+    phase_ref: "phase_8",
+    posture: "phase_gate",
+    gate: {
+      decision: unsatisfiedGateCount === 0 ? "ready_for_phase_9" : "hold_phase_8",
+      ready_for_next_phase: unsatisfiedGateCount === 0,
+      satisfied_gate_count:
+        completion.satisfied_criteria_count +
+        freezeReview.satisfied_resolution_count,
+      unsatisfied_gate_count: unsatisfiedGateCount,
+      blockers: unsatisfiedGateCount === 0 ? [] : [
+        "next-phase gate review has not been explicitly recorded"
+      ],
+      advance_when: [
+        "freeze decision is explicitly recorded",
+        "gate review is explicitly recorded",
+        "completion and freeze-review surfaces both show no unsatisfied gate criteria"
+      ]
+    }
+  };
+}
+
+function summarizePhase8GatePack() {
+  const pack = buildPhase8GatePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    satisfied_gate_count: pack.gate.satisfied_gate_count,
+    unsatisfied_gate_count: pack.gate.unsatisfied_gate_count,
+    blocker_count: pack.gate.blockers.length,
+    advance_when_count: pack.gate.advance_when.length,
+    decision: pack.gate.decision,
+    ready_for_next_phase: pack.gate.ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase8GatePack,
+  summarizePhase8GatePack
+};

package/lib/phase_8_proof_bridge_continuity_pack.js

@@ -0,0 +1,86 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8ProofBridgeContinuityPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-proof-bridge-continuity-pack",
+    phase_ref: "phase_8",
+    posture: "continuity_review",
+    continuity: {
+      lane_refs: [
+        "/v1/phases/phase-8/external-result-import/summary",
+        "/v1/phases/phase-8/external-receipt-import/summary",
+        "/v1/phases/phase-8/proof-bundle-normalization/summary"
+      ],
+      continuity_refs: ["/v1/phases/phase-8/summary"],
+      import_modes: ["result_fact_capture", "receipt_handoff_capture", "proof_bundle_normalization"],
+      bridge_modes: ["result_ingest_bridge", "receipt_ingest_bridge", "bundle_normalization_bridge"],
+      result_modes: ["result_ingest_flow", "result_mapping_flow", "result_handoff_flow"],
+      receipt_modes: ["receipt_ingest_flow", "settlement_mapping_flow", "receipt_handoff_flow"],
+      normalization_modes: ["bundle_merge_flow", "shape_alignment_flow", "continuation_export_flow"],
+      continuity_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-8/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "all current proof-bridge lanes are public and inspectable",
+        "proof-bridge posture is visible at phase level",
+        "cross-lane continuity is explicit across the Phase 8 bridge family",
+        "release-center summary reflects the proof-bridge family as one coherent slice"
+      ]
+    },
+    first_path: {
+      purpose: "show that the proof-bridge family is coherent across result import, receipt import, and normalization lanes rather than isolated summaries",
+      first_http_sequence: [
+        "/v1/phases/phase-8/summary",
+        "/v1/phases/phase-8/proof-bridge-continuity/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-8-proof-bridge-continuity --summary",
+        "xytara-release --phase-8 --summary"
+      ],
+      expected_signals: [
+        "external result import, external receipt import, and bundle normalization are linked as one proof-bridge family",
+        "bridge roles are legible without collapsing into one lane",
+        "operator surfaces stay attached to the Phase 8 lane family",
+        "Phase 8 reads as one coherent proof/import bridge slice"
+      ]
+    }
+  };
+}
+
+function summarizePhase8ProofBridgeContinuityPack() {
+  const pack = buildPhase8ProofBridgeContinuityPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.continuity.lane_refs.length,
+    continuity_ref_count: pack.continuity.continuity_refs.length,
+    import_mode_count: pack.continuity.import_modes.length,
+    bridge_mode_count: pack.continuity.bridge_modes.length,
+    result_mode_count: pack.continuity.result_modes.length,
+    receipt_mode_count: pack.continuity.receipt_modes.length,
+    normalization_mode_count: pack.continuity.normalization_modes.length,
+    continuity_surface_count: pack.continuity.continuity_surfaces.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase8ProofBridgeContinuityPack,
+  summarizePhase8ProofBridgeContinuityPack
+};

package/lib/phase_8_proof_bridges_pack.js

@@ -0,0 +1,72 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8ProofBridgesPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-proof-bridges-pack",
+    phase_ref: "phase_8",
+    status: "completed",
+    ecosystems: ["external_result_import", "external_receipt_import", "proof_bundle_normalization"],
+    lane_refs: [
+      "/v1/phases/phase-8/external-result-import/summary",
+      "/v1/phases/phase-8/external-receipt-import/summary",
+      "/v1/phases/phase-8/proof-bundle-normalization/summary"
+    ],
+    bridge_shape: {
+      import_modes: ["result_fact_capture", "receipt_handoff_capture", "proof_bundle_normalization"],
+      result_modes: ["result_ingest_flow", "result_mapping_flow", "result_handoff_flow"],
+      receipt_modes: ["receipt_ingest_flow", "settlement_mapping_flow", "receipt_handoff_flow"],
+      normalization_modes: ["bundle_merge_flow", "shape_alignment_flow", "continuation_export_flow"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-8/external-result-import/summary",
+        "/v1/phases/phase-8/external-receipt-import/summary",
+        "/v1/phases/phase-8/proof-bundle-normalization/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "broad Phase 8 proof-bridges pack is public and inspectable",
+        "external result import, external receipt import, and proof bundle normalization lanes are public and inspectable",
+        "proof-bridge posture is visible at phase level",
+        "operator surfaces stay attached to the current Phase 8 bridge family",
+        "release-center summary reflects Phase 8 activation and lane breadth"
+      ]
+    },
+    done_means: [
+      "Phase 7 is no longer the active program slice",
+      "Phase 8 has a public proof-bridge entry path",
+      "external result import, external receipt import, and proof bundle normalization are visible as explicit bridge lanes",
+      "the proof-bridge family feels operational rather than like a placeholder"
+    ]
+  };
+}
+
+function summarizePhase8ProofBridgesPack() {
+  const pack = buildPhase8ProofBridgesPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    lane_count: pack.lane_refs.length,
+    import_mode_count: pack.bridge_shape.import_modes.length,
+    result_mode_count: pack.bridge_shape.result_modes.length,
+    receipt_mode_count: pack.bridge_shape.receipt_modes.length,
+    normalization_mode_count: pack.bridge_shape.normalization_modes.length,
+    operator_surface_count: pack.bridge_shape.operator_surfaces.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    done_mean_count: pack.done_means.length,
+    first_ecosystem: pack.ecosystems[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase8ProofBridgesPack,
+  summarizePhase8ProofBridgesPack
+};

package/lib/phase_8_proof_bundle_normalization_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase8ProofBundleNormalizationRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-8-proof-bundle-normalization-runtime-pack",
+    phase_ref: "phase_8",
+    posture: "runtime_path",
+    ecosystems: ["proof_bundle_normalization"],
+    runtime_shape: {
+      import_modes: ["bundle_normalization", "evidence_shape_alignment", "continuation_bundle_export"],
+      normalization_modes: ["bundle_merge_flow", "shape_alignment_flow", "continuation_export_flow"],
+      normalization_artifacts: ["bundle_ref", "evidence_ref", "continuation_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-8/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the Phase 8 bundle-normalization bridge path for converging proof-side artifacts into a stable handoff shape",
+      first_http_sequence: [
+        "/v1/phases/phase-8/summary",
+        "/v1/phases/phase-8/proof-bundle-normalization/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-8-proof-bundle-normalization-runtime --summary",
+        "xytara-release --phase-8 --summary"
+      ],
+      expected_signals: [
+        "proof bundle normalization is a public Phase 8 lane",
+        "bundle normalization artifacts are explicit at the lane level",
+        "the proof-bridge family now reads as a broader convergence slice"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "proof bundle normalization lane is public and inspectable",
+        "bundle normalization artifacts are visible at lane level",
+        "operator surfaces remain attached to the normalization lane",
+        "the lane is ready to anchor broader proof-bridge convergence"
+      ]
+    }
+  };
+}
+
+function summarizePhase8ProofBundleNormalizationRuntimePack() {
+  const pack = buildPhase8ProofBundleNormalizationRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    import_mode_count: pack.runtime_shape.import_modes.length,
+    normalization_mode_count: pack.runtime_shape.normalization_modes.length,
+    normalization_artifact_count: pack.runtime_shape.normalization_artifacts.length,
+    completion_check_count: pack.completion.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.runtime_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase8ProofBundleNormalizationRuntimePack,
+  summarizePhase8ProofBundleNormalizationRuntimePack
+};

package/lib/phase_9_closeout_pack.js

@@ -0,0 +1,46 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase9CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-9-closeout-pack",
+    phase_ref: "phase_9",
+    posture: "closeout_plan",
+    current_decision: "ready_for_phase_10",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current treasury lane family is the intended final Phase 9 shape",
+      "confirm the recorded freeze baseline still matches the intended final Phase 9 shape",
+      "record the gate review outcome",
+      "recheck phase-9 gate summary for zero unsatisfied conditions",
+      "advance only once phase-9 gate resolves to ready_for_phase_10"
+    ],
+    completion_signals: [
+      "phase-9 completion shows no remaining focus",
+      "phase-9 decision record shows no pending records",
+      "phase-9 gate resolves to ready_for_phase_10"
+    ]
+  };
+}
+
+function summarizePhase9CloseoutPack() {
+  const pack = buildPhase9CloseoutPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    blocking_action_count: pack.blocking_actions.length,
+    action_step_count: pack.action_steps.length,
+    completion_signal_count: pack.completion_signals.length,
+    current_decision: pack.current_decision
+  };
+}
+
+module.exports = {
+  buildPhase9CloseoutPack,
+  summarizePhase9CloseoutPack
+};

package/lib/phase_9_completion_pack.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase9CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-9-completion-pack",
+    phase_ref: "phase_9",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["treasury_destinations", "custody_refs", "operator_accounting_bridges"],
+      lane_refs: [
+        "/v1/phases/phase-9/treasury-destinations/summary",
+        "/v1/phases/phase-9/custody-refs/summary",
+        "/v1/phases/phase-9/operator-accounting-bridges/summary"
+      ],
+      treasury_modes: ["treasury_destination_routing", "custody_reference_handoff", "operator_accounting_bridge"],
+      connectivity_modes: ["destination_connectivity", "custody_connectivity", "accounting_connectivity"],
+      destination_modes: ["destination_selection_flow", "destination_routing_flow", "destination_handoff_flow"],
+      custody_modes: ["custody_ref_flow", "handoff_ref_flow", "reconciliation_ref_flow"],
+      accounting_modes: ["accounting_bridge_flow", "statement_bridge_flow", "handoff_bridge_flow"],
+      ledger_artifacts: ["destination_ledger_ref", "custody_ledger_ref", "accounting_ledger_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-9/treasury-continuity/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 9 treasury connectivity pack is public and inspectable",
+        "all current Phase 9 treasury lanes are public and inspectable",
+        "treasury posture is visible at phase level",
+        "treasury continuity is explicit across the lane family",
+        "release-center summary reflects Phase 9 breadth and lane coverage",
+        "Phase 9 closure criteria are explicit before opening Phase 10"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 9 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.treasury_lane_coverage", label: "All current treasury lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.treasury_continuity_visible", label: "Treasury continuity is visible at phase level", satisfied: true },
+        { ref: "criterion.operator_surfaces_attached", label: "Operator surfaces remain attached to the treasury family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 9 treasury lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.next_phase_gate_reviewed", label: "A final freeze review has been recorded before opening Phase 10", satisfied: true }
+      ],
+      ready_for_next_phase: true,
+      remaining_focus: []
+    }
+  };
+}
+
+function summarizePhase9CompletionPack() {
+  const pack = buildPhase9CompletionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.coverage.ecosystem_refs.length,
+    lane_count: pack.coverage.lane_refs.length,
+    treasury_mode_count: pack.coverage.treasury_modes.length,
+    connectivity_mode_count: pack.coverage.connectivity_modes.length,
+    destination_mode_count: pack.coverage.destination_modes.length,
+    custody_mode_count: pack.coverage.custody_modes.length,
+    accounting_mode_count: pack.coverage.accounting_modes.length,
+    ledger_artifact_count: pack.coverage.ledger_artifacts.length,
+    operator_surface_count: pack.coverage.operator_surfaces.length,
+    completion_check_count: pack.completion.checks.length,
+    readiness_criteria_count: pack.completion.readiness_criteria.length,
+    satisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied === true).length,
+    unsatisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied !== true).length,
+    remaining_focus_count: pack.completion.remaining_focus.length,
+    ready_for_next_phase: pack.completion.ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase9CompletionPack,
+  summarizePhase9CompletionPack
+};

package/lib/phase_9_custody_refs_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase9CustodyRefsRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-9-custody-refs-runtime-pack",
+    phase_ref: "phase_9",
+    posture: "runtime_path",
+    ecosystems: ["custody_refs"],
+    runtime_shape: {
+      treasury_modes: ["destination_routing", "custody_handoff", "operator_accounting_bridge"],
+      custody_modes: ["custody_ref_flow", "handoff_ref_flow", "reconciliation_ref_flow"],
+      ledger_artifacts: ["custody_ref", "handoff_receipt", "operator_reconciliation_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-9/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the Phase 9 custody path from treasury outputs into explicit custody handoff references",
+      first_http_sequence: [
+        "/v1/phases/phase-9/summary",
+        "/v1/phases/phase-9/custody-refs/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-9-custody-refs-runtime --summary",
+        "xytara-release --phase-9 --summary"
+      ],
+      expected_signals: [
+        "custody refs is a public Phase 9 lane",
+        "custody artifacts are explicit at the lane level",
+        "custody posture is visible before broader treasury/operator expansion"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "custody refs lane is public and inspectable",
+        "custody artifacts are visible at lane level",
+        "operator surfaces remain attached to the custody lane",
+        "the lane is ready to anchor broader treasury/operator breadth"
+      ]
+    }
+  };
+}
+
+function summarizePhase9CustodyRefsRuntimePack() {
+  const pack = buildPhase9CustodyRefsRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    treasury_mode_count: pack.runtime_shape.treasury_modes.length,
+    custody_mode_count: pack.runtime_shape.custody_modes.length,
+    ledger_artifact_count: pack.runtime_shape.ledger_artifacts.length,
+    completion_check_count: pack.completion.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.runtime_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase9CustodyRefsRuntimePack,
+  summarizePhase9CustodyRefsRuntimePack
+};