@dosu/cli 0.40.0 → 0.42.0

package/README.md

@@ -54,13 +54,16 @@ dosu setup
 brew install dosu-ai/dosu/dosu
 ```
 
-Or tap first:
+The fully qualified name works on every Homebrew version: it taps the repo if needed and, on Homebrew 6.0+, records trust for just the `dosu` formula. To use tapped short names instead:
 
 ```bash
 brew tap dosu-ai/dosu
+brew trust dosu-ai/dosu   # Homebrew 6.0+ only — skip on older versions
 brew install dosu
 ```
 
+**Homebrew 6.0+ only** ([tap trust](https://docs.brew.sh/Tap-Trust), since June 2026): third-party taps start untrusted, so short-name installs or upgrades — including on machines that tapped `dosu-ai/dosu` before upgrading Homebrew — fail with `Error: Refusing to load formula dosu-ai/dosu/dosu from untrusted tap dosu-ai/dosu` until a one-time `brew trust dosu-ai/dosu` (the tap also ships [decant](https://github.com/dosu-ai/decant)). Homebrew 5 and earlier has no trust step and needs none. Tap trust is Homebrew's own consent step, separate from the macOS Gatekeeper warning below — Homebrew installs never trigger Gatekeeper.
+
 ### Manual Download
 
 Download the appropriate archive from the [Releases](https://github.com/dosu-ai/dosu-cli/releases) page.

package/bin/dosu.js

@@ -4759,7 +4759,7 @@ var init_dist4 = __esm(() => {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.40.0", INSTALL_CHANNEL = "npm";
+var VERSION = "0.42.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -8744,6 +8744,25 @@ function mcpHeaders(apiKey) {
   }
   return { "X-Dosu-API-Key": apiKey };
 }
+function mcpRemoteServer(url, apiKey) {
+  const env = {};
+  const headerArgs = Object.entries(mcpHeaders(apiKey)).flatMap(([key, value]) => {
+    const envKey = key.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+    env[envKey] = value;
+    return ["--header", `${key}:\${${envKey}}`];
+  });
+  return {
+    args: [
+      "-y",
+      `mcp-remote@${MCP_REMOTE_VERSION}`,
+      url,
+      ...headerArgs,
+      "--transport",
+      "http-only"
+    ],
+    env
+  };
+}
 function loadJSONConfig(path3) {
   if (!existsSync6(path3))
     return {};
@@ -8845,7 +8864,7 @@ function removeJSONServer(configPath, topKey) {
   }
   saveJSONConfig(configPath, jsonCfg);
 }
-var import_write_file_atomic, writeFileAtomic;
+var import_write_file_atomic, writeFileAtomic, MCP_REMOTE_VERSION = "0.1.38";
 var init_config_helpers = __esm(() => {
   import_write_file_atomic = __toESM(require_lib(), 1);
   writeFileAtomic = import_write_file_atomic.default;
@@ -10610,7 +10629,7 @@ var MCP_PROVIDER_SLUG = "dosu_mcp";
 // src/mcp/detect.ts
 import { existsSync as existsSync13 } from "node:fs";
 import { homedir as homedir2, platform as platform2 } from "node:os";
-import { join as join12 } from "node:path";
+import { delimiter, dirname as dirname5, join as join12 } from "node:path";
 function isInstalled(paths) {
   return paths.some((p2) => existsSync13(expandHome(p2)));
 }
@@ -10635,6 +10654,20 @@ function appSupportDir() {
     }
   }
 }
+function findNpx() {
+  const bin = platform2() === "win32" ? "npx.cmd" : "npx";
+  for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+    if (!dir)
+      continue;
+    const candidate = join12(dir, bin);
+    if (existsSync13(candidate))
+      return candidate;
+  }
+  throw new Error("npx not found on PATH — Node.js is required (the MCP entry runs `npx mcp-remote`).");
+}
+function npxPathEnv(npx) {
+  return [dirname5(npx), "/usr/bin", "/bin"].join(delimiter);
+}
 var init_detect = () => {};
 
 // src/mcp/providers/base.ts
@@ -10729,6 +10762,9 @@ var init_claude = __esm(() => {
 
 // src/mcp/providers/claude-desktop.ts
 import { join as join14 } from "node:path";
+function configPath() {
+  return join14(appSupportDir(), "Claude", "claude_desktop_config.json");
+}
 var ClaudeDesktopProvider = () => ({
   name: () => "Claude Desktop",
   id: () => "claude-desktop",
@@ -10736,16 +10772,31 @@ var ClaudeDesktopProvider = () => ({
   priority: () => 2,
   detectPaths: () => [join14(appSupportDir(), "Claude")],
   isInstalled: () => isInstalled([join14(appSupportDir(), "Claude")]),
-  globalConfigPath: () => join14(appSupportDir(), "Claude", "claude_desktop_config.json"),
-  isConfigured: () => false,
-  install() {
-    throw new Error("this tool only supports local (stdio) servers and cannot be configured for remote MCP");
+  globalConfigPath: () => configPath(),
+  isConfigured: () => isJSONKeyConfigured(configPath(), "mcpServers"),
+  install(cfg, global) {
+    if (!global)
+      throw new Error("Claude Desktop does not support local installation");
+    if (cfg.mode !== MODE_OSS && !cfg.active_account?.target?.deployment_id)
+      throw new Error("deployment ID is required");
+    const url = cfg.mode === MODE_OSS ? mcpBaseURL() : mcpURL(cfg.active_account.target.deployment_id);
+    const npx = findNpx();
+    const remote = mcpRemoteServer(url, cfg.active_account?.target?.api_key);
+    installJSONServer(configPath(), "mcpServers", {
+      command: npx,
+      args: remote.args,
+      env: { PATH: npxPathEnv(npx), ...remote.env }
+    });
   },
-  remove() {
-    throw new Error("this tool only supports local (stdio) servers and cannot be configured for remote MCP");
+  remove(global) {
+    if (!global)
+      throw new Error("Claude Desktop does not support local removal");
+    removeJSONServer(configPath(), "mcpServers");
   }
 });
 var init_claude_desktop = __esm(() => {
+  init_config();
+  init_config_helpers();
   init_detect();
 });
 
@@ -10824,20 +10875,25 @@ function mcpEndpoint(cfg) {
     throw new Error("deployment ID is required");
   return mcpURL(cfg.active_account?.target?.deployment_id);
 }
+function tomlString(value) {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+}
 function installDosuToTOML(path3, cfg) {
   let content = readTOML(path3);
   content = removeDosuFromTOML(content);
-  const url = mcpEndpoint(cfg);
-  const headers = mcpHeaders(cfg.active_account?.target?.api_key);
-  const headerEntries = Object.entries(headers).map(([k, v]) => `${k} = "${v}"`).join(`
+  const npx = findNpx();
+  const remote = mcpRemoteServer(mcpEndpoint(cfg), cfg.active_account?.target?.api_key);
+  const env = { PATH: npxPathEnv(npx), ...remote.env };
+  const envEntries = Object.entries(env).map(([key, value]) => `${key} = ${tomlString(value)}`).join(`
 `);
+  const args = remote.args.map(tomlString).join(", ");
   const section = `
 [mcp_servers.dosu]
-type = "http"
-url = "${url}"
-
-[mcp_servers.dosu.http_headers]
-${headerEntries}
+command = ${tomlString(npx)}
+args = [${args}]
+` + `
+[mcp_servers.dosu.env]
+${envEntries}
 `;
   content += section;
   writeTOML(path3, content);
@@ -10864,7 +10920,7 @@ function removeDosuFromTOML(content) {
 `);
 }
 var CodexProvider = () => ({
-  name: () => "Codex CLI",
+  name: () => "Codex (CLI + Desktop)",
   id: () => "codex",
   supportsLocal: () => true,
   priority: () => 8,
@@ -10928,21 +10984,21 @@ var CopilotProvider = () => ({
       };
       installJSONServer(globalPath(), "mcpServers", server);
     } else {
-      const configPath = join18(process.cwd(), ".vscode", "mcp.json");
+      const configPath2 = join18(process.cwd(), ".vscode", "mcp.json");
       const server = {
         type: "http",
         url,
         headers: mcpHeaders(cfg.active_account.target.api_key)
       };
-      installJSONServer(configPath, "servers", server);
+      installJSONServer(configPath2, "servers", server);
     }
   },
   remove(global) {
     if (global) {
       removeJSONServer(globalPath(), "mcpServers");
     } else {
-      const configPath = join18(process.cwd(), ".vscode", "mcp.json");
-      removeJSONServer(configPath, "servers");
+      const configPath2 = join18(process.cwd(), ".vscode", "mcp.json");
+      removeJSONServer(configPath2, "servers");
     }
   }
 });
@@ -11077,17 +11133,17 @@ var MCPorterProvider = () => ({
   globalConfigPath: () => resolveGlobalConfigPath(),
   isConfigured: () => isJSONKeyConfigured(resolveGlobalConfigPath(), "mcpServers"),
   install(cfg, global) {
-    const configPath = global ? resolveGlobalConfigPath() : join22(process.cwd(), "config", "mcporter.json");
+    const configPath2 = global ? resolveGlobalConfigPath() : join22(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
       url: mcpEndpoint4(cfg),
       headers: mcpHeaders(cfg.active_account.target.api_key)
     };
-    installJSONServer(configPath, "mcpServers", server);
+    installJSONServer(configPath2, "mcpServers", server);
   },
   remove(global) {
-    const configPath = global ? resolveGlobalConfigPath() : join22(process.cwd(), "config", "mcporter.json");
-    removeJSONServer(configPath, "mcpServers");
+    const configPath2 = global ? resolveGlobalConfigPath() : join22(process.cwd(), "config", "mcporter.json");
+    removeJSONServer(configPath2, "mcpServers");
   }
 });
 var init_mcporter = __esm(() => {
@@ -11236,7 +11292,7 @@ var init_providers = __esm(() => {
 // src/rules/installer.ts
 import { existsSync as existsSync16, mkdirSync as mkdirSync8, readFileSync as readFileSync14, unlinkSync, writeFileSync as writeFileSync7 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname5, join as join27 } from "node:path";
+import { dirname as dirname6, join as join27 } from "node:path";
 function claudeConfigDir() {
   return process.env.CLAUDE_CONFIG_DIR || join27(homedir4(), ".claude");
 }
@@ -11267,7 +11323,7 @@ async function fetchDosuRule(fetchImpl = globalThis.fetch) {
   return normalizeRule(FALLBACK_DOSU_RULE);
 }
 function ensureParent(path3) {
-  mkdirSync8(dirname5(path3), { recursive: true });
+  mkdirSync8(dirname6(path3), { recursive: true });
 }
 function writeIfChanged(path3, content) {
   if (!existsSync16(path3)) {
@@ -11370,6 +11426,8 @@ When \`read_knowledge\` is listed, call it before non-trivial code or documentat
 When \`write_knowledge\` is listed, use it after the task for durable, non-obvious knowledge that future work would otherwise have to rediscover. Do not save task or PR summaries, progress, test results, obvious facts, speculation, duplicates, or sensitive data. **If nothing durable was learned, do not write.**
 
 Use \`review_knowledge\` only when the user asks to inspect or manage pending knowledge. Preview one item at a time and require explicit confirmation before making changes.
+
+When \`read_knowledge\` or \`write_knowledge\` returned a \`receipt_item_id\` this turn, call \`finalize_session_knowledge\` exactly once at the end of the turn — after completing the task, immediately before your final reply — passing all receipt_item_ids from this turn. Never call it when the current turn produced no receipt_item_id, and never call it more than once per turn.
 `, RULE_TARGETS, SUPPORTED_RULE_AGENT_IDS;
 var init_installer = __esm(() => {
   DOSU_RULE_SECTION_START = `<!-- dosu:rules:start v${DOSU_RULE_SECTION_VERSION} -->`;
@@ -12221,8 +12279,7 @@ __export(exports_flow2, {
   stepDetectTools: () => stepDetectTools,
   stepConfigureTools: () => stepConfigureTools,
   runSetup: () => runSetup,
-  runInstallSkill: () => runInstallSkill,
-  isStdioOnly: () => isStdioOnly
+  runInstallSkill: () => runInstallSkill
 });
 import { randomUUID } from "node:crypto";
 async function runSetup(opts = {}) {
@@ -12769,11 +12826,8 @@ ${dim("created")}`);
     return null;
   }
 }
-function isStdioOnly(p2) {
-  return p2.id() === "claude-desktop";
-}
 function stepDetectTools() {
-  return allSetupProviders().filter((p2) => p2.isInstalled() && !isStdioOnly(p2));
+  return allSetupProviders().filter((p2) => p2.isInstalled());
 }
 async function stepSelectTools(detected) {
   const configuredMap = new Map;
@@ -12875,7 +12929,7 @@ var init_flow2 = __esm(() => {
 
 // src/commands/insights.ts
 import { existsSync as existsSync18, mkdirSync as mkdirSync9, readdirSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname6, join as join29 } from "node:path";
+import { dirname as dirname7, join as join29 } from "node:path";
 function shuffled(arr) {
   const copy2 = [...arr];
   for (let i2 = copy2.length - 1;i2 > 0; i2--) {
@@ -13073,7 +13127,7 @@ function defaultRunner(cfg) {
     build: buildInsights,
     render: renderHTML,
     writeFile: (path3, content) => {
-      const dir = dirname6(path3);
+      const dir = dirname7(path3);
       if (!existsSync18(dir))
         mkdirSync9(dir, { recursive: true, mode: 448 });
       writeFileSync9(path3, content, { mode: 384 });
@@ -13517,7 +13571,7 @@ __export(exports_flow3, {
 async function runAgentSetup(opts) {
   const provider = allSetupProviders().find((p2) => p2.id() === opts.tool.toLowerCase());
   if (!provider) {
-    const available = allSetupProviders().filter((p2) => !isStdioOnly(p2)).map((p2) => p2.id()).join(", ");
+    const available = allSetupProviders().map((p2) => p2.id()).join(", ");
     emitError({
       step: "setup",
       reason: "unknown_tool",
@@ -13525,14 +13579,6 @@ async function runAgentSetup(opts) {
     });
     return 2;
   }
-  if (isStdioOnly(provider)) {
-    emitError({
-      step: "setup",
-      reason: "tool_unsupported_in_agent_mode",
-      agent_next_steps: `${provider.name()} is not supported by agent setup. Tell the user to run 'dosu mcp add ${provider.id()}' manually after signing in.`
-    });
-    return 2;
-  }
   let cfg = loadConfig();
   if (opts.loginTicket) {
     const redeemed = await redeemTicket(opts.loginTicket, cfg);
@@ -13860,7 +13906,7 @@ function buildResumeCommand(tool, ticket, deploymentID) {
   return parts.join(" ");
 }
 function listAgentSupportedToolIDs() {
-  return allSetupProviders().filter((p2) => !isStdioOnly(p2)).map((p2) => p2.id());
+  return allSetupProviders().map((p2) => p2.id());
 }
 var NPX_INVOCATION = "npx @dosu/cli@latest";
 var init_flow3 = __esm(() => {
@@ -13872,7 +13918,6 @@ var init_flow3 = __esm(() => {
   init_providers();
   init_installer();
   init_agents_md_step();
-  init_flow2();
 });
 
 // src/cli/cli.ts

package/package.json

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