Lem/Docs

citation-harvest status

Report the current harvest ledger and next stage.

Invocation#

Shell
lem-cli citation-harvest <id-or-title> status

Inputs and options#

  • id-or-title selects the paper and its citations_harvest directory.
  • status takes no documented options; the dispatcher currently ignores trailing arguments.

Output and state#

Reads the harvest manifest, extracted-text count, batches, notes, candidate and depth counts, anchor binding freshness, and recommended next command. It prints those fields as JSON and changes nothing.

A harvest record that cannot be read is named as the next thing to fix instead of being read as empty: next is “harvest state <path> cannot be read: <cause>; fix or move it before anything rebinds”, “batch plan … before anything plans again”, “harvest manifest … before anything fetches again”, “harvest notes … before anything reads again” or “manuscript <path> cannot be read: <cause>; fix or move it before anything rebinds”, in that order of precedence; notes are then counted as zero, not as unwritten work, and an unreadable manuscript is not reported as a changed one.

Refusals#

  • Paper lookup refuses an empty or unmatched selector.
  • Harvest path resolution refuses a paper with no local source directory or no main .tex manuscript.