xytara 2.1.0 → 2.3.0

package/lib/partner_intelligence.js

@@ -0,0 +1,105 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { buildAdoptionPack } = require("./release_pack");
+const { buildAdapterPartnerPack } = require("./adapter_partner_pack");
+
+function classifyPartnerReadinessState(adoptionPack, adapterPartnerPack) {
+  const targetCount = adoptionPack.initial_adoption_targets.length;
+  const firstSuccessPathCount = adoptionPack.first_success_paths.length;
+  const partnerValueCount = adapterPartnerPack.partner_value.length;
+  const maturityStepCount = adapterPartnerPack.trust_path.maturity_path.length;
+
+  if (targetCount >= 4 && firstSuccessPathCount >= 3 && partnerValueCount >= 4 && maturityStepCount >= 5) {
+    return "strong";
+  }
+  if (targetCount >= 2 && firstSuccessPathCount >= 2 && partnerValueCount >= 2) {
+    return "working";
+  }
+  return "early";
+}
+
+function classifyOnboardingFrictionState(adapterPartnerPack) {
+  const docCount = adapterPartnerPack.start_path.first_docs.length;
+  const commandCount = adapterPartnerPack.start_path.first_commands.length;
+  const exampleCount = adapterPartnerPack.start_path.first_examples.length;
+
+  if (docCount >= 2 && commandCount >= 4 && exampleCount >= 2) return "low";
+  if (docCount >= 1 && commandCount >= 2) return "manageable";
+  return "high";
+}
+
+function classifyPromotionReadinessState(adapterPartnerPack) {
+  const publicSurfaceCount = Object.keys(adapterPartnerPack.public_surfaces).length;
+  const maturityStepCount = adapterPartnerPack.trust_path.maturity_path.length;
+  if (publicSurfaceCount >= 5 && maturityStepCount >= 5) return "strong";
+  if (publicSurfaceCount >= 3 && maturityStepCount >= 3) return "working";
+  return "early";
+}
+
+function buildPartnerIntelligencePack() {
+  const adoptionPack = buildAdoptionPack();
+  const adapterPartnerPack = buildAdapterPartnerPack();
+  const partnerReadinessState = classifyPartnerReadinessState(adoptionPack, adapterPartnerPack);
+  const onboardingFrictionState = classifyOnboardingFrictionState(adapterPartnerPack);
+  const promotionReadinessState = classifyPromotionReadinessState(adapterPartnerPack);
+
+  let nextBestAction = "promote_partner_start_path";
+  if (onboardingFrictionState !== "low") {
+    nextBestAction = "tighten_partner_onboarding";
+  } else if (promotionReadinessState !== "strong") {
+    nextBestAction = "strengthen_promotion_trust_path";
+  }
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-partner-intelligence-pack",
+    partner_readiness_state: partnerReadinessState,
+    onboarding_friction_state: onboardingFrictionState,
+    promotion_readiness_state: promotionReadinessState,
+    first_partner_segment: adapterPartnerPack.adoption_message.first_partner_type,
+    recommended_partner_motion: "lead_with_adapter_authors_and_agent_builders",
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      adoption_target_count: adoptionPack.initial_adoption_targets.length,
+      target_ecosystem_count: adoptionPack.target_ecosystems.length,
+      first_success_path_count: adoptionPack.first_success_paths.length,
+      partner_value_count: adapterPartnerPack.partner_value.length,
+      onboarding_doc_count: adapterPartnerPack.start_path.first_docs.length,
+      onboarding_command_count: adapterPartnerPack.start_path.first_commands.length,
+      onboarding_example_count: adapterPartnerPack.start_path.first_examples.length,
+      maturity_step_count: adapterPartnerPack.trust_path.maturity_path.length,
+      public_surface_count: Object.keys(adapterPartnerPack.public_surfaces).length
+    },
+    linked_surfaces: {
+      adoption_summary_ref: "/v1/release-pack/adoption/summary",
+      adapter_partner_summary_ref: "/v1/adapter-partners/summary",
+      release_center_summary_ref: "/v1/release-center/summary"
+    },
+    generated_from: {
+      adoption_pack_category: adoptionPack.category,
+      adapter_partner_pack_category: adapterPartnerPack.category
+    }
+  };
+}
+
+function summarizePartnerIntelligencePack() {
+  const pack = buildPartnerIntelligencePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    partner_readiness_state: pack.partner_readiness_state,
+    onboarding_friction_state: pack.onboarding_friction_state,
+    promotion_readiness_state: pack.promotion_readiness_state,
+    first_partner_segment: pack.first_partner_segment,
+    next_best_action: pack.next_best_action,
+    signal_count: Object.keys(pack.explanation_signals).length
+  };
+}
+
+module.exports = {
+  buildPartnerIntelligencePack,
+  summarizePartnerIntelligencePack
+};

package/lib/phase_10_closeout_pack.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-closeout-pack",
+    phase_ref: "phase_10",
+    posture: "closeout_plan",
+    current_decision: "ready_for_program_closeout",
+    blocking_actions: [],
+    action_steps: [
+      "confirm the current long-tail lane family is the intended final Phase 10 shape",
+      "record the terminal program closeout review",
+      "recheck phase-10 gate summary for zero unsatisfied conditions",
+      "advance only once phase-10 gate resolves to ready_for_program_closeout"
+    ],
+    completion_signals: [
+      "phase-10 completion shows no remaining focus",
+      "phase-10 decision record shows no pending records",
+      "phase-10 gate resolves to ready_for_program_closeout"
+    ]
+  };
+}
+
+function summarizePhase10CloseoutPack() {
+  const pack = buildPhase10CloseoutPack();
+  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 = {
+  buildPhase10CloseoutPack,
+  summarizePhase10CloseoutPack
+};

package/lib/phase_10_completion_pack.js

@@ -0,0 +1,76 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-completion-pack",
+    phase_ref: "phase_10",
+    posture: "completion_review",
+    coverage: {
+      ecosystem_refs: ["demand_signal_adapters", "niche_extension_registry", "ecosystem_backlog_triage"],
+      lane_refs: [
+        "/v1/phases/phase-10/demand-signal-adapters/summary",
+        "/v1/phases/phase-10/niche-extension-registry/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/summary"
+      ],
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      extension_artifacts: ["demand_signal_ref", "extension_registry_ref", "triage_queue_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-10/long-tail-continuity/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 10 long-tail ecosystem pack is public and inspectable",
+        "all current Phase 10 long-tail lanes are public and inspectable",
+        "extension posture is visible at phase level",
+        "long-tail continuity is explicit across the lane family",
+        "release-center summary reflects Phase 10 breadth and lane coverage",
+        "Phase 10 closeout criteria are explicit before final program closeout"
+      ],
+      readiness_criteria: [
+        { ref: "criterion.phase_surface_public", label: "Phase 10 broad summary is live and inspectable", satisfied: true },
+        { ref: "criterion.long_tail_lane_coverage", label: "All current long-tail lanes are live and inspectable", satisfied: true },
+        { ref: "criterion.long_tail_continuity_visible", label: "Long-tail continuity is visible at phase level", satisfied: true },
+        { ref: "criterion.operator_surfaces_attached", label: "Operator surfaces remain attached to the long-tail family", satisfied: true },
+        { ref: "criterion.freeze_shape_confirmed", label: "The final Phase 10 long-tail lane shape is explicitly frozen", satisfied: true },
+        { ref: "criterion.program_closeout_reviewed", label: "A final program closeout review has been recorded", satisfied: true }
+      ],
+      ready_for_next_phase: false,
+      remaining_focus: []
+    }
+  };
+}
+
+function summarizePhase10CompletionPack() {
+  const pack = buildPhase10CompletionPack();
+  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,
+    extension_mode_count: pack.coverage.extension_modes.length,
+    demand_mode_count: pack.coverage.demand_modes.length,
+    extension_artifact_count: pack.coverage.extension_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 = {
+  buildPhase10CompletionPack,
+  summarizePhase10CompletionPack
+};

package/lib/phase_10_decision_record_pack.js

@@ -0,0 +1,54 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-decision-record-pack",
+    phase_ref: "phase_10",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final long-tail lane shape as the frozen Phase 10 baseline"
+      },
+      program_closeout_review: {
+        status: "recorded",
+        description: "record the final review that authorizes terminal program closeout"
+      }
+    },
+    record_steps: [
+      "confirm the current long-tail lane family matches the intended final Phase 10 shape",
+      "record the freeze decision outcome",
+      "record the program closeout review outcome",
+      "recheck phase-10 gate summary for the remaining terminal blockers"
+    ],
+    outputs: [
+      "freeze decision status is recorded and inspectable",
+      "program closeout review status is recorded and inspectable",
+      "phase-10 terminal gate can be flipped deliberately"
+    ]
+  };
+}
+
+function summarizePhase10DecisionRecordPack() {
+  const pack = buildPhase10DecisionRecordPack();
+  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,
+    program_closeout_review_status: pack.records.program_closeout_review.status
+  };
+}
+
+module.exports = {
+  buildPhase10DecisionRecordPack,
+  summarizePhase10DecisionRecordPack
+};

package/lib/phase_10_decision_resolution_pack.js

@@ -0,0 +1,53 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DecisionResolutionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-decision-resolution-pack",
+    phase_ref: "phase_10",
+    posture: "decision_resolution",
+    transitions: [
+      {
+        ref: "freeze_decision",
+        from: "pending_record",
+        to: "recorded"
+      },
+      {
+        ref: "program_closeout_review",
+        from: "pending_record",
+        to: "recorded"
+      }
+    ],
+    resolution_steps: [
+      "confirm the long-tail lane family is the intended final Phase 10 shape",
+      "record the freeze decision outcome",
+      "record the terminal program closeout review outcome",
+      "recheck phase-10 completion and freeze-review summaries",
+      "confirm phase-10 gate resolves to ready_for_program_closeout"
+    ],
+    target_gate_decision: "ready_for_program_closeout",
+    target_ready_for_next_phase: false
+  };
+}
+
+function summarizePhase10DecisionResolutionPack() {
+  const pack = buildPhase10DecisionResolutionPack();
+  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 = {
+  buildPhase10DecisionResolutionPack,
+  summarizePhase10DecisionResolutionPack
+};

package/lib/phase_10_demand_signal_adapters_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10DemandSignalAdaptersRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-demand-signal-adapters-runtime-pack",
+    phase_ref: "phase_10",
+    posture: "runtime_path",
+    ecosystems: ["demand_signal_adapters"],
+    runtime_shape: {
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      extension_artifacts: ["signal_ref", "fit_ref", "triage_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-10/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the first Phase 10 path from incoming ecosystem demand into governed extension triage",
+      first_http_sequence: [
+        "/v1/phases/phase-10/summary",
+        "/v1/phases/phase-10/demand-signal-adapters/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-10-demand-signal-adapters-runtime --summary",
+        "xytara-release --phase-10 --summary"
+      ],
+      expected_signals: [
+        "demand signal adapters is a public Phase 10 lane",
+        "extension artifacts are explicit at the lane level",
+        "extension posture is visible before broader Phase 10 expansion"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "demand signal adapters lane is public and inspectable",
+        "extension artifacts are visible at lane level",
+        "operator surfaces remain attached to the extension lane",
+        "the lane is ready to anchor broader long-tail ecosystem breadth"
+      ]
+    }
+  };
+}
+
+function summarizePhase10DemandSignalAdaptersRuntimePack() {
+  const pack = buildPhase10DemandSignalAdaptersRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    extension_mode_count: pack.runtime_shape.extension_modes.length,
+    demand_mode_count: pack.runtime_shape.demand_modes.length,
+    extension_artifact_count: pack.runtime_shape.extension_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 = {
+  buildPhase10DemandSignalAdaptersRuntimePack,
+  summarizePhase10DemandSignalAdaptersRuntimePack
+};

package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10EcosystemBacklogTriageRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-ecosystem-backlog-triage-runtime-pack",
+    phase_ref: "phase_10",
+    posture: "runtime_path",
+    ecosystems: ["ecosystem_backlog_triage"],
+    runtime_shape: {
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      extension_artifacts: ["signal_ref", "registry_ref", "queue_ref"],
+      operator_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary",
+        "/v1/phases/phase-10/summary"
+      ]
+    },
+    first_path: {
+      purpose: "show the Phase 10 triage path that turns long-tail demand into explicit backlog handling and queue discipline",
+      first_http_sequence: [
+        "/v1/phases/phase-10/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-10-ecosystem-backlog-triage-runtime --summary",
+        "xytara-release --phase-10 --summary"
+      ],
+      expected_signals: [
+        "ecosystem backlog triage is a public Phase 10 lane",
+        "queue artifacts are explicit at the lane level",
+        "triage posture is visible before Phase 10 closure discipline"
+      ]
+    },
+    completion: {
+      completion_checks: [
+        "ecosystem backlog triage lane is public and inspectable",
+        "triage artifacts are visible at lane level",
+        "operator surfaces remain attached to the triage lane",
+        "the lane is ready to support broader long-tail ecosystem breadth"
+      ]
+    }
+  };
+}
+
+function summarizePhase10EcosystemBacklogTriageRuntimePack() {
+  const pack = buildPhase10EcosystemBacklogTriageRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystems.length,
+    extension_mode_count: pack.runtime_shape.extension_modes.length,
+    demand_mode_count: pack.runtime_shape.demand_modes.length,
+    extension_artifact_count: pack.runtime_shape.extension_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 = {
+  buildPhase10EcosystemBacklogTriageRuntimePack,
+  summarizePhase10EcosystemBacklogTriageRuntimePack
+};

package/lib/phase_10_freeze_baseline_pack.js

@@ -0,0 +1,67 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10FreezeBaselinePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-freeze-baseline-pack",
+    phase_ref: "phase_10",
+    posture: "frozen_baseline",
+    baseline: {
+      lane_refs: [
+        "/v1/phases/phase-10/demand-signal-adapters/summary",
+        "/v1/phases/phase-10/niche-extension-registry/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/summary"
+      ],
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      baseline_status: "recorded",
+      frozen_outputs: [
+        "current long-tail lane family is the recorded Phase 10 baseline",
+        "Phase 10 can now be judged against a stable final shape rather than an open expansion set",
+        "only the final program closeout review remains before terminal closeout"
+      ]
+    },
+    first_path: {
+      purpose: "show that the Phase 10 long-tail family is now treated as a frozen terminal baseline",
+      first_http_sequence: [
+        "/v1/phases/phase-10/summary",
+        "/v1/phases/phase-10/freeze-baseline/summary",
+        "/v1/phases/phase-10/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-10-freeze-baseline --summary",
+        "xytara-release --phase-10 --summary"
+      ],
+      expected_signals: [
+        "the Phase 10 long-tail family is explicitly frozen",
+        "shape freeze is no longer part of the remaining Phase 10 uncertainty",
+        "the only remaining terminal work is the final program closeout review"
+      ]
+    }
+  };
+}
+
+function summarizePhase10FreezeBaselinePack() {
+  const pack = buildPhase10FreezeBaselinePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.baseline.lane_refs.length,
+    extension_mode_count: pack.baseline.extension_modes.length,
+    demand_mode_count: pack.baseline.demand_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 = {
+  buildPhase10FreezeBaselinePack,
+  summarizePhase10FreezeBaselinePack
+};

package/lib/phase_10_freeze_review_pack.js

@@ -0,0 +1,64 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase10FreezeReviewPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-freeze-review-pack",
+    phase_ref: "phase_10",
+    posture: "freeze_review",
+    freeze_review: {
+      lane_refs: [
+        "/v1/phases/phase-10/demand-signal-adapters/summary",
+        "/v1/phases/phase-10/niche-extension-registry/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/summary"
+      ],
+      extension_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      review_questions: [
+        "Is the current long-tail lane family the intended final Phase 10 breadth?",
+        "Are demand capture, extension registry, and backlog triage coherent across the family?",
+        "Do operator surfaces expose enough review posture for the long-tail family?",
+        "Is the final program slice ready to freeze before program closeout?"
+      ],
+      resolution_criteria: [
+        { ref: "criterion.long_tail_breadth_confirmed", label: "The final long-tail lane breadth is confirmed", satisfied: true },
+        { ref: "criterion.long_tail_roles_confirmed", label: "Demand, registry, and backlog roles are coherent across the family", satisfied: true },
+        { ref: "criterion.freeze_decision_recorded", label: "The freeze decision is explicitly recorded", satisfied: true },
+        { ref: "criterion.program_closeout_review_recorded", label: "The program closeout review is explicitly recorded", satisfied: true }
+      ],
+      blockers: [],
+      outputs: [
+        "the final Phase 10 long-tail lane shape is frozen",
+        "the remaining terminal gate blockers are explicit and inspectable",
+        "Phase 10 can be closed deliberately rather than implicitly"
+      ],
+      decision_posture: "terminal_closeout_recorded"
+    }
+  };
+}
+
+function summarizePhase10FreezeReviewPack() {
+  const pack = buildPhase10FreezeReviewPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    lane_count: pack.freeze_review.lane_refs.length,
+    extension_mode_count: pack.freeze_review.extension_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 = {
+  buildPhase10FreezeReviewPack,
+  summarizePhase10FreezeReviewPack
+};

package/lib/phase_10_gate_pack.js

@@ -0,0 +1,57 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { summarizePhase10CompletionPack } = require("./phase_10_completion_pack");
+const { summarizePhase10FreezeReviewPack } = require("./phase_10_freeze_review_pack");
+
+function buildPhase10GatePack() {
+  const completion = summarizePhase10CompletionPack();
+  const freezeReview = summarizePhase10FreezeReviewPack();
+  const unsatisfiedGateCount =
+    completion.unsatisfied_criteria_count +
+    freezeReview.unsatisfied_resolution_count;
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-10-gate-pack",
+    phase_ref: "phase_10",
+    posture: "phase_gate",
+    gate: {
+      decision: unsatisfiedGateCount === 0 ? "ready_for_program_closeout" : "hold_phase_10",
+      ready_for_next_phase: false,
+      satisfied_gate_count:
+        completion.satisfied_criteria_count +
+        freezeReview.satisfied_resolution_count,
+      unsatisfied_gate_count: unsatisfiedGateCount,
+      blockers: unsatisfiedGateCount === 0 ? [] : [
+        "program closeout review has not been explicitly recorded"
+      ],
+      advance_when: [
+        "program closeout review is explicitly recorded",
+        "completion and freeze-review surfaces both show no unsatisfied terminal gate criteria"
+      ]
+    }
+  };
+}
+
+function summarizePhase10GatePack() {
+  const pack = buildPhase10GatePack();
+  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 = {
+  buildPhase10GatePack,
+  summarizePhase10GatePack
+};