@flowapt/flowiq-cli 0.10.0 → 0.12.0

package/src/index.js

@@ -41,6 +41,9 @@ import * as broadcastCmd from "./commands/broadcast.js";
 import * as segmentsCmd from "./commands/segments.js";
 import * as tagCmd from "./commands/tag.js";
 import * as linksCmd from "./commands/links.js";
+import * as membersCmd from "./commands/members.js";
+import * as notesCmd from "./commands/notes.js";
+import * as productsCmd from "./commands/products.js";
 import * as keywordsCmd from "./commands/keywords.js";
 import * as guideCmd from "./commands/guide.js";
 import * as auditCmd from "./commands/audit.js";
@@ -116,7 +119,8 @@ export function run(argv) {
     .action((orgId, auditId, opts) => promptsCmd.restore(orgId, auditId, opts));
   prompts.command("push <slug-or-path>")
     .description("Apply a local JSON file's prompt_sections back to the agent it was pulled from (regenerates system_prompt server-side)")
-    .action((id) => promptsCmd.push(id));
+    .option("--dry-run", "print what would change (added / removed / changed sections against the live agent) and write nothing")
+    .action((id, opts) => promptsCmd.push(id, opts));
 
   // questionnaires
   const qs = program.command("questionnaires")
@@ -144,9 +148,20 @@ export function run(argv) {
     .option("--until <when>", "upper bound")
     .option("--sender-type <list>", "comma list, e.g. bot-whatsapp or user-whatsapp,user-web (default: conversation rows only)")
     .option("--include-templates", "also match template / broadcast payloads")
+    .option("--tool-calls", "search inside tool-call rows' request / response instead of message text (what a tool was asked and answered)")
     .option("--limit <n>", "max rows (default 200, max 1000)")
     .option("--json", "raw JSON (rows carry contact_id)")
     .action((orgId, text, opts) => messagesCmd.search(orgId, text, opts));
+  msgs.command("purge <organization_id>")
+    .description("DELETE messages org-wide by pattern: email subject regex, text, sender types, time window (5,000 a run). Dry run by default; --confirm asks you to type the org id")
+    .option("--subject-regex <re>", "case-insensitive regex on the email subject (more_data.subject), e.g. '^Automatic reply'")
+    .option("--text <substr>", "message text contains this")
+    .option("--sender-type <list>", "comma list, e.g. user-email")
+    .option("--since <when>", "only rows newer than this (30d | YYYY-MM-DD)")
+    .option("--before <when>", "only rows older than this")
+    .option("--confirm", "actually delete (typed confirmation follows)")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => messagesCmd.purge(orgId, opts));
   msgs.command("failures <organization_id>")
     .description("What failed to send and why (Meta error codes by reason / media / contact), plus sends Meta accepted and never confirmed")
     .option("--since <when>", "7d (default) | 24h | 30d | YYYY-MM-DD")
@@ -158,6 +173,13 @@ export function run(argv) {
     .option("--until <when>", "upper bound (default now)")
     .option("--json", "raw JSON")
     .action((orgId, opts) => messagesCmd.stats(orgId, opts));
+  msgs.command("delete <contact_id>")
+    .description("DELETE a contact's messages (all, older than --before, or only --sender-type). Dry run by default; --confirm asks you to type the contact id")
+    .option("--before <when>", "only rows older than this: 30d | 2w | YYYY-MM-DD | ISO time")
+    .option("--sender-type <list>", "only these sender types, e.g. tool-call,steer")
+    .option("--confirm", "actually delete (typed confirmation follows)")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => messagesCmd.remove(contactId, opts));
 
   // fine-tuning (agents.fine_tuning text + agents.fine_tuning_entries jsonb)
   const ft = program.command("fine-tuning")
@@ -428,10 +450,23 @@ export function run(argv) {
   // org (read-only org summary for the prompt-builder skill, creds stripped)
   const org = program.command("org").description("Org info (read), create a new organization, read/set its feature flags");
   org.command("list [search]")
-    .description("List organizations with their UUIDs — the lookup every other command needs (filter by name/slug)")
+    .description("List organizations with their UUIDs — the lookup every other command needs (filter by name/slug, or find by WhatsApp number)")
     .option("--all", "include inactive organizations")
+    .option("--number <digits>", "find the org by its WhatsApp number (any format), Meta phone id or WABA id")
     .option("--json", "raw JSON")
     .action((search, opts) => orgCmd.list(search, opts));
+  org.command("agent <organization_id> <on|off>")
+    .description("The agent master switch (wati_webhook_status): off = no customer gets the AI. Dry-run unless --commit; ON without test mode needs --yes")
+    .option("--commit", "write the change")
+    .option("--yes", "confirm switching ON for every customer (vert.active not false, no allowlist)")
+    .option("--json", "raw JSON")
+    .action((orgId, state, opts) => orgCmd.agentSwitch(orgId, state, opts));
+  org.command("park <organization_id>")
+    .description("Park an org (organizations.inactive = true: hidden from censuses and crons; nothing deleted). --unpark reverses it. Needs --confirm")
+    .option("--unpark", "set inactive = false")
+    .option("--confirm", "write the change")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => orgCmd.park(orgId, opts));
   org.command("create")
     .description("Create a NEW organization (org row + admin membership; owner defaults to you)")
     .requiredOption("--name <name>", "organization name")
@@ -460,9 +495,13 @@ export function run(argv) {
     .option("--json", "raw JSON")
     .action((orgId, opts) => orgCmd.health(orgId, opts));
   org.command("automations <organization_id>")
-    .description("Automated order messages (automated_messages_config): each type, its template and whether that template is approved")
+    .description("Automated order messages (automated_messages_config): each type, its template and whether that template is approved; --set changes a type's template or mapping")
     .option("--enable [type]", "switch a type on (or the whole feature with no type); dry run unless --commit")
     .option("--disable [type]", "switch a type off (or the whole feature)")
+    .option("--set <type>", "change this type: with --template / --body / --buttons")
+    .option("--template <name>", "with --set: the template name to send (must exist in FlowIQ's templates; approval is checked and warned)")
+    .option("--body <map>", "with --set: body param mapping, param1=full_name,param2=order_number (\"none\" clears)")
+    .option("--buttons <map>", "with --set: button param mapping, param1=short_code (\"none\" clears)")
     .option("--commit", "write the change")
     .option("--json", "raw JSON")
     .action((orgId, opts) => orgCmd.automations(orgId, opts));
@@ -558,6 +597,13 @@ export function run(argv) {
     .description("List the org's agents (★ = active); use an id as --agent <id> elsewhere")
     .option("--json", "print the raw JSON payload")
     .action((orgId, opts) => agentsCmd.list(orgId, opts));
+  agent.command("flags")
+    .description("Cross-org census of every active agent: model, reasoning, prompt switch, tool gates (product_lookup, tickets, postal, …)")
+    .option("--tool <flag[=bool]>", "only agents where this tool flag is on (or =false: off)")
+    .option("--model <substr>", "only agents whose model contains this")
+    .option("--all", "include inactive orgs")
+    .option("--json", "raw JSON")
+    .action((opts) => agentsCmd.flags(opts));
   agent.command("create <organization_id>")
     .description("Create a new agent (optionally seed its prompt + set it active)")
     .requiredOption("--name <name>", "agent name")
@@ -663,6 +709,27 @@ export function run(argv) {
     .option("--json", "print the raw response")
     .option("--out <file>", "also write the full plan JSON to a file")
     .action((planId, opts) => plansCmd.show(planId, opts));
+  plans.command("create <organization_id>")
+    .description("File a plan on the client's Planning board (the MCP submit_plan row; staff are exempt from the client lead time). Dry run unless --commit")
+    .requiredOption("--topic <text>", "campaign name (under 120 chars)")
+    .requiredOption("--type <t>", "utility | marketing")
+    .requiredOption("--date <YYYY-MM-DD>", "send date (SAST)")
+    .option("--time <HH:MM>", "send time SAST (omit = any time that day)")
+    .option("--product <text>", "product or collection it is about")
+    .option("--audience <text>", "who it goes to, in words (omit = the whole opted-in list)")
+    .option("--line-1 <text>", "utility: first sentence after \"Hi [Name],\"")
+    .option("--line-2 <text>", "utility: second paragraph")
+    .option("--follow-up <text>", "utility: the message VIEW MORE sends")
+    .option("--landing <url>", "utility: the https:// page CLICK HERE opens")
+    .option("--message <text>", "marketing: the full first message (≤ 1,024 chars)")
+    .option("--button <spec>", "marketing button, repeatable: quick_reply:TEXT | url:TEXT=https://… | phone:TEXT=+27… | copy_code:CODE", (v, acc) => (acc || []).concat([v]), [])
+    .option("--reply <text=follow-up>", "marketing: the message a quick_reply button sends (repeatable)", (v, acc) => (acc || []).concat([v]), [])
+    .option("--graphic <brief>", "have Flowapt design the image: describe it")
+    .option("--media <url>", "use your own public https:// image or video instead")
+    .option("--draft", "save as a draft (nobody alerted) instead of filing for review")
+    .option("--commit", "file it")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => plansCmd.create(orgId, opts));
   plans.command("status <plan_id>")
     .description("Change a plan's status (dry run unless --commit); approved/rejected also record you as the reviewer")
     .requiredOption("--to <status>", "draft | pending_review | approved | rejected | scheduled | sent | cancelled")
@@ -679,9 +746,29 @@ export function run(argv) {
     .option("--limit <n>", "max matches (default 20, max 100)").option("--json", "raw JSON")
     .action((orgId, opts) => contactsCmd.find(orgId, opts));
   contacts.command("show <contact_id>")
-    .description("One contact's record + inbox state (needs --org)")
-    .requiredOption("--org <organization_id>", "the contact's org").option("--json", "raw JSON")
+    .description("One contact's record + inbox state (the org is resolved from the id; --org to pin it)")
+    .option("--org <organization_id>", "the contact's org (optional since 0.12.0)").option("--json", "raw JSON")
     .action((contactId, opts) => contactsCmd.show(contactId, opts));
+  contacts.command("add <organization_id>")
+    .description("Create one contact by hand (a tester, a team member for a test send). Dry run unless --commit")
+    .requiredOption("--whatsapp-id <digits>", "the number with country code, e.g. 27637186304")
+    .option("--name <name>", "full_name")
+    .option("--email <email>", "email")
+    .option("--no-broadcast", "allow_broadcast false (default: true, like the inbox)")
+    .option("--ai-off", "bot_status false (default: on)")
+    .option("--tag <csv>", "tags to start with")
+    .option("--commit", "create it")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => contactsCmd.add(orgId, opts));
+  contacts.command("ai <on|off> <organization_id>")
+    .description("Switch the AI agent on or off for every contact on a tag (or an id list), writing the agent-on/off row each chat shows. Dry run unless --commit")
+    .option("--tag <tag>", "every contact carrying this tag")
+    .option("--contact <id>", "contact UUID (repeatable)", (v, acc) => (acc || []).concat([v]), [])
+    .option("--ids-file <path>", "file of contact UUIDs")
+    .option("--reason <text>", "noted on the agent-on/off row and the audit")
+    .option("--commit", "write bot_status + the marker rows")
+    .option("--json", "raw JSON")
+    .action((state, orgId, opts) => contactsCmd.ai(state, orgId, opts));
   contacts.command("census <organization_id>")
     .description("Archived chats that still carry unread messages or where the customer wrote last")
     .option("--json", "raw JSON")
@@ -851,7 +938,8 @@ export function run(argv) {
     .description("Send one message, print the reply + any tool calls")
     .option("--agent <id>", "test a specific (non-active) agent")
     .option("--clear", "clear the conversation before the run")
-    .option("--sender <name>", "senderName in the payload (default the test contact's name)")
+    .option("--tools", "also print each tool's arguments and result (what the agent asked and got back)")
+    .option("--sender <name>", "the name the agent sees: renames a SYNTHETIC test contact (a real person's contact keeps their name)")
     .option("--image <url>", "attach a publicly-fetchable image URL (text is the caption)")
     .option("--timeout <ms>", "per-turn HTTP timeout (default 120000)")
     .option("--json", "print raw JSON instead of the transcript")
@@ -860,6 +948,7 @@ export function run(argv) {
   test.command("scenario <organization_id> <file>")
     .description("Run a scenario pack (JSON: {scenarios:[{id,title,turns:[{text,expect?,expectNot?}]}]})")
     .option("--agent <id>", "test a specific agent")
+    .option("--tools", "also print each tool's arguments and result")
     .option("--no-clear-between", "do NOT clear between scenarios (one long thread)")
     .option("--force", "go ahead even though the test contact had real (non-web) messages in the last 6 h")
     .option("--sender <name>", "senderName")
@@ -875,6 +964,24 @@ export function run(argv) {
     .option("--timeout <ms>", "per-turn HTTP timeout")
     .option("--json", "print raw JSON results")
     .action((orgId, opts) => testCmd.qa(orgId, opts));
+  test.command("seed <organization_id>")
+    .description("Copy a real chat onto a NEW test contact (test_seed_*, tag test-contact, no broadcasts, AI off) to reproduce an agent or Coworker answer. Dry run unless --commit")
+    .requiredOption("--from <contact_id>", "the real contact whose thread is copied")
+    .option("--until <time>", "copy rows up to this SAST time, e.g. \"2026-10-01 09:08\" or an ISO time")
+    .option("--rows <n>", "newest rows to copy (default 60, max 500)")
+    .option("--name <name>", "the seeded contact's display name (default: \"<name> (seeded test)\")")
+    .option("--with-tools", "also copy tool-call rows")
+    .option("--copy-attributes", "copy the contact's attributes (dog name, weight, …)")
+    .option("--ai-on", "leave the agent ON for the seeded contact (default off)")
+    .option("--agent <id>", "scope to a specific agent (audit only)")
+    .option("--commit", "create it")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => testCmd.seed(orgId, opts));
+  test.command("unseed <organization_id> <contact_id>")
+    .description("DELETE a seeded test contact (test_seed_* only) and its copied rows")
+    .option("--confirm", "actually delete")
+    .option("--json", "raw JSON")
+    .action((orgId, contactId, opts) => testCmd.unseed(orgId, contactId, opts));
   test.command("clear <organization_id>")
     .description("Clear the test conversation (hide history via memory_cutoff)")
     .option("--agent <id>", "target a specific agent's test contact")
@@ -1006,6 +1113,7 @@ export function run(argv) {
     .option("--all", "include fired / cancelled / failed rows too")
     .option("--status <s>", "filter to one status (pending|request|completed|cancelled|failed)")
     .option("--limit <n>", "max rows (default 25, max 200)")
+    .option("--detail", "also print each row's body / button values and header media (what the queued send will say)")
     .option("--json", "raw JSON")
     .action((orgId, opts) => broadcastCmd.scheduledList(orgId, opts));
   scheduled.command("approve <organization_id> <queue_id>")
@@ -1118,15 +1226,25 @@ export function run(argv) {
     .option("--raw-campaign", "use --campaign exactly as typed, bypassing the Date_Campaign normalisation")
     .option("--new-campaign", "confirm the tag is a NEW campaign even though a differently spelled one with the same name already runs")
     .option("--domain <host>", "short domain: chatcart.io (default) | linklnk.io | yapi.store")
+    .option("--slug <slug>", "readable code for ONE url (3-48 chars a-z 0-9 -); a taken slug falls back to a generated code and says so")
     .option("--commit", "actually mint the links (omit = dry-run preview)")
     .option("--json", "raw JSON output")
     .action((orgId, opts) => linksCmd.shorten(orgId, opts));
   links.command("list <organization_id>")
-    .description("List the org's short links, newest first")
+    .description("List the org's short links, newest first; look one up by code or by destination")
     .option("--campaign <value>", "only links carrying this exact utm_campaign")
-    .option("--limit <n>", "max rows (default 25, max 200)")
+    .option("--code <code>", "one link by its code (the part after the slash)")
+    .option("--to <substr>", "only links whose destination contains this text")
+    .option("--limit <n>", "max rows (default 25, max 500)")
+    .option("--all", "walk every page (500 a call) instead of the first")
     .option("--json", "raw JSON output")
     .action((orgId, opts) => linksCmd.list(orgId, opts));
+  links.command("repoint <organization_id> <code>")
+    .description("Move where a live short code sends people (the code, its clicks and every message carrying it stay). Dry-run unless --commit")
+    .requiredOption("--to <url>", "the new destination page")
+    .option("--commit", "write the change (audited with the old destination; undo is printed)")
+    .option("--json", "raw JSON output")
+    .action((orgId, code, opts) => linksCmd.repoint(orgId, code, opts));
 
   // tag (the Advanced Tagging dialog in the terminal — ONE named tag on a matched set; dry-run default)
   const tag = program.command("tag")
@@ -1136,11 +1254,28 @@ export function run(argv) {
     .option("--field <name>", "field to search", "order_history")
     .option("--any <csv>", "match ANY of these comma-separated keywords (OR)")
     .option("--all <csv>", "match ALL of these comma-separated keywords (AND)")
+    .option("--exact", "match the WHOLE value (whatsapp_id / phone_number / email / full_name), not a substring")
     .option("--case-sensitive", "case-sensitive match")
     .option("--tag <name>", "tag to apply (required with --commit)")
     .option("--commit", "write the tag (omit = dry-run count + sample)")
     .option("--yes", "skip the type-the-tag confirm on large (>2000) writes")
     .action((orgId, opts) => tagCmd.field(orgId, opts));
+  tag.command("ids <organization_id>")
+    .description("Apply one tag to an explicit list of contact ids (append-only, idempotent; ids outside the org are ignored)")
+    .option("--ids <csv>", "contact UUIDs, comma-separated")
+    .option("--ids-file <path>", "file of contact UUIDs (one per line or comma-separated)")
+    .option("--tag <name>", "tag to apply (required with --commit)")
+    .option("--commit", "write the tag (omit = dry-run count + sample)")
+    .option("--yes", "skip the type-the-tag confirm on large (>2000) writes")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => tagCmd.ids(orgId, opts));
+  tag.command("holders <organization_id> <tag>")
+    .description("Who carries a tag: name, number, id and the flags that keep them off a broadcast (read-only)")
+    .option("--limit <n>", "rows (default 200, max 1000)")
+    .option("--all", "walk every page")
+    .option("--csv", "CSV to stdout (id, name, number, email, allow_broadcast, archived, blocked)")
+    .option("--json", "raw JSON")
+    .action((orgId, tagName, opts) => tagCmd.holders(orgId, tagName, opts));
   tag.command("cohort <organization_id>")
     .description("Tag a ranked cohort (top-N). --type top_spenders|frequent_buyers|recent_buyers|high_value_low_frequency")
     .option("--type <t>", "cohort type", "top_spenders")
@@ -1194,10 +1329,96 @@ export function run(argv) {
     .option("--json", "raw JSON")
     .action((orgId, opts) => tagCmd.list(orgId, opts));
   tag.command("remove <organization_id> <tags>")
-    .description("Remove tag(s) (comma-separated) from ALL contacts in the org. Destructive — needs --confirm")
+    .description("Remove tag(s) (comma-separated) from ALL contacts in the org, or only from --contacts. Destructive — needs --confirm")
+    .option("--contacts <csv>", "only these contact UUIDs lose the tag(s)")
+    .option("--contacts-file <path>", "file of contact UUIDs that lose the tag(s)")
     .option("--confirm", "actually remove (omit = dry-run)")
     .action((orgId, tags, opts) => tagCmd.remove(orgId, tags, opts));
 
+  // members / users (organization_members + profiles + auth.users)
+  const members = program.command("members").description("An org's people: list, add an existing account, change a role, rename, remove");
+  members.command("list <organization_id>")
+    .description("Members with role, name, email, last sign-in; pending invitations")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => membersCmd.list(orgId, opts));
+  members.command("invite <organization_id> <email>")
+    .description("Invite someone who has NO account yet (an invitations row they accept at sign-up; FlowIQ sends no email)")
+    .option("--role <role>", "admin | member | viewer", "member")
+    .option("--dry-run", "show what would be written")
+    .option("--json", "raw JSON")
+    .action((orgId, email, opts) => membersCmd.invite(orgId, email, opts));
+  members.command("add <organization_id> <email>")
+    .description("Add an EXISTING account to the org (someone with no account must be invited from the app)")
+    .option("--role <role>", "admin | member | viewer", "member")
+    .option("--json", "raw JSON")
+    .action((orgId, email, opts) => membersCmd.add(orgId, email, opts));
+  members.command("role <organization_id> <email> <role>")
+    .description("Change a member's role: admin | member | viewer (the last admin cannot be demoted)")
+    .option("--json", "raw JSON")
+    .action((orgId, email, role, opts) => membersCmd.role(orgId, email, role, opts));
+  members.command("rename <email> <full_name>")
+    .description("Set the person's display name (profiles.full_name, shown in every org)")
+    .option("--json", "raw JSON")
+    .action((email, name, opts) => membersCmd.rename(email, name, opts));
+  members.command("remove <organization_id> <email>")
+    .description("Remove a member from the org (dry-run unless --confirm; the owner and the last admin are refused)")
+    .option("--confirm", "actually remove")
+    .option("--json", "raw JSON")
+    .action((orgId, email, opts) => membersCmd.remove(orgId, email, opts));
+  const users = program.command("users").description("One user across orgs");
+  users.command("lookup <email>")
+    .description("The account behind an email: sign-in method, confirmation, last sign-in, every org and role")
+    .option("--json", "raw JSON")
+    .action((email, opts) => membersCmd.lookup(email, opts));
+
+  // steer / notes (internal rows in a contact's chat)
+  const steer = program.command("steer").description("Supervisor steers for the agent on one contact: list, add, clear");
+  steer.command("list <contact_id>")
+    .description("Every steer on the contact (mode, consumed, active)")
+    .option("--limit <n>", "rows (default 50)")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => notesCmd.steerList(contactId, opts));
+  steer.command("add <contact_id> <text...>")
+    .description("Add a steer the agent applies on EVERY reply (ongoing), or --once for the next reply only")
+    .option("--once", "next reply only")
+    .option("--json", "raw JSON")
+    .action((contactId, text, opts) => notesCmd.steerAdd(contactId, text, opts));
+  steer.command("clear <contact_id>")
+    .description("Delete the contact's steers (all, or --id); the inbox has no delete for an ongoing steer. Dry-run unless --confirm")
+    .option("--id <steer_id>", "only this steer (repeatable)", (v, acc) => (acc || []).concat([v]), [])
+    .option("--confirm", "actually delete")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => notesCmd.steerClear(contactId, opts));
+  const notes = program.command("notes").description("Internal notes on a contact (the Customer panel's sticky notes)");
+  notes.command("list <contact_id>")
+    .description("Every internal note on the contact")
+    .option("--limit <n>", "rows (default 50)")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => notesCmd.notesList(contactId, opts));
+  notes.command("add <contact_id> <text...>")
+    .description("Add an internal note (team-only, never sent to the customer)")
+    .option("--json", "raw JSON")
+    .action((contactId, text, opts) => notesCmd.notesAdd(contactId, text, opts));
+
+  // products (the synced catalogue)
+  const products = program.command("products").description("The synced catalogue as the agent sees it: status, a search replay, a one-org reconcile");
+  products.command("status <organization_id>")
+    .description("Row counts by status, embeddings (missing = the agent cannot find them), images, prices, stock, the last syncs")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => productsCmd.status(orgId, opts));
+  products.command("search <organization_id> <text...>")
+    .description("Replay the agent's product_lookup match (fuzzy_match_products) for a phrase")
+    .option("--limit <n>", "matches (default 8, max 50)")
+    .option("--min-similarity <x>", "pg_trgm threshold (default 0.15)")
+    .option("--json", "raw JSON")
+    .action((orgId, text, opts) => productsCmd.search(orgId, text, opts));
+  products.command("reconcile <organization_id>")
+    .description("Trigger products-reconcile-scheduler for this org only (re-sync + re-embed). Dry-run unless --confirm")
+    .option("--platform <p>", "shopify | woo (default: the org's connected store)")
+    .option("--confirm", "actually trigger")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => productsCmd.reconcile(orgId, opts));
+
   // keywords (org auto-reply engine: keywords + keyword_actions; id-keyed diff push)
   const keywords = program.command("keywords")
     .alias("kw")
@@ -1222,6 +1443,7 @@ export function run(argv) {
   shopify.command("get <organization_id> <path>")
     .description('GET any Shopify Admin REST endpoint, e.g. `get <org> orders.json --q status=any` (".json" optional)')
     .option("--q <k=v>", "query parameter (repeatable), e.g. --q status=any --q limit=250", storeApiCmd.collectQuery, {})
+    .option("--fields <csv>", "return only these fields per record (Shopify REST `fields`); the way past the 3.5 MB cap on big lists")
     .option("--all", "follow Link rel=next and return every page (bounded by --max-pages and a size/time cap)")
     .option("--max-pages <n>", "page limit when using --all (default 10, cap 50)")
     .option("--api-version <ver>", "Shopify Admin API version (default 2024-01)")
@@ -1257,6 +1479,7 @@ export function run(argv) {
   woo.command("get <organization_id> <path>")
     .description("GET any WooCommerce REST endpoint, e.g. `get <org> orders --q status=completed`")
     .option("--q <k=v>", "query parameter (repeatable), e.g. --q status=completed --q per_page=100", storeApiCmd.collectQuery, {})
+    .option("--fields <csv>", "return only these fields per record (Woo `_fields`), e.g. id,name,permalink,status; the way past the 3.5 MB cap on a big catalogue")
     .option("--namespace <ns>", "REST namespace (default wc/v3; also wc-analytics, wp/v2)")
     .option("--all", "page through every result (bounded by --max-pages and a size/time cap)")
     .option("--max-pages <n>", "page limit when using --all (default 10, cap 50)")