@dosu/cli 0.53.0-beta.12 → 0.53.0-beta.14

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.12", INSTALL_CHANNEL = "npm";
+var VERSION = "0.53.0-beta.14", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -8376,16 +8376,164 @@ var init_agents = __esm(() => {
   init_formats();
 });
 
+// src/sessions/project-dir.ts
+import {
+  closeSync as closeSync2,
+  existsSync as existsSync9,
+  mkdirSync as mkdirSync6,
+  openSync as openSync2,
+  readFileSync as readFileSync9,
+  readSync,
+  renameSync as renameSync2,
+  statSync as statSync3,
+  writeFileSync as writeFileSync6
+} from "node:fs";
+import { join as join8 } from "node:path";
+function cachePath(configDir) {
+  return join8(configDir, CACHE_FILENAME2);
+}
+function loadCacheFile(configDir) {
+  try {
+    const raw = JSON.parse(readFileSync9(cachePath(configDir), "utf-8"));
+    if (raw.schema_version !== CACHE_SCHEMA_VERSION || typeof raw.entries !== "object")
+      return {};
+    return raw.entries;
+  } catch {
+    return {};
+  }
+}
+function saveCacheFile(configDir, entries) {
+  try {
+    if (!existsSync9(configDir))
+      mkdirSync6(configDir, { recursive: true, mode: 448 });
+    const path3 = cachePath(configDir);
+    const tmp = `${path3}.${process.pid}.tmp`;
+    const file = { schema_version: CACHE_SCHEMA_VERSION, entries };
+    writeFileSync6(tmp, JSON.stringify(file), { mode: 384 });
+    renameSync2(tmp, path3);
+  } catch {}
+}
+function readHead(path3, bytes = HEAD_BYTES) {
+  let fd;
+  try {
+    fd = openSync2(path3, "r");
+  } catch {
+    return null;
+  }
+  try {
+    const buf = Buffer.alloc(bytes);
+    const read = readSync(fd, buf, 0, bytes, 0);
+    return buf.subarray(0, read).toString("utf-8");
+  } catch {
+    return null;
+  } finally {
+    closeSync2(fd);
+  }
+}
+function cwdFromJsonlHead(text) {
+  for (const line of text.split(`
+`).slice(0, HEAD_LINES)) {
+    if (!line.includes('"cwd"'))
+      continue;
+    try {
+      const obj = JSON.parse(line);
+      const cwd = obj.cwd ?? obj.payload?.cwd;
+      if (typeof cwd === "string" && cwd.startsWith("/"))
+        return cwd;
+    } catch {}
+  }
+  return null;
+}
+function unmungeSlug(slug, exists = existsSync9) {
+  const tokens = slug.replace(/^-/, "").split("-");
+  if (tokens.length === 0 || tokens[0] === "")
+    return null;
+  let budget = 5000;
+  const walk = (prefix, index) => {
+    if (budget-- <= 0)
+      return null;
+    if (index === tokens.length)
+      return exists(prefix) ? prefix : null;
+    const asSegment = prefix === "" || exists(prefix) ? walk(`${prefix}/${tokens[index]}`, index + 1) : null;
+    if (asSegment)
+      return asSegment;
+    return prefix === "" ? null : walk(`${prefix}-${tokens[index]}`, index + 1);
+  };
+  return walk("", 0);
+}
+function fileMtime(path3) {
+  try {
+    return statSync3(path3).mtime.toISOString();
+  } catch {
+    return "";
+  }
+}
+function createProjectDirResolver(configDir = getConfigDir(), deps = {}) {
+  const exists = deps.exists ?? existsSync9;
+  const head = deps.readHead ?? readHead;
+  const mtime = deps.mtime ?? fileMtime;
+  const entries = loadCacheFile(configDir);
+  let dirty = false;
+  const compute = (session) => {
+    switch (session.harness) {
+      case "opencode":
+        return session.project ?? null;
+      case "claude": {
+        const text = head(session.path);
+        const cwd = text ? cwdFromJsonlHead(text) : null;
+        if (cwd)
+          return cwd;
+        return session.project ? unmungeSlug(session.project, exists) : null;
+      }
+      case "codex": {
+        const text = head(session.path);
+        return text ? cwdFromJsonlHead(text) : null;
+      }
+      case "cursor":
+        return session.project ? unmungeSlug(session.project, exists) : null;
+      default:
+        return null;
+    }
+  };
+  return {
+    cached(key) {
+      return entries[key]?.dir ?? null;
+    },
+    resolve(session) {
+      const key = `${session.harness}/${session.id}`;
+      const cached = entries[key];
+      if (cached && (cached.dir !== null || cached.mtime === mtime(session.path))) {
+        return cached.dir;
+      }
+      const dir = compute(session);
+      entries[key] = { dir, mtime: mtime(session.path) };
+      dirty = true;
+      return dir;
+    },
+    flush() {
+      if (!dirty)
+        return;
+      saveCacheFile(configDir, entries);
+      dirty = false;
+    }
+  };
+}
+var CACHE_FILENAME2 = "project-dirs.json", CACHE_SCHEMA_VERSION = 1, HEAD_BYTES, HEAD_LINES = 50;
+var init_project_dir = __esm(() => {
+  init_config();
+  HEAD_BYTES = 128 * 1024;
+});
+
 // src/sessions/scan.ts
-import { existsSync as existsSync9, readdirSync, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync10, readdirSync, statSync as statSync4 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir3 } from "node:os";
-import { basename, join as join8 } from "node:path";
+import { basename, join as join9 } from "node:path";
 function listDir(dir) {
   try {
     return readdirSync(dir, { withFileTypes: true }).map((entry) => ({
       name: entry.name,
-      path: join8(dir, entry.name),
+      path: join9(dir, entry.name),
       isDir: entry.isDirectory()
     }));
   } catch {
@@ -8398,7 +8546,7 @@ function sessionFromFile(filePath, harness, project) {
     return null;
   let mtime;
   try {
-    mtime = statSync3(filePath).mtime;
+    mtime = statSync4(filePath).mtime;
   } catch {
     return null;
   }
@@ -8412,7 +8560,7 @@ function sessionFromFile(filePath, harness, project) {
 }
 function scanClaude(home) {
   const sessions = [];
-  for (const project of listDir(join8(home, ".claude", "projects"))) {
+  for (const project of listDir(join9(home, ".claude", "projects"))) {
     if (!project.isDir)
       continue;
     for (const entry of listDir(project.path)) {
@@ -8427,10 +8575,10 @@ function scanClaude(home) {
 }
 function scanCursor(home) {
   const sessions = [];
-  for (const project of listDir(join8(home, ".cursor", "projects"))) {
+  for (const project of listDir(join9(home, ".cursor", "projects"))) {
     if (!project.isDir)
       continue;
-    for (const entry of listDir(join8(project.path, "agent-transcripts"))) {
+    for (const entry of listDir(join9(project.path, "agent-transcripts"))) {
       const files = entry.isDir ? listDir(entry.path).filter((f2) => !f2.isDir) : [entry];
       for (const file of files) {
         const session = sessionFromFile(file.path, "cursor", project.name);
@@ -8442,9 +8590,9 @@ function scanCursor(home) {
   return sessions;
 }
 function scanCodex(home, env) {
-  const codexHome2 = env.CODEX_HOME ?? join8(home, ".codex");
+  const codexHome2 = env.CODEX_HOME ?? join9(home, ".codex");
   const sessions = [];
-  for (const year of listDir(join8(codexHome2, "sessions"))) {
+  for (const year of listDir(join9(codexHome2, "sessions"))) {
     if (!year.isDir)
       continue;
     for (const month of listDir(year.path)) {
@@ -8500,9 +8648,9 @@ function querySqlite(dbPath, sql) {
   }
 }
 function scanOpencode(home, env) {
-  const dataDir = env.XDG_DATA_HOME ?? join8(home, ".local", "share");
-  const dbPath = join8(dataDir, "opencode", "opencode.db");
-  if (!existsSync9(dbPath))
+  const dataDir = env.XDG_DATA_HOME ?? join9(home, ".local", "share");
+  const dbPath = join9(dataDir, "opencode", "opencode.db");
+  if (!existsSync10(dbPath))
     return [];
   const rows = querySqlite(dbPath, "SELECT id, directory, time_updated FROM session WHERE parent_id IS NULL");
   if (!rows)
@@ -8540,10 +8688,10 @@ function scanAgentSessions(options = {}) {
 var init_scan = () => {};
 
 // src/sync/watermark.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync9, renameSync as renameSync2, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join9 } from "node:path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync10, renameSync as renameSync3, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join10 } from "node:path";
 function syncStatePath(configDir = getConfigDir()) {
-  return join9(configDir, STATE_FILENAME);
+  return join10(configDir, STATE_FILENAME);
 }
 function loadSyncState(configDir = getConfigDir()) {
   const empty = {
@@ -8552,13 +8700,13 @@ function loadSyncState(configDir = getConfigDir()) {
     consecutive_failures: 0
   };
   const path3 = syncStatePath(configDir);
-  if (!existsSync10(path3))
+  if (!existsSync11(path3))
     return empty;
   try {
-    const raw = JSON.parse(readFileSync9(path3, "utf-8"));
+    const raw = JSON.parse(readFileSync10(path3, "utf-8"));
     if (raw.schema_version !== STATE_SCHEMA_VERSION)
       return empty;
-    const minedSessions = 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) => ({
+    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.project === "string" ? { project: record.project } : {}
@@ -8572,8 +8720,8 @@ function loadSyncState(configDir = getConfigDir()) {
       watermark: typeof raw.watermark === "string" ? raw.watermark : null,
       last_attempt_at: typeof raw.last_attempt_at === "string" ? raw.last_attempt_at : undefined,
       consecutive_failures: typeof raw.consecutive_failures === "number" && raw.consecutive_failures >= 0 ? raw.consecutive_failures : 0,
-      mined_sessions: minedSessions,
-      total_mined: typeof raw.total_mined === "number" && raw.total_mined >= 0 ? raw.total_mined : minedSessions.length,
+      mined_sessions: studiedSessions,
+      total_mined: typeof raw.total_mined === "number" && raw.total_mined >= 0 ? raw.total_mined : studiedSessions.length,
       total_notes: typeof raw.total_notes === "number" && raw.total_notes >= 0 ? raw.total_notes : 0,
       total_learning_tokens: typeof raw.total_learning_tokens === "number" && raw.total_learning_tokens >= 0 ? raw.total_learning_tokens : 0,
       ...lastRefusal ? { last_refusal: lastRefusal } : {},
@@ -8595,13 +8743,24 @@ 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 });
+  if (!existsSync11(configDir))
+    mkdirSync7(configDir, { recursive: true, mode: 448 });
   const path3 = syncStatePath(configDir);
   const tmp = `${path3}.${process.pid}.tmp`;
-  writeFileSync6(tmp, JSON.stringify(state, null, 2), { mode: 384 });
-  renameSync2(tmp, path3);
+  writeFileSync7(tmp, JSON.stringify(state, null, 2), { mode: 384 });
+  renameSync3(tmp, path3);
 }
 function backoffUntil(state) {
   if (state.consecutive_failures === 0 || !state.last_attempt_at)
@@ -8645,7 +8804,7 @@ function gateSessions(sessions, watermark, now = new Date, quietPeriodMs = DEFAU
   }
   return { ready, open: open2 };
 }
-var STATE_FILENAME = "knowledge-sync.json", STATE_SCHEMA_VERSION = 1, DEFAULT_QUIET_PERIOD_MS, BACKOFF_BASE_MS, BACKOFF_MAX_MS, MINED_HISTORY_LIMIT = 500, UNKNOWN_PROJECT = "(unknown)";
+var STATE_FILENAME = "knowledge-sync.json", STATE_SCHEMA_VERSION = 1, DEFAULT_QUIET_PERIOD_MS, BACKOFF_BASE_MS, BACKOFF_MAX_MS, STUDIED_HISTORY_LIMIT = 500, UNKNOWN_PROJECT = "(unknown)";
 var init_watermark = __esm(() => {
   init_config();
   DEFAULT_QUIET_PERIOD_MS = 5 * 60 * 1000;
@@ -8661,20 +8820,34 @@ async function fetchReportNotes(cfg) {
   }
   const { createTypedClient: createTypedClient2 } = await Promise.resolve().then(() => (init_trpc(), exports_trpc));
   const client = createTypedClient2(cfg);
-  const { notes } = await client.notes.listMine.query({
-    org_id: orgId,
-    limit: REPORT_NOTES_LIMIT
-  });
-  return notes.map((note) => ({
-    title: note.title,
-    content: note.body,
-    at: note.created_at,
-    ...note.transcript_id ? { transcript_id: note.transcript_id } : {},
-    ...note.repo ? { repo: note.repo } : {},
-    ...note.branch ? { branch: note.branch } : {}
-  }));
+  const notes = [];
+  let cursor3;
+  let truncated = false;
+  for (let page = 0;page < REPORT_NOTES_MAX_PAGES; page++) {
+    const result = await client.notes.listMine.query({
+      org_id: orgId,
+      limit: REPORT_NOTES_LIMIT,
+      ...cursor3 ? { cursor: cursor3 } : {}
+    });
+    notes.push(...result.notes.map((note) => ({
+      title: note.title,
+      content: note.body,
+      at: note.created_at,
+      ...note.transcript_id ? { transcript_id: note.transcript_id } : {},
+      ...note.repo ? { repo: note.repo } : {},
+      ...note.branch ? { branch: note.branch } : {}
+    })));
+    cursor3 = result.next_cursor;
+    if (!cursor3) {
+      truncated = result.notes.length === REPORT_NOTES_LIMIT;
+      break;
+    }
+    if (page === REPORT_NOTES_MAX_PAGES - 1)
+      truncated = true;
+  }
+  return { notes, truncated };
 }
-var REPORT_NOTES_LIMIT = 500;
+var REPORT_NOTES_LIMIT = 500, REPORT_NOTES_MAX_PAGES = 40;
 
 // src/report/css.ts
 var REPORT_CSS = `
@@ -8849,38 +9022,6 @@ function applyStatusDefaults(candidates, dryRun) {
     return { ...c2, status: known.has(current) ? current : fallback };
   });
 }
-function tokenTotalsFromCandidates(candidates, inventory) {
-  if (candidates.length === 0)
-    return null;
-  let replaced = 0;
-  let hasRediscovery = false;
-  let readCost = 0;
-  for (const c2 of candidates) {
-    const raw = c2.approx_rediscovery_tokens;
-    if (raw != null) {
-      hasRediscovery = true;
-      replaced += Math.max(0, Number(raw) || 0);
-    }
-    const blob = `${c2.title ?? ""}
-${c2.content ?? ""}`;
-    readCost += Math.round(blob.length / CHARS_PER_TOKEN);
-  }
-  if (!hasRediscovery)
-    return null;
-  let baseline = inventory.totals?.learning_tokens ?? 0;
-  if (!baseline) {
-    baseline = inventory.transcripts.reduce((sum, t2) => sum + (t2.learning_tokens || 0), 0);
-  }
-  const saved = Math.max(0, replaced - readCost);
-  const pct = baseline ? Math.round(1000 * saved / baseline) / 10 : 0;
-  return {
-    baseline_tokens: baseline,
-    replaced_baseline_tokens: replaced,
-    read_knowledge_tokens: readCost,
-    tokens_saved: saved,
-    pct_saved: pct
-  };
-}
 function presentationCopy(c2) {
   const idea = (c2.plain_english || "").trim() || (c2.content || "").trim();
   const how = (c2.how_found || "").trim();
@@ -9254,11 +9395,9 @@ function buildReportHtml(options) {
     return bv - av;
   });
   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 projects = options.projects ?? [];
+  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);
   const candidateRows = candidates.map((c2, i2) => {
     const [idea, work] = presentationCopy(c2);
@@ -9298,27 +9437,19 @@ function buildReportHtml(options) {
       <td>${esc(query)}</td>
     </tr>`;
   }).join("");
-  let tokenSection;
-  if (derived) {
-    tokenSection = `
+  const scannedTokens = inventory.totals?.learning_tokens || transcripts.reduce((sum, t2) => sum + (t2.learning_tokens || 0), 0);
+  const writtenCount = candidates.filter((c2) => (c2.status || "written").toLowerCase() === "written").length;
+  const writtenLabel = options.dryRun ? "Notes proposed (dry run)" : "Notes written to Dosu";
+  const writtenValue = options.dryRun ? candidates.length : writtenCount;
+  const tokenSection = `
 <section>
-  <h2>Estimated context savings</h2>
-  <p class="lede">Counterfactual: replace rediscovery stretches with a Dosu <code>read_knowledge</code> hit.</p>
+  <h2>This run</h2>
   <div class="stats">
-    <div class="stat"><div class="label">Baseline (cost to learn)</div><div class="value">${fmtInt(derived.baseline_tokens)}</div></div>
-    <div class="stat"><div class="label">Learning replaced</div><div class="value">${fmtInt(derived.replaced_baseline_tokens)}</div></div>
-    <div class="stat"><div class="label">Read cost</div><div class="value">${fmtInt(derived.read_knowledge_tokens)}</div></div>
-    <div class="stat highlight"><div class="label">Est. tokens saved</div><div class="value">${fmtInt(derived.tokens_saved)} <span class="pct">(${esc(`${derived.pct_saved}%`)})</span></div></div>
+    <div class="stat"><div class="label">Tokens scanned</div><div class="value">${fmtInt(scannedTokens)}</div></div>
+    <div class="stat highlight"><div class="label">${esc(writtenLabel)}</div><div class="value">${fmtInt(writtenValue)}</div></div>
   </div>
 </section>`;
-  } else {
-    tokenSection = `
-<section>
-  <h2>Estimated context savings</h2>
-  <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">
@@ -9337,9 +9468,8 @@ ${REPORT_CSS}
       <h1>${esc(org)}</h1>
       <p class="lede">${esc(summary)}</p>
       <p class="meta-line">
-        Repo <code>${esc(repo)}</code>
-        · branch <code>${esc(branch)}</code>
-        · generated ${esc(generated)}
+        ${projects.length > 0 ? `Projects ${projects.map((p2) => `<code>${esc(p2)}</code>`).join(", ")} · ` : ""}${transcripts.length} session${transcripts.length === 1 ? "" : "s"} with notes
+        · generated ${esc(generated)}${options.truncated ? " · newest notes only (server capped the fetch)" : ""}
       </p>
       <div class="toolbar no-print">
         <button type="button" onclick="window.print()">Print / Save as PDF</button>
@@ -9385,7 +9515,7 @@ ${REPORT_CSS}
 </html>
 `;
 }
-var CHARS_PER_TOKEN = 4, MAX_TRACE_STEPS = 50, PREVIEW_CHARS = 80, SQL_DISPLAY, LOGS_DISPLAY, SKIP_TOOL_NAMES, TAG_RE, WS_RE;
+var MAX_TRACE_STEPS = 50, PREVIEW_CHARS = 80, SQL_DISPLAY, LOGS_DISPLAY, SKIP_TOOL_NAMES, TAG_RE, WS_RE;
 var init_html = __esm(() => {
   SQL_DISPLAY = new Set(["execute_sql", "query_run", "list_tables"]);
   LOGS_DISPLAY = new Set(["query_logs"]);
@@ -9395,7 +9525,7 @@ var init_html = __esm(() => {
 });
 
 // src/sessions/read.ts
-import { readFileSync as readFileSync10 } from "node:fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
@@ -9511,11 +9641,11 @@ function readSessionTurns(session) {
   try {
     switch (session.harness) {
       case "claude":
-        return readClaude(readFileSync10(session.path, "utf8"));
+        return readClaude(readFileSync11(session.path, "utf8"));
       case "cursor":
-        return readCursor(readFileSync10(session.path, "utf8"));
+        return readCursor(readFileSync11(session.path, "utf8"));
       case "codex":
-        return readCodex(readFileSync10(session.path, "utf8"));
+        return readCodex(readFileSync11(session.path, "utf8"));
       case "opencode":
         return readOpencode(session.path, session.id);
     }
@@ -9543,7 +9673,7 @@ function countRediscoveryToolCalls(session) {
       case "claude":
       case "cursor": {
         let n2 = 0;
-        for (const record of jsonlRecords(readFileSync10(session.path, "utf8"))) {
+        for (const record of jsonlRecords(readFileSync11(session.path, "utf8"))) {
           const message = asRecord(record.message);
           for (const name of toolNamesFromContent(message?.content)) {
             if (isRediscoveryTool(name))
@@ -9554,7 +9684,7 @@ function countRediscoveryToolCalls(session) {
       }
       case "codex": {
         let n2 = 0;
-        for (const record of jsonlRecords(readFileSync10(session.path, "utf8"))) {
+        for (const record of jsonlRecords(readFileSync11(session.path, "utf8"))) {
           const payload = asRecord(record.payload);
           if (payload?.type === "function_call" && typeof payload.name === "string") {
             if (isRediscoveryTool(payload.name))
@@ -9574,9 +9704,9 @@ function estimateSessionTokens(session) {
   let chars = 0;
   for (const turn of readSessionTurns(session))
     chars += turn.text.length;
-  return Math.round(chars / CHARS_PER_TOKEN2);
+  return Math.round(chars / CHARS_PER_TOKEN);
 }
-function isWorthMining(session) {
+function isWorthStudying(session) {
   const turns = readSessionTurns(session);
   if (turns.length < MIN_WORTH_TURNS)
     return false;
@@ -9588,7 +9718,7 @@ function isWorthMining(session) {
   }
   return false;
 }
-var PLAIN_TEXT, CODEX_TEXT, REDISCOVERY_TOOLS, CHARS_PER_TOKEN2 = 4, MIN_WORTH_TURNS = 4, MIN_WORTH_CHARS = 2000;
+var PLAIN_TEXT, CODEX_TEXT, REDISCOVERY_TOOLS, CHARS_PER_TOKEN = 4, MIN_WORTH_TURNS = 4, MIN_WORTH_CHARS = 2000;
 var init_read = __esm(() => {
   init_scan();
   PLAIN_TEXT = new Set(["text"]);
@@ -9645,12 +9775,12 @@ var init_queries = __esm(() => {
 });
 
 // src/report/digest.ts
-import { readFileSync as readFileSync11 } from "node:fs";
+import { readFileSync as readFileSync12 } from "node:fs";
 function asRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 function estimateTokens(text) {
-  return Math.round(text.length / CHARS_PER_TOKEN3);
+  return Math.round(text.length / CHARS_PER_TOKEN2);
 }
 function digestEstTokens(texts, tools, resultChars) {
   const countable = tools.filter((t2) => t2.name !== "tool_result");
@@ -9660,7 +9790,7 @@ function digestEstTokens(texts, tools, resultChars) {
     payload += JSON.stringify(countable);
   let tokens = estimateTokens(payload);
   if (resultChars > 0)
-    tokens += Math.max(1, Math.round(resultChars / CHARS_PER_TOKEN3));
+    tokens += Math.max(1, Math.round(resultChars / CHARS_PER_TOKEN2));
   return tokens;
 }
 function copyToolInputFields(entry, inp) {
@@ -9876,16 +10006,16 @@ function sessionToDigest(session) {
   try {
     switch (session.harness) {
       case "claude":
-        return { turns: digestClaude(readFileSync11(session.path, "utf8")) };
+        return { turns: digestClaude(readFileSync12(session.path, "utf8")) };
       case "cursor":
-        return { turns: digestCursor(readFileSync11(session.path, "utf8")) };
+        return { turns: digestCursor(readFileSync12(session.path, "utf8")) };
       case "codex":
-        return { turns: digestCodex(readFileSync11(session.path, "utf8")) };
+        return { turns: digestCodex(readFileSync12(session.path, "utf8")) };
       case "opencode": {
         const turns = readSessionTurns(session).map((turn, index) => ({
           role: turn.role,
           line: index + 1,
-          est_tokens: Math.round(turn.text.length / CHARS_PER_TOKEN3),
+          est_tokens: Math.round(turn.text.length / CHARS_PER_TOKEN2),
           text: [turn.text],
           tools: []
         }));
@@ -9910,7 +10040,7 @@ function digestTurnText(turn) {
   return texts.filter(Boolean).join(`
 `);
 }
-var CHARS_PER_TOKEN3 = 4, MAX_ASSISTANT_CHARS = 4000, MCP_DIGEST_TOOLS;
+var CHARS_PER_TOKEN2 = 4, MAX_ASSISTANT_CHARS = 4000, MCP_DIGEST_TOOLS;
 var init_digest = __esm(() => {
   init_read();
   init_queries();
@@ -10101,17 +10231,17 @@ var init_notes = __esm(() => {
 });
 
 // src/report/write.ts
-import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync7 } from "node:fs";
+import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync8 } from "node:fs";
 import { tmpdir } from "node:os";
-import { dirname as dirname4, join as join10, resolve } from "node:path";
+import { dirname as dirname4, join as join11, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 function defaultReportPath() {
-  return join10(tmpdir(), "dosu-knowledge-report.html");
+  return join11(tmpdir(), "dosu-knowledge-report.html");
 }
 async function writeAndOpenReport(options) {
   const out = resolve(options.out ?? defaultReportPath());
-  mkdirSync7(dirname4(out), { recursive: true });
-  writeFileSync7(out, options.html, "utf8");
+  mkdirSync8(dirname4(out), { recursive: true });
+  writeFileSync8(out, options.html, "utf8");
   if (options.open !== false) {
     const url = pathToFileURL(out).href;
     if (options.openUrl) {
@@ -10126,17 +10256,26 @@ async function writeAndOpenReport(options) {
 var init_write = () => {};
 
 // src/report/generate.ts
+import { basename as basename2 } from "node:path";
 function sessionsForNotes(notes, sessions) {
   const ids = new Set(notes.map((n2) => n2.transcript_id).filter((id) => Boolean(id)));
   return sessions.filter((s) => ids.has(s.id));
 }
+function defaultProjectName() {
+  const resolver = createProjectDirResolver();
+  return (session) => {
+    const dir = resolver.resolve(session);
+    return dir ? basename2(dir) : null;
+  };
+}
 function noteTime(note) {
   const parsed = Date.parse(note.at ?? "");
   return Number.isNaN(parsed) ? 0 : parsed;
 }
 async function emitKnowledgeReport(options = {}) {
   const cfg = loadConfig();
-  const notes = [...options.notes ?? await (options.fetchNotes ?? fetchReportNotes)(cfg)].sort((a3, b2) => noteTime(a3) - noteTime(b2));
+  const fetched = options.notes ? { notes: options.notes, truncated: false } : await (options.fetchNotes ?? fetchReportNotes)(cfg);
+  const notes = [...fetched.notes].sort((a3, b2) => noteTime(a3) - noteTime(b2));
   const scanned = options.sessions ?? scanAgentSessions();
   const sessions = sessionsForNotes(notes, scanned);
   const candidates = attributeRediscovery(notes, sessions);
@@ -10145,12 +10284,16 @@ async function emitKnowledgeReport(options = {}) {
   if (inventory.totals && state.total_learning_tokens && !options.sessions) {
     inventory.totals.learning_tokens = state.total_learning_tokens;
   }
+  const projectName = options.projectName ?? defaultProjectName();
+  const projects = [
+    ...new Set(sessions.map((s) => projectName(s) ?? s.project).filter((name) => Boolean(name)))
+  ];
   const html = buildReportHtml({
     inventory,
     candidates,
     orgName: options.orgName ?? cfg.active_account?.target?.org_name ?? "Your team",
-    repo: options.repo ?? notes.find((n2) => n2.repo)?.repo,
-    branch: options.branch ?? notes.find((n2) => n2.branch)?.branch,
+    projects,
+    truncated: fetched.truncated,
     generatedAt: options.generatedAt,
     digests: digestsForSessions(sessions)
   });
@@ -10163,6 +10306,7 @@ async function emitKnowledgeReport(options = {}) {
 }
 var init_generate = __esm(() => {
   init_config();
+  init_project_dir();
   init_scan();
   init_watermark();
   init_html();
@@ -10170,151 +10314,6 @@ var init_generate = __esm(() => {
   init_write();
 });
 
-// src/sessions/project-dir.ts
-import {
-  closeSync as closeSync2,
-  existsSync as existsSync11,
-  mkdirSync as mkdirSync8,
-  openSync as openSync2,
-  readFileSync as readFileSync12,
-  readSync,
-  renameSync as renameSync3,
-  statSync as statSync4,
-  writeFileSync as writeFileSync8
-} from "node:fs";
-import { join as join11 } from "node:path";
-function cachePath(configDir) {
-  return join11(configDir, CACHE_FILENAME2);
-}
-function loadCacheFile(configDir) {
-  try {
-    const raw = JSON.parse(readFileSync12(cachePath(configDir), "utf-8"));
-    if (raw.schema_version !== CACHE_SCHEMA_VERSION || typeof raw.entries !== "object")
-      return {};
-    return raw.entries;
-  } catch {
-    return {};
-  }
-}
-function saveCacheFile(configDir, entries) {
-  try {
-    if (!existsSync11(configDir))
-      mkdirSync8(configDir, { recursive: true, mode: 448 });
-    const path3 = cachePath(configDir);
-    const tmp = `${path3}.${process.pid}.tmp`;
-    const file = { schema_version: CACHE_SCHEMA_VERSION, entries };
-    writeFileSync8(tmp, JSON.stringify(file), { mode: 384 });
-    renameSync3(tmp, path3);
-  } catch {}
-}
-function readHead(path3, bytes = HEAD_BYTES) {
-  let fd;
-  try {
-    fd = openSync2(path3, "r");
-  } catch {
-    return null;
-  }
-  try {
-    const buf = Buffer.alloc(bytes);
-    const read = readSync(fd, buf, 0, bytes, 0);
-    return buf.subarray(0, read).toString("utf-8");
-  } catch {
-    return null;
-  } finally {
-    closeSync2(fd);
-  }
-}
-function cwdFromJsonlHead(text) {
-  for (const line of text.split(`
-`).slice(0, HEAD_LINES)) {
-    if (!line.includes('"cwd"'))
-      continue;
-    try {
-      const obj = JSON.parse(line);
-      const cwd = obj.cwd ?? obj.payload?.cwd;
-      if (typeof cwd === "string" && cwd.startsWith("/"))
-        return cwd;
-    } catch {}
-  }
-  return null;
-}
-function unmungeSlug(slug, exists = existsSync11) {
-  const tokens = slug.replace(/^-/, "").split("-");
-  if (tokens.length === 0 || tokens[0] === "")
-    return null;
-  let budget = 5000;
-  const walk = (prefix, index) => {
-    if (budget-- <= 0)
-      return null;
-    if (index === tokens.length)
-      return exists(prefix) ? prefix : null;
-    const asSegment = prefix === "" || exists(prefix) ? walk(`${prefix}/${tokens[index]}`, index + 1) : null;
-    if (asSegment)
-      return asSegment;
-    return prefix === "" ? null : walk(`${prefix}-${tokens[index]}`, index + 1);
-  };
-  return walk("", 0);
-}
-function fileMtime(path3) {
-  try {
-    return statSync4(path3).mtime.toISOString();
-  } catch {
-    return "";
-  }
-}
-function createProjectDirResolver(configDir = getConfigDir(), deps = {}) {
-  const exists = deps.exists ?? existsSync11;
-  const head = deps.readHead ?? readHead;
-  const mtime = deps.mtime ?? fileMtime;
-  const entries = loadCacheFile(configDir);
-  let dirty = false;
-  const compute = (session) => {
-    switch (session.harness) {
-      case "opencode":
-        return session.project ?? null;
-      case "claude": {
-        const text = head(session.path);
-        const cwd = text ? cwdFromJsonlHead(text) : null;
-        if (cwd)
-          return cwd;
-        return session.project ? unmungeSlug(session.project, exists) : null;
-      }
-      case "codex": {
-        const text = head(session.path);
-        return text ? cwdFromJsonlHead(text) : null;
-      }
-      case "cursor":
-        return session.project ? unmungeSlug(session.project, exists) : null;
-      default:
-        return null;
-    }
-  };
-  return {
-    resolve(session) {
-      const key = `${session.harness}/${session.id}`;
-      const cached = entries[key];
-      if (cached && (cached.dir !== null || cached.mtime === mtime(session.path))) {
-        return cached.dir;
-      }
-      const dir = compute(session);
-      entries[key] = { dir, mtime: mtime(session.path) };
-      dirty = true;
-      return dir;
-    },
-    flush() {
-      if (!dirty)
-        return;
-      saveCacheFile(configDir, entries);
-      dirty = false;
-    }
-  };
-}
-var CACHE_FILENAME2 = "project-dirs.json", CACHE_SCHEMA_VERSION = 1, HEAD_BYTES, HEAD_LINES = 50;
-var init_project_dir = __esm(() => {
-  init_config();
-  HEAD_BYTES = 128 * 1024;
-});
-
 // src/sync/backlog.ts
 function listSessionBacklog() {
   try {
@@ -10459,7 +10458,7 @@ function readLockFile(configDir) {
 }
 function recentSyncActivity(log3) {
   return log3.split(`
-`).filter((line) => line.includes("[sync]") || line.includes("[miner]")).slice(-ACTIVITY_LINES).map((line) => line.replace(/ \[(DEBUG|INFO|WARN|ERROR)\]/, ""));
+`).filter((line) => line.includes("[sync]") || line.includes("[learner]")).slice(-ACTIVITY_LINES).map((line) => line.replace(/ \[(DEBUG|INFO|WARN|ERROR)\]/, ""));
 }
 function getSyncStatus(deps = {}) {
   const configDir = deps.configDir ?? getConfigDir();
@@ -10508,7 +10507,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);
@@ -10518,7 +10517,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;
@@ -10580,14 +10579,14 @@ async function runKnowledgeSync(options = {}) {
         baseline_mined: state.total_mined ?? 0
       };
     }
-    const worthMining = deps.worthMining ?? isWorthMining;
+    const worthStudying = deps.worthStudying ?? isWorthStudying;
     const examined = [];
     const batch = [];
     let trivial = 0;
     for (let i2 = ready.length - 1;i2 >= 0 && batch.length < MINE_BATCH_LIMIT; i2--) {
       const candidate = ready[i2];
       examined.push(candidate);
-      if (worthMining(candidate)) {
+      if (worthStudying(candidate)) {
         batch.push(candidate);
       } else {
         trivial += 1;
@@ -10604,26 +10603,26 @@ async function runKnowledgeSync(options = {}) {
       return {
         status: "nothing-new",
         ...base,
-        minedSessions: 0,
+        studiedSessions: 0,
         trivialSessions: trivial
       };
     }
-    logger.debug("sync", `mining ${batch.length} of ${ready.length} ready sessions (${trivial} trivial skipped)`);
-    const miner = await deps.mine(batch);
-    switch (miner.outcome) {
+    logger.debug("sync", `studying ${batch.length} of ${ready.length} ready sessions (${trivial} trivial skipped)`);
+    const learner = await deps.mine(batch);
+    switch (learner.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 studiedAt = now().toISOString();
         const history = [
           ...state.mined_sessions ?? [],
           ...batch.map((s) => ({
-            at: minedAt,
+            at: studiedAt,
             session: `${s.harness}/${s.id}`,
             ...s.project ? { project: s.project } : {}
           }))
-        ].slice(-MINED_HISTORY_LIMIT);
+        ].slice(-STUDIED_HISTORY_LIMIT);
         const watermark = batchWatermark(examined);
         const sessionTokens = deps.sessionTokens ?? estimateSessionTokens;
         let batchTokens = 0;
@@ -10632,21 +10631,21 @@ async function runKnowledgeSync(options = {}) {
         saveState({
           ...state,
           watermark,
-          last_attempt_at: minedAt,
+          last_attempt_at: studiedAt,
           consecutive_failures: 0,
           mined_sessions: history,
           total_mined: (state.total_mined ?? 0) + batch.length,
-          total_notes: (state.total_notes ?? 0) + miner.notesWritten,
+          total_notes: (state.total_notes ?? 0) + learner.notesWritten,
           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, ${learner.notesWritten} suggested pages; watermark → ${watermark}`);
         return {
-          status: "mined",
+          status: "studied",
           ...base,
-          minedSessions: batch.length,
+          studiedSessions: batch.length,
           trivialSessions: trivial,
-          miner
+          learner
         };
       }
       case "consent_off":
@@ -10659,12 +10658,12 @@ async function runKnowledgeSync(options = {}) {
           consecutive_failures: 0,
           last_refusal: {
             at,
-            outcome: miner.outcome,
-            message: miner.message ?? "Mining unavailable right now."
+            outcome: learner.outcome,
+            message: learner.message ?? "Studying unavailable right now."
           }
         });
-        logger.debug("sync", `mining skipped by gateway: ${miner.outcome}`);
-        return { status: "skipped-gateway", ...base, minedSessions: 0, miner };
+        logger.debug("sync", `studying skipped by gateway: ${learner.outcome}`);
+        return { status: "skipped-gateway", ...base, studiedSessions: 0, learner };
       }
       default: {
         saveState({
@@ -10672,13 +10671,13 @@ 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: ${learner.outcome}; ${learner.message ?? ""}`);
         return {
           status: "mine-failed",
           ...base,
-          minedSessions: 0,
-          miner,
-          error: miner.message
+          studiedSessions: 0,
+          learner,
+          error: learner.message
         };
       }
     }
@@ -10824,12 +10823,12 @@ var init_backfill_run = __esm(() => {
   init_backfill();
 });
 
-// src/miner/config-dir.ts
+// src/learner/config-dir.ts
 import { mkdtempSync, rmSync as rmSync3, writeFileSync as writeFileSync10 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { join as join13 } from "node:path";
 function createRunConfigDir() {
-  const path3 = mkdtempSync(join13(tmpdir2(), "dosu-miner-"));
+  const path3 = mkdtempSync(join13(tmpdir2(), "dosu-learner-"));
   writeFileSync10(join13(path3, ".claude.json"), JSON.stringify({ hasCompletedOnboarding: true }));
   return {
     path: path3,
@@ -10840,7 +10839,7 @@ function createRunConfigDir() {
 }
 var init_config_dir = () => {};
 
-// src/miner/conflicts.ts
+// src/learner/conflicts.ts
 import { existsSync as existsSync13, readFileSync as readFileSync15 } from "node:fs";
 function managedSettingsPaths(platform3 = process.platform) {
   switch (platform3) {
@@ -10898,11 +10897,11 @@ var init_conflicts = __esm(() => {
   CONFLICTING_ENV_PREFIXES = ["ANTHROPIC_", "CLAUDE_CODE_", "AWS_"];
 });
 
-// src/miner/env.ts
+// src/learner/env.ts
 function isStripped(name) {
   return STRIPPED_NAMES.has(name) || STRIPPED_PREFIXES.some((p2) => name.startsWith(p2));
 }
-function buildMinerEnv(options) {
+function buildLearnerEnv(options) {
   const base = options.baseEnv ?? process.env;
   const env = {};
   for (const [name, value] of Object.entries(base)) {
@@ -10932,7 +10931,7 @@ var init_env = __esm(() => {
   STRIPPED_NAMES = new Set(["CLAUDE_CONFIG_DIR", "CLAUDECODE", "AWS_BEARER_TOKEN_BEDROCK"]);
 });
 
-// src/miner/executable.ts
+// src/learner/executable.ts
 import { accessSync, constants, existsSync as existsSync14 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { homedir as homedir4 } from "node:os";
@@ -10979,9 +10978,9 @@ function resolveClaudeExecutable(options = {}) {
 }
 var init_executable = () => {};
 
-// src/miner/prompt.ts
-function buildMinerSystemPrompt(coreRules) {
-  return `You are Dosu's knowledge miner. 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.
+// 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.
 
 Available tools (the only tools you may use, by these exact names):
 - mcp__sessions__list_sessions / mcp__sessions__read_session: the session transcripts in scope for this run.
@@ -10989,7 +10988,7 @@ Available tools (the only tools you may use, by these exact names):
 
 ${coreRules}`;
 }
-function buildMinerPrompt(sessions) {
+function buildLearnerPrompt(sessions) {
   const list = sessions.map((s) => `- ${s.id} (${s.harness})`).join(`
 `);
   return `Mine the following ${sessions.length} coding-agent session(s) for durable knowledge:
@@ -10999,8 +10998,8 @@ ${list}
 Work through them ONE AT A TIME: read a single session with read_session, decide what (if anything) is durable per your rules, dedupe against read_knowledge, and write that session's notes with write_knowledge BEFORE moving on to the next session. Each note is attributed to the session you read just before writing it, so do not read the next session until you have written this one's notes. When you are done, reply with a one-line summary: how many sessions you read and how many notes you wrote.`;
 }
 
-// src/miner/prompt-core.ts
-var MINER_CORE_RULES = `Rules — non-negotiable:
+// src/learner/prompt-core.ts
+var LEARNER_CORE_RULES = `Rules — non-negotiable:
 1. Before writing anything, call read_knowledge with the candidate topic. If the same fact is
 already recorded, skip it — never write a duplicate or near-duplicate. If the topic exists but
 the session shows it has changed or been superseded, do write: a note stating the current state
@@ -11028,10 +11027,9 @@ useful.
 6. Only pass repo/branch to write_knowledge when the session itself verifies them (an explicit
 cwd, git remote, or branch mentioned in the transcript). Never infer or guess a repo. When not
 verified, omit both.
-7. Populate write_knowledge metadata with source_agent and session_id for every note.
-8. Never quote credentials, tokens, or secrets — even redacted placeholders — and never include
+7. Never quote credentials, tokens, or secrets — even redacted placeholders — and never include
 long verbatim transcript spans. Summarize in your own words.
-9. A trivial session with no real user query is normal: skip it silently.`;
+8. A trivial session with no real user query is normal: skip it silently.`;
 
 // node_modules/@anthropic-ai/claude-agent-sdk/sdk.mjs
 var exports_sdk = {};
@@ -72782,7 +72780,7 @@ var init_redact = __esm(() => {
   ]);
 });
 
-// src/miner/tools.ts
+// src/learner/tools.ts
 function textResult(text) {
   return { content: [{ type: "text", text }] };
 }
@@ -72841,7 +72839,7 @@ function createSessionToolsServer(sessions) {
     name: SESSIONS_SERVER_NAME,
     version: "1.0.0",
     tools: [
-      O6e("list_sessions", "List the coding-agent sessions in scope for this mining run.", {}, async () => textResult(formatSessionList(sessions))),
+      O6e("list_sessions", "List the coding-agent sessions in scope for this study run.", {}, async () => textResult(formatSessionList(sessions))),
       O6e("read_session", "Read the conversation turns of one in-scope session. Responses are " + "paginated; pass the returned offset to continue reading.", {
         id: exports_external.string().describe("Session id from list_sessions"),
         offset: exports_external.number().int().min(0).optional().describe("Turn index to start from")
@@ -72867,11 +72865,11 @@ var init_tools = __esm(() => {
   init_redact();
 });
 
-// src/miner/runner.ts
+// src/learner/runner.ts
 var exports_runner = {};
 __export(exports_runner, {
   traceAgentMessage: () => traceAgentMessage,
-  runMiner: () => runMiner,
+  runLearner: () => runLearner,
   classifyGatewayError: () => classifyGatewayError
 });
 function classifyGatewayError(text) {
@@ -72893,12 +72891,12 @@ function traceAgentMessage(message) {
     return;
   for (const block2 of content) {
     if (msg.type === "assistant" && block2.type === "text") {
-      logger.debug("miner", `[agent] ${snippet(block2.text)}`);
+      logger.debug("learner", `[agent] ${snippet(block2.text)}`);
     } else if (msg.type === "assistant" && block2.type === "tool_use") {
-      logger.debug("miner", `[agent] → ${block2.name} ${snippet(block2.input)}`);
+      logger.debug("learner", `[agent] → ${block2.name} ${snippet(block2.input)}`);
     } else if (msg.type === "user" && block2.type === "tool_result") {
       const full = JSON.stringify(block2.content ?? "");
-      logger.debug("miner", `[agent] ← result ${full.length} chars${block2.is_error ? " (error)" : ""}: ${snippet(block2.content).slice(0, 120)}`);
+      logger.debug("learner", `[agent] ← result ${full.length} chars${block2.is_error ? " (error)" : ""}: ${snippet(block2.content).slice(0, 120)}`);
     }
   }
 }
@@ -72911,7 +72909,7 @@ function allowedToolNames() {
     `mcp__${KNOWLEDGE_SERVER_NAME}__finalize_session_knowledge`
   ]);
 }
-async function runMiner(options) {
+async function runLearner(options) {
   const conflicts = detectSettingsConflicts();
   if (conflicts.length > 0) {
     const detail = conflicts.map((c5) => `${c5.file} (${c5.keys.join(", ")})`).join("; ");
@@ -72919,7 +72917,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();
@@ -72934,7 +72932,7 @@ async function runMiner(options) {
   const { query } = await Promise.resolve().then(() => (init_sdk(), exports_sdk));
   const claudeExecutable = resolveClaudeExecutable();
   if (claudeExecutable) {
-    logger.debug("miner", `using system Claude Code executable: ${claudeExecutable}`);
+    logger.debug("learner", `using system Claude Code executable: ${claudeExecutable}`);
   }
   const configDir = createRunConfigDir();
   const runID = options.runID ?? crypto.randomUUID();
@@ -72947,7 +72945,7 @@ async function runMiner(options) {
   let currentSession;
   const readsSinceWrite = new Set;
   let turns = 0;
-  const env = buildMinerEnv({
+  const env = buildLearnerEnv({
     apiKey: options.apiKey,
     gatewayURL,
     configDir: configDir.path,
@@ -72958,9 +72956,9 @@ async function runMiner(options) {
   });
   try {
     const run2 = query({
-      prompt: buildMinerPrompt(options.sessions),
+      prompt: buildLearnerPrompt(options.sessions),
       options: {
-        systemPrompt: buildMinerSystemPrompt(MINER_CORE_RULES),
+        systemPrompt: buildLearnerSystemPrompt(LEARNER_CORE_RULES),
         env,
         abortController: abort,
         maxTurns: options.maxTurns ?? DEFAULT_MAX_TURNS,
@@ -72976,17 +72974,17 @@ async function runMiner(options) {
             headers: {
               ...mcpHeaders(options.apiKey),
               "X-Dosu-Session-Id": runID,
-              "X-Dosu-Client": `dosu-cli-miner/${getVersionString()}`,
+              "X-Dosu-Client": `dosu-cli-learner/${getVersionString()}`,
               ...sessionStartedAt ? { "X-Dosu-Session-Started-At": sessionStartedAt } : {}
             }
           }
         },
-        stderr: (data) => logger.debug("miner", `[sdk] ${data}`),
+        stderr: (data) => logger.debug("learner", `[sdk] ${data}`),
         canUseTool: async (toolName, input2) => {
           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`) {
@@ -73038,15 +73036,15 @@ async function runMiner(options) {
           };
         }
         if (message.subtype !== "success" || message.is_error) {
-          logger.debug("miner", `run ${runID} failed: ${text}`);
+          logger.debug("learner", `run ${runID} failed: ${text}`);
           return {
             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`);
+        logger.debug("learner", `run ${runID} completed: ${turns} turns, ${notesWritten} suggested pages`);
         return { outcome: "completed", notesWritten, turns, message: text };
       }
     }
@@ -73054,7 +73052,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);
@@ -73062,12 +73060,12 @@ async function runMiner(options) {
     if (gatewayError) {
       return { outcome: gatewayError.outcome, notesWritten, turns, message: gatewayError.message };
     }
-    logger.debug("miner", `run ${runID} threw: ${text}`);
+    logger.debug("learner", `run ${runID} threw: ${text}`);
     return {
       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);
@@ -73537,7 +73535,7 @@ var init_settings = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "acac034b-488b-746c-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "a3c20325-c0f7-811f-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
@@ -75413,6 +75411,140 @@ var init_errors3 = __esm(() => {
 // src/mcp/constants.ts
 var MCP_PROVIDER_SLUG2 = "dosu_mcp";
 
+// src/sessions/session-title.ts
+import { existsSync as existsSync25, mkdirSync as mkdirSync14, readFileSync as readFileSync24, renameSync as renameSync6, statSync as statSync9, writeFileSync as writeFileSync16 } from "node:fs";
+import { homedir as homedir10 } from "node:os";
+import { join as join40 } from "node:path";
+function cachePath2(configDir) {
+  return join40(configDir, CACHE_FILENAME5);
+}
+function loadCacheFile2(configDir) {
+  try {
+    const raw = JSON.parse(readFileSync24(cachePath2(configDir), "utf-8"));
+    if (raw.schema_version !== CACHE_SCHEMA_VERSION2 || typeof raw.entries !== "object")
+      return {};
+    return raw.entries;
+  } catch {
+    return {};
+  }
+}
+function saveCacheFile2(configDir, entries) {
+  try {
+    if (!existsSync25(configDir))
+      mkdirSync14(configDir, { recursive: true, mode: 448 });
+    const path3 = cachePath2(configDir);
+    const tmp = `${path3}.${process.pid}.tmp`;
+    const file2 = { schema_version: CACHE_SCHEMA_VERSION2, entries };
+    writeFileSync16(tmp, JSON.stringify(file2), { mode: 384 });
+    renameSync6(tmp, path3);
+  } catch {}
+}
+function extractUserQuery(text) {
+  const tagged = text.match(/<user_query>([\s\S]*?)<\/user_query>/);
+  if (tagged)
+    return tagged[1];
+  const named = text.match(/^\s*<[\w-]+\s[^>]*\bname="([^"]+)"/);
+  if (named)
+    return named[1];
+  return text.replace(/^(\s*<([\w-]+)(?:\s[^>]*)?>[\s\S]*?<\/\2>\s*)+/, "");
+}
+function cleanSessionName(text) {
+  const line = text.replace(/\s+/g, " ").trim();
+  if (!line)
+    return null;
+  return line.length > SESSION_NAME_MAX ? `${line.slice(0, SESSION_NAME_MAX - 1)}…` : line;
+}
+function claudeSummaryFromHead(text) {
+  for (const line of text.split(`
+`).slice(0, HEAD_LINES2)) {
+    if (!line.includes('"summary"'))
+      continue;
+    try {
+      const obj = JSON.parse(line);
+      if (obj.type === "summary" && typeof obj.summary === "string") {
+        return cleanSessionName(obj.summary);
+      }
+    } catch {}
+  }
+  return null;
+}
+function reconstructSession(harness, id2, slug, home = homedir10(), exists = existsSync25) {
+  if (!slug)
+    return null;
+  const candidates = [];
+  if (harness === "claude") {
+    candidates.push(join40(home, ".claude", "projects", slug, `${id2}.jsonl`));
+  } else if (harness === "cursor") {
+    const project = join40(home, ".cursor", "projects", slug);
+    candidates.push(join40(project, "agent-transcripts", id2, `${id2}.jsonl`), join40(project, "agent-transcripts", `${id2}.jsonl`));
+  } else {
+    return null;
+  }
+  for (const path3 of candidates) {
+    if (exists(path3))
+      return { id: id2, harness, path: path3, project: slug, updated: "" };
+  }
+  return null;
+}
+function readHead2(path3) {
+  try {
+    return readFileSync24(path3, "utf-8").slice(0, 128 * 1024);
+  } catch {
+    return null;
+  }
+}
+function fileMtime2(path3) {
+  try {
+    return statSync9(path3).mtime.toISOString();
+  } catch {
+    return "";
+  }
+}
+function createSessionTitleResolver(configDir = getConfigDir(), deps = {}) {
+  const head = deps.readHead ?? readHead2;
+  const turns = deps.readTurns ?? readSessionTurns;
+  const mtime = deps.mtime ?? fileMtime2;
+  const entries = loadCacheFile2(configDir);
+  let dirty = false;
+  const compute = (session) => {
+    if (session.harness === "claude") {
+      const text = head(session.path);
+      const summary = text ? claudeSummaryFromHead(text) : null;
+      if (summary)
+        return summary;
+    }
+    const firstUser = turns(session).find((t9) => t9.role === "user");
+    return firstUser ? cleanSessionName(extractUserQuery(firstUser.text)) : null;
+  };
+  return {
+    cached(key) {
+      return entries[key]?.title ?? null;
+    },
+    resolve(session) {
+      const key = `${session.harness}/${session.id}`;
+      const cached2 = entries[key];
+      if (cached2 && (cached2.title !== null || cached2.mtime === mtime(session.path))) {
+        return cached2.title;
+      }
+      const title = compute(session);
+      entries[key] = { title, mtime: mtime(session.path) };
+      dirty = true;
+      return title;
+    },
+    flush() {
+      if (!dirty)
+        return;
+      saveCacheFile2(configDir, entries);
+      dirty = false;
+    }
+  };
+}
+var CACHE_FILENAME5 = "session-titles.json", CACHE_SCHEMA_VERSION2 = 3, HEAD_LINES2 = 50, SESSION_NAME_MAX = 80;
+var init_session_title = __esm(() => {
+  init_config();
+  init_read();
+});
+
 // src/tui/alt-screen.ts
 function enterAltScreen(output2) {
   depth += 1;
@@ -75436,7 +75568,8 @@ var init_alt_screen = __esm(() => {
 });
 
 // src/tui/activity-view.ts
-import { readFileSync as readFileSync24 } from "node:fs";
+import { existsSync as existsSync26, readFileSync as readFileSync25 } from "node:fs";
+import { basename as basename5 } from "node:path";
 function reduceActivityViewKey(key) {
   if (key === "q" || key === ESC7 || key === CTRL_C4)
     return "back";
@@ -75452,6 +75585,8 @@ function reduceActivityViewKey(key) {
     return "sync";
   if (key === "f")
     return "full";
+  if (key === "c")
+    return "clear";
   return "none";
 }
 function cycleTab(tab, delta = 1) {
@@ -75482,13 +75617,13 @@ function formatActivityLine(line, width, full = false) {
 }
 function appendSyncActivity(buffer, chunk, max = ACTIVITY_VIEW_BUFFER_LINES) {
   const fresh = chunk.split(`
-`).filter((line) => line.includes("[sync]") || line.includes("[miner]")).map((line) => line.replace(/ \[(DEBUG|INFO|WARN|ERROR)\]/, ""));
+`).filter((line) => line.includes("[sync]") || line.includes("[learner]")).map((line) => line.replace(/ \[(DEBUG|INFO|WARN|ERROR)\]/, ""));
   return [...buffer, ...fresh].slice(-max);
 }
 function clip(text, max) {
   return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
 }
-function formatMinedRow(record2, full = false) {
+function formatStudiedRow(record2, full = false, name) {
   const match = record2.at.match(/^\d{4}-(\d{2}-\d{2})T(\d{2}:\d{2})/);
   const stamp = match ? `${match[1]} ${match[2]}` : record2.at;
   const slash = record2.session.indexOf("/");
@@ -75496,13 +75631,15 @@ function formatMinedRow(record2, full = false) {
   const id2 = slash > 0 ? record2.session.slice(slash + 1) : record2.session;
   const rawProject = record2.project ?? "-";
   const project = full ? rawProject : clip(rawProject, 28);
-  return `${harness.padEnd(8)}  ${stamp}  ${project}  ${full ? id2 : clip(id2, 24)}`;
+  const label = full ? name ? `${name} · ${id2}` : id2 : clip(name ?? id2, 44);
+  return `${harness.padEnd(8)}  ${stamp}  ${project}  ${label}`;
 }
-function formatQueuedRow(session, full = false) {
+function formatQueuedRow(session, full = false, name) {
   const stamp = session.updated.replace("T", " ").slice(5, 16);
   const rawProject = session.project ?? "-";
   const project = full ? rawProject : clip(rawProject, 28);
-  return `${session.harness.padEnd(8)}  ${stamp}  ${project}  ${full ? session.id : clip(session.id, 24)}`;
+  const label = full ? name ? `${name} · ${session.id}` : session.id : clip(name ?? session.id, 44);
+  return `${session.harness.padEnd(8)}  ${stamp}  ${project}  ${label}`;
 }
 function wrapRow(text, width, indent = "    ") {
   if (text.length <= width)
@@ -75542,23 +75679,23 @@ 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;
     }
     if (!current)
       continue;
-    const read = line.match(/\[miner\] \[agent\] → mcp__sessions__read_session .*?"id":"([^"]+)"/);
+    const read = line.match(/\[learner\] \[agent\] → mcp__sessions__read_session .*?"id":"([^"]+)"/);
     if (read) {
       current.read.add(read[1]);
       continue;
     }
-    if (line.includes("[miner] [agent] → mcp__dosu__write_knowledge")) {
+    if (line.includes("[learner] [agent] → mcp__dosu__write_knowledge")) {
       current.notes += 1;
     }
   }
@@ -75572,15 +75709,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;
@@ -75592,12 +75729,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) {
+function tabBar(tab, queuedCount, openCount, studiedCount, width) {
   return tabStrip([
     ["activity", "Activity"],
-    ["mined", `Mined (${minedCount})`],
+    ["studied", `Studied (${studiedCount})`],
     ["queued", `Queued (${queuedCount})`],
     ["open", `Open (${openCount})`]
   ], tab, width);
@@ -75621,10 +75758,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)),
@@ -75640,28 +75778,41 @@ function confirmBox(queuedCount, backlog, width, mode = "start") {
     import_picocolors30.default.dim(`╰${"─".repeat(inner + 2)}╯`)
   ];
 }
-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";
+function renderActivityFrame(status, activity, width, backlog = null, pane = DEFAULT_PANE, queued = [], studiedBeforeRun = 0, open5 = [], runProgress = null, projectNames = {}, sessionNames = {}) {
+  const studied = 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`);
   }
   let progress = null;
   if (status.running && backlog) {
-    const minedDelta = Math.max(0, (status.state.total_mined ?? 0) - minedBeforeRun);
+    const studiedDelta = Math.max(0, (status.state.total_mined ?? 0) - studiedBeforeRun);
     const stepDone = runProgress ? Math.min(Math.max(0, runProgress.read.size - 1), runProgress.batch - 1, backlog.ready) : 0;
-    progress = progressLine(minedDelta + stepDone, Math.max(0, backlog.ready - stepDone), width, runProgress?.notes ?? 0);
+    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(`! 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 withName = (item, key) => projectNames[key] ? { ...item, project: projectNames[key] } : item;
+  const latestPass = new Map;
+  for (const r9 of status.state.mined_sessions ?? [])
+    latestPass.set(r9.session, r9);
+  const studiedRows = [...latestPass.values()].map((r9) => {
+    const record2 = withName(r9, r9.session);
+    const name = sessionNames[r9.session];
+    return fullRows ? formatStudiedRow(record2, true, name) : formatActivityLine(formatStudiedRow(record2, false, name), width);
+  });
+  const sessionRow = (session) => {
+    const key = `${session.harness}/${session.id}`;
+    const s = withName(session, key);
+    const name = sessionNames[key];
+    return fullRows ? formatQueuedRow(s, true, name) : formatActivityLine(formatQueuedRow(s, false, name), 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 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 source = pane.tab === "activity" ? activity.map((line) => formatActivityLine(line, width, fullRows)) : pane.tab === "queued" ? queuedRows : pane.tab === "open" ? openRows : studiedRows;
+  const emptyStudied = 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." : emptyStudied;
   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;
@@ -75675,31 +75826,95 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     breadcrumb(["Home", "Activity"], width),
     "",
     statusLine(status),
-    import_picocolors30.default.dim(mined),
+    import_picocolors30.default.dim(studied),
     ...queueDetail.length > 0 ? wrapLine(queueDetail.join(" · "), width).map((line) => import_picocolors30.default.dim(line)) : [],
     ...progress ? [progress] : [],
     ...refusalLines,
     "",
-    ...tabBar(pane.tab, queued.length, open5.length, status.state.total_mined ?? minedRows.length, width),
+    ...tabBar(pane.tab, queued.length, open5.length, latestPass.size, width),
     ...listRows,
     ...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(`
 `);
 }
+function createRowNamer() {
+  const dirs = createProjectDirResolver();
+  const titles = createSessionTitleResolver();
+  const bySlug = new Map;
+  const fromSlug = (slug) => {
+    if (!bySlug.has(slug))
+      bySlug.set(slug, unmungeSlug(slug));
+    return bySlug.get(slug) ?? null;
+  };
+  return (status, backlog) => {
+    const names = { projects: {}, titles: {} };
+    let budget = TITLE_READS_PER_DRAW;
+    let resolved = false;
+    const title = (key, session) => {
+      const hit = titles.cached(key);
+      if (hit) {
+        names.titles[key] = hit;
+        return;
+      }
+      if (budget <= 0)
+        return;
+      budget--;
+      const t9 = titles.resolve(session);
+      resolved = true;
+      if (t9)
+        names.titles[key] = t9;
+    };
+    for (const s of [...backlog.queued, ...backlog.open]) {
+      if (!existsSync26(s.path))
+        continue;
+      const key = `${s.harness}/${s.id}`;
+      const dir = dirs.resolve(s);
+      if (dir)
+        names.projects[key] = basename5(dir);
+      title(key, s);
+      resolved = true;
+    }
+    for (const r9 of [...status.state.mined_sessions ?? []].reverse()) {
+      const key = r9.session;
+      if (!names.projects[key]) {
+        const dir = dirs.cached(key) ?? (r9.project ? fromSlug(r9.project) : null);
+        if (dir)
+          names.projects[key] = basename5(dir);
+      }
+      if (!names.titles[key]) {
+        const hit = titles.cached(key);
+        if (hit) {
+          names.titles[key] = hit;
+        } else if (budget > 0) {
+          const slash = key.indexOf("/");
+          const session = reconstructSession(key.slice(0, slash), key.slice(slash + 1), r9.project);
+          if (session)
+            title(key, session);
+        }
+      }
+    }
+    if (resolved) {
+      dirs.flush();
+      titles.flush();
+    }
+    return names;
+  };
+}
 function defaultReadLog2() {
   try {
-    return readFileSync24(logger.getLogPath(), "utf-8");
+    return readFileSync25(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -75715,7 +75930,9 @@ 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 rowNamesFor = io2.rowNames ?? createRowNamer();
   const pollMs = io2.pollMs ?? ACTIVITY_VIEW_POLL_MS;
   const seed = readLog();
   let activity = appendSyncActivity([], seed);
@@ -75744,29 +75961,30 @@ function runActivityView(io2 = {}) {
   };
   const listHeight = () => fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
   let lastFrame = null;
-  let minedBeforeRun = null;
+  let studiedBeforeRun = null;
   const draw = () => {
     status = getStatus();
     if (status.running) {
       const run2 = status.state.run;
       if (run2 && run2.pid === status.pid) {
-        minedBeforeRun = run2.baseline_mined;
+        studiedBeforeRun = run2.baseline_mined;
       } else {
-        minedBeforeRun ??= status.state.total_mined ?? 0;
+        studiedBeforeRun ??= status.state.total_mined ?? 0;
       }
     } else {
-      minedBeforeRun = null;
+      studiedBeforeRun = null;
     }
     if (status.state.watermark !== queuedWatermark) {
       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;
     const width = activityWidth(output2.columns ?? 80);
-    const frame = renderActivityFrame(status, activity, width, backlog, { tab, scroll, confirm: confirmSync ?? undefined, fullRows }, sessions.queued, minedBeforeRun ?? 0, sessions.open, runProgress);
+    const rowNames = rowNamesFor(status, sessions);
+    const frame = renderActivityFrame(status, activity, width, backlog, { tab, scroll, confirm: confirmSync ?? undefined, fullRows }, sessions.queued, studiedBeforeRun ?? 0, sessions.open, runProgress, rowNames.projects, rowNames.titles);
     if (frame === lastFrame)
       return;
     lastFrame = frame;
@@ -75813,11 +76031,15 @@ ${CLEAR_BELOW}`);
             const mode = confirmSync;
             confirmSync = null;
             let note;
-            if (mode === "stop") {
+            if (mode === "clear") {
+              clearHistory();
+              studiedBeforeRun = 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);
@@ -75841,6 +76063,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;
@@ -75868,10 +76095,12 @@ ${CLEAR_BELOW}`);
     input2.on("data", onData);
   });
 }
-var import_picocolors30, 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;
+var import_picocolors30, 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();
+  init_project_dir();
+  init_session_title();
   init_styles();
   init_backlog();
   init_detach();
@@ -75893,7 +76122,7 @@ var init_activity_view = __esm(() => {
   CURSOR_HOME = `${ESC7}[H`;
   CLEAR_BELOW = `${ESC7}[0J`;
   CLEAR_EOL = `${ESC7}[K`;
-  ACTIVITY_VIEW_TABS = ["activity", "mined", "queued", "open"];
+  ACTIVITY_VIEW_TABS = ["activity", "studied", "queued", "open"];
   DEFAULT_PANE = { tab: "activity", scroll: 0 };
 });
 
@@ -76726,23 +76955,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",
@@ -77567,12 +77804,15 @@ function loadPageStatsFromConfig() {
   }
 }
 function overviewRows(state) {
-  const minedTotal = state.total_mined ?? 0;
+  const studiedTotal = state.total_mined ?? 0;
   const notes = state.total_notes ?? 0;
   const tokens = state.total_learning_tokens ?? 0;
-  if (minedTotal === 0 && notes === 0)
+  if (studiedTotal === 0 && notes === 0)
     return [];
-  const rows = [`${label("Sessions mined")}${minedTotal}`, `${label("Suggested pages")}${notes}`];
+  const rows = [
+    `${label("Sessions studied")}${studiedTotal}`,
+    `${label("Suggested pages")}${notes}`
+  ];
   if (tokens > 0) {
     rows.push(`${label("Investigation distilled")}${formatTokenCount(tokens)} tokens`);
   }
@@ -77621,7 +77861,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)
@@ -77797,10 +78037,10 @@ function checklistRows(ctx) {
     rows.push(["agents", `${on2} ${ctx.agents.join(` ${DOT3} `)}`]);
   if (missing.has("hooks"))
     rows.push(["hooks", warnRow]);
-  if (ctx.mining) {
+  if (ctx.studying) {
     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) {
@@ -78190,8 +78430,8 @@ __export(exports_tui, {
   runTUI: () => runTUI,
   handleLogout: () => handleLogout
 });
-import { homedir as homedir10 } from "node:os";
-import { basename as basename4 } from "node:path";
+import { homedir as homedir11 } from "node:os";
+import { basename as basename6 } from "node:path";
 async function probeSession(cfg) {
   if (!isAuthenticated(cfg) || !isTokenExpired(cfg))
     return { expired: false };
@@ -78218,7 +78458,7 @@ function bannerContext(cfg, session) {
   return {
     version: getVersionString(),
     webAppHost,
-    directory: basename4(process.cwd()),
+    directory: basename6(process.cwd()),
     signedIn: isAuthenticated(cfg),
     sessionExpired: session.expired,
     deploymentName: cfg.active_account?.target?.deployment_name,
@@ -78226,7 +78466,7 @@ function bannerContext(cfg, session) {
     setupMissing: isAuthenticated(cfg) && !session.expired ? missingSetupSteps(cfg) : [],
     ...inGitWorkTree() ? { repoAgentsMd: dosuAgentsSectionState() } : {},
     agents,
-    mining: isMining(),
+    studying: isStudying(),
     ...latest ? { update: { version: latest, hint: buildUpdateHint(INSTALL_CHANNEL, isNpxInvocation()) } } : {}
   };
 }
@@ -78293,7 +78533,7 @@ function setupHint(cfg) {
   const started = Boolean(cfg.active_account?.target);
   return import_picocolors35.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
 }
-function isMining() {
+function isStudying() {
   try {
     return getSyncStatus({ readLog: () => "" }).running;
   } catch {
@@ -78341,10 +78581,10 @@ async function runMainMenu() {
         { label: "Exit", value: "exit" }
       ];
     }
-    const mining = isMining();
+    const studying = isStudying();
     return [
       {
-        label: mining ? `Activity ⛏️ ${brand("mining sessions...")}` : "Activity",
+        label: studying ? `Activity \uD83D\uDCDA ${brand("studying sessions...")}` : "Activity",
         value: "sync"
       },
       { label: "Knowledge report", hint: "(opens in browser)", value: "report" },
@@ -78420,11 +78660,11 @@ async function runSettings(cfg) {
     const target = cfg.active_account?.target;
     const library = target?.library_name ?? target?.deployment_name ?? "not configured";
     const filter = loadSyncState().project_filter;
-    const scope = !filter?.length ? "all projects" : filter.length <= 2 ? filter.map((dir) => dir === UNKNOWN_PROJECT ? "unknown" : basename4(dir)).join(", ") : `${filter.length} projects`;
+    const scope = !filter?.length ? "all projects" : filter.length <= 2 ? filter.map((dir) => dir === UNKNOWN_PROJECT ? "unknown" : basename6(dir)).join(", ") : `${filter.length} projects`;
     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" }
@@ -78432,7 +78672,7 @@ async function runSettings(cfg) {
     if (action === null || action === "back")
       return;
     if (action === "projects") {
-      await runMiningProjectsSetting();
+      await runStudyingProjectsSetting();
       continue;
     }
     if (action === "setup") {
@@ -78455,7 +78695,7 @@ async function runSettings(cfg) {
   }
 }
 function displayDir(dir) {
-  const home = homedir10();
+  const home = homedir11();
   return dir === home ? "~" : dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir;
 }
 function discoverProjectDirs() {
@@ -78470,7 +78710,7 @@ function discoverProjectDirs() {
   } catch {}
   return [...counts.entries()].sort((a9, b2) => b2[1] - a9[1]).map(([dir]) => dir);
 }
-async function runMiningProjectsSetting() {
+async function runStudyingProjectsSetting() {
   const dirs = discoverProjectDirs();
   if (dirs.length === 0) {
     log2.info("No local agent sessions found yet; nothing to scope.");
@@ -78478,7 +78718,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
@@ -78493,7 +78733,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?" });
@@ -79197,7 +79437,7 @@ import {
   constants as constants3,
   fstatSync,
   openSync as openSync5,
-  readFileSync as readFileSync25,
+  readFileSync as readFileSync26,
   readSync as readSync4,
   unlinkSync as unlinkSync5
 } from "node:fs";
@@ -82399,23 +82639,23 @@ ${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) => {
-    const all = !opts.queued && !opts.open && !opts.mined;
+  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("--studied", "Only recent studied-session history").option("--json", "Output as JSON").action((opts) => {
+    const all = !opts.queued && !opts.open && !opts.studied;
     const wantQueued = all || Boolean(opts.queued);
     const wantOpen = all || Boolean(opts.open);
-    const wantMined = all || Boolean(opts.mined);
+    const wantStudied = all || Boolean(opts.studied);
     const backlog = wantQueued || wantOpen ? listSessionBacklog() : { queued: [], open: [] };
-    const mined = wantMined ? loadSyncState().mined_sessions ?? [] : [];
+    const studied = wantStudied ? loadSyncState().mined_sessions ?? [] : [];
     if (opts.json) {
       printResult({
         ...wantQueued ? { queued: backlog.queued } : {},
         ...wantOpen ? { open: backlog.open } : {},
-        ...wantMined ? { mined } : {}
+        ...wantStudied ? { studied } : {}
       }, opts);
       return;
     }
     const sessionRows = (sessions) => sessions.map((s) => [s.harness, s.updated, s.project ?? "-", s.id]);
-    const minedRows = mined.map((record2) => {
+    const studiedRows = studied.map((record2) => {
       const slash = record2.session.indexOf("/");
       const harness = slash > 0 ? record2.session.slice(0, slash) : "-";
       const id2 = slash > 0 ? record2.session.slice(slash + 1) : record2.session;
@@ -82439,11 +82679,11 @@ ${results.length - opts.limit} more results not shown.`));
     if (wantOpen) {
       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.");
+    if (wantStudied) {
+      section("Studied", studiedRows, "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) {
@@ -82464,7 +82704,7 @@ ${results.length - opts.limit} more results not shown.`));
       ]);
       return;
     }
-    const deps = { mine: buildMiner(opts.quiet ? "hook" : "manual") };
+    const deps = { mine: buildLearner(opts.quiet ? "hook" : "manual") };
     let outcome = await runKnowledgeSync({
       quiet: opts.quiet,
       bootstrap: opts.bootstrap,
@@ -82472,7 +82712,7 @@ ${results.length - opts.limit} more results not shown.`));
     });
     if (opts.bootstrap && deps.mine) {
       const maxRounds = Math.ceil(outcome.readySessions / MINE_BATCH_LIMIT) + 2;
-      for (let round = 1;outcome.status === "mined" && round < maxRounds; round++) {
+      for (let round = 1;outcome.status === "studied" && round < maxRounds; round++) {
         if (!opts.quiet && !opts.json)
           printSyncOutcome(outcome);
         outcome = await runKnowledgeSync({ quiet: opts.quiet, bootstrap: true, deps });
@@ -82529,12 +82769,12 @@ ${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;
 }
-function buildMiner(trigger) {
+function buildLearner(trigger) {
   const cfg = loadConfig();
   if (cfg.mode === "oss")
     return;
@@ -82543,8 +82783,8 @@ function buildMiner(trigger) {
     return;
   const { api_key, deployment_id } = target;
   return async (sessions) => {
-    const { runMiner: runMiner2 } = await Promise.resolve().then(() => (init_runner(), exports_runner));
-    return runMiner2({ sessions, apiKey: api_key, deploymentID: deployment_id, trigger });
+    const { runLearner: runLearner2 } = await Promise.resolve().then(() => (init_runner(), exports_runner));
+    return runLearner2({ sessions, apiKey: api_key, deploymentID: deployment_id, trigger });
   };
 }
 function formatAge(iso, now) {
@@ -82570,14 +82810,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;
@@ -82592,7 +82832,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(`
@@ -82608,25 +82848,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.`);
+    case "studied": {
+      const notes = outcome.learner?.notesWritten ?? 0;
+      const remaining = outcome.readySessions - (outcome.studiedSessions ?? 0);
+      console.log(`✓ Studied ${outcome.studiedSessions} session${outcome.studiedSessions === 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.learner?.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.learner?.message ?? "Study run failed."));
       process.exitCode = 1;
       break;
     }
@@ -82649,7 +82889,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;
     }
   }
@@ -84567,7 +84807,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     }
     if (opts.follow) {
       try {
-        const lines = readFileSync25(logPath, "utf-8").split(`
+        const lines = readFileSync26(logPath, "utf-8").split(`
 `);
         if (lines.at(-1) === "")
           lines.pop();
@@ -84583,7 +84823,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     if (opts.tail !== undefined) {
       const n5 = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
       try {
-        const content = readFileSync25(logPath, "utf-8");
+        const content = readFileSync26(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n5).join(`
@@ -84654,4 +84894,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=acac034b-488b-746c-6475-6e2164756e21
+//# debugId=a3c20325-c0f7-811f-6475-6e2164756e21