docs: full documentation refresh post-24kk2 — README status (application decoded to formulas, dual 0.193), AGENTS phase header + env-flags/tools tables, NEXT_PROMPT rewrite (cascade simulator + campaign recipes), PLAN/roadmap gate=BIT EXACT decision recorded

This commit is contained in:
2026-08-25 12:18:32 +03:00
parent 0fee9238dc
commit f365fa8451
5 changed files with 175 additions and 95 deletions
+49 -12
View File
@@ -4,18 +4,25 @@ Bit-exact реверс DSP-ядра oeksound soothe2 (VST3) → транскри
Полное журналирование — в `handoff/NOTES_LEVEL.md`, `handoff/NOTES_TWIN.md`,
`handoff/NOTES_CAPTURE.md`, `roadmap.md`.
> **Текущая фаза (2026-08-24, после 24t):** ПРИМЕНЕНИЕ ДЕКОДИРОВАНО ФОРМУЛАМИ:
> аудио = побиновное умножение кадра на маску `10^(cut_D/20)`,
> `cut_D = α·ln1p(lvl_raw/β)+c` (+Δ у вторых пиков), калибровка dual-семейства
> (q=0.5,sens=12): α=3.2193 β=0.4927 c=0.54 Δ=+6.92, rms 0.016 дБ.
> lvl_raw — НАШ детектор-фронтенд (float-parity ✓). RT_VLAW v3 в коде (env-gated):
> dual end-to-end 9.47/11.16 vs реф 10.32/11.82; корпус dual 0.708 (было 3.264).
> Буфер FIR@540668 = промежуточное мин.-фазовое представление (exp(s−iH(s)),
> Гильберт по частоте) — для транскрипции не нужен. Остаток −0.85 дБ = слой
> STFT render48k (окно симметричное vs периодическое?, hop, нормировка).
> Открыто: параметризация α/β/c/Δ по q/sens/fc (датасеты sc_* готовы),
> правило вторых пиков из декомпа, ops A–D (опционально). Журнал: NOTES_LEVEL
> 24j24t; карта: handoff/BLOCKMAP_529fe0.md. ЭТОТ ФАЙЛ ЧИТАЙ ПЕРВЫМ.
> **Текущая фаза (2026-08-25, после 24kk2):** ПРИМЕНЕНИЕ ДЕКОДИРОВАНО ФОРМУЛАМИ:
> аудио = побиновное умножение кадра на вещественную маску `10^(cut_D/20)`,
> `cut_D = α·ln1p(lvl_raw/β)+c` (+Δ у вторых пиков). Калибровки (rms ≤0.016 дБ):
> dual(q0.5,s12,2 тона)=3.2193/0.4927/+0.54; fc1000(1 тон,q0.5)=1.6151/0.3645/+0.48;
> fc500(1 тон)=1.1530/0.4038/+0.33. lvl_raw — НАШ фронтенд (float-parity ✓).
> Слой STFT = БЕЗ синтез-окна (`RT_SYN=1`). **dual-корпус 0.193 max 0.438**
> (канон 3.264); канон TOTAL 2.286 нетронут. ГЕЙТ СМЕНЫ КАНОНА = BIT EXACT
> (решение пользователя: все параметры прослежены до декомпа + шумовой пол корпуса).
>
> Ключевые факты: q НЕ влияет на закон (доказано 24kk); sens линейно через
> lvl_raw; далёкий контент не влияет — смешение шаблонно-локальное (24ll);
> аудио = exp(deepest-scratch)+const; буфер FIR@540668 = мин.-фазовое
> представление (exp(s−iH(s))) — не для транскрипции. Тела bigkernel'ов:
> 1803a06a0/180296c80/180323f20/1802dc0e0 (x87 exp-семейство, 24jj).
>
> ОСТАТОК: каскадный симулятор шагов 9–19 по dataflow (24hh/24ii) →
> параметризация α(контент)/fc через campaign.py (датасеты готовы) →
> Δ-правило из pre-combine → полный корпус. Журнал: NOTES_LEVEL 24j24kk2;
> карта метода: handoff/BLOCKMAP_529fe0.md. ЭТОТ ФАЙЛ ЧИТАЙ ПЕРВЫМ.
## Золотое правило (обязательно)
1. **Цель — bit-exact реверс кода**, НЕ эмпирическая подгонка кривых. Каждый параметр
@@ -141,6 +148,36 @@ scale → LUT level-domain (t^γ·MULT, γ=0.344 decomp / MULT=4.2 placeholder)
- `scripts/resalpha.py` — сбор трактов + теорема об отсутствии α (22x).
- `scripts/dualtrace.py` + `play_loop.lua` — живой захват ctx при realtime-playback (22y).
## Env-флаги экспериментов (24j–24kk2)
| флаг | действие |
|------|----------|
| `RT_VLAW=1` | закон применённой стадии: mask=10^((α·ln1p(lvl/β)+c)/20) |
| `RT_SYN=1` | STFT БЕЗ синтез-окна (найденный слой плагина) |
| `RT_WIN=0/1/2` | окно анализа: sym-hann / periodic / rect |
| `RT_NOWARP=1` | отключить warp-модуляцию маски |
| `RT_NOIIR3=1` | отключить IIR3 ×2 |
| `RT_IIR12=0` | отключить частотные IIR1/2 (КРИТИЧНО с RT_VLAW — иначе размывают дипы) |
| `RT_DUMP_BIN=<f>` (+`RT_DUMP_FRAME=N`) | дамп тракта бина N: am/res/lvl_raw/band_level/prewarp/w |
| `RT_VDBG=1` | stderr-печать vlaw-вычислений |
Полный набор dual-решения: `RT_VLAW=1 RT_SYN=1 RT_NOWARP=1 RT_NOIIR3=1 RT_IIR12=0`.
## Инструменты сессии 24j–24kk2
| скрипт | назначение |
|--------|-----------|
| `scripts/rendersnap2.py <rpp> [cap] [outdir]` | мягкий STOP-снаппер: слоты FIR/scratch/bands/R + скалярный банк + t_snap; НЕ убивает reaper; RENDER_FILE из rpp (не удалять чужие рефы!) |
| `scripts/campaign.py <base> <fc> <q> <sens> <in_prefix> <drives> <out>` | ячейка параметризации: клоны rpp+рефы (~8 мин) |
| `scripts/disasm_func.py <VA> [len]` | capstone-дизасм с инлайн-резолвом RIP-констант |
| `scripts/iat_name.py` | рантайм-резолв импортов bigkernel'ов через PE-экспорты (SIGSTOP!) |
| `scripts/probe_states.py` / `probe_mem.py` / `dump_dispatch.py` | живые state-заголовки / память / таблицы диспатча |
| `scripts/hunt2.py` | перебор всех ctx-инстансов |
| `scripts/scan_pairs.py`, `scan_lutsub.py` | диагностика памяти по сигнатурам float-пар |
Датасеты кампании: `/tmp/opencode/sc_{q,sens,qmap,k,f,d}*` + `tract_*` +
`{level_pairs,f_series,q_series,k_series}.pkl/.npz` (см. NOTES 24bb24kk2).
## Чистая работа
- Не коммитить: `*.bin`(дампы 112М), `*.wav/rpp`, `*.log`, `dsp/build/`, `ghidra-proj/`,
`dl/lib/bin/include/`, `regions*/`. См. `.gitignore`.