candy-debug 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ryome
+
+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

@@ -1,3 +1,74 @@
-# Temporary Holding Version
+# candy-debug
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+ロキシーがあなたのコードをレビューして、ノベルゲーム用の台本（JSON）を作る CLI です。
+
+フォルダを渡すと、ローカルの [Claude Code](https://www.npmjs.com/package/@anthropic-ai/claude-code)（`claude` コマンド）が
+コードを読み、指摘をロキシーの台詞にまとめます。出てきた JSON は candy-debug のクライアントアプリで、
+音声つきのノベルとして再生できます。
+
+## 必要なもの
+
+- Node.js 20 以上
+- ログイン済みの `claude` コマンド（`npm install -g @anthropic-ai/claude-code`）
+
+## インストール
+
+```sh
+npm install -g candy-debug
+candy-debug --doctor   # claude が使えるかを確かめる
+```
+
+`cdbg` という短縮名でも同じコマンドを呼べます（`cdbg ./my-project -o review.json`）。
+
+## 使い方
+
+```sh
+# 結果をファイルに書き出す
+candy-debug ./my-project -o review.json
+
+# 標準出力に JSON を出す（進捗は標準エラー）
+candy-debug ./my-project > review.json
+
+# AI を呼ばずに、対象になるファイルだけを確かめる
+candy-debug ./my-project --scan-only
+```
+
+| オプション              | 内容                                                  |
+| ----------------------- | ----------------------------------------------------- |
+| `-o, --output <file>`   | 結果の JSON を書き出すファイル（省略時は標準出力）    |
+| `--max-findings <n>`    | 指摘の最大件数（既定 6）                              |
+| `--model <id>`          | レビューに使うモデル（既定 `claude-sonnet-5`）        |
+| `--scenario-model <id>` | 台本づくりに使うモデル（既定は `--model` と同じ）     |
+| `--claude <command>`    | `claude` コマンドの場所                               |
+| `--progress <mode>`     | 進捗の出し方: `text` / `json` / `none`（既定 `text`） |
+| `--scan-only`           | 走査結果だけを JSON で出す                            |
+| `--doctor [--json]`     | `claude` の疎通確認                                   |
+
+終了コード: `0` 成功 / `1` 失敗 / `2` 引数の誤り / `130` 中断
+
+## 注意
+
+- **対象のコードは `claude` コマンドを通じて Anthropic のサーバへ送られます。** 送ってよいコードかを確かめてから実行してください。
+- 対象フォルダへは一切書き込みません（`-o` で明示した場所にだけ書きます）。
+- 1 回の実行で `claude` を数回呼びます。目安は指摘 6 件で約 3 分・約 $0.3 です（2026-09-09 実測）。
+
+## 出力の形
+
+```jsonc
+{
+  "format": "candy-debug/review",
+  "schemaVersion": 1,
+  "generator": { "name": "candy-debug", "version": "1.0.0" },
+  "project": { "name": "my-project", "dir": "/path/to/my-project" },
+  "findings": [/* 指摘 */],
+  "scenario": { "beats": [/* 台詞・表情・コード片・赤枠の位置 */] },
+  "warnings": [],
+  "costUsd": 0.29,
+}
+```
+
+コード片は台本に埋め込まれているので、再生する側は対象プロジェクトを持っていなくても構いません。
+
+## ライセンス
+
+MIT

package/dist/candy-debug.mjs

@@ -0,0 +1,1061 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { parseArgs } from "node:util";
+
+// package.json
+var package_default = {
+  name: "candy-debug",
+  version: "1.0.0",
+  description: "\u30ED\u30AD\u30B7\u30FC\u304C\u30B3\u30FC\u30C9\u30EC\u30D3\u30E5\u30FC\u3092\u3057\u3066\u3001\u30CE\u30D9\u30EB\u30B2\u30FC\u30E0\u7528\u306E\u53F0\u672C\uFF08JSON\uFF09\u3092\u4F5C\u308B CLI",
+  type: "module",
+  bin: {
+    "candy-debug": "dist/candy-debug.mjs",
+    cdbg: "dist/candy-debug.mjs"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  engines: {
+    node: ">=20"
+  },
+  scripts: {
+    build: 'esbuild src/index.ts --bundle --platform=node --format=esm --target=node20 --loader:.csv=text --banner:js="#!/usr/bin/env node" --outfile=dist/candy-debug.mjs --log-level=warning',
+    prepublishOnly: "npm run build"
+  },
+  keywords: [
+    "code-review",
+    "claude",
+    "cli",
+    "visual-novel"
+  ],
+  author: "ryome",
+  license: "MIT"
+};
+
+// src/ai/claudeCli.ts
+import { spawn } from "node:child_process";
+function describeSpawnError(command, e) {
+  const code = e?.code;
+  const raw = e instanceof Error ? e.message : String(e);
+  switch (code) {
+    case "ENOENT":
+      return `\`${command}\` \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3067\u3057\u305F\u3002Claude Code \u3092\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3057\u3001PATH \u306B\u542B\u307E\u308C\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\uFF08${raw}\uFF09`;
+    case "ENOEXEC":
+      return `\`${command}\` \u306F\u898B\u3064\u304B\u308A\u307E\u3057\u305F\u304C\u3001\u5B9F\u884C\u3067\u304D\u308B\u5F62\u5F0F\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002Claude Code \u306E\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u304C\u58CA\u308C\u3066\u3044\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002\u30BF\u30FC\u30DF\u30CA\u30EB\u3067 \`${command} --version\` \u3092\u5B9F\u884C\u3057\u3066\u72B6\u6CC1\u3092\u78BA\u304B\u3081\u3001\u5165\u308C\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\uFF08npm \u3067\u5165\u308C\u305F\u5834\u5408: npm install -g @anthropic-ai/claude-code\uFF09\uFF08${raw}\uFF09`;
+    case "EACCES":
+      return `\`${command}\` \u306B\u5B9F\u884C\u306E\u6A29\u9650\u304C\u3042\u308A\u307E\u305B\u3093\u3002Claude Code \u3092\u5165\u308C\u76F4\u3059\u304B\u3001\u5B9F\u884C\u6A29\u9650\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\uFF08${raw}\uFF09`;
+    default:
+      return `\`${command}\` \u3092\u8D77\u52D5\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF08${raw}\uFF09`;
+  }
+}
+var DEFAULT_TIMEOUT_MS = 10 * 60 * 1e3;
+var ClaudeCliProvider = class {
+  id = "claude-cli";
+  displayName = "Claude\uFF08\u30ED\u30FC\u30AB\u30EB\u306E claude \u30B3\u30DE\u30F3\u30C9\uFF09";
+  command;
+  model;
+  scenarioModel;
+  timeoutMs;
+  constructor(opts = {}) {
+    this.command = opts.command ?? "claude";
+    this.model = opts.model ?? "claude-sonnet-5";
+    this.scenarioModel = opts.scenarioModel ?? this.model;
+    this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  }
+  /** 子プロセスを起動し、stdin にプロンプトを流して stdout を集める */
+  run(args, stdin, timeoutMs, signal) {
+    return new Promise((resolve2, reject) => {
+      let child;
+      try {
+        child = spawn(this.command, args, { stdio: ["pipe", "pipe", "pipe"] });
+      } catch (e) {
+        reject(new Error(describeSpawnError(this.command, e)));
+        return;
+      }
+      let stdout = "";
+      let stderr = "";
+      let settled = false;
+      const finish = (fn) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", onAbort);
+        fn();
+      };
+      const timer = setTimeout(() => {
+        child.kill("SIGTERM");
+        finish(
+          () => reject(new Error(`AI \u306E\u5FDC\u7B54\u304C ${Math.round(timeoutMs / 1e3)} \u79D2\u4EE5\u5185\u306B\u8FD4\u308A\u307E\u305B\u3093\u3067\u3057\u305F`))
+        );
+      }, timeoutMs);
+      const onAbort = () => {
+        child.kill("SIGTERM");
+        finish(() => reject(new Error("\u4E2D\u65AD\u3057\u307E\u3057\u305F")));
+      };
+      signal?.addEventListener("abort", onAbort, { once: true });
+      child.stdout.on("data", (d) => stdout += d.toString());
+      child.stderr.on("data", (d) => stderr += d.toString());
+      child.on("error", (e) => {
+        finish(() => reject(new Error(describeSpawnError(this.command, e))));
+      });
+      child.on("close", (code) => finish(() => resolve2({ code, stdout, stderr })));
+      child.stdin.write(stdin);
+      child.stdin.end();
+    });
+  }
+  async ping(signal) {
+    try {
+      const r = await this.run(["--version"], "", 15e3, signal);
+      if (r.code !== 0) return { ok: false, detail: r.stderr.trim() || `\u7D42\u4E86\u30B3\u30FC\u30C9 ${r.code}` };
+      return { ok: true, detail: `${r.stdout.trim()} / \u30E2\u30C7\u30EB ${this.model}` };
+    } catch (e) {
+      return { ok: false, detail: e instanceof Error ? e.message : String(e) };
+    }
+  }
+  async complete(req, signal) {
+    const model = req.purpose === "scenario" ? this.scenarioModel : this.model;
+    const started = Date.now();
+    const r = await this.run(
+      [
+        "-p",
+        "--output-format",
+        "json",
+        // ツールは全て無効化する。コードはプロンプトで渡すので読ませる必要がない
+        "--allowed-tools",
+        "",
+        "--model",
+        model,
+        "--append-system-prompt",
+        req.system
+      ],
+      req.user,
+      this.timeoutMs,
+      signal
+    );
+    if (r.code !== 0) {
+      const head = r.stderr.trim().split("\n")[0] ?? "";
+      throw new Error(
+        `AI \u306E\u547C\u3073\u51FA\u3057\u306B\u5931\u6557\u3057\u307E\u3057\u305F\uFF08\u7D42\u4E86\u30B3\u30FC\u30C9 ${r.code}\uFF09${head ? `: ${head}` : ""}`
+      );
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(r.stdout);
+    } catch {
+      throw new Error("AI \u306E\u5FDC\u7B54\u3092\u89E3\u91C8\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF08JSON \u3068\u3057\u3066\u8AAD\u3081\u306A\u3044\uFF09");
+    }
+    if (parsed.is_error) throw new Error("AI \u304C\u30A8\u30E9\u30FC\u3092\u8FD4\u3057\u307E\u3057\u305F");
+    if (typeof parsed.result !== "string") throw new Error("AI \u306E\u5FDC\u7B54\u306B\u672C\u6587\u304C\u542B\u307E\u308C\u3066\u3044\u307E\u305B\u3093");
+    return {
+      text: parsed.result,
+      usage: {
+        inputTokens: (parsed.usage?.input_tokens ?? 0) + (parsed.usage?.cache_read_input_tokens ?? 0) + (parsed.usage?.cache_creation_input_tokens ?? 0),
+        outputTokens: parsed.usage?.output_tokens,
+        costUsd: parsed.total_cost_usd
+      },
+      elapsedMs: Date.now() - started
+    };
+  }
+};
+
+// ../doc/csv/characters.csv
+var characters_default = 'character_id,name_ja,description,persona,tone,sample_lines,voice_engine,voice_speaker,voice_params,sprite_dir,status,notes\nchar_main,\u30ED\u30AD\u30B7\u30FC,\u8A9E\u308A\u624B\u3002\u9752\u3044\u4E09\u3064\u7DE8\u307F\u3068\u30B8\u30C8\u76EE\u306E\u9B54\u8853\u5E2B\u98A8\u3002\u6C34\u738B\u7D1A\u306E\u9B54\u8853\u5E2B\u306B\u3057\u3066\u30D7\u30ED\u30B0\u30E9\u30DF\u30F3\u30B0\u306E\u8B1B\u5E2B\u3068\u3044\u3046\u8AAD\u307F\u66FF\u3048,\u6709\u80FD\u3067\u4E01\u5BE7\u3001\u3067\u3082\u3069\u3053\u304B\u629C\u3051\u3066\u3044\u308B\u30AF\u30FC\u30EB\u306A\u30C9\u30B8\u3063\u5B50\u3002\u793C\u5100\u6B63\u3057\u3044\u52AA\u529B\u5BB6\u3067\u3001\u7406\u77E5\u7684\u306B\u843D\u3061\u7740\u3044\u3066\u8AAC\u660E\u3059\u308B\u6559\u5E2B\u3002\u5DEE\u5225\u3068\u5B64\u72EC\u3092\u7D4C\u9A13\u3057\u3066\u304D\u305F\u3076\u3093\u3001\u76F8\u624B\u3092\u898B\u4E0B\u3055\u305A\u3001\u66F8\u3044\u305F\u4EBA\u3092\u5426\u5B9A\u3057\u306A\u3044\u3002\u751F\u5F92\u3092\u5B89\u5FC3\u3055\u305B\u308B\u58F0\u304B\u3051\u3092\u3059\u308B\uFF08\u300C\u5927\u4E08\u592B\u3067\u3059\u3088\u3001\u9806\u756A\u306B\u898B\u3066\u3044\u304D\u307E\u3057\u3087\u3046\u300D\uFF09\u3002\u305F\u3060\u3057\u7269\u4E8B\u3092\u6700\u901F\u3067\u7D42\u308F\u3089\u305B\u3088\u3046\u3068\u3059\u308B\u6027\u8CEA\u304C\u707D\u3044\u3057\u3066\u3001\u809D\u5FC3\u306A\u3068\u3053\u308D\u3067\u9593\u306E\u60AA\u3044\u5931\u6557\u3092\u3059\u308B\u3002\u52D5\u63FA\u3057\u305F\u308A\u7167\u308C\u305F\u308A\u3059\u308B\u3068\u9014\u7AEF\u306B\u3057\u3069\u308D\u3082\u3069\u308D\u306B\u306A\u308B\u3002\u826F\u3044\u3068\u3053\u308D\u306F\u7D20\u76F4\u306B\u8912\u3081\u308B\u3002\u65AD\u5B9A\u3067\u304D\u306A\u3044\u3053\u3068\u306F\u65AD\u5B9A\u3057\u306A\u3044\u3002,\u4E00\u8CAB\u3057\u3066\u4E01\u5BE7\u8A9E\uFF08\u656C\u8A9E\uFF09\u3067\u8A71\u3059\u3002\u4E00\u4EBA\u79F0\u306F\u300C\u79C1\u300D\u3002\u3053\u308C\u306F\u5805\u82E6\u3057\u3055\u3067\u306F\u306A\u304F\u3001\u76F8\u624B\u3092\u4E0D\u5FEB\u306B\u3055\u305B\u306A\u3044\u305F\u3081\u306B\u610F\u8B58\u7684\u306B\u9078\u3093\u3067\u3044\u308B\u8A71\u3057\u65B9\u3002\u666E\u6BB5\u306F\u843D\u3061\u7740\u3044\u305F\u6559\u5E2B\u3089\u3057\u3044\u7406\u77E5\u7684\u306A\u53E3\u8ABF\u3002\u52D5\u63FA\u30FB\u7167\u308C\u30FB\u5931\u6557\u306E\u3068\u304D\u3060\u3051\u5D29\u308C\u3066\u3001\u3057\u3069\u308D\u3082\u3069\u308D\u306B\u306A\u308B\u3002\u7815\u3051\u305F\u8A9E\u5C3E\uFF08\u300C\u301C\u3060\u306D\u300D\u300C\u301C\u304B\u306A\u300D\u300C\u301C\u3060\u3088\u300D\uFF09\u306F\u4F7F\u308F\u306A\u3044\u3002,\u3053\u3053\u3001\u53D7\u3051\u53D6\u3063\u305F\u5024\u3092\u305D\u306E\u307E\u307E\u6587\u5B57\u5217\u306B\u6DF7\u305C\u3066\u3044\u307E\u3059\u306D\u3002\u5916\u304B\u3089\u6765\u305F\u6587\u5B57\u304C\u547D\u4EE4\u3068\u3057\u3066\u89E3\u91C8\u3055\u308C\u3066\u3057\u307E\u3044\u307E\u3059\u3002|\u5927\u4E08\u592B\u3067\u3059\u3088\u3002\u76F4\u3057\u65B9\u306F\u305D\u308C\u307B\u3069\u96E3\u3057\u304F\u3042\u308A\u307E\u305B\u3093\u304B\u3089\u3001\u9806\u756A\u306B\u898B\u3066\u3044\u304D\u307E\u3057\u3087\u3046\u3002|\u2026\u2026\u3042\u3063\u3001\u3059\u307F\u307E\u305B\u3093\u3002\u4ECA\u306E\u306F\u79C1\u306E\u52D8\u9055\u3044\u3067\u3059\u3002\u3048\u3048\u3068\u3001\u3082\u3046\u4E00\u5EA6\u8AAC\u660E\u3055\u305B\u3066\u304F\u3060\u3055\u3044\u3002,irodori,char_main,"{""speed"":1.0,""seed"":1234}",assets/characters/char_main,\u8A2D\u5B9A\u6E08\u307F,\u8A2D\u5B9A\u306E\u51FA\u5178: input/\u30ED\u30AD\u30B7\u30FC\u30FB\u30DF\u30B0\u30EB\u30C7\u30A3\u30A2_\u30AD\u30E3\u30E9\u30AF\u30BF\u30FC\u5206\u6790.md\uFF082026-09-09 \u53CD\u6620\uFF09\u3002**tone \u306B\u8A18\u5165\u4F8B\u306E\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u304C\u6B8B\u3063\u3066\u3044\u3066\u3001\u305D\u308C\u304C\u305D\u306E\u307E\u307E\u53F0\u672C\u751F\u6210\u30D7\u30ED\u30F3\u30D7\u30C8\u3078\u6CE8\u5165\u3055\u308C\u3066\u3044\u305F**\uFF08\u8AB2\u984C AI-04\uFF09\u3002persona\u30FBtone\u30FBsample_lines \u306F\u30D7\u30ED\u30F3\u30D7\u30C8\u306B\u76F4\u63A5\u5165\u308B\u3002\u7279\u306B sample_lines \u306F\u53E3\u8ABF\u306E\u624B\u672C\u3068\u3057\u3066\u52B9\u679C\u304C\u5927\u304D\u3044\u3002voice_speaker \u306F Irodori-TTS \u306E voice_id \u3068\u4E00\u81F4\u3055\u305B\u308B\u3053\u3068\u3002\u53C2\u7167\u97F3\u58F0\u306F resources.csv \u306E voice_ref_char_main \u884C\uFF08\u8AB2\u984C AUDIO-07\uFF09\n';
+
+// src/character.ts
+var FALLBACK = {
+  characterId: "char_main",
+  nameJa: "\u30ED\u30AD\u30B7\u30FC",
+  persona: "\u6709\u80FD\u3067\u4E01\u5BE7\u3001\u3067\u3082\u3069\u3053\u304B\u629C\u3051\u3066\u3044\u308B\u30AF\u30FC\u30EB\u306A\u30C9\u30B8\u3063\u5B50\u3002\u7406\u77E5\u7684\u306B\u843D\u3061\u7740\u3044\u3066\u8AAC\u660E\u3059\u308B\u6559\u5E2B\u3002\u66F8\u3044\u305F\u4EBA\u3092\u5426\u5B9A\u3057\u306A\u3044\u3002\u65AD\u5B9A\u3067\u304D\u306A\u3044\u3053\u3068\u306F\u65AD\u5B9A\u3057\u306A\u3044\u3002",
+  tone: "\u4E00\u8CAB\u3057\u3066\u4E01\u5BE7\u8A9E\u3067\u8A71\u3059\u3002\u4E00\u4EBA\u79F0\u306F\u300C\u79C1\u300D\u3002\u7815\u3051\u305F\u8A9E\u5C3E\u306F\u4F7F\u308F\u306A\u3044\u3002",
+  sampleLines: [
+    "\u3053\u3053\u3001\u53D7\u3051\u53D6\u3063\u305F\u5024\u3092\u305D\u306E\u307E\u307E\u6587\u5B57\u5217\u306B\u6DF7\u305C\u3066\u3044\u307E\u3059\u306D\u3002",
+    "\u5927\u4E08\u592B\u3067\u3059\u3088\u3002\u9806\u756A\u306B\u898B\u3066\u3044\u304D\u307E\u3057\u3087\u3046\u3002",
+    "\u2026\u2026\u3042\u3063\u3001\u3059\u307F\u307E\u305B\u3093\u3002\u4ECA\u306E\u306F\u79C1\u306E\u52D8\u9055\u3044\u3067\u3059\u3002"
+  ]
+};
+function splitCsvLine(line) {
+  const out = [];
+  let cur = "";
+  let q = false;
+  for (let i = 0; i < line.length; i++) {
+    const c = line[i];
+    if (c === '"') {
+      if (q && line[i + 1] === '"') {
+        cur += '"';
+        i++;
+      } else q = !q;
+    } else if (c === "," && !q) {
+      out.push(cur);
+      cur = "";
+    } else cur += c;
+  }
+  out.push(cur);
+  return out;
+}
+function parseCharacterCsv(csv, characterId) {
+  try {
+    const [header, ...rows] = csv.trim().split("\n");
+    if (!header || rows.length === 0) return FALLBACK;
+    const h = splitCsvLine(header);
+    const parsed = rows.map(splitCsvLine);
+    const r = (characterId ? parsed.find((x) => x[h.indexOf("character_id")] === characterId) : null) ?? parsed[0];
+    const get = (k) => r[h.indexOf(k)] ?? "";
+    return {
+      characterId: get("character_id") || FALLBACK.characterId,
+      nameJa: get("name_ja") || FALLBACK.nameJa,
+      persona: get("persona") || FALLBACK.persona,
+      tone: get("tone") || FALLBACK.tone,
+      sampleLines: (get("sample_lines") || FALLBACK.sampleLines.join("|")).split("|").filter(Boolean)
+    };
+  } catch {
+    return FALLBACK;
+  }
+}
+function defaultCharacter() {
+  return parseCharacterCsv(characters_default);
+}
+
+// src/scenario/types.ts
+var EMOTIONS = [
+  "normal",
+  "serious",
+  "thinking",
+  "proud",
+  "exasperated",
+  "flustered",
+  "sulking"
+];
+var MAX_TEXT_LENGTH = 100;
+function validateScenario(s) {
+  const issues = [];
+  const beats = s.beats.map((b) => {
+    const fixed = { ...b };
+    if (!EMOTIONS.includes(fixed.emotion)) {
+      issues.push({ beatId: b.id, message: `\u672A\u77E5\u306E\u8868\u60C5 "${b.emotion}" \u2192 normal \u3067\u4EE3\u66FF` });
+      fixed.emotion = "normal";
+    }
+    if ([...fixed.text].length > MAX_TEXT_LENGTH) {
+      issues.push({
+        beatId: b.id,
+        message: `\u53F0\u8A5E\u304C ${[...fixed.text].length} \u6587\u5B57\uFF08\u4E0A\u9650 ${MAX_TEXT_LENGTH}\uFF09\u2192 \u672B\u5C3E\u3092\u5207\u308B`
+      });
+      fixed.text = [...fixed.text].slice(0, MAX_TEXT_LENGTH - 1).join("") + "\u2026";
+    }
+    return fixed;
+  });
+  return { scenario: { ...s, beats }, issues };
+}
+
+// src/contract.ts
+var REVIEW_FILE_FORMAT = "candy-debug/review";
+var REVIEW_FILE_VERSION = 1;
+function summarizeScan(r) {
+  return {
+    projectDir: r.projectDir,
+    projectName: r.projectName,
+    fileCount: r.files.length,
+    files: r.files.map((f) => ({ relPath: f.relPath, lines: f.lines, language: f.language })),
+    excludedCount: r.excludedCount,
+    totalLines: r.totalLines,
+    estimatedTokens: r.estimatedTokens,
+    languageBreakdown: r.languageBreakdown,
+    warnings: r.warnings
+  };
+}
+
+// src/ai/types.ts
+function extractJson(text) {
+  const tryParse = (s) => {
+    try {
+      return JSON.parse(s);
+    } catch {
+      return null;
+    }
+  };
+  const direct = tryParse(text.trim());
+  if (direct !== null) return direct;
+  const fence = text.match(/```(?:json)?\s*\n([\s\S]*?)\n?```/);
+  if (fence) {
+    const inner = tryParse(fence[1].trim());
+    if (inner !== null) return inner;
+  }
+  for (const [open, close] of [
+    ["{", "}"],
+    ["[", "]"]
+  ]) {
+    const from = text.indexOf(open);
+    const to = text.lastIndexOf(close);
+    if (from >= 0 && to > from) {
+      const cut = tryParse(text.slice(from, to + 1));
+      if (cut !== null) return cut;
+    }
+  }
+  return null;
+}
+
+// src/review/scanner.ts
+import { promises as fs } from "node:fs";
+import { join, relative, sep } from "node:path";
+var ALWAYS_EXCLUDE_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "out",
+  "build",
+  ".next",
+  ".cache",
+  "vendor",
+  "__pycache__",
+  ".venv",
+  "venv",
+  "coverage",
+  ".idea",
+  ".vscode"
+]);
+var DEFAULT_EXTENSIONS = [
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  ".py",
+  ".go",
+  ".rb",
+  ".rs",
+  ".java",
+  ".kt",
+  ".swift",
+  ".c",
+  ".h",
+  ".cpp",
+  ".cs",
+  ".php",
+  ".css",
+  ".scss",
+  ".vue",
+  ".svelte"
+];
+var LANG_BY_EXT = {
+  ".ts": "typescript",
+  ".tsx": "tsx",
+  ".js": "javascript",
+  ".jsx": "jsx",
+  ".mjs": "javascript",
+  ".cjs": "javascript",
+  ".py": "python",
+  ".json": "json",
+  ".css": "css",
+  ".scss": "css",
+  ".html": "html"
+};
+function languageOf(relPath) {
+  const dot = relPath.lastIndexOf(".");
+  if (dot < 0) return "typescript";
+  return LANG_BY_EXT[relPath.slice(dot).toLowerCase()] ?? "typescript";
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 3);
+}
+async function scanProject(dir, opts = {}) {
+  const exts = new Set(opts.includeExtensions ?? DEFAULT_EXTENSIONS);
+  const maxFileLines = opts.maxFileLines ?? 1500;
+  const maxFiles = opts.maxFiles ?? 40;
+  const files = [];
+  const warnings = [];
+  let excludedCount = 0;
+  async function walk(cur) {
+    let entries;
+    try {
+      entries = await fs.readdir(cur, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (files.length >= maxFiles) return;
+      const full = join(cur, e.name);
+      if (e.isDirectory()) {
+        if (ALWAYS_EXCLUDE_DIRS.has(e.name) || e.name.startsWith(".")) {
+          excludedCount++;
+          continue;
+        }
+        await walk(full);
+        continue;
+      }
+      if (!e.isFile()) continue;
+      const dot = e.name.lastIndexOf(".");
+      const ext = dot >= 0 ? e.name.slice(dot).toLowerCase() : "";
+      if (!exts.has(ext)) {
+        excludedCount++;
+        continue;
+      }
+      let content;
+      try {
+        content = await fs.readFile(full, "utf8");
+      } catch {
+        excludedCount++;
+        continue;
+      }
+      const lines = content.split("\n").length;
+      if (lines > maxFileLines) {
+        warnings.push(`${e.name} \u306F ${lines} \u884C\u3042\u308B\u305F\u3081\u5BFE\u8C61\u304B\u3089\u5916\u3057\u307E\u3057\u305F`);
+        excludedCount++;
+        continue;
+      }
+      files.push({
+        relPath: relative(dir, full).split(sep).join("/"),
+        language: languageOf(e.name),
+        lines,
+        bytes: Buffer.byteLength(content, "utf8"),
+        content
+      });
+    }
+  }
+  await walk(dir);
+  files.sort((a, b) => a.relPath.localeCompare(b.relPath));
+  const languageBreakdown = {};
+  for (const f of files) languageBreakdown[f.language] = (languageBreakdown[f.language] ?? 0) + 1;
+  const projectName = dir.split(sep).filter(Boolean).pop() ?? dir;
+  return {
+    projectDir: dir,
+    projectName,
+    files,
+    excludedCount,
+    totalLines: files.reduce((n, f) => n + f.lines, 0),
+    estimatedTokens: files.reduce((n, f) => n + estimateTokens(f.content), 0),
+    languageBreakdown,
+    warnings
+  };
+}
+
+// src/review/chunker.ts
+var TAB_WIDTH = 2;
+function expandTabs(text) {
+  return text.replace(/\t/g, " ".repeat(TAB_WIDTH));
+}
+function makeChunks(files, maxTokens = 24e3) {
+  const chunks = [];
+  let cur = [];
+  let curTokens = 0;
+  for (const f of files) {
+    const t = estimateTokens(f.content);
+    if (cur.length > 0 && curTokens + t > maxTokens) {
+      chunks.push({ files: cur, estimatedTokens: curTokens });
+      cur = [];
+      curTokens = 0;
+    }
+    cur.push(f);
+    curTokens += t;
+  }
+  if (cur.length > 0) chunks.push({ files: cur, estimatedTokens: curTokens });
+  return chunks;
+}
+function formatFile(f) {
+  const code = expandTabs(f.content);
+  const lines = code.split("\n");
+  const width = String(lines.length).length;
+  const body = lines.map((l, i) => `${String(i + 1).padStart(width)} | ${l}`).join("\n");
+  return `=== ${f.relPath} (${f.language}) ===
+${body}`;
+}
+function formatChunk(chunk) {
+  return chunk.files.map(formatFile).join("\n\n");
+}
+
+// src/review/findings.ts
+var SEVERITIES = ["critical", "warning", "info", "praise"];
+var CONFIDENCES = ["high", "medium", "low"];
+function asString(v) {
+  return typeof v === "string" && v.trim().length > 0 ? v.trim() : null;
+}
+function asInt(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  return Number.isFinite(n) ? Math.round(n) : null;
+}
+function validateFindings(raw, files, idFrom = 1) {
+  const discarded = [];
+  if (!Array.isArray(raw)) {
+    return { findings: [], discarded: [{ reason: "\u914D\u5217\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3067\u3057\u305F" }] };
+  }
+  const byPath = new Map(files.map((f) => [f.relPath, f]));
+  const findings = [];
+  let seq = idFrom;
+  for (const item of raw) {
+    if (typeof item !== "object" || item === null) {
+      discarded.push({ reason: "\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3067\u306F\u306A\u3044\u8981\u7D20" });
+      continue;
+    }
+    const o = item;
+    const title = asString(o.title);
+    const problem = asString(o.problem);
+    const fileRaw = asString(o.file);
+    if (!title || !problem || !fileRaw) {
+      discarded.push({ reason: "title / problem / file \u306E\u3044\u305A\u308C\u304B\u304C\u7121\u3044" });
+      continue;
+    }
+    const file = byPath.get(fileRaw)?.relPath ?? files.find((f) => f.relPath.endsWith(fileRaw) || fileRaw.endsWith(f.relPath))?.relPath;
+    if (!file) {
+      discarded.push({ reason: `\u5B58\u5728\u3057\u306A\u3044\u30D5\u30A1\u30A4\u30EB: ${fileRaw}` });
+      continue;
+    }
+    const target = byPath.get(file);
+    const lineCount = expandTabs(target.content).split("\n").length;
+    const startLine = asInt(o.startLine);
+    if (startLine === null || startLine < 1 || startLine > lineCount) {
+      discarded.push({ reason: `${file} \u306E\u884C\u756A\u53F7\u304C\u7BC4\u56F2\u5916: ${String(o.startLine)}` });
+      continue;
+    }
+    let endLine = asInt(o.endLine) ?? startLine;
+    if (endLine < startLine) endLine = startLine;
+    if (endLine > lineCount) endLine = lineCount;
+    const severity = SEVERITIES.includes(o.severity) ? o.severity : "info";
+    const confidence = CONFIDENCES.includes(o.confidence) ? o.confidence : "medium";
+    findings.push({
+      id: `F-${String(seq++).padStart(3, "0")}`,
+      severity,
+      category: asString(o.category) ?? "\u305D\u306E\u4ED6",
+      title,
+      file,
+      startLine,
+      endLine,
+      problem,
+      suggestion: asString(o.suggestion) ?? "",
+      highlightText: asString(o.highlightText) ?? void 0,
+      improvedCode: asString(o.improvedCode) ?? void 0,
+      confidence
+    });
+  }
+  return { findings, discarded };
+}
+function prioritize(findings, max) {
+  const order = { critical: 0, warning: 1, info: 2, praise: 3 };
+  const sorted = [...findings].sort((a, b) => order[a.severity] - order[b.severity]);
+  const praise = sorted.filter((f) => f.severity === "praise");
+  const rest = sorted.filter((f) => f.severity !== "praise");
+  const keepPraise = praise.slice(0, 1);
+  const keepRest = rest.slice(0, Math.max(0, max - keepPraise.length));
+  return [...keepRest, ...keepPraise];
+}
+
+// src/review/prompts.ts
+var REVIEW_SYSTEM = `\u3042\u306A\u305F\u306F\u7D4C\u9A13\u8C4A\u5BCC\u306A\u30B3\u30FC\u30C9\u30EC\u30D3\u30E5\u30A2\u30FC\u3067\u3059\u3002\u65E5\u672C\u8A9E\u3067\u56DE\u7B54\u3057\u307E\u3059\u3002
+
+# \u51FA\u529B\u5F62\u5F0F
+JSON \u914D\u5217\u306E\u307F\u3092\u51FA\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u524D\u7F6E\u304D\u30FB\u5F8C\u66F8\u304D\u30FB\u30DE\u30FC\u30AF\u30C0\u30A6\u30F3\u306E\u30B3\u30FC\u30C9\u30D5\u30A7\u30F3\u30B9\u3092\u66F8\u3044\u3066\u306F\u3044\u3051\u307E\u305B\u3093\u3002
+
+\u5404\u8981\u7D20\u306E\u5F62\u5F0F:
+{
+  "severity": "critical" | "warning" | "info" | "praise",
+  "category": "\u30D0\u30B0" | "\u5B89\u5168\u6027" | "\u53EF\u8AAD\u6027" | "\u8A2D\u8A08" | "\u6027\u80FD" | "\u898F\u7D04" \u306E\u3044\u305A\u308C\u304B,
+  "title": "\u4E00\u884C\u8981\u7D04\uFF0840\u5B57\u4EE5\u5185\uFF09",
+  "file": "\u5165\u529B\u3067\u4E0E\u3048\u3089\u308C\u305F\u30D5\u30A1\u30A4\u30EB\u30D1\u30B9\u3068\u5B8C\u5168\u306B\u4E00\u81F4\u3059\u308B\u6587\u5B57\u5217",
+  "startLine": \u6307\u6458\u5BFE\u8C61\u306E\u958B\u59CB\u884C\u756A\u53F7\uFF08\u5165\u529B\u306B\u4ED8\u3044\u3066\u3044\u308B\u884C\u756A\u53F7\u3092\u305D\u306E\u307E\u307E\u4F7F\u3046\uFF09,
+  "endLine": \u6307\u6458\u5BFE\u8C61\u306E\u7D42\u4E86\u884C\u756A\u53F7,
+  "highlightText": "\u305D\u306E\u884C\u306B\u5B9F\u5728\u3059\u308B\u90E8\u5206\u6587\u5B57\u5217\u3002\u67A0\u3067\u56F2\u3093\u3067\u793A\u3059\u306E\u306B\u4F7F\u3046",
+  "problem": "\u4F55\u304C\u554F\u984C\u304B\u30022\u301C3\u6587",
+  "suggestion": "\u3069\u3046\u76F4\u3059\u304B\u30022\u301C3\u6587",
+  "improvedCode": "\u6539\u5584\u5F8C\u306E\u30B3\u30FC\u30C9\uFF08startLine\u301CendLine \u306E\u7BC4\u56F2\u3076\u3093\u3060\u3051\uFF09\u3002\u7121\u3051\u308C\u3070\u7701\u7565",
+  "confidence": "high" | "medium" | "low"
+}
+
+# \u5B88\u308B\u3053\u3068
+1. file \u306F\u5FC5\u305A\u5165\u529B\u3067\u4E0E\u3048\u305F\u30D5\u30A1\u30A4\u30EB\u30D1\u30B9\u306E\u3044\u305A\u308C\u304B\u3068\u5B8C\u5168\u4E00\u81F4\u3055\u305B\u308B\u3002\u63A8\u6E2C\u3067\u66F8\u304B\u306A\u3044\u3002
+2. startLine / endLine \u306F\u5165\u529B\u306B\u4ED8\u3044\u3066\u3044\u308B\u884C\u756A\u53F7\u3092\u305D\u306E\u307E\u307E\u4F7F\u3046\u3002\u6570\u3048\u76F4\u3055\u306A\u3044\u3002
+3. highlightText \u306F\u305D\u306E\u884C\u306B**\u5B9F\u5728\u3059\u308B\u6587\u5B57\u5217**\u306B\u3059\u308B\u3002\u5B58\u5728\u3057\u306A\u3044\u6587\u5B57\u5217\u3092\u66F8\u304B\u306A\u3044\u3002
+4. \u78BA\u4FE1\u304C\u6301\u3066\u306A\u3044\u3082\u306E\u306F confidence \u3092 "low" \u306B\u3059\u308B\u3002\u63A8\u6E2C\u3067\u65AD\u5B9A\u3057\u306A\u3044\u3002
+5. \u4E00\u822C\u8AD6\u3092\u66F8\u304B\u306A\u3044\u3002\u300C\u5909\u6570\u540D\u306F\u5206\u304B\u308A\u3084\u3059\u304F\u300D\u3067\u306F\u306A\u304F\u3001\u305D\u306E\u30B3\u30FC\u30C9\u306E\u5177\u4F53\u7684\u306A\u7B87\u6240\u3092\u6307\u3059\u3002
+6. **\u826F\u3044\u70B9\uFF08severity: "praise"\uFF09\u3092\u5FC5\u305A1\u4EF6\u4EE5\u4E0A\u542B\u3081\u308B\u3002**
+7. \u30AD\u30E3\u30E9\u30AF\u30BF\u30FC\u3092\u6F14\u3058\u306A\u3044\u3002\u3053\u3053\u3067\u306F\u4E8B\u5B9F\u3060\u3051\u3092\u3001\u7D20\u306E\u65E5\u672C\u8A9E\u3067\u66F8\u304F\u3002`;
+function reviewUserPrompt(formattedFiles, maxFindings) {
+  return `\u6B21\u306E\u30B3\u30FC\u30C9\u3092\u30EC\u30D3\u30E5\u30FC\u3057\u3001\u6307\u6458\u3092\u6700\u5927 ${maxFindings} \u4EF6\u3001JSON \u914D\u5217\u3067\u51FA\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+\u91CD\u8981\u306A\u3082\u306E\u3092\u512A\u5148\u3057\u3001\u4E9B\u7D30\u306A\u3082\u306E\u306F\u7701\u3044\u3066\u304F\u3060\u3055\u3044\u3002
+
+${formattedFiles}`;
+}
+function scenarioSystem(c) {
+  return `\u3042\u306A\u305F\u306F\u300C${c.nameJa}\u300D\u3068\u3044\u3046\u30AD\u30E3\u30E9\u30AF\u30BF\u30FC\u3068\u3057\u3066\u3001\u30B3\u30FC\u30C9\u30EC\u30D3\u30E5\u30FC\u306E\u5185\u5BB9\u3092\u8A9E\u308B\u53F0\u672C\u3092\u66F8\u304D\u307E\u3059\u3002
+
+# \u30AD\u30E3\u30E9\u30AF\u30BF\u30FC
+- \u540D\u524D: ${c.nameJa}
+- \u4EBA\u7269\u50CF: ${c.persona}
+- \u53E3\u8ABF: ${c.tone}
+- \u53E3\u8ABF\u306E\u4F8B:
+${c.sampleLines.map((l) => `  \u300C${l}\u300D`).join("\n")}
+
+# \u51FA\u529B\u5F62\u5F0F
+JSON \u914D\u5217\u306E\u307F\u3092\u51FA\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u524D\u7F6E\u304D\u30FB\u5F8C\u66F8\u304D\u30FB\u30B3\u30FC\u30C9\u30D5\u30A7\u30F3\u30B9\u3092\u66F8\u3044\u3066\u306F\u3044\u3051\u307E\u305B\u3093\u3002
+
+\u5404\u8981\u7D20\u306E\u5F62\u5F0F:
+{
+  "findingId": "\u5BFE\u8C61\u306E\u6307\u6458ID\uFF08\u30AA\u30FC\u30D7\u30CB\u30F3\u30B0\u3068\u30A8\u30F3\u30C7\u30A3\u30F3\u30B0\u306F\u7701\u7565\uFF09",
+  "role": "opening" | "present" | "problem" | "improve" | "summary" | "ending",
+  "text": "\u53F0\u8A5E",
+  "emotion": ${EMOTIONS.map((e) => `"${e}"`).join(" | ")}
+}
+
+# \u5B88\u308B\u3053\u3068
+1. **\u53F0\u8A5E\u306F\u5168\u89D2100\u6587\u5B57\u4EE5\u5185\u3002** 45\u301C80\u6587\u5B57\u304C\u6700\u3082\u8AAD\u307F\u3084\u3059\u3044\u3002\u6539\u884C\u306F \\n \u30671\u56DE\u307E\u3067\u3002
+2. \u4E0A\u8A18\u306E\u30AD\u30E3\u30E9\u30AF\u30BF\u30FC\u306E\u53E3\u8ABF\u3067\u66F8\u304F\u3002\u53E3\u8ABF\u306E\u4F8B\u306B\u5BC4\u305B\u308B\u3002
+3. **\u6280\u8853\u7684\u306A\u5185\u5BB9\u3092\u5909\u3048\u306A\u3044\u3002** \u6307\u6458\u306E\u610F\u5473\u306F\u5909\u3048\u305A\u3001\u8A00\u3044\u65B9\u3060\u3051\u3092\u30AD\u30E3\u30E9\u30AF\u30BF\u30FC\u306E\u3082\u306E\u306B\u3059\u308B\u3002
+4. emotion \u306F\u4E0A\u306B\u6319\u3052\u305F\u3082\u306E\u304B\u3089\u306E\u307F\u9078\u3076\u3002
+5. **\u53F0\u8A5E\u306B\u30D5\u30A1\u30A4\u30EB\u540D\u30FB\u884C\u756A\u53F7\u30FB\u8A18\u53F7\u3092\u66F8\u304B\u306A\u3044\u3002** \u97F3\u58F0\u3067\u8AAD\u307F\u4E0A\u3052\u308B\u305F\u3081\u3001
+   \u300C4\u884C\u76EE\u306E db.query \u304C\u300D\u306E\u3088\u3046\u306A\u66F8\u304D\u65B9\u3092\u3059\u308B\u3068\u805E\u304D\u82E6\u3057\u304F\u306A\u308B\u3002\u4F4D\u7F6E\u306F\u753B\u9762\u304C\u793A\u3059\u3002
+6. confidence \u304C low \u306E\u6307\u6458\u306F\u3001\u65AD\u5B9A\u3092\u907F\u3051\u305F\u8A00\u3044\u56DE\u3057\u306B\u3059\u308B\u3002
+
+# \u69CB\u6210
+- \u6700\u521D\u306B role="opening" \u30921\u3064\u3002\u5168\u4F53\u3067\u4F55\u4EF6\u898B\u3064\u304B\u3063\u305F\u304B\u3092\u4F1D\u3048\u308B\u3002
+- \u6307\u6458\u3054\u3068\u306B present \u2192 problem \u2192 improve \u2192 summary \u306E\u9806\u3067\u4E26\u3079\u308B\u3002
+  - severity \u304C "praise" \u306E\u6307\u6458\u306F problem \u3092\u4F5C\u3089\u306A\u3044\u3002
+  - improvedCode \u304C\u7121\u3044\u6307\u6458\u306F improve \u3092\u4F5C\u3089\u306A\u3044\u3002
+- \u6700\u5F8C\u306B role="ending" \u30921\u3064\u3002\u826F\u3044\u70B9\u306B\u89E6\u308C\u3066\u7D42\u3048\u308B\u3002
+
+# \u8868\u60C5\u306E\u4F7F\u3044\u5206\u3051
+- normal: \u63D0\u793A\uFF08present\uFF09
+- serious: \u91CD\u5927\u306A\u6307\u6458\uFF08critical\uFF09
+- exasperated: \u96D1\u306A\u30B3\u30FC\u30C9\u3078\u306E\u6307\u6458
+- thinking: \u6539\u5584\u6848\u306E\u63D0\u793A\uFF08improve\uFF09
+- proud: \u307E\u3068\u3081\u30FB\u826F\u3044\u70B9\u30FB\u30A8\u30F3\u30C7\u30A3\u30F3\u30B0
+- flustered: \u7279\u306B\u91CD\u5927\u306A\u767A\u898B
+- sulking: \u4F7F\u7528\u983B\u5EA6\u306F\u4F4E\u3044`;
+}
+function scenarioUserPrompt(findings) {
+  const counts = findings.reduce((acc, f) => {
+    acc[f.severity] = (acc[f.severity] ?? 0) + 1;
+    return acc;
+  }, {});
+  const list = findings.map(
+    (f) => [
+      `## ${f.id}\uFF08${f.severity} / ${f.category} / \u78BA\u4FE1\u5EA6 ${f.confidence}\uFF09`,
+      `\u898B\u51FA\u3057: ${f.title}`,
+      `\u554F\u984C: ${f.problem}`,
+      f.suggestion ? `\u6539\u5584: ${f.suggestion}` : "",
+      f.improvedCode ? "\u6539\u5584\u5F8C\u306E\u30B3\u30FC\u30C9\u3042\u308A" : "\u6539\u5584\u5F8C\u306E\u30B3\u30FC\u30C9\u306A\u3057"
+    ].filter(Boolean).join("\n")
+  ).join("\n\n");
+  return `\u6B21\u306E\u30EC\u30D3\u30E5\u30FC\u7D50\u679C\u3092\u53F0\u672C\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+
+\u5168\u4F53: ${findings.length}\u4EF6\uFF08${Object.entries(counts).map(([k, v]) => `${k} ${v}`).join(" / ")}\uFF09
+
+${list}`;
+}
+
+// src/review/pipeline.ts
+var SNIPPET_PAD = 2;
+var SNIPPET_MAX_LINES = 12;
+function buildCodeDisplay(f, file, source) {
+  const all = expandTabs(file.content).split("\n");
+  let startLine = Math.max(1, f.startLine - SNIPPET_PAD);
+  let endLine = Math.min(all.length, f.endLine + SNIPPET_PAD);
+  if (endLine - startLine + 1 > SNIPPET_MAX_LINES) {
+    const center = Math.round((f.startLine + f.endLine) / 2);
+    startLine = Math.max(1, center - Math.floor(SNIPPET_MAX_LINES / 2));
+    endLine = Math.min(all.length, startLine + SNIPPET_MAX_LINES - 1);
+  }
+  const highlights = [];
+  if (source === "improved") {
+    if (!f.improvedCode) return null;
+    const code2 = expandTabs(f.improvedCode);
+    const lines = code2.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const t = lines[i];
+      if (t.trim().length === 0) continue;
+      const indent = t.length - t.trimStart().length;
+      highlights.push({
+        kind: "improvement",
+        startLine: startLine + i,
+        startColumn: indent + 1,
+        endLine: startLine + i,
+        endColumn: t.length + 1
+      });
+    }
+    return {
+      source,
+      snippet: { file: f.file, startLine, language: file.language, code: code2 },
+      // 行数が多いと枠だらけになるので、3 行までなら枠を出す
+      highlights: lines.length <= 3 ? highlights : []
+    };
+  }
+  const code = all.slice(startLine - 1, endLine).join("\n");
+  if (f.highlightText) {
+    const needle = expandTabs(f.highlightText);
+    for (let i = 0; i < endLine - startLine + 1; i++) {
+      const lineNo = startLine + i;
+      if (lineNo < f.startLine || lineNo > f.endLine) continue;
+      const at = all[lineNo - 1].indexOf(needle);
+      if (at < 0) continue;
+      highlights.push({
+        kind: "problem",
+        startLine: lineNo,
+        startColumn: at + 1,
+        endLine: lineNo,
+        endColumn: at + needle.length + 1
+      });
+      break;
+    }
+  }
+  if (highlights.length === 0) {
+    const t = all[f.startLine - 1] ?? "";
+    if (t.trim().length > 0) {
+      const indent = t.length - t.trimStart().length;
+      highlights.push({
+        kind: "problem",
+        startLine: f.startLine,
+        startColumn: indent + 1,
+        endLine: f.startLine,
+        endColumn: t.length + 1
+      });
+    }
+  }
+  return { source, snippet: { file: f.file, startLine, language: file.language, code }, highlights };
+}
+var ROLES = ["opening", "present", "problem", "improve", "summary", "ending"];
+function assembleScenario(raw, findings, files, characterId, speaker, projectName) {
+  const warnings = [];
+  const byId = new Map(findings.map((f) => [f.id, f]));
+  const byPath = new Map(files.map((f) => [f.relPath, f]));
+  const beats = [];
+  let seq = 1;
+  if (!Array.isArray(raw)) {
+    warnings.push("\u53F0\u672C\u304C\u914D\u5217\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3067\u3057\u305F");
+    return {
+      scenario: {
+        schemaVersion: 1,
+        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        characterId,
+        title: projectName,
+        beats: []
+      },
+      warnings
+    };
+  }
+  for (const item of raw) {
+    const text = typeof item.text === "string" ? item.text.trim() : "";
+    if (!text) {
+      warnings.push("\u672C\u6587\u304C\u7121\u3044\u30D3\u30FC\u30C8\u3092\u98DB\u3070\u3057\u307E\u3057\u305F");
+      continue;
+    }
+    const role = ROLES.includes(item.role) ? item.role : "present";
+    const emotion = EMOTIONS.includes(item.emotion) ? item.emotion : "normal";
+    const findingId = typeof item.findingId === "string" ? item.findingId : void 0;
+    const f = findingId ? byId.get(findingId) : void 0;
+    let stage = {};
+    if (role === "opening" || role === "ending") {
+      stage = { clearCode: true };
+    } else if (f) {
+      const file = byPath.get(f.file);
+      if (file) {
+        const src = role === "improve" ? "improved" : "original";
+        const disp = buildCodeDisplay(f, file, src);
+        if (disp) {
+          stage = {
+            code: role === "present" || role === "summary" ? { ...disp, highlights: [] } : disp
+          };
+        }
+      }
+    }
+    beats.push({
+      id: `B-${String(seq++).padStart(3, "0")}`,
+      findingId,
+      role,
+      speaker,
+      text,
+      emotion,
+      stage
+    });
+  }
+  const { scenario, issues } = validateScenario({
+    schemaVersion: 1,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    characterId,
+    title: projectName,
+    beats
+  });
+  for (const i of issues) warnings.push(`${i.beatId}: ${i.message}`);
+  return { scenario, warnings };
+}
+async function runReview(dir, ai, character, opts = {}) {
+  const maxFindings = opts.maxFindings ?? 8;
+  const report = (p) => opts.onProgress?.(p);
+  const warnings = [];
+  let costUsd = 0;
+  report({ phase: "scan", done: 0, total: 1, message: "\u5BFE\u8C61\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u6570\u3048\u3066\u3044\u307E\u3059" });
+  const scan = await scanProject(dir);
+  warnings.push(...scan.warnings);
+  if (scan.files.length === 0) {
+    throw new Error("\u30EC\u30D3\u30E5\u30FC\u3067\u304D\u308B\u30BD\u30FC\u30B9\u30B3\u30FC\u30C9\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3067\u3057\u305F");
+  }
+  const chunks = makeChunks(scan.files, opts.chunkTokens ?? 24e3);
+  const all = [];
+  for (let i = 0; i < chunks.length; i++) {
+    if (opts.signal?.aborted) throw new Error("\u4E2D\u65AD\u3057\u307E\u3057\u305F");
+    report({
+      phase: "review",
+      done: i,
+      total: chunks.length,
+      // まとまりが 1 つなら実体を、複数なら**序数**で言う。
+      // 分母を出すと最後のまとまりで `3/3` になり、処理中なのに完了に見える。
+      message: chunks.length === 1 ? `${scan.files.length} \u30D5\u30A1\u30A4\u30EB\u30FB${scan.totalLines} \u884C\u3092\u8AAD\u3093\u3067\u3044\u307E\u3059` : `${i + 1} \u3064\u3081\u306E\u307E\u3068\u307E\u308A\u3092\u8AAD\u3093\u3067\u3044\u307E\u3059`
+    });
+    const res = await ai.complete(
+      {
+        purpose: "review",
+        system: REVIEW_SYSTEM,
+        user: reviewUserPrompt(formatChunk(chunks[i]), maxFindings)
+      },
+      opts.signal
+    );
+    costUsd += res.usage?.costUsd ?? 0;
+    const parsed = extractJson(res.text);
+    if (parsed === null) {
+      warnings.push(`${i + 1} \u756A\u76EE\u306E\u307E\u3068\u307E\u308A\u3067\u3001AI \u306E\u5FDC\u7B54\u3092\u89E3\u91C8\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F`);
+      continue;
+    }
+    const v = validateFindings(parsed, chunks[i].files, all.length + 1);
+    all.push(...v.findings);
+    if (v.discarded.length > 0) {
+      warnings.push(`${v.discarded.length} \u4EF6\u306E\u6307\u6458\u3092\u89E3\u91C8\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F`);
+    }
+  }
+  if (all.length === 0) throw new Error("\u6307\u6458\u3092 1 \u4EF6\u3082\u53D6\u5F97\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F");
+  const findings = prioritize(all, maxFindings);
+  report({
+    phase: "scenario",
+    done: 0,
+    total: 1,
+    message: `\u6307\u6458 ${findings.length} \u4EF6\u3092\u7269\u8A9E\u306B\u7D44\u307F\u7ACB\u3066\u3066\u3044\u307E\u3059`
+  });
+  const sres = await ai.complete(
+    {
+      purpose: "scenario",
+      system: scenarioSystem(character),
+      user: scenarioUserPrompt(findings)
+    },
+    opts.signal
+  );
+  costUsd += sres.usage?.costUsd ?? 0;
+  const rawScenario = extractJson(sres.text);
+  const { scenario, warnings: sw } = assembleScenario(
+    rawScenario,
+    findings,
+    scan.files,
+    character.characterId,
+    character.nameJa,
+    scan.projectName
+  );
+  warnings.push(...sw);
+  if (scenario.beats.length === 0) throw new Error("\u53F0\u672C\u3092\u751F\u6210\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F");
+  report({
+    phase: "done",
+    done: 1,
+    total: 1,
+    message: `\u6307\u6458 ${findings.length} \u4EF6\u30FB${scenario.beats.length} \u53F0\u8A5E\u306E\u53F0\u672C\u304C\u3067\u304D\u307E\u3057\u305F`
+  });
+  return { scan, findings, scenario, warnings, costUsd };
+}
+
+// src/index.ts
+var DEFAULT_MODEL = "claude-sonnet-5";
+var DEFAULT_MAX_FINDINGS = 6;
+var HELP = `candy-debug ${package_default.version}
+\u30ED\u30AD\u30B7\u30FC\u304C\u30B3\u30FC\u30C9\u30EC\u30D3\u30E5\u30FC\u3092\u3057\u3066\u3001\u30CE\u30D9\u30EB\u7528\u306E\u53F0\u672C\uFF08JSON\uFF09\u3092\u4F5C\u308A\u307E\u3059\u3002
+
+\u4F7F\u3044\u65B9:
+  candy-debug <\u5BFE\u8C61\u30D5\u30A9\u30EB\u30C0> [\u30AA\u30D7\u30B7\u30E7\u30F3]
+  cdbg <\u5BFE\u8C61\u30D5\u30A9\u30EB\u30C0> [\u30AA\u30D7\u30B7\u30E7\u30F3]        \uFF08\u77ED\u7E2E\u540D\u3002\u4E2D\u8EAB\u306F\u540C\u3058\uFF09
+
+\u30AA\u30D7\u30B7\u30E7\u30F3:
+  -o, --output <file>         \u7D50\u679C\u306E JSON \u3092\u66F8\u304D\u51FA\u3059\u30D5\u30A1\u30A4\u30EB\uFF08\u7701\u7565\u6642\u306F\u6A19\u6E96\u51FA\u529B\uFF09
+      --max-findings <n>      \u6307\u6458\u306E\u6700\u5927\u4EF6\u6570\uFF08\u65E2\u5B9A ${DEFAULT_MAX_FINDINGS}\uFF09
+      --model <id>            \u30EC\u30D3\u30E5\u30FC\u306B\u4F7F\u3046\u30E2\u30C7\u30EB\uFF08\u65E2\u5B9A ${DEFAULT_MODEL}\uFF09
+      --scenario-model <id>   \u53F0\u672C\u3065\u304F\u308A\u306B\u4F7F\u3046\u30E2\u30C7\u30EB\uFF08\u65E2\u5B9A\u306F --model \u3068\u540C\u3058\uFF09
+      --claude <command>      claude \u30B3\u30DE\u30F3\u30C9\u306E\u5834\u6240\uFF08\u65E2\u5B9A claude\uFF09
+      --progress <mode>       \u9032\u6357\u306E\u51FA\u3057\u65B9: text | json | none\uFF08\u65E2\u5B9A text\uFF09
+      --scan-only             AI \u3092\u547C\u3070\u305A\u3001\u5BFE\u8C61\u30D5\u30A1\u30A4\u30EB\u306E\u4E00\u89A7\u3068\u7D71\u8A08\u3060\u3051\u3092 JSON \u3067\u51FA\u3059
+      --doctor                claude \u30B3\u30DE\u30F3\u30C9\u304C\u4F7F\u3048\u308B\u304B\u3092\u78BA\u304B\u3081\u308B
+      --json                  --doctor \u306E\u7D50\u679C\u3092 JSON \u3067\u51FA\u3059
+  -v, --version               \u7248\u6570\u3092\u8868\u793A
+  -h, --help                  \u3053\u306E\u8AAC\u660E\u3092\u8868\u793A
+
+\u6CE8\u610F:
+  \u5BFE\u8C61\u306E\u30B3\u30FC\u30C9\u306F claude \u30B3\u30DE\u30F3\u30C9\u3092\u901A\u3058\u3066 Anthropic \u306E\u30B5\u30FC\u30D0\u3078\u9001\u3089\u308C\u307E\u3059\u3002
+  \u5BFE\u8C61\u30D5\u30A9\u30EB\u30C0\u3078\u306F\u4E00\u5207\u66F8\u304D\u8FBC\u307F\u307E\u305B\u3093\u3002
+
+\u7D42\u4E86\u30B3\u30FC\u30C9: 0 \u6210\u529F / 1 \u5931\u6557 / 2 \u5F15\u6570\u306E\u8AA4\u308A / 130 \u4E2D\u65AD
+`;
+var UsageError = class extends Error {
+};
+var errorMode = "text";
+function emit(mode, ev) {
+  if (mode === "json") process.stderr.write(JSON.stringify(ev) + "\n");
+  else if (mode === "text") {
+    if (ev.type === "progress") process.stderr.write(`[${ev.phase}] ${ev.message}
+`);
+    else process.stderr.write(`\u30A8\u30E9\u30FC: ${ev.message}
+`);
+  }
+}
+async function writeOutput(path, json) {
+  await mkdir(dirname(path), { recursive: true });
+  const tmp = `${path}.${process.pid}.tmp`;
+  await writeFile(tmp, json, "utf8");
+  await rename(tmp, path);
+}
+function parseCli(argv) {
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: argv,
+      allowPositionals: true,
+      options: {
+        output: { type: "string", short: "o" },
+        "max-findings": { type: "string" },
+        model: { type: "string" },
+        "scenario-model": { type: "string" },
+        claude: { type: "string" },
+        progress: { type: "string" },
+        "scan-only": { type: "boolean" },
+        doctor: { type: "boolean" },
+        json: { type: "boolean" },
+        version: { type: "boolean", short: "v" },
+        help: { type: "boolean", short: "h" }
+      }
+    });
+  } catch (e) {
+    throw new UsageError(e instanceof Error ? e.message : String(e));
+  }
+  const v = parsed.values;
+  const progress = v.progress ?? "text";
+  if (!["text", "json", "none"].includes(progress)) {
+    throw new UsageError(`--progress \u306F text / json / none \u306E\u3044\u305A\u308C\u304B\u3067\u3059: ${v.progress}`);
+  }
+  let maxFindings = DEFAULT_MAX_FINDINGS;
+  if (v["max-findings"] !== void 0) {
+    maxFindings = Number(v["max-findings"]);
+    if (!Number.isInteger(maxFindings) || maxFindings < 1 || maxFindings > 30) {
+      throw new UsageError(`--max-findings \u306F 1\u301C30 \u306E\u6574\u6570\u3067\u3059: ${v["max-findings"]}`);
+    }
+  }
+  if (parsed.positionals.length > 1) {
+    throw new UsageError(`\u5BFE\u8C61\u30D5\u30A9\u30EB\u30C0\u306F 1 \u3064\u3060\u3051\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044: ${parsed.positionals.join(" ")}`);
+  }
+  return {
+    dir: parsed.positionals[0],
+    output: v.output,
+    maxFindings,
+    model: v.model ?? DEFAULT_MODEL,
+    scenarioModel: v["scenario-model"],
+    claude: v.claude ?? "claude",
+    progress,
+    scanOnly: !!v["scan-only"],
+    doctor: !!v.doctor,
+    json: !!v.json,
+    version: !!v.version,
+    help: !!v.help
+  };
+}
+async function main(argv) {
+  const opts = parseCli(argv);
+  errorMode = opts.progress === "none" ? "text" : opts.progress;
+  if (opts.help) {
+    process.stdout.write(HELP);
+    return 0;
+  }
+  if (opts.version) {
+    process.stdout.write(`${package_default.version}
+`);
+    return 0;
+  }
+  const ai = new ClaudeCliProvider({
+    command: opts.claude,
+    model: opts.model,
+    scenarioModel: opts.scenarioModel ?? opts.model
+  });
+  if (opts.doctor) {
+    const r = await ai.ping();
+    if (opts.json) process.stdout.write(JSON.stringify({ ...r, version: package_default.version }) + "\n");
+    else process.stdout.write(`${r.ok ? "OK" : "NG"}: ${r.detail}
+`);
+    return r.ok ? 0 : 1;
+  }
+  if (!opts.dir) throw new UsageError("\u5BFE\u8C61\u30D5\u30A9\u30EB\u30C0\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\uFF08candy-debug --help\uFF09");
+  const dir = resolve(opts.dir);
+  if (opts.scanOnly) {
+    const scan = await scanProject(dir);
+    const out = JSON.stringify(summarizeScan(scan), null, 2) + "\n";
+    if (opts.output) await writeOutput(resolve(opts.output), out);
+    else process.stdout.write(out);
+    return 0;
+  }
+  if (opts.progress === "text") {
+    process.stderr.write(
+      `\u5BFE\u8C61: ${dir}
+\u30B3\u30FC\u30C9\u3092 claude \u30B3\u30DE\u30F3\u30C9\u3092\u901A\u3058\u3066 Anthropic \u306E\u30B5\u30FC\u30D0\u3078\u9001\u308A\u307E\u3059\u3002
+`
+    );
+  }
+  const controller = new AbortController();
+  const onSignal = () => controller.abort();
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  try {
+    const outcome = await runReview(dir, ai, defaultCharacter(), {
+      maxFindings: opts.maxFindings,
+      signal: controller.signal,
+      onProgress: (p) => emit(opts.progress, { type: "progress", ...p })
+    });
+    const file = {
+      format: REVIEW_FILE_FORMAT,
+      schemaVersion: REVIEW_FILE_VERSION,
+      generator: { name: package_default.name, version: package_default.version },
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      project: { name: outcome.scan.projectName, dir },
+      findings: outcome.findings,
+      scenario: outcome.scenario,
+      warnings: outcome.warnings,
+      costUsd: outcome.costUsd
+    };
+    const json = JSON.stringify(file, null, 2) + "\n";
+    if (opts.output) {
+      const out = resolve(opts.output);
+      await writeOutput(out, json);
+      if (opts.progress === "text") process.stderr.write(`\u66F8\u304D\u51FA\u3057\u307E\u3057\u305F: ${out}
+`);
+    } else {
+      process.stdout.write(json);
+    }
+    if (opts.progress === "text") {
+      for (const w of outcome.warnings) process.stderr.write(`\u8B66\u544A: ${w}
+`);
+      process.stderr.write(`\u8CBB\u7528\u306E\u76EE\u5B89: $${outcome.costUsd.toFixed(4)}
+`);
+    }
+    return 0;
+  } catch (e) {
+    if (controller.signal.aborted) {
+      emit(opts.progress, { type: "error", message: "\u4E2D\u65AD\u3057\u307E\u3057\u305F" });
+      return 130;
+    }
+    throw e;
+  } finally {
+    process.off("SIGINT", onSignal);
+    process.off("SIGTERM", onSignal);
+  }
+}
+main(process.argv.slice(2)).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (e) => {
+    const message = e instanceof Error ? e.message : String(e);
+    emit(errorMode, { type: "error", message });
+    process.exitCode = e instanceof UsageError ? 2 : 1;
+  }
+);
+export {
+  main
+};

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "candy-debug",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "ロキシーがコードレビューをして、ノベルゲーム用の台本（JSON）を作る CLI",
+  "type": "module",
+  "bin": {
+    "candy-debug": "dist/candy-debug.mjs",
+    "cdbg": "dist/candy-debug.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node20 --loader:.csv=text --banner:js=\"#!/usr/bin/env node\" --outfile=dist/candy-debug.mjs --log-level=warning",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "code-review",
+    "claude",
+    "cli",
+    "visual-novel"
+  ],
+  "author": "ryome",
+  "license": "MIT"
+}