xoonya 3.0.0 → 3.1.0

package/examples/partner_proof_walkthrough.js

@@ -1,68 +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;
-});
+"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

@@ -1,66 +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;
-});
+"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

@@ -1,72 +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();
+"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/index.js

@@ -1,22 +1,31 @@
-"use strict";
-
-module.exports = {
-  ...require("./proof_sdk"),
-  ...require("./integrations/registry"),
-  ...require("./lib/verification_service_pack"),
-  ...require("./lib/trust_portability_pack"),
-  ...require("./lib/proof_truth_contract"),
-  ...require("./lib/default_path_contract"),
-  ...require("./lib/followthrough_truth_contract"),
-  ...require("./lib/governance_disputes_summary"),
-  ...require("./lib/release_pack"),
-  ...require("./lib/release_manifest"),
-  ...require("./lib/release_center"),
-  ...require("./lib/release_history"),
-  ...require("./lib/publish_plan"),
-  ...require("./lib/ecosystem_entry"),
-  ...require("./lib/launch_narrative"),
-  ...require("./lib/outreach_proof"),
-  ...require("./lib/announcement_pack"),
-  ...require("./lib/release_candidate")
-};
+"use strict";
+
+module.exports = {
+  ...require("./proof_sdk"),
+  ...require("./integrations/registry"),
+  ...require("./lib/verification_service_pack"),
+  ...require("./lib/trust_portability_pack"),
+...require("./lib/proof_truth_contract"),
+...require("./lib/operational_receipt_contract"),
+...require("./lib/machine_identity_registry_contract"),
+...require("./lib/crypto_agility_matrix"),
+...require("./lib/authority_binding_lifecycle_contract"),
+...require("./lib/public_surface_policy_contract"),
+...require("./lib/offline_verifiability_recovery_contract"),
+...require("./lib/adapter_certification_contract"),
+...require("./lib/trust_portability_boundary_contract"),
+...require("./lib/signed_audit_provenance_contract"),
+...require("./lib/default_path_contract"),
+...require("./lib/followthrough_truth_contract"),
+  ...require("./lib/governance_disputes_summary"),
+  ...require("./lib/release_pack"),
+  ...require("./lib/release_manifest"),
+  ...require("./lib/release_center"),
+  ...require("./lib/release_history"),
+  ...require("./lib/publish_plan"),
+  ...require("./lib/ecosystem_entry"),
+  ...require("./lib/launch_narrative"),
+  ...require("./lib/outreach_proof"),
+  ...require("./lib/announcement_pack"),
+  ...require("./lib/release_candidate")
+};

package/integrations/PROOF_INTEGRATION_PROCESS.md

@@ -1,45 +1,45 @@
-# Proof Integration Process
-
-This note captures the lighter third-party path for `xoonya`.
-
-`xoonya` is not a commerce registry. Its integration model is intentionally narrower.
-
-## Goal
-
-Allow proof-adjacent integrations to be registered, inspected, and exported without letting pricing, workflow, or settlement logic leak into the proof kernel.
-
-## Typical proof-side integrations
-
-- identity-material providers
-- proof-bundle reference adapters
-- profile verification helpers
-- external verifier references
-
-## Recommended flow
-
-1. Define the proof-adjacent integration boundary.
-2. Create the registration record.
-3. Validate registration posture locally.
-4. Export a filtered snapshot when you need a reviewable proof-side state view.
-5. Treat promotion posture as explicit review data, not as an assumption.
-
-## Local commands
-
-From a cloned `xoonya` repo:
-
-```bash
-node scripts/registry_cli.js validate-registration --example verifier
-node scripts/registry_cli.js export-snapshot --registration_state staging_registered
-node scripts/registry_cli.js promotion-readiness --integration verifier.bundle.reference
-```
-
-## Posture rules
-
-- staged proof integrations can be visible
-- staged proof integrations can be review-ready
-- staged proof integrations should not become default by accident
-- blockers should be returned as data
-
-## Boundary rule
-
-If a proposed proof-side integration needs workflow, pricing, payment, or settlement semantics to make sense, it probably belongs in `xytara`, not `xoonya`.
+# Proof Integration Process
+
+This note captures the lighter third-party path for `xoonya`.
+
+`xoonya` is not a commerce registry. Its integration model is intentionally narrower.
+
+## Goal
+
+Allow proof-adjacent integrations to be registered, inspected, and exported without letting pricing, workflow, or settlement logic leak into the proof kernel.
+
+## Typical proof-side integrations
+
+- identity-material providers
+- proof-bundle reference adapters
+- profile verification helpers
+- external verifier references
+
+## Recommended flow
+
+1. Define the proof-adjacent integration boundary.
+2. Create the registration record.
+3. Validate registration posture locally.
+4. Export a filtered snapshot when you need a reviewable proof-side state view.
+5. Treat promotion posture as explicit review data, not as an assumption.
+
+## Local commands
+
+From a cloned `xoonya` repo:
+
+```bash
+node scripts/registry_cli.js validate-registration --example verifier
+node scripts/registry_cli.js export-snapshot --registration_state staging_registered
+node scripts/registry_cli.js promotion-readiness --integration verifier.bundle.reference
+```
+
+## Posture rules
+
+- staged proof integrations can be visible
+- staged proof integrations can be review-ready
+- staged proof integrations should not become default by accident
+- blockers should be returned as data
+
+## Boundary rule
+
+If a proposed proof-side integration needs workflow, pricing, payment, or settlement semantics to make sense, it probably belongs in `xytara`, not `xoonya`.

package/integrations/examples/example-third-party-verifier-registration.record.json

@@ -1,22 +1,22 @@
-{
-  "integration_id": "partner.verifier.lattice_notary",
-  "integration_class": "verification_helper_adapter",
-  "proof_scope": "profile_verification",
-  "registration_state": "staging_registered",
-  "integration_maturity": "staging_candidate",
-  "certification_state": "self_attested",
-  "bundled": false,
-  "default_selection_enabled": false,
-  "requires_explicit_selection": true,
-  "registered_at": "2026-03-20T00:00:00Z",
-  "registered_by": "partner:lattice-labs",
-  "verified_with": [
-    "schema_conformance",
-    "profile_verification_smoke"
-  ],
-  "certification_scope": [
-    "self_attested_contract_shape",
-    "staging_profile_smoke"
-  ],
-  "notes": "Reference staged verifier registration for proof-side import and discovery validation."
-}
+{
+  "integration_id": "partner.verifier.lattice_notary",
+  "integration_class": "verification_helper_adapter",
+  "proof_scope": "profile_verification",
+  "registration_state": "staging_registered",
+  "integration_maturity": "staging_candidate",
+  "certification_state": "self_attested",
+  "bundled": false,
+  "default_selection_enabled": false,
+  "requires_explicit_selection": true,
+  "registered_at": "2026-03-20T00:00:00Z",
+  "registered_by": "partner:lattice-labs",
+  "verified_with": [
+    "schema_conformance",
+    "profile_verification_smoke"
+  ],
+  "certification_scope": [
+    "self_attested_contract_shape",
+    "staging_profile_smoke"
+  ],
+  "notes": "Reference staged verifier registration for proof-side import and discovery validation."
+}