@productbrain/cli 0.1.0-beta.29 → 0.1.0-beta.30

package/dist/lib/telemetry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Telemetry — fire-and-forget event tracking for CLI onboarding and usage.
+ *
+ * Contract: trackEvent(event, properties?) → void. Never blocks, errors silently swallowed.
+ * Event names follow STD-155: setup_started, key_validated, workspace_bound,
+ * first_capture_prompted, setup_completed.
+ *
+ * Current implementation: no-op placeholder that logs to console.debug in dev mode only.
+ * The actual PostHog integration comes later — the contract matters more than the transport.
+ */
+/**
+ * Fire-and-forget telemetry event. Never throws, never blocks.
+ */
+export declare function trackEvent(event: string, properties?: Record<string, unknown>): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/lib/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUpF"}

package/dist/lib/telemetry.js

@@ -0,0 +1,29 @@
+/**
+ * Telemetry — fire-and-forget event tracking for CLI onboarding and usage.
+ *
+ * Contract: trackEvent(event, properties?) → void. Never blocks, errors silently swallowed.
+ * Event names follow STD-155: setup_started, key_validated, workspace_bound,
+ * first_capture_prompted, setup_completed.
+ *
+ * Current implementation: no-op placeholder that logs to console.debug in dev mode only.
+ * The actual PostHog integration comes later — the contract matters more than the transport.
+ */
+function isDevMode() {
+    return process.env.NODE_ENV === 'development' || process.env.PB_DEV === '1';
+}
+/**
+ * Fire-and-forget telemetry event. Never throws, never blocks.
+ */
+export function trackEvent(event, properties) {
+    try {
+        if (isDevMode()) {
+            console.debug(`[telemetry] ${event}`, properties ?? '');
+        }
+        // Future: POST to PostHog or telemetry endpoint here.
+        // Must remain fire-and-forget — wrap in a non-awaited promise, swallow errors.
+    }
+    catch {
+        // Telemetry must never break the CLI flow.
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/lib/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,SAAS,SAAS;IAChB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAAoC;IAC5E,IAAI,CAAC;QACH,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,eAAe,KAAK,EAAE,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,sDAAsD;QACtD,+EAA+E;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productbrain/cli",
-  "version": "0.1.0-beta.29",
+  "version": "0.1.0-beta.30",
   "description": "Product Brain — Chain knowledge and write-back CLI",
   "type": "module",
   "bin": {