@hypercarrier/rarebit 0.1.0-alpha.6 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.2.1 — 2026-09-29
+
+- Move Recap into the scrollable transcript using native custom-entry renderers,
+  preserving its muted styling. Retain the widget fallback for older Pi hosts.
+- Request 1–2 sentences and at most 300 characters in the default Summary prompt.
+- Add `Ctrl+Alt+G` and `/rarebit got-it` to persist branch-local recap read
+  checkpoints. Subsequent summaries emphasize changes beyond recap coverage.
+- Reuse native Recaps for the same receipt and coverage, including after read
+  acknowledgement and resume. Validate read markers against branch evidence.
+- Keep conversation evidence beside read metadata when Summary input is trimmed.
+- Promote newer manual assessments after settlement. Preserve active requests
+  until an agent-settled assessment closes them.
+- Display current request-prefix Recaps with their exact receipt coverage.
+  Revalidate live branch state after asynchronous reads.
+- Report explicit Summary outcomes even when automatic notices are disabled.
+- Shorten Recap headers to numeric date, 24-hour time, and GMT offset. Keep
+  the got-it action inline.
+- Include a native fullscreen renderer probe documenting Pi 0.84.2's mouse-input
+  limitation; the read affordance currently supports keyboard activation.
+
+## 0.2.0 — 2026-09-27
+
+- Add the `/rarebit` action palette and tabbed `/rarebit settings` editor.
+- Add a configurable `summary_prompt` for Summary format and length. Preserve
+  paragraphs and bullets; reject oversized output instead of silently cutting it.
+- Show the complete Recap in a muted, labelled TUI section. Remove
+  `/rarebit recap expand`.
+- Keep Recap outside Session messages and model context. Typing preserves it;
+  submitted input, new turns, and Session or branch changes clear it.
+- Default Summary diagnostics to off, support host or explicit IANA timezones,
+  and expose the estimated Summary input budget in settings.
+- Include a complete example config in `docs/examples/rarebit.settings.json`.
+
 ## 0.1.0-alpha.6 — 2026-09-21
 
 - Add bounded `/rarebit fork` and CLI fork flows with native Pi headroom checks.
@@ -8,9 +41,6 @@
 - Keep read-only package commands usable without optional Pi host peers; fork
   runtime loads the Pi adapter only when needed.
 
-This is an unpublished release candidate. Intended npm routing after
-publication is `next=alpha.6`; `latest` remains `alpha.4`.
-
 ## 0.1.0-alpha.5 — 2026-08-16
 
 - Repair Pi 0.84.2 Summary calls to use the active Pi model runtime. The

package/README.md

@@ -1,183 +1,357 @@
 # Rarebit
 
-`@hypercarrier/rarebit` recovers decision-bearing conversational evidence from
-one persisted Pi Session. It deterministically selects readable user messages
-and assistant continuation or stop prose on the active branch. It excludes tool
-payloads, tool results, and hidden reasoning.
-
-Rarebit is public alpha software. Its CLI output, exports, sidecar protocol,
-and visual language can change. It is not a Task, Project, runtime, priority,
-attention, or delivery authority. Native Pi Session JSONL remains the evidence
-authority.
-
-Alpha.6 is an unpublished release candidate. It adds bounded Rarebit fork
-flows, PiQ recovery, machine-only lineage, and Pi-native headroom checks.
-Intended npm routing after publication is `next=alpha.6`; `latest` remains
-`alpha.4`. Published alpha.5 repairs Pi 0.84.2 Summary calls by using the
-active Pi model runtime. Its durable publication evidence is the
-[alpha.5 release receipt](release/v0.1.0-alpha.5-release-receipt.md).
-
-The old alpha.1, alpha.2, and alpha.3 tag graphs remain public and are not
-privacy-clean. Existing package versions, tags, and releases remain immutable.
-The source-only candidate derivation and vendored-scanner binding is
-[`release/privacy-lineage.v1.json`](release/privacy-lineage.v1.json). It is
-excluded from npm and does not claim publication completion.
+[![Rarebit: catch up on a long Pi session](https://raw.githubusercontent.com/deephbz/rarebit/main/brand/assets/banner.svg)](https://deephbz.github.io/rarebit)
+
+**[Rarebit website](https://deephbz.github.io/rarebit)**
+
+## Watch the demo
+
+[![Watch the one-minute Rarebit demo](https://raw.githubusercontent.com/deephbz/rarebit/main/brand/promo-video/preview.jpg)](https://github.com/deephbz/rarebit/releases/download/v0.2.0/rarebit-promo.mp4)
+
+[Play the video inline in the release notes](https://github.com/deephbz/rarebit/releases/tag/v0.2.0#watch-the-demo)
+· [Download the MP4](https://github.com/deephbz/rarebit/releases/download/v0.2.0/rarebit-promo.mp4)
+
+Rarebit helps you catch up on a long Pi session without rereading its tool
+traffic. It selects original messages from the active branch so you can read the
+conversation, ask an agent to use it, or start a focused new Session. The
+original Pi Session stays intact.
 
-## Install
+Rarebit is public alpha software. Its CLI output, exports, sidecar protocol, and
+visual language can change.
 
-Use Node 22 or later and Pi 0.83 or later. Install it in Pi from npm:
+## Start here
+
+Three outcomes cover the useful path:
+
+- **Catch up** — read selected conversational prose from the active branch.
+- **Recall** — let an agent read that same selection for one request.
+- **Fork** — start a fresh native Pi Session from a bounded newest suffix.
+
+Install Rarebit and make the first deterministic, zero-model extraction:
 
 ```sh
-pi install npm:@hypercarrier/rarebit@0.1.0-alpha.6
-pi list
+# In a shell, install the extension in Pi, then restart Pi to load it.
+pi install npm:@hypercarrier/rarebit@0.2.0
+
+# Install the CLI in the Node project where you will run it.
+npm install @hypercarrier/rarebit@0.2.0
+npm exec -- rarebit extract \
+  --session /absolute/path/to/session.jsonl --json > selected-prose.json
 ```
 
-For a local checkout, Pi loads a directory without copying it:
+Replace the example path with an exact Pi Session JSONL path or supported Session
+identifier. Pi normally stores Session JSONL below `~/.pi/agent/sessions/`.
+Open `selected-prose.json` to catch up on the conversation. Then
+choose Recall or Fork when you need an agent request or a fresh Session.
 
-```sh
-pi install /absolute/path/to/rarebit
-pi list
+Summary and Title are optional model-derived projections. Recap only displays
+an existing Summary in the Pi TUI.
+
+## The product in one view
+
+```text
+long Pi Session
+  └─ Distill: selected active-branch prose
+       ├─ Catch up: read the conversation
+       ├─ 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
+            └─ Recap: show an existing Summary in the Pi TUI
 ```
 
-The package imports Pi's bundled `@earendil-works/pi-ai` as a peer dependency.
-Do not install or bundle a second Pi core. Pi packages execute with your user
-permissions, so review source before installation.
+### 1. Catch up and distill
 
-To use the CLI in a normal Node project, install it and invoke the local bin
-with npm:
+Rarebit selects these occurrences from one exact active branch:
 
-```sh
-npm install @hypercarrier/rarebit@0.1.0-alpha.6
-npm exec -- rarebit --help
+- readable user messages;
+- assistant prose at a continuation boundary;
+- assistant prose at a normal stop boundary.
+
+It excludes tool-call inputs, tool results, hidden reasoning, and transport
+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.
+
+### 2. Recall for the agent
+
+In Pi, run:
+
+```text
+/rarebit recall What decisions and open questions should guide the next turn?
 ```
 
-## First query and extract
+Recall writes a private conversation view and a detailed lineage view, then
+sends one user-message envelope with your request and both file references. The
+agent reads those referenced files through its configured model provider. The
+files are private on local disk, but Rarebit makes no provider-privacy claim;
+apply your provider's policy. An idle Pi starts one turn. A busy Pi queues one
+steering message. Recall does not create a durable Recall record or a second
+follow-up message.
 
-Give the CLI an exact Session JSONL path or supported Pi Session identifier.
-`query` returns metadata only. `extract` returns selected raw Session prose.
+For agent workflows outside the Pi TUI, use the CLI's `extract` operation. It
+is the CLI catch-up interface; there is no CLI `recall` command:
 
 ```sh
-npm exec -- rarebit query --session /absolute/path/to/session.jsonl --json
-npm exec -- rarebit extract --session /absolute/path/to/session.jsonl --json
+npm exec -- rarebit extract \
+  --session /absolute/path/to/session.jsonl --json > selected-prose.json
 ```
 
-The Pi extension adds `/rarebit` controls after installation. It has `status`,
-`config`, `auto-title`, `title`, `summarize`, `recall`, and `fork` subcommands.
+Treat that output as sensitive. It contains selected raw prose.
+
+### 3. Fork as a distilled native fork
 
-`/rarebit fork` validates the newest contiguous Rarebit suffix, writes a new
-Session in Pi's Session store for the current working directory, and switches
-to it without starting a model turn. Use `/rarebit fork --max-token-length 64000` to set the
-imported prose budget. Imported messages keep their roles and source outcomes,
-use zero usage, and carry machine-only lineage. The generated opening message
-records source ID/path/leaf, target directory, coverage, and the read-only PiQ
-recovery command. Legacy source entries retain `(sessionId, sourceOrder)` when
-native entry IDs are absent; Rarebit does not migrate those sources.
+Fork creates a new native Pi Session from the newest contiguous suffix of the
+selected active-branch prose. It does not summarize, deduplicate, or modify the
+source. It does not start a model turn and does not transfer mutable Team, Task,
+subscription, or extension state.
 
-The CLI performs the same operation without changing the caller's Session:
+In Pi:
+
+```text
+/rarebit fork
+```
+
+From a shell, use the exact source Session path or ID:
 
 ```sh
-rarebit fork /absolute/source.jsonl
-rarebit fork /absolute/source.jsonl --max-token-length 64000 --no-launch
+npm exec -- rarebit fork /absolute/path/to/session.jsonl
+npm exec -- rarebit fork /absolute/path/to/session.jsonl \
+  --max-token-length 64000 --no-launch --json
 ```
 
-The first form launches Pi in the invocation working directory. The second
-returns JSON for automation. Fork mode requires an installed Pi coding-agent
-peer; read-only query, extract, and PiQ commands do not. Use `piq entries
---session <path>` to read omitted native evidence without writing or migrating
-the source.
+The default import budget is 64,000 estimated tokens. Fork keeps whole
+occurrences in branch order. If the newest occurrence cannot fit, it refuses
+with an actionable error. The new Session contains machine-readable source
+lineage and a recovery route. It does not promise complete context transfer.
 
-## Model setup and optional derivations
+Use `piq` to inspect source evidence that the bounded fork omitted:
 
-Summary and Title use a dedicated configured model. They never inherit Pi's
-interactive `defaultModel`. Put this in global Pi settings, or in a trusted
-project's `.pi/settings.json`:
+```sh
+npm exec -- piq entries --session /absolute/path/to/session.jsonl
+```
 
-```json
-{
-  "rarebit": {
-    "model": "provider/model",
-    "min_total_length": 80000,
-    "max_rarebit_ratio": 0.4,
-    "auto_title": true
-  }
-}
+PiQ is read-only JSONL output for `jq`. It does not classify Rarebits, mutate a
+Session, invoke a model, or migrate legacy entries.
+
+### 4. Summary, Title, and Recap
+
+Summary and Title are optional derivations over the selected evidence. Recap is
+a presentation of an existing Summary, not a derivation.
+
+- **Summary** is a lossy, model-derived Session assessment. It can describe
+  what appears finished or needs attention in the selected prose. It is not
+  proof of completed work.
+- **Title** is a mutable label proposal derived from a suitable user message.
+- **Recap** presents the current Summary in the Pi TUI. It reads an existing
+  receipt and does not generate a Summary.
+
+Use the Pi commands for a derivation or presentation:
+
+```text
+/rarebit summarize
+/rarebit title
+/rarebit recap
+/rarebit got-it
 ```
 
-Then request explicit model work when you want it:
+The CLI exposes the same model operations for an exact Session:
 
 ```sh
-npm exec -- rarebit summarize --session /absolute/path/to/session.jsonl --json --force
-npm exec -- rarebit title --session /absolute/path/to/session.jsonl --json
+npm exec -- rarebit summarize \
+  --session /absolute/path/to/session.jsonl --json --force
+npm exec -- rarebit title \
+  --session /absolute/path/to/session.jsonl --json
 ```
 
-A Summary is a lossy assessment of an identified selection. It can report only
-Session-scoped appearance, not completed Project or Task work. A Title is a
-mutable label proposal, not Session identity. Automatic Summary work runs only
-at persisted direct-input or settled-agent boundaries and only when its policy
-permits it.
+Summary and Title need a configured model. Query, extract, and PiQ inspection
+do not need a model. Fork creation needs an installed Pi peer and a resolvable
+target model context, but it does not invoke that model or start a turn.
 
-## Privacy, local data, and provider egress
+## Continue from the first result
 
-Rarebit reads Pi Session JSONL locally and does not modify it. `extract` prints
-selected raw prose, so handle its output as sensitive.
+1. Install the pinned npm package in Pi and restart Pi. For a local checkout,
+   use `pi install /absolute/path/to/rarebit`.
+2. Read or automate against `selected-prose.json`. The deterministic path works
+   without a model.
+3. Run `/rarebit recall <request>` when the agent should read selected earlier
+   conversation for one request.
+4. Use `/rarebit fork` when a bounded, fresh Session is more useful than
+   continuing the original one.
+5. Add model configuration only when you need Summary or Title.
 
-Summary and Title send selected Rarebit prose to the provider and model that you
-configure. When input exceeds the fixed limit, Rarebit sends a newest suffix
-with an explicit omission marker. It does not send tool inputs, tool results,
-hidden reasoning, provider credentials, or HTTP headers as Rarebit content.
+The package uses Pi's bundled `@earendil-works/pi-ai` peer. Do not install or
+bundle a second Pi core. Pi packages run with your user permissions. Review
+source before installation. Use `npm install @hypercarrier/rarebit@0.2.0` and
+`npm exec -- rarebit --help` when you use the CLI from a normal Node project.
 
-Derived receipts live below `~/.pi/agent/rarebit/materializations-v4/`; job
-leases live below `~/.pi/agent/rarebit/jobs-v4/`. These directories use mode
-0700 and their files use mode 0600. Receipts retain compact metadata but no
-selected prose, prompt, provider response body, headers, or credentials. They
-remain until you remove them. Session JSONL retention is controlled by Pi.
+## Scope and source
 
-## First Recall
+Native Pi Session JSONL remains the evidence authority. Rarebit does not own
+Task, Project, runtime, priority, attention, or delivery state. A Summary is a
+lossy Session assessment, not proof of completed Task or Project work. A Title
+is a label proposal, and Recap only presents the current Summary.
 
-Run `/rarebit recall <prompt>` in a Pi Session. Rarebit writes the exact active
-branch selection to two private files: a conversation view and detailed
-lineage evidence. It then sends one atomic, human-readable Markdown user
-message containing your exact request and absolute pointers to both files.
+## Configure optional derivations
 
-When Pi is idle, that message starts one turn. When Pi is busy, it queues one
-steering message. Recall does not send a second follow-up, add a custom Session
-entry, or create a durable Recall receipt.
+Copy the example from
+[`docs/examples/rarebit.settings.json`](docs/examples/rarebit.settings.json)
+into the `rarebit` object in global Pi settings
+(`~/.pi/agent/settings.json`, or `$PI_CODING_AGENT_DIR/settings.json` when set)
+or a trusted Project's `.pi/settings.json`. Preserve other settings.
 
-The temporary directory is mode 0700 and its JSON files are mode 0600. The
-files remain after the request so Pi can read them; delete the directory after
-the turn no longer needs it. Both files and the persisted Pi message are
-sensitive. Do not put their paths or content in a ticket.
+```json
+{
+  "rarebit": {
+    "model": "provider/model",
+    "min_total_length": 80000,
+    "max_rarebit_ratio": 0.4,
+    "auto_title": true,
+    "max_input_tokens": 64000,
+    "summary_prompt": "State when evidence is uncertain, confusing, contradictory, or importantly missing.",
+    "diagnostics": {
+      "summary_triggered": false,
+      "summary_updated": false
+    },
+    "recap": {
+      "enabled": true,
+      "delay_ms": 60000,
+      "timezone": "host"
+    }
+  }
+}
+```
+
+Set `model` to a model available through your authenticated provider. Rarebit
+uses this model for Summary and Title; it does not inherit Pi's interactive
+`defaultModel`.
+
+Use `/rarebit settings` to edit the dedicated namespace. The editor supports
+global settings and a trusted Project override. Settings apply to future
+operations. The default Summary prompt requests 1–2 sentences and at most 300
+characters including spaces; this is model guidance, not an enforced truncation.
+Existing custom prompts keep their own length guidance. The `summary_prompt` value changes Summary format and length, but
+Rarebit still owns evidence handling and the structured status contract.
+
+Automatic Summary work runs only at eligible persisted direct-input or settled-
+agent boundaries. It also requires the configured minimum estimated Session
+length and maximum selected-prose ratio. A Pi Session start does not trigger
+synthesis. Explicit `/rarebit summarize` or `rarebit summarize --force` remains
+available.
+
+After successful materialization, Recap can offer the current Summary in the Pi
+TUI after one minute by default. On Pi with `registerEntryRenderer` (tested on
+0.84.2), it appears in the scrollable transcript with the same muted border and
+prose styling, and survives resume. Older Pi versions retain the pinned widget
+fallback, which clears at input/turn/Session boundaries.
+
+Press **Ctrl+Alt+G** or run `/rarebit got-it` to mark the latest displayed Recap
+in the active branch as read. Its inline header affordance changes to `✓ got it`.
+Native Session JSONL stores a read marker for the Recap receipt and covered
+evidence cut. A request-prefix Recap ends at its receipt cut, before later
+assistant prose. New messages remain unread. The next Summary includes the read
+boundary and emphasizes later updates while still checking earlier unresolved
+requests. Reading a Recap does not approve or complete work, and does not trigger
+a model call. The marker is branch-local and survives resume. The read marker
+is unavailable with the legacy widget fallback.
+
+A manual `/rarebit summarize` reports when the Summary is current, already
+current or in flight, generated but no longer current, or failed. These result
+messages do not enable automatic Summary notices.
+
+Mouse activation is not supported yet: Pi 0.84.2 consumes fullscreen mouse
+input before extension listeners, so the affordance is a keyboard action.
+Set `rarebit.recap.enabled` to `false`, change `delay_ms`, or set
+`timezone` to `host` or an IANA zone such as `Asia/Hong_Kong`.
+
+## Privacy and local data
+
+- Rarebit reads native Pi Session JSONL locally. Fork writes a new target
+  Session but never modifies the source Session.
+- `query` returns metadata and selected occurrence identifiers. `extract`
+  returns selected raw prose on demand.
+- Scrollable Recaps and read markers are stored as native custom Session entries.
+  They do not enter the main agent model context. Read-boundary metadata enters
+  subsequent Rarebit Summary requests.
+- Summary and Title send selected prose to the provider and model you
+  configure. If the input exceeds `max_input_tokens`, Rarebit sends a newest
+  suffix with an explicit omission marker and coverage record.
+- Rarebit does not send tool inputs, tool results, hidden reasoning, provider
+  credentials, or HTTP headers as Rarebit content.
+- Derived receipts live below
+  `~/.pi/agent/rarebit/materializations-v4/`. Job leases live below
+  `~/.pi/agent/rarebit/jobs-v4/`. These directories use mode `0700`; their
+  files use mode `0600`.
+- Receipts retain compact metadata, not selected prose, prompts, provider
+  response bodies, headers, or credentials. Receipts remain until you remove
+  them.
+- Recall files are private OS-temporary JSON files. They contain selected
+  content and lineage and remain until you delete them after the turn no longer
+  needs them. The persisted Pi user message and both files are sensitive.
+
+Pi controls Session JSONL retention. Do not put Session prose, credentials,
+Recall files, or private paths in public issues.
 
 ## Update, uninstall, and rollback
 
-Pin alpha versions for reproducible installs:
+Pin a version when you need reproducible installs:
 
 ```sh
-pi install npm:@hypercarrier/rarebit@0.1.0-alpha.6
+pi install npm:@hypercarrier/rarebit@0.2.0
 pi remove npm:@hypercarrier/rarebit
 ```
 
-The exact-version install also moves an existing Rarebit npm installation to
-that pin. Pi skips versioned npm sources during package updates. Do not use an
-unpinned source for alpha.5 recovery: unpinned npm resolution follows the
-retained `latest`, which remains alpha.4.
+A versioned npm install moves an existing Rarebit npm source to that pin. Pi
+skips versioned npm sources during package updates. Restart Pi after an install
+to load new extension code.
+
+To roll back, reinstall a known version:
+
+```sh
+pi install npm:@hypercarrier/rarebit@<version>
+```
 
-To roll back, reinstall a known version with `pi install npm:@hypercarrier/rarebit@<version>`.
 Removal stops package loading. It does not alter Pi Session JSONL or delete
-Rarebit sidecars, job leases, or Recall temp files. Remove retained local data
-only after you review it.
+Rarebit sidecars, job leases, or Recall temporary files. Review retained local
+data before removing it.
+
+If you need source evidence after a fork or a bounded extraction, use the
+read-only PiQ command:
+
+```sh
+npm exec -- piq entries --session /absolute/path/to/session.jsonl
+```
+
+For sidecar locks, leases, and recovery details, see [`RUNBOOK.md`](RUNBOOK.md).
 
 ## Compatibility and support
 
-This alpha supports Node 22+ and Pi 0.83.0 or later. Its Pi AI peer has no
-upper bound. The release gate runs Recall against Pi 0.83.0 and Pi 0.84.2. It
+Rarebit supports Node 22+ and Pi 0.83.0 or later. Its Pi AI peer has no upper
+bound. The release gate runs Recall against Pi 0.83.0 and Pi 0.84.2. Rarebit
 works as a deterministic CLI without a model. Summary, Title, and the Pi
 extension require a compatible Pi installation and configured provider
 credentials.
 
-Report security issues privately as described in [SECURITY.md](SECURITY.md).
-Use https://github.com/deephbz/rarebit/issues for normal support. Include no
-Session prose, credentials, or Recall files in public reports.
+Report security issues privately as described in [`SECURITY.md`](SECURITY.md).
+Use [GitHub Issues](https://github.com/deephbz/rarebit/issues) for normal
+support. Include no Session prose, credentials, or Recall files in public
+reports.
+
+## Release and source history
+
+Rarebit is released from an immutable version tag by
+[`.github/workflows/publish.yml`](.github/workflows/publish.yml). The workflow
+runs package gates, verifies one packed artifact, scans that artifact, and
+publishes it with npm provenance.
+
+The old `alpha.1`, `alpha.2`, and `alpha.3` tag graphs remain public and are not
+privacy-clean. Existing package versions, tags, and releases remain immutable.
+The source-only candidate derivation and vendored-scanner binding is
+[`release/privacy-lineage.v1.json`](release/privacy-lineage.v1.json). It is
+excluded from npm and does not claim publication completion.
+
+More detail:
 
-See [RUNBOOK.md](RUNBOOK.md) for recovery and sidecar details, and
-[VISUAL-LANGUAGE.md](VISUAL-LANGUAGE.md) for evidence-mark meaning.
+- [Visual language](VISUAL-LANGUAGE.md) defines evidence marks and Summary
+  presentation.
+- [Runbook](RUNBOOK.md) covers operator recovery and sidecars.
+- [Rarebit website](https://deephbz.github.io/rarebit) introduces the product.

package/RUNBOOK.md

@@ -1,20 +1,27 @@
 # Rarebit runbook
 
-This runbook applies to `0.1.0-alpha.6`. This candidate adds bounded fork
-flows, PiQ recovery, machine-only lineage, and Pi-native headroom checks. The
-published alpha.5 release repaired Pi 0.84.2 Summary calls. See
-[CHANGELOG.md](CHANGELOG.md) for release details.
+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.
 
 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`
 and `id`. Rarebit fails closed when it is missing or invalid. It does not use
 Pi's interactive `defaultModel`.
 
-Install or move this package to the alpha.6 pin with
-`pi install npm:@hypercarrier/rarebit@0.1.0-alpha.6`. Pi treats versioned npm
-sources as pinned, so package update commands skip it. Do not use an unpinned
-source for alpha.6 recovery: unpinned npm resolution follows `latest`, which
-remains alpha.4. Run `pi remove npm:@hypercarrier/rarebit` to
+Use `/rarebit settings` to edit the dedicated namespace. `summary_prompt`
+changes the Summary text's format and length; the evidence and structured
+status rules remain fixed. Remove the override to restore the built-in prompt.
+If a response exceeds the 8,000-character safety limit, request a shorter
+Summary in the prompt and run `/rarebit summarize` again. Oversized output
+fails explicitly instead of producing a cut-off Recap.
+
+Install or move this package to an exact version with
+`pi install npm:@hypercarrier/rarebit@<version>`. Pi treats versioned npm
+sources as pinned, so package update commands skip it. Run `pi remove
+npm:@hypercarrier/rarebit` to
 stop loading it. These commands do not modify native Sessions or remove Rarebit
 retained data.
 

package/docs/examples/rarebit.settings.json

@@ -0,0 +1,19 @@
+{
+  "rarebit": {
+    "model": "openai-codex/gpt-5.6-luna",
+    "min_total_length": 80000,
+    "max_rarebit_ratio": 0.4,
+    "auto_title": true,
+    "max_input_tokens": 64000,
+    "summary_prompt": "The summary is free-form prose. State when evidence is uncertain, confusing, contradictory, or importantly missing instead of inventing a coherent account.",
+    "diagnostics": {
+      "summary_triggered": false,
+      "summary_updated": false
+    },
+    "recap": {
+      "enabled": true,
+      "delay_ms": 60000,
+      "timezone": "host"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypercarrier/rarebit",
-  "version": "0.1.0-alpha.6",
+  "version": "0.2.1",
   "description": "Sparse, provenance-bearing conversational evidence recovery for Pi sessions.",
   "license": "MIT",
   "author": "HyperCarrier contributors",
@@ -29,6 +29,7 @@
   },
   "scripts": {
     "test": "node --test test/*.test.mjs",
+    "test:e2e:tui": "node scripts/e2e-v020-pi.mjs",
     "test:e2e:summary-cache": "node scripts/e2e-summary-cache.mjs",
     "test:e2e:recall": "node scripts/e2e-recall-pi0842.mjs",
     "test:e2e:recall:pi083": "node scripts/e2e-recall-pi083.mjs",
@@ -36,7 +37,8 @@
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": ">=0.83.0",
-    "@earendil-works/pi-coding-agent": ">=0.83.0"
+    "@earendil-works/pi-coding-agent": ">=0.83.0",
+    "@earendil-works/pi-tui": ">=0.83.0"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-ai": {
@@ -44,10 +46,14 @@
     },
     "@earendil-works/pi-coding-agent": {
       "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",
+    "@earendil-works/pi-tui": "0.84.2",
     "ajv": "^6.15.0",
     "typescript": "^5.9.3"
   },
@@ -104,6 +110,7 @@
     "bin/piq.mjs",
     "src",
     "schemas",
+    "docs/examples/rarebit.settings.json",
     "scripts",
     "test",
     "README.md",