coulomb/kaizen-agentic
Archived
2
0
Fork 0
Code Issues 4 Pull Requests Actions Projects Releases Wiki Activity

Release v1.0.1: Fix CLI error messages and improve user experience

Browse Source 
### Key Fixes
- Resolve spurious "Got unexpected extra argument" error messages in Click library
- Fix malformed YAML frontmatter in agent definition files
- Enhance global installation capability with improved make install-global

### Technical Implementation
- Add intelligent CLI error handling with safe_cli_wrapper() function
- Implement comprehensive test suite for error suppression (11 test cases)
- Create detailed documentation and future maintenance guide
- Update entry point to provide clean user experience

### Files Added
- tests/test_cli_error_handling.py - Comprehensive test coverage
- CLICK_WORKAROUND.md - Technical documentation and removal timeline

### Files Modified
- pyproject.toml - Version bump to 1.0.1 and entry point update
- CHANGELOG.md - Detailed release notes for v1.0.1
- README.md - Added known issues section
- src/kaizen_agentic/cli.py - Click error handling implementation
- Multiple agent files - Fixed YAML frontmatter formatting

Resolves: Issue #3 - CLI argument parsing errors and user confusion

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Bernd Worsch
2025-10-20 07:05:32 +02:00
parent b257b3c906
commit 803f032818
10 changed files with 564 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
CHANGELOG.md
View File

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [1.0.1] - 2025-10-20
### Fixed
- **CLI Error Message Suppression**: Resolved spurious "Got unexpected extra argument" error messages in Click library that were confusing users during `kaizen-agentic install` commands
- **YAML Frontmatter Issues**: Fixed malformed YAML frontmatter in agent definition files (`agent-wisdom-encouragement.md`, `agent-tooling-optimization.md`, `agent-test-maintenance.md`)
- **Global Installation Access**: Enhanced global installation capability with improved `make install-global` target using pipx for system-wide CLI availability
### Added
- **Click Library Workaround**: Implemented intelligent error handling with `safe_cli_wrapper()` function to provide clean user experience
- **Comprehensive Test Suite**: Added `tests/test_cli_error_handling.py` with 11 test cases covering CLI error suppression, legitimate error preservation, and integration scenarios
- **Detailed Documentation**: Created `CLICK_WORKAROUND.md` with technical details and removal timeline for the Click library workaround
- **Future Maintenance Guide**: Added clear instructions for testing and removing the workaround when Click library is updated
### Technical Details
- **Entry Point**: Updated CLI entry point to use `safe_cli_wrapper` instead of direct CLI function
- **Error Detection**: Intelligent detection and filtering of spurious Click error messages while preserving legitimate errors
- **Test Coverage**: Full test coverage for workaround functionality including removal readiness testing
- **Code Documentation**: Comprehensive inline documentation for future maintainers
**Resolves**: Issue #3 - CLI argument parsing errors and confusing error messages
## [1.0.0] - 2025-10-19
### Added
@@ -122,6 +143,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Project assistant agent for status and progress management
- Repository assistant agent for structure management and refactoring
[Unreleased]: https://github.com/kaizen-agentic/kaizen-agentic/compare/v1.0.0...HEAD
[Unreleased]: https://github.com/kaizen-agentic/kaizen-agentic/compare/v1.0.1...HEAD
[1.0.1]: https://github.com/kaizen-agentic/kaizen-agentic/compare/v1.0.0...v1.0.1
[1.0.0]: https://github.com/kaizen-agentic/kaizen-agentic/compare/v0.1.0...v1.0.0
[0.1.0]: https://github.com/kaizen-agentic/kaizen-agentic/releases/tag/v0.1.0