npm - @helloleo/plugins - Versions diffs - 0.1.13 → 0.1.15 - Mend

@helloleo/plugins 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (129) hide show

package/src/tools/scaffold.ts CHANGED Viewed

@@ -2,1385 +2,107 @@ import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import type { Plugin } from "@opencode-ai/plugin";
 import { tool } from "@opencode-ai/plugin";
+import { renderTemplate } from "../template-render.ts";
-function packageJson(name: string) {
-	return JSON.stringify(
-		{
-			name,
-			private: true,
-			version: "0.0.0",
-			type: "module",
-			scripts: {
-				dev: "vite",
-				start: "vite",
-				build: "vite build",
-				preview: "vite preview",
-			},
-			dependencies: {
-				react: "^18.3.1",
-				"react-dom": "^18.3.1",
-				clsx: "^2.1.1",
-				"tailwind-merge": "^2.6.0",
-				"lucide-react": "^1.14.0",
-			},
-			devDependencies: {
-				"@types/react": "^18.3.12",
-				"@types/react-dom": "^18.3.1",
-				"@vitejs/plugin-react": "^4.3.4",
-				autoprefixer: "^10.4.20",
-				postcss: "^8.4.49",
-				tailwindcss: "^3.4.17",
-				typescript: "^5.6.3",
-				vite: "^6.0.5",
-			},
-		},
-		null,
-		2,
-	);
-}
-function indexHtml(fontFamily: string) {
-	const fontParam = fontFamily.replace(/\s+/g, "+");
-	return `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <link rel="preconnect" href="https://fonts.googleapis.com">
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link href="https://fonts.googleapis.com/css2?family=${fontParam}:wght@400;500;600;700&display=swap" rel="stylesheet">
-    <title>App</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>`;
-}
-function viteConfig() {
-	return `import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import path from 'path'
-export default defineConfig({
-  plugins: [react()],
-  server: {
-    allowedHosts: true,
-  },
-  resolve: {
-    alias: {
-      '@': path.resolve(__dirname, './src'),
-    },
-  },
-})`;
-}
-export function tailwindConfig() {
-	return `export default {
-  darkMode: ["class"],
-  content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
-  theme: {
-    extend: {
-      colors: {
-        background: "hsl(var(--background))",
-        foreground: "hsl(var(--foreground))",
-        card: { DEFAULT: "hsl(var(--card))", foreground: "hsl(var(--card-foreground))" },
-        primary: { DEFAULT: "hsl(var(--primary))", foreground: "hsl(var(--primary-foreground))" },
-        secondary: { DEFAULT: "hsl(var(--secondary))", foreground: "hsl(var(--secondary-foreground))" },
-        muted: { DEFAULT: "hsl(var(--muted))", foreground: "hsl(var(--muted-foreground))" },
-        accent: { DEFAULT: "hsl(var(--accent))", foreground: "hsl(var(--accent-foreground))" },
-        destructive: { DEFAULT: "hsl(var(--destructive))", foreground: "hsl(var(--destructive-foreground))" },
-        success: { DEFAULT: "hsl(var(--success))", foreground: "hsl(var(--success-foreground))" },
-        warning: { DEFAULT: "hsl(var(--warning))", foreground: "hsl(var(--warning-foreground))" },
-        border: "hsl(var(--border))",
-        input: "hsl(var(--input))",
-        ring: "hsl(var(--ring))",
-      },
-      fontFamily: {
-        sans: "var(--font-sans)",
-        heading: "var(--font-heading)",
-      },
-      borderRadius: {
-        lg: "var(--radius)",
-        md: "calc(var(--radius) - 2px)",
-        sm: "calc(var(--radius) - 4px)",
-      },
-      borderWidth: {
-        DEFAULT: "var(--border-width)",
-      },
-      boxShadow: {
-        DEFAULT: "var(--shadow)",
-        lg: "var(--shadow-lg)",
-      },
-    },
-  },
-  plugins: [],
-}`;
-}
-export function postcssConfig() {
-	return `export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}`;
-}
-export function indexCss(
-	primaryColor: string,
-	fontFamily: string,
-	borderRadius: string,
-) {
-	const fontValue = `'${fontFamily}', ui-sans-serif, system-ui, sans-serif`;
-	return `/*
- * HelloLeo Design System -- READ BEFORE STYLING.
- *
- * The CSS variables below are the single source of truth for the project's
- * design tokens. They power the no-code Design panel in the HelloLeo webapp:
- * the user edits colors / fonts / radius / shadows visually, and the panel
- * writes back to THIS file. Keeping the conventions intact is what unlocks
- * that round-trip.
- *
- * Conventions (do not break):
- *   - All colors stored as raw HSL triplets (no hsl() wrapper, no #hex).
- *     Tailwind classes wrap them via hsl(var(--token)). Never inline #hex
- *     in components -- always use design tokens (bg-primary, text-foreground,
- *     border-border, etc.).
- *   - --primary / --secondary / --accent / --destructive / --success /
- *     --warning each have a paired -foreground for text on that surface.
- *   - --radius drives lg/md/sm via calc() in tailwind.config.js. Edit here,
- *     not in component classes.
- *   - --font-sans for body, --font-heading for headings. The webfont is loaded
- *     via a Google Fonts <link> — in index.html (SPA) or the root route head
- *     (SSR). Keep the family here in sync with that <link>.
- *   - .dark variants mirror :root one-for-one. When adding a token, add it
- *     to BOTH blocks or dark mode breaks.
- *
- * UI primitives (Button, Card, Input, Modal, Table, Badge, Alert, Spinner)
- * MUST live in src/components/ui/ and consume these tokens via Tailwind
- * classes -- never hardcoded colors. One responsibility per file, <50 lines
- * per component.
- */
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-@layer base {
-  :root {
-    --background: 0 0% 100%;
-    --foreground: 222.2 84% 4.9%;
-    --card: 0 0% 100%;
-    --card-foreground: 222.2 84% 4.9%;
-    --primary: ${primaryColor};
-    --primary-foreground: 210 40% 98%;
-    --secondary: 210 40% 96.1%;
-    --secondary-foreground: 222.2 47.4% 11.2%;
-    --muted: 210 40% 96.1%;
-    --muted-foreground: 215.4 16.3% 46.9%;
-    --accent: 210 40% 96.1%;
-    --accent-foreground: 222.2 47.4% 11.2%;
-    --destructive: 0 84.2% 60.2%;
-    --destructive-foreground: 210 40% 98%;
-    --success: 142 76% 36%;
-    --success-foreground: 210 40% 98%;
-    --warning: 38 92% 50%;
-    --warning-foreground: 222.2 47.4% 11.2%;
-    --border: 214.3 31.8% 91.4%;
-    --input: 214.3 31.8% 91.4%;
-    --ring: 221.2 83.2% 53.3%;
-    --radius: ${borderRadius};
-    --border-width: 1px;
-    --shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
-    --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
-    --font-sans: ${fontValue};
-    --font-heading: ${fontValue};
-  }
-  .dark {
-    --background: 222.2 84% 4.9%;
-    --foreground: 210 40% 98%;
-    --card: 222.2 84% 4.9%;
-    --card-foreground: 210 40% 98%;
-    --primary: 217.2 91.2% 59.8%;
-    --primary-foreground: 222.2 47.4% 11.2%;
-    --secondary: 217.2 32.6% 17.5%;
-    --secondary-foreground: 210 40% 98%;
-    --muted: 217.2 32.6% 17.5%;
-    --muted-foreground: 215 20.2% 65.1%;
-    --accent: 217.2 32.6% 17.5%;
-    --accent-foreground: 210 40% 98%;
-    --destructive: 0 62.8% 30.6%;
-    --destructive-foreground: 210 40% 98%;
-    --success: 142 76% 36%;
-    --success-foreground: 210 40% 98%;
-    --warning: 38 92% 50%;
-    --warning-foreground: 222.2 47.4% 11.2%;
-    --border: 217.2 32.6% 17.5%;
-    --input: 217.2 32.6% 17.5%;
-    --ring: 224.3 76.3% 48%;
-    --border-width: 1px;
-    --shadow: 0 1px 3px 0 rgb(0 0 0 / 0.3), 0 1px 2px -1px rgb(0 0 0 / 0.3);
-    --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.3), 0 4px 6px -4px rgb(0 0 0 / 0.3);
-    --font-sans: ${fontValue};
-    --font-heading: ${fontValue};
-  }
-}
-body {
-  @apply bg-background text-foreground font-sans;
-}`;
-}
-export function utilsTs() {
-	return `import { clsx, type ClassValue } from 'clsx'
-import { twMerge } from 'tailwind-merge'
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
-}`;
-}
-export function proxyTs() {
-	return `/*
- * HelloLeo Integration Proxy -- runtime helper for connected integrations.
- *
- * All third-party APIs (Odoo, Airtable, HubSpot, Stripe, Notion, Gladia,
- * Microsoft 365, Klaviyo, Supabase, DimoMaint, etc.) are reachable through
- * this single proxy. The proxy handles auth and CORS using credentials the
- * user already configured in Project Settings -- you NEVER pass an API key
- * from frontend code, and you NEVER call third-party hosts directly.
- *
- * Two modes:
- *   A) Frontend-only project -> import callIntegration() from this file.
- *   B) HelloLeo Cloud project -> route via Worker fetch(env.INTEGRATION_PROXY).
- *      Use Cloud whenever the project needs backend logic, automations,
- *      webhooks, scheduled jobs, or AI agents. Keep secrets server-side.
- *
- * Integration slugs:
- *   Use the exact slug from the Enabled MCP list with the "pipedream-"
- *   prefix removed. e.g. "pipedream-gorgias_oauth" -> "gorgias_oauth".
- *   Native integrations (odoo, airtable) keep their plain name.
- *
- * Response shape (always wrapped):
- *   { success: boolean, status: number, data: <provider payload> }
- *
- *   Unwrap "data" by provider:
- *     odoo            -> data.result
- *     airtable        -> data.records
- *     notion          -> data.results
- *     microsoft 365   -> data.value
- *     klaviyo         -> data.data
- *     supabase / dimomaint -> data
- *
- * Pagination: put query params directly in the endpoint string,
- *   e.g. endpoint: '/api/tickets?cursor=xyz&per_page=100'.
- *   Read pagination metadata from the response to build the next call.
- *   Never .filter() large lists in the frontend -- paginate server-side.
- *
- * Secrets for non-integration APIs (e.g. raw OpenAI): store them in
- * HelloLeo Cloud -> Settings -> Cloud -> Secrets, and read via env.SECRET_NAME
- * from a Worker. Never embed secrets in frontend code.
+/**
+ * Identifier for the scaffold template a project was generated from. It is
+ * also the directory name under src/templates/. Written to .leo/project.json
+ * so the webapp / leo-core can tell which template (and therefore which
+ * conventions: TanStack Router file routing, Tailwind v4, shadcn/ui) a
+ * workspace was bootstrapped with. Bump this (and add a new templates/<id>/
+ * dir) when the scaffold's shape changes.
  */
+export const SCAFFOLD_VERSION = "tanstack-router-2026-06-15";
-const PROJECT_UUID = import.meta.env.VITE_PROJECT_UUID ?? '';
-export const INTEGRATION_PROXY_URL =
-  import.meta.env.VITE_INTEGRATION_PROXY_URL ??
-  \`https://api.app.helloleo.dev/api/integration-proxy/\${PROJECT_UUID}\`;
-export interface ProxyRequest {
-  integration: string;
-  endpoint: string;
-  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-  body?: unknown;
-  headers?: Record<string, string>;
-}
-export interface ProxyResponse<T = unknown> {
-  success: boolean;
-  status: number;
-  data: T;
-}
-export async function callIntegration<T = unknown>(
-  req: ProxyRequest,
-): Promise<ProxyResponse<T>> {
-  const res = await fetch(INTEGRATION_PROXY_URL, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ method: 'POST', ...req }),
-  });
-  return res.json();
-}
-/* Example -- Odoo search_read:
- *
- *   const r = await callIntegration({
- *     integration: 'odoo',
- *     endpoint: '/jsonrpc',
- *     body: {
- *       model: 'product.template',
- *       method: 'search_read',
- *       args: [[['type', '=', 'consu']]],
- *       kwargs: { fields: ['name', 'list_price'], limit: 50 },
- *     },
- *   });
- *   const products = r.data?.result ?? [];
+/**
+ * The project workspace directory is named after the project UUID -- the
+ * webapp generates `<slugified-name>-<uuidv4>` (actions.ts createProject)
+ * and leo-core mounts the project at /workspace/<uuid>. Baking it into
+ * proxy.ts at scaffold time removes the VITE_PROJECT_UUID env var, which
+ * nothing in the infrastructure ever set and which Leo kept mis-generating.
  */
-`;
-}
-function hexToHslTriplet(hex: string): string {
-	let h = hex.trim().replace(/^#/, "");
-	if (h.length === 3) {
-		h = h
-			.split("")
-			.map((c) => c + c)
-			.join("");
-	}
-	if (!/^[0-9a-fA-F]{6}$/.test(h)) return "";
-	const r = Number.parseInt(h.slice(0, 2), 16) / 255;
-	const g = Number.parseInt(h.slice(2, 4), 16) / 255;
-	const b = Number.parseInt(h.slice(4, 6), 16) / 255;
-	const max = Math.max(r, g, b);
-	const min = Math.min(r, g, b);
-	const l = (max + min) / 2;
-	let s = 0;
-	let hue = 0;
-	if (max !== min) {
-		const d = max - min;
-		s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
-		switch (max) {
-			case r:
-				hue = (g - b) / d + (g < b ? 6 : 0);
-				break;
-			case g:
-				hue = (b - r) / d + 2;
-				break;
-			default:
-				hue = (r - g) / d + 4;
-		}
-		hue *= 60;
-	}
-	return `${Math.round(hue)} ${Math.round(s * 100)}% ${Math.round(l * 100)}%`;
-}
-export function normalizePrimaryColor(value: string): string {
-	const trimmed = value.trim();
-	if (/^(#|[0-9a-fA-F]{3}$|[0-9a-fA-F]{6}$)/.test(trimmed)) {
-		const hsl = hexToHslTriplet(trimmed);
-		if (hsl) return hsl;
-	}
-	return trimmed;
-}
-function mainTsx() {
-	return `import React from 'react'
-import ReactDOM from 'react-dom/client'
-import App from './App'
-import './index.css'
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>,
-)`;
+export function projectUuidFromDir(dir: string): string {
+	return path.basename(dir);
 }
 export interface BaseScaffoldOptions {
 	name?: string;
-	primaryColor?: string;
-	fontFamily?: string;
-	borderRadius?: string;
 }
 /**
- * Write the 9 base scaffold files (no integrations). Shared between
- * `scaffold` (frontend-only) and `setup_netsuite` (base + OAuth files).
- * Returns the list of relative file paths written.
+ * Write the base scaffold by rendering the TanStack Router template into dir,
+ * then adding .leo/project.json (template metadata the tool owns, not part of
+ * the template tree). Shared between `scaffold` (frontend-only) and
+ * `setup_netsuite` (base + OAuth files). Returns the relative paths written.
  */
 export async function writeBaseScaffold(
 	opts: BaseScaffoldOptions,
 	dir: string,
 ): Promise<string[]> {
 	const name = opts.name ?? "leo-project";
-	const primary = normalizePrimaryColor(
-		opts.primaryColor ?? "221.2 83.2% 53.3%",
-	);
-	const font = opts.fontFamily ?? "Inter";
-	const radius = opts.borderRadius ?? "0.5rem";
-	await mkdir(path.join(dir, "src", "lib"), { recursive: true });
-	const files: [string, string][] = [
-		["package.json", packageJson(name)],
-		["index.html", indexHtml(font)],
-		["vite.config.js", viteConfig()],
-		["tailwind.config.js", tailwindConfig()],
-		["postcss.config.js", postcssConfig()],
-		[path.join("src", "index.css"), indexCss(primary, font, radius)],
-		[path.join("src", "lib", "utils.ts"), utilsTs()],
-		[path.join("src", "lib", "proxy.ts"), proxyTs()],
-		[path.join("src", "main.tsx"), mainTsx()],
-	];
-	const created: string[] = [];
-	for (const [filePath, content] of files) {
-		await Bun.write(path.join(dir, filePath), content);
-		created.push(filePath);
-	}
-	return created;
-}
-// NOTE: `writeBaseScaffold` + the design-system helpers above are the legacy
-// React+Vite base, still consumed by `setup_netsuite`. The `scaffold` TOOL below
-// is the current TanStack scaffolder (spa/ssr) — it replaced the old React tool.
-/*
- * scaffold_app -- next-gen HelloLeo scaffold.
- *
- * One tool, two modes (both TanStack, both Vite, same design system + tooling):
- *   - mode "spa"  -> TanStack Router SPA (client-only). Runs `vite dev`; deploys
- *                    as a static Vite app on the preview sandbox, like today.
- *   - mode "ssr"  -> TanStack Start (Node server target, validated by
- *                    cf-sandbox-tanstack-poc). SSR loaders + server functions +
- *                    Drizzle. Runs `vite dev`; on the preview sandbox the Node
- *                    server runs inside the CF Sandbox container (the PM2
- *                    replacement). DB adapter swaps libsql (dev) -> D1 (prod);
- *                    wrangler.jsonc carries the Workers-for-Platforms prod target.
- *                    (Executing SSR *on workerd itself* needs a newer TanStack/CF
- *                    integration than the pinned 1.121.x — tracked as follow-up.)
- *
- * Shared across both:
- *   - Tailwind v3 + the HelloLeo design-system tokens (src/styles/app.css) so
- *     the no-code Design panel round-trip keeps working (same tokens as the
- *     legacy `scaffold`).
- *   - ShadcnUI primitives (components.json + src/components/ui/*) consuming the
- *     design tokens -- never hardcoded colors.
- *   - Biome (biome.json) for format + lint. No ESLint/Prettier.
- *   - Strict TypeScript (tsconfig.json: strict, bundler resolution, @/* paths)
- *     so the editor / OpenCode LSP gives full type info.
- *
- * Version pins mirror the validated cf-sandbox-tanstack-poc:
- * TanStack 1.121.x, React 19, Vite 6, @cloudflare/* current.
- */
-const REACT = "^19.0.0";
-const VITE = "^6.0.5";
-const TS = "^5.6.3";
-// Pin EXACT (no caret): @tanstack/react-router and @tanstack/react-start must
-// share one @tanstack/router-core. react-router floats ahead of react-start's
-// release line, so a caret skews router-core and SSR breaks (missing
-// processRouteTree export). 1.131.50 is the matched set react-start ships with.
-const TANSTACK = "1.131.50";
-const BIOME = "2.4.8";
-// ---------- shared tooling files ----------
-function tsconfig(): string {
-	return JSON.stringify(
-		{
-			compilerOptions: {
-				target: "ES2022",
-				module: "ESNext",
-				moduleResolution: "Bundler",
-				lib: ["ES2022", "DOM", "DOM.Iterable"],
-				jsx: "react-jsx",
-				strict: true,
-				noUncheckedIndexedAccess: true,
-				noUnusedLocals: true,
-				noUnusedParameters: true,
-				verbatimModuleSyntax: true,
-				skipLibCheck: true,
-				noEmit: true,
-				baseUrl: ".",
-				paths: { "@/*": ["./src/*"] },
-				types: ["vite/client"],
-			},
-			include: ["src", "*.config.ts"],
-		},
-		null,
-		2,
-	);
-}
-function biomeJson(): string {
-	return JSON.stringify(
-		{
-			$schema: `https://biomejs.dev/schemas/${BIOME}/schema.json`,
-			vcs: { enabled: true, clientKind: "git", useIgnoreFile: true },
-			files: { ignoreUnknown: true },
-			formatter: { enabled: true, indentStyle: "tab", lineWidth: 80 },
-			linter: { enabled: true, rules: { recommended: true } },
-			javascript: { formatter: { quoteStyle: "double" } },
-			assist: { actions: { source: { organizeImports: "on" } } },
-		},
-		null,
-		2,
-	);
-}
-function componentsJson(): string {
-	// shadcn/ui config -- "new-york" style on Tailwind v3 with our token names.
-	return JSON.stringify(
-		{
-			$schema: "https://ui.shadcn.com/schema.json",
-			style: "new-york",
-			rsc: false,
-			tsx: true,
-			tailwind: {
-				config: "tailwind.config.js",
-				css: "src/styles/app.css",
-				baseColor: "slate",
-				cssVariables: true,
-				prefix: "",
-			},
-			aliases: {
-				components: "@/components",
-				utils: "@/lib/utils",
-				ui: "@/components/ui",
-				lib: "@/lib",
-				hooks: "@/hooks",
-			},
-			iconLibrary: "lucide",
-		},
-		null,
-		2,
-	);
-}
-// ---------- shadcn primitives (token-driven) ----------
-function uiButton(): string {
-	return `import * as React from "react"
-import { Slot } from "@radix-ui/react-slot"
-import { cva, type VariantProps } from "class-variance-authority"
-import { cn } from "@/lib/utils"
-const buttonVariants = cva(
-  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4 [&_svg]:shrink-0",
-  {
-    variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground shadow hover:bg-primary/90",
-        destructive: "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90",
-        outline: "border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground",
-        secondary: "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
-        ghost: "hover:bg-accent hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-9 px-4 py-2",
-        sm: "h-8 rounded-md px-3 text-xs",
-        lg: "h-10 rounded-md px-8",
-        icon: "h-9 w-9",
-      },
-    },
-    defaultVariants: { variant: "default", size: "default" },
-  },
-)
-export interface ButtonProps
-  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {
-  asChild?: boolean
-}
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button"
-    return (
-      <Comp className={cn(buttonVariants({ variant, size, className }))} ref={ref} {...props} />
-    )
-  },
-)
-Button.displayName = "Button"
-export { Button, buttonVariants }
-`;
-}
-function uiCard(): string {
-	return `import * as React from "react"
-import { cn } from "@/lib/utils"
-const Card = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className={cn("rounded-lg border bg-card text-card-foreground shadow", className)} {...props} />
-  ),
-)
-Card.displayName = "Card"
-const CardHeader = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className={cn("flex flex-col space-y-1.5 p-6", className)} {...props} />
-  ),
-)
-CardHeader.displayName = "CardHeader"
-const CardTitle = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className={cn("font-heading font-semibold leading-none tracking-tight", className)} {...props} />
-  ),
-)
-CardTitle.displayName = "CardTitle"
-const CardDescription = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className={cn("text-sm text-muted-foreground", className)} {...props} />
-  ),
-)
-CardDescription.displayName = "CardDescription"
-const CardContent = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ className, ...props }, ref) => (
-    <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
-  ),
-)
-CardContent.displayName = "CardContent"
-export { Card, CardHeader, CardTitle, CardDescription, CardContent }
-`;
-}
-function uiInput(): string {
-	return `import * as React from "react"
-import { cn } from "@/lib/utils"
-const Input = React.forwardRef<HTMLInputElement, React.InputHTMLAttributes<HTMLInputElement>>(
-  ({ className, type, ...props }, ref) => (
-    <input
-      type={type}
-      ref={ref}
-      className={cn(
-        "flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
-        className,
-      )}
-      {...props}
-    />
-  ),
-)
-Input.displayName = "Input"
-export { Input }
-`;
-}
-function uiTextarea(): string {
-	return `import * as React from "react"
-import { cn } from "@/lib/utils"
-const Textarea = React.forwardRef<HTMLTextAreaElement, React.TextareaHTMLAttributes<HTMLTextAreaElement>>(
-  ({ className, ...props }, ref) => (
-    <textarea
-      ref={ref}
-      className={cn(
-        "flex min-h-[60px] w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
-        className,
-      )}
-      {...props}
-    />
-  ),
-)
-Textarea.displayName = "Textarea"
-export { Textarea }
-`;
-}
-function uiLabel(): string {
-	return `import * as React from "react"
-import { cn } from "@/lib/utils"
-const Label = React.forwardRef<HTMLLabelElement, React.LabelHTMLAttributes<HTMLLabelElement>>(
-  ({ className, ...props }, ref) => (
-    <label
-      ref={ref}
-      className={cn(
-        "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",
-        className,
-      )}
-      {...props}
-    />
-  ),
-)
-Label.displayName = "Label"
-export { Label }
-`;
-}
-function uiBadge(): string {
-	return `import * as React from "react"
-import { cva, type VariantProps } from "class-variance-authority"
-import { cn } from "@/lib/utils"
-const badgeVariants = cva(
-  "inline-flex items-center rounded-md border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
-  {
-    variants: {
-      variant: {
-        default: "border-transparent bg-primary text-primary-foreground shadow hover:bg-primary/80",
-        secondary: "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        destructive: "border-transparent bg-destructive text-destructive-foreground shadow hover:bg-destructive/80",
-        outline: "text-foreground",
-      },
-    },
-    defaultVariants: { variant: "default" },
-  },
-)
-export interface BadgeProps
-  extends React.HTMLAttributes<HTMLDivElement>,
-    VariantProps<typeof badgeVariants> {}
-function Badge({ className, variant, ...props }: BadgeProps) {
-  return <div className={cn(badgeVariants({ variant }), className)} {...props} />
-}
-export { Badge, badgeVariants }
-`;
-}
-// ---------- mode: SPA (TanStack Router) ----------
-function spaPackageJson(name: string): string {
-	return JSON.stringify(
-		{
-			name,
-			private: true,
-			version: "0.0.0",
-			type: "module",
-			scripts: {
-				dev: "vite dev --host",
-				build: "vite build",
-				preview: "vite preview",
-				lint: "biome check --write .",
-			},
-			dependencies: {
-				react: REACT,
-				"react-dom": REACT,
-				"@tanstack/react-router": TANSTACK,
-				"class-variance-authority": "^0.7.1",
-				clsx: "^2.1.1",
-				"tailwind-merge": "^2.6.0",
-				"lucide-react": "^0.468.0",
-				"@radix-ui/react-slot": "^1.1.1",
-			},
-			devDependencies: {
-				"@tanstack/router-plugin": TANSTACK,
-				"@types/react": "^19.0.0",
-				"@types/react-dom": "^19.0.0",
-				"@vitejs/plugin-react": "^4.3.4",
-				"@biomejs/biome": BIOME,
-				autoprefixer: "^10.4.20",
-				postcss: "^8.4.49",
-				tailwindcss: "^3.4.17",
-				typescript: TS,
-				vite: VITE,
-			},
-		},
-		null,
-		2,
+	const created = await renderTemplate(
+		SCAFFOLD_VERSION,
+		{ LEO_NAME: name, LEO_PROJECT_UUID: projectUuidFromDir(dir) },
+		dir,
 	);
-}
-function spaViteConfig(): string {
-	return `import { defineConfig } from "vite"
-import react from "@vitejs/plugin-react"
-import { TanStackRouterVite } from "@tanstack/router-plugin/vite"
-import path from "node:path"
-export default defineConfig({
-  // File-based routing: routes live in src/routes, routeTree.gen.ts is generated.
-  plugins: [TanStackRouterVite({ target: "react", autoCodeSplitting: true }), react()],
-  // allowedHosts:true is REQUIRED for the HelloLeo preview sandbox (proxied host).
-  server: { allowedHosts: true },
-  resolve: { alias: { "@": path.resolve(__dirname, "./src") } },
-})
-`;
-}
-function spaIndexHtml(fontFamily: string): string {
-	const fontParam = fontFamily.replace(/\s+/g, "+");
-	return `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <link rel="preconnect" href="https://fonts.googleapis.com">
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link href="https://fonts.googleapis.com/css2?family=${fontParam}:wght@400;500;600;700&display=swap" rel="stylesheet">
-    <title>App</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>
-`;
-}
-function spaMainTsx(): string {
-	return `import React from "react"
-import ReactDOM from "react-dom/client"
-import { RouterProvider, createRouter } from "@tanstack/react-router"
-import { routeTree } from "./routeTree.gen"
-import "./styles/app.css"
-const router = createRouter({ routeTree, defaultPreload: "intent", scrollRestoration: true })
-declare module "@tanstack/react-router" {
-  interface Register {
-    router: typeof router
-  }
-}
-ReactDOM.createRoot(document.getElementById("root") as HTMLElement).render(
-  <React.StrictMode>
-    <RouterProvider router={router} />
-  </React.StrictMode>,
-)
-`;
-}
-function spaRootRoute(): string {
-	return `import { Outlet, createRootRoute } from "@tanstack/react-router"
-export const Route = createRootRoute({
-  errorComponent: ({ error }) => (
-    <main className="mx-auto flex min-h-screen max-w-2xl flex-col items-center justify-center gap-3 p-8">
-      <h1 className="text-2xl font-heading font-semibold text-destructive">Something went wrong</h1>
-      <pre className="max-w-full overflow-auto rounded-md bg-muted p-4 text-left text-xs text-muted-foreground">{error instanceof Error ? error.message : String(error)}</pre>
-    </main>
-  ),
-  notFoundComponent: () => (
-    <main className="mx-auto flex min-h-screen max-w-2xl flex-col items-center justify-center gap-2 p-8">
-      <h1 className="text-2xl font-heading font-semibold">404</h1>
-      <p className="text-muted-foreground">This page could not be found.</p>
-    </main>
-  ),
-  component: () => (
-    <div className="min-h-screen bg-background text-foreground">
-      <Outlet />
-    </div>
-  ),
-})
-`;
-}
-function spaIndexRoute(): string {
-	return `import { createFileRoute } from "@tanstack/react-router"
-import { Button } from "@/components/ui/button"
-import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
-export const Route = createFileRoute("/")({ component: Home })
-function Home() {
-  return (
-    <main className="mx-auto flex min-h-screen max-w-2xl flex-col items-center justify-center gap-6 p-8">
-      <Card className="w-full">
-        <CardHeader>
-          <CardTitle className="text-2xl">Welcome to your app</CardTitle>
-          <CardDescription>TanStack Router SPA · Tailwind · shadcn/ui · Biome</CardDescription>
-        </CardHeader>
-        <CardContent className="flex gap-3">
-          <Button>Get started</Button>
-          <Button variant="outline">Learn more</Button>
-        </CardContent>
-      </Card>
-    </main>
-  )
-}
-`;
-}
-// ---------- mode: SSR (TanStack Start on Cloudflare workerd) ----------
-function ssrPackageJson(name: string): string {
-	return JSON.stringify(
-		{
-			name,
-			private: true,
-			version: "0.0.0",
-			type: "module",
-			scripts: {
-				// Node-target SSR (Nitro). vite dev for local; build emits
-				// .output/server/index.mjs (PORT-aware) which the CF Sandbox runs.
-				// `predev` runs automatically on `npm run dev` (the sandbox's launch
-				// command) → creates the DB tables before the server starts, so a
-				// DB query in a route loader never hits "no such table".
-				predev: "drizzle-kit push --force",
-				dev: "vite dev --host",
-				build: "vite build",
-				// `preview` is what HelloLeo's PM2 publish runs for vite projects to
-				// serve the production build. For node-SSR that's the Nitro server
-				// (honours PORT). `prepreview` runs first → ensures DB tables exist.
-				prepreview: "drizzle-kit push --force",
-				preview: "node .output/server/index.mjs",
-				start: "node .output/server/index.mjs",
-				"db:generate": "drizzle-kit generate",
-				"db:push": "drizzle-kit push --force",
-				deploy: "wrangler deploy",
-				lint: "biome check --write .",
-			},
-			dependencies: {
-				react: REACT,
-				"react-dom": REACT,
-				"@tanstack/react-router": TANSTACK,
-				"@tanstack/react-start": TANSTACK,
-				"drizzle-orm": "^0.36.4",
-				"@libsql/client": "^0.14.0",
-				"class-variance-authority": "^0.7.1",
-				clsx: "^2.1.1",
-				"tailwind-merge": "^2.6.0",
-				"lucide-react": "^0.468.0",
-				"@radix-ui/react-slot": "^1.1.1",
-			},
-			devDependencies: {
-				wrangler: "^4.20.0",
-				"@cloudflare/workers-types": "^4.20250601.0",
-				"drizzle-kit": "^0.28.1",
-				"@types/node": "^22.0.0",
-				"@types/react": "^19.0.0",
-				"@types/react-dom": "^19.0.0",
-				"@vitejs/plugin-react": "^4.3.4",
-				"@biomejs/biome": BIOME,
-				autoprefixer: "^10.4.20",
-				postcss: "^8.4.49",
-				tailwindcss: "^3.4.17",
-				typescript: TS,
-				vite: VITE,
-			},
-		},
-		null,
-		2,
-	);
-}
-function ssrViteConfig(): string {
-	return `import { defineConfig } from "vite"
-import react from "@vitejs/plugin-react"
-import { tanstackStart } from "@tanstack/react-start/plugin/vite"
-import path from "node:path"
-// TanStack Start default (Node server) target -> dist/server/server.js + dist/client.
-// The CF Sandbox container runs that server (PORT-aware), proven by the POC.
-export default defineConfig({
-  plugins: [tanstackStart({ customViteReactPlugin: true }), react()],
-  // allowedHosts:true is REQUIRED for the HelloLeo preview sandbox (proxied host).
-  server: { allowedHosts: true },
-  // Pre-bundle shared deps at boot so vite doesn't re-optimize + restart the dev
-  // server mid-request (which 500s the first SSR load with "transport disconnected").
-  optimizeDeps: {
-    include: ["clsx", "tailwind-merge", "class-variance-authority", "lucide-react"],
-  },
-  resolve: { alias: { "@": path.resolve(__dirname, "./src") } },
-  // __WORKERD__ tells src/db which runtime it's building for: true only for the
-  // prod cloudflare-module build (NITRO_PRESET set by the publish flow), false
-  // for dev and the Node preview build. Lets getDb dead-code-eliminate the wrong
-  // DB driver per target.
-  define: {
-    __WORKERD__: JSON.stringify(process.env.NITRO_PRESET === "cloudflare-module"),
-  },
-  // "cloudflare:workers" is a workerd-only module (src/db reads the D1 binding
-  // from it in prod). vite's SSR pass can't resolve it — externalize so the
-  // workerd build keeps it as an import; on other targets it's DCE'd away.
-  build: { rollupOptions: { external: ["cloudflare:workers"] } },
-})
-`;
-}
-function ssrWranglerJsonc(name: string): string {
-	return `{
-  // PROD target (Workers for Platforms). Dev/preview runs the Node server in the
-  // CF Sandbox container and does NOT use this file.
-  //
-  // NOTE: HelloLeo's publish flow REGENERATES this file at deploy time — it
-  // auto-creates the D1 database, fills in database_id, and pins its own
-  // compatibility_date. This file is the local-dev / manual \`wrangler deploy\`
-  // copy; for a manual deploy, run \`wrangler d1 create ${name}\` and paste the
-  // id below first. compatibility_date is kept at/under the runtime baseline so
-  // \`wrangler dev\` works on the pinned workerd binary.
-  "$schema": "node_modules/wrangler/config-schema.json",
-  "name": "${name}",
-  "compatibility_date": "2026-04-01",
-  "compatibility_flags": ["nodejs_compat"],
-  "observability": { "enabled": true },
-  "assets": { "directory": ".output/public", "binding": "ASSETS" },
-  "d1_databases": [
-    { "binding": "DB", "database_name": "${name}", "database_id": "" }
-  ]
-}
-`;
-}
-function ssrRouter(): string {
-	return `import { createRouter as createTanStackRouter } from "@tanstack/react-router"
-import { routeTree } from "./routeTree.gen"
-export function createRouter() {
-  return createTanStackRouter({
-    routeTree,
-    defaultPreload: "intent",
-    scrollRestoration: true,
-  })
-}
-declare module "@tanstack/react-router" {
-  interface Register {
-    router: ReturnType<typeof createRouter>
-  }
-}
-`;
-}
-function ssrRootRoute(fontFamily: string): string {
-	const fontParam = fontFamily.replace(/\s+/g, "+");
-	return `import { Outlet, createRootRoute, HeadContent, Scripts } from "@tanstack/react-router"
-import appCss from "../styles/app.css?url"
-export const Route = createRootRoute({
-  head: () => ({
-    meta: [
-      { charSet: "utf-8" },
-      { name: "viewport", content: "width=device-width, initial-scale=1" },
-      { title: "App" },
-    ],
-    // The design-system font is loaded here (SSR has no index.html). Keep the
-    // family in sync with --font-sans / --font-heading in src/styles/app.css.
-    links: [
-      { rel: "preconnect", href: "https://fonts.googleapis.com" },
-      { rel: "preconnect", href: "https://fonts.gstatic.com", crossOrigin: "anonymous" },
-      { rel: "stylesheet", href: "https://fonts.googleapis.com/css2?family=${fontParam}:wght@400;500;600;700&display=swap" },
-      { rel: "stylesheet", href: appCss },
-    ],
-  }),
-  errorComponent: ({ error }) => (
-    <main className="mx-auto flex min-h-screen max-w-2xl flex-col items-center justify-center gap-3 p-8">
-      <h1 className="text-2xl font-heading font-semibold text-destructive">Something went wrong</h1>
-      <pre className="max-w-full overflow-auto rounded-md bg-muted p-4 text-left text-xs text-muted-foreground">{error instanceof Error ? error.message : String(error)}</pre>
-    </main>
-  ),
-  notFoundComponent: () => (
-    <main className="mx-auto flex min-h-screen max-w-2xl flex-col items-center justify-center gap-2 p-8">
-      <h1 className="text-2xl font-heading font-semibold">404</h1>
-      <p className="text-muted-foreground">This page could not be found.</p>
-    </main>
-  ),
-  component: RootComponent,
-})
-function RootComponent() {
-  return (
-    <html lang="en">
-      <head>
-        <HeadContent />
-      </head>
-      <body className="min-h-screen bg-background text-foreground font-sans">
-        <Outlet />
-        <Scripts />
-      </body>
-    </html>
-  )
-}
-`;
-}
-function ssrIndexRoute(): string {
-	return `import { createFileRoute } from "@tanstack/react-router"
-import { createServerFn } from "@tanstack/react-start"
-import { Button } from "@/components/ui/button"
-import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
-// Server functions (TanStack Start 1.131.x API — IMPORTANT, do not invent
-// methods):
-//   - No input:   createServerFn({ method: "GET" }).handler(async () => {...})
-//   - With input: createServerFn({ method: "POST" })
-//                   .validator((d: { title: string }) => d)   // NOT .inputType()
-//                   .handler(async ({ data }) => { data.title })  // input is { data }
-//     Call it as: addTask({ data: { title } })   // NOT addTask({ title })
-//   - DB access:  \`const db = await getDb()\` (async). Resolves D1 in prod,
-//                 libsql in dev. Safe in server fns AND route loaders — just
-//                 never at module top. Prefer server functions for mutations.
-// Example DB-backed server fn (dev=libsql, prod=D1, same code):
-//   const getItems = createServerFn({ method: "GET" }).handler(async () => {
-//     const db = await getDb()
-//     return await db.select().from(items)
-//   })
-const getServerInfo = createServerFn({ method: "GET" }).handler(async () => {
-  return { renderedAt: new Date().toISOString() }
-})
-export const Route = createFileRoute("/")({
-  loader: () => getServerInfo(),
-  component: Home,
-})
-function Home() {
-  const info = Route.useLoaderData()
-  return (
-    <main className="mx-auto flex min-h-screen max-w-2xl flex-col items-center justify-center gap-6 p-8">
-      <Card className="w-full">
-        <CardHeader>
-          <CardTitle className="text-2xl">Welcome to your app</CardTitle>
-          <CardDescription>TanStack Start SSR (workerd) · Tailwind · shadcn/ui · Biome · Drizzle/D1</CardDescription>
-        </CardHeader>
-        <CardContent className="flex flex-col gap-3">
-          <p className="text-sm text-muted-foreground">Server-rendered at {info.renderedAt}</p>
-          <div className="flex gap-3">
-            <Button>Get started</Button>
-            <Button variant="outline">Learn more</Button>
-          </div>
-        </CardContent>
-      </Card>
-    </main>
-  )
-}
-`;
-}
-function ssrDbSchema(): string {
-	return `import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core"
-// Example table. dev uses local D1 (miniflare), prod uses the D1 binding "DB".
-export const items = sqliteTable("items", {
-  id: integer("id").primaryKey({ autoIncrement: true }),
-  title: text("title").notNull(),
-  createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()),
-})
-`;
-}
-function ssrDbIndex(): string {
-	return `/// <reference types="@cloudflare/workers-types" />
-import { drizzle as drizzleD1 } from "drizzle-orm/d1"
-import * as schema from "./schema"
-// Resolve the DB for the CURRENT request. ASYNC — always \`await getDb()\`.
-// Works from ANYWHERE on the server (route loaders, server functions,
-// beforeLoad) because it does NOT depend on AsyncLocalStorage / getEvent (which
-// is only populated inside server functions under workerd — calling getDb in a
-// loader the old way threw "No HTTPEvent found in AsyncLocalStorage").
-//   - PROD (workerd): the D1 binding read straight from the per-request env.
-//   - DEV (node SSR): a local libsql file, imported lazily and behind the DEV
-//     guard so neither @libsql/client nor node:stream is ever bundled into the
-//     workerd build (which would break it).
-// Same sqlite schema both ways.
-// __WORKERD__ is replaced at build time by vite (see vite.config.ts): true only
-// for the prod cloudflare-module build, false for dev + the Node preview build.
-// Using it (not import.meta.env.DEV) is what lets the Node preview — also a
-// production build — still take the libsql path. It's a literal, so the unused
-// branch (and its driver) is dead-code-eliminated from each bundle.
-declare const __WORKERD__: boolean
-export async function getDb() {
-  if (__WORKERD__) {
-    const { env } = await import("cloudflare:workers")
-    return drizzleD1((env as unknown as { DB: D1Database }).DB, { schema })
-  }
-  const { drizzle } = await import("drizzle-orm/libsql")
-  const { createClient } = await import("@libsql/client")
-  return drizzle(
-    createClient({ url: process.env.DATABASE_URL ?? "file:./local.db" }),
-    { schema },
-  )
-}
-`;
-}
-function ssrDrizzleConfig(): string {
-	return `import { defineConfig } from "drizzle-kit"
-// Dev/preview: push the schema straight into the local libsql file (no D1 creds
-// needed) — this is what \`predev\` runs so tables exist before the dev server.
-// Prod (D1) uses generated migrations applied via wrangler, not this push.
-export default defineConfig({
-  dialect: "sqlite",
-  schema: "./src/db/schema.ts",
-  out: "./drizzle",
-  dbCredentials: { url: process.env.DATABASE_URL ?? "file:./local.db" },
-})
-`;
-}
-function gitignore(mode: string): string {
-	const base = `node_modules
-dist
-.output
-.nitro
-.tanstack
-.vite
-local.db
-*.local
-.DS_Store
-# Generated by the TanStack Router/Start vite plugin
-src/routeTree.gen.ts
-`;
-	return mode === "ssr" ? `${base}.wrangler\n.dev.vars\n` : base;
-}
-// ---------- writer ----------
-interface ScaffoldAppOptions {
-	name?: string;
-	mode?: "spa" | "ssr";
-	primaryColor?: string;
-	fontFamily?: string;
-	borderRadius?: string;
-}
-async function writeAppScaffold(
-	opts: ScaffoldAppOptions,
-	dir: string,
-): Promise<string[]> {
-	const name = opts.name ?? "leo-app";
-	const mode = opts.mode ?? "spa";
-	const primary = normalizePrimaryColor(
-		opts.primaryColor ?? "221.2 83.2% 53.3%",
+	await mkdir(path.join(dir, ".leo"), { recursive: true });
+	const leoPath = path.join(".leo", "project.json");
+	await Bun.write(
+		path.join(dir, leoPath),
+		JSON.stringify({ $schema: 1, scaffold: SCAFFOLD_VERSION }, null, 2),
 	);
-	const font = opts.fontFamily ?? "Inter";
-	const radius = opts.borderRadius ?? "0.5rem";
-	await mkdir(path.join(dir, "src", "lib"), { recursive: true });
-	await mkdir(path.join(dir, "src", "components", "ui"), { recursive: true });
-	await mkdir(path.join(dir, "src", "routes"), { recursive: true });
-	await mkdir(path.join(dir, "src", "styles"), { recursive: true });
-	// Files common to both modes.
-	const files: [string, string][] = [
-		["tsconfig.json", tsconfig()],
-		["biome.json", biomeJson()],
-		["components.json", componentsJson()],
-		["tailwind.config.js", tailwindConfig()],
-		["postcss.config.js", postcssConfig()],
-		[".gitignore", gitignore(mode)],
-		[path.join("src", "styles", "app.css"), indexCss(primary, font, radius)],
-		[path.join("src", "lib", "utils.ts"), utilsTs()],
-		[path.join("src", "lib", "proxy.ts"), proxyTs()],
-		[path.join("src", "components", "ui", "button.tsx"), uiButton()],
-		[path.join("src", "components", "ui", "card.tsx"), uiCard()],
-		[path.join("src", "components", "ui", "input.tsx"), uiInput()],
-		[path.join("src", "components", "ui", "textarea.tsx"), uiTextarea()],
-		[path.join("src", "components", "ui", "label.tsx"), uiLabel()],
-		[path.join("src", "components", "ui", "badge.tsx"), uiBadge()],
-	];
-	if (mode === "spa") {
-		files.push(
-			["package.json", spaPackageJson(name)],
-			["vite.config.ts", spaViteConfig()],
-			["index.html", spaIndexHtml(font)],
-			[path.join("src", "main.tsx"), spaMainTsx()],
-			[path.join("src", "routes", "__root.tsx"), spaRootRoute()],
-			[path.join("src", "routes", "index.tsx"), spaIndexRoute()],
-		);
-	} else {
-		await mkdir(path.join(dir, "src", "db"), { recursive: true });
-		files.push(
-			["package.json", ssrPackageJson(name)],
-			["vite.config.ts", ssrViteConfig()],
-			["wrangler.jsonc", ssrWranglerJsonc(name)],
-			["drizzle.config.ts", ssrDrizzleConfig()],
-			[path.join("src", "router.tsx"), ssrRouter()],
-			[path.join("src", "routes", "__root.tsx"), ssrRootRoute(font)],
-			[path.join("src", "routes", "index.tsx"), ssrIndexRoute()],
-			[path.join("src", "db", "schema.ts"), ssrDbSchema()],
-			[path.join("src", "db", "index.ts"), ssrDbIndex()],
-		);
-	}
-	const created: string[] = [];
-	for (const [filePath, content] of files) {
-		await Bun.write(path.join(dir, filePath), content);
-		created.push(filePath);
-	}
-	return created.sort();
+	return [...created, leoPath];
 }
-export const scaffoldApp = tool({
+export const scaffold = tool({
 	description:
-		"Scaffold a modern TanStack app with the HelloLeo design system, ShadcnUI, " +
-		"Biome and strict TypeScript. Two modes: mode='spa' (TanStack Router, " +
-		"client-only -- use for static frontends / dashboards) or mode='ssr' " +
-		"(TanStack Start on Cloudflare workerd -- use when the project needs a " +
-		"backend, SSR, server functions, or a database via D1/Drizzle). " +
-		"Creates package.json, vite.config.ts, tsconfig.json (strict), biome.json, " +
-		"components.json, tailwind.config.js, postcss.config.js, " +
-		"src/styles/app.css (design tokens, light+dark), src/lib/utils.ts + proxy.ts, " +
-		"shadcn primitives in src/components/ui (Button, Card, Input, Textarea, " +
-		"Label, Badge), and TanStack routes in src/routes. " +
-		"Call this FIRST for any new project before writing feature routes/components. " +
-		"For NetSuite projects use `setup_netsuite` instead.",
+		"Scaffold a new React 19 + Vite + Tailwind CSS v4 + TanStack Router project " +
+		"with shadcn/ui baked in. Renders the full template: TanStack file-based " +
+		"routing (src/routes/), the complete shadcn/ui component set under " +
+		"src/components/ui, src/lib/utils.ts (cn helper), src/lib/proxy.ts " +
+		"(HelloLeo integration proxy), src/styles.css (shadcn design tokens, " +
+		"light+dark), plus package.json, vite.config.ts, tsconfig.json, " +
+		"tsr.config.json, components.json, .gitignore and the generated " +
+		"src/routeTree.gen.ts. Call this FIRST for any new project before adding " +
+		"routes and pages. For NetSuite projects (NetSuite MCP in the live list), " +
+		"call `setup_netsuite` INSTEAD -- it bundles base scaffold + OAuth wiring " +
+		"in one call. Do not call both.",
 	args: {
 		name: tool.schema
 			.string()
 			.optional()
-			.describe("Project name for package.json (default: leo-app)"),
-		mode: tool.schema
-			.enum(["spa", "ssr"])
-			.optional()
-			.describe(
-				"'spa' = TanStack Router client-only (default). 'ssr' = TanStack Start " +
-					"on Cloudflare workerd with SSR + D1/Drizzle. Pick 'ssr' when the app " +
-					"needs a backend, server functions, auth, or a database.",
-			),
-		primaryColor: tool.schema
-			.string()
-			.optional()
-			.describe(
-				'Primary brand color as raw HSL triplet, e.g. "221.2 83.2% 53.3%". ' +
-					'Hex like "#3b82f6" is auto-converted. Default: blue.',
-			),
-		fontFamily: tool.schema
-			.string()
-			.optional()
-			.describe('Google Font family, e.g. "Inter", "Poppins" (default: Inter)'),
-		borderRadius: tool.schema
-			.string()
-			.optional()
-			.describe('Base border radius, e.g. "0.5rem" (default: 0.5rem)'),
+			.describe("Project name for package.json (default: leo-project)"),
 	},
 	async execute(args, context) {
-		const mode = args.mode ?? "spa";
-		const created = await writeAppScaffold(args, context.directory);
-		const next =
-			mode === "ssr"
-				? [
-						"Mode: SSR (TanStack Start, Node server — runs in the CF Sandbox container).",
-						"Dev server: `npm run dev`.",
-						"Add routes in src/routes/*.tsx; server logic via createServerFn.",
-						"Database: edit src/db/schema.ts, `npm run db:push`, query via `db` from src/db.",
-						"  (dev = local libsql file; prod = D1, see wrangler.jsonc).",
-					]
-				: [
-						"Mode: SPA (TanStack Router, client-only).",
-						"Dev server: `npm run dev`.",
-						"Add routes in src/routes/*.tsx (file-based; routeTree.gen.ts is generated).",
-					];
+		const created = await writeBaseScaffold(args, context.directory);
 		return [
-			`Scaffolded ${created.length} files (mode=${mode}):`,
+			`Scaffolded ${created.length} files:`,
 			...created.map((f) => `  - ${f}`),
 			"",
-			...next,
-			"",
-			"Design system: src/styles/app.css tokens (light+dark) drive Tailwind +",
-			"  shadcn. Never hardcode colors -- use bg-primary, text-foreground, etc.",
-			"UI primitives live in src/components/ui (Button, Card scaffolded).",
-			"  Add more shadcn components consuming the same tokens.",
-			"Integrations: callIntegration() from src/lib/proxy.ts.",
-			"Lint/format: `npm run lint` (Biome).",
+			"Next: add routes as files under src/routes/ (TanStack file-based",
+			"  routing). Edit src/routes/index.tsx for the home page.",
+			"UI: shadcn/ui components are already in src/components/ui -- import and",
+			"  use them; do not attempt to re-add via the shadcn CLI.",
+			"Design system: edit tokens in src/styles.css (light + dark blocks).",
+			"Data fetching: React Query is wired (QueryClient on the router context +",
+			"  QueryClientProvider). ALWAYS fetch with @tanstack/react-query --",
+			"  useQuery / useMutation in components, or a route loader calling",
+			"  context.queryClient.ensureQueryData(). Do NOT hand-roll fetches with",
+			"  useEffect + useState. Wrap the fetch call (usually callIntegration())",
+			"  in the queryFn.",
+			"Integration calls: use callIntegration() from src/lib/proxy.ts -- as the",
+			"  queryFn body, never on its own in useEffect. Its header comment",
+			"  documents slugs, response unwrapping, pagination, and frontend-only vs",
+			"  HelloLeo Cloud routing.",
 		].join("\n");
 	},
 });
-// Registered as `scaffold` — this is THE scaffold tool (replaced the legacy
-// React+Vite `scaffold`). The coder UI keys its scaffold events off this name.
 export const ScaffoldPlugin: Plugin = async () => {
 	return {
-		tool: { scaffold: scaffoldApp },
+		tool: { scaffold: scaffold },
 	};
 };