careermate 0.0.7 → 0.0.8

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

@@ -27,7 +27,7 @@ import {
   APPLICATION_STATUSES,
   APPLICATION_STATUS_LABELS,
   DOCUMENT_KINDS,
-  CONTENT_SOURCES,
+  INTERVIEW_UNLOCK_STATUSES,
 } from '@careermate/shared';
 import {
   profileRepo,
@@ -60,9 +60,15 @@ import {
   updateApplicationStatus,
   saveInterviewPrep,
   listRecentActivity,
+  getActionDigest,
+  getPipelineStats,
+  prescreenJob,
+  searchJobs,
+  JOB_SEARCH_SOURCES,
   jobWithMeta,
   previewCoverLetter,
   summarizeReport,
+  checkCharLimit,
 } from '@careermate/core';
 import { getWritingStyleGuide } from '@careermate/prompts';
 import { getWorkflow, renderWorkflowMarkdown, WORKFLOWS } from '@careermate/workflows';
@@ -79,10 +85,15 @@ import {
 import {
   coverLetterToMarkdown,
   coverLetterToHtml,
+  coverLetterToDocx,
   resumeToMarkdown,
   resumeToHtml,
+  resumeToDocx,
   profileToMarkdown,
   profileToHtml,
+  profileToDocx,
+  profileToJsonResume,
+  type ExportResult,
 } from '@careermate/exporters';
 import { extractDocument } from '@careermate/parsers';
 import { ok, fail, type ToolDef } from './result.ts';
@@ -146,9 +157,6 @@ async function mapWithLimit<T, R>(items: T[], limit: number, fn: (item: T, index
   return out;
 }
 
-/** 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.
@@ -162,11 +170,27 @@ function pickRoute(ctx: ReturnType<typeof getApplicationContext>): string | null
   const app = ctx.recent_applications.find(
     (a) => (a as { job_id?: string }).job_id === jobId,
   ) as { status?: string } | undefined;
-  if (app?.status && INTERVIEW_UNLOCKED.includes(app.status)) return 'prepare_interview';
+  if (app?.status && (INTERVIEW_UNLOCK_STATUSES as readonly string[]).includes(app.status)) return 'prepare_interview';
   if (!ctx.fit_analysis) return 'analyze_job';
   return 'write_cover_letter';
 }
 
+/**
+ * Write an export to the exports dir. Binary formats (`.docx`) carry their
+ * payload in `bytes`; text formats in `content`. Returns the absolute path or an
+ * error string so the caller can `fail()` with a human message.
+ */
+function writeExport(result: ExportResult): { path: string } | { error: string } {
+  const filePath = path.join(getExportsDir(), result.filename);
+  try {
+    if (result.bytes) fs.writeFileSync(filePath, result.bytes);
+    else fs.writeFileSync(filePath, result.content, 'utf8');
+    return { path: filePath };
+  } catch (e) {
+    return { error: `파일 저장 실패: ${e instanceof Error ? e.message : e}` };
+  }
+}
+
 export const TOOLS: ToolDef[] = [
   /* --------------------------------------------------------- read document */
   {
@@ -335,7 +359,7 @@ export const TOOLS: ToolDef[] = [
     name: 'save_profile',
     title: '프로필 저장',
     description:
-      '사용자 프로필을 저장합니다. 전달한 필드만 갱신되고 나머지는 유지됩니다(부분 저장 안전). 이력서를 구조화한 뒤 이름/한 줄 소개/희망 직무/선호 문체/강조 포인트 등을 채워 저장하세요. 선호 문체(preferred_tone)와 강조 포인트(emphasis_points)는 이후 자기소개서 작성 품질에 직접 영향을 줍니다.',
+      '사용자 프로필을 저장합니다. 전달한 필드만 갱신되고 나머지는 유지됩니다(부분 저장 안전). 이력서를 구조화한 뒤 이름/한 줄 소개/희망 직무/선호 문체/강조 포인트 등을 채워 저장하세요. 선호 문체(preferred_tone)와 강조 포인트(emphasis_points)는 이후 자기소개서 작성 품질에 직접 영향을 줍니다. 학력(education)·자격증(certifications)·어학점수(language_scores: 토익·오픽 등)·수상(awards)이 이력서에 있으면 구조화해 저장하세요 — 한국 이력서 핵심 스펙이고, 저장하면 이후 자소서·이력서에서 정확한 수치(학점 3.8, 토익 920)를 지어내지 않고 그대로 인용합니다.',
     inputSchema: ProfileInputSchema.shape,
     handler: (args) => {
       const p = saveProfile(args);
@@ -590,7 +614,7 @@ export const TOOLS: ToolDef[] = [
     name: 'save_job_posting',
     title: '채용공고 저장',
     description:
-      '채용공고를 저장합니다(있으면 갱신). company와 position은 필수입니다. 공고 원문은 description에, 핵심 자격요건/우대사항은 requirements 배열에, 핵심 키워드는 keywords에 정리해 넣으면 이후 적합도 분석/자소서 작성에 활용됩니다. 같은 url이면 중복 생성 없이 갱신됩니다. 저장 시 지원(application) 항목이 자동으로 생성됩니다.',
+      '채용공고를 저장합니다(있으면 갱신). company와 position은 필수입니다. 공고 원문은 description에, 핵심 자격요건/우대사항은 requirements 배열에, 핵심 키워드는 keywords에 정리해 넣으면 이후 적합도 분석/자소서 작성에 활용됩니다. 회사를 리서치했다면 사업개요·미션은 company_overview, 회사가 강조하는 인재상은 talent_profile, 핵심가치는 core_values에 넣으세요 — 한국 자소서·면접은 인재상/핵심가치 정렬이 핵심이라 저장해두면 이후 작성·면접 준비에서 그대로 끌어다 씁니다. 같은 url이면 중복 생성 없이 갱신됩니다. 저장 시 지원(application) 항목이 자동으로 생성됩니다.',
     inputSchema: JobInputSchema.shape,
     handler: (args) => {
       const { job } = saveJobPosting(args);
@@ -821,7 +845,8 @@ export const TOOLS: ToolDef[] = [
     description:
       '예상 면접 질문, 꼬리 질문, STAR 답변 가이드, 1분 자기소개 초안 등 해당 공고 기준 면접 준비 자료를 저장합니다. 공고/직무/자기소개서를 근거로 당신(AI)이 생성한 자료를 저장하는 데 사용합니다. ' +
       "질문은 두 갈래로 준비하세요 — 각 질문의 category를 'technical'(기술·직무 1차 면접) 또는 'behavioral'(인성·컬처핏·임원 2차 면접, 자기소개서·프로필 기반)로 지정합니다. 가능하면 두 갈래 모두 채워 한 번에 저장하세요(대시보드가 기술/인성·컬처핏 탭으로 나눠 보여줍니다). " +
-      'job_id는 필수입니다. 같은 공고에 다시 저장하면 갱신됩니다.',
+      '면접을 본 뒤에는 같은 도구에 debrief(받은 질문 asked_questions·잘된 점 went_well·개선점 to_improve·다음 라운드 포커스 next_round_focus·체감 분위기 sentiment)를 채워 저장하면 다음 라운드 준비와 일관성 점검에 그대로 이어집니다(면접 전 준비와 면접 후 디브리프가 한 공고에 함께 쌓입니다). ' +
+      'job_id는 필수입니다. 같은 공고에 다시 저장하면 갱신됩니다(debrief는 기존 값과 병합되어 기존 필드를 지우지 않습니다).',
     inputSchema: InterviewPrepInputSchema.shape,
     handler: (args) => {
       try {
@@ -844,27 +869,27 @@ export const TOOLS: ToolDef[] = [
     name: 'export_cover_letter',
     title: '자기소개서 내보내기',
     description:
-      '자기소개서를 Markdown 또는 인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로와 본문을 돌려줍니다. 사용자가 "자소서 파일로 받고 싶어"라고 할 때 사용하세요. 대시보드에서 직접 다운로드할 수도 있습니다.',
+      '자기소개서를 Word(.docx)·Markdown·인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로를 돌려줍니다. ATS 제출처럼 Word 파일이 필요하면 format=docx를 쓰세요. 사용자가 "자소서 파일로 받고 싶어"라고 할 때 사용하세요. 대시보드에서 직접 다운로드할 수도 있습니다.',
     inputSchema: {
       cover_letter_id: z.string(),
-      format: z.enum(['md', 'html']).optional().describe('기본 md'),
+      format: z.enum(['md', 'html', 'docx']).optional().describe('기본 md'),
     },
-    handler: (args) => {
+    handler: async (args) => {
       const cl = coverLetterRepo.get(args.cover_letter_id, true);
       if (!cl) return fail('자기소개서를 찾을 수 없습니다.');
       const job = cl.job_id ? jobRepo.get(cl.job_id) : null;
       const profile = profileRepo.get();
       const format = args.format ?? 'md';
-      const result = format === 'html' ? coverLetterToHtml(cl, { job, profile }) : coverLetterToMarkdown(cl, { job, 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(`'${cl.title}'를 ${format.toUpperCase()}로 내보냈습니다.\n저장 위치: ${filePath}`, {
-        path: filePath,
+      const result =
+        format === 'docx'
+          ? await coverLetterToDocx(cl, { job, profile })
+          : format === 'html'
+            ? coverLetterToHtml(cl, { job, profile })
+            : coverLetterToMarkdown(cl, { job, profile });
+      const written = writeExport(result);
+      if ('error' in written) return fail(written.error);
+      return ok(`'${cl.title}'를 ${format.toUpperCase()}로 내보냈습니다.\n저장 위치: ${written.path}`, {
+        path: written.path,
         filename: result.filename,
         content: result.content,
       });
@@ -874,26 +899,26 @@ export const TOOLS: ToolDef[] = [
     name: 'export_resume',
     title: '이력서/경력기술서 내보내기',
     description:
-      '저장된 이력서·경력기술서 등 문서를 Markdown 또는 인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로와 본문을 돌려줍니다. 사용자가 공고에 맞춰 정리한 이력서를 먼저 add_resume로 저장한 뒤, "이력서 파일로 받고 싶어"라고 할 때 사용하세요. document_id는 get_resumes로 확인할 수 있습니다. 대시보드에서 직접 다운로드할 수도 있습니다.',
+      '저장된 이력서·경력기술서 등 문서를 Word(.docx)·Markdown·인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로를 돌려줍니다. ATS 제출처럼 Word 파일이 필요하면 format=docx를 쓰세요. 사용자가 공고에 맞춰 정리한 이력서를 먼저 add_resume로 저장한 뒤, "이력서 파일로 받고 싶어"라고 할 때 사용하세요. document_id는 get_resumes로 확인할 수 있습니다. 대시보드에서 직접 다운로드할 수도 있습니다.',
     inputSchema: {
       document_id: z.string(),
-      format: z.enum(['md', 'html']).optional().describe('기본 md'),
+      format: z.enum(['md', 'html', 'docx']).optional().describe('기본 md'),
     },
-    handler: (args) => {
+    handler: async (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,
+      const result =
+        format === 'docx'
+          ? await resumeToDocx(doc, profile)
+          : format === 'html'
+            ? resumeToHtml(doc, profile)
+            : resumeToMarkdown(doc, profile);
+      const written = writeExport(result);
+      if ('error' in written) return fail(written.error);
+      return ok(`'${doc.title}'를 ${format.toUpperCase()}로 내보냈습니다.\n저장 위치: ${written.path}`, {
+        path: written.path,
         filename: result.filename,
         content: result.content,
       });
@@ -903,11 +928,11 @@ export const TOOLS: ToolDef[] = [
     name: 'export_profile',
     title: '프로필을 이력서로 내보내기',
     description:
-      '저장된 프로필·경력·프로젝트·보유 기술을 한 장의 이력서 형식으로 모아 Markdown 또는 인쇄용 HTML(브라우저에서 PDF로 저장) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로와 본문을 돌려줍니다. 사용자가 "내 프로필을 이력서로 뽑아줘"처럼 구조화된 데이터 전체를 이력서로 받고 싶을 때 사용하세요. 특정 공고 맞춤 이력서는 add_resume로 정리·저장한 뒤 export_resume를 쓰세요. 대시보드에서 직접 다운로드할 수도 있습니다.',
+      '저장된 프로필·경력·프로젝트·보유 기술을 한 장의 이력서 형식으로 모아 Word(.docx)·Markdown·인쇄용 HTML(브라우저에서 PDF로 저장)·JSON Resume(format=json, jsonresume.org 표준) 파일로 내보내 데이터 폴더의 exports에 저장하고, 파일 경로를 돌려줍니다. ATS 제출처럼 Word 파일이 필요하면 format=docx, 다른 이력서 도구·테마와 연동할 표준 데이터가 필요하면 format=json을 쓰세요. 사용자가 "내 프로필을 이력서로 뽑아줘"처럼 구조화된 데이터 전체를 이력서로 받고 싶을 때 사용하세요. 특정 공고 맞춤 이력서는 add_resume로 정리·저장한 뒤 export_resume를 쓰세요. 대시보드에서 직접 다운로드할 수도 있습니다.',
     inputSchema: {
-      format: z.enum(['md', 'html']).optional().describe('기본 md'),
+      format: z.enum(['md', 'html', 'docx', 'json']).optional().describe('기본 md. json = JSON Resume 표준'),
     },
-    handler: (args) => {
+    handler: async (args) => {
       const profile = profileRepo.get();
       if (!profile) return fail('프로필이 없습니다. 먼저 프로필을 저장하세요.');
       const format = args.format ?? 'md';
@@ -915,18 +940,17 @@ export const TOOLS: ToolDef[] = [
       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,
+        format === 'docx'
+          ? await profileToDocx(profile, experiences, projects, skills)
+          : format === 'html'
+            ? profileToHtml(profile, experiences, projects, skills)
+            : format === 'json'
+              ? profileToJsonResume(profile, experiences, projects, skills)
+              : profileToMarkdown(profile, experiences, projects, skills);
+      const written = writeExport(result);
+      if ('error' in written) return fail(written.error);
+      return ok(`프로필을 이력서(${format.toUpperCase()})로 내보냈습니다.\n저장 위치: ${written.path}`, {
+        path: written.path,
         filename: result.filename,
         content: result.content,
       });
@@ -975,6 +999,78 @@ export const TOOLS: ToolDef[] = [
       return ok(`최근 활동 ${acts.length}건`, acts);
     },
   },
+  {
+    name: 'get_followups',
+    title: '후속 조치 알림(놓친 지원·마감·면접준비)',
+    description:
+      '지금 챙겨야 할 것들을 한 번에 돌려줍니다: ① 응답 없이 오래된 지원(지원 후 무응답·서류합격 후 일정대기·면접 후 결과대기) ② 임박했거나 지난 지원 마감(지원 전 단계) ③ 합격했는데 아직 면접 준비가 없는 공고. 사용자가 "내 지원 현황 어때?", "뭐 챙겨야 해?", "후속 연락할 거 있어?"라고 묻거나, 세션을 이어가며 놓친 게 없는지 먼저 점검할 때 사용하세요. 읽기 전용입니다. 응답의 reason은 사용자 언어로 풀어 전하고, 후속 문의는 강요하지 말고 선택지로 제안하세요(채용 관행상 과한 독촉은 역효과).',
+    inputSchema: {},
+    readOnly: true,
+    handler: () => {
+      const d = getActionDigest();
+      const n = d.followups.length + d.deadlines.length + d.interview_todo.length;
+      const msg = n === 0
+        ? '지금 당장 챙길 후속 항목이 없습니다(무응답 지원·임박 마감·면접 준비 대기 없음).'
+        : `챙길 항목 ${n}건: 후속 ${d.followups.length} · 마감 ${d.deadlines.length} · 면접준비 ${d.interview_todo.length}`;
+      return ok(msg, d);
+    },
+  },
+  {
+    name: 'get_pipeline_stats',
+    title: '지원 파이프라인 분석(깔때기·합격률)',
+    description:
+      '전체 지원 현황을 분석해 돌려줍니다: 현재 상태 분포(by_status), 단계별 도달 깔때기(funnel: 지원→서류합격→면접→최종, 상태 변경 이력으로 복원한 실측치라 현재 불합격이어도 거쳐간 최고 단계까지 집계), 통과율(rates: 서류·면접·최종, 지원 대비 %), 결과 요약(outcomes). 사용자가 "내 합격률 어때?", "지원 통계 보여줘", "어느 단계에서 많이 떨어져?"라고 물을 때 사용하세요. 비율은 설명용이며 표본이 작으면 예측력이 낮다는 점을 함께 전하세요(note 참고). 읽기 전용입니다.',
+    inputSchema: {},
+    readOnly: true,
+    handler: () => {
+      const s = getPipelineStats();
+      if (s.total === 0) return ok('아직 지원 내역이 없어 분석할 통계가 없습니다.', s);
+      const r = s.rates;
+      const fmt = (v: number | null) => (v == null ? '—' : `${v}%`);
+      return ok(
+        `지원 ${s.total}건 · 깔때기 지원 ${s.funnel.applied}→서류 ${s.funnel.document_passed}→면접 ${s.funnel.interview}→최종 ${s.funnel.final_passed} · 통과율 서류 ${fmt(r.document_pass)}·면접 ${fmt(r.interview)}·최종 ${fmt(r.offer)} (표본 작으면 추세 참고로만)`,
+        s,
+      );
+    },
+  },
+  {
+    name: 'search_jobs',
+    title: '공고 검색·가져오기(키워드)',
+    description:
+      `키워드로 무인증 공개 채용 사이트(${JOB_SEARCH_SOURCES.join('·')})에서 채용 공고를 가져옵니다. 사용자가 "백엔드 신입 공고 찾아줘", "React 공고 가져와"처럼 공고를 찾아 달라고 할 때 사용하세요. 결과(회사·직무·링크·지역·경력·기술스택·마감)를 사용자에게 보기 좋게 보여 주고, **사용자가 관심 있다고 고른 것만** save_job_posting으로 저장하세요(전부 자동 저장하지 마세요). 저장한 공고는 이어서 get_application_context로 분석·자소서로 연결됩니다. ` +
+      `참고: 이 도구는 외부 공개 페이지에서 공고를 가져오기만 하며(보내는 것은 검색 키워드뿐, 사용자 데이터는 절대 전송하지 않음), 봇 차단 우회는 하지 않습니다. 사람인·잡코리아는 키 발급 또는 약관 제약으로 여기 포함되지 않습니다. 결과가 비어 있으면 키워드를 바꾸거나 사용자에게 공고 URL/본문을 받아 save_job_posting으로 저장하세요.`,
+    inputSchema: {
+      keyword: z.string().describe('검색어(직무·기술·키워드). 예: "백엔드", "React 신입"'),
+      sources: z.array(z.enum([...JOB_SEARCH_SOURCES] as [string, ...string[]])).optional().describe(`대상 사이트(생략 시 전체: ${JOB_SEARCH_SOURCES.join('·')})`),
+      limit: z.number().optional().describe('사이트별 최대 건수(기본 10, 최대 50)'),
+    },
+    readOnly: true,
+    handler: async (args) => {
+      const res = await searchJobs(args.keyword, { sources: args.sources, limit: args.limit });
+      const failed = res.providers.filter((p) => !p.ok);
+      const okCount = res.results.length;
+      const parts = [`'${res.query}' 검색 결과 ${okCount}건`];
+      if (failed.length) parts.push(`(일부 사이트 응답 실패: ${failed.map((f) => f.source).join(', ')})`);
+      if (okCount === 0) parts.push('— 키워드를 바꾸거나, 공고 URL/본문을 주시면 직접 저장해 드릴게요.');
+      return ok(parts.join(' '), res);
+    },
+  },
+  {
+    name: 'prescreen_job',
+    title: '공고 사전 프리스크린(키워드 겹침)',
+    description:
+      '저장된 공고의 핵심 키워드를 사용자의 보유 기술·프로젝트/경력 기술스택과 대조해 "이 공고를 깊게 볼 가치가 있는지"를 빠르게 가늠합니다. LLM 없이 셀 수 있는 키워드 겹침(matched/missing/coverage)만 돌려주는 값싼 사전 필터이며, **진짜 적합도 판단은 당신(AI)이 get_application_context로 맥락을 받아 직접 수행**합니다(이 도구는 그 대체가 아닙니다). 사용자가 공고를 여러 개 훑으며 우선순위를 정하거나 "이거 지원할 만해?"라고 물을 때, 본격 분석 전에 가볍게 호출하세요. coverage가 낮아도 키워드 미기재일 수 있으니 단정하지 말고, 표기되지 않은 역량은 사용자에게 확인하세요. 읽기 전용입니다.',
+    inputSchema: { job_id: z.string() },
+    readOnly: true,
+    handler: (args) => {
+      const r = prescreenJob(args.job_id);
+      if (!r) return fail('공고를 찾을 수 없습니다. 먼저 save_job_posting으로 저장하세요.');
+      if (r.coverage == null)
+        return ok('이 공고에 저장된 핵심 키워드가 없어 겹침을 셀 수 없습니다. save_job_posting의 keywords에 핵심 키워드를 정리해 넣으면 프리스크린이 가능합니다.', r);
+      const pct = Math.round(r.coverage * 100);
+      return ok(`키워드 겹침 ${pct}% — 보유 ${r.matched.length}/${r.job_keywords.length}개. 부족: ${r.missing.join(', ') || '없음'}. (셀 수 있는 겹침일 뿐, 실제 적합도는 직접 판단하세요.)`, r);
+    },
+  },
 
   /* ------------------------------------------------------- workflow guide */
   {
@@ -1041,7 +1137,7 @@ export const TOOLS: ToolDef[] = [
     name: 'get_verifier',
     title: '검증 루브릭 (저장 전 자가검증)',
     description:
-      '커리어 산출물(자소서·이력서·면접 답변·적합도 등)을 save_*로 저장하기 직전에 호출하세요. 해당 검증기의 점검 항목·합격 기준·세는 방법을 루브릭으로 돌려줍니다 — 실제 점검과 합격/불합격 판단은 당신(AI)이 직접 합니다(CareerMate는 내부 LLM이 없어 의미 판단을 대신하지 않습니다). 6개 검증기: truthfulness(사실/허위수치), consistency(산출물 간 모순), recency-staleness(신선도), responsiveness-on-target(질문에 답했는가), ats-compat(ATS 호환), human-voice(AI 티/사람 목소리).',
+      '커리어 산출물(자소서·이력서·면접 답변·적합도 등)을 save_*로 저장하기 직전에 호출하세요. 해당 검증기의 점검 항목·합격 기준·세는 방법을 루브릭으로 돌려줍니다 — 실제 점검과 합격/불합격 판단은 당신(AI)이 직접 합니다(CareerMate는 내부 LLM이 없어 의미 판단을 대신하지 않습니다). 7개 검증기: truthfulness(사실/허위수치), consistency(산출물 간 모순), recency-staleness(신선도), responsiveness-on-target(질문에 답했는가), ats-compat(ATS 호환), human-voice(AI 티/사람 목소리), ai-detection-risk(한국 AI-자소서 탐지 시장 — 진정성·면접 방어가능성·자기복제 점검, 탐지 우회 아님).',
     inputSchema: {
       id: z
         .enum([...VERIFIER_IDS] as [VerifierId, ...VerifierId[]])
@@ -1063,14 +1159,20 @@ export const TOOLS: ToolDef[] = [
     name: 'validate_cover_letter',
     title: '자기소개서 자동 점검 (저장 전 미리보기)',
     description:
-      '자기소개서를 save_cover_letter_version으로 저장하기 직전에 호출하면, 저장하지 않고 미리 점검만 합니다. CareerMate가 LLM 없이 결정론으로 (1) 본문의 정량 수치가 저장된 경력·이력서·프로젝트에 근거가 있는지(없으면 환각 의심 → 저장 시 차단됨), (2) 공고에서 가져온 수치를 본인 성과처럼 쓰지 않았는지, (3) 번역투·제너릭 도입·빈 형용사·블라인드 위반 같은 문체 신호를 세어 돌려줍니다. 점검은 셀 수 있는 것만 봅니다 — 사실성·동문서답 같은 의미 판단은 당신(AI)이 직접 하세요. job_id를 주면 공고 수치까지 비교합니다.',
+      '자기소개서를 save_cover_letter_version으로 저장하기 직전에 호출하면, 저장하지 않고 미리 점검만 합니다. CareerMate가 LLM 없이 결정론으로 (1) 본문의 정량 수치가 저장된 경력·이력서·프로젝트에 근거가 있는지(없으면 환각 의심 → 저장 시 차단됨), (2) 공고에서 가져온 수치를 본인 성과처럼 쓰지 않았는지, (3) 번역투·제너릭 도입·빈 형용사·블라인드 위반 같은 문체 신호를 세어 돌려줍니다. 또 (4) 글자수를 공백포함·공백제외·UTF-8 byte 세 기준으로 정확히 세고, min_chars/max_chars를 주면 상·하한 충족 여부까지 돌려줍니다(LLM은 글자수를 정확히 못 세므로 이 기능을 쓰세요). 점검은 셀 수 있는 것만 봅니다 — 사실성·동문서답 같은 의미 판단은 당신(AI)이 직접 하세요. 한국 문항형 자소서는 문항마다 글자수 한도가 다르니 각 문항 본문을 그 문항의 한도로 따로 점검하세요. job_id를 주면 공고 수치까지 비교합니다.',
     inputSchema: {
-      text: z.string().max(200_000).describe('점검할 자기소개서 본문'),
+      text: z.string().max(200_000).describe('점검할 자기소개서 본문(문항형이면 한 문항 본문)'),
       job_id: z.string().optional().describe('연결할 공고(있으면 공고 수치까지 비교)'),
       strict: z
         .boolean()
         .optional()
         .describe('이번 점검만 엄격하게(이력서 본문에 근거 없는 수치도 차단). 사용자가 "엄격하게 봐줘"라고 할 때 true. 생략하면 저장된 모드를 따름'),
+      min_chars: z.number().int().positive().optional().describe('글자수 하한(이 문항 기준). 미달이면 알려줍니다'),
+      max_chars: z.number().int().positive().optional().describe('글자수 상한(이 문항 기준). 초과면 알려줍니다'),
+      count_mode: z
+        .enum(['with_space', 'no_space', 'byte'])
+        .optional()
+        .describe('글자수 기준: with_space=공백포함(기본), no_space=공백제외, byte=UTF-8 바이트. 공고가 지정한 기준을 쓰고, 모르면 공백포함'),
     },
     readOnly: true,
     handler: (args) => {
@@ -1081,7 +1183,25 @@ export const TOOLS: ToolDef[] = [
         ? `⛔ 이대로 저장하면 막힙니다 — ${report.blocking.map((b) => `${b.label}: ${b.detail}`).join('; ')}`
         : '✅ 자동 차단 항목 없음(셀 수 있는 항목 기준).';
       const modeLine = report.strict ? '\n(엄격 모드 적용 중)' : '';
-      return ok(`${verdict}${modeLine}\n${summarizeReport(report)}\n\n${report.disclaimer}`, report);
+
+      // Deterministic char count (chatbots can't count reliably) + optional limit check.
+      const cc = report.charCounts;
+      let charLine = `\n글자수 — 공백포함 ${cc.withSpace}자 · 공백제외 ${cc.noSpace}자 · ${cc.byte}byte`;
+      const min = typeof args?.min_chars === 'number' ? args.min_chars : undefined;
+      const max = typeof args?.max_chars === 'number' ? args.max_chars : undefined;
+      let charLimit;
+      if (min !== undefined || max !== undefined) {
+        charLimit = checkCharLimit(text, { min, max, mode: args?.count_mode });
+        const mLabel = charLimit.mode === 'no_space' ? '공백제외' : charLimit.mode === 'byte' ? 'byte' : '공백포함';
+        const unit = charLimit.mode === 'byte' ? 'byte' : '자';
+        if (charLimit.status === 'over') charLine += `\n⚠️ 한도 초과(${mLabel} ${charLimit.count}${unit} / 상한 ${max}${unit}) — ${charLimit.delta}${unit} 줄이세요`;
+        else if (charLimit.status === 'under') charLine += `\n⚠️ 하한 미달(${mLabel} ${charLimit.count}${unit} / 하한 ${min}${unit}) — ${charLimit.delta}${unit} 더 쓰세요`;
+        else charLine += `\n✅ 글자수 한도 충족(${mLabel} ${charLimit.count}${unit})`;
+      }
+      return ok(`${verdict}${modeLine}\n${summarizeReport(report)}${charLine}\n\n${report.disclaimer}`, {
+        ...report,
+        charLimit,
+      });
     },
   },
   {

package/packages/shared/src/schemas.ts

@@ -114,6 +114,43 @@ export const LinkSchema = z.object({
 });
 export type Link = z.infer<typeof LinkSchema>;
 
+/* Structured quantitative credentials (한국 이력서 스펙). Values are kept verbatim as
+   strings so the AI cites them exactly (학점 3.8, TOEIC 920) without re-deriving. */
+export const EducationSchema = z.object({
+  school: reqLine.describe('학교명'),
+  degree: z.string().max(MAX_LINE).optional().describe('학위/과정 (고졸·학사·석사·박사 등)'),
+  major: z.string().max(MAX_LINE).optional().describe('전공'),
+  gpa: z.string().max(MAX_LINE).optional().describe('학점 (예: 3.8)'),
+  gpa_scale: z.string().max(MAX_LINE).optional().describe('학점 만점 (예: 4.5)'),
+  start_date: z.string().max(MAX_LINE).optional().describe('YYYY-MM'),
+  end_date: z.string().max(MAX_LINE).optional().describe('YYYY-MM (졸업/예정)'),
+  status: z.string().max(MAX_LINE).optional().describe('졸업/재학/휴학/중퇴/수료'),
+});
+export type Education = z.infer<typeof EducationSchema>;
+
+export const CertificationSchema = z.object({
+  name: reqLine.describe('자격증/면허명'),
+  issuer: z.string().max(MAX_LINE).optional().describe('발급기관'),
+  date: z.string().max(MAX_LINE).optional().describe('취득일 YYYY-MM'),
+  score: z.string().max(MAX_LINE).optional().describe('점수/등급(있으면)'),
+});
+export type Certification = z.infer<typeof CertificationSchema>;
+
+export const LanguageScoreSchema = z.object({
+  test: reqLine.describe('시험명 (TOEIC·OPIc·TOEIC Speaking·JLPT·HSK 등)'),
+  score: reqLine.describe('점수/등급 (예: 920, IH, N1)'),
+  date: z.string().max(MAX_LINE).optional().describe('응시/취득일 YYYY-MM'),
+});
+export type LanguageScore = z.infer<typeof LanguageScoreSchema>;
+
+export const AwardSchema = z.object({
+  title: reqLine.describe('수상/대외활동명'),
+  issuer: z.string().max(MAX_LINE).optional().describe('주최/수여기관'),
+  date: z.string().max(MAX_LINE).optional().describe('YYYY-MM'),
+  description: z.string().max(MAX_NOTE).optional().describe('간단 설명'),
+});
+export type Award = z.infer<typeof AwardSchema>;
+
 export const ProfileInputSchema = z.object({
   name: reqLine.optional(),
   email: optLine,
@@ -126,6 +163,10 @@ export const ProfileInputSchema = z.object({
   preferred_tone: z.string().max(MAX_LINE).optional().describe('자기소개서 선호 문체 (예: 담백하고 구체적)'),
   emphasis_points: strList.optional().describe('강조하고 싶은 핵심 포인트'),
   links: z.array(LinkSchema).max(MAX_ITEMS).optional().describe('포트폴리오/깃허브/링크드인 등'),
+  education: z.array(EducationSchema).max(MAX_ITEMS).optional().describe('학력 (학교·학위·전공·학점)'),
+  certifications: z.array(CertificationSchema).max(MAX_ITEMS).optional().describe('자격증/면허'),
+  language_scores: z.array(LanguageScoreSchema).max(MAX_ITEMS).optional().describe('어학 점수 (토익·오픽 등)'),
+  awards: z.array(AwardSchema).max(MAX_ITEMS).optional().describe('수상/대외활동'),
 });
 export type ProfileInput = z.infer<typeof ProfileInputSchema>;
 
@@ -142,6 +183,10 @@ export const ProfileRecordSchema = z.object({
   preferred_tone: z.string().nullable(),
   emphasis_points: z.array(z.string()),
   links: z.array(LinkSchema),
+  education: z.array(EducationSchema),
+  certifications: z.array(CertificationSchema),
+  language_scores: z.array(LanguageScoreSchema),
+  awards: z.array(AwardSchema),
 });
 export type ProfileRecord = z.infer<typeof ProfileRecordSchema>;
 
@@ -346,6 +391,9 @@ export const JobInputSchema = z.object({
   keywords: strList.optional().describe('핵심 키워드'),
   deadline: z.string().max(MAX_LINE).optional().describe('마감일 YYYY-MM-DD'),
   source: z.string().max(MAX_LINE).optional().describe('출처 (사람인/원티드/직접 입력 등)'),
+  company_overview: optBody.describe('회사 사업개요·미션·주요 제품·최근 활동 (AI가 리서치해 채움)'),
+  talent_profile: optBody.describe('회사가 강조하는 인재상 (한국 자소서·면접에서 정렬 기준)'),
+  core_values: strList.optional().describe('회사 핵심가치 (키워드 배열)'),
 });
 export type JobInput = z.infer<typeof JobInputSchema>;
 
@@ -361,6 +409,9 @@ export const JobRecordSchema = z.object({
   keywords: z.array(z.string()),
   deadline: z.string().nullable(),
   source: z.string().nullable(),
+  company_overview: z.string().nullable(),
+  talent_profile: z.string().nullable(),
+  core_values: z.array(z.string()),
 });
 export type JobRecord = z.infer<typeof JobRecordSchema>;
 
@@ -459,12 +510,24 @@ export const InterviewQuestionSchema = z.object({
 });
 export type InterviewQuestion = z.infer<typeof InterviewQuestionSchema>;
 
+/** Post-interview debrief — captured AFTER the interview to close the loop and feed the next round. */
+export const InterviewDebriefSchema = z.object({
+  asked_questions: strList.optional().describe('실제로 받은 질문들'),
+  went_well: optBody.describe('잘된 점/강했던 답변'),
+  to_improve: optBody.describe('아쉬운 점/다음에 개선할 점'),
+  next_round_focus: optBody.describe('다음 라운드/면접에 대비해 준비할 포인트'),
+  sentiment: z.enum(['positive', 'neutral', 'negative']).optional().describe('체감 분위기'),
+  interviewed_at: optLine.describe('면접 본 날짜(YYYY-MM-DD)'),
+});
+export type InterviewDebrief = z.infer<typeof InterviewDebriefSchema>;
+
 export const InterviewPrepInputSchema = z.object({
   job_id: reqLine,
   questions: z.array(InterviewQuestionSchema).max(MAX_ITEMS).optional(),
   star_guides: z.array(StarGuideSchema).max(MAX_ITEMS).optional(),
   self_introduction: optBody.describe('1분 자기소개 초안'),
   notes: optNote.describe('면접 후기/메모'),
+  debrief: InterviewDebriefSchema.optional().describe('면접 후 디브리프(받은 질문·잘된 점·개선점·다음 라운드 포커스)'),
 });
 export type InterviewPrepInput = z.infer<typeof InterviewPrepInputSchema>;
 
@@ -475,6 +538,7 @@ export const InterviewPrepRecordSchema = z.object({
   star_guides: z.array(StarGuideSchema),
   self_introduction: z.string().nullable(),
   notes: z.string().nullable(),
+  debrief: InterviewDebriefSchema.nullable(),
 });
 export type InterviewPrepRecord = z.infer<typeof InterviewPrepRecordSchema>;
 

package/scripts/init.ts

@@ -394,6 +394,11 @@ const SAFE_TOOLS: readonly string[] = [
   'get_application_context', 'save_fit_analysis', 'update_application_status', 'save_interview_prep',
   'export_cover_letter', 'export_resume', 'export_profile', 'list_recent_activity', 'get_workflow_guide', 'get_playbook', 'get_verifier',
   'validate_cover_letter', 'set_verify_mode', 'get_writing_style_guide', 'check_for_update',
+  // 읽기전용 조회 도구(DB 변경·외부 전송 없음) → 사전허용 안전.
+  'get_followups', 'get_pipeline_stats', 'prescreen_job',
+  // search_jobs: 공개 잡보드에서 공고를 가져오기만(보내는 건 검색어뿐, 사용자 데이터 미전송).
+  // check_for_update와 같은 "네트워크 read" 부류라 사전허용 안전(우회·쓰기 없음).
+  'search_jobs',
   // careermate 자신의 인박스 폴더·대시보드(127.0.0.1)만 여는 로컬 동작 + 인박스 내부 문서 읽기 → 사전허용 안전.
   'read_inbox', 'open_inbox', 'open_dashboard', 'open_application',
 ];