@poolzin/pool-bot 2026.1.39 → 2026.2.1

package/dist/cli/security-cli.js

@@ -45,7 +45,7 @@ export function registerSecurityCli(program) {
         const heading = (text) => (rich ? theme.heading(text) : text);
         const muted = (text) => (rich ? theme.muted(text) : text);
         const lines = [];
-        lines.push(heading("Moltbot security audit"));
+        lines.push(heading("Poolbot security audit"));
         lines.push(muted(`Summary: ${formatSummary(report.summary)}`));
         lines.push(muted(`Run deeper: ${formatCliCommand("poolbot security audit --deep")}`));
         if (opts.fix) {

package/dist/cli/tagline.js

@@ -1,4 +1,4 @@
-const DEFAULT_TAGLINE = "All your chats, one Moltbot.";
+const DEFAULT_TAGLINE = "All your chats, one Poolbot.";
 const HOLIDAY_TAGLINES = {
     newYear: "New Year's Day: New year, new config—same old EADDRINUSE, but this time we resolve it like grown-ups.",
     lunarNewYear: "Lunar New Year: May your builds be lucky, your branches prosperous, and your merge conflicts chased away with fireworks.",

package/dist/cli/update-cli.js

@@ -1,26 +1,32 @@
 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 { checkUpdateStatus, compareSemverStrings, fetchNpmTagVersion, resolveNpmChannelTag, } from "../infra/update-check.js";
+import { trimLogTail } from "../infra/restart-sentinel.js";
 import { parseSemver } from "../infra/runtime-guard.js";
-import { runGatewayUpdate, } from "../infra/update-runner.js";
-import { detectGlobalInstallManagerByPresence, detectGlobalInstallManagerForRoot, globalInstallArgs, resolveGlobalPackageRoot, } from "../infra/update-global.js";
 import { channelToNpmTag, DEFAULT_GIT_CHANNEL, DEFAULT_PACKAGE_CHANNEL, formatUpdateChannelLabel, normalizeUpdateChannel, resolveEffectiveUpdateChannel, } from "../infra/update-channels.js";
-import { trimLogTail } from "../infra/restart-sentinel.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 { formatCliCommand } from "./command-format.js";
-import { replaceCliName, resolveCliName } from "./cli-name.js";
 import { stylePromptHint, stylePromptMessage } from "../terminal/prompt-style.js";
-import { theme } from "../terminal/theme.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 { formatHelpExamples } from "./help-format.js";
-import { formatUpdateAvailableHint, formatUpdateOneLiner, resolveUpdateAvailability, } from "../commands/status.update.js";
-import { syncPluginsForUpdateChannel, updateNpmInstalledPlugins } from "../plugins/update.js";
-import { runCommandWithTimeout } from "../process/exec.js";
 const STEP_LABELS = {
     "clean check": "Working directory is clean",
     "upstream check": "Upstream branch exists",
@@ -33,7 +39,10 @@ const STEP_LABELS = {
     "preflight cleanup": "Cleaning preflight worktree",
     "deps install": "Installing dependencies",
     build: "Building",
-    "ui:build": "Building UI",
+    "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",
@@ -63,18 +72,20 @@ const UPDATE_QUIPS = [
 ];
 const MAX_LOG_CHARS = 8000;
 const DEFAULT_PACKAGE_NAME = "poolbot";
-const CORE_PACKAGE_NAMES = new Set([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";
-const DEFAULT_GIT_DIR = path.join(os.homedir(), "poolbot");
 function normalizeTag(value) {
-    if (!value)
+    if (!value) {
         return null;
+    }
     const trimmed = value.trim();
-    if (!trimmed)
+    if (!trimmed) {
         return null;
-    if (trimmed.startsWith("poolbot@"))
+    }
+    if (trimmed.startsWith("poolbot@")) {
         return trimmed.slice("poolbot@".length);
+    }
     if (trimmed.startsWith(`${DEFAULT_PACKAGE_NAME}@`)) {
         return trimmed.slice(`${DEFAULT_PACKAGE_NAME}@`.length);
     }
@@ -85,8 +96,9 @@ function pickUpdateQuip() {
 }
 function normalizeVersionTag(tag) {
     const trimmed = tag.trim();
-    if (!trimmed)
+    if (!trimmed) {
         return null;
+    }
     const cleaned = trimmed.startsWith("v") ? trimmed.slice(1) : trimmed;
     return parseSemver(cleaned) ? cleaned : null;
 }
@@ -102,8 +114,9 @@ async function readPackageVersion(root) {
 }
 async function resolveTargetVersion(tag, timeoutMs) {
     const direct = normalizeVersionTag(tag);
-    if (direct)
+    if (direct) {
         return direct;
+    }
     const res = await fetchNpmTagVersion({ tag, timeoutMs });
     return res.version ?? null;
 }
@@ -131,13 +144,100 @@ async function isCorePackage(root) {
     const name = await readPackageName(root);
     return Boolean(name && CORE_PACKAGE_NAMES.has(name));
 }
-async function pathExists(targetPath) {
+async function tryWriteCompletionCache(root, jsonMode) {
     try {
-        await fs.stat(targetPath);
-        return true;
+        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 {
-        return false;
+        // 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 } = 
+        // @ts-expect-error module may not exist yet
+        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 } = 
+                    // @ts-expect-error module may not exist yet
+                    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 } = 
+                // @ts-expect-error module may not exist yet
+                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) {
@@ -151,14 +251,19 @@ async function isEmptyDir(targetPath) {
 }
 function resolveGitInstallDir() {
     const override = process.env.CLAWDBOT_GIT_DIR?.trim();
-    if (override)
+    if (override) {
         return path.resolve(override);
-    return DEFAULT_GIT_DIR;
+    }
+    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")
+    if (base === "node" || base === "node.exe") {
         return process.execPath;
+    }
     return "node";
 }
 async function runUpdateStep(params) {
@@ -230,8 +335,9 @@ async function resolveGlobalManager(params) {
     };
     if (params.installKind === "package") {
         const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, params.timeoutMs);
-        if (detected)
+        if (detected) {
             return detected;
+        }
     }
     const byPresence = await detectGlobalInstallManagerByPresence(runCommand, params.timeoutMs);
     return byPresence ?? "npm";
@@ -317,7 +423,7 @@ export async function updateStatusCommand(opts) {
             Value: updateAvailability.available ? theme.warn(`available · ${updateLine}`) : updateLine,
         },
     ];
-    defaultRuntime.log(theme.heading("Moltbot update status"));
+    defaultRuntime.log(theme.heading("PoolBot update status"));
     defaultRuntime.log("");
     defaultRuntime.log(renderTable({
         width: tableWidth,
@@ -350,10 +456,11 @@ function createUpdateProgress(enabled) {
             currentSpinner.start(theme.accent(getStepLabel(step)));
         },
         onStepComplete: (step) => {
-            if (!currentSpinner)
+            if (!currentSpinner) {
                 return;
+            }
             const label = getStepLabel(step);
-            const duration = theme.muted(`(${formatDuration(step.durationMs)})`);
+            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;
@@ -377,17 +484,13 @@ function createUpdateProgress(enabled) {
         },
     };
 }
-function formatDuration(ms) {
-    if (ms < 1000)
-        return `${ms}ms`;
-    const seconds = (ms / 1000).toFixed(1);
-    return `${seconds}s`;
-}
 function formatStepStatus(exitCode) {
-    if (exitCode === 0)
+    if (exitCode === 0) {
         return theme.success("\u2713");
-    if (exitCode === null)
+    }
+    if (exitCode === null) {
         return theme.warn("?");
+    }
     return theme.error("\u2717");
 }
 const selectStyled = (params) => select({
@@ -422,7 +525,7 @@ function printResult(result, opts) {
         defaultRuntime.log(theme.heading("Steps:"));
         for (const step of result.steps) {
             const status = formatStepStatus(step.exitCode);
-            const duration = theme.muted(`(${formatDuration(step.durationMs)})`);
+            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);
@@ -435,7 +538,7 @@ function printResult(result, opts) {
         }
     }
     defaultRuntime.log("");
-    defaultRuntime.log(`Total time: ${theme.muted(formatDuration(result.durationMs))}`);
+    defaultRuntime.log(`Total time: ${theme.muted(formatDurationPrecise(result.durationMs))}`);
 }
 export async function updateCommand(opts) {
     process.noDeprecation = true;
@@ -512,7 +615,7 @@ export async function updateCommand(opts) {
                 message: stylePromptMessage(message),
                 initialValue: false,
             });
-            if (isCancel(ok) || ok === false) {
+            if (isCancel(ok) || !ok) {
                 if (!opts.json) {
                     defaultRuntime.log(theme.muted("Update cancelled."));
                 }
@@ -540,7 +643,7 @@ export async function updateCommand(opts) {
     }
     const showProgress = !opts.json && process.stdout.isTTY;
     if (!opts.json) {
-        defaultRuntime.log(theme.heading("Updating Moltbot..."));
+        defaultRuntime.log(theme.heading("Updating PoolBot..."));
         defaultRuntime.log("");
     }
     const { progress, stop } = createUpdateProgress(showProgress);
@@ -560,6 +663,12 @@ export async function updateCommand(opts) {
         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}`),
@@ -666,7 +775,7 @@ export async function updateCommand(opts) {
             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 Moltbot 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.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);
@@ -702,8 +811,9 @@ export async function updateCommand(opts) {
         }
         if (!opts.json) {
             const summarizeList = (list) => {
-                if (list.length <= 6)
+                if (list.length <= 6) {
                     return list.join(", ");
+                }
                 return `${list.slice(0, 6).join(", ")} +${list.length - 6} more`;
             };
             if (syncResult.summary.switchedToBundled.length > 0) {
@@ -727,15 +837,18 @@ export async function updateCommand(opts) {
             }
             else {
                 const parts = [`${updated} updated`, `${unchanged} unchanged`];
-                if (failed > 0)
+                if (failed > 0) {
                     parts.push(`${failed} failed`);
-                if (skipped > 0)
+                }
+                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")
+                if (outcome.status !== "error") {
                     continue;
+                }
                 defaultRuntime.log(theme.error(outcome.message));
             }
         }
@@ -743,6 +856,12 @@ export async function updateCommand(opts) {
     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) {
@@ -750,16 +869,16 @@ export async function updateCommand(opts) {
             defaultRuntime.log(theme.heading("Restarting service..."));
         }
         try {
-            const { runDaemonRestart } = await import("./daemon-cli.js");
             const restarted = await runDaemonRestart();
             if (!opts.json && restarted) {
                 defaultRuntime.log(theme.success("Daemon restarted successfully."));
                 defaultRuntime.log("");
                 process.env.CLAWDBOT_UPDATE_IN_PROGRESS = "1";
                 try {
-                    const { doctorCommand } = await import("../commands/doctor.js");
                     const interactiveDoctor = Boolean(process.stdin.isTTY) && !opts.json && opts.yes !== true;
-                    await doctorCommand(defaultRuntime, { nonInteractive: !interactiveDoctor });
+                    await doctorCommand(defaultRuntime, {
+                        nonInteractive: !interactiveDoctor,
+                    });
                 }
                 catch (err) {
                     defaultRuntime.log(theme.warn(`Doctor failed: ${String(err)}`));
@@ -880,7 +999,7 @@ export async function updateWizardCommand(opts = {}) {
                 message: stylePromptMessage(`Create a git checkout at ${gitDir}? (override via CLAWDBOT_GIT_DIR)`),
                 initialValue: true,
             });
-            if (isCancel(ok) || ok === false) {
+            if (isCancel(ok) || !ok) {
                 defaultRuntime.log(theme.muted("Update cancelled."));
                 defaultRuntime.exit(0);
                 return;
@@ -911,7 +1030,7 @@ export async function updateWizardCommand(opts = {}) {
 export function registerUpdateCli(program) {
     const update = program
         .command("update")
-        .description("Update Moltbot to the latest version")
+        .description("Update PoolBot to the latest version")
         .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)")
@@ -981,7 +1100,9 @@ ${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/updat
         .addHelpText("after", `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.molt.bot/cli/update")}\n`)
         .action(async (opts) => {
         try {
-            await updateWizardCommand({ timeout: opts.timeout });
+            await updateWizardCommand({
+                timeout: opts.timeout,
+            });
         }
         catch (err) {
             defaultRuntime.error(String(err));

package/dist/cli/webhooks-cli.js

@@ -12,14 +12,14 @@ export function registerWebhooksCli(program) {
     const gmail = webhooks.command("gmail").description("Gmail Pub/Sub hooks (via gogcli)");
     gmail
         .command("setup")
-        .description("Configure Gmail watch + Pub/Sub + Moltbot hooks")
+        .description("Configure Gmail watch + Pub/Sub + Poolbot hooks")
         .requiredOption("--account <email>", "Gmail account to watch")
         .option("--project <id>", "GCP project id (OAuth client owner)")
         .option("--topic <name>", "Pub/Sub topic name", DEFAULT_GMAIL_TOPIC)
         .option("--subscription <name>", "Pub/Sub subscription name", DEFAULT_GMAIL_SUBSCRIPTION)
         .option("--label <label>", "Gmail label to watch", DEFAULT_GMAIL_LABEL)
-        .option("--hook-url <url>", "Moltbot hook URL")
-        .option("--hook-token <token>", "Moltbot hook token")
+        .option("--hook-url <url>", "Poolbot hook URL")
+        .option("--hook-token <token>", "Poolbot hook token")
         .option("--push-token <token>", "Push token for gog watch serve")
         .option("--bind <host>", "gog watch serve bind host", DEFAULT_GMAIL_SERVE_BIND)
         .option("--port <port>", "gog watch serve port", String(DEFAULT_GMAIL_SERVE_PORT))
@@ -49,8 +49,8 @@ export function registerWebhooksCli(program) {
         .option("--topic <topic>", "Pub/Sub topic path (projects/.../topics/..)")
         .option("--subscription <name>", "Pub/Sub subscription name")
         .option("--label <label>", "Gmail label to watch")
-        .option("--hook-url <url>", "Moltbot hook URL")
-        .option("--hook-token <token>", "Moltbot hook token")
+        .option("--hook-url <url>", "Poolbot hook URL")
+        .option("--hook-token <token>", "Poolbot hook token")
         .option("--push-token <token>", "Push token for gog watch serve")
         .option("--bind <host>", "gog watch serve bind host")
         .option("--port <port>", "gog watch serve port")

package/dist/commands/agent.js

@@ -342,6 +342,7 @@ export async function agentCommand(opts, runtime = defaultRuntime, deps = create
                         currentThreadTs: runContext.currentThreadTs,
                         replyToMode: runContext.replyToMode,
                         hasRepliedRef: runContext.hasRepliedRef,
+                        senderIsOwner: true,
                         sessionFile,
                         workspaceDir,
                         config: cfg,

package/dist/commands/agents.commands.add.js

@@ -129,7 +129,7 @@ export async function agentsAddCommand(opts, runtime = defaultRuntime, params) {
     }
     const prompter = createClackPrompter();
     try {
-        await prompter.intro("Add Moltbot agent");
+        await prompter.intro("Add Poolbot agent");
         const name = nameInput ??
             (await prompter.text({
                 message: "Agent name",