@contentrain/mcp 0.3.1 → 1.0.0

package/dist/graph-builder-fPrDDwnu.mjs

@@ -0,0 +1,162 @@
+import { o as readText, r as pathExists } from "./fs-BbuGnVcG.mjs";
+import { a as classifyFile, i as autoDetectSourceDirs, n as SCAN_EXTENSIONS, o as discoverFiles } from "./scan-config-AJGxCdNd.mjs";
+import { dirname, extname, join, relative } from "node:path";
+//#region src/core/graph-builder.ts
+const MAX_ORPHANS = 10;
+const IMPORT_RE = /(?:import|export)\s+.*?from\s+['"]([^'"]+)['"]|(?:import|require)\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+function extractImportPaths(content) {
+	const paths = [];
+	let m;
+	IMPORT_RE.lastIndex = 0;
+	while ((m = IMPORT_RE.exec(content)) !== null) {
+		const p = m[1] ?? m[2];
+		if (p && isLocalImport(p)) paths.push(p);
+	}
+	return paths;
+}
+function isLocalImport(p) {
+	return p.startsWith(".") || p.startsWith("/");
+}
+const NAMED_IMPORT_RE = /import\s+(?:type\s+)?(?:(\w+)(?:\s*,\s*)?)?(?:\{([^}]*)\})?\s+from\s+['"][^'"]+['"]/g;
+const DEFAULT_IMPORT_RE = /import\s+(?:type\s+)?(\w+)\s+from\s+['"][^'"]+['"]/g;
+function isPascalCase(name) {
+	return /^[A-Z][a-zA-Z0-9]*$/.test(name);
+}
+function extractComponentNames(content) {
+	const names = /* @__PURE__ */ new Set();
+	DEFAULT_IMPORT_RE.lastIndex = 0;
+	let m;
+	while ((m = DEFAULT_IMPORT_RE.exec(content)) !== null) {
+		const name = m[1];
+		if (name && isPascalCase(name)) names.add(name);
+	}
+	NAMED_IMPORT_RE.lastIndex = 0;
+	while ((m = NAMED_IMPORT_RE.exec(content)) !== null) {
+		const defaultName = m[1];
+		if (defaultName && isPascalCase(defaultName)) names.add(defaultName);
+		const namedPart = m[2];
+		if (namedPart) for (const segment of namedPart.split(",")) {
+			const parts = segment.trim().split(/\s+as\s+/);
+			const localName = (parts[1] ?? parts[0])?.trim();
+			if (localName && isPascalCase(localName)) names.add(localName);
+		}
+	}
+	return [...names];
+}
+const STRING_SINGLE_RE = /'[^'\\]*(?:\\.[^'\\]*)*'/g;
+const STRING_DOUBLE_RE = /"[^"\\]*(?:\\.[^"\\]*)*"/g;
+const STRING_TEMPLATE_RE = /`[^`\\]*(?:\\.[^`\\]*)*`/g;
+function countStrings(content) {
+	const stripped = content.replace(/^(?:import|export)\s+.*$/gm, "").replace(/\brequire\s*\([^)]*\)/g, "");
+	const singles = stripped.match(STRING_SINGLE_RE)?.length ?? 0;
+	const doubles = stripped.match(STRING_DOUBLE_RE)?.length ?? 0;
+	const templates = stripped.match(STRING_TEMPLATE_RE)?.length ?? 0;
+	return singles + doubles + templates;
+}
+const RESOLVE_EXTENSIONS = [...SCAN_EXTENSIONS];
+const RESOLVE_INDEX_FILES = [
+	"index.ts",
+	"index.tsx",
+	"index.js"
+];
+async function resolveImportPath(importPath, importerDir, projectRoot) {
+	const base = importPath.startsWith("/") ? join(projectRoot, importPath) : join(importerDir, importPath);
+	if (extname(base)) {
+		if (await pathExists(base)) return base;
+		return null;
+	}
+	for (const ext of RESOLVE_EXTENSIONS) {
+		const candidate = base + ext;
+		if (await pathExists(candidate)) return candidate;
+	}
+	for (const idx of RESOLVE_INDEX_FILES) {
+		const candidate = join(base, idx);
+		if (await pathExists(candidate)) return candidate;
+	}
+	return null;
+}
+async function buildGraph(projectRoot, options) {
+	const filePaths = await discoverFiles(projectRoot, {
+		paths: options?.paths ?? await autoDetectSourceDirs(projectRoot),
+		include: options?.include,
+		exclude: options?.exclude
+	});
+	const fileMap = /* @__PURE__ */ new Map();
+	const parsePromises = filePaths.map(async (relPath) => {
+		const content = await readText(join(projectRoot, relPath));
+		if (content === null) return;
+		const imports = extractImportPaths(content);
+		const components = extractComponentNames(content);
+		const strings = countStrings(content);
+		const category = classifyFile(relPath);
+		fileMap.set(relPath, {
+			relPath,
+			imports,
+			components,
+			strings,
+			category
+		});
+	});
+	await Promise.all(parsePromises);
+	const usedByMap = /* @__PURE__ */ new Map();
+	for (const relPath of fileMap.keys()) usedByMap.set(relPath, /* @__PURE__ */ new Set());
+	const resolvePromises = [];
+	for (const [relPath, info] of fileMap) {
+		const importerAbsDir = dirname(join(projectRoot, relPath));
+		for (const rawImport of info.imports) resolvePromises.push(resolveImportPath(rawImport, importerAbsDir, projectRoot).then((resolved) => {
+			if (!resolved) return;
+			const resolvedRel = relative(projectRoot, resolved);
+			const targetSet = usedByMap.get(resolvedRel);
+			if (targetSet) targetSet.add(relPath);
+		}));
+	}
+	await Promise.all(resolvePromises);
+	const pages = [];
+	const components = [];
+	const layouts = [];
+	const orphanCandidates = [];
+	let totalStrings = 0;
+	for (const [relPath, info] of fileMap) {
+		const usedBy = [...usedByMap.get(relPath) ?? []].toSorted((a, b) => a.localeCompare(b));
+		totalStrings += info.strings;
+		if (info.strings === 0 && info.category !== "other") continue;
+		const node = {
+			file: relPath,
+			category: info.category,
+			imports: info.imports,
+			used_by: usedBy,
+			strings: info.strings
+		};
+		if (info.category === "page" && info.components.length > 0) node.components = info.components;
+		switch (info.category) {
+			case "page":
+				pages.push(node);
+				break;
+			case "component":
+				components.push(node);
+				break;
+			case "layout":
+				layouts.push(node);
+				break;
+			default:
+				if (usedBy.length === 0 && info.imports.length === 0) orphanCandidates.push(relPath);
+				break;
+		}
+	}
+	return {
+		pages: pages.toSorted((a, b) => a.file.localeCompare(b.file)),
+		components: components.toSorted((a, b) => a.file.localeCompare(b.file)),
+		layouts: layouts.toSorted((a, b) => a.file.localeCompare(b.file)),
+		orphan_files: orphanCandidates.toSorted((a, b) => a.localeCompare(b)).slice(0, MAX_ORPHANS),
+		stats: {
+			total_files: fileMap.size,
+			total_components: components.length,
+			total_pages: pages.length,
+			total_strings_estimate: totalStrings
+		}
+	};
+}
+//#endregion
+export { buildGraph as t };
+
+//# sourceMappingURL=graph-builder-fPrDDwnu.mjs.map

package/dist/graph-builder-fPrDDwnu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder-fPrDDwnu.mjs","names":[],"sources":["../src/core/graph-builder.ts"],"sourcesContent":["import type { FileCategory, GraphNode, ProjectGraph } from '@contentrain/types'\nimport { join, relative, dirname, extname } from 'node:path'\nimport { readText, pathExists } from '../util/fs.js'\nimport {\n  SCAN_EXTENSIONS,\n  classifyFile,\n  autoDetectSourceDirs,\n  discoverFiles,\n} from './scan-config.js'\n\nexport interface BuildGraphOptions {\n  paths?: string[]\n  include?: string[]\n  exclude?: string[]\n}\n\nconst MAX_ORPHANS = 10\n\n// ---------------------------------------------------------------------------\n// Import extraction\n// ---------------------------------------------------------------------------\n\nconst IMPORT_RE = /(?:import|export)\\s+.*?from\\s+['\"]([^'\"]+)['\"]|(?:import|require)\\s*\\(\\s*['\"]([^'\"]+)['\"]\\s*\\)/g\n\nfunction extractImportPaths(content: string): string[] {\n  const paths: string[] = []\n  let m: RegExpExecArray | null\n  // Reset lastIndex before use since we reuse the regex\n  IMPORT_RE.lastIndex = 0\n  while ((m = IMPORT_RE.exec(content)) !== null) {\n    const p = m[1] ?? m[2]\n    if (p && isLocalImport(p)) {\n      paths.push(p)\n    }\n  }\n  return paths\n}\n\nfunction isLocalImport(p: string): boolean {\n  return p.startsWith('.') || p.startsWith('/')\n}\n\n// ---------------------------------------------------------------------------\n// Component name extraction from imports\n// ---------------------------------------------------------------------------\n\nconst NAMED_IMPORT_RE = /import\\s+(?:type\\s+)?(?:(\\w+)(?:\\s*,\\s*)?)?(?:\\{([^}]*)\\})?\\s+from\\s+['\"][^'\"]+['\"]/g\nconst DEFAULT_IMPORT_RE = /import\\s+(?:type\\s+)?(\\w+)\\s+from\\s+['\"][^'\"]+['\"]/g\n\nfunction isPascalCase(name: string): boolean {\n  return /^[A-Z][a-zA-Z0-9]*$/.test(name)\n}\n\nfunction extractComponentNames(content: string): string[] {\n  const names = new Set<string>()\n\n  // Default imports: `import Button from '...'`\n  DEFAULT_IMPORT_RE.lastIndex = 0\n  let m: RegExpExecArray | null\n  while ((m = DEFAULT_IMPORT_RE.exec(content)) !== null) {\n    const name = m[1]\n    if (name && isPascalCase(name)) {\n      names.add(name)\n    }\n  }\n\n  // Named imports: `import { Button, useHook } from '...'`\n  NAMED_IMPORT_RE.lastIndex = 0\n  while ((m = NAMED_IMPORT_RE.exec(content)) !== null) {\n    // Default part before destructuring\n    const defaultName = m[1]\n    if (defaultName && isPascalCase(defaultName)) {\n      names.add(defaultName)\n    }\n    // Destructured names\n    const namedPart = m[2]\n    if (namedPart) {\n      for (const segment of namedPart.split(',')) {\n        // Handle `Foo as Bar` — take the local name (Bar)\n        const parts = segment.trim().split(/\\s+as\\s+/)\n        const localName = (parts[1] ?? parts[0])?.trim()\n        if (localName && isPascalCase(localName)) {\n          names.add(localName)\n        }\n      }\n    }\n  }\n\n  return [...names]\n}\n\n// ---------------------------------------------------------------------------\n// String counting (estimate)\n// ---------------------------------------------------------------------------\n\nconst STRING_SINGLE_RE = /'[^'\\\\]*(?:\\\\.[^'\\\\]*)*'/g\nconst STRING_DOUBLE_RE = /\"[^\"\\\\]*(?:\\\\.[^\"\\\\]*)*\"/g\nconst STRING_TEMPLATE_RE = /`[^`\\\\]*(?:\\\\.[^`\\\\]*)*`/g\n\nfunction countStrings(content: string): number {\n  // Strip import/export/require lines first so their string literals don't count\n  const stripped = content.replace(/^(?:import|export)\\s+.*$/gm, '')\n    .replace(/\\brequire\\s*\\([^)]*\\)/g, '')\n\n  const singles = stripped.match(STRING_SINGLE_RE)?.length ?? 0\n  const doubles = stripped.match(STRING_DOUBLE_RE)?.length ?? 0\n  const templates = stripped.match(STRING_TEMPLATE_RE)?.length ?? 0\n\n  return singles + doubles + templates\n}\n\n// ---------------------------------------------------------------------------\n// Import path resolution\n// ---------------------------------------------------------------------------\n\nconst RESOLVE_EXTENSIONS = [...SCAN_EXTENSIONS]\nconst RESOLVE_INDEX_FILES = ['index.ts', 'index.tsx', 'index.js']\n\nasync function resolveImportPath(\n  importPath: string,\n  importerDir: string,\n  projectRoot: string,\n): Promise<string | null> {\n  const base = importPath.startsWith('/')\n    ? join(projectRoot, importPath)\n    : join(importerDir, importPath)\n\n  // If it already has an extension, check directly\n  if (extname(base)) {\n    if (await pathExists(base)) {\n      return base\n    }\n    return null\n  }\n\n  // Try adding extensions\n  for (const ext of RESOLVE_EXTENSIONS) {\n    const candidate = base + ext\n    if (await pathExists(candidate)) {\n      return candidate\n    }\n  }\n\n  // Try index files inside directory\n  for (const idx of RESOLVE_INDEX_FILES) {\n    const candidate = join(base, idx)\n    if (await pathExists(candidate)) {\n      return candidate\n    }\n  }\n\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// Main\n// ---------------------------------------------------------------------------\n\ninterface FileInfo {\n  relPath: string\n  imports: string[]\n  components: string[]\n  strings: number\n  category: FileCategory\n}\n\nexport async function buildGraph(\n  projectRoot: string,\n  options?: BuildGraphOptions,\n): Promise<ProjectGraph> {\n  const scanDirs = options?.paths ?? await autoDetectSourceDirs(projectRoot)\n\n  // ---- File discovery (shared with scanner) ----\n  const filePaths = await discoverFiles(projectRoot, {\n    paths: scanDirs,\n    include: options?.include,\n    exclude: options?.exclude,\n  })\n\n  // ---- Pass 1: Parse each file ----\n  const fileMap = new Map<string, FileInfo>()\n\n  const parsePromises = filePaths.map(async (relPath) => {\n    const absPath = join(projectRoot, relPath)\n    const content = await readText(absPath)\n    if (content === null) return\n\n    const imports = extractImportPaths(content)\n    const components = extractComponentNames(content)\n    const strings = countStrings(content)\n    const category = classifyFile(relPath)\n\n    fileMap.set(relPath, { relPath, imports, components, strings, category })\n  })\n\n  await Promise.all(parsePromises)\n\n  // ---- Pass 2: Resolve imports and build reverse lookup ----\n  const usedByMap = new Map<string, Set<string>>()\n\n  // Initialize usedBy sets\n  for (const relPath of fileMap.keys()) {\n    usedByMap.set(relPath, new Set())\n  }\n\n  const resolvePromises: Promise<void>[] = []\n\n  for (const [relPath, info] of fileMap) {\n    const importerAbsDir = dirname(join(projectRoot, relPath))\n\n    for (const rawImport of info.imports) {\n      resolvePromises.push(\n        resolveImportPath(rawImport, importerAbsDir, projectRoot).then((resolved) => {\n          if (!resolved) return\n          const resolvedRel = relative(projectRoot, resolved)\n          const targetSet = usedByMap.get(resolvedRel)\n          if (targetSet) {\n            targetSet.add(relPath)\n          }\n        }),\n      )\n    }\n  }\n\n  await Promise.all(resolvePromises)\n\n  // ---- Build nodes ----\n  const pages: GraphNode[] = []\n  const components: GraphNode[] = []\n  const layouts: GraphNode[] = []\n  const orphanCandidates: string[] = []\n\n  let totalStrings = 0\n\n  for (const [relPath, info] of fileMap) {\n    const usedBy = [...(usedByMap.get(relPath) ?? [])].toSorted((a, b) => a.localeCompare(b))\n    totalStrings += info.strings\n\n    // Filter out nodes with 0 strings — not relevant for content extraction\n    if (info.strings === 0 && info.category !== 'other') continue\n\n    const node: GraphNode = {\n      file: relPath,\n      category: info.category,\n      imports: info.imports,\n      used_by: usedBy,\n      strings: info.strings,\n    }\n\n    // Only attach components list for pages\n    if (info.category === 'page' && info.components.length > 0) {\n      node.components = info.components\n    }\n\n    switch (info.category) {\n      case 'page':\n        pages.push(node)\n        break\n      case 'component':\n        components.push(node)\n        break\n      case 'layout':\n        layouts.push(node)\n        break\n      default:\n        // Orphan = \"other\" category with no inbound references and no outbound imports\n        if (usedBy.length === 0 && info.imports.length === 0) {\n          orphanCandidates.push(relPath)\n        }\n        break\n    }\n  }\n\n  return {\n    pages: pages.toSorted((a, b) => a.file.localeCompare(b.file)),\n    components: components.toSorted((a, b) => a.file.localeCompare(b.file)),\n    layouts: layouts.toSorted((a, b) => a.file.localeCompare(b.file)),\n    orphan_files: orphanCandidates.toSorted((a, b) => a.localeCompare(b)).slice(0, MAX_ORPHANS),\n    stats: {\n      total_files: fileMap.size,\n      total_components: components.length,\n      total_pages: pages.length,\n      total_strings_estimate: totalStrings,\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/id-BdD4HvMY.mjs

@@ -0,0 +1,12 @@
+import { randomUUID } from "node:crypto";
+//#region src/util/id.ts
+function branchTimestamp() {
+	return `${Math.floor(Date.now() / 1e3).toString()}-${randomUUID().slice(0, 4)}`;
+}
+function generateEntryId() {
+	return randomUUID().replace(/-/g, "").slice(0, 12);
+}
+//#endregion
+export { generateEntryId as n, branchTimestamp as t };
+
+//# sourceMappingURL=id-BdD4HvMY.mjs.map

package/dist/id-BdD4HvMY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-BdD4HvMY.mjs","names":[],"sources":["../src/util/id.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\n\nexport function branchTimestamp(): string {\n  const ts = Math.floor(Date.now() / 1000).toString()\n  const suffix = randomUUID().slice(0, 4)\n  return `${ts}-${suffix}`\n}\n\nexport function generateEntryId(): string {\n  return randomUUID().replace(/-/g, '').slice(0, 12)\n}\n"],"mappings":";;AAEA,SAAgB,kBAA0B;AAGxC,QAAO,GAFI,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK,CAAC,UAAU,CAEtC,GADE,YAAY,CAAC,MAAM,GAAG,EAAE;;AAIzC,SAAgB,kBAA0B;AACxC,QAAO,YAAY,CAAC,QAAQ,MAAM,GAAG,CAAC,MAAM,GAAG,GAAG"}

package/dist/index.d.mts

@@ -1,359 +1 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-
-//#region src/types/index.d.ts
-interface ModelMetadata {
-  name: string;
-  description?: string;
-  modelId: string;
-  path?: string;
-  localization: boolean;
-  type: 'JSON' | 'MD' | 'MDX';
-  createdBy?: string;
-  isServerless: boolean;
-}
-interface FieldDefinition {
-  name: string;
-  description?: string;
-  fieldId: string;
-  modelId: string;
-  componentId: ComponentId;
-  fieldType: FieldType;
-  options: FieldOptions;
-  validations: FieldValidations;
-  system: boolean;
-  defaultField: boolean;
-}
-type FieldType = 'string' | 'number' | 'boolean' | 'array' | 'date' | 'media' | 'relation';
-type ComponentId = 'single-line-text' | 'multi-line-text' | 'email' | 'url' | 'slug' | 'color' | 'json' | 'md-editor' | 'rich-text-editor' | 'integer' | 'decimal' | 'rating' | 'percent' | 'phone-number' | 'checkbox' | 'switch' | 'date' | 'date-time' | 'media' | 'one-to-one' | 'one-to-many';
-interface FieldOptions {
-  'title-field'?: {
-    value: boolean;
-  };
-  'default-value'?: {
-    value: boolean;
-    form?: Record<string, {
-      value: unknown;
-    }>;
-  };
-  reference?: {
-    value: boolean;
-    form?: {
-      reference: {
-        value: string;
-      };
-    };
-  };
-  [key: string]: unknown;
-}
-interface FieldValidations {
-  'required-field'?: {
-    value: boolean;
-  };
-  'unique-field'?: {
-    value: boolean;
-  };
-  [key: string]: unknown;
-}
-interface ContentEntry {
-  ID: string;
-  createdAt: string;
-  updatedAt: string;
-  status: 'draft' | 'publish' | 'changed';
-  scheduled?: boolean;
-  [key: string]: unknown;
-}
-interface MDContentEntry extends ContentEntry {
-  slug: string;
-  path?: string;
-}
-interface AssetEntry {
-  path: string;
-  mimetype: string;
-  size: number;
-  alt?: string;
-  meta?: {
-    user?: {
-      name: string;
-      email: string;
-      avatar?: string;
-    };
-    createdAt?: string;
-    updatedAt?: string;
-  };
-}
-interface ContentrainConfig {
-  assetsPath: string;
-}
-interface WriterConfig {
-  repoPath: string;
-  branch: string;
-  contentrainDir?: string;
-  remote?: string;
-  author?: {
-    name: string;
-    email: string;
-  };
-  commitPrefix?: string;
-  retryAttempts?: number;
-  dryRun?: boolean;
-}
-interface WorktreeContext {
-  path: string;
-  branch: string;
-  id: string;
-}
-interface TransactionOptions {
-  message?: string;
-}
-interface ValidationResult {
-  valid: boolean;
-  errors: ValidationFieldError[];
-}
-interface ValidationFieldError {
-  fieldId: string;
-  message: string;
-  rule: string;
-}
-interface ToolResult {
-  success: boolean;
-  data?: unknown;
-  error?: string;
-}
-//#endregion
-//#region src/server.d.ts
-declare function createServer(config: WriterConfig): McpServer;
-//#endregion
-//#region src/core/model/manager.d.ts
-declare class ModelManager {
-  private basePath;
-  constructor(basePath: string);
-  private get modelsDir();
-  private get metadataPath();
-  list(): Promise<ModelMetadata[]>;
-  get(modelId: string): Promise<ModelMetadata>;
-  getFields(modelId: string): Promise<FieldDefinition[]>;
-  describe(modelId: string): Promise<{
-    model: ModelMetadata;
-    fields: FieldDefinition[];
-    customFields: FieldDefinition[];
-  }>;
-  create(input: {
-    name: string;
-    description?: string;
-    modelId: string;
-    localization: boolean;
-    type: 'JSON' | 'MD' | 'MDX';
-    path?: string;
-    fields?: Omit<FieldDefinition, 'modelId' | 'system' | 'defaultField'>[];
-  }): Promise<ModelMetadata>;
-  addField(modelId: string, field: Omit<FieldDefinition, 'modelId' | 'system' | 'defaultField'>): Promise<FieldDefinition>;
-  removeField(modelId: string, fieldId: string): Promise<void>;
-  delete(modelId: string): Promise<void>;
-}
-//#endregion
-//#region src/core/content/manager.d.ts
-declare class ContentManager {
-  private basePath;
-  private repoPath;
-  private modelManager;
-  private markdownSync;
-  constructor(basePath: string, repoPath: string);
-  private contentDir;
-  private contentFilePath;
-  list(modelId: string, locale?: string): Promise<ContentEntry[]>;
-  get(modelId: string, entryId: string, locale?: string): Promise<ContentEntry>;
-  getLocales(modelId: string): Promise<string[]>;
-  create(modelId: string, data: Record<string, unknown>, options?: {
-    locale?: string;
-    id?: string;
-    status?: 'draft' | 'publish';
-    content?: string;
-  }): Promise<string>;
-  update(modelId: string, entryId: string, data: Record<string, unknown>, options?: {
-    locale?: string;
-    content?: string;
-  }): Promise<ContentEntry>;
-  delete(modelId: string, entryId: string): Promise<void>;
-  private resolveContentPath;
-  private createLocalized;
-  private appendEntry;
-  private deleteFromFile;
-}
-//#endregion
-//#region src/core/asset/manager.d.ts
-declare class AssetManager {
-  private basePath;
-  private repoPath;
-  private config;
-  private assetsPath;
-  constructor(basePath: string, repoPath: string, config: WriterConfig);
-  list(): Promise<AssetEntry[]>;
-  get(assetPath: string): Promise<AssetEntry | undefined>;
-  register(input: {
-    path: string;
-    mimetype: string;
-    alt?: string;
-  }): Promise<AssetEntry>;
-  deregister(assetPath: string): Promise<void>;
-  update(assetPath: string, updates: {
-    alt?: string;
-    mimetype?: string;
-  }): Promise<AssetEntry>;
-}
-//#endregion
-//#region src/core/validation/validator.d.ts
-declare class Validator {
-  private basePath;
-  private modelManager;
-  constructor(basePath: string);
-  /**
-   * Validate content data against model field definitions.
-   */
-  validate(modelId: string, data: Record<string, unknown>, options?: {
-    isUpdate?: boolean;
-  }): Promise<ValidationResult>;
-  /**
-   * Validate ID format.
-   */
-  validateId(id: string): ValidationResult;
-  /**
-   * Validate status value.
-   */
-  validateStatus(status: string): ValidationResult;
-  private checkRelationIntegrity;
-  private checkAssetExists;
-  private checkUniqueness;
-}
-//#endregion
-//#region src/core/writer.d.ts
-/**
- * Main orchestrator — coordinates all managers and git sync.
- *
- * Three modes:
- * 1. Read mode: reads from repoPath directly (no git sync)
- * 2. Transaction mode: creates a worktree, applies changes, commits + pushes
- * 3. Dry-run mode: copies contentrain dir to temp, applies changes there, then discards
- */
-declare class ContentrainWriter {
-  private config;
-  private contentrainDir;
-  readonly model: ModelManager;
-  readonly content: ContentManager;
-  readonly asset: AssetManager;
-  readonly validator: Validator;
-  private gitSync;
-  constructor(config: WriterConfig);
-  /**
-   * Execute operations in a git-synced transaction.
-   * Creates worktree → runs operations → validates → commits → pushes.
-   * In dry-run mode, copies to a temp directory and discards after execution.
-   */
-  transaction<T>(fn: (managers: TransactionManagers) => Promise<T>, options?: {
-    message?: string;
-  }): Promise<T>;
-  /**
-   * Execute operations and push to a staging branch instead of the target branch.
-   * Returns the result and whether any changes were pushed.
-   */
-  stagingTransaction<T>(fn: (managers: TransactionManagers) => Promise<T>, options: {
-    message: string;
-    stagingBranch: string;
-  }): Promise<{
-    result: T;
-    hasChanges: boolean;
-  }>;
-  /**
-   * Merge a staging branch into the target branch.
-   */
-  applyStagingBranch(stagingBranch: string): Promise<string>;
-  /**
-   * Delete a staging branch without merging.
-   */
-  discardStagingBranch(stagingBranch: string): Promise<void>;
-  /**
-   * Dry-run: copy contentrain dir to temp, run operations there, then discard.
-   * The original repository is never modified.
-   */
-  private dryRunTransaction;
-  /**
-   * Create managers for a specific repo path (used in transactions).
-   */
-  private createManagers;
-}
-interface TransactionManagers {
-  basePath: string;
-  repoPath: string;
-  model: ModelManager;
-  content: ContentManager;
-  asset: AssetManager;
-  validator: Validator;
-}
-//#endregion
-//#region src/core/doctor.d.ts
-type IssueSeverity = 'error' | 'warning';
-type IssueCategory = 'structure' | 'id' | 'schema' | 'relation' | 'asset' | 'sync';
-interface DoctorIssue {
-  severity: IssueSeverity;
-  category: IssueCategory;
-  modelId?: string;
-  entryId?: string;
-  field?: string;
-  file?: string;
-  message: string;
-  fix?: string;
-}
-interface DoctorResult {
-  summary: {
-    total: number;
-    errors: number;
-    warnings: number;
-    fixed: number;
-    models: number;
-    entries: number;
-  };
-  issues: DoctorIssue[];
-}
-interface DoctorOptions {
-  fix?: boolean;
-  modelId?: string;
-}
-declare class Doctor {
-  private basePath;
-  private repoPath;
-  private issues;
-  private fixed;
-  private totalEntries;
-  private scannedEntries;
-  private idRemap;
-  private contentFiles;
-  private fieldsByModel;
-  constructor(basePath: string, repoPath: string);
-  diagnose(options?: DoctorOptions): Promise<DoctorResult>;
-  private loadAllContentFiles;
-  private checkMetadata;
-  private checkFieldFiles;
-  private checkOrphanDirectories;
-  private checkModelStructure;
-  private checkModelContent;
-  private checkEntry;
-  private checkRelation;
-  private checkUniqueConstraints;
-  private checkLocaleIdConsistency;
-  private checkMarkdownSync;
-  private loadAssets;
-  /**
-   * After all ID fixes are collected in idRemap, propagate changes
-   * to ALL relation fields across ALL loaded content files.
-   *
-   * This is the critical two-way binding: when entry A's ID changes,
-   * every relation field in every model that points to A must be updated.
-   */
-  private propagateIdChanges;
-  private fixDuplicateIds;
-  private writeDirtyFiles;
-  private addIssue;
-  private buildResult;
-}
-//#endregion
-export { AssetEntry, ComponentId, ContentEntry, ContentrainConfig, ContentrainWriter, Doctor, FieldDefinition, FieldOptions, FieldType, FieldValidations, MDContentEntry, ModelMetadata, ToolResult, TransactionOptions, ValidationFieldError, ValidationResult, WorktreeContext, WriterConfig, createServer };
-//# sourceMappingURL=index.d.mts.map
+export { };