Skip to content

docs: relevance floor + silent-vs-always contract spec (#289) - #295

Merged
robotrocketscience merged 1 commit into
mainfrom
docs/issue-289-relevance-floor-spec
Apr 29, 2026
Merged

docs: relevance floor + silent-vs-always contract spec (#289)#295
robotrocketscience merged 1 commit into
mainfrom
docs/issue-289-relevance-floor-spec

Conversation

@robotrocketscience

Copy link
Copy Markdown
Owner

Summary

Spec memo for #289. Phase-2a of the #286 redesign — the gating contract change so rebuild_v14() can return empty when no candidate clears the floor. Doc-only — no code change. Posted for ratification.

Five recommendations:

  1. Yes — add a silent path. All-floored-out → "". No empty-marker tag.
  2. Composite score formula. bm25_normalized * (0.5 + 0.5 * posterior_mean). Posterior-mean weighting prevents stale-but-token-overlapping beliefs (the 1bc8ab45a40351d9 example in Context rebuild surfaces duplicate + off-topic beliefs; ranking has no relevance floor or output-dedup #281) from passing.
  3. Three-tier per-lane floors. L0 locked = no floor (operator intent dominates). L2 session-scoped = soft floor T_session = 0.10. L1 / L2.5 = hard floor T_l1 = 0.40.
  4. No last_retrieved_at stamp on floored-out hits. Stamp moves to after floor application; floored-out beliefs never reach the stamp loop. Protects the hibernation staleness signal (v2.0 substrate decision: multi-axis vs single-axis uncertainty #196).
  5. Ship with placeholder T defaults; calibrate from Rebuild redesign: eval harness — per-rebuild log + fixed-corpus precision #288 logs. Floor value blocks on Rebuild redesign: eval harness — per-rebuild log + fixed-corpus precision #288 eval harness data; floor shape lands in v1.x with operator-tunable [rebuild_floor] config.

Decision asks (five)

Bottom of the memo. Composite formula, per-lane structure, empty-path shape, stamp ownership, calibration plan.

What ships if ratified

One PR (~400 lines):

  • rebuild_v14 composite + floor + empty-path return
  • hook.py precompact-envelope drop on empty
  • hook_search.py stamp move (only survivors get stamped)
  • [rebuild_floor] config block + tests

Test plan

Refs #289, #286

@robotrocketscience robotrocketscience added the author-Setr PR coordination mutex label Apr 29, 2026
@robotrocketscience

Copy link
Copy Markdown
Owner Author

[claim:review:Gylf:2026-04-29T02:28:35Z]

@robotrocketscience
robotrocketscience merged commit e6329fd into main Apr 29, 2026
8 checks passed
@robotrocketscience
robotrocketscience deleted the docs/issue-289-relevance-floor-spec branch April 29, 2026 02:29
@robotrocketscience

Copy link
Copy Markdown
Owner Author

[release:review:Gylf:2026-04-29T02:29:07Z]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author-Setr PR coordination mutex

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant