v1.3.4

Fixed

• Deterministic Processing: Fixed a critical bug that caused line numbers in the table of contents to change on every run. This was due to inconsistent newline handling after removing an existing agent docstring. The process is now fully idempotent.
• Robust Docstring Removal: Improved the detection logic to correctly find and remove all agent-generated docstrings, even when located in the middle of a file or when multiple (erroneous) docstrings were present. This prevents docstring duplication on repeated runs.
• Manual Docstring Preservation: Ensured that manual docstrings are no longer reformatted or modified unless they are being merged with an agent-generated table of contents.
• Version-Only Change Skipping: Fixed a bug where files were being unnecessarily modified when only the version number in the auto-generated header differed, while the actual content structure remained unchanged. The tool now performs normalized content comparison that ignores version differences, preventing unnecessary file modifications after Agent Docstrings version updates.

Documentation

• Contribution Guide: Added a new CONTRIBUTING.md file with detailed guidelines for development workflow and the release process.
• README Update: Updated README.md to link to the new contribution guide and reflect the automated release process.

CI/CD

• Release Automation: Added a new release-automation.yml workflow that automatically creates Git tags, GitHub Releases, and back-merge PRs when release branches are merged to master.
• CI Optimization: Optimized the main CI pipeline by removing redundant test runs on master branch pushes and adding caching for pip dependencies and Go modules to speed up workflow execution.
• Workflow Efficiency: Changed CI triggers to run on pushes to dev instead of master, eliminating duplicate test runs while maintaining comprehensive coverage.
• Version Check Precision: Improved the version bump detection in CI to specifically check version changes in pyproject.toml and agent_docstrings/__init__.py, preventing false positives from other file modifications.