@ipation/specbridge 1.2.1 → 2.0.0

package/CHANGELOG.md

@@ -7,6 +7,62 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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

package/README.md

@@ -20,6 +20,16 @@ SpecBridge creates a living integration layer between design intent and implemen
 - **Interactive Dashboard** - Real-time compliance monitoring with visual charts
 - **Agent Interface** - Exposes decisions to code generation agents (Copilot, Claude, etc.)
 
+### New in v2.0 ✨
+
+- 🔌 **Plugin System** - Create custom verifiers without modifying core code ([Guide](./docs/PLUGIN-DEVELOPMENT.md))
+- ⚖️ **Severity-Weighted Compliance** - Scores that properly reflect violation criticality
+- ⚡ **Performance Boost** - 30% faster verification with instance pooling and caching
+- 📊 **Sub-1s Dashboard** - In-memory caching for instant report loading
+- 🔄 **Migration Tool** - Automated v1 → v2 migration with comparison reports
+
+[📖 See full changelog](./CHANGELOG-v2.0.md) | [🔧 Migration Guide](./docs/MIGRATION-V2.md)
+
 ## Installation
 
 ```bash
@@ -116,6 +126,25 @@ Get AI-generated insights about compliance trends, violations, and decision impa
 specbridge dashboard
 ```
 
+Visit `http://localhost:3000` to see real-time compliance metrics, trend charts, and decision details.
+
+### 8. Create custom verifiers (v2.0+)
+
+```bash
+# Copy plugin template
+cp templates/verifiers/example-custom.ts .specbridge/verifiers/my-verifier.ts
+
+# Edit and customize
+# Then use in decisions:
+# check:
+#   verifier: my-verifier
+
+# Verify
+specbridge verify
+```
+
+See the [Plugin Development Guide](./docs/PLUGIN-DEVELOPMENT.md) for detailed instructions.
+
 Open your browser to view real-time compliance metrics, trend charts, and insights.
 
 ### 8. Integrate with AI agents