pub struct TargetQueue { /* private fields */ }Expand description
A degenerate queue containing exactly one unit: the active target session.
next() returns the unit on the first call. After close() is called, or
after the unit has been returned, subsequent next() calls return None.
close() is intentionally inert: the session’s own stop hook already
emitted the termination event; the manifest is immutable; graph-node closing
and plan-stamping belong to reconcile / stamp-plan, not the loop runtime.
The active-backlog daemon is where fno backlog done runs.
See module documentation for why close() is inert.
§Why Option (not Mutex) (F8)
Queue::next/close take &mut self so no Mutex is needed here. The walk
loop is single-threaded; interior mutability would add noise without benefit.
Implementations§
Source§impl TargetQueue
impl TargetQueue
Sourcepub fn from_manifest(repo_root: &Path) -> Result<Self, LoopError>
pub fn from_manifest(repo_root: &Path) -> Result<Self, LoopError>
Read .fno/target-state.md from repo_root and construct the queue.
Trait Implementations§
Source§impl Queue for TargetQueue
impl Queue for TargetQueue
Source§fn close(
&mut self,
_unit: &Unit,
_evidence: &Evidence,
) -> Result<CloseOutcome, LoopError>
fn close( &mut self, _unit: &Unit, _evidence: &Evidence, ) -> Result<CloseOutcome, LoopError>
Inert close: see module doc for why this does nothing.
The session’s loop-check stop hook already emitted the termination event.
The manifest is immutable (ab-d0337fbc invariant). Graph-node closing and
plan-stamping belong to reconcile / stamp-plan, not the loop runtime.
The active-backlog daemon is where fno backlog done runs.