Skip to content

feat(error)!: полные координаты ошибок и corpus 0.9 - #19

Merged
PHPCraftdream merged 2 commits into
mainfrom
error-model-09
Oct 25, 2026
Merged

PHPCraftdream merged 2 commits into
mainfrom
error-model-09

Conversation

@PHPCraftdream

@PHPCraftdream PHPCraftdream commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

Назначение

Подготовка 0.9.0, включая обе доработки: уже влитое в main редактирование исходного текста по пути (edit_value / edit_value_segments) и новую модель координат ошибок. Ветка основана на merge PR #18. Это не публикация релиза.

Fixes #15.

Breaking Rust API

  • Error::InvalidUtf8 { valid_up_to, line, span }: исходная строка и непустое покрытие malformed UTF-8 вычисляются до грамматического разбора.
  • ErrorKind::UnclosedCompound { kind, line, span }: innermost opener..EOF, строка opener. Producers owned/thin/formatter сохраняют контекст непосредственно в ошибке.
  • Downstream-конструкторы и полные field patterns требуют миграции; это намеренный minor break 0.9.0, не patch-compatible исправление.
  • Общий raw-byte location helper для from_file, C ABI, Span::line_col и envelope line_text. Учитываются исходные BOM/LF/CR/CRLF, без нормализации offsets. Исправления координат только внутри ABI-обёртки больше не нужны.
  • Ten-field JSON envelope schema, Display messages, ABI shape/version и отсутствие source positions у I/O/writer ошибок сохраняются. Существующий u32 address space Span не расширяется этим PR.

Versioned spec fixtures

Spec submodule закреплён на a45275688557dc9ecc24a82afb491dd46e615d4d, spec PR #8.

  • Новый draft versions/0.9/tests, опубликованная versions/0.8 не меняется.
  • 72 новых diagnostic fixtures: 30 EOF и 42 malformed UTF-8; все прежние категории наследуются, всего 412 fixtures в пяти категориях.
  • expected_location проверяется через owned/strict/thin/formatter/from_str/from_file, ErrorEnvelope, Span::line_col и четыре C ABI source operations. Для UTF-8 oracle требует покрытие, не навязывая всем реализациям одинаковую ширину ошибочной последовательности.
  • Все corpus runners переключены на 0.9. В GitHub CI установлен KTAV_REQUIRE_SPEC=1: отсутствие нужной версии больше не может привести к тихому skip. Manifest и required location oracle guard сохраняются.
  • Ошибки самого path-editing (EditError) остаются отдельным контрактом; существующие path-edit regressions продолжают выполняться.

Документация и проверки

  • Cargo package/spec-version готовятся как 0.9.0 по явному выбору пользователя; tags/package publication не выполняются.
  • README/changelog/migration обновлены EN/RU/ZH через root-docs. README явно различает готовящуюся 0.9.0 и опубликованную 0.8.1.
  • cargo fmt, cargo check --offline --locked --all-features --all-targets, cargo clippy --offline --locked --all-features --all-targets -- -D warnings, doc generation и --check пройдены.
  • Локальные product tests/build/e2e не запускались. Runtime-проверка — полный GitHub CI (Linux/Windows/macOS, MSRV 1.71).
  • Новых dependencies/unsafe нет. Числовая семантика и синтаксис языка не меняются.

Без merge, release tags и публикации. Spec PR должен быть сохранён/влит с доступным pinned commit до публикации Rust.

CI модели ошибок до runtime-оптимизаций

CI 40123142311 на точном 42ba13a72ef7ce360de018cb770a0fc282495d23 — 6/6 checks успешно. Linux log: 1386 passed, 0 failed, 3 прежних ignored. Оба новых fixture-driven diagnostic теста (Rust и C ABI) реально выполнены с KTAV_REQUIRE_SPEC=1; исполнены все пять категорий pinned corpus 0.9. Локальные runtime tests не запускались.

Runtime-оптимизации — 8f8dd87

  • line_text находится обратным поиском терминатора от span, без повторного сканирования префикса; CR/LF/CRLF, BOM, EOF и defensive handling произвольных error/source pairs сохранены.
  • Дочерние merge-буферы и seen-списки выделяются по необходимости. Резерв корневого items-буфера намеренно сохранён. Reopen semantics, порядок и lookup-cost guard не меняются.
  • Безопасный packed-byte probe проверяет наличие JSON-escapes по восемь байт, используя только std и определённую wrapping-арифметику. Строки без escapes копируются целиком. Экранируемый ASCII проходит checked is_ascii() и специализированный byte encoder; Unicode с escapes — прежний char encoder. Escape-циклы оставлены отдельными функциями.
  • Добавлены исчерпывающие проверки всех байтов в каждой lane и хвостовых длин, независимый serde_json oracle полного ASCII/Unicode/controls, проверки границ терминаторов и детерминированный тест отсутствия arena-аллокации у пустого дочернего буфера. Публичный API, десятипольная JSON-схема, версия, spec pin, зависимости и unsafe не меняются.

Парные замеры

Windows x86_64 MSVC, Rust 1.97.0, release/default features, одинаковые harness/lockfile, --offline --locked. Сборка выполнялась отдельно от замеров. Финальная серия: четыре пары A/B, B/A, A/B, B/A, по 7 сценариев, 5 ms warmup + 50 ms sample. Подготовка и точные expected-проверки вне измеряемых участков, но внутри общего deadline.

Весь batch со всеми восемью дочерними executable-процессами был под одним caps 15, а не под отдельными 15-секундными лимитами. Orchestrator завершился за 3.585 s, все процессы exit 0. Пользователь отдельно подтвердил, что повторные batch допустимы, каждый целиком не дольше 15 секунд.

Сценарий Baseline, мкс/op Candidate, мкс/op Медиана пар A/B Диапазон
Envelope возле EOF, префикс ≈1.6 MB 931.781 0.383 2479.810 2255.716–2632.277
Envelope в начале — control 0.381 0.368 1.009 0.983–1.119
JSON plain, payload 17 KiB 56.750 4.632 12.593 11.923–13.659
JSON Unicode без escapes, payload 13 KiB 36.843 3.665 10.017 9.478–10.468
Escape-heavy ASCII, payload 12 KiB 28.193 23.971 1.163 1.104–1.248
Один reopen + 2048 маленьких массивов 2625.744 1467.777 1.702 1.643–2.130
Без reopen — control 969.215 983.211 0.979 0.899–1.108

A/B > 1 означает ускорение. Медиана парных отношений не обязана совпадать с отношением двух медиан времени. Большой коэффициент первого сценария относится к ErrorEnvelope::from_error, не к полному parse. JSON измеряется на готовом envelope, содержащем payload в body и message. Для контрольных сценариев устойчивого выигрыша не заявляется; отрицательная медиана no-reopen не скрывается. Это короткие локальные измерения, не универсальная гарантия и не wall-clock gate CI. Peak RSS и суммарные аллокации не измерялись.

История и ограничения измерения

Первоначальные byte/chunk encoders ускоряли plain JSON, но устойчиво замедляли escape-heavy control; они отклонены, а все их CSV, stderr и binaries сохранены. A/A-контроль также сохранён и не использовался для пересчёта/отбрасывания A/B samples. Codegen-проверка выявила идентичные исходные encoder/caller instructions при другом размещении и автоматическое inlining legacy-цикла с probe. Единственная микроархитектурная причина не утверждается. Финальная ASCII-специализация устранила наблюдаемое замедление в проверенном сценарии.

При статическом анализе llvm-objcopy переписал первоначальный PE-контейнер baseline. Fingerprint guard остановил следующую попытку до запуска benchmark executable. Для финальной серии baseline заново собран из того же 42ba13a: весь .text, image base и RVA совпадают с первоначальными, но полный SHA контейнера отличается и явно записан вместе с первоначальным. Финальная серия не смешивается с ранними trials; fingerprints финальных binary/harness/lock и полный журнал сохранены.

Финальный CI

CI 40138250289 на точном 8f8dd875f6c36744b779864f6c9db3a66396c248 — 6/6 checks успешно, включая Linux/Windows/macOS и MSRV 1.71. Фактический Linux log: 1392 passed, 0 failed, 3 прежних ignored. Все шесть новых unit/integration regressions и оба fixture-driven diagnostic прогона Rust/C ABI реально выполнены с KTAV_REQUIRE_SPEC=1; pinned corpus остаётся 0.9 на a452756.

Merge и публикация релиза не выполнялись.

🤖 Generated with Claude Code

PHPCraftdream and others added 2 commits October 24, 2026 20:56
Добавить line/span в InvalidUtf8 и строку opener в UnclosedCompound.
Использовать общий расчёт исходных byte offsets в Rust API, C ABI,
Span::line_col и line_text публичного envelope для LF/CR/CRLF.
Сохранить UTF-8 priority, I/O и writer contracts и JSON schema.

Закрепить draft spec corpus 0.9 с 72 новыми diagnostic fixtures.
Проверять oracles через source entry points, envelope и C ABI;
переключить corpus runners на 0.9 и запрещать missing-corpus skips в CI.
Описать breaking migration на EN/RU/ZH. Path-editing API остаётся
частью готовящейся 0.9.0. Публикация релиза не выполняется.

BREAKING CHANGE: InvalidUtf8 теперь содержит valid_up_to, line и span;
UnclosedCompound — kind, line и span. Downstream-конструкторы и
полные field patterns требуют миграции.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Искать строку ошибки обратно от span без сканирования всего префикса.
Выделять дочерние merge-буферы и seen-списки только при необходимости.
Проверять JSON-escapes безопасными восьмибайтовыми операциями;
копировать строки без escapes целиком и выделить ASCII encoder,
сохранив прежний Unicode-путь и точные выходные байты.

Добавить проверки координат, JSON-oracles, packed-byte classifier
и отсутствия arena-аллокации у пустого дочернего буфера.
Добавить короткий парный benchmark с общим внешним лимитом batch,
обновить changelog EN/RU/ZH. Публичный API, версия, spec pin и
зависимости не меняются; нового unsafe нет.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@PHPCraftdream
PHPCraftdream merged commit 0412f52 into main Oct 25, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Direct Rust error API: complete source locations without hiding compatibility breaks

1 participant