@dosu/cli 0.62.0 → 0.63.0

package/README.md

@@ -182,7 +182,8 @@ dosu knowledge incognito enable|disable [claude|cursor|codex]  # the /dosu-incog
 ```
 
 The status line shows one of `📚 Dosu studying…`, `👻 Dosu incognito`, `⚪ Dosu paused`,
-`⚪ Dosu not studying this folder`, or `⚪ Dosu off`. Neither setup nor `enable` replaces a status
+`⚪ Dosu not studying this repo`, or `⚪ Dosu off`. Only sessions inside a git repo are studied;
+pick which repos under `dosu` → settings → study scope. Neither setup nor `enable` replaces a status
 line you already have; they print the one-liner to add to your own script instead.
 
 Running `/dosu-incognito` inside a session marks that session's transcript so studying skips it

package/bin/dosu.js

@@ -1083,7 +1083,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.62.0", INSTALL_CHANNEL = "npm";
+var VERSION = "0.63.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -1472,6 +1472,59 @@ var init_agents = __esm(() => {
   init_formats();
 });
 
+// src/sessions/repo.ts
+import { execFileSync } from "node:child_process";
+function normalizeRepoRemote(remote) {
+  const value = remote.trim();
+  if (!value)
+    return null;
+  let host;
+  let path;
+  const scp = value.includes("://") ? null : /^(?:[^@/]+@)?([^:/]+):(.+)$/.exec(value);
+  if (scp) {
+    host = scp[1];
+    path = scp[2];
+  } else {
+    try {
+      const url = new URL(value);
+      if (url.protocol === "file:")
+        return null;
+      host = url.hostname;
+      path = url.pathname;
+    } catch {
+      return null;
+    }
+  }
+  path = path.replace(/^\/+|\/+$/g, "").replace(/\.git$/, "");
+  if (!host || !path.includes("/"))
+    return null;
+  const lowerHost = host.toLowerCase();
+  return `${lowerHost}/${lowerHost === "github.com" ? path.toLowerCase() : path}`;
+}
+function originRepoOfDir(dir) {
+  const env = { ...process.env };
+  for (const name of GIT_LOCATION_ENV)
+    delete env[name];
+  try {
+    const out = execFileSync("git", ["-C", dir, "remote", "get-url", "origin"], {
+      encoding: "utf-8",
+      env,
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 1000
+    });
+    return normalizeRepoRemote(out);
+  } catch {
+    return null;
+  }
+}
+function displayRepo(repo) {
+  return repo.split("/").slice(1).join("/") || repo;
+}
+var GIT_LOCATION_ENV;
+var init_repo = __esm(() => {
+  GIT_LOCATION_ENV = ["GIT_DIR", "GIT_WORK_TREE", "GIT_COMMON_DIR", "GIT_INDEX_FILE"];
+});
+
 // src/sessions/scan.ts
 import { existsSync as existsSync6, readdirSync, statSync as statSync2 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
@@ -1919,6 +1972,9 @@ import { join as join6 } from "node:path";
 function syncStatePath(configDir = getConfigDir()) {
   return join6(configDir, STATE_FILENAME);
 }
+function stringsOf(values) {
+  return values.filter((v) => typeof v === "string");
+}
 function loadSyncState(configDir = getConfigDir()) {
   const empty = {
     schema_version: STATE_SCHEMA_VERSION,
@@ -1954,9 +2010,8 @@ function loadSyncState(configDir = getConfigDir()) {
       ...lastRefusal ? { last_refusal: lastRefusal } : {},
       ...run ? { run } : {},
       ...raw.paused === true ? { paused: true } : {},
-      ...Array.isArray(raw.project_filter) ? {
-        project_filter: raw.project_filter.filter((p) => typeof p === "string")
-      } : {}
+      ...Array.isArray(raw.repo_filter) ? { repo_filter: stringsOf(raw.repo_filter) } : {},
+      ...Array.isArray(raw.project_filter) ? { project_filter: stringsOf(raw.project_filter) } : {}
     };
   } catch {
     return empty;
@@ -1976,6 +2031,7 @@ function resetSyncState(configDir = getConfigDir()) {
     schema_version: STATE_SCHEMA_VERSION,
     watermark: null,
     consecutive_failures: 0,
+    ...previous.repo_filter ? { repo_filter: previous.repo_filter } : {},
     ...previous.project_filter ? { project_filter: previous.project_filter } : {},
     ...previous.paused ? { paused: true } : {}
   };
@@ -2002,17 +2058,31 @@ 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 studyRepoFilter(state, listSessions, locator) {
+  if (state.repo_filter)
+    return state.repo_filter;
+  const folders = state.project_filter;
+  if (!folders?.length)
+    return null;
+  const repos = new Set;
+  for (const session of listSessions()) {
+    const dir = locator.resolve(session);
+    if (!dir || !folders.some((base) => isUnderDir(dir, base)))
+      continue;
+    const repo = locator.resolveRepo(session);
+    if (repo)
+      repos.add(repo);
+  }
+  return [...repos].sort();
+}
+function filterSessionsByRepo(sessions, filter, resolveRepo) {
+  const kept = [];
+  for (const session of sessions) {
+    const repo = resolveRepo(session);
+    if (repo !== null && (filter === null || filter.includes(repo)))
+      kept.push({ ...session, repo });
+  }
+  return kept;
 }
 function gateSessions(sessions, watermark, now = new Date, quietPeriodMs = DEFAULT_QUIET_PERIOD_MS) {
   const watermarkMs = watermark ? Date.parse(watermark) : Number.NEGATIVE_INFINITY;
@@ -2031,7 +2101,7 @@ function gateSessions(sessions, watermark, now = new Date, quietPeriodMs = DEFAU
   }
   return { ready, open };
 }
-var STATE_FILENAME = "knowledge-sync.json", STATE_SCHEMA_VERSION = 1, DEFAULT_QUIET_PERIOD_MS, BACKOFF_BASE_MS, BACKOFF_MAX_MS, STUDIED_HISTORY_LIMIT = 500, UNKNOWN_PROJECT = "(unknown)";
+var STATE_FILENAME = "knowledge-sync.json", STATE_SCHEMA_VERSION = 1, DEFAULT_QUIET_PERIOD_MS, BACKOFF_BASE_MS, BACKOFF_MAX_MS, STUDIED_HISTORY_LIMIT = 500;
 var init_watermark = __esm(() => {
   init_config();
   DEFAULT_QUIET_PERIOD_MS = 5 * 60 * 1000;
@@ -2067,12 +2137,18 @@ function defaultHookEnabled(agentId) {
     return false;
   }
 }
-function cwdIsStudied(cwd, filter) {
-  if (!filter || filter.length === 0)
-    return true;
+function cwdIsStudied(cwd, state, repoOfDir) {
   if (!cwd)
-    return filter.includes(UNKNOWN_PROJECT);
-  return filter.some((base) => base !== UNKNOWN_PROJECT && isUnderDir(cwd, base));
+    return false;
+  const repo = repoOfDir(cwd);
+  if (!repo)
+    return false;
+  if (state.repo_filter)
+    return state.repo_filter.includes(repo);
+  if (state.project_filter?.length) {
+    return state.project_filter.some((base) => isUnderDir(cwd, base));
+  }
+  return true;
 }
 function resolveStatuslineState(payload, agentId, deps = {}) {
   const hookEnabled = deps.hookEnabled ?? defaultHookEnabled;
@@ -2085,7 +2161,7 @@ function resolveStatuslineState(payload, agentId, deps = {}) {
   const state = (deps.loadState ?? loadSyncState)();
   if (state.paused)
     return "paused";
-  if (!cwdIsStudied(payload.cwd, state.project_filter))
+  if (!cwdIsStudied(payload.cwd, state, deps.repoOfDir ?? originRepoOfDir))
     return "not-studied";
   return "on";
 }
@@ -2099,13 +2175,14 @@ function renderStatusline(raw, agentId, deps = {}) {
 var STATUSLINE_LABELS;
 var init_render = __esm(() => {
   init_agents();
+  init_repo();
   init_incognito();
   init_watermark();
   STATUSLINE_LABELS = {
     on: "\uD83D\uDCDA Dosu studying…",
     incognito: "\uD83D\uDC7B Dosu incognito",
     paused: "⚪ Dosu paused",
-    "not-studied": "⚪ Dosu not studying this folder",
+    "not-studied": "⚪ Dosu not studying this repo",
     off: "⚪ Dosu off"
   };
 });
@@ -9863,7 +9940,7 @@ var init_default_browser_id = __esm(() => {
 // node_modules/run-applescript/index.js
 import process6 from "node:process";
 import { promisify as promisify4 } from "node:util";
-import { execFile as execFile4, execFileSync } from "node:child_process";
+import { execFile as execFile4, execFileSync as execFileSync2 } from "node:child_process";
 async function runAppleScript(script, { humanReadableOutput = true, signal } = {}) {
   if (process6.platform !== "darwin") {
     throw new Error("macOS only");
@@ -11195,8 +11272,8 @@ async function resolveDeploymentId(client, activeOrgId, id) {
   process.exit(1);
 }
 function deploymentsCommand() {
-  const cmd = new Command("deployments").description("Manage deployments");
-  cmd.command("list").description("List all deployments").option("--json", "Output as JSON").action(async (opts) => {
+  const cmd = new Command("deployments").description("Select the MCP deployment (and its Library) this CLI uses; not for Agents");
+  cmd.command("list").description("List MCP deployments you can select").option("--json", "Output as JSON").action(async (opts) => {
     const cfg = requireConfig4();
     const client = createTypedClient(cfg);
     const allDeployments = await listAccessibleDeployments(client, cfg.active_account?.target?.org_id);
@@ -11206,7 +11283,7 @@ function deploymentsCommand() {
       return;
     }
     if (!deployments || deployments.length === 0) {
-      console.log(import_picocolors15.default.dim("No deployments found."));
+      console.log(import_picocolors15.default.dim("No MCP deployments found."));
       return;
     }
     printTable(["ID", "Name", "Org", "Status"], deployments.map((d) => [
@@ -11220,7 +11297,7 @@ function deploymentsCommand() {
 ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deployment_name ?? cfg.active_account?.target?.deployment_id}`)}`);
     }
   });
-  cmd.command("info").description("Show current deployment details").option("--json", "Output as JSON").action(async (opts) => {
+  cmd.command("info").description("Show the selected MCP deployment").option("--json", "Output as JSON").action(async (opts) => {
     const cfg = requireConfig4();
     if (!cfg.active_account?.target?.deployment_id) {
       console.error(import_picocolors15.default.red("No deployment selected. Run 'dosu setup' or 'dosu deployments switch'."));
@@ -11247,7 +11324,7 @@ ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deploy
       ["Created", formatDate(deployment.created_at)]
     ], { rawData: deployment });
   });
-  cmd.command("switch").description("Switch to a different deployment").argument("<id>", "Deployment ID (full UUID, or a unique prefix as shown by 'list')").option("--json", "Output as JSON").action(async (rawId, opts) => {
+  cmd.command("switch").description("Select a different MCP deployment (mints a new API key for it)").argument("<id>", "MCP deployment ID (full UUID, or a unique prefix as shown by 'list')").option("--json", "Output as JSON").action(async (rawId, opts) => {
     const cfg = requireConfig4();
     const client = createTypedClient(cfg);
     const id = await resolveDeploymentId(client, cfg.active_account?.target?.org_id, rawId);
@@ -12000,20 +12077,39 @@ function createProjectDirResolver(configDir = getConfigDir(), deps = {}) {
         return null;
     }
   };
+  const repoOfDir = deps.repoOfDir ?? originRepoOfDir;
+  const repoByDir = new Map;
+  const resolve = (session) => {
+    const key = `${session.harness}/${session.id}`;
+    const cached = entries[key];
+    if (cached && (cached.dir !== null || cached.mtime === mtime(session.path))) {
+      return cached.dir;
+    }
+    const dir = compute(session);
+    entries[key] = { dir, mtime: mtime(session.path) };
+    dirty = true;
+    return dir;
+  };
   return {
     cached(key) {
       return entries[key]?.dir ?? null;
     },
-    resolve(session) {
-      const key = `${session.harness}/${session.id}`;
-      const cached = entries[key];
-      if (cached && (cached.dir !== null || cached.mtime === mtime(session.path))) {
-        return cached.dir;
-      }
-      const dir = compute(session);
-      entries[key] = { dir, mtime: mtime(session.path) };
+    resolve,
+    resolveRepo(session) {
+      const dir = resolve(session);
+      if (dir === null)
+        return null;
+      const entry = entries[`${session.harness}/${session.id}`];
+      if (entry.repo !== undefined && (entry.repo !== null || entry.mtime === mtime(session.path))) {
+        return entry.repo;
+      }
+      if (!repoByDir.has(dir))
+        repoByDir.set(dir, repoOfDir(dir));
+      const repo = repoByDir.get(dir) ?? null;
+      entry.repo = repo;
+      entry.mtime = mtime(session.path);
       dirty = true;
-      return dir;
+      return repo;
     },
     flush() {
       if (!dirty)
@@ -12026,6 +12122,7 @@ function createProjectDirResolver(configDir = getConfigDir(), deps = {}) {
 var CACHE_FILENAME2 = "project-dirs.json", CACHE_SCHEMA_VERSION = 1, HEAD_BYTES, HEAD_LINES = 50;
 var init_project_dir = __esm(() => {
   init_config();
+  init_repo();
   HEAD_BYTES = 128 * 1024;
 });
 
@@ -13309,12 +13406,11 @@ var init_generate = __esm(() => {
 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 scanned = scanAgentSessions({});
+    const resolver = createProjectDirResolver();
+    const filter = studyRepoFilter(state, () => scanned, resolver);
+    const sessions = filterSessionsByRepo(scanned, filter, resolver.resolveRepo);
+    resolver.flush();
     const gate = gateSessions(sessions, state.watermark);
     const { kept, skipped } = partitionIncognitoSessions(gate.ready);
     return { queued: kept.reverse(), open: gate.open.reverse(), incognito: skipped.reverse() };
@@ -13540,19 +13636,24 @@ async function runKnowledgeSync(options = {}) {
       since: new Date(now().getTime() - GATE_WINDOW_DAYS * 24 * 60 * 60 * 1000),
       limit: GATE_WINDOW
     }));
-    let sessions = await listSessions();
-    if (state.project_filter?.length) {
-      let resolve = deps.resolveProjectDir;
-      let flush;
-      if (!resolve) {
-        const resolver = createProjectDirResolver();
-        resolve = resolver.resolve;
-        flush = resolver.flush;
-      }
-      sessions = filterSessionsByProject(sessions, state.project_filter, resolve);
-      flush?.();
-      logger.debug("sync", `project filter active: ${state.project_filter.join(", ")}`);
-    }
+    const scanned = await listSessions();
+    let flush;
+    let locator = deps.locator;
+    if (!locator) {
+      const resolver = createProjectDirResolver();
+      locator = resolver;
+      flush = resolver.flush;
+    }
+    const repoFilter = studyRepoFilter(state, () => scanAgentSessions({}), locator);
+    if (state.project_filter) {
+      delete state.project_filter;
+      if (repoFilter)
+        state.repo_filter = repoFilter;
+      logger.debug("sync", `folder scope converted to repos: ${repoFilter?.join(", ") || "none"}`);
+    }
+    const sessions = filterSessionsByRepo(scanned, repoFilter, (s) => locator.resolveRepo(s));
+    flush?.();
+    logger.debug("sync", `study scope ${repoFilter ? repoFilter.join(", ") || "none" : "all repos"}: ${sessions.length} of ${scanned.length} sessions in scope`);
     ({ ready, open } = gateSessions(sessions, state.watermark, now()));
     logGateResult(ready, open.length, state.watermark);
   } catch (err) {
@@ -13800,7 +13901,7 @@ var init_conflicts = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "da3b44a3-063b-fb2c-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "01f74cf6-cdbb-b296-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -15477,9 +15578,8 @@ note cap are the volume guards.
 5. Title is a noun-phrase topic (like "page_version UniqueViolation race"), not a sentence.
 Content is a self-contained observation in plain language; include file/path pointers when
 useful.
-6. Only pass repo/branch to write_knowledge when the session itself verifies them (an explicit
-cwd, git remote, or branch mentioned in the transcript). Never infer or guess a repo. When not
-verified, omit both.
+6. Never pass repo or branch to write_knowledge; the client attaches each note's repo from the
+session it came from.
 7. Never quote credentials, tokens, or secrets — even redacted placeholders — and never include
 long verbatim transcript spans. Summarize in your own words.
 8. A trivial session with no real user query is normal: skip it silently.`;
@@ -58494,6 +58594,7 @@ async function runLearner(options) {
   let currentSession;
   const readsSinceWrite = new Set;
   const sessionKeys = new Map(options.sessions.map((s) => [s.id, `${s.harness}/${s.id}`]));
+  const sessionRepos = new Map(options.sessions.map((s) => [s.id, s.repo]));
   const notedSessions = new Set;
   const pendingNotes = new Map;
   let turns = 0;
@@ -58577,10 +58678,20 @@ async function runLearner(options) {
             const noted = currentSession && sessionKeys.get(currentSession);
             if (noted)
               pendingNotes.set(toolUseID, noted);
-            const { transcript_id: _authoredByModel, ...clean } = input;
+            const {
+              transcript_id: _transcriptByModel,
+              repo: _repoByModel,
+              branch: _branchByModel,
+              ...clean
+            } = input;
+            const repo = currentSession && sessionRepos.get(currentSession);
             return {
               behavior: "allow",
-              updatedInput: currentSession ? { ...clean, transcript_id: currentSession } : clean
+              updatedInput: {
+                ...clean,
+                ...currentSession ? { transcript_id: currentSession } : {},
+                ...repo ? { repo } : {}
+              }
             };
           }
           return { behavior: "allow", updatedInput: input };
@@ -58670,7 +58781,6 @@ var init_runner = __esm(() => {
 
 // src/commands/knowledge.ts
 import { existsSync as existsSync18 } from "node:fs";
-import { homedir as homedir7 } from "node:os";
 import { delimiter as delimiter4, join as join21 } from "node:path";
 function requireConfig7() {
   const cfg = requireLoginConfig();
@@ -58938,10 +59048,11 @@ function printSyncStatus(status, now = new Date) {
   }
   const wm = status.state.watermark;
   console.log(`  Studied through: ${wm ? `${wm} (${formatAge(wm, now)})` : "nothing studied yet"}`);
-  if (status.state.project_filter?.length) {
-    const home = homedir7();
-    const scope = status.state.project_filter.map((dir) => dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir).join(", ");
-    console.log(`  Study scope:     ${scope}`);
+  const repoFilter = status.state.repo_filter;
+  if (repoFilter) {
+    console.log(`  Study scope:     ${repoFilter.length ? repoFilter.map(displayRepo).join(", ") : "no repos"}`);
+  } else if (status.state.project_filter?.length) {
+    console.log(`  Study scope:     ${status.state.project_filter.length} folders (converted to repos on the next sync)`);
   }
   if ((status.state.total_notes ?? 0) > 0) {
     const tokens = status.state.total_learning_tokens ?? 0;
@@ -59104,6 +59215,7 @@ var init_knowledge = __esm(() => {
   init_agents();
   init_formats();
   init_generate();
+  init_repo();
   init_backlog();
   init_detach();
   init_status();
@@ -59898,7 +60010,94 @@ var init_skills = __esm(() => {
       files: [
         {
           path: "SKILL.md",
-          content: "---\nname: dosu\ndescription: 'Use the Dosu CLI to authenticate and configure coding agents; manage Libraries, Agents, sources, Monitor, documents, reviews, threads, topics, members, integrations, and deployments; query knowledge; or audit a repository for Dosu-generated docs. Use for Dosu platform work that should be done from a terminal instead of the web app.'\n---\n\n# Use the Dosu CLI\n\nOperate Dosu through `dosu`. Prefer structured output and let the CLI and App validate product rules.\n\n## Start correctly\n\n1. Run `dosu --version`. Do not probe installation with unrelated package-manager commands.\n2. If it is unavailable and Node is present, try `npx -y @dosu/cli --version` and use `npx -y @dosu/cli` as the command prefix for this session. Otherwise ask before installing anything.\n3. Run `dosu --help` or the relevant nested `--help` before using a command not covered by [the command reference](references/commands.md).\n4. Pass `--json` whenever that leaf command exposes it. Parse the result; do not scrape the human table.\n\n## Satisfy the right prerequisite\n\n- `dosu login` supplies the JWT used by tRPC-backed commands.\n- `dosu setup` selects an organization, Library context, and MCP deployment, creates an API key, and can configure an agent tool.\n- `dosu ask` needs an API key. `docs generate`, `docs auto-tag`, and `docs publish` need both JWT login and the API key. Other platform commands generally need JWT login; commands scoped to an organization or current Library also need the corresponding setup selection.\n- For coding-agent setup, follow the nonblocking `dosu setup --agent --tool <id>` workflow in [workflows.md](references/workflows.md). Relay its URL and execute its returned `resume_command`; never invent ticket commands.\n\n## Use current product terms\n\n- **Organization** is the account and permission boundary.\n- **Library** is the knowledge container shown in the App. Older APIs may call it a `space`; do not present that internal name to users.\n- **Data source** is an organization-level connection such as a repository, Slack channel, or Notion workspace. A Library can use already-connected sources.\n- **Agent** is a configurable GitHub, GitLab, Slack, or Teams deployment serving exactly one Library.\n- **Monitor** is per Library and source. It supports GitHub, GitLab, and Azure DevOps sources.\n- `dosu deployments` manages selectable **MCP deployments**. Do not use it as an Agent CRUD command.\n\n## Route by intent\n\n| Intent | Route |\n|---|---|\n| Set up Dosu end-to-end (\"set up dosu\", new Library from scratch) | Read the guided onboarding flow in [workflows.md](references/workflows.md) first; it is checkpoint-driven — ask, wait, then act |\n| Create or configure a Library | `dosu libraries ...` |\n| Attach existing organization sources | `dosu sources list` → `dosu libraries sources attach` |\n| Create or configure an Agent | `dosu agents ...` |\n| Ask for a synthesized answer | `dosu ask` |\n| Find source documents | `dosu knowledge search`, then `dosu docs get` |\n| Create, import, or publish docs | `dosu docs ...` |\n| Review a pending doc change or draft reply | Read [review-workflow.md](references/review-workflow.md) first |\n| Inspect conversations | `dosu threads ...` |\n| Browse managed topics | `dosu topics ...` |\n| Audit agent docs, README, architecture, or dependencies | Read [audit.md](references/audit.md) first |\n\nUse [commands.md](references/commands.md) as the sole detailed command and flag reference. Use [workflows.md](references/workflows.md) only for multi-command composition.\n\n## Apply Library and Agent semantics\n\n- To assemble a Library, list organization sources, create the Library, attach the chosen source IDs, then verify with `libraries info` and `libraries sources list`. The CLI cannot establish a brand-new OAuth connection.\n- `libraries sources config` resolves the provider on the App side. Read the command reference before choosing provider-specific options.\n- When creating a Library with a GitHub repository, or newly attaching one to an existing Library, treat Monitor as part of that setup unless the user opts out. Enable it with the whole-repository and `emoji` defaults, verify it, and explain that Monitor reviews pull requests to keep the Library's knowledge up to date. Follow [the Library workflow](references/workflows.md); do not ask the user to choose defaults.\n- Create an Agent from an existing source ID and let the App choose its defaults; do not synthesize config in shell commands. Each data source can back at most one Agent: a `CONFLICT` (409) from `agents create` means the source already has one — offer a different source or an authorized `agents move` instead of retrying.\n- Read Agent config before changing one existing leaf. Values are JSON. If a concurrent write returns `CONFLICT`, read again, re-evaluate the requested change, and retry only if it is still correct.\n- Moving an Agent replaces its Library. Verify the returned `space_id`; do not infer migration behavior for historical data from the move receipt.\n\n## Respect write boundaries\n\n- Treat an explicit, unambiguous user request for the exact mutation as authorization. Otherwise show the intended change and wait for confirmation.\n- For commands exposing `--confirm`, omit it first when a preview is useful; `{ \"confirmRequired\": true, \"applied\": false }` means nothing changed. Pass `--confirm` only after authorization.\n- Never batch-approve or batch-reject review items. Diff one item, explain it, and decide only the ID the user authorized.\n- Before deleting a Library, Agent, source, or document, state the exact target and impact. Before detaching a source, read and state the impact documented in the command reference. Some older delete commands do not enforce `--confirm`; the absence of a CLI prompt is not user approval.\n- Before attaching a source to a public Library, warn that its content becomes available to everyone who can access that Library.\n- OAuth connection and billing remain web-only. Report the boundary instead of claiming success.\n\n## Handle failures literally\n\n- `Not logged in` or an unrecoverable expired session: run `dosu login` (agent setup may instead return a ticket flow).\n- Missing organization, Library, deployment, or API-key context: run the appropriate `dosu setup` flow.\n- `confirmRequired`: no write occurred.\n- `CONFLICT` on config: reread before retrying.\n- A tRPC or backend error is a failed operation. Surface the code/path/status and do not imply the requested state exists.\n\n## References\n\n- [commands.md](references/commands.md): authoritative CLI syntax, choices, defaults, conflicts, and prerequisites\n- [workflows.md](references/workflows.md): reusable multi-command flows\n- [review-workflow.md](references/review-workflow.md): review safety and context\n- [audit.md](references/audit.md): repository audit procedure\n- [audit-findings-schema.md](references/audit-findings-schema.md): `.dosu/audit.json` contract\n",
+          content: `---
+name: dosu
+description: 'Use the Dosu CLI to show the Dosu review list or review queue (items pending approval: pending doc changes and draft replies) and to review, approve, or reject one item; authenticate and configure coding agents; manage Libraries, Agents, sources, Monitor, documents, threads, topics, members, integrations, and MCP deployments; query knowledge; or audit a repository for Dosu-generated docs. Use for Dosu platform work that should be done from a terminal instead of the web app.'
+---
+
+# Use the Dosu CLI
+
+Operate Dosu through \`dosu\`. Prefer structured output and let the CLI and App validate product rules.
+
+## Start correctly
+
+1. Run \`dosu --version\`. Do not probe installation with unrelated package-manager commands.
+2. If it is unavailable and Node is present, try \`npx -y @dosu/cli --version\` and use \`npx -y @dosu/cli\` as the command prefix for this session. Otherwise ask before installing anything.
+3. Run \`dosu --help\` or the relevant nested \`--help\` before using a command not covered by [the command reference](references/commands.md).
+4. Pass \`--json\` whenever that leaf command exposes it. Parse the result; do not scrape the human table.
+
+## Satisfy the right prerequisite
+
+- \`dosu login\` supplies the JWT used by tRPC-backed commands.
+- \`dosu setup\` selects an organization, Library context, and MCP deployment, creates an API key, and can configure an agent tool.
+- \`dosu ask\` needs an API key. \`docs generate\`, \`docs auto-tag\`, and \`docs publish\` need both JWT login and the API key. Other platform commands generally need JWT login; commands scoped to an organization or current Library also need the corresponding setup selection.
+- For coding-agent setup, follow the nonblocking \`dosu setup --agent --tool <id>\` workflow in [workflows.md](references/workflows.md). Relay its URL and execute its returned \`resume_command\`; never invent ticket commands.
+
+## Use current product terms
+
+- **Organization** is the account and permission boundary.
+- **Library** is the knowledge container shown in the App. Older APIs may call it a \`space\`; do not present that internal name to users.
+- **Data source** is an organization-level connection such as a repository, Slack channel, or Notion workspace. A Library can use already-connected sources.
+- **Agent** is a configurable GitHub, GitLab, Slack, or Teams deployment serving exactly one Library.
+- **Monitor** is per Library and source. It supports GitHub, GitLab, and Azure DevOps sources.
+- **MCP deployment** is the local selection made by \`dosu setup\` or \`dosu deployments switch\`. It sets the Library that Library-scoped commands such as \`dosu review list\` read, plus the API key \`dosu ask\` uses. \`dosu deployments\` lists and switches MCP deployments; it is not an Agent command.
+- The **review queue** (\`dosu review list\`) holds pending doc changes in the selected Library plus draft replies from the selected MCP deployment. The App's **Review** page is a list of conversation threads, so its entries and counts can differ. When the user explicitly means that page, explain the difference and offer \`dosu threads list\` or \`dosu review context <thread-id>\`; do not substitute an Agent list.
+
+## Route by intent
+
+| Intent | Route |
+|---|---|
+| Set up Dosu end-to-end ("set up dosu", new Library from scratch) | Read the guided onboarding flow in [workflows.md](references/workflows.md) first; it is checkpoint-driven — ask, wait, then act |
+| Create or configure a Library | \`dosu libraries ...\` |
+| Attach existing organization sources | \`dosu sources list\` → \`dosu libraries sources attach\` |
+| Create or configure an Agent | \`dosu agents ...\` |
+| Ask for a synthesized answer | \`dosu ask\` |
+| Find source documents | \`dosu knowledge search\`, then \`dosu docs get\` |
+| Create, import, or publish docs | \`dosu docs ...\` |
+| Show the review list, review queue, or what needs approval | \`dosu review list --json\`; if the scope looks wrong, follow the context check in [review-workflow.md](references/review-workflow.md) |
+| Inspect, edit, approve, or reject one review item | Read [review-workflow.md](references/review-workflow.md) first |
+| Inspect conversations | \`dosu threads ...\` |
+| Browse managed topics | \`dosu topics ...\` |
+| Audit agent docs, README, architecture, or dependencies | Read [audit.md](references/audit.md) first |
+
+Use [commands.md](references/commands.md) as the sole detailed command and flag reference. Use [workflows.md](references/workflows.md) only for multi-command composition.
+
+## Apply Library and Agent semantics
+
+- To assemble a Library, list organization sources, create the Library, attach the chosen source IDs, then verify with \`libraries info\` and \`libraries sources list\`. The CLI cannot establish a brand-new OAuth connection.
+- \`libraries sources config\` resolves the provider on the App side. Read the command reference before choosing provider-specific options.
+- When creating a Library with a GitHub repository, or newly attaching one to an existing Library, treat Monitor as part of that setup unless the user opts out. Enable it with the whole-repository and \`emoji\` defaults, verify it, and explain that Monitor reviews pull requests to keep the Library's knowledge up to date. Follow [the Library workflow](references/workflows.md); do not ask the user to choose defaults.
+- Create an Agent from an existing source ID and let the App choose its defaults; do not synthesize config in shell commands. Each data source can back at most one Agent: a \`CONFLICT\` (409) from \`agents create\` means the source already has one — offer a different source or an authorized \`agents move\` instead of retrying.
+- Read Agent config before changing one existing leaf. Values are JSON. If a concurrent write returns \`CONFLICT\`, read again, re-evaluate the requested change, and retry only if it is still correct.
+- Moving an Agent replaces its Library. Verify the returned \`space_id\`; do not infer migration behavior for historical data from the move receipt.
+
+## Respect write boundaries
+
+- Treat an explicit, unambiguous user request for the exact mutation as authorization. Otherwise show the intended change and wait for confirmation.
+- For commands exposing \`--confirm\`, omit it first when a preview is useful; \`{ "confirmRequired": true, "applied": false }\` means nothing changed. Pass \`--confirm\` only after authorization.
+- Never batch-approve or batch-reject review items. Diff one item, explain it, and decide only the ID the user authorized.
+- Before deleting a Library, Agent, source, or document, state the exact target and impact. Before detaching a source, read and state the impact documented in the command reference. Some older delete commands do not enforce \`--confirm\`; the absence of a CLI prompt is not user approval.
+- Before attaching a source to a public Library, warn that its content becomes available to everyone who can access that Library.
+- OAuth connection and billing remain web-only. Report the boundary instead of claiming success.
+
+## Handle failures literally
+
+- \`Not logged in\` or an unrecoverable expired session: run \`dosu login\` (agent setup may instead return a ticket flow).
+- Missing organization, Library, deployment, or API-key context: run the appropriate \`dosu setup\` flow.
+- Wrong or unexpected Library context: read \`dosu status --json\` and \`dosu deployments info --json\` before changing anything. Switch only to an MCP deployment the user named or confirmed; never pick the first one listed, and never switch just because a list came back empty.
+- Skill guidance out of date: \`dosu skill update\` rewrites the installed skill from the running CLI version. Some agents read skills only when a session starts, so start a new session if the change does not appear. Installed files show the skill is on disk, not that the agent loaded it.
+- \`confirmRequired\`: no write occurred.
+- \`CONFLICT\` on config: reread before retrying.
+- A tRPC or backend error is a failed operation. Surface the code/path/status and do not imply the requested state exists.
+
+## References
+
+- [commands.md](references/commands.md): authoritative CLI syntax, choices, defaults, conflicts, and prerequisites
+- [workflows.md](references/workflows.md): reusable multi-command flows
+- [review-workflow.md](references/review-workflow.md): review safety and context
+- [audit.md](references/audit.md): repository audit procedure
+- [audit-findings-schema.md](references/audit-findings-schema.md): \`.dosu/audit.json\` contract
+`,
           executable: false
         },
         {
@@ -60249,7 +60448,7 @@ dosu docs sync-back <id> [--json]
 Read [review-workflow.md](review-workflow.md) before mutating a review item.
 
 \`\`\`text
-dosu review list [--json]
+dosu review list [--since <when>] [--until <when>] [--json]
 dosu review diff <id> [--json]
 dosu review edit <id> [--title <title>] [--body <markdown> | --body-file <path>] [--json]
 dosu review context <thread-id> [--json]
@@ -60258,7 +60457,9 @@ dosu review reject <id> [--confirm] [--json]
 dosu review revert <id> [--json]
 \`\`\`
 
-\`edit\` requires at least one field. \`approve\` and \`reject\` do not write without interactive confirmation or \`--confirm\`.
+- \`list\` reads the selected Library's pending doc changes plus the selected MCP deployment's draft replies. JSON is \`{items, truncated, total}\`: at most 50 items, newest first; \`total\` is a lower bound when \`truncated\` is true. \`--since\`/\`--until\` take \`24h\`/\`7d\`/\`2w\`, a UTC date, or an ISO-8601 datetime.
+- IDs are opaque: pass each \`id\` from \`list\` verbatim (draft replies carry a \`draft_message:\` prefix). \`revert\` takes a decided doc change's page-version ID and does not apply to drafts.
+- \`edit\` requires at least one field; drafts accept only \`--body\`/\`--body-file\`. \`approve\` and \`reject\` do not write without interactive confirmation or \`--confirm\`.
 
 ## Sources, integrations, members, and organization
 
@@ -60345,98 +60546,7 @@ The coding agent writes the findings; Dosu generates the selected docs. Follow [
         },
         {
           path: "references/review-workflow.md",
-          content: `# Review workflow
-
-How to work Dosu's review queue from the CLI: triage pending items, read the
-diff, optionally edit, and apply a decision — safely.
-
-The queue holds **document versions** (AI-generated, user-edited, synced from
-source, or API-created) and **draft messages**, all surfaced through the same
-\`dosu review\` commands. Items are keyed on a single \`page-version-id\` so
-\`list\` → \`diff\` → \`edit\` → \`approve\`/\`reject\` all share one ID.
-
-> \`list\` returns only the most recent pending items (server-capped, currently
-> 50) and does not flag truncation. If the queue is large, don't assume \`list\`
-> shows everything.
-
-## Scope tool access for a review session
-
-Approving and rejecting are destructive and outward-facing. When you spin up an
-agent session dedicated to reviewing, scope it to just the review commands:
-
-\`\`\`yaml
-allowed-tools: Bash(dosu review:*)
-\`\`\`
-
-This lets the agent triage, diff, and edit, but keeps it from running unrelated
-CLI commands during a review pass.
-
-## The flow
-
-\`\`\`bash
-# 1. Triage — what's pending? Columns: ID, Kind, Title, Source, Status, Created.
-dosu review list --json
-
-# 2. Inspect — read the exact change before deciding anything.
-dosu review diff <page-version-id> --json
-
-# 3. (optional) Edit in place instead of rejecting a near-miss.
-dosu review edit <page-version-id> --body-file ./revised.md   # or --body / --title
-
-# 4. Decide — only on the item the user named, only after they OK it.
-dosu review approve <page-version-id> --confirm --json
-dosu review reject  <page-version-id> --confirm --json
-
-# Undo a decision — back to pending.
-dosu review revert <page-version-id> --json
-\`\`\`
-
-### \`--confirm\` is mandatory for agents
-
-\`approve\` and \`reject\` only prompt interactively in a TTY *without* \`--json\`.
-The skill always passes \`--json\`, which suppresses both the diff preview and
-the prompt — so without \`--confirm\` the command changes nothing and returns
-\`{ "applied": false, "confirmRequired": true }\`. Run \`dosu review diff <id>\` to
-see the change, then pass \`--confirm\` to apply — only after the user has
-approved that specific item.
-
-## Reading the \`Source\` column
-
-\`Source\` is the humanized \`origin\` field:
-
-| \`origin\` | Source | Meaning |
-|---|---|---|
-| \`manual_update\` | User created / User updated | A teammate authored or edited the doc |
-| \`llm_generated\` | AI generated | Dosu drafted the change |
-| \`sync_upstream\` | Synced from source | Came in from a connected source (Notion/Confluence/GitHub) |
-| \`api_update\` | Created via API | Pushed in programmatically |
-
-## Feeding PR / thread context
-
-A review often originates from a conversation thread (a GitHub issue, a Slack
-message, a sync-back PR). Pull that context before deciding:
-
-\`\`\`bash
-dosu review context <thread-id> --json
-\`\`\`
-
-It returns the review \`type\`, the review/published page IDs, and — when the
-change round-trips to an external system — a **Sync PR URL**. Use it to:
-
-- show the user where the change came from and where approval will land, and
-- read the originating discussion so the decision matches intent.
-
-## Safety rules
-
-- **Explicit item only.** Decide on the \`id\` the user named. "Review my queue"
-  → run \`list\` and show it; never decide on their behalf.
-- **Diff before deciding.** Always \`diff\` and surface the change first.
-- **Never batch-accept.** No loop over \`list\` that approves everything. One
-  item, one confirmation.
-- **Extra care for sync/PR origins.** \`Synced from source\` items and anything
-  with a Sync PR URL push back to an upstream system on approval. Call it out
-  and get explicit sign-off.
-`,
+          content: '# Review workflow\n\nHow to work Dosu\'s review queue from the CLI: triage pending items, read the\ndiff, optionally edit, and apply a decision — safely.\n\nThe queue holds **document versions** (AI-generated, user-edited, synced from\nsource, or API-created) and **draft messages**, all surfaced through the same\n`dosu review` commands. Doc changes come from the selected Library; draft\nreplies come only from threads of the selected MCP deployment.\n\n## Read the list result\n\n`dosu review list --json` returns `{ "items": [...], "truncated": <bool>, "total": <n> }`.\n\n- `items` holds at most 50 entries, newest first, doc changes and draft\n  replies merged.\n- `truncated: true` means more pending items may exist than `items` shows.\n- `total` counts what the server found before that cap. When `truncated` is\n  true it is a lower bound: report "at least `total`", never an exact backlog.\n- Each `id` is opaque. A doc change\'s `id` is its page-version UUID; a draft\n  reply\'s `id` looks like `draft_message:<uuid>` and has `kind: "draft_message"`.\n  Pass the `id` exactly as listed to `diff`, `edit`, `approve`, and `reject`;\n  do not strip the prefix or shorten it.\n- `--since <when>` and `--until <when>` narrow the list by creation time. Each\n  takes a duration back from now (`24h`, `7d`, `2w`), a UTC date\n  (`2026-09-01`; an `--until` date includes that whole day), or an ISO-8601\n  datetime. When `truncated` is true, `--until` reaches older items.\n\nAn empty `items` array means no pending items in the current scope. It is not\na reason to switch deployments.\n\n## Check the context when the scope looks wrong\n\nRun this only when the user says the list is for the wrong Library, names a\ndifferent Library, or a command reports missing context:\n\n1. `dosu status --json`: login state and the selected MCP deployment.\n2. `dosu deployments info --json`: the selected MCP deployment. The list reads\n   the Library saved in the CLI\'s config, which `dosu setup` and\n   `dosu deployments switch` set to this deployment\'s `space_id`\n   (`dosu libraries info <space_id> --json` gives its name).\n3. If that is not the Library the user means, run\n   `dosu deployments list --json` and find the MCP deployment whose `space_id`\n   matches it (`dosu libraries list --json` maps names to IDs).\n4. Switch only to a deployment the user named or confirmed:\n   `dosu deployments switch <deployment-id> --json`. It changes the CLI\'s\n   selection for later commands and mints a new API key, so say that it did.\n   Never pick the first deployment, and ask when several match or none does.\n5. Run `dosu review list --json` again.\n\n## Draft reply limits\n\n- `edit` on a draft accepts `--body` or `--body-file` only (no `--title`).\n- `approve` publishes the draft to its thread; `reject` discards it.\n- Drafts have no `revert`. A rejected draft is regenerated on the next agent run.\n\n## Scope tool access for a review session\n\nApproving and rejecting are destructive and outward-facing. When you spin up an\nagent session dedicated to reviewing, scope it to just the review commands:\n\n```yaml\nallowed-tools: Bash(dosu review:*)\n```\n\nThis lets the agent triage, diff, and edit, but keeps it from running unrelated\nCLI commands during a review pass.\n\n## The flow\n\n```bash\n# 1. Triage — what\'s pending? Columns: ID, Kind, Title, Source, Status, Created.\ndosu review list --json\ndosu review list --since 7d --json          # optional creation-time window\n\n# 2. Inspect — read the exact change before deciding anything.\ndosu review diff <id> --json\n\n# 3. (optional) Edit in place instead of rejecting a near-miss.\ndosu review edit <id> --body-file ./revised.md   # or --body / --title (docs only)\n\n# 4. Decide — only on the item the user named, only after they OK it.\ndosu review approve <id> --confirm --json\ndosu review reject  <id> --confirm --json\n\n# Undo a doc-change decision — back to pending (not for draft replies).\ndosu review revert <page-version-id> --json\n```\n\n### `--confirm` is mandatory for agents\n\n`approve` and `reject` only prompt interactively in a TTY *without* `--json`.\nThe skill always passes `--json`, which suppresses both the diff preview and\nthe prompt — so without `--confirm` the command changes nothing and returns\n`{ "applied": false, "confirmRequired": true }`. Run `dosu review diff <id>` to\nsee the change, then pass `--confirm` to apply — only after the user has\napproved that specific item.\n\n## Reading the `Source` column\n\n`Source` is the humanized `origin` field:\n\n| `origin` | Source | Meaning |\n|---|---|---|\n| `manual_update` | User created / User updated | A teammate authored or edited the doc |\n| `llm_generated` | AI generated | Dosu drafted the change |\n| `sync_upstream` | Synced from source | Came in from a connected source (Notion/Confluence/GitHub) |\n| `api_update` | Created via API | Pushed in programmatically |\n\n## Feeding PR / thread context\n\nA review often originates from a conversation thread (a GitHub issue, a Slack\nmessage, a sync-back PR). Pull that context before deciding:\n\n```bash\ndosu review context <thread-id> --json\n```\n\nIt returns the review `type`, the review/published page IDs, and — when the\nchange round-trips to an external system — a **Sync PR URL**. Use it to:\n\n- show the user where the change came from and where approval will land, and\n- read the originating discussion so the decision matches intent.\n\n## Safety rules\n\n- **Explicit item only.** Decide on the `id` the user named. "Review my queue"\n  → run `list` and show it; never decide on their behalf.\n- **Listing is read-only.** A request to show the list authorizes no approve,\n  reject, edit, API-key creation, or deployment switch.\n- **Diff before deciding.** Always `diff` and surface the change first.\n- **Never batch-accept.** No loop over `list` that approves everything. One\n  item, one confirmation.\n- **Extra care for sync/PR origins.** `Synced from source` items and anything\n  with a Sync PR URL push back to an upstream system on approval. Call it out\n  and get explicit sign-off.\n',
           executable: false
         },
         {
@@ -60676,7 +60786,7 @@ import {
   symlinkSync,
   writeFileSync as writeFileSync12
 } from "node:fs";
-import { homedir as homedir8 } from "node:os";
+import { homedir as homedir7 } from "node:os";
 import { dirname as dirname10, join as join22, relative as relative3 } from "node:path";
 function skillAgentIDsForProviders(providerIDs) {
   return [
@@ -60687,15 +60797,15 @@ function isSkillAgentID(agent) {
   return SUPPORTED_SKILL_AGENTS.includes(agent);
 }
 function universalSkillsDir() {
-  return join22(homedir8(), ".agents", "skills");
+  return join22(homedir7(), ".agents", "skills");
 }
 function linkedSkillsDir(agent) {
   if (agent === "claude-code") {
-    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join22(homedir8(), ".claude");
+    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join22(homedir7(), ".claude");
     return join22(claudeConfigDir, "skills");
   }
   if (agent === "windsurf")
-    return join22(homedir8(), ".codeium", "windsurf", "skills");
+    return join22(homedir7(), ".codeium", "windsurf", "skills");
   return null;
 }
 function skillInstallTargetForProvider(providerID) {
@@ -60738,7 +60848,7 @@ function clearSkillInstallState() {
   rmSync5(installStatePath(), { force: true });
 }
 function pruneLegacySkillLock() {
-  const lockPath = join22(homedir8(), ".agents", ".skill-lock.json");
+  const lockPath = join22(homedir7(), ".agents", ".skill-lock.json");
   try {
     if (!existsSync19(lockPath))
       return [];
@@ -62173,15 +62283,15 @@ var init_vscode = __esm(() => {
 });
 
 // src/mcp/providers/windsurf.ts
-import { homedir as homedir9 } from "node:os";
+import { homedir as homedir8 } from "node:os";
 import { join as join36 } from "node:path";
 var WindsurfProvider = () => createJSONProvider({
   providerName: "Windsurf",
   providerID: "windsurf",
   local: false,
   priorityValue: 9,
-  paths: [join36(homedir9(), ".codeium", "windsurf")],
-  globalPath: join36(homedir9(), ".codeium", "windsurf", "mcp_config.json"),
+  paths: [join36(homedir8(), ".codeium", "windsurf")],
+  globalPath: join36(homedir8(), ".codeium", "windsurf", "mcp_config.json"),
   topKey: "mcpServers"
 });
 var init_windsurf = __esm(() => {
@@ -62190,14 +62300,14 @@ var init_windsurf = __esm(() => {
 
 // src/mcp/providers/zed.ts
 import { rmSync as rmSync6 } from "node:fs";
-import { homedir as homedir10, platform as platform3 } from "node:os";
+import { homedir as homedir9, platform as platform3 } from "node:os";
 import { join as join37 } from "node:path";
 function zedConfigDir() {
   const os = platform3();
   if (os === "win32")
     return join37(appSupportDir(), "Zed");
   if (os === "darwin")
-    return join37(homedir10(), ".config", "zed");
+    return join37(homedir9(), ".config", "zed");
   return join37(appSupportDir(), "zed");
 }
 function zedDataDir() {
@@ -62206,7 +62316,7 @@ function zedDataDir() {
     return join37(appSupportDir(), "Zed");
   if (os === "win32")
     return join37(process.env.LOCALAPPDATA ?? "", "Zed");
-  return join37(process.env.XDG_DATA_HOME ?? join37(homedir10(), ".local", "share"), "zed");
+  return join37(process.env.XDG_DATA_HOME ?? join37(homedir9(), ".local", "share"), "zed");
 }
 function legacyDarwinSettingsPath() {
   return platform3() === "darwin" ? join37(appSupportDir(), "Zed", "settings.json") : null;
@@ -62355,7 +62465,7 @@ import {
   writeFileSync as writeFileSync14,
   writeSync
 } from "node:fs";
-import { homedir as homedir11 } from "node:os";
+import { homedir as homedir10 } from "node:os";
 import { join as join38 } from "node:path";
 function statePath() {
   return join38(getConfigDir(), STATE_FILENAME2);
@@ -62490,7 +62600,7 @@ function startAutoUpdate(version, options = {}) {
       return claim === "held" ? "in_progress" : "unavailable";
     try {
       const child = spawn3(invocation.command, invocation.args, {
-        cwd: homedir11(),
+        cwd: homedir10(),
         detached: true,
         stdio: "ignore",
         windowsHide: true,
@@ -62891,7 +63001,7 @@ var init_follow = () => {};
 
 // src/sessions/session-title.ts
 import { existsSync as existsSync26, mkdirSync as mkdirSync16, readFileSync as readFileSync25, renameSync as renameSync6, statSync as statSync10, writeFileSync as writeFileSync17 } from "node:fs";
-import { homedir as homedir12 } from "node:os";
+import { homedir as homedir11 } from "node:os";
 import { join as join41 } from "node:path";
 function cachePath2(configDir) {
   return join41(configDir, CACHE_FILENAME5);
@@ -62946,7 +63056,7 @@ function claudeSummaryFromHead(text) {
   }
   return null;
 }
-function reconstructSession(harness, id, slug, home = homedir12(), exists = existsSync26) {
+function reconstructSession(harness, id, slug, home = homedir11(), exists = existsSync26) {
   if (!slug)
     return null;
   const candidates = [];
@@ -63622,13 +63732,13 @@ var init_activity_view = __esm(() => {
 
 // src/rules/installer.ts
 import { existsSync as existsSync28, mkdirSync as mkdirSync17, readFileSync as readFileSync27, unlinkSync as unlinkSync5, writeFileSync as writeFileSync18 } from "node:fs";
-import { homedir as homedir13 } from "node:os";
+import { homedir as homedir12 } from "node:os";
 import { dirname as dirname12, join as join42 } from "node:path";
 function claudeConfigDir4() {
-  return process.env.CLAUDE_CONFIG_DIR || join42(homedir13(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join42(homedir12(), ".claude");
 }
 function codexHome4() {
-  return process.env.CODEX_HOME || join42(homedir13(), ".codex");
+  return process.env.CODEX_HOME || join42(homedir12(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -63774,7 +63884,7 @@ var init_installer = __esm(() => {
     },
     cursor: {
       kind: "file",
-      path: () => join42(homedir13(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join42(homedir12(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
@@ -63783,15 +63893,15 @@ var init_installer = __esm(() => {
     },
     opencode: {
       kind: "section",
-      path: () => join42(homedir13(), ".config", "opencode", "AGENTS.md")
+      path: () => join42(homedir12(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join42(homedir13(), ".gemini", "GEMINI.md")
+      path: () => join42(homedir12(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join42(homedir13(), ".gemini", "GEMINI.md")
+      path: () => join42(homedir12(), ".gemini", "GEMINI.md")
     }
   };
 });
@@ -65582,7 +65692,7 @@ var init_flow2 = __esm(() => {
 // src/commands/upgrade.ts
 import { spawnSync } from "node:child_process";
 import { realpathSync as realpathSync2 } from "node:fs";
-import { homedir as homedir14 } from "node:os";
+import { homedir as homedir13 } from "node:os";
 import { posix, win32 as win322 } from "node:path";
 function isAbsoluteCommandProcessor(value) {
   return Boolean(value && win322.isAbsolute(value) && win322.basename(value).toLowerCase() === "cmd.exe");
@@ -65636,7 +65746,7 @@ function packageRoots(manager, platform, comSpec, env, cwd) {
     manager === "npm" ? path.join(lines[0], "@dosu", "cli") : path.join(lines[0], "node_modules", "@dosu", "cli")
   ];
 }
-function owningPackageManager(entrypoint, platform, comSpec, env = process.env, cwd = homedir14()) {
+function owningPackageManager(entrypoint, platform, comSpec, env = process.env, cwd = homedir13()) {
   const path = platform === "win32" ? win322 : posix;
   if (!entrypoint || !path.isAbsolute(entrypoint))
     return null;
@@ -65689,7 +65799,7 @@ Or install Dosu globally with your package manager:`);
 function runUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   const platform = options.platform ?? process.platform;
   const env = options.env ?? process.env;
-  const cwd = options.cwd ?? homedir14();
+  const cwd = options.cwd ?? homedir13();
   let manager = null;
   if (channel === "npm") {
     if (isNpxInvocation(channel, env)) {
@@ -65756,7 +65866,7 @@ function finishWithNewBinary(channel, options) {
     return;
   }
   const result = spawnSync(invocation.command, invocation.args, {
-    cwd: options.cwd ?? homedir14(),
+    cwd: options.cwd ?? homedir13(),
     shell: false,
     stdio: "inherit"
   });
@@ -66554,7 +66664,6 @@ var init_pages_view = __esm(() => {
 });
 
 // src/tui/tui.ts
-import { homedir as homedir15 } from "node:os";
 import { basename as basename6 } from "node:path";
 async function probeSession(cfg) {
   if (!isAuthenticated(cfg) || !isTokenExpired(cfg))
@@ -66783,8 +66892,9 @@ async function runSettings(cfg) {
   while (true) {
     const target = cfg.active_account?.target;
     const library = target?.library_name ?? target?.deployment_name ?? "not configured";
-    const filter = loadSyncState().project_filter;
-    const scope = !filter?.length ? "all projects" : filter.length <= 2 ? filter.map((dir) => dir === UNKNOWN_PROJECT ? "unknown" : basename6(dir)).join(", ") : `${filter.length} projects`;
+    const sync = loadSyncState();
+    const filter = sync.repo_filter;
+    const scope = !filter ? sync.project_filter?.length ? `${sync.project_filter.length} folders (legacy)` : "all repos" : filter.length === 0 ? "no repos" : filter.length <= 2 ? filter.map(displayRepo).join(", ") : `${filter.length} repos`;
     const action = await menuSelect("settings", [
       { label: "switch organization", hint: target?.org_name, value: "switch-org" },
       { label: "switch library", hint: library, value: "switch-library" },
@@ -66818,45 +66928,43 @@ async function runSettings(cfg) {
     }
   }
 }
-function displayDir(dir) {
-  const home = homedir15();
-  return dir === home ? "~" : dir.startsWith(`${home}/`) ? `~${dir.slice(home.length)}` : dir;
-}
-function discoverProjectDirs() {
+function discoverSessionRepos(current) {
   const counts = new Map;
   try {
     const resolver = createProjectDirResolver();
     for (const session of scanAgentSessions({})) {
-      const key = resolver.resolve(session) ?? UNKNOWN_PROJECT;
-      counts.set(key, (counts.get(key) ?? 0) + 1);
+      const repo = resolver.resolveRepo(session);
+      if (repo)
+        counts.set(repo, (counts.get(repo) ?? 0) + 1);
     }
     resolver.flush();
   } catch {}
-  return [...counts.entries()].sort((a, b) => b[1] - a[1]).map(([dir]) => dir);
+  for (const repo of current ?? [])
+    if (!counts.has(repo))
+      counts.set(repo, 0);
+  return [...counts.entries()].sort((a, b) => b[1] - a[1]).map(([repo]) => repo);
 }
 async function runStudyingProjectsSetting() {
-  const dirs = discoverProjectDirs();
-  if (dirs.length === 0) {
-    log2.info("No local agent sessions found yet; nothing to scope.");
+  const state = loadSyncState();
+  const current = studyRepoFilter(state, () => scanAgentSessions({}), createProjectDirResolver());
+  const repos = discoverSessionRepos(current);
+  if (repos.length === 0) {
+    log2.info("No agent sessions inside a git repo found yet; nothing to scope.");
     return;
   }
-  const current = loadSyncState().project_filter;
   const selected = await multiselect2({
-    message: "Study sessions from which folders?",
-    options: dirs.map((dir) => ({
-      label: dir === UNKNOWN_PROJECT ? "(unknown folder)" : displayDir(dir),
-      value: dir
-    })),
-    initialValues: current?.length ? current : dirs,
-    summary: (picked) => picked.length === dirs.length ? "all folders · new ones included automatically" : `${picked.length} of ${dirs.length} folders · subfolders included`,
-    validate: (picked) => picked.length === 0 ? "Select at least one folder." : undefined
+    message: "Study sessions from which repos?",
+    options: repos.map((repo) => ({ label: displayRepo(repo), hint: repo, value: repo })),
+    initialValues: current ?? repos,
+    summary: (picked) => picked.length === repos.length ? "all repos · new ones included automatically" : `${picked.length} of ${repos.length} repos`,
+    validate: (picked) => picked.length === 0 ? "Select at least one repo." : undefined
   });
   if (isCancel2(selected))
     return;
-  const { project_filter: _previous, ...state } = loadSyncState();
-  const all = selected.length === dirs.length;
-  saveSyncState(all ? state : { ...state, project_filter: [...selected] });
-  const scope = all ? "all folders" : selected.map(displayDir).join(", ");
+  const { repo_filter: _repos, project_filter: _folders, ...fresh } = loadSyncState();
+  const all = selected.length === repos.length;
+  saveSyncState(all ? fresh : { ...fresh, repo_filter: [...selected] });
+  const scope = all ? "all repos" : selected.map(displayRepo).join(", ");
   log2.success(`Study scope ${dim(`· ${scope}`)}`);
 }
 async function handleAuthenticate(cfg) {
@@ -66909,6 +67017,7 @@ var init_tui = __esm(() => {
   init_providers();
   init_generate();
   init_project_dir();
+  init_repo();
   init_scan();
   init_agents_md_step();
   init_flow2();
@@ -67631,7 +67740,7 @@ function createProgram(options = {}) {
   const program = new Command;
   let telemetryStarted = false;
   let telemetryValidationFailure = false;
-  program.name("dosu").description("Dosu CLI - Manage MCP servers for AI tools").version(getVersionString(), "-v, --version").helpCommand("help [command]", "Show help for a command").option("--debug", "Enable debug logging to stderr", false).hook("preAction", async (thisCommand, actionCommand) => {
+  program.name("dosu").description("Dosu CLI - Set up Dosu MCP for AI tools and work with Dosu Libraries, docs, reviews, and more").version(getVersionString(), "-v, --version").helpCommand("help [command]", "Show help for a command").option("--debug", "Enable debug logging to stderr", false).hook("preAction", async (thisCommand, actionCommand) => {
     const opts = thisCommand.optsWithGlobals();
     logger.init({ debug: opts.debug });
     if (shouldRunBackgroundChecks(actionCommand.name())) {
@@ -68117,4 +68226,4 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=da3b44a3-063b-fb2c-6475-6e2164756e21
+//# debugId=01f74cf6-cdbb-b296-6475-6e2164756e21

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dosu/cli",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "type": "module",
-  "description": "Dosu CLI - Manage MCP servers for AI tools",
+  "description": "Dosu CLI - Set up Dosu MCP for AI tools and work with Dosu Libraries, docs, and reviews",
   "license": "MIT",
   "repository": {
     "type": "git",