v0.5.0
CKM Help System + Project Safety + Cooperative Hooks
CKM (Codebase Knowledge Manifest)
versionguard ckm— auto-derived topic index from forge-ts ckm.jsonversionguard ckm <topic>— human-readable docs (concepts, operations, config fields)versionguard ckm <topic> --json— machine-readable CKM data for LLM agentsversionguard ckm --llm— full API context (forge-ts llms.txt)- Reusable
src/ckm/module withcreateCkmEngine()— works with any CLI framework - Topics auto-derived from
*Configinterfaces (zero manual mapping)
Project Root Detection
- All commands detect project root by walking up for
.versionguard.yml,.git, or manifest files - Helpful error messages when run outside a project directory
Changelog Changesets Auto-Fixer
versionguard fix-changelog— restructures Changesets-mangled changelog into Keep a Changelog format- Converts section names, strips commit hashes, adds dates, updates compare links
- Also runs automatically during
versionguard fix
Cooperative Git Hooks
- Hooks append VG block with
# >>> versionguard >>>markers instead of overwriting - Husky, lefthook, pre-commit, and other hook tools preserved
- Re-running install is idempotent; uninstall removes only VG block
Init Idempotency
- Requires
--forceto overwrite existing config - Global CLI symlink resolution fixed
198 tests | Full Changelog: v0.4.0...v0.5.0