@dosu/cli 0.53.0-beta.4 → 0.53.0-beta.6

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.4", INSTALL_CHANNEL = "npm";
+var VERSION = "0.53.0-beta.6", 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;
@@ -71924,7 +71983,7 @@ var init_settings = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "6c656d2d-4b9b-0be3-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "1952c680-18dc-c6aa-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
@@ -73852,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)
@@ -73880,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;
@@ -73953,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")}`;
   }
@@ -73996,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)));
@@ -74018,7 +74074,7 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
   const mined = status.state.watermark ? `Mined sessions up to ${localTime(status.state.watermark)}` : "Nothing mined yet";
   const queueDetail = [];
   if (status.backoffUntil) {
-    queueDetail.push(`retrying after ${localTime(status.backoffUntil)}`);
+    queueDetail.push(`retrying after ${localTime(status.backoffUntil)} · s syncs now`);
   }
   let progress = null;
   if (status.running && backlog) {
@@ -74041,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),
     "",
@@ -74054,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(" · "))
     ]
@@ -74081,8 +74140,10 @@ function runActivityView(io2 = {}) {
   const getStatus = io2.getStatus ?? (() => getSyncStatus({ readLog: () => "" }));
   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 startSync = io2.startSync ?? (() => spawnDetachedSelf(["knowledge", "sync", "--bootstrap"]));
+  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);
@@ -74090,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;
@@ -74126,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;
@@ -74173,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;
@@ -74191,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;
@@ -74222,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();
@@ -75934,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)}`);
     }
@@ -75985,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(" · "))] : [],
     "",
@@ -76083,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();
@@ -80634,9 +80708,11 @@ 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 homedir5 } from "node:os";
@@ -80703,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();
@@ -80784,6 +80904,9 @@ 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) {
@@ -80860,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) {
@@ -82702,4 +82829,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=6c656d2d-4b9b-0be3-6475-6e2164756e21
+//# debugId=1952c680-18dc-c6aa-6475-6e2164756e21

package/package.json

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