@dosu/cli 0.60.2 → 0.62.0

package/README.md

@@ -107,6 +107,8 @@ Or right-click the binary, select "Open", and click "Open" in the dialog.
 
 `dosu upgrade` delegates to npm, pnpm, Yarn Classic, or Homebrew only after confirming which manager owns the current installation. Temporary package-runner invocations stay ephemeral, ambiguous or local installs are left unchanged, and standalone binaries receive the latest safe manual download path. After a successful update it hands off to the new version, which re-applies the bundled skills and, only if the update crossed a release that changed the agent config format, runs `dosu setup` (or the non-interactive `dosu mcp refresh` without a TTY). Upgrades done outside `dosu upgrade` (npm, brew, `npx @dosu/cli@latest`) get a safety net: when the new version changed the shape of the MCP entry, the first command on it silently rewrites configured tools' MCP entries and prompts you to run `dosu setup` for the rest; the bundled agent skills are always re-applied on the first command after any version change.
 
+Dosu also updates itself automatically. When the update check (every six hours) finds a newer release, npm, pnpm, Yarn Classic, and Homebrew installs start the same package-manager update in a detached background process. The current command runs unchanged, and your next command uses the new version, whose first run applies the skill and MCP refreshes above. Hooks, rules, and the status line still need `dosu setup` when a release changes them. Background updates never run for `npx` invocations, standalone binaries, CI, or `DOSU_DEV=true`. A failed install (for example, a global npm prefix that needs `sudo`) falls back to the "Run `dosu upgrade`" notice and is retried after six hours. Turn background updates off with `dosu upgrade --auto off` (and back on with `--auto on`), or with `DOSU_DISABLE_AUTOUPDATE=1` for a single environment.
+
 ### Platform commands
 
 Once authenticated against a deployment, you can drive the Dosu platform without leaving the terminal:

package/bin/dosu.js

@@ -1083,7 +1083,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.60.2", INSTALL_CHANNEL = "npm";
+var VERSION = "0.62.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -13800,7 +13800,7 @@ var init_conflicts = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "49fa5d82-a4a1-8b36-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "da3b44a3-063b-fb2c-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -60326,11 +60326,11 @@ dosu skill install | remove | update
 dosu telemetry status [--json]
 dosu telemetry enable | disable | reset
 dosu insights
-dosu upgrade
+dosu upgrade [--auto on|off]
 dosu logs [--tail [n]] [--clear]
 \`\`\`
 
-\`deployments\` selects the MCP deployment stored in local config; it is distinct from \`agents\`. \`insights\` opens an interactive visual report. \`logs --clear\` deletes the CLI log file.
+\`deployments\` selects the MCP deployment stored in local config; it is distinct from \`agents\`. \`insights\` opens an interactive visual report. \`logs --clear\` deletes the CLI log file. The CLI updates itself in the background by default; a \`[dosu:update] Installing ...\` notice on stderr needs no action. \`upgrade --auto off\` turns that off.
 
 ## Codebase audit
 
@@ -61719,6 +61719,7 @@ var ClaudeProvider = () => createJSONProvider({
   paths: ["~/.claude"],
   globalPath: "~/.claude.json",
   topKey: "mcpServers",
+  buildServer: ({ url, headers }) => ({ type: "http", url, headers, alwaysLoad: true }),
   localConfigPath: (cwd) => join24(cwd, ".mcp.json")
 });
 var init_claude = __esm(() => {
@@ -62341,10 +62342,204 @@ var init_refresh = __esm(() => {
   init_providers();
 });
 
-// src/version/update-check.ts
-import { existsSync as existsSync23, mkdirSync as mkdirSync13, readFileSync as readFileSync22, writeFileSync as writeFileSync14 } from "node:fs";
+// src/version/auto-update.ts
+import { spawn as spawn3 } from "node:child_process";
+import {
+  closeSync as closeSync6,
+  existsSync as existsSync23,
+  mkdirSync as mkdirSync13,
+  openSync as openSync6,
+  readFileSync as readFileSync22,
+  rmSync as rmSync7,
+  statSync as statSync8,
+  writeFileSync as writeFileSync14,
+  writeSync
+} from "node:fs";
+import { homedir as homedir11 } from "node:os";
 import { join as join38 } from "node:path";
+function statePath() {
+  return join38(getConfigDir(), STATE_FILENAME2);
+}
+function lockPath2() {
+  return join38(getConfigDir(), LOCK_FILENAME2);
+}
 function isValidVersion(value) {
+  return typeof value === "string" && VERSION_PATTERN.test(value);
+}
+function readState() {
+  try {
+    const raw = JSON.parse(readFileSync22(statePath(), "utf-8"));
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+      return {};
+    const data = raw;
+    const state = {};
+    if (data.disabled === true)
+      state.disabled = true;
+    const last = data.lastAttempt;
+    if (last && isValidVersion(last.version) && typeof last.ok === "boolean" && typeof last.finishedAt === "number") {
+      state.lastAttempt = { version: last.version, ok: last.ok, finishedAt: last.finishedAt };
+    }
+    return state;
+  } catch {
+    return {};
+  }
+}
+function writeState(state) {
+  try {
+    const dir = getConfigDir();
+    if (!existsSync23(dir))
+      mkdirSync13(dir, { recursive: true, mode: 448 });
+    writeFileSync14(statePath(), `${JSON.stringify(state, null, 2)}
+`, { mode: 384 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isEnabledFlag(value) {
+  if (value === undefined)
+    return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized !== "" && !["0", "false", "no", "off"].includes(normalized);
+}
+function autoUpdateDisabledReason(env = process.env) {
+  if (isEnabledFlag(env[AUTO_UPDATE_ENV]))
+    return "env";
+  if (readState().disabled)
+    return "settings";
+  return;
+}
+function setAutoUpdateEnabled(enabled) {
+  const state = readState();
+  if (enabled)
+    delete state.disabled;
+  else
+    state.disabled = true;
+  return writeState(state);
+}
+function canAutoUpdate(channel, env) {
+  if (env.NODE_ENV === "test" || env.CI || env.DOSU_DEV === "true")
+    return false;
+  if (!SUPPORTED_CHANNELS.has(channel) || isNpxInvocation(channel, env))
+    return false;
+  return autoUpdateDisabledReason(env) === undefined;
+}
+function backgroundInvocation(channel, entrypoint = process.argv[1], execPath = process.execPath) {
+  const args = ["upgrade", "--background"];
+  if (channel === "npm") {
+    return entrypoint ? { command: execPath, args: [entrypoint, ...args] } : null;
+  }
+  if (channel === "homebrew")
+    return { command: execPath, args };
+  return null;
+}
+function lockIsFresh(now) {
+  try {
+    return now - statSync8(lockPath2()).mtimeMs < LOCK_STALE_MS;
+  } catch {
+    return false;
+  }
+}
+function claimLock(version, now) {
+  try {
+    mkdirSync13(getConfigDir(), { recursive: true, mode: 448 });
+    if (!lockIsFresh(now))
+      rmSync7(lockPath2(), { force: true });
+    const fd = openSync6(lockPath2(), "wx", 384);
+    try {
+      writeSync(fd, version);
+    } finally {
+      closeSync6(fd);
+    }
+    return "claimed";
+  } catch (err) {
+    return err.code === "EEXIST" ? "held" : "failed";
+  }
+}
+function releaseLock() {
+  try {
+    rmSync7(lockPath2(), { force: true });
+  } catch {}
+}
+function readLockVersion() {
+  try {
+    const version = readFileSync22(lockPath2(), "utf-8").trim();
+    return isValidVersion(version) ? version : undefined;
+  } catch {
+    return;
+  }
+}
+function startAutoUpdate(version, options = {}) {
+  const channel = options.channel ?? INSTALL_CHANNEL;
+  const env = options.env ?? process.env;
+  const now = options.now ?? Date.now();
+  try {
+    if (!isValidVersion(version) || !canAutoUpdate(channel, env))
+      return "unavailable";
+    if (lockIsFresh(now))
+      return "in_progress";
+    const last = readState().lastAttempt;
+    if (last?.version === version && now - last.finishedAt < RETRY_INTERVAL_MS) {
+      return "unavailable";
+    }
+    const invocation = backgroundInvocation(channel, options.entrypoint, options.execPath);
+    if (!invocation)
+      return "unavailable";
+    const claim = claimLock(version, now);
+    if (claim !== "claimed")
+      return claim === "held" ? "in_progress" : "unavailable";
+    try {
+      const child = spawn3(invocation.command, invocation.args, {
+        cwd: homedir11(),
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+        env: { ...env, DOSU_TELEMETRY_DISABLED: "1" }
+      });
+      child.on("error", releaseLock);
+      child.unref();
+    } catch (err) {
+      releaseLock();
+      throw err;
+    }
+    logger.info("auto-update", `Started background update to ${version}`);
+    return "started";
+  } catch (err) {
+    logger.error("auto-update", `Could not start background update: ${err}`);
+    return "unavailable";
+  }
+}
+function runBackgroundUpgrade(upgrade, now = Date.now) {
+  const version = readLockVersion();
+  let status = 1;
+  try {
+    status = upgrade();
+  } catch (err) {
+    logger.error("auto-update", `Background update threw: ${err}`);
+  }
+  if (version) {
+    const state = readState();
+    state.lastAttempt = { version, ok: status === 0, finishedAt: now() };
+    writeState(state);
+  }
+  logger.info("auto-update", `Background update ${status === 0 ? "finished" : "failed"}`);
+  releaseLock();
+  return status;
+}
+var STATE_FILENAME2 = "auto-update.json", LOCK_FILENAME2 = "auto-update.lock", LOCK_STALE_MS, RETRY_INTERVAL_MS, SUPPORTED_CHANNELS, VERSION_PATTERN, AUTO_UPDATE_ENV = "DOSU_DISABLE_AUTOUPDATE";
+var init_auto_update = __esm(() => {
+  init_config();
+  init_logger();
+  LOCK_STALE_MS = 15 * 60 * 1000;
+  RETRY_INTERVAL_MS = 6 * 60 * 60 * 1000;
+  SUPPORTED_CHANNELS = new Set(["npm", "homebrew"]);
+  VERSION_PATTERN = /^[0-9A-Za-z.+-]{1,64}$/;
+});
+
+// src/version/update-check.ts
+import { existsSync as existsSync24, mkdirSync as mkdirSync14, readFileSync as readFileSync23, writeFileSync as writeFileSync15 } from "node:fs";
+import { join as join39 } from "node:path";
+function isValidVersion2(value) {
   return typeof value === "string" && SEMVER_PATTERN.test(value);
 }
 function stripPrerelease(version) {
@@ -62365,15 +62560,15 @@ function isNewerVersion(latest, current) {
   return false;
 }
 function getCachePath2() {
-  return join38(getConfigDir(), CACHE_FILENAME3);
+  return join39(getConfigDir(), CACHE_FILENAME3);
 }
 function readCache() {
   try {
     const path = getCachePath2();
-    if (!existsSync23(path))
+    if (!existsSync24(path))
       return null;
-    const data = JSON.parse(readFileSync22(path, "utf-8"));
-    if (typeof data.lastCheck === "number" && isValidVersion(data.latestVersion)) {
+    const data = JSON.parse(readFileSync23(path, "utf-8"));
+    if (typeof data.lastCheck === "number" && isValidVersion2(data.latestVersion)) {
       return data;
     }
     return null;
@@ -62384,10 +62579,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync23(dir)) {
-      mkdirSync13(dir, { recursive: true, mode: 448 });
+    if (!existsSync24(dir)) {
+      mkdirSync14(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync14(getCachePath2(), JSON.stringify(cache), { mode: 384 });
+    writeFileSync15(getCachePath2(), JSON.stringify(cache), { mode: 384 });
   } catch {}
 }
 async function fetchLatestVersion() {
@@ -62399,7 +62594,7 @@ async function fetchLatestVersion() {
       return null;
     const data = await resp.json();
     const latest = data.latest;
-    return isValidVersion(latest) ? latest : null;
+    return isValidVersion2(latest) ? latest : null;
   } catch {
     return null;
   } finally {
@@ -62419,30 +62614,43 @@ function styleHint(hint) {
   const [, before, command, after] = match;
   return [before && import_picocolors30.default.dim(before), import_picocolors30.default.cyan(command), after && import_picocolors30.default.dim(after)].filter(Boolean).join("");
 }
-function buildUpdateNotice(current, latest, channel, interactive, npx = false, width = process.stderr.columns ?? 80) {
-  const hint = buildUpdateHint(channel, npx);
-  if (interactive) {
-    const content = [
-      `Update available: ${import_picocolors30.default.dim(current)} ${import_picocolors30.default.dim("→")} ${import_picocolors30.default.bold(brand(latest))}`,
-      styleHint(hint)
-    ];
-    const innerWidth = Math.max(...content.map(visibleWidth2)) + BOX_PADDING * 2;
-    const framed = (line) => {
-      const pad = innerWidth - visibleWidth2(line);
-      const left = Math.floor(pad / 2);
-      return `${import_picocolors30.default.yellow("│")}${" ".repeat(left)}${line}${" ".repeat(pad - left)}${import_picocolors30.default.yellow("│")}`;
-    };
-    const box = [
-      import_picocolors30.default.yellow(`╭${"─".repeat(innerWidth)}╮`),
-      framed(""),
-      ...content.map(framed),
-      framed(""),
-      import_picocolors30.default.yellow(`╰${"─".repeat(innerWidth)}╯`)
-    ];
-    return `
+function framedNotice(content, width) {
+  const innerWidth = Math.max(...content.map(visibleWidth2)) + BOX_PADDING * 2;
+  const framed = (line) => {
+    const pad = innerWidth - visibleWidth2(line);
+    const left = Math.floor(pad / 2);
+    return `${import_picocolors30.default.yellow("│")}${" ".repeat(left)}${line}${" ".repeat(pad - left)}${import_picocolors30.default.yellow("│")}`;
+  };
+  const box = [
+    import_picocolors30.default.yellow(`╭${"─".repeat(innerWidth)}╮`),
+    framed(""),
+    ...content.map(framed),
+    framed(""),
+    import_picocolors30.default.yellow(`╰${"─".repeat(innerWidth)}╯`)
+  ];
+  return `
 ${centerBlock(box, width).join(`
 `)}
 `;
+}
+function versionArrow(current, latest) {
+  return `${import_picocolors30.default.dim(current)} ${import_picocolors30.default.dim("→")} ${import_picocolors30.default.bold(brand(latest))}`;
+}
+function buildAutoUpdateNotice(current, latest, interactive, width = process.stderr.columns ?? 80) {
+  if (interactive) {
+    return framedNotice([
+      `Updating Dosu: ${versionArrow(current, latest)}`,
+      import_picocolors30.default.dim("Installing in the background; your next command uses it")
+    ], width);
+  }
+  return `
+[dosu:update] Installing Dosu ${latest} in the background (running ${current}). ` + `The next Dosu command uses it; no action needed.
+`;
+}
+function buildUpdateNotice(current, latest, channel, interactive, npx = false, width = process.stderr.columns ?? 80) {
+  const hint = buildUpdateHint(channel, npx);
+  if (interactive) {
+    return framedNotice([`Update available: ${versionArrow(current, latest)}`, styleHint(hint)], width);
   }
   const agentAction = hint[0].toLowerCase() + hint.slice(1);
   const verifyCommand = npx ? "npx -y @dosu/cli@latest --version" : "dosu --version";
@@ -62455,8 +62663,12 @@ function getAvailableUpdate() {
   const cache = readCache();
   return cache && isNewerVersion(cache.latestVersion, VERSION) ? cache.latestVersion : null;
 }
-function displayNotice(current, latest) {
-  console.error(buildUpdateNotice(current, latest, INSTALL_CHANNEL, process.stderr.isTTY === true, isNpxInvocation()));
+function handleNewerVersion(latest, notify) {
+  const autoUpdate = startAutoUpdate(latest);
+  if (!notify)
+    return;
+  const interactive = process.stderr.isTTY === true;
+  console.error(autoUpdate === "unavailable" ? buildUpdateNotice(VERSION, latest, INSTALL_CHANNEL, interactive, isNpxInvocation()) : buildAutoUpdateNotice(VERSION, latest, interactive));
 }
 async function checkForUpdates(options = {}) {
   const notify = options.notify ?? true;
@@ -62464,8 +62676,8 @@ async function checkForUpdates(options = {}) {
     const cache = readCache();
     const isStale = !cache || Date.now() - cache.lastCheck > CHECK_INTERVAL_MS2;
     if (!isStale) {
-      if (notify && isNewerVersion(cache.latestVersion, VERSION)) {
-        displayNotice(VERSION, cache.latestVersion);
+      if (isNewerVersion(cache.latestVersion, VERSION)) {
+        handleNewerVersion(cache.latestVersion, notify);
       }
       return;
     }
@@ -62478,8 +62690,8 @@ async function checkForUpdates(options = {}) {
     if (latest) {
       logger.debug("update-check", `Cached latest version: ${latest}`);
     }
-    if (notify && isNewerVersion(latestKnownVersion, VERSION)) {
-      displayNotice(VERSION, latestKnownVersion);
+    if (isNewerVersion(latestKnownVersion, VERSION)) {
+      handleNewerVersion(latestKnownVersion, notify);
     }
   } catch (err) {
     logger.error("update-check", `Update check failed: ${err}`);
@@ -62491,14 +62703,15 @@ var init_update_check = __esm(() => {
   init_logger();
   init_styles();
   init_layout();
+  init_auto_update();
   import_picocolors30 = __toESM(require_picocolors(), 1);
   CHECK_INTERVAL_MS2 = 6 * 60 * 60 * 1000;
   SEMVER_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
 });
 
 // src/version/mcp-refresh-check.ts
-import { existsSync as existsSync24, mkdirSync as mkdirSync14, readFileSync as readFileSync23, writeFileSync as writeFileSync15 } from "node:fs";
-import { join as join39 } from "node:path";
+import { existsSync as existsSync25, mkdirSync as mkdirSync15, readFileSync as readFileSync24, writeFileSync as writeFileSync16 } from "node:fs";
+import { join as join40 } from "node:path";
 function needsMcpRefresh(previous, current) {
   if (previous === null)
     return true;
@@ -62508,14 +62721,14 @@ function needsMcpRefresh(previous, current) {
   return MCP_FORMAT_CHANGES.some((change) => isNewerVersion(change, older) && !isNewerVersion(change, newer));
 }
 function getCachePath3() {
-  return join39(getConfigDir(), CACHE_FILENAME4);
+  return join40(getConfigDir(), CACHE_FILENAME4);
 }
 function readMcpRefreshCache() {
   try {
     const path = getCachePath3();
-    if (!existsSync24(path))
+    if (!existsSync25(path))
       return null;
-    const data = JSON.parse(readFileSync23(path, "utf-8"));
+    const data = JSON.parse(readFileSync24(path, "utf-8"));
     if (typeof data?.version === "string")
       return { version: data.version };
     return null;
@@ -62526,10 +62739,10 @@ function readMcpRefreshCache() {
 function writeMcpRefreshCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync24(dir)) {
-      mkdirSync14(dir, { recursive: true, mode: 448 });
+    if (!existsSync25(dir)) {
+      mkdirSync15(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync15(getCachePath3(), JSON.stringify(cache), { mode: 384 });
+    writeFileSync16(getCachePath3(), JSON.stringify(cache), { mode: 384 });
   } catch {}
 }
 function canRefreshMcp(cfg) {
@@ -62538,7 +62751,7 @@ function canRefreshMcp(cfg) {
     return false;
   return cfg.mode === MODE_OSS || Boolean(target.deployment_id);
 }
-function displayNotice2(names) {
+function displayNotice(names) {
   console.error(`
 ${import_picocolors31.default.green(`✓ Dosu ${VERSION}: refreshed MCP config for ${names.join(", ")}`)}
 ` + `${import_picocolors31.default.dim(`  Run ${import_picocolors31.default.cyan('"dosu setup"')} to also update hooks and rules, then restart your AI agents.`)}
@@ -62563,7 +62776,7 @@ function checkForMcpRefresh(options = {}) {
     writeMcpRefreshCache({ version: VERSION });
     logger.info("mcp-refresh", `Version ${VERSION}: refreshed ${result.updated.length}, failed ${result.failed.length}`);
     if (notify && result.updated.length > 0) {
-      displayNotice2(result.updated.map((provider) => provider.name()));
+      displayNotice(result.updated.map((provider) => provider.name()));
     }
   } catch (err) {
     logger.error("mcp-refresh", `MCP refresh check failed: ${err}`);
@@ -62576,11 +62789,14 @@ var init_mcp_refresh_check = __esm(() => {
   init_refresh();
   init_update_check();
   import_picocolors31 = __toESM(require_picocolors(), 1);
-  MCP_FORMAT_CHANGES = ["0.53.0"];
+  MCP_FORMAT_CHANGES = [
+    "0.53.0",
+    "0.62.0"
+  ];
 });
 
 // src/version/skill-update-check.ts
-function displayNotice3() {
+function displayNotice2() {
   console.error(`
 ${import_picocolors32.default.green(`✓ Dosu ${VERSION}: refreshed the bundled agent skills`)}
 ` + `${import_picocolors32.default.dim("  Restart your AI agents to pick up the new skill content.")}
@@ -62599,7 +62815,7 @@ function checkForSkillUpdates(options = {}) {
     }
     logger.info("skill-update-check", `Refreshed skills from ${state.version} to ${VERSION}`);
     if (notify && result.version)
-      displayNotice3();
+      displayNotice2();
   } catch (err) {
     logger.error("skill-update-check", `Skill update check failed: ${err}`);
   }
@@ -62639,11 +62855,11 @@ var init_errors3 = __esm(() => {
 var MCP_PROVIDER_SLUG2 = "dosu_mcp";
 
 // src/debug/follow.ts
-import { closeSync as closeSync6, openSync as openSync6, readSync as readSync5, statSync as statSync8 } from "node:fs";
+import { closeSync as closeSync7, openSync as openSync7, readSync as readSync5, statSync as statSync9 } from "node:fs";
 function createLogFollower(path, emit) {
   const sizeOf = () => {
     try {
-      return statSync8(path).size;
+      return statSync9(path).size;
     } catch {
       return 0;
     }
@@ -62657,7 +62873,7 @@ function createLogFollower(path, emit) {
       if (size === offset)
         return;
       try {
-        const fd = openSync6(path, "r");
+        const fd = openSync7(path, "r");
         try {
           const buf = Buffer.alloc(size - offset);
           const read = readSync5(fd, buf, 0, buf.length, offset);
@@ -62665,7 +62881,7 @@ function createLogFollower(path, emit) {
           if (read > 0)
             emit(buf.toString("utf-8", 0, read));
         } finally {
-          closeSync6(fd);
+          closeSync7(fd);
         }
       } catch {}
     }
@@ -62674,15 +62890,15 @@ function createLogFollower(path, emit) {
 var init_follow = () => {};
 
 // src/sessions/session-title.ts
-import { existsSync as existsSync25, mkdirSync as mkdirSync15, readFileSync as readFileSync24, renameSync as renameSync6, statSync as statSync9, writeFileSync as writeFileSync16 } from "node:fs";
-import { homedir as homedir11 } from "node:os";
-import { join as join40 } from "node:path";
+import { existsSync as existsSync26, mkdirSync as mkdirSync16, readFileSync as readFileSync25, renameSync as renameSync6, statSync as statSync10, writeFileSync as writeFileSync17 } from "node:fs";
+import { homedir as homedir12 } from "node:os";
+import { join as join41 } from "node:path";
 function cachePath2(configDir) {
-  return join40(configDir, CACHE_FILENAME5);
+  return join41(configDir, CACHE_FILENAME5);
 }
 function loadCacheFile2(configDir) {
   try {
-    const raw = JSON.parse(readFileSync24(cachePath2(configDir), "utf-8"));
+    const raw = JSON.parse(readFileSync25(cachePath2(configDir), "utf-8"));
     if (raw.schema_version !== CACHE_SCHEMA_VERSION2 || typeof raw.entries !== "object")
       return {};
     return raw.entries;
@@ -62692,12 +62908,12 @@ function loadCacheFile2(configDir) {
 }
 function saveCacheFile2(configDir, entries) {
   try {
-    if (!existsSync25(configDir))
-      mkdirSync15(configDir, { recursive: true, mode: 448 });
+    if (!existsSync26(configDir))
+      mkdirSync16(configDir, { recursive: true, mode: 448 });
     const path = cachePath2(configDir);
     const tmp = `${path}.${process.pid}.tmp`;
     const file = { schema_version: CACHE_SCHEMA_VERSION2, entries };
-    writeFileSync16(tmp, JSON.stringify(file), { mode: 384 });
+    writeFileSync17(tmp, JSON.stringify(file), { mode: 384 });
     renameSync6(tmp, path);
   } catch {}
 }
@@ -62730,15 +62946,15 @@ function claudeSummaryFromHead(text) {
   }
   return null;
 }
-function reconstructSession(harness, id, slug, home = homedir11(), exists = existsSync25) {
+function reconstructSession(harness, id, slug, home = homedir12(), exists = existsSync26) {
   if (!slug)
     return null;
   const candidates = [];
   if (harness === "claude") {
-    candidates.push(join40(home, ".claude", "projects", slug, `${id}.jsonl`));
+    candidates.push(join41(home, ".claude", "projects", slug, `${id}.jsonl`));
   } else if (harness === "cursor") {
-    const project = join40(home, ".cursor", "projects", slug);
-    candidates.push(join40(project, "agent-transcripts", id, `${id}.jsonl`), join40(project, "agent-transcripts", `${id}.jsonl`));
+    const project = join41(home, ".cursor", "projects", slug);
+    candidates.push(join41(project, "agent-transcripts", id, `${id}.jsonl`), join41(project, "agent-transcripts", `${id}.jsonl`));
   } else {
     return null;
   }
@@ -62750,14 +62966,14 @@ function reconstructSession(harness, id, slug, home = homedir11(), exists = exis
 }
 function readHead2(path) {
   try {
-    return readFileSync24(path, "utf-8").slice(0, 128 * 1024);
+    return readFileSync25(path, "utf-8").slice(0, 128 * 1024);
   } catch {
     return null;
   }
 }
 function fileMtime2(path) {
   try {
-    return statSync9(path).mtime.toISOString();
+    return statSync10(path).mtime.toISOString();
   } catch {
     return "";
   }
@@ -62830,7 +63046,7 @@ var init_alt_screen = __esm(() => {
 });
 
 // src/tui/activity-view.ts
-import { existsSync as existsSync26, readFileSync as readFileSync25 } from "node:fs";
+import { existsSync as existsSync27, readFileSync as readFileSync26 } from "node:fs";
 import { basename as basename5 } from "node:path";
 function reduceActivityViewKey(key) {
   if (key === "q" || key === ESC7 || key === CTRL_C4)
@@ -63151,7 +63367,7 @@ function createRowNamer() {
         names.titles[key] = t;
     };
     for (const s of [...backlog.queued, ...backlog.open]) {
-      if (!existsSync26(s.path))
+      if (!existsSync27(s.path))
         continue;
       const key = `${s.harness}/${s.id}`;
       const dir = dirs.resolve(s);
@@ -63188,7 +63404,7 @@ function createRowNamer() {
 }
 function defaultReadLog2() {
   try {
-    return readFileSync25(logger.getLogPath(), "utf-8");
+    return readFileSync26(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -63405,14 +63621,14 @@ var init_activity_view = __esm(() => {
 });
 
 // src/rules/installer.ts
-import { existsSync as existsSync27, mkdirSync as mkdirSync16, readFileSync as readFileSync26, unlinkSync as unlinkSync5, writeFileSync as writeFileSync17 } from "node:fs";
-import { homedir as homedir12 } from "node:os";
-import { dirname as dirname12, join as join41 } from "node:path";
+import { existsSync as existsSync28, mkdirSync as mkdirSync17, readFileSync as readFileSync27, unlinkSync as unlinkSync5, writeFileSync as writeFileSync18 } from "node:fs";
+import { homedir as homedir13 } from "node:os";
+import { dirname as dirname12, join as join42 } from "node:path";
 function claudeConfigDir4() {
-  return process.env.CLAUDE_CONFIG_DIR || join41(homedir12(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join42(homedir13(), ".claude");
 }
 function codexHome4() {
-  return process.env.CODEX_HOME || join41(homedir12(), ".codex");
+  return process.env.CODEX_HOME || join42(homedir13(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -63438,17 +63654,17 @@ async function fetchDosuRule(fetchImpl = globalThis.fetch) {
   return normalizeRule(FALLBACK_DOSU_RULE);
 }
 function ensureParent(path) {
-  mkdirSync16(dirname12(path), { recursive: true });
+  mkdirSync17(dirname12(path), { recursive: true });
 }
 function writeIfChanged(path, content) {
-  if (!existsSync27(path)) {
+  if (!existsSync28(path)) {
     ensureParent(path);
-    writeFileSync17(path, content, "utf-8");
+    writeFileSync18(path, content, "utf-8");
     return "created";
   }
-  if (readFileSync26(path, "utf-8") === content)
+  if (readFileSync27(path, "utf-8") === content)
     return "unchanged";
-  writeFileSync17(path, content, "utf-8");
+  writeFileSync18(path, content, "utf-8");
   return "updated";
 }
 function findSection(content) {
@@ -63474,14 +63690,14 @@ function buildSection(content, lineEnding = `
   return `${DOSU_RULE_SECTION_START}${lineEnding}${body}${lineEnding}${DOSU_RULE_SECTION_END}`;
 }
 function upsertSection(path, content) {
-  if (!existsSync27(path)) {
+  if (!existsSync28(path)) {
     const section = buildSection(content);
     ensureParent(path);
-    writeFileSync17(path, `${section}
+    writeFileSync18(path, `${section}
 `, "utf-8");
     return "created";
   }
-  const existing = readFileSync26(path, "utf-8");
+  const existing = readFileSync27(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const section = buildSection(content, lineEnding);
   const location = findSection(existing);
@@ -63494,7 +63710,7 @@ function upsertSection(path, content) {
   }
   if (next === existing)
     return "unchanged";
-  writeFileSync17(path, next, "utf-8");
+  writeFileSync18(path, next, "utf-8");
   return "updated";
 }
 function installRuleForAgent(agent, content) {
@@ -63511,13 +63727,13 @@ function removeRuleForAgent(agent) {
     return null;
   const target = RULE_TARGETS[agent];
   const path = target.path();
-  if (!existsSync27(path))
+  if (!existsSync28(path))
     return { agent, path, action: "not_found" };
   if (target.kind === "file") {
     unlinkSync5(path);
     return { agent, path, action: "removed" };
   }
-  const existing = readFileSync26(path, "utf-8");
+  const existing = readFileSync27(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const location = findSection(existing);
   if (!location)
@@ -63526,7 +63742,7 @@ function removeRuleForAgent(agent) {
   if (!next) {
     unlinkSync5(path);
   } else {
-    writeFileSync17(path, `${next}${lineEnding}`, "utf-8");
+    writeFileSync18(path, `${next}${lineEnding}`, "utf-8");
   }
   return { agent, path, action: "removed" };
 }
@@ -63554,36 +63770,36 @@ var init_installer = __esm(() => {
   RULE_TARGETS = {
     claude: {
       kind: "file",
-      path: () => join41(claudeConfigDir4(), "rules", "dosu.md")
+      path: () => join42(claudeConfigDir4(), "rules", "dosu.md")
     },
     cursor: {
       kind: "file",
-      path: () => join41(homedir12(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join42(homedir13(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
       kind: "section",
-      path: () => join41(codexHome4(), "AGENTS.md")
+      path: () => join42(codexHome4(), "AGENTS.md")
     },
     opencode: {
       kind: "section",
-      path: () => join41(homedir12(), ".config", "opencode", "AGENTS.md")
+      path: () => join42(homedir13(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join41(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join42(homedir13(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join41(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join42(homedir13(), ".gemini", "GEMINI.md")
     }
   };
 });
 
 // src/setup/agents-md-step.ts
 import { execSync as execSync2 } from "node:child_process";
-import { existsSync as existsSync28, readFileSync as readFileSync27, writeFileSync as writeFileSync18 } from "node:fs";
-import { join as join42 } from "node:path";
+import { existsSync as existsSync29, readFileSync as readFileSync28, writeFileSync as writeFileSync19 } from "node:fs";
+import { join as join43 } from "node:path";
 function inGitWorkTree(cwd = process.cwd()) {
   try {
     const stdout = execSync2("git rev-parse --is-inside-work-tree", {
@@ -63597,10 +63813,10 @@ function inGitWorkTree(cwd = process.cwd()) {
 }
 function dosuAgentsSectionState(cwd = process.cwd()) {
   try {
-    const path = join42(cwd, "AGENTS.md");
-    if (!existsSync28(path))
+    const path = join43(cwd, "AGENTS.md");
+    if (!existsSync29(path))
       return "missing";
-    const content = readFileSync27(path, "utf-8");
+    const content = readFileSync28(path, "utf-8");
     const startMatch = content.match(SECTION_START_RE);
     if (!startMatch || !content.includes(DOSU_SECTION_END))
       return "missing";
@@ -63635,14 +63851,14 @@ function findSection2(content) {
   return { start, end };
 }
 function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RULE) {
-  const path = join42(cwd, "AGENTS.md");
-  if (!existsSync28(path)) {
+  const path = join43(cwd, "AGENTS.md");
+  if (!existsSync29(path)) {
     const section = buildDosuAgentsSection(content);
-    writeFileSync18(path, `${section}
+    writeFileSync19(path, `${section}
 `);
     return { path, action: "created" };
   }
-  const existing = readFileSync27(path, "utf-8");
+  const existing = readFileSync28(path, "utf-8");
   const lineEnding = lineEndingFor2(existing);
   const section = renderDosuAgentsSection(content, lineEnding);
   const location = findSection2(existing);
@@ -63654,7 +63870,7 @@ function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RU
   }
   if (next === existing)
     return { path, action: "unchanged" };
-  writeFileSync18(path, next);
+  writeFileSync19(path, next);
   return { path, action: "updated" };
 }
 async function stepUpdateAgentsMd(cwd = process.cwd(), content) {
@@ -65366,7 +65582,7 @@ var init_flow2 = __esm(() => {
 // src/commands/upgrade.ts
 import { spawnSync } from "node:child_process";
 import { realpathSync as realpathSync2 } from "node:fs";
-import { homedir as homedir13 } from "node:os";
+import { homedir as homedir14 } from "node:os";
 import { posix, win32 as win322 } from "node:path";
 function isAbsoluteCommandProcessor(value) {
   return Boolean(value && win322.isAbsolute(value) && win322.basename(value).toLowerCase() === "cmd.exe");
@@ -65420,7 +65636,7 @@ function packageRoots(manager, platform, comSpec, env, cwd) {
     manager === "npm" ? path.join(lines[0], "@dosu", "cli") : path.join(lines[0], "node_modules", "@dosu", "cli")
   ];
 }
-function owningPackageManager(entrypoint, platform, comSpec, env = process.env, cwd = homedir13()) {
+function owningPackageManager(entrypoint, platform, comSpec, env = process.env, cwd = homedir14()) {
   const path = platform === "win32" ? win322 : posix;
   if (!entrypoint || !path.isAbsolute(entrypoint))
     return null;
@@ -65473,7 +65689,7 @@ Or install Dosu globally with your package manager:`);
 function runUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   const platform = options.platform ?? process.platform;
   const env = options.env ?? process.env;
-  const cwd = options.cwd ?? homedir13();
+  const cwd = options.cwd ?? homedir14();
   let manager = null;
   if (channel === "npm") {
     if (isNpxInvocation(channel, env)) {
@@ -65540,7 +65756,7 @@ function finishWithNewBinary(channel, options) {
     return;
   }
   const result = spawnSync(invocation.command, invocation.args, {
-    cwd: options.cwd ?? homedir13(),
+    cwd: options.cwd ?? homedir14(),
     shell: false,
     stdio: "inherit"
   });
@@ -65590,9 +65806,37 @@ Refreshing agent MCP configs with the new version...`);
     console.error(SETUP_FALLBACK);
   return 0;
 }
+function setAutoUpdate(value) {
+  const normalized = value.trim().toLowerCase();
+  if (normalized !== "on" && normalized !== "off") {
+    console.error(`Invalid --auto value '${value}' (expected 'on' or 'off').`);
+    return 2;
+  }
+  if (!setAutoUpdateEnabled(normalized === "on")) {
+    console.error("Could not save the auto-update setting.");
+    return 1;
+  }
+  if (normalized === "off") {
+    console.log('Automatic updates are off. Run "dosu upgrade" to update by hand.');
+  } else if (autoUpdateDisabledReason() === "env") {
+    console.log(`Automatic updates are on, but ${AUTO_UPDATE_ENV} still disables them here.`);
+  } else {
+    console.log("Automatic updates are on.");
+  }
+  return 0;
+}
 function upgradeCommand() {
-  return new Command("upgrade").description("Update Dosu to the latest version, re-running setup when the update changes agent config").addOption(new Option("--finish <from>").hideHelp()).action(async (opts) => {
-    const status = opts.finish !== undefined ? await finishUpgrade(opts.finish) : await completeUpgrade();
+  return new Command("upgrade").description("Update Dosu to the latest version, re-running setup when the update changes agent config").option("--auto <on|off>", "Turn automatic background updates on or off").addOption(new Option("--background").hideHelp()).addOption(new Option("--finish <from>").hideHelp()).action(async (opts) => {
+    let status;
+    if (opts.auto !== undefined) {
+      status = setAutoUpdate(opts.auto);
+    } else if (opts.background) {
+      status = runBackgroundUpgrade(() => runUpgrade());
+    } else if (opts.finish !== undefined) {
+      status = await finishUpgrade(opts.finish);
+    } else {
+      status = await completeUpgrade();
+    }
     if (status !== 0)
       process.exitCode = status;
   });
@@ -65602,6 +65846,7 @@ var init_upgrade = __esm(() => {
   init_commander();
   init_config();
   init_refresh();
+  init_auto_update();
   init_mcp_refresh_check();
   init_skill_update_check();
   import_picocolors35 = __toESM(require_picocolors(), 1);
@@ -66309,7 +66554,7 @@ var init_pages_view = __esm(() => {
 });
 
 // src/tui/tui.ts
-import { homedir as homedir14 } from "node:os";
+import { homedir as homedir15 } from "node:os";
 import { basename as basename6 } from "node:path";
 async function probeSession(cfg) {
   if (!isAuthenticated(cfg) || !isTokenExpired(cfg))
@@ -66574,7 +66819,7 @@ async function runSettings(cfg) {
   }
 }
 function displayDir(dir) {
-  const home = homedir14();
+  const home = homedir15();
   return dir === home ? "~" : dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir;
 }
 function discoverProjectDirs() {
@@ -67284,7 +67529,7 @@ var init_flow3 = __esm(() => {
 });
 
 // src/cli/cli.ts
-import { readFileSync as readFileSync28, unlinkSync as unlinkSync6 } from "node:fs";
+import { readFileSync as readFileSync29, unlinkSync as unlinkSync6 } from "node:fs";
 function shouldRunBackgroundChecks(actionName) {
   return actionName !== "upgrade";
 }
@@ -67730,7 +67975,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     }
     if (opts.follow) {
       try {
-        const lines = readFileSync28(logPath, "utf-8").split(`
+        const lines = readFileSync29(logPath, "utf-8").split(`
 `);
         if (lines.at(-1) === "")
           lines.pop();
@@ -67746,7 +67991,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     if (opts.tail !== undefined) {
       const n = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
       try {
-        const content = readFileSync28(logPath, "utf-8");
+        const content = readFileSync29(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n).join(`
@@ -67872,4 +68117,4 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=49fa5d82-a4a1-8b36-6475-6e2164756e21
+//# debugId=da3b44a3-063b-fb2c-6475-6e2164756e21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.60.2",
+  "version": "0.62.0",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",