akari-video 0.1.71 → 0.1.72

package/bin/akari.mjs

@@ -16,6 +16,7 @@ import { runDoctorCommand } from '../src/doctor-command.mjs';
 import { runGenerateCommand } from '../src/generate-command.mjs';
 import { runStoryboardCommand } from '../src/storyboard-command.mjs';
 import { runWorldCommand } from '../src/world-command.mjs';
+import { runSkillsCommand, refreshEntrySkillOnLaunch } from '../src/skills-command.mjs';
 import { resolveRuntimePaths } from '../src/runtime-diagnostics.mjs';
 import { maybeApplyPendingUpdateOnLaunch, resolveInstalledVersionInfo } from '../src/update-check.mjs';
 import { describeCliHelp, describeInstalledVersions } from '../src/messages.mjs';
@@ -38,7 +39,8 @@ async function printVersion() {
 // `--help` は claude/opencode へそのまま転送されてしまっていた — AKARI Video 自身の
 // コマンド一覧が一度も出ない行き止まりだったため新設した）。
 async function printCliHelp() {
-  for (const line of [...describeCliHelp(), '  world                    ワールド地図を検査・生成・プレビュー・停留所移動']) {
+  for (const line of [...describeCliHelp(), '  world                    ワールド地図を検査・生成・プレビュー・停留所移動',
+    '  skills                   入口スキルを配置・削除・確認（install/remove --entry, status --json）']) {
     console.log(line);
   }
   return { exitCode: 0 };
@@ -60,6 +62,7 @@ try {
 } catch (error) {
   console.error(`自動更新の適用確認でエラーが発生しました（続行します）: ${error instanceof Error ? error.message : String(error)}`);
 }
+refreshEntrySkillOnLaunch({ env: process.env });
 
 // `akari update` / `akari init` / `akari new` / `akari narration` / `akari internal` /
 // `akari sounds` / `akari status` / `akari accept` / `akari capability` / `akari store` /
@@ -73,6 +76,7 @@ const invoke = (argv[0] === '--version' || argv[0] === '-v') ? printVersion()
   : argv[0] === 'update' ? runUpdateCommand(argv.slice(1))
   : argv[0] === 'init' ? runInitCommand(argv.slice(1))
   : argv[0] === 'new' ? runNewCommand(argv.slice(1))
+  : argv[0] === 'skills' ? runSkillsCommand(argv.slice(1))
   : argv[0] === 'narration' ? runNarrationCommand(argv.slice(1))
   : argv[0] === 'internal' ? runInternalCommand(argv.slice(1))
   : argv[0] === 'sounds' ? runSoundsCommand(argv.slice(1))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.71",
+  "version": "0.1.72",
   "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/src/skills-command.mjs

@@ -0,0 +1,160 @@
+import { cpSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
+export const ENTRY_VERSION_FILE = '.akari-entry-version';
+const usage = `使い方: akari skills install --entry [--target <dir>]...
+        akari skills remove --entry [--target <dir>]...
+        akari skills status --json
+--target は入口スキル自体の配置先（例: ~/.codex/skills/akari）。既定の 2 か所に追加する。`;
+
+function stat(path) {
+  try { return lstatSync(path); } catch (error) {
+    if (error.code === 'ENOENT') return null;
+    throw error;
+  }
+}
+
+function canonicalBase(path) {
+  return stat(path) ? realpathSync(path) : resolve(path);
+}
+
+export function entryTargets(env = process.env, extra = []) {
+  const home = canonicalBase(env.HOME || homedir());
+  return [...new Set([
+    join(home, '.claude', 'skills', 'akari'),
+    join(home, '.agents', 'skills', 'akari'),
+    ...extra.map(path => resolve(path)),
+  ])];
+}
+
+export function resolveEntrySource({ env = process.env, repoRoot = REPO_ROOT } = {}) {
+  const home = env.HOME || homedir();
+  for (const root of [join(env.AKARI_HOME || join(home, '.akari'), 'app'), repoRoot]) {
+    const source = join(root, 'skills', 'akari');
+    if (!stat(join(source, 'SKILL.md'))?.isFile()) continue;
+    const version = JSON.parse(readFileSync(join(root, 'packages', 'akari-launcher', 'package.json'), 'utf8')).version;
+    if (typeof version !== 'string' || !version.trim()) throw new Error(`ランチャー版が不正です: ${root}`);
+    return { source, version };
+  }
+  throw new Error('入口スキル skills/akari/SKILL.md が見つかりません。');
+}
+
+// ディレクトリだけでなく配下の SKILL.md / 版印、親の skills がリンクの場合も触らない。
+function hasLinkedAncestor(path) {
+  for (let current = path; ; current = dirname(current)) {
+    if (stat(current)?.isSymbolicLink()) return true;
+    if (dirname(current) === current) return false;
+  }
+}
+
+function hasLinkedContent(path) {
+  const info = stat(path);
+  if (!info) return false;
+  if (info.isSymbolicLink()) return true;
+  return info.isDirectory() && readdirSync(path).some(name => hasLinkedContent(join(path, name)));
+}
+
+function inspectTarget(path, currentVersion) {
+  const info = stat(path);
+  const symlink = hasLinkedAncestor(path);
+  const marker = join(path, ENTRY_VERSION_FILE);
+  const managed = !symlink && info?.isDirectory() === true && stat(marker)?.isFile() === true;
+  const version = managed ? readFileSync(marker, 'utf8').trim() : null;
+  return { path, exists: info !== null, managed, symlink, version, stale: managed && version !== currentVersion };
+}
+
+export function entryStatus(options = {}) {
+  const { version } = resolveEntrySource(options);
+  return { version, targets: entryTargets(options.env).map(path => inspectTarget(path, version)) };
+}
+
+function installTarget(path, source, version, warn) {
+  if (hasLinkedAncestor(path) || hasLinkedContent(path) || hasLinkedContent(source)) {
+    warn(`symlink は変更しません: ${path}`);
+    return false;
+  }
+  const state = inspectTarget(path, version);
+  if (state.exists && !state.managed) {
+    warn(`入口スキルの版印がないため変更しません: ${path}`);
+    return false;
+  }
+  mkdirSync(path, { recursive: true });
+  cpSync(source, path, {
+    recursive: true,
+    filter: entry => {
+      const relativePath = relative(source, entry);
+      if (!relativePath) return true;
+      const parts = relativePath.split(sep);
+      return parts[0] !== 'test' && !parts.some(part => part.startsWith('.'));
+    },
+  });
+  // コピーに失敗した場合は旧版印を維持して次の起動で再試行する。
+  writeFileSync(join(path, ENTRY_VERSION_FILE), `${version}\n`);
+  return true;
+}
+
+/** 明示 install 済みの既定先だけを更新する。起動を止めず、出力もしない。 */
+export function refreshEntrySkillOnLaunch(options = {}) {
+  try {
+    const paths = entryTargets(options.env);
+    if (!paths.some(path => inspectTarget(path, null).managed)) return;
+    const { source, version } = resolveEntrySource(options);
+    for (const path of paths) {
+      try {
+        if (inspectTarget(path, version).stale) installTarget(path, source, version, () => {});
+      } catch { /* 次回起動で再試行 */ }
+    }
+  } catch { /* 入口の更新失敗で他のコマンドを止めない */ }
+}
+
+export async function runSkillsCommand(args, options = {}) {
+  const log = options.log ?? console.log;
+  const warn = options.logError ?? console.error;
+  if (args.includes('--help') || args.includes('-h')) {
+    log(usage);
+    return { exitCode: 0 };
+  }
+  try {
+    const [command, ...flags] = args;
+    const extra = [];
+    let entry = false;
+    let json = false;
+    for (let i = 0; i < flags.length; i++) {
+      if (flags[i] === '--entry') entry = true;
+      else if (flags[i] === '--json') json = true;
+      else if (flags[i] === '--target' && flags[i + 1] && !flags[i + 1].startsWith('-')) extra.push(flags[++i]);
+      else throw new Error(usage);
+    }
+    if (command === 'status' && json && !entry && !extra.length) {
+      log(JSON.stringify(entryStatus(options), null, 2));
+      return { exitCode: 0 };
+    }
+    if (!['install', 'remove'].includes(command) || !entry || json) throw new Error(usage);
+    const paths = entryTargets(options.env, extra);
+    const source = command === 'install' ? resolveEntrySource(options) : null;
+    let skipped = false;
+    for (const path of paths) {
+      if (command === 'install') {
+        if (installTarget(path, source.source, source.version, warn)) log(`入口スキルを配置しました: ${path}`);
+        else skipped = true;
+      } else {
+        if (!stat(path)) continue;
+        const state = inspectTarget(path, null);
+        if (!state.managed || hasLinkedContent(path)) {
+          warn(`版印がない、または symlink のため削除しません: ${path}`);
+          skipped = true;
+          continue;
+        }
+        rmSync(path, { recursive: true });
+        log(`入口スキルを削除しました: ${path}`);
+      }
+    }
+    return { exitCode: skipped ? 1 : 0 };
+  } catch (error) {
+    warn(error instanceof Error ? error.message : String(error));
+    return { exitCode: 1 };
+  }
+}

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

@@ -119,6 +119,7 @@
     "packages/schemas/package.json",
     "packages/word-book/package.json",
     "skills/address-review/SKILL.md",
+    "skills/akari/SKILL.md",
     "skills/analyze-footage/analysis-json.md",
     "skills/analyze-footage/bin/face-expression/vendor/tasks-vision-0.10.17/README-AKARI.md",
     "skills/analyze-footage/events-and-hooks.md",

package/vendor/docs/contract-2026-07-25-r6-audio-tracks-and-trim.md

@@ -1,114 +1,123 @@
-# R6 契約 — タイムライン配置原則・音源複数トラック化・音源トリム・ソーストリマー
-
-- 日付: 2026-07-25
-- 状態: draft（裁定は確定。実装と並走で approved 化）。本書は技術仕様のみ。
-  判断経緯・実装レーンの運用は非公開の内部記録で管理する（本リポには置かない方針）
-- 前提: `contract-2026-07-14-edit-json-v1-audio.md`（audio スキーマ正本）、
-  `contract-2026-07-17-data-contract-versioning.md`（三原則）
-
-## 1. 確定事項（2026-07-25 裁定）
-
-1. **タイムライン配置原則 = Premiere 型を正式採用**:
-   - 音源グループは**最下段固定**（並べ替え不可）
-   - cuts 帯（Video）はその上の縦中心。上に layers / captions（重ね物）
-   - 映像系トラック内の縦順は従来どおり**上の行ほど前面**（z 順裁定は不変）
-   - ルーラー（メモリ）位置は現状のまま固定
-   - 既定スタック（下から audio→cuts→layers→captions）と整合。本裁定はこれを
-     「固定の配置原則」として明文化するもの
-2. **音源の重なり解消 = 複数音声トラック化**:
-   - sfx の `track` フィールド（schema 既存）を UI で解放し、音声もトラックを増やせるようにする
-   - 従来の「audio は当面 ref 0 固定（単一トラック）」運用を本裁定で変更
-   - `timelineTrack` は kind:'audio' の複数宣言を既に許容（schema 変更不要）。
-     音声トラック群は配置原則 1 により常に最下段グループ内で増減する
-3. **ソーストリマーの入口 = タイムラインのクリップ dblclick**:
-   - クリップをダブルクリック → カット外部分を薄く表示し、左右スライドで in/out 調整
-   - 素材ファイルの dblclick = 素のソース再生、とは両立（入口が別）
-
-## 2. 音源トリム（schema 拡張）
-
-### schema
-
-- `sfxItem` に optional `in` / `out` を追加（**素材秒**。`in` ≥ 0 省略時 0、
-  `out` > `in` 省略時 素材末尾）。再生区間 = 素材の [in, out)、
-  タイムライン上の開始は従来どおり `t`（timeline 秒）、表示尺 = out − in
-- `narrationItem` にも同じ optional `in` / `out` を追加する。再生区間・素材秒・既定値・
-  `out > in` の検証分担は sfx と同一で、タイムライン上の開始は narration の `t` とする
-- `bgm` に optional `in` を追加（BGM ファイル内の開始オフセット素材秒。ループ・全体尺
-  トリムの既存意味論は不変）
-- edit-lint: `out <= in` を error。実尺越えの検知は lint では行わない
-  （lint は ffprobe を持たない — クランプは消費側の責務）
-- cuts 側の語彙に倣い、$comment に意味論を明記する
-
-### 消費（render-cut + preview）
-
-- render-cut: sfx の [in, out) 切り出しを出力に反映。bgm の `in` オフセット反映
-- render-cut: narration の [in, out) 切り出しも出力に反映する。`in` が素材実尺以上なら 0 へ、
-  `out` が素材実尺を超えれば素材末尾へクランプして warning を出す。クランプ後に `out <= in` なら
-  その narration 要素だけを skip する。`in` / `out` の有無にかかわらず、各 narration 要素は
-  デコード可否の判定を兼ねて実尺を従来と同じ 1 回だけ probe し、デコードできなければ従来どおり
-  その要素だけを skip して warning を出す一方、両方省略された要素には `atrim` を前置きせず、
-  従来とバイト同一のフィルタ文字列を保つ
-- preview（previewAudio）: 同意味論で再生。実尺越え in/out は素材末尾へクランプ
-
-### UI
-
-- 音源バーの端ドラッグでトリム（in/out 書き戻し）。動画クリップのトリムと同じ操作感
-- 複数音声トラック行の表示・追加・アイテムのトラック間移動（裁定 2）
-- 配置原則（裁定 1）の実装: audio グループ最下段固定・cuts 縦中心・上に重ね物。ルーラー無移動
-
-## 3. ソーストリマー
-
-- 入口: クリップ dblclick（裁定 3）。トリマーモード中はカット外を薄く表示し、
-  左右スライドで in/out を調整。解除は Esc / 再 dblclick / 他クリップ選択
-- サムネイルは素材全体のフィルムストリップを 1 回だけ焼き、窓移動は CSS
-  background-position のみで行う（トリム / スリップ操作で再焼成しない設計）
-
-## 4. 受け入れの軸
-
-- schema: schemas / edit-lint テスト全数 green
-- 消費: in/out 付き sfx の出力音声を ffprobe / 波形で実測（切り出し位置・尺一致）。
-  preview 側も同 fixture で聴感 + 実測。クランプ動作の実測
-- UI: 実機で (a) 配置原則どおりの表示 (b) 音声トラック追加とアイテム移動が edit.json に
-  書き戻る (c) 音源バー端ドラッグで in/out 書き戻り・リロード後保持 (d) トリマーの
-  表示・調整が機能 (e) 既存トラック UI・z 順の無退行
-
-## 5. §2 追記 — sfx フェード（audio-clip-fades, 2026-08-18・オーナー裁定「クリップ主義」T2）
-
-BGM をクリップ化する裁定（内部リポ `akari-video-internal` の該当タスク）に伴い、
-「音楽をクリップ（audio.sfx[]）として置いても BGM ベッドと同じフェード表現ができる」を
-満たすため、`sfxItem` に optional の `fade_in` / `fade_out`（秒・0 以上）を追加のみ拡張する
-（`version` 不変・`contract-2026-07-17-data-contract-versioning.md` の原則に従う）。
-
-### schema
-
-- `sfxItem.fade_in` / `fade_out`: 秒・省略時 0（フェードなし）。`audio.bgm.fadeIn` /
-  `fadeOut`（camelCase）とは異なり **snake_case**（既存の `gain_db` と同じ命名系列）
-- フェード対象はこのクリップの実効再生窓 `[t, t + 実効尺)`。実効尺は §2 の `[in, out)` が
-  既知なら `out − in`、`in`/`out` 省略時は素材尺（消費側が実尺を解決できた場合のみ）
-- クランプ規則は `audio.bgm.fadeIn`/`fadeOut` と同型: `fade_in`/`fade_out` それぞれ独立に
-  実効尺の半分までクランプ（render-cut が実装、edit-lint は `in`/`out` が両方既知のときだけ
-  警告できる — lint は ffprobe を持たないため実尺越えの検知は消費側の責務、という §2 本文の
-  既存原則をフェードにもそのまま適用）
-
-### 消費（render-cut + preview 3 面）
-
-- render-cut: sfx の afade を volume の直後・adelay の直前に挿入する（adelay 後だと
-  `st=0` が delay 由来の無音区間を指してしまうため）。`in`/`out` 併用時は atrim/asetpts で
-  尺をリセットした後の実効尺基準で afade を計算する
-- シェルプレビュー（akari-preview）: sfx は 1 回きりの `BufferSourceNode` 再生のため、
-  bgm の毎 tick 再計算（fadeMultiplier）ではなく、schedule 時点で
-  `gain.gain.setValueAtTime`/`linearRampToValueAtTime` によるブレークポイント列を組む
-  （`sfxFadeGainSchedule`、シーク再開時は経過秒からブレークポイントを再構成）
-- Web UI（preview-server）: bgm と同じ毎 tick 再計算方式。ただしこの層は現状 sfx の
-  `in`/`out` トリム自体を未実装のため、フェードの実効尺は常にデコード済み素材全長を使う
-  （トリム実装時に合わせて見直す）
-
-### インスペクター
-
-- akari-annotations: sfx 選択時に bgm と同じ「フェード」タブ（`fadeIn`/`fadeOut` ノブ）を出す。
-  ducking は bgm 概念のため sfx には出さない
-- 正本は `packages/edit-store`（edit.json テキスト手術）だが、本追記の実装レーン
-  （task 2026-08-18-audio-clip-fades）のファイル境界が `packages/edit-store` を含まないため、
-  書き戻りは `apps/shell/extensions/akari-annotations/src/common/sfx-fade-store.ts` に
-  境界内で完結する独立実装として置いた（`updateArrayElementByIndex` 等 edit-store の
-  export 済みユーティリティは再利用）。将来 edit-store 側の担当タスクが正本へ統合してよい
+# R6 契約 — タイムライン配置原則・音源複数トラック化・音源トリム・ソーストリマー
+
+- 日付: 2026-07-25
+- 状態: draft（裁定は確定。実装と並走で approved 化）。本書は技術仕様のみ。
+  判断経緯・実装レーンの運用は非公開の内部記録で管理する（本リポには置かない方針）
+- 前提: `contract-2026-07-14-edit-json-v1-audio.md`（audio スキーマ正本）、
+  `contract-2026-07-17-data-contract-versioning.md`（三原則）
+
+## 1. 確定事項（2026-07-25 裁定）
+
+1. **タイムライン配置原則 = Premiere 型を正式採用**:
+   - 音源グループは**最下段固定**（並べ替え不可）
+   - cuts 帯（Video）はその上の縦中心。上に layers / captions（重ね物）
+   - 映像系トラック内の縦順は従来どおり**上の行ほど前面**（z 順裁定は不変）
+   - ルーラー（メモリ）位置は現状のまま固定
+   - 既定スタック（下から audio→cuts→layers→captions）と整合。本裁定はこれを
+     「固定の配置原則」として明文化するもの
+2. **音源の重なり解消 = 複数音声トラック化**:
+   - sfx の `track` フィールド（schema 既存）を UI で解放し、音声もトラックを増やせるようにする
+   - 従来の「audio は当面 ref 0 固定（単一トラック）」運用を本裁定で変更
+   - `timelineTrack` は kind:'audio' の複数宣言を既に許容（schema 変更不要）。
+     音声トラック群は配置原則 1 により常に最下段グループ内で増減する
+3. **ソーストリマーの入口 = タイムラインのクリップ dblclick**:
+   - クリップをダブルクリック → カット外部分を薄く表示し、左右スライドで in/out 調整
+   - 素材ファイルの dblclick = 素のソース再生、とは両立（入口が別）
+
+## 2. 音源トリム（schema 拡張）
+
+### schema
+
+- `sfxItem` に optional `in` / `out` を追加（**素材秒**。`in` ≥ 0 省略時 0、
+  `out` > `in` 省略時 素材末尾）。再生区間 = 素材の [in, out)、
+  タイムライン上の開始は従来どおり `t`（timeline 秒）、表示尺 = out − in
+- `narrationItem` にも同じ optional `in` / `out` を追加する。再生区間・素材秒・既定値・
+  `out > in` の検証分担は sfx と同一で、タイムライン上の開始は narration の `t` とする
+- `bgm` に optional `in` を追加（BGM ファイル内の開始オフセット素材秒。ループ・全体尺
+  トリムの既存意味論は不変）
+- edit-lint: `out <= in` を error。実尺越えの検知は lint では行わない
+  （lint は ffprobe を持たない — クランプは消費側の責務）
+- cuts 側の語彙に倣い、$comment に意味論を明記する
+
+### 消費（render-cut + preview）
+
+- render-cut: sfx の [in, out) 切り出しを出力に反映。bgm の `in` オフセット反映
+- render-cut: narration の [in, out) 切り出しも出力に反映する。`in` が素材実尺以上なら 0 へ、
+  `out` が素材実尺を超えれば素材末尾へクランプして warning を出す。クランプ後に `out <= in` なら
+  その narration 要素だけを skip する。`in` / `out` の有無にかかわらず、各 narration 要素は
+  デコード可否の判定を兼ねて実尺を従来と同じ 1 回だけ probe し、デコードできなければ従来どおり
+  その要素だけを skip して warning を出す一方、両方省略された要素には `atrim` を前置きせず、
+  従来とバイト同一のフィルタ文字列を保つ
+- preview（previewAudio）: 同意味論で再生。実尺越え in/out は素材末尾へクランプ
+
+### UI
+
+- 音源バーの端ドラッグでトリム（in/out 書き戻し）。動画クリップのトリムと同じ操作感
+- 複数音声トラック行の表示・追加・アイテムのトラック間移動（裁定 2）
+- 配置原則（裁定 1）の実装: audio グループ最下段固定・cuts 縦中心・上に重ね物。ルーラー無移動
+
+## 3. ソーストリマー
+
+- 入口: クリップ dblclick（裁定 3）。トリマーモード中はカット外を薄く表示し、
+  左右スライドで in/out を調整。解除は Esc / 再 dblclick / 他クリップ選択
+- サムネイルは素材全体のフィルムストリップを 1 回だけ焼き、窓移動は CSS
+  background-position のみで行う（トリム / スリップ操作で再焼成しない設計）
+
+## 4. 受け入れの軸
+
+- schema: schemas / edit-lint テスト全数 green
+- 消費: in/out 付き sfx の出力音声を ffprobe / 波形で実測（切り出し位置・尺一致）。
+  preview 側も同 fixture で聴感 + 実測。クランプ動作の実測
+- UI: 実機で (a) 配置原則どおりの表示 (b) 音声トラック追加とアイテム移動が edit.json に
+  書き戻る (c) 音源バー端ドラッグで in/out 書き戻り・リロード後保持 (d) トリマーの
+  表示・調整が機能 (e) 既存トラック UI・z 順の無退行
+
+## 5. §2 追記 — sfx フェード（audio-clip-fades, 2026-08-18・オーナー裁定「クリップ主義」T2）
+
+BGM をクリップ化する裁定（内部リポ `akari-video-internal` の該当タスク）に伴い、
+「音楽をクリップ（audio.sfx[]）として置いても BGM ベッドと同じフェード表現ができる」を
+満たすため、`sfxItem` に optional の `fade_in` / `fade_out`（秒・0 以上）を追加のみ拡張する
+（`version` 不変・`contract-2026-07-17-data-contract-versioning.md` の原則に従う）。
+
+### schema
+
+- `sfxItem.fade_in` / `fade_out`: 秒・省略時 0（フェードなし）。`audio.bgm.fadeIn` /
+  `fadeOut`（camelCase）とは異なり **snake_case**（既存の `gain_db` と同じ命名系列）
+- フェード対象はこのクリップの実効再生窓 `[t, t + 実効尺)`。実効尺は §2 の `[in, out)` が
+  既知なら `out − in`、`in`/`out` 省略時は素材尺（消費側が実尺を解決できた場合のみ）
+- クランプ規則は `audio.bgm.fadeIn`/`fadeOut` と同型: `fade_in`/`fade_out` それぞれ独立に
+  実効尺の半分までクランプ（render-cut が実装、edit-lint は `in`/`out` が両方既知のときだけ
+  警告できる — lint は ffprobe を持たないため実尺越えの検知は消費側の責務、という §2 本文の
+  既存原則をフェードにもそのまま適用）
+
+### 消費（render-cut + preview 3 面）
+
+- render-cut: sfx の afade を volume の直後・adelay の直前に挿入する（adelay 後だと
+  `st=0` が delay 由来の無音区間を指してしまうため）。`in`/`out` 併用時は atrim/asetpts で
+  尺をリセットした後の実効尺基準で afade を計算する
+- シェルプレビュー（akari-preview）: sfx は 1 回きりの `BufferSourceNode` 再生のため、
+  bgm の毎 tick 再計算（fadeMultiplier）ではなく、schedule 時点で
+  `gain.gain.setValueAtTime`/`linearRampToValueAtTime` によるブレークポイント列を組む
+  （`sfxFadeGainSchedule`、シーク再開時は経過秒からブレークポイントを再構成）
+- 同・会話音声（narration / 音声レーンの `role:'speech'`）: 2026-09-18 追記。上と同じ
+  ブレークポイント列の仕組みに乗せる（`buildWebAudioSchedule` は kind に依らず
+  `fadeGainEvents` を通す）。**窓の取り方だけが sfx と非対称**で、sfx は item の実効尺を
+  そのまま使う一方、narration は `min(track.durationSec, max(0, duration − track.t))` と
+  タイムライン末尾で切る。これは `render-cut/src/plan.mjs` の実際の扱いに合わせたもので、
+  揃えると sfx が書き出しと食い違う。クランプ規則（実効尺の半分まで独立に）は共通
+- なお cuts / layers の撮影素材音声（プレビューの kind `'speech'`）は宣言にフェード項目を
+  持たず、書き出し側も cut 音声に afade を掛けない。ここにフェードを足すと逆に
+  書き出しとの食い違いを作るため、**意図的に対象外**とする
+- Web UI（preview-server）: bgm と同じ毎 tick 再計算方式。ただしこの層は現状 sfx の
+  `in`/`out` トリム自体を未実装のため、フェードの実効尺は常にデコード済み素材全長を使う
+  （トリム実装時に合わせて見直す）
+
+### インスペクター
+
+- akari-annotations: sfx 選択時に bgm と同じ「フェード」タブ（`fadeIn`/`fadeOut` ノブ）を出す。
+  ducking は bgm 概念のため sfx には出さない
+- 正本は `packages/edit-store`（edit.json テキスト手術）だが、本追記の実装レーン
+  （task 2026-08-18-audio-clip-fades）のファイル境界が `packages/edit-store` を含まないため、
+  書き戻りは `apps/shell/extensions/akari-annotations/src/common/sfx-fade-store.ts` に
+  境界内で完結する独立実装として置いた（`updateArrayElementByIndex` 等 edit-store の
+  export 済みユーティリティは再利用）。将来 edit-store 側の担当タスクが正本へ統合してよい

package/vendor/docs/contract-2026-08-02-preview-parity.md

@@ -76,6 +76,14 @@ cut 境界の選択は宣言順ではなく解決済みタイムラインと z-o
   語彙は `"source"` の 1 つだけで、マーカーが立つのは「今 fit 基準で描かれている全 media item に `scale × fit`
   （`fit = min(outputW / srcW, outputH / srcH)`・srcW / srcH は表示回転後）を一度だけ焼き込んだ」ことを意味する
   （部分適用は禁止。移行は `packages/edit-store/bin/normalize-geometry.mjs`）。x / y / rotate は両基準で同じ意味なので触らない。
+  **「ソース実寸」= 原本の論理寸法（表示回転後）であり、復号フレームの画素寸法ではない（2026-09-18 追記）**。
+  プロキシを復号していてもこの基準は動かない。ここが曖昧だったため、ベースカットのクロップ計算が
+  復号フレーム＝プロキシ寸法を使い、追加レイヤーと寸法基準が食い違っていた（不具合メモ 第10項:
+  1920×1080 原本 / 960×540 プロキシで crop 幅 0.5・scale 1 が 960×1080 ではなく 480×540 になる）。
+  frame-engine 側は `NativeFrameSource.logicalSize` の宣言を基準に使い、宣言が無い / 壊れている
+  ときだけ復号寸法へ退避する（`compositionSourceSize`）。したがってプロキシを復号し得る呼び出し側は
+  原本メタデータから `logicalSize` を宣言する責務を負う。宣言を足すのと、プロキシ差し替えに伴う
+  倍率補償を外すのは、二重補正を避けるため**同一の作業単位**で行う。
   **G1（マーカー・移行・lint の warning `geometry.fit-compat`）ではエンジンはこのマーカーを読まず、描画は 1 バイトも変わらない。
   描画へ反映するのは G2**。cross ref: `docs/contract-2026-07-22-render-basics.md` §4-1（#6 画角操作）。
 

package/vendor/docs/contract-2026-08-03-caption-display-encoding-qc-v1.md

@@ -10,9 +10,30 @@
 `packages/edit-store/src/caption-display.ts` is the only resolver for the opt-in
 `display_policy.mode: "single_line_sequential"` contract. It projects source captions through a
 linear cut/speed/multi-source timeline, then resolves one or two fragments, timing, source
-provenance, merged style variables, and reference-pixel geometry. Render-cut, preview-server, and
-the shell backend consume that result. Browser code only selects already-resolved timeline cues; it
-must not call `Intl.Segmenter` or implement the split algorithm.
+provenance, merged style variables, and reference-pixel geometry. Browser code only selects
+already-resolved timeline cues; it must not call `Intl.Segmenter` or implement the split algorithm.
+
+Every consumer reaches that kernel through one shared entry point,
+`packages/render-cut/src/caption-resolve.mjs` (`resolveCaptionPlan`), which also owns the steps in
+front of it: style-preset resolution, excluded-cue filtering, word-book protected terms, and cut
+normalization. The consumers are render-cut's internal render path, preview-server, gpu-export,
+and osr-export. Naming the kernel alone was not enough: until 2026-09-20 each consumer assembled
+that front half itself, so preview-server handed the kernel a v2 edit with no derived `cuts` and
+resolved zero display cues, while gpu-export and osr-export never consulted `display_policy` at all
+and re-split captions through the legacy overlay generator. A consumer that calls the kernel
+directly, or rebuilds any of those front-half steps, is a deviation.
+
+**Known remaining deviation — the shell backend.** `AkariPreviewService.resolveCaptionDisplay`
+(`apps/shell/extensions/akari-preview/src/node/akari-preview-service.ts`) still calls the kernel
+directly and rebuilds the front half on its own: its own preset resolution, its own cut
+normalization (`captionCompatibleCuts`, computed in frames off `internal.tracks` rather than the
+shared `captionDisplayEdit`), and its own word-book lookup that walks up from `__dirname` and
+silently degrades to no protected terms on any failure. **It never applies excluded-cue
+filtering**, so a cue excluded through `tracks[].items[].source.exclude` still appears in the
+in-app preview while the other four paths drop it. This is a preview-parity hazard of the same
+class as the two defects above. It is listed here rather than silently tolerated; the shell is
+bundled by Theia and cannot assume `packages/` sits next to it, so routing it through
+`resolveCaptionPlan` is a packaging question, not a one-line import.
 
 The policy rejects unsupported `at`, `track`, transition, and timeline winner semantics; caption
 style/emphasis conflicts; non-NFC or trimmed text; invalid manual fragments; unresolved long text;

package/vendor/docs/contract-2026-09-13-world-map-v0.md

@@ -25,6 +25,8 @@
 ## 3. 描画
 
 flat world は 1 個の overlay 断片で構成する。Canvas 層は背景、格子、遠景、portal、cut の覆いを描き、DOM sheet 層は素材と文字を持つ。各 world は直下の `.akari-world-sheet[data-world]`、zone はその子の `.akari-world-zone[data-zone]` とし、sheet 自身は left / top 0、zone の px は bounds 原点を引かない world 座標そのままとする。sheet の transform は authoring 時に固定せず、ランタイムが `camera(t)` から設定する。DOM と Canvas の混在出力は rasterize 経路を使う。
+素材の時計の起点は同じ zone id の stop の `at + delay`（`delay` は秒・省略 0・0 以上）とし、到着前は 0 秒で止める。
+`role: "background"` の素材を含む zone はカリングしない。role 省略時も `vars` の `world-width` / `world-height`（`--` 接頭辞も可）があれば背景として扱う。
 
 spatial world は `akari world build` が `assets/world/world.glb` と `overlays/world.html` の
 three 断片へ決定論的に焼く。GLB は `worlds[].spatial.floor`、`background`、`haze`、
@@ -40,7 +42,7 @@ three 宣言は `model`、`camera.fromModel: "TourCamera"`、`animationClip: "To
 - `akari world build`: flat は宣言、sheet、zone、解決済み素材断片を `overlays/world.html` に生成する。spatial は世界 GLB と three 断片を生成する。どちらも edit.json の `world` item を id 安定で upsert する。edit.json が version 2 でなければ変更せず停止するため、先に `akari migrate <project-root>` を実行する。
 - `akari world preview [--measure]`: flat / spatial とも rasterize 経路で stop と edge の代表時点を PNG と `camera-proof.json` にする。measure 時は非 move edge の全画素 RGB 標準偏差が 2 以下になる完全被覆区間を 30 Hz で測り、該当する `transition.cover` だけを書き戻す。
 - `preview --measure` は入口では C7 を問わず、実測値を書き戻した後に C7 を含む全項目を検査する。
-- `akari world overview`: 外部通信を行わず `file://` で開ける自己完結の俯瞰 HTML を生成する。
+- `akari world overview`: `overlays/world.html` の実断片を srcdoc iframe に同じ時刻で埋め込み、全世界を収める view で並べる。ピンクの撮影枠・カメラ軌道・場面ジャンプ・拡縮パン・カメラ追従・右欄の `.akari/out` 最新 MP4 を持ち、build 前は床だけへフォールバックする。外部通信 0・`file://` 直開き可で、`--json` は生成先を返す。
 - `akari world move-stop <project-root> --stop <id> --c x,y[,scale] [--json]`: flat の停留所座標だけを更新する。元テキストの整形と他の欄を変えず、bounds 外・spatial・不変条件違反では一切書き込まない。
 
 同じ入力から得る HTML と画像は決定論的でなければならない。素材 id は asset resolver で解決し、未解決時は失敗として扱う。
@@ -58,7 +60,7 @@ akari world overview .
 ## 5. 地図 UI
 
 - 実装のマーカー判定は `akari-shell-strip` の ContextKey `akari.worldMap` に一元化する。
-- main の「地図」タブは `akari-world-view` が担う。
+- main の「地図」タブは `akari-world-view` が担い、`akari world overview --json` が生成した同じ HTML を webview に表示する（描画実装は 1 か所）。
 - タイムラインのワールド帯と地図インスペクターは `akari-annotations` が担う。
 
 地図 UI は 2D 俯瞰、ワールド帯、再生時刻に追従する撮影枠、選択中の stop / edge 詳細を提供する。v1 では flat の停留所の座標だけを ⌥ ドラッグで `world-map.json` へ書き戻せる。書き手は `akari world move-stop` の 1 本に限定し、bounds 外・spatial・不変条件違反では書き込まない。`world-map.json` は edit.json の履歴の外にあるため、undo / redo は未対応とする。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.71",
+  "version": "0.1.72",
   "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-lint/README.md

@@ -53,6 +53,12 @@ item. Each source is probed once, and media finding paths include the source ID.
   past the container duration are reported by `media.source-range` instead.
 - `media.caption-silence-coverage`: warns when more than 30% of caption display time overlaps a
   silence interval of at least one second. `--caption-silence-warn-percent` changes the threshold.
+- `media.crop-scale-proxy-ratio`: warns when a cropped media item's `transform.scale` equals its
+  source's original-to-proxy dimension ratio. That value was the workaround while preview decoded
+  the proxy and export preferred it; now that both decode the original it enlarges the framing by
+  the ratio. Needs the dimensions of both files, so it only runs under `--media`; sources without a
+  `proxy`, items without a `crop` or a declared `scale`, equal-size proxies (a ratio of 1 cannot be
+  told apart from the default `scale`), and files whose dimensions cannot be read are all skipped.
 - `audio.narration.trim`: warns when a narration media item's `in` is at or beyond its audio-stream
   duration but still inside the container duration. Invalid or reversed narration `in`/`out` values
   are errors even without `--media`; an `in` past the container duration is a `media.source-range`

package/vendor/packages/edit-lint/src/edit-lint.mjs

@@ -5754,6 +5754,7 @@ function runReferencedMediaChecks(rawEdit, projectedEdit, findings, skipped, pat
   );
   validateMediaSourceRange(rangeItems, probeBySourceId, sourcesById, findings, skipped, fps);
   validateNarrationMediaStart(narrationItems, probeBySourceId, findings, skipped);
+  validateCropScaleProxyRatio(rangeItems, sourcesById, findings, skipped, paths, options);
 
   if (Array.isArray(rawEdit?.audio?.narration)) {
     for (const [index, item] of rawEdit.audio.narration.entries()) {
@@ -6258,6 +6259,130 @@ function probeMediaAudio(sourcePath, configuredCommand) {
   };
 }
 
+// 原本 / プロキシの寸法比と scale の一致判定に使う相対許容差。回避策期間の値は
+// 「原本 ÷ プロキシ」をそのまま書いた比なので、浮動小数の丸め分だけ見ればよい。
+const CROP_SCALE_PROXY_RATIO_TOLERANCE = 1e-3;
+
+/**
+ * 回避策期間（プレビューがプロキシを復号し、書き出しもプレビュー用プロキシを優先していた頃）に
+ * 保存された `transform.scale` を拾う。当時は crop を持つ item の scale へ「原本 ÷ プロキシ」の
+ * 寸法比を入れて自己整合させていたため、書き出しが原本を復号する現在はその値がそのまま効いて
+ * 構図が寸法比の分だけ膨らむ（不具合メモ 第10項 / 第18項の根本修正後に残る実害）。
+ *
+ * 寸法比と偶然一致する正当なズームもあり得るので warning に留める（止めずに知らせる）。
+ * 判定は静的な `transform.scale` だけを見る。proxy 宣言の無い source・crop の無い item・
+ * 寸法が読めない素材は対象外にして誤検知を出さない。
+ */
+export function findCropScaleProxyRatioFindings(items, ratioOf) {
+  // 半々配置の案件では同じ素材の cropped item が 100 件近く並ぶ（実機 2026-09-15: 95 件）。
+  // 直せる値は素材ごとに 1 つなので、素材 × scale 単位で 1 件へまとめて件数を添える
+  // （geometry.fit-compat が移行案内を 1 件で出すのと同じ方針）。
+  const groups = new Map();
+  for (const entry of items) {
+    const item = entry?.item;
+    if (!isRecord(item) || !isRecord(item.crop) || !isRecord(item.transform)) continue;
+    const scale = item.transform.scale;
+    if (!isPositiveNumber(scale)) continue;
+    const measured = ratioOf(entry.sourceId);
+    if (!isRecord(measured) || !isPositiveNumber(measured.ratio)) continue;
+    const ratio = measured.ratio;
+    // 等寸プロキシ（比 1）は既定値 scale=1 と区別できないため見ない。
+    if (ratio <= 1 + CROP_SCALE_PROXY_RATIO_TOLERANCE) continue;
+    if (Math.abs(scale - ratio) > CROP_SCALE_PROXY_RATIO_TOLERANCE * ratio) continue;
+    const key = `${entry.sourceId}${scale}`;
+    const group = groups.get(key);
+    if (group === undefined) groups.set(key, { entry, scale, measured, count: 1 });
+    else group.count += 1;
+  }
+  return [...groups.values()].map(({ entry, scale, measured, count }) => {
+    const { ratio, original, proxy } = measured;
+    return {
+      severity: "warning",
+      check: "media.crop-scale-proxy-ratio",
+      message: `素材 ${entry.sourceId} の crop を持つ item ${count} 件の transform.scale ${formatNumber(scale)} が、`
+        + `原本 ÷ プロキシの寸法比（${original.width}x${original.height} ÷ ${proxy.width}x${proxy.height}`
+        + ` = ${formatNumber(ratio)}）と一致します。プレビューがプロキシを復号していた時期の回避策の値`
+        + `である可能性が高く、原本を復号する現在は構図が約 ${formatNumber(ratio)} 倍に拡大します。`
+        + `意図したズームでなければ transform.scale を原本基準（通常 1）へ戻してください。`,
+      path: `${entry.itemPath}.transform.scale`,
+    };
+  });
+}
+
+function validateCropScaleProxyRatio(items, sourcesById, findings, skipped, paths, options) {
+  const candidates = items.filter((entry) => isRecord(entry?.item)
+    && isRecord(entry.item.crop)
+    && isRecord(entry.item.transform)
+    && isPositiveNumber(entry.item.transform.scale)
+    && isNonEmptyString(sourcesById.get(entry.sourceId)?.proxy));
+  if (candidates.length === 0) return;
+
+  let command;
+  try {
+    command = options.ffprobeCommand ?? process.env.FFPROBE ?? resolveFfprobe();
+  } catch (error) {
+    addSkipped(skipped, "media.crop-scale-proxy-ratio",
+      `source dimensions unavailable: ${messageOf(error)}`);
+    return;
+  }
+
+  const ratioBySourceId = new Map();
+  const ratioOf = (sourceId) => {
+    if (!ratioBySourceId.has(sourceId)) {
+      ratioBySourceId.set(sourceId, proxyDimensionRatio(sourcesById.get(sourceId), paths, command));
+    }
+    return ratioBySourceId.get(sourceId);
+  };
+  for (const finding of findCropScaleProxyRatioFindings(candidates, ratioOf)) {
+    addFinding(findings, finding);
+  }
+  for (const [sourceId, measured] of ratioBySourceId) {
+    if (measured === null) {
+      addSkipped(skipped, "media.crop-scale-proxy-ratio",
+        `source ${sourceId}: original / proxy dimensions are unavailable`);
+    }
+  }
+}
+
+/** 原本とプロキシの寸法比。片方でも読めない・縦横で比が違う場合は null（対象外）。 */
+function proxyDimensionRatio(source, paths, command) {
+  if (!isRecord(source) || !isNonEmptyString(source.path) || !isNonEmptyString(source.proxy)) {
+    return null;
+  }
+  const original = probeVideoDimensions(resolveReference(paths.editPath, source.path, paths), command);
+  const proxy = probeVideoDimensions(resolveReference(paths.editPath, source.proxy, paths), command);
+  if (original === null || proxy === null) return null;
+  const widthRatio = original.width / proxy.width;
+  const heightRatio = original.height / proxy.height;
+  // アスペクト比を変えたプロキシでは「寸法比」が一意に決まらないので判定しない。
+  if (Math.abs(widthRatio - heightRatio) > CROP_SCALE_PROXY_RATIO_TOLERANCE * widthRatio) {
+    return null;
+  }
+  return { ratio: widthRatio, original, proxy };
+}
+
+function probeVideoDimensions(filePath, command) {
+  const result = spawnSync(command, [
+    "-v", "error",
+    "-select_streams", "v:0",
+    "-show_entries", "stream=width,height",
+    "-of", "json",
+    filePath,
+  ], { encoding: "utf8", maxBuffer: 16 * 1024 * 1024 });
+  if (result.error || result.status !== 0) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(String(result.stdout ?? ""));
+  } catch {
+    return null;
+  }
+  const stream = Array.isArray(parsed?.streams) ? parsed.streams[0] : undefined;
+  const width = Number(stream?.width);
+  const height = Number(stream?.height);
+  if (!isPositiveNumber(width) || !isPositiveNumber(height)) return null;
+  return { width, height };
+}
+
 async function validateProxyGops(rawEdit, findings, paths, options) {
   const declarations = [];
   if (isRecord(rawEdit?.source) && isNonEmptyString(rawEdit.source.proxy)) {

package/vendor/packages/edit-store/lib/audio-schedule.js

@@ -145,9 +145,20 @@ function scheduleTimed(item, timelineDurationSec, startAtSec, duckIntervals) {
         return null;
     const timelineStartSec = startAtSec + delaySec;
     const baseGain = dbToLinear(item.gainDb);
-    const gainEvents = item.kind === 'sfx'
-        ? fadeGainEvents(item.spec.fade_in ?? item.spec.fadeIn, item.spec.fade_out ?? item.spec.fadeOut, item.itemDurationSec, elapsedIntoItemSec, durationSec, baseGain)
-        : [{ offsetSec: 0, value: baseGain, method: 'set' }];
+    // 会話音声（audio.narration と、音声レーンの role:'speech' — プレビューは後者も kind
+    // 'narration' として流す）も sfx と同じクリップフェードを持つ。フェード窓の取り方だけ
+    // kind ごとに render-cut へ合わせる（クランプ規則は fadeGainEvents が両者共通で持つ）:
+    //   sfx       -> trim の実効尺そのまま。plan.mjs は
+    //                resolveSfxFadeSeconds(sfx, trim.effectiveDuration) をタイムライン末尾で
+    //                切らずに使う（envelope 用の別変数だけが clamp される）
+    //   narration -> タイムライン末尾で切った尺。plan.mjs の
+    //                narrationDuration = Math.min(track.durationSec, Math.max(0, duration - track.t))
+    //                と同一。これは elapsedIntoItemSec + durationSec（fadeGainEvents の windowEnd）
+    //                と恒等だが、対応先が読めるよう plan.mjs と同じ式で書く
+    const fadeWindowSec = item.kind === 'sfx'
+        ? item.itemDurationSec
+        : Math.min(item.itemDurationSec, Math.max(0, timelineDurationSec - item.t));
+    const gainEvents = fadeGainEvents(item.spec.fade_in ?? item.spec.fadeIn, item.spec.fade_out ?? item.spec.fadeOut, fadeWindowSec, elapsedIntoItemSec, durationSec, baseGain);
     return {
         kind: item.kind,
         id: item.id,
@@ -273,6 +284,9 @@ function scheduleSpeech(spec, timelineDurationSec, startAtSec, warnings) {
     if (!(durationSec > 0))
         return null;
     const baseGain = dbToLinear(gainDb);
+    // kind 'speech' は cuts / layers の撮影素材音声（projectSpeechDeclarations の産物）で、
+    // クリップフェード宣言を持たない（render-cut 側も cut 音声に afade を掛けない）。
+    // 音声レーンの role:'speech' アイテムは kind 'narration' 側へ流れ、そこでフェードが掛かる。
     const gainEvents = speechCrossfadeGainEvents(effectiveDurationSec, elapsedIntoItemSec, durationSec, crossfadeInSec, crossfadeOutSec, baseGain);
     return {
         kind: 'speech',
@@ -498,6 +512,20 @@ function normalizedGainDb(spec, label, warnings) {
         warnings.push(`${label}: gain_db clamped to [-60, 12]`);
     return clamped;
 }
+/**
+ * クリップフェード（`audio.sfx[]` / `audio.narration[]` / 音声レーンの role:'speech' の
+ * `fade_in` / `fade_out`）のブレークポイント列。
+ *
+ * render-cut の `resolveSfxFadeSeconds` + `audioFadeFilters`（`packages/render-cut/src/plan.mjs`）
+ * と同じ意味論を持つ:
+ * - `fade_in` / `fade_out` はそれぞれ独立に実効尺（`itemDurationSec`）の半分までクランプ
+ * - 未指定・非有限・負値は「フェードなし」として 0 扱い
+ * - フェードインは窓頭（`afade=t=in:st=0:d=fade_in`）、フェードアウトは
+ *   `itemDurationSec - fade_out`（`afade=t=out:st=…:d=fade_out`）から線形
+ *
+ * 契約: `docs/contract-2026-07-25-r6-audio-tracks-and-trim.md` §2 追記（audio-clip-fades）。
+ * シーク再開時は `elapsedIntoItemSec` から窓を切り直すだけで、掛かり方は変えない。
+ */
 function fadeGainEvents(rawFadeIn, rawFadeOut, itemDurationSec, elapsedIntoItemSec, availableSec, baseGain) {
     const ceiling = itemDurationSec / 2;
     const fadeIn = finitePositive(rawFadeIn) ? Math.min(rawFadeIn, ceiling) : 0;

package/vendor/packages/edit-store/lib/internal-model.js

@@ -706,6 +706,10 @@ function buildV2VisualItem(item, fps, ref, pathOf, chromaKeyOf, legacyIndexCount
                     id: item.id, t: at, duration, kind: 'video', src: path ?? item.source.src,
                     in: item.source.in,
                     track: ref, ...common, ...copyMediaSourceFields(item.source, captionSwitch),
+                    // cuts 側（下の EditCut / declaration）と同じく、素材窓が出力尺と 1 フレーム超ずれた
+                    // ときの再生速度をレイヤー宣言にも渡す。落とすと out - in ≠ duration の追加映像が
+                    // 等倍のまま伸びて（= 速度が落ちて）書き出される。
+                    ...(speed !== undefined ? { speed } : {}),
                     ...('audio' in item && item.audio === false ? { audio: false } : {})
                 };
                 const value = declaration;
@@ -898,6 +902,11 @@ function buildV2AudioItem(item, fps, ref, pathOf, legacyIndexCounters) {
             t: at,
             path: resolvedPath,
             track: ref,
+            // fade_in / fade_out は render-cut の resolveSfxFadeSeconds が snake_case で読む
+            // （sfx 宣言と同じ綴り。bgm だけが camelCase の fadeIn / fadeOut）。
+            // 落とすと afade が生成コマンドから丸ごと消え、会話音声のフェードが書き出しに乗らない。
+            ...(item.fade_in !== undefined ? { fade_in: item.fade_in } : {}),
+            ...(item.fade_out !== undefined ? { fade_out: item.fade_out } : {}),
             ...(item.gain_db !== undefined ? { gainDb: item.gain_db } : {}),
             ...sourceClipFx,
             ...itemClipFx,
@@ -917,6 +926,8 @@ function buildV2AudioItem(item, fps, ref, pathOf, legacyIndexCounters) {
                 id: item.id, atFrames, durationFrames, at, duration, children: [], source,
                 declaration: {
                     id: item.id, t: at, path: resolvedPath,
+                    ...(item.fade_in !== undefined ? { fade_in: item.fade_in } : {}),
+                    ...(item.fade_out !== undefined ? { fade_out: item.fade_out } : {}),
                     ...(item.gain_db !== undefined ? { gain_db: item.gain_db } : {}),
                     ...sourceClipFx,
                     ...itemClipFx,

package/vendor/packages/edit-store/lib/webview-kernel.js

@@ -1393,14 +1393,15 @@ var AkariEditKernel = (() => {
     if (!(durationSec > 0)) return null;
     const timelineStartSec = startAtSec + delaySec;
     const baseGain = dbToLinear2(item.gainDb);
-    const gainEvents = item.kind === "sfx" ? fadeGainEvents(
+    const fadeWindowSec = item.kind === "sfx" ? item.itemDurationSec : Math.min(item.itemDurationSec, Math.max(0, timelineDurationSec - item.t));
+    const gainEvents = fadeGainEvents(
       item.spec.fade_in ?? item.spec.fadeIn,
       item.spec.fade_out ?? item.spec.fadeOut,
-      item.itemDurationSec,
+      fadeWindowSec,
       elapsedIntoItemSec,
       durationSec,
       baseGain
-    ) : [{ offsetSec: 0, value: baseGain, method: "set" }];
+    );
     return {
       kind: item.kind,
       id: item.id,
@@ -3105,6 +3106,10 @@ var AkariEditKernel = (() => {
             track: ref,
             ...common,
             ...copyMediaSourceFields(item.source, captionSwitch),
+            // cuts 側（下の EditCut / declaration）と同じく、素材窓が出力尺と 1 フレーム超ずれた
+            // ときの再生速度をレイヤー宣言にも渡す。落とすと out - in ≠ duration の追加映像が
+            // 等倍のまま伸びて（= 速度が落ちて）書き出される。
+            ...speed !== void 0 ? { speed } : {},
             ..."audio" in item && item.audio === false ? { audio: false } : {}
           };
           const value2 = declaration;
@@ -3372,6 +3377,11 @@ var AkariEditKernel = (() => {
         t: at,
         path: resolvedPath,
         track: ref,
+        // fade_in / fade_out は render-cut の resolveSfxFadeSeconds が snake_case で読む
+        // （sfx 宣言と同じ綴り。bgm だけが camelCase の fadeIn / fadeOut）。
+        // 落とすと afade が生成コマンドから丸ごと消え、会話音声のフェードが書き出しに乗らない。
+        ...item.fade_in !== void 0 ? { fade_in: item.fade_in } : {},
+        ...item.fade_out !== void 0 ? { fade_out: item.fade_out } : {},
         ...item.gain_db !== void 0 ? { gainDb: item.gain_db } : {},
         ...sourceClipFx,
         ...itemClipFx,
@@ -3399,6 +3409,8 @@ var AkariEditKernel = (() => {
             id: item.id,
             t: at,
             path: resolvedPath,
+            ...item.fade_in !== void 0 ? { fade_in: item.fade_in } : {},
+            ...item.fade_out !== void 0 ? { fade_out: item.fade_out } : {},
             ...item.gain_db !== void 0 ? { gain_db: item.gain_db } : {},
             ...sourceClipFx,
             ...itemClipFx,

package/vendor/packages/edit-store/lib/write-gate.d.ts

@@ -43,6 +43,20 @@ export interface DeferredLintOptions {
      */
     onDidWrite?: (filePath: string, content: string) => void;
 }
+/** 影プロジェクトの 1 エントリをどう実体化したか。 */
+export type ShadowEntryStrategy = 'symlink' | 'copy' | 'skip';
+/**
+ * 影プロジェクト構築の決定論テスト用シーム。本番呼び出しは既定（fs.symlink）のままで、
+ * 何も渡さなければ挙動は従来と同一。
+ */
+export interface ShadowLintHooks {
+    /** symlink の差し替え口。権限のある環境／無い環境をテストから作り分けるためだけに使う。 */
+    symlink?: (target: string, path: string, type: 'junction' | 'file') => Promise<void>;
+    /** エントリ 1 件ごとに実体化の手段を通知する観測口。 */
+    onShadowEntry?: (name: string, strategy: ShadowEntryStrategy) => void;
+    /** 影プロジェクトを作れず候補のメモリ検証へ退避したことを通知する観測口。 */
+    onShadowUnavailable?: (reason: string) => void;
+}
 /**
  * 実ファイルは変更せず、候補全文だけを options.inputOverrides で差し替えて検証する。
  * 既存 export のシグネチャは維持し、preview-server の保存前検査にも使える。
@@ -52,8 +66,15 @@ export declare function lintProjectCandidates(projectRoot: string, candidates: L
  * 実ディスクを直接読む lint check（motion 袋参照等）を含め、候補一式を保存前に検証する。
  * 元プロジェクトの直下エントリは影プロジェクトへ symlink し、候補の祖先だけを実体化する。
  * 既存 lintProjectCandidates の inputOverrides 契約は変更せず、Project API だけがこの入口を使う。
+ *
+ * リンクが使えない環境（Windows の非特権ユーザー等）では**ファイルだけコピーへ倒す**。
+ * 影プロジェクトは lint の読み取り専用ステージングなので、ファイルはコピーで等価であり、
+ * かつ影側への書き込みが元プロジェクトへ伝播しない（symlink 経路と同じ安全性）。
+ * ディレクトリはコピーしない: プロジェクト直下には assets/（4K 原本が何十 GB）が来るため、
+ * junction も作れない環境では影プロジェクトの構築自体を諦め、候補のメモリ差し替えだけで
+ * 検証する（実ディスクを読む check は落ちるが、保存は止めない — 冒頭の fail-open 裁定）。
  */
-export declare function lintProjectCandidatesOnDisk(projectRoot: string, candidates: LintCandidates): Promise<EditLintGateResult>;
+export declare function lintProjectCandidatesOnDisk(projectRoot: string, candidates: LintCandidates, hooks?: ShadowLintHooks): Promise<EditLintGateResult>;
 /** 互換 API。保存後 lint への移行後も、明示的に検証したい呼び出し側向けに残す。 */
 export declare function assertLintPasses(projectRoot: string, candidates: LintCandidates): Promise<void>;
 /** atomic 保存を即時完了し、lint は末尾 debounce で非同期に実行する。 */

package/vendor/packages/edit-store/lib/write-gate.js

@@ -32,6 +32,28 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const url_1 = require("url");
 const os_1 = require("os");
+/**
+ * 「OS / ファイルシステムがリンク作成自体を拒んだ」エラーコード。入力が誤っている系
+ * （EEXIST・ENOENT・ENOTDIR 等）は含めない — それらは従来どおり throw して原因を隠さない。
+ *
+ * Windows ではディレクトリ junction は権限不要だが、ファイル symlink は管理者権限か
+ * 開発者モードが必要。そのため一般の Windows 機では `.gitignore` 等のファイルリンクが
+ * 必ず EPERM になり、保存前の検証ステージングが本番の書き込みより先に落ちていた。
+ */
+const LINK_UNSUPPORTED_CODES = new Set([
+    'EPERM', 'EACCES', 'EINVAL', 'ENOSYS', 'ENOTSUP', 'EOPNOTSUPP', 'UNKNOWN'
+]);
+/** ディレクトリをリンクできなかったことを示す内部シグナル（素材の実体コピーは選ばない）。 */
+class ShadowLinkUnavailable extends Error {
+    constructor(entryPath, cause) {
+        super(`影プロジェクトへ ${entryPath} をリンクできませんでした（${cause.code ?? cause.message}）`);
+        this.name = 'ShadowLinkUnavailable';
+    }
+}
+function isLinkUnsupported(error) {
+    const code = error?.code;
+    return typeof code === 'string' && LINK_UNSUPPORTED_CODES.has(code);
+}
 const DEFAULT_LINT_DEBOUNCE_MS = 400;
 const lintTimers = new Map();
 const lintRevisions = new Map();
@@ -48,27 +70,80 @@ async function lintProjectCandidates(projectRoot, candidates) {
  * 実ディスクを直接読む lint check（motion 袋参照等）を含め、候補一式を保存前に検証する。
  * 元プロジェクトの直下エントリは影プロジェクトへ symlink し、候補の祖先だけを実体化する。
  * 既存 lintProjectCandidates の inputOverrides 契約は変更せず、Project API だけがこの入口を使う。
+ *
+ * リンクが使えない環境（Windows の非特権ユーザー等）では**ファイルだけコピーへ倒す**。
+ * 影プロジェクトは lint の読み取り専用ステージングなので、ファイルはコピーで等価であり、
+ * かつ影側への書き込みが元プロジェクトへ伝播しない（symlink 経路と同じ安全性）。
+ * ディレクトリはコピーしない: プロジェクト直下には assets/（4K 原本が何十 GB）が来るため、
+ * junction も作れない環境では影プロジェクトの構築自体を諦め、候補のメモリ差し替えだけで
+ * 検証する（実ディスクを読む check は落ちるが、保存は止めない — 冒頭の fail-open 裁定）。
  */
-async function lintProjectCandidatesOnDisk(projectRoot, candidates) {
+async function lintProjectCandidatesOnDisk(projectRoot, candidates, hooks = {}) {
     const shadowRoot = await fs_1.promises.mkdtemp((0, path_1.join)((0, os_1.tmpdir)(), 'akari-edit-store-lint-'));
     try {
         for (const entry of await fs_1.promises.readdir(projectRoot, { withFileTypes: true })) {
-            await fs_1.promises.symlink((0, path_1.resolve)(projectRoot, entry.name), (0, path_1.join)(shadowRoot, entry.name), entry.isDirectory() ? 'junction' : 'file');
+            await materializeShadowEntry((0, path_1.resolve)(projectRoot, entry.name), (0, path_1.join)(shadowRoot, entry.name), entry.isDirectory(), entry.name, hooks);
         }
         for (const [relativePath, text] of Object.entries(candidates)) {
             const segments = candidateSegments(relativePath);
             const destination = (0, path_1.join)(shadowRoot, ...segments);
-            await materializeShadowDirectory(shadowRoot, (0, path_1.dirname)(destination));
+            await materializeShadowDirectory(shadowRoot, (0, path_1.dirname)(destination), hooks);
             await fs_1.promises.rm(destination, { recursive: true, force: true });
             if (text !== null)
                 await fs_1.promises.writeFile(destination, text, 'utf8');
         }
         return await runEditLint(shadowRoot, undefined, false);
     }
+    catch (error) {
+        if (!(error instanceof ShadowLinkUnavailable))
+            throw error;
+        warnShadowUnavailableOnce(error);
+        hooks.onShadowUnavailable?.(error.message);
+        return await lintProjectCandidates(projectRoot, candidates);
+    }
     finally {
         await fs_1.promises.rm(shadowRoot, { recursive: true, force: true });
     }
 }
+/**
+ * 影プロジェクトへ 1 エントリを写す。まず従来どおり symlink / junction を試し、
+ * OS がリンク作成を拒んだときだけファイルコピーへ倒す（権限のある環境の挙動は変えない）。
+ */
+async function materializeShadowEntry(source, destination, preferDirectory, label, hooks) {
+    const symlink = hooks.symlink
+        ?? ((target, path, type) => fs_1.promises.symlink(target, path, type));
+    try {
+        await symlink(source, destination, preferDirectory ? 'junction' : 'file');
+        hooks.onShadowEntry?.(label, 'symlink');
+        return;
+    }
+    catch (error) {
+        if (!isLinkUnsupported(error))
+            throw error;
+        if (preferDirectory)
+            throw new ShadowLinkUnavailable(source, error);
+        // symlink エントリはリンク先を辿って種別を決める（リンクの実体がディレクトリなら
+        // コピーしない）。辿れない壊れたリンクは lint も読めないので影へは作らない。
+        const stats = await fs_1.promises.stat(source).catch(() => null);
+        if (stats === null) {
+            hooks.onShadowEntry?.(label, 'skip');
+            return;
+        }
+        if (stats.isDirectory())
+            throw new ShadowLinkUnavailable(source, error);
+        await fs_1.promises.copyFile(source, destination);
+        hooks.onShadowEntry?.(label, 'copy');
+    }
+}
+let shadowUnavailableWarned = false;
+function warnShadowUnavailableOnce(error) {
+    if (shadowUnavailableWarned) {
+        return;
+    }
+    shadowUnavailableWarned = true;
+    console.warn('[edit-store] 影プロジェクトを作れないため、実ディスクを読む lint check を省いて'
+        + '候補のメモリ検証だけで保存しています。', error.message);
+}
 function candidateSegments(relativePath) {
     const segments = relativePath.split('/');
     if (relativePath.length === 0 || relativePath.startsWith('/') || relativePath.includes('\\')
@@ -77,10 +152,10 @@ function candidateSegments(relativePath) {
     }
     return segments;
 }
-async function materializeShadowDirectory(shadowRoot, directory) {
+async function materializeShadowDirectory(shadowRoot, directory, hooks) {
     if (directory === shadowRoot)
         return;
-    await materializeShadowDirectory(shadowRoot, (0, path_1.dirname)(directory));
+    await materializeShadowDirectory(shadowRoot, (0, path_1.dirname)(directory), hooks);
     try {
         const stat = await fs_1.promises.lstat(directory);
         if (!stat.isSymbolicLink()) {
@@ -92,7 +167,7 @@ async function materializeShadowDirectory(shadowRoot, directory) {
         await fs_1.promises.unlink(directory);
         await fs_1.promises.mkdir(directory);
         for (const entry of await fs_1.promises.readdir(source, { withFileTypes: true })) {
-            await fs_1.promises.symlink((0, path_1.resolve)(source, entry.name), (0, path_1.join)(directory, entry.name), entry.isDirectory() ? 'junction' : 'file');
+            await materializeShadowEntry((0, path_1.resolve)(source, entry.name), (0, path_1.join)(directory, entry.name), entry.isDirectory(), entry.name, hooks);
         }
     }
     catch (error) {

package/vendor/packages/overlay-runtime/README.md

@@ -282,7 +282,7 @@ runtime.configure({ premount: false }); // 無効化
 
 ### ライブプレビューの tick 性能（3D 描画バッファ上限・`getAnimations()` キャッシュ）
 
-`tick()` は 3D 断片の `threeRuntime.render(container, localSeconds, { syncVideos: true, maxRenderSize })`
+`tick(t, playing)` は 3D 断片の `threeRuntime.render(container, localSeconds, { syncVideos: true, maxRenderSize, playing })`
 に描画バッファの長辺上限 `maxRenderSize`（px、既定 `720` = preview-server の `app.js` の
 `PREVIEW_3D_MAX_RENDER_SIZE` と同値）を渡す。`three-runtime.js` の `rendererSize()` は CSS 上の
 寸法とカメラのアスペクトを変えずに WebGL の描画バッファだけを縮める（4% のヒステリシス付き）ため、
@@ -292,6 +292,11 @@ runtime.configure({ premount: false }); // 無効化
 `configure({ maxRenderSize })` / `createOverlayRuntime({ maxRenderSize })` で上書きできる
 （正の数 = 長辺 px、`null` / `0` = 無効（等倍）。キー未指定の `mount(summary)` は保持値を引き継ぐ）。
 
+`playing` は動画テクスチャ（`materialOverrides` の動画）の同期方式に使う（2026-09-16）: 再生中は
+`<video>` を走らせて `playbackRate` で寄せ、停止・スクラブ中はシークで追従する（シーク中は次を積まない）。
+`<video>` は `crossOrigin="anonymous"` で作る（asset stream は別オリジン）。GPU への転送は提示フレームが
+変わったときだけ。詳細は `skills/overlay-authoring/3d.md` の VideoTexture 節。
+
 非 3D 断片の `tick()` は `container.getAnimations({ subtree: true })` の結果を overlay ごとに
 250ms キャッシュし（`app.js` と同じ）、可視化フリップ直後の tick・250ms 経過・未取得のときだけ
 引き直す（非表示化でキャッシュは捨てる）。`getAnimations()` のコストはドキュメント全体に現存する

package/vendor/packages/schemas/engine-capabilities.json

@@ -68,10 +68,10 @@
     { "path": "tracks[].items[].source.src", "applies_to": ["cuts", "layers"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/edit-store/src/internal-model.ts buildV2VisualItem; packages/frame-engine/src/timeline/plan.ts layerFromPlacement/resolvedCompositeLayers" },
     { "path": "tracks[].items[].source.src", "applies_to": ["audio"], "gpu": "other-subsystem", "osr": "other-subsystem", "consumer": "render-cut audio mix", "evidence": "packages/edit-store/src/internal-model.ts buildV2AudioItem" },
     { "path": "tracks[].items[].source.in", "applies_to": ["cuts"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/frame-engine/src/timeline/plan.ts layerFromPlacement/buildResolvedTimelinePlan" },
-    { "path": "tracks[].items[].source.in", "applies_to": ["layers"], "gpu": "ignored", "osr": "ignored", "evidence": "packages/edit-store/src/internal-model.ts buildV2VisualItem layer declaration omits source in/out", "hint": "layers の素材窓は現在 0 秒始まりのため、trim 済み素材を使う" },
+    { "path": "tracks[].items[].source.in", "applies_to": ["layers"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/edit-store/src/internal-model.ts buildV2VisualItem layer declaration emits `in: item.source.in`; packages/frame-engine/src/timeline/plan.ts resolvedCompositeLayers sourceTimeUs = finite(layer.in, 0) + localSeconds * speed" },
     { "path": "tracks[].items[].source.in", "applies_to": ["audio"], "gpu": "other-subsystem", "osr": "other-subsystem", "consumer": "render-cut audio mix", "evidence": "packages/edit-store/src/internal-model.ts buildV2AudioItem" },
     { "path": "tracks[].items[].source.out", "applies_to": ["cuts"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/frame-engine/src/timeline/plan.ts buildResolvedTimelinePlan/layerFromPlacement" },
-    { "path": "tracks[].items[].source.out", "applies_to": ["layers"], "gpu": "ignored", "osr": "ignored", "evidence": "packages/edit-store/src/internal-model.ts buildV2VisualItem layer declaration omits source in/out", "hint": "layers の素材窓は item.duration で決まり、source.out は反映されない" },
+    { "path": "tracks[].items[].source.out", "applies_to": ["layers"], "gpu": "partial", "osr": "partial", "evidence": "packages/edit-store/src/internal-model.ts buildV2VisualItem folds out - in into the layer declaration's speed when the span disagrees with item.duration by more than a frame; packages/frame-engine/src/timeline/plan.ts resolvedCompositeLayers consumes layer.speed", "hint": "layers の表示尺は item.duration で決まる。source.out は out - in が duration と 1 フレーム超ずれたときだけ再生速度として効く（素材窓のクリップには使われない）" },
     { "path": "tracks[].items[].source.out", "applies_to": ["audio"], "gpu": "other-subsystem", "osr": "other-subsystem", "consumer": "render-cut audio mix", "evidence": "packages/edit-store/src/internal-model.ts buildV2AudioItem" },
     { "path": "tracks[].items[].source.framing", "applies_to": ["cuts"], "gpu": "consumed", "osr": "consumed", "evidence": "packages/frame-engine/src/timeline/plan.ts visualAt/interpolateFraming" },
     { "path": "tracks[].items[].source.framing", "applies_to": ["layers"], "gpu": "ignored", "osr": "ignored", "runtime_warning": true, "evidence": "packages/edit-store/src/internal-model.ts copyMediaSourceFields; packages/frame-engine/src/timeline/plan.ts KNOWN_LAYER_KEYS omits framing" },

package/vendor/skills/akari/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: akari
+description: AKARI Video のプロジェクトを作る・開く・続きから再開する。`.akari/` の無いフォルダで動画を作りたいと言われたとき、または AKARI のプロジェクトの状態を知りたいときに使う。
+---
+
+# AKARI Video を始める・再開する
+
+> **Language**: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
+
+この入口は次の 3 分岐だけを担当する。本体スキルの手順はここに複製しない。
+以下の `akari` は PATH 上の CLI を使う。無ければ
+`node "${AKARI_HOME:-$HOME/.akari}/app/packages/akari-launcher/bin/akari.mjs"`、
+それも無ければ実在するリポ checkout の `packages/akari-launcher/bin/akari.mjs` を
+`node` で実行する。どれも無い場合は不足を伝えて止め、パスを捏造しない。
+
+## 続きから
+
+1. cwd から祖先方向へ `.akari/` を探す。見つかったプロジェクトを `<project>` とする。
+   `.akari/root.json` の `schema: "creator-root/v1"` は作業場の印であり、作品の印ではない。
+   作業場だけが見つかった場合は、依頼に応じて「作る」か「開く」へ進む。
+2. `akari status "$PWD" --json` を実行する。`next_skill` / `waiting_on` を根拠に、
+   次の一手を 1〜2 文で案内する。失敗や `state_health: inconclusive` は取得不能と伝え、
+   ファイルの断片から工程を推測しない。
+3. `next_skill` がある場合は `<project>/.claude/skills/<next_skill>/SKILL.md` を
+   **パスで直接読む**。無ければ不足を伝え、別の手順を発明しない。
+   `waiting_on` がある場合はその操作を案内し、本体スキルの待ち条件を飛ばさない。
+
+## 作る
+
+`.akari/` が無い、または新規作成を明示された場合に使う。
+
+作業場が無いことを検出しても、**利用者の同意なしに作成しない**（提案 → 同意 → 作成の順）。
+
+1. 作業場を次の 2 経路で検出する（どちらか一方でも見つかれば作業場あり）。
+   - `<AKARI_HOME>/creator-root.json`（未設定時は `~/.akari/creator-root.json`）の
+     `lastRoot` が実在するか確認する。
+   - cwd から祖先方向へ `.akari/root.json` を探し、
+     `schema` が `"creator-root/v1"` であることを確認する。
+   見つかった作業場のマーカーも読む。JSON 破損・未知 schema は上書きせず報告する。
+2. **1 問だけ**「作業場 `~/Akari/` に作りますか、このフォルダに作りますか？
+   作業場が無ければ `akari init` で作成します」と尋ねる。
+   既存の作業場が見つかった場合は、その実パスで `~/Akari/` を置き換える。
+   作業場を選んだときの具体的な宛先も同じ質問に含める:
+   `<作業場>/channels/<channel>/videos/<日付-スラッグ>/`。
+   `<channel>` は `root.json` の `channels` の先頭、無ければ `my-channel`。
+   日付と依頼内容から短いスラッグを提案し、既存の作品と同名なら別名を提案する。
+   このフォルダを選んだ場合の `<target>` は cwd。
+3. 同意後、作業場を選び未作成の場合だけ `akari init` を実行する。
+   引数なしの ensure 動作は冪等で、既存作業場があれば stdout 1 行目にそのパスを返す。
+   返された場所が同意済みの場所と異なる場合は、勝手に別の場所へ作らない。
+4. `akari new "<target>"` を実行する。既存ファイルを上書きせず不足分だけ補完し、
+   既存リポジトリの内側では git init しない F18 ガードを CLI に委ねる。
+   本体スキルは実体コピーのまま、`AKARI-SKILLS-VERSION` で作成時点の版を記録する。
+5. stdout の作成レポートのパスと「次は `edit-plan`」を案内し、
+   `<target>/.claude/skills/edit-plan/SKILL.md` を**パスで直接読む**。
+   セッション途中に作ったスキルは列挙に載らない場合がある。次回そのプロジェクトで
+   エージェントを起動すれば列挙に載るため、今のセッションでは直接読む。
+
+上の 1 問が同意取得を兼ねる。既に宛先まで明示して同意されている場合は再確認しない。
+CLI が実行できない場合の作業場だけの手動生成は、同意済みの場所に限り、
+`akari.md`、`channels/<channel>/videos/`、`library/`、`inbox/`、
+`.akari/memory/`、`.akari/cache/` を作る。
+`akari.md` は次のスタブを使う:
+
+```markdown
+# akari.md
+
+この作業場（CreatorRoot）の規約・好みを書く場所です。
+AKARI Video のエージェントは動画を作る前に、まずこのファイルを読みます。
+
+## 好み
+
+（まだ何も書かれていません）
+```
+
+手動生成では次の 2 規律を必ず守る。
+
+1. **既存ファイルを一切上書きしない**。`root.json` や `akari.md` があれば書かず「検出」に戻る
+2. **`root.json` は最後に書く**。全ディレクトリと `akari.md` の作成完了後に作業場マーカーを置く
+
+`.akari/root.json` は
+`{"schema":"creator-root/v1","createdAt":<ISO8601>,"channels":[<channel>]}` とする。
+フォールバックでは `<AKARI_HOME>/creator-root.json` を書かない。
+CLI 不在のままプロジェクト生成まで済んだとは扱わず、`akari new` の不足を伝える。
+
+## 開く
+
+「作る」の検出手順だけで作業場を探し、`<作業場>/channels/*/videos/*` の実在する
+プロジェクトディレクトリを列挙して選ばせる。見つからなければ、その旨と「作る」を案内する。
+選んだプロジェクトを cwd にして「続きから」へ進む。読み取りだけで作業場を新設しない。

package/vendor/skills/akari/test/skills-command.test.mjs

@@ -0,0 +1,2 @@
+// pure レーンが探索するスキル側から、ランチャーの入口テストを同じ正本で実行する。
+import '../../../packages/akari-launcher/test/skills-command.test.mjs';

package/vendor/skills/design-world/SKILL.md

@@ -69,6 +69,8 @@ description: 「ワールドを作って」「地図で見せる動画」「紙
 4. `akari world check "$PROJECT"` を実行し、エラーが 0 件になるまで台本を直して再展開する。
 5. 素材は、世界観の束（例: Pop Motion ワールド対応版）が持つ **背景 / 飛び込み口 / モチーフ** の 3 層で考える。背景で world ごとの材質を作り、飛び込み口で portal の通過を読ませ、モチーフを各停留所へ置く。必要な素材は `akari assets fetch <id>` で取得でき、`akari world build` がプロジェクト内の素材を解決する。
 6. `planning/world-items.json` を作り、素材を zone に対応づける。`asset` は必ず `overlay/<id>` と書く。`offset`、`scale`、`vars` は任意。
+   `delay: 0.5` のように 0 以上の秒数を指定すると、素材の時計は同じ zone id の stop の `at + delay` から始まる（省略 0）。
+   世界サイズの背景 item は `role: "background"` を付けると zone が画面外でも消えない。role 省略時も `vars` の `world-width` / `world-height`（`--` 接頭辞も可）で背景と判定する。
 
    ```json
    {
@@ -89,6 +91,6 @@ description: 「ワールドを作って」「地図で見せる動画」「紙
    `asset` の `<使う素材の id>` は実際に使う素材の id に置き換え、`zone` は `planning/world-map.json` の zone id と一致させる。同じ zone の items は配列順に重なり、後ろの item が上に乗る。素材ごとに基準点と既定サイズが異なるため、`meta.json` / `fragment.html` を実測して `offset` を決める。詳しくは [world.md の「構図の目安」](world.md#構図の目安) を見る。
 7. `akari world build "$PROJECT"` を実行する。`overlays/world.html` と `edit.json` の world item が生成される。
 8. `akari world preview "$PROJECT" --measure` を実行して `planning/world-map.json` の cover を実測値へ置き換える。生成済みの `overlays/world.html` は暫定値のままなので、`akari world build "$PROJECT"` をもう一度実行し、`akari world check "$PROJECT" --strict` を通す。順番は **build → preview --measure → build → check --strict**。
-9. `akari world overview "$PROJECT"` を実行し、地図を人に見せる。停留所の順、世界境界、carry、portal/cut の位置が意図どおりか確認する。
+9. `akari world overview "$PROJECT"` を実行し、実素材が同じ時刻で並ぶ俯瞰地図を人に見せる。停留所の順、世界境界、carry、portal/cut の位置が意図どおりか確認する。
 
 判断に迷ったら [world.md](world.md) の型を使う。概念と地図タブの読み方は [guide.md](guide.md) を見る。

package/vendor/skills/design-world/world.md

@@ -26,6 +26,9 @@ expand は最初の build を可能にするため、portal の `transition.cove
 
 ## 構図の目安
 
+素材の `delay: 0.5` は stop の `at` からの開始待ち秒数（0 以上・省略 0）で、到着前の素材の時計は 0 秒に固定される。
+背景 item に `role: "background"` を付けると zone は非カリングになる。省略時も `vars` の `world-width` / `world-height`（`--` 接頭辞も可）があれば背景として扱う。
+
 出力幅を `W`、出力高を `H`、停留所の `c` を `[x, y, scale]` とすると、画面に映る world の撮影枠は world px で次のようになる。
 
 ```text

package/vendor/skills/overlay-authoring/3d.md

@@ -690,9 +690,13 @@ container を渡しても、断片の外側からは同じ値が同じ式で読
 - 時刻を決めるのは常に**外側**。ランタイムは `autoplay` しない。wall-clock 再生へ任せない。
   - **export**: rasterize がフレーム精度シーク（提示フレームの確定まで待つ）を済ませてから
     3D を描く。ランタイムは `currentTime` を書かない
-  - **preview**: tick が `render(container, seconds, { syncVideos: true })` を渡し、ランタイムが
-    overlay のローカル時刻へ `currentTime` を合わせる。壁時計で進むので提示フレームの確定は
-    待たず、1 フレーム前後ずれることがある（絵は必ずその時刻の近傍になる）
+  - **preview**: tick が `render(container, seconds, { syncVideos: true, playing })` を渡し、ランタイムが
+    overlay のローカル時刻へ合わせる（2026-09-16 改訂）。**再生中（`playing: true`）は `<video>` を
+    走らせ、ズレは `playbackRate`（±0.25 まで）で寄せる**。ハードシークは 1 秒以上ズレたときだけ。
+    **停止・スクラブ中は `currentTime` でシーク**するが、前のシークが終わる（`seeked`）まで次を積まない。
+    毎 tick シークすると keyframe から復号し直しが連続し、画面が黒のまま / 完了した瞬間だけ絵が出る
+    「ちらつき」になり、完了するようになると frame-engine が遅れてタイムラインが減速する
+    （実測 0.2〜0.5 倍）。壁時計で進むので提示フレームの確定は待たず、1 フレーム前後ずれることがある
   - `syncVideos` は **preview 専用の opt-in**。export で渡すと確定済みの提示フレームを崩して
     決定性が壊れる
 - ランタイムは `<video loop>` を立てて作る。export のシークは loop 宣言のある素材の時刻を尺で
@@ -713,8 +717,15 @@ container を渡しても、断片の外側からは同じ値が同じ式で読
   自発光の絵を飲み込む。UV の無いメッシュには差せない（(0,0) を拾って真っ黒になる）。
 - 素材の縦横比を差し込み先に合わせる。縦動画を横画面に差すと引き伸ばされる。
 - source の寸法・format を変える場合は既存 texture を dispose し、作り直す。
-- preview は毎 tick シークするため、**編集用 720p プロキシでないと詰まる**。原本を差さない。
-  既に十分近い時刻（20ms 以内）なら書かないので、再生中にシークが走り続けることはない。
+- preview の停止・スクラブ中はシークで追従するため、**編集用 720p プロキシでないと詰まる**。原本を差さない。
+  既に十分近い時刻（20ms 以内）なら書かず、シーク中は次を積まない。
+- `<video>` は `crossOrigin="anonymous"` で作る。シェルのライブプレビューは素材を別オリジン
+  （`127.0.0.1` の asset stream、`Access-Control-Allow-Origin: *`）から配るため、CORS 無しだと canvas が
+  汚染されて WebGL へ転送できず**画面が真っ黒**になる（静止画は `TextureLoader` が既定で CORS 読みなので
+  出ていた）。同一オリジン・`file:` では無害。
+- ライブプレビューでの GPU 転送は**提示フレームが変わったとき**（`requestVideoFrameCallback`）だけ。
+  毎 tick 無条件に `needsUpdate` すると frame-engine の描画が遅れる。書き出し（`syncVideos` 無し）は
+  従来どおり毎 draw 上げ直す。
 
 公式: [Three.js VideoTexture](https://threejs.org/docs/pages/VideoTexture.html)