Research becomes a tree, and the citator says what it is

↗ view on GitHub · Eli Ziff · 2026-07-31 · 14b7b376

SHAPE, from the progressive-disclosure literature: a flat catalogue wins
while it is small -- no navigation hop, no semantic noise -- but its token
cost grows near-linearly and its accuracy degrades as the catalogue grows,
where a hierarchy stays flat on both. Research is where that bites here, at
half the deferred tools, so research is a tree and every other domain stays
one level.

  research                -> opens onto its children, not onto tools
  research.cases          -> the case tools + the citator
  research.legislation    -> the statute tools + Hansard
  research.commentary     -> journals, secondary sources, citation verification

Opening a parent returns `open_next` with each child and what it covers, so
the model narrows in one cheap turn. The A2AJ tools serve both halves of
primary law and appear under either leaf.

THE CITATOR NOW DESCRIBES ITSELF. It said "Note up a Canadian case citation
against the locally built citator graph" -- a verb the model has to already
know to want. It now states the capability: a local graph over 224,970
Canadian decisions, 2,541,822 citation edges naming 540,948 distinct cited
decisions, built offline with no network call, returning the decisions that
cite a given one with the citing court's own words, the paragraph the
citation appears at, and the pinpoints it cited into -- and stating plainly
that it records citation OCCURRENCE, not editorial treatment, so there are no
followed/overruled labels to mistake it for.

The reason to describe rather than instruct: the edit benchmark measured the
`amendment` domain being opened five times and called from zero, because its
blurb attracted renumbering tasks it could not do. Blurbs are doing routing
work, and a verb-shaped one routes on the wrong thing.

1,251 tests pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H9ToHYJVDxfeJcJwdzrP2H
Repository eliziff/Beaver
Author Eli Ziff <eliasziff@gmail.com>
Authored
Parents b82c4d66
Stats 2 files changed , +73 , -29
Part of Citator: note-up graph and attested case characterizations

Capture this commit into my fork

Download a Markdown prompt that tells Claude how to port this exact commit into your working tree. Run it via claude -p < capture-commit-14b7b376.md from inside the repo you want the change in.

⬇ Download capture-commit-14b7b376.md