contentrain 0.4.1 → 0.4.2

package/dist/{activity-DMQsYlzz.mjs → activity-CbkxcfDf.mjs}

@@ -1,6 +1,6 @@
 import { i as pc } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { intro, log, outro, spinner } from "@clack/prompts";
 //#region src/studio/commands/activity.ts

package/dist/{branches-D330IxDO.mjs → branches-D2UWex1N.mjs}

@@ -1,6 +1,6 @@
 import { i as pc, r as formatTable, t as formatCount } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
 //#region src/studio/commands/branches.ts

package/dist/{cdn-build-D_d3p4OZ.mjs → cdn-build-BzC2QPNi.mjs}

@@ -1,6 +1,6 @@
 import { i as pc, t as formatCount } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { intro, log, outro, spinner } from "@clack/prompts";
 //#region src/studio/commands/cdn-build.ts

package/dist/{cdn-init-Bhnil0F8.mjs → cdn-init-CsmqJIaQ.mjs}

@@ -1,6 +1,6 @@
 import { i as pc } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, outro, spinner } from "@clack/prompts";
 //#region src/studio/commands/cdn-init.ts

package/dist/{connect-DiSYnxFd.mjs → connect-DJo9PSiw.mjs}

@@ -1,6 +1,6 @@
 import { i as pc } from "./ui-B5mXontH.mjs";
-import { c as saveDefaults, n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { n as openBrowser, t as startOAuthServer } from "./oauth-server-1p6y1H30.mjs";
+import { c as saveDefaults, n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { n as openBrowser, t as startOAuthServer } from "./oauth-server-Beppljfz.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, outro, select, spinner, text } from "@clack/prompts";
 import { simpleGit } from "simple-git";

package/dist/demo-DcBt6fw8.mjs

@@ -0,0 +1,80 @@
+import { simpleGit } from "simple-git";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { writeModel } from "@contentrain/mcp/core/model-manager";
+import { ensureDir, writeJson } from "@contentrain/mcp/util/fs";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { getTemplate } from "@contentrain/mcp/templates";
+//#region src/utils/demo.ts
+/**
+* Creates a temporary demo project with a blog template.
+* Returns the project root path.
+*/
+async function createDemoProject() {
+	const dir = await mkdtemp(join(tmpdir(), "contentrain-demo-"));
+	const git = simpleGit(dir);
+	await git.init();
+	await git.addConfig("user.email", "demo@contentrain.io");
+	await git.addConfig("user.name", "Contentrain Demo");
+	const crDir = join(dir, ".contentrain");
+	await Promise.all([
+		"models",
+		"content",
+		"meta"
+	].map(async (sub) => {
+		await ensureDir(join(crDir, sub));
+		await writeFile(join(crDir, sub, ".gitkeep"), "", "utf-8");
+	}));
+	await writeJson(join(crDir, "config.json"), {
+		version: 1,
+		stack: "other",
+		workflow: "auto-merge",
+		locales: {
+			default: "en",
+			supported: ["en"]
+		},
+		domains: [
+			"marketing",
+			"blog",
+			"system"
+		]
+	});
+	await writeJson(join(crDir, "vocabulary.json"), {
+		version: 1,
+		terms: {}
+	});
+	await writeJson(join(crDir, "context.json"), {
+		version: "1",
+		lastOperation: {
+			tool: "contentrain_init",
+			model: "",
+			locale: "en",
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			source: "demo"
+		},
+		stats: {
+			models: 0,
+			entries: 0,
+			locales: ["en"],
+			lastSync: (/* @__PURE__ */ new Date()).toISOString()
+		}
+	});
+	const tmpl = getTemplate("blog");
+	if (tmpl) for (const model of tmpl.models) await writeModel(dir, model);
+	await git.add(".");
+	await git.commit("[contentrain] demo project");
+	return dir;
+}
+/**
+* Clean up a demo project directory.
+*/
+async function cleanupDemoProject(dir) {
+	try {
+		await rm(dir, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
+}
+//#endregion
+export { cleanupDemoProject, createDemoProject };

package/dist/ide-Bg-Z8QZk.mjs

@@ -0,0 +1,227 @@
+import { simpleGit } from "simple-git";
+import { join } from "node:path";
+import { ensureDir, pathExists } from "@contentrain/mcp/util/fs";
+import { appendFile, readFile, writeFile } from "node:fs/promises";
+//#region src/utils/ide.ts
+const AGENT_SKILL_NAMES = [
+	"contentrain",
+	"contentrain-normalize",
+	"contentrain-quality",
+	"contentrain-sdk",
+	"contentrain-content",
+	"contentrain-model",
+	"contentrain-init",
+	"contentrain-bulk",
+	"contentrain-validate-fix",
+	"contentrain-review",
+	"contentrain-translate",
+	"contentrain-generate",
+	"contentrain-serve",
+	"contentrain-diff",
+	"contentrain-doctor"
+];
+const OLD_RULE_FILES = [
+	"contentrain-content-quality.md",
+	"contentrain-seo-rules.md",
+	"contentrain-i18n-quality.md",
+	"contentrain-accessibility-rules.md",
+	"contentrain-security-rules.md",
+	"contentrain-media-rules.md",
+	"contentrain-content-conventions.md",
+	"contentrain-schema-rules.md",
+	"contentrain-mcp-usage.md",
+	"contentrain-workflow-rules.md",
+	"contentrain-normalize-rules.md"
+];
+const IDE_CONFIGS = {
+	"claude-code": {
+		name: "Claude Code",
+		rulesDir: ".claude/rules",
+		skillsDir: ".claude/skills",
+		guardrailsFileName: "contentrain-essentials.md"
+	},
+	cursor: {
+		name: "Cursor",
+		rulesDir: ".cursor/rules",
+		skillsDir: ".cursor/skills",
+		guardrailsFileName: "contentrain-essentials.mdc",
+		guardrailsFrontmatter: "---\ndescription: Contentrain essential content governance rules\nalwaysApply: true\n---\n\n"
+	},
+	windsurf: {
+		name: "Windsurf",
+		rulesDir: ".windsurf/rules",
+		skillsDir: ".windsurf/skills",
+		guardrailsFileName: "contentrain-essentials.md",
+		guardrailsFrontmatter: "---\ndescription: Contentrain essential content governance rules\ntrigger: always_on\n---\n\n"
+	},
+	copilot: {
+		name: "GitHub Copilot",
+		rulesDir: ".github",
+		skillsDir: ".agents/skills",
+		guardrailsFileName: "copilot-instructions.md"
+	}
+};
+const MCP_CONFIGS = {
+	"claude-code": ".mcp.json",
+	cursor: ".cursor/mcp.json",
+	windsurf: ".windsurf/mcp.json",
+	vscode: ".vscode/mcp.json",
+	copilot: ".vscode/mcp.json"
+};
+const STANDARD_MCP_CONFIG = { mcpServers: { contentrain: {
+	command: "npx",
+	args: [
+		"contentrain",
+		"serve",
+		"--stdio"
+	]
+} } };
+async function detectIdes(projectRoot) {
+	const ides = [];
+	if (await pathExists(join(projectRoot, "CLAUDE.md")) || await pathExists(join(projectRoot, ".claude"))) ides.push("claude-code");
+	if (await pathExists(join(projectRoot, ".cursor"))) ides.push("cursor");
+	if (await pathExists(join(projectRoot, ".windsurf"))) ides.push("windsurf");
+	if (await pathExists(join(projectRoot, ".github"))) ides.push("copilot");
+	return ides;
+}
+async function writeMcpConfig(projectRoot, agent) {
+	const relativePath = MCP_CONFIGS[agent];
+	if (!relativePath) return {
+		written: false,
+		path: "",
+		skipped: `Unknown agent: "${agent}"`
+	};
+	const configPath = join(projectRoot, relativePath);
+	if (await pathExists(configPath)) try {
+		const existing = JSON.parse(await readFile(configPath, "utf-8"));
+		if (existing?.mcpServers?.contentrain) return {
+			written: false,
+			path: relativePath,
+			skipped: "Already configured"
+		};
+		existing.mcpServers = {
+			...existing.mcpServers,
+			...STANDARD_MCP_CONFIG.mcpServers
+		};
+		await ensureDir(join(configPath, ".."));
+		await writeFile(configPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+		return {
+			written: true,
+			path: relativePath
+		};
+	} catch {}
+	await ensureDir(join(configPath, ".."));
+	await writeFile(configPath, JSON.stringify(STANDARD_MCP_CONFIG, null, 2) + "\n", "utf-8");
+	return {
+		written: true,
+		path: relativePath
+	};
+}
+async function installIdeRulesAndSkills(projectRoot, ide, resolveRuleFile, resolveSkillFile, forceUpdate = false) {
+	let installed = 0;
+	let updated = 0;
+	const rulesDir = join(projectRoot, ide.rulesDir);
+	const git = simpleGit(projectRoot);
+	const filesToAdd = [];
+	await ensureDir(rulesDir);
+	const guardrailsDest = join(rulesDir, ide.guardrailsFileName);
+	try {
+		let content = await readFile(resolveRuleFile("essential/contentrain-essentials.md"), "utf-8");
+		if (ide.guardrailsFrontmatter) content = ide.guardrailsFrontmatter + content;
+		if (await pathExists(guardrailsDest)) {
+			if (forceUpdate) {
+				await writeFile(guardrailsDest, content, "utf-8");
+				updated++;
+			}
+		} else {
+			if (ide.name === "GitHub Copilot" && await pathExists(guardrailsDest)) {
+				if (!(await readFile(guardrailsDest, "utf-8")).includes("# Contentrain")) await appendFile(guardrailsDest, `\n\n${content}`);
+			} else await writeFile(guardrailsDest, content, "utf-8");
+			installed++;
+		}
+		filesToAdd.push(guardrailsDest);
+	} catch {}
+	for (const oldFile of OLD_RULE_FILES) {
+		const oldPath = join(rulesDir, oldFile);
+		if (await pathExists(oldPath)) {
+			const { unlink } = await import("node:fs/promises");
+			await unlink(oldPath);
+		}
+	}
+	if (resolveSkillFile) {
+		const skillsDir = join(projectRoot, ide.skillsDir);
+		await ensureDir(skillsDir);
+		for (const skillName of AGENT_SKILL_NAMES) {
+			const skillDir = join(skillsDir, skillName);
+			const skillMd = join(skillDir, "SKILL.md");
+			try {
+				const src = resolveSkillFile(`skills/${skillName}/SKILL.md`);
+				const srcContent = await readFile(src, "utf-8");
+				await ensureDir(skillDir);
+				if (await pathExists(skillMd)) {
+					if (forceUpdate) {
+						await writeFile(skillMd, srcContent, "utf-8");
+						updated++;
+					}
+				} else {
+					await writeFile(skillMd, srcContent, "utf-8");
+					installed++;
+				}
+				const { readdirSync } = await import("node:fs");
+				try {
+					const refsDir = join(src, "..", "references");
+					const refs = readdirSync(refsDir);
+					if (refs.length > 0) {
+						const destRefsDir = join(skillDir, "references");
+						await ensureDir(destRefsDir);
+						for (const ref of refs) {
+							const refDest = join(destRefsDir, ref);
+							if (forceUpdate || !await pathExists(refDest)) await writeFile(refDest, await readFile(join(refsDir, ref), "utf-8"), "utf-8");
+						}
+					}
+				} catch {}
+			} catch {}
+		}
+	}
+	if (filesToAdd.length > 0) {
+		await git.add(filesToAdd);
+		try {
+			await git.commit(`[contentrain] install ${ide.name} rules and skills`);
+		} catch {}
+	}
+	return {
+		installed,
+		updated
+	};
+}
+async function addClaudeMdReference(projectRoot) {
+	const claudeMdPath = join(projectRoot, "CLAUDE.md");
+	const marker = "# Contentrain AI Rules";
+	const reference = [
+		"# Contentrain AI Rules",
+		"",
+		"This project uses [Contentrain](https://ai.contentrain.io) for AI-driven content management.",
+		"",
+		"- **Rules** are in `.claude/rules/contentrain-essentials.md` — auto-loaded each conversation",
+		"- **Skills** are in `.claude/skills/` — loaded on demand by the agent",
+		"- **Docs:** https://ai.contentrain.io"
+	].join("\n");
+	const git = simpleGit(projectRoot);
+	if (await pathExists(claudeMdPath)) {
+		if (!(await readFile(claudeMdPath, "utf-8")).includes(marker)) {
+			await appendFile(claudeMdPath, `\n\n${reference}\n`);
+			await git.add(claudeMdPath);
+			try {
+				await git.commit("[contentrain] add CLAUDE.md reference");
+			} catch {}
+		}
+	} else {
+		await writeFile(claudeMdPath, `${reference}\n`, "utf-8");
+		await git.add(claudeMdPath);
+		try {
+			await git.commit("[contentrain] add CLAUDE.md reference");
+		} catch {}
+	}
+}
+//#endregion
+export { detectIdes as a, addClaudeMdReference as i, IDE_CONFIGS as n, installIdeRulesAndSkills as o, MCP_CONFIGS as r, writeMcpConfig as s, AGENT_SKILL_NAMES as t };

package/dist/index.mjs

@@ -5,18 +5,20 @@ import { defineCommand, runMain } from "citty";
 runMain(defineCommand({
 	meta: {
 		name: "contentrain",
-		version: "0.4.1",
+		version: "0.4.2",
 		description: "Contentrain CLI — AI content governance infrastructure"
 	},
 	subCommands: {
-		init: () => import("./init-Q9B0iYtu.mjs").then((m) => m.default),
-		status: () => import("./status-BmQZGdZX.mjs").then((m) => m.default),
+		init: () => import("./init-DFyQ-l-E.mjs").then((m) => m.default),
+		status: () => import("./status-CoHgz6HN.mjs").then((m) => m.default),
 		doctor: () => import("./doctor-DyKjAIKH.mjs").then((m) => m.default),
-		validate: () => import("./validate-DnVamp3p.mjs").then((m) => m.default),
-		serve: () => import("./serve-DL4LhWxl.mjs").then((m) => m.default),
+		validate: () => import("./validate-B10L7RL7.mjs").then((m) => m.default),
+		serve: () => import("./serve-CNeFIQ1i.mjs").then((m) => m.default),
 		generate: () => import("./generate-DrUojrk8.mjs").then((m) => m.default),
 		diff: () => import("./diff--halNUpG.mjs").then((m) => m.default),
-		studio: () => import("./studio-B8lF0fQx.mjs").then((m) => m.default)
+		setup: () => import("./setup-DJy-jNEU.mjs").then((m) => m.default),
+		skills: () => import("./skills-D-tFY7WA.mjs").then((m) => m.default),
+		studio: () => import("./studio-CJUGiIMd.mjs").then((m) => m.default)
 	}
 }));
 //#endregion

package/dist/{init-Q9B0iYtu.mjs → init-DFyQ-l-E.mjs}

@@ -1,5 +1,6 @@
 import { r as resolveProjectRoot, t as loadProjectContext } from "./context-An3xrvcP.mjs";
 import { i as pc } from "./ui-B5mXontH.mjs";
+import { a as detectIdes, i as addClaudeMdReference, n as IDE_CONFIGS, o as installIdeRulesAndSkills, s as writeMcpConfig } from "./ide-Bg-Z8QZk.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, multiselect, outro, select, spinner } from "@clack/prompts";
 import { simpleGit } from "simple-git";
@@ -346,6 +347,7 @@ async function executeInit(projectRoot, opts) {
 		await tx.complete();
 		s.stop("Initialized");
 		await installRules(projectRoot);
+		await configureMcp(projectRoot);
 	} catch (error) {
 		s.stop("Failed");
 		throw error;
@@ -353,64 +355,6 @@ async function executeInit(projectRoot, opts) {
 		await tx.cleanup();
 	}
 }
-const AGENT_SKILL_NAMES = [
-	"contentrain",
-	"contentrain-normalize",
-	"contentrain-quality",
-	"contentrain-sdk",
-	"contentrain-content",
-	"contentrain-model",
-	"contentrain-init",
-	"contentrain-bulk",
-	"contentrain-validate-fix",
-	"contentrain-review",
-	"contentrain-translate",
-	"contentrain-generate",
-	"contentrain-serve",
-	"contentrain-diff",
-	"contentrain-doctor"
-];
-const OLD_RULE_FILES = [
-	"contentrain-content-quality.md",
-	"contentrain-seo-rules.md",
-	"contentrain-i18n-quality.md",
-	"contentrain-accessibility-rules.md",
-	"contentrain-security-rules.md",
-	"contentrain-media-rules.md",
-	"contentrain-content-conventions.md",
-	"contentrain-schema-rules.md",
-	"contentrain-mcp-usage.md",
-	"contentrain-workflow-rules.md",
-	"contentrain-normalize-rules.md"
-];
-const IDE_CONFIGS = {
-	"claude-code": {
-		name: "Claude Code",
-		rulesDir: ".claude/rules",
-		skillsDir: ".claude/skills",
-		guardrailsFileName: "contentrain-essentials.md"
-	},
-	cursor: {
-		name: "Cursor",
-		rulesDir: ".cursor/rules",
-		skillsDir: ".cursor/skills",
-		guardrailsFileName: "contentrain-essentials.mdc",
-		guardrailsFrontmatter: "---\ndescription: Contentrain essential content governance rules\nalwaysApply: true\n---\n\n"
-	},
-	windsurf: {
-		name: "Windsurf",
-		rulesDir: ".windsurf/rules",
-		skillsDir: ".windsurf/skills",
-		guardrailsFileName: "contentrain-essentials.md",
-		guardrailsFrontmatter: "---\ndescription: Contentrain essential content governance rules\ntrigger: always_on\n---\n\n"
-	},
-	copilot: {
-		name: "GitHub Copilot",
-		rulesDir: ".github",
-		skillsDir: ".agents/skills",
-		guardrailsFileName: "copilot-instructions.md"
-	}
-};
 async function installRules(projectRoot) {
 	try {
 		const { createRequire } = await import("node:module");
@@ -421,21 +365,13 @@ async function installRules(projectRoot) {
 			const requireSkills = createRequire(import.meta.url);
 			resolveSkillFile = (p) => requireSkills.resolve(`@contentrain/skills/${p}`);
 		} catch {}
-		const hasClaudeCode = await pathExists(join(projectRoot, "CLAUDE.md")) || await pathExists(join(projectRoot, ".claude"));
-		const hasCursor = await pathExists(join(projectRoot, ".cursor"));
-		const hasWindsurf = await pathExists(join(projectRoot, ".windsurf"));
-		const hasCopilot = await pathExists(join(projectRoot, ".github"));
-		const noIDEDetected = !hasClaudeCode && !hasCursor && !hasWindsurf && !hasCopilot;
-		const detectedIdes = [];
-		if (hasClaudeCode) detectedIdes.push("claude-code");
-		if (hasCursor) detectedIdes.push("cursor");
-		if (hasWindsurf) detectedIdes.push("windsurf");
-		if (hasCopilot) detectedIdes.push("copilot");
-		for (const ideKey of detectedIdes) {
+		const detectedIdeKeys = await detectIdes(projectRoot);
+		const noIDEDetected = detectedIdeKeys.length === 0;
+		for (const ideKey of detectedIdeKeys) {
 			const ide = IDE_CONFIGS[ideKey];
 			await installIdeRulesAndSkills(projectRoot, ide, resolveRuleFile, resolveSkillFile);
 		}
-		if (hasClaudeCode) await addClaudeMdReference(projectRoot);
+		if (detectedIdeKeys.includes("claude-code")) await addClaudeMdReference(projectRoot);
 		if (noIDEDetected) {
 			const essentials = await readFile(resolveRuleFile("essential/contentrain-essentials.md"), "utf-8");
 			const dest = join(projectRoot, "CLAUDE.md");
@@ -448,92 +384,26 @@ async function installRules(projectRoot) {
 		}
 	} catch {}
 }
-async function installIdeRulesAndSkills(projectRoot, ide, resolveRuleFile, resolveSkillFile) {
-	const rulesDir = join(projectRoot, ide.rulesDir);
-	const skillsDir = join(projectRoot, ide.skillsDir);
-	const git = simpleGit(projectRoot);
-	const filesToAdd = [];
-	await ensureDir(rulesDir);
-	const guardrailsDest = join(rulesDir, ide.guardrailsFileName);
-	if (!await pathExists(guardrailsDest)) try {
-		let content = await readFile(resolveRuleFile("essential/contentrain-essentials.md"), "utf-8");
-		if (ide.guardrailsFrontmatter) content = ide.guardrailsFrontmatter + content;
-		if (ide.name === "GitHub Copilot" && await pathExists(guardrailsDest)) {
-			if (!(await readFile(guardrailsDest, "utf-8")).includes("# Contentrain")) await appendFile(guardrailsDest, `\n\n${content}`);
-		} else await writeFile(guardrailsDest, content, "utf-8");
-		filesToAdd.push(guardrailsDest);
-	} catch {}
-	for (const oldFile of OLD_RULE_FILES) {
-		const oldPath = join(rulesDir, oldFile);
-		if (await pathExists(oldPath)) {
-			const { unlink } = await import("node:fs/promises");
-			await unlink(oldPath);
-		}
-	}
-	if (resolveSkillFile) {
-		await ensureDir(skillsDir);
-		for (const skillName of AGENT_SKILL_NAMES) {
-			const skillDir = join(skillsDir, skillName);
-			const skillMd = join(skillDir, "SKILL.md");
-			if (await pathExists(skillMd)) continue;
-			try {
-				const src = resolveSkillFile(`skills/${skillName}/SKILL.md`);
-				await ensureDir(skillDir);
-				await writeFile(skillMd, await readFile(src, "utf-8"), "utf-8");
-				filesToAdd.push(skillMd);
-				const { readdirSync } = await import("node:fs");
-				try {
-					const refsDir = join(resolveSkillFile(`skills/${skillName}/SKILL.md`), "..", "references");
-					const refs = readdirSync(refsDir);
-					if (refs.length > 0) {
-						const destRefsDir = join(skillDir, "references");
-						await ensureDir(destRefsDir);
-						for (const ref of refs) {
-							const refSrc = join(refsDir, ref);
-							const refDest = join(destRefsDir, ref);
-							await writeFile(refDest, await readFile(refSrc, "utf-8"), "utf-8");
-							filesToAdd.push(refDest);
-						}
-					}
-				} catch {}
-			} catch {}
+async function configureMcp(projectRoot) {
+	try {
+		const detectedIdeKeys = await detectIdes(projectRoot);
+		if (detectedIdeKeys.length === 0) detectedIdeKeys.push("claude-code");
+		const writtenPaths = [];
+		for (const ideKey of detectedIdeKeys) {
+			const result = await writeMcpConfig(projectRoot, ideKey);
+			if (result.written) {
+				log.info(`MCP configured: ${pc.cyan(result.path)}`);
+				writtenPaths.push(join(projectRoot, result.path));
+			}
 		}
-	}
-	if (filesToAdd.length > 0) {
-		await git.add(filesToAdd);
-		try {
-			await git.commit(`[contentrain] install ${ide.name} rules and skills`);
-		} catch {}
-	}
-}
-async function addClaudeMdReference(projectRoot) {
-	const claudeMdPath = join(projectRoot, "CLAUDE.md");
-	const marker = "# Contentrain AI Rules";
-	const reference = [
-		"# Contentrain AI Rules",
-		"",
-		"This project uses [Contentrain](https://ai.contentrain.io) for AI-driven content management.",
-		"",
-		"- **Rules** are in `.claude/rules/contentrain-essentials.md` — auto-loaded each conversation",
-		"- **Skills** are in `.claude/skills/` — loaded on demand by the agent",
-		"- **Docs:** https://ai.contentrain.io"
-	].join("\n");
-	const git = simpleGit(projectRoot);
-	if (await pathExists(claudeMdPath)) {
-		if (!(await readFile(claudeMdPath, "utf-8")).includes(marker)) {
-			await appendFile(claudeMdPath, `\n\n${reference}\n`);
-			await git.add(claudeMdPath);
+		if (writtenPaths.length > 0) {
+			const git = simpleGit(projectRoot);
+			await git.add(writtenPaths);
 			try {
-				await git.commit("[contentrain] add CLAUDE.md reference");
+				await git.commit("[contentrain] configure MCP servers");
 			} catch {}
 		}
-	} else {
-		await writeFile(claudeMdPath, `${reference}\n`, "utf-8");
-		await git.add(claudeMdPath);
-		try {
-			await git.commit("[contentrain] add CLAUDE.md reference");
-		} catch {}
-	}
+	} catch {}
 }
 async function updateGitignore(projectRoot) {
 	const gitignorePath = join(projectRoot, ".gitignore");

package/dist/{login-wRBvHDCi.mjs → login-DCXkOrQV.mjs}

@@ -1,6 +1,6 @@
 import { i as pc } from "./ui-B5mXontH.mjs";
-import { i as checkPermissions, o as loadCredentials, s as saveCredentials, t as StudioApiClient } from "./client-CLV4XoJz.mjs";
-import { n as openBrowser, t as startOAuthServer } from "./oauth-server-1p6y1H30.mjs";
+import { i as checkPermissions, o as loadCredentials, s as saveCredentials, t as StudioApiClient } from "./client-C400qHcL.mjs";
+import { n as openBrowser, t as startOAuthServer } from "./oauth-server-Beppljfz.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
 //#region src/studio/commands/login.ts

package/dist/{logout-xPTGu6vx.mjs → logout-nPt2UAeQ.mjs}

@@ -1,5 +1,5 @@
 import { i as pc } from "./ui-B5mXontH.mjs";
-import { a as clearCredentials, o as loadCredentials, t as StudioApiClient } from "./client-CLV4XoJz.mjs";
+import { a as clearCredentials, o as loadCredentials, t as StudioApiClient } from "./client-C400qHcL.mjs";
 import { defineCommand } from "citty";
 import { intro, log, outro } from "@clack/prompts";
 //#region src/studio/commands/logout.ts

package/dist/{resolve-context-BwcikcF0.mjs → resolve-context-Cg6JoVZt.mjs}

@@ -1,4 +1,4 @@
-import { c as saveDefaults, o as loadCredentials } from "./client-CLV4XoJz.mjs";
+import { c as saveDefaults, o as loadCredentials } from "./client-C400qHcL.mjs";
 import { confirm, isCancel, select } from "@clack/prompts";
 //#region src/studio/resolve-context.ts
 /**

package/dist/{serve-DL4LhWxl.mjs → serve-CNeFIQ1i.mjs}

@@ -11,32 +11,51 @@ var serve_default = defineCommand({
 	args: {
 		root: {
 			type: "string",
-			description: "Project root path",
+			description: "Project root path (env: CONTENTRAIN_PROJECT_ROOT)",
 			required: false
 		},
 		stdio: {
 			type: "boolean",
-			description: "Use stdio MCP transport (for IDE integration)",
+			description: "Use stdio MCP transport for IDE integration (env: CONTENTRAIN_STDIO=true)",
 			required: false
 		},
 		port: {
 			type: "string",
-			description: "HTTP server port (default: 3333)",
+			description: "HTTP server port, default: 3333 (env: CONTENTRAIN_PORT)",
 			required: false
 		},
 		open: {
 			type: "boolean",
-			description: "Open browser automatically",
+			description: "Open browser automatically (env: CONTENTRAIN_NO_OPEN=true to disable)",
 			required: false
 		},
 		host: {
 			type: "string",
-			description: "Bind address (default: localhost)",
+			description: "Bind address, default: localhost (env: CONTENTRAIN_HOST)",
+			required: false
+		},
+		demo: {
+			type: "boolean",
+			description: "Start with a temporary demo project (no setup needed)",
 			required: false
 		}
 	},
 	async run({ args }) {
-		const projectRoot = await resolveProjectRoot(args.root);
+		let projectRoot = await resolveProjectRoot(args.root);
+		let demoDir;
+		if (args.demo) {
+			const { createDemoProject, cleanupDemoProject } = await import("./demo-DcBt6fw8.mjs");
+			demoDir = await createDemoProject();
+			projectRoot = demoDir;
+			consola.info(`Demo project created at ${demoDir}`);
+			process.on("exit", () => {
+				cleanupDemoProject(demoDir);
+			});
+			process.on("SIGINT", () => {
+				cleanupDemoProject(demoDir);
+				process.exit(0);
+			});
+		}
 		process.env["CONTENTRAIN_PROJECT_ROOT"] = projectRoot;
 		process.env["CONTENTRAIN_SOURCE"] = "mcp-local";
 		try {
@@ -47,7 +66,7 @@ var serve_default = defineCommand({
 			if (name && typeof name === "string") process.env["CONTENTRAIN_AUTHOR_NAME"] = name;
 			if (email && typeof email === "string") process.env["CONTENTRAIN_AUTHOR_EMAIL"] = email;
 		} catch {}
-		if (args.stdio) {
+		if (args.stdio || process.env["CONTENTRAIN_STDIO"] === "true" || process.env["CONTENTRAIN_STDIO"] === "1") {
 			const server = createServer(projectRoot);
 			const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
 			const transport = new StdioServerTransport();
@@ -55,9 +74,9 @@ var serve_default = defineCommand({
 			await server.connect(transport);
 			return;
 		}
-		const port = Number(args.port) || 3333;
-		const host = args.host ?? "localhost";
-		const shouldOpen = args.open !== false;
+		const port = Number(args.port) || Number(process.env["CONTENTRAIN_PORT"]) || 3333;
+		const host = args.host ?? process.env["CONTENTRAIN_HOST"] ?? "localhost";
+		const shouldOpen = args.open !== false && process.env["CONTENTRAIN_NO_OPEN"] !== "true";
 		const { join, dirname } = await import("node:path");
 		const { existsSync } = await import("node:fs");
 		const { fileURLToPath } = await import("node:url");
@@ -66,7 +85,7 @@ var serve_default = defineCommand({
 			consola.warn("Serve UI not found. Running in API-only mode.");
 			consola.info("UI will be available after building: cd packages/cli/src/serve-ui && pnpm build");
 		}
-		const { createServeApp } = await import("./server-WLDOAZa4.mjs");
+		const { createServeApp } = await import("./server-DTdmutjb.mjs");
 		const { app, handleUpgrade } = await createServeApp({
 			projectRoot,
 			port,

package/dist/setup-DJy-jNEU.mjs

@@ -0,0 +1,108 @@
+import { r as resolveProjectRoot, t as loadProjectContext } from "./context-An3xrvcP.mjs";
+import { i as pc } from "./ui-B5mXontH.mjs";
+import { a as detectIdes, n as IDE_CONFIGS, o as installIdeRulesAndSkills, r as MCP_CONFIGS, s as writeMcpConfig } from "./ide-Bg-Z8QZk.mjs";
+import { defineCommand } from "citty";
+import { intro, log, outro, spinner } from "@clack/prompts";
+//#region src/commands/setup.ts
+const SUPPORTED_AGENTS = Object.keys(MCP_CONFIGS);
+var setup_default = defineCommand({
+	meta: {
+		name: "setup",
+		description: "Configure MCP server and AI rules for your IDE"
+	},
+	args: {
+		agent: {
+			type: "positional",
+			description: `IDE agent: ${SUPPORTED_AGENTS.join(", ")}`,
+			required: false
+		},
+		root: {
+			type: "string",
+			description: "Project root path",
+			required: false
+		},
+		all: {
+			type: "boolean",
+			description: "Configure all detected IDEs",
+			required: false
+		}
+	},
+	async run({ args }) {
+		const projectRoot = await resolveProjectRoot(args.root);
+		intro(pc.bold("contentrain setup"));
+		const agent = args.agent;
+		if (!agent && !args.all) {
+			log.error("Please specify an agent or use --all:");
+			log.message("");
+			log.message(`  ${pc.cyan("contentrain setup claude-code")}`);
+			log.message(`  ${pc.cyan("contentrain setup cursor")}`);
+			log.message(`  ${pc.cyan("contentrain setup vscode")}`);
+			log.message(`  ${pc.cyan("contentrain setup windsurf")}`);
+			log.message(`  ${pc.cyan("contentrain setup copilot")}`);
+			log.message(`  ${pc.cyan("contentrain setup --all")}`);
+			outro("");
+			return;
+		}
+		if (agent && !SUPPORTED_AGENTS.includes(agent)) {
+			log.error(`Unknown agent: "${agent}"`);
+			log.message(`Supported agents: ${SUPPORTED_AGENTS.join(", ")}`);
+			outro("");
+			return;
+		}
+		if (!(await loadProjectContext(projectRoot)).initialized) {
+			log.warning("Project not initialized. Run `contentrain init` first.");
+			outro("");
+			return;
+		}
+		const s = spinner();
+		let agents;
+		if (args.all) {
+			agents = await detectIdes(projectRoot);
+			if (agents.length === 0) agents = ["claude-code"];
+			s.start(`Configuring MCP for ${agents.map((a) => MCP_CONFIGS[a] ? a : "").filter(Boolean).join(", ")}...`);
+		} else {
+			agents = [agent];
+			s.start(`Configuring MCP for ${agent}...`);
+		}
+		const results = [];
+		for (const agentKey of agents) {
+			const mcpResult = await writeMcpConfig(projectRoot, agentKey);
+			let rulesStatus = "skipped";
+			const ideConfig = IDE_CONFIGS[agentKey];
+			if (ideConfig) try {
+				const { createRequire } = await import("node:module");
+				const req = createRequire(import.meta.url);
+				const resolveRuleFile = (p) => req.resolve(`@contentrain/rules/${p}`);
+				let resolveSkillFile = null;
+				try {
+					resolveSkillFile = (p) => req.resolve(`@contentrain/skills/${p}`);
+				} catch {}
+				const result = await installIdeRulesAndSkills(projectRoot, ideConfig, resolveRuleFile, resolveSkillFile);
+				if (result.installed > 0) rulesStatus = `${result.installed} installed`;
+				else rulesStatus = "up to date";
+			} catch {
+				rulesStatus = "failed (packages not installed)";
+			}
+			results.push({
+				agent: agentKey,
+				mcp: mcpResult.written ? `${pc.green("✓")} ${mcpResult.path}` : `${pc.dim("–")} ${mcpResult.skipped ?? mcpResult.path}`,
+				rules: rulesStatus
+			});
+		}
+		s.stop("Done");
+		for (const r of results) {
+			log.info(`${pc.bold(r.agent)}`);
+			log.message(`  MCP config: ${r.mcp}`);
+			log.message(`  Rules/skills: ${r.rules}`);
+		}
+		log.message("");
+		log.info(pc.bold("Next steps:"));
+		log.message(`  1. Restart your IDE to pick up the MCP config`);
+		log.message(`  2. Ask your agent: ${pc.cyan("\"Create a hero section model\"")}`);
+		log.message("");
+		log.message(pc.dim(`  Tip: Run ${pc.cyan("contentrain serve")} to open the local review UI`));
+		outro("");
+	}
+});
+//#endregion
+export { setup_default as default };

package/dist/skills-D-tFY7WA.mjs

@@ -0,0 +1,92 @@
+import { r as resolveProjectRoot } from "./context-An3xrvcP.mjs";
+import { i as pc } from "./ui-B5mXontH.mjs";
+import { a as detectIdes, n as IDE_CONFIGS, o as installIdeRulesAndSkills, t as AGENT_SKILL_NAMES } from "./ide-Bg-Z8QZk.mjs";
+import { defineCommand } from "citty";
+import { intro, log, outro, spinner } from "@clack/prompts";
+import { join } from "node:path";
+import { pathExists } from "@contentrain/mcp/util/fs";
+//#region src/commands/skills.ts
+var skills_default = defineCommand({
+	meta: {
+		name: "skills",
+		description: "Install, update, or list Contentrain AI skills and rules for your IDE"
+	},
+	args: {
+		root: {
+			type: "string",
+			description: "Project root path",
+			required: false
+		},
+		update: {
+			type: "boolean",
+			description: "Force update all skills and rules",
+			required: false
+		},
+		list: {
+			type: "boolean",
+			description: "List installed skills and their status",
+			required: false
+		}
+	},
+	async run({ args }) {
+		const projectRoot = await resolveProjectRoot(args.root);
+		intro(pc.bold("contentrain skills"));
+		if (args.list) {
+			await listInstalledSkills(projectRoot);
+			return;
+		}
+		const s = spinner();
+		s.start("Installing skills and rules...");
+		try {
+			const { createRequire } = await import("node:module");
+			const require = createRequire(import.meta.url);
+			const resolveRuleFile = (p) => require.resolve(`@contentrain/rules/${p}`);
+			let resolveSkillFile = null;
+			try {
+				const requireSkills = createRequire(import.meta.url);
+				resolveSkillFile = (p) => requireSkills.resolve(`@contentrain/skills/${p}`);
+			} catch {
+				s.stop("Failed");
+				log.error("@contentrain/skills package not found. Install it:");
+				log.message(pc.cyan("  pnpm add -D @contentrain/skills @contentrain/rules"));
+				outro("");
+				return;
+			}
+			const detectedIdes = await detectIdes(projectRoot);
+			if (detectedIdes.length === 0) detectedIdes.push("claude-code");
+			let totalInstalled = 0;
+			let totalUpdated = 0;
+			for (const ideKey of detectedIdes) {
+				const ide = IDE_CONFIGS[ideKey];
+				const result = await installIdeRulesAndSkills(projectRoot, ide, resolveRuleFile, resolveSkillFile, args.update ?? false);
+				totalInstalled += result.installed;
+				totalUpdated += result.updated;
+			}
+			s.stop(`Done — ${detectedIdes.map((k) => IDE_CONFIGS[k].name).join(", ")}`);
+			if (totalUpdated > 0) log.success(`Updated ${totalUpdated} skill(s)`);
+			if (totalInstalled > 0) log.success(`Installed ${totalInstalled} new skill(s)`);
+			if (totalInstalled === 0 && totalUpdated === 0) log.info("All skills are up to date");
+			outro("");
+		} catch (error) {
+			s.stop("Failed");
+			throw error;
+		}
+	}
+});
+async function listInstalledSkills(projectRoot) {
+	let found = false;
+	for (const [, ide] of Object.entries(IDE_CONFIGS)) {
+		const skillsDir = join(projectRoot, ide.skillsDir);
+		if (!await pathExists(skillsDir)) continue;
+		found = true;
+		log.info(`${pc.bold(ide.name)} (${ide.skillsDir}/):`);
+		for (const skillName of AGENT_SKILL_NAMES) if (await pathExists(join(skillsDir, skillName, "SKILL.md"))) log.message(`  ${pc.green("✓")} ${skillName}`);
+		else log.message(`  ${pc.red("✗")} ${skillName} ${pc.dim("(missing)")}`);
+		if (await pathExists(join(projectRoot, ide.rulesDir, ide.guardrailsFileName))) log.message(`  ${pc.green("✓")} essential rules`);
+		else log.message(`  ${pc.red("✗")} essential rules ${pc.dim("(missing)")}`);
+	}
+	if (!found) log.warning("No IDE skills directories found. Run `contentrain skills` to install.");
+	outro("");
+}
+//#endregion
+export { skills_default as default };

package/dist/{status-UvjbO4eS.mjs → status-Cyv-jo1y.mjs}

@@ -1,6 +1,6 @@
 import { i as pc, r as formatTable, t as formatCount } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { intro, log, outro, spinner } from "@clack/prompts";
 //#region src/studio/commands/status.ts

package/dist/studio-CJUGiIMd.mjs

@@ -0,0 +1,24 @@
+import { defineCommand } from "citty";
+//#region src/studio/index.ts
+var studio_default = defineCommand({
+	meta: {
+		name: "studio",
+		description: "Interact with Contentrain Studio"
+	},
+	subCommands: {
+		login: () => import("./login-DCXkOrQV.mjs").then((m) => m.default),
+		logout: () => import("./logout-nPt2UAeQ.mjs").then((m) => m.default),
+		whoami: () => import("./whoami-Ub5RznbU.mjs").then((m) => m.default),
+		connect: () => import("./connect-DJo9PSiw.mjs").then((m) => m.default),
+		status: () => import("./status-Cyv-jo1y.mjs").then((m) => m.default),
+		activity: () => import("./activity-CbkxcfDf.mjs").then((m) => m.default),
+		usage: () => import("./usage-B2xuc2DT.mjs").then((m) => m.default),
+		branches: () => import("./branches-D2UWex1N.mjs").then((m) => m.default),
+		"cdn-init": () => import("./cdn-init-CsmqJIaQ.mjs").then((m) => m.default),
+		"cdn-build": () => import("./cdn-build-BzC2QPNi.mjs").then((m) => m.default),
+		webhooks: () => import("./webhooks-Dq3zFLP7.mjs").then((m) => m.default),
+		submissions: () => import("./submissions-bIG-MWvv.mjs").then((m) => m.default)
+	}
+});
+//#endregion
+export { studio_default as default };

package/dist/{submissions-Dw0ChFDi.mjs → submissions-bIG-MWvv.mjs}

@@ -1,6 +1,6 @@
 import { i as pc, r as formatTable, t as formatCount } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
 //#region src/studio/commands/submissions.ts

package/dist/{usage-BqriRRqE.mjs → usage-B2xuc2DT.mjs}

@@ -1,6 +1,6 @@
 import { i as pc, n as formatPercent, r as formatTable } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { intro, log, outro, spinner } from "@clack/prompts";
 //#region src/studio/commands/usage.ts

package/dist/{webhooks-B1OhcCtZ.mjs → webhooks-Dq3zFLP7.mjs}

@@ -1,6 +1,6 @@
 import { i as pc, o as statusIcon, r as formatTable } from "./ui-B5mXontH.mjs";
-import { n as resolveStudioClient } from "./client-CLV4XoJz.mjs";
-import { t as resolveStudioContext } from "./resolve-context-BwcikcF0.mjs";
+import { n as resolveStudioClient } from "./client-C400qHcL.mjs";
+import { t as resolveStudioContext } from "./resolve-context-Cg6JoVZt.mjs";
 import { defineCommand } from "citty";
 import { confirm, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
 //#region src/studio/commands/webhooks.ts

package/dist/{whoami-CWvTYzum.mjs → whoami-Ub5RznbU.mjs}

@@ -1,5 +1,5 @@
 import { i as pc } from "./ui-B5mXontH.mjs";
-import { i as checkPermissions, n as resolveStudioClient, r as AuthExpiredError } from "./client-CLV4XoJz.mjs";
+import { i as checkPermissions, n as resolveStudioClient, r as AuthExpiredError } from "./client-C400qHcL.mjs";
 import { defineCommand } from "citty";
 import { intro, log, outro } from "@clack/prompts";
 //#region src/studio/commands/whoami.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contentrain",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "license": "MIT",
   "description": "CLI for Contentrain — AI content governance infrastructure",
   "type": "module",
@@ -46,10 +46,10 @@
     "picocolors": "^1.1.0",
     "simple-git": "^3.27.0",
     "ws": "^8.18.0",
-    "@contentrain/rules": "0.3.1",
-    "@contentrain/query": "5.1.3",
-    "@contentrain/types": "0.4.1",
-    "@contentrain/mcp": "1.1.2"
+    "@contentrain/rules": "0.3.2",
+    "@contentrain/mcp": "1.2.0",
+    "@contentrain/query": "5.1.4",
+    "@contentrain/types": "0.4.2"
   },
   "devDependencies": {
     "@types/ws": "^8.5.0",

package/dist/studio-B8lF0fQx.mjs

@@ -1,24 +0,0 @@
-import { defineCommand } from "citty";
-//#region src/studio/index.ts
-var studio_default = defineCommand({
-	meta: {
-		name: "studio",
-		description: "Interact with Contentrain Studio"
-	},
-	subCommands: {
-		login: () => import("./login-wRBvHDCi.mjs").then((m) => m.default),
-		logout: () => import("./logout-xPTGu6vx.mjs").then((m) => m.default),
-		whoami: () => import("./whoami-CWvTYzum.mjs").then((m) => m.default),
-		connect: () => import("./connect-DiSYnxFd.mjs").then((m) => m.default),
-		status: () => import("./status-UvjbO4eS.mjs").then((m) => m.default),
-		activity: () => import("./activity-DMQsYlzz.mjs").then((m) => m.default),
-		usage: () => import("./usage-BqriRRqE.mjs").then((m) => m.default),
-		branches: () => import("./branches-D330IxDO.mjs").then((m) => m.default),
-		"cdn-init": () => import("./cdn-init-Bhnil0F8.mjs").then((m) => m.default),
-		"cdn-build": () => import("./cdn-build-D_d3p4OZ.mjs").then((m) => m.default),
-		webhooks: () => import("./webhooks-B1OhcCtZ.mjs").then((m) => m.default),
-		submissions: () => import("./submissions-Dw0ChFDi.mjs").then((m) => m.default)
-	}
-});
-//#endregion
-export { studio_default as default };