@bli-cockpit/cli 0.2.54 → 0.2.56

package/dist/commands/local-args-collector-setup.js

@@ -0,0 +1,250 @@
+/**
+ * The six human "set my machine up" doors (`install`, `onboard`, `login`,
+ * `pair`, `update`, `upgrade`), `do-everything`/`fix`, `logout`, and the
+ * maintainer's `release`. Split out of local-args-collector.ts (BLI-3636).
+ *
+ * `OnboardLikeOptions` — the flag set the setup doors share — lives here with
+ * the parser that produces it and is imported back by `local-args.ts` for the
+ * `LocalCommand` union. It has never been part of that module's export
+ * surface and still is not.
+ *
+ * Every parser moved verbatim: same allowed flags, same value flags, same
+ * defaults, same refusal sentences.
+ */
+import { DEFAULT_DASHBOARD_URL } from "../local-state.js";
+import { assertNoPositionals, normalizeUrl, optionalEmail, optionalNonEmpty, optionalNonEmptyList, optionalPositiveInteger, optionalUrl, parseNamedArgs, workRootFlagValue, workRootFlagValues, } from "./local-arg-values.js";
+function parseOnboardLikeArgs(args, command) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--ticket",
+            "--branch",
+            "--json",
+            "--no-auth",
+            "--poll-interval-ms",
+            "--timeout-ms",
+            "--max-depth",
+            "--max-repos",
+            "--allow-home-root",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--ticket",
+            "--branch",
+            "--poll-interval-ms",
+            "--timeout-ms",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, command);
+    return {
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        collectionRoots: optionalNonEmptyList(workRootFlagValues(values)),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        dashboardUrlExplicit: values.flags.has("--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")),
+        noAuth: values.booleans.has("--no-auth"),
+        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"),
+        allowHomeRoot: values.booleans.has("--allow-home-root"),
+    };
+}
+export function parseOnboardArgs(args) {
+    return { kind: "onboard", ...parseOnboardLikeArgs(args, "onboard") };
+}
+export function parseUpdateArgs(alias, args) {
+    return {
+        kind: "update",
+        alias,
+        ...parseOnboardLikeArgs(args, alias),
+    };
+}
+export function parseDoctorArgs(alias, args) {
+    // The allowed set is the UNION of what the six setup doors used to accept.
+    // An alias that silently rejected a flag its own docs told people to pass
+    // would be a worse dead end than the one we are removing.
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--update-tag",
+            "--dry-run",
+            "--json",
+            "--allow-home-root",
+            "--max-depth",
+            "--max-repos",
+            // Accepted and ignored: the convergence run works these out itself.
+            // Rejecting them would break existing DMs and runbooks for no gain.
+            "--email",
+            "--device-name",
+            "--ticket",
+            "--branch",
+            "--no-auth",
+            "--poll-interval-ms",
+            "--timeout-ms",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--update-tag",
+            "--max-depth",
+            "--max-repos",
+            "--email",
+            "--device-name",
+            "--ticket",
+            "--branch",
+            "--poll-interval-ms",
+            "--timeout-ms",
+        ],
+    });
+    assertNoPositionals(values.positionals, alias);
+    const updateTag = optionalNonEmpty(values.flags.get("--update-tag"));
+    if (updateTag && !/^[a-z0-9][a-z0-9._-]*$/u.test(updateTag)) {
+        throw new Error("--update-tag must be a lowercase npm dist-tag such as 'next' or 'latest'.");
+    }
+    return {
+        kind: "doctor",
+        alias,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        collectionRoots: optionalNonEmptyList(workRootFlagValues(values)),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        updateTag,
+        dryRun: values.booleans.has("--dry-run"),
+        json: values.booleans.has("--json"),
+        allowHomeRoot: values.booleans.has("--allow-home-root"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+export function parseInstallArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--supabase-url",
+            "--json",
+            "--allow-home-root",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--supabase-url",
+        ],
+    });
+    assertNoPositionals(values.positionals, "install");
+    return {
+        kind: "install",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        supabaseUrl: optionalNonEmpty(values.flags.get("--supabase-url")),
+        json: values.booleans.has("--json"),
+        allowHomeRoot: values.booleans.has("--allow-home-root"),
+    };
+}
+export function parseReleaseArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--dry-run",
+            "--tag",
+            "--access",
+            "--otp",
+            "--skip-checks",
+            // BLI-3557: publish without raising the fleet forced-update floor. The
+            // maintainer path must be able to say that, or the staged rollout only
+            // exists for whoever runs the npm script directly.
+            "--no-floor",
+        ],
+        valueFlags: ["--tag", "--access", "--otp"],
+    });
+    assertNoPositionals(values.positionals, "release");
+    const releaseArgs = [];
+    if (values.booleans.has("--dry-run"))
+        releaseArgs.push("--dry-run");
+    if (values.booleans.has("--skip-checks"))
+        releaseArgs.push("--skip-checks");
+    if (values.booleans.has("--no-floor"))
+        releaseArgs.push("--no-floor");
+    for (const flag of ["--tag", "--access", "--otp"]) {
+        const value = values.flags.get(flag);
+        if (value !== undefined)
+            releaseArgs.push(flag, value);
+    }
+    return { kind: "release", args: releaseArgs };
+}
+export function parseLoginArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--dashboard-url",
+            "--email",
+            "--device-name",
+            "--json",
+            "--no-auth",
+            "--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"),
+        noAuth: values.booleans.has("--no-auth"),
+        pollIntervalMs: optionalPositiveInteger(values.flags.get("--poll-interval-ms"), "--poll-interval-ms"),
+        timeoutMs: optionalPositiveInteger(values.flags.get("--timeout-ms"), "--timeout-ms"),
+    };
+}
+export function parseLogoutArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--json", "--revoke", "--dashboard-url", "--yes"],
+        valueFlags: ["--home", "--dashboard-url"],
+    });
+    assertNoPositionals(values.positionals, "logout");
+    return {
+        kind: "logout",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+        revoke: values.booleans.has("--revoke"),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        yes: values.booleans.has("--yes"),
+    };
+}

package/dist/commands/local-args-collector-status.js

@@ -0,0 +1,227 @@
+/**
+ * The commands that read or maintain an already-collecting machine rather
+ * than converge new data: `cockpit status`, `cockpit sessions`,
+ * `cockpit serve`, `cockpit autostart`, `cockpit agent-rules`,
+ * `cockpit memory`, and `cockpit clean`. Split out of local-args-collector.ts
+ * (BLI-3636).
+ *
+ * Every parser moved verbatim: same allowed flags, same value flags, same
+ * defaults, same refusal sentences.
+ */
+import { DEFAULT_AUTOSTART_INTERVAL_SECONDS } from "../autostart.js";
+import { assertNoPositionals, normalizeUrl, optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, workRootFlagValue, } from "./local-arg-values.js";
+import { DEFAULT_DASHBOARD_URL } from "../local-state.js";
+export function parseStatusArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--json",
+            "--max-depth",
+            "--max-repos",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, "status");
+    return {
+        kind: "status",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        json: values.booleans.has("--json"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+export function parseSessionsArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--source",
+            "--since-days",
+            "--all",
+            "--json",
+            "--max-depth",
+            "--max-repos",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--source",
+            "--since-days",
+            "--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'. Omit it to scan both.");
+    }
+    const sinceDays = optionalPositiveInteger(values.flags.get("--since-days"), "--since-days");
+    const all = values.booleans.has("--all");
+    if (all && sinceDays !== undefined) {
+        throw new Error("--since-days and --all cannot be combined.");
+    }
+    return {
+        kind: "sessions",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        source,
+        sinceDays,
+        all,
+        json: values.booleans.has("--json"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+    };
+}
+export function parseServeArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--repo", "--workspace", "--port"],
+        valueFlags: ["--home", "--repo", "--workspace", "--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(workRootFlagValue(values)),
+        port,
+    };
+}
+export function parseAutostartArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--interval-seconds",
+            "--parent-pid",
+            "--json",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--interval-seconds",
+            "--parent-pid",
+        ],
+    });
+    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" &&
+        action !== "heal-detached") {
+        throw new Error("autostart action must be install, uninstall, or status.");
+    }
+    return {
+        kind: "autostart",
+        action,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        dashboardUrl: normalizeUrl(values.flags.get("--dashboard-url") ?? DEFAULT_DASHBOARD_URL),
+        intervalSeconds: optionalPositiveInteger(values.flags.get("--interval-seconds"), "--interval-seconds") ?? DEFAULT_AUTOSTART_INTERVAL_SECONDS,
+        parentPid: optionalPositiveInteger(values.flags.get("--parent-pid"), "--parent-pid"),
+        json: values.booleans.has("--json"),
+    };
+}
+export function parseAgentRulesArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--host", "--repo", "--workspace", "--json"],
+        valueFlags: ["--home", "--host", "--repo", "--workspace"],
+    });
+    if (values.positionals.length > 1) {
+        throw new Error("agent-rules accepts at most one action (install|uninstall|status).");
+    }
+    const action = values.positionals[0] ?? "install";
+    if (action !== "install" && action !== "uninstall" && action !== "status") {
+        throw new Error("agent-rules action must be install, uninstall, or status.");
+    }
+    return {
+        kind: "agent-rules",
+        action,
+        host: parseAgentRulesHost(values.flags.get("--host")),
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        json: values.booleans.has("--json"),
+    };
+}
+/**
+ * BLI-3580. `install` is the default action on purpose: this command exists to
+ * be run unasked (by `do-everything` and by the sync tick), and a bare
+ * `cockpit memory` should do the thing rather than print usage.
+ */
+export function parseMemoryArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--home", "--dashboard-url", "--dry-run", "--json"],
+        valueFlags: ["--home", "--dashboard-url"],
+    });
+    if (values.positionals.length > 1) {
+        throw new Error("memory accepts at most one action (install|status).");
+    }
+    const action = values.positionals[0] ?? "install";
+    if (action !== "install" && action !== "status") {
+        throw new Error("memory action must be install or status.");
+    }
+    return {
+        kind: "memory",
+        action,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        dryRun: values.booleans.has("--dry-run"),
+        json: values.booleans.has("--json"),
+    };
+}
+/**
+ * BLI-3619. Deliberately takes no positional: `clean` is one verb, and the two
+ * flags say how far it goes. A path is never accepted — the only directory this
+ * command may touch is the collector's own state directory.
+ */
+export function parseCleanArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--dashboard-url",
+            "--dry-run",
+            "--all-committed",
+            "--reconcile",
+            "--json",
+        ],
+        valueFlags: ["--home", "--dashboard-url"],
+    });
+    if (values.positionals.length > 0) {
+        throw new Error("clean takes no arguments; use --dry-run, --all-committed, or --reconcile.");
+    }
+    return {
+        kind: "clean",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        dryRun: values.booleans.has("--dry-run"),
+        allCommitted: values.booleans.has("--all-committed"),
+        reconcile: values.booleans.has("--reconcile"),
+        json: values.booleans.has("--json"),
+    };
+}
+function parseAgentRulesHost(value) {
+    const host = value?.trim().toLowerCase() || "all";
+    if (host === "codex" || host === "claude" || host === "all")
+        return host;
+    throw new Error("agent-rules --host must be codex, claude, or all.");
+}

package/dist/commands/local-args-collector-work.js

@@ -0,0 +1,175 @@
+/**
+ * The commands that do ongoing collection work on an already-set-up machine:
+ * `cockpit start` (bind a ticket), `cockpit sync`/`cockpit analyze`
+ * (converge now), and `cockpit backfill` (catch up on history). Split out of
+ * local-args-collector.ts (BLI-3636).
+ *
+ * Every parser moved verbatim: same allowed flags, same value flags, same
+ * defaults, same refusal sentences.
+ */
+import { IntentSourceSchema, WorkIntentSchema, WorkPhaseSchema, } from "@bli-cockpit/telemetry-core";
+import { assertNoPositionals, optionalConfidence, optionalNonEmpty, optionalPositiveInteger, optionalSchemaValue, optionalUrl, parseNamedArgs, workRootFlagValue, } from "./local-arg-values.js";
+export function parseStartArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--branch",
+            "--ticket",
+            "--clear-ticket",
+            "--topic",
+            "--topic-summary",
+            "--intent",
+            "--phase",
+            "--intent-source",
+            "--intent-confidence",
+            "--operator-id",
+            "--session-id",
+            "--json",
+            "--max-depth",
+            "--max-repos",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--branch",
+            "--ticket",
+            "--topic",
+            "--topic-summary",
+            "--intent",
+            "--phase",
+            "--intent-source",
+            "--intent-confidence",
+            "--operator-id",
+            "--session-id",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, "start");
+    const activeTicketId = optionalNonEmpty(values.flags.get("--ticket"));
+    const clearTicket = values.booleans.has("--clear-ticket");
+    if (activeTicketId && clearTicket) {
+        throw new Error("--ticket and --clear-ticket cannot be combined.");
+    }
+    const topicLabel = optionalNonEmpty(values.flags.get("--topic"));
+    const topicSummaryRedacted = optionalNonEmpty(values.flags.get("--topic-summary"));
+    const workIntent = optionalSchemaValue(WorkIntentSchema, values.flags.get("--intent"), "--intent");
+    const workPhase = optionalSchemaValue(WorkPhaseSchema, values.flags.get("--phase"), "--phase");
+    const intentConfidence = optionalConfidence(values.flags.get("--intent-confidence"), "--intent-confidence");
+    const explicitIntentMetadata = Boolean(topicLabel ||
+        topicSummaryRedacted ||
+        workIntent ||
+        workPhase ||
+        intentConfidence !== undefined);
+    return {
+        kind: "start",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        branch: optionalNonEmpty(values.flags.get("--branch")),
+        activeTicketId,
+        clearTicket,
+        topicLabel,
+        topicSummaryRedacted,
+        workIntent,
+        workPhase,
+        intentSource: optionalSchemaValue(IntentSourceSchema, values.flags.get("--intent-source"), "--intent-source") ?? (explicitIntentMetadata ? "explicit_user" : undefined),
+        intentConfidence,
+        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"),
+    };
+}
+export function parseSyncArgs(args) {
+    return parseSyncLikeArgs(args, "sync");
+}
+export function parseAnalyzeArgs(args) {
+    return parseSyncLikeArgs(args, "analyze");
+}
+function parseSyncLikeArgs(args, command) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--json",
+            "--max-depth",
+            "--max-repos",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--dashboard-url",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, command);
+    return {
+        kind: command,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        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"),
+    };
+}
+export function parseBackfillArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--since-days",
+            "--all",
+            "--source",
+            "--dry-run",
+            "--max-files",
+            "--max-depth",
+            "--max-repos",
+            "--yes",
+            "--json",
+        ],
+        valueFlags: [
+            "--home",
+            "--repo",
+            "--workspace",
+            "--since-days",
+            "--source",
+            "--max-files",
+            "--max-depth",
+            "--max-repos",
+        ],
+    });
+    assertNoPositionals(values.positionals, "backfill");
+    const source = values.flags.get("--source");
+    if (source !== undefined && source !== "codex" && source !== "claude") {
+        throw new Error("--source must be 'codex' or 'claude'. Omit it to scan both.");
+    }
+    const sinceDays = optionalPositiveInteger(values.flags.get("--since-days"), "--since-days");
+    const all = values.booleans.has("--all");
+    if (all && sinceDays !== undefined) {
+        throw new Error("--since-days and --all cannot be combined.");
+    }
+    return {
+        kind: "backfill",
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        repoRoot: optionalNonEmpty(workRootFlagValue(values)),
+        source,
+        sinceDays,
+        all,
+        dryRun: values.booleans.has("--dry-run"),
+        maxFiles: optionalPositiveInteger(values.flags.get("--max-files"), "--max-files"),
+        maxDepth: optionalPositiveInteger(values.flags.get("--max-depth"), "--max-depth"),
+        maxRepos: optionalPositiveInteger(values.flags.get("--max-repos"), "--max-repos"),
+        yes: values.booleans.has("--yes"),
+        json: values.booleans.has("--json"),
+    };
+}