@bli-cockpit/cli 0.1.9 → 0.1.12

package/dist/commands/local-args.js

@@ -0,0 +1,383 @@
+// CLI argument parsing for the local cockpit collector. Split out of
+// commands/local.ts so the command runners read as a table of contents and
+// the parser (pure, independently testable) can change at its own rate.
+//
+// Behavior-preserving extraction: functions moved verbatim, no logic change.
+import { DEFAULT_DASHBOARD_URL } from "../local-state.js";
+export function parseLocalArgs(argv) {
+    const command = argv[0];
+    switch (command) {
+        case "onboard":
+            return parseOnboardArgs(argv.slice(1));
+        case "install":
+            return parseInstallArgs(argv.slice(1));
+        case "login":
+        case "pair":
+            return parseLoginArgs(argv.slice(1));
+        case "logout":
+            return parseLogoutArgs(argv.slice(1));
+        case "start":
+            return parseStartArgs(argv.slice(1));
+        case "sync":
+            return parseSyncArgs(argv.slice(1));
+        case "status":
+            return parseStatusArgs(argv.slice(1));
+        case "sessions":
+            return parseSessionsArgs(argv.slice(1));
+        case "serve":
+            return parseServeArgs(argv.slice(1));
+        case "autostart":
+            return parseAutostartArgs(argv.slice(1));
+        default:
+            throw new Error(`Unknown local command: ${command ?? ""}`);
+    }
+}
+function parseOnboardArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--ticket",
+            "--branch",
+            "--json",
+            "--poll-interval-ms",
+            "--timeout-ms",
+            "--max-depth",
+            "--max-repos",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--ticket",
+            "--branch",
+            "--poll-interval-ms",
+            "--timeout-ms",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, "onboard");
+    return {
+        kind: "onboard",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        claimedOwnerEmail: optionalEmail(values.flags.get("--email")),
+        deviceName: optionalNonEmpty(values.flags.get("--device-name")),
+        activeTicketId: optionalNonEmpty(values.flags.get("--ticket")),
+        branch: optionalNonEmpty(values.flags.get("--branch")),
+        json: values.booleans.has("--json"),
+        pollIntervalMs: optionalPositiveInteger(values.flags.get("--poll-interval-ms"), "--poll-interval-ms"),
+        timeoutMs: optionalPositiveInteger(values.flags.get("--timeout-ms"), "--timeout-ms"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+function parseInstallArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--dashboard-url",
+            "--supabase-url",
+            "--json",
+        ],
+        valueFlags: ["--home", "--repo", "--dashboard-url", "--supabase-url"],
+    });
+    assertNoPositionals(values.positionals, "install");
+    return {
+        kind: "install",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        supabaseUrl: optionalNonEmpty(values.flags.get("--supabase-url")),
+        json: values.booleans.has("--json"),
+    };
+}
+function parseLoginArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--json",
+            "--poll-interval-ms",
+            "--timeout-ms",
+        ],
+        valueFlags: [
+            "--home",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--poll-interval-ms",
+            "--timeout-ms",
+        ],
+    });
+    assertNoPositionals(values.positionals, "login");
+    return {
+        kind: "login",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        claimedOwnerEmail: optionalEmail(values.flags.get("--email")),
+        deviceName: optionalNonEmpty(values.flags.get("--device-name")),
+        json: values.booleans.has("--json"),
+        pollIntervalMs: optionalPositiveInteger(values.flags.get("--poll-interval-ms"), "--poll-interval-ms"),
+        timeoutMs: optionalPositiveInteger(values.flags.get("--timeout-ms"), "--timeout-ms"),
+    };
+}
+function parseLogoutArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--json"],
+        valueFlags: ["--home"],
+    });
+    assertNoPositionals(values.positionals, "logout");
+    return {
+        kind: "logout",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+    };
+}
+function parseStartArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--branch",
+            "--ticket",
+            "--operator-id",
+            "--session-id",
+            "--json",
+            "--max-depth",
+            "--max-repos",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--branch",
+            "--ticket",
+            "--operator-id",
+            "--session-id",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, "start");
+    return {
+        kind: "start",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        branch: optionalNonEmpty(values.flags.get("--branch")),
+        activeTicketId: optionalNonEmpty(values.flags.get("--ticket")),
+        operatorId: optionalNonEmpty(values.flags.get("--operator-id")),
+        sessionId: optionalNonEmpty(values.flags.get("--session-id")),
+        json: values.booleans.has("--json"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+function parseSyncArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--repo", "--dashboard-url", "--json", "--max-depth", "--max-repos"],
+        valueFlags: ["--home", "--repo", "--dashboard-url", "--max-depth", "--max-repos"],
+    });
+    assertNoPositionals(values.positionals, "sync");
+    return {
+        kind: "sync",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        json: values.booleans.has("--json"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+function parseStatusArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--repo", "--json", "--max-depth", "--max-repos"],
+        valueFlags: ["--home", "--repo", "--max-depth", "--max-repos"],
+    });
+    assertNoPositionals(values.positionals, "status");
+    return {
+        kind: "status",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        json: values.booleans.has("--json"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+function parseSessionsArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--repo", "--source", "--json", "--max-depth", "--max-repos"],
+        valueFlags: ["--home", "--repo", "--source", "--max-depth", "--max-repos"],
+    });
+    assertNoPositionals(values.positionals, "sessions");
+    const source = values.flags.get("--source");
+    if (source !== undefined && source !== "codex" && source !== "claude") {
+        throw new Error("--source must be 'codex' or 'claude'.");
+    }
+    return {
+        kind: "sessions",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        source,
+        json: values.booleans.has("--json"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+function parseServeArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--repo", "--port"],
+        valueFlags: ["--home", "--repo", "--port"],
+    });
+    assertNoPositionals(values.positionals, "serve");
+    const port = Number(values.flags.get("--port") ?? "4174");
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error("--port must be a TCP port between 1 and 65535.");
+    }
+    return {
+        kind: "serve",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        port,
+    };
+}
+function parseAutostartArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--dashboard-url",
+            "--interval-seconds",
+            "--json",
+        ],
+        valueFlags: ["--home", "--repo", "--dashboard-url", "--interval-seconds"],
+    });
+    if (values.positionals.length > 1) {
+        throw new Error("autostart accepts at most one action (install|uninstall|status).");
+    }
+    const action = values.positionals[0] ?? "install";
+    if (action !== "install" && action !== "uninstall" && action !== "status") {
+        throw new Error("autostart action must be install, uninstall, or status.");
+    }
+    return {
+        kind: "autostart",
+        action,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(values.flags.get("--repo")),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        intervalSeconds: optionalPositiveInteger(values.flags.get("--interval-seconds"), "--interval-seconds") ?? 1800,
+        json: values.booleans.has("--json"),
+    };
+}
+function parseNamedArgs(args, options) {
+    const allowed = new Set(options.allowedFlags);
+    const valueFlags = new Set(options.valueFlags);
+    const flags = new Map();
+    const booleans = new Set();
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index] ?? "";
+        rejectServiceRoleLikeArgument(arg);
+        if (!arg.startsWith("--")) {
+            positionals.push(arg);
+            continue;
+        }
+        const [flag, inlineValue] = arg.split("=", 2);
+        if (!allowed.has(flag))
+            throw new Error(`Unknown flag: ${flag}`);
+        if (valueFlags.has(flag)) {
+            const value = inlineValue ?? args[index + 1];
+            if (!value || value.startsWith("--")) {
+                throw new Error(`${flag} requires a value.`);
+            }
+            rejectServiceRoleLikeArgument(value);
+            flags.set(flag, value);
+            if (inlineValue === undefined)
+                index += 1;
+        }
+        else {
+            if (inlineValue !== undefined)
+                throw new Error(`${flag} does not accept a value.`);
+            booleans.add(flag);
+        }
+    }
+    return { flags, booleans, positionals };
+}
+function assertNoPositionals(positionals, command) {
+    if (positionals.length > 0) {
+        throw new Error(`${command} does not accept positional arguments.`);
+    }
+}
+function optionalNonEmpty(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function optionalUrl(value) {
+    return value === undefined ? undefined : normalizeUrl(value);
+}
+function optionalEmail(value) {
+    const trimmed = value?.trim().toLowerCase();
+    if (!trimmed)
+        return undefined;
+    if (!trimmed.includes("@")) {
+        throw new Error("--email must be a valid email address.");
+    }
+    return trimmed;
+}
+function optionalPositiveInteger(value, flag) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new Error(`${flag} must be a positive integer.`);
+    }
+    return parsed;
+}
+export function normalizeUrl(value) {
+    const trimmed = value.trim().replace(/\/+$/, "");
+    if (!trimmed)
+        throw new Error("URL value cannot be empty.");
+    return trimmed;
+}
+function rejectServiceRoleLikeArgument(value) {
+    if (!looksLikeServiceRoleSecret(value))
+        return;
+    throw new Error("Service-role credentials are not accepted by local collector commands.");
+}
+function looksLikeServiceRoleSecret(value) {
+    if (serviceCredentialNamePattern().test(value))
+        return true;
+    const parts = value.split(".");
+    if (parts.length !== 3)
+        return false;
+    try {
+        const payload = Buffer.from(base64UrlToBase64(parts[1] ?? ""), "base64").toString("utf8");
+        return serviceCredentialPayloadPattern().test(payload);
+    }
+    catch {
+        return false;
+    }
+}
+function serviceCredentialNamePattern() {
+    return new RegExp([
+        ["SUPABASE", "SERVICE", "ROLE", "KEY"].join("[_-]?"),
+        ["service", "role"].join("[_-]?"),
+    ].join("|"), "i");
+}
+function serviceCredentialPayloadPattern() {
+    const privilegedRole = ["service", "role"].join("_");
+    return new RegExp(`"role"\\s*:\\s*"${privilegedRole}"`);
+}
+function base64UrlToBase64(value) {
+    const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
+    return `${normalized}${"=".repeat((4 - (normalized.length % 4)) % 4)}`;
+}