xoonya 3.0.0 → 3.1.0

package/integrations/views.js

@@ -1,36 +1,36 @@
-"use strict";
-
-function buildMissingResponse(reason) {
-  return {
-    status: 404,
-    payload: {
-      status: "not_found",
-      reason
-    }
-  };
-}
-
-function buildIntegrationListResponse(payload) {
-  return {
-    status: 200,
-    payload
-  };
-}
-
-function buildIntegrationDetailResponse(integration) {
-  if (!integration) {
-    return buildMissingResponse("integration_not_found");
-  }
-  return {
-    status: 200,
-    payload: {
-      ok: true,
-      integration
-    }
-  };
-}
-
-module.exports = {
-  buildIntegrationDetailResponse,
-  buildIntegrationListResponse
-};
+"use strict";
+
+function buildMissingResponse(reason) {
+  return {
+    status: 404,
+    payload: {
+      status: "not_found",
+      reason
+    }
+  };
+}
+
+function buildIntegrationListResponse(payload) {
+  return {
+    status: 200,
+    payload
+  };
+}
+
+function buildIntegrationDetailResponse(integration) {
+  if (!integration) {
+    return buildMissingResponse("integration_not_found");
+  }
+  return {
+    status: 200,
+    payload: {
+      ok: true,
+      integration
+    }
+  };
+}
+
+module.exports = {
+  buildIntegrationDetailResponse,
+  buildIntegrationListResponse
+};

package/lib/adapter_certification_contract.js

@@ -0,0 +1,90 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildAdapterCertificationContractPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "naxytra-adapter-certification-contract",
+    pack_version: "naxytra-adapter-certification-contract-v1",
+    doctrine: "xoonya_certifies_adapter_compatibility_for_proof_and_review_surfaces_without_leaking_proof_core_semantics",
+    model_state: "core_now",
+    core_claim: "adapter certification is the machine-readable gate for manifest, capability, health, idempotency, failure, proof, and front-specific compatibility claims",
+    certification_states: [
+      { state: "pass", description: "the adapter satisfies the declared front contract without material constraints" },
+      { state: "pass_with_constraints", description: "the adapter is usable but only within declared constraints" },
+      { state: "needs_retest", description: "the adapter needs a fresh run against updated vectors or interface versions" },
+      { state: "blocked", description: "the adapter cannot be certified until a required dependency or vector exists" },
+      { state: "fail", description: "the adapter does not satisfy the declared front contract" }
+    ],
+    certification_fronts: [
+      { front_id: "protocol_front", required_tests: ["protocol negotiation", "surface discovery", "normalized request translation"], required_evidence: ["manifest", "protocol compatibility result", "failure mapping result"], claim_boundary: "only_claim_listed_protocol_front_compatibility" },
+      { front_id: "execution_front", required_tests: ["task dispatch", "idempotency", "execution result normalization"], required_evidence: ["manifest", "task vector results", "proof-compatible output facts"], claim_boundary: "only_claim_listed_execution_front_compatibility" },
+      { front_id: "payment_front", required_tests: ["quote to pay compatibility", "payment admission", "reversal or refund posture"], required_evidence: ["payment state result", "receipt compatibility result", "failure mapping result"], claim_boundary: "only_claim_listed_payment_front_compatibility" },
+      { front_id: "settlement_front", required_tests: ["settlement target translation", "finality reference capture", "batch or direct settlement posture"], required_evidence: ["settlement reference", "finality state", "reconciliation evidence"], claim_boundary: "only_claim_listed_settlement_front_compatibility" },
+      { front_id: "identity_trust_front", required_tests: ["identity schema compatibility", "registry linkage", "attestation or trust-state roundtrip"], required_evidence: ["identity record", "registry proof", "trust-state result"], claim_boundary: "only_claim_listed_identity_trust_front_compatibility" },
+      { front_id: "proof_front", required_tests: ["receipt compatibility", "proof import or export compatibility", "verification hook compatibility"], required_evidence: ["proof contract result", "receipt result", "verification evidence"], claim_boundary: "only_claim_listed_proof_front_compatibility" },
+      { front_id: "treasury_front", required_tests: ["destination routing", "balance model compatibility", "payout landing compatibility"], required_evidence: ["treasury route result", "account abstraction result", "operator review note"], claim_boundary: "only_claim_listed_treasury_front_compatibility" },
+      { front_id: "operator_front", required_tests: ["review surface visibility", "promotion posture", "reporting export compatibility"], required_evidence: ["review summary", "promotion readiness result", "operator export"], claim_boundary: "only_claim_listed_operator_front_compatibility" }
+    ],
+    harness_requirements: {
+      test_categories: [
+        "manifest_validity",
+        "interface_conformance",
+        "capability_declaration",
+        "health_reporting",
+        "failure_mapping",
+        "idempotency_behavior",
+        "proof_compatibility",
+        "front_specific_lifecycle_compatibility"
+      ],
+      required_result_fields: [
+        "certification_state",
+        "interface_version",
+        "tested_fronts",
+        "tested_capabilities",
+        "failed_cases",
+        "warnings",
+        "evidence_refs"
+      ]
+    },
+    linked_surfaces: {
+      proof_bridge_ref: "/v1/proof-bridge",
+      verification_services_ref: "/v1/proof-center/verification-services",
+      submission_bundle_review_ref: "/v1/proof-center/result-package-handoff/review/summary",
+      trust_portability_ref: "/v1/proof-center/trust-portability/summary",
+      integration_matrix_ref: "/v1/integration-matrix",
+      provenance_ref: "/v1/provenance"
+    },
+    claim_boundary: "claim_adapter_certification_as_front_specific_compatibility_and_review_gate_without_claiming_vendor_default_or_proof_core_truth"
+  };
+}
+
+function summarizeAdapterCertificationContractPack() {
+  const pack = buildAdapterCertificationContractPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    summary_version: "naxytra-adapter-certification-contract-summary-v1",
+    pack_version: pack.pack_version,
+    model_state: pack.model_state,
+    certification_state_count: pack.certification_states.length,
+    certification_front_count: pack.certification_fronts.length,
+    required_test_category_count: pack.harness_requirements.test_categories.length,
+    linked_surfaces: pack.linked_surfaces
+  };
+}
+
+function getAdapterCertificationFrontDetail(frontId) {
+  const normalized = String(frontId || "").trim().toLowerCase();
+  return (buildAdapterCertificationContractPack().certification_fronts || []).find((entry) => entry.front_id === normalized) || null;
+}
+
+module.exports = {
+  buildAdapterCertificationContractPack,
+  summarizeAdapterCertificationContractPack,
+  getAdapterCertificationFrontDetail
+};
+

package/lib/announcement_pack.js

@@ -1,61 +1,61 @@
-"use strict";
-
-const packageJson = require("../package.json");
-
-function buildAnnouncementPack() {
-  return {
-    ok: true,
-    product: packageJson.name,
-    category: "proof-announcement-pack",
-    public_quickstart: {
-      install: "npm install xoonya",
-      first_cli: "xoonya-review --file ./handoff.json --summary",
-      first_release_view: "xoonya-release --center --summary",
-      first_http: "/v1/release-center/summary"
-    },
-    release_candidate: {
-      checks: [
-        "install the package on a clean machine",
-        "run xoonya-release --center --summary",
-        "run npm run verify:all",
-        "verify /v1/release-center/summary on the deployed service",
-        "verify /v1/outreach-proof/summary on the deployed service"
-      ]
-    },
-    publish_day: {
-      sequence: [
-        "publish the npm package",
-        "redeploy the service and docs surfaces",
-        "verify release-center, launch-narrative, and outreach-proof summaries live",
-        "run the first public proof-side review path",
-        "share the announcement artifact with proof operators and verification-focused builders"
-      ]
-    },
-    public_message: {
-      headline: "reviewable proof continuation for machine actions that cross trust boundaries",
-      who_should_try_first: [
-        "proof operators",
-        "runtime builders needing verification followthrough",
-        "governance and audit teams"
-      ]
-    }
-  };
-}
-
-function summarizeAnnouncementPack() {
-  const pack = buildAnnouncementPack();
-  return {
-    ok: true,
-    product: pack.product,
-    category: pack.category,
-    rc_check_count: pack.release_candidate.checks.length,
-    publish_step_count: pack.publish_day.sequence.length,
-    first_cli: pack.public_quickstart.first_cli,
-    audience_count: pack.public_message.who_should_try_first.length
-  };
-}
-
-module.exports = {
-  buildAnnouncementPack,
-  summarizeAnnouncementPack
-};
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildAnnouncementPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "proof-announcement-pack",
+    public_quickstart: {
+      install: "npm install xoonya",
+      first_cli: "xoonya-review --file ./handoff.json --summary",
+      first_release_view: "xoonya-release --center --summary",
+      first_http: "/v1/release-center/summary"
+    },
+    release_candidate: {
+      checks: [
+        "install the package on a clean machine",
+        "run xoonya-release --center --summary",
+        "run npm run verify:all",
+        "verify /v1/release-center/summary on the deployed service",
+        "verify /v1/outreach-proof/summary on the deployed service"
+      ]
+    },
+    publish_day: {
+      sequence: [
+        "publish the npm package",
+        "redeploy the service and docs surfaces",
+        "verify release-center, launch-narrative, and outreach-proof summaries live",
+        "run the first public proof-side review path",
+        "share the announcement artifact with proof operators and verification-focused builders"
+      ]
+    },
+    public_message: {
+      headline: "reviewable proof continuation for machine actions that cross trust boundaries",
+      who_should_try_first: [
+        "proof operators",
+        "runtime builders needing verification followthrough",
+        "governance and audit teams"
+      ]
+    }
+  };
+}
+
+function summarizeAnnouncementPack() {
+  const pack = buildAnnouncementPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    rc_check_count: pack.release_candidate.checks.length,
+    publish_step_count: pack.publish_day.sequence.length,
+    first_cli: pack.public_quickstart.first_cli,
+    audience_count: pack.public_message.who_should_try_first.length
+  };
+}
+
+module.exports = {
+  buildAnnouncementPack,
+  summarizeAnnouncementPack
+};

package/lib/artifact_distribution_lane_contract.js

@@ -1,54 +1,54 @@
-"use strict";
-
-function buildArtifactDistributionLanePack() {
-  return {
-    product: "xoonya",
-    category: "proof-artifact-distribution-lane-pack",
-    pack_version: "xoonya-artifact-distribution-lane-pack-v1",
-    lane_state: "first_party_artifact_distribution_lane_present",
-    posture: "oci_style_distribution_for_proof_bundles_and_integration_artifacts",
-    standards: ["oci_artifacts", "oras_style_distribution"],
-    artifact_families: ["proof_bundles", "handoff_bundles", "integration_snapshots", "release_artifacts"],
-    supported_surfaces: {
-      integrations_ref: "/v1/integrations",
-      integrations_snapshot_ref: "/v1/integrations/snapshot",
-      proof_bridge_ref: "/v1/proof-bridge",
-      result_package_trust_ref: "/v1/result-package-trust",
-      release_center_ref: "/v1/release-center"
-    },
-    first_run_flows: [
-      {
-        flow_ref: "proof_artifact_distribution_alignment",
-        recommended_reason: "best path for teams that want portable proof and integration artifacts rather than custom export conventions",
-        sequence: [
-          "inspect_artifact_distribution_lane_summary",
-          "inspect proof_bridge and import surfaces",
-          "treat proof bundles and integration snapshots as distribution-ready artifacts",
-          "publish or transfer them later through standard artifact registries without changing proof semantics"
-        ]
-      }
-    ],
-    guardrails: [
-      "artifact portability should preserve canonical proof bundle and handoff shapes",
-      "distribution posture must not create a second proof model"
-    ]
-  };
-}
-
-function summarizeArtifactDistributionLanePack() {
-  const pack = buildArtifactDistributionLanePack();
-  return {
-    product: "xoonya",
-    category: "proof-artifact-distribution-lane-pack-summary",
-    summary_version: "xoonya-artifact-distribution-lane-pack-summary-v1",
-    lane_state: pack.lane_state,
-    standard_count: pack.standards.length,
-    artifact_family_count: pack.artifact_families.length,
-    linked_surfaces: pack.supported_surfaces
-  };
-}
-
-module.exports = {
-  buildArtifactDistributionLanePack,
-  summarizeArtifactDistributionLanePack
-};
+"use strict";
+
+function buildArtifactDistributionLanePack() {
+  return {
+    product: "xoonya",
+    category: "proof-artifact-distribution-lane-pack",
+    pack_version: "xoonya-artifact-distribution-lane-pack-v1",
+    lane_state: "first_party_artifact_distribution_lane_present",
+    posture: "oci_style_distribution_for_proof_bundles_and_integration_artifacts",
+    standards: ["oci_artifacts", "oras_style_distribution"],
+    artifact_families: ["proof_bundles", "handoff_bundles", "integration_snapshots", "release_artifacts"],
+    supported_surfaces: {
+      integrations_ref: "/v1/integrations",
+      integrations_snapshot_ref: "/v1/integrations/snapshot",
+      proof_bridge_ref: "/v1/proof-bridge",
+      result_package_trust_ref: "/v1/result-package-trust",
+      release_center_ref: "/v1/release-center"
+    },
+    first_run_flows: [
+      {
+        flow_ref: "proof_artifact_distribution_alignment",
+        recommended_reason: "best path for teams that want portable proof and integration artifacts rather than custom export conventions",
+        sequence: [
+          "inspect_artifact_distribution_lane_summary",
+          "inspect proof_bridge and import surfaces",
+          "treat proof bundles and integration snapshots as distribution-ready artifacts",
+          "publish or transfer them later through standard artifact registries without changing proof semantics"
+        ]
+      }
+    ],
+    guardrails: [
+      "artifact portability should preserve canonical proof bundle and handoff shapes",
+      "distribution posture must not create a second proof model"
+    ]
+  };
+}
+
+function summarizeArtifactDistributionLanePack() {
+  const pack = buildArtifactDistributionLanePack();
+  return {
+    product: "xoonya",
+    category: "proof-artifact-distribution-lane-pack-summary",
+    summary_version: "xoonya-artifact-distribution-lane-pack-summary-v1",
+    lane_state: pack.lane_state,
+    standard_count: pack.standards.length,
+    artifact_family_count: pack.artifact_families.length,
+    linked_surfaces: pack.supported_surfaces
+  };
+}
+
+module.exports = {
+  buildArtifactDistributionLanePack,
+  summarizeArtifactDistributionLanePack
+};

package/lib/asyncapi_contract.js

@@ -1,135 +1,135 @@
-"use strict";
-
-const pkg = require("../package.json");
-
-function buildAsyncApiDocument() {
-  return {
-    asyncapi: "3.0.0",
-    info: {
-      title: "xoonya Event Contract",
-      version: pkg.version,
-      summary: "Proof and review event contract.",
-      description: "This AsyncAPI document describes the stable proof-side canonicalization, receipt, proof-bundle, and bridge event surfaces."
-    },
-    servers: {
-      httpProof: {
-        host: "127.0.0.1:4340",
-        protocol: "http",
-        description: "Local xoonya HTTP proof event entrypoint"
-      }
-    },
-    channels: {
-      "proof/events/canonicalize": {
-        address: "/v1/events/canonicalize",
-        messages: {
-          canonicalizeEventRequest: {
-            name: "canonicalizeEventRequest",
-            title: "Canonicalize event request",
-            summary: "Canonicalize inbound event data before proof construction."
-          }
-        }
-      },
-      "proof/events/hash": {
-        address: "/v1/events/hash",
-        messages: {
-          hashEventRequest: {
-            name: "hashEventRequest",
-            title: "Hash event request",
-            summary: "Hash canonical event data."
-          }
-        }
-      },
-      "proof/receipts/emit": {
-        address: "/v1/receipts/emit",
-        messages: {
-          emitReceiptRequest: {
-            name: "emitReceiptRequest",
-            title: "Emit receipt request",
-            summary: "Emit proof receipt data."
-          }
-        }
-      },
-      "proof/bundles/build": {
-        address: "/v1/proof-bundles/build",
-        messages: {
-          buildProofBundleRequest: {
-            name: "buildProofBundleRequest",
-            title: "Build proof bundle request",
-            summary: "Build a proof bundle from canonical proof inputs."
-          }
-        }
-      },
-      "proof/bridge/economic-handoff": {
-        address: "/v1/proof-center/bridge/economic-handoff",
-        messages: {
-          economicHandoffRequest: {
-            name: "economicHandoffRequest",
-            title: "Economic handoff bridge request",
-            summary: "Bridge bounded economic consequence data into proof review."
-          }
-        }
-      }
-    },
-    operations: {
-      canonicalizeProofEvent: {
-        action: "send",
-        channel: { $ref: "#/channels/proof/events/canonicalize" },
-        summary: "Send canonicalization input into the proof loop."
-      },
-      hashProofEvent: {
-        action: "send",
-        channel: { $ref: "#/channels/proof/events/hash" },
-        summary: "Send event data for proof hash generation."
-      },
-      emitProofReceipt: {
-        action: "send",
-        channel: { $ref: "#/channels/proof/receipts/emit" },
-        summary: "Send receipt emission input into the proof loop."
-      },
-      buildProofBundle: {
-        action: "send",
-        channel: { $ref: "#/channels/proof/bundles/build" },
-        summary: "Send proof-bundle build input into the proof loop."
-      },
-      bridgeEconomicHandoff: {
-        action: "send",
-        channel: { $ref: "#/channels/proof/bridge/economic-handoff" },
-        summary: "Send runtime economic handoff data into proof review."
-      }
-    },
-    "x-naxytra-contract": {
-      product: "xoonya",
-      stability: "stable_public_event_layer",
-      channel_count: 5,
-      linked_docs: [
-        "SERVICE_CONTRACT.md",
-        "FINAL_CONTRACT.md",
-        "START_HERE.md"
-      ]
-    }
-  };
-}
-
-function summarizeAsyncApiDocument() {
-  const document = buildAsyncApiDocument();
-  return {
-    product: "xoonya",
-    category: "proof-asyncapi-contract-summary",
-    summary_version: "xoonya-asyncapi-contract-summary-v1",
-    asyncapi_version: document.asyncapi,
-    info_version: document.info.version,
-    channel_count: Object.keys(document.channels).length,
-    operation_count: Object.keys(document.operations).length,
-    primary_event_lanes: ["canonicalization", "receipts", "proof_bundles", "bridge"],
-    linked_surfaces: {
-      asyncapi_ref: "/asyncapi.json",
-      service_contract_ref: "SERVICE_CONTRACT.md",
-      openapi_ref: "/openapi.json"
-    }
-  };
-}
-
-module.exports = {
-  buildAsyncApiDocument,
-  summarizeAsyncApiDocument
-};
+"use strict";
+
+const pkg = require("../package.json");
+
+function buildAsyncApiDocument() {
+  return {
+    asyncapi: "3.0.0",
+    info: {
+      title: "xoonya Event Contract",
+      version: pkg.version,
+      summary: "Proof and review event contract.",
+      description: "This AsyncAPI document describes the stable proof-side canonicalization, receipt, proof-bundle, and bridge event surfaces."
+    },
+    servers: {
+      httpProof: {
+        host: "127.0.0.1:4340",
+        protocol: "http",
+        description: "Local xoonya HTTP proof event entrypoint"
+      }
+    },
+    channels: {
+      "proof/events/canonicalize": {
+        address: "/v1/events/canonicalize",
+        messages: {
+          canonicalizeEventRequest: {
+            name: "canonicalizeEventRequest",
+            title: "Canonicalize event request",
+            summary: "Canonicalize inbound event data before proof construction."
+          }
+        }
+      },
+      "proof/events/hash": {
+        address: "/v1/events/hash",
+        messages: {
+          hashEventRequest: {
+            name: "hashEventRequest",
+            title: "Hash event request",
+            summary: "Hash canonical event data."
+          }
+        }
+      },
+      "proof/receipts/emit": {
+        address: "/v1/receipts/emit",
+        messages: {
+          emitReceiptRequest: {
+            name: "emitReceiptRequest",
+            title: "Emit receipt request",
+            summary: "Emit proof receipt data."
+          }
+        }
+      },
+      "proof/bundles/build": {
+        address: "/v1/proof-bundles/build",
+        messages: {
+          buildProofBundleRequest: {
+            name: "buildProofBundleRequest",
+            title: "Build proof bundle request",
+            summary: "Build a proof bundle from canonical proof inputs."
+          }
+        }
+      },
+      "proof/bridge/economic-handoff": {
+        address: "/v1/proof-center/bridge/economic-handoff",
+        messages: {
+          economicHandoffRequest: {
+            name: "economicHandoffRequest",
+            title: "Economic handoff bridge request",
+            summary: "Bridge bounded economic consequence data into proof review."
+          }
+        }
+      }
+    },
+    operations: {
+      canonicalizeProofEvent: {
+        action: "send",
+        channel: { $ref: "#/channels/proof/events/canonicalize" },
+        summary: "Send canonicalization input into the proof loop."
+      },
+      hashProofEvent: {
+        action: "send",
+        channel: { $ref: "#/channels/proof/events/hash" },
+        summary: "Send event data for proof hash generation."
+      },
+      emitProofReceipt: {
+        action: "send",
+        channel: { $ref: "#/channels/proof/receipts/emit" },
+        summary: "Send receipt emission input into the proof loop."
+      },
+      buildProofBundle: {
+        action: "send",
+        channel: { $ref: "#/channels/proof/bundles/build" },
+        summary: "Send proof-bundle build input into the proof loop."
+      },
+      bridgeEconomicHandoff: {
+        action: "send",
+        channel: { $ref: "#/channels/proof/bridge/economic-handoff" },
+        summary: "Send runtime economic handoff data into proof review."
+      }
+    },
+    "x-naxytra-contract": {
+      product: "xoonya",
+      stability: "stable_public_event_layer",
+      channel_count: 5,
+      linked_docs: [
+        "SERVICE_CONTRACT.md",
+        "FINAL_CONTRACT.md",
+        "START_HERE.md"
+      ]
+    }
+  };
+}
+
+function summarizeAsyncApiDocument() {
+  const document = buildAsyncApiDocument();
+  return {
+    product: "xoonya",
+    category: "proof-asyncapi-contract-summary",
+    summary_version: "xoonya-asyncapi-contract-summary-v1",
+    asyncapi_version: document.asyncapi,
+    info_version: document.info.version,
+    channel_count: Object.keys(document.channels).length,
+    operation_count: Object.keys(document.operations).length,
+    primary_event_lanes: ["canonicalization", "receipts", "proof_bundles", "bridge"],
+    linked_surfaces: {
+      asyncapi_ref: "/asyncapi.json",
+      service_contract_ref: "SERVICE_CONTRACT.md",
+      openapi_ref: "/openapi.json"
+    }
+  };
+}
+
+module.exports = {
+  buildAsyncApiDocument,
+  summarizeAsyncApiDocument
+};