@flowapt/flowiq-cli 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Command-line tool for FlowIQ staff: round-trip agent prompts, questionnaires, webhooks, and more without ever touching service-role credentials.",
   "type": "module",
   "bin": {

package/src/commands/questionnaires.js

@@ -0,0 +1,128 @@
+// `flowiq questionnaires pull <organization_id>` /
+// `flowiq questionnaires push <slug>`.
+// Round-trips an org's active WhatsApp agent's `agents.questionnaire`
+// jsonb column through a local JSON file. No DB credentials on disk.
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const QS_DIR = path.resolve(process.cwd(), ".flowiq", "questionnaires");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+function slugify(name, fallback) {
+  const s = String(name || "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+  return s || fallback;
+}
+
+async function fileExists(p) {
+  try { await fs.access(p); return true; } catch { return false; }
+}
+
+async function resolvePushPath(identifier) {
+  const candidates = [];
+  if (path.isAbsolute(identifier)) {
+    candidates.push(identifier);
+  } else if (identifier.includes("/") || identifier.includes("\\")) {
+    candidates.push(path.resolve(identifier));
+  } else {
+    const base = identifier.endsWith(".json") ? identifier : `${identifier}.json`;
+    candidates.push(path.join(QS_DIR, base));
+    candidates.push(path.resolve(base));
+  }
+  for (const c of candidates) {
+    if (await fileExists(c)) return c;
+  }
+  throw new Error(`File not found. Tried:\n  ${candidates.join("\n  ")}`);
+}
+
+function countQuestions(sections) {
+  let total = 0, answered = 0;
+  if (!Array.isArray(sections)) return { total, answered };
+  for (const s of sections) {
+    if (!Array.isArray(s?.questions)) continue;
+    for (const q of s.questions) {
+      total += 1;
+      if ((q?.answer ?? "").trim().length > 0) answered += 1;
+    }
+  }
+  return { total, answered };
+}
+
+export async function pull(orgId) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("questionnaires", { organization_id: orgId });
+  } catch (e) {
+    console.error(`Pull failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  await fs.mkdir(QS_DIR, { recursive: true });
+  const slug = slugify(resp.organization_name, resp.organization_id);
+  const filePath = path.join(QS_DIR, `${slug}.json`);
+  const overwriting = await fileExists(filePath);
+  await fs.writeFile(filePath, JSON.stringify(resp, null, 2) + "\n", "utf8");
+
+  const { total, answered } = countQuestions(resp.questionnaire?.sections);
+  console.log(`${overwriting ? "Overwrote" : "Wrote"} ${filePath}`);
+  console.log(`  org:        ${resp.organization_name} (${resp.organization_id})`);
+  console.log(`  agent:      ${resp.agent_name} (${resp.agent_id})`);
+  console.log(`  sections:   ${resp.questionnaire?.sections?.length ?? 0}`);
+  console.log(`  questions:  ${answered}/${total} answered`);
+  if (resp.default_used) {
+    console.log(`  note:       DB had no questionnaire — seeded from DEFAULT_QUESTIONNAIRE.`);
+    console.log(`              Pushing the file unchanged will write the full default.`);
+  }
+}
+
+export async function push(identifier) {
+  let filePath;
+  try {
+    filePath = await resolvePushPath(identifier);
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+  const raw = await fs.readFile(filePath, "utf8");
+  let data;
+  try { data = JSON.parse(raw); }
+  catch (e) {
+    console.error(`Invalid JSON in ${filePath}: ${e.message}`);
+    process.exit(1);
+  }
+
+  if (!data.organization_id || !UUID_RE.test(data.organization_id)) {
+    console.error(`${filePath}: organization_id missing or invalid`);
+    process.exit(1);
+  }
+  if (!data.questionnaire || !Array.isArray(data.questionnaire.sections)) {
+    console.error(`${filePath}: questionnaire.sections must be an array`);
+    process.exit(1);
+  }
+
+  let resp;
+  try {
+    resp = await http.post("questionnaires", {
+      organization_id: data.organization_id,
+      questionnaire: data.questionnaire,
+    });
+  } catch (e) {
+    console.error(`Push failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  console.log(`Pushed ${filePath}`);
+  console.log(`  org:        ${resp.organization_name} (${resp.organization_id})`);
+  console.log(`  agent:      ${resp.agent_name} (${resp.agent_id})`);
+  console.log(`  sections:   ${resp.sections}`);
+  console.log(`  questions:  ${resp.answered_questions}/${resp.total_questions} answered`);
+}

package/src/index.js

@@ -4,6 +4,7 @@
 import { Command } from "commander";
 import * as authCmd from "./commands/auth.js";
 import * as promptsCmd from "./commands/prompts.js";
+import * as questionnairesCmd from "./commands/questionnaires.js";
 
 export function run(argv) {
   const program = new Command();
@@ -31,5 +32,16 @@ export function run(argv) {
     .description("Apply a local JSON file's prompt_sections to the agent (regenerates system_prompt server-side)")
     .action((id) => promptsCmd.push(id));
 
+  // questionnaires
+  const qs = program.command("questionnaires")
+    .alias("q")
+    .description("Round-trip an org's active WhatsApp agent's questionnaire answers (agents.questionnaire JSONB)");
+  qs.command("pull <organization_id>")
+    .description("Fetch the active agent's questionnaire into a local JSON file (seeds from DEFAULT_QUESTIONNAIRE if the DB column is empty)")
+    .action((orgId) => questionnairesCmd.pull(orgId));
+  qs.command("push <slug-or-path>")
+    .description("Apply a local JSON file's questionnaire to the agent")
+    .action((id) => questionnairesCmd.push(id));
+
   program.parseAsync(argv);
 }