claude-task-worker 0.115.0 → 0.117.0

package/dist/last-run-pr.d.ts

@@ -0,0 +1,16 @@
+export declare function lastRunBranchName(workerName: string): string;
+export declare function hasLastRunChange(porcelain: string): boolean;
+export declare function lastRunPrTitle(workerName: string): string;
+export declare function lastRunPrBody(workerName: string, at: Date): string;
+/**
+ * 定期ワーカーの最終実行時刻（`lastRun`）だけを更新するPRを作る。
+ *
+ * スキルの成果物PRとは独立させている。材料が無くてスキルがPRを作らなかった日でも
+ * `lastRun` をマージで恒久化する必要があり、それをスキル本文の手順（＝モデルの遵守）に
+ * 依存させると、材料ゼロの早期終了パスで黙って落ちる。
+ *
+ * 返り値のPR番号は、クラウド実行の完了検知（cc-cloud-done）の置き先としても使う。
+ * 定期ワーカーは Issue/PR を起点に走らないため、他に検知対象になるものが無い。
+ * PRを作らなかった場合（差分なし・失敗）は null。
+ */
+export declare function publishLastRunPr(workerName: string, defaultBranch: string, at: Date): Promise<number | null>;

package/dist/lib.d.ts

@@ -0,0 +1,20 @@
+export { createIssuePollingWorker } from "./workers/issue-worker";
+export type { IssueWorkerConfig, PreflightResult } from "./workers/issue-worker";
+export { createPrPollingWorker } from "./workers/pr-worker";
+export type { PrWorkerConfig } from "./workers/pr-worker";
+export { createScheduledWorker } from "./workers/scheduled-worker";
+export type { ScheduledWorkerConfig } from "./workers/scheduled-worker";
+export { defineWorker, isWorkerDefinition } from "./workers/worker-definition";
+export type { WorkerDefinition, WorkerKind, WorkerStartOptions } from "./workers/worker-definition";
+export { addAssignee, addLabel, closeIssue, commentOnIssue, commentOnPR, findOpenPrNumberByHeadRef, findPrNumberByHeadRef, findPrStateByHeadRef, getCurrentUser, getIssueBody, getIssueState, getIssueSubIssuesSummary, getPrDetail, getPrMergeable, getRepoInfo, hasLabel, hasOpenBlockers, linkClosingPr, listIssuesByLabel, listIssuesByNumbers, listPrsClosingIssue, listPrsCrossReferencingIssue, listPullRequestsWithChecks, parseClosingIssueNumbers, removeLabel, } from "./gh";
+export type { ClosingPrRef, Issue, PullRequestWithChecks } from "./gh";
+export { ensureEpicBranch, syncDefaultBranch } from "./git";
+export { createWorktreeFromBranch, deleteLocalBranch, getWorktreePath, localBranchExists, removeWorktree, removeWorktreeByBranch, } from "./worktree";
+export { isRunning, isShuttingDown, isWorkerAtCapacity, run } from "./process-manager";
+export { notifyError, notifyTaskCompleted, notifyTaskFailed } from "./slack";
+export { buildClaudeEnv, buildClaudeExecution } from "./claude-args";
+export { CLOUD_DONE_LABEL, getLastRunAt, getRemoteEnvId, getUiDesignConfig, getWorkerConfig, isCloudWorker, loadConfig, } from "./config";
+export type { WorkerRuntimeConfig } from "./config";
+export { getPermissionMode, getRunMode, isAdvisorEnabled } from "./user-config";
+export { publishLastRunPr } from "./last-run-pr";
+export { generateWorktreeName } from "./random-name";

package/dist/lib.js

@@ -0,0 +1,123 @@
+import {
+  CLOUD_DONE_LABEL,
+  addAssignee,
+  addLabel,
+  buildClaudeEnv,
+  buildClaudeExecution,
+  closeIssue,
+  commentOnIssue,
+  commentOnPR,
+  createIssuePollingWorker,
+  createPrPollingWorker,
+  createScheduledWorker,
+  createWorktreeFromBranch,
+  defineWorker,
+  deleteLocalBranch,
+  ensureEpicBranch,
+  findOpenPrNumberByHeadRef,
+  findPrNumberByHeadRef,
+  findPrStateByHeadRef,
+  generateWorktreeName,
+  getCurrentUser,
+  getIssueBody,
+  getIssueState,
+  getIssueSubIssuesSummary,
+  getLastRunAt,
+  getPermissionMode,
+  getPrDetail,
+  getPrMergeable,
+  getRemoteEnvId,
+  getRepoInfo,
+  getRunMode,
+  getUiDesignConfig,
+  getWorkerConfig,
+  getWorktreePath,
+  hasLabel,
+  hasOpenBlockers,
+  isAdvisorEnabled,
+  isCloudWorker,
+  isRunning,
+  isShuttingDown,
+  isWorkerAtCapacity,
+  isWorkerDefinition,
+  linkClosingPr,
+  listIssuesByLabel,
+  listIssuesByNumbers,
+  listPrsClosingIssue,
+  listPrsCrossReferencingIssue,
+  listPullRequestsWithChecks,
+  loadConfig,
+  localBranchExists,
+  notifyError,
+  notifyTaskCompleted,
+  notifyTaskFailed,
+  parseClosingIssueNumbers,
+  publishLastRunPr,
+  removeLabel,
+  removeWorktree,
+  removeWorktreeByBranch,
+  run,
+  syncDefaultBranch
+} from "./chunk-FAD5CNP4.js";
+import "./chunk-N42YU3GJ.js";
+export {
+  CLOUD_DONE_LABEL,
+  addAssignee,
+  addLabel,
+  buildClaudeEnv,
+  buildClaudeExecution,
+  closeIssue,
+  commentOnIssue,
+  commentOnPR,
+  createIssuePollingWorker,
+  createPrPollingWorker,
+  createScheduledWorker,
+  createWorktreeFromBranch,
+  defineWorker,
+  deleteLocalBranch,
+  ensureEpicBranch,
+  findOpenPrNumberByHeadRef,
+  findPrNumberByHeadRef,
+  findPrStateByHeadRef,
+  generateWorktreeName,
+  getCurrentUser,
+  getIssueBody,
+  getIssueState,
+  getIssueSubIssuesSummary,
+  getLastRunAt,
+  getPermissionMode,
+  getPrDetail,
+  getPrMergeable,
+  getRemoteEnvId,
+  getRepoInfo,
+  getRunMode,
+  getUiDesignConfig,
+  getWorkerConfig,
+  getWorktreePath,
+  hasLabel,
+  hasOpenBlockers,
+  isAdvisorEnabled,
+  isCloudWorker,
+  isRunning,
+  isShuttingDown,
+  isWorkerAtCapacity,
+  isWorkerDefinition,
+  linkClosingPr,
+  listIssuesByLabel,
+  listIssuesByNumbers,
+  listPrsClosingIssue,
+  listPrsCrossReferencingIssue,
+  listPullRequestsWithChecks,
+  loadConfig,
+  localBranchExists,
+  notifyError,
+  notifyTaskCompleted,
+  notifyTaskFailed,
+  parseClosingIssueNumbers,
+  publishLastRunPr,
+  removeLabel,
+  removeWorktree,
+  removeWorktreeByBranch,
+  run,
+  syncDefaultBranch
+};

package/dist/process-manager.d.ts

@@ -0,0 +1,38 @@
+import { type CloudPromptTarget } from "./claude-args";
+import type { AgentStatus } from "./herdr";
+import { logLines } from "./table";
+type TaskStatus = "running" | "completed" | "failed";
+export interface TaskEntry {
+    id: number;
+    title: string;
+    status: TaskStatus;
+    workerName: string;
+    path?: string;
+    startedAt: Date;
+    finishedAt?: Date;
+    agentStatus?: AgentStatus;
+}
+export { logLines };
+export declare function makeLogFeeder(id: number, stream: "stdout" | "stderr"): {
+    feed(chunk: Buffer): void;
+    flush(): void;
+};
+export declare function setShuttingDown(): void;
+export declare function isShuttingDown(): boolean;
+export declare function isRunning(id: number): boolean;
+export declare function isWorktreeInUse(worktreeId: string): boolean;
+export declare function isWorkerAtCapacity(workerName: string): boolean;
+export declare function renderTable(): void;
+export declare function ensureRenderInterval(): void;
+type OnComplete = (status: "completed" | "failed", output: string, cloudSessionId?: string) => Promise<void>;
+export declare function onCompleteWithDebugReport(onComplete?: OnComplete, target?: CloudTarget): OnComplete | undefined;
+export declare function resolveProjectName(cwd?: string): string;
+export declare const CLOUD_SESSION_TIMEOUT_MS: number;
+export declare const CLOUD_SESSION_POLL_INTERVAL_MS = 1000;
+export declare const CLOUD_POLL_INTERVAL_MS: number;
+export declare const CLOUD_TASK_TIMEOUT_MS: number;
+export type CloudTarget = CloudPromptTarget;
+export declare function waitForCloudTask(id: number, target: CloudTarget): Promise<"completed" | "timeout" | "aborted">;
+export declare function run(command: string, args: string[], id: number, title: string, workerName: string, path?: string, onComplete?: OnComplete, cwd?: string, env?: Record<string, string>, prompt?: string, cloud?: boolean, cloudTarget?: CloudTarget, model?: string): void;
+export declare function waitForAllProcesses(): Promise<void>;
+export declare function shutdown(signal?: NodeJS.Signals): void;

package/dist/random-name.d.ts

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

package/dist/run-command-O2TMRPZK.js

@@ -0,0 +1,8 @@
+import {
+  npmInstallGlobalLatest,
+  runCommand
+} from "./chunk-3RY43CYR.js";
+export {
+  npmInstallGlobalLatest,
+  runCommand
+};

package/dist/runcat.d.ts

@@ -0,0 +1,23 @@
+import type { UsageInfo } from "./slack";
+export interface RuncatMetric {
+    title: string;
+    formattedValue: string;
+    normalizedValue: number;
+}
+export interface RuncatSnapshot {
+    title: string;
+    symbol: string;
+    metrics: RuncatMetric[];
+    metricsBarValue?: string;
+    lastUpdatedDate: string;
+}
+/** 'HH:MM' 形式。日を跨ぐ場合は 'MM/DD HH:MM' として日付も付ける。不正値は空文字。 */
+export declare function resetStamp(isoString: string, now?: Date): string;
+/** 'HH' のみ。バーのように幅が限られる用途向け。不正値は空文字。 */
+export declare function resetHour(isoString: string): string;
+export declare function buildRuncatSnapshot(usage: UsageInfo, now?: Date): RuncatSnapshot;
+/**
+ * RunCat Neo 用のスナップショットを書き出す。
+ * RunCat 側が読み取り中の中途半端な内容を掴まないよう、一時ファイルへ書いてから rename で差し替える。
+ */
+export declare function writeRuncatUsage(usage: UsageInfo, outFile?: string): void;

package/dist/slack.d.ts

@@ -0,0 +1,46 @@
+export declare function send(payload: Record<string, unknown>): Promise<void>;
+export interface UsageInfo {
+    fiveHourUtilization: number;
+    fiveHourResetsAt: string;
+    sevenDayUtilization: number;
+    sevenDayResetsAt: string;
+}
+/**
+ * 現在の利用状況を取得し、RunCat Neo 用スナップショットを更新したうえで通知に添えるテキストを返す。
+ * ワーカーの完了/失敗通知はすべてここを通るため、タスクが終わるたびに RunCat 側も最新化される
+ * （Slack webhook 未設定でも通知が no-op になるだけで、スナップショットの更新は行われる）。
+ */
+export declare function buildTokenLimitText(): Promise<string>;
+/**
+ * 通知本文へ載せる output を末尾1000文字に切り詰める。
+ * 案内文（CLOUD_FAILURE_GUIDANCE）は appendCloudFailureGuidance が output の先頭に
+ * 付けるが、単純な末尾切り出しだと長いエラー本文で先頭の案内文ごと消えてしまう。
+ * 先頭一致で検出できた場合は案内文を切り出し領域の外に確保し、残りだけを末尾切り出しする。
+ */
+export declare function truncateOutputForNotification(output: string): string;
+/**
+ * 完了/失敗通知の本文を組み立てる純粋関数。
+ * cloud が渡された（＝クラウド実行）場合のみ先頭行を出す: sessionId が非空ならセッションURL、
+ * 空ならID抽出失敗を明記する（Slack側で通知の最初の一行だけが折りたたみ表示でも見えるため、先頭に置く）。
+ * ローカル実行（cloud 省略）では先頭行を出さない。
+ */
+export declare function buildTaskNotificationText(params: {
+    status: "completed" | "failed";
+    workerName: string;
+    repoName: string;
+    id: number;
+    title: string;
+    url: string;
+    tokenText: string;
+    output?: string;
+    cloud?: {
+        sessionId?: string;
+    };
+}): string;
+export declare function notifyTaskCompleted(workerName: string, repoName: string, id: number, title: string, url: string, output?: string, cloud?: {
+    sessionId?: string;
+}): Promise<void>;
+export declare function notifyTaskFailed(workerName: string, repoName: string, id: number, title: string, url: string, output?: string, cloud?: {
+    sessionId?: string;
+}): Promise<void>;
+export declare function notifyError(workerName: string, repoName: string, error: unknown): Promise<void>;

package/dist/table-DWVMNDS3.js

@@ -0,0 +1,32 @@
+import {
+  CLOUD_WORKTREE_LABEL,
+  CONTROL_CHARS,
+  LOG_DISPLAY_LIMIT,
+  TASK_DISPLAY_LIMIT,
+  buildLogTableLines,
+  buildTaskTableLines,
+  captureConsole,
+  getDisplayWidth,
+  logLines,
+  padToWidth,
+  pushLogLine,
+  selectRecentTasks,
+  truncateToWidth,
+  writeScreen
+} from "./chunk-N42YU3GJ.js";
+export {
+  CLOUD_WORKTREE_LABEL,
+  CONTROL_CHARS,
+  LOG_DISPLAY_LIMIT,
+  TASK_DISPLAY_LIMIT,
+  buildLogTableLines,
+  buildTaskTableLines,
+  captureConsole,
+  getDisplayWidth,
+  logLines,
+  padToWidth,
+  pushLogLine,
+  selectRecentTasks,
+  truncateToWidth,
+  writeScreen
+};

package/dist/table.d.ts

@@ -0,0 +1,55 @@
+export declare function getDisplayWidth(str: string): number;
+export declare function truncateToWidth(str: string, maxWidth: number): string;
+export declare function padToWidth(str: string, targetWidth: number): string;
+/**
+ * クラウド実行（`--cloud`）のタスクは worktree を作らないため、Worktree 列にローカルの
+ * パスの代わりにこの表示を入れる（空欄だと「どこで動いているのか分からない」ため）。
+ * ANSI の色付きだが、getDisplayWidth がエスケープを除外するので桁揃えは崩れない。
+ */
+export declare const CLOUD_WORKTREE_LABEL = "\u001B[36m\u2601 running in cloud\u001B[0m";
+/** ステータステーブル1行分のタスク情報。process-manager の TaskEntry を構造的に受け取る。 */
+export interface TaskTableEntry {
+    id: number;
+    title: string;
+    status: string;
+    workerName: string;
+    path?: string;
+    startedAt: Date;
+    finishedAt?: Date;
+    agentStatus?: string;
+}
+/** タスクテーブル/ログテーブルで表示する既定の最大件数。 */
+export declare const TASK_DISPLAY_LIMIT = 20;
+export declare const LOG_DISPLAY_LIMIT = 20;
+/**
+ * 表示するタスクを「直近 limit 件」に絞り込む純粋関数。同じ Issue/PR（id）は
+ * 呼び出し元の Map で既に一意化されている前提だが、二重登録に備えて id で重複排除し
+ * 最新のものだけを残す。実行中タスクを先頭に、その下を直近順（新しい順）に並べ、
+ * 合計 limit 件で打ち切る。
+ */
+export declare function selectRecentTasks(entries: TaskTableEntry[], limit?: number): TaskTableEntry[];
+/** ステータステーブルの各行を組み立てる。副作用を持たないのでそのままテストできる。 */
+export declare function buildTaskTableLines(entries: TaskTableEntry[], now?: Date): string[];
+/** ログテーブル1行分。実行中タスクの標準出力/エラー出力、またはワーカー自身の console 出力の1行。 */
+export interface LogTableEntry {
+    /** タスクの Issue/PR 番号。ワーカー自身の console 出力には無い。 */
+    id?: number;
+    stream: string;
+    text: string;
+    time: Date;
+}
+/**
+ * 実行中タスクのログとワーカー自身の console 出力を混ぜたローリングバッファ。
+ * 直近 LOG_DISPLAY_LIMIT 行だけ残す。
+ */
+export declare const logLines: LogTableEntry[];
+export declare function pushLogLine(entry: LogTableEntry): void;
+/** 画面全体をテーブルで差し替える。captureConsole() の影響を受けない。 */
+export declare function writeScreen(lines: string[]): void;
+export declare function captureConsole(): void;
+export declare const CONTROL_CHARS: RegExp;
+/**
+ * 実行中タスクの標準出力/エラー出力のログをテーブルに組み立てる純粋関数。
+ * 新しい行ほど上に来るよう時刻の降順で並べる（テーブル下端はステータス表示に隠れやすいため）。
+ */
+export declare function buildLogTableLines(entries: LogTableEntry[]): string[];

package/dist/task-result.d.ts

@@ -0,0 +1,25 @@
+export declare const STDERR_TAIL_LIMIT: number;
+export interface TaskResult {
+    status: "completed" | "failed";
+    output: string;
+    cloudSessionId?: string;
+}
+export declare const CLOUD_FAILURE_GUIDANCE: string;
+/**
+ * クラウド実行の失敗結果にのみ、前提条件の案内を output へ追記する。
+ * ローカル実行（cloud が false）や完了結果には一切追記しない。
+ * 案内文は output の前に置く。Slack 通知は末尾1000文字を切り出すため、後ろに置くと
+ * 実際のエラー本文が案内文に押し出されて読めなくなる。
+ */
+export declare function appendCloudFailureGuidance(result: TaskResult, cloud: boolean | undefined): TaskResult;
+/**
+ * 子プロセスの終了状態を completed / failed に分類し、通知用の出力文字列を組み立てる。
+ *
+ * exit 0 でも stdout が空の場合は失敗として扱う。claude -p は正常完了時に必ず最終
+ * レポートを stdout へ出力するため、空のままの exit 0 は「スキルプリアンブルの
+ * `!` コマンド失敗などでモデル未起動のままセッションが中断された」ことを意味する。
+ * これを完了扱いにするとワーカーがラベル遷移を進めてしまい、トリガーラベルが
+ * 再装填される triage-pr では毎ポーリングで空振りセッションを起動し続ける
+ * 無限リトライループになる。
+ */
+export declare function buildTaskResult(code: number | null, stdout: string, stderrTail: string): TaskResult;

package/dist/transcript.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Claude Code のセッション transcript（JSONL）から最終レポートを取り出す。
+ *
+ * herdr モードには `claude -p` の stdout に相当するものが無いため、かつては
+ * `herdr pane read` で回収した端末内容をそのまま Slack 通知に載せていた。しかし
+ * TUI のペインは「会話ログ + 空行パディング + 入力ボックス + ステータスバー」で
+ * 構成されており、通知は末尾1000文字だけを切り出すため、実際に届くのは
+ * 罫線・`❯` プロンプト・`ctx 7% │ 5h 26%` といった TUI の装飾だけになる。
+ *
+ * 一方 Claude Code は会話を `~/.claude/projects/<エンコード済みcwd>/<session-id>.jsonl`
+ * へ書き出しており、そこには整形前の最終アシスタントメッセージがそのまま入っている。
+ * herdr は `agent get` でペインの claude セッションIDを返すため、それを鍵に
+ * transcript を引けば TUI をパースせずに正確な最終レポートが得られる。
+ */
+export declare function transcriptRoot(): string;
+export declare function findTranscriptPath(sessionId: string, root?: string): string | null;
+/**
+ * transcript の最終アシスタント発言（テキスト部分）を返す。
+ *
+ * - サブエージェントの発言（`isSidechain: true`）は除外する。メインエージェントの
+ *   完了報告こそが `claude -p` の stdout 相当であり、サブエージェントの報告は途中経過
+ * - テキストブロックを持たないエントリ（tool_use だけのターン）は飛ばす
+ * - 壊れた行は無視する（書き込み途中の末尾行など）
+ */
+export declare function extractFinalAssistantText(jsonl: string): string;
+/** セッションIDから最終レポートを読む。見つからない・空なら空文字列を返す。 */
+export declare function readFinalReport(sessionId: string | undefined, root?: string): string;

package/dist/user-config.d.ts

@@ -0,0 +1,30 @@
+export type RunMode = "default" | "herdr";
+export declare const DEFAULT_RUN_MODE: RunMode;
+export declare const DEFAULT_ADVISOR_ENABLED = false;
+export type PermissionMode = "manual" | "auto" | "acceptEdits" | "dontAsk" | "plan" | "bypassPermissions";
+export declare const PERMISSION_MODES: readonly PermissionMode[];
+export declare const DEFAULT_PERMISSION_MODE: PermissionMode;
+export interface UserConfig {
+    mode: RunMode;
+    advisor: boolean;
+    permission: PermissionMode;
+    projects: Record<string, string>;
+    projectGroups: Record<string, string[]>;
+}
+export interface ResolvedProject {
+    name: string;
+    path: string;
+}
+export declare class UserConfigError extends Error {
+    constructor(message: string);
+}
+export declare function getUserConfigPath(): string;
+export declare function loadUserConfig(): UserConfig;
+export declare function getRunMode(): RunMode;
+export declare function resetRunModeCache(): void;
+export declare function isAdvisorEnabled(): boolean;
+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 resolveTargetProjects(requested: string[], config: UserConfig): ResolvedProject[];

package/dist/workers/answer-issue-questions.d.ts

@@ -0,0 +1 @@
+export declare const answerIssueQuestionsWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/apply-ui-design.d.ts

@@ -0,0 +1 @@
+export declare const applyUiDesignWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/check-dependabot.d.ts

@@ -0,0 +1 @@
+export declare const checkDependabotWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1 @@
+export declare const createIssueWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/create-ui-design.d.ts

@@ -0,0 +1,2 @@
+export declare function designPrLabelingFailedComment(issueNumber: number, prNumber: number, error: unknown, yolo?: boolean): string;
+export declare const createUiDesignWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1,2 @@
+export declare function epicPrMissingComment(issueNumber: number): string;
+export declare const epicIssueWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1,15 @@
+import type { ClosingPrRef } from "../gh";
+export declare function formatSessionReport(output: string): string;
+export declare function selectOwnedClosingPr(candidates: ClosingPrRef[], ctx: {
+    cloud: boolean;
+    expectedHeadRefName: string;
+    baseBranch: string;
+    startedAt: number;
+    now: number;
+}): number | null;
+export declare function verifyPrCreated(issueNumber: number, worktreeId: string, output: string, ctx: {
+    cloud: boolean;
+    baseBranch: string;
+    startedAt: number;
+}): Promise<boolean | void>;
+export declare const execIssueWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/fix-review-point.d.ts

@@ -0,0 +1 @@
+export declare const fixReviewPointWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1,18 @@
+import type { Issue } from "../gh";
+import type { WorkerDefinition } from "./worker-definition";
+export declare const consumableTriggerLabels: (triggerLabels: string[]) => string[];
+export type PreflightResult = "proceed" | "skip" | "mark-pr-created";
+export interface IssueWorkerConfig {
+    name: string;
+    command: string;
+    triggerLabels: string[];
+    excludeLabels?: string[];
+    epicFilterTarget?: "parent" | "self";
+    preflight?: (issue: Issue) => Promise<PreflightResult>;
+    onCompleted?: (issueNumber: number, worktreeId: string, output: string, ctx: {
+        cloud: boolean;
+        baseBranch: string;
+        startedAt: number;
+    }) => Promise<boolean | void>;
+}
+export declare function createIssuePollingWorker(config: IssueWorkerConfig): WorkerDefinition;

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

@@ -0,0 +1,18 @@
+import { type PullRequestWithChecks } from "../gh";
+import type { WorkerDefinition } from "./worker-definition";
+export interface PrWorkerConfig {
+    name: string;
+    command: string;
+    triggerLabel: string;
+    excludeLabels?: string[];
+    /**
+     * 完了時にトリガーラベルを外さない。`dependencies` のように GitHub 側（Dependabot）が
+     * 付ける分類ラベルをトリガーに使うワーカー向け。ワーカーが外すとPRの分類情報が失われる。
+     * 使う場合、再ポーリングで無限に拾い続けないよう `onFinally` で `excludeLabels` に
+     * 含まれるラベルを必ず付けること。
+     */
+    keepTriggerLabel?: boolean;
+    onCompleted?: (pr: PullRequestWithChecks, output: string) => Promise<void>;
+    onFinally?: (pr: PullRequestWithChecks) => Promise<void>;
+}
+export declare function createPrPollingWorker(config: PrWorkerConfig): WorkerDefinition;

package/dist/workers/registry.d.ts

@@ -0,0 +1,8 @@
+import type { WorkerDefinition } from "./worker-definition";
+export interface PresetWorkerEntry {
+    definition: WorkerDefinition;
+    description: string;
+    inAll: boolean;
+    inYolo: boolean;
+}
+export declare const PRESET_WORKERS: readonly PresetWorkerEntry[];

package/dist/workers/resolve-conflict.d.ts

@@ -0,0 +1,2 @@
+export declare function shouldFlagUnresolvedConflict(output: string, mergeable: string): boolean;
+export declare const resolveConflictWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1,8 @@
+import type { WorkerDefinition } from "./worker-definition";
+export declare const SCHEDULE_INTERVAL_HOURS = 24;
+export interface ScheduledWorkerConfig {
+    name: string;
+    command: string;
+    enabled?: () => boolean;
+}
+export declare function createScheduledWorker(config: ScheduledWorkerConfig): WorkerDefinition;

package/dist/workers/triage-created-issue.d.ts

@@ -0,0 +1 @@
+export declare const triageCreatedIssueWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/triage-pr.d.ts

@@ -0,0 +1,5 @@
+export declare function shouldCloseLinkedIssues(pr: {
+    state: string;
+    baseRefName: string;
+} | null, defaultBranch: string): boolean;
+export declare const triagePrWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/ui-design.d.ts

@@ -0,0 +1,14 @@
+export declare const DESIGN_REFERENCE_HEADING = "## UI\u30C7\u30B6\u30A4\u30F3";
+export declare function designBranchName(issueNumber: number): string;
+export declare function extractDesignFilePath(body: string): string | null;
+export declare function hasDesignReference(body: string): boolean;
+export declare function shouldVerifyDesignFileExists(cloud: boolean): boolean;
+export type DesignPrDisposition = "proceed" | "wait" | "needs-human";
+export declare function classifyDesignPr(pr: {
+    state: string;
+    mergedAt: string | null;
+} | null): DesignPrDisposition;
+export declare function designPrMissingComment(issueNumber: number): string;
+export declare function designPrNotCreatedComment(issueNumber: number): string;
+export declare function designReferenceMissingComment(issueNumber: number): string;
+export declare function designFileMissingComment(issueNumber: number, designFilePath: string): string;

package/dist/workers/update-coding-guidelines.d.ts

@@ -0,0 +1 @@
+export declare const updateCodingGuidelinesWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/update-design-md.d.ts

@@ -0,0 +1 @@
+export declare const updateDesignMdWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1 @@
+export declare const updateIssueWorker: import("./worker-definition").WorkerDefinition;

package/dist/workers/update-requirement-rules.d.ts

@@ -0,0 +1 @@
+export declare const updateRequirementRulesWorker: import("./worker-definition").WorkerDefinition;

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

@@ -0,0 +1,18 @@
+export type WorkerKind = "issue" | "pr" | "scheduled";
+export interface WorkerStartOptions {
+    epicFilters?: number[];
+    labelFilters?: string[];
+}
+export declare const WORKER_DEFINITION: unique symbol;
+export interface WorkerDefinition {
+    readonly [WORKER_DEFINITION]: true;
+    readonly name: string;
+    readonly kind: WorkerKind;
+    readonly start: (opts?: WorkerStartOptions) => Promise<void>;
+}
+export declare function defineWorker(def: {
+    name: string;
+    kind: WorkerKind;
+    start: (opts?: WorkerStartOptions) => Promise<void>;
+}): WorkerDefinition;
+export declare function isWorkerDefinition(value: unknown): value is WorkerDefinition;

package/dist/worktree.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ローカルブランチを削除する。worktree 削除後のブランチ残留（リーク）防止用。
+ * 存在しないブランチは黙って無視し、他の worktree で checkout 中などの失敗のみログする。
+ */
+export declare function deleteLocalBranch(branchName: string): Promise<void>;
+/**
+ * ローカルブランチが存在するかを返す。
+ * deleteLocalBranch が「他の worktree で checkout 中」などの理由で削除に失敗しても
+ * エラーはログに留まるため、削除後に本当に消えたかはこの関数で確認する。
+ */
+export declare function localBranchExists(branchName: string): Promise<boolean>;
+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>;