@koda-sl/baker-cli 0.561.0 → 0.563.0-dev.25ca3cbc8

package/dist/experiments-EMTSSDXU.js

@@ -0,0 +1,236 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-LEH6IUC4.js";
+import {
+  handleLinkedinError
+} from "./chunk-GEGFJCAF.js";
+import "./chunk-CDTAKCJR.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.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-EMTSSDXU.js.map

package/dist/extract-AZFZHNJF.js

@@ -0,0 +1,143 @@
+import {
+  parseRequestFlags
+} from "./chunk-4N3Y5QWW.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-KNA3OWJC.js";
+import "./chunk-I7OJZ7QE.js";
+import {
+  IMAGES_EXTRACT_LIMIT_MAX,
+  imagesExtractRequestSchema
+} from "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/extract.ts
+import { defineCommand } from "citty";
+
+// src/commands/images/extractErrors.ts
+var RETRYABLE = /* @__PURE__ */ new Set(["UNAVAILABLE", "RATE_LIMITED", "TIMEOUT", "NETWORK_ERROR"]);
+var PAGE_FAILURES = /* @__PURE__ */ new Set(["VALIDATION_ERROR", "INTERNAL_ERROR"]);
+function extractErrorEnvelope(err, url) {
+  const retryable = RETRYABLE.has(err.code);
+  const fallback = `use \`baker images screenshot ${url}\` to capture the page as one image, or \`baker images logo <domain>\` for the brand's mark, and carry on with the rest of the job.`;
+  const fix = retryable ? { action: "retry_once", explanation: `Run the same command once more. If it fails again, ${fallback}` } : PAGE_FAILURES.has(err.code) ? { action: "use_fallback", explanation: `Retrying the same address will fail the same way \u2014 ${fallback}` } : err.fix;
+  return {
+    ok: false,
+    error: { code: err.code, message: err.message, retryable, ...fix ? { fix } : {} }
+  };
+}
+
+// src/commands/images/extract.ts
+registerSchema({
+  command: "images.extract",
+  description: "Extract images from a URL via Firecrawl (formats: images).",
+  args: {
+    url: { type: "string", description: "URL to scrape", required: true },
+    "wait-for": { type: "number", description: "JS render wait ms", required: false },
+    limit: {
+      type: "number",
+      description: `Most images to return (1-${IMAGES_EXTRACT_LIMIT_MAX}, default ${IMAGES_EXTRACT_LIMIT_MAX})`,
+      required: false,
+      default: IMAGES_EXTRACT_LIMIT_MAX
+    },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.extract}, default 0)`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides provider-derived context)",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var extractCommand = defineCommand({
+  meta: {
+    name: "extract",
+    description: "Pull every image from a single URL via Firecrawl. ~$0.001/scrape. Cap auto-ingest at 20.\n\nExample: baker images extract https://stripe.com --auto-ingest 5"
+  },
+  args: {
+    url: { type: "positional", description: "URL to scrape", required: false },
+    "wait-for": { type: "string", description: "JS render wait ms", required: false },
+    limit: { type: "string", description: `Most images to return (1-${IMAGES_EXTRACT_LIMIT_MAX})`, required: false },
+    "auto-ingest": { type: "string", description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.extract})`, required: false },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const url = args.url;
+      if (!url) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+        process.exit(1);
+      }
+      const body = { url };
+      if (args["wait-for"]) body.waitFor = Number(args["wait-for"]);
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.extract);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.extract}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const request = parseRequestFlags(imagesExtractRequestSchema, body, { limit: "--limit", waitFor: "--wait-for" });
+      if (!request.ok) {
+        writeJson(request.envelope);
+        process.exit(1);
+      }
+      const data = await apiPost("/api/images/extract", request.data);
+      writeProviderHits(data, data.hits, args, []);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson(extractErrorEnvelope(err, String(args.url)));
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  extractCommand
+};
+//# sourceMappingURL=extract-AZFZHNJF.js.map

package/dist/facets-6BAX2PIL.js

@@ -0,0 +1,117 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-GEGFJCAF.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-RBCO3C3Q.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.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-6BAX2PIL.js.map

package/dist/feedback-BB6HQ2ZD.js

@@ -0,0 +1,114 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-HC6464KT.js";
+import {
+  PLATFORM_REPORT_KINDS,
+  feedbackReportRequestSchema
+} from "./chunk-OVNVYNVH.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-7XFVKPE5.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.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). Answers as soon as it is saved; it reaches the Baker team on its own, with the client's details taken out. 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: once saved, the report reaches their tracker on its own, so a status of sending is the normal answer and there is nothing more to do or to tell the user about delivery. 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 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);
+      writeJson({ ok: true, data: response.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 {
+  REPORT_HINTS,
+  feedbackCommand,
+  reportBody
+};
+//# sourceMappingURL=feedback-BB6HQ2ZD.js.map

package/dist/feedback-BB6HQ2ZD.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} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { 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). Answers as soon as it is saved; it reaches the Baker team on its own, with the client\\'s details taken out. 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: once saved, the report reaches their tracker on its own, so a status of sending is the normal answer and there is nothing more to do or to tell the user about delivery. 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\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      writeJson({ ok: true, data: response.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":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,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;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,gBAAU,EAAE,IAAI,MAAM,MAAM,SAAS,MAAM,OAAO,aAAa,CAAC;AAAA,IAClE,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":[]}