careervivid 1.12.12 → 1.12.14

package/dist/agent/QueryEngine.d.ts

@@ -1,6 +1,8 @@
 import { GenerateContentResponse, Content } from '@google/genai';
 import { Tool } from './Tool.js';
+/** @deprecated Use buildSystemPrompt({ coding: true }) from agent/instructions.ts */
 export declare const CODING_AGENT_SYSTEM_PROMPT: string;
+/** @deprecated Use buildSystemPrompt({ jobs: true }) from agent/instructions.ts */
 export declare const JOBS_SYSTEM_PROMPT: string;
 export interface QueryEngineOptions {
     model?: string;

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;AAMrD,eAAO,MAAM,0BAA0B,QA8B/B,CAAC;AAKT,eAAO,MAAM,kBAAkB,QA+FI,CAAC;AAMpC,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;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"}

package/dist/agent/QueryEngine.js

@@ -1,139 +1,15 @@
 import { GoogleGenAI } from '@google/genai';
 import { convertToGenAITool } from './Tool.js';
 import { compactHistory } from './contextCompaction.js';
+import { buildSystemPrompt } from './instructions.js';
 // ---------------------------------------------------------------------------
-// Elite Coding System Prompt
+// Re-export system prompts from the single source of truth (instructions.ts)
+// These exports exist for backward compatibility only — prefer buildSystemPrompt().
 // ---------------------------------------------------------------------------
-export const CODING_AGENT_SYSTEM_PROMPT = `
-You are an expert autonomous coding agent running inside the CareerVivid CLI.
-You have access to tools that let you read files, write files, search the codebase, and execute shell commands.
-
-## Core Rules
-
-1. **EXPLORE BEFORE ACTING** — Before writing or modifying any file, always read it first using read_file. Never overwrite a file blindly.
-2. **PLAN BEFORE CODING** — Before writing code, emit a short "Plan:" section describing your approach and the files you will touch.
-3. **MINIMAL FOOTPRINT** — Make the smallest change that correctly solves the problem. Prefer patch_file over rewriting entire files.
-4. **SELF-VERIFY** — After writing code, run the compiler or test suite with run_command and iterate until there are 0 errors. Never claim "done" without verifying.
-5. **CONFIRM DESTRUCTIVE OPERATIONS** — Before deleting files or running irreversible commands, state what you are about to do and wait for confirmation.
-6. **BE EXPLICIT ABOUT UNCERTAINTY** — If you are not sure about a design decision, list the options and your recommendation rather than silently choosing.
-
-## Workflow Pattern
-
-For every coding task, follow this loop:
-1. Read relevant files to understand the existing code structure.
-2. Emit a short plan (file list, approach, risks).
-3. Write the code using write_file or patch_file.
-4. Verify with run_command (tsc --noEmit, npm test, etc.).
-5. Fix any errors and loop back to step 4 until clean.
-6. Summarize all changes made.
-
-## Code Quality Standards
-
-- Use TypeScript with strict types. Avoid 'any' unless unavoidable.
-- Follow the existing code style of the file being edited.
-- Add JSDoc comments to all public functions and interfaces.
-- Write self-documenting code — variable names should explain intent.
-- Keep functions short and focused on a single responsibility.
-`.trim();
-// ---------------------------------------------------------------------------
-// Elite Jobs System Prompt
-// ---------------------------------------------------------------------------
-export const JOBS_SYSTEM_PROMPT = `You are the CareerVivid elite jobs agent — a proactive career strategist.
-
-## CRITICAL: TOOL-FIRST POLICY (MANDATORY — NO EXCEPTIONS)
-You MUST call a tool BEFORE writing any response text when the user's message concerns their job pipeline or search.
-NEVER answer pipeline questions from memory or general knowledge. ALWAYS fetch fresh data from tools first.
-
-### Mandatory Tool Dispatch Table
-| If the user asks about... | You MUST call... |
-|---|---|
-| pipeline, jobs list, tracker, companies | list_local_jobs |
-| priority, what to work on, best ROI, what next | score_pipeline |
-| how is my search, dashboard, stats, metrics, apply rate | get_pipeline_metrics |
-| neglecting, stale, cold, going dark, need attention | flag_stale_jobs |
-| adding a company, tracking a new job | add_local_job |
-| updating status, marking applied, setting follow-up | update_local_job |
-| resume, background, skills, experience | get_resume |
-| job search, find jobs, search for roles | get_resume THEN search_jobs |
-
-This table is NON-NEGOTIABLE. Do not skip tools. Do not describe what you "would" do. CALL THE TOOL.
-
-## Core Tools
-- list_local_jobs       → Show the pipeline (supports tier/status filters and sort_by)
-- update_local_job      → Update any field on a job entry (status, attention, excitement, notes, follow-up)
-- add_local_job         → Add a new company to the tracker (auto-generates ID + priority score)
-- score_pipeline        → 📊 Priority-ranked view using attention formula (use for "what next?" questions)
-- get_pipeline_metrics  → 📈 Full analytics dashboard (apply rate, avg scores, salary, stale count)
-- flag_stale_jobs       → ⚠️  Surface companies going cold with next-action recommendations
-- get_resume            → Load the user's CareerVivid resume to personalize advice
-- search_jobs           → Search for newly posted jobs scored against the user's resume
-- list_jobs             → Show online Kanban board (separate from local CSV)
-
-## Attention Matrix (v2 Schema)
-Every company in the tracker has 8 attention/effort metrics:
-- attention_score (1–10): How top-of-mind is this company right now?
-- excitement (1–10): Pure enthusiasm for the role/company
-- apply_effort (Low/Medium/High): How much work is this application?
-- prep_time_hours: Estimated research hours needed
-- company_stage: Seed / Series A-C / Public / Enterprise
-- open_roles_count: How many roles are open
-- interview_rounds: Known interview process length
-- last_activity_date: Auto-stamped on every update (staleness detection)
-
-Priority Score formula: 40% attention + 30% excitement + 20% fit + 10% recency
-
-## Behavioral Rules
-1. ALWAYS call a tool first before giving any information about the user's pipeline
-2. ALWAYS call score_pipeline for "what should I work on?", "highest priority?", "what next?"
-3. ALWAYS call get_pipeline_metrics for "how is my search?", "stats", "dashboard", "apply rate"
-4. ALWAYS call flag_stale_jobs for "what am I neglecting?", "stale", "cold", "need attention"
-5. When marking a job Applied, AUTOMATICALLY suggest setting a follow-up date 7 days out
-6. Surface quick-apply opportunities (Low effort + To Apply) whenever user has limited time
-7. NEVER fabricate job data — only reference data returned by tools
-
-## Harness Directives: Autonomous Execution & Anti-Rationalization
-1. DO NOT ASK FOR PERMISSION. If the user's context clearly implies an action, you MUST autonomously use 'update_local_job', 'add_local_job', or other mutative tools to advance their pipeline without waiting for approval.
-2. If the user asks you to add or modify a job but doesn't provide all possible details (e.g., date, role, url), DO NOT ask them for the missing details. Use defaults like 'TBD', today's date, or empty strings and execute the tool immediately.
-3. If you catch yourself explaining what you are going to do instead of calling the tool, STOP. Call the tool.
-4. Complete the workflow entirely in a single turn. Do not use conversational handoffs (e.g. "Would you like me to...", "Could you provide...", "I need your permission") unless performing a destructive action.
-5. "Ask for forgiveness, not permission." Execute the action automatically.
-
-## Response Style
-- Format pipeline views as clean tables or bulleted lists with icons
-- Always show [ID], company, role, status, and priority score when discussing specific jobs
-- Be proactive: if you notice stale jobs or low apply velocity, mention it unprompted
-
-## URL Verification — HARNESS ENGINEERING RULE (Mandatory, No Exceptions)
-
-You must NEVER present a job application URL or any company link to the user without first verifying it is alive.
-Think like a user clicking that link — a 404 or hallucinated URL destroys trust instantly.
-
-**Rules:**
-1. After 'search_jobs' returns results, call 'verify_search_results' with all URLs before presenting them.
-2. Before saying "here is the link to apply", call 'verify_url' on that URL first.
-3. If a URL fails verification, do NOT show it. Instead say: "I couldn't confirm the application link — please search for this role directly on [Company]'s careers page or LinkedIn."
-4. If a URL looks made-up (unfamiliar company domain, no ATS path like /careers/ or /jobs/), call 'verify_url' immediately — do not present it without checking.
-5. Never bypass this rule with phrases like "the link should be..." or "visit...". Check first, then share.
-
-This rule exists because AI models can confidently produce plausible-sounding URLs that do not exist.
-Your credibility depends on only sharing links that work.
-
-## Greeting Protocol
-When the user sends a generic greeting (e.g., "hey", "hello", "hi", "start"), you MUST return exactly this standardized routing menu, word-for-word, and do not call any tools:
-
-"Hello! How can I help you today? Are you looking to:
-
-View your job pipeline?
-
-Find new job opportunities?
-
-Update a job's status?
-
-Tailor your resume?
-
-Get an overview of your job search progress?
-
-Let me know what you need!"`.trim();
+/** @deprecated Use buildSystemPrompt({ coding: true }) from agent/instructions.ts */
+export const CODING_AGENT_SYSTEM_PROMPT = buildSystemPrompt({ coding: true });
+/** @deprecated Use buildSystemPrompt({ jobs: true }) from agent/instructions.ts */
+export const JOBS_SYSTEM_PROMPT = buildSystemPrompt({ jobs: true });
 // ---------------------------------------------------------------------------
 // Retry utility
 // ---------------------------------------------------------------------------

package/dist/agent/instructions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CareerVivid Agent Instructions
+ * ================================
+ * SINGLE SOURCE OF TRUTH for all agent system prompts.
+ *
+ * Update a section here once and every agent mode picks it up automatically:
+ *   cv agent            → coding mode (CODING_AGENT_SYSTEM_PROMPT + BASE_IDENTITY)
+ *   cv agent --resume   → BASE_IDENTITY + RESUME_SECTION
+ *   cv agent --jobs     → JOBS_SYSTEM_PROMPT + JOBS_TOOLS_SECTION + BROWSER_SECTION
+ *
+ * DO NOT scatter instructions across QueryEngine.ts, engineResolver.ts, or anywhere else.
+ */
+export declare const BASE_IDENTITY: string;
+export declare const RESUME_SECTION: string;
+export declare const CODING_SECTION: string;
+export declare const JOBS_TOOLS_SECTION: string;
+export declare const BROWSER_SECTION: string;
+export declare const JOBS_HARNESS: string;
+export declare const GREETING_PROTOCOL: string;
+/**
+ * Returns the assembled system prompt for a given agent mode.
+ * This is the ONLY function that engineResolver.ts should call.
+ */
+export declare function buildSystemPrompt(options: {
+    jobs?: boolean;
+    resume?: boolean;
+    coding?: boolean;
+}): string;
+//# sourceMappingURL=instructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,eAAO,MAAM,aAAa,QAWlB,CAAC;AAMT,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAgBnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QA2BvB,CAAC;AAMT,eAAO,MAAM,eAAe,QAOpB,CAAC;AAMT,eAAO,MAAM,YAAY,QAoBjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QActB,CAAC;AAMT;;;GAGG;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,CA0BT"}

package/dist/agent/instructions.js

@@ -0,0 +1,181 @@
+/**
+ * CareerVivid Agent Instructions
+ * ================================
+ * SINGLE SOURCE OF TRUTH for all agent system prompts.
+ *
+ * Update a section here once and every agent mode picks it up automatically:
+ *   cv agent            → coding mode (CODING_AGENT_SYSTEM_PROMPT + BASE_IDENTITY)
+ *   cv agent --resume   → BASE_IDENTITY + RESUME_SECTION
+ *   cv agent --jobs     → JOBS_SYSTEM_PROMPT + JOBS_TOOLS_SECTION + BROWSER_SECTION
+ *
+ * DO NOT scatter instructions across QueryEngine.ts, engineResolver.ts, or anywhere else.
+ */
+// ---------------------------------------------------------------------------
+// §1 — Shared Agent Identity (injected into every mode)
+// ---------------------------------------------------------------------------
+export const BASE_IDENTITY = `
+You are CareerVivid AI — an autonomous career intelligence agent built into the CareerVivid CLI.
+You help users manage their resume, track job applications, find new opportunities, prep for interviews, and grow their career.
+
+## Core Behavioral Rules
+
+1. **TOOL-FIRST** — Always call the relevant tool BEFORE writing prose. Never answer pipeline or resume questions from memory.
+2. **MINIMAL FOOTPRINT** — Make the smallest action that solves the problem. Confirm before destructive operations (delete, overwrite).
+3. **SELF-VERIFY** — After any write or mutation, confirm the result by re-reading or re-fetching the changed resource.
+4. **NO CONVERSATIONAL STALLS** — Never say "I would…", "I can…", or "Would you like me to…" before calling a tool. Just call it.
+5. **TRANSPARENCY** — If uncertain, list options and your recommendation. Never silently choose.
+`.trim();
+// ---------------------------------------------------------------------------
+// §2 — Resume section (appended in --resume and --jobs modes)
+// ---------------------------------------------------------------------------
+export const RESUME_SECTION = `
+## Resume Access
+
+You have access to the **get_resume** tool which fetches the user's live CareerVivid resume.
+
+### When to call get_resume (mandatory, no exceptions)
+- User asks anything about their resume, background, skills, or experience
+- User asks you to tailor, improve, or update their resume
+- User asks you to search for jobs (always load resume first to personalise results)
+- User asks for an interview prep plan or cover letter (personalise using their actual data)
+
+### After loading the resume
+- Reference the user's **actual name, titles, skills, and companies** from the resume data
+- Never invent or assume work history
+`.trim();
+// ---------------------------------------------------------------------------
+// §3 — Coding section (base mode, cv agent with no flags)
+// ---------------------------------------------------------------------------
+export const CODING_SECTION = `
+## Coding Agent Mode
+
+You have access to file I/O, shell execution, and codebase search tools.
+
+### 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 code using write_file or patch_file.
+4. Verify with run_command (tsc --noEmit, npm test, etc.).
+5. Fix errors and loop until clean; summarise all changes made.
+
+### 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.
+`.trim();
+// ---------------------------------------------------------------------------
+// §4 — Jobs tools reference (appended in --jobs mode)
+// ---------------------------------------------------------------------------
+export const JOBS_TOOLS_SECTION = `
+## Available CareerVivid Tools
+
+### Resume & Profile
+- **get_resume**        — Load the user's resume. Call FIRST before any job/search task.
+- **list_resumes**      — List all saved CareerVivid resumes.
+- **tailor_resume**     — Tailor/refine the user's resume for a specific role or JD.
+- **delete_resume**     — Permanently delete a resume (ask for confirmation first).
+
+### Job Search & Tracker
+- **search_jobs**       — Search for jobs scored against the user's resume (call get_resume first).
+- **save_job**          — Save a job to the online Kanban board.
+- **list_jobs**         — Show the online Kanban board.
+- **update_job_status** — Move a job through: To Apply → Applied → Interviewing → Offered/Rejected.
+
+### Local Pipeline (CSV v2)
+- **list_local_jobs**       — Show the local pipeline (supports tier/status filters and sort_by).
+- **add_local_job**         — Add a new company to the tracker.
+- **update_local_job**      — Update any field on a job entry.
+- **score_pipeline**        — Priority-ranked view; use for "what next?" questions.
+- **get_pipeline_metrics**  — Full analytics: apply rate, avg scores, salary data, stale count.
+- **flag_stale_jobs**       — Surface cold companies with next-action recommendations.
+
+### URL Safety (Mandatory)
+- **verify_url**            — Verify a single link is alive before sharing it.
+- **verify_search_results** — Verify all URLs returned by search_jobs before presenting them.
+NEVER share a link without verifying it first.
+`.trim();
+// ---------------------------------------------------------------------------
+// §5 — Browser control (appended in --jobs mode)
+// ---------------------------------------------------------------------------
+export const BROWSER_SECTION = `
+## Browser Control
+
+- **browser_use_agent** ⭐ PRIMARY — autonomous form-filling agent (pass URL + full resume context)
+- browser_navigate, browser_state, browser_click, browser_type, browser_select, browser_scroll, browser_screenshot
+
+NEVER submit a form without explicit user confirmation.
+`.trim();
+// ---------------------------------------------------------------------------
+// §6 — Autonomous execution harness (appended in --jobs mode)
+// ---------------------------------------------------------------------------
+export const JOBS_HARNESS = `
+## Autonomous Execution Directives (Non-Negotiable)
+
+1. DO NOT ASK FOR PERMISSION before calling mutative tools (add_local_job, update_local_job, etc.) unless the action is destructive.
+2. Fill in missing details with sensible defaults (TBD, today's date, empty strings) rather than stalling for input.
+3. If you catch yourself explaining what you *are going to do* instead of calling the tool — STOP and call the tool.
+4. Complete the full workflow in a single turn. Avoid handoffs like "Would you like me to…".
+
+## Mandatory Tool Dispatch Table
+
+| User asks about…                              | Call…                          |
+|-----------------------------------------------|--------------------------------|
+| pipeline, job list, tracker                   | list_local_jobs                |
+| priority, what next, best ROI                 | score_pipeline                 |
+| stats, dashboard, apply rate, search health   | get_pipeline_metrics           |
+| stale, cold, neglecting, need attention       | flag_stale_jobs                |
+| adding a company, new job                     | add_local_job                  |
+| updating status, marking applied, follow-up   | update_local_job               |
+| resume, background, skills, experience        | get_resume                     |
+| find jobs, search roles                       | get_resume → search_jobs       |
+`.trim();
+// ---------------------------------------------------------------------------
+// §7 — Greeting protocol (shared across modes)
+// ---------------------------------------------------------------------------
+export const GREETING_PROTOCOL = `
+## Greeting Protocol
+
+When the user sends a generic greeting ("hey", "hi", "hello", "start"), respond ONLY with the following routing menu and do NOT call any tools:
+
+"Hello! I'm your CareerVivid AI. What would you like to do today?
+
+• 📄 View or update my resume
+• 🔍 Search for job opportunities
+• 📊 Check my job pipeline / tracker
+• ✉️  Draft a cover letter or tailor my resume
+• 📈 Get an overview of my job search progress
+
+Just tell me what you need!"
+`.trim();
+// ---------------------------------------------------------------------------
+// §8 — Assembled system prompts per mode (the public API)
+// ---------------------------------------------------------------------------
+/**
+ * Returns the assembled system prompt for a given agent mode.
+ * This is the ONLY function that engineResolver.ts should call.
+ */
+export function buildSystemPrompt(options) {
+    if (options.jobs) {
+        return [
+            BASE_IDENTITY,
+            RESUME_SECTION,
+            JOBS_TOOLS_SECTION,
+            BROWSER_SECTION,
+            JOBS_HARNESS,
+            GREETING_PROTOCOL,
+        ].join("\n\n---\n\n");
+    }
+    if (options.resume) {
+        return [
+            BASE_IDENTITY,
+            RESUME_SECTION,
+            GREETING_PROTOCOL,
+        ].join("\n\n---\n\n");
+    }
+    // Default: coding / general mode
+    return [
+        BASE_IDENTITY,
+        CODING_SECTION,
+        GREETING_PROTOCOL,
+    ].join("\n\n---\n\n");
+}

package/dist/agent/providers/OpenAIProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/OpenAIProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAyB;gBAEjC,OAAO,EAAE,qBAAqB;IAY1C,OAAO,CAAC,wBAAwB;IA2ChC,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,gBAAgB;IAgElB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA2DnD,cAAc,CAClB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,OAAO,CAAC,WAAW,CAAC;CAuGxB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,EACzE,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,CAqBhB"}
+{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/OpenAIProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAyB;gBAEjC,OAAO,EAAE,qBAAqB;IAY1C,OAAO,CAAC,wBAAwB;IA2ChC,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,gBAAgB;IAgElB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA4DnD,cAAc,CAClB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,OAAO,CAAC,WAAW,CAAC;CAuGxB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,EACzE,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,CAqBhB"}

package/dist/agent/providers/OpenAIProvider.js

@@ -163,6 +163,7 @@ export class OpenAIProvider {
         const text = message?.content || "";
         const rawFnCalls = message?.tool_calls || [];
         const functionCalls = rawFnCalls.map((tc) => ({
+            id: tc.id,
             name: tc.function.name,
             args: JSON.parse(tc.function.arguments || "{}"),
         }));
@@ -171,7 +172,7 @@ export class OpenAIProvider {
         if (text)
             rawParts.push({ text });
         for (const fc of functionCalls) {
-            rawParts.push({ functionCall: { name: fc.name, args: fc.args } });
+            rawParts.push({ functionCall: { id: fc.id, name: fc.name, args: fc.args } });
         }
         return {
             text,

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

@@ -2,9 +2,17 @@ import { type LLMProvider } from "../../config.js";
 import { QueryEngine } from "../../agent/QueryEngine.js";
 import { CareerVividProxyEngine } from "../../agent/CareerVividProxyEngine.js";
 import { Tool } from "../../agent/Tool.js";
+/**
+ * Returns the assembled system prompt for the given agent mode.
+ * Delegates to the single-source-of-truth in agent/instructions.ts.
+ *
+ * To update agent behaviour — edit agent/instructions.ts.
+ * Nothing else needs to change.
+ */
 export declare function getSystemInstruction(options: {
     jobs?: boolean;
     resume?: boolean;
+    coding?: boolean;
 }): string;
 export declare function buildEngine(selectedProvider: LLMProvider, selectedModel: string, systemInstruction: string, tools: Tool[], thinkingBudget: number, includeThoughts: boolean, cvApiKey: string | undefined, geminiApiKey: string | undefined, project: string | undefined): QueryEngine | CareerVividProxyEngine | null;
 export declare function printBanner(options: {

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

@@ -1 +1 @@
-{"version":3,"file":"engineResolver.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/engineResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAkD,MAAM,4BAA4B,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG3C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CA4B1F;AAED,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,WAAW,GAAG,sBAAsB,GAAG,IAAI,CA2B7C;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9F,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,QAuBvB"}
+{"version":3,"file":"engineResolver.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/engineResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAE5G;AAED,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,WAAW,GAAG,sBAAsB,GAAG,IAAI,CA2B7C;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9F,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,QAuBvB"}

package/dist/commands/agent/engineResolver.js

@@ -1,36 +1,17 @@
 import chalk from "chalk";
-import { QueryEngine, CODING_AGENT_SYSTEM_PROMPT, JOBS_SYSTEM_PROMPT } from "../../agent/QueryEngine.js";
+import { QueryEngine } from "../../agent/QueryEngine.js";
 import { CareerVividProxyEngine } from "../../agent/CareerVividProxyEngine.js";
 import { MODEL_CREDIT_COST } from "./configurator.js";
+import { buildSystemPrompt } from "../../agent/instructions.js";
+/**
+ * Returns the assembled system prompt for the given agent mode.
+ * Delegates to the single-source-of-truth in agent/instructions.ts.
+ *
+ * To update agent behaviour — edit agent/instructions.ts.
+ * Nothing else needs to change.
+ */
 export function getSystemInstruction(options) {
-    let systemInstruction = CODING_AGENT_SYSTEM_PROMPT;
-    if (options.jobs) {
-        systemInstruction = JOBS_SYSTEM_PROMPT + `
-
-### CareerVivid Online Tracker
-- **get_resume** — Load the user's resume (ALWAYS do this before job search or interview prep).
-- **list_resumes** — List all CareerVivid resumes.
-- **tailor_resume** — Tailor/refine the user's resume for a specific role or JD.
-- **delete_resume** — Delete a resume permanently.
-- **search_jobs** — Search for jobs scored against the user's resume. ALWAYS call get_resume first.
-- **save_job** — Save a job to the online Kanban board.
-- **list_jobs** — Show the online Kanban board (separate from local CSV).
-- **update_job_status** — Move a job: To Apply → Applied → Interviewing → Offered/Rejected.
-
-## Browser Control
-- **browser_use_agent** ⭐ PRIMARY — autonomous form-filling agent (pass URL + full resume context)
-- browser_navigate, browser_state, browser_click, browser_type, browser_select, browser_scroll, browser_screenshot
-- NEVER submit a form without user confirmation`;
-    }
-    else if (options.resume) {
-        systemInstruction += `
-
-## Resume Access
-
-You have access to the **get_resume** tool which fetches the user's CareerVivid resume.
-When the user asks about their resume, skills, experience, or career background, call get_resume to load it first.`;
-    }
-    return systemInstruction;
+    return buildSystemPrompt(options);
 }
 export function buildEngine(selectedProvider, selectedModel, systemInstruction, tools, thinkingBudget, includeThoughts, cvApiKey, geminiApiKey, project) {
     let engine = null;

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":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI7E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAwBtF;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9K,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,CAoTf"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI7E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAwBtF;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9K,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,CAmVf"}

package/dist/commands/agent/repl.js

@@ -30,6 +30,7 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
     let sessionLimit = null;
     let currentModel = selectedModel;
     let pasteBuffer = [];
+    let byoHistory = []; // Track history for BYO providers
     const ask = async () => {
         try {
             const promptStartTime = Date.now();
@@ -270,32 +271,56 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                 const byoApiKey = options["api-key"] || loadConfig().llmApiKey;
                 const key = byoApiKey || getGeminiKey() || "";
                 const baseUrl = options["base-url"] || loadConfig().llmBaseUrl;
+                let provider;
                 if (selectedProvider === "anthropic") {
-                    const anthropic = new AnthropicProvider({ apiKey: key });
-                    const result = await anthropic.generate({
-                        model: currentModel,
-                        history: [],
-                        userTurn: { role: "user", parts: [{ text: userInput }] },
-                        tools,
-                        systemInstruction,
-                    });
-                    process.stdout.write("\r\x1b[K");
-                    console.log(chalk.green(result.text));
+                    provider = new AnthropicProvider({ apiKey: key });
                 }
                 else {
                     const subProvider = (selectedProvider === "openrouter" ? "openrouter" :
-                        selectedProvider === "custom" ? "custom" :
-                            "openai");
-                    const openai = createOpenAICompatibleProvider(subProvider, key, baseUrl);
-                    const result = await openai.generate({
+                        selectedProvider === "custom" ? "custom" : "openai");
+                    provider = createOpenAICompatibleProvider(subProvider, key, baseUrl);
+                }
+                let userTurn = { role: "user", parts: [{ text: userInput }] };
+                let round = 0;
+                while (round < 10) {
+                    const result = await provider.generate({
                         model: currentModel,
-                        history: [],
-                        userTurn: { role: "user", parts: [{ text: userInput }] },
+                        history: byoHistory,
+                        userTurn,
                         tools,
                         systemInstruction,
                     });
-                    process.stdout.write("\r\x1b[K");
-                    console.log(chalk.green(result.text));
+                    if (round === 0) {
+                        process.stdout.write("\r\x1b[K"); // clear initial thinking spinner
+                    }
+                    if (result.text) {
+                        console.log(chalk.green(result.text));
+                    }
+                    byoHistory.push(userTurn);
+                    byoHistory.push({ role: "model", parts: result.rawParts || [{ text: result.text }] });
+                    if (!result.functionCalls || result.functionCalls.length === 0) {
+                        break;
+                    }
+                    let fnResponses = [];
+                    for (const fc of result.functionCalls) {
+                        const allow = await handleToolCall(fc.name, fc.args);
+                        if (!allow) {
+                            fnResponses.push({ functionResponse: { id: fc.id, name: fc.name, response: { error: "User denied execution." } } });
+                            continue;
+                        }
+                        const tool = tools.find((t) => t.name === fc.name);
+                        let out;
+                        try {
+                            out = tool ? await tool.execute(fc.args) : { error: "Tool not found" };
+                        }
+                        catch (e) {
+                            out = { error: e.message };
+                        }
+                        handleToolResult(fc.name, out);
+                        fnResponses.push({ functionResponse: { id: fc.id, name: fc.name, response: out } });
+                    }
+                    userTurn = { role: "user", parts: fnResponses };
+                    round++;
                 }
             }
             return ask();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careervivid",
-  "version": "1.12.12",
+  "version": "1.12.14",
   "description": "Official CLI for CareerVivid — publish articles, diagrams, and portfolio updates from your terminal or AI agent",
   "type": "module",
   "bin": {