careermate 0.0.4 → 0.0.6

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,13 +76,22 @@ 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';
 import { getUpdateStatus, getUpdateStatusAsync, runSelfUpdate } from './update.ts';
 
 const STATUS_LIST = APPLICATION_STATUSES.map((s) => `${s}(${APPLICATION_STATUS_LABELS[s]})`).join(', ');
+const DELETE_CONFIRMATION = 'DELETE';
+const DASHBOARD_URL = 'http://127.0.0.1:4319';
 
 /** List real, user-dropped files in the inbox (skips hidden/OS/office-lock cruft). */
 function listInboxFiles(dir: string): { name: string; path: string }[] {
@@ -91,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;
@@ -123,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;
@@ -188,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();
@@ -198,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·이미지는 제가 직접 읽습니다.)\n\n현재 파일:\n${list}`,
         { dir, files },
       );
     },
@@ -207,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·이미지는 추출하지 않고 파일 경로를 돌려주니 AI 클라이언트의 파일 읽기 기능으로 그 경로를 직접 열어 읽으세요. 읽은 내용을 구조화해 프로필은 save_profile, 이력서·경력기술서·포트폴리오는 add_resume, 기존 자기소개서는 save_cover_letter_version으로 저장하세요(파일 내용을 새 파일로 다시 쓰지 마세요). filename을 주면 해당 파일만 읽습니다.',
     inputSchema: {
       filename: z.string().optional().describe('특정 파일만 읽을 때 파일명(대소문자 무시). 생략하면 폴더 안 모든 파일을 읽습니다.'),
       max_chars: z.number().optional().describe('파일별 반환 텍스트 최대 길이(초과 시 잘라냄). 기본 20000자'),
@@ -250,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 },
       );
     },
@@ -278,9 +303,19 @@ export const TOOLS: ToolDef[] = [
           `더 깐깐하게 보길 원하면 "엄격하게 봐줘"라고 하거나 대시보드 설정에서 엄격 모드를 켤 수 있어요(이력서 본문에 없는 수치까지 차단).`;
       }
       if (upd.update_available) {
-        text += `\n\n🆕 새 버전 v${upd.latest} 사용 가능 (현재 v${upd.current}). 사용자가 원하면 update_careermate 도구로 업데이트하세요.`;
+        text += `\n\n새 버전 v${upd.latest}이 나왔습니다(현재 v${upd.current}). 사용자가 원하면 바로 업데이트를 진행하세요. 업데이트 후에는 AI 앱 또는 MCP 연결을 재시작해야 적용됩니다.`;
       }
-      return ok(text, { ...s, verify_strict: strict, update: upd });
+      return ok(text, {
+        ...s,
+        verify_strict: strict,
+        update: upd,
+        suggested_next_action: upd.update_available
+          ? {
+              prompt: `새 버전 v${upd.latest}이 나왔습니다. 지금 업데이트할까요?`,
+              next_tool: 'update_careermate',
+            }
+          : null,
+      });
     },
   },
 
@@ -313,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를 사용합니다. 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).
@@ -337,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 */
   {
@@ -412,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 */
   {
@@ -451,6 +558,32 @@ export const TOOLS: ToolDef[] = [
       }
     },
   },
+  {
+    name: 'delete_cover_letter',
+    title: '자기소개서 삭제',
+    description:
+      '사용자가 저장된 자기소개서 삭제를 명확히 요청했을 때만 사용합니다. 먼저 get_cover_letters로 전체 목록 또는 공고별 목록을 확인하고, 삭제할 항목을 사용자가 확인한 뒤 호출하세요. 삭제하면 해당 자기소개서의 모든 버전이 함께 삭제되며 되돌릴 수 없습니다. confirm에는 DELETE를 넣으세요.',
+    inputSchema: {
+      cover_letter_id: z.string(),
+      confirm: z.string().describe('삭제 확인값. 정확히 DELETE를 넣어야 삭제됩니다.'),
+    },
+    handler: (args) => {
+      if (args?.confirm !== DELETE_CONFIRMATION) {
+        return fail('삭제하려면 confirm에 DELETE를 넣어 다시 호출하세요.');
+      }
+      const cl = coverLetterRepo.get(args.cover_letter_id, false);
+      if (!cl) return fail('자기소개서를 찾을 수 없습니다.');
+      const removed = coverLetterRepo.remove(cl.id);
+      if (!removed) return fail('자기소개서를 삭제하지 못했습니다.');
+      const user_message = `'${cl.title}' 자기소개서를 삭제했어요. 연결된 지원 기록에서는 자기소개서 연결만 비워뒀습니다.`;
+      return ok(user_message, {
+        deleted: true,
+        cover_letter_id: cl.id,
+        title: cl.title,
+        user_message,
+      });
+    },
+  },
 
   /* ------------------------------------------------------------------ jobs */
   {
@@ -461,18 +594,26 @@ export const TOOLS: ToolDef[] = [
     inputSchema: JobInputSchema.shape,
     handler: (args) => {
       const { job } = saveJobPosting(args);
-      return ok(`'${job.company} · ${job.position}' 공고를 저장했습니다. (job_id: ${job.id})`, job);
+      const user_message = `'${job.company} · ${job.position}' 공고를 저장했어요.`;
+      return ok(user_message, {
+        ...job,
+        user_message,
+        suggested_next_action: {
+          prompt: '이 공고와 내 프로필을 비교해 적합도를 분석할까요?',
+          next_workflow: 'analyze_job',
+        },
+      });
     },
   },
   {
     name: 'get_job_posting',
     title: '채용공고 상세 조회',
-    description: '공고 1건의 상세를 조회합니다. 공고 정보와 함께 적합도 분석, 지원 상태, 연결된 자기소개서, 면접 준비 자료를 한 번에 돌려줍니다.',
+    description: '공고 1건의 상세를 조회합니다. 공고 정보와 함께 적합도 분석, 지원 상태, 자기소개서, 면접 준비 자료를 한 번에 돌려줍니다.',
     inputSchema: { job_id: z.string() },
     readOnly: true,
     handler: (args) => {
       const job = jobRepo.get(args.job_id);
-      if (!job) return fail(`공고를 찾을 수 없습니다: ${args.job_id}`);
+      if (!job) return fail('공고를 찾을 수 없습니다.');
       return ok(`${job.company} · ${job.position}`, {
         job: jobWithMeta(job),
         fit: fitRepo.getByJob(job.id),
@@ -493,6 +634,38 @@ export const TOOLS: ToolDef[] = [
       return ok(`공고 ${jobs.length}건`, jobs);
     },
   },
+  {
+    name: 'delete_job_posting',
+    title: '채용공고 삭제',
+    description:
+      '사용자가 저장된 채용공고 삭제를 명확히 요청했을 때만 사용합니다. 먼저 list_jobs로 전체 공고 목록을 확인하고, 삭제할 공고를 사용자가 확인한 뒤 호출하세요. 삭제하면 연결된 지원 상태·적합도 분석·면접 준비가 함께 삭제됩니다. 연결된 자기소개서는 삭제하지 않고 공고 연결만 해제합니다. confirm에는 DELETE를 넣으세요.',
+    inputSchema: {
+      job_id: z.string(),
+      confirm: z.string().describe('삭제 확인값. 정확히 DELETE를 넣어야 삭제됩니다.'),
+    },
+    handler: (args) => {
+      if (args?.confirm !== DELETE_CONFIRMATION) {
+        return fail('삭제하려면 confirm에 DELETE를 넣어 다시 호출하세요.');
+      }
+      const job = jobRepo.get(args.job_id);
+      if (!job) return fail('공고를 찾을 수 없습니다.');
+      const detachedCoverLetters = coverLetterRepo.listByJob(job.id).length;
+      const removed = jobRepo.remove(job.id);
+      if (!removed) return fail('공고를 삭제하지 못했습니다.');
+      const detachedNote = detachedCoverLetters
+        ? ` 연결된 자기소개서 ${detachedCoverLetters}건은 삭제하지 않고 공고 연결만 해제했습니다.`
+        : '';
+      const user_message = `'${job.company} · ${job.position}' 공고를 삭제했어요. 연결된 지원 상태, 적합도 분석, 면접 준비도 함께 정리했습니다.${detachedNote}`;
+      return ok(user_message, {
+        deleted: true,
+        job_id: job.id,
+        company: job.company,
+        position: job.position,
+        detached_cover_letters: detachedCoverLetters,
+        user_message,
+      });
+    },
+  },
 
   /* ----------------------------------------------------- application context */
   {
@@ -508,20 +681,54 @@ 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,
+            data_age_months: e.is_current ? monthsBetween(e.updated_at, today) : 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}` : '대상 공고 없음',
         ctx.writing_preferences.preferred_tone ? `선호 문체: ${ctx.writing_preferences.preferred_tone}` : '',
         recommended_route
-          ? `💡 다음 단계: get_workflow_guide({ workflow_id: "${recommended_route}" })로 전문가 실행 절차(EOP)와 적용할 플레이북·검증 순서를 받아 적용하세요(즉답 금지).`
-          : '💡 커리어 작업을 시작하려면 get_workflow_guide로 전문가 실행 절차와 검증 순서를 먼저 받으세요.',
+          ? `내부 안내: 사용자에게는 도구명이나 ID를 말하지 말고, 먼저 get_workflow_guide({ workflow_id: "${recommended_route}" })로 실행 절차와 검증 순서를 받은 뒤 쉬운 말로 안내하세요.`
+          : '내부 안내: 사용자에게는 도구명을 말하지 말고, 먼저 get_workflow_guide로 실행 절차와 검증 순서를 받은 뒤 쉬운 말로 안내하세요.',
       ].filter(Boolean).join('\n');
       return ok(summary, enriched);
     },
@@ -535,7 +742,34 @@ export const TOOLS: ToolDef[] = [
     handler: (args) => {
       try {
         const fit = saveFitAnalysis(args);
-        return ok(`적합도 분석을 저장했습니다${fit.score != null ? ` (${fit.score}점)` : ''}.`, fit);
+        const suggested_next_action = {
+          prompt: '이 공고에 맞춘 자기소개서를 써드릴까요?',
+          options: [
+            {
+              label: '네, 이 공고에 맞춘 자기소개서를 써줘',
+              next_workflow: 'write_cover_letter',
+            },
+            {
+              label: '아니요, 분석만 저장해줘',
+              next_workflow: null,
+            },
+          ],
+        };
+        const user_message = `적합도 분석을 저장했어요${fit.score != null ? ` (${fit.score}점)` : ''}. 자세한 결과는 대시보드에서도 확인할 수 있습니다: ${DASHBOARD_URL}`;
+        return ok(
+          [
+            user_message,
+            '',
+            '사용자에게 다음 선택지를 보여주세요:',
+            '1. 네, 이 공고에 맞춘 자기소개서를 써줘',
+            '2. 아니요, 분석만 저장해줘',
+          ].join('\n'),
+          {
+            ...fit,
+            user_message,
+            suggested_next_action,
+          },
+        );
       } catch (e) {
         return fail(e instanceof Error ? e.message : '저장 실패');
       }
@@ -551,13 +785,26 @@ 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}` : '');
         return ok(
-          `상태를 '${APPLICATION_STATUS_LABELS[args.status as keyof typeof APPLICATION_STATUS_LABELS]}'(으)로 변경했습니다.${res.hint ? `\n\n💡 ${res.hint}` : ''}`,
-          res,
+          user_message,
+          {
+            ...res,
+            user_message,
+            suggested_next_action: res.hint
+              ? {
+                  prompt: res.hint,
+                  next_workflow: 'prepare_interview',
+                }
+              : null,
+          },
         );
       } catch (e) {
         return fail(e instanceof Error ? e.message : '변경 실패');
@@ -570,12 +817,20 @@ 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);
-        return ok(`면접 준비 자료를 저장했습니다 (질문 ${prep.questions.length}개).`, prep);
+        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 : '저장 실패');
       }
@@ -613,6 +868,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 */
   {
@@ -662,10 +979,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,
@@ -781,10 +1106,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 */
@@ -792,17 +1134,27 @@ export const TOOLS: ToolDef[] = [
     name: 'check_for_update',
     title: '업데이트 확인',
     description:
-      'CareerMate에 새 버전이 있는지 npm 레지스트리에서 지금 확인합니다(공개 버전 정보만 GET하며 사용자 데이터는 전송하지 않습니다). 현재 버전·최신 버전·업데이트 가능 여부를 돌려줍니다. 사용자가 "최신이야?/업데이트 있어?"라고 묻거나, get_onboarding_status가 새 버전을 알릴 때 호출하세요. 실제 적용은 update_careermate로 합니다.',
+      'CareerMate에 새 버전이 있는지 npm 레지스트리에서 지금 확인합니다(공개 버전 정보만 GET하며 사용자 데이터는 전송하지 않습니다). 현재 버전·최신 버전·업데이트 가능 여부를 돌려줍니다. 사용자가 "최신이야?/업데이트 있어?"라고 묻거나, get_onboarding_status가 새 버전을 알릴 때 호출하세요. 확인만 하고 설치는 하지 않습니다. 사용자가 "업데이트해줘/최신으로 올려줘"처럼 명시적으로 요청하면 update_careermate를 호출하세요.',
     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}입니다. 원하시면 지금 업데이트할 수 있습니다.`
+        : `최신 버전입니다 (v${u.current}).`;
       return ok(
-        u.update_available
-          ? `새 버전 v${u.latest} 사용 가능 (현재 v${u.current}). update_careermate로 업데이트할 수 있습니다.`
-          : `최신 버전입니다 (v${u.current}).`,
-        u,
+        user_message,
+        {
+          ...u,
+          user_message,
+          suggested_next_action: u.update_available
+            ? {
+                prompt: '지금 CareerMate를 업데이트할까요?',
+                next_tool: 'update_careermate',
+              }
+            : null,
+        },
       );
     },
   },
@@ -810,12 +1162,12 @@ export const TOOLS: ToolDef[] = [
     name: 'update_careermate',
     title: 'CareerMate 업데이트',
     description:
-      'CareerMate를 최신 버전으로 업데이트합니다(설치 폴더에 npm으로 careermate@latest 설치). 사용자가 명시적으로 "업데이트해줘"라고 할 때만 호출하세요. 성공하면 적용을 위해 AI 앱(또는 MCP 연결) 재시작이 필요하며, 재시작 시 데이터베이스는 자동 마이그레이션되어 기존 데이터가 보존됩니다. 자동 설치가 막히면(개발 모드·비표준 설치) 직접 칠 명령을 안내합니다.',
+      'CareerMate를 최신 버전으로 업데이트합니다(설치 폴더에 npm으로 careermate@latest 설치). 사용자가 명시적으로 "업데이트해줘", "CareerMate 업데이트해줘", "최신으로 올려줘"라고 할 때 호출하세요. 이 도구가 최신 버전 확인도 함께 하므로 별도 확인 질문 없이 실행해도 됩니다. 성공하면 적용을 위해 AI 앱(또는 MCP 연결) 재시작이 필요하며, 재시작 시 데이터베이스는 자동 마이그레이션되어 기존 데이터는 보존됩니다. 자동 설치가 막히면(개발 모드·비표준 설치) 직접 칠 명령을 안내합니다.',
     inputSchema: {},
     handler: async () => {
       const r = await runSelfUpdate();
       if (!r.ok) return fail(`${r.message}${r.manual ? `\n\n직접 실행: ${r.manual}` : ''}`);
-      return ok(r.message, r);
+      return ok(r.message, { ...r, user_message: r.message });
     },
   },
 ];