claude-task-worker 0.98.0 → 0.100.0

package/README.md

@@ -55,8 +55,8 @@ CLI が GitHub ラベルを検知してタスクを起動し、プラグイン
 |---|---|
 | `plugin/skills/` | ワーカーが呼ぶスキル群と、対話セッション用の補助スキル（`commit-push` / `create-pr` / `breakdown-issues` / `edit-pencil-design` など） |
 | `plugin/agents/` | サブエージェント定義（`explore-agent` / `frontend-implementer` / `general-purpose-assistant` / `lightweight-assistant` / `pencil-design-updater` / `requirement-todo-organizer`） |
-| `plugin/hooks/` | `SessionStart`（worktree セットアップ / `git fetch --prune`）と `UserPromptSubmit`（`codegraph prompt-hook`）のフック定義 |
-| `plugin/scripts/` | フック・スキルから呼ばれるスクリプト（`setup-worktree.sh` / `stop-servers.mjs` / `resolve-pr-comments.sh` — `resolve-pr-comments` スキルが GitHub MCP を使えない場合の `gh` フォールバック） |
+| `plugin/hooks/` | `SessionStart`（worktree セットアップ / CodeGraph インデックス構築（クラウドのみ） / `git fetch --prune`）と `UserPromptSubmit`（`codegraph prompt-hook`）のフック定義 |
+| `plugin/scripts/` | フック・スキルから呼ばれるスクリプト（`setup-worktree.sh` / `setup-codegraph.sh` / `stop-servers.mjs` / `resolve-pr-comments.sh` — `resolve-pr-comments` スキルが GitHub MCP を使えない場合の `gh` フォールバック） |
 | `plugin/references/` | 複数スキルが共有する参照ドキュメント（GitHub アクセス方針など） |
 | `plugin/.mcp.json` | MCP サーバー定義（`codegraph` / `context7` / `next-devtools` / `shadcn` / `playwright`） |
 
@@ -98,7 +98,16 @@ claude plugin install claude-task-worker@claude-task-worker
 
 herdr が必要な場合は `curl -fsSL https://herdr.dev/install.sh | sh` または `brew install herdr`（[ドキュメント](https://herdr.dev/docs/install/)）。
 
-クラウド実行（`--cloud` フラグ）を使う場合は、クラウド VM（Claude Code on the web）側にもプラグイン・CLI が必要になる。claude.ai の環境設定（Environment setup script / セットアップスクリプト欄）に `npx claude-task-worker install` を直接記載しておく。あわせて、クラウドセッションが push / PR 作成を行うには対象リポジトリの GitHub App 連携が必要。
+クラウド実行（`--cloud` フラグ）を使う場合は、クラウド VM（Claude Code on the web）側にもプラグイン・CLI が必要になる。claude.ai の環境設定（Environment setup script / セットアップスクリプト欄）に次の2行を記載しておく。
+
+```bash
+npx claude-task-worker install
+npx claude-task-worker cloud-setup
+```
+
+`cloud-setup` は VM 側の `~/.claude/settings.json` に権限モード（`permissions.defaultMode: "auto"`）・出力スタイル（`outputStyle: "Proactive"`）・言語（`language: "Japanese"`）を書き込み、あわせてグローバル gitignore へ `.codegraph/` を登録する（CodeGraph のインデックス構築自体はプラグインの `SessionStart` フックが毎セッション行う）。クラウドセッションは起動フラグの `--permission-mode` を受理するだけで反映しないため、この設定ファイルが権限モードを指定する唯一の経路になる（設定しないと「編集を受け入れる」で動く）。書き込みはキー単位のマージで、既存の設定は消さない。
+
+あわせて、クラウドセッションが push / PR 作成を行うには対象リポジトリの GitHub App 連携が必要。
 
 UIデザイン先行ワークフローを使う場合は、同じ claude.ai の環境設定の環境変数欄に `PEN_CLI_KEY` も設定する。`.pen` を扱うスキル（`edit-pencil-design` / `inspect-pencil-node` / `resolve-pencil-conflict`）の Pen CLI 認証に使うもので、クラウド VM では対話ログインができないため。キーの発行元と値の形式は後述の「[Pen CLI のログイン](#pen-cli-のログイン)」を参照。
 
@@ -189,6 +198,7 @@ claude-task-worker <command> [--epic <issue-number>]... [--label <label>]... [--
 | `yolo` | 全ワーカーを同時にポーリング（`all` + `triage-created-issue` + `triage-pr` + `check-dependabot`） |
 | `init` | ラベル・テンプレート・設定ファイルの作成と CodeGraph セットアップ |
 | `install` / `update` | 上記「セットアップ」を参照 |
+| `cloud-setup [--force]` | クラウドセッションの VM を準備する（`~/.claude/settings.json` に権限モード・出力スタイル・言語を書き込み、グローバル gitignore へ `.codegraph/` を登録する）。claude.ai の環境設定のセットアップスクリプト欄から `install` の後に呼ぶ想定。既存のキーは上書きしない（`--force` で上書き） |
 | `usage` | Claude API 使用状況（5時間/7日間の利用率とリセット時刻）を表示し、Slack にも通知 |
 | `version` | CLI のバージョンを表示（`--version` / `-v` も可） |
 
@@ -261,7 +271,7 @@ claude-task-worker all --cloud
 - `config.json` の `mode` が `"herdr"` であること。新しいクラウドセッションの作成には TTY が必要で、`"default"` の子プロセス実行では作れない。`mode` が `"herdr"` でないのに `--cloud` を付けた場合は**タスクを1件も起動せずエラー終了する**（`"default"` へフォールバックしない）
 - claude.ai アカウントでのサインインが必須。API キー認証（`ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN`）・第三者プロバイダ（Bedrock / Vertex）・カスタムエンドポイント構成では利用できない。この検査（`claude auth status --json` の実行）は `--cloud` を指定したときだけ行う
 - 対象リポジトリの GitHub App 連携（クラウド VM から push / PR 作成を行うため）
-- claude.ai の環境設定のセットアップスクリプト欄に `npx claude-task-worker install` を記載してプラグイン・CLI を導入しておくこと（手順は「[インストール](#インストール)」参照）
+- claude.ai の環境設定のセットアップスクリプト欄に `npx claude-task-worker install` と `npx claude-task-worker cloud-setup` をこの順で記載しておくこと。前者でプラグイン・CLI を導入し、後者で VM 側の `~/.claude/settings.json`（権限モード・出力スタイル・言語）の書き込みとグローバル gitignore への `.codegraph/` 登録を行う（手順は「[インストール](#インストール)」参照）
 - UIデザイン先行ワークフローを使う場合のみ、claude.ai の環境設定の環境変数欄に `PEN_CLI_KEY`（pen.dev の組織設定 > Developer Keys で発行）を設定しておくこと。`.pen` を扱う3スキルの Pen CLI 認証に使う（「[Pen CLI のログイン](#pen-cli-のログイン)」参照）
 
 上記のうち静的検査されるのは1〜2番目だけで、GitHub App 連携・クラウド VM 側の導入状況・環境変数の設定はローカルから確認できないため検査されない。

package/dist/index.js

@@ -1635,7 +1635,7 @@ import { readFileSync, writeFileSync } from "node:fs";
 import { isAbsolute, join, normalize, sep as SEP } from "node:path";
 
 // src/dispatch-args.ts
-var FLAG_INCOMPATIBLE_COMMANDS = ["init", "install", "update", "usage", "version"];
+var FLAG_INCOMPATIBLE_COMMANDS = ["init", "install", "update", "cloud-setup", "usage", "version"];
 function collectFlagValues(argv, flag) {
   const values = [];
   for (let i = 0; i < argv.length; i++) {
@@ -5089,6 +5089,78 @@ async function install() {
   console.log("[install] Done.");
 }
 
+// src/commands/cloud-setup.ts
+import { mkdir as mkdir3, writeFile as writeFile3, readFile as readFile2 } from "node:fs/promises";
+import { homedir as homedir6 } from "node:os";
+import { join as join8 } from "node:path";
+var LOG_PREFIX = "cloud-setup";
+var CLOUD_DEFAULT_PERMISSION_MODE = "auto";
+var CLOUD_SETTINGS_DEFAULTS = {
+  outputStyle: "Proactive",
+  language: "Japanese"
+};
+function claudeSettingsPath() {
+  const dir = process.env.CLAUDE_CONFIG_DIR;
+  return join8(dir && dir.length > 0 ? dir : join8(homedir6(), ".claude"), "settings.json");
+}
+function withCloudDefaults(existing, force) {
+  const parsed = existing === null ? {} : JSON.parse(existing);
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("not a JSON object");
+  }
+  const settings = { ...parsed };
+  const current = settings["permissions"] ?? {};
+  if (typeof current !== "object" || current === null || Array.isArray(current)) {
+    throw new Error("`permissions` is not an object");
+  }
+  const permissions = { ...current };
+  let changed = false;
+  const set = (target, key, value) => {
+    if (key in target && !force) return;
+    if (target[key] === value) return;
+    target[key] = value;
+    changed = true;
+  };
+  set(permissions, "defaultMode", CLOUD_DEFAULT_PERMISSION_MODE);
+  for (const [key, value] of Object.entries(CLOUD_SETTINGS_DEFAULTS)) set(settings, key, value);
+  if (!changed) return null;
+  return `${JSON.stringify({ ...settings, permissions }, null, 2)}
+`;
+}
+async function writeClaudeSettings(force) {
+  const path2 = claudeSettingsPath();
+  let existing;
+  try {
+    existing = await readFile2(path2, "utf-8");
+  } catch {
+    existing = null;
+  }
+  let next;
+  try {
+    next = withCloudDefaults(existing, force);
+  } catch (e) {
+    console.log(`[${LOG_PREFIX}] Skipped: ${path2} (${e instanceof Error ? e.message : String(e)})`);
+    return;
+  }
+  if (next === null) {
+    console.log(`[${LOG_PREFIX}] Already set: ${path2}`);
+    return;
+  }
+  try {
+    await mkdir3(join8(path2, ".."), { recursive: true });
+    await writeFile3(path2, next, "utf-8");
+  } catch (e) {
+    console.log(`[${LOG_PREFIX}] Failed to write ${path2}: ${e instanceof Error ? e.message : String(e)}`);
+    return;
+  }
+  console.log(`[${LOG_PREFIX}] ${existing === null ? "Created" : "Updated"}: ${path2}`);
+}
+async function cloudSetup(options = {}) {
+  await writeClaudeSettings(options.force ?? false);
+  await ensureCodegraphGitIgnore(LOG_PREFIX);
+  console.log(`[${LOG_PREFIX}] Done.`);
+}
+
 // src/commands/update.ts
 init_run_command();
 var PLUGIN_NAME2 = "claude-task-worker";
@@ -5144,14 +5216,14 @@ async function update() {
 
 // src/commands/version.ts
 import { readFileSync as readFileSync5 } from "node:fs";
-import { dirname as dirname3, join as join8 } from "node:path";
+import { dirname as dirname3, join as join9 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { styleText } from "node:util";
 var REGISTRY_URL = "https://registry.npmjs.org/claude-task-worker/latest";
 var FETCH_TIMEOUT_MS = 3e3;
 function localVersion() {
   const here = dirname3(fileURLToPath(import.meta.url));
-  const pkgPath = join8(here, "..", "package.json");
+  const pkgPath = join9(here, "..", "package.json");
   const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
   return pkg.version ?? "unknown";
 }
@@ -5217,6 +5289,7 @@ Commands:
   init [--force]  Create required GitHub labels and config file (use --force to overwrite existing files)
   install           Add the claude-task-worker marketplace, install the plugin, and install/update the CLI
   update            Update the claude-task-worker plugin/marketplace and the CLI itself
+  cloud-setup [--force]  Prepare a cloud session VM (writes permission mode, output style, and language into ~/.claude/settings.json). Meant for a cloud environment setup script
   usage             Notify current usage to Slack
   version           Print the installed claude-task-worker CLI version (aliases: --version, -v)
 
@@ -5267,7 +5340,7 @@ if (!workerType) {
   printUsage();
   process.exit(1);
 }
-if (workerType !== "all" && workerType !== "yolo" && workerType !== "init" && workerType !== "install" && workerType !== "update" && workerType !== "usage" && !WORKERS[workerType]) {
+if (workerType !== "all" && workerType !== "yolo" && workerType !== "init" && workerType !== "install" && workerType !== "update" && workerType !== "cloud-setup" && workerType !== "usage" && !WORKERS[workerType]) {
   console.error(`Unknown command: ${workerType}`);
   printUsage();
   process.exit(1);
@@ -5452,6 +5525,10 @@ if (hasProjectFilter()) {
   (async () => {
     await update();
   })();
+} else if (workerType === "cloud-setup") {
+  (async () => {
+    await cloudSetup({ force: process.argv.slice(3).includes("--force") });
+  })();
 } else if (workerType === "usage") {
   (async () => {
     const text = await buildTokenLimitText();

package/package.json

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