@poolzin/pool-bot 2026.2.21 → 2026.2.22

package/dist/cli/update-cli.js

@@ -1,1032 +1,26 @@
-import { confirm, isCancel, select, spinner } from "@clack/prompts";
-import { spawnSync } from "node:child_process";
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { doctorCommand } from "../commands/doctor.js";
-import { formatUpdateAvailableHint, formatUpdateOneLiner, resolveUpdateAvailability, } from "../commands/status.update.js";
-import { readConfigFileSnapshot, writeConfigFile } from "../config/config.js";
-import { resolveStateDir } from "../config/paths.js";
-import { formatDurationPrecise } from "../infra/format-time/format-duration.js";
-import { resolvePoolBotPackageRoot } from "../infra/poolbot-root.js";
-import { trimLogTail } from "../infra/restart-sentinel.js";
-import { parseSemver } from "../infra/runtime-guard.js";
-import { channelToNpmTag, DEFAULT_GIT_CHANNEL, DEFAULT_PACKAGE_CHANNEL, formatUpdateChannelLabel, normalizeUpdateChannel, resolveEffectiveUpdateChannel, } from "../infra/update-channels.js";
-import { checkUpdateStatus, compareSemverStrings, fetchNpmTagVersion, resolveNpmChannelTag, } from "../infra/update-check.js";
-import { detectGlobalInstallManagerByPresence, detectGlobalInstallManagerForRoot, cleanupGlobalRenameDirs, globalInstallArgs, resolveGlobalPackageRoot, } from "../infra/update-global.js";
-import { runGatewayUpdate, } from "../infra/update-runner.js";
-import { syncPluginsForUpdateChannel, updateNpmInstalledPlugins } from "../plugins/update.js";
-import { runCommandWithTimeout } from "../process/exec.js";
 import { defaultRuntime } from "../runtime.js";
 import { formatDocsLink } from "../terminal/links.js";
-import { stylePromptHint, stylePromptMessage } from "../terminal/prompt-style.js";
-import { renderTable } from "../terminal/table.js";
 import { theme } from "../terminal/theme.js";
-import { pathExists } from "../utils.js";
-import { replaceCliName, resolveCliName } from "./cli-name.js";
-import { formatCliCommand } from "./command-format.js";
-import { runDaemonRestart } from "./daemon-cli.js";
+import { inheritOptionFromParent } from "./command-options.js";
 import { formatHelpExamples } from "./help-format.js";
-const STEP_LABELS = {
-    "clean check": "Working directory is clean",
-    "upstream check": "Upstream branch exists",
-    "git fetch": "Fetching latest changes",
-    "git rebase": "Rebasing onto target commit",
-    "git rev-parse @{upstream}": "Resolving upstream commit",
-    "git rev-list": "Enumerating candidate commits",
-    "git clone": "Cloning git checkout",
-    "preflight worktree": "Preparing preflight worktree",
-    "preflight cleanup": "Cleaning preflight worktree",
-    "deps install": "Installing dependencies",
-    build: "Building",
-    "ui:build": "Building UI assets",
-    "ui:build (post-doctor repair)": "Restoring missing UI assets",
-    "ui assets verify": "Validating UI assets",
-    "poolbot doctor entry": "Checking doctor entrypoint",
-    "poolbot doctor": "Running doctor checks",
-    "git rev-parse HEAD (after)": "Verifying update",
-    "global update": "Updating via package manager",
-    "global install": "Installing global package",
-};
-const UPDATE_QUIPS = [
-    "Leveled up! New skills unlocked. You're welcome.",
-    "Fresh code, same table. Miss me?",
-    "Back and better. Did you even notice I was gone?",
-    "Update complete. I learned some new tricks while I was out.",
-    "Upgraded! Now with 23% more sass.",
-    "I've evolved. Try to keep up.",
-    "New version, who dis? Oh right, still me but shinier.",
-    "Patched, polished, and ready to break. Let's go.",
-    "New rack, new game. Sharper shots, cleaner breaks.",
-    "Update done! Check the changelog or just trust me, it's good.",
-    "Re-racked from the depths of npm. Stronger now.",
-    "I went away and came back smarter. You should try it sometime.",
-    "Update complete. The bugs feared me, so they left.",
-    "New version installed. Old version sends its regards.",
-    "Firmware fresh. Brain wrinkles: increased.",
-    "I've seen things you wouldn't believe. Anyway, I'm updated.",
-    "Back online. The changelog is long but our friendship is longer.",
-    "Upgraded! Peter fixed stuff. Blame him if it breaks.",
-    "Re-racked and ready. Please don't look at my last game.",
-    "Version bump! Same chaos energy, fewer crashes (probably).",
-];
-const MAX_LOG_CHARS = 8000;
-const DEFAULT_PACKAGE_NAME = "poolbot";
-const CORE_PACKAGE_NAMES = new Set([DEFAULT_PACKAGE_NAME]);
-const CLI_NAME = resolveCliName();
-const CLAWDBOT_REPO_URL = "https://github.com/poolbot/poolbot.git";
-function normalizeTag(value) {
-    if (!value) {
-        return null;
-    }
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return null;
-    }
-    if (trimmed.startsWith("poolbot@")) {
-        return trimmed.slice("poolbot@".length);
-    }
-    if (trimmed.startsWith(`${DEFAULT_PACKAGE_NAME}@`)) {
-        return trimmed.slice(`${DEFAULT_PACKAGE_NAME}@`.length);
-    }
-    return trimmed;
-}
-function pickUpdateQuip() {
-    return UPDATE_QUIPS[Math.floor(Math.random() * UPDATE_QUIPS.length)] ?? "Update complete.";
-}
-function normalizeVersionTag(tag) {
-    const trimmed = tag.trim();
-    if (!trimmed) {
-        return null;
-    }
-    const cleaned = trimmed.startsWith("v") ? trimmed.slice(1) : trimmed;
-    return parseSemver(cleaned) ? cleaned : null;
-}
-async function readPackageVersion(root) {
-    try {
-        const raw = await fs.readFile(path.join(root, "package.json"), "utf-8");
-        const parsed = JSON.parse(raw);
-        return typeof parsed.version === "string" ? parsed.version : null;
-    }
-    catch {
-        return null;
-    }
-}
-async function resolveTargetVersion(tag, timeoutMs) {
-    const direct = normalizeVersionTag(tag);
-    if (direct) {
-        return direct;
-    }
-    const res = await fetchNpmTagVersion({ tag, timeoutMs });
-    return res.version ?? null;
-}
-async function isGitCheckout(root) {
-    try {
-        await fs.stat(path.join(root, ".git"));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function readPackageName(root) {
-    try {
-        const raw = await fs.readFile(path.join(root, "package.json"), "utf-8");
-        const parsed = JSON.parse(raw);
-        const name = parsed?.name?.trim();
-        return name ? name : null;
-    }
-    catch {
-        return null;
-    }
-}
-async function isCorePackage(root) {
-    const name = await readPackageName(root);
-    return Boolean(name && CORE_PACKAGE_NAMES.has(name));
-}
-async function tryWriteCompletionCache(root, jsonMode) {
-    try {
-        const binPath = path.join(root, "poolbot.mjs");
-        if (!(await pathExists(binPath))) {
-            return;
-        }
-        const result = spawnSync(resolveNodeRunner(), [binPath, "completion", "--write-state"], {
-            cwd: root,
-            env: process.env,
-            encoding: "utf-8",
-        });
-        if (result.error) {
-            if (!jsonMode) {
-                defaultRuntime.log(theme.warn(`Completion cache update failed: ${String(result.error)}`));
-            }
-            return;
-        }
-        if (result.status !== 0 && !jsonMode) {
-            const stderr = (result.stderr ?? "").toString().trim();
-            const detail = stderr ? ` (${stderr})` : "";
-            defaultRuntime.log(theme.warn(`Completion cache update failed${detail}.`));
-        }
-    }
-    catch {
-        // completion-cli module may not exist yet; silently ignore
-    }
-}
-/** Check if shell completion is installed and prompt user to install if not. */
-async function tryInstallShellCompletion(opts) {
-    if (opts.jsonMode || !process.stdin.isTTY) {
-        return;
-    }
-    try {
-        const { checkShellCompletionStatus, ensureCompletionCacheExists } = await import("../commands/doctor-completion.js");
-        const status = await checkShellCompletionStatus(CLI_NAME);
-        // Profile uses slow dynamic pattern - upgrade to cached version
-        if (status.usesSlowPattern) {
-            defaultRuntime.log(theme.muted("Upgrading shell completion to cached version..."));
-            // Ensure cache exists first
-            const cacheGenerated = await ensureCompletionCacheExists(CLI_NAME);
-            if (cacheGenerated) {
-                try {
-                    const { installCompletion } = await import("./completion-cli.js");
-                    await installCompletion(status.shell, true, CLI_NAME);
-                }
-                catch {
-                    // completion-cli module may not exist yet
-                }
-            }
-            return;
-        }
-        // Profile has completion but no cache - auto-fix silently
-        if (status.profileInstalled && !status.cacheExists) {
-            defaultRuntime.log(theme.muted("Regenerating shell completion cache..."));
-            await ensureCompletionCacheExists(CLI_NAME);
-            return;
-        }
-        // No completion at all - prompt to install
-        if (!status.profileInstalled) {
-            defaultRuntime.log("");
-            defaultRuntime.log(theme.heading("Shell completion"));
-            const shouldInstall = await confirm({
-                message: stylePromptMessage(`Enable ${status.shell} shell completion for ${CLI_NAME}?`),
-                initialValue: true,
-            });
-            if (isCancel(shouldInstall) || !shouldInstall) {
-                if (!opts.skipPrompt) {
-                    defaultRuntime.log(theme.muted(`Skipped. Run \`${replaceCliName(formatCliCommand("poolbot completion --install"), CLI_NAME)}\` later to enable.`));
-                }
-                return;
-            }
-            // Generate cache first (required for fast shell startup)
-            const cacheGenerated = await ensureCompletionCacheExists(CLI_NAME);
-            if (!cacheGenerated) {
-                defaultRuntime.log(theme.warn("Failed to generate completion cache."));
-                return;
-            }
-            try {
-                const { installCompletion } = await import("./completion-cli.js");
-                await installCompletion(status.shell, opts.skipPrompt, CLI_NAME);
-            }
-            catch {
-                // completion-cli module may not exist yet
-            }
-        }
-    }
-    catch {
-        // doctor-completion module may not exist yet; silently ignore
-    }
-}
-async function isEmptyDir(targetPath) {
-    try {
-        const entries = await fs.readdir(targetPath);
-        return entries.length === 0;
-    }
-    catch {
-        return false;
-    }
-}
-function resolveGitInstallDir() {
-    const override = (process.env.POOLBOT_GIT_DIR ?? process.env.CLAWDBOT_GIT_DIR)?.trim();
-    if (override) {
-        return path.resolve(override);
-    }
-    return resolveDefaultGitDir();
-}
-function resolveDefaultGitDir() {
-    return resolveStateDir(process.env, os.homedir);
-}
-function resolveNodeRunner() {
-    const base = path.basename(process.execPath).toLowerCase();
-    if (base === "node" || base === "node.exe") {
-        return process.execPath;
-    }
-    return "node";
-}
-async function runUpdateStep(params) {
-    const command = params.argv.join(" ");
-    params.progress?.onStepStart?.({
-        name: params.name,
-        command,
-        index: 0,
-        total: 0,
-    });
-    const started = Date.now();
-    const res = await runCommandWithTimeout(params.argv, {
-        cwd: params.cwd,
-        timeoutMs: params.timeoutMs,
-    });
-    const durationMs = Date.now() - started;
-    const stderrTail = trimLogTail(res.stderr, MAX_LOG_CHARS);
-    params.progress?.onStepComplete?.({
-        name: params.name,
-        command,
-        index: 0,
-        total: 0,
-        durationMs,
-        exitCode: res.code,
-        stderrTail,
-    });
-    return {
-        name: params.name,
-        command,
-        cwd: params.cwd ?? process.cwd(),
-        durationMs,
-        exitCode: res.code,
-        stdoutTail: trimLogTail(res.stdout, MAX_LOG_CHARS),
-        stderrTail,
-    };
-}
-async function ensureGitCheckout(params) {
-    const dirExists = await pathExists(params.dir);
-    if (!dirExists) {
-        return await runUpdateStep({
-            name: "git clone",
-            argv: ["git", "clone", CLAWDBOT_REPO_URL, params.dir],
-            timeoutMs: params.timeoutMs,
-            progress: params.progress,
-        });
-    }
-    if (!(await isGitCheckout(params.dir))) {
-        const empty = await isEmptyDir(params.dir);
-        if (!empty) {
-            throw new Error(`POOLBOT_GIT_DIR points at a non-git directory: ${params.dir}. Set POOLBOT_GIT_DIR to an empty folder or a poolbot checkout.`);
-        }
-        return await runUpdateStep({
-            name: "git clone",
-            argv: ["git", "clone", CLAWDBOT_REPO_URL, params.dir],
-            cwd: params.dir,
-            timeoutMs: params.timeoutMs,
-            progress: params.progress,
-        });
-    }
-    if (!(await isCorePackage(params.dir))) {
-        throw new Error(`POOLBOT_GIT_DIR does not look like a core checkout: ${params.dir}.`);
-    }
-    return null;
-}
-async function resolveGlobalManager(params) {
-    const runCommand = async (argv, options) => {
-        const res = await runCommandWithTimeout(argv, options);
-        return { stdout: res.stdout, stderr: res.stderr, code: res.code };
-    };
-    if (params.installKind === "package") {
-        const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, params.timeoutMs);
-        if (detected) {
-            return detected;
-        }
-    }
-    const byPresence = await detectGlobalInstallManagerByPresence(runCommand, params.timeoutMs);
-    return byPresence ?? "npm";
-}
-function formatGitStatusLine(params) {
-    const shortSha = params.sha ? params.sha.slice(0, 8) : null;
-    const branch = params.branch && params.branch !== "HEAD" ? params.branch : null;
-    const tag = params.tag;
-    const parts = [
-        branch ?? (tag ? "detached" : "git"),
-        tag ? `tag ${tag}` : null,
-        shortSha ? `@ ${shortSha}` : null,
-    ].filter(Boolean);
-    return parts.join(" · ");
-}
-export async function updateStatusCommand(opts) {
-    const timeoutMs = opts.timeout ? Number.parseInt(opts.timeout, 10) * 1000 : undefined;
-    if (timeoutMs !== undefined && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
-        defaultRuntime.error("--timeout must be a positive integer (seconds)");
-        defaultRuntime.exit(1);
-        return;
-    }
-    const root = (await resolvePoolBotPackageRoot({
-        moduleUrl: import.meta.url,
-        argv1: process.argv[1],
-        cwd: process.cwd(),
-    })) ?? process.cwd();
-    const configSnapshot = await readConfigFileSnapshot();
-    const configChannel = configSnapshot.valid
-        ? normalizeUpdateChannel(configSnapshot.config.update?.channel)
-        : null;
-    const update = await checkUpdateStatus({
-        root,
-        timeoutMs: timeoutMs ?? 3500,
-        fetchGit: true,
-        includeRegistry: true,
-    });
-    const channelInfo = resolveEffectiveUpdateChannel({
-        configChannel,
-        installKind: update.installKind,
-        git: update.git ? { tag: update.git.tag, branch: update.git.branch } : undefined,
-    });
-    const channelLabel = formatUpdateChannelLabel({
-        channel: channelInfo.channel,
-        source: channelInfo.source,
-        gitTag: update.git?.tag ?? null,
-        gitBranch: update.git?.branch ?? null,
-    });
-    const gitLabel = update.installKind === "git"
-        ? formatGitStatusLine({
-            branch: update.git?.branch ?? null,
-            tag: update.git?.tag ?? null,
-            sha: update.git?.sha ?? null,
-        })
-        : null;
-    const updateAvailability = resolveUpdateAvailability(update);
-    const updateLine = formatUpdateOneLiner(update).replace(/^Update:\s*/i, "");
-    if (opts.json) {
-        defaultRuntime.log(JSON.stringify({
-            update,
-            channel: {
-                value: channelInfo.channel,
-                source: channelInfo.source,
-                label: channelLabel,
-                config: configChannel,
-            },
-            availability: updateAvailability,
-        }, null, 2));
-        return;
-    }
-    const tableWidth = Math.max(60, (process.stdout.columns ?? 120) - 1);
-    const installLabel = update.installKind === "git"
-        ? `git (${update.root ?? "unknown"})`
-        : update.installKind === "package"
-            ? update.packageManager
-            : "unknown";
-    const rows = [
-        { Item: "Install", Value: installLabel },
-        { Item: "Channel", Value: channelLabel },
-        ...(gitLabel ? [{ Item: "Git", Value: gitLabel }] : []),
-        {
-            Item: "Update",
-            Value: updateAvailability.available ? theme.warn(`available · ${updateLine}`) : updateLine,
-        },
-    ];
-    defaultRuntime.log(theme.heading("PoolBot update status"));
-    defaultRuntime.log("");
-    defaultRuntime.log(renderTable({
-        width: tableWidth,
-        columns: [
-            { key: "Item", header: "Item", minWidth: 10 },
-            { key: "Value", header: "Value", flex: true, minWidth: 24 },
-        ],
-        rows,
-    }).trimEnd());
-    defaultRuntime.log("");
-    const updateHint = formatUpdateAvailableHint(update);
-    if (updateHint) {
-        defaultRuntime.log(theme.warn(updateHint));
-    }
-}
-function getStepLabel(step) {
-    return STEP_LABELS[step.name] ?? step.name;
-}
-function createUpdateProgress(enabled) {
-    if (!enabled) {
-        return {
-            progress: {},
-            stop: () => { },
-        };
-    }
-    let currentSpinner = null;
-    const progress = {
-        onStepStart: (step) => {
-            currentSpinner = spinner();
-            currentSpinner.start(theme.accent(getStepLabel(step)));
-        },
-        onStepComplete: (step) => {
-            if (!currentSpinner) {
-                return;
-            }
-            const label = getStepLabel(step);
-            const duration = theme.muted(`(${formatDurationPrecise(step.durationMs)})`);
-            const icon = step.exitCode === 0 ? theme.success("\u2713") : theme.error("\u2717");
-            currentSpinner.stop(`${icon} ${label} ${duration}`);
-            currentSpinner = null;
-            if (step.exitCode !== 0 && step.stderrTail) {
-                const lines = step.stderrTail.split("\n").slice(-10);
-                for (const line of lines) {
-                    if (line.trim()) {
-                        defaultRuntime.log(`    ${theme.error(line)}`);
-                    }
-                }
-            }
-        },
-    };
-    return {
-        progress,
-        stop: () => {
-            if (currentSpinner) {
-                currentSpinner.stop();
-                currentSpinner = null;
-            }
-        },
-    };
-}
-function formatStepStatus(exitCode) {
-    if (exitCode === 0) {
-        return theme.success("\u2713");
-    }
-    if (exitCode === null) {
-        return theme.warn("?");
-    }
-    return theme.error("\u2717");
-}
-const selectStyled = (params) => select({
-    ...params,
-    message: stylePromptMessage(params.message),
-    options: params.options.map((opt) => opt.hint === undefined ? opt : { ...opt, hint: stylePromptHint(opt.hint) }),
-});
-function printResult(result, opts) {
-    if (opts.json) {
-        defaultRuntime.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    const statusColor = result.status === "ok" ? theme.success : result.status === "skipped" ? theme.warn : theme.error;
-    defaultRuntime.log("");
-    defaultRuntime.log(`${theme.heading("Update Result:")} ${statusColor(result.status.toUpperCase())}`);
-    if (result.root) {
-        defaultRuntime.log(`  Root: ${theme.muted(result.root)}`);
-    }
-    if (result.reason) {
-        defaultRuntime.log(`  Reason: ${theme.muted(result.reason)}`);
-    }
-    if (result.before?.version || result.before?.sha) {
-        const before = result.before.version ?? result.before.sha?.slice(0, 8) ?? "";
-        defaultRuntime.log(`  Before: ${theme.muted(before)}`);
-    }
-    if (result.after?.version || result.after?.sha) {
-        const after = result.after.version ?? result.after.sha?.slice(0, 8) ?? "";
-        defaultRuntime.log(`  After: ${theme.muted(after)}`);
-    }
-    if (!opts.hideSteps && result.steps.length > 0) {
-        defaultRuntime.log("");
-        defaultRuntime.log(theme.heading("Steps:"));
-        for (const step of result.steps) {
-            const status = formatStepStatus(step.exitCode);
-            const duration = theme.muted(`(${formatDurationPrecise(step.durationMs)})`);
-            defaultRuntime.log(`  ${status} ${step.name} ${duration}`);
-            if (step.exitCode !== 0 && step.stderrTail) {
-                const lines = step.stderrTail.split("\n").slice(0, 5);
-                for (const line of lines) {
-                    if (line.trim()) {
-                        defaultRuntime.log(`      ${theme.error(line)}`);
-                    }
-                }
-            }
-        }
-    }
-    defaultRuntime.log("");
-    defaultRuntime.log(`Total time: ${theme.muted(formatDurationPrecise(result.durationMs))}`);
-}
-export async function updateCommand(opts) {
-    process.noDeprecation = true;
-    process.env.NODE_NO_WARNINGS = "1";
-    const timeoutMs = opts.timeout ? Number.parseInt(opts.timeout, 10) * 1000 : undefined;
-    const shouldRestart = opts.restart !== false;
-    if (timeoutMs !== undefined && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
-        defaultRuntime.error("--timeout must be a positive integer (seconds)");
-        defaultRuntime.exit(1);
-        return;
-    }
-    const root = (await resolvePoolBotPackageRoot({
-        moduleUrl: import.meta.url,
-        argv1: process.argv[1],
-        cwd: process.cwd(),
-    })) ?? process.cwd();
-    const updateStatus = await checkUpdateStatus({
-        root,
-        timeoutMs: timeoutMs ?? 3500,
-        fetchGit: false,
-        includeRegistry: false,
-    });
-    const configSnapshot = await readConfigFileSnapshot();
-    let activeConfig = configSnapshot.valid ? configSnapshot.config : null;
-    const storedChannel = configSnapshot.valid
-        ? normalizeUpdateChannel(configSnapshot.config.update?.channel)
-        : null;
-    const requestedChannel = normalizeUpdateChannel(opts.channel);
-    if (opts.channel && !requestedChannel) {
-        defaultRuntime.error(`--channel must be "stable", "beta", or "dev" (got "${opts.channel}")`);
-        defaultRuntime.exit(1);
-        return;
-    }
-    if (opts.channel && !configSnapshot.valid) {
-        const issues = configSnapshot.issues.map((issue) => `- ${issue.path}: ${issue.message}`);
-        defaultRuntime.error(["Config is invalid; cannot set update channel.", ...issues].join("\n"));
-        defaultRuntime.exit(1);
-        return;
-    }
-    const installKind = updateStatus.installKind;
-    const switchToGit = requestedChannel === "dev" && installKind !== "git";
-    const switchToPackage = requestedChannel !== null && requestedChannel !== "dev" && installKind === "git";
-    const updateInstallKind = switchToGit ? "git" : switchToPackage ? "package" : installKind;
-    const defaultChannel = updateInstallKind === "git" ? DEFAULT_GIT_CHANNEL : DEFAULT_PACKAGE_CHANNEL;
-    const channel = requestedChannel ?? storedChannel ?? defaultChannel;
-    const explicitTag = normalizeTag(opts.tag);
-    let tag = explicitTag ?? channelToNpmTag(channel);
-    if (updateInstallKind !== "git") {
-        const currentVersion = switchToPackage ? null : await readPackageVersion(root);
-        let fallbackToLatest = false;
-        const targetVersion = explicitTag
-            ? await resolveTargetVersion(tag, timeoutMs)
-            : await resolveNpmChannelTag({ channel, timeoutMs }).then((resolved) => {
-                tag = resolved.tag;
-                fallbackToLatest = channel === "beta" && resolved.tag === "latest";
-                return resolved.version;
-            });
-        const cmp = currentVersion && targetVersion ? compareSemverStrings(currentVersion, targetVersion) : null;
-        const needsConfirm = !fallbackToLatest &&
-            currentVersion != null &&
-            (targetVersion == null || (cmp != null && cmp > 0));
-        if (needsConfirm && !opts.yes) {
-            if (!process.stdin.isTTY || opts.json) {
-                defaultRuntime.error([
-                    "Downgrade confirmation required.",
-                    "Downgrading can break configuration. Re-run in a TTY to confirm.",
-                ].join("\n"));
-                defaultRuntime.exit(1);
-                return;
-            }
-            const targetLabel = targetVersion ?? `${tag} (unknown)`;
-            const message = `Downgrading from ${currentVersion} to ${targetLabel} can break configuration. Continue?`;
-            const ok = await confirm({
-                message: stylePromptMessage(message),
-                initialValue: false,
-            });
-            if (isCancel(ok) || !ok) {
-                if (!opts.json) {
-                    defaultRuntime.log(theme.muted("Update cancelled."));
-                }
-                defaultRuntime.exit(0);
-                return;
-            }
-        }
-    }
-    else if (opts.tag && !opts.json) {
-        defaultRuntime.log(theme.muted("Note: --tag applies to npm installs only; git updates ignore it."));
-    }
-    if (requestedChannel && configSnapshot.valid) {
-        const next = {
-            ...configSnapshot.config,
-            update: {
-                ...configSnapshot.config.update,
-                channel: requestedChannel,
-            },
-        };
-        await writeConfigFile(next);
-        activeConfig = next;
-        if (!opts.json) {
-            defaultRuntime.log(theme.muted(`Update channel set to ${requestedChannel}.`));
-        }
-    }
-    const showProgress = !opts.json && process.stdout.isTTY;
-    if (!opts.json) {
-        defaultRuntime.log(theme.heading("Updating PoolBot..."));
-        defaultRuntime.log("");
-    }
-    const { progress, stop } = createUpdateProgress(showProgress);
-    const startedAt = Date.now();
-    let result;
-    if (switchToPackage) {
-        const manager = await resolveGlobalManager({
-            root,
-            installKind,
-            timeoutMs: timeoutMs ?? 20 * 60_000,
-        });
-        const runCommand = async (argv, options) => {
-            const res = await runCommandWithTimeout(argv, options);
-            return { stdout: res.stdout, stderr: res.stderr, code: res.code };
-        };
-        const pkgRoot = await resolveGlobalPackageRoot(manager, runCommand, timeoutMs ?? 20 * 60_000);
-        const packageName = (pkgRoot ? await readPackageName(pkgRoot) : await readPackageName(root)) ??
-            DEFAULT_PACKAGE_NAME;
-        const beforeVersion = pkgRoot ? await readPackageVersion(pkgRoot) : null;
-        if (pkgRoot) {
-            await cleanupGlobalRenameDirs({
-                globalRoot: path.dirname(pkgRoot),
-                packageName,
-            });
-        }
-        const updateStep = await runUpdateStep({
-            name: "global update",
-            argv: globalInstallArgs(manager, `${packageName}@${tag}`),
-            timeoutMs: timeoutMs ?? 20 * 60_000,
-            progress,
-        });
-        const steps = [updateStep];
-        let afterVersion = beforeVersion;
-        if (pkgRoot) {
-            afterVersion = await readPackageVersion(pkgRoot);
-            const entryPath = path.join(pkgRoot, "dist", "entry.js");
-            if (await pathExists(entryPath)) {
-                const doctorStep = await runUpdateStep({
-                    name: `${CLI_NAME} doctor`,
-                    argv: [resolveNodeRunner(), entryPath, "doctor", "--non-interactive"],
-                    timeoutMs: timeoutMs ?? 20 * 60_000,
-                    progress,
-                });
-                steps.push(doctorStep);
-            }
-        }
-        const failedStep = steps.find((step) => step.exitCode !== 0);
-        result = {
-            status: failedStep ? "error" : "ok",
-            mode: manager,
-            root: pkgRoot ?? root,
-            reason: failedStep ? failedStep.name : undefined,
-            before: { version: beforeVersion },
-            after: { version: afterVersion },
-            steps,
-            durationMs: Date.now() - startedAt,
-        };
-    }
-    else {
-        const updateRoot = switchToGit ? resolveGitInstallDir() : root;
-        const cloneStep = switchToGit
-            ? await ensureGitCheckout({
-                dir: updateRoot,
-                timeoutMs: timeoutMs ?? 20 * 60_000,
-                progress,
-            })
-            : null;
-        if (cloneStep && cloneStep.exitCode !== 0) {
-            result = {
-                status: "error",
-                mode: "git",
-                root: updateRoot,
-                reason: cloneStep.name,
-                steps: [cloneStep],
-                durationMs: Date.now() - startedAt,
-            };
-            stop();
-            printResult(result, { ...opts, hideSteps: showProgress });
-            defaultRuntime.exit(1);
-            return;
-        }
-        const updateResult = await runGatewayUpdate({
-            cwd: updateRoot,
-            argv1: switchToGit ? undefined : process.argv[1],
-            timeoutMs,
-            progress,
-            channel,
-            tag,
-        });
-        const steps = [...(cloneStep ? [cloneStep] : []), ...updateResult.steps];
-        if (switchToGit && updateResult.status === "ok") {
-            const manager = await resolveGlobalManager({
-                root,
-                installKind,
-                timeoutMs: timeoutMs ?? 20 * 60_000,
-            });
-            const installStep = await runUpdateStep({
-                name: "global install",
-                argv: globalInstallArgs(manager, updateRoot),
-                cwd: updateRoot,
-                timeoutMs: timeoutMs ?? 20 * 60_000,
-                progress,
-            });
-            steps.push(installStep);
-            const failedStep = [installStep].find((step) => step.exitCode !== 0);
-            result = {
-                ...updateResult,
-                status: updateResult.status === "ok" && !failedStep ? "ok" : "error",
-                steps,
-                durationMs: Date.now() - startedAt,
-            };
-        }
-        else {
-            result = {
-                ...updateResult,
-                steps,
-                durationMs: Date.now() - startedAt,
-            };
-        }
-    }
-    stop();
-    printResult(result, { ...opts, hideSteps: showProgress });
-    if (result.status === "error") {
-        defaultRuntime.exit(1);
-        return;
-    }
-    if (result.status === "skipped") {
-        if (result.reason === "dirty") {
-            defaultRuntime.log(theme.warn("Skipped: working directory has uncommitted changes. Commit or stash them first."));
-        }
-        if (result.reason === "not-git-install") {
-            defaultRuntime.log(theme.warn(`Skipped: this PoolBot install isn't a git checkout, and the package manager couldn't be detected. Update via your package manager, then run \`${replaceCliName(formatCliCommand("poolbot doctor"), CLI_NAME)}\` and \`${replaceCliName(formatCliCommand("poolbot gateway restart"), CLI_NAME)}\`.`));
-            defaultRuntime.log(theme.muted(`Examples: \`${replaceCliName("npm i -g poolbot@latest", CLI_NAME)}\` or \`${replaceCliName("pnpm add -g poolbot@latest", CLI_NAME)}\``));
-        }
-        defaultRuntime.exit(0);
-        return;
-    }
-    if (activeConfig) {
-        const pluginLogger = opts.json
-            ? {}
-            : {
-                info: (msg) => defaultRuntime.log(msg),
-                warn: (msg) => defaultRuntime.log(theme.warn(msg)),
-                error: (msg) => defaultRuntime.log(theme.error(msg)),
-            };
-        if (!opts.json) {
-            defaultRuntime.log("");
-            defaultRuntime.log(theme.heading("Updating plugins..."));
-        }
-        const syncResult = await syncPluginsForUpdateChannel({
-            config: activeConfig,
-            channel,
-            workspaceDir: root,
-            logger: pluginLogger,
-        });
-        let pluginConfig = syncResult.config;
-        const npmResult = await updateNpmInstalledPlugins({
-            config: pluginConfig,
-            skipIds: new Set(syncResult.summary.switchedToNpm),
-            logger: pluginLogger,
-        });
-        pluginConfig = npmResult.config;
-        if (syncResult.changed || npmResult.changed) {
-            await writeConfigFile(pluginConfig);
-        }
-        if (!opts.json) {
-            const summarizeList = (list) => {
-                if (list.length <= 6) {
-                    return list.join(", ");
-                }
-                return `${list.slice(0, 6).join(", ")} +${list.length - 6} more`;
-            };
-            if (syncResult.summary.switchedToBundled.length > 0) {
-                defaultRuntime.log(theme.muted(`Switched to bundled plugins: ${summarizeList(syncResult.summary.switchedToBundled)}.`));
-            }
-            if (syncResult.summary.switchedToNpm.length > 0) {
-                defaultRuntime.log(theme.muted(`Restored npm plugins: ${summarizeList(syncResult.summary.switchedToNpm)}.`));
-            }
-            for (const warning of syncResult.summary.warnings) {
-                defaultRuntime.log(theme.warn(warning));
-            }
-            for (const error of syncResult.summary.errors) {
-                defaultRuntime.log(theme.error(error));
-            }
-            const updated = npmResult.outcomes.filter((entry) => entry.status === "updated").length;
-            const unchanged = npmResult.outcomes.filter((entry) => entry.status === "unchanged").length;
-            const failed = npmResult.outcomes.filter((entry) => entry.status === "error").length;
-            const skipped = npmResult.outcomes.filter((entry) => entry.status === "skipped").length;
-            if (npmResult.outcomes.length === 0) {
-                defaultRuntime.log(theme.muted("No plugin updates needed."));
-            }
-            else {
-                const parts = [`${updated} updated`, `${unchanged} unchanged`];
-                if (failed > 0) {
-                    parts.push(`${failed} failed`);
-                }
-                if (skipped > 0) {
-                    parts.push(`${skipped} skipped`);
-                }
-                defaultRuntime.log(theme.muted(`npm plugins: ${parts.join(", ")}.`));
-            }
-            for (const outcome of npmResult.outcomes) {
-                if (outcome.status !== "error") {
-                    continue;
-                }
-                defaultRuntime.log(theme.error(outcome.message));
-            }
-        }
-    }
-    else if (!opts.json) {
-        defaultRuntime.log(theme.warn("Skipping plugin updates: config is invalid."));
-    }
-    await tryWriteCompletionCache(root, Boolean(opts.json));
-    // Offer to install shell completion if not already installed
-    await tryInstallShellCompletion({
-        jsonMode: Boolean(opts.json),
-        skipPrompt: Boolean(opts.yes),
-    });
-    // Restart service if requested
-    if (shouldRestart) {
-        if (!opts.json) {
-            defaultRuntime.log("");
-            defaultRuntime.log(theme.heading("Restarting service..."));
-        }
-        try {
-            const restarted = await runDaemonRestart();
-            if (!opts.json && restarted) {
-                defaultRuntime.log(theme.success("Daemon restarted successfully."));
-                defaultRuntime.log("");
-                process.env.POOLBOT_UPDATE_IN_PROGRESS = "1";
-                process.env.CLAWDBOT_UPDATE_IN_PROGRESS = "1";
-                try {
-                    const interactiveDoctor = Boolean(process.stdin.isTTY) && !opts.json && opts.yes !== true;
-                    await doctorCommand(defaultRuntime, {
-                        nonInteractive: !interactiveDoctor,
-                    });
-                }
-                catch (err) {
-                    defaultRuntime.log(theme.warn(`Doctor failed: ${String(err)}`));
-                }
-                finally {
-                    delete process.env.POOLBOT_UPDATE_IN_PROGRESS;
-                    delete process.env.CLAWDBOT_UPDATE_IN_PROGRESS;
-                }
-            }
-        }
-        catch (err) {
-            if (!opts.json) {
-                defaultRuntime.log(theme.warn(`Daemon restart failed: ${String(err)}`));
-                defaultRuntime.log(theme.muted(`You may need to restart the service manually: ${replaceCliName(formatCliCommand("poolbot gateway restart"), CLI_NAME)}`));
-            }
-        }
-    }
-    else if (!opts.json) {
-        defaultRuntime.log("");
-        if (result.mode === "npm" || result.mode === "pnpm") {
-            defaultRuntime.log(theme.muted(`Tip: Run \`${replaceCliName(formatCliCommand("poolbot doctor"), CLI_NAME)}\`, then \`${replaceCliName(formatCliCommand("poolbot gateway restart"), CLI_NAME)}\` to apply updates to a running gateway.`));
-        }
-        else {
-            defaultRuntime.log(theme.muted(`Tip: Run \`${replaceCliName(formatCliCommand("poolbot gateway restart"), CLI_NAME)}\` to apply updates to a running gateway.`));
-        }
-    }
-    if (!opts.json) {
-        defaultRuntime.log(theme.muted(pickUpdateQuip()));
-    }
+import { updateStatusCommand } from "./update-cli/status.js";
+import { updateCommand } from "./update-cli/update-command.js";
+import { updateWizardCommand } from "./update-cli/wizard.js";
+export { updateCommand, updateStatusCommand, updateWizardCommand };
+function inheritedUpdateJson(command) {
+    return Boolean(inheritOptionFromParent(command, "json"));
 }
-export async function updateWizardCommand(opts = {}) {
-    if (!process.stdin.isTTY) {
-        defaultRuntime.error("Update wizard requires a TTY. Use `poolbot update --channel <stable|beta|dev>` instead.");
-        defaultRuntime.exit(1);
-        return;
-    }
-    const timeoutMs = opts.timeout ? Number.parseInt(opts.timeout, 10) * 1000 : undefined;
-    if (timeoutMs !== undefined && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
-        defaultRuntime.error("--timeout must be a positive integer (seconds)");
-        defaultRuntime.exit(1);
-        return;
-    }
-    const root = (await resolvePoolBotPackageRoot({
-        moduleUrl: import.meta.url,
-        argv1: process.argv[1],
-        cwd: process.cwd(),
-    })) ?? process.cwd();
-    const [updateStatus, configSnapshot] = await Promise.all([
-        checkUpdateStatus({
-            root,
-            timeoutMs: timeoutMs ?? 3500,
-            fetchGit: false,
-            includeRegistry: false,
-        }),
-        readConfigFileSnapshot(),
-    ]);
-    const configChannel = configSnapshot.valid
-        ? normalizeUpdateChannel(configSnapshot.config.update?.channel)
-        : null;
-    const channelInfo = resolveEffectiveUpdateChannel({
-        configChannel,
-        installKind: updateStatus.installKind,
-        git: updateStatus.git
-            ? { tag: updateStatus.git.tag, branch: updateStatus.git.branch }
-            : undefined,
-    });
-    const channelLabel = formatUpdateChannelLabel({
-        channel: channelInfo.channel,
-        source: channelInfo.source,
-        gitTag: updateStatus.git?.tag ?? null,
-        gitBranch: updateStatus.git?.branch ?? null,
-    });
-    const pickedChannel = await selectStyled({
-        message: "Update channel",
-        options: [
-            {
-                value: "keep",
-                label: `Keep current (${channelInfo.channel})`,
-                hint: channelLabel,
-            },
-            {
-                value: "stable",
-                label: "Stable",
-                hint: "Tagged releases (npm latest)",
-            },
-            {
-                value: "beta",
-                label: "Beta",
-                hint: "Prereleases (npm beta)",
-            },
-            {
-                value: "dev",
-                label: "Dev",
-                hint: "Git main",
-            },
-        ],
-        initialValue: "keep",
-    });
-    if (isCancel(pickedChannel)) {
-        defaultRuntime.log(theme.muted("Update cancelled."));
-        defaultRuntime.exit(0);
-        return;
-    }
-    const requestedChannel = pickedChannel === "keep" ? null : pickedChannel;
-    if (requestedChannel === "dev" && updateStatus.installKind !== "git") {
-        const gitDir = resolveGitInstallDir();
-        const hasGit = await isGitCheckout(gitDir);
-        if (!hasGit) {
-            const dirExists = await pathExists(gitDir);
-            if (dirExists) {
-                const empty = await isEmptyDir(gitDir);
-                if (!empty) {
-                    defaultRuntime.error(`POOLBOT_GIT_DIR points at a non-git directory: ${gitDir}. Set POOLBOT_GIT_DIR to an empty folder or a poolbot checkout.`);
-                    defaultRuntime.exit(1);
-                    return;
-                }
-            }
-            const ok = await confirm({
-                message: stylePromptMessage(`Create a git checkout at ${gitDir}? (override via POOLBOT_GIT_DIR)`),
-                initialValue: true,
-            });
-            if (isCancel(ok) || !ok) {
-                defaultRuntime.log(theme.muted("Update cancelled."));
-                defaultRuntime.exit(0);
-                return;
-            }
-        }
-    }
-    const restart = await confirm({
-        message: stylePromptMessage("Restart the gateway service after update?"),
-        initialValue: true,
-    });
-    if (isCancel(restart)) {
-        defaultRuntime.log(theme.muted("Update cancelled."));
-        defaultRuntime.exit(0);
-        return;
-    }
-    try {
-        await updateCommand({
-            channel: requestedChannel ?? undefined,
-            restart: Boolean(restart),
-            timeout: opts.timeout,
-        });
-    }
-    catch (err) {
-        defaultRuntime.error(String(err));
-        defaultRuntime.exit(1);
+function inheritedUpdateTimeout(opts, command) {
+    const timeout = opts.timeout;
+    if (timeout) {
+        return timeout;
     }
+    return inheritOptionFromParent(command, "timeout");
 }
 export function registerUpdateCli(program) {
     const update = program
         .command("update")
-        .description("Update PoolBot to the latest version")
+        .description("Update Pool Bot and inspect update channel status")
         .option("--json", "Output result as JSON", false)
         .option("--no-restart", "Skip restarting the gateway service after a successful update")
         .option("--channel <stable|beta|dev>", "Persist update channel (git + npm)")
@@ -1071,7 +65,7 @@ ${theme.heading("Notes:")}
   - Downgrades require confirmation (can break configuration)
   - Skips update if the working directory has uncommitted changes
 
-${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/update")}`;
+${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.poolbot.dev/cli/update")}`;
     })
         .action(async (opts) => {
         try {
@@ -1093,11 +87,11 @@ ${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/updat
         .command("wizard")
         .description("Interactive update wizard")
         .option("--timeout <seconds>", "Timeout for each update step in seconds (default: 1200)")
-        .addHelpText("after", `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/update")}\n`)
-        .action(async (opts) => {
+        .addHelpText("after", `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.poolbot.dev/cli/update")}\n`)
+        .action(async (opts, command) => {
         try {
             await updateWizardCommand({
-                timeout: opts.timeout,
+                timeout: inheritedUpdateTimeout(opts, command),
             });
         }
         catch (err) {
@@ -1114,12 +108,12 @@ ${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/updat
         ["poolbot update status", "Show channel + version status."],
         ["poolbot update status --json", "JSON output."],
         ["poolbot update status --timeout 10", "Custom timeout."],
-    ])}\n\n${theme.heading("Notes:")}\n${theme.muted("- Shows current update channel (stable/beta/dev) and source")}\n${theme.muted("- Includes git tag/branch/SHA for source checkouts")}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/update")}`)
-        .action(async (opts) => {
+    ])}\n\n${theme.heading("Notes:")}\n${theme.muted("- Shows current update channel (stable/beta/dev) and source")}\n${theme.muted("- Includes git tag/branch/SHA for source checkouts")}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.poolbot.dev/cli/update")}`)
+        .action(async (opts, command) => {
         try {
             await updateStatusCommand({
-                json: Boolean(opts.json),
-                timeout: opts.timeout,
+                json: Boolean(opts.json) || inheritedUpdateJson(command),
+                timeout: inheritedUpdateTimeout(opts, command),
             });
         }
         catch (err) {