truthmark/changes/2026-06-21-version-2-2-5.md

Version 2.2.5

Previous version: 2.2.4 New version: 2.2.5 Diff basis: release/2.2.4..HEAD plus working tree Version action: patch SemVer rationale: This release is a backward-compatible patch that corrects generated workflow surfaces, validation/report examples, and generated-surface diagnostics without changing public CLI command shape.

Release payload:

• Move generated Cursor workflow support from large .cursor/rules files to native Cursor Agent Skill packages under .cursor/skills/truthmark-* with colocated support resources.
• Keep retired Gemini surfaces as manual-cleanup diagnostics while allowing truthmark init to auto-remove non-Gemini retired generated surfaces.
• Prevent Truth Sync reports and examples from treating provisional bootstrap-routing.md as a completed behavior-update target.
• Narrow Sync candidateStaleTruthDocs to signal-backed candidates instead of every indexed truth doc outside the impact set.

User-facing release text:

• Cursor installs now receive Truthmark workflows as Agent Skills under .cursor/skills/truthmark-*, while generated-surface checks and Sync validation avoid stale or over-broad workflow guidance.

Verification:

• npx vitest run tests/agents/instructions.test.ts tests/agents/prompts.test.ts tests/agents/truth-check.test.ts tests/agents/truth-document.test.ts tests/agents/truth-sync.test.ts tests/templates/generated-surfaces.test.ts passed.
• npx tsx src/cli/main.ts check --json passed with no diagnostics after regenerating surfaces.
• npm run release:check passed: lint, format, typecheck, 337 tests, build, package check, and audit.