xoonya 3.0.1 → 3.1.0

package/bin/xoonya-first-run.js

@@ -1,184 +1,184 @@
-#!/usr/bin/env node
-"use strict";
-
-const path = require("path");
-const { spawnSync } = require("child_process");
-
-const DEFAULT_KIT_URL = "https://www.naxytra.com/v1/first-run-kit";
-
-function parseArgs(argv) {
-  const args = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (!token.startsWith("--")) continue;
-    const key = token.slice(2);
-    const next = argv[index + 1];
-    if (!next || next.startsWith("--")) {
-      args[key] = true;
-      continue;
-    }
-    args[key] = next;
-    index += 1;
-  }
-  return args;
-}
-
-function buildLocalGuide() {
-  return {
-    ok: true,
-    product: "xoonya",
-    category: "xoonya-first-run-proof-guide",
-    guide_version: "xoonya-first-run-proof-guide-v1",
-    public_command_kit_url: DEFAULT_KIT_URL,
-    role: "proof_followthrough_after_xytara_runtime_execution",
-    safe_local_verification_command: "xoonya first-run --verify-native --pretty",
-    proof_modes: [
-      {
-        method: "xoonya-native-sha256-v1",
-        verification: "replayable_digest"
-      },
-      {
-        method: "xoonya-native-signed-v1",
-        verification: "ed25519_signature"
-      },
-      {
-        method: "xoonya-native-anchored-v1",
-        verification: "anchor_binding"
-      },
-      {
-        method: "external_interop_methods",
-        verification: "structure_checked_external_verifier_boundary"
-      }
-    ],
-    public_checks: [
-      "https://xoonya.onrender.com/v1/proof-center/native-standard/summary",
-      "https://xoonya.onrender.com/v1/proof-center/native-atom-conformance/summary",
-      "https://xoonya.onrender.com/v1/proof-center/native-anchor-profile/summary"
-    ],
-    boundaries: [
-      "xoonya_verifies_proof_bundles_and_native_method_binding",
-      "xoonya_anchor_binding_does_not_claim_external_provider_or_chain_truth",
-      "xytara_owns_runtime_payment_and_execution_state"
-    ]
-  };
-}
-
-async function fetchPublicKit(url) {
-  const response = await fetch(url, { headers: { accept: "application/json" } });
-  if (!response.ok) {
-    throw new Error(`first_run_kit_fetch_failed_${response.status}`);
-  }
-  return response.json();
-}
-
-function writeJson(payload, pretty) {
-  process.stdout.write(`${JSON.stringify(payload, null, pretty ? 2 : 0)}\n`);
-}
-
-function printUsage() {
-  process.stdout.write([
-    "Usage: xoonya first-run [options]",
-    "",
-    "Options:",
-    "  --json             Print the guided proof followthrough object",
-    "  --offline          Do not fetch the public command kit",
-    "  --verify-native    Run local native/conformance verification",
-    "  --pretty           Pretty-print JSON output",
-    "  --help             Show this help message"
-  ].join("\n"));
-}
-
-function runNativeVerification(args) {
-  const scriptPath = path.join(__dirname, "..", "scripts", "verify_vectors.js");
-  const result = spawnSync(process.execPath, [
-    scriptPath,
-    "--json"
-  ], {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "inherit"]
-  });
-  if (result.status !== 0) {
-    process.exitCode = typeof result.status === "number" ? result.status : 1;
-    return;
-  }
-  const summary = JSON.parse(result.stdout);
-  writeJson({
-    ok: true,
-    product: "xoonya",
-    category: "xoonya-first-run-native-verification",
-    verification_version: "xoonya-first-run-native-verification-v1",
-    proof_bundle_conformance_passed: summary.ok === true,
-    conformance_count: summary.conformance_count,
-    adversarial_count: summary.adversarial_count,
-    native_atom_vector_count: summary.native_atom_vector_count,
-    native_atom_adversarial_count: summary.native_atom_adversarial_count,
-    verification_methods: summary.verification_methods,
-    native_atom_error_codes: summary.native_atom_error_codes,
-    required_native_methods_present: [
-      "xoonya-native-sha256-v1",
-      "xoonya-native-signed-v1",
-      "xoonya-native-anchored-v1"
-    ].every((method) => summary.verification_methods.includes(method)),
-    boundary: "local_conformance_verifies_xoonya_binding_and_vectors_not_external_chain_truth"
-  }, args.pretty);
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.help) {
-    printUsage();
-    return;
-  }
-  if (args["verify-native"]) {
-    runNativeVerification(args);
-    return;
-  }
-
-  const localGuide = buildLocalGuide();
-  if (args.json) {
-    if (args.offline) {
-      writeJson(localGuide, args.pretty);
-      return;
-    }
-    try {
-      const publicKit = await fetchPublicKit(DEFAULT_KIT_URL);
-      writeJson({
-        ...localGuide,
-        public_command_kit: publicKit
-      }, args.pretty);
-    } catch (error) {
-      writeJson({
-        ...localGuide,
-        public_command_kit_fetch_error: error.message
-      }, args.pretty);
-    }
-    return;
-  }
-
-  process.stdout.write([
-    "xoonya first-run",
-    "",
-    "Proof followthrough after xytara execution:",
-    "  xoonya first-run --verify-native --pretty",
-    "",
-    "Inspect the public command kit:",
-    `  ${DEFAULT_KIT_URL}`,
-    "",
-    "Native proof modes checked locally:",
-    "  xoonya-native-sha256-v1",
-    "  xoonya-native-signed-v1",
-    "  xoonya-native-anchored-v1",
-    "",
-    "Public proof surfaces:",
-    "  https://xoonya.onrender.com/v1/proof-center/native-standard/summary",
-    "  https://xoonya.onrender.com/v1/proof-center/native-anchor-profile/summary",
-    "",
-    "Boundary:",
-    "  xoonya verifies proof and anchor binding; external chain/provider truth stays external."
-  ].join("\n"));
-}
-
-main().catch((error) => {
-  process.stderr.write(`${error.message}\n`);
-  process.exitCode = 1;
-});
+#!/usr/bin/env node
+"use strict";
+
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const DEFAULT_KIT_URL = "https://www.naxytra.com/v1/first-run-kit";
+
+function parseArgs(argv) {
+  const args = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith("--")) continue;
+    const key = token.slice(2);
+    const next = argv[index + 1];
+    if (!next || next.startsWith("--")) {
+      args[key] = true;
+      continue;
+    }
+    args[key] = next;
+    index += 1;
+  }
+  return args;
+}
+
+function buildLocalGuide() {
+  return {
+    ok: true,
+    product: "xoonya",
+    category: "xoonya-first-run-proof-guide",
+    guide_version: "xoonya-first-run-proof-guide-v1",
+    public_command_kit_url: DEFAULT_KIT_URL,
+    role: "proof_followthrough_after_xytara_runtime_execution",
+    safe_local_verification_command: "xoonya first-run --verify-native --pretty",
+    proof_modes: [
+      {
+        method: "xoonya-native-sha256-v1",
+        verification: "replayable_digest"
+      },
+      {
+        method: "xoonya-native-signed-v1",
+        verification: "ed25519_signature"
+      },
+      {
+        method: "xoonya-native-anchored-v1",
+        verification: "anchor_binding"
+      },
+      {
+        method: "external_interop_methods",
+        verification: "structure_checked_external_verifier_boundary"
+      }
+    ],
+    public_checks: [
+      "https://xoonya.onrender.com/v1/proof-center/native-standard/summary",
+      "https://xoonya.onrender.com/v1/proof-center/native-atom-conformance/summary",
+      "https://xoonya.onrender.com/v1/proof-center/native-anchor-profile/summary"
+    ],
+    boundaries: [
+      "xoonya_verifies_proof_bundles_and_native_method_binding",
+      "xoonya_anchor_binding_does_not_claim_external_provider_or_chain_truth",
+      "xytara_owns_runtime_payment_and_execution_state"
+    ]
+  };
+}
+
+async function fetchPublicKit(url) {
+  const response = await fetch(url, { headers: { accept: "application/json" } });
+  if (!response.ok) {
+    throw new Error(`first_run_kit_fetch_failed_${response.status}`);
+  }
+  return response.json();
+}
+
+function writeJson(payload, pretty) {
+  process.stdout.write(`${JSON.stringify(payload, null, pretty ? 2 : 0)}\n`);
+}
+
+function printUsage() {
+  process.stdout.write([
+    "Usage: xoonya first-run [options]",
+    "",
+    "Options:",
+    "  --json             Print the guided proof followthrough object",
+    "  --offline          Do not fetch the public command kit",
+    "  --verify-native    Run local native/conformance verification",
+    "  --pretty           Pretty-print JSON output",
+    "  --help             Show this help message"
+  ].join("\n"));
+}
+
+function runNativeVerification(args) {
+  const scriptPath = path.join(__dirname, "..", "scripts", "verify_vectors.js");
+  const result = spawnSync(process.execPath, [
+    scriptPath,
+    "--json"
+  ], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "inherit"]
+  });
+  if (result.status !== 0) {
+    process.exitCode = typeof result.status === "number" ? result.status : 1;
+    return;
+  }
+  const summary = JSON.parse(result.stdout);
+  writeJson({
+    ok: true,
+    product: "xoonya",
+    category: "xoonya-first-run-native-verification",
+    verification_version: "xoonya-first-run-native-verification-v1",
+    proof_bundle_conformance_passed: summary.ok === true,
+    conformance_count: summary.conformance_count,
+    adversarial_count: summary.adversarial_count,
+    native_atom_vector_count: summary.native_atom_vector_count,
+    native_atom_adversarial_count: summary.native_atom_adversarial_count,
+    verification_methods: summary.verification_methods,
+    native_atom_error_codes: summary.native_atom_error_codes,
+    required_native_methods_present: [
+      "xoonya-native-sha256-v1",
+      "xoonya-native-signed-v1",
+      "xoonya-native-anchored-v1"
+    ].every((method) => summary.verification_methods.includes(method)),
+    boundary: "local_conformance_verifies_xoonya_binding_and_vectors_not_external_chain_truth"
+  }, args.pretty);
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    printUsage();
+    return;
+  }
+  if (args["verify-native"]) {
+    runNativeVerification(args);
+    return;
+  }
+
+  const localGuide = buildLocalGuide();
+  if (args.json) {
+    if (args.offline) {
+      writeJson(localGuide, args.pretty);
+      return;
+    }
+    try {
+      const publicKit = await fetchPublicKit(DEFAULT_KIT_URL);
+      writeJson({
+        ...localGuide,
+        public_command_kit: publicKit
+      }, args.pretty);
+    } catch (error) {
+      writeJson({
+        ...localGuide,
+        public_command_kit_fetch_error: error.message
+      }, args.pretty);
+    }
+    return;
+  }
+
+  process.stdout.write([
+    "xoonya first-run",
+    "",
+    "Proof followthrough after xytara execution:",
+    "  xoonya first-run --verify-native --pretty",
+    "",
+    "Inspect the public command kit:",
+    `  ${DEFAULT_KIT_URL}`,
+    "",
+    "Native proof modes checked locally:",
+    "  xoonya-native-sha256-v1",
+    "  xoonya-native-signed-v1",
+    "  xoonya-native-anchored-v1",
+    "",
+    "Public proof surfaces:",
+    "  https://xoonya.onrender.com/v1/proof-center/native-standard/summary",
+    "  https://xoonya.onrender.com/v1/proof-center/native-anchor-profile/summary",
+    "",
+    "Boundary:",
+    "  xoonya verifies proof and anchor binding; external chain/provider truth stays external."
+  ].join("\n"));
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+});