@brokkai/bug-bot 0.3.2 → 0.3.4

package/README.md

@@ -50,6 +50,7 @@ make build
 ./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 report /path/to/your-repo --status dry_run > findings.md
 ./bin/bbb version
 ./bin/bbb retry /path/to/your-repo --once
 ```
@@ -108,7 +109,7 @@ 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
+`NO_COLOR` disables dashboard colors. `status`, `report`, `version`, and help keep their
 existing output and never open the dashboard.
 
 ## How it works
@@ -144,9 +145,15 @@ and another scan **30 minutes after completion**, even if the commit is unchange
 Recent summaries guide exploration; this is not a claim of exhaustive coverage.
 `once` runs or resumes one scan and exits. Failed scans retain their candidates,
 workspace, and diagnostics; retries wait at least 15 minutes and run on the next
-poll, with three attempts before requiring `retry`. Agent setup errors stop the
-daemon without consuming an attempt. An advanced branch invalidates pending
-findings so the next eligible attempt scans the new commit.
+poll, with three attempts before requiring `retry`. Agent startup failures are
+retried in place three times within about a minute, since nothing has been
+prompted yet; persistent setup errors then stop the daemon without consuming
+an attempt. After reconciling any uncertain issue
+publications, each poll or one-shot invocation checks for an advanced branch
+before enforcing the saved revision’s attempt budget or retry delay. A new
+revision archives pending findings as stale, retains their evidence and workspace,
+and starts a separate scan with a fresh budget. An unchanged exhausted revision
+remains blocked until `retry`.
 
 ## Duplicate handling and interrupted requests
 
@@ -201,7 +208,9 @@ TLS transport to be added later without changing worker semantics.
 ## Optional configuration
 
 `bbb --config bug-bot.json` loads a strict JSON object. No file is loaded or
-generated implicitly. Paths are resolved relative to the configuration file.
+generated implicitly. Paths, including local mirror remotes such as
+`./mirror.git` or `./published:mirror.git`, are resolved relative to the
+configuration file.
 See [bug-bot.example.json](bug-bot.example.json).
 
 ```json
@@ -239,6 +248,25 @@ remote and branch. JSON state is replaced atomically with fsync; private session
 transcripts live under the state directory. `status` prints saved JSON without
 starting an agent. `--json` selects structured progress logs.
 
+Export all retained findings as Markdown for later review or sharing:
+
+```sh
+bbb report --config bug-bot.json > findings.md
+bbb report --config bug-bot.json --status dry_run > dry-run.md
+```
+
+`report` reads saved state without starting an agent or scan, or changing state.
+A repository argument and `--branch` use the same selection as other commands;
+`--config` avoids remote discovery and requires neither GitHub CLI nor an agent.
+The report includes every completed and active finding (without the dashboard's
+200-entry limit), evidence, review, saved status, and any issue URL. Filter with
+`--status pending|posting|submitted|duplicate|uncertain|invalid|dry_run|stale`
+(select one value); omitting it includes all outcomes. Empty selections report
+no saved findings. Active findings show the scan's known commit; completed
+findings explicitly show commit unavailable because it is not retained. Internal
+checkout/state paths and publication request markers are omitted from report
+metadata; saved finding text is preserved.
+
 Scan worktrees and reproduction files are retained for inspection. Manage their
 retention along with transcripts externally. Agent instructions prohibit fixes,
 commits, pushes, and direct GitHub writes; tracked source changes or a changed

package/package.json

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