career-compass-mcp 2.0.0

package/data/example/career/experience.yaml

@@ -0,0 +1,67 @@
+- role: Senior Program Manager
+  company: MedFlow Health Systems
+  industry: Healthcare Technology
+  location: Austin, TX (Remote)
+  startDate: "2021-03"
+  endDate: present
+  summary: >
+    Led enterprise-scale digital health initiatives across 14 hospital systems,
+    managing $8M in annual program budgets and a team of 6 PMs.
+  achievements:
+    - metric: Reduced average patient onboarding time from 47 days to 11 days
+      context: Inherited a manual, paper-heavy onboarding process after acquisition of 3 regional health systems
+      impact: Enabled 3x faster revenue recognition and eliminated $2.1M in compliance penalties over 18 months
+      keywords: [process improvement, healthcare, compliance, onboarding, automation]
+    - metric: Launched real-time capacity dashboard adopted by 94% of clinical staff within 60 days
+      context: COVID surge created critical visibility gaps across ICU bed availability
+      impact: Reduced emergency diversion incidents by 34% across 6 facilities
+      keywords: [stakeholder adoption, product launch, data visualization, cross-functional leadership]
+    - metric: Rebuilt vendor evaluation framework, reducing tool procurement cycle from 9 months to 6 weeks
+      context: Legacy RFP process was bottlenecking 7 technology initiatives simultaneously
+      impact: Unlocked $4.3M in modernization budget and reduced vendor cost overruns by 22%
+      keywords: [vendor management, procurement, operations, frameworks, cost reduction]
+  tags: [healthcare, program management, executive stakeholders, cross-functional, remote]
+
+- role: Operations Manager
+  company: Apex Logistics Partners
+  industry: Logistics & Supply Chain
+  location: Denver, CO
+  startDate: "2018-06"
+  endDate: "2021-02"
+  summary: >
+    Managed end-to-end operations for a regional 3PL serving 120+ retail clients,
+    overseeing warehouse operations, carrier relationships, and a team of 42.
+  achievements:
+    - metric: Grew on-time delivery rate from 81% to 97.3% in 14 months
+      context: Inherited an underperforming network with high carrier churn and manual routing
+      impact: Retained 3 major retail accounts worth $6.8M annually that were at risk of churning
+      keywords: [operations, logistics, KPI improvement, team leadership, process optimization]
+    - metric: Reduced headcount costs 18% while increasing throughput 31%
+      context: Executive leadership mandated cost reduction without service degradation
+      impact: Avoided layoffs by restructuring shifts; saved $1.4M annually
+      keywords: [cost reduction, workforce optimization, leadership, change management]
+    - metric: Implemented first warehouse automation system — ROI achieved in 11 months vs. 18-month projection
+      context: First-ever automation initiative for a $45M family-owned business
+      impact: Set foundation for $12M Series A fundraise the following year
+      keywords: [automation, ROI, project management, change management, stakeholder buy-in]
+  tags: [logistics, operations, team leadership, automation, retail]
+
+- role: Customer Success Manager
+  company: Brightline Software (acquired by Salesforce)
+  industry: SaaS / CRM
+  location: Chicago, IL
+  startDate: "2016-01"
+  endDate: "2018-05"
+  summary: >
+    Owned post-sale relationship for enterprise accounts in the $100K–$500K ARR range,
+    driving adoption, expansion, and retention across a 22-account portfolio.
+  achievements:
+    - metric: Maintained 118% net revenue retention across portfolio for 8 consecutive quarters
+      context: Joined during product pivot that created significant customer confusion
+      impact: Recognized as top CS rep company-wide; accounts became pilot group for new product line
+      keywords: [customer success, NRR, retention, enterprise, SaaS, ARR]
+    - metric: Identified and closed $1.2M in expansion revenue through QBR process redesign
+      context: Standard QBRs were perceived as low-value and skipped by 60% of customers
+      impact: Redesigned to ROI-focused format; 100% executive attendance within 2 quarters
+      keywords: [expansion revenue, QBR, executive relationships, SaaS, account management]
+  tags: [saas, customer success, enterprise, revenue, retention]

package/data/example/career/profile.yaml

@@ -0,0 +1,31 @@
+name: Alex Rivera
+email: alex.rivera@email.com
+phone: "+1-555-0142"
+location: Austin, TX
+linkedIn: linkedin.com/in/alexrivera
+portfolio: alexrivera.dev
+summary: >
+  Operations and program manager with 9 years of experience driving cross-functional
+  initiatives across healthcare, logistics, and SaaS. Known for translating ambiguous
+  problems into structured execution plans and building high-trust relationships with
+  both technical and non-technical stakeholders.
+targetRoles:
+  - Program Manager
+  - Director of Operations
+  - Head of Customer Success
+  - Chief of Staff
+targetIndustries:
+  - Healthcare Technology
+  - SaaS
+  - Logistics
+  - Fintech
+targetCompanySize:
+  - Series B
+  - Series C
+  - Mid-market (200-2000 employees)
+salaryMin: 140000
+salaryMax: 180000
+salaryCurrency: USD
+openToRemote: true
+openToRelocation: false
+noticePeriod: 3 weeks

package/data/example/career/skills.yaml

@@ -0,0 +1,71 @@
+- name: Program Management
+  category: Leadership
+  proficiency: 5
+  yearsUsed: 9
+  lastUsed: current
+
+- name: Cross-functional Team Leadership
+  category: Leadership
+  proficiency: 5
+  yearsUsed: 7
+  lastUsed: current
+
+- name: Executive Stakeholder Management
+  category: Leadership
+  proficiency: 5
+  yearsUsed: 6
+  lastUsed: current
+
+- name: Process Improvement / Lean
+  category: Operations
+  proficiency: 4
+  yearsUsed: 8
+  lastUsed: current
+
+- name: Vendor Management & Procurement
+  category: Operations
+  proficiency: 4
+  yearsUsed: 6
+  lastUsed: current
+
+- name: Customer Success
+  category: Domain
+  proficiency: 4
+  yearsUsed: 5
+  lastUsed: "2021"
+
+- name: Healthcare Operations (HIPAA, EHR)
+  category: Domain
+  proficiency: 4
+  yearsUsed: 4
+  lastUsed: current
+
+- name: Supply Chain / 3PL Operations
+  category: Domain
+  proficiency: 4
+  yearsUsed: 3
+  lastUsed: "2021"
+
+- name: Data Analysis (SQL, Excel, Tableau)
+  category: Technical
+  proficiency: 3
+  yearsUsed: 5
+  lastUsed: current
+
+- name: Salesforce CRM
+  category: Technical
+  proficiency: 3
+  yearsUsed: 4
+  lastUsed: current
+
+- name: JIRA / Confluence
+  category: Technical
+  proficiency: 4
+  yearsUsed: 6
+  lastUsed: current
+
+- name: Budget Management ($1M–$10M)
+  category: Operations
+  proficiency: 4
+  yearsUsed: 5
+  lastUsed: current

package/data/example/career/testimonials.yaml

@@ -0,0 +1,26 @@
+- source: Dr. Priya Nair, SVP Clinical Operations, MedFlow Health Systems
+  relationship: Direct Executive Sponsor
+  quote: >
+    Alex has a rare ability to walk into a room of skeptical physicians and leave with
+    their trust and a signed change order. The onboarding initiative alone paid for
+    itself five times over in year one.
+  date: "2023-08"
+  context: End-of-year performance review, shared with permission
+
+- source: Marcus Chen, VP of Sales, Apex Logistics Partners
+  relationship: Cross-functional peer
+  quote: >
+    I've worked with a lot of ops managers. Alex is the only one who ever came to me
+    with a proposal that actually reduced cost AND improved customer outcomes simultaneously.
+    The automation project was a career highlight for both of us.
+  date: "2020-11"
+  context: LinkedIn recommendation, public
+
+- source: Jamie Park, CEO, Brightline Software
+  relationship: Skip-level manager
+  quote: >
+    When we were acquired, Alex was the reason our largest accounts stayed calm. She
+    knew each stakeholder personally and had the credibility to make a difficult
+    transition feel seamless.
+  date: "2018-04"
+  context: Reference letter, provided for applications

package/data/example/pipeline/applications.yaml

@@ -0,0 +1,312 @@
+applications:
+  - id: demo-001
+    company: Veridian Health
+    role: Director of Operations
+    industry: Healthcare Technology
+    location: Austin, TX (Hybrid)
+    remote: hybrid
+    postingUrl: https://veridianhealth.com/careers/director-operations
+    status: interviewing
+    dateDiscovered: "2026-03-10"
+    dateApplied: "2026-03-12"
+    dateUpdated: "2026-03-24T14:22:00.000Z"
+    priority: high
+    excitement: 9
+    source: LinkedIn
+    salaryRange:
+      min: 155000
+      max: 185000
+      currency: USD
+    contacts:
+      - name: Rachel Torres
+        title: Talent Acquisition Partner
+        email: r.torres@veridianhealth.com
+        relationship: Recruiter
+      - name: David Kim
+        title: Chief Operating Officer
+        relationship: Hiring Manager
+    interviewRounds:
+      - type: phone_screen
+        date: "2026-03-17"
+        interviewers: [Rachel Torres]
+        outcome: Passed — advancing to panel
+      - type: panel
+        date: "2026-03-28"
+        interviewers: [David Kim, Head of Clinical Ops, VP Engineering]
+        notes: 90-minute panel. Prep STAR stories around cross-functional change management.
+    notes:
+      - "[2026-03-12] Tailored resume to emphasize healthcare ops experience. Used 'capacity optimization' framing from their JD."
+      - "[2026-03-17] Great phone screen. Rachel mentioned they want someone who can 'speak clinical AND exec.' Strong fit signal."
+      - "[2026-03-24] Panel confirmed. David Kim background: ex-McKinsey, 12 years hospital ops."
+    followUpDue: "2026-03-30"
+    coverLetterGenerated: true
+    tags: [healthcare, operations, director, panel-stage]
+
+  - id: demo-002
+    company: Meridian Logistics Group
+    role: Head of Customer Success
+    industry: Logistics & Supply Chain
+    location: Remote
+    remote: remote
+    status: applied
+    dateDiscovered: "2026-03-18"
+    dateApplied: "2026-03-20"
+    dateUpdated: "2026-03-20T09:15:00.000Z"
+    priority: medium
+    excitement: 7
+    source: Company site
+    referral: "Marcus Chen (former Apex colleague)"
+    salaryRange:
+      min: 140000
+      max: 165000
+      currency: USD
+    contacts:
+      - name: Marcus Chen
+        title: VP of Sales
+        relationship: Internal referral contact
+    interviewRounds: []
+    notes:
+      - "[2026-03-18] Marcus flagged this opening. Direct referral — he'll put in a word with the hiring manager."
+      - "[2026-03-20] Applied via company site. Tailored to emphasize NRR and QBR redesign from Brightline days."
+    followUpDue: "2026-03-27"
+    coverLetterGenerated: true
+    tags: [logistics, customer-success, referral]
+
+  - id: demo-003
+    company: Novare Capital Partners
+    role: Chief of Staff
+    industry: Fintech
+    location: Chicago, IL (Hybrid)
+    remote: hybrid
+    status: rejected
+    dateDiscovered: "2026-02-28"
+    dateApplied: "2026-03-01"
+    dateUpdated: "2026-03-19T16:00:00.000Z"
+    priority: high
+    excitement: 8
+    source: LinkedIn
+    salaryRange:
+      min: 160000
+      max: 190000
+      currency: USD
+    contacts:
+      - name: Jennifer Wu
+        title: Head of People
+        email: j.wu@novarecapital.com
+        relationship: Recruiter
+    interviewRounds:
+      - type: phone_screen
+        date: "2026-03-07"
+        interviewers: [Jennifer Wu]
+        outcome: Advanced
+      - type: behavioral
+        date: "2026-03-14"
+        interviewers: [Partner, Chief of Staff (outgoing)]
+        outcome: Did not advance — preferred fintech-native background
+    notes:
+      - "[2026-03-01] Stretch role but strong culture fit signal from job description."
+      - "[2026-03-14] Behavioral went well subjectively, but feedback was they prioritized someone with direct fintech P&L experience."
+      - "[2026-03-19] Graceful rejection received. Will send keep-the-door-open response and connect with Jennifer on LinkedIn."
+    coverLetterGenerated: true
+    tags: [fintech, chief-of-staff, rejected, learnings]
+
+  - id: demo-004
+    company: Canopy Analytics
+    role: VP of Operations
+    industry: Data Analytics / SaaS
+    location: Denver, CO (Hybrid)
+    remote: hybrid
+    postingUrl: https://canopyanalytics.com/careers/vp-operations
+    status: discovered
+    dateDiscovered: "2026-03-25"
+    dateUpdated: "2026-03-25T10:30:00.000Z"
+    priority: medium
+    excitement: 6
+    source: LinkedIn
+    salaryRange:
+      min: 170000
+      max: 200000
+      currency: USD
+    contacts: []
+    interviewRounds: []
+    notes:
+      - "[2026-03-25] Found via LinkedIn job alert. Series C company, ~250 employees. JD emphasizes scaling ops infrastructure — strong match with current experience."
+      - "[2026-03-25] Research: CEO previously scaled ops at Tableau. COO role is new headcount, not backfill — likely greenfield build."
+    coverLetterGenerated: false
+    tags: [analytics, saas, vp-ops, discovered]
+
+  - id: demo-005
+    company: Stratos Cloud
+    role: Program Director
+    industry: Cloud Infrastructure
+    location: Remote
+    remote: remote
+    postingUrl: https://stratoscloud.io/jobs/program-director
+    status: screening
+    dateDiscovered: "2026-03-14"
+    dateApplied: "2026-03-16"
+    dateUpdated: "2026-03-26T11:00:00.000Z"
+    priority: medium
+    excitement: 7
+    source: Recruiter outreach
+    salaryRange:
+      min: 145000
+      max: 170000
+      currency: USD
+    contacts:
+      - name: Priya Nair
+        title: Technical Recruiter
+        email: p.nair@stratoscloud.io
+        relationship: Recruiter
+    interviewRounds:
+      - type: phone_screen
+        date: "2026-03-21"
+        interviewers: [Priya Nair]
+        outcome: Passed — scheduling hiring manager screen
+    notes:
+      - "[2026-03-14] Priya reached out on LinkedIn. Role aligns with cross-functional program delivery background."
+      - "[2026-03-16] Applied after reviewing JD in detail. Emphasized distributed team coordination and OKR alignment experience."
+      - "[2026-03-21] Good phone screen with Priya. 30 mins. She mentioned hiring manager is ex-AWS, values structured program rigor. Follow up if no response by Mar 28."
+    followUpDue: "2026-03-28"
+    coverLetterGenerated: true
+    tags: [cloud, infrastructure, program-director, screening]
+
+  - id: demo-006
+    company: Brightpath Health
+    role: Sr. Program Manager
+    industry: Healthcare Technology
+    location: Boston, MA (Hybrid)
+    remote: hybrid
+    postingUrl: https://brightpathhealth.com/careers/sr-program-manager
+    status: offer
+    dateDiscovered: "2026-02-20"
+    dateApplied: "2026-02-22"
+    dateUpdated: "2026-03-26T16:45:00.000Z"
+    priority: high
+    excitement: 8
+    source: Referral
+    referral: "Samantha Osei (former colleague, now Head of PMO at Brightpath)"
+    salaryRange:
+      min: 130000
+      max: 155000
+      currency: USD
+    contacts:
+      - name: Samantha Osei
+        title: Head of PMO
+        relationship: Internal referral contact
+      - name: Carlos Mendez
+        title: VP of Product & Engineering
+        relationship: Hiring Manager
+      - name: Diane Hartley
+        title: HR Business Partner
+        email: d.hartley@brightpathhealth.com
+        relationship: Recruiter
+    interviewRounds:
+      - type: phone_screen
+        date: "2026-03-01"
+        interviewers: [Diane Hartley]
+        outcome: Advanced
+      - type: behavioral
+        date: "2026-03-10"
+        interviewers: [Carlos Mendez, Samantha Osei]
+        outcome: Advanced
+      - type: panel
+        date: "2026-03-18"
+        interviewers: [Carlos Mendez, CTO, Head of Clinical Delivery]
+        outcome: Advanced to offer
+      - type: offer_call
+        date: "2026-03-25"
+        interviewers: [Diane Hartley, Carlos Mendez]
+        outcome: Verbal offer extended
+    offer:
+      baseSalary: 148000
+      currency: USD
+      bonus: 15000
+      equity: "0.05% RSUs over 4 years"
+      benefits:
+        - Full medical, dental, vision (100% employee premium covered)
+        - 401k with 4% company match
+        - $2,000 annual learning & development stipend
+        - Flexible PTO
+        - Home office stipend $1,500
+      startDate: "2026-05-01"
+      expiresDate: "2026-04-07"
+      notes: "Strong offer — slightly below target base but equity and benefits are solid. Need to decide before Apr 7."
+    notes:
+      - "[2026-02-20] Sam flagged this opening before it was even posted. Direct referral to Carlos."
+      - "[2026-03-10] Behavioral round felt strong. Sam prepped me on Carlos's communication style — direct, metrics-first."
+      - "[2026-03-18] Three-person panel, 2 hours. Good energy. CTO asked deep questions about cross-functional conflict resolution."
+      - "[2026-03-25] Offer received! Base $148K vs $155K ask. Need to negotiate or decide. Equity + benefits partially offset."
+      - "[2026-03-26] Reviewing total comp. Will counter on base — target $153K. Benefits package is excellent."
+    followUpDue: "2026-04-07"
+    coverLetterGenerated: true
+    tags: [healthcare, program-management, offer, negotiating-soon]
+
+  - id: demo-007
+    company: Apex Consulting Group
+    role: Engagement Manager
+    industry: Management Consulting
+    location: Washington, DC (Hybrid)
+    remote: hybrid
+    postingUrl: https://apexconsultinggroup.com/careers/engagement-manager
+    status: withdrawn
+    dateDiscovered: "2026-02-15"
+    dateApplied: "2026-02-18"
+    dateUpdated: "2026-03-22T13:00:00.000Z"
+    priority: low
+    excitement: 5
+    source: Company site
+    salaryRange:
+      min: 150000
+      max: 175000
+      currency: USD
+    contacts:
+      - name: Bradley Kowalski
+        title: Recruiting Manager
+        email: b.kowalski@apexconsulting.com
+        relationship: Recruiter
+    interviewRounds:
+      - type: behavioral
+        date: "2026-03-05"
+        interviewers: [Bradley Kowalski, Senior Partner]
+        outcome: Advanced — but role scope narrower than expected
+    notes:
+      - "[2026-02-18] Applied based on strong brand name. JD was broad — assumed more strategic scope."
+      - "[2026-03-05] Behavioral round clarified role is primarily client delivery/billable hours — less internal transformation focus than expected."
+      - "[2026-03-10] After reflection, this role is a step sideways rather than forward. Travel requirements (60%+) also not sustainable."
+      - "[2026-03-22] Withdrew candidacy. Sent courteous email to Bradley thanking the team and keeping door open for future opportunities."
+    coverLetterGenerated: true
+    tags: [consulting, engagement-manager, withdrawn, culture-fit-mismatch]
+
+  - id: demo-008
+    company: Lumen Digital
+    role: Head of Operations
+    industry: Digital Marketing / Agency
+    location: Austin, TX (Onsite)
+    remote: onsite
+    postingUrl: https://lumendigital.com/jobs/head-of-operations
+    status: applied
+    dateDiscovered: "2026-03-22"
+    dateApplied: "2026-03-24"
+    dateUpdated: "2026-03-24T17:30:00.000Z"
+    priority: medium
+    excitement: 7
+    source: LinkedIn
+    salaryRange:
+      min: 135000
+      max: 160000
+      currency: USD
+    contacts:
+      - name: Yvonne Park
+        title: Chief People Officer
+        relationship: Listed on JD as point of contact
+    interviewRounds: []
+    notes:
+      - "[2026-03-22] Noticed this role trending on LinkedIn. Fast-growing agency (~180 employees), recently acquired two boutique studios."
+      - "[2026-03-24] Applied with tailored resume emphasizing agency ops and vendor management. Highlighted team scaling from 40 to 120 in prior role."
+      - "[2026-03-24] Onsite requirement is a factor but Austin-based — manageable. Will wait for response before committing further."
+    followUpDue: "2026-03-31"
+    coverLetterGenerated: true
+    tags: [digital, agency, head-of-ops, applied]
+
+lastUpdated: "2026-03-27T00:00:00.000Z"

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "career-compass-mcp",
+  "version": "2.0.0",
+  "description": "AI-native career co-pilot for Claude — Career KB, resume tailoring, job pipeline, interview prep, and offer evaluation via MCP",
+  "type": "module",
+  "main": "build/src/index.js",
+  "bin": {
+    "career-compass-mcp": "build/bin/cli.js"
+  },
+  "files": [
+    "build/",
+    "!build/**/__tests__/**",
+    "!build/**/*.test.*",
+    "dashboard/.next/standalone/",
+    "dashboard/.next/static/",
+    "dashboard/public/",
+    "data/example/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc && npm run build:dashboard",
+    "build:dashboard": "cd dashboard && npx next build",
+    "build:mcp": "tsc",
+    "dev": "tsc --watch",
+    "dev:dashboard": "cd dashboard && npx next dev --turbopack",
+    "start": "node build/src/index.js",
+    "dashboard": "node build/bin/cli.js dashboard",
+    "test": "cd dashboard && npx vitest run",
+    "storybook": "cd dashboard && npx storybook dev -p 6006",
+    "test:mcp": "vitest run --config vitest.config.ts",
+    "screenshots": "npx tsx scripts/capture-screenshots.ts",
+    "inspect": "mcp-inspector node build/src/index.js",
+    "pack:guard": "vitest run --config vitest.config.ts src/__tests__/npm-pack-leak-guard.test.ts",
+    "prepublishOnly": "npm run build && npm run pack:guard"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "career",
+    "job-search",
+    "resume",
+    "interview-prep",
+    "application-tracking",
+    "claude",
+    "anthropic",
+    "ai"
+  ],
+  "author": "Ben Schippers",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/benskamps/career-compass-mcp.git"
+  },
+  "homepage": "https://github.com/benskamps/career-compass-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/benskamps/career-compass-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "next": "^16.2.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.21.1",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "playwright": "^1.59.1",
+    "tailwindcss": "^4.2.2",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}