claude-task-worker 0.101.0 → 0.103.0

package/README.md

@@ -61,7 +61,7 @@ CLI が GitHub ラベルを検知してタスクを起動し、プラグイン
 | [Pen CLI](https://docs.pen.dev/for-developers/pen-cli) | `.pen` の編集・参照。UIデザイン先行ワークフロー使用時のみ（要ログイン） |
 | [Playwright](https://playwright.dev/) のブラウザ | Playwright MCP でのブラウザ確認 |
 | [DESIGN.md CLI](https://github.com/google-labs-code/design.md) | `DESIGN.md` の lint。`update-design-md` 使用時のみ（未導入でも動く） |
-| [herdr](https://herdr.dev) | `--project` / `mode: "herdr"` 使用時のみ（`--cloud` は起動ゲートこそ herdr を要求しないが、実行経路の分岐が未追随のため現状は `mode: "herdr"` が要る） |
+| [herdr](https://herdr.dev) | `--project` / `mode: "herdr"` 使用時のみ（`--cloud` は herdr に依存しない） |
 | [GitHub MCP](https://github.com/github/github-mcp-server) | GitHub アクセスの高速化・クラウド実行時のプロキシ制限回避（任意。Claude 側のコネクタで有効化） |
 
 CLI 本体に npm の実行時依存はない（Node.js 標準モジュールのみで動作する）。
@@ -205,7 +205,7 @@ npx claude-task-worker cloud-setup
 - 完了は `cc-cloud-done` ラベルで検知する。4時間で応答がなければ打ち切り、`cc-need-human-check` を付けて失敗通知する
 - `--project` と併用した場合、`--cloud` は各プロジェクトへそのまま転送される
 - `--cloud` と併用できないコマンド: `init` / `install` / `update` / `usage` / `version`
-- **現時点では `mode: "default"` での `--cloud` はクラウド経路へ流れない**（実行経路の分岐が `mode: "herdr"` 判定のまま未追随のため）。`--cloud` を使うには `mode: "herdr"` にしておく必要がある。追随は別Issueで対応予定
+- `--cloud` は `mode`（`default` / `herdr`）に依存しない。クラウドセッションの作成は `script` コマンドの疑似 pty で完結し、herdr のペインを使わないため、どちらの `mode` でも同じ経路を通る
 
 詳細は [`docs/prd-cloud-worker-execution.md`](./docs/prd-cloud-worker-execution.md) を参照。
 
@@ -258,10 +258,25 @@ CI やクラウド VM など対話ログインできない環境では、環境
 | キー | 型 | 既定 | 説明 |
 |---|---|---|---|
 | `fixReviewPointCallbackCommentMessage` | string | - | `fix-review-point` 完了時に PR へ投稿するコメント（未設定なら投稿しない） |
+| `remoteEnvId` | string \| null | `null` | クラウド実行（`--cloud`）時に `--environment` へ渡すクラウド環境ID。`null` なら渡さず claude 側の既定解決に任せる（下記） |
 | `uiDesign` | object | `{ "enabled": false, "designDir": "designs", "yolo": false }` | UIデザイン先行ワークフロー（下記） |
 | `workers` | object | `{}` | ワーカーごとの上書き設定（下記） |
 | `lastRun` | object | `{}` | 定期ワーカーの最終実行時刻。ワーカーが自動更新するため手で編集しない |
 
+#### `claude-task-worker.local.json`（ローカル上書き）
+
+同じディレクトリに `claude-task-worker.local.json` を置くと、`claude-task-worker.json` と同じキーを書けて**同じキーはローカル側が勝つ**。マージはネストしたオブジェクトのキー単位（`workers.<name>.model` だけを差し替えられる。配列・スカラーは丸ごと置き換え）。
+
+コミットしない前提のファイルで、`claude-task-worker init` が `.gitignore` へ登録する。`remoteEnvId` のように各自の環境で値が違う設定を置く。
+
+#### クラウド環境の指定（`remoteEnvId`）
+
+`--cloud` 実行時に `claude --environment <id>` へ渡す環境ID。指定しない場合の選択は claude CLI に任せる（`~/.claude/settings.json` の `remote.defaultEnvironmentId` → アカウントの最初の `anthropic_cloud` 環境 → 無ければ自動作成）。ID は claude.ai の環境設定、または `/remote-env` で確認できる。自己ホスト環境（`ccpool_...`）も同じキーに書ける。
+
+```json
+{ "remoteEnvId": "env_xxxxxxxx" }
+```
+
 #### ワーカーごとの設定
 
 未指定のワーカー・フィールドは既定値にフォールバックする。

package/dist/index.js

@@ -12,6 +12,7 @@ var __export = (target, all) => {
 // src/table.ts
 var table_exports = {};
 __export(table_exports, {
+  CLOUD_WORKTREE_LABEL: () => CLOUD_WORKTREE_LABEL,
   CONTROL_CHARS: () => CONTROL_CHARS,
   LOG_DISPLAY_LIMIT: () => LOG_DISPLAY_LIMIT,
   TASK_DISPLAY_LIMIT: () => TASK_DISPLAY_LIMIT,
@@ -29,7 +30,7 @@ __export(table_exports, {
 import { format } from "node:util";
 function getDisplayWidth(str) {
   let width = 0;
-  for (const char of str) {
+  for (const char of str.replace(CONTROL_CHARS, "")) {
     const code = char.codePointAt(0);
     if (code >= 4352 && code <= 4447 || code >= 11904 && code <= 12350 || code >= 12352 && code <= 13247 || code >= 13312 && code <= 19903 || code >= 19968 && code <= 42191 || code >= 44032 && code <= 55215 || code >= 63744 && code <= 64255 || code >= 65072 && code <= 65135 || code >= 65281 && code <= 65376 || code >= 65504 && code <= 65510 || code >= 131072 && code <= 196605 || code >= 196608 && code <= 262141) {
       width += 2;
@@ -181,10 +182,11 @@ function buildLogTableLines(entries) {
   });
   return renderBoxTable(["Time", "#", "Stream", "Log"], [rows]);
 }
-var TASK_DISPLAY_LIMIT, LOG_DISPLAY_LIMIT, logLines, rawLog, rawClear, consoleCaptured, CONTROL_CHARS;
+var CLOUD_WORKTREE_LABEL, TASK_DISPLAY_LIMIT, LOG_DISPLAY_LIMIT, logLines, rawLog, rawClear, consoleCaptured, CONTROL_CHARS;
 var init_table = __esm({
   "src/table.ts"() {
     "use strict";
+    CLOUD_WORKTREE_LABEL = "\x1B[36m\u2601 running in cloud\x1B[0m";
     TASK_DISPLAY_LIMIT = 20;
     LOG_DISPLAY_LIMIT = 20;
     logLines = [];
@@ -1905,11 +1907,13 @@ function checkCloudConfig(input) {
 }
 var DEFAULT_CONFIG = {
   fixReviewPointCallbackCommentMessage: "",
+  remoteEnvId: null,
   uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG },
   lastRun: {},
   workers: {}
 };
 var CONFIG_PATH = join(process.cwd(), "claude-task-worker.json");
+var LOCAL_CONFIG_PATH = join(process.cwd(), "claude-task-worker.local.json");
 function defaultsFor(name) {
   return WORKER_DEFAULTS[name] ?? DEFAULT_WORKER_CONFIG;
 }
@@ -2041,18 +2045,44 @@ function parseLastRunEntry(val) {
   }
   return result;
 }
-function loadConfig() {
-  const configPath = CONFIG_PATH;
-  let raw;
+function isPlainObject(val) {
+  return typeof val === "object" && val !== null && !Array.isArray(val);
+}
+function mergeConfigRaw(base, local) {
+  const result = { ...base };
+  for (const [key, val] of Object.entries(local)) {
+    const current = result[key];
+    result[key] = isPlainObject(current) && isPlainObject(val) ? mergeConfigRaw(current, val) : val;
+  }
+  return result;
+}
+function readRawConfig(path2) {
+  let parsed;
   try {
-    raw = JSON.parse(readFileSync(configPath, "utf-8"));
+    parsed = JSON.parse(readFileSync(path2, "utf-8"));
   } catch (err) {
-    if (err.code === "ENOENT") {
-      return { ...DEFAULT_CONFIG, uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG }, lastRun: {}, workers: {} };
-    }
+    if (err.code === "ENOENT") return {};
     throw err;
   }
+  if (!isPlainObject(parsed)) {
+    console.warn(`[config] invalid ${path2}: expected object, ignoring`);
+    return {};
+  }
+  return parsed;
+}
+function loadConfig() {
+  const raw = mergeConfigRaw(readRawConfig(CONFIG_PATH), readRawConfig(LOCAL_CONFIG_PATH));
   const result = { ...DEFAULT_CONFIG, uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG }, lastRun: {}, workers: {} };
+  if ("remoteEnvId" in raw) {
+    const val = raw["remoteEnvId"];
+    if (val === null) {
+      result.remoteEnvId = null;
+    } else if (typeof val === "string" && val.trim().length > 0) {
+      result.remoteEnvId = val.trim();
+    } else {
+      console.warn(`[config] invalid remoteEnvId: ${String(val)}, using default null`);
+    }
+  }
   if ("lastRun" in raw) {
     result.lastRun = parseLastRunEntry(raw["lastRun"]);
   }
@@ -2112,6 +2142,14 @@ function writeLastRun(repoRoot, workerName, at = /* @__PURE__ */ new Date()) {
   writeFileSync(path2, `${JSON.stringify(raw, null, 2)}
 `, "utf-8");
 }
+function getRemoteEnvId() {
+  try {
+    return loadConfig().remoteEnvId;
+  } catch (err) {
+    console.warn(`[config] failed to load remoteEnvId, not passing --environment: ${err}`);
+    return null;
+  }
+}
 function getUiDesignConfig() {
   try {
     return loadConfig().uiDesign;
@@ -2175,7 +2213,7 @@ function parseConfigFile(path2) {
     throw err;
   }
 }
-function readRawConfig() {
+function readRawConfig2() {
   return parseConfigFile(getUserConfigPath());
 }
 function parseMode(raw, path2) {
@@ -2201,7 +2239,7 @@ function parsePermission(raw, path2) {
 }
 function loadUserConfig() {
   const path2 = getUserConfigPath();
-  const raw = readRawConfig();
+  const raw = readRawConfig2();
   if (raw === void 0) {
     throw new UserConfigError(`config.json not found: ${path2}`);
   }
@@ -2293,7 +2331,7 @@ function getPermissionMode() {
 function readTopLevel(parse, fallback, label) {
   let raw;
   try {
-    raw = readRawConfig();
+    raw = readRawConfig2();
   } catch (err) {
     console.warn(`[config] failed to read config file, using default ${label}: ${err}`);
     return fallback;
@@ -2443,6 +2481,7 @@ function buildClaudeArgs({
   advisorModel,
   permissionMode,
   cloud,
+  remoteEnvId,
   baseRef,
   onBranch
 }) {
@@ -2452,6 +2491,7 @@ function buildClaudeArgs({
     throw new Error("--on-branch and --ref both set the cloud session's base branch; pass one or the other");
   }
   const advisor = advisorModel?.trim() ?? "";
+  const remoteEnv = remoteEnvId?.trim() ?? "";
   const permission = permissionMode ?? DEFAULT_PERMISSION_MODE;
   return [
     // default モードはプロンプトを引数で渡す（print モード）。herdr モードでは渡さない:
@@ -2475,6 +2515,9 @@ function buildClaudeArgs({
     // advisor 未指定（空文字）ならフラグごと省く。値なしの `--advisor` を渡すと
     // 後続フラグを値として食われるため、必ずモデル名とセットでのみ付ける。
     ...advisor === "" ? [] : ["--advisor", advisor],
+    // クラウド環境の指名。値なしの `--environment` は後続フラグを値として食うため、
+    // `--advisor` と同じく ID とセットでのみ付ける。
+    ...cloud === true && remoteEnv !== "" ? ["--environment", remoteEnv] : [],
     // クラウド実行時は「作成コマンドの共通フラグ」だけをここで返す。`--cloud` 自体は
     // 付けない（値として渡す description（＝クラウドセッションの初期プロンプト。
     // appendCloudDoneInstruction() 適用後のタスクプロンプトそのもの）は
@@ -2972,7 +3015,9 @@ function run(command, args, id, title, workerName, path2, onComplete, cwd, env,
     title,
     status: "running",
     workerName,
-    path: path2,
+    // クラウド実行は worktree を持たない（ワーカーが path に undefined を渡す）ため、
+    // 空欄ではなく実行場所が分かる表示を入れる。
+    path: cloud ? CLOUD_WORKTREE_LABEL : path2,
     startedAt: /* @__PURE__ */ new Date()
   });
   ensureRenderInterval();
@@ -3786,7 +3831,7 @@ function createIssuePollingWorker(config) {
               // config.json の advisor が false なら advisorModel の指定に関わらず渡さない。
               advisorModel: isAdvisorEnabled() ? advisorModel : "",
               permissionMode: getPermissionMode(),
-              ...cloud ? { cloud: true, baseRef: baseBranch } : {}
+              ...cloud ? { cloud: true, baseRef: baseBranch, remoteEnvId: getRemoteEnvId() ?? "" } : {}
             });
             let cwd;
             if (cloud) {
@@ -4054,6 +4099,7 @@ function createPrPollingWorker(config) {
               advisorModel: isAdvisorEnabled() ? advisorModel : "",
               permissionMode: getPermissionMode(),
               cloud: isCloud,
+              remoteEnvId: isCloud ? getRemoteEnvId() ?? "" : void 0,
               onBranch: isCloud ? pr.headRefName : void 0
             });
             if (isCloud) {
@@ -4660,7 +4706,7 @@ function createScheduledWorker(config) {
           effort,
           advisorModel: isAdvisorEnabled() ? advisorModel : "",
           permissionMode: getPermissionMode(),
-          ...cloud ? { cloud: true, baseRef: defaultBranch } : {}
+          ...cloud ? { cloud: true, baseRef: defaultBranch, remoteEnvId: getRemoteEnvId() ?? "" } : {}
         });
         await publishLastRunPr(config.name, defaultBranch, new Date(now)).catch(
           (err) => console.error(`[${config.name}] publishLastRunPr failed: ${err}`)
@@ -4748,7 +4794,8 @@ var updateDesignMdWorker = createScheduledWorker({
 init_table();
 
 // src/commands/init.ts
-import { mkdir as mkdir2, writeFile as writeFile2, access } from "node:fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2, access } from "node:fs/promises";
+import { basename as basename3 } from "node:path";
 
 // src/commands/codegraph.ts
 import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -4937,6 +4984,22 @@ async function createConfig(force) {
   const result = await writeFileWithMode(CONFIG_PATH, JSON.stringify(initialConfig, null, 2), force);
   logWriteResult(result, CONFIG_PATH);
 }
+async function ensureLocalConfigGitIgnore() {
+  const entry = basename3(LOCAL_CONFIG_PATH);
+  const path2 = ".gitignore";
+  let current = "";
+  try {
+    current = await readFile2(path2, "utf-8");
+  } catch {
+  }
+  const next = appendIgnoreEntry(current, entry);
+  if (next === null) {
+    console.log(`[init] Already ignored: ${entry} (${path2})`);
+    return;
+  }
+  await writeFile2(path2, next, "utf-8");
+  console.log(`[init] Added ${entry} to ${path2}`);
+}
 async function init(options = {}) {
   const force = options.force ?? false;
   console.log(`[init] Creating labels...${force ? " (force mode)" : ""}`);
@@ -4958,6 +5021,7 @@ async function init(options = {}) {
   logWriteResult(await writeFileWithMode(workflowPath, ASSIGN_CREATOR_WORKFLOW, force), workflowPath);
   console.log("[init] Creating config file...");
   await createConfig(force);
+  await ensureLocalConfigGitIgnore();
   console.log("[init] Setting up CodeGraph...");
   await ensureCodegraphGitIgnore("init");
   await runCodegraphInit("init");
@@ -5119,7 +5183,7 @@ async function install() {
 }
 
 // src/commands/cloud-setup.ts
-import { mkdir as mkdir3, writeFile as writeFile3, readFile as readFile2 } from "node:fs/promises";
+import { mkdir as mkdir3, writeFile as writeFile3, readFile as readFile3 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
 import { join as join8 } from "node:path";
 var LOG_PREFIX = "cloud-setup";
@@ -5160,7 +5224,7 @@ async function writeClaudeSettings(force) {
   const path2 = claudeSettingsPath();
   let existing;
   try {
-    existing = await readFile2(path2, "utf-8");
+    existing = await readFile3(path2, "utf-8");
   } catch {
     existing = null;
   }

package/package.json

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