@hypercarrier/rarebit 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.4.0 — 2026-10-07
+
+- Replace Recall's hour-bucketed `rarebit_conversation/v1` with a flat
+  `rarebit_conversation/v2` message list. Each message has `seq`, `round`,
+  `role`, `kind`, second-precision UTC `time`, and `text`. Detailed evidence
+  occurrences gain the same `seq` join key.
+- Add the conversation schema and `jq` tail queries to the Recall message.
+
+## 0.3.0 — 2026-10-04
+
+- Add `/rarebit view [context|all|peek|off]` and a View action in the palette.
+  Read active-branch Rarebits across compactions, or keep the editor live in
+  peek.
+- Add scroll and smartcase search controls, toggle/cycle shortcuts with Super
+  aliases, and active-view status. First toggle opens all; off clears status.
+- Add the experimental context view with capability checks and an all-view
+  fallback. It relies on unsupported Pi internals and can break after updates.
+- Reset views on Session replacement, reload, and shutdown. Verify views on
+  Pi 0.84.2 and 1.0.0; component wheel input requires a supporting fullscreen
+  host.
+- Stop retained Recap entries from reading a closed Session after shutdown or
+  `/resume`.
+
 ## 0.2.1 — 2026-09-29
 
 - Move Recap into the scrollable transcript using native custom-entry renderers,

package/README.md

@@ -52,7 +52,7 @@ an existing Summary in the Pi TUI.
 ```text
 long Pi Session
   └─ Distill: selected active-branch prose
-       ├─ Catch up: read the conversation
+       ├─ Catch up: read the conversation through CLI extract or Pi view
        ├─ Recall: let an agent use the selection for one request
        ├─ Fork: start a new native Pi Session from a bounded suffix
        └─ Summary / Title: optional model-derived projections
@@ -72,6 +72,46 @@ records. Selection is deterministic. It is not model summarization. Each
 selected occurrence keeps its source entry, branch position, role, outcome,
 timestamp when available, and lineage.
 
+#### Read in the Pi TUI
+
+Use `/rarebit view` beside CLI `extract` to read the current Session without a
+model call. The command opens a picker. Choose a view directly with
+`/rarebit view [context|all|peek|off]`:
+
+- **all** reads every Rarebit on the active branch across compactions. Each
+  compaction has a marker. This is the first-toggle default.
+- **peek** reads that same branch while you type in the editor. It stays open
+  on submit. Replies appear when finished. It reserves a fixed seven-row dock;
+  a tall multiline editor can overlap the view.
+- **context** is experimental. The context view filters Pi's own transcript.
+  It depends on how Pi draws the transcript, which Pi does not guarantee for
+  extensions, so a Pi update can disable it. Rarebit then reports that the
+  context view is unavailable on this Pi version; the all and peek views keep
+  working. Context shows only Rarebits after the last compaction; use all to
+  read across compactions. It keeps Pi's compaction summary and Rarebit Recaps
+  visible.
+- **off** restores the normal transcript and removes the view status line.
+
+In `all`, use j/k or ↑/↓ for lines, u/d or Ctrl+U/Ctrl+D for half pages,
+b/Space for pages, and g/G for the ends. Search with `/` or `?`, then repeat
+with n/N. Search ignores case unless the query has an uppercase letter. Esc
+clears a search before it closes the view; q closes it. Mouse wheel scrolling
+requires fullscreen Pi with component mouse-event support. Pi 0.84.2 does not
+provide that support; Pi 1.0.0 does. In `peek`, keyboard input goes to the
+editor.
+
+Ctrl+Alt+R toggles the view. Ctrl+Alt+N cycles context → all → peek. The
+Ctrl+Super+R/N aliases support terminals that report the Super modifier through
+Kitty keyboard sequences. Later toggles reopen the last used view. Extension
+shortcuts cannot be rebound in `keybindings.json`; `/rarebit view` is the
+fallback. Close `all` before using Ctrl+Alt+G to acknowledge a Recap.
+
+The status line names the active view. The palette's **View** action opens the
+picker. Opening the Rarebit palette or settings closes the view. Session
+replacement, reload, and shutdown reset it to off. Turn it off before changing
+TUI mode. The views are verified on Pi 0.84.2 and 1.0.0. Other versions use
+capability checks and can report an unavailable view.
+
 ### 2. Recall for the agent
 
 In Pi, run:

package/RUNBOOK.md

@@ -1,10 +1,12 @@
 # Rarebit runbook
 
-Rarebit release automation lives in
-[`.github/workflows/publish.yml`](.github/workflows/publish.yml). It validates
-an immutable version tag, runs the package gates, verifies one packed artifact,
-and publishes that artifact with npm provenance. See [CHANGELOG.md](CHANGELOG.md)
-for product changes.
+To release, merge the version bump and its [CHANGELOG.md](CHANGELOG.md) entry
+to `main`, run `git-privacy-scan --ref HEAD history`, then push tag
+`v<version>`. The tag push runs
+[`.github/workflows/publish.yml`](.github/workflows/publish.yml). It runs the
+package gates, publishes one verified packed artifact with npm provenance, and
+creates the GitHub Release. A prerelease version goes to npm `next`; any other
+version goes to `latest`. Publication adds no commit.
 
 Set `rarebit.model` in global Pi settings or in a trusted Project's
 `.pi/settings.json`. It must be `provider/model` or an object with `provider`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypercarrier/rarebit",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Sparse, provenance-bearing conversational evidence recovery for Pi sessions.",
   "license": "MIT",
   "author": "HyperCarrier contributors",

package/scripts/e2e-recall-pi0842.mjs

@@ -18,29 +18,47 @@ async function waitFor(predicate, label, timeout = 2_000) {
 function expectedRecallMarkdown(conversationPath, detailedPath, request) {
   return `# Rarebit Recall
 
-*Use these local private evidence files to recover historical context for this turn.*
+*Answer the **Current request** below. Use these local private files to recover earlier context from this Session.*
 
-## How to use this bundle
+## Files
 
-1. Treat **Current request** below as the exact current user request.
-2. Read **Conversation** first for meaning.
-3. Use **Detailed evidence** only for source, Session, branch, or lineage facts.
-4. Answer the current request using this evidence.
-
-## Local private evidence files
-
-**Conversation** — \`rarebit_conversation/v1\`
+**Conversation** — \`rarebit_conversation/v2\`. Read this first.
 
 \`\`\`text
 ${conversationPath}
 \`\`\`
 
-**Detailed evidence** — \`rarebit_message_recall/v1\`
+**Detailed evidence** — \`rarebit_message_recall/v1\`. Use it only for source, Session, branch, or lineage facts. Join on \`seq\`.
 
 \`\`\`text
 ${detailedPath}
 \`\`\`
 
+## Conversation schema
+
+\`\`\`text
+{ messageCount, lastRound, messages: [{ seq, round, role, kind, time, text }] }
+seq    1-based, oldest first
+round  increments at each user message; agent messages before the first user message have round 0
+role   "user" | "agent"
+kind   "request" (user) | "progress" (agent text before a tool call) | "reply" (agent final answer)
+time   UTC "YYYY-MM-DDTHH:MM:SSZ", or null
+\`\`\`
+
+Messages contain user and agent text only. Tool calls and tool results are excluded.
+
+## Example queries
+
+Set \`F\` to the Conversation path. Read the smallest slice that answers the request.
+
+\`\`\`sh
+jq '.messages[-20:]' "$F"                                              # last 20 messages
+jq '[.messages[] | select(.role == "user")][-3:]' "$F"                 # last 3 user messages
+jq '[.messages[] | select(.kind == "reply")][-10:]' "$F"               # last 10 agent replies
+jq '.lastRound as $r | [.messages[] | select(.round > $r - 5)]' "$F"  # last 5 rounds
+jq '(now - 8*3600 | todate) as $t | [.messages[] | select(.time >= $t)]' "$F"  # last 8 hours
+\`\`\`
+
 ## Current request
 
 \`\`\`text
@@ -50,7 +68,7 @@ ${request}
 
 function conversationPathFrom(message) {
   const match = message.match(
-    /\*\*Conversation\*\* — `rarebit_conversation\/v1`\n\n```text\n([^\n]*rarebit-conversation\.json)\n```/,
+    /\*\*Conversation\*\* — `rarebit_conversation\/v2`\. Read this first\.\n\n```text\n([^\n]*rarebit-conversation\.json)\n```/,
   );
   assert.ok(match, "Recall Markdown must contain the fenced conversation path");
   return match[1];
@@ -58,7 +76,7 @@ function conversationPathFrom(message) {
 
 function detailedPathFrom(message) {
   const match = message.match(
-    /\*\*Detailed evidence\*\* — `rarebit_message_recall\/v1`\n\n```text\n([^\n]*rarebit-evidence\.json)\n```/,
+    /\*\*Detailed evidence\*\* — `rarebit_message_recall\/v1`\. Use it only for source, Session, branch, or lineage facts\. Join on `seq`\.\n\n```text\n([^\n]*rarebit-evidence\.json)\n```/,
   );
   assert.ok(match, "Recall Markdown must contain the fenced detailed path");
   return match[1];