xoonya 1.14.0 → 1.16.0

package/README.md

@@ -139,6 +139,12 @@ Primary proof-model routes:
 - `POST /v1/proof-center/result-package-handoff/review/contract-summary`
 - `POST /v1/proof-center/result-package-handoff/review/contract-boundary`
 - `POST /v1/proof-center/result-package-handoff/review/contract-carry`
+- `POST /v1/proof-center/result-package-handoff/review/bridge-summary`
+- `POST /v1/proof-center/result-package-handoff/review/bridge-boundary`
+- `POST /v1/proof-center/result-package-handoff/review/bridge-carry`
+- `POST /v1/proof-center/result-package-handoff/review/bridge-run`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-continuity`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-run`
 - `POST /v1/proof-center/result-package-handoff/run`
 
 The result-package review surface now also returns a durability summary so the preserved execution, economic, and proof-facing context is easier to inspect before proof-native execution.
@@ -147,6 +153,10 @@ It now also exposes a reusable-default continuation summary so that same stable
 It now also exposes a compact reusable-default boundary summary so the proof-side default seam can be treated as a stable public boundary, not just a recommended path.
 It now also exposes composition-contract summaries so the proof-side default seam can be treated more clearly as a stable public contract across review and run.
 It now also exposes compact contract-carry summaries so the stable proof-side contract context is easier to inspect directly without expanding proof scope.
+It now also exposes bridge summaries, bridge-boundary summaries, and bridge-carry summaries so the proof-side review seam is easier to treat as an adapter-ready bridge without widening proof scope.
+It now also exposes a bridge-run summary so that same proof-side bridge can be read directly as the final run posture instead of only as review-stage carry.
+It now also exposes a handoff-continuity summary so the proof-side bridge can be treated more clearly as a stable handoff contract into proof-native execution.
+It now also exposes a handoff-run summary so that same handoff contract can be read directly as the final proof-native run posture instead of only as continuity guidance.
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`
 - `POST /v1/receipts/emit`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xoonya",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "Deterministic proof SDK for canonical events, receipts, proof bundles, and verification.",
   "main": "index.js",
   "type": "commonjs",

package/proof_sdk.js

@@ -1514,6 +1514,89 @@ function summarizeReviewCompositionContractCarry(input) {
   };
 }
 
+function summarizeReviewBridgeSummary(input) {
+  const contract = summarizeReviewCompositionContract(input);
+  return {
+    ok: contract.ok === true,
+    composition_contract_ref: contract.composition_contract_ref || null,
+    adapter_bridge_ref: contract.composition_contract_ref
+      ? `bridge.${contract.composition_contract_ref}`
+      : null,
+    stable_bridge_ids: [
+      "review_bridge_summary",
+      "proof_run"
+    ],
+    bridge_carry: contract.stable_contract_context || {},
+    bridge_ready: contract.contract_ready === true,
+    next_surface: contract.next_surface || null
+  };
+}
+
+function summarizeReviewBridgeBoundary(input) {
+  const bridge = summarizeReviewBridgeSummary(input);
+  return {
+    ok: bridge.ok === true,
+    adapter_bridge_ref: bridge.adapter_bridge_ref || null,
+    stable_boundary_ids: [
+      "review_bridge_summary",
+      "proof_run"
+    ],
+    bridge_ready: bridge.bridge_ready === true,
+    next_surface: bridge.next_surface || null
+  };
+}
+
+function summarizeReviewBridgeCarry(input) {
+  const bridge = summarizeReviewBridgeSummary(input);
+  return {
+    ok: bridge.ok === true,
+    adapter_bridge_ref: bridge.adapter_bridge_ref || null,
+    stable_bridge_ids: Array.isArray(bridge.stable_bridge_ids) ? bridge.stable_bridge_ids : [],
+    bridge_carry: bridge.bridge_carry || {},
+    bridge_ready: bridge.bridge_ready === true,
+    next_surface: bridge.next_surface || null
+  };
+}
+
+function summarizeReviewBridgeRun(input) {
+  const bridge = summarizeReviewBridgeSummary(input);
+  return {
+    ok: bridge.ok === true,
+    adapter_bridge_ref: bridge.adapter_bridge_ref || null,
+    accepted_bridge_ids: Array.isArray(bridge.stable_bridge_ids) ? bridge.stable_bridge_ids : [],
+    bridge_ready: bridge.bridge_ready === true,
+    run_surface: bridge.next_surface || null,
+    run_path_ids: [
+      "proof_run"
+    ]
+  };
+}
+
+function summarizeReviewHandoffContinuity(input) {
+  const bridgeRun = summarizeReviewBridgeRun(input);
+  return {
+    ok: bridgeRun.ok === true,
+    adapter_bridge_ref: bridgeRun.adapter_bridge_ref || null,
+    handoff_contract_ref: bridgeRun.adapter_bridge_ref ? `handoff.${bridgeRun.adapter_bridge_ref}` : null,
+    stable_handoff_ids: Array.isArray(bridgeRun.accepted_bridge_ids) ? bridgeRun.accepted_bridge_ids : [],
+    handoff_ready: bridgeRun.bridge_ready === true,
+    run_surface: bridgeRun.run_surface || null,
+    continuity_path_ids: Array.isArray(bridgeRun.run_path_ids) ? bridgeRun.run_path_ids : []
+  };
+}
+
+function summarizeReviewHandoffRun(input) {
+  const continuity = summarizeReviewHandoffContinuity(input);
+  return {
+    ok: continuity.ok === true,
+    handoff_contract_ref: continuity.handoff_contract_ref || null,
+    accepted_handoff_ids: Array.isArray(continuity.stable_handoff_ids) ? continuity.stable_handoff_ids : [],
+    handoff_ready: continuity.handoff_ready === true,
+    run_surface: continuity.run_surface || null,
+    run_path_ids: Array.isArray(continuity.continuity_path_ids) ? continuity.continuity_path_ids : []
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1577,6 +1660,12 @@ module.exports = {
   summarizeReviewCompositionContract,
   summarizeReviewCompositionContractBoundary,
   summarizeReviewCompositionContractCarry,
+  summarizeReviewBridgeSummary,
+  summarizeReviewBridgeBoundary,
+  summarizeReviewBridgeCarry,
+  summarizeReviewBridgeRun,
+  summarizeReviewHandoffContinuity,
+  summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,
   runTransactionProofHandoff,

package/server.js

@@ -281,6 +281,72 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/bridge-summary') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewBridgeSummary(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/bridge-boundary') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewBridgeBoundary(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/bridge-carry') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewBridgeCarry(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/bridge-run') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewBridgeRun(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-continuity') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffContinuity(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/handoff-run') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffRun(body);
+      sendJson(res, 200, result);
+    } catch (error) {
+      sendJson(res, 400, { ok: false, reason: error.message });
+    }
+    return;
+  }
+
   if (req.method === 'POST' && url.pathname === '/v1/receipts/verify') {
     try {
       const body = await readJsonBody(req);