xoonya 2.1.0 → 2.2.0

package/lib/phase_3_native_continuity_pack.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase3NativeContinuityPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-3-native-continuity-pack",
+    phase_ref: "phase_3",
+    posture: "native_family_continuity",
+    lane_refs: [
+      "/v1/phases/phase-3/bsv-teranode/proof/summary",
+      "/v1/phases/phase-3/metanet/proof/summary",
+      "/v1/phases/phase-3/brc/proof/summary"
+    ],
+    continuity_shape: {
+      rail_family: "bsv_native",
+      settlement_lane_refs: ["/v1/phases/phase-3/bsv-teranode/proof/summary"],
+      identity_lane_refs: [
+        "/v1/phases/phase-3/metanet/proof/summary",
+        "/v1/phases/phase-3/brc/proof/summary"
+      ],
+      proof_surfaces: [
+        "/v1/proof-center/bridge/summary",
+        "/v1/release-center/summary",
+        "/v1/outreach-proof/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the native proof continuity family is public and inspectable",
+        "settlement carry and identity-native proof lanes remain attached to one Phase 3 family",
+        "Metanet and BRC stay legible as identity-continuity extensions of the BSV-native proof family",
+        "proof-side native continuity review remains available from stable public routes"
+      ]
+    },
+    first_path: {
+      purpose: "show the native BSV proof family as one continuity path spanning settlement carry and identity-linked review",
+      first_http_sequence: [
+        "/v1/phases/phase-3/summary",
+        "/v1/phases/phase-3/bsv-teranode/proof/summary",
+        "/v1/phases/phase-3/metanet/proof/summary",
+        "/v1/phases/phase-3/brc/proof/summary"
+      ],
+      first_cli_sequence: [
+        "xoonya-release --phase-3-native-continuity --summary",
+        "xoonya-release --phase-3 --summary"
+      ],
+      expected_signals: [
+        "Phase 3 reads as one native proof family rather than disconnected lanes",
+        "native settlement carry and native identity proof expansion stay visibly linked",
+        "reviewers can inspect one continuity posture before drilling into lane-specific details",
+        "the differentiated native proof family feels more operational and coherent"
+      ]
+    }
+  };
+}
+
+function summarizePhase3NativeContinuityPack() {
+  const pack = buildPhase3NativeContinuityPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.lane_refs.length,
+    settlement_lane_count: pack.continuity_shape.settlement_lane_refs.length,
+    identity_lane_count: pack.continuity_shape.identity_lane_refs.length,
+    proof_surface_count: pack.continuity_shape.proof_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 = {
+  buildPhase3NativeContinuityPack,
+  summarizePhase3NativeContinuityPack
+};

package/lib/phase_4_attestation_proof_pack.js

@@ -0,0 +1,75 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4AttestationProofPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-attestation-proof-pack",
+    phase_ref: "phase_4",
+    ecosystem_ref: "attestation",
+    status: "active",
+    trust_shape: {
+      identity_layers: ["attestation"],
+      attestation_modes: ["subject_attestation", "attester_resolution", "review_carry"],
+      review_modes: ["subject_attestation", "attester_resolution", "review_carry"],
+      proof_artifacts: ["attestation_bundle", "attester_receipt", "review_receipt"],
+      proof_surfaces: [
+        "/v1/proof-center/bridge/summary",
+        "/v1/release-center/summary",
+        "/v1/phases/phase-4/summary"
+      ]
+    },
+    first_steps: {
+      http: [
+        "/v1/phases/phase-4/summary",
+        "/v1/phases/phase-4/attestation/proof/summary",
+        "/v1/release-center/summary"
+      ],
+      cli: [
+        "xoonya-release --phase-4 --summary",
+        "xoonya-release --phase-4-attestation-proof --summary"
+      ]
+    },
+    success_signals: [
+      "attestation proof lane is public and inspectable",
+      "attester resolution and review carry are visible",
+      "proof artifacts stay explicit at lane level"
+    ],
+    completion_shape: {
+      completion_checks: [
+        "attestation proof lane is public and inspectable",
+        "attestation and attester resolution modes are visible",
+        "proof artifacts are explicit at lane level",
+        "proof surfaces stay attached to the lane"
+      ]
+    }
+  };
+}
+
+function summarizePhase4AttestationProofPack() {
+  const pack = buildPhase4AttestationProofPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.trust_shape.identity_layers.length,
+    identity_layer_count: pack.trust_shape.identity_layers.length,
+    attestation_mode_count: pack.trust_shape.attestation_modes.length,
+    review_mode_count: pack.trust_shape.review_modes.length,
+    proof_artifact_count: pack.trust_shape.proof_artifacts.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_steps.http.length,
+    cli_step_count: pack.first_steps.cli.length,
+    signal_count: pack.success_signals.length,
+    proof_surface_count: pack.trust_shape.proof_surfaces.length,
+    first_http_step: pack.first_steps.http[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase4AttestationProofPack,
+  summarizePhase4AttestationProofPack
+};

package/lib/phase_4_closeout_pack.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-closeout-pack",
+    phase_ref: "phase_4",
+    posture: "phase_closeout",
+    current_decision: "ready_for_phase_5",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current trust proof lane family remains the recorded Phase 4 baseline",
+      "confirm the gate review is recorded",
+      "recheck phase-4 gate summary for zero unsatisfied conditions",
+      "advance to Phase 5 only after the gate is explicitly ready"
+    ],
+    completion_signals: [
+      "freeze baseline is recorded",
+      "gate review is recorded",
+      "phase-4 gate resolves to ready_for_phase_5"
+    ]
+  };
+}
+
+function summarizePhase4CloseoutPack() {
+  const pack = buildPhase4CloseoutPack();
+  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 = {
+  buildPhase4CloseoutPack,
+  summarizePhase4CloseoutPack
+};

package/lib/phase_4_completion_pack.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-completion-pack",
+    phase_ref: "phase_4",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["erc8004", "identity_registry", "attestation"],
+      lane_refs: [
+        "/v1/phases/phase-4/erc8004/proof/summary",
+        "/v1/phases/phase-4/identity-registry/proof/summary",
+        "/v1/phases/phase-4/attestation/proof/summary"
+      ],
+      identity_layers: ["erc8004", "identity_registry"],
+      attestation_modes: ["subject_attestation", "registry_binding", "trust_resolution"],
+      erc8004_modes: ["subject_binding", "policy_carry", "wallet_resolution"],
+      registry_modes: ["registry_binding", "subject_resolution", "registry_lookup"],
+      review_modes: ["attester_resolution", "review_carry", "trust_resolution"],
+      proof_artifacts: ["subject_bundle", "registry_binding_receipt", "attestation_bundle"],
+      proof_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/proof-center/bridge/summary",
+        "/v1/phases/phase-4/trust-continuity/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 4 trust proof pack is public and inspectable",
+        "all current Phase 4 trust proof lanes are public and inspectable",
+        "identity and attestation proof posture are visible at phase level",
+        "trust continuity is explicit across the trust proof family",
+        "release-center summary reflects Phase 4 breadth and proof lane coverage",
+        "Phase 4 closure criteria are explicit before opening Phase 5"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 4 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.trust_lane_coverage", label: "All current trust proof lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.trust_continuity_visible", label: "Trust continuity is visible at phase level", satisfied: true },
+        { ref: "criterion.proof_surfaces_attached", label: "Proof surfaces remain attached to the trust family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 4 trust proof lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.next_phase_gate_reviewed", label: "A final freeze review has been recorded before opening Phase 5", satisfied: true }
+      ],
+      ready_for_next_phase: true,
+      remaining_focus: []
+    }
+  };
+}
+
+function summarizePhase4CompletionPack() {
+  const pack = buildPhase4CompletionPack();
+  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,
+    identity_layer_count: pack.coverage.identity_layers.length,
+    attestation_mode_count: pack.coverage.attestation_modes.length,
+    erc8004_mode_count: pack.coverage.erc8004_modes.length,
+    registry_mode_count: pack.coverage.registry_modes.length,
+    review_mode_count: pack.coverage.review_modes.length,
+    proof_artifact_count: pack.coverage.proof_artifacts.length,
+    proof_surface_count: pack.coverage.proof_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 = {
+  buildPhase4CompletionPack,
+  summarizePhase4CompletionPack
+};

package/lib/phase_4_decision_record_pack.js

@@ -0,0 +1,54 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-decision-record-pack",
+    phase_ref: "phase_4",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final trust proof lane shape as the frozen Phase 4 baseline"
+      },
+      gate_review: {
+        status: "recorded",
+        description: "record the final review that authorizes the move to Phase 5"
+      }
+    },
+    record_steps: [
+      "confirm the current trust proof lane family is the final Phase 4 shape",
+      "record the freeze decision outcome",
+      "record the gate review outcome",
+      "recheck phase-4 gate summary for zero unsatisfied conditions"
+    ],
+    outputs: [
+      "freeze decision status moves out of pending_record",
+      "gate review status moves out of pending_record",
+      "phase-4 gate can be flipped deliberately"
+    ]
+  };
+}
+
+function summarizePhase4DecisionRecordPack() {
+  const pack = buildPhase4DecisionRecordPack();
+  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 = {
+  buildPhase4DecisionRecordPack,
+  summarizePhase4DecisionRecordPack
+};

package/lib/phase_4_decision_resolution_pack.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4DecisionResolutionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-decision-resolution-pack",
+    phase_ref: "phase_4",
+    posture: "decision_resolution",
+    transitions: [
+      "freeze_decision: pending_record -> recorded",
+      "gate_review: pending_record -> recorded"
+    ],
+    resolution_steps: [
+      "record the final trust-family freeze decision",
+      "record the final gate review",
+      "confirm freeze-review blockers are cleared",
+      "confirm gate unsatisfied count is zero",
+      "treat the gate result as the explicit signal to open Phase 5"
+    ],
+    target_gate_decision: "ready_for_phase_5",
+    target_ready_for_next_phase: true
+  };
+}
+
+function summarizePhase4DecisionResolutionPack() {
+  const pack = buildPhase4DecisionResolutionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    transition_count: pack.transitions.length,
+    resolution_step_count: pack.resolution_steps.length,
+    target_gate_decision: pack.target_gate_decision,
+    target_ready_for_next_phase: pack.target_ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase4DecisionResolutionPack,
+  summarizePhase4DecisionResolutionPack
+};

package/lib/phase_4_erc8004_proof_pack.js

@@ -0,0 +1,76 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4Erc8004ProofPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-erc8004-proof-pack",
+    phase_ref: "phase_4",
+    ecosystem_refs: ["erc8004"],
+    posture: "proof_path",
+    trust_shape: {
+      identity_layers: ["erc8004"],
+      attestation_modes: ["subject_attestation", "registry_binding", "trust_resolution"],
+      erc8004_modes: ["subject_binding", "policy_carry", "wallet_resolution"],
+      proof_artifacts: ["subject_bundle", "attestation_receipt", "registry_binding_receipt"],
+      proof_surfaces: [
+        "/v1/proof-center/bridge/summary",
+        "/v1/release-center/summary",
+        "/v1/phases/phase-4/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "the ERC8004 proof lane is public and inspectable",
+        "trust and attestation proof posture stay attached to the proof lane",
+        "proof surfaces remain available for trust review",
+        "Phase 4 begins from explicit identity and attestation proof legibility"
+      ]
+    },
+    first_path: {
+      purpose: "show the first public trust proof lane for ERC8004-linked identity and attestation",
+      first_http_sequence: [
+        "/v1/phases/phase-4/summary",
+        "/v1/proof-center/bridge/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xoonya-release --phase-4-erc8004-proof --summary",
+        "xoonya-release --phase-4 --summary"
+      ],
+      expected_signals: [
+        "ERC8004 is visible as the first concrete Phase 4 proof lane",
+        "identity and attestation proof posture are inspectable from a stable route",
+        "Phase 4 starts from trust clarity rather than generic adapter naming"
+      ]
+    }
+  };
+}
+
+function summarizePhase4Erc8004ProofPack() {
+  const pack = buildPhase4Erc8004ProofPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    identity_layer_count: pack.trust_shape.identity_layers.length,
+    attestation_mode_count: pack.trust_shape.attestation_modes.length,
+    erc8004_mode_count: pack.trust_shape.erc8004_modes.length,
+    proof_artifact_count: pack.trust_shape.proof_artifacts.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,
+    proof_surface_count: pack.trust_shape.proof_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase4Erc8004ProofPack,
+  summarizePhase4Erc8004ProofPack
+};

package/lib/phase_4_freeze_baseline_pack.js

@@ -0,0 +1,67 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4FreezeBaselinePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-freeze-baseline-pack",
+    phase_ref: "phase_4",
+    posture: "frozen_baseline",
+    baseline: {
+      lane_refs: [
+        "/v1/phases/phase-4/erc8004/proof/summary",
+        "/v1/phases/phase-4/identity-registry/proof/summary",
+        "/v1/phases/phase-4/attestation/proof/summary"
+      ],
+      identity_layers: ["erc8004", "identity_registry"],
+      attestation_modes: ["subject_attestation", "registry_binding", "trust_resolution"],
+      baseline_status: "recorded",
+      frozen_outputs: [
+        "current trust proof-lane family is the recorded Phase 4 baseline",
+        "trust proof family can now be judged against a stable shape rather than an open expansion set",
+        "only the final gate review remains before Phase 5"
+      ]
+    },
+    first_path: {
+      purpose: "show that the Phase 4 trust proof-lane family is now treated as a frozen baseline",
+      first_http_sequence: [
+        "/v1/phases/phase-4/summary",
+        "/v1/phases/phase-4/freeze-baseline/summary",
+        "/v1/phases/phase-4/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xoonya-release --phase-4-freeze-baseline --summary",
+        "xoonya-release --phase-4 --summary"
+      ],
+      expected_signals: [
+        "the trust proof-lane family is now explicitly frozen",
+        "proof-lane freeze is no longer part of the remaining Phase 4 uncertainty",
+        "the final open work is narrowed to gate review rather than shape definition"
+      ]
+    }
+  };
+}
+
+function summarizePhase4FreezeBaselinePack() {
+  const pack = buildPhase4FreezeBaselinePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.baseline.lane_refs.length,
+    identity_layer_count: pack.baseline.identity_layers.length,
+    attestation_mode_count: pack.baseline.attestation_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 = {
+  buildPhase4FreezeBaselinePack,
+  summarizePhase4FreezeBaselinePack
+};

package/lib/phase_4_freeze_review_pack.js

@@ -0,0 +1,68 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase4FreezeReviewPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-freeze-review-pack",
+    phase_ref: "phase_4",
+    posture: "freeze_review",
+    current_shape: {
+      lane_refs: [
+        "/v1/phases/phase-4/erc8004/proof/summary",
+        "/v1/phases/phase-4/identity-registry/proof/summary",
+        "/v1/phases/phase-4/attestation/proof/summary"
+      ],
+      identity_layers: ["erc8004", "identity_registry"],
+      attestation_modes: ["subject_attestation", "registry_binding", "trust_resolution"]
+    },
+    freeze_review: {
+      decision_posture: "gate_review_recorded",
+      review_questions: [
+        "Is the current trust proof-lane split the exact shape we want to preserve for Phase 4?",
+        "Do ERC8004, registry, and attestation communicate distinct proof roles without overlap confusion?",
+        "Is the current proof and review coverage sufficient before opening the next phase?",
+        "Would adding more trust proof sub-lanes materially improve Phase 4, or just create sprawl?"
+      ],
+      resolution_criteria: [
+        { ref: "criterion.freeze_review_surface_public", label: "Freeze-review surface is public and inspectable", satisfied: true },
+        { ref: "criterion.blockers_explicit", label: "Current blockers are explicit and bounded", satisfied: true },
+        { ref: "criterion.freeze_decision_recorded", label: "Final trust proof lane freeze has been explicitly recorded", satisfied: true },
+        { ref: "criterion.gate_review_recorded", label: "Next-phase gate review has been explicitly recorded", satisfied: true }
+      ],
+      blockers: [],
+      freeze_outputs: [
+        "freeze decision recorded",
+        "ready_for_next_phase flipped deliberately",
+        "Phase 4 trust proof shape treated as stable baseline going forward"
+      ]
+    }
+  };
+}
+
+function summarizePhase4FreezeReviewPack() {
+  const pack = buildPhase4FreezeReviewPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.current_shape.lane_refs.length,
+    identity_layer_count: pack.current_shape.identity_layers.length,
+    attestation_mode_count: pack.current_shape.attestation_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.freeze_outputs.length,
+    decision_posture: pack.freeze_review.decision_posture
+  };
+}
+
+module.exports = {
+  buildPhase4FreezeReviewPack,
+  summarizePhase4FreezeReviewPack
+};

package/lib/phase_4_gate_pack.js

@@ -0,0 +1,58 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizePhase4CompletionPack } = require("./phase_4_completion_pack");
+const { summarizePhase4FreezeReviewPack } = require("./phase_4_freeze_review_pack");
+
+function buildPhase4GatePack() {
+  const completion = summarizePhase4CompletionPack();
+  const freezeReview = summarizePhase4FreezeReviewPack();
+  const unsatisfiedGateCount =
+    completion.unsatisfied_criteria_count +
+    freezeReview.unsatisfied_resolution_count;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-phase-4-gate-pack",
+    phase_ref: "phase_4",
+    posture: "phase_gate",
+    gate: {
+      decision: unsatisfiedGateCount === 0 ? "ready_for_phase_5" : "hold_phase_4",
+      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 summarizePhase4GatePack() {
+  const pack = buildPhase4GatePack();
+  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 = {
+  buildPhase4GatePack,
+  summarizePhase4GatePack
+};