xoonya 3.1.0 → 3.1.2

package/lib/openapi_contract.js

@@ -1,227 +1,227 @@
-"use strict";
-
-const pkg = require("../package.json");
-
-function buildOpenApiDocument() {
-  return {
-    openapi: "3.1.0",
-    info: {
-      title: "xoonya Public HTTP Contract",
-      version: pkg.version,
-      summary: "Proof and review contract for the stable public HTTP layer.",
-      description: "This OpenAPI document exposes the stable builder-facing proof, review, and compatibility surfaces that outside builders should rely on first.",
-      contact: {
-        name: "naxytra"
-      }
-    },
-    jsonSchemaDialect: "https://spec.openapis.org/oas/3.1/dialect/base",
-    servers: [
-      {
-        url: "http://127.0.0.1:4340",
-        description: "Local xoonya service"
-      }
-    ],
-    tags: [
-      { name: "health", description: "Service health and readiness." },
-      { name: "proof-center", description: "Core proof and review surfaces." },
-      { name: "events", description: "Canonicalization, hashing, and receipt emission." },
-      { name: "proof-bundles", description: "Proof bundle build and verify surfaces." },
-      { name: "compatibility", description: "Compatibility verification surfaces." },
-      { name: "intelligence", description: "Proof-side intelligence and role surfaces." }
-    ],
-    paths: {
-      "/health": {
-        get: {
-          tags: ["health"],
-          summary: "Health check",
-          operationId: "getHealth",
-          responses: {
-            "200": { description: "Service health response" }
-          }
-        }
-      },
-      "/v1/proof-center": {
-        get: {
-          tags: ["proof-center"],
-          summary: "Get proof center bundle",
-          operationId: "getProofCenter",
-          responses: {
-            "200": { description: "Proof center bundle" }
-          }
-        }
-      },
-      "/v1/proof-center/summary": {
-        get: {
-          tags: ["proof-center"],
-          summary: "Get proof center summary",
-          operationId: "getProofCenterSummary",
-          responses: {
-            "200": { description: "Proof center summary" }
-          }
-        }
-      },
-      "/v1/events/canonicalize": {
-        post: {
-          tags: ["events"],
-          summary: "Canonicalize event payload",
-          operationId: "canonicalizeEvent",
-          responses: {
-            "200": { description: "Canonical event response" },
-            "400": { description: "Invalid event payload" }
-          }
-        }
-      },
-      "/v1/events/hash": {
-        post: {
-          tags: ["events"],
-          summary: "Hash canonical event payload",
-          operationId: "hashEvent",
-          responses: {
-            "200": { description: "Event hash response" },
-            "400": { description: "Invalid event payload" }
-          }
-        }
-      },
-      "/v1/receipts/emit": {
-        post: {
-          tags: ["events"],
-          summary: "Emit proof receipt",
-          operationId: "emitReceipt",
-          responses: {
-            "200": { description: "Receipt emission response" },
-            "400": { description: "Invalid receipt emission request" }
-          }
-        }
-      },
-      "/v1/proof-bundles/build": {
-        post: {
-          tags: ["proof-bundles"],
-          summary: "Build proof bundle",
-          operationId: "buildProofBundle",
-          responses: {
-            "200": { description: "Proof bundle created" },
-            "400": { description: "Invalid proof bundle request" }
-          }
-        }
-      },
-      "/v1/proof-bundles/verify": {
-        post: {
-          tags: ["proof-bundles"],
-          summary: "Verify proof bundle",
-          operationId: "verifyProofBundle",
-          responses: {
-            "200": { description: "Proof bundle verification result" },
-            "400": { description: "Invalid proof verification request" }
-          }
-        }
-      },
-      "/v1/receipts/verify": {
-        post: {
-          tags: ["compatibility"],
-          summary: "Verify receipt",
-          operationId: "verifyReceipt",
-          responses: {
-            "200": { description: "Receipt verification result" },
-            "400": { description: "Invalid receipt verification request" }
-          }
-        }
-      },
-      "/v1/proof-center/bridge/economic-handoff": {
-        post: {
-          tags: ["proof-center"],
-          summary: "Bridge economic handoff into proof review",
-          operationId: "bridgeEconomicHandoff",
-          responses: {
-            "200": { description: "Economic handoff bridge result" },
-            "400": { description: "Invalid handoff payload" }
-          }
-        }
-      },
-      "/v1/trust-intelligence/summary": {
-        get: {
-          tags: ["intelligence"],
-          summary: "Get trust intelligence summary",
-          operationId: "getTrustIntelligenceSummary",
-          responses: {
-            "200": { description: "Trust intelligence summary" }
-          }
-        }
-      },
-      "/v1/governance-intelligence/summary": {
-        get: {
-          tags: ["intelligence"],
-          summary: "Get governance intelligence summary",
-          operationId: "getGovernanceIntelligenceSummary",
-          responses: {
-            "200": { description: "Governance intelligence summary" }
-          }
-        }
-      },
-      "/v1/role-freeze/package": {
-        get: {
-          tags: ["intelligence"],
-          summary: "Get canonical role-freeze package",
-          operationId: "getRoleFreezePackage",
-          responses: {
-            "200": { description: "Role-freeze package" }
-          }
-        }
-      },
-      "/v1/role-transition": {
-        get: {
-          tags: ["intelligence"],
-          summary: "Get role transition direction package",
-          operationId: "getRoleTransition",
-          responses: {
-            "200": { description: "Role transition package" }
-          }
-        }
-      },
-      "/v1/capability-registry-home": {
-        get: {
-          tags: ["intelligence"],
-          summary: "Get capability registry home direction package",
-          operationId: "getCapabilityRegistryHome",
-          responses: {
-            "200": { description: "Capability registry home package" }
-          }
-        }
-      }
-    },
-    "x-naxytra-contract": {
-      product: "xoonya",
-      stability: "stable_public_http_layer",
-      route_count: 14,
-      target_audience: ["builders", "partners", "reviewers"],
-      linked_docs: [
-        "SERVICE_CONTRACT.md",
-        "FINAL_CONTRACT.md",
-        "START_HERE.md"
-      ]
-    }
-  };
-}
-
-function summarizeOpenApiDocument() {
-  const document = buildOpenApiDocument();
-  return {
-    product: "xoonya",
-    category: "proof-openapi-contract-summary",
-    summary_version: "xoonya-openapi-contract-summary-v1",
-    openapi_version: document.openapi,
-    info_version: document.info.version,
-    path_count: Object.keys(document.paths).length,
-    server_count: document.servers.length,
-    primary_protocol_lanes: ["http", "proof", "bridge"],
-    linked_surfaces: {
-      openapi_ref: "/openapi.json",
-      service_contract_ref: "SERVICE_CONTRACT.md",
-      final_contract_ref: "FINAL_CONTRACT.md"
-    }
-  };
-}
-
-module.exports = {
-  buildOpenApiDocument,
-  summarizeOpenApiDocument
-};
+"use strict";
+
+const pkg = require("../package.json");
+
+function buildOpenApiDocument() {
+  return {
+    openapi: "3.1.0",
+    info: {
+      title: "xoonya Public HTTP Contract",
+      version: pkg.version,
+      summary: "Proof and review contract for the stable public HTTP layer.",
+      description: "This OpenAPI document exposes the stable builder-facing proof, review, and compatibility surfaces that outside builders should rely on first.",
+      contact: {
+        name: "naxytra"
+      }
+    },
+    jsonSchemaDialect: "https://spec.openapis.org/oas/3.1/dialect/base",
+    servers: [
+      {
+        url: "http://127.0.0.1:4340",
+        description: "Local xoonya service"
+      }
+    ],
+    tags: [
+      { name: "health", description: "Service health and readiness." },
+      { name: "proof-center", description: "Core proof and review surfaces." },
+      { name: "events", description: "Canonicalization, hashing, and receipt emission." },
+      { name: "proof-bundles", description: "Proof bundle build and verify surfaces." },
+      { name: "compatibility", description: "Compatibility verification surfaces." },
+      { name: "intelligence", description: "Proof-side intelligence and role surfaces." }
+    ],
+    paths: {
+      "/health": {
+        get: {
+          tags: ["health"],
+          summary: "Health check",
+          operationId: "getHealth",
+          responses: {
+            "200": { description: "Service health response" }
+          }
+        }
+      },
+      "/v1/proof-center": {
+        get: {
+          tags: ["proof-center"],
+          summary: "Get proof center bundle",
+          operationId: "getProofCenter",
+          responses: {
+            "200": { description: "Proof center bundle" }
+          }
+        }
+      },
+      "/v1/proof-center/summary": {
+        get: {
+          tags: ["proof-center"],
+          summary: "Get proof center summary",
+          operationId: "getProofCenterSummary",
+          responses: {
+            "200": { description: "Proof center summary" }
+          }
+        }
+      },
+      "/v1/events/canonicalize": {
+        post: {
+          tags: ["events"],
+          summary: "Canonicalize event payload",
+          operationId: "canonicalizeEvent",
+          responses: {
+            "200": { description: "Canonical event response" },
+            "400": { description: "Invalid event payload" }
+          }
+        }
+      },
+      "/v1/events/hash": {
+        post: {
+          tags: ["events"],
+          summary: "Hash canonical event payload",
+          operationId: "hashEvent",
+          responses: {
+            "200": { description: "Event hash response" },
+            "400": { description: "Invalid event payload" }
+          }
+        }
+      },
+      "/v1/receipts/emit": {
+        post: {
+          tags: ["events"],
+          summary: "Emit proof receipt",
+          operationId: "emitReceipt",
+          responses: {
+            "200": { description: "Receipt emission response" },
+            "400": { description: "Invalid receipt emission request" }
+          }
+        }
+      },
+      "/v1/proof-bundles/build": {
+        post: {
+          tags: ["proof-bundles"],
+          summary: "Build proof bundle",
+          operationId: "buildProofBundle",
+          responses: {
+            "200": { description: "Proof bundle created" },
+            "400": { description: "Invalid proof bundle request" }
+          }
+        }
+      },
+      "/v1/proof-bundles/verify": {
+        post: {
+          tags: ["proof-bundles"],
+          summary: "Verify proof bundle",
+          operationId: "verifyProofBundle",
+          responses: {
+            "200": { description: "Proof bundle verification result" },
+            "400": { description: "Invalid proof verification request" }
+          }
+        }
+      },
+      "/v1/receipts/verify": {
+        post: {
+          tags: ["compatibility"],
+          summary: "Verify receipt",
+          operationId: "verifyReceipt",
+          responses: {
+            "200": { description: "Receipt verification result" },
+            "400": { description: "Invalid receipt verification request" }
+          }
+        }
+      },
+      "/v1/proof-center/bridge/economic-handoff": {
+        post: {
+          tags: ["proof-center"],
+          summary: "Bridge economic handoff into proof review",
+          operationId: "bridgeEconomicHandoff",
+          responses: {
+            "200": { description: "Economic handoff bridge result" },
+            "400": { description: "Invalid handoff payload" }
+          }
+        }
+      },
+      "/v1/trust-intelligence/summary": {
+        get: {
+          tags: ["intelligence"],
+          summary: "Get trust intelligence summary",
+          operationId: "getTrustIntelligenceSummary",
+          responses: {
+            "200": { description: "Trust intelligence summary" }
+          }
+        }
+      },
+      "/v1/governance-intelligence/summary": {
+        get: {
+          tags: ["intelligence"],
+          summary: "Get governance intelligence summary",
+          operationId: "getGovernanceIntelligenceSummary",
+          responses: {
+            "200": { description: "Governance intelligence summary" }
+          }
+        }
+      },
+      "/v1/role-freeze/package": {
+        get: {
+          tags: ["intelligence"],
+          summary: "Get canonical role-freeze package",
+          operationId: "getRoleFreezePackage",
+          responses: {
+            "200": { description: "Role-freeze package" }
+          }
+        }
+      },
+      "/v1/role-transition": {
+        get: {
+          tags: ["intelligence"],
+          summary: "Get role transition direction package",
+          operationId: "getRoleTransition",
+          responses: {
+            "200": { description: "Role transition package" }
+          }
+        }
+      },
+      "/v1/capability-registry-home": {
+        get: {
+          tags: ["intelligence"],
+          summary: "Get capability registry home direction package",
+          operationId: "getCapabilityRegistryHome",
+          responses: {
+            "200": { description: "Capability registry home package" }
+          }
+        }
+      }
+    },
+    "x-naxytra-contract": {
+      product: "xoonya",
+      stability: "stable_public_http_layer",
+      route_count: 14,
+      target_audience: ["builders", "partners", "reviewers"],
+      linked_docs: [
+        "SERVICE_CONTRACT.md",
+        "FINAL_CONTRACT.md",
+        "START_HERE.md"
+      ]
+    }
+  };
+}
+
+function summarizeOpenApiDocument() {
+  const document = buildOpenApiDocument();
+  return {
+    product: "xoonya",
+    category: "proof-openapi-contract-summary",
+    summary_version: "xoonya-openapi-contract-summary-v1",
+    openapi_version: document.openapi,
+    info_version: document.info.version,
+    path_count: Object.keys(document.paths).length,
+    server_count: document.servers.length,
+    primary_protocol_lanes: ["http", "proof", "bridge"],
+    linked_surfaces: {
+      openapi_ref: "/openapi.json",
+      service_contract_ref: "SERVICE_CONTRACT.md",
+      final_contract_ref: "FINAL_CONTRACT.md"
+    }
+  };
+}
+
+module.exports = {
+  buildOpenApiDocument,
+  summarizeOpenApiDocument
+};