synthesisui 0.1.15 → 0.1.17

package/dist/commands/add.js

@@ -64,6 +64,22 @@ export async function add(slug, opts) {
                 .join("\n")}\n`;
         await writeFile(join(slugDir, "rules.md"), body, "utf8");
     }
+    // 5c. structured philosophy (personal DS) → philosophy.md at the slug root.
+    //     Narrative guidance (mission, principles, voice, motion doctrine…); the
+    //     GUIDE points the agent here right after rules.md.
+    const philosophy = payload.document.philosophy;
+    const sections = philosophy?.sections ?? [];
+    if (sections.length > 0 || philosophy?.context) {
+        const parts = [`# ${payload.name} - Philosophy`, ""];
+        parts.push("> The voice and principles behind this system. Read after rules.md;", "> let it shape every screen. Managed by synthesisui (edit in the studio).", "");
+        if (philosophy?.context) {
+            parts.push("## What this product is", "", philosophy.context, "");
+        }
+        for (const s of sections) {
+            parts.push(`## ${s.title}`, "", s.body, "");
+        }
+        await writeFile(join(slugDir, "philosophy.md"), `${parts.join("\n")}\n`, "utf8");
+    }
     // 6. discovery by the agent
     const claudeMd = await syncClaudeMd(projectRoot);
     // outcome line
@@ -89,6 +105,9 @@ export async function add(slug, opts) {
     if (rules.length > 0) {
         console.log(`  rules.md → ${rules.length} rule(s) (read these first)`);
     }
+    if (sections.length > 0 || philosophy?.context) {
+        console.log(`  philosophy.md → ${sections.length} section(s) (read after rules)`);
+    }
     console.log(`  CLAUDE.md ${claudeMd.created ? "created" : "updated"} (${claudeMd.count} system(s) installed)`);
     console.log("");
     console.log("Next steps:");

package/dist/commands/init.js

@@ -1,7 +1,11 @@
 import { DEFAULT_CONFIG, writeProjectConfig } from "../config.js";
+import { add } from "./add.js";
 /**
- * Writes `_synthesisui/config.json` - where `synthesisui page` materializes
- * pages and which framework to target. Committable; safe to re-run.
+ * Bootstraps a project for SynthesisUI: writes `_synthesisui/config.json`
+ * (where `page` materializes pages, where components live, which framework to
+ * target) and - with `--ds <slug>` - immediately brings that system in, so the
+ * project lands with tokens, philosophy, rules and a CLAUDE.md in one step.
+ * Committable; safe to re-run.
  */
 export async function init(opts) {
     const root = opts.dir ?? process.cwd();
@@ -9,13 +13,22 @@ export async function init(opts) {
     const config = {
         target,
         pagesDir: opts.pagesDir ?? (target === "next" ? "app" : DEFAULT_CONFIG.pagesDir),
+        componentsDir: opts.componentsDir ?? DEFAULT_CONFIG.componentsDir,
     };
     await writeProjectConfig(root, config);
     console.log("✓ wrote _synthesisui/config.json");
-    console.log(`  target:   ${config.target}`);
-    console.log(`  pagesDir: ${config.pagesDir}`);
+    console.log(`  target:        ${config.target}`);
+    console.log(`  pagesDir:      ${config.pagesDir}`);
+    console.log(`  componentsDir: ${config.componentsDir}`);
+    // --ds bootstraps the project with a system in one step (tokens + philosophy
+    // + rules + CLAUDE.md all arrive via `add`).
+    if (opts.ds) {
+        console.log("");
+        await add(opts.ds, { registry: opts.registry, dir: root });
+        return;
+    }
     console.log("");
     console.log("Next steps:");
-    console.log("  • synthesisui add <slug>            bring a design system in");
+    console.log("  • synthesisui add <slug>              bring a design system in");
     console.log("  • synthesisui page <slug> <template>  materialize a full page");
 }

package/dist/config.js

@@ -39,6 +39,7 @@ export async function writeToken(token, registry) {
 export const DEFAULT_CONFIG = {
     target: "next",
     pagesDir: "app",
+    componentsDir: "components",
 };
 const projectConfigPath = (root) => join(root, "_synthesisui", "config.json");
 /** Reads the project config, falling back to defaults when absent/invalid. */
@@ -51,6 +52,9 @@ export async function readProjectConfig(root) {
             pagesDir: typeof parsed.pagesDir === "string" && parsed.pagesDir
                 ? parsed.pagesDir
                 : DEFAULT_CONFIG.pagesDir,
+            componentsDir: typeof parsed.componentsDir === "string" && parsed.componentsDir
+                ? parsed.componentsDir
+                : DEFAULT_CONFIG.componentsDir,
         };
     }
     catch {

package/dist/guide.js

@@ -123,13 +123,21 @@ place** - wire real data, split into components, swap the chart/icon/media place
 `
         : "";
     const hasRules = (payload.rules?.length ?? 0) > 0;
-    const rulesNote = hasRules
+    const philosophy = payload.document.philosophy;
+    const hasPhilosophy = (philosophy?.sections?.length ?? 0) > 0 || !!philosophy?.context;
+    const readFirst = [
+        hasRules
+            ? `**Read \`_synthesisui/ds/${slug}/rules.md\` FIRST and obey it above everything else** - it carries this system's accumulated, project-specific rules; on any conflict they win.`
+            : "",
+        hasPhilosophy
+            ? `**${hasRules ? "Then read" : "Read"} \`_synthesisui/ds/${slug}/philosophy.md\`** - the mission, principles, voice and motion doctrine. Let it shape every screen you build.`
+            : "",
+    ].filter(Boolean);
+    const rulesNote = readFirst.length > 0
         ? `
-## Rules - highest authority
+## Read first - highest authority
 
-**Read \`_synthesisui/ds/${slug}/rules.md\` FIRST and obey it above everything else in this guide.**
-It carries this system's accumulated, project-specific rules; on any conflict they win over the
-generic guidance below.
+${readFirst.map((l) => `- ${l}`).join("\n")}
 
 ---
 `

package/dist/index.js

@@ -11,7 +11,7 @@ const HELP = `synthesisui - bring SynthesisUI design systems into your project
 
 Usage:
   synthesisui login [options]              connect the CLI to your account (device-flow)
-  synthesisui init [options]               write _synthesisui/config.json (target + pages dir)
+  synthesisui init [options]               write _synthesisui/config.json (target, dirs); --ds to bring one in
   synthesisui list [options]               list the published design systems
   synthesisui add <slug> [options]         materialize a DS into _synthesisui/ds/<slug>/
   synthesisui page <slug> <template>       materialize a whole page from a DS template
@@ -22,15 +22,18 @@ Options:
   --registry <url>   registry URL (or env SYNTHESISUI_REGISTRY_URL)
   --dir <path>       consumer project root (default: current directory)
   --version <n>      install a specific version (default: latest)
-  --ds <slug>        target design system for generate (default: the installed one)
+  --ds <slug>        init: bring this DS in right away · generate: target DS (default: installed)
   --name <name>      preferred component name for generate
   --target <t>       page/init target: next | general (default: next)
+  --pages-dir <dir>  init: folder for generated pages (default: app)
+  --components-dir <dir>  init: folder where components live (default: components)
   --out <path>       output path for the generated page (default: <pagesDir>/<file>)
   -h, --help         this help
 
 Examples:
   synthesisui login
   synthesisui init --target next
+  synthesisui init --target next --ds halogen   bootstrap + bring a system in
   synthesisui list
   synthesisui add halogen
   synthesisui add halogen --version 3
@@ -102,7 +105,12 @@ async function main() {
             break;
         case "init": {
             const target = typeof flags.target === "string" ? flags.target : undefined;
-            await init({ dir, target });
+            const pagesDir = typeof flags["pages-dir"] === "string" ? flags["pages-dir"] : undefined;
+            const componentsDir = typeof flags["components-dir"] === "string"
+                ? flags["components-dir"]
+                : undefined;
+            const ds = typeof flags.ds === "string" ? flags.ds : undefined;
+            await init({ dir, registry, target, pagesDir, componentsDir, ds });
             break;
         }
         case "page": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Traz design systems do SynthesisUI para qualquer projeto (materializa em _local/ds/).",
   "type": "module",
   "bin": {