akari-video 0.1.65 → 0.1.66

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.65",
+  "version": "0.1.66",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/vendor/.akari-capability-sources.json

@@ -91,6 +91,8 @@
     "packages/frame-engine/package.json",
     "packages/frame-engine/README.ja.md",
     "packages/frame-engine/README.md",
+    "packages/generate/package.json",
+    "packages/generate/README.md",
     "packages/gpu-export/package.json",
     "packages/gpu-export/README.ja.md",
     "packages/gpu-export/README.md",

package/vendor/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.65",
+  "version": "0.1.66",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/edit-store/lib/generation-meta-node.d.ts

@@ -0,0 +1,11 @@
+import type { GenerationMetaV1, ReadGenerationMetaResult } from './generation-meta';
+export type { GenerationBinding, GenerationMetaV1, GenerationState, ReadGenerationMetaResult, } from './generation-meta';
+export declare function readGenerationMeta(options: {
+    projectRoot: string;
+    sourcePath: string;
+    now: Date | string | number;
+}): ReadGenerationMetaResult;
+export declare function findGenerationMetaBySha(options: {
+    projectRoot: string;
+    sha256: string;
+}): GenerationMetaV1 | null;

package/vendor/packages/edit-store/lib/generation-meta-node.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readGenerationMeta = readGenerationMeta;
+exports.findGenerationMetaBySha = findGenerationMetaBySha;
+const node_crypto_1 = require("node:crypto");
+const fs = require("node:fs");
+const path = require("node:path");
+const generation_meta_1 = require("./generation-meta");
+function readGenerationMeta(options) {
+    const sourcePath = resolveInsideProject(options.projectRoot, options.sourcePath);
+    const sidecarPath = (0, generation_meta_1.sidecarPathFor)(sourcePath);
+    if (!fs.existsSync(sidecarPath)) {
+        return { state: 'none', meta: null, sidecarPath, binding: null };
+    }
+    const meta = parseMeta(sidecarPath);
+    const expected = bindingSha(meta);
+    let binding = null;
+    let state = (0, generation_meta_1.resolveGenerationState)(meta, options.now);
+    if (expected) {
+        const actualSha256 = fs.existsSync(sourcePath) && fs.statSync(sourcePath).isFile()
+            ? sha256File(sourcePath)
+            : null;
+        binding = {
+            expectedSha256: expected.sha256,
+            actualSha256,
+            matches: actualSha256 === expected.sha256,
+            source: expected.source,
+        };
+        if (!binding.matches)
+            state = 'orphan';
+    }
+    return { state, meta, sidecarPath, binding };
+}
+function findGenerationMetaBySha(options) {
+    const generatedRoot = resolveInsideProject(options.projectRoot, 'assets/generated');
+    if (!fs.existsSync(generatedRoot) || !fs.statSync(generatedRoot).isDirectory())
+        return null;
+    for (const sidecarPath of generationSidecars(generatedRoot)) {
+        const meta = parseMeta(sidecarPath);
+        const expected = bindingSha(meta);
+        if (expected?.sha256 === options.sha256)
+            return meta;
+    }
+    return null;
+}
+function bindingSha(meta) {
+    if (meta.status === 'done' && typeof meta.result?.sha256 === 'string') {
+        return { sha256: meta.result.sha256, source: 'result' };
+    }
+    if ((meta.kind === 'still' || meta.status === 'planned') && typeof meta.inputs?.first_frame?.sha256 === 'string') {
+        return { sha256: meta.inputs.first_frame.sha256, source: 'first_frame' };
+    }
+    return null;
+}
+function generationSidecars(directory) {
+    const found = [];
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const absolute = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            found.push(...generationSidecars(absolute));
+        else if (entry.isFile() && entry.name.endsWith('.meta.json'))
+            found.push(absolute);
+    }
+    return found.sort();
+}
+function resolveInsideProject(projectRoot, candidate) {
+    if (!candidate)
+        throw new Error('sourcePath は空でないパスである必要があります。');
+    const root = path.resolve(projectRoot);
+    const absolute = path.isAbsolute(candidate) ? path.resolve(candidate) : path.resolve(root, candidate);
+    const relative = path.relative(root, absolute);
+    if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error(`projectRoot 外のパスは扱えません: ${candidate}`);
+    }
+    if (fs.existsSync(absolute)) {
+        const realRoot = fs.realpathSync(root);
+        const realPath = fs.realpathSync(absolute);
+        const realRelative = path.relative(realRoot, realPath);
+        if (realRelative === '..' || realRelative.startsWith(`..${path.sep}`) || path.isAbsolute(realRelative)) {
+            throw new Error(`projectRoot 外を指すパスは扱えません: ${candidate}`);
+        }
+    }
+    return absolute;
+}
+function parseMeta(sidecarPath) {
+    let value;
+    try {
+        value = JSON.parse(fs.readFileSync(sidecarPath, 'utf8'));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`生成サイドカーを読めません: ${sidecarPath}: ${message}`);
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`生成サイドカーのルートは object である必要があります: ${sidecarPath}`);
+    }
+    return value;
+}
+function sha256File(filePath) {
+    return (0, node_crypto_1.createHash)('sha256').update(fs.readFileSync(filePath)).digest('hex');
+}

package/vendor/packages/edit-store/lib/generation-meta.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ブラウザ安全な生成サイドカーの型と純粋関数。
+ * fs / crypto を使う読み取りは './generation-meta-node' を明示的に import すること
+ * （ここへ Node 専用依存を戻すと browser バンドルに node builtins が混入するため分離している）。
+ */
+export type GenerationState = 'none' | 'planned' | 'generating' | 'stale' | 'done' | 'failed' | 'orphan';
+export interface GenerationMetaV1 {
+    version: 1;
+    kind: 'still' | 'video' | 'frames';
+    status: 'planned' | 'generating' | 'done' | 'failed';
+    inputs?: {
+        first_frame?: {
+            sha256?: string;
+        } | null;
+        [key: string]: unknown;
+    };
+    job?: {
+        started_at?: string;
+        stale_after_s?: number;
+        [key: string]: unknown;
+    };
+    result?: {
+        sha256?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface GenerationBinding {
+    expectedSha256: string;
+    actualSha256: string | null;
+    matches: boolean;
+    source: 'result' | 'first_frame';
+}
+export interface ReadGenerationMetaResult {
+    state: GenerationState;
+    meta: GenerationMetaV1 | null;
+    sidecarPath: string;
+    binding: GenerationBinding | null;
+}
+export declare function sidecarPathFor(sourcePath: string): string;
+/** fs に触れず、サイドカー自身が表す状態だけを解決する。 */
+export declare function resolveGenerationState(meta: GenerationMetaV1 | null | undefined, now: Date | string | number): GenerationState;

package/vendor/packages/edit-store/lib/generation-meta.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * ブラウザ安全な生成サイドカーの型と純粋関数。
+ * fs / crypto を使う読み取りは './generation-meta-node' を明示的に import すること
+ * （ここへ Node 専用依存を戻すと browser バンドルに node builtins が混入するため分離している）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sidecarPathFor = sidecarPathFor;
+exports.resolveGenerationState = resolveGenerationState;
+function sidecarPathFor(sourcePath) {
+    return `${sourcePath}.meta.json`;
+}
+/** fs に触れず、サイドカー自身が表す状態だけを解決する。 */
+function resolveGenerationState(meta, now) {
+    if (!meta)
+        return 'none';
+    if (meta.status === 'failed')
+        return 'failed';
+    if (meta.status === 'generating') {
+        const nowMs = timeValue(now);
+        const startedMs = Date.parse(String(meta.job?.started_at ?? ''));
+        const staleAfterS = meta.job?.stale_after_s;
+        if (Number.isFinite(nowMs)
+            && Number.isFinite(startedMs)
+            && typeof staleAfterS === 'number'
+            && nowMs - startedMs > staleAfterS * 1000)
+            return 'stale';
+    }
+    return meta.status;
+}
+function timeValue(value) {
+    return value instanceof Date ? value.getTime() : typeof value === 'number' ? value : Date.parse(value);
+}

package/vendor/packages/edit-store/lib/index.d.ts

@@ -12,6 +12,7 @@ export * from './caption-window';
 export * from './caption-clock';
 export * from './timeline-map';
 export * from './caption-display';
+export * from './generation-meta';
 export * from './edit-v2';
 export * from './edit-v2-item-write';
 export * from './internal-model';

package/vendor/packages/edit-store/lib/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./caption-window"), exports);
 __exportStar(require("./caption-clock"), exports);
 __exportStar(require("./timeline-map"), exports);
 __exportStar(require("./caption-display"), exports);
+__exportStar(require("./generation-meta"), exports);
 // Includes AdjustV1 and its curve/wheel/hue types; AdjustV0 remains an alias.
 __exportStar(require("./edit-v2"), exports);
 __exportStar(require("./edit-v2-item-write"), exports);

package/vendor/packages/edit-store/package.json

@@ -9,6 +9,7 @@
     ".": "./lib/index.js",
     "./lib/project": "./lib/project.js",
     "./lib/write-gate": "./lib/write-gate.js",
+    "./lib/generation-meta-node": "./lib/generation-meta-node.js",
     "./lib/migrate": "./lib/migrate/index.js",
     "./lib/*.js": "./lib/*.js",
     "./lib/*": "./lib/*.js",

package/vendor/packages/generate/README.md

@@ -0,0 +1,12 @@
+# @akari-video/generate
+
+This dependency-free package normalizes generation slots and validates them against one model capability row.
+The UI, CLI, and agent integrations should all call the same `validateInputs` function.
+
+```js
+import { validateInputs } from '@akari-video/generate';
+const { ok, normalized, rounded, messages, cost } = validateInputs({ inputs, output, model });
+```
+
+Messages use `error`, `warn`, or `info` levels with stable codes such as `first_frame.required`, `duration.rounded`, and `price.unknown`.
+A model without recorded pricing remains valid and returns `cost.needs_explicit_confirm` instead of changing `ok` to false.

package/vendor/packages/generate/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@akari-video/generate",
+  "version": "0.0.0",
+  "private": true,
+  "description": "生成入力（9 スロット + 出力ノブ）を能力カタログ行に対して検証・正規化・丸め・費用見積する依存ゼロの共有モジュール。UI / CLI / エージェントが同じ関数を使う。",
+  "type": "module",
+  "main": "src/index.mjs",
+  "scripts": {
+    "test": "node --test \"test/*.test.mjs\""
+  }
+}

package/vendor/packages/schemas/bin/refresh-gen-models-openapi.mjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+// gen-models.json の fal 行について、明示実行時だけ OpenAPI スナップショットを更新する。
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const usage = "使い方: node packages/schemas/bin/refresh-gen-models-openapi.mjs";
+const args = process.argv.slice(2);
+
+if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
+  console.log(usage);
+  process.exit(0);
+}
+if (args.length !== 0) {
+  console.error(usage);
+  process.exit(2);
+}
+
+const packageRoot = fileURLToPath(new URL("..", import.meta.url));
+const catalogPath = path.join(packageRoot, "gen-models.json");
+const fixtureRoot = path.join(packageRoot, "fixtures", "gen-models", "openapi");
+
+let catalog;
+try {
+  catalog = JSON.parse(fs.readFileSync(catalogPath, "utf8"));
+} catch (error) {
+  console.error(`ERROR: gen-models.json を読めません: ${messageOf(error)}`);
+  process.exit(1);
+}
+
+const models = catalog.models.filter((model) => model.provider === "fal");
+fs.mkdirSync(fixtureRoot, { recursive: true });
+
+try {
+  for (const model of models) {
+    const response = await fetch(model.source_url, { headers: { accept: "application/json" } });
+    if (!response.ok) throw new Error(`${model.id}: HTTP ${response.status} ${response.statusText}`);
+    const document = await response.json();
+    sanitizeDocument(document);
+    const outputPath = path.join(fixtureRoot, `${model.id.replaceAll(":", "_")}.json`);
+    const temporaryPath = `${outputPath}.tmp`;
+    fs.writeFileSync(temporaryPath, `${JSON.stringify(document, null, 2)}\n`, "utf8");
+    fs.renameSync(temporaryPath, outputPath);
+    console.log(`更新: ${model.id} -> ${outputPath}`);
+  }
+} catch (error) {
+  console.error(`ERROR: OpenAPI の更新に失敗しました: ${messageOf(error)}`);
+  process.exit(1);
+}
+
+console.log(`OK: fal ${models.length} 行の OpenAPI を更新しました`);
+
+function sanitizeDocument(document) {
+  // fal のメタデータに含まれる表示用サムネイルは、スナップショットへ保存しない。
+  delete document.info?.["x-fal-metadata"]?.thumbnailUrl;
+
+  // 名前マップ直下では同名の property / schema を保護し、それ以外の例示キーを落とす。
+  removeExampleKeys(document, []);
+
+  // 構造上必要な配信先だけを残し、説明文などに埋め込まれた URL も固定値へ置換する。
+  replaceUrls(document, []);
+}
+
+function removeExampleKeys(value, pathParts) {
+  if (Array.isArray(value)) {
+    for (let index = 0; index < value.length; index += 1) {
+      removeExampleKeys(value[index], [...pathParts, index]);
+    }
+    return;
+  }
+  if (value === null || typeof value !== "object") return;
+
+  const namedMapKeys = new Set(["properties", "schemas", "$defs", "definitions"]);
+  const protectedNameMap = namedMapKeys.has(pathParts.at(-1));
+  for (const key of Object.keys(value)) {
+    if (!protectedNameMap && ["examples", "example", "externalDocs"].includes(key)) {
+      delete value[key];
+      continue;
+    }
+    removeExampleKeys(value[key], [...pathParts, key]);
+  }
+}
+
+function replaceUrls(value, pathParts) {
+  if (Array.isArray(value)) {
+    for (let index = 0; index < value.length; index += 1) {
+      if (typeof value[index] === "string" && !isServerUrl([...pathParts, index])) {
+        value[index] = value[index].replace(/https?:\/\/[^\s<>"'`)\]}]+/g, "<url-removed>");
+      } else {
+        replaceUrls(value[index], [...pathParts, index]);
+      }
+    }
+    return;
+  }
+  if (value === null || typeof value !== "object") return;
+
+  for (const key of Object.keys(value)) {
+    const childPath = [...pathParts, key];
+    if (typeof value[key] === "string" && !isServerUrl(childPath)) {
+      value[key] = value[key].replace(/https?:\/\/[^\s<>"'`)\]}]+/g, "<url-removed>");
+    } else {
+      replaceUrls(value[key], childPath);
+    }
+  }
+}
+
+function isServerUrl(pathParts) {
+  return pathParts.length === 3
+    && pathParts[0] === "servers"
+    && Number.isInteger(pathParts[1])
+    && pathParts[2] === "url";
+}
+
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}

package/vendor/packages/schemas/bin/validate-captions.mjs

@@ -299,13 +299,20 @@ function validateCaptionWords(value, captionLabel) {
       if (!hasOwn(word, field)) fail(`${label}.${field} は必須です`);
     }
     for (const key of Object.keys(word)) {
-      if (!["start", "end", "text"].includes(key)) fail(`${label} に未知のキーがあります: ${key}`);
+      if (!["start", "end", "raw_start", "raw_end", "text"].includes(key)) fail(`${label} に未知のキーがあります: ${key}`);
     }
     const startValid = isFiniteNumber(word.start) && word.start >= 0;
     const endValid = isFiniteNumber(word.end) && word.end >= 0;
     if (!startValid || !endValid || word.end < word.start) {
       fail(`${label} は 0 <= start <= end を満たす必要があります`);
     }
+    const hasRawStart = hasOwn(word, "raw_start");
+    const hasRawEnd = hasOwn(word, "raw_end");
+    if (hasRawStart !== hasRawEnd) fail(`${label}.raw_start / raw_end は両方指定してください`);
+    if (hasRawStart && (!isFiniteNumber(word.raw_start) || word.raw_start < 0
+        || !isFiniteNumber(word.raw_end) || word.raw_end < word.raw_start)) {
+      fail(`${label} は 0 <= raw_start <= raw_end を満たす必要があります`);
+    }
     if (!isNonEmptyString(word.text)) {
       fail(`${label}.text は空でない文字列である必要があります`);
     }

package/vendor/packages/schemas/bin/validate-gen-models.mjs

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+
+// gen-models.json v1 のスキーマと、行をまたぐ意味制約を検証する。
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import Ajv2020 from "ajv/dist/2020.js";
+
+const usage = "使い方: node packages/schemas/bin/validate-gen-models.mjs <gen-models.json>";
+const catalogArgument = process.argv[2];
+
+if (!catalogArgument || process.argv.length !== 3) {
+  console.error(usage);
+  process.exit(2);
+}
+
+if (catalogArgument === "--help" || catalogArgument === "-h") {
+  console.log(usage);
+  process.exit(0);
+}
+
+const catalogPath = path.resolve(catalogArgument);
+const schemaPath = fileURLToPath(new URL("../gen-models.schema.json", import.meta.url));
+const errors = [];
+
+if (!isRegularFile(catalogPath)) {
+  fail(`gen-models.json が見つかりません: ${catalogPath}`);
+  finish();
+}
+
+let schema;
+try {
+  schema = JSON.parse(fs.readFileSync(schemaPath, "utf8"));
+} catch (error) {
+  fail(`gen-models.schema.json を JSON として読めません: ${messageOf(error)}`);
+  finish();
+}
+if (schema.$id !== "urn:akari-video:schema:gen-models:v1") {
+  fail("gen-models.schema.json の $id が v1 契約と一致しません");
+  finish();
+}
+
+let catalog;
+try {
+  catalog = JSON.parse(fs.readFileSync(catalogPath, "utf8"));
+} catch (error) {
+  fail(`gen-models.json を JSON として読めません: ${messageOf(error)}`);
+  finish();
+}
+
+try {
+  const validate = new Ajv2020({ allErrors: true, strict: true }).compile(schema);
+  if (!validate(catalog)) {
+    for (const error of validate.errors ?? []) {
+      fail(`スキーマ違反 ${error.instancePath || "/"}: ${error.message}`);
+    }
+  }
+} catch (error) {
+  fail(`gen-models.schema.json をコンパイルできません: ${messageOf(error)}`);
+  finish();
+}
+
+validateCatalog(catalog);
+finish();
+
+function validateCatalog(value) {
+  if (!value || typeof value !== "object" || !Array.isArray(value.models)) return;
+  if (value.models.length !== 14) fail(`models は 14 行である必要があります: ${value.models.length}`);
+
+  const ids = new Set();
+  for (const [index, model] of value.models.entries()) {
+    if (!model || typeof model !== "object" || Array.isArray(model)) continue;
+    const label = typeof model.id === "string" ? model.id : `models[${index}]`;
+    if (typeof model.id === "string") {
+      if (ids.has(model.id)) fail(`id が重複しています: ${model.id}`);
+      ids.add(model.id);
+    }
+    if (model.verified !== "documented") {
+      fail(`${label} の verified は documented である必要があります`);
+    }
+    if (model.price && typeof model.price === "object" && model.price.by_resolution) {
+      const resolutions = new Set(Array.isArray(model.resolutions) ? model.resolutions : []);
+      for (const resolution of Object.keys(model.price.by_resolution)) {
+        if (resolution !== "" && !resolutions.has(resolution)) {
+          fail(`${label} の price.by_resolution.${resolution} は resolutions に含まれていません`);
+        }
+      }
+    }
+    validateDuration(model.duration, label);
+  }
+  findForbiddenWord(value);
+}
+
+function validateDuration(duration, label) {
+  if (!duration || typeof duration !== "object") return;
+  if (duration.kind === "range") {
+    if (duration.min > duration.max) fail(`${label} の duration.min は max 以下である必要があります`);
+    if (duration.default !== null
+        && (duration.default < duration.min || duration.default > duration.max
+          || (duration.default - duration.min) % duration.step !== 0)) {
+      fail(`${label} の duration.default は range 内の step に一致する必要があります`);
+    }
+  }
+  if (duration.kind === "enum" && duration.default !== null && !duration.values.includes(duration.default)) {
+    fail(`${label} の duration.default は values に含まれている必要があります`);
+  }
+}
+
+function findForbiddenWord(value, location = "ルート") {
+  if (typeof value === "string") {
+    if (value === "cap" + "ability") fail(`${location} に禁止語が値として使われています`);
+    return;
+  }
+  if (!value || typeof value !== "object") return;
+  for (const [key, child] of Object.entries(value)) {
+    if (key === "cap" + "ability") fail(`${location} に禁止語のキーがあります`);
+    findForbiddenWord(child, `${location}.${key}`);
+  }
+}
+
+function isRegularFile(targetPath) {
+  try {
+    return fs.statSync(targetPath).isFile();
+  } catch {
+    return false;
+  }
+}
+
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+function fail(message) {
+  errors.push(message);
+}
+
+function finish() {
+  if (errors.length > 0) {
+    for (const error of errors) console.error(`ERROR: ${error}`);
+    process.exit(1);
+  }
+  console.log(`OK: ${catalogPath}`);
+  process.exit(0);
+}

package/vendor/packages/schemas/bin/validate-generation-meta.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+// <元ファイル名>.meta.json の生成サイドカー v1 を検証する。
+// 素材工房の asset-meta.schema.json とは別契約。
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import Ajv2020 from "ajv/dist/2020.js";
+
+const usage = "使い方: node packages/schemas/bin/validate-generation-meta.mjs <元ファイル名.meta.json>";
+const argument = process.argv[2];
+
+if (!argument || process.argv.length !== 3) {
+  console.error(usage);
+  process.exit(2);
+}
+if (argument === "--help" || argument === "-h") {
+  console.log(usage);
+  process.exit(0);
+}
+
+const metaPath = path.resolve(argument);
+const schemaPath = fileURLToPath(new URL("../generation-meta.schema.json", import.meta.url));
+let schema;
+let meta;
+
+try {
+  schema = JSON.parse(fs.readFileSync(schemaPath, "utf8"));
+} catch (error) {
+  console.error(`NG: ${metaPath}`);
+  console.error(`- generation-meta.schema.json を JSON として読めません: ${messageOf(error)}`);
+  process.exit(2);
+}
+if (schema.$id !== "urn:akari-video:schema:generation-meta:v1") {
+  console.error(`NG: ${metaPath}`);
+  console.error("- generation-meta.schema.json の $id が v1 契約と一致しません");
+  process.exit(2);
+}
+try {
+  meta = JSON.parse(fs.readFileSync(metaPath, "utf8"));
+} catch (error) {
+  console.error(`NG: ${metaPath}`);
+  console.error(`- 生成サイドカーを JSON として読めません: ${messageOf(error)}`);
+  process.exit(1);
+}
+
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+ajv.addFormat("date-time", value => typeof value === "string" && Number.isFinite(Date.parse(value)) && /^\d{4}-\d{2}-\d{2}T/.test(value));
+const validate = ajv.compile(schema);
+if (!validate(meta)) {
+  console.error(`NG: ${metaPath}`);
+  for (const error of validate.errors ?? []) console.error(`- ${japaneseError(error)}`);
+  process.exit(1);
+}
+
+console.log(`OK: ${metaPath}`);
+
+function japaneseError(error) {
+  const location = error.instancePath || "/";
+  switch (error.keyword) {
+    case "required": return `${location} に必須キー ${error.params.missingProperty} がありません`;
+    case "additionalProperties": return `${location} に未定義キー ${error.params.additionalProperty} があります`;
+    case "enum": return `${location} の値が許可された候補と一致しません`;
+    case "const": return `${location} は ${JSON.stringify(error.params.allowedValue)} である必要があります`;
+    case "type": return `${location} は ${error.params.type} である必要があります`;
+    case "format": return `${location} は ${error.params.format} 形式である必要があります`;
+    case "pattern": return `${location} の文字列形式が契約と一致しません`;
+    default: return `${location} が契約を満たしません（${error.keyword}）`;
+  }
+}
+
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}

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

@@ -247,9 +247,11 @@
       "properties": {
         "start": { "type": "number", "minimum": 0 },
         "end": { "type": "number", "minimum": 0 },
+        "raw_start": { "type": "number", "minimum": 0 },
+        "raw_end": { "type": "number", "minimum": 0 },
         "text": { "type": "string", "minLength": 1, "pattern": "\\S" }
       },
-      "$comment": "end >= start と親 caption の範囲外警告は JSON Schema 標準だけでは兄弟値を比較できないため検証器が扱う。"
+      "$comment": "raw_start/raw_end は発話吸着前の監査用時刻。end >= start、raw_end >= raw_start と親 caption の範囲外警告は JSON Schema 標準だけでは兄弟値を比較できないため検証器が扱う。"
     },
     "sourceRef": {
       "oneOf": [