@decantr/cli 1.0.0 → 1.1.0

package/dist/index.js

@@ -2,16 +2,17 @@
 import {
   RegistryClient,
   syncRegistry
-} from "./chunk-PWTUBGGJ.js";
+} from "./chunk-K6MIDPQH.js";
 import {
   __require
 } from "./chunk-PDX44BCA.js";
 
 // src/index.ts
-import { readFileSync as readFileSync4, existsSync as existsSync4 } from "fs";
-import { join as join4 } from "path";
+import { readFileSync as readFileSync6, existsSync as existsSync7 } from "fs";
+import { join as join7, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { validateEssence, evaluateGuard } from "@decantr/essence-spec";
-import { createResolver, createRegistryClient } from "@decantr/registry";
+import { RegistryAPIClient as RegistryAPIClient2 } from "@decantr/registry";
 
 // src/detect.ts
 import { existsSync, readFileSync } from "fs";
@@ -370,6 +371,148 @@ import { join as join2, dirname } from "path";
 import { fileURLToPath } from "url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var CLI_VERSION = "1.0.0";
+function generateTokensCSS(themeData, mode) {
+  if (!themeData) {
+    return `/* No theme data available */
+:root {
+  --d-primary: #6366f1;
+  --d-secondary: #a1a1aa;
+  --d-accent: #f59e0b;
+  --d-bg: #18181b;
+  --d-surface: #1f1f23;
+  --d-surface-raised: #27272a;
+  --d-border: #3f3f46;
+  --d-text: #fafafa;
+  --d-text-muted: #a1a1aa;
+}
+`;
+  }
+  const seed = themeData.seed || {};
+  const palette = themeData.palette || {};
+  const tokens = {
+    // Seed colors
+    "--d-primary": seed.primary || "#6366f1",
+    "--d-secondary": seed.secondary || "#a1a1aa",
+    "--d-accent": seed.accent || "#f59e0b",
+    // Palette colors (mode-aware)
+    "--d-bg": palette.background?.[mode] || "#18181b",
+    "--d-surface": palette.surface?.[mode] || "#1f1f23",
+    "--d-surface-raised": palette["surface-raised"]?.[mode] || "#27272a",
+    "--d-border": palette.border?.[mode] || "#3f3f46",
+    "--d-text": palette.text?.[mode] || "#fafafa",
+    "--d-text-muted": palette["text-muted"]?.[mode] || "#a1a1aa",
+    "--d-primary-hover": palette["primary-hover"]?.[mode] || seed.primary || "#6366f1",
+    // Spacing scale
+    "--d-gap-1": "0.25rem",
+    "--d-gap-2": "0.5rem",
+    "--d-gap-3": "0.75rem",
+    "--d-gap-4": "1rem",
+    "--d-gap-6": "1.5rem",
+    "--d-gap-8": "2rem",
+    "--d-gap-12": "3rem",
+    // Radii
+    "--d-radius": "0.5rem",
+    "--d-radius-sm": "0.25rem",
+    "--d-radius-lg": "0.75rem",
+    "--d-radius-xl": "1rem",
+    "--d-radius-full": "9999px",
+    // Shadows
+    "--d-shadow-sm": "0 1px 2px rgba(0,0,0,0.05)",
+    "--d-shadow": "0 1px 3px rgba(0,0,0,0.1)",
+    "--d-shadow-md": "0 4px 6px rgba(0,0,0,0.1)",
+    "--d-shadow-lg": "0 10px 15px rgba(0,0,0,0.1)",
+    // Status colors
+    "--d-success": themeData.tokens?.base?.success || "#22c55e",
+    "--d-error": themeData.tokens?.base?.danger || "#ef4444",
+    "--d-warning": themeData.tokens?.base?.warning || "#f59e0b",
+    "--d-info": "#3b82f6"
+  };
+  const lines = Object.entries(tokens).map(([key, value]) => `  ${key}: ${value};`).join("\n");
+  return `/* Generated by @decantr/cli */
+:root {
+${lines}
+}
+`;
+}
+function generateDecoratorsCSS(recipeData, themeName) {
+  if (!recipeData?.decorators) {
+    return `/* No recipe decorators available */`;
+  }
+  const decorators = recipeData.decorators;
+  const css = [
+    `/* Generated by @decantr/cli from recipe: ${themeName} */`,
+    ""
+  ];
+  for (const [name, description] of Object.entries(decorators)) {
+    css.push(generateDecoratorRule(name, description));
+    css.push("");
+  }
+  css.push(`/* Animation keyframes */
+@keyframes decantr-fade-in {
+  from { opacity: 0; transform: translateY(8px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+@keyframes decantr-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.5; }
+}
+`);
+  return css.join("\n");
+}
+function generateDecoratorRule(name, description) {
+  const rules = [];
+  const descLower = description.toLowerCase();
+  if (descLower.includes("surface background") || descLower.includes("surface elevation")) {
+    rules.push("background: var(--d-surface)");
+  } else if (descLower.includes("background") && descLower.includes("theme")) {
+    rules.push("background: var(--d-bg)");
+  } else if (descLower.includes("primary-tinted") || descLower.includes("primary background")) {
+    rules.push("background: color-mix(in srgb, var(--d-primary) 15%, var(--d-surface))");
+  }
+  if (descLower.includes("1px border") || descLower.includes("subtle border")) {
+    rules.push("border: 1px solid var(--d-border)");
+  } else if (descLower.includes("border") && !descLower.includes("radius")) {
+    rules.push("border: 1px solid var(--d-border)");
+  }
+  const radiusMatch = descLower.match(/(\d+)px radius/);
+  if (radiusMatch) {
+    rules.push(`border-radius: ${radiusMatch[1]}px`);
+  } else if (descLower.includes("radius") || descLower.includes("rounded")) {
+    rules.push("border-radius: var(--d-radius)");
+  }
+  if (descLower.includes("hover shadow") || descLower.includes("shadow transition")) {
+    rules.push("transition: box-shadow 0.15s ease");
+  }
+  if (descLower.includes("elevation") || descLower.includes("shadow")) {
+    rules.push("box-shadow: var(--d-shadow)");
+  }
+  if (descLower.includes("entrance animation") || descLower.includes("fade")) {
+    rules.push("animation: decantr-fade-in 0.2s ease-out");
+  }
+  if (descLower.includes("pulse animation") || descLower.includes("skeleton")) {
+    rules.push("animation: decantr-pulse 1.5s ease-in-out infinite");
+  }
+  if (descLower.includes("blur") || descLower.includes("glass")) {
+    rules.push("backdrop-filter: blur(8px)");
+  }
+  if (descLower.includes("right-aligned")) {
+    rules.push("margin-left: auto");
+  } else if (descLower.includes("left-aligned")) {
+    rules.push("margin-right: auto");
+  }
+  if (descLower.includes("message bubble") || descLower.includes("bubble")) {
+    rules.push("padding: var(--d-gap-3) var(--d-gap-4)");
+    rules.push("border-radius: var(--d-radius-lg)");
+    rules.push("max-width: 80%");
+  }
+  if (rules.length === 0) {
+    return `/* .${name}: ${description} */`;
+  }
+  return `.${name} {
+  ${rules.join(";\n  ")};
+}`;
+}
 function serializeLayoutItem(item) {
   if (typeof item === "string") {
     return item;
@@ -771,7 +914,7 @@ ${cacheEntry}
     return true;
   }
 }
-function scaffoldProject(projectRoot, options, detected, archetypeData, registrySource = "bundled", themeData, recipeData) {
+function scaffoldProject(projectRoot, options, detected, archetypeData, registrySource = "cache", themeData, recipeData) {
   const essence = buildEssence(options, archetypeData);
   const decantrDir = join2(projectRoot, ".decantr");
   const contextDir = join2(decantrDir, "context");
@@ -797,12 +940,145 @@ function scaffoldProject(projectRoot, options, detected, archetypeData, registry
   const summaryPath = join2(contextDir, "essence-summary.md");
   writeFileSync(summaryPath, generateEssenceSummary(essence));
   contextFiles.push(summaryPath);
+  const stylesDir = join2(projectRoot, "src", "styles");
+  mkdirSync(stylesDir, { recursive: true });
+  const tokensPath = join2(stylesDir, "tokens.css");
+  writeFileSync(tokensPath, generateTokensCSS(themeData, essence.theme.mode));
+  const decoratorsPath = join2(stylesDir, "decorators.css");
+  writeFileSync(decoratorsPath, generateDecoratorsCSS(recipeData, essence.theme.style));
   const gitignoreUpdated = updateGitignore(projectRoot);
   return {
     essencePath,
     decantrMdPath,
     projectJsonPath,
     contextFiles,
+    cssFiles: [tokensPath, decoratorsPath],
+    gitignoreUpdated
+  };
+}
+function scaffoldMinimal(projectRoot) {
+  const decantrDir = join2(projectRoot, ".decantr");
+  const customDir = join2(decantrDir, "custom");
+  const contentTypes = ["patterns", "recipes", "themes", "blueprints", "archetypes", "shells"];
+  for (const type of contentTypes) {
+    mkdirSync(join2(customDir, type), { recursive: true });
+  }
+  const essence = {
+    version: "2.0.0",
+    archetype: "custom",
+    theme: {
+      style: "default",
+      mode: "dark",
+      recipe: "default",
+      shape: "rounded"
+    },
+    personality: ["clean", "modern"],
+    platform: {
+      type: "spa",
+      routing: "hash"
+    },
+    structure: [
+      { id: "home", shell: "sidebar-main", layout: ["hero"] }
+    ],
+    features: [],
+    guard: {
+      enforce_style: true,
+      enforce_recipe: true,
+      mode: "guided"
+    },
+    density: {
+      level: "comfortable",
+      content_gap: "_gap4"
+    },
+    target: "react"
+  };
+  const essencePath = join2(projectRoot, "decantr.essence.json");
+  writeFileSync(essencePath, JSON.stringify(essence, null, 2) + "\n");
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const projectJson = {
+    detected: {
+      framework: "unknown",
+      version: null,
+      packageManager: "npm",
+      hasTypeScript: false,
+      hasTailwind: false,
+      existingRuleFiles: []
+    },
+    overrides: {
+      framework: null
+    },
+    sync: {
+      status: "needs-sync",
+      lastSync: now,
+      registrySource: "cache",
+      cachedContent: {
+        archetypes: [],
+        patterns: [],
+        themes: [],
+        recipes: []
+      }
+    },
+    initialized: {
+      at: now,
+      via: "cli",
+      version: CLI_VERSION,
+      flags: "--offline --minimal"
+    }
+  };
+  const projectJsonPath = join2(decantrDir, "project.json");
+  writeFileSync(projectJsonPath, JSON.stringify(projectJson, null, 2));
+  const decantrMdPath = join2(projectRoot, "DECANTR.md");
+  const decantrMdContent = `# DECANTR.md
+
+> This file was generated by \`decantr init\` in offline/minimal mode.
+> Run \`decantr upgrade\` when online to pull full registry content.
+
+## Guard Mode: guided
+
+## Project Summary
+
+**Archetype:** custom
+**Target:** react
+**Theme:** default (dark mode)
+**Guard Mode:** guided
+**Pages:** home
+
+## Pages
+
+| Page | Shell | Layout |
+|------|-------|--------|
+| home | sidebar-main | hero |
+
+## Quick Start
+
+1. Edit \`decantr.essence.json\` to define your project structure.
+2. Run \`decantr sync\` when online to fetch registry content.
+3. Use \`decantr create <type> <name>\` to create custom content.
+4. Use \`decantr search <query>\` to find patterns and themes.
+5. Use \`decantr validate\` to check your essence file.
+
+## Commands
+
+- \`decantr status\` \u2014 Project health
+- \`decantr search\` \u2014 Search the registry
+- \`decantr get <type> <id>\` \u2014 Fetch content details
+- \`decantr validate\` \u2014 Validate essence file
+- \`decantr sync\` \u2014 Sync registry content
+- \`decantr create <type> <name>\` \u2014 Create custom content
+- \`decantr publish <type> <name>\` \u2014 Publish to community registry
+
+---
+
+*Generated by @decantr/cli v${CLI_VERSION}*
+`;
+  writeFileSync(decantrMdPath, decantrMdContent);
+  const gitignoreUpdated = updateGitignore(projectRoot);
+  return {
+    essencePath,
+    decantrMdPath,
+    projectJsonPath,
+    contextFiles: [],
+    cssFiles: [],
     gitignoreUpdated
   };
 }
@@ -1029,6 +1305,155 @@ function importTheme(projectRoot, sourcePath) {
   };
 }
 
+// src/auth.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, rmSync as rmSync2 } from "fs";
+import { join as join4 } from "path";
+import { homedir } from "os";
+var CONFIG_DIR = join4(homedir(), ".config", "decantr");
+var AUTH_FILE = join4(CONFIG_DIR, "auth.json");
+function getCredentials() {
+  if (!existsSync4(AUTH_FILE)) return null;
+  try {
+    return JSON.parse(readFileSync4(AUTH_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveCredentials(creds) {
+  mkdirSync3(CONFIG_DIR, { recursive: true });
+  writeFileSync3(AUTH_FILE, JSON.stringify(creds, null, 2));
+}
+function clearCredentials() {
+  if (existsSync4(AUTH_FILE)) {
+    rmSync2(AUTH_FILE);
+  }
+}
+function getApiKeyOrToken() {
+  const creds = getCredentials();
+  if (!creds) return null;
+  return creds.api_key || creds.access_token || null;
+}
+
+// src/commands/publish.ts
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { join as join5 } from "path";
+import { RegistryAPIClient } from "@decantr/registry";
+var PLURAL_TO_SINGULAR = {
+  patterns: "pattern",
+  recipes: "recipe",
+  themes: "theme",
+  blueprints: "blueprint",
+  archetypes: "archetype",
+  shells: "shell"
+};
+var SINGULAR_TO_PLURAL = {
+  pattern: "patterns",
+  recipe: "recipes",
+  theme: "themes",
+  blueprint: "blueprints",
+  archetype: "archetypes",
+  shell: "shells"
+};
+async function cmdPublish(type, name, projectRoot = process.cwd()) {
+  const token = getApiKeyOrToken();
+  if (!token) {
+    console.error("Not authenticated. Run `decantr login` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const singularType = PLURAL_TO_SINGULAR[type] || type;
+  const pluralType = SINGULAR_TO_PLURAL[type] || SINGULAR_TO_PLURAL[singularType] || `${type}s`;
+  const customPath = join5(projectRoot, ".decantr", "custom", pluralType, `${name}.json`);
+  if (!existsSync5(customPath)) {
+    console.error(`Custom ${singularType} "${name}" not found at ${customPath}`);
+    console.error(`Create one first: decantr create ${singularType} ${name}`);
+    process.exitCode = 1;
+    return;
+  }
+  let data;
+  try {
+    data = JSON.parse(readFileSync5(customPath, "utf-8"));
+  } catch {
+    console.error(`Failed to parse ${customPath}`);
+    process.exitCode = 1;
+    return;
+  }
+  const client = new RegistryAPIClient({
+    apiKey: token
+  });
+  try {
+    const result = await client.publishContent({
+      type: pluralType,
+      slug: name,
+      version: data.version || "1.0.0",
+      data,
+      namespace: "@community",
+      visibility: "public"
+    });
+    console.log(`Published ${singularType}/${name} to @community`);
+    console.log(`Status: ${result.status}`);
+  } catch (err) {
+    console.error(`Failed to publish: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/create.ts
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
+import { join as join6 } from "path";
+var CONTENT_TYPES = ["pattern", "recipe", "theme", "blueprint", "archetype", "shell"];
+var PLURAL = {
+  pattern: "patterns",
+  recipe: "recipes",
+  theme: "themes",
+  blueprint: "blueprints",
+  archetype: "archetypes",
+  shell: "shells"
+};
+function getSkeleton(type, id, name) {
+  const base = {
+    id,
+    name,
+    description: "",
+    version: "1.0.0",
+    source: "custom"
+  };
+  switch (type) {
+    case "pattern":
+      return { ...base, components: [], presets: {}, layout: {} };
+    case "recipe":
+      return { ...base, shell: {}, spatial: {}, effects: {} };
+    case "theme":
+      return { ...base, seed: { primary: "#6500C6", secondary: "#0AF3EB", accent: "#F58882", background: "#0D0D1A" }, modes: ["dark"], shapes: ["rounded"] };
+    case "blueprint":
+      return { ...base, compose: [], theme: {}, personality: [] };
+    case "archetype":
+      return { ...base, pages: [], features: [], suggested_theme: "" };
+    case "shell":
+      return { ...base, regions: [], layout: "sidebar-main" };
+  }
+}
+function cmdCreate(type, name, projectRoot = process.cwd()) {
+  if (!CONTENT_TYPES.includes(type)) {
+    console.error(`Invalid type "${type}". Must be one of: ${CONTENT_TYPES.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const plural = PLURAL[type];
+  const customDir = join6(projectRoot, ".decantr", "custom", plural);
+  const filePath = join6(customDir, `${name}.json`);
+  if (existsSync6(filePath)) {
+    console.error(`${type} "${name}" already exists at ${filePath}`);
+    process.exitCode = 1;
+    return;
+  }
+  mkdirSync4(customDir, { recursive: true });
+  const skeleton = getSkeleton(type, name, name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()));
+  writeFileSync4(filePath, JSON.stringify(skeleton, null, 2));
+  console.log(`Created ${type} "${name}" at ${filePath}`);
+  console.log(`Edit it, then publish with: decantr publish ${type} ${name}`);
+}
+
 // src/index.ts
 var BOLD2 = "\x1B[1m";
 var DIM2 = "\x1B[2m";
@@ -1109,58 +1534,67 @@ ${sep}
 ${body}
 ${bottom}`;
 }
-function getContentRoot() {
-  const bundled = join4(import.meta.dirname, "..", "..", "..", "content");
-  return process.env.DECANTR_CONTENT_ROOT || bundled;
-}
-function getResolver() {
-  return createResolver({ contentRoot: getContentRoot() });
+function getAPIClient() {
+  return new RegistryAPIClient2({
+    baseUrl: process.env.DECANTR_API_URL || void 0,
+    apiKey: process.env.DECANTR_API_KEY || void 0
+  });
 }
 async function cmdSearch(query, type) {
-  const client = createRegistryClient();
-  const results = await client.search(query, type);
-  if (results.length === 0) {
-    console.log(dim(`No results for "${query}"`));
-    return;
-  }
-  console.log(heading(`${results.length} result(s) for "${query}"`));
-  for (const r of results) {
-    console.log(`  ${cyan(r.type.padEnd(12))} ${BOLD2}${r.id}${RESET2}`);
-    console.log(`  ${dim(r.description || "")}`);
-    console.log("");
+  const apiClient = getAPIClient();
+  try {
+    const response = await apiClient.search({ q: query, type });
+    const results = response.results;
+    if (results.length === 0) {
+      console.log(dim(`No results for "${query}"`));
+      return;
+    }
+    console.log(heading(`${results.length} result(s) for "${query}"`));
+    for (const r of results) {
+      console.log(`  ${cyan(r.type.padEnd(12))} ${BOLD2}${r.slug}${RESET2}`);
+      console.log(`  ${dim(r.description || "")}`);
+      console.log("");
+    }
+  } catch {
+    console.log(dim(`Search failed. API may be unavailable.`));
   }
 }
 async function cmdSuggest(query, type) {
-  const client = createRegistryClient();
+  const apiClient = getAPIClient();
   const searchType = type || "pattern";
-  const results = await client.search(query, searchType);
-  if (results.length === 0) {
-    console.log(dim(`No suggestions for "${query}"`));
-    console.log("");
-    console.log("Try:");
-    console.log(`  ${cyan("decantr list patterns")} - see all patterns`);
-    console.log(`  ${cyan("decantr search <broader-term>")} - broaden your search`);
-    return;
-  }
-  console.log(heading(`Suggestions for "${query}"`));
-  const queryLower = query.toLowerCase();
-  const exact = results.filter((r) => r.id.toLowerCase().includes(queryLower));
-  const related = results.filter((r) => !r.id.toLowerCase().includes(queryLower));
-  if (exact.length > 0) {
-    console.log(`${BOLD2}Direct matches:${RESET2}`);
-    for (const r of exact.slice(0, 3)) {
-      console.log(`  ${cyan(r.id)} - ${r.description || ""}`);
+  try {
+    const response = await apiClient.search({ q: query, type: searchType });
+    const results = response.results;
+    if (results.length === 0) {
+      console.log(dim(`No suggestions for "${query}"`));
+      console.log("");
+      console.log("Try:");
+      console.log(`  ${cyan("decantr list patterns")} - see all patterns`);
+      console.log(`  ${cyan("decantr search <broader-term>")} - broaden your search`);
+      return;
     }
-    console.log("");
-  }
-  if (related.length > 0) {
-    console.log(`${BOLD2}Related:${RESET2}`);
-    for (const r of related.slice(0, 5)) {
-      console.log(`  ${cyan(r.id)} - ${r.description || ""}`);
+    console.log(heading(`Suggestions for "${query}"`));
+    const queryLower = query.toLowerCase();
+    const exact = results.filter((r) => r.slug.toLowerCase().includes(queryLower));
+    const related = results.filter((r) => !r.slug.toLowerCase().includes(queryLower));
+    if (exact.length > 0) {
+      console.log(`${BOLD2}Direct matches:${RESET2}`);
+      for (const r of exact.slice(0, 3)) {
+        console.log(`  ${cyan(r.slug)} - ${r.description || ""}`);
+      }
+      console.log("");
     }
-    console.log("");
+    if (related.length > 0) {
+      console.log(`${BOLD2}Related:${RESET2}`);
+      for (const r of related.slice(0, 5)) {
+        console.log(`  ${cyan(r.slug)} - ${r.description || ""}`);
+      }
+      console.log("");
+    }
+    console.log(dim(`Use "decantr get pattern <id>" for full details`));
+  } catch {
+    console.log(dim(`Suggestion search failed. API may be unavailable.`));
   }
-  console.log(dim(`Use "decantr get pattern <id>" for full details`));
 }
 async function cmdGet(type, id) {
   const validTypes = ["pattern", "archetype", "recipe", "theme", "blueprint", "shell"];
@@ -1169,64 +1603,60 @@ async function cmdGet(type, id) {
     process.exitCode = 1;
     return;
   }
-  if (type === "shell") {
-    const registryClient = new RegistryClient({
-      cacheDir: join4(process.cwd(), ".decantr", "cache")
-    });
-    const shellResult = await registryClient.fetchShell(id);
-    if (shellResult) {
-      console.log(JSON.stringify(shellResult.data, null, 2));
-      return;
-    }
-    console.error(error(`shell "${id}" not found.`));
-    process.exitCode = 1;
+  const typeMap = {
+    pattern: "patterns",
+    archetype: "archetypes",
+    recipe: "recipes",
+    theme: "themes",
+    blueprint: "blueprints",
+    shell: "shells"
+  };
+  const apiType = typeMap[type];
+  const registryClient = new RegistryClient({
+    cacheDir: join7(process.cwd(), ".decantr", "cache")
+  });
+  const result = await registryClient.fetchContentItem(apiType, id);
+  if (result) {
+    console.log(JSON.stringify(result.data, null, 2));
     return;
   }
-  const resolver = getResolver();
-  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;
+  const currentDir = dirname2(fileURLToPath2(import.meta.url));
+  const bundledFromDist = join7(currentDir, "..", "src", "bundled", apiType, `${id}.json`);
+  const bundledFromSrc = join7(currentDir, "bundled", apiType, `${id}.json`);
+  const bundledPath = existsSync7(bundledFromDist) ? bundledFromDist : existsSync7(bundledFromSrc) ? bundledFromSrc : null;
+  if (bundledPath) {
+    const data = JSON.parse(readFileSync6(bundledPath, "utf-8"));
+    console.log(JSON.stringify(data, null, 2));
     return;
   }
-  console.log(JSON.stringify(result.item, null, 2));
+  console.error(error(`${type} "${id}" not found.`));
+  process.exitCode = 1;
+  return;
 }
 function buildRegistryContext() {
   const { readdirSync: readdirSync2 } = __require("fs");
   const themeRegistry = /* @__PURE__ */ new Map();
   const patternRegistry = /* @__PURE__ */ new Map();
-  const contentRoot = getContentRoot();
-  const themeDirs = [join4(contentRoot, "themes"), join4(contentRoot, "core", "themes")];
-  for (const dir of themeDirs) {
-    try {
-      if (existsSync4(dir)) {
-        for (const f of readdirSync2(dir).filter((f2) => f2.endsWith(".json"))) {
-          const data = JSON.parse(readFileSync4(join4(dir, f), "utf-8"));
-          if (data.id && !themeRegistry.has(data.id)) {
-            themeRegistry.set(data.id, { modes: data.modes || ["light", "dark"] });
-          }
+  const projectRoot = process.cwd();
+  const cacheDir = join7(projectRoot, ".decantr", "cache");
+  const customDir = join7(projectRoot, ".decantr", "custom");
+  const cachedThemesDir = join7(cacheDir, "@official", "themes");
+  try {
+    if (existsSync7(cachedThemesDir)) {
+      for (const f of readdirSync2(cachedThemesDir).filter((f2) => f2.endsWith(".json") && f2 !== "index.json")) {
+        const data = JSON.parse(readFileSync6(join7(cachedThemesDir, f), "utf-8"));
+        if (data.id && !themeRegistry.has(data.id)) {
+          themeRegistry.set(data.id, { modes: data.modes || ["light", "dark"] });
         }
       }
-    } catch {
     }
+  } catch {
   }
-  const customThemesDir = join4(process.cwd(), ".decantr", "custom", "themes");
+  const customThemesDir = join7(customDir, "themes");
   try {
-    if (existsSync4(customThemesDir)) {
+    if (existsSync7(customThemesDir)) {
       for (const f of readdirSync2(customThemesDir).filter((f2) => f2.endsWith(".json"))) {
-        const data = JSON.parse(readFileSync4(join4(customThemesDir, f), "utf-8"));
+        const data = JSON.parse(readFileSync6(join7(customThemesDir, f), "utf-8"));
         if (data.id) {
           themeRegistry.set(`custom:${data.id}`, { modes: data.modes || ["light", "dark"] });
         }
@@ -1234,27 +1664,25 @@ function buildRegistryContext() {
     }
   } catch {
   }
-  const patternDirs = [join4(contentRoot, "patterns"), join4(contentRoot, "core", "patterns")];
-  for (const dir of patternDirs) {
-    try {
-      if (existsSync4(dir)) {
-        for (const f of readdirSync2(dir).filter((f2) => f2.endsWith(".json"))) {
-          const data = JSON.parse(readFileSync4(join4(dir, f), "utf-8"));
-          if (data.id && !patternRegistry.has(data.id)) {
-            patternRegistry.set(data.id, data);
-          }
+  const cachedPatternsDir = join7(cacheDir, "@official", "patterns");
+  try {
+    if (existsSync7(cachedPatternsDir)) {
+      for (const f of readdirSync2(cachedPatternsDir).filter((f2) => f2.endsWith(".json") && f2 !== "index.json")) {
+        const data = JSON.parse(readFileSync6(join7(cachedPatternsDir, f), "utf-8"));
+        if (data.id && !patternRegistry.has(data.id)) {
+          patternRegistry.set(data.id, data);
         }
       }
-    } catch {
     }
+  } catch {
   }
   return { themeRegistry, patternRegistry };
 }
 async function cmdValidate(path) {
-  const essencePath = path || join4(process.cwd(), "decantr.essence.json");
+  const essencePath = path || join7(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync4(essencePath, "utf-8");
+    raw = readFileSync6(essencePath, "utf-8");
   } catch {
     console.error(error(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -1303,110 +1731,40 @@ async function cmdList(type) {
     process.exitCode = 1;
     return;
   }
-  if (type === "shells") {
-    const registryClient = new RegistryClient({
-      cacheDir: join4(process.cwd(), ".decantr", "cache")
-    });
-    const shellsResult = await registryClient.fetchShells();
-    for (const item of shellsResult.data.items) {
-      console.log(`  ${item.id}${item.description ? ` \u2014 ${item.description}` : ""}`);
-    }
-    console.log(`
-${shellsResult.data.total} shells found`);
+  const registryClient = new RegistryClient({
+    cacheDir: join7(process.cwd(), ".decantr", "cache")
+  });
+  const result = await registryClient.fetchContentList(type);
+  const items = result.data.items;
+  if (items.length === 0) {
+    console.log(dim(`No ${type} found.`));
     return;
   }
-  const { readdirSync: readdirSync2, existsSync: existsSync5 } = await import("fs");
-  const contentRoot = getContentRoot();
-  const mainDir = join4(contentRoot, type);
-  const coreDir = join4(contentRoot, "core", type);
-  const items = [];
-  try {
-    if (existsSync5(mainDir)) {
-      const files = readdirSync2(mainDir).filter((f) => f.endsWith(".json"));
-      for (const f of files) {
-        const data = JSON.parse(readFileSync4(join4(mainDir, f), "utf-8"));
-        items.push({ id: data.id || f.replace(".json", ""), description: data.description, name: data.name });
-      }
-    }
-  } catch {
-  }
-  try {
-    if (existsSync5(coreDir)) {
-      const files = readdirSync2(coreDir).filter((f) => f.endsWith(".json"));
-      const existingIds = new Set(items.map((i) => i.id));
-      for (const f of files) {
-        const data = JSON.parse(readFileSync4(join4(coreDir, f), "utf-8"));
-        const itemId = data.id || f.replace(".json", "");
-        if (!existingIds.has(itemId)) {
-          items.push({ id: itemId, description: data.description, name: data.name });
-        }
-      }
-    }
-  } catch {
-  }
-  const customItems = [];
   if (type === "themes") {
-    try {
-      const custom = listCustomThemes(process.cwd());
-      for (const theme of custom) {
-        customItems.push({
-          id: `custom:${theme.id}`,
-          description: theme.description,
-          name: theme.name,
-          source: "custom"
-        });
-      }
-    } catch {
+    const customItems = registryClient.listCustomContent("themes");
+    const customIds = new Set(customItems.map((c) => c.id));
+    const registryItems = items.filter((i) => !customIds.has(i.id));
+    console.log(heading(`Registry themes (${registryItems.length}):`));
+    for (const item of registryItems) {
+      console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
     }
-  }
-  if (items.length > 0 || customItems.length > 0) {
-    if (type === "themes") {
-      console.log(heading(`Registry themes (${items.length}):`));
-      for (const item of items) {
-        console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-      }
-      if (customItems.length > 0) {
-        console.log("");
-        console.log(heading(`Custom themes (${customItems.length}):`));
-        for (const item of customItems) {
-          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-        }
-      } else {
-        console.log("");
-        console.log(dim("Custom themes (0):"));
-        console.log(dim('  Run "decantr theme create <name>" to create a custom theme.'));
+    if (customItems.length > 0) {
+      console.log("");
+      console.log(heading(`Custom themes (${customItems.length}):`));
+      for (const item of customItems) {
+        console.log(`  ${cyan(`custom:${item.id}`)}  ${dim(item.description || item.name || "")}`);
       }
     } else {
-      console.log(heading(`${items.length} ${type}`));
-      for (const item of items) {
-        console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-      }
+      console.log("");
+      console.log(dim("Custom themes (0):"));
+      console.log(dim('  Run "decantr theme create <name>" to create a custom theme.'));
     }
-    return;
-  }
-  try {
-    const res = await fetch(`https://decantr-registry.fly.dev/v1/${type}`);
-    if (res.ok) {
-      const data = await res.json();
-      if (type === "themes") {
-        console.log(heading(`Registry themes (${data.total}):`));
-        for (const item of data.items) {
-          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-        }
-        console.log("");
-        console.log(dim("Custom themes (0):"));
-        console.log(dim('  Run "decantr theme create <name>" to create a custom theme.'));
-      } else {
-        console.log(heading(`${data.total} ${type}`));
-        for (const item of data.items) {
-          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-        }
-      }
-      return;
+  } else {
+    console.log(heading(`${items.length} ${type}`));
+    for (const item of items) {
+      console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
     }
-  } catch {
   }
-  console.log(dim(`No ${type} found.`));
 }
 async function cmdInit(args) {
   const projectRoot = process.cwd();
@@ -1421,16 +1779,36 @@ async function cmdInit(args) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join4(projectRoot, ".decantr", "cache"),
+    cacheDir: join7(projectRoot, ".decantr", "cache"),
     apiUrl: args.registry,
     offline: args.offline
   });
   const apiAvailable = await registryClient.checkApiAvailability();
   let selectedBlueprint = "default";
-  let registrySource = "bundled";
+  let registrySource = "cache";
   if (args.yes) {
     selectedBlueprint = args.blueprint || "default";
   } else if (!apiAvailable) {
+    if (!args.blueprint) {
+      console.log(`
+${YELLOW2}You're offline. Scaffolding minimal Decantr project.${RESET2}`);
+      console.log(dim("Run `decantr sync` or `decantr upgrade` when online to pull full registry content.\n"));
+      const result2 = scaffoldMinimal(projectRoot);
+      console.log(success("\nProject scaffolded (minimal/offline)!\n"));
+      console.log("  Files created:");
+      console.log(`    ${cyan("decantr.essence.json")}    Design specification`);
+      console.log(`    ${cyan("DECANTR.md")}              LLM instructions`);
+      console.log(`    ${cyan(".decantr/")}               Project state & custom content dirs`);
+      if (result2.gitignoreUpdated) {
+        console.log(`    ${dim(".gitignore updated")}`);
+      }
+      console.log("");
+      console.log("  Next steps:");
+      console.log(`    1. Run ${cyan("decantr sync")} when online`);
+      console.log(`    2. Use ${cyan("decantr create <type> <name>")} to create custom content`);
+      console.log(`    3. Review DECANTR.md for methodology`);
+      return;
+    }
     console.log(`
 ${YELLOW2}You're offline. Scaffolding Decantr default.${RESET2}`);
     console.log(dim("Run `decantr upgrade` when online, or visit decantr.ai/registry\n"));
@@ -1438,7 +1816,7 @@ ${YELLOW2}You're offline. Scaffolding Decantr default.${RESET2}`);
   } else {
     console.log(dim("Fetching registry content..."));
     const blueprintsResult2 = await registryClient.fetchBlueprints();
-    registrySource = blueprintsResult2.source.type === "api" ? "api" : "bundled";
+    registrySource = blueprintsResult2.source.type === "api" ? "api" : "cache";
     const { selectedBlueprint: selected } = await runSimplifiedInit(
       blueprintsResult2.data.items
     );
@@ -1468,6 +1846,17 @@ ${YELLOW2}You're offline. Scaffolding Decantr default.${RESET2}`);
     const blueprintResult = await registryClient.fetchBlueprint(options.blueprint);
     if (blueprintResult) {
       const blueprint = blueprintResult.data;
+      if (blueprint.theme) {
+        if (blueprint.theme.style && options.theme === "luminarum") {
+          options.theme = blueprint.theme.style;
+        }
+        if (blueprint.theme.mode && options.mode === "dark") {
+          options.mode = blueprint.theme.mode;
+        }
+        if (blueprint.theme.shape && options.shape === "rounded") {
+          options.shape = blueprint.theme.shape;
+        }
+      }
       const primaryArchetype = blueprint.compose?.[0];
       if (primaryArchetype) {
         const archetypeResult = await registryClient.fetchArchetype(primaryArchetype);
@@ -1489,8 +1878,13 @@ ${YELLOW2}You're offline. Scaffolding Decantr default.${RESET2}`);
     const themeResult = await registryClient.fetchTheme(options.theme);
     if (themeResult) {
       const theme = themeResult.data;
-      if (theme.seed) {
-        themeData = { seed: theme.seed };
+      themeData = {
+        seed: theme.seed,
+        palette: theme.palette,
+        tokens: theme.tokens
+      };
+      if (theme.decorators) {
+        recipeData = { decorators: theme.decorators };
       }
     }
   }
@@ -1524,7 +1918,7 @@ ${YELLOW2}You're offline. Scaffolding Decantr default.${RESET2}`);
   console.log(`    ${cyan("decantr validate")}   Check essence file`);
   console.log(`    ${cyan("decantr upgrade")}    Update to latest patterns`);
   console.log(`    ${cyan("decantr heal")}       Fix drift issues`);
-  const essenceContent = readFileSync4(result.essencePath, "utf-8");
+  const essenceContent = readFileSync6(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   const validation = validateEssence(essence);
   if (!validation.valid) {
@@ -1546,22 +1940,22 @@ Validation warnings: ${validation.errors.join(", ")}`));
   const curatedPrompt = generateCuratedPrompt(promptCtx);
   console.log(boxedPrompt(curatedPrompt, "Copy this prompt for your AI assistant"));
   console.log("");
-  if (registrySource === "bundled") {
+  if (registrySource === "cache") {
     console.log(dim('Run "decantr sync" when online to get the latest registry content.'));
   }
 }
 async function cmdStatus() {
   const projectRoot = process.cwd();
-  const essencePath = join4(projectRoot, "decantr.essence.json");
-  const projectJsonPath = join4(projectRoot, ".decantr", "project.json");
+  const essencePath = join7(projectRoot, "decantr.essence.json");
+  const projectJsonPath = join7(projectRoot, ".decantr", "project.json");
   console.log(heading("Decantr Project Status"));
-  if (!existsSync4(essencePath)) {
+  if (!existsSync7(essencePath)) {
     console.log(`${RED}No decantr.essence.json found.${RESET2}`);
     console.log(dim('Run "decantr init" to create one.'));
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync4(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync6(essencePath, "utf-8"));
     const validation = validateEssence(essence);
     console.log(`${BOLD2}Essence:${RESET2}`);
     if (validation.valid) {
@@ -1577,9 +1971,9 @@ async function cmdStatus() {
   }
   console.log("");
   console.log(`${BOLD2}Sync Status:${RESET2}`);
-  if (existsSync4(projectJsonPath)) {
+  if (existsSync7(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync4(projectJsonPath, "utf-8"));
+      const projectJson = JSON.parse(readFileSync6(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
@@ -1597,33 +1991,33 @@ async function cmdStatus() {
 }
 async function cmdSync() {
   const projectRoot = process.cwd();
-  const cacheDir = join4(projectRoot, ".decantr", "cache");
+  const cacheDir = join7(projectRoot, ".decantr", "cache");
   console.log(heading("Syncing registry content..."));
   const result = await syncRegistry(cacheDir);
-  if (result.source === "api") {
+  if (result.synced.length > 0) {
     console.log(success("Sync completed successfully."));
-    if (result.synced.length > 0) {
-      console.log(`  Synced: ${result.synced.join(", ")}`);
-    }
+    console.log(`  Synced: ${result.synced.join(", ")}`);
     if (result.failed.length > 0) {
       console.log(`  ${YELLOW2}Failed: ${result.failed.join(", ")}${RESET2}`);
     }
   } else {
     console.log(`${YELLOW2}Could not sync: API unavailable${RESET2}`);
-    console.log(dim("Using bundled content."));
+    if (result.failed.length > 0) {
+      console.log(`  ${YELLOW2}Failed: ${result.failed.join(", ")}${RESET2}`);
+    }
   }
 }
 async function cmdAudit() {
   const projectRoot = process.cwd();
-  const essencePath = join4(projectRoot, "decantr.essence.json");
+  const essencePath = join7(projectRoot, "decantr.essence.json");
   console.log(heading("Auditing project..."));
-  if (!existsSync4(essencePath)) {
+  if (!existsSync7(essencePath)) {
     console.log(`${RED}No decantr.essence.json found.${RESET2}`);
     process.exitCode = 1;
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync4(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync6(essencePath, "utf-8"));
     const validation = validateEssence(essence);
     if (!validation.valid) {
       console.log(`${RED}Essence validation failed:${RESET2}`);
@@ -1723,14 +2117,14 @@ ${BOLD2}Examples:${RESET2}
         process.exitCode = 1;
         return;
       }
-      const themePath = join4(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync4(themePath)) {
+      const themePath = join7(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
+      if (!existsSync7(themePath)) {
         console.error(error(`Theme "${name}" not found at ${themePath}`));
         process.exitCode = 1;
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync4(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync6(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success(`Custom theme "${name}" is valid`));
@@ -1803,6 +2197,10 @@ ${BOLD2}Usage:${RESET2}
   decantr list <type>
   decantr validate [path]
   decantr theme <subcommand>
+  decantr create <type> <name>
+  decantr publish <type> <name>
+  decantr login
+  decantr logout
   decantr help
 
 ${BOLD2}Init Options:${RESET2}
@@ -1830,6 +2228,10 @@ ${BOLD2}Commands:${RESET2}
   ${cyan("list")}      List items by type
   ${cyan("validate")}  Validate essence file
   ${cyan("theme")}     Manage custom themes (create, list, validate, delete, import)
+  ${cyan("create")}    Create a custom content item (pattern, recipe, theme, etc.)
+  ${cyan("publish")}   Publish a custom content item to the community registry
+  ${cyan("login")}     Authenticate with the Decantr registry
+  ${cyan("logout")}    Remove stored credentials
   ${cyan("help")}      Show this help
 
 ${BOLD2}Examples:${RESET2}
@@ -1842,6 +2244,8 @@ ${BOLD2}Examples:${RESET2}
   decantr suggest leaderboard
   decantr suggest ranking --type pattern
   decantr list patterns
+  decantr create pattern my-card
+  decantr publish pattern my-card
 `);
 }
 async function main() {
@@ -1887,7 +2291,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-FWICWIQW.js");
+      const { cmdUpgrade } = await import("./upgrade-KRFCKUMR.js");
       await cmdUpgrade(process.cwd());
       break;
     }
@@ -1953,6 +2357,60 @@ async function main() {
       await cmdTheme(args.slice(1));
       break;
     }
+    case "login": {
+      const apiKeyArg = args[1];
+      if (apiKeyArg && apiKeyArg.startsWith("--api-key=")) {
+        const key = apiKeyArg.split("=")[1];
+        saveCredentials({ access_token: key, api_key: key });
+        console.log(success("API key saved."));
+      } else {
+        console.log(heading("Decantr Login"));
+        console.log("  To authenticate, get your API key from the Decantr dashboard:");
+        console.log("");
+        console.log(`    ${cyan("https://decantr.ai/dashboard/api-keys")}`);
+        console.log("");
+        console.log("  Then run:");
+        console.log(`    ${cyan("decantr login --api-key=<your-key>")}`);
+        console.log("");
+        console.log("  Or set the environment variable:");
+        console.log(`    ${cyan("export DECANTR_API_KEY=<your-key>")}`);
+        const existingCreds = getCredentials();
+        if (existingCreds) {
+          console.log("");
+          console.log(dim("You are currently authenticated."));
+        }
+      }
+      break;
+    }
+    case "logout": {
+      clearCredentials();
+      console.log(success("Logged out. Credentials removed."));
+      break;
+    }
+    case "create": {
+      const type = args[1];
+      const name = args[2];
+      if (!type || !name) {
+        console.error(error("Usage: decantr create <type> <name>"));
+        console.error(dim("Types: pattern, recipe, theme, blueprint, archetype, shell"));
+        process.exitCode = 1;
+        break;
+      }
+      cmdCreate(type, name);
+      break;
+    }
+    case "publish": {
+      const type = args[1];
+      const name = args[2];
+      if (!type || !name) {
+        console.error(error("Usage: decantr publish <type> <name>"));
+        console.error(dim("Types: pattern, recipe, theme, blueprint, archetype, shell"));
+        process.exitCode = 1;
+        break;
+      }
+      await cmdPublish(type, name);
+      break;
+    }
     default:
       console.error(error(`Unknown command: ${command}`));
       cmdHelp();