@ipation/specbridge 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -7,7 +7,76 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [1.2.0] - 2024-02-03 - Phase 4: Analytics & Insights
+## [1.3.0] - 2026-02-03
+
+### Phase 5: Foundational Trust & Propagation (v1.3 - Non-Breaking)
+
+### Added
+
+#### Structured Constraints
+- **Machine-readable constraint specification**: New optional `check` block in constraints with `verifier` and `params` fields
+- **Backward compatibility**: Legacy `verifier` field continues to work; `check` block takes priority when present
+- **Type-safe parameters**: Structured parameters passed to verifiers, validated by Zod schema
+- **Better verifier selection**: Three-tier priority system - check.verifier → verifier field → auto-detection
+
+#### Verification Debuggability
+- **--explain mode**: New `specbridge verify --explain` flag shows detailed verification trace
+- **Constraint application tracking**: See which constraints applied/skipped for each file and why
+- **Verifier selection visibility**: Shows which verifier was selected and why
+- **Execution metrics**: Displays violation count and execution time per constraint
+- **Error transparency**: Failed verifications show full error details in explanation
+
+#### Stop Silent Failures
+- **Warning system**: Missing verifiers now log warnings with available alternatives
+- **Error reporting**: Verifier exceptions logged with full stack traces
+- **Structured diagnostics**: `VerificationResult` includes `warnings` and `errors` arrays
+- **CLI output**: Warnings and errors displayed before summary with proper formatting
+- **Non-blocking errors**: Verification continues after errors instead of silently stopping
+
+#### Propagation Exposure
+- **Impact analysis command**: New `specbridge impact <decision-id>` command
+- **Change type support**: Analyze created, modified, or deprecated decisions
+- **Affected files tracking**: Shows all files impacted with violation counts
+- **Auto-fix detection**: Identifies which violations can be automatically fixed
+- **Migration planning**: Generated step-by-step migration plans (automated vs manual)
+- **Effort estimation**: Calculates low/medium/high effort based on violation complexity
+- **JSON output**: Machine-readable format via `--json` flag
+
+### Changed
+- **VerificationResult interface**: Added optional `warnings` and `errors` fields
+- **VerificationEngine**: Enhanced error handling with detailed logging
+- **Verifier selection**: Updated priority system to support structured check blocks
+
+### Documentation
+- **Decision format**: Updated with new `check` block format examples
+- **CLI help**: Enhanced with new --explain option documentation
+
+### Tests
+- **18 new tests**: Added comprehensive test coverage for v1.3 features
+  - ConstraintCheckSchema validation tests
+  - ExplainReporter functionality tests
+  - Impact command integration tests
+- **969 total tests passing**: All existing tests continue to pass
+
+### Migration Notes
+- **No breaking changes**: All existing decision files work without modification
+- **Optional adoption**: New features can be adopted incrementally
+- **Forward compatible**: Decisions with `check` blocks validate successfully
+
+## [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
 

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 |