careervivid 1.12.26 → 1.12.31

package/dist/agent/instructions.d.ts

@@ -14,7 +14,6 @@ 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;
 /**

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;AAEH,eAAO,MAAM,aAAa,QAalB,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"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,aAAa,QAalB,CAAC;AAMT,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAgBnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QAoCvB,CAAC;AAMT,eAAO,MAAM,YAAY,QAsCjB,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,CAyBT"}

package/dist/agent/instructions.js

@@ -74,62 +74,78 @@ export const JOBS_TOOLS_SECTION = `
 - **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.
+### Job Search
+- **search_jobs**       — Search for jobs scored against the user's resume. Returns results for review (dry_run by default — does NOT auto-save).
+
+### CSV Pipeline Tracker (tracker_*)
+These tools read/write jobs.csv — the local career-ops pipeline spreadsheet.
+- **tracker_list_jobs**      — Show the pipeline (supports tier/status filters and sort_by).
+- **tracker_add_job**        — Add a new company to the tracker.
+- **tracker_update_job**     — Update any field on a job entry (status, scores, notes, follow-up).
+- **tracker_rank_priority**  — Priority-ranked view; use for "what next?" questions.
+- **tracker_dashboard**      — Full analytics: apply rate, avg scores, salary data, stale count.
+- **tracker_find_stale**     — Surface cold companies with next-action recommendations.
+- **tracker_inspect_quality**— Scan for duplicates, missing URLs, and corrupted data (read-only).
+
+### Web Kanban Board (kanban_*)
+These tools read/write the Firebase Kanban board at careervivid.app/job-tracker.
+- **kanban_add_job**         — Save a job card to the web Kanban board.
+- **kanban_list_jobs**       — Show the web Kanban board.
+- **kanban_update_status**   — Move a Kanban card to a new status column.
+
+### Browser Automation (browser_*)
+- **browser_autofill_application** ⭐ — Auto-fill an application form in Chrome (does NOT submit).
+- browser_navigate, browser_state, browser_click, browser_type, browser_select, browser_scroll, browser_screenshot
 
 ### 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.
+- **verify_url**             — Verify a single link is alive before sharing it.
+- **verify_job_urls**        — Verify all URLs from a search_jobs result batch.
 NEVER share a link without verifying it first.
 `.trim();
 // ---------------------------------------------------------------------------
-// §5 — Browser control (appended in --jobs mode)
+// §5 — Autonomous execution harness (appended in --jobs mode)
 // ---------------------------------------------------------------------------
-export const BROWSER_SECTION = `
-## Browser Control
+export const JOBS_HARNESS = `
+## Autonomy Rules (Non-Negotiable)
 
-- **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
+### What you may do freely (no confirmation needed)
+- Call any read-only tool (tracker_list_jobs, tracker_dashboard, tracker_rank_priority, tracker_find_stale, tracker_inspect_quality, search_jobs, get_resume, etc.)
+- Add a new company/job entry via tracker_add_job (when the user explicitly names a company or approves a search result)
+- Update non-status fields (attention_score, excitement, notes, follow_up_date, etc.) via tracker_update_job
 
-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)
+### What requires explicit user confirmation
+- Changing status to "Applied", "Rejected", or "Ghosted" — present the proposed change and wait for "yes"
+- Deleting any entry
+- Submitting any web form via browser tools
+
+### Anti-hallucination rules (CRITICAL)
+- NEVER invent company names. All companies added via tracker_add_job MUST come from:
+  (a) verified search_jobs results with a real URL, OR (b) explicit user input naming the company.
+- If search_jobs returns 0 results: say so — do NOT generate fictional alternative companies.
+- Do NOT add more than 5 new companies in a single response without user review.
+- A company without a valid careers_url (starting with http) is flagged as unverified — add it with a note.
 
-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 (e.g., tailoring a resume, finding jobs) ONLY if explicitly requested or obviously needed. However, if the user just asks a simple targeted question (e.g., "Did you find X?", "Is my resume up to date?"), DO NOT trigger an unprompted mass workflow (like saving extra companies and rewriting multiple resumes). Answer the question immediately.
+### Deduplication rule (MANDATORY)
+Before calling tracker_add_job, ALWAYS check tracker_list_jobs to see if the company+role already exists.
+If it does, call tracker_update_job instead — never create a duplicate row.
 
 ## 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               |
+| pipeline, job list, tracker                   | tracker_list_jobs              |
+| priority, what next, best ROI                 | tracker_rank_priority          |
+| stats, dashboard, apply rate, search health   | tracker_dashboard              |
+| stale, cold, neglecting, need attention       | tracker_find_stale             |
+| duplicates, data quality, audit               | tracker_inspect_quality        |
+| adding a company, new job                     | tracker_add_job                |
+| updating status, marking applied, follow-up   | tracker_update_job             |
+| Kanban board, web tracker                     | kanban_list_jobs               |
 | resume, background, skills, experience        | get_resume                     |
 | find jobs, search roles                       | get_resume → search_jobs       |
 `.trim();
 // ---------------------------------------------------------------------------
-// §7 — Greeting protocol (shared across modes)
+// §6 — Greeting protocol (shared across modes)
 // ---------------------------------------------------------------------------
 export const GREETING_PROTOCOL = `
 ## Greeting Protocol
@@ -147,7 +163,7 @@ When the user sends a generic greeting ("hey", "hi", "hello", "start"), respond
 Just tell me what you need!"
 `.trim();
 // ---------------------------------------------------------------------------
-// §8 — Assembled system prompts per mode (the public API)
+// §7 — Assembled system prompts per mode (the public API)
 // ---------------------------------------------------------------------------
 /**
  * Returns the assembled system prompt for a given agent mode.
@@ -159,7 +175,6 @@ export function buildSystemPrompt(options) {
             BASE_IDENTITY,
             RESUME_SECTION,
             JOBS_TOOLS_SECTION,
-            BROWSER_SECTION,
             JOBS_HARNESS,
             GREETING_PROTOCOL,
         ].join("\n\n---\n\n");

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

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAmBlC,eAAO,MAAM,cAAc,EAAE,IA0F5B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,IA4EzB,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC;AAMF,eAAO,MAAM,mBAAmB,EAAE,IAwDjC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAgC3B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAmE9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAwB9B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,IAyO5B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EAU/B,CAAC"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAmBlC,eAAO,MAAM,cAAc,EAAE,IAmG5B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,IA4EzB,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC;AAMF,eAAO,MAAM,mBAAmB,EAAE,IAwDjC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAgC3B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAmE9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAwB9B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,IAyO5B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EAU/B,CAAC"}

package/dist/agent/tools/jobs.js

@@ -12,10 +12,10 @@ import { jobsHunt, jobsCreate, jobsList, jobsUpdate, resumeGet, resumesList, res
 // ---------------------------------------------------------------------------
 export const SearchJobsTool = {
     name: "search_jobs",
-    description: `Search for jobs that match a given role and location.
-The search automatically scores results against the user's CareerVivid resume.
-Returns a list of scored job opportunities with AI summaries and missing skills.
-Use this when the user asks to "find jobs", "search for roles", "look for positions", etc.`,
+    description: `Search for jobs matching a role and location, scored against the user's resume.
+Returns a scored list of job opportunities with AI summaries and missing skills.
+Use this when the user asks to "find jobs", "search for roles", "look for positions", etc.
+By default operates in dry_run mode — results are shown for review, nothing is saved automatically.`,
     parameters: {
         type: Type.OBJECT,
         properties: {
@@ -33,12 +33,16 @@ Use this when the user asks to "find jobs", "search for roles", "look for positi
             },
             min_score: {
                 type: Type.NUMBER,
-                description: "Optional. Minimum match score (0-100) to include in results. Use 60 for good matches, 80 for excellent matches only.",
+                description: "Optional. Minimum match score (0-100). Default is 70. Use 80 for excellent matches only.",
             },
             resume_id: {
                 type: Type.STRING,
                 description: "Optional. Specific resume ID to score against. If omitted, uses the user's latest resume.",
             },
+            dry_run: {
+                type: Type.BOOLEAN,
+                description: "Optional. Default: true. If true, shows results for review without auto-saving. Set false only if user explicitly says to save all results.",
+            },
         },
         required: ["role"],
     },
@@ -59,7 +63,7 @@ Use this when the user asks to "find jobs", "search for roles", "look for positi
             role: args.role,
             location: args.location,
             count: args.count ?? 10,
-            minScore: args.min_score,
+            minScore: args.min_score ?? 70, // default 70 to filter low-quality results
         });
         if (isApiError(result)) {
             return `Error searching jobs: ${result.message}`;
@@ -79,15 +83,20 @@ Use this when the user asks to "find jobs", "search for roles", "look for positi
                 `   Job ID: ${job.id}`);
         })
             .join("\n\n");
-        return (`Found ${result.total} jobs for "${args.role}"${args.location ? ` in ${args.location}` : ""}.\n` +
-            `Showing top ${result.jobs.length} results:\n\n${jobList}`);
+        const isDryRun = args.dry_run !== false; // default true
+        const dryRunNote = isDryRun
+            ? `\n\n📋 Review above. Say "add [company] to my tracker" to save specific ones.`
+            : "";
+        return (`Found ${result.total} jobs for "${args.role}"${args.location ? ` in ${args.location}` : ""}. ` +
+            `Showing top ${result.jobs.length} (min score ${args.min_score ?? 70}%):\n\n${jobList}` +
+            dryRunNote);
     },
 };
 // ---------------------------------------------------------------------------
 // Tool: save_job
 // ---------------------------------------------------------------------------
 export const SaveJobTool = {
-    name: "save_job",
+    name: "kanban_add_job",
     description: `Save a job to the user's CareerVivid job tracker Kanban board.
 The job will appear in the "To Apply" column of the /job-tracker page.
 Use this after finding interesting jobs via search_jobs, or when the user asks to "save", "add", or "track" a specific job.`,
@@ -154,7 +163,7 @@ Use this after finding interesting jobs via search_jobs, or when the user asks t
 // Tool: list_jobs
 // ---------------------------------------------------------------------------
 export const ListJobsTool = {
-    name: "list_jobs",
+    name: "kanban_list_jobs",
     description: `List the user's jobs from their CareerVivid job tracker Kanban board.
 Can filter by status. Use this when the user asks "what jobs do I have?", "show my tracker",
 "what's in my job pipeline?", "check my interviews", etc.`,
@@ -216,7 +225,7 @@ Can filter by status. Use this when the user asks "what jobs do I have?", "show
 // Tool: update_job_status
 // ---------------------------------------------------------------------------
 export const UpdateJobStatusTool = {
-    name: "update_job_status",
+    name: "kanban_update_status",
     description: `Move a job to a different status on the CareerVivid Kanban board.
 Use this when the user mentions: "I got an interview", "I applied to X", "I got an offer",
 "X rejected me", "move Y to applied", etc. The change will be visible in the /job-tracker UI.`,
@@ -412,7 +421,7 @@ MAKE SURE the user actually intends to delete it, as this is permanent.`,
 // Tool: apply_to_job
 // ---------------------------------------------------------------------------
 export const ApplyToJobTool = {
-    name: "apply_to_job",
+    name: "browser_autofill_application",
     description: `Open a job application in the user's Chrome browser and auto-fill it with AI-tailored answers.
 This tool launches Playwright, navigates to the job URL, extracts the form fields, fills them
 with AI-generated answers from the user's resume, and shows the user a final preview before submitting.

package/dist/agent/tools/local-tracker.d.ts

@@ -19,11 +19,17 @@
  *   flag_stale_jobs       → surface companies with no recent activity
  */
 import { Tool } from "../Tool.js";
+export interface JobValidationResult {
+    ok: boolean;
+    blockers: string[];
+    warnings: string[];
+}
 export declare const ListLocalJobsTool: Tool;
 export declare const UpdateLocalJobTool: Tool;
 export declare const AddLocalJobTool: Tool;
 export declare const ScorePipelineTool: Tool;
 export declare const GetPipelineMetricsTool: Tool;
 export declare const FlagStaleJobsTool: Tool;
+export declare const InspectQualityTool: Tool;
 export declare const ALL_LOCAL_TRACKER_TOOLS: Tool[];
 //# sourceMappingURL=local-tracker.d.ts.map

package/dist/agent/tools/local-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-tracker.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/local-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAwKlC,eAAO,MAAM,iBAAiB,EAAE,IA8H/B,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,IA2HhC,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IAmG7B,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IA2F/B,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,IA+GpC,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IAoE/B,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,IAAI,EAOzC,CAAC"}
+{"version":3,"file":"local-tracker.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/local-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAkClC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoOD,eAAO,MAAM,iBAAiB,EAAE,IA8H/B,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,IAqIhC,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IAkJ7B,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IA2F/B,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,IA+GpC,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,IAoE/B,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,IAsEhC,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,IAAI,EAQzC,CAAC"}

package/dist/agent/tools/local-tracker.js

@@ -19,10 +19,81 @@
  *   flag_stale_jobs       → surface companies with no recent activity
  */
 import { Type } from "@google/genai";
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
+import { verifyUrl } from "./urlVerifier.js";
+// ---------------------------------------------------------------------------
+// Job entry validation harness
+// ---------------------------------------------------------------------------
+/** Patterns that strongly suggest an AI-hallucinated company name. */
+const HALLUCINATED_COMPANY_PATTERNS = [
+    /synthai/i,
+    /innovatex/i,
+    /innovatech/i,
+    /datagenius/i,
+    /nexusai/i,
+    /quantumflow/i,
+    /skymind/i,
+    /integratex/i,
+    /aiworks/i,
+    /techsolutions\s*inc/i,
+    /aether\s*systems/i,
+    /cogni(serve|tech|flow)/i,
+    /gentech\s*ai/i,
+    /brightspark\s*labs/i,
+    /synapse\s*tech/i,
+    /veridian\s*ai/i,
+    // Generic filler patterns: "XYZ AI", "XYZ Solutions", "XYZ Labs" with single-word prefix
+    /^[A-Z][a-z]+(\s*(AI|Solutions|Labs|Systems|Technologies|Innovations|Tech|Ventures))+$/,
+];
+/**
+ * Pre-add validation harness.
+ * Runs structural + network checks before any row is written to jobs.csv.
+ */
+async function validateJobEntry(company, careersUrl) {
+    const blockers = [];
+    const warnings = [];
+    // ── 1. Company name hallucination check ──────────────────────────────────
+    for (const pattern of HALLUCINATED_COMPANY_PATTERNS) {
+        if (pattern.test(company)) {
+            blockers.push(`Company name "${company}" matches a known hallucination pattern. ` +
+                `Verify this is a real company before adding.`);
+            break;
+        }
+    }
+    // ── 2. URL verification (if provided) ────────────────────────────────────
+    if (careersUrl && careersUrl.startsWith("http")) {
+        const urlResult = await verifyUrl(careersUrl);
+        if (!urlResult.ok) {
+            blockers.push(`URL verification failed: ${urlResult.reason.replace(/^[❌⚠️✅]\s*/u, "")}`);
+        }
+        else if (urlResult.warning) {
+            warnings.push(`URL: ${urlResult.warning}`);
+        }
+        // ── 3. Domain ↔ company name coherence check ─────────────────────────
+        if (careersUrl.startsWith("http")) {
+            try {
+                const parsed = new URL(careersUrl);
+                const domain = parsed.hostname.replace(/^www\./, "").split(".")[0].toLowerCase();
+                const coName = company.toLowerCase().replace(/[^a-z0-9]/g, "");
+                const coShort = coName.slice(0, 5); // first 5 chars of company (no-spaces)
+                // Flag if domain has zero overlap with company name (e.g., stripe.com for "JPMorgan")
+                const domainMatchesCompany = domain.includes(coShort) ||
+                    coName.includes(domain) ||
+                    domain.length < 4; // short generics (e.g., "wk2" for Workday) are inconclusive
+                if (!domainMatchesCompany) {
+                    warnings.push(`Domain "${parsed.hostname}" may not match company "${company}" — double-check this is the right URL.`);
+                }
+            }
+            catch {
+                // URL parse failed — already caught in verifyUrl
+            }
+        }
+    }
+    return { ok: blockers.length === 0, blockers, warnings };
+}
 // ---------------------------------------------------------------------------
 // CSV path resolution
 // ---------------------------------------------------------------------------
@@ -126,6 +197,10 @@ function loadCsv() {
     return { rows: parseCsv(raw), path };
 }
 function saveCsv(rows, csvPath) {
+    // Auto-backup before every write — recoverable with jobs.csv.bak
+    if (existsSync(csvPath)) {
+        copyFileSync(csvPath, csvPath + ".bak");
+    }
     writeFileSync(csvPath, serializeCsv(rows), "utf-8");
 }
 function today() {
@@ -172,11 +247,11 @@ const EFFORT_ICONS = {
 // Tool: list_local_jobs
 // ---------------------------------------------------------------------------
 export const ListLocalJobsTool = {
-    name: "list_local_jobs",
-    description: `Read the local job pipeline from career-ops/data/jobs.csv.
+    name: "tracker_list_jobs",
+    description: `Read the job pipeline from jobs.csv (the career-ops tracker spreadsheet).
 Returns a formatted summary of target companies grouped by tier and status.
 Use this when the user asks to "show my job pipeline", "list target companies",
-"check my local tracker", "what companies am I targeting?", etc.
+"what companies am I targeting?", "check my pipeline", etc.
 Shows attention scores, apply effort, excitement, and follow-up dates.`,
     parameters: {
         type: Type.OBJECT,
@@ -296,15 +371,16 @@ Shows attention scores, apply effort, excitement, and follow-up dates.`,
 // Tool: update_local_job
 // ---------------------------------------------------------------------------
 export const UpdateLocalJobTool = {
-    name: "update_local_job",
-    description: `Update any field on a row in career-ops/data/jobs.csv by job ID.
+    name: "tracker_update_job",
+    description: `Update any field on a row in jobs.csv by job ID.
 Use this for:
 - Status changes: "Mark WorkOS as Applied"
 - Attention updates: "Set attention_score for CUR-001 to 10"
 - Follow-up dates: "Set follow-up for NEO-001 to 2026-04-20"
 - Notes: "Add note to VER-001: great culture, hiring manager is Jane"
 - Excitement: "Update excitement for TMP-001 to 9"
-Auto-stamps last_activity_date on every update.`,
+Auto-stamps last_activity_date on every update.
+IMPORTANT: To change status to 'Applied', you MUST also provide date_applied (YYYY-MM-DD). Otherwise return a confirmation prompt.`,
     parameters: {
         type: Type.OBJECT,
         properties: {
@@ -338,12 +414,17 @@ Auto-stamps last_activity_date on every update.`,
                 if (!VALID_STATUSES.includes(args.status)) {
                     return `❌ Invalid status "${args.status}". Valid: ${VALID_STATUSES.join(", ")}`;
                 }
+                // Gate: Applied requires explicit date_applied to prevent autonomous escalation
+                if (args.status === "Applied" && !args.date_applied && row.status !== "Applied") {
+                    return (`⚠️  CONFIRMATION REQUIRED\n` +
+                        `To mark "${row.company} — ${row.role}" as Applied, please confirm with a date:\n` +
+                        `  Example: "Yes, mark ${args.job_id} as Applied on ${today()}"`);
+                }
                 changes.push(`status: ${row.status} → ${args.status}`);
                 row.status = args.status;
-                // Auto-set date_applied when marking Applied
                 if (args.status === "Applied" && !row.date_applied) {
-                    row.date_applied = today();
-                    changes.push(`date_applied: auto-set to ${today()}`);
+                    row.date_applied = args.date_applied ?? today();
+                    changes.push(`date_applied: ${row.date_applied}`);
                 }
             }
             if (args.date_applied) {
@@ -393,9 +474,11 @@ Auto-stamps last_activity_date on every update.`,
                 row.interview_rounds = String(args.interview_rounds);
             }
             if (args.notes) {
+                const MAX_NOTES = 500;
+                const appendText = args.notes.length > 200 ? args.notes.slice(0, 200) + "…" : args.notes;
                 const existing = row.notes ? row.notes + "; " : "";
-                row.notes = (existing + args.notes).replace(/,/g, ";");
-                changes.push(`notes: appended "${args.notes.substring(0, 60)}"`);
+                row.notes = (existing + appendText).replace(/,/g, ";").slice(0, MAX_NOTES);
+                changes.push(`notes: appended "${appendText.substring(0, 60)}"`);
             }
             if (changes.length === 0) {
                 return `No changes specified for ${args.job_id}. Provide at least one field to update.`;
@@ -419,13 +502,16 @@ Auto-stamps last_activity_date on every update.`,
 // Tool: add_local_job
 // ---------------------------------------------------------------------------
 export const AddLocalJobTool = {
-    name: "add_local_job",
-    description: `Add a new company/role row to career-ops/data/jobs.csv.
+    name: "tracker_add_job",
+    description: `Add a new company/role row to jobs.csv (the career-ops pipeline tracker).
 Use this when the user says:
 - "Add Linear to my job tracker"
 - "Track this company: [name], [role], [url]"
 - "Add a Tier 1 target: Neon"
-Auto-generates a unique ID (e.g. LIN-001) and sets date_added + last_activity_date to today.`,
+Auto-generates a unique ID (e.g. LIN-001) and sets date_added + last_activity_date to today.
+IMPORTANT: Before calling this, check tracker_list_jobs to ensure the company+role is not already tracked.
+IMPORTANT: Provide a careers_url. The tool will verify the URL is live before writing.
+IMPORTANT: The tool auto-validates: dead URLs and hallucinated company names are BLOCKED.`,
     parameters: {
         type: Type.OBJECT,
         properties: {
@@ -449,10 +535,35 @@ Auto-generates a unique ID (e.g. LIN-001) and sets date_added + last_activity_da
     execute: async (args) => {
         try {
             const { rows, path } = loadCsv();
+            // ── Fix 1: Duplicate detection (company + role must be unique) ──────
+            const duplicate = rows.find((r) => r.company.toLowerCase() === args.company.toLowerCase() &&
+                (r.role ?? "").toLowerCase() === (args.role ?? "").toLowerCase());
+            if (duplicate) {
+                return (`⚠️  Duplicate detected: "${args.company} — ${args.role ?? "TBD"}" already exists (ID: ${duplicate.id}).\n` +
+                    `Use tracker_update_job with job_id="${duplicate.id}" to update it instead.`);
+            }
             const prefix = args.company.toUpperCase().replace(/[^A-Z]/g, "").slice(0, 3) || "JOB";
             const existing = rows.filter((r) => r.id.startsWith(prefix + "-")).length;
             const id = `${prefix}-${String(existing + 1).padStart(3, "0")}`;
             const todayStr = today();
+            // ── Validation harness (URL + company name) ────────────────────────
+            const validation = await validateJobEntry(args.company, args.careers_url);
+            if (!validation.ok) {
+                return (`❌ Cannot add "${args.company}" — validation failed:\n` +
+                    validation.blockers.map(b => `  • ${b}`).join("\n") +
+                    `\n\nFix these issues and try again, or ask the user to confirm the company is real.`);
+            }
+            // ── Fix 2: No URL = unverified origin → cap attention, add warning ──
+            const hasUrl = !!(args.careers_url && args.careers_url.startsWith("http"));
+            const cappedAttention = hasUrl
+                ? Math.min(10, args.attention_score ?? 7)
+                : Math.min(4, args.attention_score ?? 4);
+            const unverifiedNote = hasUrl ? "" : "⚠️ No verified URL — confirm role exists before applying.";
+            // ── Fix 4: Salary fields must be numeric only ─────────────────────
+            const parseSalary = (v) => (v && !isNaN(v) ? String(Math.round(v)) : "");
+            const baseNotes = (args.notes ?? "").replace(/,/g, ";");
+            const warningNotes = validation.warnings.map(w => `⚠️ ${w}`).join("; ");
+            const combinedNotes = [baseNotes, unverifiedNote, warningNotes].filter(Boolean).join("; ").slice(0, 500);
             const newRow = {
                 id,
                 company: args.company,
@@ -460,19 +571,19 @@ Auto-generates a unique ID (e.g. LIN-001) and sets date_added + last_activity_da
                 tier: String(args.tier ?? 2),
                 careers_url: args.careers_url ?? "",
                 ats: args.ats ?? "Direct",
-                status: "To Apply",
+                status: "To Apply", // Fix 3: always To Apply — never Applied at creation
                 date_added: todayStr,
                 date_applied: "",
                 follow_up_date: "",
                 contact: "",
                 contact_email: "",
-                salary_min: args.salary_min ? String(args.salary_min) : "",
-                salary_max: args.salary_max ? String(args.salary_max) : "",
+                salary_min: parseSalary(args.salary_min),
+                salary_max: parseSalary(args.salary_max),
                 location: args.location ?? "Remote",
-                notes: (args.notes ?? "").replace(/,/g, ";"),
+                notes: combinedNotes,
                 fit_score: String(args.fit_score ?? 7),
                 referral: "false",
-                attention_score: String(Math.min(10, args.attention_score ?? 7)),
+                attention_score: String(cappedAttention),
                 apply_effort: args.apply_effort ?? "Medium",
                 prep_time_hours: "2",
                 excitement: String(Math.min(10, args.excitement ?? 7)),
@@ -487,19 +598,25 @@ Auto-generates a unique ID (e.g. LIN-001) and sets date_added + last_activity_da
                 ? `$${args.salary_min.toLocaleString()}–$${args.salary_max.toLocaleString()}`
                 : "Not specified";
             const priority = priorityScore(newRow).toFixed(1);
+            const urlBadge = hasUrl ? "✅ Verified" : "⚠️ Unverified";
+            const warningSection = validation.warnings.length > 0
+                ? `\n  Warnings:\n` + validation.warnings.map(w => `    ⚠️  ${w}`).join("\n")
+                : "";
             return (`✅ Added to jobs.csv!\n\n` +
                 `  ID:             ${id}\n` +
                 `  Company:        ${args.company}\n` +
-                `  Role:           ${args.role}\n` +
+                `  Role:           ${args.role ?? "TBD"}\n` +
                 `  Tier:           ${args.tier ?? 2}\n` +
                 `  ATS:            ${args.ats ?? "Direct"}\n` +
                 `  Location:       ${args.location ?? "Remote"}\n` +
                 `  Salary:         ${salary}\n` +
-                `  Attention:      ${args.attention_score ?? 7}/10\n` +
+                `  Attention:      ${cappedAttention}/10\n` +
                 `  Excitement:     ${args.excitement ?? 7}/10\n` +
                 `  Apply Effort:   ${args.apply_effort ?? "Medium"}\n` +
                 `  Priority Score: ${priority}/10\n` +
-                `  Status:         To Apply\n`);
+                `  Status:         To Apply\n` +
+                `  URL:            ${args.careers_url || "None"} [${urlBadge}]\n` +
+                warningSection);
         }
         catch (err) {
             return `❌ Error adding to jobs.csv: ${err.message}`;
@@ -510,9 +627,9 @@ Auto-generates a unique ID (e.g. LIN-001) and sets date_added + last_activity_da
 // Tool: score_pipeline
 // ---------------------------------------------------------------------------
 export const ScorePipelineTool = {
-    name: "score_pipeline",
-    description: `Return the job pipeline ranked by priority score — the attention-weighted formula:
-  Priority = 40% attention_score + 30% excitement + 20% fit_score + 10% staleness_bonus
+    name: "tracker_rank_priority",
+    description: `Rank the jobs.csv pipeline by weighted priority score.
+  Formula: 40% attention_score + 30% excitement + 20% fit_score + 10% recency_bonus
 Use this when the user asks: "What should I work on today?", "Which jobs are highest priority?",
 "What's my best ROI right now?", "Rank my pipeline", "Easy wins first".
 Also returns quick-apply opportunities (Low effort + high score) separately.`,
@@ -596,12 +713,12 @@ Also returns quick-apply opportunities (Low effort + high score) separately.`,
 // Tool: get_pipeline_metrics
 // ---------------------------------------------------------------------------
 export const GetPipelineMetricsTool = {
-    name: "get_pipeline_metrics",
-    description: `Return comprehensive analytics about the job search pipeline.
-Includes: apply velocity, avg attention/excitement/fit, ATS breakdown, salary stats,
+    name: "tracker_dashboard",
+    description: `Return comprehensive analytics dashboard for the jobs.csv pipeline.
+Includes: apply rate, avg attention/excitement/fit, ATS breakdown, salary stats,
 stale company count, estimated total prep time, and a smart recommendation.
 Use this when the user asks: "How is my job search going?", "Give me pipeline stats",
-"What's my apply rate?", "Dashboard view of my search".`,
+"What's my apply rate?", "Dashboard view of my search", "pipeline analytics".`,
     parameters: {
         type: Type.OBJECT,
         properties: {
@@ -706,11 +823,11 @@ Use this when the user asks: "How is my job search going?", "Give me pipeline st
 // Tool: flag_stale_jobs
 // ---------------------------------------------------------------------------
 export const FlagStaleJobsTool = {
-    name: "flag_stale_jobs",
-    description: `Identify jobs with no recent activity and suggest next actions.
+    name: "tracker_find_stale",
+    description: `Find jobs in jobs.csv with no recent activity and suggest next actions.
 Use this when the user asks: "What jobs am I neglecting?", "Anything going stale?",
-"Which companies need attention?", "Clean up my pipeline".
-Returns a prioritized action list: Apply Now / Follow Up / Deprioritize?.`,
+"Which companies need attention?", "Clean up my pipeline", "what's cold?".
+Read-only — returns a prioritized action list: Apply Now / Follow Up / Deprioritize.`,
     parameters: {
         type: Type.OBJECT,
         properties: {
@@ -773,6 +890,75 @@ Returns a prioritized action list: Apply Now / Follow Up / Deprioritize?.`,
     },
 };
 // ---------------------------------------------------------------------------
+// Tool: tracker_inspect_quality
+// ---------------------------------------------------------------------------
+export const InspectQualityTool = {
+    name: "tracker_inspect_quality",
+    description: `Scan jobs.csv for data quality issues without modifying anything.
+Detects and reports: duplicate company+role entries, rows with no careers_url (unverified/hallucinated risk),
+rows where salary fields contain non-numeric text (corruption), and notes fields over 400 chars.
+Use this when the user asks: "clean up my tracker", "find duplicates", "audit my pipeline", "any bad data?".`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            _run: { type: Type.BOOLEAN, description: "Always set to true to run the tool." },
+        },
+        required: ["_run"],
+    },
+    execute: async () => {
+        try {
+            const { rows, path } = loadCsv();
+            const issues = [];
+            // 1. Duplicates by company+role
+            const seen = new Map();
+            for (const r of rows) {
+                const key = `${r.company.toLowerCase()}|${r.role.toLowerCase()}`;
+                if (seen.has(key)) {
+                    issues.push(`  🔁 Duplicate: [${r.id}] ${r.company} — ${r.role}  (first seen: ${seen.get(key)})`);
+                }
+                else {
+                    seen.set(key, r.id);
+                }
+            }
+            // 2. Missing careers_url
+            const noUrl = rows.filter((r) => !r.careers_url || !r.careers_url.startsWith("http"));
+            if (noUrl.length > 0) {
+                issues.push(`\n  ⚠️  ${noUrl.length} rows have no verified careers_url:`);
+                noUrl.slice(0, 10).forEach((r) => issues.push(`    [${r.id}] ${r.company} — ${r.role}`));
+                if (noUrl.length > 10)
+                    issues.push(`    ... and ${noUrl.length - 10} more.`);
+            }
+            // 3. Salary fields containing non-numeric text
+            const badSalary = rows.filter((r) => (r.salary_min && isNaN(Number(r.salary_min))) ||
+                (r.salary_max && isNaN(Number(r.salary_max))));
+            if (badSalary.length > 0) {
+                issues.push(`\n  💸 ${badSalary.length} rows with corrupted salary fields:`);
+                badSalary.forEach((r) => issues.push(`    [${r.id}] salary_min="${r.salary_min}" salary_max="${r.salary_max}"  (first 60 chars)`));
+            }
+            // 4. Notes overflow
+            const longNotes = rows.filter((r) => r.notes && r.notes.length > 400);
+            if (longNotes.length > 0) {
+                issues.push(`\n  📝 ${longNotes.length} rows with notes > 400 chars:`);
+                longNotes.forEach((r) => issues.push(`    [${r.id}] ${r.company} (${r.notes.length} chars)`));
+            }
+            if (issues.length === 0) {
+                return `✅ jobs.csv looks clean! ${rows.length} rows, no duplicates, all URLs present, salary fields valid.`;
+            }
+            return [
+                `🔍 Quality Report — ${rows.length} rows in ${path}`,
+                "─".repeat(60),
+                ...issues,
+                "─".repeat(60),
+                `\nTotal issues found: ${issues.filter(l => l.startsWith("  🔁")).length} duplicates, ${noUrl.length} missing URLs, ${badSalary.length} bad salaries, ${longNotes.length} long notes.`,
+                `\nTo fix: say "remove duplicates from my tracker" or "fix salary fields" and I will present a confirmation before writing.`,
+            ].join("\n");
+        }
+        catch (err) {
+            return `❌ Error inspecting jobs.csv: ${err.message}`;
+        }
+    },
+};
+// ---------------------------------------------------------------------------
 // Export
 // ---------------------------------------------------------------------------
 export const ALL_LOCAL_TRACKER_TOOLS = [
@@ -782,4 +968,5 @@ export const ALL_LOCAL_TRACKER_TOOLS = [
     ScorePipelineTool,
     GetPipelineMetricsTool,
     FlagStaleJobsTool,
+    InspectQualityTool,
 ];

package/dist/agent/tools/urlVerifier.js

@@ -247,7 +247,7 @@ and whether the URL is on a trusted ATS (Ashby, Greenhouse, Lever, etc.).`,
 };
 // ── Tool: verify_search_results ──────────────────────────────────────────────
 export const VerifySearchResultsTool = {
-    name: "verify_search_results",
+    name: "verify_job_urls",
     description: `Verify a batch of job URLs returned from search_jobs are all reachable.
 Use this after search_jobs to filter out dead or hallucinated links before showing results to the user.
 Returns a summary of which URLs passed and which failed, so you can present only working links.`,

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

@@ -1 +1 @@
-{"version":3,"file":"configurator.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/configurator.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0D,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI3G,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF,eAAO,MAAM,SAAS;;;;;GAyBrB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;GA+BtB,CAAC;AAEF,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEpD;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC;IACpE,gBAAgB,EAAE,WAAW,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAwJD"}
+{"version":3,"file":"configurator.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/configurator.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0D,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI3G,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF,eAAO,MAAM,SAAS;;;;;GAyBrB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;GA+BtB,CAAC;AAEF,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEpD;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC;IACpE,gBAAgB,EAAE,WAAW,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAiKD"}

package/dist/commands/agent/configurator.js

@@ -187,16 +187,26 @@ export async function promptForAgentModel(options = {}) {
                 chalk.dim("\n   Your key will be saved locally — you only need to enter it once."));
             console.log(chalk.dim(`\n   Get your key at: `) + chalk.cyan(providerKeyUrls[selectedProvider] ?? "the provider's website"));
             console.log();
-            const keyAnswer = await prompt({
-                type: "password",
-                name: "key",
-                message: `Enter your ${providerLabels[selectedProvider] ?? selectedProvider} API key:`,
-            });
-            apiKey = keyAnswer.key.trim();
+            try {
+                const keyAnswer = await prompt({
+                    type: "password",
+                    name: "key",
+                    message: `Enter your ${providerLabels[selectedProvider] ?? selectedProvider} API key:`,
+                });
+                apiKey = (keyAnswer?.key ?? "").trim();
+            }
+            catch {
+                // User pressed Escape or Ctrl+C — exit cleanly
+                console.log(chalk.dim("\n  Cancelled. Run `cv agent` again when you have your API key.\n"));
+                process.exit(0);
+            }
             if (apiKey) {
                 setProviderKey(selectedProvider, apiKey);
                 console.log(chalk.green(`\n✔ Key saved for ${providerLabels[selectedProvider] ?? selectedProvider}\n`));
             }
+            else {
+                console.log(chalk.yellow("\n⚠️  No key entered. Continuing without API key — the agent may fail.\n"));
+            }
         }
         else {
             apiKey = savedKey;

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,CA+bf"}
+{"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,EAA4D,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI7G,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,CAggBf"}

package/dist/commands/agent/repl.js

@@ -4,7 +4,7 @@ import ora from "ora";
 import { isSafeCommand } from "../../agent/tools/coding.js";
 import { CareerVividProxyEngine } from "../../agent/CareerVividProxyEngine.js";
 import { CV_MODELS } from "./configurator.js";
-import { loadConfig, getGeminiKey } from "../../config.js";
+import { loadConfig, getProviderKey, setProviderKey } from "../../config.js";
 const { prompt } = pkg;
 export function printCreditStatus(remaining, limit = null) {
     if (remaining === null)
@@ -203,12 +203,16 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                 run_command: "⚙️  Running command...",
                 write_file: "✏️  Writing file...",
                 patch_file: "✏️  Patching file...",
-                list_local_jobs: "📊 Checking job pipeline...",
-                add_local_job: "➕ Adding job to pipeline...",
-                update_local_job: "🔄 Updating job record...",
-                score_pipeline: "📈 Scoring pipeline...",
-                get_pipeline_metrics: "📊 Fetching pipeline metrics...",
-                flag_stale_jobs: "🚩 Checking stale jobs...",
+                tracker_list_jobs: "📊 Checking job pipeline...",
+                tracker_add_job: "➕ Adding job to pipeline...",
+                tracker_update_job: "🔄 Updating job record...",
+                tracker_rank_priority: "📈 Ranking pipeline...",
+                tracker_dashboard: "📊 Fetching pipeline analytics...",
+                tracker_find_stale: "🚩 Checking stale jobs...",
+                tracker_inspect_quality: "🔍 Inspecting data quality...",
+                kanban_add_job: "📌 Saving to Kanban board...",
+                kanban_list_jobs: "📋 Loading Kanban board...",
+                kanban_update_status: "🔄 Updating Kanban status...",
                 list_cover_letters: "📄 Loading cover letters...",
                 get_cover_letter: "📄 Reading cover letter...",
                 save_cover_letter: "💾 Saving cover letter...",
@@ -366,8 +370,8 @@ ${label}
                 sessionTurns++;
                 const { createOpenAICompatibleProvider } = await import("../../agent/providers/OpenAIProvider.js");
                 const { AnthropicProvider } = await import("../../agent/providers/AnthropicProvider.js");
-                const byoApiKey = options["api-key"] || loadConfig().llmApiKey;
-                const key = byoApiKey || getGeminiKey() || "";
+                const byoApiKey = options["api-key"] || getProviderKey(selectedProvider) || loadConfig().llmApiKey;
+                const key = byoApiKey || "";
                 const baseUrl = options["base-url"] || loadConfig().llmBaseUrl;
                 let provider;
                 if (selectedProvider === "anthropic") {
@@ -425,11 +429,71 @@ ${label}
             return ask();
         }
         catch (err) {
-            if (err.message && err.message.includes("cancelled")) {
+            const msg = err?.message ?? "";
+            // ── Clean exit on Ctrl+C / enquirer cancel ────────────────────────
+            if (!msg || msg.includes("cancelled") || msg.includes("User force closed")) {
                 console.log(chalk.gray("\nCancelled. Exiting.\n"));
                 process.exit(0);
             }
-            console.error(chalk.red(`\nAgent encountered an error: ${err.message}`));
+            // ── 401 unauthorized — offer key reset ───────────────────────────
+            const is401 = msg.includes("401") || msg.toLowerCase().includes("user not found") ||
+                msg.toLowerCase().includes("invalid api key") || msg.toLowerCase().includes("unauthorized");
+            if (is401 && selectedProvider && selectedProvider !== "careervivid") {
+                const providerLabels = {
+                    openai: "OpenAI", anthropic: "Anthropic",
+                    gemini: "Gemini", openrouter: "OpenRouter", custom: "Custom",
+                };
+                const providerKeyUrls = {
+                    openai: "https://platform.openai.com/api-keys",
+                    anthropic: "https://console.anthropic.com/settings/keys",
+                    gemini: "https://aistudio.google.com/app/apikey",
+                    openrouter: "https://openrouter.ai/settings/keys",
+                };
+                const label = providerLabels[selectedProvider] ?? selectedProvider;
+                console.log();
+                console.log(chalk.red(`❌ API key rejected by ${label} (401 Unauthorized).`));
+                console.log(chalk.dim(`   The saved key may be expired or invalid.`));
+                if (providerKeyUrls[selectedProvider]) {
+                    console.log(chalk.dim(`   Get a new key at: `) + chalk.cyan(providerKeyUrls[selectedProvider]));
+                }
+                console.log();
+                try {
+                    const resetAnswer = await prompt({
+                        type: "select",
+                        name: "action",
+                        message: "What would you like to do?",
+                        choices: [
+                            { name: "reset", message: `🔑 Enter a new ${label} API key` },
+                            { name: "continue", message: "⏭️  Continue anyway (will keep failing)" },
+                            { name: "exit", message: "🚪 Exit the agent" },
+                        ],
+                    });
+                    if (resetAnswer.action === "reset") {
+                        const keyAnswer = await prompt({
+                            type: "password",
+                            name: "key",
+                            message: `Enter your new ${label} API key:`,
+                        });
+                        const newKey = (keyAnswer?.key ?? "").trim();
+                        if (newKey) {
+                            setProviderKey(selectedProvider, newKey);
+                            // Update the key used for subsequent turns this session
+                            options["api-key"] = newKey;
+                            console.log(chalk.green(`\n✔ New ${label} key saved. Resuming session...\n`));
+                        }
+                    }
+                    else if (resetAnswer.action === "exit") {
+                        console.log(chalk.gray("\nGoodbye! 👋\n"));
+                        process.exit(0);
+                    }
+                }
+                catch {
+                    // User cancelled the reset prompt — just continue
+                }
+                return ask();
+            }
+            // ── Generic error ────────────────────────────────────────────────
+            console.error(chalk.red(`\nAgent encountered an error: ${msg}`));
             return ask();
         }
     };

package/dist/eval/runner.d.ts

@@ -7,8 +7,8 @@
  *    conversation history never bleeds between test cases.
  *
  * 2. SAFE TOOL EXECUTION DURING EVAL:
- *    - READ tools: auto-approved (list_local_jobs, get_resume, search_jobs, etc.)
- *    - WRITE tools (add_local_job, update_local_job): auto-denied by default.
+ *    - READ tools: auto-approved (tracker_list_jobs, get_resume, search_jobs, etc.)
+ *    - WRITE tools (tracker_add_job, tracker_update_job): auto-denied by default.
  *      Tests marked write-op use a TEMP COPY of jobs.csv so they can test
  *      write operations safely without modifying the real CSV.
  *

package/dist/eval/runner.js

@@ -7,8 +7,8 @@
  *    conversation history never bleeds between test cases.
  *
  * 2. SAFE TOOL EXECUTION DURING EVAL:
- *    - READ tools: auto-approved (list_local_jobs, get_resume, search_jobs, etc.)
- *    - WRITE tools (add_local_job, update_local_job): auto-denied by default.
+ *    - READ tools: auto-approved (tracker_list_jobs, get_resume, search_jobs, etc.)
+ *    - WRITE tools (tracker_add_job, tracker_update_job): auto-denied by default.
  *      Tests marked write-op use a TEMP COPY of jobs.csv so they can test
  *      write operations safely without modifying the real CSV.
  *
@@ -50,8 +50,8 @@ function getToolsForMode(mode) {
         return ALL_JOB_TOOLS.filter((t) => ["get_resume", "tailor_resume", "list_resumes"].includes(t.name));
     }
     if (mode === "jobs") {
-        const jobTools = ALL_JOB_TOOLS.filter((t) => ["get_resume", "search_jobs", "save_job", "list_jobs", "update_job_status"].includes(t.name));
-        // All local tracker tools: list, update, add, score_pipeline, get_pipeline_metrics, flag_stale_jobs
+        const jobTools = ALL_JOB_TOOLS.filter((t) => ["get_resume", "search_jobs", "kanban_add_job", "kanban_list_jobs", "kanban_update_status"].includes(t.name));
+        // All local tracker tools: list, update, add, tracker_rank_priority, tracker_dashboard, tracker_find_stale
         return [...jobTools, ...ALL_LOCAL_TRACKER_TOOLS];
     }
     return []; // base mode: no domain-specific tools injected
@@ -202,11 +202,11 @@ export class AgentEvalRunner {
         const onToolCall = async (toolName, _args) => {
             toolsCalled.push(toolName);
             // Write tools that mutate jobs.csv — deny on read-only tests
-            const isWriteTool = ["update_local_job", "add_local_job"].includes(toolName);
+            const isWriteTool = ["tracker_update_job", "tracker_add_job"].includes(toolName);
             if (isWriteTool && !isWriteOp)
                 return false;
-            // All read tools (list_local_jobs, score_pipeline, get_pipeline_metrics, flag_stale_jobs,
-            //   get_resume, search_jobs, list_jobs) are auto-approved
+            // All read tools (tracker_list_jobs, tracker_rank_priority, tracker_dashboard, tracker_find_stale,
+            //   get_resume, search_jobs, kanban_list_jobs) are auto-approved
         };
         for (const turn of tc.turns) {
             const t0 = Date.now();

package/dist/eval/test-cases/jobs-agent.js

@@ -20,14 +20,14 @@ export const JOBS_AGENT_TESTS = [
         turns: [
             {
                 prompt: "Check my local tracker and show me all the companies I'm currently tracking — grouped by tier and status.",
-                expectTools: ["list_local_jobs"],
-                forbidTools: ["update_local_job", "add_local_job"],
+                expectTools: ["tracker_list_jobs"],
+                forbidTools: ["tracker_update_job", "tracker_add_job"],
                 expectedKeywords: ["tier", "status", "company"],
             },
         ],
         rubric: {
             intent: "User wants to see all companies they're tracking in jobs.csv.",
-            goodResponse: "Calls list_local_jobs with no filters and presents a clear, well-formatted summary grouped by tier and status, showing attention scores, excitement, effort and pipeline summary counts.",
+            goodResponse: "Calls tracker_list_jobs with no filters and presents a clear, well-formatted summary grouped by tier and status, showing attention scores, excitement, effort and pipeline summary counts.",
             badResponse: "Calls a different tool, returns unstructured data, or fabricates company data.",
         },
     },
@@ -39,7 +39,7 @@ export const JOBS_AGENT_TESTS = [
         turns: [
             {
                 prompt: "I want to add Linear to my job tracker. It's a Tier 1 target for a Senior Software Engineer role. Their careers page is at https://linear.app/careers. They use Ashby ATS.",
-                expectTools: ["add_local_job"],
+                expectTools: ["tracker_add_job"],
                 expectedKeywords: ["linear", "added", "tier", "LIN"],
             },
             {
@@ -49,7 +49,7 @@ export const JOBS_AGENT_TESTS = [
         ],
         rubric: {
             intent: "User wants to add a new Tier 1 company and recall the auto-generated ID.",
-            goodResponse: "Calls add_local_job with all provided details, reports auto-generated ID (LIN-001), and recalls it in turn 2.",
+            goodResponse: "Calls tracker_add_job with all provided details, reports auto-generated ID (LIN-001), and recalls it in turn 2.",
             badResponse: "Fails to call tool, misses ATS/tier, or can't recall ID in turn 2.",
         },
     },
@@ -61,18 +61,18 @@ export const JOBS_AGENT_TESTS = [
         turns: [
             {
                 prompt: "Show me all jobs I haven't applied to yet.",
-                expectTools: ["list_local_jobs"],
-                forbidTools: ["update_local_job"],
+                expectTools: ["tracker_list_jobs"],
+                forbidTools: ["tracker_update_job"],
                 expectedKeywords: ["to apply", "status"],
             },
             {
                 prompt: "Pick the first Tier 1 company in the list and mark it as Applied. Set today as the application date.",
-                expectTools: ["update_local_job"],
+                expectTools: ["tracker_update_job"],
                 expectedKeywords: ["applied", "updated", "date"],
             },
             {
                 prompt: "Set a follow-up reminder for that same company in 5 days from today.",
-                expectTools: ["update_local_job"],
+                expectTools: ["tracker_update_job"],
                 expectedKeywords: ["follow", "updated"],
             },
         ],
@@ -140,16 +140,16 @@ export const JOBS_AGENT_TESTS = [
             },
             {
                 prompt: "For each of those 3 companies, pull up what I have in my local tracker if anything, and tell me the current status.",
-                expectTools: ["list_local_jobs"],
+                expectTools: ["tracker_list_jobs"],
             },
             {
                 prompt: "Of those I'm not tracking yet, which one should I add first and why?",
-                forbidTools: ["add_local_job"],
+                forbidTools: ["tracker_add_job"],
                 expectedKeywords: ["recommend", "add", "because", "first"],
             },
             {
                 prompt: "OK, go ahead and add that company to my tracker as a Tier 1 target.",
-                expectTools: ["add_local_job"],
+                expectTools: ["tracker_add_job"],
                 expectedKeywords: ["added", "tier"],
             },
         ],
@@ -162,58 +162,58 @@ export const JOBS_AGENT_TESTS = [
     // ── NEW v2 tests (attention matrix + new tools) ───────────────────────────
     {
         id: "JOBS-007",
-        name: "Priority Pipeline Ranking (score_pipeline)",
+        name: "Priority Pipeline Ranking (tracker_rank_priority)",
         agentMode: "jobs",
         tags: ["single-turn", "tool-use", "attention-matrix"],
         turns: [
             {
                 prompt: "Run a priority ranking of my tracker data and tell me what to work on today. I want to see the quick apply opportunities at the top.",
-                expectTools: ["score_pipeline"],
-                forbidTools: ["update_local_job", "add_local_job"],
+                expectTools: ["tracker_rank_priority"],
+                forbidTools: ["tracker_update_job", "tracker_add_job"],
                 expectedKeywords: ["priority", "effort", "apply"],
             },
         ],
         rubric: {
             intent: "User wants an attention-weighted ranked view of their pipeline to decide what to do next.",
-            goodResponse: "Calls score_pipeline, presents the ranked list with priority scores, highlights Low-effort quick-apply opportunities separately, and makes a concrete recommendation.",
-            badResponse: "Uses list_local_jobs without sorting, doesn't call score_pipeline, or fails to highlight quick-apply opportunities.",
+            goodResponse: "Calls tracker_rank_priority, presents the ranked list with priority scores, highlights Low-effort quick-apply opportunities separately, and makes a concrete recommendation.",
+            badResponse: "Uses tracker_list_jobs without sorting, doesn't call tracker_rank_priority, or fails to highlight quick-apply opportunities.",
         },
     },
     {
         id: "JOBS-008",
-        name: "Pipeline Analytics Dashboard (get_pipeline_metrics)",
+        name: "Pipeline Analytics Dashboard (tracker_dashboard)",
         agentMode: "jobs",
         tags: ["single-turn", "tool-use", "analytics"],
         turns: [
             {
                 prompt: "Pull up my pipeline stats. I want the full analytics dashboard — apply rate, average attention scores, how many are stale, and a recommendation.",
-                expectTools: ["get_pipeline_metrics"],
-                forbidTools: ["update_local_job", "add_local_job"],
+                expectTools: ["tracker_dashboard"],
+                forbidTools: ["tracker_update_job", "tracker_add_job"],
                 expectedKeywords: ["apply rate", "attention", "stale", "recommend"],
             },
         ],
         rubric: {
             intent: "User wants a comprehensive analytics view of their job search pipeline health.",
-            goodResponse: "Calls get_pipeline_metrics, surfaces at minimum: apply rate %, avg attention/excitement/fit scores, stale count, ATS breakdown, and a smart recommendation. Formats results clearly.",
-            badResponse: "Uses list_local_jobs and manually counts, doesn't mention stale jobs or averages, or provides no recommendation.",
+            goodResponse: "Calls tracker_dashboard, surfaces at minimum: apply rate %, avg attention/excitement/fit scores, stale count, ATS breakdown, and a smart recommendation. Formats results clearly.",
+            badResponse: "Uses tracker_list_jobs and manually counts, doesn't mention stale jobs or averages, or provides no recommendation.",
         },
     },
     {
         id: "JOBS-009",
-        name: "Stale Job Detection (flag_stale_jobs)",
+        name: "Stale Job Detection (tracker_find_stale)",
         agentMode: "jobs",
         tags: ["single-turn", "tool-use", "attention-matrix"],
         turns: [
             {
                 prompt: "Scan my tracker for anything going stale — companies I've been neglecting. Flag them and give me a specific action for each one.",
-                expectTools: ["flag_stale_jobs"],
-                forbidTools: ["update_local_job", "add_local_job"],
+                expectTools: ["tracker_find_stale"],
+                forbidTools: ["tracker_update_job", "tracker_add_job"],
                 expectedKeywords: ["stale", "action", "apply", "follow"],
             },
         ],
         rubric: {
             intent: "User wants to surface neglected jobs with per-company action recommendations.",
-            goodResponse: "Calls flag_stale_jobs, presents stale companies with per-company actions (Apply Now / Follow Up / Deprioritize), and summarizes total counts. Offers next step.",
+            goodResponse: "Calls tracker_find_stale, presents stale companies with per-company actions (Apply Now / Follow Up / Deprioritize), and summarizes total counts. Offers next step.",
             badResponse: "Lists all jobs without filtering for staleness, doesn't provide action recommendations, or guesses stale jobs without calling the tool.",
         },
     },
@@ -225,23 +225,23 @@ export const JOBS_AGENT_TESTS = [
         turns: [
             {
                 prompt: "Show me my Tier 1 companies sorted by attention score.",
-                expectTools: ["list_local_jobs"],
-                forbidTools: ["update_local_job"],
+                expectTools: ["tracker_list_jobs"],
+                forbidTools: ["tracker_update_job"],
             },
             {
                 prompt: "I'm feeling super energized about Cursor right now. Set my attention score for CUR-001 to 10 and excitement to 10.",
-                expectTools: ["update_local_job"],
+                expectTools: ["tracker_update_job"],
                 expectedKeywords: ["updated", "attention", "excitement", "CUR-001"],
             },
             {
                 prompt: "Now re-rank my pipeline and tell me what the new top 3 are.",
-                expectTools: ["score_pipeline"],
+                expectTools: ["tracker_rank_priority"],
                 expectedKeywords: ["Cursor", "priority"],
             },
         ],
         rubric: {
             intent: "User updates attention/excitement scores and immediately sees the effect on priority ranking.",
-            goodResponse: "Lists Tier 1 companies, updates CUR-001 attention=10 and excitement=10, then calls score_pipeline and shows Cursor at or near the top of the ranking.",
+            goodResponse: "Lists Tier 1 companies, updates CUR-001 attention=10 and excitement=10, then calls tracker_rank_priority and shows Cursor at or near the top of the ranking.",
             badResponse: "Fails to update scores, updates wrong company, or doesn't re-rank after update.",
         },
     },
@@ -253,24 +253,24 @@ export const JOBS_AGENT_TESTS = [
         turns: [
             {
                 prompt: "I have 30 minutes right now. Find me the highest-priority Low-effort job I can apply to immediately.",
-                expectTools: ["score_pipeline"],
-                forbidTools: ["update_local_job", "add_local_job"],
+                expectTools: ["tracker_rank_priority"],
+                forbidTools: ["tracker_update_job", "tracker_add_job"],
                 expectedKeywords: ["low", "effort", "apply"],
             },
             {
                 prompt: "Great. Mark that one as Applied right now and set a follow-up for 7 days from today.",
-                expectTools: ["update_local_job"],
+                expectTools: ["tracker_update_job"],
                 expectedKeywords: ["applied", "follow"],
             },
             {
                 prompt: "What's my apply rate now? And what are my next 3 priorities?",
-                expectTools: ["get_pipeline_metrics"],
+                expectTools: ["tracker_dashboard"],
                 expectedKeywords: ["apply", "rate", "priority"],
             },
         ],
         rubric: {
             intent: "Time-constrained apply decision → execution → impact check. Validates end-to-end apply workflow.",
-            goodResponse: "Identifies highest-priority Low-effort job from score_pipeline. Marks it Applied with follow-up in turn 2. Shows updated apply rate and refreshed priority list in turn 3.",
+            goodResponse: "Identifies highest-priority Low-effort job from tracker_rank_priority. Marks it Applied with follow-up in turn 2. Shows updated apply rate and refreshed priority list in turn 3.",
             badResponse: "Picks a medium/high-effort job, fails to set follow-up, or gives stale metrics without re-calling the tool.",
         },
     },
@@ -291,19 +291,19 @@ export const JOBS_AGENT_TESTS = [
             },
             {
                 prompt: "The top result looks interesting. Add it to my local tracker as a Tier 2 target with attention_score 8 and excitement 8.",
-                expectTools: ["add_local_job"],
+                expectTools: ["tracker_add_job"],
                 expectedKeywords: ["added", "tier", "attention"],
             },
             {
                 prompt: "How does this new company rank in my pipeline? Show me where it fits in my priority score.",
-                expectTools: ["score_pipeline"],
+                expectTools: ["tracker_rank_priority"],
                 expectedKeywords: ["priority", "score"],
             },
         ],
         rubric: {
             intent: "Full end-to-end workflow: search → discover → add to tracker → see priority ranking. Tests all major tools in sequence.",
-            goodResponse: "Uses resume context to search, adds the top result with specified scores, then shows score_pipeline where the new entry appears in the ranked list.",
-            badResponse: "Adds a different company than the top search result, omits attention/excitement scores, or doesn't call score_pipeline to show placement.",
+            goodResponse: "Uses resume context to search, adds the top result with specified scores, then shows tracker_rank_priority where the new entry appears in the ranked list.",
+            badResponse: "Adds a different company than the top search result, omits attention/excitement scores, or doesn't call tracker_rank_priority to show placement.",
         },
     },
 ];

package/package.json

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