Cli/breaking flag cleanup#167
Merged
simongdavies merged 3 commits intoMay 21, 2026
Merged
Conversation
… fix verbose tool-output gate BREAKING CHANGE: --show-reasoning / HYPERAGENT_SHOW_REASONING removed. Use --reasoning-effort / HYPERAGENT_REASONING_EFFORT instead. Same accepted levels (low / medium / high / xhigh, default 'high' when the flag is given without a value), same wiring into the Copilot SDK session -- the old name is gone with no silent fallback. Added: - --very-verbose / -vv / HYPERAGENT_VERY_VERBOSE: extends --verbose so the full result body prints for *every* tool (audit progress, plugin enable/disable, module registration, intent reports, handler registration, etc.), not just sandbox tools. Plain --verbose keeps the leaner default (sandbox tool bodies only; one-line ✅ Done for everything else). - --base-dir <path> / HYPERAGENT_BASE_DIR: auto-enables both the fs-read and fs-write plugins at startup with the supplied directory as their baseDir. Directory is created if missing; symlinks are still rejected. Independent of --auto-approve. Fixed: - --verbose was silently dropping non-sandbox tool result bodies. The event handler returned early for anything other than execute_javascript / execute_bash, so plugin_info, module_info, report_intent, register_handler, etc. always rendered as a terse ✅ Done even in verbose mode. The early-return is gone; --verbose now prints sandbox tool bodies and --very-verbose prints every tool body. Tests: new tests/cli-parser.test.ts covers all new flags plus rejection of the removed --show-reasoning. just check is green (45 files, 2491 tests pass). Signed-off-by: Simon Davies <simongdavies@users.noreply.github.com>
…se-dir, fix verbose tool-output gate Signed-off-by: Simon Davies <simongdavies@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates HyperAgent’s CLI and runtime output behavior by replacing the removed --show-reasoning flag with --reasoning-effort, adding a stricter multi-level verbosity mode (--very-verbose / -vv), and introducing --base-dir to auto-configure and enable the fs-read/fs-write plugins at startup.
Changes:
- Replaced
--show-reasoning/HYPERAGENT_SHOW_REASONINGwith--reasoning-effort/HYPERAGENT_REASONING_EFFORT, including tests and documentation updates. - Added
--very-verbose(-vv) and implemented tool-result body gating so--verboseshows sandbox tool bodies while--very-verboseshows bodies for all tools. - Added
--base-dir/HYPERAGENT_BASE_DIRto auto-audit/approve/configure/enablefs-readandfs-writeat startup, plus CLI parser tests and docs/changelog entries.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| tests/cli-parser.test.ts | Adds unit coverage for the new/removed CLI flags and env vars. |
| src/agent/state.ts | Introduces veryVerboseOutput in agent state wired from CLI config. |
| src/agent/index.ts | Sets new verbosity env var and applies --base-dir to fs plugins at startup; updates reasoning-effort wiring. |
| src/agent/event-handler.ts | Implements verbose vs very-verbose gating for tool result bodies (sandbox-only vs all tools). |
| src/agent/commands.ts | Updates /reasoning help text to reference --reasoning-effort. |
| src/agent/cli-parser.ts | Renames/extends CLI config (reasoningEffort, veryVerbose, baseDir) and updates usage text + env var handling. |
| docs/USAGE.md | Updates CLI and env var reference docs for the new flags and breaking change. |
| CHANGELOG.md | Documents breaking removal of --show-reasoning and adds notes for --very-verbose and --base-dir. |
…se-dir, fix verbose tool-output gate Signed-off-by: Simon Davies <simongdavies@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces several new CLI features, environment variables, and important breaking changes to HyperAgent's configuration and output modes. The main highlights are the replacement of the misnamed
--show-reasoningflag, the addition of--very-verbosefor more detailed output, and a new--base-dirflag that auto-enables and configures thefs-readandfs-writeplugins. Documentation and internal state handling are updated accordingly.Breaking changes:
--show-reasoning/HYPERAGENT_SHOW_REASONINGflag; use--reasoning-effort/HYPERAGENT_REASONING_EFFORTinstead. The new flag has the same accepted levels and no fallback to the old name.New features:
--very-verbose/-vv/HYPERAGENT_VERY_VERBOSEflag to print full result bodies for all tools, not just sandbox tools. This extends the output detail beyond what--verboseprovides.--base-dir <path>/HYPERAGENT_BASE_DIRto auto-enable and configure thefs-readandfs-writeplugins with the specified directory, which is created if missing and rejects symlinks. This is independent of--auto-approve.Output and event handling improvements:
--verboseso that it now prints sandbox tool bodies, and--very-verboseprints every tool body (previously, non-sandbox tools always rendered as a terse✅ Doneeven in verbose mode).--verboseby--very-verbose.Documentation updates:
CHANGELOG.mdanddocs/USAGE.mdto reflect the new flags, environment variables, and removed options.