citation-harvest read

Invocation#

lem-cli citation-harvest <id-or-title> read [--batch <b>] [--key <k>] [--limit <n>] [--force] [--model <alias>] [--dry-run]

Inputs and options#

• --batch <b> selects one planned batch; --key <k> selects one paper. They are mutually exclusive.
• --limit <n> caps the selected calls with a positive integer. --force rereads papers that already have notes. --model <alias> overrides the configured logical route.
• --dry-run prints one exact prompt and makes no model call or credential acquisition.

Output and state#

Before a live run, acquires the Brama bearer and agent signing secret from Skarbiec once, announces scope and call count on stderr, makes one model call per selected paper, and saves state after each outcome.

The JSON summary reports model, calls, written, skipped, failed, failure detail, notes, and state. Any failed paper makes the process exit nonzero. If every selected paper already has a note, calls is zero and the command exits cleanly.

Refusals#

• --batch, --key, --model, or --limit without a value refuses with “<flag> needs a value”; a non-positive --limit is also refused.
• Using --batch and --key together refuses with “--batch and --key name different work; pass one of them”. Unknown options are refused.
• The read plan refuses an unbound, stale, or unwritten anchor, missing source text, unknown batch/key, unresolved Brama service, unavailable Skarbiec grant, transport failure, or malformed gateway response. It never substitutes an environment credential.