v4.0.0 β Full SDD Lifecycle
What's New
spec-sync 4.0.0 is the full Spec-Driven Development lifecycle release β covering authoring, validation, enforcement, and archival.
Breaking Changes
- All metadata moves into
.specsync/directory (config, registry, lifecycle, changes, archives) - Config converted from JSON β TOML (
.specsync/config.toml) lifecycle_logremoved from spec YAML frontmatter β extracted to.specsync/lifecycle/*.json- GitHub Action bumped from
@v3to@v4
New Features
specsync migrateβ automated 3.x β 4.0 migration (10 steps, dry-run support, idempotent)- Full lifecycle management β
specsync lifecyclesubcommands:status,promote,demote,set,history,guard,auto-promote,enforce - Lifecycle stages β draft β review β active β stable β deprecated β archived
- CI enforcement β
specsync lifecycle enforce --allvalidates lifecycle rules in CI - Change records β
.specsync/changes/tracks spec modifications over time - Spec archival β
.specsync/archive/for retired specs - Cross-project ref scanning β detects
depends_onrefs to external repos - Agent-agnostic AI config β provider/model settings with local overrides (
.specsync/ai-config.local.toml) - Spec file diff detection β PRs that modify spec files themselves are now caught
Migration
Run specsync migrate in any existing 3.x project. Supports --dry-run for preview. Creates a backup in .specsync/backup-3x/.
Full Changelog
What's Changed
- Create CODEOWNERS by @0xLeif in #200
- feat: full spec lifecycle + migrate command for v4.0.0 by @corvid-agent in #199
- fix(diff): detect when spec files themselves are modified in PRs by @corvid-agent in #204
- feat: agent-agnostic AI config with local overrides by @corvid-agent in #205
- chore: migrate spec-sync to v4.0.0 directory structure by @corvid-agent in #201
Full Changelog: v3.8.0...v4.0.0