All notable changes to the JARPA plugin are recorded here.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Statusline percentage was reading the rate-limit value, not context
usage. The payload exposes
used_percentageunder bothcontext_windowandrate_limits.*, and the greedy JSON extraction picked the last match. Two side effects: the displayed percentage was wrong (e.g., 16% instead of 3%), and all sessions on the same account showed the same value because rate limits are global. The payload is now trimmed beforerate_limitsto scope the extraction tocontext_window.
- Statusline now shows accurate context usage. The percentage is read
from Claude Code's real
context_window.used_percentageinstead of a rough transcript-size heuristic. Fallback heuristic retained for forward-compatibility. - Model name displayed in statusline. Format is now
<model> · JARPA <gauge> <pct>% ctx <label>. - JARPA context budget decoupled from model window. Set
JARPA_CONTEXT_TOKENS(e.g.,250000) to trigger warnings before the full model context is exhausted. The displayed percentage still reflects the model's real usage so the user can calibrate the budget. - Statusline auto-configured on first session start. No longer requires
/jarpa:initor manual setup — the SessionStart hook installs it in.claude/settings.jsonautomatically.
- Context-window monitoring. A statusline shows live context usage with warning/critical thresholds.
/jarpa:initnow seeds your project'sCLAUDE.mdwith the core JARPA rules./jarpa:upgradecommand. Upgrades your project'sjarpa/files when the plugin's on-disk format evolves.coherence-validatoragent (opt-in, advisory). Checks that your fivejarpa/files stay consistent with each other. Read-only.session-revieweragent (opt-in, advisory). Reviews recent journal entries for scope drift and retrospective insights. Read-only.
- No more Python dependency. The context-monitoring MCP server is now
pure bash. Installing JARPA no longer requires
python,pip, orjq. - More reliable session protocol in multi-project repos. Session
workflows stay focused on your top-level
jarpa/logbook instead of wandering into sub-projects. - Safer journal archiving. The archiver no longer treats an unparseable
JOURNAL.mdas empty. - Settings simplified. A few unused options were removed from
.claude/jarpa.local.md.
/jarpa:migratecommand. Legacy pre-plugin workflow, now gone.
- Your existing projects keep working. Files created by
0.1.0are treated as format version 1;/jarpa:upgradecan add the explicit format marker on demand.
First public release. See git log c0dfd16 for the shipping commit.