claude-task-worker 0.139.1 → 0.141.0

package/README.md

@@ -60,7 +60,7 @@ CLI が GitHub ラベルを検知してタスクを起動し、プラグイン
 | [Claude Code (`claude`)](https://docs.anthropic.com/en/docs/claude-code) | タスク実行エンジン |
 | [Git](https://git-scm.com/) / [jq](https://jqlang.org/) | worktree 操作 / スキル内での JSON 加工 |
 | [CodeGraph](https://www.npmjs.com/package/@colbymchenry/codegraph) | コード探索用インデックス（任意。未導入ならテキスト検索に落ちる） |
-| [Playwright](https://playwright.dev/) のブラウザ | Playwright MCP でのブラウザ確認、`.pen` のスナップショット描画 |
+| [Playwright](https://playwright.dev/) のブラウザ（Google Chrome） | Playwright MCP でのブラウザ確認（起動済みの Chrome に CDP `http://localhost:9222` で接続する。Chrome を `--remote-debugging-port=9222 --user-data-dir=<任意のディレクトリ>` 付きで起動しておく）、`.pen` のスナップショット描画 |
 | [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 に依存しない） |
 | [GitHub MCP](https://github.com/github/github-mcp-server) | GitHub アクセスの高速化・クラウド実行時のプロキシ制限回避（任意。Claude 側のコネクタで有効化） |
@@ -126,7 +126,7 @@ claude-task-worker apply-labels   # ラベルだけを作成（冪等）
 ## コマンド
 
 ```bash
-claude-task-worker <command> [--epic <issue-number>]... [--label <label>]... [--project <name>]... [--cloud] [--debug]
+claude-task-worker <command> [--epic <issue-number>]... [--label <label>]... [--exclude-label <label>]... [--project <name>]... [--cloud] [--debug]
 ```
 
 | コマンド | 内容 |
@@ -154,12 +154,22 @@ claude-task-worker all --epic 100 --epic 200
 
 ### `--label <label>`
 
-トリガーラベルに加えて指定ラベルが付いた Issue のみに絞る。複数指定は AND。`--epic` と併用可能。
+トリガーラベルに加えて指定ラベルが付いた Issue・PR のみに絞る（Issue 系・PR 系ワーカーの両方に効く）。`exec-issue` / `epic-issue` / `create-ui-design` が Issue から作った PR にも同じラベルを付けるので、後続の PR 系ワーカーが拾える。複数指定は AND。`--epic` と併用可能。
 
 ```bash
 claude-task-worker all --label priority-high --label needs-design
 ```
 
+### `--exclude-label <label>`
+
+指定ラベルが付いた Issue・PR を対象から外す（Issue 系・PR 系ワーカーの両方に効く。定期ワーカーは対象を持たないため無関係）。複数指定は AND で、どれか1つでも付いていれば外れる。
+
+```bash
+claude-task-worker all --exclude-label wip --exclude-label on-hold
+```
+
+`--label` / `--exclude-label` は `config.json` の `projects` にプロジェクトごとの既定を書ける（下記）。`--project` 経由の起動でだけ CLI の指定に足し込まれる。
+
 ### `--project <name>`
 
 指定したプロジェクト（またはグループ、`all`）へ [herdr](https://herdr.dev) 経由でコマンドをディスパッチする。CLI はワーカーを直接実行せず、プロジェクトごとに独立した herdr ワークスペースを作ってそこでコマンドを実行し、稼働状況をステータステーブルに表示する。SIGTERM/SIGINT で全セッションを一括停止する。
@@ -254,7 +264,7 @@ claude-task-worker init --inherit-config ~/ctw/shared.json   # 指定パスへ
 
 ```bash
 node plugin/scripts/pen.mjs validate design.pen            # ID重複・参照切れ・未知プロパティなどの検査
-node plugin/scripts/pen.mjs render design.pen --out out/   # Chromium で描画して PNG 出力
+node plugin/scripts/pen.mjs render design.pen --out out/   # Chrome で描画して PNG 出力
 ```
 
 画像は pen.dev 本体ではなく HTML/CSS へ変換して描画した近似で、描画しきれない表現（取得できなかったフォント・アイコン、shader など）は警告として出る。フォントは Google Fonts、アイコンは unpkg から取得する。
@@ -272,7 +282,7 @@ node plugin/scripts/pen.mjs render design.pen --out out/   # Chromium で描画
   "permission": "bypassPermissions",
   "projects": {
     "app-a": "/Users/me/repos/app-a",
-    "app-b": "/Users/me/repos/app-b"
+    "app-b": { "path": "/Users/me/repos/app-b", "label": ["priority-high"], "excludeLabel": ["wip"] }
   },
   "projectGroups": {
     "frontend": ["app-a", "app-b"]
@@ -282,13 +292,13 @@ node plugin/scripts/pen.mjs render design.pen --out out/   # Chromium で描画
 
 | キー | 既定 | 説明 |
 |---|---|---|
-| `projects` | - | プロジェクト名 → 絶対パス |
+| `projects` | - | プロジェクト名 → 絶対パス、または `{ path, label, excludeLabel }`。`label` / `excludeLabel` は `--label` / `--exclude-label` と同じ意味で、`--project` でそのプロジェクトを指定して起動したワーカーにだけ足し込まれる（`--project` なしの起動には適用しない）。`path` の重複は可 |
 | `projectGroups` | `{}` | グループ名 → プロジェクト名配列 |
 | `mode` | `"default"` | `"default"`: `claude -p` の子プロセスとして実行 / `"herdr"`: herdr のタブ内で TUI 起動し、実行中の様子を覗ける（`--project` はこちらが必要） |
 | `advisor` | `false` | `true` で `--advisor <model>` を渡す。モデルは `claude-task-worker.json` の `advisorModel` |
 | `permission` | `"bypassPermissions"` | Claude CLI の[権限モード](https://code.claude.com/docs/ja/permission-modes)（`bypassPermissions` / `dontAsk` / `auto` / `acceptEdits` / `manual` / `plan`） |
 
-いずれもトップレベル一括で、プロジェクト単位・ワーカー単位の指定はできない。`permission` はワーカーに承認するユーザーがいないため、`bypassPermissions` / `dontAsk` 以外ではタスクが承認待ちで止まりうる。
+`projects` 以外はいずれもトップレベル一括で、プロジェクト単位・ワーカー単位の指定はできない。`permission` はワーカーに承認するユーザーがいないため、`bypassPermissions` / `dontAsk` 以外ではタスクが承認待ちで止まりうる。
 
 > ℹ️ `mode: "herdr"` の完了通知音はワーカー側から止められない。無音にするには `~/.config/herdr/config.toml` に `[ui.sound] enabled = false` を書いて `herdr server reload-config` する（herdr サーバー全体に効く）。
 
@@ -423,7 +433,7 @@ claude-task-worker all
 
 ## プロセス管理
 
-実行中のタスクはリアルタイムのステータステーブルで表示される（タスクID・タイトル・ステータス・開始時刻・経過時間）。SIGTERM/SIGINT で graceful shutdown し、もう一度送ると強制終了してラベル・worktree の後片付けを試みる。前回の異常終了で残った worktree はワーカー起動時に自動回収される。
+実行中のタスクはリアルタイムのステータステーブルで表示される（タスクID・タイトル・ステータス・開始時刻・経過時間）。SIGTERM/SIGINT で graceful shutdown し、もう一度送ると強制終了してラベル・worktree の後片付けを試みる。前回の異常終了で残った worktree は自動回収しない（同じ path のプロジェクトを並走させたとき他プロセスの作業中 worktree を消さないため）。不要なら `.claude/worktrees/` 配下を `git worktree remove` で手動削除する。
 
 ワーカーは応答するユーザーがいない状態でスキルを起動するため、処理が未完のままラベルだけ進む事故を防ぐガードを持つ（バックグラウンド実行と対話系ツールの無効化、自律実行原則のシステムプロンプト注入、PR 実在の完了検証、空出力セッションの失敗扱い、`Stop` フックによる残留プロセスの停止）。
 

package/dist/{chunk-D4BPQ3K3.js → chunk-725IRSKF.js}

@@ -16,7 +16,7 @@ import {
   pushLogLine,
   selectRecentTasks,
   writeScreen
-} from "./chunk-HFU27QHT.js";
+} from "./chunk-BA2CE3L6.js";
 
 // src/gh.ts
 import { createRequire } from "node:module";
@@ -365,7 +365,7 @@ function excludePrsByLabels(prs, excludeLabels) {
   return prs.filter((pr) => !pr.labels.some((l) => excludeLabels.includes(l.name)));
 }
 var PR_LIST_FETCH_LIMIT = 50;
-async function listPullRequestsWithChecks(assignee, label, excludeLabels = [], limit = 5) {
+async function listPullRequestsWithChecks(assignee, label, excludeLabels = [], limit = 5, searchExcludeLabels = []) {
   const args = [
     "pr",
     "list",
@@ -374,18 +374,22 @@ async function listPullRequestsWithChecks(assignee, label, excludeLabels = [], l
     "--json",
     "number,title,labels,headRefName",
     "--search",
-    "sort:created-asc",
+    ["sort:created-asc", ...searchExcludeLabels.map((l) => `-label:"${l}"`)].join(" "),
     "--limit",
     String(PR_LIST_FETCH_LIMIT)
   ];
   if (assignee) {
     args.push("--assignee", assignee);
   }
-  if (label) {
-    args.push("--label", label);
+  for (const l of [label ?? []].flat()) {
+    if (!l) continue;
+    args.push("--label", l);
   }
   const output = await execGh(args);
-  const prs = excludePrsByLabels(JSON.parse(output), excludeLabels).slice(0, limit);
+  const prs = excludePrsByLabels(JSON.parse(output), [...excludeLabels, ...searchExcludeLabels]).slice(
+    0,
+    limit
+  );
   const withChecks = await Promise.all(prs.map(async (pr) => ({ ...pr, checks: await fetchPRChecks(pr.number) })));
   return withChecks.filter((pr) => isCICompleted(pr.checks));
 }
@@ -1552,7 +1556,7 @@ function resolveProjectName(cwd = process.cwd()) {
   return findProjectNameByPath(cwd) ?? basename(cwd);
 }
 async function runViaHerdr(args, prompt, id, onComplete, cwd, env) {
-  const { startHerdrTask, stopHerdrTask, taskTabLabel, waitForHerdrTask } = await import("./herdr-runner-TNX2W4G6.js");
+  const { startHerdrTask, stopHerdrTask, taskTabLabel, waitForHerdrTask } = await import("./herdr-runner-S5X5NTFR.js");
   const { getCurrentWorkspaceId } = await import("./herdr-NDLUM6JF.js");
   const label = taskTabLabel(resolveProjectName(), id);
   let task;
@@ -1678,7 +1682,7 @@ async function flagOrphanedCloudSession(target, reason, cloudSessionId) {
   });
 }
 async function createCloudSession(args, initialPrompt, cwd, env) {
-  const { extractCloudSessionId, normalizePtyOutput } = await import("./herdr-runner-TNX2W4G6.js");
+  const { extractCloudSessionId, normalizePtyOutput } = await import("./herdr-runner-S5X5NTFR.js");
   const spec = buildScriptCommand("claude", buildCloudCreateArgs(args, initialPrompt));
   const child = spawn(spec.command, spec.args, {
     stdio: ["ignore", "pipe", "pipe"],
@@ -2134,9 +2138,6 @@ function generateWorktreeName() {
   const suffix = String(randomInt(1e4)).padStart(4, "0");
   return `${pick(ADJECTIVES)}-${pick(NOUNS)}-${suffix}`;
 }
-function isGeneratedWorktreeName(name) {
-  return /^[a-z]+-[a-z]+-\d{4}$/.test(name);
-}
 
 // src/slack.ts
 import { exec } from "node:child_process";
@@ -2409,7 +2410,7 @@ async function notifyError(workerName, repoName, error) {
 // src/worktree.ts
 import { createRequire as createRequire2 } from "node:module";
 import { promisify as promisify3 } from "node:util";
-import { readdir, rm, stat } from "node:fs/promises";
+import { rm, stat } from "node:fs/promises";
 import { basename as basename2, resolve as resolve2, sep } from "node:path";
 var childProcess2 = createRequire2(import.meta.url)("node:child_process");
 var execFileAsync2 = (command, args) => promisify3(childProcess2.execFile)(command, args);
@@ -2549,29 +2550,6 @@ async function removeWorktreeByBranch(branchName) {
     console.error(`[worktree] Failed to remove worktree for branch ${branchName}:`, error);
   }
 }
-async function removeStaleWorktrees() {
-  const worktreeIds = /* @__PURE__ */ new Set();
-  try {
-    for (const name of await readdir(WORKTREES_DIR)) {
-      if (isGeneratedWorktreeName(name)) worktreeIds.add(name);
-    }
-  } catch {
-  }
-  try {
-    for (const entry of await listWorktreeEntries()) {
-      if (!isManagedWorktreePath(entry.path)) continue;
-      const worktreeId = basename2(entry.path);
-      if (isGeneratedWorktreeName(worktreeId)) worktreeIds.add(worktreeId);
-    }
-  } catch (error) {
-    console.error(`[worktree] Failed to list worktrees:`, error);
-  }
-  for (const worktreeId of worktreeIds) {
-    if (isWorktreeInUse(worktreeId)) continue;
-    console.log(`[worktree] Removing stale worktree: ${worktreeId}`);
-    await removeWorktree(worktreeId);
-  }
-}
 
 // src/workers/worker-definition.ts
 var WORKER_DEFINITION = /* @__PURE__ */ Symbol.for("claude-task-worker.worker-definition");
@@ -2587,6 +2565,13 @@ function isWorkerDefinition(value) {
 
 // src/workers/issue-worker.ts
 var STICKY_LABELS = ["cc-triage-scope", "cc-issue-created"];
+async function carryLabelFiltersToPr(workerName, prNumber, labelFilters = []) {
+  for (const label of labelFilters) {
+    await addLabel("pr", prNumber, label).catch(
+      (err) => console.error(`[${workerName}] addLabel ${label} failed for PR #${prNumber}: ${err}`)
+    );
+  }
+}
 var consumableTriggerLabels = (triggerLabels) => triggerLabels.filter((label) => !STICKY_LABELS.includes(label));
 var PREFLIGHT_SEARCH_LIMIT = 5;
 function createIssuePollingWorker(config) {
@@ -2607,7 +2592,12 @@ function createIssuePollingWorker(config) {
       if (isShuttingDown()) return;
       if (cooldownMs > 0 && lastCompletionAt > 0 && Date.now() - lastCompletionAt < cooldownMs) return;
       try {
-        const excludeLabels = ["cc-in-progress", "cc-need-human-check", ...config.excludeLabels ?? []];
+        const excludeLabels = [
+          "cc-in-progress",
+          "cc-need-human-check",
+          ...config.excludeLabels ?? [],
+          ...opts.excludeLabelFilters ?? []
+        ];
         const epicFilter = config.epicFilterTarget !== "self" && epicFilters && epicFilters.length > 0 ? { owner, repo: name, numbers: epicFilters } : void 0;
         const labels = labelFilters && labelFilters.length > 0 ? [...config.triggerLabels, ...labelFilters] : config.triggerLabels;
         const { maxConcurrentTasks } = getWorkerConfig(config.name);
@@ -2701,7 +2691,8 @@ function createIssuePollingWorker(config) {
                     const verified = await config.onCompleted?.(issue.number, worktreeId, output, {
                       cloud,
                       baseBranch,
-                      startedAt
+                      startedAt,
+                      labelFilters: labelFilters ?? []
                     }) ?? true;
                     if (verified === false) {
                       await notifyTaskFailed(
@@ -2794,7 +2785,7 @@ function createIssuePollingWorker(config) {
 var LABEL_IN_PROGRESS = "cc-in-progress";
 var LABEL_TRIAGE_SCOPE = "cc-triage-scope";
 function createPrPollingWorker(config) {
-  const start = async () => {
+  const start = async (opts = {}) => {
     const { owner, name, defaultBranch } = await getRepoInfo();
     const user = await getCurrentUser();
     const { pollingIntervalSeconds, cooldownSeconds } = getWorkerConfig(config.name);
@@ -2809,7 +2800,13 @@ function createPrPollingWorker(config) {
       if (cooldownMs > 0 && lastCompletionAt > 0 && Date.now() - lastCompletionAt < cooldownMs) return;
       try {
         const excludeLabels = [LABEL_IN_PROGRESS, ...config.excludeLabels ?? []];
-        const candidates = await listPullRequestsWithChecks(user, config.triggerLabel, excludeLabels);
+        const candidates = await listPullRequestsWithChecks(
+          user,
+          [config.triggerLabel, ...opts.labelFilters ?? []],
+          excludeLabels,
+          void 0,
+          opts.excludeLabelFilters ?? []
+        );
         for (const pr of candidates) {
           if (isRunning(pr.number)) continue;
           if (isWorkerAtCapacity(config.name)) break;
@@ -3211,9 +3208,9 @@ export {
   createWorktreeFromBranch,
   removeWorktree,
   removeWorktreeByBranch,
-  removeStaleWorktrees,
   defineWorker,
   isWorkerDefinition,
+  carryLabelFiltersToPr,
   createIssuePollingWorker,
   createPrPollingWorker,
   publishLastRunPr,

package/dist/{chunk-HFU27QHT.js → chunk-BA2CE3L6.js}

@@ -203,10 +203,13 @@ function loadUserConfig() {
     );
   }
   const projects = {};
-  for (const [name, value] of Object.entries(rawProjects)) {
+  const projectLabelFilters = {};
+  for (const [name, entry] of Object.entries(rawProjects)) {
     if (name === "__proto__") {
       throw new UserConfigError(`"__proto__" cannot be used as a key in "projects": ${path}`);
     }
+    const isObjectEntry = typeof entry === "object" && entry !== null && !Array.isArray(entry);
+    const value = isObjectEntry ? entry["path"] : entry;
     if (typeof value !== "string" || !isAbsolute(value)) {
       console.warn(`[config] invalid projects.${name}: expected an absolute path, skipping`);
       continue;
@@ -216,6 +219,18 @@ function loadUserConfig() {
       continue;
     }
     projects[name] = value;
+    if (isObjectEntry) {
+      const obj = entry;
+      for (const key of Object.keys(obj)) {
+        if (!PROJECT_ENTRY_KEYS.includes(key)) {
+          console.warn(`[config] unknown key "${key}" in projects.${name}, ignoring`);
+        }
+      }
+      projectLabelFilters[name] = {
+        label: parseLabelList(obj["label"], `projects.${name}.label`),
+        excludeLabel: parseLabelList(obj["excludeLabel"], `projects.${name}.excludeLabel`)
+      };
+    }
   }
   const projectGroups = {};
   for (const [groupName, value] of Object.entries(rawProjectGroups)) {
@@ -236,7 +251,16 @@ function loadUserConfig() {
     }
     projectGroups[groupName] = members;
   }
-  return { mode, advisor, permission, projects, projectGroups };
+  return { mode, advisor, permission, projects, projectGroups, projectLabelFilters };
+}
+var PROJECT_ENTRY_KEYS = ["path", "label", "excludeLabel"];
+function parseLabelList(value, key) {
+  if (value === void 0) return [];
+  if (Array.isArray(value) && value.every((v) => typeof v === "string" && v.length > 0)) return value;
+  console.warn(
+    `[config] invalid ${key}: expected an array of non-empty strings, got ${JSON.stringify(value)}, ignoring`
+  );
+  return [];
 }
 var cachedRunMode;
 function getRunMode() {
@@ -292,6 +316,18 @@ function findProjectNameByPath(path) {
   }
   return void 0;
 }
+function findProjectLabelFilters(projectName = process.env.CTW_PROJECT_NAME) {
+  const empty = { label: [], excludeLabel: [] };
+  if (!projectName) return empty;
+  let config;
+  try {
+    config = loadUserConfig();
+  } catch (err) {
+    console.warn(`[config] failed to read config file, project label filters are not applied: ${err}`);
+    return empty;
+  }
+  return Object.prototype.hasOwnProperty.call(config.projectLabelFilters, projectName) ? config.projectLabelFilters[projectName] : empty;
+}
 function resolveTargetProjects(requested, config) {
   const resolved = /* @__PURE__ */ new Map();
   for (const name of requested) {
@@ -558,6 +594,7 @@ export {
   isAdvisorEnabled,
   getPermissionMode,
   findProjectNameByPath,
+  findProjectLabelFilters,
   resolveTargetProjects,
   getDisplayWidth,
   truncateToWidth,

package/dist/commands/playwright.d.ts

@@ -1,7 +1,7 @@
 export declare const PLAYWRIGHT_CORE_PACKAGE = "playwright-core";
 export declare const PLAYWRIGHT_MCP_PACKAGE = "@playwright/mcp";
 /**
- * `install-deps`（chromium が要求するシステムライブラリの導入）の実行コマンドを組み立てる。
+ * `install-deps`（chrome が要求するシステムライブラリの導入）の実行コマンドを組み立てる。
  *
  * root（コンテナなど）では `sudo` を使わない。sudo バイナリ自体が入っていない環境が普通にあり、
  * root なら昇格は不要なため。非 root では `sudo` を前置する（パスワードを求められうる）。
@@ -11,18 +11,16 @@ export declare function buildInstallDepsCommand(uid: number | undefined): {
     args: string[];
 };
 /**
- * Playwright MCP が使うブラウザ（chromium）をインストールする。
+ * Playwright MCP が使うブラウザ（Google Chrome）をインストールする。
  *
  * MCP サーバー本体（`@playwright/mcp`）は `plugin/.mcp.json` が `npx -y ...@latest` で起動するため
- * 事前導入が不要だが、ブラウザバイナリは共有キャッシュ（macOS なら `~/Library/Caches/ms-playwright`）へ
- * 落としておく必要がある。未取得だと MCP ツールの初回呼び出しが実行時に失敗する。
+ * 事前導入が不要だが、ブラウザ（Chrome）は事前に入れておく必要がある。未取得だと MCP ツールの初回呼び出しが実行時に失敗する。
  *
  * Linux ではさらにシステムライブラリ（`install-deps`）が必要なため、続けて実行する。同コマンドは
  * apt 等を叩くので非 root では `sudo` 経由になり、パスワード入力を求められうる。
  *
  * どちらも冪等（取得済み・導入済みならスキップされる）なので install / update で分岐しない。
  *
- * ponytail: chromium のみ。firefox / webkit や `--browser chrome`（ブランドChannel）が要るように
- * なったら browsers 引数を増やす。
+ * shortcut: chrome のみ。firefox / webkit が要るようになったら browsers 引数を増やす。
  */
 export declare function installPlaywrightBrowsers(logPrefix: string): Promise<boolean>;

package/dist/{dispatcher-UTBV3L5Z.js → dispatcher-M7ELTAHV.js}

@@ -3,7 +3,7 @@ async function loadHerdr() {
   return await import("./herdr-NDLUM6JF.js");
 }
 async function loadTable() {
-  return await import("./table-OOKBQVW5.js");
+  return await import("./table-EENSXIIT.js");
 }
 var { getDisplayWidth, truncateToWidth, padToWidth, buildLogTableLines, logLines, writeScreen } = await loadTable();
 var POLL_INTERVAL_MS = 7 * 1e3;

package/dist/gh.d.ts

@@ -90,7 +90,7 @@ export declare function excludePrsByLabels<T extends {
         name: string;
     }[];
 }>(prs: T[], excludeLabels: string[]): T[];
-export declare function listPullRequestsWithChecks(assignee?: string, label?: string, excludeLabels?: string[], limit?: number): Promise<PullRequestWithChecks[]>;
+export declare function listPullRequestsWithChecks(assignee?: string, label?: string | string[], excludeLabels?: string[], limit?: number, searchExcludeLabels?: string[]): Promise<PullRequestWithChecks[]>;
 export declare function addLabel(type: "issue" | "pr", number: number, label: string): Promise<void>;
 export declare function addAssignee(type: "issue" | "pr", number: number, login: string): Promise<void>;
 export declare function hasLabel(type: "issue" | "pr", number: number, label: string): Promise<boolean>;

package/dist/{herdr-runner-TNX2W4G6.js → herdr-runner-S5X5NTFR.js}

@@ -1,6 +1,6 @@
 import {
   CONTROL_CHARS
-} from "./chunk-HFU27QHT.js";
+} from "./chunk-BA2CE3L6.js";
 
 // src/transcript.ts
 import { existsSync, readFileSync, readdirSync } from "node:fs";

package/dist/index.js

@@ -13,6 +13,7 @@ import {
   bodyMentionsIssue,
   buildScriptCommand,
   buildTokenLimitText,
+  carryLabelFiltersToPr,
   checkCloudConfig,
   closeIssue,
   closePullRequest,
@@ -55,7 +56,6 @@ import {
   parseClosingIssueNumbers,
   partitionEnabledWorkers,
   remoteTrackingSha,
-  removeStaleWorktrees,
   renderTable,
   resolveInheritConfigSource,
   resolveWorkerFilePath,
@@ -65,13 +65,14 @@ import {
   shutdown,
   waitForAllProcesses,
   writeLastRun
-} from "./chunk-D4BPQ3K3.js";
+} from "./chunk-725IRSKF.js";
 import {
   UserConfigError,
   assertCloudCompatibleCommand,
   assertProjectCompatibleCommand,
   buildForwardedCommand,
   captureConsole,
+  findProjectLabelFilters,
   getInheritConfigPath,
   getRunMode,
   hasCloudFlag,
@@ -79,7 +80,7 @@ import {
   loadUserConfig,
   parseProjectFilters,
   resolveTargetProjects
-} from "./chunk-HFU27QHT.js";
+} from "./chunk-BA2CE3L6.js";
 import {
   npmInstallGlobalLatest,
   runCommand
@@ -355,7 +356,8 @@ function prMissingComment(worktreeId, output, cloud) {
     "- \u624B\u52D5\u3067PR\u3092\u4F5C\u6210\u3057\u305F\u5834\u5408\u306A\u3069\u5BFE\u5FDC\u6E08\u307F\u306E\u5834\u5408: `cc-need-human-check` \u30E9\u30D9\u30EB\u3092\u5916\u3057\u3066\u304F\u3060\u3055\u3044"
   ].join("\n");
 }
-async function ensurePrTriageMetadata(prNumber) {
+async function ensurePrTriageMetadata(prNumber, labelFilters) {
+  await carryLabelFiltersToPr("exec-issue", prNumber, labelFilters);
   await addLabel("pr", prNumber, "cc-triage-scope").catch(
     (err) => console.error(`[exec-issue] addLabel cc-triage-scope failed for PR #${prNumber}: ${err}`)
   );
@@ -398,7 +400,7 @@ async function verifyPrCreated(issueNumber, worktreeId, output, ctx) {
   }
   if (prNumber !== null) {
     await addLabel("issue", issueNumber, "cc-pr-created");
-    await ensurePrTriageMetadata(prNumber);
+    await ensurePrTriageMetadata(prNumber, ctx.labelFilters);
     return;
   }
   console.error(
@@ -534,6 +536,7 @@ var createUiDesignWorker = defineWorker({
         }
         try {
           await addLabel("pr", prNumber, "cc-ui-design");
+          await carryLabelFiltersToPr("create-ui-design", prNumber, ctx.labelFilters);
           if (yolo) {
             await addLabel("pr", prNumber, "cc-triage-scope");
           } else {
@@ -584,7 +587,7 @@ var epicIssueWorker = createIssuePollingWorker({
     if (summary.completed !== summary.total) return "skip";
     return "proceed";
   },
-  onCompleted: async (issueNumber) => {
+  onCompleted: async (issueNumber, _worktreeId, _output, ctx) => {
     const prNumber = await findOpenPrNumberByHeadRef(`cc-epic-${issueNumber}`);
     if (prNumber === null) {
       console.error(`[epic-issue] Epic PR for branch cc-epic-${issueNumber} not found; skip cc-pr-created`);
@@ -597,6 +600,7 @@ var epicIssueWorker = createIssuePollingWorker({
     await addLabel("issue", issueNumber, "cc-pr-created");
     await addLabel("pr", prNumber, "cc-epic-issue");
     await addLabel("pr", prNumber, "cc-triage-scope");
+    await carryLabelFiltersToPr("epic-issue", prNumber, ctx.labelFilters);
     await getCurrentUser().then((user) => addAssignee("pr", prNumber, user)).catch((err) => console.error(`[epic-issue] addAssignee failed for PR #${prNumber}: ${err}`));
   }
 });
@@ -1119,9 +1123,9 @@ async function loadRunCommand3() {
 }
 var PLAYWRIGHT_CORE_PACKAGE = "playwright-core";
 var PLAYWRIGHT_MCP_PACKAGE = "@playwright/mcp";
-var INSTALL_BROWSER_ARGS = ["-y", `${PLAYWRIGHT_MCP_PACKAGE}@latest`, "install-browser", "--no-shell", "chromium"];
+var INSTALL_BROWSER_ARGS = ["-y", `${PLAYWRIGHT_MCP_PACKAGE}@latest`, "install-browser", "chrome"];
 function buildInstallDepsCommand(uid) {
-  const npxArgs = ["-y", `${PLAYWRIGHT_CORE_PACKAGE}@latest`, "install-deps", "chromium"];
+  const npxArgs = ["-y", `${PLAYWRIGHT_CORE_PACKAGE}@latest`, "install-deps", "chrome"];
   return uid === 0 ? { command: "npx", args: npxArgs } : { command: "sudo", args: ["npx", ...npxArgs] };
 }
 async function installPlaywrightBrowsers(logPrefix) {
@@ -1536,7 +1540,7 @@ async function loadCustomWorkersOrExit() {
   return workers;
 }
 function printUsage() {
-  console.log(`Usage: claude-task-worker <command> [--project <name>] [--epic <issue-number>] [--label <label-name>]
+  console.log(`Usage: claude-task-worker <command> [--project <name>] [--epic <issue-number>] [--label <label-name>] [--exclude-label <label-name>]
 
 Commands:
   init [--force]  Create required GitHub labels and config file (use --force to overwrite existing files)
@@ -1560,7 +1564,9 @@ Options:
   --inherit-config <path>  Use the given config file as the base. claude-task-worker.json and claude-task-worker.local.json in the current directory are layered on top (their keys win). Relative paths inside the file resolve from its own directory. With init, the config file is generated at this path.
   --debug           Post each task's final report as a comment on the target Issue/PR (off by default; the report is only sent to Slack). Works in both local and --cloud runs.
   --epic <number>   Limit issue-based workers to sub-issues of the specified epic issue. Repeatable: any matching parent (OR).
-  --label <name>    Limit issue-based workers to issues that also carry the specified label. Repeatable: all must be present (AND).
+  --label <name>    Limit issue- and PR-based workers to issues/PRs that also carry the specified label. Repeatable: all must be present (AND).
+  --exclude-label <name>  Skip issues and PRs that carry the specified label. Repeatable: each is applied (AND), so any listed label excludes the item.
+                    Per-project defaults: write a project in config.json as { "path": "...", "label": [...], "excludeLabel": [...] }; they are added to the flags only when started via --project.
 
 Example:
   claude-task-worker init
@@ -1569,6 +1575,7 @@ Example:
   claude-task-worker all --epic 100 --epic 200
   claude-task-worker all --label priority-high
   claude-task-worker all --label priority-high --label needs-design
+  claude-task-worker all --exclude-label wip
   claude-task-worker yolo --epic 100 --epic 200 --label priority-high
   claude-task-worker all --project all
   claude-task-worker all --project web
@@ -1637,8 +1644,18 @@ function parseEpicFilters() {
     return num;
   });
 }
-function parseLabelFilters() {
-  return collectFlagValues("--label");
+function parseLabelOptions() {
+  const project = findProjectLabelFilters();
+  const uniq = (values) => [...new Set(values)];
+  const labelFilters = uniq([...collectFlagValues("--label"), ...project.label]);
+  const excludeLabelFilters = uniq([...collectFlagValues("--exclude-label"), ...project.excludeLabel]);
+  const overlapped = labelFilters.filter((l) => excludeLabelFilters.includes(l));
+  if (overlapped.length > 0) {
+    console.warn(
+      `[worker] label(s) in both --label and --exclude-label, no issue/PR will match: ${overlapped.join(", ")}`
+    );
+  }
+  return { labelFilters, excludeLabelFilters };
 }
 process.on("unhandledRejection", (err) => {
   console.error("[worker] unhandled rejection:", err);
@@ -1774,7 +1791,7 @@ if (hasProjectFilter()) {
     let sessions = /* @__PURE__ */ new Map();
     let monitorHandle;
     const herdr = await import("./herdr-NDLUM6JF.js");
-    const dispatcher = await import("./dispatcher-UTBV3L5Z.js");
+    const dispatcher = await import("./dispatcher-M7ELTAHV.js");
     captureConsole();
     const shutdownController = dispatcher.createDispatcherShutdownHandler(
       (options) => dispatcher.shutdownDispatcher(sessions, monitorHandle, options)
@@ -1840,40 +1857,37 @@ if (hasProjectFilter()) {
   for (const c of customWorkers) printWorkerRow(c.definition.name, "custom", c.source);
 } else if (workerType === "all") {
   const epicFilters = parseEpicFilters();
-  const labelFilters = parseLabelFilters();
+  const labelOptions = parseLabelOptions();
   (async () => {
     await assertRunPrerequisites();
-    await removeStaleWorktrees();
     await Promise.all(
       startEnabledWorkers(
         candidateNames((e) => e.inAll),
-        { epicFilters, labelFilters }
+        { epicFilters, ...labelOptions }
       )
     );
   })();
 } else if (workerType === "yolo") {
   const epicFilters = parseEpicFilters();
-  const labelFilters = parseLabelFilters();
+  const labelOptions = parseLabelOptions();
   (async () => {
     await assertRunPrerequisites();
-    await removeStaleWorktrees();
     await Promise.all(
       startEnabledWorkers(
         candidateNames((e) => e.inYolo),
-        { epicFilters, labelFilters }
+        { epicFilters, ...labelOptions }
       )
     );
   })();
 } else {
   const epicFilters = parseEpicFilters();
-  const labelFilters = parseLabelFilters();
+  const labelOptions = parseLabelOptions();
   (async () => {
     if (!isWorkerEnabled(workerType)) {
       console.error(`[worker] ${disabledWorkerMessage(workerType)}`);
       process.exit(1);
     }
     await assertRunPrerequisites();
-    await removeStaleWorktrees();
-    await WORKERS[workerType].start({ epicFilters, labelFilters });
+    await WORKERS[workerType].start({ epicFilters, ...labelOptions });
   })();
 }

package/dist/lib.js

@@ -55,12 +55,12 @@ import {
   removeWorktreeByBranch,
   run,
   syncDefaultBranch
-} from "./chunk-D4BPQ3K3.js";
+} from "./chunk-725IRSKF.js";
 import {
   getPermissionMode,
   getRunMode,
   isAdvisorEnabled
-} from "./chunk-HFU27QHT.js";
+} from "./chunk-BA2CE3L6.js";
 export {
   CLOUD_DONE_LABEL,
   addAssignee,

package/dist/random-name.d.ts

@@ -1,2 +1 @@
 export declare function generateWorktreeName(): string;
-export declare function isGeneratedWorktreeName(name: string): boolean;

package/dist/{table-OOKBQVW5.js → table-EENSXIIT.js}

@@ -16,7 +16,7 @@ import {
   truncateToWidth,
   wrapToWidth,
   writeScreen
-} from "./chunk-HFU27QHT.js";
+} from "./chunk-BA2CE3L6.js";
 export {
   CLOUD_WORKTREE_LABEL,
   CONTROL_CHARS,

package/dist/user-config.d.ts

@@ -10,6 +10,11 @@ export interface UserConfig {
     permission: PermissionMode;
     projects: Record<string, string>;
     projectGroups: Record<string, string[]>;
+    projectLabelFilters: Record<string, ProjectLabelFilters>;
+}
+export interface ProjectLabelFilters {
+    label: string[];
+    excludeLabel: string[];
 }
 export interface ResolvedProject {
     name: string;
@@ -28,4 +33,5 @@ export declare function resetAdvisorCache(): void;
 export declare function getPermissionMode(): PermissionMode;
 export declare function resetPermissionModeCache(): void;
 export declare function findProjectNameByPath(path: string): string | undefined;
+export declare function findProjectLabelFilters(projectName?: string | undefined): ProjectLabelFilters;
 export declare function resolveTargetProjects(requested: string[], config: UserConfig): ResolvedProject[];

package/dist/workers/exec-issue.d.ts

@@ -11,5 +11,6 @@ export declare function verifyPrCreated(issueNumber: number, worktreeId: string,
     cloud: boolean;
     baseBranch: string;
     startedAt: number;
+    labelFilters?: string[];
 }): Promise<boolean | void>;
 export declare const execIssueWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/issue-worker.d.ts

@@ -1,5 +1,6 @@
 import type { Issue } from "../gh";
 import type { WorkerDefinition } from "./worker-definition";
+export declare function carryLabelFiltersToPr(workerName: string, prNumber: number, labelFilters?: string[]): Promise<void>;
 export declare const consumableTriggerLabels: (triggerLabels: string[]) => string[];
 export type PreflightResult = "proceed" | "skip" | "mark-pr-created";
 export interface IssueWorkerConfig {
@@ -13,6 +14,7 @@ export interface IssueWorkerConfig {
         cloud: boolean;
         baseBranch: string;
         startedAt: number;
+        labelFilters?: string[];
     }) => Promise<boolean | void>;
     cloudOnBranch?: (issue: Issue, baseBranch: string) => Promise<string>;
 }

package/dist/workers/worker-definition.d.ts

@@ -2,6 +2,7 @@ export type WorkerKind = "issue" | "pr" | "scheduled";
 export interface WorkerStartOptions {
     epicFilters?: number[];
     labelFilters?: string[];
+    excludeLabelFilters?: string[];
 }
 export declare const WORKER_DEFINITION: unique symbol;
 export interface WorkerDefinition {

package/dist/worktree.d.ts

@@ -13,9 +13,3 @@ export declare function getWorktreePath(worktreeId: string): string;
 export declare function createWorktreeFromBranch(worktreeId: string, baseBranch: string): Promise<void>;
 export declare function removeWorktree(worktreeId: string): Promise<void>;
 export declare function removeWorktreeByBranch(branchName: string): Promise<void>;
-/**
- * 前回のクラッシュ・強制終了などで残った worktree を起動時に一括回収する。
- * generateWorktreeName() 形式（adj-noun-4桁）の名前だけを対象にすることで、
- * ユーザーが対話セッションで使用中の claude worktree を誤って削除しない。
- */
-export declare function removeStaleWorktrees(): Promise<void>;

package/package.json

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