careervivid 1.12.48 → 2.0.0

package/dist/index.js

@@ -53,6 +53,8 @@ import { registerJobsCommand } from "./commands/jobs.js";
 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();
@@ -77,6 +79,8 @@ registerJobsCommand(program);
 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.48",
-  "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",