akari-video 0.1.50 → 0.1.52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "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/cli.mjs

@@ -22,6 +22,7 @@ import {
   triggerBackgroundRefresh
 } from './update-check.mjs';
 import { applySelfUpdate, isRunningFromAppDir, rollbackSelfUpdate } from './self-update.mjs';
+import { runDecisionLogCommand } from './decision-log-command.mjs';
 import { runCaptionsCommand } from './captions-command.mjs';
 import { runCaptureCommand } from './capture-command.mjs';
 import { runMediaCommand } from './media-command.mjs';
@@ -44,6 +45,7 @@ export async function run(args, options = {}) {
     error(`akari ${retiredBrowserCommand} は廃止されました（Chrome は不要になりました）`);
     return { exitCode: 1 };
   }
+  if (args[0] === 'decision-log') return runDecisionLogCommand(args.slice(1), options);
   if (args[0] === 'captions') return runCaptionsCommand(args.slice(1), options);
   if (args[0] === 'capture') return runCaptureCommand(args.slice(1), options);
   if (args[0] === 'media') return runMediaCommand(args.slice(1), options);

package/src/decision-log-command.mjs

@@ -0,0 +1,20 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+
+import { resolveLauncherAssets } from "./repo-assets.mjs";
+
+export async function runDecisionLogCommand(argv, options = {}) {
+  const logError = options.error ?? options.logError ?? ((line) => console.error(line));
+  const assets = options.assets ?? resolveLauncherAssets();
+  if (!assets.decisionLogScript || !existsSync(assets.decisionLogScript)) {
+    logError("akari decision-log の実行スクリプトが見つかりません。AKARI Video を再インストールしてください。");
+    return { exitCode: 1 };
+  }
+
+  const spawn = options.spawn ?? spawnSync;
+  const result = spawn(process.execPath, [assets.decisionLogScript, ...argv], {
+    stdio: "inherit",
+    cwd: options.cwd ?? process.cwd(),
+  });
+  return { exitCode: typeof result.status === "number" ? result.status : 1 };
+}

package/src/repo-assets.mjs

@@ -33,6 +33,7 @@ const AUDIO_FETCH_SCRIPT_RELATIVE = path.join('packages', 'audio-library-setup',
 const ASSET_RESOLVER_CLI_RELATIVE = path.join('packages', 'asset-resolver', 'bin', 'akari-assets.mjs');
 const BEATMAP_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'beatmap.mjs');
 const PROBE_FRAME_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'probe-frame.mjs');
+const DECISION_LOG_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'decision-log.mjs');
 const CAPTIONS_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'captions.mjs');
 const CAPTURE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'capture.mjs');
 const RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
@@ -56,6 +57,7 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const renderWhenIdleScript = path.join(repoRoot, RENDER_WHEN_IDLE_SCRIPT_RELATIVE);
   const eyeBarScript = path.join(repoRoot, EYE_BAR_SCRIPT_RELATIVE);
   const mediaScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'media.mjs');
+  const decisionLogScript = path.join(repoRoot, DECISION_LOG_SCRIPT_RELATIVE);
   const wordBookScript = path.join(repoRoot, 'packages', 'akari-tools', 'bin', 'word-book.mjs');
 
   return {
@@ -75,6 +77,7 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
     renderWhenIdleScript: existsSync(renderWhenIdleScript) ? renderWhenIdleScript : null,
     eyeBarScript: existsSync(eyeBarScript) ? eyeBarScript : null,
     mediaScript: existsSync(mediaScript) ? mediaScript : null,
+    ...(existsSync(decisionLogScript) ? { decisionLogScript } : {}),
     ...(existsSync(wordBookScript) ? { wordBookScript } : {})
   };
 }
@@ -111,6 +114,7 @@ export function resolveLauncherAssets({
     renderWhenIdleScript: candidate.renderWhenIdleScript ?? vendor.renderWhenIdleScript,
     eyeBarScript: candidate.eyeBarScript ?? vendor.eyeBarScript,
     mediaScript: candidate.mediaScript ?? vendor.mediaScript,
+    ...(candidate.decisionLogScript ?? vendor.decisionLogScript ? { decisionLogScript: candidate.decisionLogScript ?? vendor.decisionLogScript } : {}),
     ...(candidate.wordBookScript ?? vendor.wordBookScript
       ? { wordBookScript: candidate.wordBookScript ?? vendor.wordBookScript }
       : {})

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

@@ -146,6 +146,7 @@
     "skills/declare-audio/launch.md",
     "skills/declare-audio/SKILL.md",
     "skills/declare-audio/what-to-declare.md",
+    "skills/edit-lint/preview.md",
     "skills/edit-lint/SKILL.md",
     "skills/edit-plan/approvals-and-generation.md",
     "skills/edit-plan/autonomy.md",
@@ -170,6 +171,7 @@
     "skills/harvest-asset/SKILL.md",
     "skills/manage-connections/SKILL.md",
     "skills/overlay-authoring/3d.md",
+    "skills/overlay-authoring/device-materials.md",
     "skills/overlay-authoring/glass.md",
     "skills/overlay-authoring/motion.md",
     "skills/overlay-authoring/SKILL.md",

package/vendor/docs/contract-2026-09-06-vgpu-layer-v0.md

@@ -50,6 +50,7 @@ CPU への画素読み戻しはこの経路に追加しない。ブラウザ内
 | `passes[].wgsl` | 必須、空白だけではない WGSL 文字列 |
 | `passes[].inputs` | 先行パス id の文字列配列、最大 8 個。省略時 `[]`。自己参照・前方参照不可 |
 | `passes[].scale` | 正の有限数、省略時 `1`。最終パスでは無視する |
+| `passes[].format` | `pure` のみ、`"rgba8unorm"` または `"rgba16float"`。省略時 `"rgba8unorm"`。最終パスでは無視する（surface の format は vgpu の既定） |
 
 未知のトップレベルキー・pass キー、不正 JSON、不正な値は `readDescriptor` が TypeError にする。
 `uniforms` のキーは WGSL `Params` のメンバーに対応し、断片が
@@ -91,6 +92,9 @@ fn akari_uv(pos: vec4f) -> vec2f { return pos.xy / vec2f(akari.pad.x, akari.pad.
 断片は `akari_uv(position)`、または vgpu の頂点段が供給する左上原点の `@location(0) uv` を使う。
 `position.xy / vec2f(akari.width, akari.height)` は縮小時に構図が変わるので使わない。
 
+`rgba16float` の中間 target は線形 HDR（> 1）をそのまま次のパスへ渡せる。
+`rgba8unorm` は [0,1] に飽和する。
+
 ## 4. API・解像度・ツマミ
 
 - `probe()` はページで 1 回だけ `init()` し、同じ Promise を返す。64×64 一時 surface に 2 コマ描画し、
@@ -152,6 +156,8 @@ vgpu 不在の overlay sheet には新しい script や seek 文を一切挿入
 
 ## 6. fail-loud と v0 の限界
 
+- `passes[].format` の `rgba32float` は未対応（`float32-filterable` 機能に依存するため）。
+
 - WebGPU 未提供・adapter null・初期化/試験描画失敗は `VGPU-UNAVAILABLE:` で probe を reject。
 - device lost 後の render は `VGPU-DEVICE-LOST:` で throw。復帰や別 device への切り替えは行わない。
 - `auto` でも `VGPU-` を含む失敗は OSR へフォールバックせずそのまま伝播する。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "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/cut-audio-split-ops.d.ts

@@ -0,0 +1,36 @@
+import type { EditV2 } from './edit-v2';
+/** Serialized v2 document; editing does not require a Project instance. */
+export type EditV2Document = EditV2;
+export type CutAudioSplitBlocker = 'not-found' | 'not-visual-media' | 'nested' | 'anchored' | 'speed' | 'freeze' | 'transition-crossfade' | 'already-split' | 'no-audio';
+export declare function canSplitCutAudio(doc: EditV2Document, cutId: string, options?: {
+    hasAudio?: boolean;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    blocker: CutAudioSplitBlocker;
+    message: string;
+};
+export declare function splitCutAudio(doc: EditV2Document, options: {
+    cutId: string;
+    hasAudio?: boolean;
+}): {
+    document: EditV2Document;
+    audioItemId: string;
+    audioTrackId: string;
+    createdTrack: boolean;
+};
+export declare function linkedAudioItemIdOf(doc: EditV2Document, cutId: string): string | undefined;
+export declare function linkedCutIdOf(doc: EditV2Document, audioItemId: string): string | undefined;
+export declare function unlinkCutAudio(doc: EditV2Document, options: {
+    audioItemId: string;
+}): EditV2Document;
+export declare function moveLinkedCutAudio(doc: EditV2Document, options: {
+    cutId: string;
+    deltaFrames: number;
+}): EditV2Document;
+export declare function removeCutAudioLinked(doc: EditV2Document, options: {
+    target: 'pair' | 'audio-only' | 'cut-only';
+    cutId?: string;
+    audioItemId?: string;
+}): EditV2Document;

package/vendor/packages/edit-store/lib/cut-audio-split-ops.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canSplitCutAudio = canSplitCutAudio;
+exports.splitCutAudio = splitCutAudio;
+exports.linkedAudioItemIdOf = linkedAudioItemIdOf;
+exports.linkedCutIdOf = linkedCutIdOf;
+exports.unlinkCutAudio = unlinkCutAudio;
+exports.moveLinkedCutAudio = moveLinkedCutAudio;
+exports.removeCutAudioLinked = removeCutAudioLinked;
+const tree_ops_1 = require("./tree-ops");
+const BLOCKER_MESSAGES = {
+    'not-found': 'カットが見つかりません',
+    'not-visual-media': '映像トラックの素材カットだけ音声を分離できます',
+    nested: '入れ子のカットはまだ音声を分離できません',
+    anchored: '字幕に固定したカットはまだ音声を分離できません',
+    speed: '速度を変えたカットはまだ音声を分離できません',
+    freeze: '静止区間を持つカットはまだ音声を分離できません',
+    'transition-crossfade': 'トランジションを持つカットはまだ音声を分離できません',
+    'already-split': 'このカットの音声はすでに分離されています',
+    'no-audio': 'この素材には音声がありません',
+};
+// These tree helpers only access tracks/items; no Project methods are needed.
+function tree(doc) {
+    return doc;
+}
+function canSplitCutAudio(doc, cutId, options = {}) {
+    const location = (0, tree_ops_1.locate)(tree(doc), cutId);
+    let blocker;
+    if (!location)
+        blocker = 'not-found';
+    else if (location.parent || location.item.items !== undefined)
+        blocker = 'nested';
+    else if (location.track.lane !== 'visual' || location.item.source.kind !== 'media')
+        blocker = 'not-visual-media';
+    else if (location.item.anchor !== undefined)
+        blocker = 'anchored';
+    else if (location.item.source.speed !== undefined && location.item.source.speed !== 1)
+        blocker = 'speed';
+    else if (location.item.source.freeze != null)
+        blocker = 'freeze';
+    else if (location.item.source.transition_out != null)
+        blocker = 'transition-crossfade';
+    else if (location.item.audio === false)
+        blocker = 'already-split';
+    else if (options.hasAudio === false)
+        blocker = 'no-audio';
+    return blocker ? { ok: false, blocker, message: BLOCKER_MESSAGES[blocker] } : { ok: true };
+}
+function splitCutAudio(doc, options) {
+    const eligible = canSplitCutAudio(doc, options.cutId, options);
+    if (eligible.ok === false)
+        throw new Error(eligible.message);
+    const document = structuredClone(doc);
+    const location = (0, tree_ops_1.locate)(tree(document), options.cutId);
+    const cut = location.item;
+    const visualIds = new Set(location.track.items.map(item => item.id));
+    let audioTrack = document.tracks.find((track) => track.lane === 'audio' && 'items' in track
+        && (track.muted === true) === (location.track.muted === true)
+        && track.items.length > 0
+        && track.items.every(item => item.role === 'speech' && visualIds.has(item.link)));
+    const createdTrack = audioTrack === undefined;
+    if (!audioTrack) {
+        // Audio tracks are inserted at the end of their lane, preserving all existing order.
+        let index = 0;
+        document.tracks.forEach((track, i) => { if (track.lane === 'audio')
+            index = i + 1; });
+        audioTrack = (0, tree_ops_1.createTrackAt)(tree(document), 'audio', index);
+        const visualNumber = document.tracks.filter(track => track.lane === 'visual').findIndex(track => track.id === location.track.id) + 1;
+        audioTrack.name = `${location.track.name ?? `V${visualNumber}`}の音声`;
+        if (location.track.muted === true)
+            audioTrack.muted = true;
+    }
+    const ids = new Set((0, tree_ops_1.allLocations)(tree(document)).map(entry => entry.item.id));
+    const base = `${cut.id}-audio`;
+    let audioItemId = base;
+    for (let serial = 2; ids.has(audioItemId); serial++)
+        audioItemId = `${base}-${serial}`;
+    const audio = {
+        id: audioItemId, role: 'speech', link: cut.id, at: cut.at, duration: cut.duration,
+        source: { kind: 'media', src: cut.source.src, in: cut.source.in, out: cut.source.out },
+    };
+    if (cut.source.gain_db !== undefined) {
+        audio.gain_db = cut.source.gain_db;
+        delete cut.source.gain_db;
+    }
+    if (cut.source.mute === true) {
+        audio.mute = true;
+        delete cut.source.mute;
+    }
+    if (Array.isArray(cut.keyframes)) {
+        const visualPoints = [];
+        const audioPoints = [];
+        for (const point of cut.keyframes) {
+            if (point.gain_db === undefined) {
+                visualPoints.push(point);
+                continue;
+            }
+            audioPoints.push({ t: point.t, gain_db: point.gain_db,
+                ...(point.easing === undefined ? {} : { easing: structuredClone(point.easing) }) });
+            delete point.gain_db;
+            if (Object.keys(point).some(key => key !== 't' && key !== 'easing'))
+                visualPoints.push(point);
+        }
+        if (audioPoints.length) {
+            if (audioPoints.length === 1) {
+                // A singleton envelope is a constant offset to the base gain; clamp sums outside the schema range.
+                audio.gain_db = Math.max(-60, Math.min(12, (audio.gain_db ?? 0) + audioPoints[0].gain_db));
+            }
+            else
+                audio.keyframes = audioPoints;
+            // Keep the original, gain-stripped array for a singleton visual: inert points preserve
+            // the two-point minimum without changing any property's filtered interpolation.
+            if (visualPoints.length >= 2)
+                cut.keyframes = visualPoints;
+            else if (visualPoints.length === 0)
+                delete cut.keyframes;
+        }
+    }
+    cut.audio = false;
+    audioTrack.items.push(audio);
+    return { document, audioItemId, audioTrackId: audioTrack.id, createdTrack };
+}
+function linkedAudioItemIdOf(doc, cutId) {
+    return (0, tree_ops_1.allLocations)(tree(doc)).find(location => location.track.lane === 'audio'
+        && location.item.link === cutId)?.item.id;
+}
+function linkedCutIdOf(doc, audioItemId) {
+    const location = (0, tree_ops_1.locate)(tree(doc), audioItemId);
+    return location?.track.lane === 'audio' && typeof location.item.link === 'string'
+        ? location.item.link : undefined;
+}
+function unlinkCutAudio(doc, options) {
+    const document = structuredClone(doc);
+    const audio = requireAudio(document, options.audioItemId);
+    delete audio.item.link;
+    return document;
+}
+function moveLinkedCutAudio(doc, options) {
+    if (!Number.isInteger(options.deltaFrames))
+        throw new Error('移動量は整数フレームで指定してください');
+    const document = structuredClone(doc);
+    const cut = requireCut(document, options.cutId);
+    const audioId = linkedAudioItemIdOf(document, options.cutId);
+    const locations = [cut, ...(audioId === undefined ? [] : [requireAudio(document, audioId)])];
+    if (locations.some(location => location.item.at + options.deltaFrames < 0)) {
+        throw new Error('カットまたは音声がタイムラインの先頭より前になるため移動できません');
+    }
+    for (const location of locations)
+        location.item.at += options.deltaFrames;
+    return document;
+}
+function removeCutAudioLinked(doc, options) {
+    const document = structuredClone(doc);
+    if (!['pair', 'audio-only', 'cut-only'].includes(options.target))
+        throw new Error('削除対象が不正です');
+    if (options.cutId === undefined && options.audioItemId === undefined)
+        throw new Error('削除対象を指定してください');
+    let cut = options.cutId === undefined ? undefined : requireCut(document, options.cutId);
+    let audio = options.audioItemId === undefined ? undefined : requireAudio(document, options.audioItemId);
+    if (cut && audio && audio.item.link !== cut.item.id)
+        throw new Error('指定された映像と音声はリンクしていません');
+    if (!cut && typeof audio?.item.link === 'string')
+        cut = requireCut(document, audio.item.link);
+    if (!audio && cut) {
+        const audioId = linkedAudioItemIdOf(document, cut.item.id);
+        if (audioId !== undefined)
+            audio = requireAudio(document, audioId);
+    }
+    if (options.target === 'audio-only' && !audio)
+        throw new Error('リンクされた音声が見つかりません');
+    if (options.target === 'cut-only' && !cut)
+        throw new Error('リンクされたカットが見つかりません');
+    if (options.target !== 'audio-only' && cut)
+        removeLocation(cut);
+    if (options.target !== 'cut-only' && audio)
+        removeLocation(audio);
+    if (options.target === 'cut-only' && audio)
+        delete audio.item.link;
+    return document;
+}
+function requireCut(doc, id) {
+    const location = (0, tree_ops_1.locate)(tree(doc), id);
+    if (!location || location.track.lane !== 'visual' || location.item.source.kind !== 'media') {
+        throw new Error('映像の素材カットが見つかりません');
+    }
+    return location;
+}
+function requireAudio(doc, id) {
+    const location = (0, tree_ops_1.locate)(tree(doc), id);
+    if (!location || location.track.lane !== 'audio')
+        throw new Error('音声が見つかりません');
+    return location;
+}
+function removeLocation(location) {
+    location.items.splice(location.index, 1);
+}

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

@@ -27,6 +27,7 @@ export * from './ducking';
 export * from './envelope';
 export * from './audio-schedule';
 export * from './audio-ownership';
+export * from './cut-audio-split-ops';
 export * from './canonical';
 export * from './tree-ops';
 export * from './item-anchor';

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

@@ -45,6 +45,7 @@ __exportStar(require("./ducking"), exports);
 __exportStar(require("./envelope"), exports);
 __exportStar(require("./audio-schedule"), exports);
 __exportStar(require("./audio-ownership"), exports);
+__exportStar(require("./cut-audio-split-ops"), exports);
 __exportStar(require("./canonical"), exports);
 __exportStar(require("./tree-ops"), exports);
 __exportStar(require("./item-anchor"), exports);

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

@@ -164,6 +164,7 @@ vgpu は他の宣言型ランタイムと同じく `runtimes.mjs` に登録さ
 `ready` であることを確認する。プレビューは `render(container, localTimeSeconds, { previewScale: 0.5, fps })` を呼び、
 非表示化と unmount で `dispose(container)` を呼ぶ。非対応環境の警告はランタイムが 1 回にまとめる。
 共有 device は container の破棄時には落とさない。
+`pure` の中間パスは `passes[].format` に `rgba16float` を指定すると線形 HDR を保持でき、省略時は `rgba8unorm`、最終パスでは format を無視する。
 `mode: "stateful"` の断片では `render(container, localTimeSeconds, { fps })` の `fps`（= `edit.output.fps`）が必須で、省略すると TypeError になる。
 stateful のプレビューは上の options にも `fps` を加え、`{ previewScale: 0.5, fps }` を渡す。
 逆戻りシークは reset + 固定ステップ replay で追従し、`maxReplaySteps` 超過は `VGPU-REPLAY-LIMIT` で失敗する。

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

@@ -61,7 +61,7 @@ node の解決順は `AKARI_NODE_BIN` → PATH の node（20 以上）→ 同梱
 4. 同じコマンドを再実行し、error finding がなく `verdict: "pass"` になるまで繰り返す。analysis.json または captions.json が無い検査は `skipped[]` で確認する。
 5. 書き出し前は、使う出口に合わせて `--engine gpu` または `--engine osr` を追加して再実行する。
    書き出し側が出口を自動選択する場合は `--engine auto` を使い、エンジン適合性も PASS させる。
-6. PASS 後に、カット境界と overlay の開始・終了フレームを実際に視認する。**開始・終了フレームに加えて中間時刻（各区間の 1/4・1/2・3/4）も必ず視認する** — 拍ちょうど・カット境界ちょうどのフレームは区間の境界値（0% / 100% = 画面外・opacity 0）に必ず当たるため、正常な動きを事故と誤診する（`akari capture --auto` は各オーバーレイ / 字幕区間の中点を含む代表時刻を決定論で導出する）。機械検査の PASS を意味的な品質確認の代わりにしない。
+6. PASS 後に [既存プレビューの起動・確認](preview.md) に従って対象の `edit.json` を開き、再生・シーク・音声（ある場合）を確認する。専用プレイヤーを自作しない。確認した入口と未確認項目を報告に明記する。そのうえで、カット境界と overlay の開始・終了フレームを実際に視認する。**開始・終了フレームに加えて中間時刻（各区間の 1/4・1/2・3/4）も必ず視認する** — 拍ちょうど・カット境界ちょうどのフレームは区間の境界値（0% / 100% = 画面外・opacity 0）に必ず当たるため、正常な動きを事故と誤診する（`akari capture --auto` は各オーバーレイ / 字幕区間の中点を含む代表時刻を決定論で導出する）。機械検査の PASS を意味的な品質確認の代わりにしない。
 7. `<project>/.akari/reports/edit-lint-report.html` とフレーム視認結果を編集レポートへ反映し、checkpoint 状態と provenance を実態に合わせて閉じる。
 
 音声も確認するときだけ `--media` を追加する。無音区間と音量値は既定で warning になり、次の明示閾値を指定した検査だけが FAIL になり得る。

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

@@ -0,0 +1,31 @@
+# 既存プレビューを開いて確認する
+
+制作・QA では既存の出力プレビューを使う。対象はプロジェクトの `edit.json`。
+プレビュー提供だけを目的に、案件専用の再生 HTML・再生 UI・シーク・音声同期・編集データ変換を
+新規実装しない。利用者が独立した再生ページを明示的に依頼した場合は、その依頼範囲で作成する。
+
+## 起動と接続
+
+1. 対象プロジェクトの絶対パスを確認する。起動済みの既存プレビューが同じプロジェクトを
+   開いていれば再利用する。ポートが開いているだけでは対象プロジェクトの一致とみなさない。
+2. **デスクトップアプリ**: 対象フォルダを開き、タイムラインから「出力プレビュー」を開く。
+   ブラウザで見る場合は左の「メニュー」→「ブラウザプレビュー」を使い、起動後に表示される
+   URL を開く。アプリ同梱の機能なので `~/.akari/app` や別途 Node の導入を前提にしない。
+3. **`install.sh` / ソース版**: 実在する `akari.sh` を使い、別の端末で
+   `./akari.sh --preview /absolute/path/to/project --port 4567` を実行する。
+   `~/.akari/app` に導入した場合は、その中の `akari.sh` をフルパスで指定できる。
+   起動ログの Project と URL を確認し、その URL を開く。ポート競合時は別の空きポートを指定する。
+   存在を確認していない CLI コマンドやインストールパスを作り上げない。
+4. 画面に対象作品が表示されることを確認する。HTTP 200 やサーバー起動ログだけで完了にしない。
+   起動・読込が失敗したら、使った入口、対象パス、操作またはコマンド、エラーを記録する。
+   診断は最小限にとどめ、代替プレイヤーの開発へ進まない。
+
+## 確認と報告
+
+- 既存画面で再生・停止し、区間の途中へシークして表示が変わることを確認する。
+  開始・終了に加え区間中間（1/4・1/2・3/4）も見る。音声がある場合は音声再生も確認する。
+- 「プレビュー確認済み」は上記を実施した場合に限る。アプリ内か既存ブラウザか、
+  対象プロジェクト、確認時刻、再生・シーク・音声の結果と証跡を記録する。
+- `akari capture` のフレーム視認や描画部品単独の比較は、それぞれその検証として記録する。
+  別ページの描画一致をアプリの入口・素材判定・読込・再生の確認へ読み替えない。
+  未確認の経路と音声を未確認と明記する。

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

@@ -19,6 +19,8 @@ description: analyze-project が作る分析レポート（interpretation.json +
 
 ## 出力ルール（全モード共通）
 
+- 仕上がりを見せる前に [既存プレビューの起動・確認](../edit-lint/preview.md) を読む。既存機能を使い、案件専用の再生 HTML・再生 UI・音声同期を自作しない（利用者が独立ページを明示依頼した場合を除く）。確認した入口を報告に明記する。
+
 - 判断の正本は検証済み `analysis.json` に置き、根拠のない transcript、フレーム、素材、承認を作らない。
 - 決定は `decision-log.md` へ記録する。`decision-log.md` の既存行は変更・削除せず、常に追記する。
   `decision-log.md` を読み取り専用 HTML へ派生描画する判断記録レポート

package/vendor/skills/edit-plan/autonomy.md

@@ -32,10 +32,10 @@
 1. 依頼文 + `intake.tasks` + akari.md の好みで「入れる物」を決める。**頼まれた物に加えて良さそうな物を足してよい**（B ロール・図解・テロップ演出・BGM・SE・章立て。足す判断は akari.md の調達の好み表に従う）。
 2. 分析は事実層 `analysis.json` だけを読む。分析レポートの必読は課さない。無ければ [analyze-footage](../analyze-footage/SKILL.md) の既定（L0 + L1）を実行する。
 3. 方針・素材計画をチャットで提示しない・承認を求めない。
-4. **足した物 1 件ごとに `decision-log.md` へ「予測」1 行**を、タイムラインに入れるのと同じターンで書く。既存の [decision_log 表形式](report-guide.md#decision_log) を使い、ISO 8601 日時と `category = proposal` / `subject = item id または caption id` / `決定 = 何を入れたか` / `理由 = なぜ良さそうか（根拠 = analysis.json のどこ / akari.md のどの行）` / `決定者 = machine:director` / `関連 = 出所（素材 id・手段）` を記す。頼まれた物そのもの（提案でない物）には予測行を書かない。予測行の欠落は edit-lint の warning 止まりとする。
+4. **足した物 1 件ごとに `decision-log.md` へ「予測」1 行**を、タイムラインに入れるのと同じターンで書く。既存の [decision_log 表形式](report-guide.md#decision_log) を使い、ISO 8601 日時と `category = proposal` / `subject = item id または caption id` / `決定 = 何を入れたか` / `理由 = なぜ良さそうか（根拠 = analysis.json のどこ / akari.md のどの行）` / `決定者 = machine:director` / `関連 = 出所（素材 id・手段）` を記す。関連セルには必ず `sha:<提案時の item / record の canonical JSON の sha256 先頭 8 hex>` を含める。canonical JSON はオブジェクトのキーを再帰的にソートして JSON.stringify した文字列（配列の順序は保持）とする。例: `source-01 / HTML overlay sha:1a2b3c4d`（sha は提案時の実データから計算する）。頼まれた物そのもの（提案でない物）には予測行を書かない。予測行の欠落は edit-lint の warning 止まりとする。
 5. [execution.md](execution.md) の出力ルールで v2 の `edit.json` / `captions.json` / overlays を書き、書いた直後に [edit-lint](../edit-lint/SKILL.md) を実行する。FAIL は直して再実行する。直せなければ §4 に従って止まる。原本は変更せず、`edit.json` を書くのはディレクター 1 人とし、生成物には `<file>.meta.json` の provenance を残す。字幕は `akari captions <project-dir>`（execution.md §4）を使う。
 6. **書き出さない（render-cut を呼ばない）**。最後に「入れた物 N 件（うち提案 M 件・帳面に M 行）・lint 結果・**プレビューで見て、要らなければ消してください。書き出しはヘッダの書き出しボタン**」を報告する。この報告が唯一のチャット出力となる（§1 の offer-once と §4 の停止時の連絡を除く）。
-7. 人間が消した / 直した / そのまま出した の**結果行は書き出し時**に機械が追記する（render-cut 側・別票）。
+7. 人間が消した / 直した / そのまま出した の**結果行は書き出し時**に `akari decision-log settle`（render-cut の CLI が自動で呼ぶ）が追記する。シェルの書き出しからの呼び出しは別票。
 
 ## 4. 止まる条件（3 つだけ）
 

package/vendor/skills/edit-plan/execution.md

@@ -169,8 +169,8 @@ akari captions <project-dir>
 - **次 caption の start まで引き伸ばさない**（敷き詰め禁止）。**無発話区間は無字幕**とし、隙間を字幕で埋めない。短い字幕は次 caption を超えない範囲で既定 1.0 秒の床まで延ばし、床に届かない場合は warning を確認する。
 - caption の start / end は source 秒アンカー（§1）。`words[]` も同じ source 秒で持つ。
 
-`--max-chars` は方針で文字数上限を決めたときだけ指定する。複数素材では `--source <sources[].id>` で対象を選ぶ。
-按分 fallback は CLI が内包する（語時刻が無い場合は segment 境界を使い、分割せず読み切り猶予を加える）。
+`--max-chars` は既定 20・文節優先（句点 > ポーズ > 読点 > 文字数 / 秒数）。`--split none` で旧挙動に戻せる。複数素材では `--source <sources[].id>` で対象を選ぶ。
+按分 fallback は CLI が内包する（語時刻が無い場合は句点等で切り、segment 区間を文字数比で按分して読み切り猶予を加える）。
 字幕の付ける/付けない・スタイル等の方針レベルは [report-guide.md](report-guide.md) の素材計画 §字幕枠で決め、ここでは区間の作り方だけを定める。
 
 ### 字幕スタイルを適用する

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

@@ -146,6 +146,14 @@ fragment は単一ルートとし、透明 canvas、任意の静的 fallback、
   `offsetWidth` / `offsetHeight`（fallback は `clientWidth` / `clientHeight`）から決まるため、
   回転で投影が縦横に歪むことはなく、回転用の回避策は不要。
 
+## 端末画面・キーの反射と材質
+
+端末モックの画面を生成・差し替え・PBR へ変換するときは
+[画面・キーの共通材質生成と比較](device-materials.md) を読む。
+発光画像があっても鏡面反射は残る。画面・キー・印字・筐体を分け、ガラス画面のスマホも
+正面と斜めで確認する。共通の生成ヘルパーに明示した対象へだけ設定し、案件専用の GLB
+後処理や全体露出の調整で回避しない。
+
 ## texts[] — 3D テキスト（flat / extrude。2026-08-12 導入。contract-2026-08-12-3d-text-rail.md）
 
 `data-akari-3d-scene` に `texts[]` を足すと、troika-three-text（SDF 平面文字）で per-char に

package/vendor/skills/overlay-authoring/SKILL.md

@@ -37,7 +37,7 @@ description: AKARI Video のオーバーレイ HTML、字幕、表・グラフ
 
 - 字幕・テロップの日本語組版、可読性、配置: [telop.md](telop.md)
 - 表・グラフの HTML/CSS 構成とアニメーション: [table.md](table.md)
-- Three.js + glTF、動画テクスチャ、3D 性能: [3d.md](3d.md)
+- Three.js + glTF、動画テクスチャ、3D 性能: [3d.md](3d.md)。端末の画面・キーの生成や反射調整は [device-materials.md](device-materials.md) も読む。
 - ガラス屈折の宣言、入れ子、ツマミ、静止背景: [glass.md](glass.md)
 - 新しい描画の種類は `packages/overlay-runtime/runtimes.mjs` のマニフェストへ登録する（追加手順: `packages/overlay-runtime/README.md`）。
 - 決定的モーション、イージング、compositor 制約: [motion.md](motion.md)

package/vendor/skills/overlay-authoring/dev-fixtures/test_device_materials.py

@@ -0,0 +1,75 @@
+import copy
+import importlib.util
+import json
+from pathlib import Path
+import struct
+import sys
+sys.dont_write_bytecode = True
+import unittest
+
+spec = importlib.util.spec_from_file_location('device_materials', Path(__file__).parents[1] / 'scripts/device_materials.py')
+module = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(module)
+
+class DeviceMaterialsTest(unittest.TestCase):
+    def setUp(self):
+        self.gltf = {'asset': {'version': '2.0'}, 'materials': [
+            {'name': 'screen', 'emissiveFactor': [1, 1, 1], 'emissiveTexture': {'index': 0},
+             'pbrMetallicRoughness': {'baseColorFactor': [0, 0, 0, 1]}},
+            {'name': 'key', 'pbrMetallicRoughness': {'baseColorFactor': [.03, .03, .04, 1]},
+             'extensions': {'KHR_materials_clearcoat': {'clearcoatFactor': .12, 'clearcoatTexture': {'index': 1}}}}
+        ], 'meshes': [
+            {'name': 'display', 'primitives': [{'material': 0, 'attributes': {'POSITION': 0}}]},
+            {'name': 'keyboard', 'primitives': [{'material': 1, 'attributes': {'POSITION': 1}}]},
+            {'name': 'usb', 'primitives': [{'material': 1, 'attributes': {'POSITION': 2}}]}
+        ], 'animations': [{'name': 'motion'}]}
+        self.profiles = [
+            {'material': 'screen', 'values': {'metallic': 0, 'roughness': .9, 'specular': .05}},
+            {'material': 'key', 'meshes': ['keyboard'], 'name': 'keyboard-matte', 'values': {'roughness': .9, 'specular': .02, 'clearcoat': 0}}
+        ]
+
+    def test_selected_mesh_gets_its_own_material_and_usb_and_emission_survive(self):
+        before = copy.deepcopy(self.gltf)
+        result, records = module.apply_profiles(self.gltf, self.profiles)
+        self.assertEqual(self.gltf, before)
+        self.assertEqual(result['materials'][1], before['materials'][1])
+        self.assertEqual(result['meshes'][2], before['meshes'][2])
+        self.assertEqual(result['meshes'][1]['primitives'][0]['material'], 2)
+        self.assertEqual(result['materials'][0]['emissiveTexture'], {'index': 0})
+        self.assertEqual(result['materials'][0]['emissiveFactor'], [1, 1, 1])
+        self.assertEqual(result['materials'][2]['extensions']['KHR_materials_clearcoat']['clearcoatTexture'], {'index': 1})
+        self.assertEqual(records[1]['meshes'], ['keyboard'])
+        self.assertIn('KHR_materials_specular', result['extensionsUsed'])
+
+    def test_binary_geometry_animation_and_images_are_unchanged_and_output_is_deterministic(self):
+        j = json.dumps(self.gltf).encode(); j += b' ' * (-len(j) % 4)
+        binary = b'preserve mesh image animation!!! ' * 4
+        raw = struct.pack('<III', 0x46546C67, 2, 28 + len(j) + len(binary)) + struct.pack('<II', len(j), module.JSON_CHUNK) + j + struct.pack('<II', len(binary), 0x004E4942) + binary
+        out, report = module.prepare_glb(raw, self.profiles)
+        result, chunks = module.read_glb(out)
+        self.assertEqual(chunks[1][1], binary)
+        self.assertEqual(result['animations'], self.gltf['animations'])
+        self.assertTrue(report['binary_chunks_unchanged'])
+        self.assertEqual(module.prepare_glb(raw, self.profiles)[0], out)
+
+    def test_invalid_profiles_fail_without_mutating_the_input(self):
+        before = copy.deepcopy(self.gltf)
+        for profile in [
+            {'material': 'missing', 'values': {'roughness': .5}},
+            {'material': 'key', 'meshes': ['missing'], 'name': 'new', 'values': {'roughness': .5}},
+            {'material': 'key', 'meshes': ['keyboard'], 'name': 'screen', 'values': {'roughness': .5}},
+            {'material': 'key', 'values': {'brightness': .5}},
+            *[{'material': 'key', 'values': {'roughness': value}} for value in [-1, 2, True, float('nan'), float('inf')]],
+        ]:
+            with self.subTest(profile=profile), self.assertRaises(ValueError):
+                module.apply_profiles(self.gltf, [self.profiles[0], profile])
+        self.assertEqual(self.gltf, before)
+
+    def test_ambiguous_names_are_rejected(self):
+        self.gltf['materials'].append(copy.deepcopy(self.gltf['materials'][0]))
+        with self.assertRaises(ValueError): module.apply_profiles(self.gltf, self.profiles)
+
+    def test_truncated_glb_is_rejected(self):
+        with self.assertRaises(ValueError): module.read_glb(b'glTF')
+
+if __name__ == '__main__': unittest.main()

package/vendor/skills/overlay-authoring/device-materials.md

@@ -0,0 +1,64 @@
+# 端末画面・キーの材質を生成時に整える
+
+画面の白濁を見つけたら、まず取得原本・生成レシピ・ライブ用派生 GLB の材質を区別する。
+黒い Base Color と発光画像だけでは PBR の鏡面反射は止まらない。Emission を Principled に
+置き換える経路では metallic / roughness / specular / clearcoat の実効値も調べる。
+
+画面、キーの樹脂、印字、筐体、トラックパッドを個別に扱う。画面のためにシーン全体の
+環境光・露出を下げない。`ScreenMaterial` 等の名前から全素材へ無条件に設定を適用しない。
+
+## 共通の生成入口
+
+[scripts/device_materials.py](scripts/device_materials.py) は GLB の JSON チャンクだけに
+明示指定した材質係数を適用する。画像、形状、カメラ、アニメーションの BIN チャンクは
+バイト単位で保持する。`emissiveTexture` / `emissiveFactor` / 発光強度、未指定の係数・
+テクスチャ・拡張も維持する。ランタイムの `materialOverrides` に未対応キーを追加しない。
+
+Blender レシピから `export_glb(filepath, profiles, **export_options)` を呼ぶと、通常の GLB
+書き出しと材質設定が一つの生成処理になる。モジュールはこのスキルの `scripts/` から
+`importlib.util.spec_from_file_location` で読み込める。プロジェクトへ配備されたスキルは
+`.claude/skills/overlay-authoring/scripts/device_materials.py`。単独配布レシピに組み込む場合は
+ヘルパーもレシピ内へ同梱し、ユーザー固有の絶対パスを埋め込まない。
+
+既存モデルを確認用の派生物へ変換するときは Python 3 で次を実行する:
+
+```sh
+python3 .claude/skills/overlay-authoring/scripts/device_materials.py \
+  --input assets/models/original.glb --output assets/generated/device-matte.glb \
+  --profiles .akari/work/keep/device-material-profiles.json \
+  --report .akari/reports/device-materials.json
+```
+
+入力・既存出力は上書きしない。原本を更新する回避スクリプトを案件ごとに作らない。
+選定した profiles JSON を生成レシピの入力として残し、後段の変換では材質を保持する。
+
+profiles は明示的な対象の配列。次は強いスタジオ照明で確認した候補値の例であり、
+全端末に使う既定値ではない。`values` の各係数は 0〜1。
+
+```json
+[
+  {"material":"ScreenMaterial","values":{"metallic":0,"roughness":0.90,"specular":0.05}},
+  {"material":"keycap","meshes":["keyboard_keys"],"name":"KeyboardMatteMaterial",
+   "values":{"roughness":0.90,"specular":0.02,"clearcoat":0}}
+]
+```
+
+`meshes` を指定すると材質を複製し、そのメッシュの対象 primitive にだけ割り当てる。
+USB 端子などで共有される元の keycap 材質は維持する。材質名・メッシュ名が重複して
+曖昧な場合、対象が無い場合、未知の係数や範囲外の値はエラーにする。
+`meshes` を省略するとその材質の全使用箇所が対象になるため、監査レポートの対象一覧を確認する。
+
+## 比較と採用
+
+- 同じ画像・カメラ・照明・発光倍率で、正面と左右斜めを比較する。キーは specular、
+  clearcoat、roughness を一つずつ変えた対照を作り、色・露出を先に暗くして原因を隠さない。
+- ガラス画面のスマホも同じ照明で確認する。発光画面の挿入板と、その背後のガラス・
+  ベゼル・背面を分ける。白濁を再現しないモデルへ不要な変更を入れない。
+- 画像と動画の差し替え、brightness の保持を検査する。GLB の
+  `KHR_materials_specular` / `KHR_materials_clearcoat` が読み込み後も残ることを確認する。
+  `threeRuntime.inspect(container).materials` は読み込み後の係数を返す検証用の入口。
+- [既存プレビュー](../edit-lint/preview.md) と実際の GPU / OSR 出力で比較し、どの入口で
+  再生・シーク・フレームを確認したか明記する。別ページの描画をアプリ確認済みとしない。
+- 比較画像、採用値、素材の版・ハッシュ、変更対象と非対象の不変確認を記録する。
+  画面の黒・白文字・色付き UI、キー印字と筐体の区別が保たれることを視認する。
+  配布原本の更新は検証済みの版更新として行い、既存案件の原本を置き換えない。

package/vendor/skills/overlay-authoring/scripts/device_materials.py

@@ -0,0 +1,157 @@
+"""Explicit, reproducible material profiles at the glTF export boundary.
+
+No material is selected by convention. Numeric factors are authored per model and lighting.
+Import export_glb from a Blender recipe, or use --input/--output/--profiles for a derivative.
+"""
+import argparse
+import copy
+import hashlib
+import json
+import math
+from pathlib import Path
+import struct
+import tempfile
+
+JSON_CHUNK = 0x4E4F534A
+FACTORS = {
+    'metallic': ('pbrMetallicRoughness', 'metallicFactor'),
+    'roughness': ('pbrMetallicRoughness', 'roughnessFactor'),
+    'specular': ('KHR_materials_specular', 'specularFactor'),
+    'clearcoat': ('KHR_materials_clearcoat', 'clearcoatFactor'),
+    'clearcoat_roughness': ('KHR_materials_clearcoat', 'clearcoatRoughnessFactor'),
+}
+
+
+def read_glb(data):
+    if len(data) < 20 or struct.unpack_from('<III', data) != (0x46546C67, 2, len(data)):
+        raise ValueError('Expected a complete glTF 2.0 GLB')
+    chunks = []
+    offset = 12
+    while offset < len(data):
+        if offset + 8 > len(data):
+            raise ValueError('Truncated GLB chunk header')
+        size, kind = struct.unpack_from('<II', data, offset)
+        offset += 8
+        if size % 4 or offset + size > len(data):
+            raise ValueError('Invalid GLB chunk size')
+        chunks.append((kind, data[offset:offset + size]))
+        offset += size
+    if not chunks or chunks[0][0] != JSON_CHUNK or sum(k == JSON_CHUNK for k, _ in chunks) != 1:
+        raise ValueError('Expected exactly one leading JSON chunk')
+    return json.loads(chunks[0][1]), chunks
+
+
+def apply_profiles(gltf, profiles):
+    """Return a copy and audit records; preserve all unselected data and texture bindings."""
+    if not isinstance(profiles, list) or not profiles:
+        raise ValueError('profiles must be a nonempty array of explicit targets')
+    result = copy.deepcopy(gltf)
+    records = []
+    for profile in profiles:
+        if not isinstance(profile, dict) or set(profile) - {'material', 'meshes', 'name', 'values'}:
+            raise ValueError('A profile accepts material, meshes, name, values only')
+        name = profile.get('material')
+        matches = [i for i, m in enumerate(result.get('materials', [])) if m.get('name') == name]
+        if not isinstance(name, str) or not name or len(matches) != 1:
+            raise ValueError(f'Material must match exactly once: {name!r}')
+        values = profile.get('values')
+        if not isinstance(values, dict) or not values or set(values) - FACTORS.keys():
+            raise ValueError(f'Explicit material factors required: {name}')
+        for key, value in values.items():
+            if isinstance(value, bool) or not isinstance(value, (int, float)) or not math.isfinite(value) or not 0 <= value <= 1:
+                raise ValueError(f'{name}.{key} must be finite and between 0 and 1')
+        index = matches[0]
+        material = result['materials'][index]
+        before = copy.deepcopy(material)
+        affected = []
+        if 'meshes' in profile:
+            targets = profile['meshes']
+            if not isinstance(targets, list) or not targets or any(not isinstance(t, str) or not t for t in targets) or len(set(targets)) != len(targets):
+                raise ValueError('meshes must contain unique explicit mesh names')
+            clone_name = profile.get('name')
+            if not isinstance(clone_name, str) or not clone_name or any(m.get('name') == clone_name for m in result['materials']):
+                raise ValueError('Mesh-scoped profiles require a unique cloned material name')
+            material = copy.deepcopy(material)
+            material['name'] = clone_name
+            replacement = len(result['materials'])
+            for target in targets:
+                meshes = [m for m in result.get('meshes', []) if m.get('name') == target]
+                if len(meshes) != 1:
+                    raise ValueError(f'Mesh must match exactly once: {target}')
+                primitives = [p for p in meshes[0].get('primitives', []) if p.get('material') == index]
+                if not primitives:
+                    raise ValueError(f'{target} does not use {name}')
+                for primitive in primitives:
+                    primitive['material'] = replacement
+                affected.append(target)
+            result['materials'].append(material)
+        elif 'name' in profile:
+            raise ValueError('name is only used when cloning for explicit meshes')
+        else:
+            affected = [m.get('name') for m in result.get('meshes', []) if any(p.get('material') == index for p in m.get('primitives', []))]
+        for key, value in values.items():
+            section, field = FACTORS[key]
+            if section == 'pbrMetallicRoughness':
+                material.setdefault(section, {})[field] = value
+            else:
+                material.setdefault('extensions', {}).setdefault(section, {})[field] = value
+                used = result.setdefault('extensionsUsed', [])
+                if section not in used:
+                    used.append(section)
+        records.append({'material': name, 'meshes': affected, 'before': before, 'after': copy.deepcopy(material)})
+    return result, records
+
+
+def prepare_glb(data, profiles):
+    gltf, chunks = read_glb(data)
+    result, records = apply_profiles(gltf, profiles)
+    encoded = json.dumps(result, ensure_ascii=False, separators=(',', ':'), allow_nan=False).encode()
+    encoded += b' ' * (-len(encoded) % 4)
+    updated = [(JSON_CHUNK, encoded), *chunks[1:]]
+    output = struct.pack('<III', 0x46546C67, 2, 12 + sum(8 + len(b) for _, b in updated))
+    output += b''.join(struct.pack('<II', len(b), kind) + b for kind, b in updated)
+    return output, {
+        'source_sha256': hashlib.sha256(data).hexdigest(),
+        'output_sha256': hashlib.sha256(output).hexdigest(),
+        'binary_chunks_unchanged': chunks[1:] == read_glb(output)[1][1:],
+        'changes': records,
+    }
+
+
+def export_glb(filepath, profiles, **options):
+    """Blender recipe entry: export and prepare in one operation, before publishing the GLB."""
+    import bpy
+    target = Path(filepath)
+    target.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.TemporaryDirectory(prefix='akari-material-export-', dir=target.parent) as tmp:
+        raw = Path(tmp) / 'scene.glb'
+        bpy.ops.export_scene.gltf(filepath=str(raw), export_format='GLB', **options)
+        prepared, report = prepare_glb(raw.read_bytes(), profiles)
+        ready = Path(tmp) / 'ready.glb'
+        ready.write_bytes(prepared)
+        ready.replace(target)
+    return report
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--input', required=True, type=Path)
+    parser.add_argument('--output', required=True, type=Path)
+    parser.add_argument('--profiles', required=True, type=Path)
+    parser.add_argument('--report', type=Path)
+    args = parser.parse_args()
+    if args.input.resolve() == args.output.resolve() or args.output.exists():
+        parser.error('Write a new derivative; input and existing files cannot be overwritten')
+    if args.report and (args.report.exists() or args.report.resolve() in {args.input.resolve(), args.output.resolve(), args.profiles.resolve()}):
+        parser.error('Report must be a new, separate file')
+    output, report = prepare_glb(args.input.read_bytes(), json.loads(args.profiles.read_text()))
+    args.output.parent.mkdir(parents=True, exist_ok=True)
+    args.output.write_bytes(output)
+    if args.report:
+        args.report.parent.mkdir(parents=True, exist_ok=True)
+        args.report.write_text(json.dumps(report, ensure_ascii=False, indent=2) + '\n')
+    print(json.dumps(report, ensure_ascii=False))
+
+
+if __name__ == '__main__':
+    main()

package/vendor/skills/render-cut/SKILL.md

@@ -86,6 +86,7 @@ node の解決順は `AKARI_NODE_BIN` → PATH の node（20 以上）→ 同梱
 
 - 成果物は既定で `<project>/exports/<source-name>.mp4` に置く。既存名があれば連番を使う。
 - 状態の正本は `<project>/.akari/render.json` とする。HTML レポートは可視化専用とする。
+- CLI は書き出し成功後に帳面の結果行を追記する（`akari decision-log settle`）。`--no-settle` で抑止できる。
 - 成功時だけ `<project>/.akari/render-tmp/` を削除する。失敗時は診断用に保持する。
 - 字幕は `captions.json` から決定的な HTML へ生成し、他のオーバーレイと同じ経路で焼き込む。
 - 字幕スタイルの preset は `presets/textstyle/` にあり、`akari-apply-textstyle.mjs` で `captions.json` へ適用できる。この実行体も同じ解決の対象で、`<render-cut>` と同じ `bin/` 配下にある。通常は edit-plan 段階で適用を済ませ、render-cut はその結果をそのまま描画する。

package/vendor/templates/project-default/AGENTS.md

@@ -21,6 +21,17 @@
   ローカル候補は (b) `install.sh` 経路の `~/.akari/app/docs/contract-2026-07-25-project-structure-v0.md`、
   (c) モノレポの `<repo>/docs/contract-2026-07-25-project-structure-v0.md` である。
 
+## プレビューの確認
+
+プレビューは既存機能を使う。提供するためだけに専用の再生 HTML・再生 UI・音声同期を
+新規実装しない（独立した再生ページを利用者が明示依頼した場合を除く）。
+アプリで対象プロジェクトの出力プレビューを開く。ブラウザ版は「メニュー」→
+「ブラウザプレビュー」から起動できる。詳しくは
+[既存プレビューの起動・確認](.claude/skills/edit-lint/preview.md) を読む。
+起動できない場合は原因と再現条件を記録する。確認済みと報告するには既存画面で
+再生・シーク・音声（ある場合）を確認し、アプリ内／既存ブラウザのどちらかを明記する。
+描画部品や別ページだけの検証を、既存プレビューの確認済みとして扱わない。
+
 ## AKARI Video の在処
 
 - `~/.akari/cli` … CLI 本体とシム（`~/.akari/cli/bin/akari`）。パートナー接続時に配備される。

package/vendor/templates/project-default/CLAUDE.md

@@ -23,6 +23,17 @@
 購入していれば使え、未購入のものは価格付きの `locked` と表示されます。ライブラリの実体は
 `~/.akari/assets/` に置かれますが、直接編集せず上記コマンド経由で操作してください。
 
+## プレビューの確認
+
+プレビューは既存機能を使う。提供するためだけに専用の再生 HTML・再生 UI・音声同期を
+新規実装しない（独立した再生ページを利用者が明示依頼した場合を除く）。
+アプリで対象プロジェクトの出力プレビューを開く。ブラウザ版は「メニュー」→
+「ブラウザプレビュー」から起動できる。詳しくは
+[既存プレビューの起動・確認](.claude/skills/edit-lint/preview.md) を読む。
+起動できない場合は原因と再現条件を記録する。確認済みと報告するには既存画面で
+再生・シーク・音声（ある場合）を確認し、アプリ内／既存ブラウザのどちらかを明記する。
+描画部品や別ページだけの検証を、既存プレビューの確認済みとして扱わない。
+
 ## AKARI Video の在処
 
 - `~/.akari/cli` … コマンド操作の本体と入口（`~/.akari/cli/bin/akari`）です。パートナー接続時に配備されます。