@dosu/cli 0.53.0-beta.13 → 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.13", 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 } : {},
@@ -8607,12 +8755,12 @@ function resetSyncState(configDir = getConfigDir()) {
   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)
@@ -8656,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;
@@ -8672,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 = `
@@ -8860,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();
@@ -9265,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 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);
@@ -9309,26 +9437,18 @@ 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 Dosu studies your sessions and extracts learnings.</p>';
   const lede = notesLede ? `<p class="lede">${esc(notesLede)}</p>` : "";
   return `<!DOCTYPE html>
@@ -9348,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>
@@ -9396,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"]);
@@ -9406,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;
 }
@@ -9522,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);
     }
@@ -9554,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))
@@ -9565,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))
@@ -9585,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;
@@ -9599,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"]);
@@ -9656,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");
@@ -9671,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) {
@@ -9887,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: []
         }));
@@ -9921,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();
@@ -10112,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) {
@@ -10137,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);
@@ -10156,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)
   });
@@ -10174,6 +10306,7 @@ async function emitKnowledgeReport(options = {}) {
 }
 var init_generate = __esm(() => {
   init_config();
+  init_project_dir();
   init_scan();
   init_watermark();
   init_html();
@@ -10181,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 {
@@ -10470,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();
@@ -10591,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;
@@ -10615,26 +10603,26 @@ async function runKnowledgeSync(options = {}) {
       return {
         status: "nothing-new",
         ...base,
-        minedSessions: 0,
+        studiedSessions: 0,
         trivialSessions: trivial
       };
     }
     logger.debug("sync", `studying ${batch.length} of ${ready.length} ready sessions (${trivial} trivial skipped)`);
-    const miner = await deps.mine(batch);
-    switch (miner.outcome) {
+    const learner = await deps.mine(batch);
+    switch (learner.outcome) {
       case "completed": {
         for (const s of batch) {
           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;
@@ -10643,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", `studied ${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":
@@ -10670,12 +10658,12 @@ async function runKnowledgeSync(options = {}) {
           consecutive_failures: 0,
           last_refusal: {
             at,
-            outcome: miner.outcome,
-            message: miner.message ?? "Studying unavailable right now."
+            outcome: learner.outcome,
+            message: learner.message ?? "Studying unavailable right now."
           }
         });
-        logger.debug("sync", `studying 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({
@@ -10683,13 +10671,13 @@ async function runKnowledgeSync(options = {}) {
           last_attempt_at: now().toISOString(),
           consecutive_failures: state.consecutive_failures + 1
         });
-        logger.debug("sync", `studying 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
         };
       }
     }
@@ -10835,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,
@@ -10851,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) {
@@ -10909,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)) {
@@ -10943,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";
@@ -10990,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.
@@ -11000,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:
@@ -11010,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
@@ -11039,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 = {};
@@ -72793,7 +72780,7 @@ var init_redact = __esm(() => {
   ]);
 });
 
-// src/miner/tools.ts
+// src/learner/tools.ts
 function textResult(text) {
   return { content: [{ type: "text", text }] };
 }
@@ -72852,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")
@@ -72878,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) {
@@ -72904,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)}`);
     }
   }
 }
@@ -72922,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("; ");
@@ -72945,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();
@@ -72958,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,
@@ -72969,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,
@@ -72987,12 +72974,12 @@ 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 {
@@ -73049,7 +73036,7 @@ 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,
@@ -73057,7 +73044,7 @@ async function runMiner(options) {
             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 };
       }
     }
@@ -73073,7 +73060,7 @@ 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,
@@ -73548,7 +73535,7 @@ var init_settings = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "6b750395-441b-6515-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "a3c20325-c0f7-811f-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
@@ -75424,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;
@@ -75447,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";
@@ -75495,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("/");
@@ -75509,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)
@@ -75566,12 +75690,12 @@ function foldRunProgress(progress, chunk) {
     }
     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;
     }
   }
@@ -75607,10 +75731,10 @@ function progressLine(done, ready, width, notes = 0) {
   const suffix = notes > 0 ? ` · ${notes} suggested page${notes === 1 ? "" : "s"}` : "";
   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", `Studied (${minedCount})`],
+    ["studied", `Studied (${studiedCount})`],
     ["queued", `Queued (${queuedCount})`],
     ["open", `Open (${openCount})`]
   ], tab, width);
@@ -75654,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 ? `Studied sessions up to ${localTime(status.state.watermark)}` : "Nothing studied 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(`! 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 study run." : "No studied sessions yet.";
-  const empty = pane.tab === "activity" ? "No sync activity in the log yet." : pane.tab === "queued" ? "Queue empty. Finished agent sessions appear here." : pane.tab === "open" ? "No open sessions. Live agent sessions sit here until they go quiet." : emptyMined;
+  const 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;
@@ -75689,12 +75826,12 @@ 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))] : [],
     "",
@@ -75712,9 +75849,72 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
   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 "";
   }
@@ -75732,6 +75932,7 @@ function runActivityView(io2 = {}) {
   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);
@@ -75760,18 +75961,18 @@ 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;
@@ -75782,7 +75983,8 @@ function runActivityView(io2 = {}) {
     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;
@@ -75831,7 +76033,7 @@ ${CLEAR_BELOW}`);
             let note;
             if (mode === "clear") {
               clearHistory();
-              minedBeforeRun = null;
+              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);
@@ -75893,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();
@@ -75918,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 };
 });
 
@@ -77600,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 studied")}${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`);
   }
@@ -77830,7 +78037,7 @@ 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",
       `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors33.default.dim(`${DOT3} see Activity`)}`
@@ -78223,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 };
@@ -78251,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,
@@ -78259,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()) } } : {}
   };
 }
@@ -78326,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 {
@@ -78374,10 +78581,10 @@ async function runMainMenu() {
         { label: "Exit", value: "exit" }
       ];
     }
-    const mining = isMining();
+    const studying = isStudying();
     return [
       {
-        label: mining ? `Activity \uD83D\uDCDA ${brand("studying sessions...")}` : "Activity",
+        label: studying ? `Activity \uD83D\uDCDA ${brand("studying sessions...")}` : "Activity",
         value: "sync"
       },
       { label: "Knowledge report", hint: "(opens in browser)", value: "report" },
@@ -78453,7 +78660,7 @@ 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" },
@@ -78465,7 +78672,7 @@ async function runSettings(cfg) {
     if (action === null || action === "back")
       return;
     if (action === "projects") {
-      await runMiningProjectsSetting();
+      await runStudyingProjectsSetting();
       continue;
     }
     if (action === "setup") {
@@ -78488,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() {
@@ -78503,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.");
@@ -79230,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";
@@ -82432,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 studying").option("--open", "Only live sessions still inside the quiet period").option("--mined", "Only recent studied-session history").option("--json", "Output as JSON").action((opts) => {
-    const all = !opts.queued && !opts.open && !opts.mined;
+  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;
@@ -82472,8 +82679,8 @@ ${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("Studied", minedRows, "Studied at", "No studied 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 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) => {
@@ -82497,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,
@@ -82505,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 });
@@ -82567,7 +82774,7 @@ ${results.length - opts.limit} more results not shown.`));
   cmd.addCommand(hooksCommand());
   return cmd;
 }
-function buildMiner(trigger) {
+function buildLearner(trigger) {
   const cfg = loadConfig();
   if (cfg.mode === "oss")
     return;
@@ -82576,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) {
@@ -82645,21 +82852,21 @@ function printSyncOutcome(outcome) {
       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(`✓ Studied ${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 ?? "Studying 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 ?? "Study run failed."));
+      console.error(import_picocolors18.default.red(outcome.learner?.message ?? "Study run failed."));
       process.exitCode = 1;
       break;
     }
@@ -84600,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();
@@ -84616,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(`
@@ -84687,4 +84894,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=6b750395-441b-6515-6475-6e2164756e21
+//# debugId=a3c20325-c0f7-811f-6475-6e2164756e21