akari-video 0.1.0

package/vendor/skills/compile-review-session/test/compiler.test.mjs

@@ -0,0 +1,458 @@
+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 {
+  proposalToAnnotation,
+  provisionalJudgement,
+  segmentUtterances,
+} from "../bin/core/compiler.mjs";
+import {
+  appendAnnotationLine,
+  nextAnnotationNumber,
+} from "../bin/core/review-store.mjs";
+import {
+  buildCutMap,
+  buildTimelineTrace,
+  parseEventsJsonl,
+  resolveUtteranceReference,
+} from "../bin/core/time-mapping.mjs";
+import {
+  detectVadSpans,
+  restoreWhisperTokenWords,
+  transcribeAudio,
+} from "../bin/core/transcription.mjs";
+
+const execFileAsync = promisify(execFile);
+const compileCli = fileURLToPath(new URL("../bin/compile-review-session.mjs", import.meta.url));
+
+const snapshot = {
+  cuts: [
+    { in: 10, out: 20 },
+    { in: 100, out: 140 },
+  ],
+};
+
+test("timelineT の cut 境界を半開区間で sourceT へ写像する", () => {
+  const map = buildCutMap(snapshot);
+  assert.deepEqual(map.locate(9.5), expectLocation(19.5, 0));
+  assert.deepEqual(map.locate(10), expectLocation(100, 1));
+  assert.deepEqual(map.locate(45), expectLocation(135, 1));
+});
+
+test("tick を正として recT から停止・再生位置を復元する", () => {
+  const { events, warnings } = parseEventsJsonl([
+    '{"recT":0,"type":"start","timelineT":0,"playing":false}',
+    '{"recT":0,"type":"play","timelineT":0}',
+    '{"recT":10,"type":"tick","timelineT":10}',
+    '{"broken":',
+  ].join("\n"));
+  assert.equal(warnings.length, 1);
+  const trace = buildTimelineTrace(events);
+  assert.equal(trace.stateAt(12).timelineT, 12);
+  assert.equal(trace.stateAt(12).playing, true);
+});
+
+test("再生中発話は 3 秒窓内の単一 cut 境界へ解決する", () => {
+  const { events } = parseEventsJsonl([
+    '{"recT":0,"type":"start","timelineT":0,"playing":false}',
+    '{"recT":0,"type":"play","timelineT":0}',
+    '{"recT":9,"type":"tick","timelineT":9}',
+    '{"recT":12,"type":"tick","timelineT":12}',
+  ].join("\n"));
+  const reference = resolveUtteranceReference({
+    utterance: { text: "調整する", recT: [12, 15], words: [] },
+    trace: buildTimelineTrace(events),
+    cutMap: buildCutMap(snapshot),
+  });
+  assert.equal(reference.sourceT, 100);
+  assert.equal(reference.target, "cut:1");
+  assert.equal(reference.resolutionMethod, "rewind-window-boundary");
+  assert.equal(reference.confidence, "high");
+});
+
+test("再生中発話へ近接するストロークを高信頼の frame アンカーとして採用する", () => {
+  const { events } = parseEventsJsonl([
+    '{"recT":0,"type":"start","timelineT":0,"playing":false}',
+    '{"recT":0,"type":"play","timelineT":0}',
+    '{"recT":9,"type":"tick","timelineT":9}',
+    '{"recT":12,"type":"tick","timelineT":12}',
+  ].join("\n"));
+  const stroke = {
+    id: "st-0001",
+    tool: "pen",
+    space: "content-rect",
+    recTStart: 12.4,
+    recTEnd: 13.1,
+    frame: { timelineT: 7.25, sourceT: 777.5, cutIndex: 7 },
+    points: [[0.1, 0.2], [0.8, 0.9]],
+  };
+  const reference = resolveUtteranceReference({
+    utterance: { text: "ここを調整する", recT: [12, 15], words: [] },
+    trace: buildTimelineTrace(events),
+    cutMap: buildCutMap(snapshot),
+    strokes: [stroke],
+  });
+  assert.equal(reference.resolutionMethod, "stroke-pair");
+  assert.equal(reference.timelineT, stroke.frame.timelineT);
+  assert.equal(reference.sourceT, stroke.frame.sourceT);
+  assert.equal(reference.target, "cut:7");
+  assert.equal(reference.confidence, "high");
+  assert.equal(reference.pairedStroke, stroke);
+});
+
+test("停止中発話はアンカーを保ちつつ近接ストロークを添付する", () => {
+  const { events } = parseEventsJsonl([
+    '{"recT":0,"type":"start","timelineT":5,"playing":false}',
+    '{"recT":6,"type":"end","timelineT":5}',
+  ].join("\n"));
+  const stroke = {
+    id: "st-0002",
+    tool: "pen",
+    space: "content-rect",
+    recTStart: 2.2,
+    recTEnd: 2.8,
+    frame: { timelineT: 18, sourceT: 108, cutIndex: 1 },
+    points: [[0.2, 0.3], [0.7, 0.6]],
+  };
+  const reference = resolveUtteranceReference({
+    utterance: { text: "ここを直す", recT: [2, 3], words: [] },
+    trace: buildTimelineTrace(events),
+    cutMap: buildCutMap(snapshot),
+    strokes: [stroke],
+  });
+  assert.equal(reference.resolutionMethod, "stopped-frame");
+  assert.equal(reference.timelineT, 5);
+  assert.equal(reference.sourceT, 15);
+  assert.equal(reference.target, "cut:0");
+  assert.equal(reference.pairedStroke, stroke);
+});
+
+test("annotation へ端点を保った最大100点のストロークと sessionRef を埋め込む", () => {
+  const points = Array.from({ length: 151 }, (_, index) => [index / 150, index / 300]);
+  const pairedStroke = {
+    id: "st-0012",
+    tool: "pen",
+    space: "content-rect",
+    frame: { timelineT: 4, sourceT: 14, cutIndex: 0 },
+    points,
+  };
+  const annotation = proposalToAnnotation({
+    proposal: {
+      transcript: "ここを直す",
+      recRange: [1, 2],
+      reference: {
+        timelineT: 4,
+        sourceT: 14,
+        sourceRange: null,
+        target: "cut:0",
+        confidence: "high",
+        candidates: [],
+        pairedStroke,
+      },
+    },
+    decision: { action: "annotate", reason: "編集指示", text: "ここを直す", confidence: "high" },
+    sessionId: "s-0003",
+    audioPath: "review/sessions/s-0003/audio.wav",
+    createdAt: "2026-07-24T00:00:00.000Z",
+  });
+  assert.equal(annotation.strokes.length, 1);
+  assert.equal(annotation.strokes[0].points.length, 100);
+  assert.deepEqual(annotation.strokes[0].points[0], points[0]);
+  assert.deepEqual(annotation.strokes[0].points.at(-1), points.at(-1));
+  assert.equal(annotation.strokes[0].sessionRef, "s-0003/st-0012");
+  assert.deepEqual(annotation.strokes[0].frame, { sourceT: 14, cutIndex: 0 });
+});
+
+test("CLI が strokes.json を読み annotation へ着地し、破損時は warning へ劣化する", async (context) => {
+  const temporary = await fs.mkdtemp(path.join(os.tmpdir(), "compile-review-strokes-"));
+  context.after(() => fs.rm(temporary, { recursive: true, force: true }));
+  await fs.writeFile(
+    path.join(temporary, "review.json"),
+    '{\n  "version": 0,\n  "annotations": [\n  ]\n}\n',
+  );
+  const sessionsRoot = path.join(temporary, "review", "sessions");
+  await fs.mkdir(sessionsRoot, { recursive: true });
+
+  for (const [sessionId, strokesSource] of [
+    ["s-0001", JSON.stringify({
+      version: 1,
+      strokes: [{
+        id: "st-0001",
+        tool: "pen",
+        space: "content-rect",
+        recTStart: 2.1,
+        recTEnd: 2.7,
+        frame: { timelineT: 6, sourceT: 16, cutIndex: 0 },
+        points: [[0.1, 0.2], [0.8, 0.9]],
+      }],
+    })],
+    ["s-0002", "{broken"],
+  ]) {
+    const sessionDirectory = path.join(sessionsRoot, sessionId);
+    await fs.mkdir(sessionDirectory);
+    await fs.writeFile(path.join(sessionDirectory, "session.json"), JSON.stringify({
+      version: 1,
+      id: sessionId,
+      status: "recorded",
+      audio: "audio.wav",
+      editSnapshot: "edit.snapshot.json",
+      compiledAnnotations: null,
+    }));
+    await fs.writeFile(path.join(sessionDirectory, "edit.snapshot.json"), JSON.stringify({
+      cuts: [{ in: 10, out: 30 }],
+    }));
+    await fs.writeFile(path.join(sessionDirectory, "events.jsonl"), [
+      '{"recT":0,"type":"start","timelineT":0,"playing":false}',
+      '{"recT":0.5,"type":"play","timelineT":0}',
+      '{"recT":4,"type":"end","timelineT":3.5}',
+    ].join("\n"));
+    await fs.writeFile(path.join(sessionDirectory, "transcript.json"), JSON.stringify({
+      version: 1,
+      backend: "fixture",
+      segments: [{
+        start: 2,
+        end: 3,
+        text: "このカットを削除してください",
+        words: [{ start: 2, end: 3, text: "このカットを削除してください" }],
+      }],
+    }));
+    await fs.writeFile(path.join(sessionDirectory, "strokes.json"), strokesSource);
+    await execFileAsync(process.execPath, [compileCli, temporary, "--session", sessionId, "--json"]);
+  }
+
+  const review = JSON.parse(await fs.readFile(path.join(temporary, "review.json"), "utf8"));
+  assert.equal(review.annotations.length, 2);
+  assert.equal(review.annotations[0].strokes[0].sessionRef, "s-0001/st-0001");
+  assert.equal(review.annotations[0].sourceT, 16);
+  assert.equal(review.annotations[1].strokes, null);
+  const damagedReport = await fs.readFile(
+    path.join(sessionsRoot, "s-0002", "compile-report.md"),
+    "utf8",
+  );
+  assert.match(damagedReport, /strokes\.json を無視します/);
+});
+
+test("0.3 秒未満の segment を結合し、文末 word で分割する", () => {
+  const utterances = segmentUtterances([
+    {
+      start: 1,
+      end: 2,
+      text: "一つ目。",
+      words: [{ start: 1, end: 2, text: "一つ目。" }],
+    },
+    {
+      start: 2.2,
+      end: 3,
+      text: "二つ目",
+      words: [{ start: 2.2, end: 3, text: "二つ目" }],
+    },
+  ]);
+  assert.equal(utterances.length, 2);
+  assert.equal(utterances[0].text, "一つ目。");
+  assert.equal(utterances[1].text, "二つ目");
+});
+
+test("fixture の編集指示とテスト発話を暫定判定する", () => {
+  assert.deepEqual(
+    provisionalJudgement("テロップの文字をもう少し大きくしてください").action,
+    "annotate",
+  );
+  assert.deepEqual(
+    provisionalJudgement("えー、これはテストです、音声チェックです").action,
+    "discard",
+  );
+});
+
+test("review.json の既存 annotation バイト列を変更せず新しい行を足す", () => {
+  const existingLine = '    {"id":"a-0001","text":"保持"}';
+  const source = `{\n  "version": 0,\n  "annotations": [\n${existingLine}\n  ]\n}\n`;
+  const updated = appendAnnotationLine(source, { id: "a-0002", text: "追加" });
+  assert.ok(updated.includes(existingLine));
+  assert.equal(updated.split(existingLine).length, 2);
+  assert.deepEqual(JSON.parse(updated).annotations.map((item) => item.id), ["a-0001", "a-0002"]);
+  assert.equal(nextAnnotationNumber(JSON.parse(updated).annotations), 3);
+});
+
+test("whisper token 境界で分断された UTF-8 bytes を連結して word に戻す", () => {
+  const bytes = Buffer.from("テ", "utf8");
+  const words = restoreWhisperTokenWords([
+    {
+      text: bytes.subarray(0, 2).toString("latin1"),
+      offsets: { from: 1000, to: 1100 },
+    },
+    {
+      text: bytes.subarray(2).toString("latin1"),
+      offsets: { from: 1100, to: 1200 },
+    },
+  ], 1, 2);
+  assert.deepEqual(words, [{ start: 1, end: 1.2, text: "テ" }]);
+});
+
+test("発話をまたぐ多段スクラブは発話終端の着地点へ高信頼で解決する", () => {
+  const scrubSnapshot = {
+    cuts: [
+      { in: 0, out: 60 },
+      { in: 1000, out: 1050, at: 60 },
+      { in: 2000, out: 2060, at: 110 },
+    ],
+  };
+  const { events } = parseEventsJsonl([
+    '{"recT":0,"type":"start","timelineT":0,"playing":false}',
+    '{"recT":11.21,"type":"seek","from":0,"to":100.06}',
+    '{"recT":12.72,"type":"seek","from":100.06,"to":104.34}',
+    '{"recT":12.97,"type":"seek","from":104.34,"to":115.17}',
+    '{"recT":12.98,"type":"rate","value":0.9}',
+    '{"recT":13.23,"type":"seek","from":115.17,"to":122.88}',
+    '{"recT":17.32,"type":"seek","from":122.88,"to":71.25}',
+    '{"recT":17.33,"type":"rate","value":1}',
+    '{"recT":20.52,"type":"end","timelineT":71.25}',
+  ].join("\n"));
+  const reference = resolveUtteranceReference({
+    utterance: { text: "この辺りを明るく調整する", recT: [9.22, 17.94], words: [] },
+    trace: buildTimelineTrace(events),
+    cutMap: buildCutMap(scrubSnapshot),
+  });
+  assert.equal(reference.target, "cut:1");
+  assert.ok(Math.abs(reference.sourceT - 1011.25) < 0.05, `sourceT=${reference.sourceT}`);
+  assert.equal(reference.confidence, "high");
+  assert.notEqual(reference.confidence, "low");
+});
+
+test("圧縮タイムスタンプを reject して whisper.cpp へ fallback する", async (context) => {
+  const temporary = await fs.mkdtemp(path.join(os.tmpdir(), "compile-review-vad-"));
+  context.after(() => fs.rm(temporary, { recursive: true, force: true }));
+  const audioPath = path.join(temporary, "audio.wav");
+  await writePcmWav(audioPath, 18, [
+    [1.95, 3.05],
+    [4.65, 6.15],
+    [7.1, 7.45],
+    [8.1, 9.2],
+    [11.95, 12.25],
+    [14.5, 17.85],
+  ]);
+  const vad = await detectVadSpans(audioPath);
+  assert.deepEqual(
+    vad.spans.map(({ start, end }) => [start, end]),
+    [
+      [1.95, 3.05],
+      [4.65, 6.15],
+      [7.1, 7.45],
+      [8.1, 9.2],
+      [11.95, 12.25],
+      [14.5, 17.85],
+    ],
+  );
+  const calls = [];
+  const warnings = [];
+  const transcript = await transcribeAudio({
+    audioPath,
+    transcribers: {
+      speechAnalyzer: async () => {
+        calls.push("speechanalyzer");
+        return {
+          result: {
+            backend: "speechanalyzer",
+            segments: timedSegments([[4.38, 6.4], [14.27, 15.16]]),
+          },
+          reason: null,
+        };
+      },
+      whisper: async () => {
+        calls.push("whisper-cpp");
+        return {
+          result: {
+            backend: "whisper-cpp",
+            segments: timedSegments([[0, 9.22], [9.22, 17.94]]),
+          },
+          reason: null,
+        };
+      },
+    },
+    logger: { warn: (warning) => warnings.push(warning) },
+  });
+
+  assert.deepEqual(calls, ["speechanalyzer", "whisper-cpp"]);
+  assert.equal(transcript.backend, "whisper-cpp");
+  assert.equal(transcript.provenance.backend, "whisper-cpp");
+  assert.equal(transcript.provenance.fallbackFrom, "speechanalyzer");
+  assert.match(transcript.provenance.reason, /coverage=0\.313 .*\/7\.700秒.*< 0\.700/);
+  assert.equal(warnings.length, 1);
+  assert.match(warnings[0], /タイムスタンプ健全性ゲートで結果を破棄/);
+});
+
+test("VAD 発話時間を十分に覆うタイムスタンプはそのまま採用する", async (context) => {
+  const temporary = await fs.mkdtemp(path.join(os.tmpdir(), "compile-review-vad-"));
+  context.after(() => fs.rm(temporary, { recursive: true, force: true }));
+  const audioPath = path.join(temporary, "audio.wav");
+  await writePcmWav(audioPath, 3, [[0.5, 1.5], [2, 2.5]]);
+  let whisperCalled = false;
+  const healthySegments = timedSegments([[0.45, 1.55], [1.95, 2.55]]);
+  const transcript = await transcribeAudio({
+    audioPath,
+    transcribers: {
+      speechAnalyzer: async () => ({
+        result: { backend: "speechanalyzer", segments: healthySegments },
+        reason: null,
+      }),
+      whisper: async () => {
+        whisperCalled = true;
+        throw new Error("健全な tier の後に fallback してはいけません");
+      },
+    },
+    logger: { warn: () => assert.fail("健全なタイムスタンプで warning を出してはいけません") },
+  });
+
+  assert.equal(whisperCalled, false);
+  assert.equal(transcript.backend, "speechanalyzer");
+  assert.deepEqual(transcript.segments, healthySegments);
+  assert.deepEqual(transcript.provenance, { backend: "speechanalyzer" });
+});
+
+function expectLocation(sourceT, cutIndex) {
+  return {
+    ...buildCutMap(snapshot).intervals[cutIndex],
+    timelineT: sourceT < 100 ? sourceT - 10 : sourceT - 90,
+    sourceT,
+  };
+}
+
+function timedSegments(ranges) {
+  return ranges.map(([start, end], index) => ({
+    start,
+    end,
+    text: `発話${index + 1}`,
+    words: [{ start, end, text: `発話${index + 1}` }],
+  }));
+}
+
+async function writePcmWav(file, duration, speechSpans, sampleRate = 16000) {
+  const frameCount = Math.round(duration * sampleRate);
+  const data = Buffer.alloc(frameCount * 2);
+  for (let frame = 0; frame < frameCount; frame += 1) {
+    const time = frame / sampleRate;
+    const voiced = speechSpans.some(([start, end]) => time >= start && time < end);
+    data.writeInt16LE(voiced ? 1000 : 0, frame * 2);
+  }
+  const wav = Buffer.alloc(44 + data.length);
+  wav.write("RIFF", 0);
+  wav.writeUInt32LE(36 + data.length, 4);
+  wav.write("WAVE", 8);
+  wav.write("fmt ", 12);
+  wav.writeUInt32LE(16, 16);
+  wav.writeUInt16LE(1, 20);
+  wav.writeUInt16LE(1, 22);
+  wav.writeUInt32LE(sampleRate, 24);
+  wav.writeUInt32LE(sampleRate * 2, 28);
+  wav.writeUInt16LE(2, 32);
+  wav.writeUInt16LE(16, 34);
+  wav.write("data", 36);
+  wav.writeUInt32LE(data.length, 40);
+  data.copy(wav, 44);
+  await fs.writeFile(file, wav);
+}

package/vendor/skills/create-project/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: create-project
+description: AKARI Video の新規プロジェクトを headless で作成する。`templates/project-default/` を再帰コピーし、雛形バージョンを記録し、安全な場合のみ git 初期化して、作成結果レポート HTML を生成する。アプリ起動は不要。新しい動画プロジェクトを作るとき、または既存フォルダを AKARI Video プロジェクトとして補完するときに使う。
+---
+
+# 新規プロジェクトを作成する
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+## ハードルール
+
+1. **雛形は解決順の 2 択のみ。** 存在しない雛形・カテゴリを捏造しない
+2. **既存ファイルを絶対に上書きしない**（`flag:'wx'`。既存フォルダへの適用は不足分の追加のみ、
+   CLAUDE.md / AGENTS.md には触れない — 自己完結契約 §5 と同じ規律）
+3. **シンボリックリンクはコピーせず警告**
+4. **F18 ガードを内蔵する**: 作成先で `git rev-parse --show-toplevel` を判定し、
+   既存リポ（`_edit` 等）の内側では git init しない。親リポを汚す経路を作らない
+   （Wave 9 `f18-parent-repo-guard` と同じ判定基準）
+5. **git 初期化が安全な場合のみ** init + 単一コミット。それ以外は理由を報告して skip
+6. **雛形バージョン（`AKARI-SKILLS-VERSION`）を記録するだけ**で、既存プロジェクトへの
+   silent update をしない
+7. **アプリ作成とスキル作成の成果物 diff ゼロを保つ**（§3 の共有実装がその手段）
+
+## 実行手順
+
+1. `--template <path>` があればその雛形を使い、省略時はリポ checkout の `templates/project-default/` を使う。この 2 択以外の雛形解決を行わない。
+2. 次の CLI を実行する。
+
+   ```sh
+   node skills/create-project/bin/create-project.mjs <target-dir> [--template <path>]
+   ```
+
+3. 標準出力に表示された作成結果レポート HTML のパスを確認する。レポートは読み取り専用で、コピー、フォールバック補完、シンボリックリンクのスキップ、雛形バージョン、git 初期化の結果を記録する。
+
+## 使い方
+
+```sh
+node skills/create-project/bin/create-project.mjs <target-dir> [--template <path>]
+```
+
+- `<target-dir>`: 作成先ディレクトリ。新規でも既存の非空フォルダでもよい。既存ファイルは上書きしない。
+- `--template <path>`: 雛形ディレクトリを明示指定する。省略時はリポ checkout の `templates/project-default/` を使う。それ以外の解決手段はない。
+
+## intake.json（進め方フォームの保存先）
+
+作成直後の `.akari/intake.json` は `status: "draft"`・空 `tasks` から始まる（契約: `packages/schemas/intake.schema.json`）。プロジェクトの CLAUDE.md には intake の規律を追記する — `status: "submitted"` なら `tasks` / `target` / `autonomy` に従い、`autonomy: "checkpoint"`（既定）なら企画承認・書き出し前などの要所で人に確認し、`status: "draft"` のままなら進め方をフォームまたは対話で確定させてから進める。

package/vendor/skills/create-project/bin/create-project.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { createProject } from '../../../packages/project-scaffold/src/index.mjs';
+
+const usage = '使い方: node skills/create-project/bin/create-project.mjs <target-dir> [--template <path>]';
+
+function parseArguments(args) {
+    let target;
+    let template;
+
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === '--template') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new Error(`${usage}\n--template にはパスが必要です。`);
+            }
+            template = value;
+            index += 1;
+        } else if (argument.startsWith('-')) {
+            throw new Error(`${usage}\n不明なオプションです: ${argument}`);
+        } else if (target === undefined) {
+            target = argument;
+        } else {
+            throw new Error(`${usage}\n作成先は 1 つだけ指定してください。`);
+        }
+    }
+
+    if (target === undefined) {
+        throw new Error(usage);
+    }
+    return { target, template };
+}
+
+async function directoryHasFile(directory, relativeFile) {
+    try {
+        return (await fs.stat(path.join(directory, relativeFile))).isFile();
+    } catch {
+        return false;
+    }
+}
+
+async function main() {
+    const { target, template } = parseArguments(process.argv.slice(2));
+    const targetDir = path.resolve(process.cwd(), target);
+    const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+    const templateDir = template
+        ? path.resolve(process.cwd(), template)
+        : path.resolve(scriptDirectory, '../../../templates/project-default');
+
+    try {
+        const templateStat = await fs.stat(templateDir);
+        if (!templateStat.isDirectory()) {
+            throw new Error('not a directory');
+        }
+    } catch {
+        throw new Error(`雛形が見つかりません: ${templateDir}`);
+    }
+
+    // スキル正本は自分の 2 つ上（リポ checkout なら skills/、プロジェクト内なら .claude/skills/）。
+    const skillsSourceDir = path.resolve(scriptDirectory, '../..');
+    const hasSkills = await directoryHasFile(skillsSourceDir, 'analyze-footage/SKILL.md');
+    if (!hasSkills) {
+        console.warn(`スキル正本が見つからないため、スキル同梱をスキップします: ${skillsSourceDir}`);
+    }
+    const schemasSourceDir = path.resolve(scriptDirectory, '../../../packages/schemas');
+    const hasSchemas = await directoryHasFile(schemasSourceDir, 'analysis.schema.json');
+
+    const result = await createProject(targetDir, templateDir, hasSkills
+        ? { skillsSourceDir, schemasSourceDir: hasSchemas ? schemasSourceDir : undefined }
+        : {});
+    console.log(`プロジェクトを作成しました: ${result.destination}`);
+    console.log(`コピー: ${result.copy.copiedFiles.length} 件`);
+    console.log(`フォールバック補完: ${result.fallback.writtenFiles.length} 件`);
+    console.log(`シンボリックリンクのスキップ: ${result.copy.skippedSymlinks.length} 件`);
+    console.log(`スキル同梱: ${hasSkills ? `実施（${skillsSourceDir}）` : 'スキップ'}`);
+    console.log(`git: ${result.git.action}`);
+    console.log(`作成結果レポート: ${result.reportPath}`);
+}
+
+main().catch(error => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});

package/vendor/skills/edit-lint/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: edit-lint
+description: edit.json と任意の analysis.json / captions.json / メディアを決定的 CLI で検査し、PASS 後のフレーム視認とレポートまで QA を完了する。edit.json を書いた、または変更した直後、書き出し前、レビュー指摘を反映した後の再確認で使う。
+---
+
+# 編集結果を lint して QA を閉じる
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+## ハードルール
+
+1. **決定的であること**: 同一入力 → 同一出力。LLM 判断・乱数・現在時刻を判定に混ぜない
+   （`checked_at` の記録は可・判定には使わない）
+2. **外部 npm 依存ゼロ**。ffmpeg / ffprobe は**本体直叩き**（ラッパーライブラリ禁止）
+3. **書き込みは `.akari/lint.json` と `.akari/reports/` のみ**。edit.json を自動修正しない
+   （fix は人間/エージェントの編集として git diff に出す）
+4. **ネットワーク禁止**（完全ローカル・headless-first 不変条件どおりアプリ不要）
+5. **外部候補のコード転写禁止**（loudcheck 等は設計参考のみ。survey の転記条件に
+   関わらず本 CLI は全量自作 — 依存ゼロ規律と同根）
+6. **analysis.json / captions.json / `.akari/intake.json` 不在をエラーにしない**（skipped 報告。
+   プロジェクトの成長段階に関わらず常に走れる）
+7. **`--media` なしの既定実行はメディアをデコードしない**（起動・CI で常用できる速さを守る）
+8. **視認に使うキーフレーム静止画・QA 生成物、ad-hoc な一時検証スクリプトはプロジェクトルート
+   直下に書かない**。前者は `.akari/reports/`、後者は `.akari/work/` へ置く
+   （[project-structure-v0 契約](../../docs/contract-2026-07-25-project-structure-v0.md) §1）
+
+## 実行手順
+
+1. edit.json を保存した直後に、リポジトリルートから次を実行する。
+
+   ```sh
+   node packages/edit-lint/bin/edit-lint.mjs <project-root|edit.json>
+   ```
+
+2. exit code と `<project>/.akari/lint.json` を確認する。`0` は PASS、`1` は FAIL、`2` は入力や実行環境のエラーを表す。
+3. FAIL なら `findings[]` を上から読み、指摘された edit.json、参照ファイル、overlay HTML、captions.json を手で修正する。CLI に自動修正させない。
+4. 同じコマンドを再実行し、error finding がなく `verdict: "pass"` になるまで繰り返す。analysis.json または captions.json が無い検査は `skipped[]` で確認する。
+5. PASS 後に、カット境界と overlay の開始・終了フレームを実際に視認する。機械検査の PASS を意味的な品質確認の代わりにしない。
+6. `<project>/.akari/reports/edit-lint-report.html` とフレーム視認結果を編集レポートへ反映し、checkpoint 状態と provenance を実態に合わせて閉じる。
+
+音声も確認するときだけ `--media` を追加する。無音区間と音量値は既定で warning になり、次の明示閾値を指定した検査だけが FAIL になり得る。
+
+```sh
+node packages/edit-lint/bin/edit-lint.mjs <project> --media
+node packages/edit-lint/bin/edit-lint.mjs <project> --media --silence-error-seconds 2 --max-volume-error-db -0.1
+```
+
+機械向けの標準出力が必要なら `--json` を追加する。状態の正本は常に `.akari/lint.json` とし、HTML は可視化にだけ使う。
+
+`.akari/intake.json`（進め方フォームの保存先。契約: `packages/schemas/intake.schema.json`）が存在すれば、schema 検証と整合検査（未知の task ID・`duration_s`/`keep_length` の同時指定・`status: submitted` なのに `submitted_at` 欠落 等）を合わせて行う。不正値は error（FAIL）、`status: "draft"`（進め方が未確定）は warning に留める。
+
+## 非スコープと拡張候補
+
+黒フレーム、フリーズ、ビート、シーン、フラッシュフレーム、ギャップ、重複クリップ、オフラインメディア、セーフゾーン、フレームレート不整合は将来候補であり、現在の PASS 条件へ推測で追加しない。
+
+## 公開契約
+
+edit.json の検査対象は次の公開契約が定めるフィールドである。契約に無いフィールドの検査を推測で
+足さず、契約が定めた検査（構造・id 一意性・範囲・参照整合）は既に実装済みである。
+
+- [edit.json v0](../../docs/contract-2026-07-13-m1-m4.md)
+- [マルチソース `sources[]` / `cuts[].src`](../../docs/contract-2026-07-18-edit-json-v1-sources.md)
+  — `version: 1` の必須形、`source` と `sources[]` の排他、`sources[].id` の一意性、`cuts[].src` の参照整合
+- [ナレーション `audio.narration[]`](../../docs/contract-2026-07-20-edit-json-v1-narration.md)
+  — id 形式と一意性、`t` の timeline 座標、`gain_db` 範囲、provenance と credit
+- [見せ場マーカー `beats[]`](../../docs/contract-2026-07-22-edit-json-v1-beats.md)
+  — id・`t`（source 秒）・`kind`・`strength`・`src` の参照整合（`src` は v1 のみ）
+- [演出宣言 `direction`](../../docs/contract-2026-07-23-edit-json-v1-direction.md)
+  — `preset` の必須と `intensity` の範囲、`overrides` の型
+- [語レベル演出 `emphasis_words[]`](../../docs/contract-2026-07-23-edit-json-v1-emphasis-words.md)
+  — id 形式と一意性、`t_end > t_start`（source 秒）、`src` の参照整合（`src` は v1 のみ）
+- [字幕とカット編集](../../docs/notes-2026-07-14-captions-and-cut-editing.md)
+- [QA lint の方向性](../../docs/notes-2026-07-16-qa-lint-and-transcript-ui.md)