editorbrain 0.31.0 → 0.34.0

package/bin/editorbrain.mjs

@@ -1,9 +1,5 @@
 #!/usr/bin/env node
 
-// packages/cli/src/sfx.ts
-import { readdir as readdir2, lstat as lstat3 } from "node:fs/promises";
-import { join as join2, extname as extname2, basename } from "node:path";
-
 // packages/core/src/creative-direction.ts
 var creativePreferenceSections = [
   { id: "brand", title: "Marca y tipograf\xEDa", question: "\xBFConservamos tus colores, fuentes e idioma, o quieres ajustarlos?" },
@@ -57125,13 +57121,6 @@ function canonicalFiles(files) {
   return result2;
 }
 
-// packages/cli/src/media-runtime.ts
-import { spawn } from "node:child_process";
-import { createHash } from "node:crypto";
-import { constants } from "node:fs";
-import { lstat, open, realpath } from "node:fs/promises";
-import { dirname, extname, parse, resolve } from "node:path";
-
 // packages/cli/src/errors.ts
 var CliError = class extends Error {
   constructor(code, message, hint, retryable = false, details = {}) {
@@ -57154,7 +57143,346 @@ function errorOutput(error) {
   return { error: safe, code: "COMMAND_FAILED", retryable: false, hint: "Read the command help and run editorbrain doctor. Do not retry writes blindly." };
 }
 
+// packages/cli/src/production-output.ts
+import { constants as constants2 } from "node:fs";
+import { mkdir as mkdir2, open as open2 } from "node:fs/promises";
+import { dirname as dirname2 } from "node:path";
+
+// packages/cli/src/io.ts
+import { constants } from "node:fs";
+import { lstat, mkdir, open, readdir, realpath, rename, unlink, link } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { randomUUID } from "node:crypto";
+async function ensureRoot(directory, create = false) {
+  const root = resolve(directory);
+  if (create) await mkdir(root, { recursive: true });
+  const info = await lstat(root);
+  if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("Workspace root must be a real directory, not a symlink");
+  return realpath(root);
+}
+async function checkedPath(root, path, document2 = true) {
+  if (document2) safeDocumentPath(path);
+  const target = resolve(root, path);
+  const rel = relative(root, target);
+  if (!rel || rel.startsWith(`..${sep}`) || rel === ".." || resolve(path) === path) throw new Error("Path escapes workspace");
+  let cursor = root;
+  for (const segment of rel.split(sep)) {
+    cursor = join(cursor, segment);
+    try {
+      const info = await lstat(cursor);
+      if (info.isSymbolicLink()) throw new Error(`Symlinks are not allowed: ${path}`);
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+  }
+  return target;
+}
+async function readText(root, path, document2 = true) {
+  const target = await checkedPath(root, path, document2);
+  const handle = await open(target, constants.O_RDONLY | constants.O_NOFOLLOW);
+  try {
+    const info = await handle.stat();
+    if (!info.isFile()) throw new Error(`Not a regular file: ${path}`);
+    if (document2 && info.size > MAX_DOCUMENT_BYTES) throw new Error(`Document exceeds 128 KiB: ${path}`);
+    return new TextDecoder("utf-8", { fatal: true }).decode(await handle.readFile());
+  } finally {
+    await handle.close();
+  }
+}
+async function atomicWrite(root, path, content, options = {}) {
+  const target = await checkedPath(root, path, options.document ?? true);
+  await mkdir(dirname(target), { recursive: true });
+  await checkedPath(root, path, options.document ?? true);
+  const temporary = join(dirname(target), `.eh-${randomUUID()}.tmp`);
+  const handle = await open(temporary, "wx", options.mode ?? 420);
+  try {
+    await handle.writeFile(content, "utf8");
+    await handle.close();
+    await checkedPath(root, path, options.document ?? true);
+    if (options.overwrite === false) {
+      await link(temporary, target);
+      await unlink(temporary);
+    } else await rename(temporary, target);
+  } catch (error) {
+    await handle.close().catch(() => {
+    });
+    await unlink(temporary).catch(() => {
+    });
+    throw error;
+  }
+}
+async function readWorkspace(root) {
+  const files = /* @__PURE__ */ Object.create(null);
+  async function walk(path) {
+    const directory = await checkedPath(root, path, false);
+    let entries;
+    try {
+      entries = await readdir(directory, { withFileTypes: true });
+    } catch (error) {
+      if (error.code === "ENOENT") return;
+      throw error;
+    }
+    for (const entry of entries) {
+      const child = `${path}/${entry.name}`;
+      if (entry.isSymbolicLink()) throw new Error(`Symlinks are not allowed: ${child}`);
+      if (entry.name.startsWith(".")) continue;
+      if (entry.isDirectory()) {
+        if (path.startsWith("videos/") && ["assets", "renders"].includes(entry.name)) continue;
+        await walk(child);
+      } else if (entry.isFile() && /\.(json|md)$/.test(entry.name)) {
+        safeDocumentPath(child);
+        files[child] = await readText(root, child);
+      }
+    }
+  }
+  await walk(".editorharness");
+  await walk(".editorbrain");
+  await walk("videos");
+  return canonicalFiles(files);
+}
+async function readProjectWorkspace(root, projectId) {
+  assertIdentifier(projectId);
+  const projectPath = `videos/${projectId}/project.json`;
+  const projectContent = await readText(root, projectPath);
+  const checked = validateDocument(projectPath, projectContent);
+  if (!checked.valid) throw new ValidationError(checked.issues);
+  const project = JSON.parse(projectContent);
+  const files = { [projectPath]: projectContent };
+  for (const path of /* @__PURE__ */ new Set([...projectSources(project), ...optionalProjectSources(project)])) {
+    if (path === projectPath) continue;
+    const aliases2 = path.startsWith(".editorbrain/") ? [path, path.replace(/^\.editorbrain\//, ".editorharness/")] : [path];
+    for (const alias of aliases2) {
+      try {
+        files[alias] = await readText(root, alias);
+      } catch (error) {
+        if (error.code !== "ENOENT") throw error;
+      }
+    }
+  }
+  if (await readText(root, projectPath) !== projectContent) throw new Error("The selected project changed while reading its context. Retry before editing.");
+  return canonicalFiles(files);
+}
+
+// packages/cli/src/production-output.ts
+async function productionOutputPath(root, relativePath) {
+  if (!relativePath.startsWith(".editorbrain-local/") || relativePath.split(/[\\/]/).some((p) => !p || p === ".." || p === ".") || /[\\\x00-\x1f\x7f]/.test(relativePath)) {
+    throw new CliError("LOCAL_OUTPUT_REQUIRED", "Production output must be inside .editorbrain-local/.", "Use --out .editorbrain-local/<project>/inventory.json, or omit --out for JSON stdout. These reports are not synced.");
+  }
+  return checkedPath(root, relativePath, false);
+}
+async function prepareSampleDirectory(root, path) {
+  const target = await productionOutputPath(root, path);
+  await mkdir2(dirname2(target), { recursive: true });
+  await productionOutputPath(root, path);
+  return target;
+}
+async function readProductionJson(root, path) {
+  const target = await checkedPath(root, path, false);
+  const handle = await open2(target, constants2.O_RDONLY | constants2.O_NOFOLLOW | constants2.O_NONBLOCK);
+  try {
+    const stat = await handle.stat();
+    if (!stat.isFile() || stat.size > 16 * 1024 * 1024) throw new CliError("INVALID_REPORT", "Expected a regular JSON file of at most 16 MiB.", "Select a local inventory, plan or check profile.");
+    return JSON.parse(await handle.readFile("utf8"));
+  } finally {
+    await handle.close();
+  }
+}
+async function saveProductionReport(root, path, report) {
+  const target = await productionOutputPath(root, path);
+  if (!path.endsWith(".json")) throw new CliError("INVALID_ARGUMENT", "Report output needs a .json extension.", "Use a new path under .editorbrain-local/.");
+  await atomicWrite(root, path, stableJson(report), { document: false, overwrite: false, mode: 384 });
+  return target;
+}
+function summarizeProductionReport(value) {
+  const r = value;
+  const base = { schemaVersion: r.schemaVersion, kind: r.kind, summary: true, mediaUploaded: false, quality: "not_assessed" };
+  if (r.kind === "editorbrain.media-inventory") return {
+    ...base,
+    complete: r.complete,
+    contentReviewed: false,
+    counts: { assets: r.assets.length, failures: r.failures.length, skipped: r.skipped.length },
+    assets: r.assets.slice(0, 8),
+    failures: r.failures.slice(0, 5),
+    omitted: { assets: Math.max(0, r.assets.length - 8), failures: Math.max(0, r.failures.length - 5), skipped: r.skipped.length },
+    next: "Inspect selected source content. Use media sample for specific frames. Read the saved report or rerun with --details for omitted metadata; no content was reviewed automatically."
+  };
+  if (r.kind === "editorbrain.media-samples") return { ...base, sourceSha256: r.source.sha256, frames: r.frames, contentReviewed: false, next: "View these frames to inspect composition. They do not prove motion or sound." };
+  if (r.kind === "editorbrain.production-plan-check") return {
+    ...base,
+    valid: r.valid,
+    inventoryComplete: r.inventoryComplete,
+    observations: r.observations,
+    sourceFilesReverified: false,
+    counts: { sources: r.coverage.length, findings: r.findings.length, repeatedPairs: r.repeatedPairs ?? 0 },
+    findings: [...r.findings].sort((a, b) => ({ error: 0, warning: 1, info: 2 })[a.severity] - { error: 0, warning: 1, info: 2 }[b.severity]).slice(0, 8),
+    omittedFindings: Math.max(0, r.findings.length - 8),
+    next: "Review source reuse and inspection gaps in the saved report. Observations are agent-declared, not independently certified."
+  };
+  if (r.kind === "editorbrain.render-check") return {
+    ...base,
+    complete: r.complete,
+    technicalStatus: r.technicalStatus,
+    file: r.file,
+    checks: r.checks,
+    findings: r.findings.slice(0, 8),
+    findingsSummary: r.findingsSummary,
+    omittedFindings: Math.max(0, r.findings.length - 8),
+    next: "Reconcile technical candidates with the brief; inspect the actual video/audio. Technical checks do not assess narrative, aesthetics or SFX audibility."
+  };
+  if (r.kind === "editorbrain.media-source-search") return {
+    ...base,
+    complete: r.complete,
+    results: r.results.slice(0, 5).map((item) => ({ provider: item.provider, id: item.id.slice(0, 180), title: item.title.slice(0, 180), sourceUrl: item.sourceUrl.length <= 1500 ? item.sourceUrl : null, author: item.author?.slice(0, 120) ?? null, license: { id: item.license.id, reason: item.license.reason, url: item.license.url && item.license.url.length <= 500 ? item.license.url : null }, contentReviewed: false, rightsVerified: false })),
+    metadataAbbreviated: true,
+    failures: r.failures.slice(0, 5),
+    counts: r.counts,
+    omitted: { results: Math.max(0, r.results.length - 5), failures: Math.max(0, r.failures.length - 5) },
+    searchExhaustive: false,
+    rightsVerified: false,
+    next: "Inspect relevant source pages and media. These archives supplement web image/video search; empty results do not prove absence on the internet."
+  };
+  if (r.kind === "editorbrain.evidence-check") return {
+    ...base,
+    valid: r.valid,
+    inventoryComplete: r.inventoryComplete,
+    observations: r.observations,
+    sourceFilesReverified: false,
+    factualTruth: "not_assessed",
+    reuseRights: "not_assessed",
+    findings: r.findings.slice(0, 8),
+    omitted: { findings: Math.max(0, r.findings.length - 8) }
+  };
+  if (r.kind === "editorbrain.audio-check") return {
+    ...base,
+    complete: r.complete,
+    technicalStatus: r.technicalStatus,
+    file: r.file,
+    fileStable: r.fileStable,
+    coverage: r.coverage,
+    measurements: r.measurements.slice(0, 8),
+    errorCode: r.errorCode,
+    creativeQuality: r.creativeQuality,
+    omitted: { measurements: Math.max(0, r.measurements.length - 8) },
+    next: "Measurements describe this exact file. Listen for intelligibility, pronunciation, SFX and sync when the modality is available."
+  };
+  if (r.kind === "editorbrain.motion-review") return {
+    ...base,
+    samples: r.samples ? { frameCount: r.samples.frameCount, fps: r.samples.fps, radiusFrames: r.samples.radiusFrames, samples: r.samples.samples.slice(0, 12), omittedSamples: Math.max(0, r.samples.samples.length - 12) } : null,
+    geometryReviews: r.geometryReviews.slice(0, 3).map((g) => ({ scope: g.scope, status: g.status, candidates: g.candidates.slice(0, 8), omittedCandidates: Math.max(0, g.candidates.length - 8), checks: g.checks })),
+    omittedGeometryReviews: Math.max(0, r.geometryReviews.length - 3),
+    next: "This plans samples and checks declared boxes only. Render/view those frames; read saved details for omitted candidates and intentional overlaps."
+  };
+  throw new CliError("INVALID_REPORT", "Unknown production report kind.", "Use media inventory/sample or production check/plan-check.");
+}
+
+// packages/cli/src/editing-batches.ts
+async function batchCommand(client, root, command, argument, flags) {
+  const fail2 = () => {
+    throw new CliError(
+      "INVALID_ARGUMENT",
+      "Use batches list/get/create/pause/resume/cancel/retry/detach/claim/renew/release/attention.",
+      "Create with --file batch.json; updates need --expected-revision; leases need --project and --lease-token UUID."
+    );
+  };
+  const lease = ["claim", "renew", "release", "attention"].includes(command), update = ["pause", "resume", "cancel", "retry", "detach"].includes(command);
+  if (!["list", "get", "create"].includes(command) && !lease && !update) fail2();
+  const allowed = [
+    "dir",
+    "url",
+    ...command === "create" ? ["file"] : command === "list" ? ["after"] : lease ? ["project", "lease-token"] : update ? [
+      "expected-revision",
+      ...["retry", "detach"].includes(command) ? ["project"] : []
+    ] : []
+  ];
+  for (const key of Object.keys(flags)) if (!allowed.includes(key)) fail2();
+  if (command === "list") {
+    if (argument) fail2();
+    return client.request(
+      "/v1/batches" + (typeof flags.after === "string" ? "?after=" + encodeURIComponent(flags.after) : "")
+    );
+  }
+  if (command === "create") {
+    if (argument || typeof flags.file !== "string") fail2();
+    const body = await readProductionJson(root, flags.file);
+    return client.request("/v1/batches", { method: "POST", body });
+  }
+  if (!argument || !/^[a-f0-9-]{36}$/i.test(argument)) fail2();
+  const path = "/v1/batches/" + argument;
+  if (command === "get") return client.request(path);
+  if (update) {
+    const revision = Number(flags["expected-revision"]);
+    if (!Number.isSafeInteger(revision) || revision < 1 || ["retry", "detach"].includes(command) && typeof flags.project !== "string")
+      fail2();
+    return client.request(path, {
+      method: "POST",
+      body: {
+        action: command,
+        expectedRevision: revision,
+        ...["retry", "detach"].includes(command) ? { projectId: flags.project } : {}
+      }
+    });
+  }
+  if (typeof flags.project !== "string" || !/^[a-z0-9][a-z0-9_-]{0,79}$/.test(flags.project) || typeof flags["lease-token"] !== "string" || !/^[a-f0-9-]{36}$/i.test(flags["lease-token"]))
+    fail2();
+  return client.request(path + "/lease", {
+    method: "POST",
+    body: {
+      action: command,
+      projectId: flags.project,
+      leaseToken: flags["lease-token"]
+    }
+  });
+}
+
+// packages/cli/src/project-progress-client.ts
+async function projectProgressCommand(client, command, flags) {
+  const fail2 = (message) => {
+    throw new CliError(
+      "INVALID_ARGUMENT",
+      message,
+      "Use projects progress/start/queue/complete --project ID. Read progress first; pass --expected-version HASH for changes."
+    );
+  };
+  if (!["progress", "start", "queue", "complete"].includes(command))
+    fail2("Unknown project command.");
+  const allowed = [
+    "project",
+    "url",
+    "dir",
+    ...command === "progress" ? [] : ["expected-version"],
+    ...command === "complete" ? ["revision", "user-confirmed"] : []
+  ];
+  for (const name of Object.keys(flags))
+    if (!allowed.includes(name)) fail2(`Unsupported flag --${name}.`);
+  if (typeof flags.project !== "string") fail2("--project is required.");
+  const project = assertIdentifier(flags.project), path = `/v1/projects/${encodeURIComponent(project)}/progress`;
+  if (command === "progress") return client.request(path);
+  if (typeof flags["expected-version"] !== "string" || !/^[a-f0-9]{64}$/.test(flags["expected-version"]))
+    fail2("--expected-version must be the current progress version.");
+  if (command === "complete" && (typeof flags.revision !== "string" || !/^[a-f0-9-]{36}$/.test(flags.revision) || flags["user-confirmed"] !== true))
+    fail2(
+      "Completion requires --revision UUID and --user-confirmed after explicit final-video approval."
+    );
+  return client.request(path, {
+    method: "POST",
+    body: {
+      action: command,
+      expectedVersion: flags["expected-version"],
+      ...command === "complete" ? { revisionId: flags.revision, userConfirmed: true } : {}
+    }
+  });
+}
+
+// packages/cli/src/sfx.ts
+import { readdir as readdir2, lstat as lstat3 } from "node:fs/promises";
+import { join as join2, extname as extname2, basename } from "node:path";
+
 // packages/cli/src/media-runtime.ts
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { constants as constants3 } from "node:fs";
+import { lstat as lstat2, open as open3, realpath as realpath2 } from "node:fs/promises";
+import { dirname as dirname3, extname, parse, resolve as resolve2 } from "node:path";
 var MediaToolError = class extends CliError {
   constructor(code, message) {
     super(code, message, code === "MEDIA_TOOL_NOT_FOUND" ? "Install FFmpeg/FFprobe separately and make them available on PATH; no account or model is needed." : "Review the local input and reported limit. An incomplete check does not validate the media.");
@@ -57206,24 +57534,24 @@ function resolveLocalMediaPath(value) {
   if (!value || value.includes("\0") || /[\r\n]/.test(value) || /^[a-z][a-z\d+.-]*:/i.test(value) && !(process.platform === "win32" && /^[a-z]:[\\/]/i.test(value)) || value.startsWith("\\\\")) {
     throw new MediaToolError("MEDIA_LOCAL_PATH_REQUIRED", "Provide a local filesystem path, not a URL, protocol or network share.");
   }
-  return resolve(value);
+  return resolve2(value);
 }
 async function assertNoMediaSymlinks(value) {
   const path = resolveLocalMediaPath(value);
   let cursor = path;
   while (cursor !== parse(cursor).root) {
-    const info = await lstat(cursor);
+    const info = await lstat2(cursor);
     if (info.isSymbolicLink()) {
-      const systemAlias = process.platform === "darwin" && (cursor === "/tmp" || cursor === "/var") && await realpath(cursor) === `/private${cursor}`;
+      const systemAlias = process.platform === "darwin" && (cursor === "/tmp" || cursor === "/var") && await realpath2(cursor) === `/private${cursor}`;
       if (!systemAlias) throw new MediaToolError("MEDIA_SYMLINK", "Symlink media paths are not followed. Use the original local path.");
     }
-    cursor = dirname(cursor);
+    cursor = dirname3(cursor);
   }
   return path;
 }
 async function assertLocalMediaFile(value) {
   const path = await assertNoMediaSymlinks(value);
-  const info = await lstat(path);
+  const info = await lstat2(path);
   if (!info.isFile()) throw new MediaToolError("MEDIA_NOT_REGULAR", "The media input must be a regular local file.");
   if (!SUPPORTED_MEDIA_EXTENSIONS.has(extname(path).toLowerCase())) throw new MediaToolError("MEDIA_FORMAT_UNSUPPORTED", "This file extension is not supported for local media inspection.");
   return path;
@@ -57308,7 +57636,7 @@ var rate2 = (value) => {
 var sameFile = (a, b) => a.dev === b.dev && a.ino === b.ino && a.size === b.size && a.mtimeMs === b.mtimeMs && a.ctimeMs === b.ctimeMs;
 async function probeLocalMedia(value) {
   const path = await assertLocalMediaFile(value);
-  const handle = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+  const handle = await open3(path, constants3.O_RDONLY | (constants3.O_NOFOLLOW ?? 0));
   try {
     const before = await handle.stat();
     if (!before.isFile()) throw new MediaToolError("MEDIA_NOT_REGULAR", "The media input must be a regular local file.");
@@ -57318,7 +57646,7 @@ async function probeLocalMedia(value) {
     for await (const chunk of handle.createReadStream({ autoClose: false })) hash6.update(chunk);
     const after = await handle.stat();
     await assertNoMediaSymlinks(path);
-    const current2 = await lstat(path);
+    const current2 = await lstat2(path);
     if (!sameFile(before, after) || !sameFile(after, current2)) throw new MediaToolError("MEDIA_FILE_CHANGED", "The media file changed while it was being inspected. Retry with a stable source.");
     let raw;
     try {
@@ -57346,121 +57674,6 @@ async function probeLocalMedia(value) {
   }
 }
 
-// packages/cli/src/io.ts
-import { constants as constants2 } from "node:fs";
-import { lstat as lstat2, mkdir, open as open2, readdir, realpath as realpath2, rename, unlink, link } from "node:fs/promises";
-import { dirname as dirname2, join, relative, resolve as resolve2, sep } from "node:path";
-import { randomUUID } from "node:crypto";
-async function ensureRoot(directory, create = false) {
-  const root = resolve2(directory);
-  if (create) await mkdir(root, { recursive: true });
-  const info = await lstat2(root);
-  if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("Workspace root must be a real directory, not a symlink");
-  return realpath2(root);
-}
-async function checkedPath(root, path, document2 = true) {
-  if (document2) safeDocumentPath(path);
-  const target = resolve2(root, path);
-  const rel = relative(root, target);
-  if (!rel || rel.startsWith(`..${sep}`) || rel === ".." || resolve2(path) === path) throw new Error("Path escapes workspace");
-  let cursor = root;
-  for (const segment of rel.split(sep)) {
-    cursor = join(cursor, segment);
-    try {
-      const info = await lstat2(cursor);
-      if (info.isSymbolicLink()) throw new Error(`Symlinks are not allowed: ${path}`);
-    } catch (error) {
-      if (error.code !== "ENOENT") throw error;
-    }
-  }
-  return target;
-}
-async function readText(root, path, document2 = true) {
-  const target = await checkedPath(root, path, document2);
-  const handle = await open2(target, constants2.O_RDONLY | constants2.O_NOFOLLOW);
-  try {
-    const info = await handle.stat();
-    if (!info.isFile()) throw new Error(`Not a regular file: ${path}`);
-    if (document2 && info.size > MAX_DOCUMENT_BYTES) throw new Error(`Document exceeds 128 KiB: ${path}`);
-    return new TextDecoder("utf-8", { fatal: true }).decode(await handle.readFile());
-  } finally {
-    await handle.close();
-  }
-}
-async function atomicWrite(root, path, content, options = {}) {
-  const target = await checkedPath(root, path, options.document ?? true);
-  await mkdir(dirname2(target), { recursive: true });
-  await checkedPath(root, path, options.document ?? true);
-  const temporary = join(dirname2(target), `.eh-${randomUUID()}.tmp`);
-  const handle = await open2(temporary, "wx", options.mode ?? 420);
-  try {
-    await handle.writeFile(content, "utf8");
-    await handle.close();
-    await checkedPath(root, path, options.document ?? true);
-    if (options.overwrite === false) {
-      await link(temporary, target);
-      await unlink(temporary);
-    } else await rename(temporary, target);
-  } catch (error) {
-    await handle.close().catch(() => {
-    });
-    await unlink(temporary).catch(() => {
-    });
-    throw error;
-  }
-}
-async function readWorkspace(root) {
-  const files = /* @__PURE__ */ Object.create(null);
-  async function walk(path) {
-    const directory = await checkedPath(root, path, false);
-    let entries;
-    try {
-      entries = await readdir(directory, { withFileTypes: true });
-    } catch (error) {
-      if (error.code === "ENOENT") return;
-      throw error;
-    }
-    for (const entry of entries) {
-      const child = `${path}/${entry.name}`;
-      if (entry.isSymbolicLink()) throw new Error(`Symlinks are not allowed: ${child}`);
-      if (entry.name.startsWith(".")) continue;
-      if (entry.isDirectory()) {
-        if (path.startsWith("videos/") && ["assets", "renders"].includes(entry.name)) continue;
-        await walk(child);
-      } else if (entry.isFile() && /\.(json|md)$/.test(entry.name)) {
-        safeDocumentPath(child);
-        files[child] = await readText(root, child);
-      }
-    }
-  }
-  await walk(".editorharness");
-  await walk(".editorbrain");
-  await walk("videos");
-  return canonicalFiles(files);
-}
-async function readProjectWorkspace(root, projectId) {
-  assertIdentifier(projectId);
-  const projectPath = `videos/${projectId}/project.json`;
-  const projectContent = await readText(root, projectPath);
-  const checked = validateDocument(projectPath, projectContent);
-  if (!checked.valid) throw new ValidationError(checked.issues);
-  const project = JSON.parse(projectContent);
-  const files = { [projectPath]: projectContent };
-  for (const path of /* @__PURE__ */ new Set([...projectSources(project), ...optionalProjectSources(project)])) {
-    if (path === projectPath) continue;
-    const aliases2 = path.startsWith(".editorbrain/") ? [path, path.replace(/^\.editorbrain\//, ".editorharness/")] : [path];
-    for (const alias of aliases2) {
-      try {
-        files[alias] = await readText(root, alias);
-      } catch (error) {
-        if (error.code !== "ENOENT") throw error;
-      }
-    }
-  }
-  if (await readText(root, projectPath) !== projectContent) throw new Error("The selected project changed while reading its context. Retry before editing.");
-  return canonicalFiles(files);
-}
-
 // packages/cli/src/production-context.ts
 async function prepareProductionContext(root, projectId, client) {
   const resolved = await resolveProject(await readProjectWorkspace(root, projectId), projectId);
@@ -57561,123 +57774,6 @@ async function remoteSfx(client, subcommand, params) {
 // packages/cli/src/media-preview.ts
 import { chmod, link as link2, mkdtemp, rm } from "node:fs/promises";
 import { dirname as dirname4, join as join3 } from "node:path";
-
-// packages/cli/src/production-output.ts
-import { constants as constants3 } from "node:fs";
-import { mkdir as mkdir2, open as open3 } from "node:fs/promises";
-import { dirname as dirname3 } from "node:path";
-async function productionOutputPath(root, relativePath) {
-  if (!relativePath.startsWith(".editorbrain-local/") || relativePath.split(/[\\/]/).some((p) => !p || p === ".." || p === ".") || /[\\\x00-\x1f\x7f]/.test(relativePath)) {
-    throw new CliError("LOCAL_OUTPUT_REQUIRED", "Production output must be inside .editorbrain-local/.", "Use --out .editorbrain-local/<project>/inventory.json, or omit --out for JSON stdout. These reports are not synced.");
-  }
-  return checkedPath(root, relativePath, false);
-}
-async function prepareSampleDirectory(root, path) {
-  const target = await productionOutputPath(root, path);
-  await mkdir2(dirname3(target), { recursive: true });
-  await productionOutputPath(root, path);
-  return target;
-}
-async function readProductionJson(root, path) {
-  const target = await checkedPath(root, path, false);
-  const handle = await open3(target, constants3.O_RDONLY | constants3.O_NOFOLLOW | constants3.O_NONBLOCK);
-  try {
-    const stat = await handle.stat();
-    if (!stat.isFile() || stat.size > 16 * 1024 * 1024) throw new CliError("INVALID_REPORT", "Expected a regular JSON file of at most 16 MiB.", "Select a local inventory, plan or check profile.");
-    return JSON.parse(await handle.readFile("utf8"));
-  } finally {
-    await handle.close();
-  }
-}
-async function saveProductionReport(root, path, report) {
-  const target = await productionOutputPath(root, path);
-  if (!path.endsWith(".json")) throw new CliError("INVALID_ARGUMENT", "Report output needs a .json extension.", "Use a new path under .editorbrain-local/.");
-  await atomicWrite(root, path, stableJson(report), { document: false, overwrite: false, mode: 384 });
-  return target;
-}
-function summarizeProductionReport(value) {
-  const r = value;
-  const base = { schemaVersion: r.schemaVersion, kind: r.kind, summary: true, mediaUploaded: false, quality: "not_assessed" };
-  if (r.kind === "editorbrain.media-inventory") return {
-    ...base,
-    complete: r.complete,
-    contentReviewed: false,
-    counts: { assets: r.assets.length, failures: r.failures.length, skipped: r.skipped.length },
-    assets: r.assets.slice(0, 8),
-    failures: r.failures.slice(0, 5),
-    omitted: { assets: Math.max(0, r.assets.length - 8), failures: Math.max(0, r.failures.length - 5), skipped: r.skipped.length },
-    next: "Inspect selected source content. Use media sample for specific frames. Read the saved report or rerun with --details for omitted metadata; no content was reviewed automatically."
-  };
-  if (r.kind === "editorbrain.media-samples") return { ...base, sourceSha256: r.source.sha256, frames: r.frames, contentReviewed: false, next: "View these frames to inspect composition. They do not prove motion or sound." };
-  if (r.kind === "editorbrain.production-plan-check") return {
-    ...base,
-    valid: r.valid,
-    inventoryComplete: r.inventoryComplete,
-    observations: r.observations,
-    sourceFilesReverified: false,
-    counts: { sources: r.coverage.length, findings: r.findings.length, repeatedPairs: r.repeatedPairs ?? 0 },
-    findings: [...r.findings].sort((a, b) => ({ error: 0, warning: 1, info: 2 })[a.severity] - { error: 0, warning: 1, info: 2 }[b.severity]).slice(0, 8),
-    omittedFindings: Math.max(0, r.findings.length - 8),
-    next: "Review source reuse and inspection gaps in the saved report. Observations are agent-declared, not independently certified."
-  };
-  if (r.kind === "editorbrain.render-check") return {
-    ...base,
-    complete: r.complete,
-    technicalStatus: r.technicalStatus,
-    file: r.file,
-    checks: r.checks,
-    findings: r.findings.slice(0, 8),
-    findingsSummary: r.findingsSummary,
-    omittedFindings: Math.max(0, r.findings.length - 8),
-    next: "Reconcile technical candidates with the brief; inspect the actual video/audio. Technical checks do not assess narrative, aesthetics or SFX audibility."
-  };
-  if (r.kind === "editorbrain.media-source-search") return {
-    ...base,
-    complete: r.complete,
-    results: r.results.slice(0, 5).map((item) => ({ provider: item.provider, id: item.id.slice(0, 180), title: item.title.slice(0, 180), sourceUrl: item.sourceUrl.length <= 1500 ? item.sourceUrl : null, author: item.author?.slice(0, 120) ?? null, license: { id: item.license.id, reason: item.license.reason, url: item.license.url && item.license.url.length <= 500 ? item.license.url : null }, contentReviewed: false, rightsVerified: false })),
-    metadataAbbreviated: true,
-    failures: r.failures.slice(0, 5),
-    counts: r.counts,
-    omitted: { results: Math.max(0, r.results.length - 5), failures: Math.max(0, r.failures.length - 5) },
-    searchExhaustive: false,
-    rightsVerified: false,
-    next: "Inspect relevant source pages and media. These archives supplement web image/video search; empty results do not prove absence on the internet."
-  };
-  if (r.kind === "editorbrain.evidence-check") return {
-    ...base,
-    valid: r.valid,
-    inventoryComplete: r.inventoryComplete,
-    observations: r.observations,
-    sourceFilesReverified: false,
-    factualTruth: "not_assessed",
-    reuseRights: "not_assessed",
-    findings: r.findings.slice(0, 8),
-    omitted: { findings: Math.max(0, r.findings.length - 8) }
-  };
-  if (r.kind === "editorbrain.audio-check") return {
-    ...base,
-    complete: r.complete,
-    technicalStatus: r.technicalStatus,
-    file: r.file,
-    fileStable: r.fileStable,
-    coverage: r.coverage,
-    measurements: r.measurements.slice(0, 8),
-    errorCode: r.errorCode,
-    creativeQuality: r.creativeQuality,
-    omitted: { measurements: Math.max(0, r.measurements.length - 8) },
-    next: "Measurements describe this exact file. Listen for intelligibility, pronunciation, SFX and sync when the modality is available."
-  };
-  if (r.kind === "editorbrain.motion-review") return {
-    ...base,
-    samples: r.samples ? { frameCount: r.samples.frameCount, fps: r.samples.fps, radiusFrames: r.samples.radiusFrames, samples: r.samples.samples.slice(0, 12), omittedSamples: Math.max(0, r.samples.samples.length - 12) } : null,
-    geometryReviews: r.geometryReviews.slice(0, 3).map((g) => ({ scope: g.scope, status: g.status, candidates: g.candidates.slice(0, 8), omittedCandidates: Math.max(0, g.candidates.length - 8), checks: g.checks })),
-    omittedGeometryReviews: Math.max(0, r.geometryReviews.length - 3),
-    next: "This plans samples and checks declared boxes only. Render/view those frames; read saved details for omitted candidates and intentional overlaps."
-  };
-  throw new CliError("INVALID_REPORT", "Unknown production report kind.", "Use media inventory/sample or production check/plan-check.");
-}
-
-// packages/cli/src/media-preview.ts
 async function prepareMediaPreview(root, file, out, quality = 720, audioStream) {
   if (![720, 1080].includes(quality) || !out.endsWith(".mp4")) throw new CliError("INVALID_ARGUMENT", "Use --quality 720 or 1080 and a new .mp4 output.", "Previews belong under .editorbrain-local/.");
   const source = await probeLocalMedia(await assertLocalMediaFile(file));
@@ -57736,6 +57832,16 @@ async function prepareStudioAudio(root, file, out, streamIndex) {
 // packages/cli/src/client.ts
 import { setTimeout as delay } from "node:timers/promises";
 var searchErrors = {
+  batch_changed: { status: 409, code: "BATCH_CHANGED", hint: "Read batches get before retrying; preserve new changes." },
+  batch_claim_blocked: { status: 409, code: "BATCH_CLAIM_BLOCKED", hint: "Read the batch. Wait for an available slot or reconcile an expired turn; do not start work without a claim." },
+  batch_budget_exceeded: { status: 409, code: "BATCH_BUDGET_EXCEEDED", hint: "Stop generation. The batch or video budget was reached. Do not increase the budget yourself." },
+  batch_not_running: { status: 409, code: "BATCH_NOT_RUNNING", hint: "The batch is paused/cancelled or the turn expired. Read the batch before continuing." },
+  batch_retry_blocked: { status: 409, code: "BATCH_RETRY_BLOCKED", hint: "Inspect existing jobs and outputs before retrying. Do not duplicate a paid request." },
+  batch_project_busy: { status: 409, code: "BATCH_PROJECT_BUSY", hint: "Wait for existing Studio jobs before grouping these projects." },
+  batch_project_taken: { status: 409, code: "BATCH_PROJECT_TAKEN", hint: "Use the project existing batch or create a separate video project." },
+  studio_context_or_lease_changed: { status: 409, code: "STUDIO_CONTEXT_OR_LEASE_CHANGED", hint: "Refresh the workflow and batch lease before generating." },
+  progress_changed: { status: 409, code: "PROGRESS_CHANGED", hint: "Read projects progress --project ID again. Preserve the latest state; never force an old progress version." },
+  final_not_approved: { status: 409, code: "FINAL_NOT_APPROVED", hint: "Review and approve the latest complete video, resolve pending changes, then record explicit final-delivery acceptance." },
   invalid_search_brief: { status: 400, code: "INVALID_SEARCH_BRIEF", hint: "Check references/search-brief.md and the service contract. Older services may reject eventQueries objects with channels. Do not silently remove constraints or retry a changed query as if filtering succeeded." },
   source_inspection_required: { status: 422, code: "SOURCE_INSPECTION_REQUIRED", hint: "Inspect the supplied source and declare only modalities actually reviewed. A script requires script inspection; video requires frames, motion or audio." },
   search_index_not_ready: { status: 503, code: "SEARCH_INDEX_NOT_READY", hint: "No current authorized evidence is indexed. Report the gap; literal library lookup is available but is not semantic retrieval or proof of fit." }
@@ -57835,7 +57941,7 @@ var Client = class {
       const retryAfterMs = retryDelay(response.headers.get("Retry-After"), this.runtime.now());
       if (!response.ok) {
         let errorBody;
-        if (path === "/v1/search/brief" && [400, 422, 503].includes(response.status)) {
+        if ((path.startsWith("/v1/batches") || path === "/v1/studio/jobs") && response.status === 409 || path === "/v1/search/brief" && [400, 422, 503].includes(response.status) || /^\/v1\/projects\/[^/]+\/progress$/.test(path) && response.status === 409) {
           try {
             const diagnostic = searchDiagnostic(response.status, await boundedJson(response, 16 * 1024));
             errorBody = diagnostic ? { error: { code: diagnostic.serviceCode } } : void 0;
@@ -58017,7 +58123,7 @@ ${conflicts.join("\n")}`, "Run pull --dry-run and reconcile the reported paths."
 
 // packages/cli/src/studio.ts
 async function studioCommand(client, root, command, argument, flags) {
-  const allowed = /* @__PURE__ */ new Set(["dir", "url", ...command === "quote" ? ["file"] : command === "run" ? ["max-credits", "user-confirmed"] : []]);
+  const allowed = /* @__PURE__ */ new Set(["dir", "url", ...command === "quote" ? ["file"] : command === "run" ? ["max-credits", "user-confirmed", "batch-lease-token"] : []]);
   for (const flag of Object.keys(flags)) if (!allowed.has(flag)) throw new CliError("INVALID_ARGUMENT", `--${flag} is not supported for studio ${command}.`, "Read editorbrain help.");
   try {
     if (command === "catalog" || command === "jobs") {
@@ -58035,7 +58141,7 @@ async function studioCommand(client, root, command, argument, flags) {
     if (command === "run") {
       const maxCredits = Number(flags["max-credits"]);
       if (flags["user-confirmed"] !== true || !Number.isFinite(maxCredits) || maxCredits <= 0 || maxCredits > 1e4) throw new CliError("SPENDING_APPROVAL_REQUIRED", "Supply --user-confirmed and --max-credits only after the user authorized this quote or budget.", "Preferences and direct editing mode do not authorize spending.");
-      return await client.request("/v1/studio/jobs", { method: "POST", body: { quoteId: argument, maxCredits, userConfirmed: true } });
+      return await client.request("/v1/studio/jobs", { method: "POST", body: { quoteId: argument, maxCredits, userConfirmed: true, ...flags["batch-lease-token"] ? { batchLeaseToken: flags["batch-lease-token"] } : {} } });
     }
     throw new CliError("INVALID_ARGUMENT", "Use studio catalog, quote, run, get or jobs.", "Read editorbrain help.");
   } catch (error) {
@@ -58348,6 +58454,74 @@ var VERIFIED_GUIDANCE_RELEASES = [
       "editorbrain/references/style-creator.md": "1b1bc289a5bc308cbbf7f4d699de2933b8934733a2b69b3e98fb1b7420d986f2",
       "editorbrain/references/workspace-files.md": "cd3006a7cc4f04ff5dfeb1bd901a21c53455017aa7d19fcde9a6e26f1fbbd5b6"
     }
+  },
+  {
+    "version": "0.31.0",
+    "archiveSha256": "34a074361f35b099d673e4f310b566d359bc18ec6f326b055c4e0ce811f07c97",
+    "files": {
+      "editorbrain/AGENTS.md": "2361aaa3202d3f4ea9e941684fbda1a84d9711389cca89f7f6cd3ae03b7ab6d0",
+      "editorbrain/references/audio-production.md": "038504d738db98939aeed14407b15561e4f82c650aace7eb545e77cdffd8dadb",
+      "editorbrain-motion/references/authored-scenes.md": "11109dcd35ab7138fdc18e54605885bb26d9e948f12221e18dea4038987dede2",
+      "editorbrain/references/cli-mcp.md": "3a83731d73dd09b55ee5a250bebd950b5a0daedc2b1c3af23bfc6c36f748d793",
+      "editorbrain-motion/references/code-motion.md": "50382a797adc1e1596086e2408e81ee75ceb6730ca409be9c884646db643a7cd",
+      "editorbrain-motion/references/component-library.md": "e4593622ebe371bba1b1c62f698c6709c36a8d01ddce4a07d40534fca44b797e",
+      "editorbrain/references/editorial-evidence.md": "caf72365b3e7492a62d96b39cd17031fa7c961671ce32bc4649420d8a353a026",
+      "editorbrain/references/first-edit.md": "d71271ab32c6432cce01316917b4504f15411ea59511566a1f6169ac6d09723c",
+      "editorbrain-motion/references/generated-motion.md": "a8d214b53c15f742658abd84f03b768fa2821f8cde94f50aab82a3759a30b36b",
+      "editorbrain/references/integrations.md": "a3500dd79c71ab3ee80a865bb5bf8c94287efb933e07d577738891e276a819a0",
+      "editorbrain/references/local-production.md": "2d170bb217854eda7581f64d8342fffe3b56234bbe56b2715fa93eb3210e6354",
+      "editorbrain/references/media-preferences.md": "d1b92b181fbc226c8d3fda762726dd413944175768651fbfb8200eae44fb2ec8",
+      "editorbrain/references/memory-and-review.md": "2a89d6fc4737b750a380c69630d6fd4f4132aed27656b92e8f0c5748887b70ae",
+      "editorbrain-motion/references/motion-craft.md": "adba1b0cbb3c6327a7665857b0a6d144f97dc843464ccf154d3f76ee3ada905d",
+      "editorbrain/references/motion-review.md": "0fb09a2d61ecd13114ced5cca5daa4580a922cf7d7b3f8698077ceb0e96da6f0",
+      "editorbrain/references/onboarding.md": "875d1b9049c4663780f993c2843528c531a51d6b51380b08ed77d82f618185fb",
+      "editorbrain/references/production-and-review.md": "50f10a98a4f3709a5a585f58e4154f33d6d883b218cd25f3abd72eccc43b15a7",
+      "editorbrain/references/production-continuity.md": "c4b346c9634f3d1ef63b24a97d178e0253c2e45d53f6934076a5417e66e34d9b",
+      "editorbrain/references/real-media.md": "106bee5a34641d53f021ead5d41630d473c2bfc98e4f7ee5500dae837e2e45bb",
+      "editorbrain/references/search-brief.md": "ea2a9c2d5a5cf685c1e5918366901ef2589c4d79aaa78a0dd31e97d6fed42b7b",
+      "editorbrain/references/sfx-library.md": "fa0b02c8765988257e46e16298ecca9cdb0e338a863915e29f831162e237eac4",
+      "editorbrain-motion/SKILL.md": "86617d39341d7325d613b877838258f40f05b4286301dacf8e1ec85ccd502aab",
+      "editorbrain/SKILL.md": "d53070052608fc2535af7cb51bcac2c10097b289450958ca7372cab3fb8364a9",
+      "editorbrain/references/storage-and-previews.md": "8a3057f1c1a2a1e1cd32028059dc897a8461da38c36e812fbd24943d3740b4d5",
+      "editorbrain/references/studio.md": "7a84e43bd72f8590d1a91c7d1bc5f6b60678c1c8eba6523b51b99243e22a1322",
+      "editorbrain/references/style-creator.md": "1b1bc289a5bc308cbbf7f4d699de2933b8934733a2b69b3e98fb1b7420d986f2",
+      "editorbrain/references/workspace-files.md": "18462e7b66ba6204770c654e4a2f7e505c343319671a0447aa55c59f0b9096ec"
+    }
+  },
+  {
+    "version": "0.32.0",
+    "archiveSha256": "30c6c6d97da7de16bb620c0975c2d3f2a4b7a6ea4a56f2eb3c5b0f5f53914f45",
+    "files": {
+      "editorbrain-formats/SKILL.md": "b8b03266a9b7cde8337846144d3032b63b6d9cfbfc4530ae1b06f3dd43074ff2",
+      "editorbrain-formats/references/numbered-tutorial.md": "95754ae7dbfaa678e11ddf1a2b84710dba83a16e2fa4055051bd4f5f4f868a5f",
+      "editorbrain-motion/SKILL.md": "86617d39341d7325d613b877838258f40f05b4286301dacf8e1ec85ccd502aab",
+      "editorbrain-motion/references/authored-scenes.md": "11109dcd35ab7138fdc18e54605885bb26d9e948f12221e18dea4038987dede2",
+      "editorbrain-motion/references/code-motion.md": "50382a797adc1e1596086e2408e81ee75ceb6730ca409be9c884646db643a7cd",
+      "editorbrain-motion/references/component-library.md": "e4593622ebe371bba1b1c62f698c6709c36a8d01ddce4a07d40534fca44b797e",
+      "editorbrain-motion/references/generated-motion.md": "a8d214b53c15f742658abd84f03b768fa2821f8cde94f50aab82a3759a30b36b",
+      "editorbrain-motion/references/motion-craft.md": "adba1b0cbb3c6327a7665857b0a6d144f97dc843464ccf154d3f76ee3ada905d",
+      "editorbrain/AGENTS.md": "2361aaa3202d3f4ea9e941684fbda1a84d9711389cca89f7f6cd3ae03b7ab6d0",
+      "editorbrain/SKILL.md": "b15eb4e2438c0a3e6ec5c3c3170f11c973676d5c6a850cf5d2e9cb3bc7c44e42",
+      "editorbrain/references/audio-production.md": "038504d738db98939aeed14407b15561e4f82c650aace7eb545e77cdffd8dadb",
+      "editorbrain/references/cli-mcp.md": "9febfcac6c1dc763b79ab26ffb07e53bce703cbe4c2332ddcd250e10f2fa75dd",
+      "editorbrain/references/editorial-evidence.md": "caf72365b3e7492a62d96b39cd17031fa7c961671ce32bc4649420d8a353a026",
+      "editorbrain/references/first-edit.md": "d71271ab32c6432cce01316917b4504f15411ea59511566a1f6169ac6d09723c",
+      "editorbrain/references/integrations.md": "a3500dd79c71ab3ee80a865bb5bf8c94287efb933e07d577738891e276a819a0",
+      "editorbrain/references/local-production.md": "2d170bb217854eda7581f64d8342fffe3b56234bbe56b2715fa93eb3210e6354",
+      "editorbrain/references/media-preferences.md": "d1b92b181fbc226c8d3fda762726dd413944175768651fbfb8200eae44fb2ec8",
+      "editorbrain/references/memory-and-review.md": "2a89d6fc4737b750a380c69630d6fd4f4132aed27656b92e8f0c5748887b70ae",
+      "editorbrain/references/motion-review.md": "0fb09a2d61ecd13114ced5cca5daa4580a922cf7d7b3f8698077ceb0e96da6f0",
+      "editorbrain/references/onboarding.md": "875d1b9049c4663780f993c2843528c531a51d6b51380b08ed77d82f618185fb",
+      "editorbrain/references/production-and-review.md": "50f10a98a4f3709a5a585f58e4154f33d6d883b218cd25f3abd72eccc43b15a7",
+      "editorbrain/references/production-continuity.md": "c4b346c9634f3d1ef63b24a97d178e0253c2e45d53f6934076a5417e66e34d9b",
+      "editorbrain/references/real-media.md": "106bee5a34641d53f021ead5d41630d473c2bfc98e4f7ee5500dae837e2e45bb",
+      "editorbrain/references/search-brief.md": "ea2a9c2d5a5cf685c1e5918366901ef2589c4d79aaa78a0dd31e97d6fed42b7b",
+      "editorbrain/references/sfx-library.md": "fa0b02c8765988257e46e16298ecca9cdb0e338a863915e29f831162e237eac4",
+      "editorbrain/references/storage-and-previews.md": "8a3057f1c1a2a1e1cd32028059dc897a8461da38c36e812fbd24943d3740b4d5",
+      "editorbrain/references/studio.md": "7a84e43bd72f8590d1a91c7d1bc5f6b60678c1c8eba6523b51b99243e22a1322",
+      "editorbrain/references/style-creator.md": "1b1bc289a5bc308cbbf7f4d699de2933b8934733a2b69b3e98fb1b7420d986f2",
+      "editorbrain/references/workspace-files.md": "c16fe08b209c65baf8f57054f7cc01f514292fc073b7072298b86c0054da3e19"
+    }
   }
 ];
 function isVerifiedHistoricalGuidance(skillName, relativePath, sha2562) {
@@ -58356,7 +58530,7 @@ function isVerifiedHistoricalGuidance(skillName, relativePath, sha2562) {
 }
 
 // packages/cli/src/agent-guidance.ts
-var BUNDLED_SKILLS = ["editorbrain", "editorbrain-motion"];
+var BUNDLED_SKILLS = ["editorbrain", "editorbrain-motion", "editorbrain-formats"];
 var previousSkillHashes = { "SKILL.md": ["9df2c89deeec30ddf556c359027efe1d90e6b4e9c08717cd8827e210b38a187f", "67b157cb45cae3621e6f2c43235c1d69907ad6abd45ab6b52a3c65f236732db9", "1e2fff65a1b303b18b2d65156bef6eb2439a19d77ba2a25b37bcb1819ff009e3", "dacce1c4127f4281df6f7e1681e243444bb6f8a8e74b829e52ee0108c6672348", "09740ab4b275eada65b5040ae6000104ff39094f534a2784e67feb2afc2a59b3", "f18269ad5504fff8a4fc522d463483261f5041e56cb7f1081f9614bc67e0d96f", "5779a28879313070b0d819771ac967d4a133cff1c3dbda2ec44b4dd2abcb17d1", "30f1e64622e70552a1a6129cacc646f56b09b3d7a1fd3f5bf22299bc6bfd0d1e", "6975d917226f75ad55c67543bf7f1c5ef18f4cfe43426c69400c56c1ed497db3", "0029d5da60efc14759a66c4e3299d5da09c4ab8e3f255fe5da9990699c42f3e4", "09d5441cba061349b43b36ab683d966f772d0cec94698823e32c35f2475d287e"], "AGENTS.md": ["4f3ef860ade3a31aa7c6a6aab5cf6ec2a700850bf19ea2320324c12c2e0fbf5b", "1b07de01698a0040b47ea0eddb1b017f70a69e81acd0bf9710647ca5e02f5125", "b5ee3439ff974c668755816149fab76899d7ad9266f63978b30fbc9b7d2cd640", "bacedb7bdedab5abe75c9601717cfdb05a96208fa2e2a42af878e2dfd2ae4251", "ea3b473179857ccc07e9e4f21a6ede9e0906a09e495f4a051069d15aee1556cd", "faa2bba99ae3023be7f588d02177a4abf583d3a8a65f617b8cff7a3ceed09dfc", "83c75394bc7eaab6662a76d89339361e836cc1a988237720eeeacdd6b62e726f", "b685cb7ff21d5bfe19d96ce0139c17b7eb014b7ecda8ec5321558b0004bfdc71", "9da0b84e166ad3799dd0c644adaa3ce8727f383e5571b0a212c3d34f5c05ab40", "12f5dce738eb974ddd96f4bd00d8de5be236a54dbb20720f6f4ab455bcc319d9"], "references/cli-mcp.md": ["5d3a79343fbd76cdae5bdbe12fb9c944d5dff4f489ac6534fd96e0cb8630b988", "8e011c31368cef2117a28ee972b39aab9535eeb0f601a4a0f9d6fc019b22c1c2", "666082653efc000f8a7cc5f1836c80bbdda5f0f57cdbbdcb393f2b84aeb93a01", "78b737796a8685b1135e0acb91b620c51845b62e31dba04eb51dd9dd38b41008", "8b2e01bfd937237919f5ade794eed01dc6e32b556ede9de3a0ccc28cbdd988d1", "ca88b2816a795a5ebe834074b178469367634b80ad837e3697182ea585af1c05", "490daf154b428b536d0a6f590030c854b2fc8ca6adb995c6ecd5a162f85e471e", "9f98affecd69752c17f52fb51ae74b26a1cadea5919b8b74b7865a20661c4418", "19fc85e92cef203f4162e2bfb2dd2df8ef90472bc8f81dfb568b65a714335ff9", "f697c525a32d8ed6c0752d833cb98cca8b9aec9eadf456e178dfbc9fc246c58c", "d2a3dd980fb712110861ac9802288bb025ac5ea0055f1e56d70d649412a4d733", "955d60d1be71d0eb134ae9fc35a771d41303fae8fe63daa99bfce514a6522e14"], "references/production-and-review.md": ["055c6df9e0f167be148b0a5c0bba5b43e108eb1f58f478d88b3536c6589ac7b3", "4a4035b87a6c024b419847ab8592bddfeb9b2d9c184f65880c47d661f0bb250e", "c3669af0717a5fafbf7cc8b01bd66f74d4c82028715323a870a1298d25250d5e"], "references/workspace-files.md": ["e72af2871f42cd776be1bfff8009ed5562780e7f8a65b12c27887f3880631f81", "00780c64bd0244c6afb18d786b7512b43e315c376e8f88c67d6ba53d91275ccf", "97053b092e0ff36e3cfb764095fcb4a4fca94e722567e774b53bc118279f40e5", "70fc660e7ed3d70c16c33c62c8e0399b99c3251808f093ef3d4ea5e8d39e4c8a", "28c62c1e28842142607f5168ee79b18fd797900dd66dd9ac5eb3cfcf8a09f781", "b86eae85cf86dbf4409b10f4d8df1f1649fc408ce1a240f7cf26d5bb69aabfd1", "fc65f343e50b91327653bdc5d94f35af9c86c097bb46810b4b2f7c9a1c200166", "8a650485bc4f26bbebf6d6a66957bdea87b156632e52a27e9becc194b003a9fc"], "references/first-edit.md": ["cb1e9d3272b2b22ae095aed02e33067c646da48e7b64cf71ff81197f6e67b673", "5a02253d9907f5e6705304565da7b2d1787e84ae17616414b295a8526ec3e4a5", "586b1f18bab01ad6b2bb0efd95cfdc8f8002ecfd022ae91021779ab1d5e432c9"], "references/memory-and-review.md": ["51a274e522270f1fc295d0c0b9a1c23672ce01abea097c2499c9a8db56c0c289"], "references/search-brief.md": ["137203383a7873593136428520f5f9cd6ce1ab6cfeab365c277175786eba3ab3", "df93154562bb89a9f22d31260c17406565f5f308c407643c85d15e528ef2c086", "a472eeb61a2a60172d5cdb71f80be3d18f59e248028ab107b6cd1b68535ff588"], "references/style-creator.md": ["1b1bc289a5bc308cbbf7f4d699de2933b8934733a2b69b3e98fb1b7420d986f2"], "references/local-production.md": ["0a13c65cd60e40ba703095f5e33a1ea66433323b38345c2034fb73c602c438ee"], "references/integrations.md": ["a3500dd79c71ab3ee80a865bb5bf8c94287efb933e07d577738891e276a819a0"], "references/media-preferences.md": ["970b97fbd55b8e9e05fd7e51b4a953cd1b96b9bee7830382aa7514f1b240b3aa", "481c643a5e6516413a6cae970b5170573c981d0effd7d4e146c5cd07c0ee3b1f", "8f11e1956ed06ab73ba58d8c880f0d2292eb76829b07d2de2eaaed1965885158", "e94bc13c05ffd57eceecc4ceaa42df2b83904c12f8c552e161c98f13e6427e5b", "00e50c6231a917639c8d9eb39bff61b0b90e3a1886a4d4684ef6d85fa754e87c"] };
 var destinations = {
   codex: { directory: ".agents/skills/editorbrain", entryPoint: "AGENTS.md" },
@@ -58364,6 +58538,7 @@ var destinations = {
 };
 var previousHashesBySkill = {
   editorbrain: previousSkillHashes,
+  "editorbrain-formats": {},
   "editorbrain-motion": { "references/code-motion.md": ["9c9bd4c7c6ef8c607e4de6198408e4a49e6d6c4deda681dd7aadada1e46c1a80", "dc7446d5349fd107d6c722fcf62ad6ad6dfc7b9a1d4829c0adfbc00e41a9c8a5", "08fd07e904424a98ec4dd68732d55e15fa9f6edffe14e4ee0241f0483acb82be"], "references/generated-motion.md": ["a8d214b53c15f742658abd84f03b768fa2821f8cde94f50aab82a3759a30b36b"], "SKILL.md": ["f732ba6c896e01a844df92a353a77d18da1be7f09ce557bf7a543e3066a667d2", "0920c79979dc029fae3526a565e5eab75d5b7f1f51c369fb7ef0d652b95876eb", "0b6f6e6990528579fdff4275a2bcf0b0fe6f0f2de59ae84d0f57b81a07185cec"], "references/component-library.md": ["ad7142f9bbd52903b61f401104dfdbb430535f358946e58788f9f740d8f44b56", "7ff9e079116c410be0dc80fb470e79226c380b6fcc7d6eb72cb94443dd8915a4", "c2ab96ee61dc1e9480cb6f7fd160c016b35ff946e3d8ffe31267d127718482c8", "fea1fb710d23830c3ed14c3e4bed7bc53540ae2e2e662b74fe6eb6307b010d28"] }
 };
 function installedSkillDirectory(agent, skillName = "editorbrain") {
@@ -58421,11 +58596,11 @@ async function prepareAgentGuidance(root, agent = "both", sourceDirectory, compa
   root = await ensureRoot(root);
   parseAgentTarget(agent);
   const agents = agent === "both" ? ["codex", "claude"] : [agent];
-  const companions = companionSources ?? (sourceDirectory === void 0 ? {
-    "editorbrain-motion": bundledSkillDirectory(void 0, "editorbrain-motion")
-  } : {});
+  const companions = companionSources ?? (sourceDirectory === void 0 ? Object.fromEntries(
+    BUNDLED_SKILLS.filter((name) => name !== "editorbrain").map((name) => [name, bundledSkillDirectory(void 0, name)])
+  ) : {});
   for (const name of Object.keys(companions)) {
-    if (name !== "editorbrain-motion") throw new Error(`Unknown companion skill: ${name}`);
+    if (name === "editorbrain" || !BUNDLED_SKILLS.includes(name)) throw new Error(`Unknown companion skill: ${name}`);
   }
   const sources = /* @__PURE__ */ new Map([
     ["editorbrain", await loadSkill(sourceDirectory ?? bundledSkillDirectory())]
@@ -63497,7 +63672,16 @@ editorbrain register --url https://server --name workspace --invite-stdin
 editorbrain status
 editorbrain pull [--project id | --all] [--dir folder] [--dry-run]
 editorbrain push [--dir folder] [--dry-run]
+editorbrain batches list [--after UUID]
+editorbrain batches create --file batch.json
+editorbrain batches get BATCH_ID
+editorbrain batches pause|resume|cancel BATCH_ID --expected-revision N
+editorbrain batches retry|detach BATCH_ID --project ID --expected-revision N
+editorbrain batches claim|renew|release|attention BATCH_ID --project ID --lease-token UUID
 editorbrain projects list
+editorbrain projects progress --project ID
+editorbrain projects start|queue --project ID --expected-version HASH
+editorbrain projects complete --project ID --expected-version HASH --revision UUID --user-confirmed
 editorbrain documents list [--prefix path]
 editorbrain documents get <path> [--revision N]
 editorbrain documents history <path> [--before N]
@@ -63516,7 +63700,7 @@ editorbrain studio prepare --file source.mp4 --out .editorbrain-local/studio/aud
 editorbrain studio catalog
 editorbrain billing status
 editorbrain studio quote --file request.json [--dir folder]
-editorbrain studio run QUOTE_ID --max-credits N --user-confirmed
+editorbrain studio run QUOTE_ID --max-credits N --user-confirmed [--batch-lease-token UUID]
 editorbrain studio get JOB_ID
 editorbrain studio jobs
 editorbrain integrations catalog
@@ -63602,6 +63786,9 @@ function parseArgs(argv) {
   known.add("preview-kind");
   known.add("preset");
   known.add("context-version");
+  known.add("expected-version");
+  known.add("lease-token");
+  known.add("batch-lease-token");
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (!arg.startsWith("--")) {
@@ -64187,6 +64374,14 @@ async function main() {
     }
     throw new Error("Use keys list, keys create --label name, or keys revoke <key-id>");
   }
+  if (command === "batches") {
+    output(await batchCommand(new Client(await config(args)), await ensureRoot(str(args, "dir") ?? process.cwd()), subcommand, argument, args.flags));
+    return;
+  }
+  if (command === "projects" && ["progress", "start", "queue", "complete"].includes(subcommand)) {
+    output(await projectProgressCommand(new Client(await config(args)), subcommand, args.flags));
+    return;
+  }
   if (command === "projects" && subcommand === "list") {
     output({ projects: await listProjects(new Client(await config(args))) });
     return;