@contentrain/mcp 1.3.0 → 1.5.0

package/dist/core/context.mjs

@@ -1,7 +1,7 @@
 import "../serialization-B1CEzR4H.mjs";
 import "../fs-DLbVB-Ek.mjs";
-import "../config-BIl5Ybj0.mjs";
+import "../config-Lw7vpK9n.mjs";
 import "../model-manager-BhLsUgaB.mjs";
 import "../meta-manager-C900rEyG.mjs";
-import { n as readContext, r as writeContext, t as buildContextChange } from "../context-J0OU9Nfp.mjs";
+import { n as readContext, r as writeContext, t as buildContextChange } from "../context-DS40WOdw.mjs";
 export { buildContextChange, readContext, writeContext };

package/dist/core/doctor.mjs

@@ -1,8 +1,8 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../config-BIl5Ybj0.mjs";
+import "../config-Lw7vpK9n.mjs";
 import "../model-manager-BhLsUgaB.mjs";
 import "../meta-manager-C900rEyG.mjs";
-import "../branch-lifecycle-CFVpTpNT.mjs";
+import "../branch-lifecycle-DjX3MXNG.mjs";
 import "../scan-config-jC6XmiqF.mjs";
-import { t as runDoctor } from "../doctor-CgBoT6h1.mjs";
+import { t as runDoctor } from "../doctor-Dxu_SzZy.mjs";
 export { runDoctor };

package/dist/core/validator/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/validator/entry.ts","../../../src/core/validator/relation-integrity.ts","../../../src/core/validator/project.ts","../../../src/core/validator/schedule.ts"],"mappings":";;;;;;;AAUA;;;;UAAiB,iBAAA;EAMN;EAJT,UAAA,GAAa,MAAA,SAAe,MAAA;EAIJ;EAFxB,cAAA;EAFa;EAIb,MAAA,GAAS,eAAA;AAAA;;;;;AAgBX;;;;;;;;;iBAAgB,eAAA,CACd,IAAA,EAAM,MAAA,mBACN,MAAA,EAAQ,MAAA,SAAe,QAAA,GACvB,OAAA,UACA,MAAA,UACA,OAAA,WACA,GAAA,GAAM,iBAAA,GACL,gBAAA;;;;;;AA7BH;;;;;;;;;UCIiB,cAAA;EACf,MAAA;EACA,OAAA,GAAU,MAAA;AAAA;;KAIA,iBAAA,IACV,aAAA,UACA,YAAA,aACG,OAAA,CAAQ,MAAA;AAAA,UAEI,6BAAA;EDOD;ECLd,QAAA;;;;;;EAMA,aAAA,IACE,aAAA,UACA,YAAA,aACG,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;iBAcO,sBAAA,CACpB,IAAA,EAAM,MAAA,mBACN,MAAA,EAAQ,MAAA,SAAe,QAAA,GACvB,OAAA,UACA,MAAA,UACA,OAAA,sBACA,WAAA,EAAa,iBAAA,EACb,IAAA,GAAM,6BAAA,GACL,OAAA,CAAQ,eAAA;;;UCxCM,eAAA;EACf,KAAA;EACA,GAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA;EACA,OAAA;IACE,MAAA;IACA,QAAA;IACA,OAAA;IACA,cAAA;IACA,eAAA;EAAA;EAEF,MAAA,EAAQ,eAAA;EACR,KAAA;AAAA;;;AFDF;;;;;;;;;;;;;iBEqrBsB,eAAA,CAAgB,WAAA,UAAqB,OAAA,GAAU,eAAA,GAAkB,OAAA,CAAQ,cAAA;AAAA,iBACzE,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,OAAA,GAAU,eAAA,GAAkB,OAAA,CAAQ,cAAA;;;;;;AF5sB9F;;;;;iBGAgB,sBAAA,CACd,IAAA,EAAM,SAAA,EACN,GAAA;EAAO,KAAA;EAAe,MAAA;EAAgB,KAAA;EAAgB,IAAA;AAAA,GACtD,MAAA,EAAQ,eAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/validator/entry.ts","../../../src/core/validator/relation-integrity.ts","../../../src/core/validator/project.ts","../../../src/core/validator/schedule.ts"],"mappings":";;;;;;;AAUA;;;;UAAiB,iBAAA;EAMN;EAJT,UAAA,GAAa,MAAA,SAAe,MAAA;EAIJ;EAFxB,cAAA;EAFa;EAIb,MAAA,GAAS,eAAA;AAAA;;;;;AAgBX;;;;;;;;;iBAAgB,eAAA,CACd,IAAA,EAAM,MAAA,mBACN,MAAA,EAAQ,MAAA,SAAe,QAAA,GACvB,OAAA,UACA,MAAA,UACA,OAAA,WACA,GAAA,GAAM,iBAAA,GACL,gBAAA;;;;;;AA7BH;;;;;;;;;UCIiB,cAAA;EACf,MAAA;EACA,OAAA,GAAU,MAAA;AAAA;;KAIA,iBAAA,IACV,aAAA,UACA,YAAA,aACG,OAAA,CAAQ,MAAA;AAAA,UAEI,6BAAA;EDOD;ECLd,QAAA;;;;;;EAMA,aAAA,IACE,aAAA,UACA,YAAA,aACG,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;iBAcO,sBAAA,CACpB,IAAA,EAAM,MAAA,mBACN,MAAA,EAAQ,MAAA,SAAe,QAAA,GACvB,OAAA,UACA,MAAA,UACA,OAAA,sBACA,WAAA,EAAa,iBAAA,EACb,IAAA,GAAM,6BAAA,GACL,OAAA,CAAQ,eAAA;;;UCxCM,eAAA;EACf,KAAA;EACA,GAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA;EACA,OAAA;IACE,MAAA;IACA,QAAA;IACA,OAAA;IACA,cAAA;IACA,eAAA;EAAA;EAEF,MAAA,EAAQ,eAAA;EACR,KAAA;AAAA;;;AFDF;;;;;;;;;;;;;iBEwsBsB,eAAA,CAAgB,WAAA,UAAqB,OAAA,GAAU,eAAA,GAAkB,OAAA,CAAQ,cAAA;AAAA,iBACzE,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,OAAA,GAAU,eAAA,GAAkB,OAAA,CAAQ,cAAA;;;;;;AF/tB9F;;;;;iBGAgB,sBAAA,CACd,IAAA,EAAM,SAAA,EACN,GAAA;EAAO,KAAA;EAAe,MAAA;EAAgB,KAAA;EAAgB,IAAA;AAAA,GACtD,MAAA,EAAQ,eAAA"}

package/dist/core/validator/index.mjs

@@ -1,6 +1,6 @@
 import "../../fs-DLbVB-Ek.mjs";
-import "../../config-BIl5Ybj0.mjs";
+import "../../config-Lw7vpK9n.mjs";
 import "../../model-manager-BhLsUgaB.mjs";
 import "../../meta-manager-C900rEyG.mjs";
-import { i as validateContent, n as validateScheduleFields, r as checkRelationIntegrity, t as validateProject } from "../../validator-B0nNRFeU.mjs";
+import { i as validateContent, n as validateScheduleFields, r as checkRelationIntegrity, t as validateProject } from "../../validator-BX2ou7V-.mjs";
 export { checkRelationIntegrity, validateContent, validateProject, validateScheduleFields };

package/dist/{doctor-CgBoT6h1.mjs → doctor-Dxu_SzZy.mjs}

@@ -1,7 +1,7 @@
 import { a as readJson, i as readDir, o as readText, r as pathExists, t as contentrainDir } from "./fs-DLbVB-Ek.mjs";
-import { t as readConfig } from "./config-BIl5Ybj0.mjs";
+import { t as readConfig } from "./config-Lw7vpK9n.mjs";
 import { g as resolveLocaleStrategy, h as resolveJsonFilePath, m as resolveContentDir, o as listModels, s as readModel } from "./model-manager-BhLsUgaB.mjs";
-import { n as checkBranchHealth } from "./branch-lifecycle-CFVpTpNT.mjs";
+import { n as checkBranchHealth } from "./branch-lifecycle-DjX3MXNG.mjs";
 import { i as autoDetectSourceDirs, o as discoverFiles } from "./scan-config-jC6XmiqF.mjs";
 import { join } from "node:path";
 import { stat } from "node:fs/promises";
@@ -335,4 +335,4 @@ async function analyzeMissingLocaleKeys(projectRoot, config) {
 //#endregion
 export { runDoctor as t };
 
-//# sourceMappingURL=doctor-CgBoT6h1.mjs.map
+//# sourceMappingURL=doctor-Dxu_SzZy.mjs.map

package/dist/{doctor-CgBoT6h1.mjs.map → doctor-Dxu_SzZy.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"doctor-CgBoT6h1.mjs","names":[],"sources":["../src/core/doctor.ts"],"sourcesContent":["import { join } from 'node:path'\nimport { stat } from 'node:fs/promises'\nimport { simpleGit } from 'simple-git'\nimport type { ContentrainConfig, ModelDefinition } from '@contentrain/types'\nimport { readConfig } from './config.js'\nimport { listModels, readModel } from './model-manager.js'\nimport { resolveContentDir, resolveJsonFilePath, resolveLocaleStrategy } from './content-manager.js'\nimport { autoDetectSourceDirs, discoverFiles } from './scan-config.js'\nimport { checkBranchHealth } from '../git/branch-lifecycle.js'\nimport { contentrainDir, pathExists, readDir, readJson, readText } from '../util/fs.js'\n\n/**\n * Doctor — project health report.\n *\n * The public entry point is `runDoctor(projectRoot, { usage? })`. It is\n * inherently local-filesystem work (Node version, git install, file\n * mtimes, orphan directory detection), so the MCP tool surface gates\n * it behind the `localWorktree` capability — same pattern as\n * `contentrain_setup` and normalize.\n *\n * The report is structured JSON so three consumers can share it:\n *\n * - The `contentrain doctor` CLI command pretty-prints the checks.\n * - The Serve UI `/api/doctor` route returns the report to the\n *   Dashboard's Doctor panel.\n * - Automation (CI, Studio) gets a deterministic JSON shape it can\n *   assert against.\n *\n * Usage analysis (`--usage`) is a heavier, opt-in branch — it scans\n * every source file in the repo for content-key references. Kept\n * behind the flag so the default doctor run stays fast.\n */\n\nexport type CheckSeverity = 'error' | 'warning' | 'info'\n\nexport interface DoctorCheck {\n  name: string\n  pass: boolean\n  detail: string\n  /**\n   * `error` — default for failing checks. Blocks a clean bill of health.\n   * `warning` — failing-but-not-blocking (e.g. pending branches above\n   *   threshold, stale SDK client).\n   * `info` — passed check; pure informational.\n   */\n  severity?: CheckSeverity\n}\n\nexport interface UnusedKeyEntry {\n  model: string\n  kind: string\n  key: string\n  locale: string\n}\n\nexport interface DuplicateValueEntry {\n  model: string\n  locale: string\n  value: string\n  keys: string[]\n}\n\nexport interface MissingLocaleEntry {\n  model: string\n  key: string\n  missingIn: string\n}\n\nexport interface DoctorUsageAnalysis {\n  unusedKeys: UnusedKeyEntry[]\n  duplicateValues: DuplicateValueEntry[]\n  missingLocaleKeys: MissingLocaleEntry[]\n}\n\nexport interface DoctorReport {\n  checks: DoctorCheck[]\n  summary: {\n    total: number\n    passed: number\n    failed: number\n    warnings: number\n  }\n  /** Present only when `options.usage === true`. */\n  usage?: DoctorUsageAnalysis\n}\n\nexport interface RunDoctorOptions {\n  /** Run heavier `--usage` analysis (unused keys, duplicates, locale gaps). */\n  usage?: boolean\n}\n\nexport async function runDoctor(\n  projectRoot: string,\n  options: RunDoctorOptions = {},\n): Promise<DoctorReport> {\n  const checks: DoctorCheck[] = []\n\n  // ─── 1. Git installed ───\n  try {\n    const git = simpleGit(projectRoot)\n    const version = await git.version()\n    checks.push({\n      name: 'Git',\n      pass: true,\n      detail: `v${version.major}.${version.minor}.${version.patch}`,\n    })\n  } catch {\n    checks.push({ name: 'Git', pass: false, detail: 'Not installed or not in PATH', severity: 'error' })\n  }\n\n  // ─── 2. Git repo initialized ───\n  const hasGit = await pathExists(join(projectRoot, '.git'))\n  checks.push({\n    name: 'Git repository',\n    pass: hasGit,\n    detail: hasGit ? projectRoot : 'No .git directory found',\n    severity: hasGit ? undefined : 'error',\n  })\n\n  // ─── 3. Node version ───\n  const nodeVersion = process.versions.node\n  const [major] = nodeVersion.split('.').map(Number)\n  const nodePass = (major ?? 0) >= 22\n  checks.push({\n    name: 'Node.js',\n    pass: nodePass,\n    detail: `v${nodeVersion}${nodePass ? '' : ' (requires ≥22)'}`,\n    severity: nodePass ? undefined : 'error',\n  })\n\n  // ─── 4. .contentrain/ structure ───\n  const crDir = contentrainDir(projectRoot)\n  const hasCrDir = await pathExists(crDir)\n  const hasConfig = await pathExists(join(crDir, 'config.json'))\n  const hasModels = await pathExists(join(crDir, 'models'))\n  const hasContent = await pathExists(join(crDir, 'content'))\n  const structurePass = hasCrDir && hasConfig && hasModels && hasContent\n\n  checks.push({\n    name: '.contentrain/ structure',\n    pass: structurePass,\n    detail: !hasCrDir\n      ? 'Not initialized — run `contentrain init`'\n      : [\n          hasConfig ? null : 'missing config.json',\n          hasModels ? null : 'missing models/',\n          hasContent ? null : 'missing content/',\n        ].filter(Boolean).join(', ') || 'OK',\n    severity: structurePass ? undefined : 'error',\n  })\n\n  // ─── 5. Config parseable ───\n  let config: ContentrainConfig | null = null\n  if (hasConfig) {\n    config = await readConfig(projectRoot)\n    checks.push({\n      name: 'Config',\n      pass: config !== null,\n      detail: config\n        ? `stack: ${config.stack}, locales: ${config.locales.supported.join(', ')}`\n        : 'Failed to parse config.json',\n      severity: config ? undefined : 'error',\n    })\n  }\n\n  // ─── 6. Models all parseable ───\n  if (hasCrDir) {\n    try {\n      const models = await listModels(projectRoot)\n      const parseResults = await Promise.all(models.map(m => readModel(projectRoot, m.id)))\n      const allParseable = parseResults.every(r => r !== null)\n      checks.push({\n        name: 'Models',\n        pass: allParseable,\n        detail: `${models.length} model(s)${allParseable ? ', all valid' : ', some failed to parse'}`,\n        severity: allParseable ? undefined : 'error',\n      })\n    } catch {\n      checks.push({ name: 'Models', pass: false, detail: 'Failed to read models', severity: 'error' })\n    }\n  }\n\n  // ─── 7. Orphan content ───\n  if (hasCrDir) {\n    const orphans = await findOrphanContent(projectRoot)\n    checks.push({\n      name: 'Orphan content',\n      pass: orphans.length === 0,\n      detail: orphans.length === 0 ? 'None' : `Found: ${orphans.join(', ')}`,\n      severity: orphans.length === 0 ? undefined : 'warning',\n    })\n  }\n\n  // ─── 8. Stale contentrain branches ───\n  if (hasGit) {\n    try {\n      const health = await checkBranchHealth(projectRoot)\n      checks.push({\n        name: 'Pending branches',\n        pass: !health.blocked && !health.warning,\n        detail: health.message\n          ?? (health.unmerged === 0 ? 'None' : `${health.unmerged} active cr/* branch(es)`),\n        severity: health.blocked ? 'error' : health.warning ? 'warning' : undefined,\n      })\n    } catch {\n      checks.push({ name: 'Pending branches', pass: true, detail: 'Could not check' })\n    }\n  }\n\n  // ─── 9. SDK client freshness ───\n  const clientDir = join(crDir, 'client')\n  const modelsDir = join(crDir, 'models')\n  if (await pathExists(clientDir) && await pathExists(modelsDir)) {\n    try {\n      const [clientStat, modelsStat] = await Promise.all([stat(clientDir), stat(modelsDir)])\n      const fresh = clientStat.mtimeMs >= modelsStat.mtimeMs\n      checks.push({\n        name: 'SDK client',\n        pass: fresh,\n        detail: fresh ? 'Up to date' : 'Stale — run `contentrain generate`',\n        severity: fresh ? undefined : 'warning',\n      })\n    } catch {\n      checks.push({ name: 'SDK client', pass: true, detail: 'Could not check' })\n    }\n  }\n\n  // ─── 10–12. Usage analysis (optional) ───\n  let usage: DoctorUsageAnalysis | undefined\n  if (options.usage && hasCrDir && config) {\n    const [unusedKeys, duplicateValues, missingLocaleKeys] = await Promise.all([\n      analyzeUnusedKeys(projectRoot, config),\n      analyzeDuplicateValues(projectRoot, config),\n      analyzeMissingLocaleKeys(projectRoot, config),\n    ])\n    usage = { unusedKeys, duplicateValues, missingLocaleKeys }\n\n    checks.push({\n      name: 'Unused content keys',\n      pass: unusedKeys.length === 0,\n      detail: unusedKeys.length === 0\n        ? 'All keys referenced in source'\n        : `${unusedKeys.length} key(s) not referenced in source code`,\n      severity: unusedKeys.length === 0 ? undefined : 'warning',\n    })\n\n    checks.push({\n      name: 'Duplicate dictionary values',\n      pass: duplicateValues.length === 0,\n      detail: duplicateValues.length === 0\n        ? 'No duplicate values'\n        : `${duplicateValues.length} value(s) mapped to multiple keys`,\n      severity: duplicateValues.length === 0 ? undefined : 'warning',\n    })\n\n    checks.push({\n      name: 'Locale key coverage',\n      pass: missingLocaleKeys.length === 0,\n      detail: missingLocaleKeys.length === 0\n        ? 'All locales have matching keys'\n        : `${missingLocaleKeys.length} key(s) missing in some locales`,\n      severity: missingLocaleKeys.length === 0 ? undefined : 'warning',\n    })\n  }\n\n  const passed = checks.filter(c => c.pass).length\n  const failed = checks.length - passed\n  const warnings = checks.filter(c => !c.pass && c.severity === 'warning').length\n\n  const report: DoctorReport = {\n    checks,\n    summary: { total: checks.length, passed, failed, warnings },\n  }\n  if (usage) report.usage = usage\n  return report\n}\n\nasync function findOrphanContent(projectRoot: string): Promise<string[]> {\n  const crDir = contentrainDir(projectRoot)\n  const models = await listModels(projectRoot)\n  const orphans: string[] = []\n\n  const knownContentDirs = new Set<string>()\n  for (const m of models) {\n    const full = await readModel(projectRoot, m.id)\n    const modelForPath = full\n      ? {\n          ...full,\n          content_path: full.content_path ?? (m as { content_path?: string }).content_path,\n        }\n      : {\n          id: m.id,\n          name: m.id,\n          kind: m.kind,\n          domain: m.domain,\n          i18n: m.i18n,\n          fields: {},\n          content_path: (m as { content_path?: string }).content_path,\n        }\n    knownContentDirs.add(resolveContentDir(projectRoot, modelForPath))\n  }\n\n  const contentDir = join(crDir, 'content')\n  if (await pathExists(contentDir)) {\n    const domains = await readDir(contentDir)\n    for (const domain of domains) {\n      const domainDir = join(contentDir, domain)\n      const entries = await readDir(domainDir)\n      for (const entry of entries) {\n        if (entry === '.gitkeep') continue\n        const entryDir = join(domainDir, entry)\n        if (!knownContentDirs.has(entryDir)) {\n          orphans.push(`${domain}/${entry}`)\n        }\n      }\n    }\n  }\n\n  for (const dir of knownContentDirs) {\n    if (dir.startsWith(contentDir)) continue\n    if (!await pathExists(dir)) {\n      orphans.push(`(missing custom path) ${dir}`)\n      continue\n    }\n    await readDir(dir)\n  }\n\n  return orphans\n}\n\nasync function analyzeUnusedKeys(\n  projectRoot: string,\n  config: ContentrainConfig,\n): Promise<UnusedKeyEntry[]> {\n  const sourceDirs = await autoDetectSourceDirs(projectRoot)\n  const files = await discoverFiles(projectRoot, { paths: sourceDirs })\n  if (files.length === 0) return []\n\n  const chunks = await Promise.all(\n    files.map(async (relPath) => {\n      const content = await readText(join(projectRoot, relPath))\n      return content ?? ''\n    }),\n  )\n  const allSource = chunks.join('\\n')\n\n  const models = await listModels(projectRoot)\n  const defaultLocale = config.locales.default\n  const unused: UnusedKeyEntry[] = []\n\n  for (const m of models) {\n    const fullModel = await readModel(projectRoot, m.id)\n    if (!fullModel) continue\n\n    const keys = await extractContentKeys(projectRoot, fullModel, defaultLocale)\n    for (const key of keys) {\n      if (!allSource.includes(key)) {\n        unused.push({ model: m.id, kind: m.kind, key, locale: defaultLocale })\n      }\n    }\n  }\n\n  return unused\n}\n\nasync function extractContentKeys(\n  projectRoot: string,\n  model: ModelDefinition,\n  locale: string,\n): Promise<string[]> {\n  const cDir = resolveContentDir(projectRoot, model)\n  if (!await pathExists(cDir)) return []\n\n  switch (model.kind) {\n    case 'dictionary': {\n      const filePath = resolveJsonFilePath(cDir, model, locale)\n      const data = await readJson<Record<string, string>>(filePath)\n      return data ? Object.keys(data) : []\n    }\n    case 'collection': {\n      const filePath = resolveJsonFilePath(cDir, model, locale)\n      const data = await readJson<Record<string, Record<string, unknown>>>(filePath)\n      return data ? Object.keys(data) : []\n    }\n    case 'document': {\n      const strategy = resolveLocaleStrategy(model)\n      const slugs: string[] = []\n      if (!model.i18n) {\n        const files = await readDir(cDir)\n        for (const f of files) if (f.endsWith('.md')) slugs.push(f.replace('.md', ''))\n      } else if (strategy === 'file') {\n        const dirs = await readDir(cDir)\n        for (const d of dirs) if (!d.startsWith('.')) slugs.push(d)\n      } else if (strategy === 'suffix') {\n        const files = await readDir(cDir)\n        const suffix = `.${locale}.md`\n        for (const f of files) if (f.endsWith(suffix)) slugs.push(f.slice(0, -suffix.length))\n      } else if (strategy === 'directory') {\n        const localeDir = join(cDir, locale)\n        if (await pathExists(localeDir)) {\n          const files = await readDir(localeDir)\n          for (const f of files) if (f.endsWith('.md')) slugs.push(f.replace('.md', ''))\n        }\n      } else {\n        const files = await readDir(cDir)\n        for (const f of files) if (f.endsWith('.md')) slugs.push(f.replace('.md', ''))\n      }\n      return slugs\n    }\n    case 'singleton':\n      return []\n    default:\n      return []\n  }\n}\n\nasync function analyzeDuplicateValues(\n  projectRoot: string,\n  config: ContentrainConfig,\n): Promise<DuplicateValueEntry[]> {\n  const models = await listModels(projectRoot)\n  const result: DuplicateValueEntry[] = []\n\n  for (const m of models) {\n    if (m.kind !== 'dictionary') continue\n    const fullModel = await readModel(projectRoot, m.id)\n    if (!fullModel) continue\n\n    const cDir = resolveContentDir(projectRoot, fullModel)\n    for (const locale of config.locales.supported) {\n      const filePath = resolveJsonFilePath(cDir, fullModel, locale)\n      const data = await readJson<Record<string, string>>(filePath)\n      if (!data) continue\n\n      const valueToKeys = new Map<string, string[]>()\n      for (const [key, value] of Object.entries(data)) {\n        const arr = valueToKeys.get(value)\n        if (arr) arr.push(key)\n        else valueToKeys.set(value, [key])\n      }\n\n      for (const [value, keys] of valueToKeys) {\n        if (keys.length > 1) {\n          result.push({ model: m.id, locale, value, keys })\n        }\n      }\n    }\n  }\n\n  return result\n}\n\nasync function analyzeMissingLocaleKeys(\n  projectRoot: string,\n  config: ContentrainConfig,\n): Promise<MissingLocaleEntry[]> {\n  if (config.locales.supported.length < 2) return []\n\n  const models = await listModels(projectRoot)\n  const result: MissingLocaleEntry[] = []\n  const defaultLocale = config.locales.default\n  const otherLocales = config.locales.supported.filter(l => l !== defaultLocale)\n\n  for (const m of models) {\n    if (m.kind !== 'dictionary' && m.kind !== 'collection') continue\n    if (!m.i18n) continue\n\n    const fullModel = await readModel(projectRoot, m.id)\n    if (!fullModel) continue\n\n    const cDir = resolveContentDir(projectRoot, fullModel)\n    const defaultPath = resolveJsonFilePath(cDir, fullModel, defaultLocale)\n    const defaultData = await readJson<Record<string, unknown>>(defaultPath)\n    if (!defaultData) continue\n    const defaultKeys = new Set(Object.keys(defaultData))\n\n    for (const locale of otherLocales) {\n      const localePath = resolveJsonFilePath(cDir, fullModel, locale)\n      const localeData = await readJson<Record<string, unknown>>(localePath)\n      const localeKeys = localeData ? new Set(Object.keys(localeData)) : new Set<string>()\n\n      for (const key of defaultKeys) {\n        if (!localeKeys.has(key)) {\n          result.push({ model: m.id, key, missingIn: locale })\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"mappings":"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"}
+{"version":3,"file":"doctor-Dxu_SzZy.mjs","names":[],"sources":["../src/core/doctor.ts"],"sourcesContent":["import { join } from 'node:path'\nimport { stat } from 'node:fs/promises'\nimport { simpleGit } from 'simple-git'\nimport type { ContentrainConfig, ModelDefinition } from '@contentrain/types'\nimport { readConfig } from './config.js'\nimport { listModels, readModel } from './model-manager.js'\nimport { resolveContentDir, resolveJsonFilePath, resolveLocaleStrategy } from './content-manager.js'\nimport { autoDetectSourceDirs, discoverFiles } from './scan-config.js'\nimport { checkBranchHealth } from '../git/branch-lifecycle.js'\nimport { contentrainDir, pathExists, readDir, readJson, readText } from '../util/fs.js'\n\n/**\n * Doctor — project health report.\n *\n * The public entry point is `runDoctor(projectRoot, { usage? })`. It is\n * inherently local-filesystem work (Node version, git install, file\n * mtimes, orphan directory detection), so the MCP tool surface gates\n * it behind the `localWorktree` capability — same pattern as\n * `contentrain_setup` and normalize.\n *\n * The report is structured JSON so three consumers can share it:\n *\n * - The `contentrain doctor` CLI command pretty-prints the checks.\n * - The Serve UI `/api/doctor` route returns the report to the\n *   Dashboard's Doctor panel.\n * - Automation (CI, Studio) gets a deterministic JSON shape it can\n *   assert against.\n *\n * Usage analysis (`--usage`) is a heavier, opt-in branch — it scans\n * every source file in the repo for content-key references. Kept\n * behind the flag so the default doctor run stays fast.\n */\n\nexport type CheckSeverity = 'error' | 'warning' | 'info'\n\nexport interface DoctorCheck {\n  name: string\n  pass: boolean\n  detail: string\n  /**\n   * `error` — default for failing checks. Blocks a clean bill of health.\n   * `warning` — failing-but-not-blocking (e.g. pending branches above\n   *   threshold, stale SDK client).\n   * `info` — passed check; pure informational.\n   */\n  severity?: CheckSeverity\n}\n\nexport interface UnusedKeyEntry {\n  model: string\n  kind: string\n  key: string\n  locale: string\n}\n\nexport interface DuplicateValueEntry {\n  model: string\n  locale: string\n  value: string\n  keys: string[]\n}\n\nexport interface MissingLocaleEntry {\n  model: string\n  key: string\n  missingIn: string\n}\n\nexport interface DoctorUsageAnalysis {\n  unusedKeys: UnusedKeyEntry[]\n  duplicateValues: DuplicateValueEntry[]\n  missingLocaleKeys: MissingLocaleEntry[]\n}\n\nexport interface DoctorReport {\n  checks: DoctorCheck[]\n  summary: {\n    total: number\n    passed: number\n    failed: number\n    warnings: number\n  }\n  /** Present only when `options.usage === true`. */\n  usage?: DoctorUsageAnalysis\n}\n\nexport interface RunDoctorOptions {\n  /** Run heavier `--usage` analysis (unused keys, duplicates, locale gaps). */\n  usage?: boolean\n}\n\nexport async function runDoctor(\n  projectRoot: string,\n  options: RunDoctorOptions = {},\n): Promise<DoctorReport> {\n  const checks: DoctorCheck[] = []\n\n  // ─── 1. Git installed ───\n  try {\n    const git = simpleGit(projectRoot)\n    const version = await git.version()\n    checks.push({\n      name: 'Git',\n      pass: true,\n      detail: `v${version.major}.${version.minor}.${version.patch}`,\n    })\n  } catch {\n    checks.push({ name: 'Git', pass: false, detail: 'Not installed or not in PATH', severity: 'error' })\n  }\n\n  // ─── 2. Git repo initialized ───\n  const hasGit = await pathExists(join(projectRoot, '.git'))\n  checks.push({\n    name: 'Git repository',\n    pass: hasGit,\n    detail: hasGit ? projectRoot : 'No .git directory found',\n    severity: hasGit ? undefined : 'error',\n  })\n\n  // ─── 3. Node version ───\n  const nodeVersion = process.versions.node\n  const [major] = nodeVersion.split('.').map(Number)\n  const nodePass = (major ?? 0) >= 22\n  checks.push({\n    name: 'Node.js',\n    pass: nodePass,\n    detail: `v${nodeVersion}${nodePass ? '' : ' (requires ≥22)'}`,\n    severity: nodePass ? undefined : 'error',\n  })\n\n  // ─── 4. .contentrain/ structure ───\n  const crDir = contentrainDir(projectRoot)\n  const hasCrDir = await pathExists(crDir)\n  const hasConfig = await pathExists(join(crDir, 'config.json'))\n  const hasModels = await pathExists(join(crDir, 'models'))\n  const hasContent = await pathExists(join(crDir, 'content'))\n  const structurePass = hasCrDir && hasConfig && hasModels && hasContent\n\n  checks.push({\n    name: '.contentrain/ structure',\n    pass: structurePass,\n    detail: !hasCrDir\n      ? 'Not initialized — run `contentrain init`'\n      : [\n          hasConfig ? null : 'missing config.json',\n          hasModels ? null : 'missing models/',\n          hasContent ? null : 'missing content/',\n        ].filter(Boolean).join(', ') || 'OK',\n    severity: structurePass ? undefined : 'error',\n  })\n\n  // ─── 5. Config parseable ───\n  let config: ContentrainConfig | null = null\n  if (hasConfig) {\n    config = await readConfig(projectRoot)\n    checks.push({\n      name: 'Config',\n      pass: config !== null,\n      detail: config\n        ? `stack: ${config.stack}, locales: ${config.locales.supported.join(', ')}`\n        : 'Failed to parse config.json',\n      severity: config ? undefined : 'error',\n    })\n  }\n\n  // ─── 6. Models all parseable ───\n  if (hasCrDir) {\n    try {\n      const models = await listModels(projectRoot)\n      const parseResults = await Promise.all(models.map(m => readModel(projectRoot, m.id)))\n      const allParseable = parseResults.every(r => r !== null)\n      checks.push({\n        name: 'Models',\n        pass: allParseable,\n        detail: `${models.length} model(s)${allParseable ? ', all valid' : ', some failed to parse'}`,\n        severity: allParseable ? undefined : 'error',\n      })\n    } catch {\n      checks.push({ name: 'Models', pass: false, detail: 'Failed to read models', severity: 'error' })\n    }\n  }\n\n  // ─── 7. Orphan content ───\n  if (hasCrDir) {\n    const orphans = await findOrphanContent(projectRoot)\n    checks.push({\n      name: 'Orphan content',\n      pass: orphans.length === 0,\n      detail: orphans.length === 0 ? 'None' : `Found: ${orphans.join(', ')}`,\n      severity: orphans.length === 0 ? undefined : 'warning',\n    })\n  }\n\n  // ─── 8. Stale contentrain branches ───\n  if (hasGit) {\n    try {\n      const health = await checkBranchHealth(projectRoot)\n      checks.push({\n        name: 'Pending branches',\n        pass: !health.blocked && !health.warning,\n        detail: health.message\n          ?? (health.unmerged === 0 ? 'None' : `${health.unmerged} active cr/* branch(es)`),\n        severity: health.blocked ? 'error' : health.warning ? 'warning' : undefined,\n      })\n    } catch {\n      checks.push({ name: 'Pending branches', pass: true, detail: 'Could not check' })\n    }\n  }\n\n  // ─── 9. SDK client freshness ───\n  const clientDir = join(crDir, 'client')\n  const modelsDir = join(crDir, 'models')\n  if (await pathExists(clientDir) && await pathExists(modelsDir)) {\n    try {\n      const [clientStat, modelsStat] = await Promise.all([stat(clientDir), stat(modelsDir)])\n      const fresh = clientStat.mtimeMs >= modelsStat.mtimeMs\n      checks.push({\n        name: 'SDK client',\n        pass: fresh,\n        detail: fresh ? 'Up to date' : 'Stale — run `contentrain generate`',\n        severity: fresh ? undefined : 'warning',\n      })\n    } catch {\n      checks.push({ name: 'SDK client', pass: true, detail: 'Could not check' })\n    }\n  }\n\n  // ─── 10–12. Usage analysis (optional) ───\n  let usage: DoctorUsageAnalysis | undefined\n  if (options.usage && hasCrDir && config) {\n    const [unusedKeys, duplicateValues, missingLocaleKeys] = await Promise.all([\n      analyzeUnusedKeys(projectRoot, config),\n      analyzeDuplicateValues(projectRoot, config),\n      analyzeMissingLocaleKeys(projectRoot, config),\n    ])\n    usage = { unusedKeys, duplicateValues, missingLocaleKeys }\n\n    checks.push({\n      name: 'Unused content keys',\n      pass: unusedKeys.length === 0,\n      detail: unusedKeys.length === 0\n        ? 'All keys referenced in source'\n        : `${unusedKeys.length} key(s) not referenced in source code`,\n      severity: unusedKeys.length === 0 ? undefined : 'warning',\n    })\n\n    checks.push({\n      name: 'Duplicate dictionary values',\n      pass: duplicateValues.length === 0,\n      detail: duplicateValues.length === 0\n        ? 'No duplicate values'\n        : `${duplicateValues.length} value(s) mapped to multiple keys`,\n      severity: duplicateValues.length === 0 ? undefined : 'warning',\n    })\n\n    checks.push({\n      name: 'Locale key coverage',\n      pass: missingLocaleKeys.length === 0,\n      detail: missingLocaleKeys.length === 0\n        ? 'All locales have matching keys'\n        : `${missingLocaleKeys.length} key(s) missing in some locales`,\n      severity: missingLocaleKeys.length === 0 ? undefined : 'warning',\n    })\n  }\n\n  const passed = checks.filter(c => c.pass).length\n  const failed = checks.length - passed\n  const warnings = checks.filter(c => !c.pass && c.severity === 'warning').length\n\n  const report: DoctorReport = {\n    checks,\n    summary: { total: checks.length, passed, failed, warnings },\n  }\n  if (usage) report.usage = usage\n  return report\n}\n\nasync function findOrphanContent(projectRoot: string): Promise<string[]> {\n  const crDir = contentrainDir(projectRoot)\n  const models = await listModels(projectRoot)\n  const orphans: string[] = []\n\n  const knownContentDirs = new Set<string>()\n  for (const m of models) {\n    const full = await readModel(projectRoot, m.id)\n    const modelForPath = full\n      ? {\n          ...full,\n          content_path: full.content_path ?? (m as { content_path?: string }).content_path,\n        }\n      : {\n          id: m.id,\n          name: m.id,\n          kind: m.kind,\n          domain: m.domain,\n          i18n: m.i18n,\n          fields: {},\n          content_path: (m as { content_path?: string }).content_path,\n        }\n    knownContentDirs.add(resolveContentDir(projectRoot, modelForPath))\n  }\n\n  const contentDir = join(crDir, 'content')\n  if (await pathExists(contentDir)) {\n    const domains = await readDir(contentDir)\n    for (const domain of domains) {\n      const domainDir = join(contentDir, domain)\n      const entries = await readDir(domainDir)\n      for (const entry of entries) {\n        if (entry === '.gitkeep') continue\n        const entryDir = join(domainDir, entry)\n        if (!knownContentDirs.has(entryDir)) {\n          orphans.push(`${domain}/${entry}`)\n        }\n      }\n    }\n  }\n\n  for (const dir of knownContentDirs) {\n    if (dir.startsWith(contentDir)) continue\n    if (!await pathExists(dir)) {\n      orphans.push(`(missing custom path) ${dir}`)\n      continue\n    }\n    await readDir(dir)\n  }\n\n  return orphans\n}\n\nasync function analyzeUnusedKeys(\n  projectRoot: string,\n  config: ContentrainConfig,\n): Promise<UnusedKeyEntry[]> {\n  const sourceDirs = await autoDetectSourceDirs(projectRoot)\n  const files = await discoverFiles(projectRoot, { paths: sourceDirs })\n  if (files.length === 0) return []\n\n  const chunks = await Promise.all(\n    files.map(async (relPath) => {\n      const content = await readText(join(projectRoot, relPath))\n      return content ?? ''\n    }),\n  )\n  const allSource = chunks.join('\\n')\n\n  const models = await listModels(projectRoot)\n  const defaultLocale = config.locales.default\n  const unused: UnusedKeyEntry[] = []\n\n  for (const m of models) {\n    const fullModel = await readModel(projectRoot, m.id)\n    if (!fullModel) continue\n\n    const keys = await extractContentKeys(projectRoot, fullModel, defaultLocale)\n    for (const key of keys) {\n      if (!allSource.includes(key)) {\n        unused.push({ model: m.id, kind: m.kind, key, locale: defaultLocale })\n      }\n    }\n  }\n\n  return unused\n}\n\nasync function extractContentKeys(\n  projectRoot: string,\n  model: ModelDefinition,\n  locale: string,\n): Promise<string[]> {\n  const cDir = resolveContentDir(projectRoot, model)\n  if (!await pathExists(cDir)) return []\n\n  switch (model.kind) {\n    case 'dictionary': {\n      const filePath = resolveJsonFilePath(cDir, model, locale)\n      const data = await readJson<Record<string, string>>(filePath)\n      return data ? Object.keys(data) : []\n    }\n    case 'collection': {\n      const filePath = resolveJsonFilePath(cDir, model, locale)\n      const data = await readJson<Record<string, Record<string, unknown>>>(filePath)\n      return data ? Object.keys(data) : []\n    }\n    case 'document': {\n      const strategy = resolveLocaleStrategy(model)\n      const slugs: string[] = []\n      if (!model.i18n) {\n        const files = await readDir(cDir)\n        for (const f of files) if (f.endsWith('.md')) slugs.push(f.replace('.md', ''))\n      } else if (strategy === 'file') {\n        const dirs = await readDir(cDir)\n        for (const d of dirs) if (!d.startsWith('.')) slugs.push(d)\n      } else if (strategy === 'suffix') {\n        const files = await readDir(cDir)\n        const suffix = `.${locale}.md`\n        for (const f of files) if (f.endsWith(suffix)) slugs.push(f.slice(0, -suffix.length))\n      } else if (strategy === 'directory') {\n        const localeDir = join(cDir, locale)\n        if (await pathExists(localeDir)) {\n          const files = await readDir(localeDir)\n          for (const f of files) if (f.endsWith('.md')) slugs.push(f.replace('.md', ''))\n        }\n      } else {\n        const files = await readDir(cDir)\n        for (const f of files) if (f.endsWith('.md')) slugs.push(f.replace('.md', ''))\n      }\n      return slugs\n    }\n    case 'singleton':\n      return []\n    default:\n      return []\n  }\n}\n\nasync function analyzeDuplicateValues(\n  projectRoot: string,\n  config: ContentrainConfig,\n): Promise<DuplicateValueEntry[]> {\n  const models = await listModels(projectRoot)\n  const result: DuplicateValueEntry[] = []\n\n  for (const m of models) {\n    if (m.kind !== 'dictionary') continue\n    const fullModel = await readModel(projectRoot, m.id)\n    if (!fullModel) continue\n\n    const cDir = resolveContentDir(projectRoot, fullModel)\n    for (const locale of config.locales.supported) {\n      const filePath = resolveJsonFilePath(cDir, fullModel, locale)\n      const data = await readJson<Record<string, string>>(filePath)\n      if (!data) continue\n\n      const valueToKeys = new Map<string, string[]>()\n      for (const [key, value] of Object.entries(data)) {\n        const arr = valueToKeys.get(value)\n        if (arr) arr.push(key)\n        else valueToKeys.set(value, [key])\n      }\n\n      for (const [value, keys] of valueToKeys) {\n        if (keys.length > 1) {\n          result.push({ model: m.id, locale, value, keys })\n        }\n      }\n    }\n  }\n\n  return result\n}\n\nasync function analyzeMissingLocaleKeys(\n  projectRoot: string,\n  config: ContentrainConfig,\n): Promise<MissingLocaleEntry[]> {\n  if (config.locales.supported.length < 2) return []\n\n  const models = await listModels(projectRoot)\n  const result: MissingLocaleEntry[] = []\n  const defaultLocale = config.locales.default\n  const otherLocales = config.locales.supported.filter(l => l !== defaultLocale)\n\n  for (const m of models) {\n    if (m.kind !== 'dictionary' && m.kind !== 'collection') continue\n    if (!m.i18n) continue\n\n    const fullModel = await readModel(projectRoot, m.id)\n    if (!fullModel) continue\n\n    const cDir = resolveContentDir(projectRoot, fullModel)\n    const defaultPath = resolveJsonFilePath(cDir, fullModel, defaultLocale)\n    const defaultData = await readJson<Record<string, unknown>>(defaultPath)\n    if (!defaultData) continue\n    const defaultKeys = new Set(Object.keys(defaultData))\n\n    for (const locale of otherLocales) {\n      const localePath = resolveJsonFilePath(cDir, fullModel, locale)\n      const localeData = await readJson<Record<string, unknown>>(localePath)\n      const localeKeys = localeData ? new Set(Object.keys(localeData)) : new Set<string>()\n\n      for (const key of defaultKeys) {\n        if (!localeKeys.has(key)) {\n          result.push({ model: m.id, key, missingIn: locale })\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"mappings":"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"}

package/dist/git/branch-lifecycle.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"branch-lifecycle.d.mts","names":[],"sources":["../../src/git/branch-lifecycle.ts"],"mappings":";UAIiB,aAAA;EACf,OAAA;EACA,SAAA;EACA,eAAA;AAAA;AAAA,UAGe,iBAAA;EACf,KAAA;EACA,MAAA;EACA,QAAA;EACA,OAAA;EACA,OAAA;EACA,OAAA;AAAA;;;;;iBAOoB,qBAAA,CAAsB,WAAA,WAAsB,OAAA,CAAQ,aAAA;;;;;AAA1E;iBAqEsB,iBAAA,CAAkB,WAAA,WAAsB,OAAA,CAAQ,iBAAA;AAAA,UAiDrD,gBAAA;EAtHwD;EAwHvE,MAAA;EAxHgE;EA0HhE,IAAA;EA1HqF;EA4HrF,IAAA;EAvDoB;EAyDpB,KAAA;;EAEA,YAAA;AAAA;;;;;AAVF;;;;;;;;;iBA0BsB,UAAA,CACpB,WAAA,UACA,IAAA;EAAQ,MAAA;EAAgB,IAAA;AAAA,IACvB,OAAA,CAAQ,gBAAA"}
+{"version":3,"file":"branch-lifecycle.d.mts","names":[],"sources":["../../src/git/branch-lifecycle.ts"],"mappings":";UAIiB,aAAA;EACf,OAAA;EACA,SAAA;EACA,eAAA;AAAA;AAAA,UAGe,iBAAA;EACf,KAAA;EACA,MAAA;EACA,QAAA;EACA,OAAA;EACA,OAAA;EACA,OAAA;AAAA;;;;;iBAOoB,qBAAA,CAAsB,WAAA,WAAsB,OAAA,CAAQ,aAAA;;;;;AAA1E;iBAqEsB,iBAAA,CAAkB,WAAA,WAAsB,OAAA,CAAQ,iBAAA;AAAA,UAmDrD,gBAAA;EAxHwD;EA0HvE,MAAA;EA1HgE;EA4HhE,IAAA;EA5HqF;EA8HrF,IAAA;EAzDoB;EA2DpB,KAAA;;EAEA,YAAA;AAAA;;;;;AAVF;;;;;;;;;iBA0BsB,UAAA,CACpB,WAAA,UACA,IAAA;EAAQ,MAAA;EAAgB,IAAA;AAAA,IACvB,OAAA,CAAQ,gBAAA"}

package/dist/git/branch-lifecycle.mjs

@@ -1,4 +1,4 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../config-BIl5Ybj0.mjs";
-import { n as checkBranchHealth, r as cleanupMergedBranches, t as branchDiff } from "../branch-lifecycle-CFVpTpNT.mjs";
+import "../config-Lw7vpK9n.mjs";
+import { n as checkBranchHealth, r as cleanupMergedBranches, t as branchDiff } from "../branch-lifecycle-DjX3MXNG.mjs";
 export { branchDiff, checkBranchHealth, cleanupMergedBranches };

package/dist/git/transaction.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.mts","names":[],"sources":["../../src/git/transaction.ts"],"mappings":";;;UAYiB,aAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,UAGe,cAAA;EACf,QAAA;EACA,MAAA;EACA,KAAA,CAAM,QAAA,GAAW,YAAA,aAAyB,OAAA,SAAgB,OAAA;EAC1D,MAAA,CAAO,OAAA,UAAiB,aAAA,GAAgB,aAAA,GAAgB,OAAA;EACxD,QAAA,IAAY,OAAA;IAAU,MAAA;IAA0C,MAAA;IAAgB,IAAA,GAAO,UAAA;IAAY,OAAA;EAAA;EACnG,OAAA,IAAW,OAAA;AAAA;AAAA,iBAGS,mBAAA,CAAoB,WAAA,WAAsB,OAAA;AAAA,iBAkH1C,iBAAA,CACpB,WAAA,UACA,UAAA,UACA,OAAA;EAAY,gBAAA,GAAmB,YAAA;AAAA,IAC9B,OAAA,CAAQ,cAAA;AAAA,iBA0NW,WAAA,CACpB,WAAA,UACA,UAAA,WACC,OAAA;EAAU,MAAA;EAAkB,MAAA;EAAgB,IAAA,EAAM,UAAA;AAAA;AAAA,iBA0HrC,eAAA,CAAgB,KAAA,UAAe,MAAA,UAAgB,MAAA"}
+{"version":3,"file":"transaction.d.mts","names":[],"sources":["../../src/git/transaction.ts"],"mappings":";;;UAYiB,aAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,UAGe,cAAA;EACf,QAAA;EACA,MAAA;EACA,KAAA,CAAM,QAAA,GAAW,YAAA,aAAyB,OAAA,SAAgB,OAAA;EAC1D,MAAA,CAAO,OAAA,UAAiB,aAAA,GAAgB,aAAA,GAAgB,OAAA;EACxD,QAAA,IAAY,OAAA;IAAU,MAAA;IAA0C,MAAA;IAAgB,IAAA,GAAO,UAAA;IAAY,OAAA;EAAA;EACnG,OAAA,IAAW,OAAA;AAAA;AAAA,iBAGS,mBAAA,CAAoB,WAAA,WAAsB,OAAA;AAAA,iBAkH1C,iBAAA,CACpB,WAAA,UACA,UAAA,UACA,OAAA;EAAY,gBAAA,GAAmB,YAAA;AAAA,IAC9B,OAAA,CAAQ,cAAA;AAAA,iBA8OW,WAAA,CACpB,WAAA,UACA,UAAA,WACC,OAAA;EAAU,MAAA;EAAkB,MAAA;EAAgB,IAAA,EAAM,UAAA;AAAA;AAAA,iBAkIrC,eAAA,CAAgB,KAAA,UAAe,MAAA,UAAgB,MAAA"}

package/dist/git/transaction.mjs

@@ -1,9 +1,9 @@
 import "../serialization-B1CEzR4H.mjs";
 import "../fs-DLbVB-Ek.mjs";
-import "../config-BIl5Ybj0.mjs";
+import "../config-Lw7vpK9n.mjs";
 import "../model-manager-BhLsUgaB.mjs";
 import "../meta-manager-C900rEyG.mjs";
-import "../context-J0OU9Nfp.mjs";
+import "../context-DS40WOdw.mjs";
 import "../id-CIO9s0x_.mjs";
-import { i as mergeBranch, n as createTransaction, r as ensureContentBranch, t as buildBranchName } from "../transaction-DgkNgWSI.mjs";
+import { i as mergeBranch, n as createTransaction, r as ensureContentBranch, t as buildBranchName } from "../transaction-0D_edyh0.mjs";
 export { buildBranchName, createTransaction, ensureContentBranch, mergeBranch };

package/dist/index.mjs

@@ -3,24 +3,24 @@ import "./contracts-DfL0BfrD.mjs";
 import "./ops-DjEWi5Wa.mjs";
 import "./serialization-B1CEzR4H.mjs";
 import "./fs-DLbVB-Ek.mjs";
-import "./config-BIl5Ybj0.mjs";
+import "./config-Lw7vpK9n.mjs";
 import "./model-manager-BhLsUgaB.mjs";
 import "./meta-manager-C900rEyG.mjs";
-import "./context-J0OU9Nfp.mjs";
+import "./context-DS40WOdw.mjs";
 import "./id-CIO9s0x_.mjs";
-import "./transaction-DgkNgWSI.mjs";
-import "./local-DvP4Y4T-.mjs";
+import "./transaction-0D_edyh0.mjs";
+import "./local-BEl5L7p5.mjs";
 import "./detect-DL9mFmaS.mjs";
-import "./branch-lifecycle-CFVpTpNT.mjs";
-import "./annotations-Clhbw2lh.mjs";
-import { t as createServer } from "./server-B1OJrUQ9.mjs";
-import "./validator-B0nNRFeU.mjs";
+import "./branch-lifecycle-DjX3MXNG.mjs";
+import "./annotations-BFJbfSKe.mjs";
+import { t as createServer } from "./server-BiiVUjgs.mjs";
+import "./validator-BX2ou7V-.mjs";
 import "./scan-config-jC6XmiqF.mjs";
 import "./graph-builder-DXv2JEp-.mjs";
 import "./scanner-DKMwc03k.mjs";
 import "./tsx-parser-CQc6nr-o.mjs";
-import "./apply-manager-D5ym5Jba.mjs";
-import "./doctor-CgBoT6h1.mjs";
+import "./apply-manager-CDss8ZIr.mjs";
+import "./doctor-Dxu_SzZy.mjs";
 import { resolve } from "node:path";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 //#region src/index.ts

package/dist/{local-DvP4Y4T-.mjs → local-BEl5L7p5.mjs}

@@ -1,8 +1,8 @@
 import { t as LOCAL_CAPABILITIES } from "./contracts-DfL0BfrD.mjs";
 import { a as applyChangesToWorktree } from "./ops-DjEWi5Wa.mjs";
-import { t as readConfig } from "./config-BIl5Ybj0.mjs";
+import { t as readConfig } from "./config-Lw7vpK9n.mjs";
 import { C as LocalReader } from "./model-manager-BhLsUgaB.mjs";
-import { i as mergeBranch$1, n as createTransaction } from "./transaction-DgkNgWSI.mjs";
+import { i as mergeBranch$1, n as createTransaction } from "./transaction-0D_edyh0.mjs";
 import { CONTENTRAIN_BRANCH } from "@contentrain/types";
 import { simpleGit } from "simple-git";
 //#region src/providers/local/branch-ops.ts
@@ -177,6 +177,6 @@ var LocalProvider = class {
 	}
 };
 //#endregion
-export { LocalProvider as t };
+export { isMerged as n, LocalProvider as t };
 
-//# sourceMappingURL=local-DvP4Y4T-.mjs.map
+//# sourceMappingURL=local-BEl5L7p5.mjs.map

package/dist/{local-DvP4Y4T-.mjs.map → local-BEl5L7p5.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"local-DvP4Y4T-.mjs","names":["mergeBranchOp","listBranchesOp","createBranchOp","deleteBranchOp","getBranchDiffOp","mergeBranchOp","isMergedOp","getDefaultBranchOp"],"sources":["../src/providers/local/branch-ops.ts","../src/providers/local/provider.ts"],"sourcesContent":["import { simpleGit } from 'simple-git'\nimport { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport type { Branch, FileDiff, MergeResult } from '../../core/contracts/index.js'\nimport { readConfig } from '../../core/config.js'\nimport { mergeBranch as mergeBranchOp } from '../../git/transaction.js'\n\n/**\n * Branch/merge/diff helpers backed by the local simple-git worktree flow.\n *\n * Pure functions composed into `LocalProvider` — mirroring the shape of\n * `providers/github/branch-ops.ts` so the two providers share the same\n * surface at the `RepoProvider` boundary.\n */\n\nexport async function getDefaultBranch(projectRoot: string): Promise<string> {\n  const config = await readConfig(projectRoot)\n  if (config?.repository?.default_branch) return config.repository.default_branch\n  const envBranch = process.env['CONTENTRAIN_BRANCH']\n  if (envBranch) return envBranch\n  const git = simpleGit(projectRoot)\n  const current = (await git.raw(['branch', '--show-current'])).trim()\n  return current || 'main'\n}\n\nexport async function listBranches(\n  projectRoot: string,\n  prefix?: string,\n): Promise<Branch[]> {\n  const git = simpleGit(projectRoot)\n  const summary = await git.branchLocal()\n  const names = prefix\n    ? summary.all.filter(n => n.startsWith(prefix))\n    : summary.all\n  const branches: Branch[] = []\n  for (const name of names) {\n    const info = summary.branches[name]\n    branches.push({ name, sha: info?.commit ?? '' })\n  }\n  return branches\n}\n\nexport async function createBranch(\n  projectRoot: string,\n  name: string,\n  fromRef: string,\n): Promise<void> {\n  const git = simpleGit(projectRoot)\n  await git.raw(['branch', name, fromRef])\n}\n\nexport async function deleteBranch(\n  projectRoot: string,\n  name: string,\n): Promise<void> {\n  const git = simpleGit(projectRoot)\n  await git.deleteLocalBranch(name, true)\n}\n\nexport async function getBranchDiff(\n  projectRoot: string,\n  branch: string,\n  base: string,\n): Promise<FileDiff[]> {\n  const git = simpleGit(projectRoot)\n  const raw = await git.raw(['diff', '--name-status', `${base}...${branch}`])\n  const diffs: FileDiff[] = []\n  for (const line of raw.split('\\n')) {\n    if (!line.trim()) continue\n    const [code, ...pathParts] = line.split('\\t')\n    const path = pathParts[pathParts.length - 1]\n    if (!code || !path) continue\n    const status: FileDiff['status'] = code.startsWith('A')\n      ? 'added'\n      : code.startsWith('D')\n        ? 'removed'\n        : 'modified'\n    diffs.push({ path, status, before: null, after: null })\n  }\n  return diffs\n}\n\nexport async function mergeBranch(\n  projectRoot: string,\n  branch: string,\n  into: string,\n): Promise<MergeResult> {\n  if (into !== CONTENTRAIN_BRANCH) {\n    throw Object.assign(new Error(\n      `LocalProvider.mergeBranch only supports merging into \"${CONTENTRAIN_BRANCH}\" (got \"${into}\"). `\n      + `The local flow merges feature branches into the content-tracking branch and fast-forwards the base branch via update-ref.`,\n    ), {\n      code: 'UNSUPPORTED_MERGE_TARGET',\n      agent_hint: `Pass \"${CONTENTRAIN_BRANCH}\" as the merge target, or use a non-local provider that supports arbitrary targets.`,\n      developer_action: `Merge \"${branch}\" into \"${CONTENTRAIN_BRANCH}\" instead.`,\n    })\n  }\n  const result = await mergeBranchOp(projectRoot, branch)\n  return {\n    merged: true,\n    sha: result.commit,\n    pullRequestUrl: null,\n    sync: result.sync,\n  }\n}\n\nexport async function isMerged(\n  projectRoot: string,\n  branch: string,\n  into: string,\n): Promise<boolean> {\n  const git = simpleGit(projectRoot)\n  try {\n    const raw = await git.raw(['branch', '--merged', into])\n    const merged = new Set(\n      raw.split('\\n').map(b => b.replace(/^\\*?\\s+/, '').trim()).filter(Boolean),\n    )\n    return merged.has(branch)\n  } catch {\n    return false\n  }\n}\n","import { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport type {\n  Branch,\n  FileDiff,\n  MergeResult,\n  ProviderCapabilities,\n  RepoProvider,\n} from '../../core/contracts/index.js'\nimport { LOCAL_CAPABILITIES } from '../../core/contracts/index.js'\nimport { applyChangesToWorktree } from '../../core/ops/index.js'\nimport { createTransaction } from '../../git/transaction.js'\nimport {\n  createBranch as createBranchOp,\n  deleteBranch as deleteBranchOp,\n  getBranchDiff as getBranchDiffOp,\n  getDefaultBranch as getDefaultBranchOp,\n  isMerged as isMergedOp,\n  listBranches as listBranchesOp,\n  mergeBranch as mergeBranchOp,\n} from './branch-ops.js'\nimport { LocalReader } from './reader.js'\nimport type { LocalApplyPlanInput, LocalApplyResult } from './types.js'\n\nconst DEFAULT_AUTHOR_NAME = 'Contentrain'\nconst DEFAULT_AUTHOR_EMAIL = 'mcp@contentrain.io'\n\n/**\n * LocalProvider — the local-filesystem, worktree-backed content provider.\n *\n * Implements the full `RepoProvider` surface:\n * - Reader methods delegate to `LocalReader`.\n * - `applyPlan` wraps `createTransaction` and returns `LocalApplyResult`\n *   (a superset of `Commit` carrying workflow action + selective sync).\n * - Branch ops mirror `GitHubProvider` — thin wrappers over the local\n *   simple-git helpers in `./branch-ops.ts`.\n *\n * `mergeBranch` only supports merging into the singleton\n * `CONTENTRAIN_BRANCH`; the local flow advances the base branch via\n * `update-ref` in `transaction.mergeBranch`, so arbitrary merge targets\n * would bypass that invariant.\n */\nexport class LocalProvider implements RepoProvider {\n  readonly capabilities: ProviderCapabilities = LOCAL_CAPABILITIES\n  private readonly reader: LocalReader\n\n  constructor(public readonly projectRoot: string) {\n    this.reader = new LocalReader(projectRoot)\n  }\n\n  readFile(path: string, ref?: string): Promise<string> {\n    return this.reader.readFile(path, ref)\n  }\n\n  listDirectory(path: string, ref?: string): Promise<string[]> {\n    return this.reader.listDirectory(path, ref)\n  }\n\n  fileExists(path: string, ref?: string): Promise<boolean> {\n    return this.reader.fileExists(path, ref)\n  }\n\n  async applyPlan(input: LocalApplyPlanInput): Promise<LocalApplyResult> {\n    const tx = await createTransaction(this.projectRoot, input.branch, {\n      workflowOverride: input.workflowOverride,\n    })\n    try {\n      await tx.write(async (wt) => {\n        await applyChangesToWorktree(wt, input.changes)\n      })\n      await tx.commit(input.message, input.context)\n      const gitResult = await tx.complete()\n      return {\n        sha: gitResult.commit,\n        message: input.message,\n        author: {\n          name: process.env['CONTENTRAIN_AUTHOR_NAME'] ?? DEFAULT_AUTHOR_NAME,\n          email: process.env['CONTENTRAIN_AUTHOR_EMAIL'] ?? DEFAULT_AUTHOR_EMAIL,\n        },\n        timestamp: new Date().toISOString(),\n        workflowAction: gitResult.action,\n        sync: gitResult.sync,\n        warning: gitResult.warning,\n      }\n    } finally {\n      await tx.cleanup()\n    }\n  }\n\n  listBranches(prefix?: string): Promise<Branch[]> {\n    return listBranchesOp(this.projectRoot, prefix)\n  }\n\n  async createBranch(name: string, fromRef?: string): Promise<void> {\n    const resolved = fromRef ?? CONTENTRAIN_BRANCH\n    await createBranchOp(this.projectRoot, name, resolved)\n  }\n\n  deleteBranch(name: string): Promise<void> {\n    return deleteBranchOp(this.projectRoot, name)\n  }\n\n  getBranchDiff(branch: string, base?: string): Promise<FileDiff[]> {\n    const resolved = base ?? CONTENTRAIN_BRANCH\n    return getBranchDiffOp(this.projectRoot, branch, resolved)\n  }\n\n  mergeBranch(branch: string, into: string): Promise<MergeResult> {\n    return mergeBranchOp(this.projectRoot, branch, into)\n  }\n\n  isMerged(branch: string, into?: string): Promise<boolean> {\n    const resolved = into ?? CONTENTRAIN_BRANCH\n    return isMergedOp(this.projectRoot, branch, resolved)\n  }\n\n  getDefaultBranch(): Promise<string> {\n    return getDefaultBranchOp(this.projectRoot)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"local-BEl5L7p5.mjs","names":["mergeBranchOp","listBranchesOp","createBranchOp","deleteBranchOp","getBranchDiffOp","mergeBranchOp","isMergedOp","getDefaultBranchOp"],"sources":["../src/providers/local/branch-ops.ts","../src/providers/local/provider.ts"],"sourcesContent":["import { simpleGit } from 'simple-git'\nimport { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport type { Branch, FileDiff, MergeResult } from '../../core/contracts/index.js'\nimport { readConfig } from '../../core/config.js'\nimport { mergeBranch as mergeBranchOp } from '../../git/transaction.js'\n\n/**\n * Branch/merge/diff helpers backed by the local simple-git worktree flow.\n *\n * Pure functions composed into `LocalProvider` — mirroring the shape of\n * `providers/github/branch-ops.ts` so the two providers share the same\n * surface at the `RepoProvider` boundary.\n */\n\nexport async function getDefaultBranch(projectRoot: string): Promise<string> {\n  const config = await readConfig(projectRoot)\n  if (config?.repository?.default_branch) return config.repository.default_branch\n  const envBranch = process.env['CONTENTRAIN_BRANCH']\n  if (envBranch) return envBranch\n  const git = simpleGit(projectRoot)\n  const current = (await git.raw(['branch', '--show-current'])).trim()\n  return current || 'main'\n}\n\nexport async function listBranches(\n  projectRoot: string,\n  prefix?: string,\n): Promise<Branch[]> {\n  const git = simpleGit(projectRoot)\n  const summary = await git.branchLocal()\n  const names = prefix\n    ? summary.all.filter(n => n.startsWith(prefix))\n    : summary.all\n  const branches: Branch[] = []\n  for (const name of names) {\n    const info = summary.branches[name]\n    branches.push({ name, sha: info?.commit ?? '' })\n  }\n  return branches\n}\n\nexport async function createBranch(\n  projectRoot: string,\n  name: string,\n  fromRef: string,\n): Promise<void> {\n  const git = simpleGit(projectRoot)\n  await git.raw(['branch', name, fromRef])\n}\n\nexport async function deleteBranch(\n  projectRoot: string,\n  name: string,\n): Promise<void> {\n  const git = simpleGit(projectRoot)\n  await git.deleteLocalBranch(name, true)\n}\n\nexport async function getBranchDiff(\n  projectRoot: string,\n  branch: string,\n  base: string,\n): Promise<FileDiff[]> {\n  const git = simpleGit(projectRoot)\n  const raw = await git.raw(['diff', '--name-status', `${base}...${branch}`])\n  const diffs: FileDiff[] = []\n  for (const line of raw.split('\\n')) {\n    if (!line.trim()) continue\n    const [code, ...pathParts] = line.split('\\t')\n    const path = pathParts[pathParts.length - 1]\n    if (!code || !path) continue\n    const status: FileDiff['status'] = code.startsWith('A')\n      ? 'added'\n      : code.startsWith('D')\n        ? 'removed'\n        : 'modified'\n    diffs.push({ path, status, before: null, after: null })\n  }\n  return diffs\n}\n\nexport async function mergeBranch(\n  projectRoot: string,\n  branch: string,\n  into: string,\n): Promise<MergeResult> {\n  if (into !== CONTENTRAIN_BRANCH) {\n    throw Object.assign(new Error(\n      `LocalProvider.mergeBranch only supports merging into \"${CONTENTRAIN_BRANCH}\" (got \"${into}\"). `\n      + `The local flow merges feature branches into the content-tracking branch and fast-forwards the base branch via update-ref.`,\n    ), {\n      code: 'UNSUPPORTED_MERGE_TARGET',\n      agent_hint: `Pass \"${CONTENTRAIN_BRANCH}\" as the merge target, or use a non-local provider that supports arbitrary targets.`,\n      developer_action: `Merge \"${branch}\" into \"${CONTENTRAIN_BRANCH}\" instead.`,\n    })\n  }\n  const result = await mergeBranchOp(projectRoot, branch)\n  return {\n    merged: true,\n    sha: result.commit,\n    pullRequestUrl: null,\n    sync: result.sync,\n  }\n}\n\nexport async function isMerged(\n  projectRoot: string,\n  branch: string,\n  into: string,\n): Promise<boolean> {\n  const git = simpleGit(projectRoot)\n  try {\n    const raw = await git.raw(['branch', '--merged', into])\n    const merged = new Set(\n      raw.split('\\n').map(b => b.replace(/^\\*?\\s+/, '').trim()).filter(Boolean),\n    )\n    return merged.has(branch)\n  } catch {\n    return false\n  }\n}\n","import { CONTENTRAIN_BRANCH } from '@contentrain/types'\nimport type {\n  Branch,\n  FileDiff,\n  MergeResult,\n  ProviderCapabilities,\n  RepoProvider,\n} from '../../core/contracts/index.js'\nimport { LOCAL_CAPABILITIES } from '../../core/contracts/index.js'\nimport { applyChangesToWorktree } from '../../core/ops/index.js'\nimport { createTransaction } from '../../git/transaction.js'\nimport {\n  createBranch as createBranchOp,\n  deleteBranch as deleteBranchOp,\n  getBranchDiff as getBranchDiffOp,\n  getDefaultBranch as getDefaultBranchOp,\n  isMerged as isMergedOp,\n  listBranches as listBranchesOp,\n  mergeBranch as mergeBranchOp,\n} from './branch-ops.js'\nimport { LocalReader } from './reader.js'\nimport type { LocalApplyPlanInput, LocalApplyResult } from './types.js'\n\nconst DEFAULT_AUTHOR_NAME = 'Contentrain'\nconst DEFAULT_AUTHOR_EMAIL = 'mcp@contentrain.io'\n\n/**\n * LocalProvider — the local-filesystem, worktree-backed content provider.\n *\n * Implements the full `RepoProvider` surface:\n * - Reader methods delegate to `LocalReader`.\n * - `applyPlan` wraps `createTransaction` and returns `LocalApplyResult`\n *   (a superset of `Commit` carrying workflow action + selective sync).\n * - Branch ops mirror `GitHubProvider` — thin wrappers over the local\n *   simple-git helpers in `./branch-ops.ts`.\n *\n * `mergeBranch` only supports merging into the singleton\n * `CONTENTRAIN_BRANCH`; the local flow advances the base branch via\n * `update-ref` in `transaction.mergeBranch`, so arbitrary merge targets\n * would bypass that invariant.\n */\nexport class LocalProvider implements RepoProvider {\n  readonly capabilities: ProviderCapabilities = LOCAL_CAPABILITIES\n  private readonly reader: LocalReader\n\n  constructor(public readonly projectRoot: string) {\n    this.reader = new LocalReader(projectRoot)\n  }\n\n  readFile(path: string, ref?: string): Promise<string> {\n    return this.reader.readFile(path, ref)\n  }\n\n  listDirectory(path: string, ref?: string): Promise<string[]> {\n    return this.reader.listDirectory(path, ref)\n  }\n\n  fileExists(path: string, ref?: string): Promise<boolean> {\n    return this.reader.fileExists(path, ref)\n  }\n\n  async applyPlan(input: LocalApplyPlanInput): Promise<LocalApplyResult> {\n    const tx = await createTransaction(this.projectRoot, input.branch, {\n      workflowOverride: input.workflowOverride,\n    })\n    try {\n      await tx.write(async (wt) => {\n        await applyChangesToWorktree(wt, input.changes)\n      })\n      await tx.commit(input.message, input.context)\n      const gitResult = await tx.complete()\n      return {\n        sha: gitResult.commit,\n        message: input.message,\n        author: {\n          name: process.env['CONTENTRAIN_AUTHOR_NAME'] ?? DEFAULT_AUTHOR_NAME,\n          email: process.env['CONTENTRAIN_AUTHOR_EMAIL'] ?? DEFAULT_AUTHOR_EMAIL,\n        },\n        timestamp: new Date().toISOString(),\n        workflowAction: gitResult.action,\n        sync: gitResult.sync,\n        warning: gitResult.warning,\n      }\n    } finally {\n      await tx.cleanup()\n    }\n  }\n\n  listBranches(prefix?: string): Promise<Branch[]> {\n    return listBranchesOp(this.projectRoot, prefix)\n  }\n\n  async createBranch(name: string, fromRef?: string): Promise<void> {\n    const resolved = fromRef ?? CONTENTRAIN_BRANCH\n    await createBranchOp(this.projectRoot, name, resolved)\n  }\n\n  deleteBranch(name: string): Promise<void> {\n    return deleteBranchOp(this.projectRoot, name)\n  }\n\n  getBranchDiff(branch: string, base?: string): Promise<FileDiff[]> {\n    const resolved = base ?? CONTENTRAIN_BRANCH\n    return getBranchDiffOp(this.projectRoot, branch, resolved)\n  }\n\n  mergeBranch(branch: string, into: string): Promise<MergeResult> {\n    return mergeBranchOp(this.projectRoot, branch, into)\n  }\n\n  isMerged(branch: string, into?: string): Promise<boolean> {\n    const resolved = into ?? CONTENTRAIN_BRANCH\n    return isMergedOp(this.projectRoot, branch, resolved)\n  }\n\n  getDefaultBranch(): Promise<string> {\n    return getDefaultBranchOp(this.projectRoot)\n  }\n}\n"],"mappings":"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"}

package/dist/providers/github/index.d.mts

@@ -1,6 +1,54 @@
 import { c as MergeResult, d as RepoReader, i as CommitAuthor, l as ProviderCapabilities, n as Branch, o as FileDiff, r as Commit, t as ApplyPlanInput, u as RepoProvider } from "../../index-D0wQJSgs.mjs";
 import { Octokit } from "@octokit/rest";
 
+//#region src/providers/github/app-auth.d.ts
+/**
+ * GitHub App authentication helpers.
+ *
+ * Two entry points:
+ *
+ * - {@link signAppJwt} — mint a short-lived (10 min) GitHub App JWT from
+ *   `appId` + `privateKey`. Used to authenticate app-level endpoints
+ *   (listing installations, creating installation tokens).
+ *
+ * - {@link exchangeInstallationToken} — exchange an app JWT for a
+ *   per-installation access token that can be passed straight to
+ *   `Octokit({ auth: token })`. Installation tokens last ~1 hour and
+ *   must be refreshed.
+ *
+ * Both helpers are pure — they never import `@octokit/rest` or
+ * `@octokit/auth-app`. Callers that want auto-refresh behaviour should
+ * either wire `@octokit/auth-app` as the `authStrategy` when constructing
+ * their own Octokit (see the embedding guide), or call
+ * `exchangeInstallationToken` on their own schedule.
+ */
+interface AppAuthConfig {
+  /** GitHub App ID (numeric, from the app's settings page). */
+  appId: number;
+  /** PEM-encoded private key — the contents of the `.pem` the app issued. */
+  privateKey: string;
+  /** Installation the token should be scoped to. */
+  installationId: number;
+}
+interface InstallationTokenResult {
+  /** Opaque bearer token — pass to `new Octokit({ auth: token })`. */
+  token: string;
+  /** ISO 8601 expiry. Installation tokens expire after ~1 hour. */
+  expiresAt: string;
+}
+declare function signAppJwt(config: Pick<AppAuthConfig, 'appId' | 'privateKey'>): string;
+/**
+ * Exchange an App JWT for an installation-scoped access token by calling
+ * GitHub's `POST /app/installations/{id}/access_tokens` endpoint.
+ *
+ * Uses `fetch` (Node ≥22 has it native) so the helper stays dependency-
+ * free. Throws on non-2xx responses with the GitHub-returned message.
+ */
+declare function exchangeInstallationToken(config: AppAuthConfig, opts?: {
+  baseUrl?: string;
+  fetchImpl?: typeof globalThis.fetch;
+}): Promise<InstallationTokenResult>;
+//#endregion
 //#region src/providers/github/capabilities.d.ts
 /**
  * Capability set for GitHubProvider.
@@ -102,8 +150,17 @@ declare class GitHubProvider implements RepoProvider {
  * it. If the module is not installed, the import throws with a helpful
  * hint pointing the operator at the peer dependency.
  *
- * Phase 5.1 ships with PAT auth only. App-based auth (JWT + installation
- * token) lands in phase 5.2 together with the HTTP transport.
+ * Two auth modes:
+ *
+ * - `pat` — personal access token or fine-grained PAT. Simplest for
+ *   self-hosted MCP or CI runners.
+ * - `app` — GitHub App installation auth. The factory mints a short-
+ *   lived JWT, exchanges it for an installation token via
+ *   `exchangeInstallationToken`, and instantiates Octokit with the
+ *   resulting bearer. The returned token expires in ~1 hour; callers
+ *   that need auto-refresh should instead inject their own Octokit
+ *   built with `@octokit/auth-app`'s auth strategy and construct
+ *   `GitHubProvider` directly. See the embedding guide for trade-offs.
  */
 declare function createGitHubClient(auth: GitHubAuth): Promise<GitHubClient>;
 /**
@@ -140,5 +197,5 @@ declare class GitHubReader implements RepoReader {
   fileExists(path: string, ref?: string): Promise<boolean>;
 }
 //#endregion
-export { DEFAULT_GITHUB_AUTHOR, GITHUB_CAPABILITIES, type GitHubAuth, type GitHubClient, GitHubProvider, GitHubReader, type RepoRef, createGitHubClient, createGitHubProvider };
+export { type AppAuthConfig, DEFAULT_GITHUB_AUTHOR, GITHUB_CAPABILITIES, type GitHubAuth, type GitHubClient, GitHubProvider, GitHubReader, type InstallationTokenResult, type RepoRef, createGitHubClient, createGitHubProvider, exchangeInstallationToken, signAppJwt };
 //# sourceMappingURL=index.d.mts.map

package/dist/providers/github/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/providers/github/capabilities.ts","../../../src/providers/github/client.ts","../../../src/providers/github/types.ts","../../../src/providers/github/provider.ts","../../../src/providers/github/factory.ts","../../../src/providers/github/reader.ts"],"mappings":";;;;;;;AAeA;;;;;;;;ACJA;;cDIa,mBAAA,EAAqB,oBAAA;;;;;;AAAlC;;;;;;KCJY,YAAA,GAAe,OAAA;;;;;;ADI3B;;;;;UELiB,OAAA;EACf,KAAA;EACA,IAAA;EACA,WAAA;AAAA;;;;;;;AAHF;;;KAeY,UAAA;EACN,IAAA;EAAa,KAAA;AAAA;EAEb,IAAA;EACA,KAAA;EACA,UAAA;EACA,cAAA;AAAA;;cAIO,qBAAA,EAAuB,YAAA;;;;AFpBpC;;;;;;;;cGkBa,cAAA,YAA0B,YAAA;EAAA,iBAKlB,MAAA;EAAA,SACD,IAAA,EAAM,OAAA;EAAA,SALf,YAAA,EAAc,oBAAA;EAAA,iBACN,MAAA;cAGE,MAAA,EAAQ,YAAA,EACT,IAAA,EAAM,OAAA;EAKxB,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAGtC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAG3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;EAIxC,SAAA,CAAU,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,MAAA;EAI1C,YAAA,CAAa,MAAA,YAAkB,OAAA,CAAQ,MAAA;EAGvC,YAAA,CAAa,IAAA,UAAc,OAAA,YAAmB,OAAA;EAI9C,YAAA,CAAa,IAAA,WAAe,OAAA;EAG5B,aAAA,CAAc,MAAA,UAAgB,IAAA,YAAgB,OAAA,CAAQ,QAAA;EAItD,WAAA,CAAY,MAAA,UAAgB,IAAA,WAAe,OAAA,CAAQ,WAAA;EAGnD,QAAA,CAAS,MAAA,UAAgB,IAAA,YAAgB,OAAA;EAIzC,gBAAA,CAAA,GAAoB,OAAA;AAAA;;;;AHhEtB;;;;;;;;ACJA;;iBGIsB,kBAAA,CAAmB,IAAA,EAAM,UAAA,GAAa,OAAA,CAAQ,YAAA;;;;;;AFLpE;iBEiCsB,oBAAA,CAAqB,IAAA;EAAQ,IAAA,EAAM,UAAA;EAAY,IAAA,EAAM,OAAA;AAAA,IAAY,OAAA,CAAQ,cAAA;;;;AJ5B/F;;;;;;;;ACJA;;;;cIOa,YAAA,YAAwB,UAAA;EAAA,iBAEhB,MAAA;EAAA,iBACA,IAAA;cADA,MAAA,EAAQ,YAAA,EACR,IAAA,EAAM,OAAA;EAGnB,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAmCtC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAkB3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/providers/github/app-auth.ts","../../../src/providers/github/capabilities.ts","../../../src/providers/github/client.ts","../../../src/providers/github/types.ts","../../../src/providers/github/provider.ts","../../../src/providers/github/factory.ts","../../../src/providers/github/reader.ts"],"mappings":";;;;;;;;AAuBA;;;;;;;;;AASA;;;;;AAkBA;;UA3BiB,aAAA;EA2BsB;EAzBrC,KAAA;EAyBsC;EAvBtC,UAAA;EAuB4E;EArB5E,cAAA;AAAA;AAAA,UAGe,uBAAA;;EAEf,KAAA;EA4C6C;EA1C7C,SAAA;AAAA;AAAA,iBAcc,UAAA,CAAW,MAAA,EAAQ,IAAA,CAAK,aAAA;;;;;;;;iBA0BlB,yBAAA,CACpB,MAAA,EAAQ,aAAA,EACR,IAAA;EAAQ,OAAA;EAAkB,SAAA,UAAmB,UAAA,CAAW,KAAA;AAAA,IACvD,OAAA,CAAQ,uBAAA;;;;;;AAxDX;;;;;;;;;AASA;cCjBa,mBAAA,EAAqB,oBAAA;;;;;;ADQlC;;;;;;KEZY,YAAA,GAAe,OAAA;;;;;;AFY3B;;;;;UGbiB,OAAA;EACf,KAAA;EACA,IAAA;EACA,WAAA;AAAA;;;;;AHqCF;;;;;KGzBY,UAAA;EACN,IAAA;EAAa,KAAA;AAAA;EAEb,IAAA;EACA,KAAA;EACA,UAAA;EACA,cAAA;AAAA;;cAIO,qBAAA,EAAuB,YAAA;;;;AHZpC;;;;;;;;cIUa,cAAA,YAA0B,YAAA;EAAA,iBAKlB,MAAA;EAAA,SACD,IAAA,EAAM,OAAA;EAAA,SALf,YAAA,EAAc,oBAAA;EAAA,iBACN,MAAA;cAGE,MAAA,EAAQ,YAAA,EACT,IAAA,EAAM,OAAA;EAKxB,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAGtC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAG3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;EAIxC,SAAA,CAAU,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,MAAA;EAI1C,YAAA,CAAa,MAAA,YAAkB,OAAA,CAAQ,MAAA;EAGvC,YAAA,CAAa,IAAA,UAAc,OAAA,YAAmB,OAAA;EAI9C,YAAA,CAAa,IAAA,WAAe,OAAA;EAG5B,aAAA,CAAc,MAAA,UAAgB,IAAA,YAAgB,OAAA,CAAQ,QAAA;EAItD,WAAA,CAAY,MAAA,UAAgB,IAAA,WAAe,OAAA,CAAQ,WAAA;EAGnD,QAAA,CAAS,MAAA,UAAgB,IAAA,YAAgB,OAAA;EAIzC,gBAAA,CAAA,GAAoB,OAAA;AAAA;;;;AJxDtB;;;;;;;;;AASA;;;;;AAkBA;;;;;iBKzBsB,kBAAA,CAAmB,IAAA,EAAM,UAAA,GAAa,OAAA,CAAQ,YAAA;;;;ALmDpE;;;iBKhBsB,oBAAA,CAAqB,IAAA;EAAQ,IAAA,EAAM,UAAA;EAAY,IAAA,EAAM,OAAA;AAAA,IAAY,OAAA,CAAQ,cAAA;;;;ALrC/F;;;;;;;;;AASA;;;cMda,YAAA,YAAwB,UAAA;EAAA,iBAEhB,MAAA;EAAA,iBACA,IAAA;cADA,MAAA,EAAQ,YAAA,EACR,IAAA,EAAM,OAAA;EAGnB,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAmCtC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAkB3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;AAAA"}

package/dist/providers/github/index.mjs

@@ -1,5 +1,67 @@
 import { n as isNotFoundError, t as resolveRepoPath } from "../../paths-C3xNyc7z.mjs";
 import { CONTENTRAIN_BRANCH } from "@contentrain/types";
+import { createPrivateKey, createSign } from "node:crypto";
+//#region src/providers/github/app-auth.ts
+/**
+* Sign a GitHub App JWT.
+*
+* GitHub's spec: RS256 (RSASSA-PKCS1-v1_5), 10-minute max lifetime,
+* `iat` 60 seconds in the past to cover small clock skew, `iss`
+* set to the numeric app ID.
+*/
+function base64UrlEncode(obj) {
+	return Buffer.from(JSON.stringify(obj), "utf8").toString("base64url");
+}
+function signAppJwt(config) {
+	const now = Math.floor(Date.now() / 1e3);
+	const header = {
+		alg: "RS256",
+		typ: "JWT"
+	};
+	const payload = {
+		iat: now - 60,
+		exp: now + 540,
+		iss: String(config.appId)
+	};
+	const toSign = `${base64UrlEncode(header)}.${base64UrlEncode(payload)}`;
+	const keyObject = createPrivateKey({
+		key: config.privateKey,
+		format: "pem"
+	});
+	const signer = createSign("RSA-SHA256");
+	signer.update(toSign);
+	signer.end();
+	return `${toSign}.${signer.sign(keyObject).toString("base64url")}`;
+}
+/**
+* Exchange an App JWT for an installation-scoped access token by calling
+* GitHub's `POST /app/installations/{id}/access_tokens` endpoint.
+*
+* Uses `fetch` (Node ≥22 has it native) so the helper stays dependency-
+* free. Throws on non-2xx responses with the GitHub-returned message.
+*/
+async function exchangeInstallationToken(config, opts = {}) {
+	const jwt = signAppJwt(config);
+	const baseUrl = opts.baseUrl ?? "https://api.github.com";
+	const response = await (opts.fetchImpl ?? globalThis.fetch)(`${baseUrl}/app/installations/${config.installationId}/access_tokens`, {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${jwt}`,
+			Accept: "application/vnd.github+json",
+			"X-GitHub-Api-Version": "2022-11-28"
+		}
+	});
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new Error(`GitHub installation-token exchange failed: ${response.status} ${response.statusText}${body ? ` — ${body}` : ""}`);
+	}
+	const data = await response.json();
+	return {
+		token: data.token,
+		expiresAt: data.expires_at
+	};
+}
+//#endregion
 //#region src/providers/github/capabilities.ts
 /**
 * Capability set for GitHubProvider.
@@ -379,18 +441,36 @@ var GitHubProvider = class {
 * it. If the module is not installed, the import throws with a helpful
 * hint pointing the operator at the peer dependency.
 *
-* Phase 5.1 ships with PAT auth only. App-based auth (JWT + installation
-* token) lands in phase 5.2 together with the HTTP transport.
+* Two auth modes:
+*
+* - `pat` — personal access token or fine-grained PAT. Simplest for
+*   self-hosted MCP or CI runners.
+* - `app` — GitHub App installation auth. The factory mints a short-
+*   lived JWT, exchanges it for an installation token via
+*   `exchangeInstallationToken`, and instantiates Octokit with the
+*   resulting bearer. The returned token expires in ~1 hour; callers
+*   that need auto-refresh should instead inject their own Octokit
+*   built with `@octokit/auth-app`'s auth strategy and construct
+*   `GitHubProvider` directly. See the embedding guide for trade-offs.
 */
 async function createGitHubClient(auth) {
-	if (auth.type !== "pat") throw new Error(`GitHub auth type "${auth.type}" is not yet supported. Phase 5.1 ships with "pat" only; "app" installation auth arrives in phase 5.2.`);
 	let OctokitCtor;
 	try {
 		({Octokit: OctokitCtor} = await import("@octokit/rest"));
 	} catch (error) {
 		throw new Error("@octokit/rest is required for the GitHubProvider but could not be loaded. Install it as a peer dependency: pnpm add @octokit/rest.", { cause: error });
 	}
-	return new OctokitCtor({ auth: auth.token });
+	if (auth.type === "pat") return new OctokitCtor({ auth: auth.token });
+	if (auth.type === "app") {
+		const { token } = await exchangeInstallationToken({
+			appId: auth.appId,
+			privateKey: auth.privateKey,
+			installationId: auth.installationId
+		});
+		return new OctokitCtor({ auth: token });
+	}
+	const unknown = auth;
+	throw new Error(`GitHub auth type "${unknown.type}" is not supported. Use "pat" or "app".`);
 }
 /**
 * Factory for the full provider — instantiates an Octokit client and
@@ -409,6 +489,6 @@ const DEFAULT_GITHUB_AUTHOR = {
 	email: "mcp@contentrain.io"
 };
 //#endregion
-export { DEFAULT_GITHUB_AUTHOR, GITHUB_CAPABILITIES, GitHubProvider, GitHubReader, createGitHubClient, createGitHubProvider };
+export { DEFAULT_GITHUB_AUTHOR, GITHUB_CAPABILITIES, GitHubProvider, GitHubReader, createGitHubClient, createGitHubProvider, exchangeInstallationToken, signAppJwt };
 
 //# sourceMappingURL=index.mjs.map