Skip to main content

Module engine

Module engine 

Source
Expand description

Query-engine entry point and module map.

engine::execute takes a loaded workspace, its validated task graph, the bearing project (if any), and a typed spec::QuerySpec covering every filter family (QRY-003 per-attribute, QRY-004 relational, QRY-005 boolean shortcuts), and returns the matching tasks’ TaskIds in canonical (ProjectName, TaskName) order per QRY-007.

execute_non_relational is a convenience wrapper that uses an empty graph; it is appropriate only for specs that contain no relational filters.

Modules§

candidate
Candidate-set computation per QRY vocabulary.
filter
Per-task evaluation of the non-relational filters of QRY-003 and QRY-005.
relational
Per-task evaluation of the relational filters of QRY-004.
spec
Inputs and errors of the query engine.

Functions§

execute
Run the engine against a workspace and return the matching task identities in canonical (ProjectName, TaskName) order.
execute_non_relational
Convenience wrapper for execute for specs that contain no relational filters. Passes an empty graph; if any relational filter is set on spec, that filter’s target set will be computed but the relation check will always fail (no edges to traverse), producing zero matches. New code SHOULD use execute directly.