@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/chunk-4MH6LONO.js

@@ -0,0 +1,274 @@
+import {
+  chatgptDraftOpInputSchema,
+  chatgptFailure
+} from "./chunk-IOCSDFF2.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  requireChatId
+} from "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/ads/chatgpt/write-shared.ts
+import { defineCommand } from "citty";
+function fail(envelope) {
+  writeJsonEnvelope({ ...envelope });
+  process.exit(1);
+}
+function failWriteValidation(message) {
+  fail({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message,
+      fix: { action: "add_required_field", explanation: `${message}. Nothing was staged.` },
+      retryable: false
+    }
+  });
+}
+function writeFailure(err, reference) {
+  if (!(err instanceof ApiError) && err instanceof Error && err.message.includes("BAKER_CHAT_ID")) {
+    return {
+      ok: false,
+      error: {
+        code: "NO_CHAT",
+        message: err.message,
+        fix: {
+          action: "reject",
+          explanation: "ChatGPT Ads changes are staged on a chat and apply when it is published; run this from the chat."
+        },
+        retryable: false
+      }
+    };
+  }
+  return chatgptFailure(err, reference);
+}
+function decimalPlaces(value) {
+  const [mantissa, exponent] = String(value).trim().split(/e/i);
+  const written = (mantissa?.split(".")[1] ?? "").length;
+  return Math.max(0, written - (exponent ? Number(exponent) : 0));
+}
+function parseChatgptMoney(value) {
+  if (value === void 0 || value === "") {
+    return { ok: true, micros: void 0 };
+  }
+  const amount = Number(value);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    return { ok: false, reason: "must be a positive amount, for example 12.50" };
+  }
+  if (decimalPlaces(value) > 6) {
+    return { ok: false, reason: "is finer than ChatGPT Ads can express" };
+  }
+  return { ok: true, micros: Math.round(amount * 1e6) };
+}
+function microsFromArg(value, flag) {
+  const parsed = parseChatgptMoney(value);
+  if (!parsed.ok) {
+    failWriteValidation(`${flag} ${parsed.reason}`);
+  }
+  return parsed.micros;
+}
+function csvArg(value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    return void 0;
+  }
+  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function schemaArgs(args) {
+  return Object.fromEntries(
+    Object.entries(args).map(([name, arg]) => [
+      name,
+      {
+        type: arg.type === "positional" ? "string" : arg.type,
+        description: arg.description,
+        required: arg.required === true
+      }
+    ])
+  );
+}
+function lowerArg(value) {
+  return typeof value === "string" && value.trim() !== "" ? value.trim().toLowerCase() : void 0;
+}
+function lowerCsvArg(value) {
+  return csvArg(value)?.map((part) => part.toLowerCase());
+}
+function compact(payload) {
+  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0 && value !== ""));
+}
+function requireTarget(args, name) {
+  const value = args[name];
+  if (typeof value !== "string" || value.trim().length === 0) {
+    failWriteValidation(`${name} is required`);
+  }
+  return value.trim();
+}
+function requireTargets(args, name) {
+  const ids = csvArg(args[name]);
+  if (!ids) {
+    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
+  }
+  return ids;
+}
+function preflight(raw) {
+  const parsed = chatgptDraftOpInputSchema.safeParse(raw);
+  if (parsed.success) {
+    return parsed.data;
+  }
+  const fields = parsed.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
+  const message = fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; ");
+  return fail({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message,
+      fix: {
+        action: "retry_with_modified_query",
+        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is as it was before this call."
+      },
+      retryable: false
+    }
+  });
+}
+async function postStage(chatId, op) {
+  return await apiPost("/api/ads/chatgpt/draft/stage", { chatId, op });
+}
+async function stageChatgptOp(raw, reference, hintsFor) {
+  const op = preflight(raw);
+  try {
+    const staged = await postStage(requireChatId(), op);
+    const hints = hintsFor?.(staged) ?? [];
+    writeJsonEnvelope({ ok: true, data: staged, ...hints.length > 0 ? { hints } : {} });
+  } catch (err) {
+    fail(writeFailure(err, reference));
+  }
+}
+async function stageChatgptOps(raws, reference) {
+  if (raws.length === 1 && raws[0]) {
+    await stageChatgptOp(raws[0], reference);
+    return;
+  }
+  const ops = raws.map(preflight);
+  const staged = [];
+  try {
+    const chatId = requireChatId();
+    for (const op of ops) {
+      staged.push(await postStage(chatId, op));
+    }
+    writeJsonEnvelope({ ok: true, data: staged });
+  } catch (err) {
+    const failure = writeFailure(err, reference);
+    if (staged.length > 0) {
+      failure.error.message = `${failure.error.message} (already staged: ${staged.map((s) => s.summary).join("; ")})`;
+    }
+    fail(failure);
+  }
+}
+function clearableCsvArg(value) {
+  return typeof value === "string" && value.trim().toLowerCase() === "none" ? [] : csvArg(value);
+}
+function clearableArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  return value.trim().toLowerCase() === "none" ? null : value.trim();
+}
+function cropArg(value, flag) {
+  const parts = csvArg(value);
+  if (!parts) {
+    return void 0;
+  }
+  const numbers = parts.map(Number);
+  const [x, y, width, height] = numbers;
+  if (numbers.length !== 4 || numbers.some(Number.isNaN) || x === void 0 || y === void 0 || width === void 0 || height === void 0) {
+    failWriteValidation(`${flag} takes four shares of the image, x,y,width,height \u2014 e.g. 0.1,0,0.8,0.8`);
+  }
+  return { x, y, width, height };
+}
+var STATUS_OF = {
+  pause: "paused",
+  resume: "active",
+  archive: "archived"
+};
+function statusOps(entity, ids, status) {
+  return ids.map((id) => ({ kind: `${entity}.update`, target: id, payload: { status } }));
+}
+var STATUS_NOUN = {
+  campaign: { command: "campaigns", plural: "campaigns", example: "cmpn_123,cmpn_456" },
+  adGroup: { command: "ad-groups", plural: "ad groups", example: "adgrp_123,adgrp_456" },
+  ad: { command: "ads", plural: "cards", example: "ad_123,ad_456" }
+};
+var STATUS_DOING = { pause: "pausing", resume: "resuming", archive: "archiving" };
+function statusCommand(entity, verb, reference) {
+  const noun = STATUS_NOUN[entity];
+  const args = {
+    ids: { type: "positional", description: `${noun.plural} ids, comma-separated`, required: true }
+  };
+  const forGood = verb === "archive" ? ` Archiving is for good: ChatGPT Ads cannot bring archived ${noun.plural} back, and their results stay in reports. Pause instead unless the user asked to archive.` : "";
+  registerSchema({
+    command: `ads.chatgpt.${noun.command}.${verb}`,
+    description: `Stage ${STATUS_DOING[verb]} one or more ChatGPT Ads ${noun.plural}. Pass every id in one call.${forGood}`,
+    args: schemaArgs(args)
+  });
+  return defineCommand({
+    meta: {
+      name: verb,
+      description: `Stage ${STATUS_DOING[verb]} ${noun.plural}.${forGood}
+
+Example:
+  baker ads chatgpt ${noun.command} ${verb} ${noun.example}`
+    },
+    args,
+    run: async ({ args: parsed }) => {
+      await stageChatgptOps(statusOps(entity, requireTargets(parsed, "ids"), STATUS_OF[verb]), reference);
+    }
+  });
+}
+function productFiltersArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  return value.split(";").map((condition) => condition.trim()).filter(Boolean).map((condition) => {
+    const match = /^(\S+)\s+(\S+)\s+(.+)$/.exec(condition);
+    if (!match?.[1] || !match[2] || !match[3]) {
+      failWriteValidation(
+        `"${condition}" is not a product filter \u2014 write field operator values, e.g. price lte 5000`
+      );
+    }
+    return {
+      field: match[1],
+      operator: match[2].toLowerCase(),
+      values: match[3].split("|").map((part) => part.trim()).filter(Boolean)
+    };
+  });
+}
+
+export {
+  failWriteValidation,
+  microsFromArg,
+  csvArg,
+  schemaArgs,
+  lowerArg,
+  lowerCsvArg,
+  compact,
+  requireTarget,
+  requireTargets,
+  stageChatgptOp,
+  stageChatgptOps,
+  clearableCsvArg,
+  clearableArg,
+  cropArg,
+  statusCommand,
+  productFiltersArg
+};
+//# sourceMappingURL=chunk-4MH6LONO.js.map

package/dist/chunk-4MH6LONO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/write-shared.ts"],"sourcesContent":["import { type ChatgptDraftStageResponse, chatgptDraftOpInputSchema } from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport type { AdsErrorEnvelope } from \"../types.ts\";\nimport { chatgptFailure } from \"./shared.ts\";\n\n/**\n * Shared plumbing for the staged ChatGPT Ads write commands.\n *\n * Writes never reach ChatGPT Ads from here: every command stages an op on this\n * chat's draft (`/api/ads/chatgpt/draft/stage`), the dashboard shows it as a\n * pending change, and it applies only when the chat is published.\n */\n\nfunction fail(envelope: AdsErrorEnvelope): never {\n  writeJsonEnvelope({ ...envelope });\n  process.exit(1);\n}\n\nexport function failWriteValidation(message: string): never {\n  fail({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message,\n      fix: { action: \"add_required_field\", explanation: `${message}. Nothing was staged.` },\n      retryable: false,\n    },\n  });\n}\n\n/** A write failure, as the agent should act on it; a missing chat is not a network error. */\nfunction writeFailure(err: unknown, reference: string): AdsErrorEnvelope {\n  if (!(err instanceof ApiError) && err instanceof Error && err.message.includes(\"BAKER_CHAT_ID\")) {\n    return {\n      ok: false,\n      error: {\n        code: \"NO_CHAT\",\n        message: err.message,\n        fix: {\n          action: \"reject\",\n          explanation:\n            \"ChatGPT Ads changes are staged on a chat and apply when it is published; run this from the chat.\",\n        },\n        retryable: false,\n      },\n    };\n  }\n  return chatgptFailure(err, reference);\n}\n\n/**\n * Digits after the decimal point, read off the written amount: `String(0.0000005)`\n * is `\"5e-7\"`, whose mantissa has no decimals at all.\n */\nfunction decimalPlaces(value: unknown): number {\n  const [mantissa, exponent] = String(value).trim().split(/e/i);\n  const written = (mantissa?.split(\".\")[1] ?? \"\").length;\n  return Math.max(0, written - (exponent ? Number(exponent) : 0));\n}\n\nexport type ChatgptMoneyParse = { ok: true; micros: number | undefined } | { ok: false; reason: string };\n\n/**\n * ChatGPT Ads takes money as integer micros of the account currency; the CLI\n * takes the amount a person writes. Counting decimals instead of comparing\n * `amount * 1e6` with its rounding is exact at every magnitude.\n */\nexport function parseChatgptMoney(value: unknown): ChatgptMoneyParse {\n  if (value === undefined || value === \"\") {\n    return { ok: true, micros: undefined };\n  }\n  const amount = Number(value);\n  if (!Number.isFinite(amount) || amount <= 0) {\n    return { ok: false, reason: \"must be a positive amount, for example 12.50\" };\n  }\n  if (decimalPlaces(value) > 6) {\n    return { ok: false, reason: \"is finer than ChatGPT Ads can express\" };\n  }\n  return { ok: true, micros: Math.round(amount * 1_000_000) };\n}\n\nexport function microsFromArg(value: unknown, flag: string): number | undefined {\n  const parsed = parseChatgptMoney(value);\n  if (!parsed.ok) {\n    failWriteValidation(`${flag} ${parsed.reason}`);\n  }\n  return parsed.micros;\n}\n\nexport function csvArg(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    return undefined;\n  }\n  const parts = value\n    .split(\",\")\n    .map((part) => part.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\ninterface CliArg {\n  type: string;\n  description: string;\n  required?: boolean;\n}\n\n/**\n * The `baker schema` entry for a command, read off the flags it really takes,\n * so the introspection an agent plans from cannot drift from the command.\n */\nexport function schemaArgs(args: Record<string, CliArg>) {\n  return Object.fromEntries(\n    Object.entries(args).map(([name, arg]) => [\n      name,\n      {\n        type: arg.type === \"positional\" ? \"string\" : arg.type,\n        description: arg.description,\n        required: arg.required === true,\n      },\n    ]),\n  );\n}\n\n/** A flag naming one of ChatGPT Ads' lowercase values, taken in whatever case it was typed. */\nexport function lowerArg(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() !== \"\" ? value.trim().toLowerCase() : undefined;\n}\n\n/** A comma-separated list of those values. */\nexport function lowerCsvArg(value: unknown): string[] | undefined {\n  return csvArg(value)?.map((part) => part.toLowerCase());\n}\n\n/** Drop unset keys so an omitted flag never stages as an explicit value. */\nexport function compact(payload: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== undefined && value !== \"\"));\n}\n\nexport function requireTarget(args: Record<string, unknown>, name: string): string {\n  const value = args[name];\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    failWriteValidation(`${name} is required`);\n  }\n  return value.trim();\n}\n\nexport function requireTargets(args: Record<string, unknown>, name: string): string[] {\n  const ids = csvArg(args[name]);\n  if (!ids) {\n    failWriteValidation(`${name} is required — pass one or more ids, comma-separated`);\n  }\n  return ids;\n}\n\n/** The op, checked against the same schema the backend applies, before anything is sent. */\nfunction preflight(raw: Record<string, unknown>) {\n  const parsed = chatgptDraftOpInputSchema.safeParse(raw);\n  if (parsed.success) {\n    return parsed.data;\n  }\n  const fields = parsed.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message }));\n  const message = fields.map((field) => (field.path ? `${field.path}: ${field.message}` : field.message)).join(\"; \");\n  return fail({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message,\n      fix: {\n        action: \"retry_with_modified_query\",\n        explanation:\n          \"Fix the named fields and stage again. Nothing was staged — the draft is as it was before this call.\",\n      },\n      retryable: false,\n    },\n  });\n}\n\n/** The ChatGPT Ads routes answer with the payload itself; the envelope is the CLI's to add. */\nasync function postStage(chatId: string, op: ReturnType<typeof preflight>): Promise<ChatgptDraftStageResponse> {\n  return await apiPost<ChatgptDraftStageResponse>(\"/api/ads/chatgpt/draft/stage\", { chatId, op });\n}\n\n/** Stage one op and print what was staged; `hintsFor` names the obvious next step. */\nexport async function stageChatgptOp(\n  raw: Record<string, unknown>,\n  reference: string,\n  hintsFor?: (staged: ChatgptDraftStageResponse) => string[],\n): Promise<void> {\n  const op = preflight(raw);\n  try {\n    const staged = await postStage(requireChatId(), op);\n    const hints = hintsFor?.(staged) ?? [];\n    writeJsonEnvelope({ ok: true, data: staged, ...(hints.length > 0 ? { hints } : {}) });\n  } catch (err) {\n    fail(writeFailure(err, reference));\n  }\n}\n\n/**\n * Stage the same change on several entities (a pause across campaigns). Each is\n * its own op; when one is refused, the ones already staged are named so the\n * agent neither re-stages nor loses them.\n */\nexport async function stageChatgptOps(raws: Array<Record<string, unknown>>, reference: string): Promise<void> {\n  if (raws.length === 1 && raws[0]) {\n    await stageChatgptOp(raws[0], reference);\n    return;\n  }\n  const ops = raws.map(preflight);\n  const staged: ChatgptDraftStageResponse[] = [];\n  try {\n    const chatId = requireChatId();\n    for (const op of ops) {\n      staged.push(await postStage(chatId, op));\n    }\n    writeJsonEnvelope({ ok: true, data: staged });\n  } catch (err) {\n    const failure = writeFailure(err, reference);\n    if (staged.length > 0) {\n      failure.error.message = `${failure.error.message} (already staged: ${staged.map((s) => s.summary).join(\"; \")})`;\n    }\n    fail(failure);\n  }\n}\n\n/** On an update, `none` empties a list — ChatGPT Ads' way to clear exclusions, audiences or regions. */\nexport function clearableCsvArg(value: unknown): string[] | undefined {\n  return typeof value === \"string\" && value.trim().toLowerCase() === \"none\" ? [] : csvArg(value);\n}\n\n/** On an update, `none` removes the value — a tracking template. */\nexport function clearableArg(value: unknown): string | null | undefined {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    return undefined;\n  }\n  return value.trim().toLowerCase() === \"none\" ? null : value.trim();\n}\n\n/** A crop as `x,y,width,height`, each a share of the image from 0 to 1. */\nexport function cropArg(\n  value: unknown,\n  flag: string,\n): { x: number; y: number; width: number; height: number } | undefined {\n  const parts = csvArg(value);\n  if (!parts) {\n    return undefined;\n  }\n  const numbers = parts.map(Number);\n  const [x, y, width, height] = numbers;\n  if (\n    numbers.length !== 4 ||\n    numbers.some(Number.isNaN) ||\n    x === undefined ||\n    y === undefined ||\n    width === undefined ||\n    height === undefined\n  ) {\n    failWriteValidation(`${flag} takes four shares of the image, x,y,width,height — e.g. 0.1,0,0.8,0.8`);\n  }\n  return { x, y, width, height };\n}\n\ntype StatusEntity = \"campaign\" | \"adGroup\" | \"ad\";\ntype StatusVerb = \"pause\" | \"resume\" | \"archive\";\n\nconst STATUS_OF: Record<StatusVerb, \"paused\" | \"active\" | \"archived\"> = {\n  pause: \"paused\",\n  resume: \"active\",\n  archive: \"archived\",\n};\n\nexport function statusOps(entity: StatusEntity, ids: readonly string[], status: \"paused\" | \"active\" | \"archived\") {\n  return ids.map((id) => ({ kind: `${entity}.update`, target: id, payload: { status } }));\n}\n\nconst STATUS_NOUN: Record<StatusEntity, { command: string; plural: string; example: string }> = {\n  campaign: { command: \"campaigns\", plural: \"campaigns\", example: \"cmpn_123,cmpn_456\" },\n  adGroup: { command: \"ad-groups\", plural: \"ad groups\", example: \"adgrp_123,adgrp_456\" },\n  ad: { command: \"ads\", plural: \"cards\", example: \"ad_123,ad_456\" },\n};\n\nconst STATUS_DOING: Record<StatusVerb, string> = { pause: \"pausing\", resume: \"resuming\", archive: \"archiving\" };\n\n/** `pause`, `resume` or `archive` for every id passed, staged as one change each. */\nexport function statusCommand(entity: StatusEntity, verb: StatusVerb, reference: string) {\n  const noun = STATUS_NOUN[entity];\n  const args = {\n    ids: { type: \"positional\", description: `${noun.plural} ids, comma-separated`, required: true },\n  } as const;\n  const forGood =\n    verb === \"archive\"\n      ? ` Archiving is for good: ChatGPT Ads cannot bring archived ${noun.plural} back, and their results stay in reports. Pause instead unless the user asked to archive.`\n      : \"\";\n  registerSchema({\n    command: `ads.chatgpt.${noun.command}.${verb}`,\n    description: `Stage ${STATUS_DOING[verb]} one or more ChatGPT Ads ${noun.plural}. Pass every id in one call.${forGood}`,\n    args: schemaArgs(args),\n  });\n  return defineCommand({\n    meta: {\n      name: verb,\n      description: `Stage ${STATUS_DOING[verb]} ${noun.plural}.${forGood}\n\nExample:\n  baker ads chatgpt ${noun.command} ${verb} ${noun.example}`,\n    },\n    args,\n    run: async ({ args: parsed }) => {\n      await stageChatgptOps(statusOps(entity, requireTargets(parsed, \"ids\"), STATUS_OF[verb]), reference);\n    },\n  });\n}\n\n/**\n * Product filters as a marketer writes them: `brand in Acme|Baker; price lte 5000`\n * — conditions split by `;`, each field, operator and values (several joined\n * with `|`). `none` is no filter: the whole catalog.\n */\nexport function productFiltersArg(\n  value: unknown,\n): Array<{ field: string; operator: string; values: string[] }> | undefined {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    return undefined;\n  }\n  if (value.trim().toLowerCase() === \"none\") {\n    return [];\n  }\n  return value\n    .split(\";\")\n    .map((condition) => condition.trim())\n    .filter(Boolean)\n    .map((condition) => {\n      const match = /^(\\S+)\\s+(\\S+)\\s+(.+)$/.exec(condition);\n      if (!match?.[1] || !match[2] || !match[3]) {\n        failWriteValidation(\n          `\"${condition}\" is not a product filter — write field operator values, e.g. price lte 5000`,\n        );\n      }\n      return {\n        field: match[1],\n        operator: match[2].toLowerCase(),\n        values: match[3]\n          .split(\"|\")\n          .map((part) => part.trim())\n          .filter(Boolean),\n      };\n    });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-4NZ47VXO.js

@@ -0,0 +1,137 @@
+// src/engine/copy-tells/questions.ts
+var ANY_LANGUAGE = "The copy may be in any language; judge the construction, not the words.";
+var TELL_QUESTIONS = [
+  {
+    id: "rhetorical-opener",
+    question: `Does \`sentence\` open with a fake-candid pause before an ordinary claim, such as "Honestly?", "Here's the thing:", "Look,", "Let's be real", "La verdad es que", "Seamos sinceros"? A sentence that simply starts with its claim does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.75
+  },
+  {
+    id: "negation-pivot",
+    question: `Is \`sentence\` built as a negative parallelism that denies a smaller framing to assert a bigger one, such as "It's not just a CRM, it's a growth engine", "Not only X but also Y", "No se trata solo de X, sino de Y", or a short "Not a tool." answered by "A partner." (\`before\` is the sentence before it, for that two-sentence form)? A plain negative fact ("No setup fee", "We don't sell your data") does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "participle-tail",
+    question: `Does \`sentence\` end with a participle or gerund phrase hung off a comma to add vague significance, such as ", ensuring nothing slips through", ", fostering growth", ", permitiendo cerrar el mes antes"? A sentence that opens with such a word does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "copula-avoidance",
+    question: `Does \`sentence\` use an inflated verb where a plain "is" or "has" would do, such as "serves as", "stands as", "boasts", "se erige como", "cuenta con"? ${ANY_LANGUAGE}`,
+    threshold: 0.6
+  },
+  {
+    id: "authority-trope",
+    question: `Does \`sentence\` claim to reveal what is "really" at stake, with a phrase like "The real question is", "At its core", "What really matters is", "The heart of the matter", "En el fondo", "Lo que realmente importa"? Candid openers ("Honestly", "To be fair"), contrasts ("not just X, but Y") and filler words are other tells and do not count here. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "signposting",
+    question: `Does \`sentence\` announce what the text is about to explain instead of saying it, such as "Let's dive in", "Here's what you need to know", "Let's break it down", "Vamos a ver c\xF3mo funciona"? Presenting the offer itself ("Here is a plan for every team size", "Aqu\xED tienes nuestras tarifas") and an assistant handing over a summary are not this. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "chat-artifact",
+    question: `Is \`sentence\` an AI assistant talking to the person who asked it for the text, pasted into the page by mistake, such as "I hope this helps!", "Let me know if you want changes", "Here is an overview of the plan", "Would you like me to", "Aqu\xED tienes el resumen"? Copy that speaks to the page's own visitor ("Here are our three plans", "Tell us what you need") does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.62
+  },
+  {
+    id: "vague-attribution",
+    question: `Does \`sentence\` credit a claim to unnamed authorities, such as "Experts agree", "Studies show", "Research shows", "Los expertos coinciden", without naming who? ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "hollow-conclusion",
+    question: `Is \`sentence\` a vague upbeat ending that asserts nothing, such as "The future looks bright", "The possibilities are endless", "El cielo es el l\xEDmite"? ${ANY_LANGUAGE}`,
+    threshold: 0.65
+  },
+  {
+    id: "filler-phrase",
+    question: `Does \`sentence\` contain a wordy filler phrase that carries no meaning, such as "in order to", "due to the fact that", "it is worth noting that", "cabe destacar"? ${ANY_LANGUAGE}`,
+    threshold: 0.75
+  },
+  {
+    id: "aphorism-formula",
+    question: `Is \`sentence\` an aphorism of the form "X is the <abstract noun> of Y", such as "Trust is the currency of every deal", "Data is the language of growth", "Los datos son la columna vertebral de tu negocio"? Other contrasts and slogans do not count. ${ANY_LANGUAGE}`,
+    threshold: 0.7
+  },
+  {
+    id: "false-range",
+    question: `Does \`sentence\` use a "from X to Y" range whose two ends are not points on one scale, such as "from onboarding to retention", "from startups to enterprises", "desde la captaci\xF3n hasta la fidelizaci\xF3n"? A real range of numbers, prices or dates ("from $9 to $99") does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  }
+];
+function tellQuestionsFor(sentence) {
+  return TELL_QUESTIONS.map((t) => ({
+    instructions: {
+      sentence: sentence.text,
+      ...t.id === "negation-pivot" && sentence.before ? { before: sentence.before } : {},
+      question: t.question
+    }
+  }));
+}
+var SAME_CLAIM_QUESTION = `\`a\` and \`b\` are two headlines of the same ad. Are they the same claim reworded, a synonym or a swapped verb apart ("Boost Your Sales Fast" and "Increase Your Sales Fast"), rather than two different claims (a price, a guarantee, a delivery time, a rating)? ${ANY_LANGUAGE}`;
+var SAME_CLAIM_HELD = 0.5;
+function sameClaimQuestion(a, b) {
+  return { instructions: { a, b, question: SAME_CLAIM_QUESTION } };
+}
+
+// src/engine/copy-tells/sentences.ts
+var SENTENCES = new Intl.Segmenter(void 0, { granularity: "sentence" });
+var WORDS = new Intl.Segmenter(void 0, { granularity: "word" });
+function wordCount(text) {
+  let n = 0;
+  for (const s of WORDS.segment(text)) if (s.isWordLike) n++;
+  return n;
+}
+function rawSentences(text) {
+  return [...SENTENCES.segment(text)].map((s) => s.segment.trim()).filter(Boolean);
+}
+function blockSentences(block, offset) {
+  const out = [];
+  let pending = null;
+  for (const segment of SENTENCES.segment(block)) {
+    const trimmed = segment.segment.trim().replace(/\s+/g, " ");
+    if (!trimmed) continue;
+    const start = offset + segment.index + (segment.segment.length - segment.segment.trimStart().length);
+    const joined = pending ? { text: `${pending.text} ${trimmed}`, start: pending.start } : { text: trimmed, start };
+    pending = wordCount(joined.text) < 2 ? joined : null;
+    if (!pending) out.push(joined);
+  }
+  if (pending && wordCount(pending.text) > 0) out.push(pending);
+  return out;
+}
+var BLOCK_END = /\n[^\S\n]*\n/g;
+function copySentences(copy) {
+  const out = [];
+  let offset = 0;
+  for (const end of [...copy.matchAll(BLOCK_END), null]) {
+    const to = end ? end.index : copy.length;
+    blockSentences(copy.slice(offset, to).replaceAll("\n", " "), offset).forEach((s, i, all) => {
+      const before = all[i - 1]?.text;
+      out.push({ ...s, ...before ? { before } : {} });
+    });
+    if (end) offset = end.index + end[0].length;
+  }
+  return out;
+}
+
+// src/engine/copy-tells/patterns.ts
+var STACCATO_MAX_WORDS = 4;
+var STACCATO_RUN = 3;
+var HEADLINE_SET_FLOOR = 3;
+
+export {
+  STACCATO_MAX_WORDS,
+  STACCATO_RUN,
+  HEADLINE_SET_FLOOR,
+  TELL_QUESTIONS,
+  tellQuestionsFor,
+  SAME_CLAIM_HELD,
+  sameClaimQuestion,
+  wordCount,
+  rawSentences,
+  copySentences
+};
+//# sourceMappingURL=chunk-4NZ47VXO.js.map

package/dist/chunk-4NZ47VXO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/copy-tells/questions.ts","../src/engine/copy-tells/sentences.ts","../src/engine/copy-tells/patterns.ts"],"sourcesContent":["/**\n * The AI copy tells that are a reading of the words, asked of the decision model (Jev) one\n * sentence at a time, in whatever language the copy is written.\n *\n * The observation set is Wikipedia's \"Signs of AI writing\" (WikiProject AI Cleanup), via the\n * `humanizer` skill (MIT, github.com/blader/humanizer): which constructions models over-produce.\n * It used to be phrase lists in English and Spanish, so a Portuguese, German or French page passed\n * clean and a paraphrase of a listed phrase did too. The examples in each question are examples:\n * Jev reads the construction, not the words. Thresholds were measured on\n * scripts/copy-tells-evals (docs/decision-model.md).\n *\n * The tells that are a shape rather than a reading (a run of very short sentences, Title Case in\n * a heading, emoji, curly quotes, an inline-header list) stay in code: `detect.ts`.\n */\nimport type { NoulQuestion } from \"../lib/remembered-nouls.ts\";\n\nexport type JudgedTellId =\n  | \"rhetorical-opener\"\n  | \"negation-pivot\"\n  | \"participle-tail\"\n  | \"copula-avoidance\"\n  | \"authority-trope\"\n  | \"signposting\"\n  | \"chat-artifact\"\n  | \"vague-attribution\"\n  | \"hollow-conclusion\"\n  | \"filler-phrase\"\n  | \"aphorism-formula\"\n  | \"false-range\";\n\ntype TellQuestion = {\n  id: JudgedTellId;\n  question: string;\n  /** At or above this, the sentence carries the tell. Measured per question. */\n  threshold: number;\n};\n\nconst ANY_LANGUAGE = \"The copy may be in any language; judge the construction, not the words.\";\n\nexport const TELL_QUESTIONS: readonly TellQuestion[] = [\n  {\n    id: \"rhetorical-opener\",\n    question: `Does \\`sentence\\` open with a fake-candid pause before an ordinary claim, such as \"Honestly?\", \"Here's the thing:\", \"Look,\", \"Let's be real\", \"La verdad es que\", \"Seamos sinceros\"? A sentence that simply starts with its claim does not count. ${ANY_LANGUAGE}`,\n    threshold: 0.75,\n  },\n  {\n    id: \"negation-pivot\",\n    question: `Is \\`sentence\\` built as a negative parallelism that denies a smaller framing to assert a bigger one, such as \"It's not just a CRM, it's a growth engine\", \"Not only X but also Y\", \"No se trata solo de X, sino de Y\", or a short \"Not a tool.\" answered by \"A partner.\" (\\`before\\` is the sentence before it, for that two-sentence form)? A plain negative fact (\"No setup fee\", \"We don't sell your data\") does not count. ${ANY_LANGUAGE}`,\n    threshold: 0.5,\n  },\n  {\n    id: \"participle-tail\",\n    question: `Does \\`sentence\\` end with a participle or gerund phrase hung off a comma to add vague significance, such as \", ensuring nothing slips through\", \", fostering growth\", \", permitiendo cerrar el mes antes\"? A sentence that opens with such a word does not count. ${ANY_LANGUAGE}`,\n    threshold: 0.5,\n  },\n  {\n    id: \"copula-avoidance\",\n    question: `Does \\`sentence\\` use an inflated verb where a plain \"is\" or \"has\" would do, such as \"serves as\", \"stands as\", \"boasts\", \"se erige como\", \"cuenta con\"? ${ANY_LANGUAGE}`,\n    threshold: 0.6,\n  },\n  {\n    id: \"authority-trope\",\n    question: `Does \\`sentence\\` claim to reveal what is \"really\" at stake, with a phrase like \"The real question is\", \"At its core\", \"What really matters is\", \"The heart of the matter\", \"En el fondo\", \"Lo que realmente importa\"? Candid openers (\"Honestly\", \"To be fair\"), contrasts (\"not just X, but Y\") and filler words are other tells and do not count here. ${ANY_LANGUAGE}`,\n    threshold: 0.5,\n  },\n  {\n    id: \"signposting\",\n    question: `Does \\`sentence\\` announce what the text is about to explain instead of saying it, such as \"Let's dive in\", \"Here's what you need to know\", \"Let's break it down\", \"Vamos a ver cómo funciona\"? Presenting the offer itself (\"Here is a plan for every team size\", \"Aquí tienes nuestras tarifas\") and an assistant handing over a summary are not this. ${ANY_LANGUAGE}`,\n    threshold: 0.5,\n  },\n  {\n    id: \"chat-artifact\",\n    question: `Is \\`sentence\\` an AI assistant talking to the person who asked it for the text, pasted into the page by mistake, such as \"I hope this helps!\", \"Let me know if you want changes\", \"Here is an overview of the plan\", \"Would you like me to\", \"Aquí tienes el resumen\"? Copy that speaks to the page's own visitor (\"Here are our three plans\", \"Tell us what you need\") does not count. ${ANY_LANGUAGE}`,\n    threshold: 0.62,\n  },\n  {\n    id: \"vague-attribution\",\n    question: `Does \\`sentence\\` credit a claim to unnamed authorities, such as \"Experts agree\", \"Studies show\", \"Research shows\", \"Los expertos coinciden\", without naming who? ${ANY_LANGUAGE}`,\n    threshold: 0.5,\n  },\n  {\n    id: \"hollow-conclusion\",\n    question: `Is \\`sentence\\` a vague upbeat ending that asserts nothing, such as \"The future looks bright\", \"The possibilities are endless\", \"El cielo es el límite\"? ${ANY_LANGUAGE}`,\n    threshold: 0.65,\n  },\n  {\n    id: \"filler-phrase\",\n    question: `Does \\`sentence\\` contain a wordy filler phrase that carries no meaning, such as \"in order to\", \"due to the fact that\", \"it is worth noting that\", \"cabe destacar\"? ${ANY_LANGUAGE}`,\n    threshold: 0.75,\n  },\n  {\n    id: \"aphorism-formula\",\n    question: `Is \\`sentence\\` an aphorism of the form \"X is the <abstract noun> of Y\", such as \"Trust is the currency of every deal\", \"Data is the language of growth\", \"Los datos son la columna vertebral de tu negocio\"? Other contrasts and slogans do not count. ${ANY_LANGUAGE}`,\n    threshold: 0.7,\n  },\n  {\n    id: \"false-range\",\n    question: `Does \\`sentence\\` use a \"from X to Y\" range whose two ends are not points on one scale, such as \"from onboarding to retention\", \"from startups to enterprises\", \"desde la captación hasta la fidelización\"? A real range of numbers, prices or dates (\"from $9 to $99\") does not count. ${ANY_LANGUAGE}`,\n    threshold: 0.5,\n  },\n];\n\n/** One sentence of copy, and the one before it in the same block, when there is one. */\nexport type CopySentence = { text: string; before?: string };\n\n/** The tell questions for one sentence, in `TELL_QUESTIONS` order. Pure. */\nexport function tellQuestionsFor(sentence: CopySentence): NoulQuestion[] {\n  return TELL_QUESTIONS.map((t) => ({\n    instructions: {\n      sentence: sentence.text,\n      ...(t.id === \"negation-pivot\" && sentence.before ? { before: sentence.before } : {}),\n      question: t.question,\n    },\n  }));\n}\n\n/**\n * Synonym cycling (§11): headlines of one ad that are one claim reworded with a swapped verb. Both\n * an AI tell and a real Google Ads defect, since a cycled set gives the auction nothing to choose\n * between. Asked of each pair of a set; it replaced a table of English and Spanish verb synonyms.\n */\nexport const SAME_CLAIM_QUESTION = `\\`a\\` and \\`b\\` are two headlines of the same ad. Are they the same claim reworded, a synonym or a swapped verb apart (\"Boost Your Sales Fast\" and \"Increase Your Sales Fast\"), rather than two different claims (a price, a guarantee, a delivery time, a rating)? ${ANY_LANGUAGE}`;\nexport const SAME_CLAIM_HELD = 0.5;\n\nexport function sameClaimQuestion(a: string, b: string): NoulQuestion {\n  return { instructions: { a, b, question: SAME_CLAIM_QUESTION } };\n}\n","/**\n * Copy cut into the sentences the decision model reads one at a time. ICU's sentence and word\n * segmentation (`Intl.Segmenter`) does the cutting, so it holds in any script, Japanese and Thai\n * included, with no list of abbreviations or punctuation of our own.\n */\n\nexport type LocatedSentence = {\n  text: string;\n  /** Where the sentence starts in the copy, in UTF-16 code units. */\n  start: number;\n  /** The sentence before it in the same block, for a construction that spans two. */\n  before?: string;\n};\n\nconst SENTENCES = new Intl.Segmenter(undefined, { granularity: \"sentence\" });\nconst WORDS = new Intl.Segmenter(undefined, { granularity: \"word\" });\n\n/** How many words `text` holds, in any script. Pure. */\nexport function wordCount(text: string): number {\n  let n = 0;\n  for (const s of WORDS.segment(text)) if (s.isWordLike) n++;\n  return n;\n}\n\n/** Every sentence of `text` exactly as written, a one-word one included. Pure. */\nexport function rawSentences(text: string): string[] {\n  return [...SENTENCES.segment(text)].map((s) => s.segment.trim()).filter(Boolean);\n}\n\n/** The sentences of one block, each located from `offset`, a one-word one joined to the next. */\nfunction blockSentences(block: string, offset: number): Array<{ text: string; start: number }> {\n  const out: Array<{ text: string; start: number }> = [];\n  let pending: { text: string; start: number } | null = null;\n  for (const segment of SENTENCES.segment(block)) {\n    const trimmed = segment.segment.trim().replace(/\\s+/g, \" \");\n    if (!trimmed) continue;\n    const start = offset + segment.index + (segment.segment.length - segment.segment.trimStart().length);\n    const joined: { text: string; start: number } = pending\n      ? { text: `${pending.text} ${trimmed}`, start: pending.start }\n      : { text: trimmed, start };\n    pending = wordCount(joined.text) < 2 ? joined : null;\n    if (!pending) out.push(joined);\n  }\n  if (pending && wordCount(pending.text) > 0) out.push(pending);\n  return out;\n}\n\n/** A blank line: what ends a block, in Markdown and in page copy, where block tags leave one. */\nconst BLOCK_END = /\\n[^\\S\\n]*\\n/g;\n\n/**\n * Every sentence of `copy`, block by block (a blank line ends a block; a single line break is a\n * soft wrap, read as a space). A one-word sentence is kept with the one it opens (\"Honestly? It\n * depends.\"): alone it says nothing to judge. Pure.\n */\nexport function copySentences(copy: string): LocatedSentence[] {\n  const out: LocatedSentence[] = [];\n  let offset = 0;\n  for (const end of [...copy.matchAll(BLOCK_END), null]) {\n    const to = end ? end.index : copy.length;\n    blockSentences(copy.slice(offset, to).replaceAll(\"\\n\", \" \"), offset).forEach((s, i, all) => {\n      const before = all[i - 1]?.text;\n      out.push({ ...s, ...(before ? { before } : {}) });\n    });\n    if (end) offset = end.index + end[0].length;\n  }\n  return out;\n}\n","/**\n * AI copy tells — the ids, and the measures of the tells that are a shape.\n *\n * The observation set is Wikipedia's \"Signs of AI writing\" (WikiProject AI Cleanup) via the\n * `humanizer` skill (MIT, github.com/blader/humanizer): which constructions models over-produce.\n * The tells that read the words are questions to the decision model (`questions.ts`), in any\n * language; the ones here are measured in code and hold in any language too.\n *\n * Callers own the thresholds: a single tell in a 30-character Google headline is damning, the\n * same tell in a long landing is noise.\n */\nimport type { JudgedTellId } from \"./questions.ts\";\n\n/** The tells this module can report. */\nexport type CopyTellId =\n  | JudgedTellId\n  | \"staccato-drama\"\n  | \"curly-quote\"\n  | \"emoji\"\n  | \"inline-header-list\"\n  | \"title-case-heading\"\n  | \"synonym-cycling\";\n\n/** Staccato drama (§31): N consecutive sentences at or under this word count. */\nexport const STACCATO_MAX_WORDS = 4;\nexport const STACCATO_RUN = 3;\n\n/** Below this many headlines there is no \"set\" to judge for synonym cycling (§11). */\nexport const HEADLINE_SET_FLOOR = 3;\n"],"mappings":"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","names":[]}