Expand description
@arch:layer(kg_store) @arch:role(substrate) @arch:see(.yah/docs/working/yah-task-runs.md)
task-runs — lossless command-output capture with a tiered observation
model (bytes → beholders → triage → shims).
Tier 1 (this crate): core types + per-camp SQLite store. Higher tiers (beholders, pruner, shims) build on top.
Re-exports§
pub use driver::DriverError;pub use driver::SpawnOpts;pub use driver::TaskDriver;pub use beholders::AttachResult;pub use beholders::Beholder;pub use beholders::BeholderFactory;pub use beholders::BeholderMode;pub use beholders::BeholderRegistry;pub use beholders::BeholderSelect;pub use beholders::CargoBeholder;pub use beholders::CargoBeholderFactory;pub use beholders::ToolVersionRange;pub use beholders::default_registry;pub use beholders::registry_with_user_beholders;pub use beholders::resolve_argv;pub use user_beholders::load_user_beholders;pub use store::AggregateBucket;pub use store::AggregateFilter;pub use store::AggregateGroupBy;pub use store::ChunkFilter;pub use store::EventFilter;pub use store::FieldFilter;pub use store::FieldIndexInfo;pub use store::GcConfig;pub use store::GcResult;pub use store::RunFilter;pub use store::StoreError;pub use store::TaskStore;pub use store::TimelineTick;pub use store::validate_field_path;pub use rule_filter::EventsRuleFilter;pub use rule_filter::FieldPredicate;pub use rule_filter::ParseError;pub use rule_filter::ScopeSpec;pub use rule_filter::TaskEventsRuleFilter;pub use types::BeholderStatus;pub use types::Initiator;pub use types::KeepRange;pub use types::OutputChunk;pub use types::RunStatus;pub use types::SeqRange;pub use types::Stream;pub use types::TaskRunMeta;pub use types::Triage;
Modules§
- beholders
- Beholder framework — observer-side parsers and rewriters for structured output.
- driver
- @arch:layer(kg_store) @arch:role(substrate) @arch:see(.yah/docs/working/yah-task-runs.md)
- rule_
filter - Parsed forms of
task-events:andevents:gnome rule check expressions. - store
- Per-camp Turso store for TaskRun bytes (Tier 1).
- types
- Core types for the TaskRun system.
- user_
beholders - @arch:layer(kg_store) @arch:role(substrate) @arch:see(.yah/docs/working/yah-task-runs.md)
Structs§
- Chunk
Ref - Back-pointer from an event into the raw byte stream.
- Diagnostic
- Normalized diagnostic shape — produced by beholders and shims where it makes sense.
Agents query
task.diagnosticsrather than parsing raw events. - Event
- A structured event row — written by beholders (Tier 1.5) or shims (Tier 2).
- Task
RunId
Enums§
- Event
Scope - The scope an event row belongs to — stored as
(scope_kind, scope_id)in scryer’s events.db so the index generalizes across all species. - Event
Source - Level
Constants§
- RESERVED_
FIELD_ PATHS - Field paths in
Event.fieldsthat have defined semantics.