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.
1.8 KiB
1.8 KiB
Implementation Tasks
1. Update Conventions
- 1.1 Update openspec-conventions spec with delta-based approach
- 1.2 Add Header-Based Requirement Identification
- 1.3 Define ADDED/MODIFIED/REMOVED/RENAMED sections
- 1.4 Document standard output symbols (+ ~ - →)
- 1.5 Update openspec/README.md with delta-based conventions
- 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