@brokkai/bug-bot-linux-arm64 0.3.4 → 0.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/BUILD.json +1 -1
- package/README.md +52 -1
- package/bin/bbb +0 -0
- package/package.json +2 -2
package/BUILD.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"commit": "
|
|
1
|
+
{"commit": "dbafc8261b701d0a8529d5d1789f23a0d964a6fc", "tag": "v0.6.2-bug-bot", "target": "linux-arm64"}
|
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Brokk Bug Bot
|
|
2
2
|
|
|
3
|
+
This standalone project now lives in [`BrokkAi/brokk-town/bots/bug-bot`](https://github.com/BrokkAi/brokk-town/tree/master/bots/bug-bot). Build and test from this directory; see [RELEASING.md](RELEASING.md) for its independent suffix-tag releases.
|
|
4
|
+
|
|
3
5
|
Find new bugs in a repository and file useful GitHub issues. `bbb` follows the
|
|
4
6
|
same Go CLI, no-config discovery, managed workspace, and shared
|
|
5
7
|
[ACP runner](https://github.com/BrokkAi/acp-go) pattern as
|
|
@@ -48,7 +50,9 @@ make build
|
|
|
48
50
|
./bin/bbb once /path/to/your-repo --dry-run
|
|
49
51
|
./bin/bbb once /path/to/your-repo --focus "parser and input validation"
|
|
50
52
|
./bin/bbb /path/to/your-repo --max-issues 2 --label bug
|
|
53
|
+
./bin/bbb /path/to/your-repo --only-on-change
|
|
51
54
|
./bin/bbb /path/to/your-repo --model YOUR_MODEL_ID --effort low
|
|
55
|
+
./bin/bbb /path/to/your-repo --model SCAN_MODEL_ID --review-model REVIEW_MODEL_ID --review-effort high
|
|
52
56
|
./bin/bbb status /path/to/your-repo
|
|
53
57
|
./bin/bbb report /path/to/your-repo --status dry_run > findings.md
|
|
54
58
|
./bin/bbb version
|
|
@@ -85,7 +89,8 @@ bbb /path/to/repo --json # structured logs for tools and log collectors
|
|
|
85
89
|
|
|
86
90
|
The overview shows the repository, branch and commit, scan stage, active tool,
|
|
87
91
|
uptime, attempt budget, and next check or retry countdown. Larger panes also
|
|
88
|
-
show the
|
|
92
|
+
show the discovery and review model and reasoning effort, and the investigation
|
|
93
|
+
focus.
|
|
89
94
|
|
|
90
95
|
**Saved** counts cover findings in the configured repository/branch state,
|
|
91
96
|
including the current scan: found, filed, duplicate, pending, dry run, and skipped
|
|
@@ -116,6 +121,8 @@ existing output and never open the dashboard.
|
|
|
116
121
|
|
|
117
122
|
1. Fetch the target branch into a managed clone and make an isolated detached
|
|
118
123
|
worktree for the scan. The original checkout and uncommitted work are preserved.
|
|
124
|
+
An optional operator setup command prepares the worktree at the start of
|
|
125
|
+
each attempt, before any agent runs.
|
|
119
126
|
2. Download all open and closed issues and their comments with pagination. Give
|
|
120
127
|
the investigator the complete snapshot and recent scan summaries so it can
|
|
121
128
|
avoid known bugs and explore new areas on subsequent scans.
|
|
@@ -143,6 +150,17 @@ belonging to that report. The bot does not reopen or comment on it.
|
|
|
143
150
|
The default is at most **three issues per scan**, a **two-hour attempt budget**,
|
|
144
151
|
and another scan **30 minutes after completion**, even if the commit is unchanged.
|
|
145
152
|
Recent summaries guide exploration; this is not a claim of exhaustive coverage.
|
|
153
|
+
With `only_on_change` (`--only-on-change`), the daemon still fetches at each poll
|
|
154
|
+
but starts no investigation while the branch commit matches the last completed
|
|
155
|
+
scan for the same dry-run setting; the dashboard reports the unchanged branch and
|
|
156
|
+
the next check. A completed scan is one whose findings were all reviewed,
|
|
157
|
+
including a scan with zero findings; a scan discarded because the branch
|
|
158
|
+
advanced does not count. Switching from dry-run to publication permits a new scan
|
|
159
|
+
of the same commit. Saved state from earlier versions scans once to establish the
|
|
160
|
+
baseline. Uncertain publications, pending retries and exhausted budgets are
|
|
161
|
+
handled before this check, and `once` always runs. This is a polling policy, not
|
|
162
|
+
a claim that the revision was exhaustively investigated; use `once` to rescan after
|
|
163
|
+
changing focus or model settings.
|
|
146
164
|
`once` runs or resumes one scan and exits. Failed scans retain their candidates,
|
|
147
165
|
workspace, and diagnostics; retries wait at least 15 minutes and run on the next
|
|
148
166
|
poll, with three attempts before requiring `retry`. Agent startup failures are
|
|
@@ -227,6 +245,7 @@ See [bug-bot.example.json](bug-bot.example.json).
|
|
|
227
245
|
"focus": "",
|
|
228
246
|
"labels": [],
|
|
229
247
|
"dry_run": false,
|
|
248
|
+
"only_on_change": false,
|
|
230
249
|
"agent": {"command": ["codex-acp"]}
|
|
231
250
|
}
|
|
232
251
|
```
|
|
@@ -237,10 +256,42 @@ Enterprise, and `github.repo` (`OWNER/REPO`) identifies a local mirror's GitHub
|
|
|
237
256
|
repository. `agent` also supports `environment`, `auth_method`, `mode`, `model`,
|
|
238
257
|
and `effort`, with selection handled by the shared ACP runner.
|
|
239
258
|
|
|
259
|
+
Discovery uses `agent.model` and `agent.effort` (`--model`, `--effort`). Evidence
|
|
260
|
+
validation and every duplicate-review batch, including reviews after issue
|
|
261
|
+
history changes and reviews of pending findings resumed from a saved scan, use
|
|
262
|
+
`review_model` and `review_effort` (`--review-model`, `--review-effort`). Each
|
|
263
|
+
omitted review setting inherits the discovery setting; CLI flags override JSON,
|
|
264
|
+
and blank values are rejected. For example, adding
|
|
265
|
+
`"review_model": "REVIEW_MODEL_ID"` to the configuration keeps discovery on
|
|
266
|
+
`agent.model` while review uses `REVIEW_MODEL_ID`. Review runs with the same agent command,
|
|
267
|
+
environment, workspace, retries, timeout, and publication gates. A review model
|
|
268
|
+
or effort the adapter does not offer stops the scan with a setup error before any
|
|
269
|
+
review prompt; pending findings stay pending and never fall back to the discovery
|
|
270
|
+
selection. Progress logs carry `stage=discovery` or `stage=review` with the
|
|
271
|
+
effective model and effort.
|
|
272
|
+
|
|
240
273
|
`verify` accepts an argument array, such as `["/opt/checks/verify-bug"]`, executed
|
|
241
274
|
in the scan worktree with `BUG_COMMIT` and JSON `BUG_FINDING` in its environment.
|
|
242
275
|
Keep operator verifiers outside the writable worktree. A nonzero exit blocks filing.
|
|
243
276
|
|
|
277
|
+
`setup` (default: none; set it in the `--config` file) accepts an argument array, such as
|
|
278
|
+
`["/opt/checks/install-deps", "--frozen"]`, for preparing test prerequisites. It
|
|
279
|
+
runs in the detached scan worktree with `bbb`'s environment, like `verify`, plus
|
|
280
|
+
`BUG_COMMIT` set to its HEAD, once at the
|
|
281
|
+
start of every counted scan attempt before any agent runs, including attempts
|
|
282
|
+
that resume review of pending findings. It does not repeat for review batches or
|
|
283
|
+
agent startup retries, so a later attempt runs it again: keep it idempotent and
|
|
284
|
+
tolerant of partial earlier runs. It may create untracked or ignored files, which
|
|
285
|
+
discovery and review then see; it must exit zero and leave HEAD and tracked
|
|
286
|
+
source unchanged. Any failure, including exceeding the shared `timeout` (which
|
|
287
|
+
kills its process tree), consumes the attempt, keeps pending findings unpublished,
|
|
288
|
+
saves a `workspace setup` failure and waits `retry_delay` from when it failed.
|
|
289
|
+
Dry runs run it; `status`, `report`, waiting polls and reconciling an interrupted
|
|
290
|
+
publication do not. Only the tail of its output is kept in the saved failure.
|
|
291
|
+
Nothing it exports reaches the agent. Keep setup scripts outside the writable
|
|
292
|
+
worktree; they run with the bot's own privileges. An empty array or blank
|
|
293
|
+
executable is rejected.
|
|
294
|
+
|
|
244
295
|
## State and execution
|
|
245
296
|
|
|
246
297
|
State defaults to `$XDG_STATE_HOME/bug-bot` or `~/.local/state/bug-bot`, keyed by
|
package/bin/bbb
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.6.2",
|
|
3
3
|
"license": "Apache-2.0",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
|
-
"url": "git+https://github.com/BrokkAi/
|
|
6
|
+
"url": "git+https://github.com/BrokkAi/brokk-town.git"
|
|
7
7
|
},
|
|
8
8
|
"publishConfig": {
|
|
9
9
|
"access": "public"
|