akari-video 0.1.0

package/vendor/skills/address-review/dev-fixtures/fixture-project/review.json

@@ -0,0 +1,100 @@
+{
+  "version": 0,
+  "annotations": [
+    {
+      "id": "a-0001",
+      "createdAt": "2026-07-20T10:00:00.000Z",
+      "sourceT": 12.5,
+      "sourceRange": null,
+      "timelineT": null,
+      "target": null,
+      "text": "BGMをもう少し下げてほしい",
+      "input": "typed",
+      "audio": null,
+      "strokes": null,
+      "poses": null,
+      "status": "open",
+      "response": null
+    },
+    {
+      "id": "a-0002",
+      "createdAt": "2026-07-20T10:05:00.000Z",
+      "sourceT": 105.0,
+      "sourceRange": null,
+      "timelineT": null,
+      "target": "cut:1",
+      "text": "字幕をこの位置まで延長してほしい",
+      "input": "session",
+      "audio": "review/sessions/s-0001/audio.wav",
+      "strokes": [
+        {
+          "tool": "pen",
+          "space": "content-rect",
+          "frame": { "sourceT": 105.0, "cutIndex": 1 },
+          "points": [[0.42, 0.31], [0.5, 0.5]],
+          "sessionRef": "s-0001/st-0001"
+        }
+      ],
+      "poses": null,
+      "status": "open",
+      "response": null,
+      "transcript": "ここら辺まで字幕が欲しいなって思います",
+      "session": { "id": "s-0001", "recRange": [3.2, 6.4], "confidence": "high" }
+    },
+    {
+      "id": "a-0003",
+      "createdAt": "2026-07-21T09:00:00.000Z",
+      "sourceT": 20.0,
+      "sourceRange": null,
+      "timelineT": null,
+      "target": "cut:0",
+      "text": "冒頭のカットをもう少し短くしてほしい",
+      "input": "typed",
+      "audio": null,
+      "strokes": null,
+      "poses": null,
+      "status": "addressed",
+      "response": {
+        "summary": "cuts[0].out を 30 から 25 に短縮。edit-lint --media PASS 確認済み。",
+        "action": "edited",
+        "respondedAt": "2026-07-21T09:30:00.000Z"
+      }
+    },
+    {
+      "id": "a-0004",
+      "createdAt": "2026-07-19T08:00:00.000Z",
+      "sourceT": 130.0,
+      "sourceRange": null,
+      "timelineT": null,
+      "target": null,
+      "text": "エンディングにロゴを入れてほしい",
+      "input": "typed",
+      "audio": null,
+      "strokes": null,
+      "poses": null,
+      "status": "resolved",
+      "response": {
+        "summary": "ロゴ素材が assets/ に無く、権利確認も未了のため見送り。素材が揃ったら再度チケットを切ってください。",
+        "action": "declined",
+        "respondedAt": "2026-07-19T08:10:00.000Z"
+      }
+    },
+    {
+      "id": "a-0005",
+      "createdAt": "2026-07-22T11:00:00.000Z",
+      "sourceT": 200.0,
+      "sourceRange": null,
+      "timelineT": null,
+      "target": null,
+      "text": "[要確認] 停止位置（source 200.0s）での発話「これで合ってますかね」— 編集指示か動作確認の独り言か判別できない。対応不要なら resolved にしてください。",
+      "input": "session",
+      "audio": "review/sessions/s-0002/audio.wav",
+      "strokes": null,
+      "poses": null,
+      "status": "open",
+      "response": null,
+      "transcript": "えーと、これで合ってますかね",
+      "session": { "id": "s-0002", "recRange": [11.0, 14.5], "confidence": "low" }
+    }
+  ]
+}

package/vendor/skills/address-review/test/review-store.test.mjs

@@ -0,0 +1,201 @@
+import assert from "node:assert/strict";
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
+
+import {
+  locateAnnotations,
+  needsConfirmation,
+  parseReviewDocument,
+  respondToAnnotation,
+} from "../bin/core/review-store.mjs";
+
+const execFileAsync = promisify(execFile);
+const listCli = fileURLToPath(new URL("../bin/list.mjs", import.meta.url));
+const respondCli = fileURLToPath(new URL("../bin/respond.mjs", import.meta.url));
+const fixtureProject = fileURLToPath(new URL("../dev-fixtures/fixture-project", import.meta.url));
+
+async function withTempProject(context) {
+  const temporary = await fs.mkdtemp(path.join(os.tmpdir(), "address-review-"));
+  context.after(() => fs.rm(temporary, { recursive: true, force: true }));
+  await fs.cp(fixtureProject, temporary, { recursive: true });
+  return temporary;
+}
+
+async function readReview(projectRoot) {
+  return fs.readFile(path.join(projectRoot, "review.json"), "utf8");
+}
+
+test("locateAnnotations は波括弧・引用符を含む text でも要素境界を正しく特定する", () => {
+  const source = JSON.stringify({
+    version: 0,
+    annotations: [
+      { id: "a-0001", status: "open", text: 'これは "引用" と { 波括弧 } を含む \\ バックスラッシュ' },
+      { id: "a-0002", status: "open", text: "普通のテキスト", nested: { points: [[0, 1], [1, 0]] } },
+    ],
+  });
+  const elements = locateAnnotations(source);
+  assert.equal(elements.length, 2);
+  assert.equal(elements[0].value.id, "a-0001");
+  assert.equal(elements[1].value.id, "a-0002");
+  assert.equal(source.slice(elements[0].start, elements[0].end), JSON.stringify(JSON.parse(source).annotations[0]));
+});
+
+test("needsConfirmation は text 冒頭の [要確認] を検出する（前後空白を許容）", () => {
+  assert.equal(needsConfirmation({ text: "[要確認] 曖昧です" }), true);
+  assert.equal(needsConfirmation({ text: "  [要確認] 先頭に空白" }), true);
+  assert.equal(needsConfirmation({ text: "普通の指示" }), false);
+  assert.equal(needsConfirmation({ text: "" }), false);
+});
+
+test("respondToAnnotation: open → addressed が原子的に書け、他 annotation はバイト不変", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const before = await readReview(projectRoot);
+
+  const result = await respondToAnnotation(path.join(projectRoot, "review.json"), {
+    id: "a-0001",
+    action: "edited",
+    summary: "BGMを -6dB 下げました",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, true);
+  assert.equal(result.annotation.status, "addressed");
+  assert.deepEqual(result.annotation.response, {
+    summary: "BGMを -6dB 下げました",
+    action: "edited",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+
+  const after = await readReview(projectRoot);
+  const beforeDoc = parseReviewDocument(before);
+  const afterDoc = parseReviewDocument(after);
+  for (const annotation of beforeDoc.annotations) {
+    if (annotation.id === "a-0001") continue;
+    const afterElement = locateAnnotations(after).find((element) => element.value.id === annotation.id);
+    const beforeElement = locateAnnotations(before).find((element) => element.value.id === annotation.id);
+    assert.equal(afterElement.raw, beforeElement.raw, `${annotation.id} のバイト列が変化した`);
+  }
+  assert.equal(afterDoc.annotations.length, beforeDoc.annotations.length);
+});
+
+test("respondToAnnotation: resolved 対象は拒否し review.json は無変更", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const before = await readReview(projectRoot);
+  const result = await respondToAnnotation(path.join(projectRoot, "review.json"), {
+    id: "a-0004",
+    action: "edited",
+    summary: "test",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, false);
+  assert.equal(result.code, "not-open");
+  assert.equal(await readReview(projectRoot), before);
+});
+
+test("respondToAnnotation: addressed 対象は拒否し review.json は無変更", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const before = await readReview(projectRoot);
+  const result = await respondToAnnotation(path.join(projectRoot, "review.json"), {
+    id: "a-0003",
+    action: "declined",
+    summary: "test",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, false);
+  assert.equal(result.code, "not-open");
+  assert.equal(await readReview(projectRoot), before);
+});
+
+test("respondToAnnotation: 未知の id は拒否し review.json は無変更", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const before = await readReview(projectRoot);
+  const result = await respondToAnnotation(path.join(projectRoot, "review.json"), {
+    id: "a-9999",
+    action: "edited",
+    summary: "test",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, false);
+  assert.equal(result.code, "unknown-id");
+  assert.equal(await readReview(projectRoot), before);
+});
+
+test("respondToAnnotation: summary 欠落は拒否し review.json は無変更", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const before = await readReview(projectRoot);
+  const result = await respondToAnnotation(path.join(projectRoot, "review.json"), {
+    id: "a-0001",
+    action: "edited",
+    summary: "   ",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, false);
+  assert.equal(result.code, "missing-summary");
+  assert.equal(await readReview(projectRoot), before);
+});
+
+test("respondToAnnotation: 不正な action は拒否し review.json は無変更", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const before = await readReview(projectRoot);
+  const result = await respondToAnnotation(path.join(projectRoot, "review.json"), {
+    id: "a-0001",
+    action: "approved",
+    summary: "test",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, false);
+  assert.equal(result.code, "invalid-action");
+  assert.equal(await readReview(projectRoot), before);
+});
+
+test("respondToAnnotation: review.json が無ければ拒否する", async (context) => {
+  const temporary = await fs.mkdtemp(path.join(os.tmpdir(), "address-review-empty-"));
+  context.after(() => fs.rm(temporary, { recursive: true, force: true }));
+  const result = await respondToAnnotation(path.join(temporary, "review.json"), {
+    id: "a-0001",
+    action: "edited",
+    summary: "test",
+    respondedAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(result.ok, false);
+  assert.equal(result.code, "no-review");
+});
+
+test("CLI list --all-open は [要確認] をスキップし、その旨を報告する", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const { stdout } = await execFileAsync(process.execPath, [listCli, projectRoot, "--all-open", "--json"]);
+  const result = JSON.parse(stdout);
+  assert.deepEqual(result.targets.map((a) => a.id).sort(), ["a-0001", "a-0002"]);
+  assert.deepEqual(result.skipped.map((a) => a.id), ["a-0005"]);
+});
+
+test("CLI list --ids は明示指定なら [要確認] も対象にする", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const { stdout } = await execFileAsync(process.execPath, [listCli, projectRoot, "--ids", "a-0005", "--json"]);
+  const result = JSON.parse(stdout);
+  assert.deepEqual(result.targets.map((a) => a.id), ["a-0005"]);
+  assert.deepEqual(result.notFound, []);
+});
+
+test("CLI respond は成功時 exit 0、ガード拒否時 exit 1 を返す", async (context) => {
+  const projectRoot = await withTempProject(context);
+  const ok = await execFileAsync(process.execPath, [
+    respondCli, projectRoot, "--id", "a-0002", "--action", "declined", "--summary", "見送り", "--json",
+  ]);
+  assert.equal(JSON.parse(ok.stdout).ok, true);
+
+  await assert.rejects(
+    execFileAsync(process.execPath, [
+      respondCli, projectRoot, "--id", "a-0004", "--action", "edited", "--summary", "test", "--json",
+    ]),
+    (error) => {
+      assert.equal(error.code, 1);
+      assert.equal(JSON.parse(error.stdout).code, "not-open");
+      return true;
+    },
+  );
+});

package/vendor/skills/analyze-footage/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: analyze-footage
+description: 動画素材 1 本から 720p プロキシ、ローカル既定の文字起こし（Mac は macOS SpeechAnalyzer / 共通は whisper.cpp・クラウドは承認制）、視認済みキーフレーム、編集イベント、人物関連トラックを作り、analysis.json v0 にまとめるスキル。新しい撮影素材を取り込むとき、素材単体の編集前分析を頼まれたとき、または edit-plan の前処理として素材ごとの分析が必要なときに使う。
+---
+
+# 素材 1 本を分析する
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+## ハードルール
+
+- 1 回の実行で扱う素材は 1 本に限定し、全時刻を未カット素材の source 秒で記録する。
+- 原本を変更しない。成果物は `<source-dir>/analysis/<source-stem>/` に隔離し、同名素材との衝突を避ける。
+- プロキシは ffmpeg で 720p 枠に収め、文字起こしは 3 層で行う: Mac 既定 = macOS SpeechAnalyzer（26+・swiftc 可）/ 共通フォールバック = whisper.cpp（従来どおり）/ クラウド = `.akari/connections.json` に doctor `ok` で登録済みの ElevenLabs Scribe・Groq を決定カードでの明示承認後にのみ使う。承認なしに外部 API へ音声を送信しない。キーは credentials.env 経由のみで扱い、値をチャット・成果物・ログに出さない。
+- いずれのバックエンドも使えなければ文字を推測せず、`transcript: []` に劣化して理由を報告する。
+- シーン検出と一定間隔の両方でキーフレーム候補を作り、採用する画像は Read で実際に視認してから `note` を書く。
+- `filler | trouble | chapter | highlight | hook` 以外の event を作らない。hook は 5 軸すべてを 1〜5 の整数で採点する。
+- [analysis.schema.json](references/analysis.schema.json) にない補助フィールドを追加しない。Schema 検証と意味検証を通した JSON だけを確定版にする。
+- 人物マットは全素材で作らない。人物演出を使うと決めた素材でだけ実行する任意工程であり、処理時間が実時間の数倍に増える。既定は `tracks.person_matte: null` である。
+- OpenMontage は構造上の参考に限り、AGPL の文章・コードを転写しない。
+- 既存の `.akari/sidecars/` 出力先規約（[workflow.md](workflow.md) 参照）は
+  [project-structure-v0 契約](../../docs/contract-2026-07-25-project-structure-v0.md) の
+  「契約サイドカー（既存）」層の一部であり、同契約が定める `.akari/work/`（エージェント中間物）・
+  `.akari/reports/`（検証証跡）と並ぶ置き場所の一つである。
+
+## 実行順と目次
+
+1. [workflow.md](workflow.md) を読み、入力確認、出力ディレクトリ決定、失敗時の扱いを確定する。
+2. [media-and-transcript.md](media-and-transcript.md) を読み、720p プロキシとローカル文字起こしを作る。
+3. [keyframes-and-review.md](keyframes-and-review.md) を読み、scene + interval 抽出、Read 視認、キーフレーム所見を行う。
+4. [events-and-hooks.md](events-and-hooks.md) を読み、5 種 event と hook の 5 軸スコアを判定する。
+5. （任意）人物演出を使うと決めた素材でだけ [person-matte.md](person-matte.md) を読み、人物マットを生成する。既定は実行しない。
+6. [analysis-json.md](analysis-json.md) を読み、tracks を含む JSON を組み立て、検証後に確定する。
+
+詳細を先読みせず、現在の工程に対応するファイルだけを読む。

package/vendor/skills/analyze-footage/analysis-json.md

@@ -0,0 +1,185 @@
+# analysis.json の組み立てと検証
+
+## 目次
+
+- [最小形と要素](#最小の有効形)
+- [意味制約](#schema-では表せない意味制約)
+- [検証と確定](#検証して確定する)
+
+## 原則
+
+このスキルの `references/analysis.schema.json` を唯一の構造定義として使う。トップレベルと各 object は未知フィールドを許可しないため、作業メモ、信頼度、劣化理由、生成ツール情報を勝手に追加しない。
+
+## 最小の有効形
+
+```json
+{
+  "version": 0,
+  "source": "../../clip.mp4",
+  "transcript": [],
+  "keyframes": [],
+  "events": [],
+  "tracks": {
+    "speakers": [],
+    "faces": [],
+    "person_matte": null
+  }
+}
+```
+
+全 6 トップレベル項目は必須である。配列が空でも省略しない。
+
+## 各要素の形
+
+```json
+{
+  "start": 1.2,
+  "end": 3.4,
+  "text": "発話本文"
+}
+```
+
+`speaker` と `words` は任意であり、確認できた場合だけ次のように追加する。
+
+```json
+{
+  "start": 1.2,
+  "end": 3.4,
+  "text": "発話本文",
+  "speaker": "A",
+  "words": [
+    { "start": 1.2, "end": 1.6, "text": "発話" }
+  ]
+}
+```
+
+[media-and-transcript.md のハルシネーション疑いの判定基準](media-and-transcript.md#ハルシネーション疑いの判定基準)に合致した segment はこの配列に含めない。全 segment が該当する場合は `transcript: []` のまま確定する。
+
+```json
+{
+  "t": 12.0,
+  "path": "keyframes/kf-0001-t12.000.jpg",
+  "note": "画面共有へ切り替わり、資料タイトルが中央に表示されている。",
+  "origin": "scene"
+}
+```
+
+`origin` は任意で、採用元の抽出系統（`scene` / `interval` / `transcript`）を記す。付けられる場合は必ず付ける（トレーサビリティ）。
+
+event は type ごとに許可フィールドが異なる。
+
+```json
+[
+  { "type": "filler", "start": 5.0, "end": 5.8 },
+  { "type": "trouble", "start": 40.0, "end": 55.0, "note": "音声波形が途切れ、直後に話者が聞き返している。" },
+  { "type": "chapter", "t": 60.0, "title": "セットアップ手順" },
+  {
+    "type": "highlight",
+    "start": 312.0,
+    "end": 318.5,
+    "quote": "リリースは 8 月頭で行きます",
+    "reason": "リリース時期を明言（決定事項）",
+    "importance": 4
+  },
+  {
+    "type": "hook",
+    "start": 12.0,
+    "end": 24.0,
+    "score": {
+      "hook": 4,
+      "self_contained": 5,
+      "emotion": 3,
+      "density": 4,
+      "punch": 3
+    }
+  }
+]
+```
+
+tracks の形:
+
+```json
+{
+  "speakers": [
+    { "id": "A", "spans": [[1.2, 3.4]] }
+  ],
+  "faces": [
+    { "speaker": "A", "t": 12.0, "box": [0.1, 0.2, 0.3, 0.5] }
+  ],
+  "person_matte": {
+    "path": "matte/person-matte.webm",
+    "fps": 24,
+    "quality": "balanced",
+    "generated_at": "2026-07-23T01:33:30.069Z",
+    "tool": "vision-person-segmentation"
+  }
+}
+```
+
+`person_matte` は生成・照合済みのときだけ値を入れ、それ以外は `null` にする。生成は任意工程であり、既定は `null` である（[person-matte.md](person-matte.md)）。`path`（マット動画へのパス）と `fps`（マット動画の fps）が必須、`quality` / `generated_at` / `tool` は任意である。相対パスは `analysis.json` のディレクトリ基準とし、区切りは `/` を使う。データ契約は [docs/contract-2026-07-23-analysis-person-matte.md](../../docs/contract-2026-07-23-analysis-person-matte.md) が正本である。
+
+単一パスの文字列（`"mattes/person-alpha.mov"`）は旧形であり、`{ "path": ... }` の糖衣として読み手が受けるが、新しく書かない。face の speaker は対応する `tracks.speakers[].id` に存在させる。
+
+## Schema では表せない意味制約
+
+確定前に次を別途検査する。
+
+- すべての区間で `end > start` である。
+- transcript、word、event、span、face の時刻が source duration 内である。
+- `words` がある場合、その word 区間が親 transcript segment 内にある。
+- transcript、keyframes、events、各 span が source 時刻順である。
+- `speaker` がある transcript と face の speaker ID が tracks と整合する。
+- face box が `[x, y, width, height]` で、`x + width <= 1`、`y + height <= 1` である。
+- `source`、keyframe path、非 null の person_matte の `path` を JSON の位置から解決でき、実ファイルが存在する。
+- person_matte を書いた場合、マット動画の時刻 0 が素材の時刻 0 と一致し、`fps` が実際のマット動画の fps と一致する。
+- JSON number に `NaN`、`Infinity`、文字列化した数値を使っていない。
+
+## 検証して確定する
+
+最初は同じディレクトリの `analysis.json.tmp` に書く。JSON 構文を先に確認する。
+
+```bash
+python3 -m json.tool "$OUT_DIR/analysis.json.tmp" >/dev/null
+```
+
+Python の `jsonschema` がローカルにある場合は Draft 2020-12 として検証する。
+
+```bash
+python3 - ".claude/skills/analyze-footage/references/analysis.schema.json" "$OUT_DIR/analysis.json.tmp" <<'PY'
+import json
+import pathlib
+import sys
+from jsonschema import Draft202012Validator
+
+schema_path, data_path = map(pathlib.Path, sys.argv[1:])
+schema = json.loads(schema_path.read_text(encoding="utf-8"))
+data = json.loads(data_path.read_text(encoding="utf-8"))
+Draft202012Validator.check_schema(schema)
+errors = sorted(
+    Draft202012Validator(schema).iter_errors(data),
+    key=lambda e: "/".join(map(str, e.absolute_path)),
+)
+for error in errors:
+    where = "/".join(map(str, error.path)) or "<root>"
+    print(f"{where}: {error.message}", file=sys.stderr)
+raise SystemExit(1 if errors else 0)
+PY
+```
+
+ローカルに別の Draft 2020-12 対応 validator があればそれを使ってよい。validator を得るために無断でネットワーク導入しない。validator が一つもない場合は構文・構造・意味制約を手作業で照合し、Schema 検証未実施を報告する。
+
+Schema 検証、意味制約、参照ファイル存在確認を通した後だけ、一時ファイルを `analysis.json` へ原子的に置き換える。既存ファイルがある場合は、同じ source の再分析だと確認してから置き換える。
+
+## よくある間違い
+
+- `version` を文字列 `"0"` にする。
+- whisper.cpp の raw JSON を transcript へ直接入れる。
+- ハルシネーション疑いの segment を突合せず transcript に残して確定する。
+- trouble 以外の event に `note` を足す。
+- highlight の `quote` に要約・言い換えを書く（transcript の実発言に忠実にする）。
+- hook score を小数、0、6 以上にする、または 5 軸の一部を省く。
+- 未生成の人物マットを空文字にする。未生成は `null` である。
+- 人物マットの `path` にヘルパーが返した絶対パスをそのまま書く。`analysis.json` のディレクトリ基準へ直す。
+- box を pixel 座標で保存する。
+- Schema が検出しない `end <= start` を残す。
+- backend（使用した文字起こしエンジン）を transcript segment に追加する — analysis.schema.json は `additionalProperties: false` でこのフィールドを許可しない。完了報告に書く（[media-and-transcript.md#provenancebackendの記録](media-and-transcript.md#provenancebackend-の記録)）。