claude-task-worker 0.102.0 → 0.103.0

package/README.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

@@ -1907,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;
 }
@@ -2043,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"]);
   }
@@ -2114,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;
@@ -2177,7 +2213,7 @@ function parseConfigFile(path2) {
     throw err;
   }
 }
-function readRawConfig() {
+function readRawConfig2() {
   return parseConfigFile(getUserConfigPath());
 }
 function parseMode(raw, path2) {
@@ -2203,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}`);
   }
@@ -2295,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;
@@ -2445,6 +2481,7 @@ function buildClaudeArgs({
   advisorModel,
   permissionMode,
   cloud,
+  remoteEnvId,
   baseRef,
   onBranch
 }) {
@@ -2454,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 モードでは渡さない:
@@ -2477,6 +2515,9 @@ function buildClaudeArgs({
     // advisor 未指定（空文字）ならフラグごと省く。値なしの `--advisor` を渡すと
     // 後続フラグを値として食われるため、必ずモデル名とセットでのみ付ける。
     ...advisor === "" ? [] : ["--advisor", advisor],
+    // クラウド環境の指名。値なしの `--environment` は後続フラグを値として食うため、
+    // `--advisor` と同じく ID とセットでのみ付ける。
+    ...cloud === true && remoteEnv !== "" ? ["--environment", remoteEnv] : [],
     // クラウド実行時は「作成コマンドの共通フラグ」だけをここで返す。`--cloud` 自体は
     // 付けない（値として渡す description（＝クラウドセッションの初期プロンプト。
     // appendCloudDoneInstruction() 適用後のタスクプロンプトそのもの）は
@@ -3790,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) {
@@ -4058,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) {
@@ -4664,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}`)
@@ -4752,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";
@@ -4941,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)" : ""}`);
@@ -4962,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");
@@ -5123,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";
@@ -5164,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.102.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",