From 0e51dab6cd5d6d38634e6eeea07740eb4d640189 Mon Sep 17 00:00:00 2001 From: Jeffrey Phillips Freeman Date: Sat, 1 Nov 2025 19:39:10 -0400 Subject: [PATCH] Added some content for the plan --- implementation_plan.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/implementation_plan.md b/implementation_plan.md index e7f9f00fee8..3386fe7bdeb 100644 --- a/implementation_plan.md +++ b/implementation_plan.md @@ -68,9 +68,10 @@ The migration roadmap mirrors the legacy functionality while defining Python-cen #### Phase 0 Notes Notes: Populate with discoveries, tooling choices, scripts created, and emerging tasks. -- 2025-11-01: Ported boilerplate foundation to CleverAgents baseline. Repository metadata updated in README.md:1-50, pyproject.toml:1-91, mkdocs.yml:1-33, and docs/index.md:1-35. CLI entry points implemented in src/cleveragents/cli.py:1-41 with `cleveragents` / `agents` console scripts declared in pyproject.toml:46-48 and module entry point wired via src/cleveragents/__main__.py:1-14. Help/version behavior now validated by Behave features/example.feature:1-9 with steps in features/steps/example_steps.py:1-43. benchmarks/simple_benchmark.py:1-17 measures CLI latency. Outstanding follow-ups: +- 2025-11-01: Ported boilerplate foundation to CleverAgents baseline. Repository metadata updated in README.md:1-50, pyproject.toml:1-91, mkdocs.yml:1-33, and docs/index.md:1-35. CLI entry points implemented in src/cleveragents/cli.py:1-62 with `cleveragents` / `agents` console scripts declared in pyproject.toml:46-48 and module entry point wired via src/cleveragents/__main__.py:1-14. Help/version behavior now validated by Behave features/cli.feature:1-9 with steps in features/steps/cli_steps.py:1-43. benchmarks/cli_benchmark.py:1-33 measures CLI latency and should be kept in sync with new command ergonomics. Outstanding follow-ups: - Build structured CLI inventory extractors per Phase 0 Code checklist once discovery tooling is ready. - - Expand Robot suites beyond robot/placeholder.robot after additional CLI commands land. + - Expand Robot suites beyond robot/cli.robot once additional CLI commands land. + - Add Behave coverage for the new `agents diagnostics` and `agents info` commands to keep parity with Go equivalents. --- @@ -219,10 +220,11 @@ Each phase item includes mandatory **Code**, **Document**, and **Tests** bullets - [x] Replace placeholder source, benchmark, and unit test files with real CLI `--help` and `--version` implementations plus their unit tests and benchmarks. - [x] Update documentation references (README, contribution guides, docs) to use CleverAgents naming and CLI commands. - [x] Record outstanding branding or scaffolding follow-ups discovered during the port in Phase 0 Notes and add new checklist items in appropriate phases. - - [ ] Replace placeholder test in `robot/cli.robot` with an actual benchmark that full tests the CLI and remove the "hello world" example that is there. + - [ ] Replace placeholder test in `robot/cli.robot` with an actual benchmark that fully tests the CLI and remove the "hello world" example that is there. - [ ] Ensure `nox -e coverage_report` fails with an error code when run if code coverage is reported below 85%, but passes when above 85%. - - [ ] Bring unit test code coverage above 85% + - [ ] Bring unit test code coverage above 85% while maintaining CLI parity scenarios. - [ ] Once code coverage is above 85% ensure `nox -e coverage_report` now passes as expected, if it does not fix it so it passes. + - [ ] Backfill unit tests for `diagnostics` and `info` commands with corresponding Behave hooks to keep coverage stable. - [ ] Build CLI inventory extractors for `plandex/app/cli/cmd` and supporting packages (`plan_exec`, `stream_tui`, `term`, `lib`). - [ ] Parse command metadata from `root.go` and subcommand files, capturing names, aliases, flags, defaults, help text, confirmation prompts, and mutually exclusive flag groups. - [ ] Emit the inventory as structured data (YAML/JSON) saved under `docs/reference/cli_inventory.` with schema documentation checked into repo.