xytara 2.1.0 → 2.3.0

package/lib/phase_2_gate_pack.js

@@ -0,0 +1,77 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizePhase2CompletionPack } = require("./phase_2_completion_pack");
+const { summarizePhase2FreezeReviewPack } = require("./phase_2_freeze_review_pack");
+
+function buildPhase2GatePack() {
+  const completion = summarizePhase2CompletionPack();
+  const freezeReview = summarizePhase2FreezeReviewPack();
+  const unsatisfiedGateCount =
+    completion.unsatisfied_criteria_count +
+    freezeReview.unsatisfied_resolution_count;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-gate-pack",
+    phase_ref: "phase_2",
+    posture: "phase_gate",
+    gate: {
+      decision: unsatisfiedGateCount === 0 ? "ready_for_phase_3" : "hold_phase_2",
+      ready_for_next_phase: unsatisfiedGateCount === 0,
+      satisfied_gate_count:
+        completion.satisfied_criteria_count +
+        freezeReview.satisfied_resolution_count,
+      unsatisfied_gate_count: unsatisfiedGateCount,
+      blockers: unsatisfiedGateCount === 0 ? [] : [
+        "final lane-shape freeze has not been explicitly recorded",
+        "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"
+      ]
+    },
+    sources: {
+      completion_summary: "/v1/phases/phase-2/completion/summary",
+      freeze_review_summary: "/v1/phases/phase-2/freeze-review/summary",
+      release_center_summary: "/v1/release-center/summary"
+    },
+    first_path: {
+      purpose: "decide whether Phase 2 can be deliberately closed and Phase 3 can open",
+      first_http_sequence: [
+        "/v1/phases/phase-2/completion/summary",
+        "/v1/phases/phase-2/freeze-review/summary",
+        "/v1/phases/phase-2/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-gate --summary",
+        "xytara-release --phase-2-completion --summary",
+        "xytara-release --phase-2-freeze-review --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase2GatePack() {
+  const pack = buildPhase2GatePack();
+  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 = {
+  buildPhase2GatePack,
+  summarizePhase2GatePack
+};

package/lib/phase_2_payment_rails_pack.js

@@ -0,0 +1,71 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2PaymentRailsPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-payment-rails-pack",
+    phase_ref: "phase_2",
+    status: "active",
+    ecosystems: ["evm", "base", "eth", "usdc"],
+    lane_refs: [
+      "/v1/phases/phase-2/evm/summary",
+      "/v1/phases/phase-2/evm-base/summary",
+      "/v1/phases/phase-2/base/summary",
+      "/v1/phases/phase-2/usdc/summary",
+      "/v1/phases/phase-2/base-usdc/summary",
+      "/v1/phases/phase-2/eth/summary"
+    ],
+    rail_shape: {
+      rail_family: "evm",
+      payment_assets: ["evm-native-or-tokenized-value", "base-native-or-tokenized-value", "eth", "usdc"],
+      settlement_modes: ["ethereum_evm"],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "broad EVM rail lane is public and inspectable",
+        "Base, ETH, and USDC all have standalone runtime-facing summaries",
+        "combined Base plus USDC lane stays visible for practical stablecoin execution",
+        "settlement-mode and operator surfaces stay attached to the rail family",
+        "release-center summary reflects Phase 2 breadth and step coverage"
+      ]
+    },
+    goal: "make machine-commerce rail support legible outside the native BSV-centered path",
+    done_means: [
+      "Phase 1 is no longer the active program slice",
+      "broadly legible rail support has a public runtime-facing entry path",
+      "EVM/Base/ETH/USDC work is visible as an explicit program lane instead of a future note",
+      "the rail family carries enough lane and operator detail to feel operational rather than merely named"
+    ]
+  };
+}
+
+function summarizePhase2PaymentRailsPack() {
+  const pack = buildPhase2PaymentRailsPack();
+  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,
+    payment_asset_count: pack.rail_shape.payment_assets.length,
+    settlement_mode_count: pack.rail_shape.settlement_modes.length,
+    operator_surface_count: pack.rail_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 = {
+  buildPhase2PaymentRailsPack,
+  summarizePhase2PaymentRailsPack
+};

package/lib/phase_2_usdc_runtime_pack.js

@@ -0,0 +1,71 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2UsdcRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-usdc-runtime-pack",
+    phase_ref: "phase_2",
+    ecosystem_refs: ["usdc"],
+    posture: "runtime_path",
+    settlement_shape: {
+      payment_asset: "usdc",
+      rail_family: "stablecoin_on_evm",
+      settlement_modes: ["ethereum_evm"],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "USDC runtime lane is public and inspectable",
+        "stablecoin settlement posture stays visible at the lane level",
+        "operator surfaces remain available from the USDC lane",
+        "the lane stays consistent with the combined Base plus USDC path"
+      ]
+    },
+    first_path: {
+      purpose: "show the USDC-specific runtime lane inside Phase 2's broader EVM payment-rail work",
+      first_http_sequence: [
+        "/v1/phases/phase-2/evm-base/summary",
+        "/v1/phases/phase-2/usdc/summary",
+        "/v1/integrations/settlement-modes"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-usdc-runtime --summary",
+        "xytara-release --phase-2-base-usdc-runtime --summary"
+      ],
+      expected_signals: [
+        "USDC has a dedicated runtime-facing lane instead of appearing only inside combined EVM language",
+        "stablecoin-oriented settlement posture is visible without hardwiring the whole stack to one asset",
+        "the path stays compatible with the same operator and release-center surfaces"
+      ]
+    }
+  };
+}
+
+function summarizePhase2UsdcRuntimePack() {
+  const pack = buildPhase2UsdcRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    settlement_mode_count: pack.settlement_shape.settlement_modes.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,
+    operator_surface_count: pack.settlement_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase2UsdcRuntimePack,
+  summarizePhase2UsdcRuntimePack
+};

package/lib/phase_3_brc_runtime_pack.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3BrcRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-brc-runtime-pack",
+    phase_ref: "phase_3",
+    ecosystem_refs: ["brc"],
+    posture: "runtime_path",
+    identity_shape: {
+      rail_family: "bsv_native_identity",
+      identity_layers: ["brc"],
+      registry_modes: ["record_linkage", "attestation_lookup", "subject_resolution"],
+      registry_artifacts: ["record_ref", "attestation_ref", "registry_subject_ref"],
+      continuity_refs: [
+        "/v1/phases/phase-3/native-continuity/summary",
+        "/v1/phases/phase-3/bsv-teranode/summary",
+        "/v1/phases/phase-3/metanet/summary"
+      ],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-3/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the BRC runtime lane is public and inspectable",
+        "native identity-layer posture stays attached to the runtime lane",
+        "operator surfaces remain available for native BRC review",
+        "Phase 3 shows explicit BRC-linked native expansion"
+      ]
+    },
+    first_path: {
+      purpose: "show the native BRC runtime lane for BSV-linked identity and continuity",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-brc-runtime --summary",
+        "xytara-release --phase-3 --summary"
+      ],
+      expected_signals: [
+        "BRC is visible as a first-class native runtime lane",
+        "native BRC-linked continuity is inspectable from a stable route",
+        "Phase 3 broadens beyond settlement into native registry posture"
+      ]
+    }
+  };
+}
+
+function summarizePhase3BrcRuntimePack() {
+  const pack = buildPhase3BrcRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    identity_layer_count: pack.identity_shape.identity_layers.length,
+    registry_mode_count: pack.identity_shape.registry_modes.length,
+    registry_artifact_count: pack.identity_shape.registry_artifacts.length,
+    continuity_ref_count: pack.identity_shape.continuity_refs.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,
+    operator_surface_count: pack.identity_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase3BrcRuntimePack,
+  summarizePhase3BrcRuntimePack
+};

package/lib/phase_3_bsv_teranode_runtime_pack.js

@@ -0,0 +1,83 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3BsvTeranodeRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-bsv-teranode-runtime-pack",
+    phase_ref: "phase_3",
+    ecosystem_refs: ["bsv", "teranode"],
+    posture: "runtime_path",
+    settlement_shape: {
+      rail_family: "bsv_native_with_teranode",
+      settlement_modes: ["bsv_teranode"],
+      submission_modes: ["signed_submit", "operator_replay"],
+      finality_stages: ["accepted", "observed", "settled"],
+      settlement_artifacts: ["txid", "settlement_ref", "operator_observation"],
+      continuity_refs: [
+        "/v1/phases/phase-3/native-continuity/summary",
+        "/v1/phases/phase-3/metanet/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the BSV plus Teranode runtime lane is public and inspectable",
+        "native settlement mode stays attached to the runtime lane",
+        "operator surfaces remain available while deeper native splits are still future work",
+        "Phase 3 begins from explicit native runtime legibility rather than hidden native assumptions"
+      ]
+    },
+    first_path: {
+      purpose: "show the first public native runtime lane for BSV plus Teranode settlement-aware machine commerce",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-bsv-teranode-runtime --summary",
+        "xytara-release --phase-3 --summary"
+      ],
+      expected_signals: [
+        "BSV and Teranode are visible as the first concrete native runtime lane",
+        "native settlement posture is inspectable from a stable public route",
+        "Phase 3 starts from native runtime and settlement clarity"
+      ]
+    }
+  };
+}
+
+function summarizePhase3BsvTeranodeRuntimePack() {
+  const pack = buildPhase3BsvTeranodeRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    settlement_mode_count: pack.settlement_shape.settlement_modes.length,
+    submission_mode_count: pack.settlement_shape.submission_modes.length,
+    finality_stage_count: pack.settlement_shape.finality_stages.length,
+    settlement_artifact_count: pack.settlement_shape.settlement_artifacts.length,
+    continuity_ref_count: pack.settlement_shape.continuity_refs.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,
+    operator_surface_count: pack.settlement_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase3BsvTeranodeRuntimePack,
+  summarizePhase3BsvTeranodeRuntimePack
+};

package/lib/phase_3_closeout_pack.js

@@ -0,0 +1,62 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-closeout-pack",
+    phase_ref: "phase_3",
+    posture: "closeout_plan",
+    closeout: {
+      current_decision: "ready_for_phase_4",
+      blocking_actions: [],
+      action_sequence: [
+        "review phase-3 completion summary",
+        "review phase-3 freeze-review summary",
+        "flip ready_for_next_phase deliberately"
+      ],
+      completion_signals: [
+        "gate review has been recorded",
+        "phase-3 gate summary shows zero unsatisfied gate conditions"
+      ]
+    },
+    sources: {
+      completion_summary: "/v1/phases/phase-3/completion/summary",
+      freeze_review_summary: "/v1/phases/phase-3/freeze-review/summary",
+      gate_summary: "/v1/phases/phase-3/gate/summary"
+    },
+    first_path: {
+      purpose: "show the exact remaining actions needed to close Phase 3 cleanly",
+      first_http_sequence: [
+        "/v1/phases/phase-3/gate/summary",
+        "/v1/phases/phase-3/closeout/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-closeout --summary",
+        "xytara-release --phase-3-gate --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase3CloseoutPack() {
+  const pack = buildPhase3CloseoutPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    blocking_action_count: pack.closeout.blocking_actions.length,
+    action_step_count: pack.closeout.action_sequence.length,
+    completion_signal_count: pack.closeout.completion_signals.length,
+    current_decision: pack.closeout.current_decision
+  };
+}
+
+module.exports = {
+  buildPhase3CloseoutPack,
+  summarizePhase3CloseoutPack
+};

package/lib/phase_3_completion_pack.js

@@ -0,0 +1,94 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-completion-pack",
+    phase_ref: "phase_3",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["bsv", "teranode", "metanet", "brc"],
+      lane_refs: [
+        "/v1/phases/phase-3/bsv-teranode/summary",
+        "/v1/phases/phase-3/metanet/summary",
+        "/v1/phases/phase-3/brc/summary"
+      ],
+      settlement_modes: ["bsv_teranode"],
+      identity_layers: ["metanet", "brc"],
+      submission_modes: ["signed_submit", "operator_replay"],
+      finality_stages: ["accepted", "observed", "settled"],
+      graph_modes: ["node_linkage", "path_carry", "subject_continuity"],
+      registry_modes: ["record_linkage", "attestation_lookup", "subject_resolution"],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 3 native BSV pack is public and inspectable",
+        "all current Phase 3 runtime lanes are public and inspectable",
+        "native settlement and identity-layer coverage are visible at phase level",
+        "operator surfaces remain attached to the native rail family",
+        "release-center summary reflects Phase 3 breadth and lane coverage",
+        "Phase 3 closure criteria are explicit before opening Phase 4"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 3 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.runtime_lane_coverage", label: "All current native runtime lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.identity_coverage_visible", label: "Native identity-layer coverage is visible at phase level", satisfied: true },
+        { ref: "criterion.operator_surfaces_attached", label: "Native operator surfaces remain attached to the rail family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 3 lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.next_phase_gate_reviewed", label: "A final freeze review has been recorded before opening Phase 4", satisfied: true }
+      ],
+      ready_for_next_phase: true,
+      remaining_focus: []
+    },
+    first_path: {
+      purpose: "review whether Phase 3 is complete as a native machine-commerce program slice rather than just enumerated",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/phases/phase-3/completion/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-completion --summary",
+        "xytara-release --phase-3 --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase3CompletionPack() {
+  const pack = buildPhase3CompletionPack();
+  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,
+    settlement_mode_count: pack.coverage.settlement_modes.length,
+    identity_layer_count: pack.coverage.identity_layers.length,
+    submission_mode_count: pack.coverage.submission_modes.length,
+    finality_stage_count: pack.coverage.finality_stages.length,
+    graph_mode_count: pack.coverage.graph_modes.length,
+    registry_mode_count: pack.coverage.registry_modes.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 = {
+  buildPhase3CompletionPack,
+  summarizePhase3CompletionPack
+};

package/lib/phase_3_decision_record_pack.js

@@ -0,0 +1,64 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-decision-record-pack",
+    phase_ref: "phase_3",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final native lane shape as the frozen Phase 3 baseline"
+      },
+      gate_review: {
+        status: "recorded",
+        description: "record the final review that authorizes the move to Phase 4"
+      }
+    },
+    record_steps: [
+      "confirm the current native lane family is the final Phase 3 shape",
+      "record the gate review outcome",
+      "recheck phase-3 gate summary for zero unsatisfied conditions"
+    ],
+    outputs: [
+      "gate review status moves out of pending_record",
+      "phase-3 gate can be flipped deliberately"
+    ],
+    first_path: {
+      purpose: "show the two unresolved records that still prevent the Phase 3 gate from flipping",
+      first_http_sequence: [
+        "/v1/phases/phase-3/closeout/summary",
+        "/v1/phases/phase-3/decision-record/summary",
+        "/v1/phases/phase-3/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-decision-record --summary",
+        "xytara-release --phase-3-closeout --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase3DecisionRecordPack() {
+  const pack = buildPhase3DecisionRecordPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    pending_record_count: Object.values(pack.records).filter((record) => record.status === "pending_record").length,
+    record_step_count: pack.record_steps.length,
+    output_count: pack.outputs.length,
+    freeze_decision_status: pack.records.freeze_decision.status,
+    gate_review_status: pack.records.gate_review.status
+  };
+}
+
+module.exports = {
+  buildPhase3DecisionRecordPack,
+  summarizePhase3DecisionRecordPack
+};

package/lib/phase_3_decision_resolution_pack.js

@@ -0,0 +1,69 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3DecisionResolutionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-3-decision-resolution-pack",
+    phase_ref: "phase_3",
+    posture: "decision_resolution",
+    transitions: [
+      {
+        record_ref: "freeze_decision",
+        from: "pending_record",
+        to: "recorded",
+        resolution_action: "record the final native lane freeze decision"
+      },
+      {
+        record_ref: "gate_review",
+        from: "pending_record",
+        to: "recorded",
+        resolution_action: "record the final gate review authorizing Phase 4"
+      }
+    ],
+    resolution_sequence: [
+      "confirm the final Phase 3 native lane shape",
+      "change freeze_decision from pending_record to recorded",
+      "change gate_review from pending_record to recorded",
+      "recheck the phase-3 gate for zero unsatisfied conditions",
+      "flip ready_for_next_phase deliberately"
+    ],
+    completion_result: {
+      target_gate_decision: "ready_for_phase_4",
+      target_ready_for_next_phase: true
+    },
+    first_path: {
+      purpose: "show the exact status transitions still needed before the phase gate can flip",
+      first_http_sequence: [
+        "/v1/phases/phase-3/decision-record/summary",
+        "/v1/phases/phase-3/decision-resolution/summary",
+        "/v1/phases/phase-3/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-3-decision-resolution --summary",
+        "xytara-release --phase-3-decision-record --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase3DecisionResolutionPack() {
+  const pack = buildPhase3DecisionResolutionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    transition_count: pack.transitions.length,
+    resolution_step_count: pack.resolution_sequence.length,
+    target_gate_decision: pack.completion_result.target_gate_decision,
+    target_ready_for_next_phase: pack.completion_result.target_ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase3DecisionResolutionPack,
+  summarizePhase3DecisionResolutionPack
+};