akari-video 0.1.0

package/vendor/skills/generate-narration/voice-profile-setup.md

@@ -0,0 +1,77 @@
+# 声プロファイル作成手順（fal-qwen3 自声クローン用）
+
+fal-qwen3 アダプタ（[engines.md](engines.md)）で自声クローンを使うには、事前に
+`~/.config/akari-video/voice-profiles/<name>/` へ声プロファイルを 1 度作っておく必要がある。
+本リーフはその作成手順を正文として記載する。**クローンするのはプロジェクトオーナー本人の声のみ**
+（SKILL.md ハードルール 1）。
+
+## 1. 原稿提示
+
+同梱の [assets/reading-script-v1.md](assets/reading-script-v1.md) を人間にそのまま提示する。
+本文は正文であり、人間が読みやすいよう言い換えたり要約したりしない
+（`reference_text` と完全一致させる必要があるため）。約 330 字・45〜60 秒を目安と伝える。
+
+## 2. 録音（2 経路）
+
+どちらでもよい。
+
+- **経路 A（既定）**: iPhone / Mac のボイスメモで原稿を読んでもらい、共有・書き出しで
+  `~/Downloads` へ保存してもらう（AirDrop 含む）。追加権限が要らず、既存の録音習慣と一致する。
+- **経路 B（全自動）**: `ffmpeg -f avfoundation -i ":<device>"` でマイクから直接録音する。
+  利用可能なデバイスは `ffmpeg -f avfoundation -list_devices true -i ""` で確認する
+  （初回のみマイク許可プロンプトが出る）。
+
+## 3. 拾いルール
+
+セットアップ開始時刻の mtime を記録しておき、`~/Downloads` の中で**その時刻以降に更新された**
+最新の音声ファイル（m4a / wav / mp3）を対象にする。ボイスメモの自動命名は録音場所に由来し
+ファイル名からは内容を推定できないため、**ファイル名ではなく mtime で拾う**。
+
+## 4. 送信前ガード（省略不可、ハードルール 2）
+
+外部（fal）へ送信する前に、ローカル whisper で拾った音声を逆文字起こしし、所定原稿（§1）との
+一致度と、長さが 30〜300 秒の範囲かを確認する。目的は文字起こしの精度検証ではなく、
+**誤ファイル（別録音・他人の声・私的な音声）を外部サービスへ誤送信しないための照合**である。
+
+- whisper.cpp の実行ファイル・モデル探索は
+  [../analyze-footage/media-and-transcript.md](../analyze-footage/media-and-transcript.md) の
+  「層 2: whisper.cpp」節と同じ探索順・同じ呼び出し規約を流用する（新しい探索ロジックを作らない）
+- 一致度が低い、または長さが範囲外なら**送信せず停止**し、録音のやり直しを人間に案内する
+- 照合をスキップしてよいのはオーナーが明示的に指示した場合のみで、その場合も `meta.json` の
+  `reference.verification` に `"skipped by owner instruction (<日付>)"` のように理由と日付を記録する
+  （既定は照合ありのまま変えない）
+
+## 5. クローン（fal `clone-voice/1.7b`）
+
+`FAL_KEY` は `~/.config/akari-video/credentials.env` から読む（manage-connections 経由のみ。
+ハードルール 5）。参照音声を data URI にエンコードし、`reference_text` に §1 の原稿本文をそのまま
+渡して `fal-ai/qwen-3-tts/clone-voice/1.7b` を呼ぶ。応答の `speaker_embedding.url` が
+声プロファイル資産（`embedding_source_url`）になる。**有償操作**なので、実行前に対象・使う手・理由・
+代替案・費用・待ち時間・外部送信・provenance を宣言し、明示承認を得てから送信する
+（[../manage-connections/SKILL.md](../manage-connections/SKILL.md) の Decision Communication Contract
+と同型。クローンは声につき通常 1 回のみで費用は僅少だが、宣言自体は省略しない）。
+
+## 6. 保存
+
+`~/.config/akari-video/voice-profiles/<name>/` に以下を保存する（`credentials.env` と同じ
+ユーザーレベル・git 管理外）。
+
+- `embedding.safetensors`（または `embedding_source_url` を meta.json に記録し、資産は fal 側 URL
+  参照のままでもよい。実装は [bin/generate-narration.mjs](bin/generate-narration.mjs) の
+  fal-qwen3 アダプタが `meta.json` の `embedding_source_url` を読む前提に合わせる）
+- `ref-recording.<ext>`（送信した参照音声そのもの）
+- `meta.json`:
+  - `profile`: プロファイル名
+  - `created_at`: ISO8601
+  - `reference.sha256`: 参照音声のハッシュ
+  - `reference.script_version`: 使用した原稿バージョン（例 `v1`）
+  - `reference.verification`: whisper 照合の結果、またはスキップの記録（§4）
+  - `consent`: 本人が本人の声のプロファイル作成を明示指示したことの記録（**必須**。ハードルール 1）
+  - `reference_text`: fal に渡した参照テキスト（§1 の原稿本文と同一）
+  - `embedding_source_url`: fal から得た speaker embedding の URL
+
+## 7. 検収
+
+短文 1 本（数十文字程度、$0.01 未満）を fal-qwen3 アダプタで試し生成し、`afplay` 等で人間に耳確認して
+もらう。OK であればプロファイルは有効化完了。似度が不足する場合は、静かな環境で 30〜60 秒のナレ調
+録音を撮り直してプロファイルを作り直す（NG 判定はその後で行う）。

package/vendor/skills/harvest-asset/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: harvest-asset
+description: 案件で作った高コスト・再利用価値の高いオーバーレイ、3D、モーション、テロップ、サムネ構図、音源、B ロールを AKARI Video の assets ライブラリへ素材化するときに発動する。入庫判定、meta.json 下書き、preview、INDEX 更新、検証を行う。
+---
+
+# 素材化ワークフロー
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+順序を変えず、導出できる情報を人へ質問しない。
+
+## 1. 入庫基準を判定する
+
+**「生成コストが高い、または生成不能なものだけ」を入れる。** 次のどちらも満たさなければ収穫を中止し、理由を報告する。
+
+- 自然言語から毎回すぐ再生成できない。例: license 済み 3D model、多要素の複雑 motion、完成度の高い telop / thumbnail 構図、音源、B-roll。
+- 再利用時に、保存・検索・license 管理の価値が生成コストを上回る。
+
+単純字幕、色違いだけ、素朴な fade / slide、案件固有文言を差し替えただけの断片は入れない。既存 asset と本質的に同じ場合も variant を増やさず、既存 asset の knob で表せるかを先に確認する。
+
+## 2. 作業用 package と `meta.json` 下書きを作る
+
+source fragment と同階層の依存 asset を読み、作業用一時ディレクトリへ自己完結した package を組む。最終配置前に次を自動抽出する。
+
+### CSS 変数 → `knobs`
+
+1. fragment 内の `--name: value` と `var(--name, fallback)` を列挙する。
+2. 重複を除き、runtime 所有の `--x`、`--y`、`--scale`、`--rotate` と素材固有 knob を区別する。
+3. default は宣言値または fallback から取り、fragment と preview の確認に使う。schema v0 にない `default` field は `meta.json` へ追加せず、値を発明しない。
+4. 型を次の語彙へ機械的に寄せる。
+   - 色値 → `color`
+   - 数値 + 単位 → `slider`。`min` / `max` は根拠が抽出できる場合だけ付ける
+   - media URL / `src` → `media`
+   - boolean の表示切替 → `checkbox`
+   - 有限の選択肢がコードから読める → `dropdown`
+   - それ以外の置換可能文字列 → `text`
+5. `group` と `label` は variable 名と利用箇所から生成する。曖昧な推論は下書きに注記し、人へ新しい質問を増やさない。
+
+### 依存 → `requires` と同梱対象
+
+- `<script src>`、module import、`@import`、`url()`、`src` / `href`、Three.js addon / decoder、font、model、texture、audio、video を走査する。
+- package / runtime 名は `requires` へ、相対 file は copy 対象へ分ける。
+- CDN / remote URL はそのまま採用せず、license を確認して local 化するか入庫を止める。
+- file が存在しない参照、fragment 外へ抜ける相対 path、未使用依存を残さない。
+
+### その他の自動導出
+
+- `id`: source 名と内容から kebab-case で生成する。
+- `category`: `3d` / `motion` / `telop` / `audio` / `broll` / `font` / `thumbnail` から単一カテゴリを内容から選ぶ。横断軸は `tags` にする。サムネイルの HTML 文字組テンプレは `thumbnail`（背景差し替え前提で、文字組レイヤーだけを素材化する）。
+- `title` / `description` / `tags`: 見た目、役割、aspect、scene を source と利用文脈から要約する。
+- `provenance`: origin project、元 path、生成手、prompt、日時を既存情報から埋める。分からない値を捏造しない。
+- media の寸法、duration、codec、model 情報は `sips`、`ffprobe`、利用可能な GLB inspector などで読める場合だけ確認し、description / tags / preview 判断へ使う。schema にないトップレベル field は追加しない。
+- `author` は既知の project / git 情報から、`price` は現行契約どおり `null` とする。
+
+`meta.json` は `docs/contract-2026-07-13-asset-library.md` の schema v0 に合わせ、正式 key `when_to_use` を使う。依頼文中の `when_use` はこの key の意味と扱う。
+
+## 3. 人間判断が必要な 4 項目だけを聞く
+
+自動抽出結果を短く見せ、次の 4 項目を一度に質問する。それ以外は質問しない。
+
+1. **when_use** → `when_to_use`: どの scene / 目的で使うか。
+2. **ai_usage**: AI が変えてよい部分、守る部分、禁止する改変。
+3. **license**: SPDX、commercial scope、attribution 要否、AI training 可否。license 不明を既定許可にしない。
+4. **登録先スコープ**: `local`（そのプロジェクトのみ）/ `shared`（上位ディレクトリの `.akari/assets/`、事業・組織単位）/ `user`（`~/.akari/assets/`、全プロジェクト共通の定番）/ `builtin`（製品リポ。昇格は PR 経路）。目安を添えて聞く: プロジェクト固有の文言・素材が残るなら `local`、汎用化できたなら `user`。黙って `builtin` に入れない。
+
+回答を `meta.json` に反映する。license が確定しない asset はどの層にも入れない。
+
+## 4. `preview.png` を生成する
+
+- HTML / CSS: 単一の preview harness へ fragment を置き、local font / image の load を待って headless Chrome で撮る。動画 timing は代表時刻へ seek する。
+- 3D: model、material、texture が読める代表 pose を使う。現行 Three.js live runtime が未整備でも、実物ではない代替画像を model preview と偽らない。
+- B-roll / video: `ffmpeg` で内容を代表する frame を選ぶ。
+- audio: waveform と title / duration を読める preview を作る。
+- thumbnail / still: 元 asset を aspect を壊さず preview canvas へ収める。
+
+preview は中身を識別するためのものとし、source と違う架空の完成図を生成しない。schema または category INDEX に寸法規約が追加されていたら、それを優先する。
+
+## 5. 選ばれたスコープの `assets/<category>/` へ配置する
+
+配置先は**登録先スコープ（手順 3 で確定）の** `assets/<category>/<id>/` とし、階層を増やさない。スコープの実ディレクトリ（`local` = プロジェクト内 / `shared` = 上位の `.akari/assets/` / `user` = `~/.akari/assets/`）が無ければ category と INDEX.md ごと新設する。層が違っても構造・meta.json v0・validator は同一。最低限、次をそろえる。
+
+- `meta.json`
+- `preview.png`
+- 実体。HTML 表現は `fragment.html`、ほかは model / media 本体
+- fragment が参照する local dependency
+
+同名 directory が既にあれば上書きしない。内容を比較し、更新か新 ID かの明示判断を得る。採用時は library 外への symlink を残さず、package を自己完結させる。
+
+## 6. category `INDEX.md` を更新する
+
+`assets/<category>/INDEX.md` に、ID 順または既存の並び規則を守って 1 行追加する。
+
+```text
+<id> — <何で、どんな場面向けかを一文で>
+```
+
+重複行を作らない。新 category のときだけ `assets/INDEX.md` にもカテゴリ説明を追加する。
+
+## 7. validator で検証する
+
+まず `packages/schemas/bin/validate-asset.mjs` と `packages/schemas/asset-meta.schema.json` の存在、script 内の usage を確認する。現行 usage では、次のように対象 package を渡す。
+
+```sh
+node packages/schemas/bin/validate-asset.mjs "assets/<category>/<id>"
+```
+
+将来 usage が変わっていれば script を正とし、引数を推測しない。失敗時は `meta.json`、最小 3 点、category 一致、relative dependency、INDEX を直し、成功するまで再実行する。
+
+script または schema がまだない場合、成功扱いにせず成果報告へ次をそのまま残す。
+
+```text
+後で実行: node packages/schemas/bin/validate-asset.mjs（validator / schema 作成後）
+```
+
+## よくある間違い
+
+- 「きれいにできた」だけで、毎回生成できる単純表現を入庫する。
+- CSS 変数や依存を人へ転記させる。
+- `when_to_use` を `when_use` という非 schema key で保存する。
+- slider の min / max、license、provenance を推測で埋める。
+- CDN や案件 directory への相対参照を残す。
+- 1 asset を複数 category へ複製する。
+- 登録先スコープを聞かず、黙って `builtin`（製品リポ）へ入庫する。
+- プロジェクト固有の文言・画像が残ったまま `user` / `builtin` へ入れて、他プロジェクトで使えない資産を作る。
+- preview を作らず、または実体と違う mock を preview にする。
+- INDEX を更新せず、grep で発見不能にする。
+- validator がない状態を validation pass と報告する。
+
+## 根拠
+
+- 入庫基準、schema、構造、収穫: `docs/contract-2026-07-13-asset-library.md`
+- authoring hard rules: [../overlay-authoring/SKILL.md](../overlay-authoring/SKILL.md)

package/vendor/skills/manage-connections/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: manage-connections
+description: AKARI Video の生成プロバイダ・SNS 接続・API キー参照・モデル選択・コスト承認ポリシーを一元管理する。初回セットアップ、接続状態の確認、provider やモデルの追加、有償生成・外部公開の実行前ゲートで発動し、`.akari/connections.json` と無償・読み取り専用の doctor を扱う。
+---
+
+# FORBIDDEN 級ハードルール
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+次の規則は詳細手順より常に優先する。
+
+1. **キーの値を git 管理下ファイル・HTML・ログ・会話に出さない。** 表示は常にマスク
+2. **credentials.env 以外からキーを探索しない。チャットでキーの提示を求めない。**
+   置き場と KEY 名を案内し、人間が置く
+3. **keychain / 外部 vault を必須依存にしない**（オプションバックエンドとしてのみ将来検討）
+4. **doctor は無償・読み取り専用のみ。実生成テストはしない**（保留裁定 2026-07-17）
+5. **有償操作は見積 → 明示承認まで実行しない**（edit-plan の Decision Communication
+   Contract と同型）。予算上限の超過見込みで実行前に停止する
+6. **リアルタイムフック監視（PreToolUse 等）を採用しない。** 状態は JSON、伝達は git 正味差分
+7. **connections.json に無い接続を消費側スキルが使わない**（本スキルが唯一の入口。
+   42・70 系の契約はこのルールを継承する）
+
+# 実行順リーフ
+
+1. プロジェクトの `.akari/connections.json` を読み、使う provider と
+   `models.default / allowed`、`policy` を確認する。レジストリに無い接続や allowed 外のモデルを
+   使わない。
+2. 前回の `doctor` 結果を提示する。再確認を明示された場合だけ、プロジェクトルートで
+   `node <このスキルのディレクトリ>/bin/doctor.mjs` を実行する。別プロジェクトを確認する場合は
+   そのプロジェクトルート、または connections.json のパスを第 1 引数に渡す。
+3. `~/.config/akari-video/credentials.env` が無ければ、doctor が示す置き場・KEY 名・取得先 URL を
+   人間へ案内して停止する。代理取得・代理書き込みをしない。テストで差し替える場合だけ
+   `AKARI_CREDENTIALS_FILE` にファイルパスを指定する。
+4. provider を追加する場合は、人間が credentials.env に `KEY=VALUE` を 1 行追加し、
+   `.akari/connections.json` の `providers` に値を含まない entry を 1 件追加する。
+   `auth: env-key` の `env` は `${KEY_NAME}` 形式にする。doctor に安全な adapter が無い provider は
+   `unchecked` と正直に残す。
+5. モデルを変更する場合は `models.allowed` を先に確定し、`models.default` はその中から選ぶ。
+   タスク単位の上書きは次の承認ゲートで宣言する。
+6. 有償操作の前に [承認ゲート](../edit-plan/approvals-and-generation.md) と同じ形式で対象、使う手、
+   理由、代替案、見積費用、待ち時間、外部送信、provenance を提示する。明示承認が得られるまで
+   実行せず、未設定の予算上限や超過見込みがあれば停止する。
+
+doctor は connections.json の `doctor` ブロックを書き戻し、プロジェクトルートへ読み取り専用の
+`connections-report.html` を生成する。レポートに表示する資格情報は「設定済み（マスク）」または
+「未設定」の存在有無だけとし、HTTP 応答本文やキー値を表示しない。
+
+## memory 接続の管理
+
+`.akari/connections.json` の `memory` 配列は、生成プロバイダとは別種の接続（外部参照記憶。
+[contract-2026-07-25-memory-connection-v0.md](../../docs/contract-2026-07-25-memory-connection-v0.md)
+が正本）を宣言する。資格情報・課金は発生しない読み取り専用の接続であり、本スキルが
+`providers` と同じレジストリファイルの中で一元管理する。
+
+- **追加**: `memory` 配列へ `{ "name": "<kebab-case>", "root": "<ローカルパス>" }` を最小構成として
+  1 件追加する。`entry`（省略時 `INDEX.md`）・`include`/`exclude`・`read_policy`（省略時
+  `read-only`）は任意。`root` に秘密情報（API キー等）を書かない — 経路情報のみを持つ
+- **削除**: `memory` 配列から該当エントリを取り除くだけ。対になる credentials.env の行は無い
+  （`memory` は `auth`/`env` を持たない）
+- **doctor での表示**: `memory` エントリは `providers` の疎通確認（HTTP 認証チェック等）とは
+  別の軽い確認に限る。`root`（および `root`+`entry`）のパス実在チェックのみを行う、無償・
+  読み取り専用の確認である。有償生成の doctor と同じ「無償・読み取り専用のみ」原則
+  （FORBIDDEN 級ハードルール 4）を継承するが、**`memory` は `doctor` フィールドを持たない
+  スキーマ設計**（永続化する認証状態が無いため）であり、v0 時点の `doctor.mjs` はこの
+  パスチェックを実装しない（データ契約 + スキル規約の確立が v0 の範囲。実装は次段）
+- `root` へ実際にアクセスできない場合も、読む瞬間（research-plan / edit-plan の冒頭・
+  analyze-project の文脈読み合わせ）のスキル実行そのものは止めない（劣化規約は
+  memory-connection-v0 契約 §5 を参照）
+
+## 根拠
+
+- 正本契約: 接続・設定管理契約（2026-07-17）— 非公開の内部記録（`akari-video-internal`）にある
+- first-run・代理取得しない規律: [../setup-library/SKILL.md](../setup-library/SKILL.md)
+- 有償操作の承認ゲート: [../edit-plan/approvals-and-generation.md](../edit-plan/approvals-and-generation.md)
+- レジストリ検証: `node packages/schemas/bin/validate-connections.mjs .akari/connections.json`

package/vendor/skills/manage-connections/bin/doctor.mjs

@@ -0,0 +1,341 @@
+#!/usr/bin/env node
+
+// 接続レジストリを、無償・読み取り専用の確認だけで更新する。
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const usage = "使い方: node skills/manage-connections/bin/doctor.mjs [プロジェクトルート|connections.json]";
+const argument = process.argv[2];
+
+if (process.argv.length > 3) {
+  console.error(usage);
+  process.exit(2);
+}
+
+if (argument === "--help" || argument === "-h") {
+  console.log(usage);
+  process.exit(0);
+}
+
+const inputPath = path.resolve(argument ?? process.cwd());
+const connectionsPath = inputPath.endsWith(".json")
+  ? inputPath
+  : path.join(inputPath, ".akari", "connections.json");
+const projectRoot = inputPath.endsWith(".json")
+  ? path.dirname(path.dirname(connectionsPath))
+  : inputPath;
+const reportPath = path.join(projectRoot, "connections-report.html");
+const credentialsPath = path.resolve(
+  process.env.AKARI_CREDENTIALS_FILE ?? path.join(os.homedir(), ".config", "akari-video", "credentials.env"),
+);
+const timeoutMs = 5_000;
+
+async function main() {
+  const registry = readRegistry();
+  const credentialState = readCredentials();
+  const checkedAt = new Date().toISOString();
+
+  if (!credentialState.exists) {
+    printCredentialGuide(registry);
+  } else if (!credentialState.securePermissions) {
+    console.warn(`警告: credentials.env の権限は 600 ではありません（現在 ${credentialState.mode}）。chmod 600 ${credentialsPath} を実行してください。`);
+  }
+
+  const results = await Promise.all(
+    registry.providers.map((provider) => inspectProvider(provider, credentialState, checkedAt)),
+  );
+  for (const [index, result] of results.entries()) registry.providers[index].doctor = result.doctor;
+
+  const jsonOutput = `${JSON.stringify(registry, null, 2)}\n`;
+  refuseSecretLeak(jsonOutput, credentialState.values);
+  const htmlOutput = renderReport(registry, results, credentialState, checkedAt);
+  refuseSecretLeak(htmlOutput, credentialState.values);
+
+  fs.writeFileSync(connectionsPath, jsonOutput, "utf8");
+  fs.writeFileSync(reportPath, htmlOutput, "utf8");
+
+  for (const result of results) {
+    console.log(`${result.id}: ${result.doctor.status} — ${result.doctor.detail}`);
+  }
+  console.log(`接続レポート: ${reportPath}`);
+}
+
+function readRegistry() {
+  let value;
+  try {
+    value = JSON.parse(fs.readFileSync(connectionsPath, "utf8"));
+  } catch {
+    throw new Error("connections.json を読めません");
+  }
+  if (!isPlainObject(value) || !Array.isArray(value.providers) || !isPlainObject(value.policy)) {
+    throw new Error("connections.json の構造が不正です");
+  }
+  return value;
+}
+
+function readCredentials() {
+  let stat;
+  try {
+    stat = fs.statSync(credentialsPath);
+  } catch (error) {
+    if (error && error.code === "ENOENT") {
+      return { exists: false, securePermissions: false, mode: null, values: new Map(), parseWarnings: [] };
+    }
+    throw error;
+  }
+  if (!stat.isFile()) throw new Error("credentials.env が通常ファイルではありません");
+
+  const mode = (stat.mode & 0o777).toString(8).padStart(3, "0");
+  const values = new Map();
+  const parseWarnings = [];
+  const source = fs.readFileSync(credentialsPath, "utf8");
+  for (const [index, originalLine] of source.split(/\r?\n/).entries()) {
+    const line = originalLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    const separator = line.indexOf("=");
+    if (separator < 1) {
+      parseWarnings.push(index + 1);
+      continue;
+    }
+    const name = line.slice(0, separator).trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+      parseWarnings.push(index + 1);
+      continue;
+    }
+    let value = line.slice(separator + 1).trim();
+    if (
+      value.length >= 2 &&
+      ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'")))
+    ) {
+      value = value.slice(1, -1);
+    }
+    values.set(name, value);
+  }
+  if (parseWarnings.length > 0) {
+    console.warn(`警告: credentials.env の ${parseWarnings.map((line) => `${line} 行目`).join("、")}を KEY=VALUE として読めませんでした。`);
+  }
+  return { exists: true, securePermissions: mode === "600", mode, values, parseWarnings };
+}
+
+async function inspectProvider(provider, credentialState, checkedAt) {
+  const id = typeof provider.id === "string" ? provider.id : "unknown-provider";
+  if (provider.auth === "login" || provider.auth === "oauth-mcp") {
+    return result(id, checkedAt, "unchecked", `${provider.auth} 認証は doctor から疎通確認しません。人間がログイン状態を確認してください。`, false);
+  }
+  if (provider.auth === "none") {
+    const localAdapter = localAdapters[id];
+    if (!localAdapter) {
+      return result(id, checkedAt, "unchecked", "無償・読み取り専用と確認済みの doctor adapter がありません。", true);
+    }
+    const doctor = await localAdapter(checkedAt);
+    return { id, configured: true, doctor };
+  }
+  if (provider.auth !== "env-key") {
+    return result(id, checkedAt, "unchecked", "未対応の認証方式のため確認していません。", false);
+  }
+
+  const envName = extractEnvName(provider.env);
+  if (!envName) {
+    return result(id, checkedAt, "unconfigured", "env は ${KEY_NAME} 形式で登録してください。", false);
+  }
+  const secret = credentialState.values.get(envName);
+  if (!credentialState.exists || typeof secret !== "string" || secret.length === 0) {
+    return result(id, checkedAt, "unconfigured", `${envName} は credentials.env に未設定です。`, false);
+  }
+
+  const adapter = adapters[id];
+  if (!adapter) {
+    return result(id, checkedAt, "unchecked", "無償・読み取り専用と確認済みの doctor adapter がありません。", true);
+  }
+  const doctor = await adapter(secret, checkedAt);
+  return { id, configured: true, doctor };
+}
+
+const adapters = {
+  fal: (secret, checkedAt) =>
+    checkGet("https://rest.alpha.fal.ai/billing/user_balance", { Authorization: `Key ${secret}` }, checkedAt),
+  replicate: (secret, checkedAt) =>
+    checkGet("https://api.replicate.com/v1/account", { Authorization: `Bearer ${secret}` }, checkedAt),
+  groq: (secret, checkedAt) =>
+    checkGet("https://api.groq.com/openai/v1/models", { Authorization: `Bearer ${secret}` }, checkedAt),
+  elevenlabs: (secret, checkedAt) =>
+    checkGet("https://api.elevenlabs.io/v1/models", { "xi-api-key": secret }, checkedAt),
+  openrouter: (secret, checkedAt) =>
+    checkGet("https://openrouter.ai/api/v1/key", { Authorization: `Bearer ${secret}` }, checkedAt),
+};
+
+const localAdapters = {
+  voicevox: (checkedAt) => checkVoicevox(checkedAt),
+};
+
+async function checkVoicevox(checkedAt) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch("http://127.0.0.1:50021/version", {
+      method: "GET",
+      headers: { Accept: "application/json" },
+      redirect: "error",
+      signal: controller.signal,
+    });
+    if (response.ok) {
+      let version = "";
+      try {
+        version = String(await response.json()).trim();
+      } catch {
+        version = "";
+      }
+      return {
+        last_checked: checkedAt,
+        status: "ok",
+        detail: version
+          ? `VOICEVOX エンジンが起動中です（version ${version}）。`
+          : "VOICEVOX エンジンが起動中です。",
+      };
+    }
+    return {
+      last_checked: checkedAt,
+      status: "setup_required",
+      detail: "VOICEVOX アプリを起動するか、generate-narration が自動起動します。",
+    };
+  } catch {
+    return {
+      last_checked: checkedAt,
+      status: "setup_required",
+      detail: "VOICEVOX アプリを起動するか、generate-narration が自動起動します。",
+    };
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+async function checkGet(url, headers, checkedAt) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: { ...headers, Accept: "application/json" },
+      redirect: "error",
+      signal: controller.signal,
+    });
+    if (response.body) await response.body.cancel();
+    if (response.ok) {
+      return { last_checked: checkedAt, status: "ok", detail: "認証済み（無償・読み取り専用 GET で確認）。" };
+    }
+    if (response.status === 401 || response.status === 403) {
+      return { last_checked: checkedAt, status: "unauthorized", detail: `認証されませんでした（HTTP ${response.status}）。` };
+    }
+    return { last_checked: checkedAt, status: "unchecked", detail: `認証を判定できませんでした（HTTP ${response.status}）。` };
+  } catch (error) {
+    const timedOut = error instanceof Error && error.name === "AbortError";
+    return {
+      last_checked: checkedAt,
+      status: "unchecked",
+      detail: timedOut ? `接続確認が ${timeoutMs / 1000} 秒でタイムアウトしました。` : "ネットワーク不通のため確認できませんでした。",
+    };
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+function result(id, checkedAt, status, detail, configured) {
+  return { id, configured, doctor: { last_checked: checkedAt, status, detail } };
+}
+
+function extractEnvName(value) {
+  if (typeof value !== "string") return null;
+  const match = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/.exec(value);
+  return match ? match[1] : null;
+}
+
+function printCredentialGuide(registry) {
+  console.log(`credentials.env がありません: ${credentialsPath}`);
+  console.log(`作成後に chmod 600 ${credentialsPath} を実行してください。キーは人間が取得して配置してください。`);
+  for (const provider of registry.providers) {
+    if (provider.auth !== "env-key") continue;
+    const name = extractEnvName(provider.env) ?? "KEY_NAME";
+    const setupUrl = isPlainObject(provider.notes) ? provider.notes.setup_url : null;
+    console.log(`- ${provider.id}: ${name}${typeof setupUrl === "string" ? ` / ${setupUrl}` : ""}`);
+  }
+}
+
+function refuseSecretLeak(output, values) {
+  for (const secret of values.values()) {
+    if (secret && output.includes(secret)) {
+      throw new Error("資格情報の値と一致する文字列が出力に含まれています");
+    }
+  }
+}
+
+function renderReport(registry, results, credentialState, checkedAt) {
+  const resultById = new Map(results.map((item) => [item.id, item]));
+  const cards = registry.providers.map((provider) => {
+    const result = resultById.get(provider.id);
+    const notes = isPlainObject(provider.notes) ? provider.notes : {};
+    const credentialLabel = provider.auth === "env-key"
+      ? result?.configured
+        ? "設定済み（マスク）"
+        : "未設定"
+      : provider.auth === "none"
+        ? "不要（ローカル接続）"
+        : `${provider.auth}（値なし）`;
+    const allowed = Array.isArray(provider.models?.allowed) && provider.models.allowed.length > 0
+      ? provider.models.allowed.join(", ")
+      : "未設定";
+    return `<article class="card status-${escapeHtml(provider.doctor.status)}">
+      <div class="card-head"><h2>${escapeHtml(provider.id)}</h2><span>${escapeHtml(provider.doctor.status)}</span></div>
+      <dl>
+        <dt>用途</dt><dd>${escapeHtml(notes.description ?? "未記入")}</dd>
+        <dt>工程</dt><dd>${escapeHtml(arrayText(notes.workflows))}</dd>
+        <dt>課金モデル</dt><dd>${escapeHtml(notes.billing ?? "未記入")}</dd>
+        <dt>quota</dt><dd>${escapeHtml(notes.quota ?? "未記入")}</dd>
+        <dt>必要スコープ</dt><dd>${escapeHtml(arrayText(notes.scopes))}</dd>
+        <dt>資格情報</dt><dd>${escapeHtml(credentialLabel)}</dd>
+        <dt>既定モデル</dt><dd>${escapeHtml(provider.models?.default ?? "未設定")}</dd>
+        <dt>許可モデル</dt><dd>${escapeHtml(allowed)}</dd>
+        <dt>最終確認</dt><dd>${escapeHtml(provider.doctor.last_checked ?? "未確認")}</dd>
+        <dt>結果</dt><dd>${escapeHtml(provider.doctor.detail ?? "未確認")}</dd>
+      </dl>
+      ${typeof notes.setup_url === "string" ? `<p><a href="${escapeHtml(notes.setup_url)}">設定ページ</a></p>` : ""}
+    </article>`;
+  }).join("\n");
+  const missingGuide = credentialState.exists ? "" : `<section class="guide"><h2>credentials.env の準備</h2><p><code>${escapeHtml(credentialsPath)}</code> を作成し、権限を 600 にしてください。次の KEY 名だけを登録し、値はレポートや会話へ貼らないでください。</p><ul>${registry.providers.filter((provider) => provider.auth === "env-key").map((provider) => {
+    const notes = isPlainObject(provider.notes) ? provider.notes : {};
+    return `<li>${escapeHtml(provider.id)}: <code>${escapeHtml(extractEnvName(provider.env) ?? "KEY_NAME")}</code>${typeof notes.setup_url === "string" ? ` — <a href="${escapeHtml(notes.setup_url)}">取得先</a>` : ""}</li>`;
+  }).join("")}</ul></section>`;
+  const policy = registry.policy;
+  return `<!doctype html>
+<html lang="ja"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; img-src data:; base-uri 'none'; form-action 'none'"><title>AKARI 接続レポート</title><style>
+:root{color-scheme:light dark;font-family:system-ui,sans-serif}body{max-width:1100px;margin:0 auto;padding:32px 20px;background:#10131a;color:#eef2f8}header,.guide,.policy,.card{background:#191f2b;border:1px solid #303a4d;border-radius:14px;padding:20px}.summary{color:#aeb8ca}.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(300px,1fr));gap:16px;margin-top:18px}.card-head{display:flex;align-items:center;justify-content:space-between;gap:12px}.card h2{margin:0}.card-head span{border-radius:999px;padding:4px 10px;background:#384359}.status-ok{border-color:#2d9d78}.status-unauthorized{border-color:#d76a6a}.status-unconfigured{border-color:#d5a941}dl{display:grid;grid-template-columns:8em 1fr;gap:8px;margin-bottom:0}dt{color:#aeb8ca}dd{margin:0;overflow-wrap:anywhere}a{color:#81b7ff}.guide,.policy{margin-top:18px}code{overflow-wrap:anywhere}</style></head>
+<body><header><h1>AKARI 接続レポート</h1><p class="summary">生成日時: ${escapeHtml(checkedAt)}。資格情報は存在有無だけを表示し、値は保存していません。</p></header>
+${missingGuide}
+<section class="policy"><h2>コスト承認ポリシー</h2><dl><dt>通貨</dt><dd>${escapeHtml(policy.currency)}</dd><dt>月間予算上限</dt><dd>${escapeHtml(money(policy.monthly_budget, policy.currency))}</dd><dt>個別承認閾値</dt><dd>${escapeHtml(money(policy.approval_threshold, policy.currency))}</dd><dt>予算消化状況</dt><dd>実績データ未連携</dd></dl></section>
+<main class="grid">${cards}</main></body></html>\n`;
+}
+
+function money(value, currency) {
+  return typeof value === "number" ? `${value} ${currency}` : "未設定（有償操作を停止）";
+}
+
+function arrayText(value) {
+  return Array.isArray(value) && value.length > 0 ? value.join(" / ") : "未記入";
+}
+
+function escapeHtml(value) {
+  return String(value ?? "").replace(/[&<>"']/g, (character) => ({
+    "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;",
+  })[character]);
+}
+
+function isPlainObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+main().catch(() => {
+  console.error("接続確認を完了できませんでした。connections.json の形式と書き込み権限を確認してください。");
+  process.exitCode = 1;
+});