careermate 0.1.0

package/packages/db/src/runtime.ts

@@ -0,0 +1,58 @@
+/**
+ * Runtime handshake between the two local processes.
+ *
+ * The web server and the MCP server run independently (the MCP server is
+ * launched by the AI client). They find each other through a small JSON file in
+ * the data dir: the web server writes its live URL/port/pid on boot; the MCP
+ * server reads it so tools like `open_dashboard` can point the browser at the
+ * right place — without any network discovery.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDataDir } from './paths.ts';
+
+export interface RuntimeInfo {
+  url: string;
+  port: number;
+  pid: number;
+  started_at: string;
+}
+
+function runtimeFile(): string {
+  return path.join(getDataDir(), 'server.json');
+}
+
+export function writeRuntimeInfo(info: RuntimeInfo): void {
+  try {
+    fs.writeFileSync(runtimeFile(), JSON.stringify(info, null, 2), 'utf8');
+  } catch {
+    /* non-fatal */
+  }
+}
+
+export function readRuntimeInfo(): RuntimeInfo | null {
+  try {
+    const raw = fs.readFileSync(runtimeFile(), 'utf8');
+    return JSON.parse(raw) as RuntimeInfo;
+  } catch {
+    return null;
+  }
+}
+
+/** True if a process with this pid is currently alive. */
+export function isProcessAlive(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return (e as NodeJS.ErrnoException).code === 'EPERM';
+  }
+}
+
+export function clearRuntimeInfo(): void {
+  try {
+    fs.unlinkSync(runtimeFile());
+  } catch {
+    /* ignore */
+  }
+}

package/packages/db/src/schema.ts

@@ -0,0 +1,189 @@
+/**
+ * SQLite schema + lightweight migration runner.
+ *
+ * Migrations are an ordered list of SQL strings. The current version is tracked
+ * in `_meta`. Applying is idempotent and safe to run on every process start, so
+ * both the web server and the MCP server can call `migrate()` on boot and share
+ * the same database file without coordination.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+
+export const MIGRATIONS: string[] = [
+  // v1 — initial schema
+  `
+  CREATE TABLE IF NOT EXISTS profile (
+    id TEXT PRIMARY KEY,
+    name TEXT, email TEXT, phone TEXT, location TEXT,
+    headline TEXT, summary TEXT,
+    desired_roles TEXT NOT NULL DEFAULT '[]',
+    desired_conditions TEXT,
+    preferred_tone TEXT,
+    emphasis_points TEXT NOT NULL DEFAULT '[]',
+    links TEXT NOT NULL DEFAULT '[]',
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS experiences (
+    id TEXT PRIMARY KEY,
+    company TEXT NOT NULL,
+    role TEXT,
+    employment_type TEXT,
+    start_date TEXT,
+    end_date TEXT,
+    is_current INTEGER NOT NULL DEFAULT 0,
+    description TEXT,
+    achievements TEXT NOT NULL DEFAULT '[]',
+    tech TEXT NOT NULL DEFAULT '[]',
+    order_index INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS projects (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    role TEXT,
+    description TEXT,
+    highlights TEXT NOT NULL DEFAULT '[]',
+    tech TEXT NOT NULL DEFAULT '[]',
+    url TEXT,
+    start_date TEXT,
+    end_date TEXT,
+    order_index INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS skills (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    category TEXT,
+    level TEXT,
+    years REAL,
+    order_index INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS documents (
+    id TEXT PRIMARY KEY,
+    kind TEXT NOT NULL,
+    title TEXT NOT NULL,
+    content TEXT NOT NULL DEFAULT '',
+    source TEXT NOT NULL DEFAULT 'manual',
+    is_primary INTEGER NOT NULL DEFAULT 0,
+    tags TEXT NOT NULL DEFAULT '[]',
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS cover_letters (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    job_id TEXT,
+    is_primary INTEGER NOT NULL DEFAULT 0,
+    current_version_id TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS cover_letter_versions (
+    id TEXT PRIMARY KEY,
+    cover_letter_id TEXT NOT NULL,
+    version_no INTEGER NOT NULL,
+    content TEXT NOT NULL,
+    note TEXT,
+    source TEXT NOT NULL DEFAULT 'ai',
+    created_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS jobs (
+    id TEXT PRIMARY KEY,
+    company TEXT NOT NULL,
+    position TEXT NOT NULL,
+    url TEXT,
+    location TEXT,
+    employment_type TEXT,
+    description TEXT,
+    requirements TEXT NOT NULL DEFAULT '[]',
+    keywords TEXT NOT NULL DEFAULT '[]',
+    deadline TEXT,
+    source TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS fit_analyses (
+    id TEXT PRIMARY KEY,
+    job_id TEXT NOT NULL,
+    score REAL,
+    summary TEXT,
+    strengths TEXT NOT NULL DEFAULT '[]',
+    gaps TEXT NOT NULL DEFAULT '[]',
+    matched_keywords TEXT NOT NULL DEFAULT '[]',
+    missing_keywords TEXT NOT NULL DEFAULT '[]',
+    recommendations TEXT NOT NULL DEFAULT '[]',
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS applications (
+    id TEXT PRIMARY KEY,
+    job_id TEXT NOT NULL UNIQUE,
+    status TEXT NOT NULL DEFAULT 'draft',
+    resume_id TEXT,
+    cover_letter_id TEXT,
+    applied_at TEXT,
+    notes TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS interview_preps (
+    id TEXT PRIMARY KEY,
+    job_id TEXT NOT NULL UNIQUE,
+    questions TEXT NOT NULL DEFAULT '[]',
+    star_guides TEXT NOT NULL DEFAULT '[]',
+    self_introduction TEXT,
+    notes TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS activities (
+    id TEXT PRIMARY KEY,
+    type TEXT NOT NULL,
+    entity_type TEXT,
+    entity_id TEXT,
+    summary TEXT NOT NULL,
+    created_at TEXT NOT NULL
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_fit_job ON fit_analyses(job_id);
+  CREATE INDEX IF NOT EXISTS idx_clv_letter ON cover_letter_versions(cover_letter_id);
+  CREATE INDEX IF NOT EXISTS idx_cl_job ON cover_letters(job_id);
+  CREATE INDEX IF NOT EXISTS idx_activities_created ON activities(created_at DESC);
+  `,
+];
+
+export function migrate(db: DatabaseSync): { from: number; to: number } {
+  db.exec(`CREATE TABLE IF NOT EXISTS _meta (key TEXT PRIMARY KEY, value TEXT NOT NULL);`);
+  const row = db.prepare(`SELECT value FROM _meta WHERE key = 'schema_version'`).get() as
+    | { value: string }
+    | undefined;
+  const from = row ? Number(row.value) : 0;
+
+  for (let v = from; v < MIGRATIONS.length; v++) {
+    db.exec(MIGRATIONS[v]!);
+  }
+
+  const to = MIGRATIONS.length;
+  if (to !== from) {
+    db.prepare(
+      `INSERT INTO _meta (key, value) VALUES ('schema_version', ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
+    ).run(String(to));
+  }
+  return { from, to };
+}

package/packages/exporters/src/html.ts

@@ -0,0 +1,113 @@
+/**
+ * @careermate/exporters — HTML helpers.
+ *
+ * `escapeHtml` and `toPrintableHtml` produce a clean, standalone, A4
+ * print-optimized HTML document. The print CSS is what powers our "PDF" export:
+ * the user opens the HTML in a browser and chooses "Print → Save as PDF", so we
+ * never ship a binary PDF library.
+ */
+import { markdownToHtml } from './markdown.ts';
+
+/** Escape the five HTML-significant characters. */
+export function escapeHtml(input: string | null | undefined): string {
+  return (input ?? '')
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+}
+
+/** Heuristic: does this string already look like an HTML fragment? */
+function looksLikeHtml(s: string): boolean {
+  return /<\/?(p|h[1-6]|ul|ol|li|div|section|article|br|hr|strong|em|a|table)\b/i.test(s);
+}
+
+/**
+ * Wrap a body (markdown OR ready HTML) in a complete, print-optimized HTML
+ * document. If `body` already looks like HTML it is used verbatim; otherwise it
+ * is rendered through the tiny markdown renderer.
+ */
+export function toPrintableHtml(title: string, bodyMarkdownOrHtml: string): string {
+  const body = looksLikeHtml(bodyMarkdownOrHtml)
+    ? bodyMarkdownOrHtml
+    : markdownToHtml(bodyMarkdownOrHtml);
+  const safeTitle = escapeHtml(title);
+
+  return `<!doctype html>
+<html lang="ko">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${safeTitle}</title>
+<style>
+  :root {
+    --ink: #1a1a1a;
+    --muted: #555;
+    --line: #d8d8d8;
+    --accent: #2b4a6f;
+    --maxw: 800px;
+  }
+  * { box-sizing: border-box; }
+  html, body {
+    margin: 0;
+    padding: 0;
+    color: var(--ink);
+    background: #f4f4f5;
+    font-family: "Pretendard", "Apple SD Gothic Neo", "Malgun Gothic",
+      -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    font-size: 14px;
+    line-height: 1.7;
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+  }
+  .page {
+    max-width: var(--maxw);
+    margin: 24px auto;
+    padding: 48px 56px;
+    background: #fff;
+    box-shadow: 0 1px 8px rgba(0, 0, 0, 0.08);
+  }
+  h1, h2, h3, h4, h5, h6 {
+    color: var(--accent);
+    line-height: 1.3;
+    margin: 1.4em 0 0.5em;
+    font-weight: 700;
+  }
+  h1 { font-size: 1.9em; margin-top: 0; border-bottom: 2px solid var(--accent); padding-bottom: 0.25em; }
+  h2 { font-size: 1.4em; border-bottom: 1px solid var(--line); padding-bottom: 0.2em; }
+  h3 { font-size: 1.15em; }
+  h4, h5, h6 { font-size: 1em; }
+  p { margin: 0.6em 0; }
+  ul, ol { margin: 0.5em 0 0.8em; padding-left: 1.4em; }
+  li { margin: 0.2em 0; }
+  a { color: var(--accent); text-decoration: none; }
+  a:hover { text-decoration: underline; }
+  strong { font-weight: 700; }
+  hr { border: none; border-top: 1px solid var(--line); margin: 1.5em 0; }
+  @page {
+    size: A4;
+    margin: 18mm 16mm;
+  }
+  @media print {
+    html, body { background: #fff; font-size: 12px; }
+    .page {
+      max-width: none;
+      margin: 0;
+      padding: 0;
+      box-shadow: none;
+    }
+    h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
+    ul, ol, p { page-break-inside: avoid; }
+    a { color: var(--ink); }
+  }
+</style>
+</head>
+<body>
+<main class="page">
+${body}
+</main>
+</body>
+</html>
+`;
+}