@koda-sl/baker-cli 0.534.0-dev.911a80433 → 0.535.0

package/dist/crm-32RA7QHK.js

@@ -0,0 +1,227 @@
+import {
+  failNotConnected
+} from "./chunk-QSZPHIQ7.js";
+import {
+  writeAdsOutput
+} from "./chunk-SBFNGJ4C.js";
+import "./chunk-RC52N27Q.js";
+import {
+  hubspotCompaniesSearchRequestSchema,
+  hubspotDealsListRequestSchema
+} from "./chunk-HVJJEQDQ.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-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import "./chunk-6THXOWAP.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-S6WPMD3V.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/hubspot/crm.ts
+import { defineCommand } from "citty";
+function dealsListHints(data, request) {
+  const hints = [];
+  if (data.deals.length === 0 && (request.pipelineIds.length > 0 || request.modifiedSince !== void 0)) {
+    hints.push(
+      "No deals matched. Widen the read: drop --pipeline, or pass an earlier --modified-since (`baker hubspot pipelines list` shows the pipeline ids)."
+    );
+  }
+  if (data.next !== null) {
+    hints.push(`More deals follow: run it again with --after ${data.next}.`);
+  }
+  if (data.restartFrom !== null) {
+    hints.push(
+      `HubSpot stops one search at 10,000 deals. Read on with --modified-since ${data.restartFrom} (no --after); the first deal repeats the last one here.`
+    );
+  }
+  if (!data.companiesReadable) {
+    hints.push(
+      "Deals came back without their companies: this HubSpot connection cannot read companies. Do not report a deal as having no company \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
+    );
+  }
+  return hints;
+}
+function companiesSearchHints(data, request) {
+  const hints = [];
+  if (data.notFound.length > 0) {
+    hints.push(
+      `${data.notFound.length} domain(s) are not in HubSpot: ${data.notFound.join(", ")}. Those companies are new to the CRM \u2014 not in pipeline \u2014 which is a finding, not a failed search.`
+    );
+  }
+  if (!request.withDeals && data.companies.length > 0) {
+    hints.push("Add --with-deals to see each company's deals: amount, stage, and whether it closed won.");
+  }
+  if (data.truncated) {
+    hints.push(
+      "More companies matched than --limit, so the search stopped before checking every domain: a domain with no row here may still be in HubSpot, and notFound leaves it out. Do not report a domain without a row as new to the CRM until a search returns every match: raise --limit (up to 500) or search fewer domains at a time."
+    );
+  }
+  return hints;
+}
+function list(raw, separator) {
+  if (typeof raw !== "string") return void 0;
+  const items = raw.split(separator).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function optionalNumber(raw) {
+  return typeof raw === "string" && raw.trim() !== "" ? Number(raw) : void 0;
+}
+function failInvalid(issues) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: issues.map((issue) => `${issue.path.map(String).join(".") || "args"}: ${issue.message}`).join("; ")
+    }
+  });
+  process.exit(1);
+}
+var OUTPUT_ARG = {
+  type: "string",
+  description: "json|csv|jsonl|md (default json). csv/jsonl/md print the rows only; hints go to stderr",
+  required: false,
+  default: "json"
+};
+var COMPANIES_SEARCH_ARGS = {
+  domains: {
+    type: "string",
+    description: "Comma-separated website domains, up to 100 (acme.com,globex.io). URLs and www. are fine",
+    required: false
+  },
+  names: {
+    type: "string",
+    description: "Semicolon-separated exact company names (names contain commas): 'Acme, Inc.;Globex'",
+    required: false
+  },
+  "with-deals": {
+    type: "boolean",
+    description: "Add each company's deals: amount, currency, pipeline, stage, closed/won, dates",
+    required: false,
+    default: false
+  },
+  limit: { type: "string", description: "Most companies to return, 1-500 (default 100)", required: false },
+  output: OUTPUT_ARG
+};
+registerSchema({
+  command: "hubspot.companies.search",
+  description: "Find the client's CRM companies (accounts) by website domain or name \u2014 start here to match an outside list of companies against HubSpot, e.g. the companies `baker ads linkedin companies --with-domains` says the ads reached: which are already accounts, which have deals, which are new. Rows: {id, name, domain, linkedinPage}; --with-deals adds each company's deals. `notFound` lists the domains no CRM company carries \u2014 new to the CRM, a finding; when `truncated`, it leaves out the domains the search did not reach. Reads records only; changes nothing in HubSpot.",
+  args: COMPANIES_SEARCH_ARGS
+});
+var COMPANY_CSV_FIELDS = ["id", "name", "domain", "linkedinPage", "deals"];
+var companiesSearchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Find CRM companies by domain or name, optionally with their deals. Example: baker hubspot companies search --domains acme.com,globex.io --with-deals"
+  },
+  args: COMPANIES_SEARCH_ARGS,
+  run: async ({ args }) => {
+    const input = {
+      domains: list(args.domains, ","),
+      names: list(args.names, ";"),
+      withDeals: Boolean(args["with-deals"]),
+      limit: optionalNumber(args.limit)
+    };
+    const parsed = hubspotCompaniesSearchRequestSchema.safeParse(input);
+    if (!parsed.success) failInvalid(parsed.error.issues);
+    try {
+      const response = await apiPost("/api/hubspot/companies/search", parsed.data);
+      const hints = companiesSearchHints(response.data, { withDeals: parsed.data.withDeals === true });
+      const format = String(args.output ?? "json");
+      if (format !== "json") {
+        writeAdsOutput(response.data.companies, format, COMPANY_CSV_FIELDS, hints);
+        return;
+      }
+      writeJson({
+        ...response,
+        meta: { count: response.data.companies.length },
+        ...hints.length > 0 ? { hints } : {}
+      });
+    } catch (err) {
+      failNotConnected(err, "so I can see which of your companies and deals the ads reached");
+    }
+  }
+});
+var DEALS_LIST_ARGS = {
+  pipeline: {
+    type: "string",
+    description: "Comma-separated pipeline ids, from `baker hubspot pipelines list` (default: every pipeline)",
+    required: false
+  },
+  "modified-since": {
+    type: "string",
+    description: "Only deals changed on or after this date (YYYY-MM-DD or ISO date-time)",
+    required: false
+  },
+  limit: { type: "string", description: "Most deals to return, 1-1000 (default 200)", required: false },
+  after: { type: "string", description: "Cursor from the previous page's `next`", required: false },
+  output: OUTPUT_ARG
+};
+registerSchema({
+  command: "hubspot.deals.list",
+  description: "The client's deals, oldest change first: {id, name, amount, currency, pipelineId, stageId, stageLabel, isClosed, isWon, createdAt, closedAt, modifiedAt, companyIds}. Start here for pipeline and revenue questions \u2014 which deals closed won, what is open, which companies they belong to (`companyIds` are HubSpot company ids, the same as `hubspot companies search` returns). Page with --after <next> until it is null. `amount: null` means no amount was entered, not zero.",
+  args: DEALS_LIST_ARGS
+});
+var DEAL_CSV_FIELDS = [
+  "id",
+  "name",
+  "amount",
+  "currency",
+  "pipelineId",
+  "stageId",
+  "stageLabel",
+  "isClosed",
+  "isWon",
+  "createdAt",
+  "closedAt",
+  "modifiedAt",
+  "companyIds"
+];
+var dealsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List deals with amount, stage and whether they closed won. Example: baker hubspot deals list --pipeline default --modified-since 2026-01-01"
+  },
+  args: DEALS_LIST_ARGS,
+  run: async ({ args }) => {
+    const input = {
+      pipelineIds: list(args.pipeline, ","),
+      modifiedSince: typeof args["modified-since"] === "string" ? args["modified-since"] : void 0,
+      limit: optionalNumber(args.limit),
+      after: typeof args.after === "string" && args.after !== "" ? args.after : void 0
+    };
+    const parsed = hubspotDealsListRequestSchema.safeParse(input);
+    if (!parsed.success) failInvalid(parsed.error.issues);
+    try {
+      const response = await apiPost("/api/hubspot/deals/list", parsed.data);
+      const hints = dealsListHints(response.data, {
+        pipelineIds: parsed.data.pipelineIds ?? [],
+        modifiedSince: parsed.data.modifiedSince
+      });
+      const format = String(args.output ?? "json");
+      if (format !== "json") {
+        writeAdsOutput(response.data.deals, format, DEAL_CSV_FIELDS, hints);
+        return;
+      }
+      writeJson({ ...response, meta: { count: response.data.deals.length }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err, "so I can see which of your companies and deals the ads reached");
+    }
+  }
+});
+export {
+  companiesSearchCommand,
+  companiesSearchHints,
+  dealsListCommand,
+  dealsListHints
+};
+//# sourceMappingURL=crm-32RA7QHK.js.map

package/dist/crm-S36XN5QR.js

@@ -0,0 +1,323 @@
+import {
+  crmColumnMeanings,
+  crmColumnQuestions
+} from "./chunk-UBDY5RE4.js";
+import {
+  crmBatchFromSheet,
+  crmColumnReading,
+  crmPushBrief,
+  crmPushRequestSchema,
+  crmPushUrl,
+  exactCrmColumns,
+  judgeCrmBatch,
+  sheetDelimiter
+} from "./chunk-I7AYMJZA.js";
+import "./chunk-GRQ2AXDX.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-RJ675DP3.js";
+import "./chunk-V6F2QWUZ.js";
+import {
+  askJevQuestions
+} from "./chunk-AIOKWGMO.js";
+import "./chunk-EJWTQDKA.js";
+import "./chunk-7UTWZGIV.js";
+import "./chunk-6LU64W5J.js";
+import {
+  failApi
+} from "./chunk-RC52N27Q.js";
+import "./chunk-HVJJEQDQ.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-46YLDIQG.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import {
+  getEnv
+} from "./chunk-6THXOWAP.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-S6WPMD3V.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/accounts/crm.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+import { parse } from "csv-parse/sync";
+var MAX_REJECTIONS_SHOWN = 20;
+var SAMPLES_MAX = 3;
+function jsonKind(batch) {
+  const body = batch;
+  const companies = (body?.companies?.length ?? 0) > 0;
+  const deals = (body?.deals?.length ?? 0) > 0;
+  if (companies && deals) return "both";
+  return companies ? "companies" : "deals";
+}
+async function readBatch(name, text, readColumns) {
+  if (name.toLowerCase().endsWith(".json")) {
+    const batch = JSON.parse(text);
+    return { format: "json", kind: jsonKind(batch), batch, ignoredColumns: [], unread: [] };
+  }
+  const rows = parse(text, {
+    bom: true,
+    columns: true,
+    delimiter: sheetDelimiter(text),
+    skip_empty_lines: true,
+    relax_column_count: true,
+    trim: true
+  });
+  const headers = Object.keys(rows[0] ?? {});
+  const exact = exactCrmColumns(headers);
+  const rest = headers.filter((header) => exact[header] === void 0).map((header) => ({
+    header,
+    samples: rows.map((row) => row[header] ?? "").filter(Boolean).slice(0, SAMPLES_MAX)
+  }));
+  const answers = rest.length > 0 ? await readColumns(crmColumnQuestions(rest, headers)) : [];
+  const meanings = answers ? { ...crmColumnMeanings(rest, answers), ...exact } : exact;
+  const sheet = crmBatchFromSheet(rows, crmColumnReading(meanings));
+  return {
+    format: "csv",
+    kind: sheet.kind,
+    batch: sheet.batch,
+    ignoredColumns: sheet.ignoredColumns,
+    unread: answers ? [] : rest.map((column) => column.header)
+  };
+}
+async function checkCrmFile(name, text, readColumns) {
+  const { format, kind, batch, ignoredColumns, unread } = await readBatch(name, text, readColumns);
+  const body = crmPushRequestSchema.safeParse(batch);
+  if (!body.success) throw new Error(body.error.issues[0]?.message ?? "not a batch of companies and deals");
+  const judged = judgeCrmBatch(body.data);
+  const kept = (items) => items.filter((item) => !item.deleted).length;
+  const rejectedOf = (kind2) => judged.rejected.filter((r) => r.kind === kind2).length;
+  const data = {
+    file: name,
+    format,
+    kind,
+    received: {
+      companies: judged.companies.length + rejectedOf("company"),
+      deals: judged.deals.length + rejectedOf("deal")
+    },
+    accepted: { companies: kept(judged.companies), deals: kept(judged.deals) },
+    rejected: judged.rejected.slice(0, MAX_REJECTIONS_SHOWN),
+    rejectedCount: judged.rejected.length,
+    ignoredColumns
+  };
+  const hints = [];
+  if (judged.rejected.length > 0) {
+    hints.push(
+      `${judged.rejected.length} record(s) would be refused \u2014 fix them in the file (each message names the field) and check again. The rest would still be accepted.`
+    );
+  }
+  if (kind === "companies") {
+    hints.push(
+      "Read as a company list (one row per company). A website or LinkedIn page is enough to know a company by; deals sent later with the same website land on it."
+    );
+  }
+  if (unread.length > 0) {
+    hints.push(
+      `These columns could not be read just now, so this check leaves them out: ${unread.join(", ")}. The upload reads them again; check once more to see what they hold.`
+    );
+  }
+  const left = ignoredColumns.filter((header) => !unread.includes(header));
+  if (left.length > 0) {
+    hints.push(`These columns are left behind and never sent: ${left.join(", ")}.`);
+  }
+  hints.push(
+    format === "csv" ? "Nothing was sent. The user uploads this file themselves in Measure \u2192 Sources \u2192 Deals \u2192 Send your deals \u2192 Upload a file \u2014 or keeps it in a Google Sheet and links it there (Google Sheets), which Baker then reads every night." : "Nothing was sent. This is the body their system posts to the address in `baker accounts crm contract`, with their CRM sending key."
+  );
+  return { data, hints };
+}
+registerSchema({
+  command: "accounts.crm.status",
+  description: "Start here when a client's deals are not in HubSpot. Where Account insights reads deals from (source: hubspot | api \u2014 api means the client sends them), the address their system sends to, the last live send and the last test send (when, via upload | sheet | api, how many companies and deals, the first refusals and why), the Google Sheets Baker reads every night (each with its last read, or why it failed), and what Baker holds now (companies, deals, deals per pipeline and stage, and how many were sent as won or lost).",
+  args: {}
+});
+var statusCommand = defineCommand({
+  meta: {
+    name: "status",
+    description: "Where the client's deals come from and what has arrived. Example: baker accounts crm status"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const response = await apiGet("/api/accounts/crm/status");
+      writeJson({ ...response, hints: statusHints(response.data) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+function sheetHints(sheets) {
+  return sheets.filter((sheet) => sheet.lastRead !== null && !sheet.lastRead.ok).map(
+    (sheet) => `Baker could not read the linked Google Sheet "${sheet.spreadsheetName} \xB7 ${sheet.tab}": ${sheet.lastRead?.message ?? "no reason given"} Tell the user; they fix it in Measure \u2192 Sources \u2192 Deals \u2192 Google Sheets (Read now, or link it again). What it brought stays in Baker until then.`
+  );
+}
+function refusedHints(lastLive) {
+  if (lastLive === null || lastLive.rejected === 0) return [];
+  const reasons = [...new Set(lastLive.samples.map((sample) => sample.message))].join("; ");
+  return [
+    `${lastLive.rejected} record(s) in the last send were refused and are not in Baker (${reasons}). The rest arrived. Tell the user what to fix in their file, sheet or system; the next send takes the corrected rows.`
+  ];
+}
+function statusHints(data) {
+  if (data.source === null) {
+    return [
+      "Nobody has said where the deals are yet. The user chooses in Measure \u2192 Accounts: HubSpot, or Another CRM (they send the deals)."
+    ];
+  }
+  if (data.source === "hubspot") return ["Deals are read from HubSpot; nothing needs sending."];
+  const failing = [...sheetHints(data.sheets), ...refusedHints(data.lastLive)];
+  if (data.lastLive === null && data.sheets.length === 0) {
+    return [
+      "Another CRM is chosen and nothing has arrived. Offer the three ways in, all in Measure \u2192 Sources \u2192 Deals: a CSV of deals or of companies uploaded there (check it first with `baker accounts crm check --file`), a Google Sheet they link there and Baker reads every night, or their developer sending from their system (`baker accounts crm contract`)."
+    ];
+  }
+  if ((data.contents?.companies ?? 0) > 0 && (data.contents?.deals ?? 0) === 0) {
+    return [
+      ...failing,
+      "Only companies have arrived, no deals. Baker matches them to the companies the LinkedIn ads reach, but no pipeline or revenue counts as influenced until deals arrive: offer the same ways in for a deals export (a deal names its company by the same website)."
+    ];
+  }
+  const sentStatus = (data.contents?.stages ?? []).some((stage) => stage.won > 0 || stage.lost > 0);
+  if (sentStatus || (data.contents?.deals ?? 0) === 0) return failing;
+  return [
+    ...failing,
+    "The deals arrived without a status (open, won, lost). Unless the user has picked which stages mean won and lost in Measure \u2192 Sources \u2192 Deals, no deal counts as won: send status with each deal, or ask them to pick."
+  ];
+}
+var CHECK_ARGS = {
+  file: {
+    type: "string",
+    description: "A CSV of deals or of companies (one row each), or a JSON body { companies, deals }",
+    required: true
+  }
+};
+registerSchema({
+  command: "accounts.crm.check",
+  description: "Check a client's CRM file before they send it: judged by exactly the rules the upload, a linked Google Sheet and the endpoint use, nothing stored. A CSV is a deals export (the deal's id, name, company, website, LinkedIn page, amount, currency, pipeline, stage, status, created and closed dates) or a company list (the company's id, name, website, LinkedIn page \u2014 a website alone is enough), told apart by its columns. Headers are read in any language or CRM wording, as the upload reads them; columns that are none of these are left behind. Dates may be YYYY-MM-DD or 15/03/2026. Returns {kind, received, accepted, rejected (each with the field and why), ignoredColumns}. Records naming a person (contact, owner, email, phone) are refused.",
+  args: CHECK_ARGS
+});
+var checkCommand = defineCommand({
+  meta: {
+    name: "check",
+    description: "Check a CRM export will be accepted, without sending it. Example: baker accounts crm check --file deals.csv"
+  },
+  args: CHECK_ARGS,
+  run: async ({ args }) => {
+    try {
+      const spent = [];
+      const { data, hints } = await checkCrmFile(
+        args.file,
+        readFileSync(args.file, "utf8"),
+        (questions) => askJevQuestions(questions, (usage) => spent.push(usage))
+      );
+      await holdWorkspaceSpend(spent);
+      writeJson({ ok: true, data, hints });
+    } catch (error) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "INVALID_FILE",
+          message: `${args.file} could not be read as CSV or JSON: ${error instanceof Error ? error.message : String(error)}`
+        }
+      });
+      process.exit(1);
+    }
+  }
+});
+registerSchema({
+  command: "accounts.crm.contract",
+  description: "The whole contract for a client's developer (or their coding assistant) as Markdown: the address, the key to use, test mode, every company and deal field, the answer and an example. Hand it over as it is; never put a key in it.",
+  args: {}
+});
+var contractCommand = defineCommand({
+  meta: {
+    name: "contract",
+    description: "What a client's system sends, for their developer. Example: baker accounts crm contract"
+  },
+  args: {},
+  run: () => {
+    const env = getEnv();
+    process.stdout.write(crmPushBrief(crmPushUrl(env.BAKER_PUBLIC_API_URL, env.BAKER_API_URL)));
+  }
+});
+var SHEET_ARGS = {
+  account: {
+    type: "string",
+    description: "The Google Drive connection to create it with, when the company has more than one",
+    required: false
+  }
+};
+registerSchema({
+  command: "accounts.crm.sheet",
+  description: `Create the deals sheet LinkedIn's Account insights reads, for a company running LinkedIn campaigns whose CRM Baker cannot read (anything but HubSpot). Makes "Deals and companies for Baker" in the client's Google Drive \u2014 a Deals tab and a Companies tab headed by the columns Baker reads \u2014 and links both, so Baker reads it every night; chooses Another CRM first when nobody has said where the deals are. Applies at once (it is a real file) and goes on the chat's change list. Empty: nothing counts until the client fills it or pastes their CRM export into it. Asking again returns the sheet already linked. Needs a Google Drive connection and a chat owned by an admin of the company; refused when HubSpot is where the deals come from. Returns {created, spreadsheetName, url, tabs}.`,
+  args: SHEET_ARGS
+});
+function sheetFailureFix(code, message) {
+  if (code === "NOT_FOUND" && message.startsWith("No Google Drive account is connected")) {
+    return {
+      action: "request_connection",
+      explanation: 'Google Drive is not connected, and the sheet is made in it. Don\'t send the user to Settings or end the turn \u2014 call the `request_connection` tool with { platform: "google-drive", reason: "so I can create the sheet of your deals that LinkedIn Account insights reads" }; once they connect, run `baker accounts crm sheet` again. If they decline or the call fails, carry on with the rest of the work and leave a Task saying the deals sheet is still to create.'
+    };
+  }
+  if (message.startsWith("Only an admin")) {
+    return {
+      action: "continue_without",
+      explanation: "Carry on with the rest of the work and leave a Task for an admin: create the deals sheet for LinkedIn Account insights."
+    };
+  }
+  return null;
+}
+var sheetCommand = defineCommand({
+  meta: {
+    name: "sheet",
+    description: "Start here when the client runs LinkedIn ads and their deals are not in HubSpot: create and link the Google Sheet of deals Account insights reads. Example: baker accounts crm sheet"
+  },
+  args: SHEET_ARGS,
+  run: async ({ args }) => {
+    try {
+      const account = typeof args.account === "string" && args.account.trim() !== "" ? args.account.trim() : void 0;
+      const response = await apiPost("/api/accounts/crm/sheet", account ? { account } : {});
+      writeJson({
+        ...response,
+        hints: [
+          `Give the user the link (${response.data.url}). The client fills the Deals tab \u2014 or pastes their CRM's deals export into it \u2014 and keeps it up to date; Baker reads it every night, and "Read now" in Measure \u2192 Sources \u2192 Deals reads it at once. A website on each deal is enough to match it to the companies the LinkedIn ads reach.`,
+          "Check what arrived later with `baker accounts crm status`."
+        ]
+      });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const fix = sheetFailureFix(err.code, err.message);
+        if (fix) {
+          writeJson({ ok: false, error: { code: err.code, message: err.message, fix } });
+          process.exit(1);
+        }
+      }
+      failApi(err);
+    }
+  }
+});
+var crmCommand = defineCommand({
+  meta: {
+    name: "crm",
+    description: "A CRM Baker cannot read (Salesforce, Pipedrive, a Google Sheet, their own): where the deals and companies stand, create the deals sheet Baker reads, check a file before it is sent, and the contract a developer sends to. Nothing here sends a deal."
+  },
+  subCommands: { status: statusCommand, sheet: sheetCommand, check: checkCommand, contract: contractCommand }
+});
+export {
+  checkCrmFile,
+  crmCommand,
+  sheetFailureFix,
+  statusHints
+};
+//# sourceMappingURL=crm-S36XN5QR.js.map

package/dist/crop-L3ALN7OW.js

@@ -0,0 +1,113 @@
+import {
+  atomicWrite,
+  isRemoteUrl,
+  readImageBuffer,
+  resolveOutputPath
+} from "./chunk-EPSAWDYY.js";
+import "./chunk-6LU64W5J.js";
+import "./chunk-6THXOWAP.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-S6WPMD3V.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/crop.ts
+import { defineCommand } from "citty";
+
+// src/lib/image/crop-sprite.ts
+import sharp from "sharp";
+function cropSprite(input, region) {
+  return sharp(input).extract({
+    left: Math.round(region.x),
+    top: Math.round(region.y),
+    width: Math.round(region.width),
+    height: Math.round(region.height)
+  }).png().toBuffer();
+}
+
+// src/commands/images/crop.ts
+registerSchema({
+  command: "images.crop",
+  description: "Crop a rectangular region from a local image or remote URL. Coordinate-based extract.",
+  args: {
+    file: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    x: { type: "number", description: "Left coordinate (px)", required: true },
+    y: { type: "number", description: "Top coordinate (px)", required: true },
+    width: { type: "number", description: "Region width (px)", required: true },
+    height: { type: "number", description: "Region height (px)", required: true },
+    output: {
+      type: "string",
+      description: "Output path. Default: in-place for local files, ./crop.png for URLs.",
+      required: false
+    }
+  }
+});
+var ValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationError";
+  }
+};
+function parseRegion(args) {
+  const result = { x: 0, y: 0, width: 0, height: 0 };
+  for (const key of ["x", "y", "width", "height"]) {
+    const raw = args[key];
+    const n = typeof raw === "number" ? raw : raw !== void 0 && raw !== "" ? Number(raw) : Number.NaN;
+    if (!Number.isFinite(n) || n < 0) {
+      throw new ValidationError(`--${key} must be a non-negative number`);
+    }
+    result[key] = n;
+  }
+  if (result.width === 0 || result.height === 0) {
+    throw new ValidationError("--width and --height must be > 0");
+  }
+  return result;
+}
+function emitError(err) {
+  if (err instanceof ValidationError) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+  } else {
+    const message = err instanceof Error ? err.message : "Unexpected error";
+    writeJson({ ok: false, error: { code: "IMAGE_PROCESSING_ERROR", message } });
+  }
+  process.exit(1);
+}
+var cropCommand = defineCommand({
+  meta: {
+    name: "crop",
+    description: "Crop a rectangular region from an image.\n\nExample: baker images crop sprite.png --x 0 --y 0 --width 64 --height 64 --output icon.png"
+  },
+  args: {
+    file: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    x: { type: "string", description: "Left coordinate (px)", required: false },
+    y: { type: "string", description: "Top coordinate (px)", required: false },
+    width: { type: "string", description: "Region width (px)", required: false },
+    height: { type: "string", description: "Region height (px)", required: false },
+    output: { type: "string", description: "Output path", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      if (!file) {
+        throw new ValidationError("file argument is required");
+      }
+      const region = parseRegion(args);
+      const outputArg = typeof args.output === "string" && args.output.length > 0 ? args.output : void 0;
+      const inputBuffer = await readImageBuffer(file);
+      const output = await cropSprite(inputBuffer, region);
+      const outputPath = isRemoteUrl(file) ? outputArg ?? "./crop.png" : await resolveOutputPath(file, outputArg, { multipleInputs: false, newExtension: ".png" });
+      await atomicWrite(outputPath, output);
+      writeJson({
+        ok: true,
+        data: { input: file, output: outputPath, sizeBytes: output.length, region }
+      });
+    } catch (err) {
+      emitError(err);
+    }
+  }
+});
+export {
+  cropCommand
+};
+//# sourceMappingURL=crop-L3ALN7OW.js.map