careermate 0.1.0 → 0.1.1

package/scripts/build-mcpb.mjs

@@ -28,6 +28,27 @@ function run(cmd, args, opts = {}) {
   return r.status === 0;
 }
 
+/**
+ * The MCP tool registry (packages/mcp-tools) is the single source of truth for
+ * what tools exist. Extract {name, description} from it so manifest.json never
+ * drifts from the real 24-tool list. Returns null if extraction fails.
+ */
+function extractTools() {
+  const script =
+    "import {TOOLS} from '@careermate/mcp-tools';" +
+    "process.stdout.write(JSON.stringify(TOOLS.map(t=>({name:t.name,description:t.title||t.description}))));";
+  const r = spawnSync(process.execPath, ['--no-warnings', '--import', 'tsx', '-e', script], {
+    cwd: ROOT,
+    encoding: 'utf8',
+  });
+  if (r.status !== 0 || !r.stdout) return null;
+  try {
+    return JSON.parse(r.stdout);
+  } catch {
+    return null;
+  }
+}
+
 function main() {
   console.log('CareerMate .mcpb 빌드를 시작합니다…\n');
 
@@ -41,10 +62,32 @@ function main() {
   console.log('\n2) 번들 스테이징(manifest + dist)…');
   fs.rmSync(STAGE, { recursive: true, force: true });
   fs.mkdirSync(STAGE, { recursive: true });
-  fs.copyFileSync(path.join(ROOT, 'manifest.json'), path.join(STAGE, 'manifest.json'));
-  // dist/ 에서 산출물만 복사 (스테이지/번들 산출물 자기참조 제외).
+  // manifest 버전은 package.json을 단일 출처로 삼아 주입한다(.mcpb 버전 드리프트 방지).
+  const pkgVersion = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).version;
+  const manifest = JSON.parse(fs.readFileSync(path.join(ROOT, 'manifest.json'), 'utf8'));
+  if (manifest.version !== pkgVersion) {
+    console.log(`   manifest 버전 ${manifest.version} → ${pkgVersion} (package.json 기준으로 맞춤)`);
+    manifest.version = pkgVersion;
+  }
+  // 도구 목록은 mcp-tools 레지스트리를 단일 출처로 주입(24개 ↔ manifest 드리프트 방지).
+  const tools = extractTools();
+  if (tools) {
+    console.log(`   manifest 도구 목록 ${manifest.tools?.length ?? 0} → ${tools.length} (mcp-tools 기준으로 맞춤)`);
+    manifest.tools = tools;
+  } else {
+    console.warn('   ⚠ 도구 목록 추출 실패 — 기존 manifest.tools를 그대로 사용합니다.');
+  }
+  fs.writeFileSync(path.join(STAGE, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+  // dist/ 에서 런타임에 필요한 산출물만 복사한다.
+  //  - mcp.mjs        : .mcpb의 entry_point(필수)
+  //  - web.mjs/public : open_dashboard로 띄우는 로컬 대시보드(필수)
+  //  - install-page   : 제외. 공개 마케팅 랜딩의 사본이라 MCP 서버·대시보드 동작에 불필요하고,
+  //                     fonts(2MB)+shots(2MB) 때문에 .mcpb를 두 배로 불린다. 대시보드 /install/
+  //                     라우트는 부재 시 serveStatic이 폴백하므로 깨지지 않는다(.mcpb 사용자는
+  //                     애초에 careermate.life를 거쳐 들어온다). npm 패키지는 dist/install-page를
+  //                     그대로 포함하므로 /install/가 유지된다.
   fs.mkdirSync(path.join(STAGE, 'dist'), { recursive: true });
-  for (const name of ['mcp.mjs', 'web.mjs', 'public', 'install-page']) {
+  for (const name of ['mcp.mjs', 'web.mjs', 'public']) {
     const src = path.join(DIST, name);
     if (fs.existsSync(src)) fs.cpSync(src, path.join(STAGE, 'dist', name), { recursive: true });
   }
@@ -64,7 +107,20 @@ function main() {
 
   const size = (fs.statSync(OUT).size / (1024 * 1024)).toFixed(1);
   console.log(`\n✅ 완성: ${OUT} (${size} MB)`);
-  console.log('   배포: 이 파일을 GitHub Releases 등에 올리면 유저가 더블클릭만 하면 Claude Desktop에 설치됩니다.');
+
+  // 랜딩 페이지(install-page/)가 .mcpb를 직접 서빙한다(careermate.life/careermate.mcpb).
+  // private repo라 GitHub Release 다운로드가 막혀, 빌드 결과를 페이지로 복사해 다운로드
+  // 버튼을 항상 최신으로 유지한다. install-page/ 는 배포 소스라 사이트와 함께 배포된다.
+  console.log('\n4) 랜딩 페이지로 복사…');
+  const pageDir = path.join(ROOT, 'install-page');
+  if (fs.existsSync(pageDir)) {
+    const pageCopy = path.join(pageDir, 'careermate.mcpb');
+    fs.copyFileSync(OUT, pageCopy);
+    console.log(`   복사 완료: ${pageCopy}`);
+    console.log('   배포: install-page/ 를 배포하면 유저가 페이지에서 바로 내려받아 Settings → Extensions → Install extension… 으로 설치합니다.');
+  } else {
+    console.log(`   건너뜀: ${pageDir} 없음 — 페이지 호스팅 복사 생략.`);
+  }
 }
 
 main();

package/scripts/gen-og.mjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * scripts/gen-og.mjs — 소셜 공유용 OG 이미지와 앱 아이콘(PNG) 생성기.
+ *
+ * 브랜드 색(에메랄드 #0f7256 · 크림 페이퍼 #faf8f4)을 랜딩/대시보드와 통일해
+ * Playwright(chromium)로 다음을 렌더링한다. 한 번 만들어 두면 정적 자산으로 커밋된다.
+ *
+ *   install-page/favicon.svg      벡터 파비콘 (모던 브라우저)
+ *   install-page/og.png           1200×630 소셜 공유 카드 (og:image / twitter:image)
+ *   install-page/icon-180.png     apple-touch-icon
+ *   install-page/icon-512.png     PWA/대형 폴백
+ *   apps/web/public/icon-180.png  대시보드 apple-touch-icon (동일 자산)
+ *
+ * 실행: node scripts/gen-og.mjs   (사전: npx playwright install chromium)
+ */
+import { chromium } from 'playwright';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const LANDING = path.join(ROOT, 'install-page');
+const PUBLIC = path.join(ROOT, 'apps', 'web', 'public');
+
+const EMERALD = '#0f7256';
+const CREAM = '#faf8f4';
+const KR_FONT = "'Malgun Gothic','Apple SD Gothic Neo','Noto Sans KR',sans-serif";
+
+const favicon = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><rect width="24" height="24" rx="6" fill="${EMERALD}"/><text x="12" y="17" font-size="14" text-anchor="middle" fill="#fff" font-family="Segoe UI,sans-serif" font-weight="bold">C</text></svg>`;
+
+const ogHtml = `<!doctype html><meta charset="utf-8"><style>
+  *{margin:0;box-sizing:border-box}
+  body{width:1200px;height:630px;background:${CREAM};font-family:${KR_FONT};color:#1c1a16}
+  .wrap{width:100%;height:100%;padding:78px 88px;display:flex;flex-direction:column;justify-content:space-between}
+  .brand{display:flex;align-items:center;gap:20px}
+  .logo{width:84px;height:84px;border-radius:20px;background:${EMERALD};color:#fff;font-weight:800;font-size:48px;display:grid;place-items:center}
+  .word{font-size:40px;font-weight:800;letter-spacing:-1.5px}
+  .h{font-size:78px;font-weight:800;line-height:1.08;letter-spacing:-2.5px}
+  .accent{color:${EMERALD}}
+  .sub{font-size:29px;color:#595449;line-height:1.5;margin-top:26px;max-width:900px}
+  .pill{display:inline-flex;align-items:center;gap:13px;font-size:23px;font-weight:600;color:#0b5b44;border:1px solid #bcdccd;background:#e7f1ec;padding:13px 24px;border-radius:999px;align-self:flex-start}
+  .dot{width:12px;height:12px;border-radius:50%;background:${EMERALD}}
+</style><div class="wrap">
+  <div class="brand"><div class="logo">C</div><div class="word">CareerMate</div></div>
+  <div>
+    <div class="h">내 <span class="accent">AI</span>를<br>나만의 <span class="accent">커리어 비서</span>로</div>
+    <div class="sub">이력서·자기소개서·지원 현황을 이 컴퓨터 안에서 관리하세요.<br>분석·글쓰기는 평소 쓰던 AI가, 데이터 보관은 CareerMate가.</div>
+  </div>
+  <div class="pill"><span class="dot"></span>로컬 전용 · MCP · 오픈소스</div>
+</div>`;
+
+const iconHtml = (size) => `<!doctype html><meta charset="utf-8"><style>
+  *{margin:0}
+  body{width:${size}px;height:${size}px;background:${EMERALD};display:grid;place-items:center}
+  .c{color:#fff;font-family:${KR_FONT};font-weight:800;font-size:${Math.round(size * 0.56)}px;line-height:1}
+</style><div class="c">C</div>`;
+
+async function shoot(page, html, w, h, out) {
+  await page.setViewportSize({ width: w, height: h });
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.screenshot({ path: out, clip: { x: 0, y: 0, width: w, height: h } });
+  console.log('  ✔', path.relative(ROOT, out));
+}
+
+async function main() {
+  fs.writeFileSync(path.join(LANDING, 'favicon.svg'), favicon);
+  console.log('  ✔', path.relative(ROOT, path.join(LANDING, 'favicon.svg')));
+
+  const browser = await chromium.launch();
+  const page = await browser.newPage({ deviceScaleFactor: 1 });
+  try {
+    await shoot(page, ogHtml, 1200, 630, path.join(LANDING, 'og.png'));
+    await shoot(page, iconHtml(180), 180, 180, path.join(LANDING, 'icon-180.png'));
+    await shoot(page, iconHtml(512), 512, 512, path.join(LANDING, 'icon-512.png'));
+    fs.copyFileSync(path.join(LANDING, 'icon-180.png'), path.join(PUBLIC, 'icon-180.png'));
+    console.log('  ✔', path.relative(ROOT, path.join(PUBLIC, 'icon-180.png')));
+  } finally {
+    await browser.close();
+  }
+  console.log('OG/아이콘 생성 완료.');
+}
+
+main().catch((err) => {
+  console.error('생성 실패:', err);
+  process.exitCode = 1;
+});

package/scripts/init.ts

@@ -13,7 +13,7 @@
  *
  * 사용:
  *   careermate init                       감지되는 클라이언트에 등록 (기본: 로컬 실행 모드)
- *   careermate init --client claude-code  특정 클라이언트만 (claude | claude-code | codex | cursor)
+ *   careermate init --client claude-code  특정 클라이언트만 (claude | claude-code | codex | cursor | gemini | antigravity)
  *   careermate init --all-clients         감지 여부와 무관하게 지원하는 모든 클라이언트에 등록
  *   careermate init --npx                 MCP 실행을 npx 방식으로 등록(공개 배포/개발자용)
  *   careermate init --print               실제로 쓰지 않고 등록할 설정/명령만 출력
@@ -41,6 +41,8 @@ interface ClientTarget {
   jsonType?: boolean;
   /** project scope처럼 항상 적용 가능한 대상은 감지 없이 기본 포함. */
   alwaysPresent?: boolean;
+  /** 설정 경로가 유동적인 대상(Antigravity)은 '실제 파일이 있을 때만' 감지해 추측 파일 생성을 막는다. */
+  requireFileForPresent?: boolean;
 }
 
 interface ServerEntry {
@@ -90,12 +92,37 @@ function codexConfigPath(): string {
   return path.join(base, 'config.toml');
 }
 
+/** Gemini CLI: `~/.gemini/settings.json` 의 mcpServers(Cursor 등과 동일 JSON 형식). */
+function geminiConfigPath(): string {
+  return path.join(os.homedir(), '.gemini', 'settings.json');
+}
+
+/**
+ * Antigravity(Gemini CLI의 소비자용 후속, 2026-06-18 전환) MCP 설정.
+ * 출시 직후라 정확한 파일 경로가 커뮤니티 소스 간 갈려, 존재하는 후보를 우선 사용한다.
+ * requireFileForPresent로 '실제 파일이 있을 때만' 감지 → 기본 init은 추측 경로에 파일을 만들지 않는다
+ * (--all-clients / --client antigravity 일 때만 첫 후보에 생성). 스키마는 Gemini와 동일(mcpServers).
+ */
+function antigravityCandidates(): string[] {
+  const g = path.join(os.homedir(), '.gemini');
+  return [
+    path.join(g, 'config', 'mcp_config.json'),
+    path.join(g, 'antigravity', 'mcp_config.json'),
+    path.join(g, 'antigravity-cli', 'mcp_config.json'),
+  ];
+}
+function antigravityConfigPath(): string {
+  return antigravityCandidates().find((p) => fs.existsSync(p)) ?? antigravityCandidates()[0];
+}
+
 function allTargets(): ClientTarget[] {
   return [
     { id: 'claude', label: 'Claude Desktop', format: 'mcp-json', configPath: claudeDesktopConfigPath() },
     { id: 'claude-code', label: 'Claude Code', format: 'mcp-json', configPath: claudeCodeConfigPath(), jsonType: true, alwaysPresent: true },
     { id: 'codex', label: 'Codex CLI', format: 'codex-toml', configPath: codexConfigPath() },
     { id: 'cursor', label: 'Cursor (기타 MCP 클라이언트)', format: 'mcp-json', configPath: cursorConfigPath() },
+    { id: 'gemini', label: 'Gemini CLI', format: 'mcp-json', configPath: geminiConfigPath() },
+    { id: 'antigravity', label: 'Antigravity', format: 'mcp-json', configPath: antigravityConfigPath(), requireFileForPresent: true },
   ];
 }
 
@@ -105,6 +132,7 @@ function allTargets(): ClientTarget[] {
  */
 function isPresent(t: ClientTarget): boolean {
   if (t.alwaysPresent) return true;
+  if (t.requireFileForPresent) return fs.existsSync(t.configPath);
   return fs.existsSync(t.configPath) || fs.existsSync(path.dirname(t.configPath));
 }
 
@@ -270,7 +298,7 @@ function printConfigs(server: ServerEntry): void {
   const cmd = [server.command, ...server.args];
   console.log('CareerMate를 AI 클라이언트에 직접 연결하는 방법입니다.\n');
 
-  console.log('① Claude Desktop / Claude Code / Cursor — MCP 설정(mcpServers)에 추가:');
+  console.log('① Claude Desktop / Claude Code / Cursor / Gemini CLI / Antigravity — MCP 설정(mcpServers)에 추가:');
   console.log(
     JSON.stringify(
       { mcpServers: { [PKG]: { type: 'stdio', command: server.command, args: server.args } } },
@@ -279,6 +307,7 @@ function printConfigs(server: ServerEntry): void {
     ),
   );
   console.log('\n  · Claude Code는 위 내용을 프로젝트 루트의 .mcp.json 으로 저장하면 됩니다.');
+  console.log('  · Gemini CLI는 ~/.gemini/settings.json, Antigravity는 ~/.gemini/(config|antigravity|antigravity-cli)/mcp_config.json 의 mcpServers에 같은 블록을 넣으세요(type 키는 없어도 됨).');
   console.log(`  · 또는 명령으로:  ${shellJoin(['claude', 'mcp', 'add', '--scope', 'project', '--transport', 'stdio', PKG, '--', ...cmd])}`);
 
   console.log('\n② Codex CLI — ~/.codex/config.toml 에 추가:');
@@ -324,7 +353,7 @@ function main(): void {
 
   if (connected === 0) {
     console.log('\n연결할 AI 클라이언트를 찾지 못했습니다.');
-    console.log('특정 클라이언트를 지정하거나(--client claude|claude-code|codex|cursor),');
+    console.log('특정 클라이언트를 지정하거나(--client claude|claude-code|codex|cursor|gemini|antigravity),');
     console.log('설정을 직접 복사해 추가할 수 있어요:  careermate init --print');
     process.exitCode = 1;
     return;

package/scripts/seed.ts

@@ -23,8 +23,8 @@ function main(): void {
   }
 
   saveProfile({
-    name: '이서연',
-    email: 'seoyeon.lee@example.com',
+    name: '홍길동',
+    email: 'gildong.hong@example.com',
     phone: '010-1234-5678',
     location: '서울',
     headline: '5년 차 백엔드 엔지니어 · 결제/정산 도메인',
@@ -76,8 +76,8 @@ function main(): void {
   ]) skillRepo.add(s);
 
   addResume({
-    kind: 'resume', title: '이서연 이력서 (백엔드)', is_primary: true, source: 'manual',
-    content: `# 이서연 — 백엔드 엔지니어\n\n## 경력 요약\n결제·정산 도메인 5년. 대규모 트래픽 안정화와 데이터 정합성에 강점.\n\n## 핵심 성과\n- 결제 승인 API p99 320ms→110ms\n- 정산 배치 6시간→40분\n- 연간 거래액 1.2조 무중단 처리`,
+    kind: 'resume', title: '홍길동 이력서 (백엔드)', is_primary: true, source: 'manual',
+    content: `# 홍길동 — 백엔드 엔지니어\n\n## 경력 요약\n결제·정산 도메인 5년. 대규모 트래픽 안정화와 데이터 정합성에 강점.\n\n## 핵심 성과\n- 결제 승인 API p99 320ms→110ms\n- 정산 배치 6시간→40분\n- 연간 거래액 1.2조 무중단 처리`,
   });
 
   // A job with full analysis + cover letter + status + interview prep
@@ -115,7 +115,7 @@ function main(): void {
     star_guides: [
       { question: '가장 큰 기술적 성과', situation: '정산 배치가 6시간 소요되어 익일 지연', task: '처리 시간 단축', action: 'Kafka 이벤트 스트리밍으로 준실시간 파이프라인 재설계', result: '6시간→40분, 정산 지연 0건' },
     ],
-    self_introduction: '안녕하세요. 결제·정산 도메인에서 5년간 "정확함"을 지켜온 백엔드 엔지니어 이서연입니다...(데모 1분 자기소개)',
+    self_introduction: '안녕하세요. 결제·정산 도메인에서 5년간 "정확함"을 지켜온 백엔드 엔지니어 홍길동입니다...(데모 1분 자기소개)',
     notes: '결제 도메인 질문에 집중 예상. 정량 수치 암기.',
   });
 

package/scripts/shots-seed.ts

@@ -0,0 +1,192 @@
+/**
+ * `shots-seed` — richer demo data for marketing screenshots ONLY.
+ *
+ * Unlike `scripts/seed.ts` (one job, for a first-run feel), this fills the whole
+ * pipeline: jobs across every status, a few cover letters, fit analyses, and an
+ * interview prep — so the home dashboard, the applications board and the jobs
+ * list all look populated in the landing-page screenshots.
+ *
+ * NEVER run this against real data. Always isolate into a throwaway dir:
+ *   CAREERMATE_DATA_DIR=./.shots-data npm run shots:seed
+ */
+import {
+  profileRepo, experienceRepo, projectRepo, skillRepo, getDataDir,
+} from '@careermate/db';
+import {
+  saveProfile, saveJobPosting, saveFitAnalysis, saveCoverLetterVersion,
+  updateApplicationStatus, saveInterviewPrep, addResume,
+} from '@careermate/core';
+
+if (profileRepo.get()?.name) {
+  console.error('⚠️  데이터가 이미 있습니다. 마케팅 시드는 빈 throwaway 폴더에서만 실행하세요.');
+  console.error('   예:  CAREERMATE_DATA_DIR=./.shots-data npm run shots:seed');
+  process.exit(1);
+}
+
+saveProfile({
+  name: '홍길동',
+  email: 'gildong.hong@example.com',
+  phone: '010-1234-5678',
+  location: '서울',
+  headline: '5년 차 백엔드 엔지니어 · 결제/정산 도메인',
+  summary: '대규모 트래픽 환경에서 결제·정산 시스템을 설계·운영했습니다. 안정성과 데이터 정합성을 중시하며, 문제를 정량적으로 정의하고 개선하는 것을 좋아합니다.',
+  desired_roles: ['백엔드 엔지니어', '서버 개발자', '플랫폼 엔지니어'],
+  desired_conditions: '서울/판교, 정규직, 원격 일부 가능, 결제/금융 도메인 선호',
+  preferred_tone: '담백하고 구체적이며, 성과를 숫자로 보여주는 문체',
+  emphasis_points: ['대규모 트래픽 처리 경험', '데이터 정합성', '장애 대응', '동료와의 협업'],
+  links: [
+    { label: 'GitHub', url: 'https://github.com/example' },
+    { label: '기술 블로그', url: 'https://blog.example.com' },
+  ],
+});
+
+experienceRepo.add({
+  company: '페이테크', role: '백엔드 엔지니어', employment_type: '정규직',
+  start_date: '2021-03', is_current: true,
+  description: '결제 게이트웨이와 정산 시스템 개발·운영',
+  achievements: ['결제 승인 API p99 응답시간 320ms→110ms 개선', '정산 배치 처리 시간 6시간→40분 단축', '장애 0건으로 연간 거래액 1.2조 처리'],
+  tech: ['Java', 'Spring Boot', 'Kafka', 'MySQL', 'Redis', 'Kubernetes'],
+});
+experienceRepo.add({
+  company: '커머스랩', role: '주니어 백엔드 개발자', employment_type: '정규직',
+  start_date: '2019-01', end_date: '2021-02',
+  description: '커머스 주문/재고 서비스 개발',
+  achievements: ['주문 동시성 이슈 해결로 재고 오차 99% 감소', '검색 응답속도 2배 개선'],
+  tech: ['Python', 'Django', 'PostgreSQL', 'Elasticsearch'],
+});
+
+projectRepo.add({
+  name: '실시간 정산 파이프라인', role: '설계 및 리드',
+  description: 'Kafka 기반 이벤트 스트리밍으로 준실시간 정산 파이프라인 구축',
+  highlights: ['정산 지연 6시간→실시간', '재처리 가능한 멱등 설계'],
+  tech: ['Kafka', 'Spring', 'MySQL'], url: 'https://github.com/example/settlement',
+});
+projectRepo.add({
+  name: '결제 장애 자동 복구 시스템', role: '개발',
+  description: 'PG사 장애 시 자동 우회 라우팅 및 알림',
+  highlights: ['장애 평균 복구시간 15분→2분'], tech: ['Java', 'Spring', 'Redis'],
+});
+
+for (const s of [
+  { name: 'Java', category: '언어', level: '상', years: 5 },
+  { name: 'Spring Boot', category: '프레임워크', level: '상', years: 5 },
+  { name: 'Kafka', category: '인프라', level: '중', years: 3 },
+  { name: 'MySQL', category: '데이터베이스', level: '상', years: 5 },
+  { name: 'Kubernetes', category: '인프라', level: '중', years: 2 },
+  { name: 'Python', category: '언어', level: '중', years: 3 },
+]) skillRepo.add(s);
+
+addResume({
+  kind: 'resume', title: '홍길동 이력서 (백엔드)', is_primary: true, source: 'manual',
+  content: `# 홍길동 — 백엔드 엔지니어\n\n## 경력 요약\n결제·정산 도메인 5년. 대규모 트래픽 안정화와 데이터 정합성에 강점.\n\n## 핵심 성과\n- 결제 승인 API p99 320ms→110ms\n- 정산 배치 6시간→40분\n- 연간 거래액 1.2조 무중단 처리`,
+});
+
+/** One demo job: posting → optional fit analysis → optional cover letter → status. */
+function job(spec: {
+  company: string; position: string; location: string; deadline: string;
+  description: string; requirements: string[]; keywords: string[];
+  status: string; score?: number; fit?: { summary: string; strengths: string[]; gaps: string[]; matched: string[]; missing: string[] };
+  cover?: { title: string; content: string };
+}) {
+  const { job: j } = saveJobPosting({
+    company: spec.company, position: spec.position, url: `https://example.com/${encodeURIComponent(spec.company)}`,
+    location: spec.location, employment_type: '정규직', description: spec.description,
+    requirements: spec.requirements, keywords: spec.keywords, deadline: spec.deadline, source: '데모',
+  });
+  if (spec.fit && spec.score != null) {
+    saveFitAnalysis({
+      job_id: j.id, score: spec.score, summary: spec.fit.summary,
+      strengths: spec.fit.strengths, gaps: spec.fit.gaps,
+      matched_keywords: spec.fit.matched, missing_keywords: spec.fit.missing,
+      recommendations: ['지원동기에 결제 도메인 경험을 구체 수치로', '부족 키워드는 학습 의지로 보완'],
+    });
+  }
+  let coverLetterId: number | undefined;
+  if (spec.cover) {
+    const { coverLetter } = saveCoverLetterVersion({
+      job_id: j.id, title: spec.cover.title, content: spec.cover.content, note: '초안', source: 'ai',
+    });
+    coverLetterId = coverLetter.id;
+  }
+  if (spec.status !== 'draft') updateApplicationStatus(j.id, spec.status, `데모: ${spec.status}`);
+  return { jobId: j.id, coverLetterId };
+}
+
+// 최종 합격
+job({
+  company: '쿠팡', position: '백엔드 엔지니어 (정산플랫폼)', location: '서울 송파', deadline: '2026-05-30',
+  description: '대규모 정산 플랫폼의 안정성과 확장성을 책임질 백엔드 엔지니어를 찾습니다.',
+  requirements: ['Java/Kotlin 백엔드', '대규모 트래픽', '정산 도메인'], keywords: ['Java', 'Spring', 'Kafka', '정산', 'MSA'],
+  status: 'final_passed', score: 91,
+  fit: { summary: '정산 도메인 경험이 공고와 거의 완벽히 일치합니다.', strengths: ['정산 파이프라인 설계 경험', '대규모 트래픽 안정화'], gaps: ['Kotlin 실무 경험'], matched: ['Java', 'Spring', 'Kafka', '정산'], missing: ['Kotlin'] },
+  cover: { title: '쿠팡 정산플랫폼 자기소개서', content: '저는 "정산은 단 1원도 틀려선 안 된다"는 원칙으로 일해 왔습니다...(데모)' },
+});
+
+// 면접
+const naver = job({
+  company: '네이버', position: '서버 개발자 (페이)', location: '경기 성남', deadline: '2026-07-10',
+  description: '네이버페이 결제/정산 백엔드를 함께 만들 서버 개발자를 찾습니다.',
+  requirements: ['Java 백엔드', '결제 시스템 경험', '대용량 처리'], keywords: ['Java', 'Spring', '결제', '대용량'],
+  status: 'interview', score: 84,
+  fit: { summary: '결제 백엔드 경험과 강하게 일치하며 대용량 처리 성과가 돋보입니다.', strengths: ['결제 API 성능 개선(p99)', '대용량 트래픽 경험'], gaps: ['검색 도메인 경험은 제한적'], matched: ['Java', 'Spring', '결제'], missing: ['대용량 검색'] },
+  cover: { title: '네이버페이 자기소개서', content: '결제 시스템의 신뢰성을 숫자로 증명해 온 백엔드 엔지니어입니다...(데모)' },
+});
+saveInterviewPrep({
+  job_id: naver.jobId,
+  questions: [
+    { question: '결제 승인 API 응답시간을 어떻게 개선했나요?', intent: '성능 개선 접근법', followups: ['병목은 어떻게 찾았나요?'], answer_outline: '프로파일링으로 커넥션 풀 병목 발견 → 캐시 도입 → p99 320→110ms.' },
+    { question: '데이터 정합성이 깨질 뻔한 경험은?', intent: '장애 대응', followups: ['멱등성 보장은?'], answer_outline: '정산 재처리 중복 지급 위험 → 멱등키+분산락으로 해결.' },
+  ],
+  star_guides: [
+    { question: '가장 큰 기술적 성과', situation: '정산 배치 6시간 소요', task: '처리 시간 단축', action: 'Kafka 이벤트 스트리밍 재설계', result: '6시간→40분, 지연 0건' },
+  ],
+  self_introduction: '안녕하세요. 결제·정산 도메인에서 5년간 "정확함"을 지켜온 백엔드 엔지니어 홍길동입니다...(데모 1분 자기소개)',
+  notes: '결제 도메인 질문 집중 예상. 정량 수치 암기.',
+});
+
+// 서류 합격
+const toss = job({
+  company: '토스', position: '백엔드 엔지니어 (결제)', location: '서울 강남', deadline: '2026-07-15',
+  description: '토스 결제 시스템의 안정성과 확장성을 책임질 백엔드 엔지니어를 찾습니다.',
+  requirements: ['Java/Kotlin 백엔드', '대규모 트래픽', '결제/정산 도메인 이해'], keywords: ['Java', 'Kotlin', 'Spring', 'Kafka', '결제', 'MSA'],
+  status: 'document_passed', score: 88,
+  fit: { summary: '결제·정산 경험과 대규모 트래픽 이력이 요구사항과 강하게 일치합니다.', strengths: ['결제/정산 5년', 'p99 개선 성과', 'Kafka 이벤트 처리'], gaps: ['Kotlin 실무 경험 부족', 'MSA 리딩 제한적'], matched: ['Java', 'Spring', 'Kafka', '결제'], missing: ['Kotlin', 'MSA'] },
+  cover: { title: '토스 백엔드 자기소개서', content: '저는 결제 시스템의 "한 푼도 틀리면 안 된다"는 긴장감 속에서 성장했습니다...(데모)' },
+});
+saveCoverLetterVersion({
+  cover_letter_id: toss.coverLetterId,
+  content: '저는 결제 시스템의 "한 푼도 틀리면 안 된다"는 긴장감 속에서 성장했습니다. 페이테크에서 결제 승인 API의 p99 응답시간을 320ms에서 110ms로 줄이며...(데모 v2)',
+  note: '지원동기와 정량 성과 보강', source: 'edit',
+});
+
+// 지원 완료
+job({
+  company: '카카오페이', position: '백엔드 엔지니어 (정산)', location: '경기 판교', deadline: '2026-07-20',
+  description: '카카오페이 정산 시스템 백엔드 개발자를 찾습니다.',
+  requirements: ['Java/Kotlin', 'MSA', '정산/회계 이해'], keywords: ['Java', 'Kotlin', 'MSA', '정산'],
+  status: 'applied', score: 79,
+  fit: { summary: '정산 경험은 강하나 MSA 전환 리딩 경험 보강이 필요합니다.', strengths: ['정산 도메인 경험', '데이터 정합성'], gaps: ['MSA 리딩', 'Kotlin'], matched: ['Java', '정산'], missing: ['Kotlin', 'MSA'] },
+  cover: { title: '카카오페이 자기소개서', content: '정산의 정확성과 속도를 동시에 끌어올린 경험을 가지고 있습니다...(데모)' },
+});
+
+// 지원 예정
+job({
+  company: '당근', position: '서버 개발자 (커머스)', location: '서울 강남', deadline: '2026-08-01',
+  description: '당근 중고거래/커머스 백엔드 서버 개발자를 찾습니다.',
+  requirements: ['Java/Kotlin 또는 Go', '대용량 트래픽', '커머스 도메인'], keywords: ['Java', 'Go', '대용량', '커머스'],
+  status: 'planned', score: 73,
+  fit: { summary: '대용량 처리 경험은 적합하나 커머스 도메인 노출은 초기 경력에 한정됩니다.', strengths: ['대용량 트래픽', '주문/재고 경험'], gaps: ['최근 커머스 경험', 'Go'], matched: ['Java', '대용량'], missing: ['Go', '커머스'] },
+});
+
+// 보류
+job({
+  company: '라인', position: '백엔드 엔지니어 (Fintech)', location: '서울 영등포', deadline: '2026-08-10',
+  description: 'LINE Fintech 백엔드 엔지니어를 찾습니다.',
+  requirements: ['Java/Kotlin', '글로벌 서비스 경험', '금융 도메인'], keywords: ['Java', 'Kotlin', '금융', '글로벌'],
+  status: 'on_hold', score: 70,
+  fit: { summary: '금융 도메인은 적합하나 글로벌 서비스 경험이 부족합니다.', strengths: ['금융/결제 도메인'], gaps: ['글로벌 서비스', 'Kotlin'], matched: ['Java', '금융'], missing: ['글로벌', 'Kotlin'] },
+});
+
+console.log('✅ 마케팅용 데모 데이터를 생성했습니다.');
+console.log(`   위치: ${getDataDir()}`);
+console.log('   공고 6건(최종합격·면접·서류합격·지원·예정·보류) · 적합도 6 · 자기소개서 4 · 면접 준비 1');

package/scripts/shots.ts

@@ -0,0 +1,89 @@
+/**
+ * `shots` — capture real dashboard screenshots for the landing page.
+ *
+ * Starts the local web server against whatever data dir is configured, then uses
+ * Playwright to capture home / applications / jobs in BOTH light and dark themes
+ * into install-page/shots/{screen}-{theme}.png. The landing page embeds these and
+ * swaps light↔dark to match its own theme toggle.
+ *
+ * Run against the throwaway marketing data (see shots-seed.ts):
+ *   CAREERMATE_DATA_DIR=./.shots-data CAREERMATE_NO_OPEN=1 npm run shots
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { chromium } from 'playwright';
+import { startServer } from '../apps/web/src/server.ts';
+import { getDataDir } from '@careermate/db';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const OUT_DIR = path.resolve(__dirname, '../install-page/shots');
+fs.mkdirSync(OUT_DIR, { recursive: true });
+
+const SCREENS = [
+  { name: 'home', hash: '#/home' },
+  { name: 'applications', hash: '#/applications' },
+  { name: 'jobs', hash: '#/jobs' },
+  { name: 'documents', hash: '#/documents' },
+  { name: 'interview', hash: '#/interview' },
+  { name: 'settings', hash: '#/settings' },
+];
+const THEMES = ['light', 'dark'] as const;
+
+// A desktop viewport that fits the home/board content without scrolling; @2x for
+// crisp text on retina/landing-card sizes.
+const VIEWPORT = { width: 1360, height: 940 };
+
+async function main(): Promise<void> {
+  process.env.CAREERMATE_NO_OPEN = '1';
+  const { url } = await startServer(Number(process.env.CAREERMATE_PORT ?? 4337));
+  const expectedDir = getDataDir();
+  console.log(`서버 시작: ${url}  (data: ${expectedDir})`);
+
+  // Safety: never screenshot real career data. Confirm the server we'll capture is
+  // actually serving our throwaway demo dir — not another careermate instance that
+  // grabbed the URL (e.g. a real dashboard on the default port).
+  const health = await fetch(`${url}/api/health`).then((r) => r.json()).catch(() => null) as { data_dir?: string } | null;
+  if (!health || path.resolve(health.data_dir ?? '') !== path.resolve(expectedDir)) {
+    throw new Error(`연결된 서버의 데이터 폴더(${health?.data_dir ?? '?'})가 예상(${expectedDir})과 다릅니다. `
+      + '실제 데이터를 캡처할 위험이 있어 중단합니다. CAREERMATE_DATA_DIR을 빈 throwaway 폴더로 지정하세요.');
+  }
+
+  const browser = await chromium.launch();
+  try {
+    for (const theme of THEMES) {
+      const ctx = await browser.newContext({ viewport: VIEWPORT, deviceScaleFactor: 2 });
+      // The dashboard reads localStorage 'cf-theme' on boot (app.js initTheme).
+      await ctx.addInitScript((t) => {
+        try { window.localStorage.setItem('cf-theme', t as string); } catch { /* ignore */ }
+      }, theme);
+      const page = await ctx.newPage();
+
+      for (const s of SCREENS) {
+        await page.goto(`${url}/${s.hash}`, { waitUntil: 'networkidle' });
+        // wait for the route to render (spinner gone) and webfont to load
+        await page.waitForFunction(() => {
+          const v = document.getElementById('view');
+          const hasSpinner = !!document.querySelector('.spinner');
+          const fontsReady = !document.fonts || document.fonts.status === 'loaded';
+          return !!v && v.childElementCount > 0 && !hasSpinner && fontsReady;
+        }, { timeout: 10_000 }).catch(() => { /* best effort */ });
+        await page.waitForTimeout(450);
+
+        const file = path.join(OUT_DIR, `${s.name}-${theme}.png`);
+        await page.screenshot({ path: file });
+        console.log(`  ✓ ${path.relative(process.cwd(), file)}`);
+      }
+      await ctx.close();
+    }
+  } finally {
+    await browser.close();
+  }
+  console.log('완료. install-page/shots/*.png 생성됨.');
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error('스크린샷 캡처 실패:', err instanceof Error ? err.stack : err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -25,5 +25,7 @@
       "@careermate/workflows": ["packages/workflows/src/index.ts"]
     }
   },
-  "include": ["packages/**/*.ts", "apps/**/*.ts", "scripts/**/*.ts"]
+  "include": ["packages/**/*.ts", "apps/**/*.ts", "scripts/**/*.ts"],
+  "//exclude": "scripts/shots*.ts는 Playwright 브라우저 컨텍스트(window/document)·임시 시드용 마케팅 도구라 타입검사 제외(배포물 아님).",
+  "exclude": ["node_modules", "scripts/shots.ts", "scripts/shots-seed.ts"]
 }

package/dist/mcp-smoke.err

@@ -1,3 +0,0 @@
-[careermate-mcp] 연결됨 · 도구 24개 · 데이터: C:\Users\승택\.careermate
-(node:23944) ExperimentalWarning: SQLite is an experimental feature and might change at any time
-(Use `node --trace-warnings ...` to show where the warning was created)