xoonya 1.10.0 → 1.12.0

package/README.md

@@ -131,7 +131,13 @@ Primary proof-model routes:
 - `GET /v1/proof-center/result-package-handoff`
 - `GET /v1/proof-center/result-package-handoff/summary`
 - `POST /v1/proof-center/result-package-handoff/review`
+- `POST /v1/proof-center/result-package-handoff/review/summary`
+- `POST /v1/proof-center/result-package-handoff/review/extension-readiness`
+- `POST /v1/proof-center/result-package-handoff/review/extension-boundary`
 - `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.
+It also now exposes an extension-readiness summary so the stable post-review proof boundary is easier to treat as a reusable seam.
 - `POST /v1/events/canonicalize`
 - `POST /v1/events/hash`
 - `POST /v1/receipts/emit`

package/package.json

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

package/proof_sdk.js

@@ -1301,6 +1301,8 @@ function summarizeInteractionResultPackageHandoff(bundle) {
 
 function reviewInteractionResultPackageHandoff(input) {
   const handoff = canonicalizeInteractionResultPackageHandoff(input);
+  const seamLayers = Array.isArray(handoff.seam_layers) ? handoff.seam_layers : [];
+  const taskRefs = Array.isArray(handoff.task_refs) ? handoff.task_refs : [];
   return {
     ok: true,
     handoff_kind: "interaction_result_package",
@@ -1313,14 +1315,97 @@ function reviewInteractionResultPackageHandoff(input) {
       handoff.payment_protocol,
       handoff.settlement_mode,
       handoff.treasury_destination_id,
-      ...(Array.isArray(handoff.task_refs) ? handoff.task_refs : []),
-      ...(Array.isArray(handoff.seam_layers) ? handoff.seam_layers : [])
-    ].filter(Boolean).length,
+        ...taskRefs,
+        ...seamLayers
+      ].filter(Boolean).length,
+    durability_summary: {
+      review_ref: handoff.result_package_ref ? `review.${handoff.result_package_ref}` : null,
+      preserved_context: {
+        execution_result: {
+          committed_ref: handoff.committed_ref || null,
+          task_ref_count: taskRefs.length
+        },
+        economic_state: {
+          payment_protocol: handoff.payment_protocol || null,
+          settlement_mode: handoff.settlement_mode || null,
+          treasury_destination_id: handoff.treasury_destination_id || null
+        },
+        proof_handoff: {
+          source_ref: handoff.source_ref || null,
+          seam_layer_count: seamLayers.length,
+          seam_layers: seamLayers
+        }
+      },
+      run_ready: Boolean(handoff.transaction_id && handoff.receipt_id && handoff.proof_ref),
+      next_surface: "/v1/proof-center/result-package-handoff/run"
+    },
     recommended_loop: "default.proof.bundle.loop",
     next_surface: "/v1/proof-center/result-package-handoff/run"
   };
 }
 
+function summarizeReviewedInteractionResultPackageHandoff(input) {
+  const review = reviewInteractionResultPackageHandoff(input);
+  const durability = review.durability_summary && typeof review.durability_summary === "object"
+    ? review.durability_summary
+    : {};
+  const proofHandoff = durability.preserved_context && durability.preserved_context.proof_handoff
+    ? durability.preserved_context.proof_handoff
+    : {};
+  return {
+    ok: review.ok === true,
+    handoff_kind: review.handoff_kind || null,
+    result_package_ref: review.handoff && review.handoff.result_package_ref ? review.handoff.result_package_ref : null,
+    review_ref: durability.review_ref || null,
+    run_ready: durability.run_ready === true,
+    next_surface: durability.next_surface || review.next_surface || null,
+    preserved_seam_layer_count: Number(proofHandoff.seam_layer_count || 0)
+  };
+}
+
+function summarizeReviewExtensionReadiness(input) {
+  const review = reviewInteractionResultPackageHandoff(input);
+  const durability = review.durability_summary && typeof review.durability_summary === "object"
+    ? review.durability_summary
+    : {};
+  const preserved = durability.preserved_context && typeof durability.preserved_context === "object"
+    ? durability.preserved_context
+    : {};
+  return {
+    ok: review.ok === true,
+    handoff_kind: review.handoff_kind || null,
+    result_package_ref: review.handoff && review.handoff.result_package_ref ? review.handoff.result_package_ref : null,
+    review_ref: durability.review_ref || null,
+    extension_ready_ref: durability.review_ref ? `extension.${durability.review_ref}` : null,
+    stable_post_review_context: {
+      execution_context_ready: Boolean(preserved.execution_result && preserved.execution_result.committed_ref),
+      economic_context_ready: Boolean(
+        preserved.economic_state &&
+        (preserved.economic_state.payment_protocol || preserved.economic_state.settlement_mode || preserved.economic_state.treasury_destination_id)
+      ),
+      proof_context_ready: Boolean(preserved.proof_handoff && preserved.proof_handoff.source_ref)
+    },
+    proof_extension_ready: durability.run_ready === true,
+    next_surface: durability.next_surface || review.next_surface || null
+  };
+}
+
+function summarizeReviewExtensionBoundary(input) {
+  const readiness = summarizeReviewExtensionReadiness(input);
+  return {
+    ok: readiness.ok === true,
+    handoff_kind: readiness.handoff_kind || null,
+    result_package_ref: readiness.result_package_ref || null,
+    extension_ready_ref: readiness.extension_ready_ref || null,
+    stable_boundary_ids: [
+      "review_extension_readiness",
+      "proof_run"
+    ],
+    proof_extension_ready: readiness.proof_extension_ready === true,
+    next_surface: readiness.next_surface || null
+  };
+}
+
 function runDefaultProofLoop(loopRef, input) {
   const loop = getDefaultProofLoop(loopRef);
   if (!loop) {
@@ -1376,6 +1461,9 @@ module.exports = {
   canonicalizeTransactionProofHandoff,
   runDefaultProofLoop,
   reviewInteractionResultPackageHandoff,
+  summarizeReviewedInteractionResultPackageHandoff,
+  summarizeReviewExtensionReadiness,
+  summarizeReviewExtensionBoundary,
   runInteractionResultPackageHandoff,
   runInteractionSpineProofHandoff,
   runTransactionProofHandoff,

package/server.js

@@ -193,6 +193,39 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === 'POST' && url.pathname === '/v1/proof-center/result-package-handoff/review/summary') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewedInteractionResultPackageHandoff(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/extension-readiness') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewExtensionReadiness(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/extension-boundary') {
+    try {
+      const body = await readJsonBody(req);
+      const result = proofSdk.summarizeReviewExtensionBoundary(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);