@flowapt/flowiq-cli 0.9.2 → 0.9.3

package/README.md

@@ -1768,18 +1768,30 @@ number already maps to an existing contact, the command prints a `⚠` warning
 naming it. Pass `--test-contact-number ""` (empty) to clear the override — the
 harness then falls back to a synthetic per-agent `test_<agent_id>` contact.
 
-### Agent updates — `flowiq agent-updates pull|list|resolve` (alias `au`)
+### Agent updates — `flowiq agent-updates all|pull|list|resolve` (alias `au`)
 
-Pull an org's client-raised "change the agent" requests (`agent_updates`),
-each with the chat context around the triggering message + the linked contact
-(attachments downloaded locally) — then, once the fix is verified, resolve the
-ticket from the same terminal.
+Client-raised "change the agent" requests (`agent_updates`). **`all`** is the
+cross-org queue: every org in ONE call (about a second), grouped by org, no
+UUID needed. **`pull`** is the deep read for one org: each update with the chat
+context around the triggering message + the linked contact (attachments
+downloaded locally). Once a fix is verified, resolve the ticket from the same
+terminal.
 
 ```bash
+# every org at once (v0.9.3)
+flowiq au all                                          # open = pending + in_progress, grouped by org
+flowiq au all --status all --since 14d                 # everything raised in the last 14 days
+flowiq au all --priority urgent,high --summary         # just the per-org counts
+flowiq au all --search wallet --status all             # title OR description contains "wallet"
+flowiq au all --org <uuid>,<uuid> --context            # a few orgs, with the chat window around each trigger
+flowiq au all --json | jq '.updates[] | {org: .organization_name, title}'
+# → ./.flowiq/agent-updates/_all.<status>.json  (aliases: `au queue`, `au list-remote`)
+
+# one org in depth
 flowiq au pull <organization_id>                       # pending, with context
 flowiq au pull <organization_id> --status all --titles "EFT, bank"
 flowiq au pull <organization_id> --before 20 --after 10 --no-files
-# → ./.flowiq/agent-updates/<slug>.json + files/<update-id>/<attachment>
+# → ./.flowiq/agent-updates/<slug>.json (pending) or <slug>.<status>.json + files/<update-id>/<attachment>
 
 flowiq au resolve <update_id> --note "We updated the agent so it no longer …"
 flowiq au resolve <update_id> --status declined --internal "duplicate of …"
@@ -1791,6 +1803,20 @@ flowiq au resolve <update_id> --status declined --internal "duplicate of …"
   the LAST step, after a live test proves the fix. Don't resolve on hope.
 - An interactive confirm shows exactly what the client will read; `--yes`
   skips the confirm (but never the `--note` requirement).
+- `all` flags: `--status` (`open` default, or any of `pending,in_progress,
+  resolved,declined`, or `all`), `--since` / `--until` (`14d`, `12h`, `2w` or
+  `YYYY-MM-DD`, SAST day start), `--priority`, `--org` (repeatable),
+  `--titles`, `--search`, `--limit` (default 1000, max 5000; a ⚠ TRUNCATED
+  line says when more matched), `--context` (+ `--before/--after/--recent`),
+  `--files`, `--summary`, `--no-desc`, `--out`, `--json`. No context window and
+  no attachment download unless asked, which is what keeps it fast.
+- Every update (in `all` and `pull`) names the **agent that answers that
+  conversation**: the contact's binding, else the agent on the update, else the
+  org's active agent, with a ⚠ when it is not the active one, so a fix goes to
+  the right agent.
+- `pull` builds the context windows in parallel (v0.9.3), so `--status all` no
+  longer times out on orgs with long ticket histories, and `--no-files` really
+  skips downloads.
 
 ### Broadcast planning — `flowiq plans list|show|status` (alias `planning`) (v0.7.3)
 

package/TEAM-GUIDE.md

@@ -201,7 +201,8 @@ several.
 | Manage Shopify/Woo platform webhooks | `flowiq wh pull <org_id>` → edit → `flowiq wh push <slug>` |
 | Manage outbound messaging webhooks (incl. their auth) | `flowiq mw pull <org_id>` → `flowiq mw push <slug> --dry-run` → push |
 | Create a brand-new client org | `flowiq org create --name "Client Name"` → then `agent create` on the printed id |
-| See a client's pending change requests | `flowiq au pull <org_id>` |
+| See EVERY client's open change requests at once | `flowiq au all` (grouped by org; `--since 14d`, `--priority urgent,high`, `--search <text>`, `--status all`, `--summary`, `--json`) |
+| See one client's pending change requests, with the chat around each | `flowiq au pull <org_id>` |
 | Close a client's change request (after verifying the fix!) | `flowiq au resolve <update_id> --note "what changed"` — the client reads the note |
 | Check an org's platform + active agent | `flowiq org info <org_id>` |
 | **See every Settings → Profile switch on an org** | `flowiq org flags show <org_id>` (credentials are never shown) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Command-line tool for FlowIQ staff: round-trip agent prompts, questionnaires, fine-tuning, pin-board tasks, webhooks, templates, agent-updates, chat exports, and live agent testing without ever touching service-role credentials.",
   "type": "module",
   "bin": {

package/src/commands/agent-updates.js

@@ -1,6 +1,7 @@
-// `flowiq agent-updates pull <org_id> [flags]` / `list`.
+// `flowiq agent-updates pull <org_id> [flags]` / `all` / `list` / `resolve`.
 // Read-only: fetches an org's agent_updates + chat context via /cli/agent-updates,
 // then downloads any attachments client-side into ./.flowiq/agent-updates/files/.
+// `all` (v0.9.3) is the cross-org queue: one server query over every org.
 
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -81,7 +82,9 @@ export async function pull(orgId, opts = {}) {
     process.exit(1);
   }
 
-  const downloadFiles = !opts.noFiles;
+  // Commander turns --no-files into `files: false` (the old `noFiles` read was
+  // never set, so attachments downloaded regardless — gap row 14 Sep 2026).
+  const downloadFiles = opts.files !== false && !opts.noFiles;
   const maxMb = opts.maxMb != null ? Number.parseFloat(opts.maxMb) : DEFAULT_MAX_MB;
   if (!Number.isFinite(maxMb) || maxMb <= 0) {
     console.error(`Invalid --max-mb: ${opts.maxMb}`);
@@ -116,7 +119,10 @@ export async function pull(orgId, opts = {}) {
 
   await fs.mkdir(AU_DIR, { recursive: true });
   const slug = slugify(resp.organization_name, resp.organization_id);
-  const filePath = path.join(AU_DIR, `${slug}.json`);
+  // A non-default status gets its own file, so pulling in_progress no longer
+  // overwrites the pending snapshot (gap rows 18 + 21 Sep 2026).
+  const statusKey = String(resp.status_filter || "pending");
+  const filePath = path.join(AU_DIR, statusKey === "pending" ? `${slug}.json` : `${slug}.${slugify(statusKey, "status")}.json`);
   const overwriting = await fileExists(filePath);
   await fs.writeFile(filePath, JSON.stringify(resp, null, 2) + "\n", "utf8");
 
@@ -138,6 +144,7 @@ export async function pull(orgId, opts = {}) {
     console.log(`      priority=${u.priority}  status=${u.status}  raised=${date}${u.created_by_name ? ` by ${u.created_by_name}` : ""}`);
     console.log(`      desc: ${oneLine(u.description, 140)}`);
     if (u.contact) console.log(`      contact: ${u.contact.full_name ?? "(no name)"} (${u.contact.whatsapp_id ?? u.contact.id})`);
+    if (u.agent) console.log(`      agent:   ${agentLine(u.agent)}`);
     if (u.attachments && u.attachments.length) {
       console.log(`      attachments: ${u.attachments.length} (${u.attachments.map((a) => a.filename || a.type || "file").join(", ")})`);
       for (const a of u.attachments) {
@@ -158,6 +165,112 @@ export async function pull(orgId, opts = {}) {
   console.log(`${path.join(AU_DIR, FILES_DIRNAME)}/<update-id>/ — Read those files for visual context, then act.`);
 }
 
+function agentLine(a) {
+  const src = { update: "set on the update", contact_binding: "contact is bound to it", org_active: "org's active agent" }[a.source] || a.source;
+  const warn = a.is_active ? "" : `  ⚠ NOT the active agent (${a.active_agent_name ?? a.active_agent_id ?? "none"}) — fix THIS agent`;
+  return `${a.name ?? a.id} (${src})${warn}`;
+}
+
+function sastStamp(iso) {
+  if (!iso) return "?";
+  const d = new Date(new Date(iso).getTime() + 2 * 3600e3);
+  return d.toISOString().slice(0, 16).replace("T", " ");
+}
+
+const PRIORITY_MARK = { urgent: "‼", high: "!", medium: "·", low: " " };
+
+// --- all (cross-org queue) --------------------------------------------------
+// One server query across every org: no per-org UUIDs, no context window and
+// no attachment downloads unless asked, so the whole open queue is one call.
+export async function all(opts = {}) {
+  const query = { scope: "all", status: opts.status || "open" };
+  if (opts.since) query.since = opts.since;
+  if (opts.until) query.until = opts.until;
+  if (opts.priority) query.priority = opts.priority;
+  if (opts.org && opts.org.length) query.org = [].concat(opts.org).join(",");
+  if (opts.titles) query.titles = opts.titles;
+  if (opts.search) query.search = opts.search;
+  if (opts.limit) query.limit = String(opts.limit);
+  if (opts.context) {
+    query.context = "1";
+    if (opts.before != null) query.before = String(opts.before);
+    if (opts.after != null) query.after = String(opts.after);
+    if (opts.recent != null) query.recent = String(opts.recent);
+  }
+
+  let resp;
+  try {
+    resp = await http.get("agent-updates", query);
+  } catch (e) {
+    console.error(`Pull failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  if (opts.files) {
+    const maxMb = opts.maxMb != null ? Number.parseFloat(opts.maxMb) : DEFAULT_MAX_MB;
+    const maxBytes = Math.round(maxMb * 1024 * 1024);
+    for (const u of resp.updates || []) {
+      if (!(u.attachments || []).length && !u.superadmin_response_image) continue;
+      try { await downloadUpdateFiles(u, maxBytes); } catch (e) { u._file_download_error = e.message; }
+    }
+  }
+
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(resp, null, 2) + "\n");
+    return;
+  }
+
+  await fs.mkdir(AU_DIR, { recursive: true });
+  const statusKey = Array.isArray(resp.filters?.status) ? resp.filters.status.join("-") : String(resp.filters?.status ?? "all");
+  const filePath = opts.out ? path.resolve(opts.out) : path.join(AU_DIR, `_all.${slugify(statusKey, "all")}.json`);
+  await fs.writeFile(filePath, JSON.stringify(resp, null, 2) + "\n", "utf8");
+
+  const updates = resp.updates || [];
+  const f = resp.filters || {};
+  console.log(`Wrote ${filePath}  (${resp.elapsed_ms ?? "?"} ms server)`);
+  console.log(`  status:   ${Array.isArray(f.status) ? f.status.join(", ") : f.status}` +
+    `${f.since ? `  · since ${sastStamp(f.since)} SAST` : ""}${f.until ? `  · until ${sastStamp(f.until)}` : ""}` +
+    `${f.priority ? `  · priority ${f.priority.join(",")}` : ""}${f.search ? `  · search "${f.search}"` : ""}` +
+    `${f.titles ? `  · titles ${f.titles.join("|")}` : ""}${f.org ? `  · ${f.org.length} org(s)` : ""}`);
+  console.log(`  updates:  ${resp.returned} across ${(resp.by_org || []).length} org(s)` +
+    (resp.truncated ? `  ⚠ TRUNCATED: ${resp.total_matched} matched, raise --limit` : ""));
+  if (!updates.length) { console.log("  (nothing matches)"); return; }
+
+  console.log("");
+  console.log("  By org (count · pending · in progress · urgent/high · oldest):");
+  for (const b of resp.by_org || []) {
+    const age = Math.floor((Date.now() - new Date(b.oldest_created_at).getTime()) / 86400e3);
+    console.log(`    ${String(b.count).padStart(4)}  ${String(b.pending).padStart(3)} ${String(b.in_progress).padStart(3)} ${String(b.urgent_or_high).padStart(3)}  ${String(age + "d").padStart(5)}  ${b.organization_name ?? b.organization_id}`);
+  }
+  if (opts.summary) return;
+
+  const byOrg = new Map();
+  for (const u of updates) {
+    if (!byOrg.has(u.organization_id)) byOrg.set(u.organization_id, []);
+    byOrg.get(u.organization_id).push(u);
+  }
+  for (const b of resp.by_org || []) {
+    const list = byOrg.get(b.organization_id) || [];
+    console.log("");
+    console.log(`  ── ${b.organization_name ?? b.organization_id}  (${b.organization_id})`);
+    for (const u of list) {
+      const mark = PRIORITY_MARK[u.priority] ?? "?";
+      const st = u.status === "pending" ? "" : ` [${u.status}]`;
+      console.log(`   ${mark} ${u.id.slice(0, 8)}  ${String(u.age_days + "d").padStart(4)}  ${oneLine(u.title, 70)}${st}`);
+      const bits = [];
+      if (u.created_by_name) bits.push(`by ${u.created_by_name}`);
+      if (u.contact) bits.push(`contact ${u.contact.full_name ?? u.contact.whatsapp_id ?? u.contact.id}`);
+      if ((u.attachments || []).length) bits.push(`${u.attachments.length} attachment(s)`);
+      if (u.agent && !u.agent.is_active) bits.push(`⚠ agent ${u.agent.name ?? u.agent.id} is NOT active`);
+      if (bits.length) console.log(`               ${bits.join(" · ")}`);
+      if (opts.desc !== false && u.description) console.log(`               ${oneLine(u.description, 150)}`);
+    }
+  }
+  console.log("");
+  console.log("Full text, contacts, agents" + (opts.context ? ", chat context" : "") + " are in the JSON. Drill into one org with");
+  console.log("`flowiq au pull <org_id>` (chat context + attachments), then `flowiq au resolve <id> --note …`.");
+}
+
 export async function list() {
   let files;
   try {

package/src/index.js

@@ -506,7 +506,7 @@ export function run(argv) {
   // agent-updates (pending client change-requests + chat context; pull + resolve)
   const au = program.command("agent-updates")
     .alias("au")
-    .description("Pull pending agent_updates + the chat context around each; resolve a ticket with a client-facing note");
+    .description("Agent updates: `all` = every org's queue in one call; `pull` = one org with chat context + attachments; `resolve` with a client-facing note");
   au.command("pull <organization_id>")
     .description("Fetch updates + linked contact + trigger-message window; downloads attachments locally")
     .option("--status <status>", "pending (default) | resolved | in_progress | all")
@@ -517,6 +517,29 @@ export function run(argv) {
     .option("--no-files", "do NOT download attachments (default: download is ON)")
     .option("--max-mb <n>", "skip attachments larger than N MB (default 25)")
     .action((orgId, opts) => agentUpdatesCmd.pull(orgId, opts));
+  au.command("all")
+    .alias("queue")
+    .alias("list-remote")
+    .description("EVERY org's agent updates in one call (default: open = pending + in_progress), grouped by org; → ./.flowiq/agent-updates/_all.<status>.json")
+    .option("--status <list>", "open (default) | pending | in_progress | resolved | declined | all — comma-separated allowed")
+    .option("--since <when>", "raised on/after: 14d, 12h, 2w or YYYY-MM-DD (SAST day start)")
+    .option("--until <when>", "raised on/before (same formats)")
+    .option("--priority <list>", "urgent,high,medium,low (comma-separated)")
+    .option("--org <uuid>", "limit to these org(s) (repeatable or comma-separated)", (v, prev) => prev.concat(v.split(",")), [])
+    .option("--titles <list>", "title contains any of these (comma-separated, ci substring)")
+    .option("--search <text>", "title OR description contains this text (ci)")
+    .option("--limit <n>", "max updates returned (default 1000, max 5000)")
+    .option("--context", "also fetch the chat window around each trigger message (slower)")
+    .option("--before <n>", "with --context: messages before the trigger (default 6)")
+    .option("--after <n>", "with --context: messages after the trigger (default 4)")
+    .option("--recent <n>", "with --context: fallback window when no trigger message (default 10)")
+    .option("--files", "download attachments too (off by default across orgs)")
+    .option("--max-mb <n>", "with --files: skip attachments larger than N MB (default 25)")
+    .option("--summary", "print only the per-org counts")
+    .option("--no-desc", "hide the one-line description under each update")
+    .option("--out <path>", "write the JSON here instead of ./.flowiq/agent-updates/_all.<status>.json")
+    .option("--json", "print the JSON to stdout (no file, no table) — pipe into jq")
+    .action((opts) => agentUpdatesCmd.all(opts));
   au.command("list")
     .description("List local agent-updates snapshots")
     .action(() => agentUpdatesCmd.list());