contentrain 0.2.3 → 0.3.0

package/dist/index.mjs

@@ -5,11 +5,11 @@ import { defineCommand, runMain } from "citty";
 runMain(defineCommand({
 	meta: {
 		name: "contentrain",
-		version: "0.2.3",
+		version: "0.3.0",
 		description: "Contentrain CLI — AI content governance infrastructure"
 	},
 	subCommands: {
-		init: () => import("./init-BbtT9_sl.mjs").then((m) => m.default),
+		init: () => import("./init-BARgfYUV.mjs").then((m) => m.default),
 		status: () => import("./status-kF5miVty.mjs").then((m) => m.default),
 		doctor: () => import("./doctor-DyKjAIKH.mjs").then((m) => m.default),
 		validate: () => import("./validate-DnVamp3p.mjs").then((m) => m.default),

package/dist/{init-BbtT9_sl.mjs → init-BARgfYUV.mjs}

@@ -350,33 +350,64 @@ async function executeInit(projectRoot, opts) {
 		await tx.cleanup();
 	}
 }
-const RULE_BASE_NAMES = [
-	"content-quality",
-	"seo-rules",
-	"i18n-quality",
-	"accessibility-rules",
-	"security-rules",
-	"media-rules",
-	"content-conventions",
-	"schema-rules",
-	"mcp-usage",
-	"workflow-rules",
-	"normalize-rules"
+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 SKILL_FILE_NAMES = [
-	"contentrain-normalize.md",
-	"contentrain-content.md",
-	"contentrain-model.md",
-	"contentrain-bulk.md",
-	"contentrain-validate-fix.md",
-	"contentrain-review.md",
-	"contentrain-translate.md",
-	"contentrain-generate.md",
-	"contentrain-serve.md",
-	"contentrain-diff.md",
-	"contentrain-doctor.md",
-	"contentrain-init.md"
+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");
@@ -388,27 +419,24 @@ async function installRules(projectRoot) {
 			resolveSkillFile = (p) => requireSkills.resolve(`@contentrain/skills/${p}`);
 		} catch {}
 		const hasClaudeCode = await pathExists(join(projectRoot, "CLAUDE.md")) || await pathExists(join(projectRoot, ".claude"));
-		const hasCursorDir = await pathExists(join(projectRoot, ".cursor"));
-		const hasCursorRules = await pathExists(join(projectRoot, ".cursorrules"));
-		const hasWindsurfDir = await pathExists(join(projectRoot, ".windsurf"));
-		const noIDEDetected = !hasClaudeCode && !hasCursorDir && !hasCursorRules && !hasWindsurfDir;
-		if (hasClaudeCode) await installClaudeCodeRules(projectRoot, resolveRuleFile, resolveSkillFile);
-		if (hasCursorDir) await installCursorRules(projectRoot, resolveRuleFile);
-		else if (hasCursorRules) {
-			const source = resolveRuleFile("ide/cursor/contentrain.cursorrules");
-			const dest = join(projectRoot, ".cursorrules");
-			await writeFile(dest, await readFile(source, "utf-8"), "utf-8");
-			const git = simpleGit(projectRoot);
-			await git.add(dest);
-			try {
-				await git.commit("[contentrain] install Cursor rules");
-			} catch {}
+		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 ide = IDE_CONFIGS[ideKey];
+			await installIdeRulesAndSkills(projectRoot, ide, resolveRuleFile, resolveSkillFile);
 		}
-		if (hasWindsurfDir) await installWindsurfRules(projectRoot, resolveRuleFile);
+		if (hasClaudeCode) await addClaudeMdReference(projectRoot);
 		if (noIDEDetected) {
-			const source = resolveRuleFile("ide/generic/contentrain.md");
+			const essentials = await readFile(resolveRuleFile("essential/contentrain-essentials.md"), "utf-8");
 			const dest = join(projectRoot, "CLAUDE.md");
-			await writeFile(dest, await readFile(source, "utf-8"), "utf-8");
+			await writeFile(dest, essentials, "utf-8");
 			const git = simpleGit(projectRoot);
 			await git.add(dest);
 			try {
@@ -417,32 +445,65 @@ async function installRules(projectRoot) {
 		}
 	} catch {}
 }
-async function installClaudeCodeRules(projectRoot, resolveRuleFile, resolveSkillFile) {
-	const rulesDir = join(projectRoot, ".claude", "rules");
-	const skillsDir = join(projectRoot, ".claude", "skills");
+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);
-	for (const baseName of RULE_BASE_NAMES) {
-		const fileName = `contentrain-${baseName}.md`;
-		const dest = join(rulesDir, fileName);
-		if (await pathExists(dest)) continue;
-		try {
-			await writeFile(dest, await readFile(resolveRuleFile(`ide/claude-code/rules/${fileName}`), "utf-8"), "utf-8");
-			filesToAdd.push(dest);
-		} catch {}
+	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 fileName of SKILL_FILE_NAMES) {
-			const dest = join(skillsDir, fileName);
-			if (await pathExists(dest)) continue;
+		for (const skillName of AGENT_SKILL_NAMES) {
+			const skillDir = join(skillsDir, skillName);
+			const skillMd = join(skillDir, "SKILL.md");
+			if (await pathExists(skillMd)) continue;
 			try {
-				await writeFile(dest, await readFile(resolveSkillFile(`workflows/${fileName}`), "utf-8"), "utf-8");
-				filesToAdd.push(dest);
+				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 {}
 		}
 	}
+	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 = [
@@ -450,65 +511,24 @@ async function installClaudeCodeRules(projectRoot, resolveRuleFile, resolveSkill
 		"",
 		"This project uses [Contentrain](https://ai.contentrain.io) for AI-driven content management.",
 		"",
-		"- **Rules** are in `.claude/rules/` — auto-loaded each conversation",
-		"- **Skills** are in `.claude/skills/` — invoke with `/contentrain-normalize` etc.",
+		"- **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`);
-			filesToAdd.push(claudeMdPath);
+			await git.add(claudeMdPath);
+			try {
+				await git.commit("[contentrain] add CLAUDE.md reference");
+			} catch {}
 		}
 	} else {
 		await writeFile(claudeMdPath, `${reference}\n`, "utf-8");
-		filesToAdd.push(claudeMdPath);
-	}
-	if (filesToAdd.length > 0) {
-		await git.add(filesToAdd);
-		try {
-			await git.commit("[contentrain] install Claude Code rules and skills");
-		} catch {}
-	}
-}
-async function installCursorRules(projectRoot, resolveRuleFile) {
-	const rulesDir = join(projectRoot, ".cursor", "rules");
-	await ensureDir(rulesDir);
-	const git = simpleGit(projectRoot);
-	const filesToAdd = [];
-	for (const baseName of RULE_BASE_NAMES) {
-		const srcFile = `contentrain-${baseName}.mdc`;
-		const dest = join(rulesDir, srcFile);
-		if (await pathExists(dest)) continue;
-		try {
-			await writeFile(dest, await readFile(resolveRuleFile(`ide/cursor/rules/${srcFile}`), "utf-8"), "utf-8");
-			filesToAdd.push(dest);
-		} catch {}
-	}
-	if (filesToAdd.length > 0) {
-		await git.add(filesToAdd);
-		try {
-			await git.commit("[contentrain] install Cursor rules");
-		} catch {}
-	}
-}
-async function installWindsurfRules(projectRoot, resolveRuleFile) {
-	const rulesDir = join(projectRoot, ".windsurf", "rules");
-	await ensureDir(rulesDir);
-	const git = simpleGit(projectRoot);
-	const filesToAdd = [];
-	for (const baseName of RULE_BASE_NAMES) {
-		const fileName = `contentrain-${baseName}.md`;
-		const dest = join(rulesDir, fileName);
-		if (await pathExists(dest)) continue;
-		try {
-			await writeFile(dest, await readFile(resolveRuleFile(`ide/windsurf/rules/${fileName}`), "utf-8"), "utf-8");
-			filesToAdd.push(dest);
-		} catch {}
-	}
-	if (filesToAdd.length > 0) {
-		await git.add(filesToAdd);
+		await git.add(claudeMdPath);
 		try {
-			await git.commit("[contentrain] install Windsurf rules");
+			await git.commit("[contentrain] add CLAUDE.md reference");
 		} catch {}
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contentrain",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "license": "MIT",
   "description": "CLI for Contentrain — AI content governance infrastructure",
   "type": "module",
@@ -46,9 +46,9 @@
     "picocolors": "^1.1.0",
     "simple-git": "^3.27.0",
     "ws": "^8.18.0",
+    "@contentrain/rules": "0.3.0",
     "@contentrain/mcp": "1.0.6",
-    "@contentrain/rules": "0.2.0",
-    "@contentrain/query": "5.0.2",
+    "@contentrain/query": "5.1.0",
     "@contentrain/types": "0.2.0"
   },
   "devDependencies": {