claude-task-worker 0.117.0 → 0.118.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`
 
@@ -239,11 +241,14 @@ claude-task-worker init --inherit-config ~/ctw/shared.json   # 指定パスへ
 
 - 未指定時は従来どおり 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` では絶対パスにして各プロジェクトへ転送する
 - 定期ワーカーの `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 +379,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-ULDG6SEE.js}

@@ -922,11 +922,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;
 }
@@ -973,7 +977,7 @@ function readCwdRawConfig() {
 function loadConfig() {
   const inheritPath = getInheritConfigPath();
   const cwdRaw = readCwdRawConfig();
-  const raw = inheritPath ? mergeConfigRaw(readInheritedRawConfig(inheritPath, process.cwd()), cwdRaw) : cwdRaw;
+  const raw = inheritPath ? mergeConfigRaw(readInheritedRawConfig(inheritPath, process.cwd()), cwdRaw, true) : cwdRaw;
   const result = {
     ...DEFAULT_CONFIG,
     labels: [],
@@ -1612,7 +1616,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}

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

@@ -60,7 +60,7 @@ 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 function loadConfig(): Config;
 export declare function getWorkerConfig(workerName: string): WorkerRuntimeConfig;

package/dist/index.js

@@ -64,7 +64,7 @@ import {
   shutdown,
   waitForAllProcesses,
   writeLastRun
-} from "./chunk-FAD5CNP4.js";
+} from "./chunk-ULDG6SEE.js";
 import {
   captureConsole
 } from "./chunk-N42YU3GJ.js";
@@ -921,14 +921,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);

package/dist/lib.js

@@ -58,7 +58,7 @@ import {
   removeWorktreeByBranch,
   run,
   syncDefaultBranch
-} from "./chunk-FAD5CNP4.js";
+} from "./chunk-ULDG6SEE.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.118.0",
   "description": "CLI tool that polls GitHub Issues/PRs and delegates work to Claude CLI",
   "type": "module",
   "main": "dist/index.js",