# Requirements Archive: v2.1 L2 Real-Topic Relevance Hardening

**Archived:** 2026-04-14
**Status:** SHIPPED

For current requirements, see `.planning/REQUIREMENTS.md`.

---

# Requirements: v2.1 L2 Real-Topic Relevance Hardening

## Milestone Goal

Make fresh real-topic `L2` staging and consultation trustworthy enough that
newly ingested literature surfaces the right local knowledge with correct
provenance instead of noisy staged rows or irrelevant primary hits.

## Active Requirements

### Staging Quality

- [x] `L2H-01`: literature-intake staging suppresses generic notation tokens
  and weak method rows that do not represent reusable knowledge.

- [x] `L2H-02`: every staged row preserves the true source id of the paper or
  note it came from, even when multiple related papers are registered into the
  same topic.

### Retrieval Relevance

- [x] `L2H-03`: `consult-l2` can rank topic-local relevant staged or canonical
  entries above unrelated canonical material when the query clearly targets a
  fresh local topic.

### Replayable Proof

- [x] `L2H-04`: one replayable real-topic acceptance lane registers multiple
  related papers into one topic and proves both provenance correctness and
  consultation relevance ordering.

- [x] `L2H-05`: the milestone closes with durable receipts, a runbook, and
  explicit non-claims about what `L2` hardening this bounded slice does not yet
  solve.

## Out of Scope

| Feature | Reason |
|---------|--------|
| Fixing fresh-topic `session-start` misrouting | important front-door regression, but keep `v2.1` bounded to `L2` hardening first |
| Windows long-path source registration and immediate status-sync repair | separate first-use / L0 surface hardening slice |
| Broad benchmark-alignment schema overhaul (`999.87`–`999.92`) | too wide for the first post-`v2.0` bounded milestone |
| Widening any of the formal, toy-model, or first-principles science claims | `v2.1` is about `L2` quality, not new scientific closure |

## Traceability

| Requirement | Phase | Status |
|-------------|-------|--------|
| L2H-01 | Phase 175 | Done |
| L2H-02 | Phase 175 | Done |
| L2H-03 | Phase 175.1 | Done |
| L2H-04 | Phase 175.2 | Done |
| L2H-05 | Phase 175.2 | Done |

**Coverage:**
- v1 requirements: 5 total
- mapped to phases: 5
- unmapped: 0
