v1.12.0 - Findings Reports, SourceCraft

What's New in v1.12.0

OpenSpec v1.12.0 adds focused validation reports and SourceCraft support, while making planning, initialization, installation, and documentation more reliable.

New

• Findings-only validation reports - Use openspec validate --report findings with explicit bulk scopes to show only errors, warnings, and informational findings while preserving full-run totals and exit codes.
• SourceCraft Code Assistant support - Generate OpenSpec project skills and commands for the SourceCraft VS Code extension.

Improved

• Code-grounded planning - Propose and fast-forward workflows now inspect relevant code, tests, and documentation before drafting artifacts.
• Focused exploration - Explore mode asks dependency-aware questions, recommends defaults, and checks the repository before asking users for facts already present in the codebase.
• Initialization reliability - Empty OpenSpec directories remain tracked in Git, and rerunning init safely restores missing markers.
• Consistent restart guidance - Init and update now share accurate IDE restart hints, including when workflows are removed.
• Documentation - Expanded archive, PowerShell completion, community showcase, spec behavior, analytics routing, and store-link guidance.

Fixed

• Delta validation - Merge conflicts appear as informational findings without changing exit codes, filesystem read errors remain distinct from missing specs, and advisory preflight failures preserve the validation report.
• Git installations - npm Git installs prepare correctly without requiring pnpm on the user's machine.
• Node.js 20 compatibility - Chalk remains on a Node.js 20-compatible version.
• Dependency security - Patched fast-uri advisories and refreshed website dependencies.

New Contributors

• @jasonsawthis made their first contribution in #1757
• @aleksandr4842 made their first contribution in #1171
• @pformoso-deus-ai made their first contribution in #792
• @DanRioDev made their first contribution in #1017
• @aron-intframe made their first contribution in #1725
• @Br1an67 made their first contribution in #786

Full Changelog: v1.11.0...v1.12.0