@contentrain/mcp 2.3.1 → 3.0.1

package/dist/{config-oxxgznz7.mjs → config-VlRKRwAS.mjs}

@@ -40,4 +40,4 @@ async function readVocabulary(input) {
 //#endregion
 export { readVocabulary as n, readConfig as t };
 
-//# sourceMappingURL=config-oxxgznz7.mjs.map
+//# sourceMappingURL=config-VlRKRwAS.mjs.map

package/dist/{config-oxxgznz7.mjs.map → config-VlRKRwAS.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"config-oxxgznz7.mjs","names":[],"sources":["../src/core/config.ts"],"sourcesContent":["import type { ContentrainConfig, Vocabulary } from '@contentrain/types'\nimport { join } from 'node:path'\nimport { contentrainDir, readJson } from '../util/fs.js'\nimport type { RepoReader } from './contracts/index.js'\n\nconst CONFIG_PATH = '.contentrain/config.json'\nconst VOCABULARY_PATH = '.contentrain/vocabulary.json'\n\nasync function readJsonViaReader<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\nfunction normaliseConfig(raw: Partial<ContentrainConfig> | null): ContentrainConfig | null {\n  if (!raw) return null\n  return {\n    version: raw.version ?? 1,\n    stack: raw.stack ?? 'other',\n    workflow: raw.workflow ?? 'auto-merge',\n    locales: {\n      default: raw.locales?.default ?? 'en',\n      supported: raw.locales?.supported ?? [raw.locales?.default ?? 'en'],\n    },\n    domains: raw.domains ?? [],\n    repository: raw.repository,\n    assets_path: raw.assets_path,\n    branchRetention: raw.branchRetention,\n    branchWarnLimit: raw.branchWarnLimit,\n    branchBlockLimit: raw.branchBlockLimit,\n    remoteBranchCleanup: raw.remoteBranchCleanup,\n  }\n}\n\n/**\n * Read `.contentrain/config.json` and normalise it with safe defaults.\n *\n * Accepts either a legacy `projectRoot` string (LocalReader is constructed\n * internally) or any `RepoReader` — tool handlers pass their provider so\n * the same logic resolves against local fs or the GitHub Git Data API.\n */\nexport function readConfig(projectRoot: string): Promise<ContentrainConfig | null>\nexport function readConfig(reader: RepoReader): Promise<ContentrainConfig | null>\nexport async function readConfig(input: string | RepoReader): Promise<ContentrainConfig | null> {\n  if (typeof input === 'string') {\n    const raw = await readJson<Partial<ContentrainConfig>>(join(contentrainDir(input), 'config.json'))\n    return normaliseConfig(raw)\n  }\n  const raw = await readJsonViaReader<Partial<ContentrainConfig>>(input, CONFIG_PATH)\n  return normaliseConfig(raw)\n}\n\n/**\n * Read `.contentrain/vocabulary.json`. Same dual signature as {@link readConfig}.\n */\nexport function readVocabulary(projectRoot: string): Promise<Vocabulary | null>\nexport function readVocabulary(reader: RepoReader): Promise<Vocabulary | null>\nexport async function readVocabulary(input: string | RepoReader): Promise<Vocabulary | null> {\n  if (typeof input === 'string') {\n    return readJson<Vocabulary>(join(contentrainDir(input), 'vocabulary.json'))\n  }\n  return readJsonViaReader<Vocabulary>(input, VOCABULARY_PATH)\n}\n"],"mappings":";;;AAKA,MAAM,cAAc;AACpB,MAAM,kBAAkB;AAExB,eAAe,kBAAqB,QAAoB,MAAiC;AACvF,KAAI;AACF,SAAO,KAAK,MAAM,MAAM,OAAO,SAAS,KAAK,CAAC;SACxC;AACN,SAAO;;;AAIX,SAAS,gBAAgB,KAAkE;AACzF,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,SAAS,IAAI,WAAW;EACxB,OAAO,IAAI,SAAS;EACpB,UAAU,IAAI,YAAY;EAC1B,SAAS;GACP,SAAS,IAAI,SAAS,WAAW;GACjC,WAAW,IAAI,SAAS,aAAa,CAAC,IAAI,SAAS,WAAW,KAAK;GACpE;EACD,SAAS,IAAI,WAAW,EAAE;EAC1B,YAAY,IAAI;EAChB,aAAa,IAAI;EACjB,iBAAiB,IAAI;EACrB,iBAAiB,IAAI;EACrB,kBAAkB,IAAI;EACtB,qBAAqB,IAAI;EAC1B;;AAYH,eAAsB,WAAW,OAA+D;AAC9F,KAAI,OAAO,UAAU,SAEnB,QAAO,gBADK,MAAM,SAAqC,KAAK,eAAe,MAAM,EAAE,cAAc,CAAC,CACvE;AAG7B,QAAO,gBADK,MAAM,kBAA8C,OAAO,YAAY,CACxD;;AAQ7B,eAAsB,eAAe,OAAwD;AAC3F,KAAI,OAAO,UAAU,SACnB,QAAO,SAAqB,KAAK,eAAe,MAAM,EAAE,kBAAkB,CAAC;AAE7E,QAAO,kBAA8B,OAAO,gBAAgB"}
+{"version":3,"file":"config-VlRKRwAS.mjs","names":[],"sources":["../src/core/config.ts"],"sourcesContent":["import type { ContentrainConfig, Vocabulary } from '@contentrain/types'\nimport { join } from 'node:path'\nimport { contentrainDir, readJson } from '../util/fs.js'\nimport type { RepoReader } from './contracts/index.js'\n\nconst CONFIG_PATH = '.contentrain/config.json'\nconst VOCABULARY_PATH = '.contentrain/vocabulary.json'\n\nasync function readJsonViaReader<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\nfunction normaliseConfig(raw: Partial<ContentrainConfig> | null): ContentrainConfig | null {\n  if (!raw) return null\n  return {\n    version: raw.version ?? 1,\n    stack: raw.stack ?? 'other',\n    workflow: raw.workflow ?? 'auto-merge',\n    locales: {\n      default: raw.locales?.default ?? 'en',\n      supported: raw.locales?.supported ?? [raw.locales?.default ?? 'en'],\n    },\n    domains: raw.domains ?? [],\n    repository: raw.repository,\n    assets_path: raw.assets_path,\n    branchRetention: raw.branchRetention,\n    branchWarnLimit: raw.branchWarnLimit,\n    branchBlockLimit: raw.branchBlockLimit,\n    remoteBranchCleanup: raw.remoteBranchCleanup,\n  }\n}\n\n/**\n * Read `.contentrain/config.json` and normalise it with safe defaults.\n *\n * Accepts either a legacy `projectRoot` string (LocalReader is constructed\n * internally) or any `RepoReader` — tool handlers pass their provider so\n * the same logic resolves against local fs or the GitHub Git Data API.\n */\nexport function readConfig(projectRoot: string): Promise<ContentrainConfig | null>\nexport function readConfig(reader: RepoReader): Promise<ContentrainConfig | null>\nexport async function readConfig(input: string | RepoReader): Promise<ContentrainConfig | null> {\n  if (typeof input === 'string') {\n    const raw = await readJson<Partial<ContentrainConfig>>(join(contentrainDir(input), 'config.json'))\n    return normaliseConfig(raw)\n  }\n  const raw = await readJsonViaReader<Partial<ContentrainConfig>>(input, CONFIG_PATH)\n  return normaliseConfig(raw)\n}\n\n/**\n * Read `.contentrain/vocabulary.json`. Same dual signature as {@link readConfig}.\n */\nexport function readVocabulary(projectRoot: string): Promise<Vocabulary | null>\nexport function readVocabulary(reader: RepoReader): Promise<Vocabulary | null>\nexport async function readVocabulary(input: string | RepoReader): Promise<Vocabulary | null> {\n  if (typeof input === 'string') {\n    return readJson<Vocabulary>(join(contentrainDir(input), 'vocabulary.json'))\n  }\n  return readJsonViaReader<Vocabulary>(input, VOCABULARY_PATH)\n}\n"],"mappings":";;;AAKA,MAAM,cAAc;AACpB,MAAM,kBAAkB;AAExB,eAAe,kBAAqB,QAAoB,MAAiC;AACvF,KAAI;AACF,SAAO,KAAK,MAAM,MAAM,OAAO,SAAS,KAAK,CAAC;SACxC;AACN,SAAO;;;AAIX,SAAS,gBAAgB,KAAkE;AACzF,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,SAAS,IAAI,WAAW;EACxB,OAAO,IAAI,SAAS;EACpB,UAAU,IAAI,YAAY;EAC1B,SAAS;GACP,SAAS,IAAI,SAAS,WAAW;GACjC,WAAW,IAAI,SAAS,aAAa,CAAC,IAAI,SAAS,WAAW,KAAK;GACpE;EACD,SAAS,IAAI,WAAW,EAAE;EAC1B,YAAY,IAAI;EAChB,aAAa,IAAI;EACjB,iBAAiB,IAAI;EACrB,iBAAiB,IAAI;EACrB,kBAAkB,IAAI;EACtB,qBAAqB,IAAI;EAC1B;;AAYH,eAAsB,WAAW,OAA+D;AAC9F,KAAI,OAAO,UAAU,SAEnB,QAAO,gBADK,MAAM,SAAqC,KAAK,eAAe,MAAM,EAAE,cAAc,CAAC,CACvE;AAG7B,QAAO,gBADK,MAAM,kBAA8C,OAAO,YAAY,CACxD;;AAQ7B,eAAsB,eAAe,OAAwD;AAC3F,KAAI,OAAO,UAAU,SACnB,QAAO,SAAqB,KAAK,eAAe,MAAM,EAAE,kBAAkB,CAAC;AAE7E,QAAO,kBAA8B,OAAO,gBAAgB"}

package/dist/{content-manager-DWo3G64y.d.mts → content-manager-Dn4tqDw1.d.mts}

@@ -1,13 +1,16 @@
-import { _ as RepoReader } from "./index-w8QHThNS.mjs";
+import { _ as RepoReader } from "./index-BWbTJlXm.mjs";
 import { ContentrainConfig, LocaleStrategy, ModelDefinition, Vocabulary, parseMarkdownFrontmatter as parseFrontmatter, serializeMarkdownFrontmatter as serializeFrontmatter, validateEntryId as validateEntryId$1, validateLocale as validateLocale$1, validateSlug as validateSlug$1 } from "@contentrain/types";
 
 //#region src/core/content-manager.d.ts
-declare function resolveContentDir(projectRoot: string, model: ModelDefinition): string;
-declare function resolveLocaleStrategy(model: ModelDefinition): LocaleStrategy;
+type ContentPathModel = Pick<ModelDefinition, 'id' | 'domain' | 'content_path'>;
+type LocaleStrategyModel = Pick<ModelDefinition, 'locale_strategy'>;
+type ContentFileModel = Pick<ModelDefinition, 'id' | 'i18n' | 'locale_strategy'>;
+declare function resolveContentDir(projectRoot: string, model: ContentPathModel): string;
+declare function resolveLocaleStrategy(model: LocaleStrategyModel): LocaleStrategy;
 /** Build the file path for a JSON content file (singleton/collection/dictionary) */
-declare function resolveJsonFilePath(dir: string, model: ModelDefinition, locale: string): string;
+declare function resolveJsonFilePath(dir: string, model: ContentFileModel, locale: string): string;
 /** Build the file path for a markdown document */
-declare function resolveMdFilePath(dir: string, model: ModelDefinition, locale: string, slug: string): string;
+declare function resolveMdFilePath(dir: string, model: Pick<ModelDefinition, 'i18n' | 'locale_strategy'>, locale: string, slug: string): string;
 interface ContentEntry {
   id?: string;
   slug?: string;
@@ -61,5 +64,5 @@ declare function readContent(projectRoot: string, model: ModelDefinition, opts:
   slug?: string;
 }): Promise<unknown>;
 //#endregion
-export { writeContent as _, deleteContent as a, readContent as c, resolveLocaleStrategy as d, resolveMdFilePath as f, validateSlug$1 as g, validateLocale$1 as h, WriteResult as i, resolveContentDir as l, validateEntryId$1 as m, DeleteOpts as n, listContent as o, serializeFrontmatter as p, ListOpts as r, parseFrontmatter as s, ContentEntry as t, resolveJsonFilePath as u };
-//# sourceMappingURL=content-manager-DWo3G64y.d.mts.map
+export { validateEntryId$1 as _, ListOpts as a, writeContent as b, deleteContent as c, readContent as d, resolveContentDir as f, serializeFrontmatter as g, resolveMdFilePath as h, DeleteOpts as i, listContent as l, resolveLocaleStrategy as m, ContentFileModel as n, LocaleStrategyModel as o, resolveJsonFilePath as p, ContentPathModel as r, WriteResult as s, ContentEntry as t, parseFrontmatter as u, validateLocale$1 as v, validateSlug$1 as y };
+//# sourceMappingURL=content-manager-Dn4tqDw1.d.mts.map

package/dist/content-manager-Dn4tqDw1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-manager-Dn4tqDw1.d.mts","names":[],"sources":["../src/core/content-manager.ts"],"mappings":";;;;KAyBY,gBAAA,GAAmB,IAAA,CAAK,eAAA;AAAA,KACxB,mBAAA,GAAsB,IAAA,CAAK,eAAA;AAAA,KAC3B,gBAAA,GAAmB,IAAA,CAAK,eAAA;AAAA,iBAEpB,iBAAA,CAAkB,WAAA,UAAqB,KAAA,EAAO,gBAAA;AAAA,iBAO9C,qBAAA,CAAsB,KAAA,EAAO,mBAAA,GAAsB,cAAA;;iBAKnD,mBAAA,CAAoB,GAAA,UAAa,KAAA,EAAO,gBAAA,EAAkB,MAAA;;iBAc1D,iBAAA,CAAkB,GAAA,UAAa,KAAA,EAAO,IAAA,CAAK,eAAA,+BAA8C,MAAA,UAAgB,IAAA;AAAA,UAexG,YAAA;EACf,EAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA,EAAM,MAAA;AAAA;AAAA,UAGS,WAAA;EACf,MAAA;EACA,EAAA;EACA,IAAA;EACA,MAAA;EACA,UAAA;AAAA;AAAA,UAGe,UAAA;EACf,EAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA;EArD2C;EAuD3C,aAAA;AAAA;AAAA,UAGe,QAAA;EACf,MAAA;EACA,MAAA,GAAS,MAAA;EACT,OAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,iBAKoB,YAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,OAAA,EAAS,YAAA,IACT,MAAA,EAAQ,iBAAA,EACR,UAAA,GAAa,UAAA,UACZ,OAAA,CAAQ,WAAA;AAAA,iBAuJW,aAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,UAAA,GACL,OAAA;;;;AAlNH;;;;;;;;;;;;iBA+VgB,WAAA,CACd,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,EACN,MAAA,EAAQ,iBAAA,GACP,OAAA;AAAA,iBACa,WAAA,CACd,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,EACN,MAAA,EAAQ,iBAAA,GACP,OAAA;AAAA,iBA0QmB,WAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA;EAAQ,MAAA;EAAgB,OAAA;EAAkB,IAAA;AAAA,IACzC,OAAA"}

package/dist/{context-DjglDPvj.mjs → context-C3x6I3cE.mjs}

@@ -1,7 +1,7 @@
-import { n as canonicalStringify } from "./serialization-B1CEzR4H.mjs";
+import { r as canonicalStringify } from "./serialization-tmgfFBOh.mjs";
 import { a as readJson, s as writeJson, t as contentrainDir } from "./fs-DLbVB-Ek.mjs";
-import { t as readConfig } from "./config-oxxgznz7.mjs";
-import { o as listModels, r as countEntries, s as readModel } from "./model-manager-DP2CZiMT.mjs";
+import { t as readConfig } from "./config-VlRKRwAS.mjs";
+import { c as listModels, i as countEntries, l as readModel } from "./model-manager-DgyKMjLN.mjs";
 import { join } from "node:path";
 //#region src/core/context.ts
 const CONTEXT_PATH = ".contentrain/context.json";
@@ -112,4 +112,4 @@ async function buildContextChange(reader, operation, source, opts) {
 //#endregion
 export { readContext as n, writeContext as r, buildContextChange as t };
 
-//# sourceMappingURL=context-DjglDPvj.mjs.map
+//# sourceMappingURL=context-C3x6I3cE.mjs.map

package/dist/{context-DjglDPvj.mjs.map → context-C3x6I3cE.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"context-DjglDPvj.mjs","names":[],"sources":["../src/core/context.ts"],"sourcesContent":["import type { ContextJson, ContextSource } from '@contentrain/types'\nimport { join } from 'node:path'\nimport { contentrainDir, readJson, writeJson } from '../util/fs.js'\nimport type { FileChange, RepoReader } from './contracts/index.js'\nimport { canonicalStringify } from './serialization/index.js'\nimport { listModels, readModel, countEntries } from './model-manager.js'\nimport { readConfig } from './config.js'\n\nconst CONTEXT_PATH = '.contentrain/context.json'\n\n/**\n * Pre-computed stats a caller can pass to {@link buildContextChange} to skip\n * the model/entry scan. `entries` is nullable — a `null` is dropped from the\n * emitted context.json by {@link canonicalStringify}, exactly as a failed\n * scan is today.\n */\nexport interface ContextStats {\n  models: number\n  entries: number | null\n}\n\n/**\n * Read the committed `.contentrain/context.json` payload written by the\n * most recent content or model operation. Returns `null` when the file\n * does not exist (fresh project, or reader lookup failure).\n *\n * Dual signature — the local flow passes a `projectRoot` string, remote\n * flows (GitHubProvider, GitLabProvider, any custom `RepoReader`) pass\n * the reader directly so `contentrain_status` over HTTP can still\n * report the last operation + stats.\n */\nexport function readContext(projectRoot: string): Promise<ContextJson | null>\nexport function readContext(reader: RepoReader): Promise<ContextJson | null>\nexport async function readContext(input: string | RepoReader): Promise<ContextJson | null> {\n  if (typeof input === 'string') {\n    return readJson<ContextJson>(join(contentrainDir(input), 'context.json'))\n  }\n  try {\n    const raw = await input.readFile(CONTEXT_PATH)\n    return JSON.parse(raw) as ContextJson\n  } catch {\n    return null\n  }\n}\n\nfunction resolveSource(explicit?: ContextSource): ContextSource {\n  if (explicit) return explicit\n  return process.env['CONTENTRAIN_SOURCE'] === 'mcp-studio' ? 'mcp-studio' : 'mcp-local'\n}\n\nasync function computeEntriesCount(projectRoot: string): Promise<number | null> {\n  try {\n    const models = await listModels(projectRoot)\n    const fullModels = await Promise.all(models.map(m => readModel(projectRoot, m.id)))\n    const counts = await Promise.all(\n      fullModels\n        .filter((m): m is NonNullable<typeof m> => m !== null)\n        .map(m => countEntries(projectRoot, m)),\n    )\n    return counts.reduce((acc, c) => acc + c.total, 0)\n  } catch {\n    return null\n  }\n}\n\nexport async function writeContext(\n  projectRoot: string,\n  operation: { tool: string, model: string, locale?: string, entries?: string[] },\n): Promise<void> {\n  const models = await listModels(projectRoot)\n  const config = await readConfig(projectRoot)\n  const locales = config?.locales.supported ?? ['en']\n  const totalEntries = await computeEntriesCount(projectRoot)\n  const source = resolveSource()\n\n  const context: ContextJson = {\n    version: '1',\n    lastOperation: {\n      tool: operation.tool,\n      model: operation.model,\n      locale: operation.locale ?? config?.locales.default ?? 'en',\n      entries: operation.entries,\n      timestamp: new Date().toISOString(),\n      source,\n    },\n    stats: {\n      models: models.length,\n      entries: totalEntries as number,\n      locales,\n      lastSync: new Date().toISOString(),\n    },\n  }\n\n  await writeJson(join(contentrainDir(projectRoot), 'context.json'), context)\n}\n\n/**\n * Build a FileChange for `.contentrain/context.json` that remote providers\n * (GitHubProvider over HTTP, for example) can slot into their plan. The\n * local write path still uses {@link writeContext} directly because its\n * transaction layer writes into the post-apply worktree with real stats.\n *\n * Remote providers (Phase 5.5+) now also get accurate entry counts: the\n * reader-based {@link countEntries} walks each model over the provider's\n * read surface. GitHubProvider pays an extra round trip per model; the\n * payoff is a context.json that matches what the local write path emits,\n * so cross-provider merges stay deterministic.\n *\n * A caller that already knows the model/entry counts (e.g. Studio deriving\n * them from its own index) can pass `opts.stats` to skip that O(models·\n * locales) scan entirely — only `readConfig` remains, for the locale list\n * and the `lastOperation.locale` default. The emitted context.json is\n * byte-identical to the scanned variant for the same logical state.\n */\nexport async function buildContextChange(\n  reader: RepoReader,\n  operation: { tool: string, model: string, locale?: string, entries?: string[] },\n  source?: ContextSource,\n  opts?: { stats?: ContextStats },\n): Promise<FileChange> {\n  const config = await readConfig(reader)\n  const locales = config?.locales.supported ?? ['en']\n\n  let modelCount: number\n  let totalEntries: number | null\n  if (opts?.stats) {\n    modelCount = opts.stats.models\n    totalEntries = opts.stats.entries\n  } else {\n    const models = await listModels(reader)\n    modelCount = models.length\n    try {\n      const fullModels = await Promise.all(models.map(m => readModel(reader, m.id)))\n      const counts = await Promise.all(\n        fullModels\n          .filter((m): m is NonNullable<typeof m> => m !== null)\n          .map(m => countEntries(reader, m)),\n      )\n      totalEntries = counts.reduce((acc, c) => acc + c.total, 0)\n    } catch {\n      totalEntries = null\n    }\n  }\n\n  const context: ContextJson = {\n    version: '1',\n    lastOperation: {\n      tool: operation.tool,\n      model: operation.model,\n      locale: operation.locale ?? config?.locales.default ?? 'en',\n      entries: operation.entries,\n      timestamp: new Date().toISOString(),\n      source: resolveSource(source),\n    },\n    stats: {\n      models: modelCount,\n      entries: totalEntries as number,\n      locales,\n      lastSync: new Date().toISOString(),\n    },\n  }\n\n  return {\n    path: CONTEXT_PATH,\n    content: canonicalStringify(context),\n  }\n}\n"],"mappings":";;;;;;AAQA,MAAM,eAAe;AAyBrB,eAAsB,YAAY,OAAyD;AACzF,KAAI,OAAO,UAAU,SACnB,QAAO,SAAsB,KAAK,eAAe,MAAM,EAAE,eAAe,CAAC;AAE3E,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,SAAS,aAAa;AAC9C,SAAO,KAAK,MAAM,IAAI;SAChB;AACN,SAAO;;;AAIX,SAAS,cAAc,UAAyC;AAC9D,KAAI,SAAU,QAAO;AACrB,QAAO,QAAQ,IAAI,0BAA0B,eAAe,eAAe;;AAG7E,eAAe,oBAAoB,aAA6C;AAC9E,KAAI;EACF,MAAM,SAAS,MAAM,WAAW,YAAY;EAC5C,MAAM,aAAa,MAAM,QAAQ,IAAI,OAAO,KAAI,MAAK,UAAU,aAAa,EAAE,GAAG,CAAC,CAAC;AAMnF,UALe,MAAM,QAAQ,IAC3B,WACG,QAAQ,MAAkC,MAAM,KAAK,CACrD,KAAI,MAAK,aAAa,aAAa,EAAE,CAAC,CAC1C,EACa,QAAQ,KAAK,MAAM,MAAM,EAAE,OAAO,EAAE;SAC5C;AACN,SAAO;;;AAIX,eAAsB,aACpB,aACA,WACe;CACf,MAAM,SAAS,MAAM,WAAW,YAAY;CAC5C,MAAM,SAAS,MAAM,WAAW,YAAY;CAC5C,MAAM,UAAU,QAAQ,QAAQ,aAAa,CAAC,KAAK;CACnD,MAAM,eAAe,MAAM,oBAAoB,YAAY;CAC3D,MAAM,SAAS,eAAe;CAE9B,MAAM,UAAuB;EAC3B,SAAS;EACT,eAAe;GACb,MAAM,UAAU;GAChB,OAAO,UAAU;GACjB,QAAQ,UAAU,UAAU,QAAQ,QAAQ,WAAW;GACvD,SAAS,UAAU;GACnB,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC;GACD;EACD,OAAO;GACL,QAAQ,OAAO;GACf,SAAS;GACT;GACA,2BAAU,IAAI,MAAM,EAAC,aAAa;GACnC;EACF;AAED,OAAM,UAAU,KAAK,eAAe,YAAY,EAAE,eAAe,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;AAqB7E,eAAsB,mBACpB,QACA,WACA,QACA,MACqB;CACrB,MAAM,SAAS,MAAM,WAAW,OAAO;CACvC,MAAM,UAAU,QAAQ,QAAQ,aAAa,CAAC,KAAK;CAEnD,IAAI;CACJ,IAAI;AACJ,KAAI,MAAM,OAAO;AACf,eAAa,KAAK,MAAM;AACxB,iBAAe,KAAK,MAAM;QACrB;EACL,MAAM,SAAS,MAAM,WAAW,OAAO;AACvC,eAAa,OAAO;AACpB,MAAI;GACF,MAAM,aAAa,MAAM,QAAQ,IAAI,OAAO,KAAI,MAAK,UAAU,QAAQ,EAAE,GAAG,CAAC,CAAC;AAM9E,mBALe,MAAM,QAAQ,IAC3B,WACG,QAAQ,MAAkC,MAAM,KAAK,CACrD,KAAI,MAAK,aAAa,QAAQ,EAAE,CAAC,CACrC,EACqB,QAAQ,KAAK,MAAM,MAAM,EAAE,OAAO,EAAE;UACpD;AACN,kBAAe;;;AAsBnB,QAAO;EACL,MAAM;EACN,SAAS,mBApBkB;GAC3B,SAAS;GACT,eAAe;IACb,MAAM,UAAU;IAChB,OAAO,UAAU;IACjB,QAAQ,UAAU,UAAU,QAAQ,QAAQ,WAAW;IACvD,SAAS,UAAU;IACnB,4BAAW,IAAI,MAAM,EAAC,aAAa;IACnC,QAAQ,cAAc,OAAO;IAC9B;GACD,OAAO;IACL,QAAQ;IACR,SAAS;IACT;IACA,2BAAU,IAAI,MAAM,EAAC,aAAa;IACnC;GACF,CAIqC;EACrC"}
+{"version":3,"file":"context-C3x6I3cE.mjs","names":[],"sources":["../src/core/context.ts"],"sourcesContent":["import type { ContextJson, ContextSource } from '@contentrain/types'\nimport { join } from 'node:path'\nimport { contentrainDir, readJson, writeJson } from '../util/fs.js'\nimport type { FileChange, RepoReader } from './contracts/index.js'\nimport { canonicalStringify } from './serialization/index.js'\nimport { listModels, readModel, countEntries } from './model-manager.js'\nimport { readConfig } from './config.js'\n\nconst CONTEXT_PATH = '.contentrain/context.json'\n\n/**\n * Pre-computed stats a caller can pass to {@link buildContextChange} to skip\n * the model/entry scan. `entries` is nullable — a `null` is dropped from the\n * emitted context.json by {@link canonicalStringify}, exactly as a failed\n * scan is today.\n */\nexport interface ContextStats {\n  models: number\n  entries: number | null\n}\n\n/**\n * Read the committed `.contentrain/context.json` payload written by the\n * most recent content or model operation. Returns `null` when the file\n * does not exist (fresh project, or reader lookup failure).\n *\n * Dual signature — the local flow passes a `projectRoot` string, remote\n * flows (GitHubProvider, GitLabProvider, any custom `RepoReader`) pass\n * the reader directly so `contentrain_status` over HTTP can still\n * report the last operation + stats.\n */\nexport function readContext(projectRoot: string): Promise<ContextJson | null>\nexport function readContext(reader: RepoReader): Promise<ContextJson | null>\nexport async function readContext(input: string | RepoReader): Promise<ContextJson | null> {\n  if (typeof input === 'string') {\n    return readJson<ContextJson>(join(contentrainDir(input), 'context.json'))\n  }\n  try {\n    const raw = await input.readFile(CONTEXT_PATH)\n    return JSON.parse(raw) as ContextJson\n  } catch {\n    return null\n  }\n}\n\nfunction resolveSource(explicit?: ContextSource): ContextSource {\n  if (explicit) return explicit\n  return process.env['CONTENTRAIN_SOURCE'] === 'mcp-studio' ? 'mcp-studio' : 'mcp-local'\n}\n\nasync function computeEntriesCount(projectRoot: string): Promise<number | null> {\n  try {\n    const models = await listModels(projectRoot)\n    const fullModels = await Promise.all(models.map(m => readModel(projectRoot, m.id)))\n    const counts = await Promise.all(\n      fullModels\n        .filter((m): m is NonNullable<typeof m> => m !== null)\n        .map(m => countEntries(projectRoot, m)),\n    )\n    return counts.reduce((acc, c) => acc + c.total, 0)\n  } catch {\n    return null\n  }\n}\n\nexport async function writeContext(\n  projectRoot: string,\n  operation: { tool: string, model: string, locale?: string, entries?: string[] },\n): Promise<void> {\n  const models = await listModels(projectRoot)\n  const config = await readConfig(projectRoot)\n  const locales = config?.locales.supported ?? ['en']\n  const totalEntries = await computeEntriesCount(projectRoot)\n  const source = resolveSource()\n\n  const context: ContextJson = {\n    version: '1',\n    lastOperation: {\n      tool: operation.tool,\n      model: operation.model,\n      locale: operation.locale ?? config?.locales.default ?? 'en',\n      entries: operation.entries,\n      timestamp: new Date().toISOString(),\n      source,\n    },\n    stats: {\n      models: models.length,\n      entries: totalEntries as number,\n      locales,\n      lastSync: new Date().toISOString(),\n    },\n  }\n\n  await writeJson(join(contentrainDir(projectRoot), 'context.json'), context)\n}\n\n/**\n * Build a FileChange for `.contentrain/context.json` that remote providers\n * (GitHubProvider over HTTP, for example) can slot into their plan. The\n * local write path still uses {@link writeContext} directly because its\n * transaction layer writes into the post-apply worktree with real stats.\n *\n * Remote providers (Phase 5.5+) now also get accurate entry counts: the\n * reader-based {@link countEntries} walks each model over the provider's\n * read surface. GitHubProvider pays an extra round trip per model; the\n * payoff is a context.json that matches what the local write path emits,\n * so cross-provider merges stay deterministic.\n *\n * A caller that already knows the model/entry counts (e.g. Studio deriving\n * them from its own index) can pass `opts.stats` to skip that O(models·\n * locales) scan entirely — only `readConfig` remains, for the locale list\n * and the `lastOperation.locale` default. The emitted context.json is\n * byte-identical to the scanned variant for the same logical state.\n */\nexport async function buildContextChange(\n  reader: RepoReader,\n  operation: { tool: string, model: string, locale?: string, entries?: string[] },\n  source?: ContextSource,\n  opts?: { stats?: ContextStats },\n): Promise<FileChange> {\n  const config = await readConfig(reader)\n  const locales = config?.locales.supported ?? ['en']\n\n  let modelCount: number\n  let totalEntries: number | null\n  if (opts?.stats) {\n    modelCount = opts.stats.models\n    totalEntries = opts.stats.entries\n  } else {\n    const models = await listModels(reader)\n    modelCount = models.length\n    try {\n      const fullModels = await Promise.all(models.map(m => readModel(reader, m.id)))\n      const counts = await Promise.all(\n        fullModels\n          .filter((m): m is NonNullable<typeof m> => m !== null)\n          .map(m => countEntries(reader, m)),\n      )\n      totalEntries = counts.reduce((acc, c) => acc + c.total, 0)\n    } catch {\n      totalEntries = null\n    }\n  }\n\n  const context: ContextJson = {\n    version: '1',\n    lastOperation: {\n      tool: operation.tool,\n      model: operation.model,\n      locale: operation.locale ?? config?.locales.default ?? 'en',\n      entries: operation.entries,\n      timestamp: new Date().toISOString(),\n      source: resolveSource(source),\n    },\n    stats: {\n      models: modelCount,\n      entries: totalEntries as number,\n      locales,\n      lastSync: new Date().toISOString(),\n    },\n  }\n\n  return {\n    path: CONTEXT_PATH,\n    content: canonicalStringify(context),\n  }\n}\n"],"mappings":";;;;;;AAQA,MAAM,eAAe;AAyBrB,eAAsB,YAAY,OAAyD;AACzF,KAAI,OAAO,UAAU,SACnB,QAAO,SAAsB,KAAK,eAAe,MAAM,EAAE,eAAe,CAAC;AAE3E,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,SAAS,aAAa;AAC9C,SAAO,KAAK,MAAM,IAAI;SAChB;AACN,SAAO;;;AAIX,SAAS,cAAc,UAAyC;AAC9D,KAAI,SAAU,QAAO;AACrB,QAAO,QAAQ,IAAI,0BAA0B,eAAe,eAAe;;AAG7E,eAAe,oBAAoB,aAA6C;AAC9E,KAAI;EACF,MAAM,SAAS,MAAM,WAAW,YAAY;EAC5C,MAAM,aAAa,MAAM,QAAQ,IAAI,OAAO,KAAI,MAAK,UAAU,aAAa,EAAE,GAAG,CAAC,CAAC;AAMnF,UALe,MAAM,QAAQ,IAC3B,WACG,QAAQ,MAAkC,MAAM,KAAK,CACrD,KAAI,MAAK,aAAa,aAAa,EAAE,CAAC,CAC1C,EACa,QAAQ,KAAK,MAAM,MAAM,EAAE,OAAO,EAAE;SAC5C;AACN,SAAO;;;AAIX,eAAsB,aACpB,aACA,WACe;CACf,MAAM,SAAS,MAAM,WAAW,YAAY;CAC5C,MAAM,SAAS,MAAM,WAAW,YAAY;CAC5C,MAAM,UAAU,QAAQ,QAAQ,aAAa,CAAC,KAAK;CACnD,MAAM,eAAe,MAAM,oBAAoB,YAAY;CAC3D,MAAM,SAAS,eAAe;CAE9B,MAAM,UAAuB;EAC3B,SAAS;EACT,eAAe;GACb,MAAM,UAAU;GAChB,OAAO,UAAU;GACjB,QAAQ,UAAU,UAAU,QAAQ,QAAQ,WAAW;GACvD,SAAS,UAAU;GACnB,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC;GACD;EACD,OAAO;GACL,QAAQ,OAAO;GACf,SAAS;GACT;GACA,2BAAU,IAAI,MAAM,EAAC,aAAa;GACnC;EACF;AAED,OAAM,UAAU,KAAK,eAAe,YAAY,EAAE,eAAe,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;AAqB7E,eAAsB,mBACpB,QACA,WACA,QACA,MACqB;CACrB,MAAM,SAAS,MAAM,WAAW,OAAO;CACvC,MAAM,UAAU,QAAQ,QAAQ,aAAa,CAAC,KAAK;CAEnD,IAAI;CACJ,IAAI;AACJ,KAAI,MAAM,OAAO;AACf,eAAa,KAAK,MAAM;AACxB,iBAAe,KAAK,MAAM;QACrB;EACL,MAAM,SAAS,MAAM,WAAW,OAAO;AACvC,eAAa,OAAO;AACpB,MAAI;GACF,MAAM,aAAa,MAAM,QAAQ,IAAI,OAAO,KAAI,MAAK,UAAU,QAAQ,EAAE,GAAG,CAAC,CAAC;AAM9E,mBALe,MAAM,QAAQ,IAC3B,WACG,QAAQ,MAAkC,MAAM,KAAK,CACrD,KAAI,MAAK,aAAa,QAAQ,EAAE,CAAC,CACrC,EACqB,QAAQ,KAAK,MAAM,MAAM,EAAE,OAAO,EAAE;UACpD;AACN,kBAAe;;;AAsBnB,QAAO;EACL,MAAM;EACN,SAAS,mBApBkB;GAC3B,SAAS;GACT,eAAe;IACb,MAAM,UAAU;IAChB,OAAO,UAAU;IACjB,QAAQ,UAAU,UAAU,QAAQ,QAAQ,WAAW;IACvD,SAAS,UAAU;IACnB,4BAAW,IAAI,MAAM,EAAC,aAAa;IACnC,QAAQ,cAAc,OAAO;IAC9B;GACD,OAAO;IACL,QAAQ;IACR,SAAS;IACT;IACA,2BAAU,IAAI,MAAM,EAAC,aAAa;IACnC;GACF,CAIqC;EACrC"}

package/dist/core/apply-manager.d.mts

@@ -6,6 +6,8 @@ interface ExtractionEntry {
   kind: 'singleton' | 'collection' | 'dictionary' | 'document';
   domain: string;
   i18n?: boolean;
+  /** Optional — inferred from `fields` when omitted, and reported in the dry run. */
+  title_field?: string;
   fields?: Record<string, FieldDef>;
   entries: Array<{
     locale?: string;
@@ -33,6 +35,12 @@ interface ExtractionPreview {
   models_to_update: string[];
   total_entries: number;
   content_files: string[];
+  /**
+   * Resolved `title_field` per model, keyed by model id. Surfaced in the dry run
+   * because the extract envelope may omit it — without this the agent would be
+   * approving a schema decision it never saw.
+   */
+  title_fields: Record<string, string>;
 }
 interface ExtractionResult {
   dry_run: boolean;

package/dist/core/apply-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-manager.d.mts","names":[],"sources":["../../src/core/apply-manager.ts"],"mappings":";;;UAYiB,eAAA;EACf,KAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA;EACA,MAAA,GAAS,MAAA,SAAe,QAAA;EACxB,OAAA,EAAS,KAAA;IACP,MAAA;IACA,IAAA;IACA,IAAA,EAAM,MAAA;IACN,MAAA;MAAW,IAAA;MAAc,IAAA;MAAc,KAAA;IAAA;IACvC,OAAA,GAAU,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,GAAA;MAAa,KAAA;IAAA;EAAA;AAAA;AAAA,UAI9C,eAAA;EACf,WAAA,EAAa,eAAA;EACb,OAAA;AAAA;AAAA,UAGe,iBAAA;EACf,gBAAA;EACA,gBAAA;EACA,aAAA;EACA,aAAA;AAAA;AAAA,UAGe,gBAAA;EACf,OAAA;EACA,OAAA,GAAU,iBAAA;EACV,KAAA;EACA,iBAAA;EACA,OAAA;IACE,cAAA;IACA,cAAA;IACA,eAAA;IACA,UAAA,EAAY,KAAA;MAAQ,KAAA;MAAe,MAAA;MAAgB,KAAA;MAAe,IAAA;MAAc,IAAA;IAAA;EAAA;EAElF,GAAA;IAAQ,MAAA;IAAgB,MAAA;IAAgB,MAAA;IAAgB,OAAA;EAAA;EACxD,eAAA;EACA,UAAA;AAAA;AAAA,UAGe,UAAA;EACf,IAAA;EACA,IAAA;EACA,SAAA;EACA,cAAA;EACA,gBAAA;AAAA;AAAA,UAGe,UAAA;EACf,KAAA;IAAS,KAAA;IAAgB,MAAA;EAAA;EACzB,OAAA,EAAS,UAAA;EACT,OAAA;AAAA;AAAA,UAGe,WAAA;EACf,IAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,KAAA;EACA,cAAA;EACA,OAAA;IACE,eAAA;IACA,aAAA;IACA,cAAA;EAAA;EAEF,OAAA;IACE,cAAA;IACA,eAAA;IACA,eAAA,EAAiB,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,MAAA;IAAA;IACrD,aAAA;IACA,kBAAA,GAAqB,KAAA;MAAQ,IAAA;MAAc,OAAA;IAAA;IAC3C,aAAA,GAAgB,WAAA;EAAA;EAElB,GAAA;IAAQ,MAAA;IAAgB,MAAA;IAAgB,MAAA;IAAgB,OAAA;EAAA;EACxD,UAAA;AAAA;;cAQW,oBAAA,EAAoB,GAAA;AAAA,iBAajB,mBAAA,CAAoB,QAAA,WAAmB,eAAA;;;;;iBAmBvC,2BAAA,CACd,QAAA,UACA,aAAA,UACA,OAAA;;;;;iBAyCc,iBAAA,CAAkB,QAAA;;;;;iBAoClB,WAAA,CAAY,QAAA,UAAkB,OAAA;AAAA,iBA8JxB,YAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,GACN,OAAA,CAAQ,gBAAA;AAAA,iBA+RW,UAAA,CACpB,WAAA,UACA,KAAA,EAAO,UAAA,GACN,OAAA,CAAQ,WAAA;;;;;;;;;iBAgZK,aAAA,CAAc,IAAA,UAAc,QAAA,UAAkB,aAAA"}
+{"version":3,"file":"apply-manager.d.mts","names":[],"sources":["../../src/core/apply-manager.ts"],"mappings":";;;UAYiB,eAAA;EACf,KAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA;EAGwB;EADxB,WAAA;EACA,MAAA,GAAS,MAAA,SAAe,QAAA;EACxB,OAAA,EAAS,KAAA;IACP,MAAA;IACA,IAAA;IACA,IAAA,EAAM,MAAA;IACN,MAAA;MAAW,IAAA;MAAc,IAAA;MAAc,KAAA;IAAA;IACvC,OAAA,GAAU,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,GAAA;MAAa,KAAA;IAAA;EAAA;AAAA;AAAA,UAI9C,eAAA;EACf,WAAA,EAAa,eAAA;EACb,OAAA;AAAA;AAAA,UAGe,iBAAA;EACf,gBAAA;EACA,gBAAA;EACA,aAAA;EACA,aAAA;EAbgD;;;;AAIlD;EAeE,YAAA,EAAc,MAAA;AAAA;AAAA,UAGC,gBAAA;EACf,OAAA;EACA,OAAA,GAAU,iBAAA;EACV,KAAA;EACA,iBAAA;EACA,OAAA;IACE,cAAA;IACA,cAAA;IACA,eAAA;IACA,UAAA,EAAY,KAAA;MAAQ,KAAA;MAAe,MAAA;MAAgB,KAAA;MAAe,IAAA;MAAc,IAAA;IAAA;EAAA;EAElF,GAAA;IAAQ,MAAA;IAAgB,MAAA;IAAgB,MAAA;IAAgB,OAAA;EAAA;EACxD,eAAA;EACA,UAAA;AAAA;AAAA,UAGe,UAAA;EACf,IAAA;EACA,IAAA;EACA,SAAA;EACA,cAAA;EACA,gBAAA;AAAA;AAAA,UAGe,UAAA;EACf,KAAA;IAAS,KAAA;IAAgB,MAAA;EAAA;EACzB,OAAA,EAAS,UAAA;EACT,OAAA;AAAA;AAAA,UAGe,WAAA;EACf,IAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,KAAA;EACA,cAAA;EACA,OAAA;IACE,eAAA;IACA,aAAA;IACA,cAAA;EAAA;EAEF,OAAA;IACE,cAAA;IACA,eAAA;IACA,eAAA,EAAiB,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,MAAA;IAAA;IACrD,aAAA;IACA,kBAAA,GAAqB,KAAA;MAAQ,IAAA;MAAc,OAAA;IAAA;IAC3C,aAAA,GAAgB,WAAA;EAAA;EAElB,GAAA;IAAQ,MAAA;IAAgB,MAAA;IAAgB,MAAA;IAAgB,OAAA;EAAA;EACxD,UAAA;AAAA;;cAQW,oBAAA,EAAoB,GAAA;AAAA,iBAajB,mBAAA,CAAoB,QAAA,WAAmB,eAAA;;;;;iBAmBvC,2BAAA,CACd,QAAA,UACA,aAAA,UACA,OAAA;;;;;iBAyCc,iBAAA,CAAkB,QAAA;;;;;iBAoClB,WAAA,CAAY,QAAA,UAAkB,OAAA;AAAA,iBA8JxB,YAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,GACN,OAAA,CAAQ,gBAAA;AAAA,iBAmUW,UAAA,CACpB,WAAA,UACA,KAAA,EAAO,UAAA,GACN,OAAA,CAAQ,WAAA;;;;;;;;;iBAgZK,aAAA,CAAc,IAAA,UAAc,QAAA,UAAkB,aAAA"}

package/dist/core/apply-manager.mjs

@@ -1,11 +1,12 @@
-import "../serialization-B1CEzR4H.mjs";
+import "../serialization-tmgfFBOh.mjs";
 import "../fs-DLbVB-Ek.mjs";
-import "../meta-manager-CJUiTgP2.mjs";
-import "../config-oxxgznz7.mjs";
-import "../model-manager-DP2CZiMT.mjs";
-import "../context-DjglDPvj.mjs";
-import "../branch-lifecycle-BAfgSQBv.mjs";
-import "../id-DV_T9Ic8.mjs";
-import "../transaction-1SPznNt3.mjs";
-import { a as detectFileFramework, c as validatePatchPath, i as checkSyntax, n as applyExtract, o as replaceInLine, r as applyReuse, s as validateFrameworkExpression, t as PATCHABLE_EXTENSIONS } from "../apply-manager-SLCRLHN_.mjs";
+import "../meta-manager-B_Se183X.mjs";
+import "../identity-D8QoGxhT.mjs";
+import "../config-VlRKRwAS.mjs";
+import "../branch-lifecycle-B6PXZ2N7.mjs";
+import "../model-manager-DgyKMjLN.mjs";
+import "../context-C3x6I3cE.mjs";
+import "../id-BjhaIxTL.mjs";
+import "../transaction-BW9ektWu.mjs";
+import { a as detectFileFramework, c as validatePatchPath, i as checkSyntax, n as applyExtract, o as replaceInLine, r as applyReuse, s as validateFrameworkExpression, t as PATCHABLE_EXTENSIONS } from "../apply-manager-BybvnUVC.mjs";
 export { PATCHABLE_EXTENSIONS, applyExtract, applyReuse, checkSyntax, detectFileFramework, replaceInLine, validateFrameworkExpression, validatePatchPath };

package/dist/core/config.d.mts

@@ -1,4 +1,4 @@
-import { _ as RepoReader } from "../index-w8QHThNS.mjs";
+import { _ as RepoReader } from "../index-BWbTJlXm.mjs";
 import { ContentrainConfig, Vocabulary } from "@contentrain/types";
 
 //#region src/core/config.d.ts

package/dist/core/config.mjs

@@ -1,3 +1,3 @@
 import "../fs-DLbVB-Ek.mjs";
-import { n as readVocabulary, t as readConfig } from "../config-oxxgznz7.mjs";
+import { n as readVocabulary, t as readConfig } from "../config-VlRKRwAS.mjs";
 export { readConfig, readVocabulary };

package/dist/core/content-manager.d.mts

@@ -1,2 +1,2 @@
-import { _ as writeContent, a as deleteContent, c as readContent, d as resolveLocaleStrategy, f as resolveMdFilePath, g as validateSlug, h as validateLocale, i as WriteResult, l as resolveContentDir, m as validateEntryId, n as DeleteOpts, o as listContent, p as serializeFrontmatter, r as ListOpts, s as parseFrontmatter, t as ContentEntry, u as resolveJsonFilePath } from "../content-manager-DWo3G64y.mjs";
-export { ContentEntry, DeleteOpts, ListOpts, WriteResult, deleteContent, listContent, parseFrontmatter, readContent, resolveContentDir, resolveJsonFilePath, resolveLocaleStrategy, resolveMdFilePath, serializeFrontmatter, validateEntryId, validateLocale, validateSlug, writeContent };
+import { _ as validateEntryId, a as ListOpts, b as writeContent, c as deleteContent, d as readContent, f as resolveContentDir, g as serializeFrontmatter, h as resolveMdFilePath, i as DeleteOpts, l as listContent, m as resolveLocaleStrategy, n as ContentFileModel, o as LocaleStrategyModel, p as resolveJsonFilePath, r as ContentPathModel, s as WriteResult, t as ContentEntry, u as parseFrontmatter, v as validateLocale, y as validateSlug } from "../content-manager-Dn4tqDw1.mjs";
+export { ContentEntry, ContentFileModel, ContentPathModel, DeleteOpts, ListOpts, LocaleStrategyModel, WriteResult, deleteContent, listContent, parseFrontmatter, readContent, resolveContentDir, resolveJsonFilePath, resolveLocaleStrategy, resolveMdFilePath, serializeFrontmatter, validateEntryId, validateLocale, validateSlug, writeContent };

package/dist/core/content-manager.mjs

@@ -1,4 +1,4 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../meta-manager-CJUiTgP2.mjs";
-import { S as writeContent, _ as resolveMdFilePath, b as validateLocale, d as listContent, f as parseFrontmatter, g as resolveLocaleStrategy, h as resolveJsonFilePath, m as resolveContentDir, p as readContent, u as deleteContent, v as serializeFrontmatter, x as validateSlug, y as validateEntryId } from "../model-manager-DP2CZiMT.mjs";
+import "../meta-manager-B_Se183X.mjs";
+import { C as validateLocale, S as validateEntryId, T as writeContent, _ as resolveContentDir, b as resolveMdFilePath, g as readContent, h as parseFrontmatter, m as listContent, p as deleteContent, v as resolveJsonFilePath, w as validateSlug, x as serializeFrontmatter, y as resolveLocaleStrategy } from "../model-manager-DgyKMjLN.mjs";
 export { deleteContent, listContent, parseFrontmatter, readContent, resolveContentDir, resolveJsonFilePath, resolveLocaleStrategy, resolveMdFilePath, serializeFrontmatter, validateEntryId, validateLocale, validateSlug, writeContent };

package/dist/core/context.d.mts

@@ -1,4 +1,4 @@
-import { _ as RepoReader, a as FileChange } from "../index-w8QHThNS.mjs";
+import { _ as RepoReader, a as FileChange } from "../index-BWbTJlXm.mjs";
 import { ContextJson, ContextSource } from "@contentrain/types";
 
 //#region src/core/context.d.ts

package/dist/core/context.mjs

@@ -1,7 +1,7 @@
-import "../serialization-B1CEzR4H.mjs";
+import "../serialization-tmgfFBOh.mjs";
 import "../fs-DLbVB-Ek.mjs";
-import "../meta-manager-CJUiTgP2.mjs";
-import "../config-oxxgznz7.mjs";
-import "../model-manager-DP2CZiMT.mjs";
-import { n as readContext, r as writeContext, t as buildContextChange } from "../context-DjglDPvj.mjs";
+import "../meta-manager-B_Se183X.mjs";
+import "../config-VlRKRwAS.mjs";
+import "../model-manager-DgyKMjLN.mjs";
+import { n as readContext, r as writeContext, t as buildContextChange } from "../context-C3x6I3cE.mjs";
 export { buildContextChange, readContext, writeContext };

package/dist/core/contracts/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as RepoReader, a as FileChange, c as MediaAsset, d as MediaListResult, f as MediaProvider, g as RepoProvider, h as ProviderCapabilities, i as CommitAuthor, l as MediaIngestInput, m as MergeResult, n as Branch, o as FileDiff, p as MediaUpdateInput, r as Commit, s as LOCAL_CAPABILITIES, t as ApplyPlanInput, u as MediaListOptions, v as RepoWriter } from "../../index-w8QHThNS.mjs";
-export { ApplyPlanInput, Branch, Commit, CommitAuthor, FileChange, FileDiff, LOCAL_CAPABILITIES, MediaAsset, MediaIngestInput, MediaListOptions, MediaListResult, MediaProvider, MediaUpdateInput, MergeResult, ProviderCapabilities, RepoProvider, RepoReader, RepoWriter };
+import { _ as RepoReader, a as FileChange, c as MediaAsset, d as MediaListResult, f as MediaProvider, g as RepoProvider, h as ProviderCapabilities, i as CommitAuthor, l as MediaIngestInput, m as MergeResult, n as Branch, o as FileDiff, p as MediaUpdateInput, r as Commit, s as LOCAL_CAPABILITIES, t as ApplyPlanInput, u as MediaListOptions, v as RepoWriter, y as WriteReadiness } from "../../index-BWbTJlXm.mjs";
+export { ApplyPlanInput, Branch, Commit, CommitAuthor, FileChange, FileDiff, LOCAL_CAPABILITIES, MediaAsset, MediaIngestInput, MediaListOptions, MediaListResult, MediaProvider, MediaUpdateInput, MergeResult, ProviderCapabilities, RepoProvider, RepoReader, RepoWriter, WriteReadiness };

package/dist/core/doctor.mjs

@@ -1,8 +1,9 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../meta-manager-CJUiTgP2.mjs";
-import "../config-oxxgznz7.mjs";
-import "../model-manager-DP2CZiMT.mjs";
-import "../branch-lifecycle-BAfgSQBv.mjs";
-import "../scan-config-BlNLRCMx.mjs";
-import { t as runDoctor } from "../doctor-BwJ_nmqS.mjs";
+import "../meta-manager-B_Se183X.mjs";
+import "../identity-D8QoGxhT.mjs";
+import "../config-VlRKRwAS.mjs";
+import "../branch-lifecycle-B6PXZ2N7.mjs";
+import "../model-manager-DgyKMjLN.mjs";
+import "../scan-config-Dx49nCqk.mjs";
+import { t as runDoctor } from "../doctor-DNPuGgcg.mjs";
 export { runDoctor };

package/dist/core/graph-builder.mjs

@@ -1,4 +1,4 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../scan-config-BlNLRCMx.mjs";
-import { t as buildGraph } from "../graph-builder-DK4Mh8Tn.mjs";
+import "../scan-config-Dx49nCqk.mjs";
+import { t as buildGraph } from "../graph-builder-BEocwW13.mjs";
 export { buildGraph };

package/dist/core/meta-manager.d.mts

@@ -1,4 +1,4 @@
-import { EntryMeta, ModelDefinition } from "@contentrain/types";
+import { ContentStatus, EntryMeta, ModelDefinition } from "@contentrain/types";
 
 //#region src/core/meta-manager.d.ts
 interface MetaOpts {
@@ -15,15 +15,14 @@ interface MetaOpts {
 }
 declare function readMeta(projectRoot: string, model: ModelDefinition, opts: MetaOpts): Promise<EntryMeta | Record<string, EntryMeta> | null>;
 /**
- * Build the meta for a content write, merged over the entry's existing meta.
+ * Meta for a deliberate status change.
  *
- * `status` is a publish decision and belongs to whoever made it — editing a
- * field must not unpublish an entry. Only an entry with no meta yet starts at
- * `draft`. `source`/`updated_by` describe *this* write, so they are stamped
- * every time; `approved_by`/`version` survive via the spread.
- *
- * Pass `existing: undefined` to mint meta for a genuinely new entry.
+ * Distinct from {@link mergeEntryMeta}, which preserves `status` on purpose —
+ * editing a field must not unpublish an entry. Changing the status IS the
+ * operation here, so it is the one place that may overwrite it. Everything
+ * else about the write is stamped identically.
  */
+declare function applyStatusChange(existing: EntryMeta, status: ContentStatus): EntryMeta;
 declare function mergeEntryMeta(existing: EntryMeta | undefined, data?: Record<string, unknown>): EntryMeta;
 declare function writeMeta(projectRoot: string, model: ModelDefinition, opts: MetaOpts, meta: EntryMeta): Promise<void>;
 /**
@@ -38,5 +37,5 @@ declare function writeMeta(projectRoot: string, model: ModelDefinition, opts: Me
 declare function writeMetaEntries(projectRoot: string, model: ModelDefinition, opts: MetaOpts, updates: Record<string, EntryMeta>): Promise<string[]>;
 declare function deleteMeta(projectRoot: string, model: ModelDefinition, opts: MetaOpts): Promise<void>;
 //#endregion
-export { deleteMeta, mergeEntryMeta, readMeta, writeMeta, writeMetaEntries };
+export { applyStatusChange, deleteMeta, mergeEntryMeta, readMeta, writeMeta, writeMetaEntries };
 //# sourceMappingURL=meta-manager.d.mts.map

package/dist/core/meta-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-manager.d.mts","names":[],"sources":["../../src/core/meta-manager.ts"],"mappings":";;;UAKU,QAAA;EACR,MAAA;EACA,OAAA;EACA,IAAA;;;;;;;EAOA,aAAA;AAAA;AAAA,iBAkBoB,QAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,GACL,OAAA,CAAQ,SAAA,GAAY,MAAA,SAAe,SAAA;;;;;;;;;;;iBActB,cAAA,CACd,QAAA,EAAU,SAAA,cACV,IAAA,GAAO,MAAA,oBACN,SAAA;AAAA,iBAYmB,SAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,EACN,IAAA,EAAM,SAAA,GACL,OAAA;;;;;;;;;;iBAqBmB,gBAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,EACN,OAAA,EAAS,MAAA,SAAe,SAAA,IACvB,OAAA;AAAA,iBAUmB,UAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,GACL,OAAA"}
+{"version":3,"file":"meta-manager.d.mts","names":[],"sources":["../../src/core/meta-manager.ts"],"mappings":";;;UAKU,QAAA;EACR,MAAA;EACA,OAAA;EACA,IAAA;;;;;;;EAOA,aAAA;AAAA;AAAA,iBAkBoB,QAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,GACL,OAAA,CAAQ,SAAA,GAAY,MAAA,SAAe,SAAA;;;;;;;;;iBA8BtB,iBAAA,CAAkB,QAAA,EAAU,SAAA,EAAW,MAAA,EAAQ,aAAA,GAAgB,SAAA;AAAA,iBAS/D,cAAA,CACd,QAAA,EAAU,SAAA,cACV,IAAA,GAAO,MAAA,oBACN,SAAA;AAAA,iBAamB,SAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,EACN,IAAA,EAAM,SAAA,GACL,OAAA;;;;;;;;;;iBAqBmB,gBAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,EACN,OAAA,EAAS,MAAA,SAAe,SAAA,IACvB,OAAA;AAAA,iBAUmB,UAAA,CACpB,WAAA,UACA,KAAA,EAAO,eAAA,EACP,IAAA,EAAM,QAAA,GACL,OAAA"}

package/dist/core/meta-manager.mjs

@@ -1,3 +1,3 @@
 import "../fs-DLbVB-Ek.mjs";
-import { a as writeMetaEntries, i as writeMeta, n as mergeEntryMeta, r as readMeta, t as deleteMeta } from "../meta-manager-CJUiTgP2.mjs";
-export { deleteMeta, mergeEntryMeta, readMeta, writeMeta, writeMetaEntries };
+import { a as writeMeta, i as readMeta, n as deleteMeta, o as writeMetaEntries, r as mergeEntryMeta, t as applyStatusChange } from "../meta-manager-B_Se183X.mjs";
+export { applyStatusChange, deleteMeta, mergeEntryMeta, readMeta, writeMeta, writeMetaEntries };

package/dist/core/model-manager.d.mts

@@ -1,5 +1,5 @@
-import { _ as RepoReader } from "../index-w8QHThNS.mjs";
-import { ModelDefinition, ModelSummary, ModelSummary as ModelSummary$1 } from "@contentrain/types";
+import { _ as RepoReader } from "../index-BWbTJlXm.mjs";
+import { MODEL_FIELD_ORDER, ModelDefinition, ModelSummary, ModelSummary as ModelSummary$1 } from "@contentrain/types";
 import { z } from "zod";
 
 //#region src/core/model-manager.d.ts
@@ -65,6 +65,41 @@ interface ModelDefinitionIssues {
   /** Surface to the caller; the write proceeds. */
   warnings: string[];
 }
+interface TitleFieldPick {
+  field: string;
+  /** Which rule chose it — surfaced to the user so an inferred title can be overruled. */
+  rule: 'dictionary' | 'name-match' | 'required-displayable' | 'displayable';
+}
+/**
+ * Pick the field a model should title its entries by.
+ *
+ * Migration aid only — it exists to backfill models authored before `title_field`
+ * was required, and `contentrain validate --fix` is its one caller. New models
+ * declare the field; nothing here runs on the write path.
+ *
+ * Every rung filters by `isTitleFieldType` first. That filter is the whole point:
+ * an unfiltered name match hands the title to a field called `name` that happens
+ * to be typed `icon`, which is the exact bug this contract replaces.
+ *
+ * Returns `null` when no field can render as a title. That is a real answer, not a
+ * failure — guessing `image` or `relation` here would re-create the bug, so the
+ * validation error stands and a human picks.
+ */
+declare function inferTitleField(kind: string, fields?: Record<string, unknown>): TitleFieldPick | null;
+/**
+ * The `title_field` rule table.
+ *
+ * Extracted so `validateModelDefinition` (write path) and the project validator
+ * (read path) report the same wording from one place, rather than one of them
+ * sniffing the other's strings.
+ *
+ * Chained so a model gets one title_field error, not a cascade of five.
+ */
+declare function titleFieldIssues(input: {
+  kind: string;
+  title_field?: unknown;
+  fields?: Record<string, unknown>;
+}): ModelDefinitionIssues;
 /**
  * Validate a model definition before writing.
  * Used by both the model_save tool and normalize extract.
@@ -72,8 +107,9 @@ interface ModelDefinitionIssues {
 declare function validateModelDefinition(input: {
   id: string;
   kind: string;
+  title_field?: unknown;
   fields?: Record<string, unknown>;
 }): ModelDefinitionIssues;
 //#endregion
-export { FIELD_TYPE_ENUM, ModelDefinitionIssues, ModelReference, type ModelSummary, checkReferences, countEntries, deleteModel, fieldDefZodSchema, listModels, readModel, validateModelDefinition, writeModel };
+export { FIELD_TYPE_ENUM, MODEL_FIELD_ORDER, ModelDefinitionIssues, ModelReference, type ModelSummary, TitleFieldPick, checkReferences, countEntries, deleteModel, fieldDefZodSchema, inferTitleField, listModels, readModel, titleFieldIssues, validateModelDefinition, writeModel };
 //# sourceMappingURL=model-manager.d.mts.map

package/dist/core/model-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"model-manager.d.mts","names":[],"sources":["../../src/core/model-manager.ts"],"mappings":";;;;;;AA6BA;;;;;;iBAAgB,UAAA,CAAW,WAAA,WAAsB,OAAA,CAAQ,cAAA;AAAA,iBACzC,UAAA,CAAW,MAAA,EAAQ,UAAA,GAAa,OAAA,CAAQ,cAAA;;AAAxD;;iBAgCgB,SAAA,CAAU,WAAA,UAAqB,OAAA,WAAkB,OAAA,CAAQ,eAAA;AAAA,iBACzD,SAAA,CAAU,MAAA,EAAQ,UAAA,EAAY,OAAA,WAAkB,OAAA,CAAQ,eAAA;;;;;;;;iBA4JxD,YAAA,CACd,WAAA,UACA,KAAA,EAAO,eAAA,GACN,OAAA;EAAU,KAAA;EAAe,OAAA,EAAS,MAAA;AAAA;AAAA,iBACrB,YAAA,CACd,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,eAAA,GACN,OAAA;EAAU,KAAA;EAAe,OAAA,EAAS,MAAA;AAAA;AAAA,iBAgIf,UAAA,CAAW,WAAA,UAAqB,KAAA,EAAO,eAAA,GAAkB,OAAA;AAAA,iBASzD,WAAA,CAAY,WAAA,UAAqB,OAAA,WAAkB,OAAA;AAAA,UA+BxD,cAAA;EACf,KAAA;EACA,KAAA;EACA,IAAA;AAAA;;;;;;;;;iBAWc,eAAA,CAAgB,WAAA,UAAqB,OAAA,WAAkB,OAAA,CAAQ,cAAA;AAAA,iBAC/D,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,OAAA,WAAkB,OAAA,CAAQ,cAAA;AAAA,cA8BjE,eAAA;;;AA5Nb;;;;;;cA8Oa,iBAAA,EAAmB,CAAA,CAAE,OAAA,CAAQ,MAAA;AAAA,UAiCzB,qBAAA;EA9Qf;EAgRA,MAAA;EA/QA;EAiRA,QAAA;AAAA;;;;;iBAkKc,uBAAA,CACd,KAAA;EAAS,EAAA;EAAY,IAAA;EAAc,MAAA,GAAS,MAAA;AAAA,IAC3C,qBAAA"}
+{"version":3,"file":"model-manager.d.mts","names":[],"sources":["../../src/core/model-manager.ts"],"mappings":";;;;;AAkCA;;;;;;;AAAA,iBAAgB,UAAA,CAAW,WAAA,WAAsB,OAAA,CAAQ,cAAA;AAAA,iBACzC,UAAA,CAAW,MAAA,EAAQ,UAAA,GAAa,OAAA,CAAQ,cAAA;AAAxD;;;AAAA,iBAgCgB,SAAA,CAAU,WAAA,UAAqB,OAAA,WAAkB,OAAA,CAAQ,eAAA;AAAA,iBACzD,SAAA,CAAU,MAAA,EAAQ,UAAA,EAAY,OAAA,WAAkB,OAAA,CAAQ,eAAA;;;;;;;;iBA4JxD,YAAA,CACd,WAAA,UACA,KAAA,EAAO,eAAA,GACN,OAAA;EAAU,KAAA;EAAe,OAAA,EAAS,MAAA;AAAA;AAAA,iBACrB,YAAA,CACd,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,eAAA,GACN,OAAA;EAAU,KAAA;EAAe,OAAA,EAAS,MAAA;AAAA;AAAA,iBA8Hf,UAAA,CAAW,WAAA,UAAqB,KAAA,EAAO,eAAA,GAAkB,OAAA;AAAA,iBASzD,WAAA,CAAY,WAAA,UAAqB,OAAA,WAAkB,OAAA;AAAA,UA+BxD,cAAA;EACf,KAAA;EACA,KAAA;EACA,IAAA;AAAA;;;;;;;;;iBAWc,eAAA,CAAgB,WAAA,UAAqB,OAAA,WAAkB,OAAA,CAAQ,cAAA;AAAA,iBAC/D,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,OAAA,WAAkB,OAAA,CAAQ,cAAA;AAAA,cA8BjE,eAAA;;AA1Nb;;;;;;;cA4Oa,iBAAA,EAAmB,CAAA,CAAE,OAAA,CAAQ,MAAA;AAAA,UAqCzB,qBAAA;EA/QR;EAiRP,MAAA;EAhRC;EAkRD,QAAA;AAAA;AAAA,UA+Me,cAAA;EACf,KAAA;EAleyC;EAoezC,IAAA;AAAA;;;;;;;;;;;;;;;;iBAwDc,eAAA,CAAgB,IAAA,UAAc,MAAA,GAAS,MAAA,oBAA0B,cAAA;;AA1ZjF;;;;;;;;iBA2bgB,gBAAA,CACd,KAAA;EAAS,IAAA;EAAc,WAAA;EAAuB,MAAA,GAAS,MAAA;AAAA,IACtD,qBAAA;;;;;iBAyCa,uBAAA,CAId,KAAA;EAAS,EAAA;EAAY,IAAA;EAAc,WAAA;EAAuB,MAAA,GAAS,MAAA;AAAA,IAClE,qBAAA"}

package/dist/core/model-manager.mjs

@@ -1,4 +1,4 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../meta-manager-CJUiTgP2.mjs";
-import { a as fieldDefZodSchema, c as validateModelDefinition, i as deleteModel, l as writeModel, n as checkReferences, o as listModels, r as countEntries, s as readModel, t as FIELD_TYPE_ENUM } from "../model-manager-DP2CZiMT.mjs";
-export { FIELD_TYPE_ENUM, checkReferences, countEntries, deleteModel, fieldDefZodSchema, listModels, readModel, validateModelDefinition, writeModel };
+import "../meta-manager-B_Se183X.mjs";
+import { a as deleteModel, c as listModels, d as validateModelDefinition, f as writeModel, i as countEntries, l as readModel, n as MODEL_FIELD_ORDER, o as fieldDefZodSchema, r as checkReferences, s as inferTitleField, t as FIELD_TYPE_ENUM, u as titleFieldIssues } from "../model-manager-DgyKMjLN.mjs";
+export { FIELD_TYPE_ENUM, MODEL_FIELD_ORDER, checkReferences, countEntries, deleteModel, fieldDefZodSchema, inferTitleField, listModels, readModel, titleFieldIssues, validateModelDefinition, writeModel };

package/dist/core/ops/index.d.mts

@@ -1,5 +1,5 @@
-import { _ as RepoReader, a as FileChange } from "../../index-w8QHThNS.mjs";
-import { t as ContentEntry } from "../../content-manager-DWo3G64y.mjs";
+import { _ as RepoReader, a as FileChange } from "../../index-BWbTJlXm.mjs";
+import { t as ContentEntry } from "../../content-manager-Dn4tqDw1.mjs";
 import { ContentrainConfig, ModelDefinition, Vocabulary } from "@contentrain/types";
 
 //#region src/core/ops/apply-to-worktree.d.ts
@@ -173,5 +173,42 @@ declare function documentFilePath(model: Pick<ModelDefinition, 'id' | 'domain' |
  */
 declare function metaFilePath(model: Pick<ModelDefinition, 'id' | 'kind' | 'i18n'>, locale: string, defaultLocale: string, slug?: string): string;
 //#endregion
-export { type ContentDeleteInput, type ContentDeletePlan, type ContentSaveEntryResult, type ContentSavePlan, type ModelDeleteInput, type ModelDeletePlan, type ModelSaveInput, type ModelSavePlan, type ModelSaveResult, type OpPlan, applyChangesToWorktree, contentDirPath, contentFilePath, documentFilePath, metaFilePath, planContentDelete, planContentSave, planModelDelete, planModelSave };
+//#region src/core/ops/vocabulary-save.d.ts
+interface VocabularySaveInput {
+  /**
+   * Terms to add or update, keyed by term slug, each holding its translations
+   * keyed by locale. Merged with what is already there — a term absent from
+   * this map is untouched.
+   */
+  terms: Record<string, Record<string, string>>;
+}
+interface VocabularyDeleteInput {
+  /** Term slugs to remove. A slug that is not present is reported, not an error. */
+  terms: string[];
+}
+interface VocabularySaveResult {
+  added: string[];
+  updated: string[];
+  total: number;
+}
+interface VocabularyDeleteResult {
+  deleted: string[];
+  missing: string[];
+  total: number;
+}
+type VocabularySavePlan = OpPlan<VocabularySaveResult>;
+type VocabularyDeletePlan = OpPlan<VocabularyDeleteResult>;
+/**
+ * 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.
+ */
+declare function planVocabularySave(reader: RepoReader, input: VocabularySaveInput): Promise<VocabularySavePlan>;
+/** Build the FileChange[] to remove vocabulary terms. */
+declare function planVocabularyDelete(reader: RepoReader, input: VocabularyDeleteInput): Promise<VocabularyDeletePlan>;
+//#endregion
+export { type ContentDeleteInput, type ContentDeletePlan, type ContentSaveEntryResult, type ContentSavePlan, type ModelDeleteInput, type ModelDeletePlan, type ModelSaveInput, type ModelSavePlan, type ModelSaveResult, type OpPlan, type VocabularyDeleteInput, type VocabularyDeletePlan, type VocabularySaveInput, type VocabularySavePlan, applyChangesToWorktree, contentDirPath, contentFilePath, documentFilePath, metaFilePath, planContentDelete, planContentSave, planModelDelete, planModelSave, planVocabularyDelete, planVocabularySave };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/ops/apply-to-worktree.ts","../../../src/core/ops/types.ts","../../../src/core/ops/content-delete.ts","../../../src/core/ops/content-save.ts","../../../src/core/ops/model-delete.ts","../../../src/core/ops/model-save.ts","../../../src/core/ops/paths.ts"],"mappings":";;;;;;;;;AAkBA;;;;;;;;;;iBAAsB,sBAAA,CAAuB,QAAA,UAAkB,OAAA,WAAkB,UAAA,KAAe,OAAA;;;;;;;AAAhG;;;;UCRiB,MAAA;EDQgE;ECN/E,OAAA,EAAS,UAAA;EDMqF;ECJ9F,MAAA,EAAQ,OAAA;EDI6F;ECFrG,UAAA;AAAA;AAAA,UAGe,sBAAA;EACf,MAAA;EACA,EAAA;EACA,IAAA;EACA,MAAA;EACA,UAAA;AAAA;AAAA,KAGU,eAAA,GAAkB,MAAA,CAAO,sBAAA;;;UCpBpB,kBAAA;EACf,KAAA,EAAO,eAAA;EACP,EAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA;EFM2C;;;;EED3C,aAAA;AAAA;AAAA,KAGU,iBAAA,GAAoB,MAAA;;;ADVhC;;;;;;;;;;;iBCoDsB,iBAAA,CACpB,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,kBAAA,GACN,OAAA,CAAQ,iBAAA;;;UCvDD,SAAA;EACR,KAAA,EAAO,eAAA;EACP,OAAA,EAAS,YAAA;EACT,MAAA,EAAQ,iBAAA;EACR,UAAA,GAAa,UAAA;EHI8B;;;;;;EGG3C,YAAA;AAAA;;AFXF;;;;;;;;iBEuBsB,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,SAAA,GAAY,OAAA,CAAQ,eAAA;;;UC7BpE,gBAAA;EACf,KAAA,EAAO,eAAA;AAAA;AAAA,KAGG,eAAA,GAAkB,MAAA;;;;;;;;;;;;AHE9B;;;iBGcsB,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,gBAAA,GAAmB,OAAA,CAAQ,eAAA;;;UCN3E,cAAA;EACf,KAAA,EAAO,eAAA;AAAA;AAAA,UAGQ,eAAA;EACf,MAAA;EACA,EAAA;AAAA;AAAA,KAGU,aAAA,GAAgB,MAAA,CAAO,eAAA;;;;;;;;AJjBnC;;iBI4BsB,aAAA,CAAc,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,aAAA;;;;;;;ALpBxF;;;;;;;;;;;;;iBMEgB,cAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA;AAAA,iBAUE,eAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA,2EACZ,MAAA;AAAA,iBAac,gBAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA,kEACZ,MAAA,UACA,IAAA;;;;;;;;;;AL9BF;iBKqDgB,YAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA,2BACZ,MAAA,UACA,aAAA,UACA,IAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/ops/apply-to-worktree.ts","../../../src/core/ops/types.ts","../../../src/core/ops/content-delete.ts","../../../src/core/ops/content-save.ts","../../../src/core/ops/model-delete.ts","../../../src/core/ops/model-save.ts","../../../src/core/ops/paths.ts","../../../src/core/ops/vocabulary-save.ts"],"mappings":";;;;;;;;;AAkBA;;;;;;;;;;iBAAsB,sBAAA,CAAuB,QAAA,UAAkB,OAAA,WAAkB,UAAA,KAAe,OAAA;;;;;;;AAAhG;;;;UCRiB,MAAA;EDQgE;ECN/E,OAAA,EAAS,UAAA;EDMqF;ECJ9F,MAAA,EAAQ,OAAA;EDI6F;ECFrG,UAAA;AAAA;AAAA,UAGe,sBAAA;EACf,MAAA;EACA,EAAA;EACA,IAAA;EACA,MAAA;EACA,UAAA;AAAA;AAAA,KAGU,eAAA,GAAkB,MAAA,CAAO,sBAAA;;;UCpBpB,kBAAA;EACf,KAAA,EAAO,eAAA;EACP,EAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA;EFM2C;;;;EED3C,aAAA;AAAA;AAAA,KAGU,iBAAA,GAAoB,MAAA;;;ADVhC;;;;;;;;;;;iBCoDsB,iBAAA,CACpB,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,kBAAA,GACN,OAAA,CAAQ,iBAAA;;;UCpDD,SAAA;EACR,KAAA,EAAO,eAAA;EACP,OAAA,EAAS,YAAA;EACT,MAAA,EAAQ,iBAAA;EACR,UAAA,GAAa,UAAA;EHC8B;;;;;;EGM3C,YAAA;AAAA;;AFdF;;;;;;;;iBE0BsB,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,SAAA,GAAY,OAAA,CAAQ,eAAA;;;UChCpE,gBAAA;EACf,KAAA,EAAO,eAAA;AAAA;AAAA,KAGG,eAAA,GAAkB,MAAA;;;;;;;;;;;;AHE9B;;;iBGcsB,eAAA,CAAgB,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,gBAAA,GAAmB,OAAA,CAAQ,eAAA;;;UClB3E,cAAA;EACf,KAAA,EAAO,eAAA;AAAA;AAAA,UAGQ,eAAA;EACf,MAAA;EACA,EAAA;AAAA;AAAA,KAGU,aAAA,GAAgB,MAAA,CAAO,eAAA;;;;;;;;AJLnC;;iBIgBsB,aAAA,CAAc,MAAA,EAAQ,UAAA,EAAY,KAAA,EAAO,cAAA,GAAiB,OAAA,CAAQ,aAAA;;;;;;;ALRxF;;;;;;;;;;;;;iBMEgB,cAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA;AAAA,iBAUE,eAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA,2EACZ,MAAA;AAAA,iBAac,gBAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA,kEACZ,MAAA,UACA,IAAA;;;;;;;;;;AL9BF;iBKqDgB,YAAA,CACd,KAAA,EAAO,IAAA,CAAK,eAAA,2BACZ,MAAA,UACA,aAAA,UACA,IAAA;;;UClEe,mBAAA;;;APQjB;;;EOFE,KAAA,EAAO,MAAA,SAAe,MAAA;AAAA;AAAA,UAGP,qBAAA;EPD8C;EOG7D,KAAA;AAAA;AAAA,UAGe,oBAAA;EACf,KAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,UAGe,sBAAA;EACf,OAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,KAGU,kBAAA,GAAqB,MAAA,CAAO,oBAAA;AAAA,KAC5B,oBAAA,GAAuB,MAAA,CAAO,sBAAA;;;;;ANlB1C;;;;iBM4EsB,kBAAA,CACpB,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,mBAAA,GACN,OAAA,CAAQ,kBAAA;;iBA2DW,oBAAA,CACpB,MAAA,EAAQ,UAAA,EACR,KAAA,EAAO,qBAAA,GACN,OAAA,CAAQ,oBAAA"}

package/dist/core/ops/index.mjs

@@ -1,6 +1,6 @@
-import { a as applyChangesToWorktree, i as planContentDelete, n as planModelDelete, r as planContentSave, t as planModelSave } from "../../ops-CGKIKwDc.mjs";
-import "../../serialization-B1CEzR4H.mjs";
+import { a as planContentSave, i as planModelDelete, n as planVocabularySave, o as planContentDelete, r as planModelSave, s as applyChangesToWorktree, t as planVocabularyDelete } from "../../ops-BzbThweu.mjs";
+import "../../serialization-tmgfFBOh.mjs";
 import { i as metaFilePath, n as contentFilePath, r as documentFilePath, t as contentDirPath } from "../../paths-CmVw5Cw2.mjs";
 import "../../fs-DLbVB-Ek.mjs";
-import "../../meta-manager-CJUiTgP2.mjs";
-export { applyChangesToWorktree, contentDirPath, contentFilePath, documentFilePath, metaFilePath, planContentDelete, planContentSave, planModelDelete, planModelSave };
+import "../../meta-manager-B_Se183X.mjs";
+export { applyChangesToWorktree, contentDirPath, contentFilePath, documentFilePath, metaFilePath, planContentDelete, planContentSave, planModelDelete, planModelSave, planVocabularyDelete, planVocabularySave };

package/dist/core/overlay-reader.d.mts

@@ -1,4 +1,4 @@
-import { _ as RepoReader, a as FileChange } from "../index-w8QHThNS.mjs";
+import { _ as RepoReader, a as FileChange } from "../index-BWbTJlXm.mjs";
 
 //#region src/core/overlay-reader.d.ts
 /**

package/dist/core/overlay-reader.mjs

@@ -1,2 +1,2 @@
-import { t as OverlayReader } from "../overlay-reader-DNaVsgiS.mjs";
+import { t as OverlayReader } from "../overlay-reader-CkU_pGXZ.mjs";
 export { OverlayReader };

package/dist/core/scan-config.mjs

@@ -1,3 +1,3 @@
 import "../fs-DLbVB-Ek.mjs";
-import { a as classifyFile, i as autoDetectSourceDirs, n as SCAN_EXTENSIONS, o as discoverFiles, r as SCAN_IGNORE_DIRS, t as MAX_SCAN_FILES } from "../scan-config-BlNLRCMx.mjs";
+import { a as classifyFile, i as autoDetectSourceDirs, n as SCAN_EXTENSIONS, o as discoverFiles, r as SCAN_IGNORE_DIRS, t as MAX_SCAN_FILES } from "../scan-config-Dx49nCqk.mjs";
 export { MAX_SCAN_FILES, SCAN_EXTENSIONS, SCAN_IGNORE_DIRS, autoDetectSourceDirs, classifyFile, discoverFiles };

package/dist/core/scanner.mjs

@@ -1,5 +1,5 @@
 import "../fs-DLbVB-Ek.mjs";
-import "../scan-config-BlNLRCMx.mjs";
-import { n as scanSummary, t as scanCandidates } from "../scanner-CGWhmpDz.mjs";
-import "../tsx-parser-md1N0Niu.mjs";
+import "../scan-config-Dx49nCqk.mjs";
+import { n as scanSummary, t as scanCandidates } from "../scanner-BSvXjfkp.mjs";
+import "../tsx-parser-BvsK6lyG.mjs";
 export { scanCandidates, scanSummary };

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

@@ -1,4 +1,4 @@
-import { _ as RepoReader } from "../../index-w8QHThNS.mjs";
+import { _ as RepoReader } from "../../index-BWbTJlXm.mjs";
 import { EntryMeta, FieldDef, ModelDefinition, ValidationError, ValidationResult } from "@contentrain/types";
 
 //#region src/core/validator/entry.d.ts

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

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

package/dist/core/validator/index.mjs

@@ -1,6 +1,6 @@
 import "../../fs-DLbVB-Ek.mjs";
-import "../../meta-manager-CJUiTgP2.mjs";
-import "../../config-oxxgznz7.mjs";
-import "../../model-manager-DP2CZiMT.mjs";
-import { i as validateContent, n as validateScheduleFields, r as checkRelationIntegrity, t as validateProject } from "../../validator-ChiYk6ap.mjs";
+import "../../meta-manager-B_Se183X.mjs";
+import "../../config-VlRKRwAS.mjs";
+import "../../model-manager-DgyKMjLN.mjs";
+import { i as validateContent, n as validateScheduleFields, r as checkRelationIntegrity, t as validateProject } from "../../validator-0sJ9vh1j.mjs";
 export { checkRelationIntegrity, validateContent, validateProject, validateScheduleFields };

package/dist/{detect-CdDU4Ew_.mjs → detect-B0oXbQaP.mjs}

@@ -452,4 +452,4 @@ async function collectAllDeps(projectRoot) {
 //#endregion
 export { detectStackInfo as n, inferPlatform as r, detectStack as t };
 
-//# sourceMappingURL=detect-CdDU4Ew_.mjs.map
+//# sourceMappingURL=detect-B0oXbQaP.mjs.map