ai-forge-cli 0.2.3 → 0.3.2

package/dist/{add-feature-JBVJHKHX.js → add-feature-MU65GMUK.js}

@@ -76,11 +76,11 @@ var add_feature_default = defineCommand({
       // Route files
       {
         templatePath: "feature/routes/index.tsx.hbs",
-        destPath: join(cwd, "app/routes", name, "index.tsx")
+        destPath: join(cwd, "src/routes", name, "index.tsx")
       },
       {
         templatePath: "feature/routes/$id.tsx.hbs",
-        destPath: join(cwd, "app/routes", name, "$id.tsx")
+        destPath: join(cwd, "src/routes", name, "$id.tsx")
       }
     ];
     for (const file of files) {

package/dist/index.js

@@ -19,8 +19,8 @@ var main = defineCommand({
     }
   },
   subCommands: {
-    init: () => import("./init-UBPMMJ4L.js").then((m) => m.default),
-    "add:feature": () => import("./add-feature-JBVJHKHX.js").then((m) => m.default),
+    init: () => import("./init-OYJP5QCZ.js").then((m) => m.default),
+    "add:feature": () => import("./add-feature-MU65GMUK.js").then((m) => m.default),
     check: () => import("./check-B4VHLFHH.js").then((m) => m.default),
     version: () => import("./version-VO3LHLDO.js").then((m) => m.default)
   },

package/dist/{init-UBPMMJ4L.js → init-OYJP5QCZ.js}

@@ -59,16 +59,24 @@ var init_default = defineCommand({
     logger.blank();
     logger.log(`  ${pc.bold("Forge CLI")} - Creating project "${name}"`);
     logger.blank();
-    logger.log(`  ${pc.cyan("Step 1/5:")} TanStack Start setup`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
+    logger.log(`  ${pc.cyan("Step 1/5:")} TanStack Start`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
     logger.blank();
     try {
       await runInteractive("pnpm", ["create", "@tanstack/start@latest", name]);
+      logger.blank();
+      logger.success("TanStack Start scaffolding complete");
     } catch {
       logger.error("TanStack Start scaffolding failed");
       process.exit(1);
     }
     logger.blank();
-    const step2 = logger.step(`${pc.cyan("Step 2/5:")} Adding Forge customizations...`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
+    logger.log(`  ${pc.cyan("Step 2/5:")} Forge Customizations`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
+    logger.blank();
+    const step2 = logger.step("Adding customizations...");
     try {
       const pkgPath = join(projectDir, "package.json");
       const pkg = JSON.parse(await readFile(pkgPath));
@@ -80,10 +88,9 @@ var init_default = defineCommand({
       };
       pkg.devDependencies = {
         ...pkg.devDependencies,
-        "@biomejs/biome": "^1.9.4",
-        autoprefixer: "^10.4.20",
-        postcss: "^8.5.0",
-        tailwindcss: "^3.4.17"
+        "@biomejs/biome": "^2.3.11",
+        "@tailwindcss/vite": "^4.1.18",
+        tailwindcss: "^4.1.18"
       };
       pkg.scripts = {
         ...pkg.scripts,
@@ -107,8 +114,6 @@ var init_default = defineCommand({
       const templateData = { name };
       const forgeFiles = [
         { templatePath: "init/biome.json.hbs", destPath: join(projectDir, "biome.json") },
-        { templatePath: "init/tailwind.config.ts.hbs", destPath: join(projectDir, "tailwind.config.ts") },
-        { templatePath: "init/postcss.config.js.hbs", destPath: join(projectDir, "postcss.config.js") },
         { templatePath: "init/convex/schema.ts.hbs", destPath: join(projectDir, "convex/schema.ts") },
         { templatePath: "init/src/lib/cn.ts.hbs", destPath: join(projectDir, "src/lib/cn.ts") },
         { templatePath: "init/src/providers/index.tsx.hbs", destPath: join(projectDir, "src/providers/index.tsx") },
@@ -143,13 +148,24 @@ ${rootContent}`;
       }
       const stylesPath = join(projectDir, "src/styles.css");
       const existingStyles = await fileExists(stylesPath) ? await readFile(stylesPath) : "";
-      if (!existingStyles.includes("@tailwind")) {
-        const tailwindDirectives = `@tailwind base;
-@tailwind components;
-@tailwind utilities;
+      if (!existingStyles.includes("@import") && !existingStyles.includes("@tailwind")) {
+        const tailwindImport = `@import "tailwindcss";
 
 `;
-        await writeFile(stylesPath, tailwindDirectives + existingStyles);
+        await writeFile(stylesPath, tailwindImport + existingStyles);
+      }
+      const viteConfigPath = join(projectDir, "vite.config.ts");
+      if (await fileExists(viteConfigPath)) {
+        let viteConfig = await readFile(viteConfigPath);
+        if (!viteConfig.includes("@tailwindcss/vite")) {
+          viteConfig = `import tailwindcss from "@tailwindcss/vite";
+${viteConfig}`;
+          viteConfig = viteConfig.replace(
+            /plugins:\s*\[/,
+            "plugins: [tailwindcss(), "
+          );
+          await writeFile(viteConfigPath, viteConfig);
+        }
       }
       const gitignorePath = join(projectDir, ".gitignore");
       let gitignore = await fileExists(gitignorePath) ? await readFile(gitignorePath) : "";
@@ -162,43 +178,60 @@ ${item}`;
       }
       await writeFile(gitignorePath, gitignore.trim() + "\n");
       await writeFile(join(projectDir, ".env.example"), "VITE_CONVEX_URL=\n");
-      step2.succeed(`${pc.cyan("Step 2/5:")} Forge customizations added`);
+      step2.succeed("Forge customizations added");
     } catch (err) {
-      step2.fail(`${pc.cyan("Step 2/5:")} Failed to add customizations`);
+      step2.fail("Failed to add customizations");
       throw err;
     }
     logger.blank();
-    logger.log(`  ${pc.cyan("Step 3/5:")} Installing dependencies...`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
+    logger.log(`  ${pc.cyan("Step 3/5:")} Dependencies`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
     logger.blank();
     try {
       await runInteractive("pnpm", ["install"], projectDir);
+      logger.blank();
+      logger.success("Dependencies installed");
     } catch {
       logger.error("Failed to install dependencies");
       process.exit(1);
     }
     logger.blank();
-    logger.log(`  ${pc.cyan("Step 4/5:")} Convex setup`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
+    logger.log(`  ${pc.cyan("Step 4/5:")} Convex`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
     logger.blank();
     try {
       await runInteractive("npx", ["convex", "dev", "--once", "--configure=new"], projectDir);
+      logger.blank();
+      logger.success("Convex configured");
     } catch {
-      logger.warn("Convex setup skipped or failed - you can run it later");
+      logger.blank();
+      logger.warn("Convex setup skipped - run 'npx convex dev' later");
     }
     logger.blank();
-    logger.log(`  ${pc.cyan("Step 5/5:")} shadcn/ui setup`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
+    logger.log(`  ${pc.cyan("Step 5/5:")} shadcn/ui`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
     logger.blank();
     try {
       await runInteractive("pnpm", ["dlx", "shadcn@latest", "init"], projectDir);
+      logger.blank();
+      logger.success("shadcn/ui configured");
     } catch {
-      logger.warn("shadcn setup skipped or failed - you can run it later");
+      logger.blank();
+      logger.warn("shadcn setup skipped - run 'pnpm dlx shadcn init' later");
     }
     logger.blank();
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
     logger.log(`  ${pc.green("\u2713")} ${pc.bold("Project created successfully!")}`);
+    logger.log(`  ${pc.dim("\u2500".repeat(50))}`);
     logger.blank();
-    logger.log(`  ${pc.cyan("cd")} ${name}`);
-    logger.log(`  ${pc.cyan("pnpm dev")}`);
+    logger.log(`  ${pc.dim("Next steps:")}`);
+    logger.log(`  ${pc.cyan("$")} cd ${name}`);
+    logger.log(`  ${pc.cyan("$")} pnpm dev`);
     logger.blank();
-    logger.log(`  ${pc.dim("CLAUDE.md is configured. Claude Code will use forge CLI automatically.")}`);
+    logger.log(`  ${pc.dim("CLAUDE.md configured for Claude Code.")}`);
     logger.blank();
   }
 });

package/dist/templates/init/biome.json.hbs

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",
@@ -7,15 +7,19 @@
   },
   "files": {
     "ignoreUnknown": false,
-    "ignore": ["node_modules", "dist", ".vinxi", "convex/_generated"]
+    "includes": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.json"]
   },
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
     "indentWidth": 2
   },
-  "organizeImports": {
-    "enabled": true
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
   },
   "linter": {
     "enabled": true,

package/dist/templates/init/claude.md.hbs

@@ -1,93 +1,51 @@
 # CLAUDE.md
 
-## YOU MUST USE FORGE CLI
+## Stack
+TanStack Start + Convex + Tailwind v4 + shadcn/ui + Biome
 
-When the user asks you to build ANY feature, you MUST:
+## IMPORTANT: Use Forge CLI for Features
 
-1. FIRST run `forge add:feature <name>`
-2. THEN fill in the generated files
-3. NEVER create feature files manually
-
-## Trigger Words → Action
-
-| User says | You run |
-|-----------|---------|
-| "add feature", "create feature", "build feature" | `forge add:feature <name>` |
-| "add X with Y" (any domain entity) | `forge add:feature <name>` |
-| "new page for X" | `forge add:feature <name>` |
-| "build X functionality" | `forge add:feature <name>` |
-
-## File Creation Rules
-
-DO NOT create these files manually:
-- `src/features/**/*` (forge creates the structure)
-- `convex/features/**/*` (forge creates the structure)
-- `app/routes/<feature>/**/*` (forge creates the structure)
-
-ONLY the forge CLI creates these. You fill them in after.
-
-## What You CAN Create Manually
-
-- Files inside existing feature component folders (after forge created them)
-- `src/components/*` (shared UI)
-- `src/lib/*` (utilities)
-- `src/hooks/*` (global hooks)
+BEFORE building any feature, YOU MUST run:
+```bash
+forge add:feature <name>
+```
 
-## Workflow Example
+This scaffolds the complete vertical slice:
+- `src/features/<name>/` (components, hooks)
+- `convex/features/<name>/` (schema, queries, mutations)
+- `src/routes/<name>/` (route pages)
 
-User: "Add a comments feature with replies"
+NEVER create these paths manually. Edit the scaffolded files instead.
 
-You MUST:
-```
-Run: forge add:feature comments
-Edit: convex/features/comments/schema.ts (add fields for comments + replies)
-Edit: convex/features/comments/queries.ts (add queries)
-Edit: convex/features/comments/mutations.ts (add mutations)
-Edit: src/features/comments/hooks.ts (add/modify hooks)
-Create: src/features/comments/components/CommentCard.tsx
-Create: src/features/comments/components/CommentList.tsx
-Create: src/features/comments/components/ReplyForm.tsx
-Update: src/features/comments/components/index.ts (add exports)
-Edit: app/routes/comments/index.tsx (wire up components)
-```
+The ONLY route you may create directly is `src/routes/index.tsx` (homepage).
 
-## Validation
+## Commands
 
-Before finishing ANY task, run:
 ```bash
-forge check
+pnpm dev              # Start dev server
+npx convex dev        # Start Convex backend
+pnpm lint             # Check with Biome
+forge check           # Validate architecture (run before finishing)
 ```
-If it fails, fix ALL issues before responding to the user.
 
-## Project Structure
+## Architecture
 
 ```
-app/routes/         → Thin route files only (import from features, no logic)
-src/features/       → All feature code (components, hooks, types)
-src/components/     → Shared UI only (used across features)
-src/lib/            → Pure utilities
-convex/features/    → Backend mirrors frontend features
+src/routes/         → Thin route files (import from features, no logic)
+src/features/       → Feature code (components/, hooks.ts)
+src/components/     → Shared UI only
+src/lib/            → Utilities
+convex/features/    → Backend (mirrors src/features/)
 ```
 
 ## Rules
 
-1. **Routes are thin**: Only import and render. No business logic. No hooks defined here.
-2. **No cross-feature imports**: `src/features/X` cannot import from `src/features/Y`
-3. **Hooks in hooks.ts**: All feature hooks in `src/features/<name>/hooks.ts`
-4. **Components in components/**: All feature components in `src/features/<name>/components/`
-5. **Mirror structure**: Every `src/features/X` has `convex/features/X`
-
-## Stack Quick Reference
-
-- **Data fetching**: Use hooks from `src/features/<name>/hooks.ts` (they wrap Convex)
-- **Mutations**: Use mutation hooks from `src/features/<name>/hooks.ts`
-- **UI primitives**: Import from `~/components/ui/*` (shadcn)
-- **Styling**: Tailwind classes only, no CSS files
-- **Forms**: react-hook-form + zod for validation
+1. Routes are thin wrappers - no business logic, just imports and renders
+2. No cross-feature imports (`src/features/X` cannot import from `src/features/Y`)
+3. Each `src/features/X` has matching `convex/features/X`
 
-## Commands Reference
+## Quick Reference
 
-| Command | When to use |
-|---------|-------------|
-| `forge add:feature <name>` | BEFORE building any new feature |
-| `forge check` | BEFORE completing any task |
+- **Data/Mutations**: Use hooks from `src/features/<name>/hooks.ts`
+- **UI Components**: Import from `~/components/ui/*` (shadcn)
+- **Styling**: Tailwind classes only

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-forge-cli",
-  "version": "0.2.3",
+  "version": "0.3.2",
   "description": "TypeScript stack scaffolding & enforcement CLI for TanStack Start + Convex",
   "type": "module",
   "license": "MIT",

package/templates/init/biome.json.hbs

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",
@@ -7,15 +7,19 @@
   },
   "files": {
     "ignoreUnknown": false,
-    "ignore": ["node_modules", "dist", ".vinxi", "convex/_generated"]
+    "includes": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.json"]
   },
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
     "indentWidth": 2
   },
-  "organizeImports": {
-    "enabled": true
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
   },
   "linter": {
     "enabled": true,

package/templates/init/claude.md.hbs

@@ -1,93 +1,51 @@
 # CLAUDE.md
 
-## YOU MUST USE FORGE CLI
+## Stack
+TanStack Start + Convex + Tailwind v4 + shadcn/ui + Biome
 
-When the user asks you to build ANY feature, you MUST:
+## IMPORTANT: Use Forge CLI for Features
 
-1. FIRST run `forge add:feature <name>`
-2. THEN fill in the generated files
-3. NEVER create feature files manually
-
-## Trigger Words → Action
-
-| User says | You run |
-|-----------|---------|
-| "add feature", "create feature", "build feature" | `forge add:feature <name>` |
-| "add X with Y" (any domain entity) | `forge add:feature <name>` |
-| "new page for X" | `forge add:feature <name>` |
-| "build X functionality" | `forge add:feature <name>` |
-
-## File Creation Rules
-
-DO NOT create these files manually:
-- `src/features/**/*` (forge creates the structure)
-- `convex/features/**/*` (forge creates the structure)
-- `app/routes/<feature>/**/*` (forge creates the structure)
-
-ONLY the forge CLI creates these. You fill them in after.
-
-## What You CAN Create Manually
-
-- Files inside existing feature component folders (after forge created them)
-- `src/components/*` (shared UI)
-- `src/lib/*` (utilities)
-- `src/hooks/*` (global hooks)
+BEFORE building any feature, YOU MUST run:
+```bash
+forge add:feature <name>
+```
 
-## Workflow Example
+This scaffolds the complete vertical slice:
+- `src/features/<name>/` (components, hooks)
+- `convex/features/<name>/` (schema, queries, mutations)
+- `src/routes/<name>/` (route pages)
 
-User: "Add a comments feature with replies"
+NEVER create these paths manually. Edit the scaffolded files instead.
 
-You MUST:
-```
-Run: forge add:feature comments
-Edit: convex/features/comments/schema.ts (add fields for comments + replies)
-Edit: convex/features/comments/queries.ts (add queries)
-Edit: convex/features/comments/mutations.ts (add mutations)
-Edit: src/features/comments/hooks.ts (add/modify hooks)
-Create: src/features/comments/components/CommentCard.tsx
-Create: src/features/comments/components/CommentList.tsx
-Create: src/features/comments/components/ReplyForm.tsx
-Update: src/features/comments/components/index.ts (add exports)
-Edit: app/routes/comments/index.tsx (wire up components)
-```
+The ONLY route you may create directly is `src/routes/index.tsx` (homepage).
 
-## Validation
+## Commands
 
-Before finishing ANY task, run:
 ```bash
-forge check
+pnpm dev              # Start dev server
+npx convex dev        # Start Convex backend
+pnpm lint             # Check with Biome
+forge check           # Validate architecture (run before finishing)
 ```
-If it fails, fix ALL issues before responding to the user.
 
-## Project Structure
+## Architecture
 
 ```
-app/routes/         → Thin route files only (import from features, no logic)
-src/features/       → All feature code (components, hooks, types)
-src/components/     → Shared UI only (used across features)
-src/lib/            → Pure utilities
-convex/features/    → Backend mirrors frontend features
+src/routes/         → Thin route files (import from features, no logic)
+src/features/       → Feature code (components/, hooks.ts)
+src/components/     → Shared UI only
+src/lib/            → Utilities
+convex/features/    → Backend (mirrors src/features/)
 ```
 
 ## Rules
 
-1. **Routes are thin**: Only import and render. No business logic. No hooks defined here.
-2. **No cross-feature imports**: `src/features/X` cannot import from `src/features/Y`
-3. **Hooks in hooks.ts**: All feature hooks in `src/features/<name>/hooks.ts`
-4. **Components in components/**: All feature components in `src/features/<name>/components/`
-5. **Mirror structure**: Every `src/features/X` has `convex/features/X`
-
-## Stack Quick Reference
-
-- **Data fetching**: Use hooks from `src/features/<name>/hooks.ts` (they wrap Convex)
-- **Mutations**: Use mutation hooks from `src/features/<name>/hooks.ts`
-- **UI primitives**: Import from `~/components/ui/*` (shadcn)
-- **Styling**: Tailwind classes only, no CSS files
-- **Forms**: react-hook-form + zod for validation
+1. Routes are thin wrappers - no business logic, just imports and renders
+2. No cross-feature imports (`src/features/X` cannot import from `src/features/Y`)
+3. Each `src/features/X` has matching `convex/features/X`
 
-## Commands Reference
+## Quick Reference
 
-| Command | When to use |
-|---------|-------------|
-| `forge add:feature <name>` | BEFORE building any new feature |
-| `forge check` | BEFORE completing any task |
+- **Data/Mutations**: Use hooks from `src/features/<name>/hooks.ts`
+- **UI Components**: Import from `~/components/ui/*` (shadcn)
+- **Styling**: Tailwind classes only

package/dist/templates/init/postcss.config.js.hbs

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/dist/templates/init/tailwind.config.ts.hbs

@@ -1,12 +0,0 @@
-import type { Config } from "tailwindcss";
-
-export default {
-  content: [
-    "./app/**/*.{js,ts,jsx,tsx}",
-    "./src/**/*.{js,ts,jsx,tsx}",
-  ],
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-} satisfies Config;

package/templates/init/postcss.config.js.hbs

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/templates/init/tailwind.config.ts.hbs

@@ -1,12 +0,0 @@
-import type { Config } from "tailwindcss";
-
-export default {
-  content: [
-    "./app/**/*.{js,ts,jsx,tsx}",
-    "./src/**/*.{js,ts,jsx,tsx}",
-  ],
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-} satisfies Config;