Repository navigation
SYS REQ 033
The live-assistance system shall consume ordered evidence and return bounded local-model responses while preserving the Actor capture's active, incomplete, and terminal lifecycle states.
Epic #250 requires on-demand, periodic, and continuous agent interaction while LBA capture remains active. Actor issue #45 owns production of the active-capture read contract; ProjectBuddy issue #255 owns consuming it. Without a pinned sequenced interface and explicit lifecycle semantics, ProjectBuddy could miss/reorder evidence or mistake a partial capture for a final result.
ProjectBuddy pins and validates the Actor server identity, contract revision/digest, opaque run identity, capture state, event/frame sequence, and monotonic timestamps before using evidence. The three interaction modes share one session/privacy/resource contract and only use the approved local model digest. Bounded queues and cursors expose every gap or overflow; stale, reordered, duplicate, malformed, missing, delayed, cancelled, or over-budget data remains incomplete and cannot produce a final assessment or unapproved UI action. The system never falls back to remote inference or changes the Actor capture lifecycle. Performance/quality thresholds remain unset until reviewed calibration data is available.
TEST-127 / TEST-128 cover the offline Actor-resource and bounded-scheduler candidate; TEST-129 / TEST-130 / TEST-131 specify the still-planned native Windows packaging, relay, and live-trial gates under issue #255. The candidate consumer/scheduler is integrated in develop through PRs #256 and #258, but no native Windows live capture, inference, action, or calibration result is qualified; Vagrant inspection remains tracked by issue #257.
System-Requirements-Specification; epic #250; P2 #255
High
TEST-127, TEST-128, TEST-129, TEST-130, TEST-131
Offline Actor-stream and local-Ollama fixtures verify ordered evidence, lifecycle preservation, bounded buffering, cancellation, partial output, and incomplete/failure receipts. Native packaging, relay, and end-to-end Windows cases remain planned in TEST-129, TEST-130, and TEST-131. No live capture dataset, calibration result, or numeric threshold is claimed.
ProjectBuddy's active-capture consumer, bounded scheduler, and sealed action router are integrated as a candidate under #255 and consume the Actor #45 contract without crawling Actor storage. Native Windows packaging, host/guest relay qualification, and drained live-trial evidence remain planned in REQ-128, REQ-129, and REQ-130. Actor producer code is out of scope for this requirement.
Candidate implementation integrated; native Windows live qualification and reviewed calibration remain unproven.