Fold planned subject viewpoints against current observation receipts.
Observations arrive as unknown at the evidence boundary, so a frame
receipt, a malformed payload or another subject's view is counted as
foreign without being cast into subject coverage. A well-formed view of
this production, shot and subject is then sorted by its viewpoint and
context: a planned viewpoint observed in the current context is observed
once and counted as a duplicate after that; a planned viewpoint seen only in
another context is stale; an unplanned viewpoint in the current context is
unplanned, and one in another context is foreign. Plan order is kept for
every planned list, unplanned is sorted by code unit, and the order of the
observations cannot change the result.
The state is indeterminate for an empty plan, reviewed when every
planned viewpoint is observed, partial when some are, stale when none is
observed but some were seen in another context, and not-run otherwise.
Throws an Error when current does not exactly name the resolved unit
(blank production id, shot or runtime identity, a target or revision
differing from the unit, or a fingerprint or plan identity not in sha256:
hex form), and a RangeError for a plan with a blank or duplicated
viewpoint id, a distance that is not finite and positive, or a direction
whose length is not within 1e-6 of one.
Fold planned subject viewpoints against current observation receipts.
Observations arrive as
unknownat the evidence boundary, so a frame receipt, a malformed payload or another subject's view is counted asforeignwithout being cast into subject coverage. A well-formed view of this production, shot and subject is then sorted by its viewpoint and context: a planned viewpoint observed in the current context isobservedonce and counted as a duplicate after that; a planned viewpoint seen only in another context isstale; an unplanned viewpoint in the current context isunplanned, and one in another context isforeign. Plan order is kept for every planned list,unplannedis sorted by code unit, and the order of the observations cannot change the result.The state is
indeterminatefor an empty plan,reviewedwhen every planned viewpoint is observed,partialwhen some are,stalewhen none is observed but some were seen in another context, andnot-runotherwise.Throws an
Errorwhencurrentdoes not exactly name the resolved unit (blank production id, shot or runtime identity, a target or revision differing from the unit, or a fingerprint or plan identity not insha256:hex form), and aRangeErrorfor a plan with a blank or duplicated viewpoint id, a distance that is not finite and positive, or a direction whose length is not within1e-6of one.