xoonya 2.1.0 → 2.3.0

package/examples/partner_proof_walkthrough.js

@@ -0,0 +1,68 @@
+"use strict";
+
+const assert = require("assert");
+const { createServer } = require("../server");
+
+async function fetchJson(url, options) {
+  const response = await fetch(url, options);
+  assert.strictEqual(response.ok, true, `request failed: ${url}`);
+  return response.json();
+}
+
+async function postJson(url, body) {
+  return fetchJson(url, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+}
+
+async function main() {
+  const server = createServer();
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  const baseUrl = `http://127.0.0.1:${address.port}`;
+
+  try {
+    const releaseCenterSummary = await fetchJson(`${baseUrl}/v1/release-center/summary`);
+    assert.strictEqual(typeof releaseCenterSummary.category, "string", "release-center summary category missing");
+
+    const proofCenterSummary = await fetchJson(`${baseUrl}/v1/proof-center/summary`);
+    assert.strictEqual(typeof proofCenterSummary.proof_bundle_version, "string", "proof-center summary missing");
+
+    const handoffReview = await postJson(`${baseUrl}/v1/proof-center/result-package-handoff/review/summary`, {
+      handoff_bundle: {
+        result_package_ref: "result.spine.job.commitment",
+        source_ref: "spine.job.commitment",
+        transaction_id: "txn-partner-proof-1",
+        receipt_id: "rcpt-partner-proof-1",
+        proof_ref: "memory://partner-proof-1",
+        committed_ref: "transaction.job.commitment",
+        precommit_pack_ref: "precommit.job.commitment.readiness",
+        payment_protocol: "x402",
+        settlement_mode: "evm_payment",
+        treasury_destination_id: "treasury_acct_demo",
+        task_refs: ["jobs.quote", "admission.preview", "jobs.reserve", "jobs.commit"],
+        seam_layers: ["execution_consequence", "payment_settlement_treasury", "proof_handoff"]
+      }
+    });
+    assert.strictEqual(typeof handoffReview.review_ref, "string", "handoff review ref missing");
+    assert.strictEqual(handoffReview.run_ready, true, "handoff review run readiness missing");
+
+    const integrationReadiness = await fetchJson(`${baseUrl}/v1/integrations/promotion-readiness`);
+    assert.strictEqual(integrationReadiness.ok, true, "integration readiness summary missing");
+
+    console.log("xoonya partner proof walkthrough passed");
+  } finally {
+    await new Promise((resolve, reject) => {
+      server.close((error) => (error ? reject(error) : resolve()));
+    });
+  }
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/examples/proof_review_walkthrough.js

@@ -0,0 +1,66 @@
+"use strict";
+
+const assert = require("assert");
+const { createServer } = require("../server");
+
+async function fetchJson(url, options) {
+  const response = await fetch(url, options);
+  assert.strictEqual(response.ok, true, `request failed: ${url}`);
+  return response.json();
+}
+
+async function postJson(url, body) {
+  return fetchJson(url, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+}
+
+function createHandoffBundle() {
+  return {
+    result_package_ref: "result.spine.job.commitment",
+    source_ref: "spine.job.commitment",
+    transaction_id: "txn-proof-review-demo-1",
+    receipt_id: "rcpt-proof-review-demo-1",
+    proof_ref: "memory://proof-review-demo-1",
+    committed_ref: "transaction.job.commitment",
+    precommit_pack_ref: "precommit.job.commitment.readiness",
+    payment_protocol: "x402",
+    settlement_mode: "evm_payment",
+    treasury_destination_id: "treasury_acct_demo",
+    task_refs: ["jobs.quote", "admission.preview", "jobs.reserve", "jobs.commit"],
+    seam_layers: ["execution_consequence", "payment_settlement_treasury", "proof_handoff"]
+  };
+}
+
+async function main() {
+  const server = createServer();
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const { port } = server.address();
+  const baseUrl = `http://127.0.0.1:${port}`;
+
+  try {
+    const review = await postJson(`${baseUrl}/v1/proof-center/result-package-handoff/review/summary`, {
+      handoff_bundle: createHandoffBundle()
+    });
+    assert.strictEqual(typeof review.review_ref, "string", "review summary missing");
+    assert.strictEqual(review.run_ready, true, "review should be run-ready");
+
+    const bridgeSummary = await postJson(`${baseUrl}/v1/proof-center/result-package-handoff/review/bridge-summary`, {
+      handoff_bundle: createHandoffBundle()
+    });
+    assert.strictEqual(typeof bridgeSummary.adapter_bridge_ref, "string", "bridge summary missing");
+
+    console.log("xoonya proof review walkthrough passed");
+  } finally {
+    await new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())));
+  }
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/examples/review_carried_handoff.js

@@ -0,0 +1,72 @@
+"use strict";
+
+const assert = require("assert");
+const fs = require("fs");
+const path = require("path");
+const proof = require("../index.js");
+
+function parseInputPath(argv) {
+  const args = Array.isArray(argv) ? argv : [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === "--file" && args[index + 1]) {
+      return path.resolve(process.cwd(), args[index + 1]);
+    }
+  }
+  return null;
+}
+
+function buildDefaultInput() {
+  return {
+    handoff_bundle: {
+      result_package_ref: "result.spine.job.commitment",
+      source_ref: "spine.job.commitment",
+      transaction_id: "txn-carried-handoff-demo-1",
+      receipt_id: "txn-carried-handoff-demo-receipt-1",
+      proof_ref: "memory://proof-demo/carried-handoff",
+      committed_ref: "transaction.job.commitment",
+      precommit_pack_ref: "precommit.job.commitment.readiness",
+      payment_protocol: "x402",
+      settlement_mode: "bsv_teranode",
+      treasury_destination_id: "treasury_acct_demo",
+      task_refs: ["jobs.quote", "admission.preview", "jobs.reserve", "jobs.commit"],
+      seam_layers: ["execution_consequence", "payment_settlement_treasury", "proof_handoff"]
+    }
+  };
+}
+
+function loadInput(inputPath) {
+  if (!inputPath) {
+    return buildDefaultInput();
+  }
+  return JSON.parse(fs.readFileSync(inputPath, "utf8"));
+}
+
+function main() {
+  const inputPath = parseInputPath(process.argv.slice(2));
+  const input = loadInput(inputPath);
+  const reviewSummary = proof.summarizeReviewedInteractionResultPackageHandoff(input);
+  const runResult = proof.runInteractionResultPackageHandoff({
+    ...input,
+    options: {
+      legacy_identity_material_hex: "aa11bb22cc33dd44"
+    }
+  });
+
+  assert.strictEqual(reviewSummary.ok, true, "review summary missing");
+  assert.strictEqual(reviewSummary.run_ready, true, "review summary should be run-ready");
+  assert.strictEqual(runResult.ok, true, "proof run missing");
+  assert.strictEqual(runResult.bundle_verification.valid, true, "proof bundle verification failed");
+
+  process.stdout.write(JSON.stringify({
+    ok: true,
+    input_file: inputPath,
+    result_package_ref: reviewSummary.result_package_ref,
+    review_ref: reviewSummary.review_ref,
+    run_ready: reviewSummary.run_ready,
+    next_surface: reviewSummary.next_surface,
+    proof_bundle_version: runResult.proof_bundle.proof_bundle_version,
+    bundle_valid: runResult.bundle_verification.valid
+  }, null, 2));
+}
+
+main();

package/lib/bridge_intelligence.js

@@ -0,0 +1,102 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const proofSdk = require("../proof_sdk");
+
+function classifyBridgeCoverageState(bridgeSummary) {
+  if (bridgeSummary.capability_count >= 8 && bridgeSummary.profile_count >= 3) return "broad";
+  if (bridgeSummary.capability_count >= 4 && bridgeSummary.profile_count >= 2) return "working";
+  return "thin";
+}
+
+function classifyCompatibilityStrengthState(compatibilityPack) {
+  const preservedRouteCount = Array.isArray(compatibilityPack.preserved_routes)
+    ? compatibilityPack.preserved_routes.length
+    : 0;
+  const preservedHelperCount = Array.isArray(compatibilityPack.preserved_helpers)
+    ? compatibilityPack.preserved_helpers.length
+    : 0;
+  if (preservedRouteCount >= 5 && preservedHelperCount >= 8) return "strong";
+  if (preservedRouteCount >= 3 && preservedHelperCount >= 5) return "working";
+  return "thin";
+}
+
+function classifyHandoffDependencyState(operatorReviewPack, handoffCenterSummary) {
+  const includedSectionCount = Array.isArray(operatorReviewPack.included_sections)
+    ? operatorReviewPack.included_sections.length
+    : 0;
+  if (includedSectionCount >= 6 && handoffCenterSummary.source_ref_count >= 3) return "strong";
+  if (includedSectionCount >= 4 && handoffCenterSummary.source_ref_count >= 2) return "working";
+  return "thin";
+}
+
+function buildBridgeIntelligencePack(input) {
+  const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+  const bridgeSummary = proofSdk.summarizeBridgeCenter();
+  const compatibilityPack = proofSdk.buildBridgeCompatibilityPack(payload);
+  const operatorReviewPack = proofSdk.buildBridgeOperatorReviewPack(payload);
+  const handoffCenterSummary = proofSdk.summarizeInteractionResultPackageHandoffCenter();
+
+  const bridgeCoverageState = classifyBridgeCoverageState(bridgeSummary);
+  const compatibilityStrengthState = classifyCompatibilityStrengthState(compatibilityPack);
+  const handoffDependencyState = classifyHandoffDependencyState(operatorReviewPack, handoffCenterSummary);
+
+  let nextBestAction = "continue_bridge_review_motion";
+  if (bridgeCoverageState === "thin") {
+    nextBestAction = "strengthen_bridge_coverage";
+  } else if (compatibilityStrengthState === "thin") {
+    nextBestAction = "strengthen_compatibility_posture";
+  } else if (handoffDependencyState !== "strong") {
+    nextBestAction = "strengthen_bridge_handoff_continuity";
+  } else if (compatibilityStrengthState === "working" || handoffDependencyState === "working") {
+    nextBestAction = "inspect_bridge_operator_pack";
+  }
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-bridge-intelligence-pack",
+    bridge_coverage_state: bridgeCoverageState,
+    compatibility_strength_state: compatibilityStrengthState,
+    handoff_dependency_state: handoffDependencyState,
+    recommended_bridge_motion: "bridge_operator_review_and_handoff_followthrough",
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      bridge_capability_count: bridgeSummary.capability_count,
+      bridge_profile_count: bridgeSummary.profile_count,
+      compatibility_route_count: Array.isArray(compatibilityPack.preserved_routes) ? compatibilityPack.preserved_routes.length : 0,
+      compatibility_helper_count: Array.isArray(compatibilityPack.preserved_helpers) ? compatibilityPack.preserved_helpers.length : 0,
+      compatibility_profile_version_count: Array.isArray(compatibilityPack.profile_versions) ? compatibilityPack.profile_versions.length : 0,
+      operator_pack_section_count: Array.isArray(operatorReviewPack.included_sections) ? operatorReviewPack.included_sections.length : 0,
+      handoff_source_ref_count: handoffCenterSummary.source_ref_count,
+      handoff_mode_count: handoffCenterSummary.handoff_mode_count
+    },
+    linked_surfaces: {
+      bridge_summary_ref: "/v1/proof-center/bridge/summary",
+      bridge_operator_review_pack_ref: "/v1/proof-center/bridge/operator-review-pack",
+      bridge_compatibility_pack_ref: "/v1/proof-center/bridge/compatibility-pack",
+      bridge_workflow_pack_ref: "/v1/proof-center/bridge/workflow-pack",
+      result_package_handoff_summary_ref: "/v1/proof-center/result-package-handoff/summary",
+      result_package_handoff_run_ref: "/v1/proof-center/result-package-handoff/run"
+    }
+  };
+}
+
+function summarizeBridgeIntelligencePack(input) {
+  const pack = buildBridgeIntelligencePack(input);
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    bridge_coverage_state: pack.bridge_coverage_state,
+    compatibility_strength_state: pack.compatibility_strength_state,
+    handoff_dependency_state: pack.handoff_dependency_state,
+    next_best_action: pack.next_best_action,
+    signal_count: Object.keys(pack.explanation_signals).length
+  };
+}
+
+module.exports = {
+  buildBridgeIntelligencePack,
+  summarizeBridgeIntelligencePack
+};

package/lib/governance_intelligence.js

@@ -0,0 +1,108 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const proofSdk = require("../proof_sdk");
+
+function classifyEscalationReadinessState(adminView, disputesSummary) {
+  const escalationReadyCount = Number(adminView.oversight_summary?.escalation_ready_count || 0);
+  const openCaseCount = Number(disputesSummary.open_case_count || 0);
+  if (escalationReadyCount >= 1 && openCaseCount >= 2) return "active";
+  if (escalationReadyCount >= 1 || openCaseCount >= 1) return "watch";
+  return "quiet";
+}
+
+function classifySignoffMotionState(dashboard, signoffPack) {
+  const signoffReadyCount = Number(dashboard.queue_summary?.signoff_ready_count || 0);
+  if (signoffPack.signoff_status === "review_ready" && signoffReadyCount >= 1) return "review_ready";
+  if (signoffReadyCount >= 1) return "forming";
+  return "early";
+}
+
+function classifyHandoffContinuityState(handoffBundle) {
+  const includedSectionCount = Array.isArray(handoffBundle.included_sections)
+    ? handoffBundle.included_sections.length
+    : 0;
+  if (
+    includedSectionCount >= 4
+    && handoffBundle.review_summary_surface
+    && handoffBundle.handoff_run_surface
+  ) {
+    return "strong";
+  }
+  if (includedSectionCount >= 2) return "working";
+  return "thin";
+}
+
+function buildGovernanceIntelligencePack(input) {
+  const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+  const dashboard = proofSdk.summarizeGovernanceDashboard(payload);
+  const adminView = proofSdk.summarizeGovernanceAdminView(payload);
+  const disputesSummary = proofSdk.summarizeGovernanceDisputes(payload);
+  const signoffPack = proofSdk.buildGovernanceSignoffPack(payload);
+  const consolePack = proofSdk.buildGovernanceConsolePack(payload);
+  const handoffBundle = proofSdk.buildGovernanceHandoffBundle(payload);
+
+  const escalationReadinessState = classifyEscalationReadinessState(adminView, disputesSummary);
+  const signoffMotionState = classifySignoffMotionState(dashboard, signoffPack);
+  const handoffContinuityState = classifyHandoffContinuityState(handoffBundle);
+
+  let nextBestAction = "continue_governance_flow";
+  if (escalationReadinessState === "active") {
+    nextBestAction = "escalate_governance_attention";
+  } else if (signoffMotionState === "review_ready") {
+    nextBestAction = "advance_signoff_motion";
+  } else if (handoffContinuityState !== "strong") {
+    nextBestAction = "strengthen_handoff_continuity";
+  } else if (escalationReadinessState === "watch") {
+    nextBestAction = "inspect_governance_console";
+  }
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-governance-intelligence-pack",
+    escalation_readiness_state: escalationReadinessState,
+    signoff_motion_state: signoffMotionState,
+    handoff_continuity_state: handoffContinuityState,
+    recommended_governance_motion: "governance_console_and_signoff_followthrough",
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      review_count: Number(dashboard.queue_summary?.review_count || 0),
+      dispute_count: Number(dashboard.queue_summary?.dispute_count || 0),
+      signoff_ready_count: Number(dashboard.queue_summary?.signoff_ready_count || 0),
+      escalation_ready_count: Number(adminView.oversight_summary?.escalation_ready_count || 0),
+      oversight_queue_count: Number(adminView.oversight_summary?.queue_count || 0),
+      open_case_count: Number(disputesSummary.open_case_count || 0),
+      case_count: Number(disputesSummary.case_count || 0),
+      console_section_count: Array.isArray(consolePack.included_sections) ? consolePack.included_sections.length : 0,
+      handoff_section_count: Array.isArray(handoffBundle.included_sections) ? handoffBundle.included_sections.length : 0
+    },
+    linked_surfaces: {
+      governance_dashboard_ref: "/v1/proof-center/governance/dashboard",
+      governance_admin_view_ref: "/v1/proof-center/governance/admin-view",
+      governance_signoff_pack_ref: "/v1/proof-center/governance/signoff-pack",
+      governance_console_pack_ref: "/v1/proof-center/governance/console-pack",
+      governance_handoff_bundle_ref: "/v1/proof-center/governance/handoff-bundle",
+      governance_disputes_summary_ref: "/v1/proof-center/governance/disputes/summary"
+    }
+  };
+}
+
+function summarizeGovernanceIntelligencePack(input) {
+  const pack = buildGovernanceIntelligencePack(input);
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    escalation_readiness_state: pack.escalation_readiness_state,
+    signoff_motion_state: pack.signoff_motion_state,
+    handoff_continuity_state: pack.handoff_continuity_state,
+    next_best_action: pack.next_best_action,
+    signal_count: Object.keys(pack.explanation_signals).length
+  };
+}
+
+module.exports = {
+  buildGovernanceIntelligencePack,
+  summarizeGovernanceIntelligencePack
+};

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: "proof-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 proof 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: "proof-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/proof/summary",
+        "/v1/phases/phase-10/niche-extension-registry/proof/summary",
+        "/v1/phases/phase-10/ecosystem-backlog-triage/proof/summary"
+      ],
+      proof_modes: ["demand_signal_capture", "extension_registry_mapping", "backlog_triage"],
+      demand_modes: ["partner_signal_flow", "extension_fit_flow", "queue_handoff_flow"],
+      proof_artifacts: ["demand_signal_bundle", "extension_registry_bundle", "triage_queue_bundle"],
+      proof_surfaces: [
+        "/v1/proof-center/bridge/summary",
+        "/v1/release-center/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 proof lanes are public and inspectable",
+        "extension posture is visible at phase level",
+        "long-tail continuity is explicit across the proof lane family",
+        "release-center summary reflects Phase 10 breadth and proof-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 proof 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.proof_surfaces_attached", label: "Proof 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,
+    proof_mode_count: pack.coverage.proof_modes.length,
+    demand_mode_count: pack.coverage.demand_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 = {
+  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: "proof-phase-10-decision-record-pack",
+    phase_ref: "phase_10",
+    posture: "decision_record",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final long-tail proof 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 proof 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: "proof-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 proof 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
+};