symfonic.memory.layers.procedural.retrieval

retrieval

Procedural selection with opt-in, per-row retrieval origin.

Origins describe how a scope query selected a row, not relevance, approval or execution authority. A shadow winner retains the origin and queried scope of its winning occurrence. Entry metadata and existing list APIs are unchanged.

ProceduralRetrievalHit dataclass

ProceduralRetrievalHit(entry: MemoryEntry, origin: Literal['cue-match', 'importance-fallback', 'empty-cue'], queried_scope_path: str)

One selected entry and its query occurrence, before/after shadow merge.