@insforge/cli 0.1.44 → 0.1.46

package/dist/index.js

@@ -106,6 +106,39 @@ var ProjectNotLinkedError = class extends CLIError {
     super("No project linked. Run `npx @insforge/cli link` first.", 3, "PROJECT_NOT_LINKED");
   }
 };
+function formatFetchError(err, url) {
+  if (!(err instanceof Error)) return `Network request to ${url} failed: ${String(err)}`;
+  if (err.message !== "fetch failed") return err.message;
+  const cause = err.cause;
+  const code = cause?.code ?? cause?.errno;
+  const causeMsg = cause instanceof Error ? cause.message : typeof cause === "string" ? cause : void 0;
+  let host = url;
+  try {
+    host = new URL(url).host;
+  } catch {
+  }
+  switch (code) {
+    case "ENOTFOUND":
+    case "EAI_AGAIN":
+      return `Cannot resolve ${host} (DNS lookup failed: ${code}). Check your internet connection or DNS settings.`;
+    case "ECONNREFUSED":
+      return `Connection to ${host} refused. The server may be down or blocked by a firewall.`;
+    case "ETIMEDOUT":
+    case "UND_ERR_CONNECT_TIMEOUT":
+      return `Connection to ${host} timed out. Check your network, VPN, or proxy settings.`;
+    case "ECONNRESET":
+    case "UND_ERR_SOCKET":
+      return `Connection to ${host} was reset. A proxy, VPN, or firewall may be interfering.`;
+    case "CERT_HAS_EXPIRED":
+    case "UNABLE_TO_VERIFY_LEAF_SIGNATURE":
+    case "SELF_SIGNED_CERT_IN_CHAIN":
+    case "DEPTH_ZERO_SELF_SIGNED_CERT":
+      return `TLS certificate error contacting ${host} (${code}). Your network may be intercepting HTTPS (corporate proxy / VPN).`;
+  }
+  if (code) return `Network error contacting ${host}: ${code}${causeMsg ? ` \u2014 ${causeMsg}` : ""}`;
+  if (causeMsg) return `Network error contacting ${host}: ${causeMsg}`;
+  return `Network error contacting ${host}.`;
+}
 function getDeploymentError(metadata) {
   if (!metadata || typeof metadata.error !== "object" || !metadata.error) return null;
   return metadata.error.errorMessage ?? null;
@@ -167,36 +200,48 @@ function buildAuthorizeUrl(params) {
   return url.toString();
 }
 async function exchangeCodeForTokens(params) {
-  const res = await fetch(`${params.platformUrl}/api/oauth/v1/token`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      grant_type: "authorization_code",
-      code: params.code,
-      redirect_uri: params.redirectUri,
-      client_id: params.clientId,
-      code_verifier: params.codeVerifier
-    })
-  });
+  const tokenUrl = `${params.platformUrl}/api/oauth/v1/token`;
+  let res;
+  try {
+    res = await fetch(tokenUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        grant_type: "authorization_code",
+        code: params.code,
+        redirect_uri: params.redirectUri,
+        client_id: params.clientId,
+        code_verifier: params.codeVerifier
+      })
+    });
+  } catch (err) {
+    throw new Error(`Token exchange failed \u2014 ${formatFetchError(err, tokenUrl)}`, { cause: err });
+  }
   if (!res.ok) {
     const err = await res.json().catch(() => ({}));
-    throw new Error(err.error_description ?? err.error ?? "Token exchange failed");
+    throw new Error(err.error_description ?? err.error ?? `Token exchange failed (HTTP ${res.status})`);
   }
   return await res.json();
 }
 async function refreshOAuthToken(params) {
-  const res = await fetch(`${params.platformUrl}/api/oauth/v1/token`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      grant_type: "refresh_token",
-      refresh_token: params.refreshToken,
-      client_id: params.clientId
-    })
-  });
+  const tokenUrl = `${params.platformUrl}/api/oauth/v1/token`;
+  let res;
+  try {
+    res = await fetch(tokenUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        grant_type: "refresh_token",
+        refresh_token: params.refreshToken,
+        client_id: params.clientId
+      })
+    });
+  } catch (err) {
+    throw new Error(`Token refresh failed \u2014 ${formatFetchError(err, tokenUrl)}`, { cause: err });
+  }
   if (!res.ok) {
     const err = await res.json().catch(() => ({}));
-    throw new Error(err.error_description ?? err.error ?? "Token refresh failed");
+    throw new Error(err.error_description ?? err.error ?? `Token refresh failed (HTTP ${res.status})`);
   }
   return await res.json();
 }
@@ -394,11 +439,22 @@ async function platformFetch(path5, options = {}, apiUrl) {
     Authorization: `Bearer ${token}`,
     ...options.headers ?? {}
   };
-  const res = await fetch(`${baseUrl}${path5}`, { ...options, headers });
+  const fullUrl = `${baseUrl}${path5}`;
+  let res;
+  try {
+    res = await fetch(fullUrl, { ...options, headers });
+  } catch (err) {
+    throw new CLIError(formatFetchError(err, fullUrl));
+  }
   if (res.status === 401) {
     const newToken = await refreshAccessToken(apiUrl);
     headers.Authorization = `Bearer ${newToken}`;
-    const retryRes = await fetch(`${baseUrl}${path5}`, { ...options, headers });
+    let retryRes;
+    try {
+      retryRes = await fetch(fullUrl, { ...options, headers });
+    } catch (err) {
+      throw new CLIError(formatFetchError(err, fullUrl));
+    }
     if (!retryRes.ok) {
       const err = await retryRes.json().catch(() => ({}));
       throw new CLIError(err.error ?? `Request failed: ${retryRes.status}`, retryRes.status === 403 ? 5 : 1);
@@ -709,6 +765,28 @@ import { join as join2 } from "path";
 import { promisify } from "util";
 import * as clack5 from "@clack/prompts";
 var execAsync = promisify(exec);
+var SKILL_INSTALL_TIMEOUT_MS = 6e4;
+function describeExecError(err) {
+  const e = err;
+  if (e.killed && (e.signal === "SIGTERM" || e.signal === "SIGKILL")) {
+    return `timed out after ${SKILL_INSTALL_TIMEOUT_MS / 1e3}s \u2014 the npm registry may be slow or blocked by your network`;
+  }
+  if (e.code === "ENOENT") {
+    return "`npx` is not on your PATH \u2014 install Node.js 18+ and reopen your shell";
+  }
+  const stderr = (typeof e.stderr === "string" ? e.stderr : e.stderr?.toString()) ?? "";
+  if (/ENOTFOUND|EAI_AGAIN|getaddrinfo/i.test(stderr)) return "cannot reach the npm registry (DNS lookup failed) \u2014 check your internet connection";
+  if (/ECONNREFUSED/i.test(stderr)) return "connection to the npm registry was refused \u2014 a proxy or firewall is likely blocking it";
+  if (/ETIMEDOUT|ESOCKETTIMEDOUT|network timeout/i.test(stderr)) return "the npm registry timed out \u2014 check your VPN, proxy, or corporate network";
+  if (/CERT_HAS_EXPIRED|UNABLE_TO_VERIFY_LEAF_SIGNATURE|SELF_SIGNED_CERT/i.test(stderr)) return "TLS error reaching the npm registry \u2014 a corporate proxy may be intercepting HTTPS";
+  if (/\bE404\b|404 Not Found/i.test(stderr)) return "npm returned 404 \u2014 the `skills` package or a dependency could not be found (check your npm registry config)";
+  if (/EACCES|permission denied/i.test(stderr)) return "permission denied writing files \u2014 run from a directory you own, without sudo";
+  if (/ENOSPC|no space left/i.test(stderr)) return "no disk space left to install the package";
+  if (/\b401\b|EAUTH|authentication/i.test(stderr)) return "npm authentication failed \u2014 check ~/.npmrc";
+  if (typeof e.code === "number") return `npx exited with code ${e.code}`;
+  if (typeof e.code === "string") return e.code;
+  return e.message ?? "unknown error";
+}
 var GITIGNORE_ENTRIES = [
   ".insforge",
   ".agent",
@@ -741,33 +819,41 @@ async function installSkills(json) {
     if (!json) clack5.log.info("Installing InsForge agent skills...");
     await execAsync("npx skills add insforge/agent-skills -y -a antigravity -a augment -a claude-code -a cline -a codex -a cursor -a gemini-cli -a github-copilot -a kilo -a qoder -a qwen-code -a roo -a trae -a windsurf", {
       cwd: process.cwd(),
-      timeout: 6e4
+      timeout: SKILL_INSTALL_TIMEOUT_MS
     });
     if (!json) clack5.log.success("InsForge agent skills installed.");
-  } catch {
-    if (!json) clack5.log.warn("Failed to install agent skills. You can run manually: npx skills add insforge/agent-skills");
+  } catch (err) {
+    if (!json) {
+      clack5.log.warn(`Could not install agent skills: ${describeExecError(err)}`);
+      clack5.log.info("Run `npx skills add insforge/agent-skills` once resolved to see the full output.");
+    }
   }
   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
+      timeout: SKILL_INSTALL_TIMEOUT_MS
     });
     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");
+  } catch (err) {
+    if (!json) {
+      clack5.log.warn(`Could not install find-skills: ${describeExecError(err)}`);
+      clack5.log.info("Run `npx skills add https://github.com/vercel-labs/skills --skill find-skills` once resolved.");
+    }
   }
   try {
     updateGitignore();
   } catch {
   }
 }
-async function reportCliUsage(toolName, success, maxRetries = 1) {
-  let config;
-  try {
-    config = getProjectConfig();
-  } catch {
-    return;
+async function reportCliUsage(toolName, success, maxRetries = 1, explicitConfig) {
+  let config = explicitConfig;
+  if (!config) {
+    try {
+      config = getProjectConfig();
+    } catch {
+      return;
+    }
   }
   if (!config) return;
   const payload = JSON.stringify({
@@ -1215,7 +1301,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, chatbot, crm, e-commerce, 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, crm, e-commerce, todo, or empty").action(async (opts, cmd) => {
     const { json, apiUrl } = getRootOpts(cmd);
     try {
       await requireAuth(apiUrl, false);
@@ -1266,7 +1352,7 @@ function registerCreateCommand(program2) {
       if (projectName.length < 2 || projectName === "." || projectName === "..") {
         throw new CLIError("Project name must be at least 2 safe characters (letters, numbers, hyphens).");
       }
-      const validTemplates = ["react", "nextjs", "chatbot", "crm", "e-commerce", "empty"];
+      const validTemplates = ["react", "nextjs", "chatbot", "crm", "e-commerce", "todo", "empty"];
       let template = opts.template;
       if (template && !validTemplates.includes(template)) {
         throw new CLIError(`Invalid template "${template}". Valid options: ${validTemplates.join(", ")}`);
@@ -1296,7 +1382,8 @@ function registerCreateCommand(program2) {
                 { value: "nextjs", label: "Web app template with Next.js" },
                 { value: "chatbot", label: "AI Chatbot with Next.js" },
                 { value: "crm", label: "CRM with Next.js" },
-                { value: "e-commerce", label: "E-Commerce store with Next.js" }
+                { value: "e-commerce", label: "E-Commerce store with Next.js" },
+                { value: "todo", label: "Todo app with Next.js" }
               ]
             });
             if (clack7.isCancel(selected)) process.exit(0);
@@ -1359,7 +1446,7 @@ function registerCreateCommand(program2) {
         saveProjectConfig(projectConfig);
         projectLinked = true;
         s?.stop(`Project "${project.name}" created and linked`);
-        const githubTemplates = ["chatbot", "crm", "e-commerce", "nextjs", "react"];
+        const githubTemplates = ["chatbot", "crm", "e-commerce", "nextjs", "react", "todo"];
         if (githubTemplates.includes(template)) {
           await downloadGitHubTemplate(template, projectConfig, json);
         } else if (hasTemplate) {
@@ -1618,7 +1705,7 @@ function buildOssHost2(appkey, region) {
   return `https://${appkey}.${region}.insforge.app`;
 }
 function registerProjectLinkCommand(program2) {
-  program2.command("link").description("Link current directory to an InsForge project").option("--project-id <id>", "Project ID to link").option("--org-id <id>", "Organization ID").option("--template <template>", "Download a template after linking: react, nextjs, chatbot, crm, e-commerce").option("--api-base-url <url>", "API Base URL for direct linking (OSS/Self-hosted)").option("--api-key <key>", "API Key for direct linking (OSS/Self-hosted)").action(async (opts, cmd) => {
+  program2.command("link").description("Link current directory to an InsForge project").option("--project-id <id>", "Project ID to link").option("--org-id <id>", "Organization ID").option("--template <template>", "Download a template after linking: react, nextjs, chatbot, crm, e-commerce, todo").option("--api-base-url <url>", "API Base URL for direct linking (OSS/Self-hosted)").option("--api-key <key>", "API Key for direct linking (OSS/Self-hosted)").action(async (opts, cmd) => {
     const { json, apiUrl } = getRootOpts(cmd);
     try {
       if (opts.apiBaseUrl || opts.apiKey) {
@@ -1649,7 +1736,7 @@ function registerProjectLinkCommand(program2) {
           }
           trackCommand("link", "oss-org", { direct: true });
           await installSkills(json);
-          await reportCliUsage("cli.link_direct", true, 6);
+          await reportCliUsage("cli.link_direct", true, 6, projectConfig2);
           try {
             const urlMatch = opts.apiBaseUrl.match(/^https?:\/\/([^.]+)\.[^.]+\.insforge\.app/);
             if (urlMatch) {
@@ -1747,14 +1834,14 @@ function registerProjectLinkCommand(program2) {
         outputSuccess(`Linked to project "${project.name}" (${project.appkey}.${project.region})`);
       }
       await installSkills(json);
-      await reportCliUsage("cli.link", true, 6);
+      await reportCliUsage("cli.link", true, 6, projectConfig);
       try {
         await reportAgentConnected({ project_id: project.id }, apiUrl);
       } catch {
       }
       const template = opts.template;
       if (template) {
-        const validTemplates = ["react", "nextjs", "chatbot", "crm", "e-commerce"];
+        const validTemplates = ["react", "nextjs", "chatbot", "crm", "e-commerce", "todo"];
         if (!validTemplates.includes(template)) {
           throw new CLIError(`Invalid template "${template}". Valid options: ${validTemplates.join(", ")}`);
         }
@@ -1785,7 +1872,7 @@ function registerProjectLinkCommand(program2) {
         process.chdir(templateDir);
         saveProjectConfig(projectConfig);
         captureEvent(orgId ?? project.organization_id, "template_selected", { template, source: "link" });
-        const githubTemplates = ["chatbot", "crm", "e-commerce", "nextjs", "react"];
+        const githubTemplates = ["chatbot", "crm", "e-commerce", "nextjs", "react", "todo"];
         if (githubTemplates.includes(template)) {
           await downloadGitHubTemplate(template, projectConfig, json);
         } else {