@matteoaliano/forest-ui 0.2.0 → 0.2.2

package/bin/sync.mjs

@@ -3,38 +3,72 @@
 /**
  * forest-ui sync
  *
- * Copies FOREST_AI_GUIDELINES.md into the AI-tool config directories
+ * Copies guideline files into the AI-tool config directories
  * of the consuming project so coding assistants automatically follow
  * Forest UI conventions.
  *
  * Supported targets:
- *   .claude/forest-ui.md      — Claude Code
- *   .cursor/rules/forest-ui.mdc — Cursor
+ *   .claude/<name>.md         — Claude Code
+ *   .cursor/rules/<name>.mdc  — Cursor
+ *
+ * Guideline categories:
+ *   - FOREST_AI_GUIDELINES.md            — Design system components, tokens, patterns
+ *   - FOREST_DEV_GUIDELINES.md           — Development best practices
+ *   - themes/FOREST_THEME_<NAME>.md      — Theme-specific guidelines (auto-discovered)
  */
 
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
-import { resolve, dirname } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from "node:fs";
+import { resolve, dirname, basename } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Locate the guidelines file shipped with the package
-const guidelinesPath = resolve(__dirname, "..", "FOREST_AI_GUIDELINES.md");
+const guidelinesDir = resolve(__dirname, "..", "guidelines");
+const themesDir = resolve(guidelinesDir, "themes");
 
-if (!existsSync(guidelinesPath)) {
-    console.error("❌ Could not find FOREST_AI_GUIDELINES.md in the forest-ui package.");
-    process.exit(1);
-}
+// Static guideline entries
+const staticEntries = [
+    {
+        source: resolve(guidelinesDir, "FOREST_AI_GUIDELINES.md"),
+        claudeName: "forest-ui.md",
+        cursorName: "forest-ui.mdc",
+        cursorDescription: "Forest UI Design System guidelines — components, tokens, and patterns",
+    },
+    {
+        source: resolve(guidelinesDir, "FOREST_DEV_GUIDELINES.md"),
+        claudeName: "forest-dev.md",
+        cursorName: "forest-dev.mdc",
+        cursorDescription: "Forest UI development best practices",
+    },
+];
+
+// Auto-discover theme files from guidelines/themes/
+function discoverThemeEntries() {
+    if (!existsSync(themesDir)) return [];
+
+    return readdirSync(themesDir)
+        .filter((f) => /^FOREST_THEME_\w+\.md$/.test(f))
+        .map((f) => {
+            const themeName = f
+                .replace(/^FOREST_THEME_/, "")
+                .replace(/\.md$/, "")
+                .toLowerCase();
 
-const guidelines = readFileSync(guidelinesPath, "utf-8");
+            return {
+                source: resolve(themesDir, f),
+                claudeName: `forest-theme-${themeName}.md`,
+                cursorName: `forest-theme-${themeName}.mdc`,
+                cursorDescription: `Forest UI theme guidelines — ${themeName}`,
+            };
+        });
+}
 
 // Find the consuming project root (walk up until we find package.json)
 function findProjectRoot(startDir) {
     let dir = startDir;
     while (dir !== dirname(dir)) {
         if (existsSync(resolve(dir, "package.json"))) {
-            // Skip if this is the forest-ui package itself
             try {
                 const pkg = JSON.parse(readFileSync(resolve(dir, "package.json"), "utf-8"));
                 if (pkg.name !== "@matteoaliano/forest-ui") return dir;
@@ -48,44 +82,51 @@ function findProjectRoot(startDir) {
 }
 
 const projectRoot = findProjectRoot(process.cwd());
-
-// Define sync targets
-const targets = [
-    {
-        name: "Claude Code",
-        dir: resolve(projectRoot, ".claude"),
-        file: "forest-ui.md",
-    },
-    {
-        name: "Cursor",
-        dir: resolve(projectRoot, ".cursor", "rules"),
-        file: "forest-ui.mdc",
-    },
-];
+const entries = [...staticEntries, ...discoverThemeEntries()];
 
 console.log(`\n🌲 Forest UI — Syncing AI guidelines\n`);
-console.log(`   Project root: ${projectRoot}\n`);
+console.log(`   Project root: ${projectRoot}`);
+console.log(`   Found ${entries.length} guideline file(s)\n`);
 
 let synced = 0;
+let total = 0;
+
+for (const entry of entries) {
+    if (!existsSync(entry.source)) {
+        console.log(`   ⚠️  ${basename(entry.source)} — not found, skipping`);
+        continue;
+    }
 
-for (const target of targets) {
+    const content = readFileSync(entry.source, "utf-8");
+
+    // Claude Code target
+    const claudeDir = resolve(projectRoot, ".claude");
+    const claudePath = resolve(claudeDir, entry.claudeName);
+    total++;
     try {
-        mkdirSync(target.dir, { recursive: true });
-
-        // For Cursor .mdc files, prepend frontmatter
-        let content = guidelines;
-        if (target.file.endsWith(".mdc")) {
-            content =
-                `---\ndescription: Forest UI Design System guidelines — components, tokens, and patterns\nglobs: **/*.{ts,tsx,js,jsx}\nalwaysApply: false\n---\n\n` +
-                guidelines;
-        }
+        mkdirSync(claudeDir, { recursive: true });
+        writeFileSync(claudePath, content, "utf-8");
+        console.log(`   ✅ Claude Code → .claude/${entry.claudeName}`);
+        synced++;
+    } catch (err) {
+        console.log(`   ⚠️  Claude Code — .claude/${entry.claudeName} skipped (${err.message})`);
+    }
 
-        writeFileSync(resolve(target.dir, target.file), content, "utf-8");
-        console.log(`   ✅ ${target.name} → ${target.dir}/${target.file}`);
+    // Cursor target
+    const cursorDir = resolve(projectRoot, ".cursor", "rules");
+    const cursorPath = resolve(cursorDir, entry.cursorName);
+    total++;
+    try {
+        mkdirSync(cursorDir, { recursive: true });
+        const cursorContent =
+            `---\ndescription: ${entry.cursorDescription}\nglobs: **/*.{ts,tsx,js,jsx}\nalwaysApply: false\n---\n\n` +
+            content;
+        writeFileSync(cursorPath, cursorContent, "utf-8");
+        console.log(`   ✅ Cursor     → .cursor/rules/${entry.cursorName}`);
         synced++;
     } catch (err) {
-        console.log(`   ⚠️  ${target.name} — skipped (${err.message})`);
+        console.log(`   ⚠️  Cursor — .cursor/rules/${entry.cursorName} skipped (${err.message})`);
     }
 }
 
-console.log(`\n   Synced to ${synced}/${targets.length} targets.\n`);
+console.log(`\n   Synced ${synced}/${total} targets.\n`);