@code-insights/cli 3.3.0 → 3.3.2

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 All notable changes to `@code-insights/cli` will be documented in this file.
 
+## [3.3.2] - 2026-03-02
+
+### Added
+
+- **Richer analysis prompts (v3.0.0)** — Decomposed insight schemas: decisions now include situation, choice, reasoning, alternatives (with rejection reason), trade-offs, and revisit conditions. Learnings include symptom, root cause, transferable takeaway, and applicability. Summaries include outcome status.
+- **Session traits in prompt quality** — Detects higher-level behavioral patterns: context drift, objective bloat, late context, no planning, and good structure. Each trait includes severity, evidence, and suggestions.
+- **LLM-based session character classification** — Sessions are classified into one of 7 types (deep_focus, bug_hunt, feature_build, exploration, refactor, learning, quick_task) by the LLM during analysis, replacing the heuristic-only approach.
+- **PR link extraction** — GitHub PR links referenced in session messages are automatically detected and displayed as clickable badges on the session detail page.
+- **Few-shot examples in analysis prompt** — Two curated examples (a decision and a learning) set the quality bar for LLM output.
+- **Chain-of-thought pre-analysis** — Prompt quality analysis now uses a 6-step mental walkthrough before scoring.
+
+### Changed
+
+- **Analysis version bumped to 3.0.0** — New decomposed schemas are not backward-compatible with v2 insight format. Re-analyze sessions to generate v3 insights.
+- **Tool result cap raised from 200 to 500 chars** — Better context for error messages in analysis input.
+- **Source tool badge shown for all sessions** — Previously hidden for claude-code sessions.
+
+### Fixed
+
+- **Dashboard compact layout** — Higher information density across dashboard pages.
+- **7-day range filter** — Default range filter applied to dashboard and analytics.
+- **LLM JSON truncation** — 3-layer fix: max_tokens 8192, jsonrepair fallback, conciseness constraints.
+- **PostHog exception tracking** — Stack trace frames included in error reports.
+
+## [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

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.
 
@@ -52,15 +56,14 @@ Opens the built-in React dashboard at `http://localhost:7890`. The dashboard pro
 
 - **Session Browser** — search, filter, and view full session details
 - **Analytics** — usage patterns, cost trends, activity charts
-- **LLM Insights** — AI-generated summaries, decisions, learnings, and techniques
+- **LLM Insights** — AI-generated summaries, decisions (with reasoning and trade-offs), learnings (with root cause analysis), prompt quality scoring with session traits
 - **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