@decantr/cli 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/index.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync } from "fs";
+import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join } from "path";
+import { createInterface } from "readline";
 import { validateEssence, evaluateGuard } from "@decantr/essence-spec";
 import { createResolver, createRegistryClient } from "@decantr/registry";
 var BOLD = "\x1B[1m";
@@ -58,8 +59,20 @@ async function cmdGet(type, id) {
     return;
   }
   const resolver = getResolver();
-  const result = await resolver.resolve(type, id);
+  let result = await resolver.resolve(type, id);
   if (!result) {
+    const apiType = type === "blueprint" ? "blueprints" : `${type}s`;
+    try {
+      const res = await fetch(`https://decantr-registry.fly.dev/v1/${apiType}/${id}`);
+      if (res.ok) {
+        const item = await res.json();
+        if (!item.error) {
+          console.log(JSON.stringify(item, null, 2));
+          return;
+        }
+      }
+    } catch {
+    }
     console.error(error(`${type} "${id}" not found.`));
     process.exitCode = 1;
     return;
@@ -117,32 +130,176 @@ async function cmdList(type) {
   }
   const { readdirSync } = await import("fs");
   const dir = join(getContentRoot(), type);
+  let found = false;
   try {
     const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
-    console.log(heading(`${files.length} ${type}`));
-    for (const f of files) {
-      const data = JSON.parse(readFileSync(join(dir, f), "utf-8"));
-      console.log(`  ${cyan(data.id || f.replace(".json", ""))}  ${dim(data.description || data.name || "")}`);
+    if (files.length > 0) {
+      found = true;
+      console.log(heading(`${files.length} ${type}`));
+      for (const f of files) {
+        const data = JSON.parse(readFileSync(join(dir, f), "utf-8"));
+        console.log(`  ${cyan(data.id || f.replace(".json", ""))}  ${dim(data.description || data.name || "")}`);
+      }
     }
   } catch {
-    const coreDir = join(getContentRoot(), "core", type);
+  }
+  if (!found) {
     try {
-      const files = readdirSync(coreDir).filter((f) => f.endsWith(".json"));
-      console.log(heading(`${files.length} ${type} (core)`));
-      for (const f of files) {
-        const data = JSON.parse(readFileSync(join(coreDir, f), "utf-8"));
-        console.log(`  ${cyan(data.id || f.replace(".json", ""))}  ${dim(data.description || data.name || "")}`);
+      const res = await fetch(`https://decantr-registry.fly.dev/v1/${type}`);
+      if (res.ok) {
+        const data = await res.json();
+        console.log(heading(`${data.total} ${type}`));
+        for (const item of data.items) {
+          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
+        }
+        return;
       }
     } catch {
-      console.log(dim(`No ${type} found.`));
     }
+    console.log(dim(`No ${type} found.`));
   }
 }
+function ask(question, defaultValue) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = defaultValue ? `${question} ${dim(`(${defaultValue})`)}: ` : `${question}: `;
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim() || defaultValue || "");
+    });
+  });
+}
+async function select(question, options, defaultIdx = 0) {
+  console.log(`
+${BOLD}${question}${RESET}`);
+  for (let i = 0; i < options.length; i++) {
+    const marker = i === defaultIdx ? `${GREEN}>${RESET}` : " ";
+    console.log(`  ${marker} ${i + 1}. ${options[i]}`);
+  }
+  const answer = await ask(`Choose (1-${options.length})`, String(defaultIdx + 1));
+  const idx = parseInt(answer, 10) - 1;
+  return options[Math.max(0, Math.min(idx, options.length - 1))];
+}
+async function cmdInit() {
+  console.log(heading("Create a new Decantr project"));
+  const essencePath = join(process.cwd(), "decantr.essence.json");
+  if (existsSync(essencePath)) {
+    const overwrite = await ask("decantr.essence.json already exists. Overwrite?", "n");
+    if (overwrite.toLowerCase() !== "y") {
+      console.log(dim("Cancelled."));
+      return;
+    }
+  }
+  let archetypes = [];
+  try {
+    const res = await fetch("https://decantr-registry.fly.dev/v1/archetypes");
+    if (res.ok) {
+      const data = await res.json();
+      archetypes = data.items;
+    }
+  } catch {
+  }
+  if (archetypes.length === 0) {
+    archetypes = [
+      { id: "saas-dashboard", description: "Analytics dashboard with KPIs and data tables" },
+      { id: "ecommerce", description: "Online store with product catalog" },
+      { id: "portfolio", description: "Personal or agency portfolio site" },
+      { id: "marketing-landing", description: "Product marketing landing page" },
+      { id: "gaming-platform", description: "Gaming community hub" },
+      { id: "content-site", description: "Blog or content site" }
+    ];
+  }
+  const archetypeOptions = archetypes.map((a) => `${a.id} ${dim(`\u2014 ${a.description || ""}`)}`);
+  const selectedArchetype = await select("What are you building?", archetypeOptions);
+  const archetypeId = selectedArchetype.split(" ")[0];
+  let themes = [];
+  try {
+    const res = await fetch("https://decantr-registry.fly.dev/v1/themes");
+    if (res.ok) {
+      const data = await res.json();
+      themes = data.items;
+    }
+  } catch {
+  }
+  if (themes.length === 0) {
+    themes = [
+      { id: "luminarum", description: "Dark geometric canvas with vibrant accents" },
+      { id: "clean", description: "Professional, minimal, universal" },
+      { id: "glassmorphism", description: "Frosted glass aesthetic" }
+    ];
+  }
+  const themeOptions = themes.map((t) => `${t.id} ${dim(`\u2014 ${t.description || ""}`)}`);
+  const selectedTheme = await select("Choose a theme", themeOptions);
+  const themeId = selectedTheme.split(" ")[0];
+  const mode = await select("Mode", ["dark", "light"], 0);
+  const shape = await select("Shape", ["pill", "rounded", "sharp"], 0);
+  const target = await select("Target framework", ["react", "vue", "svelte", "html"], 0);
+  let pages = [];
+  try {
+    const res = await fetch(`https://decantr-registry.fly.dev/v1/archetypes/${archetypeId}`);
+    if (res.ok) {
+      const data = await res.json();
+      if (data.pages) pages = data.pages;
+    }
+  } catch {
+  }
+  const structure = pages.length > 0 ? pages.map((p) => ({
+    id: p.id,
+    shell: p.shell || "sidebar-main",
+    layout: p.default_layout || []
+  })) : [{ id: "home", shell: "full-bleed", layout: ["hero-split"] }];
+  let features = [];
+  try {
+    const res = await fetch(`https://decantr-registry.fly.dev/v1/archetypes/${archetypeId}`);
+    if (res.ok) {
+      const data = await res.json();
+      if (data.features) features = data.features;
+    }
+  } catch {
+  }
+  const essence = {
+    version: "2.0.0",
+    archetype: archetypeId,
+    theme: {
+      style: themeId,
+      mode,
+      recipe: themeId,
+      shape
+    },
+    personality: ["professional"],
+    platform: { type: "spa", routing: "hash" },
+    structure,
+    features,
+    guard: { enforce_style: true, enforce_recipe: true, mode: "strict" },
+    density: { level: "comfortable", content_gap: "_gap4" },
+    target
+  };
+  writeFileSync(essencePath, JSON.stringify(essence, null, 2) + "\n");
+  console.log(success(`
+Created decantr.essence.json`));
+  console.log(dim(`  Archetype: ${archetypeId}`));
+  console.log(dim(`  Theme: ${themeId} (${mode})`));
+  console.log(dim(`  Pages: ${structure.map((s) => s.id).join(", ")}`));
+  console.log(dim(`  Target: ${target}`));
+  const validation = validateEssence(essence);
+  if (validation.valid) {
+    console.log(success("  Validation: passed"));
+  } else {
+    console.log(error(`  Validation: ${validation.errors.join(", ")}`));
+  }
+  console.log(heading("Next steps"));
+  console.log(`  1. Open your AI assistant (Claude, Cursor, etc.)`);
+  console.log(`  2. Tell it to read ${cyan("decantr.essence.json")} before generating code`);
+  console.log(`  3. The essence file defines your theme, pages, and patterns`);
+  console.log(`  4. Run ${cyan("decantr validate")} after changes to check for drift
+`);
+}
 function cmdHelp() {
   console.log(`
 ${BOLD}decantr${RESET} \u2014 Design intelligence for AI-generated UI
 
 ${BOLD}Usage:${RESET}
+  decantr init
   decantr search <query> [--type pattern|archetype|recipe|theme]
   decantr get <type> <id>
   decantr list <type>
@@ -150,6 +307,7 @@ ${BOLD}Usage:${RESET}
   decantr help
 
 ${BOLD}Commands:${RESET}
+  ${cyan("init")}      Create a new decantr.essence.json \u2014 pick an archetype, theme, and target
   ${cyan("search")}    Search the registry for patterns, archetypes, recipes, themes
   ${cyan("get")}       Get full details of a registry item as JSON
   ${cyan("list")}      List all items of a type (patterns, archetypes, recipes, themes, blueprints)
@@ -157,15 +315,13 @@ ${BOLD}Commands:${RESET}
   ${cyan("help")}      Show this help message
 
 ${BOLD}Examples:${RESET}
+  decantr init
   decantr search dashboard
   decantr search kpi --type pattern
   decantr get pattern kpi-grid
   decantr get recipe luminarum
-  decantr get theme luminarum
   decantr list patterns
-  decantr list themes
   decantr validate
-  decantr validate ./my-project/decantr.essence.json
 `);
 }
 async function main() {
@@ -176,6 +332,10 @@ async function main() {
     return;
   }
   switch (command) {
+    case "init": {
+      await cmdInit();
+      break;
+    }
     case "search": {
       const query = args[1];
       if (!query) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.5",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {