@flowapt/flowiq-cli 0.8.1 → 0.9.2

package/src/index.js

@@ -11,6 +11,7 @@ import * as questionnairesCmd from "./commands/questionnaires.js";
 import * as messagesCmd from "./commands/messages.js";
 import * as fineTuningCmd from "./commands/fine-tuning.js";
 import * as messagingWebhooksCmd from "./commands/messaging-webhooks.js";
+import * as popupsCmd from "./commands/popups.js";
 import * as webhooksCmd from "./commands/webhooks.js";
 import * as flowmodCmd from "./commands/flowmod.js";
 import * as groupsCmd from "./commands/groups.js";
@@ -137,6 +138,62 @@ export function run(argv) {
     .option("--dry-run", "preview the diff without writing anything")
     .action((id, opts) => messagingWebhooksCmd.push(id, opts));
 
+  // popups — the popup service's /api/popup-settings is the ONE home for popup
+  // writes (editor + CLI). This CLI holds no popup logic: `schema` reads what a
+  // popup may contain from the server, so new popup features need no release.
+  const popups = program.command("popups")
+    .alias("pp")
+    .description("Popups: list / pull / push / create / duplicate / activate / live / delete / upload — one JSON document per popup, validated by the popup service");
+  popups.command("schema")
+    .description("What a popup document may contain TODAY (content, rules, design, webhooks) — served by the popup service, never stale")
+    .option("--json", "print the full schema as JSON (enums + limits included)")
+    .action((opts) => popupsCmd.schema(opts));
+  popups.command("list <organization_id>")
+    .description("Every popup of an org: id, state, views, signups, and what a signup triggers")
+    .option("--json", "print as JSON")
+    .action((orgId, opts) => popupsCmd.list(orgId, opts));
+  popups.command("pull <organization_id> [popup_id]")
+    .description("Write a popup's full document (popup + webhooks + etag) to ./.flowiq/popups/<org>/; no popup_id = every popup")
+    .action((orgId, popupId) => popupsCmd.pull(orgId, popupId));
+  popups.command("push <file>")
+    .description("Apply a pulled document back: id-keyed webhook upsert, integration configs MERGED, refused if someone else edited it since the pull")
+    .option("--dry-run", "show what would change without writing")
+    .option("--replace-webhooks", "webhooks not in the file are REMOVED (needs --confirm-delete-webhooks)")
+    .option("--confirm-delete-webhooks", "allow the push to remove webhooks")
+    .option("--force", "overwrite even if the popup changed since the pull")
+    .action((file, opts) => popupsCmd.push(file, opts));
+  popups.command("create <organization_id> <file>")
+    .description("Create a popup from a JSON document (a pulled file from ANY org works — ids are stripped); created INACTIVE")
+    .option("--dry-run", "validate only")
+    .action((orgId, file, opts) => popupsCmd.create(orgId, file, opts));
+  popups.command("duplicate <organization_id> <popup_id>")
+    .description("Copy a popup (design, content, behaviour AND webhooks) — inactive, no link, zero stats")
+    .option("--name <name>", "name for the copy (default: \"<name> (copy)\")")
+    .option("--from-org <organization_id>", "copy a popup that lives in ANOTHER org (webhooks are not copied across orgs)")
+    .option("--no-webhooks", "do not copy the webhooks")
+    .action((orgId, popupId, opts) => popupsCmd.duplicate(orgId, popupId, opts));
+  popups.command("activate <organization_id> <popup_id>")
+    .description("Switch a popup ON (is_active) — the real on/off switch")
+    .action((orgId, popupId) => popupsCmd.activate(orgId, popupId));
+  popups.command("deactivate <organization_id> <popup_id>")
+    .description("Switch a popup OFF everywhere (store, pinned id and its link)")
+    .action((orgId, popupId) => popupsCmd.deactivate(orgId, popupId));
+  popups.command("live <organization_id> <popup_id>")
+    .description("Make this the popup the org's store embed shows (one per org; others are demoted)")
+    .option("--off", "unselect it (NOT a kill switch — use deactivate for that)")
+    .action((orgId, popupId, opts) => popupsCmd.live(orgId, popupId, opts));
+  popups.command("delete <organization_id> <popup_id>")
+    .description("Delete a popup and its signups; a live popup or one with signups needs --confirm")
+    .option("--confirm", "delete even if live or it has signups")
+    .action((orgId, popupId, opts) => popupsCmd.remove(orgId, popupId, opts));
+  popups.command("upload <organization_id> <popup_id> <file>")
+    .description("Upload an image (--slot) or a custom font (--font) for a popup and print the URL to put in its design")
+    .option("--slot <name>", "image slot: main, main-mobile, textimage, textimage-mobile, success-main, success-mobile, intro-logo, deck-<key>…")
+    .option("--font <family>", "font family name (uploads to the public popup_fonts bucket)")
+    .option("--weight <n>", "font weight (default 400)")
+    .option("--italic", "italic face")
+    .action((orgId, popupId, file, opts) => popupsCmd.upload(orgId, popupId, file, opts));
+
   // webhooks (Shopify/WooCommerce platform webhooks; auto-detects platform + ip_whitelist proxy)
   const wh = program.command("webhooks")
     .alias("wh")
@@ -166,13 +223,15 @@ export function run(argv) {
   // groups (read-only: pull WhatsApp GROUP chat history from the FlowMod Evolution DB)
   const groups = program.command("groups")
     .alias("grp")
-    .description("Read WhatsApp group chat history from the FlowMod Evolution DB (set FLOWMOD_EVO_DB_URL env). Read-only.");
+    .description("DEPRECATED — Evolution is retired and frozen (nothing since 29 Aug 2026). Read group chats with the whatsapp-flowapt / whatsapp-flowmod MCP instead.");
   groups.command("list")
-    .description("List an Evolution instance's group chats with message counts + last activity")
+    .description("[archive only] List the frozen Evolution instance's group chats — needs --archive")
     .option("--instance <name>", "Evolution instance name", "flowapt")
+    .option("--archive", "read the FROZEN pre-29-Aug-2026 archive anyway")
     .action((opts) => groupsCmd.list(opts));
   groups.command("pull <name-or-jid>")
-    .description("Pull a group's messages in a time window into a local JSON file + print a timeline")
+    .description("[archive only] Pull a group's FROZEN message history into a local JSON file — needs --archive")
+    .option("--archive", "read the FROZEN pre-29-Aug-2026 archive anyway")
     .option("--instance <name>", "Evolution instance name", "flowapt")
     .option("--last <window>", "rolling window back from now, e.g. 48h, 7d, 2w, 90m", "48h")
     .option("--since <date>", "window start (SAST), YYYY-MM-DD or \"YYYY-MM-DD HH:MM\" (overrides --last)")
@@ -198,9 +257,9 @@ export function run(argv) {
     .description("List every task in the DB (optionally filter: open | in_progress | done) to find an id")
     .action((status) => pinboardCmd.listRemote(status));
 
-  // hours (client-hours ledger — every org's package = 10h Flowapt work/month)
+  // hours (client-hours ledger + each org's monthly hours package, v0.9.2)
   const hours = program.command("hours")
-    .description("Client-hours ledger: log + report Flowapt work against each org's 10h/month package");
+    .description("Client-hours ledger: log + report Flowapt work against each org's monthly hours package");
   hours.command("log <organization_id>")
     .description("Log work done for a client org (exactly one of --minutes / --hours)")
     .option("--minutes <n>", "duration in whole minutes")
@@ -216,10 +275,27 @@ export function run(argv) {
     .option("--json", "raw JSON output")
     .action((orgId, opts) => hoursCmd.list(orgId, opts));
   hours.command("summary")
-    .description("Cross-org month totals — every org with logged work, vs the 10h package")
+    .description("Cross-org month totals: every org with logged work or a package, vs its package")
     .option("--month <YYYY-MM>", "which month to report")
     .option("--json", "raw JSON output")
     .action((opts) => hoursCmd.summary(opts));
+  const hoursPkg = hours.command("package")
+    .description("Each org's monthly hours package (one org, or several sharing one). Changes: Matt + Gidon only");
+  hoursPkg.command("show [organization_id]")
+    .description("Every package, or the one an org is on")
+    .option("--json", "raw JSON output")
+    .action((orgId, opts) => hoursCmd.packageShow(orgId, opts));
+  hoursPkg.command("set <organization_ids...>")
+    .description("Put these orgs on ONE package of --hours a month (several orgs = a shared package)")
+    .requiredOption("--hours <h>", "hours included per month (0 = none included, e.g. a self-service plan)")
+    .option("--name <text>", "package name (default: the org's name, or the names joined)")
+    .option("--notes <text>", "where the figure comes from, e.g. \"Order Form 12 Aug 2026\"")
+    .option("--dry-run", "show what would change, write nothing")
+    .action((orgIds, opts) => hoursCmd.packageSet(orgIds, opts));
+  hoursPkg.command("clear <organization_id>")
+    .description("Take an org off its package (back to 'no package on file')")
+    .option("--dry-run", "show what would change, write nothing")
+    .action((orgId, opts) => hoursCmd.packageClear(orgId, opts));
 
   // report deck — the monthly client deck (build / copy / approve / send)
   const report = program.command("report").description("Client reporting: the monthly 10-slide client deck");
@@ -417,7 +493,7 @@ export function run(argv) {
     .option("--agent <id>", "target a specific agent instead of the org's active one")
     .option("--use-settings-prompt [bool]", "settings.use_settings_prompt (true if bare)")
     .option("--model <model>", "settings.model (e.g. gpt-5.4-mini)")
-    .option("--reasoning-effort <level>", "settings.reasoning_effort — low|medium|high (\"\" clears it); pairs with reasoning models (e.g. gpt-5.6-luna + high)")
+    .option("--reasoning-effort <level>", "settings.reasoning_effort — low|medium|high|xhigh|max (\"\" clears it; max = Claude only); pairs with reasoning models (e.g. gpt-5.6-luna + high, claude-sonnet-5 + medium)")
     .option("--rename <name>", "rename the agent")
     .option("--tool <flag=bool>", "toggle a tool flag (repeatable): woo_order_build/woo_tip_field/woo_order_note_field/view_cart_tool/restock_tool/block_tool_status/postal_code_tool_status/shopify_products_web_chat/ticket_tool_status/product_lookup/email_request_tool/collapse_product_variants", agentConfigCmd.collectTool, [])
     .option("--discount [bool]", "agent.discount.enabled (true if bare)")
@@ -460,7 +536,9 @@ export function run(argv) {
   plans.command("list [organization_id]")
     .description("List plans, default open (draft, pending_review, approved, scheduled), across all active orgs or one org")
     .option("--status <status>", "open (default) | all | pending_review | draft | approved | rejected | scheduled | sent | cancelled (comma-separated allowed)")
-    .option("--since <date>", "only plans scheduled on or after YYYY-MM-DD")
+    .option("--since <date>", "only plans whose SEND date is on or after YYYY-MM-DD")
+    .option("--created-since <date>", "only plans CREATED on or after YYYY-MM-DD (SAST) — what a client just submitted")
+    .option("--touched-since <date>", "only plans UPDATED on or after YYYY-MM-DD (SAST)")
     .option("--include-inactive", "include plans from inactive orgs (cross-org listing)")
     .option("--limit <n>", "max plans returned (default 100, max 500)")
     .option("--json", "print the raw response")
@@ -679,6 +757,18 @@ export function run(argv) {
     .option("--confirm", "actually cancel")
     .action((orgId, queueId, opts) => broadcastCmd.scheduledUpdate(orgId, queueId, "cancel", opts));
 
+  const drafts = broadcast.command("drafts")
+    .description("Saved SEND DRAFTS (the send dialog's stored configurations) — read-only");
+  drafts.command("list <organization_id>", { isDefault: true })
+    .description("List the org's saved send drafts, newest first")
+    .option("--limit <n>", "max rows (default 25, max 200)")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => broadcastCmd.draftsList(orgId, opts));
+  drafts.command("show <organization_id> <draft_id>")
+    .description("One saved send draft in full (the whole stored config)")
+    .option("--json", "raw JSON")
+    .action((orgId, draftId, opts) => broadcastCmd.draftsShow(orgId, draftId, opts));
+
   broadcast.command("list-remote <organization_id>")
     .description("List the org's broadcasts newest-first (full broadcastId + template + status + recipients) — the discovery step for `bc status` / `bc retry`")
     .option("--limit <n>", "how many to show (default 25, max 200)")