careermate 0.0.5 → 0.0.7

package/packages/knowledge/src/index.ts

@@ -58,12 +58,13 @@ export const VERIFIER_IDS = [
 ] as const;
 export type VerifierId = (typeof VERIFIER_IDS)[number];
 
-/** 5 per-feature execution procedures — docs/career-os/eop/<feature>.md. */
+/** Per-feature execution procedures — docs/career-os/eop/<feature>.md. */
 export const EOP_FEATURES = [
   'fit-analysis',
   'job-analysis',
   'profile-extraction',
   'cover-letter',
+  'career-description',
   'interview-prep',
 ] as const;
 export type EopFeature = (typeof EOP_FEATURES)[number];
@@ -95,7 +96,7 @@ export function getEop(feature: EopFeature): string {
 
 /** A goal → which EOP, expert playbooks, and verifiers to apply, in order. */
 export interface CareerRoute {
-  eop?: EopFeature;
+  eop?: EopFeature | EopFeature[];
   expertSequence: ExpertDomain[];
   verifierSequence: VerifierId[];
   loop?: 'draft_verify_revise';
@@ -109,23 +110,65 @@ export const CAREER_ROUTES: Record<string, CareerRoute> = {
     verifierSequence: ['truthfulness', 'consistency'],
   },
   analyze_job: {
-    eop: 'job-analysis',
+    eop: ['job-analysis', 'fit-analysis'],
     expertSequence: ['fit-matching', 'company-research'],
     verifierSequence: ['truthfulness', 'consistency', 'responsiveness-on-target'],
     loop: 'draft_verify_revise',
   },
+  // R22(audit): responsiveness-on-target는 한국 문항형 자소서 전용 검증기(문항별 1:1 응답·
+  // 글자수 상·하한 = "핵심 탈락 사유")인데 analyze_job에만 라우팅돼 있어 정작 자소서 자가검증
+  // 루프에서 빠져 있었다. 동문서답·미응답 문항·글자수 초과를 잡도록 write_cover_letter에 추가.
   write_cover_letter: {
     eop: 'cover-letter',
     expertSequence: ['cover-letter', 'human-writing', 'company-research'],
-    verifierSequence: ['human-voice', 'truthfulness', 'ats-compat', 'consistency'],
+    verifierSequence: ['human-voice', 'truthfulness', 'responsiveness-on-target', 'ats-compat', 'consistency'],
+    loop: 'draft_verify_revise',
+  },
+  write_career_description: {
+    eop: 'career-description',
+    expertSequence: ['resume', 'ats'],
+    verifierSequence: ['truthfulness', 'consistency', 'ats-compat'],
     loop: 'draft_verify_revise',
   },
   prepare_interview: {
     eop: 'interview-prep',
-    expertSequence: ['interview-behavioral', 'interview-technical', 'company-research'],
-    verifierSequence: ['truthfulness', 'consistency'],
+    expertSequence: ['recruiter-screen', 'interview-behavioral', 'interview-technical', 'company-research'],
+    // R22(audit): recency-staleness 추가 — 면접의 "최근 소식"·회사 근황이 낡으면 거짓 신선도가
+    // 되므로(company-research) 저장 전 신선도 점검을 푸시한다.
+    verifierSequence: ['truthfulness', 'consistency', 'recency-staleness'],
     loop: 'draft_verify_revise',
   },
+  // R7 A2: manage_application_status had no route → rejection-triage / offer-evaluation /
+  // salary-negotiation were orphaned (served only on-demand via get_playbook). Route the
+  // decision-stage playbooks so they are pushed when the user manages application outcomes.
+  // R7 A4: A2 routed the decision-stage playbooks, but the EOP-free lifecycle domains
+  // onboarding-first-90-days and networking-referrals were still on-demand-only. Anchor them
+  // here (the only EOP-free lifecycle route). NOTE: networking's strongest lever is *before*
+  // applied (pre-referral, networking-referrals §2) — this route is the surfacing point, not
+  // the recommended timing, so surface networking early when the user is pre-application.
+  // linkedin-profile/portfolio stay on-demand pending a dedicated personal-brand workflow id
+  // (FIXES.md / STATUS §7.9 follow-up — onboarding EOP is résumé-import-only, so brand-
+  // creation playbooks would blur its stage meaning). Additive wiring (A1/A2 precedent).
+  manage_application_status: {
+    expertSequence: [
+      'rejection-triage-iteration',
+      'offer-evaluation-decision',
+      'salary-negotiation',
+      'onboarding-first-90-days',
+      'networking-referrals',
+    ],
+    // R22(audit): recency-staleness 추가 — 연봉 벤치마크·오퍼 비교는 시점이 지나면 낡은 기준이
+    // 되므로(salary-negotiation/offer-evaluation) 저장 전 신선도 점검을 푸시한다.
+    verifierSequence: ['truthfulness', 'consistency', 'recency-staleness'],
+  },
+  // R7 후속: linkedin-profile·portfolio는 onboarding(이력서 임포트)과 단계 의미가
+  // 달라(개인 브랜드 자산 *생성*) 전용 워크플로우로 분리(consensus 권고). networking은
+  // manage_application_status에 이미 정박. 저장은 add_resume(kind=portfolio); linkedin
+  // 전용 저장/검증은 Phase B.
+  build_personal_brand: {
+    expertSequence: ['linkedin-profile', 'portfolio'],
+    verifierSequence: ['truthfulness', 'human-voice', 'consistency'],
+  },
 };
 
 export function getRoute(id: string): CareerRoute | undefined {
@@ -142,12 +185,15 @@ export function renderRouteGuide(id: string): string | undefined {
   const route = CAREER_ROUTES[id];
   if (!route) return undefined;
   const lines: string[] = [];
-  if (route.eop) {
+  const eops = route.eop ? (Array.isArray(route.eop) ? route.eop : [route.eop]) : [];
+  if (eops.length) {
     lines.push('---', '');
     lines.push('## 전문가 실행 절차 (EOP) — 즉답하지 말고 이 절차를 따르세요');
     lines.push('');
-    lines.push(getEop(route.eop));
-    lines.push('');
+    for (const e of eops) {
+      lines.push(getEop(e));
+      lines.push('');
+    }
   }
   lines.push('## 이 작업에 적용할 전문가 플레이북');
   lines.push('작성 직전, 아래 도메인의 깊은 지식을 받아 적용하세요:');

package/packages/mcp-tools/src/tools.ts

@@ -21,6 +21,7 @@ import {
   JobInputSchema,
   FitAnalysisInputSchema,
   CoverLetterVersionInputSchema,
+  ApplicationSubmissionSchema,
   InterviewPrepInputSchema,
   DocumentInputSchema,
   APPLICATION_STATUSES,
@@ -63,7 +64,7 @@ import {
   previewCoverLetter,
   summarizeReport,
 } from '@careermate/core';
-import { HUMANIZE_WRITING_GUIDE } from '@careermate/prompts';
+import { getWritingStyleGuide } from '@careermate/prompts';
 import { getWorkflow, renderWorkflowMarkdown, WORKFLOWS } from '@careermate/workflows';
 import {
   getPlaybook,
@@ -75,7 +76,14 @@ import {
   type ExpertDomain,
   type VerifierId,
 } from '@careermate/knowledge';
-import { coverLetterToMarkdown, coverLetterToHtml } from '@careermate/exporters';
+import {
+  coverLetterToMarkdown,
+  coverLetterToHtml,
+  resumeToMarkdown,
+  resumeToHtml,
+  profileToMarkdown,
+  profileToHtml,
+} from '@careermate/exporters';
 import { extractDocument } from '@careermate/parsers';
 import { ok, fail, type ToolDef } from './result.ts';
 import { resolveDashboardUrl, openInBrowser, openInFileManager } from './bridge.ts';
@@ -93,15 +101,28 @@ function listInboxFiles(dir: string): { name: string; path: string }[] {
   } catch {
     return [];
   }
+  // Resolve the inbox itself once so we can confine listed files to it: a symlink
+  // dropped in the inbox whose real target escapes the inbox (e.g. → ~/.ssh/id_rsa
+  // or a private doc elsewhere) must not be listed or later read by read_inbox.
+  let realDir: string;
+  try {
+    realDir = fs.realpathSync.native(dir);
+  } catch {
+    realDir = dir;
+  }
   const SKIP = /^[.~]|^(thumbs\.db|desktop\.ini)$/i;
   const out: { name: string; path: string }[] = [];
   for (const name of names) {
     if (SKIP.test(name)) continue;
     const p = path.join(dir, name);
     try {
-      if (fs.statSync(p).isFile()) out.push({ name, path: p });
+      if (!fs.statSync(p).isFile()) continue;
+      const real = fs.realpathSync.native(p);
+      const rel = path.relative(realDir, real);
+      if (rel.startsWith('..') || path.isAbsolute(rel)) continue; // escapes the inbox — skip
+      out.push({ name, path: p });
     } catch {
-      /* unreadable entry — skip */
+      /* unreadable entry / broken link — skip */
     }
   }
   return out;
@@ -125,13 +146,15 @@ async function mapWithLimit<T, R>(items: T[], limit: number, fn: (item: T, index
   return out;
 }
 
-/** Statuses at/after which interview prep is unlocked (mirror of INTERVIEW_UNLOCK_STATUSES). */
+/** Statuses at/after which interview prep is recommended as a next step. */
 const INTERVIEW_UNLOCKED = ['document_passed', 'interview', 'final_passed'];
 
 /**
  * Pick the recommended Career-OS route from the loaded context, so the AI is
  * nudged onto the expert procedure for what it's most likely about to do.
- * Returns a get_workflow_guide workflow_id, or null when there's no target job.
+ * Returns a get_workflow_guide workflow_id for job-centered tasks, or null when
+ * there's no target job. Non-job tasks such as write_career_description are
+ * selected from the user's explicit request via get_workflow_guide.
  */
 function pickRoute(ctx: ReturnType<typeof getApplicationContext>): string | null {
   if (!ctx.job) return null;
@@ -190,9 +213,9 @@ export const TOOLS: ToolDef[] = [
   /* --------------------------------------------------------- inbox (파일 인입) */
   {
     name: 'open_inbox',
-    title: '이력서 인입 폴더 열기',
+    title: '문서 인입 폴더 열기',
     description:
-      'CLI 클라이언트는 파일 첨부가 안 되므로, 사용자가 기존 이력서·경력기술서 파일(hwp/hwpx/docx/pdf 등)을 끌어다 넣을 수 있는 로컬 인입 폴더(~/.careermate/inbox)를 보장하고 파일 탐색기로 엽니다. 온보딩에서 "기존에 작성해 둔 이력서 파일이 있다"고 사용자가 답했을 때만 호출하세요 — 묻지도 않고 폴더를 자동으로 열지 마세요. 파일 경로를 직접 알려주는 사용자에게는 이 도구 대신 read_document를 쓰세요. 호출하면 폴더 경로와 현재 폴더에 들어 있는 파일 목록을 돌려줍니다. 사용자가 파일을 다 넣었다고 하면 read_inbox로 본문을 읽으세요.',
+      'CLI 클라이언트는 파일 첨부가 안 되므로, 사용자가 기존 이력서·경력기술서·포트폴리오·자기소개서 파일(hwp/hwpx/docx/pdf 등)을 끌어다 넣을 수 있는 로컬 인입 폴더(~/.careermate/inbox)를 보장하고 파일 탐색기로 엽니다. 온보딩에서 "기존에 작성해 둔 문서 파일이 있다"고 사용자가 답했을 때만 호출하세요 — 묻지도 않고 폴더를 자동으로 열지 마세요. 파일 경로를 직접 알려주는 사용자에게는 이 도구 대신 read_document를 쓰세요. 호출하면 폴더 경로와 현재 폴더에 들어 있는 파일 목록을 돌려줍니다. 사용자가 파일을 다 넣었다고 하면 read_inbox로 본문을 읽으세요.',
     inputSchema: {},
     handler: () => {
       const dir = getInboxDir();
@@ -200,7 +223,7 @@ export const TOOLS: ToolDef[] = [
       const files = listInboxFiles(dir);
       const list = files.length ? files.map((f) => `- ${f.name}`).join('\n') : '(아직 비어 있음)';
       return ok(
-        `이력서 인입 폴더를 열었습니다:\n${dir}\n\n여기에 이력서·경력기술서 파일을 넣고 "다 넣었어"라고 알려주세요. (hwp/hwpx/docx는 자동으로 텍스트를 추출하고, pdf·이미지는 제가 직접 읽습니다.)\n\n현재 파일:\n${list}`,
+        `문서 인입 폴더를 열었습니다:\n${dir}\n\n여기에 이력서·경력기술서·포트폴리오·기존 자기소개서 파일을 넣고 "다 넣었어"라고 알려주세요. (hwp·hwpx·docx·pdf는 자동으로 텍스트를 추출하고, 텍스트 레이어가 없는 이미지·스캔 PDF만 제가 직접 읽습니다.)\n\n현재 파일:\n${list}`,
         { dir, files },
       );
     },
@@ -209,7 +232,7 @@ export const TOOLS: ToolDef[] = [
     name: 'read_inbox',
     title: '인입 폴더 파일 읽기',
     description:
-      '인입 폴더(~/.careermate/inbox)에 사용자가 넣어 둔 문서들의 본문을 한 번에 읽어 돌려줍니다. open_inbox로 폴더를 안내한 뒤 사용자가 "다 넣었어"라고 하면 호출하세요. docx/hwp/hwpx/텍스트는 텍스트를 추출하고, pdf·이미지는 추출하지 않고 파일 경로를 돌려주니 AI 클라이언트의 파일 읽기 기능으로 그 경로를 직접 열어 읽으세요. 읽은 내용을 구조화해 save_profile·add_resume 등 알맞은 도구로 저장하세요(파일 내용을 새 파일로 다시 쓰지 마세요). filename을 주면 해당 파일만 읽습니다.',
+      '인입 폴더(~/.careermate/inbox)에 사용자가 넣어 둔 문서들의 본문을 한 번에 읽어 돌려줍니다. open_inbox로 폴더를 안내한 뒤 사용자가 "다 넣었어"라고 하면 호출하세요. docx·hwp·hwpx·pdf·텍스트(.txt/.md)에서 본문 텍스트를 추출해 돌려줍니다(read_document와 동일한 추출 스택). 단 텍스트 레이어가 없는 이미지·스캔 PDF는 추출되지 않아(unsupported=true) 파일 경로만 돌려주니, 그 경로는 AI 클라이언트의 파일 읽기 기능으로 직접 열어 읽으세요. 읽은 내용을 구조화해 프로필은 save_profile, 이력서·경력기술서·포트폴리오는 add_resume, 기존 자기소개서는 save_cover_letter_version으로 저장하세요(파일 내용을 새 파일로 다시 쓰지 마세요). filename을 주면 해당 파일만 읽습니다.',
     inputSchema: {
       filename: z.string().optional().describe('특정 파일만 읽을 때 파일명(대소문자 무시). 생략하면 폴더 안 모든 파일을 읽습니다.'),
       max_chars: z.number().optional().describe('파일별 반환 텍스트 최대 길이(초과 시 잘라냄). 기본 20000자'),
@@ -252,7 +275,7 @@ export const TOOLS: ToolDef[] = [
         )
         .join('\n');
       return ok(
-        `인입 폴더 파일 ${files.length}건을 읽었습니다:\n${summary}\n\n추출된 내용을 구조화해 save_profile·add_resume 등으로 저장하세요.`,
+        `인입 폴더 파일 ${files.length}건을 읽었습니다:\n${summary}\n\n추출된 내용을 구조화해 프로필은 save_profile, 이력서·경력기술서·포트폴리오는 add_resume, 기존 자기소개서는 save_cover_letter_version으로 저장하세요.`,
         { dir, files },
       );
     },
@@ -325,7 +348,7 @@ export const TOOLS: ToolDef[] = [
     name: 'add_resume',
     title: '이력서/경력기술서 추가',
     description:
-      '이력서, 경력기술서, 포트폴리오 등 문서를 저장합니다. content에는 사용자가 업로드/붙여넣은 텍스트(또는 정리한 Markdown)를 넣으세요. kind 기본값은 resume입니다. is_primary=true로 대표 문서를 지정하면 get_application_context의 primary_resume로 노출됩니다.',
+      '이력서, 경력기술서, 포트폴리오 등 문서를 저장합니다. content에는 사용자가 업로드/붙여넣은 텍스트 또는 AI가 전문가 절차로 정리한 Markdown을 넣으세요. 경력기술서를 작성해 저장할 때는 kind=career_description, source=ai를 사용합니다. ⚠️ content에는 이 문서 한 종류의 본문만 넣고, 자기소개서 등 다른 종류 문서를 같은 content에 이어붙이지 마세요 — 자기소개서는 save_cover_letter_version으로 따로 저장합니다(한 번에 둘 다 요청받았어도 한 저장 호출에 두 문서를 합치지 않습니다). kind 기본값은 resume입니다. is_primary=true로 대표 문서를 지정하면 get_application_context의 primary_resume로 노출됩니다.',
     // Reuse the shared (length-bounded, whitespace-rejecting) Document schema so
     // the MCP ingestion path — the primary route for résumé text — inherits the
     // same caps as the web API. kind stays optional here (defaults to resume).
@@ -349,6 +372,24 @@ export const TOOLS: ToolDef[] = [
       return ok(`문서 ${docs.length}건`, docs);
     },
   },
+  {
+    name: 'delete_resume',
+    title: '이력서/문서 삭제',
+    description:
+      '저장된 이력서·경력기술서·포트폴리오 등 문서를 삭제합니다. 사용자가 명확히 삭제를 요청했을 때만 사용하세요. 먼저 get_resumes로 목록을 확인하고 어떤 문서인지 사용자와 확인한 뒤 호출합니다. confirm에는 DELETE를 넣으세요.',
+    inputSchema: {
+      document_id: z.string(),
+      confirm: z.string().describe('삭제 확인값. 정확히 DELETE를 넣어야 삭제됩니다.'),
+    },
+    handler: (args) => {
+      if (args?.confirm !== DELETE_CONFIRMATION) return fail('삭제하려면 confirm에 DELETE를 넣어 다시 호출하세요.');
+      const doc = documentRepo.get(args.document_id);
+      if (!doc) return fail('문서를 찾을 수 없습니다.');
+      if (!documentRepo.remove(doc.id)) return fail('문서를 삭제하지 못했습니다.');
+      const user_message = `'${doc.title}' 문서를 삭제했어요.`;
+      return ok(user_message, { deleted: true, document_id: doc.id, user_message });
+    },
+  },
 
   /* ----------------------------------------------------------- experiences */
   {
@@ -424,6 +465,60 @@ export const TOOLS: ToolDef[] = [
       return ok(`기술 ${list.length}건`, list);
     },
   },
+  {
+    name: 'delete_experience',
+    title: '경력 항목 삭제',
+    description:
+      '구조화된 경력(직장) 항목 하나를 삭제합니다. 잘못 추출/입력된 경력을 지울 때 사용하세요. 먼저 get_experiences로 목록과 id를 확인하고 사용자와 확인한 뒤 호출합니다. (내용 수정은 add_experience로 같은 항목을 다시 저장하면 갱신됩니다.) confirm에는 DELETE를 넣으세요.',
+    inputSchema: {
+      experience_id: z.string(),
+      confirm: z.string().describe('삭제 확인값. 정확히 DELETE를 넣어야 삭제됩니다.'),
+    },
+    handler: (args) => {
+      if (args?.confirm !== DELETE_CONFIRMATION) return fail('삭제하려면 confirm에 DELETE를 넣어 다시 호출하세요.');
+      const exp = experienceRepo.get(args.experience_id);
+      if (!exp) return fail('해당 경력 항목을 찾을 수 없습니다.');
+      if (!experienceRepo.remove(exp.id)) return fail('경력 항목을 삭제하지 못했습니다.');
+      const user_message = `'${exp.company}' 경력을 삭제했어요.`;
+      return ok(user_message, { deleted: true, experience_id: exp.id, user_message });
+    },
+  },
+  {
+    name: 'delete_project',
+    title: '프로젝트 항목 삭제',
+    description:
+      '구조화된 프로젝트 항목 하나를 삭제합니다. 잘못 추출/입력된 프로젝트를 지울 때 사용하세요. 먼저 get_projects로 목록과 id를 확인하고 사용자와 확인한 뒤 호출합니다. (내용 수정은 add_project로 같은 항목을 다시 저장하면 갱신됩니다.) confirm에는 DELETE를 넣으세요.',
+    inputSchema: {
+      project_id: z.string(),
+      confirm: z.string().describe('삭제 확인값. 정확히 DELETE를 넣어야 삭제됩니다.'),
+    },
+    handler: (args) => {
+      if (args?.confirm !== DELETE_CONFIRMATION) return fail('삭제하려면 confirm에 DELETE를 넣어 다시 호출하세요.');
+      const proj = projectRepo.get(args.project_id);
+      if (!proj) return fail('해당 프로젝트 항목을 찾을 수 없습니다.');
+      if (!projectRepo.remove(proj.id)) return fail('프로젝트 항목을 삭제하지 못했습니다.');
+      const user_message = `'${proj.name}' 프로젝트를 삭제했어요.`;
+      return ok(user_message, { deleted: true, project_id: proj.id, user_message });
+    },
+  },
+  {
+    name: 'delete_skill',
+    title: '기술스택 항목 삭제',
+    description:
+      '구조화된 기술스택 항목 하나를 삭제합니다. 잘못 추출/입력된 기술을 지울 때 사용하세요. 먼저 get_skills로 목록과 id를 확인하고 사용자와 확인한 뒤 호출합니다. (내용 수정은 add_skill로 같은 항목을 다시 저장하면 갱신됩니다.) confirm에는 DELETE를 넣으세요.',
+    inputSchema: {
+      skill_id: z.string(),
+      confirm: z.string().describe('삭제 확인값. 정확히 DELETE를 넣어야 삭제됩니다.'),
+    },
+    handler: (args) => {
+      if (args?.confirm !== DELETE_CONFIRMATION) return fail('삭제하려면 confirm에 DELETE를 넣어 다시 호출하세요.');
+      const skill = skillRepo.get(args.skill_id);
+      if (!skill) return fail('해당 기술 항목을 찾을 수 없습니다.');
+      if (!skillRepo.remove(skill.id)) return fail('기술 항목을 삭제하지 못했습니다.');
+      const user_message = `'${skill.name}' 기술을 삭제했어요.`;
+      return ok(user_message, { deleted: true, skill_id: skill.id, user_message });
+    },
+  },
 
   /* ---------------------------------------------------------- cover letters */
   {
@@ -441,7 +536,7 @@ export const TOOLS: ToolDef[] = [
     name: 'save_cover_letter_version',
     title: '자기소개서 버전 저장',
     description:
-      '자기소개서의 새 버전을 저장합니다. CareerMate 자소서 작성 워크플로우의 핵심 저장 단계입니다. cover_letter_id를 주면 기존 자소서에 새 버전을 추가하고, 없으면 새 자소서를 만들어 v1로 저장합니다(이때 title 권장). note에 이 버전의 변경 요약(예: "지원동기 보강")을 남기면 사용자가 대시보드에서 버전 히스토리를 이해하기 쉽습니다. job_id로 공고에 연결하면 지원 항목과 자동 연결됩니다. 저장 직전 자동으로 "근거 없는 수치" 점검을 돌립니다 — 본문의 정량 수치가 저장된 경력·이력서·프로젝트에 근거가 없으면(환각 의심) 저장이 막힙니다. 그때는 원본의 실제 수치로 고치거나, 의도한 값이면 force:true로 다시 저장하세요.',
+      '자기소개서의 새 버전을 저장합니다. CareerMate 자소서 작성 워크플로우의 핵심 저장 단계입니다. ⚠️ content에는 자기소개서 본문만 넣고, 경력기술서 등 다른 종류 문서를 이어붙이지 마세요(경력기술서는 add_resume(kind=career_description)로 따로 저장). cover_letter_id를 주면 기존 자소서에 새 버전을 추가하고, 없으면 새 자소서를 만들어 v1로 저장합니다(이때 title 권장). note에 이 버전의 변경 요약(예: "지원동기 보강")을 남기면 사용자가 대시보드에서 버전 히스토리를 이해하기 쉽습니다. job_id로 공고에 연결하면 지원 항목과 자동 연결됩니다. 저장 직전 자동으로 "근거 없는 수치" 점검을 돌립니다 — 본문의 정량 수치가 저장된 경력·이력서·프로젝트에 근거가 없으면(환각 의심) 저장이 막힙니다. 그때는 원본의 실제 수치로 고치거나, 의도한 값이면 force:true로 다시 저장하세요.',
     inputSchema: CoverLetterVersionInputSchema.shape,
     handler: (args) => {
       try {
@@ -513,7 +608,7 @@ export const TOOLS: ToolDef[] = [
   {
     name: 'get_job_posting',
     title: '채용공고 상세 조회',
-    description: '공고 1건의 상세를 조회합니다. 공고 정보와 함께 적합도 분석, 지원 상태, 연결된 자기소개서, 면접 준비 자료를 한 번에 돌려줍니다.',
+    description: '공고 1건의 상세를 조회합니다. 공고 정보와 함께 적합도 분석, 지원 상태, 자기소개서, 면접 준비 자료를 한 번에 돌려줍니다.',
     inputSchema: { job_id: z.string() },
     readOnly: true,
     handler: (args) => {
@@ -586,13 +681,48 @@ export const TOOLS: ToolDef[] = [
       // 여기에 추천 경로를 실어 전문가 절차로 유도한다. 스키마 변경 없이 반환 JSON만 확장.
       const recommended_route = pickRoute(ctx);
       const route = recommended_route ? getRoute(recommended_route) : undefined;
+      // 오늘 날짜 주입: LLM은 현재 날짜를 신뢰성 있게 모른다.
+      const today = new Date().toISOString().slice(0, 10);
+      // 재직기간/연차는 LLM이 산술하면 회귀하므로(검증됨) 서버가 결정적으로 계산해 제공한다.
+      // 재직중 경력의 확정 연차 = updated_at(정보 입력·확인 시점) − start_date — today가 아님(아직 재직
+      // 중인지 미확인이라 today로 계산하면 과대 산정·명시 연차와 충돌). 종료 경력 = end_date − start_date.
+      // data_age_months = 재직중 정보가 얼마나 오래됐나(크면 '현재도 재직 중인지 확인 필요').
+      const ym = (s: string | null | undefined): number | null => {
+        const m = s ? /^(\d{4})-(\d{2})/.exec(s) : null;
+        return m ? Number(m[1]) * 12 + Number(m[2]) : null;
+      };
+      const monthsBetween = (a: string | null | undefined, b: string | null | undefined): number | null => {
+        const x = ym(a), y = ym(b);
+        return x != null && y != null ? y - x : null;
+      };
+      const tenure = ctx.experiences
+        .map((e) => {
+          if (!e.start_date) return null;
+          const asOf = e.is_current ? (e.updated_at ?? today) : e.end_date;
+          const months = monthsBetween(e.start_date, asOf);
+          if (months == null || months < 0) return null;
+          return {
+            company: e.company,
+            is_current: e.is_current,
+            start_date: e.start_date,
+            as_of: (asOf ?? '').slice(0, 7), // 재직중=updated_at(정보 확인 시점) / 종료=end_date
+            months,
+            years: Math.round((months / 12) * 10) / 10,
+            // 음수 방지(미래 updated_at·시계 오차) — 0 미만은 0으로 클램프
+            data_age_months: e.is_current ? Math.max(0, monthsBetween(e.updated_at, today) ?? 0) : null,
+          };
+        })
+        .filter((t): t is NonNullable<typeof t> => t != null);
       const enriched = {
         ...ctx,
+        today,
+        tenure,
         recommended_route,
         verifier_sequence: route?.verifierSequence ?? [],
         next_tool: recommended_route ? 'get_workflow_guide' : null,
       };
       const summary = [
+        `오늘 날짜: ${today}. 경력 연차·재직기간은 직접 계산하지 말고 제공된 tenure[](서버 계산: 재직중=정보확인일 기준 연차, data_age_months 크면 현재 재직 확인 필요)를 그대로 쓰세요.`,
         `프로필: ${ctx.profile?.name ?? '미입력'}`,
         `이력서 ${ctx.resumes.length} · 경력 ${ctx.experiences.length} · 프로젝트 ${ctx.projects.length} · 스킬 ${ctx.skills.length} · 자소서 ${ctx.cover_letters.length}`,
         ctx.job ? `대상 공고: ${ctx.job.company} · ${ctx.job.position}` : '대상 공고 없음',
@@ -614,7 +744,7 @@ export const TOOLS: ToolDef[] = [
       try {
         const fit = saveFitAnalysis(args);
         const suggested_next_action = {
-          prompt: '이 공고에 맞춘 자기소개서를 써드릴까요?',
+          prompt: '이 공고에 맞춘 자기소개서를 써드릴까요? (회사 지정 문항·양식·글자수가 있으면 함께 알려주시면 그에 맞춰 작성합니다)',
           options: [
             {
               label: '네, 이 공고에 맞춘 자기소개서를 써줘',
@@ -634,6 +764,7 @@ export const TOOLS: ToolDef[] = [
             '사용자에게 다음 선택지를 보여주세요:',
             '1. 네, 이 공고에 맞춘 자기소개서를 써줘',
             '2. 아니요, 분석만 저장해줘',
+            '(1번이면, 회사 지정 문항·양식·글자수가 있으면 알려달라고 요청하세요 — 한국 자소서는 문항형이 많습니다. 없으면 일반 양식으로 진행합니다.)',
           ].join('\n'),
           {
             ...fit,
@@ -656,10 +787,11 @@ export const TOOLS: ToolDef[] = [
       job_id: z.string(),
       status: z.enum(APPLICATION_STATUSES),
       note: z.string().optional(),
+      submission: ApplicationSubmissionSchema.optional(),
     },
     handler: (args) => {
       try {
-        const res = updateApplicationStatus(args.job_id, args.status, args.note);
+        const res = updateApplicationStatus(args.job_id, args.status, args.note, args.submission);
         const user_message =
           `지원 상태를 '${APPLICATION_STATUS_LABELS[args.status as keyof typeof APPLICATION_STATUS_LABELS]}'(으)로 바꿨어요.` +
           (res.hint ? `\n\n${res.hint}` : '');
@@ -687,12 +819,19 @@ export const TOOLS: ToolDef[] = [
     name: 'save_interview_prep',
     title: '면접 준비 자료 저장',
     description:
-      '예상 면접 질문, 꼬리 질문, STAR 답변 가이드, 1분 자기소개 초안 등 면접 준비 자료를 저장합니다. 보통 지원 상태가 서류 합격으로 바뀐 뒤, 해당 공고/직무/자소서를 근거로 당신(AI)이 생성한 자료를 저장하는 데 사용합니다. job_id는 필수입니다. 같은 공고에 다시 저장하면 갱신됩니다.',
+      '예상 면접 질문, 꼬리 질문, STAR 답변 가이드, 1분 자기소개 초안 등 해당 공고 기준 면접 준비 자료를 저장합니다. 공고/직무/자기소개서를 근거로 당신(AI)이 생성한 자료를 저장하는 데 사용합니다. ' +
+      "질문은 두 갈래로 준비하세요 — 각 질문의 category를 'technical'(기술·직무 1차 면접) 또는 'behavioral'(인성·컬처핏·임원 2차 면접, 자기소개서·프로필 기반)로 지정합니다. 가능하면 두 갈래 모두 채워 한 번에 저장하세요(대시보드가 기술/인성·컬처핏 탭으로 나눠 보여줍니다). " +
+      'job_id는 필수입니다. 같은 공고에 다시 저장하면 갱신됩니다.',
     inputSchema: InterviewPrepInputSchema.shape,
     handler: (args) => {
       try {
         const prep = saveInterviewPrep(args);
-        const user_message = `면접 준비 자료를 저장했어요. 예상 질문 ${prep.questions.length}개가 준비되어 있습니다.`;
+        const tech = prep.questions.filter((q) => (q.category ?? 'technical') === 'technical').length;
+        const behavioral = prep.questions.filter((q) => q.category === 'behavioral').length;
+        const user_message =
+          `면접 준비 자료를 저장했어요. 예상 질문 ${prep.questions.length}개` +
+          (behavioral > 0 ? ` (기술 ${tech}개 · 인성·컬처핏 ${behavioral}개)` : '') +
+          '가 준비되어 있습니다.';
         return ok(user_message, { ...prep, user_message });
       } catch (e) {
         return fail(e instanceof Error ? e.message : '저장 실패');
@@ -731,6 +870,68 @@ export const TOOLS: ToolDef[] = [
       });
     },
   },
+  {
+    name: 'export_resume',
+    title: '이력서/경력기술서 내보내기',
+    description:
+      '저장된 이력서·경력기술서 등 문서를 Markdown 또는 인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로와 본문을 돌려줍니다. 사용자가 공고에 맞춰 정리한 이력서를 먼저 add_resume로 저장한 뒤, "이력서 파일로 받고 싶어"라고 할 때 사용하세요. document_id는 get_resumes로 확인할 수 있습니다. 대시보드에서 직접 다운로드할 수도 있습니다.',
+    inputSchema: {
+      document_id: z.string(),
+      format: z.enum(['md', 'html']).optional().describe('기본 md'),
+    },
+    handler: (args) => {
+      const doc = documentRepo.get(args.document_id);
+      if (!doc) return fail('문서를 찾을 수 없습니다.');
+      const profile = profileRepo.get();
+      const format = args.format ?? 'md';
+      const result = format === 'html' ? resumeToHtml(doc, profile) : resumeToMarkdown(doc, profile);
+      const dir = getExportsDir();
+      const filePath = path.join(dir, result.filename);
+      try {
+        fs.writeFileSync(filePath, result.content, 'utf8');
+      } catch (e) {
+        return fail(`파일 저장 실패: ${e instanceof Error ? e.message : e}`);
+      }
+      return ok(`'${doc.title}'를 ${format.toUpperCase()}로 내보냈습니다.\n저장 위치: ${filePath}`, {
+        path: filePath,
+        filename: result.filename,
+        content: result.content,
+      });
+    },
+  },
+  {
+    name: 'export_profile',
+    title: '프로필을 이력서로 내보내기',
+    description:
+      '저장된 프로필·경력·프로젝트·보유 기술을 한 장의 이력서 형식으로 모아 Markdown 또는 인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로와 본문을 돌려줍니다. 사용자가 "내 프로필을 이력서로 뽑아줘"처럼 구조화된 데이터 전체를 이력서로 받고 싶을 때 사용하세요. 특정 공고 맞춤 이력서는 add_resume로 정리·저장한 뒤 export_resume를 쓰세요. 대시보드에서 직접 다운로드할 수도 있습니다.',
+    inputSchema: {
+      format: z.enum(['md', 'html']).optional().describe('기본 md'),
+    },
+    handler: (args) => {
+      const profile = profileRepo.get();
+      if (!profile) return fail('프로필이 없습니다. 먼저 프로필을 저장하세요.');
+      const format = args.format ?? 'md';
+      const experiences = experienceRepo.list();
+      const projects = projectRepo.list();
+      const skills = skillRepo.list();
+      const result =
+        format === 'html'
+          ? profileToHtml(profile, experiences, projects, skills)
+          : profileToMarkdown(profile, experiences, projects, skills);
+      const dir = getExportsDir();
+      const filePath = path.join(dir, result.filename);
+      try {
+        fs.writeFileSync(filePath, result.content, 'utf8');
+      } catch (e) {
+        return fail(`파일 저장 실패: ${e instanceof Error ? e.message : e}`);
+      }
+      return ok(`프로필을 이력서(${format.toUpperCase()})로 내보냈습니다.\n저장 위치: ${filePath}`, {
+        path: filePath,
+        filename: result.filename,
+        content: result.content,
+      });
+    },
+  },
 
   /* ----------------------------------------------------------- dashboard ui */
   {
@@ -780,10 +981,18 @@ export const TOOLS: ToolDef[] = [
     name: 'get_workflow_guide',
     title: '워크플로우 가이드',
     description:
-      '커리어 작업(공고 분석·자소서·면접 준비 등)을 시작하기 직전에 호출하세요. 표준 워크플로우의 단계별 안내에 더해, 그 작업의 "전문가 실행 절차(EOP)"와 적용할 전문가 플레이북·저장 전 검증기 순서를 한 번에 돌려줍니다. 안내된 대로 get_playbook으로 도메인 지식을, 저장 직전 get_verifier로 검증 루브릭을 받아 적용하세요. workflow_id를 생략하면 전체 목록을 돌려줍니다.',
+      '커리어 작업(공고 분석·자소서·경력기술서·면접 준비 등)을 시작하기 직전에 호출하세요. 표준 워크플로우의 단계별 안내에 더해, 그 작업의 "전문가 실행 절차(EOP)"와 적용할 전문가 플레이북·저장 전 검증기 순서를 한 번에 돌려줍니다. 안내된 대로 get_playbook으로 도메인 지식을, 저장 직전 get_verifier로 검증 루브릭을 받아 적용하세요. workflow_id를 생략하면 전체 목록을 돌려줍니다.',
     inputSchema: {
       workflow_id: z
-        .enum(['onboarding', 'analyze_job', 'write_cover_letter', 'manage_application_status', 'prepare_interview'])
+        .enum([
+          'onboarding',
+          'analyze_job',
+          'write_cover_letter',
+          'write_career_description',
+          'manage_application_status',
+          'prepare_interview',
+          'build_personal_brand',
+        ])
         .optional(),
     },
     readOnly: true,
@@ -899,10 +1108,27 @@ export const TOOLS: ToolDef[] = [
     name: 'get_writing_style_guide',
     title: 'AI 티 안 나는 글쓰기 가이드',
     description:
-      '자기소개서·자기 PR·지원 메일 등 사람이 쓴 듯한 글을 작성하기 직전에 호출하세요. "AI가 쓴 티"가 나는 한국어 문장 습관(번역투, 클리셰, 기계적 병렬, 상투적 연결어, 균일한 문장 리듬 등)을 제거하는 작성 규칙과 저장 전 자가 점검 항목을 돌려줍니다. 사실·수치·고유명사는 그대로 두고 문장 결만 다듬도록 안내합니다. write_cover_letter / analyze_job 워크플로우에서 자기소개서를 쓸 때 반드시 함께 적용하세요.',
-    inputSchema: {},
+      '자기소개서·자기 PR·지원 메일 등 사람이 쓴 듯한 글을 작성하기 직전에 호출하세요. "AI가 쓴 티"가 나는 한국어 문장 습관(번역투, 클리셰, 기계적 병렬, 상투적 연결어, 균일한 문장 리듬 등)을 제거하는 작성 규칙과 저장 전 자가 점검 항목을 돌려줍니다. 사실·수치·고유명사는 그대로 두고 문장 결만 다듬도록 안내합니다. 경력기술서·이력서·포트폴리오를 쓸 때는 doc_type을 함께 주면 불릿·번호 성과 같은 구조를 산문으로 평탄화하지 않도록 구조 보존 보정 지침을 더해 돌려줍니다. write_cover_letter / write_career_description / analyze_job 워크플로우에서 글을 쓸 때 반드시 함께 적용하세요.',
+    inputSchema: {
+      doc_type: z
+        .enum([
+          'cover_letter',
+          'self_pr',
+          'application_email',
+          'career_description',
+          'resume',
+          'portfolio',
+        ])
+        .optional()
+        .describe(
+          '작성할 문서 유형. career_description·resume·portfolio는 불릿·구조를 보존하는 보정을 더해 돌려줍니다. 생략하면 자기소개서 등 산문형 기준.',
+        ),
+    },
     readOnly: true,
-    handler: () => ok('AI 티 안 나는 글쓰기 가이드를 적용해 작성하세요.', { guide: HUMANIZE_WRITING_GUIDE }),
+    handler: (args) =>
+      ok('AI 티 안 나는 글쓰기 가이드를 적용해 작성하세요.', {
+        guide: getWritingStyleGuide(args?.doc_type),
+      }),
   },
 
   /* ----------------------------------------------------------------- update */
@@ -914,7 +1140,7 @@ export const TOOLS: ToolDef[] = [
     inputSchema: {},
     readOnly: true,
     handler: async () => {
-      const u = await getUpdateStatusAsync();
+      const u = await getUpdateStatusAsync(true); // "지금 확인" — 신선한 캐시 무시하고 재조회
       if (u.latest === null) return ok('업데이트 확인에 실패했습니다(오프라인이거나 일시적 오류). 잠시 후 다시 시도하세요.', u);
       const user_message = u.update_available
         ? `새 버전 v${u.latest}이 나왔어요. 현재 버전은 v${u.current}입니다. 원하시면 지금 업데이트할 수 있습니다.`

package/packages/mcp-tools/src/update.ts

@@ -193,17 +193,34 @@ export function getUpdateStatus(): UpdateStatus {
 }
 
 /**
- * 즉시(바운드) 업데이트 확인. 캐시가 만료면 레지스트리를 한 번 await하고 캐시를 갱신한다.
- * doctor·check_for_update처럼 "지금 확인" 의미가 분명한 일회성 호출에서 사용.
+ * 즉시(바운드) 업데이트 확인. doctor·check_for_update처럼 "지금 확인" 의미가 분명한
+ * 일회성 호출에서 사용.
+ *
+ * `force=true`("지금 확인")면 신선한 24h 캐시여도 무시하고 레지스트리를 새로 읽는다 —
+ * 캐시가 직전 릴리스(예: 0.0.3) 시점에 채워진 채 새 버전(0.0.4)이 나오면, 설치본보다
+ * 오래된 `latest`를 돌려주던 버그를 막는다. 강제 조회가 네트워크 오류로 실패하면 멀쩡한
+ * 기존 캐시를 null로 덮지 않고(비차단 신호 getUpdateStatus 보호) "확인 실패"로만 보고한다.
+ *
+ * `force=false`(기본, 만료 재확인)면 기존대로 캐시를 존중하고, 실패는 짧은 TTL의 null로
+ * 기록해 잦은 재시도를 막는다.
  */
-export async function getUpdateStatusAsync(): Promise<UpdateStatus> {
+export async function getUpdateStatusAsync(force = false): Promise<UpdateStatus> {
   if (checkDisabled()) return buildStatus(null);
-  let cache = readCache();
-  if (cacheExpired(cache)) {
-    cache = { checkedAt: Date.now(), latest: await fetchLatest() };
-    writeCache(cache);
+  const cache = readCache();
+  if (!force && !cacheExpired(cache)) return buildStatus(cache);
+
+  const latest = await fetchLatest();
+  if (latest !== null) {
+    const fresh = { checkedAt: Date.now(), latest };
+    writeCache(fresh);
+    return buildStatus(fresh);
   }
-  return buildStatus(cache);
+  // fetch 실패. 강제("지금 확인")는 정직하게 실패로 보고하되 멀쩡한 기존 캐시는 보존한다.
+  if (force) return buildStatus(null);
+  // 비강제(만료 재확인)는 기존처럼 null을 짧은 TTL로 기록해 잦은 재시도를 막는다.
+  const failed = { checkedAt: Date.now(), latest: null };
+  writeCache(failed);
+  return buildStatus(failed);
 }
 
 export interface UpdateResult {
@@ -288,13 +305,11 @@ export async function runSelfUpdate(): Promise<UpdateResult> {
       manual: manualCommand(),
     };
   }
-  // 최신 버전: 신선한 캐시가 있으면 재사용하고, 없으면 한 번만 조회한다(레지스트리 중복 호출 방지).
-  let cache = readCache();
-  if (cacheExpired(cache)) {
-    cache = { checkedAt: Date.now(), latest: await fetchLatest() };
-    writeCache(cache);
-  }
-  const latest = cache?.latest ?? null;
+  // 최신 버전: "업데이트해줘"는 명시적 사용자 행동이라 신선한 캐시여도 새로 조회한다 —
+  // 직전 릴리스 시점에 채워진 캐시가 'already latest'로 오판해 실제 업데이트를 건너뛰지 않게.
+  // 실패(null)면 아래 가드가 안내로 빠지며, 멀쩡한 기존 캐시는 덮지 않는다.
+  const latest = await fetchLatest();
+  if (latest !== null) writeCache({ checkedAt: Date.now(), latest });
   // 최신 버전을 확인하지 못함(오프라인/레지스트리 오류): 무엇을 설치할지 모른 채 실행 중인
   // 설치를 덮어쓰면 반파 위험이 있으므로 시도하지 않고 안내한다.
   if (latest === null) {