@rogeriq/cli 0.1.0

package/dist/index.mjs

@@ -0,0 +1,2326 @@
+#!/usr/bin/env node
+
+// src/lib/args.ts
+function parseArgs(argv, specs = []) {
+  const byLong = new Map(specs.map((s) => [s.name, s]));
+  const byShort = new Map(specs.filter((s) => s.alias).map((s) => [s.alias, s]));
+  const positional = [];
+  const flags = {};
+  let i = 0;
+  while (i < argv.length) {
+    const tok = argv[i];
+    if (tok === "--") {
+      positional.push(...argv.slice(i + 1));
+      break;
+    }
+    if (tok.startsWith("--")) {
+      const eq = tok.indexOf("=");
+      const name = eq >= 0 ? tok.slice(2, eq) : tok.slice(2);
+      const inline = eq >= 0 ? tok.slice(eq + 1) : void 0;
+      const spec = byLong.get(name);
+      i = applyFlag(flags, name, spec, inline, argv, i);
+      continue;
+    }
+    if (tok.startsWith("-") && tok.length > 1) {
+      const name = tok.slice(1);
+      const spec = byShort.get(name);
+      const longName = spec?.name ?? name;
+      i = applyFlag(flags, longName, spec, void 0, argv, i);
+      continue;
+    }
+    positional.push(tok);
+    i += 1;
+  }
+  return { positional, flags };
+}
+function applyFlag(flags, name, spec, inline, argv, i) {
+  const type = spec?.type ?? (inline !== void 0 ? "string" : "boolean");
+  if (type === "boolean") {
+    flags[name] = inline === void 0 ? true : inline !== "false";
+    return i + 1;
+  }
+  let value;
+  if (inline !== void 0) {
+    value = inline;
+    i += 1;
+  } else {
+    const next = argv[i + 1];
+    if (next === void 0 || next.startsWith("-")) {
+      throw new Error(`Flag --${name} requires a value`);
+    }
+    value = next;
+    i += 2;
+  }
+  if (type === "array") {
+    const existing = flags[name];
+    if (Array.isArray(existing)) existing.push(value);
+    else flags[name] = [value];
+  } else {
+    flags[name] = value;
+  }
+  return i;
+}
+function flagString(flags, name, fallback) {
+  const v = flags[name];
+  if (typeof v === "string") return v;
+  return fallback;
+}
+function flagBool(flags, name) {
+  return flags[name] === true;
+}
+
+// src/lib/errors.ts
+var CliError = class extends Error {
+  code;
+  exitCode;
+  requestId;
+  statusCode;
+  issues;
+  constructor(message, code = "CLI_ERROR", exitCode = 1) {
+    super(message);
+    this.code = code;
+    this.exitCode = exitCode;
+  }
+};
+
+// src/lib/output.ts
+var globalOpts = {};
+function setOutputOpts(opts) {
+  globalOpts = { ...opts };
+}
+function shouldJson() {
+  if (globalOpts.json) return true;
+  return !process.stdout.isTTY;
+}
+function emit(value, opts = {}) {
+  if (globalOpts.quiet) {
+    if (Array.isArray(value)) {
+      for (const row of value) printId(row, opts.idField);
+    } else {
+      printId(value, opts.idField);
+    }
+    return;
+  }
+  if (shouldJson()) {
+    process.stdout.write(JSON.stringify(value, null, 2) + "\n");
+    return;
+  }
+  if (Array.isArray(value)) {
+    printTable(value);
+  } else if (value && typeof value === "object") {
+    printRecord(value);
+  } else {
+    process.stdout.write(String(value) + "\n");
+  }
+}
+function printId(value, idField = "id") {
+  if (value && typeof value === "object" && idField in value) {
+    const id = value[idField];
+    if (id !== void 0 && id !== null) {
+      process.stdout.write(String(id) + "\n");
+    }
+  }
+}
+function printTable(rows) {
+  if (rows.length === 0) {
+    process.stderr.write("(no results)\n");
+    return;
+  }
+  const keys2 = preferredKeys(rows);
+  const widths = keys2.map(
+    (k) => Math.max(k.length, ...rows.map((r) => formatCell(r[k]).length))
+  );
+  const header = keys2.map((k, i) => k.padEnd(widths[i])).join("  ");
+  const sep = widths.map((w) => "\u2500".repeat(w)).join("  ");
+  process.stdout.write(header + "\n");
+  process.stdout.write(sep + "\n");
+  for (const row of rows) {
+    const line = keys2.map((k, i) => formatCell(row[k]).padEnd(widths[i])).join("  ");
+    process.stdout.write(line + "\n");
+  }
+}
+function preferredKeys(rows) {
+  const first = rows.find((r) => r && typeof r === "object");
+  if (!first) return [];
+  const all = Object.keys(first);
+  const priority = ["id", "name", "email", "url", "status", "subject", "channel", "priority", "event", "events", "scopes", "key_prefix", "created_at"];
+  const out = [];
+  for (const k of priority) if (all.includes(k)) out.push(k);
+  for (const k of all) {
+    if (out.includes(k)) continue;
+    const v = first[k];
+    if (v === null) continue;
+    if (typeof v === "object") continue;
+    out.push(k);
+  }
+  return out.slice(0, 8);
+}
+function printRecord(obj) {
+  const keys2 = Object.keys(obj);
+  const w = Math.max(...keys2.map((k) => k.length));
+  for (const k of keys2) {
+    const v = obj[k];
+    const s = v === null || v === void 0 ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+    process.stdout.write(`${k.padEnd(w)}  ${s}
+`);
+  }
+}
+function formatCell(v) {
+  if (v === null || v === void 0) return "";
+  if (Array.isArray(v)) return v.join(",");
+  if (typeof v === "object") return "{\u2026}";
+  const s = String(v);
+  return s.length > 60 ? s.slice(0, 57) + "\u2026" : s;
+}
+function logInfo(msg) {
+  if (globalOpts.quiet) return;
+  process.stderr.write(msg + "\n");
+}
+function logError(err) {
+  if (shouldJson()) {
+    const payload = {
+      error: err.message,
+      code: err.code ?? "UNKNOWN"
+    };
+    const ce = err;
+    if (ce.requestId) payload["request_id"] = ce.requestId;
+    if (ce.statusCode) payload["status_code"] = ce.statusCode;
+    if (ce.issues) payload["issues"] = ce.issues;
+    process.stderr.write(JSON.stringify(payload) + "\n");
+  } else {
+    process.stderr.write(`error: ${err.message}
+`);
+    const ce = err;
+    if (ce.code) process.stderr.write(`  code: ${ce.code}
+`);
+    if (ce.requestId) process.stderr.write(`  request_id: ${ce.requestId}
+`);
+    if (ce.issues?.length) {
+      for (const issue of ce.issues) {
+        process.stderr.write(`  - ${issue.path}: ${issue.message}
+`);
+      }
+    }
+  }
+}
+
+// src/lib/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+var CONFIG_PATH = join(homedir(), ".rogeriq", "config.json");
+var DEFAULT_API_BASE = "https://api.rogeriq.com";
+function readFile() {
+  if (!existsSync(CONFIG_PATH)) return {};
+  try {
+    const raw = readFileSync(CONFIG_PATH, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function writeFile(cfg) {
+  const dir = dirname(CONFIG_PATH);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true, mode: 448 });
+  writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+  try {
+    chmodSync(CONFIG_PATH, 384);
+  } catch {
+  }
+}
+function loadConfig() {
+  const file = readFile();
+  return {
+    apiKey: process.env["RIQ_API_KEY"] || file.apiKey,
+    apiBase: process.env["RIQ_API_BASE"] || file.apiBase || DEFAULT_API_BASE,
+    orgId: process.env["RIQ_ORG_ID"] || file.orgId,
+    projectId: process.env["RIQ_PROJECT_ID"] || file.projectId,
+    email: file.email
+  };
+}
+function saveConfig(updates) {
+  const current = readFile();
+  const merged = { ...current, ...updates };
+  writeFile(merged);
+  return merged;
+}
+function clearConfig() {
+  writeFile({});
+}
+function configPath() {
+  return CONFIG_PATH;
+}
+
+// src/lib/api-client.ts
+var ApiClient = class {
+  apiBase;
+  apiKey;
+  projectId;
+  orgId;
+  constructor(opts = {}) {
+    const cfg = loadConfig();
+    this.apiBase = (opts.apiBase ?? cfg.apiBase).replace(/\/$/, "");
+    this.apiKey = opts.apiKey ?? cfg.apiKey ?? "";
+    this.projectId = opts.projectId ?? cfg.projectId;
+    this.orgId = cfg.orgId;
+    if (!this.apiKey) {
+      throw new CliError(
+        "No API key configured. Run `rogeriq auth login --api-key riq_xxx` or set RIQ_API_KEY.",
+        "AUTH_REQUIRED",
+        3
+      );
+    }
+  }
+  async request(method, path, body, init = {}) {
+    const url = path.startsWith("http") ? path : `${this.apiBase}${path}`;
+    const headers = {
+      "X-API-Key": this.apiKey,
+      "User-Agent": `rogeriq-cli/0.1.0 node/${process.versions.node}`,
+      "Accept": "application/json",
+      ...init.headers
+    };
+    if (body !== void 0) headers["Content-Type"] = "application/json";
+    let res;
+    try {
+      res = await fetch(url, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : JSON.stringify(body),
+        ...init
+      });
+    } catch (e) {
+      throw new CliError(
+        `Network error contacting ${url}: ${e instanceof Error ? e.message : String(e)}`,
+        "NETWORK_ERROR",
+        2
+      );
+    }
+    const requestId = res.headers.get("X-Request-Id") ?? void 0;
+    const limit = res.headers.get("X-RateLimit-Limit");
+    const remaining = res.headers.get("X-RateLimit-Remaining");
+    const resetAt = res.headers.get("X-RateLimit-Reset");
+    const rateLimit = limit ? {
+      limit: Number(limit),
+      remaining: Number(remaining),
+      resetAt: Number(resetAt)
+    } : void 0;
+    const text = await res.text();
+    let parsed = void 0;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) {
+      const err = parsed;
+      const code = err?.code ?? `HTTP_${res.status}`;
+      const message = err?.error ?? `Request failed: ${res.status} ${res.statusText}`;
+      const exitCode = res.status === 401 || res.status === 403 ? 3 : res.status === 429 ? 4 : 2;
+      if (res.status === 429 && err?.retry_after && err.retry_after <= 30) {
+        await sleep(err.retry_after * 1e3);
+        return this.request(method, path, body, init);
+      }
+      const ce = new CliError(message, code, exitCode);
+      ce.requestId = requestId;
+      ce.statusCode = res.status;
+      ce.issues = err?.issues;
+      throw ce;
+    }
+    const data = parsed?.data;
+    return { data, raw: parsed, status: res.status, requestId, rateLimit };
+  }
+  get(path) {
+    return this.request("GET", path);
+  }
+  post(path, body) {
+    return this.request("POST", path, body);
+  }
+  patch(path, body) {
+    return this.request("PATCH", path, body);
+  }
+  put(path, body) {
+    return this.request("PUT", path, body);
+  }
+  del(path) {
+    return this.request("DELETE", path);
+  }
+  requireProject() {
+    if (!this.projectId) {
+      throw new CliError(
+        "No project selected. Run `rogeriq projects use <id>`, pass --project <id>, or set RIQ_PROJECT_ID.",
+        "PROJECT_REQUIRED",
+        1
+      );
+    }
+    return this.projectId;
+  }
+  requireOrg() {
+    if (!this.orgId) {
+      throw new CliError(
+        "No org selected. Run `rogeriq orgs use <id>` or set RIQ_ORG_ID.",
+        "ORG_REQUIRED",
+        1
+      );
+    }
+    return this.orgId;
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+// src/commands/auth.ts
+var auth = {
+  summary: "Manage CLI authentication",
+  subcommands: {
+    login: {
+      summary: "Save an API key for future commands",
+      usage: "rogeriq auth login --api-key riq_xxx [--api-base https://api.rogeriq.com]",
+      flags: [
+        { name: "api-key", type: "string" },
+        { name: "api-base", type: "string" }
+      ],
+      async run({ flags }) {
+        const apiKey = flags["api-key"];
+        const apiBase = flags["api-base"];
+        if (!apiKey) {
+          throw new CliError(
+            "Pass --api-key riq_xxx. Generate one with `rogeriq keys create <name>` (after a one-time browser login) or in the dashboard.",
+            "MISSING_API_KEY",
+            1
+          );
+        }
+        if (!apiKey.startsWith("riq_")) {
+          throw new CliError("API key must start with riq_", "INVALID_API_KEY", 1);
+        }
+        const updates = { apiKey };
+        if (apiBase) updates["apiBase"] = apiBase;
+        saveConfig(updates);
+        const client = new ApiClient();
+        const me = await client.get("/api/orgs");
+        const list = me.raw?.data ?? [];
+        if (list[0]?.id) saveConfig({ orgId: list[0].id });
+        logInfo(`Saved API key to ${configPath()}.`);
+        emit({ ok: true, org_id: list[0]?.id ?? null });
+      }
+    },
+    logout: {
+      summary: "Clear stored API key",
+      run() {
+        clearConfig();
+        logInfo(`Cleared ${configPath()}.`);
+        emit({ ok: true });
+      }
+    },
+    whoami: {
+      summary: "Show current API key + default org/project",
+      async run() {
+        const cfg = loadConfig();
+        if (!cfg.apiKey) {
+          throw new CliError("Not logged in. Run `rogeriq auth login --api-key riq_xxx`.", "NOT_LOGGED_IN", 3);
+        }
+        const client = new ApiClient();
+        const orgsRes = await client.get("/api/orgs");
+        const list = orgsRes.raw?.data ?? [];
+        emit({
+          api_key_prefix: cfg.apiKey.slice(0, 12) + "...",
+          api_base: cfg.apiBase,
+          org_id: cfg.orgId ?? null,
+          project_id: cfg.projectId ?? null,
+          orgs: list
+        });
+      }
+    }
+  }
+};
+
+// src/commands/config.ts
+var KEYS = ["apiKey", "apiBase", "orgId", "projectId"];
+var config = {
+  summary: "View / set CLI config (~/.rogeriq/config.json)",
+  subcommands: {
+    get: {
+      summary: "Print current config (apiKey redacted)",
+      run() {
+        const cfg = loadConfig();
+        emit({
+          ...cfg,
+          apiKey: cfg.apiKey ? cfg.apiKey.slice(0, 12) + "..." : null,
+          path: configPath()
+        });
+      }
+    },
+    set: {
+      summary: "Set a config key (apiKey | apiBase | orgId | projectId)",
+      usage: "rogeriq config set <key> <value>",
+      async run({ positional }) {
+        const [key, value] = positional;
+        if (!key || !value) throw new CliError("Usage: rogeriq config set <key> <value>", "BAD_USAGE", 1);
+        if (!KEYS.includes(key)) {
+          throw new CliError(`Unknown key. One of: ${KEYS.join(", ")}`, "BAD_KEY", 1);
+        }
+        saveConfig({ [key]: value });
+        logInfo(`Saved ${key}.`);
+        emit({ ok: true });
+      }
+    },
+    path: {
+      summary: "Print config file path",
+      run() {
+        process.stdout.write(configPath() + "\n");
+      }
+    }
+  }
+};
+
+// src/commands/orgs.ts
+var orgs = {
+  summary: "Manage organizations",
+  subcommands: {
+    list: {
+      summary: "List organizations you belong to",
+      async run() {
+        const client = new ApiClient();
+        const res = await client.get("/api/orgs");
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Show one organization with members",
+      usage: "rogeriq orgs get <org-id>",
+      async run({ positional }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq orgs get <org-id>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const res = await client.get(`/api/orgs/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create a new organization",
+      usage: "rogeriq orgs create <name>",
+      async run({ positional }) {
+        const [name] = positional;
+        if (!name) throw new CliError("Usage: rogeriq orgs create <name>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const res = await client.post("/api/orgs", { name });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    use: {
+      summary: "Set default org for future commands",
+      usage: "rogeriq orgs use <org-id>",
+      async run({ positional }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq orgs use <org-id>", "BAD_USAGE", 1);
+        saveConfig({ orgId: id });
+        logInfo(`Default org set to ${id}`);
+        emit({ ok: true, org_id: id });
+      }
+    },
+    members: {
+      summary: "List members of an org",
+      usage: "rogeriq orgs members [--org <id>]",
+      flags: [{ name: "org", type: "string" }],
+      async run({ flags }) {
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const res = await client.get(`/api/orgs/${orgId}/members`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/projects.ts
+var projects = {
+  summary: "Manage projects (a project is the unit of data isolation)",
+  subcommands: {
+    list: {
+      summary: "List projects in current org",
+      flags: [{ name: "org", type: "string" }],
+      async run({ flags }) {
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const res = await client.get(`/api/v1/orgs/${orgId}/projects`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one project",
+      usage: "rogeriq projects get <project-id>",
+      flags: [{ name: "org", type: "string" }],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq projects get <project-id>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const res = await client.get(`/api/v1/orgs/${orgId}/projects/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create a new project",
+      usage: "rogeriq projects create <name> [--slug ...] [--domain ...]",
+      flags: [
+        { name: "org", type: "string" },
+        { name: "slug", type: "string" },
+        { name: "domain", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [name] = positional;
+        if (!name) throw new CliError("Usage: rogeriq projects create <name>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const body = { name };
+        if (flags["slug"]) body["slug"] = flags["slug"];
+        if (flags["domain"]) body["domain"] = flags["domain"];
+        const res = await client.post(`/api/v1/orgs/${orgId}/projects`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update a project",
+      usage: "rogeriq projects update <project-id> [--name ...] [--domain ...] [--agent-mode autopilot|copilot|assist] [--ai-model ...]",
+      flags: [
+        { name: "org", type: "string" },
+        { name: "name", type: "string" },
+        { name: "domain", type: "string" },
+        { name: "agent-mode", type: "string" },
+        { name: "ai-model", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq projects update <project-id>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const body = {};
+        if (flags["name"]) body["name"] = flags["name"];
+        if (flags["domain"]) body["domain"] = flags["domain"];
+        if (flags["agent-mode"]) body["agent_mode"] = flags["agent-mode"];
+        if (flags["ai-model"]) body["ai_model"] = flags["ai-model"];
+        if (Object.keys(body).length === 0) {
+          throw new CliError("Provide at least one --name/--domain/--agent-mode/--ai-model", "NO_UPDATES", 1);
+        }
+        const res = await client.patch(`/api/v1/orgs/${orgId}/projects/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    delete: {
+      summary: "Delete a project (owner only)",
+      usage: "rogeriq projects delete <project-id>",
+      flags: [{ name: "org", type: "string" }],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq projects delete <project-id>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        await client.del(`/api/v1/orgs/${orgId}/projects/${id}`);
+        emit({ ok: true, deleted: id });
+      }
+    },
+    use: {
+      summary: "Set default project for future commands",
+      usage: "rogeriq projects use <project-id>",
+      async run({ positional }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq projects use <project-id>", "BAD_USAGE", 1);
+        saveConfig({ projectId: id });
+        logInfo(`Default project set to ${id}`);
+        emit({ ok: true, project_id: id });
+      }
+    }
+  }
+};
+
+// src/commands/keys.ts
+var keys = {
+  summary: "Manage API keys",
+  subcommands: {
+    list: {
+      summary: "List API keys for current org",
+      flags: [{ name: "org", type: "string" }],
+      async run({ flags }) {
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const res = await client.get(`/api/orgs/${orgId}/api-keys`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create an API key. Raw key returned ONCE \u2014 copy it now.",
+      usage: "rogeriq keys create <name> [--scopes read,write,admin] [--expires-days 90]",
+      flags: [
+        { name: "org", type: "string" },
+        { name: "scopes", type: "string" },
+        { name: "expires-days", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [name] = positional;
+        if (!name) throw new CliError("Usage: rogeriq keys create <name>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        const scopes = flags["scopes"]?.split(",").map((s) => s.trim()) ?? ["read", "write"];
+        const body = { name, scopes };
+        if (flags["expires-days"]) body["expires_in_days"] = Number(flags["expires-days"]);
+        const res = await client.post(`/api/orgs/${orgId}/api-keys`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    revoke: {
+      summary: "Revoke an API key",
+      usage: "rogeriq keys revoke <key-id>",
+      flags: [{ name: "org", type: "string" }],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq keys revoke <key-id>", "BAD_USAGE", 1);
+        const client = new ApiClient();
+        const orgId = flags["org"] ?? client.requireOrg();
+        await client.del(`/api/orgs/${orgId}/api-keys/${id}`);
+        emit({ ok: true, revoked: id });
+      }
+    }
+  }
+};
+
+// src/commands/conversations.ts
+function buildQuery(params) {
+  const u = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) if (v) u.set(k, v);
+  const s = u.toString();
+  return s ? `?${s}` : "";
+}
+var conversations = {
+  summary: "Manage tickets / conversations",
+  subcommands: {
+    list: {
+      summary: "List conversations (uses v1 public API)",
+      usage: "rogeriq conversations list [--status open|snoozed|resolved|closed] [--priority ...] [--channel ...] [--q 'search'] [--limit 50] [--cursor ...]",
+      flags: [
+        { name: "status", type: "string" },
+        { name: "priority", type: "string" },
+        { name: "channel", type: "string" },
+        { name: "assigned-to", type: "string" },
+        { name: "contact", type: "string" },
+        { name: "q", type: "string" },
+        { name: "limit", type: "string" },
+        { name: "cursor", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const qs = buildQuery({
+          status: flags["status"],
+          priority: flags["priority"],
+          channel: flags["channel"],
+          assigned_to: flags["assigned-to"],
+          contact_id: flags["contact"],
+          q: flags["q"],
+          limit: flags["limit"],
+          cursor: flags["cursor"]
+        });
+        const res = await client.get(`/api/v1/projects/${pid}/conversations${qs}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one conversation (with recent messages)",
+      usage: "rogeriq conversations get <conversation-id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq conversations get <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/v1/projects/${pid}/conversations/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create a conversation",
+      usage: "rogeriq conversations create [--subject ...] [--contact <id>] [--channel api]",
+      flags: [
+        { name: "subject", type: "string" },
+        { name: "contact", type: "string" },
+        { name: "channel", type: "string" },
+        { name: "priority", type: "string" },
+        { name: "tags", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {};
+        if (flags["subject"]) body["subject"] = flags["subject"];
+        if (flags["contact"]) body["contact_id"] = flags["contact"];
+        if (flags["channel"]) body["channel"] = flags["channel"];
+        if (flags["priority"]) body["priority"] = flags["priority"];
+        if (flags["tags"]) body["tags"] = flags["tags"].split(",");
+        const res = await client.post(`/api/v1/projects/${pid}/conversations`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update a conversation (subject/status/priority/assignee/tags)",
+      usage: "rogeriq conversations update <id> [--status ...] [--priority ...] [--assigned-to <user-id>] [--tags a,b]",
+      flags: [
+        { name: "subject", type: "string" },
+        { name: "status", type: "string" },
+        { name: "priority", type: "string" },
+        { name: "assigned-to", type: "string" },
+        { name: "tags", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq conversations update <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {};
+        if (flags["subject"]) body["subject"] = flags["subject"];
+        if (flags["status"]) body["status"] = flags["status"];
+        if (flags["priority"]) body["priority"] = flags["priority"];
+        if (flags["assigned-to"]) body["assigned_to"] = flags["assigned-to"];
+        if (flags["tags"]) body["tags"] = flags["tags"].split(",");
+        if (Object.keys(body).length === 0) throw new CliError("No updates provided", "NO_UPDATES", 1);
+        const res = await client.patch(`/api/v1/projects/${pid}/conversations/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    reply: {
+      summary: "Send a reply to a conversation",
+      usage: "rogeriq conversations reply <id> <content> [--internal]",
+      flags: [
+        { name: "internal", type: "boolean" },
+        { name: "sender-type", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id, ...rest] = positional;
+        const content = rest.join(" ");
+        if (!id || !content) throw new CliError("Usage: rogeriq conversations reply <id> <content>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {
+          content,
+          is_internal: flags["internal"] === true
+        };
+        if (flags["sender-type"]) body["sender_type"] = flags["sender-type"];
+        const res = await client.post(`/api/v1/projects/${pid}/conversations/${id}/messages`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    resolve: {
+      summary: "Resolve a conversation",
+      usage: "rogeriq conversations resolve <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq conversations resolve <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/v1/projects/${pid}/conversations/${id}`, { status: "resolved" });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    snooze: {
+      summary: "Snooze a conversation",
+      usage: "rogeriq conversations snooze <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq conversations snooze <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/v1/projects/${pid}/conversations/${id}`, { status: "snoozed" });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    assign: {
+      summary: "Assign conversation to a user",
+      usage: "rogeriq conversations assign <id> <user-id>",
+      async run({ positional, flags }) {
+        const [id, userId] = positional;
+        if (!id || !userId) throw new CliError("Usage: rogeriq conversations assign <id> <user-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/v1/projects/${pid}/conversations/${id}`, { assigned_to: userId });
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/messages.ts
+var messages = {
+  summary: "List / send messages on a conversation",
+  subcommands: {
+    list: {
+      summary: "List messages for a conversation",
+      usage: "rogeriq messages list <conversation-id> [--limit 100] [--cursor ...]",
+      flags: [
+        { name: "limit", type: "string" },
+        { name: "cursor", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [conv] = positional;
+        if (!conv) throw new CliError("Usage: rogeriq messages list <conversation-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const qs = new URLSearchParams();
+        if (flags["limit"]) qs.set("limit", flags["limit"]);
+        if (flags["cursor"]) qs.set("cursor", flags["cursor"]);
+        const suffix = qs.toString() ? `?${qs}` : "";
+        const res = await client.get(`/api/v1/projects/${pid}/conversations/${conv}/messages${suffix}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    send: {
+      summary: "Send a message on a conversation",
+      usage: "rogeriq messages send <conversation-id> <content> [--internal] [--sender-type system|agent]",
+      flags: [
+        { name: "internal", type: "boolean" },
+        { name: "sender-type", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [conv, ...rest] = positional;
+        const content = rest.join(" ");
+        if (!conv || !content) throw new CliError("Usage: rogeriq messages send <conversation-id> <content>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {
+          content,
+          is_internal: flags["internal"] === true
+        };
+        if (flags["sender-type"]) body["sender_type"] = flags["sender-type"];
+        const res = await client.post(`/api/v1/projects/${pid}/conversations/${conv}/messages`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/contacts.ts
+var contacts = {
+  summary: "Manage contacts (people on the customer side)",
+  subcommands: {
+    list: {
+      summary: "List contacts",
+      usage: "rogeriq contacts list [--q 'search'] [--email ...] [--external-id ...] [--limit 50] [--cursor ...]",
+      flags: [
+        { name: "q", type: "string" },
+        { name: "email", type: "string" },
+        { name: "external-id", type: "string" },
+        { name: "limit", type: "string" },
+        { name: "cursor", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const qs = new URLSearchParams();
+        if (flags["q"]) qs.set("q", flags["q"]);
+        if (flags["email"]) qs.set("email", flags["email"]);
+        if (flags["external-id"]) qs.set("external_id", flags["external-id"]);
+        if (flags["limit"]) qs.set("limit", flags["limit"]);
+        if (flags["cursor"]) qs.set("cursor", flags["cursor"]);
+        const suffix = qs.toString() ? `?${qs}` : "";
+        const res = await client.get(`/api/v1/projects/${pid}/contacts${suffix}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one contact (with conversation history)",
+      usage: "rogeriq contacts get <contact-id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq contacts get <contact-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/v1/projects/${pid}/contacts/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    upsert: {
+      summary: "Create or update a contact by email/external_id",
+      usage: "rogeriq contacts upsert [--email ...] [--name ...] [--external-id ...] [--phone ...] [--company ...] [--metadata '{...}']",
+      flags: [
+        { name: "email", type: "string" },
+        { name: "name", type: "string" },
+        { name: "phone", type: "string" },
+        { name: "company", type: "string" },
+        { name: "job-title", type: "string" },
+        { name: "external-id", type: "string" },
+        { name: "metadata", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {};
+        if (flags["email"]) body["email"] = flags["email"];
+        if (flags["name"]) body["name"] = flags["name"];
+        if (flags["phone"]) body["phone"] = flags["phone"];
+        if (flags["company"]) body["company"] = flags["company"];
+        if (flags["job-title"]) body["job_title"] = flags["job-title"];
+        if (flags["external-id"]) body["external_id"] = flags["external-id"];
+        if (flags["metadata"]) {
+          try {
+            body["metadata"] = JSON.parse(flags["metadata"]);
+          } catch {
+            throw new CliError("--metadata must be valid JSON", "BAD_JSON", 1);
+          }
+        }
+        if (Object.keys(body).length === 0) throw new CliError("Provide at least one field", "NO_FIELDS", 1);
+        const res = await client.post(`/api/v1/projects/${pid}/contacts`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update a contact",
+      usage: "rogeriq contacts update <contact-id> [--name ...] [--email ...] etc",
+      flags: [
+        { name: "email", type: "string" },
+        { name: "name", type: "string" },
+        { name: "phone", type: "string" },
+        { name: "company", type: "string" },
+        { name: "job-title", type: "string" },
+        { name: "external-id", type: "string" },
+        { name: "metadata", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq contacts update <contact-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {};
+        for (const [src, dst] of [
+          ["email", "email"],
+          ["name", "name"],
+          ["phone", "phone"],
+          ["company", "company"],
+          ["job-title", "job_title"],
+          ["external-id", "external_id"]
+        ]) {
+          if (flags[src]) body[dst] = flags[src];
+        }
+        if (flags["metadata"]) {
+          try {
+            body["metadata"] = JSON.parse(flags["metadata"]);
+          } catch {
+            throw new CliError("--metadata must be valid JSON", "BAD_JSON", 1);
+          }
+        }
+        if (Object.keys(body).length === 0) throw new CliError("No updates provided", "NO_UPDATES", 1);
+        const res = await client.patch(`/api/v1/projects/${pid}/contacts/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/agent.ts
+var agent = {
+  summary: "AI agent: status, config, respond, classify",
+  subcommands: {
+    status: {
+      summary: "Show agent status (mode, model, recent activity)",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/agent/status`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    config: {
+      summary: "Get or update agent config",
+      usage: "rogeriq agent config [--mode autopilot|copilot|assist] [--model openai/gpt-4o]",
+      flags: [
+        { name: "mode", type: "string" },
+        { name: "model", type: "string" },
+        { name: "persona", type: "string" },
+        { name: "tone", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {};
+        if (flags["mode"]) body["agent_mode"] = flags["mode"];
+        if (flags["model"]) body["ai_model"] = flags["model"];
+        if (flags["persona"]) body["persona"] = flags["persona"];
+        if (flags["tone"]) body["tone"] = flags["tone"];
+        if (Object.keys(body).length === 0) {
+          const res2 = await client.get(`/api/projects/${pid}/agent/config`);
+          emit(res2.raw?.data ?? res2.raw);
+          return;
+        }
+        const res = await client.patch(`/api/projects/${pid}/agent/config`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    models: {
+      summary: "List available LLM models",
+      async run() {
+        const client = new ApiClient();
+        const res = await client.get(`/api/projects/agent/models`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    respond: {
+      summary: "Trigger AI to draft / send a response on a conversation",
+      usage: "rogeriq agent respond <conversation-id>",
+      async run({ positional, flags }) {
+        const [conv] = positional;
+        if (!conv) throw new CliError("Usage: rogeriq agent respond <conversation-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/agent/respond`, {
+          conversation_id: conv
+        });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    classify: {
+      summary: "Classify a conversation (intent, sentiment, priority)",
+      usage: "rogeriq agent classify <conversation-id>",
+      async run({ positional, flags }) {
+        const [conv] = positional;
+        if (!conv) throw new CliError("Usage: rogeriq agent classify <conversation-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/agent/classify`, {
+          conversation_id: conv
+        });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    suggest: {
+      summary: "Generate suggested replies for a conversation",
+      usage: "rogeriq agent suggest <conversation-id>",
+      async run({ positional, flags }) {
+        const [conv] = positional;
+        if (!conv) throw new CliError("Usage: rogeriq agent suggest <conversation-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/agent/suggest`, {
+          conversation_id: conv
+        });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    "knowledge-map": {
+      summary: "Show what the agent knows (knowledge map)",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/agent/knowledge-map`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/kb.ts
+import { readFileSync as readFileSync2, statSync } from "node:fs";
+var kb = {
+  summary: "Knowledge base: articles, search, ingest, crawl",
+  subcommands: {
+    list: {
+      summary: "List KB articles",
+      flags: [{ name: "limit", type: "string" }, { name: "cursor", type: "string" }],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const qs = new URLSearchParams();
+        if (flags["limit"]) qs.set("limit", flags["limit"]);
+        if (flags["cursor"]) qs.set("cursor", flags["cursor"]);
+        const suffix = qs.toString() ? `?${qs}` : "";
+        const res = await client.get(`/api/projects/${pid}/kb/articles${suffix}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one article",
+      usage: "rogeriq kb get <article-id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq kb get <article-id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/kb/articles/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create an article",
+      usage: "rogeriq kb create --title 'Title' [--content-file path.md] [--content 'inline'] [--category-id ...]",
+      flags: [
+        { name: "title", type: "string" },
+        { name: "content", type: "string" },
+        { name: "content-file", type: "string" },
+        { name: "category-id", type: "string" },
+        { name: "status", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const title = flags["title"];
+        if (!title) throw new CliError("--title is required", "MISSING_TITLE", 1);
+        let content = flags["content"];
+        if (flags["content-file"]) content = readFileSync2(flags["content-file"], "utf8");
+        if (!content) throw new CliError("--content or --content-file is required", "MISSING_CONTENT", 1);
+        const body = { title, content };
+        if (flags["category-id"]) body["category_id"] = flags["category-id"];
+        if (flags["status"]) body["status"] = flags["status"];
+        const res = await client.post(`/api/projects/${pid}/kb/articles`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update an article",
+      usage: "rogeriq kb update <id> [--title ...] [--content-file ...] [--status published|draft]",
+      flags: [
+        { name: "title", type: "string" },
+        { name: "content", type: "string" },
+        { name: "content-file", type: "string" },
+        { name: "status", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq kb update <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const body = {};
+        if (flags["title"]) body["title"] = flags["title"];
+        if (flags["content-file"]) body["content"] = readFileSync2(flags["content-file"], "utf8");
+        else if (flags["content"]) body["content"] = flags["content"];
+        if (flags["status"]) body["status"] = flags["status"];
+        if (Object.keys(body).length === 0) throw new CliError("No updates provided", "NO_UPDATES", 1);
+        const res = await client.patch(`/api/projects/${pid}/kb/articles/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    delete: {
+      summary: "Delete an article",
+      usage: "rogeriq kb delete <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq kb delete <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        await client.del(`/api/projects/${pid}/kb/articles/${id}`);
+        emit({ ok: true, deleted: id });
+      }
+    },
+    publish: {
+      summary: "Publish an article",
+      usage: "rogeriq kb publish <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq kb publish <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/kb/articles/${id}/publish`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    search: {
+      summary: "Search KB by query",
+      usage: "rogeriq kb search 'how to refund'",
+      async run({ positional, flags }) {
+        const q = positional.join(" ");
+        if (!q) throw new CliError("Usage: rogeriq kb search <query>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/kb/search?q=${encodeURIComponent(q)}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    ingest: {
+      summary: "Ingest a URL or file as a KB article",
+      usage: "rogeriq kb ingest <url-or-file>",
+      async run({ positional, flags }) {
+        const [target] = positional;
+        if (!target) throw new CliError("Usage: rogeriq kb ingest <url-or-file>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const isUrl = /^https?:\/\//.test(target);
+        if (isUrl) {
+          const res = await client.post(`/api/projects/${pid}/kb/ingest-url`, { url: target });
+          emit(res.raw?.data ?? res.raw);
+        } else {
+          statSync(target);
+          const content = readFileSync2(target, "utf8");
+          const title = target.split("/").pop().replace(/\.[^.]+$/, "");
+          const res = await client.post(`/api/projects/${pid}/kb/articles`, { title, content });
+          emit(res.raw?.data ?? res.raw);
+        }
+      }
+    },
+    crawl: {
+      summary: "Start a site crawl (or list / get job status)",
+      usage: "rogeriq kb crawl <url> | rogeriq kb crawl status <job-id> | rogeriq kb crawl list",
+      async run({ positional, flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const [arg1, arg2] = positional;
+        if (!arg1) throw new CliError("Usage: rogeriq kb crawl <url|status|list>", "BAD_USAGE", 1);
+        if (arg1 === "list") {
+          const res2 = await client.get(`/api/projects/${pid}/kb/crawl`);
+          emit(res2.raw?.data ?? res2.raw);
+          return;
+        }
+        if (arg1 === "status") {
+          if (!arg2) throw new CliError("Usage: rogeriq kb crawl status <job-id>", "BAD_USAGE", 1);
+          const res2 = await client.get(`/api/projects/${pid}/kb/crawl/${arg2}`);
+          emit(res2.raw?.data ?? res2.raw);
+          return;
+        }
+        const res = await client.post(`/api/projects/${pid}/kb/crawl`, { url: arg1 });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    categories: {
+      summary: "List KB categories",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/kb/categories`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/widget.ts
+var widget = {
+  summary: "Configure the embeddable chat widget",
+  subcommands: {
+    config: {
+      summary: "Get current widget config",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/v1/projects/${pid}/widget/config`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    set: {
+      summary: "Update widget config",
+      usage: "rogeriq widget set [--theme dark|light] [--launcher circle|rounded] [--primary-color '#xxxxxx'] [--position bottom-right] [--json-patch '{...}']",
+      flags: [
+        { name: "theme", type: "string" },
+        { name: "launcher", type: "string" },
+        { name: "primary-color", type: "string" },
+        { name: "position", type: "string" },
+        { name: "welcome-message", type: "string" },
+        { name: "json-patch", type: "string" }
+      ],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        let body = {};
+        if (flags["json-patch"]) {
+          try {
+            body = JSON.parse(flags["json-patch"]);
+          } catch {
+            throw new CliError("--json-patch must be valid JSON", "BAD_JSON", 1);
+          }
+        }
+        if (flags["theme"]) body["theme"] = flags["theme"];
+        if (flags["launcher"]) body["launcher_style"] = flags["launcher"];
+        if (flags["primary-color"]) body["primary_color"] = flags["primary-color"];
+        if (flags["position"]) body["position"] = flags["position"];
+        if (flags["welcome-message"]) body["welcome_message"] = flags["welcome-message"];
+        if (Object.keys(body).length === 0) throw new CliError("No fields to update", "NO_UPDATES", 1);
+        const res = await client.patch(`/api/v1/projects/${pid}/widget/config`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    snippet: {
+      summary: "Print the install snippet (HTML <script>) for the widget",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/widget/snippet`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    "custom-fields": {
+      summary: "List widget custom fields",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/widget/custom-fields`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/integrations.ts
+var integrations = {
+  summary: "Manage third-party integrations (Slack, Shopify, Stripe, Linear, GitHub, Discord)",
+  subcommands: {
+    list: {
+      summary: "List integrations connected to current project",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/integrations`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one integration",
+      usage: "rogeriq integrations get <integration-id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq integrations get <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/integrations/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    connect: {
+      summary: "Get OAuth install URL for a provider (open in browser to complete)",
+      usage: "rogeriq integrations connect <slack|github|shopify|stripe|linear|discord>",
+      async run({ positional, flags }) {
+        const [provider] = positional;
+        if (!provider) throw new CliError("Usage: rogeriq integrations connect <provider>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/integrations/${provider}/install-url`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    configure: {
+      summary: "Update integration config (provider-specific JSON payload)",
+      usage: "rogeriq integrations configure <id> --config '{...}'",
+      flags: [{ name: "config", type: "string" }],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        const raw = flags["config"];
+        if (!id || !raw) throw new CliError("Usage: rogeriq integrations configure <id> --config '{...}'", "BAD_USAGE", 1);
+        let body;
+        try {
+          body = JSON.parse(raw);
+        } catch {
+          throw new CliError("--config must be valid JSON", "BAD_JSON", 1);
+        }
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/projects/${pid}/integrations/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    disconnect: {
+      summary: "Disconnect an integration",
+      usage: "rogeriq integrations disconnect <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq integrations disconnect <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        await client.del(`/api/projects/${pid}/integrations/${id}`);
+        emit({ ok: true, disconnected: id });
+      }
+    }
+  }
+};
+
+// src/commands/forms.ts
+import { readFileSync as readFileSync3 } from "node:fs";
+var forms = {
+  summary: "Manage public-facing intake forms",
+  subcommands: {
+    list: {
+      summary: "List forms",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/forms`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one form",
+      usage: "rogeriq forms get <form-id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq forms get <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/forms/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create a form (pass schema as JSON or file)",
+      usage: "rogeriq forms create --name 'Contact us' --schema-file form.json",
+      flags: [
+        { name: "name", type: "string" },
+        { name: "schema", type: "string" },
+        { name: "schema-file", type: "string" }
+      ],
+      async run({ flags }) {
+        const name = flags["name"];
+        if (!name) throw new CliError("--name required", "MISSING_NAME", 1);
+        let schema;
+        if (flags["schema-file"]) schema = JSON.parse(readFileSync3(flags["schema-file"], "utf8"));
+        else if (flags["schema"]) schema = JSON.parse(flags["schema"]);
+        else throw new CliError("--schema or --schema-file required", "MISSING_SCHEMA", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/forms`, { name, schema });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update a form",
+      usage: "rogeriq forms update <id> [--name ...] [--schema-file ...]",
+      flags: [
+        { name: "name", type: "string" },
+        { name: "schema", type: "string" },
+        { name: "schema-file", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq forms update <id>", "BAD_USAGE", 1);
+        const body = {};
+        if (flags["name"]) body["name"] = flags["name"];
+        if (flags["schema-file"]) body["schema"] = JSON.parse(readFileSync3(flags["schema-file"], "utf8"));
+        else if (flags["schema"]) body["schema"] = JSON.parse(flags["schema"]);
+        if (Object.keys(body).length === 0) throw new CliError("No updates provided", "NO_UPDATES", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/projects/${pid}/forms/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    archive: {
+      summary: "Archive a form",
+      usage: "rogeriq forms archive <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq forms archive <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/forms/${id}/archive`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    submissions: {
+      summary: "List submissions for a form",
+      usage: "rogeriq forms submissions <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq forms submissions <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/forms/${id}/submissions`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/beacons.ts
+var beacons = {
+  summary: "Manage floating help beacons",
+  subcommands: {
+    list: {
+      summary: "List beacons",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/beacons`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one beacon",
+      usage: "rogeriq beacons get <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq beacons get <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/beacons/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create a beacon (provide config JSON)",
+      usage: "rogeriq beacons create --name '...' --config '{...}'",
+      flags: [
+        { name: "name", type: "string" },
+        { name: "config", type: "string" }
+      ],
+      async run({ flags }) {
+        const name = flags["name"];
+        const cfgStr = flags["config"];
+        if (!name) throw new CliError("--name required", "MISSING_NAME", 1);
+        const body = { name };
+        if (cfgStr) {
+          try {
+            Object.assign(body, JSON.parse(cfgStr));
+          } catch {
+            throw new CliError("--config must be valid JSON", "BAD_JSON", 1);
+          }
+        }
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/beacons`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update a beacon",
+      usage: "rogeriq beacons update <id> --config '{...}'",
+      flags: [{ name: "config", type: "string" }],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        const cfgStr = flags["config"];
+        if (!id || !cfgStr) throw new CliError("Usage: rogeriq beacons update <id> --config '{...}'", "BAD_USAGE", 1);
+        let body;
+        try {
+          body = JSON.parse(cfgStr);
+        } catch {
+          throw new CliError("--config must be valid JSON", "BAD_JSON", 1);
+        }
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/projects/${pid}/beacons/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    archive: {
+      summary: "Archive a beacon",
+      usage: "rogeriq beacons archive <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq beacons archive <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/projects/${pid}/beacons/${id}/archive`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/webhooks.ts
+var webhooks = {
+  summary: "Manage outbound webhooks (event subscriptions)",
+  subcommands: {
+    list: {
+      summary: "List webhooks",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/v1/projects/${pid}/webhooks`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    get: {
+      summary: "Get one webhook",
+      usage: "rogeriq webhooks get <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq webhooks get <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/v1/projects/${pid}/webhooks/${id}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    create: {
+      summary: "Create a webhook subscription",
+      usage: "rogeriq webhooks create --url https://example.com/hook --events conversation.*,message.created",
+      flags: [
+        { name: "url", type: "string" },
+        { name: "events", type: "string" }
+      ],
+      async run({ flags }) {
+        const url = flags["url"];
+        const events = flags["events"];
+        if (!url || !events) throw new CliError("--url and --events required", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/v1/projects/${pid}/webhooks`, {
+          url,
+          events: events.split(",").map((e) => e.trim())
+        });
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    update: {
+      summary: "Update a webhook (url, events, or status)",
+      usage: "rogeriq webhooks update <id> [--url ...] [--events ...] [--status active|disabled]",
+      flags: [
+        { name: "url", type: "string" },
+        { name: "events", type: "string" },
+        { name: "status", type: "string" }
+      ],
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq webhooks update <id>", "BAD_USAGE", 1);
+        const body = {};
+        if (flags["url"]) body["url"] = flags["url"];
+        if (flags["events"]) body["events"] = flags["events"].split(",").map((e) => e.trim());
+        if (flags["status"]) body["status"] = flags["status"];
+        if (Object.keys(body).length === 0) throw new CliError("No updates provided", "NO_UPDATES", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.patch(`/api/v1/projects/${pid}/webhooks/${id}`, body);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    delete: {
+      summary: "Delete a webhook",
+      usage: "rogeriq webhooks delete <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq webhooks delete <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        await client.del(`/api/v1/projects/${pid}/webhooks/${id}`);
+        emit({ ok: true, deleted: id });
+      }
+    },
+    test: {
+      summary: "Fire a sample webhook.test event",
+      usage: "rogeriq webhooks test <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq webhooks test <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/v1/projects/${pid}/webhooks/${id}/test`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    deliveries: {
+      summary: "List recent deliveries (last 50)",
+      usage: "rogeriq webhooks deliveries <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq webhooks deliveries <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/v1/projects/${pid}/webhooks/${id}/deliveries`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    "rotate-secret": {
+      summary: "Rotate the HMAC signing secret",
+      usage: "rogeriq webhooks rotate-secret <id>",
+      async run({ positional, flags }) {
+        const [id] = positional;
+        if (!id) throw new CliError("Usage: rogeriq webhooks rotate-secret <id>", "BAD_USAGE", 1);
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.post(`/api/v1/projects/${pid}/webhooks/${id}/rotate-secret`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/analytics.ts
+var analytics = {
+  summary: "Analytics \u2014 overview, conversation metrics, AI performance",
+  subcommands: {
+    overview: {
+      summary: "Project analytics overview",
+      flags: [{ name: "period", type: "string" }],
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const qs = flags["period"] ? `?period=${flags["period"]}` : "";
+        const res = await client.get(`/api/projects/${pid}/analytics/overview${qs}`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    },
+    "report-views": {
+      summary: "List saved report views",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const res = await client.get(`/api/projects/${pid}/report-views`);
+        emit(res.raw?.data ?? res.raw);
+      }
+    }
+  }
+};
+
+// src/commands/status.ts
+var status = {
+  summary: "One-shot dashboard: open conversations, AI stats, project health",
+  subcommands: {
+    _default: {
+      summary: "Show project status overview",
+      async run({ flags }) {
+        const client = new ApiClient({ projectId: flags["project"] });
+        const pid = client.requireProject();
+        const [counts, agent2, overview] = await Promise.all([
+          client.get(`/api/projects/${pid}/conversations/count`).catch((e) => ({ raw: { error: e.message } })),
+          client.get(`/api/projects/${pid}/agent/status`).catch((e) => ({ raw: { error: e.message } })),
+          client.get(`/api/projects/${pid}/analytics/overview`).catch((e) => ({ raw: { error: e.message } }))
+        ]);
+        emit({
+          project_id: pid,
+          conversations: counts.raw?.data ?? counts.raw,
+          agent: agent2.raw?.data ?? agent2.raw,
+          analytics: overview.raw?.data ?? overview.raw
+        });
+      }
+    }
+  }
+};
+
+// src/commands/mcp.ts
+var tools = [
+  {
+    name: "list_conversations",
+    description: "List support conversations (tickets) for the current project. Filter by status, priority, channel, contact, or free-text query.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        status: { type: "string", enum: ["open", "snoozed", "resolved", "closed"] },
+        priority: { type: "string", enum: ["low", "normal", "high", "urgent"] },
+        channel: { type: "string" },
+        contact_id: { type: "string" },
+        q: { type: "string", description: "Free-text search" },
+        limit: { type: "number", default: 50 }
+      }
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const qs = new URLSearchParams();
+      for (const k of ["status", "priority", "channel", "contact_id", "q", "limit"]) {
+        const v = args[k];
+        if (v !== void 0 && v !== null) qs.set(k, String(v));
+      }
+      const res = await client.get(`/api/v1/projects/${pid}/conversations?${qs}`);
+      return res.raw;
+    }
+  },
+  {
+    name: "get_conversation",
+    description: "Fetch a single conversation with its recent messages.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string" } },
+      required: ["id"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.get(`/api/v1/projects/${pid}/conversations/${args["id"]}`);
+      return res.raw;
+    }
+  },
+  {
+    name: "reply_to_conversation",
+    description: "Send a reply message on a conversation. Set is_internal=true for an internal note that the customer cannot see.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        conversation_id: { type: "string" },
+        content: { type: "string" },
+        is_internal: { type: "boolean", default: false }
+      },
+      required: ["conversation_id", "content"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.post(
+        `/api/v1/projects/${pid}/conversations/${args["conversation_id"]}/messages`,
+        { content: args["content"], is_internal: args["is_internal"] === true }
+      );
+      return res.raw;
+    }
+  },
+  {
+    name: "update_conversation",
+    description: "Update a conversation's status, priority, assignee, or tags.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string" },
+        status: { type: "string", enum: ["open", "snoozed", "resolved", "closed"] },
+        priority: { type: "string", enum: ["low", "normal", "high", "urgent"] },
+        assigned_to: { type: "string", description: "User ID to assign the conversation to" },
+        tags: { type: "array", items: { type: "string" } },
+        subject: { type: "string" }
+      },
+      required: ["id"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const { id, ...body } = args;
+      const res = await client.patch(`/api/v1/projects/${pid}/conversations/${id}`, body);
+      return res.raw;
+    }
+  },
+  {
+    name: "list_contacts",
+    description: "List contacts (customers) for the current project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        q: { type: "string" },
+        email: { type: "string" },
+        external_id: { type: "string" },
+        limit: { type: "number", default: 50 }
+      }
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const qs = new URLSearchParams();
+      for (const k of ["q", "email", "external_id", "limit"]) {
+        const v = args[k];
+        if (v !== void 0 && v !== null) qs.set(k, String(v));
+      }
+      const res = await client.get(`/api/v1/projects/${pid}/contacts?${qs}`);
+      return res.raw;
+    }
+  },
+  {
+    name: "upsert_contact",
+    description: "Create or update a contact, keyed by email or external_id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        email: { type: "string" },
+        name: { type: "string" },
+        phone: { type: "string" },
+        external_id: { type: "string" },
+        company: { type: "string" },
+        metadata: { type: "object" }
+      }
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.post(`/api/v1/projects/${pid}/contacts`, args);
+      return res.raw;
+    }
+  },
+  {
+    name: "search_knowledge_base",
+    description: "Search the project's knowledge base for relevant articles.",
+    inputSchema: {
+      type: "object",
+      properties: { q: { type: "string" } },
+      required: ["q"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.get(`/api/projects/${pid}/kb/search?q=${encodeURIComponent(String(args["q"]))}`);
+      return res.raw;
+    }
+  },
+  {
+    name: "list_kb_articles",
+    description: "List knowledge base articles.",
+    inputSchema: { type: "object", properties: {} },
+    async call(client) {
+      const pid = client.requireProject();
+      const res = await client.get(`/api/projects/${pid}/kb/articles`);
+      return res.raw;
+    }
+  },
+  {
+    name: "create_kb_article",
+    description: "Add a new article to the knowledge base.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: { type: "string" },
+        content: { type: "string", description: "Markdown body" },
+        category_id: { type: "string" },
+        status: { type: "string", enum: ["draft", "published"] }
+      },
+      required: ["title", "content"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.post(`/api/projects/${pid}/kb/articles`, args);
+      return res.raw;
+    }
+  },
+  {
+    name: "agent_respond",
+    description: "Ask the AI agent to draft and send a response on a conversation.",
+    inputSchema: {
+      type: "object",
+      properties: { conversation_id: { type: "string" } },
+      required: ["conversation_id"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.post(`/api/projects/${pid}/agent/respond`, args);
+      return res.raw;
+    }
+  },
+  {
+    name: "list_projects",
+    description: "List projects in the current org.",
+    inputSchema: { type: "object", properties: {} },
+    async call(client) {
+      const orgId = client.requireOrg();
+      const res = await client.get(`/api/v1/orgs/${orgId}/projects`);
+      return res.raw;
+    }
+  },
+  {
+    name: "create_project",
+    description: "Create a new project in the current org.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        domain: { type: "string" }
+      },
+      required: ["name"]
+    },
+    async call(client, args) {
+      const orgId = client.requireOrg();
+      const res = await client.post(`/api/v1/orgs/${orgId}/projects`, args);
+      return res.raw;
+    }
+  },
+  {
+    name: "get_widget_config",
+    description: "Get the current chat widget configuration for the project.",
+    inputSchema: { type: "object", properties: {} },
+    async call(client) {
+      const pid = client.requireProject();
+      const res = await client.get(`/api/v1/projects/${pid}/widget/config`);
+      return res.raw;
+    }
+  },
+  {
+    name: "update_widget_config",
+    description: "Patch the widget configuration (theme, launcher, primary color, etc).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        theme: { type: "string" },
+        launcher_style: { type: "string" },
+        primary_color: { type: "string" },
+        position: { type: "string" },
+        welcome_message: { type: "string" }
+      }
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.patch(`/api/v1/projects/${pid}/widget/config`, args);
+      return res.raw;
+    }
+  },
+  {
+    name: "list_integrations",
+    description: "List integrations (Slack, Shopify, Stripe, Linear, GitHub, Discord) connected to the project.",
+    inputSchema: { type: "object", properties: {} },
+    async call(client) {
+      const pid = client.requireProject();
+      const res = await client.get(`/api/projects/${pid}/integrations`);
+      return res.raw;
+    }
+  },
+  {
+    name: "list_webhooks",
+    description: "List outbound webhooks for the project.",
+    inputSchema: { type: "object", properties: {} },
+    async call(client) {
+      const pid = client.requireProject();
+      const res = await client.get(`/api/v1/projects/${pid}/webhooks`);
+      return res.raw;
+    }
+  },
+  {
+    name: "create_webhook",
+    description: "Subscribe a URL to webhook events. Events can use wildcards like conversation.*",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string" },
+        events: { type: "array", items: { type: "string" } }
+      },
+      required: ["url", "events"]
+    },
+    async call(client, args) {
+      const pid = client.requireProject();
+      const res = await client.post(`/api/v1/projects/${pid}/webhooks`, args);
+      return res.raw;
+    }
+  }
+];
+var mcp = {
+  summary: "Run an MCP server (stdio) so Claude / agents can call the API directly",
+  subcommands: {
+    _default: {
+      summary: "Start MCP stdio server (use from Claude Desktop / Claude Code)",
+      async run() {
+        await runMcpServer();
+      }
+    },
+    "list-tools": {
+      summary: "Print the list of MCP tools (for inspection / docs)",
+      run() {
+        const list = tools.map((t) => ({
+          name: t.name,
+          description: t.description,
+          inputSchema: t.inputSchema
+        }));
+        process.stdout.write(JSON.stringify(list, null, 2) + "\n");
+      }
+    }
+  }
+};
+async function runMcpServer() {
+  let client;
+  try {
+    client = new ApiClient();
+  } catch (e) {
+    logInfo(`MCP: ApiClient init failed: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  process.stdin.setEncoding("utf8");
+  let buffer = "";
+  const handle = async (req) => {
+    switch (req.method) {
+      case "initialize":
+        return {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: "rogeriq", version: "0.1.0" }
+        };
+      case "notifications/initialized":
+        return void 0;
+      case "tools/list":
+        return {
+          tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema
+          }))
+        };
+      case "tools/call": {
+        const name = req.params?.["name"] ?? "";
+        const args = req.params?.["arguments"] ?? {};
+        const tool = tools.find((t) => t.name === name);
+        if (!tool) {
+          return {
+            content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            isError: true
+          };
+        }
+        if (!client) {
+          return {
+            content: [{ type: "text", text: "No API key. Set RIQ_API_KEY env var or run `rogeriq auth login`." }],
+            isError: true
+          };
+        }
+        try {
+          const result = await tool.call(client, args);
+          return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+          };
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return {
+            content: [{ type: "text", text: `Error: ${msg}` }],
+            isError: true
+          };
+        }
+      }
+      case "ping":
+        return {};
+      default:
+        throw rpcError(-32601, `Method not found: ${req.method}`);
+    }
+  };
+  process.stdin.on("data", (chunk) => {
+    buffer += chunk;
+    let idx;
+    while ((idx = buffer.indexOf("\n")) >= 0) {
+      const line = buffer.slice(0, idx).trim();
+      buffer = buffer.slice(idx + 1);
+      if (!line) continue;
+      void processLine(line, handle);
+    }
+  });
+  process.stdin.on("end", () => process.exit(0));
+  await new Promise(() => {
+  });
+}
+async function processLine(line, handle) {
+  let req;
+  try {
+    req = JSON.parse(line);
+  } catch {
+    return;
+  }
+  try {
+    const result = await handle(req);
+    if (req.id !== void 0 && req.id !== null && result !== void 0) {
+      respond({ jsonrpc: "2.0", id: req.id, result });
+    }
+  } catch (e) {
+    const err = e;
+    if (req.id !== void 0 && req.id !== null) {
+      respond({
+        jsonrpc: "2.0",
+        id: req.id,
+        error: { code: err.code ?? -32603, message: err.message ?? "Internal error" }
+      });
+    }
+  }
+}
+function respond(msg) {
+  process.stdout.write(JSON.stringify(msg) + "\n");
+}
+function rpcError(code, message) {
+  const err = new Error(message);
+  err.code = code;
+  return err;
+}
+
+// src/commands/index.ts
+var commands = {
+  auth,
+  config,
+  orgs,
+  projects,
+  keys,
+  conversations,
+  messages,
+  contacts,
+  agent,
+  kb,
+  widget,
+  integrations,
+  forms,
+  beacons,
+  webhooks,
+  analytics,
+  status,
+  mcp
+};
+
+// src/index.ts
+var GLOBAL_FLAGS = [
+  { name: "json", type: "boolean" },
+  { name: "quiet", alias: "q", type: "boolean" },
+  { name: "help", alias: "h", type: "boolean" },
+  { name: "version", alias: "v", type: "boolean" },
+  { name: "project", type: "string" }
+];
+var VERSION = "0.1.0";
+async function main() {
+  const argv = process.argv.slice(2);
+  const { positional, flags } = parseArgs(argv, GLOBAL_FLAGS);
+  setOutputOpts({
+    json: flagBool(flags, "json"),
+    quiet: flagBool(flags, "quiet")
+  });
+  if (flagBool(flags, "version")) {
+    process.stdout.write(`rogeriq ${VERSION}
+`);
+    return;
+  }
+  if (positional.length === 0 || flagBool(flags, "help")) {
+    printRootHelp();
+    return;
+  }
+  const [groupName, ...rest] = positional;
+  if (!groupName) {
+    printRootHelp();
+    process.exit(1);
+  }
+  const group = commands[groupName];
+  if (!group) {
+    process.stderr.write(`Unknown command: ${groupName}
+`);
+    printRootHelp();
+    process.exit(1);
+  }
+  const [subName, ...subArgs] = rest;
+  const cmd = subName && group.subcommands[subName] || group.subcommands["_default"];
+  if (!cmd) {
+    printGroupHelp(groupName, group);
+    process.exit(1);
+  }
+  const cmdArgsRaw = subName && group.subcommands[subName] ? subArgs : rest;
+  const cmdParsed = parseArgs(cmdArgsRaw, [...GLOBAL_FLAGS, ...cmd.flags ?? []]);
+  const project = flagString(cmdParsed.flags, "project") ?? flagString(flags, "project");
+  if (project) cmdParsed.flags["project"] = project;
+  if (flagBool(cmdParsed.flags, "help")) {
+    printCommandHelp(groupName, subName ?? "", cmd);
+    return;
+  }
+  try {
+    await cmd.run(cmdParsed);
+  } catch (e) {
+    if (e instanceof CliError) {
+      logError(e);
+      process.exit(e.exitCode);
+    }
+    if (e instanceof Error) {
+      logError(e);
+      process.exit(1);
+    }
+    process.stderr.write(String(e) + "\n");
+    process.exit(1);
+  }
+}
+function printRootHelp() {
+  const lines = [
+    `rogeriq ${VERSION} \u2014 RogerIQ CLI`,
+    "",
+    "Usage:",
+    "  rogeriq <command> <subcommand> [options]",
+    "",
+    "Commands:"
+  ];
+  for (const [name, group] of Object.entries(commands)) {
+    lines.push(`  ${name.padEnd(16)} ${group.summary}`);
+  }
+  lines.push(
+    "",
+    "Global flags:",
+    "  --json           Machine-readable JSON output (auto-enabled when piped)",
+    "  --quiet, -q      Print only IDs",
+    "  --project <id>   Override project ID for this command",
+    "  --help, -h       Show help",
+    "  --version, -v    Show version",
+    "",
+    "Auth:",
+    "  rogeriq auth login --api-key riq_xxx",
+    "  RIQ_API_KEY=riq_xxx rogeriq conversations list",
+    "",
+    "AI agents: see AGENTS.md or run `rogeriq mcp` for an MCP server."
+  );
+  process.stdout.write(lines.join("\n") + "\n");
+}
+function printGroupHelp(name, group) {
+  const lines = [`rogeriq ${name} \u2014 ${group.summary}`, "", "Subcommands:"];
+  for (const [subName, cmd] of Object.entries(group.subcommands)) {
+    if (subName === "_default") continue;
+    lines.push(`  ${subName.padEnd(16)} ${cmd.summary ?? ""}`);
+  }
+  process.stdout.write(lines.join("\n") + "\n");
+}
+function printCommandHelp(group, sub, cmd) {
+  const lines = [`rogeriq ${group} ${sub} \u2014 ${cmd.summary ?? ""}`];
+  if (cmd.usage) lines.push("", `Usage: ${cmd.usage}`);
+  if (cmd.flags?.length) {
+    lines.push("", "Flags:");
+    for (const f of cmd.flags) {
+      lines.push(`  --${f.name}${f.alias ? `, -${f.alias}` : ""}  (${f.type ?? "boolean"})`);
+    }
+  }
+  if (cmd.examples?.length) {
+    lines.push("", "Examples:");
+    for (const ex of cmd.examples) lines.push(`  ${ex}`);
+  }
+  process.stdout.write(lines.join("\n") + "\n");
+}
+main();