@dosu/cli 0.53.0-beta.9 → 0.53.1

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.9", INSTALL_CHANNEL = "npm";
+var VERSION = "0.53.1", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -5712,12 +5712,34 @@ function answeredEcho(message, answer) {
 function optionLabel(option) {
   return option.label ?? String(option.value);
 }
+function viewport(count, cursor3, top, rows, chrome) {
+  const visible = Math.min(count, Math.max(4, (rows ?? 24) - chrome));
+  let next = top;
+  if (cursor3 < next)
+    next = cursor3;
+  if (cursor3 >= next + visible)
+    next = cursor3 - visible + 1;
+  next = Math.max(0, Math.min(next, count - visible));
+  return { top: next, visible, above: next, below: count - next - visible };
+}
+function moreAbove(n2) {
+  return n2 > 0 ? [import_picocolors11.default.dim(`  ↑ ${n2} more`)] : [];
+}
+function moreBelow(n2) {
+  return n2 > 0 ? [import_picocolors11.default.dim(`  ↓ ${n2} more`)] : [];
+}
 function select(opts, io = {}) {
+  const { output } = resolveIO(io);
   let selected = 0;
+  let top = 0;
   const labelWidth = Math.max(...opts.options.map((o2) => optionLabel(o2).length));
   return runInteractive({
     render() {
-      const rows = opts.options.map((option, index) => {
+      const count = opts.options.length;
+      const view = viewport(count, selected, top, output.rows, 8);
+      top = view.top;
+      const rows = opts.options.slice(top, top + view.visible).map((option, offset) => {
+        const index = top + offset;
         const label = optionLabel(option).padEnd(labelWidth);
         const hint = option.hint ? `   ${import_picocolors11.default.dim(option.hint)}` : "";
         return index === selected ? `${brand(POINTER2)} ${import_picocolors11.default.bold(brand(label))}${hint}` : `  ${import_picocolors11.default.dim(label)}${hint}`;
@@ -5725,7 +5747,9 @@ function select(opts, io = {}) {
       return [
         import_picocolors11.default.bold(opts.message),
         "",
+        ...moreAbove(view.above),
         ...rows,
+        ...moreBelow(view.below),
         "",
         import_picocolors11.default.dim(`↑↓ move ${DOT} enter select ${DOT} esc cancel`)
       ];
@@ -5763,13 +5787,9 @@ function multiselect2(opts, io = {}) {
   return runInteractive({
     render() {
       const count = opts.options.length;
-      const visible = Math.min(count, Math.max(4, (output.rows ?? 24) - 9));
-      if (cursor3 < top)
-        top = cursor3;
-      if (cursor3 >= top + visible)
-        top = cursor3 - visible + 1;
-      top = Math.max(0, Math.min(top, count - visible));
-      const rows = opts.options.slice(top, top + visible).map((option, offset) => {
+      const view = viewport(count, cursor3, top, output.rows, 9);
+      top = view.top;
+      const rows = opts.options.slice(top, top + view.visible).map((option, offset) => {
         const index = top + offset;
         const isPicked = picked.has(option.value);
         const box = isPicked ? brand(BOX_ON) : import_picocolors11.default.dim(BOX_OFF);
@@ -5778,15 +5798,13 @@ function multiselect2(opts, io = {}) {
         const suffix = status ? `   ${status}` : "";
         return index === cursor3 ? `${brand(POINTER2)} ${box} ${import_picocolors11.default.bold(brand(label))}${suffix}` : `  ${box} ${import_picocolors11.default.dim(label)}${suffix}`;
       });
-      const above = top;
-      const below = count - top - visible;
       const summary = opts.summary?.(pickedValues());
       return [
         import_picocolors11.default.bold(opts.message),
         "",
-        ...above > 0 ? [import_picocolors11.default.dim(`  ↑ ${above} more`)] : [],
+        ...moreAbove(view.above),
         ...rows,
-        ...below > 0 ? [import_picocolors11.default.dim(`  ↓ ${below} more`)] : [],
+        ...moreBelow(view.below),
         "",
         ...error ? [import_picocolors11.default.yellow(error)] : summary ? [import_picocolors11.default.dim(summary)] : [],
         import_picocolors11.default.dim(`↑↓ move ${DOT} space toggle ${DOT} a all ${DOT} enter confirm ${DOT} esc cancel`)
@@ -7982,6 +8000,14 @@ function mcpURL(deploymentID) {
 function mcpBaseURL() {
   return `${getBackendURL()}/v1/mcp`;
 }
+function mcpEndpoint(cfg) {
+  if (cfg.mode === MODE_OSS)
+    return mcpBaseURL();
+  const deploymentID = cfg.active_account?.target?.deployment_id;
+  if (!deploymentID)
+    throw new Error("deployment ID is required");
+  return mcpURL(deploymentID);
+}
 function mcpHeaders(apiKey) {
   if (!apiKey) {
     throw new Error("API key is required. Run 'dosu setup' to create one.");
@@ -8008,18 +8034,23 @@ function mcpRemoteServer(url, apiKey) {
   };
 }
 function loadJSONConfig(path3) {
+  try {
+    return readJSONConfig(path3);
+  } catch {
+    return {};
+  }
+}
+function readJSONConfig(path3) {
   if (!existsSync7(path3))
     return {};
-  let data = readFileSync7(path3, "utf-8").trim();
-  if (!data)
+  const raw = readFileSync7(path3, "utf-8").trim();
+  if (!raw)
     return {};
-  if (path3.endsWith(".jsonc")) {
-    data = stripJSONComments(data);
-  }
   try {
-    return JSON.parse(data);
-  } catch {
-    return {};
+    return JSON.parse(stripTrailingCommas(stripJSONComments(raw)));
+  } catch (err) {
+    const detail = err.message;
+    throw new Error(`Could not parse ${path3} as JSON (${detail}). Fix the file and retry.`);
   }
 }
 function stripJSONComments(data) {
@@ -8027,25 +8058,7 @@ function stripJSONComments(data) {
   let i2 = 0;
   while (i2 < data.length) {
     if (data[i2] === '"') {
-      result.push(data[i2]);
-      i2++;
-      while (i2 < data.length && data[i2] !== '"') {
-        if (data[i2] === "\\") {
-          result.push(data[i2]);
-          i2++;
-          if (i2 < data.length) {
-            result.push(data[i2]);
-            i2++;
-          }
-          continue;
-        }
-        result.push(data[i2]);
-        i2++;
-      }
-      if (i2 < data.length) {
-        result.push(data[i2]);
-        i2++;
-      }
+      i2 = copyStringLiteral(data, i2, result);
       continue;
     }
     if (i2 + 1 < data.length && data[i2] === "/" && data[i2 + 1] === "/") {
@@ -8059,8 +8072,7 @@ function stripJSONComments(data) {
       i2 += 2;
       while (i2 + 1 < data.length && !(data[i2] === "*" && data[i2 + 1] === "/"))
         i2++;
-      if (i2 + 1 < data.length)
-        i2 += 2;
+      i2 = i2 + 1 < data.length ? i2 + 2 : data.length;
       continue;
     }
     result.push(data[i2]);
@@ -8068,6 +8080,43 @@ function stripJSONComments(data) {
   }
   return result.join("");
 }
+function copyStringLiteral(data, start, out) {
+  let i2 = start + 1;
+  out.push('"');
+  while (i2 < data.length && data[i2] !== '"') {
+    out.push(data[i2]);
+    if (data[i2] === "\\" && i2 + 1 < data.length)
+      out.push(data[++i2]);
+    i2++;
+  }
+  if (i2 < data.length) {
+    out.push('"');
+    i2++;
+  }
+  return i2;
+}
+function stripTrailingCommas(data) {
+  const result = [];
+  let i2 = 0;
+  while (i2 < data.length) {
+    if (data[i2] === '"') {
+      i2 = copyStringLiteral(data, i2, result);
+      continue;
+    }
+    if (data[i2] === ",") {
+      let j = i2 + 1;
+      while (j < data.length && /\s/.test(data[j]))
+        j++;
+      if (data[j] === "}" || data[j] === "]") {
+        i2++;
+        continue;
+      }
+    }
+    result.push(data[i2]);
+    i2++;
+  }
+  return result.join("");
+}
 function saveJSONConfig(path3, cfg) {
   writeSecureFile(path3, JSON.stringify(cfg, null, 2));
 }
@@ -8086,7 +8135,7 @@ function isJSONKeyConfigured(configPath, topLevelKey) {
   return "dosu" in section;
 }
 function installJSONServer(configPath, topKey, server) {
-  const jsonCfg = loadJSONConfig(configPath);
+  const jsonCfg = readJSONConfig(configPath);
   let section = jsonCfg[topKey];
   if (typeof section !== "object" || section === null) {
     section = {};
@@ -8098,18 +8147,19 @@ function installJSONServer(configPath, topKey, server) {
 function removeJSONServer(configPath, topKey) {
   let jsonCfg;
   try {
-    jsonCfg = loadJSONConfig(configPath);
+    jsonCfg = readJSONConfig(configPath);
   } catch {
     return;
   }
   const section = jsonCfg[topKey];
-  if (typeof section === "object" && section !== null) {
-    delete section.dosu;
-  }
+  if (typeof section !== "object" || section === null || !("dosu" in section))
+    return;
+  delete section.dosu;
   saveJSONConfig(configPath, jsonCfg);
 }
 var import_write_file_atomic, writeFileAtomic, MCP_REMOTE_VERSION = "0.1.38";
 var init_config_helpers = __esm(() => {
+  init_config();
   import_write_file_atomic = __toESM(require_lib(), 1);
   writeFileAtomic = import_write_file_atomic.default;
 });
@@ -8358,16 +8408,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 {
@@ -8380,7 +8578,7 @@ function sessionFromFile(filePath, harness, project) {
     return null;
   let mtime;
   try {
-    mtime = statSync3(filePath).mtime;
+    mtime = statSync4(filePath).mtime;
   } catch {
     return null;
   }
@@ -8394,7 +8592,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)) {
@@ -8409,10 +8607,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);
@@ -8424,9 +8622,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)) {
@@ -8482,9 +8680,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)
@@ -8522,10 +8720,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 = {
@@ -8534,13 +8732,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 } : {}
@@ -8554,8 +8752,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 } : {},
@@ -8577,13 +8775,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)
@@ -8627,7 +8836,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;
@@ -8643,20 +8852,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 = `
@@ -8831,38 +9054,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();
@@ -9236,11 +9427,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);
@@ -9280,27 +9469,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">
@@ -9319,9 +9500,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>
@@ -9367,7 +9547,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"]);
@@ -9377,7 +9557,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;
 }
@@ -9493,11 +9673,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);
     }
@@ -9525,7 +9705,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))
@@ -9536,7 +9716,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))
@@ -9556,9 +9736,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;
@@ -9570,7 +9750,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"]);
@@ -9627,12 +9807,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");
@@ -9642,7 +9822,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) {
@@ -9858,16 +10038,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: []
         }));
@@ -9892,7 +10072,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();
@@ -10083,17 +10263,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) {
@@ -10108,17 +10288,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);
@@ -10127,12 +10316,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)
   });
@@ -10145,6 +10338,7 @@ async function emitKnowledgeReport(options = {}) {
 }
 var init_generate = __esm(() => {
   init_config();
+  init_project_dir();
   init_scan();
   init_watermark();
   init_html();
@@ -10152,151 +10346,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 {
@@ -10441,7 +10490,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();
@@ -10490,7 +10539,7 @@ async function runKnowledgeSync(options = {}) {
   const state = loadState();
   if (options.quiet) {
     if (state.paused) {
-      logger.debug("sync", "skipping quiet sync: mining is paused");
+      logger.debug("sync", "skipping quiet sync: studying is paused");
       return { status: "skipped-paused", readySessions: 0, inFlightSessions: 0, sessions: [] };
     }
     const retryAt = backoffUntil(state);
@@ -10500,7 +10549,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;
@@ -10562,14 +10611,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;
@@ -10586,26 +10635,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;
@@ -10614,21 +10663,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":
@@ -10641,12 +10690,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({
@@ -10654,13 +10703,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
         };
       }
     }
@@ -10806,12 +10855,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,
@@ -10822,7 +10871,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) {
@@ -10880,11 +10929,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)) {
@@ -10914,7 +10963,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";
@@ -10961,9 +11010,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.
@@ -10971,7 +11020,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:
@@ -10981,8 +11030,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
@@ -11010,10 +11059,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 = {};
@@ -72764,7 +72812,7 @@ var init_redact = __esm(() => {
   ]);
 });
 
-// src/miner/tools.ts
+// src/learner/tools.ts
 function textResult(text) {
   return { content: [{ type: "text", text }] };
 }
@@ -72823,7 +72871,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")
@@ -72849,11 +72897,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) {
@@ -72875,12 +72923,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)}`);
     }
   }
 }
@@ -72893,7 +72941,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("; ");
@@ -72901,7 +72949,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();
@@ -72916,7 +72964,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();
@@ -72929,7 +72977,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,
@@ -72940,9 +72988,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,
@@ -72958,17 +73006,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`) {
@@ -73020,15 +73068,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 };
       }
     }
@@ -73036,7 +73084,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);
@@ -73044,12 +73092,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);
@@ -73519,7 +73567,7 @@ var init_settings = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "971484cf-da0f-e0c4-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "5776df20-501e-ff5f-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
@@ -73548,11 +73596,13 @@ function normalizeContext(context) {
   const isAuthenticated2 = context?.isAuthenticated === true;
   const id2 = safeRead(context?.user, "id");
   const email3 = safeRead(context?.user, "email");
-  const user = isAuthenticated2 && validUserId(id2) ? { id: id2, ...validEmail(email3) ? { email: email3 } : {} } : undefined;
+  const orgId = safeRead(context, "orgId");
+  const user = isAuthenticated2 && isUUID2(id2) ? { id: id2, ...validEmail(email3) ? { email: email3 } : {} } : undefined;
   return {
     mode: context?.mode === "oss" ? "oss" : "cloud",
     isAuthenticated: isAuthenticated2,
-    ...user ? { user } : {}
+    ...user ? { user } : {},
+    ...user && isUUID2(orgId) ? { orgId } : {}
   };
 }
 function normalizeExitCode(value, fallback = 1) {
@@ -73572,12 +73622,9 @@ function normalizeRuntime(runtime) {
     isTty: runtime.isTty === true
   };
 }
-function validInstallId(value) {
+function isUUID2(value) {
   return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
 }
-function validUserId(value) {
-  return validInstallId(value);
-}
 function validEmail(value) {
   return typeof value === "string" && value.length <= 254 && /^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/.test(value);
 }
@@ -73727,7 +73774,7 @@ function buildPostHogPayload(input2) {
   const result = input2.result === "success" || input2.result === "validation_error" ? input2.result : "failure";
   return {
     api_key: input2.apiKey,
-    distinct_id: context.user?.id ?? (validInstallId(input2.installId) ? input2.installId : FALLBACK_INSTALL_ID),
+    distinct_id: context.user?.id ?? (isUUID2(input2.installId) ? input2.installId : FALLBACK_INSTALL_ID),
     event: "cli_command_completed",
     properties: {
       $geoip_disable: true,
@@ -73745,6 +73792,10 @@ function buildPostHogPayload(input2) {
       is_ci: runtime.isCi,
       is_tty: runtime.isTty,
       mode: context.mode,
+      ...context.orgId ? {
+        org_id: context.orgId,
+        $groups: { organization: context.orgId }
+      } : {},
       is_authenticated: context.isAuthenticated,
       exit_code: normalizeExitCode(input2.exitCode),
       ...errorCode ? { error_code: errorCode } : {}
@@ -73859,7 +73910,12 @@ function buildSentryEnvelope(input2) {
     level: "error",
     release: `dosu-cli@${runtime.version}`,
     tags: sentryTags(command, context, runtime, error61),
-    ...context.user ? { user: context.user } : {},
+    ...context.user ? {
+      user: {
+        id: context.user.id,
+        ...context.user.email ? { email: context.user.email } : {}
+      }
+    } : {},
     ...mappedBundle ? {
       debug_meta: {
         images: [{ type: "sourcemap", code_file: BUNDLE_CODE_FILE, debug_id: debugId }]
@@ -74053,7 +74109,7 @@ function safeNow(now) {
 function safeUuid(generate) {
   try {
     const value = generate();
-    return validInstallId(value) ? value : undefined;
+    return isUUID2(value) ? value : undefined;
   } catch {
     return;
   }
@@ -74085,7 +74141,7 @@ function createCommandTelemetry(settings2, dependencies = {}) {
   let installIdResolved = false;
   let resolvedInstallId = settings2.install_id;
   function installId() {
-    if (validInstallId(resolvedInstallId))
+    if (isUUID2(resolvedInstallId))
       return resolvedInstallId;
     if (installIdResolved)
       return;
@@ -74095,7 +74151,7 @@ function createCommandTelemetry(settings2, dependencies = {}) {
     } catch {
       resolvedInstallId = undefined;
     }
-    return validInstallId(resolvedInstallId) ? resolvedInstallId : undefined;
+    return isUUID2(resolvedInstallId) ? resolvedInstallId : undefined;
   }
   function debugPayload(payload) {
     try {
@@ -74314,16 +74370,6 @@ var init_follow = () => {};
 
 // src/mcp/providers/base.ts
 function createJSONProvider(opts) {
-  const defaultBuildServer = (cfg) => ({
-    type: "http",
-    url: mcpURL(cfg.active_account.target.deployment_id),
-    headers: mcpHeaders(cfg.active_account?.target?.api_key)
-  });
-  const defaultBuildOSSServer = (cfg) => ({
-    type: "http",
-    url: mcpBaseURL(),
-    headers: mcpHeaders(cfg.active_account?.target?.api_key)
-  });
   const buildServer = opts.buildServer ?? defaultBuildServer;
   return {
     name: () => opts.providerName,
@@ -74335,8 +74381,10 @@ function createJSONProvider(opts) {
     globalConfigPath: () => expandHome(opts.globalPath),
     isConfigured: () => isJSONKeyConfigured(expandHome(opts.globalPath), opts.topKey),
     install(cfg, global2) {
-      if (cfg.mode !== MODE_OSS && !cfg.active_account?.target?.deployment_id)
-        throw new Error("deployment ID is required");
+      const endpoint = {
+        url: mcpEndpoint(cfg),
+        headers: mcpHeaders(cfg.active_account?.target?.api_key)
+      };
       let configPath;
       if (global2) {
         configPath = expandHome(opts.globalPath);
@@ -74345,8 +74393,7 @@ function createJSONProvider(opts) {
       } else {
         throw new Error(`${opts.providerName} does not support local installation`);
       }
-      const serverBuilder = cfg.mode === MODE_OSS ? defaultBuildOSSServer : buildServer;
-      installJSONServer(configPath, opts.topKey, serverBuilder(cfg));
+      installJSONServer(configPath, opts.topKey, buildServer(endpoint, cfg));
     },
     remove(global2) {
       let configPath;
@@ -74361,8 +74408,12 @@ function createJSONProvider(opts) {
     }
   };
 }
+var defaultBuildServer = ({ url: url2, headers }) => ({
+  type: "http",
+  url: url2,
+  headers
+});
 var init_base = __esm(() => {
-  init_config();
   init_config_helpers();
   init_detect();
 });
@@ -74376,13 +74427,12 @@ var AntigravityProvider = () => createJSONProvider({
   paths: ["~/.gemini"],
   globalPath: "~/.gemini/antigravity/mcp_config.json",
   topKey: "mcpServers",
-  buildServer: (cfg) => ({
-    serverUrl: mcpURL(cfg.active_account.target.deployment_id),
-    headers: mcpHeaders(cfg.active_account.target.api_key)
+  buildServer: ({ url: url2, headers }) => ({
+    serverUrl: url2,
+    headers
   })
 });
 var init_antigravity = __esm(() => {
-  init_config_helpers();
   init_base();
 });
 
@@ -74419,9 +74469,7 @@ var ClaudeDesktopProvider = () => ({
   install(cfg, global2) {
     if (!global2)
       throw new Error("Claude Desktop does not support local installation");
-    if (cfg.mode !== MODE_OSS && !cfg.active_account?.target?.deployment_id)
-      throw new Error("deployment ID is required");
-    const url2 = cfg.mode === MODE_OSS ? mcpBaseURL() : mcpURL(cfg.active_account.target.deployment_id);
+    const url2 = mcpEndpoint(cfg);
     const npx = findNpx();
     const remote = mcpRemoteServer(url2, cfg.active_account?.target?.api_key);
     installJSONServer(configPath(), "mcpServers", {
@@ -74437,7 +74485,6 @@ var ClaudeDesktopProvider = () => ({
   }
 });
 var init_claude_desktop = __esm(() => {
-  init_config();
   init_config_helpers();
   init_detect();
 });
@@ -74452,15 +74499,14 @@ var extensionDir = () => join25(appSupportDir(), "Code", "User", "globalStorage"
   paths: [extensionDir()],
   globalPath: join25(extensionDir(), "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
-  buildServer: (cfg) => ({
-    url: mcpURL(cfg.active_account.target.deployment_id),
+  buildServer: ({ url: url2, headers }) => ({
+    url: url2,
     type: "streamableHttp",
     disabled: false,
-    headers: mcpHeaders(cfg.active_account.target.api_key)
+    headers
   })
 });
 var init_cline = __esm(() => {
-  init_config_helpers();
   init_detect();
   init_base();
 });
@@ -74478,22 +74524,21 @@ var ClineCliProvider = () => createJSONProvider({
   paths: [clineDir()],
   globalPath: join26(clineDir(), "data", "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
-  buildServer: (cfg) => ({
-    url: mcpURL(cfg.active_account.target.deployment_id),
+  buildServer: ({ url: url2, headers }) => ({
+    url: url2,
     type: "streamableHttp",
     disabled: false,
-    headers: mcpHeaders(cfg.active_account.target.api_key)
+    headers
   })
 });
 var init_cline_cli = __esm(() => {
-  init_config_helpers();
   init_detect();
   init_base();
 });
 
 // src/mcp/providers/codex.ts
 import { existsSync as existsSync20, readFileSync as readFileSync20 } from "node:fs";
-import { join as join27 } from "node:path";
+import { dirname as dirname9, join as join27 } from "node:path";
 function codexHome2() {
   return process.env.CODEX_HOME ?? expandHome("~/.codex");
 }
@@ -74510,13 +74555,6 @@ function readTOML(path3) {
 function writeTOML(path3, content) {
   writeSecureFile(path3, content);
 }
-function mcpEndpoint(cfg) {
-  if (cfg.mode === MODE_OSS)
-    return mcpBaseURL();
-  if (!cfg.active_account?.target?.deployment_id)
-    throw new Error("deployment ID is required");
-  return mcpURL(cfg.active_account?.target?.deployment_id);
-}
 function tomlString(value) {
   return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
 }
@@ -74540,19 +74578,24 @@ ${envEntries}
   content += section;
   writeTOML(path3, content);
 }
+function sectionName(line) {
+  const header = line.trim();
+  const match = header.match(/^\[\[([^\]]*)]]\s*(?:#.*)?$/) ?? header.match(/^\[([^\]]*)]\s*(?:#.*)?$/);
+  return match ? match[1].trim() : null;
+}
+function isDosuSection(name) {
+  return name === "mcp_servers.dosu" || name.startsWith("mcp_servers.dosu.");
+}
 function removeDosuFromTOML(content) {
-  const lines = content.split(`
-`);
   const result = [];
   let inDosuSection = false;
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (trimmed.match(/^\[mcp_servers\.dosu(\..*)?]$/)) {
-      inDosuSection = true;
-      continue;
-    }
-    if (inDosuSection && trimmed.startsWith("[")) {
-      inDosuSection = false;
+  for (const line of content.split(`
+`)) {
+    const name = sectionName(line);
+    if (name !== null) {
+      inDosuSection = isDosuSection(name);
+      if (inDosuSection)
+        continue;
     }
     if (!inDosuSection) {
       result.push(line);
@@ -74561,7 +74604,45 @@ function removeDosuFromTOML(content) {
   return result.join(`
 `);
 }
-var CodexProvider = () => ({
+function hasRemoteHTTPForm(content) {
+  let inDosuRoot = false;
+  for (const line of content.split(`
+`)) {
+    const name = sectionName(line);
+    if (name !== null) {
+      if (name === "mcp_servers.dosu.http_headers")
+        return true;
+      inDosuRoot = name === "mcp_servers.dosu";
+      continue;
+    }
+    if (inDosuRoot && REMOTE_HTTP_KEY.test(line.trim()))
+      return true;
+  }
+  return false;
+}
+function projectConfigPaths() {
+  const cwd = process.cwd();
+  const chain = [];
+  for (let dir = cwd;; ) {
+    chain.push(dir);
+    if (existsSync20(join27(dir, ".git")))
+      break;
+    const parent = dirname9(dir);
+    if (parent === dir)
+      return [join27(cwd, ".codex", "config.toml")];
+    dir = parent;
+  }
+  return chain.reverse().map((dir) => join27(dir, ".codex", "config.toml"));
+}
+function pruneLegacyRemoteEntry(path3) {
+  if (!existsSync20(path3))
+    return;
+  const content = readTOML(path3);
+  if (!hasRemoteHTTPForm(content))
+    return;
+  writeTOML(path3, removeDosuFromTOML(content));
+}
+var REMOTE_HTTP_KEY, CodexProvider = () => ({
   name: () => "Codex (CLI + Desktop)",
   id: () => "codex",
   supportsLocal: () => true,
@@ -74576,7 +74657,15 @@ var CodexProvider = () => ({
   install(cfg, global2) {
     if (cfg.mode !== MODE_OSS && !cfg.active_account?.target?.deployment_id)
       throw new Error("deployment ID is required");
-    installDosuToTOML(getConfigPath2(global2), cfg);
+    if (!global2 && hasRemoteHTTPForm(readTOML(getConfigPath2(true)))) {
+      throw new Error("the global Codex config still holds the legacy remote-HTTP Dosu entry, which Codex would " + "merge with a project-local entry and reject. Migrate it first with " + "`dosu mcp add codex --global`, then re-run this.");
+    }
+    const written = getConfigPath2(global2);
+    installDosuToTOML(written, cfg);
+    for (const path3 of projectConfigPaths()) {
+      if (path3 !== written)
+        pruneLegacyRemoteEntry(path3);
+    }
   },
   remove(global2) {
     const path3 = getConfigPath2(global2);
@@ -74589,6 +74678,7 @@ var init_codex = __esm(() => {
   init_config();
   init_config_helpers();
   init_detect();
+  REMOTE_HTTP_KEY = /^(url|type|bearer_token_env_var)\s*=/;
 });
 
 // src/mcp/providers/copilot.ts
@@ -74599,13 +74689,6 @@ function globalPath() {
   }
   return expandHome("~/.copilot/mcp-config.json");
 }
-function mcpEndpoint2(cfg) {
-  if (cfg.mode === MODE_OSS)
-    return mcpBaseURL();
-  if (!cfg.active_account?.target?.deployment_id)
-    throw new Error("deployment ID is required");
-  return mcpURL(cfg.active_account?.target?.deployment_id);
-}
 var CopilotProvider = () => ({
   name: () => "GitHub Copilot CLI",
   id: () => "copilot",
@@ -74616,7 +74699,7 @@ var CopilotProvider = () => ({
   globalConfigPath: () => globalPath(),
   isConfigured: () => isJSONKeyConfigured(globalPath(), "mcpServers"),
   install(cfg, global2) {
-    const url2 = mcpEndpoint2(cfg);
+    const url2 = mcpEndpoint(cfg);
     if (global2) {
       const server = {
         type: "http",
@@ -74645,7 +74728,6 @@ var CopilotProvider = () => ({
   }
 });
 var init_copilot = __esm(() => {
-  init_config();
   init_config_helpers();
   init_detect();
 });
@@ -74660,14 +74742,13 @@ var CursorProvider = () => createJSONProvider({
   paths: ["~/.cursor"],
   globalPath: "~/.cursor/mcp.json",
   topKey: "mcpServers",
-  buildServer: (cfg) => ({
-    url: mcpURL(cfg.active_account.target.deployment_id),
-    headers: mcpHeaders(cfg.active_account.target.api_key)
+  buildServer: ({ url: url2, headers }) => ({
+    url: url2,
+    headers
   }),
   localConfigPath: (cwd) => join29(cwd, ".cursor", "mcp.json")
 });
 var init_cursor = __esm(() => {
-  init_config_helpers();
   init_base();
 });
 
@@ -74704,13 +74785,6 @@ var init_gemini = __esm(() => {
 });
 
 // src/mcp/providers/manual.ts
-function mcpEndpoint3(cfg) {
-  if (cfg.mode === MODE_OSS)
-    return mcpBaseURL();
-  if (!cfg.active_account?.target?.deployment_id)
-    throw new Error("deployment ID is required");
-  return mcpURL(cfg.active_account?.target?.deployment_id);
-}
 function maskSecret(secret) {
   if (secret.length <= 8)
     return "[hidden]";
@@ -74722,7 +74796,7 @@ var ManualProvider = () => ({
   id: () => "manual",
   supportsLocal: () => false,
   install(cfg, _global, opts = {}) {
-    const url2 = mcpEndpoint3(cfg);
+    const url2 = mcpEndpoint(cfg);
     const apiKey = mcpHeaders(cfg.active_account?.target?.api_key)["X-Dosu-API-Key"];
     const headerValue = opts.showSecret ? apiKey : maskSecret(apiKey);
     console.log("Use these details to configure the Dosu MCP server in your client:");
@@ -74742,7 +74816,6 @@ To remove the Dosu MCP server, manually delete the configuration from your clien
   }
 });
 var init_manual = __esm(() => {
-  init_config();
   init_config_helpers();
 });
 
@@ -74758,13 +74831,6 @@ function resolveGlobalConfigPath() {
     return jsoncPath;
   return jsonPath;
 }
-function mcpEndpoint4(cfg) {
-  if (cfg.mode === MODE_OSS)
-    return mcpBaseURL();
-  if (!cfg.active_account?.target?.deployment_id)
-    throw new Error("deployment ID is required");
-  return mcpURL(cfg.active_account?.target?.deployment_id);
-}
 var MCPorterProvider = () => ({
   name: () => "MCPorter",
   id: () => "mcporter",
@@ -74778,7 +74844,7 @@ var MCPorterProvider = () => ({
     const configPath2 = global2 ? resolveGlobalConfigPath() : join32(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
-      url: mcpEndpoint4(cfg),
+      url: mcpEndpoint(cfg),
       headers: mcpHeaders(cfg.active_account.target.api_key)
     };
     installJSONServer(configPath2, "mcpServers", server);
@@ -74789,7 +74855,6 @@ var MCPorterProvider = () => ({
   }
 });
 var init_mcporter = __esm(() => {
-  init_config();
   init_config_helpers();
   init_detect();
 });
@@ -74804,16 +74869,15 @@ var OpenCodeProvider = () => createJSONProvider({
   paths: ["~/.config/opencode"],
   globalPath: "~/.config/opencode/opencode.json",
   topKey: "mcp",
-  buildServer: (cfg) => ({
+  buildServer: ({ url: url2, headers }) => ({
     type: "remote",
-    url: mcpURL(cfg.active_account.target.deployment_id),
+    url: url2,
     enabled: true,
-    headers: mcpHeaders(cfg.active_account.target.api_key)
+    headers
   }),
   localConfigPath: (cwd) => join33(cwd, "opencode.json")
 });
 var init_opencode = __esm(() => {
-  init_config_helpers();
   init_base();
 });
 
@@ -74851,30 +74915,73 @@ var init_windsurf = __esm(() => {
 });
 
 // src/mcp/providers/zed.ts
-import { platform as platform3 } from "node:os";
+import { rmSync as rmSync5 } from "node:fs";
+import { homedir as homedir9, platform as platform3 } from "node:os";
 import { join as join36 } from "node:path";
 function zedConfigDir() {
   const os3 = platform3();
-  if (os3 === "darwin" || os3 === "win32")
+  if (os3 === "win32")
     return join36(appSupportDir(), "Zed");
+  if (os3 === "darwin")
+    return join36(homedir9(), ".config", "zed");
   return join36(appSupportDir(), "zed");
 }
-var ZedProvider = () => createJSONProvider({
-  providerName: "Zed",
-  providerID: "zed",
-  local: true,
-  priorityValue: 10,
-  paths: [zedConfigDir()],
-  globalPath: join36(zedConfigDir(), "settings.json"),
-  topKey: "context_servers",
-  buildServer: (cfg) => ({
-    source: "custom",
-    type: "http",
-    url: mcpURL(cfg.active_account.target.deployment_id),
-    headers: mcpHeaders(cfg.active_account.target.api_key)
-  }),
-  localConfigPath: (cwd) => join36(cwd, ".zed", "settings.json")
-});
+function zedDataDir() {
+  const os3 = platform3();
+  if (os3 === "darwin")
+    return join36(appSupportDir(), "Zed");
+  if (os3 === "win32")
+    return join36(process.env.LOCALAPPDATA ?? "", "Zed");
+  return join36(process.env.XDG_DATA_HOME ?? join36(homedir9(), ".local", "share"), "zed");
+}
+function legacyDarwinSettingsPath() {
+  return platform3() === "darwin" ? join36(appSupportDir(), "Zed", "settings.json") : null;
+}
+function removeLegacyDosuEntry(path3) {
+  let cfg;
+  try {
+    cfg = readJSONConfig(path3);
+  } catch {
+    return;
+  }
+  const servers = cfg.context_servers;
+  if (typeof servers !== "object" || servers === null || !("dosu" in servers))
+    return;
+  delete servers.dosu;
+  const nothingElse = Object.keys(cfg).length === 1 && Object.keys(servers).length === 0;
+  if (nothingElse)
+    rmSync5(path3, { force: true });
+  else
+    saveJSONConfig(path3, cfg);
+}
+var ZedProvider = (legacyPath = legacyDarwinSettingsPath()) => {
+  const provider = createJSONProvider({
+    providerName: "Zed",
+    providerID: "zed",
+    local: true,
+    priorityValue: 10,
+    paths: [zedConfigDir(), zedDataDir()],
+    globalPath: join36(zedConfigDir(), "settings.json"),
+    topKey: "context_servers",
+    buildServer: ({ url: url2, headers }) => ({ url: url2, headers }),
+    localConfigPath: (cwd) => join36(cwd, ".zed", "settings.json")
+  });
+  if (!legacyPath)
+    return provider;
+  return {
+    ...provider,
+    install(cfg, global2) {
+      provider.install(cfg, global2);
+      if (global2)
+        removeLegacyDosuEntry(legacyPath);
+    },
+    remove(global2) {
+      provider.remove(global2);
+      if (global2)
+        removeLegacyDosuEntry(legacyPath);
+    }
+  };
+};
 var init_zed = __esm(() => {
   init_config_helpers();
   init_detect();
@@ -75088,13 +75195,13 @@ var init_update_check = __esm(() => {
 
 // src/rules/installer.ts
 import { existsSync as existsSync23, mkdirSync as mkdirSync13, readFileSync as readFileSync22, unlinkSync as unlinkSync4, writeFileSync as writeFileSync14 } from "node:fs";
-import { homedir as homedir9 } from "node:os";
-import { dirname as dirname9, join as join38 } from "node:path";
+import { homedir as homedir10 } from "node:os";
+import { dirname as dirname10, join as join38 } from "node:path";
 function claudeConfigDir() {
-  return process.env.CLAUDE_CONFIG_DIR || join38(homedir9(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join38(homedir10(), ".claude");
 }
 function codexHome3() {
-  return process.env.CODEX_HOME || join38(homedir9(), ".codex");
+  return process.env.CODEX_HOME || join38(homedir10(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -75120,7 +75227,7 @@ async function fetchDosuRule(fetchImpl = globalThis.fetch) {
   return normalizeRule(FALLBACK_DOSU_RULE);
 }
 function ensureParent(path3) {
-  mkdirSync13(dirname9(path3), { recursive: true });
+  mkdirSync13(dirname10(path3), { recursive: true });
 }
 function writeIfChanged(path3, content) {
   if (!existsSync23(path3)) {
@@ -75240,7 +75347,7 @@ var init_installer = __esm(() => {
     },
     cursor: {
       kind: "file",
-      path: () => join38(homedir9(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join38(homedir10(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
@@ -75249,15 +75356,15 @@ var init_installer = __esm(() => {
     },
     opencode: {
       kind: "section",
-      path: () => join38(homedir9(), ".config", "opencode", "AGENTS.md")
+      path: () => join38(homedir10(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join38(homedir9(), ".gemini", "GEMINI.md")
+      path: () => join38(homedir10(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join38(homedir9(), ".gemini", "GEMINI.md")
+      path: () => join38(homedir10(), ".gemini", "GEMINI.md")
     }
   };
 });
@@ -75395,6 +75502,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 homedir11 } 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 = homedir11(), 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;
@@ -75418,7 +75659,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";
@@ -75432,6 +75674,10 @@ function reduceActivityViewKey(key) {
     return "down";
   if (key === "s")
     return "sync";
+  if (key === "f")
+    return "full";
+  if (key === "c")
+    return "clear";
   return "none";
 }
 function cycleTab(tab, delta = 1) {
@@ -75454,33 +75700,49 @@ function syncConfirmMode(status) {
     return "resume";
   return "start";
 }
-function formatActivityLine(line, width) {
+function formatActivityLine(line, width, full = false) {
   const compact = stripAnsiCodes(line).replace(/^\[(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})[^\]]*\]/, (_match, _date2, time3) => time3);
-  if (compact.length <= width)
+  if (full || compact.length <= width)
     return compact;
   return `${compact.slice(0, Math.max(0, width - 1))}…`;
 }
 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) {
+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("/");
   const harness = slash > 0 ? record2.session.slice(0, slash) : "-";
   const id2 = slash > 0 ? record2.session.slice(slash + 1) : record2.session;
-  const project = clip(record2.project ?? "-", 28);
-  return `${harness.padEnd(8)}  ${stamp}  ${project}  ${clip(id2, 24)}`;
+  const rawProject = record2.project ?? "-";
+  const project = full ? rawProject : clip(rawProject, 28);
+  const label = full ? name ? `${name} · ${id2}` : id2 : clip(name ?? id2, 44);
+  return `${harness.padEnd(8)}  ${stamp}  ${project}  ${label}`;
 }
-function formatQueuedRow(session) {
+function formatQueuedRow(session, full = false, name) {
   const stamp = session.updated.replace("T", " ").slice(5, 16);
-  const project = clip(session.project ?? "-", 28);
-  return `${session.harness.padEnd(8)}  ${stamp}  ${project}  ${clip(session.id, 24)}`;
+  const rawProject = session.project ?? "-";
+  const project = full ? rawProject : clip(rawProject, 28);
+  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)
+    return [text];
+  const out = [text.slice(0, width)];
+  let rest = text.slice(width);
+  const inner = Math.max(1, width - indent.length);
+  while (rest.length > 0) {
+    out.push(indent + rest.slice(0, inner));
+    rest = rest.slice(inner);
+  }
+  return out;
 }
 function windowList(lines, scroll, height = ACTIVITY_VIEW_LIST_LINES) {
   const clamped = Math.max(0, Math.min(scroll, Math.max(0, lines.length - height)));
@@ -75508,23 +75770,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;
     }
   }
@@ -75538,15 +75800,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;
@@ -75558,14 +75820,14 @@ 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})`],
-    ["queued", `Queued (${queuedCount})`],
-    ["open", `Open (${openCount})`]
+    ["activity", "activity"],
+    ["studied", `studied (${studiedCount})`],
+    ["queued", `queued (${queuedCount})`],
+    ["open", `open (${openCount})`]
   ], tab, width);
 }
 function activityWidth(columns) {
@@ -75587,10 +75849,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)),
@@ -75606,64 +75869,143 @@ 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 minedRows = (status.state.mined_sessions ?? []).map((record2) => formatActivityLine(formatMinedRow(record2), width));
-  const queuedRows = queued.map((session) => formatActivityLine(formatQueuedRow(session), width));
-  const openRows = open5.map((session) => formatActivityLine(formatQueuedRow(session), width));
-  const source = pane.tab === "activity" ? activity.map((line) => formatActivityLine(line, width)) : 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 { visible, above, below } = windowList(source, pane.scroll);
-  const listRows = visible.length > 0 ? visible.map((row) => import_picocolors30.default.dim(row)) : [import_picocolors30.default.dim(empty)];
+  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 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 : 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;
+  const listRows = display.length > 0 ? display.map((row) => import_picocolors30.default.dim(row)) : [import_picocolors30.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
     scrollParts.push(`↑ ${above} earlier`);
   if (below > 0)
     scrollParts.push(`↓ ${below} newer`);
-  if (pane.tab !== "activity" && visible.length > 0) {
-    scrollParts.push(`full rows: dosu knowledge sessions --${pane.tab}`);
-  }
   const lines = [
-    breadcrumb(["Home", "Activity"], width),
+    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(scrollParts.join(" · "))] : [],
+    ...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 "";
   }
@@ -75679,7 +76021,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);
@@ -75687,6 +76031,7 @@ function runActivityView(io2 = {}) {
   let runProgress = foldRunProgress(null, seed);
   let tab = "activity";
   let scroll = 0;
+  let fullRows = false;
   let confirmSync = null;
   let status = getStatus();
   let sessions = listBacklog();
@@ -75705,30 +76050,32 @@ function runActivityView(io2 = {}) {
       return sessions.open.length;
     return (status.state.mined_sessions ?? []).length;
   };
+  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 }, 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;
@@ -75775,11 +76122,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);
@@ -75803,14 +76154,23 @@ ${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;
           if (tab === "queued" || tab === "open")
             sessions = listBacklog();
           draw();
+        } else if (action === "full") {
+          fullRows = !fullRows;
+          scroll = 0;
+          draw();
         } else if (action === "up") {
-          const maxScroll = Math.max(0, activeListLength() - ACTIVITY_VIEW_LIST_LINES);
+          const maxScroll = Math.max(0, activeListLength() - listHeight());
           if (scroll < maxScroll) {
             scroll += 1;
             draw();
@@ -75826,10 +76186,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_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();
@@ -75851,7 +76213,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 };
 });
 
@@ -75864,7 +76226,7 @@ async function trackCliOnboardingEvent(cfg, onboardingRunID, event, properties =
       return;
     if (!cfg.active_account?.session.access_token)
       return;
-    if (!isUUID2(onboardingRunID))
+    if (!isUUID3(onboardingRunID))
       return;
     const input2 = {
       event,
@@ -75887,7 +76249,7 @@ async function trackCliOnboardingPreAuthEvent(onboardingRunID, event, properties
       return;
     if (!analyticsReleaseEnabled())
       return;
-    if (!isUUID2(onboardingRunID))
+    if (!isUUID3(onboardingRunID))
       return;
     const input2 = {
       event,
@@ -75920,13 +76282,14 @@ function analyticsReleaseEnabled() {
   return Boolean(parsePostHogProjectToken(process.env.DOSU_POSTHOG_PROJECT_TOKEN_OVERRIDE ?? "phc_Uo9RxhN0HRk8gZkPlT18BCr7eqsM0MPWVW88HZB95V5"));
 }
 function baseProperties(cfg) {
+  const orgId = cfg.active_account?.target?.org_id;
   return {
     cli_version: safeIdentifier(VERSION, 32),
     install_channel: safeIdentifier(INSTALL_CHANNEL, 32),
     platform: safeIdentifier(process.platform, 24),
     arch: safeIdentifier(process.arch, 24),
     mode: cfg.mode ?? "cloud",
-    org_id: safeIdentifier(cfg.active_account?.target?.org_id, 128),
+    ...orgId && isUUID3(orgId) ? { org_id: orgId, $groups: { organization: orgId } } : {},
     deployment_id: safeIdentifier(cfg.active_account?.target?.deployment_id, 128),
     space_id: safeIdentifier(cfg.active_account?.target?.space_id, 128)
   };
@@ -75961,7 +76324,7 @@ function allowlistedWorkflowProperties(properties) {
 function safeIdentifier(value, maxLength) {
   return typeof value === "string" && value.length <= maxLength && /^[A-Za-z0-9][A-Za-z0-9._+-]*$/.test(value) ? value : undefined;
 }
-function isUUID2(value) {
+function isUUID3(value) {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
 }
 function createAnalyticsClient(accessToken, requestSignal) {
@@ -76684,23 +77047,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",
@@ -77525,12 +77896,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`);
   }
@@ -77579,7 +77953,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)
@@ -77587,12 +77961,12 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
   if (below > 0)
     scrollParts.push(`↓ ${below} more`);
   const lines = [
-    breadcrumb(["Home", "Analytics"], width),
+    breadcrumb(["home", "analytics"], width),
     "",
     ...tabStrip([
-      ["overview", "Overview"],
-      ["projects", "Projects"],
-      ["pages", "Pages"]
+      ["overview", "overview"],
+      ["projects", "projects"],
+      ["pages", "pages"]
     ], tab, width, { spread: false }),
     "",
     ...listRows,
@@ -77731,7 +78105,7 @@ function checklistRows(ctx) {
   const rows = [["workspace", ctx.directory]];
   rows.push([
     "account",
-    ctx.signedIn ? `${on2} signed in` : `${off} ${import_picocolors33.default.dim("not signed in · run Setup")}`
+    ctx.sessionExpired ? `${off} ${import_picocolors33.default.yellow("session expired")} ${import_picocolors33.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on2} signed in` : `${off} ${import_picocolors33.default.dim(`not signed in ${DOT3} run Setup`)}`
   ]);
   const missing = new Set(ctx.setupMissing ?? []);
   const warnRow = `${off} ${import_picocolors33.default.yellow("not configured")} ${import_picocolors33.default.dim(`${DOT3} run Setup`)}`;
@@ -77755,10 +78129,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) {
@@ -77935,7 +78309,7 @@ function renderPagesFrame(model, width, selected) {
   }
   const count = model.phase === "ready" ? ` ${import_picocolors34.default.dim(model.pages.length < model.total ? `(${model.pages.length} of ${model.total})` : `(${model.pages.length})`)}` : "";
   const lines = [
-    `${breadcrumb(["Home", "Pages"], width)}${count}`,
+    `${breadcrumb(["home", "pages"], width)}${count}`,
     "",
     ...body,
     ...scrollHint ? [import_picocolors34.default.dim(scrollHint)] : [],
@@ -77965,7 +78339,7 @@ function renderPageFrame(page, content, width, scroll) {
   }
   const meta3 = `${page.type} · ${page.published ? "published" : "draft"} · updated ${page.updated_at.slice(0, 10)}`;
   const lines = [
-    breadcrumb(["Home", "Pages", page.title], width),
+    breadcrumb(["home", "pages", page.title], width),
     import_picocolors34.default.dim(clip3(meta3, width)),
     "",
     ...body,
@@ -78148,9 +78522,19 @@ __export(exports_tui, {
   runTUI: () => runTUI,
   handleLogout: () => handleLogout
 });
-import { homedir as homedir10 } from "node:os";
-import { basename as basename4 } from "node:path";
-function bannerContext(cfg) {
+import { homedir as homedir12 } from "node:os";
+import { basename as basename6 } from "node:path";
+async function probeSession(cfg) {
+  if (!isAuthenticated(cfg) || !isTokenExpired(cfg))
+    return { expired: false };
+  try {
+    await new Client(cfg).refreshToken();
+    return { expired: false };
+  } catch (err) {
+    return { expired: err instanceof SessionExpiredError };
+  }
+}
+function bannerContext(cfg, session) {
   let webAppHost = "app.dosu.dev";
   try {
     webAppHost = new URL(getWebAppURL()).host;
@@ -78166,14 +78550,15 @@ function bannerContext(cfg) {
   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,
     libraryName: cfg.active_account?.target?.library_name,
-    setupMissing: isAuthenticated(cfg) ? missingSetupSteps(cfg) : [],
+    setupMissing: isAuthenticated(cfg) && !session.expired ? missingSetupSteps(cfg) : [],
     ...inGitWorkTree() ? { repoAgentsMd: dosuAgentsSectionState() } : {},
     agents,
-    mining: isMining(),
+    studying: isStudying(),
     ...latest ? { update: { version: latest, hint: buildUpdateHint(INSTALL_CHANNEL, isNpxInvocation()) } } : {}
   };
 }
@@ -78240,24 +78625,25 @@ 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 {
     return false;
   }
 }
-function drawHome(cfg) {
+function drawHome(cfg, session) {
   if (process.stdout.isTTY) {
     process.stdout.write(CLEAR_SCREEN);
     process.stdout.write(`
 `.repeat(frameTopMargin()));
   }
-  process.stdout.write(`${renderBanner(bannerContext(cfg))}
+  process.stdout.write(`${renderBanner(bannerContext(cfg, session))}
 `);
 }
 async function runMainMenu() {
   const cfg = loadConfig();
+  const session = await probeSession(cfg);
   const runSetupAndReload = async () => {
     await runSetup();
     const fresh = loadConfig();
@@ -78265,34 +78651,44 @@ async function runMainMenu() {
     cfg.active_account = fresh.active_account;
   };
   const buildOptions = () => {
+    if (session.expired) {
+      return [
+        {
+          label: "log in again",
+          hint: "(session expired · opens your browser)",
+          value: "auth"
+        },
+        { label: "exit", value: "exit" }
+      ];
+    }
     if (!isAuthenticated(cfg)) {
       return [
-        { label: "Log in / Sign up", hint: "(opens your browser)", value: "auth" },
-        { label: "Exit", value: "exit" }
+        { label: "log in / sign up", hint: "(opens your browser)", value: "auth" },
+        { label: "exit", value: "exit" }
       ];
     }
     if (!isSetUp(cfg)) {
       return [
-        { label: "Setup", hint: setupHint(cfg), value: "setup" },
-        { label: "Exit", value: "exit" }
+        { label: "setup", hint: setupHint(cfg), value: "setup" },
+        { 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" },
-      { label: "Analytics", value: "analytics" },
-      { label: "Pages", value: "pages" },
-      { label: "Settings", value: "settings" },
-      { label: "Exit", value: "exit" }
+      { label: "knowledge report", hint: "(opens in browser)", value: "report" },
+      { label: "analytics", value: "analytics" },
+      { label: "pages", value: "pages" },
+      { label: "settings", value: "settings" },
+      { label: "exit", value: "exit" }
     ];
   };
-  const home = () => drawHome(cfg);
+  const home = () => drawHome(cfg, session);
   home();
-  if (isAuthenticated(cfg) && !isSetUp(cfg)) {
+  if (isAuthenticated(cfg) && !session.expired && !isSetUp(cfg)) {
     await runSetupAndReload();
     home();
   }
@@ -78326,6 +78722,7 @@ async function runMainMenu() {
         break;
       case "auth":
         await handleAuthenticate(cfg);
+        session.expired = session.expired && isTokenExpired(cfg);
         home();
         if (isAuthenticated(cfg) && !isSetUp(cfg)) {
           await runSetupAndReload();
@@ -78355,19 +78752,19 @@ 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 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: "Run setup", hint: "rerun the setup wizard", value: "setup" },
-      { label: "Log out", hint: "clear stored credentials", value: "logout" },
-      { label: "Back", value: "back" }
+    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: "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" }
     ]);
     if (action === null || action === "back")
       return;
     if (action === "projects") {
-      await runMiningProjectsSetting();
+      await runStudyingProjectsSetting();
       continue;
     }
     if (action === "setup") {
@@ -78390,7 +78787,7 @@ async function runSettings(cfg) {
   }
 }
 function displayDir(dir) {
-  const home = homedir10();
+  const home = homedir12();
   return dir === home ? "~" : dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir;
 }
 function discoverProjectDirs() {
@@ -78405,7 +78802,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.");
@@ -78413,7 +78810,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
@@ -78428,7 +78825,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?" });
@@ -78474,6 +78871,7 @@ function handleLogout(cfg) {
 }
 var import_picocolors35, ESC10, CLEAR_SCREEN;
 var init_tui = __esm(() => {
+  init_client();
   init_config();
   init_agents();
   init_providers();
@@ -79131,7 +79529,7 @@ import {
   constants as constants3,
   fstatSync,
   openSync as openSync5,
-  readFileSync as readFileSync25,
+  readFileSync as readFileSync26,
   readSync as readSync4,
   unlinkSync as unlinkSync5
 } from "node:fs";
@@ -82333,23 +82731,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;
@@ -82373,11 +82771,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) {
@@ -82398,7 +82796,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,
@@ -82406,7 +82804,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 });
@@ -82463,12 +82861,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;
@@ -82477,8 +82875,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) {
@@ -82504,14 +82902,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;
@@ -82526,7 +82924,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(`
@@ -82542,25 +82940,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;
     }
@@ -82583,7 +82981,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;
     }
   }
@@ -83335,7 +83733,10 @@ init_skill();
 // src/commands/sources.ts
 init_commander();
 init_trpc();
+init_github_step();
+init_installation_server();
 var import_picocolors25 = __toESM(require_picocolors(), 1);
+var CONNECT_TIMEOUT_DEFAULT_SECONDS = 600;
 function requireConfig11() {
   const cfg = requireLoginConfig();
   if (!cfg.active_account?.target?.org_id) {
@@ -83344,6 +83745,15 @@ function requireConfig11() {
   }
   return cfg;
 }
+function rejectWebOnlyProvider(provider, json2) {
+  const url2 = getWebAppURL();
+  if (json2) {
+    printResult({ provider, cli_supported: false, connect_via: "web", url: url2 }, { json: true });
+  } else {
+    console.error(import_picocolors25.default.yellow(`Connecting '${provider}' sources is web-only for now. Open ${url2}, add the source ` + `under Data Sources, then re-run 'dosu sources list'.`));
+  }
+  process.exit(1);
+}
 function sourcesCommand() {
   const cmd = new Command("sources").description("Manage connected data sources");
   cmd.command("list").description("List all connected data sources").option("--json", "Output as JSON").action(async (opts) => {
@@ -83426,6 +83836,154 @@ function sourcesCommand() {
     }
     console.log(import_picocolors25.default.green("Data source deleted."));
   });
+  cmd.command("connect").description("Install or update a provider integration (currently GitHub) via the browser").argument("[provider]", "Provider to connect (github)", "github").option("--json", "Emit machine-readable NDJSON progress events").option("--timeout <seconds>", "Seconds to wait for the browser install to complete", String(CONNECT_TIMEOUT_DEFAULT_SECONDS)).option("--no-open", "Print the URL without opening a browser").action(async (provider, opts) => {
+    const providerName = provider.toLowerCase();
+    if (providerName !== "github") {
+      rejectWebOnlyProvider(providerName, opts.json);
+      return;
+    }
+    const cfg = requireConfig11();
+    const client = createTypedClient(cfg);
+    const orgID = cfg.active_account.target.org_id;
+    const timeoutSeconds = Math.max(1, Number.parseInt(opts.timeout ?? "", 10)) || CONNECT_TIMEOUT_DEFAULT_SECONDS;
+    const before = await fetchListForOrg(client, orgID);
+    const { server, installationPromise } = await startInstallationCallbackServer();
+    let timeoutId;
+    try {
+      const connectURL = new URL("/cli/connect-github", getWebAppURL());
+      connectURL.searchParams.set("callback", `http://localhost:${server.port}/callback`);
+      const url2 = connectURL.toString();
+      if (opts.json) {
+        console.log(JSON.stringify({
+          event: "awaiting_install",
+          provider: "github",
+          url: url2,
+          timeout_seconds: timeoutSeconds
+        }));
+      } else {
+        console.log(`Open this URL to install or update the Dosu GitHub App:
+  ${import_picocolors25.default.cyan(url2)}`);
+        if (opts.open !== false) {
+          try {
+            const open5 = await Promise.resolve().then(() => (init_open(), exports_open));
+            await open5.default(url2);
+          } catch {}
+        }
+        console.log(import_picocolors25.default.dim("Waiting for the install to complete..."));
+      }
+      const timedOut = new Promise((resolve6) => {
+        timeoutId = setTimeout(() => resolve6(null), timeoutSeconds * 1000);
+      });
+      const result = await Promise.race([installationPromise, timedOut]);
+      if (result === null) {
+        if (opts.json) {
+          console.log(JSON.stringify({ event: "timeout", timeout_seconds: timeoutSeconds }));
+        } else {
+          console.error(import_picocolors25.default.red(`Timed out after ${timeoutSeconds}s. Finish the install in the browser, then re-run 'dosu sources connect github'.`));
+        }
+        process.exit(1);
+        return;
+      }
+      const refresh = await waitForRepositoryRefresh(client, orgID, before);
+      const beforeIds = new Set(before.map((repo) => repo.repository_id));
+      const newRepositories = refresh.repos.filter((repo) => !beforeIds.has(repo.repository_id)).map((repo) => ({ slug: repo.slug, repository_id: repo.repository_id }));
+      if (opts.json) {
+        console.log(JSON.stringify({
+          event: "installed",
+          installation_id: result.installation_id,
+          new_repositories: newRepositories
+        }));
+        return;
+      }
+      console.log(import_picocolors25.default.green(`GitHub App connected (installation ${result.installation_id}).`));
+      if (newRepositories.length > 0) {
+        for (const repo of newRepositories) {
+          console.log(`  ${repo.slug}`);
+        }
+        console.log(import_picocolors25.default.dim("Next: dosu sources create github --repo <owner/name> --library <library-id>"));
+      } else {
+        console.log(import_picocolors25.default.dim("No new repositories visible yet — GitHub may still be syncing. " + "Re-run 'dosu sources connect github' or check 'dosu sources list' shortly."));
+      }
+    } finally {
+      clearTimeout(timeoutId);
+      server.close();
+    }
+  });
+  cmd.command("create").description("Create a data source from an installed provider and attach it to a library (requires confirmation)").argument("<provider>", "Provider (currently: github)").requiredOption("--repo <owner/name>", "GitHub repository slug visible to the Dosu app").option("--library <id>", "Library (space) ID to attach to; defaults to the active library").option("--confirm", "Apply without the interactive prompt").option("--json", "Output as JSON").action(async (provider, opts) => {
+    const providerName = provider.toLowerCase();
+    if (providerName !== "github") {
+      rejectWebOnlyProvider(providerName, opts.json);
+      return;
+    }
+    const cfg = requireConfig11();
+    const orgID = cfg.active_account.target.org_id;
+    const libraryID = opts.library ?? cfg.active_account?.target?.space_id;
+    if (!libraryID) {
+      console.error(import_picocolors25.default.red("No library specified and no active library. Pass --library <id>."));
+      process.exit(1);
+      return;
+    }
+    const client = createTypedClient(cfg);
+    const repos = await fetchListForOrg(client, orgID);
+    const repo = repos.find((r9) => r9.slug.toLowerCase() === opts.repo.toLowerCase());
+    if (!repo) {
+      console.error(import_picocolors25.default.red(`Repository '${opts.repo}' is not visible to Dosu. Run ` + `'dosu sources connect github' to grant the GitHub App access, then retry.`));
+      process.exit(1);
+      return;
+    }
+    if (repo.is_fork === true) {
+      console.error(import_picocolors25.default.red(`'${repo.slug}' is a fork and can't be synced.` + (repo.fork_parent_slug ? ` Connect '${repo.fork_parent_slug}' instead.` : "")));
+      process.exit(1);
+      return;
+    }
+    if (!await confirmAction({
+      confirmed: opts.confirm,
+      json: opts.json,
+      message: `Create a data source for ${repo.slug} and attach it to library ${libraryID}?`,
+      preview: {
+        action: "create_source",
+        provider: "github",
+        repository: repo.slug,
+        repository_id: repo.repository_id,
+        library_id: libraryID
+      }
+    }))
+      return;
+    const existingDeployments = await fetchOrgGithubDeployments(client, orgID);
+    const existingDataSources = await fetchOrgGithubDataSources(client, orgID);
+    const created = await createDeploymentForRepo(client, orgID, libraryID, repo, {
+      deploymentID: existingDeployments.get(repo.repository_id),
+      dataSourceID: existingDataSources.get(repo.repository_id)
+    });
+    if (!created) {
+      console.error(import_picocolors25.default.red("Could not create the data source. Check 'dosu logs --tail 50' for details."));
+      process.exit(1);
+      return;
+    }
+    const survivors = await verifyDataSourcesPersist(client, orgID, [created.data_source_id]);
+    if (survivors.dropped.size > 0) {
+      await deleteOrphanDeployment(client, created.deployment_id, repo.slug);
+      console.error(import_picocolors25.default.red(`Dosu couldn't sync '${repo.slug}' (the GitHub App may not have access to it). ` + "Nothing was created."));
+      process.exit(1);
+      return;
+    }
+    const receipt = {
+      provider: "github",
+      repository: repo.slug,
+      repository_id: repo.repository_id,
+      data_source_id: created.data_source_id,
+      deployment_id: created.deployment_id,
+      library_id: libraryID,
+      attached: true
+    };
+    if (opts.json) {
+      printResult(receipt, opts);
+      return;
+    }
+    console.log(import_picocolors25.default.green(`Connected ${repo.slug} to library ${libraryID}.`));
+    console.log(import_picocolors25.default.dim(`  data source ${created.data_source_id}`));
+    console.log(import_picocolors25.default.dim(`  deployment ${created.deployment_id}`));
+  });
   return cmd;
 }
 
@@ -83939,10 +84497,12 @@ function commandTelemetryContext() {
     const tokenUserID = getAccessTokenUserID(accessToken);
     const userID = configUserID && configUserID === tokenUserID ? configUserID : undefined;
     const email3 = userID ? getAccessTokenEmail(accessToken) : undefined;
+    const orgId = userID ? cfg.active_account?.target?.org_id : undefined;
     return {
       mode: cfg.mode === MODE_OSS ? "oss" : "cloud",
       isAuthenticated: authenticated,
-      ...userID ? { user: { id: userID, ...email3 ? { email: email3 } : {} } } : {}
+      ...userID ? { user: { id: userID, ...email3 ? { email: email3 } : {} } } : {},
+      ...orgId ? { orgId } : {}
     };
   } catch {
     return { mode: "cloud", isAuthenticated: false };
@@ -84341,7 +84901,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();
@@ -84357,7 +84917,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(`
@@ -84428,4 +84988,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=971484cf-da0f-e0c4-6475-6e2164756e21
+//# debugId=5776df20-501e-ff5f-6475-6e2164756e21