akari-video 0.1.4 → 0.1.6

package/README.md

@@ -32,6 +32,9 @@ akari
 ```
 
 サブコマンド: `akari update`（更新確認）/ `akari init`（作業場の作成・確認のみ）/
+`akari new <target-dir> [--template <path>]`（新規プロジェクト作成）/
+`akari narration generate ...`（VOICEVOX / fal-qwen3 ナレーション生成）/
+`akari internal beat-sync-<beatmap|probe-frame|render-when-idle> ...`（beat-sync-edit 内部実行物）/
 `akari sounds [--variant wav] [--force]`（公式音源の一括ダウンロード。プロンプトなし・headless 可）/
 `akari store <connect|status|download|disconnect>`（AKARI Store 連携。マイページで発行した
 接続トークンを `~/.akari/store-credentials.json`（0600）に保存し、購入済み一覧の確認と
@@ -67,7 +70,7 @@ AKARI Video は「同じファイル契約（`.akari/` 配下の JSON）に収
 | アプリ | 接続ボタン（AKARI Video アプリ） | アプリの「はじめる」画面から接続 → はじめかた選択 |
 
 3 つとも最終的に同じもの（`.akari/connections.json` / `.akari/intake.json` /
-`skills/create-project`）を読み書きするため、どの入口から始めても続きは他の入口から
+`akari new` が使う共通 project-scaffold）を読み書きするため、どの入口から始めても続きは他の入口から
 再開できる。
 
 ## インストール

package/bin/akari.mjs

@@ -1,25 +1,34 @@
 #!/usr/bin/env node
 import { run, runUpdateCommand } from '../src/cli.mjs';
 import { runInitCommand } from '../src/init-command.mjs';
+import { runNewCommand } from '../src/new-command.mjs';
+import { runNarrationCommand } from '../src/narration-command.mjs';
+import { runInternalCommand } from '../src/internal-command.mjs';
 import { runSoundsCommand } from '../src/sounds-setup.mjs';
 import { runStatusCommand } from '../src/status-command.mjs';
 import { runAcceptCommand } from '../src/accept-command.mjs';
 import { runCapabilityCommand } from '../src/capability-command.mjs';
 import { runStoreCommand } from '../src/store-command.mjs';
+import { runAssetsCommand } from '../src/assets-command.mjs';
 
 const argv = process.argv.slice(2);
-// `akari update` / `akari init` / `akari sounds` / `akari status` / `akari accept` /
-// `akari capability` / `akari store` は claude へ転送せず、
-// 専用のサブコマンドとして扱う（契約 §4-1 / タスク契約 launcher-init（内部リポ）/
-// 音源カタログ既定化のオーナー裁定 2026-08-03 / AKARI Store 連携）。
+// `akari update` / `akari init` / `akari new` / `akari narration` / `akari internal` /
+// `akari sounds` / `akari status` / `akari accept` / `akari capability` / `akari store` /
+// `akari assets` は claude へ転送せず、専用のサブコマンドとして扱う（契約 §4-1 /
+// タスク契約 launcher-init（内部リポ）/ 音源カタログ既定化のオーナー裁定 2026-08-03 /
+// AKARI Store 連携 / タスク契約 2026-08-09-agent-assets-discovery）。
 // それ以外の引数はすべて従来どおり claude へ転送する。
 const invoke = argv[0] === 'update' ? runUpdateCommand(argv.slice(1))
   : argv[0] === 'init' ? runInitCommand(argv.slice(1))
+  : argv[0] === 'new' ? runNewCommand(argv.slice(1))
+  : argv[0] === 'narration' ? runNarrationCommand(argv.slice(1))
+  : argv[0] === 'internal' ? runInternalCommand(argv.slice(1))
   : argv[0] === 'sounds' ? runSoundsCommand(argv.slice(1))
   : argv[0] === 'status' ? runStatusCommand(argv.slice(1))
   : argv[0] === 'accept' ? runAcceptCommand(argv.slice(1))
   : argv[0] === 'capability' ? runCapabilityCommand(argv.slice(1))
   : argv[0] === 'store' ? runStoreCommand(argv.slice(1))
+  : argv[0] === 'assets' ? runAssetsCommand(argv.slice(1))
   : run(argv);
 
 const result = await invoke.catch((error) => {

package/package.json

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

@@ -0,0 +1,42 @@
+import { spawnSync } from 'node:child_process';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+import { assetsResolverUnavailableError } from './messages.mjs';
+
+/**
+ * `akari assets <list|fetch|sync|...>` — `packages/asset-resolver` の CLI
+ * （`bin/akari-assets.mjs`）への薄い委譲（タスク契約 2026-08-09-agent-assets-discovery）。
+ *
+ * カタログ合成・entitlements 判定・取得・sha256 検証・validate-asset・fail-closed の実ロジックは
+ * すべて resolver 側の責務のまま変更しない。認証（`~/.akari/store-credentials.json`）も
+ * resolver がそのまま読む。ここでは引数をそのまま子プロセスへ転送し、resolver 側の usage /
+ * エラー文言 / exit code をそのまま利用者に返すだけ。
+ *
+ * 規約は他の launcher 委譲コマンド（`akari sounds` = sounds-setup.mjs）と同じ:
+ *   - 同梱の実体解決は `resolveLauncherAssets()`（モノレポ checkout → npm 配布時の vendor/）
+ *   - 副作用（spawn）は options で注入可能・node --test で実プロセス不要
+ */
+
+function defaultSpawnAssetsCli(cliPath, args, env) {
+  // stdio: inherit — list の一覧表示・fetch の進捗ログ・JSON 出力をそのまま利用者に見せる
+  // （sounds-setup.mjs の defaultSpawnFetch と同じ流儀）。env を明示的に渡すのは必須 —
+  // 注入された AKARI_HOME（テスト・隔離実行）が resolver 側の解決にも効くようにする。
+  return spawnSync(process.execPath, [cliPath, ...args], { stdio: 'inherit', env });
+}
+
+export async function runAssetsCommand(args, options = {}) {
+  const logError = options.logError ?? ((line) => console.error(line));
+  const env = options.env ?? process.env;
+  const assets = options.assets ?? resolveLauncherAssets();
+
+  const cliPath = assets?.assetResolverCliPath;
+  if (!cliPath) {
+    logError(assetsResolverUnavailableError());
+    return { exitCode: 1 };
+  }
+
+  const spawnAssetsCli = options.spawnAssetsCli ?? defaultSpawnAssetsCli;
+  const result = spawnAssetsCli(cliPath, args, env);
+  const exitCode = typeof result.status === 'number' ? result.status : (result.error ? 1 : 0);
+  return { exitCode };
+}

package/src/internal-command.mjs

@@ -0,0 +1,52 @@
+import { spawnSync } from 'node:child_process';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+
+const commands = [
+  'beat-sync-beatmap',
+  'beat-sync-probe-frame',
+  'beat-sync-render-when-idle'
+];
+
+const usage = [
+  '使い方: akari internal <subcommand> [args...]',
+  '',
+  'サブコマンド:',
+  ...commands.map((command) => `  ${command}`)
+].join('\n');
+
+export async function runInternalCommand(args, options = {}) {
+  const log = options.log ?? ((line) => console.log(line));
+  const logError = options.logError ?? ((line) => console.error(line));
+  const assets = options.assets ?? resolveLauncherAssets();
+  const spawn = options.spawn ?? spawnSync;
+  const subcommand = args[0];
+
+  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
+    log(usage);
+    return { exitCode: 0 };
+  }
+
+  const definitions = {
+    'beat-sync-beatmap': { path: assets.beatmapScript, node: true },
+    'beat-sync-probe-frame': { path: assets.probeFrameScript, node: true },
+    'beat-sync-render-when-idle': { path: assets.renderWhenIdleScript, node: false }
+  };
+  const definition = definitions[subcommand];
+  if (!definition) {
+    logError(`不明な internal サブコマンドです: ${subcommand}`);
+    log(usage);
+    return { exitCode: 1 };
+  }
+  if (!definition.path) {
+    logError(`内部コマンド ${subcommand} の実行スクリプトが見つかりません。AKARI Video の完全な checkout または配布物を確認してください。`);
+    return { exitCode: 1 };
+  }
+
+  const forwardedArgs = args.slice(1);
+  const result = definition.node
+    ? spawn(process.execPath, [definition.path, ...forwardedArgs], { stdio: 'inherit' })
+    : spawn(definition.path, forwardedArgs, { stdio: 'inherit' });
+  const exitCode = typeof result?.status === 'number' ? result.status : 1;
+  return { exitCode };
+}

package/src/messages.mjs

@@ -48,7 +48,7 @@ export function claudeMissingGuidance() {
 export function opencodeMissingGuidance() {
   return [
     'opencode コマンドが見つかりませんでした。',
-    'opencode をインストールしてください: npm install -g opencode',
+    'opencode をインストールしてください: npm install -g opencode-ai',
     'インストール後、このフォルダーで再度 `akari --opencode` を実行してください。'
   ].join('\n');
 }
@@ -191,3 +191,8 @@ export function soundsFailedNotice() {
 export function soundsUnavailableError() {
   return '音源セットアップスクリプト（audio-library-setup）が見つかりませんでした。';
 }
+
+/** `akari assets`: 素材 resolver（asset-resolver）が同梱されていない場合のエラー（stderr 1 行）。 */
+export function assetsResolverUnavailableError() {
+  return '素材 resolver（asset-resolver）が見つかりませんでした。`akari assets` は使えません。';
+}

package/{vendor/skills/generate-narration/bin/generate-narration.mjs → src/narration-command.mjs}

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 // 原稿テキストから VOICEVOX（ローカル）または fal Qwen3-TTS（自声クローン）でナレーション音声を
 // 生成し、docs/contract-2026-07-20-edit-json-v1-narration.md 準拠のエントリを組み立てる。
 
@@ -17,12 +15,20 @@ const FAL_USD_PER_1000_CHARS = 0.09;
 
 const usage = [
   "使い方:",
-  "  node generate-narration.mjs generate \\",
+  "  akari narration generate \\",
   "    --project <projectDir> --engine <voicevox|fal-qwen3> \\",
   "    --reading-file <読み原稿.txt> [--script-file <表示原稿.txt>] \\",
   "    --t <タイムライン秒> [--gain-db 0] [--id n-0001] \\",
   "    [--speaker 3] [--profile owner-ja] [--dry-run] [--yes] [--apply]",
 ].join("\n");
+const commandUsage = [
+  "使い方: akari narration <subcommand> [options]",
+  "",
+  "サブコマンド:",
+  "  generate  原稿からナレーション音声を生成する",
+  "",
+  usage,
+].join("\n");
 
 class PublicError extends Error {
   constructor(message, exitCode = 1) {
@@ -31,8 +37,8 @@ class PublicError extends Error {
   }
 }
 
-function printJson(value) {
-  process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+function printJson(value, log = (line) => console.log(line)) {
+  log(JSON.stringify(value, null, 2));
 }
 
 function sleep(ms) {
@@ -390,10 +396,10 @@ async function synthesizeVoicevox(readingText, speakerId) {
 // --- edit.json への --apply ---
 
 function validateEditScriptPath() {
-  return fileURLToPath(new URL("../../../packages/schemas/bin/validate-edit.mjs", import.meta.url));
+  return fileURLToPath(new URL("../../schemas/bin/validate-edit.mjs", import.meta.url));
 }
 
-function applyToEditJson(projectDir, entry) {
+function applyToEditJson(projectDir, entry, io) {
   const editPath = path.join(projectDir, "edit.json");
   let originalText;
   try {
@@ -422,7 +428,7 @@ function applyToEditJson(projectDir, entry) {
       `validate-edit が NG のため edit.json への書き込みをロールバックしました。\n${detail}`,
     );
   }
-  process.stderr.write(`edit.json に ${entry.id} を追加しました（validate-edit: PASS）。\n`);
+  io.logError(`edit.json に ${entry.id} を追加しました（validate-edit: PASS）。`);
 }
 
 // --- dry-run ---
@@ -432,7 +438,7 @@ function maskKey(secret) {
   return secret ? "***configured***" : "***unconfigured***";
 }
 
-async function runDryRun(options, readingText) {
+async function runDryRun(options, readingText, io) {
   const outputPath = relativeOutputPath(options.id ?? computeNextId(options.project), options.engine);
   if (options.engine === "voicevox") {
     printJson({
@@ -449,7 +455,7 @@ async function runDryRun(options, readingText) {
         speaker: Number(options.speaker),
         text: readingText,
       },
-    });
+    }, io.log);
     return;
   }
 
@@ -467,18 +473,18 @@ async function runDryRun(options, readingText) {
       headers: { Authorization: `Key ${maskKey(falKey)}` },
       body: payload,
     },
-  });
+  }, io.log);
 }
 
 // --- generate 本体 ---
 
-async function runGenerate(options) {
+async function runGenerate(options, io) {
   const readingText = readTextFile(options.readingFile, "読み原稿");
   const scriptText = options.scriptFile ? readTextFile(options.scriptFile, "表示原稿") : null;
 
   if (options.dryRun) {
-    await runDryRun(options, readingText);
-    return;
+    await runDryRun(options, readingText, io);
+    return 0;
   }
 
   const id = options.id ?? computeNextId(options.project);
@@ -514,18 +520,15 @@ async function runGenerate(options) {
     const falKey = resolveFalKey();
     const meta = readProfileMeta(options.profile);
     const estimatedCostUsd = estimateFalCostUsd(readingText);
-    process.stderr.write(
-      `fal-qwen3 推定費用: 約 $${estimatedCostUsd}（${readingText.length} 文字 × $${FAL_USD_PER_1000_CHARS}/1000字）\n`,
-    );
+    io.logError(`fal-qwen3 推定費用: 約 $${estimatedCostUsd}（${readingText.length} 文字 × $${FAL_USD_PER_1000_CHARS}/1000字）`);
     if (!options.yes) {
       printJson({
         sent: false,
         engine: "fal-qwen3",
         estimated_cost_usd: estimatedCostUsd,
         reason: "費用承認（--yes）がありません。実リクエストは送信していません。",
-      });
-      process.exitCode = 2;
-      return;
+      }, io.log);
+      return 2;
     }
     // --yes が明示された場合のみ、ここで初めて課金の発生する fal API を呼び出す。
     audioBuffer = await synthesizeFal(readingText, meta, falKey);
@@ -550,23 +553,37 @@ async function runGenerate(options) {
     provenance,
   };
 
-  if (options.apply) applyToEditJson(options.project, entry);
+  if (options.apply) applyToEditJson(options.project, entry, io);
 
-  printJson(entry);
+  printJson(entry, io.log);
+  return 0;
 }
 
-async function main() {
-  let options;
+export async function runNarrationCommand(args, commandOptions = {}) {
+  const io = {
+    log: commandOptions.log ?? ((line) => console.log(line)),
+    logError: commandOptions.logError ?? ((line) => console.error(line)),
+  };
+
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    io.log(commandUsage);
+    return { exitCode: 0 };
+  }
+  if (args[0] === 'generate' && (args.includes('--help') || args.includes('-h'))) {
+    io.log(usage);
+    return { exitCode: 0 };
+  }
+
+  let parsedOptions;
   try {
-    options = parseArguments(process.argv.slice(2));
-    await runGenerate(options);
+    parsedOptions = parseArguments(args);
+    const exitCode = await runGenerate(parsedOptions, io);
+    return { exitCode };
   } catch (error) {
     const exitCode = error instanceof PublicError ? error.exitCode : 1;
     const message = error instanceof PublicError ? error.message : `内部処理に失敗しました: ${error?.message ?? error}`;
-    process.stderr.write(`${message}\n`);
-    printJson({ error: message });
-    process.exitCode = exitCode;
+    io.logError(message);
+    printJson({ error: message }, io.log);
+    return { exitCode };
   }
 }
-
-await main();

package/src/new-command.mjs

@@ -0,0 +1,119 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+
+const usage = '使い方: akari new <target-dir> [--template <path>]';
+
+function parseArguments(args) {
+    let target;
+    let template;
+
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === '--template') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new Error(`${usage}\n--template にはパスが必要です。`);
+            }
+            template = value;
+            index += 1;
+        } else if (argument.startsWith('-')) {
+            throw new Error(`${usage}\n不明なオプションです: ${argument}`);
+        } else if (target === undefined) {
+            target = argument;
+        } else {
+            throw new Error(`${usage}\n作成先は 1 つだけ指定してください。`);
+        }
+    }
+
+    if (target === undefined) {
+        throw new Error(usage);
+    }
+    return { target, template };
+}
+
+async function directoryHasFile(directory, relativeFile) {
+    if (!directory) return false;
+    try {
+        return (await fs.stat(path.join(directory, relativeFile))).isFile();
+    } catch {
+        return false;
+    }
+}
+
+export async function runNewCommand(args, options = {}) {
+    const log = options.log ?? ((line) => console.log(line));
+    const logError = options.logError ?? ((line) => console.error(line));
+    const cwd = options.cwd ?? process.cwd();
+    const assets = options.assets ?? resolveLauncherAssets();
+
+    if (args.includes('--help') || args.includes('-h')) {
+        log(usage);
+        return { exitCode: 0 };
+    }
+
+    let parsed;
+    try {
+        parsed = parseArguments(args);
+    } catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        return { exitCode: 1 };
+    }
+
+    const { target, template } = parsed;
+    const targetDir = path.resolve(cwd, target);
+    const templateDir = template ? path.resolve(cwd, template) : assets.templateDir;
+
+    if (!templateDir) {
+        logError('プロジェクト雛形が見つかりません。');
+        return { exitCode: 1 };
+    }
+
+    try {
+        const templateStat = await fs.stat(templateDir);
+        if (!templateStat.isDirectory()) {
+            throw new Error('not a directory');
+        }
+    } catch {
+        logError(`雛形が見つかりません: ${templateDir}`);
+        return { exitCode: 1 };
+    }
+
+    const skillsSourceDir = assets.skillsSourceDir;
+    const hasSkills = await directoryHasFile(skillsSourceDir, 'analyze-footage/SKILL.md');
+    if (!hasSkills) {
+        logError(`スキル正本が見つからないため、スキル同梱をスキップします: ${skillsSourceDir ?? '未検出'}`);
+    }
+    const schemasSourceDir = assets.schemasSourceDir;
+    const hasSchemas = await directoryHasFile(schemasSourceDir, 'analysis.schema.json');
+
+    if (!assets.scaffoldModulePath && !options.createProject) {
+        logError('プロジェクト作成モジュールが見つかりません。');
+        return { exitCode: 1 };
+    }
+
+    try {
+        const createProject = options.createProject ?? await defaultCreateProject(assets.scaffoldModulePath);
+        const result = await createProject(targetDir, templateDir, hasSkills
+            ? { skillsSourceDir, schemasSourceDir: hasSchemas ? schemasSourceDir : undefined }
+            : {});
+        log(`プロジェクトを作成しました: ${result.destination}`);
+        log(`コピー: ${result.copy.copiedFiles.length} 件`);
+        log(`フォールバック補完: ${result.fallback.writtenFiles.length} 件`);
+        log(`シンボリックリンクのスキップ: ${result.copy.skippedSymlinks.length} 件`);
+        log(`スキル同梱: ${hasSkills ? `実施（${skillsSourceDir}）` : 'スキップ'}`);
+        log(`git: ${result.git.action}`);
+        log(`作成結果レポート: ${result.reportPath}`);
+        return { exitCode: 0, result };
+    } catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        return { exitCode: 1 };
+    }
+}
+
+async function defaultCreateProject(scaffoldModulePath) {
+    const { createProject } = await import(pathToFileURL(scaffoldModulePath).href);
+    return createProject;
+}

package/src/project-state.mjs

@@ -5,13 +5,22 @@ import path from 'node:path';
  * カレントプロジェクトが AKARI Video プロジェクトとしてセットアップ済みかを判定する。
  * `.akari/connections.json` の有無を「セットアップ済み」の判定基準にする
  * （`create-project` / `project-scaffold` が必ずこのファイルを雛形から生成するため）。
+ *
+ * 例外: `.akari/root.json`（作業場マニフェスト）を持つディレクトリは作業場ルートであって
+ * プロジェクトではない。作業場層 `.akari/connections.json`（`packages/creator-root` の
+ * `createCreatorRoot()` が既定レジストリを書き出す）が存在しても、それはプロジェクトの
+ * セットアップ済みマーカーとして扱わない（さもないと作業場ルート自体が既存プロジェクトと
+ * 誤判定され、`(b) 作業場の中だがプロジェクトではない cwd` の新規プロジェクト作成分岐
+ * [`first-run.mjs`] が壊れる）。
  */
 export function detectProjectState(projectRoot) {
   const akariDir = path.join(projectRoot, '.akari');
   const connectionsPath = path.join(akariDir, 'connections.json');
   const intakePath = path.join(akariDir, 'intake.json');
+  const rootManifestPath = path.join(akariDir, 'root.json');
 
-  const scaffolded = existsSync(connectionsPath);
+  const isWorkspaceRoot = existsSync(rootManifestPath);
+  const scaffolded = !isWorkspaceRoot && existsSync(connectionsPath);
   let intake = null;
   if (existsSync(intakePath)) {
     try {

package/src/repo-assets.mjs

@@ -3,8 +3,8 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 // このファイルの場所（packages/akari-launcher/src/）から見て、モノレポの checkout
-// なら 2 つ上がリポジトリルート。`skills/create-project/bin/create-project.mjs` と
-// 同じ「スクリプト自身の位置からの相対解決」方式（cwd には依存しない — cwd は
+// なら 2 つ上がリポジトリルート。「スクリプト自身の位置からの相対解決」方式で、
+// cwd には依存しない（cwd は
 // スキャフォールド先のプロジェクトルートであり、リポ checkout の位置とは無関係）。
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const DEFAULT_REPO_ROOT_CANDIDATE = path.resolve(PACKAGE_ROOT, '..', '..');
@@ -27,6 +27,13 @@ const CREATOR_ROOT_MODULE_RELATIVE = path.join('packages', 'creator-root', 'src'
 // 公式音源ライブラリ（AKARI Sounds）の一括取得スクリプト。初回動線（sounds-setup.mjs）と
 // `akari sounds` が子プロセスとして起動する。未同梱なら null（機能スキップ）。
 const AUDIO_FETCH_SCRIPT_RELATIVE = path.join('packages', 'audio-library-setup', 'bin', 'fetch-akari-sounds.mjs');
+// 素材 resolver（アカウントの素材 = 無料 + 購入済みの一覧・取得）の CLI 実体。
+// `akari assets <list|fetch|sync|...>`（assets-command.mjs）が子プロセスとして起動する。
+// 未同梱なら null（`akari assets` はその旨のエラーを返す。他コマンドは無影響）。
+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 RENDER_WHEN_IDLE_SCRIPT_RELATIVE = path.join('packages', 'akari-tools', 'bin', 'render-when-idle.sh');
 
 /**
  * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装・creator-root
@@ -40,6 +47,10 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const scaffoldModulePath = path.join(repoRoot, SCAFFOLD_MODULE_RELATIVE);
   const creatorRootModulePath = path.join(repoRoot, CREATOR_ROOT_MODULE_RELATIVE);
   const audioFetchScriptPath = path.join(repoRoot, AUDIO_FETCH_SCRIPT_RELATIVE);
+  const assetResolverCliPath = path.join(repoRoot, ASSET_RESOLVER_CLI_RELATIVE);
+  const beatmapScript = path.join(repoRoot, BEATMAP_SCRIPT_RELATIVE);
+  const probeFrameScript = path.join(repoRoot, PROBE_FRAME_SCRIPT_RELATIVE);
+  const renderWhenIdleScript = path.join(repoRoot, RENDER_WHEN_IDLE_SCRIPT_RELATIVE);
 
   return {
     repoRoot,
@@ -49,7 +60,11 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
     doctorScript: existsSync(doctorScript) ? doctorScript : null,
     scaffoldModulePath: existsSync(scaffoldModulePath) ? scaffoldModulePath : null,
     creatorRootModulePath: existsSync(creatorRootModulePath) ? creatorRootModulePath : null,
-    audioFetchScriptPath: existsSync(audioFetchScriptPath) ? audioFetchScriptPath : null
+    audioFetchScriptPath: existsSync(audioFetchScriptPath) ? audioFetchScriptPath : null,
+    assetResolverCliPath: existsSync(assetResolverCliPath) ? assetResolverCliPath : null,
+    beatmapScript: existsSync(beatmapScript) ? beatmapScript : null,
+    probeFrameScript: existsSync(probeFrameScript) ? probeFrameScript : null,
+    renderWhenIdleScript: existsSync(renderWhenIdleScript) ? renderWhenIdleScript : null
   };
 }
 
@@ -64,6 +79,7 @@ export function resolveLauncherAssets({
 } = {}) {
   const checkout = resolveRepoAssets(candidateRoot);
   const found = checkout.skillsSourceDir || checkout.templateDir || checkout.schemasSourceDir
-    || checkout.doctorScript || checkout.scaffoldModulePath || checkout.creatorRootModulePath;
+    || checkout.doctorScript || checkout.scaffoldModulePath || checkout.creatorRootModulePath
+    || checkout.beatmapScript || checkout.probeFrameScript || checkout.renderWhenIdleScript;
   return found ? checkout : resolveRepoAssets(vendorRoot);
 }

package/src/status-command.mjs

@@ -1,4 +1,13 @@
-import { resolveProjectStatus, resolveFullProjectStatus, serializeStatus, formatStatusSummary } from "./status-core/status.mjs";
+import {
+  resolveProjectStatus,
+  resolveFullProjectStatus,
+  serializeStatus,
+  formatStatusSummary,
+  detectStatusScope,
+  resolveWorkspaceStatus,
+  serializeWorkspaceStatus,
+  formatWorkspaceStatusSummary,
+} from "./status-core/status.mjs";
 
 export async function runStatusCommand(argv, options = {}) {
   const log = options.log ?? ((line) => process.stdout.write(line));
@@ -10,6 +19,14 @@ export async function runStatusCommand(argv, options = {}) {
     error(cause instanceof Error ? cause.message : String(cause));
     return { exitCode: 2 };
   }
+  if (detectStatusScope(parsed.projectRoot) === "workspace") {
+    const workspace = resolveWorkspaceStatus(parsed.projectRoot);
+    // fail-safe: a broken root.json falls through to the unchanged project-scope path below.
+    if (workspace) {
+      log(parsed.json ? serializeWorkspaceStatus(workspace) : `${formatWorkspaceStatusSummary(workspace)}\n`);
+      return { exitCode: 0, workspace };
+    }
+  }
   const status = parsed.full
     ? await resolveFullProjectStatus(parsed.projectRoot)
     : resolveProjectStatus(parsed.projectRoot, { mode: "fast" });

package/src/status-core/display-name.mjs

@@ -0,0 +1,22 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+// プロジェクトの人間向け表示名の解決（task 2026-08-09-project-display-title）。
+// フォルダ名は作成時刻ベースの機械 ID のまま変えない（オーナー裁定: フォルダ名 = 機械の ID /
+// 表示名 = 別に持つ）。人が読む名前は `.akari/intake.json` の `title` に置き、
+// `akari status`（プロジェクトスコープ・作業場スコープ双方）はここを通す。
+
+/** `.akari/intake.json` の title を読む。無い・壊れている・型違いは null（フェイルセーフ側）。 */
+export function readProjectTitle(projectRoot) {
+  try {
+    const parsed = JSON.parse(readFileSync(join(projectRoot, ".akari", "intake.json"), "utf8"));
+    return typeof parsed?.title === "string" && parsed.title.trim().length > 0 ? parsed.title : null;
+  } catch {
+    return null;
+  }
+}
+
+/** title ?? フォルダ名。title が無い（既存プロジェクト）・null・空文字はフォルダ名へフォールバックする。 */
+export function resolveProjectDisplayName(title, folderName) {
+  return typeof title === "string" && title.trim().length > 0 ? title : folderName;
+}

package/src/status-core/status.mjs

@@ -3,9 +3,17 @@ import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync } from "
 import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 
 import { readProjectEvents, resolveActiveAcceptance } from "./events.mjs";
+import { resolveProjectDisplayName } from "./display-name.mjs";
 import { inspectFullIntegrity } from "./integrity.mjs";
 import { validateAndCountReview } from "./review.mjs";
 
+export {
+  detectStatusScope,
+  resolveWorkspaceStatus,
+  serializeWorkspaceStatus,
+  formatWorkspaceStatusSummary,
+} from "./workspace.mjs";
+
 const MEDIA_EXTENSIONS = new Set([
   ".aac", ".aif", ".aiff", ".avi", ".bmp", ".flac", ".gif", ".jpeg", ".jpg",
   ".m4a", ".m4v", ".mkv", ".mov", ".mp3", ".mp4", ".ogg", ".png", ".wav",
@@ -105,7 +113,7 @@ export function resolveProjectStatus(input = process.cwd(), { mode = "fast" } =
   return {
     version: 1,
     mode,
-    project: { name: projectName, scaffolded },
+    project: { name: projectName, scaffolded, display_name: resolveProjectDisplayName(intake?.title, projectName) },
     workflow_stage: stage,
     state_health: stateHealth,
     waiting_on: routing.waiting_on,