careervivid 1.12.48 → 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

@@ -0,0 +1,21 @@
+/**
+ * cv interview — interactive AI mock interview with real-time voice audio.
+ *
+ * Usage:
+ *   cv interview                          Prompt for role interactively (voice mode)
+ *   cv interview --role "Sr SWE"          Specify role directly (voice mode)
+ *   cv interview --role "PM" --text       Text-only fallback (no audio required)
+ *   cv interview --role "SDE" --resume <id>  Load resume for context
+ *
+ * Voice mode requires sox (handles both mic input and speaker output):
+ *   macOS:  brew install sox
+ *   Linux:  sudo apt install sox
+ *
+ * AI calls:
+ *   - Token vend: cliGetInterviewToken Cloud Function (validates cv_live_ key, deducts credits)
+ *   - Voice session: gemini-3.1-flash-live-preview via @google/genai Live API (direct WebSocket)
+ *   - Feedback: agentProxy Cloud Function (standard HTTP, existing pattern)
+ */
+import { Command } from "commander";
+export declare function registerInterviewCommand(program: Command): void;
+//# sourceMappingURL=interview.d.ts.map

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

@@ -0,0 +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;AA4rBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG/D"}