@dosu/cli 0.56.0 → 0.57.0

package/bin/dosu.js

@@ -636,7 +636,18 @@ function numberValue(value) {
 var init_config_v1_migration = () => {};
 
 // src/config/config.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import {
+  closeSync,
+  constants,
+  existsSync as existsSync2,
+  fstatSync,
+  mkdirSync,
+  openSync,
+  readFileSync,
+  readSync,
+  renameSync,
+  writeFileSync
+} from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
 function getConfigUserID(cfg) {
@@ -701,6 +712,26 @@ function loadConfig() {
   } catch {}
   return parsed;
 }
+function loadConfigNonBlocking() {
+  let fd;
+  try {
+    fd = openSync(getConfigPath(), constants.O_RDONLY | constants.O_NONBLOCK);
+    const file = fstatSync(fd);
+    if (!file.isFile() || file.size > MAX_BACKGROUND_CONFIG_BYTES)
+      return;
+    const content = Buffer.alloc(MAX_BACKGROUND_CONFIG_BYTES);
+    const bytesRead = readSync(fd, content, 0, content.byteLength, 0);
+    return parseConfig(JSON.parse(content.subarray(0, bytesRead).toString("utf8")));
+  } catch {
+    return;
+  } finally {
+    if (fd !== undefined) {
+      try {
+        closeSync(fd);
+      } catch {}
+    }
+  }
+}
 function parseConfig(raw) {
   if (isConfigV2(raw))
     return normalizeV2(raw);
@@ -796,8 +827,10 @@ function stringValue2(value) {
 function numberValue2(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
+var MAX_BACKGROUND_CONFIG_BYTES;
 var init_config = __esm(() => {
   init_config_v1_migration();
+  MAX_BACKGROUND_CONFIG_BYTES = 64 * 1024;
 });
 
 // src/mcp/config-helpers.ts
@@ -1050,7 +1083,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.56.0", INSTALL_CHANNEL = "npm";
+var VERSION = "0.57.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -1829,21 +1862,21 @@ var init_read = __esm(() => {
 });
 
 // src/sync/incognito.ts
-import { closeSync, fstatSync, openSync, readSync } from "node:fs";
+import { closeSync as closeSync2, fstatSync as fstatSync2, openSync as openSync2, readSync as readSync2 } from "node:fs";
 function textHasIncognitoMarker(text) {
   return text.includes(INCOGNITO_MARKER) || text.includes(COMMAND_NAME_MARKER);
 }
 function transcriptHasIncognitoMarker(path, maxBytes = MAX_SCAN_BYTES) {
   let fd;
   try {
-    fd = openSync(path, "r");
-    const size = Math.min(fstatSync(fd).size, maxBytes);
+    fd = openSync2(path, "r");
+    const size = Math.min(fstatSync2(fd).size, maxBytes);
     if (size === 0)
       return false;
     const buffer = Buffer.allocUnsafe(size);
     let offset = 0;
     while (offset < size) {
-      const read = readSync(fd, buffer, offset, size - offset, offset);
+      const read = readSync2(fd, buffer, offset, size - offset, offset);
       if (read === 0)
         break;
       offset += read;
@@ -1854,7 +1887,7 @@ function transcriptHasIncognitoMarker(path, maxBytes = MAX_SCAN_BYTES) {
   } finally {
     if (fd !== undefined) {
       try {
-        closeSync(fd);
+        closeSync2(fd);
       } catch {}
     }
   }
@@ -1902,6 +1935,7 @@ function loadSyncState(configDir = getConfigDir()) {
     const studiedSessions = Array.isArray(raw.mined_sessions) ? raw.mined_sessions.filter((record) => typeof record === "object" && record !== null && typeof record.at === "string" && typeof record.session === "string").map((record) => ({
       at: record.at,
       session: record.session,
+      ...typeof record.updated === "string" ? { updated: record.updated } : {},
       ...typeof record.project === "string" ? { project: record.project } : {}
     })) : [];
     const rawRefusal = raw.last_refusal;
@@ -4204,11 +4238,11 @@ var init_session_errors = __esm(() => {
 // src/config/config-lock.ts
 import { randomUUID } from "node:crypto";
 import {
-  closeSync as closeSync2,
+  closeSync as closeSync3,
   existsSync as existsSync8,
   linkSync,
   mkdirSync as mkdirSync5,
-  openSync as openSync2,
+  openSync as openSync3,
   readFileSync as readFileSync7,
   statSync as statSync3,
   unlinkSync,
@@ -4261,12 +4295,12 @@ async function acquireConfigRefreshLock(options) {
   }
 }
 function createLockFile(lockPath, metadata) {
-  const fd = openSync2(lockPath, "wx", 384);
+  const fd = openSync3(lockPath, "wx", 384);
   try {
     writeFileSync4(fd, JSON.stringify(metadata));
   } catch (cause) {
     try {
-      closeSync2(fd);
+      closeSync3(fd);
     } catch {}
     try {
       unlinkSync(lockPath);
@@ -4274,7 +4308,7 @@ function createLockFile(lockPath, metadata) {
     throw cause;
   }
   try {
-    closeSync2(fd);
+    closeSync3(fd);
   } catch (cause) {
     try {
       unlinkSync(lockPath);
@@ -11820,12 +11854,12 @@ var init_integrations = __esm(() => {
 
 // src/sessions/project-dir.ts
 import {
-  closeSync as closeSync3,
+  closeSync as closeSync4,
   existsSync as existsSync11,
   mkdirSync as mkdirSync7,
-  openSync as openSync3,
+  openSync as openSync4,
   readFileSync as readFileSync11,
-  readSync as readSync2,
+  readSync as readSync3,
   renameSync as renameSync3,
   statSync as statSync4,
   writeFileSync as writeFileSync7
@@ -11858,18 +11892,18 @@ function saveCacheFile(configDir, entries) {
 function readHead(path, bytes = HEAD_BYTES) {
   let fd;
   try {
-    fd = openSync3(path, "r");
+    fd = openSync4(path, "r");
   } catch {
     return null;
   }
   try {
     const buf = Buffer.alloc(bytes);
-    const read = readSync2(fd, buf, 0, bytes, 0);
+    const read = readSync3(fd, buf, 0, bytes, 0);
     return buf.subarray(0, read).toString("utf-8");
   } catch {
     return null;
   } finally {
-    closeSync3(fd);
+    closeSync4(fd);
   }
 }
 function cwdFromJsonlHead(text) {
@@ -13429,6 +13463,27 @@ function batchWatermark(batch) {
   }
   return newest;
 }
+function sessionKey(session) {
+  return `${session.harness}/${session.id}`;
+}
+function studiedRecords(sessions, at) {
+  return sessions.map((s) => ({
+    at,
+    session: sessionKey(s),
+    updated: s.updated,
+    ...s.project ? { project: s.project } : {}
+  }));
+}
+function lastStudiedSnapshot(history) {
+  const latest = new Map;
+  for (const record of history ?? []) {
+    const updated = record.updated ? Date.parse(record.updated) : Number.NaN;
+    if (!Number.isNaN(updated) && updated > (latest.get(record.session) ?? Number.NEGATIVE_INFINITY)) {
+      latest.set(record.session, updated);
+    }
+  }
+  return latest;
+}
 async function runKnowledgeSync(options = {}) {
   const deps = options.deps ?? {};
   const loadState = deps.loadState ?? loadSyncState;
@@ -13511,14 +13566,20 @@ async function runKnowledgeSync(options = {}) {
     }
     const worthStudying = deps.worthStudying ?? isWorthStudying;
     const isIncognito = deps.isIncognito ?? isIncognitoSession;
+    const studiedSnapshot = lastStudiedSnapshot(state.mined_sessions);
     const examined = [];
     const batch = [];
     let trivial = 0;
     let incognito = 0;
+    let alreadyStudied = 0;
     for (let i = ready.length - 1;i >= 0 && batch.length < MINE_BATCH_LIMIT; i--) {
       const candidate = ready[i];
       examined.push(candidate);
-      if (isIncognito(candidate)) {
+      const key = sessionKey(candidate);
+      if (Date.parse(candidate.updated) <= (studiedSnapshot.get(key) ?? Number.NEGATIVE_INFINITY)) {
+        alreadyStudied += 1;
+        logger.debug("sync", `skipping already-studied session ${key}`);
+      } else if (isIncognito(candidate)) {
         incognito += 1;
         logger.debug("sync", `skipping incognito session ${candidate.harness}/${candidate.id}`);
       } else if (worthStudying(candidate)) {
@@ -13527,7 +13588,7 @@ async function runKnowledgeSync(options = {}) {
         trivial += 1;
       }
     }
-    const skippedNote = `${trivial} trivial, ${incognito} incognito skipped`;
+    const skippedNote = `${trivial} trivial, ${incognito} incognito${alreadyStudied > 0 ? `, ${alreadyStudied} already studied` : ""} skipped`;
     if (batch.length === 0) {
       saveState({
         ...state,
@@ -13546,29 +13607,41 @@ async function runKnowledgeSync(options = {}) {
     }
     logger.debug("sync", `studying ${batch.length} of ${ready.length} ready sessions (${skippedNote})`);
     const learner = await deps.mine(batch);
+    const sessionTokens = deps.sessionTokens ?? estimateSessionTokens;
+    const noted = new Set(learner.notedSessions ?? []);
+    const notedBatch = batch.filter((s) => noted.has(sessionKey(s)));
+    const partialProgress = (at) => {
+      if (notedBatch.length === 0)
+        return {};
+      let tokens = 0;
+      for (const s of notedBatch)
+        tokens += sessionTokens(s);
+      logger.debug("sync", `recorded ${notedBatch.length} noted sessions from the ${learner.outcome} run`);
+      return {
+        mined_sessions: [...state.mined_sessions ?? [], ...studiedRecords(notedBatch, at)].slice(-STUDIED_HISTORY_LIMIT),
+        total_mined: (state.total_mined ?? 0) + notedBatch.length,
+        total_notes: (state.total_notes ?? 0) + learner.notesWritten,
+        total_learning_tokens: (state.total_learning_tokens ?? 0) + tokens
+      };
+    };
     switch (learner.outcome) {
       case "completed": {
         for (const s of batch) {
           logger.debug("sync", `studied session ${s.harness}/${s.id}`);
         }
-        const studiedAt = now().toISOString();
+        const completedAt = now().toISOString();
         const history = [
           ...state.mined_sessions ?? [],
-          ...batch.map((s) => ({
-            at: studiedAt,
-            session: `${s.harness}/${s.id}`,
-            ...s.project ? { project: s.project } : {}
-          }))
+          ...studiedRecords(batch, completedAt)
         ].slice(-STUDIED_HISTORY_LIMIT);
         const watermark = batchWatermark(examined);
-        const sessionTokens = deps.sessionTokens ?? estimateSessionTokens;
         let batchTokens = 0;
         for (const s of batch)
           batchTokens += sessionTokens(s);
         saveState({
           ...state,
           watermark,
-          last_attempt_at: studiedAt,
+          last_attempt_at: completedAt,
           consecutive_failures: 0,
           mined_sessions: history,
           total_mined: (state.total_mined ?? 0) + batch.length,
@@ -13588,10 +13661,12 @@ async function runKnowledgeSync(options = {}) {
       }
       case "consent_off":
       case "credit_limit":
-      case "quota_exceeded": {
+      case "quota_exceeded":
+      case "claude_code_missing": {
         const at = now().toISOString();
         saveState({
           ...state,
+          ...partialProgress(at),
           last_attempt_at: at,
           consecutive_failures: 0,
           last_refusal: {
@@ -13600,13 +13675,14 @@ async function runKnowledgeSync(options = {}) {
             message: learner.message ?? "Studying unavailable right now."
           }
         });
-        logger.debug("sync", `studying skipped by gateway: ${learner.outcome}`);
+        logger.debug("sync", `studying skipped: ${learner.outcome}`);
         return { status: "skipped-gateway", ...base, studiedSessions: 0, learner };
       }
       default: {
         const at = now().toISOString();
         saveState({
           ...state,
+          ...partialProgress(at),
           last_attempt_at: at,
           consecutive_failures: state.consecutive_failures + 1,
           ...learner.outcome === "gateway_rejected" && learner.message ? { last_refusal: { at, outcome: learner.outcome, message: learner.message } } : {}
@@ -13637,7 +13713,7 @@ var init_sync = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "2f023ff0-da66-217c-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "6712b11a-8117-30cb-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -13862,12 +13938,19 @@ function consumeCommandFacets() {
 function allowlisted(value, allowed) {
   return typeof value === "string" && allowed.has(value) ? value : undefined;
 }
+function matching(value, pattern) {
+  return typeof value === "string" && pattern.test(value) ? value : undefined;
+}
 function sanitizeFacets(facets) {
   if (!facets || typeof facets !== "object")
     return {};
   const trigger = allowlisted(facets.sync_trigger, SYNC_TRIGGERS);
   const status = allowlisted(facets.sync_status, SYNC_STATUSES);
   const learner = allowlisted(facets.learner_outcome, LEARNER_OUTCOMES);
+  const gatewayReason = allowlisted(facets.gateway_reason, GATEWAY_REASONS);
+  const claudeSource = allowlisted(facets.claude_code_source, CLAUDE_CODE_SOURCES);
+  const claudeVersion = matching(facets.claude_code_version, CLAUDE_CODE_VERSION_PATTERN);
+  const model = matching(facets.learner_model, LEARNER_MODEL_PATTERN);
   const backfill = allowlisted(facets.backfill_offer, BACKFILL_OFFERS);
   return {
     ...trigger ? { sync_trigger: trigger } : {},
@@ -13875,6 +13958,10 @@ function sanitizeFacets(facets) {
     ...facets.sessions_studied !== undefined ? { sessions_studied: countBucket(facets.sessions_studied) } : {},
     ...facets.notes_written !== undefined ? { notes_written: countBucket(facets.notes_written) } : {},
     ...learner ? { learner_outcome: learner } : {},
+    ...gatewayReason ? { gateway_reason: gatewayReason } : {},
+    ...claudeSource ? { claude_code_source: claudeSource } : {},
+    ...claudeVersion ? { claude_code_version: claudeVersion } : {},
+    ...model ? { learner_model: model } : {},
     ...backfill ? { backfill_offer: backfill } : {}
   };
 }
@@ -13964,7 +14051,13 @@ function parseSentryDsn(value) {
     return null;
   }
 }
-function sentryTags(command, context, runtime, error) {
+function sentryTags(command, context, runtime, error, facets) {
+  const facetTags = {};
+  for (const key of SENTRY_FACET_TAGS) {
+    const value = facets[key];
+    if (value)
+      facetTags[key] = value;
+  }
   return {
     schema_version: "1",
     command,
@@ -13980,9 +14073,21 @@ function sentryTags(command, context, runtime, error) {
     is_authenticated: String(context.isAuthenticated),
     ...error.code ? { error_code: error.code } : {},
     ...error.status ? { http_status: String(error.status) } : {},
-    ...error.exitCode === undefined ? {} : { exit_code: String(error.exitCode) }
+    ...error.exitCode === undefined ? {} : { exit_code: String(error.exitCode) },
+    ...facetTags
   };
 }
+function failedLearnerOutcome(facets) {
+  return facets.learner_outcome === "completed" ? undefined : facets.learner_outcome;
+}
+function exceptionSummary(command, error, facets) {
+  if (facets.learner_outcome === "completed")
+    return error.code ?? error.type;
+  const outcome = facets.learner_outcome ?? facets.sync_status;
+  if (!outcome)
+    return error.code ?? error.type;
+  return `${command}: ${outcome}${facets.gateway_reason ? ` (${facets.gateway_reason})` : ""}`;
+}
 function buildSentryEnvelope(input) {
   const parsedDsn = parseSentryDsn(input.dsn);
   if (!parsedDsn || !validEventId(input.eventId))
@@ -13990,6 +14095,7 @@ function buildSentryEnvelope(input) {
   const context = normalizeContext(input.context);
   const runtime = normalizeRuntime(input.runtime);
   const command = canonicalCommand(input.command);
+  const facets = sanitizeFacets(input.facets);
   const debugId = validDebugId(input.debugId) ? input.debugId.toLowerCase() : undefined;
   const error = {
     type: validErrorType(input.error.type) ? input.error.type : "Error",
@@ -14009,7 +14115,7 @@ function buildSentryEnvelope(input) {
   };
   const exceptionValue = {
     type: error.type,
-    value: error.code ?? error.type,
+    value: exceptionSummary(command, error, facets),
     ...error.frames.length > 0 ? { stacktrace: { frames: error.frames } } : {}
   };
   const newestFrame = error.frames.at(-1);
@@ -14022,7 +14128,7 @@ function buildSentryEnvelope(input) {
     platform: "node",
     level: "error",
     release: `dosu-cli@${runtime.version}`,
-    tags: sentryTags(command, context, runtime, error),
+    tags: sentryTags(command, context, runtime, error, facets),
     ...context.user ? {
       user: {
         id: context.user.id,
@@ -14034,7 +14140,15 @@ function buildSentryEnvelope(input) {
         images: [{ type: "sourcemap", code_file: BUNDLE_CODE_FILE, debug_id: debugId }]
       }
     } : {},
-    fingerprint: ["dosu-cli", command, error.type, error.code ?? "unknown", safeCallsite],
+    fingerprint: [
+      "dosu-cli",
+      command,
+      error.type,
+      error.code ?? "unknown",
+      safeCallsite,
+      ...failedLearnerOutcome(facets) ? [facets.learner_outcome] : [],
+      ...facets.gateway_reason ? [facets.gateway_reason] : []
+    ],
     exception: { values: [exceptionValue] }
   };
   const envelopeHeader = {
@@ -14275,15 +14389,17 @@ function createCommandTelemetry(settings, dependencies = {}) {
   async function dispatch(result, exitCode, error) {
     try {
       const tasks = [];
+      let facets;
+      if (!disabled) {
+        try {
+          facets = resolveFacets();
+        } catch {
+          facets = undefined;
+        }
+      }
       if (!disabled && analyticsToken) {
         const id = context.user?.id ?? installId();
         if (id) {
-          let facets;
-          try {
-            facets = resolveFacets();
-          } catch {
-            facets = undefined;
-          }
           const payload = buildPostHogPayload({
             apiKey: analyticsToken,
             ...context.user ? {} : { installId: id },
@@ -14311,14 +14427,16 @@ function createCommandTelemetry(settings, dependencies = {}) {
           }
         }
       }
-      if (!disabled && result === "failure" && error && shouldSendToSentry(error) && sentryDsn) {
+      const sentryError = result === "failure" && error && shouldSendToSentry(error) ? error : result === "success" && sanitizeFacets(facets).sync_status === "mine-failed" ? { type: "LearnerRunFailed", frames: [] } : undefined;
+      if (!disabled && sentryError && sentryDsn) {
         const id = eventId(generateUuid);
         const envelope = id ? buildSentryEnvelope({
           dsn: sentryDsn,
           command,
           context,
           runtime,
-          error,
+          error: sentryError,
+          ...facets ? { facets } : {},
           eventId: id,
           timestampMs: safeNow(now),
           debugId: BUNDLE_DEBUG_ID_PLACEHOLDER
@@ -14370,7 +14488,7 @@ function createCommandTelemetry(settings, dependencies = {}) {
 function shouldSendToSentry(error) {
   return !["SESSION_EXPIRED", "SESSION_PERSISTENCE_ERROR"].includes(error.code ?? "");
 }
-var REQUEST_TIMEOUT_MS = 500, MAX_RESPONSE_BYTES, MAX_STACK_FRAMES = 20, UNKNOWN_COMMAND = "unknown", FALLBACK_INSTALL_ID = "00000000-0000-4000-8000-000000000000", BUNDLE_CODE_FILE = "app:///bin/dosu.js", CLI_PACKAGE_ROOT, SAFE_ERROR_TYPES, SAFE_ERROR_CODES, SYNC_TRIGGERS, SYNC_STATUSES, LEARNER_OUTCOMES, BACKFILL_OFFERS, pendingFacets;
+var REQUEST_TIMEOUT_MS = 500, MAX_RESPONSE_BYTES, MAX_STACK_FRAMES = 20, UNKNOWN_COMMAND = "unknown", FALLBACK_INSTALL_ID = "00000000-0000-4000-8000-000000000000", BUNDLE_CODE_FILE = "app:///bin/dosu.js", CLI_PACKAGE_ROOT, SAFE_ERROR_TYPES, SAFE_ERROR_CODES, SYNC_TRIGGERS, SYNC_STATUSES, LEARNER_OUTCOMES, GATEWAY_REASONS, CLAUDE_CODE_SOURCES, CLAUDE_CODE_VERSION_PATTERN, LEARNER_MODEL_PATTERN, BACKFILL_OFFERS, SENTRY_FACET_TAGS, pendingFacets;
 var init_telemetry = __esm(() => {
   MAX_RESPONSE_BYTES = 1024 * 1024;
   CLI_PACKAGE_ROOT = detectCliPackageRoot();
@@ -14381,6 +14499,7 @@ var init_telemetry = __esm(() => {
     "CliUsageError",
     "CommandExitError",
     "Error",
+    "LearnerRunFailed",
     "OAuthCallbackError",
     "RangeError",
     "ReferenceError",
@@ -14474,8 +14593,21 @@ var init_telemetry = __esm(() => {
     "credit_limit",
     "quota_exceeded",
     "gateway_rejected",
+    "claude_code_missing",
     "error"
   ]);
+  GATEWAY_REASONS = new Set([
+    "system_role_unsupported",
+    "adaptive_thinking_unsupported",
+    "effort_unsupported",
+    "unsupported_request",
+    "max_tokens",
+    "context_length",
+    "other"
+  ]);
+  CLAUDE_CODE_SOURCES = new Set(["sdk", "system", "missing"]);
+  CLAUDE_CODE_VERSION_PATTERN = /^\d{1,4}\.\d{1,4}\.\d{1,6}(?:-[0-9A-Za-z]{1,16}(?:\.[0-9A-Za-z]{1,16}){0,3})?$/;
+  LEARNER_MODEL_PATTERN = /^claude-[a-z0-9.-]{1,56}$/;
   BACKFILL_OFFERS = new Set([
     "not-offered",
     "accepted",
@@ -14483,6 +14615,15 @@ var init_telemetry = __esm(() => {
     "cancelled",
     "spawn-failed"
   ]);
+  SENTRY_FACET_TAGS = [
+    "sync_trigger",
+    "sync_status",
+    "learner_outcome",
+    "gateway_reason",
+    "claude_code_source",
+    "claude_code_version",
+    "learner_model"
+  ];
 });
 
 // src/commands/agent-select.ts
@@ -15073,12 +15214,14 @@ function buildLearnerEnv(options) {
   const headers = [
     `x-dosu-run-id: ${options.runID}`,
     `x-dosu-trigger: ${options.trigger}`,
-    `x-dosu-cli-version: ${options.cliVersion}`
+    `x-dosu-cli-version: ${options.cliVersion}`,
+    `x-dosu-expected-model: ${options.model}`
   ];
   if (options.deploymentID)
     headers.push(`x-dosu-deployment-id: ${options.deploymentID}`);
   env.ANTHROPIC_BASE_URL = options.gatewayURL;
   env.ANTHROPIC_AUTH_TOKEN = options.apiKey;
+  env.ANTHROPIC_MODEL = options.model;
   env.ANTHROPIC_CUSTOM_HEADERS = headers.join(`
 `);
   env.CLAUDE_CONFIG_DIR = options.configDir;
@@ -15095,7 +15238,7 @@ var init_env = __esm(() => {
 });
 
 // src/learner/executable.ts
-import { accessSync, constants, existsSync as existsSync16 } from "node:fs";
+import { accessSync, constants as constants2, existsSync as existsSync16 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { homedir as homedir6 } from "node:os";
 import { delimiter as delimiter2, dirname as dirname6, join as join16 } from "node:path";
@@ -15114,7 +15257,7 @@ function sdkNativeBinaryExists() {
 }
 function isExecutable(path) {
   try {
-    accessSync(path, constants.X_OK);
+    accessSync(path, constants2.X_OK);
     return true;
   } catch {
     return false;
@@ -15136,11 +15279,44 @@ function findSystemClaude(env = process.env, homeDir = homedir6()) {
 function resolveClaudeExecutable(options = {}) {
   const hasSdkBinary = options.sdkBinaryExists ?? sdkNativeBinaryExists;
   if (hasSdkBinary())
-    return;
-  return findSystemClaude(options.env, options.homeDir);
+    return { kind: "sdk" };
+  const path = findSystemClaude(options.env, options.homeDir);
+  return path ? { kind: "system", path } : { kind: "missing" };
 }
 var init_executable = () => {};
 
+// src/learner/model.ts
+async function resolveServedModel(options) {
+  const fetchImpl = options.fetchImpl ?? fetch;
+  try {
+    const base = options.gatewayURL.replace(/\/+$/, "");
+    const resp = await fetchImpl(`${base}/capabilities`, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${options.apiKey}` },
+      signal: AbortSignal.timeout(options.timeoutMs ?? CAPABILITIES_TIMEOUT_MS)
+    });
+    if (!resp.ok) {
+      logger.debug("learner", `gateway capabilities returned ${resp.status}; using default model`);
+      return DEFAULT_LEARNER_MODEL;
+    }
+    const body = await resp.json();
+    const model = body?.model;
+    if (typeof model === "string" && CLAUDE_MODEL_PATTERN.test(model))
+      return model;
+    logger.debug("learner", "gateway capabilities named no usable model; using default model");
+    return DEFAULT_LEARNER_MODEL;
+  } catch (error) {
+    const text = error instanceof Error ? error.message : String(error);
+    logger.debug("learner", `gateway capabilities failed (${text}); using default model`);
+    return DEFAULT_LEARNER_MODEL;
+  }
+}
+var DEFAULT_LEARNER_MODEL = "claude-haiku-4-5", CAPABILITIES_TIMEOUT_MS = 5000, CLAUDE_MODEL_PATTERN;
+var init_model = __esm(() => {
+  init_logger();
+  CLAUDE_MODEL_PATTERN = /^claude-[a-z0-9.-]+$/;
+});
+
 // src/learner/prompt.ts
 function buildLearnerSystemPrompt(coreRules) {
   return `You are Dosu's knowledge learner. You read a developer's recent coding-agent sessions and save the durable, non-obvious findings to the team's shared knowledge base so future teammates and agents do not have to rediscover them.
@@ -58104,6 +58280,13 @@ function snippet(value) {
   const flat = (text ?? "").replace(/\s+/g, " ").trim();
   return flat.length > TRACE_SNIPPET_LIMIT ? `${flat.slice(0, TRACE_SNIPPET_LIMIT)}…` : flat;
 }
+function classifyRejectionReason(detail) {
+  for (const [pattern, reason] of REJECTION_REASONS) {
+    if (pattern.test(detail))
+      return reason;
+  }
+  return "other";
+}
 function classifyGatewayRejection(text) {
   const match = API_400_PATTERN.exec(text);
   if (!match)
@@ -58116,7 +58299,8 @@ function classifyGatewayRejection(text) {
   } catch {}
   return {
     outcome: "gateway_rejected",
-    message: `LLM gateway rejected the study run: ${snippet(detail)}`
+    message: `LLM gateway rejected the study run: ${snippet(detail)}`,
+    reason: classifyRejectionReason(detail.trim())
   };
 }
 function traceAgentMessage(message) {
@@ -58164,11 +58348,26 @@ async function runLearner(options) {
       message: "LLM gateway URL is not set. From source, use `bun run dev` (production endpoints) or `bun run dev:local` (local stack)."
     };
   }
-  await Promise.resolve().then(() => init_sdk());
   const claudeExecutable = resolveClaudeExecutable();
-  if (claudeExecutable) {
-    logger.debug("learner", `using system Claude Code executable: ${claudeExecutable}`);
+  if (claudeExecutable.kind === "missing") {
+    return {
+      outcome: "claude_code_missing",
+      notesWritten: 0,
+      turns: 0,
+      claudeCodeSource: "missing",
+      message: "Studying runs on Claude Code, which isn't installed here. Install Claude Code, then run `dosu knowledge sync`."
+    };
   }
+  if (claudeExecutable.kind === "system") {
+    logger.debug("learner", `using system Claude Code executable: ${claudeExecutable.path}`);
+  }
+  const model = await resolveServedModel({ gatewayURL, apiKey: options.apiKey });
+  logger.debug("learner", `study run model: ${model}`);
+  const diagnostics = {
+    claudeCodeSource: claudeExecutable.kind,
+    model
+  };
+  await Promise.resolve().then(() => init_sdk());
   const configDir = createRunConfigDir();
   const runID = options.runID ?? crypto.randomUUID();
   const sessionStartedAt = options.sessions.map((s) => s.updated).sort()[0];
@@ -58179,7 +58378,19 @@ async function runLearner(options) {
   let notesWritten = 0;
   let currentSession;
   const readsSinceWrite = new Set;
+  const sessionKeys = new Map(options.sessions.map((s) => [s.id, `${s.harness}/${s.id}`]));
+  const notedSessions = new Set;
+  const pendingNotes = new Map;
   let turns = 0;
+  const finish = (outcome, message, gatewayReason) => ({
+    outcome,
+    notesWritten,
+    notedSessions: [...notedSessions],
+    turns,
+    ...message === undefined ? {} : { message },
+    ...gatewayReason ? { gatewayReason } : {},
+    ...diagnostics
+  });
   const env = buildLearnerEnv({
     apiKey: options.apiKey,
     gatewayURL,
@@ -58187,19 +58398,21 @@ async function runLearner(options) {
     runID,
     trigger: options.trigger,
     cliVersion: getVersionString(),
-    deploymentID: options.deploymentID
+    deploymentID: options.deploymentID,
+    model
   });
   try {
     const run = PGt({
       prompt: buildLearnerPrompt(options.sessions),
       options: {
         systemPrompt: buildLearnerSystemPrompt(LEARNER_CORE_RULES),
+        model,
         env,
         abortController: abort,
         maxTurns: options.maxTurns ?? DEFAULT_MAX_TURNS,
         settingSources: [],
         persistSession: false,
-        ...claudeExecutable ? { pathToClaudeCodeExecutable: claudeExecutable } : {},
+        ...claudeExecutable.kind === "system" ? { pathToClaudeCodeExecutable: claudeExecutable.path } : {},
         sandbox: { enabled: true, failIfUnavailable: false },
         mcpServers: {
           [SESSIONS_SERVER_NAME]: createSessionToolsServer(options.sessions),
@@ -58215,7 +58428,7 @@ async function runLearner(options) {
           }
         },
         stderr: (data) => logger.debug("learner", `[sdk] ${data}`),
-        canUseTool: async (toolName, input) => {
+        canUseTool: async (toolName, input, { toolUseID }) => {
           if (!allowed.has(toolName)) {
             return {
               behavior: "deny",
@@ -58246,6 +58459,9 @@ async function runLearner(options) {
             }
             notesWritten += 1;
             readsSinceWrite.clear();
+            const noted = currentSession && sessionKeys.get(currentSession);
+            if (noted)
+              pendingNotes.set(toolUseID, noted);
             const { transcript_id: _authoredByModel, ...clean } = input;
             return {
               behavior: "allow",
@@ -58258,56 +58474,46 @@ async function runLearner(options) {
     });
     for await (const message of run) {
       traceAgentMessage(message);
+      if (message.type === "user" && Array.isArray(message.message.content)) {
+        for (const block of message.message.content) {
+          const noted = block.type === "tool_result" && pendingNotes.get(block.tool_use_id);
+          if (noted && block.is_error !== true)
+            notedSessions.add(noted);
+        }
+      }
+      if (message.type === "system" && message.subtype === "init" && typeof message.claude_code_version === "string") {
+        diagnostics.claudeCodeVersion = message.claude_code_version;
+      }
       if (message.type === "result") {
         turns = message.num_turns;
         const text = message.subtype === "success" ? message.result : message.subtype;
         const gatewayError = classifyGatewayError(text ?? "") ?? (message.is_error ? classifyGatewayRejection(text ?? "") : null);
         if (gatewayError) {
-          return {
-            outcome: gatewayError.outcome,
-            notesWritten,
-            turns,
-            message: gatewayError.message
-          };
+          return finish(gatewayError.outcome, gatewayError.message, gatewayError.reason);
         }
         if (message.subtype !== "success" || message.is_error) {
           logger.debug("learner", `run ${runID} failed: ${text}`);
-          return {
-            outcome: "error",
-            notesWritten,
-            turns,
-            message: "Study run failed; see debug log for details."
-          };
+          return finish("error", "Study run failed; see debug log for details.");
         }
         logger.debug("learner", `run ${runID} completed: ${turns} turns, ${notesWritten} suggested pages`);
-        return { outcome: "completed", notesWritten, turns, message: text };
+        return finish("completed", text);
       }
     }
-    return {
-      outcome: "error",
-      notesWritten,
-      turns,
-      message: "Study run ended without a result."
-    };
+    return finish("error", "Study run ended without a result.");
   } catch (error) {
     const text = error instanceof Error ? error.message : String(error);
     const gatewayError = classifyGatewayError(text) ?? classifyGatewayRejection(text);
     if (gatewayError) {
-      return { outcome: gatewayError.outcome, notesWritten, turns, message: gatewayError.message };
+      return finish(gatewayError.outcome, gatewayError.message, gatewayError.reason);
     }
     logger.debug("learner", `run ${runID} threw: ${text}`);
-    return {
-      outcome: "error",
-      notesWritten,
-      turns,
-      message: abort.signal.aborted ? "Study run timed out and was aborted." : "Study run failed; see debug log for details."
-    };
+    return finish("error", abort.signal.aborted ? "Study run timed out and was aborted." : "Study run failed; see debug log for details.");
   } finally {
     clearTimeout(timer);
     configDir.cleanup();
   }
 }
-var DEFAULT_MAX_TURNS = 160, DEFAULT_MAX_NOTES = 80, DEFAULT_TIMEOUT_MS2, KNOWLEDGE_SERVER_NAME = "dosu", GATEWAY_ERRORS, TRACE_SNIPPET_LIMIT = 400, API_400_PATTERN;
+var DEFAULT_MAX_TURNS = 160, DEFAULT_MAX_NOTES = 80, DEFAULT_TIMEOUT_MS2, KNOWLEDGE_SERVER_NAME = "dosu", GATEWAY_ERRORS, TRACE_SNIPPET_LIMIT = 400, REJECTION_REASONS, API_400_PATTERN;
 var init_runner = __esm(() => {
   init_logger();
   init_config_helpers();
@@ -58316,6 +58522,7 @@ var init_runner = __esm(() => {
   init_conflicts();
   init_env();
   init_executable();
+  init_model();
   init_tools();
   DEFAULT_TIMEOUT_MS2 = 30 * 60 * 1000;
   GATEWAY_ERRORS = {
@@ -58332,6 +58539,14 @@ var init_runner = __esm(() => {
       message: "Daily Dosu Remote Sessions budget reached; runs resume tomorrow."
     }
   };
+  REJECTION_REASONS = [
+    [/^dosu_unsupported_request:/, "unsupported_request"],
+    [/\beffort\b|output_config/i, "effort_unsupported"],
+    [/\brole\b.*\bsystem\b|\bsystem\b.*\brole\b|messages\.\d+\.role/i, "system_role_unsupported"],
+    [/\badaptive\b/i, "adaptive_thinking_unsupported"],
+    [/prompt is too long|context (?:limit|length|window)/i, "context_length"],
+    [/max_tokens/i, "max_tokens"]
+  ];
   API_400_PATTERN = /API Error: 400\b\s*(.*)/s;
 });
 
@@ -58495,7 +58710,7 @@ ${results.length - opts.limit} more results not shown.`));
       sync_status: outcome.status,
       sessions_studied: sessionsStudied,
       notes_written: notesWritten,
-      ...outcome.learner ? { learner_outcome: outcome.learner.outcome } : {}
+      ...outcome.learner ? learnerFacets(outcome.learner) : {}
     });
     if (opts.quiet)
       return;
@@ -58555,6 +58770,15 @@ ${results.length - opts.limit} more results not shown.`));
   cmd.addCommand(statuslineCommand2());
   return cmd;
 }
+function learnerFacets(learner) {
+  return {
+    learner_outcome: learner.outcome,
+    ...learner.gatewayReason ? { gateway_reason: learner.gatewayReason } : {},
+    ...learner.claudeCodeSource ? { claude_code_source: learner.claudeCodeSource } : {},
+    ...learner.claudeCodeVersion ? { claude_code_version: learner.claudeCodeVersion } : {},
+    ...learner.model ? { learner_model: learner.model } : {}
+  };
+}
 function buildLearner(trigger) {
   const cfg = loadConfig();
   if (cfg.mode === "oss")
@@ -60533,6 +60757,10 @@ function runUpgrade(channel = INSTALL_CHANNEL, options = {}) {
     }
     manager = owningPackageManager(options.entrypoint ?? process.argv[1], platform, options.comSpec, env, cwd);
     if (!manager) {
+      if (env.DOSU_DEV === "true") {
+        console.log("DOSU_DEV=true and this copy is not a global package: skipping the package install.");
+        return 0;
+      }
       printNonGlobalPackageGuidance();
       return 1;
     }
@@ -60565,6 +60793,41 @@ Could not update Dosu automatically.`);
   console.log('Run "dosu --version" to verify.');
   return 0;
 }
+function postUpgradeArgs(interactive) {
+  return interactive ? ["setup"] : ["mcp", "refresh"];
+}
+function newBinaryInvocation(channel, args, entrypoint = process.argv[1], execPath = process.execPath) {
+  if (channel === "npm") {
+    return entrypoint ? { command: execPath, args: [entrypoint, ...args] } : null;
+  }
+  if (channel === "homebrew") {
+    return { command: "dosu", args };
+  }
+  return null;
+}
+function isInteractiveTerminal() {
+  return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+function setupAgentsWithNewBinary(channel, options) {
+  const interactive = options.interactive ?? isInteractiveTerminal();
+  const invocation = newBinaryInvocation(channel, postUpgradeArgs(interactive), options.entrypoint ?? process.argv[1]);
+  if (!invocation) {
+    console.error(SETUP_FALLBACK);
+    return;
+  }
+  console.log(interactive ? `
+Running setup with the new version to update your AI agents...
+` : `
+Refreshing agent MCP configs with the new version...`);
+  const result = spawnSync(invocation.command, invocation.args, {
+    cwd: options.cwd ?? homedir9(),
+    shell: false,
+    stdio: "inherit"
+  });
+  if (result.error || result.status !== 0) {
+    console.error(SETUP_FALLBACK);
+  }
+}
 async function completeUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   const status = runUpgrade(channel, options);
   if (status !== 0)
@@ -60580,16 +60843,17 @@ async function completeUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   } catch {
     console.error('Skills could not be refreshed. Run "dosu skill update" to retry.');
   }
+  setupAgentsWithNewBinary(channel, options);
   return 0;
 }
 function upgradeCommand() {
-  return new Command("upgrade").description("Update Dosu to the latest version and refresh agent skills").action(async () => {
+  return new Command("upgrade").description("Update Dosu to the latest version, then re-run setup to update your AI agents").action(async () => {
     const status = await completeUpgrade();
     if (status !== 0)
       process.exitCode = status;
   });
 }
-var import_picocolors31, PACKAGE_NAME = "@dosu/cli", LATEST_PACKAGE, BREW_MANUAL_COMMAND = "brew upgrade dosu-ai/dosu/dosu", NPX_COMMAND = "npx -y @dosu/cli@latest", PROBE_TIMEOUT_MS = 5000, RELEASES_URL = "https://github.com/dosu-ai/dosu-cli/releases/latest", PACKAGE_MANAGERS;
+var import_picocolors31, PACKAGE_NAME = "@dosu/cli", LATEST_PACKAGE, BREW_MANUAL_COMMAND = "brew upgrade dosu-ai/dosu/dosu", NPX_COMMAND = "npx -y @dosu/cli@latest", PROBE_TIMEOUT_MS = 5000, RELEASES_URL = "https://github.com/dosu-ai/dosu-cli/releases/latest", PACKAGE_MANAGERS, SETUP_FALLBACK = 'Run "dosu setup" to finish updating your AI agents.';
 var init_upgrade = __esm(() => {
   init_commander();
   init_skill();
@@ -60615,7 +60879,7 @@ var init_upgrade = __esm(() => {
 });
 
 // src/debug/follow.ts
-import { closeSync as closeSync5, openSync as openSync5, readSync as readSync4, statSync as statSync8 } from "node:fs";
+import { closeSync as closeSync6, openSync as openSync6, readSync as readSync5, statSync as statSync8 } from "node:fs";
 function createLogFollower(path, emit) {
   const sizeOf = () => {
     try {
@@ -60633,15 +60897,15 @@ function createLogFollower(path, emit) {
       if (size === offset)
         return;
       try {
-        const fd = openSync5(path, "r");
+        const fd = openSync6(path, "r");
         try {
           const buf = Buffer.alloc(size - offset);
-          const read = readSync4(fd, buf, 0, buf.length, offset);
+          const read = readSync5(fd, buf, 0, buf.length, offset);
           offset += read;
           if (read > 0)
             emit(buf.toString("utf-8", 0, read));
         } finally {
-          closeSync5(fd);
+          closeSync6(fd);
         }
       } catch {}
     }
@@ -61319,6 +61583,36 @@ var init_providers = __esm(() => {
   init_zed();
 });
 
+// src/mcp/refresh.ts
+function configuredProviders() {
+  return allSetupProviders().filter((provider) => {
+    try {
+      return provider.isInstalled() && provider.isConfigured();
+    } catch {
+      return false;
+    }
+  });
+}
+function refreshConfiguredProviders(cfg) {
+  const result = { updated: [], failed: [] };
+  for (const provider of configuredProviders()) {
+    try {
+      provider.install(cfg, true);
+      logger.info("mcp", `Refreshed ${provider.name()} MCP entry`);
+      result.updated.push(provider);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      logger.error("mcp", `Refresh failed for ${provider.name()}: ${error.message}`);
+      result.failed.push({ provider, error });
+    }
+  }
+  return result;
+}
+var init_refresh = __esm(() => {
+  init_logger();
+  init_providers();
+});
+
 // src/version/update-check.ts
 import { existsSync as existsSync23, mkdirSync as mkdirSync13, readFileSync as readFileSync22, writeFileSync as writeFileSync14 } from "node:fs";
 import { join as join39 } from "node:path";
@@ -61474,15 +61768,98 @@ var init_update_check = __esm(() => {
   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 join40 } from "node:path";
+function needsMcpRefresh(previous, current) {
+  if (previous === null)
+    return true;
+  if (previous === current)
+    return false;
+  const [older, newer] = isNewerVersion(current, previous) ? [previous, current] : [current, previous];
+  return MCP_FORMAT_CHANGES.some((change) => isNewerVersion(change, older) && !isNewerVersion(change, newer));
+}
+function getCachePath4() {
+  return join40(getConfigDir(), CACHE_FILENAME5);
+}
+function readMcpRefreshCache() {
+  try {
+    const path = getCachePath4();
+    if (!existsSync24(path))
+      return null;
+    const data = JSON.parse(readFileSync23(path, "utf-8"));
+    if (typeof data?.version === "string")
+      return { version: data.version };
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeMcpRefreshCache(cache) {
+  try {
+    const dir = getConfigDir();
+    if (!existsSync24(dir)) {
+      mkdirSync14(dir, { recursive: true, mode: 448 });
+    }
+    writeFileSync15(getCachePath4(), JSON.stringify(cache), { mode: 384 });
+  } catch {}
+}
+function canRefreshMcp(cfg) {
+  const target = cfg.active_account?.target;
+  if (!target?.api_key)
+    return false;
+  return cfg.mode === MODE_OSS || Boolean(target.deployment_id);
+}
+function displayNotice3(names) {
+  console.error(`
+${import_picocolors33.default.green(`✓ Dosu ${VERSION}: refreshed MCP config for ${names.join(", ")}`)}
+` + `${import_picocolors33.default.dim(`  Run ${import_picocolors33.default.cyan('"dosu setup"')} to also update skills, hooks, and rules, then restart your AI agents.`)}
+`);
+}
+function checkForMcpRefresh(options = {}) {
+  const notify = options.notify ?? true;
+  try {
+    const previous = readMcpRefreshCache()?.version ?? null;
+    if (previous === VERSION)
+      return;
+    if (!needsMcpRefresh(previous, VERSION)) {
+      writeMcpRefreshCache({ version: VERSION });
+      return;
+    }
+    const cfg = loadConfigNonBlocking();
+    if (!cfg || !canRefreshMcp(cfg)) {
+      logger.debug("mcp-refresh", "Skipping MCP refresh: no API key or deployment configured");
+      return;
+    }
+    const result = refreshConfiguredProviders(cfg);
+    writeMcpRefreshCache({ version: VERSION });
+    logger.info("mcp-refresh", `Version ${VERSION}: refreshed ${result.updated.length}, failed ${result.failed.length}`);
+    if (notify && result.updated.length > 0) {
+      displayNotice3(result.updated.map((provider) => provider.name()));
+    }
+  } catch (err) {
+    logger.error("mcp-refresh", `MCP refresh check failed: ${err}`);
+  }
+}
+var import_picocolors33, CACHE_FILENAME5 = "mcp-refresh.json", MCP_FORMAT_CHANGES;
+var init_mcp_refresh_check = __esm(() => {
+  init_config();
+  init_logger();
+  init_refresh();
+  init_update_check();
+  import_picocolors33 = __toESM(require_picocolors(), 1);
+  MCP_FORMAT_CHANGES = ["0.53.0"];
+});
+
 // src/rules/installer.ts
-import { existsSync as existsSync24, mkdirSync as mkdirSync14, readFileSync as readFileSync23, unlinkSync as unlinkSync5, writeFileSync as writeFileSync15 } from "node:fs";
+import { existsSync as existsSync25, mkdirSync as mkdirSync15, readFileSync as readFileSync24, unlinkSync as unlinkSync5, writeFileSync as writeFileSync16 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
-import { dirname as dirname11, join as join40 } from "node:path";
+import { dirname as dirname11, join as join41 } from "node:path";
 function claudeConfigDir4() {
-  return process.env.CLAUDE_CONFIG_DIR || join40(homedir12(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join41(homedir12(), ".claude");
 }
 function codexHome4() {
-  return process.env.CODEX_HOME || join40(homedir12(), ".codex");
+  return process.env.CODEX_HOME || join41(homedir12(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -61508,17 +61885,17 @@ async function fetchDosuRule(fetchImpl = globalThis.fetch) {
   return normalizeRule(FALLBACK_DOSU_RULE);
 }
 function ensureParent(path) {
-  mkdirSync14(dirname11(path), { recursive: true });
+  mkdirSync15(dirname11(path), { recursive: true });
 }
 function writeIfChanged(path, content) {
-  if (!existsSync24(path)) {
+  if (!existsSync25(path)) {
     ensureParent(path);
-    writeFileSync15(path, content, "utf-8");
+    writeFileSync16(path, content, "utf-8");
     return "created";
   }
-  if (readFileSync23(path, "utf-8") === content)
+  if (readFileSync24(path, "utf-8") === content)
     return "unchanged";
-  writeFileSync15(path, content, "utf-8");
+  writeFileSync16(path, content, "utf-8");
   return "updated";
 }
 function findSection(content) {
@@ -61544,14 +61921,14 @@ function buildSection(content, lineEnding = `
   return `${DOSU_RULE_SECTION_START}${lineEnding}${body}${lineEnding}${DOSU_RULE_SECTION_END}`;
 }
 function upsertSection(path, content) {
-  if (!existsSync24(path)) {
+  if (!existsSync25(path)) {
     const section = buildSection(content);
     ensureParent(path);
-    writeFileSync15(path, `${section}
+    writeFileSync16(path, `${section}
 `, "utf-8");
     return "created";
   }
-  const existing = readFileSync23(path, "utf-8");
+  const existing = readFileSync24(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const section = buildSection(content, lineEnding);
   const location = findSection(existing);
@@ -61564,7 +61941,7 @@ function upsertSection(path, content) {
   }
   if (next === existing)
     return "unchanged";
-  writeFileSync15(path, next, "utf-8");
+  writeFileSync16(path, next, "utf-8");
   return "updated";
 }
 function installRuleForAgent(agent, content) {
@@ -61581,13 +61958,13 @@ function removeRuleForAgent(agent) {
     return null;
   const target = RULE_TARGETS[agent];
   const path = target.path();
-  if (!existsSync24(path))
+  if (!existsSync25(path))
     return { agent, path, action: "not_found" };
   if (target.kind === "file") {
     unlinkSync5(path);
     return { agent, path, action: "removed" };
   }
-  const existing = readFileSync23(path, "utf-8");
+  const existing = readFileSync24(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const location = findSection(existing);
   if (!location)
@@ -61596,7 +61973,7 @@ function removeRuleForAgent(agent) {
   if (!next) {
     unlinkSync5(path);
   } else {
-    writeFileSync15(path, `${next}${lineEnding}`, "utf-8");
+    writeFileSync16(path, `${next}${lineEnding}`, "utf-8");
   }
   return { agent, path, action: "removed" };
 }
@@ -61624,36 +62001,36 @@ var init_installer = __esm(() => {
   RULE_TARGETS = {
     claude: {
       kind: "file",
-      path: () => join40(claudeConfigDir4(), "rules", "dosu.md")
+      path: () => join41(claudeConfigDir4(), "rules", "dosu.md")
     },
     cursor: {
       kind: "file",
-      path: () => join40(homedir12(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join41(homedir12(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
       kind: "section",
-      path: () => join40(codexHome4(), "AGENTS.md")
+      path: () => join41(codexHome4(), "AGENTS.md")
     },
     opencode: {
       kind: "section",
-      path: () => join40(homedir12(), ".config", "opencode", "AGENTS.md")
+      path: () => join41(homedir12(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join40(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join41(homedir12(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join40(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join41(homedir12(), ".gemini", "GEMINI.md")
     }
   };
 });
 
 // src/setup/agents-md-step.ts
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync25, readFileSync as readFileSync24, writeFileSync as writeFileSync16 } from "node:fs";
-import { join as join41 } from "node:path";
+import { existsSync as existsSync26, readFileSync as readFileSync25, writeFileSync as writeFileSync17 } from "node:fs";
+import { join as join42 } from "node:path";
 function inGitWorkTree(cwd = process.cwd()) {
   try {
     const stdout = execSync3("git rev-parse --is-inside-work-tree", {
@@ -61667,10 +62044,10 @@ function inGitWorkTree(cwd = process.cwd()) {
 }
 function dosuAgentsSectionState(cwd = process.cwd()) {
   try {
-    const path = join41(cwd, "AGENTS.md");
-    if (!existsSync25(path))
+    const path = join42(cwd, "AGENTS.md");
+    if (!existsSync26(path))
       return "missing";
-    const content = readFileSync24(path, "utf-8");
+    const content = readFileSync25(path, "utf-8");
     const startMatch = content.match(SECTION_START_RE);
     if (!startMatch || !content.includes(DOSU_SECTION_END))
       return "missing";
@@ -61705,14 +62082,14 @@ function findSection2(content) {
   return { start, end };
 }
 function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RULE) {
-  const path = join41(cwd, "AGENTS.md");
-  if (!existsSync25(path)) {
+  const path = join42(cwd, "AGENTS.md");
+  if (!existsSync26(path)) {
     const section = buildDosuAgentsSection(content);
-    writeFileSync16(path, `${section}
+    writeFileSync17(path, `${section}
 `);
     return { path, action: "created" };
   }
-  const existing = readFileSync24(path, "utf-8");
+  const existing = readFileSync25(path, "utf-8");
   const lineEnding = lineEndingFor2(existing);
   const section = renderDosuAgentsSection(content, lineEnding);
   const location = findSection2(existing);
@@ -61724,7 +62101,7 @@ function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RU
   }
   if (next === existing)
     return { path, action: "unchanged" };
-  writeFileSync16(path, next);
+  writeFileSync17(path, next);
   return { path, action: "updated" };
 }
 async function stepUpdateAgentsMd(cwd = process.cwd(), content) {
@@ -61780,15 +62157,15 @@ var init_errors3 = __esm(() => {
 var MCP_PROVIDER_SLUG2 = "dosu_mcp";
 
 // src/sessions/session-title.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync15, readFileSync as readFileSync25, renameSync as renameSync6, statSync as statSync9, writeFileSync as writeFileSync17 } from "node:fs";
+import { existsSync as existsSync27, mkdirSync as mkdirSync16, readFileSync as readFileSync26, renameSync as renameSync6, statSync as statSync9, writeFileSync as writeFileSync18 } from "node:fs";
 import { homedir as homedir13 } from "node:os";
-import { join as join42 } from "node:path";
+import { join as join43 } from "node:path";
 function cachePath2(configDir) {
-  return join42(configDir, CACHE_FILENAME5);
+  return join43(configDir, CACHE_FILENAME6);
 }
 function loadCacheFile2(configDir) {
   try {
-    const raw = JSON.parse(readFileSync25(cachePath2(configDir), "utf-8"));
+    const raw = JSON.parse(readFileSync26(cachePath2(configDir), "utf-8"));
     if (raw.schema_version !== CACHE_SCHEMA_VERSION2 || typeof raw.entries !== "object")
       return {};
     return raw.entries;
@@ -61798,12 +62175,12 @@ function loadCacheFile2(configDir) {
 }
 function saveCacheFile2(configDir, entries) {
   try {
-    if (!existsSync26(configDir))
-      mkdirSync15(configDir, { recursive: true, mode: 448 });
+    if (!existsSync27(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 };
-    writeFileSync17(tmp, JSON.stringify(file), { mode: 384 });
+    writeFileSync18(tmp, JSON.stringify(file), { mode: 384 });
     renameSync6(tmp, path);
   } catch {}
 }
@@ -61836,15 +62213,15 @@ function claudeSummaryFromHead(text) {
   }
   return null;
 }
-function reconstructSession(harness, id, slug, home = homedir13(), exists = existsSync26) {
+function reconstructSession(harness, id, slug, home = homedir13(), exists = existsSync27) {
   if (!slug)
     return null;
   const candidates = [];
   if (harness === "claude") {
-    candidates.push(join42(home, ".claude", "projects", slug, `${id}.jsonl`));
+    candidates.push(join43(home, ".claude", "projects", slug, `${id}.jsonl`));
   } else if (harness === "cursor") {
-    const project = join42(home, ".cursor", "projects", slug);
-    candidates.push(join42(project, "agent-transcripts", id, `${id}.jsonl`), join42(project, "agent-transcripts", `${id}.jsonl`));
+    const project = join43(home, ".cursor", "projects", slug);
+    candidates.push(join43(project, "agent-transcripts", id, `${id}.jsonl`), join43(project, "agent-transcripts", `${id}.jsonl`));
   } else {
     return null;
   }
@@ -61856,7 +62233,7 @@ function reconstructSession(harness, id, slug, home = homedir13(), exists = exis
 }
 function readHead2(path) {
   try {
-    return readFileSync25(path, "utf-8").slice(0, 128 * 1024);
+    return readFileSync26(path, "utf-8").slice(0, 128 * 1024);
   } catch {
     return null;
   }
@@ -61907,7 +62284,7 @@ function createSessionTitleResolver(configDir = getConfigDir(), deps = {}) {
     }
   };
 }
-var CACHE_FILENAME5 = "session-titles.json", CACHE_SCHEMA_VERSION2 = 3, HEAD_LINES2 = 50, SESSION_NAME_MAX = 80;
+var CACHE_FILENAME6 = "session-titles.json", CACHE_SCHEMA_VERSION2 = 3, HEAD_LINES2 = 50, SESSION_NAME_MAX = 80;
 var init_session_title = __esm(() => {
   init_config();
   init_read();
@@ -61936,7 +62313,7 @@ var init_alt_screen = __esm(() => {
 });
 
 // src/tui/activity-view.ts
-import { existsSync as existsSync27, readFileSync as readFileSync26 } from "node:fs";
+import { existsSync as existsSync28, readFileSync as readFileSync27 } from "node:fs";
 import { basename as basename5 } from "node:path";
 function reduceActivityViewKey(key) {
   if (key === "q" || key === ESC7 || key === CTRL_C4)
@@ -62077,15 +62454,15 @@ function statusLine(status) {
   if (status.running) {
     const since = status.startedAt ? ` · since ${localTime(status.startedAt)}` : "";
     const pid = status.pid !== undefined ? ` (pid ${status.pid})` : "";
-    return `\uD83D\uDCDA ${import_picocolors33.default.bold(brand("Studying sessions..."))}${import_picocolors33.default.dim(`${pid}${since}`)}`;
+    return `\uD83D\uDCDA ${import_picocolors34.default.bold(brand("Studying sessions..."))}${import_picocolors34.default.dim(`${pid}${since}`)}`;
   }
   if (status.state.paused) {
-    return `${import_picocolors33.default.yellow("○")} ${import_picocolors33.default.bold("Paused")} ${import_picocolors33.default.dim("· studying stays off until you resume")}`;
+    return `${import_picocolors34.default.yellow("○")} ${import_picocolors34.default.bold("Paused")} ${import_picocolors34.default.dim("· studying stays off until you resume")}`;
   }
   if (status.staleLock) {
-    return `${import_picocolors33.default.yellow("○")} ${import_picocolors33.default.bold("Not running")} ${import_picocolors33.default.dim("· a previous run exited without cleaning up")}`;
+    return `${import_picocolors34.default.yellow("○")} ${import_picocolors34.default.bold("Not running")} ${import_picocolors34.default.dim("· a previous run exited without cleaning up")}`;
   }
-  return `${import_picocolors33.default.dim("○")} ${import_picocolors33.default.bold("Idle")} ${import_picocolors33.default.dim("· hooks study new sessions automatically")}`;
+  return `${import_picocolors34.default.dim("○")} ${import_picocolors34.default.bold("Idle")} ${import_picocolors34.default.dim("· hooks study new sessions automatically")}`;
 }
 function progressLine(done, ready, width, notes = 0) {
   const total = done + ready;
@@ -62094,7 +62471,7 @@ function progressLine(done, ready, width, notes = 0) {
   const cells = Math.max(10, Math.min(30, width - 44));
   const ratio = Math.max(0, Math.min(1, done / total));
   const filled = Math.min(cells, Math.round(ratio * cells));
-  const bar = brand("█".repeat(filled)) + import_picocolors33.default.dim("░".repeat(cells - filled));
+  const bar = brand("█".repeat(filled)) + import_picocolors34.default.dim("░".repeat(cells - filled));
   const pct = Math.floor(ratio * 100);
   const suffix = notes > 0 ? ` · ${notes} suggested page${notes === 1 ? "" : "s"}` : "";
   return `${bar} ${done}/${total} studied · ${pct}%${suffix}`;
@@ -62133,17 +62510,17 @@ function confirmBox(queuedCount, backlog, width, mode = "start") {
   const verb = mode === "clear" ? "clear" : mode === "stop" ? "stop" : mode === "resume" ? "resume" : "start";
   const maxInner = Math.max(20, Math.min(width, contentWidth()) - 4);
   const rows = [
-    import_picocolors33.default.bold(brand(title)),
-    ...wrapLine(scope, maxInner, "").map((line) => import_picocolors33.default.dim(line)),
+    import_picocolors34.default.bold(brand(title)),
+    ...wrapLine(scope, maxInner, "").map((line) => import_picocolors34.default.dim(line)),
     "",
-    `${import_picocolors33.default.bold("enter")} ${verb} · ${import_picocolors33.default.bold("esc")} cancel`
+    `${import_picocolors34.default.bold("enter")} ${verb} · ${import_picocolors34.default.bold("esc")} cancel`
   ];
   const inner = Math.min(maxInner, Math.max(...rows.map(visibleWidth2)));
   const pad = (row) => row + " ".repeat(Math.max(0, inner - visibleWidth2(row)));
   return [
-    import_picocolors33.default.dim(`╭${"─".repeat(inner + 2)}╮`),
-    ...rows.map((row) => `${import_picocolors33.default.dim("│")} ${pad(row)} ${import_picocolors33.default.dim("│")}`),
-    import_picocolors33.default.dim(`╰${"─".repeat(inner + 2)}╯`)
+    import_picocolors34.default.dim(`╭${"─".repeat(inner + 2)}╮`),
+    ...rows.map((row) => `${import_picocolors34.default.dim("│")} ${pad(row)} ${import_picocolors34.default.dim("│")}`),
+    import_picocolors34.default.dim(`╰${"─".repeat(inner + 2)}╯`)
   ];
 }
 function renderActivityFrame(status, activity, width, backlog = null, pane = DEFAULT_PANE, queued = [], studiedBeforeRun = 0, open = [], runProgress = null, projectNames = {}, sessionNames = {}) {
@@ -62159,7 +62536,7 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     progress = progressLine(studiedDelta + stepDone, Math.max(0, backlog.ready - stepDone), width, runProgress?.notes ?? 0);
   }
   const refusal = !status.running && status.state.last_refusal;
-  const refusalLines = refusal ? wrapLine(`! Studying paused: ${refusal.message} (${localTime(refusal.at)})`, width).map((line) => import_picocolors33.default.yellow(line)) : [];
+  const refusalLines = refusal ? wrapLine(`! Studying paused: ${refusal.message} (${localTime(refusal.at)})`, width).map((line) => import_picocolors34.default.yellow(line)) : [];
   const fullRows = Boolean(pane.fullRows);
   const withName = (item, key) => projectNames[key] ? { ...item, project: projectNames[key] } : item;
   const latestPass = new Map;
@@ -62184,7 +62561,7 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
   const height = fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
   const { visible, above, below } = windowList(source, pane.scroll, height);
   const display = fullRows ? visible.flatMap((row) => wrapRow(row, width)) : visible;
-  const listRows = display.length > 0 ? display.map((row) => import_picocolors33.default.dim(row)) : [import_picocolors33.default.dim(empty)];
+  const listRows = display.length > 0 ? display.map((row) => import_picocolors34.default.dim(row)) : [import_picocolors34.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
     scrollParts.push(`↑ ${above} earlier`);
@@ -62194,14 +62571,14 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     breadcrumb(["home", "activity"], width),
     "",
     statusLine(status),
-    import_picocolors33.default.dim(studied),
-    ...queueDetail.length > 0 ? wrapLine(queueDetail.join(" · "), width).map((line) => import_picocolors33.default.dim(line)) : [],
+    import_picocolors34.default.dim(studied),
+    ...queueDetail.length > 0 ? wrapLine(queueDetail.join(" · "), width).map((line) => import_picocolors34.default.dim(line)) : [],
     ...progress ? [progress] : [],
     ...refusalLines,
     "",
     ...tabBar(pane.tab, queued.length, open.length, latestPass.size, width),
     ...listRows,
-    ...scrollParts.length > 0 ? [import_picocolors33.default.dim(clip(scrollParts.join(" · "), width))] : [],
+    ...scrollParts.length > 0 ? [import_picocolors34.default.dim(clip(scrollParts.join(" · "), width))] : [],
     "",
     ...pane.confirm ? centerBlock(confirmBox(queued.length, backlog, width, pane.confirm), width) : [
       ...wrapLine([
@@ -62211,7 +62588,7 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
         status.running ? "s stop" : status.state.paused ? "s resume" : "s sync now",
         ...!status.running && status.state.watermark ? ["c clear"] : [],
         "esc back"
-      ].join(" · "), width, "").map((line) => import_picocolors33.default.dim(line))
+      ].join(" · "), width, "").map((line) => import_picocolors34.default.dim(line))
     ]
   ];
   return lines.join(`
@@ -62245,7 +62622,7 @@ function createRowNamer() {
         names.titles[key] = t;
     };
     for (const s of [...backlog.queued, ...backlog.open]) {
-      if (!existsSync27(s.path))
+      if (!existsSync28(s.path))
         continue;
       const key = `${s.harness}/${s.id}`;
       const dir = dirs.resolve(s);
@@ -62282,7 +62659,7 @@ function createRowNamer() {
 }
 function defaultReadLog2() {
   try {
-    return readFileSync26(logger.getLogPath(), "utf-8");
+    return readFileSync27(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -62463,7 +62840,7 @@ ${CLEAR_BELOW}`);
     input.on("data", onData);
   });
 }
-var import_picocolors33, ESC7, HIDE_CURSOR3, SHOW_CURSOR3, CTRL_C4, KEY_UP4, KEY_DOWN4, KEY_RIGHT3, KEY_LEFT3, CURSOR_HOME, CLEAR_BELOW, CLEAR_EOL, ACTIVITY_VIEW_POLL_MS = 500, ACTIVITY_VIEW_LIST_LINES = 10, ACTIVITY_VIEW_FULL_LIST_ROWS = 5, ACTIVITY_VIEW_BUFFER_LINES = 200, ACTIVITY_VIEW_TABS, DEFAULT_PANE, TITLE_READS_PER_DRAW = 25;
+var import_picocolors34, ESC7, HIDE_CURSOR3, SHOW_CURSOR3, CTRL_C4, KEY_UP4, KEY_DOWN4, KEY_RIGHT3, KEY_LEFT3, CURSOR_HOME, CLEAR_BELOW, CLEAR_EOL, ACTIVITY_VIEW_POLL_MS = 500, ACTIVITY_VIEW_LIST_LINES = 10, ACTIVITY_VIEW_FULL_LIST_ROWS = 5, ACTIVITY_VIEW_BUFFER_LINES = 200, ACTIVITY_VIEW_TABS, DEFAULT_PANE, TITLE_READS_PER_DRAW = 25;
 var init_activity_view = __esm(() => {
   init_follow();
   init_logger();
@@ -62478,7 +62855,7 @@ var init_activity_view = __esm(() => {
   init_alt_screen();
   init_layout();
   init_menu();
-  import_picocolors33 = __toESM(require_picocolors(), 1);
+  import_picocolors34 = __toESM(require_picocolors(), 1);
   ESC7 = String.fromCharCode(27);
   HIDE_CURSOR3 = `${ESC7}[?25l`;
   SHOW_CURSOR3 = `${ESC7}[?25h`;
@@ -63259,6 +63636,7 @@ async function runSetupFlow(opts = {}) {
     }));
     return;
   }
+  writeMcpRefreshCache({ version: VERSION });
   const configuredProviders = configured.filter((result) => (result.action === "install" || result.action === "skip") && !result.error);
   const mcpCompleted = configuredProviders.length > 0;
   if (mcpCompleted) {
@@ -63703,25 +64081,14 @@ async function runSwitchTarget(scope = "org") {
     return;
   updateTarget(cfg, { api_key: apiKey });
   saveConfig(cfg);
-  const configured = allSetupProviders().filter((provider) => {
-    try {
-      return provider.isInstalled() && provider.isConfigured();
-    } catch {
-      return false;
-    }
-  });
-  for (const provider of configured) {
-    try {
-      provider.install(cfg, true);
-      logger.info("setup", `Switch: updated ${provider.name()}`);
-      log2.success(`${provider.name()} ${dim("· updated")}`);
-    } catch (err) {
-      const error = err instanceof Error ? err : new Error(String(err));
-      logger.error("setup", `Switch: update failed for ${provider.name()}: ${error.message}`);
-      log2.error(`Failed to update ${provider.name()}: ${error.message}`);
-    }
+  const refreshed = refreshConfiguredProviders(cfg);
+  for (const provider of refreshed.updated) {
+    log2.success(`${provider.name()} ${dim("· updated")}`);
+  }
+  for (const { provider, error } of refreshed.failed) {
+    log2.error(`Failed to update ${provider.name()}: ${error.message}`);
   }
-  if (configured.length > 0) {
+  if (refreshed.updated.length + refreshed.failed.length > 0) {
     log2.info("Restart your AI agents so they pick up the new MCP target.");
   }
 }
@@ -63971,7 +64338,7 @@ async function stepSelectTools(detected) {
     initialValues: preselected,
     statusFor: (id, picked) => {
       if (configuredMap.get(id))
-        return picked ? dim("configured") : import_picocolors34.default.yellow("will remove");
+        return picked ? dim("configured") : import_picocolors35.default.yellow("will remove");
       return picked ? brand("will configure") : undefined;
     },
     summary: (picked) => {
@@ -64146,7 +64513,7 @@ ${dim(wrapLog("Run it inside a session to keep that session out of studying. Rem
     log2.success("All agents already configured. No changes needed.");
   }
 }
-var import_picocolors34, OAUTH_ANALYTICS_REASONS, SETUP_HANDSHAKE_TIMEOUT_MS = 1800000, LIBRARY_SELECT_CANCELLED;
+var import_picocolors35, OAUTH_ANALYTICS_REASONS, SETUP_HANDSHAKE_TIMEOUT_MS = 1800000, LIBRARY_SELECT_CANCELLED;
 var init_flow2 = __esm(() => {
   init_dist();
   init_errors3();
@@ -64157,6 +64524,7 @@ var init_flow2 = __esm(() => {
   init_agents();
   init_agents3();
   init_providers();
+  init_refresh();
   init_agents4();
   init_detach();
   init_sync();
@@ -64164,12 +64532,13 @@ var init_flow2 = __esm(() => {
   init_activity_view();
   init_layout();
   init_prompts();
+  init_mcp_refresh_check();
   init_agents_md_step();
   init_analytics2();
   init_github_step();
   init_rules_step();
   init_styles();
-  import_picocolors34 = __toESM(require_picocolors(), 1);
+  import_picocolors35 = __toESM(require_picocolors(), 1);
   OAUTH_ANALYTICS_REASONS = new Set([
     "access_denied",
     "bad_oauth_state",
@@ -64297,7 +64666,7 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
   const rows = analyticsTabRows(tab, state, pageStats);
   const { visible, above, below } = windowReport(rows, scroll);
   const empty = tab === "overview" ? "No analytics yet. They appear after the first study run." : tab === "projects" ? "No per-project history yet. It fills in as sessions are studied." : pagesPending ? "Loading page analytics..." : "No page analytics yet.";
-  const listRows = visible.length > 0 ? visible.map((row) => import_picocolors35.default.dim(row)) : [import_picocolors35.default.dim(empty)];
+  const listRows = visible.length > 0 ? visible.map((row) => import_picocolors36.default.dim(row)) : [import_picocolors36.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
     scrollParts.push(`↑ ${above} earlier`);
@@ -64313,9 +64682,9 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
     ], tab, width, { spread: false }),
     "",
     ...listRows,
-    ...scrollParts.length > 0 ? [import_picocolors35.default.dim(scrollParts.join(" · "))] : [],
+    ...scrollParts.length > 0 ? [import_picocolors36.default.dim(scrollParts.join(" · "))] : [],
     "",
-    import_picocolors35.default.dim("tab switch · ↑↓ scroll · esc back")
+    import_picocolors36.default.dim("tab switch · ↑↓ scroll · esc back")
   ];
   return lines.join(`
 `);
@@ -64410,7 +64779,7 @@ ${CLEAR_BELOW2}`);
     input.on("data", onData);
   });
 }
-var import_picocolors35, ESC8, HIDE_CURSOR4, SHOW_CURSOR4, CTRL_C5, KEY_UP5, KEY_DOWN5, KEY_RIGHT4, KEY_LEFT4, CURSOR_HOME2, CLEAR_BELOW2, CLEAR_EOL2, ANALYTICS_VIEW_POLL_MS = 1000, ANALYTICS_VIEW_LINES = 14, ANALYTICS_VIEW_TABS, TOP_PAGES_LIMIT = 5, TOP_CITED_DAYS = 30, label = (text) => text.padEnd(26);
+var import_picocolors36, ESC8, HIDE_CURSOR4, SHOW_CURSOR4, CTRL_C5, KEY_UP5, KEY_DOWN5, KEY_RIGHT4, KEY_LEFT4, CURSOR_HOME2, CLEAR_BELOW2, CLEAR_EOL2, ANALYTICS_VIEW_POLL_MS = 1000, ANALYTICS_VIEW_LINES = 14, ANALYTICS_VIEW_TABS, TOP_PAGES_LIMIT = 5, TOP_CITED_DAYS = 30, label = (text) => text.padEnd(26);
 var init_analytics_view = __esm(() => {
   init_trpc();
   init_config();
@@ -64418,7 +64787,7 @@ var init_analytics_view = __esm(() => {
   init_alt_screen();
   init_layout();
   init_menu();
-  import_picocolors35 = __toESM(require_picocolors(), 1);
+  import_picocolors36 = __toESM(require_picocolors(), 1);
   ESC8 = String.fromCharCode(27);
   HIDE_CURSOR4 = `${ESC8}[?25l`;
   SHOW_CURSOR4 = `${ESC8}[?25h`;
@@ -64436,7 +64805,7 @@ var init_analytics_view = __esm(() => {
 // src/tui/banner.ts
 function paintLogoRow(row) {
   return row.map(([tone, art]) => {
-    if (!import_picocolors36.default.isColorSupported)
+    if (!import_picocolors37.default.isColorSupported)
       return art;
     const { fg, fallback } = LOGO_TONES[tone];
     return hasTruecolor() ? `${fg}${art}\x1B[39m` : fallback(art);
@@ -64444,14 +64813,14 @@ function paintLogoRow(row) {
 }
 function checklistRows(ctx) {
   const on = brand(CHECK2);
-  const off = import_picocolors36.default.dim(CIRCLE);
+  const off = import_picocolors37.default.dim(CIRCLE);
   const rows = [["workspace", ctx.directory]];
   rows.push([
     "account",
-    ctx.sessionExpired ? `${off} ${import_picocolors36.default.yellow("session expired")} ${import_picocolors36.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on} signed in` : `${off} ${import_picocolors36.default.dim(`not signed in ${DOT3} run Setup`)}`
+    ctx.sessionExpired ? `${off} ${import_picocolors37.default.yellow("session expired")} ${import_picocolors37.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on} signed in` : `${off} ${import_picocolors37.default.dim(`not signed in ${DOT3} run Setup`)}`
   ]);
   const missing = new Set(ctx.setupMissing ?? []);
-  const warnRow = `${off} ${import_picocolors36.default.yellow("not configured")} ${import_picocolors36.default.dim(`${DOT3} run Setup`)}`;
+  const warnRow = `${off} ${import_picocolors37.default.yellow("not configured")} ${import_picocolors37.default.dim(`${DOT3} run Setup`)}`;
   if (missing.has("MCP"))
     rows.push(["mcp", warnRow]);
   else if (ctx.deploymentName)
@@ -64463,7 +64832,7 @@ function checklistRows(ctx) {
   if (ctx.repoAgentsMd) {
     rows.push([
       "repo",
-      ctx.repoAgentsMd === "current" ? `${on} AGENTS.md has the Dosu section` : `${off} ${import_picocolors36.default.yellow(ctx.repoAgentsMd === "outdated" ? "AGENTS.md Dosu section outdated" : "AGENTS.md missing the Dosu section")} ${import_picocolors36.default.dim(`${DOT3} run Setup`)}`
+      ctx.repoAgentsMd === "current" ? `${on} AGENTS.md has the Dosu section` : `${off} ${import_picocolors37.default.yellow(ctx.repoAgentsMd === "outdated" ? "AGENTS.md Dosu section outdated" : "AGENTS.md missing the Dosu section")} ${import_picocolors37.default.dim(`${DOT3} run Setup`)}`
     ]);
   }
   if (missing.has("agents"))
@@ -64475,24 +64844,24 @@ function checklistRows(ctx) {
   if (ctx.studying) {
     rows.push([
       "sync",
-      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors36.default.dim(`${DOT3} see activity`)}`
+      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors37.default.dim(`${DOT3} see activity`)}`
     ]);
   }
   if (ctx.update) {
     rows.push([
       "update",
-      `${import_picocolors36.default.yellow(`↑ ${ctx.update.version} available`)} ${import_picocolors36.default.dim(`${DOT3} ${ctx.update.hint}`)}`
+      `${import_picocolors37.default.yellow(`↑ ${ctx.update.version} available`)} ${import_picocolors37.default.dim(`${DOT3} ${ctx.update.hint}`)}`
     ]);
   }
   const labelWidth = Math.max(...rows.map(([label]) => label.length));
-  return rows.map(([label, value]) => `${import_picocolors36.default.dim(label.padEnd(labelWidth))}  ${value}`);
+  return rows.map(([label, value]) => `${import_picocolors37.default.dim(label.padEnd(labelWidth))}  ${value}`);
 }
 function renderBanner(ctx) {
   const logo = LOGO_ROWS.map(paintLogoRow);
   const text = [
     ...checklistRows(ctx),
     "",
-    `${brandBadge("dosu-cli")} ${import_picocolors36.default.dim(`${ctx.version} ${DOT3} ${ctx.webAppHost}`)}`
+    `${brandBadge("dosu-cli")} ${import_picocolors37.default.dim(`${ctx.version} ${DOT3} ${ctx.webAppHost}`)}`
   ];
   const height = Math.max(logo.length, text.length);
   const combined = [];
@@ -64505,10 +64874,10 @@ function renderBanner(ctx) {
   return ["", ...combined, ""].join(`
 `);
 }
-var import_picocolors36, CHECK2 = "✔", CIRCLE = "○", DOT3 = "·", LOGO_ROWS, LOGO_MARK, LOGO_WIDTH, LOGO_TONES, COLUMN_GAP = "   ";
+var import_picocolors37, CHECK2 = "✔", CIRCLE = "○", DOT3 = "·", LOGO_ROWS, LOGO_MARK, LOGO_WIDTH, LOGO_TONES, COLUMN_GAP = "   ";
 var init_banner = __esm(() => {
   init_styles();
-  import_picocolors36 = __toESM(require_picocolors(), 1);
+  import_picocolors37 = __toESM(require_picocolors(), 1);
   LOGO_ROWS = [
     [["sage", "▄▄▄▄▄▄"]],
     [["sage", "██    ▀▄"]],
@@ -64519,8 +64888,8 @@ var init_banner = __esm(() => {
   LOGO_MARK = LOGO_ROWS.map((row) => row.map(([, art]) => art).join(""));
   LOGO_WIDTH = Math.max(...LOGO_MARK.map((row) => row.length));
   LOGO_TONES = {
-    sage: { fg: "\x1B[38;2;180;187;145m", fallback: import_picocolors36.default.green },
-    moss: { fg: "\x1B[38;2;119;133;97m", fallback: (art) => import_picocolors36.default.dim(import_picocolors36.default.green(art)) }
+    sage: { fg: "\x1B[38;2;180;187;145m", fallback: import_picocolors37.default.green },
+    moss: { fg: "\x1B[38;2;119;133;97m", fallback: (art) => import_picocolors37.default.dim(import_picocolors37.default.green(art)) }
   };
 });
 
@@ -64632,16 +65001,16 @@ function renderPagesFrame(model, width, selected) {
   const body = [];
   let scrollHint = "";
   if (model.phase === "loading") {
-    body.push(import_picocolors37.default.dim("Loading pages…"));
+    body.push(import_picocolors38.default.dim("Loading pages…"));
   } else if (model.phase === "error") {
-    body.push(import_picocolors37.default.yellow(clip3(model.message, width)));
+    body.push(import_picocolors38.default.yellow(clip3(model.message, width)));
   } else if (model.pages.length === 0) {
-    body.push(import_picocolors37.default.dim("No pages in this Library yet."));
+    body.push(import_picocolors38.default.dim("No pages in this Library yet."));
   } else {
     const rows = pageRows2(model.pages, width - 2);
     const { start, above } = windowSelection(rows.length, selected);
     const visible = rows.slice(start, start + PAGES_VIEW_LINES);
-    body.push(...visible.map((row, i) => start + i === selected ? `${brand("▸")} ${import_picocolors37.default.bold(row)}` : `  ${import_picocolors37.default.dim(row)}`));
+    body.push(...visible.map((row, i) => start + i === selected ? `${brand("▸")} ${import_picocolors38.default.bold(row)}` : `  ${import_picocolors38.default.dim(row)}`));
     const below = Math.max(0, Math.max(model.total, rows.length) - start - PAGES_VIEW_LINES);
     const parts = [];
     if (above > 0)
@@ -64650,14 +65019,14 @@ function renderPagesFrame(model, width, selected) {
       parts.push(`↓ ${below} more`);
     scrollHint = parts.join(" · ");
   }
-  const count = model.phase === "ready" ? ` ${import_picocolors37.default.dim(model.pages.length < model.total ? `(${model.pages.length} of ${model.total})` : `(${model.pages.length})`)}` : "";
+  const count = model.phase === "ready" ? ` ${import_picocolors38.default.dim(model.pages.length < model.total ? `(${model.pages.length} of ${model.total})` : `(${model.pages.length})`)}` : "";
   const lines = [
     `${breadcrumb(["home", "pages"], width)}${count}`,
     "",
     ...body,
-    ...scrollHint ? [import_picocolors37.default.dim(scrollHint)] : [],
+    ...scrollHint ? [import_picocolors38.default.dim(scrollHint)] : [],
     "",
-    import_picocolors37.default.dim("↑↓ move · enter open · esc back")
+    import_picocolors38.default.dim("↑↓ move · enter open · esc back")
   ];
   return lines.join(`
 `);
@@ -64666,9 +65035,9 @@ function renderPageFrame(page, content, width, scroll) {
   const body = [];
   let scrollHint = "";
   if (content.phase === "loading") {
-    body.push(import_picocolors37.default.dim("Loading page…"));
+    body.push(import_picocolors38.default.dim("Loading page…"));
   } else if (content.phase === "error") {
-    body.push(import_picocolors37.default.yellow(clip3(content.message, width)));
+    body.push(import_picocolors38.default.yellow(clip3(content.message, width)));
   } else {
     const rows = wrapBody(content.body, width);
     const { visible, above, below } = windowReport(rows, scroll, PAGE_BODY_LINES);
@@ -64683,12 +65052,12 @@ function renderPageFrame(page, content, width, scroll) {
   const meta = `${page.type} · ${page.published ? "published" : "draft"} · updated ${page.updated_at.slice(0, 10)}`;
   const lines = [
     breadcrumb(["home", "pages", page.title], width),
-    import_picocolors37.default.dim(clip3(meta, width)),
+    import_picocolors38.default.dim(clip3(meta, width)),
     "",
     ...body,
-    ...scrollHint ? [import_picocolors37.default.dim(scrollHint)] : [],
+    ...scrollHint ? [import_picocolors38.default.dim(scrollHint)] : [],
     "",
-    import_picocolors37.default.dim("↑↓ scroll · esc back to pages")
+    import_picocolors38.default.dim("↑↓ scroll · esc back to pages")
   ];
   return lines.join(`
 `);
@@ -64837,7 +65206,7 @@ ${CLEAR_BELOW3}`);
     input.on("data", onData);
   });
 }
-var import_picocolors37, ESC9, HIDE_CURSOR5, SHOW_CURSOR5, CTRL_C6, KEY_UP6, KEY_DOWN6, CURSOR_HOME3, CLEAR_BELOW3, CLEAR_EOL3, PAGES_VIEW_LINES = 12, PAGE_BODY_LINES = 14, PAGES_FETCH_BATCH = 100;
+var import_picocolors38, ESC9, HIDE_CURSOR5, SHOW_CURSOR5, CTRL_C6, KEY_UP6, KEY_DOWN6, CURSOR_HOME3, CLEAR_BELOW3, CLEAR_EOL3, PAGES_VIEW_LINES = 12, PAGE_BODY_LINES = 14, PAGES_FETCH_BATCH = 100;
 var init_pages_view = __esm(() => {
   init_trpc();
   init_config();
@@ -64847,7 +65216,7 @@ var init_pages_view = __esm(() => {
   init_analytics_view();
   init_layout();
   init_menu();
-  import_picocolors37 = __toESM(require_picocolors(), 1);
+  import_picocolors38 = __toESM(require_picocolors(), 1);
   ESC9 = String.fromCharCode(27);
   HIDE_CURSOR5 = `${ESC9}[?25l`;
   SHOW_CURSOR5 = `${ESC9}[?25h`;
@@ -64961,7 +65330,7 @@ function isSetUp(cfg) {
 }
 function setupHint(cfg) {
   const started = Boolean(cfg.active_account?.target);
-  return import_picocolors38.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
+  return import_picocolors39.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
 }
 function isStudying() {
   try {
@@ -65207,7 +65576,7 @@ function handleLogout(cfg) {
   saveConfig(cfg);
   log2.success("Credentials cleared.");
 }
-var import_picocolors38, ESC10, CLEAR_SCREEN;
+var import_picocolors39, ESC10, CLEAR_SCREEN;
 var init_tui = __esm(() => {
   init_client();
   init_config();
@@ -65230,7 +65599,7 @@ var init_tui = __esm(() => {
   init_menu();
   init_pages_view();
   init_prompts();
-  import_picocolors38 = __toESM(require_picocolors(), 1);
+  import_picocolors39 = __toESM(require_picocolors(), 1);
   ESC10 = String.fromCharCode(27);
   CLEAR_SCREEN = `${ESC10}[2J${ESC10}[H`;
 });
@@ -65834,18 +66203,15 @@ var init_flow3 = __esm(() => {
 });
 
 // src/cli/cli.ts
-import {
-  closeSync as closeSync6,
-  constants as constants3,
-  fstatSync as fstatSync2,
-  openSync as openSync6,
-  readFileSync as readFileSync27,
-  readSync as readSync5,
-  unlinkSync as unlinkSync6
-} from "node:fs";
+import { readFileSync as readFileSync28, unlinkSync as unlinkSync6 } from "node:fs";
 function shouldRunBackgroundChecks(actionName) {
   return actionName !== "upgrade";
 }
+function shouldRunMcpRefreshCheck(actionCommand) {
+  if (actionCommand.name() === "setup")
+    return false;
+  return !(actionCommand.name() === "refresh" && actionCommand.parent?.name() === "mcp");
+}
 function commandTelemetryName(actionCommand) {
   const segments = [];
   let current = actionCommand;
@@ -65862,7 +66228,7 @@ function shouldTrackCommand(command) {
 }
 function commandTelemetryContext() {
   try {
-    const cfg = loadConfigForTelemetry();
+    const cfg = loadConfigNonBlocking();
     if (!cfg)
       return { mode: "cloud", isAuthenticated: false };
     const authenticated = isAuthenticated(cfg);
@@ -65882,29 +66248,6 @@ function commandTelemetryContext() {
     return { mode: "cloud", isAuthenticated: false };
   }
 }
-function loadConfigForTelemetry() {
-  let fd;
-  try {
-    const nonblocking = typeof constants3.O_NONBLOCK === "number" ? constants3.O_NONBLOCK : 0;
-    fd = openSync6(getConfigPath(), constants3.O_RDONLY | nonblocking);
-    const file = fstatSync2(fd);
-    if (!file.isFile() || file.size > MAX_TELEMETRY_CONFIG_BYTES)
-      return;
-    const content = Buffer.alloc(MAX_TELEMETRY_CONFIG_BYTES + 1);
-    const bytesRead = readSync5(fd, content, 0, content.byteLength, 0);
-    if (bytesRead > MAX_TELEMETRY_CONFIG_BYTES)
-      return;
-    return parseConfig(JSON.parse(content.subarray(0, bytesRead).toString("utf8")));
-  } catch {
-    return;
-  } finally {
-    if (fd !== undefined) {
-      try {
-        closeSync6(fd);
-      } catch {}
-    }
-  }
-}
 function startTelemetry(telemetry, command, context) {
   if (!telemetry)
     return false;
@@ -65963,12 +66306,15 @@ function createProgram(options = {}) {
     const opts = thisCommand.optsWithGlobals();
     logger.init({ debug: opts.debug });
     if (shouldRunBackgroundChecks(actionCommand.name())) {
+      const launchesTUI = actionCommand.parent === null;
       if (!process.env.CI) {
-        const launchesTUI = actionCommand.parent === null;
         await checkForUpdates({ notify: !launchesTUI });
       }
       checkForSkillUpdates();
       checkForReadyTasks();
+      if (shouldRunMcpRefreshCheck(actionCommand)) {
+        checkForMcpRefresh({ notify: !launchesTUI });
+      }
     }
     const command = commandTelemetryName(actionCommand);
     if (options.telemetry && shouldTrackCommand(command)) {
@@ -66195,6 +66541,31 @@ Start ${provider.name()} in any project to use the Dosu MCP.`);
 Start ${provider.name()} in this project directory to use the Dosu MCP.`);
     }
   });
+  mcp.command("refresh").description("Rewrite the Dosu MCP entry in every configured AI tool from the current setup").action(() => {
+    const cfg = loadConfig();
+    if (!canRefreshMcp(cfg)) {
+      throw new CliUsageError("Dosu is not set up yet. Run 'dosu setup' first");
+    }
+    const configured = configuredProviders();
+    if (configured.length === 0) {
+      console.log("No AI tools with Dosu configured. Run 'dosu setup' to add Dosu to a tool.");
+      return;
+    }
+    console.log(`Refreshing Dosu MCP config for configured AI tools...
+`);
+    const result = refreshConfiguredProviders(cfg);
+    writeMcpRefreshCache({ version: VERSION });
+    for (const provider of result.updated) {
+      console.log(`  ✓ ${provider.name()}`);
+    }
+    for (const { provider, error } of result.failed) {
+      console.log(`  ✗ ${provider.name()}: ${error.message}`);
+    }
+    console.log(`
+Restart your AI agents so they pick up the change.`);
+    if (result.failed.length > 0)
+      process.exitCode = 1;
+  });
   mcp.command("list").description("List available AI tools").action(() => {
     console.log(`Available AI tools:
 `);
@@ -66275,7 +66646,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     }
     if (opts.follow) {
       try {
-        const lines = readFileSync27(logPath, "utf-8").split(`
+        const lines = readFileSync28(logPath, "utf-8").split(`
 `);
         if (lines.at(-1) === "")
           lines.pop();
@@ -66291,7 +66662,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 = readFileSync27(logPath, "utf-8");
+        const content = readFileSync28(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n).join(`
@@ -66343,7 +66714,7 @@ function processCommandTelemetry() {
     return;
   }
 }
-var TELEMETRY_FLUSH_TIMEOUT_MS = 750, MAX_TELEMETRY_CONFIG_BYTES, CliUsageError, FOLLOW_POLL_MS = 500, DEFAULT_TAIL_LINES = 50;
+var TELEMETRY_FLUSH_TIMEOUT_MS = 750, CliUsageError, FOLLOW_POLL_MS = 500, DEFAULT_TAIL_LINES = 50;
 var init_cli = __esm(() => {
   init_commander();
   init_client();
@@ -66369,13 +66740,14 @@ var init_cli = __esm(() => {
   init_follow();
   init_logger();
   init_providers();
+  init_refresh();
   init_styles();
   init_settings();
   init_telemetry();
+  init_mcp_refresh_check();
   init_pending_tasks_check();
   init_skill_update_check();
   init_update_check();
-  MAX_TELEMETRY_CONFIG_BYTES = 64 * 1024;
   CliUsageError = class CliUsageError extends Error {
     exitCode = 1;
     constructor(message) {
@@ -66416,4 +66788,4 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=2f023ff0-da66-217c-6475-6e2164756e21
+//# debugId=6712b11a-8117-30cb-6475-6e2164756e21