@insforge/cli 0.1.20 → 0.1.23

package/README.md

@@ -137,6 +137,49 @@ insforge metadata
 insforge metadata --json
 ```
 
+#### `insforge logs`
+
+Fetch backend container logs.
+
+```bash
+insforge logs <source> [options]
+```
+
+**Sources:** `insforge.logs`, `postgREST.logs`, `postgres.logs`, `function.logs`
+
+**Options:**
+- `--limit <n>`: Number of log entries to return (default: 20)
+
+**Examples:**
+```bash
+insforge logs insforge.logs
+insforge logs postgres.logs --limit 50
+insforge logs function.logs --json
+```
+
+#### `insforge docs`
+
+Browse InsForge SDK documentation.
+
+```bash
+insforge docs [feature] [language]
+```
+
+**Features:** `db`, `storage`, `functions`, `auth`, `ai`, `realtime`, `instructions`
+**Languages:** `typescript`, `swift`, `kotlin`, `rest-api`
+
+**Examples:**
+```bash
+# List all available docs
+insforge docs
+
+# Specific feature/language docs
+insforge docs instructions           # Show backend setup instructions
+insforge docs db typescript          # Show TypeScript database SDK docs
+insforge docs auth swift             # Show Swift auth SDK docs
+insforge docs storage rest-api       # Show REST API storage docs
+```
+
 ---
 
 ### Database — `insforge db`
@@ -258,6 +301,15 @@ insforge functions invoke my-function --method GET
 insforge functions invoke my-function --data '{"key": "value"}' --json
 ```
 
+#### `insforge functions delete <slug>`
+
+Delete an edge function.
+
+```bash
+insforge functions delete my-function
+insforge functions delete my-function -y  # skip confirmation
+```
+
 ---
 
 ### Storage — `insforge storage`
@@ -409,6 +461,64 @@ insforge secrets delete STRIPE_API_KEY
 insforge secrets delete STRIPE_API_KEY -y   # skip confirmation
 ```
 
+### Schedules — `insforge schedules`
+
+Manage scheduled tasks (cron jobs).
+
+#### `insforge schedules list`
+
+List all schedules in the current project.
+
+```bash
+insforge schedules list
+insforge schedules list --json
+```
+
+#### `insforge schedules create`
+
+Create a new scheduled task.
+
+```bash
+insforge schedules create --name "daily-cleanup" --cron "0 0 * * *" --url "https://api.example.com/cleanup" --method POST
+insforge schedules create --name "hourly-sync" --cron "0 * * * *" --url "https://api.example.com/sync" --method GET --headers '{"Authorization": "Bearer xxx"}'
+```
+
+#### `insforge schedules get <id>`
+
+Get details of a specific schedule.
+
+```bash
+insforge schedules get <id>
+insforge schedules get 123 --json
+```
+
+#### `insforge schedules update <id>`
+
+Update an existing schedule.
+
+```bash
+insforge schedules update <id> --name "weekly-cleanup" --cron "0 0 * * 0"
+insforge schedules update 123 --active false
+```
+
+#### `insforge schedules delete <id>`
+
+Delete a schedule.
+
+```bash
+insforge schedules delete <id>
+insforge schedules delete 123 -y
+```
+
+#### `insforge schedules logs <id>`
+
+Fetch execution logs for a specific schedule.
+
+```bash
+insforge schedules logs <id>
+insforge schedules logs 123 --limit 100
+```
+
 ---
 
 ## Project Configuration

package/dist/index.js

@@ -720,6 +720,16 @@ async function installSkills(json) {
   } catch {
     if (!json) clack5.log.warn("Failed to install agent skills. You can run manually: npx skills add insforge/agent-skills -s insforge -s insforge-cli");
   }
+  try {
+    if (!json) clack5.log.info("Installing find-skills...");
+    await execAsync("npx skills add https://github.com/vercel-labs/skills --skill find-skills -y", {
+      cwd: process.cwd(),
+      timeout: 6e4
+    });
+    if (!json) clack5.log.success("find-skills installed.");
+  } catch {
+    if (!json) clack5.log.warn("Failed to install find-skills. You can run manually: npx skills add https://github.com/vercel-labs/skills --skill find-skills");
+  }
   try {
     updateGitignore();
   } catch {
@@ -1433,8 +1443,8 @@ Specify --file <path> or create ${join3("insforge", "functions", slug, "index.ts
           }
         }
       }
-      await reportCliUsage("cli.functions.deploy", !deployFailed);
-      if (deployFailed) process.exit(1);
+      if (deployFailed) throw new CLIError("Function deployment failed");
+      await reportCliUsage("cli.functions.deploy", true);
     } catch (err) {
       await reportCliUsage("cli.functions.deploy", false);
       handleError(err, json);
@@ -1470,20 +1480,14 @@ function registerFunctionsInvokeCommand(functionsCmd2) {
         if (json) {
           outputJson({ status, body: data });
         } else {
-          if (status >= 400) {
-            console.error(`HTTP ${status}`);
-          }
           console.log(JSON.stringify(data, null, 2));
         }
       } else {
         const text3 = await res.text();
-        if (!json && status >= 400) {
-          console.error(`HTTP ${status}`);
-        }
         console.log(text3);
       }
       if (status >= 400) {
-        process.exit(1);
+        throw new CLIError(`HTTP ${status}`, 1, "HTTP_ERROR");
       }
     } catch (err) {
       handleError(err, json);
@@ -1964,7 +1968,7 @@ async function copyDir(src, dest) {
   }
 }
 function registerCreateCommand(program2) {
-  program2.command("create").description("Create a new InsForge project").option("--name <name>", "Project name").option("--org-id <id>", "Organization ID").option("--region <region>", "Deployment region (us-east, us-west, eu-central, ap-southeast)").option("--template <template>", "Template to use: react, nextjs, or empty").action(async (opts, cmd) => {
+  program2.command("create").description("Create a new InsForge project").option("--name <name>", "Project name").option("--org-id <id>", "Organization ID").option("--region <region>", "Deployment region (us-east, us-west, eu-central, ap-southeast)").option("--template <template>", "Template to use: react, nextjs, chatbot, or empty").action(async (opts, cmd) => {
     const { json, apiUrl } = getRootOpts(cmd);
     try {
       await requireAuth(apiUrl);
@@ -2013,6 +2017,7 @@ function registerCreateCommand(program2) {
             options: [
               { value: "react", label: "Web app template with React" },
               { value: "nextjs", label: "Web app template with Next.js" },
+              { value: "chatbot", label: "AI Chatbot with Next.js" },
               { value: "empty", label: "Empty project" }
             ]
           });
@@ -2038,7 +2043,9 @@ function registerCreateCommand(program2) {
       saveProjectConfig(projectConfig);
       s?.stop(`Project "${project.name}" created and linked`);
       const hasTemplate = template !== "empty";
-      if (hasTemplate) {
+      if (template === "chatbot") {
+        await downloadGitHubTemplate("chatbot", projectConfig, json);
+      } else if (hasTemplate) {
         await downloadTemplate(template, projectConfig, projectName, json, apiUrl);
       }
       await installCliGlobally(json);
@@ -2144,6 +2151,72 @@ async function downloadTemplate(framework, projectConfig, projectName, json, _ap
     }
   }
 }
+async function downloadGitHubTemplate(templateName, projectConfig, json) {
+  const s = !json ? clack10.spinner() : null;
+  s?.start(`Downloading ${templateName} template...`);
+  const tempDir = path2.join(tmpdir(), `insforge-template-${Date.now()}`);
+  try {
+    await fs2.mkdir(tempDir, { recursive: true });
+    await execAsync2(
+      "git clone --depth 1 https://github.com/InsForge/insforge-templates.git .",
+      { cwd: tempDir, maxBuffer: 10 * 1024 * 1024, timeout: 6e4 }
+    );
+    const templateDir = path2.join(tempDir, templateName);
+    const stat3 = await fs2.stat(templateDir).catch(() => null);
+    if (!stat3?.isDirectory()) {
+      throw new Error(`Template "${templateName}" not found in repository`);
+    }
+    s?.message("Copying template files...");
+    const cwd = process.cwd();
+    await copyDir(templateDir, cwd);
+    const envExamplePath = path2.join(cwd, ".env.example");
+    const envExampleExists = await fs2.stat(envExamplePath).catch(() => null);
+    if (envExampleExists) {
+      const anonKey = await getAnonKey();
+      const envExample = await fs2.readFile(envExamplePath, "utf-8");
+      const envContent = envExample.replace(
+        /^([A-Z_]+=)(.*)$/gm,
+        (_, prefix, _value) => {
+          const key = prefix.slice(0, -1);
+          if (/INSFORGE.*(URL|BASE_URL)$/.test(key)) return `${prefix}${projectConfig.oss_host}`;
+          if (/INSFORGE.*ANON_KEY$/.test(key)) return `${prefix}${anonKey}`;
+          return `${prefix}${_value}`;
+        }
+      );
+      await fs2.writeFile(path2.join(cwd, ".env.local"), envContent);
+    }
+    s?.stop(`${templateName} template downloaded`);
+    const migrationPath = path2.join(cwd, "migrations", "db_int.sql");
+    const migrationExists = await fs2.stat(migrationPath).catch(() => null);
+    if (migrationExists) {
+      const dbSpinner = !json ? clack10.spinner() : null;
+      dbSpinner?.start("Running database migrations...");
+      try {
+        const sql = await fs2.readFile(migrationPath, "utf-8");
+        await ossFetch("/api/database/advance/rawsql/unrestricted", {
+          method: "POST",
+          body: JSON.stringify({ query: sql })
+        });
+        dbSpinner?.stop("Database migrations applied");
+      } catch (err) {
+        dbSpinner?.stop("Database migration failed");
+        if (!json) {
+          clack10.log.warn(`Migration failed: ${err.message}`);
+          clack10.log.info('You can run the migration manually: insforge db query --unrestricted "$(cat migrations/db_int.sql)"');
+        }
+      }
+    }
+  } catch (err) {
+    s?.stop(`${templateName} template download failed`);
+    if (!json) {
+      clack10.log.warn(`Failed to download ${templateName} template: ${err.message}`);
+      clack10.log.info("You can manually clone from: https://github.com/InsForge/insforge-templates");
+    }
+  } finally {
+    await fs2.rm(tempDir, { recursive: true, force: true }).catch(() => {
+    });
+  }
+}
 
 // src/commands/info.ts
 function registerContextCommand(program2) {
@@ -2800,8 +2873,7 @@ function registerLogsCommand(program2) {
       await requireAuth();
       const resolved = SOURCE_LOOKUP.get(source.toLowerCase());
       if (!resolved) {
-        console.error(`Invalid log source "${source}". Valid sources: ${VALID_SOURCES.join(", ")}`);
-        process.exit(1);
+        throw new CLIError(`Invalid log source "${source}". Valid sources: ${VALID_SOURCES.join(", ")}`);
       }
       const limit = parseInt(opts.limit, 10) || 20;
       const res = await ossFetch(`/api/logs/${encodeURIComponent(resolved)}?limit=${limit}`);