create-fornix 0.0.2 → 0.0.3

package/dist/index.js

@@ -898,6 +898,535 @@ function generateProjectManifest(config, blocks) {
   return JSON.stringify(manifest2, null, 2) + "\n";
 }
 
+// ../fornix-registry/src/schemas/block-manifest.ts
+import { z } from "zod";
+var BlockFileSchema = z.object({
+  source: z.string().min(1),
+  destination: z.string().min(1),
+  condition: z.string().optional()
+});
+var EnvVarSchema = z.object({
+  name: z.string().min(1),
+  description: z.string().min(1),
+  required: z.boolean()
+});
+var ContentSlotSchema = z.object({
+  type: z.enum(["string", "number", "boolean", "array", "object"]),
+  description: z.string().optional(),
+  maxLength: z.number().int().positive().optional(),
+  example: z.unknown().optional(),
+  items: z.record(z.unknown()).optional(),
+  minItems: z.number().int().nonnegative().optional(),
+  maxItems: z.number().int().positive().optional()
+});
+var BlockCollectionSchema = z.object({
+  name: z.string().min(1),
+  type: z.enum(["data", "content"]),
+  schemaSource: z.string().min(1)
+});
+var BlockAIMetadataSchema = z.object({
+  whenToUse: z.string().min(1),
+  whenNotToUse: z.string().min(1),
+  pairsWith: z.array(z.string()),
+  contentSlots: z.record(ContentSlotSchema).optional()
+});
+var BlockManifestSchema = z.object({
+  schemaVersion: z.number().int().positive(),
+  name: z.string().regex(
+    /^[a-z][a-z0-9-]*$/,
+    "Block name must be kebab-case, starting with a lowercase letter (regex: ^[a-z][a-z0-9-]*$)"
+  ),
+  version: z.string().min(1),
+  type: z.enum(["section", "integration", "feature", "layout"]),
+  description: z.string().min(1).max(200),
+  category: z.string().min(1),
+  tags: z.array(z.string()),
+  dependencies: z.record(z.string()),
+  requires: z.array(z.string()),
+  conflicts: z.array(z.string()),
+  requiredMode: z.enum(["static", "hybrid", "server"]).optional(),
+  envVars: z.array(EnvVarSchema),
+  variants: z.array(z.string()),
+  slots: z.array(z.string()),
+  files: z.array(BlockFileSchema),
+  collections: z.array(BlockCollectionSchema).optional(),
+  ai: BlockAIMetadataSchema.optional()
+});
+
+// ../fornix-registry/src/schemas/palette.ts
+import { z as z2 } from "zod";
+var HexColorSchema = z2.string().regex(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/, "Must be a valid hex color (e.g. #ff00aa or #fff)");
+var PaletteSchema = z2.object({
+  schemaVersion: z2.number().int().positive(),
+  name: z2.string().regex(
+    /^[a-z][a-z0-9-]*$/,
+    "Palette name must be kebab-case, starting with a lowercase letter"
+  ),
+  displayName: z2.string().min(1),
+  category: z2.string().min(1),
+  mode: z2.enum(["light", "dark"]),
+  colors: z2.object({
+    primary: HexColorSchema,
+    secondary: HexColorSchema,
+    accent: HexColorSchema,
+    background: HexColorSchema,
+    foreground: HexColorSchema
+  })
+});
+var PaletteRegistrySchema = z2.array(PaletteSchema);
+
+// ../fornix-registry/src/builtin-palettes.ts
+var BUILTIN_PALETTES = [
+  {
+    schemaVersion: 1,
+    name: "arctic",
+    displayName: "Arctic",
+    category: "nature",
+    mode: "light",
+    colors: {
+      primary: "#0ea5e9",
+      secondary: "#38bdf8",
+      accent: "#6366f1",
+      background: "#f0f9ff",
+      foreground: "#0c4a6e"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "charcoal",
+    displayName: "Charcoal",
+    category: "dark",
+    mode: "dark",
+    colors: {
+      primary: "#3b82f6",
+      secondary: "#60a5fa",
+      accent: "#f59e0b",
+      background: "#1c1917",
+      foreground: "#e7e5e4"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "copper",
+    displayName: "Copper",
+    category: "warm",
+    mode: "dark",
+    colors: {
+      primary: "#b45309",
+      secondary: "#d97706",
+      accent: "#06b6d4",
+      background: "#27272a",
+      foreground: "#fef3c7"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "corporate-blue",
+    displayName: "Corporate Blue",
+    category: "professional",
+    mode: "light",
+    colors: {
+      primary: "#1e40af",
+      secondary: "#2563eb",
+      accent: "#0d9488",
+      background: "#f0f9ff",
+      foreground: "#1e3a5f"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "cotton",
+    displayName: "Cotton",
+    category: "light",
+    mode: "light",
+    colors: {
+      primary: "#7c3aed",
+      secondary: "#8b5cf6",
+      accent: "#10b981",
+      background: "#fafaf9",
+      foreground: "#1c1917"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "cream",
+    displayName: "Cream",
+    category: "light",
+    mode: "light",
+    colors: {
+      primary: "#b45309",
+      secondary: "#d97706",
+      accent: "#059669",
+      background: "#fffbeb",
+      foreground: "#451a03"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "cyber-punk",
+    displayName: "Cyber Punk",
+    category: "vibrant",
+    mode: "dark",
+    colors: {
+      primary: "#eab308",
+      secondary: "#facc15",
+      accent: "#ec4899",
+      background: "#0a0a0a",
+      foreground: "#fef9c3"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "deep-sea",
+    displayName: "Deep Sea",
+    category: "cool",
+    mode: "dark",
+    colors: {
+      primary: "#06b6d4",
+      secondary: "#22d3ee",
+      accent: "#f97316",
+      background: "#042f2e",
+      foreground: "#ccfbf1"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "desert-sand",
+    displayName: "Desert Sand",
+    category: "nature",
+    mode: "light",
+    colors: {
+      primary: "#c2410c",
+      secondary: "#ea580c",
+      accent: "#0d9488",
+      background: "#fef3c7",
+      foreground: "#431407"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "electric-violet",
+    displayName: "Electric Violet",
+    category: "vibrant",
+    mode: "dark",
+    colors: {
+      primary: "#8b5cf6",
+      secondary: "#a78bfa",
+      accent: "#34d399",
+      background: "#1e1b4b",
+      foreground: "#ede9fe"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "ember",
+    displayName: "Ember",
+    category: "warm",
+    mode: "dark",
+    colors: {
+      primary: "#ef4444",
+      secondary: "#f87171",
+      accent: "#fbbf24",
+      background: "#1c1917",
+      foreground: "#fef2f2"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "executive",
+    displayName: "Executive",
+    category: "professional",
+    mode: "dark",
+    colors: {
+      primary: "#d4af37",
+      secondary: "#f5d063",
+      accent: "#4ade80",
+      background: "#1a1a2e",
+      foreground: "#eef2ff"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "fintech-dark",
+    displayName: "Fintech Dark",
+    category: "brand-inspired",
+    mode: "dark",
+    colors: {
+      primary: "#10b981",
+      secondary: "#34d399",
+      accent: "#6366f1",
+      background: "#0a0a0a",
+      foreground: "#ecfdf5"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "forest",
+    displayName: "Forest",
+    category: "nature",
+    mode: "dark",
+    colors: {
+      primary: "#22c55e",
+      secondary: "#4ade80",
+      accent: "#fbbf24",
+      background: "#14532d",
+      foreground: "#dcfce7"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "frost",
+    displayName: "Frost",
+    category: "cool",
+    mode: "light",
+    colors: {
+      primary: "#6366f1",
+      secondary: "#818cf8",
+      accent: "#f43f5e",
+      background: "#eef2ff",
+      foreground: "#312e81"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "glacier",
+    displayName: "Glacier",
+    category: "cool",
+    mode: "light",
+    colors: {
+      primary: "#0284c7",
+      secondary: "#0ea5e9",
+      accent: "#c026d3",
+      background: "#ecfeff",
+      foreground: "#164e63"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "golden-hour",
+    displayName: "Golden Hour",
+    category: "warm",
+    mode: "light",
+    colors: {
+      primary: "#d97706",
+      secondary: "#f59e0b",
+      accent: "#be185d",
+      background: "#fffbeb",
+      foreground: "#451a03"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "health-clean",
+    displayName: "Health Clean",
+    category: "brand-inspired",
+    mode: "light",
+    colors: {
+      primary: "#0891b2",
+      secondary: "#06b6d4",
+      accent: "#16a34a",
+      background: "#f0fdfa",
+      foreground: "#134e4a"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "luxury-gold",
+    displayName: "Luxury Gold",
+    category: "brand-inspired",
+    mode: "dark",
+    colors: {
+      primary: "#d4af37",
+      secondary: "#f5d063",
+      accent: "#e11d48",
+      background: "#0c0a09",
+      foreground: "#fef9c3"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "midnight",
+    displayName: "Midnight",
+    category: "dark",
+    mode: "dark",
+    colors: {
+      primary: "#6366f1",
+      secondary: "#818cf8",
+      accent: "#c084fc",
+      background: "#0f172a",
+      foreground: "#f8fafc"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "neon-tokyo",
+    displayName: "Neon Tokyo",
+    category: "vibrant",
+    mode: "dark",
+    colors: {
+      primary: "#f43f5e",
+      secondary: "#fb7185",
+      accent: "#22d3ee",
+      background: "#0c0a09",
+      foreground: "#fef2f2"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "obsidian",
+    displayName: "Obsidian",
+    category: "dark",
+    mode: "dark",
+    colors: {
+      primary: "#a855f7",
+      secondary: "#7c3aed",
+      accent: "#f472b6",
+      background: "#09090b",
+      foreground: "#fafafa"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "ocean-breeze",
+    displayName: "Ocean Breeze",
+    category: "nature",
+    mode: "light",
+    colors: {
+      primary: "#0077b6",
+      secondary: "#0096c7",
+      accent: "#f4845f",
+      background: "#caf0f8",
+      foreground: "#023e8a"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "pearl",
+    displayName: "Pearl",
+    category: "light",
+    mode: "light",
+    colors: {
+      primary: "#0891b2",
+      secondary: "#06b6d4",
+      accent: "#e11d48",
+      background: "#f8fafc",
+      foreground: "#0c4a6e"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "slate-modern",
+    displayName: "Slate Modern",
+    category: "professional",
+    mode: "light",
+    colors: {
+      primary: "#475569",
+      secondary: "#64748b",
+      accent: "#0ea5e9",
+      background: "#f8fafc",
+      foreground: "#0f172a"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "snow",
+    displayName: "Snow",
+    category: "light",
+    mode: "light",
+    colors: {
+      primary: "#2563eb",
+      secondary: "#3b82f6",
+      accent: "#f97316",
+      background: "#ffffff",
+      foreground: "#0f172a"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "startup-bold",
+    displayName: "Startup Bold",
+    category: "brand-inspired",
+    mode: "light",
+    colors: {
+      primary: "#7c3aed",
+      secondary: "#8b5cf6",
+      accent: "#f97316",
+      background: "#faf5ff",
+      foreground: "#3b0764"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "storm",
+    displayName: "Storm",
+    category: "cool",
+    mode: "dark",
+    colors: {
+      primary: "#64748b",
+      secondary: "#94a3b8",
+      accent: "#38bdf8",
+      background: "#0f172a",
+      foreground: "#cbd5e1"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "sunset-glow",
+    displayName: "Sunset Glow",
+    category: "vibrant",
+    mode: "dark",
+    colors: {
+      primary: "#f97316",
+      secondary: "#fb923c",
+      accent: "#a855f7",
+      background: "#18181b",
+      foreground: "#fff7ed"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "terracotta",
+    displayName: "Terracotta",
+    category: "warm",
+    mode: "light",
+    colors: {
+      primary: "#c2410c",
+      secondary: "#dc2626",
+      accent: "#65a30d",
+      background: "#fdf2f8",
+      foreground: "#431407"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "trust",
+    displayName: "Trust",
+    category: "professional",
+    mode: "light",
+    colors: {
+      primary: "#0369a1",
+      secondary: "#0284c7",
+      accent: "#16a34a",
+      background: "#f0fdfa",
+      foreground: "#0c4a6e"
+    }
+  },
+  {
+    schemaVersion: 1,
+    name: "void",
+    displayName: "Void",
+    category: "dark",
+    mode: "dark",
+    colors: {
+      primary: "#14b8a6",
+      secondary: "#2dd4bf",
+      accent: "#f43f5e",
+      background: "#020617",
+      foreground: "#e2e8f0"
+    }
+  }
+];
+
 // src/cli/fixture-registry.ts
 import { readFileSync, readdirSync } from "fs";
 import { join, dirname } from "path";
@@ -1208,6 +1737,9 @@ export function getStaticPaths() { return [{ params: { slug: '1' } }]; }
 };
 var FIXTURE_DEFAULT_CONTENT = {};
 function loadAllPalettes() {
+  if (BUILTIN_PALETTES.length > 0) {
+    return [...BUILTIN_PALETTES];
+  }
   try {
     const registryPath = findRegistryPalettesDir();
     if (!registryPath) return [];
@@ -1779,26 +2311,26 @@ ONLY recommend blocks that exist in the catalog above. Be precise with block nam
 }
 
 // src/ai/schemas.ts
-import { z } from "zod";
-var BrandSchema = z.object({
-  name: z.string().min(1),
-  tagline: z.string().optional(),
-  description: z.string().min(1),
-  targetAudience: z.string().optional(),
-  tone: z.string().min(1)
+import { z as z3 } from "zod";
+var BrandSchema = z3.object({
+  name: z3.string().min(1),
+  tagline: z3.string().nullable().default(null),
+  description: z3.string().min(1),
+  targetAudience: z3.string().nullable().default(null),
+  tone: z3.string().min(1)
 });
-var RecommendedBlockSchema = z.object({
-  blockName: z.string().min(1),
-  reason: z.string().min(1),
-  confidence: z.number().min(0).max(1)
+var RecommendedBlockSchema = z3.object({
+  blockName: z3.string().min(1),
+  reason: z3.string().min(1),
+  confidence: z3.number().min(0).max(1)
 });
-var UncertaintySchema = z.object({
-  topic: z.string().min(1),
-  question: z.string().min(1),
-  defaultAssumption: z.string().min(1)
+var UncertaintySchema = z3.object({
+  topic: z3.string().min(1),
+  question: z3.string().min(1),
+  defaultAssumption: z3.string().min(1)
 });
-var IntentSchema = z.object({
-  siteType: z.enum([
+var IntentSchema = z3.object({
+  siteType: z3.enum([
     "landing-page",
     "saas",
     "agency",
@@ -1810,20 +2342,20 @@ var IntentSchema = z.object({
     "community",
     "other"
   ]),
-  industry: z.string().min(1),
+  industry: z3.string().min(1),
   brand: BrandSchema,
-  needsAuth: z.boolean(),
-  needsPayments: z.boolean(),
-  needsBlog: z.boolean(),
-  needsDocs: z.boolean(),
-  needsDashboard: z.boolean(),
-  needsContactForm: z.boolean(),
-  needsNewsletter: z.boolean(),
-  hasDynamicContent: z.boolean(),
-  hasEcommerce: z.boolean(),
-  hasUserAccounts: z.boolean(),
-  prefersDarkMode: z.boolean(),
-  visualStyle: z.enum([
+  needsAuth: z3.boolean(),
+  needsPayments: z3.boolean(),
+  needsBlog: z3.boolean(),
+  needsDocs: z3.boolean(),
+  needsDashboard: z3.boolean(),
+  needsContactForm: z3.boolean(),
+  needsNewsletter: z3.boolean(),
+  hasDynamicContent: z3.boolean(),
+  hasEcommerce: z3.boolean(),
+  hasUserAccounts: z3.boolean(),
+  prefersDarkMode: z3.boolean(),
+  visualStyle: z3.enum([
     "minimal",
     "bold",
     "glassmorphism",
@@ -1831,80 +2363,15 @@ var IntentSchema = z.object({
     "flat",
     "neo-brutalist"
   ]),
-  languages: z.array(z.string().min(1)).default([]),
-  palettePreference: z.enum(["custom", "prebuilt", "ai-generated", "unspecified"]),
-  wantsThemeSwitcher: z.boolean(),
-  recommendedBlocks: z.array(RecommendedBlockSchema),
-  uncertainties: z.array(UncertaintySchema),
-  overallConfidence: z.number().min(0).max(1)
+  languages: z3.array(z3.string().min(1)).default([]),
+  palettePreference: z3.enum(["custom", "prebuilt", "ai-generated", "unspecified"]),
+  wantsThemeSwitcher: z3.boolean(),
+  recommendedBlocks: z3.array(RecommendedBlockSchema),
+  uncertainties: z3.array(UncertaintySchema),
+  overallConfidence: z3.number().min(0).max(1)
 });
 
 // src/ai/rules.ts
-import { z as z2 } from "zod";
-var IntentSchema2 = z2.object({
-  siteType: z2.enum([
-    "landing-page",
-    "saas",
-    "agency",
-    "portfolio",
-    "blog",
-    "docs",
-    "ecommerce",
-    "dashboard",
-    "community",
-    "other"
-  ]),
-  industry: z2.string(),
-  brand: z2.object({
-    name: z2.string(),
-    tagline: z2.string().optional(),
-    description: z2.string(),
-    targetAudience: z2.string().optional(),
-    tone: z2.string()
-  }),
-  needsAuth: z2.boolean(),
-  needsPayments: z2.boolean(),
-  needsBlog: z2.boolean(),
-  needsDocs: z2.boolean(),
-  needsDashboard: z2.boolean(),
-  needsContactForm: z2.boolean(),
-  needsNewsletter: z2.boolean(),
-  hasDynamicContent: z2.boolean(),
-  hasEcommerce: z2.boolean(),
-  hasUserAccounts: z2.boolean(),
-  prefersDarkMode: z2.boolean(),
-  visualStyle: z2.enum([
-    "minimal",
-    "bold",
-    "glassmorphism",
-    "gradient",
-    "flat",
-    "neo-brutalist"
-  ]),
-  languages: z2.array(z2.string()),
-  palettePreference: z2.enum([
-    "custom",
-    "prebuilt",
-    "ai-generated",
-    "unspecified"
-  ]),
-  wantsThemeSwitcher: z2.boolean(),
-  recommendedBlocks: z2.array(
-    z2.object({
-      blockName: z2.string(),
-      reason: z2.string(),
-      confidence: z2.number()
-    })
-  ),
-  uncertainties: z2.array(
-    z2.object({
-      topic: z2.string(),
-      question: z2.string(),
-      defaultAssumption: z2.string()
-    })
-  ),
-  overallConfidence: z2.number().min(0).max(1)
-});
 function hasBlock(config, name) {
   return config.blocks.some((b) => b.name === name);
 }
@@ -1996,37 +2463,37 @@ function createDefaultConfig(overrides = {}) {
 }
 
 // src/schemas/config.ts
-import { z as z3 } from "zod";
-var BlockSelectionSchema = z3.object({
-  name: z3.string().min(1),
-  variant: z3.string().min(1)
+import { z as z4 } from "zod";
+var BlockSelectionSchema = z4.object({
+  name: z4.string().min(1),
+  variant: z4.string().min(1)
 });
-var PaletteColorsSchema = z3.object({
-  primary: z3.string().min(1),
-  secondary: z3.string().min(1),
-  accent: z3.string().min(1),
-  background: z3.string().min(1),
-  foreground: z3.string().min(1)
+var PaletteColorsSchema = z4.object({
+  primary: z4.string().min(1),
+  secondary: z4.string().min(1),
+  accent: z4.string().min(1),
+  background: z4.string().min(1),
+  foreground: z4.string().min(1)
 });
-var PaletteConfigSchema = z3.object({
-  preset: z3.string().min(1).optional(),
+var PaletteConfigSchema = z4.object({
+  preset: z4.string().min(1).optional(),
   colors: PaletteColorsSchema
 });
-var ResolvedConfigSchema = z3.object({
-  projectName: z3.string().min(1),
-  projectDir: z3.string().min(1),
-  renderMode: z3.enum(["static", "hybrid", "server"]),
-  deployTarget: z3.enum(["cloudflare", "vercel", "netlify", "static"]),
-  database: z3.enum(["none", "d1", "turso", "astro-db", "postgres"]),
-  cssEngine: z3.enum(["tailwind", "vanilla"]),
-  packageManager: z3.enum(["npm", "pnpm", "bun"]),
-  blocks: z3.array(BlockSelectionSchema),
-  locales: z3.array(z3.string().min(1)).transform((locales) => locales.length === 0 ? ["en"] : locales),
-  defaultLocale: z3.string().min(1),
+var ResolvedConfigSchema = z4.object({
+  projectName: z4.string().min(1),
+  projectDir: z4.string().min(1),
+  renderMode: z4.enum(["static", "hybrid", "server"]),
+  deployTarget: z4.enum(["cloudflare", "vercel", "netlify", "static"]),
+  database: z4.enum(["none", "d1", "turso", "astro-db", "postgres"]),
+  cssEngine: z4.enum(["tailwind", "vanilla"]),
+  packageManager: z4.enum(["npm", "pnpm", "bun"]),
+  blocks: z4.array(BlockSelectionSchema),
+  locales: z4.array(z4.string().min(1)).transform((locales) => locales.length === 0 ? ["en"] : locales),
+  defaultLocale: z4.string().min(1),
   palette: PaletteConfigSchema,
-  themeSwitcher: z3.boolean().default(false),
-  content: z3.record(z3.record(z3.unknown())).optional(),
-  createdWith: z3.enum(["ai", "manual", "recipe", "mcp"])
+  themeSwitcher: z4.boolean().default(false),
+  content: z4.record(z4.record(z4.unknown())).optional(),
+  createdWith: z4.enum(["ai", "manual", "recipe", "mcp"])
 }).refine(
   (config) => config.locales.includes(config.defaultLocale),
   {
@@ -2341,7 +2808,7 @@ function createOpenAIProvider(apiKey) {
         const { openai } = await import("@ai-sdk/openai");
         const result = await generateObject({
           model: openai("gpt-4o-mini", { structuredOutputs: true }),
-          schema: IntentSchema2,
+          schema: IntentSchema,
           system: systemPrompt ?? "You are the Fornix AI assistant. Analyze the user's website description and produce a structured Intent object.",
           prompt,
           maxTokens: 2e3
@@ -2402,7 +2869,7 @@ function createOllamaProvider(opts = {}) {
           });
         }
         const parsed = JSON.parse(content);
-        const validated = IntentSchema2.parse(parsed);
+        const validated = IntentSchema.parse(parsed);
         return ok(validated);
       } catch (error) {
         const message = error instanceof Error ? error.message : "Unknown Ollama error";
@@ -2478,7 +2945,7 @@ function createCloudflareProvider(opts = {}) {
           });
         }
         const parsed = JSON.parse(content);
-        const validated = IntentSchema2.parse(parsed);
+        const validated = IntentSchema.parse(parsed);
         return ok(validated);
       } catch (error) {
         const message = error instanceof Error ? error.message : "Unknown Cloudflare AI error";
@@ -2538,7 +3005,7 @@ function createMockProvider() {
       try {
         const raw = readFileSync2(filePath, "utf-8");
         const parsed = JSON.parse(raw);
-        const validated = IntentSchema2.parse(parsed);
+        const validated = IntentSchema.parse(parsed);
         return ok(validated);
       } catch (error) {
         const message = error instanceof Error ? error.message : "Unknown parse error";
@@ -2862,11 +3329,11 @@ var createCommand = defineCommand({
       default: false
     }
   },
-  async run({ args }) {
+  async run({ args: args2 }) {
     const allPalettes = loadAllPalettes();
-    const hasExplicitFlags = !!(args.render || args.deploy || args.blocks || args.database || args.css || args.locales || args.palette || args.recipe);
-    if (args.manual && !args.yes) {
-      const defaultProjectName = args.dir ? basename2(resolve(args.dir)) : "my-project";
+    const hasExplicitFlags = !!(args2.render || args2.deploy || args2.blocks || args2.database || args2.css || args2.locales || args2.palette || args2.recipe);
+    if (args2.manual && !args2.yes) {
+      const defaultProjectName = args2.dir ? basename2(resolve(args2.dir)) : "my-project";
       const config = await runManualFlow({
         defaultProjectName,
         manifests: FIXTURE_MANIFESTS,
@@ -2876,20 +3343,20 @@ var createCommand = defineCommand({
         process.exitCode = 0;
         return;
       }
-      const projectDir = args.dir ? resolve(args.dir) : resolve(config.projectDir);
+      const projectDir = args2.dir ? resolve(args2.dir) : resolve(config.projectDir);
       const finalConfig = { ...config, projectDir };
-      return runScaffold(finalConfig, allPalettes, args["dry-run"] ?? false, args.verbose ?? false, !(args.install ?? true), !(args.git ?? true));
+      return runScaffold(finalConfig, allPalettes, args2["dry-run"] ?? false, args2.verbose ?? false, !(args2.install ?? true), !(args2.git ?? true));
     }
-    if (args.manual || hasExplicitFlags) {
-      return runFlagDrivenMode(args, allPalettes);
+    if (args2.manual || hasExplicitFlags) {
+      return runFlagDrivenMode(args2, allPalettes);
     }
-    return runAIMode(args, allPalettes);
+    return runAIMode(args2, allPalettes);
   }
 });
-async function runAIMode(args, allPalettes) {
-  const providerName = parseProviderName(args.provider);
-  if (args.provider && !providerName) {
-    console.error(pc3.red(`\u2716 Unknown provider: ${String(args.provider)}`));
+async function runAIMode(args2, allPalettes) {
+  const providerName = parseProviderName(args2.provider);
+  if (args2.provider && !providerName) {
+    console.error(pc3.red(`\u2716 Unknown provider: ${String(args2.provider)}`));
     console.error(pc3.dim(`  Available: ${VALID_PROVIDER_NAMES.join(", ")}`));
     process.exitCode = 1;
     return;
@@ -2904,7 +3371,7 @@ async function runAIMode(args, allPalettes) {
     return;
   }
   const provider = adaptProvider(legacyProvider);
-  const description = await getDescription(args);
+  const description = await getDescription(args2);
   if (!description) {
     process.exitCode = 0;
     return;
@@ -2913,7 +3380,7 @@ async function runAIMode(args, allPalettes) {
     blocks: Object.values(FIXTURE_MANIFESTS),
     palettes: [...allPalettes]
   };
-  const projectDir = resolve(String(args.dir ?? "."));
+  const projectDir = resolve(String(args2.dir ?? "."));
   const projectName = basename2(projectDir);
   const nameResult = validateProjectName(projectName);
   if (!nameResult.ok) {
@@ -2934,7 +3401,7 @@ async function runAIMode(args, allPalettes) {
     return;
   }
   const config = result.value;
-  if (!args.yes) {
+  if (!args2.yes) {
     showAISummary(config);
     const confirmed = await p2.confirm({
       message: "Create this project?",
@@ -2949,14 +3416,14 @@ async function runAIMode(args, allPalettes) {
   return runScaffold(
     config,
     allPalettes,
-    (args["dry-run"] ?? false) === true,
-    (args.verbose ?? false) === true,
-    !((args.install ?? true) === true),
-    !((args.git ?? true) === true)
+    (args2["dry-run"] ?? false) === true,
+    (args2.verbose ?? false) === true,
+    !((args2.install ?? true) === true),
+    !((args2.git ?? true) === true)
   );
 }
-function runFlagDrivenMode(args, allPalettes) {
-  const projectDir = resolve(String(args.dir ?? "."));
+function runFlagDrivenMode(args2, allPalettes) {
+  const projectDir = resolve(String(args2.dir ?? "."));
   const projectName = basename2(projectDir);
   const nameResult = validateProjectName(projectName);
   if (!nameResult.ok) {
@@ -2964,7 +3431,7 @@ function runFlagDrivenMode(args, allPalettes) {
     process.exitCode = 1;
     return;
   }
-  const recipeName = args.recipe ? String(args.recipe) : void 0;
+  const recipeName = args2.recipe ? String(args2.recipe) : void 0;
   let recipeOverlay = {};
   if (recipeName) {
     if (RECIPES[recipeName]) {
@@ -2977,11 +3444,11 @@ function runFlagDrivenMode(args, allPalettes) {
       return;
     }
   }
-  const renderMode = String(args.render ?? recipeOverlay.renderMode ?? "static");
-  const deployTarget = String(args.deploy ?? recipeOverlay.deployTarget ?? "cloudflare");
-  const database = String(args.database ?? recipeOverlay.database ?? "none");
-  const cssEngine = String(args.css ?? recipeOverlay.cssEngine ?? "tailwind");
-  const localesRaw = String(args.locales ?? "");
+  const renderMode = String(args2.render ?? recipeOverlay.renderMode ?? "static");
+  const deployTarget = String(args2.deploy ?? recipeOverlay.deployTarget ?? "cloudflare");
+  const database = String(args2.database ?? recipeOverlay.database ?? "none");
+  const cssEngine = String(args2.css ?? recipeOverlay.cssEngine ?? "tailwind");
+  const localesRaw = String(args2.locales ?? "");
   let locales = ["en"];
   let defaultLocale = "en";
   if (localesRaw) {
@@ -2991,8 +3458,8 @@ function runFlagDrivenMode(args, allPalettes) {
     locales = [...recipeOverlay.locales];
     defaultLocale = recipeOverlay.defaultLocale ?? locales[0] ?? "en";
   }
-  const themeSwitcher = args["theme-switcher"] !== void 0 ? args["theme-switcher"] === true : recipeOverlay.themeSwitcher ?? false;
-  const blocksString = args.blocks ? String(args.blocks) : "";
+  const themeSwitcher = args2["theme-switcher"] !== void 0 ? args2["theme-switcher"] === true : recipeOverlay.themeSwitcher ?? false;
+  const blocksString = args2.blocks ? String(args2.blocks) : "";
   let blocks = recipeOverlay.blocks ? [...recipeOverlay.blocks] : [];
   if (blocksString) {
     const blockNames = blocksString.split(",").map((b) => b.trim()).filter(Boolean);
@@ -3006,8 +3473,8 @@ function runFlagDrivenMode(args, allPalettes) {
   }
   let paletteColors = recipeOverlay.palette ? { ...recipeOverlay.palette.colors } : { ...DEFAULT_COLORS };
   let palettePreset = recipeOverlay.palette?.preset;
-  if (args.palette) {
-    const paletteName = String(args.palette);
+  if (args2.palette) {
+    const paletteName = String(args2.palette);
     const found = allPalettes.find((palette) => palette.name === paletteName);
     if (found) {
       paletteColors = { ...found.colors };
@@ -3040,10 +3507,10 @@ function runFlagDrivenMode(args, allPalettes) {
   return runScaffold(
     config,
     allPalettes,
-    (args["dry-run"] ?? false) === true,
-    (args.verbose ?? false) === true,
-    !((args.install ?? true) === true),
-    !((args.git ?? true) === true)
+    (args2["dry-run"] ?? false) === true,
+    (args2.verbose ?? false) === true,
+    !((args2.install ?? true) === true),
+    !((args2.git ?? true) === true)
   );
 }
 function runScaffold(config, allPalettes, dryRun, verbose, skipInstall, skipGit) {
@@ -3125,9 +3592,9 @@ function parseProviderName(value) {
   }
   return void 0;
 }
-async function getDescription(args) {
-  if (args.yes) {
-    return typeof args.description === "string" && args.description.length > 0 ? args.description : DEFAULT_AI_DESCRIPTION;
+async function getDescription(args2) {
+  if (args2.yes) {
+    return typeof args2.description === "string" && args2.description.length > 0 ? args2.description : DEFAULT_AI_DESCRIPTION;
   }
   p2.intro(pc3.bgCyan(pc3.black(" Fornix \u2014 AI Mode ")));
   const input = await p2.text({
@@ -3206,8 +3673,8 @@ var addCommand = defineCommand2({
       default: false
     }
   },
-  run({ args }) {
-    const typedArgs = args;
+  run({ args: args2 }) {
+    const typedArgs = args2;
     const cwd = process.cwd();
     const manifestPath = join5(cwd, "fornix.json");
     if (!existsSync2(manifestPath)) {
@@ -3375,8 +3842,8 @@ var removeCommand = defineCommand3({
       default: false
     }
   },
-  run({ args }) {
-    const typedArgs = args;
+  run({ args: args2 }) {
+    const typedArgs = args2;
     const cwd = process.cwd();
     const manifestPath = join6(cwd, "fornix.json");
     if (!existsSync3(manifestPath)) {
@@ -3503,8 +3970,8 @@ var listCommand = defineCommand4({
       default: false
     }
   },
-  run({ args }) {
-    const typedArgs = args;
+  run({ args: args2 }) {
+    const typedArgs = args2;
     const blocks = getFilteredBlocks(typedArgs);
     if (blocks.length === 0) {
       console.log(pc6.yellow("No blocks found matching your filters."));
@@ -3517,14 +3984,14 @@ var listCommand = defineCommand4({
     }
   }
 });
-function getFilteredBlocks(args) {
+function getFilteredBlocks(args2) {
   let blocks = Object.values(FIXTURE_MANIFESTS);
-  if (args.type) {
-    const filterType = args.type.toLowerCase();
+  if (args2.type) {
+    const filterType = args2.type.toLowerCase();
     blocks = blocks.filter((b) => b.type === filterType);
   }
-  if (args.category) {
-    const filterCategory = args.category.toLowerCase();
+  if (args2.category) {
+    const filterCategory = args2.category.toLowerCase();
     blocks = blocks.filter((b) => b.category === filterCategory);
   }
   return blocks.sort((a, b) => a.name.localeCompare(b.name));
@@ -3618,8 +4085,8 @@ var statusCommand = defineCommand5({
       default: false
     }
   },
-  run({ args }) {
-    const typedArgs = args;
+  run({ args: args2 }) {
+    const typedArgs = args2;
     const cwd = process.cwd();
     const manifestPath = join7(cwd, "fornix.json");
     if (!existsSync4(manifestPath)) {
@@ -3730,7 +4197,7 @@ var doctorCommand = defineCommand6({
       default: false
     }
   },
-  run({ args }) {
+  run({ args: args2 }) {
     const cwd = process.cwd();
     const manifestPath = join8(cwd, "fornix.json");
     let hasErrors = false;
@@ -3738,13 +4205,13 @@ var doctorCommand = defineCommand6({
     function reportError(msg) {
       hasErrors = true;
       errors.push(msg);
-      if (!args.json) {
+      if (!args2.json) {
         console.error(pc8.red(`\u2717 ${msg}`));
       }
     }
     if (!existsSync5(manifestPath)) {
       reportError("No fornix.json found in the current directory.");
-      if (args.json) {
+      if (args2.json) {
         console.log(JSON.stringify({ healthy: false, errors }));
       }
       process.exit(1);
@@ -3755,7 +4222,7 @@ var doctorCommand = defineCommand6({
       manifest2 = JSON.parse(raw);
     } catch {
       reportError("Failed to parse fornix.json.");
-      if (args.json) {
+      if (args2.json) {
         console.log(JSON.stringify({ healthy: false, errors }));
       }
       process.exit(1);
@@ -3816,7 +4283,7 @@ var doctorCommand = defineCommand6({
       reportError(`Broken content reference: missing ${missing}`);
     }
     if (hasErrors) {
-      if (args.json) {
+      if (args2.json) {
         console.log(JSON.stringify({ healthy: false, errors }));
       } else {
         console.log();
@@ -3824,7 +4291,7 @@ var doctorCommand = defineCommand6({
       }
       process.exit(1);
     } else {
-      if (args.json) {
+      if (args2.json) {
         console.log(JSON.stringify({ healthy: true, errors: [] }));
       } else {
         console.log(pc8.green("\u2713 Project is healthy!"));
@@ -4090,7 +4557,7 @@ function getContentSchema(input) {
 }
 
 // src/mcp/tools/validate-content.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 function validateContent(input) {
   const { collection, data } = input;
   const manifest2 = FIXTURE_MANIFESTS[collection];
@@ -4113,7 +4580,7 @@ function validateContent(input) {
   for (const [slotName, slot] of Object.entries(contentSlots)) {
     schemaShape[slotName] = zodTypeForSlot2(slot.type);
   }
-  const schema = z4.object(schemaShape);
+  const schema = z5.object(schemaShape);
   const parseResult = schema.safeParse(data);
   if (parseResult.success) {
     return ok({ valid: true, errors: [] });
@@ -4126,17 +4593,17 @@ function validateContent(input) {
 function zodTypeForSlot2(slotType) {
   switch (slotType) {
     case "string":
-      return z4.string();
+      return z5.string();
     case "number":
-      return z4.number();
+      return z5.number();
     case "boolean":
-      return z4.boolean();
+      return z5.boolean();
     case "array":
-      return z4.array(z4.unknown());
+      return z5.array(z5.unknown());
     case "object":
-      return z4.record(z4.unknown());
+      return z5.record(z5.unknown());
     default:
-      return z4.unknown();
+      return z5.unknown();
   }
 }
 
@@ -4387,8 +4854,8 @@ var FornixMCPServer = class {
       CallToolRequestSchema,
       async (request) => {
         const toolName = request.params.name;
-        const args = request.params.arguments ?? {};
-        const result = await this.executeTool(toolName, args);
+        const args2 = request.params.arguments ?? {};
+        const result = await this.executeTool(toolName, args2);
         if (!result.ok) {
           return {
             content: [
@@ -4461,49 +4928,49 @@ var FornixMCPServer = class {
    * Execute a tool by name with the given arguments.
    * Exposed as a public method for testing without MCP transport.
    */
-  async callTool(toolName, args) {
-    return this.executeTool(toolName, args);
+  async callTool(toolName, args2) {
+    return this.executeTool(toolName, args2);
   }
-  async executeTool(toolName, args) {
+  async executeTool(toolName, args2) {
     switch (toolName) {
       case "list_blocks": {
         const result = listBlocks({
-          type: args.type,
-          category: args.category,
-          search: args.search
+          type: args2.type,
+          category: args2.category,
+          search: args2.search
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
       }
       case "add_block": {
         const result = addBlock2({
-          name: args.name,
-          variant: args.variant,
-          projectDirectory: args.projectDirectory
+          name: args2.name,
+          variant: args2.variant,
+          projectDirectory: args2.projectDirectory
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
       }
       case "remove_block": {
         const result = removeBlock({
-          name: args.name,
-          force: args.force,
-          projectDirectory: args.projectDirectory
+          name: args2.name,
+          force: args2.force,
+          projectDirectory: args2.projectDirectory
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
       }
       case "get_content_schema": {
         const result = getContentSchema({
-          collection: args.collection
+          collection: args2.collection
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
       }
       case "update_content": {
         const validationResult = validateContent({
-          collection: args.collection,
-          data: args.data
+          collection: args2.collection,
+          data: args2.data
         });
         if (!validationResult.ok) return err(validationResult.error);
         if (!validationResult.value.valid) {
@@ -4517,34 +4984,34 @@ var FornixMCPServer = class {
         return ok(
           JSON.stringify({
             updated: true,
-            collection: args.collection,
-            data: args.data
+            collection: args2.collection,
+            data: args2.data
           })
         );
       }
       case "validate_content": {
         const result = validateContent({
-          collection: args.collection,
-          data: args.data
+          collection: args2.collection,
+          data: args2.data
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
       }
       case "get_project_status": {
         const result = getProjectStatus({
-          projectDirectory: args.projectDirectory
+          projectDirectory: args2.projectDirectory
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
       }
       case "scaffold_project": {
         const result = scaffoldProject({
-          description: args.description,
-          projectDirectory: args.projectDirectory,
-          renderMode: args.renderMode,
-          deployTarget: args.deployTarget,
-          blocks: args.blocks,
-          locales: args.locales
+          description: args2.description,
+          projectDirectory: args2.projectDirectory,
+          renderMode: args2.renderMode,
+          deployTarget: args2.deployTarget,
+          blocks: args2.blocks,
+          locales: args2.locales
         });
         if (!result.ok) return err(result.error);
         return ok(JSON.stringify(result.value, null, 2));
@@ -4609,8 +5076,12 @@ var main = defineCommand8({
 
 // src/index.ts
 var KNOWN_COMMANDS = /* @__PURE__ */ new Set(["create", "add", "remove", "list", "status", "doctor", "mcp"]);
-var firstArg = process.argv[2];
-if (firstArg && !firstArg.startsWith("-") && !KNOWN_COMMANDS.has(firstArg)) {
+var HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
+var args = process.argv.slice(2);
+var hasKnownCommand = args.some((arg) => KNOWN_COMMANDS.has(arg));
+var isHelpOrVersion = args.some((arg) => HELP_FLAGS.has(arg));
+var hasArgs = args.length > 0;
+if (hasArgs && !hasKnownCommand && !isHelpOrVersion) {
   process.argv.splice(2, 0, "create");
 }
 runMain(main);