Document the Repository tab, newer status and hint column

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2 files changed, 17 insertions, 5 deletions

diff --git a/AGENTS.md b/AGENTS.md
index 92c636e..2718ff7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -20,6 +20,8 @@ plans are working files, kept out of git (`.superpowers/`).
   answers with JSON. `sb_builder/remote.py` is the only code that runs ssh
   (and local `virsh`). `sb_builder/upstream.py` runs the local `nvchecker`
   over the repo's `nvchecker.toml`; the VM never sees the GitHub token.
+  `sb_builder/repository.py` reads the built package repository from its
+  local mount (`[repository] path`), never over ssh.
 - Trust boundary: the helper runs only a fixed table of job kinds and builds
   argv itself from validated args. Never pass shell strings or paths from the
   GUI to the helper.
diff --git a/README.md b/README.md
index 938dbc6..652bcae 100644
--- a/README.md
+++ b/README.md
@@ -67,8 +67,8 @@ Wayland the compositor may still pick the window size).
 
     sb-builder
 
-The window has five tabs, always open: Dashboard, Packages, Hints, Results,
-Jobs (Ctrl+PgUp/PgDn cycle them). The ribbon at the top holds the current
+The window has six tabs, always open: Dashboard, Packages, Hints, Results,
+Repository, Jobs (Ctrl+PgUp/PgDn cycle them). The ribbon at the top holds the current
 tab's actions, in the order a task uses them; the smaller bar under it holds
 its view controls (select, clear, refresh). An action that does not apply is
 greyed out, its tooltip says why. Actions act on the **ticked** rows: a click
@@ -86,9 +86,13 @@ reopens it.
   build results, last overlay pull, SBo orphans, recent jobs. Refreshes while
   visible. The tiles open Packages (the orphans tile with only the orphaned
   filter on), Results (one result kind) and Jobs.
-- **Packages**: every package of the repository, with built version and
-  status (`ok`, `failed`, `never`, `outdated`). Search by name or summary, or
-  with `cat:`, `maint:`, `req:`, `status:`; toggle the overlay and status
+- **Packages**: every package of the repository, with built version, hint
+  and status (`ok`, `failed`, `never`, `outdated`, `newer`: built newer than
+  the target, e.g. after a pin left its hint, so Update would downgrade). The
+  hint column says what the hint does: `pin` (sets `VERSION`), `deps` (only
+  `DELREQUIRES`/`ADDREQUIRES`), `skip`, `other`. Search by name or summary,
+  or with `cat:`, `maint:`, `req:`, `status:`, `hint:` (`hint:none` for no
+  hint); toggle the overlay and status
   chips, and **orphaned** for the packages SBo lists without a maintainer.
   The detail pane shows the package's versions, its dependencies after
   hints (dropped ones struck through), what its hint file does, and a link
@@ -120,6 +124,12 @@ reopens it.
   the log of the package's last attempt (slackrepo keeps one per command:
   `build.log`, `update.log`, `rebuild.log`, `remove.log`), where it reports
   the failure, with its `resource.log` (load, memory, tmp over the build).
+- **Repository**: the packages slackrepo built, read from the local mount of
+  its package repository (`[repository] path`, default `/repo`; no VM
+  needed). A stats line (count, size, per overlay, unpublished, last
+  publish), search by name or description, overlay and `unpublished` chips;
+  the detail pane shows the description, sizes and the package's ChangeLog
+  entries, with a link to it in Packages.
 - **Jobs**: every job with its live log. **Pull overlay** (`sbpull <overlay>`)
   and **Check shadowing** (`sbshadow`) run as previews; when one finds
   `shadow:` or `unshadow:` lines, its dialog offers **Apply shadowing**.