@brokkai/bug-bot 0.1.0 → 0.2.0

package/README.md

@@ -44,11 +44,13 @@ From a source checkout:
 ```sh
 make build
 ./bin/bbb /path/to/your-repo
+./bin/bbb /path/to/your-repo --plain
 ./bin/bbb once /path/to/your-repo --dry-run
 ./bin/bbb once /path/to/your-repo --focus "parser and input validation"
 ./bin/bbb /path/to/your-repo --max-issues 2 --label bug
 ./bin/bbb /path/to/your-repo --model YOUR_MODEL_ID --effort low
 ./bin/bbb status /path/to/your-repo
+./bin/bbb version
 ./bin/bbb retry /path/to/your-repo --once
 ```
 
@@ -57,6 +59,8 @@ Source builds require Go 1.27.1. To install the local source as `bbb`, run
 Running `bbb` from inside any target repository discovers its remote and default
 branch. A Git URL also works. Flags can precede or follow the repository argument.
 
+`bbb version` prints the embedded release tag. Local builds report `dev`; binaries installed with `go install ...@version` report the module version.
+
 Runtime requirements: Git, authenticated `gh` with repository/issue read and
 issue creation access, and an authenticated ACP agent. By default it uses an
 installed `codex-acp`, falling back to `npx --yes @agentclientprotocol/codex-acp`.
@@ -66,6 +70,47 @@ Starting `bbb` authorizes unattended local investigation, test execution, and
 creation of issues for the selected repository. `--dry-run` performs discovery
 and review, prints the proposed issue bodies, and saves them without filing.
 
+## Terminal dashboard
+
+Interactive runs show a live dashboard by default. It fits the current terminal
+or tmux pane, adjusts when the pane is resized, and keeps the repository and
+current task visible. Each pane still runs one repository.
+
+```sh
+bbb /path/to/repo           # live dashboard in an interactive terminal
+bbb /path/to/repo --plain   # scrolling console output and agent transcript
+bbb /path/to/repo --json    # structured logs for tools and log collectors
+```
+
+The overview shows the repository, branch and commit, scan stage, active tool,
+uptime, attempt budget, and next check or retry countdown. Larger panes also
+show the selected model, reasoning effort, and investigation focus.
+
+**Saved** counts cover findings in the configured repository/branch state,
+including the current scan: found, filed, duplicate, pending, dry run, and skipped
+(invalid, uncertain, or stale). **Run** counters start at zero each time the
+process starts: completed scans, attempts, agent starts, tools, and error log
+events. A discovered finding is counted as filed only after publication is
+confirmed. Findings restored after restarting are included in saved totals.
+
+- `1`, `2`, `3` or `Tab`: switch between overview, findings, and activity.
+- `↑` / `↓` or `k` / `j`: browse findings or scroll activity.
+- `Enter`: inspect the selected finding, issue URL, reproduction, and review.
+- `Esc`: return from finding details. `Page Up` / `Page Down` scroll details.
+- `g` / `G`: jump to the start/end; `G` resumes following live activity.
+- `q` or `Ctrl+C`: stop the bot and its active agent, then restore the terminal.
+
+The finding browser shows the latest 200 findings, while totals include all saved
+findings. The activity view keeps recent output; full agent transcripts remain
+under the state directory. On exit, a short summary and new finding URLs stay in
+the terminal. `once` exits after its scan, and dry runs also print proposed finding
+details on exit.
+
+Piped input, redirected stderr, and `TERM=dumb` use scrolling output automatically.
+`--plain` and `--json` disable the dashboard and are mutually exclusive.
+`NO_COLOR` disables dashboard colors. `status`, `version`, and help keep their
+existing output and never open the dashboard.
+
 ## How it works
 
 1. Fetch the target branch into a managed clone and make an isolated detached
@@ -183,7 +228,7 @@ node --test --test-isolation=none npm/bbb.test.cjs
 Tests use local Git fixtures and simulated ACP/GitHub outcomes; they do not run
 a paid model or create real issues. They cover semantic closed duplicates,
 same-title distinct bugs, concurrent reports, partial histories, source changes,
-dry runs, retries, ambiguous POSTs, receipt coverage, configuration, and locks.
+dry runs, retries, ambiguous POSTs, receipt coverage, configuration, locks, progress snapshots, dashboard resizing, and terminal cleanup.
 
 The inherited release workflow packages Linux/macOS amd64/arm64 archives with
 checksums. The npm launcher and packaging workflow target `@brokkai/bug-bot`
@@ -192,3 +237,16 @@ and install `bbb`. See [RELEASING.md](RELEASING.md) for publication and verifica
 API references: [GitHub issues](https://docs.github.com/en/rest/issues/issues),
 [issue comments](https://docs.github.com/en/rest/issues/comments).
 Licensed under [Apache-2.0](LICENSE).
+
+## Automatic releases
+
+Push a new `v*` version tag to run the complete **Publish packages** pipeline:
+Linux/macOS checks, native GitHub assets, then all five npm packages from the
+same tag and commit. No manual package dispatch is needed. The package job runs
+only after native publication succeeds and validates package contents and local
+installs before uploading. It does not wait for npm's public index to update.
+
+For recovery, rerun failed jobs or manually dispatch `publish-packages.yml` from
+the exact existing tag with `publish=true`. The default manual `publish=false`
+validates without uploading. Existing published bytes must match on retry.
+See [RELEASING.md](RELEASING.md) for details.

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -25,9 +25,9 @@
     "arm64"
   ],
   "optionalDependencies": {
-    "@brokkai/bug-bot-linux-x64": "0.1.0",
-    "@brokkai/bug-bot-linux-arm64": "0.1.0",
-    "@brokkai/bug-bot-darwin-x64": "0.1.0",
-    "@brokkai/bug-bot-darwin-arm64": "0.1.0"
+    "@brokkai/bug-bot-linux-x64": "0.2.0",
+    "@brokkai/bug-bot-linux-arm64": "0.2.0",
+    "@brokkai/bug-bot-darwin-x64": "0.2.0",
+    "@brokkai/bug-bot-darwin-arm64": "0.2.0"
   }
 }