ai-forge-cli 0.4.2 → 0.4.6

package/dist/add-component-AQPCXQ4O.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+import {
+  kebabCase,
+  pascalCase,
+  renderTemplate
+} from "./chunk-MBF6K2AC.js";
+import {
+  fileExists,
+  logger,
+  readFile,
+  writeFile
+} from "./chunk-HL4K5AHI.js";
+
+// src/commands/add-component.ts
+import { defineCommand } from "citty";
+import { join } from "path";
+var add_component_default = defineCommand({
+  meta: {
+    name: "add:component",
+    description: "Create a new React component"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: "Component name (will be PascalCased)",
+      required: true
+    },
+    feature: {
+      type: "string",
+      description: "Add to a feature's components folder"
+    },
+    page: {
+      type: "string",
+      description: "Add to a page's components folder"
+    },
+    layout: {
+      type: "string",
+      description: "Add to a layout's components folder"
+    }
+  },
+  async run({ args }) {
+    const cwd = process.cwd();
+    const rawName = args.name;
+    const componentName = pascalCase(rawName);
+    const feature = args.feature;
+    const page = args.page;
+    const layout = args.layout;
+    let targetDir;
+    let indexPath;
+    let locationLabel;
+    if (feature) {
+      const featureName = kebabCase(feature);
+      targetDir = join(cwd, "src/features", featureName, "components");
+      indexPath = join(targetDir, "index.ts");
+      locationLabel = `src/features/${featureName}/components`;
+      if (!await fileExists(join(cwd, "src/features", featureName))) {
+        logger.error(`Feature "${featureName}" does not exist`);
+        logger.log(`  Run: forge add:feature ${featureName}`);
+        process.exit(1);
+      }
+    } else if (page) {
+      const pageName = kebabCase(page);
+      targetDir = join(cwd, "src/components", pageName);
+      indexPath = join(targetDir, "index.ts");
+      locationLabel = `src/components/${pageName}`;
+    } else if (layout) {
+      const layoutName = kebabCase(layout);
+      targetDir = join(cwd, "src/components", layoutName);
+      indexPath = join(targetDir, "index.ts");
+      locationLabel = `src/components/${layoutName}`;
+    } else {
+      targetDir = join(cwd, "src/components/ui");
+      indexPath = join(targetDir, "index.ts");
+      locationLabel = "src/components/ui";
+    }
+    const componentPath = join(targetDir, `${componentName}.tsx`);
+    if (await fileExists(componentPath)) {
+      logger.error(`Component "${componentName}" already exists at ${locationLabel}`);
+      process.exit(1);
+    }
+    logger.blank();
+    const templateData = {
+      componentName,
+      name: kebabCase(rawName)
+    };
+    const content = renderTemplate("component/Component.tsx.hbs", templateData);
+    await writeFile(componentPath, content);
+    logger.success(`Created ${locationLabel}/${componentName}.tsx`);
+    const exportLine = `export { ${componentName} } from "./${componentName}";`;
+    if (await fileExists(indexPath)) {
+      const existing = await readFile(indexPath);
+      if (!existing.includes(exportLine)) {
+        await writeFile(indexPath, existing.trim() + "\n" + exportLine + "\n");
+        logger.success(`Updated ${locationLabel}/index.ts`);
+      }
+    } else {
+      await writeFile(indexPath, exportLine + "\n");
+      logger.success(`Created ${locationLabel}/index.ts`);
+    }
+    logger.blank();
+    logger.log(`  Component "${componentName}" created!`);
+    logger.blank();
+    logger.log("  Location:");
+    logger.log(`    ${locationLabel}/${componentName}.tsx`);
+    logger.blank();
+    logger.log("  Import:");
+    if (feature) {
+      logger.log(`    import { ${componentName} } from "~/features/${kebabCase(feature)}/components";`);
+    } else if (page || layout) {
+      const folder = page ? kebabCase(page) : kebabCase(layout);
+      logger.log(`    import { ${componentName} } from "~/components/${folder}";`);
+    } else {
+      logger.log(`    import { ${componentName} } from "~/components/ui";`);
+    }
+    logger.blank();
+  }
+});
+export {
+  add_component_default as default
+};

package/dist/{add-feature-2AR4DP7P.js → add-feature-VEY62Y5M.js}

@@ -2,11 +2,15 @@
 import {
   insertAtMarker
 } from "./chunk-M7T2JD5B.js";
+import {
+  ensureShadcnComponents
+} from "./chunk-YMJTSRWM.js";
 import {
   camelCase,
   kebabCase,
+  pascalCase,
   renderTemplate
-} from "./chunk-PIFX2L5H.js";
+} from "./chunk-MBF6K2AC.js";
 import {
   fileExists,
   logger,
@@ -44,6 +48,8 @@ var add_feature_default = defineCommand({
       process.exit(1);
     }
     logger.blank();
+    await ensureShadcnComponents(cwd, "feature");
+    const pascal = pascalCase(name);
     const templateData = { name };
     const files = [
       // Convex files
@@ -63,11 +69,7 @@ var add_feature_default = defineCommand({
         templatePath: "feature/convex/index.ts.hbs",
         destPath: join(cwd, "convex/features", name, "index.ts")
       },
-      // Src files
-      {
-        templatePath: "feature/src/components/index.ts.hbs",
-        destPath: join(cwd, "src/features", name, "components/index.ts")
-      },
+      // Src files - hooks and index
       {
         templatePath: "feature/src/hooks.ts.hbs",
         destPath: join(cwd, "src/features", name, "hooks.ts")
@@ -76,6 +78,27 @@ var add_feature_default = defineCommand({
         templatePath: "feature/src/index.ts.hbs",
         destPath: join(cwd, "src/features", name, "index.ts")
       },
+      // Components
+      {
+        templatePath: "feature/src/components/List.tsx.hbs",
+        destPath: join(cwd, "src/features", name, "components", `${pascal}List.tsx`)
+      },
+      {
+        templatePath: "feature/src/components/Card.tsx.hbs",
+        destPath: join(cwd, "src/features", name, "components", `${pascal}Card.tsx`)
+      },
+      {
+        templatePath: "feature/src/components/Form.tsx.hbs",
+        destPath: join(cwd, "src/features", name, "components", `${pascal}Form.tsx`)
+      },
+      {
+        templatePath: "feature/src/components/Detail.tsx.hbs",
+        destPath: join(cwd, "src/features", name, "components", `${pascal}Detail.tsx`)
+      },
+      {
+        templatePath: "feature/src/components/index.ts.hbs",
+        destPath: join(cwd, "src/features", name, "components/index.ts")
+      },
       // Route files
       {
         templatePath: "feature/routes/index.tsx.hbs",
@@ -96,10 +119,16 @@ var add_feature_default = defineCommand({
     logger.blank();
     logger.log(`  Feature "${name}" created successfully.`);
     logger.blank();
+    logger.log("  Created:");
+    logger.log(`    Backend: convex/features/${name}/`);
+    logger.log(`    Components: ${pascal}List, ${pascal}Card, ${pascal}Form, ${pascal}Detail`);
+    logger.log(`    Routes: /src/routes/${name}/`);
+    logger.blank();
     logger.log("  Next steps:");
     logger.log(`    1. Define your schema in convex/features/${name}/schema.ts`);
-    logger.log("    2. Run `npx convex dev` to sync");
-    logger.log(`    3. Build components in src/features/${name}/components/`);
+    logger.log(`    2. Update form fields in ${pascal}Form.tsx`);
+    logger.log(`    3. Customize ${pascal}Card.tsx display`);
+    logger.log("    4. Run: npx convex dev");
     logger.blank();
   }
 });

package/dist/add-hook-OE4BKE6B.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import {
+  camelCase,
+  kebabCase,
+  renderTemplate
+} from "./chunk-MBF6K2AC.js";
+import {
+  fileExists,
+  logger,
+  readFile,
+  writeFile
+} from "./chunk-HL4K5AHI.js";
+
+// src/commands/add-hook.ts
+import { defineCommand } from "citty";
+import { join } from "path";
+var add_hook_default = defineCommand({
+  meta: {
+    name: "add:hook",
+    description: "Create a new React hook"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: "Hook name (will be prefixed with 'use' if needed)",
+      required: true
+    },
+    feature: {
+      type: "string",
+      description: "Append to a feature's hooks.ts file"
+    }
+  },
+  async run({ args }) {
+    const cwd = process.cwd();
+    const rawName = args.name;
+    const feature = args.feature;
+    let hookName = camelCase(rawName);
+    if (!hookName.startsWith("use")) {
+      hookName = `use${hookName.charAt(0).toUpperCase()}${hookName.slice(1)}`;
+    }
+    const templateData = {
+      hookName,
+      name: rawName
+    };
+    logger.blank();
+    if (feature) {
+      const featureName = kebabCase(feature);
+      const hooksPath = join(cwd, "src/features", featureName, "hooks.ts");
+      if (!await fileExists(hooksPath)) {
+        logger.error(`Feature "${featureName}" does not exist or has no hooks.ts`);
+        logger.log(`  Run: forge add:feature ${featureName}`);
+        process.exit(1);
+      }
+      const existing = await readFile(hooksPath);
+      if (existing.includes(`export function ${hookName}`)) {
+        logger.error(`Hook "${hookName}" already exists in ${featureName}/hooks.ts`);
+        process.exit(1);
+      }
+      const hookCode = renderTemplate("hook/feature-hook.ts.hbs", templateData);
+      await writeFile(hooksPath, existing.trim() + "\n\n" + hookCode);
+      logger.success(`Added ${hookName} to src/features/${featureName}/hooks.ts`);
+      logger.blank();
+      logger.log(`  Hook "${hookName}" added to feature "${featureName}"!`);
+      logger.blank();
+      logger.log("  Import:");
+      logger.log(`    import { ${hookName} } from "~/features/${featureName}";`);
+    } else {
+      const hooksDir = join(cwd, "src/hooks");
+      const hookFile = join(hooksDir, `${hookName}.ts`);
+      const indexPath = join(hooksDir, "index.ts");
+      if (await fileExists(hookFile)) {
+        logger.error(`Hook "${hookName}" already exists at src/hooks/${hookName}.ts`);
+        process.exit(1);
+      }
+      const content = renderTemplate("hook/global-hook.ts.hbs", templateData);
+      await writeFile(hookFile, content);
+      logger.success(`Created src/hooks/${hookName}.ts`);
+      const exportLine = `export { ${hookName} } from "./${hookName}";`;
+      if (await fileExists(indexPath)) {
+        const existing = await readFile(indexPath);
+        if (!existing.includes(exportLine)) {
+          await writeFile(indexPath, existing.trim() + "\n" + exportLine + "\n");
+          logger.success("Updated src/hooks/index.ts");
+        }
+      } else {
+        await writeFile(indexPath, exportLine + "\n");
+        logger.success("Created src/hooks/index.ts");
+      }
+      logger.blank();
+      logger.log(`  Hook "${hookName}" created!`);
+      logger.blank();
+      logger.log("  Location:");
+      logger.log(`    src/hooks/${hookName}.ts`);
+      logger.blank();
+      logger.log("  Import:");
+      logger.log(`    import { ${hookName} } from "~/hooks";`);
+    }
+    logger.blank();
+  }
+});
+export {
+  add_hook_default as default
+};

package/dist/{add-integration-QXB63S3V.js → add-integration-NJ56UXSY.js}

@@ -2,9 +2,12 @@
 import {
   insertAtMarker
 } from "./chunk-M7T2JD5B.js";
+import {
+  ensureShadcnComponents
+} from "./chunk-YMJTSRWM.js";
 import {
   renderTemplate
-} from "./chunk-PIFX2L5H.js";
+} from "./chunk-MBF6K2AC.js";
 import {
   fileExists,
   logger,
@@ -72,38 +75,72 @@ async function setupAuth(cwd) {
     step1.fail("Failed to install dependencies");
     process.exit(1);
   }
-  const step2 = logger.step("Creating auth files...");
+  await ensureShadcnComponents(cwd, "auth");
+  const step2 = logger.step("Creating backend files...");
   try {
-    const files = [
+    const backendFiles = [
       { template: "integration/auth/convex/auth.ts.hbs", dest: "convex/auth.ts" },
       { template: "integration/auth/convex/auth.config.ts.hbs", dest: "convex/auth.config.ts" },
       { template: "integration/auth/convex/http.ts.hbs", dest: "convex/http.ts" },
       { template: "integration/auth/src/lib/auth.ts.hbs", dest: "src/lib/auth.ts" }
     ];
-    for (const file of files) {
+    for (const file of backendFiles) {
+      const content = renderTemplate(file.template, {});
+      await writeFile(join(cwd, file.dest), content);
+    }
+    step2.succeed("Backend files created");
+  } catch (err) {
+    step2.fail("Failed to create backend files");
+    throw err;
+  }
+  const step3 = logger.step("Creating UI components...");
+  try {
+    const uiFiles = [
+      { template: "integration/auth/src/components/auth/LoginForm.tsx.hbs", dest: "src/components/auth/LoginForm.tsx" },
+      { template: "integration/auth/src/components/auth/SignupForm.tsx.hbs", dest: "src/components/auth/SignupForm.tsx" },
+      { template: "integration/auth/src/components/auth/AuthGuard.tsx.hbs", dest: "src/components/auth/AuthGuard.tsx" },
+      { template: "integration/auth/src/components/auth/UserMenu.tsx.hbs", dest: "src/components/auth/UserMenu.tsx" },
+      { template: "integration/auth/src/components/auth/index.ts.hbs", dest: "src/components/auth/index.ts" }
+    ];
+    for (const file of uiFiles) {
+      const content = renderTemplate(file.template, {});
+      await writeFile(join(cwd, file.dest), content);
+    }
+    step3.succeed("UI components created");
+  } catch (err) {
+    step3.fail("Failed to create UI components");
+    throw err;
+  }
+  const step4 = logger.step("Creating routes...");
+  try {
+    const routeFiles = [
+      { template: "integration/auth/src/routes/login.tsx.hbs", dest: "src/routes/login.tsx" },
+      { template: "integration/auth/src/routes/signup.tsx.hbs", dest: "src/routes/signup.tsx" }
+    ];
+    for (const file of routeFiles) {
       const content = renderTemplate(file.template, {});
       await writeFile(join(cwd, file.dest), content);
     }
-    step2.succeed("Auth files created");
+    step4.succeed("Routes created");
   } catch (err) {
-    step2.fail("Failed to create auth files");
+    step4.fail("Failed to create routes");
     throw err;
   }
-  const step3 = logger.step("Updating convex/schema.ts...");
+  const step5 = logger.step("Updating convex/schema.ts...");
   try {
     await updateSchemaForAuth(cwd);
-    step3.succeed("Schema updated");
+    step5.succeed("Schema updated");
   } catch {
-    step3.fail("Failed to update schema");
+    step5.fail("Failed to update schema");
   }
-  const step4 = logger.step("Updating providers...");
+  const step6 = logger.step("Updating providers...");
   try {
     await updateProvidersForAuth(cwd);
-    step4.succeed("Providers updated");
+    step6.succeed("Providers updated");
   } catch {
-    step4.fail("Failed to update providers");
+    step6.fail("Failed to update providers");
   }
-  const step5 = logger.step("Updating .env.example...");
+  const step7 = logger.step("Updating .env.example...");
   try {
     const envPath = join(cwd, ".env.example");
     let env = await fileExists(envPath) ? await readFile(envPath) : "";
@@ -117,18 +154,26 @@ AUTH_GOOGLE_SECRET=
     if (!env.includes("AUTH_GITHUB_ID")) {
       await writeFile(envPath, env.trim() + "\n" + authVars);
     }
-    step5.succeed(".env.example updated");
+    step7.succeed(".env.example updated");
   } catch {
-    step5.fail("Failed to update .env.example");
+    step7.fail("Failed to update .env.example");
   }
   logger.blank();
   logger.log(`  ${pc.green("\u2713")} ${pc.bold("Convex Auth configured!")}`);
   logger.blank();
+  logger.log("  Created:");
+  logger.log("    Backend: convex/auth.ts, convex/auth.config.ts");
+  logger.log("    Components: LoginForm, SignupForm, AuthGuard, UserMenu");
+  logger.log("    Routes: /login, /signup");
+  logger.blank();
   logger.log("  Next steps:");
-  logger.log("    1. Create OAuth apps on GitHub/Google");
-  logger.log("    2. Add secrets: npx convex env set AUTH_GITHUB_ID=xxx");
-  logger.log("    3. Generate JWT keys: npx @convex-dev/auth");
-  logger.log("    4. Run: npx convex dev");
+  logger.log("    1. Set up auth secrets: npx @convex-dev/auth");
+  logger.log("    2. Run: npx convex dev");
+  logger.log("    3. Visit: http://localhost:3000/login");
+  logger.blank();
+  logger.log("  Usage:");
+  logger.log("    - Protect routes: <AuthGuard><YourComponent /></AuthGuard>");
+  logger.log("    - Add to header: <UserMenu />");
   logger.blank();
 }
 async function setupStorage(cwd) {
@@ -139,27 +184,52 @@ async function setupStorage(cwd) {
   }
   logger.log(`  ${pc.bold("Setting up Convex Storage...")}`);
   logger.blank();
-  const step1 = logger.step("Creating storage files...");
+  await ensureShadcnComponents(cwd, "storage");
+  const step1 = logger.step("Creating backend files...");
   try {
-    const files = [
+    const backendFiles = [
       { template: "integration/storage/convex/lib/storage.ts.hbs", dest: "convex/lib/storage.ts" },
       { template: "integration/storage/src/lib/storage.ts.hbs", dest: "src/lib/storage.ts" }
     ];
-    for (const file of files) {
+    for (const file of backendFiles) {
       const content = renderTemplate(file.template, {});
       await writeFile(join(cwd, file.dest), content);
     }
-    step1.succeed("Storage files created");
+    step1.succeed("Backend files created");
   } catch (err) {
-    step1.fail("Failed to create storage files");
+    step1.fail("Failed to create backend files");
+    throw err;
+  }
+  const step2 = logger.step("Creating UI components...");
+  try {
+    const uiFiles = [
+      { template: "integration/storage/src/components/storage/FileUpload.tsx.hbs", dest: "src/components/storage/FileUpload.tsx" },
+      { template: "integration/storage/src/components/storage/FilePreview.tsx.hbs", dest: "src/components/storage/FilePreview.tsx" },
+      { template: "integration/storage/src/components/storage/index.ts.hbs", dest: "src/components/storage/index.ts" }
+    ];
+    for (const file of uiFiles) {
+      const content = renderTemplate(file.template, {});
+      await writeFile(join(cwd, file.dest), content);
+    }
+    step2.succeed("UI components created");
+  } catch (err) {
+    step2.fail("Failed to create UI components");
     throw err;
   }
   logger.blank();
   logger.log(`  ${pc.green("\u2713")} ${pc.bold("Convex Storage configured!")}`);
   logger.blank();
-  logger.log("  Next steps:");
-  logger.log("    1. Use generateUploadUrl() in your mutations");
-  logger.log("    2. Use useUpload() hook in your components");
+  logger.log("  Created:");
+  logger.log("    Backend: convex/lib/storage.ts");
+  logger.log("    Lib: src/lib/storage.ts");
+  logger.log("    Components: FileUpload, FilePreview");
+  logger.blank();
+  logger.log("  Usage:");
+  logger.log('    import { FileUpload, FilePreview } from "~/components/storage";');
+  logger.log('    import { useUpload, useFileUrl } from "~/lib/storage";');
+  logger.blank();
+  logger.log("    <FileUpload onUpload={(id) => console.log(id)} />");
+  logger.log("    <FilePreview storageId={someId} />");
   logger.blank();
 }
 async function updateSchemaForAuth(cwd) {

package/dist/add-layout-2KQPPTJX.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import {
+  ensureShadcnComponents
+} from "./chunk-YMJTSRWM.js";
+import {
+  kebabCase,
+  pascalCase,
+  renderTemplate
+} from "./chunk-MBF6K2AC.js";
+import {
+  fileExists,
+  logger,
+  writeFile
+} from "./chunk-HL4K5AHI.js";
+
+// src/commands/add-layout.ts
+import { defineCommand } from "citty";
+import { join } from "path";
+var LAYOUT_PRESETS = ["dashboard", "auth", "marketing"];
+var add_layout_default = defineCommand({
+  meta: {
+    name: "add:layout",
+    description: "Create a layout (dashboard, auth, marketing, or custom)"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: `Layout name: ${LAYOUT_PRESETS.join(", ")} or custom name`,
+      required: true
+    }
+  },
+  async run({ args }) {
+    const cwd = process.cwd();
+    const name = kebabCase(args.name);
+    const isPreset = LAYOUT_PRESETS.includes(name);
+    const pascalName = pascalCase(name);
+    const routeFolder = name === "auth" ? `(${name})` : name;
+    const layoutFile = join(cwd, "src/routes", routeFolder, "_layout.tsx");
+    if (await fileExists(layoutFile)) {
+      logger.error(`Layout "${name}" already exists`);
+      process.exit(1);
+    }
+    logger.blank();
+    if (isPreset && (name === "dashboard" || name === "marketing")) {
+      await ensureShadcnComponents(cwd, name);
+    }
+    const templateData = {
+      name,
+      pascalName
+    };
+    const templateFolder = isPreset ? name : "base";
+    const layoutContent = renderTemplate(`layout/${templateFolder}/_layout.tsx.hbs`, templateData);
+    await writeFile(layoutFile, layoutContent);
+    logger.success(`Created src/routes/${routeFolder}/_layout.tsx`);
+    if (name === "dashboard") {
+      const dashboardComponents = [
+        {
+          template: "layout/dashboard/components/Sidebar.tsx.hbs",
+          dest: "src/components/layout/Sidebar.tsx"
+        },
+        {
+          template: "layout/dashboard/components/Header.tsx.hbs",
+          dest: "src/components/layout/Header.tsx"
+        },
+        {
+          template: "layout/dashboard/components/index.ts.hbs",
+          dest: "src/components/layout/index.ts"
+        }
+      ];
+      for (const { template, dest } of dashboardComponents) {
+        const content = renderTemplate(template, templateData);
+        await writeFile(join(cwd, dest), content);
+        logger.success(`Created ${dest}`);
+      }
+    }
+    const exampleRoute = join(cwd, "src/routes", routeFolder, "index.tsx");
+    if (!await fileExists(exampleRoute)) {
+      const exampleContent = renderTemplate(`layout/${templateFolder}/index.tsx.hbs`, templateData);
+      await writeFile(exampleRoute, exampleContent);
+      logger.success(`Created src/routes/${routeFolder}/index.tsx`);
+    }
+    logger.blank();
+    logger.log(`  Layout "${name}" created!`);
+    logger.blank();
+    logger.log("  Files:");
+    logger.log(`    - src/routes/${routeFolder}/_layout.tsx`);
+    if (name === "dashboard") {
+      logger.log("    - src/components/layout/Sidebar.tsx");
+      logger.log("    - src/components/layout/Header.tsx");
+    }
+    logger.blank();
+    logger.log(`  Routes inside src/routes/${routeFolder}/ will use this layout.`);
+    logger.blank();
+    if (name === "dashboard") {
+      logger.log("  Example: http://localhost:3000/dashboard");
+    } else if (name === "auth") {
+      logger.log("  Example: Add login.tsx to the route group for /login");
+    }
+    logger.blank();
+  }
+});
+export {
+  add_layout_default as default
+};