careervivid 1.12.50 → 2.0.0

package/README.md

@@ -1,10 +1,11 @@
 # careervivid · CLI
 
-> **Your AI-powered career terminal — autonomous job applications, resume editing, job pipeline tracking, and portfolio publishing from the command line.**
+> **Your AI-powered career terminal — voice mock interviews, autonomous job applications, resume editing, job pipeline tracking, and portfolio publishing from the command line.**
 
 [![npm version](https://img.shields.io/npm/v/careervivid?color=0ea5e9&label=careervivid)](https://www.npmjs.com/package/careervivid)
 [![License: MIT](https://img.shields.io/badge/license-MIT-brightgreen)](LICENSE)
 [![Node ≥18](https://img.shields.io/badge/node-%3E%3D18-blue)](https://nodejs.org)
+[![v2.0](https://img.shields.io/badge/version-2.0-6366f1?logo=sparkles)](https://www.npmjs.com/package/careervivid)
 
 ---
 
@@ -12,6 +13,7 @@
 
 - [Quick Start](#quick-start)
 - [Commands](#commands)
+  - [cv interview](#cv-interview) 🎙 **AI Voice Interview**
   - [cv agent](#cv-agent) ⭐ **AI Agent**
   - [cv agent --jobs](#cv-agent---jobs) 🤖 **Autonomous Job Applications**
   - [cv agent --resume](#cv-agent---resume) 📄 **Resume CRUD**
@@ -40,18 +42,20 @@ npm install -g careervivid
 
 # 2. Log in and get your free API key
 cv login
-# → opens careervivid.app/developer in your browser
-# → copy your API key, then:
-cv auth set-key cv_live_YOUR_KEY_HERE
+# → opens careervivid.app in your browser
+# → authenticate once, API key is saved automatically
+
+# 3. Practice an interview with voice AI
+cv interview
 
-# 3. Start the AI agent
+# 4. Start the AI agent
 cv agent
 
-# 4. Or jump straight into job-hunting mode
+# 5. Or jump straight into job-hunting mode
 cv agent --jobs
 ```
 
-> **Free tier includes 100 AI credits/month** — no credit card required.
+> **Free tier includes 10 AI credits/month** — no credit card required.
 
 ---
 
@@ -59,6 +63,50 @@ cv agent --jobs
 
 ---
 
+### `cv interview`
+
+**AI-powered voice mock interview** using the Gemini Live API. Vivid, your AI interviewer, conducts a real-time spoken interview tailored to the role you specify. After the session, you receive an auto-generated feedback report with scores and actionable improvement tips.
+
+```bash
+cv interview                               # interactive role prompt, voice mode
+cv interview --role "Senior Software Engineer"
+cv interview --role "Product Manager" --text   # text-only fallback (no mic needed)
+cv interview --role "SDE" --resume <id>        # load your resume for context
+cv interview --questions 7                     # custom question count (default 5)
+```
+
+**Requirements (voice mode):**
+- `sox` for audio I/O — install once:
+  ```bash
+  # macOS
+  brew install sox
+  # Ubuntu / Debian
+  sudo apt install sox
+  ```
+
+**How it works:**
+
+1. Vivid generates tailored interview questions using your role (and resume, if provided)
+2. A real-time voice session opens — speak your answers naturally
+3. Vivid asks follow-up questions and adapts to your responses
+4. Press **Ctrl+C** at any time to end
+5. A structured feedback report is generated covering:
+   - Overall, communication, confidence, and relevance scores (0–100)
+   - Specific strengths and areas for improvement
+
+**Credit cost:** **2 credits/minute** (minimum 2, maximum 60 per session)
+
+| Session length | Credits |
+|---|---|
+| < 1 min | 2 |
+| 5 min | 10 |
+| 10 min | 20 |
+| 30 min+ | 60 (cap) |
+
+> Credits are only charged after the session ends — never upfront.
+
+---
+
 ### `cv agent`
 
 An **autonomous AI agent** that runs interactively in your terminal. Choose from CareerVivid Cloud (credits deducted from your account) or Bring Your Own API Key.
@@ -294,7 +342,7 @@ CV_API_KEY=cv_live_YOUR_KEY_HERE cv publish article.md
 
 ### `cv login`
 
-Open the CareerVivid sign-in page and interactively save your API key.
+Open the CareerVivid sign-in page and automatically save your API key.
 
 ```bash
 cv login
@@ -336,17 +384,20 @@ cv config set llmModel gpt-4o
 
 | Plan | Credits / Month | Price |
 |---|---|---|
-| **Free** | 100 credits | $0 |
+| **Free** | 10 credits | $0 |
 | **Pro** | 1,000 credits | Paid |
 | **Max** | 10,000 credits | Paid |
 
-**Credit costs per agent turn:**
+**Credit costs by feature:**
 
-| Model | Credits |
+| Feature | Credits |
 |---|---|
-| `gemini-3.1-flash-lite-preview` | 0.5 cr |
-| `gemini-2.5-flash` | 1 cr |
+| `cv interview` (voice) | 2 credits/min (min 2, max 60) |
+| `gemini-3.1-flash-lite-preview` agent turn | 0.5 cr |
+| `gemini-2.5-flash` agent turn | 1 cr |
 | `gemini-3.1-pro-preview` (`--pro`) | 2 cr |
+| Resume tailor | 2 cr |
+| Job evaluation | 3 cr |
 
 > **Bring Your Own Key:** Using `--provider openai` (or any non-CareerVivid provider) deducts **zero credits** — you pay your provider directly.
 
@@ -462,12 +513,13 @@ echo "# My Architecture\n\nExplains the new service..." \
 You have access to the `cv` CLI tool.
 
 Available commands:
-- cv publish <file>               Publish an article (private by default, use --public to share)
-- cv agent --resume               Resume CRUD: read, update fields, tailor
-- cv agent --jobs                 Job hunting + autonomous apply
-- cv jobs hunt --role "..."       AI job search
-- cv jobs apply <url>             Autonomous form filling (stops before submit)
-- cv jobs list                    View job tracker
+- cv interview                        AI voice interview (requires sox)
+- cv publish <file>                   Publish an article (private by default, use --public to share)
+- cv agent --resume                   Resume CRUD: read, update fields, tailor
+- cv agent --jobs                     Job hunting + autonomous apply
+- cv jobs hunt --role "..."           AI job search
+- cv jobs apply <url>                 Autonomous form filling (stops before submit)
+- cv jobs list                        View job tracker
 
 Rules:
 1. Never include real API keys in published content.
@@ -500,6 +552,20 @@ cv auth check
 CV_API_KEY=cv_live_YOUR_KEY cv publish article.md
 ```
 
+**`cv interview` — no audio / can't hear Vivid**
+```bash
+# Install sox first:
+brew install sox          # macOS
+sudo apt install sox      # Ubuntu/Debian
+
+# Then retry:
+cv interview
+```
+
+**`cv interview` — hearing echo / Vivid repeating itself**
+
+This can occur if your microphone picks up the speaker output. The CLI uses half-duplex mute suppression (mic is muted while Vivid is speaking). Use headphones for the best experience.
+
 **`browser_sidecar.py not found`**
 ```bash
 # browser-use is not set up. Follow the browser-use Setup section above.

package/dist/agent/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,aAAa,QAalB,CAAC;AAMT,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAqCnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QAwCvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA2CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAiBtB,CAAC;AAOT;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAkCT"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,aAAa,QAalB,CAAC;AAMT,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAqCnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QAgDvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA4CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAkBtB,CAAC;AAOT;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAkCT"}

package/dist/agent/instructions.js

@@ -127,6 +127,14 @@ These tools read/write the Firebase Kanban board at careervivid.app/job-tracker.
 - **verify_url**             — Verify a single link is alive before sharing it.
 - **verify_job_urls**        — Verify all URLs from a search_jobs result batch.
 NEVER share a link without verifying it first.
+
+### 🎙 AI Voice Interview
+- **start_interview** ⭐ — Launch a live AI mock interview session directly in the terminal.
+  - Vivid (the AI interviewer) asks tailored questions based on the role and user's resume.
+  - User speaks answers (voice mode, requires sox) or types them (text mode).
+  - Feedback report auto-generated at the end with scores and improvement tips.
+  - **Credit cost:** 2 credits/minute (min 2, max 60). Text mode ~1 credit flat.
+  - Use when user says: "practice interview", "mock interview", "interview me for [role]", "I have an interview at [company]", etc.
 `.trim();
 // ---------------------------------------------------------------------------
 // §5 — Autonomous execution harness (appended in --jobs mode)
@@ -174,6 +182,7 @@ If it does, call tracker_update_job instead — never create a duplicate row.
 | view saved openings                           | openings_list                  |
 | applied to a specific opening                 | openings_apply                 |
 | find NEW companies/roles not yet in tracker   | get_resume → search_jobs       |
+| practice interview, mock interview, interview me | start_interview             |
 `.trim();
 // ---------------------------------------------------------------------------
 // §6 — Greeting protocol (shared across modes)
@@ -189,6 +198,7 @@ When the user sends a generic greeting ("hey", "hi", "hello", "start"), respond
 • 🔍 Search for job opportunities
 • 📊 Check my job pipeline / tracker
 • ✉️  Draft a cover letter or tailor my resume
+• 🎙  Start an AI mock interview (voice or text)
 • 📈 Get an overview of my job search progress
 • 🗓️  Pick up where we left off
 

package/dist/agent/tools/interview.d.ts

@@ -0,0 +1,13 @@
+/**
+ * start_interview tool — launches a live `cv interview` session
+ * from within the agent REPL.
+ *
+ * The tool spawns the interview subprocess with the terminal attached
+ * (stdio: "inherit") so the user gets the full interactive voice/text
+ * experience without leaving the agent session.  When the interview ends
+ * the agent picks up again and can discuss results, next steps, etc.
+ */
+import { Tool } from "../Tool.js";
+export declare const StartInterviewTool: Tool;
+export declare const ALL_INTERVIEW_TOOLS: Tool[];
+//# sourceMappingURL=interview.d.ts.map

package/dist/agent/tools/interview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interview.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/interview.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA4DlC,eAAO,MAAM,kBAAkB,EAAE,IAwDhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,IAAI,EAAyB,CAAC"}

package/dist/agent/tools/interview.js

@@ -0,0 +1,106 @@
+/**
+ * start_interview tool — launches a live `cv interview` session
+ * from within the agent REPL.
+ *
+ * The tool spawns the interview subprocess with the terminal attached
+ * (stdio: "inherit") so the user gets the full interactive voice/text
+ * experience without leaving the agent session.  When the interview ends
+ * the agent picks up again and can discuss results, next steps, etc.
+ */
+import { spawn } from "child_process";
+import { Type } from "@google/genai";
+/** Resolve the `cv` binary that is currently running this process. */
+function getCvBin() {
+    // process.argv[1] is the entry-point JS file.
+    // When installed globally via npm, `cv` is a shell wrapper that calls
+    // the same binary — we can just re-use process.argv[0] (node) + argv[1].
+    // But the cleanest approach is to call the same node + script directly.
+    return process.argv[1]; // absolute path to dist/index.js
+}
+async function runInterview(args) {
+    return new Promise((resolve) => {
+        const argv = [
+            getCvBin(),
+            "interview",
+            "--role", args.role,
+        ];
+        if (args.mode === "text")
+            argv.push("--text");
+        if (args.questions && args.questions > 0) {
+            argv.push("--questions", String(args.questions));
+        }
+        if (args.resume_id)
+            argv.push("--resume", args.resume_id);
+        // Inherit the terminal so the full interactive TUI works.
+        const child = spawn(process.execPath, argv, {
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve(`✅ Interview session for "${args.role}" completed.\n` +
+                    `The user has received their feedback report above.\n` +
+                    `You may now discuss their performance, suggest areas for improvement, ` +
+                    `help them prep specific STAR stories, or start another session.`);
+            }
+            else {
+                resolve(`⚠️  Interview session ended with exit code ${code ?? "unknown"}.\n` +
+                    `This is normal if the user pressed Ctrl+C to end early. ` +
+                    `Ask if they'd like to start another session or discuss their responses.`);
+            }
+        });
+        child.on("error", (err) => {
+            resolve(`❌ Failed to launch interview session: ${err.message}`);
+        });
+    });
+}
+export const StartInterviewTool = {
+    name: "start_interview",
+    description: `Launch a live AI mock interview session for the user.
+
+Use this tool when the user says ANYTHING like:
+- "Start an interview", "practice interview", "mock interview"
+- "Interview me for [role]", "prep me for [company] interview"
+- "I have an interview at [company], let's practice"
+- "Start a voice interview", "text interview"
+
+HOW IT WORKS:
+- Launches the full interactive \`cv interview\` session directly in the terminal.
+- The user speaks (voice mode) or types (text mode) their answers to Vivid, the AI interviewer.
+- At the end, a feedback report with scores and improvement tips is displayed automatically.
+- You (the agent) can then discuss results, coach on weak areas, help build STAR stories, etc.
+
+CREDIT COST: 2 credits/minute (minimum 2, capped at 60). Text mode uses ~1 credit flat.
+
+DEFAULTS:
+- mode defaults to "voice" (requires sox). Suggest "text" if user is on a server / no mic.
+- questions defaults to 5.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            role: {
+                type: Type.STRING,
+                description: "The job role to interview for, e.g. 'Senior Software Engineer', 'Product Manager', 'Data Scientist'.",
+            },
+            mode: {
+                type: Type.STRING,
+                enum: ["voice", "text"],
+                description: "Interview mode. 'voice' = real-time speech (default, requires sox). 'text' = text-only fallback.",
+            },
+            questions: {
+                type: Type.INTEGER,
+                description: "Number of interview questions to generate (1–10). Default: 5.",
+            },
+            resume_id: {
+                type: Type.STRING,
+                description: "Optional. CareerVivid resume ID to load as context. The AI will tailor questions to the user's actual background.",
+            },
+        },
+        required: ["role"],
+    },
+    requiresConfirmation: false,
+    execute: async (args) => {
+        return runInterview(args);
+    },
+};
+export const ALL_INTERVIEW_TOOLS = [StartInterviewTool];

package/dist/commands/admin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * cv admin — Admin-only commands: log inspection, audit, diagnostics.
+ *
+ * Usage:
+ *   cv admin logs                             Last 100 events across all features
+ *   cv admin logs --feature interview          Interview events only
+ *   cv admin logs --feature interview --level error  Errors only
+ *   cv admin logs --uid <userId>               Events for a specific user
+ *   cv admin logs --since 2025-01-01           Events since a date
+ *   cv admin logs --limit 50                   Custom limit (max 500)
+ *   cv admin logs --json                       Raw JSON output (pipe-friendly)
+ *
+ * Access: requires `role: "admin"` on the caller's Firestore user document.
+ * Feature logs are written by cli/src/lib/logger.ts and stored in Firestore cliLogs.
+ */
+import { Command } from "commander";
+export declare function registerAdminCommand(program: Command): void;
+//# sourceMappingURL=admin.d.ts.map

package/dist/commands/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/commands/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6FpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoH3D"}

package/dist/commands/admin.js

@@ -0,0 +1,187 @@
+/**
+ * cv admin — Admin-only commands: log inspection, audit, diagnostics.
+ *
+ * Usage:
+ *   cv admin logs                             Last 100 events across all features
+ *   cv admin logs --feature interview          Interview events only
+ *   cv admin logs --feature interview --level error  Errors only
+ *   cv admin logs --uid <userId>               Events for a specific user
+ *   cv admin logs --since 2025-01-01           Events since a date
+ *   cv admin logs --limit 50                   Custom limit (max 500)
+ *   cv admin logs --json                       Raw JSON output (pipe-friendly)
+ *
+ * Access: requires `role: "admin"` on the caller's Firestore user document.
+ * Feature logs are written by cli/src/lib/logger.ts and stored in Firestore cliLogs.
+ */
+import chalk from "chalk";
+import { getApiKey } from "../config.js";
+// ─── Constants ────────────────────────────────────────────────────────────────
+const CLI_GET_LOGS_URL = process.env.CV_FUNCTIONS_URL
+    ? `${process.env.CV_FUNCTIONS_URL}/cliGetLogs`
+    : "https://us-west1-jastalk-firebase.cloudfunctions.net/cliGetLogs";
+// ─── Level styling ────────────────────────────────────────────────────────────
+function levelBadge(level) {
+    switch (level) {
+        case "error": return chalk.bgRed.white.bold(" ERR ");
+        case "warn": return chalk.bgYellow.black.bold(" WRN ");
+        case "info": return chalk.bgBlue.white.bold(" INF ");
+        case "debug": return chalk.bgGray.white.bold(" DBG ");
+        default: return chalk.bgGray.white.bold(` ${level.toUpperCase().slice(0, 3)} `);
+    }
+}
+function featureBadge(feature) {
+    const colors = {
+        interview: (s) => chalk.hex("#4f46e5").bold(s),
+        agent: (s) => chalk.hex("#059669").bold(s),
+        resume: (s) => chalk.hex("#d97706").bold(s),
+        jobs: (s) => chalk.hex("#dc2626").bold(s),
+    };
+    const fn = colors[feature] ?? ((s) => chalk.gray.bold(s));
+    return fn(`[${feature}]`);
+}
+function dim(s) { return chalk.dim(s); }
+// ─── Display helpers ──────────────────────────────────────────────────────────
+function formatEvent(e, verbose) {
+    const ts = dim(new Date(e.clientTime ?? e.serverTime ?? 0).toISOString().replace("T", " ").slice(0, 19));
+    const badge = levelBadge(e.level ?? "info");
+    const feat = featureBadge(e.feature ?? "?");
+    const evt = chalk.white(e.event ?? "unknown");
+    const sid = e.sessionId ? dim(` sid:${String(e.sessionId).slice(0, 8)}…`) : "";
+    const ver = dim(` v${e.cliVersion ?? "?"}`);
+    console.log(`  ${ts}  ${badge}  ${feat}  ${evt}${sid}${ver}`);
+    if (e.errorMessage) {
+        console.log(`          ${chalk.red("↳ " + e.errorMessage)}`);
+        if (verbose && e.errorStack) {
+            const stack = e.errorStack.split("\n").slice(1, 4).join("\n    ");
+            console.log(chalk.red(`    ${stack}`));
+        }
+    }
+    if (verbose && e.metadata && Object.keys(e.metadata).length > 0) {
+        const json = JSON.stringify(e.metadata, null, 2)
+            .split("\n").map(l => `    ${chalk.dim(l)}`).join("\n");
+        console.log(json);
+    }
+}
+function printHeader(filters) {
+    console.log("\n" + chalk.bgHex("#4f46e5").white.bold("  CareerVivid — CLI Logs  "));
+    const parts = [
+        filters.feature ? chalk.cyan(`feature=${filters.feature}`) : chalk.dim("feature=*"),
+        filters.level ? chalk.yellow(`level=${filters.level}`) : chalk.dim("level=*"),
+        filters.uid ? chalk.magenta(`uid=${filters.uid.slice(0, 8)}…`) : chalk.dim("uid=*"),
+        filters.since ? chalk.green(`since=${filters.since}`) : chalk.dim("since=all"),
+        chalk.dim(`limit=${filters.limit}`),
+    ];
+    console.log("  " + parts.join(chalk.dim("  ·  ")));
+    console.log(chalk.dim("  " + "─".repeat(78)));
+}
+function printSummary(events) {
+    const counts = {};
+    for (const e of events)
+        counts[e.level ?? "info"] = (counts[e.level ?? "info"] || 0) + 1;
+    const parts = Object.entries(counts).map(([l, n]) => `${levelBadge(l)} ${n}`);
+    console.log(chalk.dim("\n  " + "─".repeat(78)));
+    console.log(`  ${chalk.bold("Total:")} ${events.length} events   ${parts.join("   ")}`);
+    const errorCount = counts["error"] ?? 0;
+    if (errorCount > 0) {
+        console.log(chalk.red.bold(`\n  ⚠  ${errorCount} error${errorCount > 1 ? "s" : ""} found. Run with --level error to filter.`));
+    }
+    console.log("");
+}
+// ─── Command registration ──────────────────────────────────────────────────────
+export function registerAdminCommand(program) {
+    const admin = program
+        .command("admin", { hidden: true }) // hidden from public --help
+        .description("Admin-only commands — requires admin role");
+    admin
+        .command("logs")
+        .description("Fetch and inspect CLI event logs")
+        .option("-f, --feature <name>", "Filter by feature (interview, agent, resume, jobs, …)")
+        .option("-l, --level <level>", "Filter by level (error, warn, info)")
+        .option("--uid <userId>", "Filter by specific user UID")
+        .option("--since <date>", "Only show logs after this date (ISO format: 2025-01-01)")
+        .option("-n, --limit <n>", "Number of log batches to fetch (default 100, max 500)", "100")
+        .option("--verbose", "Show full metadata and stack traces")
+        .option("--json", "Output raw JSON (pipe-friendly)")
+        .addHelpText("after", `
+Examples:
+  cv admin logs
+  cv admin logs --feature interview
+  cv admin logs --feature interview --level error
+  cv admin logs --level error --limit 50
+  cv admin logs --uid abc123def456
+  cv admin logs --since 2025-01-01
+  cv admin logs --feature interview --json | jq '.[] | select(.level=="error")'
+`)
+        .action(async (opts) => {
+        const apiKey = getApiKey();
+        if (!apiKey) {
+            console.error(chalk.red("\n  Not logged in. Run: cv login\n"));
+            process.exit(1);
+        }
+        const limit = Math.min(Math.max(parseInt(opts.limit, 10) || 100, 1), 500);
+        // ── Fetch logs ──────────────────────────────────────────────────
+        if (!opts.json) {
+            printHeader({ feature: opts.feature, level: opts.level, uid: opts.uid, since: opts.since, limit });
+            process.stdout.write(chalk.dim("  Fetching logs…\r"));
+        }
+        let result;
+        try {
+            const res = await fetch(CLI_GET_LOGS_URL, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    apiKey,
+                    feature: opts.feature,
+                    level: opts.level,
+                    uid: opts.uid,
+                    since: opts.since,
+                    limit,
+                }),
+            });
+            result = await res.json();
+            if (res.status === 403) {
+                console.error(chalk.red("\n  ✖  Admin access required.\n"));
+                process.exit(1);
+            }
+            if (!res.ok) {
+                throw new Error(result?.error ?? `HTTP ${res.status}`);
+            }
+        }
+        catch (err) {
+            console.error(chalk.red(`\n  Failed to fetch logs: ${err.message}\n`));
+            process.exit(1);
+        }
+        // ── Flatten all events from all batches ─────────────────────────
+        const allEvents = [];
+        for (const batch of result.logs ?? []) {
+            for (const e of batch.events ?? []) {
+                allEvents.push({ ...e, _batchId: batch.batchId, _receivedAt: batch.receivedAt });
+            }
+        }
+        // ── Output ──────────────────────────────────────────────────────
+        if (opts.json) {
+            console.log(JSON.stringify(allEvents, null, 2));
+            return;
+        }
+        if (allEvents.length === 0) {
+            process.stdout.write("                          \r");
+            console.log(chalk.dim("  No log events found with the current filters.\n"));
+            return;
+        }
+        process.stdout.write("                          \r");
+        // Sort by clientTime ascending (oldest first for readability)
+        allEvents.sort((a, b) => {
+            const ta = new Date(a.clientTime || a._receivedAt || 0).getTime();
+            const tb = new Date(b.clientTime || b._receivedAt || 0).getTime();
+            return ta - tb;
+        });
+        for (const e of allEvents) {
+            formatEvent(e, !!opts.verbose);
+        }
+        printSummary(allEvents);
+    });
+    // Future subcommands can be added here:
+    // admin.command("sessions") — list interviewSessions
+    // admin.command("users")    — user credit audit
+    // admin.command("billing")  — billing reconciliation
+}

package/dist/commands/agent/toolRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/toolRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAwO3C,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,EAAE,CA8ChG"}
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/toolRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAyO3C,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,EAAE,CAiDhG"}

package/dist/commands/agent/toolRegistry.js

@@ -7,6 +7,7 @@ import { ALL_URL_VERIFIER_TOOLS } from "../../agent/tools/urlVerifier.js";
 import { ALL_PORTFOLIO_TOOLS } from "../../agent/tools/portfolio.js";
 import { ALL_COVERLETTER_TOOLS } from "../../agent/tools/coverLetter.js";
 import { ALL_JOB_OPENINGS_TOOLS } from "../../agent/tools/jobOpenings.js";
+import { ALL_INTERVIEW_TOOLS } from "../../agent/tools/interview.js";
 import { publishSingleFile } from "../publish.js";
 // ── Publish tools ─────────────────────────────────────────────────────────────
 const PublishArticleTool = {
@@ -242,6 +243,10 @@ export function getTools(options) {
             if (!tools.find((x) => x.name === t.name))
                 tools.push(t);
         }
+        for (const t of ALL_INTERVIEW_TOOLS) {
+            if (!tools.find((x) => x.name === t.name))
+                tools.push(t);
+        }
         return tools;
     }
     if (options.resume) {
@@ -266,5 +271,5 @@ export function getTools(options) {
         return tools;
     }
     // Default coding mode: file system + publish tools
-    return [...ALL_CODING_TOOLS, PublishArticleTool, GenerateDiagramTool, ...ALL_COVERLETTER_TOOLS];
+    return [...ALL_CODING_TOOLS, PublishArticleTool, GenerateDiagramTool, ...ALL_COVERLETTER_TOOLS, ...ALL_INTERVIEW_TOOLS];
 }

package/dist/commands/interview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interview.d.ts","sourceRoot":"","sources":["../../src/commands/interview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4oBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG/D"}
+{"version":3,"file":"interview.d.ts","sourceRoot":"","sources":["../../src/commands/interview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4rBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG/D"}

package/dist/commands/interview.js

@@ -20,9 +20,21 @@ import chalk from "chalk";
 import readline from "readline";
 import ora from "ora";
 import { spawn } from "child_process";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
 import { GoogleGenAI, Modality } from "@google/genai";
 import { getApiKey } from "../config.js";
 import { isApiError, resumeGet } from "../api.js";
+import { createLogger } from "../lib/logger.js";
+/** Read CLI version from package.json (ESM-compatible) */
+const __dirname_iv = dirname(fileURLToPath(import.meta.url));
+let _cliVersion = "unknown";
+try {
+    _cliVersion = JSON.parse(readFileSync(join(__dirname_iv, "../../package.json"), "utf-8")).version ?? "unknown";
+}
+catch { /* ignore */ }
+const CLI_VERSION = _cliVersion;
 /** Strip ANSI escape codes for accurate string length measurement */
 const stripAnsi = (s) => s.replace(/\x1B\[[0-9;]*m/g, "");
 // ─── Constants ────────────────────────────────────────────────────────────────
@@ -334,14 +346,24 @@ async function analyzeTranscript(transcript, role) {
 async function runVoiceSession(opts) {
     const { role, questions, resumeContext, soxPath } = opts;
     printBanner(role, "voice");
+    // Create logger (sessionId not yet known — will be set after token vend)
+    const log = createLogger("interview", {
+        apiKey: getApiKey(),
+        version: CLI_VERSION,
+    });
+    const sessionStart = Date.now();
     // Get Gemini token from Cloud Function
     const connectSpinner = ora(chalk.dim("Connecting to Vivid...")).start();
     let geminiKey;
     let sessionId;
     try {
         ({ geminiKey, sessionId } = await getGeminiToken(role));
+        log.setSessionId(sessionId);
+        log.info("session_start", { role, numQuestions: questions.length, mode: "voice", soxPath });
     }
     catch (err) {
+        log.error("token_vend_failed", err, { role });
+        await log.dispose();
         connectSpinner.fail(chalk.red(err.message));
         throw err;
     }
@@ -456,12 +478,15 @@ async function runVoiceSession(opts) {
         });
     }
     catch (err) {
+        log.error("live_connect_failed", err, { role, sessionId });
+        await log.dispose();
         connectSpinner.fail(chalk.red(`Failed to connect: ${err.message}`));
         micProc.kill();
         speakerProc.kill();
         throw err;
     }
-    // ── Wait until interview ends or Ctrl+C ─────────────────────────────
+    // ── Wait until interview ends or Ctrl+C (single-SIGINT guard) ───────
+    let shuttingDown = false;
     await new Promise((resolve) => {
         const check = setInterval(() => {
             if (ended) {
@@ -469,12 +494,17 @@ async function runVoiceSession(opts) {
                 resolve();
             }
         }, 200);
-        process.once("SIGINT", () => {
+        const onSigInt = () => {
+            if (shuttingDown)
+                return; // ignore double Ctrl+C
+            shuttingDown = true;
             clearInterval(check);
             printSystem("Interview ended by user.");
+            log.info("session_interrupted", { role, sessionId, elapsedMs: Date.now() - sessionStart });
             ended = true;
             resolve();
-        });
+        };
+        process.once("SIGINT", onSigInt);
     });
     // ── Cleanup ──────────────────────────────────────────────────────────
     try {
@@ -491,31 +521,49 @@ async function runVoiceSession(opts) {
     catch { /* ignore */ }
     // Wait a moment for final audio to drain
     await new Promise(r => setTimeout(r, 800));
-    // ── Bill session (duration-based) ───────────────────────────────────
+    const sessionDurationMs = Date.now() - sessionStart;
+    // ── Bill session (duration-based, 10s timeout to prevent hang) ──────
     const billSpinner = ora(chalk.dim("Calculating session cost...")).start();
-    const bill = await billSession(sessionId);
+    const bill = await Promise.race([
+        billSession(sessionId),
+        new Promise(r => setTimeout(() => r(null), 10_000)),
+    ]);
     if (bill) {
         billSpinner.succeed(chalk.dim(`Session: ${bill.durationMinutes}min · `) +
             chalk.hex("#4f46e5").bold(`${bill.creditsCharged} credits used`) +
             chalk.dim(` · ${bill.creditsRemaining} remaining`));
+        log.info("billing_complete", {
+            sessionId, durationMinutes: bill.durationMinutes,
+            creditsCharged: bill.creditsCharged, creditsRemaining: bill.creditsRemaining,
+        });
+        log.metric("credits_charged", bill.creditsCharged, { sessionId });
+        log.metric("session_duration_ms", sessionDurationMs, { sessionId });
     }
     else {
-        billSpinner.stop();
+        billSpinner.warn(chalk.dim("Session cost could not be calculated (timeout)."));
+        log.warn("billing_timeout", { sessionId, sessionDurationMs });
     }
     // ── Feedback report ──────────────────────────────────────────────────
     const userTurns = transcript.filter(t => t.speaker === "user").length;
+    log.info("session_end", { sessionId, userTurns, aiTurns: transcript.filter(t => t.speaker === "ai").length, sessionDurationMs });
     if (userTurns < 1) {
         printSystem("Not enough conversation to generate a feedback report.");
+        await log.dispose();
         return;
     }
     console.log(chalk.dim("\n  Generating your personalized feedback report..."));
     try {
         const report = await analyzeTranscript(transcript, role);
         printReport(report);
+        log.info("feedback_complete", { sessionId, overallScore: report.overallScore });
     }
     catch (err) {
+        log.error("feedback_failed", err, { sessionId });
         console.log(chalk.red(`  Failed to generate feedback: ${err.message}`));
     }
+    finally {
+        await log.dispose();
+    }
 }
 // ─── TEXT SESSION (fallback) ──────────────────────────────────────────────────
 async function runTextSession(opts) {

package/dist/index.js

@@ -54,6 +54,7 @@ import { registerResumesCommand } from "./commands/resumes.js";
 import { registerReferralCommand } from "./commands/referral.js";
 import { registerEvalCommand } from "./commands/eval.js";
 import { registerInterviewCommand } from "./commands/interview.js";
+import { registerAdminCommand } from "./commands/admin.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
 const program = new Command();
@@ -79,6 +80,7 @@ registerResumesCommand(program);
 registerReferralCommand(program);
 registerEvalCommand(program);
 registerInterviewCommand(program);
+registerAdminCommand(program);
 // Shortcuts for whiteboard creation
 registerNewCommand(program);
 registerListTemplatesCommand(program);

package/dist/lib/logger.d.ts

@@ -0,0 +1,108 @@
+/**
+ * CVLogger — Generic structured logging module for the CareerVivid CLI.
+ *
+ * Design goals:
+ *  - Zero-friction: never throws, never blocks the user — fire-and-forget
+ *  - Extensible: one logger per command/feature, sessionId for event correlation
+ *  - Dual-sink: (1) remote POST to cliLog Cloud Function, (2) local JSONL fallback
+ *  - Buffered: batched remote flushes to minimize network calls
+ *
+ * Usage:
+ *   import { createLogger } from "../lib/logger.js";
+ *   const log = createLogger("interview", { sessionId, apiKey, version: pkg.version });
+ *   log.info("session_start", { role, numQuestions });
+ *   log.error("connection_error", err, { phase: "websocket_open" });
+ *   await log.dispose(); // flush before process exit
+ *
+ * Extending to new features — no changes to this file needed:
+ *   const agentLog = createLogger("agent", { apiKey, version });
+ *   const resumeLog = createLogger("resume", { sessionId: resumeId, apiKey, version });
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogEvent {
+    /** Severity level */
+    level: LogLevel;
+    /** Feature area: "interview" | "agent" | "resume" | ... */
+    feature: string;
+    /** Machine-readable event name: "session_start" | "billing_complete" | ... */
+    event: string;
+    /** Optional session/entity correlation ID */
+    sessionId?: string;
+    /** Arbitrary serializable metadata */
+    metadata?: Record<string, unknown>;
+    /** Error message (when level === "error") */
+    errorMessage?: string;
+    /** Error stack trace (when level === "error") */
+    errorStack?: string;
+    /** ISO 8601 timestamp from the client */
+    clientTime: string;
+    /** CLI package.json version */
+    cliVersion: string;
+}
+export declare class CVLogger {
+    private readonly _feature;
+    private _sessionId;
+    private readonly _flushUrl;
+    private readonly _apiKey;
+    private readonly _cliVersion;
+    private readonly _localLogDir;
+    private _buffer;
+    private _flushing;
+    private _disposed;
+    private _flushTimer;
+    private static readonly FLUSH_INTERVAL_MS;
+    private static readonly FLUSH_BUFFER_SIZE;
+    constructor(opts: {
+        feature: string;
+        sessionId?: string;
+        flushUrl: string;
+        apiKey?: string;
+        cliVersion: string;
+        localLogDir?: string;
+    });
+    /** Informational event. */
+    info(event: string, metadata?: Record<string, unknown>): void;
+    /** Warning event. */
+    warn(event: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Error event. Accepts Error objects or any thrown value.
+     * Serializes the error — never rethrows.
+     */
+    error(event: string, err?: unknown, metadata?: Record<string, unknown>): void;
+    /**
+     * Record a numeric metric (latency, token count, credit charge, etc.)
+     * Stored as an "info" event with metricName + metricValue in metadata.
+     */
+    metric(name: string, value: number, metadata?: Record<string, unknown>): void;
+    /**
+     * Update the sessionId after construction.
+     * Use when the sessionId isn't available until after an async call.
+     */
+    setSessionId(sessionId: string): void;
+    /**
+     * Flush buffered events to the remote endpoint.
+     * Safe to call multiple times — idempotent. Never throws.
+     */
+    flush(): Promise<void>;
+    /**
+     * Dispose: stop auto-flush timer + flush remaining events.
+     * Always call before the command exits (use try/finally).
+     */
+    dispose(): Promise<void>;
+    private _push;
+    private _writeLocal;
+}
+/**
+ * Create a feature-scoped logger. Pass this around; call dispose() at the end.
+ *
+ * @param feature   "interview" | "agent" | "resume" | "jobs" | etc.
+ * @param opts.sessionId  Correlation ID (interview sessionId, resumeId, …)
+ * @param opts.apiKey     CareerVivid cv_live_ key (for remote attribution)
+ * @param opts.version    CLI version from package.json
+ */
+export declare function createLogger(feature: string, opts?: {
+    sessionId?: string;
+    apiKey?: string;
+    version?: string;
+}): CVLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACrB,qBAAqB;IACrB,KAAK,EAAE,QAAQ,CAAC;IAChB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACtB;AAID,qBAAa,QAAQ;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA+C;IAElE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAM;gBAEnC,IAAI,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB;IAwBD,2BAA2B;IAC3B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D,qBAAqB;IACrB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAc7E;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7E;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,OAAO,CAAC,KAAK;IA+Bb,OAAO,CAAC,WAAW;CAOtB;AAWD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,QAAQ,CAQV"}

package/dist/lib/logger.js

@@ -0,0 +1,198 @@
+/**
+ * CVLogger — Generic structured logging module for the CareerVivid CLI.
+ *
+ * Design goals:
+ *  - Zero-friction: never throws, never blocks the user — fire-and-forget
+ *  - Extensible: one logger per command/feature, sessionId for event correlation
+ *  - Dual-sink: (1) remote POST to cliLog Cloud Function, (2) local JSONL fallback
+ *  - Buffered: batched remote flushes to minimize network calls
+ *
+ * Usage:
+ *   import { createLogger } from "../lib/logger.js";
+ *   const log = createLogger("interview", { sessionId, apiKey, version: pkg.version });
+ *   log.info("session_start", { role, numQuestions });
+ *   log.error("connection_error", err, { phase: "websocket_open" });
+ *   await log.dispose(); // flush before process exit
+ *
+ * Extending to new features — no changes to this file needed:
+ *   const agentLog = createLogger("agent", { apiKey, version });
+ *   const resumeLog = createLogger("resume", { sessionId: resumeId, apiKey, version });
+ */
+import { appendFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+// ─── Logger class ─────────────────────────────────────────────────────────────
+export class CVLogger {
+    _feature;
+    _sessionId;
+    _flushUrl;
+    _apiKey;
+    _cliVersion;
+    _localLogDir;
+    _buffer = [];
+    _flushing = false;
+    _disposed = false;
+    _flushTimer = null;
+    static FLUSH_INTERVAL_MS = 60_000;
+    static FLUSH_BUFFER_SIZE = 25;
+    constructor(opts) {
+        this._feature = opts.feature;
+        this._sessionId = opts.sessionId;
+        this._flushUrl = opts.flushUrl;
+        this._apiKey = opts.apiKey;
+        this._cliVersion = opts.cliVersion;
+        this._localLogDir = opts.localLogDir ?? join(homedir(), ".cv", "logs");
+        // Ensure local log directory exists
+        try {
+            if (!existsSync(this._localLogDir)) {
+                mkdirSync(this._localLogDir, { recursive: true });
+            }
+        }
+        catch { /* non-fatal */ }
+        // Auto-flush timer — unref() so it doesn't prevent clean process exit
+        this._flushTimer = setInterval(() => {
+            if (this._buffer.length > 0)
+                this.flush().catch(() => { });
+        }, CVLogger.FLUSH_INTERVAL_MS);
+        this._flushTimer.unref?.();
+    }
+    // ── Public API ────────────────────────────────────────────────────────────
+    /** Informational event. */
+    info(event, metadata) {
+        this._push("info", event, metadata);
+    }
+    /** Warning event. */
+    warn(event, metadata) {
+        this._push("warn", event, metadata);
+    }
+    /**
+     * Error event. Accepts Error objects or any thrown value.
+     * Serializes the error — never rethrows.
+     */
+    error(event, err, metadata) {
+        let errorMessage;
+        let errorStack;
+        if (err instanceof Error) {
+            errorMessage = err.message;
+            errorStack = err.stack;
+        }
+        else if (typeof err === "string") {
+            errorMessage = err;
+        }
+        else if (err != null) {
+            try {
+                errorMessage = JSON.stringify(err);
+            }
+            catch {
+                errorMessage = String(err);
+            }
+        }
+        this._push("error", event, metadata, errorMessage, errorStack);
+    }
+    /**
+     * Record a numeric metric (latency, token count, credit charge, etc.)
+     * Stored as an "info" event with metricName + metricValue in metadata.
+     */
+    metric(name, value, metadata) {
+        this._push("info", `metric:${name}`, { ...metadata, metricName: name, metricValue: value });
+    }
+    /**
+     * Update the sessionId after construction.
+     * Use when the sessionId isn't available until after an async call.
+     */
+    setSessionId(sessionId) {
+        this._sessionId = sessionId;
+    }
+    /**
+     * Flush buffered events to the remote endpoint.
+     * Safe to call multiple times — idempotent. Never throws.
+     */
+    async flush() {
+        if (this._flushing || this._buffer.length === 0 || !this._apiKey)
+            return;
+        this._flushing = true;
+        const batch = this._buffer.splice(0); // atomic drain
+        try {
+            await fetch(this._flushUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ apiKey: this._apiKey, events: batch }),
+                signal: AbortSignal.timeout(8_000),
+            });
+        }
+        catch {
+            // Remote flush failed: events are already in local JSONL file.
+            // Don't re-buffer — avoids memory growth on persistent failures.
+        }
+        finally {
+            this._flushing = false;
+        }
+    }
+    /**
+     * Dispose: stop auto-flush timer + flush remaining events.
+     * Always call before the command exits (use try/finally).
+     */
+    async dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        if (this._flushTimer) {
+            clearInterval(this._flushTimer);
+            this._flushTimer = null;
+        }
+        await this.flush();
+    }
+    // ── Internal ──────────────────────────────────────────────────────────────
+    _push(level, event, metadata, errorMessage, errorStack) {
+        if (this._disposed)
+            return;
+        const entry = {
+            level,
+            feature: this._feature,
+            event,
+            sessionId: this._sessionId,
+            metadata,
+            errorMessage,
+            errorStack,
+            clientTime: new Date().toISOString(),
+            cliVersion: this._cliVersion,
+        };
+        // Write to local JSONL immediately (synchronous, best-effort)
+        this._writeLocal(entry);
+        this._buffer.push(entry);
+        // Trigger remote flush if buffer is large enough
+        if (this._buffer.length >= CVLogger.FLUSH_BUFFER_SIZE) {
+            this.flush().catch(() => { });
+        }
+    }
+    _writeLocal(entry) {
+        try {
+            const date = entry.clientTime.slice(0, 10); // YYYY-MM-DD
+            const logFile = join(this._localLogDir, `${this._feature}-${date}.jsonl`);
+            appendFileSync(logFile, JSON.stringify(entry) + "\n");
+        }
+        catch { /* local write failure is non-fatal */ }
+    }
+}
+// ─── Constants ────────────────────────────────────────────────────────────────
+const CLI_LOG_URL = process.env.CV_FUNCTIONS_URL
+    ? `${process.env.CV_FUNCTIONS_URL}/cliLog`
+    : "https://us-west1-jastalk-firebase.cloudfunctions.net/cliLog";
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create a feature-scoped logger. Pass this around; call dispose() at the end.
+ *
+ * @param feature   "interview" | "agent" | "resume" | "jobs" | etc.
+ * @param opts.sessionId  Correlation ID (interview sessionId, resumeId, …)
+ * @param opts.apiKey     CareerVivid cv_live_ key (for remote attribution)
+ * @param opts.version    CLI version from package.json
+ */
+export function createLogger(feature, opts = {}) {
+    return new CVLogger({
+        feature,
+        sessionId: opts.sessionId,
+        flushUrl: CLI_LOG_URL,
+        apiKey: opts.apiKey,
+        cliVersion: opts.version ?? "unknown",
+    });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "careervivid",
-  "version": "1.12.50",
-  "description": "Official CLI for CareerVivid — publish articles, diagrams, and portfolio updates from your terminal or AI agent",
+  "version": "2.0.0",
+  "description": "Official CLI for CareerVivid — AI voice interviews, autonomous job applications, resume editing, and portfolio publishing from your terminal",
   "type": "module",
   "bin": {
     "cv": "dist/index.js",
@@ -57,10 +57,15 @@
   "keywords": [
     "careervivid",
     "cli",
+    "ai-interview",
+    "voice-interview",
+    "mock-interview",
+    "job-search",
     "developer-tools",
     "publish",
     "portfolio",
     "ai-agent",
+    "resume",
     "mcp"
   ],
   "author": "CareerVivid",