@code-insights/cli 3.2.0 → 3.3.1

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 All notable changes to `@code-insights/cli` will be documented in this file.
 
+## [3.3.1] - 2026-03-02
+
+### Added
+
+- **Error telemetry with PostHog `captureException`** — All CLI commands (sync, dashboard, init, status, reset, install-hook) and server analysis routes now capture exceptions with classified error types and enriched context via `captureError()`.
+- **Structured parse errors** — Server analysis routes use `ParseResult<T>` type for structured LLM response parsing with error classification (`error_type`, `response_length`).
+- **CLI ASCII art banner** — Branded ASCII banner displayed on `code-insights init` welcome message and `code-insights dashboard` launch.
+- **Logo integration** — Monochrome logo component added to dashboard header and mobile nav. Favicon replaced with branded logo. Logo assets added to READMEs.
+- **CI gate** — GitHub Actions workflow for automated build + test on push/PR to master.
+- **Test coverage expansion** — New tests for `config.ts` utilities and `config.test.ts` server route. Existing `read-write.test.ts` and `prompts.test.ts` tests enhanced.
+
+### Fixed
+
+- **Server chunked analysis** — Guard against all chunks failing in chunked analysis path, preventing unhandled errors.
+
+## [3.3.0] - 2026-03-02
+
+### Changed
+
+- **Telemetry migrated from Supabase to PostHog** — Replaces the custom Supabase Edge Function with PostHog for product analytics. Provides retention charts, feature funnels, and a real analytics dashboard instead of raw event storage.
+- **Stable machine identity** — Machine IDs no longer rotate monthly, enabling accurate unique user counts and retention analysis. IDs remain anonymous (SHA-256 hash, no PII).
+- **Expanded event schema** — All CLI commands now include `duration_ms` for performance tracking. Sync events include exact session counts and per-provider breakdowns. Analysis events capture LLM provider and model.
+- **Dashboard telemetry** — Page views and load timing tracked via `posthog-js` (client-side). Configured with `autocapture: false`, `persistence: 'memory'`, `ip: false` for privacy.
+- **`trackEvent` signature change** — Now accepts `(event: TelemetryEventName, properties?)` instead of `(command, success, subcommand?)`. Typed event names for autocomplete and typo prevention.
+
+### Added
+
+- **`GET /api/telemetry/identity`** — New server endpoint returns shared `distinct_id` for dashboard SPA initialization.
+- **`shutdownTelemetry()`** — Graceful PostHog flush on server shutdown with 3-second timeout guard.
+- **`posthog-node`** dependency in CLI (~20KB, lazy-initialized)
+- **`posthog-js`** dependency in dashboard (~45KB, memory-only persistence)
+- **Analysis failure tracking** — `analysis_run` events now fire on both success and failure for observability.
+
+### Removed
+
+- Supabase Edge Function endpoint, HMAC signing key, and `signPayload()`
+- Monthly-rotating machine ID (`getMachineId()` with date salt)
+- `getSessionCountBucket()` — replaced by exact `total_sessions` person property
+- `getDataSource()` — always 'local', provided no value
+
+### Fixed
+
+- **`RecurringInsightResult.groups`** — Fixed type error using `.insights` instead of `.groups` for recurring insight count.
+
 ## [3.1.1] - 2026-03-02
 
 ### Fixed

package/README.md

@@ -1,4 +1,8 @@
-# Code Insights CLI
+<p align="center">
+  <img src="https://raw.githubusercontent.com/melagiri/code-insights/master/docs/assets/logo.svg" width="80" height="80" alt="Code Insights logo" />
+</p>
+
+<h1 align="center">Code Insights CLI</h1>
 
 Analyze AI coding sessions from the terminal. Parses session history from Claude Code, Cursor, Codex CLI, and Copilot CLI — stores everything in a local SQLite database — and serves a built-in browser dashboard.
 
@@ -55,12 +59,11 @@ Opens the built-in React dashboard at `http://localhost:7890`. The dashboard pro
 - **LLM Insights** — AI-generated summaries, decisions, learnings, and techniques
 - **Settings** — configure your LLM provider for analysis
 
-> **Screenshot:** _Coming soon_
-
-### Custom Port
+### Options
 
 ```bash
-code-insights dashboard --port 8080
+code-insights dashboard --port 8080    # Custom port
+code-insights dashboard --no-open      # Start server without opening browser
 ```
 
 ## CLI Commands
@@ -152,8 +155,9 @@ code-insights stats models
 # Show sync statistics (sessions, projects, last sync)
 code-insights status
 
-# Open the local dashboard in your browser (server must already be running)
+# Open the local dashboard in your browser
 code-insights open
+code-insights open --project           # Open filtered to the current project
 
 # Delete all local data and reset sync state
 code-insights reset --confirm