@koda-sl/baker-cli 0.545.0 → 0.546.0-dev.e8b0ca6de

package/dist/experiments-KGRE35JK.js

@@ -0,0 +1,236 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-CVTWKHWZ.js";
+import {
+  handleLinkedinError
+} from "./chunk-JAFTWN3A.js";
+import "./chunk-3W4IORXH.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-NGQ5J4FV.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MGWAZXY6.js";
+import "./chunk-VWOKPC3T.js";
+import "./chunk-BGT5ZA4L.js";
+import "./chunk-JF2XP76K.js";
+import "./chunk-SYLPRIFM.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-DGUN7FUH.js";
+import "./chunk-3S3TVLAV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  apiGet
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/experiments.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads linkedin draft`.";
+var accountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" }
+};
+var STOP_AT = {
+  "end-date": "AUTO_STOP_AT_END_DATE",
+  winner: "AUTO_STOP_AT_WINNER",
+  never: "AUTO_STOP_DISABLED"
+};
+function stopAtArg(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const mapped = STOP_AT[String(value)];
+  if (!mapped) {
+    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join("|")}`);
+  }
+  return mapped;
+}
+function numberArg(value, flag) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    failWriteValidation(`${flag} must be a whole number`);
+  }
+  return parsed;
+}
+var experimentsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the ad account's A/B tests, newest first: name, state (what was asked), running (what LinkedIn is doing: PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates and the two versions (ad sets + traffic split). Runs by default."
+  },
+  args: { ...accountArgs },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "One A/B test with LinkedIn's setup checks (an ERROR keeps it from running \u2014 e.g. NO_ACTIVE_CREATIVES; a WARNING may skew it) and its latest result: the winning version, p-value, and each version's confidence interval for the metric. `result: null` until LinkedIn computes the first one (daily)."
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id from `experiments`", required: true },
+    ...accountArgs
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args),
+        id: requireTarget(args, "A/B test")
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage an A/B test between two ad sets of the SAME campaign: LinkedIn splits the audience so each member sees only one version, and calls a winner on the metric. ${STAGED_NOTE}
+Rules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51\u201399 (90+ recommended), each ad set needs an active ad. Best practice: two new ad sets identical but for the one thing tested, equal budgets, 3+ weeks.
+Examples:
+  baker ads linkedin experiments create --name "Image vs video" --version-a li_temp_x1 --version-b li_temp_x2 --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments create --name "Headline test" --version-a 896802423 --name-a "Pain" --version-b 896812053 --name-b "Gain" --metric CPM --start 2026-11-01 --end 2026-12-01 --stop-at winner --confidence 95`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Test name (\u2264100)", required: true },
+    description: { type: "string", description: "What is being tested" },
+    "version-a": { type: "string", description: "Ad set id/URN or li_temp_* ref for version A", required: true },
+    "version-b": { type: "string", description: "Ad set id/URN or li_temp_* ref for version B", required: true },
+    "name-a": { type: "string", description: "Version A label (default A)" },
+    "name-b": { type: "string", description: "Version B label (default B)" },
+    "weight-a": { type: "string", description: "Version A share of the audience, 1\u201399 (default 50; B gets the rest)" },
+    metric: { type: "string", description: "CPC|CPM|CPV (video ad sets)|CPMS (message ads)", required: true },
+    confidence: { type: "string", description: "51\u201399 (default 90)" },
+    start: { type: "string", description: "Start date (ISO or epoch ms)", required: true },
+    end: { type: "string", description: "End date (\u226490 days after start)", required: true },
+    "stop-at": {
+      type: "string",
+      description: "end-date (default, pauses both) | winner | never (ad sets keep running)"
+    },
+    draft: { type: "boolean", description: "Create it set up but not running" }
+  },
+  run: async ({ args }) => {
+    const weightA = numberArg(args["weight-a"], "--weight-a") ?? 50;
+    await stageOp({
+      kind: "experiment.create",
+      accountId: bareAccountId(args),
+      payload: {
+        name: args.name,
+        description: args.description,
+        keyMetric: args.metric ? String(args.metric).toUpperCase() : void 0,
+        confidence: numberArg(args.confidence, "--confidence"),
+        start: parseDateFlag(args.start, "--start"),
+        end: parseDateFlag(args.end, "--end"),
+        autoStop: stopAtArg(args["stop-at"]),
+        state: args.draft ? "DRAFT" : void 0,
+        cells: [
+          { name: args["name-a"] ?? "A", campaign: args["version-a"], trafficWeight: weightA },
+          { name: args["name-b"] ?? "B", campaign: args["version-b"], trafficWeight: 100 - weightA }
+        ]
+      }
+    });
+  }
+});
+var experimentsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still \u226490 days from start), confidence and when it stops can change \u2014 the versions are fixed. ${STAGED_NOTE}
+Example: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    end: { type: "string", description: "New end date" },
+    confidence: { type: "string", description: "51\u201399" },
+    "stop-at": { type: "string", description: "end-date|winner|never" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "experiment.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "A/B test"),
+      payload: {
+        name: args.name,
+        description: args.description,
+        end: parseDateFlag(args.end, "--end"),
+        confidence: numberArg(args.confidence, "--confidence"),
+        autoStop: stopAtArg(args["stop-at"])
+      }
+    });
+  }
+});
+function experimentStateCommand(name, state, what) {
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${what}. ${STAGED_NOTE}
+Example: baker ads linkedin experiments ${name} 5633011`
+    },
+    args: {
+      id: { type: "positional", description: "A/B test id", required: true },
+      ...accountArgs
+    },
+    run: async ({ args }) => {
+      await stageOp({
+        kind: "experiment.update",
+        accountId: bareAccountId(args),
+        target: requireTarget(args, "A/B test"),
+        payload: { state }
+      });
+    }
+  });
+}
+var experimentsCommand = defineCommand({
+  meta: {
+    name: "experiments",
+    description: `LinkedIn A/B tests: two ad sets of one campaign shown to separate halves of the audience, with a winner called on CPC/CPM/CPV/CPMS.
+Examples:
+  baker ads linkedin experiments                       # list
+  baker ads linkedin experiments get 5633011           # setup checks + result
+  baker ads linkedin experiments create --name "Image vs video" --version-a <ad set> --version-b <ad set> --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments pause|start|end 5633011`
+  },
+  subCommands: {
+    list: experimentsListCommand,
+    get: experimentsGetCommand,
+    create: experimentsCreateCommand,
+    update: experimentsUpdateCommand,
+    start: experimentStateCommand("start", "ACTIVE", "starting (or resuming) an A/B test"),
+    pause: experimentStateCommand("pause", "PAUSED", "pausing an A/B test \u2014 both ad sets pause, the end date stays"),
+    end: experimentStateCommand("end", "CANCELED", "ending an A/B test for good")
+  },
+  args: { ...accountArgs },
+  default: "list"
+});
+export {
+  experimentsCommand
+};
+//# sourceMappingURL=experiments-KGRE35JK.js.map

package/dist/facets-GWV63PKA.js

@@ -0,0 +1,117 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-JAFTWN3A.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MGWAZXY6.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-FPTEBOB5.js";
+import "./chunk-3S3TVLAV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  apiGet
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/facets.ts
+import { defineCommand } from "citty";
+var listCmd = defineCommand({
+  meta: {
+    name: "list",
+    description: `List every targeting facet LinkedIn supports.
+
+Cached 7 days. Use this to discover what dimensions you can target on (industries,
+seniorities, titles, employers, growthRate, companyCategory, skills, etc.).`
+  },
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/facets", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var valuesCmd = defineCommand({
+  meta: {
+    name: "values",
+    description: `Look up entity values for a single facet \u2014 full list or typeahead search.
+
+Examples:
+  baker ads linkedin facets values --facet seniorities                          \u2014 all seniority URNs
+  baker ads linkedin facets values --facet titles --query "marketing director"  \u2014 typeahead
+  baker ads linkedin facets values --facet industries --output csv
+
+The --facet flag accepts the bare name (industries, seniorities, titles, etc.)
+or the full URN (urn:li:adTargetingFacet:industries).`
+  },
+  args: {
+    facet: { type: "string", description: "Facet name (e.g. industries) or URN", required: true },
+    query: { type: "string", description: "Typeahead query (auto-switches finder to typeahead)" },
+    finder: { type: "string", description: "adTargetingFacet | typeahead | similarEntities (default: auto)" },
+    locale: { type: "string", description: "Locale (default: en_US)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { facet: String(args.facet) };
+      const finder = args.finder ?? (args.query ? "typeahead" : "adTargetingFacet");
+      params.finder = finder;
+      if (args.query) params.query = String(args.query);
+      if (args.locale) params.locale = String(args.locale);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/facets/entities", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var facetsCommand = defineCommand({
+  meta: {
+    name: "facets",
+    description: `LinkedIn targeting facets and entity lookup.
+
+Subcommands:
+  list                          \u2014 every facet (industries, seniorities, titles, employers, \u2026)
+  values --facet titles         \u2014 entity URNs for one facet
+  values --facet titles --query "marketing director"  \u2014 typeahead`
+  },
+  subCommands: {
+    list: listCmd,
+    values: valuesCmd
+  }
+});
+export {
+  facetsCommand
+};
+//# sourceMappingURL=facets-GWV63PKA.js.map

package/dist/feedback-2SOINGXM.js

@@ -0,0 +1,115 @@
+import {
+  readCreativeIdea,
+  withAnchor
+} from "./chunk-JKRXKD54.js";
+import "./chunk-MONZLJWO.js";
+import "./chunk-7UFV6H7J.js";
+import "./chunk-PZEPUBAS.js";
+import "./chunk-6REXNFPV.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-LDFM37DM.js";
+import "./chunk-EZVW3KAW.js";
+import "./chunk-LDMN6RE6.js";
+import "./chunk-JYXERSEO.js";
+import "./chunk-C4EE6LIF.js";
+import "./chunk-P6744QO6.js";
+import "./chunk-3EUITH4J.js";
+import "./chunk-UYUH5XNV.js";
+import "./chunk-JDBZCUTY.js";
+import "./chunk-P6FMQHJJ.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-NGQ5J4FV.js";
+import "./chunk-VWOKPC3T.js";
+import "./chunk-BGT5ZA4L.js";
+import "./chunk-E5H7JIWB.js";
+import "./chunk-GCZK4BMB.js";
+import "./chunk-Q6LCL67T.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-4IRJ5JXA.js";
+import "./chunk-XU6XQPNM.js";
+import "./chunk-B3CDNANO.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-JF2XP76K.js";
+import "./chunk-SYLPRIFM.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-DGUN7FUH.js";
+import "./chunk-3S3TVLAV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/feedback.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "Read what this company's reviewers said about creative versions: recent approved / rejected verdicts with reasons and notes, the top rejection reasons, what approved versions share (format, platform, option), and hints[] saying what to do differently. Start here before making or changing a creative: baker creatives feedback; then baker creatives feedback --slug <slug> for one creative's history and its idea (data.anchor: the message, the reference and what we take from it, the language; what an edit keeps). When the user reacts to a version in the chat, record it with baker creatives feedback record.";
+var SLUG_DESCRIPTION = "One creative's feedback (src/creatives/<slug>/), with its idea as data.anchor. Left out, the whole company's.";
+var FULL_DESCRIPTION = "Every verdict as stored (up to 200), notes whole. Default is a summary plus the 8 latest.";
+registerSchema({
+  command: "creatives.feedback",
+  description: DESCRIPTION,
+  args: {
+    slug: { type: "string", description: SLUG_DESCRIPTION, required: false },
+    full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
+  }
+});
+var readArgs = {
+  slug: { type: "string", description: SLUG_DESCRIPTION, required: false },
+  full: { type: "boolean", description: FULL_DESCRIPTION, required: false, default: false }
+};
+var feedbackReadCommand = defineCommand({
+  meta: { name: "read", description: `${DESCRIPTION} Runs by default when no subcommand is given.` },
+  args: readArgs,
+  run: async ({ args }) => {
+    try {
+      const body = {
+        ...typeof args.slug === "string" && args.slug.length > 0 ? { slug: args.slug } : {},
+        ...args.full === true ? { full: true } : {}
+      };
+      const [response, idea] = await Promise.all([
+        apiPost("/api/creatives/feedback", body),
+        body.slug ? readCreativeIdea(body.slug) : Promise.resolve(null)
+      ]);
+      writeJson(idea ? withAnchor(response, idea, { full: body.full === true }) : response);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: { name: "feedback", description: DESCRIPTION },
+  subCommands: {
+    read: feedbackReadCommand,
+    record: () => import("./feedback-record-6FKYOZ3P.js").then((m) => m.feedbackRecordCommand)
+  },
+  // `args` stays although the parent has no `run`: citty finds the subcommand
+  // name with THIS command's arg defs, so without them `--slug spring-offer`
+  // would read `spring-offer` as a subcommand. `default` (not `run`) serves the
+  // bare invocation, since citty runs a parent's `run` after its subcommand too.
+  args: readArgs,
+  default: "read"
+});
+export {
+  feedbackCommand
+};
+//# sourceMappingURL=feedback-2SOINGXM.js.map

package/dist/feedback-O4RPVQ73.js

@@ -0,0 +1,136 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-ERWMBQU2.js";
+import {
+  PLATFORM_REPORT_KINDS,
+  feedbackReportRequestSchema
+} from "./chunk-3S3TVLAV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/feedback/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/feedback.md";
+var ARGS = {
+  kind: {
+    type: "string",
+    description: "bug \u2014 something in Baker is broken (a command, check, hook, skill or doc does the wrong thing). feature \u2014 Baker has no way to do what the work needs.",
+    required: true
+  },
+  title: {
+    type: "string",
+    description: `One sentence, what is wrong or missing, in Baker's terms: "baker winning-ads has no way to read one country's ads".`,
+    required: true
+  },
+  body: {
+    type: "string",
+    description: "What you ran, what came back (the exact message), what you expected, and what you ruled out. Describe the problem, not the client: no names, emails or figures from their accounts.",
+    required: true
+  },
+  "user-asked": {
+    type: "boolean",
+    description: "Set when the user asked you to tell the Baker team. Leave it off when you are reporting on your own; the team reads which it was.",
+    required: false,
+    default: false
+  }
+};
+registerSchema({
+  command: "feedback.report",
+  description: `Start here when Baker itself is in the way: a command, check, hook, skill or doc that is broken, or a capability the work needs that Baker does not have. Example: baker feedback report --kind bug --title "verify fails on an archived test version" --body "\u2026" (add --user-asked when the user asked you to). Sent to the Baker team at once, with the client's details taken out; the answer names the issue it is on. Never a Task, never a message for the user to pass on. Then say one plain line to the user and keep going with what you can still do.`,
+  args: ARGS
+});
+var REPORT_HINTS = [
+  "The Baker team has it (or will within minutes, if it is still sending \u2014 nothing more to do). Tell the user in one plain line that you let the Baker team know \u2014 no ids, commands or file names \u2014 and never ask them to pass it on.",
+  "Then keep going: work around it with what this workspace still lets you change (the pages, Forms, Knowledge and Brand you own, a staged change instead of a blocked one), finish the rest of the job, and say plainly what is left undone. One broken piece should not stop the whole task.",
+  "It is not a Task: don't also file one for it."
+];
+function reportBody(args) {
+  if (!PLATFORM_REPORT_KINDS.includes(args.kind ?? "")) {
+    return { ok: false, error: `--kind is ${PLATFORM_REPORT_KINDS.join(" or ")}, got "${args.kind ?? ""}".` };
+  }
+  const parsed = feedbackReportRequestSchema.safeParse({
+    kind: args.kind,
+    title: args.title,
+    body: args.body,
+    askedByUser: args["user-asked"] === true
+  });
+  if (!parsed.success) {
+    return {
+      ok: false,
+      error: "A report needs a --title of at least 10 characters (one sentence, what is wrong or missing) and a --body of at least 20 (what you ran, what came back, what you expected)."
+    };
+  }
+  return { ok: true, body: parsed.data };
+}
+var ISSUE_WAIT_MS = 2e4;
+var ISSUE_POLL_MS = 2e3;
+async function waitForIssue(sent, read, sleep, budgetMs = ISSUE_WAIT_MS) {
+  let state = sent;
+  for (let waited = 0; state.status === "sending" && waited < budgetMs; waited += ISSUE_POLL_MS) {
+    await sleep(ISSUE_POLL_MS);
+    try {
+      state = await read();
+    } catch {
+      return state;
+    }
+  }
+  return state;
+}
+var reportCommand = defineCommand({
+  meta: {
+    name: "report",
+    description: `Tell the Baker team about a defect in Baker or a capability it lacks; sent to their tracker at once.
+Start here: baker feedback report --kind bug --title "<what is wrong, one sentence>" --body "<what you ran, what came back, what you expected>"`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const parsed = reportBody(args);
+    if (!parsed.ok) {
+      failValidation(parsed.error);
+    }
+    try {
+      const response = await apiPost("/api/feedback/report", parsed.body);
+      const data = await waitForIssue(
+        response.data,
+        async () => (await apiGet("/api/feedback/report", { id: response.data.id })).data,
+        (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+      );
+      writeJson({ ok: true, data, hints: REPORT_HINTS });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: {
+    name: "feedback",
+    description: `Report a defect in Baker, or a capability it lacks, to the Baker team \u2014 never to the user, never as a Task. Subcommands: report.
+Full guide: ${DOC}`
+  },
+  subCommands: { report: reportCommand }
+});
+export {
+  ISSUE_WAIT_MS,
+  REPORT_HINTS,
+  feedbackCommand,
+  reportBody,
+  waitForIssue
+};
+//# sourceMappingURL=feedback-O4RPVQ73.js.map

package/dist/feedback-O4RPVQ73.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/feedback/index.ts"],"sourcesContent":["import {\n  type FeedbackReportRequest,\n  type FeedbackReportResponse,\n  feedbackReportRequestSchema,\n  PLATFORM_REPORT_KINDS,\n  type PlatformReportState,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi, failValidation } from \"../actions/shared.ts\";\n\nconst DOC = \"__tooling__/docs/tools/baker/feedback.md\";\n\nconst ARGS = {\n  kind: {\n    type: \"string\",\n    description:\n      \"bug — something in Baker is broken (a command, check, hook, skill or doc does the wrong thing). feature — Baker has no way to do what the work needs.\",\n    required: true,\n  },\n  title: {\n    type: \"string\",\n    description:\n      \"One sentence, what is wrong or missing, in Baker's terms: \\\"baker winning-ads has no way to read one country's ads\\\".\",\n    required: true,\n  },\n  body: {\n    type: \"string\",\n    description:\n      \"What you ran, what came back (the exact message), what you expected, and what you ruled out. Describe the problem, not the client: no names, emails or figures from their accounts.\",\n    required: true,\n  },\n  \"user-asked\": {\n    type: \"boolean\",\n    description:\n      \"Set when the user asked you to tell the Baker team. Leave it off when you are reporting on your own; the team reads which it was.\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"feedback.report\",\n  description:\n    'Start here when Baker itself is in the way: a command, check, hook, skill or doc that is broken, or a capability the work needs that Baker does not have. Example: baker feedback report --kind bug --title \"verify fails on an archived test version\" --body \"…\" (add --user-asked when the user asked you to). Sent to the Baker team at once, with the client\\'s details taken out; the answer names the issue it is on. Never a Task, never a message for the user to pass on. Then say one plain line to the user and keep going with what you can still do.',\n  args: ARGS,\n});\n\n/**\n * What to do once the report is saved. Hints rather than prose in a doc,\n * because the moment that matters is right after the call: the agent has just\n * hit a wall, and the two things it reaches for — stopping, or asking the\n * marketer to carry the report — are both wrong.\n */\nexport const REPORT_HINTS = [\n  \"The Baker team has it (or will within minutes, if it is still sending — nothing more to do). Tell the user in one plain line that you let the Baker team know — no ids, commands or file names — and never ask them to pass it on.\",\n  \"Then keep going: work around it with what this workspace still lets you change (the pages, Forms, Knowledge and Brand you own, a staged change instead of a blocked one), finish the rest of the job, and say plainly what is left undone. One broken piece should not stop the whole task.\",\n  \"It is not a Task: don't also file one for it.\",\n];\n\ntype ReportArgs = { kind?: string; title?: string; body?: string; \"user-asked\"?: boolean };\n\n/** The request one `report` line asks for, or why it cannot be sent. */\nexport function reportBody(args: ReportArgs): { ok: true; body: FeedbackReportRequest } | { ok: false; error: string } {\n  if (!(PLATFORM_REPORT_KINDS as readonly string[]).includes(args.kind ?? \"\")) {\n    return { ok: false, error: `--kind is ${PLATFORM_REPORT_KINDS.join(\" or \")}, got \"${args.kind ?? \"\"}\".` };\n  }\n  const parsed = feedbackReportRequestSchema.safeParse({\n    kind: args.kind,\n    title: args.title,\n    body: args.body,\n    askedByUser: args[\"user-asked\"] === true,\n  });\n  if (!parsed.success) {\n    return {\n      ok: false,\n      error:\n        \"A report needs a --title of at least 10 characters (one sentence, what is wrong or missing) and a --body of at least 20 (what you ran, what came back, what you expected).\",\n    };\n  }\n  return { ok: true, body: parsed.data };\n}\n\n/** How long the command waits for the tracker to answer before returning \"sending\". */\nexport const ISSUE_WAIT_MS = 20_000;\nconst ISSUE_POLL_MS = 2_000;\n\n/**\n * Wait, briefly, for the report to land on an issue. The send runs on its own\n * whatever happens here: this only lets the answer say where it landed.\n */\nexport async function waitForIssue(\n  sent: PlatformReportState,\n  read: () => Promise<PlatformReportState>,\n  sleep: (ms: number) => Promise<void>,\n  budgetMs: number = ISSUE_WAIT_MS,\n): Promise<PlatformReportState> {\n  let state = sent;\n  for (let waited = 0; state.status === \"sending\" && waited < budgetMs; waited += ISSUE_POLL_MS) {\n    await sleep(ISSUE_POLL_MS);\n    try {\n      state = await read();\n    } catch {\n      return state;\n    }\n  }\n  return state;\n}\n\nconst reportCommand = defineCommand({\n  meta: {\n    name: \"report\",\n    description: `Tell the Baker team about a defect in Baker or a capability it lacks; sent to their tracker at once.\nStart here: baker feedback report --kind bug --title \"<what is wrong, one sentence>\" --body \"<what you ran, what came back, what you expected>\"`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    const parsed = reportBody(args);\n    if (!parsed.ok) {\n      failValidation(parsed.error);\n    }\n    try {\n      const response = await apiPost<FeedbackReportResponse>(\"/api/feedback/report\", parsed.body);\n      const data = await waitForIssue(\n        response.data,\n        async () => (await apiGet<FeedbackReportResponse>(\"/api/feedback/report\", { id: response.data.id })).data,\n        (ms) => new Promise((resolve) => setTimeout(resolve, ms)),\n      );\n      writeJson({ ok: true, data, hints: REPORT_HINTS });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nexport const feedbackCommand = defineCommand({\n  meta: {\n    name: \"feedback\",\n    description: `Report a defect in Baker, or a capability it lacks, to the Baker team — never to the user, never as a Task. Subcommands: report.\nFull guide: ${DOC}`,\n  },\n  subCommands: { report: reportCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,SAAS,qBAAqB;AAM9B,IAAM,MAAM;AAEZ,IAAM,OAAO;AAAA,EACX,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,cAAc;AAAA,IACZ,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,IACV,SAAS;AAAA,EACX;AACF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AACR,CAAC;AAQM,IAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AACF;AAKO,SAAS,WAAW,MAA4F;AACrH,MAAI,CAAE,sBAA4C,SAAS,KAAK,QAAQ,EAAE,GAAG;AAC3E,WAAO,EAAE,IAAI,OAAO,OAAO,aAAa,sBAAsB,KAAK,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,KAAK;AAAA,EAC1G;AACA,QAAM,SAAS,4BAA4B,UAAU;AAAA,IACnD,MAAM,KAAK;AAAA,IACX,OAAO,KAAK;AAAA,IACZ,MAAM,KAAK;AAAA,IACX,aAAa,KAAK,YAAY,MAAM;AAAA,EACtC,CAAC;AACD,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,OACE;AAAA,IACJ;AAAA,EACF;AACA,SAAO,EAAE,IAAI,MAAM,MAAM,OAAO,KAAK;AACvC;AAGO,IAAM,gBAAgB;AAC7B,IAAM,gBAAgB;AAMtB,eAAsB,aACpB,MACA,MACA,OACA,WAAmB,eACW;AAC9B,MAAI,QAAQ;AACZ,WAAS,SAAS,GAAG,MAAM,WAAW,aAAa,SAAS,UAAU,UAAU,eAAe;AAC7F,UAAM,MAAM,aAAa;AACzB,QAAI;AACF,cAAQ,MAAM,KAAK;AAAA,IACrB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA,EAEf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,WAAW,IAAI;AAC9B,QAAI,CAAC,OAAO,IAAI;AACd,qBAAe,OAAO,KAAK;AAAA,IAC7B;AACA,QAAI;AACF,YAAM,WAAW,MAAM,QAAgC,wBAAwB,OAAO,IAAI;AAC1F,YAAM,OAAO,MAAM;AAAA,QACjB,SAAS;AAAA,QACT,aAAa,MAAM,OAA+B,wBAAwB,EAAE,IAAI,SAAS,KAAK,GAAG,CAAC,GAAG;AAAA,QACrG,CAAC,OAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,MAC1D;AACA,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,aAAa,CAAC;AAAA,IACnD,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;AAEM,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,cACH,GAAG;AAAA,EACf;AAAA,EACA,aAAa,EAAE,QAAQ,cAAc;AACvC,CAAC;","names":[]}