@ipation/specbridge 1.1.2 → 1.2.1

package/CHANGELOG.md

@@ -7,6 +7,109 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.1] - 2026-02-03
+
+### Fixed
+- **Dashboard Chart.js rendering**: Fixed chart initialization timing issue by adding 100ms delay to ensure canvas element is fully mounted before rendering
+- **Build process**: Configured tsup to automatically copy dashboard static files (`src/dashboard/public/`) to `dist/public/` during build
+- **Chart enhancements**: Added better error handling, formatted date labels, tooltips, and improved visual styling for compliance trend chart
+
+### Changed
+- **Build output**: Dashboard static files now automatically included in build output without manual intervention
+- **.gitignore**: Added `.playwright-mcp/` and `.specbridge/reports/history/` to ignore test and runtime artifacts
+
+## [1.2.0] - 2026-02-03
+
+### Phase 4: Analytics & Insights
+
+### Added
+
+#### Report Storage & History
+- **Automatic report persistence**: All reports now auto-save to `.specbridge/reports/history/`
+- **Historical data management**: Store and retrieve compliance reports over time
+- **Report cleanup**: Automatic retention management (default: 90 days)
+- **Date-based retrieval**: Load reports by specific dates or ranges
+
+#### Drift Detection
+- **Compliance drift analysis**: Compare current vs. previous reports
+- **Trend classification**: Automatic categorization (improving/stable/degrading)
+- **Violation tracking**: Track new vs. fixed violations by severity
+- **Decision-level drift**: Per-decision compliance changes
+- **Top movers identification**: Automatically identify most improved/degraded decisions
+
+#### Trend Analysis
+- **Multi-period trends**: Analyze compliance patterns over 7-90 days
+- **Visual data points**: Chart-ready data for compliance visualization
+- **Per-decision trends**: Track individual decision compliance over time
+- **Period summaries**: Start/end compliance with overall change calculation
+
+#### Analytics Engine
+- **Decision metrics**: Deep analysis of individual decisions with historical context
+- **Automated insights**: AI-generated observations, warnings, and suggestions
+- **Performance ranking**: Identify top and bottom performing decisions
+- **Trend detection**: Automatic pattern recognition in compliance data
+- **Insight categories**: Warnings (🟠), Successes (🟢), Suggestions (💡)
+
+#### CLI Enhancements
+- **`specbridge report --trend`**: Show compliance trends over time
+- **`specbridge report --drift`**: Analyze drift since last report
+- **`specbridge report --days <n>`**: Specify analysis period
+- **`specbridge analytics`**: New analytics command with comprehensive insights
+- **`specbridge analytics [decision-id]`**: Per-decision analysis
+- **`specbridge analytics --insights`**: Show AI-generated insights
+- **`specbridge dashboard`**: Launch interactive web dashboard
+
+#### Web Dashboard
+- **Real-time monitoring**: Interactive compliance dashboard with live data
+- **Visual compliance score**: Large, prominent score with trend indicators
+- **30-day trend chart**: Interactive Chart.js visualization
+- **Decision breakdown**: Sortable table with per-decision compliance
+- **Automated insights panel**: Display warnings, successes, and suggestions
+- **Modern React UI**: Responsive design with gradient styling
+- **Mobile-friendly**: Adaptive layout for all screen sizes
+
+#### REST API
+- 11 new API endpoints for programmatic access to compliance data
+- Full CRUD operations for reports, decisions, and analytics
+- Configurable query parameters for flexible data retrieval
+- Consistent error handling and response formats
+
+#### Documentation
+- **Interactive demo guide**: Step-by-step walkthrough of all features
+- **Quick start guide**: 5-minute setup with sample data
+- **Comprehensive API reference**: Full TypeScript/JavaScript/REST API docs
+- **Feature documentation**: Detailed explanation of analytics capabilities
+- **Sample data generator**: Script to create realistic historical reports
+- **Integration examples**: Slack, email, CI/CD, and monitoring integrations
+
+### Changed
+- **Report command**: Now auto-saves all reports to history by default
+- **Report output**: Enhanced with trend indicators (📈/📉/➡️)
+- **CLI experience**: Improved formatting with colors and visual indicators
+
+### Dependencies
+- **Added**: `express@^4.18.0` - Web server framework for dashboard
+- **Added**: `@types/express@^4.17.0` - TypeScript types for Express
+
+### Testing
+- **Total tests**: 951 (all passing)
+- **New tests**: 58 for Phase 4 components
+- **Coverage**: >95% for all new code
+
+### Files Added
+- `src/reporting/storage.ts` - Historical report storage
+- `src/reporting/drift.ts` - Drift detection and trend analysis
+- `src/analytics/engine.ts` - Analytics engine with insight generation
+- `src/dashboard/server.ts` - Express REST API server
+- `src/dashboard/public/index.html` - React dashboard UI
+- `src/cli/commands/analytics.ts` - Analytics CLI command
+- `src/cli/commands/dashboard.ts` - Dashboard CLI command
+- `docs/demos/phase4-analytics-demo.md` - Interactive demo guide (900+ lines)
+- `docs/demos/QUICKSTART.md` - Quick start guide
+- `docs/demos/generate-sample-data.sh` - Sample data generator
+- `docs/features/analytics-and-insights.md` - Feature documentation (1200+ lines)
+- `docs/API.md` - Complete API reference (900+ lines)
+
 ## [1.1.2] - 2026-02-02
 
 ### Documentation

package/README.md

@@ -16,6 +16,8 @@ SpecBridge creates a living integration layer between design intent and implemen
 - **Verification Engine** - Continuously verifies code compliance at multiple levels
 - **Propagation Engine** - Analyzes impact when architectural decisions change
 - **Compliance Reporting** - Provides dashboards and tracks conformity over time
+- **Analytics & Insights** - AI-generated insights, drift detection, and trend analysis
+- **Interactive Dashboard** - Real-time compliance monitoring with visual charts
 - **Agent Interface** - Exposes decisions to code generation agents (Copilot, Claude, etc.)
 
 ## Installation
@@ -92,7 +94,31 @@ specbridge report
 specbridge report --format markdown --save
 ```
 
-### 6. Integrate with AI agents
+Track compliance trends over time:
+```bash
+specbridge report --trend --days 30
+specbridge report --drift
+```
+
+### 6. Analyze compliance with AI insights
+
+```bash
+specbridge analytics
+specbridge analytics --insights
+specbridge analytics auth-001
+```
+
+Get AI-generated insights about compliance trends, violations, and decision impact.
+
+### 7. Launch interactive dashboard
+
+```bash
+specbridge dashboard
+```
+
+Open your browser to view real-time compliance metrics, trend charts, and insights.
+
+### 8. Integrate with AI agents
 
 ```bash
 specbridge context src/api/auth.ts
@@ -222,6 +248,11 @@ verification:
 | `specbridge decision create <id>` | Create new decision |
 | `specbridge decision validate` | Validate decision files |
 | `specbridge report` | Generate compliance report |
+| `specbridge report --trend` | Show compliance trends over time |
+| `specbridge report --drift` | Analyze drift since last report |
+| `specbridge analytics` | Analyze compliance with AI insights |
+| `specbridge analytics <id>` | Analyze specific decision |
+| `specbridge dashboard` | Launch interactive web dashboard |
 | `specbridge hook install` | Install git hooks |
 | `specbridge hook run` | Run verification (for hooks) |
 | `specbridge context <file>` | Generate agent context |