v3.5.0 — DX Improvements from Dogfood Feedback

What's New

This release addresses all 7 issues from the NFTRemix dogfood feedback session (14 specs, B→A journey). The focus is on developer experience — better diagnostics, smarter parsing, and catching placeholder content that was silently inflating scores.

Added

• Stub/placeholder detection — sections containing only "TBD", "N/A", "TODO", "Coming soon", or similar placeholders are now flagged as warnings and no longer inflate quality scores (#162)
• Source-attributed export warnings — undocumented export warnings now show which source file the export comes from, making them actionable in large codebases (#165)
• Requirements companion validation — warns when specs contain inline requirements sections (should be in requirements.md) and when companion files are missing (#163)
• Score diagnostics — specsync score now shows per-category breakdowns (completeness, structure, cross-references) with actionable improvement suggestions (#167)

Fixed

• Header matching flexibility — fuzzy matching for common header variations like "Public API" → "Exports", "Tech Stack" → "Dependencies", reducing false negatives (#166)
• Frontmatter parser edge cases — correctly handles tabs, trailing whitespace, and inline YAML comments in spec frontmatter (#161)
• --fix header renaming — near-miss headers are now renamed in-place instead of duplicating the section (#164)

Stats

• 80 tests passing
• Zero clippy warnings
• All specs self-validate

Full Changelog: v3.4.1...v3.5.0

What's Changed

• fix: high-priority DX improvements from dogfood feedback by @corvid-agent in #168

Full Changelog: v3.4.1...v3.5.0