@synctek/forgeos 2.0.0

package/dist/cli/commands/changeset.js

@@ -0,0 +1,174 @@
+/**
+ * `forge changeset` — Changeset operations.
+ *
+ * Subcommands:
+ *   forge changeset propose  --project <pid> --description <desc> [--modules m1,m2] [--files f1,f2]
+ *   forge changeset list     --project <pid>
+ *   forge changeset show     --project <pid> <id>
+ *   forge changeset warnings --project <pid> <id>
+ */
+import { formatTable, formatJSON, formatSuccess, formatWarning, formatError, formatStatus, } from "../output.js";
+export function registerChangesetCommands(parent, client) {
+    const changeset = parent
+        .command("changeset")
+        .description("Manage changesets");
+    // -------------------------------------------------------------------------
+    // changeset propose
+    // -------------------------------------------------------------------------
+    changeset
+        .command("propose")
+        .description("Propose a new changeset")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .requiredOption("--description <desc>", "What changed and why")
+        .option("--initiative <iid>", "Initiative ID this changeset belongs to")
+        .option("--modules <modules>", "Comma-separated list of affected modules", "")
+        .option("--files <files>", "Comma-separated list of changed files", "")
+        .option("--branch <branch>", "Git branch name")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const body = {
+                description: opts.description,
+                modules_affected: opts.modules
+                    ? opts.modules.split(",").map((s) => s.trim()).filter(Boolean)
+                    : [],
+                files_changed: opts.files
+                    ? opts.files.split(",").map((s) => s.trim()).filter(Boolean)
+                    : [],
+            };
+            if (opts.initiative)
+                body.initiative_id = opts.initiative;
+            if (opts.branch)
+                body.branch = opts.branch;
+            const data = (await client.post(`/api/projects/${opts.project}/changesets`, body));
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const csId = data.id ?? data.changeset_id ?? "—";
+            console.log(formatSuccess(`Changeset proposed: ${csId}`));
+            console.log(formatTable(["Field", "Value"], [
+                ["ID", csId],
+                ["Description", data.description],
+                ["Risk Score", String(data.risk_score ?? "—")],
+                [
+                    "Modules",
+                    (data.modules_affected ?? []).join(", ") || "—",
+                ],
+                [
+                    "Files",
+                    (data.files_changed ?? []).join(", ") || "—",
+                ],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // changeset list
+    // -------------------------------------------------------------------------
+    changeset
+        .command("list")
+        .description("List changesets for a project")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = await client.get(`/api/projects/${opts.project}/changesets`);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const items = Array.isArray(data)
+                ? data
+                : (data.changesets ?? []);
+            if (items.length === 0) {
+                console.log("No changesets found.");
+                return;
+            }
+            console.log(formatTable(["ID", "Description", "Risk Score"], items.map((c) => [
+                c.id ?? c.changeset_id ?? "—",
+                c.description.length > 60
+                    ? c.description.substring(0, 57) + "..."
+                    : c.description,
+                String(c.risk_score ?? "—"),
+            ])));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // changeset show <id>
+    // -------------------------------------------------------------------------
+    changeset
+        .command("show <id>")
+        .description("Show changeset details")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (id, opts) => {
+        try {
+            const data = (await client.get(`/api/projects/${opts.project}/changesets/${id}`));
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const csId = data.id ?? data.changeset_id ?? id;
+            console.log(formatTable(["Field", "Value"], [
+                ["ID", csId],
+                ["Description", data.description],
+                ["Risk Score", String(data.risk_score ?? "—")],
+                ["Modules", (data.modules_affected ?? []).join(", ") || "—"],
+                ["Files", (data.files_changed ?? []).join(", ") || "—"],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // changeset warnings <id>
+    // -------------------------------------------------------------------------
+    changeset
+        .command("warnings <id>")
+        .description("Show quality warnings for a changeset")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (id, opts) => {
+        try {
+            const data = await client.get(`/api/projects/${opts.project}/changesets/${id}/quality-warnings`);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const warnings = Array.isArray(data)
+                ? data
+                : (data.warnings ?? []);
+            if (warnings.length === 0) {
+                console.log(formatStatus("Quality warnings", "none", "green"));
+                return;
+            }
+            console.log(formatTable(["Type", "Severity", "Message", "Source"], warnings.map((w) => [
+                w.type,
+                w.severity,
+                w.message.length > 50
+                    ? w.message.substring(0, 47) + "..."
+                    : w.message,
+                w.source,
+            ])));
+            const highs = warnings.filter((w) => ["high", "error", "critical"].includes(w.severity.toLowerCase()));
+            if (highs.length > 0) {
+                console.log(formatWarning(`${highs.length} high-severity warning(s) found.`));
+            }
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=changeset.js.map

package/dist/cli/commands/changeset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeset.js","sourceRoot":"","sources":["../../../src/cli/commands/changeset.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/evidence.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `forge evidence` — Evidence management commands.
+ *
+ * Subcommands:
+ *   forge evidence submit --project <pid> --changeset <cid> --gate <gid>
+ *                         --type <type> --content <content>
+ *   forge evidence list   --project <pid> --changeset <cid> --gate <gid>
+ */
+import { Command } from "commander";
+import { ForgeOSClient } from "../../shared/client.js";
+export declare function registerEvidenceCommands(parent: Command, client: ForgeOSClient): void;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/cli/commands/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAUvD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CA2GN"}

package/dist/cli/commands/evidence.js

@@ -0,0 +1,94 @@
+/**
+ * `forge evidence` — Evidence management commands.
+ *
+ * Subcommands:
+ *   forge evidence submit --project <pid> --changeset <cid> --gate <gid>
+ *                         --type <type> --content <content>
+ *   forge evidence list   --project <pid> --changeset <cid> --gate <gid>
+ */
+import { formatTable, formatJSON, formatSuccess, formatError, } from "../output.js";
+export function registerEvidenceCommands(parent, client) {
+    const evidence = parent
+        .command("evidence")
+        .description("Manage gate evidence");
+    // -------------------------------------------------------------------------
+    // evidence submit
+    // -------------------------------------------------------------------------
+    evidence
+        .command("submit")
+        .description("Submit evidence for a gate")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .requiredOption("--changeset <cid>", "Changeset ID")
+        .requiredOption("--gate <gid>", "Gate ID")
+        .requiredOption("--type <type>", "Evidence type (e.g. unit_test, lint, security_scan)")
+        .requiredOption("--content <content>", "Evidence content / summary")
+        .option("--file-refs <refs>", "Comma-separated file references", "")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const body = {
+                type: opts.type,
+                summary: opts.content,
+                file_refs: opts.fileRefs
+                    ? opts.fileRefs.split(",").map((s) => s.trim()).filter(Boolean)
+                    : [],
+            };
+            const data = (await client.post(`/api/projects/${opts.project}/changesets/${opts.changeset}/gates/${opts.gate}/evidence`, body));
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const evidenceId = data.id ?? "—";
+            console.log(formatSuccess(`Evidence submitted: ${evidenceId}`));
+            console.log(formatTable(["Field", "Value"], [
+                ["ID", evidenceId],
+                ["Type", data.type ?? opts.type],
+                ["Summary", data.summary ?? opts.content],
+                ["Submitted By", data.submitted_by ?? "—"],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // evidence list
+    // -------------------------------------------------------------------------
+    evidence
+        .command("list")
+        .description("List evidence for a gate")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .requiredOption("--changeset <cid>", "Changeset ID")
+        .requiredOption("--gate <gid>", "Gate ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = await client.get(`/api/projects/${opts.project}/changesets/${opts.changeset}/gates/${opts.gate}/evidence`);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const items = Array.isArray(data)
+                ? data
+                : (data.evidence ?? []);
+            if (items.length === 0) {
+                console.log("No evidence submitted for this gate.");
+                return;
+            }
+            console.log(formatTable(["ID", "Type", "Summary", "Submitted By"], items.map((e) => [
+                e.id,
+                e.type,
+                e.summary.length > 50
+                    ? e.summary.substring(0, 47) + "..."
+                    : e.summary,
+                e.submitted_by,
+            ])));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=evidence.js.map

package/dist/cli/commands/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../../src/cli/commands/evidence.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/federation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `forge federation` — Federation operations.
+ *
+ * Subcommands:
+ *   forge federation status --project <pid>
+ *   forge federation enable --project <pid>
+ *   forge federation push   --project <pid>
+ *   forge federation ingest --project <pid>
+ */
+import { Command } from "commander";
+import { ForgeOSClient } from "../../shared/client.js";
+export declare function registerFederationCommands(parent: Command, client: ForgeOSClient): void;
+//# sourceMappingURL=federation.d.ts.map

package/dist/cli/commands/federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAavD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CAsIN"}

package/dist/cli/commands/federation.js

@@ -0,0 +1,127 @@
+/**
+ * `forge federation` — Federation operations.
+ *
+ * Subcommands:
+ *   forge federation status --project <pid>
+ *   forge federation enable --project <pid>
+ *   forge federation push   --project <pid>
+ *   forge federation ingest --project <pid>
+ */
+import { formatTable, formatJSON, formatSuccess, formatError, green, red, } from "../output.js";
+export function registerFederationCommands(parent, client) {
+    const fed = parent
+        .command("federation")
+        .description("Manage ForgeOS federation");
+    // -------------------------------------------------------------------------
+    // federation status
+    // -------------------------------------------------------------------------
+    fed
+        .command("status")
+        .description("Show federation status for a project")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = (await client.get(`/v1/federation/status`));
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatTable(["Field", "Value"], [
+                ["Enabled", data.enabled ? green("yes") : red("no")],
+                ["Hub URL", data.hub_url ?? "—"],
+                ["Instance ID", data.instance_id ?? "—"],
+                ["Last Push", data.last_push ?? "—"],
+                ["Last Pull", data.last_pull ?? "—"],
+            ]));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // federation enable
+    // -------------------------------------------------------------------------
+    fed
+        .command("enable")
+        .description("Enable federation for a project")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--hub-url <url>", "Federation hub URL")
+        .option("--consent-analytics", "Consent to analytics sharing", false)
+        .option("--consent-patterns", "Consent to pattern sharing", false)
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const body = {
+                project_id: opts.project,
+                consent_analytics: opts.consentAnalytics,
+                consent_patterns: opts.consentPatterns,
+            };
+            if (opts.hubUrl)
+                body.hub_url = opts.hubUrl;
+            const data = await client.post(`/v1/federation/configure`, body);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatSuccess("Federation enabled."));
+            console.log(formatJSON(data));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // federation push
+    // -------------------------------------------------------------------------
+    fed
+        .command("push")
+        .description("Push local data to the federation hub")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = await client.post(`/v1/federation/push`, {
+                project_id: opts.project,
+            });
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatSuccess("Federation push initiated."));
+            console.log(formatJSON(data));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // federation ingest
+    // -------------------------------------------------------------------------
+    fed
+        .command("ingest")
+        .description("Ingest updates from the federation hub")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = await client.post(`/v1/federation/ingest`, {
+                project_id: opts.project,
+            });
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatSuccess("Federation ingest complete."));
+            console.log(formatJSON(data));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=federation.js.map

package/dist/cli/commands/federation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.js","sourceRoot":"","sources":["../../../src/cli/commands/federation.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/gate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `forge gate` — Gate management commands.
+ *
+ * Subcommands:
+ *   forge gate status    --project <pid> <changeset_id>
+ *   forge gate promote   --project <pid> <changeset_id> <gate_id>
+ *   forge gate reject    --project <pid> <changeset_id> <gate_id> --reason <reason>
+ *   forge gate skip      --project <pid> <changeset_id> <gate_id> [--reason <reason>]
+ *   forge gate recommend --project <pid> <changeset_id>
+ *   forge gate presets
+ */
+import { Command } from "commander";
+import { ForgeOSClient } from "../../shared/client.js";
+export declare function registerGateCommands(parent: Command, client: ForgeOSClient): void;
+//# sourceMappingURL=gate.d.ts.map

package/dist/cli/commands/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAsBvD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,IAAI,CAgMN"}

package/dist/cli/commands/gate.js

@@ -0,0 +1,178 @@
+/**
+ * `forge gate` — Gate management commands.
+ *
+ * Subcommands:
+ *   forge gate status    --project <pid> <changeset_id>
+ *   forge gate promote   --project <pid> <changeset_id> <gate_id>
+ *   forge gate reject    --project <pid> <changeset_id> <gate_id> --reason <reason>
+ *   forge gate skip      --project <pid> <changeset_id> <gate_id> [--reason <reason>]
+ *   forge gate recommend --project <pid> <changeset_id>
+ *   forge gate presets
+ */
+import { formatTable, formatJSON, formatSuccess, formatError, formatStatus, green, yellow, red, } from "../output.js";
+function gateStatusColor(status) {
+    const s = status.toLowerCase();
+    if (s === "passed" || s === "approved")
+        return green(status);
+    if (s === "pending" || s === "in_progress")
+        return yellow(status);
+    if (s === "failed" || s === "rejected")
+        return red(status);
+    return status;
+}
+export function registerGateCommands(parent, client) {
+    const gate = parent
+        .command("gate")
+        .description("Manage governance gates");
+    // -------------------------------------------------------------------------
+    // gate status <changeset_id>
+    // -------------------------------------------------------------------------
+    gate
+        .command("status <changeset_id>")
+        .description("Show gate pipeline status for a changeset")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (changesetId, opts) => {
+        try {
+            const data = await client.get(`/api/projects/${opts.project}/changesets/${changesetId}/gates`);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            const gates = Array.isArray(data)
+                ? data
+                : (data.gates ?? []);
+            if (gates.length === 0) {
+                console.log("No gates found for this changeset.");
+                return;
+            }
+            console.log(formatTable(["Order", "Gate ID", "Gate Name", "Status", "Required Evidence"], gates.map((g) => [
+                String(g.order ?? "—"),
+                g.gate_id,
+                g.gate_name,
+                gateStatusColor(g.status),
+                (g.required_evidence ?? []).join(", ") || "—",
+            ])));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // gate promote <changeset_id> <gate_id>
+    // -------------------------------------------------------------------------
+    gate
+        .command("promote <changeset_id> <gate_id>")
+        .description("Promote a gate to passed")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--promoted-by <actor>", "Who is promoting", "local_agent")
+        .option("--json", "Output raw JSON")
+        .action(async (changesetId, gateId, opts) => {
+        try {
+            const data = await client.post(`/api/projects/${opts.project}/changesets/${changesetId}/gates/${gateId}/promote`, { promoted_by: opts.promotedBy });
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatSuccess(`Gate ${gateId} promoted.`));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // gate reject <changeset_id> <gate_id>
+    // -------------------------------------------------------------------------
+    gate
+        .command("reject <changeset_id> <gate_id>")
+        .description("Reject a gate")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .requiredOption("--reason <reason>", "Reason for rejection")
+        .option("--json", "Output raw JSON")
+        .action(async (changesetId, gateId, opts) => {
+        try {
+            const data = await client.post(`/api/projects/${opts.project}/changesets/${changesetId}/gates/${gateId}/reject`, { reason: opts.reason });
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatStatus("Gate", `${gateId} rejected`, "red"));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // gate skip <changeset_id> <gate_id>
+    // -------------------------------------------------------------------------
+    gate
+        .command("skip <changeset_id> <gate_id>")
+        .description("Skip a gate (with optional reason)")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--reason <reason>", "Reason for skipping")
+        .option("--json", "Output raw JSON")
+        .action(async (changesetId, gateId, opts) => {
+        try {
+            const body = {};
+            if (opts.reason)
+                body.reason = opts.reason;
+            const data = await client.post(`/api/projects/${opts.project}/changesets/${changesetId}/gates/${gateId}/skip`, body);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatSuccess(`Gate ${gateId} skipped.`));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // gate recommend <changeset_id>
+    // -------------------------------------------------------------------------
+    gate
+        .command("recommend <changeset_id>")
+        .description("Get gate recommendations for a changeset based on risk")
+        .requiredOption("-p, --project <pid>", "Project ID")
+        .option("--json", "Output raw JSON")
+        .action(async (changesetId, opts) => {
+        try {
+            const data = await client.post(`/api/projects/${opts.project}/changesets/${changesetId}/recommend-gates`);
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatJSON(data));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // gate presets
+    // -------------------------------------------------------------------------
+    gate
+        .command("presets")
+        .description("List available governance gate presets")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const data = await client.get("/api/gate-presets");
+            if (opts.json) {
+                console.log(formatJSON(data));
+                return;
+            }
+            console.log(formatJSON(data));
+        }
+        catch (err) {
+            console.error(formatError(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=gate.js.map