@takuhon/cli 0.12.0 → 0.14.0

package/dist/index.js

@@ -2,10 +2,10 @@
 import {
   ADMIN_DIST_DIRNAME,
   resolveAdminBundleDir
-} from "./chunk-XMSWT5NY.js";
+} from "./chunk-YLSMA3YM.js";
 
 // src/index.ts
-import { readFileSync as readFileSync15, realpathSync } from "fs";
+import { readFileSync as readFileSync16, realpathSync } from "fs";
 import { stdin, stdout } from "process";
 import { createInterface } from "readline/promises";
 import { fileURLToPath } from "url";
@@ -355,18 +355,32 @@ import { applyPublicPrivacyFilter, normalize, validate } from "@takuhon/core";
 
 // src/build-html.ts
 import { generateJsonLd, renderActivitySvg } from "@takuhon/core";
+
+// src/html-helpers.ts
 function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
-function escapeJsonLd(json) {
-  return json.replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026");
-}
 function safeUrl(url) {
   const trimmed = url.trim();
   const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):/.exec(trimmed)?.[1]?.toLowerCase();
   if (scheme === void 0) return trimmed;
   return scheme === "http" || scheme === "https" || scheme === "mailto" ? trimmed : void 0;
 }
+function dateRange(start, end, isCurrent) {
+  const left = start ?? "";
+  const right = isCurrent === true || end === null ? "Present" : end ?? "";
+  if (left && right) return `${left} \u2013 ${right}`;
+  return left || right;
+}
+function nonEmpty(values, separator) {
+  const joined = values.filter((v) => typeof v === "string" && v.length > 0).join(separator);
+  return joined.length > 0 ? joined : void 0;
+}
+
+// src/build-html.ts
+function escapeJsonLd(json) {
+  return json.replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026");
+}
 var CSS = `:root{--fg:#1a1a1a;--muted:#666;--accent:#0b5fff;--line:#e5e5e5}
 *{box-sizing:border-box}
 body{margin:0;color:var(--fg);font:16px/1.6 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;background:#fff}
@@ -392,16 +406,6 @@ ul{padding:0;margin:0;list-style:none}
 nav.locales{display:flex;gap:.75rem;margin-bottom:1rem;font-size:.9rem}
 .activity svg{max-width:100%;height:auto}
 footer.powered{max-width:42rem;margin:0 auto;padding:1.5rem 1.25rem;color:var(--muted);font-size:.85rem}`;
-function dateRange(start, end, isCurrent) {
-  const left = start ?? "";
-  const right = isCurrent === true || end === null ? "Present" : end ?? "";
-  if (left && right) return `${left} \u2013 ${right}`;
-  return left || right;
-}
-function nonEmpty(values, separator) {
-  const joined = values.filter((v) => typeof v === "string" && v.length > 0).join(separator);
-  return joined.length > 0 ? joined : void 0;
-}
 function renderEntry(entry) {
   const href = entry.url ? safeUrl(entry.url) : void 0;
   const heading = href ? `<a href="${escapeHtml(href)}">${escapeHtml(entry.heading)}</a>` : escapeHtml(entry.heading);
@@ -648,14 +652,226 @@ ${footer ? `${footer}
 }
 
 // src/site.ts
-import { resolveLocale } from "@takuhon/core";
+import { deriveCv, resolveLocale } from "@takuhon/core";
+
+// src/cv-html.ts
+var SECTION_TITLES = {
+  experience: "Experience",
+  education: "Education",
+  skills: "Skills",
+  certifications: "Certifications",
+  publications: "Publications",
+  honors: "Honors & Awards",
+  courses: "Courses",
+  patents: "Patents",
+  languages: "Languages",
+  volunteering: "Volunteering",
+  memberships: "Memberships"
+};
+var CSS2 = `:root{--fg:#1a1a1a;--muted:#555;--accent:#0b5fff;--line:#d9d9d9}
+*{box-sizing:border-box}
+body{margin:0;background:#f3f4f6;color:var(--fg);font:13px/1.5 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif}
+main{background:#fff;width:210mm;min-height:297mm;margin:1.5rem auto;padding:18mm 16mm;box-shadow:0 1px 6px rgba(0,0,0,.15)}
+h1{font-size:1.7rem;margin:0}
+.tagline{font-size:1.05rem;color:var(--muted);margin:.15rem 0 0}
+.contact{color:var(--muted);font-size:.85rem;margin:.4rem 0 0;display:flex;flex-wrap:wrap;gap:.25rem 1rem}
+.contact a{color:var(--accent)}
+.bio{margin:.75rem 0 0}
+header{border-bottom:2px solid var(--fg);padding-bottom:.6rem;margin-bottom:.4rem}
+section{margin-top:1.1rem}
+h2{font-size:.95rem;text-transform:uppercase;letter-spacing:.05em;color:var(--accent);border-bottom:1px solid var(--line);margin:0 0 .5rem;padding-bottom:.15rem}
+ul{padding:0;margin:0;list-style:none}
+.entry{margin:0 0 .7rem;break-inside:avoid}
+.entry .row{display:flex;justify-content:space-between;gap:1rem;align-items:baseline}
+.entry h3{font-size:.95rem;margin:0}
+.entry .dates{color:var(--muted);font-size:.8rem;white-space:nowrap}
+.entry .sub{color:var(--muted);margin:.05rem 0}
+.entry p{margin:.2rem 0 0}
+.entry a{color:var(--accent)}
+.chips{display:flex;flex-wrap:wrap;gap:.3rem}
+.chips li{border:1px solid var(--line);border-radius:1rem;padding:.05rem .55rem;font-size:.8rem}
+@media print{
+  body{background:#fff}
+  main{width:auto;min-height:0;margin:0;padding:0;box-shadow:none}
+  a{color:var(--fg)}
+}
+@page{size:A4;margin:14mm}`;
+function renderEntry2(entry) {
+  const href = entry.url ? safeUrl(entry.url) : void 0;
+  const title = href ? `<a href="${escapeHtml(href)}">${escapeHtml(entry.heading)}</a>` : escapeHtml(entry.heading);
+  const dates = entry.dates ? `<span class="dates">${escapeHtml(entry.dates)}</span>` : "";
+  const parts = [`<div class="row"><h3>${title}</h3>${dates}</div>`];
+  if (entry.sub) parts.push(`<p class="sub">${escapeHtml(entry.sub)}</p>`);
+  if (entry.body) parts.push(`<p>${escapeHtml(entry.body)}</p>`);
+  return `<li class="entry">${parts.join("")}</li>`;
+}
+function entryListSection(title, entries) {
+  return `<section><h2>${escapeHtml(title)}</h2><ul>${entries.map(renderEntry2).join("")}</ul></section>`;
+}
+function chipSection(title, labels) {
+  const chips = labels.map((l) => `<li>${escapeHtml(l)}</li>`).join("");
+  return `<section><h2>${escapeHtml(title)}</h2><ul class="chips">${chips}</ul></section>`;
+}
+function languageLabel(l) {
+  return `${l.displayName ?? l.language} \u2014 ${l.proficiency}`;
+}
+function renderSection(section) {
+  const title = SECTION_TITLES[section.kind];
+  switch (section.kind) {
+    case "experience":
+      return entryListSection(
+        title,
+        section.entries.map((c) => ({
+          heading: c.role,
+          sub: c.organization,
+          dates: dateRange(c.startDate, c.endDate, c.isCurrent),
+          body: c.description,
+          url: c.url
+        }))
+      );
+    case "education":
+      return entryListSection(
+        title,
+        section.entries.map((e) => {
+          const degree = nonEmpty([e.degree, e.fieldOfStudy], ", ");
+          return {
+            heading: degree ?? e.institution,
+            sub: degree ? e.institution : void 0,
+            dates: dateRange(e.startDate, e.endDate, e.isCurrent),
+            body: e.description,
+            url: e.url
+          };
+        })
+      );
+    case "skills":
+      return chipSection(
+        title,
+        section.entries.map((s) => s.label)
+      );
+    case "languages":
+      return chipSection(title, section.entries.map(languageLabel));
+    case "certifications":
+      return entryListSection(
+        title,
+        section.entries.map((c) => ({
+          heading: c.title,
+          sub: c.issuingOrganization,
+          dates: dateRange(c.issueDate, c.expirationDate),
+          url: c.url
+        }))
+      );
+    case "publications":
+      return entryListSection(
+        title,
+        section.entries.map((x) => ({
+          heading: x.title,
+          sub: nonEmpty([x.publisher, x.coAuthors?.join(", ")], " \xB7 "),
+          dates: dateRange(x.date),
+          body: x.description,
+          url: x.url ?? (x.doi ? `https://doi.org/${x.doi}` : void 0)
+        }))
+      );
+    case "honors":
+      return entryListSection(
+        title,
+        section.entries.map((x) => ({
+          heading: x.title,
+          sub: x.issuer,
+          dates: dateRange(x.date),
+          body: x.description,
+          url: x.url
+        }))
+      );
+    case "courses":
+      return entryListSection(
+        title,
+        section.entries.map((x) => ({
+          heading: x.title,
+          sub: x.provider,
+          dates: dateRange(x.completionDate),
+          body: x.description,
+          url: x.certificateUrl
+        }))
+      );
+    case "patents":
+      return entryListSection(
+        title,
+        section.entries.map((x) => ({
+          heading: x.title,
+          sub: nonEmpty([x.patentNumber, x.office, x.status], " \xB7 "),
+          dates: dateRange(x.filingDate ?? x.grantDate),
+          body: x.description,
+          url: x.url
+        }))
+      );
+    case "volunteering":
+      return entryListSection(
+        title,
+        section.entries.map((x) => ({
+          heading: x.role,
+          sub: nonEmpty([x.organization, x.cause], " \xB7 "),
+          dates: dateRange(x.startDate, x.endDate, x.isCurrent),
+          body: x.description,
+          url: x.url
+        }))
+      );
+    case "memberships":
+      return entryListSection(
+        title,
+        section.entries.map((x) => ({
+          heading: x.role ?? x.organization,
+          sub: x.role ? x.organization : void 0,
+          dates: dateRange(x.startDate, x.endDate, x.isCurrent),
+          body: x.description,
+          url: x.url
+        }))
+      );
+  }
+}
+function renderHeader2(cv) {
+  const h = cv.header;
+  const parts = [`<h1>${escapeHtml(h.displayName)}</h1>`];
+  if (h.tagline) parts.push(`<p class="tagline">${escapeHtml(h.tagline)}</p>`);
+  const contact = [];
+  if (h.location) contact.push(`<span>${escapeHtml(h.location)}</span>`);
+  if (h.email) {
+    contact.push(`<a href="mailto:${escapeHtml(h.email)}">${escapeHtml(h.email)}</a>`);
+  }
+  const formHref = h.formUrl ? safeUrl(h.formUrl) : void 0;
+  if (formHref) contact.push(`<a href="${escapeHtml(formHref)}">Contact</a>`);
+  if (contact.length > 0) parts.push(`<div class="contact">${contact.join("")}</div>`);
+  if (h.bio) parts.push(`<p class="bio">${escapeHtml(h.bio)}</p>`);
+  return `<header>${parts.join("")}</header>`;
+}
+function renderCvHtml(cv) {
+  const title = `${cv.header.displayName} \u2014 CV`;
+  const body = [renderHeader2(cv), ...cv.sections.map(renderSection)].join("\n");
+  return `<!DOCTYPE html>
+<html lang="${escapeHtml(cv.resolvedLocale)}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtml(title)}</title>
+  <style>${CSS2}</style>
+</head>
+<body>
+<main>
+${body}
+</main>
+</body>
+</html>
+`;
+}
+
+// src/site.ts
 function generateSite(profile, options = {}) {
   const { baseUrl } = options;
   const defaultLocale = profile.settings.defaultLocale;
   const locales = [.../* @__PURE__ */ new Set([defaultLocale, ...profile.settings.availableLocales])];
   const jsonLd = profile.settings.enableJsonLd !== false;
   const activitySnapshot = profile.settings.activity?.enabled === true ? options.activitySnapshot ?? void 0 : void 0;
-  return locales.map((locale) => {
+  const pages = [];
+  for (const locale of locales) {
     const localized = resolveLocale(profile, locale);
     const isDefault = locale === defaultLocale;
     const localeNav = locales.map((to) => ({
@@ -673,12 +889,20 @@ function generateSite(profile, options = {}) {
       jsonLd,
       activitySnapshot
     });
-    return {
+    pages.push({
       route: isDefault ? "/" : `/${locale}/`,
       file: isDefault ? "index.html" : `${locale}/index.html`,
       html
-    };
-  });
+    });
+    if (options.cv === true) {
+      pages.push({
+        route: isDefault ? "/cv/" : `/${locale}/cv/`,
+        file: isDefault ? "cv.html" : `${locale}/cv.html`,
+        html: renderCvHtml(deriveCv(localized))
+      });
+    }
+  }
+  return pages;
 }
 function absoluteUrl(baseUrl, locale, defaultLocale) {
   return locale === defaultLocale ? `${baseUrl}/` : `${baseUrl}/${locale}/`;
@@ -706,10 +930,10 @@ var DEFAULT_PATH2 = "takuhon.json";
 var DEFAULT_PORT = 4321;
 var USAGE = `Usage: takuhon dev [path] [--port <n>] [--base-url <url>]
 
-Serve a takuhon.json as a local static preview (one page per locale) \u2014 the same
-surface \`takuhon build\` produces. With no path, serves ./takuhon.json. The file
-is re-read and re-rendered on every request, so edit it and reload the browser
-to see changes. Stop with Ctrl-C.
+Serve a takuhon.json as a local static preview (one page per locale, plus a
+print-ready CV page at /cv) \u2014 the same surface \`takuhon build\` produces. With
+no path, serves ./takuhon.json. The file is re-read and re-rendered on every
+request, so edit it and reload the browser to see changes. Stop with Ctrl-C.
 
 Options:
   --port <n>       Port to listen on (default: ${DEFAULT_PORT}).
@@ -749,7 +973,7 @@ ${lines.join("\n")}`
   const filtered = applyPublicPrivacyFilter(normalize(result.data));
   const activitySnapshot = filtered.settings.activity?.enabled === true ? readActivitySnapshotSync(path) : null;
   const pages = new Map(
-    generateSite(filtered, { baseUrl, activitySnapshot }).map((p) => [p.route, p.html])
+    generateSite(filtered, { baseUrl, activitySnapshot, cv: true }).map((p) => [p.route, p.html])
   );
   return { ok: true, pages };
 }
@@ -1472,7 +1696,7 @@ import { dirname as dirname5, join as join6 } from "path";
 import { applyPublicPrivacyFilter as applyPublicPrivacyFilter2, normalize as normalize2, validate as validate2 } from "@takuhon/core";
 var DEFAULT_PATH4 = "takuhon.json";
 var DEFAULT_OUTPUT = "dist";
-var USAGE3 = `Usage: takuhon build [path] [--output <dir>] [--base-url <url>]
+var USAGE3 = `Usage: takuhon build [path] [--output <dir>] [--base-url <url>] [--cv]
 
 Render a takuhon.json into a static site (one HTML page per locale, with
 build-time Schema.org JSON-LD). With no path, builds ./takuhon.json.
@@ -1483,6 +1707,9 @@ Options:
                    to <dir>/<locale>/index.html.
   --base-url <url> Site origin (e.g. https://me.example). Enables absolute
                    canonical and hreflang links; without it those are omitted.
+  --cv             Also emit a print-ready CV/r\xE9sum\xE9 page per locale
+                   (<dir>/cv.html and <dir>/<locale>/cv.html). Open it and use
+                   the browser's "Save as PDF" to produce a r\xE9sum\xE9 PDF.
 
 The public privacy filter is applied (meta.privacy is honoured). Asset URLs are
 referenced as-is and are not copied. The output directory is written into, not
@@ -1511,8 +1738,13 @@ function parseArgs3(args) {
   let path;
   let output;
   let baseUrl;
+  let cv = false;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
+    if (arg === "--cv") {
+      cv = true;
+      continue;
+    }
     if (arg === "--output" || arg === "--base-url") {
       const value = args[i + 1];
       if (value === void 0 || value === "" || value.startsWith("-")) {
@@ -1550,7 +1782,8 @@ function parseArgs3(args) {
     path: path ?? DEFAULT_PATH4,
     output: output ?? DEFAULT_OUTPUT,
     // Drop any trailing slash so URL joins are predictable.
-    baseUrl: baseUrl?.replace(/\/+$/, "")
+    baseUrl: baseUrl?.replace(/\/+$/, ""),
+    cv
   };
 }
 function isHttpUrl3(value) {
@@ -1562,7 +1795,7 @@ function isHttpUrl3(value) {
   }
 }
 function buildSite(parsed) {
-  const { path, output, baseUrl } = parsed;
+  const { path, output, baseUrl, cv } = parsed;
   let raw;
   try {
     raw = readFileSync7(path, "utf8");
@@ -1597,7 +1830,7 @@ ${lines.join("\n")}
   const activitySnapshot = filtered.settings.activity?.enabled === true ? readActivitySnapshotSync(path) : null;
   const written = [];
   try {
-    for (const page of generateSite(filtered, { baseUrl, activitySnapshot })) {
+    for (const page of generateSite(filtered, { baseUrl, activitySnapshot, cv })) {
       const outFile = join6(output, page.file);
       mkdirSync3(dirname5(outFile), { recursive: true });
       writeFileAtomic(outFile, page.html);
@@ -1914,18 +2147,144 @@ function isNotFound5(error) {
   return typeof error === "object" && error !== null && error.code === "ENOENT";
 }
 
-// src/migrate-command.ts
+// src/mcp-command.ts
 import { readFileSync as readFileSync10 } from "fs";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { validate as validate4 } from "@takuhon/core";
+import { createTakuhonMcpServer } from "@takuhon/mcp";
+var DEFAULT_PATH7 = "takuhon.json";
+var SERVER_NAME = "takuhon";
+var USAGE6 = `Usage: takuhon mcp [path]
+
+Serve a takuhon.json over the Model Context Protocol on stdio, so an MCP client
+(e.g. Claude Desktop) can read the profile read-only. With no path, serves
+./takuhon.json. The file is re-read on every request, so edits are reflected
+without restarting.
+
+Exposes (read-only, the same surface as the public API, privacy filter applied):
+  tools:     get_profile, get_section, get_jsonld, list_locales
+  resources: takuhon://profile, takuhon://schema
+
+stdin/stdout carry the protocol stream; diagnostics go to stderr. The server
+runs until the client disconnects or you press Ctrl-C.
+
+Example Claude Desktop config (claude_desktop_config.json):
+  {
+    "mcpServers": {
+      "my-profile": { "command": "takuhon", "args": ["mcp", "/path/to/takuhon.json"] }
+    }
+  }
+
+Exit codes: 0 = served then stopped, 2 = bad arguments / file missing /
+unreadable / invalid.
+`;
+var VERSION = readCliVersion();
+function loadMcpProfile(path) {
+  let raw;
+  try {
+    raw = readFileSync10(path, "utf8");
+  } catch {
+    throw new Error(`cannot read '${path}'.`);
+  }
+  let data;
+  try {
+    data = JSON.parse(raw);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`'${path}' is not valid JSON: ${detail}`, { cause: error });
+  }
+  const result = validate4(data);
+  if (!result.ok) {
+    const lines = result.errors.map((e) => `  ${e.pointer || "/"}: ${e.message}`);
+    throw new Error(`'${path}' is not a valid takuhon profile:
+${lines.join("\n")}`);
+  }
+  return result.data;
+}
+async function runMcp(args = [], deps = {}) {
+  const err = deps.stderr ?? ((text) => void process.stderr.write(text));
+  if (args[0] === "--help" || args[0] === "-h") {
+    const out = deps.stdout ?? ((text) => void process.stdout.write(text));
+    out(USAGE6);
+    return 0;
+  }
+  const parsed = parseArgs6(args);
+  if ("error" in parsed) {
+    err(`${parsed.error}
+Run \`takuhon mcp --help\` for usage.
+`);
+    return 2;
+  }
+  try {
+    loadMcpProfile(parsed.path);
+  } catch (error) {
+    err(`takuhon: ${error instanceof Error ? error.message : String(error)}
+`);
+    return 2;
+  }
+  const server = createTakuhonMcpServer({
+    // Re-read per request so edits are reflected; if the file later becomes
+    // invalid, the load failure surfaces to the client as a tool error result.
+    loadProfile: () => loadMcpProfile(parsed.path),
+    name: SERVER_NAME,
+    version: VERSION
+  });
+  const transport = (deps.createTransport ?? (() => new StdioServerTransport()))();
+  await server.connect(transport);
+  err(`takuhon mcp: serving ${parsed.path} (read-only) on stdio
+`);
+  return await new Promise((resolve7) => {
+    let done = false;
+    function finish() {
+      if (done) return;
+      done = true;
+      process.removeListener("SIGINT", shutdown);
+      process.removeListener("SIGTERM", shutdown);
+      resolve7(0);
+    }
+    function shutdown() {
+      void server.close();
+      finish();
+    }
+    server.server.onclose = finish;
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+  });
+}
+function parseArgs6(args) {
+  let path;
+  for (const arg of args) {
+    if (arg.startsWith("-")) {
+      return { error: `takuhon: unknown option \`${arg}\` for \`mcp\`.` };
+    }
+    if (path !== void 0) {
+      return { error: "takuhon: `mcp` takes at most one path argument." };
+    }
+    path = arg;
+  }
+  return { path: path ?? DEFAULT_PATH7 };
+}
+function readCliVersion() {
+  try {
+    const pkg2 = JSON.parse(readFileSync10(new URL("../package.json", import.meta.url), "utf8"));
+    return pkg2.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+
+// src/migrate-command.ts
+import { readFileSync as readFileSync11 } from "fs";
 import { resolve as resolve5 } from "path";
 import {
   MigrationError as MigrationError2,
   SCHEMA_VERSION as SCHEMA_VERSION2,
   SUPPORTED_SCHEMA_VERSIONS,
   migrateTakuhon as migrateTakuhon2,
-  validate as validate4
+  validate as validate5
 } from "@takuhon/core";
-var DEFAULT_PATH7 = "takuhon.json";
-var USAGE6 = `Usage: takuhon migrate [path] [--to <version>] [--out <file>] [--dry-run]
+var DEFAULT_PATH8 = "takuhon.json";
+var USAGE7 = `Usage: takuhon migrate [path] [--to <version>] [--out <file>] [--dry-run]
 
 Forward-migrate a takuhon.json to a newer schema version. The source version
 is read from the file's own schemaVersion. With no path, migrates
@@ -1947,9 +2306,9 @@ Exit codes: 0 = migrated / already current / dry-run, 1 = cannot migrate,
 `;
 function runMigrate(args = [], deps = {}) {
   if (args[0] === "--help" || args[0] === "-h") {
-    return { code: 0, stdout: USAGE6, stderr: "" };
+    return { code: 0, stdout: USAGE7, stderr: "" };
   }
-  const parsed = parseArgs6(args);
+  const parsed = parseArgs7(args);
   if ("error" in parsed) {
     return {
       code: 2,
@@ -1962,7 +2321,7 @@ Run \`takuhon migrate --help\` for usage.
   const now = deps.now ?? (() => /* @__PURE__ */ new Date());
   return migrateFile(parsed, now);
 }
-function parseArgs6(args) {
+function parseArgs7(args) {
   let path;
   let to;
   let out;
@@ -2005,13 +2364,13 @@ function parseArgs6(args) {
       error: `takuhon: unsupported --to version "${target}". Supported: ${SUPPORTED_SCHEMA_VERSIONS.join(", ")}.`
     };
   }
-  return { path: path ?? DEFAULT_PATH7, to: target, out, dryRun };
+  return { path: path ?? DEFAULT_PATH8, to: target, out, dryRun };
 }
 function migrateFile(parsed, now) {
   const { path, to: target, out, dryRun } = parsed;
   let raw;
   try {
-    raw = readFileSync10(path, "utf8");
+    raw = readFileSync11(path, "utf8");
   } catch {
     return {
       code: 2,
@@ -2062,7 +2421,7 @@ Migrations are forward-only; to move to an older schema, restore from a backup w
     }
     throw error;
   }
-  const revalidated = validate4(migrated);
+  const revalidated = validate5(migrated);
   if (!revalidated.ok) {
     const lines2 = revalidated.errors.map((e) => `  ${e.pointer || "/"}: ${e.message}`);
     return {
@@ -2125,11 +2484,11 @@ ${lines2.join("\n")}
 }
 
 // src/refresh-admin-command.ts
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 import { cp, mkdtemp, readdir, rename, rm, stat } from "fs/promises";
 import { join as join7, resolve as resolve6 } from "path";
 var PROFILE_FILENAME = "takuhon.json";
-var USAGE7 = `Usage: takuhon admin update [path]
+var USAGE8 = `Usage: takuhon admin update [path]
 
 Refresh a project's ${ADMIN_DIST_DIRNAME}/ with the admin form-UI bundle shipped in
 this @takuhon/cli. Use it after upgrading @takuhon/cli to pick up a newer admin
@@ -2142,7 +2501,7 @@ no ${ADMIN_DIST_DIRNAME}/ to refresh / copy failed.
 `;
 async function runRefreshAdmin(args = [], opts = {}) {
   if (args[0] === "--help" || args[0] === "-h") {
-    return { code: 0, stdout: USAGE7, stderr: "" };
+    return { code: 0, stdout: USAGE8, stderr: "" };
   }
   const unknownFlag = args.find((arg) => arg.startsWith("-"));
   if (unknownFlag !== void 0) {
@@ -2225,7 +2584,7 @@ Run \`takuhon admin update --help\` for usage.
   };
 }
 function readVersion() {
-  const pkg2 = JSON.parse(readFileSync11(new URL("../package.json", import.meta.url), "utf8"));
+  const pkg2 = JSON.parse(readFileSync12(new URL("../package.json", import.meta.url), "utf8"));
   return pkg2.version;
 }
 function isNodeErrnoException(err) {
@@ -2233,10 +2592,10 @@ function isNodeErrnoException(err) {
 }
 
 // src/restore-command.ts
-import { readFileSync as readFileSync12 } from "fs";
-import { validate as validate5 } from "@takuhon/core";
-var DEFAULT_PATH8 = "takuhon.json";
-var USAGE8 = `Usage: takuhon restore --from <backup> [path] [--yes]
+import { readFileSync as readFileSync13 } from "fs";
+import { validate as validate6 } from "@takuhon/core";
+var DEFAULT_PATH9 = "takuhon.json";
+var USAGE9 = `Usage: takuhon restore --from <backup> [path] [--yes]
 
 Overwrite a profile with a previously saved backup. With no path, restores
 ./takuhon.json in the current working directory.
@@ -2253,9 +2612,9 @@ Exit codes: 0 = restored / aborted, 1 = backup failed validation,
 `;
 async function runRestore(args = [], deps = {}) {
   if (args[0] === "--help" || args[0] === "-h") {
-    return { code: 0, stdout: USAGE8, stderr: "" };
+    return { code: 0, stdout: USAGE9, stderr: "" };
   }
-  const parsed = parseArgs7(args);
+  const parsed = parseArgs8(args);
   if ("error" in parsed) {
     return {
       code: 2,
@@ -2268,7 +2627,7 @@ Run \`takuhon restore --help\` for usage.
   const now = deps.now ?? (() => /* @__PURE__ */ new Date());
   return restoreFile(parsed, now, deps.confirm);
 }
-function parseArgs7(args) {
+function parseArgs8(args) {
   let from;
   let path;
   let yes = false;
@@ -2302,13 +2661,13 @@ function parseArgs7(args) {
   if (from === void 0 || from.length === 0) {
     return { error: "takuhon: `restore` requires `--from <backup>`." };
   }
-  return { from, path: path ?? DEFAULT_PATH8, yes };
+  return { from, path: path ?? DEFAULT_PATH9, yes };
 }
 async function restoreFile(parsed, now, confirm) {
   const { from, path, yes } = parsed;
   let backupRaw;
   try {
-    backupRaw = readFileSync12(from, "utf8");
+    backupRaw = readFileSync13(from, "utf8");
   } catch {
     return { code: 2, stdout: "", stderr: `takuhon: cannot read backup '${from}'.
 ` };
@@ -2325,7 +2684,7 @@ async function restoreFile(parsed, now, confirm) {
 `
     };
   }
-  const result = validate5(backupData);
+  const result = validate6(backupData);
   if (!result.ok) {
     const lines2 = result.errors.map((e) => `  ${e.pointer || "/"}: ${e.message}`);
     return {
@@ -2338,7 +2697,7 @@ ${lines2.join("\n")}
   }
   let currentRaw;
   try {
-    currentRaw = readFileSync12(path, "utf8");
+    currentRaw = readFileSync13(path, "utf8");
   } catch (error) {
     if (!isNotFound6(error)) {
       return { code: 2, stdout: "", stderr: `takuhon: cannot read current profile '${path}'.
@@ -2408,12 +2767,12 @@ function isNotFound6(error) {
 }
 
 // src/sync-command.ts
-import { readFileSync as readFileSync13 } from "fs";
-import { validate as validate6 } from "@takuhon/core";
-var DEFAULT_PATH9 = "takuhon.json";
+import { readFileSync as readFileSync14 } from "fs";
+import { validate as validate7 } from "@takuhon/core";
+var DEFAULT_PATH10 = "takuhon.json";
 var ADMIN_PROFILE_PATH = "/api/admin/profile";
 var TOKEN_ENV = "TAKUHON_ADMIN_TOKEN";
-var USAGE9 = `Usage: takuhon sync [path] --url <base-url> [--if-match <etag>] [--dry-run]
+var USAGE10 = `Usage: takuhon sync [path] --url <base-url> [--if-match <etag>] [--dry-run]
 
 Push a local takuhon.json to a deployed takuhon instance by calling its admin
 write endpoint (PUT <base-url>/api/admin/profile). With no path, syncs
@@ -2439,9 +2798,9 @@ unset / auth failure / network error / other non-success response.
 `;
 async function runSync(args = [], deps = {}) {
   if (args[0] === "--help" || args[0] === "-h") {
-    return { code: 0, stdout: USAGE9, stderr: "" };
+    return { code: 0, stdout: USAGE10, stderr: "" };
   }
-  const parsed = parseArgs8(args);
+  const parsed = parseArgs9(args);
   if ("error" in parsed) {
     return {
       code: 2,
@@ -2453,7 +2812,7 @@ Run \`takuhon sync --help\` for usage.
   }
   return syncProfile(parsed, deps);
 }
-function parseArgs8(args) {
+function parseArgs9(args) {
   let path;
   let url;
   let ifMatch;
@@ -2499,7 +2858,7 @@ function parseArgs8(args) {
   }
   const base = parseOrigin(url);
   if ("error" in base) return base;
-  return { path: path ?? DEFAULT_PATH9, url: base.origin, ifMatch, dryRun };
+  return { path: path ?? DEFAULT_PATH10, url: base.origin, ifMatch, dryRun };
 }
 function parseOrigin(value) {
   let parsed;
@@ -2532,7 +2891,7 @@ async function syncProfile(parsed, deps) {
   const { path, url, ifMatch, dryRun } = parsed;
   let raw;
   try {
-    raw = readFileSync13(path, "utf8");
+    raw = readFileSync14(path, "utf8");
   } catch {
     return { code: 2, stdout: "", stderr: `takuhon: cannot read '${path}'.
 ` };
@@ -2545,7 +2904,7 @@ async function syncProfile(parsed, deps) {
     return { code: 2, stdout: "", stderr: `takuhon: '${path}' is not valid JSON: ${detail}
 ` };
   }
-  const result = validate6(data);
+  const result = validate7(data);
   if (!result.ok) {
     const lines = result.errors.map((e) => `  ${e.pointer || "/"}: ${e.message}`);
     return {
@@ -2669,10 +3028,10 @@ async function readProblem(res) {
 }
 
 // src/validate-command.ts
-import { readFileSync as readFileSync14 } from "fs";
-import { validate as validate7 } from "@takuhon/core";
-var DEFAULT_PATH10 = "takuhon.json";
-var USAGE10 = `Usage: takuhon validate [path]
+import { readFileSync as readFileSync15 } from "fs";
+import { validate as validate8 } from "@takuhon/core";
+var DEFAULT_PATH11 = "takuhon.json";
+var USAGE11 = `Usage: takuhon validate [path]
 
 Validate a takuhon.json against the takuhon schema. With no path, validates
 ./takuhon.json in the current working directory.
@@ -2681,7 +3040,7 @@ Exit codes: 0 = valid, 1 = invalid, 2 = file missing / unreadable / not JSON.
 `;
 function runValidate(args = []) {
   if (args[0] === "--help" || args[0] === "-h") {
-    return { code: 0, stdout: USAGE10, stderr: "" };
+    return { code: 0, stdout: USAGE11, stderr: "" };
   }
   if (args.length > 1) {
     return {
@@ -2693,10 +3052,10 @@ function runValidate(args = []) {
   return validateFile(args[0]);
 }
 function validateFile(pathArg) {
-  const target = pathArg ?? DEFAULT_PATH10;
+  const target = pathArg ?? DEFAULT_PATH11;
   let raw;
   try {
-    raw = readFileSync14(target, "utf8");
+    raw = readFileSync15(target, "utf8");
   } catch {
     return {
       code: 2,
@@ -2717,7 +3076,7 @@ function validateFile(pathArg) {
 `
     };
   }
-  const result = validate7(data);
+  const result = validate8(data);
   if (result.ok) {
     return {
       code: 0,
@@ -2738,9 +3097,9 @@ ${lines.join("\n")}
 }
 
 // src/index.ts
-var pkg = JSON.parse(readFileSync15(new URL("../package.json", import.meta.url), "utf8"));
-var VERSION = pkg.version;
-var HELP = `takuhon ${VERSION}
+var pkg = JSON.parse(readFileSync16(new URL("../package.json", import.meta.url), "utf8"));
+var VERSION2 = pkg.version;
+var HELP = `takuhon ${VERSION2}
 
 Takuhon \u2014 open-source portable profile API server.
 
@@ -2771,6 +3130,9 @@ Commands:
   takuhon admin update [path]          Refresh a project's admin-dist/ with the admin form UI
                                        bundled in this @takuhon/cli (use after upgrading the
                                        CLI). Updates an existing admin-dist/ only.
+  takuhon mcp [path]                   Serve a takuhon.json over the Model Context Protocol on
+                                       stdio (read-only), so an MCP client such as Claude Desktop
+                                       can read the profile. Re-reads the file per request.
   takuhon sync [path] --url <url>      Push a takuhon.json to a deployment's admin API
                                        (PUT <url>/api/admin/profile). Reads the admin token
                                        from TAKUHON_ADMIN_TOKEN. --if-match <etag> opts into
@@ -2788,7 +3150,7 @@ Scaffolding a new profile project:
 async function main(argv) {
   const first = argv[0];
   if (first === "--version" || first === "-v") {
-    process.stdout.write(`${VERSION}
+    process.stdout.write(`${VERSION2}
 `);
     return 0;
   }
@@ -2817,6 +3179,9 @@ async function main(argv) {
     }
     return runAdmin(argv.slice(1));
   }
+  if (first === "mcp") {
+    return runMcp(argv.slice(1));
+  }
   if (first === "import") {
     return emit(runImport(argv.slice(1)));
   }