Skip to main content

Module filter

Module filter 

Source
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§

facet_keys

Structs§

FacetPredicate
Single predicate over one facet key (spec §4.2).
FilterEvaluationSummary
Aggregated filter evaluation result plus non-fatal warnings encountered while evaluating individual node projections.
FilterResult
Output of filter evaluation against a graph scope.

Enums§

FacetExpr
Composable predicate expression over node facets (spec §4.1).
FacetOperand
Operand carried by a predicate.
FacetOperator
Filter operators (spec §4.2).
FacetScalar
FacetValue
Runtime value carried by a facet key.
FilterEvalError
Error produced when a predicate cannot be evaluated.

Functions§

evaluate_filter_result
parse_omnibar_facet_token
Parse a minimal facet:key=value or facet:key (Exists check) token entered via the omnibar.

Type Aliases§

FacetProjection