xytara 2.6.0 → 2.8.0

package/scripts/registry_cli.js

@@ -0,0 +1,275 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const {
+  createIntegrationRegistrySnapshotFromBundles,
+  exportIntegrationSubmissionBundleSet,
+  importIntegrationSubmissionBundle,
+  summarizeIntegrationPromotionActionPreview,
+  summarizeIntegrationPromotionActionSet,
+  summarizeIntegrationPromotionActionSetList,
+  summarizeIntegrationPromotionReadiness,
+  summarizeIntegrationPromotionWorkflow,
+  summarizeIntegrationPromotionWorkflowList,
+  summarizeIntegrationRegistrySnapshotReview,
+  summarizeIntegrationSubmissionBundleReview,
+  summarizeIntegrationSubmissionBundleSetReview,
+  validateIntegrationSubmissionBundle
+} = 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 resolveExampleBundle(name) {
+  const filename = name === "settlement"
+    ? "example-third-party-settlement-registration.submission-bundle.json"
+    : name === "identity"
+      ? "example-third-party-identity-registration.submission-bundle.json"
+    : "example-third-party-registration.submission-bundle.json";
+  return path.resolve(__dirname, "..", "adapters", "examples", filename);
+}
+
+function importExampleBundles() {
+  return [
+    importIntegrationSubmissionBundle(readJson(resolveExampleBundle("protocol")), {
+      source: "third_party_example",
+      protocols: ["mcp"],
+      execution_backends: ["mcp"],
+      adapter_lanes: ["mcp"],
+      task_refs: ["adapter.mcp.invoke"]
+    }),
+    importIntegrationSubmissionBundle(readJson(resolveExampleBundle("identity")), {
+      source: "third_party_example",
+      protocols: [],
+      execution_backends: ["http", "chain"],
+      adapter_lanes: ["http", "chain"],
+      task_refs: ["registry.register", "trust.handoff.emit", "trust.handoff.validate"]
+    }),
+    importIntegrationSubmissionBundle(readJson(resolveExampleBundle("settlement")), {
+      source: "third_party_example",
+      protocols: [],
+      execution_backends: ["chain"],
+      adapter_lanes: ["chain"],
+      task_refs: ["anchoring.submit"]
+    })
+  ];
+}
+
+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 runValidateBundle(options) {
+  const filePath = options.file
+    ? path.resolve(process.cwd(), options.file)
+    : resolveExampleBundle(options.example === "settlement" ? "settlement" : options.example === "identity" ? "identity" : "protocol");
+  const bundle = readJson(filePath);
+  const validation = validateIntegrationSubmissionBundle(bundle);
+  writeJson({
+    ok: validation.ok,
+    file: filePath,
+    errors: validation.errors
+  });
+  process.exitCode = validation.ok ? 0 : 1;
+}
+
+function runExportBundleSet(options) {
+  const payload = exportIntegrationSubmissionBundleSet({
+    source: "third_party_example",
+    bundled: "false"
+  }, options.notes || "generated by registry_cli");
+  writeJson(payload);
+}
+
+function runExportSnapshot(options) {
+  const snapshot = createIntegrationRegistrySnapshotFromBundles(
+    importExampleBundles(),
+    { source: "third_party_example" },
+    { source: "third_party_example" }
+  );
+  writeJson({
+    generated_by: "registry_cli",
+    mode: options.mode || "examples",
+    snapshot
+  });
+}
+
+function runReviewBundle(options) {
+  const filePath = options.file
+    ? path.resolve(process.cwd(), options.file)
+    : resolveExampleBundle(options.example === "settlement" ? "settlement" : options.example === "identity" ? "identity" : "protocol");
+  const bundle = readJson(filePath);
+  writeJson({
+    file: filePath,
+    review: summarizeIntegrationSubmissionBundleReview(bundle)
+  });
+}
+
+function runReviewBundleSet(options) {
+  const payload = exportIntegrationSubmissionBundleSet({
+    source: "third_party_example",
+    bundled: "false"
+  }, options.notes || "generated by registry_cli");
+  writeJson({
+    review: summarizeIntegrationSubmissionBundleSetReview(payload)
+  });
+}
+
+function runReviewSnapshot() {
+  const snapshot = createIntegrationRegistrySnapshotFromBundles(
+    importExampleBundles(),
+    { source: "third_party_example" },
+    { source: "third_party_example" }
+  );
+  writeJson({
+    review: summarizeIntegrationRegistrySnapshotReview(snapshot)
+  });
+}
+
+function runPromotionReadiness(options) {
+  const integrationId = options.integration || "partner.protocol.acme_mcp";
+  writeJson({
+    integration_id: integrationId,
+    review: summarizeIntegrationPromotionReadiness(integrationId)
+  });
+}
+
+function runPromotionWorkflow(options) {
+  const integrationId = options.integration || "partner.protocol.acme_mcp";
+  writeJson({
+    integration_id: integrationId,
+    review: summarizeIntegrationPromotionWorkflow(integrationId)
+  });
+}
+
+function runPromotionWorkflowSummary(options) {
+  writeJson({
+    review: summarizeIntegrationPromotionWorkflowList({
+      source: options.source || "",
+      bundled: options.bundled || ""
+    })
+  });
+}
+
+function runPromotionActionPreview(options) {
+  writeJson({
+    review: summarizeIntegrationPromotionActionPreview({
+      integration_id: options.integration || "partner.protocol.acme_mcp",
+      action: options.action || "complete_certification"
+    })
+  });
+}
+
+function runPromotionActionSet(options) {
+  const integrationId = options.integration || "partner.protocol.acme_mcp";
+  writeJson({
+    integration_id: integrationId,
+    review: summarizeIntegrationPromotionActionSet(integrationId)
+  });
+}
+
+function runPromotionActionSetSummary(options) {
+  writeJson({
+    review: summarizeIntegrationPromotionActionSetList({
+      source: options.source || "",
+      bundled: options.bundled || ""
+    })
+  });
+}
+
+function main() {
+  const { command, options } = parseArgs(process.argv.slice(2));
+  if (command === "validate-bundle") {
+    runValidateBundle(options);
+    return;
+  }
+  if (command === "export-bundle-set") {
+    runExportBundleSet(options);
+    return;
+  }
+  if (command === "export-snapshot") {
+    runExportSnapshot(options);
+    return;
+  }
+  if (command === "review-bundle") {
+    runReviewBundle(options);
+    return;
+  }
+  if (command === "review-bundle-set") {
+    runReviewBundleSet(options);
+    return;
+  }
+  if (command === "review-snapshot") {
+    runReviewSnapshot();
+    return;
+  }
+  if (command === "promotion-readiness") {
+    runPromotionReadiness(options);
+    return;
+  }
+  if (command === "promotion-workflow") {
+    runPromotionWorkflow(options);
+    return;
+  }
+  if (command === "promotion-workflow-summary") {
+    runPromotionWorkflowSummary(options);
+    return;
+  }
+  if (command === "promotion-action-preview") {
+    runPromotionActionPreview(options);
+    return;
+  }
+  if (command === "promotion-action-set") {
+    runPromotionActionSet(options);
+    return;
+  }
+  if (command === "promotion-action-set-summary") {
+    runPromotionActionSetSummary(options);
+    return;
+  }
+
+  writeJson({
+    ok: false,
+    usage: [
+      "node scripts/registry_cli.js validate-bundle [--file <path>] [--example protocol|settlement]",
+      "node scripts/registry_cli.js validate-bundle [--file <path>] [--example identity]",
+      "node scripts/registry_cli.js export-bundle-set [--notes <text>]",
+      "node scripts/registry_cli.js export-snapshot",
+      "node scripts/registry_cli.js review-bundle [--file <path>] [--example protocol|identity|settlement]",
+      "node scripts/registry_cli.js review-bundle-set [--notes <text>]",
+      "node scripts/registry_cli.js review-snapshot",
+      "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 <source>] [--bundled true|false]",
+      "node scripts/registry_cli.js promotion-action-preview [--integration <integration_id>] [--action <action>]",
+      "node scripts/registry_cli.js promotion-action-set [--integration <integration_id>]",
+      "node scripts/registry_cli.js promotion-action-set-summary [--source <source>] [--bundled true|false]"
+    ]
+  });
+  process.exitCode = 1;
+}
+
+main();