akari-video 1.3.0-beta.5 → 1.3.0-beta.6

package/package.json

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

package/vendor/docs/contract-2026-07-13-asset-library.md

@@ -374,7 +374,7 @@ catalog に載せる素材は、取得元のライセンスが CC0 相当（帰
 | v1 category | 形の定義 | 判定 | 旧 category |
 |---|---|---|---|
 | `overlay` | 時間を持つ HTML 断片 | `fragment.html` を `overlays[]` から合成。断片ルートに時刻を置かず、素材本来の長さは `data-akari-natural-duration`（秒）に記録 | `telop` / `motion` |
-| `still` | 時間を持たない HTML シート | `fragment.html`。決定的スクショで画像に焼く | `thumbnail` |
+| `still` | 時間を持たない静止画（画像 1 枚 + 任意でツマミ用の HTML シート） | **既定は直下の画像（`preview.png` 以外の 1 枚）を `sources[]` の media クリップとして置く**。`fragment.html` は色相などのツマミを使うとき・画像が 1 枚に決まらないときだけ（2026-10-12 改訂）。HTML シートは決定的スクショで画像に焼ける | `thumbnail` |
 | `scene3d` | 3D モデル + 表示断片、またはベイクレシピ | `fragment.html` + glTF、または `scene.py` | `3d` |
 | `audio` | 音声トラックに載るバイナリ | `edit.json` の `audio.bgm` / `sfx` が参照 | `audio`（変更なし） |
 | `broll` | 映像トラックに載る実写バイナリ | `sources[]` が参照 | `broll`（変更なし） |

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.3.0-beta.5",
+  "version": "1.3.0-beta.6",
   "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/asset-resolver/src/library.mjs

@@ -117,5 +117,7 @@ export function readLocalLibraryItem(env, category, id) {
     mediaFile: primaryMediaFile(category, files), libraryDir,
     addedAt: new Date(info.birthtimeMs > 0 ? info.birthtimeMs : info.mtimeMs).toISOString(),
     creditText, warnings, state: 'cached',
+    // meta.json の無い取り寄せ（AKARI Sounds は音源ファイルだけを配る）を合成側が見分ける。
+    metaOk: Object.keys(meta).length > 0,
   };
 }

package/vendor/packages/asset-resolver/src/state.mjs

@@ -82,11 +82,17 @@ export async function composeState({ env = process.env, fetchImpl = fetch, inten
     localItems.delete(key);
     // Preserve remote download descriptors/preview keys for existing consumers.
     // Local-only assets use the actual directory listing assembled above.
-    return local ? { ...item, ...local, tier: item.tier ?? assetTier(item), files: item.files ?? local.files, preview: local.libraryDir && local.preview ? local.preview : item.preview ?? local.preview,
-      ...(item.source === 'installed' ? { source: item.source } : {}) } : item;
+    if (!local) return item;
+    // meta.json の無い取り寄せは表示用の title / tags をカタログから引き継ぐ。空の tags で上書きすると
+    // 効果音の 'sfx' が消え、ライブラリの BGM 側へ混ざっていた（オーナー指摘 2026-10-12）。
+    const { metaOk, ...localFields } = local;
+    return { ...item, ...localFields,
+      ...(metaOk ? {} : { title: item.title ?? localFields.title, tags: item.tags ?? localFields.tags }),
+      tier: item.tier ?? assetTier(item), files: item.files ?? local.files, preview: local.libraryDir && local.preview ? local.preview : item.preview ?? local.preview,
+      ...(item.source === 'installed' ? { source: item.source } : {}) };
   });
   const localOnlyKeys = new Set(localItems.keys());
-  merged.push(...[...localItems.values()].filter(Boolean));
+  merged.push(...[...localItems.values()].filter(Boolean).map(({ metaOk, ...local }) => local));
   const items = merged.map((item) => {
     const key = `${item.category}/${item.id}`;
     const tier = localOnlyKeys.has(key) && !Object.hasOwn(item, 'tier')

package/vendor/packages/asset-resolver/test/local-library.test.mjs

@@ -185,3 +185,19 @@ test('cached Lab items retain remote preview and file descriptors', async t => {
   assert.deepEqual(item.files, remote.files);
   assert.ok(item.libraryDir);
 });
+
+test('downloaded catalog audio without meta.json keeps the catalog tags and title (sfx stays out of BGM)', async t => {
+  const { env, catalog, catalogPath } = fixture(t);
+  catalog.items.push({ id: 'sfx-x', category: 'audio', title: 'ベルの効果音', tags: ['bell', 'sfx'],
+    license: { spdx: 'CC0-1.0' }, version: 1, tier: 'free', files: [{ name: 'sfx-x.mp3', key: 'audio/sfx-x/v1/sfx-x.mp3', bytes: 5 }] });
+  writeFileSync(catalogPath, `${JSON.stringify(catalog, null, 2)}\n`);
+  // AKARI Sounds の取り寄せは音源ファイルだけで meta.json を持たない。
+  const dir = path.join(env.AKARI_LIBRARY_ROOT, 'audio', 'sfx-x');
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(path.join(dir, 'sfx-x.mp3'), 'sound');
+  const item = (await composeState({ env })).items.find(row => row.id === 'sfx-x');
+  assert.equal(item.state, 'cached');
+  assert.ok(item.tags.includes('sfx'));
+  assert.equal(item.title, 'ベルの効果音');
+  assert.equal(Object.hasOwn(item, 'metaOk'), false);
+});

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

@@ -359,7 +359,17 @@ export function validateCaptions(captions, edit, analysis, findings, paths, cuts
       if (caption.time_domain !== "output") {
         const kept = keptOverlap(caption.start, caption.end, edit?.cuts, caption.src);
         const ratio = kept / (caption.end - caption.start);
-        if (ratio < 0.5 - EPSILON) {
+        if (kept <= EPSILON) {
+          // 話した区間ごとカットで消した字幕は出ないのが正しい結果。エラーにすると GUI で
+          // カットするたびに誤報になるため記録だけ残す（オーナー裁定 2026-10-12）。
+          addFinding(findings, {
+            severity: "info",
+            check: "captions.cut-removed",
+            message: "the caption is entirely inside removed sections and will not be shown",
+            path: itemPath,
+            range: { start: caption.start, end: caption.end },
+          });
+        } else if (ratio < 0.5 - EPSILON) {
           addFinding(findings, {
             severity: "error",
             check: "captions.cut-visibility",

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

@@ -22,6 +22,12 @@ export interface EditLintFinding {
     message?: string;
     check?: string;
     path?: string;
+    range?: {
+        start?: number;
+        end?: number;
+    };
+    /** 今回の保存より前の lint にも同じ指摘があった（この保存が起こした問題ではない）。 */
+    preexisting?: boolean;
 }
 export interface EditLintGateResult {
     pass: boolean;
@@ -95,6 +101,12 @@ export declare function assertNoCamelCaseTransitionOut(content: string): void;
  * これは render-cut が読む PASS ゲートを常に最新に保つ、意図した保存後 lint の副作用。
  */
 export declare function scheduleProjectLint(projectRoot: string, options?: DeferredLintOptions): void;
+/**
+ * 保存前の lint にも有った指摘へ preexisting を付ける。字幕の挿入で配列の番号がずれても
+ * 同じ指摘と分かるよう、時刻範囲を持つ指摘は path の番号ではなく範囲で照合する。
+ * 基準が無い（初回・lint.json 不在）ときは従来どおり全部を今回の保存の指摘として返す。
+ */
+export declare function markPreexistingLintFindings(result: EditLintGateResult, baseline: readonly EditLintFinding[] | undefined): EditLintGateResult;
 export declare function writeAtomic(destination: string, content: string): Promise<void>;
 /**
  * edit-lint をプロセス内実行する。inputOverrides は候補全文のメモリ差し替え。

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

@@ -27,6 +27,7 @@ exports.writeSavedByStamp = writeSavedByStamp;
 exports.writeProjectFilesGuarded = writeProjectFilesGuarded;
 exports.assertNoCamelCaseTransitionOut = assertNoCamelCaseTransitionOut;
 exports.scheduleProjectLint = scheduleProjectLint;
+exports.markPreexistingLintFindings = markPreexistingLintFindings;
 exports.writeAtomic = writeAtomic;
 exports.runEditLint = runEditLint;
 exports.findEditLintModulePath = findEditLintModulePath;
@@ -72,6 +73,10 @@ const DEFAULT_LINT_DEBOUNCE_MS = 400;
 const lintTimers = new Map();
 const lintRevisions = new Map();
 const lintRunChains = new Map();
+/** プロジェクトごとの直近の保存後 lint の指摘。次の保存の「保存前から有った指摘」の基準にする。 */
+const lastLintFindings = new Map();
+/** debounce 窓の最初の書き込みの直前に取った基準。窓の lint が走るときに消費する。 */
+const pendingLintBaselines = new Map();
 const dynamicImport = new Function('specifier', 'return import(specifier)');
 /**
  * 実ファイルは変更せず、候補全文だけを options.inputOverrides で差し替えて検証する。
@@ -227,6 +232,10 @@ async function writeProjectFilesGuarded(projectRoot, candidates, options = {}) {
     if (typeof editCandidate === 'string') {
         assertNoCamelCaseTransitionOut(editCandidate);
     }
+    const lintKey = (0, path_1.resolve)(projectRoot);
+    if (!pendingLintBaselines.has(lintKey)) {
+        pendingLintBaselines.set(lintKey, lastLintFindings.get(lintKey) ?? await readPersistedLintFindings(projectRoot));
+    }
     for (const [name, text] of Object.entries(candidates)) {
         if (text === null) {
             continue;
@@ -288,10 +297,18 @@ function scheduleProjectLint(projectRoot, options = {}) {
     }
     const timer = setTimeout(() => {
         lintTimers.delete(key);
+        const baseline = pendingLintBaselines.get(key);
+        pendingLintBaselines.delete(key);
         const previousRun = lintRunChains.get(key) ?? Promise.resolve({ pass: true, errors: [], findings: [] });
         const currentRun = previousRun
             .catch(() => ({ pass: true, errors: [], findings: [] }))
-            .then(() => (options.lintRunner ?? runEditLint)(key));
+            .then(() => (options.lintRunner ?? runEditLint)(key))
+            .then(result => {
+            if (!result.findings.some(finding => finding.check === 'edit-lint.execution')) {
+                lastLintFindings.set(key, result.findings);
+            }
+            return markPreexistingLintFindings(result, baseline);
+        });
         lintRunChains.set(key, currentRun);
         void currentRun.then(result => lintRevisions.get(key) === revision ? options.onLintResult?.(result) : undefined, error => {
             console.warn('[edit-store] 保存後 edit-lint の実行に失敗しました（保存は維持します）。', error);
@@ -303,6 +320,45 @@ function scheduleProjectLint(projectRoot, options = {}) {
     }, options.debounceMs ?? DEFAULT_LINT_DEBOUNCE_MS);
     lintTimers.set(key, timer);
 }
+/**
+ * 保存前の lint にも有った指摘へ preexisting を付ける。字幕の挿入で配列の番号がずれても
+ * 同じ指摘と分かるよう、時刻範囲を持つ指摘は path の番号ではなく範囲で照合する。
+ * 基準が無い（初回・lint.json 不在）ときは従来どおり全部を今回の保存の指摘として返す。
+ */
+function markPreexistingLintFindings(result, baseline) {
+    if (!baseline?.length)
+        return result;
+    const remaining = new Map();
+    for (const finding of baseline) {
+        const key = lintFindingIdentity(finding);
+        remaining.set(key, (remaining.get(key) ?? 0) + 1);
+    }
+    const findings = result.findings.map(finding => {
+        const key = lintFindingIdentity(finding);
+        const count = remaining.get(key) ?? 0;
+        if (count === 0)
+            return finding;
+        remaining.set(key, count - 1);
+        return { ...finding, preexisting: true };
+    });
+    return { ...result, findings };
+}
+function lintFindingIdentity(finding) {
+    const file = finding.path?.split('#', 1)[0] ?? '';
+    const range = finding.range;
+    const where = range && Number.isFinite(range.start) && Number.isFinite(range.end)
+        ? `${file}@${range.start}-${range.end}` : finding.path ?? '';
+    return JSON.stringify([finding.severity ?? '', finding.check ?? '', finding.message ?? '', where]);
+}
+async function readPersistedLintFindings(projectRoot) {
+    try {
+        const parsed = JSON.parse(await fs_1.promises.readFile((0, path_1.join)(projectRoot, '.akari', 'lint.json'), 'utf8'));
+        return Array.isArray(parsed.findings) ? parsed.findings : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 // 同じ宛先への書き込みは 1 本ずつ直列化する。
 // 一時ファイル名が PID だけだった頃は、同一プロセス内で書き込みが 2 本重なると同じ
 // 一時ファイルを奪い合い、短い方が truncate した後に長い方の書き込みがその先へ着地して

package/vendor/packages/gpu-export/package.json

@@ -8,7 +8,7 @@
     "bundle:frame-engine": "node ../../scripts/gen-frame-engine-bundles.mjs",
     "check:frame-engine-drift": "node ../../scripts/gen-frame-engine-bundles.mjs --check",
     "assert-zero-readback": "node scripts/assert-zero-readback.mjs",
-    "test": "node --test test/*.test.mjs",
+    "test": "node --import ../../scripts/ci/default-test-language.mjs --test test/*.test.mjs",
     "ci:required": "npm test && npm run assert-zero-readback"
   },
   "dependencies": {

package/vendor/packages/i18n/locales/en/lint.json

@@ -3,6 +3,7 @@
   "lint.check.cuts.transitionOutNonAdjacent": "There is a gap before the clip after this transition. Close the gap or remove the transition.",
   "lint.check.cuts.transitionOutZeroOverlap": "This transition has no spare source footage to overlap, so it has no effect. Adjust the clip trim or remove the transition.",
   "lint.check.cuts.transitionOutLayerEvacuated": "This clip is routed through PiP, so its transition will not be exported. Resolve the overlap or remove the transition.",
+  "lint.check.captions.cutVisibility": "More than half of this caption's display time falls in a cut section, so it barely appears. Move its start and end into the kept section, or delete it.",
   "lint.check.captions.overlap": "Caption display times overlap. Move the caption start or end points on the timeline.",
   "lint.check.captions.outputDomainExceedsDuration": "An output-timed caption extends beyond the video duration. It will be clipped at the end during export.",
   "lint.check.cuts.trackOverlap": "Clips overlap on the same video track. Move them apart.",

package/vendor/packages/i18n/locales/en/preview.json

@@ -1,4 +1,6 @@
 {
+  "preview.emphasisWords.validation.expectedArrayWarning": "[akari-preview] Ignored emphasis_words because it is not an array",
+  "preview.emphasisWords.validation.invalidItemWarning": "[akari-preview] Ignored invalid emphasis_words[{index}]",
   "preview.audioMeter.command.openAudioMeterAction": "Open audio meter",
   "preview.audioMeter.display.baseAudioUnavailableLegacyPreviewError": "Base audio is unavailable in legacy preview",
   "preview.audioMeter.display.clearClippingIndicatorAction": "Clear clipping indicator",

package/vendor/packages/i18n/locales/en/surfaces.json

@@ -1735,7 +1735,7 @@
   "surfaces.onboarding.askConnectionCopyEvenConnectedAiSeeFlowExample.message": "You can watch the example without connecting an AI partner.",
   "surfaces.onboarding.askConnectionCopyConnectAiLaterList.message": "You can connect your AI partner from this list later.",
   "surfaces.onboarding.preparing.label": "Preparing...",
-  "surfaces.onboarding.inviteMarkupLikeMakeOneTogetherAddTitlesCaptions.message": "<h2>Make your first video together</h2><p>Add a title and captions to the prepared video, then export. It takes about five minutes, and you can stop anytime.</p>{error}<div class=\"ao-actions\"><button class=\"primary\" data-ao=\"start\">{action}</button></div><div class=\"ao-secondary\"><button data-ao=\"later\">Start on my own later</button></div>",
+  "surfaces.onboarding.inviteMarkupLikeMakeOneTogetherAddTitlesCaptions.message": "<h2>Make your first video together</h2><p>Add a title and captions to the prepared video, then export. It takes about five minutes, and you can stop anytime.</p>{error}{switchNotice}<div class=\"ao-actions\"><button class=\"primary\" data-ao=\"start\">{action}</button></div><div class=\"ao-secondary\"><button data-ao=\"later\">Start on my own later</button></div>",
   "surfaces.home.homeDialogChannelName.label": "Channel name",
   "surfaces.home.welcomeCardOpenFolderAdvanced.button": "Open folder… (advanced)",
   "surfaces.home.welcomeCardOpenProjectLauncher.button": "Open project launcher",
@@ -1927,6 +1927,8 @@
   "surfaces.tools.detectSpeechAnalyzerCheckSpeechanalyzerTerms.label": "Check the SpeechAnalyzer terms of use",
   "surfaces.tools.defaultOpenPathOpenCommandFailed.message": "Could not run the open command.",
   "surfaces.onboarding.inviteMarkupOnceAgain.label": "Try again",
+  "surfaces.onboarding.inviteMarkupAgreeAndStart.label": "Agree and start",
+  "surfaces.onboarding.inviteMarkupPartnerSwitchWarning.message": "The guide will switch from your current project, ‘{current}’, to the guide project (the partner's current work will stop).",
   "surfaces.onboarding.inviteMarkupTry.label": "Try it",
   "surfaces.channelDesign.genre.title": "What do you film?",
   "surfaces.channelDesign.genre.hint": "Choose your main topic. You can change it later.",

package/vendor/packages/i18n/locales/ja/lint.json

@@ -3,6 +3,7 @@
   "lint.check.cuts.transitionOutNonAdjacent": "トランジションの次のクリップとの間にすき間があります。すき間を詰めるか、トランジションを削除してください。",
   "lint.check.cuts.transitionOutZeroOverlap": "トランジションを宣言していますが、のりしろにできる素材の余りがないため効きません。素材のトリムを調整するか、トランジションを削除してください。",
   "lint.check.cuts.transitionOutLayerEvacuated": "このクリップは PiP 経路へ退避されているため、宣言したトランジションは書き出されません。重なりを解消するか、トランジションを削除してください。",
+  "lint.check.captions.cutVisibility": "字幕の表示時間の半分以上がカットした区間にかかっていて、ほとんど映りません。字幕の開始・終了を残した区間に合わせるか、字幕を消してください。",
   "lint.check.captions.overlap": "字幕の表示時間が重なっています。タイムラインで字幕の開始・終了位置をずらしてください。",
   "lint.check.captions.outputDomainExceedsDuration": "出力時間の字幕が動画総尺を超えています。書き出しでは動画終端までにクランプして表示されます。",
   "lint.check.cuts.trackOverlap": "同じ映像トラック上でクリップが重なっています。クリップを重ならない位置へ移動してください。",

package/vendor/packages/i18n/locales/ja/preview.json

@@ -1,4 +1,6 @@
 {
+  "preview.emphasisWords.validation.expectedArrayWarning": "[akari-preview] emphasis_words を無視しました（配列ではありません）",
+  "preview.emphasisWords.validation.invalidItemWarning": "[akari-preview] emphasis_words[{index}] を無視しました（要素が不正です）",
   "preview.audioMeter.command.openAudioMeterAction": "音声メーターを開く",
   "preview.audioMeter.display.baseAudioUnavailableLegacyPreviewError": "legacy プレビューでは土台の音声は含まれません",
   "preview.audioMeter.display.clearClippingIndicatorAction": "クリップ表示を解除",

package/vendor/packages/i18n/locales/ja/surfaces.json

@@ -1735,7 +1735,7 @@
   "surfaces.onboarding.askConnectionCopyEvenConnectedAiSeeFlowExample.message": "AI とつながなくても、流れはお手本で見られます。",
   "surfaces.onboarding.askConnectionCopyConnectAiLaterList.message": "お使いの AI は、あとでこの一覧からつなげます。",
   "surfaces.onboarding.preparing.label": "準備しています…",
-  "surfaces.onboarding.inviteMarkupLikeMakeOneTogetherAddTitlesCaptions.message": "<h2>一緒に 1 本、つくってみませんか？</h2><p>用意した動画に、AI でタイトルと字幕を入れて、書き出すところまで。5 分ほどです。途中でやめても大丈夫です。</p>{error}<div class=\"ao-actions\"><button class=\"primary\" data-ao=\"start\">{action}</button></div><div class=\"ao-secondary\"><button data-ao=\"later\">後で自分で始める</button></div>",
+  "surfaces.onboarding.inviteMarkupLikeMakeOneTogetherAddTitlesCaptions.message": "<h2>一緒に 1 本、つくってみませんか？</h2><p>用意した動画に、AI でタイトルと字幕を入れて、書き出すところまで。5 分ほどです。途中でやめても大丈夫です。</p>{error}{switchNotice}<div class=\"ao-actions\"><button class=\"primary\" data-ao=\"start\">{action}</button></div><div class=\"ao-secondary\"><button data-ao=\"later\">後で自分で始める</button></div>",
   "surfaces.home.homeDialogChannelName.label": "チャンネル名",
   "surfaces.home.welcomeCardOpenFolderAdvanced.button": "フォルダを開く…（上級者向け）",
   "surfaces.home.welcomeCardOpenProjectLauncher.button": "プロジェクト・ランチャーを開く",
@@ -1927,6 +1927,8 @@
   "surfaces.tools.detectSpeechAnalyzerCheckSpeechanalyzerTerms.label": "SpeechAnalyzer の利用条件を確認してください",
   "surfaces.tools.defaultOpenPathOpenCommandFailed.message": "open コマンドに失敗しました。",
   "surfaces.onboarding.inviteMarkupOnceAgain.label": "もう一度",
+  "surfaces.onboarding.inviteMarkupAgreeAndStart.label": "同意してはじめる",
+  "surfaces.onboarding.inviteMarkupPartnerSwitchWarning.message": "いまのプロジェクト『{current}』から、ガイド用のプロジェクトに切り替わります（作業中のパートナーは止まります）",
   "surfaces.onboarding.inviteMarkupTry.label": "やってみる",
   "surfaces.channelDesign.genre.title": "何を撮りますか？",
   "surfaces.channelDesign.genre.hint": "いちばん多いものを 1 つ。あとで変えられます。",

package/vendor/packages/osr-export/package.json

@@ -9,7 +9,7 @@
     "check:frame-engine-drift": "node ../../scripts/gen-frame-engine-bundles.mjs --check",
     "build-fixture": "node scripts/build-fixture.mjs",
     "assert-no-intermediates": "node scripts/assert-no-intermediates.mjs",
-    "test": "node --test test/*.test.mjs",
+    "test": "node --import ../../scripts/ci/default-test-language.mjs --test test/*.test.mjs",
     "ci:required": "npm test",
     "ci:fixture": "node scripts/build-fixture.mjs"
   },

package/vendor/packages/overlay-runtime/src/three-runtime.js

@@ -2132,7 +2132,7 @@ window.akari.threeRuntime = (() => {
   }
 
   // ── 標準ツマミ: モデルの姿勢（--akari-3d-rot-x/y/z）と動きのプリセット（--akari-3d-clip）──
-  // 契約: 内部リポ planning/contract-2026-10-11-3d-place-v0.md §2.1。
+  // 契約: 内部リポの 3D 配置 v0 の設計契約 §2.1。
   // pan/zoom と同じく宣言キー不要で、draw のたびに canvas の computed style から読む。
   //  - 軸は水平を保ったカメラ基準（モデル読み込み完了時点。X = 画面の横（水平）・Y = 真上・Z = 手前。levelledCameraFrame）
   //  - 合成は「X → Y → Z の順にカメラ基準の固定軸で回す」（行列 Rz·Ry·Rx = Euler 順 "ZYX"）