CLI Core Feature Tracking
July 14, 2026 ยท View on GitHub
Current Status
The standard-library CLI provides initialization, feature creation, validation, and adapter installation. Automated behavioral coverage now protects init, add, and validate.
Source Of Truth
- Implementation: feature_track.py
- Specification: feature-track-spec.md
- Test design: CLI core command tests design
- Implementation plan: CLI core command tests plan
Current Behavior
initcreates a feature index without overwriting existing content.addcreates a feature track, standard subdirectories, and an index row.validatechecks feature structure, required sections, index membership, and local links.- Validation accepts documented English headings and supported Chinese heading aliases.
- Pytest coverage exercises command functions and selected CLI exit-code and output contracts in isolated temporary projects.
Decisions
- Keep the CLI runtime dependency-free.
- Use pytest only as a development dependency for isolated filesystem and CLI-contract tests.
- Preserve Chinese heading aliases as intentional compatibility behavior.
Known Risks
- Validator logic is duplicated in distributable skill and plugin directories; synchronization coverage is deferred to a later increment.
- The install commands remain outside this first automated test increment and still need dedicated coverage.
Changelog
- 2026-07-14: Defined automated coverage for the
init,add, andvalidatecommands. - 2026-07-14: Added automated behavioral coverage for the
init,add, andvalidatecommands.