podcast-guest-crm-cli 0.1.0

package/bin/podcast-guest-crm-cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,524 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { readFileSync as readFileSync2 } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join as join2 } from "path";
+
+// src/lib/config.ts
+import { mkdirSync, readFileSync, writeFileSync, existsSync, chmodSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CONFIG_DIR_NAME = "podcast-guest-crm-cli";
+function getConfigDir() {
+  return join(homedir(), ".config", CONFIG_DIR_NAME);
+}
+function getCredentialsPath() {
+  return join(getConfigDir(), "credentials.json");
+}
+function saveCredentials(creds) {
+  const dir = getConfigDir();
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true, mode: 448 });
+  }
+  const path = getCredentialsPath();
+  writeFileSync(path, JSON.stringify(creds, null, 2), { mode: 384 });
+  chmodSync(path, 384);
+}
+function loadCredentials() {
+  const path = getCredentialsPath();
+  if (!existsSync(path)) return null;
+  try {
+    const raw = readFileSync(path, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function loadCliConfig() {
+  return {
+    apiUrl: process.env.PODCAST_GUEST_CRM_API_URL ?? "http://localhost:3001/api/v1",
+    supabaseUrl: process.env.PODCAST_GUEST_CRM_SUPABASE_URL,
+    supabaseAnonKey: process.env.PODCAST_GUEST_CRM_SUPABASE_ANON_KEY
+  };
+}
+
+// src/lib/supabase-auth.ts
+var SupabaseAuthError = class extends Error {
+};
+function tokenUrl(supabaseUrl) {
+  return `${supabaseUrl.replace(/\/+$/, "")}/auth/v1/token`;
+}
+async function requestToken(supabaseUrl, anonKey, grantType, body) {
+  const res = await fetch(`${tokenUrl(supabaseUrl)}?grant_type=${grantType}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      apikey: anonKey
+    },
+    body: JSON.stringify(body)
+  });
+  const json = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const message = json.error_description ?? json.msg ?? json.error ?? `HTTP ${res.status}`;
+    throw new SupabaseAuthError(message);
+  }
+  return json;
+}
+async function signInWithPassword(supabaseUrl, anonKey, email, password) {
+  const json = await requestToken(supabaseUrl, anonKey, "password", { email, password });
+  if (!json.access_token || !json.refresh_token) {
+    throw new SupabaseAuthError("Supabase did not return an access token.");
+  }
+  return {
+    accessToken: json.access_token,
+    refreshToken: json.refresh_token,
+    expiresAt: Math.floor(Date.now() / 1e3) + json.expires_in,
+    email: json.user?.email ?? email
+  };
+}
+async function refreshSession(supabaseUrl, anonKey, refreshToken, fallbackEmail) {
+  const json = await requestToken(supabaseUrl, anonKey, "refresh_token", {
+    refresh_token: refreshToken
+  });
+  if (!json.access_token || !json.refresh_token) {
+    throw new SupabaseAuthError("Supabase did not return a refreshed access token.");
+  }
+  return {
+    accessToken: json.access_token,
+    refreshToken: json.refresh_token,
+    expiresAt: Math.floor(Date.now() / 1e3) + json.expires_in,
+    email: json.user?.email ?? fallbackEmail
+  };
+}
+
+// src/lib/prompt.ts
+import { createInterface } from "readline";
+function promptText(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+var CTRL_C = "";
+var CTRL_D = "";
+var BACKSPACE = "\x7F";
+function promptPassword(question) {
+  if (!process.stdin.isTTY) {
+    return promptText(question);
+  }
+  return new Promise((resolve) => {
+    process.stdout.write(question);
+    const stdin = process.stdin;
+    let password = "";
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    const onData = (char) => {
+      if (char === "\n" || char === "\r" || char === CTRL_D) {
+        stdin.setRawMode(false);
+        stdin.pause();
+        stdin.removeListener("data", onData);
+        process.stdout.write("\n");
+        resolve(password);
+        return;
+      }
+      if (char === CTRL_C) {
+        process.stdout.write("\n");
+        process.exit(130);
+      }
+      if (char === BACKSPACE || char === "\b") {
+        password = password.slice(0, -1);
+        return;
+      }
+      password += char;
+    };
+    stdin.on("data", onData);
+  });
+}
+
+// src/lib/api-client.ts
+var CliError = class extends Error {
+  constructor(message, statusCode, details) {
+    super(message);
+    this.statusCode = statusCode;
+    this.details = details;
+    this.name = "CliError";
+  }
+  statusCode;
+  details;
+};
+var NotLoggedInError = class extends CliError {
+  constructor() {
+    super("Not logged in. Run `podcast-guest-crm-cli login` first.");
+    this.name = "NotLoggedInError";
+  }
+};
+var EXPIRY_BUFFER_SECONDS = 30;
+async function getValidAccessToken() {
+  const creds = loadCredentials();
+  if (!creds || !creds.accessToken) {
+    throw new NotLoggedInError();
+  }
+  const now = Math.floor(Date.now() / 1e3);
+  if (creds.expiresAt - EXPIRY_BUFFER_SECONDS > now) {
+    return creds.accessToken;
+  }
+  const refreshed = await refreshSession(
+    creds.supabaseUrl,
+    creds.supabaseAnonKey,
+    creds.refreshToken,
+    creds.email
+  );
+  saveCredentials({
+    accessToken: refreshed.accessToken,
+    refreshToken: refreshed.refreshToken,
+    expiresAt: refreshed.expiresAt,
+    email: refreshed.email,
+    supabaseUrl: creds.supabaseUrl,
+    supabaseAnonKey: creds.supabaseAnonKey
+  });
+  return refreshed.accessToken;
+}
+async function apiRequest(path, options = {}) {
+  const { apiUrl } = loadCliConfig();
+  const accessToken = await getValidAccessToken();
+  const url = new URL(`${apiUrl.replace(/\/+$/, "")}${path}`);
+  if (options.query) {
+    for (const [key, value] of Object.entries(options.query)) {
+      if (value !== void 0) url.searchParams.set(key, String(value));
+    }
+  }
+  const init = {
+    method: options.method ?? "GET",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${accessToken}`
+    }
+  };
+  if (options.body !== void 0) {
+    init.body = JSON.stringify(options.body);
+  }
+  const res = await fetch(url, init);
+  if (res.status === 204) {
+    return void 0;
+  }
+  const json = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const errBody = json;
+    throw new CliError(
+      errBody.message ?? `Request failed with status ${res.status}`,
+      res.status,
+      json
+    );
+  }
+  return json;
+}
+
+// src/lib/output.ts
+function printJson(data) {
+  process.stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+}
+function printError(err, json) {
+  const message = err instanceof Error ? err.message : String(err);
+  const statusCode = err instanceof CliError ? err.statusCode : void 0;
+  if (json) {
+    printJson({ error: err instanceof Error ? err.name : "Error", message, statusCode });
+  } else {
+    process.stderr.write(`Error: ${message}
+`);
+  }
+  process.exitCode = 1;
+  return void 0;
+}
+function printTable(rows, columns) {
+  if (rows.length === 0) {
+    process.stdout.write("No results.\n");
+    return;
+  }
+  const widths = columns.map(
+    (col) => Math.max(col.length, ...rows.map((row) => (row[col] ?? "").length))
+  );
+  const renderRow = (cells) => cells.map((cell, i) => cell.padEnd(widths[i] ?? 0)).join("  ");
+  process.stdout.write(`${renderRow(columns)}
+`);
+  process.stdout.write(`${widths.map((w) => "-".repeat(w)).join("  ")}
+`);
+  for (const row of rows) {
+    process.stdout.write(`${renderRow(columns.map((col) => row[col] ?? ""))}
+`);
+  }
+}
+
+// src/commands/login.ts
+function registerLoginCommand(program2) {
+  program2.command("login").description(
+    "Log in with your Podcast Guest CRM email and password. Authenticates directly against Supabase (the same identity provider the web app uses) and caches the session to ~/.config/podcast-guest-crm-cli/credentials.json."
+  ).option("-e, --email <email>", "Account email (prompted if omitted)").option("-p, --password <password>", "Account password (prompted if omitted; prefer the prompt over this flag on shared machines)").option(
+    "--supabase-url <url>",
+    "Supabase project URL (or set PODCAST_GUEST_CRM_SUPABASE_URL)"
+  ).option(
+    "--supabase-anon-key <key>",
+    "Supabase anon/public API key (or set PODCAST_GUEST_CRM_SUPABASE_ANON_KEY)"
+  ).action(async (opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const cliConfig = loadCliConfig();
+      const supabaseUrl = opts.supabaseUrl ?? cliConfig.supabaseUrl;
+      const supabaseAnonKey = opts.supabaseAnonKey ?? cliConfig.supabaseAnonKey;
+      if (!supabaseUrl || !supabaseAnonKey) {
+        throw new Error(
+          "Missing Supabase project config. Pass --supabase-url and --supabase-anon-key, or set PODCAST_GUEST_CRM_SUPABASE_URL / PODCAST_GUEST_CRM_SUPABASE_ANON_KEY. These match the NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY values your Podcast Guest CRM deployment already uses."
+        );
+      }
+      const email = opts.email ?? await promptText("Email: ");
+      const password = opts.password ?? await promptPassword("Password: ");
+      const session = await signInWithPassword(supabaseUrl, supabaseAnonKey, email, password);
+      saveCredentials({
+        accessToken: session.accessToken,
+        refreshToken: session.refreshToken,
+        expiresAt: session.expiresAt,
+        email: session.email,
+        supabaseUrl,
+        supabaseAnonKey
+      });
+      if (json) {
+        printJson({ loggedIn: true, email: session.email });
+      } else {
+        process.stdout.write(`Logged in as ${session.email}
+`);
+      }
+    } catch (err) {
+      if (err instanceof SupabaseAuthError) {
+        printError(new Error(`Login failed: ${err.message}`), json);
+        return;
+      }
+      printError(err, json);
+    }
+  });
+}
+
+// src/commands/guest.ts
+var STAGES = ["discover", "outreach", "scheduled", "recorded", "published", "follow_up"];
+var PRIORITIES = ["low", "medium", "high"];
+function registerGuestCommands(program2) {
+  const guest = program2.command("guest").description("Manage guests in the pipeline (GET/POST/PATCH /api/v1/guests)");
+  guest.command("list").description("List guests, paginated and filterable. Wraps GET /api/v1/guests").option("--page <page>", "Page number (default 1)").option("--limit <limit>", "Results per page, max 100 (default 20)").option("--stage <stage>", `Filter by stage: ${STAGES.join(", ")}`).option("--priority <priority>", `Filter by priority: ${PRIORITIES.join(", ")}`).option("--search <search>", "Free-text search").action(async (opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest("/guests", {
+        query: {
+          page: opts.page,
+          limit: opts.limit,
+          stage: opts.stage,
+          priority: opts.priority,
+          search: opts.search
+        }
+      });
+      if (json) {
+        printJson(res);
+        return;
+      }
+      printTable(
+        res.data.map((g) => ({
+          id: g.id,
+          name: g.name,
+          company: g.company,
+          stage: g.stage,
+          priority: g.priority,
+          fitScore: String(g.fitScore)
+        })),
+        ["id", "name", "company", "stage", "priority", "fitScore"]
+      );
+      process.stdout.write(`
+${res.meta.total} total \xB7 page ${res.meta.page} \xB7 limit ${res.meta.limit}
+`);
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+  guest.command("show <id>").description("Get full detail for a single guest, wraps GET /api/v1/guests/:id").action(async (id, _opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest(`/guests/${encodeURIComponent(id)}`);
+      if (json) {
+        printJson(res);
+      } else {
+        printJson(res.data);
+      }
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+  guest.command("add").description(
+    "Create a new guest, wraps POST /api/v1/guests. Fit scoring runs asynchronously after creation. Fetch the guest again shortly after to see fitScore populate."
+  ).requiredOption("--name <name>", "Guest full name").requiredOption("--email <email>", "Guest email").requiredOption("--title <title>", "Guest job title").requiredOption("--company <company>", "Guest company").option("--bio <bio>", "Short bio (max 2000 chars)").option("--topics <topics>", 'Comma-separated topics, e.g. "AI,startups"').option("--priority <priority>", `One of: ${PRIORITIES.join(", ")}`).action(async (opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest("/guests", {
+        method: "POST",
+        body: {
+          name: opts.name,
+          email: opts.email,
+          title: opts.title,
+          company: opts.company,
+          bio: opts.bio,
+          topics: opts.topics ? opts.topics.split(",").map((t) => t.trim()).filter(Boolean) : void 0,
+          priority: opts.priority
+        }
+      });
+      if (json) {
+        printJson(res);
+      } else if (res.data?.id) {
+        process.stdout.write(`Created guest ${res.data.id} (${res.data.name})
+`);
+      } else {
+        printJson(res);
+      }
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+  guest.command("stage <id> <newStage>").description(
+    "Transition a guest to a new lifecycle stage, wraps PATCH /api/v1/guests/:id/stage. Valid paths: discover -> outreach -> scheduled -> recorded -> published -> follow_up, with back-transitions outreach -> discover (declined), scheduled -> outreach (reschedule), recorded -> scheduled (re-record), follow_up -> outreach (invite back) or follow_up -> published. Invalid transitions are rejected by the API, not this CLI."
+  ).option("--reason <reason>", "Optional reason recorded with the transition").action(async (id, newStage, opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest(`/guests/${encodeURIComponent(id)}/stage`, {
+        method: "PATCH",
+        body: { stage: newStage, reason: opts.reason }
+      });
+      if (json) {
+        printJson(res);
+      } else if (res.data?.stage) {
+        process.stdout.write(`${res.data.name} is now in stage: ${res.data.stage}
+`);
+      } else {
+        printJson(res);
+      }
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+}
+
+// src/commands/outreach.ts
+function registerOutreachCommands(program2) {
+  const outreach = program2.command("outreach").description("AI-assisted outreach email drafting (/api/v1/outreach)");
+  outreach.command("draft <guestId>").description(
+    "Generate an AI outreach email draft for a guest, wraps POST /api/v1/outreach/draft. Uses claude-sonnet-4-6 server-side (packages/ai). Returns subject, body, a confidence score, and the reasoning behind the draft."
+  ).option("--episode-angle <angle>", "Suggested angle for the episode").option("--recent-work <work>", "Reference to the guest's recent work").action(async (guestId, opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest("/outreach/draft", {
+        method: "POST",
+        body: {
+          guestId,
+          episodeAngle: opts.episodeAngle,
+          recentWork: opts.recentWork
+        }
+      });
+      if (json || !res.data?.subject) {
+        printJson(res);
+        return;
+      }
+      const { subject, body, confidenceScore, reasoning } = res.data;
+      process.stdout.write(`Subject: ${subject}
+
+${body}
+
+`);
+      process.stdout.write(`Confidence: ${confidenceScore}
+Reasoning: ${reasoning}
+`);
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+}
+
+// src/commands/analytics.ts
+function registerAnalyticsCommands(program2) {
+  const analytics = program2.command("analytics").description("Pipeline metrics (/api/v1/analytics)");
+  analytics.command("summary").description(
+    "Dashboard overview: total guests, stage breakdown, average fit score, reply and booking conversion rates, top topics, recent activity. Wraps GET /api/v1/analytics/overview."
+  ).action(async (_opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest("/analytics/overview");
+      if (json) {
+        printJson(res);
+        return;
+      }
+      const d = res.data;
+      process.stdout.write(`Total guests: ${d.totalGuests}
+`);
+      process.stdout.write(`Average fit score: ${d.avgFitScore}
+`);
+      process.stdout.write(`Outreach reply rate: ${(d.outreachReplyRate * 100).toFixed(1)}%
+`);
+      process.stdout.write(`Booking conversion rate: ${(d.bookingConversionRate * 100).toFixed(1)}%
+
+`);
+      process.stdout.write("By stage:\n");
+      const stageEntries = Object.entries(d.byStage ?? {});
+      if (stageEntries.length === 0) {
+        process.stdout.write("  (none returned)\n");
+      }
+      for (const [stage, count] of stageEntries) {
+        process.stdout.write(`  ${stage.padEnd(12)} ${count}
+`);
+      }
+      if (d.topTopics.length > 0) {
+        process.stdout.write("\nTop topics:\n");
+        for (const t of d.topTopics) {
+          process.stdout.write(`  ${t.topic}: ${t.count}
+`);
+        }
+      }
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+  analytics.command("pipeline").description(
+    "Stage-by-stage conversion funnel, outreach activity timeline, and topic breakdown. Wraps GET /api/v1/analytics/pipeline."
+  ).action(async (_opts, cmd) => {
+    const json = Boolean(cmd.optsWithGlobals().json);
+    try {
+      const res = await apiRequest("/analytics/pipeline");
+      printJson(res);
+    } catch (err) {
+      printError(err, json);
+    }
+  });
+}
+
+// src/index.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function readVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync2(join2(__dirname, "..", "package.json"), "utf-8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+var program = new Command();
+program.name("podcast-guest-crm-cli").description(
+  "Command-line client for Podcast Guest CRM. Manage the guest lifecycle (discover -> outreach -> scheduled -> recorded -> published -> follow_up), draft AI outreach emails, and pull pipeline analytics, from a terminal or an agent."
+).version(readVersion()).option("--json", "Output machine-readable JSON instead of human-formatted text (every data-returning command supports this)");
+registerLoginCommand(program);
+registerGuestCommands(program);
+registerOutreachCommands(program);
+registerAnalyticsCommands(program);
+program.parseAsync(process.argv).catch((err) => {
+  const message = err instanceof Error ? err.message : String(err);
+  process.stderr.write(`Error: ${message}
+`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "podcast-guest-crm-cli",
+  "version": "0.1.0",
+  "description": "Command-line client for Podcast Guest CRM: manage the guest lifecycle (discover, outreach, scheduled, recorded, published, follow_up), draft AI outreach emails, and pull pipeline analytics from your terminal or an agent.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "podcast-guest-crm-cli": "./bin/podcast-guest-crm-cli.js",
+    "pgcrm": "./bin/podcast-guest-crm-cli.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --target node20",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "podcast",
+    "guest-crm",
+    "cli",
+    "outreach",
+    "supabase",
+    "fastify",
+    "agent-native"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Rudrendu Paul",
+  "contributors": [
+    "Sourav Nandy"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RudrenduPaul/podcast-guest-crm.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/RudrenduPaul/podcast-guest-crm#readme",
+  "bugs": {
+    "url": "https://github.com/RudrenduPaul/podcast-guest-crm/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.2",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0",
+    "@types/node": "^20.0.0"
+  }
+}