Workspace of 9 crates (noxis, noxis-core, noxis-classfile, noxis-analysis, noxis-passes, noxis-runtime, noxis-jar, noxis-verify, noxis-structure-check). AGPL-3.0-only license, Rust 2024 edition, unsafe_code denied.
16 KiB
16 KiB
todo.md — план работ noxis
Обновляется по мере выполнения. Текущее состояние кодовой базы — в
docs/architecture.md (раздел «Статус»).
Обозначения: [x] готово и проверено, [~] частично, [ ] не начато,
[!] заблокировано другим пунктом.
0. Каркас и правила — готово
- Workspace:
Cargo.toml, lints (deny(unsafe_code)), release-профиль - Крейты:
noxis-classfile,noxis-core,noxis-analysis,noxis-passes,noxis-runtime,noxis-jar,noxis-structure-check noxis-structure-check: 250 строк / 4 файла, вызывается изbuild.rsкаждого крейта, сканируетsrc/+docs/cargo:rerun-if-changedна проверяемые деревья (гейт реагирует наdocs/)scripts/check.sh—check → fmt --check → clippy -D warnings → test- Документация:
docs/README,architecture,techniques,stack,learnings/{lessons,reference,priorities} - Гейт проверяет и
crates/*/tests,crates/*/benches(правило нельзя обойти выносом кода в тесты) - Лицензия:
LICENSE(MIT),Cargo.toml→license = "MIT",NOTICE.md— third-party (ristretto_classfile)
1. Данные и модель — готово
- IR:
Program → ClassFile → Code → Insn, метки вместо смещений Attribute::Raw— round-trip непонятных атрибутов- Builder + writer (без frames),
frames::compute_frames— заглушка P1 - Конфиг:
Profile,RenameConfig,StringsConfig,DebugConfig,NoiseConfig,FlowConfig; загрузка из TOML - Детерминированный PRNG:
xoshiro256+++splitmix64+ доменное разделение по FNV-1a - Маппинги классов/полей/методов + JSON-отчёт
Report/PassReport - Контракт
Pass+Context::rng(domain)
2. Анализ — готово
hierarchy: слои наследования,check::virtual_safeentrypoints:main,<clinit>, ServiceLoader,jar:fileиз manifestkeep: reflection по строкам (Class.forName,getMethod, …), fixed-члены (serialVersionUID,access_widened, JNI/native), поддержкаformat::compute_frames(stackmap), сериализация,@Override+getMethodдля стабов,record-аксессоры,enum-константы (values/valueOf/$VALUES)- Детект класса из дескриптора (
Lpkg/C;+ dotted + slash)
3. Пассы
3.1 Переименование — готово
namegen: алфавиты,builtin/english/cyrillic-стили, счётчики, запрет одинаковых имён в scope,$только если включеноrename::assign: классы в пакеты, private/static/final → Safe, virtual → семейства, widening поkeep::widen+ policyrename::rewrite: дескрипторы,LDC-классы, вызовы, поля, exception table,Signature/Exceptions/InnerClasses/MethodParametersstandard_pipeline()— каркас конвейера- Тесты: round-trip классов,
constant_valueне тронут,ACC_BRIDGE,package-info,module-info
3.2 Строки — готово
noxis-runtime::scheme:XorSplitmix+XteaCtr, salt→ключ, nonce→stream, FNV-1a MAC, roundtrip/tamper-тестыnoxis-runtime::decoder: ABId(Ljava/lang/String;I)Ljava/lang/String;- пасс
strings(passes/strings/{mod,crypt,tests}): заменаConst::String→cipher+salt+invokestatic, ротация схем поsalt % n(salt всегда неотрицателен), split на 1–3 чанка +String.concat - генератор класса-декодера (
runtime/decoder/{mod,kdf,xor,xtea}): v49 безStackMapTable, KDF через FNV+ByteBuffer, мастер какk1^k2, обе схемы побайтово зеркалят Rust - вывод мастер-секрета в рантайме (B2): части в
ldc2_w, сборка в декодере - приёмка:
runtime/tests/exec.rs— шифруем в Rust, расшифровываем настоящимjava(6 строк × 2 схемы, побайтовое сравнение stdout)
3.3 Константы — готово (int/long)
- пасс
constants(passes/constants/{mod,forms,tests}):x^k,a+b, сдвиг;ConstantsConfig{schemes, max_predicates, skip}(секция TOML) - opaque-предикаты:
(C*C+C)&1 == 0+ мёртвая ветвь изnop(константные — честно слабее против свёртки, см. ограничения) - отдельные схемы для
int/long;float/double— не тронуты
3.4 Контрольный поток — кадры готовы, схемы не начаты
- spike
ristretto_classfile 0.34— backend выбран и подтверждён (tests/spike_ristretto.rs: сборка/verify/round-trip/запись кадров) - spike по генерации кадров (
tests/spike_frames.rs): inference работает, но кадры наружу не отдаются —inference/diagnostics/frameобъявленыpub(crate), строгий режим возвращаетErr(VerifyError) - решение: кадры считаем сами на своём IR; вендор
inferenceотвергнут (14crate::-ссылок, весьverifiers/bytecode/≈ 9 700 строк, весь крейт 61 193 строки) — обоснование вdocs/stack.md§3 - реализация
format::parse/format::writeповерх ристретто (parse/{class,attrs},write/{mod,pool,attrs,code/{mod,insns,ops,frames}}; пул строится заново детерминированным обходом;tests/roundtrip.rs: минимальный класс, ветвления+handler+кадры, bootstrap — все green) SlotKindвInsn::Load/Store(тип слота терялся при parse — writer не мог восстановитьaloadvsiload); найдены пропущенныеlaload/lastore(падали с «неизвестная инструкция»)Attribute::{BootstrapMethods, EnclosingMethod, MethodParameters, ConstantValue}— ссылки пула переживают пересборку;keepлочит BSM-методы от переименования;debugрежет новые вариантыcompute_framesвместо заглушки (границы блоков, worklist, merge/LUB черезHierarchy-трейт, эмиссияStackMapFrame) (format/frames/{mod,flow,emit,tests,xfer/{mod,stack,calls},merge/{mod,descs}})- приёмка:
java -Xverify:allна фикстурах (tests/data4 класса +tests/frames.rs: снести кадры → посчитать → round-trip →javaдля JDK-классов;verify_class(Strict)для приёмки НЕ годится — backend хранит кадры в индексах, а его верификатор ждёт байты) - закрыты дыры:
I2d/I2D,Record+LocalVariableTypeTableкак явные варианты (Rawсо старыми индексами ломал чтение); кадрыAppend— на гранулярности переменных ([Top, Long]отвергает JVM) - 4 схемы:
state-spread,computed-switch,butterfly,exception-goto - ротация схем между методами + мешанина внутри метода
- только после: включение в
standard_pipeline
3.5 Шум — готово (без аннотаций)
- junk-классы +
weave_reachable(passes/noise/{mod,weave}):shadow/decoyNсrun()V, вызов вшит перед терминалом живого метода - бюджет раздувания (
junk_ratio× классы; по умолчанию 0 — выключено) - junk-аннотации: пропущены сознательно (сырые атрибуты не несут свежие индексы пула — нужно моделирование аннотаций)
3.6 Отладочная информация — готово
DebugInfoPass: stripLineNumberTable,LocalVariableTable,Signature,InnerClasses,EnclosingMethod,MethodParametersspoof_source_file— ложное, но правдоподобное имя (B4)- детерминированность подмены от мастер-сида
fake_line_numbers— ложные номера строк (не толькоSourceFile)strip_source_file— полное удаление вместо подмены
3.7 Ресурсы — частично
- крейт
noxis-jar: чтение/запись ZIP (порядок, deflate, дубликаты) strip_signatures—*.SF/*.RSA/*.DSA/*.EC,META-INF/SIG-*load/save— архив ↔Program(классы через парсер, остальное ресурсы)- пасс
resources: патч текстовых ресурсов по маппингу (boundary-замена),META-INF/services/*, 9 тестов, вstandard_pipeline fabric.mod.json,*.mixins.json, refmap, access widener
4. Верификация — не начато
- крейт
noxis-verify: красный список паттернов (хранится в репо) - утечки имён: эталонный список идентификаторов → тест падает при утечке
java -Xverify:allsubprocess на обфусцированном jar- метрики: размер, время, доля распознанных структур в декомпиляте
- бюджеты: ≤ N% размера, ≤ M% времени
- проверка стабильности между сборками (маппинги обязаны меняться)
- P3: опция
ristretto_vm(встраиваемый JVM) вместо системногоjava
5. CLI — не начато
- крейт
noxis:obfuscate,analyze,patterns - флаги конфига +
--seed(детерминированность по умолчанию) - честные off-ключи:
--no-strings,--no-flow,--no-junk, … - JSON-отчёт маппингов
6. Тесты и данные
- regression-кейсы из референса:
smoke-safe,smoke-inheritance,smoke-flow,smoke-fields,smoke-aes - встроить
.class-фикстуры вnoxis-classfile/tests/data/ - противник-скрипт (свёртка констант, regex) как тест в
noxis-verify
6.1 Fixtures — jar из /storage/project/jvm/ (найдены, не подключены)
| jar | классов | major | StackMapTable |
тип |
|---|---|---|---|---|
LoReport/build/libs/lorep-1.1.0.jar |
17 | 65 | 15 | Spigot-плагин, быстрый smoke |
hillsphere/neoforge/build/libs/hillsphere-neoforge-1.21.1-0.1.0.jar |
40 | 65 | 22 | NeoForge-мод, Java 21 |
LoParkour/build/libs/LoParkour-1.4.0.jar |
274 | 65 | 204 | Spigot-плагин, средний |
LoChat/build/libs/LoChat-1.5.5-1.20.1.jar |
1 080 | 51/52/65 | 591 | микс версий — стресс |
oc2r/build/libs/oc2r-1.21.1-neoforge-0.1.1+78704d26.jar |
1 278 | 65 | 659 | NeoForge, 28 MB (shaded) |
LoVisual/mod/build/libs/lovisual-0.1.1.jar |
4 082 | 47–69 | 2 251 | Fabric, включает major 47/49 без кадров |
- скопировать в fixtures-каталог репозитория (licenses permitting)
- прогон
load → pipeline → save → verifyнаlorepиhillsphere java -Xverify:allна каждом; для Fabric/NeoForge — толькоverify_class(запуск требует лаунчеров)
Порядок (что делать следующим)
Ремонт структуры + тулчейн— готов (08.10.2026, оценка 55/100). Гейт падал наparse/code.rs/insns.rs— разбиты; 8 латентных багов orphan-кода исправлены;stable1.97→1.99, edition→2024,toml→1.1.7; MSRV 1.97../check.sh— OK.— готов.noxis-jarПасс— готов (P0/A2/B4).debugПасс— готов (P0/A4).resourcesSpike— backend выбран, ограничение найдено.ristretto_classfile— готов (08.10.2026): классовый уровень поверх ристретто, пул с нуля,format::parse/format::write(P1)StackMapTableтуда-обратно (байтовые дельты ↔ индексные),verify()backend'а на выходе writer'а,tests/roundtrip.rs(3 теста). Снимает блокер writer'а и генератора декодера, то есть иstrings, иflow. Известные ограничения (P2):renameне переписывает ссылки внутриBootstrapMethods(имена лочатся вkeep, классы с BSM переименовывать методы не будут — безопасно, но менее мутно);Raw-атрибуты со ссылками пула (аннотации, ...) несут старые индексы — моделировать явно (Record+LocalVariableTypeTableуже смоделированы 08.10.2026) или переходить на пул-сохраняющий writer.Кадры— готов (08.10.2026): свой dataflow (StackMapTable(P1)format/frames/{mod,flow,emit,tests,xfer/{mod,stack,calls},merge/{mod,descs}},Hierarchy-трейт для LUB); приёмка —java -Xverify:allна фикстурах (tests/data4 класса,tests/frames.rs): снести → посчитать → round-trip →javaзелёный для JDK-классов.Пассы— готовы (08.10.2026): строки с декодером v49 (сквозной тест исполнением), константы int/longstrings,constants,noise- opaque, шум с вплетанием; все в
standard_pipeline. Ограничения: opaque константные (бьются свёрткой);float/doubleне шифруются; junk-аннотации пропущены;renameне правит ссылки в BSM.
- opaque, шум с вплетанием; все в
noxis-verify— метрики, красные паттерны,java -Xverify:all.noxis(CLI) — последним: он собирает всё вместе.
После каждого пункта — ./scripts/check.sh.
Долг структуры (на грани лимита, разбить превентивно)
noxis-passes/src/debug.rs— 249/250noxis-analysis/src/entrypoints.rs— 244/250docs/stack.md— 242/250noxis-passes/src/rename/{mod,assign}— 232–237/250noxis-passes/src/namegen/mod.rs— 215/250noxis-runtime/src/decoder/{xor,xtea}.rs— 243–245/250