Lem/Docs

citation-harvest anchor

Bind a harvest to the manuscript it will be read against.

Invocation#

Shell
lem-cli citation-harvest <id-or-title> anchor [--force]

Inputs and options#

  • --force rewrites the claim-spine skeleton even when an anchor exists.
  • Without --force, a missing anchor gets a skeleton; an existing anchor keeps its prose and only has its binding header updated.

Output and state#

Writes or updates the anchor, records manuscript name, digest, label count, and bound_at in harvest state, and prints anchor, manuscript, labels, wrote_skeleton, and a note.

Refusals#

  • A manuscript with no \\label refuses with “no \\label found in <file>; nothing to bind to”.
  • An existing anchor without a complete binding header refuses rather than replacing its prose.
  • Filesystem and encoding errors are surfaced as a refusal. Arguments other than --force are currently ignored.