Skip to content

v4.0.0 β€” Full SDD Lifecycle

Choose a tag to compare

@corvid-agent corvid-agent released this 11 Apr 19:56
· 390 commits to main since this release
68829c5

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_log removed from spec YAML frontmatter β€” extracted to .specsync/lifecycle/*.json
  • GitHub Action bumped from @v3 to @v4

New Features

  • specsync migrate β€” automated 3.x β†’ 4.0 migration (10 steps, dry-run support, idempotent)
  • Full lifecycle management β€” specsync lifecycle subcommands: status, promote, demote, set, history, guard, auto-promote, enforce
  • Lifecycle stages β€” draft β†’ review β†’ active β†’ stable β†’ deprecated β†’ archived
  • CI enforcement β€” specsync lifecycle enforce --all validates 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_on refs 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

v3.8.0...v4.0.0

What's Changed

Full Changelog: v3.8.0...v4.0.0