careermate 0.1.1 → 0.1.2

package/README.md

@@ -26,7 +26,7 @@
 
 ## 주요 기능
 
-- **AI와 대화로 모든 작업** — MCP 도구 24개로 온보딩·프로필·이력서·자소서·공고·핏 분석·지원 상태·면접 준비·AI 티 안 나는 글쓰기까지 처리.
+- **AI와 대화로 모든 작업** — MCP 도구 31개로 온보딩·프로필·이력서·자소서·공고·핏 분석·지원 상태·면접 준비·AI 티 안 나는 글쓰기까지 처리.
 - **지원 상태 8단계 관리** — `draft`(작성 중) · `planned`(지원 예정) · `applied`(지원 완료) · `document_passed`(서류 합격) · `interview`(면접 진행) · `final_passed`(최종 합격) · `rejected`(불합격) · `on_hold`(보류). `document_passed` 이상에서 면접 준비가 해금됩니다.
 - **자기소개서 버전 관리** — 공고별로 자소서 버전을 쌓고 타임라인으로 비교, 파일로 내보내기.
 - **채용공고 파싱** — 붙여넣은 공고 텍스트를 구조화해 저장.
@@ -42,7 +42,7 @@
 | 프로세스 | 실행 | 역할 |
 | --- | --- | --- |
 | **대시보드 웹 서버** | `npm start` | `http://127.0.0.1:4319` — 내 데이터를 눈으로 확인·관리. `127.0.0.1`에만 바인딩. |
-| **MCP 서버** | `npm run mcp` | stdio 기반. 보통 AI 클라이언트가 자동 실행. 도구 24개 제공. |
+| **MCP 서버** | `npm run mcp` | stdio 기반. 보통 AI 클라이언트가 자동 실행. 도구 31개 제공. |
 
 ---
 
@@ -139,21 +139,23 @@ Codex가 `~/.codex/config.toml`에 MCP 서버를 등록합니다. 연결은 Code
 
 ---
 
-## MCP 도구 한눈에 (24개)
+## MCP 도구 한눈에 (31개)
 
 | 분류 | 도구 |
 | --- | --- |
-| 온보딩 | `get_onboarding_status` · `start_onboarding` |
-| 프로필 | `save_profile` · `get_profile` · `update_profile` |
-| 이력서 | `add_resume` · `get_resumes` |
-| 자기소개서 | `add_cover_letter` · `get_cover_letters` · `save_cover_letter_version` · `export_cover_letter` |
-| 채용공고 | `save_job_posting` · `get_job_posting` · `list_jobs` · `parse_job_posting` |
+| 온보딩 | `get_onboarding_status` |
+| 프로필 | `save_profile` · `get_profile` |
+| 이력서 | `read_document` · `add_resume` · `get_resumes` · `open_inbox` · `read_inbox` |
+| 경력·프로젝트·스킬 | `add_experience` · `get_experiences` · `add_project` · `get_projects` · `add_skill` · `get_skills` |
+| 자기소개서 | `get_cover_letters` · `save_cover_letter_version` · `export_cover_letter` |
+| 채용공고 | `save_job_posting` · `get_job_posting` · `list_jobs` |
 | 핵심 컨텍스트 | **`get_application_context`** (지원에 필요한 맥락을 한 번에 모아줌) |
 | 핏 분석 | `save_fit_analysis` |
 | 지원 상태 | `update_application_status` |
 | 면접 준비 | `save_interview_prep` |
 | 글쓰기 | `get_writing_style_guide` (AI 티 안 나는 한국어 글쓰기 규칙) |
 | 대시보드/활동 | `open_dashboard` · `open_application` · `list_recent_activity` · `get_workflow_guide` |
+| 업데이트 | `check_for_update` · `update_careermate` |
 
 이 도구들 위에 5종의 워크플로우(`onboarding`, `analyze_job`, `write_cover_letter`, `manage_application_status`, `prepare_interview`)가 정의되어 있어, AI가 단계별로 자연스럽게 안내합니다.
 
@@ -170,7 +172,7 @@ CareerMate/
 │  ├─ shared/         # 공용 타입·zod 스키마·유틸
 │  ├─ db/             # node:sqlite DB 접근·스키마·마이그레이션
 │  ├─ core/           # 도메인 유스케이스
-│  ├─ mcp-tools/      # MCP 도구 24개 정의
+│  ├─ mcp-tools/      # MCP 도구 31개 정의
 │  ├─ exporters/      # 내보내기(자소서 등)
 │  ├─ parsers/        # 채용공고 파싱
 │  ├─ prompts/        # 프롬프트·안내 문구
@@ -256,4 +258,4 @@ npm run typecheck
 
 ## 라이선스
 
-MIT.
+MIT 라이선스 — npm으로 배포되는 패키지 코드에 적용됩니다. (개발용 GitHub 저장소는 현재 비공개입니다.)

package/THIRD_PARTY_NOTICES.md

@@ -38,3 +38,18 @@ SOFTWARE.
 
 > 참고: 원 저장소의 정확한 저작권자 표기(`Copyright (c) <year> <holder>`)를 확인해
 > 위 전문 상단에 그대로 채워 넣는 것을 권장합니다.
+
+---
+
+## 번들에 포함되는 npm 의존성 (문서 텍스트 추출)
+
+`read_document` 도구가 PDF·Word·한컴 문서에서 텍스트를 추출하는 데 사용하는 순수 JS 라이브러리들입니다. 배포 시 `dist/` 번들(esbuild)에 코드가 인라인되므로 각 라이선스 고지를 보존합니다. 각 라이선스 전문은 설치된 `node_modules/<패키지>/LICENSE` 에 포함됩니다.
+
+| 패키지 | 용도 | 라이선스 | 저작권 |
+| --- | --- | --- | --- |
+| [`mammoth`](https://github.com/mwilliamson/mammoth.js) | `.docx` → 텍스트 | BSD-2-Clause | Copyright (c) Michael Williamson |
+| [`hwp.js`](https://github.com/hahnlee/hwp.js) | `.hwp`(HWP 5.x) → 텍스트 | Apache-2.0 | Copyright Han Lee and other contributors |
+| [`fflate`](https://github.com/101arrowz/fflate) | `.hwpx` 압축 해제 | MIT | Copyright (c) 2023 Arjun Barrett |
+| [`pdfjs-dist`](https://github.com/mozilla/pdf.js) | `.pdf` → 텍스트 | Apache-2.0 | Copyright Mozilla Foundation and contributors |
+
+> Apache-2.0(`hwp.js`, `pdfjs-dist`)은 라이선스 사본과 NOTICE 고지 보존을 요구합니다. 위 표와 `node_modules`의 동봉 라이선스로 이를 충족합니다.

package/apps/mcp/src/index.ts

@@ -6,16 +6,15 @@
  * dashboard uses, so anything the AI writes appears in the dashboard instantly,
  * and anything the user edits in the dashboard is visible to the AI.
  *
- * Nothing here calls out to the network. All reasoning stays in the user's AI.
+ * All reasoning stays in the user's AI. The only outbound network call is an
+ * optional version check (check_for_update / update_careermate) against the
+ * public npm registry — no user data is sent; disable with CAREERMATE_NO_UPDATE_CHECK.
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { getDb, getDataDir } from '@careermate/db';
 import { TOOLS, toCallToolResult } from '@careermate/mcp-tools';
-
-// 번들 빌드(esbuild)에서 package.json 버전으로 치환된다. tsx 개발 실행에서는 정의되지 않아 typeof로 안전 분기.
-declare const __APP_VERSION__: string | undefined;
-const APP_VERSION = typeof __APP_VERSION__ !== 'undefined' ? __APP_VERSION__ : '0.0.0-dev';
+import { APP_VERSION } from '@careermate/shared';
 
 async function main(): Promise<void> {
   // Ensure the DB is created/migrated before serving any tool call.

package/apps/web/demo/demo-shim.js

@@ -0,0 +1,536 @@
+// =============================================================================
+// Demo shim — makes the CareerMate dashboard run with NO server.
+//
+// The real dashboard is a static SPA that talks to a local Node server over
+// /api/*. Here we intercept window.fetch and serve everything from an in-memory
+// DB seeded from seed.js. Writes mutate that DB (so editing the profile updates
+// the home counts, etc.), but nothing is persisted — a page reload resets to the
+// seed. Response shapes mirror apps/web/src/routes.ts exactly.
+//
+// This module is injected BEFORE app.js (see scripts/build-demo.mjs), so fetch is
+// patched before any page code calls it.
+// =============================================================================
+import { buildSeed } from './seed.js';
+
+/* ------------------------------------------------------------- constants */
+const STATUS_LABELS = {
+  draft: '작성 중', planned: '지원 예정', applied: '지원 완료', document_passed: '서류 합격',
+  interview: '면접 진행', final_passed: '최종 합격', rejected: '불합격', on_hold: '보류',
+};
+const BOARD_ORDER = ['draft', 'planned', 'applied', 'document_passed', 'interview', 'final_passed', 'on_hold', 'rejected'];
+const INTERVIEW_UNLOCK = ['document_passed', 'interview', 'final_passed'];
+const ACTIVE = ['draft', 'planned', 'applied', 'document_passed', 'interview'];
+const DOC_KIND_LABELS = { resume: '이력서', career_description: '경력기술서', portfolio: '포트폴리오', other: '기타 문서' };
+
+/* --------------------------------------------------------------- the DB */
+let db = buildSeed();
+let seq = 1000;
+const nid = (p) => `${p}${++seq}`;
+const nowIso = () => new Date().toISOString();
+const clone = (v) => JSON.parse(JSON.stringify(v));
+
+function logActivity(type, summary, entity_type = null, entity_id = null) {
+  db.activities.unshift({ id: nid('ac'), type, entity_type, entity_id, summary, created_at: nowIso() });
+}
+
+/* ------------------------------------------------------- derived helpers */
+const appByJob = (jobId) => db.applications.find((a) => a.job_id === jobId) || null;
+const fitByJob = (jobId) => db.fits.find((f) => f.job_id === jobId) || null;
+const ivByJob = (jobId) => db.interviews.find((i) => i.job_id === jobId) || null;
+const clByJob = (jobId) => db.coverLetters.filter((c) => c.job_id === jobId);
+
+function jobWithMeta(job) {
+  const app = appByJob(job.id);
+  const fit = fitByJob(job.id);
+  const status = app?.status ?? 'draft';
+  return { ...job, status, status_label: STATUS_LABELS[status], fit_score: fit?.score ?? null };
+}
+
+function onboarding() {
+  const p = db.profile;
+  const has_profile = !!(p && p.name);
+  const has_resume = db.documents.some((d) => d.kind === 'resume');
+  const has_cover_letter = db.coverLetters.length > 0;
+  const has_experience = db.experiences.length > 0;
+  const has_skills = db.skills.length > 0;
+  const has_job = db.jobs.length > 0;
+  const checks = p ? [
+    !!p.name, !!(p.headline || p.summary), !!p.location, p.desired_roles.length > 0,
+    !!p.desired_conditions, !!p.preferred_tone, p.emphasis_points.length > 0, p.links.length > 0,
+    db.experiences.length > 0, db.skills.length > 0,
+  ] : [];
+  const completeness = p ? Math.round((checks.filter(Boolean).length / checks.length) * 100) : 0;
+  const completed = has_profile && (has_resume || has_experience);
+  const next_steps = [];
+  if (!has_profile) next_steps.push('기본 프로필을 입력하세요 (이름, 한 줄 소개, 희망 직무).');
+  if (!has_resume) next_steps.push('이력서나 경력기술서를 추가하세요. 파일 내용을 붙여넣어도 됩니다.');
+  if (!has_experience) next_steps.push('주요 경력을 1개 이상 추가하면 적합도 분석 품질이 올라갑니다.');
+  if (!has_skills) next_steps.push('보유 기술스택을 정리해 두면 공고 매칭이 정확해집니다.');
+  if (has_profile && !has_cover_letter) next_steps.push('기존 자기소개서가 있다면 추가해 두세요. AI가 문체를 학습합니다.');
+  if (completed && !has_job) next_steps.push('관심 있는 채용공고 URL이나 내용을 AI에게 전달해 적합도 분석을 받아보세요.');
+  if (next_steps.length === 0) next_steps.push('준비가 잘 되어 있어요. 새 공고를 분석하거나 자기소개서를 작성해 보세요.');
+  return { completed, has_profile, has_resume, has_cover_letter, has_experience, has_skills, has_job, profile_completeness: completeness, next_steps };
+}
+
+function homeSummary() {
+  const apps = db.applications;
+  const status_breakdown = Object.keys(STATUS_LABELS).map((status) => ({
+    status, label: STATUS_LABELS[status], count: apps.filter((a) => a.status === status).length,
+  }));
+  const active = apps.filter((a) => ACTIVE.includes(a.status));
+  const interview_todo = apps
+    .filter((a) => INTERVIEW_UNLOCK.includes(a.status) && !ivByJob(a.job_id))
+    .map((a) => { const job = db.jobs.find((j) => j.id === a.job_id); return job ? { job, status_label: STATUS_LABELS[a.status] } : null; })
+    .filter(Boolean);
+  return {
+    onboarding: onboarding(),
+    counts: {
+      jobs: db.jobs.length,
+      active_applications: active.length,
+      cover_letters: db.coverLetters.length,
+      interview_pending: interview_todo.length,
+    },
+    status_breakdown,
+    recent_jobs: db.jobs.slice(0, 6).map(jobWithMeta),
+    in_progress: active.slice(0, 6).map((application) => ({
+      application, job: db.jobs.find((j) => j.id === application.job_id) || null, status_label: STATUS_LABELS[application.status],
+    })),
+    recent_cover_letters: db.coverLetters.slice(0, 5),
+    interview_todo,
+    recent_activity: db.activities.slice(0, 10),
+  };
+}
+
+function jobDetail(jobId) {
+  const job = db.jobs.find((j) => j.id === jobId);
+  if (!job) return { __status: 404, error: '공고를 찾을 수 없습니다.' };
+  const related = db.jobs
+    .filter((j) => j.id !== jobId && (j.company === job.company || j.position === job.position))
+    .map(jobWithMeta);
+  return {
+    job: {
+      ...jobWithMeta(job),
+      application: appByJob(jobId),
+      fit: fitByJob(jobId),
+      cover_letters: clByJob(jobId),
+      interview: ivByJob(jobId),
+      related,
+    },
+  };
+}
+
+function settingsInfo() {
+  return {
+    name: 'CareerMate', version: 'demo', port: 0, url: '',
+    data_dir: '데모 모드 — 브라우저 메모리에만 존재',
+    db_path: '저장되지 않습니다 (새로고침 시 초기화)',
+    exports_dir: '데모', backups_dir: '데모', node_version: '데모',
+    counts: {
+      profile: db.profile ? 1 : 0, experiences: db.experiences.length, projects: db.projects.length,
+      skills: db.skills.length, documents: db.documents.length, cover_letters: db.coverLetters.length,
+      jobs: db.jobs.length, applications: db.applications.length, interview_preps: db.interviews.length,
+    },
+  };
+}
+
+/* --------------------------------------------------- normalizers (input) */
+// Mirror the *Input → *Record defaulting the server's repos perform.
+function normProfile(input, base) {
+  const b = base || {};
+  return {
+    id: 'p1', created_at: b.created_at || nowIso(), updated_at: nowIso(),
+    name: input.name ?? b.name ?? null, email: input.email ?? b.email ?? null,
+    phone: input.phone ?? b.phone ?? null, location: input.location ?? b.location ?? null,
+    headline: input.headline ?? b.headline ?? null, summary: input.summary ?? b.summary ?? null,
+    desired_roles: input.desired_roles ?? b.desired_roles ?? [],
+    desired_conditions: input.desired_conditions ?? b.desired_conditions ?? null,
+    preferred_tone: input.preferred_tone ?? b.preferred_tone ?? null,
+    emphasis_points: input.emphasis_points ?? b.emphasis_points ?? [],
+    links: input.links ?? b.links ?? [],
+  };
+}
+const arr = (v) => (Array.isArray(v) ? v : []);
+
+/* -------------------------------------------------------------- routes */
+// Each: [method, RegExp on pathname, handler(params, body, query) -> data | {__status,error}]
+const ROUTES = [
+  ['GET', /^\/api\/health$/, () => ({ ok: true, ...settingsInfo() })],
+  ['GET', /^\/api\/onboarding$/, () => onboarding()],
+  ['GET', /^\/api\/summary$/, () => homeSummary()],
+  ['GET', /^\/api\/activity$/, () => ({ activities: db.activities.slice(0, 30) })],
+  ['GET', /^\/api\/meta$/, () => ({
+    statuses: BOARD_ORDER.map((s) => ({ value: s, label: STATUS_LABELS[s] })),
+    document_kinds: Object.entries(DOC_KIND_LABELS).map(([value, label]) => ({ value, label })),
+  })],
+
+  /* profile */
+  ['GET', /^\/api\/profile$/, () => ({ profile: db.profile })],
+  ['PUT', /^\/api\/profile$/, (_p, body) => {
+    db.profile = normProfile(body, db.profile);
+    logActivity('profile_updated', '프로필을 업데이트했습니다.', 'profile', 'p1');
+    return { profile: db.profile };
+  }],
+
+  /* experiences / projects / skills share a CRUD shape */
+  ...crud('experiences', 'experience', ['company', 'role', 'employment_type', 'start_date', 'end_date', 'is_current', 'description', 'achievements', 'tech', 'order_index']),
+  ...crud('projects', 'project', ['name', 'role', 'description', 'highlights', 'tech', 'url', 'start_date', 'end_date', 'order_index']),
+  ...crud('skills', 'skill', ['name', 'category', 'level', 'years', 'order_index']),
+
+  /* documents */
+  ['GET', /^\/api\/documents$/, (_p, _b, q) => {
+    const kind = q.get('kind');
+    return { documents: kind ? db.documents.filter((d) => d.kind === kind) : db.documents };
+  }],
+  ['POST', /^\/api\/documents$/, (_p, body) => {
+    const doc = {
+      id: nid('d'), created_at: nowIso(), updated_at: nowIso(),
+      kind: body.kind || 'other', title: body.title || '제목 없음', content: body.content || '',
+      source: body.source || 'manual', is_primary: !!body.is_primary, tags: arr(body.tags),
+    };
+    if (doc.is_primary) db.documents.forEach((d) => { if (d.kind === doc.kind) d.is_primary = false; });
+    db.documents.unshift(doc);
+    logActivity(doc.kind === 'resume' ? 'resume_added' : 'profile_updated', `${doc.title}을(를) 추가했습니다.`, 'document', doc.id);
+    return { document: doc };
+  }],
+  ['GET', /^\/api\/documents\/([^/]+)$/, (p) => {
+    const doc = db.documents.find((d) => d.id === p[0]);
+    return doc ? { document: doc } : { __status: 404, error: '문서를 찾을 수 없습니다.' };
+  }],
+  ['PUT', /^\/api\/documents\/([^/]+)$/, (p, body) => {
+    const doc = db.documents.find((d) => d.id === p[0]);
+    if (!doc) return { __status: 404, error: '문서를 찾을 수 없습니다.' };
+    Object.assign(doc, pick(body, ['kind', 'title', 'content', 'source', 'is_primary', 'tags']), { updated_at: nowIso() });
+    return { document: doc };
+  }],
+  ['DELETE', /^\/api\/documents\/([^/]+)$/, (p) => remove(db.documents, p[0])],
+
+  /* cover letters */
+  ['GET', /^\/api\/cover-letters$/, () => ({ cover_letters: db.coverLetters })],
+  ['POST', /^\/api\/cover-letters$/, (_p, body) => {
+    const id = nid('c'); const t = nowIso();
+    const cl = {
+      id, created_at: t, updated_at: t, title: body.title || '제목 없음', job_id: body.job_id ?? null,
+      is_primary: !!body.is_primary, current_version_id: null, version_count: 0, current_content: null, versions: [],
+    };
+    if (body.content) addVersion(cl, body.content, body.note, body.source || 'manual');
+    if (cl.is_primary) db.coverLetters.forEach((c) => { c.is_primary = false; });
+    cl.is_primary = !!body.is_primary;
+    db.coverLetters.unshift(cl);
+    logActivity('cover_letter_added', `${cl.title} 자기소개서를 추가했습니다.`, 'cover_letter', id);
+    return { cover_letter: cl };
+  }],
+  ['GET', /^\/api\/cover-letters\/([^/]+)$/, (p) => {
+    const cl = db.coverLetters.find((c) => c.id === p[0]);
+    return cl ? { cover_letter: cl } : { __status: 404, error: '자기소개서를 찾을 수 없습니다.' };
+  }],
+  ['POST', /^\/api\/cover-letters\/([^/]+)\/versions$/, (p, body) => {
+    const cl = db.coverLetters.find((c) => c.id === p[0]);
+    if (!cl) return { __status: 404, error: '자기소개서를 찾을 수 없습니다.' };
+    const version = addVersion(cl, body.content, body.note, body.source || 'edit');
+    logActivity('cover_letter_version_saved', `${cl.title} v${version.version_no}을(를) 저장했습니다.`, 'cover_letter', cl.id);
+    return { cover_letter: cl, version };
+  }],
+  ['PUT', /^\/api\/cover-letters\/([^/]+)\/current-version$/, (p, body) => {
+    const cl = db.coverLetters.find((c) => c.id === p[0]);
+    if (!cl) return { __status: 404, error: '자기소개서를 찾을 수 없습니다.' };
+    const v = (cl.versions || []).find((x) => x.id === body.version_id);
+    if (v) { cl.current_version_id = v.id; cl.current_content = v.content; cl.updated_at = nowIso(); }
+    return { cover_letter: cl };
+  }],
+  ['PUT', /^\/api\/cover-letters\/([^/]+)\/primary$/, (p) => {
+    const cl = db.coverLetters.find((c) => c.id === p[0]);
+    if (!cl) return { __status: 404, error: '자기소개서를 찾을 수 없습니다.' };
+    db.coverLetters.forEach((c) => { c.is_primary = c.id === cl.id; });
+    cl.updated_at = nowIso();
+    return { cover_letter: cl };
+  }],
+  ['DELETE', /^\/api\/cover-letters\/([^/]+)$/, (p) => remove(db.coverLetters, p[0])],
+
+  /* jobs */
+  ['GET', /^\/api\/jobs$/, () => ({ jobs: db.jobs.map(jobWithMeta) })],
+  ['POST', /^\/api\/jobs$/, (_p, body) => {
+    const job = normJob(body);
+    db.jobs.unshift(job);
+    const application = { id: nid('a'), created_at: nowIso(), updated_at: nowIso(), job_id: job.id, status: 'draft', resume_id: null, cover_letter_id: null, applied_at: null, notes: null };
+    db.applications.unshift(application);
+    logActivity('job_saved', `${job.company} 공고를 저장했습니다.`, 'job', job.id);
+    return { job: jobWithMeta(job), application };
+  }],
+  ['GET', /^\/api\/jobs\/([^/]+)\/interview$/, (p) => ({ interview: ivByJob(p[0]) })],
+  ['PUT', /^\/api\/jobs\/([^/]+)\/interview$/, (p, body) => {
+    let iv = ivByJob(p[0]);
+    if (!iv) { iv = { id: nid('iv'), created_at: nowIso(), updated_at: nowIso(), job_id: p[0], questions: [], star_guides: [], self_introduction: null, notes: null }; db.interviews.unshift(iv); }
+    Object.assign(iv, { questions: arr(body.questions), star_guides: arr(body.star_guides), self_introduction: body.self_introduction ?? iv.self_introduction, notes: body.notes ?? iv.notes, updated_at: nowIso() });
+    logActivity('interview_prep_saved', '면접 준비 자료를 저장했습니다.', 'interview_prep', iv.id);
+    return { interview: iv };
+  }],
+  ['GET', /^\/api\/jobs\/([^/]+)$/, (p) => jobDetail(p[0])],
+  ['PUT', /^\/api\/jobs\/([^/]+)$/, (p, body) => {
+    const job = db.jobs.find((j) => j.id === p[0]);
+    if (!job) return { __status: 404, error: '공고를 찾을 수 없습니다.' };
+    Object.assign(job, pick(body, ['company', 'position', 'url', 'location', 'employment_type', 'description', 'requirements', 'keywords', 'deadline', 'source']), { updated_at: nowIso() });
+    return { job: jobWithMeta(job) };
+  }],
+  ['DELETE', /^\/api\/jobs\/([^/]+)$/, (p) => {
+    db.applications = db.applications.filter((a) => a.job_id !== p[0]);
+    db.fits = db.fits.filter((f) => f.job_id !== p[0]);
+    db.interviews = db.interviews.filter((i) => i.job_id !== p[0]);
+    return remove(db.jobs, p[0]);
+  }],
+
+  /* interview page */
+  ['GET', /^\/api\/interview$/, () => {
+    const preps = db.interviews.map((pp) => ({ ...pp, job: db.jobs.find((j) => j.id === pp.job_id) }));
+    const eligible = db.applications
+      .filter((a) => INTERVIEW_UNLOCK.includes(a.status))
+      .map((a) => ({ job: db.jobs.find((j) => j.id === a.job_id), status: a.status, status_label: STATUS_LABELS[a.status], has_prep: !!ivByJob(a.job_id) }))
+      .filter((x) => x.job);
+    return { preps, eligible };
+  }],
+
+  /* applications */
+  ['GET', /^\/api\/applications$/, () => ({
+    applications: db.applications.map((a) => ({ ...a, status_label: STATUS_LABELS[a.status], job: db.jobs.find((j) => j.id === a.job_id), fit_score: fitByJob(a.job_id)?.score ?? null })),
+    board_order: BOARD_ORDER,
+  })],
+  ['PUT', /^\/api\/applications\/([^/]+)\/status$/, (p, body) => {
+    const job = db.jobs.find((j) => j.id === p[0]);
+    if (!job) return { __status: 404, error: '공고를 찾을 수 없습니다.' };
+    let app = appByJob(p[0]);
+    if (!app) { app = { id: nid('a'), created_at: nowIso(), updated_at: nowIso(), job_id: p[0], status: 'draft', resume_id: null, cover_letter_id: null, applied_at: null, notes: null }; db.applications.unshift(app); }
+    app.status = body.status; app.updated_at = nowIso();
+    if (body.note) app.notes = body.note;
+    logActivity('application_status_changed', `${job.company} · ${job.position} 상태를 '${STATUS_LABELS[body.status]}'(으)로 변경했습니다.`, 'application', app.id);
+    const interview_unlocked = INTERVIEW_UNLOCK.includes(body.status);
+    return { application: app, job, interview_unlocked, hint: interview_unlocked && !ivByJob(p[0]) ? '서류 단계를 통과했어요. 면접 질문과 자기소개를 준비해 보세요.' : null };
+  }],
+  ['PUT', /^\/api\/applications\/([^/]+)$/, (p, body) => {
+    let app = appByJob(p[0]);
+    if (!app) { app = { id: nid('a'), created_at: nowIso(), updated_at: nowIso(), job_id: p[0], status: 'draft', resume_id: null, cover_letter_id: null, applied_at: null, notes: null }; db.applications.unshift(app); }
+    Object.assign(app, pick(body, ['status', 'resume_id', 'cover_letter_id', 'applied_at', 'notes']), { updated_at: nowIso() });
+    return { application: app };
+  }],
+
+  /* settings */
+  ['GET', /^\/api\/settings$/, () => ({ info: settingsInfo(), backups: db.backups || [] })],
+  ['POST', /^\/api\/settings\/backup$/, () => {
+    db.backups = db.backups || [];
+    const b = { filename: `careermate-${nowIso().replace(/[:.]/g, '-')}.sqlite`, path: '(데모)', created_at: nowIso(), size: 48 * 1024 };
+    db.backups.unshift(b);
+    return b;
+  }],
+  ['POST', /^\/api\/settings\/reset$/, (_p, body) => {
+    if (body.confirm !== 'DELETE') return { __status: 400, error: 'confirm 값이 올바르지 않습니다.' };
+    db = buildSeed(); // demo "reset" = back to the seed
+    return { ok: true };
+  }],
+
+  /* parse helper (deterministic, no AI) */
+  ['POST', /^\/api\/parse\/job$/, (_p, body) => cleanPosting(body.raw || '')],
+];
+
+/* -------------------------------------------------- CRUD route factory */
+function crud(coll, key, fields) {
+  const base = `/api/${coll}`;
+  const re = new RegExp(`^/api/${coll}/([^/]+)$`);
+  return [
+    ['GET', new RegExp(`^/api/${coll}$`), () => ({ [coll]: db[coll] })],
+    ['POST', new RegExp(`^/api/${coll}$`), (_p, body) => {
+      const rec = { id: nid(key[0]), created_at: nowIso(), updated_at: nowIso(), ...defaults(fields), ...pick(body, fields) };
+      db[coll].push(rec);
+      return { [key]: rec };
+    }],
+    ['PUT', re, (p, body) => {
+      const rec = db[coll].find((x) => x.id === p[0]);
+      if (!rec) return { __status: 404, error: '항목을 찾을 수 없습니다.' };
+      Object.assign(rec, pick(body, fields), { updated_at: nowIso() });
+      return { [key]: rec };
+    }],
+    ['DELETE', re, (p) => remove(db[coll], p[0])],
+  ];
+}
+function defaults(fields) {
+  const out = {};
+  for (const f of fields) {
+    if (['achievements', 'tech', 'highlights'].includes(f)) out[f] = [];
+    else if (f === 'is_current') out[f] = false;
+    else if (f === 'order_index') out[f] = 0;
+    else out[f] = null;
+  }
+  return out;
+}
+
+/* ------------------------------------------------------------- helpers */
+function pick(obj, fields) {
+  const out = {};
+  for (const f of fields) if (obj[f] !== undefined) out[f] = obj[f];
+  return out;
+}
+function remove(coll, id) {
+  const i = coll.findIndex((x) => x.id === id);
+  if (i >= 0) coll.splice(i, 1);
+  return { ok: i >= 0 };
+}
+function addVersion(cl, content, note, source) {
+  cl.versions = cl.versions || [];
+  const v = { id: nid('clv'), cover_letter_id: cl.id, version_no: cl.versions.length + 1, content, note: note ?? null, source: source || 'manual', created_at: nowIso() };
+  cl.versions.push(v);
+  cl.current_version_id = v.id; cl.current_content = content; cl.version_count = cl.versions.length; cl.updated_at = nowIso();
+  return v;
+}
+function normJob(body) {
+  return {
+    id: nid('j'), created_at: nowIso(), updated_at: nowIso(),
+    company: body.company || '', position: body.position || '', url: body.url ?? null,
+    location: body.location ?? null, employment_type: body.employment_type ?? null,
+    description: body.description ?? null, requirements: arr(body.requirements), keywords: arr(body.keywords),
+    deadline: body.deadline ?? null, source: body.source ?? null,
+  };
+}
+const TECH = ['Java', 'Spring', 'Kotlin', 'Node.js', 'TypeScript', 'Python', 'Go', 'Kafka', 'MySQL', 'PostgreSQL', 'Redis', 'Kubernetes', 'AWS', 'Docker', 'React', 'MSA'];
+function cleanPosting(raw) {
+  const text = String(raw).replace(/\r\n?/g, '\n').split('\n').map((l) => l.replace(/[ \t]+/g, ' ').trim()).filter(Boolean).join('\n');
+  const keywords = TECH.filter((t) => new RegExp(`\\b${t.replace(/[.+]/g, '\\$&')}\\b`, 'i').test(text));
+  const out = { text, keywords };
+  const m = text.match(/(?:마감|접수\s*마감)[^\d]*(\d{4}[.\-/]\d{1,2}[.\-/]\d{1,2})/);
+  if (m) out.deadline = m[1].replace(/[.\/]/g, '-');
+  return out;
+}
+
+/* ----------------------------------------------------- fetch interception */
+const realFetch = window.fetch.bind(window);
+function jsonResponse(data) {
+  const status = data && data.__status ? data.__status : 200;
+  const payload = data && data.__status ? { error: data.error } : data;
+  return new Response(JSON.stringify(payload ?? {}), { status, headers: { 'Content-Type': 'application/json; charset=utf-8' } });
+}
+
+window.fetch = async function (input, init) {
+  const url = typeof input === 'string' ? input : input.url;
+  let pathname;
+  try { pathname = new URL(url, location.href).pathname; } catch { return realFetch(input, init); }
+  if (!pathname.startsWith('/api/')) return realFetch(input, init);
+
+  const method = (init?.method || (input instanceof Request ? input.method : 'GET')).toUpperCase();
+  const query = new URL(url, location.href).searchParams;
+  let body = {};
+  const rawBody = init?.body ?? (input instanceof Request ? null : null);
+  if (rawBody) { try { body = JSON.parse(rawBody); } catch { body = {}; } }
+
+  for (const [m, re, handler] of ROUTES) {
+    if (m !== method) continue;
+    const match = re.exec(pathname);
+    if (!match) continue;
+    try {
+      const data = handler(match.slice(1), body, query);
+      return jsonResponse(clone(data));
+    } catch (e) {
+      return jsonResponse({ __status: 500, error: e?.message || '데모 처리 중 오류가 발생했습니다.' });
+    }
+  }
+  return jsonResponse({ __status: 404, error: '요청한 항목을 찾을 수 없어요.' });
+};
+
+/* ------------------------------------------ export-download interception */
+// downloadUrl() builds an <a download href="/api/export/..."> and clicks it.
+// That's a navigation, not fetch — so we catch the click and build the file
+// from the in-memory DB instead.
+function buildExport(pathname, query) {
+  const fmt = (query.get('format') || 'md').toLowerCase();
+  let m;
+  if ((m = pathname.match(/^\/api\/export\/cover-letter\/([^/]+)$/))) {
+    const cl = db.coverLetters.find((c) => c.id === m[1]);
+    return cl ? { name: `${cl.title}.${fmt === 'html' ? 'html' : 'md'}`, content: wrap(fmt, cl.title, cl.current_content || '') } : null;
+  }
+  if ((m = pathname.match(/^\/api\/export\/document\/([^/]+)$/))) {
+    const d = db.documents.find((x) => x.id === m[1]);
+    return d ? { name: `${d.title}.md`, content: d.content || '' } : null;
+  }
+  if ((m = pathname.match(/^\/api\/export\/interview\/([^/]+)$/))) {
+    const iv = ivByJob(m[1]); const job = db.jobs.find((j) => j.id === m[1]);
+    if (!iv) return null;
+    const lines = [`# 면접 준비 — ${job ? job.company : ''}`, '', iv.self_introduction || '', '', ...(iv.questions || []).map((q) => `- ${q.question}`)];
+    return { name: '면접준비.md', content: wrap(fmt, '면접 준비', lines.join('\n')) };
+  }
+  if (pathname === '/api/settings/export-all') {
+    return { name: 'careermate-demo-export.json', content: JSON.stringify({ exported_at: nowIso(), demo: true, data: db }, null, 2) };
+  }
+  return null;
+}
+function wrap(fmt, title, body) {
+  if (fmt !== 'html') return body;
+  return `<!doctype html><meta charset="utf-8"><title>${title}</title><pre>${body.replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[c]))}</pre>`;
+}
+document.addEventListener('click', (e) => {
+  const a = e.target.closest && e.target.closest('a[download]');
+  if (!a) return;
+  let pathname, query;
+  try { const u = new URL(a.getAttribute('href'), location.href); pathname = u.pathname; query = u.searchParams; } catch { return; }
+  if (!pathname.startsWith('/api/')) return;
+  e.preventDefault();
+  const file = buildExport(pathname, query);
+  if (!file) return;
+  const blob = new Blob([file.content], { type: 'text/plain;charset=utf-8' });
+  const href = URL.createObjectURL(blob);
+  const link = document.createElement('a');
+  link.href = href; link.download = file.name;
+  document.body.append(link); link.click(); link.remove();
+  setTimeout(() => URL.revokeObjectURL(href), 1000);
+}, true);
+
+/* ----------------------------------------------------- theme (synced) */
+// Both the marketing site and this demo share localStorage key 'careermate-theme'
+// and the <html data-theme> attribute (same origin), so a choice on either side
+// carries over. The pre-paint resolver is injected into <head> by build-demo.mjs;
+// here we just wire the toggle button.
+function effectiveTheme() {
+  const t = document.documentElement.getAttribute('data-theme');
+  if (t === 'light' || t === 'dark') return t;
+  return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+}
+const SUN = '<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg>';
+const MOON = '<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8Z"/></svg>';
+function paintToggle(btn) {
+  // Show the icon of the mode you'd switch TO.
+  btn.innerHTML = effectiveTheme() === 'dark' ? SUN : MOON;
+}
+
+/* ------------------------------------------------------ demo top bar */
+// A slim top bar that frames the page as a no-save preview and links back to the
+// marketing site. Kept intentionally light so it doesn't compete with the
+// dashboard's own sidebar/topbar navigation.
+function installChrome() {
+  if (document.getElementById('demo-bar')) return;
+  const bar = document.createElement('div');
+  bar.id = 'demo-bar';
+  bar.innerHTML =
+    '<a class="demo-bar__brand" href="/" title="CareerMate 소개로 돌아가기">' +
+      '<span class="demo-bar__logo" aria-hidden="true">C</span>' +
+      '<span class="demo-bar__name">CareerMate</span>' +
+      '<span class="demo-bar__badge">데모</span>' +
+    '</a>' +
+    '<span class="demo-bar__text">샘플 데이터 미리보기 · 입력·수정은 저장되지 않아요</span>' +
+    '<span class="demo-bar__spacer"></span>' +
+    '<button class="demo-bar__icon" id="demo-theme" type="button" aria-label="테마 전환" title="테마 전환"></button>' +
+    '<a class="demo-bar__link" href="/#install">설치하기</a>' +
+    '<a class="demo-bar__link demo-bar__link--primary" href="/">소개로 ←</a>';
+  document.body.prepend(bar);
+  document.body.classList.add('has-demo-bar');
+
+  const toggle = bar.querySelector('#demo-theme');
+  paintToggle(toggle);
+  toggle.addEventListener('click', () => {
+    const next = effectiveTheme() === 'dark' ? 'light' : 'dark';
+    document.documentElement.setAttribute('data-theme', next);
+    try { localStorage.setItem('careermate-theme', next); localStorage.removeItem('cf-theme'); } catch { /* ignore */ }
+    paintToggle(toggle);
+  });
+
+  // Reframe the sidebar footer (it normally says "로컬에서 실행 중").
+  const foot = document.getElementById('foot-status');
+  if (foot) foot.textContent = '데모 모드 · 저장 안 됨';
+  const footPath = document.getElementById('foot-path');
+  if (footPath) footPath.textContent = '브라우저 메모리 · 새로고침 시 초기화';
+}
+if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', installChrome);
+else installChrome();