Citations

Lumen shows every citation to a lawyer next to the source passage, and checks it against the source before the lawyer sees it. A citation that fails the check is shown as "Citation not found". Get it right the first time.

The object

{ "doc_id": "<id from lumen docs>", "a": "p3.12", "quote": "verbatim text from that paragraph" }

• a is the paragraph anchor: p<page>.<n>. Take it from lumen read or lumen search. Never compute it.
• quote is copied character for character from ONE paragraph: at most 300 characters, no "..." inside, no paraphrase, case kept.
• Quote the words that prove the claim, not the whole paragraph. 8 to 40 words is right.

Get anchors

lumen search --matter <matter_dir> --query "limitation of liability capped"   # hits: doc_id, a, snippet
lumen read --doc <doc_id> --anchor p3.12 --context 1                           # the paragraph and its neighbours
lumen read --doc <doc_id>                                                      # the whole document

Check before you finish

echo '{"citations": [{"doc_id": "...", "a": "p3.12", "quote": "..."}]}' | lumen cite check

Code	Meaning	Fix
not_found	The quote is not in the document	Copy the exact words from lumen read output
wrong_anchor	The quote is in another paragraph (fixed_anchor)	Use fixed_anchor
too_long	Over 300 characters	Quote fewer words
unknown_doc	No such document	Use a doc_id from lumen docs

lumen result write runs the same check on every citation in a result and refuses the file until each passes.

In chat answers