akari-video 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryoma Nakajima (AkariLabs)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# akari-launcher（`akari` コマンド）
+
+「UI に依存したくない。Claude Code 単体でも、どんなディレクトリでも始められるように」を
+実現する薄いラッパー CLI。npm パッケージ名は `akari-video`、提供するコマンド名は `akari`
+（npm の `akari` は別プロダクトが取得済みのため。オーナー裁定 2026-07-21 §8-2）。
+
+## やること
+
+```
+akari
+  │
+  ├─ 1. doctor: カレントディレクトリが AKARI Video プロジェクトかを判定する
+  │     （.akari/connections.json の有無）
+  │
+  ├─ 2. 未セットアップなら:
+  │     日本語で案内 → project-scaffold を呼んで雛形を作成
+  │     （.akari/intake.json は status: "draft" で生成される）
+  │
+  ├─ 3. 接続状態を確認する:
+  │     skills/manage-connections/bin/doctor.mjs を再利用して
+  │     .akari/connections.json の doctor ブロックを更新・表示する
+  │     （キーの値は一切表示しない）
+  │
+  └─ 4. 最後に claude を exec する
+        （PATH に claude が無ければ、インストール案内を出して終了する）
+```
+
+`akari` に渡した引数はそのまま `claude` に転送する（例: `akari --continue` は
+`claude --continue` を起動する）。
+
+## 3 入口の対応表
+
+AKARI Video は「同じファイル契約（`.akari/` 配下の JSON）に収束する 3 つの入口」を
+持つ（上位契約 §5）。
+
+| 入口 | 実体 | 発動方法 |
+|---|---|---|
+| ターミナル | この `akari` ランチャー CLI | シェルで `akari` と打つ（`npm i -g akari-video` または `npx akari-video` 相当。器のみ、npm publish は本タスクのスコープ外） |
+| セッション内 | プラグインの `/akari` スラッシュコマンド、または発話 | Claude Code セッション内で `/akari` と打つ、または普通に話しかけて `create-project` スキルを発動させる |
+| アプリ | 接続ボタン（AKARI Video アプリ） | アプリの「はじめる」画面から接続 → はじめかた選択 |
+
+3 つとも最終的に同じもの（`.akari/connections.json` / `.akari/intake.json` /
+`skills/create-project`）を読み書きするため、どの入口から始めても続きは他の入口から
+再開できる。
+
+## インストール（現状の到達点）
+
+npm publish は本タスクのスコープ外（「器まで」）。現状は次のいずれかで実行できる:
+
+```sh
+# モノレポ checkout 内から、bin を直接実行する
+node packages/akari-launcher/bin/akari.mjs
+
+# 将来 npm publish された場合の想定コマンド（現状は publish していないため未検証）
+npm i -g akari-video && akari
+npx akari-video
+```
+
+`package.json` は `"private": true` のままにしてある（誤って publish されることを防ぐ
+セーフティネット）。実際に npm へ配信する契約が別途 approve されたときに、まず
+この 1 行を外すところから始める。
+
+## 既知の制約
+
+- **配布パッケージとしての自己完結性は未整備**: `akari` はスキル正本・
+  `templates/project-default`・`packages/schemas` を、自分の checkout 位置からの
+  相対パスで解決する（`skills/create-project/bin/create-project.mjs` と同じ方式）。
+  これはこのリポジトリの checkout 内で実行される前提であり、npm レジストリ経由で
+  単体インストールされた場合にこれらのアセットを同梱する build/vendor 手順はまだ
+  実装していない（マーケットプレイス配布・審査は上位契約 §7 でスコープ外）。
+- Windows での動作は未検証（`claude.exe` / `claude.cmd` の探索ロジックはあるが
+  実機確認していない）。
+
+## テスト
+
+```sh
+node --test test/*.mjs
+```
+
+`doctor` 分岐（セットアップ済み/未セットアップ）・scaffold 呼び出し（実 project-scaffold
+を使った統合テストを含む）・`claude` 不在時の案内、の 3 系統 + 補助的な単体テストを含む。

package/bin/akari.mjs

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "akari-video",
+  "version": "0.1.0",
+  "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code. AKARI Video を Claude Code 単体・どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → `claude` を起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
+  "type": "module",
+  "bin": {
+    "akari": "bin/akari.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "vendor",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AkariLabs/akari-video.git",
+    "directory": "packages/akari-launcher"
+  },
+  "homepage": "https://github.com/AkariLabs/akari-video#readme",
+  "bugs": {
+    "url": "https://github.com/AkariLabs/akari-video/issues"
+  },
+  "keywords": [
+    "video",
+    "video-editing",
+    "ai",
+    "agent",
+    "claude",
+    "claude-code",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "prepack": "node scripts/prepack.mjs",
+    "postpack": "node scripts/prepack.mjs clean",
+    "test": "node --test test/*.mjs"
+  }
+}

package/src/cli.mjs

@@ -0,0 +1,140 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+
+import { resolveLauncherAssets } from './repo-assets.mjs';
+import { detectProjectState } from './project-state.mjs';
+import { findClaudeExecutable } from './path-lookup.mjs';
+import { loadTaskLabels } from './task-labels.mjs';
+import { describeIntake, claudeMissingGuidance, describeUpdateCommand, describeVersionStatus, formatUpdateNotice } from './messages.mjs';
+import {
+  checkForUpdateSync,
+  readCacheSync,
+  readOwnVersion,
+  recordDismissalSync,
+  resolveCachePath,
+  triggerBackgroundRefresh
+} from './update-check.mjs';
+
+/**
+ * `akari` ランチャーの本体。3 入口契約（ターミナル `akari` / セッション内 `/akari` /
+ * アプリ接続ボタン）のうち、ターミナル入口を実装する:
+ *   doctor（接続チェック）→ 未セットアップなら案内 + scaffold → 最後に `claude` を exec。
+ *
+ * すべての副作用（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;
+  const runDoctor = options.runDoctor ?? defaultRunDoctor;
+  const resolveClaude = options.resolveClaude ?? (() => findClaudeExecutable());
+  const spawnClaude = options.spawnClaude ?? defaultSpawnClaude;
+  const env = options.env ?? process.env;
+  const currentVersion = options.currentVersion ?? readOwnVersion();
+
+  let state = detectProjectState(projectRoot);
+
+  if (!state.scaffolded) {
+    log(`このフォルダーは AKARI Video プロジェクトとしてまだセットアップされていません: ${projectRoot}`);
+    if (!assets.templateDir || !assets.scaffoldModulePath) {
+      log('プロジェクト雛形が見つからないため、雛形の作成をスキップしました。');
+    } else {
+      log('プロジェクトの雛形を作成します…');
+      try {
+        const report = await scaffold(projectRoot, assets);
+        log(`プロジェクトを作成しました（コピー ${report.copy.copiedFiles.length} 件 / 補完 ${report.fallback.writtenFiles.length} 件 / git: ${report.git.action}）。`);
+      } catch (error) {
+        // scaffold の失敗で claude 起動まで止めない（「最後に claude を exec」は不変条件）。
+        log(`プロジェクトの雛形作成でエラーが発生しました（続行します）: ${error instanceof Error ? error.message : String(error)}`);
+      }
+      state = detectProjectState(projectRoot);
+    }
+  } else {
+    log(`既存の AKARI Video プロジェクトを検出しました: ${projectRoot}`);
+  }
+
+  const taskLabels = loadTaskLabels(assets.schemasSourceDir);
+  log(describeIntake(state.intake, taskLabels));
+
+  if (state.scaffolded && assets.doctorScript) {
+    log('接続状態を確認します…');
+    try {
+      runDoctor(assets.doctorScript, projectRoot);
+    } catch (error) {
+      log(`接続確認でエラーが発生しました（続行します）: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    log(describeVersionStatus(currentVersion, readCacheSync(resolveCachePath(env))));
+  }
+
+  // 新版通知（契約 §4-1）: キャッシュの読み比較のみ・ネットワークには一切触れない
+  // （起動をブロックしない）。fetch は detached な子プロセスへ切り離し、
+  // 結果は次回セッションで効く。
+  const updateNotice = formatUpdateNotice((options.checkUpdate ?? checkForUpdateSync)({ currentVersion, env }));
+  if (updateNotice) {
+    log(updateNotice);
+  }
+  (options.refreshUpdate ?? triggerBackgroundRefresh)({ env });
+
+  log('Claude Code を起動します…');
+  const claudePath = resolveClaude();
+  if (!claudePath) {
+    log(claudeMissingGuidance());
+    return { exitCode: 1, scaffolded: state.scaffolded, claudeLaunched: false };
+  }
+
+  const result = spawnClaude(claudePath, args, projectRoot);
+  const exitCode = typeof result.status === 'number' ? result.status : (result.error ? 1 : 0);
+  return { exitCode, scaffolded: state.scaffolded, claudeLaunched: true };
+}
+
+async function defaultScaffold(projectRoot, assets) {
+  // scaffold 実装はパッケージ外（モノレポ workspace）と vendor 同梱（npm 配布時）の
+  // 両方があり得るため、静的 import ではなく assets で解決したパスを動的 import する。
+  const { createProject } = await import(pathToFileURL(assets.scaffoldModulePath).href);
+  const scaffoldOptions = assets.skillsSourceDir
+    ? { skillsSourceDir: assets.skillsSourceDir, schemasSourceDir: assets.schemasSourceDir ?? undefined }
+    : {};
+  return createProject(projectRoot, assets.templateDir, scaffoldOptions);
+}
+
+function defaultRunDoctor(doctorScript, projectRoot) {
+  if (!existsSync(doctorScript)) {
+    return { status: 0 };
+  }
+  return spawnSync(process.execPath, [doctorScript, projectRoot], { stdio: 'inherit' });
+}
+
+function defaultSpawnClaude(claudePath, args, projectRoot) {
+  return spawnSync(claudePath, args, { stdio: 'inherit', cwd: projectRoot });
+}
+
+/**
+ * `akari update`: 現在版・最新版・リリースノート URL を表示し、更新手順を**案内するだけ**
+ * （自動実行はしない — 契約 §4-1）。`--dismiss` を渡すと、キャッシュに載っている最新版の
+ * 通知を今後出さないよう記録する。ネットワークには一切触れない
+ * （表示に使う情報はすべて既存キャッシュ由来 — 最新情報は `akari` 起動時のバックグラウンド
+ * fetch で更新される）。
+ */
+export async function runUpdateCommand(args, options = {}) {
+  const log = options.log ?? ((line) => console.log(line));
+  const env = options.env ?? process.env;
+  const currentVersion = options.currentVersion ?? readOwnVersion();
+  const cachePath = resolveCachePath(env);
+  const cache = readCacheSync(cachePath);
+  const dismissRequested = args.includes('--dismiss');
+
+  let dismissed = false;
+  if (dismissRequested && typeof cache?.feed?.product === 'string') {
+    recordDismissalSync({ version: cache.feed.product, env });
+    dismissed = true;
+  }
+
+  const finalCache = dismissed ? readCacheSync(cachePath) : cache;
+  for (const line of describeUpdateCommand({ currentVersion, cache: finalCache, dismissed })) {
+    log(line);
+  }
+  return { exitCode: 0 };
+}

package/src/messages.mjs

@@ -0,0 +1,100 @@
+import { compareVersions } from './update-check.mjs';
+
+const AUTONOMY_LABELS = {
+  'full-auto': 'すべておまかせ',
+  checkpoint: '要所で確認（既定）',
+  collaborative: '相談しながら'
+};
+
+/** channel が prerelease のときだけ付ける版名の注記（CLI・シェルで共通の規則）。 */
+function channelSuffix(channel) {
+  return channel === 'prerelease' ? '（プレリリース）' : '';
+}
+
+/**
+ * `.akari/intake.json`（進め方フォーム）の状態を、利用者の言葉で 1 段落に要約する。
+ */
+export function describeIntake(intake, taskLabels) {
+  if (!intake) {
+    return '進め方フォーム（.akari/intake.json）がまだありません。';
+  }
+  if (intake.status !== 'submitted') {
+    return '進め方はまだ未確定です（.akari/intake.json: draft）。intake フォーム、または対話で「やること・尺・おまかせ度」を確定してください。';
+  }
+
+  const tasks = Array.isArray(intake.tasks) ? intake.tasks : [];
+  const taskText = tasks.length > 0
+    ? tasks.map((id) => taskLabels?.[id] ?? id).join('、')
+    : '（やること未選択）';
+  const autonomyText = AUTONOMY_LABELS[intake.autonomy] ?? intake.autonomy ?? '未設定';
+  const target = intake.target ?? {};
+  const targetText = target.keep_length
+    ? '尺は素材のまま'
+    : typeof target.duration_s === 'number'
+      ? `目標尺 ${target.duration_s} 秒`
+      : '尺は未指定';
+
+  return `進め方: ${taskText} / ${targetText} / 進め方は${autonomyText}。この内容で進めます。`;
+}
+
+export function claudeMissingGuidance() {
+  return [
+    'claude コマンドが見つかりませんでした。',
+    'Claude Code をインストールしてください: https://claude.ai/install.sh',
+    'インストール後、このフォルダーで再度 `akari` を実行してください。'
+  ].join('\n');
+}
+
+/**
+ * `akari` 起動時、claude 起動直前に出す 1 行通知（契約 §4-1）。
+ * `checkForUpdateSync` が返す状態から組み立てる。新版が無ければ null。
+ */
+export function formatUpdateNotice(status) {
+  if (!status?.available) {
+    return null;
+  }
+  return `⬆ AKARI Video v${status.latestVersion}${channelSuffix(status.channel)}があります（現在 v${status.currentVersion}）→ 詳細: akari update`;
+}
+
+/** `akari doctor` 系出力に足す 1 行（現在版 + フィード取得状態）。 */
+export function describeVersionStatus(currentVersion, cache) {
+  if (!cache?.feed) {
+    return `バージョン: v${currentVersion}（更新フィード: 未取得）`;
+  }
+  const fetchedAt = typeof cache.fetched_at === 'string' ? cache.fetched_at : '不明';
+  return `バージョン: v${currentVersion}（更新フィード: 取得済み・${fetchedAt} 時点）`;
+}
+
+/**
+ * `akari update` の出力本文（複数行）。フィード未取得・最新・新版ありで案内が変わる。
+ * `dismissed` は今回の実行で dismiss 記録を書いたかどうか（表示文言の切り替えのみに使う）。
+ */
+export function describeUpdateCommand({ currentVersion, cache, dismissed }) {
+  const lines = [`現在のバージョン: v${currentVersion}`];
+  const feed = cache?.feed;
+  if (!feed) {
+    lines.push('最新情報をまだ取得できていません（オフライン、または初回起動直後の可能性があります）。');
+    lines.push('少し待ってから、もう一度 `akari` を実行すると次回チェックされます。');
+    return lines;
+  }
+
+  lines.push(`最新バージョン: v${feed.product}${channelSuffix(feed.channel)}`);
+  if (feed.notes_url) {
+    lines.push(`リリースノート: ${feed.notes_url}`);
+  }
+
+  if (compareVersions(feed.product, currentVersion) <= 0) {
+    lines.push('お使いのバージョンは最新です。');
+    return lines;
+  }
+
+  const tarballUrl = feed.components?.cli?.tarball?.url;
+  lines.push('更新するには、次のコマンドを実行してください（自動実行はしません）:');
+  lines.push(tarballUrl ? `  npm i -g ${tarballUrl}` : '  npm i -g akari-video@latest');
+  lines.push(
+    dismissed
+      ? `この版（v${feed.product}）の通知は今後表示しません。`
+      : 'この版の通知を今後出さない場合は `akari update --dismiss` を実行してください。'
+  );
+  return lines;
+}

package/src/path-lookup.mjs

@@ -0,0 +1,47 @@
+import { accessSync, constants as fsConstants } from 'node:fs';
+import path from 'node:path';
+
+const DEFAULT_WINDOWS_EXTENSIONS = ['.exe', '.cmd', '.bat'];
+
+/**
+ * Windows の実行可能拡張子一覧を決める。`PATHEXT` があればそれに従い（実 OS の
+ * CreateProcess 拡張子解決と同じ規約）、無ければ既定セットへ fallback する。
+ * `PATHEXT` は Windows 上では常に `;` 区切り（`path.delimiter` はホスト OS 依存の
+ * ため、posix ホストから win32 分岐をテストする際は一致しない）。
+ */
+function resolveWindowsExtensions(pathExt) {
+  const parsed = (pathExt ?? '')
+    .split(';')
+    .map((extension) => extension.trim())
+    .filter(Boolean);
+  return parsed.length > 0 ? parsed : DEFAULT_WINDOWS_EXTENSIONS;
+}
+
+/**
+ * PATH 上に `claude` 実行ファイルがあるかを探す。純粋関数（`pathEnv` / `platform` /
+ * `pathExt` を引数として渡せる）にして、実 PATH やシェル alias に依存せずテストできる
+ * ようにする。シェル alias（例: 対話シェルの `alias claude=...`）は子プロセス起動では
+ * 解決されないため、ここでは実ファイルの存在と実行権限だけを見る。
+ *
+ * win32 では拡張子なしの `claude` は候補に含めない: CreateProcess は拡張子で実行方式
+ * を判定するため、拡張子なしファイル（npm の POSIX シムなど）は直接 spawn できない。
+ */
+export function findClaudeExecutable(pathEnv = process.env.PATH ?? '', platform = process.platform, pathExt = process.env.PATHEXT) {
+  const directories = pathEnv.split(path.delimiter).filter(Boolean);
+  const candidateNames = platform === 'win32'
+    ? resolveWindowsExtensions(pathExt).map((extension) => `claude${extension.toLowerCase()}`)
+    : ['claude'];
+
+  for (const directory of directories) {
+    for (const name of candidateNames) {
+      const candidate = path.join(directory, name);
+      try {
+        accessSync(candidate, fsConstants.X_OK);
+        return candidate;
+      } catch {
+        // このディレクトリには無い。次を探す。
+      }
+    }
+  }
+  return null;
+}

package/src/project-state.mjs

@@ -0,0 +1,25 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+
+/**
+ * カレントプロジェクトが AKARI Video プロジェクトとしてセットアップ済みかを判定する。
+ * `.akari/connections.json` の有無を「セットアップ済み」の判定基準にする
+ * （`create-project` / `project-scaffold` が必ずこのファイルを雛形から生成するため）。
+ */
+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 scaffolded = existsSync(connectionsPath);
+  let intake = null;
+  if (existsSync(intakePath)) {
+    try {
+      intake = JSON.parse(readFileSync(intakePath, 'utf8'));
+    } catch {
+      intake = null;
+    }
+  }
+
+  return { projectRoot, scaffolded, intake, connectionsPath, intakePath };
+}

package/src/repo-assets.mjs

@@ -0,0 +1,59 @@
+import { existsSync } from 'node:fs';
+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 は
+// スキャフォールド先のプロジェクトルートであり、リポ checkout の位置とは無関係）。
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const DEFAULT_REPO_ROOT_CANDIDATE = path.resolve(PACKAGE_ROOT, '..', '..');
+
+// npm 配布時は prepack（scripts/prepack.mjs）がモノレポ同梱物を同一レイアウトで
+// vendor/ に焼き込む。checkout に見えない場合はこちらを「リポジトリルート」として使う。
+const DEFAULT_VENDOR_ROOT = path.join(PACKAGE_ROOT, 'vendor');
+
+const SKILLS_MARKER = path.join('skills', 'analyze-footage', 'SKILL.md');
+// 雛形マーカーに .gitignore を使わない: npm は tarball 生成時に .gitignore という名前の
+// ファイルを無条件に除外するため、vendor 同梱（npm 配布時）では存在し得ない。
+// 雛形側の .gitignore 実体は project-scaffold の writeFallbackTemplate が補完する。
+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');
+
+/**
+ * 指定ルート配下に同梱されているスキル正本・雛形・schemas・scaffold 実装を探す。
+ * 見つからないフィールドは null になり、呼び出し側はそれに応じて機能をスキップする。
+ */
+export function resolveRepoAssets(repoRoot = DEFAULT_REPO_ROOT_CANDIDATE) {
+  const hasSkills = existsSync(path.join(repoRoot, SKILLS_MARKER));
+  const hasTemplate = existsSync(path.join(repoRoot, TEMPLATE_MARKER));
+  const hasSchemas = existsSync(path.join(repoRoot, SCHEMAS_MARKER));
+  const doctorScript = path.join(repoRoot, DOCTOR_SCRIPT_RELATIVE);
+  const scaffoldModulePath = path.join(repoRoot, SCAFFOLD_MODULE_RELATIVE);
+
+  return {
+    repoRoot,
+    skillsSourceDir: hasSkills ? path.join(repoRoot, 'skills') : null,
+    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
+  };
+}
+
+/**
+ * ランチャー実行時の同梱物解決: モノレポ checkout（開発時）→ vendor/（npm 配布時）の
+ * 順で探し、最初に何かしら見つかったルートを採用する。テストからは candidateRoot /
+ * vendorRoot を注入して両分岐を実ディレクトリ無しで検証できる。
+ */
+export function resolveLauncherAssets({
+  candidateRoot = DEFAULT_REPO_ROOT_CANDIDATE,
+  vendorRoot = DEFAULT_VENDOR_ROOT
+} = {}) {
+  const checkout = resolveRepoAssets(candidateRoot);
+  const found = checkout.skillsSourceDir || checkout.templateDir || checkout.schemasSourceDir
+    || checkout.doctorScript || checkout.scaffoldModulePath;
+  return found ? checkout : resolveRepoAssets(vendorRoot);
+}

package/src/task-labels.mjs

@@ -0,0 +1,30 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+
+// packages/schemas/intake.schema.json の x-akari-labels（安定 ID ↔ 日本語ラベル）が
+// 唯一の出典（オーナー裁定 2026-07-21 §8-3）。読めない場合だけ、この最小フォールバックを使う。
+const FALLBACK_LABELS = {
+  'transcribe-captions': '文字起こし・テロップ',
+  'silence-cut': 'いらない間・NG のカット',
+  'bgm-sfx': 'BGM・効果音',
+  narration: 'ナレーション（自分の声 / 既製の声）',
+  '3d-inserts': '3D・画面はめ込みの演出'
+};
+
+export function loadTaskLabels(schemasSourceDir) {
+  if (schemasSourceDir) {
+    const schemaPath = path.join(schemasSourceDir, 'intake.schema.json');
+    if (existsSync(schemaPath)) {
+      try {
+        const schema = JSON.parse(readFileSync(schemaPath, 'utf8'));
+        const labels = schema?.['x-akari-labels'];
+        if (labels && typeof labels === 'object' && !Array.isArray(labels)) {
+          return labels;
+        }
+      } catch {
+        // 破損している場合はフォールバックへ。
+      }
+    }
+  }
+  return FALLBACK_LABELS;
+}