@flowapt/flowiq-cli 0.12.2 → 0.12.3

package/README.md

@@ -1309,6 +1309,7 @@ flowiq report deck generate <org_id> 2026-08 --refresh --force   # rebuild every
 flowiq report deck build <org_id> 2026-08 --refresh        # metrics only; status then says "Copy is older than the numbers" until you narrate
 flowiq report deck narrate <org_id> 2026-08                # copy only (hand edits are kept)
 flowiq report deck narrate <org_id> 2026-08 --only changes,action_points   # rewrite just these copy fields, keep the rest as written
+flowiq report deck check <org_id> 2026-08                  # fact-check the copy as shown (hand edits too) against the figures; rewrites nothing
 flowiq report deck inputs <org_id> 2026-08 --file inputs.json   # the super-admin input form
 flowiq report deck approve <org_id> 2026-08                # refused until every required input is present
 flowiq report deck send <org_id> 2026-08 --test-to me@flowapt.com   # one test copy, status untouched

package/TEAM-GUIDE.md

@@ -274,6 +274,7 @@ several.
 | Generate a client's monthly deck (metrics + copy) after the month has frozen | `flowiq report deck generate <org_id> 2026-08` — then review it at /reporting/deck |
 | See whether a client deck can be approved, and what is still missing | `flowiq report deck status <org_id> 2026-08` |
 | Rewrite one part of a deck's copy without touching the rest (e.g. the changes column and action points) | `flowiq report deck narrate <org_id> 2026-08 --only changes,suggested_updates,action_points` |
+| Check a deck's wording against its figures before it goes out (e.g. a heading that says a group "leads" when it does not) | `flowiq report deck check <org_id> 2026-08` — lists each unsupported statement with a fix; rewrites nothing |
 | Send yourself a test copy of a client deck (PDF from flowiq@flowapt.com) | `flowiq report deck send <org_id> 2026-08 --test-to you@flowapt.com` — status untouched |
 | Take a tile, pill or card off a client deck (and its PDF) for one month | On `/reporting/deck` open **Inputs** (the rail beside the slides) → Show or hide; or `flowiq report deck inputs <org_id> 2026-08 --file inputs.json` with `{ "hidden": { "tile:tail": true } }` |
 | Approve a client deck / send it to the client | `flowiq report deck approve <org_id> 2026-08` then `… send … --client` (or let the 09:00 SAST schedule send it on the 5th) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.12.2",
+  "version": "0.12.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/report.js

@@ -80,6 +80,21 @@ export async function narrate(orgId, month, opts) {
   reportCopy(r, month);
 }
 
+export async function check(orgId, month, opts) {
+  requireArgs(orgId, month);
+  const r = await post("check", orgId, month, {}, "Check");
+  if (opts.json) { console.log(JSON.stringify(r, null, 2)); return; }
+  printClaims(r.issues);
+  if (r.status) console.log(`  status: ${r.status}${r.missing?.length ? ` · needed: ${r.missing.join(" · ")}` : ""}`);
+}
+
+function printClaims(issues) {
+  if (!Array.isArray(issues)) return;
+  if (!issues.length) { console.log("  fact check: passed (every statement is supported by the figures)"); return; }
+  console.log(`  ⚠ fact check: ${issues.length} statement${issues.length === 1 ? "" : "s"} the figures do not support:`);
+  for (const i of issues) console.log(`    ${i.path}: "${i.quote}" (${i.why}) → ${i.fix}`);
+}
+
 export async function generate(orgId, month, opts) {
   requireArgs(orgId, month);
   const r = await post("generate", orgId, month, { refresh: !!opts.refresh, force: !!opts.force }, "Generate");
@@ -94,6 +109,7 @@ function reportCopy(r, month) {
     const n = Object.keys(r.guard.offenders || {}).length;
     console.log(`  ⚠ numeric guard: ${n} field${n === 1 ? "" : "s"} carry figures that are not in the data — flagged on the slides: ${Object.keys(r.guard.offenders).join(", ")}`);
   } else if (r.guard) console.log("  numeric guard: passed (every figure in the copy exists in the data)");
+  if (r.guard?.claim_check?.ran) printClaims(r.guard.claim_check.issues);
   if (Array.isArray(r.length_issues) && r.length_issues.length) console.log(`  trimmed to limit: ${r.length_issues.map((i) => `${i.path} (${i.length}→${i.limit})`).join(", ")}`);
 }
 

package/src/index.js

@@ -381,6 +381,10 @@ export function run(argv) {
     .option("--only <fields>", "rewrite only these copy fields, comma-separated (e.g. changes,suggested_updates,action_points); the rest stays as written")
     .option("--json", "raw JSON output")
     .action((orgId, month, opts) => reportCmd.narrate(orgId, month, opts));
+  deck.command("check <organization_id> <month>")
+    .description("Fact-check the copy as the slides show it (hand edits included) against the month's figures; rewrites nothing")
+    .option("--json", "raw JSON output")
+    .action((orgId, month, opts) => reportCmd.check(orgId, month, opts));
   deck.command("generate <organization_id> <month>")
     .description("Build the metrics (if missing, or --refresh) and write the copy")
     .option("--refresh", "rebuild the metrics first")