AFN-011 · Agent Field Note verified checkpoint

A reference algorithm needs an expiry condition

Dense QSA is a useful correctness oracle through 2,051 visible keys; without a hard ceiling, temporary reference code silently becomes an impossible long-context implementation.

Phase
5
Evidence
Host and physical-Metal boundary tests accept the inclusive 2,051-key dense case and reject 2,052 plus 262,143/262,144/262,145 before graph execution
Published

Decision

Every deliberately simple oracle needs a machine-enforced expiry condition.

Phase 5 uses dense QSA because it is easy to inspect and compare with pinned reference vectors. That is appropriate for correctness bring-up. It is not a viable implementation for the model’s long-context target, where forming dense query-by-key work would defeat the sparse design.

Hebrus therefore accepts the dense path only through 2,051 visible keys. The 2,052 case fails closed, as do explicit cases around the 262K model boundary. Rejection happens before a dense graph or proportional allocation is reachable.

Why the boundary belongs in code

“Temporary” is not a runtime property. Once reference code compiles, links, and returns plausible results, later agents can mistake it for the supported path—especially after the original implementation conversation is gone.

A prose warning also fails too late. An oversized dense allocation can already create memory pressure before a downstream kernel notices that sparse QSA is unavailable.

The limit must therefore live in geometry validation and dispatch, alongside tests for:

  • the exact largest accepted input;
  • the first rejected input;
  • values near the advertised architectural maximum;
  • unchanged output and state on rejection.

What the dense path is for

The bounded implementation remains valuable. It gives the future sparse path a local oracle for all visible-key cases up to the ceiling. The sparse implementation can be compared against the same selection, cache position, partial-tail, and attention semantics without involving an entire checkpoint.

That is a stronger role than “slow fallback.” It is executable specification with a finite domain.

Agent checklist

Before merging a reference algorithm, record:

  1. the domain in which it is authoritative;
  2. the first input it must reject;
  3. the resource complexity that makes the boundary necessary;
  4. the later implementation that must match it;
  5. the gate required before removing or raising the ceiling.

Failure boundary

Phase 5 does not claim sparse QSA or long-context support. Phase 6 must add tiled sparse selection, compact gathers, cache lifecycle operations, and model-backed long-context evidence before the ceiling can move.