@contentrain/mcp 2.3.1 → 3.0.0

package/dist/{ops-CGKIKwDc.mjs → ops-BzbThweu.mjs}

@@ -1,8 +1,8 @@
-import { n as canonicalStringify$1, t as serializeMarkdownFrontmatter$1 } from "./serialization-B1CEzR4H.mjs";
+import { n as serializeMarkdownFrontmatter$1, r as canonicalStringify$1, t as parseMarkdownFrontmatter$1 } from "./serialization-tmgfFBOh.mjs";
 import { i as metaFilePath, n as contentFilePath, r as documentFilePath } from "./paths-CmVw5Cw2.mjs";
-import { n as mergeEntryMeta } from "./meta-manager-CJUiTgP2.mjs";
+import { r as mergeEntryMeta } from "./meta-manager-B_Se183X.mjs";
 import { dirname, join } from "node:path";
-import { generateEntryId, validateEntryId, validateLocale, validateSlug } from "@contentrain/types";
+import { LOCALE_PATTERN, MODEL_FIELD_ORDER, SLUG_PATTERN, canonicalStringify, generateEntryId, validateEntryId, validateLocale, validateSlug } from "@contentrain/types";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 //#region src/core/ops/apply-to-worktree.ts
 /**
@@ -302,6 +302,8 @@ function rewriteMarkdownMedia(body, base) {
 }
 //#endregion
 //#region src/core/ops/content-save.ts
+/** Keys named individually in a replacement advisory before it collapses to a count. */
+const MAX_REPORTED_KEYS = 5;
 /**
 * Build the FileChange[] required to save a batch of content entries. The
 * plan is deterministic, pure, and does not touch disk — it reads existing
@@ -389,9 +391,14 @@ async function planContentSave(reader, input) {
 				const mPath = metaFilePath(model, locale, defaultLocale);
 				const existing = contentByPath.get(cPath) ?? await readJsonOrEmpty(cPath);
 				const newData = entry.data;
-				const collisions = Object.keys(newData).filter((k) => k in existing && existing[k] !== newData[k]);
-				if (collisions.length > 0) throw new Error(`Dictionary "${model.id}" (${locale}): ${collisions.length} key collision(s) — [${collisions.join(", ")}] already exist with different values. Read existing keys with contentrain_content_list first, or include all keys in a single save call.`);
 				const entryAdvisories = [];
+				const replaced = Object.keys(newData).filter((k) => k in existing && existing[k] !== newData[k]);
+				if (replaced.length > 0) {
+					const shown = replaced.slice(0, MAX_REPORTED_KEYS);
+					const detail = shown.map((k) => `"${k}": "${existing[k]}" → "${newData[k]}"`).join(", ");
+					const more = replaced.length > shown.length ? `, and ${replaced.length - shown.length} more` : "";
+					entryAdvisories.push(`Dictionary "${model.id}" (${locale}): replaced ${replaced.length} existing value(s) — ${detail}${more}.`);
+				}
 				const reverseMap = /* @__PURE__ */ new Map();
 				for (const [k, v] of Object.entries(existing)) reverseMap.set(v, k);
 				for (const [newKey, newValue] of Object.entries(newData)) {
@@ -420,28 +427,42 @@ async function planContentSave(reader, input) {
 				break;
 			}
 			case "document": {
+				const entryAdvisories = [];
 				const slug = entry.slug ?? entry.data["slug"];
 				if (!slug) throw new Error("Document entries require a slug");
 				const slugErr = validateSlug(slug);
 				if (slugErr) throw new Error(slugErr);
-				const fmData = { ...entry.data };
-				const bodyContent = fmData["body"] ?? "";
-				delete fmData["body"];
-				if (!fmData["slug"]) fmData["slug"] = slug;
+				const incomingFm = { ...entry.data };
+				const bodySent = "body" in incomingFm;
+				const incomingBody = incomingFm["body"] ?? "";
+				delete incomingFm["body"];
+				if (!incomingFm["slug"]) incomingFm["slug"] = slug;
 				const dPath = documentFilePath(model, locale, slug);
 				const mPath = metaFilePath(model, locale, defaultLocale, slug);
-				let existingRaw = null;
-				try {
+				let existingRaw = markdownChanges.get(dPath) ?? null;
+				if (existingRaw === null) try {
 					existingRaw = await reader.readFile(dPath);
 				} catch {}
 				const action = existingRaw ? "updated" : "created";
+				const existing = existingRaw ? parseMarkdownFrontmatter$1(existingRaw) : null;
+				const fmData = {
+					...existing?.frontmatter,
+					...incomingFm
+				};
+				const bodyContent = bodySent ? incomingBody : existing?.body ?? "";
+				if (bodySent && !incomingBody.trim() && existing?.body.trim()) {
+					const notice = `Document "${slug}" (${locale}): body cleared — an explicit empty "body" replaced ${existing.body.length} characters. Omit "body" to leave it untouched.`;
+					entryAdvisories.push(notice);
+					advisories.push(notice);
+				}
 				const normalizedBody = mediaBaseUrl ? rewriteMarkdownMedia(bodyContent, mediaBaseUrl) : bodyContent;
 				markdownChanges.set(dPath, serializeMarkdownFrontmatter$1(normalizeMedia(fmData), normalizedBody));
 				metaByPath.set(mPath, mergeEntryMeta(await priorMeta(mPath), entry.data));
 				result.push({
 					action,
 					slug,
-					locale
+					locale,
+					...entryAdvisories.length > 0 ? { advisories: entryAdvisories } : {}
 				});
 				break;
 			}
@@ -528,18 +549,6 @@ async function enumerateTwoLevels(reader, dir) {
 }
 //#endregion
 //#region src/core/ops/model-save.ts
-/** Field order for canonical model JSON — preserves reader ergonomics. */
-const MODEL_FIELD_ORDER = [
-	"id",
-	"name",
-	"kind",
-	"domain",
-	"i18n",
-	"description",
-	"content_path",
-	"locale_strategy",
-	"fields"
-];
 /**
 * Build the FileChange[] required to create or update a model definition.
 *
@@ -570,6 +579,136 @@ async function planModelSave(reader, input) {
 	};
 }
 //#endregion
-export { applyChangesToWorktree as a, planContentDelete as i, planModelDelete as n, planContentSave as r, planModelSave as t };
+//#region src/core/ops/vocabulary-save.ts
+const VOCABULARY_PATH = ".contentrain/vocabulary.json";
+/** Terms named individually in an advisory before it collapses to a count. */
+const MAX_REPORTED_TERMS = 5;
+async function readVocabulary(reader) {
+	try {
+		const parsed = JSON.parse(await reader.readFile(VOCABULARY_PATH));
+		return {
+			version: parsed.version ?? 1,
+			terms: parsed.terms ?? {}
+		};
+	} catch {
+		return {
+			version: 1,
+			terms: {}
+		};
+	}
+}
+/**
+* Validate the shape callers get wrong.
+*
+* The nesting is `term -> locale -> translation`, and it reads identically the
+* other way round, so a caller that groups by locale at the top level produces
+* a structurally valid file that matches nothing. That is not a typo anyone
+* notices — the vocabulary simply stops having any effect. Checking that outer
+* keys are term slugs and inner keys are locale codes catches the inversion at
+* the point of writing.
+*/
+function validateTerms(terms) {
+	const errors = [];
+	for (const [term, translations] of Object.entries(terms)) {
+		if (!SLUG_PATTERN.test(term)) errors.push(`Term "${term}": must be kebab-case. The outer key is the term, not a locale.`);
+		if (typeof translations !== "object" || translations === null || Array.isArray(translations)) {
+			errors.push(`Term "${term}": expected an object of locale → translation.`);
+			continue;
+		}
+		if (Object.keys(translations).length === 0) errors.push(`Term "${term}": has no translations.`);
+		for (const [locale, value] of Object.entries(translations)) {
+			if (!LOCALE_PATTERN.test(locale)) errors.push(`Term "${term}": "${locale}" is not a locale code. Terms nest as { "${term}": { "en": "…" } } — one term, its translations inside.`);
+			if (typeof value !== "string") errors.push(`Term "${term}" (${locale}): translation must be a string, got ${typeof value}.`);
+		}
+	}
+	return errors;
+}
+/**
+* Build the FileChange[] to add or update vocabulary terms.
+*
+* Vocabulary had no write tool at all: the rules forbid editing `.contentrain/`
+* by hand, and there was no supported way to obey that. This closes it through
+* the same plan/apply path every other write uses, so it lands on a `cr/*`
+* branch and follows the project's workflow like anything else.
+*/
+async function planVocabularySave(reader, input) {
+	const errors = validateTerms(input.terms);
+	if (errors.length > 0) throw new Error(`Vocabulary validation failed:\n- ${errors.join("\n- ")}`);
+	const existing = await readVocabulary(reader);
+	const added = [];
+	const updated = [];
+	const advisories = [];
+	const merged = { ...existing.terms };
+	for (const [term, translations] of Object.entries(input.terms)) {
+		const prior = existing.terms[term];
+		if (!prior) {
+			added.push(term);
+			merged[term] = { ...translations };
+			continue;
+		}
+		updated.push(term);
+		merged[term] = {
+			...prior,
+			...translations
+		};
+		const changed = Object.entries(translations).filter(([l, v]) => l in prior && prior[l] !== v);
+		if (changed.length > 0) {
+			const shown = changed.slice(0, MAX_REPORTED_TERMS);
+			const detail = shown.map(([l, v]) => `${l}: "${prior[l]}" → "${v}"`).join(", ");
+			const more = changed.length > shown.length ? `, and ${changed.length - shown.length} more` : "";
+			advisories.push(`Term "${term}": replaced ${changed.length} translation(s) — ${detail}${more}.`);
+		}
+	}
+	const byValue = /* @__PURE__ */ new Map();
+	for (const [term, translations] of Object.entries(merged)) for (const value of Object.values(translations)) {
+		const owner = byValue.get(value);
+		if (owner && owner !== term) advisories.push(`Terms "${owner}" and "${term}" share the translation "${value}".`);
+		else byValue.set(value, term);
+	}
+	return {
+		changes: [{
+			path: VOCABULARY_PATH,
+			content: canonicalStringify({
+				version: existing.version,
+				terms: merged
+			})
+		}],
+		result: {
+			added,
+			updated,
+			total: Object.keys(merged).length
+		},
+		advisories
+	};
+}
+/** Build the FileChange[] to remove vocabulary terms. */
+async function planVocabularyDelete(reader, input) {
+	const existing = await readVocabulary(reader);
+	const deleted = [];
+	const missing = [];
+	const remaining = { ...existing.terms };
+	for (const term of input.terms) if (term in remaining) {
+		delete remaining[term];
+		deleted.push(term);
+	} else missing.push(term);
+	const advisories = missing.length > 0 ? [`Not in the vocabulary, so nothing to delete: ${missing.join(", ")}.`] : [];
+	return {
+		changes: deleted.length > 0 ? [{
+			path: VOCABULARY_PATH,
+			content: canonicalStringify({
+				version: existing.version,
+				terms: remaining
+			})
+		}] : [],
+		result: {
+			deleted,
+			missing,
+			total: Object.keys(remaining).length
+		},
+		advisories
+	};
+}
+//#endregion
+export { planContentSave as a, planModelDelete as i, planVocabularySave as n, planContentDelete as o, planModelSave as r, applyChangesToWorktree as s, planVocabularyDelete as t };
 
-//# sourceMappingURL=ops-CGKIKwDc.mjs.map
+//# sourceMappingURL=ops-BzbThweu.mjs.map

package/dist/ops-BzbThweu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-BzbThweu.mjs","names":["canonicalStringify","parseMarkdownFrontmatter","serializeMarkdownFrontmatter","canonicalStringify","canonicalStringify"],"sources":["../src/core/ops/apply-to-worktree.ts","../src/core/ops/content-delete.ts","../src/core/media/media-rewrite.ts","../src/core/ops/content-save.ts","../src/core/ops/model-delete.ts","../src/core/ops/model-save.ts","../src/core/ops/vocabulary-save.ts"],"sourcesContent":["import { mkdir, rm, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport type { FileChange } from '../contracts/index.js'\n\n/**\n * Phase 2 shim — applies a `FileChange[]` to a local worktree directory.\n *\n * Phase 3 replaces this with `LocalProvider.applyPlan` (same logic, owned by\n * the provider) while a `GitHubProvider.applyPlan` produces the equivalent\n * commit through the Git Data API. Until then, tool handlers call this shim\n * inside the existing `createTransaction` flow so Phase 2 gets plan/apply\n * semantics without rewriting the transaction machinery.\n *\n * - `content: string` → `writeFile` (creates parent dirs).\n * - `content: null` → `rm`; missing files are tolerated.\n * - Changes are applied in their given order; callers should sort for\n *   determinism.\n */\nexport async function applyChangesToWorktree(worktree: string, changes: readonly FileChange[]): Promise<void> {\n  for (const change of changes) {\n    const absolute = join(worktree, change.path)\n    if (change.content === null) {\n      await rm(absolute, { force: true }).catch(() => { /* tolerate missing */ })\n      continue\n    }\n    await mkdir(dirname(absolute), { recursive: true })\n    await writeFile(absolute, change.content, 'utf-8')\n  }\n}\n","import type { EntryMeta, ModelDefinition } from '@contentrain/types'\nimport { validateSlug } from '@contentrain/types'\nimport type { FileChange, RepoReader } from '../contracts/index.js'\nimport { canonicalStringify } from '../serialization/index.js'\nimport { contentFilePath, documentFilePath, metaFilePath } from './paths.js'\nimport type { OpPlan } from './types.js'\n\nexport interface ContentDeleteInput {\n  model: ModelDefinition\n  id?: string\n  slug?: string\n  locale?: string\n  keys?: string[]\n  /**\n   * `config.locales.default` — where a non-i18n model's single meta record\n   * lives. Required to resolve meta paths; see `metaFilePath`.\n   */\n  defaultLocale: string\n}\n\nexport type ContentDeletePlan = OpPlan<string[]>\n\nfunction contentDir(model: Pick<ModelDefinition, 'domain' | 'id' | 'content_path'>): string {\n  return model.content_path ?? `.contentrain/content/${model.domain}/${model.id}`\n}\n\nasync function tryReadJson<T>(reader: RepoReader, path: string): Promise<T | null> {\n  try {\n    return JSON.parse(await reader.readFile(path)) as T\n  } catch {\n    return null\n  }\n}\n\nasync function discoverCollectionLocales(\n  reader: RepoReader,\n  model: ModelDefinition,\n): Promise<string[]> {\n  const dir = contentDir(model)\n  const files = await reader.listDirectory(dir)\n  const strategy = model.locale_strategy ?? 'file'\n  if (strategy === 'directory') {\n    return files\n  }\n  return files\n    .filter(f => f.endsWith('.json'))\n    .map(f => f.replace('.json', '').replace(`${model.id}.`, ''))\n}\n\n/**\n * Build the FileChange[] required to delete content. Pure — touches no disk.\n *\n * Semantics preserved from legacy `deleteContent`:\n * - Collection: remove the entry ID from each locale's content file and its\n *   meta file. Meta file is deleted outright if the removal empties it.\n * - Singleton: delete the locale's content + meta file (locale-scoped when\n *   i18n, non-i18n removes whatever meta lives under `.contentrain/meta/{id}/`).\n * - Dictionary: two modes — key-scoped removal updates the file in place,\n *   or locale-scoped removes the content + meta pair.\n * - Document: strategy-aware delete (file/suffix/directory/none), plus\n *   meta removal under `.contentrain/meta/{id}/{slug}/`.\n */\nexport async function planContentDelete(\n  reader: RepoReader,\n  input: ContentDeleteInput,\n): Promise<ContentDeletePlan> {\n  const { model } = input\n\n  // A non-i18n model stores content locale-agnostically in data.json and keeps\n  // exactly one meta record, pinned to the default locale. A locale-scoped\n  // delete is therefore meaningless — and actively destructive: the locale\n  // silently maps onto data.json and the default-locale meta, so passing a\n  // non-default locale deletes the shared content and the wrong meta while the\n  // named locale's stray meta is never touched. Reject it; stray per-locale\n  // meta is cleaned up by `contentrain_validate fix:true`.\n  if (!model.i18n && input.locale) {\n    throw new Error(\n      `Model \"${model.id}\" has i18n disabled — its content is locale-agnostic (stored in data.json), `\n      + 'so a locale-scoped delete is invalid. Omit \"locale\" to delete the entry, '\n      + 'or run contentrain_validate fix:true to remove stray per-locale meta files.',\n    )\n  }\n\n  const changes: FileChange[] = []\n  const removed: string[] = []\n\n  switch (model.kind) {\n    case 'collection': {\n      if (!input.id) throw new Error('Collection delete requires an entry ID')\n\n      const locales = input.locale\n        ? [input.locale]\n        : await discoverCollectionLocales(reader, model)\n\n      for (const loc of locales) {\n        const cPath = contentFilePath(model, loc)\n        const data = await tryReadJson<Record<string, unknown>>(reader, cPath)\n        if (!data || !(input.id in data)) continue\n        delete data[input.id]\n        const sorted: Record<string, unknown> = {}\n        for (const k of Object.keys(data).toSorted()) sorted[k] = data[k]\n        changes.push({ path: cPath, content: canonicalStringify(sorted) })\n        removed.push(`content/${model.domain}/${model.id}/${loc}.json#${input.id}`)\n      }\n\n      for (const loc of locales) {\n        // For a non-i18n model `loc` is the pseudo-locale \"data\" (discovered from\n        // data.json); metaFilePath maps it onto the default locale regardless.\n        const mPath = metaFilePath(model, loc, input.defaultLocale)\n        const meta = await tryReadJson<Record<string, EntryMeta>>(reader, mPath)\n        if (!meta || !(input.id in meta)) continue\n        delete meta[input.id]\n        if (Object.keys(meta).length > 0) {\n          changes.push({ path: mPath, content: canonicalStringify(meta) })\n        } else {\n          changes.push({ path: mPath, content: null })\n        }\n      }\n      break\n    }\n\n    case 'singleton': {\n      if (model.i18n && !input.locale) {\n        throw new Error('Singleton delete requires a locale when i18n is enabled')\n      }\n      const locale = input.locale ?? 'data'\n      const cPath = contentFilePath(model, locale)\n      changes.push({ path: cPath, content: null })\n      removed.push(model.i18n\n        ? `content/${model.domain}/${model.id}/${locale}.json`\n        : `content/${model.domain}/${model.id}/data.json`)\n\n      if (model.i18n) {\n        changes.push({ path: metaFilePath(model, locale, input.defaultLocale), content: null })\n      } else {\n        // Removing data.json leaves a non-i18n model with no content at all, so\n        // every meta file under it goes — including strays left by older writes.\n        await pushAllMetaForModel(reader, model.id, changes)\n      }\n      break\n    }\n\n    case 'dictionary': {\n      if (model.i18n && !input.locale) {\n        throw new Error('Dictionary delete requires a locale when i18n is enabled')\n      }\n      const locale = input.locale ?? 'data'\n      const cPath = contentFilePath(model, locale)\n\n      if (input.keys?.length) {\n        const existing = (await tryReadJson<Record<string, string>>(reader, cPath)) ?? {}\n        const notFound: string[] = []\n        for (const key of input.keys) {\n          if (key in existing) delete existing[key]\n          else notFound.push(key)\n        }\n        if (notFound.length > 0) {\n          throw new Error(`Dictionary \"${model.id}\" (${locale}): keys not found — [${notFound.join(', ')}]`)\n        }\n        changes.push({ path: cPath, content: canonicalStringify(existing) })\n        removed.push(...input.keys.map(k => `${model.id}/${locale}:${k}`))\n      } else {\n        changes.push({ path: cPath, content: null })\n        removed.push(model.i18n\n          ? `content/${model.domain}/${model.id}/${locale}.json`\n          : `content/${model.domain}/${model.id}/data.json`)\n        if (model.i18n) {\n          changes.push({ path: metaFilePath(model, locale, input.defaultLocale), content: null })\n        } else {\n          await pushAllMetaForModel(reader, model.id, changes)\n        }\n      }\n      break\n    }\n\n    case 'document': {\n      if (!input.slug) throw new Error('Document delete requires a slug')\n      const slugErr = validateSlug(input.slug)\n      if (slugErr) throw new Error(slugErr)\n\n      const dir = contentDir(model)\n      const strategy = model.locale_strategy ?? 'file'\n\n      if (!model.i18n) {\n        changes.push({ path: `${dir}/${input.slug}.md`, content: null })\n      } else if (strategy === 'file') {\n        const slugDir = `${dir}/${input.slug}`\n        const files = await reader.listDirectory(slugDir)\n        for (const f of files) changes.push({ path: `${slugDir}/${f}`, content: null })\n      } else if (input.locale) {\n        changes.push({ path: documentFilePath(model, input.locale, input.slug), content: null })\n      } else if (strategy === 'suffix') {\n        const files = await reader.listDirectory(dir)\n        for (const f of files) {\n          if (f.startsWith(`${input.slug}.`) && f.endsWith('.md')) {\n            changes.push({ path: `${dir}/${f}`, content: null })\n          }\n        }\n      } else if (strategy === 'directory') {\n        const subdirs = await reader.listDirectory(dir)\n        for (const d of subdirs) {\n          const filePath = `${dir}/${d}/${input.slug}.md`\n          if (await reader.fileExists(filePath)) {\n            changes.push({ path: filePath, content: null })\n          }\n        }\n      } else if (strategy === 'none') {\n        const files = await reader.listDirectory(dir)\n        if (files.includes(`${input.slug}.md`)) {\n          changes.push({ path: `${dir}/${input.slug}.md`, content: null })\n        }\n      }\n\n      removed.push(`${model.content_path ?? `content/${model.domain}/${model.id}`}/${input.slug}`)\n\n      const metaSlugDir = `.contentrain/meta/${model.id}/${input.slug}`\n      if (input.locale) {\n        changes.push({ path: `${metaSlugDir}/${input.locale}.json`, content: null })\n      } else {\n        const metaFiles = await reader.listDirectory(metaSlugDir)\n        for (const f of metaFiles) changes.push({ path: `${metaSlugDir}/${f}`, content: null })\n      }\n      break\n    }\n  }\n\n  changes.sort((a, b) => a.path.localeCompare(b.path))\n  return { changes, result: removed, advisories: [] }\n}\n\nasync function pushAllMetaForModel(reader: RepoReader, modelId: string, changes: FileChange[]): Promise<void> {\n  const metaDir = `.contentrain/meta/${modelId}`\n  const files = await reader.listDirectory(metaDir)\n  for (const f of files) changes.push({ path: `${metaDir}/${f}`, content: null })\n}\n","import type { FieldDef, FieldType } from '@contentrain/types'\n\n/**\n * Media path → delivery URL rewriting for MCP content writes.\n *\n * Ported from Studio's `server/utils/media-rewrite.ts`, with one deliberate\n * difference: Studio derives the delivery base from a `projectId` plus its\n * runtime config, whereas MCP receives the fully-qualified per-project base\n * directly via `RepoProvider.mediaBaseUrl`\n * (`{siteUrl}/api/cdn/v1/{projectId}` — the project segment is already\n * included). So here `toDeliveryUrl` is a single `{base}/{path}` join.\n *\n * Why this exists: Studio stores uploaded media in CDN/R2 and references it\n * from content by a relative storage path (`media/...`). That path renders\n * nowhere on its own — it must become an absolute, public delivery URL before\n * it reaches a browser. When an external agent writes through MCP Cloud, the\n * write bypasses Studio's content-engine and goes straight through\n * `planContentSave`, so this is where the normalization has to happen: the\n * git-committed value is then already a ready-to-use URL for any consumer\n * (`@contentrain/query`, raw markdown, a plain landing page) with no SDK.\n *\n * Only image/video/file fields (resolved via the model schema, including those\n * nested in object/array fields) and `media/...` src/href targets in\n * markdown/HTML are rewritten. External URLs (`http(s)://`, `//`, `data:`) and\n * already-absolute delivery URLs pass through untouched, so every entry point\n * is idempotent and safe to call repeatedly. In local mode (no base) media\n * stays a relative path — the OSS file model.\n */\n\nconst MEDIA_FIELD_TYPES = new Set<FieldType>(['image', 'video', 'file'])\n\n/**\n * Whether a stored field value is a relative media-storage path (`media/...`)\n * rather than an already-absolute URL or external link. Only these are\n * rewritten to delivery URLs — `http(s)://`, `//`, and `data:` are left as-is.\n */\nexport function isStoredMediaPath(value: unknown): value is string {\n  return typeof value === 'string' && value.startsWith('media/')\n}\n\n/** Join a relative media path onto the per-project delivery base. */\nexport function toDeliveryUrl(base: string, path: string): string {\n  return `${base.replace(/\\/+$/, '')}/${path}`\n}\n\n/**\n * Rewrite a stored media path to its absolute delivery URL. Non-media values\n * (external URLs, empty, non-strings) pass through untouched, so this is safe\n * to call on any field value.\n */\nexport function rewriteMediaUrl(base: string, value: unknown): unknown {\n  return isStoredMediaPath(value) ? toDeliveryUrl(base, value) : value\n}\n\n/**\n * Rewrite media paths within a single field value, guided by its FieldDef so\n * only media fields — including those nested inside object/array fields — are\n * touched. Non-media values pass through.\n */\nexport function rewriteFieldMedia(value: unknown, field: FieldDef, base: string): unknown {\n  if (value == null) return value\n\n  if (MEDIA_FIELD_TYPES.has(field.type))\n    return rewriteMediaUrl(base, value)\n\n  if (field.type === 'object' && field.fields && typeof value === 'object' && !Array.isArray(value))\n    return rewriteEntryMedia(value as Record<string, unknown>, field.fields, base)\n\n  if (field.type === 'array' && Array.isArray(value)) {\n    const itemDef: FieldDef | null = typeof field.items === 'string'\n      ? { type: field.items as FieldType }\n      : field.items ?? null\n    if (!itemDef) return value\n    return value.map(v => rewriteFieldMedia(v, itemDef, base))\n  }\n\n  return value\n}\n\n/**\n * Rewrite media paths across one entry/frontmatter object using a field map.\n * Returns a shallow copy (the input is never mutated); a no-op when the object\n * has no media fields.\n */\nexport function rewriteEntryMedia(\n  entry: Record<string, unknown>,\n  fields: Record<string, FieldDef>,\n  base: string,\n): Record<string, unknown> {\n  const out = { ...entry }\n  for (const [fieldId, field] of Object.entries(fields)) {\n    if (fieldId in out)\n      out[fieldId] = rewriteFieldMedia(out[fieldId], field, base)\n  }\n  return out\n}\n\n/** Rewrite `media/...` markdown image/link targets and inline src/href attrs. */\nexport function rewriteMarkdownMedia(body: string, base: string): string {\n  return body\n    // markdown image/link target: ](media/...) — stops at whitespace, ) or \"\n    .replace(/(\\]\\()(media\\/[^)\\s\"]+)/g, (_m, open, p) => `${open}${toDeliveryUrl(base, p)}`)\n    // inline HTML src=/href=\"media/...\"\n    .replace(/(\\s(?:src|href)=)([\"'])(media\\/[^\"']+)\\2/gi,\n      (_m, attr, quote, p) => `${attr}${quote}${toDeliveryUrl(base, p)}${quote}`)\n}\n","import type { ContentrainConfig, EntryMeta, ModelDefinition, Vocabulary } from '@contentrain/types'\nimport { generateEntryId, validateEntryId, validateLocale, validateSlug } from '@contentrain/types'\nimport type { FileChange, RepoReader } from '../contracts/index.js'\nimport type { ContentEntry } from '../content-manager.js'\nimport { canonicalStringify, parseMarkdownFrontmatter, serializeMarkdownFrontmatter } from '../serialization/index.js'\nimport { rewriteEntryMedia, rewriteMarkdownMedia } from '../media/media-rewrite.js'\nimport type { ContentSaveEntryResult, ContentSavePlan } from './types.js'\nimport { contentFilePath, documentFilePath, metaFilePath } from './paths.js'\nimport { mergeEntryMeta } from '../meta-manager.js'\n\n/** Keys named individually in a replacement advisory before it collapses to a count. */\nconst MAX_REPORTED_KEYS = 5\n\ninterface PlanInput {\n  model: ModelDefinition\n  entries: ContentEntry[]\n  config: ContentrainConfig\n  vocabulary?: Vocabulary | null\n  /**\n   * Per-project public media delivery base (`RepoProvider.mediaBaseUrl`). When\n   * set (hosted/cloud mode), relative `media/...` references in media fields\n   * and markdown bodies are normalized to absolute delivery URLs before the\n   * value is committed. Undefined in local mode — paths are kept verbatim.\n   */\n  mediaBaseUrl?: string\n}\n\n/**\n * Build the FileChange[] required to save a batch of content entries. The\n * plan is deterministic, pure, and does not touch disk — it reads existing\n * state through `reader` and returns changes for a single atomic commit.\n *\n * Grouping: multiple entries targeting the same (model, locale) share a\n * single content file and a single meta file. Reads are cached in-memory\n * so repeated reads of the same path during a plan are one IO.\n */\nexport async function planContentSave(reader: RepoReader, input: PlanInput): Promise<ContentSavePlan> {\n  const { model, entries, config, vocabulary, mediaBaseUrl } = input\n  const result: ContentSaveEntryResult[] = []\n  const advisories: string[] = []\n\n  // Hosted/cloud mode: normalize relative `media/...` references to absolute\n  // delivery URLs so the committed value renders anywhere with no SDK. A no-op\n  // in local mode (no base) or for field-less models (e.g. dictionaries).\n  const normalizeMedia = (data: Record<string, unknown>): Record<string, unknown> =>\n    mediaBaseUrl && model.fields ? rewriteEntryMedia(data, model.fields, mediaBaseUrl) : data\n\n  // In-memory accumulators keyed by content-root-relative path.\n  const contentByPath = new Map<string, unknown>()\n  const metaByPath = new Map<string, unknown>()\n  const markdownChanges = new Map<string, string>()\n\n  async function readJsonOrEmpty<T>(path: string): Promise<T> {\n    try {\n      return JSON.parse(await reader.readFile(path)) as T\n    } catch {\n      return {} as T\n    }\n  }\n\n  /** Absent file and absent entry both mean \"no prior meta\" — hence undefined, not `{}`. */\n  async function readJsonOrUndefined<T>(path: string): Promise<T | undefined> {\n    try {\n      return JSON.parse(await reader.readFile(path)) as T\n    } catch {\n      return undefined\n    }\n  }\n\n  /** Prior meta for a whole-file (non-collection) meta path, honouring the accumulator. */\n  async function priorMeta(mPath: string): Promise<EntryMeta | undefined> {\n    return (metaByPath.get(mPath) as EntryMeta | undefined)\n      ?? await readJsonOrUndefined<EntryMeta>(mPath)\n  }\n\n  const defaultLocale = config.locales.default\n\n  for (const entry of entries) {\n    const locale = entry.locale ?? defaultLocale\n\n    const localeErr = validateLocale(locale, config)\n    if (localeErr) throw new Error(localeErr)\n    if (entry.id) {\n      const err = validateEntryId(entry.id)\n      if (err) throw new Error(err)\n    }\n    if (entry.slug) {\n      const err = validateSlug(entry.slug)\n      if (err) throw new Error(err)\n    }\n\n    switch (model.kind) {\n      case 'singleton': {\n        const cPath = contentFilePath(model, locale)\n        const mPath = metaFilePath(model, locale, defaultLocale)\n        contentByPath.set(cPath, normalizeMedia(entry.data))\n        metaByPath.set(mPath, mergeEntryMeta(await priorMeta(mPath), entry.data))\n        result.push({ action: 'updated', locale })\n        break\n      }\n\n      case 'collection': {\n        const isNew = !entry.id\n        const id = entry.id ?? generateEntryId()\n        const cPath = contentFilePath(model, locale)\n        const mPath = metaFilePath(model, locale, defaultLocale)\n\n        const existing = (contentByPath.get(cPath) as Record<string, unknown> | undefined)\n          ?? await readJsonOrEmpty<Record<string, unknown>>(cPath)\n\n        const action: 'created' | 'updated' = isNew || !(id in existing) ? 'created' : 'updated'\n        existing[id] = normalizeMedia(entry.data)\n\n        const sorted: Record<string, unknown> = {}\n        for (const key of Object.keys(existing).toSorted()) {\n          sorted[key] = existing[key]\n        }\n        contentByPath.set(cPath, sorted)\n\n        const existingMeta = (metaByPath.get(mPath) as Record<string, EntryMeta> | undefined)\n          ?? await readJsonOrEmpty<Record<string, EntryMeta>>(mPath)\n        existingMeta[id] = mergeEntryMeta(existingMeta[id], entry.data)\n        metaByPath.set(mPath, existingMeta)\n\n        result.push({ action, id, locale })\n        break\n      }\n\n      case 'dictionary': {\n        const cPath = contentFilePath(model, locale)\n        const mPath = metaFilePath(model, locale, defaultLocale)\n\n        const existing = (contentByPath.get(cPath) as Record<string, string> | undefined)\n          ?? await readJsonOrEmpty<Record<string, string>>(cPath)\n\n        const newData = entry.data as Record<string, string>\n        const entryAdvisories: string[] = []\n\n        // Overwriting a key used to be refused outright, which made the most\n        // ordinary dictionary operation — correcting a translation — impossible:\n        // the workaround was delete, merge, save, merge. Four operations and two\n        // branches to fix one string. The refusal also advised \"include all keys\n        // in a single save call\", which cannot work, because the check compares\n        // values per key rather than counting them.\n        //\n        // Choosing a translation is a content decision, and MCP does not make\n        // those. It reports them — the same way the duplicate-value case two\n        // blocks below already does — and the branch diff shows the rest.\n        const replaced = Object.keys(newData).filter(\n          k => k in existing && existing[k] !== newData[k],\n        )\n        if (replaced.length > 0) {\n          const shown = replaced.slice(0, MAX_REPORTED_KEYS)\n          const detail = shown.map(k => `\"${k}\": \"${existing[k]}\" → \"${newData[k]}\"`).join(', ')\n          const more = replaced.length > shown.length ? `, and ${replaced.length - shown.length} more` : ''\n          entryAdvisories.push(\n            `Dictionary \"${model.id}\" (${locale}): replaced ${replaced.length} existing value(s) — ${detail}${more}.`,\n          )\n        }\n\n        const reverseMap = new Map<string, string>()\n        for (const [k, v] of Object.entries(existing)) reverseMap.set(v, k)\n        for (const [newKey, newValue] of Object.entries(newData)) {\n          if (newKey in existing) continue\n          const existingKey = reverseMap.get(newValue)\n          if (existingKey && existingKey !== newKey) {\n            entryAdvisories.push(\n              `Value \"${newValue}\" already exists as key \"${existingKey}\". Consider reusing instead of creating \"${newKey}\".`,\n            )\n          }\n        }\n\n        if (vocabulary && Object.keys(vocabulary.terms).length > 0) {\n          outer:\n          for (const [newKey, newValue] of Object.entries(newData)) {\n            if (newKey in existing) continue\n            for (const translations of Object.values(vocabulary.terms)) {\n              if (Object.values(translations).includes(newValue)) {\n                entryAdvisories.push(\n                  `Value \"${newValue}\" matches a vocabulary term. Use the canonical form for consistency.`,\n                )\n                continue outer\n              }\n            }\n          }\n        }\n\n        advisories.push(...entryAdvisories)\n\n        contentByPath.set(cPath, { ...existing, ...newData })\n        metaByPath.set(mPath, mergeEntryMeta(await priorMeta(mPath), entry.data))\n\n        result.push({\n          action: 'updated',\n          locale,\n          ...(entryAdvisories.length > 0 ? { advisories: entryAdvisories } : {}),\n        })\n        break\n      }\n\n      case 'document': {\n        const entryAdvisories: string[] = []\n        const slug = entry.slug ?? (entry.data['slug'] as string | undefined)\n        if (!slug) throw new Error('Document entries require a slug')\n        const slugErr = validateSlug(slug)\n        if (slugErr) throw new Error(slugErr)\n\n        const incomingFm = { ...entry.data }\n        const bodySent = 'body' in incomingFm\n        const incomingBody = (incomingFm['body'] as string | undefined) ?? ''\n        delete incomingFm['body']\n        if (!incomingFm['slug']) incomingFm['slug'] = slug\n\n        const dPath = documentFilePath(model, locale, slug)\n        const mPath = metaFilePath(model, locale, defaultLocale, slug)\n\n        // Accumulator before disk, as the collection branch does: two entries\n        // touching one document in a single call must compose, not race.\n        let existingRaw: string | null = markdownChanges.get(dPath) ?? null\n        if (existingRaw === null) {\n          try { existingRaw = await reader.readFile(dPath) }\n          catch { /* not yet */ }\n        }\n        // Same rule the collection branch uses: anything already present —\n        // on disk or produced earlier in this plan — makes this an update.\n        const action: 'created' | 'updated' = existingRaw ? 'updated' : 'created'\n\n        // Merge with what is on disk, the way collections and singletons above\n        // already do. Documents were the only kind that replaced instead of\n        // merging, so a save that touched one frontmatter field wrote a file\n        // containing only that field — and an entirely empty body. Nothing\n        // reported it: the response said `valid: true`, because validation runs\n        // over the plan's own output, which was internally consistent and\n        // wrong. Under auto-merge that reaches the default branch directly.\n        const existing = existingRaw ? parseMarkdownFrontmatter(existingRaw) : null\n        const fmData = { ...existing?.frontmatter, ...incomingFm }\n\n        // Absent `body` means \"I am not editing the body\" — keep what is there.\n        // A `body` that is present, even empty, is an instruction, and is\n        // honoured; clearing real content that way is announced rather than\n        // silent, because it is indistinguishable from a templating mistake.\n        const bodyContent = bodySent ? incomingBody : (existing?.body ?? '')\n        if (bodySent && !incomingBody.trim() && existing?.body.trim()) {\n          const notice = `Document \"${slug}\" (${locale}): body cleared — an explicit empty \"body\" replaced ${existing.body.length} characters. Omit \"body\" to leave it untouched.`\n          entryAdvisories.push(notice)\n          advisories.push(notice)\n        }\n\n        // Frontmatter media fields go through the schema-guided rewrite; the\n        // markdown body has its `media/...` image/link targets rewritten too.\n        const normalizedBody = mediaBaseUrl ? rewriteMarkdownMedia(bodyContent, mediaBaseUrl) : bodyContent\n        markdownChanges.set(dPath, serializeMarkdownFrontmatter(normalizeMedia(fmData), normalizedBody))\n        metaByPath.set(mPath, mergeEntryMeta(await priorMeta(mPath), entry.data))\n\n        result.push({\n          action,\n          slug,\n          locale,\n          ...(entryAdvisories.length > 0 ? { advisories: entryAdvisories } : {}),\n        })\n        break\n      }\n    }\n  }\n\n  const changes: FileChange[] = []\n  for (const [path, data] of contentByPath) {\n    changes.push({ path, content: canonicalStringify(data) })\n  }\n  for (const [path, meta] of metaByPath) {\n    changes.push({ path, content: canonicalStringify(meta) })\n  }\n  for (const [path, content] of markdownChanges) {\n    changes.push({ path, content })\n  }\n  changes.sort((a, b) => a.path.localeCompare(b.path))\n\n  return { changes, result, advisories }\n}\n","import type { ModelDefinition } from '@contentrain/types'\nimport type { FileChange, RepoReader } from '../contracts/index.js'\nimport type { OpPlan } from './types.js'\n\nexport interface ModelDeleteInput {\n  model: ModelDefinition\n}\n\nexport type ModelDeletePlan = OpPlan<string[]>\n\n/**\n * Build the FileChange[] required to delete a model and its associated\n * content/meta files.\n *\n * The schema is at most two directory levels deep (e.g. document meta at\n * `.contentrain/meta/{id}/{slug}/{locale}.json`). The helper below walks\n * that much, which is enough for every model kind + locale strategy and\n * keeps us free of a general-purpose recursive lister for now.\n *\n * `result` is the legacy three-entry summary:\n * - `models/{id}.json`\n * - `content/{domain}/{id}/` (only if any content files existed)\n * - `meta/{id}/` (only if any meta files existed)\n */\nexport async function planModelDelete(reader: RepoReader, input: ModelDeleteInput): Promise<ModelDeletePlan> {\n  const { model } = input\n  const changes: FileChange[] = []\n  const removed: string[] = []\n\n  changes.push({ path: `.contentrain/models/${model.id}.json`, content: null })\n  removed.push(`models/${model.id}.json`)\n\n  const contentDir = model.content_path ?? `.contentrain/content/${model.domain}/${model.id}`\n  const contentFiles = await enumerateTwoLevels(reader, contentDir)\n  for (const path of contentFiles) {\n    changes.push({ path, content: null })\n  }\n  if (contentFiles.length > 0) {\n    removed.push(model.content_path ?? `content/${model.domain}/${model.id}/`)\n  }\n\n  const metaDir = `.contentrain/meta/${model.id}`\n  const metaFiles = await enumerateTwoLevels(reader, metaDir)\n  for (const path of metaFiles) {\n    changes.push({ path, content: null })\n  }\n  if (metaFiles.length > 0) {\n    removed.push(`meta/${model.id}/`)\n  }\n\n  changes.sort((a, b) => a.path.localeCompare(b.path))\n  return { changes, result: removed, advisories: [] }\n}\n\n/** List files up to two directory levels deep. Filters to `.json` and `.md`. */\nasync function enumerateTwoLevels(reader: RepoReader, dir: string): Promise<string[]> {\n  const results: string[] = []\n  const entries = await reader.listDirectory(dir)\n  for (const entry of entries) {\n    const path = `${dir}/${entry}`\n    if (entry.endsWith('.json') || entry.endsWith('.md')) {\n      results.push(path)\n      continue\n    }\n    const subEntries = await reader.listDirectory(path)\n    for (const sub of subEntries) {\n      if (sub.endsWith('.json') || sub.endsWith('.md')) {\n        results.push(`${path}/${sub}`)\n      }\n    }\n  }\n  return results\n}\n","import type { ModelDefinition } from '@contentrain/types'\nimport { MODEL_FIELD_ORDER } from '@contentrain/types'\nimport type { FileChange, RepoReader } from '../contracts/index.js'\nimport { canonicalStringify } from '../serialization/index.js'\nimport type { OpPlan } from './types.js'\n\nexport interface ModelSaveInput {\n  model: ModelDefinition\n}\n\nexport interface ModelSaveResult {\n  action: 'created' | 'updated'\n  id: string\n}\n\nexport type ModelSavePlan = OpPlan<ModelSaveResult>\n\n/**\n * Build the FileChange[] required to create or update a model definition.\n *\n * The only disk change is the model JSON file itself. Content and meta\n * directories are created on-demand when their first write lands — git does\n * not track empty directories, and MCP's write helpers `mkdir -p` before\n * every file write, so there is no operational reason to emit an empty-dir\n * ensure step here.\n */\nexport async function planModelSave(reader: RepoReader, input: ModelSaveInput): Promise<ModelSavePlan> {\n  const { model } = input\n  const modelPath = `.contentrain/models/${model.id}.json`\n\n  let action: 'created' | 'updated' = 'created'\n  try {\n    await reader.readFile(modelPath)\n    action = 'updated'\n  } catch { /* not yet exists */ }\n\n  const changes: FileChange[] = [\n    { path: modelPath, content: canonicalStringify(model, MODEL_FIELD_ORDER) },\n  ]\n\n  return {\n    changes,\n    result: { action, id: model.id },\n    advisories: [],\n  }\n}\n","import type { Vocabulary } from '@contentrain/types'\nimport { canonicalStringify, LOCALE_PATTERN, SLUG_PATTERN } from '@contentrain/types'\nimport type { FileChange, RepoReader } from '../contracts/index.js'\nimport type { OpPlan } from './types.js'\n\nconst VOCABULARY_PATH = '.contentrain/vocabulary.json'\n\n/** Terms named individually in an advisory before it collapses to a count. */\nconst MAX_REPORTED_TERMS = 5\n\nexport interface VocabularySaveInput {\n  /**\n   * Terms to add or update, keyed by term slug, each holding its translations\n   * keyed by locale. Merged with what is already there — a term absent from\n   * this map is untouched.\n   */\n  terms: Record<string, Record<string, string>>\n}\n\nexport interface VocabularyDeleteInput {\n  /** Term slugs to remove. A slug that is not present is reported, not an error. */\n  terms: string[]\n}\n\nexport interface VocabularySaveResult {\n  added: string[]\n  updated: string[]\n  total: number\n}\n\nexport interface VocabularyDeleteResult {\n  deleted: string[]\n  missing: string[]\n  total: number\n}\n\nexport type VocabularySavePlan = OpPlan<VocabularySaveResult>\nexport type VocabularyDeletePlan = OpPlan<VocabularyDeleteResult>\n\nasync function readVocabulary(reader: RepoReader): Promise<Vocabulary> {\n  try {\n    const parsed = JSON.parse(await reader.readFile(VOCABULARY_PATH)) as Partial<Vocabulary>\n    return { version: parsed.version ?? 1, terms: parsed.terms ?? {} }\n  } catch {\n    return { version: 1, terms: {} }\n  }\n}\n\n/**\n * Validate the shape callers get wrong.\n *\n * The nesting is `term -> locale -> translation`, and it reads identically the\n * other way round, so a caller that groups by locale at the top level produces\n * a structurally valid file that matches nothing. That is not a typo anyone\n * notices — the vocabulary simply stops having any effect. Checking that outer\n * keys are term slugs and inner keys are locale codes catches the inversion at\n * the point of writing.\n */\nfunction validateTerms(terms: Record<string, Record<string, string>>): string[] {\n  const errors: string[] = []\n\n  for (const [term, translations] of Object.entries(terms)) {\n    if (!SLUG_PATTERN.test(term)) {\n      errors.push(`Term \"${term}\": must be kebab-case. The outer key is the term, not a locale.`)\n    }\n    if (typeof translations !== 'object' || translations === null || Array.isArray(translations)) {\n      errors.push(`Term \"${term}\": expected an object of locale → translation.`)\n      continue\n    }\n    if (Object.keys(translations).length === 0) {\n      errors.push(`Term \"${term}\": has no translations.`)\n    }\n    for (const [locale, value] of Object.entries(translations)) {\n      if (!LOCALE_PATTERN.test(locale)) {\n        errors.push(\n          `Term \"${term}\": \"${locale}\" is not a locale code. Terms nest as { \"${term}\": { \"en\": \"…\" } } — one term, its translations inside.`,\n        )\n      }\n      if (typeof value !== 'string') {\n        errors.push(`Term \"${term}\" (${locale}): translation must be a string, got ${typeof value}.`)\n      }\n    }\n  }\n\n  return errors\n}\n\n/**\n * Build the FileChange[] to add or update vocabulary terms.\n *\n * Vocabulary had no write tool at all: the rules forbid editing `.contentrain/`\n * by hand, and there was no supported way to obey that. This closes it through\n * the same plan/apply path every other write uses, so it lands on a `cr/*`\n * branch and follows the project's workflow like anything else.\n */\nexport async function planVocabularySave(\n  reader: RepoReader,\n  input: VocabularySaveInput,\n): Promise<VocabularySavePlan> {\n  const errors = validateTerms(input.terms)\n  if (errors.length > 0) {\n    throw new Error(`Vocabulary validation failed:\\n- ${errors.join('\\n- ')}`)\n  }\n\n  const existing = await readVocabulary(reader)\n  const added: string[] = []\n  const updated: string[] = []\n  const advisories: string[] = []\n\n  const merged: Record<string, Record<string, string>> = { ...existing.terms }\n  for (const [term, translations] of Object.entries(input.terms)) {\n    const prior = existing.terms[term]\n    if (!prior) {\n      added.push(term)\n      merged[term] = { ...translations }\n      continue\n    }\n    updated.push(term)\n    // Merge per locale: adding a Turkish translation must not drop the English.\n    merged[term] = { ...prior, ...translations }\n\n    const changed = Object.entries(translations).filter(([l, v]) => l in prior && prior[l] !== v)\n    if (changed.length > 0) {\n      const shown = changed.slice(0, MAX_REPORTED_TERMS)\n      const detail = shown.map(([l, v]) => `${l}: \"${prior[l]}\" → \"${v}\"`).join(', ')\n      const more = changed.length > shown.length ? `, and ${changed.length - shown.length} more` : ''\n      advisories.push(`Term \"${term}\": replaced ${changed.length} translation(s) — ${detail}${more}.`)\n    }\n  }\n\n  // A canonical term whose value duplicates another term's is the whole thing\n  // this file exists to prevent, so it is worth saying out loud.\n  const byValue = new Map<string, string>()\n  for (const [term, translations] of Object.entries(merged)) {\n    for (const value of Object.values(translations)) {\n      const owner = byValue.get(value)\n      if (owner && owner !== term) {\n        advisories.push(`Terms \"${owner}\" and \"${term}\" share the translation \"${value}\".`)\n      } else {\n        byValue.set(value, term)\n      }\n    }\n  }\n\n  const next: Vocabulary = { version: existing.version, terms: merged }\n  const changes: FileChange[] = [\n    { path: VOCABULARY_PATH, content: canonicalStringify(next) },\n  ]\n\n  return {\n    changes,\n    result: { added, updated, total: Object.keys(merged).length },\n    advisories,\n  }\n}\n\n/** Build the FileChange[] to remove vocabulary terms. */\nexport async function planVocabularyDelete(\n  reader: RepoReader,\n  input: VocabularyDeleteInput,\n): Promise<VocabularyDeletePlan> {\n  const existing = await readVocabulary(reader)\n\n  const deleted: string[] = []\n  const missing: string[] = []\n  const remaining = { ...existing.terms }\n\n  for (const term of input.terms) {\n    if (term in remaining) {\n      delete remaining[term]\n      deleted.push(term)\n    } else {\n      missing.push(term)\n    }\n  }\n\n  const advisories = missing.length > 0\n    ? [`Not in the vocabulary, so nothing to delete: ${missing.join(', ')}.`]\n    : []\n\n  // Nothing changed — emit no FileChange, so the caller can skip the commit\n  // rather than create an empty branch.\n  const changes: FileChange[] = deleted.length > 0\n    ? [{ path: VOCABULARY_PATH, content: canonicalStringify({ version: existing.version, terms: remaining } satisfies Vocabulary) }]\n    : []\n\n  return {\n    changes,\n    result: { deleted, missing, total: Object.keys(remaining).length },\n    advisories,\n  }\n}\n"],"mappings":"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"}

package/dist/{overlay-reader-DNaVsgiS.mjs → overlay-reader-CkU_pGXZ.mjs}

@@ -71,4 +71,4 @@ function normalise(path) {
 //#endregion
 export { OverlayReader as t };
 
-//# sourceMappingURL=overlay-reader-DNaVsgiS.mjs.map
+//# sourceMappingURL=overlay-reader-CkU_pGXZ.mjs.map

package/dist/{overlay-reader-DNaVsgiS.mjs.map → overlay-reader-CkU_pGXZ.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"overlay-reader-DNaVsgiS.mjs","names":[],"sources":["../src/core/overlay-reader.ts"],"sourcesContent":["import type { FileChange, RepoReader } from './contracts/index.js'\n\n/**\n * A RepoReader that overlays a set of pending FileChanges on top of an\n * underlying reader. Used in the remote-provider write path so helpers\n * like {@link import('./context.js').buildContextChange} and\n * {@link import('./validator/project.js').validateProject} see the\n * post-change state — the state the pending commit is about to produce\n * — rather than the pre-change base branch.\n *\n * Semantics:\n *\n * - `readFile(path)` — returns pending `content` when the overlay maps\n *   the path; falls back to the base reader otherwise. A pending delete\n *   (`content: null`) surfaces as \"missing\" (throws, matching\n *   `RepoReader.readFile`'s missing-file contract).\n *\n * - `listDirectory(path)` — merges the base directory listing with\n *   pending additions that live directly in the same folder, removes\n *   entries whose pending change is a delete, and de-duplicates the\n *   result. Pending paths in nested subdirectories surface only at\n *   their own listings.\n *\n * - `fileExists(path)` — pending adds → `true`, pending deletes →\n *   `false`, otherwise delegates.\n *\n * The overlay keys are canonicalised to match the FileChange contract:\n * forward slashes, no leading `/`, no `..` segments (FileChanges are\n * required to respect these invariants).\n */\nexport class OverlayReader implements RepoReader {\n  private readonly overlay: Map<string, FileChange>\n\n  constructor(\n    private readonly base: RepoReader,\n    pendingChanges: FileChange[],\n  ) {\n    this.overlay = new Map()\n    for (const change of pendingChanges) {\n      this.overlay.set(normalise(change.path), change)\n    }\n  }\n\n  async readFile(path: string, ref?: string): Promise<string> {\n    const key = normalise(path)\n    const pending = this.overlay.get(key)\n    if (pending) {\n      if (pending.content === null) {\n        throw new Error(`OverlayReader: \"${path}\" is marked for deletion`)\n      }\n      return pending.content\n    }\n    return this.base.readFile(path, ref)\n  }\n\n  async listDirectory(path: string, ref?: string): Promise<string[]> {\n    const baseEntries = await this.base.listDirectory(path, ref)\n    const dirKey = normalise(path)\n    const prefix = dirKey === '' ? '' : `${dirKey}/`\n\n    const direct = [...this.overlay.entries()]\n      .filter(([key]) => key.startsWith(prefix))\n      .map(([key, change]) => ({\n        name: key.slice(prefix.length).split('/')[0] ?? '',\n        isNested: key.slice(prefix.length).includes('/'),\n        deleted: change.content === null,\n      }))\n      .filter(entry => entry.name.length > 0)\n\n    // For nested pending paths (e.g. overlay at `dir/sub/a.json` when\n    // listing `dir`), the immediate child directory `sub` must surface\n    // even though no pending change targets it directly.\n    const deleted = new Set(\n      direct.filter(e => e.deleted && !e.isNested).map(e => e.name),\n    )\n    const added = direct\n      .filter(e => !e.deleted)\n      .map(e => e.name)\n\n    const result = baseEntries.filter(n => !deleted.has(n))\n    for (const name of added) {\n      if (!result.includes(name)) result.push(name)\n    }\n    return result\n  }\n\n  async fileExists(path: string, ref?: string): Promise<boolean> {\n    const key = normalise(path)\n    const pending = this.overlay.get(key)\n    if (pending) return pending.content !== null\n    return this.base.fileExists(path, ref)\n  }\n}\n\nfunction normalise(path: string): string {\n  return path.replace(/^\\/+/, '')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,IAAa,gBAAb,MAAiD;CAC/C;CAEA,YACE,MACA,gBACA;AAFiB,OAAA,OAAA;AAGjB,OAAK,0BAAU,IAAI,KAAK;AACxB,OAAK,MAAM,UAAU,eACnB,MAAK,QAAQ,IAAI,UAAU,OAAO,KAAK,EAAE,OAAO;;CAIpD,MAAM,SAAS,MAAc,KAA+B;EAC1D,MAAM,MAAM,UAAU,KAAK;EAC3B,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI;AACrC,MAAI,SAAS;AACX,OAAI,QAAQ,YAAY,KACtB,OAAM,IAAI,MAAM,mBAAmB,KAAK,0BAA0B;AAEpE,UAAO,QAAQ;;AAEjB,SAAO,KAAK,KAAK,SAAS,MAAM,IAAI;;CAGtC,MAAM,cAAc,MAAc,KAAiC;EACjE,MAAM,cAAc,MAAM,KAAK,KAAK,cAAc,MAAM,IAAI;EAC5D,MAAM,SAAS,UAAU,KAAK;EAC9B,MAAM,SAAS,WAAW,KAAK,KAAK,GAAG,OAAO;EAE9C,MAAM,SAAS,CAAC,GAAG,KAAK,QAAQ,SAAS,CAAC,CACvC,QAAQ,CAAC,SAAS,IAAI,WAAW,OAAO,CAAC,CACzC,KAAK,CAAC,KAAK,aAAa;GACvB,MAAM,IAAI,MAAM,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM;GAChD,UAAU,IAAI,MAAM,OAAO,OAAO,CAAC,SAAS,IAAI;GAChD,SAAS,OAAO,YAAY;GAC7B,EAAE,CACF,QAAO,UAAS,MAAM,KAAK,SAAS,EAAE;EAKzC,MAAM,UAAU,IAAI,IAClB,OAAO,QAAO,MAAK,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,KAAI,MAAK,EAAE,KAAK,CAC9D;EACD,MAAM,QAAQ,OACX,QAAO,MAAK,CAAC,EAAE,QAAQ,CACvB,KAAI,MAAK,EAAE,KAAK;EAEnB,MAAM,SAAS,YAAY,QAAO,MAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;AACvD,OAAK,MAAM,QAAQ,MACjB,KAAI,CAAC,OAAO,SAAS,KAAK,CAAE,QAAO,KAAK,KAAK;AAE/C,SAAO;;CAGT,MAAM,WAAW,MAAc,KAAgC;EAC7D,MAAM,MAAM,UAAU,KAAK;EAC3B,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI;AACrC,MAAI,QAAS,QAAO,QAAQ,YAAY;AACxC,SAAO,KAAK,KAAK,WAAW,MAAM,IAAI;;;AAI1C,SAAS,UAAU,MAAsB;AACvC,QAAO,KAAK,QAAQ,QAAQ,GAAG"}
+{"version":3,"file":"overlay-reader-CkU_pGXZ.mjs","names":[],"sources":["../src/core/overlay-reader.ts"],"sourcesContent":["import type { FileChange, RepoReader } from './contracts/index.js'\n\n/**\n * A RepoReader that overlays a set of pending FileChanges on top of an\n * underlying reader. Used in the remote-provider write path so helpers\n * like {@link import('./context.js').buildContextChange} and\n * {@link import('./validator/project.js').validateProject} see the\n * post-change state — the state the pending commit is about to produce\n * — rather than the pre-change base branch.\n *\n * Semantics:\n *\n * - `readFile(path)` — returns pending `content` when the overlay maps\n *   the path; falls back to the base reader otherwise. A pending delete\n *   (`content: null`) surfaces as \"missing\" (throws, matching\n *   `RepoReader.readFile`'s missing-file contract).\n *\n * - `listDirectory(path)` — merges the base directory listing with\n *   pending additions that live directly in the same folder, removes\n *   entries whose pending change is a delete, and de-duplicates the\n *   result. Pending paths in nested subdirectories surface only at\n *   their own listings.\n *\n * - `fileExists(path)` — pending adds → `true`, pending deletes →\n *   `false`, otherwise delegates.\n *\n * The overlay keys are canonicalised to match the FileChange contract:\n * forward slashes, no leading `/`, no `..` segments (FileChanges are\n * required to respect these invariants).\n */\nexport class OverlayReader implements RepoReader {\n  private readonly overlay: Map<string, FileChange>\n\n  constructor(\n    private readonly base: RepoReader,\n    pendingChanges: FileChange[],\n  ) {\n    this.overlay = new Map()\n    for (const change of pendingChanges) {\n      this.overlay.set(normalise(change.path), change)\n    }\n  }\n\n  async readFile(path: string, ref?: string): Promise<string> {\n    const key = normalise(path)\n    const pending = this.overlay.get(key)\n    if (pending) {\n      if (pending.content === null) {\n        throw new Error(`OverlayReader: \"${path}\" is marked for deletion`)\n      }\n      return pending.content\n    }\n    return this.base.readFile(path, ref)\n  }\n\n  async listDirectory(path: string, ref?: string): Promise<string[]> {\n    const baseEntries = await this.base.listDirectory(path, ref)\n    const dirKey = normalise(path)\n    const prefix = dirKey === '' ? '' : `${dirKey}/`\n\n    const direct = [...this.overlay.entries()]\n      .filter(([key]) => key.startsWith(prefix))\n      .map(([key, change]) => ({\n        name: key.slice(prefix.length).split('/')[0] ?? '',\n        isNested: key.slice(prefix.length).includes('/'),\n        deleted: change.content === null,\n      }))\n      .filter(entry => entry.name.length > 0)\n\n    // For nested pending paths (e.g. overlay at `dir/sub/a.json` when\n    // listing `dir`), the immediate child directory `sub` must surface\n    // even though no pending change targets it directly.\n    const deleted = new Set(\n      direct.filter(e => e.deleted && !e.isNested).map(e => e.name),\n    )\n    const added = direct\n      .filter(e => !e.deleted)\n      .map(e => e.name)\n\n    const result = baseEntries.filter(n => !deleted.has(n))\n    for (const name of added) {\n      if (!result.includes(name)) result.push(name)\n    }\n    return result\n  }\n\n  async fileExists(path: string, ref?: string): Promise<boolean> {\n    const key = normalise(path)\n    const pending = this.overlay.get(key)\n    if (pending) return pending.content !== null\n    return this.base.fileExists(path, ref)\n  }\n}\n\nfunction normalise(path: string): string {\n  return path.replace(/^\\/+/, '')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,IAAa,gBAAb,MAAiD;CAC/C;CAEA,YACE,MACA,gBACA;AAFiB,OAAA,OAAA;AAGjB,OAAK,0BAAU,IAAI,KAAK;AACxB,OAAK,MAAM,UAAU,eACnB,MAAK,QAAQ,IAAI,UAAU,OAAO,KAAK,EAAE,OAAO;;CAIpD,MAAM,SAAS,MAAc,KAA+B;EAC1D,MAAM,MAAM,UAAU,KAAK;EAC3B,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI;AACrC,MAAI,SAAS;AACX,OAAI,QAAQ,YAAY,KACtB,OAAM,IAAI,MAAM,mBAAmB,KAAK,0BAA0B;AAEpE,UAAO,QAAQ;;AAEjB,SAAO,KAAK,KAAK,SAAS,MAAM,IAAI;;CAGtC,MAAM,cAAc,MAAc,KAAiC;EACjE,MAAM,cAAc,MAAM,KAAK,KAAK,cAAc,MAAM,IAAI;EAC5D,MAAM,SAAS,UAAU,KAAK;EAC9B,MAAM,SAAS,WAAW,KAAK,KAAK,GAAG,OAAO;EAE9C,MAAM,SAAS,CAAC,GAAG,KAAK,QAAQ,SAAS,CAAC,CACvC,QAAQ,CAAC,SAAS,IAAI,WAAW,OAAO,CAAC,CACzC,KAAK,CAAC,KAAK,aAAa;GACvB,MAAM,IAAI,MAAM,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM;GAChD,UAAU,IAAI,MAAM,OAAO,OAAO,CAAC,SAAS,IAAI;GAChD,SAAS,OAAO,YAAY;GAC7B,EAAE,CACF,QAAO,UAAS,MAAM,KAAK,SAAS,EAAE;EAKzC,MAAM,UAAU,IAAI,IAClB,OAAO,QAAO,MAAK,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,KAAI,MAAK,EAAE,KAAK,CAC9D;EACD,MAAM,QAAQ,OACX,QAAO,MAAK,CAAC,EAAE,QAAQ,CACvB,KAAI,MAAK,EAAE,KAAK;EAEnB,MAAM,SAAS,YAAY,QAAO,MAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;AACvD,OAAK,MAAM,QAAQ,MACjB,KAAI,CAAC,OAAO,SAAS,KAAK,CAAE,QAAO,KAAK,KAAK;AAE/C,SAAO;;CAGT,MAAM,WAAW,MAAc,KAAgC;EAC7D,MAAM,MAAM,UAAU,KAAK;EAC3B,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI;AACrC,MAAI,QAAS,QAAO,QAAQ,YAAY;AACxC,SAAO,KAAK,KAAK,WAAW,MAAM,IAAI;;;AAI1C,SAAS,UAAU,MAAsB;AACvC,QAAO,KAAK,QAAQ,QAAQ,GAAG"}

package/dist/{paths-enT2coeX.mjs → paths-CdPPWpbG.mjs}

@@ -24,4 +24,4 @@ function resolveRepoPath(contentRoot, relativePath) {
 //#endregion
 export { resolveRepoPath as t };
 
-//# sourceMappingURL=paths-enT2coeX.mjs.map
+//# sourceMappingURL=paths-CdPPWpbG.mjs.map

package/dist/{paths-enT2coeX.mjs.map → paths-CdPPWpbG.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"paths-enT2coeX.mjs","names":[],"sources":["../src/providers/shared/paths.ts"],"sourcesContent":["/**\n * Normalise an optional contentRoot — strip leading/trailing slashes,\n * treat `''`, `/` and `undefined` as \"no prefix\". Used by API-backed\n * providers (GitHub, GitLab, future Bitbucket) to anchor content-relative\n * paths against a repo subdirectory when Contentrain lives under a\n * monorepo path like `apps/web/.contentrain/`.\n */\nexport function normaliseContentRoot(raw?: string): string {\n  if (!raw || raw === '/' || raw === '') return ''\n  return raw.replace(/^\\/+|\\/+$/g, '')\n}\n\n/**\n * Resolve a content-root-relative path to a repo-relative path. The result\n * always uses forward slashes and has no leading slash — the form every\n * REST git API consumes for `file_path` / `path` query parameters and the\n * Git Data API tree entries.\n */\nexport function resolveRepoPath(contentRoot: string | undefined, relativePath: string): string {\n  const prefix = normaliseContentRoot(contentRoot)\n  const cleanPath = relativePath.replace(/^\\/+/, '')\n  return prefix ? `${prefix}/${cleanPath}` : cleanPath\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,qBAAqB,KAAsB;AACzD,KAAI,CAAC,OAAO,QAAQ,OAAO,QAAQ,GAAI,QAAO;AAC9C,QAAO,IAAI,QAAQ,cAAc,GAAG;;;;;;;;AAStC,SAAgB,gBAAgB,aAAiC,cAA8B;CAC7F,MAAM,SAAS,qBAAqB,YAAY;CAChD,MAAM,YAAY,aAAa,QAAQ,QAAQ,GAAG;AAClD,QAAO,SAAS,GAAG,OAAO,GAAG,cAAc"}
+{"version":3,"file":"paths-CdPPWpbG.mjs","names":[],"sources":["../src/providers/shared/paths.ts"],"sourcesContent":["/**\n * Normalise an optional contentRoot — strip leading/trailing slashes,\n * treat `''`, `/` and `undefined` as \"no prefix\". Used by API-backed\n * providers (GitHub, GitLab, future Bitbucket) to anchor content-relative\n * paths against a repo subdirectory when Contentrain lives under a\n * monorepo path like `apps/web/.contentrain/`.\n */\nexport function normaliseContentRoot(raw?: string): string {\n  if (!raw || raw === '/' || raw === '') return ''\n  return raw.replace(/^\\/+|\\/+$/g, '')\n}\n\n/**\n * Resolve a content-root-relative path to a repo-relative path. The result\n * always uses forward slashes and has no leading slash — the form every\n * REST git API consumes for `file_path` / `path` query parameters and the\n * Git Data API tree entries.\n */\nexport function resolveRepoPath(contentRoot: string | undefined, relativePath: string): string {\n  const prefix = normaliseContentRoot(contentRoot)\n  const cleanPath = relativePath.replace(/^\\/+/, '')\n  return prefix ? `${prefix}/${cleanPath}` : cleanPath\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,qBAAqB,KAAsB;AACzD,KAAI,CAAC,OAAO,QAAQ,OAAO,QAAQ,GAAI,QAAO;AAC9C,QAAO,IAAI,QAAQ,cAAc,GAAG;;;;;;;;AAStC,SAAgB,gBAAgB,aAAiC,cAA8B;CAC7F,MAAM,SAAS,qBAAqB,YAAY;CAChD,MAAM,YAAY,aAAa,QAAQ,QAAQ,GAAG;AAClD,QAAO,SAAS,GAAG,OAAO,GAAG,cAAc"}

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

@@ -1,4 +1,4 @@
-import { _ as RepoReader, g as RepoProvider, h as ProviderCapabilities, i as CommitAuthor, m as MergeResult, n as Branch, o as FileDiff, r as Commit, t as ApplyPlanInput } from "../../index-w8QHThNS.mjs";
+import { _ as RepoReader, g as RepoProvider, h as ProviderCapabilities, i as CommitAuthor, m as MergeResult, n as Branch, o as FileDiff, r as Commit, t as ApplyPlanInput } from "../../index-BWbTJlXm.mjs";
 import { Octokit } from "@octokit/rest";
 
 //#region src/providers/github/app-auth.d.ts

package/dist/providers/github/index.mjs

@@ -1,5 +1,5 @@
-import { t as isNotFoundError } from "../../errors-e0YdjooK.mjs";
-import { t as resolveRepoPath } from "../../paths-enT2coeX.mjs";
+import { t as isNotFoundError } from "../../errors-CvBS12e7.mjs";
+import { t as resolveRepoPath } from "../../paths-CdPPWpbG.mjs";
 import { CONTENTRAIN_BRANCH } from "@contentrain/types";
 import { createPrivateKey, createSign } from "node:crypto";
 //#region src/providers/github/app-auth.ts

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

@@ -1,4 +1,4 @@
-import { _ as RepoReader, g as RepoProvider, h as ProviderCapabilities, i as CommitAuthor, m as MergeResult, n as Branch, o as FileDiff, r as Commit, t as ApplyPlanInput } from "../../index-w8QHThNS.mjs";
+import { _ as RepoReader, g as RepoProvider, h as ProviderCapabilities, i as CommitAuthor, m as MergeResult, n as Branch, o as FileDiff, r as Commit, t as ApplyPlanInput } from "../../index-BWbTJlXm.mjs";
 import { Gitlab } from "@gitbeaker/rest";
 
 //#region src/providers/gitlab/capabilities.d.ts

package/dist/providers/gitlab/index.mjs

@@ -1,5 +1,5 @@
-import { t as isNotFoundError } from "../../errors-e0YdjooK.mjs";
-import { t as resolveRepoPath } from "../../paths-enT2coeX.mjs";
+import { t as isNotFoundError } from "../../errors-CvBS12e7.mjs";
+import { t as resolveRepoPath } from "../../paths-CdPPWpbG.mjs";
 import { CONTENTRAIN_BRANCH } from "@contentrain/types";
 //#region src/providers/gitlab/capabilities.ts
 /**

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

@@ -1,4 +1,4 @@
-import { _ as RepoReader, a as FileChange, g as RepoProvider, h as ProviderCapabilities$1, i as CommitAuthor, m as MergeResult, n as Branch, o as FileDiff, r as Commit } from "../../index-w8QHThNS.mjs";
+import { _ as RepoReader, a as FileChange, g as RepoProvider, h as ProviderCapabilities$1, i as CommitAuthor, m as MergeResult, n as Branch, o as FileDiff, r as Commit, y as WriteReadiness } from "../../index-BWbTJlXm.mjs";
 import { SyncResult, WorkflowMode } from "@contentrain/types";
 
 //#region src/providers/local/types.d.ts
@@ -72,6 +72,12 @@ declare class LocalProvider implements RepoProvider {
   readFile(path: string, ref?: string): Promise<string>;
   listDirectory(path: string, ref?: string): Promise<string[]>;
   fileExists(path: string, ref?: string): Promise<boolean>;
+  /**
+   * Branch pressure gate. Unmerged `cr/*` branches accumulate in a local repo
+   * and eventually have to stop new writes; hosted providers have no such
+   * limit, so they omit this method entirely.
+   */
+  checkWriteReadiness(): Promise<WriteReadiness>;
   applyPlan(input: LocalApplyPlanInput): Promise<LocalApplyResult>;
   listBranches(prefix?: string): Promise<Branch[]>;
   createBranch(name: string, fromRef?: string): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/providers/local/types.ts","../../../src/providers/local/provider.ts","../../../src/providers/local/reader.ts"],"mappings":";;;;;UAIiB,kBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;AAAA;;;;;;AAYF;;;;UAAiB,mBAAA;EAYL;EAVV,MAAA;EAY+B;EAV/B,OAAA,EAAS,UAAA;EAFT;EAIA,OAAA;EAFS;EAIT,MAAA,GAAS,YAAA;EAAT;EAEA,IAAA;EAAA;EAEA,OAAA,GAAU,kBAAA;EAAA;EAEV,gBAAA,GAAmB,YAAA;AAAA;AAAA,UAGJ,gBAAA,SAAyB,MAAA;EAHT;AAGjC;;;;;EAOE,cAAA;EAEA;EAAA,IAAA,GAAO,UAAA;EAEP;EAAA,OAAA;AAAA;;;;;AA5CF;;;;;;;;;;AAgBA;;;cCqBa,aAAA,YAAyB,YAAA;EAAA,SAIR,WAAA;EAAA,SAHnB,YAAA,EAAc,sBAAA;EAAA,iBACN,MAAA;cAEW,WAAA;EAI5B,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAItC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAI3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;EAIlC,SAAA,CAAU,KAAA,EAAO,mBAAA,GAAsB,OAAA,CAAQ,gBAAA;EA2BrD,YAAA,CAAa,MAAA,YAAkB,OAAA,CAAQ,MAAA;EAIjC,YAAA,CAAa,IAAA,UAAc,OAAA,YAAmB,OAAA;EAKpD,YAAA,CAAa,IAAA,WAAe,OAAA;EAI5B,aAAA,CAAc,MAAA,UAAgB,IAAA,YAAgB,OAAA,CAAQ,QAAA;EAKtD,WAAA,CAAY,MAAA,UAAgB,IAAA,WAAe,OAAA,CAAQ,WAAA;EAInD,QAAA,CAAS,MAAA,UAAgB,IAAA,YAAgB,OAAA;EAKzC,gBAAA,CAAA,GAAoB,OAAA;AAAA;;;;;;AD/GtB;;;;;;;;cEWa,WAAA,YAAuB,UAAA;EAAA,SACN,WAAA;cAAA,WAAA;EAEtB,QAAA,CAAS,IAAA,UAAc,IAAA,YAAgB,OAAA;EAIvC,aAAA,CAAc,IAAA,UAAc,IAAA,YAAgB,OAAA;EAQ5C,UAAA,CAAW,IAAA,UAAc,IAAA,YAAgB,OAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/providers/local/types.ts","../../../src/providers/local/provider.ts","../../../src/providers/local/reader.ts"],"mappings":";;;;;UAIiB,kBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;AAAA;;;;;;AAYF;;;;UAAiB,mBAAA;EAYL;EAVV,MAAA;EAY+B;EAV/B,OAAA,EAAS,UAAA;EAFT;EAIA,OAAA;EAFS;EAIT,MAAA,GAAS,YAAA;EAAT;EAEA,IAAA;EAAA;EAEA,OAAA,GAAU,kBAAA;EAAA;EAEV,gBAAA,GAAmB,YAAA;AAAA;AAAA,UAGJ,gBAAA,SAAyB,MAAA;EAHT;AAGjC;;;;;EAOE,cAAA;EAEA;EAAA,IAAA,GAAO,UAAA;EAEP;EAAA,OAAA;AAAA;;;;;AA5CF;;;;;;;;;;AAgBA;;;cCuBa,aAAA,YAAyB,YAAA;EAAA,SAIR,WAAA;EAAA,SAHnB,YAAA,EAAc,sBAAA;EAAA,iBACN,MAAA;cAEW,WAAA;EAI5B,QAAA,CAAS,IAAA,UAAc,GAAA,YAAe,OAAA;EAItC,aAAA,CAAc,IAAA,UAAc,GAAA,YAAe,OAAA;EAI3C,UAAA,CAAW,IAAA,UAAc,GAAA,YAAe,OAAA;EDnC/B;;;;;EC4CH,mBAAA,CAAA,GAAuB,OAAA,CAAQ,cAAA;EAO/B,SAAA,CAAU,KAAA,EAAO,mBAAA,GAAsB,OAAA,CAAQ,gBAAA;EA2BrD,YAAA,CAAa,MAAA,YAAkB,OAAA,CAAQ,MAAA;EAIjC,YAAA,CAAa,IAAA,UAAc,OAAA,YAAmB,OAAA;EAKpD,YAAA,CAAa,IAAA,WAAe,OAAA;EAI5B,aAAA,CAAc,MAAA,UAAgB,IAAA,YAAgB,OAAA,CAAQ,QAAA;EAKtD,WAAA,CAAY,MAAA,UAAgB,IAAA,WAAe,OAAA,CAAQ,WAAA;EAInD,QAAA,CAAS,MAAA,UAAgB,IAAA,YAAgB,OAAA;EAKzC,gBAAA,CAAA,GAAoB,OAAA;AAAA;;;;;;AD7HtB;;;;;;;;cEWa,WAAA,YAAuB,UAAA;EAAA,SACN,WAAA;cAAA,WAAA;EAEtB,QAAA,CAAS,IAAA,UAAc,IAAA,YAAgB,OAAA;EAIvC,aAAA,CAAc,IAAA,UAAc,IAAA,YAAgB,OAAA;EAQ5C,UAAA,CAAW,IAAA,UAAc,IAAA,YAAgB,OAAA;AAAA"}

package/dist/providers/local/index.mjs

@@ -1,13 +1,14 @@
 import "../../contracts-DfL0BfrD.mjs";
-import "../../ops-CGKIKwDc.mjs";
-import "../../serialization-B1CEzR4H.mjs";
+import "../../ops-BzbThweu.mjs";
+import "../../serialization-tmgfFBOh.mjs";
 import "../../fs-DLbVB-Ek.mjs";
-import "../../meta-manager-CJUiTgP2.mjs";
-import "../../config-oxxgznz7.mjs";
-import { C as LocalReader } from "../../model-manager-DP2CZiMT.mjs";
-import "../../context-DjglDPvj.mjs";
-import "../../branch-lifecycle-BAfgSQBv.mjs";
-import "../../id-DV_T9Ic8.mjs";
-import "../../transaction-1SPznNt3.mjs";
-import { t as LocalProvider } from "../../local-8dJ5NIWL.mjs";
+import "../../meta-manager-B_Se183X.mjs";
+import "../../identity-D8QoGxhT.mjs";
+import "../../config-VlRKRwAS.mjs";
+import "../../branch-lifecycle-B6PXZ2N7.mjs";
+import { E as LocalReader } from "../../model-manager-DgyKMjLN.mjs";
+import "../../context-C3x6I3cE.mjs";
+import "../../id-BjhaIxTL.mjs";
+import "../../transaction-BW9ektWu.mjs";
+import { t as LocalProvider } from "../../local-Db5X9mjZ.mjs";
 export { LocalProvider, LocalReader };

package/dist/{scan-config-BlNLRCMx.mjs → scan-config-Dx49nCqk.mjs}

@@ -156,4 +156,4 @@ async function discoverFiles(projectRoot, options) {
 //#endregion
 export { classifyFile as a, autoDetectSourceDirs as i, SCAN_EXTENSIONS as n, discoverFiles as o, SCAN_IGNORE_DIRS as r, MAX_SCAN_FILES as t };
 
-//# sourceMappingURL=scan-config-BlNLRCMx.mjs.map
+//# sourceMappingURL=scan-config-Dx49nCqk.mjs.map

package/dist/{scan-config-BlNLRCMx.mjs.map → scan-config-Dx49nCqk.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"scan-config-BlNLRCMx.mjs","names":[],"sources":["../src/core/scan-config.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises'\nimport { join, extname, basename } from 'node:path'\nimport { pathExists } from '../util/fs.js'\n\n// ─── Shared Scan Constants ───\n\n/** File extensions to scan across all JS/TS ecosystem projects */\nexport const SCAN_EXTENSIONS = new Set([\n  '.tsx', '.jsx', '.vue', '.ts', '.js', '.mjs', '.astro', '.svelte',\n])\n\n/** Directory names to always exclude from scanning */\nexport const SCAN_IGNORE_DIRS = new Set([\n  // Package managers / deps\n  'node_modules', '.pnpm',\n  // Build outputs\n  'dist', 'build', 'out', '.output',\n  // Framework caches\n  '.nuxt', '.next', '.svelte-kit', '.expo', '.turbo', '.parcel-cache', '.vercel', '.netlify',\n  // Test / coverage\n  'coverage', '__tests__', '__mocks__',\n  // VCS / IDE\n  '.git', '.vscode', '.idea',\n  // Contentrain\n  '.contentrain',\n])\n\n/** Max files per scan operation */\nexport const MAX_SCAN_FILES = 500\n\n/** File patterns to skip regardless of extension */\nconst SKIP_FILE_RE = /\\.(test|spec)\\.[^.]+$|\\.d\\.ts$|\\.min\\.[^.]+$/\n\n// ─── File Classification ───\n// Covers: React, Next.js, Nuxt, Vue, Astro, SvelteKit, Remix,\n//         React Native/Expo, NestJS, Express, Fastify, Koa, Hapi\n\n/** Directories that represent entry points / pages / screens */\nconst PAGE_DIR_NAMES = new Set([\n  // Frontend routing\n  'pages', 'routes', 'screens', 'views',\n  // Backend entry points\n  'controllers', 'handlers', 'resolvers',\n])\n\n/** Directories that represent reusable components / modules */\nconst COMPONENT_DIR_NAMES = new Set([\n  // UI components\n  'components', 'ui', 'widgets', 'elements',\n  // Feature modules\n  'features', 'modules',\n  // Backend services\n  'services', 'providers',\n  // Shared / common\n  'shared', 'common',\n])\n\n/** Directories that represent layouts / templates */\nconst LAYOUT_DIR_NAMES = new Set([\n  'layouts', 'templates',\n])\n\n/** Next.js App Router special files that are page-like */\nconst NEXTJS_PAGE_FILES = new Set([\n  'page.tsx', 'page.jsx', 'page.ts', 'page.js',\n  'layout.tsx', 'layout.jsx', 'layout.ts', 'layout.js',\n  'error.tsx', 'error.jsx',\n  'loading.tsx', 'loading.jsx',\n  'not-found.tsx', 'not-found.jsx',\n])\n\n/** Classify a file into page/component/layout/other based on path heuristics */\nexport function classifyFile(relPath: string): 'page' | 'component' | 'layout' | 'other' {\n  const parts = relPath.split('/')\n  const fileName = parts[parts.length - 1] ?? ''\n\n  // Next.js App Router: files in app/ with special names are pages\n  if (parts.includes('app') && NEXTJS_PAGE_FILES.has(fileName)) {\n    return fileName.startsWith('layout') ? 'layout' : 'page'\n  }\n\n  // Check directory names in path (check layout first — more specific)\n  for (const part of parts) {\n    const lower = part.toLowerCase()\n    if (LAYOUT_DIR_NAMES.has(lower)) return 'layout'\n    if (PAGE_DIR_NAMES.has(lower)) return 'page'\n    if (COMPONENT_DIR_NAMES.has(lower)) return 'component'\n  }\n\n  return 'other'\n}\n\n// ─── Source Directory Detection ───\n\n/** Common source directories across all JS/TS project types */\nconst AUTO_DETECT_DIRS = [\n  // Standard source\n  'src', 'app', 'lib',\n  // Frontend specific\n  'pages', 'components', 'layouts', 'views',\n  // Mobile\n  'screens',\n  // Backend\n  'modules', 'routes', 'controllers', 'services',\n  // Shared\n  'features', 'shared', 'common',\n  // Hooks / composables\n  'hooks', 'composables',\n  // Stores\n  'stores',\n]\n\n/** Auto-detect which source directories exist in the project */\nexport async function autoDetectSourceDirs(projectRoot: string): Promise<string[]> {\n  const found: string[] = []\n  for (const dir of AUTO_DETECT_DIRS) {\n    if (await pathExists(join(projectRoot, dir))) {\n      found.push(dir)\n    }\n  }\n  return found.length > 0 ? found : ['.']\n}\n\n// ─── File Discovery ───\n\nexport interface DiscoverFilesOptions {\n  paths?: string[]\n  include?: string[]\n  exclude?: string[]\n}\n\n/**\n * Discover source files matching scan criteria.\n * Returns relative paths (relative to projectRoot).\n */\nexport async function discoverFiles(\n  projectRoot: string,\n  options?: DiscoverFilesOptions,\n): Promise<string[]> {\n  const extensions = options?.include\n    ? new Set(options.include.map(e => e.startsWith('.') ? e : `.${e}`))\n    : SCAN_EXTENSIONS\n  const extraExcludes = new Set(options?.exclude ?? [])\n  const scanDirs = options?.paths ?? await autoDetectSourceDirs(projectRoot)\n\n  const files: string[] = []\n\n  for (const dir of scanDirs) {\n    const absDir = join(projectRoot, dir)\n    if (!(await pathExists(absDir))) continue\n\n    let entries: string[]\n    try {\n      entries = await readdir(absDir, { recursive: true }) as unknown as string[]\n    } catch {\n      continue\n    }\n\n    for (const entry of entries) {\n      if (files.length >= MAX_SCAN_FILES) break\n\n      const fileName = basename(entry)\n\n      // Check if any path segment is excluded\n      const pathSegments = entry.split('/')\n      if (pathSegments.some(seg => SCAN_IGNORE_DIRS.has(seg) || extraExcludes.has(seg))) continue\n\n      // Check extension\n      if (!extensions.has(extname(fileName))) continue\n\n      // Skip test/spec/declaration/minified files\n      if (SKIP_FILE_RE.test(fileName)) continue\n\n      files.push(join(dir, entry))\n    }\n\n    if (files.length >= MAX_SCAN_FILES) break\n  }\n\n  return files.toSorted((a, b) => a.localeCompare(b)).slice(0, MAX_SCAN_FILES)\n}\n"],"mappings":"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"}
+{"version":3,"file":"scan-config-Dx49nCqk.mjs","names":[],"sources":["../src/core/scan-config.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises'\nimport { join, extname, basename } from 'node:path'\nimport { pathExists } from '../util/fs.js'\n\n// ─── Shared Scan Constants ───\n\n/** File extensions to scan across all JS/TS ecosystem projects */\nexport const SCAN_EXTENSIONS = new Set([\n  '.tsx', '.jsx', '.vue', '.ts', '.js', '.mjs', '.astro', '.svelte',\n])\n\n/** Directory names to always exclude from scanning */\nexport const SCAN_IGNORE_DIRS = new Set([\n  // Package managers / deps\n  'node_modules', '.pnpm',\n  // Build outputs\n  'dist', 'build', 'out', '.output',\n  // Framework caches\n  '.nuxt', '.next', '.svelte-kit', '.expo', '.turbo', '.parcel-cache', '.vercel', '.netlify',\n  // Test / coverage\n  'coverage', '__tests__', '__mocks__',\n  // VCS / IDE\n  '.git', '.vscode', '.idea',\n  // Contentrain\n  '.contentrain',\n])\n\n/** Max files per scan operation */\nexport const MAX_SCAN_FILES = 500\n\n/** File patterns to skip regardless of extension */\nconst SKIP_FILE_RE = /\\.(test|spec)\\.[^.]+$|\\.d\\.ts$|\\.min\\.[^.]+$/\n\n// ─── File Classification ───\n// Covers: React, Next.js, Nuxt, Vue, Astro, SvelteKit, Remix,\n//         React Native/Expo, NestJS, Express, Fastify, Koa, Hapi\n\n/** Directories that represent entry points / pages / screens */\nconst PAGE_DIR_NAMES = new Set([\n  // Frontend routing\n  'pages', 'routes', 'screens', 'views',\n  // Backend entry points\n  'controllers', 'handlers', 'resolvers',\n])\n\n/** Directories that represent reusable components / modules */\nconst COMPONENT_DIR_NAMES = new Set([\n  // UI components\n  'components', 'ui', 'widgets', 'elements',\n  // Feature modules\n  'features', 'modules',\n  // Backend services\n  'services', 'providers',\n  // Shared / common\n  'shared', 'common',\n])\n\n/** Directories that represent layouts / templates */\nconst LAYOUT_DIR_NAMES = new Set([\n  'layouts', 'templates',\n])\n\n/** Next.js App Router special files that are page-like */\nconst NEXTJS_PAGE_FILES = new Set([\n  'page.tsx', 'page.jsx', 'page.ts', 'page.js',\n  'layout.tsx', 'layout.jsx', 'layout.ts', 'layout.js',\n  'error.tsx', 'error.jsx',\n  'loading.tsx', 'loading.jsx',\n  'not-found.tsx', 'not-found.jsx',\n])\n\n/** Classify a file into page/component/layout/other based on path heuristics */\nexport function classifyFile(relPath: string): 'page' | 'component' | 'layout' | 'other' {\n  const parts = relPath.split('/')\n  const fileName = parts[parts.length - 1] ?? ''\n\n  // Next.js App Router: files in app/ with special names are pages\n  if (parts.includes('app') && NEXTJS_PAGE_FILES.has(fileName)) {\n    return fileName.startsWith('layout') ? 'layout' : 'page'\n  }\n\n  // Check directory names in path (check layout first — more specific)\n  for (const part of parts) {\n    const lower = part.toLowerCase()\n    if (LAYOUT_DIR_NAMES.has(lower)) return 'layout'\n    if (PAGE_DIR_NAMES.has(lower)) return 'page'\n    if (COMPONENT_DIR_NAMES.has(lower)) return 'component'\n  }\n\n  return 'other'\n}\n\n// ─── Source Directory Detection ───\n\n/** Common source directories across all JS/TS project types */\nconst AUTO_DETECT_DIRS = [\n  // Standard source\n  'src', 'app', 'lib',\n  // Frontend specific\n  'pages', 'components', 'layouts', 'views',\n  // Mobile\n  'screens',\n  // Backend\n  'modules', 'routes', 'controllers', 'services',\n  // Shared\n  'features', 'shared', 'common',\n  // Hooks / composables\n  'hooks', 'composables',\n  // Stores\n  'stores',\n]\n\n/** Auto-detect which source directories exist in the project */\nexport async function autoDetectSourceDirs(projectRoot: string): Promise<string[]> {\n  const found: string[] = []\n  for (const dir of AUTO_DETECT_DIRS) {\n    if (await pathExists(join(projectRoot, dir))) {\n      found.push(dir)\n    }\n  }\n  return found.length > 0 ? found : ['.']\n}\n\n// ─── File Discovery ───\n\nexport interface DiscoverFilesOptions {\n  paths?: string[]\n  include?: string[]\n  exclude?: string[]\n}\n\n/**\n * Discover source files matching scan criteria.\n * Returns relative paths (relative to projectRoot).\n */\nexport async function discoverFiles(\n  projectRoot: string,\n  options?: DiscoverFilesOptions,\n): Promise<string[]> {\n  const extensions = options?.include\n    ? new Set(options.include.map(e => e.startsWith('.') ? e : `.${e}`))\n    : SCAN_EXTENSIONS\n  const extraExcludes = new Set(options?.exclude ?? [])\n  const scanDirs = options?.paths ?? await autoDetectSourceDirs(projectRoot)\n\n  const files: string[] = []\n\n  for (const dir of scanDirs) {\n    const absDir = join(projectRoot, dir)\n    if (!(await pathExists(absDir))) continue\n\n    let entries: string[]\n    try {\n      entries = await readdir(absDir, { recursive: true }) as unknown as string[]\n    } catch {\n      continue\n    }\n\n    for (const entry of entries) {\n      if (files.length >= MAX_SCAN_FILES) break\n\n      const fileName = basename(entry)\n\n      // Check if any path segment is excluded\n      const pathSegments = entry.split('/')\n      if (pathSegments.some(seg => SCAN_IGNORE_DIRS.has(seg) || extraExcludes.has(seg))) continue\n\n      // Check extension\n      if (!extensions.has(extname(fileName))) continue\n\n      // Skip test/spec/declaration/minified files\n      if (SKIP_FILE_RE.test(fileName)) continue\n\n      files.push(join(dir, entry))\n    }\n\n    if (files.length >= MAX_SCAN_FILES) break\n  }\n\n  return files.toSorted((a, b) => a.localeCompare(b)).slice(0, MAX_SCAN_FILES)\n}\n"],"mappings":"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"}

package/dist/{scanner-CGWhmpDz.mjs → scanner-BSvXjfkp.mjs}

@@ -1,6 +1,6 @@
 import { o as readText } from "./fs-DLbVB-Ek.mjs";
-import { i as autoDetectSourceDirs, o as discoverFiles } from "./scan-config-BlNLRCMx.mjs";
-import { t as parseTsx } from "./tsx-parser-md1N0Niu.mjs";
+import { i as autoDetectSourceDirs, o as discoverFiles } from "./scan-config-Dx49nCqk.mjs";
+import { t as parseTsx } from "./tsx-parser-BvsK6lyG.mjs";
 import { extname, join } from "node:path";
 //#region src/core/ast-scanner/pre-filter.ts
 const PURE_NUMBER_RE = /^-?\d+(\.\d+)?$/;
@@ -273,7 +273,7 @@ const ASTRO_EXTENSIONS = new Set([".astro"]);
 */
 async function loadVueParser() {
 	try {
-		return (await import("./vue-parser-CHxDohd8.mjs")).parseVue;
+		return (await import("./vue-parser-auedZiJG.mjs")).parseVue;
 	} catch {
 		return;
 	}
@@ -284,7 +284,7 @@ async function loadVueParser() {
 */
 async function loadSvelteParser() {
 	try {
-		return (await import("./svelte-parser-DaFK9iY0.mjs")).parseSvelte;
+		return (await import("./svelte-parser-CwySu9yn.mjs")).parseSvelte;
 	} catch {
 		return;
 	}
@@ -295,7 +295,7 @@ async function loadSvelteParser() {
 */
 async function loadAstroParser() {
 	try {
-		return (await import("./astro-parser-LNjEspnf.mjs")).parseAstro;
+		return (await import("./astro-parser-Cb9uuBpW.mjs")).parseAstro;
 	} catch {
 		return;
 	}
@@ -601,4 +601,4 @@ async function scanSummary(projectRoot, options) {
 //#endregion
 export { scanSummary as n, scanCandidates as t };
 
-//# sourceMappingURL=scanner-CGWhmpDz.mjs.map
+//# sourceMappingURL=scanner-BSvXjfkp.mjs.map