takomi 2.1.39 → 2.1.41

package/plugins/takomi-flow/scripts/lib/agent-plan.mjs

@@ -1,130 +1,140 @@
-import { loadCapabilities } from './capabilities.mjs';
-import { normalizeRequest } from './request.mjs';
-
-export function createAgentPlan(args = {}) {
-  const request = normalizeRequest(args);
-  const capabilities = loadCapabilities();
-  const submit = Boolean(args.submit);
-  const collectTarget = args.targetDir || args['target-dir'];
-  return {
-    schemaVersion: 1,
-    status: 'ready',
-    provider: capabilities.provider,
-    summary: `${request.kind} ${request.mode} Flow job with ${request.variations} variation(s).`,
-    request,
-    gates: gates(request, submit),
-    mcpSequence: mcpSequence(request, { submit, collectTarget }),
-    cliSequence: cliSequence(request, { submit, collectTarget }),
-    expectedOutputs: expectedOutputs(request, collectTarget),
-    nextActions: nextActions(submit, collectTarget),
-  };
-}
-
-function gates(request, submit) {
-  const items = [
-    {
-      name: 'spend',
-      required: submit,
-      satisfied: request.allowSpend,
-      note: 'Generation submission may spend Flow credits and requires allowSpend=true.',
-    },
-    {
-      name: 'browser',
-      required: submit,
-      satisfied: false,
-      note: 'Browser-opening MCP tools require allowBrowser=true at call time.',
-    },
-  ];
-  return submit ? items : items.map(item => ({ ...item, required: false }));
-}
-
-function mcpSequence(request, options) {
-  const workflowArgs = {
-    kind: request.kind,
-    prompt: request.prompt,
-    variations: request.variations,
-    aspectRatio: request.aspectRatio,
-    durationSeconds: request.durationSeconds,
-    mode: request.mode,
-    modelHint: request.modelHint,
-    outputDir: request.outputDir,
-    allowSpend: request.allowSpend,
-    extractFrames: request.extractFrames,
-    sourceAssets: request.sourceAssets,
-    submit: options.submit,
-    allowBrowser: options.submit,
-  };
-  const steps = [
-    { tool: 'takomi_flow_audit', arguments: { outputDir: request.outputDir } },
-    { tool: 'takomi_flow_workflow', arguments: compact(workflowArgs) },
-    { tool: 'takomi_flow_review', arguments: { run: '<run.json|run-dir>', frames: request.extractFrames || 0 } },
-  ];
-  if (options.collectTarget) {
-    steps.push({
-      tool: 'takomi_flow_collect',
-      arguments: {
-        run: '<run.json|run-dir>',
-        targetDir: options.collectTarget,
-        frames: request.extractFrames || 0,
-        includeFrames: true,
-      },
-    });
-  }
-  return steps;
-}
-
-function cliSequence(request, options) {
-  const base = [
-    'node scripts/takomi-flow.mjs audit',
-    `node scripts/takomi-flow.mjs workflow --kind ${request.kind} --prompt "${escapeArg(request.prompt)}"${optionArgs(request, options.submit)}`,
-    `node scripts/takomi-flow.mjs review --run <run.json|run-dir> --frames ${request.extractFrames || 0}`,
-  ];
-  if (options.collectTarget) {
-    base.push(`node scripts/takomi-flow.mjs collect --run <run.json|run-dir> --target-dir "${escapeArg(options.collectTarget)}" --frames ${request.extractFrames || 0} --include-frames`);
-  }
-  return base;
-}
-
-function optionArgs(request, submit) {
-  const args = [];
-  if (request.variations) args.push(`--variations ${request.variations}`);
-  if (request.aspectRatio) args.push(`--aspect-ratio ${request.aspectRatio}`);
-  if (request.durationSeconds) args.push(`--duration ${request.durationSeconds}`);
-  if (request.mode) args.push(`--mode ${request.mode}`);
-  if (request.modelHint) args.push(`--model "${escapeArg(request.modelHint)}"`);
-  if (request.outputDir) args.push(`--output-dir "${escapeArg(request.outputDir)}"`);
-  if (request.extractFrames) args.push(`--extract-frames ${request.extractFrames}`);
-  if (request.sourceAssets.length) args.push(`--assets "${escapeArg(request.sourceAssets.join(','))}"`);
-  if (submit) args.push('--submit --allow-browser --allow-spend');
-  return args.length ? ` ${args.join(' ')}` : '';
-}
-
-function expectedOutputs(request, collectTarget) {
-  const outputs = [
-    `${request.outputDir}/requests/<timestamp>-request.json`,
-    `${request.outputDir}/<runId>/run.json`,
-    `${request.outputDir}/<runId>/downloads/`,
-    `${request.outputDir}/<runId>/assets.json`,
-    `${request.outputDir}/<runId>/report.md`,
-  ];
-  if (request.extractFrames) outputs.push(`${request.outputDir}/<runId>/frames/`);
-  if (collectTarget) outputs.push(`${collectTarget}/takomi-flow-collection.json`);
-  return outputs;
-}
-
-function nextActions(submit, collectTarget) {
-  const actions = ['Run the audit step first and treat missing profile as a bootstrap/login gate.'];
-  if (!submit) actions.push('Use the workflow step without submit to prepare and validate the request without spending credits.');
-  if (submit) actions.push('Confirm the user explicitly approved spending Flow credits before running the submit step.');
-  actions.push('After generation, review run metadata, errors, screenshots, and downloaded assets.');
-  if (collectTarget) actions.push('Collect reviewed outputs into the downstream target folder for pipeline reuse.');
-  return actions;
-}
-
-function compact(value) {
-  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
-}
-
-function escapeArg(value) {
-  return String(value).replaceAll('"', '\\"');
-}
+import { loadCapabilities } from './capabilities.mjs';
+import { normalizeRequest } from './request.mjs';
+
+export function createAgentPlan(args = {}) {
+  const request = normalizeRequest(args);
+  const capabilities = loadCapabilities();
+  const submit = Boolean(args.submit);
+  const collectTarget = args.targetDir || args['target-dir'];
+  return {
+    schemaVersion: 1,
+    status: 'ready',
+    provider: capabilities.provider,
+    summary: `${request.kind} ${request.mode} Flow job with ${request.variations} variation(s).`,
+    request,
+    gates: gates(request, submit),
+    mcpSequence: mcpSequence(request, { submit, collectTarget }),
+    cliSequence: cliSequence(request, { submit, collectTarget }),
+    expectedOutputs: expectedOutputs(request, collectTarget),
+    nextActions: nextActions(submit, collectTarget),
+  };
+}
+
+function gates(request, submit) {
+  const items = [
+    {
+      name: 'spend',
+      required: submit,
+      satisfied: request.allowSpend,
+      note: 'Generation submission may spend Flow credits and requires allowSpend=true.',
+    },
+    {
+      name: 'browser',
+      required: submit,
+      satisfied: false,
+      note: 'Browser-opening MCP tools require allowBrowser=true at call time.',
+    },
+  ];
+  return submit ? items : items.map(item => ({ ...item, required: false }));
+}
+
+function mcpSequence(request, options) {
+  const workflowArgs = {
+    kind: request.kind,
+    prompt: request.prompt,
+    variations: request.variations,
+    aspectRatio: request.aspectRatio,
+    durationSeconds: request.durationSeconds,
+    mode: request.mode,
+    modelHint: request.modelHint,
+    outputDir: request.outputDir,
+    allowSpend: request.allowSpend,
+    extractFrames: request.extractFrames,
+    sourceAssets: request.sourceAssets,
+    projectUrl: request.projectUrl,
+    reuseCurrentProject: request.reuseCurrentProject,
+    allowNewProject: request.allowNewProject,
+    freshChatOnFailure: request.freshChatOnFailure,
+    editorWaitMs: request.editorWaitMs,
+    submit: options.submit,
+    allowBrowser: options.submit,
+  };
+  const steps = [
+    { tool: 'takomi_flow_audit', arguments: { outputDir: request.outputDir } },
+    { tool: 'takomi_flow_workflow', arguments: compact(workflowArgs) },
+    { tool: 'takomi_flow_review', arguments: { run: '<run.json|run-dir>', frames: request.extractFrames || 0 } },
+  ];
+  if (options.collectTarget) {
+    steps.push({
+      tool: 'takomi_flow_collect',
+      arguments: {
+        run: '<run.json|run-dir>',
+        targetDir: options.collectTarget,
+        frames: request.extractFrames || 0,
+        includeFrames: true,
+      },
+    });
+  }
+  return steps;
+}
+
+function cliSequence(request, options) {
+  const base = [
+    'node scripts/takomi-flow.mjs audit',
+    `node scripts/takomi-flow.mjs workflow --kind ${request.kind} --prompt "${escapeArg(request.prompt)}"${optionArgs(request, options.submit)}`,
+    `node scripts/takomi-flow.mjs review --run <run.json|run-dir> --frames ${request.extractFrames || 0}`,
+  ];
+  if (options.collectTarget) {
+    base.push(`node scripts/takomi-flow.mjs collect --run <run.json|run-dir> --target-dir "${escapeArg(options.collectTarget)}" --frames ${request.extractFrames || 0} --include-frames`);
+  }
+  return base;
+}
+
+function optionArgs(request, submit) {
+  const args = [];
+  if (request.variations) args.push(`--variations ${request.variations}`);
+  if (request.aspectRatio) args.push(`--aspect-ratio ${request.aspectRatio}`);
+  if (request.durationSeconds) args.push(`--duration ${request.durationSeconds}`);
+  if (request.mode) args.push(`--mode ${request.mode}`);
+  if (request.modelHint) args.push(`--model "${escapeArg(request.modelHint)}"`);
+  if (request.outputDir) args.push(`--output-dir "${escapeArg(request.outputDir)}"`);
+  if (request.extractFrames) args.push(`--extract-frames ${request.extractFrames}`);
+  if (request.sourceAssets.length) args.push(`--assets "${escapeArg(request.sourceAssets.join(','))}"`);
+  if (request.projectUrl) args.push(`--project-url "${escapeArg(request.projectUrl)}"`);
+  if (request.reuseCurrentProject) args.push('--reuse-current-project');
+  if (request.allowNewProject) args.push('--allow-new-project');
+  if (request.freshChatOnFailure === false) args.push('--fresh-chat-on-failure=false');
+  if (request.editorWaitMs) args.push(`--editor-wait-ms ${request.editorWaitMs}`);
+  if (submit) args.push('--submit --allow-browser --allow-spend');
+  return args.length ? ` ${args.join(' ')}` : '';
+}
+
+function expectedOutputs(request, collectTarget) {
+  const outputs = [
+    `${request.outputDir}/requests/<timestamp>-request.json`,
+    `${request.outputDir}/<runId>/run.json`,
+    `${request.outputDir}/<runId>/downloads/`,
+    `${request.outputDir}/<runId>/assets.json`,
+    `${request.outputDir}/<runId>/report.md`,
+  ];
+  if (request.extractFrames) outputs.push(`${request.outputDir}/<runId>/frames/`);
+  if (collectTarget) outputs.push(`${collectTarget}/takomi-flow-collection.json`);
+  return outputs;
+}
+
+function nextActions(submit, collectTarget) {
+  const actions = ['Run the audit step first and treat missing profile as a bootstrap/login gate.'];
+  if (!submit) actions.push('Use the workflow step without submit to prepare and validate the request without spending credits.');
+  if (submit) actions.push('Confirm the user explicitly approved spending Flow credits before running the submit step.');
+  actions.push('After generation, review run metadata, errors, screenshots, and downloaded assets.');
+  if (collectTarget) actions.push('Collect reviewed outputs into the downstream target folder for pipeline reuse.');
+  return actions;
+}
+
+function compact(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}
+
+function escapeArg(value) {
+  return String(value).replaceAll('"', '\\"');
+}

package/plugins/takomi-flow/scripts/lib/api.mjs

@@ -1,113 +1,113 @@
-import { createPreparedRequest } from './request.mjs';
-import fs from 'node:fs';
-import path from 'node:path';
-import { validateRequestFile } from './request-validator.mjs';
-import { runDoctor } from './doctor.mjs';
-import { loadCapabilities } from './capabilities.mjs';
-import { listTemplates, loadTemplate, writeTemplate } from './templates.mjs';
-import { runSelfTest } from './selftest.mjs';
-import { inspectRun, latestRun, listRuns, resolveRun } from './inspect.mjs';
-import { catalogAssets } from './media.mjs';
-import { observeFlow } from './observe.mjs';
-import { generateFromRequest } from './generation.mjs';
-import { createReport } from './report.mjs';
-import { runWorkflow } from './workflow.mjs';
-import { reviewRun } from './review.mjs';
-import { runAudit } from './audit.mjs';
-import { collectRun } from './collect.mjs';
-import { loadExamples } from './examples.mjs';
-import { createAgentPlan } from './agent-plan.mjs';
-
-export async function doctor(args = {}) {
-  return runDoctor({ profileDir: args.profileDir, outputDir: args.outputDir });
-}
-
-export function capabilities() {
-  return loadCapabilities();
-}
-
-export async function observe(args = {}) {
-  return observeFlow({
-    profileDir: args.profileDir,
-    outputDir: args.outputDir,
-    browserChannel: args.browserChannel,
-    cdpUrl: args.cdpUrl,
-    headless: Boolean(args.headless),
-  });
-}
-
-export function template(args = {}) {
-  if (!args.kind) return { templates: listTemplates() };
-  if (args.outputDir) return writeTemplate(args.kind, args.outputDir);
-  return loadTemplate(args.kind);
-}
-
-export function prepare(args = {}) {
-  const { request, requestPath } = createPreparedRequest(args);
-  return { status: 'prepared', requestPath, request };
-}
-
-export function validate(args = {}) {
-  return validateRequestFile(args.request);
-}
-
-export async function selftest(args = {}) {
-  return runSelfTest({ outputDir: args.outputDir });
-}
-
-export function inspect(args = {}) {
-  return inspectRun(args.run);
-}
-
-export function latest(args = {}) {
-  return latestRun(args.outputDir);
-}
-
-export function runs(args = {}) {
-  return listRuns(args.outputDir, args.limit);
-}
-
-export async function assets(args = {}) {
-  const run = resolveRun(args.run);
-  return catalogAssets(run, assetPathsForRun(run), { frames: args.frames || 0 });
-}
-
-export async function generate(args = {}) {
-  return generateFromRequest(args);
-}
-
-export function report(args = {}) {
-  return createReport(args);
-}
-
-export async function workflow(args = {}) {
-  return runWorkflow(args);
-}
-
-export async function review(args = {}) {
-  return reviewRun(args);
-}
-
-export async function audit(args = {}) {
-  return runAudit(args);
-}
-
-export async function collect(args = {}) {
-  return collectRun(args);
-}
-
-export function examples(args = {}) {
-  return loadExamples(args.name);
-}
-
-export function plan(args = {}) {
-  return createAgentPlan(args);
-}
-
-function assetPathsForRun(run) {
-  if (run.data.assets?.length) return run.data.assets;
-  if (!fs.existsSync(run.downloadsDir)) return [];
-  return fs.readdirSync(run.downloadsDir)
-    .map(name => path.join(run.downloadsDir, name))
-    .filter(filePath => fs.statSync(filePath).isFile());
-}
+import { createPreparedRequest } from './request.mjs';
+import fs from 'node:fs';
+import path from 'node:path';
+import { validateRequestFile } from './request-validator.mjs';
+import { runDoctor } from './doctor.mjs';
+import { loadCapabilities } from './capabilities.mjs';
+import { listTemplates, loadTemplate, writeTemplate } from './templates.mjs';
+import { runSelfTest } from './selftest.mjs';
+import { inspectRun, latestRun, listRuns, resolveRun } from './inspect.mjs';
+import { catalogAssets } from './media.mjs';
+import { observeFlow } from './observe.mjs';
+import { generateFromRequest } from './generation.mjs';
+import { createReport } from './report.mjs';
+import { runWorkflow } from './workflow.mjs';
+import { reviewRun } from './review.mjs';
+import { runAudit } from './audit.mjs';
+import { collectRun } from './collect.mjs';
+import { loadExamples } from './examples.mjs';
+import { createAgentPlan } from './agent-plan.mjs';
+
+export async function doctor(args = {}) {
+  return runDoctor({ profileDir: args.profileDir, outputDir: args.outputDir });
+}
+
+export function capabilities() {
+  return loadCapabilities();
+}
+
+export async function observe(args = {}) {
+  return observeFlow({
+    profileDir: args.profileDir,
+    outputDir: args.outputDir,
+    browserChannel: args.browserChannel,
+    cdpUrl: args.cdpUrl,
+    headless: Boolean(args.headless),
+  });
+}
+
+export function template(args = {}) {
+  if (!args.kind) return { templates: listTemplates() };
+  if (args.outputDir) return writeTemplate(args.kind, args.outputDir);
+  return loadTemplate(args.kind);
+}
+
+export function prepare(args = {}) {
+  const { request, requestPath } = createPreparedRequest(args);
+  return { status: 'prepared', requestPath, request };
+}
+
+export function validate(args = {}) {
+  return validateRequestFile(args.request);
+}
+
+export async function selftest(args = {}) {
+  return runSelfTest({ outputDir: args.outputDir });
+}
+
+export function inspect(args = {}) {
+  return inspectRun(args.run);
+}
+
+export function latest(args = {}) {
+  return latestRun(args.outputDir);
+}
+
+export function runs(args = {}) {
+  return listRuns(args.outputDir, args.limit);
+}
+
+export async function assets(args = {}) {
+  const run = resolveRun(args.run);
+  return catalogAssets(run, assetPathsForRun(run), { frames: args.frames || 0 });
+}
+
+export async function generate(args = {}) {
+  return generateFromRequest(args);
+}
+
+export function report(args = {}) {
+  return createReport(args);
+}
+
+export async function workflow(args = {}) {
+  return runWorkflow(args);
+}
+
+export async function review(args = {}) {
+  return reviewRun(args);
+}
+
+export async function audit(args = {}) {
+  return runAudit(args);
+}
+
+export async function collect(args = {}) {
+  return collectRun(args);
+}
+
+export function examples(args = {}) {
+  return loadExamples(args.name);
+}
+
+export function plan(args = {}) {
+  return createAgentPlan(args);
+}
+
+function assetPathsForRun(run) {
+  if (run.data.assets?.length) return run.data.assets;
+  if (!fs.existsSync(run.downloadsDir)) return [];
+  return fs.readdirSync(run.downloadsDir)
+    .map(name => path.join(run.downloadsDir, name))
+    .filter(filePath => fs.statSync(filePath).isFile());
+}

package/plugins/takomi-flow/scripts/lib/args.mjs

@@ -1,57 +1,66 @@
-export function parseArgs(argv) {
-  const args = { _: [] };
-  for (let i = 0; i < argv.length; i += 1) {
-    const token = argv[i];
-    if (!token.startsWith('--')) {
-      args._.push(token);
-      continue;
-    }
-    const key = token.slice(2);
-    const next = argv[i + 1];
-    if (!next || next.startsWith('--')) {
-      args[key] = true;
-      continue;
-    }
-    args[key] = next;
-    i += 1;
-  }
-  return args;
-}
-
-export function printUsage() {
-  console.log(`
-TakomiFlow
-
-Usage:
-  node scripts/takomi-flow.mjs bootstrap [--profile-dir <path>] [--browser-channel chrome] [--cdp-url <url>] [--headless]
-  node scripts/takomi-flow.mjs doctor [--profile-dir <path>] [--output-dir <path>]
-  node scripts/takomi-flow.mjs audit [--profile-dir <path>] [--output-dir <path>]
-  node scripts/takomi-flow.mjs capabilities
-  node scripts/takomi-flow.mjs examples [--name <example-name>]
-  node scripts/takomi-flow.mjs trusted-chrome [--port 9222] [--profile-dir <path>] [--chrome-path <path>]
-  node scripts/takomi-flow.mjs plan --kind <video|image> --prompt <text> [--submit --target-dir <path>]
-  node scripts/takomi-flow.mjs observe [--profile-dir <path>] [--output-dir <path>] [--browser-channel chrome] [--cdp-url <url>] [--headless]
-  node scripts/takomi-flow.mjs smoke [--profile-dir <path>] [--output-dir <path>] [--browser-channel chrome] [--cdp-url <url>]
-  node scripts/takomi-flow.mjs prepare --kind <video|image> --prompt <text> [--variations 1]
-  node scripts/takomi-flow.mjs workflow --kind <video|image> --prompt <text> [--submit --allow-browser --allow-spend]
-  node scripts/takomi-flow.mjs template --kind <video|image> [--output-dir <path>]
-  node scripts/takomi-flow.mjs validate --request <path>
-  node scripts/takomi-flow.mjs generate --request <path>
-  node scripts/takomi-flow.mjs selftest [--output-dir <path>]
-  node scripts/takomi-flow.mjs inspect --run <run.json|run-dir>
-  node scripts/takomi-flow.mjs latest [--output-dir <path>]
-  node scripts/takomi-flow.mjs runs [--output-dir <path>] [--limit 20]
-  node scripts/takomi-flow.mjs assets --run <run.json|run-dir> [--frames 4]
-  node scripts/takomi-flow.mjs review --run <run.json|run-dir> [--frames 4]
-  node scripts/takomi-flow.mjs collect --run <run.json|run-dir> --target-dir <path> [--frames 4 --include-frames]
-  node scripts/takomi-flow.mjs report [--run <run.json|run-dir>] [--output-dir <path>]
-
-Spend guard:
-  generation submits only when request allowSpend=true or TAKOMI_FLOW_ALLOW_SPEND=true.
-
-Google login note:
-  If Google says the browser may not be secure, use trusted Chrome attach mode:
-  node scripts/takomi-flow.mjs trusted-chrome
-  Then log in manually and attach with --cdp-url http://127.0.0.1:9222.
-`);
-}
+export function parseArgs(argv) {
+  const args = { _: [] };
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (!token.startsWith('--')) {
+      args._.push(token);
+      continue;
+    }
+    const [key, inlineValue] = token.slice(2).split(/=(.*)/s, 2);
+    if (inlineValue !== undefined) {
+      args[key] = inlineValue;
+      continue;
+    }
+    const next = argv[i + 1];
+    if (!next || next.startsWith('--')) {
+      args[key] = true;
+      continue;
+    }
+    args[key] = next;
+    i += 1;
+  }
+  return args;
+}
+
+export function printUsage() {
+  console.log(`
+TakomiFlow
+
+Usage:
+  node scripts/takomi-flow.mjs bootstrap [--profile-dir <path>] [--browser-channel chrome] [--cdp-url <url>] [--headless]
+  node scripts/takomi-flow.mjs doctor [--profile-dir <path>] [--output-dir <path>]
+  node scripts/takomi-flow.mjs audit [--profile-dir <path>] [--output-dir <path>]
+  node scripts/takomi-flow.mjs capabilities
+  node scripts/takomi-flow.mjs examples [--name <example-name>]
+  node scripts/takomi-flow.mjs trusted-chrome [--port 9222] [--profile-dir <path>] [--chrome-path <path>]
+  node scripts/takomi-flow.mjs plan --kind <video|image> --prompt <text> [--submit --target-dir <path>]
+  node scripts/takomi-flow.mjs observe [--profile-dir <path>] [--output-dir <path>] [--browser-channel chrome] [--cdp-url <url>] [--headless]
+  node scripts/takomi-flow.mjs smoke [--profile-dir <path>] [--output-dir <path>] [--browser-channel chrome] [--cdp-url <url>]
+  node scripts/takomi-flow.mjs prepare --kind <video|image> --prompt <text> [--variations 1]
+  node scripts/takomi-flow.mjs workflow --kind <video|image> --prompt <text> [--project-url <url>] [--reuse-current-project] [--allow-new-project] [--submit --allow-browser --allow-spend]
+  node scripts/takomi-flow.mjs template --kind <video|image> [--output-dir <path>]
+  node scripts/takomi-flow.mjs validate --request <path>
+  node scripts/takomi-flow.mjs generate --request <path> [--project-url <url>] [--reuse-current-project] [--allow-new-project]
+  node scripts/takomi-flow.mjs selftest [--output-dir <path>]
+  node scripts/takomi-flow.mjs inspect --run <run.json|run-dir>
+  node scripts/takomi-flow.mjs latest [--output-dir <path>]
+  node scripts/takomi-flow.mjs runs [--output-dir <path>] [--limit 20]
+  node scripts/takomi-flow.mjs assets --run <run.json|run-dir> [--frames 4]
+  node scripts/takomi-flow.mjs review --run <run.json|run-dir> [--frames 4]
+  node scripts/takomi-flow.mjs collect --run <run.json|run-dir> --target-dir <path> [--frames 4 --include-frames]
+  node scripts/takomi-flow.mjs report [--run <run.json|run-dir>] [--output-dir <path>]
+
+Spend guard:
+  generation submits only when request allowSpend=true or TAKOMI_FLOW_ALLOW_SPEND=true.
+
+Google login note:
+  If Google says the browser may not be secure, use trusted Chrome attach mode:
+  node scripts/takomi-flow.mjs trusted-chrome
+  Then log in manually and attach with --cdp-url http://127.0.0.1:9222.
+
+Project reuse:
+  Pass --project-url or attach Chrome while already on a Flow project. TakomiFlow will not click
+  New project unless --allow-new-project is set. Use --fresh-chat-on-failure=false to disable
+  same-project chat recovery.
+`);
+}