akari-video 0.1.2 → 0.1.3

package/bin/akari.mjs

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
 import { run, runUpdateCommand } from '../src/cli.mjs';
+import { runInitCommand } from '../src/init-command.mjs';
 
 const argv = process.argv.slice(2);
-// `akari update` は claude へ転送せず、更新の案内だけを行う専用サブコマンド
-// （契約 §4-1）。それ以外の引数はすべて従来どおり claude へ転送する。
-const invoke = argv[0] === 'update' ? runUpdateCommand(argv.slice(1)) : run(argv);
+// `akari update` / `akari init` は claude へ転送せず、専用のサブコマンドとして扱う
+// （契約 §4-1、および `akari init` はタスク契約 tasks/2026-08-02-launcher-init）。
+// それ以外の引数はすべて従来どおり claude へ転送する。
+const invoke = argv[0] === 'update' ? runUpdateCommand(argv.slice(1))
+  : argv[0] === 'init' ? runInitCommand(argv.slice(1))
+  : run(argv);
 
 const result = await invoke.catch((error) => {
   console.error(error instanceof Error ? error.message : String(error));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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

@@ -7,6 +7,7 @@ import { detectProjectState } from './project-state.mjs';
 import { findClaudeExecutable, findOpencodeExecutable } from './path-lookup.mjs';
 import { loadTaskLabels } from './task-labels.mjs';
 import { describeIntake, claudeMissingGuidance, opencodeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
+import { resolveEffectiveProjectRoot } from './first-run.mjs';
 import {
   checkForUpdateSync,
   readCacheSync,
@@ -19,13 +20,13 @@ import {
 /**
  * `akari` ランチャーの本体。3 入口契約（ターミナル `akari` / セッション内 `/akari` /
  * アプリ接続ボタン）のうち、ターミナル入口を実装する:
- *   doctor（接続チェック）→ 未セットアップなら案内 + scaffold → 最後に `claude` を exec。
+ *   作業場（creator-root）の初回動線（`first-run.mjs`）→ doctor（接続チェック）→
+ *   未セットアップなら案内 + scaffold → 最後に `claude` を exec。
  *
- * すべての副作用（scaffold・doctor 実行・claude 起動・claude 探索）は options 経由で
- * 差し替え可能にしてあり、node --test から実プロセスを起動せずに分岐を検証できる。
+ * すべての副作用（creator-root 解決・scaffold・doctor 実行・claude 起動・claude 探索）は
+ * options 経由で差し替え可能にしてあり、node --test から実プロセスを起動せずに分岐を検証できる。
  */
 export async function run(args, options = {}) {
-  const projectRoot = options.projectRoot ?? process.cwd();
   const log = options.log ?? ((line) => console.log(line));
   const assets = options.assets ?? resolveLauncherAssets();
   const scaffold = options.scaffold ?? defaultScaffold;
@@ -35,12 +36,26 @@ export async function run(args, options = {}) {
   const spawnClaude = options.spawnClaude ?? defaultSpawnClaude;
   const spawnOpencode = options.spawnOpencode ?? defaultSpawnOpencode;
   const env = options.env ?? process.env;
+  const platform = options.platform ?? process.platform;
   const currentVersion = options.currentVersion ?? readOwnVersion();
-  
-  // --opencode / --claude / --claudecode / --yes フラグを解析
+  const now = options.now ?? new Date();
+
+  // --opencode / --claude / --claudecode / --yes / --here フラグを解析
   const useOpencode = args.includes('--opencode');
   const autoConfirm = args.includes('--yes') || args.includes('-y');
-  const filteredArgs = args.filter(arg => arg !== '--opencode' && arg !== '--claude' && arg !== '--claudecode' && arg !== '--yes' && arg !== '-y');
+  const hereOnly = args.includes('--here');
+  const filteredArgs = args.filter(arg =>
+    arg !== '--opencode' && arg !== '--claude' && arg !== '--claudecode'
+    && arg !== '--yes' && arg !== '-y' && arg !== '--here'
+  );
+
+  let projectRoot = options.projectRoot ?? process.cwd();
+
+  // 作業場（creator-root）の初回動線（契約 §5・§6-1）。`--here` はお試しモード強制
+  // （現行動作）のため丸ごとスキップする（契約 §9・非 TTY と同じ現行動作互換の扱い）。
+  if (!hereOnly) {
+    projectRoot = await resolveEffectiveProjectRoot({ projectRoot, env, platform, now, log, assets, autoConfirm, options });
+  }
 
   let state = detectProjectState(projectRoot);
 

package/src/first-run.mjs

@@ -0,0 +1,217 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { pathToFileURL } from 'node:url';
+
+import { detectProjectState } from './project-state.mjs';
+import {
+  creatorRootFoundNotice,
+  creatorRootNewProjectNotice,
+  creatorRootCreatedNotice,
+  creatorRootCreateFailedNotice,
+  creatorRootPromptText
+} from './messages.mjs';
+
+/**
+ * `akari` の初回動線（契約 `docs/contract-2026-08-02-creator-root-v1.md` §5・§6-1）。
+ *
+ * `packages/creator-root` が「作業場操作の単一実装」を提供する pure Node ESM モジュールで、
+ * 本モジュールはそれを `repo-assets.mjs` の `scaffoldModulePath` と同型の流儀で動的 import し、
+ * cwd から作業場を解決 → (a)/(b)/(c) の分岐に従ってプロジェクトの展開先ディレクトリを決める
+ * 配線を担う。creator-root モジュールが解決できない場合（npm 配布で vendor 未同梱等）は、
+ * 「最後に claude を exec」の不変条件を守るため現行動作へ静かにフォールバックする。
+ */
+
+// creator-root が未解決の場合の既定チャンネル名フォールバック
+// （`packages/creator-root` の `DEFAULT_CHANNEL_NAME` と同値。値の重複は許容する —
+// creator-root を静的 import できないため定数を直接参照できず、モジュールが解決できた
+// ときは常に本物の export を優先して使う。ここに来るのはモジュール自体が読めない
+// 極端なケースのみ）。
+const DEFAULT_CHANNEL_NAME_FALLBACK = 'my-channel';
+
+/**
+ * creator-root モジュールを `assets.creatorRootModulePath` から動的 import する。
+ * `cli.mjs` の `defaultScaffold` が `scaffoldModulePath` を扱うのと同型。
+ * 見つからなければ null（呼び出し側は現行動作へフォールバックする）。
+ */
+export async function defaultLoadCreatorRootModule(assets) {
+  if (!assets?.creatorRootModulePath) {
+    return null;
+  }
+  return import(pathToFileURL(assets.creatorRootModulePath).href);
+}
+
+/** `node:readline/promises` を使った既定の TTY プロンプト実装。 */
+export async function defaultPrompt(promptText) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    return await rl.question(promptText);
+  } finally {
+    rl.close();
+  }
+}
+
+/**
+ * `manifest.channels[0]` を既定チャンネルとして使う。配列が欠如・空の手作り root.json にも
+ * 備え、その場合は `fallback`（creator-root の `DEFAULT_CHANNEL_NAME`）へフォールバックする。
+ */
+function pickChannelName(manifest, fallback) {
+  return Array.isArray(manifest?.channels) && manifest.channels.length > 0
+    ? manifest.channels[0]
+    : fallback;
+}
+
+function formatDateSlug(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}
+
+/**
+ * `videosDir` 配下に日付ベースの一意なプロジェクトディレクトリパスを決める
+ * （`YYYY-MM-DD-video`、衝突時 `-2`, `-3`… 契約 §5 (b)/(c)）。ディレクトリはまだ作らない
+ * （作成は既存の scaffold 経路に委ねる — 「孤児プロジェクトを作らない」を、新しい作成経路を
+ * 増やさず既存の唯一の scaffold 実装を再利用することで自然に満たす設計）。
+ */
+export function resolveUniqueProjectDir(videosDir, date) {
+  const baseName = `${formatDateSlug(date)}-video`;
+  let candidate = path.join(videosDir, baseName);
+  let suffix = 2;
+  while (existsSync(candidate)) {
+    candidate = path.join(videosDir, `${baseName}-${suffix}`);
+    suffix += 1;
+  }
+  return candidate;
+}
+
+/**
+ * 現在の `projectRoot` から、実際にプロジェクトを展開すべき先のディレクトリを決めて返す。
+ * 何もすることがなければ（既存プロジェクト内 / creator-root モジュール未解決 / お試しモード
+ * 選択時）`projectRoot` をそのまま返す。ここではディレクトリの作成もプロジェクトの scaffold
+ * も行わない。呼び出し側（`cli.mjs` の `run()`）が返り値を新しい `projectRoot` として、
+ * 既存の scaffold 経路にそのまま渡す。
+ */
+export async function resolveEffectiveProjectRoot({
+  projectRoot,
+  env,
+  platform,
+  now,
+  log,
+  assets,
+  autoConfirm,
+  options = {}
+}) {
+  let creatorRootModule = null;
+  try {
+    creatorRootModule = await (options.loadCreatorRootModule ?? defaultLoadCreatorRootModule)(assets);
+  } catch {
+    // creator-root モジュールの読み込みに失敗 → 現行動作へフォールバック（不変条件）
+    creatorRootModule = null;
+  }
+
+  const resolveCreatorRootFn = options.resolveCreatorRoot ?? creatorRootModule?.resolveCreatorRoot;
+  const createCreatorRootFn = options.createCreatorRoot ?? creatorRootModule?.createCreatorRoot;
+  const updateMachinePointerFn = options.updateMachinePointer ?? creatorRootModule?.updateMachinePointer;
+  const defaultRootPathFn = options.defaultRootPath ?? creatorRootModule?.defaultRootPath;
+  const defaultChannelName = options.defaultChannelName ?? creatorRootModule?.DEFAULT_CHANNEL_NAME ?? DEFAULT_CHANNEL_NAME_FALLBACK;
+
+  if (!resolveCreatorRootFn) {
+    return projectRoot;
+  }
+
+  const localState = detectProjectState(projectRoot);
+
+  let resolved = null;
+  try {
+    resolved = await resolveCreatorRootFn({ cwd: projectRoot, env, platform });
+  } catch {
+    resolved = null;
+  }
+
+  if (localState.scaffolded) {
+    // (a) 既存プロジェクト内 → 現行動作のまま。作業場内なら log に 1 行添える。
+    if (resolved && resolved.manifest) {
+      log(creatorRootFoundNotice(resolved.rootDir));
+    }
+    return projectRoot;
+  }
+
+  if (resolved && resolved.error) {
+    // 祖先/マシンポインタに壊れた作業場（未知 schema・壊れた JSON 等）が見つかった場合、
+    // 新規に別の作業場を作りにいかず安全側（お試しモード = 現行動作）に倒す。
+    return projectRoot;
+  }
+
+  if (resolved && resolved.manifest) {
+    // (b) 作業場の中だがプロジェクトではない → 既定チャンネルの videos/ へ新規プロジェクト
+    const channel = pickChannelName(resolved.manifest, defaultChannelName);
+    const videosDir = path.join(resolved.rootDir, 'channels', channel, 'videos');
+    const newProjectDir = resolveUniqueProjectDir(videosDir, now);
+
+    if (updateMachinePointerFn) {
+      try {
+        await updateMachinePointerFn(resolved.rootDir, env, { platform });
+      } catch {
+        // ポインタ更新の失敗でプロジェクト作成・claude 起動までは止めない
+      }
+    }
+
+    log(creatorRootNewProjectNotice(resolved.rootDir, newProjectDir));
+    return newProjectDir;
+  }
+
+  // (c) どちらでもない
+  if (!createCreatorRootFn || !defaultRootPathFn) {
+    return projectRoot;
+  }
+
+  const isTTY = options.isTTY ?? Boolean(process.stdin.isTTY);
+
+  let chosenRootPath = null;
+  if (autoConfirm) {
+    // --yes: 既定パスに自動作成
+    chosenRootPath = defaultRootPathFn(env, { platform });
+  } else if (isTTY) {
+    const promptFn = options.prompt ?? defaultPrompt;
+    const defaultPath = defaultRootPathFn(env, { platform });
+    const answerRaw = await promptFn(creatorRootPromptText(defaultPath));
+    const answer = typeof answerRaw === 'string' ? answerRaw.trim() : '';
+    if (answer.length === 0) {
+      chosenRootPath = defaultPath;
+    } else if (answer.toLowerCase() === 'n') {
+      chosenRootPath = null;
+    } else {
+      chosenRootPath = path.resolve(projectRoot, answer);
+    }
+  } else {
+    // 非 TTY: 現行動作（自動化互換・契約 §9）
+    chosenRootPath = null;
+  }
+
+  if (!chosenRootPath) {
+    return projectRoot;
+  }
+
+  let createResult;
+  try {
+    createResult = await createCreatorRootFn(chosenRootPath);
+  } catch (error) {
+    log(creatorRootCreateFailedNotice(error instanceof Error ? error.message : String(error)));
+    return projectRoot;
+  }
+
+  if (updateMachinePointerFn) {
+    try {
+      await updateMachinePointerFn(createResult.rootDir, env, { platform });
+    } catch {
+      // ポインタ更新の失敗でプロジェクト作成・claude 起動までは止めない
+    }
+  }
+
+  const channel = pickChannelName(createResult.manifest, defaultChannelName);
+  const videosDir = path.join(createResult.rootDir, 'channels', channel, 'videos');
+  const newProjectDir = resolveUniqueProjectDir(videosDir, now);
+  log(creatorRootCreatedNotice(createResult.rootDir, newProjectDir));
+  return newProjectDir;
+}

package/src/init-command.mjs

@@ -0,0 +1,135 @@
+import path from 'node:path';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+import { defaultLoadCreatorRootModule } from './first-run.mjs';
+import {
+  initFoundNotice,
+  initCreatedNotice,
+  initModuleMissingError,
+  initFailedError
+} from './messages.mjs';
+
+/**
+ * `akari init [path] [--channel <name>]` — 作業場（creator-root）の作成・確認だけを行う
+ * 純粋な入口サブコマンド（タスク契約 tasks/2026-08-02-launcher-init）。プロジェクト作成も
+ * claude 起動も一切行わない。シェルの相棒（パートナーエージェント）が headless で
+ * 安全に叩ける口として、plugin 配線（並列タスク B）がこのコマンドを呼ぶ前提で書かれている。
+ *
+ * `run()`（`first-run.mjs` 経由の初回動線）とは役割が違う: あちらは creator-root
+ * モジュールが解決できないとき「最後に claude を exec」という不変条件を守るため現行動作へ
+ * 静かにフォールバックするが、`init` にはフォールバック先そのものが無いため、
+ * モジュール未解決はそのままエラー（exit 1）として扱う。
+ *
+ * 解決した creator-root の各関数（`resolveCreatorRoot` / `createCreatorRoot` /
+ * `updateMachinePointer` / `defaultRootPath`）は options 経由で差し替え可能にしてあり、
+ * node --test から実 creator-root モジュールを使わずに分岐を検証できる。
+ */
+
+function parseInitArgs(args) {
+  let channelName;
+  const positional = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--channel') {
+      channelName = args[i + 1];
+      i += 1;
+      continue;
+    }
+    if (arg === '--yes' || arg === '-y') {
+      // 互換余地として受け取るが無視する（init は TTY プロンプトを持たないため無意味）。
+      continue;
+    }
+    positional.push(arg);
+  }
+  return { targetPath: positional[0], channelName };
+}
+
+function errorMessageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export async function runInitCommand(args, options = {}) {
+  const log = options.log ?? ((line) => console.log(line));
+  const logError = options.logError ?? ((line) => console.error(line));
+  const env = options.env ?? process.env;
+  const platform = options.platform ?? process.platform;
+  const cwd = options.cwd ?? process.cwd();
+  const assets = options.assets ?? resolveLauncherAssets();
+
+  const { targetPath: explicitPath, channelName } = parseInitArgs(args);
+
+  let creatorRootModule = null;
+  try {
+    creatorRootModule = await (options.loadCreatorRootModule ?? defaultLoadCreatorRootModule)(assets);
+  } catch {
+    creatorRootModule = null;
+  }
+  if (!creatorRootModule) {
+    logError(initModuleMissingError());
+    return { exitCode: 1 };
+  }
+
+  const resolveCreatorRootFn = options.resolveCreatorRoot ?? creatorRootModule.resolveCreatorRoot;
+  const createCreatorRootFn = options.createCreatorRoot ?? creatorRootModule.createCreatorRoot;
+  const updateMachinePointerFn = options.updateMachinePointer ?? creatorRootModule.updateMachinePointer;
+  const defaultRootPathFn = options.defaultRootPath ?? creatorRootModule.defaultRootPath;
+
+  let targetDir;
+
+  if (explicitPath) {
+    // `akari init <path>`: 指定パスに作成（既に有効な作業場なら createCreatorRoot が
+    // no-op で既存 manifest を返す＝冪等）。resolveCreatorRoot は経由しない。
+    targetDir = path.resolve(cwd, explicitPath);
+  } else {
+    // `akari init`（引数なし）: resolveCreatorRoot（env → cwd 祖先 → マシンポインタ）で
+    // 既存の作業場が見つかれば ensure（何も作らない）。見つからなければ defaultRootPath に作成。
+    let resolved;
+    try {
+      resolved = await resolveCreatorRootFn({ cwd, env, platform });
+    } catch (error) {
+      logError(initFailedError(errorMessageOf(error)));
+      return { exitCode: 1 };
+    }
+
+    if (resolved?.error) {
+      // 祖先/マシンポインタに壊れた作業場（未知 schema・壊れた JSON 等）が見つかった場合、
+      // 新規に別の作業場を作りにいかず、既存ファイルに一切触れずエラーで終了する。
+      logError(initFailedError(resolved.error.message));
+      return { exitCode: 1 };
+    }
+
+    if (resolved?.manifest) {
+      // ensure: 既存の作業場を確認しただけで何も作らない。
+      try {
+        await updateMachinePointerFn(resolved.rootDir, env, { platform });
+      } catch (error) {
+        logError(initFailedError(errorMessageOf(error)));
+        return { exitCode: 1 };
+      }
+      log(resolved.rootDir);
+      log(initFoundNotice(resolved.rootDir));
+      return { exitCode: 0 };
+    }
+
+    targetDir = defaultRootPathFn(env, { platform });
+  }
+
+  let createResult;
+  try {
+    createResult = await createCreatorRootFn(targetDir, channelName ? { channelName } : {});
+  } catch (error) {
+    logError(initFailedError(errorMessageOf(error)));
+    return { exitCode: 1 };
+  }
+
+  try {
+    await updateMachinePointerFn(createResult.rootDir, env, { platform });
+  } catch (error) {
+    logError(initFailedError(errorMessageOf(error)));
+    return { exitCode: 1 };
+  }
+
+  log(createResult.rootDir);
+  log(createResult.created ? initCreatedNotice(createResult.rootDir) : initFoundNotice(createResult.rootDir));
+  return { exitCode: 0 };
+}

package/src/messages.mjs

@@ -73,6 +73,36 @@ export function describeVersionStatus(currentVersion, cache) {
   return `バージョン: v${currentVersion}（更新フィード: 取得済み・${fetchedAt} 時点）`;
 }
 
+/**
+ * 初回動線（作業場・creator-root）関連の 1 行メッセージ群（契約
+ * `docs/contract-2026-08-02-creator-root-v1.md` §5）。既存の流儀に従い日本語・1 行主義。
+ */
+
+/** (a) 既存プロジェクトが作業場の中にある場合に添える 1 行。 */
+export function creatorRootFoundNotice(rootDir) {
+  return `作業場: ${rootDir}`;
+}
+
+/** (b) 作業場の中だがプロジェクトではない cwd から新規プロジェクトを作るときの 1 行。 */
+export function creatorRootNewProjectNotice(rootDir, projectDir) {
+  return `作業場 ${rootDir} に新規プロジェクトを作成します: ${projectDir}`;
+}
+
+/** (c) 作業場を新規作成してプロジェクトを作るときの 1 行。 */
+export function creatorRootCreatedNotice(rootDir, projectDir) {
+  return `作業場を作成しました: ${rootDir}（新規プロジェクト: ${projectDir}）`;
+}
+
+/** (c) 作業場の作成でエラーが発生した場合の 1 行（このフォルダでの単体運用を続ける）。 */
+export function creatorRootCreateFailedNotice(errorMessage) {
+  return `作業場の作成でエラーが発生しました（このフォルダでの単体運用を続けます）: ${errorMessage}`;
+}
+
+/** (c) の TTY プロンプト文言。既定パスを 1 行で提示する。 */
+export function creatorRootPromptText(defaultPath) {
+  return `作業場を作って始めますか？ [Enter: ${defaultPath} / パスを入力 / n: このフォルダだけで試す] `;
+}
+
 /**
  * `akari update` の出力本文（複数行）。フィード未取得・最新・新版ありで案内が変わる。
  * `dismissed` は今回の実行で dismiss 記録を書いたかどうか（表示文言の切り替えのみに使う）。
@@ -106,3 +136,28 @@ export function describeUpdateCommand({ currentVersion, cache, dismissed }) {
   );
   return lines;
 }
+
+/**
+ * `akari init` の出力文言（タスク契約 tasks/2026-08-02-launcher-init）。作業場
+ * （creator-root）の作成・確認だけを行う入口コマンド専用。1 行主義の既存流儀に従う。
+ */
+
+/** 既存の作業場が見つかり、何も作らず確認しただけの場合の人間向け行。 */
+export function initFoundNotice(rootDir) {
+  return `既存の作業場を確認しました: ${rootDir}`;
+}
+
+/** 新規に作業場を作成した場合の人間向け行。 */
+export function initCreatedNotice(rootDir) {
+  return `作業場を作成しました: ${rootDir}`;
+}
+
+/** creator-root モジュールが解決できない場合のエラー（stderr 1 行。init にフォールバック先は無い）。 */
+export function initModuleMissingError() {
+  return '作業場モジュール（creator-root）が見つかりませんでした。';
+}
+
+/** 作業場の初期化に失敗した場合のエラー（root.json 破損・未知 schema・書き込み不能など。stderr 1 行）。 */
+export function initFailedError(errorMessage) {
+  return `作業場の初期化に失敗しました: ${errorMessage}`;
+}

package/src/repo-assets.mjs

@@ -21,10 +21,13 @@ const TEMPLATE_MARKER = path.join('templates', 'project-default', 'CLAUDE.md');
 const SCHEMAS_MARKER = path.join('packages', 'schemas', 'analysis.schema.json');
 const DOCTOR_SCRIPT_RELATIVE = path.join('skills', 'manage-connections', 'bin', 'doctor.mjs');
 const SCAFFOLD_MODULE_RELATIVE = path.join('packages', 'project-scaffold', 'src', 'index.mjs');
+// 作業場（creator-root）モジュール。① Wave（packages/creator-root）の成果物で、本パッケージ
+// からは読み取り専用（動的 import のみ）。scaffoldModulePath と同型の解決方式。
+const CREATOR_ROOT_MODULE_RELATIVE = path.join('packages', 'creator-root', 'src', 'index.mjs');
 
 /**
- * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装を探す。
- * 見つからないフィールドは null になり、呼び出し側はそれに応じて機能をスキップする。
+ * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装・creator-root
+ * 実装を探す。見つからないフィールドは null になり、呼び出し側はそれに応じて機能をスキップする。
  */
 export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const hasSkills = existsSync(path.join(repoRoot, SKILLS_MARKER));
@@ -32,6 +35,7 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
   const hasSchemas = existsSync(path.join(repoRoot, SCHEMAS_MARKER));
   const doctorScript = path.join(repoRoot, DOCTOR_SCRIPT_RELATIVE);
   const scaffoldModulePath = path.join(repoRoot, SCAFFOLD_MODULE_RELATIVE);
+  const creatorRootModulePath = path.join(repoRoot, CREATOR_ROOT_MODULE_RELATIVE);
 
   return {
     repoRoot,
@@ -39,7 +43,8 @@ export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
     templateDir: hasTemplate ? path.join(repoRoot, 'templates', 'project-default') : null,
     schemasSourceDir: hasSchemas ? path.join(repoRoot, 'packages', 'schemas') : null,
     doctorScript: existsSync(doctorScript) ? doctorScript : null,
-    scaffoldModulePath: existsSync(scaffoldModulePath) ? scaffoldModulePath : null
+    scaffoldModulePath: existsSync(scaffoldModulePath) ? scaffoldModulePath : null,
+    creatorRootModulePath: existsSync(creatorRootModulePath) ? creatorRootModulePath : null
   };
 }
 
@@ -54,6 +59,6 @@ export function resolveLauncherAssets({
 } = {}) {
   const checkout = resolveRepoAssets(candidateRoot);
   const found = checkout.skillsSourceDir || checkout.templateDir || checkout.schemasSourceDir
-    || checkout.doctorScript || checkout.scaffoldModulePath;
+    || checkout.doctorScript || checkout.scaffoldModulePath || checkout.creatorRootModulePath;
   return found ? checkout : resolveRepoAssets(vendorRoot);
 }

package/vendor/packages/creator-root/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@akari-video/creator-root",
+  "version": "0.0.0",
+  "private": true,
+  "description": "AKARI Video の作業場（CreatorRoot）を解決・生成・養子縁組する Electron 非依存・pure Node ESM・外部 npm 依存ゼロの共有モジュール。",
+  "type": "module",
+  "main": "src/index.mjs",
+  "scripts": {
+    "test": "node --test \"test/*.mjs\""
+  }
+}