This release improves contract comparison, Git baseline validation, and structural drift detection.
The compare command now detects deeper architectural changes across components, APIs, props, state, and variables.
➕ Added
Git Baseline Comparison
Compare your current project against any Git reference:
stamp context compare --baseline git:main
stamp context compare --baseline git:HEAD
stamp context compare --baseline git:v1.0.0LogicStamp automatically:
- Creates isolated git worktrees
- Generates context for both versions
- Performs a structural contract comparison
Useful for CI validation, PR reviews, and release checks.
Deeper Contract Comparison
Compare mode now detects additional contract changes:
- API signatures (parameters and return types)
- Component state variables
- Module variables
- Prop and emit type changes
Example:
~ propName: "string" → "number"This ensures contract comparisons detect breaking type changes, not just added or removed fields.
🔁 Changed
Improved Drift Detection
New components and folders are now treated as growth, not drift.
Only the following trigger DRIFT:
- removed contracts
- modified contracts
This prevents false drift warnings when projects expand.
More Stable Comparisons
Contract comparison now includes improved normalization:
- filtered invalid identifiers
- normalized object structures
- consistent ordering for stable comparisons
These changes improve reliability and reduce false positives.
🧪 Tests
Significant testing improvements were added:
- Expanded unit tests for compare command behavior
- Stabilized file lock tests (fixed race conditions)
- Added E2E tests for git baseline comparisons
The E2E suite validates:
- branches
- tags
- commit hashes
- cleanup of temporary worktrees
- invalid reference handling
🔗 Related PRs
- #134 – Stabilized file lock tests
- #135 – Git baseline comparison
- #136 – State and module variable comparison
- #137 – Git ignore handling and safer git execution
- #138 – Expanded compare command test coverage
- #139 – Git ref validation and timeout handling
- #140 – Backend API signature comparison
- #141 – Deterministic hashing fixes and drift classification improvements
- #142 – Prop and emit type change detection
- #143 – Git baseline E2E tests