@koda-sl/baker-cli 0.571.0 → 0.572.0-dev.61ba69c66

package/dist/chunk-3BKESS5W.js

@@ -0,0 +1,66 @@
+import {
+  recordIdeaLines
+} from "./chunk-AYX7PB2L.js";
+import {
+  anchorLines,
+  readIdeaAnchor
+} from "./chunk-2W6DMVGH.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-4CYB33V3.js";
+
+// src/commands/creatives/idea-hint.ts
+import path from "path";
+function present(fields) {
+  const said = Object.entries(fields).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0));
+  return Object.fromEntries(said);
+}
+function anchorOut(view, full) {
+  const reference = view.reference ? {
+    ...present({ adId: view.reference.adId, advertiser: view.advertiser }),
+    carry: view.reference.carry,
+    mustKeep: view.reference.mustKeep
+  } : void 0;
+  const compact = present({
+    message: view.message,
+    language: view.language,
+    reference,
+    seriesLead: view.seriesLead,
+    accent: view.accent,
+    cast: view.cast,
+    who: view.who,
+    survives: view.survives
+  });
+  if (!full) return compact;
+  return {
+    ...compact,
+    ...present({ why: view.why, voices: view.voices, voiceIds: view.voiceIds, route: view.route }),
+    changes: view.changes
+  };
+}
+function ideaHint(view) {
+  return `Its idea: ${anchorLines(view).join(" \xB7 ").replace(
+    /[.!?…]+$/u,
+    ""
+  )}. An edit keeps it: change exactly what they named; a change of the idea they asked for is one line under "## Changes" in _definition.md, the reason after the dash.`;
+}
+function withAnchor(response, view, opts) {
+  return {
+    ...response,
+    data: { ...response.data, anchor: anchorOut(view, opts.full) },
+    hints: [ideaHint(view), ...response.hints ?? []]
+  };
+}
+async function readCreativeIdea(slug) {
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const read = await readIdeaAnchor(path.join(root, "src", "creatives", slug));
+  if (!read) return null;
+  await recordIdeaLines(path.join(root, "canvas"), slug, anchorLines(read.view)).catch(() => void 0);
+  return read.view;
+}
+
+export {
+  withAnchor,
+  readCreativeIdea
+};
+//# sourceMappingURL=chunk-3BKESS5W.js.map

package/dist/chunk-3VBPJQ7L.js

@@ -0,0 +1,288 @@
+import {
+  writeAdsOutput
+} from "./chunk-VF3W7CI7.js";
+import {
+  asRecord,
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.js";
+
+// src/commands/ads/meta/list-rows.ts
+function pick(row, keys) {
+  const picked = {};
+  for (const key of keys) {
+    if (row[key] !== void 0) picked[key] = row[key];
+  }
+  return picked;
+}
+var CAMPAIGN_COLUMNS = ["id", "name", "effective_status", "daily_budget", "lifetime_budget", "created_date"];
+var DIAGNOSTIC_COLUMNS = ["issues", "suggestions"];
+function compactCampaign(row) {
+  const created = row.created_time;
+  return {
+    ...pick(row, ["id", "name", "effective_status", "daily_budget", "lifetime_budget"]),
+    ...typeof created === "string" ? { created_date: created.slice(0, 10) } : {},
+    ...diagnostics(row)
+  };
+}
+var ADSET_KEYS = [
+  "id",
+  "name",
+  "campaign_id",
+  "effective_status",
+  "optimization_goal",
+  "billing_event",
+  "bid_strategy",
+  "daily_budget",
+  "lifetime_budget",
+  "destination_type",
+  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.
+  "is_dynamic_creative"
+];
+var ADSET_COLUMNS = [...ADSET_KEYS, "learning_stage", "end_time", "created_time"];
+function compactAdSet(row) {
+  const learning = asRecord(row.learning_stage_info)?.status;
+  return {
+    ...pick(row, ADSET_KEYS),
+    ...typeof learning === "string" ? { learning_stage: learning } : {},
+    ...pick(row, ["end_time", "created_time"]),
+    ...diagnostics(row)
+  };
+}
+var AD_COLUMNS = [
+  "id",
+  "name",
+  "adset_id",
+  "campaign_id",
+  "effective_status",
+  "creative_id",
+  "issues",
+  "created_time"
+];
+function adIssues(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const issue = asRecord(entry);
+    const text = issue?.error_summary ?? issue?.error_message;
+    return typeof text === "string" && text ? [text] : [];
+  });
+}
+function suggestions(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const recommendation = asRecord(entry);
+    const text = recommendation?.title ?? recommendation?.message;
+    return typeof text === "string" && text ? [text] : [];
+  });
+}
+function diagnostics(row) {
+  const issues = adIssues(row.issues_info);
+  const suggested = suggestions(row.recommendations);
+  return {
+    ...issues.length > 0 ? { issues } : {},
+    ...suggested.length > 0 ? { suggestions: suggested } : {}
+  };
+}
+function compactAd(row) {
+  const creativeId = asRecord(row.creative)?.id;
+  const issues = adIssues(row.issues_info);
+  return {
+    ...pick(row, ["id", "name", "adset_id", "campaign_id", "effective_status"]),
+    ...creativeId !== void 0 ? { creative_id: creativeId } : {},
+    ...issues.length > 0 ? { issues } : {},
+    ...pick(row, ["created_time"])
+  };
+}
+var ACTIVITY_COLUMNS = [
+  "event_time",
+  "event_type",
+  "actor_name",
+  "object_type",
+  "object_name",
+  "object_id",
+  "change"
+];
+function isScalar(value) {
+  return value === null || typeof value === "string" || typeof value === "number";
+}
+function activityChange(extraData) {
+  if (typeof extraData !== "string") return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(extraData);
+  } catch {
+    return void 0;
+  }
+  const data = asRecord(parsed);
+  if (!data || !("new_value" in data) || !("old_value" in data)) return void 0;
+  const { old_value: before, new_value: after } = data;
+  if (!isScalar(before) || !isScalar(after)) return void 0;
+  const show = (value) => value === null ? "(none)" : String(value);
+  return `${show(before)} \u2192 ${show(after)}`;
+}
+function compactActivity(row) {
+  const change = activityChange(row.extra_data);
+  return {
+    ...pick(row, ["event_time", "event_type", "actor_name", "object_type", "object_name", "object_id"]),
+    ...change !== void 0 ? { change } : {}
+  };
+}
+var AUDIENCE_COLUMNS = ["id", "name", "subtype", "size_min", "size_max", "retention_days", "updated_date"];
+var AUDIENCE_WHEN_PRESENT = ["delivery", "seed_id"];
+function compactAudience(row) {
+  const updated = row.time_updated;
+  const delivery = asRecord(row.delivery_status);
+  const origin = asRecord(row.lookalike_spec)?.origin;
+  const seed = Array.isArray(origin) ? asRecord(origin[0])?.id : void 0;
+  return {
+    ...pick(row, ["id", "name", "subtype"]),
+    ...row.approximate_count_lower_bound !== void 0 ? { size_min: row.approximate_count_lower_bound } : {},
+    ...row.approximate_count_upper_bound !== void 0 ? { size_max: row.approximate_count_upper_bound } : {},
+    ...pick(row, ["retention_days"]),
+    ...typeof updated === "number" ? { updated_date: new Date(updated * 1e3).toISOString().slice(0, 10) } : {},
+    ...delivery && delivery.code !== 200 && typeof delivery.description === "string" ? { delivery: delivery.description } : {},
+    ...seed !== void 0 ? { seed_id: seed } : {}
+  };
+}
+var CREATIVE_COLUMNS = [
+  "id",
+  "name",
+  "status",
+  "object_type",
+  "dynamic",
+  "body",
+  "title",
+  "description",
+  "link",
+  "cta",
+  "url_tags",
+  "image_hash",
+  "video_id",
+  "page_id",
+  "instagram_user_id",
+  "effective_object_story_id"
+];
+function texts(value, key) {
+  return Array.isArray(value) ? value.map((entry) => asRecord(entry)?.[key]) : [];
+}
+function oneOrMany(...candidates) {
+  const values = [...new Set(candidates.flat().filter((v) => typeof v === "string" && v !== ""))];
+  if (values.length === 0) return void 0;
+  return values.length === 1 ? values[0] : values;
+}
+function compactCreative(row) {
+  const story = asRecord(row.object_story_spec);
+  const link = asRecord(story?.link_data);
+  const video = asRecord(story?.video_data);
+  const feed = asRecord(row.asset_feed_spec);
+  const cards = link?.child_attachments;
+  const derived = {
+    dynamic: feed ? typeof feed.optimization_type === "string" ? feed.optimization_type : "ASSET_FEED" : void 0,
+    body: oneOrMany(row.body, link?.message, video?.message, texts(feed?.bodies, "text")),
+    title: oneOrMany(row.title, link?.name, video?.title, texts(feed?.titles, "text"), texts(cards, "name")),
+    description: oneOrMany(
+      link?.description,
+      video?.link_description,
+      texts(feed?.descriptions, "text"),
+      texts(cards, "description")
+    ),
+    link: oneOrMany(
+      row.link_url,
+      link?.link,
+      asRecord(asRecord(video?.call_to_action)?.value)?.link,
+      texts(feed?.link_urls, "website_url"),
+      texts(cards, "link")
+    ),
+    cta: oneOrMany(row.call_to_action_type, feed?.call_to_action_types),
+    url_tags: row.url_tags,
+    image_hash: oneOrMany(
+      row.image_hash,
+      link?.image_hash,
+      video?.image_hash,
+      texts(feed?.images, "hash"),
+      texts(cards, "image_hash")
+    ),
+    video_id: oneOrMany(row.video_id, video?.video_id, texts(feed?.videos, "video_id"), texts(cards, "video_id")),
+    page_id: story?.page_id,
+    instagram_user_id: row.instagram_user_id ?? story?.instagram_user_id,
+    effective_object_story_id: row.effective_object_story_id
+  };
+  const compact = pick(row, ["id", "name", "status", "object_type"]);
+  for (const [key, value] of Object.entries(derived)) if (value !== void 0) compact[key] = value;
+  return compact;
+}
+function budgetUnitHints(rows) {
+  const listed = rows.map((row) => Number(row.daily_budget ?? row.lifetime_budget)).find((amount) => Number.isFinite(amount) && amount > 0);
+  if (listed === void 0) return [];
+  const whole = listed / 100;
+  return [
+    `Budgets here are in the account currency's smallest unit, as Meta sends them: daily_budget ${listed} is ${whole} in EUR or USD (currencies without cents, such as JPY, are not divided). Money flags take whole currency: --daily-budget ${whole}, never ${listed}.`
+  ];
+}
+var PROJECTIONS = {
+  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
+  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
+  ads: { row: compactAd, columns: AD_COLUMNS },
+  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS },
+  audiences: { row: compactAudience, columns: AUDIENCE_COLUMNS, whenPresent: AUDIENCE_WHEN_PRESENT },
+  creatives: { row: compactCreative, columns: CREATIVE_COLUMNS }
+};
+function shapeMetaListRows(kind, rows, args) {
+  return shapeListRows(rows, args, PROJECTIONS[kind]);
+}
+var NOUNS = {
+  campaigns: "campaigns",
+  adsets: "ad sets",
+  ads: "ads",
+  activities: "activities",
+  audiences: "audiences",
+  creatives: "creatives"
+};
+function writeMetaListRows(kind, shaped, format, hints = []) {
+  if (format === "md" && shaped.rows.length === 0) {
+    process.stdout.write(`${hints.length > 0 ? hints.join("\n") : `No ${NOUNS[kind]} matched.`}
+`);
+    return;
+  }
+  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...shaped.hints ?? []]);
+}
+var META_LIST_SHAPE_ARGS = {
+  fields: {
+    type: "string",
+    description: "CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations"
+  },
+  full: { type: "boolean", description: "Return every field Meta sent (targeting, tracking specs, raw extra_data)" },
+  output: {
+    type: "string",
+    description: "md|json|csv|jsonl \u2014 md (default) prints a table; json returns the rows in the { ok, data } envelope",
+    default: "md"
+  }
+};
+function registerMetaListSchema(kind, description, args) {
+  registerSchema({
+    command: `ads.meta.${kind}`,
+    description,
+    args: Object.fromEntries(
+      Object.entries(args).map(([name, def]) => [
+        name,
+        {
+          type: def.type,
+          description: def.description ?? "",
+          required: false,
+          ...def.default !== void 0 ? { default: def.default } : {}
+        }
+      ])
+    )
+  });
+}
+
+export {
+  budgetUnitHints,
+  shapeMetaListRows,
+  writeMetaListRows,
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema
+};
+//# sourceMappingURL=chunk-3VBPJQ7L.js.map

package/dist/chunk-3X262BEG.js

@@ -0,0 +1,19 @@
+import {
+  latestVersion
+} from "./chunk-AYX7PB2L.js";
+import {
+  canvasOutputsRoot
+} from "./chunk-4CYB33V3.js";
+
+// src/commands/creatives/version-of.ts
+import path from "path";
+async function versionOf(slug, run) {
+  if (typeof run === "string" && run.trim()) return run.trim();
+  const canvas = path.join("src", "creatives", slug, `${slug}.canvas.json`);
+  return await latestVersion(canvasOutputsRoot(canvas), slug) ?? void 0;
+}
+
+export {
+  versionOf
+};
+//# sourceMappingURL=chunk-3X262BEG.js.map

package/dist/chunk-4CUBOXBS.js

@@ -0,0 +1,99 @@
+import {
+  readCreativeSpecs,
+  readSurface,
+  rulesHints,
+  rulesView,
+  waiverCounts
+} from "./chunk-OW3D63SI.js";
+import {
+  readAllRules
+} from "./chunk-M3IXPK6U.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-4CYB33V3.js";
+import {
+  landingRules,
+  selectRules
+} from "./chunk-OGWCLE4W.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-6V4UAC5I.js";
+
+// src/commands/rules/list.ts
+import { defineCommand } from "citty";
+var LIST_DESCRIPTION = `The company's standing rules for every ad and every landing: the brand's own (BRAND.md) and the ones a person taught, each with its id, strength (never | must | prefer), what it holds for (\`for\`: landings or all; absent, ads), what it is about, its words, the person's own words and where it came from. \`baker creatives brief\` carries the ones for ads.
+Start here: baker rules list
+  baker rules list --for landings                        # the rules every page is held to
+  baker rules list --kind video --product cubbo-engage   # the rules one ad is held to
+  baker rules list --all                                 # retired ones and every scope too`;
+var LIST_ARGS = {
+  for: {
+    type: "string",
+    description: "ads | landings: only the rules ads, or landings, are held to",
+    required: false
+  },
+  kind: {
+    type: "string",
+    description: "static | video: only the rules an ad of this kind is held to",
+    required: false
+  },
+  product: {
+    type: "string",
+    description: "A product slug (src/content/products/<slug>.md): only the rules an ad of it is held to",
+    required: false
+  },
+  all: {
+    type: "boolean",
+    description: "Every rule, retired ones and every scope included",
+    required: false,
+    default: false
+  },
+  full: { type: "boolean", description: "Each rule and the person's words whole", required: false, default: false }
+};
+registerSchema({ command: "rules.list", description: LIST_DESCRIPTION, args: LIST_ARGS });
+function listedRules(rules, on) {
+  if (on.surface === "landings") return landingRules(rules);
+  const forAds = selectRules(rules, {
+    ...on.kind ? { kind: on.kind } : {},
+    ...on.product ? { product: on.product } : {}
+  });
+  if (on.surface === "ads" || on.kind || on.product) return forAds;
+  return [...forAds, ...landingRules(rules).filter((r) => r.for === "landings")];
+}
+var rulesListCommand = defineCommand({
+  meta: { name: "list", description: LIST_DESCRIPTION },
+  args: LIST_ARGS,
+  async run({ args }) {
+    const target = readSurface(args.for);
+    if (!target) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `--for: ads or landings, not "${String(args.for)}".`,
+          fix: "Leave --for out to list the rules for ads and for landings together."
+        }
+      });
+      process.exit(1);
+    }
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const kind = args.kind === "static" || args.kind === "video" ? args.kind : void 0;
+    const product = typeof args.product === "string" && args.product ? args.product : void 0;
+    const [rules, specs] = await Promise.all([readAllRules(root), readCreativeSpecs(root)]);
+    const forAds = selectRules(rules, { ...kind ? { kind } : {}, ...product ? { product } : {} });
+    const active = listedRules(rules, { ...target, ...kind ? { kind } : {}, ...product ? { product } : {} });
+    const shown = args.all === true ? rules : active;
+    const hints = rulesHints(forAds, waiverCounts(specs));
+    writeJson({
+      ok: true,
+      data: { rules: rulesView(shown, { full: args.full === true }), active: active.length, total: rules.length },
+      ...hints.length > 0 ? { hints } : {}
+    });
+  }
+});
+
+export {
+  rulesListCommand
+};
+//# sourceMappingURL=chunk-4CUBOXBS.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/rules/list.ts"],"sourcesContent":["/** `baker rules list`: the company's standing rules, for ads, landings or both, as they stand now. */\nimport { defineCommand } from \"citty\";\nimport { readAllRules } from \"../../engine/creative-context/index.ts\";\nimport type { CreativeRule } from \"../../engine/creative-rules/schema.ts\";\nimport { landingRules, selectRules } from \"../../engine/creative-rules/select.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { readCreativeSpecs, readSurface, rulesHints, rulesView, waiverCounts } from \"./view.ts\";\n\nconst LIST_DESCRIPTION = `The company's standing rules for every ad and every landing: the brand's own (BRAND.md) and the ones a person taught, each with its id, strength (never | must | prefer), what it holds for (\\`for\\`: landings or all; absent, ads), what it is about, its words, the person's own words and where it came from. \\`baker creatives brief\\` carries the ones for ads.\nStart here: baker rules list\n  baker rules list --for landings                        # the rules every page is held to\n  baker rules list --kind video --product cubbo-engage   # the rules one ad is held to\n  baker rules list --all                                 # retired ones and every scope too`;\n\nconst LIST_ARGS = {\n  for: {\n    type: \"string\",\n    description: \"ads | landings: only the rules ads, or landings, are held to\",\n    required: false,\n  },\n  kind: {\n    type: \"string\",\n    description: \"static | video: only the rules an ad of this kind is held to\",\n    required: false,\n  },\n  product: {\n    type: \"string\",\n    description: \"A product slug (src/content/products/<slug>.md): only the rules an ad of it is held to\",\n    required: false,\n  },\n  all: {\n    type: \"boolean\",\n    description: \"Every rule, retired ones and every scope included\",\n    required: false,\n    default: false,\n  },\n  full: { type: \"boolean\", description: \"Each rule and the person's words whole\", required: false, default: false },\n} as const;\n\nregisterSchema({ command: \"rules.list\", description: LIST_DESCRIPTION, args: LIST_ARGS });\n\n/**\n * The active rules `rules list` shows: the ones for landings, or for ads (one kind or product's\n * when narrowed), or with neither, the ads' and the ones only for landings, unless a kind or\n * product names one ad. Pure.\n */\nexport function listedRules(\n  rules: readonly CreativeRule[],\n  on: { surface?: \"ads\" | \"landings\"; kind?: \"static\" | \"video\"; product?: string },\n): CreativeRule[] {\n  if (on.surface === \"landings\") return landingRules(rules);\n  const forAds = selectRules(rules, {\n    ...(on.kind ? { kind: on.kind } : {}),\n    ...(on.product ? { product: on.product } : {}),\n  });\n  if (on.surface === \"ads\" || on.kind || on.product) return forAds;\n  return [...forAds, ...landingRules(rules).filter((r) => r.for === \"landings\")];\n}\n\nexport const rulesListCommand = defineCommand({\n  meta: { name: \"list\", description: LIST_DESCRIPTION },\n  args: LIST_ARGS,\n  async run({ args }) {\n    const target = readSurface(args.for);\n    if (!target) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: `--for: ads or landings, not \"${String(args.for)}\".`,\n          fix: \"Leave --for out to list the rules for ads and for landings together.\",\n        },\n      });\n      process.exit(1);\n    }\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const kind = args.kind === \"static\" || args.kind === \"video\" ? args.kind : undefined;\n    const product = typeof args.product === \"string\" && args.product ? args.product : undefined;\n    const [rules, specs] = await Promise.all([readAllRules(root), readCreativeSpecs(root)]);\n    const forAds = selectRules(rules, { ...(kind ? { kind } : {}), ...(product ? { product } : {}) });\n    const active = listedRules(rules, { ...target, ...(kind ? { kind } : {}), ...(product ? { product } : {}) });\n    const shown = args.all === true ? rules : active;\n    const hints = rulesHints(forAds, waiverCounts(specs));\n    writeJson({\n      ok: true,\n      data: { rules: rulesView(shown, { full: args.full === true }), active: active.length, total: rules.length },\n      ...(hints.length > 0 ? { hints } : {}),\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAS9B,IAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAMzB,IAAM,YAAY;AAAA,EAChB,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,SAAS;AAAA,EACX;AAAA,EACA,MAAM,EAAE,MAAM,WAAW,aAAa,0CAA0C,UAAU,OAAO,SAAS,MAAM;AAClH;AAEA,eAAe,EAAE,SAAS,cAAc,aAAa,kBAAkB,MAAM,UAAU,CAAC;AAOjF,SAAS,YACd,OACA,IACgB;AAChB,MAAI,GAAG,YAAY,WAAY,QAAO,aAAa,KAAK;AACxD,QAAM,SAAS,YAAY,OAAO;AAAA,IAChC,GAAI,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,IAAI,CAAC;AAAA,IACnC,GAAI,GAAG,UAAU,EAAE,SAAS,GAAG,QAAQ,IAAI,CAAC;AAAA,EAC9C,CAAC;AACD,MAAI,GAAG,YAAY,SAAS,GAAG,QAAQ,GAAG,QAAS,QAAO;AAC1D,SAAO,CAAC,GAAG,QAAQ,GAAG,aAAa,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,UAAU,CAAC;AAC/E;AAEO,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM,EAAE,MAAM,QAAQ,aAAa,iBAAiB;AAAA,EACpD,MAAM;AAAA,EACN,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,UAAM,SAAS,YAAY,KAAK,GAAG;AACnC,QAAI,CAAC,QAAQ;AACX,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS,gCAAgC,OAAO,KAAK,GAAG,CAAC;AAAA,UACzD,KAAK;AAAA,QACP;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM,OAAO,kBAAkB,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI;AAC7D,UAAM,OAAO,KAAK,SAAS,YAAY,KAAK,SAAS,UAAU,KAAK,OAAO;AAC3E,UAAM,UAAU,OAAO,KAAK,YAAY,YAAY,KAAK,UAAU,KAAK,UAAU;AAClF,UAAM,CAAC,OAAO,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC,aAAa,IAAI,GAAG,kBAAkB,IAAI,CAAC,CAAC;AACtF,UAAM,SAAS,YAAY,OAAO,EAAE,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,GAAI,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,EAAG,CAAC;AAChG,UAAM,SAAS,YAAY,OAAO,EAAE,GAAG,QAAQ,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,GAAI,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,EAAG,CAAC;AAC3G,UAAM,QAAQ,KAAK,QAAQ,OAAO,QAAQ;AAC1C,UAAM,QAAQ,WAAW,QAAQ,aAAa,KAAK,CAAC;AACpD,cAAU;AAAA,MACR,IAAI;AAAA,MACJ,MAAM,EAAE,OAAO,UAAU,OAAO,EAAE,MAAM,KAAK,SAAS,KAAK,CAAC,GAAG,QAAQ,OAAO,QAAQ,OAAO,MAAM,OAAO;AAAA,MAC1G,GAAI,MAAM,SAAS,IAAI,EAAE,MAAM,IAAI,CAAC;AAAA,IACtC,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/chunk-4CYB33V3.js

@@ -0,0 +1,136 @@
+import {
+  coercePathUrlToUrl,
+  looksLikeHttpUrl
+} from "./chunk-XQEHLDGP.js";
+
+// src/commands/canvas/resolve-paths.ts
+import path from "path";
+function resolveRelativeCanvasPaths(canvas, baseDir) {
+  if (!canvas || typeof canvas !== "object") return canvas;
+  const c = canvas;
+  if (!Array.isArray(c.nodes)) return canvas;
+  return { ...canvas, nodes: c.nodes.map((n) => resolveNode(n, baseDir)) };
+}
+function localPathParam(node) {
+  if (node.type === "ingest") return node.params?.source === "path" ? "path" : null;
+  if (node.type === "hyperframe_render" || node.type === "hyperframe_snapshot") return "composition";
+  return null;
+}
+function resolveNode(node, baseDir) {
+  if (!node || typeof node !== "object") return node;
+  const n = node;
+  const params = n.params;
+  if (!params || typeof params !== "object") return node;
+  const key = localPathParam(n);
+  if (key && isResolvableRelative(params[key])) {
+    return { ...node, params: { ...params, [key]: path.resolve(baseDir, params[key]) } };
+  }
+  return node;
+}
+function isResolvableRelative(value) {
+  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !looksLikeHttpUrl(value) && !path.isAbsolute(value);
+}
+
+// src/commands/canvas/normalize-paths.ts
+import { existsSync, realpathSync } from "fs";
+import { writeFile } from "fs/promises";
+import path2 from "path";
+function findWorkspaceRoot(startDir, exists = existsSync, maxDepth = 12) {
+  let dir = path2.resolve(startDir);
+  for (let i = 0; i < maxDepth; i++) {
+    if (exists(path2.join(dir, "package.json"))) return dir;
+    const parent = path2.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function canvasOutputsRoot(canvasFile, cwd = process.cwd(), exists = existsSync) {
+  const root = findWorkspaceRoot(path2.dirname(path2.resolve(cwd, canvasFile)), exists) ?? cwd;
+  return path2.join(root, "canvas");
+}
+function canonicalize(target) {
+  const abs = path2.resolve(target);
+  let dir = abs;
+  for (; ; ) {
+    try {
+      const real = realpathSync(dir);
+      return dir === abs ? real : path2.join(real, path2.relative(dir, abs));
+    } catch {
+      const parent = path2.dirname(dir);
+      if (parent === dir) return abs;
+      dir = parent;
+    }
+  }
+}
+function isInside(root, target) {
+  const rel = path2.relative(root, target);
+  return rel !== "" && !rel.startsWith("..") && !path2.isAbsolute(rel);
+}
+function toCanvasRelative(canvasDir, target) {
+  return path2.relative(canvasDir, target).split(path2.sep).join("/");
+}
+var RUNTIME_WORKSPACE_ROOT = "/home/user/repo";
+function rewriteTarget(value, workspaceRoot) {
+  if (typeof value !== "string" || value.length === 0) return null;
+  if (value.includes("[TODO") || looksLikeHttpUrl(value) || !path2.isAbsolute(value)) return null;
+  const target = canonicalize(value);
+  if (isInside(workspaceRoot, target)) return target;
+  const fromRuntime = path2.relative(RUNTIME_WORKSPACE_ROOT, path2.normalize(value));
+  if (fromRuntime !== "" && !fromRuntime.startsWith("..") && !path2.isAbsolute(fromRuntime)) {
+    return path2.join(workspaceRoot, fromRuntime);
+  }
+  return null;
+}
+function normalizeCanvasPaths(canvas, canvasDir, workspaceRoot) {
+  if (!canvas || typeof canvas !== "object") return { canvas, rewrites: [] };
+  const c = canvas;
+  if (!Array.isArray(c.nodes)) return { canvas, rewrites: [] };
+  const root = canonicalize(workspaceRoot);
+  const dir = canonicalize(canvasDir);
+  const rewrites = [];
+  const nodes = c.nodes.map((node) => {
+    if (!node || typeof node !== "object") return node;
+    const n = node;
+    const params = n.params;
+    if (!params || typeof params !== "object") return node;
+    const nodeId = typeof n.id === "string" ? n.id : "?";
+    if (n.type === "ingest" && params.source === "path" && looksLikeHttpUrl(params.path)) {
+      rewrites.push({ nodeId, param: "source", from: "path", to: "url" });
+      return { ...node, params: coercePathUrlToUrl(params) };
+    }
+    const key = localPathParam(n);
+    if (!key) return node;
+    const target = rewriteTarget(params[key], root);
+    if (target === null) return node;
+    const to = toCanvasRelative(dir, target);
+    rewrites.push({ nodeId, param: key, from: params[key], to });
+    return { ...node, params: { ...params, [key]: to } };
+  });
+  return rewrites.length === 0 ? { canvas, rewrites } : { canvas: { ...canvas, nodes }, rewrites };
+}
+async function healCanvasPaths(filePath, canvas) {
+  const canvasDir = path2.dirname(filePath);
+  const workspaceRoot = findWorkspaceRoot(canvasDir);
+  if (!workspaceRoot) return { canvas, rewrites: [], text: null };
+  const normalized = normalizeCanvasPaths(canvas, canvasDir, workspaceRoot);
+  if (normalized.rewrites.length === 0) return { ...normalized, text: null };
+  const text = `${JSON.stringify(normalized.canvas, null, 2)}
+`;
+  await writeFile(filePath, text, "utf8");
+  return { ...normalized, text };
+}
+function describeRewrites(rewrites) {
+  return rewrites.map((r) => `  ${r.nodeId}.${r.param}: ${r.from} \u2192 ${r.to}`).join("\n");
+}
+
+export {
+  resolveRelativeCanvasPaths,
+  localPathParam,
+  findWorkspaceRoot,
+  canvasOutputsRoot,
+  normalizeCanvasPaths,
+  healCanvasPaths,
+  describeRewrites
+};
+//# sourceMappingURL=chunk-4CYB33V3.js.map