careermate 0.0.7 → 0.0.8

package/packages/exporters/src/index.ts

@@ -28,6 +28,7 @@ import {
   slugify,
 } from './markdown.ts';
 import { escapeHtml, toPrintableHtml } from './html.ts';
+import { markdownToDocx, DOCX_MIME } from './docx.ts';
 
 /** The uniform shape every exporter returns. */
 export interface ExportResult {
@@ -35,8 +36,16 @@ export interface ExportResult {
   filename: string;
   /** MIME type, e.g. `text/markdown` or `text/html`. */
   mimeType: string;
-  /** The document body. */
+  /**
+   * The document body as text. For binary formats (`.docx`) this is a short,
+   * human-readable note instead of the payload — write/stream {@link bytes}.
+   */
   content: string;
+  /**
+   * Present only for binary formats (e.g. `.docx`). When set, callers MUST
+   * write/stream these bytes rather than {@link content}.
+   */
+  bytes?: Uint8Array;
 }
 
 export type ExportOptions = {
@@ -47,6 +56,23 @@ export type ExportOptions = {
 const MD_MIME = 'text/markdown';
 const HTML_MIME = 'text/html';
 
+/** Stand-in `content` for binary exports — the real payload rides in `bytes`. */
+function docxNote(filename: string): string {
+  return `(Word 문서로 저장됨: ${filename})`;
+}
+
+/**
+ * Compose an export filename from slugged parts joined by `_`, then the
+ * extension — e.g. `["토스 백엔드 자기소개서", "홍길동"]` → `토스_백엔드_자기소개서_홍길동.docx`.
+ * Empty parts (no title, no owner name) drop out; if nothing survives, `fallback`
+ * is used. The owner's name as the trailing part makes files self-identifying in
+ * a downloads folder.
+ */
+function exportName(parts: (string | null | undefined)[], ext: string, fallback: string): string {
+  const slug = parts.map((p) => slugify(p, '')).filter(Boolean).join('_') || fallback;
+  return `${slug}.${ext}`;
+}
+
 /* ------------------------------------------------------------- cover letters */
 
 /** Build the shared markdown body for a cover letter (used by MD + HTML). */
@@ -74,7 +100,7 @@ export function coverLetterToMarkdown(
   opts?: ExportOptions,
 ): ExportResult {
   return {
-    filename: `${slugify(cl.title, 'cover-letter')}.md`,
+    filename: exportName([cl.title, opts?.profile?.name], 'md', 'cover_letter'),
     mimeType: MD_MIME,
     content: coverLetterBody(cl, opts),
   };
@@ -86,12 +112,22 @@ export function coverLetterToHtml(
   opts?: ExportOptions,
 ): ExportResult {
   return {
-    filename: `${slugify(cl.title, 'cover-letter')}.html`,
+    filename: exportName([cl.title, opts?.profile?.name], 'html', 'cover_letter'),
     mimeType: HTML_MIME,
     content: toPrintableHtml(cl.title, coverLetterBody(cl, opts)),
   };
 }
 
+/** Cover letter → Word (.docx), ATS-friendly single column. */
+export async function coverLetterToDocx(
+  cl: CoverLetterRecord,
+  opts?: ExportOptions,
+): Promise<ExportResult> {
+  const filename = exportName([cl.title, opts?.profile?.name], 'docx', 'cover_letter');
+  const bytes = await markdownToDocx(cl.title, coverLetterBody(cl, opts));
+  return { filename, mimeType: DOCX_MIME, content: docxNote(filename), bytes };
+}
+
 /* -------------------------------------------------------------------- resume */
 
 /** A stored resume/career document → Markdown. */
@@ -115,7 +151,7 @@ export function resumeToMarkdown(
   ]);
 
   return {
-    filename: `${slugify(doc.title, doc.kind)}.md`,
+    filename: exportName([doc.title, profile?.name], 'md', doc.kind),
     mimeType: MD_MIME,
     content: body,
   };
@@ -128,12 +164,23 @@ export function resumeToHtml(
 ): ExportResult {
   const md = resumeToMarkdown(doc, profile);
   return {
-    filename: `${slugify(doc.title, doc.kind)}.html`,
+    filename: exportName([doc.title, profile?.name], 'html', doc.kind),
     mimeType: HTML_MIME,
     content: toPrintableHtml(doc.title, md.content),
   };
 }
 
+/** A stored resume/career document → Word (.docx). */
+export async function resumeToDocx(
+  doc: DocumentRecord,
+  profile?: ProfileRecord | null,
+): Promise<ExportResult> {
+  const md = resumeToMarkdown(doc, profile);
+  const filename = exportName([doc.title, profile?.name], 'docx', doc.kind);
+  const bytes = await markdownToDocx(doc.title, md.content);
+  return { filename, mimeType: DOCX_MIME, content: docxNote(filename), bytes };
+}
+
 /* ------------------------------------------------------------------- profile */
 
 /** Full resume-style profile export → Markdown. */
@@ -243,7 +290,7 @@ export function profileToMarkdown(
   ]);
 
   return {
-    filename: `${slugify(name, 'resume')}-resume.md`,
+    filename: exportName(['프로필', profile.name], 'md', 'resume'),
     mimeType: MD_MIME,
     content,
   };
@@ -259,12 +306,97 @@ export function profileToHtml(
   const md = profileToMarkdown(profile, experiences, projects, skills);
   const title = profile.name?.trim() || '이력서';
   return {
-    filename: `${slugify(title, 'resume')}-resume.html`,
+    filename: exportName(['프로필', profile.name], 'html', 'resume'),
     mimeType: HTML_MIME,
     content: toPrintableHtml(title, md.content),
   };
 }
 
+/** Full resume-style profile export → Word (.docx). */
+export async function profileToDocx(
+  profile: ProfileRecord,
+  experiences: ExperienceRecord[] = [],
+  projects: ProjectRecord[] = [],
+  skills: SkillRecord[] = [],
+): Promise<ExportResult> {
+  const md = profileToMarkdown(profile, experiences, projects, skills);
+  const title = profile.name?.trim() || '이력서';
+  const filename = exportName(['프로필', profile.name], 'docx', 'resume');
+  const bytes = await markdownToDocx(title, md.content);
+  return { filename, mimeType: DOCX_MIME, content: docxNote(filename), bytes };
+}
+
+/**
+ * Full profile → JSON Resume (jsonresume.org, schema v1.0.0). Makes CareerMate
+ * data portable: the open standard is consumed by 100+ themes (HTML/PDF render)
+ * and other AI/ATS tools. Dates pass through as stored (YYYY-MM[-DD]); only
+ * populated fields are emitted to keep the document clean.
+ */
+export function profileToJsonResume(
+  profile: ProfileRecord,
+  experiences: ExperienceRecord[] = [],
+  projects: ProjectRecord[] = [],
+  skills: SkillRecord[] = [],
+): ExportResult {
+  const clean = <T extends Record<string, unknown>>(o: T): T =>
+    Object.fromEntries(
+      Object.entries(o).filter(([, v]) => v != null && !(Array.isArray(v) && v.length === 0) && v !== ''),
+    ) as T;
+
+  const basics = clean({
+    name: profile.name ?? '',
+    label: profile.headline ?? '',
+    email: profile.email ?? '',
+    phone: profile.phone ?? '',
+    summary: profile.summary ?? '',
+    location: profile.location ? { address: profile.location } : undefined,
+    profiles: (profile.links ?? [])
+      .filter((l) => l.url)
+      .map((l) => clean({ network: l.label ?? '', url: l.url })),
+  });
+
+  const work = experiences.map((e) =>
+    clean({
+      name: e.company ?? '',
+      position: e.role ?? '',
+      startDate: e.start_date ?? '',
+      endDate: e.is_current ? '' : (e.end_date ?? ''),
+      summary: e.description ?? '',
+      highlights: e.achievements ?? [],
+    }),
+  );
+
+  const projectsOut = projects.map((p) =>
+    clean({
+      name: p.name ?? '',
+      description: p.description ?? '',
+      highlights: p.highlights ?? [],
+      keywords: p.tech ?? [],
+      url: p.url ?? '',
+      startDate: p.start_date ?? '',
+      endDate: p.end_date ?? '',
+      roles: p.role ? [p.role] : [],
+    }),
+  );
+
+  const skillsOut = skills.map((s) => clean({ name: s.name, level: s.level ?? '' }));
+
+  const resume = {
+    $schema: 'https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json',
+    basics,
+    work,
+    projects: projectsOut,
+    skills: skillsOut,
+    meta: { canonical: 'https://jsonresume.org', version: 'v1.0.0', generatedBy: 'CareerMate' },
+  };
+
+  return {
+    filename: exportName(['프로필', profile.name], 'json', 'resume'),
+    mimeType: 'application/json',
+    content: JSON.stringify(resume, null, 2),
+  };
+}
+
 /* ------------------------------------------------------------ interview prep */
 
 /** Interview prep record → Markdown study sheet. */
@@ -343,7 +475,7 @@ export function interviewPrepToMarkdown(
   ]);
 
   return {
-    filename: `${slugify(titleBase, 'interview-prep')}.md`,
+    filename: exportName([titleBase], 'md', 'interview_prep'),
     mimeType: MD_MIME,
     content,
   };
@@ -357,7 +489,7 @@ export function interviewPrepToHtml(
   const md = interviewPrepToMarkdown(prep, job);
   const title = job ? `${job.company} ${job.position} 면접 준비` : '면접 준비';
   return {
-    filename: `${slugify(title, 'interview-prep')}.html`,
+    filename: exportName([title], 'html', 'interview_prep'),
     mimeType: HTML_MIME,
     content: toPrintableHtml(title, md.content),
   };
@@ -373,3 +505,4 @@ export {
   markdownToHtml,
   slugify,
 } from './markdown.ts';
+export { DOCX_MIME } from './docx.ts';

package/packages/exporters/src/markdown.ts

@@ -11,19 +11,24 @@ import { escapeHtml } from './html.ts';
 /* ----------------------------------------------------------- slug / filenames */
 
 /**
- * Make a filesystem-safe, ASCII-leaning slug from arbitrary (often Korean) text.
- * Non-ASCII runs collapse to `-`; the result is lowercased and trimmed of
- * leading/trailing separators. Falls back to `document` when nothing survives.
+ * Make a filesystem-safe slug from arbitrary text, PRESERVING the original
+ * script (Hangul, CJK, Latin, digits) so a Korean title like "백엔드 자기소개서"
+ * yields "백엔드_자기소개서" instead of a generic fallback. Spaces and any
+ * characters that aren't Unicode letters/numbers (punctuation, path separators)
+ * collapse to `_`; the result is trimmed and capped to a sane filename length.
+ * Falls back to `fallback` when nothing survives (e.g. emoji-only titles); pass
+ * `''` to opt out of the fallback when composing a multi-part name.
+ * Unicode filenames are safe on modern OSes, and the download header
+ * (`http.ts` `sendDownload`) already allows Hangul and encodes UTF-8.
  */
 export function slugify(input: string | null | undefined, fallback = 'document'): string {
-  const raw = (input ?? '').normalize('NFKD');
-  // Keep ASCII alphanumerics; everything else becomes a separator.
-  const slug = raw
-    .replace(/[^\x00-\x7F]+/g, '-') // drop non-ASCII (e.g. Hangul) -> separator
-    .replace(/[^a-zA-Z0-9]+/g, '-') // remaining punctuation/space -> separator
-    .replace(/-+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    .toLowerCase();
+  const slug = (input ?? '')
+    .normalize('NFC')
+    .replace(/[^\p{L}\p{N}]+/gu, '_') // non letter/number (space, punctuation, /\:*?…) -> separator
+    .replace(/_+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .slice(0, 80)
+    .replace(/_+$/g, ''); // re-trim a separator left dangling by the length cap
   return slug || fallback;
 }
 

package/packages/knowledge/src/index.ts

@@ -47,7 +47,9 @@ export const EXPERT_DOMAINS = [
 ] as const;
 export type ExpertDomain = (typeof EXPERT_DOMAINS)[number];
 
-/** 6 verifier rubrics — 1:1 with docs/career-os/knowledge/verifiers/<id>.md (CONTRACT C3). */
+/** 7 verifier rubrics — 1:1 with docs/career-os/knowledge/verifiers/<id>.md (CONTRACT C3).
+ *  ai-detection-risk: additive (한국 AI-자소서 탐지 시장 전용 — 진정성·면접 방어가능성 점검,
+ *  탐지기 우회가 아님). human-voice(문체 "AI 티")와 역할이 다르다. */
 export const VERIFIER_IDS = [
   'truthfulness',
   'consistency',
@@ -55,6 +57,7 @@ export const VERIFIER_IDS = [
   'responsiveness-on-target',
   'ats-compat',
   'human-voice',
+  'ai-detection-risk',
 ] as const;
 export type VerifierId = (typeof VERIFIER_IDS)[number];
 
@@ -121,13 +124,15 @@ export const CAREER_ROUTES: Record<string, CareerRoute> = {
   write_cover_letter: {
     eop: 'cover-letter',
     expertSequence: ['cover-letter', 'human-writing', 'company-research'],
-    verifierSequence: ['human-voice', 'truthfulness', 'responsiveness-on-target', 'ats-compat', 'consistency'],
+    // ai-detection-risk: 한국 자소서는 AI 탐지(무하유 GPT킬러 등)가 제도화돼 있어, 저장 전
+    // "진정성·면접 방어가능성·자기복제 여부"를 점검한다(탐지 우회가 아님 — 짝은 human-voice).
+    verifierSequence: ['human-voice', 'truthfulness', 'responsiveness-on-target', 'ats-compat', 'consistency', 'ai-detection-risk'],
     loop: 'draft_verify_revise',
   },
   write_career_description: {
     eop: 'career-description',
     expertSequence: ['resume', 'ats'],
-    verifierSequence: ['truthfulness', 'consistency', 'ats-compat'],
+    verifierSequence: ['truthfulness', 'consistency', 'ats-compat', 'ai-detection-risk'],
     loop: 'draft_verify_revise',
   },
   prepare_interview: {