@code-insights/cli 3.6.1 → 4.0.0

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 All notable changes to `@code-insights/cli` will be documented in this file.
 
+## [4.0.0] - 2026-03-16
+
+### Added
+
+- **Reflect & Patterns** — Cross-session pattern detection and synthesis via LLM. New `reflect` CLI command generates weekly insights: friction points, effective patterns, prompt quality analysis, and working style rules. New `stats patterns` subcommand shows patterns in the terminal. New Patterns dashboard page with weekly report card layout and ISO week navigation.
+- **Session facets** — Each analyzed session now produces structured facets (outcome, workflow, friction, effective patterns, course corrections) stored in a dedicated `session_facets` table. Facets power Reflect aggregation.
+- **Friction taxonomy** — 9 canonical friction categories (wrong-approach, knowledge-gap, stale-assumptions, incomplete-requirements, context-loss, scope-creep, repeated-mistakes, documentation-gap, tooling-limitation) with attribution model (user-actionable, AI capability, environmental) and CoT reasoning.
+- **Effective pattern taxonomy** — 8 canonical pattern categories (structured-planning, incremental-implementation, verification-workflow, systematic-debugging, self-correction, context-gathering, domain-expertise, effective-tooling) with driver classification (user-driven, AI-driven, collaborative).
+- **Prompt quality taxonomy** — 7 deficit + 3 strength categories replacing efficiency scores. Two-layer output: user-facing takeaways (before/after) and categorized findings for Reflect aggregation. 5 dimension scores (context_provision, request_specificity, scope_management, information_timing, correction_quality).
+- **ISO week navigation** — `reflect --week 2026-W11` replaces sliding `--period` windows. Dashboard WeekSelector with session counts and snapshot status per week.
+- **Reflect backfill** — `reflect backfill` extracts facets for sessions synced before Reflect existed. Handles both missing and outdated sessions in one pass. `--prompt-quality` flag for PQ-specific backfill.
+- **Reflect snapshots** — Cross-session synthesis results are cached in `reflect_snapshots` table with staleness detection and auto-load.
+- **LLM prompt caching** — Shared cacheable conversation prefix for Anthropic (prompt-caching beta) and OpenAI (automatic prefix caching). Estimated ~32% input token savings on Anthropic.
+- **LLM cost tracking** — New `analysis_usage` table tracks per-session analysis cost with provider, model, token counts, and duration. Dashboard cost UI on session detail page.
+- **Soft-delete sessions** — `sync prune` with preview+confirm UX. Trash button in dashboard. Deleted sessions filtered from all API endpoints.
+- **Chat view system events** — Context break dividers, inline command chips for slash commands, protocol noise hidden. Raw message toggle for full conversation view.
+- **VS Code Copilot Chat support** — Added to supported tools table and provider documentation (provider existed since v2.1.0 but was undocumented in READMEs).
+- **Message classification V6** — `compact_count`, `auto_compact_count`, `slash_commands` columns. V6 prompt context signals for better LLM analysis. Auto force-sync and stale insight advisory on V6 migration.
+- **PQ signals in Reflect** — Prompt quality category aggregation wired into friction-wins synthesis for richer weekly reports.
+
+### Changed
+
+- **SQLite Schema V5** — `deleted_at` column for soft-delete support.
+- **SQLite Schema V6** — `compact_count`, `auto_compact_count`, `slash_commands` columns on sessions.
+- **SQLite Schema V7** — `analysis_usage` table with composite PK `(session_id, analysis_type)`.
+- **`reflect --period` → `reflect --week`** — CLI flag replaced. Use ISO week format `YYYY-WNN` (default: current week).
+- **Prompt quality metadata shape** — Dimension scores replace efficiency score. Dashboard handles both new and legacy formats via dual-read.
+- **Friction display** — Bar chart replaced with category+description list matching effective patterns layout.
+- **Patterns page** — Multiple redesigns: 2-tab→3-tab layout, hero card, weekly report card, data-driven week navigation.
+- **Session analysis prompt** — Restructured for better facet quality with auto-applied LLM-suggested titles.
+- **Actor-neutral classification** — Friction/pattern prompts use neutral category definitions with evidence-based attribution decision trees.
+
+### Fixed
+
+- **Inflated user_message_count** — Claude Code JSONL parser now correctly counts user messages.
+- **Gemini JSON response mode** — Enabled JSON response mode to prevent malformed LLM output.
+- **Insights API default limit** — Raised from 100 to 5000 to prevent truncated results.
+- **Week range generation** — Monday milliseconds normalized to UTC midnight; correct Monday bucketing in GROUP BY queries.
+- **PostHog telemetry routing** — CLI and dashboard telemetry routed through correct endpoints.
+
+### Improved
+
+- **Test coverage** — Expanded to 80%+ across CLI and server packages. Added migration idempotency tests, V6 classification tests, shared-aggregation coverage.
+- **Code organization** — Major refactoring: split monolithic `analysis.ts` and `prompts.ts` into focused modules, shared normalizer infrastructure, route helpers (`trackAnalysisResult`, `streamSessionAnalysis`, `streamBatchBackfill`), dashboard component decomposition.
+- **Normalizer infrastructure** — Shared `normalizeCategory()` used by friction, pattern, and prompt quality normalizers.
+
 ## [3.6.1] - 2026-03-04
 
 ### Changed

package/README.md

@@ -4,7 +4,7 @@
 
 <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.
+Analyze AI coding sessions from the terminal. Parses session history from Claude Code, Cursor, Codex CLI, Copilot CLI, and VS Code Copilot Chat — stores everything in a local SQLite database — and serves a built-in browser dashboard with cross-session pattern detection.
 
 **Local-first. No accounts. No cloud. No data leaves your machine.**
 
@@ -51,6 +51,7 @@ The dashboard opens at `http://localhost:7890` and shows your sessions, analytic
 | **Cursor** | Workspace storage SQLite (macOS, Linux, Windows) |
 | **Codex CLI** | `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` |
 | **Copilot CLI** | `~/.copilot/session-state/{id}/events.jsonl` |
+| **VS Code Copilot Chat** | Platform-specific Copilot Chat storage |
 
 Sessions from all tools are discovered automatically during sync.
 
@@ -62,9 +63,11 @@ code-insights dashboard
 
 Opens the built-in React dashboard at `http://localhost:7890`. The dashboard provides:
 
-- **Session Browser** — search, filter, and view full session details
+- **Session Browser** — search, filter, soft-delete, and view full session details with chat view
 - **Analytics** — usage patterns, cost trends, activity charts
-- **LLM Insights** — AI-generated summaries, decisions (with reasoning and trade-offs), learnings (with root cause analysis), prompt quality scoring with session traits
+- **LLM Insights** — AI-generated summaries, decisions, learnings, and prompt quality analysis (7 deficit + 3 strength categories with dimension scores)
+- **Patterns** — weekly cross-session synthesis: friction points (with attribution), effective patterns (with driver classification), working style rules
+- **Export** — LLM-powered cross-session synthesis in 4 formats (Agent Rules, Knowledge Brief, Obsidian, Notion)
 - **Settings** — configure your LLM provider for analysis
 
 <p align="center">
@@ -135,6 +138,9 @@ code-insights sync --verbose
 
 # Regenerate titles for all sessions
 code-insights sync --regenerate-titles
+
+# Soft-delete sessions (preview + confirm)
+code-insights sync prune
 ```
 
 ### Terminal Analytics
@@ -154,6 +160,9 @@ code-insights stats today
 
 # Model usage distribution and cost chart
 code-insights stats models
+
+# Cross-session patterns summary
+code-insights stats patterns
 ```
 
 <p align="center">
@@ -169,6 +178,33 @@ code-insights stats models
 | `--source <tool>` | Filter by source tool |
 | `--no-sync` | Skip auto-sync before displaying stats |
 
+### Reflect & Patterns
+
+Cross-session pattern detection and synthesis. Requires an LLM provider to be configured.
+
+```bash
+# Generate weekly cross-session synthesis (current week)
+code-insights reflect
+
+# Reflect on a specific ISO week
+code-insights reflect --week 2026-W11
+
+# Scope to a specific project
+code-insights reflect --project "my-project"
+
+# Backfill facets for sessions that were synced before Reflect existed
+code-insights reflect backfill
+
+# Backfill prompt quality analysis
+code-insights reflect backfill --prompt-quality
+```
+
+The Reflect feature analyzes your sessions to surface:
+- **Friction points** — recurring obstacles classified into 9 categories with attribution (user-actionable, AI capability, environmental)
+- **Effective patterns** — working strategies across 8 categories with driver classification (user-driven, AI-driven, collaborative)
+- **Prompt quality** — how well you communicate with AI tools (7 deficit + 3 strength categories)
+- **Working style** — rules and skills derived from your sessions
+
 ### Status & Maintenance
 
 ```bash
@@ -211,7 +247,7 @@ CODE_INSIGHTS_TELEMETRY_DISABLED=1 code-insights sync
 
 ## LLM Configuration
 
-Session analysis (summaries, decisions, learnings) requires an LLM provider. Configure it via CLI or the dashboard Settings page.
+Session analysis (summaries, decisions, learnings, facets) and Reflect synthesis require an LLM provider. Configure it via CLI or the dashboard Settings page.
 
 ```bash
 code-insights config llm