akari-video 1.5.0-beta.5 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.5.0-beta.5",
+  "version": "1.5.0",
   "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

@@ -32,6 +32,7 @@ import { runWordBookCommand } from './word-book-command.mjs';
 import { runConnectCommand } from './connect-command.mjs';
 import { runProjectCommand } from './project-command.mjs';
 import { runPlaybookCommand } from './playbook-command.mjs';
+import { runRecipeCommand } from './recipe-command.mjs';
 import { resolveRuntimePaths } from './runtime-diagnostics.mjs';
 import { cliText } from './i18n.mjs';
 
@@ -47,6 +48,7 @@ export const runSubcommands = {
   connect: runConnectCommand,
   project: runProjectCommand,
   playbook: runPlaybookCommand,
+  recipe: runRecipeCommand,
 };
 
 /**

package/src/kits.mjs

@@ -293,6 +293,37 @@ export function linkKitPlaybooks(kitDir, manifest, home, options = {}) {
   return { linked, warnings };
 }
 
+export function linkKitRecipes(kitDir, manifest, home, options = {}) {
+  const linked = [];
+  const warnings = [];
+  for (const entry of manifest.recipes ?? []) {
+    if (typeof entry?.dir !== 'string' || !/^recipes\/[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(entry.dir)) {
+      throw new Error(cliText('cli.kits.error.pathOutside', { path: String(entry?.dir) }));
+    }
+    const id = path.posix.basename(entry.dir);
+    const source = safeKitPath(kitDir, entry.dir);
+    const realKit = realpathSync(kitDir);
+    const realSource = realpathSync(source);
+    if (!realSource.startsWith(`${realKit}${path.sep}`) || !statSync(realSource).isDirectory()) {
+      throw new Error(cliText('cli.kits.error.pathOutside', { path: entry.dir }));
+    }
+    const destination = path.join(home, 'tool-recipes', id);
+    try {
+      const stat = lstatSync(destination);
+      let owned = false;
+      if (stat.isSymbolicLink()) {
+        try { owned = realpathSync(destination) === realSource; } catch { /* Broken links are not owned. */ }
+      }
+      if (!owned) { warnings.push(cliText('cli.kits.warning.directoryKept', { path: destination })); continue; }
+    } catch (error) { if (error?.code !== 'ENOENT') throw error; }
+    const result = replaceSymlink(source, destination, options);
+    if (result.status === 'linked') linked.push(id);
+    else warnings.push(cliText(result.status === 'permission-denied'
+      ? 'cli.kits.warning.symlinkFailed' : 'cli.kits.warning.directoryKept', { path: destination }));
+  }
+  return { linked, warnings };
+}
+
 export function readKitsLedger(home) {
   const ledgerPath = path.join(home, 'kits', 'installed.json');
   if (!existsSync(ledgerPath)) return { schema: KITS_SCHEMA, kits: [] };
@@ -311,6 +342,9 @@ export function writeKitsLedger(home, entry) {
       removeOwnedSymlink(path.join(home, 'playbooks', id), previous.kitDir);
     }
   }
+  for (const id of previous?.recipes ?? []) {
+    if (!(entry.recipes ?? []).includes(id)) removeOwnedSymlink(path.join(home, 'tool-recipes', id), previous.kitDir);
+  }
   ledger.kits = [...ledger.kits.filter((kit) => kit.id !== entry.id), entry];
   const ledgerPath = path.join(home, 'kits', 'installed.json');
   mkdirSync(path.dirname(ledgerPath), { recursive: true });
@@ -326,6 +360,7 @@ export function removeKit(home, productId, env = process.env) {
   if (!entry) return false;
   for (const name of entry.skills ?? []) removeOwnedSymlink(path.join(home, 'kits', 'plugin', 'skills', name), entry.kitDir);
   for (const id of entry.playbooks ?? []) removeOwnedSymlink(path.join(home, 'playbooks', id), entry.kitDir);
+  for (const id of entry.recipes ?? []) removeOwnedSymlink(path.join(home, 'tool-recipes', id), entry.kitDir);
   for (const asset of entry.assets ?? []) {
     for (const root of resolveAssetLibraryRoots({ ...env, AKARI_HOME: home }).read) removeOwnedSymlink(path.join(root, asset.category, asset.id), entry.kitDir);
   }

package/src/messages.mjs

@@ -335,7 +335,7 @@ export function describeCliHelp() {
     cliText('cli.help.header.usage'),
     '',
     cliText('cli.help.commands.heading'),
-    ...['launch', 'store', 'sounds', 'doctor', 'speakers', 'toolsVoice', 'update', 'status', 'migrate', 'migrateLook', 'generate', 'storyboard', 'project', 'playbook', 'clean'].map((name) => cliText(`cli.help.commands.${name}`)),
+    ...['launch', 'store', 'sounds', 'doctor', 'speakers', 'toolsVoice', 'update', 'status', 'migrate', 'migrateLook', 'generate', 'storyboard', 'project', 'playbook', 'recipe', 'clean'].map((name) => cliText(`cli.help.commands.${name}`)),
     '',
     cliText('cli.help.developer.heading'),
     ...['opencode', 'claude', 'yes', 'version', 'new', 'init', 'other', 'help'].map((name) => cliText(`cli.help.developer.${name}`)),

package/src/playbook-command.mjs

@@ -5,27 +5,30 @@ import { pathToFileURL } from 'node:url';
 import { cliText } from './i18n.mjs';
 import { resolveLauncherAssets } from './repo-assets.mjs';
 
-const usage = () => cliText('cli.playbook.help.usage');
+const usage = () => `${cliText('cli.playbook.help.usage')}\n${cliText('cli.playbook.template.usage')}`;
 const safeChannel = value => typeof value === 'string' && value.trim() && value.length <= 64
     && value !== '.' && !value.includes('..') && !/[/\\<>:"|?*\x00-\x1f]/.test(value);
 
 function parse(args) {
     const action = args[0];
     if (action === '--help' || action === '-h' || args.includes('--help') || args.includes('-h')) return { action: 'help' };
-    if (!['list', 'apply'].includes(action)) throw new Error(usage());
-    const result = { action, id: action === 'apply' ? args[1] : null };
+    if (!['list', 'apply', 'template'].includes(action)) throw new Error(usage());
+    const result = { action, id: action === 'apply' ? args[1] : null, project: action === 'template' ? args[1] : null };
     if (action === 'apply' && (!result.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(result.id))) throw new Error(usage());
-    for (let i = action === 'apply' ? 2 : 1; i < args.length; i++) {
+    if (action === 'template' && !result.project) throw new Error(usage());
+    for (let i = action === 'apply' || action === 'template' ? 2 : 1; i < args.length; i++) {
         const arg = args[i];
         if ((action === 'list' && arg === '--json') || (action === 'apply' && arg === '--dry-run')) {
             result[arg.slice(2).replace('-', '')] = true;
         } else if ((action === 'list' && ['--category', '--tag', '--channel'].includes(arg))
-            || (action === 'apply' && arg === '--into')) {
+            || (action === 'apply' && arg === '--into')
+            || (action === 'template' && ['--item', '--id', '--name', '--out', '--license-own'].includes(arg))) {
             if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error(usage());
             result[arg.slice(2)] = args[++i];
         } else throw new Error(usage());
     }
     if (action === 'apply' && !result.into) throw new Error(usage());
+    if (action === 'template' && (!result.item || !result.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(result.id))) throw new Error(usage());
     if (result.channel && !safeChannel(result.channel)) throw new Error(usage());
     return result;
 }
@@ -41,9 +44,16 @@ export async function runPlaybookCommand(args, options = {}) {
         const env = options.env ?? process.env;
         const cwd = options.cwd ?? process.cwd();
         const assets = options.assets ?? resolveLauncherAssets();
+        const akariHome = env.AKARI_HOME || path.join(options.home ?? os.homedir(), '.akari');
         if (!assets.scaffoldModulePath) throw new Error(cliText('cli.playbook.error.scaffoldMissing'));
         const scaffold = await import(pathToFileURL(assets.scaffoldModulePath).href);
-        const akariHome = env.AKARI_HOME || path.join(options.home ?? os.homedir(), '.akari');
+        if (parsed.action === 'template') {
+            const result = await scaffold.exportPlaybookTemplate({ projectDir: path.resolve(cwd, parsed.project),
+                itemId: parsed.item, id: parsed.id, name: parsed.name, out: parsed.out ?? path.join(akariHome, 'playbooks'),
+                licenseOwn: parsed['license-own'] });
+            log(result.dir);
+            return { exitCode: 0, ...result };
+        }
         const projectDir = parsed.into ? path.resolve(cwd, parsed.into) : null;
         let root = null;
         if (assets.creatorRootModulePath) {

package/src/recipe-command.mjs

@@ -0,0 +1,128 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { cliText } from './i18n.mjs';
+import { resolveLauncherAssets } from './repo-assets.mjs';
+
+const KIND_CAPABILITIES = Object.freeze({
+  image: ['image-generation'], video: ['video-generation'], music: ['music-generation'],
+  tts: ['speech-synthesis'], sns: ['publish']
+});
+const idPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+
+function parse(args) {
+  if (args.length === 0 || ['--help', '-h'].includes(args[0])) return { action: 'help' };
+  const action = args[0];
+  if (!['list', 'plan'].includes(action)) throw new Error(cliText('cli.recipe.help.usage'));
+  const id = action === 'plan' ? args[1] : null;
+  if (action === 'plan' && !idPattern.test(id ?? '')) throw new Error(cliText('cli.recipe.help.usage'));
+  const parsed = { action, id, json: false, project: null };
+  for (let i = action === 'plan' ? 2 : 1; i < args.length; i++) {
+    if (args[i] === '--json' && !parsed.json) parsed.json = true;
+    else if (args[i] === '--project' && !parsed.project && args[i + 1] && !args[i + 1].startsWith('-')) parsed.project = args[++i];
+    else throw new Error(cliText('cli.recipe.help.usage'));
+  }
+  return parsed;
+}
+
+async function readJson(file) {
+  return JSON.parse(await fs.readFile(file, 'utf8'));
+}
+
+function akariHome(options) {
+  const env = options.env ?? process.env;
+  return env.AKARI_HOME || path.join(options.home ?? env.HOME ?? os.homedir(), '.akari');
+}
+
+export async function listRecipes({ projectDir, home, schemasDir }) {
+  const { validateAkariRecipe } = await import(pathToFileURL(path.join(schemasDir, 'validate-akari-recipe.mjs')).href);
+  const result = new Map();
+  for (const [source, shelf] of [['project', path.join(projectDir, 'recipes')], ['local', path.join(home, 'tool-recipes')]]) {
+    let entries;
+    try { entries = await fs.readdir(shelf, { withFileTypes: true }); }
+    catch (error) { if (error.code === 'ENOENT') continue; throw error; }
+    for (const entry of entries) {
+      if (!idPattern.test(entry.name) || result.has(entry.name)) continue;
+      const file = path.join(shelf, entry.name, 'recipe.json');
+      let recipe;
+      try { recipe = await readJson(file); }
+      catch (error) { if (error.code === 'ENOENT' || error.code === 'ENOTDIR' || error instanceof SyntaxError) continue; throw error; }
+      if (recipe?.kind !== 'akari-recipe' || recipe.id !== entry.name || !validateAkariRecipe(recipe).ok) continue;
+      result.set(entry.name, { id: recipe.id, name: recipe.name, needs: recipe.needs,
+        source: source === 'local' && entry.isSymbolicLink() ? 'kit' : source, recipe });
+    }
+  }
+  return [...result.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+
+function candidateGates(recipe, provider) {
+  const gates = new Set(recipe.gates);
+  const billing = provider.notes?.billing ?? '';
+  const paidSignal = /(?:paid|purchase|per (?:image|minute|generation|request)|\$|usd|\u6709\u6599|\u8ab2\u91d1|\u5f93\u91cf)/iu.test(billing);
+  const freeSignal = /(?:free|no charge|\u7121\u6599|\u7121\u511f)/iu.test(billing);
+  if (billing && (paidSignal || !freeSignal)) gates.add('paid');
+  if (provider.adapter?.type === 'official-api' || provider.adapter?.type === 'custom'
+    || (!provider.adapter && provider.auth !== 'none')) gates.add('external-send');
+  if (!provider.terms?.checked) gates.add('license');
+  return [...gates];
+}
+
+export function planRecipe(recipe, connections) {
+  const providers = Array.isArray(connections?.providers) ? connections.providers : [];
+  const requirements = recipe.needs.map(capability => {
+    const candidates = providers.filter(provider =>
+      (provider.provides ?? KIND_CAPABILITIES[provider.kind] ?? []).includes(capability))
+      .map(provider => ({ id: provider.id, kind: provider.kind,
+        auth: provider.doctor?.status ?? 'unchecked', gates: candidateGates(recipe, provider) }));
+    return { capability, candidates, ...(candidates.length ? {} : { message: cliText('cli.recipe.plan.noCandidate') }) };
+  });
+  return { id: recipe.id, name: recipe.name, gates: recipe.gates, requirements,
+    missing: requirements.filter(item => item.candidates.length === 0).map(item => item.capability) };
+}
+
+export async function runRecipeCommand(args, options = {}) {
+  const log = options.log ?? console.log;
+  const error = options.error ?? console.error;
+  try {
+    const parsed = parse(args);
+    if (parsed.action === 'help') { log(cliText('cli.recipe.help.usage')); return { exitCode: 0 }; }
+    const projectDir = path.resolve(options.cwd ?? process.cwd(), parsed.project ?? options.projectRoot ?? '.');
+    const assets = options.assets ?? resolveLauncherAssets();
+    const schemasDir = options.schemasDir ?? assets.schemasSourceDir;
+    if (!schemasDir) throw new Error(cliText('cli.recipe.error.schemasMissing'));
+    const recipes = await listRecipes({ projectDir, home: akariHome(options), schemasDir });
+    if (parsed.action === 'list') {
+      const entries = recipes.map(({ recipe, ...entry }) => entry);
+      if (parsed.json) log(JSON.stringify(entries));
+      else for (const entry of entries) log(cliText('cli.recipe.list.row', { id: entry.id, name: entry.name,
+        needs: entry.needs.join(', '), source: entry.source }));
+      return { exitCode: 0, entries };
+    }
+    const selected = recipes.find(entry => entry.id === parsed.id);
+    if (!selected) throw new Error(cliText('cli.recipe.error.notFound', { id: parsed.id }));
+    const projectConnections = path.join(projectDir, '.akari', 'connections.json');
+    let connections;
+    try { connections = await readJson(projectConnections); }
+    catch (cause) {
+      if (cause.code !== 'ENOENT') throw cause;
+      if (!assets.templateDir) throw new Error(cliText('cli.recipe.error.connectionsMissing'));
+      connections = await readJson(path.join(assets.templateDir, '.akari', 'connections.json'));
+    }
+    const plan = planRecipe(selected.recipe, connections);
+    if (parsed.json) log(JSON.stringify(plan));
+    else {
+      log(cliText('cli.recipe.plan.header', { id: plan.id, name: plan.name }));
+      if (plan.gates.length) log(cliText('cli.recipe.plan.recipeGates', { gates: plan.gates.join(', ') }));
+      for (const item of plan.requirements) {
+        if (!item.candidates.length) log(cliText('cli.recipe.plan.missingRow', { capability: item.capability, message: item.message }));
+        else for (const candidate of item.candidates) log(cliText('cli.recipe.plan.row', {
+          capability: item.capability, id: candidate.id,
+          auth: candidate.auth === 'unchecked' ? cliText('cli.recipe.auth.unchecked') : candidate.auth,
+          gates: candidate.gates.join(', ') || cliText('cli.recipe.plan.noGates') }));
+      }
+    }
+    return { exitCode: plan.missing.length ? 1 : 0, plan };
+  } catch (cause) { error(cause.message); return { exitCode: 1 }; }
+}

package/src/status-command.mjs

@@ -11,6 +11,7 @@ import {
 import { describeVersionStatus } from "./messages.mjs";
 import { readCacheSync, readOwnVersion, resolveCachePath, resolveInstalledVersionInfo } from "./update-check.mjs";
 import { resolveRuntimePaths } from "./runtime-diagnostics.mjs";
+import { cliText } from "./i18n.mjs";
 
 export async function runStatusCommand(argv, options = {}) {
   const log = options.log ?? ((line) => process.stdout.write(line));
@@ -48,9 +49,17 @@ export async function runStatusCommand(argv, options = {}) {
 
 export function formatStatusOutput(status) {
   const summary = formatStatusSummary(status);
-  if (status.state_health !== "inconclusive" || status.problems.length === 0) return summary;
+  const activity = [];
+  if (status.automation?.action_count) activity.push(cliText("cli.status.automation.actions", {
+    count: status.automation.action_count, summary: status.automation.latest_action,
+  }));
+  if (status.automation?.pending_gate_count) activity.push(cliText("cli.status.automation.pending", {
+    count: status.automation.pending_gate_count,
+  }));
+  const output = [summary, ...activity].join("\n");
+  if (status.state_health !== "inconclusive" || status.problems.length === 0) return output;
   const problems = status.problems.map((problem) => `  - ${problem}`).join("\n");
-  return `${summary}\nCould not determine:\n${problems}\nNext: run \`akari status --json\` for the full machine-readable report, or resolve the items above and re-run \`akari status\`.`;
+  return `${output}\nCould not determine:\n${problems}\nNext: run \`akari status --json\` for the full machine-readable report, or resolve the items above and re-run \`akari status\`.`;
 }
 
 export function parseStatusArguments(argv, cwd = process.cwd()) {

package/src/status-core/events.mjs

@@ -2,6 +2,10 @@ import { lstatSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import { basename, isAbsolute, join, relative, resolve } from "node:path";
 
 const FINAL_EVENT_TYPES = new Set(["final-acceptance", "final-acceptance-revoked"]);
+const AUTOMATION_GATES = new Set([
+  "publish", "lab-submit", "paid", "external-send", "delete-original",
+  "license", "playbook-checkpoint", "human-asked",
+]);
 
 export function readProjectEvents(projectRoot, { gateTypes = [] } = {}) {
   let realRoot;
@@ -147,6 +151,36 @@ export function resolveActiveAcceptance(events) {
   };
 }
 
+/** Automation requests are separate from milestone gateTypes. Unknown events stay harmless. */
+export function resolveAutomationSummary(events) {
+  const validBase = (payload) => payload.version === 1
+    && isNonEmptyString(payload.id) && isNonEmptyString(payload.occurredAt);
+  const actions = events.filter(({ type, payload }) => type === "agent-action" && validBase(payload)
+    && isNonEmptyString(payload.summary)
+    && !/[\r\n]/u.test(payload.summary)
+    && ["partner", "external", "unattended"].includes(payload.actor)
+    && Array.isArray(payload.files) && payload.files.every(isNonEmptyString));
+  const resolved = new Set(events.filter(({ type, payload }) => type === "gate-resolved"
+    && validBase(payload) && isNonEmptyString(payload.requestId)
+    && ["approved", "declined"].includes(payload.decision) && payload.by === "human")
+    .map(({ payload }) => payload.requestId));
+  const pendingIds = new Set();
+  for (const { type, payload } of events) {
+    if (type === "gate-requested" && validBase(payload)
+      && isNonEmptyString(payload.requestId) && isNonEmptyString(payload.summary)
+      && AUTOMATION_GATES.has(payload.gate)
+      && (payload.detail === undefined || typeof payload.detail === "string")
+      && !resolved.has(payload.requestId)) {
+      pendingIds.add(payload.requestId);
+    }
+  }
+  return {
+    action_count: actions.length,
+    latest_action: actions.at(-1)?.payload.summary ?? null,
+    pending_gate_count: pendingIds.size,
+  };
+}
+
 function validateFinalEventShape(payload, type) {
   if (!FINAL_EVENT_TYPES.has(type)) return null;
   if (!isNonEmptyString(payload.id)) return "has no id";

package/src/status-core/review.mjs

@@ -139,7 +139,9 @@ function validateStroke(stroke, label, problems) {
         && (!Number.isInteger(stroke.frame.cutIndex) || stroke.frame.cutIndex < 0))) {
       problems.push(`${label}.frame is invalid for content-rect`);
     }
-    if (!isNonEmptyString(stroke.sessionRef)) problems.push(`${label}.sessionRef is required for content-rect`);
+    if (hasOwn(stroke, "sessionRef") && !isNonEmptyString(stroke.sessionRef)) {
+      problems.push(`${label}.sessionRef must be non-empty when present`);
+    }
   } else if (hasOwn(stroke, "frame")) {
     problems.push(`${label}.frame is forbidden for ${stroke.space}`);
   }

package/src/status-core/status.mjs

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 
-import { readProjectEvents, resolveActiveAcceptance } from "./events.mjs";
+import { readProjectEvents, resolveActiveAcceptance, resolveAutomationSummary } from "./events.mjs";
 import { resolveProjectDisplayName } from "./display-name.mjs";
 import { inspectFullIntegrity } from "./integrity.mjs";
 import { validateAndCountReview } from "./review.mjs";
@@ -76,6 +76,7 @@ export function resolveProjectStatus(input = process.cwd(), { mode = "fast" } =
   });
   problems.push(...eventProblems);
   const acceptanceState = resolveActiveAcceptance(events);
+  const automation = resolveAutomationSummary(events);
   problems.push(...acceptanceState.problems);
 
   const materials = scaffolded
@@ -120,6 +121,7 @@ export function resolveProjectStatus(input = process.cwd(), { mode = "fast" } =
     waiting_on: routing.waiting_on,
     next_skill: routing.next_skill,
     review: reviewCounts,
+    ...(automation.action_count || automation.pending_gate_count ? { automation } : {}),
     release: { state: releaseState, accepted: false },
     problems: [...new Set(problems)].sort((a, b) => a.localeCompare(b, "en")),
     warnings: [...new Set(warnings)].sort((a, b) => a.localeCompare(b, "en")),

package/src/store-command.mjs

@@ -34,6 +34,7 @@ import {
   ensureKitsMarketplace,
   linkKitAssets,
   linkKitPlaybooks,
+  linkKitRecipes,
   linkKitSkills,
   readKitManifest,
   readKitsLedger,
@@ -630,6 +631,8 @@ export async function runStoreCommand(args, options = {}) {
         }
         const playbookLinks = linkKitPlaybooks(kitDir, manifest, home, { platform: options.platform });
         for (const warning of playbookLinks.warnings) log(cliText('cli.store.install.warning', { warning }));
+        const recipeLinks = linkKitRecipes(kitDir, manifest, home, { platform: options.platform });
+        for (const warning of recipeLinks.warnings) log(cliText('cli.store.install.warning', { warning }));
         registerKitAssets(home, manifest, kitDir, assetLinks.items, env);
         writeKitsLedger(home, {
           id: manifest.id,
@@ -638,6 +641,7 @@ export async function runStoreCommand(args, options = {}) {
           kitDir,
           skills: skillLinks.linked,
           playbooks: playbookLinks.linked,
+          recipes: recipeLinks.linked,
           assets: assetLinks.linked
         });
         ensureKitsMarketplace(home);

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

@@ -95,6 +95,9 @@
     "docs/contract-2026-10-15-script-lines-v0.md",
     "docs/contract-2026-10-16-automation-gates-v0.md",
     "docs/contract-2026-10-16-recipes-and-connectors-v0.md",
+    "docs/contract-2026-10-16-showcase-v0.md",
+    "docs/contract-2026-10-16-template-v0.md",
+    "docs/contract-2026-10-16-vocabulary-v0.md",
     "packages/akari-ear/package.json",
     "packages/akari-ear/README.md",
     "packages/akari-launcher/package.json",

package/vendor/docs/contract-2026-07-20-review-json-v1-annotation-model.md

@@ -92,8 +92,10 @@
 - `target` が `doc:<path>#<block-id>`、`image:<path>`、`canvas:<c-NNNN>` のときだけ
   `sourceT:null` を許容する。動画面では従来どおり 0 以上の source 秒が必要である。
 - `strokes[]` は `{tool:"pen", space, points, ...}` の object。`content-rect` は
-  `frame:{sourceT,cutIndex?}` と `sessionRef` が必須、`image-rect` / `canvas-rect` は
-  `frame` を持たない。後二者の `sessionRef` / `canvasRef` は任意である。
+  `frame:{sourceT,cutIndex?}` が必須。`sessionRef` は録音から作った線だけが持ち、録音なしで
+  プレビューへ直接描いた線では省略する。`image-rect` / `canvas-rect` は `frame` を持たない。
+  `content-rect` / `image-rect` の `sessionRef` と `canvas-rect` の `canvasRef` は
+  いずれも任意である。
 
 実行可能仕様は `packages/schemas/fixtures/review/` に一元化し、`validate-review` と
 `edit-lint` が同じ valid / invalid 全件を消費する。片方だけの専用 fixture で契約差を

package/vendor/docs/contract-2026-08-23-stroke-persistence.md

@@ -73,6 +73,8 @@ review.json の data `version` は 0 のまま据え置く。compile-review-sess
 ```
 
 - `strokeRefs` は `null`、省略、または 1 件以上の配列。欠落は従来データとして正常である。
+- `strokeRefs` は録音の原本への参照なので、録音なしで直接描いた線には付かない。その線は
+  `strokes[].points`（描いた順）がそのまま原本になる。
 - pen は従来どおり最大 100 点の `strokes[].points` も埋め込み、`strokeRefs` から無加工の原本へ
   戻れる。rect は従来どおり `targetKind:"region"` + `region.box` を埋め込み、同じ `strokeRefs`
   から `strokes.json` 内の rect 原本へ戻れる。

package/vendor/docs/contract-2026-10-15-playbook-v0.md

@@ -185,7 +185,7 @@ akari new <target-dir> --from <playbook-dir | id> [--lang <bcp47>]
 
 ## 8. 非スコープ
 
-- 深さ 3（元データごと）。edit.json そのものと素材の実体の配布
+- 深さ 3（元データごと）。edit.json そのものと素材の実体の配布 — **ただし「まとまり 1 つ + その素材」の深さ 3 = テンプレは `contract-2026-10-16-template-v0.md` で範囲内にした（2026-10-16）**
 - Lab での公開・入手・検索・タグ俯瞰・クリエイター登録・還元
 - URL を貼って作り方を起こす分析
 - 画面の最終デザイン（ポップアップの出だしは別の実装票。本契約は形と CLI と確認シートまで）

package/vendor/docs/contract-2026-10-16-recipes-and-connectors-v0.md

@@ -1,5 +1,5 @@
 ---
-lifecycle: draft
+lifecycle: accepted
 created: 2026-10-16
 updated: 2026-10-16
 ---
@@ -7,7 +7,7 @@ updated: 2026-10-16
 # recipes-and-connectors-v0（レシピと接続の 2 層）契約
 
 - 日付: 2026-10-16
-- 状態: **ドラフト・語の裁定待ち**（§6。形と層の分け方は確定方向、「レシピ」の語の割り当てが未裁定）
+- 状態: **accepted**（2026-10-16。語と置き場は §6 の既定で確定。語は後から改名できるよう、ファイルの見分けは `kind` で行う）
 - 前提: `contract-2026-07-14-3d-bake-recipe.md`（道具のレシピ = 正本、焼いた出力 = 再生成できるキャッシュ）/
   `contract-2026-09-13-extension-kit-v0.md`（キットの manifest。v0 の `kind` は `kit` のみ）/
   `packages/schemas/connections.schema.json`（接続の台帳。`kind`: genai / image / video / tts / music / sns / analytics / notify）/
@@ -73,10 +73,17 @@ updated: 2026-10-16
 - 公式の API が無いサービスを非公式に叩くアダプタは**同梱しない**。配る場合は個別に審査する（相手の規約に触れうる）
 - 有償・外部送信は門（`paid` / `external-send`）。どのおまかせ度でも止まる
 - MCP サーバーは作らない（2 種類目のエージェントか外部アプリが要ったとき）。外から叩く口はファイル契約と `akari` の副コマンド
-- 個々のアダプタの実装・レシピの GUI
+- 個々のアダプタの実装・レシピの GUI・レシピの実行エンジン（実行はエージェント）
 
-## 6. 開けた問い（オーナー裁定待ち）
+## 6. 語と置き場（2026-10-16 の既定）
 
-1. **語**: 「レシピ」は既に `contract-2026-07-25-recipe-v0.md`（好みの凍結 `recipe.json`。ドラフト・スキル 2 本が参照）と
-   3D ベイクのレシピで使われている。シチュエーションの層を「レシピ」と呼ぶなら、好みの凍結の側を「好み」などへ改名するか
-2. 置き場: レシピの宣言を キット（`recipes/<id>/recipe.json`）と手元（`~/.akari/…`）のどこに置くか（1 の語が決まってから）
+- 画面の語: シチュエーションの層を **レシピ** と呼ぶ。既存の `contract-2026-07-25-recipe-v0.md` の `recipe.json`
+  （確認済みの好みの凍結。`~/.akari/recipes/<name>.json`）は**そのまま**で、画面では「好みの記憶」と呼ぶ。2 つはファイルの `kind` で見分ける
+  （本契約の宣言は `"kind": "akari-recipe"`。好みの凍結は `kind` を持たない）
+- 置き場（作り方と同じ形の棚）: 手元 = `~/.akari/tool-recipes/<id>/recipe.json`（`~/.akari/recipes/` には置かない）/
+  キット = `recipes/<id>/recipe.json`（キットの manifest に `recipes: [{ "dir": "recipes/<id>" }]`。`akari store install` で手元の棚へ symlink）/
+  プロジェクト = `<project>/recipes/<id>/recipe.json`（そのプロジェクトだけで使うもの）。同じ id はプロジェクト → 手元 → キットの順で先を使う
+- 動詞（CLI）: `akari recipe list [--json]`（棚の一覧）/ `akari recipe plan <id> [--project <dir>]`（要る能力 → 使える接続の候補・
+  止まる門〈`paid` / `external-send` / `terms.checked` が無ければ `license`〉を出す。**実行はしない** — 実行はエージェントがスキルと既存の動詞
+  〈`akari generate` など〉で行い、出力を manifest の tool-output に recipe / connector つきで載せる）
+- 改名するときは、画面の語と CLI の別名を足すだけで、ファイルの `kind` と置き場は変えない