@contentrain/mcp 1.3.0 → 1.4.0

package/dist/server.mjs

@@ -12,7 +12,7 @@ import "./local-DvP4Y4T-.mjs";
 import "./detect-DL9mFmaS.mjs";
 import "./branch-lifecycle-CFVpTpNT.mjs";
 import "./annotations-Clhbw2lh.mjs";
-import { t as createServer } from "./server-B1OJrUQ9.mjs";
+import { t as createServer } from "./server-BkhhtEE2.mjs";
 import "./validator-B0nNRFeU.mjs";
 import "./scan-config-jC6XmiqF.mjs";
 import "./graph-builder-DXv2JEp-.mjs";

package/dist/testing/conformance.d.mts

@@ -0,0 +1,59 @@
+//#region src/testing/conformance.d.ts
+/**
+ * Conformance fixture loader — published as `@contentrain/mcp/testing/conformance`
+ * so external tools (Studio, third-party reimplementations, alt-provider
+ * test harnesses) can assert byte-identical output against the same
+ * scenarios `@contentrain/mcp` tests itself against.
+ *
+ * Each scenario directory under `testing/conformance/` is:
+ *
+ *   scenario.json   — { id, description, operation, input, context_tool? }
+ *   setup/          — files seeded into a temp projectRoot before the op
+ *   expected/       — byte-identical file tree after the op runs
+ *
+ * Consumers use the `fixturesDir` export to locate the root and the
+ * helpers below to iterate scenarios without hardcoding directory names.
+ *
+ * The fixtures are published as-is — no transformation, no compilation.
+ * They ship next to the package so consumers can read them with
+ * `node:fs` without additional dependencies.
+ */
+interface ConformanceScenario {
+  /** Stable scenario id — e.g. `01-new-collection-entry`. */
+  id: string;
+  /** Short human-readable description pulled from `scenario.json`. */
+  description: string;
+  /** The write operation under test — `save_content`, `save_model`, `delete_content`, …. */
+  operation: string;
+  /** Tool input object — passed into the operation at runtime. */
+  input: Record<string, unknown>;
+  /** Optional MCP tool name recorded in the resulting `context.json`. */
+  context_tool?: string;
+  /** Absolute path to this scenario's directory on disk. */
+  dir: string;
+  /** Absolute path to this scenario's `setup/` tree. */
+  setupDir: string;
+  /** Absolute path to this scenario's `expected/` tree. */
+  expectedDir: string;
+}
+/**
+ * Resolve the conformance fixtures root. When called from the built
+ * package (`dist/testing/conformance.mjs`), the fixtures live at
+ * `../../testing/conformance`. When called from source tests
+ * (`src/testing/conformance.ts`), they live at
+ * `../../testing/conformance` as well — the layout is identical.
+ */
+declare const fixturesDir: string;
+/**
+ * List every scenario directory under `fixturesDir`. Returns an array
+ * sorted by `id` for deterministic iteration.
+ */
+declare function listConformanceScenarios(): ConformanceScenario[];
+/**
+ * Load a single scenario by id. Throws with a helpful message when the
+ * id does not resolve to a published fixture.
+ */
+declare function loadConformanceScenario(id: string): ConformanceScenario;
+//#endregion
+export { ConformanceScenario, fixturesDir, listConformanceScenarios, loadConformanceScenario };
+//# sourceMappingURL=conformance.d.mts.map

package/dist/testing/conformance.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.mts","names":[],"sources":["../../src/testing/conformance.ts"],"mappings":";;AAwBA;;;;;;;;;;;;;;;AA4BA;;;UA5BiB,mBAAA;EA4B2E;EA1B1F,EAAA;EAgCsC;EA9BtC,WAAA;EA8B0C;EA5B1C,SAAA;EAqDc;EAnDd,KAAA,EAAO,MAAA;;EAEP,YAAA;EAiDsE;EA/CtE,GAAA;;EAEA,QAAA;;EAEA,WAAA;AAAA;;;;;;;;cAYW,WAAA;;;;;iBAMG,wBAAA,CAAA,GAA4B,mBAAA;;;;;iBAyB5B,uBAAA,CAAwB,EAAA,WAAa,mBAAA"}

package/dist/testing/conformance.mjs

@@ -0,0 +1,59 @@
+import { dirname, join, resolve } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/**
+* Resolve the conformance fixtures root. When called from the built
+* package (`dist/testing/conformance.mjs`), the fixtures live at
+* `../../testing/conformance`. When called from source tests
+* (`src/testing/conformance.ts`), they live at
+* `../../testing/conformance` as well — the layout is identical.
+*/
+const fixturesDir = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "testing", "conformance");
+/**
+* List every scenario directory under `fixturesDir`. Returns an array
+* sorted by `id` for deterministic iteration.
+*/
+function listConformanceScenarios() {
+	if (!existsSync(fixturesDir)) throw new Error(`Conformance fixtures not found at ${fixturesDir}. Is @contentrain/mcp/testing/conformance installed as a dev dependency?`);
+	const entries = readdirSync(fixturesDir, { withFileTypes: true });
+	const scenarios = [];
+	for (const entry of entries) {
+		if (!entry.isDirectory()) continue;
+		if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
+		const dir = join(fixturesDir, entry.name);
+		const scenarioPath = join(dir, "scenario.json");
+		if (!existsSync(scenarioPath)) continue;
+		scenarios.push({
+			id: entry.name,
+			...loadScenarioFile(scenarioPath),
+			dir,
+			setupDir: join(dir, "setup"),
+			expectedDir: join(dir, "expected")
+		});
+	}
+	return scenarios.toSorted((a, b) => a.id.localeCompare(b.id));
+}
+/**
+* Load a single scenario by id. Throws with a helpful message when the
+* id does not resolve to a published fixture.
+*/
+function loadConformanceScenario(id) {
+	const all = listConformanceScenarios();
+	const match = all.find((s) => s.id === id);
+	if (!match) throw new Error(`Unknown conformance scenario "${id}". Known ids: ${all.map((s) => s.id).join(", ")}`);
+	return match;
+}
+function loadScenarioFile(path) {
+	const raw = readFileSync(path, "utf-8");
+	const parsed = JSON.parse(raw);
+	return {
+		description: parsed.description,
+		operation: parsed.operation,
+		input: parsed.input,
+		...parsed.context_tool ? { context_tool: parsed.context_tool } : {}
+	};
+}
+//#endregion
+export { fixturesDir, listConformanceScenarios, loadConformanceScenario };
+
+//# sourceMappingURL=conformance.mjs.map

package/dist/testing/conformance.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.mjs","names":[],"sources":["../../src/testing/conformance.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/**\n * Conformance fixture loader — published as `@contentrain/mcp/testing/conformance`\n * so external tools (Studio, third-party reimplementations, alt-provider\n * test harnesses) can assert byte-identical output against the same\n * scenarios `@contentrain/mcp` tests itself against.\n *\n * Each scenario directory under `testing/conformance/` is:\n *\n *   scenario.json   — { id, description, operation, input, context_tool? }\n *   setup/          — files seeded into a temp projectRoot before the op\n *   expected/       — byte-identical file tree after the op runs\n *\n * Consumers use the `fixturesDir` export to locate the root and the\n * helpers below to iterate scenarios without hardcoding directory names.\n *\n * The fixtures are published as-is — no transformation, no compilation.\n * They ship next to the package so consumers can read them with\n * `node:fs` without additional dependencies.\n */\n\nexport interface ConformanceScenario {\n  /** Stable scenario id — e.g. `01-new-collection-entry`. */\n  id: string\n  /** Short human-readable description pulled from `scenario.json`. */\n  description: string\n  /** The write operation under test — `save_content`, `save_model`, `delete_content`, …. */\n  operation: string\n  /** Tool input object — passed into the operation at runtime. */\n  input: Record<string, unknown>\n  /** Optional MCP tool name recorded in the resulting `context.json`. */\n  context_tool?: string\n  /** Absolute path to this scenario's directory on disk. */\n  dir: string\n  /** Absolute path to this scenario's `setup/` tree. */\n  setupDir: string\n  /** Absolute path to this scenario's `expected/` tree. */\n  expectedDir: string\n}\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url))\n\n/**\n * Resolve the conformance fixtures root. When called from the built\n * package (`dist/testing/conformance.mjs`), the fixtures live at\n * `../../testing/conformance`. When called from source tests\n * (`src/testing/conformance.ts`), they live at\n * `../../testing/conformance` as well — the layout is identical.\n */\nexport const fixturesDir: string = resolve(MODULE_DIR, '..', '..', 'testing', 'conformance')\n\n/**\n * List every scenario directory under `fixturesDir`. Returns an array\n * sorted by `id` for deterministic iteration.\n */\nexport function listConformanceScenarios(): ConformanceScenario[] {\n  if (!existsSync(fixturesDir)) {\n    throw new Error(\n      `Conformance fixtures not found at ${fixturesDir}. `\n      + 'Is @contentrain/mcp/testing/conformance installed as a dev dependency?',\n    )\n  }\n\n  const entries = readdirSync(fixturesDir, { withFileTypes: true })\n  const scenarios: ConformanceScenario[] = []\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue\n    if (entry.name.startsWith('_') || entry.name.startsWith('.')) continue\n    const dir = join(fixturesDir, entry.name)\n    const scenarioPath = join(dir, 'scenario.json')\n    if (!existsSync(scenarioPath)) continue\n    scenarios.push({ id: entry.name, ...loadScenarioFile(scenarioPath), dir, setupDir: join(dir, 'setup'), expectedDir: join(dir, 'expected') })\n  }\n  return scenarios.toSorted((a, b) => a.id.localeCompare(b.id))\n}\n\n/**\n * Load a single scenario by id. Throws with a helpful message when the\n * id does not resolve to a published fixture.\n */\nexport function loadConformanceScenario(id: string): ConformanceScenario {\n  const all = listConformanceScenarios()\n  const match = all.find(s => s.id === id)\n  if (!match) {\n    throw new Error(`Unknown conformance scenario \"${id}\". Known ids: ${all.map(s => s.id).join(', ')}`)\n  }\n  return match\n}\n\nfunction loadScenarioFile(path: string): Omit<ConformanceScenario, 'id' | 'dir' | 'setupDir' | 'expectedDir'> {\n  const raw = readFileSync(path, 'utf-8')\n  const parsed = JSON.parse(raw) as {\n    description: string\n    operation: string\n    input: Record<string, unknown>\n    context_tool?: string\n  }\n  return {\n    description: parsed.description,\n    operation: parsed.operation,\n    input: parsed.input,\n    ...(parsed.context_tool ? { context_tool: parsed.context_tool } : {}),\n  }\n}\n"],"mappings":";;;;;;;;;;AAoDA,MAAa,cAAsB,QAThB,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EASH,MAAM,MAAM,WAAW,cAAc;;;;;AAM5F,SAAgB,2BAAkD;AAChE,KAAI,CAAC,WAAW,YAAY,CAC1B,OAAM,IAAI,MACR,qCAAqC,YAAY,0EAElD;CAGH,MAAM,UAAU,YAAY,aAAa,EAAE,eAAe,MAAM,CAAC;CACjE,MAAM,YAAmC,EAAE;AAC3C,MAAK,MAAM,SAAS,SAAS;AAC3B,MAAI,CAAC,MAAM,aAAa,CAAE;AAC1B,MAAI,MAAM,KAAK,WAAW,IAAI,IAAI,MAAM,KAAK,WAAW,IAAI,CAAE;EAC9D,MAAM,MAAM,KAAK,aAAa,MAAM,KAAK;EACzC,MAAM,eAAe,KAAK,KAAK,gBAAgB;AAC/C,MAAI,CAAC,WAAW,aAAa,CAAE;AAC/B,YAAU,KAAK;GAAE,IAAI,MAAM;GAAM,GAAG,iBAAiB,aAAa;GAAE;GAAK,UAAU,KAAK,KAAK,QAAQ;GAAE,aAAa,KAAK,KAAK,WAAW;GAAE,CAAC;;AAE9I,QAAO,UAAU,UAAU,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,CAAC;;;;;;AAO/D,SAAgB,wBAAwB,IAAiC;CACvE,MAAM,MAAM,0BAA0B;CACtC,MAAM,QAAQ,IAAI,MAAK,MAAK,EAAE,OAAO,GAAG;AACxC,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,iCAAiC,GAAG,gBAAgB,IAAI,KAAI,MAAK,EAAE,GAAG,CAAC,KAAK,KAAK,GAAG;AAEtG,QAAO;;AAGT,SAAS,iBAAiB,MAAoF;CAC5G,MAAM,MAAM,aAAa,MAAM,QAAQ;CACvC,MAAM,SAAS,KAAK,MAAM,IAAI;AAM9B,QAAO;EACL,aAAa,OAAO;EACpB,WAAW,OAAO;EAClB,OAAO,OAAO;EACd,GAAI,OAAO,eAAe,EAAE,cAAc,OAAO,cAAc,GAAG,EAAE;EACrE"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@contentrain/mcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "mcpName": "io.github.Contentrain/contentrain",
   "license": "MIT",
-  "description": "Local-first MCP server for AI-generated content governance — 13 deterministic tools for any platform",
+  "description": "Local-first MCP server for AI-generated content governance — 17 deterministic tools, stdio + HTTP transports, Local / GitHub / GitLab providers",
   "type": "module",
   "repository": {
     "type": "git",
@@ -120,6 +120,10 @@
       "types": "./dist/tools/annotations.d.mts",
       "import": "./dist/tools/annotations.mjs"
     },
+    "./testing/conformance": {
+      "types": "./dist/testing/conformance.d.mts",
+      "import": "./dist/testing/conformance.mjs"
+    },
     "./templates": {
       "types": "./dist/templates/index.d.mts",
       "import": "./dist/templates/index.mjs"
@@ -140,7 +144,8 @@
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [
-    "dist"
+    "dist",
+    "testing"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
@@ -177,8 +182,8 @@
     "vitest": "^3.0.0"
   },
   "scripts": {
-    "build": "tsdown src/index.ts src/server.ts src/core/config.ts src/core/context.ts src/core/model-manager.ts src/core/content-manager.ts src/core/meta-manager.ts src/core/validator/index.ts src/core/scanner.ts src/core/scan-config.ts src/core/doctor.ts src/core/graph-builder.ts src/core/apply-manager.ts src/util/detect.ts src/util/fs.ts src/util/id.ts src/git/transaction.ts src/git/branch-lifecycle.ts src/tools/annotations.ts src/templates/index.ts src/core/contracts/index.ts src/core/ops/index.ts src/core/overlay-reader.ts src/providers/local/index.ts src/providers/github/index.ts src/providers/gitlab/index.ts src/server/http/index.ts --format esm --dts --external typescript",
-    "dev": "tsdown src/index.ts src/server.ts src/core/config.ts src/core/context.ts src/core/model-manager.ts src/core/content-manager.ts src/core/meta-manager.ts src/core/validator/index.ts src/core/scanner.ts src/core/scan-config.ts src/core/doctor.ts src/core/graph-builder.ts src/core/apply-manager.ts src/util/detect.ts src/util/fs.ts src/util/id.ts src/git/transaction.ts src/git/branch-lifecycle.ts src/tools/annotations.ts src/templates/index.ts src/core/contracts/index.ts src/core/ops/index.ts src/core/overlay-reader.ts src/providers/local/index.ts src/providers/github/index.ts src/providers/gitlab/index.ts src/server/http/index.ts --format esm --dts --external typescript --watch",
+    "build": "tsdown src/index.ts src/server.ts src/core/config.ts src/core/context.ts src/core/model-manager.ts src/core/content-manager.ts src/core/meta-manager.ts src/core/validator/index.ts src/core/scanner.ts src/core/scan-config.ts src/core/doctor.ts src/core/graph-builder.ts src/core/apply-manager.ts src/util/detect.ts src/util/fs.ts src/util/id.ts src/git/transaction.ts src/git/branch-lifecycle.ts src/tools/annotations.ts src/testing/conformance.ts src/templates/index.ts src/core/contracts/index.ts src/core/ops/index.ts src/core/overlay-reader.ts src/providers/local/index.ts src/providers/github/index.ts src/providers/gitlab/index.ts src/server/http/index.ts --format esm --dts --external typescript",
+    "dev": "tsdown src/index.ts src/server.ts src/core/config.ts src/core/context.ts src/core/model-manager.ts src/core/content-manager.ts src/core/meta-manager.ts src/core/validator/index.ts src/core/scanner.ts src/core/scan-config.ts src/core/doctor.ts src/core/graph-builder.ts src/core/apply-manager.ts src/util/detect.ts src/util/fs.ts src/util/id.ts src/git/transaction.ts src/git/branch-lifecycle.ts src/tools/annotations.ts src/testing/conformance.ts src/templates/index.ts src/core/contracts/index.ts src/core/ops/index.ts src/core/overlay-reader.ts src/providers/local/index.ts src/providers/github/index.ts src/providers/gitlab/index.ts src/server/http/index.ts --format esm --dts --external typescript --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"

package/testing/conformance/01-new-collection-entry/expected/.contentrain/config.json

@@ -0,0 +1,15 @@
+{
+  "domains": [
+    "blog"
+  ],
+  "locales": {
+    "default": "en",
+    "supported": [
+      "en",
+      "tr"
+    ]
+  },
+  "stack": "vue-nuxt",
+  "version": 1,
+  "workflow": "auto-merge"
+}

package/testing/conformance/01-new-collection-entry/expected/.contentrain/content/blog/blog/en.json

@@ -0,0 +1,6 @@
+{
+  "abc123def456": {
+    "body": "First post content",
+    "title": "Hello World"
+  }
+}

package/testing/conformance/01-new-collection-entry/expected/.contentrain/context.json

@@ -0,0 +1,22 @@
+{
+  "lastOperation": {
+    "entries": [
+      "abc123def456"
+    ],
+    "locale": "en",
+    "model": "blog",
+    "source": "mcp-local",
+    "timestamp": "2026-01-01T00:00:00.000Z",
+    "tool": "contentrain_content_save"
+  },
+  "stats": {
+    "entries": 1,
+    "lastSync": "2026-01-01T00:00:00.000Z",
+    "locales": [
+      "en",
+      "tr"
+    ],
+    "models": 1
+  },
+  "version": "1"
+}

package/testing/conformance/01-new-collection-entry/expected/.contentrain/meta/blog/en.json

@@ -0,0 +1,7 @@
+{
+  "abc123def456": {
+    "source": "agent",
+    "status": "draft",
+    "updated_by": "contentrain-mcp"
+  }
+}

package/testing/conformance/01-new-collection-entry/expected/.contentrain/models/blog.json

@@ -0,0 +1,16 @@
+{
+  "domain": "blog",
+  "fields": {
+    "body": {
+      "type": "text"
+    },
+    "title": {
+      "required": true,
+      "type": "string"
+    }
+  },
+  "i18n": true,
+  "id": "blog",
+  "kind": "collection",
+  "name": "Blog"
+}

package/testing/conformance/01-new-collection-entry/scenario.json

@@ -0,0 +1,19 @@
+{
+  "context_tool": "contentrain_content_save",
+  "description": "Save a new collection entry for a model",
+  "id": "01-new-collection-entry",
+  "input": {
+    "entries": [
+      {
+        "data": {
+          "body": "First post content",
+          "title": "Hello World"
+        },
+        "id": "abc123def456",
+        "locale": "en"
+      }
+    ],
+    "model": "blog"
+  },
+  "operation": "save_content"
+}

package/testing/conformance/01-new-collection-entry/setup/.contentrain/config.json

@@ -0,0 +1,15 @@
+{
+  "domains": [
+    "blog"
+  ],
+  "locales": {
+    "default": "en",
+    "supported": [
+      "en",
+      "tr"
+    ]
+  },
+  "stack": "vue-nuxt",
+  "version": 1,
+  "workflow": "auto-merge"
+}

package/testing/conformance/01-new-collection-entry/setup/.contentrain/models/blog.json

@@ -0,0 +1,16 @@
+{
+  "domain": "blog",
+  "fields": {
+    "body": {
+      "type": "text"
+    },
+    "title": {
+      "required": true,
+      "type": "string"
+    }
+  },
+  "i18n": true,
+  "id": "blog",
+  "kind": "collection",
+  "name": "Blog"
+}

package/testing/conformance/02-new-singleton/expected/.contentrain/config.json

@@ -0,0 +1,15 @@
+{
+  "domains": [
+    "marketing"
+  ],
+  "locales": {
+    "default": "en",
+    "supported": [
+      "en",
+      "tr"
+    ]
+  },
+  "stack": "vue-nuxt",
+  "version": 1,
+  "workflow": "auto-merge"
+}

package/testing/conformance/02-new-singleton/expected/.contentrain/content/marketing/hero/en.json

@@ -0,0 +1,4 @@
+{
+  "subtitle": "Build the web with AI agents",
+  "title": "Welcome to Contentrain"
+}

package/testing/conformance/02-new-singleton/expected/.contentrain/context.json

@@ -0,0 +1,22 @@
+{
+  "lastOperation": {
+    "entries": [
+      "en"
+    ],
+    "locale": "en",
+    "model": "hero",
+    "source": "mcp-local",
+    "timestamp": "2026-01-01T00:00:00.000Z",
+    "tool": "contentrain_content_save"
+  },
+  "stats": {
+    "entries": 1,
+    "lastSync": "2026-01-01T00:00:00.000Z",
+    "locales": [
+      "en",
+      "tr"
+    ],
+    "models": 1
+  },
+  "version": "1"
+}

package/testing/conformance/02-new-singleton/expected/.contentrain/meta/hero/en.json

@@ -0,0 +1,5 @@
+{
+  "source": "agent",
+  "status": "draft",
+  "updated_by": "contentrain-mcp"
+}

package/testing/conformance/02-new-singleton/expected/.contentrain/models/hero.json

@@ -0,0 +1,16 @@
+{
+  "domain": "marketing",
+  "fields": {
+    "subtitle": {
+      "type": "text"
+    },
+    "title": {
+      "required": true,
+      "type": "string"
+    }
+  },
+  "i18n": true,
+  "id": "hero",
+  "kind": "singleton",
+  "name": "Hero"
+}

package/testing/conformance/02-new-singleton/scenario.json

@@ -0,0 +1,18 @@
+{
+  "context_tool": "contentrain_content_save",
+  "description": "Save a new singleton content block",
+  "id": "02-new-singleton",
+  "input": {
+    "entries": [
+      {
+        "data": {
+          "subtitle": "Build the web with AI agents",
+          "title": "Welcome to Contentrain"
+        },
+        "locale": "en"
+      }
+    ],
+    "model": "hero"
+  },
+  "operation": "save_content"
+}

package/testing/conformance/02-new-singleton/setup/.contentrain/config.json

@@ -0,0 +1,15 @@
+{
+  "domains": [
+    "marketing"
+  ],
+  "locales": {
+    "default": "en",
+    "supported": [
+      "en",
+      "tr"
+    ]
+  },
+  "stack": "vue-nuxt",
+  "version": 1,
+  "workflow": "auto-merge"
+}

package/testing/conformance/02-new-singleton/setup/.contentrain/models/hero.json

@@ -0,0 +1,16 @@
+{
+  "domain": "marketing",
+  "fields": {
+    "subtitle": {
+      "type": "text"
+    },
+    "title": {
+      "required": true,
+      "type": "string"
+    }
+  },
+  "i18n": true,
+  "id": "hero",
+  "kind": "singleton",
+  "name": "Hero"
+}

package/testing/conformance/03-new-dictionary/expected/.contentrain/config.json

@@ -0,0 +1,15 @@
+{
+  "domains": [
+    "marketing"
+  ],
+  "locales": {
+    "default": "en",
+    "supported": [
+      "en",
+      "tr"
+    ]
+  },
+  "stack": "vue-nuxt",
+  "version": 1,
+  "workflow": "auto-merge"
+}

package/testing/conformance/03-new-dictionary/expected/.contentrain/content/marketing/ui-strings/en.json

@@ -0,0 +1,5 @@
+{
+  "hero.cta": "Get started",
+  "hero.subtitle": "Build the web with AI agents",
+  "hero.title": "Welcome to Contentrain"
+}

package/testing/conformance/03-new-dictionary/expected/.contentrain/context.json

@@ -0,0 +1,22 @@
+{
+  "lastOperation": {
+    "entries": [
+      "en"
+    ],
+    "locale": "en",
+    "model": "ui-strings",
+    "source": "mcp-local",
+    "timestamp": "2026-01-01T00:00:00.000Z",
+    "tool": "contentrain_content_save"
+  },
+  "stats": {
+    "entries": 1,
+    "lastSync": "2026-01-01T00:00:00.000Z",
+    "locales": [
+      "en",
+      "tr"
+    ],
+    "models": 1
+  },
+  "version": "1"
+}

package/testing/conformance/03-new-dictionary/expected/.contentrain/meta/ui-strings/en.json

@@ -0,0 +1,5 @@
+{
+  "source": "agent",
+  "status": "draft",
+  "updated_by": "contentrain-mcp"
+}

package/testing/conformance/03-new-dictionary/expected/.contentrain/models/ui-strings.json

@@ -0,0 +1,7 @@
+{
+  "domain": "marketing",
+  "i18n": true,
+  "id": "ui-strings",
+  "kind": "dictionary",
+  "name": "UI Strings"
+}

package/testing/conformance/03-new-dictionary/scenario.json

@@ -0,0 +1,19 @@
+{
+  "context_tool": "contentrain_content_save",
+  "description": "Create a dictionary with multiple string keys",
+  "id": "03-new-dictionary",
+  "input": {
+    "entries": [
+      {
+        "data": {
+          "hero.cta": "Get started",
+          "hero.subtitle": "Build the web with AI agents",
+          "hero.title": "Welcome to Contentrain"
+        },
+        "locale": "en"
+      }
+    ],
+    "model": "ui-strings"
+  },
+  "operation": "save_content"
+}

package/testing/conformance/03-new-dictionary/setup/.contentrain/config.json

@@ -0,0 +1,15 @@
+{
+  "domains": [
+    "marketing"
+  ],
+  "locales": {
+    "default": "en",
+    "supported": [
+      "en",
+      "tr"
+    ]
+  },
+  "stack": "vue-nuxt",
+  "version": 1,
+  "workflow": "auto-merge"
+}

package/testing/conformance/03-new-dictionary/setup/.contentrain/models/ui-strings.json

@@ -0,0 +1,7 @@
+{
+  "domain": "marketing",
+  "i18n": true,
+  "id": "ui-strings",
+  "kind": "dictionary",
+  "name": "UI Strings"
+}

package/testing/conformance/README.md

@@ -0,0 +1,77 @@
+# Conformance Fixtures
+
+Byte-identical conformance test suite for content operations. Each fixture describes an operation and its expected on-disk file tree after execution. Used by `packages/mcp/tests/conformance.test.ts`.
+
+**Purpose** — guarantee byte-level parity between providers (LocalProvider today; GitHubProvider + GitLabProvider in later phases) for the same operation. Any silent drift in serialization, meta generation, context.json, or path resolution shows up as a failed fixture.
+
+## Directory layout
+
+```
+conformance/
+├── README.md             — this file
+├── scenarios.json        — human-readable index
+├── 01-new-collection-entry/
+│   ├── scenario.json     — input spec
+│   ├── setup/            — files copied into temp projectRoot before op runs (optional)
+│   └── expected/         — byte-identical file tree after op (GENERATED, committed)
+├── 02-new-singleton/
+│   └── ...
+└── 03-new-dictionary/
+    └── ...
+```
+
+## Scenario schema
+
+```jsonc
+{
+  "id": "01-new-collection-entry",
+  "description": "Save a new collection entry",
+  "operation": "save_content",     // save_content | save_model | delete_content
+  "context_tool": "contentrain_content_save",  // tool name recorded in context.json (optional)
+  "input": {                         // operation-specific params
+    "model": "blog",
+    "entries": [
+      { "id": "...", "locale": "en", "data": { ... } }
+    ]
+  }
+}
+```
+
+## Determinism rules
+
+The harness fixes non-deterministic sources so output is reproducible:
+
+- `Date.now()` / `new Date()` returns `2026-01-01T00:00:00.000Z` (vitest fake timers)
+- `CONTENTRAIN_SOURCE=mcp-local` env var is set
+- `Math.random()` is NOT stubbed globally — scenarios that need determinism must pass explicit entry IDs instead of relying on `generateEntryId()`
+- Git is not initialized — core write functions don't require it
+
+## Regenerating `expected/`
+
+When an intentional behavior change lands (e.g., schema bump, new default field), regenerate the expected fixtures and review the diff:
+
+```bash
+GENERATE_FIXTURES=1 pnpm --filter @contentrain/mcp test -- conformance
+```
+
+Then `git diff` the `expected/` directories. Each byte difference must be a conscious decision.
+
+## Adding a new fixture
+
+1. `mkdir NN-short-name/setup/.contentrain`
+2. Write `scenario.json` at the fixture root
+3. Optionally add setup files under `setup/`
+4. `GENERATE_FIXTURES=1 pnpm --filter @contentrain/mcp test -- conformance` to populate `expected/`
+5. Review generated `expected/` files manually — they become the contract
+6. Commit both `setup/` and `expected/`
+
+## Provider matrix (future)
+
+Today the harness runs scenarios against the current MCP write path (direct fs + `writeContent` + `writeContext`). Post-refactor phases will add:
+
+- Phase 2 — run through plan/apply API, assert `FileChange[]` → same `expected/`
+- Phase 3 — LocalProvider.applyPlan → same `expected/`
+- Phase 5 — GitHubProvider.applyPlan (mocked) → same `expected/`
+- Phase 8 — GitLab/Bitbucket providers → same `expected/`
+
+The fixtures themselves never change between providers. Only the runner wiring does.