@insforge/cli 0.1.80 → 0.1.81

package/README.md

@@ -674,17 +674,19 @@ Skill files are written to per-agent directories (e.g. `.claude/`, `.cursor/`, `
 
 The CLI reports anonymous usage events to [PostHog](https://posthog.com) so we can understand which features are being used and prioritize improvements.
 
-Analytics are enabled by default in the published npm package. If you build the CLI from source without setting `POSTHOG_API_KEY` at build time, analytics become a no-op automatically.
+We capture only non-sensitive metadata: the command name, subcommand, outcome (`success`, `applied`, `aborted`, `dry_run`, `no_changes`, `all_skipped`, `error`), flag shape (e.g. `dry_run`, `json_mode`), section names from `insforge.toml` schema (e.g. `auth.smtp`), region, and an OSS-vs-cloud flag. We never send SQL, TOML file contents, credentials, environment variable values, or any free text you type.
+
+If you build the CLI from source without setting `POSTHOG_API_KEY` at build time, analytics become a no-op automatically.
 
 ## Environment Variables
 
-| Variable                | Description                        |
-| ----------------------- | ---------------------------------- |
-| `INSFORGE_ACCESS_TOKEN` | Override the stored access token   |
-| `INSFORGE_PROJECT_ID`   | Override the linked project ID     |
-| `INSFORGE_API_URL`      | Override the Platform API URL      |
-| `INSFORGE_EMAIL`        | Email for non-interactive login    |
-| `INSFORGE_PASSWORD`     | Password for non-interactive login |
+| Variable                | Description                                                     |
+| ----------------------- | --------------------------------------------------------------- |
+| `INSFORGE_ACCESS_TOKEN` | Override the stored access token                                |
+| `INSFORGE_PROJECT_ID`   | Override the linked project ID                                  |
+| `INSFORGE_API_URL`      | Override the Platform API URL                                   |
+| `INSFORGE_EMAIL`        | Email for non-interactive login                                 |
+| `INSFORGE_PASSWORD`     | Password for non-interactive login                              |
 
 ## Non-Interactive / CI Usage
 

package/dist/index.js

@@ -1215,9 +1215,24 @@ function trackPayments(subcommand, config, properties) {
     ...properties
   });
 }
+function trackConfig(subcommand, config, properties) {
+  const distinctId = config?.project_id ?? FAKE_PROJECT_ID;
+  captureEvent(distinctId, "cli_config_invoked", {
+    subcommand,
+    project_id: config?.project_id,
+    project_name: config?.project_name,
+    org_id: config?.org_id,
+    region: config?.region,
+    oss_mode: !config || config.project_id === FAKE_PROJECT_ID,
+    ...properties
+  });
+}
 async function shutdownAnalytics() {
+  if (!client) return;
+  const c = client;
+  client = null;
   try {
-    if (client) await client.shutdown();
+    await c.shutdown();
   } catch {
   }
 }
@@ -6961,7 +6976,7 @@ function registerDiagnoseCommands(diagnoseCmd2) {
         const s = !json ? clack15.spinner() : null;
         s?.start("Collecting diagnostic data...");
         const data2 = await collectDiagnosticData(projectId, ossMode, apiUrl);
-        const cliVersion = "0.1.80";
+        const cliVersion = "0.1.81";
         s?.stop("Data collected");
         if (!json) {
           console.log(`
@@ -8325,7 +8340,6 @@ function registerPaymentsCommands(paymentsCmd2) {
 }
 
 // src/commands/posthog/setup.ts
-import { spawnSync as spawnSync2 } from "child_process";
 import * as clack16 from "@clack/prompts";
 import pc3 from "picocolors";
 
@@ -8528,41 +8542,20 @@ async function runSetup(opts) {
     outputSuccess(`Linked to InsForge project: ${proj.project_name} (${proj.project_id})`);
   }
   const dashboardConnection = await ensureDashboardConnection(proj.project_id, token, opts);
-  if (opts.json) {
-    return {
-      dashboardConnection,
-      wizardSkipped: true,
-      wizardCommand: WIZARD_COMMAND
-    };
-  }
-  outputInfo("Running the official PostHog setup wizard to wire PostHog into your app...");
-  outputInfo(
-    pc3.dim("(it will open a browser for OAuth and let you pick a PostHog project)")
-  );
-  const wizardResult = spawnSync2(NPX_COMMAND, ["-y", "@posthog/wizard@latest"], {
-    stdio: "inherit",
-    env: process.env
-  });
-  if (wizardResult.error) {
-    throw new CLIError(`Failed to launch PostHog wizard: ${wizardResult.error.message}`);
-  }
-  const exitCode = wizardResult.status ?? 1;
-  if (wizardResult.signal === "SIGINT" || exitCode === 130) {
-    clack16.outro("Setup cancelled.");
-    return {
-      dashboardConnection,
-      wizardSkipped: false,
-      wizardExitCode: exitCode
-    };
-  }
-  if (exitCode !== 0) {
-    throw new CLIError(`PostHog wizard exited with code ${exitCode}.`);
+  if (!opts.json) {
+    clack16.note(
+      `Run this in your terminal to wire PostHog into your app code:
+
+  ${WIZARD_COMMAND}
+
+Once it completes, open the Analytics page in your InsForge dashboard.`,
+      "Next step"
+    );
   }
-  clack16.outro("Done. Open the Analytics page in your InsForge dashboard to view data.");
   return {
     dashboardConnection,
-    wizardSkipped: false,
-    wizardExitCode: exitCode
+    wizardSkipped: true,
+    wizardCommand: WIZARD_COMMAND
   };
 }
 async function ensureDashboardConnection(projectId, token, opts) {
@@ -8589,10 +8582,14 @@ async function runConnectFlow(projectId, token, authorizeUrl, opts) {
     process.stderr.write("Your browser should open automatically. If not, copy the URL above.\n");
   } else {
     clack16.log.info("PostHog is not yet connected to your InsForge dashboard.");
-    outputInfo("");
-    outputInfo(`Open this URL to authorize PostHog:
-  ${pc3.cyan(pc3.underline(authorizeUrl))}`);
-    outputInfo("");
+    if (opts.skipBrowser) {
+      clack16.log.info(`Open this URL to authorize PostHog:
+${pc3.cyan(pc3.underline(authorizeUrl))}`);
+    } else {
+      clack16.log.info("Opening browser to authorize PostHog...");
+      clack16.log.info(`If browser doesn't open, visit:
+${pc3.cyan(pc3.underline(authorizeUrl))}`);
+    }
   }
   if (!opts.skipBrowser) {
     try {
@@ -8602,7 +8599,11 @@ async function runConnectFlow(projectId, token, authorizeUrl, opts) {
     }
   }
   const spinner11 = !opts.json && isInteractive ? clack16.spinner() : null;
-  spinner11?.start("Waiting for InsForge dashboard connection... (timeout: 15 minutes)");
+  if (spinner11) {
+    spinner11.start("Waiting for InsForge dashboard connection... (timeout: 15 minutes)");
+  } else if (!opts.json) {
+    clack16.log.info("Waiting for InsForge dashboard connection (up to 15 minutes)...");
+  }
   try {
     await pollPosthogConnection(
       projectId,
@@ -8622,9 +8623,17 @@ async function runConnectFlow(projectId, token, authorizeUrl, opts) {
       },
       opts.apiUrl
     );
-    spinner11?.stop("InsForge dashboard connection received.");
+    if (spinner11) {
+      spinner11.stop("InsForge dashboard connection received.");
+    } else if (!opts.json) {
+      clack16.log.success("InsForge dashboard connection received.");
+    }
   } catch (err) {
-    spinner11?.stop("InsForge dashboard connection wait failed.");
+    if (spinner11) {
+      spinner11.stop("InsForge dashboard connection wait failed.");
+    } else if (!opts.json) {
+      clack16.log.error("InsForge dashboard connection wait failed.");
+    }
     throw err;
   }
 }
@@ -9111,7 +9120,9 @@ function configFromMetadata(raw) {
 function registerConfigExportCommand(cfg) {
   cfg.command("export").description("Pull live project config and write insforge.toml").option("--out <path>", "output path", "insforge.toml").option("--force", "overwrite without confirmation").action(async (opts, cmd) => {
     const { json } = getRootOpts(cmd);
+    let projectConfig = null;
     try {
+      projectConfig = getProjectConfig();
       await requireAuth();
       const target = resolve5(process.cwd(), opts.out);
       if (existsSync10(target) && !opts.force) {
@@ -9128,6 +9139,12 @@ function registerConfigExportCommand(cfg) {
         });
         if (!ok || p.isCancel(ok)) {
           console.log("Aborted.");
+          await reportCliUsage("cli.config.export", true);
+          trackConfig("export", projectConfig, {
+            json_mode: !!json,
+            force: !!opts.force,
+            outcome: "aborted"
+          });
           return;
         }
       }
@@ -9149,9 +9166,23 @@ function registerConfigExportCommand(cfg) {
         }
       }
       await reportCliUsage("cli.config.export", true);
+      trackConfig("export", projectConfig, {
+        json_mode: !!json,
+        force: !!opts.force,
+        skipped_count: skipped.length,
+        outcome: "success"
+      });
     } catch (err) {
       await reportCliUsage("cli.config.export", false);
+      trackConfig("export", projectConfig, {
+        json_mode: !!json,
+        force: !!opts.force,
+        outcome: "error"
+      });
+      await shutdownAnalytics();
       handleError(err, json);
+    } finally {
+      await shutdownAnalytics();
     }
   });
 }
@@ -9460,7 +9491,9 @@ function authPasswordWireKey(key) {
 function registerConfigPlanCommand(cfg) {
   cfg.command("plan").description("Show diff between insforge.toml and live project state").option("--file <path>", "path to insforge.toml", "insforge.toml").action(async (opts, cmd) => {
     const { json } = getRootOpts(cmd);
+    let projectConfig = null;
     try {
+      projectConfig = getProjectConfig();
       await requireAuth();
       const tomlPath = resolve6(process.cwd(), opts.file);
       const tomlSource = readFileSync8(tomlPath, "utf8");
@@ -9483,9 +9516,25 @@ function registerConfigPlanCommand(cfg) {
         }
       }
       await reportCliUsage("cli.config.plan", true);
+      trackConfig("plan", projectConfig, {
+        json_mode: !!json,
+        changes_count: result.changes.length,
+        skipped_count: skipped.length,
+        sections_changed: Array.from(
+          new Set(result.changes.map((c) => changePath(c)))
+        ),
+        outcome: "success"
+      });
     } catch (err) {
       await reportCliUsage("cli.config.plan", false);
+      trackConfig("plan", projectConfig, {
+        json_mode: !!json,
+        outcome: "error"
+      });
+      await shutdownAnalytics();
       handleError(err, json);
+    } finally {
+      await shutdownAnalytics();
     }
   });
 }
@@ -9498,7 +9547,9 @@ import pc6 from "picocolors";
 function registerConfigApplyCommand(cfg) {
   cfg.command("apply").description("Apply insforge.toml to the live project").option("--file <path>", "path to insforge.toml", "insforge.toml").option("--dry-run", "show plan, do not apply").option("--auto-approve", "skip confirmation prompt").action(async (opts, cmd) => {
     const { json, yes } = getRootOpts(cmd);
+    let projectConfig = null;
     try {
+      projectConfig = getProjectConfig();
       await requireAuth();
       const tomlPath = resolve7(process.cwd(), opts.file);
       const tomlSource = readFileSync9(tomlPath, "utf8");
@@ -9508,6 +9559,9 @@ function registerConfigApplyCommand(cfg) {
       const live = liveFromMetadata(raw);
       const result = diffConfig({ live, file });
       const approved = opts.autoApprove || yes;
+      const sectionsChanged = Array.from(
+        new Set(result.changes.map((c) => changePath(c)))
+      );
       if (!json) {
         console.log(formatPlan(result));
       }
@@ -9518,6 +9572,13 @@ function registerConfigApplyCommand(cfg) {
           );
         }
         await reportCliUsage("cli.config.apply", true);
+        trackConfig("apply", projectConfig, {
+          dry_run: !!opts.dryRun,
+          json_mode: !!json,
+          changes_count: result.changes.length,
+          sections_changed: sectionsChanged,
+          outcome: result.changes.length === 0 ? "no_changes" : "dry_run"
+        });
         return;
       }
       if (!approved) {
@@ -9535,6 +9596,12 @@ function registerConfigApplyCommand(cfg) {
         if (!ok || p2.isCancel(ok)) {
           console.log("Aborted.");
           await reportCliUsage("cli.config.apply", true);
+          trackConfig("apply", projectConfig, {
+            json_mode: !!json,
+            changes_count: result.changes.length,
+            sections_changed: sectionsChanged,
+            outcome: "aborted"
+          });
           return;
         }
       }
@@ -9571,9 +9638,25 @@ function registerConfigApplyCommand(cfg) {
         }
       }
       await reportCliUsage("cli.config.apply", true);
+      trackConfig("apply", projectConfig, {
+        auto_approved: !!approved,
+        json_mode: !!json,
+        changes_count: result.changes.length,
+        applied_count: applied.length,
+        skipped_count: skipped.length,
+        sections_changed: sectionsChanged,
+        outcome: applied.length > 0 ? "applied" : "all_skipped"
+      });
     } catch (err) {
       await reportCliUsage("cli.config.apply", false);
+      trackConfig("apply", projectConfig, {
+        json_mode: !!json,
+        outcome: "error"
+      });
+      await shutdownAnalytics();
       handleError(err, json);
+    } finally {
+      await shutdownAnalytics();
     }
   });
 }