Skip to content

v0.7.0 Release Notes

Release Date: 2026-06-01

This release introduces spec-to-code drift detection, test generation from TPD, and new CLI commands for continuous spec alignment.

Highlights

  • Spec-to-code drift detection for identifying implementation divergence
  • Test generation from Test Plan Documents (TPD)
  • Generate, sync, and drift CLI commands for continuous spec alignment
  • Updated to structured-evaluation v0.6.0 with rubric package

What's New

Drift Detection

Detect divergence between specifications and implementation:

# Check for spec-to-code drift
visionspec drift

# Show detailed drift report
visionspec drift --verbose

# Output as JSON for CI integration
visionspec drift --format json

The drift detection engine analyzes:

  • Requirements coverage in code
  • API contracts vs implementation
  • Test coverage against TPD test cases
  • Documentation freshness

Test Generation

Generate test scaffolding from Test Plan Documents:

# Generate tests from TPD
visionspec generate tests

# Generate for specific test categories
visionspec generate tests --category unit
visionspec generate tests --category integration

Features:

  • Generates test stubs from TPD test cases
  • Supports Go, TypeScript, and Python targets
  • Maintains traceability to TPD requirements
  • Integrates with existing test frameworks

Sync Command

Bidirectional synchronization between specs and code:

# Sync spec changes to targets
visionspec sync

# Sync with specific target
visionspec sync --target speckit
visionspec sync --target gsd

ExecutionState Tracking

New ExecutionState type for tracking synchronization status:

type ExecutionState struct {
    LastSync      time.Time
    SyncStatus    SyncStatus  // pending, synced, diverged
    DriftScore    float64     // 0.0-1.0 divergence metric
    PendingChanges []Change
}

Changed

structured-evaluation v0.6.0

Updated to structured-evaluation v0.6.0 with the rubric package rename:

// Before (v0.5.0)
import "github.com/plexusone/structured-evaluation/evaluation"

// After (v0.6.0)
import "github.com/plexusone/structured-evaluation/rubric"

New evaluation capabilities:

  • Claims validation for source attribution
  • Render utilities for report formatting
  • Summary reports for aggregated results

Installation

go install github.com/ProductBuildersHQ/visionspec/cmd/visionspec@v0.7.0

Requirements

  • Go 1.26+
  • structured-evaluation v0.6.0