feat(discovery): gateway bonjour + node pairing bridge

src/cli/nodes-cli.ts

@@ -0,0 +1,210 @@
+import type { Command } from "commander";
+import { callGateway } from "../gateway/call.js";
+import { defaultRuntime } from "../runtime.js";
+
+type NodesRpcOpts = {
+  url?: string;
+  token?: string;
+  timeout?: string;
+  json?: boolean;
+};
+
+type PendingRequest = {
+  requestId: string;
+  nodeId: string;
+  displayName?: string;
+  platform?: string;
+  version?: string;
+  remoteIp?: string;
+  isRepair?: boolean;
+  ts: number;
+};
+
+type PairedNode = {
+  nodeId: string;
+  token?: string;
+  displayName?: string;
+  platform?: string;
+  version?: string;
+  remoteIp?: string;
+  createdAtMs?: number;
+  approvedAtMs?: number;
+};
+
+type PairingList = {
+  pending: PendingRequest[];
+  paired: PairedNode[];
+};
+
+const nodesCallOpts = (cmd: Command) =>
+  cmd
+    .option("--url <url>", "Gateway WebSocket URL", "ws://127.0.0.1:18789")
+    .option("--token <token>", "Gateway token (if required)")
+    .option("--timeout <ms>", "Timeout in ms", "10000")
+    .option("--json", "Output JSON", false);
+
+const callGatewayCli = async (
+  method: string,
+  opts: NodesRpcOpts,
+  params?: unknown,
+) =>
+  callGateway({
+    url: opts.url,
+    token: opts.token,
+    method,
+    params,
+    timeoutMs: Number(opts.timeout ?? 10_000),
+    clientName: "cli",
+    mode: "cli",
+  });
+
+function formatAge(msAgo: number) {
+  const s = Math.max(0, Math.floor(msAgo / 1000));
+  if (s < 60) return `${s}s`;
+  const m = Math.floor(s / 60);
+  if (m < 60) return `${m}m`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h}h`;
+  const d = Math.floor(h / 24);
+  return `${d}d`;
+}
+
+function parsePairingList(value: unknown): PairingList {
+  const obj =
+    typeof value === "object" && value !== null
+      ? (value as Record<string, unknown>)
+      : {};
+  const pending = Array.isArray(obj.pending)
+    ? (obj.pending as PendingRequest[])
+    : [];
+  const paired = Array.isArray(obj.paired) ? (obj.paired as PairedNode[]) : [];
+  return { pending, paired };
+}
+
+export function registerNodesCli(program: Command) {
+  const nodes = program
+    .command("nodes")
+    .description("Manage gateway-owned node pairing");
+
+  nodesCallOpts(
+    nodes
+      .command("list")
+      .description("List pending and paired nodes")
+      .action(async (opts: NodesRpcOpts) => {
+        try {
+          const result = (await callGatewayCli(
+            "node.pair.list",
+            opts,
+            {},
+          )) as unknown;
+          if (opts.json) {
+            defaultRuntime.log(JSON.stringify(result, null, 2));
+            return;
+          }
+          const { pending, paired } = parsePairingList(result);
+          defaultRuntime.log(
+            `Pending: ${pending.length} · Paired: ${paired.length}`,
+          );
+          if (pending.length > 0) {
+            defaultRuntime.log("\nPending:");
+            for (const r of pending) {
+              const name = r.displayName || r.nodeId;
+              const repair = r.isRepair ? " (repair)" : "";
+              const ip = r.remoteIp ? ` · ${r.remoteIp}` : "";
+              const age =
+                typeof r.ts === "number"
+                  ? ` · ${formatAge(Date.now() - r.ts)} ago`
+                  : "";
+              defaultRuntime.log(
+                `- ${r.requestId}: ${name}${repair}${ip}${age}`,
+              );
+            }
+          }
+          if (paired.length > 0) {
+            defaultRuntime.log("\nPaired:");
+            for (const n of paired) {
+              const name = n.displayName || n.nodeId;
+              const ip = n.remoteIp ? ` · ${n.remoteIp}` : "";
+              defaultRuntime.log(`- ${n.nodeId}: ${name}${ip}`);
+            }
+          }
+        } catch (err) {
+          defaultRuntime.error(`nodes list failed: ${String(err)}`);
+          defaultRuntime.exit(1);
+        }
+      }),
+  );
+
+  nodesCallOpts(
+    nodes
+      .command("pending")
+      .description("List pending pairing requests")
+      .action(async (opts: NodesRpcOpts) => {
+        try {
+          const result = (await callGatewayCli(
+            "node.pair.list",
+            opts,
+            {},
+          )) as unknown;
+          const { pending } = parsePairingList(result);
+          if (opts.json) {
+            defaultRuntime.log(JSON.stringify(pending, null, 2));
+            return;
+          }
+          if (pending.length === 0) {
+            defaultRuntime.log("No pending pairing requests.");
+            return;
+          }
+          for (const r of pending) {
+            const name = r.displayName || r.nodeId;
+            const repair = r.isRepair ? " (repair)" : "";
+            const ip = r.remoteIp ? ` · ${r.remoteIp}` : "";
+            const age =
+              typeof r.ts === "number"
+                ? ` · ${formatAge(Date.now() - r.ts)} ago`
+                : "";
+            defaultRuntime.log(`- ${r.requestId}: ${name}${repair}${ip}${age}`);
+          }
+        } catch (err) {
+          defaultRuntime.error(`nodes pending failed: ${String(err)}`);
+          defaultRuntime.exit(1);
+        }
+      }),
+  );
+
+  nodesCallOpts(
+    nodes
+      .command("approve")
+      .description("Approve a pending pairing request")
+      .argument("<requestId>", "Pending request id")
+      .action(async (requestId: string, opts: NodesRpcOpts) => {
+        try {
+          const result = await callGatewayCli("node.pair.approve", opts, {
+            requestId,
+          });
+          defaultRuntime.log(JSON.stringify(result, null, 2));
+        } catch (err) {
+          defaultRuntime.error(`nodes approve failed: ${String(err)}`);
+          defaultRuntime.exit(1);
+        }
+      }),
+  );
+
+  nodesCallOpts(
+    nodes
+      .command("reject")
+      .description("Reject a pending pairing request")
+      .argument("<requestId>", "Pending request id")
+      .action(async (requestId: string, opts: NodesRpcOpts) => {
+        try {
+          const result = await callGatewayCli("node.pair.reject", opts, {
+            requestId,
+          });
+          defaultRuntime.log(JSON.stringify(result, null, 2));
+        } catch (err) {
+          defaultRuntime.error(`nodes reject failed: ${String(err)}`);
+          defaultRuntime.exit(1);
+        }
+      }),
+  );
+}