@dosu/cli 0.53.0-beta.3 → 0.53.0-beta.5

package/bin/dosu.js

@@ -5006,7 +5006,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.53.0-beta.3", INSTALL_CHANNEL = "npm";
+var VERSION = "0.53.0-beta.5", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -8346,258 +8346,25 @@ var init_agents = __esm(() => {
   init_formats();
 });
 
-// src/sync/lock.ts
-import { existsSync as existsSync9, readFileSync as readFileSync9, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join8 } from "node:path";
-function processAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (err) {
-    return err.code === "EPERM";
-  }
-}
-function lockPath(configDir = getConfigDir()) {
-  return join8(configDir, LOCK_FILENAME);
-}
-function fileLock(configDir = getConfigDir(), now = () => new Date) {
-  const path3 = lockPath(configDir);
-  let held = false;
-  const tryCreate = () => {
-    try {
-      writeFileSync6(path3, String(process.pid), { flag: "wx" });
-      return true;
-    } catch {
-      return false;
-    }
-  };
-  return {
-    acquire() {
-      if (tryCreate()) {
-        held = true;
-        return true;
-      }
-      try {
-        const age = now().getTime() - statSync3(path3).mtimeMs;
-        const holder = Number.parseInt(readFileSync9(path3, "utf8"), 10);
-        const holderDead = Number.isInteger(holder) && holder > 0 && !processAlive(holder);
-        if (age > STALE_LOCK_MS || holderDead) {
-          rmSync2(path3, { force: true });
-          held = tryCreate();
-          return held;
-        }
-      } catch {}
-      return false;
-    },
-    release() {
-      if (!held)
-        return;
-      held = false;
-      try {
-        if (existsSync9(path3) && readFileSync9(path3, "utf8") === String(process.pid)) {
-          rmSync2(path3, { force: true });
-        }
-      } catch {}
-    }
-  };
-}
-var LOCK_FILENAME = "knowledge-sync.lock", STALE_LOCK_MS;
-var init_lock = __esm(() => {
-  init_config();
-  STALE_LOCK_MS = 15 * 60 * 1000;
-});
-
-// src/sync/watermark.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync10, renameSync as renameSync2, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join9 } from "node:path";
-function syncStatePath(configDir = getConfigDir()) {
-  return join9(configDir, STATE_FILENAME);
-}
-function loadSyncState(configDir = getConfigDir()) {
-  const empty = {
-    schema_version: STATE_SCHEMA_VERSION,
-    watermark: null,
-    consecutive_failures: 0
-  };
-  const path3 = syncStatePath(configDir);
-  if (!existsSync10(path3))
-    return empty;
-  try {
-    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) => ({
-      at: record.at,
-      session: record.session,
-      ...typeof record.project === "string" ? { project: record.project } : {}
-    })) : [];
-    const rawRefusal = raw.last_refusal;
-    const lastRefusal = rawRefusal && typeof rawRefusal.at === "string" && typeof rawRefusal.outcome === "string" && typeof rawRefusal.message === "string" ? { at: rawRefusal.at, outcome: rawRefusal.outcome, message: rawRefusal.message } : undefined;
-    const rawRun = raw.run;
-    const run2 = rawRun && typeof rawRun.pid === "number" && typeof rawRun.started_at === "string" && typeof rawRun.baseline_mined === "number" && rawRun.baseline_mined >= 0 ? { pid: rawRun.pid, started_at: rawRun.started_at, baseline_mined: rawRun.baseline_mined } : undefined;
-    return {
-      schema_version: STATE_SCHEMA_VERSION,
-      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,
-      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 } : {},
-      ...run2 ? { run: run2 } : {},
-      ...Array.isArray(raw.project_filter) ? {
-        project_filter: raw.project_filter.filter((p2) => typeof p2 === "string")
-      } : {}
-    };
-  } catch {
-    return empty;
-  }
-}
-function saveSyncState(state, configDir = getConfigDir()) {
-  if (!existsSync10(configDir))
-    mkdirSync6(configDir, { recursive: true, mode: 448 });
-  const path3 = syncStatePath(configDir);
-  const tmp = `${path3}.${process.pid}.tmp`;
-  writeFileSync7(tmp, JSON.stringify(state, null, 2), { mode: 384 });
-  renameSync2(tmp, path3);
-}
-function backoffUntil(state) {
-  if (state.consecutive_failures === 0 || !state.last_attempt_at)
-    return null;
-  const last = Date.parse(state.last_attempt_at);
-  if (Number.isNaN(last))
-    return null;
-  const delay = Math.min(BACKOFF_BASE_MS * 2 ** (state.consecutive_failures - 1), BACKOFF_MAX_MS);
-  return new Date(last + delay);
-}
-function isUnderDir(dir, base) {
-  const root = base.endsWith("/") ? base.slice(0, -1) : base;
-  return dir === root || dir.startsWith(`${root}/`);
-}
-function filterSessionsByProject(sessions, filter, resolveDir) {
-  if (!filter || filter.length === 0)
-    return [...sessions];
-  const includeUnknown = filter.includes(UNKNOWN_PROJECT);
-  const dirs = filter.filter((entry) => entry !== UNKNOWN_PROJECT);
-  return sessions.filter((session) => {
-    const dir = resolveDir(session);
-    if (!dir)
-      return includeUnknown;
-    return dirs.some((base) => isUnderDir(dir, base));
-  });
-}
-function gateSessions(sessions, watermark, now = new Date, quietPeriodMs = DEFAULT_QUIET_PERIOD_MS) {
-  const watermarkMs = watermark ? Date.parse(watermark) : Number.NEGATIVE_INFINITY;
-  const completedBefore = now.getTime() - quietPeriodMs;
-  const ready = [];
-  const open2 = [];
-  for (const session of sessions) {
-    const updated = Date.parse(session.updated);
-    if (Number.isNaN(updated) || updated <= watermarkMs)
-      continue;
-    if (updated > completedBefore) {
-      open2.push(session);
-    } else {
-      ready.push(session);
-    }
-  }
-  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 init_watermark = __esm(() => {
-  init_config();
-  DEFAULT_QUIET_PERIOD_MS = 5 * 60 * 1000;
-  BACKOFF_BASE_MS = 15 * 60 * 1000;
-  BACKOFF_MAX_MS = 24 * 60 * 60 * 1000;
-});
-
-// src/sync/status.ts
-import { readFileSync as readFileSync11, statSync as statSync4 } from "node:fs";
-function formatTokenCount(tokens) {
-  if (tokens < 1000)
-    return String(tokens);
-  if (tokens < 1e6) {
-    const k = tokens / 1000;
-    return `~${k >= 100 ? Math.round(k) : k.toFixed(1).replace(/\.0$/, "")}k`;
-  }
-  const m3 = tokens / 1e6;
-  return `~${m3 >= 100 ? Math.round(m3) : m3.toFixed(1).replace(/\.0$/, "")}M`;
-}
-function defaultIsProcessAlive2(pid) {
-  if (!Number.isInteger(pid) || pid <= 0)
-    return false;
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (err) {
-    return err.code === "EPERM";
-  }
-}
-function defaultReadLog() {
-  try {
-    return readFileSync11(logger.getLogPath(), "utf-8");
-  } catch {
-    return "";
-  }
-}
-function readLockFile(configDir) {
-  const path3 = lockPath(configDir);
-  try {
-    const pid = Number.parseInt(readFileSync11(path3, "utf-8"), 10);
-    return { pid: Number.isNaN(pid) ? -1 : pid, mtime: statSync4(path3).mtime };
-  } catch {
-    return null;
-  }
-}
-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)\]/, ""));
-}
-function getSyncStatus(deps = {}) {
-  const configDir = deps.configDir ?? getConfigDir();
-  const isProcessAlive = deps.isProcessAlive ?? defaultIsProcessAlive2;
-  const readLog = deps.readLog ?? defaultReadLog;
-  const lock = readLockFile(configDir);
-  const running = lock !== null && isProcessAlive(lock.pid);
-  const state = loadSyncState(configDir);
-  const retryAt = backoffUntil(state);
-  return {
-    running,
-    ...lock ? { pid: lock.pid, startedAt: lock.mtime.toISOString() } : {},
-    ...lock && !running ? { staleLock: true } : {},
-    state,
-    ...retryAt ? { backoffUntil: retryAt.toISOString() } : {},
-    recentActivity: recentSyncActivity(readLog())
-  };
-}
-var ACTIVITY_LINES = 10;
-var init_status = __esm(() => {
-  init_config();
-  init_logger();
-  init_lock();
-  init_watermark();
-});
-
 // src/sessions/project-dir.ts
 import {
   closeSync as closeSync2,
-  existsSync as existsSync11,
-  mkdirSync as mkdirSync7,
+  existsSync as existsSync9,
+  mkdirSync as mkdirSync6,
   openSync as openSync2,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync9,
   readSync,
-  renameSync as renameSync3,
-  statSync as statSync5,
-  writeFileSync as writeFileSync8
+  renameSync as renameSync2,
+  statSync as statSync3,
+  writeFileSync as writeFileSync6
 } from "node:fs";
-import { join as join10 } from "node:path";
+import { join as join8 } from "node:path";
 function cachePath(configDir) {
-  return join10(configDir, CACHE_FILENAME2);
+  return join8(configDir, CACHE_FILENAME2);
 }
 function loadCacheFile(configDir) {
   try {
-    const raw = JSON.parse(readFileSync12(cachePath(configDir), "utf-8"));
+    const raw = JSON.parse(readFileSync9(cachePath(configDir), "utf-8"));
     if (raw.schema_version !== CACHE_SCHEMA_VERSION || typeof raw.entries !== "object")
       return {};
     return raw.entries;
@@ -8607,13 +8374,13 @@ function loadCacheFile(configDir) {
 }
 function saveCacheFile(configDir, entries) {
   try {
-    if (!existsSync11(configDir))
-      mkdirSync7(configDir, { recursive: true, mode: 448 });
+    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 };
-    writeFileSync8(tmp, JSON.stringify(file), { mode: 384 });
-    renameSync3(tmp, path3);
+    writeFileSync6(tmp, JSON.stringify(file), { mode: 384 });
+    renameSync2(tmp, path3);
   } catch {}
 }
 function readHead(path3, bytes = HEAD_BYTES) {
@@ -8647,7 +8414,7 @@ function cwdFromJsonlHead(text) {
   }
   return null;
 }
-function unmungeSlug(slug, exists = existsSync11) {
+function unmungeSlug(slug, exists = existsSync9) {
   const tokens = slug.replace(/^-/, "").split("-");
   if (tokens.length === 0 || tokens[0] === "")
     return null;
@@ -8666,13 +8433,13 @@ function unmungeSlug(slug, exists = existsSync11) {
 }
 function fileMtime(path3) {
   try {
-    return statSync5(path3).mtime.toISOString();
+    return statSync3(path3).mtime.toISOString();
   } catch {
     return "";
   }
 }
 function createProjectDirResolver(configDir = getConfigDir(), deps = {}) {
-  const exists = deps.exists ?? existsSync11;
+  const exists = deps.exists ?? existsSync9;
   const head = deps.readHead ?? readHead;
   const mtime = deps.mtime ?? fileMtime;
   const entries = loadCacheFile(configDir);
@@ -8725,15 +8492,15 @@ var init_project_dir = __esm(() => {
 });
 
 // src/sessions/scan.ts
-import { existsSync as existsSync12, readdirSync, statSync as statSync6 } 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 join11 } 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: join11(dir, entry.name),
+      path: join9(dir, entry.name),
       isDir: entry.isDirectory()
     }));
   } catch {
@@ -8746,7 +8513,7 @@ function sessionFromFile(filePath, harness, project) {
     return null;
   let mtime;
   try {
-    mtime = statSync6(filePath).mtime;
+    mtime = statSync4(filePath).mtime;
   } catch {
     return null;
   }
@@ -8760,7 +8527,7 @@ function sessionFromFile(filePath, harness, project) {
 }
 function scanClaude(home) {
   const sessions = [];
-  for (const project of listDir(join11(home, ".claude", "projects"))) {
+  for (const project of listDir(join9(home, ".claude", "projects"))) {
     if (!project.isDir)
       continue;
     for (const entry of listDir(project.path)) {
@@ -8775,10 +8542,10 @@ function scanClaude(home) {
 }
 function scanCursor(home) {
   const sessions = [];
-  for (const project of listDir(join11(home, ".cursor", "projects"))) {
+  for (const project of listDir(join9(home, ".cursor", "projects"))) {
     if (!project.isDir)
       continue;
-    for (const entry of listDir(join11(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);
@@ -8790,9 +8557,9 @@ function scanCursor(home) {
   return sessions;
 }
 function scanCodex(home, env) {
-  const codexHome2 = env.CODEX_HOME ?? join11(home, ".codex");
+  const codexHome2 = env.CODEX_HOME ?? join9(home, ".codex");
   const sessions = [];
-  for (const year of listDir(join11(codexHome2, "sessions"))) {
+  for (const year of listDir(join9(codexHome2, "sessions"))) {
     if (!year.isDir)
       continue;
     for (const month of listDir(year.path)) {
@@ -8848,9 +8615,9 @@ function querySqlite(dbPath, sql) {
   }
 }
 function scanOpencode(home, env) {
-  const dataDir = env.XDG_DATA_HOME ?? join11(home, ".local", "share");
-  const dbPath = join11(dataDir, "opencode", "opencode.db");
-  if (!existsSync12(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)
@@ -8887,6 +8654,291 @@ function scanAgentSessions(options = {}) {
 }
 var init_scan = () => {};
 
+// src/sync/watermark.ts
+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 join10(configDir, STATE_FILENAME);
+}
+function loadSyncState(configDir = getConfigDir()) {
+  const empty = {
+    schema_version: STATE_SCHEMA_VERSION,
+    watermark: null,
+    consecutive_failures: 0
+  };
+  const path3 = syncStatePath(configDir);
+  if (!existsSync11(path3))
+    return empty;
+  try {
+    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) => ({
+      at: record.at,
+      session: record.session,
+      ...typeof record.project === "string" ? { project: record.project } : {}
+    })) : [];
+    const rawRefusal = raw.last_refusal;
+    const lastRefusal = rawRefusal && typeof rawRefusal.at === "string" && typeof rawRefusal.outcome === "string" && typeof rawRefusal.message === "string" ? { at: rawRefusal.at, outcome: rawRefusal.outcome, message: rawRefusal.message } : undefined;
+    const rawRun = raw.run;
+    const run2 = rawRun && typeof rawRun.pid === "number" && typeof rawRun.started_at === "string" && typeof rawRun.baseline_mined === "number" && rawRun.baseline_mined >= 0 ? { pid: rawRun.pid, started_at: rawRun.started_at, baseline_mined: rawRun.baseline_mined } : undefined;
+    return {
+      schema_version: STATE_SCHEMA_VERSION,
+      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,
+      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 } : {},
+      ...run2 ? { run: run2 } : {},
+      ...raw.paused === true ? { paused: true } : {},
+      ...Array.isArray(raw.project_filter) ? {
+        project_filter: raw.project_filter.filter((p2) => typeof p2 === "string")
+      } : {}
+    };
+  } catch {
+    return empty;
+  }
+}
+function setSyncPaused(paused, configDir = getConfigDir()) {
+  const state = loadSyncState(configDir);
+  if (paused)
+    state.paused = true;
+  else
+    delete state.paused;
+  saveSyncState(state, configDir);
+}
+function saveSyncState(state, configDir = getConfigDir()) {
+  if (!existsSync11(configDir))
+    mkdirSync7(configDir, { recursive: true, mode: 448 });
+  const path3 = syncStatePath(configDir);
+  const tmp = `${path3}.${process.pid}.tmp`;
+  writeFileSync7(tmp, JSON.stringify(state, null, 2), { mode: 384 });
+  renameSync3(tmp, path3);
+}
+function backoffUntil(state) {
+  if (state.consecutive_failures === 0 || !state.last_attempt_at)
+    return null;
+  const last = Date.parse(state.last_attempt_at);
+  if (Number.isNaN(last))
+    return null;
+  const delay = Math.min(BACKOFF_BASE_MS * 2 ** (state.consecutive_failures - 1), BACKOFF_MAX_MS);
+  return new Date(last + delay);
+}
+function isUnderDir(dir, base) {
+  const root = base.endsWith("/") ? base.slice(0, -1) : base;
+  return dir === root || dir.startsWith(`${root}/`);
+}
+function filterSessionsByProject(sessions, filter, resolveDir) {
+  if (!filter || filter.length === 0)
+    return [...sessions];
+  const includeUnknown = filter.includes(UNKNOWN_PROJECT);
+  const dirs = filter.filter((entry) => entry !== UNKNOWN_PROJECT);
+  return sessions.filter((session) => {
+    const dir = resolveDir(session);
+    if (!dir)
+      return includeUnknown;
+    return dirs.some((base) => isUnderDir(dir, base));
+  });
+}
+function gateSessions(sessions, watermark, now = new Date, quietPeriodMs = DEFAULT_QUIET_PERIOD_MS) {
+  const watermarkMs = watermark ? Date.parse(watermark) : Number.NEGATIVE_INFINITY;
+  const completedBefore = now.getTime() - quietPeriodMs;
+  const ready = [];
+  const open2 = [];
+  for (const session of sessions) {
+    const updated = Date.parse(session.updated);
+    if (Number.isNaN(updated) || updated <= watermarkMs)
+      continue;
+    if (updated > completedBefore) {
+      open2.push(session);
+    } else {
+      ready.push(session);
+    }
+  }
+  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 init_watermark = __esm(() => {
+  init_config();
+  DEFAULT_QUIET_PERIOD_MS = 5 * 60 * 1000;
+  BACKOFF_BASE_MS = 15 * 60 * 1000;
+  BACKOFF_MAX_MS = 24 * 60 * 60 * 1000;
+});
+
+// src/sync/backlog.ts
+function listSessionBacklog() {
+  try {
+    const state = loadSyncState();
+    let sessions = scanAgentSessions({});
+    if (state.project_filter?.length) {
+      const resolver = createProjectDirResolver();
+      sessions = filterSessionsByProject(sessions, state.project_filter, resolver.resolve);
+      resolver.flush();
+    }
+    const gate = gateSessions(sessions, state.watermark);
+    return { queued: gate.ready.reverse(), open: gate.open.reverse() };
+  } catch {
+    return { queued: [], open: [] };
+  }
+}
+var init_backlog = __esm(() => {
+  init_project_dir();
+  init_scan();
+  init_watermark();
+});
+
+// src/sync/lock.ts
+import { existsSync as existsSync12, readFileSync as readFileSync11, rmSync as rmSync2, statSync as statSync5, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join11 } from "node:path";
+function processAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code === "EPERM";
+  }
+}
+function lockPath(configDir = getConfigDir()) {
+  return join11(configDir, LOCK_FILENAME);
+}
+function stopSyncRun(pid, configDir = getConfigDir(), kill = process.kill.bind(process)) {
+  if (!Number.isInteger(pid) || pid <= 0)
+    return false;
+  let killed = false;
+  try {
+    kill(-pid, "SIGTERM");
+    killed = true;
+  } catch {
+    try {
+      kill(pid, "SIGTERM");
+      killed = true;
+    } catch {}
+  }
+  try {
+    const path3 = lockPath(configDir);
+    if (existsSync12(path3) && readFileSync11(path3, "utf8") === String(pid)) {
+      rmSync2(path3, { force: true });
+    }
+  } catch {}
+  return killed;
+}
+function fileLock(configDir = getConfigDir(), now = () => new Date) {
+  const path3 = lockPath(configDir);
+  let held = false;
+  const tryCreate = () => {
+    try {
+      writeFileSync8(path3, String(process.pid), { flag: "wx" });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  return {
+    acquire() {
+      if (tryCreate()) {
+        held = true;
+        return true;
+      }
+      try {
+        const age = now().getTime() - statSync5(path3).mtimeMs;
+        const holder = Number.parseInt(readFileSync11(path3, "utf8"), 10);
+        const holderDead = Number.isInteger(holder) && holder > 0 && !processAlive(holder);
+        if (age > STALE_LOCK_MS || holderDead) {
+          rmSync2(path3, { force: true });
+          held = tryCreate();
+          return held;
+        }
+      } catch {}
+      return false;
+    },
+    release() {
+      if (!held)
+        return;
+      held = false;
+      try {
+        if (existsSync12(path3) && readFileSync11(path3, "utf8") === String(process.pid)) {
+          rmSync2(path3, { force: true });
+        }
+      } catch {}
+    }
+  };
+}
+var LOCK_FILENAME = "knowledge-sync.lock", STALE_LOCK_MS;
+var init_lock = __esm(() => {
+  init_config();
+  STALE_LOCK_MS = 15 * 60 * 1000;
+});
+
+// src/sync/status.ts
+import { readFileSync as readFileSync12, statSync as statSync6 } from "node:fs";
+function formatTokenCount(tokens) {
+  if (tokens < 1000)
+    return String(tokens);
+  if (tokens < 1e6) {
+    const k = tokens / 1000;
+    return `~${k >= 100 ? Math.round(k) : k.toFixed(1).replace(/\.0$/, "")}k`;
+  }
+  const m3 = tokens / 1e6;
+  return `~${m3 >= 100 ? Math.round(m3) : m3.toFixed(1).replace(/\.0$/, "")}M`;
+}
+function defaultIsProcessAlive2(pid) {
+  if (!Number.isInteger(pid) || pid <= 0)
+    return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code === "EPERM";
+  }
+}
+function defaultReadLog() {
+  try {
+    return readFileSync12(logger.getLogPath(), "utf-8");
+  } catch {
+    return "";
+  }
+}
+function readLockFile(configDir) {
+  const path3 = lockPath(configDir);
+  try {
+    const pid = Number.parseInt(readFileSync12(path3, "utf-8"), 10);
+    return { pid: Number.isNaN(pid) ? -1 : pid, mtime: statSync6(path3).mtime };
+  } catch {
+    return null;
+  }
+}
+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)\]/, ""));
+}
+function getSyncStatus(deps = {}) {
+  const configDir = deps.configDir ?? getConfigDir();
+  const isProcessAlive = deps.isProcessAlive ?? defaultIsProcessAlive2;
+  const readLog = deps.readLog ?? defaultReadLog;
+  const lock = readLockFile(configDir);
+  const running = lock !== null && isProcessAlive(lock.pid);
+  const state = loadSyncState(configDir);
+  const retryAt = backoffUntil(state);
+  return {
+    running,
+    ...lock ? { pid: lock.pid, startedAt: lock.mtime.toISOString() } : {},
+    ...lock && !running ? { staleLock: true } : {},
+    state,
+    ...retryAt ? { backoffUntil: retryAt.toISOString() } : {},
+    recentActivity: recentSyncActivity(readLog())
+  };
+}
+var ACTIVITY_LINES = 10;
+var init_status = __esm(() => {
+  init_config();
+  init_logger();
+  init_lock();
+  init_watermark();
+});
+
 // src/sessions/read.ts
 import { readFileSync as readFileSync13 } from "node:fs";
 function asRecord(value) {
@@ -9062,11 +9114,18 @@ async function runKnowledgeSync(options = {}) {
   const now = deps.now ?? (() => new Date);
   const state = loadState();
   if (options.quiet) {
+    if (state.paused) {
+      logger.debug("sync", "skipping quiet sync: mining is paused");
+      return { status: "skipped-paused", readySessions: 0, inFlightSessions: 0, sessions: [] };
+    }
     const retryAt = backoffUntil(state);
     if (retryAt && now() < retryAt) {
       logger.debug("sync", `skipping quiet sync: backoff until ${retryAt.toISOString()}`);
       return { status: "skipped-backoff", readySessions: 0, inFlightSessions: 0, sessions: [] };
     }
+  } else if (state.paused) {
+    delete state.paused;
+    logger.debug("sync", "manual sync resumes paused mining");
   }
   let ready;
   let open2;
@@ -9420,20 +9479,12 @@ Read each session with read_session, decide what (if anything) is durable per yo
 }
 
 // src/miner/prompt-core.ts
-function extractMinerCore(markdown) {
-  const start = markdown.indexOf(MINER_CORE_START);
-  const end = markdown.indexOf(MINER_CORE_END);
-  if (start === -1 || end === -1 || end <= start) {
-    throw new Error(`miner-core markers not found (expected ${MINER_CORE_START} … ${MINER_CORE_END})`);
-  }
-  return markdown.slice(start + MINER_CORE_START.length, end).trim();
-}
-var MINER_CORE_START = "<!-- dosu:miner-core:start -->", MINER_CORE_END = "<!-- dosu:miner-core:end -->";
-
-// src/miner/prompt-core.generated.ts
 var MINER_CORE_RULES = `Rules — non-negotiable:
-1. Before writing anything, call read_knowledge with the candidate topic to check whether the
-knowledge already exists. Never write a duplicate or near-duplicate.
+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
+and what changed. Only restatements of already-recorded facts are duplicates; an update to an
+existing topic is not.
 2. Write ONLY durable, non-obvious knowledge:
 - decisions and their rationale (chose A over B because ...)
 - non-obvious constraints (API, schema, RLS, feature flags, deploy quirks)
@@ -9461,43 +9512,6 @@ verified, omit both.
 long verbatim transcript spans. Summarize in your own words.
 9. A trivial session with no real user query is normal: skip it silently.`;
 
-// src/miner/prompt-source.ts
-import { readFileSync as readFileSync15 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
-import { join as join14 } from "node:path";
-function candidateSkillPromptPaths(env = process.env) {
-  const paths = [];
-  if (env.DOSU_SKILL_REPO?.trim()) {
-    paths.push(join14(env.DOSU_SKILL_REPO.trim(), "skills", SKILL_PROMPT_RELPATH));
-  }
-  paths.push(join14(homedir5(), ".agents", "skills", SKILL_PROMPT_RELPATH));
-  const claudeConfigDir = env.CLAUDE_CONFIG_DIR?.trim() || join14(homedir5(), ".claude");
-  paths.push(join14(claudeConfigDir, "skills", SKILL_PROMPT_RELPATH));
-  paths.push(join14(homedir5(), ".codeium", "windsurf", "skills", SKILL_PROMPT_RELPATH));
-  return paths;
-}
-function resolveMinerCoreRules(env = process.env) {
-  for (const path3 of candidateSkillPromptPaths(env)) {
-    let markdown;
-    try {
-      markdown = readFileSync15(path3, "utf-8");
-    } catch {
-      continue;
-    }
-    try {
-      return { rules: extractMinerCore(markdown), source: path3 };
-    } catch (err) {
-      logger.debug("miner", `skipping unusable skill rules at ${path3}: ${err}`);
-    }
-  }
-  return { rules: MINER_CORE_RULES, source: "bundled" };
-}
-var SKILL_PROMPT_RELPATH;
-var init_prompt_source = __esm(() => {
-  init_logger();
-  SKILL_PROMPT_RELPATH = join14("log-to-dosu-knowledge", "references", "miner-system-prompt.md");
-});
-
 // node_modules/@anthropic-ai/claude-agent-sdk/sdk.mjs
 var exports_sdk = {};
 __export(exports_sdk, {
@@ -71410,13 +71424,11 @@ async function runMiner(options) {
     cliVersion: getVersionString(),
     deploymentID: options.deploymentID
   });
-  const coreRules = resolveMinerCoreRules();
-  logger.debug("miner", `write-knowledge rules source: ${coreRules.source}`);
   try {
     const run2 = query({
       prompt: buildMinerPrompt(options.sessions),
       options: {
-        systemPrompt: buildMinerSystemPrompt(coreRules.rules),
+        systemPrompt: buildMinerSystemPrompt(MINER_CORE_RULES),
         env,
         abortController: abort,
         maxTurns: options.maxTurns ?? DEFAULT_MAX_TURNS,
@@ -71517,7 +71529,6 @@ var init_runner = __esm(() => {
   init_conflicts();
   init_env();
   init_executable();
-  init_prompt_source();
   init_tools();
   DEFAULT_TIMEOUT_MS2 = 30 * 60 * 1000;
   GATEWAY_ERRORS = {
@@ -71537,17 +71548,17 @@ var init_runner = __esm(() => {
 });
 
 // src/version/skill-update-check.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync9, readFileSync as readFileSync18, writeFileSync as writeFileSync10 } from "node:fs";
-import { join as join20 } from "node:path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync9, readFileSync as readFileSync17, writeFileSync as writeFileSync10 } from "node:fs";
+import { join as join19 } from "node:path";
 function getCachePath2() {
-  return join20(getConfigDir(), CACHE_FILENAME3);
+  return join19(getConfigDir(), CACHE_FILENAME3);
 }
 function readSkillCache() {
   try {
     const path3 = getCachePath2();
     if (!existsSync17(path3))
       return null;
-    const data = JSON.parse(readFileSync18(path3, "utf-8"));
+    const data = JSON.parse(readFileSync17(path3, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestSha === "string" && typeof data.installedSha === "string") {
       return data;
     }
@@ -71635,8 +71646,8 @@ var init_skill_update_check = __esm(() => {
 
 // src/commands/skill.ts
 import { exec as exec2, execSync as execSync2 } from "node:child_process";
-import { homedir as homedir7 } from "node:os";
-import { join as join21 } from "node:path";
+import { homedir as homedir6 } from "node:os";
+import { join as join20 } from "node:path";
 function skillAgentIDsForProviders(providerIDs) {
   return [
     ...new Set(providerIDs.map((providerID) => SKILL_AGENT_BY_PROVIDER[providerID]).filter((agent) => Boolean(agent)))
@@ -71647,17 +71658,17 @@ function skillInstallTargetForProvider(providerID) {
   if (!agentID)
     return null;
   if (agentID === "claude-code") {
-    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join21(homedir7(), ".claude");
-    return { path: join21(claudeConfigDir, "skills", SKILL_NAME), symlink: true };
+    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join20(homedir6(), ".claude");
+    return { path: join20(claudeConfigDir, "skills", SKILL_NAME), symlink: true };
   }
   if (agentID === "windsurf") {
     return {
-      path: join21(homedir7(), ".codeium", "windsurf", "skills", SKILL_NAME),
+      path: join20(homedir6(), ".codeium", "windsurf", "skills", SKILL_NAME),
       symlink: true
     };
   }
   return {
-    path: join21(homedir7(), ".agents", "skills", SKILL_NAME),
+    path: join20(homedir6(), ".agents", "skills", SKILL_NAME),
     symlink: false
   };
 }
@@ -71819,14 +71830,14 @@ import {
   existsSync as existsSync18,
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync10,
-  readFileSync as readFileSync19,
+  readFileSync as readFileSync18,
   renameSync as renameSync5,
   unlinkSync as unlinkSync3,
   writeFileSync as writeFileSync11
 } from "node:fs";
-import { join as join22 } from "node:path";
+import { join as join21 } from "node:path";
 function getTelemetrySettingsPath() {
-  return join22(getConfigDir(), TELEMETRY_SETTINGS_FILENAME);
+  return join21(getConfigDir(), TELEMETRY_SETTINGS_FILENAME);
 }
 function loadTelemetrySettings() {
   return readTelemetrySettings().settings;
@@ -71894,7 +71905,7 @@ function readTelemetrySettings() {
   }
   let content;
   try {
-    content = readFileSync19(path3, "utf-8");
+    content = readFileSync18(path3, "utf-8");
   } catch {
     return { status: "error", settings: disabledTelemetrySettings() };
   }
@@ -71972,7 +71983,7 @@ var init_settings = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "49488d75-f9b7-7b0e-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "858ed0b9-5f8c-23ca-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
@@ -72840,7 +72851,7 @@ var init_antigravity = __esm(() => {
 });
 
 // src/mcp/providers/claude.ts
-import { join as join23 } from "node:path";
+import { join as join22 } from "node:path";
 var ClaudeProvider = () => createJSONProvider({
   providerName: "Claude Code",
   providerID: "claude",
@@ -72849,24 +72860,24 @@ var ClaudeProvider = () => createJSONProvider({
   paths: ["~/.claude"],
   globalPath: "~/.claude.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join23(cwd, ".mcp.json")
+  localConfigPath: (cwd) => join22(cwd, ".mcp.json")
 });
 var init_claude = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/claude-desktop.ts
-import { join as join24 } from "node:path";
+import { join as join23 } from "node:path";
 function configPath() {
-  return join24(appSupportDir(), "Claude", "claude_desktop_config.json");
+  return join23(appSupportDir(), "Claude", "claude_desktop_config.json");
 }
 var ClaudeDesktopProvider = () => ({
   name: () => "Claude Desktop",
   id: () => "claude-desktop",
   supportsLocal: () => false,
   priority: () => 2,
-  detectPaths: () => [join24(appSupportDir(), "Claude")],
-  isInstalled: () => isInstalled([join24(appSupportDir(), "Claude")]),
+  detectPaths: () => [join23(appSupportDir(), "Claude")],
+  isInstalled: () => isInstalled([join23(appSupportDir(), "Claude")]),
   globalConfigPath: () => configPath(),
   isConfigured: () => isJSONKeyConfigured(configPath(), "mcpServers"),
   install(cfg, global2) {
@@ -72896,14 +72907,14 @@ var init_claude_desktop = __esm(() => {
 });
 
 // src/mcp/providers/cline.ts
-import { join as join25 } from "node:path";
-var extensionDir = () => join25(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
+import { join as join24 } from "node:path";
+var extensionDir = () => join24(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
   providerName: "Cline",
   providerID: "cline",
   local: false,
   priorityValue: 11,
   paths: [extensionDir()],
-  globalPath: join25(extensionDir(), "settings", "cline_mcp_settings.json"),
+  globalPath: join24(extensionDir(), "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.active_account.target.deployment_id),
@@ -72919,7 +72930,7 @@ var init_cline = __esm(() => {
 });
 
 // src/mcp/providers/cline-cli.ts
-import { join as join26 } from "node:path";
+import { join as join25 } from "node:path";
 function clineDir() {
   return process.env.CLINE_DIR ?? expandHome("~/.cline");
 }
@@ -72929,7 +72940,7 @@ var ClineCliProvider = () => createJSONProvider({
   local: false,
   priorityValue: 12,
   paths: [clineDir()],
-  globalPath: join26(clineDir(), "data", "settings", "cline_mcp_settings.json"),
+  globalPath: join25(clineDir(), "data", "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.active_account.target.deployment_id),
@@ -72945,20 +72956,20 @@ var init_cline_cli = __esm(() => {
 });
 
 // src/mcp/providers/codex.ts
-import { existsSync as existsSync20, readFileSync as readFileSync20 } from "node:fs";
-import { join as join27 } from "node:path";
+import { existsSync as existsSync20, readFileSync as readFileSync19 } from "node:fs";
+import { join as join26 } from "node:path";
 function codexHome2() {
   return process.env.CODEX_HOME ?? expandHome("~/.codex");
 }
 function getConfigPath2(global2) {
   if (global2)
-    return join27(codexHome2(), "config.toml");
-  return join27(process.cwd(), ".codex", "config.toml");
+    return join26(codexHome2(), "config.toml");
+  return join26(process.cwd(), ".codex", "config.toml");
 }
 function readTOML(path3) {
   if (!existsSync20(path3))
     return "";
-  return readFileSync20(path3, "utf-8");
+  return readFileSync19(path3, "utf-8");
 }
 function writeTOML(path3, content) {
   writeSecureFile(path3, content);
@@ -73021,9 +73032,9 @@ var CodexProvider = () => ({
   priority: () => 8,
   detectPaths: () => ["~/.codex"],
   isInstalled: () => isInstalled(["~/.codex"]),
-  globalConfigPath: () => join27(codexHome2(), "config.toml"),
+  globalConfigPath: () => join26(codexHome2(), "config.toml"),
   isConfigured: () => {
-    const content = readTOML(join27(codexHome2(), "config.toml"));
+    const content = readTOML(join26(codexHome2(), "config.toml"));
     return content.includes("[mcp_servers.dosu]");
   },
   install(cfg, global2) {
@@ -73045,10 +73056,10 @@ var init_codex = __esm(() => {
 });
 
 // src/mcp/providers/copilot.ts
-import { join as join28 } from "node:path";
+import { join as join27 } from "node:path";
 function globalPath() {
   if (process.env.XDG_CONFIG_HOME) {
-    return join28(process.env.XDG_CONFIG_HOME, "mcp-config.json");
+    return join27(process.env.XDG_CONFIG_HOME, "mcp-config.json");
   }
   return expandHome("~/.copilot/mcp-config.json");
 }
@@ -73079,7 +73090,7 @@ var CopilotProvider = () => ({
       };
       installJSONServer(globalPath(), "mcpServers", server);
     } else {
-      const configPath2 = join28(process.cwd(), ".vscode", "mcp.json");
+      const configPath2 = join27(process.cwd(), ".vscode", "mcp.json");
       const server = {
         type: "http",
         url: url2,
@@ -73092,7 +73103,7 @@ var CopilotProvider = () => ({
     if (global2) {
       removeJSONServer(globalPath(), "mcpServers");
     } else {
-      const configPath2 = join28(process.cwd(), ".vscode", "mcp.json");
+      const configPath2 = join27(process.cwd(), ".vscode", "mcp.json");
       removeJSONServer(configPath2, "servers");
     }
   }
@@ -73104,7 +73115,7 @@ var init_copilot = __esm(() => {
 });
 
 // src/mcp/providers/cursor.ts
-import { join as join29 } from "node:path";
+import { join as join28 } from "node:path";
 var CursorProvider = () => createJSONProvider({
   providerName: "Cursor",
   providerID: "cursor",
@@ -73117,7 +73128,7 @@ var CursorProvider = () => createJSONProvider({
     url: mcpURL(cfg.active_account.target.deployment_id),
     headers: mcpHeaders(cfg.active_account.target.api_key)
   }),
-  localConfigPath: (cwd) => join29(cwd, ".cursor", "mcp.json")
+  localConfigPath: (cwd) => join28(cwd, ".cursor", "mcp.json")
 });
 var init_cursor = __esm(() => {
   init_config_helpers();
@@ -73125,7 +73136,7 @@ var init_cursor = __esm(() => {
 });
 
 // src/mcp/providers/factory.ts
-import { join as join30 } from "node:path";
+import { join as join29 } from "node:path";
 var FactoryProvider = () => createJSONProvider({
   providerName: "Factory",
   providerID: "factory",
@@ -73134,14 +73145,14 @@ var FactoryProvider = () => createJSONProvider({
   paths: ["~/.factory"],
   globalPath: "~/.factory/mcp.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join30(cwd, ".factory", "mcp.json")
+  localConfigPath: (cwd) => join29(cwd, ".factory", "mcp.json")
 });
 var init_factory = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/gemini.ts
-import { join as join31 } from "node:path";
+import { join as join30 } from "node:path";
 var GeminiProvider = () => createJSONProvider({
   providerName: "Gemini CLI",
   providerID: "gemini",
@@ -73150,7 +73161,7 @@ var GeminiProvider = () => createJSONProvider({
   paths: ["~/.gemini"],
   globalPath: "~/.gemini/settings.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join31(cwd, ".gemini", "settings.json")
+  localConfigPath: (cwd) => join30(cwd, ".gemini", "settings.json")
 });
 var init_gemini = __esm(() => {
   init_base();
@@ -73201,7 +73212,7 @@ var init_manual = __esm(() => {
 
 // src/mcp/providers/mcporter.ts
 import { existsSync as existsSync21 } from "node:fs";
-import { join as join32 } from "node:path";
+import { join as join31 } from "node:path";
 function resolveGlobalConfigPath() {
   const jsonPath = expandHome("~/.mcporter/mcporter.json");
   if (existsSync21(jsonPath))
@@ -73228,7 +73239,7 @@ var MCPorterProvider = () => ({
   globalConfigPath: () => resolveGlobalConfigPath(),
   isConfigured: () => isJSONKeyConfigured(resolveGlobalConfigPath(), "mcpServers"),
   install(cfg, global2) {
-    const configPath2 = global2 ? resolveGlobalConfigPath() : join32(process.cwd(), "config", "mcporter.json");
+    const configPath2 = global2 ? resolveGlobalConfigPath() : join31(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
       url: mcpEndpoint4(cfg),
@@ -73237,7 +73248,7 @@ var MCPorterProvider = () => ({
     installJSONServer(configPath2, "mcpServers", server);
   },
   remove(global2) {
-    const configPath2 = global2 ? resolveGlobalConfigPath() : join32(process.cwd(), "config", "mcporter.json");
+    const configPath2 = global2 ? resolveGlobalConfigPath() : join31(process.cwd(), "config", "mcporter.json");
     removeJSONServer(configPath2, "mcpServers");
   }
 });
@@ -73248,7 +73259,7 @@ var init_mcporter = __esm(() => {
 });
 
 // src/mcp/providers/opencode.ts
-import { join as join33 } from "node:path";
+import { join as join32 } from "node:path";
 var OpenCodeProvider = () => createJSONProvider({
   providerName: "OpenCode",
   providerID: "opencode",
@@ -73263,7 +73274,7 @@ var OpenCodeProvider = () => createJSONProvider({
     enabled: true,
     headers: mcpHeaders(cfg.active_account.target.api_key)
   }),
-  localConfigPath: (cwd) => join33(cwd, "opencode.json")
+  localConfigPath: (cwd) => join32(cwd, "opencode.json")
 });
 var init_opencode = __esm(() => {
   init_config_helpers();
@@ -73271,16 +73282,16 @@ var init_opencode = __esm(() => {
 });
 
 // src/mcp/providers/vscode.ts
-import { join as join34 } from "node:path";
+import { join as join33 } from "node:path";
 var VSCodeProvider = () => createJSONProvider({
   providerName: "VS Code",
   providerID: "vscode",
   local: true,
   priorityValue: 6,
-  paths: [join34(appSupportDir(), "Code")],
-  globalPath: join34(appSupportDir(), "Code", "User", "mcp.json"),
+  paths: [join33(appSupportDir(), "Code")],
+  globalPath: join33(appSupportDir(), "Code", "User", "mcp.json"),
   topKey: "servers",
-  localConfigPath: (cwd) => join34(cwd, ".vscode", "mcp.json")
+  localConfigPath: (cwd) => join33(cwd, ".vscode", "mcp.json")
 });
 var init_vscode = __esm(() => {
   init_detect();
@@ -73288,15 +73299,15 @@ var init_vscode = __esm(() => {
 });
 
 // src/mcp/providers/windsurf.ts
-import { homedir as homedir9 } from "node:os";
-import { join as join35 } from "node:path";
+import { homedir as homedir8 } from "node:os";
+import { join as join34 } from "node:path";
 var WindsurfProvider = () => createJSONProvider({
   providerName: "Windsurf",
   providerID: "windsurf",
   local: false,
   priorityValue: 9,
-  paths: [join35(homedir9(), ".codeium", "windsurf")],
-  globalPath: join35(homedir9(), ".codeium", "windsurf", "mcp_config.json"),
+  paths: [join34(homedir8(), ".codeium", "windsurf")],
+  globalPath: join34(homedir8(), ".codeium", "windsurf", "mcp_config.json"),
   topKey: "mcpServers"
 });
 var init_windsurf = __esm(() => {
@@ -73305,12 +73316,12 @@ var init_windsurf = __esm(() => {
 
 // src/mcp/providers/zed.ts
 import { platform as platform3 } from "node:os";
-import { join as join36 } from "node:path";
+import { join as join35 } from "node:path";
 function zedConfigDir() {
   const os3 = platform3();
   if (os3 === "darwin" || os3 === "win32")
-    return join36(appSupportDir(), "Zed");
-  return join36(appSupportDir(), "zed");
+    return join35(appSupportDir(), "Zed");
+  return join35(appSupportDir(), "zed");
 }
 var ZedProvider = () => createJSONProvider({
   providerName: "Zed",
@@ -73318,7 +73329,7 @@ var ZedProvider = () => createJSONProvider({
   local: true,
   priorityValue: 10,
   paths: [zedConfigDir()],
-  globalPath: join36(zedConfigDir(), "settings.json"),
+  globalPath: join35(zedConfigDir(), "settings.json"),
   topKey: "context_servers",
   buildServer: (cfg) => ({
     source: "custom",
@@ -73326,7 +73337,7 @@ var ZedProvider = () => createJSONProvider({
     url: mcpURL(cfg.active_account.target.deployment_id),
     headers: mcpHeaders(cfg.active_account.target.api_key)
   }),
-  localConfigPath: (cwd) => join36(cwd, ".zed", "settings.json")
+  localConfigPath: (cwd) => join35(cwd, ".zed", "settings.json")
 });
 var init_zed = __esm(() => {
   init_config_helpers();
@@ -73385,8 +73396,8 @@ var init_providers = __esm(() => {
 });
 
 // src/version/update-check.ts
-import { existsSync as existsSync22, mkdirSync as mkdirSync11, readFileSync as readFileSync21, writeFileSync as writeFileSync12 } from "node:fs";
-import { join as join37 } from "node:path";
+import { existsSync as existsSync22, mkdirSync as mkdirSync11, readFileSync as readFileSync20, writeFileSync as writeFileSync12 } from "node:fs";
+import { join as join36 } from "node:path";
 function isValidVersion(value) {
   return typeof value === "string" && SEMVER_PATTERN.test(value);
 }
@@ -73408,14 +73419,14 @@ function isNewerVersion(latest, current) {
   return false;
 }
 function getCachePath3() {
-  return join37(getConfigDir(), CACHE_FILENAME4);
+  return join36(getConfigDir(), CACHE_FILENAME4);
 }
 function readCache() {
   try {
     const path3 = getCachePath3();
     if (!existsSync22(path3))
       return null;
-    const data = JSON.parse(readFileSync21(path3, "utf-8"));
+    const data = JSON.parse(readFileSync20(path3, "utf-8"));
     if (typeof data.lastCheck === "number" && isValidVersion(data.latestVersion)) {
       return data;
     }
@@ -73540,14 +73551,14 @@ var init_update_check = __esm(() => {
 });
 
 // src/rules/installer.ts
-import { existsSync as existsSync23, mkdirSync as mkdirSync12, readFileSync as readFileSync22, unlinkSync as unlinkSync4, writeFileSync as writeFileSync13 } from "node:fs";
-import { homedir as homedir10 } from "node:os";
-import { dirname as dirname8, join as join38 } from "node:path";
+import { existsSync as existsSync23, mkdirSync as mkdirSync12, readFileSync as readFileSync21, unlinkSync as unlinkSync4, writeFileSync as writeFileSync13 } from "node:fs";
+import { homedir as homedir9 } from "node:os";
+import { dirname as dirname8, join as join37 } from "node:path";
 function claudeConfigDir() {
-  return process.env.CLAUDE_CONFIG_DIR || join38(homedir10(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join37(homedir9(), ".claude");
 }
 function codexHome3() {
-  return process.env.CODEX_HOME || join38(homedir10(), ".codex");
+  return process.env.CODEX_HOME || join37(homedir9(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -73581,7 +73592,7 @@ function writeIfChanged(path3, content) {
     writeFileSync13(path3, content, "utf-8");
     return "created";
   }
-  if (readFileSync22(path3, "utf-8") === content)
+  if (readFileSync21(path3, "utf-8") === content)
     return "unchanged";
   writeFileSync13(path3, content, "utf-8");
   return "updated";
@@ -73616,7 +73627,7 @@ function upsertSection(path3, content) {
 `, "utf-8");
     return "created";
   }
-  const existing = readFileSync22(path3, "utf-8");
+  const existing = readFileSync21(path3, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const section = buildSection(content, lineEnding);
   const location = findSection(existing);
@@ -73652,7 +73663,7 @@ function removeRuleForAgent(agent) {
     unlinkSync4(path3);
     return { agent, path: path3, action: "removed" };
   }
-  const existing = readFileSync22(path3, "utf-8");
+  const existing = readFileSync21(path3, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const location = findSection(existing);
   if (!location)
@@ -73689,36 +73700,36 @@ var init_installer = __esm(() => {
   RULE_TARGETS = {
     claude: {
       kind: "file",
-      path: () => join38(claudeConfigDir(), "rules", "dosu.md")
+      path: () => join37(claudeConfigDir(), "rules", "dosu.md")
     },
     cursor: {
       kind: "file",
-      path: () => join38(homedir10(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join37(homedir9(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
       kind: "section",
-      path: () => join38(codexHome3(), "AGENTS.md")
+      path: () => join37(codexHome3(), "AGENTS.md")
     },
     opencode: {
       kind: "section",
-      path: () => join38(homedir10(), ".config", "opencode", "AGENTS.md")
+      path: () => join37(homedir9(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join38(homedir10(), ".gemini", "GEMINI.md")
+      path: () => join37(homedir9(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join38(homedir10(), ".gemini", "GEMINI.md")
+      path: () => join37(homedir9(), ".gemini", "GEMINI.md")
     }
   };
 });
 
 // src/setup/agents-md-step.ts
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync24, readFileSync as readFileSync23, writeFileSync as writeFileSync14 } from "node:fs";
-import { join as join39 } from "node:path";
+import { existsSync as existsSync24, readFileSync as readFileSync22, writeFileSync as writeFileSync14 } from "node:fs";
+import { join as join38 } from "node:path";
 function inGitWorkTree(cwd = process.cwd()) {
   try {
     const stdout2 = execSync3("git rev-parse --is-inside-work-tree", {
@@ -73732,10 +73743,10 @@ function inGitWorkTree(cwd = process.cwd()) {
 }
 function dosuAgentsSectionState(cwd = process.cwd()) {
   try {
-    const path3 = join39(cwd, "AGENTS.md");
+    const path3 = join38(cwd, "AGENTS.md");
     if (!existsSync24(path3))
       return "missing";
-    const content = readFileSync23(path3, "utf-8");
+    const content = readFileSync22(path3, "utf-8");
     const startMatch = content.match(SECTION_START_RE);
     if (!startMatch || !content.includes(DOSU_SECTION_END))
       return "missing";
@@ -73770,14 +73781,14 @@ function findSection2(content) {
   return { start, end };
 }
 function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RULE) {
-  const path3 = join39(cwd, "AGENTS.md");
+  const path3 = join38(cwd, "AGENTS.md");
   if (!existsSync24(path3)) {
     const section2 = buildDosuAgentsSection(content);
     writeFileSync14(path3, `${section2}
 `);
     return { path: path3, action: "created" };
   }
-  const existing = readFileSync23(path3, "utf-8");
+  const existing = readFileSync22(path3, "utf-8");
   const lineEnding = lineEndingFor2(existing);
   const section = renderDosuAgentsSection(content, lineEnding);
   const location = findSection2(existing);
@@ -73871,7 +73882,7 @@ var init_alt_screen = __esm(() => {
 });
 
 // src/tui/activity-view.ts
-import { readFileSync as readFileSync24 } from "node:fs";
+import { readFileSync as readFileSync23 } from "node:fs";
 function reduceActivityViewKey(key) {
   if (key === "q" || key === ESC7 || key === CTRL_C4)
     return "back";
@@ -73900,6 +73911,13 @@ function reduceSyncConfirmKey(key) {
     return "cancel";
   return "none";
 }
+function syncConfirmMode(status) {
+  if (status.running)
+    return "stop";
+  if (status.state.paused)
+    return "resume";
+  return "start";
+}
 function formatActivityLine(line, width) {
   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)
@@ -73928,21 +73946,6 @@ function formatQueuedRow(session) {
   const project = clip(session.project ?? "-", 28);
   return `${session.harness.padEnd(8)}  ${stamp}  ${project}  ${clip(session.id, 24)}`;
 }
-function defaultListBacklog() {
-  try {
-    const state = loadSyncState();
-    let sessions = scanAgentSessions({});
-    if (state.project_filter?.length) {
-      const resolver = createProjectDirResolver();
-      sessions = filterSessionsByProject(sessions, state.project_filter, resolver.resolve);
-      resolver.flush();
-    }
-    const gate = gateSessions(sessions, state.watermark);
-    return { queued: gate.ready.reverse(), open: gate.open.reverse() };
-  } catch {
-    return { queued: [], open: [] };
-  }
-}
 function windowList(lines, scroll, height = ACTIVITY_VIEW_LIST_LINES) {
   const clamped = Math.max(0, Math.min(scroll, Math.max(0, lines.length - height)));
   const end = lines.length - clamped;
@@ -74001,6 +74004,9 @@ function statusLine(status) {
     const pid = status.pid !== undefined ? ` (pid ${status.pid})` : "";
     return `⛏️ ${import_picocolors30.default.bold(brand("Mining 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")}`;
+  }
   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")}`;
   }
@@ -74044,15 +74050,17 @@ function wrapLine(text, width, indent = "  ") {
     out.push(line);
   return out;
 }
-function confirmBox(queuedCount, backlog, width) {
+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 = 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 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 maxInner = Math.max(20, Math.min(width, contentWidth()) - 4);
   const rows = [
-    `⛏ ${import_picocolors30.default.bold(brand("Start mining now?"))}`,
+    import_picocolors30.default.bold(brand(title)),
     ...wrapLine(scope, maxInner, "").map((line) => import_picocolors30.default.dim(line)),
     "",
-    `${import_picocolors30.default.bold("enter")} start · ${import_picocolors30.default.bold("esc")} cancel`
+    `${import_picocolors30.default.bold("enter")} ${verb} · ${import_picocolors30.default.bold("esc")} cancel`
   ];
   const inner = Math.min(maxInner, Math.max(...rows.map(visibleWidth)));
   const pad = (row) => row + " ".repeat(Math.max(0, inner - visibleWidth(row)));
@@ -74089,6 +74097,9 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     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),
     "",
@@ -74102,11 +74113,11 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     ...listRows,
     ...scrollParts.length > 0 ? [import_picocolors30.default.dim(scrollParts.join(" · "))] : [],
     "",
-    ...pane.confirm ? centerBlock(confirmBox(queued.length, backlog, width), width) : [
+    ...pane.confirm ? centerBlock(confirmBox(queued.length, backlog, width, pane.confirm), width) : [
       import_picocolors30.default.dim([
         "tab switch",
         "↑↓ scroll",
-        ...status.running ? [] : ["s sync now"],
+        status.running ? "s stop" : status.state.paused ? "s resume" : "s sync now",
         "esc back"
       ].join(" · "))
     ]
@@ -74116,7 +74127,7 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
 }
 function defaultReadLog2() {
   try {
-    return readFileSync24(logger.getLogPath(), "utf-8");
+    return readFileSync23(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -74130,7 +74141,9 @@ function runActivityView(io2 = {}) {
   const readLog = io2.readLog ?? defaultReadLog2;
   const createFollower = io2.createFollower ?? ((emit) => createLogFollower(logger.getLogPath(), emit));
   const startSync = io2.startSync ?? (() => spawnDetachedSelf(["knowledge", "sync", "--quiet", "--bootstrap"]));
-  const listBacklog = io2.listBacklog ?? defaultListBacklog;
+  const stopSync = io2.stopSync ?? stopSyncRun;
+  const setPaused = io2.setPaused ?? setSyncPaused;
+  const listBacklog = io2.listBacklog ?? listSessionBacklog;
   const pollMs = io2.pollMs ?? ACTIVITY_VIEW_POLL_MS;
   const seed = readLog();
   let activity = appendSyncActivity([], seed);
@@ -74138,7 +74151,7 @@ function runActivityView(io2 = {}) {
   let runProgress = foldRunProgress(null, seed);
   let tab = "activity";
   let scroll = 0;
-  let confirmSync = false;
+  let confirmSync = null;
   let status = getStatus();
   let sessions = listBacklog();
   let queuedWatermark = status.state.watermark;
@@ -74174,10 +74187,12 @@ function runActivityView(io2 = {}) {
       queuedWatermark = status.state.watermark;
       sessions = listBacklog();
     }
-    if (confirmSync && status.running)
-      confirmSync = false;
+    if ((confirmSync === "start" || confirmSync === "resume") && 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 }, sessions.queued, minedBeforeRun ?? 0, sessions.open, runProgress);
+    const frame = renderActivityFrame(status, activity, width, backlog, { tab, scroll, confirm: confirmSync ?? undefined }, sessions.queued, minedBeforeRun ?? 0, sessions.open, runProgress);
     if (frame === lastFrame)
       return;
     lastFrame = frame;
@@ -74221,14 +74236,25 @@ ${CLEAR_BELOW}`);
         if (confirmSync) {
           const decision = reduceSyncConfirmKey(key);
           if (decision === "start") {
-            confirmSync = false;
-            const ok2 = startSync();
-            const note = ok2 ? "[sync] sync requested · starting a background run" : "[sync] could not start a background run · try `dosu knowledge sync`";
+            const mode = confirmSync;
+            confirmSync = null;
+            let note;
+            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";
+            } else {
+              if (mode === "resume")
+                setPaused(false);
+              const ok2 = startSync();
+              note = ok2 ? "[sync] sync requested · starting a background run" : "[sync] could not start a background run · try `dosu knowledge sync`";
+            }
             activity = appendSyncActivity(activity, `[${new Date().toISOString()}] [INFO] ${note}
 `);
             draw();
           } else if (decision === "cancel") {
-            confirmSync = false;
+            confirmSync = null;
             draw();
           }
           continue;
@@ -74239,10 +74265,8 @@ ${CLEAR_BELOW}`);
           return;
         }
         if (action === "sync") {
-          if (!status.running) {
-            confirmSync = true;
-            draw();
-          }
+          confirmSync = syncConfirmMode(status);
+          draw();
         } else if (action === "tab" || action === "tab-back") {
           tab = cycleTab(tab, action === "tab" ? 1 : -1);
           scroll = 0;
@@ -74270,10 +74294,10 @@ var import_picocolors30, ESC7, HIDE_CURSOR3, SHOW_CURSOR3, CTRL_C4, KEY_UP4, KEY
 var init_activity_view = __esm(() => {
   init_follow();
   init_logger();
-  init_project_dir();
-  init_scan();
   init_styles();
+  init_backlog();
   init_detach();
+  init_lock();
   init_status();
   init_watermark();
   init_alt_screen();
@@ -75982,18 +76006,19 @@ function projectRows(state) {
     const key = record2.project ?? "(unknown)";
     byProject.set(key, (byProject.get(key) ?? 0) + 1);
   }
-  return [...byProject.entries()].sort((a9, b2) => b2[1] - a9[1]).map(([project, count]) => `${label(clip2(project, 24))}${count}`);
+  const data = [...byProject.entries()].sort((a9, b2) => b2[1] - a9[1]).map(([project, count]) => `${label(clip2(project, 24))}${count}`);
+  return data.length > 0 ? [`${label("Project")}Sessions`, ...data] : [];
 }
 function pageRows(pageStats) {
   const rows = [];
   if (pageStats && pageStats.topCited.length > 0) {
-    rows.push(`Top cited pages (${TOP_CITED_DAYS}d)`);
+    rows.push(`${label(`Top cited (${TOP_CITED_DAYS}d)`)}Citations`);
     for (const row of pageStats.topCited) {
       rows.push(`${label(clip2(row.title, 24))}${row.citation_count}`);
     }
   }
   if (pageStats && pageStats.topUpdated.length > 0) {
-    rows.push(...rows.length > 0 ? [""] : [], "Recently updated pages");
+    rows.push(...rows.length > 0 ? [""] : [], `${label("Recently updated")}Updated`);
     for (const row of pageStats.topUpdated) {
       rows.push(`${label(clip2(row.title, 24))}${row.updated_at.slice(0, 10)}`);
     }
@@ -76033,6 +76058,7 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
       ["projects", "Projects"],
       ["pages", "Pages"]
     ], tab, width, { spread: false }),
+    "",
     ...listRows,
     ...scrollParts.length > 0 ? [import_picocolors32.default.dim(scrollParts.join(" · "))] : [],
     "",
@@ -76131,7 +76157,7 @@ ${CLEAR_BELOW2}`);
     input2.on("data", onData);
   });
 }
-var import_picocolors32, ESC8, HIDE_CURSOR4, SHOW_CURSOR4, CTRL_C5, KEY_UP5, KEY_DOWN5, KEY_RIGHT4, KEY_LEFT4, CURSOR_HOME2, CLEAR_BELOW2, CLEAR_EOL2, ANALYTICS_VIEW_POLL_MS = 1000, ANALYTICS_VIEW_LINES = 12, ANALYTICS_VIEW_TABS, TOP_PAGES_LIMIT = 5, TOP_CITED_DAYS = 30, label = (text) => text.padEnd(26);
+var import_picocolors32, ESC8, HIDE_CURSOR4, SHOW_CURSOR4, CTRL_C5, KEY_UP5, KEY_DOWN5, KEY_RIGHT4, KEY_LEFT4, CURSOR_HOME2, CLEAR_BELOW2, CLEAR_EOL2, ANALYTICS_VIEW_POLL_MS = 1000, ANALYTICS_VIEW_LINES = 14, ANALYTICS_VIEW_TABS, TOP_PAGES_LIMIT = 5, TOP_CITED_DAYS = 30, label = (text) => text.padEnd(26);
 var init_analytics_view = __esm(() => {
   init_trpc();
   init_config();
@@ -76586,7 +76612,7 @@ __export(exports_tui, {
   runTUI: () => runTUI,
   handleLogout: () => handleLogout
 });
-import { homedir as homedir11 } from "node:os";
+import { homedir as homedir10 } from "node:os";
 import { basename as basename4 } from "node:path";
 function bannerContext(cfg) {
   let webAppHost = "app.dosu.dev";
@@ -76812,7 +76838,7 @@ async function runSettings(cfg) {
   }
 }
 function displayDir(dir) {
-  const home = homedir11();
+  const home = homedir10();
   return dir === home ? "~" : dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir;
 }
 function discoverProjectDirs() {
@@ -77552,7 +77578,7 @@ import {
   constants as constants3,
   fstatSync,
   openSync as openSync5,
-  readFileSync as readFileSync25,
+  readFileSync as readFileSync24,
   readSync as readSync4,
   unlinkSync as unlinkSync5
 } from "node:fs";
@@ -80682,13 +80708,15 @@ init_trpc();
 init_config();
 init_agents();
 init_formats();
+init_backlog();
 init_detach();
 init_status();
 init_sync();
+init_watermark();
 var import_picocolors18 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync16 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
-import { delimiter as delimiter4, join as join19 } from "node:path";
+import { homedir as homedir5 } from "node:os";
+import { delimiter as delimiter4, join as join18 } from "node:path";
 function requireConfig7() {
   const cfg = requireLoginConfig();
   if (!cfg.active_account?.target?.org_id || !cfg.active_account?.target?.space_id) {
@@ -80751,6 +80779,50 @@ ${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;
+    const wantQueued = all || Boolean(opts.queued);
+    const wantOpen = all || Boolean(opts.open);
+    const wantMined = all || Boolean(opts.mined);
+    const backlog = wantQueued || wantOpen ? listSessionBacklog() : { queued: [], open: [] };
+    const mined = wantMined ? loadSyncState().mined_sessions ?? [] : [];
+    if (opts.json) {
+      printResult({
+        ...wantQueued ? { queued: backlog.queued } : {},
+        ...wantOpen ? { open: backlog.open } : {},
+        ...wantMined ? { mined } : {}
+      }, opts);
+      return;
+    }
+    const sessionRows = (sessions) => sessions.map((s) => [s.harness, s.updated, s.project ?? "-", s.id]);
+    const minedRows = mined.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;
+      return [harness, record2.at, record2.project ?? "-", id2];
+    });
+    let first = true;
+    const section = (title, rows, stamp, emptyMsg) => {
+      if (!first)
+        console.log();
+      first = false;
+      console.log(import_picocolors18.default.bold(`${title} (${rows.length})`));
+      if (rows.length === 0) {
+        console.log(import_picocolors18.default.dim(`  ${emptyMsg}`));
+        return;
+      }
+      printTable(["Agent", stamp, "Project", "Session"], rows);
+    };
+    if (wantQueued) {
+      section("Queued", sessionRows(backlog.queued), "Updated", "Queue empty. Finished agent sessions appear here.");
+    }
+    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.");
+    }
+  });
   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("--json", "Output as JSON").action(async (opts) => {
     if (opts.status) {
       const status = getSyncStatus();
@@ -80832,10 +80904,13 @@ function printSyncStatus(status, now = new Date) {
   } else {
     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'."));
+  }
   const wm2 = status.state.watermark;
   console.log(`  Mined through:   ${wm2 ? `${wm2} (${formatAge(wm2, now)})` : "nothing mined yet"}`);
   if (status.state.project_filter?.length) {
-    const home = homedir6();
+    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}`);
   }
@@ -80908,6 +80983,10 @@ function printSyncOutcome(outcome) {
       console.log(import_picocolors18.default.dim("Skipped: a recent sync failed; waiting out the retry backoff."));
       break;
     }
+    case "skipped-paused": {
+      console.log(import_picocolors18.default.dim("Skipped: mining is paused. Run 'dosu knowledge sync' to resume."));
+      break;
+    }
   }
 }
 function resolveHookAgents(ids) {
@@ -81003,7 +81082,7 @@ function reportHookFailure(agent, err) {
 }
 function dosuOnPath() {
   const bin = process.platform === "win32" ? "dosu.cmd" : "dosu";
-  return (process.env.PATH ?? "").split(delimiter4).some((dir) => dir !== "" && existsSync16(join19(dir, bin)));
+  return (process.env.PATH ?? "").split(delimiter4).some((dir) => dir !== "" && existsSync16(join18(dir, bin)));
 }
 
 // src/commands/libraries.ts
@@ -81343,7 +81422,7 @@ init_dist();
 init_commander();
 init_trpc();
 var import_picocolors22 = __toESM(require_picocolors(), 1);
-import { readFileSync as readFileSync17 } from "node:fs";
+import { readFileSync as readFileSync16 } from "node:fs";
 function requireConfig10() {
   return requireLoginConfig();
 }
@@ -81519,7 +81598,7 @@ function reviewCommand() {
     let body = opts.body;
     if (opts.bodyFile) {
       try {
-        body = readFileSync17(opts.bodyFile, "utf-8");
+        body = readFileSync16(opts.bodyFile, "utf-8");
       } catch (err) {
         console.error(import_picocolors22.default.red(`Failed to read --body-file: ${err.message}`));
         process.exit(1);
@@ -82017,7 +82096,7 @@ init_skill();
 var import_picocolors28 = __toESM(require_picocolors(), 1);
 import { spawnSync } from "node:child_process";
 import { realpathSync as realpathSync2 } from "node:fs";
-import { homedir as homedir8 } from "node:os";
+import { homedir as homedir7 } from "node:os";
 import { posix, win32 as win322 } from "node:path";
 var PACKAGE_NAME = "@dosu/cli";
 var LATEST_PACKAGE = `${PACKAGE_NAME}@latest`;
@@ -82094,7 +82173,7 @@ function packageRoots(manager, platform3, comSpec, env, cwd) {
     manager === "npm" ? path3.join(lines[0], "@dosu", "cli") : path3.join(lines[0], "node_modules", "@dosu", "cli")
   ];
 }
-function owningPackageManager(entrypoint, platform3, comSpec, env = process.env, cwd = homedir8()) {
+function owningPackageManager(entrypoint, platform3, comSpec, env = process.env, cwd = homedir7()) {
   const path3 = platform3 === "win32" ? win322 : posix;
   if (!entrypoint || !path3.isAbsolute(entrypoint))
     return null;
@@ -82147,7 +82226,7 @@ Or install Dosu globally with your package manager:`);
 function runUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   const platform3 = options.platform ?? process.platform;
   const env = options.env ?? process.env;
-  const cwd = options.cwd ?? homedir8();
+  const cwd = options.cwd ?? homedir7();
   let manager = null;
   if (channel === "npm") {
     if (isNpxInvocation(channel, env)) {
@@ -82663,7 +82742,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 = readFileSync24(logPath, "utf-8").split(`
 `);
         if (lines.at(-1) === "")
           lines.pop();
@@ -82679,7 +82758,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 = readFileSync24(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n5).join(`
@@ -82750,4 +82829,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=49488d75-f9b7-7b0e-6475-6e2164756e21
+//# debugId=858ed0b9-5f8c-23ca-6475-6e2164756e21