careervivid 2.1.22 → 2.1.30

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

@@ -1 +1 @@
-{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../src/agent/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,uBAAuB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AASrD,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,QAAsC,CAAC;AAC9E,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,QAAoC,CAAC;AASpE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAyCD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAyBrC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;IAW7B,OAAO,CAAC,mBAAmB;YAcb,YAAY;YAOZ,gBAAgB;IA6DjB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAqG5E;;;;OAIG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAoHtF"}
+{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../src/agent/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,uBAAuB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AASrD,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,QAAsC,CAAC;AAC9E,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,QAAoC,CAAC;AASpE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAwED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAyBrC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;IAW7B,OAAO,CAAC,mBAAmB;YAcb,YAAY;YAOZ,gBAAgB;IA6DjB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAqG5E;;;;OAIG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAoHtF"}

package/dist/agent/QueryEngine.js

@@ -18,14 +18,39 @@ function isRetryableError(e) {
     // Google GenAI errors often have a status field
     if (e?.status && RETRYABLE_STATUS_CODES.has(e.status))
         return true;
-    if (e?.message && /rate.?limit|quota|too.?many.?requests|service.?unavailable/i.test(e.message))
+    if (e?.message && /rate.?limit|quota|too.?many.?requests|service.?unavailable|429/i.test(e.message))
         return true;
     return false;
 }
+/** Parse the retryDelay (in seconds) from a Gemini 429 error message or details array. */
+function extractRetryDelayMs(e) {
+    // Try structured errorDetails array first (e.g. RetryInfo proto)
+    if (Array.isArray(e?.errorDetails)) {
+        for (const detail of e.errorDetails) {
+            const delay = detail?.retryDelay;
+            if (delay) {
+                // "16s" or "16.44s" → milliseconds
+                const secs = parseFloat(String(delay).replace('s', ''));
+                if (!isNaN(secs))
+                    return Math.ceil(secs * 1000);
+            }
+        }
+    }
+    // Fallback: parse from error message string ("Please retry in 16.44s")
+    if (e?.message) {
+        const match = e.message.match(/retry\s*in\s*([\d.]+)\s*s/i);
+        if (match) {
+            const secs = parseFloat(match[1]);
+            if (!isNaN(secs))
+                return Math.ceil(secs * 1000);
+        }
+    }
+    return null;
+}
 async function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
-async function retryWithBackoff(fn, maxRetries = 3, baseDelayMs = 1000) {
+async function retryWithBackoff(fn, maxRetries = 5, baseDelayMs = 5000) {
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
         try {
             return await fn();
@@ -33,8 +58,15 @@ async function retryWithBackoff(fn, maxRetries = 3, baseDelayMs = 1000) {
         catch (e) {
             if (attempt === maxRetries || !isRetryableError(e))
                 throw e;
-            const delay = baseDelayMs * Math.pow(2, attempt);
-            await sleep(delay);
+            // Honour the server-requested retry delay if present, use exponential backoff as floor
+            const serverDelayMs = extractRetryDelayMs(e);
+            const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+            const delayMs = Math.max(serverDelayMs ?? 0, exponentialDelay);
+            // Add ±10% jitter to avoid thundering-herd on shared quota
+            const jitter = delayMs * 0.1 * (Math.random() * 2 - 1);
+            const finalDelay = Math.ceil(delayMs + jitter);
+            console.error(`\n⏳  Rate limited (attempt ${attempt + 1}/${maxRetries}). Retrying in ${(finalDelay / 1000).toFixed(1)}s…`);
+            await sleep(finalDelay);
         }
     }
     // TypeScript requires this even though it's unreachable

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

@@ -1 +1 @@
-{"version":3,"file":"agentAuditLog.d.ts","sourceRoot":"","sources":["../../src/agent/agentAuditLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;CACb;AAID,eAAO,IAAI,UAAU,QAA2B,CAAC;AAoCjD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpE;AA8BD,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CA8BP;AAyJD,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAID,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhB"}
+{"version":3,"file":"agentAuditLog.d.ts","sourceRoot":"","sources":["../../src/agent/agentAuditLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;CACb;AAID,eAAO,IAAI,UAAU,QAA2B,CAAC;AA0CjD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpE;AA8BD,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CA8BP;AA8KD,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAID,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEhB"}

package/dist/agent/agentAuditLog.js

@@ -20,7 +20,7 @@ import { appendFileSync, existsSync, mkdirSync } from "fs";
 import { resolve } from "path";
 import { homedir } from "os";
 import { randomUUID } from "crypto";
-import { saveSessionMemory } from "./memory.js";
+import { saveSessionMemory, saveCodingSession } from "./memory.js";
 // ── Session-level state ───────────────────────────────────────────────────────
 export let SESSION_ID = randomUUID().slice(0, 8);
 const pendingFirestore = [];
@@ -38,6 +38,8 @@ const sessionState = {
     coverLetters: [],
     interviewPrep: [],
     facts: {},
+    filesChanged: [],
+    lastBuilt: "",
 };
 /** Call once at startup so the session summary records the correct mode and model. */
 export function initSessionContext(mode, model) {
@@ -196,6 +198,26 @@ function extractSessionFacts(tool, args, result) {
             addHighlight(`Auto-filled application: ${company} (${role})`);
             break;
         }
+        // ── Coding file tools ───────────────────────────────────────────────────────────────────
+        case "write_file": {
+            const filePath = String(args.path || "");
+            if (filePath && !sessionState.filesChanged.includes(filePath)) {
+                sessionState.filesChanged.push(filePath);
+            }
+            // Track what was built from the path name
+            const fileName = filePath.split("/").pop() || filePath;
+            sessionState.lastBuilt = fileName;
+            addHighlight(`Created/wrote: ${filePath}`);
+            break;
+        }
+        case "patch_file": {
+            const filePath = String(args.path || "");
+            if (filePath && !sessionState.filesChanged.includes(filePath)) {
+                sessionState.filesChanged.push(filePath);
+            }
+            addHighlight(`Patched: ${filePath} (lines ${args.start_line}–${args.end_line})`);
+            break;
+        }
         default:
             break;
     }
@@ -274,6 +296,28 @@ export async function writeSessionSummary(stats) {
                 facts: sessionState.facts,
             };
             saveSessionMemory(memoryInput);
+            // ── For coding mode: also save the fast pick-up file ──────────────────
+            if (sessionState.mode === "coding" && sessionState.filesChanged.length > 0) {
+                const { execSync } = await import("child_process");
+                let branch = "";
+                try {
+                    branch = execSync("git branch --show-current", { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+                }
+                catch { /* no git */ }
+                const summaryParts = sessionState.highlights.slice(0, 5).map(h => h.outcome);
+                const summary = summaryParts.length > 0
+                    ? summaryParts.join(" · ")
+                    : `Coding session — ${stats.turns} turns, ${sessionState.filesChanged.length} file(s) changed.`;
+                saveCodingSession({
+                    cwd: process.cwd(),
+                    savedAt: new Date().toISOString(),
+                    mode: "coding",
+                    summary,
+                    filesChanged: sessionState.filesChanged,
+                    lastBuilt: sessionState.lastBuilt,
+                    branch,
+                });
+            }
         }
         catch { /* memory write failure is non-fatal */ }
     }

package/dist/agent/instructions.d.ts

@@ -14,6 +14,7 @@
 export declare const baseIdentity: string;
 export declare const RESUME_SECTION: string;
 export declare const CODING_SECTION: string;
+export declare const BROWSER_CODING_SECTION: string;
 export declare const JOBS_TOOLS_SECTION: string;
 export declare const JOBS_HARNESS: string;
 export declare const GREETING_PROTOCOL: string;

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;AAsCH,mFAAmF;AACnF,eAAO,MAAM,YAAY,QAAsB,CAAC;AAMhD,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAqCnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QA0DvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA6CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAuBtB,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,CAqCT"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsCH,mFAAmF;AACnF,eAAO,MAAM,YAAY,QAAsB,CAAC;AAMhD,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAqDnB,CAAC;AAMT,eAAO,MAAM,sBAAsB,QAiD3B,CAAC;AAMT,eAAO,MAAM,kBAAkB,QA0DvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA6CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAuBtB,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,CAsCT"}

package/dist/agent/instructions.js

@@ -68,40 +68,109 @@ You have access to the **get_resume** tool which fetches the user's live CareerV
 export const CODING_SECTION = `
 ## Coding Agent Mode
 
-You have access to file I/O, shell execution, and codebase search tools.
+You are a fully autonomous software engineering agent — equivalent to Antigravity or Claude Code.
+You write production-ready code directly to local files on disk using your file tools.
 
-### ⚠️ File Access Scope (STRICT — do not bypass)
+### ⚠️ Critical: Write Code to Files — Never to Articles
 
-You operate with least-privilege file access. This is enforced at the tool level and cannot be overridden.
+When a user asks you to build something, create a feature, write a script, or fix a bug:
+1. **USE write_file** to create actual code files in the user's working directory.
+2. **USE patch_file** to surgically edit existing files without rewriting them.
+3. **NEVER use publish_article** to output code. publish_article is ONLY for publishing markdown content to the CareerVivid community blog.
+4. **NEVER just show the user a code block** in the chat and say "here you go". Always write the file.
 
-**READ access** is limited to:
-- \`career-vivid/\` — your job tracker data, résumé drafts, and career pipeline files
-- \`cli/\` — the CLI source code (your own code)
-- \`tmp/\` or \`/tmp/\` — temporary scratch files
+### Your Execution Loop (follow this exactly)
 
-**WRITE access** is limited to:
-- \`career-vivid/\` — ONLY the career data directory you own
-- \`tmp/\` or \`/tmp/\` — temporary scratch files
+1. **Orient** — Call list_directory or get_file_tree on the relevant directory to understand the project structure.
+2. **Read** — Call read_file on any existing files you need to understand before modifying them.
+3. **Plan** — Emit a concise "Plan:" (2–5 bullets: what files you will create/change and why).
+4. **Execute** — Call write_file or patch_file to create/modify every file in the plan.
+5. **Verify** — Run the compiler or tests via run_command (e.g., \`tsc --noEmit\`, \`npm test\`, \`python -c "import script"\`).
+6. **Fix** — If verification fails, read the error, patch the file, re-verify. Loop until clean.
+7. **Report** — Summarise what was created or changed, with the exact file paths.
 
-**NEVER attempt to read or write:**
-- \`src/\` — web app source code (React, components, pages)
-- \`functions/\` — Firebase Cloud Functions source
-- \`next-app/\` — Next.js application source
-- Any file outside your allowed prefixes
+### File Access
 
-If a task requires modifying web app code (\`src/\`, \`functions/\`, etc.), tell the user to make that change in their editor. Your role is career data management, not application development.
+You have full read and write access to any file in the user's working directory EXCEPT:
+- \`.env\` / \`.env.*\` files — contains secrets, never read or write these
+- \`node_modules/\` — managed by npm, never write here
+- \`.git/\` — git internals, use run_command for git operations
 
-### Workflow
-1. Read relevant files first (read_file). Never overwrite blindly.
-2. Emit a short "Plan:" describing files you will touch and the approach.
-3. Write data using write_file or patch_file (career-vivid/ only).
-4. Verify with run_command (read-only commands like cat, ls, grep).
-5. Fix errors and loop until clean; summarise all changes made.
+### Code Quality Standards
 
-### Code Quality
-- TypeScript with strict types. Avoid \`any\` unless unavoidable.
-- Follow existing code style. Add JSDoc to public APIs.
-- Short, single-responsibility functions. Self-documenting names.
+- **TypeScript/JavaScript**: Strict types, no implicit \`any\`, ESM imports, JSDoc on public APIs.
+- **Python**: Type hints, docstrings on public functions, PEP8.
+- **All languages**: Follow existing code style in the project. Keep functions small and single-responsibility.
+- Read the existing file style before writing new code in that file.
+
+### Shell Commands
+
+Use run_command for:
+- Compiling: \`tsc --noEmit\`, \`npm run build\`, \`python -m py_compile\`
+- Testing: \`npm test\`, \`pytest\`, \`go test ./...\`
+- Formatting/linting: \`npm run lint\`, \`black .\`, \`gofmt\`
+- Git: \`git status\`, \`git diff\`, \`git log --oneline -10\`
+- Reading output: \`cat file\`, \`ls -la\`, \`grep -rn pattern dir/\`
+
+### What You Must Never Do
+
+- ❌ Show a code block in the chat and say "paste this" — always write the file
+- ❌ Call publish_article with code content
+- ❌ Ask "would you like me to write this file?" — just write it
+- ❌ Write to .env, node_modules/, or .git/
+`.trim();
+// ---------------------------------------------------------------------------
+// §3b — Browser debugging section (added in --coding mode)
+// ---------------------------------------------------------------------------
+export const BROWSER_CODING_SECTION = `
+## Browser Debugging Tools
+
+You have a full browser automation suite for debugging web apps during development.
+Use these tools when the user asks you to:
+- Inspect a running local dev server (localhost:3000, :8080, etc.)
+- Debug a visual layout bug, broken UI, or rendering error
+- Check what the browser actually shows vs. what the code produces
+- Verify an HTML/CSS/JS project looks correct after generating it
+- Watch live errors or network failures in a running app
+
+### Browser Debug Workflow
+
+1. **browser_navigate** — Open the local server URL (e.g., \`http://localhost:3000\`)
+2. **browser_state** — Read the page structure and all interactive elements
+3. **browser_screenshot** — Visually inspect layout (returns description of current view)
+4. **browser_scroll** — Scroll to reveal below-the-fold content
+5. **browser_click** — Interact with elements by their index number from browser_state
+6. **run_command** — Check server logs, console output, or network errors in parallel
+7. **patch_file** — Fix the issue in the source file
+8. **browser_navigate** (reload) — Verify the fix
+
+### When to use browser tools vs. run_command
+
+| Use browser tools when…          | Use run_command when…              |
+|-----------------------------------|------------------------------------|
+| Visual / layout bug               | Compile error or type error        |
+| JS runtime error in the browser   | Test suite failure                 |
+| Form or interaction doesn't work  | Lint warning                       |
+| Need to see what page renders     | File system inspection (ls, cat)   |
+| Verifying CSS / responsive design | Running build scripts              |
+
+### Browser Tool Quick Reference
+
+- **browser_navigate(url)** — Go to a URL
+- **browser_state()** — Get page title, URL, and numbered interactive element list
+- **browser_click(element_index)** — Click by index from browser_state
+- **browser_type(element_index, text)** — Type into a field
+- **browser_scroll(direction, amount)** — Scroll up/down
+- **browser_screenshot()** — Capture current view
+- **browser_wait(seconds)** — Wait for async content to load
+- **browser_close()** — Close the browser when done
+
+### Rules
+
+- Always call browser_state() after navigating to get the current element list
+- Use browser_wait() after actions that trigger page loads or AJAX calls
+- When you find a bug visually, fix it in the source file with patch_file, then reload
+- Do NOT use browser_autofill_application in coding mode — that is for job applications only
 `.trim();
 // ---------------------------------------------------------------------------
 // §4 — Jobs tools reference (appended in --jobs mode)
@@ -279,6 +348,7 @@ export function buildSystemPrompt(options) {
     return [
         baseIdentity,
         CODING_SECTION,
+        BROWSER_CODING_SECTION,
         ...memorySections,
         GREETING_PROTOCOL,
     ].join("\n\n---\n\n");

package/dist/agent/memory.d.ts

@@ -152,4 +152,32 @@ export declare function buildSessionSummary(opts: SessionSummaryInput): string;
  * Append a session summary to the memory file, merge into KB, compact if needed.
  */
 export declare function saveSessionMemory(opts: SessionSummaryInput): void;
+export interface CodingSessionData {
+    /** Absolute path of the working directory when the session ended */
+    cwd: string;
+    /** ISO timestamp of when the session was saved */
+    savedAt: string;
+    /** Persona mode ("coding", "resume", etc.) */
+    mode: string;
+    /** Human-readable summary of what happened in the session */
+    summary: string;
+    /** Files the agent wrote or patched during the session */
+    filesChanged: string[];
+    /** Short description of the last thing that was built/created */
+    lastBuilt: string;
+    /** Git branch active during the session (empty if no git repo) */
+    branch: string;
+}
+/**
+ * Load the last coding session from ~/.careervivid/coding-session.md.
+ * Returns null if the file does not exist or cannot be parsed.
+ * Intentionally synchronous — called at startup before the agent loop.
+ */
+export declare function loadCodingSession(): CodingSessionData | null;
+/**
+ * Save the current coding session to ~/.careervivid/coding-session.md.
+ * Overwrites the previous entry — only the most recent session is kept here.
+ * Full history is preserved in memory.md via saveSessionMemory().
+ */
+export declare function saveCodingSession(data: CodingSessionData): void;
 //# sourceMappingURL=memory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"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"}

package/dist/agent/memory.js

@@ -462,3 +462,62 @@ export function saveSessionMemory(opts) {
     const updated = compactMemory(base + "\n" + entry);
     saveMemory(updated);
 }
+// =============================================================================
+// Coding session file — fast persona-specific pick-up context
+// =============================================================================
+const CODING_SESSION_FILE = join(MEMORY_DIR, "coding-session.md");
+/**
+ * Load the last coding session from ~/.careervivid/coding-session.md.
+ * Returns null if the file does not exist or cannot be parsed.
+ * Intentionally synchronous — called at startup before the agent loop.
+ */
+export function loadCodingSession() {
+    if (!existsSync(CODING_SESSION_FILE))
+        return null;
+    try {
+        const raw = readFileSync(CODING_SESSION_FILE, "utf-8").trim();
+        const match = raw.match(/<!-- CODING_SESSION_START -->([\s\S]*?)<!-- CODING_SESSION_END -->/);
+        if (!match)
+            return null;
+        return JSON.parse(match[1].trim());
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save the current coding session to ~/.careervivid/coding-session.md.
+ * Overwrites the previous entry — only the most recent session is kept here.
+ * Full history is preserved in memory.md via saveSessionMemory().
+ */
+export function saveCodingSession(data) {
+    try {
+        if (!existsSync(MEMORY_DIR))
+            mkdirSync(MEMORY_DIR, { recursive: true });
+        const filesList = data.filesChanged.length > 0
+            ? "## Files Changed\n" + data.filesChanged.map(f => `- \`${f}\``).join("\n")
+            : "";
+        const content = [
+            "# Last Coding Session",
+            "",
+            "> Auto-saved by cv agent --coding. Do not edit manually.",
+            "",
+            `**Saved:** ${data.savedAt}`,
+            `**Directory:** \`${data.cwd}\``,
+            `**Branch:** ${data.branch || "(no git)"}`,
+            "",
+            "## Summary",
+            data.summary,
+            "",
+            filesList,
+            "",
+            "<!-- CODING_SESSION_START -->",
+            JSON.stringify(data, null, 2),
+            "<!-- CODING_SESSION_END -->",
+        ].join("\n");
+        writeFileSync(CODING_SESSION_FILE, content, "utf-8");
+    }
+    catch {
+        // Non-fatal — session save failure must never crash the agent
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"coding.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/coding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAyGlC,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3C;AAMD,eAAO,MAAM,YAAY,EAAE,IAqC1B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IA0B3B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IA+C3B,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IA8C/B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA8C7B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,IAmD5B,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,yBAAyB,IAAI,IAAI,CAQhD;AAMD,eAAO,MAAM,eAAe,EAAE,IAkD7B,CAAC;AAMF,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAQlC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"coding.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/coding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAmGlC,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3C;AAMD,eAAO,MAAM,YAAY,EAAE,IAqC1B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IA0B3B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IA+C3B,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IA8C/B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA8C7B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,IAmD5B,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,yBAAyB,IAAI,IAAI,CAQhD;AAMD,eAAO,MAAM,eAAe,EAAE,IAkD7B,CAAC;AAMF,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAQlC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/agent/tools/coding.js

@@ -5,45 +5,38 @@ import { Type } from '@google/genai';
 // ============================================================================
 // Path-based Access Control (Least Privilege)
 // ============================================================================
+// ============================================================================
+// Path-based Access Control
+// ============================================================================
 /**
- * Directories the agent is ALLOWED to READ.
- * These are relative to the repo root (process.cwd()) or absolute paths the agent owns.
- */
-const READ_ALLOWED_PREFIXES = [
-    // Agent's own data & config
-    'career-vivid/', // job tracker CSV, résumé drafts, career data
-    'cli/', // CLI source — agent may read its own code
-    // Scratch / temporary outputs produced by the agent
-    'tmp/',
-    '/tmp/',
-    // User's home config file is read by loadConfig() — not by read_file tool
-];
-/**
- * Directories the agent is ALLOWED to WRITE.
- * This is intentionally much narrower than the read list.
- * Source code (src/, functions/, next-app/) is completely off-limits.
+ * In coding mode the agent operates like a real coding assistant (Antigravity-style).
+ * It can read and write files anywhere in the working directory tree.
+ *
+ * Hard-blocked regardless of mode:
+ *   - .env / .env.* files  (secrets)
+ *   - node_modules/        (package artifacts — use npm install)
+ *   - .git/                (git internals)
  */
-const WRITE_ALLOWED_PREFIXES = [
-    'career-vivid/', // job tracker CSV, résumé drafts — the only structured data the agent owns
-    'tmp/',
-    '/tmp/',
+const HARD_BLOCKED_PATTERNS = [
+    /\/\.env(\.\w+)?$/, // .env, .env.local, .env.production, etc.
+    /\/node_modules\//, // node_modules anywhere in path
+    /\/\.git\//, // .git internals
 ];
+function isHardBlocked(absPath) {
+    return HARD_BLOCKED_PATTERNS.some(re => re.test(absPath));
+}
 /**
- * Resolve a raw path argument and check it against an allowlist.
- * @throws if the resolved path falls outside every allowed prefix.
+ * Resolve a raw path argument and enforce hard-block rules.
+ * @throws if the path matches a hard-blocked pattern.
  */
-function guardPath(rawPath, allowedPrefixes, mode) {
+function guardPath(rawPath, _allowedPrefixes, mode) {
     const cwd = process.cwd();
     const absPath = normalize(resolve(rawPath));
-    const allowed = allowedPrefixes.some(prefix => {
-        const fullPrefix = prefix.startsWith('/') ? normalize(prefix) : normalize(join(cwd, prefix));
-        return absPath.startsWith(fullPrefix);
-    });
-    if (!allowed) {
+    if (isHardBlocked(absPath)) {
         const rel = relative(cwd, absPath);
-        throw new Error(`⛔ Access denied: ${mode} access to "${rel}" is not permitted.\n` +
-            `The agent can only ${mode} files inside: ${allowedPrefixes.join(', ')}\n` +
-            `To access this file, use your editor or the CareerVivid web app.`);
+        throw new Error(`⛔ Access denied: ${mode} access to "${rel}" is blocked for safety.\n` +
+            `Blocked paths: .env files, node_modules/, .git/\n` +
+            `Edit secrets manually in your editor.`);
     }
     return absPath;
 }
@@ -122,7 +115,7 @@ export const readFileTool = {
         required: ['path'],
     },
     execute: async (args) => {
-        const absPath = guardPath(args.path, READ_ALLOWED_PREFIXES, 'read');
+        const absPath = guardPath(args.path, [], 'read');
         if (!existsSync(absPath)) {
             throw new Error(`File not found: ${absPath}`);
         }
@@ -159,7 +152,7 @@ export const writeFileTool = {
         required: ['path', 'content'],
     },
     execute: async (args) => {
-        const absPath = guardPath(args.path, WRITE_ALLOWED_PREFIXES, 'write');
+        const absPath = guardPath(args.path, [], 'write');
         mkdirSync(dirname(absPath), { recursive: true });
         writeFileSync(absPath, args.content, 'utf-8');
         const lines = args.content.split('\n').length;
@@ -196,7 +189,7 @@ export const patchFileTool = {
         required: ['path', 'start_line', 'end_line', 'new_content'],
     },
     execute: async (args) => {
-        const absPath = guardPath(args.path, WRITE_ALLOWED_PREFIXES, 'write');
+        const absPath = guardPath(args.path, [], 'write');
         if (!existsSync(absPath))
             throw new Error(`File not found: ${absPath}`);
         const lines = readFileSync(absPath, 'utf-8').split('\n');

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAmJpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAqJpD"}

package/dist/commands/agent/index.js

@@ -6,6 +6,7 @@ import { getTools } from "./toolRegistry.js";
 import { getSystemInstruction, buildEngine, printBanner } from "./engineResolver.js";
 import { askLoop } from "./repl.js";
 import { initSessionContext } from "../../agent/agentAuditLog.js";
+import { resolvePersona } from "./personas.js";
 const { prompt } = pkg;
 export function registerAgentCommand(program) {
     const agentCmd = program
@@ -119,10 +120,11 @@ export function registerAgentCommand(program) {
         }
         const engine = buildEngine(selectedProvider, selectedModel, systemInstruction, tools, thinkingBudget, includeThoughts, cvApiKey, geminiApiKey, project);
         printBanner(options, selectedProvider, selectedModel, thinkingBudget);
-        // agentMode: jobs is now always the default
         const agentMode = options.resume ? "resume" : options.coding ? "coding" : "jobs";
         initSessionContext(agentMode, selectedModel);
-        await askLoop(engine, options, selectedProvider, selectedModel, cvApiKey, systemInstruction, tools);
+        // Resolve the active persona — drives menu, pick-up prompt, and context
+        const persona = resolvePersona(options);
+        await askLoop(engine, options, selectedProvider, selectedModel, cvApiKey, systemInstruction, tools, persona);
     });
     agentCmd.command("config")
         .description("Configure the default LLM provider for cv agent")

package/dist/commands/agent/personas.d.ts

@@ -0,0 +1,41 @@
+/**
+ * personas.ts — Extensible Persona Registry for cv agent
+ *
+ * Each persona defines:
+ *   - id:             unique key (matches the CLI flag name)
+ *   - label:          human-readable name shown in the banner
+ *   - menuItems:      first-turn autocomplete menu entries
+ *   - pickUpPrompt:   the system message injected when the user chooses
+ *                     "Pick up where we left off" — workspace-aware, not job-aware
+ *   - contextGather:  async function returning a markdown context snapshot
+ *                     of the current environment relevant to this persona
+ *
+ * ── Adding a new persona ──────────────────────────────────────────────────────
+ * 1. Add a new PersonaDefinition entry in PERSONAS below.
+ * 2. Register the matching --flag in index.ts (one line).
+ * 3. Done. The menu, context, and system prompt routing all work automatically.
+ */
+export interface PersonaDefinition {
+    id: string;
+    label: string;
+    /** Displayed in the first-turn autocomplete menu */
+    menuItems: string[];
+    /**
+     * Optional per-item prompt overrides.
+     * Key = exact menu item string. Value = the prompt sent to the agent.
+     * Items without an entry get the default emoji-stripped text.
+     */
+    menuPrompts?: Record<string, string>;
+    /** Used as the agent prompt when "Pick up where we left off" is selected */
+    pickUpPrompt: string;
+    /** Gathers live workspace context for the pick-up prompt */
+    contextGather: () => Promise<string>;
+}
+/**
+ * Resolve the active PersonaDefinition from the CLI options object.
+ * Falls back to the jobs persona.
+ */
+export declare function resolvePersona(options: Record<string, any>): PersonaDefinition;
+/** All registered personas — useful for dynamic --help generation. */
+export declare const ALL_PERSONAS: PersonaDefinition[];
+//# sourceMappingURL=personas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/personas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAwTD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAK9E;AAED,sEAAsE;AACtE,eAAO,MAAM,YAAY,qBAA6B,CAAC"}

package/dist/commands/agent/personas.js

@@ -0,0 +1,323 @@
+/**
+ * personas.ts — Extensible Persona Registry for cv agent
+ *
+ * Each persona defines:
+ *   - id:             unique key (matches the CLI flag name)
+ *   - label:          human-readable name shown in the banner
+ *   - menuItems:      first-turn autocomplete menu entries
+ *   - pickUpPrompt:   the system message injected when the user chooses
+ *                     "Pick up where we left off" — workspace-aware, not job-aware
+ *   - contextGather:  async function returning a markdown context snapshot
+ *                     of the current environment relevant to this persona
+ *
+ * ── Adding a new persona ──────────────────────────────────────────────────────
+ * 1. Add a new PersonaDefinition entry in PERSONAS below.
+ * 2. Register the matching --flag in index.ts (one line).
+ * 3. Done. The menu, context, and system prompt routing all work automatically.
+ */
+import { execSync } from "child_process";
+import { existsSync, readdirSync, statSync } from "fs";
+import { join } from "path";
+import { loadCodingSession } from "../../agent/memory.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Shared context helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function tryExec(cmd) {
+    try {
+        return execSync(cmd, { stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+    }
+    catch {
+        return "";
+    }
+}
+function getRecentlyModifiedFiles(dir, maxFiles = 8) {
+    const results = [];
+    function walk(current, depth = 0) {
+        if (depth > 3)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (name.startsWith(".") || name === "node_modules" || name === "__pycache__" || name === ".git")
+                continue;
+            const full = join(current, name);
+            try {
+                const st = statSync(full);
+                if (st.isDirectory()) {
+                    walk(full, depth + 1);
+                }
+                else if (/\.(ts|tsx|js|jsx|py|go|rs|java|cs|cpp|c|md|json|yaml|yml|sh|toml)$/.test(name)) {
+                    results.push({ path: full.replace(dir + "/", ""), mtime: st.mtimeMs });
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    walk(dir);
+    return results
+        .sort((a, b) => b.mtime - a.mtime)
+        .slice(0, maxFiles)
+        .map((f) => f.path);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Coding Persona
+// ─────────────────────────────────────────────────────────────────────────────
+async function gatherCodingContext() {
+    const cwd = process.cwd();
+    const lines = [];
+    // Git branch + last commit
+    const branch = tryExec("git branch --show-current");
+    const lastCommit = tryExec("git log --oneline -1");
+    const gitStatus = tryExec("git status --short").split("\n").slice(0, 10).join("\n");
+    if (branch)
+        lines.push(`**Git branch:** \`${branch}\``);
+    if (lastCommit)
+        lines.push(`**Last commit:** ${lastCommit}`);
+    if (gitStatus)
+        lines.push(`**Uncommitted changes:**\n\`\`\`\n${gitStatus}\n\`\`\``);
+    // Recent files
+    const recentFiles = getRecentlyModifiedFiles(cwd);
+    if (recentFiles.length > 0) {
+        lines.push(`**Recently modified files:**\n${recentFiles.map((f) => `  • \`${f}\``).join("\n")}`);
+    }
+    // Package.json / pyproject.toml project name
+    const pkgPath = join(cwd, "package.json");
+    const pyPath = join(cwd, "pyproject.toml");
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(require("fs").readFileSync(pkgPath, "utf-8"));
+            lines.push(`**Project:** ${pkg.name ?? "unknown"} v${pkg.version ?? "?"} (Node.js)`);
+        }
+        catch { /* ok */ }
+    }
+    else if (existsSync(pyPath)) {
+        const name = tryExec("grep '^name' pyproject.toml | head -1");
+        if (name)
+            lines.push(`**Project (Python):** ${name}`);
+    }
+    return lines.length > 0 ? lines.join("\n") : "No git repo or recognised project found in current directory.";
+}
+const CODING_PERSONA = {
+    id: "coding",
+    label: "Coding",
+    menuItems: [
+        "🔍 Analyze the current codebase or a specific file",
+        "🛠️  Debug an error or failing test",
+        "🏗️  Scaffold a new feature or module into an existing project",
+        "🔄 Refactor or optimize existing code",
+        "📖 Explain how a piece of code works",
+        "🧪 Write or improve tests",
+        "🆕 Create a brand-new project or app in a new folder",
+        "🌐 Debug or test in the browser",
+        "🗓️  Pick up where we left off",
+    ],
+    menuPrompts: {
+        "🔍 Analyze the current codebase or a specific file": [
+            `The user wants to analyze their codebase. Current working directory: \`${process.cwd()}\`.`,
+            `1. Run get_file_tree on the current directory to show the project structure.`,
+            `2. Ask the user: "Which file or directory would you like me to analyze? Or should I give you an overview of the whole project?"`,
+            `3. Wait for their answer before reading any files.`,
+        ].join("\n"),
+        "🛠️  Debug an error or failing test": [
+            `The user wants to debug an error or failing test. Current working directory: \`${process.cwd()}\`.`,
+            `1. Ask the user: "Please paste the full error message or test output, and tell me which file it's coming from."`,
+            `2. Once you have the error, read the relevant file(s) and identify the root cause.`,
+            `3. Apply a targeted fix with patch_file. Verify with run_command (e.g., npm test or tsc --noEmit).`,
+        ].join("\n"),
+        "🏗️  Scaffold a new feature or module into an existing project": [
+            `The user wants to scaffold a feature or module into their EXISTING project. Current working directory: \`${process.cwd()}\`.`,
+            ``,
+            `Before writing ANY files, ask the user these two questions in a single message:`,
+            `1. "What feature or module would you like to add?" — e.g., authentication, API route, React component, database model`,
+            `2. "Which directory should I add it to?" — e.g., src/components, src/api, lib/`,
+            ``,
+            `Do NOT write any files until you have both answers.`,
+            `Once you have the answers: read the relevant existing files first → Plan → write_file/patch_file → run_command to verify → Report all changed paths.`,
+        ].join("\n"),
+        "🆕 Create a brand-new project or app in a new folder": [
+            `The user wants to create a BRAND-NEW standalone project in a new folder. Current working directory: \`${process.cwd()}\`.`,
+            ``,
+            `Ask the user ONE message with these two questions:`,
+            `1. "What would you like to build?"`,
+            `   Give them examples to spark ideas:`,
+            `   • A modern HTML/CSS/JS dashboard visualising my CareerVivid job pipeline`,
+            `   • A React + Vite app with TypeScript`,
+            `   • A FastAPI Python REST API`,
+            `   • A Next.js full-stack app`,
+            `   • A Node.js CLI tool`,
+            `   • A static landing page`,
+            `   • Or describe anything else`,
+            `2. "What should the folder be called?" (e.g., job-dashboard, my-api, cool-app)`,
+            ``,
+            `Do NOT create any files or run any commands until you have both answers.`,
+            ``,
+            `Once you have the answers, follow this execution loop:`,
+            `  a. Plan: list every file you will create with a one-line description of each`,
+            `  b. Create the folder and write EVERY file using write_file`,
+            `     — For HTML/CSS/JS projects: write index.html, style.css, app.js (and any sub-files) with REAL, complete, production-quality code — NO placeholders`,
+            `     — For Node/Python projects: write package.json/pyproject.toml, README.md, and all source files`,
+            `     — For React/Next/Vite apps: write all config files AND source components`,
+            `  c. Run run_command to verify (e.g., \`tsc --noEmit\`, \`python -m py_compile\`, or \`open index.html\`)`,
+            `  d. Report: list every file created with its absolute path so the user can open them immediately`,
+            ``,
+            `Special case — Job Pipeline Dashboard:`,
+            `If the user asks for a dashboard based on their job application pipeline or CareerVivid data:`,
+            `  1. Run run_command with \`cat ~/career-vivid/jobs.csv\` to read their real job data`,
+            `  2. Parse the CSV and embed the actual data as a JavaScript array in the dashboard`,
+            `  3. Build a beautiful, modern HTML/CSS/JS single-file dashboard with:`,
+            `     — Kanban-style status columns (To Apply / Applied / Interview / Offer / Rejected)`,
+            `     — Cards for each job showing company, role, status, excitement score`,
+            `     — Summary stats bar (total jobs, applied %, top companies)`,
+            `     — A color-coded priority chart`,
+            `     — Responsive design that works on mobile`,
+            `  4. Write it to \`job-dashboard/index.html\` as a self-contained file (inline CSS + JS)`,
+            `  5. Run \`open job-dashboard/index.html\` so the user sees it immediately in their browser`,
+        ].join("\n"),
+        "🔄 Refactor or optimize existing code": [
+            `The user wants to refactor or optimize code. Current working directory: \`${process.cwd()}\`.`,
+            `1. Ask: "Which file or function would you like me to refactor? What's the goal — performance, readability, type safety, or something else?"`,
+            `2. Wait for their answer. Then read the file, propose a brief Plan, and apply changes with patch_file.`,
+        ].join("\n"),
+        "📖 Explain how a piece of code works": [
+            `The user wants an explanation of some code. Current working directory: \`${process.cwd()}\`.`,
+            `Ask: "Which file, function, or class would you like me to explain?"`,
+            `Once they answer, read the file and give a clear, structured explanation.`,
+        ].join("\n"),
+        "🧪 Write or improve tests": [
+            `The user wants to write or improve tests. Current working directory: \`${process.cwd()}\`.`,
+            `1. Ask: "Which file or function should I write tests for? And do you want unit tests, integration tests, or browser-based E2E tests?"`,
+            `2. Once they answer:`,
+            `   • For unit/integration tests: read the source file, detect the test framework (check package.json), write test files to disk with write_file, run with run_command.`,
+            `   • For browser E2E tests: use browser_navigate to open the app, browser_state to inspect, browser_click/browser_type to simulate user actions, browser_screenshot to verify results.`,
+            `3. Report all test files created and test results.`,
+        ].join("\n"),
+        "🌐 Debug or test in the browser": [
+            `The user wants to debug a visual/runtime issue OR test a feature directly in the browser. Current working directory: \`${process.cwd()}\`.`,
+            ``,
+            `First, ask ONE clarifying question: "What would you like to do?"`,
+            `Give these options:`,
+            `  • Debug a visual or layout bug in my running app`,
+            `  • Debug a JavaScript runtime error`,
+            `  • Smoke test / manually test a feature in the browser`,
+            `  • Run a browser-based E2E test on my app`,
+            `  • Verify my generated HTML/CSS/JS file looks correct`,
+            ``,
+            `Once you know what they want, follow the browser debug/test loop:`,
+            `1. Ask for the URL if not provided (e.g., http://localhost:3000 or a file path like ./index.html)`,
+            `2. Call browser_navigate(url) to open it`,
+            `3. Call browser_state() to get the page structure`,
+            `4. Call browser_screenshot() to visually inspect the page`,
+            `5. For debugging: identify the root cause, patch_file to fix it, browser_navigate to reload and verify`,
+            `6. For testing: browser_click / browser_type to simulate user interactions, browser_screenshot to confirm the expected result`,
+            `7. Report what was found and fixed/verified`,
+            ``,
+            `If the user's dev server is not running, offer to start it: run_command with \`npm run dev\` or equivalent.`,
+        ].join("\n"),
+    },
+    pickUpPrompt: (() => {
+        // Read the coding session file synchronously — this is O(1), no tool calls.
+        const last = loadCodingSession();
+        if (last) {
+            const fileList = last.filesChanged.length > 0
+                ? `Files changed last session:\n${last.filesChanged.slice(0, 10).map(f => `  • \`${f}\``).join("\n")}`
+                : "";
+            return [
+                `## Resuming Last Coding Session`,
+                ``,
+                `Here is the context from the last coding session (read from local memory — no tool calls needed):`,
+                ``,
+                `- **Directory:** \`${last.cwd}\``,
+                `- **Git branch:** ${last.branch || "(no git repo)"}`,
+                `- **Last built:** ${last.lastBuilt || "(unknown)"}`,
+                `- **Session saved:** ${new Date(last.savedAt).toLocaleString()}`,
+                ``,
+                `**What happened last time:**`,
+                last.summary,
+                ``,
+                fileList,
+                ``,
+                `The current working directory is now: \`${process.cwd()}\``,
+                ``,
+                `Greet the user with a ONE-LINE recap of what was worked on last time and ask what they want to continue or start next.`,
+                `Do NOT run any git commands or scan the filesystem — you already have the context above.`,
+                `Only call tools if the user asks for something new.`,
+            ].filter(Boolean).join("\n");
+        }
+        // No previous session — do a lightweight orientation
+        return [
+            `No previous coding session found in memory.`,
+            `Current working directory: \`${process.cwd()}\`.`,
+            ``,
+            `Ask the user: "What would you like to work on today?" — give them the menu options as a reminder.`,
+            `Do NOT run any commands or scan files until they answer.`,
+        ].join("\n");
+    })(),
+    contextGather: gatherCodingContext,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Jobs Persona (default)
+// ─────────────────────────────────────────────────────────────────────────────
+const JOBS_PERSONA = {
+    id: "jobs",
+    label: "Jobs & Applications",
+    menuItems: [
+        "📄 View or update my resume",
+        "🔍 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",
+    ],
+    pickUpPrompt: "The user wants to pick up their last job-search session. Check their resume list (cv tracker resume list), review their job tracker pipeline (cv tracker list), and provide a concise overview of where they left off. Suggest the most impactful next action.",
+    contextGather: async () => "",
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Resume Persona
+// ─────────────────────────────────────────────────────────────────────────────
+const RESUME_PERSONA = {
+    id: "resume",
+    label: "Resume Builder",
+    menuItems: [
+        "📄 View or load my current resume",
+        "✏️  Update a section of my resume",
+        "🎯 Tailor my resume for a specific job",
+        "🔗 Sync resume to my portfolio",
+        "💡 Get suggestions to improve my resume",
+        "🗓️  Pick up where we left off",
+    ],
+    pickUpPrompt: "The user wants to pick up their last resume session. List their resumes with get_resume or list_resumes, identify the most recently updated one, and summarise what was last worked on. Suggest the next improvement.",
+    contextGather: async () => "",
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Persona registry
+// ─────────────────────────────────────────────────────────────────────────────
+const PERSONA_MAP = {
+    coding: CODING_PERSONA,
+    jobs: JOBS_PERSONA,
+    resume: RESUME_PERSONA,
+    // Future:
+    // ceo:       CEO_PERSONA,
+    // finance:   FINANCE_PERSONA,
+    // marketing: MARKETING_PERSONA,
+};
+/**
+ * Resolve the active PersonaDefinition from the CLI options object.
+ * Falls back to the jobs persona.
+ */
+export function resolvePersona(options) {
+    for (const key of Object.keys(PERSONA_MAP)) {
+        if (options[key])
+            return PERSONA_MAP[key];
+    }
+    return JOBS_PERSONA;
+}
+/** All registered personas — useful for dynamic --help generation. */
+export const ALL_PERSONAS = Object.values(PERSONA_MAP);

package/dist/commands/agent/repl/input.d.ts

@@ -2,13 +2,22 @@
  * repl/input.ts
  *
  * Handles all user input collection:
- *  - First-turn quick-action menu (autocomplete)
+ *  - First-turn quick-action menu (autocomplete) — persona-aware
  *  - Subsequent turn free-text input
  *  - Multi-line paste mode (<<<)
  *  - Fast-paste buffer accumulation
  */
-/** Read the first-turn menu selection. Returns the cleaned user intent string. */
-export declare function readFirstTurnInput(): Promise<string>;
+import type { PersonaDefinition } from "../personas.js";
+/**
+ * Read the first-turn menu selection.
+ * Returns the cleaned user-intent string ready to send to the agent.
+ *
+ * When the user picks "Pick up where we left off" the persona's
+ * `pickUpPrompt` is returned instead of the raw menu label — so
+ * the agent receives a rich context-gathering instruction specific
+ * to the active mode (coding, jobs, resume, …).
+ */
+export declare function readFirstTurnInput(persona: PersonaDefinition): Promise<string>;
 /** Reads a single multi-line paste block. User ends with an empty Enter. */
 export declare function readMultiLineInput(prefix: string): Promise<string>;
 export interface InputResult {

package/dist/commands/agent/repl/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/commands/agent/repl/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,kFAAkF;AAClF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAyB1D;AAED,4EAA4E;AAC5E,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBxE;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAUrF"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/commands/agent/repl/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCpF;AAED,4EAA4E;AAC5E,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBxE;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAUrF"}

package/dist/commands/agent/repl/input.js

@@ -2,7 +2,7 @@
  * repl/input.ts
  *
  * Handles all user input collection:
- *  - First-turn quick-action menu (autocomplete)
+ *  - First-turn quick-action menu (autocomplete) — persona-aware
  *  - Subsequent turn free-text input
  *  - Multi-line paste mode (<<<)
  *  - Fast-paste buffer accumulation
@@ -10,19 +10,19 @@
 import chalk from "chalk";
 import pkg from "enquirer";
 const { prompt } = pkg;
-const MENU_ITEMS = [
-    "📄 View or update my resume",
-    "🔍 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",
-];
-/** Read the first-turn menu selection. Returns the cleaned user intent string. */
-export async function readFirstTurnInput() {
+const PICK_UP_LABEL = "🗓️  Pick up where we left off";
+/**
+ * Read the first-turn menu selection.
+ * Returns the cleaned user-intent string ready to send to the agent.
+ *
+ * When the user picks "Pick up where we left off" the persona's
+ * `pickUpPrompt` is returned instead of the raw menu label — so
+ * the agent receives a rich context-gathering instruction specific
+ * to the active mode (coding, jobs, resume, …).
+ */
+export async function readFirstTurnInput(persona) {
     console.log(chalk.dim("  What would you like to do today?\n"));
-    for (const item of MENU_ITEMS) {
+    for (const item of persona.menuItems) {
         console.log(chalk.dim(`  ${item}`));
     }
     console.log("");
@@ -30,17 +30,25 @@ export async function readFirstTurnInput() {
         type: "autocomplete",
         name: "choice",
         message: chalk.bold.hex("#6366f1")("❯") + chalk.dim(" ·"),
-        limit: 7,
+        limit: persona.menuItems.length,
         suggest(input, choices) {
             if (!input)
                 return choices;
             return choices.filter((c) => c.value.toLowerCase().includes(input.toLowerCase()));
         },
-        choices: MENU_ITEMS.map(item => ({ name: item, value: item })),
+        choices: persona.menuItems.map((item) => ({ name: item, value: item })),
         footer: chalk.dim("  ↑↓ to navigate  ·  type to filter  ·  Enter to send"),
     });
-    const raw = firstResp.choice?.trim() || "";
-    // Strip emoji prefixes so the agent gets clean text
+    const raw = firstResp.choice?.trim() ?? "";
+    // 1. "Pick up where we left off" → persona-specific context-gathering prompt
+    if (raw === PICK_UP_LABEL || raw.toLowerCase().includes("pick up")) {
+        return persona.pickUpPrompt;
+    }
+    // 2. Per-item prompt override (e.g. scaffold, debug) → rich targeted prompt
+    if (persona.menuPrompts?.[raw]) {
+        return persona.menuPrompts[raw];
+    }
+    // 3. Default: strip emoji prefix and send clean text
     return raw.replace(/^[\p{Emoji}\s]+/u, "").trim() || raw;
 }
 /** Reads a single multi-line paste block. User ends with an empty Enter. */

package/dist/commands/agent/repl.d.ts

@@ -11,6 +11,7 @@
 import { CareerVividProxyEngine } from "../../agent/CareerVividProxyEngine.js";
 import { QueryEngine } from "../../agent/QueryEngine.js";
 import { type LLMProvider } from "../../config.js";
+import type { PersonaDefinition } from "./personas.js";
 export declare function printCreditStatus(remaining: number | null, limit?: number | null): void;
 export declare function askLoop(engine: QueryEngine | CareerVividProxyEngine | null, options: {
     verbose?: boolean;
@@ -22,5 +23,5 @@ export declare function askLoop(engine: QueryEngine | CareerVividProxyEngine | n
     jobs?: boolean;
     resume?: boolean;
     coding?: boolean;
-}, selectedProvider: LLMProvider, selectedModel: string, cvApiKey: string | undefined, systemInstruction: string, tools: any[]): Promise<void>;
+}, selectedProvider: LLMProvider, selectedModel: string, cvApiKey: string | undefined, systemInstruction: string, tools: any[], persona: PersonaDefinition): Promise<void>;
 //# sourceMappingURL=repl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAanD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAsBtF;AA+DD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,EACD,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,GAAG,EAAE,GACX,OAAO,CAAC,IAAI,CAAC,CA4Kf"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUvD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAsBtF;AA+DD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,EACD,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,GAAG,EAAE,EACZ,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Kf"}

package/dist/commands/agent/repl.js

@@ -95,7 +95,7 @@ async function handle401Error(selectedProvider, options) {
     return true; // re-prompt
 }
 // ── Main REPL loop ────────────────────────────────────────────────────────────
-export async function askLoop(engine, options, selectedProvider, selectedModel, cvApiKey, systemInstruction, tools) {
+export async function askLoop(engine, options, selectedProvider, selectedModel, cvApiKey, systemInstruction, tools, persona) {
     let sessionTurns = 0;
     let sessionLimit = null;
     let currentModel = selectedModel;
@@ -123,7 +123,7 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
             let userInput;
             // ── Collect user input ──────────────────────────────────────────────
             if (isFirstTurn) {
-                userInput = await readFirstTurnInput();
+                userInput = await readFirstTurnInput(persona);
             }
             else {
                 const { text, isFastLine } = await readNormalInput(pasteBuffer.length > 0);

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;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,CAoDhG"}
+{"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,CAsDhG"}

package/dist/commands/agent/toolRegistry.js

@@ -274,6 +274,8 @@ export function getTools(options) {
         }
         return tools;
     }
-    // Default coding mode: file system + publish tools
-    return [...ALL_CODING_TOOLS, PublishArticleTool, GenerateDiagramTool, ...ALL_COVERLETTER_TOOLS, ...ALL_INTERVIEW_TOOLS];
+    // Default coding mode: file system tools + browser debugging tools
+    // Browser tools are included for dev debugging (inspect layout, check errors, verify local server).
+    // publish_article is NOT included — agent writes code to disk, not to community posts.
+    return [...ALL_CODING_TOOLS, ...ALL_BROWSER_TOOLS];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careervivid",
-  "version": "2.1.22",
+  "version": "2.1.30",
   "description": "Official CLI for CareerVivid — AI voice interviews, autonomous job applications, resume editing, and portfolio publishing from your terminal",
   "type": "module",
   "bin": {
@@ -52,7 +52,8 @@
     "ajv": "^6.12.6",
     "micromatch": "^4.0.8",
     "ws": ">=7.5.10",
-    "axios": ">=1.7.4"
+    "axios": ">=1.7.4",
+    "uuid": ">=14.0.0"
   },
   "keywords": [
     "careervivid",