claude-task-worker 0.117.0 → 0.119.0

package/README.md

@@ -4,6 +4,8 @@ GitHub Issues/PRを定期ポーリングし、Claude Codeに処理を委譲す
 
 同梱の Claude Code プラグイン（`plugin/`）と組み合わせることで、Issue の実装からPRのレビュー対応、Dependabot PR の対応までを自動化する。CLI 本体（npm パッケージ）とプラグイン（Claude Code マーケットプレイス）は同じリポジトリ・同じ名前で提供される。
 
+使い方のマニュアル（ハンズオン形式の導入・カスタムワーカーの作り方・設定のパッケージ化など）は [`docs/`](./docs/README.md) にある。
+
 ## アーキテクチャ
 
 CLI が GitHub ラベルを検知してタスクを起動し、プラグインのスキルが実際の処理を担う。
@@ -181,7 +183,7 @@ claude-task-worker exec-issue --cloud
 claude-task-worker all --cloud
 ```
 
-**クラウドで実行されるのは `exec-issue` と `fix-review-point` の2ワーカーだけ**で、それ以外は `--cloud` を付けてもローカル実行のまま残る（`all` / `yolo` にそのまま付けられる）。どのワーカーがクラウドで走るかは起動時にログへ出る。
+`--cloud` を付けたプロセスが起動するワーカーはすべてクラウドで実行される。ワーカーごとの向き不向きは [`docs/cloud.md`](./docs/cloud.md) を参照。
 
 前提条件:
 
@@ -213,7 +215,7 @@ npx claude-task-worker cloud-setup
 - `--cloud` と併用できないコマンド: `init` / `apply-labels` / `install` / `update` / `cloud-setup` / `usage` / `version` / `list-workers`
 - `--cloud` は `mode`（`default` / `herdr`）に依存しない。クラウドセッションの作成は `script` コマンドの疑似 pty で完結し、herdr のペインを使わないため、どちらの `mode` でも同じ経路を通る
 
-詳細は [`docs/prd-cloud-worker-execution.md`](./docs/prd-cloud-worker-execution.md) を参照。
+詳細は [`docs/cloud.md`](./docs/cloud.md) を参照。
 
 ### `--debug`
 
@@ -237,13 +239,17 @@ claude-task-worker all --inherit-config ~/ctw/shared.json
 claude-task-worker init --inherit-config ~/ctw/shared.json   # 指定パスへ設定ファイルを生成する
 ```
 
+- フラグの代わりに、cwd 直下の `claude-task-worker.json`（または `claude-task-worker.local.json`。local が勝つ）のトップレベル `inheritConfig` に土台ファイルのパスを書いてもよい（例: `"inheritConfig": "~/ctw/shared.json"`）。挙動はフラグと同一で、相対パスは cwd 基準、`~` はホーム展開。フラグとキーの両方があればフラグが勝つ。土台ファイル側の `inheritConfig` は解釈しない（継承は1段のみ）。非 string・空文字は警告して未指定扱い
 - 未指定時は従来どおり cwd 直下の `claude-task-worker.json` / `claude-task-worker.local.json` だけを読む
 - 値自体の相対パスは起動時の cwd 基準。ファイル内の相対パス（`workerFiles` / `uiDesign.designDir`）は**そのファイルの所在ディレクトリ基準**で解決する
+- 配列（`labels` / `workerFiles` など）は置き換えではなく、cwd 側の値を土台の後ろへ追記する（重複は除く）。cwd の `claude-task-worker.json` と `claude-task-worker.local.json` 同士は従来どおり local が丸ごと置き換え、その結果を土台へ追記する
 - `claude-task-worker.local.json` は常に cwd 直下のものを読む（指定ファイルと同じディレクトリのものは読まない）。cwd 直下の `claude-task-worker.json` は無くてもよい
-- 指定ファイルが存在しなければエラー終了する（既定ファイルへは倒さない）。`--project` では絶対パスにして各プロジェクトへ転送する
+- 指定ファイルが存在しなければエラー終了する（既定ファイルへは倒さない。メッセージは指定元に応じて `--inherit-config <path>` / `inheritConfig <path>`）。`--project` では絶対パスにして各プロジェクトへ転送する
 - 定期ワーカーの `lastRun` は指定に関わらずリポジトリ直下の `claude-task-worker.json` で読み書きする。リポジトリ直下に同ファイルが無ければ `lastRun` だけを持つファイルが作られる（他のキーを持たないので土台の設定とは衝突しない）。`init` を `--inherit-config` 付きで実行した場合も、未記録のワーカーの `lastRun` はリポジトリ直下へ記録する（セットアップ直後に定期ワーカーが一斉に走らないようにするため）
 - スキル（`create-ui-design` / `update-design-md` / `triage-created-issue`）はリポジトリ直下の `claude-task-worker.json` を直接読むため、**`uiDesign` の設定は `--inherit-config` のファイルに書いてもスキルには届かない**。`uiDesign` はリポジトリ直下に書くこと
 
+設定・カスタムワーカー・スキルを1つのリポジトリにまとめて配る手順は [`docs/config-package.md`](./docs/config-package.md) を参照。
+
 ### Pen CLI のログイン
 
 `.pen` を扱うスキルは Pen CLI の認証を必要とする。UIデザイン先行ワークフローを使うなら一度ログインしておく。
@@ -374,7 +380,7 @@ export const myWorker = createIssuePollingWorker({
 });
 ```
 
-起動時に全件を検証し、次のいずれかがあればタスクを1件も起動せず exit 1 する（メッセージにファイルパスと直し方を含む）: ファイルが存在しない／読み込み・トランスパイルに失敗／定義が1つも export されていない／`name` がプリセットと衝突／`name` がカスタム同士で衝突。`claude-task-worker list-workers` でロード結果を確認できる。
+起動時に全件を検証し、次のいずれかがあればタスクを1件も起動せず exit 1 する（メッセージにファイルパスと直し方を含む）: ファイルが存在しない／読み込み・トランスパイルに失敗／定義が1つも export されていない／`name` がプリセットと衝突／`name` がカスタム同士で衝突。`claude-task-worker list-workers` でロード結果を確認できる。作り方の詳しい手順は [`docs/custom-worker.md`](./docs/custom-worker.md) を参照。
 
 ## ワークフロー
 

package/dist/{chunk-FAD5CNP4.js → chunk-Z2IEIKI3.js}

@@ -514,6 +514,7 @@ function buildForwardedCommand(argv) {
 
 // src/config.ts
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { dirname, isAbsolute, join, normalize, relative, resolve as resolve2, sep as SEP } from "node:path";
 var DEFAULT_UI_DESIGN_CONFIG = {
   enabled: false,
@@ -922,11 +923,15 @@ function resolveWorkerFilePath(entry, configDir, home) {
 function isPlainObject(val) {
   return typeof val === "object" && val !== null && !Array.isArray(val);
 }
-function mergeConfigRaw(base, local) {
+function mergeConfigRaw(base, local, appendArrays = false) {
   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;
+    if (appendArrays && Array.isArray(current) && Array.isArray(val)) {
+      result[key] = [...current, ...val.filter((v) => !current.includes(v))];
+    } else {
+      result[key] = isPlainObject(current) && isPlainObject(val) ? mergeConfigRaw(current, val, appendArrays) : val;
+    }
   }
   return result;
 }
@@ -961,19 +966,39 @@ function resolveInheritedRelativePaths(raw, configDir, repoRoot) {
   }
   return result;
 }
-function readInheritedRawConfig(path2, repoRoot) {
-  if (!existsSync(path2)) {
-    throw new Error(`${INHERIT_CONFIG_FLAG} ${path2} does not exist`);
+var INHERIT_CONFIG_KEY = "inheritConfig";
+var cachedInheritConfigSource;
+function resolveInheritConfigSource() {
+  if (cachedInheritConfigSource !== void 0) return cachedInheritConfigSource;
+  const flagPath = getInheritConfigPath();
+  if (flagPath) return cachedInheritConfigSource = { path: flagPath, origin: INHERIT_CONFIG_FLAG };
+  const raw = readCwdRawConfig();
+  if (!(INHERIT_CONFIG_KEY in raw)) return cachedInheritConfigSource = null;
+  const val = raw[INHERIT_CONFIG_KEY];
+  if (typeof val !== "string" || val.trim().length === 0) {
+    console.warn(`[config] invalid ${INHERIT_CONFIG_KEY}: ${String(val)}, ignoring`);
+    return cachedInheritConfigSource = null;
+  }
+  cachedInheritConfigSource = {
+    path: resolveWorkerFilePath(val.trim(), process.cwd(), homedir()),
+    origin: INHERIT_CONFIG_KEY
+  };
+  return cachedInheritConfigSource;
+}
+function readInheritedRawConfig(source, repoRoot) {
+  if (!existsSync(source.path)) {
+    throw new Error(`${source.origin} ${source.path} does not exist`);
   }
-  return resolveInheritedRelativePaths(readRawConfig(path2), dirname(path2), repoRoot);
+  const { [INHERIT_CONFIG_KEY]: _ignored, ...raw } = readRawConfig(source.path);
+  return resolveInheritedRelativePaths(raw, dirname(source.path), repoRoot);
 }
 function readCwdRawConfig() {
   return mergeConfigRaw(readRawConfig(CONFIG_PATH), readRawConfig(LOCAL_CONFIG_PATH));
 }
 function loadConfig() {
-  const inheritPath = getInheritConfigPath();
+  const inheritSource = resolveInheritConfigSource();
   const cwdRaw = readCwdRawConfig();
-  const raw = inheritPath ? mergeConfigRaw(readInheritedRawConfig(inheritPath, process.cwd()), cwdRaw) : cwdRaw;
+  const raw = inheritSource ? mergeConfigRaw(readInheritedRawConfig(inheritSource, process.cwd()), cwdRaw, true) : cwdRaw;
   const result = {
     ...DEFAULT_CONFIG,
     labels: [],
@@ -1094,7 +1119,7 @@ function getUiDesignConfig() {
 
 // src/user-config.ts
 import { readFileSync as readFileSync2, statSync } from "node:fs";
-import { homedir } from "node:os";
+import { homedir as homedir2 } from "node:os";
 import { isAbsolute as isAbsolute2, join as join2, resolve as resolve3 } from "node:path";
 var RESERVED_ALL = "all";
 var DEFAULT_RUN_MODE = "default";
@@ -1116,7 +1141,7 @@ var UserConfigError = class extends Error {
 };
 function getConfigDir() {
   const xdg = process.env.XDG_CONFIG_HOME;
-  const configHome = xdg && xdg.length > 0 ? xdg : join2(homedir(), ".config");
+  const configHome = xdg && xdg.length > 0 ? xdg : join2(homedir2(), ".config");
   return join2(configHome, "claude-task-worker");
 }
 function getUserConfigPath() {
@@ -1612,7 +1637,7 @@ import { StringDecoder } from "node:string_decoder";
 
 // src/task-result.ts
 var STDERR_TAIL_LIMIT = 8 * 1024;
-var CLOUD_FAILURE_GUIDANCE = "[worker] \u30AF\u30E9\u30A6\u30C9\u5B9F\u884C\u306E\u524D\u63D0\u6761\u4EF6\uFF08GitHub \u9023\u643A / allow_remote_sessions \u7D44\u7E54\u30DD\u30EA\u30B7\u30FC\uFF09\u304C\u6E80\u305F\u3055\u308C\u3066\u3044\u306A\u3044\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002\u8A73\u7D30\u306F docs/cloud-prerequisite-checks.md \u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
+var CLOUD_FAILURE_GUIDANCE = "[worker] \u30AF\u30E9\u30A6\u30C9\u5B9F\u884C\u306E\u524D\u63D0\u6761\u4EF6\uFF08GitHub \u9023\u643A / allow_remote_sessions \u7D44\u7E54\u30DD\u30EA\u30B7\u30FC\uFF09\u304C\u6E80\u305F\u3055\u308C\u3066\u3044\u306A\u3044\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002\u8A73\u7D30\u306F docs/cloud.md \u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
 function appendCloudFailureGuidance(result, cloud) {
   if (!cloud || result.status === "completed") return result;
   return { ...result, output: `${CLOUD_FAILURE_GUIDANCE}
@@ -2334,15 +2359,15 @@ function isGeneratedWorktreeName(name) {
 // src/slack.ts
 import { exec } from "node:child_process";
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync4 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
+import { homedir as homedir4 } from "node:os";
 import { join as join4 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 
 // src/runcat.ts
 import { mkdirSync as mkdirSync2, renameSync as renameSync2, rmSync, writeFileSync as writeFileSync3 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
+import { homedir as homedir3 } from "node:os";
 import { dirname as dirname2, join as join3 } from "node:path";
-var RUNCAT_OUT_FILE = process.env.RUNCAT_OUT_FILE ?? join3(process.env.HOME ?? homedir2(), ".claude", "runcat-usage.json");
+var RUNCAT_OUT_FILE = process.env.RUNCAT_OUT_FILE ?? join3(process.env.HOME ?? homedir3(), ".claude", "runcat-usage.json");
 var JST = "Asia/Tokyo";
 function formatG(value) {
   return String(Number(value.toPrecision(6)));
@@ -2443,7 +2468,7 @@ async function getOAuthToken() {
     const { stdout } = await execAsync('security find-generic-password -s "Claude Code-credentials" -w');
     return extractToken(JSON.parse(stdout.trim()));
   } catch {
-    const raw = readFileSync3(join4(homedir3(), ".claude", ".credentials.json"), "utf-8");
+    const raw = readFileSync3(join4(homedir4(), ".claude", ".credentials.json"), "utf-8");
     return extractToken(JSON.parse(raw));
   }
 }
@@ -3332,7 +3357,6 @@ export {
   hasProjectFilter,
   assertProjectCompatibleCommand,
   hasCloudFlag,
-  INHERIT_CONFIG_FLAG,
   getInheritConfigPath,
   assertCloudCompatibleCommand,
   buildForwardedCommand,
@@ -3345,6 +3369,8 @@ export {
   CONFIG_PATH,
   LOCAL_CONFIG_PATH,
   resolveWorkerFilePath,
+  INHERIT_CONFIG_KEY,
+  resolveInheritConfigSource,
   loadConfig,
   getWorkerConfig,
   isWorkerEnabled,

package/dist/commands/init.d.ts

@@ -10,6 +10,7 @@ export declare function buildLabelSpecs(custom: string[]): {
 export declare function applyLabels(): Promise<void>;
 export declare const ISSUE_TEMPLATE = "name: \"[claude-task-worker] Issue\u4F5C\u6210\u4F9D\u983C\"\ndescription: claude-task-worker\u3067GitHub Issue\u3092\u4F5C\u6210\u3059\u308B\ntitle: \"[claude-task-worker] Issue\u4F5C\u6210\u4F9D\u983C\"\nlabels:\n  - cc-triage-scope\n  - cc-issue-request\nbody:\n  - type: textarea\n    id: request\n    attributes:\n      label: \u4F9D\u983C\u5185\u5BB9\n      description: \u4F5C\u6210\u3057\u3066\u307B\u3057\u3044Issue\u306E\u5185\u5BB9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\n    validations:\n      required: true\n";
 export declare const ASSIGN_CREATOR_WORKFLOW = "name: Assign creator on issue request\n\non:\n  issues:\n    types: [opened]\n\njobs:\n  assign:\n    if: contains(github.event.issue.labels.*.name, 'cc-issue-request')\n    runs-on: ubuntu-latest\n    permissions:\n      issues: write\n    steps:\n      - uses: actions/github-script@v9\n        with:\n          script: |\n            await github.rest.issues.addAssignees({\n              owner: context.repo.owner,\n              repo: context.repo.repo,\n              issue_number: context.issue.number,\n              assignees: [context.payload.issue.user.login]\n            });\n";
+export declare function buildInitialConfig(now: string): Record<string, unknown>;
 export declare function seedCwdLastRun(at: Date): void;
 export declare function isContentMismatch(result: "created" | "overwritten" | "skipped", expected: string, actual: string): boolean;
 export declare function init(options?: {

package/dist/config.d.ts

@@ -1,3 +1,4 @@
+import { INHERIT_CONFIG_FLAG } from "./dispatch-args";
 export type WorkerName = "exec-issue" | "answer-issue-questions" | "create-issue" | "update-issue" | "triage-created-issue" | "fix-review-point" | "check-dependabot" | "triage-pr" | "resolve-conflict" | "epic-issue" | "create-ui-design" | "apply-ui-design" | "update-coding-guidelines" | "update-requirement-rules" | "update-design-md";
 export interface WorkerRuntimeConfig {
     skill: string;
@@ -60,8 +61,15 @@ export declare function parseLastRunEntry(val: unknown): LastRunLog;
 export declare function parseLabelsEntry(val: unknown): string[];
 export declare function parseWorkerFilesEntry(val: unknown): string[];
 export declare function resolveWorkerFilePath(entry: string, configDir: string, home: string): string;
-export declare function mergeConfigRaw(base: Record<string, unknown>, local: Record<string, unknown>): Record<string, unknown>;
+export declare function mergeConfigRaw(base: Record<string, unknown>, local: Record<string, unknown>, appendArrays?: boolean): Record<string, unknown>;
 export declare function resolveInheritedRelativePaths(raw: Record<string, unknown>, configDir: string, repoRoot: string): Record<string, unknown>;
+export declare const INHERIT_CONFIG_KEY = "inheritConfig";
+export interface InheritConfigSource {
+    path: string;
+    origin: typeof INHERIT_CONFIG_FLAG | typeof INHERIT_CONFIG_KEY;
+}
+export declare function resolveInheritConfigSource(): InheritConfigSource | null;
+export declare function resetInheritConfigSourceCache(): void;
 export declare function loadConfig(): Config;
 export declare function getWorkerConfig(workerName: string): WorkerRuntimeConfig;
 export declare function isWorkerEnabled(workerName: string): boolean;

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   CONFIG_PATH,
   DEFAULT_CONFIG,
   DEFAULT_UI_DESIGN_CONFIG,
-  INHERIT_CONFIG_FLAG,
+  INHERIT_CONFIG_KEY,
   LOCAL_CONFIG_PATH,
   SCHEDULED_WORKER_NAMES,
   UserConfigError,
@@ -57,6 +57,7 @@ import {
   partitionEnabledWorkers,
   removeStaleWorktrees,
   renderTable,
+  resolveInheritConfigSource,
   resolveTargetProjects,
   resolveWorkerFilePath,
   send,
@@ -64,7 +65,7 @@ import {
   shutdown,
   waitForAllProcesses,
   writeLastRun
-} from "./chunk-FAD5CNP4.js";
+} from "./chunk-Z2IEIKI3.js";
 import {
   captureConsole
 } from "./chunk-N42YU3GJ.js";
@@ -921,14 +922,18 @@ function logWriteResult(result, path) {
   else if (result === "overwritten") console.log(`[init] Overwritten: ${path}`);
   else console.log(`[init] Already exists: ${path}`);
 }
-async function createConfig(force) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const initialConfig = {
-    ...DEFAULT_CONFIG,
+function buildInitialConfig(now) {
+  const { labels: _labels, workerFiles: _workerFiles, ...rest } = DEFAULT_CONFIG;
+  return {
+    ...rest,
     uiDesign: { ...DEFAULT_UI_DESIGN_CONFIG },
     lastRun: Object.fromEntries(SCHEDULED_WORKER_NAMES.map((name) => [name, now])),
     workers: {}
   };
+}
+async function createConfig(force) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const initialConfig = buildInitialConfig(now);
   const inheritPath = getInheritConfigPath();
   const path = inheritPath ?? CONFIG_PATH;
   const result = await writeFileWithMode(path, JSON.stringify(initialConfig, null, 2), force);
@@ -1533,10 +1538,17 @@ if (workerType === "version" || workerType === "--version" || workerType === "-v
   process.exit(process.exitCode ?? 0);
 }
 void notifyIfOutdated();
-var inheritConfigPath = getInheritConfigPath();
-if (inheritConfigPath && workerType !== "init" && !existsSync3(inheritConfigPath)) {
-  console.error(`${INHERIT_CONFIG_FLAG} ${inheritConfigPath} does not exist`);
-  process.exit(1);
+if (workerType !== "init") {
+  let inheritSource;
+  try {
+    inheritSource = resolveInheritConfigSource();
+  } catch {
+    inheritSource = null;
+  }
+  if (inheritSource && !(hasProjectFilter() && inheritSource.origin === INHERIT_CONFIG_KEY) && !existsSync3(inheritSource.path)) {
+    console.error(`${inheritSource.origin} ${inheritSource.path} does not exist`);
+    process.exit(1);
+  }
 }
 var customWorkers = workerType && !NON_WORKER_COMMANDS.includes(workerType) && !hasProjectFilter() ? await loadCustomWorkersOrExit() : [];
 var WORKERS = Object.fromEntries(

package/dist/lib.js

@@ -58,7 +58,7 @@ import {
   removeWorktreeByBranch,
   run,
   syncDefaultBranch
-} from "./chunk-FAD5CNP4.js";
+} from "./chunk-Z2IEIKI3.js";
 import "./chunk-N42YU3GJ.js";
 export {
   CLOUD_DONE_LABEL,

package/package.json

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