akari-video 0.1.0

package/vendor/packages/project-scaffold/test/skill-adapter-link.test.mjs

@@ -0,0 +1,204 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import test from "node:test";
+
+import { createSkillAdapterLink, installSkillAdapters } from "../src/index.mjs";
+
+async function withScratchRoot(callback) {
+  const root = await mkdtemp(join(tmpdir(), "akari-scaffold-adapter-link-test-"));
+  try {
+    return await callback(root);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+}
+
+/**
+ * Builds a fake `fs/promises`-shaped object backed by an in-memory call log, so the
+ * symlink / junction / copy fallback chain can be exercised deterministically from mac
+ * without a real Windows machine. Delegates directory operations (mkdir/readdir/writeFile/
+ * readFile) to the real `node:fs/promises` against a scratch directory — only `symlink`
+ * behavior is faked.
+ */
+function fakeFsWithSymlinkBehavior(realFs, symlinkImpl) {
+  return {
+    mkdir: realFs.mkdir,
+    readdir: realFs.readdir,
+    readFile: realFs.readFile,
+    writeFile: realFs.writeFile,
+    symlink: symlinkImpl
+  };
+}
+
+function eperm(message) {
+  const error = new Error(message);
+  error.code = "EPERM";
+  return error;
+}
+
+function eexist(message) {
+  const error = new Error(message);
+  error.code = "EEXIST";
+  return error;
+}
+
+test("createSkillAdapterLink: passes an explicit 'dir' type through to fs.symlink (skills are directories)", async () => {
+  await withScratchRoot(async (root) => {
+    const realFs = await import("node:fs/promises");
+    const source = join(root, "skill-source");
+    const linkPath = join(root, "adapter", "skill-source");
+    await mkdir(source, { recursive: true });
+    await mkdir(dirname(linkPath), { recursive: true });
+
+    const calls = [];
+    const fsImpl = fakeFsWithSymlinkBehavior(realFs, async (target, path, type) => {
+      calls.push({ target, path, type });
+      return realFs.symlink(target, path, type);
+    });
+
+    const result = await createSkillAdapterLink("../skill-source", linkPath, { fsImpl, platform: "darwin" });
+
+    assert.equal(result.method, "symlink");
+    assert.equal(calls.length, 1);
+    assert.equal(calls[0].type, "dir");
+  });
+});
+
+test("createSkillAdapterLink: on win32, EPERM from a plain symlink falls back to an absolute-path junction", async () => {
+  await withScratchRoot(async (root) => {
+    const realFs = await import("node:fs/promises");
+    const source = join(root, "skill-source");
+    const linkPath = join(root, "adapter", "skill-source");
+    await mkdir(source, { recursive: true });
+    await mkdir(dirname(linkPath), { recursive: true });
+
+    const calls = [];
+    const fsImpl = fakeFsWithSymlinkBehavior(realFs, async (target, path, type) => {
+      calls.push({ target, path, type });
+      if (type === "dir") {
+        throw eperm("plain symlink denied (no admin rights / developer mode)");
+      }
+      // Simulate junction creation succeeding by materializing a real symlink in its place
+      // (macOS/Linux fs.symlink ignores the 'junction' type and just makes a normal link,
+      // which is enough to prove createSkillAdapterLink reached this branch with an
+      // absolute, resolved target).
+      return realFs.symlink(target, path, "dir");
+    });
+
+    const result = await createSkillAdapterLink("../skill-source", linkPath, { fsImpl, platform: "win32" });
+
+    assert.equal(result.method, "junction");
+    assert.equal(calls.length, 2);
+    assert.equal(calls[0].type, "dir");
+    assert.equal(calls[1].type, "junction");
+    // Junctions require an absolute target path (relative targets are not valid junctions).
+    assert.ok(calls[1].target.startsWith("/") || /^[A-Za-z]:/.test(calls[1].target));
+    assert.equal(calls[1].target, source);
+  });
+});
+
+test("createSkillAdapterLink: on win32, when junction creation also fails, falls back to a recursive copy", async () => {
+  await withScratchRoot(async (root) => {
+    const realFs = await import("node:fs/promises");
+    const source = join(root, "skill-source");
+    const linkPath = join(root, "adapter", "skill-source");
+    await mkdir(join(source, "nested"), { recursive: true });
+    await realFs.writeFile(join(source, "top.md"), "top-level file\n", "utf8");
+    await realFs.writeFile(join(source, "nested", "child.md"), "nested file\n", "utf8");
+    await mkdir(dirname(linkPath), { recursive: true });
+
+    const fsImpl = fakeFsWithSymlinkBehavior(realFs, async (target, path, type) => {
+      if (type === "dir") {
+        throw eperm("plain symlink denied");
+      }
+      throw eperm("junction denied (e.g. cross-volume target)");
+    });
+
+    const result = await createSkillAdapterLink("../skill-source", linkPath, { fsImpl, platform: "win32" });
+
+    assert.equal(result.method, "copy");
+    assert.equal(await readFile(join(linkPath, "top.md"), "utf8"), "top-level file\n");
+    assert.equal(await readFile(join(linkPath, "nested", "child.md"), "utf8"), "nested file\n");
+  });
+});
+
+test("createSkillAdapterLink: on non-Windows platforms, symlink errors other than EEXIST are not retried as junction/copy", async () => {
+  await withScratchRoot(async (root) => {
+    const realFs = await import("node:fs/promises");
+    const linkPath = join(root, "adapter", "skill-source");
+    await mkdir(dirname(linkPath), { recursive: true });
+
+    const calls = [];
+    const fsImpl = fakeFsWithSymlinkBehavior(realFs, async (target, path, type) => {
+      calls.push({ target, path, type });
+      throw eperm("hypothetical restricted sandbox");
+    });
+
+    await assert.rejects(
+      () => createSkillAdapterLink("../skill-source", linkPath, { fsImpl, platform: "darwin" }),
+      (error) => error.code === "EPERM"
+    );
+    // Junctions are an NTFS-only concept; there is nothing sensible to fall back to on
+    // POSIX platforms, so only the original attempt should have been made.
+    assert.equal(calls.length, 1);
+  });
+});
+
+test("createSkillAdapterLink: EEXIST propagates unchanged (idempotent re-install keeps existing links)", async () => {
+  await withScratchRoot(async (root) => {
+    const realFs = await import("node:fs/promises");
+    const linkPath = join(root, "adapter", "skill-source");
+    await mkdir(dirname(linkPath), { recursive: true });
+
+    const fsImpl = fakeFsWithSymlinkBehavior(realFs, async () => {
+      throw eexist("already linked");
+    });
+
+    await assert.rejects(
+      () => createSkillAdapterLink("../skill-source", linkPath, { fsImpl, platform: "win32" }),
+      (error) => error.code === "EEXIST"
+    );
+  });
+});
+
+test("installSkillAdapters: on win32 with symlink EPERM, all adapters degrade to junctions and the caller learns which ones", async () => {
+  await withScratchRoot(async (root) => {
+    const realFs = await import("node:fs/promises");
+    const skillsDir = join(root, ".claude", "skills");
+    await mkdir(join(skillsDir, "analyze-footage"), { recursive: true });
+
+    const fsImpl = fakeFsWithSymlinkBehavior(realFs, async (target, path, type) => {
+      if (type === "dir") {
+        throw eperm("plain symlink denied");
+      }
+      return realFs.symlink(target, path, "dir");
+    });
+
+    const report = await installSkillAdapters(root, { fsImpl, platform: "win32" });
+
+    assert.deepEqual(report.created.sort(), [
+      ".agents/skills/analyze-footage",
+      ".codex/skills/analyze-footage"
+    ]);
+    assert.deepEqual(report.skippedExisting, []);
+    assert.equal(report.degraded.length, 2);
+    assert.ok(report.degraded.every((entry) => entry.method === "junction"));
+  });
+});
+
+test("installSkillAdapters: real fs on the current platform still creates plain symlinks (no regression)", async () => {
+  await withScratchRoot(async (root) => {
+    const skillsDir = join(root, ".claude", "skills");
+    await mkdir(join(skillsDir, "analyze-footage"), { recursive: true });
+
+    const report = await installSkillAdapters(root);
+
+    assert.deepEqual(report.created.sort(), [
+      ".agents/skills/analyze-footage",
+      ".codex/skills/analyze-footage"
+    ]);
+    assert.deepEqual(report.degraded, []);
+  });
+});

package/vendor/packages/schemas/analysis.schema.json

@@ -0,0 +1,475 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AKARI Video analysis.json v0",
+  "description": "素材 1 本の分析結果を表す中間契約。",
+  "$comment": "意味制約として、start/end を持つ全区間では end > start とする。Draft 2020-12 標準では兄弟プロパティ間を比較できないため、この条件は生成・検証手順で確認する。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "source",
+    "transcript",
+    "keyframes",
+    "events",
+    "tracks"
+  ],
+  "properties": {
+    "version": {
+      "const": 0
+    },
+    "source": {
+      "type": "string",
+      "minLength": 1,
+      "description": "分析対象素材へのパス。相対パスは analysis.json の所在ディレクトリを基準に解決する。"
+    },
+    "transcript": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/transcriptSegment"
+      }
+    },
+    "keyframes": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/keyframe"
+      }
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/event"
+      }
+    },
+    "tracks": {
+      "$ref": "#/$defs/tracks"
+    }
+  },
+  "$defs": {
+    "seconds": {
+      "type": "number",
+      "minimum": 0
+    },
+    "word": {
+      "$comment": "M5 契約例で省略されている words の要素を、区間・本文を持つ最小形として定義する。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "start",
+        "end",
+        "text"
+      ],
+      "properties": {
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        },
+        "text": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "transcriptSegment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "start",
+        "end",
+        "text"
+      ],
+      "properties": {
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        },
+        "text": {
+          "type": "string",
+          "minLength": 1
+        },
+        "speaker": {
+          "type": "string",
+          "minLength": 1
+        },
+        "words": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/word"
+          }
+        }
+      }
+    },
+    "keyframe": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "t",
+        "path",
+        "note"
+      ],
+      "properties": {
+        "t": {
+          "$ref": "#/$defs/seconds"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "キーフレーム画像へのパス。相対パスは analysis.json の所在ディレクトリを基準に解決する。"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        },
+        "origin": {
+          "enum": [
+            "scene",
+            "interval",
+            "transcript"
+          ],
+          "description": "採用元の抽出系統（2026-07-14 追加・任意）。scene = 映像変化検出、interval = 一定間隔、transcript = 発話由来（highlight 等の時刻から抽出）。候補と note の対応トレーサビリティにも使う。"
+        }
+      }
+    },
+    "fillerEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "start",
+        "end"
+      ],
+      "properties": {
+        "type": {
+          "const": "filler"
+        },
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        }
+      }
+    },
+    "troubleEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "start",
+        "end",
+        "note"
+      ],
+      "properties": {
+        "type": {
+          "const": "trouble"
+        },
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "chapterEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "t",
+        "title"
+      ],
+      "properties": {
+        "type": {
+          "const": "chapter"
+        },
+        "t": {
+          "$ref": "#/$defs/seconds"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "hookScore": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "hook",
+        "self_contained",
+        "emotion",
+        "density",
+        "punch"
+      ],
+      "properties": {
+        "hook": {
+          "$ref": "#/$defs/scoreValue"
+        },
+        "self_contained": {
+          "$ref": "#/$defs/scoreValue"
+        },
+        "emotion": {
+          "$ref": "#/$defs/scoreValue"
+        },
+        "density": {
+          "$ref": "#/$defs/scoreValue"
+        },
+        "punch": {
+          "$ref": "#/$defs/scoreValue"
+        }
+      }
+    },
+    "scoreValue": {
+      "$comment": "1〜5 の整数尺度は analysis.json v0 の運用仮定。採用閾値は M5 契約どおり運用で調整する。",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5
+    },
+    "hookEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "start",
+        "end",
+        "score"
+      ],
+      "properties": {
+        "type": {
+          "const": "hook"
+        },
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        },
+        "score": {
+          "$ref": "#/$defs/hookScore"
+        }
+      }
+    },
+    "highlightEvent": {
+      "$comment": "2026-07-14 追加（後方互換の追加語彙）。ショート向けの hook と異なり、決定事項・結論・数字・強い主張など編集判断全般の根拠になる重要発言を記録する。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "start",
+        "end",
+        "quote",
+        "reason"
+      ],
+      "properties": {
+        "type": {
+          "const": "highlight"
+        },
+        "start": {
+          "$ref": "#/$defs/seconds"
+        },
+        "end": {
+          "$ref": "#/$defs/seconds"
+        },
+        "quote": {
+          "type": "string",
+          "minLength": 1,
+          "description": "transcript の実発言に忠実な引用。要約・創作をしない。"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "description": "なぜ重要か（決定事項・結論・数値/実績・強い主張などの根拠カテゴリと内容）。"
+        },
+        "importance": {
+          "$ref": "#/$defs/scoreValue"
+        }
+      }
+    },
+    "event": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/fillerEvent"
+        },
+        {
+          "$ref": "#/$defs/troubleEvent"
+        },
+        {
+          "$ref": "#/$defs/chapterEvent"
+        },
+        {
+          "$ref": "#/$defs/highlightEvent"
+        },
+        {
+          "$ref": "#/$defs/hookEvent"
+        }
+      ]
+    },
+    "speakerSpan": {
+      "type": "array",
+      "prefixItems": [
+        {
+          "$ref": "#/$defs/seconds"
+        },
+        {
+          "$ref": "#/$defs/seconds"
+        }
+      ],
+      "items": false,
+      "minItems": 2,
+      "maxItems": 2
+    },
+    "speakerTrack": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "spans"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "spans": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/speakerSpan"
+          }
+        }
+      }
+    },
+    "faceBox": {
+      "description": "素材フレームに対する [x, y, width, height] 順の正規化座標。各要素は 0〜1。",
+      "$comment": "意味制約として x + width <= 1 かつ y + height <= 1 とする。Draft 2020-12 標準では配列要素間を加算・比較できないため、この条件は生成・検証手順で確認する。",
+      "type": "array",
+      "prefixItems": [
+        {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      ],
+      "items": false,
+      "minItems": 4,
+      "maxItems": 4
+    },
+    "faceTrackPoint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "speaker",
+        "t",
+        "box"
+      ],
+      "properties": {
+        "speaker": {
+          "type": "string",
+          "minLength": 1
+        },
+        "t": {
+          "$ref": "#/$defs/seconds"
+        },
+        "box": {
+          "$ref": "#/$defs/faceBox"
+        }
+      }
+    },
+    "personMatteTrack": {
+      "$comment": "2026-07-23 追加（docs/contract-2026-07-23-analysis-person-matte.md）。実体は VP9 alpha WebM（コンテナに alpha_mode=1）。意味制約として、マット動画の時刻 0 は素材の時刻 0 と一致し、fps はマット動画の実 fps と一致する。Draft 2020-12 標準では外部ファイルを参照できないため、この条件は生成・検証手順で確認する。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "fps"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "マット動画（VP9 alpha WebM）へのパス。相対パスは analysis.json の所在ディレクトリを基準に解決し、区切りは / を使う。"
+        },
+        "fps": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "description": "マット動画の fps。元素材の fps と一致しなくてよい。"
+        },
+        "quality": {
+          "type": "string",
+          "minLength": 1,
+          "description": "生成品質。fast / balanced / accurate を例示するが、enum 強制はしない（beats[].kind と同じ流儀）。"
+        },
+        "generated_at": {
+          "type": "string",
+          "minLength": 1,
+          "description": "生成時刻（ISO8601）。"
+        },
+        "tool": {
+          "type": "string",
+          "minLength": 1,
+          "description": "生成手段の記録。vision-person-segmentation を例示する。"
+        }
+      }
+    },
+    "tracks": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "speakers",
+        "faces",
+        "person_matte"
+      ],
+      "properties": {
+        "speakers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/speakerTrack"
+          }
+        },
+        "faces": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/faceTrackPoint"
+          }
+        },
+        "person_matte": {
+          "description": "生成済み人物マット。未生成なら null。object 形が正（2026-07-23 追加）。string 形は { path } の糖衣として後方互換で受ける（非推奨）。相対パスは analysis.json の所在ディレクトリを基準に解決する。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "$ref": "#/$defs/personMatteTrack"
+            }
+          ]
+        }
+      }
+    }
+  }
+}