ui-chan-mcp 0.5.0

package/docs/STYLE.md

@@ -0,0 +1,107 @@
+# ドキュメントの書きかた
+
+> **ドキュメントを書く・直すときに読む。** ここに書いてある型を守れば、どのページも同じ顔になる。
+> 読む人は毎回レイアウトを学び直さずに済むし、書く人は迷わずに済む。
+
+CSS は使えないので、**GitHub の Markdown でできることだけ**を組み合わせて統一感を作る。
+凝ったことはしない。決めごとを少なくして、全部のページで必ず守るほうが効く。
+
+---
+
+## `01` ページの型
+
+どのページも、この4つで始める。
+
+```markdown
+# タイトル（名詞。機能名か作業名）
+
+> **いつ読むか。** 1〜2文で、このページが答える問いを書く。
+> 別のページのほうが適切なら、そのリンクをここで出す。
+
+---
+```
+
+<sub>リード文を引用（`>`）にしているのは、本文と視覚的に切り離すため。GitHub では
+引用が左に縦線で表示されるので、それだけで「案内文」だと分かる。</sub>
+
+## `02` 見出し
+
+| レベル | 使いかた |
+|---|---|
+| `#` | ページに1つだけ。タイトル |
+| `## \`01\` 見出し` | 大きな区切り。**番号を付ける**。区切りの前に `---` を入れる |
+| `###` | その中の手順や項目。番号は付けない |
+| `####` | 使わない。必要になったらページを分ける合図 |
+
+番号は図解ページ（[SETUP.html](SETUP.html)）の `01` `02` と同じ役割で、
+「いくつあって、いま何番目か」を読む人に渡すためのもの。
+
+## `03` コールアウト（色）
+
+GitHub Alerts は種類ごとに色が付く。**用途を固定して、色が意味を持つようにする。**
+
+> [!NOTE]
+> 青。前提・環境・仕様の補足。知らなくても進めるが、知っていると迷わないこと。
+
+> [!TIP]
+> 緑。近道・省略できること。「これ全部やらなくていいよ」の合図。
+
+> [!IMPORTANT]
+> 紫。守ってほしい約束。権利表記、命名規約、設計上の決めごと。
+
+> [!WARNING]
+> 黄。壊れる操作、ハマりどころ。やり直せるが痛いもの。
+
+> [!CAUTION]
+> 赤。取り返しがつかないもの。公開、削除、上書き。**滅多に使わない。**
+
+<sub>1ページに何個も置かない。目安は2つまで。多いと色が意味を失う。</sub>
+
+## `04` 表
+
+説明が3つ以上並ぶときは、箇条書きより表にする。視線が止まる場所ができる。
+
+- **1列目は「対象」**（id、ファイル名、コマンド、キー）。ここが揃うと読みやすい
+- 記号・絵文字の列は `|:---:|` で中央寄せ
+- 最後の列に「そうしないとどうなるか」を置くと、判断できる表になる
+
+| 悪い例 | 良い例 |
+|---|---|
+| 説明を文章で3段落 | 表にして、1列目に対象、最後に結果 |
+| `| 項目 | 説明 |` だけ | `| 項目 | 何が起きる | 省略すると |` |
+
+## `05` 補足と強調
+
+| 書きかた | 使いどころ |
+|---|---|
+| `<sub>小さい文字</sub>` | 注釈。読み飛ばしてよい情報。段落の末尾に置く |
+| `**太字**` | その段落で1箇所だけ。多用すると効かなくなる |
+| `` `コード` `` | ファイル名、コマンド、設定キー、Cue名 |
+| `<kbd>Enter</kbd>` | 実際に押すキー |
+
+## `06` ページの終わり
+
+行き先を示して終わる。読み終えた人を放り出さない。
+
+```markdown
+---
+
+<sub>次に読むなら [ページ名.md](.)（〜したいとき） / [ページ名.md](.)（〜したいとき）</sub>
+```
+
+## `07` 口調
+
+| 場所 | 誰の言葉か |
+|---|---|
+| `README.md` | **ういちゃん本人**。「わたし」「きみ」。使う人向けの案内 |
+| `docs/` | **書き手**。です・ます。事実と理由を淡々と |
+| `persona/` `context/` | ドキュメントではない。**AI に注入される設定**。触ると振る舞いが変わる |
+| `CLAUDE.md` | 実装者向け。英語。設計判断と、そう決めた理由 |
+
+> [!IMPORTANT]
+> `docs/` でういちゃんの口調を真似しない。**楽しいのは README だけでいい。**
+> 手順書が語尾で揺れると、読む側は情報の正確さを疑いはじめる。
+
+---
+
+<sub>このページ自体がこの型で書かれています。迷ったら、ここの見た目を真似してください。</sub>

package/docs/TOOLS.md

@@ -0,0 +1,33 @@
+# エージェントから見た操作面
+
+> **エージェントが何をできるのかを知りたいとき**に読みます。MCP ツールと、プラグインのスラッシュコマンドの一覧です。
+
+---
+
+## `01` MCP ツール（エージェントが呼ぶ）
+
+| ツール | 引数 | 説明 |
+|---|---|---|
+| `set_cue` | `cue`, `text?`, `reading?`, `duration_ms?`, `pitch?`, `speed?`, `volume?`, `intonation?` | Cue（見た目＋声）を切り替え、任意でセリフを同時に話す。`text` を省略すると無言でCueだけ変わる。未知の `cue` 名は `default` にフォールバックし `note` が付く。`pitch`/`speed`/`volume`/`intonation` はその一行だけのアドリブ演技 |
+| `get_state` | — | 現在の状態・接続エージェント・利用可能Cue・好感度・警告 |
+| `adjust_affinity` | `direction`（`up`/`down`）, `magnitude`（`low`/`middle`/`high`） | 好感度を増減（セッション内のみ・再起動でリセット）。実際の増減量はエンジンが決めます |
+| `clear` | — | 吹き出し・Cueを初期状態（`default`）にリセット |
+
+どのCueが使えるかは、起動のたびに `cues/` から作り直してエージェントに渡してる。
+だから表情を1個足したら、その場で選べるようになるよ。手で一覧を書き足す必要はないの。
+
+---
+
+## `02` スラッシュコマンド（プラグイン導入時）
+
+| コマンド | 説明 |
+|---|---|
+| `/talk <メッセージ>` | 会話のみ。作業はしない |
+| `/mode [依頼]` | セッションごと憑依モード。以後は作業も会話もういちゃん本人として行う |
+| `/beam` | ういビーム。好感度が閾値未満なら撃たない |
+| `/eli14 [お題]` | 14才目線の図解で説明する（HTML＋口頭解説） |
+| `/mcp__ui-chan__persona` | 人格ファイルを編集したあとの読み込み直し |
+
+---
+
+<sub>次に読むなら [PERSONA.md](PERSONA.md)（これらの使い方をどう指示しているか） / [CUE_AUTHORING.md](CUE_AUTHORING.md)（表情そのものを増やす）</sub>

package/docs/TROUBLESHOOTING.md

@@ -0,0 +1,122 @@
+# 困ったときは
+
+> **動かない、または思った通りにならないとき**に読みます。
+> まず `ui-chan doctor` を実行してから、症状の近いものを開いてください。
+
+---
+
+## `01` 動かない
+
+<details>
+<summary><b>マスコットが画面に出てこない</b></summary>
+
+`ui-chan start` で直接起こしてみて。それで出るなら、繋ぎ方の問題。
+普通はセッションを開けば勝手に出てくるはずなんだけどね。
+立ち絵が `~/.ui-chan/assets/` に無いときは、のっぺらぼうで出るよ。それはそれで。
+</details>
+
+<details>
+<summary><b>声が出ない</b></summary>
+
+よくある原因は次の3つです。VoiSona Talk が起きてない、
+`~/.ui-chan/.env` に鍵が無い、VoiSona 側で REST API を有効にしてない。
+
+声が出なくても吹き出しは出るし、口も `reading` のかなでパクパクするから、そんなに困らないと思う。
+理由は `get_state` の `warnings` に書いてあるよ。詳しくは [docs/TTS.md](TTS.md)。
+</details>
+
+<details>
+<summary><b>ビルドはいつ必要？</b></summary>
+
+npm で入れたなら要らないよ。ビルド済みのものが届くから。
+クローンして中を直すときだけ `npm run build` が要ります → [DEVELOPMENT.md](DEVELOPMENT.md)
+</details>
+
+---
+
+## `02` うるさい・静かすぎる
+
+<details>
+<summary><b>アイドル中の独り言がうるさい／静かすぎる</b></summary>
+
+`idle.idlingCues` の `minSec` / `maxSec`（既定 120〜300秒）で間隔、`weight` で出やすさ。
+好感度で出し分けたいなら `minAffinity` / `maxAffinity`。
+
+なお、キー入力やマウス操作がある間は黙っています。15分離席すると寝て、戻ると起きます
+（`idle.idlingCues.systemIdle`）。
+</details>
+
+<details>
+<summary><b>作業中の反応（失敗した・サブエージェントが帰ってきた 等）を変えたい</b></summary>
+
+`ui-chan.config.json` の `eventCues.events`。イベントごとにセリフのプールがあって、
+`cooldownSec` でうるささを、`chance` で「毎回言うか、たまにか」を決められるよ。
+中身は IdlingCue と同じ形だから `weight` / `minAffinity` / `maxAffinity` / `hours` も効く。
+
+用意してあるのは `permission`（許可待ち）、`idle_wait`（入力待ち）、`tool_failure`（こけた）、
+`turn_done`（終わった）、`compact`、`agent_out`（お手伝いの子を送り出した）、`agent_back`（帰ってきた）。
+
+セリフを変えるのに JavaScript は触らなくていいよ。フックは「何が起きたか」を投げるだけだから。
+</details>
+
+<details>
+<summary><b>マスコットを終了させたい</b></summary>
+
+マスコット右上のつまみを開いて、**電源のアイコン ⏻** を押します。これが最短です。
+**エージェントがツールを呼んでも起き直しません**（次にセッションを開くか、
+`ui-chan start` で起動するまで停止したままです）。
+
+コマンドからは：
+
+```bash
+ui-chan stop     # 止める
+ui-chan start    # 起こす
+```
+
+**放っておいても、繋がっているエージェントが全部いなくなれば自動で終了します**（既定 60 秒後。
+`~/.ui-chan/config.json` の `exitAfterLastAgentSec`、`0` で無効）。猶予があるのは、
+クライアントの再起動で一瞬切断されただけのときに消えないためです。
+
+MCP ツールに終了コマンドはありません。エージェントが自分の都合でマスコットを閉じるのは、
+ユーザーの画面を勝手に片付けることに等しいためです。
+</details>
+
+---
+
+## `03` 中身を変えたい
+
+<details>
+<summary><b>新しい表情（Cue）を追加したい</b></summary>
+
+`~/.ui-chan/cues/<名前>.json` を1個作るだけ。同じ名前なら同梱のを上書きするよ。
+継承とか無いから、そのファイルだけ見れば分かる。**保存した瞬間に反映**されるから、
+アプリを再起動しなくていいの。書き方は [docs/CUE_AUTHORING.md](CUE_AUTHORING.md)。
+</details>
+
+<details>
+<summary><b>性格やセリフを変えたい</b></summary>
+
+`persona/ui-chan.md` と `context/*.md`（`SOUL.md` が価値観、`VOCABULARY.md` が語彙と口癖、
+`AFFINITY.md` が好感度の機微）。`~/.ui-chan/` 側に同じ名前で置けば上書きできます。
+→ [PERSONA.md](PERSONA.md)
+</details>
+
+<details>
+<summary><b>別のキャラクターに差し替えたい</b></summary>
+
+`persona/` と `context/` を書き換え、PSD に合わせて `cues/` とレイヤー設定を作り直します。
+どれも `~/.ui-chan/` 側に置けば上書きになるため、同梱物を削る必要はありません。
+手順は [CUE_AUTHORING.md](CUE_AUTHORING.md) と [PERSONA.md](PERSONA.md)。
+</details>
+
+<details>
+<summary><b>ういビームが撃てない</b></summary>
+
+好感度が閾値（65）に達していません。感謝、気遣い、以前の発言を覚えていること、といった
+振る舞いで上がります。直球の好意表現はむしろ下がります（`context/AFFINITY.md`）。
+
+</details>
+
+---
+
+<sub>次に読むなら [TTS.md](TTS.md)（声まわりを詳しく） / [CLIENTS.md](CLIENTS.md)（どこに何が登録されているか）</sub>

package/docs/TTS.md

@@ -0,0 +1,61 @@
+# 音声合成（VoiSona Talk 連携）
+
+> **声が出ない、または声を調整したいとき**に読みます。有効化の手順、設定項目、うまく喋らないときの原因。
+
+---
+
+[VoiSona Talk](https://voisona.com/talk/download/)（テクノスピーチ、無料）の REST API 経由で、
+`set_cue` のセリフを実際に喋らせることができます。合成は `destination: memory` で行い、
+WAV と音素タイミング（`phonemes` / `phoneme_durations`）を取得してアプリ側で再生するため、
+**口パクは音素単位で音声と完全同期**します。吹き出しの表示時間も音声の実時間に一致します。
+
+API リファレンスは REST API 有効化後に http://localhost:32766/docs/talk_api.html で読めます。
+
+## `01` 有効化手順
+
+1. VoiSona Talk を起動してログインし、ボイスライブラリを 1 つ以上ダウンロード
+2. メニュー「編集 > 環境設定」の **API タブ** で待ち受けポート（デフォルト 32766）と API 用パスワードを設定し、「REST API を有効にする」をチェック
+3. 認証情報を **`~/.ui-chan/.env`** に置く（`npx ui-chan` の対話セットアップが聞いてきます。
+   環境変数 `UI_CHAN_TTS_USERNAME` / `UI_CHAN_TTS_PASSWORD` でも可で、そちらが優先）。
+   `ui-chan.config.json` は認証情報を持たず、MCP ブリッジ経由でメモリ上にのみ渡されます
+
+`ui-chan.config.json` 側の設定は接続先とボイス選択だけです：
+
+```json
+"tts": {
+  "enabled": true,
+  "provider": "voisona-talk",
+  "url": "http://127.0.0.1:32766",
+  "voice_name": "使いたいボイス名（空なら日本語対応の最初のボイス）",
+  "language": "ja_JP",
+  "app_name": "VoiSona Talk"
+}
+```
+
+- `enabled` — TTS のマスタースイッチ。true でも認証情報が届くまでは音声なしで動きます
+- `app_name` — MCP サーバ起動時に API へ到達できないとき `open -a` で起動するアプリ名（macOS）
+
+---
+
+## `02` Cueと声のトーンの連動
+
+`set_cue(cue)` が顔と声の両方を駆動します。各Cueファイル（`cues/<cue>.json`）の `voice` ブロックが
+そのCueの声を決めます：
+
+- `voice.style_weights` はスタイル名 → 重みのオブジェクト（`{"Happy": 0.7, "Bashful": 0.3}`）。
+  ブレンド計算はせず、ボイスの `style_names` の並び順に変換して VoiSona の `global_parameters.style_weights`
+  にそのまま渡ります
+- `voice.alp` / `voice.huskiness` もCueに焼き込め、同じく `global_parameters` に素通しされます
+- そのセリフ一行だけの演技（`pitch`/`speed`/`volume`/`intonation`）は `set_cue` の引数として渡します。
+  Cueの `voice` と `set_cue` のアドリブパラメータはどちらも同じ `global_parameters` にマージされて送られます
+- スタイル名はボイスごとに異なるので `GET {url}/api/talk/v1/voices/{voice_name}/{voice_version}` の
+  `style_names` で確認して合わせてください。一致しない場合はデフォルトのトーンで喋ります
+
+利用可能なボイス名は `GET {url}/api/talk/v1/voices`（Basic 認証）で確認できます。
+
+- 雨衣（うい）ちゃんのボイスが発売されたら、`voice_name` を差し替えるだけで対応できる想定です
+- エンジンに接続できない場合は音声なしで動き続けます（60 秒のクールダウン後に再試行）。その間のリップシンクはテキスト読み駆動（`set_cue` の `reading`）にフォールバックします
+
+---
+
+<sub>次に読むなら [TROUBLESHOOTING.md](TROUBLESHOOTING.md)（ほかの不具合） / [CUE_AUTHORING.md](CUE_AUTHORING.md)（Cue ごとの声色を作る）</sub>

package/docs/design/CUE_CATALOG.md

@@ -0,0 +1,259 @@
+# CUE_CATALOG — Cueカタログ設計（あるべき一覧とMECE方針）
+
+現在の Cue 群を **MECE（漏れなく・ダブりなく）に整理**するための設計ドキュメント。
+「表情をこの世に何個あるか」から逆算し、心理学モデルを**構造の背骨**として採用する。
+ここは *あるべき姿* の定義。実ファイル（`cues/*.json`）の現状との対応・被り・欠番を可視化し、
+統合／新規／改名の判断材料にする。実装はこの後。
+
+> 関連: `VISION.md`（製品ビジョン・ユビキタス言語）／ `docs/PSD_LAYERS.md`（Cue *作成*用の生レイヤーパス参照）。
+> 本ファイルは *分類* の設計であり、両者とは役割が違う。
+
+## 方針（なぜこの構造か）
+
+1. **敵は「数」ではなく「被り＋フラットな羅列」。** 66個フラットで境界が曖昧だと、AI（`set_cue`）が
+   毎回どれを選ぶか判別できず選択がブレる（＝MCPツールが多すぎて使えない問題と同じ）。
+2. **重複統合は表現力の損失ゼロ。** 同義Cueはどちらを選んでも同じ＝表現に何も足していない。消しても幅は狭まらない。
+3. **幅（網羅）は "別物の表情" を全部残して守る。** 心理学モデルは *埋める格子* ではなく **抜けチェックの点検表**として使う。
+4. **使いこなせるかは "数" ではなく "構造" で解く。** ファミリー分類＋強度ラダー＋鋭いdescriptionで
+   `family → cue` と辿れるようにする（`buildCueCatalog` をグループ化出力に）。
+5. Plutchik を背骨に選ぶ理由: Ekman6 / Cowen-Keltner16 は **平たいリスト**。Plutchik は **2軸グリッド＋関係性**で、
+   *構造そのものから表現が生成される*（強度ラダー＝既存の `_strong`、隣接ブレンド＝`love`/`contempt`）。
+
+## 分類軸（背骨）
+
+| 層 | 数 | 内容 |
+|---|---|---|
+| ① 基本感情 | **8** | 喜 / 信頼 / 恐 / 驚 / 悲 / 嫌悪 / 怒 / 期待（Plutchik） |
+| ② 強度 | 各 **最大3** | 弱 / 無印 / 強（全感情に3段作る義務は無い＝点検表） |
+| ③ ブレンド（隣接dyad） | **8** | 8基本の隣り合わせ。愛/服従/畏敬/失望/自責/侮蔑/攻撃/楽観 |
+| ④ 自己意識感情 | **4** | 照れ / 恥 / 罪悪感 / 誇り（感情の輪の外。ツンデレの核） |
+| ⑤ システム表情 | 可変（~10） | 思考/説明/配信/眠気/作業結果/特殊 等。心理学に無い**マスコット固有軸** |
+
+> 「隣接なら6では？」への答え = **8**。Ekman6 には輪の順序が無く隣接を定義できない。Plutchik が *あえて8* に
+> しているのは、8で輪が閉じて隣接が8つの意味あるブレンドになるから。6に削ると輪が壊れブレンドが破綻する。
+
+## 命名規則
+
+- **論理名** = 分類上のスロット（例: 「喜び・強」「侮蔑」）。人間・カタログ用。
+- **物理名** = Cueファイル名 `cues/<物理名>.json`（例: `happy_strong`）。`set_cue` に渡す実名。
+- **強度**: 無印 = 素の名前（`happy` = 中）。極だけ接尾辞 `_weak` / `_strong` を足す（既存 `_strong` 準拠、改名コスト最小）。
+  全感情に3段は作らない — 要る所だけ。
+- **状態記号**: ✅既存流用 / ⚠️被り(統合候補) / ⛔欠番(新規要検討) / 🔀別層へ移動
+
+---
+
+## ① 基本感情 × 強度
+
+### 喜び Joy
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 平穏 serenity | `smile` | smile（微笑み） | ✅ |
+| 無印 | 喜び joy | `happy` | happy（うれしい） | ✅ |
+| 強 | 恍惚 ecstasy | `happy_strong` | happy_strong（大喜び） | ✅ |
+| 変種 | はしゃぎ | `kyakkya` | kyakkya（きゃっきゃ） | ⚠️ happy_strong と近い（要差別化 or 統合） |
+
+### 信頼 Trust
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 容認 | — | — | ⛔（表情に出にくい。要否検討） |
+| 無印 | 信頼 | — | — | ⛔ |
+| 強 | 敬愛 admiration | `uioji` | uioji（愛でる・ういおじ化） | ✅ 強寄り（溺愛） |
+
+### 恐れ Fear
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 不安 apprehension | `yabe` | yabe（冷や汗・やべっ） | ✅ 弱寄り（システム焦りとも重なる） |
+| 無印 | 恐れ fear | `scared` | scared（怖い） | ✅ |
+| 強 | 恐怖 terror | `scared_strong` | scared_strong（強い恐怖） | ✅ |
+
+### 驚き Surprise
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 放心 distraction | `kyoton` | kyoton（きょとん・ぽかーん） | ✅（システム放心とも） |
+| 無印 | 驚き surprise | `surprised` | surprised / **odoroki** | ⚠️ **被り**（surprised と odoroki 同義 → 統合） |
+| 強 | 驚愕 amazement | `surprised_strong` | surprised_strong / **shock** | ⚠️ shock は失望寄りにも（下記④失望と要仕分け） |
+
+### 悲しみ Sadness
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 憂い pensiveness | — | — | ⛔（しんみり。欠番） |
+| 無印 | 悲しみ sadness | `sad` | sad（悲しい） | ✅ |
+| 強 | 悲嘆 grief | `sad_strong` | sad_strong / **naku** | ⚠️ 近い（naku=涙で差別化する前提なら両立可） |
+
+### 嫌悪 Disgust
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 退屈 boredom | — | （nemui の退屈成分） | 🔀 退屈は⑤眠気/退屈へ |
+| 無印 | 嫌悪 disgust | — | — | ⛔（純粋な「うわ、無理」。欠番） |
+| 強 | 強い嫌悪 loathing | — | — | ⛔ |
+| 注 | — | — | — | 塩対応(jito/shiozake)は嫌悪単体でなく**⑥侮蔑ブレンド**へ |
+
+### 怒り Anger
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 苛立ち annoyance | `mutto` | mutto（むっ） / **fuman**（不満） | ⚠️ **被り** → 統合 |
+| 無印 | 怒り anger | `angry` | angry（怒り） | ✅ |
+| 強 | 激怒 rage | `gekioko` | gekioko（激おこ） | ✅ |
+
+### 期待 Anticipation
+| 強度 | 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 弱 | 関心 interest | — | （思考系はシステムへ） | 🔀 |
+| 無印 | 期待 anticipation | `excited` | excited（ワクワク・興奮） | ✅（⑧楽観とも重なる） |
+| 強 | 警戒/決意 vigilance | `yaruki` | yaruki（やる気・気合い） | ✅ 強寄り |
+
+---
+
+## ③ ブレンド（隣接dyad）8
+
+| 論理名 | 構成 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|---|
+| 愛 love | 喜+信頼 | `love` / `deredere` | love（恋ときめき） / deredere（とろけ） | ⚠️ 近い（love=無印 / deredere=強、で両立余地） |
+| 服従 submission | 信頼+恐 | — | — | ⛔（マスコット的に不要かも） |
+| 畏敬 awe | 恐+驚 | `kantan` | kantan（感嘆・おおー） | ✅ |
+| 失望 disappointment | 驚+悲 | `gennari` | gennari（げんなり） / （shock の負の面） | ✅ |
+| 自責 remorse | 悲+嫌悪 | `zetsubou` | zetsubou（絶望・虚無） | ✅（罪悪感 suimasenne は④へ） |
+| 侮蔑 contempt | 嫌悪+怒 | `jito` | **jito** / **shiozake**（塩対応・呆れ） | ⚠️ **被り** → 統合。kotowaru は「断り」変種 |
+| 攻撃 aggressiveness | 怒+期待 | — | — | ⛔ |
+| 楽観 optimism | 期待+喜 | — | （excited と重複） | ⛔ or excited に吸収 |
+
+---
+
+## ④ 自己意識感情 4
+
+| 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|
+| 照れ embarrassment | `shy` / `tere` / `tere_max` / `fun_tere` | shy（恥ずかしい） / tere（褒められ照れ） / tere_max（真っ赤） / fun_tere（照れ隠し） | ⚠️ shy≈tere 被り。tere_max=強、fun_tere=ツンデレ変種で残す |
+| 恥 shame | — | — | ⛔ or 照れ・強に統合 |
+| 罪悪感 guilt | `suimasenne` | suimasenne（すいませんねぇ） / troubled（申し訳） | ✅（troubled と要仕分け） |
+| 誇り pride | `smug` / `doya` | **smug**（ドヤ顔） / **doya**（〜だが？） | ⚠️ **被り** → 統合。smug_arms_crossed / smug_hands_on_hips は🔀ポーズ変種 |
+
+---
+
+## ⑤ システム表情（マスコット固有・感情外）
+
+| 論理名 | 物理名 | 現Cue | 状態 |
+|---|---|---|---|
+| 素・相槌 | `normal` | normal | ✅ |
+| 無・真顔・悟り | `magao` | magao | ✅ |
+| 思考・集中 | `thinking` | **thinking** / **kangae**（調査中） | ⚠️ **被り** → 統合。normal_think(頬杖)は🔀ポーズ |
+| 説明・案内 | `setsumei` | setsumei | ✅ |
+| 登場・挨拶 | `toujou` | toujou | ✅ |
+| 語りかけ・カメラ目線 | `yobikake` | yobikake | ✅ |
+| 配信・実況 | `haishin` | haishin | ✅ |
+| 眠気・退屈 | `sleepy` | **sleepy** / **nemui**（眠い・退屈） | ⚠️ **被り** → 統合 |
+| 混乱・目が回る | `panic` | **dizzy** / **panic** | ⚠️ **被り** → 統合 |
+| 焦り・あわあわ | `awawa` | awawa | ✅（yabe と近い） |
+| 困り・気まずい | `troubled` | troubled | ✅（suimasenne と近い） |
+| 脱力・ほへ | `hoke` | hoke | ✅ |
+| 含み笑い・いたずら | `fukumiwarai` | fukumiwarai | ✅（amusement/mischief） |
+| 安心・ほっと | `relief` | relief | ✅ |
+| 爆笑 | `bakushou` | bakushou | ✅（amusement） |
+| 作業成功 | `success` | success | ✅ |
+| 雨 | `ame` | ame | ✅（情景） |
+| ういビーム | `beam` | beam | ✅（特殊アクション） |
+| ビーム拒否 | `kotowaru` | kotowaru | ✅（侮蔑の変種でも） |
+
+### ポーズ変種（感情×ポーズ = 別軸。件数を食うので注意）
+`normal_arms_crossed`（退屈腕組み） / `normal_umbrella`（傘） / `happy_banzai`（万歳） /
+`smug_arms_crossed` / `smug_hands_on_hips`（ドヤ独り言） / `normal_think`（頬杖考え）
+→ 「感情」ではなく「感情＋ポーズ」の組。カタログ上は感情スロットに紐づけつつ、*ポーズ変種*として別扱い。
+
+### 内部（IdlingCueのビルディングブロック・AI非公開）
+`idling_yawn_1..3` / `idling_doze_1..3` / `idling_lookaround_1..3` / `idling_giggle_1..2` /
+`idling_sigh_1..2` / `idling_ponder` — `internal: true`。カタログ対象外。
+
+---
+
+## 被り（統合候補）サマリ
+
+| ペア/群 | 論理スロット | 方針案 |
+|---|---|---|
+| surprised / odoroki | 驚き・無印 | 統合（1つに） |
+| sleepy / nemui | 眠気・退屈 | 統合 |
+| dizzy / panic | 混乱 | 統合 |
+| jito / shiozake | 侮蔑（塩対応） | 統合 |
+| shy / tere | 照れ・無印 | 統合 or 「恥ずかしい」vs「褒められ照れ」で明確に弁別 |
+| smug / doya | 誇り・無印 | 統合 |
+| mutto / fuman | 苛立ち | 統合 |
+| kangae / thinking | 思考 | 統合（normal_think は頬杖ポーズ変種で残す） |
+| troubled / suimasenne | 困り / 罪悪感 | 弁別（困り＝気まずい / すいません＝申し訳）or 統合 |
+| love / deredere | 愛 | 強度差で両立（love=無印 / deredere=強） |
+| sad_strong / naku | 悲嘆 | 涙の有無で弁別して両立 |
+| surprised_strong / shock | 驚愕 / 失望 | shock を「負の驚き＝失望」に寄せて弁別 |
+
+## 欠番（新規要検討）サマリ
+
+- **悲しみ・弱**（しんみり・憂い）
+- **嫌悪・無印/強**（純粋な「うわ無理」/ 強い嫌悪） ※塩対応は侮蔑に振ったので嫌悪単体が空く
+- **信頼・弱/無印**（表情に出にくい。不要判断もあり）
+- ブレンド: **服従 / 攻撃 / 楽観**（マスコット的に不要な可能性大 → 欠番のままでよいか判断）
+- **恥 shame**（照れ・強に統合でよいか）
+
+---
+
+# あるべき最終リスト（統合後の目標セット）
+
+方針: **明確な同義だけ統合（→で示す5組）。微妙に違うものは description を鋭くして両立（表現力を残す）。欠番は候補として明記（CEはこの子が遭遇する場面に限定）。**
+物理名 = `cues/<name>.json`。`(merge: X→)` = X を統合して消す。`(差別化)` = 隣接と弁別して残す。`⛔候補` = 欠番（作るか要判断）。`[pose]` = ポーズ変種。
+
+## ① 基本感情
+
+**喜び** `smile`(平穏) / `happy`(喜び) / `happy_strong`(恍惚) / `kyakkya`(はしゃぎ・差別化: happy_strong=感情の高さ, kyakkya=子供っぽい多動)
+**信頼** `uioji`(敬愛・溺愛) ／ 弱・無印 ⛔候補（表情に出にくい＝不要濃厚）
+**恐れ** `yabe`(不安・冷や汗) / `scared`(恐れ) / `scared_strong`(恐怖)
+**驚き** `kyoton`(放心) / `surprised`(驚き)（merge: odoroki→） / `surprised_strong`(驚愕)
+**悲しみ** `sad`(悲しみ) / `sad_strong`(悲嘆) / `naku`(涙・差別化: sad_strong=表情の強さ, naku=泣く動作) ／ 弱(しんみり) ⛔候補
+**嫌悪** ⛔候補: 純粋な嫌悪「うわ無理」（塩対応は侮蔑へ振ったので単体嫌悪が空く）
+**怒り** `mutto`(苛立ち)（merge: fuman→） / `angry`(怒り) / `gekioko`(激怒)
+**期待** `excited`(期待・ワクワク) / `yaruki`(決意・気合い)
+
+## ③ ブレンド（隣接dyad）
+
+**愛** `love`(恋・ときめき) / `deredere`(とろけ・差別化: love=ときめき, deredere=蕩ける強)
+**畏敬** `kantan`(感嘆・おおー)
+**失望** `gennari`(げんなり) ／ `shock`(負の驚き＝驚愕×失望・差別化: surprised_strong=純驚き, shock=ショック)
+**自責** `zetsubou`(絶望・虚無)
+**侮蔑** `jito`(ジト目で見る) / `shiozake`(ふ〜んと受け流す・差別化: jito=睨む, shiozake=受け流す)
+**服従 / 攻撃 / 楽観** ⛔ 欠番のまま（マスコット的に不要と判断）
+
+## ④ 自己意識感情
+
+**照れ** `shy`(恥ずかしい) / `tere`(褒められ照れ・差別化: shy=気恥ずかしさ, tere=嬉しさ混じり) / `tere_max`(真っ赤・強) / `fun_tere`(照れ隠し・ツンデレ変種)
+**罪悪感** `suimasenne`(申し訳・すいませんねぇ)
+**誇り** `smug`(ドヤ顔・独り言) / `doya`(決め台詞「〜だが？」・差別化: smug=顔, doya=セリフ) / `smug_arms_crossed`[pose] / `smug_hands_on_hips`[pose]
+**恥 shame** ⛔ 照れ・強（tere_max）に統合でよい
+
+## ⑤ システム表情
+
+`normal`(素・相槌) / `magao`(無・真顔) / `thinking`(思考)（merge: kangae→） / `setsumei`(説明) / `toujou`(登場) / `yobikake`(語りかけ) / `haishin`(配信) / `sleepy`(眠気)（merge: nemui→） / `dizzy`(混乱)（merge: panic→） / `awawa`(焦り) / `troubled`(困り・気まずい・差別化: suimasenne=申し訳) / `hoke`(脱力) / `fukumiwarai`(含み笑い) / `relief`(安心) / `bakushou`(爆笑) / `success`(作業成功) / `ame`(雨・情景) / `beam`(ういビーム) / `kotowaru`(ビーム拒否)
+**[pose]** `normal_arms_crossed` / `normal_umbrella` / `happy_banzai` / `normal_think`
+**[internal]** `idling_*`（AI非公開・IdlingCue部品）
+
+## 統合サマリ（この目標セットで消えるCue = 5個）
+
+| 消す | 統合先 | 理由 |
+|---|---|---|
+| `odoroki` | `surprised` | 同義（驚き） |
+| `fuman` | `mutto` | 同義（苛立ち・不満） |
+| `kangae` | `thinking` | 同義（考え中） |
+| `nemui` | `sleepy` | 同義（眠い） |
+| `panic` | `dizzy` | 同義（混乱・目が回る） |
+
+→ AI向け 66 → **61**。残りの近接ペア（jito/shiozake, shy/tere, smug/doya, love/deredere, sad_strong/naku, troubled/suimasenne, surprised_strong/shock）は **description を弁別的に書き直して両立**（もっと減らしたければ更に統合可）。
+
+## 欠番候補（作るか要判断・CEはこの子の場面に限定）
+
+- 悲しみ・弱（しんみり・憂い）
+- 嫌悪・単体（「うわ無理」＝純粋な嫌悪）
+- （信頼弱/無印・ブレンド服従/攻撃/楽観・恥 は不要と判断＝作らない）
+
+---
+
+## 未決事項（次に決める）
+
+1. 被り群を1つずつ「統合／弁別」決定（MEを立てる）。
+2. 欠番を「新規作成／不要」判断（CEの範囲＝この子が遭遇する場面に限定）。
+3. 強度接尾辞を `_weak`/`_strong` で確定するか（無印=素の名前）。
+4. ポーズ変種の扱い（感情スロットにぶら下げるか、別カタログにするか）。
+5. `buildCueCatalog` をこの階層でグループ化出力する実装（AIが family→cue で辿れる）。

package/hooks/fire-event.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// Fire one EventCue by name, from anywhere:
+//
+//   bin/ui-chan-node hooks/fire-event.js tool_failure
+//
+// The Claude Code hooks read a payload from stdin and decide the event
+// themselves; this is the same last step exposed for hosts whose plugin
+// runtime isn't JavaScript (the Hermes plugin is Python and spawns this). It
+// keeps the "a trigger only names the event" rule intact — the lines, weights,
+// cooldowns and affinity gates stay in ui-chan.config.json, one copy for every
+// host.
+const { fireEvent } = require('./lib/mascot');
+
+fireEvent(process.argv[2], process.argv[3] ?? 'external-hook');