mirror of
https://github.com/got-feedBack/feedBack.git
synced 2026-08-11 03:09:57 +00:00
514461167e
The single largest handler in server.py — the 902-line /ws/highway/{filename}
chart streamer — plus its 3 exclusive helpers (_pick_smart_arrangement,
_sanitize_authors, _sanitized_song_offset). server.py: 9,008 -> 8,003 (-1,005,
the biggest single R3 cut).
Clean move despite the size: the handler's only server-module deps are the 4
path constants + 3 exclusive helpers + app + log. Everything else it uses is
either NESTED inside the handler (_evict_audio_cache, _fill_scale_degree,
_manifest_entries, _tone_names, _xml_rank, _send_keepalives) or imported from
the shared lib modules (song/audio/sloppak/drums/notation/dlc_paths/metadata_db).
- Path constants read through the appstate seam: added static_dir /
sloppak_cache_dir / audio_cache_dir slots (config_dir already there);
server.py configures them. Bodies otherwise verbatim (@app.websocket ->
@router.websocket, PATHS -> appstate.*, log -> module logger).
- sloppak_cache_dir IS setattr-patched, so the 3 test_highway_ws_* suites now
also `setattr(appstate, "sloppak_cache_dir", ...)` next to their existing
server patch. _sanitize_authors unit tests import it from routers.ws_highway
(it moved). No other test churn.
- Removed 23 now-dead imports from server.py (song/audio/drums/notation/
bisect/contextvars/structlog/WebSocket*/_arr_smart_sort_key) — diffed against
the origin/main unused-import baseline so only NEWLY-dead ones went.
owns_tmp (assigned, never read) moved verbatim — it's pre-existing dead on
origin/main too; left as-is to keep the move faithful.
Verified: route table identical to origin/main (143, paths/methods/order);
handler body verbatim spot-checked; pyflakes clean (server has no new
undefined/dead); pytest 2400 passed; packaging guard 53; eslint 0. Boot smoke:
the highway WS streams the full chart (song_info/beats/sections/notes/chords/
notation/anchors/drum_tab -> ready) BYTE-for-byte the same message sequence as
origin/main across arrangements 0/1/2, zero tracebacks.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
67 lines
4.6 KiB
Markdown
67 lines
4.6 KiB
Markdown
# Size-exemption register
|
||
|
||
The working norm (constitution Principle II; enforced by the `max-lines` lint
|
||
gate) is **no source file over 1,500 lines**. A few files are allowed to exceed
|
||
it because splitting them would do more harm than good — hot per-frame
|
||
renderers, C++, offline generators, cohesive registries. This register is the
|
||
list of those exceptions: each row is a **deliberate, signed** decision with a
|
||
ceiling, a rationale, and a review trigger. Without it, "no file over 1,500
|
||
without a *signed* exemption" is unenforceable.
|
||
|
||
**Rules**
|
||
- One row per file: a ceiling, a rationale, a signer, a review trigger.
|
||
- The `max-lines` per-file ceilings in `eslint.config.js` mirror this table —
|
||
keep them in sync (this register is canonical).
|
||
- Files with a scheduled split **plan** are *not* exempt — they live in
|
||
"Planned, not exempt" at the bottom so nothing falls between the two states.
|
||
- **Signers** (decided 2026-07-08): **Byron** signs core + bundled rows;
|
||
**Christian** signs the authored-plugin row (virtuoso, its own repo/track).
|
||
|
||
## Permanent exemptions (structural rationale)
|
||
|
||
| Repo / file | Lines (7-07) | Ceiling | Rationale | Signer | Review |
|
||
|---|---|---|---|---|---|
|
||
| core `static/highway.js` → residual `renderer-2d.js` (post-split) | ~2,400–2,900 est. | **3,000** | 60 fps hot path; no module boundary inside the per-frame loop | Byron | after the highway.js split |
|
||
| core `plugins/highway_3d/` → residual renderer | sized at split; likely **>3,000** | set at split, flagged now | same hot-path rule; the draw core can't be cut without behavior risk | Byron | after the highway_3d split |
|
||
| core `static/capabilities.js` | 1,538 | 1,600 | cohesive registry + `window.feedBack` bus, 38 lines over; a split spends credibility for nothing | Byron | R4 |
|
||
| tutorials `builtin/reading-the-highway/generate.py` | 1,818 | 2,000 | offline content generator, never imported at runtime, deps not in runtime requirements | Byron | if a 3rd builtin pack appears |
|
||
| desktop `src/audio/NodeAddon.cpp` | 3,542 | as-is | C++, outside the ESM/routes playbooks; under active use-after-free crash work — do not churn | Byron | after crash-class work settles |
|
||
| desktop `src/audio/AudioEngine.cpp` | 2,977 | as-is | same | Byron | same |
|
||
| desktop `src/vst-host/main.cpp` | 1,928 | as-is | same | Byron | same |
|
||
| virtuoso `screen.js` (authored, own track) | 25,741 | as-is until its own split | authored plugin on a separate roadmap; migrates on its own schedule | Christian | virtuoso split kickoff |
|
||
|
||
## Split-when-touched (no scheduled train; row retires when split)
|
||
|
||
| Repo / file | Lines | Ceiling | Rationale | Signer | Review |
|
||
|---|---|---|---|---|---|
|
||
| core `lib/gp2rs_gpx.py` | 2,540 | as-is | import converter, off the serve-path hot loop | Byron | when next touched |
|
||
| core `lib/gp2rs.py` | 2,055 | as-is | same | Byron | when next touched |
|
||
| core `lib/song.py` | 1,689 | as-is | data models + wire format; cohesive | Byron | when next touched |
|
||
| core `lib/gp_autosync.py` | 1,572 | as-is | under active dev (#787/#791) — don't collide | Byron | after in-flight work lands |
|
||
| core `plugins/capability_inspector/screen.js` | 1,752 | as-is | bundled diagnostics plugin, low churn | Byron | when next touched |
|
||
| core `plugins/folder_library/screen.js` | 1,672 | as-is | bundled plugin, low churn | Byron | when next touched |
|
||
|
||
## Temporary rows (cleared by a scheduled PR)
|
||
|
||
| Repo / file | Lines | Cleared by |
|
||
|---|---|---|
|
||
| core `plugins/__init__.py` | ~2,470 (grew under R0) | the `plugins/_routes.py` + `plugins/_registry.py` split (rides the server.py router work) |
|
||
|
||
## Watch list (under the norm — no row needed, re-census each phase)
|
||
|
||
`musicxml-import/mxml2notation.py` (1,456) · core `static/capabilities/audio-effects.js`
|
||
(1,436) · `studio routes.py` (1,399) · `update-manager screen.js` (1,492 — zero headroom).
|
||
|
||
## Planned, NOT exempt (owned by split plans — listed so nothing falls between states)
|
||
|
||
core `static/app.js` (11,852) · `static/highway.js` (4,168, whole file) · `server.py`
|
||
(8,003 — was 14,037; ratcheted by the R3 `MetadataDB` + `AudioEffectsMappingDB`
|
||
extractions and five `routers/` modules) ·
|
||
`lib/metadata_db.py` (4,373 — new in R3; the `MetadataDB` class alone is 4,018 lines
|
||
and is a monolith in its own right, to be split per-table once the router train
|
||
lands) · `static/v3/songs.js` (4,134) · `static/capabilities/audio-session.js`
|
||
(2,974) · `plugins/highway_3d/screen.js` (15,656) · `plugins/keys_highway_3d/screen.js`
|
||
(3,780) · `plugins/drum_highway_3d/screen.js` (3,597) — and every monolith with a PR
|
||
train in the refactor plan. Test files (e.g. `tests/test_plugins.py`) are out of scope
|
||
by policy — the norm governs source files.
|