Keeper care

In plain words: Keeper: care records and yields

Designed 2 min read 6 connected pages
The short version written for the Snayu team

How Keeper records care that was done (feeding, cleaning, transfers) and collected material like eggs or milk as yield receipts for Homestead stores.

Why read it: Read when building care logs or yield handoff to stores.
  1. 1Intended and actual care are recorded together.
  2. 2A lost acknowledgement never justifies repeating care.
  3. 3Yield receipts give no food-safety verdict; duplicates add no stock.
The original text Underlined words open their plain-English card.

A missed due window is unfinished care, even when its reminder has expired. keeper.record_care@1 records KeeperCareEvent@1 and KeeperCareResult@1, with an optional KeeperYieldReceipt@1 for confirmed collected material.

Record what happened

For feeding completion, water inspection, cleaning, confirmed transfer, appointments, or other care, record what was intended alongside what happened. Preserve the subject and placement references, due window, actor, effective and recorded times, evidence, uncertainty, and outcome. If professional instructions guided the work, link their exact reference and version. Recording them does not broaden their authority: clinical diagnosis and treatment decisions remain with the external professional.

Physical work belongs to a human or separately admitted owner. Local controller safety wins. Distinguish proposed, confirmed, partial, missed, cancelled, interrupted, and unknown-effect work. A lost acknowledgment cannot justify repeating feeding, cleaning, or a transfer. Reconcile the effect and exact event identities first; record unresolved effects explicitly.

Receive collected material

A yield receipt records confirmed eggs, milk, or other collected material with source individual or group, collection-event identity and revision, actor, effective and recorded times, material, quantity and units, condition and uncertainty, and disposition. A hen group can remain a durable subject while successive collections produce separate receipts. Neither birth nor death automatically creates a product or stock lot.

Homestead separately accepts exact sourced lots, referencing the receipt. Keeper's collection record supplies no food-safety or consumption verdict and does not equate collection with acceptance into stores. Duplicate receipt delivery cannot create another collection or stock lot. Amendments preserve the original collection identity and trigger an explicit stock adjustment against prior acceptance.

Finish or hand off

Close the invocation with the confirmed result, named partial completion, refusal, blockage, or unresolved physical effect. A care schedule can identify future work after this invocation ends. On restart, recover its settled result and reconcile pending effects before retrying.

Deletion also requires attention to unfinished care. Stop schedules and disclosure, then reconcile or hand off pending obligations before authorized erasure. The animal's custody and welfare obligations remain even when records are removed.


Keeper · Composition portfolio