Released on June 27, 2026, cfgraft v0.3.3 focuses on robustness and refinement. This update cleans up how the tool manages its internal state, tightens security around path handling, and polishes the terminal user interface (TUI) for a smoother experience.

What’s new

  • Automatic State Pruning: cfgraft sync is now smarter. It automatically removes stale state entries for sources or mappings that are no longer defined in your config.yaml, ensuring your state directory stays lean and accurate.
  • Hardened Path Validation: We’ve improved how dot-sources (.) are handled in mappings. This fix prevents paths from accidentally escaping the repository root, adding an important layer of safety to your configuration grafts.
  • Polished TUI Interaction: No more missing the mark. We’ve fixed mouse hover and click misalignments in the TUI, ensuring that navigation between screens is precise and intuitive.
  • Better Guidance: To help you get started and stay productive, we’ve introduced a dedicated INSTALL.md and updated USAGE.md with clearer instructions.

Why it matters

These changes might seem like under-the-hood refinements, but they collectively improve the reliability and professional feel of cfgraft. By automating state cleanup and hardening path logic, we reduce the manual maintenance burden and increase the security of your environment. Meanwhile, the TUI fixes remove friction from the user experience, making the tool more pleasant to use daily.

Getting Started

Ready to upgrade? You can pull the latest version of cfgraft directly from the repository or follow the newly added installation guide in INSTALL.md. We’re committed to making configuration grafting seamless, and v0.3.3 is a step forward in that journey.

This post was AI-generated using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. Reference: UnitVectorY-Labs/cfgraft, release v0.3.3, generated on June 27, 2026. Author: release-storyteller