@dosu/cli 0.53.0-beta.11 → 0.53.0-beta.13

package/bin/dosu.js

@@ -5018,7 +5018,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.53.0-beta.11", INSTALL_CHANNEL = "npm";
+var VERSION = "0.53.0-beta.13", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -5712,12 +5712,34 @@ function answeredEcho(message, answer) {
 function optionLabel(option) {
   return option.label ?? String(option.value);
 }
+function viewport(count, cursor3, top, rows, chrome) {
+  const visible = Math.min(count, Math.max(4, (rows ?? 24) - chrome));
+  let next = top;
+  if (cursor3 < next)
+    next = cursor3;
+  if (cursor3 >= next + visible)
+    next = cursor3 - visible + 1;
+  next = Math.max(0, Math.min(next, count - visible));
+  return { top: next, visible, above: next, below: count - next - visible };
+}
+function moreAbove(n2) {
+  return n2 > 0 ? [import_picocolors11.default.dim(`  ↑ ${n2} more`)] : [];
+}
+function moreBelow(n2) {
+  return n2 > 0 ? [import_picocolors11.default.dim(`  ↓ ${n2} more`)] : [];
+}
 function select(opts, io = {}) {
+  const { output } = resolveIO(io);
   let selected = 0;
+  let top = 0;
   const labelWidth = Math.max(...opts.options.map((o2) => optionLabel(o2).length));
   return runInteractive({
     render() {
-      const rows = opts.options.map((option, index) => {
+      const count = opts.options.length;
+      const view = viewport(count, selected, top, output.rows, 8);
+      top = view.top;
+      const rows = opts.options.slice(top, top + view.visible).map((option, offset) => {
+        const index = top + offset;
         const label = optionLabel(option).padEnd(labelWidth);
         const hint = option.hint ? `   ${import_picocolors11.default.dim(option.hint)}` : "";
         return index === selected ? `${brand(POINTER2)} ${import_picocolors11.default.bold(brand(label))}${hint}` : `  ${import_picocolors11.default.dim(label)}${hint}`;
@@ -5725,7 +5747,9 @@ function select(opts, io = {}) {
       return [
         import_picocolors11.default.bold(opts.message),
         "",
+        ...moreAbove(view.above),
         ...rows,
+        ...moreBelow(view.below),
         "",
         import_picocolors11.default.dim(`↑↓ move ${DOT} enter select ${DOT} esc cancel`)
       ];
@@ -5763,13 +5787,9 @@ function multiselect2(opts, io = {}) {
   return runInteractive({
     render() {
       const count = opts.options.length;
-      const visible = Math.min(count, Math.max(4, (output.rows ?? 24) - 9));
-      if (cursor3 < top)
-        top = cursor3;
-      if (cursor3 >= top + visible)
-        top = cursor3 - visible + 1;
-      top = Math.max(0, Math.min(top, count - visible));
-      const rows = opts.options.slice(top, top + visible).map((option, offset) => {
+      const view = viewport(count, cursor3, top, output.rows, 9);
+      top = view.top;
+      const rows = opts.options.slice(top, top + view.visible).map((option, offset) => {
         const index = top + offset;
         const isPicked = picked.has(option.value);
         const box = isPicked ? brand(BOX_ON) : import_picocolors11.default.dim(BOX_OFF);
@@ -5778,15 +5798,13 @@ function multiselect2(opts, io = {}) {
         const suffix = status ? `   ${status}` : "";
         return index === cursor3 ? `${brand(POINTER2)} ${box} ${import_picocolors11.default.bold(brand(label))}${suffix}` : `  ${box} ${import_picocolors11.default.dim(label)}${suffix}`;
       });
-      const above = top;
-      const below = count - top - visible;
       const summary = opts.summary?.(pickedValues());
       return [
         import_picocolors11.default.bold(opts.message),
         "",
-        ...above > 0 ? [import_picocolors11.default.dim(`  ↑ ${above} more`)] : [],
+        ...moreAbove(view.above),
         ...rows,
-        ...below > 0 ? [import_picocolors11.default.dim(`  ↓ ${below} more`)] : [],
+        ...moreBelow(view.below),
         "",
         ...error ? [import_picocolors11.default.yellow(error)] : summary ? [import_picocolors11.default.dim(summary)] : [],
         import_picocolors11.default.dim(`↑↓ move ${DOT} space toggle ${DOT} a all ${DOT} enter confirm ${DOT} esc cancel`)
@@ -8577,6 +8595,17 @@ function setSyncPaused(paused, configDir = getConfigDir()) {
     delete state.paused;
   saveSyncState(state, configDir);
 }
+function resetSyncState(configDir = getConfigDir()) {
+  const previous = loadSyncState(configDir);
+  const fresh = {
+    schema_version: STATE_SCHEMA_VERSION,
+    watermark: null,
+    consecutive_failures: 0,
+    ...previous.project_filter ? { project_filter: previous.project_filter } : {},
+    ...previous.paused ? { paused: true } : {}
+  };
+  saveSyncState(fresh, configDir);
+}
 function saveSyncState(state, configDir = getConfigDir()) {
   if (!existsSync10(configDir))
     mkdirSync6(configDir, { recursive: true, mode: 448 });
@@ -9238,7 +9267,7 @@ function buildReportHtml(options) {
   const org = options.orgName || "Your team";
   const repo = options.repo || inventory.cwd || "—";
   const branch = options.branch || "—";
-  const summary = options.summary || "Local agent session logs were mined into Dosu notes so the next task can reuse them — reducing rediscovery cost.";
+  const summary = options.summary || "Local agent session logs were studied and distilled into Dosu notes so the next task can reuse them — reducing rediscovery cost.";
   const generated = `${(options.generatedAt ?? new Date).toISOString().replace("T", " ").slice(0, 16)} UTC`;
   const derived = tokenTotalsFromCandidates(candidates, inventory);
   const [notesHeading, notesLede, footerTitle, footerBody] = notesSectionCopy(candidates);
@@ -9300,7 +9329,7 @@ function buildReportHtml(options) {
   <p class="muted">No rediscovery estimates on the notes yet — each candidate needs <code>approx_rediscovery_tokens</code>.</p>
 </section>`;
   }
-  const notesBody = candidateRows.join("") || '<p class="muted">No write_knowledge payloads yet. Run knowledge sync so the miner extracts learnings.</p>';
+  const notesBody = candidateRows.join("") || '<p class="muted">No write_knowledge payloads yet. Run knowledge sync so Dosu studies your sessions and extracts learnings.</p>';
   const lede = notesLede ? `<p class="lede">${esc(notesLede)}</p>` : "";
   return `<!DOCTYPE html>
 <html lang="en">
@@ -10490,7 +10519,7 @@ async function runKnowledgeSync(options = {}) {
   const state = loadState();
   if (options.quiet) {
     if (state.paused) {
-      logger.debug("sync", "skipping quiet sync: mining is paused");
+      logger.debug("sync", "skipping quiet sync: studying is paused");
       return { status: "skipped-paused", readySessions: 0, inFlightSessions: 0, sessions: [] };
     }
     const retryAt = backoffUntil(state);
@@ -10500,7 +10529,7 @@ async function runKnowledgeSync(options = {}) {
     }
   } else if (state.paused) {
     delete state.paused;
-    logger.debug("sync", "manual sync resumes paused mining");
+    logger.debug("sync", "manual sync resumes paused studying");
   }
   let ready;
   let open2;
@@ -10590,12 +10619,12 @@ async function runKnowledgeSync(options = {}) {
         trivialSessions: trivial
       };
     }
-    logger.debug("sync", `mining ${batch.length} of ${ready.length} ready sessions (${trivial} trivial skipped)`);
+    logger.debug("sync", `studying ${batch.length} of ${ready.length} ready sessions (${trivial} trivial skipped)`);
     const miner = await deps.mine(batch);
     switch (miner.outcome) {
       case "completed": {
         for (const s of batch) {
-          logger.debug("sync", `mined session ${s.harness}/${s.id}`);
+          logger.debug("sync", `studied session ${s.harness}/${s.id}`);
         }
         const minedAt = now().toISOString();
         const history = [
@@ -10622,7 +10651,7 @@ async function runKnowledgeSync(options = {}) {
           total_learning_tokens: (state.total_learning_tokens ?? 0) + batchTokens,
           last_refusal: undefined
         });
-        logger.debug("sync", `mined ${batch.length} sessions, ${miner.notesWritten} suggested pages; watermark → ${watermark}`);
+        logger.debug("sync", `studied ${batch.length} sessions, ${miner.notesWritten} suggested pages; watermark → ${watermark}`);
         return {
           status: "mined",
           ...base,
@@ -10642,10 +10671,10 @@ async function runKnowledgeSync(options = {}) {
           last_refusal: {
             at,
             outcome: miner.outcome,
-            message: miner.message ?? "Mining unavailable right now."
+            message: miner.message ?? "Studying unavailable right now."
           }
         });
-        logger.debug("sync", `mining skipped by gateway: ${miner.outcome}`);
+        logger.debug("sync", `studying skipped by gateway: ${miner.outcome}`);
         return { status: "skipped-gateway", ...base, minedSessions: 0, miner };
       }
       default: {
@@ -10654,7 +10683,7 @@ async function runKnowledgeSync(options = {}) {
           last_attempt_at: now().toISOString(),
           consecutive_failures: state.consecutive_failures + 1
         });
-        logger.debug("sync", `mining failed: ${miner.outcome}; ${miner.message ?? ""}`);
+        logger.debug("sync", `studying failed: ${miner.outcome}; ${miner.message ?? ""}`);
         return {
           status: "mine-failed",
           ...base,
@@ -72901,7 +72930,7 @@ async function runMiner(options) {
       outcome: "settings_conflict",
       notesWritten: 0,
       turns: 0,
-      message: `Refusing to run: conflicting Claude Code settings would override the miner's auth (${detail})`
+      message: `Refusing to run: conflicting Claude Code settings would override the study run's auth (${detail})`
     };
   }
   const gatewayURL = options.gatewayURL ?? getLlmGatewayURL();
@@ -72968,7 +72997,7 @@ async function runMiner(options) {
           if (!allowed.has(toolName)) {
             return {
               behavior: "deny",
-              message: `Tool ${toolName} is not permitted in mining runs.`
+              message: `Tool ${toolName} is not permitted in study runs.`
             };
           }
           if (toolName === `mcp__${SESSIONS_SERVER_NAME}__read_session`) {
@@ -73025,7 +73054,7 @@ async function runMiner(options) {
             outcome: "error",
             notesWritten,
             turns,
-            message: "Mining run failed; see debug log for details."
+            message: "Study run failed; see debug log for details."
           };
         }
         logger.debug("miner", `run ${runID} completed: ${turns} turns, ${notesWritten} suggested pages`);
@@ -73036,7 +73065,7 @@ async function runMiner(options) {
       outcome: "error",
       notesWritten,
       turns,
-      message: "Mining run ended without a result."
+      message: "Study run ended without a result."
     };
   } catch (error61) {
     const text = error61 instanceof Error ? error61.message : String(error61);
@@ -73049,7 +73078,7 @@ async function runMiner(options) {
       outcome: "error",
       notesWritten,
       turns,
-      message: abort.signal.aborted ? "Mining run timed out and was aborted." : "Mining run failed; see debug log for details."
+      message: abort.signal.aborted ? "Study run timed out and was aborted." : "Study run failed; see debug log for details."
     };
   } finally {
     clearTimeout(timer);
@@ -73519,7 +73548,7 @@ var init_settings = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "fa7cf492-7aa5-180c-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "6b750395-441b-6515-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
@@ -75434,6 +75463,8 @@ function reduceActivityViewKey(key) {
     return "sync";
   if (key === "f")
     return "full";
+  if (key === "c")
+    return "clear";
   return "none";
 }
 function cycleTab(tab, delta = 1) {
@@ -75524,12 +75555,12 @@ function foldRunProgress(progress, chunk) {
   let current = progress;
   for (const line of chunk.split(`
 `)) {
-    const start = line.match(/\[sync\] mining (\d+) of \d+ ready sessions/);
+    const start = line.match(/\[sync\] (?:studying|mining) (\d+) of \d+ ready sessions/);
     if (start) {
       current = { batch: Number.parseInt(start[1], 10), read: new Set, notes: 0 };
       continue;
     }
-    if (/\[sync\] (mined \d+ sessions|mining failed|mining skipped)/.test(line)) {
+    if (/\[sync\] (?:studied|mined) \d+ sessions|\[sync\] (?:studying|mining) (?:failed|skipped)/.test(line)) {
       current = null;
       continue;
     }
@@ -75554,15 +75585,15 @@ function statusLine(status) {
   if (status.running) {
     const since = status.startedAt ? ` · since ${localTime(status.startedAt)}` : "";
     const pid = status.pid !== undefined ? ` (pid ${status.pid})` : "";
-    return `⛏️ ${import_picocolors30.default.bold(brand("Mining sessions..."))}${import_picocolors30.default.dim(`${pid}${since}`)}`;
+    return `\uD83D\uDCDA ${import_picocolors30.default.bold(brand("Studying sessions..."))}${import_picocolors30.default.dim(`${pid}${since}`)}`;
   }
   if (status.state.paused) {
-    return `${import_picocolors30.default.yellow("○")} ${import_picocolors30.default.bold("Paused")} ${import_picocolors30.default.dim("· mining stays off until you resume")}`;
+    return `${import_picocolors30.default.yellow("○")} ${import_picocolors30.default.bold("Paused")} ${import_picocolors30.default.dim("· studying stays off until you resume")}`;
   }
   if (status.staleLock) {
     return `${import_picocolors30.default.yellow("○")} ${import_picocolors30.default.bold("Not running")} ${import_picocolors30.default.dim("· a previous run exited without cleaning up")}`;
   }
-  return `${import_picocolors30.default.dim("○")} ${import_picocolors30.default.bold("Idle")} ${import_picocolors30.default.dim("· hooks mine new sessions automatically")}`;
+  return `${import_picocolors30.default.dim("○")} ${import_picocolors30.default.bold("Idle")} ${import_picocolors30.default.dim("· hooks study new sessions automatically")}`;
 }
 function progressLine(done, ready, width, notes = 0) {
   const total = done + ready;
@@ -75574,12 +75605,12 @@ function progressLine(done, ready, width, notes = 0) {
   const bar = brand("█".repeat(filled)) + import_picocolors30.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} mined · ${pct}%${suffix}`;
+  return `${bar} ${done}/${total} studied · ${pct}%${suffix}`;
 }
 function tabBar(tab, queuedCount, openCount, minedCount, width) {
   return tabStrip([
     ["activity", "Activity"],
-    ["mined", `Mined (${minedCount})`],
+    ["mined", `Studied (${minedCount})`],
     ["queued", `Queued (${queuedCount})`],
     ["open", `Open (${openCount})`]
   ], tab, width);
@@ -75603,10 +75634,11 @@ function wrapLine(text, width, indent = "  ") {
   return out;
 }
 function confirmBox(queuedCount, backlog, width, mode = "start") {
-  const inFlight = backlog && backlog.inFlight > 0 ? ` (+${backlog.inFlight} open, mined once ${backlog.inFlight === 1 ? "it goes" : "they go"} quiet)` : "";
-  const scope = mode === "stop" ? "the run is killed mid-batch · mining stays paused until you resume" : queuedCount > 0 ? `${queuedCount} session${queuedCount === 1 ? "" : "s"} queued${inFlight} · runs in the background` : `queue empty${inFlight} · a run would only pick up sessions that finish from here`;
-  const title = mode === "stop" ? "Stop mining?" : mode === "resume" ? "Resume mining?" : "Start mining now?";
-  const verb = mode === "stop" ? "stop" : mode === "resume" ? "resume" : "start";
+  const inFlight = backlog && backlog.inFlight > 0 ? ` (+${backlog.inFlight} still open; ${backlog.inFlight === 1 ? "it joins" : "they join"} once quiet)` : "";
+  const sessions = `${queuedCount} session${queuedCount === 1 ? "" : "s"}`;
+  const scope = mode === "clear" ? "Forgets which local sessions Dosu has already studied, so the next run reads them all again. Use this to rebuild knowledge from scratch. Notes already saved in Dosu are kept." : mode === "stop" ? "Kills the run mid-batch and pauses studying, so new sessions pile up in the queue instead of being read. Nothing is lost; press s again to resume from where it left off." : mode === "resume" ? `Studying picks up where it stopped: ${sessions} queued${inFlight}. Runs in the background; new notes appear in Dosu as each batch finishes.` : queuedCount > 0 ? `Dosu reads ${sessions}${inFlight} and distills the durable decisions and gotchas into team knowledge. Runs in the background; new notes appear in Dosu as each batch finishes.` : `Queue is empty${inFlight}. A run now would only pick up sessions that finish from here; hooks already do that automatically.`;
+  const title = mode === "clear" ? "Clear study history?" : mode === "stop" ? "Stop studying?" : mode === "resume" ? "Resume studying?" : "Start studying now?";
+  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_picocolors30.default.bold(brand(title)),
@@ -75623,7 +75655,7 @@ function confirmBox(queuedCount, backlog, width, mode = "start") {
   ];
 }
 function renderActivityFrame(status, activity, width, backlog = null, pane = DEFAULT_PANE, queued = [], minedBeforeRun = 0, open5 = [], runProgress = null) {
-  const mined = status.state.watermark ? `Mined sessions up to ${localTime(status.state.watermark)}` : "Nothing mined yet";
+  const mined = status.state.watermark ? `Studied sessions up to ${localTime(status.state.watermark)}` : "Nothing studied yet";
   const queueDetail = [];
   if (status.backoffUntil) {
     queueDetail.push(`retrying after ${localTime(status.backoffUntil)} · s syncs now`);
@@ -75635,14 +75667,14 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     progress = progressLine(minedDelta + stepDone, Math.max(0, backlog.ready - stepDone), width, runProgress?.notes ?? 0);
   }
   const refusal = !status.running && status.state.last_refusal;
-  const refusalLines = refusal ? wrapLine(`! Mining paused: ${refusal.message} (${localTime(refusal.at)})`, width).map((line) => import_picocolors30.default.yellow(line)) : [];
+  const refusalLines = refusal ? wrapLine(`! Studying paused: ${refusal.message} (${localTime(refusal.at)})`, width).map((line) => import_picocolors30.default.yellow(line)) : [];
   const fullRows = Boolean(pane.fullRows);
   const minedRows = (status.state.mined_sessions ?? []).map((record2) => fullRows ? formatMinedRow(record2, true) : formatActivityLine(formatMinedRow(record2), width));
   const sessionRow = (session) => fullRows ? formatQueuedRow(session, true) : formatActivityLine(formatQueuedRow(session), width);
   const queuedRows = queued.map(sessionRow);
   const openRows = open5.map(sessionRow);
   const source = pane.tab === "activity" ? activity.map((line) => formatActivityLine(line, width, fullRows)) : pane.tab === "queued" ? queuedRows : pane.tab === "open" ? openRows : minedRows;
-  const emptyMined = status.state.watermark ? "No sessions recorded yet. History starts with the next mining run." : "No mined sessions yet.";
+  const emptyMined = status.state.watermark ? "No sessions recorded yet. History starts with the next study run." : "No studied sessions yet.";
   const empty = pane.tab === "activity" ? "No sync activity in the log yet." : pane.tab === "queued" ? "Queue empty. Finished agent sessions appear here." : pane.tab === "open" ? "No open sessions. Live agent sessions sit here until they go quiet." : emptyMined;
   const height = fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
   const { visible, above, below } = windowList(source, pane.scroll, height);
@@ -75667,13 +75699,14 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     ...scrollParts.length > 0 ? [import_picocolors30.default.dim(clip(scrollParts.join(" · "), width))] : [],
     "",
     ...pane.confirm ? centerBlock(confirmBox(queued.length, backlog, width, pane.confirm), width) : [
-      import_picocolors30.default.dim([
+      ...wrapLine([
         "tab switch",
         "↑↓ scroll",
         fullRows ? "f clip" : "f full rows",
         status.running ? "s stop" : status.state.paused ? "s resume" : "s sync now",
+        ...!status.running && status.state.watermark ? ["c clear"] : [],
         "esc back"
-      ].join(" · "))
+      ].join(" · "), width, "").map((line) => import_picocolors30.default.dim(line))
     ]
   ];
   return lines.join(`
@@ -75697,6 +75730,7 @@ function runActivityView(io2 = {}) {
   const startSync = io2.startSync ?? (() => spawnDetachedSelf(["knowledge", "sync", "--bootstrap"]));
   const stopSync = io2.stopSync ?? stopSyncRun;
   const setPaused = io2.setPaused ?? setSyncPaused;
+  const clearHistory = io2.clearHistory ?? resetSyncState;
   const listBacklog = io2.listBacklog ?? listSessionBacklog;
   const pollMs = io2.pollMs ?? ACTIVITY_VIEW_POLL_MS;
   const seed = readLog();
@@ -75743,7 +75777,7 @@ function runActivityView(io2 = {}) {
       queuedWatermark = status.state.watermark;
       sessions = listBacklog();
     }
-    if ((confirmSync === "start" || confirmSync === "resume") && status.running)
+    if (confirmSync !== null && confirmSync !== "stop" && status.running)
       confirmSync = null;
     if (confirmSync === "stop" && !status.running)
       confirmSync = null;
@@ -75795,11 +75829,15 @@ ${CLEAR_BELOW}`);
             const mode = confirmSync;
             confirmSync = null;
             let note;
-            if (mode === "stop") {
+            if (mode === "clear") {
+              clearHistory();
+              minedBeforeRun = null;
+              note = "[sync] study history cleared · the next run reads every local session again";
+            } else if (mode === "stop") {
               const ok2 = status.pid !== undefined && stopSync(status.pid);
               if (ok2)
                 setPaused(true);
-              note = ok2 ? "[sync] mining stopped · paused until you resume" : "[sync] could not stop the run · it may have just finished";
+              note = ok2 ? "[sync] studying stopped · paused until you resume" : "[sync] could not stop the run · it may have just finished";
             } else {
               if (mode === "resume")
                 setPaused(false);
@@ -75823,6 +75861,11 @@ ${CLEAR_BELOW}`);
         if (action === "sync") {
           confirmSync = syncConfirmMode(status);
           draw();
+        } else if (action === "clear") {
+          if (!status.running && status.state.watermark) {
+            confirmSync = "clear";
+            draw();
+          }
         } else if (action === "tab" || action === "tab-back") {
           tab = cycleTab(tab, action === "tab" ? 1 : -1);
           scroll = 0;
@@ -76708,23 +76751,31 @@ async function stepOfferInitialSync(cfg) {
   s.start("Checking for recent agent sessions...");
   const outcome = await runKnowledgeSync({ bootstrap: true });
   if (outcome.status !== "backlog" || outcome.readySessions === 0) {
-    s.stop("No unmined agent sessions found. Dosu will learn as you work.");
+    s.stop("No past agent sessions to study. Dosu will learn from new ones as you work.");
     return;
   }
   const n5 = outcome.readySessions;
-  s.stop(`Found ${n5} unmined agent session${n5 === 1 ? "" : "s"} on this machine.`);
+  const them = n5 === 1 ? "it" : "them";
+  s.stop(`Found ${n5} past agent session${n5 === 1 ? "" : "s"} on this machine that Dosu hasn't studied.`);
+  log2.message([
+    `Dosu can read ${them} and pull out the durable knowledge: decisions, gotchas, and`,
+    "how-things-work that your team and agents would otherwise rediscover.",
+    "Only distilled notes are saved to Dosu; your session logs stay on this machine.",
+    "It runs in the background a few sessions at a time; notes appear in Dosu as each batch finishes."
+  ].join(`
+`));
   const mineNow = await confirm2({
-    message: `Mine ${n5 === 1 ? "it" : "them"} for team knowledge now? (runs in the background)`,
-    active: "Mine now ⛏️",
-    inactive: "Skip",
+    message: `Study ${them} now?`,
+    active: "Study now \uD83D\uDCDA",
+    inactive: "Skip for now",
     initialValue: true
   });
   if (isCancel2(mineNow) || !mineNow) {
-    log2.info(`Skipped. Dosu picks sessions up in the background as you work, or run ${info("dosu knowledge sync")} anytime.`);
+    log2.info(`Skipped. Dosu studies new sessions in the background as you work; run ${info("dosu knowledge sync")} anytime to study these too.`);
     return;
   }
   if (spawnDetachedSelf(["knowledge", "sync", "--quiet", "--bootstrap"])) {
-    log2.success("⛏️ Currently mining... Dosu is distilling your past sessions into team knowledge, a few at a time in the background.");
+    log2.success(`\uD83D\uDCDA Studying ${n5} session${n5 === 1 ? "" : "s"} in the background. Watch progress on the Activity screen; when it finishes, the new notes are in Dosu and agents connected to this MCP can use them.`);
     const watch = await confirm2({
       message: "What next?",
       active: "Watch it work",
@@ -77554,7 +77605,7 @@ function overviewRows(state) {
   const tokens = state.total_learning_tokens ?? 0;
   if (minedTotal === 0 && notes === 0)
     return [];
-  const rows = [`${label("Sessions mined")}${minedTotal}`, `${label("Suggested pages")}${notes}`];
+  const rows = [`${label("Sessions studied")}${minedTotal}`, `${label("Suggested pages")}${notes}`];
   if (tokens > 0) {
     rows.push(`${label("Investigation distilled")}${formatTokenCount(tokens)} tokens`);
   }
@@ -77603,7 +77654,7 @@ function analyticsTabRows(tab, state, pageStats) {
 function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending = false, width = contentWidth()) {
   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 mining run." : tab === "projects" ? "No per-project history yet. It fills in as sessions are mined." : pagesPending ? "Loading page analytics..." : "No page analytics yet.";
+  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_picocolors32.default.dim(row)) : [import_picocolors32.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
@@ -77782,7 +77833,7 @@ function checklistRows(ctx) {
   if (ctx.mining) {
     rows.push([
       "sync",
-      `⛏️ ${brand("mining sessions...")} ${import_picocolors33.default.dim(`${DOT3} see Activity`)}`
+      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors33.default.dim(`${DOT3} see Activity`)}`
     ]);
   }
   if (ctx.update) {
@@ -78326,7 +78377,7 @@ async function runMainMenu() {
     const mining = isMining();
     return [
       {
-        label: mining ? `Activity ⛏️ ${brand("mining sessions...")}` : "Activity",
+        label: mining ? `Activity \uD83D\uDCDA ${brand("studying sessions...")}` : "Activity",
         value: "sync"
       },
       { label: "Knowledge report", hint: "(opens in browser)", value: "report" },
@@ -78406,7 +78457,7 @@ async function runSettings(cfg) {
     const action = await menuSelect("Settings", [
       { label: "Switch organization", hint: target?.org_name, value: "switch-org" },
       { label: "Switch Library", hint: library, value: "switch-library" },
-      { label: "Mining scope", hint: scope, value: "projects" },
+      { label: "Study scope", hint: scope, value: "projects" },
       { label: "Run setup", hint: "rerun the setup wizard", value: "setup" },
       { label: "Log out", hint: "clear stored credentials", value: "logout" },
       { label: "Back", value: "back" }
@@ -78460,7 +78511,7 @@ async function runMiningProjectsSetting() {
   }
   const current = loadSyncState().project_filter;
   const selected = await multiselect2({
-    message: "Mine sessions from which folders?",
+    message: "Study sessions from which folders?",
     options: dirs.map((dir) => ({
       label: dir === UNKNOWN_PROJECT ? "(unknown folder)" : displayDir(dir),
       value: dir
@@ -78475,7 +78526,7 @@ async function runMiningProjectsSetting() {
   const all = selected.length === dirs.length;
   saveSyncState(all ? state : { ...state, project_filter: [...selected] });
   const scope = all ? "all folders" : selected.map(displayDir).join(", ");
-  log2.success(`Mining scope ${dim(`· ${scope}`)}`);
+  log2.success(`Study scope ${dim(`· ${scope}`)}`);
 }
 async function handleAuthenticate(cfg) {
   const shouldLogin = await confirm2({ message: "Open browser to log in?" });
@@ -82381,7 +82432,7 @@ ${results.length - opts.limit} more results not shown.`));
     console.log(`  ID:       ${store.id}`);
     console.log(`  Space ID: ${store.space_id}`);
   });
-  cmd.command("sessions").description("List local agent sessions with full project and session ids (the untruncated view of the Activity screen's tabs)").option("--queued", "Only sessions queued for mining").option("--open", "Only live sessions still inside the quiet period").option("--mined", "Only recent mined-session history").option("--json", "Output as JSON").action((opts) => {
+  cmd.command("sessions").description("List local agent sessions with full project and session ids (the untruncated view of the Activity screen's tabs)").option("--queued", "Only sessions queued for studying").option("--open", "Only live sessions still inside the quiet period").option("--mined", "Only recent studied-session history").option("--json", "Output as JSON").action((opts) => {
     const all = !opts.queued && !opts.open && !opts.mined;
     const wantQueued = all || Boolean(opts.queued);
     const wantOpen = all || Boolean(opts.open);
@@ -82422,10 +82473,10 @@ ${results.length - opts.limit} more results not shown.`));
       section("Open", sessionRows(backlog.open), "Updated", "No open sessions. Live agent sessions sit here until they go quiet.");
     }
     if (wantMined) {
-      section("Mined", minedRows, "Mined at", "No mined sessions recorded yet.");
+      section("Studied", minedRows, "Studied at", "No studied sessions recorded yet.");
     }
   });
-  cmd.command("sync").description("Scan local agent session history and report the mining backlog").option("--quiet", "Background mode for hooks: honor backoff, exit 0, print nothing").option("--detach", "Re-spawn detached and return immediately (used by agent hooks)").option("--bootstrap", "Backfill mode: mine the full local session history regardless of age and drain the backlog (used by setup)").option("--status", "Show whether a sync is running now, plus watermark and recent activity").option("--report", "Write the same HTML harvest report as the log-to-dosu-knowledge skill and open it").option("--out <path>", "HTML report path (default: tmp/dosu-knowledge-report.html)").option("--json", "Output as JSON").action(async (opts) => {
+  cmd.command("sync").description("Scan local agent session history and report the study backlog").option("--quiet", "Background mode for hooks: honor backoff, exit 0, print nothing").option("--detach", "Re-spawn detached and return immediately (used by agent hooks)").option("--bootstrap", "Backfill mode: study the full local session history regardless of age and drain the backlog (used by setup)").option("--status", "Show whether a sync is running now, plus watermark and recent activity").option("--report", "Write the same HTML harvest report as the log-to-dosu-knowledge skill and open it").option("--out <path>", "HTML report path (default: tmp/dosu-knowledge-report.html)").option("--json", "Output as JSON").action(async (opts) => {
     if (opts.status) {
       const status = getSyncStatus();
       if (opts.json) {
@@ -82511,7 +82562,7 @@ ${results.length - opts.limit} more results not shown.`));
       console.log("All your notes already have a transcript — nothing to backfill.");
       return;
     }
-    console.log(`Attributed ${result.updated} of ${result.candidates} notes (${result.ambiguous} ambiguous, ${result.noBatch} without a local mining batch). Run 'dosu knowledge report' to see their traces.`);
+    console.log(`Attributed ${result.updated} of ${result.candidates} notes (${result.ambiguous} ambiguous, ${result.noBatch} without a local study batch). Run 'dosu knowledge report' to see their traces.`);
   });
   cmd.addCommand(hooksCommand());
   return cmd;
@@ -82552,14 +82603,14 @@ function printSyncStatus(status, now = new Date) {
     console.log("○ No sync running.");
   }
   if (status.state.paused) {
-    console.log(import_picocolors18.default.yellow("  Mining paused: stopped by you. Resume from the Activity screen or run 'dosu knowledge sync'."));
+    console.log(import_picocolors18.default.yellow("  Studying paused: stopped by you. Resume from the Activity screen or run 'dosu knowledge sync'."));
   }
   const wm2 = status.state.watermark;
-  console.log(`  Mined through:   ${wm2 ? `${wm2} (${formatAge(wm2, now)})` : "nothing mined yet"}`);
+  console.log(`  Studied through: ${wm2 ? `${wm2} (${formatAge(wm2, now)})` : "nothing studied yet"}`);
   if (status.state.project_filter?.length) {
     const home = homedir5();
     const scope = status.state.project_filter.map((dir) => dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir).join(", ");
-    console.log(`  Mining scope:    ${scope}`);
+    console.log(`  Study scope:     ${scope}`);
   }
   if ((status.state.total_notes ?? 0) > 0) {
     const tokens = status.state.total_learning_tokens ?? 0;
@@ -82574,7 +82625,7 @@ function printSyncStatus(status, now = new Date) {
     console.log(import_picocolors18.default.yellow(`  Backing off after ${n5} failure${n5 === 1 ? "" : "s"}; background syncs retry after ${status.backoffUntil}.`));
   }
   if (status.state.last_refusal) {
-    console.log(import_picocolors18.default.yellow(`  Mining paused: ${status.state.last_refusal.message} (${formatAge(status.state.last_refusal.at, now)})`));
+    console.log(import_picocolors18.default.yellow(`  Studying paused: ${status.state.last_refusal.message} (${formatAge(status.state.last_refusal.at, now)})`));
   }
   if (status.recentActivity.length > 0) {
     console.log(`
@@ -82590,25 +82641,25 @@ function printSyncOutcome(outcome) {
   switch (outcome.status) {
     case "backlog": {
       const inFlight = outcome.inFlightSessions > 0 ? import_picocolors18.default.dim(` (${outcome.inFlightSessions} more still in progress)`) : "";
-      console.log(`✓ Scanned. ${outcome.readySessions} new session${outcome.readySessions === 1 ? "" : "s"} ready to mine${inFlight}.`);
-      console.log(import_picocolors18.default.dim("Sign in with 'dosu setup' to enable mining."));
+      console.log(`✓ Scanned. ${outcome.readySessions} new session${outcome.readySessions === 1 ? "" : "s"} ready to study${inFlight}.`);
+      console.log(import_picocolors18.default.dim("Sign in with 'dosu setup' to enable studying."));
       break;
     }
     case "mined": {
       const notes = outcome.miner?.notesWritten ?? 0;
       const remaining = outcome.readySessions - (outcome.minedSessions ?? 0);
-      console.log(`✓ Mined ${outcome.minedSessions} session${outcome.minedSessions === 1 ? "" : "s"}, ${notes} suggested page${notes === 1 ? "" : "s"} created.`);
+      console.log(`✓ Studied ${outcome.minedSessions} session${outcome.minedSessions === 1 ? "" : "s"}, ${notes} suggested page${notes === 1 ? "" : "s"} created.`);
       if (remaining > 0) {
         console.log(import_picocolors18.default.dim(`${remaining} more in the backlog; run sync again to continue.`));
       }
       break;
     }
     case "skipped-gateway": {
-      console.log(import_picocolors18.default.yellow(outcome.miner?.message ?? "Mining unavailable right now."));
+      console.log(import_picocolors18.default.yellow(outcome.miner?.message ?? "Studying unavailable right now."));
       break;
     }
     case "mine-failed": {
-      console.error(import_picocolors18.default.red(outcome.miner?.message ?? "Mining run failed."));
+      console.error(import_picocolors18.default.red(outcome.miner?.message ?? "Study run failed."));
       process.exitCode = 1;
       break;
     }
@@ -82631,7 +82682,7 @@ function printSyncOutcome(outcome) {
       break;
     }
     case "skipped-paused": {
-      console.log(import_picocolors18.default.dim("Skipped: mining is paused. Run 'dosu knowledge sync' to resume."));
+      console.log(import_picocolors18.default.dim("Skipped: studying is paused. Run 'dosu knowledge sync' to resume."));
       break;
     }
   }
@@ -84636,4 +84687,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=fa7cf492-7aa5-180c-6475-6e2164756e21
+//# debugId=6b750395-441b-6515-6475-6e2164756e21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.53.0-beta.11",
+  "version": "0.53.0-beta.13",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",