breakaway 1.5.0-main.21 → 1.5.0-main.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "breakaway",
-  "version": "1.5.0-main.21",
+  "version": "1.5.0-main.22",
   "description": "The task board for you and your coding agents: a Cloudflare Worker, its web app, Taskwarrior sync, and the CLI (npx breakaway).",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/scripts/tasks/mcp.js

@@ -52,13 +52,23 @@ export function mcpConfig({ url, agent, repo = null, tokenVar }) {
  * docs/specs/IDEA-25-claude-plugin.md, section 4). Claude Code reads them as JSON from standard output, so the token is
  * its value here, and only there. Outside a repository the board tracks there's only Authorization, and the repository's
  * tools say what's missing; without a token there's none, so a session's proxy can add it.
- * @param {{ token?: string | null, agent: string, repo?: string | null }} options
+ *
+ * The agent's name is X-Breakaway-Agent only when the CLI has one of its own (`named`: --as, BREAKAWAY_AGENT, or
+ * tasks.env). Otherwise it's `agent`, claude-<branch>, as X-Breakaway-Agent-Default: the helper can't see the plugin's
+ * agent_name, which the plugin sends as a static X-Breakaway-Agent that this one would override, and /mcp takes the
+ * default only when that's empty (CLI-16).
+ * @param {{ token?: string | null, named?: string | null, agent: string, repo?: string | null }} options
  * @returns {Record<string, string>}
  */
-export function mcpHeaders({ token = null, agent, repo = null }) {
+export function mcpHeaders({ token = null, named = null, agent, repo = null }) {
   return {
     ...(token ? { Authorization: `Bearer ${token}` } : {}),
-    ...(repo ? { 'X-Breakaway-Agent': agent, 'X-Breakaway-Repo': repo } : {}),
+    ...(repo
+      ? {
+          ...(named ? { 'X-Breakaway-Agent': named } : { 'X-Breakaway-Agent-Default': agent }),
+          'X-Breakaway-Repo': repo,
+        }
+      : {}),
   };
 }
 

package/scripts/tasks.mjs

@@ -1637,7 +1637,8 @@ const commands = {
     } catch {
       /* not a git checkout */
     }
-    const name = mcpAgent({ named: opts.as ?? setting('AGENT'), branch, fallback: agent() });
+    const named = opts.as ?? setting('AGENT');
+    const name = mcpAgent({ named, branch, fallback: agent() });
     if (opts.headers) {
       const token = setting('TOKEN');
       let remote = null;
@@ -1659,7 +1660,7 @@ const commands = {
         fetch,
       });
       // Standard output is Claude Code's, and only the headers go there: never --json's wrapping, never a line of text.
-      console.log(JSON.stringify(mcpHeaders({ token, agent: name, repo })));
+      console.log(JSON.stringify(mcpHeaders({ token, named, agent: name, repo })));
       return;
     }
     const tokenVar = envName('TOKEN');
@@ -2540,8 +2541,9 @@ if (opts.help || command === 'help') {
   process.exitCode = (await import('./tasks/pipeline.js')).run(args, opts);
 } else if (!commands[command]) {
   fail(`no command "${command}". npx breakaway help lists them.`);
-} else if (!BASE && command !== 'init-secrets' && command !== 'hook') {
+} else if (!BASE && command !== 'init-secrets' && command !== 'hook' && !(command === 'mcp' && opts.headers)) {
   // The hooks stay quiet without a board (a plugin installed but not set up, CLI-8): session-hook.mjs checks for itself.
+  // The plugin's headersHelper never fails, and Claude Code tells it the board's address when only the plugin knows it.
   fail(
     `no board address. Set BREAKAWAY_URL (in the environment or ${ENV_FILE}), sync.server.url in this checkout's .taskrc, or the board's address in the breakaway plugin's settings (or run npx breakaway setup): see docs/tasks.md#another-install.`,
   );