Skip to content

feat: add stale-doc filtering and canonical boosting for GBrain shadow retrieval #18

@100yenadmin

Description

@100yenadmin

Summary

Add cheap ranking heuristics to the GBrain shadow retrieval lane before considering heavier reranking.

Why

The first real shadow retrieval slice works, but noisy queries can surface deprecated docs. The next step should be lightweight filtering/boosting, not Voyage/Voyager reranking yet.

Add

  • downrank deprecated docs
  • boost canonical runbooks/specs
  • prefer exact title/path matches when relevant
  • keep this in shadow mode only
  • do not inject anything into authoritative Cortex paths

Explicit non-goal

Do not add Voyage/Voyager reranking in this issue. We only earn that once metadata/filtering/query shaping are good enough to justify it.

Acceptance

  • deprecated docs are less likely to outrank current canonical docs for obvious queries
  • canonical runbooks/specs get consistent preference in shadow results
  • behavior remains observe-only and separately logged

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions