@fullstackhouse/cerber 0.10.1 → 0.12.0

package/README.md

@@ -8,9 +8,7 @@ verdict with a confidence score. You go through it in a local web cockpit.
 write is the Send button (plus opt-in daemon auto-send you turn on yourself) —
 reviewing is 100% local and read-only.
 
-Named after Cerberus, the gatekeeper — and a sibling of
-[cezar](https://github.com/open-mercato/cezar): cezar runs coding agents,
-cerber guards what gets merged.
+Named after Cerberus, the gatekeeper: cerber guards what gets merged.
 
 ## Quick start
 
@@ -37,9 +35,21 @@ npx @fullstackhouse/cerber serve        # → http://127.0.0.1:4820
 Sending stays a human click. Tame it with `--no-auto-review` (list awaiting
 PRs, review on click) or `--no-poll` (no GitHub polling at all) — or flip the
 same two switches in the cockpit's Settings, which persist in
-`~/.cerber/config.json` and apply on the next poll. Merged and closed PRs are
-archived out of the queue automatically, and PRs in archived repos are never
-picked up at all — the repo is read-only, so a review could never be sent.
+`~/.cerber/config.json` and apply on the next poll. The queue only lists what
+still wants you: anything you have settled drops into a drawer under it — one
+for reviews you sent, one for the ones you marked reviewed or skipped, one for
+merged and closed PRs — and PRs in archived repos are never picked up at all,
+since the repo is read-only and a review could never be sent.
+
+The cockpit is a background tab most of the day, so it tells you when the queue
+grows: a desktop notification naming the PR that arrived — click it to open the
+review — folded into one popup when several land at once. It stays quiet while
+you're looking straight at cerber, and no browser announces the same PR twice.
+Only the browser can grant this, and only off a click, so the bell in the top
+bar is one: click it to be asked, click it again to stop. Both the switch and
+the record of what has been announced are per-browser, kept in that browser
+rather than in `~/.cerber/config.json` — the permission they gate is the
+browser's, so a second browser starts its own record.
 
 ## What a review looks like
 
@@ -59,6 +69,13 @@ Each review is a plain JSON artifact in `~/.cerber/reviews/` (override with
 The cockpit (`cerber serve`) renders the queue and the per-PR walkthrough with
 diffs. Artifacts are plain JSON you can `cat`, edit, or pipe into anything.
 
+The queue is meant to be walked, not clicked through: `j`/`k` move the cursor
+and the strip under the table explains whatever it lands on — the verdict's own
+reasoning, what the run read, how it sits against the auto-send bar — so most
+rows can be judged without opening them. `↵` opens one, `r` drafts (or
+re-drafts) it. Inside a review, `[` and `]` walk to the previous/next PR still
+awaiting you, `n` steps through the chapters, and `s` sends.
+
 ### It reviews the code, not just the diff
 
 Cerber checks the PR's head out locally and lets the review read it. That
@@ -301,4 +318,4 @@ Web cockpit dev with hot reload: `pnpm dev serve` in one terminal,
 
 ## License
 
-MIT © Full Stack House
+MIT © [Full Stack House](https://fullstack.house)

package/dist/server/index.js

@@ -144,10 +144,19 @@ export async function buildApp(opts) {
                 additions: a.pr.additions,
                 deletions: a.pr.deletions,
                 changedFiles: a.pr.changedFiles,
+                // The queue's cursor row explains itself without opening the review,
+                // so the list carries what that explanation is made of.
+                baseRefName: a.pr.baseRefName,
+                headRefName: a.pr.headRefName,
             },
             verdict: a.verdict,
             commentCount: a.comments.filter((cm) => cm.status !== "dropped").length,
+            driftedCount: a.comments.filter((cm) => cm.status !== "dropped" && cm.drifted).length,
             costUsd: a.run?.costUsd ?? null,
+            withSource: a.run?.withSource ?? null,
+            trusted: a.run?.trusted ?? null,
+            runError: a.run?.error ?? null,
+            sent: a.sent ? { at: a.sent.at, event: a.sent.event, url: a.sent.url, auto: a.sent.auto ?? false } : null,
         })));
     });
     app.get("/api/reviews/:key", async (c) => {

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@fullstackhouse/cerber",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "AI code-review cockpit: Claude reviews your PRs into local artifacts; nothing reaches GitHub until you say so.",
   "license": "MIT",
+  "author": "Full Stack House (https://fullstack.house)",
   "repository": "github:fullstackhouse/cerber",
   "type": "module",
   "packageManager": "pnpm@10.33.2",