akari-video 1.0.2 → 1.1.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.0.2",
+  "version": "1.1.0-beta.1",
   "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/self-update.mjs

@@ -4,7 +4,8 @@ import { spawnSync } from 'node:child_process';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { resolveAkariHome } from './update-check.mjs';
+import { readUpdateChannel, resolveAkariHome } from './update-check.mjs';
+import { compareVersions } from './version.mjs';
 
 /**
  * `akari update` の実適用（update-and-versioning 契約（内部リポ）§11）:
@@ -202,6 +203,15 @@ export async function stageSelfUpdate({
   }
 
   const version = feed.product;
+  if (readUpdateChannel(env) === 'stable' && version?.includes('-')) {
+    log('安定版だけを受け取る設定です。');
+    return { ok: false, reason: 'channel-mismatch' };
+  }
+  const installedVersion = readVersionAt(resolveAppDir(env));
+  if (installedVersion && compareVersions(version, installedVersion) < 0) {
+    log('現在より古い版は適用できません。');
+    return { ok: false, reason: 'older-version' };
+  }
   const stagingRoot = resolveStagingRoot(env);
   const stagingDir = resolveStagingDir(env, version);
   const downloadPath = join(stagingRoot, `.download-${version}.tar.gz`);

package/src/update-check.mjs

@@ -5,6 +5,8 @@ import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { isRunningFromAppDir, resolveStagingDir, stageSelfUpdate, swapStagedApp } from './self-update.mjs';
+import { compareVersions } from './version.mjs';
+export { compareVersions } from './version.mjs';
 
 /**
  * CLI（と、同じ契約に従うシェル）の更新検知・通知の共通ロジック
@@ -35,6 +37,7 @@ import { isRunningFromAppDir, resolveStagingDir, stageSelfUpdate, swapStagedApp
  */
 
 export const DEFAULT_UPDATE_FEED_URL = 'https://github.com/AkariLabs/akari-video/releases/download/updates/latest.json';
+export const PRERELEASE_UPDATE_FEED_URL = 'https://github.com/AkariLabs/akari-video/releases/download/updates/prerelease.json';
 
 const CACHE_SCHEMA = 1;
 const FETCH_TIMEOUT_MS = 5000;
@@ -42,8 +45,18 @@ const FETCH_TIMEOUT_MS = 5000;
 const THIS_FILE = fileURLToPath(import.meta.url);
 const PACKAGE_ROOT = dirname(dirname(THIS_FILE));
 
-export function resolveFeedUrl(env = process.env) {
-  return env.AKARI_UPDATE_FEED_URL || DEFAULT_UPDATE_FEED_URL;
+export function resolveUpdateChannel(value) {
+  return value === 'prerelease' ? 'prerelease' : 'stable';
+}
+
+export function readUpdateChannel(env = process.env) {
+  try { return resolveUpdateChannel(JSON.parse(readFileSync(join(resolveAkariHome(env), 'update-preferences.json'), 'utf8')).channel); }
+  catch { return 'stable'; }
+}
+
+// 明示 URL はテスト・運用の完全上書き。チャンネルは評価側でも独立に検査する。
+export function resolveFeedUrl(env = process.env, channel = readUpdateChannel(env)) {
+  return env.AKARI_UPDATE_FEED_URL || (channel === 'prerelease' ? PRERELEASE_UPDATE_FEED_URL : DEFAULT_UPDATE_FEED_URL);
 }
 
 /** `~/.akari`（既定）または `AKARI_HOME`（テスト用にルートを差し替え可能）。 */
@@ -112,26 +125,6 @@ export function resolveInstalledVersionInfo({ env = process.env, cliVersion = re
   };
 }
 
-/** "major.minor.patch" の先頭 3 要素だけを数値比較する（prerelease 考慮不要 — 契約 D4: stable のみ）。 */
-export function compareVersions(a, b) {
-  const pa = parseVersionTriplet(a);
-  const pb = parseVersionTriplet(b);
-  if (!pa || !pb) {
-    return 0;
-  }
-  for (let i = 0; i < 3; i++) {
-    if (pa[i] !== pb[i]) {
-      return pa[i] < pb[i] ? -1 : 1;
-    }
-  }
-  return 0;
-}
-
-function parseVersionTriplet(value) {
-  const match = typeof value === 'string' ? value.trim().match(/^(\d+)\.(\d+)\.(\d+)/) : null;
-  return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
-}
-
 /** `cache.feed` が最低限の形をしているか（壊れたフィードを弾く）。 */
 export function isValidFeedShape(feed) {
   return !!feed && typeof feed === 'object' && typeof feed.schema === 'number' && typeof feed.product === 'string';
@@ -141,7 +134,13 @@ export function isValidFeedShape(feed) {
 export function readCacheSync(cachePath) {
   try {
     const parsed = JSON.parse(readFileSync(cachePath, 'utf8'));
-    return parsed && typeof parsed === 'object' ? parsed : null;
+    if (!parsed || typeof parsed !== 'object') return null;
+    // cli.mjs もこの関数でキャッシュを読む。設定切替直後の手動 update を含めて遮断。
+    let channel = 'stable';
+    try { channel = resolveUpdateChannel(JSON.parse(readFileSync(join(dirname(cachePath), 'update-preferences.json'), 'utf8')).channel); }
+    catch { /* 未設定は stable */ }
+    return channel === 'stable' && parsed.feed?.product?.includes('-')
+      ? { ...parsed, feed: null, staged: undefined } : parsed;
   } catch {
     return null;
   }
@@ -155,7 +154,7 @@ function writeCacheSync(cachePath, cache) {
 /**
  * キャッシュと現在版から、新版通知を出すべきかを判定する（同期・純粋関数・I/O なし）。
  */
-export function evaluateUpdateStatus({ currentVersion, cache, cliVersion = currentVersion, appVersion = null, source = 'cli-fallback', installRefStatus, installRefPath, installRefNeedsRepair, managedApp, mismatch = false }) {
+export function evaluateUpdateStatus({ currentVersion, cache, channel = 'stable', feedUrl, cliVersion = currentVersion, appVersion = null, source = 'cli-fallback', installRefStatus, installRefPath, installRefNeedsRepair, managedApp, mismatch = false }) {
   const versionDetails = {
     currentVersion,
     cliVersion,
@@ -168,7 +167,8 @@ export function evaluateUpdateStatus({ currentVersion, cache, cliVersion = curre
     mismatch
   };
   const feed = cache?.feed;
-  if (!isValidFeedShape(feed)) {
+  if (!isValidFeedShape(feed) || (channel === 'stable' && /-/.test(feed.product))
+      || (cache?.feed_url && feedUrl && cache.feed_url !== feedUrl)) {
     return { available: false, ...versionDetails };
   }
   const latest = feed.product;
@@ -200,7 +200,8 @@ export function checkForUpdateSync({ currentVersion, versionInfo, env = process.
     ?? (currentVersion === undefined
       ? resolveInstalledVersionInfo({ env })
       : { cliVersion: currentVersion, appVersion: null, currentVersion, source: 'cli-fallback', mismatch: false });
-  return evaluateUpdateStatus({ ...versions, currentVersion: currentVersion ?? versions.currentVersion, cache });
+  return evaluateUpdateStatus({ ...versions, currentVersion: currentVersion ?? versions.currentVersion, cache,
+    channel: readUpdateChannel(env), feedUrl: resolveFeedUrl(env) });
 }
 
 /** 「この版の通知を今後出さない」を記録する（同期・ローカル I/O のみ）。 */
@@ -234,7 +235,8 @@ export async function maybeStageInBackground({ env = process.env, feed, fetchImp
   if (!appComponent?.url || !appComponent?.sha256) {
     return null;
   }
-  if (compareVersions(feed.product, resolveInstalledVersionInfo({ env }).currentVersion) <= 0) {
+  if ((readUpdateChannel(env) === 'stable' && feed.product.includes('-'))
+      || compareVersions(feed.product, resolveInstalledVersionInfo({ env }).currentVersion) <= 0) {
     return null;
   }
   // npm 側 CLI と本体が分離していても、install-ref があれば管理対象の本体を更新できる。
@@ -262,7 +264,7 @@ export async function refreshUpdateFeed({ env = process.env, fetchImpl = globalT
       return;
     }
     const feed = await response.json();
-    if (!isValidFeedShape(feed)) {
+    if (!isValidFeedShape(feed) || (readUpdateChannel(env) === 'stable' && feed.product.includes('-'))) {
       return null;
     }
     const existing = readCacheSync(cachePath);
@@ -270,6 +272,7 @@ export async function refreshUpdateFeed({ env = process.env, fetchImpl = globalT
       schema: CACHE_SCHEMA,
       fetched_at: new Date().toISOString(),
       feed,
+      feed_url: feedUrl,
       dismissed: existing?.dismissed ?? {}
     };
     writeCacheSync(cachePath, next);
@@ -347,7 +350,9 @@ export function maybeApplyPendingUpdateOnLaunch({ env = process.env, log = () =>
   const cache = readCacheSync(cachePath);
   const staged = cache?.staged;
   const feed = cache?.feed;
-  if (!staged?.version || !isValidFeedShape(feed) || staged.version !== feed.product) {
+  if (!staged?.version || !isValidFeedShape(feed) || staged.version !== feed.product
+      || (readUpdateChannel(env) === 'stable' && feed.product.includes('-'))
+      || (cache.feed_url && cache.feed_url !== resolveFeedUrl(env))) {
     return { applied: false, reason: 'no-matching-staged-update' };
   }
 

package/src/version.mjs

@@ -0,0 +1,23 @@
+/** npm 依存ゼロの launcher 用 semver 比較。build metadata は順序に影響しない。 */
+export function compareVersions(a, b) {
+  const parse = value => {
+    const match = typeof value === 'string' ? value.trim().match(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/) : null;
+    if (!match) return null;
+    const pre = match[4]?.split('.') ?? null;
+    if (pre?.some(id => /^0\d+$/.test(id))) return null;
+    return { core: match.slice(1, 4).map(Number), pre };
+  };
+  const left = parse(a), right = parse(b);
+  if (!left || !right) return 0;
+  for (let i = 0; i < 3; i++) if (left.core[i] !== right.core[i]) return Math.sign(left.core[i] - right.core[i]);
+  if (!left.pre || !right.pre) return left.pre === right.pre ? 0 : left.pre ? -1 : 1;
+  for (let i = 0; i < Math.min(left.pre.length, right.pre.length); i++) {
+    const x = left.pre[i], y = right.pre[i];
+    if (x === y) continue;
+    const xn = /^\d+$/.test(x), yn = /^\d+$/.test(y);
+    if (xn && yn) return Math.sign(BigInt(x) > BigInt(y) ? 1 : -1);
+    if (xn !== yn) return xn ? -1 : 1;
+    return x < y ? -1 : 1;
+  }
+  return Math.sign(left.pre.length - right.pre.length);
+}

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

@@ -82,6 +82,7 @@
     "docs/contract-2026-10-02-fragment-font-subset-v0.md",
     "docs/contract-2026-10-02-textstyle-v1-rich.md",
     "docs/contract-2026-10-04-asset-tier-v1.md",
+    "docs/contract-2026-10-06-timeline-ripple-v0.md",
     "packages/akari-launcher/package.json",
     "packages/akari-launcher/README.md",
     "packages/akari-tools/package.json",

package/vendor/docs/contract-2026-09-02-audio-envelope-v1.md

@@ -89,3 +89,12 @@ schema と reader は型・範囲・時刻順を error にする。lint は実
 | 許容する差 | デコーダとサンプル境界 | デコーダとサンプル境界 |
 
 afftdn、loudnorm、true peak guard は最終マスターだけの責務であり、プレビューには実装しない。
+
+## 7. フェードの形
+
+音声アイテムは `fade_in_shape` / `fade_out_shape` を任意に持つ。省略時は `linear` とし、
+既存のフェード秒数、クランプ規則、フィルタ文字列を維持する。進行率 `p`（0〜1）に対する
+ゲイン係数は `linear` = `p`、`equal_power` = `sin(pπ/2)`、
+`s_curve` = `(1−cos(pπ))/2`、`slow` = `p²` とする。フェードアウトは時間方向を反転する。
+書き出しの `afade` 曲線は順に `tri`、`qsin`、`hsin`、`qua` を使う。
+プレビューではフェード区間を少なくとも 16 区間の折れ線で近似する。

package/vendor/docs/contract-2026-10-06-timeline-ripple-v0.md

@@ -0,0 +1,33 @@
+---
+lifecycle: implemented
+created: 2026-10-06
+updated: 2026-10-06
+---
+
+# タイムラインの範囲操作と詰めカーネル v0
+
+実装モジュールは `packages/edit-store/src/ripple.ts`。`cut-ranges.ts` はこのカーネルを呼び出す。edit.json v2 の時刻は整数フレーム。`tracks[]` の配列順は合成順として維持する。範囲編集関数は入力を変更せず `{ edit, changed, removedFrames?, blocked?, reason? }` を返す。`changed: false` では `reason` に操作不能の理由を入れる。`setTrackRippleMode` は新しい edit を直接返し、`findGapAt` と `editPoints` は読み取り値を返す。
+
+## トラックの札
+
+`tracks[]` に任意の `target` / `sync` 真偽値を保存する。`resolveTrackRippleMode(track)` は `target: true` を `cut`、`target: false, sync: true` を `shift`、`target: false` とそれ以外の組を `fixed` とする。両キー省略時は visual が `cut`、audio は 1 件以上の全アイテムが `role: "bgm"` なら `fixed`、それ以外は `cut`。`sync` だけ指定したときは true が `shift`、false が `fixed`。`setTrackRippleMode` は `cut = (true,true)`、`shift = (false,true)`、`fixed = (false,false)` を保存する。
+
+操作ごとの `modeOverride` は一時指定で、`lockedTrackIds` は常に固定として優先する。固定トラックは範囲操作で変えない。選択アイテムを明示して消す場合はそのトラックを削除対象とするが、ロック中なら操作全体を拒否する。
+
+| 関数 | 内容 |
+|---|---|
+| `splitAtFrame` | 再生ヘッドをまたぐ cut トラックの media / html / telop / filter / 独立音声を分割。`itemIds` または `trackIds` で絞れる。リンクした映像・音声は同時に分割する。リンク相手がロック行にある場合、または左右どちらかが `ceil(fps × 0.15)` フレーム未満なら、全体を拒否して `changed: false` と `reason: "リンク相手が固定中か、片側が最小尺未満です"` を返す。 |
+| `liftRange` | cut トラックの範囲内を取り除き、隙間を残す。 |
+| `extractRange` | cut トラックの範囲内を取り除き、後続を範囲長だけ前へ送る。shift トラックは中身を取り除かず、範囲終端以降に始まるアイテムだけを前へ送る。 |
+| `rippleDeleteItems` | 選択アイテムの区間を詰める。他トラックは中身を消さずに後続を送る。リンク相手も既定で対象とし、`oneSide` で片側だけにできる。離れた選択は右から処理する。 |
+| `findGapAt` / `closeGapAt` | 指定トラックでフレームを含む先頭またはアイテム間の隙間を見つけ、その長さだけ後続を送る。末尾の空きは対象外。 |
+| `rippleTrimToPlayhead` | 最も近い前後の編集点から再生ヘッドまでを `extractRange` する。編集点が無ければ理由を返す。 |
+| `editPoints` | cut トラックのアイテム端を昇順・重複なしで返す。 |
+| `compactTrackGaps` | cut の visual トラックにある media だけを配列順に詰める。`fromItemId` があればそのアイテムの後続だけを詰める。既定では anchor 付きアイテムを直接動かさない。 |
+| `applyCutRanges` | 素材秒で重なる media を選び、共通の区間除去部品で切除する。触った visual トラックの media だけを `at = 0` から配列順に詰める旧挙動を保つ。 |
+
+shift は前のアイテムの終端より前に入らない。必要な移動量を確保できなかったアイテムの id を `blocked` に返し、重なりを作らない。`anchor` を持つアイテムは shift で直接動かさない。cut トラックなら範囲内の削除対象にはなる。位置の再解決は `refreshItemAnchors` の責務とする。`applyCutRanges` は旧挙動を維持するため、`compactTrackGaps` に `includeAnchored: true` を渡して触ったトラックの media を詰める。
+
+分割片の `source.in/out` は、素材秒をアイテムのフレーム比率（speed 込み）で按分する。音声の `keyframes[].gain_db` と映像の数値キーフレームは境界点を両片に入れ、ローカルフレーム時刻へ振り分ける。境界値は区間の終点側キーの `easing` を `easingProgress` で評価する。文字列指定は全プロパティ、Record 指定はプロパティ別（例: `gain_db`、`opacity`、`transform.x`）に適用し、左片の新しい境界点にも終点側の easing を引き継ぐ。線形区間の全フレーム値は分割前と一致する。非線形区間は境界値を一致させるが、分割後の区間内部の曲線は近似になる。`fade_in` は左片、`fade_out` は右片だけに残し、ダッキングなど他の属性は両片へ複製する。リンク音声の右片は映像の右片へ `link` を付け替える。
+
+字幕本文は `captions.json` のソース秒が正本であり、ここでは変更しない。切除後の表示位置は `timeline-map` の `sourceToOutput` で追従する。通常の Delete は隙間を残す。詰める処理は明示した操作でだけ行う。

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

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.0.2",
+  "version": "1.1.0-beta.1",
   "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/place-library-asset.mjs

@@ -0,0 +1,54 @@
+import { realpath, stat } from 'node:fs/promises';
+import { basename, dirname, isAbsolute, join, relative, sep } from 'node:path';
+import { recordProjectReference } from './project-references.mjs';
+import { appendLibraryUsage } from './library-usage.mjs';
+import { ASSET_CATEGORIES } from './library.mjs';
+import { resolveAssetLibraryRoots } from '../../creator-root/src/index.mjs';
+
+const within = (root, target) => {
+  const rel = relative(root, target);
+  return rel === '' || (rel !== '..' && !rel.startsWith('..' + sep) && !isAbsolute(rel));
+};
+
+export async function placeLibraryAsset(source, projectPath, env = process.env) {
+  if (!source || !ASSET_CATEGORIES.includes(source.category)
+      || typeof source.id !== 'string' || !source.id || source.id === '.'
+      || source.id.includes('..') || source.id.includes('/') || source.id.includes(String.fromCharCode(92))
+      || typeof source.libraryDir !== 'string' || !isAbsolute(source.libraryDir)) {
+    throw new Error('素材の種類・名前・置き場が不正です');
+  }
+  const actual = await realpath(source.libraryDir);
+  if (basename(actual) !== source.id || basename(dirname(actual)) !== source.category
+      || !(await stat(actual)).isDirectory()) {
+    throw new Error('素材の置き場と種類・名前が一致しません');
+  }
+  let allowed = false;
+  for (const root of resolveAssetLibraryRoots(env).read) {
+    try { if (within(await realpath(root), actual)) allowed = true; }
+    catch (error) { if (error.code !== 'ENOENT') throw error; }
+  }
+  if (!allowed) throw new Error('素材がライブラリの置き場の外にあります');
+  const project = await realpath(projectPath);
+  if (!(await stat(project)).isDirectory()) throw new Error('プロジェクトがフォルダではありません');
+  const destination = join(project, 'assets', source.category, source.id);
+  let parent = dirname(destination);
+  let actualDestination;
+  while (true) {
+    try {
+      const actualParent = await realpath(parent);
+      if (!within(project, actualParent)) throw new Error('配置先がプロジェクトの外にあります');
+      actualDestination = join(actualParent, relative(parent, destination));
+      break;
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+      parent = dirname(parent);
+    }
+  }
+  if (within(actualDestination, actual) || within(actual, actualDestination)) {
+    throw new Error('素材の大元と重なる配置はできません');
+  }
+  await recordProjectReference(project, { category: source.category, id: source.id });
+  await appendLibraryUsage({ category: source.category, id: source.id, project });
+  return { success: true, projectAssetPath: join(projectPath, 'assets', source.category, source.id),
+    reference: true, libraryDir: actual };
+}

package/vendor/packages/asset-resolver/src/project-reference-listing.mjs

@@ -0,0 +1,22 @@
+import { readFile } from 'node:fs/promises';
+import { listProjectReferenceAssets } from './shell-reference.mjs';
+import { sourceFields } from './library.mjs';
+import { readCatalogCache } from './catalog.mjs';
+import { resolveCatalogSource } from './env.mjs';
+
+export async function listProjectAssetReferences(project, env = process.env) {
+  let catalog = await readCatalogCache(env);
+  const source = resolveCatalogSource(env);
+  if (source.kind === 'file') { try { catalog = JSON.parse(await readFile(source.value, 'utf8')); } catch {} }
+  const entries = await listProjectReferenceAssets(project, env);
+  for (const entry of entries) {
+    let meta;
+    try { meta = JSON.parse(await readFile(entry.files.find(file => file.name === 'meta.json').path, 'utf8')); } catch {}
+    entry.tags = Array.isArray(meta?.tags) ? meta.tags.filter(tag => typeof tag === 'string') : [];
+    const known = catalog?.items?.find(item => item.id === entry.id && item.category === entry.category);
+    entry.title = typeof meta?.title === 'string' ? meta.title : typeof known?.title === 'string' ? known.title : entry.id;
+    if (!meta && known) entry.tags = Array.isArray(known.tags) ? known.tags.filter(tag => typeof tag === 'string') : [];
+    if (meta || known) entry.sourceKind = sourceFields(meta ?? known, !!known).sourceKind;
+  }
+  return entries;
+}

package/vendor/packages/asset-resolver/src/project-references.mjs

@@ -1,6 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { lstatSync, realpathSync } from 'node:fs';
-import fsPromises, { mkdir, open, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import fsPromises, { lstat, realpath, mkdir, open, readFile, rm, stat, writeFile } from 'node:fs/promises';
 import { setTimeout as delay } from 'node:timers/promises';
 import path from 'node:path';
 
@@ -219,3 +219,26 @@ export function resolveLibraryFallback({ declaredPath, references, akariAssetsDi
     return null;
   }
 }
+
+export async function resolveLibraryFallbackAsync({ declaredPath, references, akariAssetsDir, rootRealpaths }) {
+  const parsed = parseDeclaredAssetPath(declaredPath);
+  if (!parsed || typeof akariAssetsDir !== 'string' || akariAssetsDir.length === 0) return null;
+  if (!normalizeReferences(references).some(
+    entry => entry.category === parsed.category && entry.id === parsed.id,
+  )) return null;
+  const lexicalRoot = path.resolve(akariAssetsDir);
+  const lexicalTarget = path.resolve(lexicalRoot, parsed.category, parsed.id, ...parsed.rest);
+  if (!isWithin(lexicalRoot, lexicalTarget)) return null;
+  try {
+    let actualRoot = rootRealpaths?.get(lexicalRoot);
+    if (!actualRoot) {
+      actualRoot = realpath(lexicalRoot);
+      rootRealpaths?.set(lexicalRoot, actualRoot);
+    }
+    const [root, target] = await Promise.all([actualRoot, realpath(lexicalTarget)]);
+    if (!isWithin(root, target) || !(await lstat(target)).isFile()) return null;
+    return target;
+  } catch {
+    return null;
+  }
+}

package/vendor/packages/asset-resolver/src/resolve-async-library.mjs

@@ -0,0 +1,113 @@
+import { readdir, stat, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveAssetLibraryRoots } from '../../creator-root/src/index.mjs';
+import { assetTier } from './tier.mjs';
+import { loadCatalog, readCatalogCache } from './catalog.mjs';
+import { mergeInstalledItems, INSTALLED_ASSETS_SCHEMA } from './installed.mjs';
+import { resolveCatalogSource } from './env.mjs';
+
+export async function cachedAssetDirAsync(env, category, id) {
+  for (const root of resolveAssetLibraryRoots(env).read) {
+    const dir = path.resolve(root, category, id);
+    try {
+      if ((await stat(dir)).isDirectory() && (await readdir(dir)).length) return dir;
+    } catch { /* next root */ }
+  }
+  return null;
+}
+
+const safe = value => typeof value === 'string' && value.length > 0
+  && value !== '.' && value !== '..' && !/[\\/]/.test(value);
+
+function within(root, ...parts) {
+  const base = path.resolve(root);
+  const candidate = path.resolve(base, ...parts);
+  if (candidate !== base && !candidate.startsWith(`${base}${path.sep}`)) {
+    throw new Error(`導入済み素材のパスがパック外を指しています: ${parts.join('/')}`);
+  }
+  return candidate;
+}
+
+async function installedItemsAsync(env) {
+  const roots = resolveAssetLibraryRoots(env).read;
+  const byId = new Map();
+  for (const libraryRoot of [...roots].reverse()) {
+    const indexPath = path.join(libraryRoot, 'installed.json');
+    let index;
+    try { index = JSON.parse(await readFile(indexPath, 'utf8')); }
+    catch (error) {
+      if (error?.code === 'ENOENT') continue;
+      throw new Error(`導入済み素材索引を読めません: ${indexPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (index?.schema !== INSTALLED_ASSETS_SCHEMA
+        || !index.packs || typeof index.packs !== 'object' || Array.isArray(index.packs)) {
+      throw new Error(`導入済み素材索引の形式が想定と違います: ${indexPath}`);
+    }
+    for (const [packId, pack] of Object.entries(index.packs)) {
+      if (!safe(packId) || !pack || typeof pack.root !== 'string' || !path.isAbsolute(pack.root)
+          || (typeof pack.version !== 'string' && typeof pack.version !== 'number')
+          || typeof pack.installedAt !== 'string' || !pack.installedAt || !Array.isArray(pack.items)) {
+        throw new Error(`導入済み素材索引に不正な pack があります: ${packId}`);
+      }
+      const originalRoot = roots.find(root => {
+        try { within(path.join(root, 'store', packId), pack.root); return true; } catch { return false; }
+      });
+      if (!originalRoot) throw new Error(`導入済み素材の root がパック外を指しています: ${pack.root}`);
+      const relativeRoot = path.relative(originalRoot, pack.root);
+      const readRoots = roots.map(root => path.join(root, relativeRoot));
+      for (const item of pack.items) {
+        if (!item || !safe(item.id) || typeof item.title !== 'string' || !item.title
+            || typeof item.path !== 'string' || !item.path || item.version == null) {
+          throw new Error(`導入済み素材索引に不正な item があります: ${packId}`);
+        }
+        if (!Array.isArray(item.files) || item.files.length === 0) {
+          throw new Error(`導入済み素材索引の item に files[] がありません: ${item.id}`);
+        }
+        const itemRoots = readRoots.map(root => within(root, item.path));
+        let metaTier;
+        for (const root of itemRoots) {
+          try {
+            const meta = JSON.parse(await readFile(path.join(root, 'meta.json'), 'utf8'));
+            if (Object.hasOwn(meta, 'tier') || Object.hasOwn(meta, 'price')) metaTier = assetTier(meta);
+            break;
+          } catch (error) { if (error?.code !== 'ENOENT') break; }
+        }
+        const categoryParts = item.path.replaceAll('\\', '/').split('/').filter(Boolean);
+        const category = categoryParts[0] === 'assets' && safe(categoryParts[1]) ? categoryParts[1] : 'pack';
+        const files = await Promise.all(item.files.map(async file => {
+          if (!file || typeof file.path !== 'string' || !file.path
+              || !Number.isInteger(file.bytes) || file.bytes < 0
+              || typeof file.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(file.sha256)) {
+            throw new Error(`導入済み素材索引の files[] が不正です: ${item.id}`);
+          }
+          const candidates = itemRoots.map(root => within(root, file.path));
+          let localPath = candidates[0];
+          for (const candidate of candidates) {
+            if (await stat(candidate).then(() => true, () => false)) { localPath = candidate; break; }
+          }
+          return { name: file.path, local_path: localPath, sha256: file.sha256, bytes: file.bytes };
+        }));
+        byId.set(item.id, { id: item.id, title: item.title, category, version: item.version,
+          price: 0, ...((Object.hasOwn(item, 'tier') ? assetTier(item) : metaTier)
+            ? { tier: Object.hasOwn(item, 'tier') ? assetTier(item) : metaTier } : {}),
+          source: 'installed', files });
+      }
+    }
+  }
+  return [...byId.values()];
+}
+
+export async function loadCatalogForResolveAsync(ref, { env = process.env, fetchImpl = fetch, timeouts } = {}) {
+  const matches = typeof ref === 'string' && ref.includes('/')
+    ? item => `${item.category}/${item.id}` === ref : item => item.id === ref;
+  const installedItems = await installedItemsAsync(env);
+  if (installedItems.some(matches)) {
+    return { schema: 'akari-assets-catalog/v0', version: null, base: null, items: installedItems };
+  }
+  if (resolveCatalogSource(env).kind === 'url') {
+    const cached = await readCatalogCache(env);
+    if (cached && cached.items.some(matches)) return mergeInstalledItems(cached, installedItems);
+  }
+  const catalog = await loadCatalog({ env, fetchImpl, timeouts, fallbackToCache: false, includeInstalled: false });
+  return mergeInstalledItems(catalog, installedItems);
+}

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

@@ -11,19 +11,18 @@ import { resolveAssetLibraryRoots } from '../../creator-root/src/index.mjs';
 // なら resolvePaidZip() が `/api/store/v1/download/<id>` から zip を取得し、展開 →
 // checksums.txt 検証（paid-zip.mjs）→ 同じ validate-asset / 原子的 move の経路に合流する。
 
-import { spawnSync } from 'node:child_process';
-import { constants, existsSync, realpathSync } from 'node:fs';
-import { cp, mkdir, mkdtemp, rename, rm } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { constants } from 'node:fs';
+import { cp, mkdir, mkdtemp, readFile, rename, rm, realpath, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { format } from 'node:util';
-import { loadCatalogForResolve } from './catalog.mjs';
+import { loadCatalogForResolveAsync, cachedAssetDirAsync } from './resolve-async-library.mjs';
 import { resolveEffectiveBase } from './env.mjs';
 import { AssetResolverError } from './errors.mjs';
 import { fetchEntitlements, readStoreCredentials } from './entitlements.mjs';
 import { materialize, resolveFileLocation } from './fetch-file.mjs';
 import { sha256File } from './hash.mjs';
-import { cachedAssetDir, localAssetDir } from './library.mjs';
 import { downloadPaidZip, extractZip, verifyPaidZipContents } from './paid-zip.mjs';
 import { recordProjectReference } from './project-references.mjs';
 import { assetTier, isAssetEntitled } from './tier.mjs';
@@ -81,7 +80,15 @@ async function validateAsset(assetDir) {
     return await run;
   } catch {
     // Module loading failures are outside the validator's ordinary NG result.
-    return spawnSync(process.execPath, [VALIDATE_ASSET_SCRIPT, assetDir], { encoding: 'utf8' });
+    return new Promise((resolveResult, reject) => {
+      const child = spawn(process.execPath, [VALIDATE_ASSET_SCRIPT, assetDir]);
+      let stdout = '';
+      let stderr = '';
+      child.stdout.on('data', chunk => { stdout += chunk; });
+      child.stderr.on('data', chunk => { stderr += chunk; });
+      child.on('error', reject);
+      child.on('close', status => resolveResult({ status, stdout, stderr }));
+    });
   }
 }
 
@@ -110,7 +117,7 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
   // 素材箱側が「meta.json を含むディレクトリ = 1 カード」でグルーピングする際、
   // 深さではなくディレクトリ形で判定するため、置き場の形をライブラリと合わせておく必要はないが、
   // カテゴリ別に整理された配置の方が人間が見ても分かりやすいのでライブラリ型に統一する。
-  const realSourceDir = realpathSync(sourceDir);
+  const realSourceDir = await realpath(sourceDir);
   const dest = path.join(path.resolve(projectDir), 'assets', category, id);
   await mkdir(path.dirname(dest), { recursive: true });
   await rm(dest, { recursive: true, force: true });
@@ -119,8 +126,12 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
     // このマシンの Node（libuv）は clonefileat 相当が ENOSYS を返し、fs.cp の
     // COPYFILE_FICLONE では節約が効かない（前段 2026-08-09-project-copy-cow-clone で実測確認済み）。
     // BSD cp -c は clonefile(2) を Node を介さず直接使うため、同じ OS/FS 上で実際にクローンできる。
-    const clone = spawnSync('/bin/cp', ['-Rc', realSourceDir, dest], { stdio: 'ignore' });
-    if (!clone.error && clone.status === 0) {
+    const cloned = await new Promise(resolveResult => {
+      const child = spawn('/bin/cp', ['-Rc', realSourceDir, dest], { stdio: 'ignore' });
+      child.on('error', () => resolveResult(false));
+      child.on('close', code => resolveResult(code === 0));
+    });
+    if (cloned) {
       return dest;
     }
     // クロスボリューム等で -c が失敗したケース。部分的に書かれた dest を掃除してから
@@ -136,7 +147,7 @@ export async function copyIntoProject(sourceDir, projectDir, category, id) {
 
 async function moveIntoLibrary(tempDir, destDir) {
   await mkdir(path.dirname(destDir), { recursive: true });
-  if (existsSync(destDir)) {
+  if (await stat(destDir).then(() => true, error => { if (error.code === 'ENOENT') return false; throw error; })) {
     await rm(destDir, { recursive: true, force: true });
   }
   try {
@@ -152,6 +163,19 @@ async function moveIntoLibrary(tempDir, destDir) {
   }
 }
 
+async function backfillLegacyMetaTier(metaPath, item) {
+  let meta;
+  try {
+    meta = JSON.parse(await readFile(metaPath, 'utf8'));
+  } catch {
+    return;
+  }
+  if (!meta || typeof meta !== 'object' || Array.isArray(meta) || Object.hasOwn(meta, 'tier')) return;
+  // R2 に公開済みの旧 meta.json（tier 導入前・price のみ）を、sha256 検証済みのうえでカタログの tier で補う互換経路。R2 の meta.json を tier 付きで上げ直したら外せる。
+  meta.tier = assetTier(item);
+  await writeFile(metaPath, `${JSON.stringify(meta, null, 2)}\n`);
+}
+
 /**
  * @param {string} ref カタログの category/id。bare id は一意な場合のみ互換解決する
  * @param {{ env?: object, fetchImpl?: Function, project?: string|null, force?: boolean, reference?: boolean }} options
@@ -161,16 +185,16 @@ export async function resolve(
   { env = process.env, fetchImpl = fetch, project = null, force = false, reference = false, timeouts } = {},
 ) {
   const home = resolveAssetLibraryRoots(env).write;
-  const catalog = await loadCatalogForResolve(ref, { env, fetchImpl, timeouts });
+  const catalog = await loadCatalogForResolveAsync(ref, { env, fetchImpl, timeouts });
   const item = findCatalogItem(catalog, ref);
 
   const tier = assetTier(item);
   const hasFiles = Array.isArray(item.files) && item.files.length > 0;
-  const destDir = localAssetDir(env, item.category, item.id);
+  const destDir = path.join(home, item.category, item.id);
 
   // キャッシュヒット → 即返す（未購入だったとしても、一度取得済みなら手元にある実体をそのまま使う。
   // ゲートは「新規に取得するとき」だけにかける）
-  const cachedDir = cachedAssetDir(env, item.category, item.id);
+  const cachedDir = await cachedAssetDirAsync(env, item.category, item.id);
   if (!force && cachedDir) {
     const result = { id: item.id, category: item.category, dir: cachedDir, cached: true };
     if (project && reference) {
@@ -244,6 +268,7 @@ export async function resolve(
 
     // still / scene3d 等、meta.json を実体に持つ素材は validate-asset で契約検証してから登録する
     if (hasMeta) {
+      await backfillLegacyMetaTier(path.join(tempAssetDir, 'meta.json'), item);
       const result = await validateAsset(tempAssetDir);
       if (result.status !== 0) {
         const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim();
@@ -327,6 +352,8 @@ async function resolvePaidZip(item, { env, fetchImpl, project, reference, home,
       });
     }
 
+    await backfillLegacyMetaTier(path.join(tempAssetDir, 'meta.json'), item);
+
     {
       const result = await validateAsset(tempAssetDir);
       if (result.status !== 0) {