xoonya 2.6.0 → 2.7.0

package/RELEASE_NOTES.md

@@ -1,3 +1,14 @@
+# xoonya 2.7.0 Release Notes
+
+`xoonya` 2.7.0 is the expansion-closeout release line for package-hardening, clean-consumer release smoke testing, and disciplined native-standard claim boundaries.
+
+Highlights:
+
+- ships `scripts/` in the npm artifact so `xoonya conformance` and `xoonya first-run --verify-native` work from a clean npm install
+- adds release-candidate guards that fail if conformance verifier scripts are missing from `npm pack`
+- participates in the Naxytra release-smoke harness that installs packed tarballs into a clean consumer project before synchronized release
+- keeps the 2.6.0 XNYA native, payload, line-rate frame, import-adapter, and standardization capabilities intact while closing the packaging reliability gap
+
 # xoonya 2.6.0 Release Notes
 
 `xoonya` 2.6.0 is the expansion release line for Xoonya Native standard hardening, external proof import, native signed and anchored verification, and strict XNYA payload/frame profile work.

package/lib/release_history.js

@@ -10,6 +10,19 @@ function buildReleaseHistory() {
     current_version: packageJson.version,
     release_track: "public_release",
     history: [
+      {
+        version: "2.7.0",
+        channel: "public_release",
+        maturity_posture: "expansion_closeout",
+        headline: "expansion-closeout release with packaged conformance verifiers, clean-consumer release smoke testing, and disciplined native-standard claim boundaries",
+        milestone_refs: [
+          "npm_packaged_first_run_native_verification",
+          "npm_packaged_conformance_cli",
+          "release_candidate_packaging_guard",
+          "clean_consumer_release_smoke",
+          "expansion_closeout_claim_boundaries"
+        ]
+      },
       {
         version: "2.6.0",
         channel: "public_release",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xoonya",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Deterministic proof and review engine for receipts, handoffs, governance, and verification.",
   "main": "index.js",
   "bin": {
@@ -23,6 +23,7 @@
     "proof_sdk.js",
     "server.js",
     "bin/",
+    "scripts/",
     "lib/",
     "integrations/",
     "vectors/",

package/scripts/registry_cli.js

@@ -0,0 +1,157 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const {
+  exportIntegrationRegistrySnapshot,
+  summarizeIntegrationPromotionWorkflow,
+  summarizeIntegrationPromotionWorkflowList,
+  summarizeIntegrationPromotionReadiness,
+  validateIntegrationRegistration
+} = require("../integrations/registry");
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function writeJson(payload) {
+  process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}
+
+function resolveExampleRegistration(name) {
+  const filename = name === "verifier"
+    ? "example-third-party-verifier-registration.record.json"
+    : "example-third-party-verifier-registration.record.json";
+  return path.resolve(__dirname, "..", "integrations", "examples", filename);
+}
+
+function resolveExampleDescriptor(name) {
+  const descriptorByExample = {
+    verifier: {
+      integration_id: "partner.verifier.lattice_notary",
+      integration_class: "verification_helper_adapter",
+      proof_scope: "profile_verification"
+    }
+  };
+  return descriptorByExample[name] || descriptorByExample.verifier;
+}
+
+function parseArgs(argv) {
+  const [command, ...rest] = argv;
+  const options = {};
+  for (let index = 0; index < rest.length; index += 1) {
+    const token = rest[index];
+    if (!token.startsWith("--")) continue;
+    const key = token.slice(2);
+    const next = rest[index + 1];
+    if (!next || next.startsWith("--")) {
+      options[key] = true;
+      continue;
+    }
+    options[key] = next;
+    index += 1;
+  }
+  return {
+    command: command || "",
+    options
+  };
+}
+
+function runValidateRegistration(options) {
+  const exampleName = options.example === "verifier" ? "verifier" : "verifier";
+  const filePath = options.file
+    ? path.resolve(process.cwd(), options.file)
+    : resolveExampleRegistration(exampleName);
+  const registrationRecord = readJson(filePath);
+  const descriptor = resolveExampleDescriptor(exampleName);
+  const validation = validateIntegrationRegistration(descriptor, registrationRecord);
+  writeJson({
+    ok: validation.ok,
+    file: filePath,
+    descriptor,
+    errors: validation.errors
+  });
+  process.exitCode = validation.ok ? 0 : 1;
+}
+
+function runExportSnapshot(options) {
+  const filters = {
+    source: options.source || undefined,
+    certification_state: options.certification_state || undefined,
+    integration_maturity: options.integration_maturity || undefined,
+    registration_state: options.registration_state || undefined,
+    proof_scope: options.proof_scope || undefined,
+    bundled: options.bundled || undefined
+  };
+  const snapshot = exportIntegrationRegistrySnapshot(filters);
+  writeJson({
+    generated_by: "registry_cli",
+    filters: snapshot.filters,
+    snapshot
+  });
+}
+
+function runPromotionReadiness(options) {
+  const integrationId = options.integration || "partner.verifier.lattice_notary";
+  writeJson({
+    integration_id: integrationId,
+    review: summarizeIntegrationPromotionReadiness(integrationId)
+  });
+}
+
+function runPromotionWorkflow(options) {
+  const integrationId = options.integration || "partner.verifier.lattice_notary";
+  writeJson({
+    integration_id: integrationId,
+    review: summarizeIntegrationPromotionWorkflow(integrationId)
+  });
+}
+
+function runPromotionWorkflowSummary(options) {
+  writeJson({
+    review: summarizeIntegrationPromotionWorkflowList({
+      source: options.source || undefined,
+      registration_state: options.registration_state || undefined,
+      proof_scope: options.proof_scope || undefined,
+      bundled: options.bundled || undefined
+    })
+  });
+}
+
+function main() {
+  const { command, options } = parseArgs(process.argv.slice(2));
+  if (command === "validate-registration") {
+    runValidateRegistration(options);
+    return;
+  }
+  if (command === "export-snapshot") {
+    runExportSnapshot(options);
+    return;
+  }
+  if (command === "promotion-readiness") {
+    runPromotionReadiness(options);
+    return;
+  }
+  if (command === "promotion-workflow") {
+    runPromotionWorkflow(options);
+    return;
+  }
+  if (command === "promotion-workflow-summary") {
+    runPromotionWorkflowSummary(options);
+    return;
+  }
+
+  writeJson({
+    ok: false,
+    usage: [
+      "node scripts/registry_cli.js validate-registration [--file <path>] [--example verifier]",
+      "node scripts/registry_cli.js export-snapshot [--source <value>] [--registration_state <value>] [--proof_scope <value>]",
+      "node scripts/registry_cli.js promotion-readiness [--integration <integration_id>]",
+      "node scripts/registry_cli.js promotion-workflow [--integration <integration_id>]",
+      "node scripts/registry_cli.js promotion-workflow-summary [--source <value>] [--registration_state <value>] [--proof_scope <value>] [--bundled true|false]"
+    ]
+  });
+  process.exitCode = 1;
+}
+
+main();