mirror of
https://github.com/Fission-AI/OpenSpec.git
synced 2026-09-14 20:16:53 +08:00
Tabish Bidiwale
4ab65d75dd
- Update openspec-conventions spec with delta-based approach - Add Header-Based Requirement Identification for programmatic matching - Define ADDED/MODIFIED/REMOVED/RENAMED sections format - Document standard output symbols (+ ~ - →) - Update openspec/README.md with delta conventions and examples - Update init command template to use delta format - Mark completed tasks in adopt-delta-based-changes/tasks.md This implements the first part of the delta-based changes proposal, updating all documentation and conventions to support the new format.
39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
# Implementation Tasks
|
|
|
|
## 1. Update Conventions
|
|
- [x] 1.1 Update openspec-conventions spec with delta-based approach
|
|
- [x] 1.2 Add Header-Based Requirement Identification
|
|
- [x] 1.3 Define ADDED/MODIFIED/REMOVED/RENAMED sections
|
|
- [x] 1.4 Document standard output symbols (+ ~ - →)
|
|
- [x] 1.5 Update openspec/README.md with delta-based conventions
|
|
- [x] 1.6 Update examples to use delta format
|
|
|
|
## 2. Update Diff Command
|
|
- [ ] 2.1 Update cli-diff spec with requirement-level comparison
|
|
- [ ] 2.2 Parse specs into requirement-level structures
|
|
- [ ] 2.3 Apply deltas to generate future state
|
|
- [ ] 2.4 Implement side-by-side comparison view (changes only)
|
|
- [ ] 2.5 Add tests for requirement-level comparison
|
|
- [ ] 2.6 Add tests for side-by-side view formatting
|
|
|
|
## 3. Update Archive Command
|
|
- [ ] 3.1 Update cli-archive spec with delta processing behavior
|
|
- [ ] 3.2 Implement normalized header matching (trim whitespace)
|
|
- [ ] 3.3 Parse delta sections (ADDED/MODIFIED/REMOVED/RENAMED)
|
|
- [ ] 3.4 Apply changes in order: RENAMED → REMOVED → MODIFIED → ADDED
|
|
- [ ] 3.5 Validate delta operations:
|
|
- [ ] 3.5.1 MODIFIED/REMOVED requirements exist
|
|
- [ ] 3.5.2 ADDED requirements don't already exist
|
|
- [ ] 3.5.3 RENAMED FROM headers exist, TO headers don't
|
|
- [ ] 3.5.4 No duplicate headers within specs
|
|
- [ ] 3.5.5 Renamed requirements aren't also in ADDED
|
|
- [ ] 3.6 Display operation counts (+ 2 added, ~ 3 modified, etc.)
|
|
- [ ] 3.7 Add tests for header normalization
|
|
- [ ] 3.8 Add tests for applying deltas in correct order
|
|
- [ ] 3.9 Add tests for validation edge cases
|
|
|
|
## Notes
|
|
- Archive command is critical path - must work reliably
|
|
- All new changes must use delta format
|
|
- Header normalization: normalize(header) = trim(header)
|
|
- Diff command shows only changed requirements in side-by-side comparison |