Expand description
Faceted filter expression engine.
Implements the canonical filter query model from:
repos/graphshell/design_docs/graphshell_docs/implementation_strategy/graph/faceted_filter_surface_spec.md §4
§Authority contract (spec §2)
- Filter truth is derived from graph-owned node/edge metadata.
- Evaluation runs through reducer-owned intent paths.
- Filter output is a projection over graph truth — it never mutates node/edge identity.
§Namespaced extension keys (spec §3)
Canonical PMEST facet keys (see FacetKey constants) are non-namespaced.
Extension facets must use "namespace:name" format. Non-namespaced
extension keys are invalid and must emit a Warn diagnostic at evaluation
time.
Modules§
Structs§
- Facet
Predicate - Single predicate over one facet key (spec §4.2).
- Filter
Evaluation Summary - Aggregated filter evaluation result plus non-fatal warnings encountered while evaluating individual node projections.
- Filter
Result - Output of filter evaluation against a graph scope.
Enums§
- Facet
Expr - Composable predicate expression over node facets (spec §4.1).
- Facet
Operand - Operand carried by a predicate.
- Facet
Operator - Filter operators (spec §4.2).
- Facet
Scalar - Facet
Value - Runtime value carried by a facet key.
- Filter
Eval Error - Error produced when a predicate cannot be evaluated.
Functions§
- evaluate_
filter_ result - parse_
omnibar_ facet_ token - Parse a minimal
facet:key=valueorfacet:key(Exists check) token entered via the omnibar.