Skip to content

v0.3.0: once-per-session delivery

Choose a tag to compare

@EliaAlberti EliaAlberti released this 18 Sep 13:22
· 9 commits to main since this release

Each rule and map document is now delivered once per session.

What it means for your context

Measured on the demo project (12 rules, 3 map documents, real Jev calls):

Session Loading everything up front With jev-rules
8 prompts, all about checkout about 1,390 tokens about 330 tokens
12 prompts touching nearly every topic about 1,390 tokens about 1,400 tokens

A focused session uses a quarter of the tokens, a session that touches everything breaks even, and the cost does not grow with the length of the session. The more rules a project has, the larger the gap. Jev is also asked about fewer rules as the session goes on, and not at all once everything relevant has been delivered.

Details

  • What Claude has been given is not judged or delivered again, by a prompt or by an edit. always: true rules are delivered once per session too.
  • Editing a rule's text makes it deliverable again. After /clear or a compaction everything is deliverable again (a new SessionStart hook that runs only for those two events).
  • A fail-open costs at most one full delivery per session.
  • JEV_RULES_REPEAT=1 delivers on every matching prompt, for anyone who prefers the repetition.
  • 101 offline tests.

Upgrade

claude plugin marketplace update jev-rules
claude plugin update jev-rules@jev-rules

Restart Claude Code afterwards so the new SessionStart hook is registered.