v0.10.0 Release Notes

Release Date: 2026-06-13

This release introduces post-ship alignment checking, comprehensive cross-project analysis tools, and execution integration features. It completes all remaining ROADMAP items for Phase 8 (Advanced Features) and Phase 14 (Execution Integration).

Highlights

• Post-ship alignment checking with spec-to-reality comparison
• OpenSpec portable JSON/YAML export format for cross-tool compatibility
• Git hooks for automated spec validation (pre-commit, pre-push)
• Full-text search, pattern detection, and requirement reuse tracking
• Evaluation metrics dashboard with quality trends and conflict analysis
• MCP execution tracking tools and guided implementation prompts

What's New

Post-Ship Alignment

After shipping a feature, use visionspec align to compare spec.md against actual implementation:

# Check alignment with optional context
visionspec align -p myproject --with-context

# Generate current-truth.md showing actual state
visionspec align -p myproject --generate-truth

# Track resolution of discrepancies
visionspec align resolve -p myproject --id disc-001 --action "Updated docs"

Discrepancy types detected:

• missing_feature - Spec requirement not implemented
• undocumented_code - Code exists without spec coverage
• diverged - Implementation differs from spec
• partial_implementation - Partially implemented
• behavior_mismatch - Behavior differs from specified

OpenSpec Export

Export specifications to a portable JSON/YAML format for cross-tool compatibility:

# Export to OpenSpec JSON
visionspec export openspec -p myproject

# Export to YAML variant
visionspec export openspec -p myproject --format yaml

The OpenSpec format includes metadata, sections, requirements, tasks, acceptance criteria, and dependency graphs.

Git Hooks

Automate spec validation with Git hooks:

# Install all hooks
visionspec hooks install

# Install specific hooks
visionspec hooks install --hooks pre-commit,pre-push

# Check status
visionspec hooks status

# Uninstall
visionspec hooks uninstall

Available hooks:

Hook	Purpose
pre-commit	Lint changed spec files
pre-push	Validate all specs before push
commit-msg	Validate commit message format
post-commit	Update spec status after commit

Cross-Project Analysis

New commands for analyzing specs across multiple projects:

# Full-text search across all specs
visionspec search "authentication" --projects auth,user

# Find similar/duplicate requirements
visionspec reuse

# Detect patterns and anti-patterns
visionspec patterns

Evaluation Metrics Dashboard

Track spec quality over time:

# Terminal dashboard
visionspec metrics

# HTML report
visionspec metrics --format html > metrics.html

# JSON for programmatic access
visionspec metrics --format json

Metrics tracked:

• Spec quality trends over time
• Common failure patterns
• Conflict frequency
• Resolution time
• Reconciliation metrics

MCP Execution Integration

New MCP tools for AI-assisted implementation:

Tool	Description
get_execution_status	Track requirement implementation progress
track_requirement	Update requirement status with evidence
align_spec	Run alignment checking
get_alignment_status	Get current alignment status
track_resolution	Track discrepancy resolution
get_metrics	Get evaluation metrics
install_hooks	Install git hooks
get_hooks_status	Get hooks status

New MCP prompts for guided workflows:

Prompt	Purpose
implement_requirement	Guide requirement implementation
verify_acceptance	Guide acceptance criteria verification
resolve_drift	Guide drift resolution workflow

Rich Status Output

The status command now shows pipeline visualization by default:

visionspec status -p myproject

# Output:
# Pipeline: MRD ✅ → PRD ✅ → UXD ✅ → TRD ✅ → spec.md ✅
#
# ┌──────────┬──────┬─────────┬──────┐
# │ Category │ Pass │ Partial │ Fail │
# ├──────────┼──────┼─────────┼──────┤
# │ Source   │ 3    │ 0       │ 0    │
# │ GTM      │ 2    │ 0       │ 0    │
# │ Technical│ 2    │ 0       │ 0    │
# └──────────┴──────┴─────────┴──────┘

Use --basic for simplified output.

New Packages

Package	Description
pkg/align	Post-ship alignment checking
pkg/decisions	Decision log and rationale graphs
pkg/deps	Cross-project dependency analysis
pkg/hooks	Git hooks management
pkg/metrics	Evaluation metrics dashboard
pkg/patterns	Pattern and anti-pattern detection
pkg/reuse	Requirement reuse tracking
pkg/roadmap	ROADMAP.md generation
pkg/search	Full-text search
pkg/testmap	Test coverage mapping

CLI Changes

New Commands

Command	Description
align	Check spec-to-reality alignment
metrics	View evaluation metrics dashboard
hooks install	Install git hooks
hooks uninstall	Remove git hooks
hooks status	Check hooks status
search <query>	Full-text search across specs
reuse	Analyze requirement reuse opportunities
patterns	Detect patterns and anti-patterns

New Flags

Flag	Command	Description
--with-context	align, drift	Include codebase context
--context-file	align, drift	Load context from file
--generate-truth	align	Generate current-truth.md
--format	search, reuse, patterns, metrics	Output format (json/terminal/html)
--hooks	hooks install	Specific hooks to install
--basic	status	Use simplified output

New Export Targets

Target	Description
openspec	Portable JSON/YAML format
github	GitHub Issues with milestones
jira	Jira epics/stories

Bug Fixes

• Windows compatibility: Git hooks now use oscompat.IsExecutable for cross-platform executable detection
• Security: Fixed gosec G306 by using 0o600 permissions for sensitive files
• Integer overflow: Fixed G115 in pairKey function using strconv.Itoa

Dependencies

• Update oscompat to v0.4.0 for cross-platform executable detection

Installation

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

Requirements

• Go 1.22+
• structured-evaluation v0.6.0

Links

• Documentation
• GitHub Repository
• Changelog