@dosu/cli 0.32.1 → 0.33.0

package/bin/dosu.js

@@ -4577,7 +4577,7 @@ var init_dist4 = __esm(() => {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.32.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.33.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -10981,6 +10981,160 @@ var init_providers = __esm(() => {
   init_zed();
 });
 
+// src/setup/audit-handoff.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+function buildAuditHandoffPrompt(dosuCmd = dosuInvocation()) {
+  return [
+    "Audit this repository to see what docs Dosu can generate for it.",
+    "1. Run the codebase audit from the Dosu skill. It writes findings to .dosu/audit.json.",
+    "2. Show me the findings and which docs you recommend Dosu generate.",
+    `3. Once I confirm, run \`${dosuCmd} audit --tasks <comma-separated task ids> --json\` to kick off generation. Dosu opens a PR and the CLI notifies me when it's ready.`
+  ].join(`
+`);
+}
+function binOnPath(bin) {
+  const cmd = process.platform === "win32" ? "where" : "which";
+  try {
+    return spawnSync2(cmd, [bin], { stdio: "ignore" }).status === 0;
+  } catch {
+    return false;
+  }
+}
+function claudeCliAvailable() {
+  return binOnPath("claude");
+}
+function dosuInvocation() {
+  return binOnPath("dosu") ? "dosu" : "npx -y @dosu/cli";
+}
+function printManualAuditNudge() {
+  log.message(`See what docs Dosu can generate for this repo:
+
+${info("Ask Dosu to audit this repo and show what docs it can generate.")}
+
+Or run ${info(`${dosuInvocation()} audit`)} after your agent writes the audit.`);
+}
+async function offerAuditHandoff() {
+  if (!detectGitRepo())
+    return false;
+  if (!claudeCliAvailable()) {
+    printManualAuditNudge();
+    return false;
+  }
+  const go = await confirm({
+    message: "Kick off the codebase audit in Claude Code now?",
+    initialValue: true
+  });
+  if (isCancel(go) || !go) {
+    printManualAuditNudge();
+    return false;
+  }
+  return true;
+}
+function launchAuditAgent() {
+  logger.info("setup", "Handing off to Claude Code for the codebase audit");
+  const result = spawnSync2("claude", ["--model", AUDIT_AGENT_MODEL, buildAuditHandoffPrompt()], {
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  if (result.error) {
+    logger.warn("setup", `Claude Code launch failed: ${result.error.message}`);
+    printManualAuditNudge();
+  }
+}
+var AUDIT_AGENT_MODEL = "haiku";
+var init_audit_handoff = __esm(() => {
+  init_dist8();
+  init_logger();
+  init_github_step();
+  init_styles();
+});
+
+// src/setup/agents-md-step.ts
+import { execSync as execSync3 } from "node:child_process";
+import { existsSync as existsSync16, readFileSync as readFileSync14, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join26 } from "node:path";
+function inGitWorkTree(cwd = process.cwd()) {
+  try {
+    const stdout2 = execSync3("git rev-parse --is-inside-work-tree", {
+      cwd,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return stdout2.toString().trim() === "true";
+  } catch {
+    return false;
+  }
+}
+function buildDosuAgentsSection(dosuCmd = dosuInvocation()) {
+  return [
+    DOSU_SECTION_START,
+    "## Dosu",
+    "",
+    "Shared team knowledge lives in [Dosu](https://dosu.dev), via the Dosu MCP server.",
+    "",
+    "- Before a task, and for any codebase or docs questions: pull context with `read_knowledge` before digging through source.",
+    "- After a task: save durable learnings with `write_knowledge`.",
+    "",
+    `Missing these tools? Run \`${dosuCmd} setup --help\` — it covers agent-assisted setup.`,
+    DOSU_SECTION_END
+  ].join(`
+`);
+}
+function upsertDosuAgentsSection(cwd = process.cwd(), dosuCmd = dosuInvocation()) {
+  const path3 = join26(cwd, "AGENTS.md");
+  const section = buildDosuAgentsSection(dosuCmd);
+  if (!existsSync16(path3)) {
+    writeFileSync7(path3, `${section}
+`);
+    return { path: path3, action: "created" };
+  }
+  const existing = readFileSync14(path3, "utf-8");
+  const startMatch = existing.match(SECTION_START_RE);
+  const start = startMatch?.index ?? -1;
+  const end = existing.indexOf(DOSU_SECTION_END);
+  let next;
+  if (start !== -1 && end !== -1 && end >= start) {
+    next = existing.slice(0, start) + section + existing.slice(end + DOSU_SECTION_END.length);
+  } else {
+    next = `${existing.trimEnd()}
+
+${section}
+`;
+  }
+  if (next === existing)
+    return { path: path3, action: "unchanged" };
+  writeFileSync7(path3, next);
+  return { path: path3, action: "updated" };
+}
+function stepUpdateAgentsMd(cwd = process.cwd()) {
+  logger.info("setup", "Step: update AGENTS.md");
+  try {
+    const result = upsertDosuAgentsSection(cwd);
+    logger.info("setup", `AGENTS.md ${result.action} at ${result.path}`);
+    if (result.action === "unchanged") {
+      log.success(`AGENTS.md
+${dim("Dosu section already up to date")}`);
+    } else {
+      log.success(`AGENTS.md
+${dim(`Dosu section ${result.action} — ${result.path}`)}`);
+    }
+    return true;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error("setup", `AGENTS.md update failed: ${msg}`);
+    log.error(`Could not update AGENTS.md: ${msg}`);
+    return false;
+  }
+}
+var DOSU_SECTION_VERSION = 1, DOSU_SECTION_START, DOSU_SECTION_END = "<!-- dosu:mcp:end -->", SECTION_START_RE;
+var init_agents_md_step = __esm(() => {
+  init_dist8();
+  init_logger();
+  init_audit_handoff();
+  init_styles();
+  DOSU_SECTION_START = `<!-- dosu:mcp:start v${DOSU_SECTION_VERSION} -->`;
+  SECTION_START_RE = /<!-- dosu:mcp:start(?: v(\d+))? -->/;
+});
+
 // src/setup/analytics.ts
 async function trackCliOnboardingEvent(cfg, onboardingRunID, event, properties = {}) {
   if (!cfg.access_token)
@@ -11066,74 +11220,6 @@ var init_analytics = __esm(() => {
   init_logger();
 });
 
-// src/setup/audit-handoff.ts
-import { spawnSync as spawnSync2 } from "node:child_process";
-function buildAuditHandoffPrompt(dosuCmd = dosuInvocation()) {
-  return [
-    "Audit this repository to see what docs Dosu can generate for it.",
-    "1. Run the codebase audit from the Dosu skill. It writes findings to .dosu/audit.json.",
-    "2. Show me the findings and which docs you recommend Dosu generate.",
-    `3. Once I confirm, run \`${dosuCmd} audit --tasks <comma-separated task ids> --json\` to kick off generation. Dosu opens a PR and the CLI notifies me when it's ready.`
-  ].join(`
-`);
-}
-function binOnPath(bin) {
-  const cmd = process.platform === "win32" ? "where" : "which";
-  try {
-    return spawnSync2(cmd, [bin], { stdio: "ignore" }).status === 0;
-  } catch {
-    return false;
-  }
-}
-function claudeCliAvailable() {
-  return binOnPath("claude");
-}
-function dosuInvocation() {
-  return binOnPath("dosu") ? "dosu" : "npx -y @dosu/cli";
-}
-function printManualAuditNudge() {
-  log.message(`See what docs Dosu can generate for this repo:
-
-${info("Ask Dosu to audit this repo and show what docs it can generate.")}
-
-Or run ${info(`${dosuInvocation()} audit`)} after your agent writes the audit.`);
-}
-async function offerAuditHandoff() {
-  if (!detectGitRepo())
-    return false;
-  if (!claudeCliAvailable()) {
-    printManualAuditNudge();
-    return false;
-  }
-  const go = await confirm({
-    message: "Kick off the codebase audit in Claude Code now?",
-    initialValue: true
-  });
-  if (isCancel(go) || !go) {
-    printManualAuditNudge();
-    return false;
-  }
-  return true;
-}
-function launchAuditAgent() {
-  logger.info("setup", "Handing off to Claude Code for the codebase audit");
-  const result = spawnSync2("claude", ["--model", AUDIT_AGENT_MODEL, buildAuditHandoffPrompt()], {
-    stdio: "inherit",
-    shell: process.platform === "win32"
-  });
-  if (result.error) {
-    logger.warn("setup", `Claude Code launch failed: ${result.error.message}`);
-    printManualAuditNudge();
-  }
-}
-var AUDIT_AGENT_MODEL = "haiku";
-var init_audit_handoff = __esm(() => {
-  init_dist8();
-  init_logger();
-  init_github_step();
-  init_styles();
-});
-
 // src/auth/errors.ts
 var exports_errors = {};
 __export(exports_errors, {
@@ -11718,7 +11804,7 @@ async function runSetup(opts = {}) {
   }
   cfg.api_key = apiKey;
   saveConfig(cfg);
-  const choices = await stepOneShotConfirm();
+  const choices = await stepOneShotConfirm(inGitWorkTree());
   if (!choices) {
     await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_cancelled", {
       reason: "options_cancelled"
@@ -11727,7 +11813,8 @@ async function runSetup(opts = {}) {
   }
   await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_options_selected", {
     configure_mcp: choices.configureMcp,
-    install_skill: choices.installSkill
+    install_skill: choices.installSkill,
+    update_agents_md: choices.updateAgentsMd
   });
   let mcpConfiguredThisRun = false;
   let mcpCompleted = false;
@@ -11756,14 +11843,19 @@ async function runSetup(opts = {}) {
       await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_skill_installed");
     }
   }
+  let agentsMdCompleted = false;
+  if (choices.updateAgentsMd) {
+    agentsMdCompleted = stepUpdateAgentsMd();
+  }
   let handoffToAudit = false;
   if (mcpConfiguredThisRun && cfg.mode !== MODE_OSS) {
     handoffToAudit = await offerAuditHandoff();
   }
-  if (mcpCompleted || skillCompleted) {
+  if (mcpCompleted || skillCompleted || agentsMdCompleted) {
     await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_completed", {
       completed_mcp: mcpCompleted,
-      completed_skill: skillCompleted
+      completed_skill: skillCompleted,
+      completed_agents_md: agentsMdCompleted
     });
   }
   if (cfg.mode === MODE_OSS) {
@@ -11792,11 +11884,14 @@ function applyModeOverride(cfg, opts) {
   }
   saveConfig(cfg);
 }
-async function stepOneShotConfirm() {
+async function stepOneShotConfirm(offerAgentsMd) {
   const items = [
     { value: "configureMcp", label: "Install Dosu MCP" },
     { value: "installSkill", label: "Install Dosu skill" }
   ];
+  if (offerAgentsMd) {
+    items.push({ value: "updateAgentsMd", label: "Add Dosu instructions to AGENTS.md" });
+  }
   const selected = await multiselect({
     message: "Dosu will set these up — press Enter to accept, space to toggle",
     options: items.map((it) => ({ value: it.value, label: it.label })),
@@ -11810,7 +11905,8 @@ async function stepOneShotConfirm() {
   const chosen = new Set(selected);
   return {
     configureMcp: chosen.has("configureMcp"),
-    installSkill: chosen.has("installSkill")
+    installSkill: chosen.has("installSkill"),
+    updateAgentsMd: chosen.has("updateAgentsMd")
   };
 }
 async function stepConfigureMcpTools(cfg) {
@@ -12263,14 +12359,15 @@ var init_flow2 = __esm(() => {
   init_config();
   init_logger();
   init_providers();
+  init_agents_md_step();
   init_analytics();
   init_audit_handoff();
   init_styles();
 });
 
 // src/commands/insights.ts
-import { existsSync as existsSync16, mkdirSync as mkdirSync8, readdirSync, unlinkSync, writeFileSync as writeFileSync7 } from "node:fs";
-import { dirname as dirname5, join as join26 } from "node:path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync8, readdirSync, unlinkSync, writeFileSync as writeFileSync8 } from "node:fs";
+import { dirname as dirname5, join as join27 } from "node:path";
 function shuffled(arr) {
   const copy2 = [...arr];
   for (let i2 = copy2.length - 1;i2 > 0; i2--) {
@@ -12374,17 +12471,17 @@ function makeAskFn(cfg) {
   };
 }
 function insightsDir() {
-  return join26(getConfigDir(), "insights");
+  return join27(getConfigDir(), "insights");
 }
 function reportPath(timestamp) {
   const dir = insightsDir();
   if (!timestamp)
-    return join26(dir, "latest.html");
+    return join27(dir, "latest.html");
   const iso = timestamp.toISOString().slice(0, 19).replace(/:/g, "-");
-  return join26(dir, `report-${iso}Z.html`);
+  return join27(dir, `report-${iso}Z.html`);
 }
 function pruneOldReports(dir, keepN) {
-  if (!existsSync16(dir))
+  if (!existsSync17(dir))
     return;
   let entries;
   try {
@@ -12396,7 +12493,7 @@ function pruneOldReports(dir, keepN) {
   const reports = entries.filter((f2) => REPORT_FILE_PATTERN.test(f2)).sort().reverse();
   for (const f2 of reports.slice(keepN)) {
     try {
-      unlinkSync(join26(dir, f2));
+      unlinkSync(join27(dir, f2));
     } catch (err) {
       logger.debug("insights", `failed to prune ${f2}: ${err instanceof Error ? err.message : err}`);
     }
@@ -12469,9 +12566,9 @@ function defaultRunner(cfg) {
     render: renderHTML,
     writeFile: (path3, content) => {
       const dir = dirname5(path3);
-      if (!existsSync16(dir))
+      if (!existsSync17(dir))
         mkdirSync8(dir, { recursive: true, mode: 448 });
-      writeFileSync7(path3, content, { mode: 384 });
+      writeFileSync8(path3, content, { mode: 384 });
     },
     prune: pruneOldReports,
     openInBrowser: async (path3) => {
@@ -13198,7 +13295,7 @@ var init_flow3 = __esm(() => {
 // src/cli/cli.ts
 init_commander();
 init_client();
-import { readFileSync as readFileSync16, unlinkSync as unlinkSync2 } from "node:fs";
+import { readFileSync as readFileSync17, unlinkSync as unlinkSync2 } from "node:fs";
 
 // src/commands/analytics.ts
 init_commander();
@@ -15260,7 +15357,7 @@ init_dist();
 init_commander();
 init_trpc();
 var import_picocolors19 = __toESM(require_picocolors(), 1);
-import { readFileSync as readFileSync14 } from "node:fs";
+import { readFileSync as readFileSync15 } from "node:fs";
 function requireConfig10() {
   return requireLoginConfig();
 }
@@ -15436,7 +15533,7 @@ function reviewCommand() {
     let body = opts.body;
     if (opts.bodyFile) {
       try {
-        body = readFileSync14(opts.bodyFile, "utf-8");
+        body = readFileSync15(opts.bodyFile, "utf-8");
       } catch (err) {
         console.error(import_picocolors19.default.red(`Failed to read --body-file: ${err.message}`));
         process.exit(1);
@@ -15956,8 +16053,8 @@ init_skill_update_check();
 init_config();
 init_logger();
 var import_picocolors24 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync17, mkdirSync as mkdirSync9, readFileSync as readFileSync15, writeFileSync as writeFileSync8 } from "node:fs";
-import { join as join27 } from "node:path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync9, readFileSync as readFileSync16, writeFileSync as writeFileSync9 } from "node:fs";
+import { join as join28 } from "node:path";
 var CACHE_FILENAME3 = "update-check.json";
 var CHECK_INTERVAL_MS3 = 24 * 60 * 60 * 1000;
 var FETCH_TIMEOUT_MS3 = 5000;
@@ -15980,14 +16077,14 @@ function isNewerVersion(latest, current) {
   return false;
 }
 function getCachePath3() {
-  return join27(getConfigDir(), CACHE_FILENAME3);
+  return join28(getConfigDir(), CACHE_FILENAME3);
 }
 function readCache() {
   try {
     const path3 = getCachePath3();
-    if (!existsSync17(path3))
+    if (!existsSync18(path3))
       return null;
-    const data = JSON.parse(readFileSync15(path3, "utf-8"));
+    const data = JSON.parse(readFileSync16(path3, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestVersion === "string") {
       return data;
     }
@@ -15999,10 +16096,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync17(dir)) {
+    if (!existsSync18(dir)) {
       mkdirSync9(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync8(getCachePath3(), JSON.stringify(cache), { mode: 384 });
+    writeFileSync9(getCachePath3(), JSON.stringify(cache), { mode: 384 });
   } catch {}
 }
 async function fetchLatestVersion() {
@@ -16366,7 +16463,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     if (opts.tail !== undefined) {
       const n2 = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
       try {
-        const content = readFileSync16(logPath, "utf-8");
+        const content = readFileSync17(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n2).join(`

package/package.json

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