@ipation/specbridge 1.2.1 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +56 -0
- package/dist/cli.js +704 -209
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +146 -13
- package/dist/index.js +153 -42
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,62 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [1.3.0] - 2026-02-03
|
|
11
|
+
|
|
12
|
+
### Phase 5: Foundational Trust & Propagation (v1.3 - Non-Breaking)
|
|
13
|
+
|
|
14
|
+
### Added
|
|
15
|
+
|
|
16
|
+
#### Structured Constraints
|
|
17
|
+
- **Machine-readable constraint specification**: New optional `check` block in constraints with `verifier` and `params` fields
|
|
18
|
+
- **Backward compatibility**: Legacy `verifier` field continues to work; `check` block takes priority when present
|
|
19
|
+
- **Type-safe parameters**: Structured parameters passed to verifiers, validated by Zod schema
|
|
20
|
+
- **Better verifier selection**: Three-tier priority system - check.verifier → verifier field → auto-detection
|
|
21
|
+
|
|
22
|
+
#### Verification Debuggability
|
|
23
|
+
- **--explain mode**: New `specbridge verify --explain` flag shows detailed verification trace
|
|
24
|
+
- **Constraint application tracking**: See which constraints applied/skipped for each file and why
|
|
25
|
+
- **Verifier selection visibility**: Shows which verifier was selected and why
|
|
26
|
+
- **Execution metrics**: Displays violation count and execution time per constraint
|
|
27
|
+
- **Error transparency**: Failed verifications show full error details in explanation
|
|
28
|
+
|
|
29
|
+
#### Stop Silent Failures
|
|
30
|
+
- **Warning system**: Missing verifiers now log warnings with available alternatives
|
|
31
|
+
- **Error reporting**: Verifier exceptions logged with full stack traces
|
|
32
|
+
- **Structured diagnostics**: `VerificationResult` includes `warnings` and `errors` arrays
|
|
33
|
+
- **CLI output**: Warnings and errors displayed before summary with proper formatting
|
|
34
|
+
- **Non-blocking errors**: Verification continues after errors instead of silently stopping
|
|
35
|
+
|
|
36
|
+
#### Propagation Exposure
|
|
37
|
+
- **Impact analysis command**: New `specbridge impact <decision-id>` command
|
|
38
|
+
- **Change type support**: Analyze created, modified, or deprecated decisions
|
|
39
|
+
- **Affected files tracking**: Shows all files impacted with violation counts
|
|
40
|
+
- **Auto-fix detection**: Identifies which violations can be automatically fixed
|
|
41
|
+
- **Migration planning**: Generated step-by-step migration plans (automated vs manual)
|
|
42
|
+
- **Effort estimation**: Calculates low/medium/high effort based on violation complexity
|
|
43
|
+
- **JSON output**: Machine-readable format via `--json` flag
|
|
44
|
+
|
|
45
|
+
### Changed
|
|
46
|
+
- **VerificationResult interface**: Added optional `warnings` and `errors` fields
|
|
47
|
+
- **VerificationEngine**: Enhanced error handling with detailed logging
|
|
48
|
+
- **Verifier selection**: Updated priority system to support structured check blocks
|
|
49
|
+
|
|
50
|
+
### Documentation
|
|
51
|
+
- **Decision format**: Updated with new `check` block format examples
|
|
52
|
+
- **CLI help**: Enhanced with new --explain option documentation
|
|
53
|
+
|
|
54
|
+
### Tests
|
|
55
|
+
- **18 new tests**: Added comprehensive test coverage for v1.3 features
|
|
56
|
+
- ConstraintCheckSchema validation tests
|
|
57
|
+
- ExplainReporter functionality tests
|
|
58
|
+
- Impact command integration tests
|
|
59
|
+
- **969 total tests passing**: All existing tests continue to pass
|
|
60
|
+
|
|
61
|
+
### Migration Notes
|
|
62
|
+
- **No breaking changes**: All existing decision files work without modification
|
|
63
|
+
- **Optional adoption**: New features can be adopted incrementally
|
|
64
|
+
- **Forward compatible**: Decisions with `check` blocks validate successfully
|
|
65
|
+
|
|
10
66
|
## [1.2.1] - 2026-02-03
|
|
11
67
|
|
|
12
68
|
### Fixed
|