Nick
16c5150a9c
Baseline {BLE001: 351, S110: 79} (was 455/117): 103 handlers in
memory_store.py, warm_router.py, curator.py, tool_executor.py now log
tracebacks via logger.debug(.., exc_info=True) or carry reasoned
# noqa: BLE001 (warm_router P0-06 record_failure paths). Ledger table
regenerated from the live tree; Completion Record appended to the plan.
68 lines
2.8 KiB
Markdown
68 lines
2.8 KiB
Markdown
# Silent-handler debt ledger (#126)
|
|
|
|
_Tracked, not silent — the repo's doctrine for known debt (same pattern as
|
|
`module-coverage-debt.md` and the pyright baseline). The lint ratchet
|
|
(`scripts/lint_ratchet.py`, wired into the CI lint job) counts S110
|
|
(try-except-pass) and BLE001 (blind `except Exception`) over `src/`,
|
|
`shared/`, `scripts/` and fails when any count exceeds `lint-baseline.json`._
|
|
|
|
**Rule: this ledger only shrinks.** A handler leaves the ledger by becoming
|
|
compliant: re-raise, or log the traceback (`.exception()` / `exc_info=True` —
|
|
BLE001's built-in exemptions ARE the compliant-handler spec), or carry
|
|
`# noqa: BLE001 — <reason>` where silence is genuinely intentional (e.g.
|
|
best-effort cleanup, or the failure already routes through a designed
|
|
observable channel such as `subsystem_health.record_failure`). New silent
|
|
handlers fail CI; the baseline may never be raised to admit new debt.
|
|
|
|
T201 (print) was measured during the #126 sweep (1625 hits) but is out of the
|
|
handler-visibility scope and is NOT enforced.
|
|
|
|
## Mechanism
|
|
|
|
`lint-baseline.json` is the machine ledger ({BLE001, S110} counts);
|
|
`tests/test_ci_lint_contract.py::test_lint_baseline_matches_current_tree_counts`
|
|
pins it to reality, so every fix must lower the baseline in the same commit.
|
|
|
|
## Remaining debt (as of 2026-09-07, post-#126 — BLE001 351 / S110 79 = 430)
|
|
|
|
Paid this PR (#126): `memory_store.py`, `warm_router.py`, `curator.py`,
|
|
`tool_executor.py` (142 handler sites — the four core non-TUI files; 3 of
|
|
warm_router's P0-06 `record_failure` handlers carry reasoned
|
|
`# noqa: BLE001` instead).
|
|
|
|
Still ledgered (top first, per-file S110+BLE001 counts):
|
|
|
|
| File | Count |
|
|
| --- | --- |
|
|
| src/rune/rune_tui.py | 125 |
|
|
| src/rune/rune_operator.py | 23 |
|
|
| src/rune/sleep_time.py | 19 |
|
|
| src/rune/memory_consolidation.py | 15 |
|
|
| src/rune/work_manager.py | 12 |
|
|
| src/rune/canary_tui_drift.py | 10 |
|
|
| src/rune/auto_context.py | 8 |
|
|
| src/rune/provider_registry.py | 7 |
|
|
| src/rune/night_mode.py | 7 |
|
|
| src/rune/growth_delta.py | 7 |
|
|
| src/rune/contracts.py | 7 |
|
|
| src/rune/system_registry.py | 6 |
|
|
| src/rune/skills/llm-craft/update.py | 6 |
|
|
| src/rune/local_tool_runtime.py | 6 |
|
|
| src/rune/complexity_scorer.py | 6 |
|
|
| src/rune/capability_broker.py | 6 |
|
|
| src/rune/voicebox.py | 5 |
|
|
| src/rune/self_improve.py | 5 |
|
|
| src/rune/provider_budget.py | 5 |
|
|
| src/rune/persona_gate.py | 5 |
|
|
| src/rune/model_profiles.py | 5 |
|
|
| src/rune/drift_ledger.py | 5 |
|
|
| src/rune/canary_unbounded.py | 5 |
|
|
| src/rune/canary_query_memory.py | 5 |
|
|
| 39 further src/rune files | 81 |
|
|
| shared/ + scripts/ | 40 |
|
|
|
|
`rune_tui.py` is the largest block and is deliberately deferred from #126:
|
|
#139 just landed there and TUI handlers need UX-level judgement, not a
|
|
codemod. Every PR that pays handlers down must lower `lint-baseline.json` and
|
|
remove rows from this table in the same commit.
|