@koda-sl/baker-cli 0.477.0 → 0.479.0

package/dist/credentials-GJMH4XRU.js

@@ -1,287 +0,0 @@
-import {
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-import {
-  failApi,
-  failValidation
-} from "./chunk-R4CDO5YH.js";
-import "./chunk-GAJQPQWS.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import {
-  getPublicSuffix,
-  parse
-} from "./chunk-ML7DLFFY.js";
-import {
-  apiPost
-} from "./chunk-7ANWFQEA.js";
-import "./chunk-KODTY7PB.js";
-import "./chunk-H5CGVMQW.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-ANYMWCST.js";
-import "./chunk-YQSBHWOI.js";
-
-// ../api/src/credentials/contract.ts
-import { z } from "zod";
-
-// ../api/src/credentials/hosts.ts
-function normaliseHost(host) {
-  return host.trim().toLowerCase().replace(/\.$/, "");
-}
-function asciiHost(host) {
-  if (!/[\u0080-\u{10FFFF}]/u.test(host) || /[/?#@:\\%[\]\s]/.test(host)) return host;
-  const url = `http://${host}`;
-  return URL.canParse(url) ? new URL(url).hostname : host;
-}
-function validateHostPattern(raw) {
-  const typed = normaliseHost(raw);
-  const wildcard = typed.startsWith("*.");
-  const host = asciiHost(wildcard ? typed.slice(2) : typed);
-  const pattern = wildcard ? `*.${host}` : host;
-  if (host === "" || host.includes("*")) {
-    return { ok: false, reason: "Use a website address like api.example.com or *.example.com." };
-  }
-  const parsed = parse(host);
-  if (parsed.isIp || host.startsWith("[")) {
-    return { ok: false, reason: "Use a website address, not an IP address." };
-  }
-  if (parsed.hostname !== host || parsed.domain === null) {
-    return { ok: false, reason: "Use only the website address, like api.example.com." };
-  }
-  if (wildcard && !wildcardSafe(host)) {
-    return { ok: false, reason: `*.${host} would allow any website. Name the company's own address.` };
-  }
-  return { ok: true, pattern };
-}
-var OPEN_HOSTING_DOMAINS = ["amazonaws.com", "cloudfront.net", "googleapis.com", "on.aws"];
-var WITH_PRIVATE = { allowPrivateDomains: true };
-function wildcardSafe(host) {
-  if (OPEN_HOSTING_DOMAINS.some((domain) => host === domain || host.endsWith(`.${domain}`))) return false;
-  const suffix = getPublicSuffix(host, WITH_PRIVATE);
-  return suffix !== host && getPublicSuffix(`zz.${host}`, WITH_PRIVATE) === suffix;
-}
-
-// ../api/src/credentials/placeholder.ts
-var CREDENTIAL_NAME_PATTERN = "[a-z0-9][a-z0-9_-]{0,63}";
-var CREDENTIAL_NAME_RE = new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`);
-var PLACEHOLDER_SOURCE = `\\{\\{credential:(${CREDENTIAL_NAME_PATTERN})\\}\\}`;
-var WHOLE_PLACEHOLDER_RE = new RegExp(`^${PLACEHOLDER_SOURCE}$`);
-
-// ../api/src/credentials/contract.ts
-var MAX_CREDENTIAL_VALUE_LENGTH = 16384;
-var MAX_CREDENTIAL_HOSTS = 20;
-var credentialNameSchema = z.string().regex(new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`), "Use lowercase letters, digits, - and _ (max 64).");
-var credentialHostsSchema = z.array(z.string()).max(MAX_CREDENTIAL_HOSTS).transform((hosts, ctx) => {
-  const patterns = [];
-  for (const host of hosts) {
-    const result = validateHostPattern(host);
-    if (result.ok) patterns.push(result.pattern);
-    else ctx.addIssue({ code: "custom", message: `${host}: ${result.reason}` });
-  }
-  return [...new Set(patterns)];
-});
-var credentialSourceSchema = z.enum(["user", "agent", "chat-detected", "requested"]);
-var credentialSummarySchema = z.object({
-  name: z.string(),
-  label: z.string(),
-  placeholder: z.string(),
-  allowedHosts: z.array(z.string()),
-  source: credentialSourceSchema,
-  lastUsedAt: z.number().nullable()
-});
-var credentialsListResponseSchema = z.object({ credentials: z.array(credentialSummarySchema) });
-var credentialsPutRequestSchema = z.object({
-  name: credentialNameSchema,
-  label: z.string().trim().min(1).max(80).optional(),
-  value: z.string().min(1).max(MAX_CREDENTIAL_VALUE_LENGTH),
-  allowedHosts: credentialHostsSchema
-});
-var credentialsPutResponseSchema = z.object({
-  name: z.string(),
-  placeholder: z.string(),
-  replaced: z.boolean()
-});
-var credentialsDeleteRequestSchema = z.object({ name: credentialNameSchema });
-var credentialsDeleteResponseSchema = z.object({ name: z.string(), deleted: z.literal(true) });
-var brokerResolveResponseSchema = z.object({
-  credentials: z.array(z.object({ name: z.string(), value: z.string(), allowedHosts: z.array(z.string()) }))
-});
-var brokerUsageRequestSchema = z.object({
-  uses: z.array(z.object({ name: credentialNameSchema, host: z.string().max(253) })).max(100)
-});
-
-// src/commands/credentials/index.ts
-import { defineCommand } from "citty";
-var DOC = "__tooling__/docs/tools/baker/credentials.md";
-var STDIN_ONLY = 'The value is read from stdin only, never from the command line (argv is visible to other processes and lands in logs). Pipe it: printf %s "$VALUE" | baker credentials put <name> --host <host>. For a credential the user owns, call request_credential instead.';
-registerSchema({
-  command: "credentials.list",
-  description: "Start here: the credentials (API keys, tokens, passwords) this company stored, by name \u2014 never their values. Write the `placeholder` ({{credential:NAME}}) into an HTTPS request (curl header, URL, SDK config, JSON body) and the sandbox proxy sends the real value, only to the credential's allowedHosts. Nothing listed? Ask the user with the request_credential tool. Compact by default; --full adds source and lastUsedAt.",
-  args: {
-    full: { type: "boolean", description: "Add source and lastUsedAt per credential", required: false, default: false }
-  }
-});
-registerSchema({
-  command: "credentials.put",
-  description: `Store a credential YOU created on the user's behalf (e.g. a key you just generated through an API), so later requests can use {{credential:NAME}}. Example: printf %s "$KEY" | baker credentials put stripe-key --host api.stripe.com --label "Stripe key". The value comes from stdin ONLY. For a credential the user owns, call request_credential instead \u2014 never ask for it in chat. Replacing is allowed only for credentials the agent created.`,
-  args: {
-    name: { type: "positional", description: "Lowercase name: letters, digits, - and _ (max 64)", required: true },
-    host: {
-      type: "string",
-      description: "Website the value may be sent to (repeatable, or comma-separated): api.stripe.com, acme-store.myshopify.com",
-      required: true
-    },
-    label: { type: "string", description: "Human-readable label shown in Settings \u2192 Credentials", required: false }
-  }
-});
-registerSchema({
-  command: "credentials.delete",
-  description: "Delete a credential the agent created (e.g. a key it rotated out). Credentials the user added can only be removed by the user, in Settings \u2192 Credentials.",
-  args: {
-    name: { type: "positional", description: "Credential name", required: true }
-  }
-});
-async function readPipedValue() {
-  const stdin = process.stdin;
-  if (stdin.isTTY) return "";
-  const chunks = [];
-  for await (const chunk of stdin) {
-    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
-  }
-  return Buffer.concat(chunks).toString("utf8").replace(/\r?\n$/, "");
-}
-function parseName(raw) {
-  const parsed = credentialNameSchema.safeParse(raw);
-  if (!parsed.success) {
-    failValidation(`Invalid credential name "${String(raw)}": use lowercase letters, digits, - and _ (max 64).`);
-  }
-  return parsed.data;
-}
-function parseHosts(rawArgs, parsed) {
-  const hosts = repeatedValues(rawArgs, "host", parsed).flatMap((value) => value.split(",")).map((host) => host.trim()).filter((host) => host !== "");
-  if (hosts.length === 0) {
-    failValidation("Name at least one website the value may be sent to: --host api.example.com (repeatable).");
-  }
-  const result = credentialHostsSchema.safeParse(hosts);
-  if (!result.success) {
-    failValidation(`Invalid --host: ${result.error.issues.map((issue) => issue.message).join("; ")}`);
-  }
-  return result.data;
-}
-var listCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "Start here: stored credentials by name with their {{credential:NAME}} placeholder and allowed websites. Never shows values."
-  },
-  args: {
-    full: { type: "boolean", description: "Add source and lastUsedAt", required: false, default: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const response = await apiPost("/api/credentials/list", {});
-      const credentials = response.data.credentials.map(
-        (credential) => args.full ? credential : {
-          name: credential.name,
-          placeholder: credential.placeholder,
-          allowedHosts: credential.allowedHosts,
-          label: credential.label
-        }
-      );
-      writeJson({
-        ok: true,
-        data: { credentials },
-        meta: { count: credentials.length },
-        ...credentials.length === 0 ? {
-          hints: [
-            "No credentials stored. When the task needs one the user owns, call the request_credential tool (label, reason, allowedHosts) \u2014 never ask them to paste it in chat."
-          ]
-        } : {}
-      });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-var putCommand = defineCommand({
-  meta: {
-    name: "put",
-    description: `Store a credential you created on the user's behalf; the value is read from stdin only.
-Start here: printf %s "$KEY" | baker credentials put stripe-key --host api.stripe.com
-For a credential the user owns, call request_credential instead.`
-  },
-  args: {
-    name: { type: "positional", description: "Lowercase name: letters, digits, - and _ (max 64)", required: true },
-    host: {
-      type: "string",
-      description: "Website the value may be sent to (repeatable, or comma-separated)",
-      required: false
-    },
-    label: { type: "string", description: "Label shown in Settings \u2192 Credentials", required: false },
-    value: {
-      type: "string",
-      description: "Refused \u2014 never put a value on the command line. Pipe it on stdin.",
-      required: false
-    }
-  },
-  run: async ({ args, rawArgs }) => {
-    if (args.value !== void 0 || args._.length > 1) {
-      failValidation(STDIN_ONLY);
-    }
-    const name = parseName(args.name);
-    const allowedHosts = parseHosts(rawArgs, args.host);
-    const value = await readPipedValue();
-    if (value === "") {
-      failValidation(`Nothing was piped on stdin. ${STDIN_ONLY}`);
-    }
-    if (value.length > MAX_CREDENTIAL_VALUE_LENGTH) {
-      failValidation(`The value is longer than ${MAX_CREDENTIAL_VALUE_LENGTH} characters.`);
-    }
-    const body = { name, value, allowedHosts, ...args.label ? { label: args.label } : {} };
-    try {
-      const response = await apiPost("/api/credentials/put", body);
-      writeJson({
-        ok: true,
-        data: { name: response.data.name, placeholder: response.data.placeholder },
-        hints: [
-          `Use ${response.data.placeholder} in the request; the value is sent only to: ${allowedHosts.join(", ")}.`,
-          "Never echo, print or write the value anywhere \u2014 unset the shell variable that held it."
-        ]
-      });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-var deleteCommand = defineCommand({
-  meta: {
-    name: "delete",
-    description: "Delete a credential the agent created. User-added credentials are removed by the user in Settings \u2192 Credentials."
-  },
-  args: {
-    name: { type: "positional", description: "Credential name", required: true }
-  },
-  run: async ({ args }) => {
-    const name = parseName(args.name);
-    try {
-      const response = await apiPost("/api/credentials/delete", { name });
-      writeJson({ ok: true, data: response.data });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-var credentialsCommand = defineCommand({
-  meta: {
-    name: "credentials",
-    description: `Credentials (API keys, tokens, passwords) by name: write {{credential:NAME}} in an HTTPS request and the value is sent only to the websites it is bound to. You never see values.
-Full guide: ${DOC}`
-  },
-  subCommands: { list: listCommand, put: putCommand, delete: deleteCommand }
-});
-export {
-  credentialsCommand
-};
-//# sourceMappingURL=credentials-GJMH4XRU.js.map

package/dist/critique-EJJQVV4D.js

@@ -1,213 +0,0 @@
-import {
-  FRAME_PLACEHOLDER_NOTE,
-  exitOnPrepareError,
-  prepareCanvas
-} from "./chunk-3IGY2FWK.js";
-import "./chunk-CMNVR6DX.js";
-import "./chunk-37P6DTDJ.js";
-import "./chunk-O6TGA5HT.js";
-import "./chunk-QKUBK3AD.js";
-import "./chunk-HH5PFZ7U.js";
-import "./chunk-ANWV2VTO.js";
-import {
-  briefCopyLines,
-  frameDescriptionOf,
-  nativeDialogueOf
-} from "./chunk-GRL25RKS.js";
-import "./chunk-GAD2NYL4.js";
-import "./chunk-DGCUPJZD.js";
-import {
-  COPY_DIRECTIVE_HEADER
-} from "./chunk-5TV4GYP2.js";
-import "./chunk-2XQ5HU6D.js";
-import "./chunk-OST3RA6Q.js";
-import "./chunk-5HYSKH77.js";
-import "./chunk-KIGGMKAE.js";
-import "./chunk-UW7PZFWZ.js";
-import "./chunk-NKXH3I65.js";
-import "./chunk-CPTOHQSJ.js";
-import "./chunk-JRLGQA2T.js";
-import "./chunk-GAJQPQWS.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import "./chunk-KODTY7PB.js";
-import "./chunk-H5CGVMQW.js";
-import "./chunk-ANYMWCST.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/canvas/critique.ts
-import path from "path";
-import { defineCommand } from "citty";
-
-// src/engine/scaffold/lib/critique.ts
-var VIBE_CUE = /\b(light|lighting|golden|moody|warm|cool|tone|grade|contrast|shadow|glow|rim|backlit|neon|soft)\b/i;
-var MECHANISM_CUE = /\b(because|works by|so that|mechanism|proof|guarantee|clinically|backed by|the reason|that's why)\b/i;
-function promptOf(node) {
-  const p = node?.params?.prompt;
-  return typeof p === "string" ? p : "";
-}
-function round(n) {
-  return Math.round(n * 100) / 100;
-}
-function frameLook(node) {
-  const description = frameDescriptionOf(promptOf(node)).trim();
-  return description.endsWith(FRAME_PLACEHOLDER_NOTE) ? "" : description;
-}
-function creativeText(nodes) {
-  return nodes.flatMap((n) => {
-    if (n.type === "image_generate") return [frameLook(n)];
-    if (n.type === "video_generate") return [nativeDialogueOf(promptOf(n)) ?? ""];
-    if (n.type === "tts" && typeof n.params?.text === "string") return [n.params.text];
-    return [];
-  }).join("\n");
-}
-function scoreHookStrength(nodes, scene0, hasOverlay) {
-  const scene0Text = scene0.map((n) => promptOf(n)).join("\n");
-  const frames = scene0.filter((n) => n.type === "image_generate");
-  const look = (frames.length > 0 ? frames.map(frameLook) : scene0.map((n) => promptOf(n))).join("\n");
-  const hookClip = scene0.find((n) => n.type === "video_generate");
-  const hasSound = hookClip?.params?.generate_audio === true || /Dialogue:|Audio:/.test(scene0Text) || nodes.some((n) => n.type === "tts" || n.type === "dialogue");
-  const layers = [hasOverlay, hasSound, look.trim().length > 40, VIBE_CUE.test(look)];
-  const layerCount = layers.filter(Boolean).length;
-  return {
-    dimension: "hook_strength",
-    score: round(hookClip ? layerCount / 4 : 0.5),
-    note: hookClip ? `hook works on ${layerCount}/4 layers (text/sound/visual/vibe)` : "no scene-0 clip found \u2014 is this a video creative?"
-  };
-}
-function scoreFirstFrameLegibility(hasOverlay) {
-  return {
-    dimension: "first_frame_legibility",
-    score: hasOverlay ? 1 : 0.4,
-    note: hasOverlay ? "a designed overlay layer carries the sound-off message" : "footage-only \u2014 the first frame may not read with sound off; consider an overlay hook"
-  };
-}
-function scoreRetentionRisk(videoNodes) {
-  let saggy = 0;
-  for (const n of videoNodes) {
-    const dur = typeof n.params?.duration === "number" ? n.params.duration : 0;
-    const spoken = /Dialogue:/.test(promptOf(n)) || n.params?.generate_audio === true;
-    if (dur >= 8 && !spoken) saggy += 1;
-  }
-  return {
-    dimension: "retention_risk",
-    score: round(videoNodes.length > 0 ? 1 - Math.min(1, saggy / videoNodes.length) : 0.7),
-    note: saggy > 0 ? `${saggy} long clip(s) with no spoken line may sag` : "no obvious sag points"
-  };
-}
-function scoreMechanismClarity(allPromptText) {
-  const clear = MECHANISM_CUE.test(allPromptText);
-  return {
-    dimension: "mechanism_clarity",
-    score: clear ? 1 : 0.4,
-    note: clear ? "states a mechanism/proof" : "no clear 'why it works' \u2014 add the mechanism"
-  };
-}
-function clamp01(n) {
-  return Math.max(0, Math.min(1, n));
-}
-function staticCopyLines(nodes) {
-  const gen = nodes.find((n) => n.type === "image_generate");
-  const prompt = promptOf(gen);
-  const compiled = briefCopyLines(prompt);
-  if (compiled.length > 0) return compiled;
-  const start = prompt.indexOf(COPY_DIRECTIVE_HEADER);
-  if (start === -1) return [];
-  const bodyStart = start + COPY_DIRECTIVE_HEADER.length;
-  const end = prompt.indexOf("\n\n", bodyStart);
-  const block = prompt.slice(bodyStart, end === -1 ? void 0 : end);
-  const quoted = block.match(/"[^"]+"/g);
-  return quoted ? quoted.map((s) => s.slice(1, -1)) : [];
-}
-function scoreTextLegibilityRisk(copy) {
-  const lines = copy.length;
-  return {
-    dimension: "text_legibility_risk",
-    score: round(clamp01(1 - Math.max(0, lines - 6) / 12)),
-    note: lines > 6 ? `${lines} copy blocks \u2014 dense; trim or split so type stays legible` : `${lines} copy block(s) \u2014 reads cleanly`
-  };
-}
-function scoreIdentityGrounding(nodes) {
-  const grounded = nodes.filter((n) => n.type === "image_reference_sheet").length + nodes.filter((n) => n.type === "ingest" && typeof n.id === "string" && /^el_/.test(n.id)).length;
-  return {
-    dimension: "identity_grounding",
-    // 0 grounded is fine for a pure-type ad, so it's a soft nudge, not a failure.
-    score: grounded > 0 ? 1 : 0.6,
-    note: grounded > 0 ? `${grounded} subject(s) grounded in a real reference` : "no grounded subject \u2014 fine for a type-only ad; otherwise ground the hero in a real reference"
-  };
-}
-function scoreTypeFidelity(nodes) {
-  const hasSpecimen = nodes.some((n) => n.type === "font_specimen");
-  return {
-    dimension: "type_fidelity",
-    score: hasSpecimen ? 1 : 0.5,
-    note: hasSpecimen ? "brand type biased by a font specimen" : "no font specimen \u2014 brand type may drift; wire the brand font"
-  };
-}
-function critiqueVideo(nodes, videoNodes) {
-  const scene0 = nodes.filter((n) => typeof n.id === "string" && /^s0(?:[_a-z0-9])*_/.test(n.id));
-  const hasOverlay = nodes.some((n) => typeof n.type === "string" && /hyperframe/.test(n.type));
-  return [
-    scoreHookStrength(nodes, scene0, hasOverlay),
-    scoreFirstFrameLegibility(hasOverlay),
-    scoreRetentionRisk(videoNodes),
-    scoreMechanismClarity(creativeText(nodes))
-  ];
-}
-function critiqueStatic(nodes) {
-  const copy = staticCopyLines(nodes);
-  const copyText = copy.join("\n");
-  return [
-    scoreTextLegibilityRisk(copy),
-    scoreIdentityGrounding(nodes),
-    scoreTypeFidelity(nodes),
-    scoreMechanismClarity(copyText)
-  ];
-}
-function critiqueCanvas(canvas) {
-  const nodes = Array.isArray(canvas.nodes) ? canvas.nodes : [];
-  const videoNodes = nodes.filter((n) => n.type === "video_generate");
-  const dimensions = videoNodes.length > 0 ? critiqueVideo(nodes, videoNodes) : critiqueStatic(nodes);
-  const overall = round(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);
-  return { advisory: true, overall, dimensions };
-}
-
-// src/commands/canvas/critique.ts
-var critiqueCommand = defineCommand({
-  meta: {
-    name: "critique",
-    description: "Pre-spend creative critic (ADVISORY \u2014 never blocks). Scores a scaffolded creative BEFORE the billed render, so weak spots get fixed for free. It scores what will render: prompt.json and scenes/*.json edits are brought into the canvas first, exactly as `run` does. A VIDEO creative is scored on hook strength, sound-off first-frame legibility, retention risk, and mechanism clarity; a STATIC ad on baked-text legibility risk, identity grounding, brand-type fidelity, and mechanism clarity. Ground a video hook against `baker winning-ads hooks` for a proven pattern."
-  },
-  args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
-  async run({ args }) {
-    const filePath = path.resolve(String(args.file));
-    let prepared;
-    try {
-      prepared = await prepareCanvas(filePath, { log: (line) => process.stderr.write(`${line}
-`) });
-    } catch (e) {
-      exitOnPrepareError(e);
-    }
-    const report = critiqueCanvas(prepared.canvas);
-    process.stdout.write(
-      `${JSON.stringify(
-        {
-          ok: true,
-          advisory: true,
-          overall: report.overall,
-          dimensions: report.dimensions,
-          hint: "Scores are 0\u20131 (higher is better). This never blocks a render \u2014 strengthen weak dimensions or proceed."
-        },
-        null,
-        2
-      )}
-`
-    );
-  }
-});
-export {
-  critiqueCommand
-};
-//# sourceMappingURL=critique-EJJQVV4D.js.map

package/dist/critique-EJJQVV4D.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/canvas/critique.ts","../src/engine/scaffold/lib/critique.ts"],"sourcesContent":["import path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { critiqueCanvas } from \"../../engine/scaffold/lib/critique.ts\";\nimport { exitOnPrepareError, type PreparedCanvas, prepareCanvas } from \"./prepare-canvas.ts\";\n\nexport const critiqueCommand = defineCommand({\n  meta: {\n    name: \"critique\",\n    description:\n      \"Pre-spend creative critic (ADVISORY — never blocks). Scores a scaffolded creative BEFORE the billed render, so weak spots get fixed for free. It scores what will render: prompt.json and scenes/*.json edits are brought into the canvas first, exactly as `run` does. A VIDEO creative is scored on hook strength, sound-off first-frame legibility, retention risk, and mechanism clarity; a STATIC ad on baked-text legibility risk, identity grounding, brand-type fidelity, and mechanism clarity. Ground a video hook against `baker winning-ads hooks` for a proven pattern.\",\n  },\n  args: { file: { type: \"positional\", required: true, description: \"Path to canvas JSON\" } },\n  async run({ args }) {\n    const filePath = path.resolve(String(args.file));\n    // Scored on the graph the render will run: every projection applied (the static copy\n    // from prompt.json, each scene's frame and clip prompts from scenes/*.json), not the\n    // canvas as it was scaffolded.\n    let prepared: PreparedCanvas;\n    try {\n      prepared = await prepareCanvas(filePath, { log: (line) => process.stderr.write(`${line}\\n`) });\n    } catch (e) {\n      exitOnPrepareError(e);\n    }\n    const report = critiqueCanvas(prepared.canvas as Parameters<typeof critiqueCanvas>[0]);\n    // Advisory: always exit 0. A low score is guidance, not a gate — the operator\n    // decides whether to strengthen the creative or render as-is.\n    process.stdout.write(\n      `${JSON.stringify(\n        {\n          ok: true,\n          advisory: true,\n          overall: report.overall,\n          dimensions: report.dimensions,\n          hint: \"Scores are 0–1 (higher is better). This never blocks a render — strengthen weak dimensions or proceed.\",\n        },\n        null,\n        2,\n      )}\\n`,\n    );\n  },\n});\n","/**\n * Pre-spend creative critic (T4.1) — our answer to Higgsfield's Virality Predictor,\n * grounded in the doctrine we already enforce. It scores a scaffolded creative on\n * the dimensions that decide whether an ad stops the scroll, BEFORE the billed\n * render, so the operator can strengthen a weak hook for free.\n *\n * ADVISORY ONLY. It never blocks a render or publish — it returns scores + notes;\n * the operator decides. This mirrors our validator philosophy (advisory warnings\n * steer, they don't gate).\n *\n * Pure + offline: it reads the parsed canvas and reasons from the node graph. The\n * deeper \"is this hook a proven winner for the segment\" question is answered by\n * grounding against `baker winning-ads hooks` (see references/critique.md) — kept\n * out of this function so the critic can't fail on a network hiccup.\n */\n\nimport { frameDescriptionOf } from \"../../engine/lint/rules/video-prompt.ts\";\nimport { nativeDialogueOf } from \"../../lib/prompt-profiles.ts\";\nimport { briefCopyLines } from \"../static-brief.ts\";\nimport { COPY_DIRECTIVE_HEADER } from \"../static-copy.ts\";\nimport { FRAME_PLACEHOLDER_NOTE } from \"../video/prompts/frame.ts\";\n\nexport type CritiqueCanvasInput = {\n  nodes?: Array<{ id?: string; type?: string; params?: Record<string, unknown>; inputs?: unknown }>;\n  metadata?: { video?: { duration_s?: number; vo_segments?: unknown[]; talking_scenes?: unknown[] } };\n};\n\nexport type CritiqueDimension = {\n  dimension: // Video creative dimensions.\n    | \"hook_strength\"\n    | \"first_frame_legibility\"\n    | \"retention_risk\"\n    // Static-ad dimensions.\n    | \"text_legibility_risk\"\n    | \"identity_grounding\"\n    | \"type_fidelity\"\n    // Shared.\n    | \"mechanism_clarity\";\n  /** 0–1, higher is better (for the *_risk dimensions, higher = LOWER risk). */\n  score: number;\n  note: string;\n};\n\nexport type CritiqueReport = {\n  advisory: true;\n  overall: number;\n  dimensions: CritiqueDimension[];\n};\n\nconst VIBE_CUE = /\\b(light|lighting|golden|moody|warm|cool|tone|grade|contrast|shadow|glow|rim|backlit|neon|soft)\\b/i;\nconst MECHANISM_CUE =\n  /\\b(because|works by|so that|mechanism|proof|guarantee|clinically|backed by|the reason|that's why)\\b/i;\n\nfunction promptOf(node: { params?: Record<string, unknown> } | undefined): string {\n  const p = node?.params?.prompt;\n  return typeof p === \"string\" ? p : \"\";\n}\n\nfunction round(n: number): number {\n  return Math.round(n * 100) / 100;\n}\n\ntype CanvasNode = NonNullable<CritiqueCanvasInput[\"nodes\"]>[number];\n\n/**\n * What a frame node says about its own picture: the FRAME DESCRIPTION a scaffolded frame\n * wraps in fixed instructions (the same slice the validator reads), or a hand-authored\n * prompt whole. The fixed instructions are the same on every frame — scoring them is how\n * every hook read as having a mood, because they name \"lighting\" — and a frame still\n * waiting for its description has none.\n */\nfunction frameLook(node: CanvasNode): string {\n  const description = frameDescriptionOf(promptOf(node)).trim();\n  return description.endsWith(FRAME_PLACEHOLDER_NOTE) ? \"\" : description;\n}\n\n/** The words the creative itself says: every frame's own description and every spoken line. */\nfunction creativeText(nodes: CanvasNode[]): string {\n  return nodes\n    .flatMap((n) => {\n      if (n.type === \"image_generate\") return [frameLook(n)];\n      if (n.type === \"video_generate\") return [nativeDialogueOf(promptOf(n)) ?? \"\"];\n      if (n.type === \"tts\" && typeof n.params?.text === \"string\") return [n.params.text];\n      return [];\n    })\n    .join(\"\\n\");\n}\n\n/**\n * HOOK STRENGTH — the four hook layers present on scene 0 (text/sound/visual/vibe). The\n * visual and vibe layers are read off the opening frames' own descriptions (a canvas with\n * no generated frame: its scene-0 prompts, whole).\n */\nfunction scoreHookStrength(nodes: CanvasNode[], scene0: CanvasNode[], hasOverlay: boolean): CritiqueDimension {\n  const scene0Text = scene0.map((n) => promptOf(n)).join(\"\\n\");\n  const frames = scene0.filter((n) => n.type === \"image_generate\");\n  const look = (frames.length > 0 ? frames.map(frameLook) : scene0.map((n) => promptOf(n))).join(\"\\n\");\n  const hookClip = scene0.find((n) => n.type === \"video_generate\");\n  const hasSound =\n    hookClip?.params?.generate_audio === true ||\n    /Dialogue:|Audio:/.test(scene0Text) ||\n    nodes.some((n) => n.type === \"tts\" || n.type === \"dialogue\");\n  const layers = [hasOverlay, hasSound, look.trim().length > 40, VIBE_CUE.test(look)];\n  const layerCount = layers.filter(Boolean).length;\n  return {\n    dimension: \"hook_strength\",\n    score: round(hookClip ? layerCount / 4 : 0.5),\n    note: hookClip\n      ? `hook works on ${layerCount}/4 layers (text/sound/visual/vibe)`\n      : \"no scene-0 clip found — is this a video creative?\",\n  };\n}\n\n/** FIRST-FRAME LEGIBILITY (sound-off) — feeds autoplay muted, so the first frame\n * must read without audio. A designed overlay text layer is the strongest signal. */\nfunction scoreFirstFrameLegibility(hasOverlay: boolean): CritiqueDimension {\n  return {\n    dimension: \"first_frame_legibility\",\n    score: hasOverlay ? 1 : 0.4,\n    note: hasOverlay\n      ? \"a designed overlay layer carries the sound-off message\"\n      : \"footage-only — the first frame may not read with sound off; consider an overlay hook\",\n  };\n}\n\n/** RETENTION RISK (higher = lower risk) — long clips with no spoken line sag. */\nfunction scoreRetentionRisk(videoNodes: CanvasNode[]): CritiqueDimension {\n  let saggy = 0;\n  for (const n of videoNodes) {\n    const dur = typeof n.params?.duration === \"number\" ? n.params.duration : 0;\n    const spoken = /Dialogue:/.test(promptOf(n)) || n.params?.generate_audio === true;\n    if (dur >= 8 && !spoken) saggy += 1;\n  }\n  return {\n    dimension: \"retention_risk\",\n    score: round(videoNodes.length > 0 ? 1 - Math.min(1, saggy / videoNodes.length) : 0.7),\n    note: saggy > 0 ? `${saggy} long clip(s) with no spoken line may sag` : \"no obvious sag points\",\n  };\n}\n\n/** MECHANISM CLARITY — does the creative state WHY it works, not just what it is? */\nfunction scoreMechanismClarity(allPromptText: string): CritiqueDimension {\n  const clear = MECHANISM_CUE.test(allPromptText);\n  return {\n    dimension: \"mechanism_clarity\",\n    score: clear ? 1 : 0.4,\n    note: clear ? \"states a mechanism/proof\" : \"no clear 'why it works' — add the mechanism\",\n  };\n}\n\nfunction clamp01(n: number): number {\n  return Math.max(0, Math.min(1, n));\n}\n\n/**\n * The copy a static ad carries: the numbered lines its compiled brief quotes\n * (`static-brief.ts`), or, on a canvas no run has compiled yet, the strings of the older\n * prompt's copy block (from its header to the next blank line).\n */\nfunction staticCopyLines(nodes: CanvasNode[]): string[] {\n  const gen = nodes.find((n) => n.type === \"image_generate\");\n  const prompt = promptOf(gen);\n  const compiled = briefCopyLines(prompt);\n  if (compiled.length > 0) return compiled;\n  const start = prompt.indexOf(COPY_DIRECTIVE_HEADER);\n  if (start === -1) return [];\n  const bodyStart = start + COPY_DIRECTIVE_HEADER.length;\n  const end = prompt.indexOf(\"\\n\\n\", bodyStart);\n  const block = prompt.slice(bodyStart, end === -1 ? undefined : end);\n  const quoted = block.match(/\"[^\"]+\"/g);\n  return quoted ? quoted.map((s) => s.slice(1, -1)) : [];\n}\n\n/** TEXT LEGIBILITY RISK (higher = lower risk) — baked copy is the #1 static-ad defect,\n * and it crowds fast: past ~6 distinct copy blocks the render garbles and duplicates. */\nfunction scoreTextLegibilityRisk(copy: string[]): CritiqueDimension {\n  const lines = copy.length;\n  return {\n    dimension: \"text_legibility_risk\",\n    score: round(clamp01(1 - Math.max(0, lines - 6) / 12)),\n    note:\n      lines > 6\n        ? `${lines} copy blocks — dense; trim or split so type stays legible`\n        : `${lines} copy block(s) — reads cleanly`,\n  };\n}\n\n/** IDENTITY GROUNDING — Rule 1: every real subject grounds on a real reference (a\n * dropped `el_*` asset or its fused reference sheet), never free-generated. */\nfunction scoreIdentityGrounding(nodes: CanvasNode[]): CritiqueDimension {\n  const grounded =\n    nodes.filter((n) => n.type === \"image_reference_sheet\").length +\n    nodes.filter((n) => n.type === \"ingest\" && typeof n.id === \"string\" && /^el_/.test(n.id)).length;\n  return {\n    dimension: \"identity_grounding\",\n    // 0 grounded is fine for a pure-type ad, so it's a soft nudge, not a failure.\n    score: grounded > 0 ? 1 : 0.6,\n    note:\n      grounded > 0\n        ? `${grounded} subject(s) grounded in a real reference`\n        : \"no grounded subject — fine for a type-only ad; otherwise ground the hero in a real reference\",\n  };\n}\n\n/** TYPE FIDELITY — \"the big one\": image models don't hold a brand font, so a wired\n * font specimen that biases the render toward the real face is the strongest lever. */\nfunction scoreTypeFidelity(nodes: CanvasNode[]): CritiqueDimension {\n  const hasSpecimen = nodes.some((n) => n.type === \"font_specimen\");\n  return {\n    dimension: \"type_fidelity\",\n    score: hasSpecimen ? 1 : 0.5,\n    note: hasSpecimen\n      ? \"brand type biased by a font specimen\"\n      : \"no font specimen — brand type may drift; wire the brand font\",\n  };\n}\n\n/** VIDEO creative dimensions (hook / legibility / retention / mechanism). */\nfunction critiqueVideo(nodes: CanvasNode[], videoNodes: CanvasNode[]): CritiqueDimension[] {\n  const scene0 = nodes.filter((n) => typeof n.id === \"string\" && /^s0(?:[_a-z0-9])*_/.test(n.id));\n  const hasOverlay = nodes.some((n) => typeof n.type === \"string\" && /hyperframe/.test(n.type));\n  return [\n    scoreHookStrength(nodes, scene0, hasOverlay),\n    scoreFirstFrameLegibility(hasOverlay),\n    scoreRetentionRisk(videoNodes),\n    scoreMechanismClarity(creativeText(nodes)),\n  ];\n}\n\n/** STATIC-ad dimensions (legibility / grounding / type / mechanism). */\nfunction critiqueStatic(nodes: CanvasNode[]): CritiqueDimension[] {\n  // Only the ad's own copy: every other prompt on the canvas is the scaffold's boilerplate,\n  // and the judge's rubric alone (\"the reason the reference ad works\") read as a stated\n  // mechanism on every multi-take ad.\n  const copy = staticCopyLines(nodes);\n  const copyText = copy.join(\"\\n\");\n  return [\n    scoreTextLegibilityRisk(copy),\n    scoreIdentityGrounding(nodes),\n    scoreTypeFidelity(nodes),\n    scoreMechanismClarity(copyText),\n  ];\n}\n\n/**\n * Score a scaffolded creative. Branches on modality — a canvas with `video_generate`\n * nodes is a video creative; anything else (an `image_generate` static ad, or an empty\n * canvas) is scored on the static dimensions. All heuristics degrade gracefully rather\n * than throwing, and every dimension is advisory only.\n */\nexport function critiqueCanvas(canvas: CritiqueCanvasInput): CritiqueReport {\n  const nodes = Array.isArray(canvas.nodes) ? canvas.nodes : [];\n  const videoNodes = nodes.filter((n) => n.type === \"video_generate\");\n  const dimensions = videoNodes.length > 0 ? critiqueVideo(nodes, videoNodes) : critiqueStatic(nodes);\n  const overall = round(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);\n  return { advisory: true, overall, dimensions };\n}\n"],"mappings":"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","names":[]}