claude-task-worker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toshifumi Kiyono (getty104)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,386 @@
+# claude-task-worker
+
+GitHub Issues/PRを定期ポーリングし、Claude Codeに処理を委譲するCLIツール。
+
+本リポジトリに同梱されている `claude-task-worker` Claude Code プラグイン（`plugin/` ディレクトリ）と組み合わせることで、GitHub Issue の実装からPRのレビュー対応、Dependabot PRの対応までを自動化する。CLI 本体（npm パッケージ）とプラグイン（Claude Code マーケットプレイス）は同じリポジトリ・同じ名前で提供される。
+
+## アーキテクチャ
+
+`claude-task-worker` CLI がGitHubラベルを検知してタスクを起動し、`claude-task-worker` プラグインのスキルが実際の処理を担う。
+
+```
+┌────────────────────────────────────────────────────────┐
+│                         GitHub                         │
+│                                                        │
+│  Issue (cc-exec-issue)                            ──┐  │
+│  Issue (cc-triage-scope, blockedBy all closed)    ──┤  │
+│  Issue (cc-update-issue)                          ──┤  │
+│  Issue (cc-answer-issue-questions)                ──┤  │
+│  Issue (cc-issue-created + cc-triage-scope)       ──┤  │
+│  Issue (cc-epic-issue, all sub-issues closed)     ──┤  │
+│  PR    (cc-fix-onetime)                           ──┤  │
+│  PR    (cc-triage-scope)                          ──┤  │
+│  PR    (cc-resolve-conflict)                      ──┤  │
+│  PR    (dependencies, Dependabot)                 ──┤  │
+└─────────────────────────────────────────────────────┼──┘
+                                                      │
+                                                      ▼
+                                       ┌────────────────────────┐
+                                       │   claude-task-worker   │
+                                       └───────────┬────────────┘
+                                                   │ invoke
+                                                   ▼
+                                       ┌────────────────────────┐
+                                       │    Claude Code CLI     │
+                                       │  + claude-task-worker  │
+                                       │       plugin           │
+                                       └────────────────────────┘
+```
+
+### Worker と claude-task-worker プラグインのスキル対応
+
+| Worker | トリガーラベル | 呼び出されるスキル | デフォルト間隔 |
+|---|---|---|---|
+| `exec-issue` | `cc-exec-issue` | `/claude-task-worker:exec-issue` | 1分 |
+| `create-issue` | `cc-triage-scope` (Issue, blockedBy が全て Close) | `/claude-task-worker:create-issue-from-issue-number` | 1分 |
+| `update-issue` | `cc-update-issue` | `/claude-task-worker:update-issue` | 1分 |
+| `answer-issue-questions` | `cc-answer-issue-questions` | `/claude-task-worker:answer-issue-questions` | 1分 |
+| `fix-review-point` | `cc-fix-onetime` | `/claude-task-worker:fix-review-point` | 1分 |
+| `triage-created-issue` | `cc-issue-created` + `cc-triage-scope` (Issue) | `/claude-task-worker:triage-created-issue` | 1分 |
+| `triage-pr` | `cc-triage-scope` (PR) | `/claude-task-worker:triage-pr` | 1分 |
+| `resolve-conflict` | `cc-resolve-conflict` (PR) | `/claude-task-worker:resolve-conflict` | 1分 |
+| `check-dependabot` | `dependencies` (PR) | `/claude-task-worker:check-dependabot` | 1時間 |
+| `epic-issue` | `cc-epic-issue` (Issue, sub-issues が全て Close) | `/claude-task-worker:create-epic-pr` | 5分 |
+
+> ℹ️ Issue 系ワーカーはすべて GitHub Issue Dependencies の `-is:blocked` 検索 qualifier でサーバ側絞り込みを行うため、未解決の blockedBy Issue を持つ Issue は対象外となる。
+
+### Epic（親Issue）連携
+
+親Issue (Issue Dependencies の Parent) を持つサブIssueを処理する場合、ワーカーはデフォルトブランチではなく `cc-epic-<親Issue番号>` ブランチから worktree を作成する。エピック単位でブランチをまとめることで、サブIssueごとのPRを単一の統合ブランチに集約しやすくなる。エピックブランチが remote に無い場合はデフォルトブランチから自動派生して push される。
+
+`epic-issue` ワーカーは、`cc-epic-issue` ラベル付きの親Issueに紐づくサブIssueがすべて Close されたタイミングで `/claude-task-worker:create-epic-pr` を起動し、エピックブランチからまとめてPRを作成する。
+
+## セットアップ
+
+### 前提条件
+
+- [GitHub CLI (`gh`)](https://cli.github.com/) がインストール・認証済みであること
+- [Claude Code (`claude`)](https://docs.anthropic.com/en/docs/claude-code) がインストール済みであること
+- `claude-task-worker` プラグインがインストール済みであること（下記インストール手順を参照）
+
+### インストール
+
+#### 推奨手順（一発セットアップ）
+
+以下のコマンド一発で、Claude Code マーケットプレイスの追加・プラグインのインストール・CLI本体のグローバルインストールをまとめて行える。
+
+```bash
+npx claude-task-worker install
+```
+
+- `claude plugin marketplace add getty104/claude-task-worker` — マーケットプレイスの追加（追加済みの場合のエラーはログのみで無視して続行）
+- `claude plugin install claude-task-worker@claude-task-worker` — プラグインのインストール
+- `npm install -g claude-task-worker@latest` — CLI 本体のグローバルインストール（`npx` 実行時でも `claude-task-worker` コマンドを常設化する）
+
+インストール後、Claude Code のセッションを再起動するとプラグインが有効化される。
+
+#### 手動手順（代替）
+
+個別にインストールしたい場合は以下の手順でも良い。
+
+CLI（npm パッケージ）:
+
+```bash
+npm install -g claude-task-worker
+```
+
+開発版をローカルから使う場合:
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+Claude Code プラグイン（このリポジトリを Claude Code マーケットプレイスとして追加し、プラグインをインストールする）:
+
+```bash
+claude plugin marketplace add getty104/claude-task-worker
+claude plugin install claude-task-worker@claude-task-worker
+```
+
+インストール後、Claude Code のセッションを再起動するとプラグインが有効化される。
+
+#### 更新
+
+CLI とプラグイン（マーケットプレイス）をまとめて更新する。
+
+```bash
+claude-task-worker update
+```
+
+- `claude plugin marketplace update claude-task-worker` — マーケットプレイスの更新
+- `claude plugin update claude-task-worker@claude-task-worker` — プラグインの更新（反映にはセッション再起動が必要）
+- `npm install -g claude-task-worker@latest` — CLI 本体の更新
+
+### 初期化
+
+対象リポジトリで実行すると、必要なGitHubラベル・Issueテンプレート・GitHub Actionsワークフロー・設定ファイルが作成される。既存ファイルは保護され、`--force` を指定すると上書きされる。
+
+```bash
+claude-task-worker init           # 既存ファイルは保護
+claude-task-worker init --force   # 既存ファイルを強制上書き
+```
+
+作成されるラベル:
+
+| ラベル名 | 用途 |
+|---------|------|
+| `cc-update-issue` | Issue更新トリガー |
+| `cc-answer-issue-questions` | Issue確認事項への回答トリガー |
+| `cc-exec-issue` | Issue実行トリガー |
+| `cc-fix-onetime` | PR修正トリガー（1回） |
+| `cc-triage-scope` | トリアージ対象マーク（Issue/PR） |
+| `cc-resolve-conflict` | PRコンフリクト解消トリガー |
+| `cc-in-progress` | 処理中ステータス |
+| `cc-need-human-check` | 人間の確認が必要なマーク（付与中はIssueワーカーの処理対象から除外される） |
+| `cc-issue-created` | `/claude-task-worker:create-issue` 由来のIssueマーク（triage-created-issue のトリガー条件） |
+| `cc-pr-created` | PR作成完了マーク |
+| `cc-epic-issue` | エピックIssueマーク（サブIssueが全Closeで `epic-issue` ワーカーが起動） |
+
+作成されるファイル:
+
+- `.github/ISSUE_TEMPLATE/cc-triage-scope.yml` — `cc-triage-scope` ラベル付きIssue作成用テンプレート
+- `.github/workflows/assign-creator-on-cc-triage-scope.yml` — Issue作成者を自動アサインするワークフロー
+- `claude-task-worker.json` — 設定ファイル（コマンド実行ディレクトリ直下）
+
+## コマンド
+
+```bash
+claude-task-worker <command> [--epic <issue-number>]... [--label <label-name>]...
+```
+
+### `--epic <issue-number>` オプション
+
+`all` / `yolo` および Issue 系の各ワーカー（`exec-issue` / `create-issue` / `update-issue` / `answer-issue-questions` / `triage-created-issue` / `epic-issue`）で、指定したエピックIssueのサブIssueのみを処理対象に絞り込む。エピック単位でロールアウトしたいときに使用する。
+
+複数指定可能で、複数指定した場合はいずれかのエピックを親に持つサブIssueが対象になる（OR）。
+
+> ℹ️ `epic-issue` ワーカーはエピックIssue自体を処理対象とするため、`--epic` で指定した番号は「サブIssueの親」ではなく「エピックIssue自身の番号」として照合される。`--epic 100` を指定した場合、Epic PR が作成されるのは #100 のみになる。
+
+```bash
+claude-task-worker all --epic 100
+claude-task-worker all --epic 100 --epic 200    # #100 または #200 の sub-issue
+```
+
+### `--label <label-name>` オプション
+
+`all` / `yolo` および Issue 系の各ワーカーで、トリガーラベルに加えて指定したラベルが付いているIssueのみを処理対象に絞り込む。優先度・スプリント・スコープ等で対象を限定したいときに使用する。
+
+複数指定可能で、複数指定した場合は指定したすべてのラベルが付いているIssueが対象になる（AND）。`--epic` と併用すれば両条件のANDで絞り込まれる。
+
+```bash
+claude-task-worker all --label priority-high
+claude-task-worker all --label priority-high --label needs-design   # 両方付いている Issue のみ
+claude-task-worker yolo --epic 100 --epic 200 --label priority-high
+```
+
+> ℹ️ `--label` で指定したラベルはユーザーのスコープ指定なので、タスク完了時にワーカー側で除去されることはない（トリガーラベルだけが除去される）。
+
+### exec-issue
+
+`cc-exec-issue` ラベルが付いた自分にアサインされたIssueを定期取得し、Claude Codeで処理を実行する。（デフォルト1分間隔）
+
+- `cc-in-progress` ラベルを付与
+- `/claude-task-worker:exec-issue <issue番号>` を非同期で実行
+- 親Issueがある場合は `cc-epic-<親Issue番号>` ブランチから worktree を切って実行
+- 完了後、`cc-exec-issue` ラベルを除去し、`cc-pr-created` ラベルを付与
+
+### fix-review-point
+
+`cc-fix-onetime` ラベルが付いたPRを定期取得し、Claude Codeで修正を実行する。（1分間隔）
+
+- CI完了済みで `cc-in-progress` がないPRが対象
+- 完了後、設定ファイルに `fixReviewPointCallbackCommentMessage` が設定されていればPRにコメント投稿
+
+### create-issue
+
+`cc-triage-scope` ラベルが付いており、かつ Open な blockedBy Issue を持たないIssueを定期取得し、Claude CodeでIssue作成を実行する。（1分間隔）
+
+`init` コマンドで作成されるIssueテンプレートを使えば、`cc-triage-scope` ラベル付与と作成者アサインが自動で行われる。ブロック中の依存 Issue が残っている間はワーカーが拾わず、依存がすべて Close された時点で処理が開始される。
+
+除外ラベル: `cc-issue-created` / `cc-pr-created` / `cc-update-issue` / `cc-answer-issue-questions` / `cc-exec-issue` のいずれかが付いている Issue は対象外。
+
+### update-issue
+
+`cc-update-issue` ラベルが付いたIssueを定期取得し、最新コメントの依頼内容に基づいてClaude CodeでIssue更新を実行する。（1分間隔）
+
+### answer-issue-questions
+
+`cc-answer-issue-questions` ラベルが付いたIssueを定期取得し、Issueに記載された確認事項への回答をClaude Codeで生成する。（1分間隔）
+
+- 完了後、`cc-update-issue` ラベルを付与して update-issue ワーカーに引き継ぎ
+
+### triage-created-issue
+
+`cc-issue-created` と `cc-triage-scope` の両方のラベルが付いたIssueを定期取得し、Claude Codeでトリアージを実行する。（1分間隔）
+
+- `cc-pr-created` / `cc-update-issue` / `cc-answer-issue-questions` / `cc-exec-issue` のいずれかが付いているIssueは除外
+- 確認事項の有無に応じて `cc-answer-issue-questions` または `cc-exec-issue` ラベルを付与（または不要ならクローズ）
+
+### triage-pr
+
+`cc-triage-scope` ラベルが付いたPRを定期取得し、Claude Codeでトリアージを実行する。（1分間隔）
+
+- `cc-fix-onetime` が付いているPRは除外
+- `cc-resolve-conflict` が付いているPRは除外
+
+### resolve-conflict
+
+`cc-resolve-conflict` ラベルが付いたPRを定期取得し、`/claude-task-worker:resolve-conflict` を実行してコンフリクト解消を行う。（1分間隔）
+
+- 完了後、`cc-resolve-conflict` ラベルを除去
+
+### check-dependabot
+
+`dependencies` ラベルが付いたDependabot PRを定期取得し、依存ライブラリのバージョンアップ内容を確認する。（1時間間隔）
+
+- `cc-triage-scope` が付いているPRは除外
+- 完了後、`cc-triage-scope` ラベルを付与して triage-pr ワーカーに引き継ぎ
+
+### epic-issue
+
+`cc-epic-issue` ラベルが付いた親Issueを定期取得し、紐づくサブIssueがすべて Close されたタイミングで `/claude-task-worker:create-epic-pr` を起動してエピックPRを作成する。（デフォルト5分間隔）
+
+- `cc-pr-created` が付いているIssueは除外
+- サブIssueが存在しない、または1つでも未Closeのものがあればスキップ
+- 完了後、`cc-pr-created` ラベルを付与
+
+### all
+
+通常ワーカー7つ（exec-issue, fix-review-point, create-issue, update-issue, answer-issue-questions, resolve-conflict, epic-issue）を同時にポーリングする。`--epic` / `--label` オプションでIssue系ワーカーの処理対象を絞り込み可能（どちらも複数指定可）。
+
+### yolo
+
+すべてのワーカー（`all` + triage-created-issue + triage-pr + check-dependabot）を同時にポーリングする。`--epic` / `--label` オプションでIssue系ワーカーの処理対象を絞り込み可能（どちらも複数指定可）。
+
+### usage
+
+現在のClaude API使用状況をSlackに通知する。
+
+### install
+
+`claude-task-worker` マーケットプレイスの追加・プラグインのインストール・CLI本体のグローバルインストールを一括で行う。
+
+```bash
+npx claude-task-worker install
+```
+
+- `claude plugin marketplace add getty104/claude-task-worker` — マーケットプレイスの追加（追加済みの場合のエラーはログのみで無視して続行）
+- `claude plugin install claude-task-worker@claude-task-worker` — プラグインのインストール
+- `npm install -g claude-task-worker@latest` — CLI 本体のグローバルインストール
+
+いずれかのステップが失敗しても処理は継続し、`[install]` プレフィックス付きでエラー内容がログ出力される。
+
+### update
+
+`claude-task-worker` プラグイン/マーケットプレイスとCLI本体を更新する。
+
+```bash
+claude-task-worker update
+```
+
+- `claude plugin marketplace update claude-task-worker` — マーケットプレイスの更新
+- `claude plugin update claude-task-worker@claude-task-worker` — プラグインの更新（反映にはセッション再起動が必要）
+- `npm install -g claude-task-worker@latest` — CLI 本体の更新
+
+いずれかのステップが失敗しても処理は継続し、`[update]` プレフィックス付きでエラー内容がログ出力される。
+
+## 設定ファイル
+
+コマンドを実行したディレクトリ直下の `claude-task-worker.json` を読み込む。
+
+| キー | 型 | デフォルト | 説明 |
+|---|---|---|---|
+| `fixReviewPointCallbackCommentMessage` | string | - | fix-review-point 完了時にPRへ投稿するコメント（未設定の場合は投稿しない） |
+| `workers` | object | `{}` | ワーカーごとに Claude CLI に渡すスキル、`--model` / `--effort`、ポーリング間隔、クールダウン時間、最大同時実行数を上書きする設定（詳細は下記） |
+
+### ワーカーごとの設定
+
+`workers` キーにワーカー名ごとの設定オブジェクトを指定することで、Claude CLI の `-p` に渡すスキル（スラッシュコマンド）、`--model` / `--effort`、ポーリング間隔、タスク完了後のクールダウン時間、最大同時実行数を個別に上書きできる。未指定のワーカー・フィールドは下記のワーカー別デフォルト値が使用される。
+
+| ワーカー名 | デフォルト `skill` | デフォルト `model` | デフォルト `effort` | デフォルト `pollingIntervalSeconds` | デフォルト `cooldownSeconds` | デフォルト `maxConcurrentTasks` |
+|---|---|---|---|---|---|---|
+| `answer-issue-questions` | `/claude-task-worker:answer-issue-questions` | `opus` | `xhigh` | 60 | 0 | 1 |
+| `create-issue` | `/claude-task-worker:create-issue-from-issue-number` | `opus` | `xhigh` | 60 | 0 | 1 |
+| `update-issue` | `/claude-task-worker:update-issue` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `exec-issue` | `/claude-task-worker:exec-issue` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `fix-review-point` | `/claude-task-worker:fix-review-point` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `triage-created-issue` | `/claude-task-worker:triage-created-issue` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `triage-pr` | `/claude-task-worker:triage-pr` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `resolve-conflict` | `/claude-task-worker:resolve-pr-conflict` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `check-dependabot` | `/claude-task-worker:check-dependabot` | `sonnet` | `xhigh` | 3600 | 0 | 1 |
+| `epic-issue` | `/claude-task-worker:create-epic-pr` | `sonnet` | `xhigh` | 300 | 0 | 1 |
+
+各フィールドの値:
+
+| フィールド | 型 | 説明 |
+|---|---|---|
+| `skill` | string | Claude CLI の `-p` に渡すスラッシュコマンド（例: `/claude-task-worker:exec-issue`, `/my-plugin:my-skill`）。ワーカーは `"<skill> <issue-or-pr-number>"` の形で Claude を起動する |
+| `model` | string | Claude CLI の `--model` に渡す値（例: `sonnet`, `opus`, `haiku`） |
+| `effort` | string | Claude CLI の `--effort` に渡す値（例: `high`, `medium`, `low`） |
+| `pollingIntervalSeconds` | number | GitHub をポーリングする間隔（秒）。正の数を指定する |
+| `cooldownSeconds` | number | タスク完了後に次のポーリングを停止する時間（秒）。`0` でクールダウンなし |
+| `maxConcurrentTasks` | number | そのワーカーが同時に実行できるタスクの最大数。正の整数を指定する |
+
+設定例:
+
+```json
+{
+  "workers": {
+    "exec-issue":        { "skill": "/my-plugin:exec-issue", "model": "opus", "effort": "high", "pollingIntervalSeconds": 60, "cooldownSeconds": 600, "maxConcurrentTasks": 3 },
+    "fix-review-point":  { "skill": "/claude-task-worker:fix-review-point", "model": "sonnet", "effort": "high", "maxConcurrentTasks": 2 },
+    "triage-pr":         { "effort": "medium", "pollingIntervalSeconds": 120 },
+    "check-dependabot":  { "model": "haiku", "pollingIntervalSeconds": 7200 }
+  }
+}
+```
+
+> 💡 **推奨:** 重い実装タスク（`exec-issue`, `fix-review-point`）では `/advisor` を有効にすることを推奨する。事前/事後に強力なレビューモデルへ相談することで、アプローチの誤りや見落としを早期に検出でき、完了率と品質が向上する。各ワーカーが呼び出すスキルのプロンプト内で `advisor` ツールを活用する運用を推奨。
+
+## Slack通知
+
+環境変数 `CLAUDE_TASK_WORKER_SLACK_WEBHOOK_URL` にSlack Incoming Webhook URLを設定すると、各ワーカーのタスク完了時・失敗時にSlackへ通知が送信される。
+
+```bash
+export CLAUDE_TASK_WORKER_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/yyy/zzz
+claude-task-worker all
+```
+
+通知にはClaude APIの使用状況（5時間/7日間の利用率とリセット時刻）も含まれる。未設定の場合、通知は送信されない。
+
+## プロセス管理
+
+実行中のタスクはリアルタイムのステータステーブルで表示される。
+
+- タスクID・タイトル・ステータス（running/completed/failed）・開始時刻・経過時間を表示
+- 同一Issue/PRの重複実行を自動防止
+- SIGTERM/SIGINTで全子プロセスをgraceful shutdown
+
+## 開発
+
+```bash
+npm install
+npm run build    # TypeScript → dist/
+npm run dev      # Watch mode (auto-rebuild)
+```
+
+コントリビューションを歓迎します。開発環境のセットアップ・PRの出し方は [CONTRIBUTING.md](./CONTRIBUTING.md) を参照してください。バグ報告・機能要望は [Issue テンプレート](https://github.com/getty104/claude-task-worker/issues/new/choose) から作成してください。
+
+セキュリティ上の脆弱性は公開Issueではなく [SECURITY.md](./SECURITY.md) の手順で報告してください。
+
+本プロジェクトへの参加にあたっては [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)（Contributor Covenant）を遵守してください。
+
+## ライセンス
+
+MIT License. 詳細は [LICENSE](./LICENSE) を参照してください。

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function init(): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,84 @@
+import { mkdir, writeFile, access } from "node:fs/promises";
+import { createLabel } from "../gh.js";
+const LABELS = [
+    { name: "cc-create-issue", color: "0075ca" },
+    { name: "cc-update-issue", color: "e4e669" },
+    { name: "cc-exec-issue", color: "7057ff" },
+    { name: "cc-fix-onetime", color: "d93f0b" },
+    { name: "cc-fix-repeat", color: "b60205" },
+    { name: "cc-in-progress", color: "0e8a16" },
+    { name: "cc-issue-created", color: "f9a825" },
+    { name: "cc-pr-created", color: "006b75" },
+    { name: "cc-triage-scope", color: "c5def5" },
+];
+const ISSUE_TEMPLATE = `name: "[claude-task-worker] Issue作成依頼"
+description: claude-task-workerでGitHub Issueを作成する
+title: "[claude-task-worker] Issue作成依頼"
+labels:
+  - cc-create-issue
+body:
+  - type: textarea
+    id: request
+    attributes:
+      label: 依頼内容
+      description: 作成してほしいIssueの内容を記述してください
+    validations:
+      required: true
+`;
+const ASSIGN_CREATOR_WORKFLOW = `name: Assign creator on cc-create-issue
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  assign:
+    if: contains(github.event.issue.labels.*.name, 'cc-create-issue')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.addAssignees({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              assignees: [context.payload.issue.user.login]
+            });
+`;
+async function createFileIfNotExists(path, content) {
+    try {
+        await access(path);
+        return false;
+    }
+    catch {
+        await writeFile(path, content, "utf-8");
+        return true;
+    }
+}
+export async function init() {
+    console.log("[init] Creating labels...");
+    for (const label of LABELS) {
+        const ok = await createLabel(label.name, label.color, true);
+        if (ok) {
+            console.log(`[init] Ensured label: ${label.name}`);
+        }
+        else {
+            console.log(`[init] Failed to create label: ${label.name}`);
+        }
+    }
+    console.log("[init] Creating issue template...");
+    await mkdir(".github/ISSUE_TEMPLATE", { recursive: true });
+    const templatePath = ".github/ISSUE_TEMPLATE/cc-create-issue.yml";
+    const templateCreated = await createFileIfNotExists(templatePath, ISSUE_TEMPLATE);
+    console.log(templateCreated ? `[init] Created: ${templatePath}` : `[init] Already exists: ${templatePath}`);
+    console.log("[init] Creating GitHub Actions workflow...");
+    await mkdir(".github/workflows", { recursive: true });
+    const workflowPath = ".github/workflows/assign-creator-on-cc-create-issue.yml";
+    const workflowCreated = await createFileIfNotExists(workflowPath, ASSIGN_CREATOR_WORKFLOW);
+    console.log(workflowCreated ? `[init] Created: ${workflowPath}` : `[init] Already exists: ${workflowPath}`);
+    console.log("[init] Done.");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/gh.d.ts

@@ -0,0 +1,47 @@
+interface Issue {
+    number: number;
+    title: string;
+    labels: {
+        name: string;
+    }[];
+    body: string;
+    state: string;
+}
+interface PullRequest {
+    number: number;
+    headRefName: string;
+    labels: {
+        name: string;
+    }[];
+    title: string;
+}
+interface RepoInfo {
+    owner: string;
+    name: string;
+    defaultBranch: string;
+}
+export declare function getCurrentUser(): Promise<string>;
+export declare function getRepoInfo(): Promise<RepoInfo>;
+export declare function listIssues(assignee: string, label: string): Promise<Issue[]>;
+export declare function listAllIssues(assignee: string): Promise<Issue[]>;
+interface StatusCheck {
+    __typename: string;
+    status?: string;
+    state?: string;
+}
+interface PullRequestWithChecks extends PullRequest {
+    statusCheckRollup: StatusCheck[];
+}
+export declare function isCICompleted(checks: StatusCheck[]): boolean;
+export declare function listPullRequestsWithChecks(assignee?: string, options?: {
+    triageScope?: boolean;
+}): Promise<PullRequestWithChecks[]>;
+export declare function addLabel(type: "issue" | "pr", number: number, label: string): Promise<void>;
+export declare function removeLabel(type: "issue" | "pr", number: number, label: string): Promise<void>;
+export declare function getLastIssueComment(issueNumber: number): Promise<{
+    author: string;
+    body: string;
+} | null>;
+export declare function commentOnIssue(issueNumber: number, body: string): Promise<void>;
+export declare function createLabel(name: string, color?: string, force?: boolean): Promise<boolean>;
+export {};

package/dist/gh.js

@@ -0,0 +1,113 @@
+import { execFile } from "node:child_process";
+function execGh(args) {
+    return new Promise((resolve, reject) => {
+        execFile("gh", args, (error, stdout, stderr) => {
+            if (error) {
+                reject(new Error(`gh ${args.join(" ")} failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+export async function getCurrentUser() {
+    return execGh(["api", "user", "--jq", ".login"]);
+}
+export async function getRepoInfo() {
+    const output = await execGh(["repo", "view", "--json", "owner,name,defaultBranchRef"]);
+    const parsed = JSON.parse(output);
+    return { owner: parsed.owner.login, name: parsed.name, defaultBranch: parsed.defaultBranchRef.name };
+}
+export async function listIssues(assignee, label) {
+    const output = await execGh([
+        "issue", "list",
+        "--assignee", assignee,
+        "--label", label,
+        "--json", "number,title,labels",
+        "--limit", "100",
+    ]);
+    return JSON.parse(output);
+}
+export async function listAllIssues(assignee) {
+    const output = await execGh([
+        "issue", "list",
+        "--assignee", assignee,
+        "--label", "cc-triage-scope",
+        "--search", "sort:created-asc",
+        "--json", "number,title,labels",
+        "--limit", "5",
+    ]);
+    return JSON.parse(output);
+}
+export function isCICompleted(checks) {
+    if (checks.length === 0)
+        return true;
+    return checks.every(check => {
+        if (check.__typename === "CheckRun") {
+            return check.status === "COMPLETED";
+        }
+        return check.state !== "PENDING";
+    });
+}
+export async function listPullRequestsWithChecks(assignee, options) {
+    const args = [
+        "pr", "list",
+        "--json", "number,headRefName,labels,title,statusCheckRollup",
+        "--limit", "100",
+    ];
+    if (options?.triageScope) {
+        args.push("--label", "cc-triage-scope");
+    }
+    if (assignee) {
+        args.push("--assignee", assignee);
+    }
+    const output = await execGh(args);
+    return JSON.parse(output);
+}
+async function withRetry(fn, maxRetries = 3, delayMs = 1000) {
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (attempt === maxRetries)
+                throw err;
+            console.error(`[gh] Attempt ${attempt}/${maxRetries} failed, retrying in ${delayMs}ms...`);
+            await new Promise(resolve => setTimeout(resolve, delayMs));
+        }
+    }
+    throw new Error("unreachable");
+}
+export async function addLabel(type, number, label) {
+    await withRetry(() => execGh([type, "edit", String(number), "--add-label", label]));
+}
+export async function removeLabel(type, number, label) {
+    await withRetry(() => execGh([type, "edit", String(number), "--remove-label", label]));
+}
+export async function getLastIssueComment(issueNumber) {
+    const output = await execGh(["issue", "view", String(issueNumber), "--json", "comments"]);
+    const parsed = JSON.parse(output);
+    const comments = parsed.comments ?? [];
+    if (comments.length === 0)
+        return null;
+    const last = comments[comments.length - 1];
+    return { author: last.author.login, body: last.body };
+}
+export async function commentOnIssue(issueNumber, body) {
+    await execGh(["issue", "comment", String(issueNumber), "--body", body]);
+}
+export async function createLabel(name, color, force) {
+    try {
+        const args = ["label", "create", name];
+        if (color)
+            args.push("--color", color);
+        if (force)
+            args.push("--force");
+        await execGh(args);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=gh.js.map