xoonya 1.15.0 → 1.17.0

package/README.md

@@ -143,6 +143,11 @@ Primary proof-model routes:
 - `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-intake`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-intake-boundary`
+- `POST /v1/proof-center/result-package-handoff/review/handoff-intake-carry`
+- `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.
@@ -153,6 +158,10 @@ It now also exposes composition-contract summaries so the proof-side default sea
 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-intake summary and handoff-intake-boundary summary so that same handoff contract can be consumed more directly as a stable proof-native intake surface for future adapters without widening proof scope.
+It now also exposes a handoff-intake-carry summary so the same proof-side intake surface can be reused more directly as compact consumable carry instead of only summary or boundary posture.
+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.15.0",
+  "version": "1.17.0",
   "description": "Deterministic proof SDK for canonical events, receipts, proof bundles, and verification.",
   "main": "index.js",
   "type": "commonjs",

package/proof_sdk.js

@@ -1572,6 +1572,70 @@ function summarizeReviewBridgeRun(input) {
   };
 }
 
+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 summarizeReviewHandoffIntake(input) {
+  const continuity = summarizeReviewHandoffContinuity(input);
+  return {
+    ok: continuity.ok === true,
+    handoff_contract_ref: continuity.handoff_contract_ref || null,
+    handoff_surface_ref: continuity.handoff_contract_ref ? `surface.${continuity.handoff_contract_ref}` : null,
+    stable_handoff_surface_ids: Array.isArray(continuity.stable_handoff_ids) ? continuity.stable_handoff_ids : [],
+    adapter_consumable: continuity.handoff_ready === true,
+    run_surface: continuity.run_surface || null,
+    intake_path_ids: Array.isArray(continuity.continuity_path_ids) ? continuity.continuity_path_ids : []
+  };
+}
+
+function summarizeReviewHandoffIntakeBoundary(input) {
+  const intake = summarizeReviewHandoffIntake(input);
+  return {
+    ok: intake.ok === true,
+    handoff_surface_ref: intake.handoff_surface_ref || null,
+    stable_boundary_ids: Array.isArray(intake.stable_handoff_surface_ids) ? intake.stable_handoff_surface_ids : [],
+    adapter_consumable: intake.adapter_consumable === true,
+    run_surface: intake.run_surface || null,
+    intake_path_ids: Array.isArray(intake.intake_path_ids) ? intake.intake_path_ids : []
+  };
+}
+
+function summarizeReviewHandoffIntakeCarry(input) {
+  const intake = summarizeReviewHandoffIntake(input);
+  return {
+    ok: intake.ok === true,
+    handoff_surface_ref: intake.handoff_surface_ref || null,
+    stable_handoff_surface_ids: Array.isArray(intake.stable_handoff_surface_ids) ? intake.stable_handoff_surface_ids : [],
+    consumable_handoff_carry: {
+      run_surface: intake.run_surface || null,
+      intake_path_ids: Array.isArray(intake.intake_path_ids) ? intake.intake_path_ids : []
+    },
+    adapter_consumable: intake.adapter_consumable === true
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1639,6 +1703,11 @@ module.exports = {
   summarizeReviewBridgeBoundary,
   summarizeReviewBridgeCarry,
   summarizeReviewBridgeRun,
+  summarizeReviewHandoffContinuity,
+  summarizeReviewHandoffIntake,
+  summarizeReviewHandoffIntakeBoundary,
+  summarizeReviewHandoffIntakeCarry,
+  summarizeReviewHandoffRun,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,
   runTransactionProofHandoff,

package/server.js

@@ -325,6 +325,61 @@ async function routeRequest(req, res) {
     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-intake') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffIntake(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-intake-boundary') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffIntakeBoundary(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-intake-carry') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewHandoffIntakeCarry(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);