Matteo Rosati
30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# 15. Improve Command Registration So Parser and Dispatcher Cannot Drift
|
|
|
|
## Summary
|
|
|
|
Unify command parser metadata, handlers, aliases, and error mappings into one registry or add a startup check that prevents parser and dispatcher drift.
|
|
|
|
## Implementation Steps
|
|
|
|
- Create one command registry that includes command name, aliases, help text, arguments, handler, and expected error mappings.
|
|
- Build argparse subcommands from the registry.
|
|
- Dispatch commands through the same registry.
|
|
- Remove duplicated command declarations from separate parser and app structures.
|
|
- Add a small validation check that command names are unique and aliases do not collide.
|
|
|
|
## Public Interface Changes
|
|
|
|
- CLI command names, aliases, arguments, and help text should remain the same.
|
|
- Internal command registration becomes centralized.
|
|
|
|
## Test Plan
|
|
|
|
- Test that every registry command appears in parser help.
|
|
- Test every alias dispatches to the canonical command.
|
|
- Test duplicate command or alias validation fails fast.
|
|
- Smoke test all existing commands through parser and dispatcher.
|
|
|
|
## Assumptions
|
|
|
|
- A unified registry is preferred over only adding a drift-detection test because the current repo already has structured command metadata.
|