claude-task-worker 0.31.0 → 0.33.0

package/README.md

@@ -274,7 +274,7 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 }
 ```
 
-`mode` については [`mode`（タスクの実行形態）](#modeタスクの実行形態) を参照。
+`mode` については [`mode`（タスクの実行形態）](#modeタスクの実行形態) を、`headroom` については [`headroom`（Headroom 経由でのタスク実行）](#headroomheadroom-経由でのタスク実行) を参照。
 
 `--project` は繰り返し指定可能で、複数指定した場合は解決後のプロジェクト集合の和集合が対象になる（重複は一意化される）。`--epic` / `--label` と併用でき、ディスパッチ先の各プロジェクトで実行されるコマンドにそのまま引き継がれる。
 
@@ -331,6 +331,31 @@ claude-task-worker exec-issue --project app-a --epic 100 --label priority-high
 
   適用は `herdr server reload-config`。この設定は herdr サーバー全体に効くため、ワーカー以外の対話セッションの完了音も鳴らなくなる（`[ui.sound.agents] claude = "off"` でも実質同じ範囲）。ワーカーだけを無音にしたい場合は、`HERDR_DISABLE_SOUND=1 herdr --session <name>` で別セッションを起動し、その中でディスパッチャーを動かす
 
+### `headroom`（Headroom 経由でのタスク実行）
+
+`config.json` のトップレベルに `"headroom": true` を書くと、ワーカーは各タスクの claude を [Headroom](https://github.com/headroom-ai/headroom) 経由（`headroom wrap claude`）で起動する。Headroom がローカルプロキシを立ててコンテキストを圧縮し、`ANTHROPIC_BASE_URL` を差し替えた状態で claude を起動する。既定は `false`（`claude` を直接起動する）。
+
+`mode` と同じくトップレベル一括の設定で、プロジェクト単位・ワーカー単位の指定はできない。
+
+```json
+{
+  "headroom": true,
+  "projects": { "app-a": "/Users/me/repos/app-a" }
+}
+```
+
+| `headroom` | 実行されるコマンド |
+|-----------|------------------|
+| `false`（既定） | `claude <引数>` |
+| `true` | `headroom wrap claude -- <引数>` |
+
+補足:
+
+- `mode` とは独立して組み合わせられる（`mode: "herdr"` の TUI 起動も `headroom wrap claude` になる）
+- claude へ渡す引数はすべて `--` の後ろに置かれる。`headroom wrap claude` 自身も `--port` / `--memory` などのオプションを持ち、`-p` のように衝突しうるフラグは `--` の後ろでないと claude に届かないため
+- `headroom: true` で headroom コマンドが PATH に無い場合、ワーカーは起動時にエラー終了する（`mode: "herdr"` と同じく、サイレントに直接起動へフォールバックはしない）
+- `headroom wrap claude` は claude を起動する前に起動バナー（枠線・`ANTHROPIC_BASE_URL=...` など）を stdout へ出力し、これを抑止するオプションは無い。ワーカーは空振りセッション検知（exit 0 かつ無出力を失敗とみなす判定）の前にこのバナーを取り除くため、検知は `headroom: true` でも従来どおり機能する。ただし Slack 通知の本文にはバナーがそのまま含まれる
+
 ### exec-issue
 
 `cc-exec-issue` ラベルが付いた自分にアサインされたIssueを定期取得し、Claude Codeで処理を実行する。（デフォルト1分間隔）

package/dist/index.js

@@ -132,6 +132,38 @@ var init_table = __esm({
   }
 });
 
+// src/task-result.ts
+function stripHeadroomBanner(stdout) {
+  const lines = stdout.split("\n");
+  let i = 0;
+  while (i < lines.length && (lines[i].trim() === "" || lines[i].startsWith("  "))) i++;
+  return lines.slice(i).join("\n");
+}
+function buildTaskResult(code, stdout, stderrTail, options) {
+  const meaningful = options?.headroom ? stripHeadroomBanner(stdout) : stdout;
+  const emptyOutput = meaningful.trim() === "";
+  const completed = code === 0 && !emptyOutput;
+  let output = stdout;
+  if (code === 0 && emptyOutput) {
+    output += "[worker] claude exited with code 0 but produced no output (session aborted before the model ran; e.g. a skill preamble command failed)";
+  } else if (!completed) {
+    output += `
+[worker] claude exited with code ${code}`;
+  }
+  if (!completed && stderrTail.trim() !== "") {
+    output += `
+[stderr] ${stderrTail.trim()}`;
+  }
+  return { status: completed ? "completed" : "failed", output };
+}
+var STDERR_TAIL_LIMIT;
+var init_task_result = __esm({
+  "src/task-result.ts"() {
+    "use strict";
+    STDERR_TAIL_LIMIT = 8 * 1024;
+  }
+});
+
 // src/herdr.ts
 var herdr_exports = {};
 __export(herdr_exports, {
@@ -490,8 +522,9 @@ function observeAgentStatus(tracker, status) {
   }
   return { tracker, decision: "running" };
 }
-function buildHerdrTaskResult(paneOutput) {
-  if (paneOutput.trim() === "") {
+function buildHerdrTaskResult(paneOutput, options) {
+  const meaningful = options?.headroom ? stripHeadroomBanner(paneOutput) : paneOutput;
+  if (meaningful.trim() === "") {
     return {
       status: "failed",
       output: "[worker] the claude session became idle but its pane produced no output (session aborted before the model ran; e.g. a skill preamble command failed)"
@@ -549,7 +582,7 @@ async function waitForHerdrTask(paneId, options) {
     tracker = observed.tracker;
     if (observed.decision === "completed") {
       const output = await readPaneOutput(paneId, mod);
-      return buildHerdrTaskResult(output);
+      return buildHerdrTaskResult(output, { headroom: options?.headroom });
     }
     if (observed.decision === "blocked-first-seen") {
       options?.onBlocked?.();
@@ -609,6 +642,7 @@ var AGENT_POLL_INTERVAL_MS, PANE_OUTPUT_LINES, CLAUDE_EXIT_TIMEOUT_MS, CLAUDE_EX
 var init_herdr_runner = __esm({
   "src/herdr-runner.ts"() {
     "use strict";
+    init_task_result();
     AGENT_POLL_INTERVAL_MS = 3 * 1e3;
     PANE_OUTPUT_LINES = 300;
     CLAUDE_EXIT_TIMEOUT_MS = 15 * 1e3;
@@ -1378,6 +1412,9 @@ var SYSTEM_PROMPT = `\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306F \`claude-t
 - CodeGraph \u304C\u8FD4\u3057\u305F\u30BD\u30FC\u30B9\u306F\u300C\u8AAD\u307F\u7D42\u3048\u305F\u3082\u306E\u300D\u3068\u3057\u3066\u6271\u3044\u3001\u540C\u3058\u7B87\u6240\u3092 \`Grep\`/\`Read\` \u3067\u88CF\u53D6\u308A\u3057\u76F4\u3055\u306A\u3044\u3002\u305F\u3060\u3057\u51FA\u529B\u306B staleness\uFF08\u30A4\u30F3\u30C7\u30C3\u30AF\u30B9\u304C\u53E4\u3044\u65E8\uFF09\u306E\u8B66\u544A\u304C\u51FA\u3066\u3044\u308B\u5834\u5408\u306F\u8A72\u5F53\u30D5\u30A1\u30A4\u30EB\u3092 \`Read\` \u3057\u3066\u73FE\u7269\u3092\u78BA\u8A8D\u3059\u308B
 - \u8A2D\u5B9A\u30D5\u30A1\u30A4\u30EB\u30FB\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u30FB\u30B3\u30E1\u30F3\u30C8/\u6587\u5B57\u5217\u30EA\u30C6\u30E9\u30EB\u30FB\u672A\u5BFE\u5FDC\u8A00\u8A9E\u306A\u3069 CodeGraph \u304C\u6271\u308F\u306A\u3044\u5BFE\u8C61\u306F\u3001\u5F93\u6765\u3069\u304A\u308A\u30C6\u30AD\u30B9\u30C8\u691C\u7D22\u3067\u88DC\u3046
 - \u63A2\u7D22\u3092\u30B5\u30D6\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u3078\u59D4\u8B72\u3059\u308B\u5834\u5408\u306F\u3001\u3053\u306E\u65B9\u91DD\u3082\u59D4\u8B72\u30D7\u30ED\u30F3\u30D7\u30C8\u306B\u660E\u8A18\u3057\u3066\u4F1D\u3048\u308B`;
+var CLAUDE_COMMAND = "claude";
+var HEADROOM_COMMAND = "headroom";
+var HEADROOM_WRAP_OPTIONS = ["--1m", "--memory", "--code-graph"];
 function buildClaudeArgs({ mode, prompt, model, effort }) {
   return [
     ...mode === "herdr" ? [] : ["-p"],
@@ -1394,6 +1431,16 @@ function buildClaudeArgs({ mode, prompt, model, effort }) {
     effort
   ];
 }
+function buildClaudeExecution(invocation) {
+  const args = buildClaudeArgs(invocation);
+  if (!invocation.headroom) {
+    return { command: CLAUDE_COMMAND, args };
+  }
+  return {
+    command: HEADROOM_COMMAND,
+    args: ["wrap", CLAUDE_COMMAND, ...HEADROOM_WRAP_OPTIONS, "--", ...args]
+  };
+}
 function buildClaudeEnv(mode) {
   if (mode === "herdr") {
     return {
@@ -1648,25 +1695,7 @@ async function assertRemoteTrackingExists(epicBranch) {
 import { spawn } from "node:child_process";
 import { basename } from "node:path";
 init_table();
-
-// src/task-result.ts
-var STDERR_TAIL_LIMIT = 8 * 1024;
-function buildTaskResult(code, stdout, stderrTail) {
-  const emptyOutput = stdout.trim() === "";
-  const completed = code === 0 && !emptyOutput;
-  let output = stdout;
-  if (code === 0 && emptyOutput) {
-    output += "[worker] claude exited with code 0 but produced no output (session aborted before the model ran; e.g. a skill preamble command failed)";
-  } else if (!completed) {
-    output += `
-[worker] claude exited with code ${code}`;
-  }
-  if (!completed && stderrTail.trim() !== "") {
-    output += `
-[stderr] ${stderrTail.trim()}`;
-  }
-  return { status: completed ? "completed" : "failed", output };
-}
+init_task_result();
 
 // src/user-config.ts
 import { readFileSync as readFileSync2, statSync } from "node:fs";
@@ -1674,6 +1703,7 @@ import { homedir } from "node:os";
 import { isAbsolute, join as join2, resolve } from "node:path";
 var RESERVED_ALL = "all";
 var DEFAULT_RUN_MODE = "default";
+var DEFAULT_HEADROOM = false;
 var UserConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -1722,6 +1752,13 @@ function parseMode(raw, path) {
   console.warn(`[config] invalid mode: ${JSON.stringify(value)} in ${path}, using "${DEFAULT_RUN_MODE}"`);
   return DEFAULT_RUN_MODE;
 }
+function parseHeadroom(raw, path) {
+  if (!("headroom" in raw)) return DEFAULT_HEADROOM;
+  const value = raw["headroom"];
+  if (typeof value === "boolean") return value;
+  console.warn(`[config] invalid headroom: ${JSON.stringify(value)} in ${path}, using ${DEFAULT_HEADROOM}`);
+  return DEFAULT_HEADROOM;
+}
 function loadUserConfig() {
   const path = getUserConfigPath();
   const raw = readRawConfig();
@@ -1738,6 +1775,7 @@ function loadUserConfig() {
     throw new UserConfigError(`config.json "projectGroups" must be an object: ${path}`);
   }
   const mode = parseMode(raw, path);
+  const headroom = parseHeadroom(raw, path);
   const rawProjects = raw["projects"];
   const rawProjectGroups = "projectGroups" in raw ? raw["projectGroups"] : {};
   const projectKeys = Object.keys(rawProjects);
@@ -1788,7 +1826,7 @@ function loadUserConfig() {
     }
     projectGroups[groupName] = members;
   }
-  return { mode, projects, projectGroups };
+  return { mode, headroom, projects, projectGroups };
 }
 var cachedRunMode;
 function getRunMode() {
@@ -1798,18 +1836,35 @@ function getRunMode() {
   return cachedRunMode;
 }
 function readRunMode() {
+  const raw = readTopLevelConfig(`using "${DEFAULT_RUN_MODE}" mode`);
+  if (raw === void 0) return DEFAULT_RUN_MODE;
+  return parseMode(raw, getUserConfigPath());
+}
+var cachedHeadroom;
+function getHeadroomEnabled() {
+  if (cachedHeadroom === void 0) {
+    cachedHeadroom = readHeadroom();
+  }
+  return cachedHeadroom;
+}
+function readHeadroom() {
+  const raw = readTopLevelConfig(`using headroom=${DEFAULT_HEADROOM}`);
+  if (raw === void 0) return DEFAULT_HEADROOM;
+  return parseHeadroom(raw, getUserConfigPath());
+}
+function readTopLevelConfig(fallbackDescription) {
   let raw;
   try {
     raw = readRawConfig();
   } catch (err) {
-    console.warn(`[config] failed to read config file, using "${DEFAULT_RUN_MODE}" mode: ${err}`);
-    return DEFAULT_RUN_MODE;
+    console.warn(`[config] failed to read config file, ${fallbackDescription}: ${err}`);
+    return void 0;
   }
-  if (raw === void 0) return DEFAULT_RUN_MODE;
+  if (raw === void 0) return void 0;
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return DEFAULT_RUN_MODE;
+    return void 0;
   }
-  return parseMode(raw, getUserConfigPath());
+  return raw;
 }
 function findProjectNameByPath(path) {
   let config;
@@ -1945,6 +2000,7 @@ async function runViaHerdr(command, args, id, onComplete, cwd, env) {
     herdrTasks.set(id, task);
     result = await waitForHerdrTask2(task.paneId, {
       signal: herdrAbortSignal,
+      headroom: getHeadroomEnabled(),
       onBlocked: () => console.warn(`[worker] #${id} is blocked and waiting for input in herdr tab "${label}"`),
       onStatus: (status) => {
         const task2 = tasks.get(id);
@@ -2002,7 +2058,8 @@ function run(command, args, id, title, workerName, path, onComplete, cwd, env) {
     const result = buildTaskResult(
       code,
       Buffer.concat(outputChunks).toString("utf-8"),
-      Buffer.concat(stderrChunks).toString("utf-8").slice(-STDERR_TAIL_LIMIT)
+      Buffer.concat(stderrChunks).toString("utf-8").slice(-STDERR_TAIL_LIMIT),
+      { headroom: getHeadroomEnabled() }
     );
     await finishTask(id, result, onComplete);
     childProcesses.delete(id);
@@ -2711,7 +2768,13 @@ function createIssuePollingWorker(config) {
             const command = skill || config.command;
             const parentNumber = issue.parent?.number;
             const mode = getRunMode();
-            const claudeArgs = buildClaudeArgs({ mode, prompt: `${command} ${issue.number}`, model, effort });
+            const execution = buildClaudeExecution({
+              mode,
+              prompt: `${command} ${issue.number}`,
+              model,
+              effort,
+              headroom: getHeadroomEnabled()
+            });
             let baseBranch = defaultBranch;
             if (parentNumber !== void 0) {
               baseBranch = `cc-epic-${parentNumber}`;
@@ -2721,8 +2784,8 @@ function createIssuePollingWorker(config) {
             const cwd = getWorktreePath(worktreeId);
             console.log(`[${config.name}] #${issue.number}: created worktree ${worktreeId} from ${baseBranch}`);
             run(
-              "claude",
-              claudeArgs,
+              execution.command,
+              execution.args,
               issue.number,
               issue.title,
               config.name,
@@ -2877,9 +2940,16 @@ function createPrPollingWorker(config) {
             const { model, effort, skill } = getWorkerConfig(config.name);
             const command = skill || config.command;
             const mode = getRunMode();
+            const execution = buildClaudeExecution({
+              mode,
+              prompt: `${command} ${pr.number}`,
+              model,
+              effort,
+              headroom: getHeadroomEnabled()
+            });
             run(
-              "claude",
-              buildClaudeArgs({ mode, prompt: `${command} ${pr.number}`, model, effort }),
+              execution.command,
+              execution.args,
               pr.number,
               `PR #${pr.number} (${pr.headRefName})`,
               config.name,
@@ -3543,6 +3613,23 @@ async function assertRunModeAvailable() {
   }
   console.log("[worker] run mode: herdr (each task runs as a TUI session in its own herdr tab)");
 }
+async function assertHeadroomAvailable() {
+  if (!getHeadroomEnabled()) return;
+  const { execFile: execFile3 } = await import("node:child_process");
+  const { promisify: promisify4 } = await import("node:util");
+  try {
+    await promisify4(execFile3)(HEADROOM_COMMAND, ["--version"]);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`[worker] config.json has headroom: true but the headroom CLI is unavailable: ${message}`);
+    process.exit(1);
+  }
+  console.log("[worker] headroom: enabled (each task runs as `headroom wrap claude`)");
+}
+async function assertRunPrerequisites() {
+  await assertRunModeAvailable();
+  await assertHeadroomAvailable();
+}
 if (!hasProjectFilter()) {
   process.on("SIGTERM", async () => {
     if (isShuttingDown()) return;
@@ -3631,7 +3718,7 @@ if (hasProjectFilter()) {
   const epicFilters = parseEpicFilters();
   const labelFilters = parseLabelFilters();
   (async () => {
-    await assertRunModeAvailable();
+    await assertRunPrerequisites();
     await removeStaleWorktrees();
     await Promise.all([
       execIssueWorker({ epicFilters, labelFilters }),
@@ -3647,7 +3734,7 @@ if (hasProjectFilter()) {
   const epicFilters = parseEpicFilters();
   const labelFilters = parseLabelFilters();
   (async () => {
-    await assertRunModeAvailable();
+    await assertRunPrerequisites();
     await removeStaleWorktrees();
     await Promise.all([
       execIssueWorker({ epicFilters, labelFilters }),
@@ -3666,7 +3753,7 @@ if (hasProjectFilter()) {
   const epicFilters = parseEpicFilters();
   const labelFilters = parseLabelFilters();
   (async () => {
-    await assertRunModeAvailable();
+    await assertRunPrerequisites();
     await removeStaleWorktrees();
     await WORKERS[workerType]({ epicFilters, labelFilters });
   })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-task-worker",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "CLI tool that polls GitHub Issues/PRs and delegates work to Claude CLI",
   "type": "module",
   "main": "dist/index.js",