careermate 0.0.1 → 0.0.2

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

@@ -42,6 +42,8 @@ import {
   getExportsDir,
   getDataDir,
   getInboxDir,
+  getVerifyStrict,
+  setVerifyStrict,
 } from '@careermate/db';
 import {
   getOnboardingStatus,
@@ -58,6 +60,8 @@ import {
   saveInterviewPrep,
   listRecentActivity,
   jobWithMeta,
+  previewCoverLetter,
+  summarizeReport,
 } from '@careermate/core';
 import { HUMANIZE_WRITING_GUIDE } from '@careermate/prompts';
 import { getWorkflow, renderWorkflowMarkdown, WORKFLOWS } from '@careermate/workflows';
@@ -264,11 +268,19 @@ export const TOOLS: ToolDef[] = [
       const s = getOnboardingStatus();
       const lines = s.next_steps.map((t, i) => `${i + 1}. ${t}`).join('\n');
       const upd = getUpdateStatus();
+      const strict = getVerifyStrict();
       let text = `온보딩 ${s.completed ? '완료됨' : '진행 필요'} · 프로필 완성도 ${s.profile_completeness}%\n\n다음 단계:\n${lines}`;
+      // One-time guidance: CareerMate machine-checks that the numbers in a cover
+      // letter trace to the user's real data. Mention the optional strict mode.
+      if (!s.completed) {
+        text +=
+          `\n\n💡 참고: 자소서를 저장할 때 CareerMate가 본문의 수치를 저장된 경력·이력서와 자동 대조해, 근거 없는 수치는 막습니다. ` +
+          `더 깐깐하게 보길 원하면 "엄격하게 봐줘"라고 하거나 대시보드 설정에서 엄격 모드를 켤 수 있어요(이력서 본문에 없는 수치까지 차단).`;
+      }
       if (upd.update_available) {
         text += `\n\n🆕 새 버전 v${upd.latest} 사용 가능 (현재 v${upd.current}). 사용자가 원하면 update_careermate 도구로 업데이트하세요.`;
       }
-      return ok(text, { ...s, update: upd });
+      return ok(text, { ...s, verify_strict: strict, update: upd });
     },
   },
 
@@ -414,11 +426,26 @@ export const TOOLS: ToolDef[] = [
     name: 'save_cover_letter_version',
     title: '자기소개서 버전 저장',
     description:
-      '자기소개서의 새 버전을 저장합니다. CareerMate 자소서 작성 워크플로우의 핵심 저장 단계입니다. cover_letter_id를 주면 기존 자소서에 새 버전을 추가하고, 없으면 새 자소서를 만들어 v1로 저장합니다(이때 title 권장). note에 이 버전의 변경 요약(예: "지원동기 보강")을 남기면 사용자가 대시보드에서 버전 히스토리를 이해하기 쉽습니다. job_id로 공고에 연결하면 지원 항목과 자동 연결됩니다.',
+      '자기소개서의 새 버전을 저장합니다. CareerMate 자소서 작성 워크플로우의 핵심 저장 단계입니다. cover_letter_id를 주면 기존 자소서에 새 버전을 추가하고, 없으면 새 자소서를 만들어 v1로 저장합니다(이때 title 권장). note에 이 버전의 변경 요약(예: "지원동기 보강")을 남기면 사용자가 대시보드에서 버전 히스토리를 이해하기 쉽습니다. job_id로 공고에 연결하면 지원 항목과 자동 연결됩니다. 저장 직전 자동으로 "근거 없는 수치" 점검을 돌립니다 — 본문의 정량 수치가 저장된 경력·이력서·프로젝트에 근거가 없으면(환각 의심) 저장이 막힙니다. 그때는 원본의 실제 수치로 고치거나, 의도한 값이면 force:true로 다시 저장하세요.',
     inputSchema: CoverLetterVersionInputSchema.shape,
     handler: (args) => {
-      const { coverLetter, version } = saveCoverLetterVersion(args);
-      return ok(`'${coverLetter.title}' v${version.version_no}을 저장했습니다.`, { coverLetter, version });
+      try {
+        const { coverLetter, version, verification, forced } = saveCoverLetterVersion(args);
+        const advisory = summarizeReport(verification);
+        const head = `'${coverLetter.title}' v${version.version_no}을 저장했습니다.`;
+        const hasAdvisory =
+          verification.signals.length ||
+          verification.provenance.jobSourced.length ||
+          verification.provenance.unverified.length;
+        const note = forced
+          ? '\n⚠️ 근거 없는 수치가 있는데도 force로 저장했습니다(검증 미통과로 기록). 면접 전 사실 확인을 권합니다.'
+          : hasAdvisory
+            ? `\n점검: ${advisory}`
+            : '';
+        return ok(head + note, { coverLetter, version, verification });
+      } catch (e) {
+        return fail(e instanceof Error ? e.message : '저장 실패');
+      }
     },
   },
 
@@ -672,7 +699,9 @@ export const TOOLS: ToolDef[] = [
     handler: (args) => {
       try {
         const content = getPlaybook(args.domain as ExpertDomain);
-        return ok(content, { domain: args.domain, content });
+        // Content is already in the text block; don't duplicate it in the
+        // structured payload (it was being shipped ~2x → token bloat).
+        return ok(content, { domain: args.domain });
       } catch (e) {
         return fail(e instanceof Error ? e.message : '플레이북을 불러오지 못했습니다.');
       }
@@ -692,13 +721,58 @@ export const TOOLS: ToolDef[] = [
     handler: (args) => {
       try {
         const content = getVerifier(args.id as VerifierId);
-        return ok(content, { id: args.id, content });
+        return ok(content, { id: args.id });
       } catch (e) {
         return fail(e instanceof Error ? e.message : '검증 루브릭을 불러오지 못했습니다.');
       }
     },
   },
 
+  /* ----------------------------------------- career-os: deterministic lint */
+  {
+    name: 'validate_cover_letter',
+    title: '자기소개서 자동 점검 (저장 전 미리보기)',
+    description:
+      '자기소개서를 save_cover_letter_version으로 저장하기 직전에 호출하면, 저장하지 않고 미리 점검만 합니다. CareerMate가 LLM 없이 결정론으로 (1) 본문의 정량 수치가 저장된 경력·이력서·프로젝트에 근거가 있는지(없으면 환각 의심 → 저장 시 차단됨), (2) 공고에서 가져온 수치를 본인 성과처럼 쓰지 않았는지, (3) 번역투·제너릭 도입·빈 형용사·블라인드 위반 같은 문체 신호를 세어 돌려줍니다. 점검은 셀 수 있는 것만 봅니다 — 사실성·동문서답 같은 의미 판단은 당신(AI)이 직접 하세요. job_id를 주면 공고 수치까지 비교합니다.',
+    inputSchema: {
+      text: z.string().max(200_000).describe('점검할 자기소개서 본문'),
+      job_id: z.string().optional().describe('연결할 공고(있으면 공고 수치까지 비교)'),
+      strict: z
+        .boolean()
+        .optional()
+        .describe('이번 점검만 엄격하게(이력서 본문에 근거 없는 수치도 차단). 사용자가 "엄격하게 봐줘"라고 할 때 true. 생략하면 저장된 모드를 따름'),
+    },
+    readOnly: true,
+    handler: (args) => {
+      const text = typeof args?.text === 'string' ? args.text : '';
+      if (!text.trim()) return fail('점검할 본문이 비어 있습니다.');
+      const report = previewCoverLetter(text, args?.job_id ?? null, args?.strict);
+      const verdict = report.blocking.length
+        ? `⛔ 이대로 저장하면 막힙니다 — ${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);
+    },
+  },
+  {
+    name: 'set_verify_mode',
+    title: '점검 모드 설정 (기본/엄격)',
+    description:
+      '저장 전 자동 점검의 엄격도를 바꿉니다. 엄격 모드(strict=true)를 켜면, 이후 모든 자소서 저장에서 "이력서 본문에 근거 없는 수치"(구조화 경력 항목에만 있는 값)까지 차단합니다. 기본 모드는 출처가 아예 없는 수치만 차단합니다. 사용자가 "엄격하게 봐줘"라고 하면 바로 켜지 말고 "앞으로 항상 엄격하게 볼까요?"라고 먼저 확인한 뒤 동의하면 strict=true로 호출하세요. 끄기(strict=false)는 안전장치를 약하게 만드는 것이므로, 사용자가 명확히 끄겠다고 할 때만 호출하세요. 이번 한 건만 엄격하게 보려면 모드를 바꾸지 말고 validate_cover_letter / save_cover_letter_version에 strict:true를 한 번만 넘기세요.',
+    inputSchema: {
+      strict: z.boolean().describe('true=엄격 켜기, false=끄기(명확한 사용자 의사일 때만)'),
+    },
+    handler: (args) => {
+      const on = setVerifyStrict(!!args?.strict);
+      return ok(
+        on
+          ? '엄격 점검 모드를 켰습니다. 이제 자소서를 저장할 때, 올린 이력서 본문에 근거가 없는 수치는 막힙니다(구조화 경력 항목에만 있는 값 포함). 끄려면 "엄격 모드 꺼줘"라고 하세요.'
+          : '엄격 점검 모드를 껐습니다. 이제 출처가 아예 없는 수치만 차단합니다(구조화 항목에만 있는 값은 경고만).',
+        { strict: on },
+      );
+    },
+  },
+
   /* --------------------------------------------------- writing style guide */
   {
     name: 'get_writing_style_guide',

package/packages/shared/src/schemas.ts

@@ -244,6 +244,14 @@ export const CoverLetterVersionInputSchema = z.object({
   note: optNote.describe('이 버전의 변경 요약 (예: 지원동기 보강)'),
   source: z.enum(CONTENT_SOURCES).optional(),
   set_current: z.boolean().optional().describe('이 버전을 현재 버전으로 지정 (기본 true)'),
+  force: z
+    .boolean()
+    .optional()
+    .describe('저장 전 자동 점검(근거 없는 수치)에서 막혔을 때, 의도한 값임을 확인하고 그대로 저장'),
+  strict: z
+    .boolean()
+    .optional()
+    .describe('이번 저장만 엄격하게 점검(이력서 본문에 근거 없는 수치도 차단). 생략하면 저장된 모드 설정을 따름'),
 });
 export type CoverLetterVersionInput = z.infer<typeof CoverLetterVersionInputSchema>;