Skip to content

Retrieval

Advanced Retrieval Status

Understand Origin's shipped retrieval path and the opt-in main-branch experiments behind newer retrieval work.

Qi-Xuan LuUpdated 6 min read

At a glance

01

The stable public path is hybrid retrieval over embeddings, FTS5, pages, and graph context.

02

Recent main-branch PRs add many opt-in retrieval experiments; treat them as evaluation work until a release promotes them.

01

Stable retrieval path

Origin's released retrieval combines vector embeddings, FTS5 full-text search, graph context, pages, and Reciprocal Rank Fusion. The goal is not a single magic ranking signal; it is a compact context bundle that helps the next AI session continue work.

The public README snapshot reports retrieval metrics, not end-to-end answer quality. Read the evaluation page before using the numbers in comparisons.

02

Pages are part of retrieval

Origin treats distilled pages as retrieval surfaces, not only as human-readable notes. That matters because repeated project context often becomes clearer as a page than as isolated captures.

A useful recall can include atomic memories, source-backed pages, graph neighbors, and decisions. The best result set is the one that gives the agent enough context without replaying a full chat history.

03

Opt-in main-branch work

After v0.7.0, main received a large opt-in retrieval batch. Examples include graph gates, temporal filters, query-adaptive routing, FTS hardening, session diversity, salience priors, episode and fact channels, PRF rounds, k-hop graph traversal, global preludes, CoT retrieval, LLM routing, and context compression.

These flags are useful for development and evaluation, but they should not be described as default product behavior until the release notes say so.

Example opt-in flags

ORIGIN_ENABLE_GRAPH_GATE
ORIGIN_ENABLE_GRAPH_SEED
ORIGIN_ENABLE_TEMPORAL_FILTER
ORIGIN_ENABLE_QUERY_INTENT
ORIGIN_MAGNITUDE_FUSION
ORIGIN_ENABLE_FTS_HARDENING
ORIGIN_ENABLE_SESSION_DIVERSITY
ORIGIN_ENABLE_SALIENCE_PRIOR
ORIGIN_ENABLE_EPISODE_CHANNEL
ORIGIN_ENABLE_FACT_CHANNEL
ORIGIN_PRF_ROUNDS
ORIGIN_ENABLE_GRAPH_KHOP
ORIGIN_ENABLE_GLOBAL_PRELUDE
ORIGIN_ENABLE_COT_RETRIEVAL
ORIGIN_LLM_ROUTE
ORIGIN_ENABLE_CONTEXT_COMPRESS

04

How to read experiments

A retrieval experiment can improve one benchmark slice and hurt another. Origin's eval discipline is deliberately conservative: compare under the same schema, fixture revision, embedder, and run protocol.

When a feature is opt-in, the docs should say which problem it targets and which release status it has instead of implying it is the normal user path.

05

When to care

Most users should care about whether /brief, context, and recall bring the right project facts forward. Maintainers should care about benchmark slices, regression guards, and whether new retrieval work reduces real cold starts.

If recall feels weak, first improve the query and capture quality. Then distill repeated topics into pages before reaching for experimental retrieval flags.

Next

Experimental Flags

How to read Origin's opt-in main-branch flags without mistaking them for released defaults.

Read next