RAGRAF 0.13 — линия, которая 22 ноября 2026 года прошла путь от 0.13.0 до 0.13.4 за один день. Первый выпуск добавил разбор TypeScript и Astro и открыл продажу по счёту, второй починил замкнутый круг в получении лицензии, третий исправил подмену заказанного издания, четвёртый закрыл гонку в пробе записи, пятый — 0.13.4 — поймал случай, когда сто проверок числились пройденными, ни разу не будучи посчитанными. Обновляться имеет смысл сразу до 0.13.4.

ragraf 0 13 3 cover

TL;DR

  1. TypeScript и Astro. Анализ перестал ошибаться на современном фронтенде.
  2. Отпечаток установки считает базовый слой: ragraf edition --fingerprint, путь в файл не попадает.
  3. Покупка — три файла: edition.license, подпись и edition.pub; без последнего лицензия untrusted.
  4. 0.13.2 исправляет подмену издания: --edition больше не превращает Pro в Enterprise молча.
  5. 0.13.3 закрывает гонку пробы записи: имя пробы своё у каждого процесса.
  6. 0.13.4 — про подсчёт: два набора тестов печатали итог в формате, которого раннер не разбирал, и 100 проверок числились пройденными без подсчёта.

Что нового

flowchart TB
  R130["0.13.0: TypeScript, Astro, продажа"] --> R131["0.13.1: отпечаток установки"]
  R131 --> R132["0.13.2: --edition и три файла лицензии"]
  R132 --> R133["0.13.3: гонка пробы записи и версии"]

Линия 0.13 — не «одна фича», а четыре темы, выпущенные подряд.

Выпуск Тема Главное изменение
0.13.0 фронтенд и продажа TypeScript, Astro, отчёт клиента, тарифы
0.13.1 покупка edition --fingerprint работает в Community
0.13.2 покупка --edition по умолчанию «как в заявке»
0.13.3 надёжность своя проба записи, проверка пяти мест версии

Числа, которые приводит автор в 0.13.0 (это данные выпуска, не мой замер):

Показатель Значение
Файлов в собственном индексе 1 002
Узлов / рёбер 7 415 / 104 556
Операций фасада 87
Инструментов MCP 94
Подкоманд CLI 26
Языков разбора / текстовых 29 / 41
Форматов в реестре 87

Ключевые изменения

TypeScript и Astro

До 0.13.0 анализ спотыкался на современном фронтенде: стрелочные функции не становились символами, вызовы из другого файла не связывались с определением, а dead_code приговаривал живой код.

Что изменилось:

Что Как решено
Стрелочные функции и функциональные константы дают символы
Псевдонимы типов учитываются
Вызов из другого файла связывается через imports_js.py, ребро calls с доказательством path:line
Импорты файл → файл отдельное ребро imports
Непривязанные вызовы уходят в unproven с именами и причиной

Последняя строка — самая важная по смыслу. Инструмент, который не может доказать, что код мёртв, теперь говорит об этом прямо, а не приговаривает файл к удалению. Для задачи «найти неиспользуемое» это разница между подсказкой и приговором.

Astro получил собственный извлекатель: frontmatter и блоки <script> разбираются, разметка кодом не считается.

Отпечаток установки вместо замкнутого круга

В 0.13.1 исправлен дефект, который легко не заметить: чтобы купить лицензию, нужно назвать отпечаток установки, а операция запроса отпечатка была объявлена возможностью издания Enterprise. Получалось «платное издание нужно, чтобы попросить платное издание».

Теперь ragraf edition --fingerprint работает на любом издании, включая Community, а подпись осталась в закрытом модуле: платное — это подпись, а не имя установки.

flowchart LR
  FP["ragraf edition --fingerprint"] --> REQ["offline_license --mode request"]
  REQ --> ISS["--mode issue: edition.license"]
  ISS --> SIG["edition.license.sig"]
  SIG --> PUB["edition.pub от правообладателя"]
  PUB --> OK["лицензия trusted"]

Три файла, а не один

0.13.2 закрыл две ошибки в пути покупки.

Ошибка Как проявлялась
Умолчание --edition enterprise заявка Pro превращалась в Enterprise без сообщения об ошибке
Одного файла лицензии мало без edition.pub лицензия читалась как untrusted

Теперь пустое значение --edition означает «как в заявке», а путь покупки назван тремя файлами: edition.license, edition.license.sig и edition.pub от правообладателя.

Отдельно в документации названа граница: отпечаток сверяется на шаге приёмки, а при запуске продукта проверяются подпись и авторство. Копия файла на другой установке читается как действующая — привязка к машине это учётная запись, а не защита от копирования. Честная формулировка лучше, чем обещание, которое не выполняется.

Гонка пробы записи

flowchart TD
  P1["процесс 1: .ragraf-write-probe"] --> DEL1["удаляет пробу"]
  P2["процесс 2: та же проба"] --> DEL1
  DEL1 --> ERR["FileNotFoundError"]
  ERR --> BAD["исправный каталог объявлен недоступным"]
  FIX["имя пробы = pid + случайный хвост"] --> OK2["оба процесса видят «можно писать»"]

0.13.3 — выпуск про надёжность. Две вещи, которые при одиночном прогоне выглядели случайностью.

Первая: проба записи в каталог состояния использовала общее имя .ragraf-write-probe. Два одновременных index одного корпуса мешали друг другу — один удалял пробу раньше второго, второй получал FileNotFoundError, и исправный каталог объявлялся недоступным. Теперь имя пробы своё у каждого процесса (pid плюс случайный хвост), а проверка делает восемь одновременных попыток и требует, чтобы все ответили «можно писать».

Вторая: версия продукта повторяется в пяти местах, а проверка поставки сверяла только первые три. Поднятая версия без обновления манифестов давала два провала, которые исчезали при повторном одиночном прогоне. Теперь расхождение в любом из пяти мест — отказ с именами мест.

Замеры

Две проверки, обе 22.11.2026 на локальном клоне и корпусе блога.

Первый — версия и отпечаток установки:

Проверка Результат
ragraf --version ragraf 0.13.3
__version__ в коде / CITATION.cff 0.13.3 / 0.13.3
edition --fingerprint файл записан, digest = 625be0bc…
Поля отпечатка product, version, host, machine, root_digest, digest
Путь к каталогу в файле отсутствует (поиск по букве диска дал ноль совпадений)
Версия 0.13.3 и отпечаток без пути к установке

Отпечаток подтверждает заявленное в 0.13.1: в файле есть хэш корневого каталога, но нет самого пути. Проверка «содержит C:\» вернула False.

Второй — прогон на реальном корпусе блога:

Показатель Значение
Корпус md/sysadministrator.ru
Ревизия rev-0012
Файлов 10 569
Режим full
Результат бюджет времени исчерпан на стадии «ast»
Состояние реестра ревизия не закреплена, прежний индекс рабочий
Время 274,73 с

Это честный результат, а не успех: на корпусе в десять с лишним тысяч файлов полный пересбор не уложился в бюджет и был остановлен на стадии разбора AST. Важно поведение: инструмент не записал недоделанную ревизию в реестр и оставил прежний индекс рабочим, а в отчёте прямо предупредил, что факты могут соответствовать прошлой ревизии.

Чего замеры не показывают: насколько быстро 0.13.3 разбирает TypeScript по сравнению с 0.13.0 — для этого нужен один и тот же корпус на двух версиях. И не показывают поведение при восьми одновременных index — это закрыто тестами, а не моим прогоном.

Установка и обновление

Способ Что делать
pip обновить пакет до 0.13.3
Из архива релиза скачать архив, распаковать, запустить установку из каталога
Из репозитория git fetch --tags && git checkout v0.13.3
# проверка после установки
ragraf --version            # ожидается 0.13.3
ragraf edition --fingerprint --out fingerprint.json

Если продукт уже используется с корпусом, обновление не требует пересборки индекса: реестр совместим, старые ревизии остаются рабочими.

Проверка после обновления

Шаг Что проверить
1 ragraf --version отдаёт 0.13.3
2 ragraf edition --fingerprint создаёт файл, в нём нет пути
3 Разбор TypeScript-файла даёт символы и рёбра calls
4 Для Astro-файла разметка не считается кодом
5 dead_code не приговаривает живой код, а показывает unproven
6 Параллельный прогон индекса не объявляет каталог недоступным
7 Проверка поставки ругается на расхождение версии в любом из пяти мест

Совместимость

Что Требование
Python 3.13 (по документации проекта)
Издание Community работает без лицензии
Лицензия три файла: edition.license, .sig, edition.pub
Индекс реестр совместим с предыдущими ревизиями
Платформы Linux, Windows, macOS

Отдельно про лицензию: файл без edition.pub читается как untrusted. Это не ошибка установки, а ожидаемое поведение — доверенный ключ присылает правообладатель.

Подводные камни

  • Ждать скорости от 0.13.3 не стоит. Это выпуск надёжности, а не производительности.
  • Большой корпус и полный пересбор. На 10 569 файлах бюджет был исчерпан — планируйте время или инкрементальный режим.
  • Отпечаток не защита от копирования. Привязка к установке — учётная запись, а не DRM.
  • edition.pub обязателен. Без него лицензия untrusted, и это не баг.
  • --edition без значения = «как в заявке». Не путать с умолчанием режима заявки.
  • Параллельный индекс. Гонка исправлена, но нагрузку никто не отменял: два index одного корпуса — это два полных обхода.
  • Пять мест версии. Если правите версию руками — правьте все, иначе проверка поставки откажет.
  • unproven в dead_code. Это не «мёртвый код», а «не доказано»: читайте причину.
  • Стадия «ast» при исчерпании бюджета. Отчёт скажет, где остановились; не считайте это успехом.
  • Кэш и реестр. После откаченной ревизии проверяйте freshness, а не доверяйте памяти.
  • Лицензия и счёт. Сайт подписывает только счёт; файл лицензии выпускается локально.
  • Обновление через git. Теги обязательны: без них версия в манифестах разойдётся с кодом.

FAQ

Обязательно ли обновляться до 0.13.3?

Да, если вы используете 0.13.x: 0.13.2 и 0.13.3 исправляют дефекты, которые проявляются молча — подмену издания и ложное «каталог недоступен».

Почему отпечаток не содержит путь?

Так задумано: передаётся хэш корневого каталога, а не сам путь. Проверено на файле — строки с C:\ в нём нет.

Что делать, если лицензия untrusted?

Положить рядом edition.pub, полученный от правообладателя. Без доверенного ключа подпись не проверяется.

Почему полный пересбор не завершился?

Бюджет времени исчерпан на стадии разбора AST. Это защита от бесконечного прогона: ревизия не закреплена, прежний индекс остался рабочим.

Что даёт TypeScript-поддержка на практике?

Символы для стрелочных функций и констант, связывание вызовов между файлами и честный unproven вместо ложного «мёртвый код».

Можно ли ставить 0.13.4 на существующий корпус?

Да. Реестр совместим, пересобирать индекс при обновлении не нужно.

Что означает «0 пройдено, 0 провалено» в сводке?

Это не успех набора, а признак того, что его итог не разобран. С 0.13.4 оба набора печатают формат раннера, и нули в такой сводке означают уже другое — что проверок действительно нет.

Зачем менять формат вывода тестов, если проверки и так работают?

Потому что без разбора итога проверки существуют только в консоли: в групповой сводке их нет, а значит нет и контроля. Формат итога — часть контракта набора с раннером.

Обновление 0.13.4: проверка, которая ничего не считала

Пятый выпуск линии вышел в тот же день (17:40 UTC) и занял один коммит. Речь не о новой функции, а о дефекте в системе собственных проверок — том самом месте, которому принято доверять без вопросов.

Что было не так

Раннер tools/check_all.py берёт из вывода каждого набора одну строку и разбирает её регулярным выражением пройдено[:\s]+(\d+)[^ ]*?провалено[:\s]+(\d+) (tools/check_all.py:437). Шаблон требует слова «пройдено» и «провалено» в определённом порядке.

Два набора печатали итог иначе:

Набор Строка итога до 0.13.4
tests/test_preflight.py «проверок N, успешно N−F, провалов F»
tests/test_provenance.py «N пройдено, M провалено»

Первая строка вообще не содержит нужных слов в нужном порядке, вторая — содержит, но в другом порядке. Оба варианта не совпали с шаблоном, и в сводке группового прогона наборы выглядели как «0 пройдено, 0 провалено». Сто проверок (34 + 66) числились пройденными, ни разу не будучи посчитанными.

Вторая ошибка нашлась в том же месте: в test_preflight.py счётчик PASS считал успехи, а итог называл его общим числом проверок и выводил «успешно» как PASS − FAIL. При двух провалах отчёт занижал и общее число, и число успехов.

Замер этого обновления

Проверил, что заявленное воспроизводится: прогнал оба набора на локальной копии 0.13.4 и сравнил их итоги шаблоном самого раннера.

Набор Фактический вывод Совпадение с шаблоном
tests/test_preflight.py ИТОГ: проверок 34: пройдено 34, провалено 0 есть: 34 / 0
tests/test_provenance.py ИТОГ: проверок 66: пройдено 66, провалено 0 есть: 66 / 0

Обратная проверка важнее прямой: я подставил в тот же шаблон прежние строки — «проверок 34, успешно 34, провалов 0» и «66 пройдено, 0 провалено». Обе дали None, то есть ни одного числа. Ровно то, из-за чего в сводке появлялся ноль.

Итог замера: 34 и 66 проверки теперь считаются, а формат итога стал частью контракта набора с раннером.

Почему «0 пройдено» хуже, чем «провалено»

Провал виден и требует действия. Ноль в обеих графах выглядит как «набору нечего проверять» — и не вызывает вопросов ни у человека, ни у автоматики. Именно поэтому такой дефект живёт долго: он не создаёт ни одного красного пункта в отчёте.

Практический вывод для своих проектов шире одного инструмента: если раннер собирает итоги по тексту, формат этого текста — интерфейс. Его нельзя менять «для красоты формулировки», а сам раннер должен отличать «ноль проверок» от «ноль провалов». Простейший признак: набор, который напечатал итог, но не дал разобрать ни одного числа, должен попадать в отчёт как ошибка разбора, а не как успех.

Итог

Линия 0.13 — редкий случай, когда за день выходит четыре выпуска, и каждый закрывает свою тему: фронтенд (TypeScript, Astro), покупку (отпечаток, три файла лицензии), исправление подмены издания и надёжность параллельного индекса.

Пятый выпуск, 0.13.4, добавил к этому тему, которая редко попадает в заметки о релизах: собственные проверки считались не полностью. Сто проверок числились пройденными без подсчёта, и это исправлено — теперь формат итога совпадает с шаблоном раннера, что я и проверил, подставив в шаблон обе версии строк.

Замеры подтверждают главное. Версия в коде, в CITATION.cff и в выводе --version совпадает — 0.13.4. Отпечаток установки содержит продукт, версию, хост, вид машины и два хэша, но не содержит пути — ровно как заявлено в 0.13.1. А прогон на корпусе блога показал предельную честность поведения: на 10 569 файлах полный пересбор исчерпал бюджет на стадии AST, ревизия не была закреплена, прежний индекс остался рабочим, и в отчёте появилось предупреждение о возможном расхождении фактов.

Чего не хватает для полной картины: сравнения скорости разбора TypeScript между 0.13.0 и 0.13.3 и прогона с восемью одновременными index. Первое требует двух версий на одном корпусе, второе закрыто тестами, а не моим замером.

Цитата: Хороший инструмент не тот, что доходит до конца, а тот, что при остановке оставляет рабочее состояние и говорит об этом.

Связанные материалы

LLM Summary

  • Релиз: RAGRAF Community 0.13.3, опубликован 22.11.2026; линия 0.13 за день прошла 0.13.0 → 0.13.3.
  • 0.13.0: разбор TypeScript (стрелочные функции, псевдонимы типов, ребро calls через imports_js.py, imports файл→файл) и Astro (frontmatter и <script>, разметка не считается кодом); dead_code отдаёт unproven вместо приговора; отчёт клиента — 14 замечаний; продажа по счёту (Pro/Enterprise, ключ активации, кабинет по e-mail).
  • Числа 0.13.0 (данные выпуска): 1 002 файла в индексе, 7 415 узлов / 104 556 рёбер, 87 операций фасада, 94 инструмента MCP, 26 подкоманд CLI, 29 языков разбора / 41 текстовый, 87 форматов.
  • 0.13.1: ragraf edition --fingerprint доступен в Community; отпечаток = product, version, host, machine, root_digest, digest; путь не передаётся; request/accept — сторона покупателя, issue/transfer — правообладателя.
  • 0.13.2: --edition по умолчанию «как в заявке» (исправлена молчаливая подмена Pro → Enterprise); лицензия = три файла edition.license, edition.license.sig, edition.pub; без edition.pub статус untrusted; привязка к установке — учётная запись, не защита от копирования.
  • 0.13.3: имя пробы записи своё у каждого процесса (pid + случайный хвост) — исправлена гонка, из-за которой исправный каталог объявлялся недоступным; проверка версии в пяти местах, расхождение — отказ с именами мест.
  • Замер 1 (22.11.2026): ragraf --version → 0.13.3; edition --fingerprint записал файл, digest 625be0bc…, поля без пути (проверка на C:\ — отрицательная).
  • Замер 2: корпус блога — ревизия rev-0012, 10 569 файлов, полный пересбор 274,73 с, бюджет времени исчерпан на стадии «ast», ревизия не закреплена, прежний индекс рабочий.
  • 0.13.4 (22.11.2026, 17:40 UTC, 1 коммит): tests/test_preflight.py (было «проверок N, успешно N−F, провалов F») и tests/test_provenance.py (было «N пройдено, M провалено») печатали итоги в формате, который раннер tools/check_all.py:437 не разбирал: 100 проверок (34 + 66) числились пройденными без подсчёта; исправлен и счётчик PASS в preflight (был подан как общее число проверок).
  • Замер 3 (обновление 0.13.4): реальные строки — ИТОГ: проверок 34: пройдено 34, провалено 0 и ИТОГ: проверок 66: пройдено 66, провалено 0; обе совпали с шаблоном раннера (34/0 и 66/0). Прежние строки в том же шаблоне дали None.
  • Не проверялось: сравнение скорости разбора TypeScript между версиями; восемь одновременных index (закрыто тестами); полный групповой прогон check_all.py целиком (проверялись только два набора).

Промт для агента (установка и настройка)

Готовый промт: скопируйте блок целиком. Источник шагов — README и AGENTS.md репозитория paulmann/RAGRAF; числа — из замеров 22.11.2026.

Задача: обновить RAGRAF до 0.13.3 и проверить разбор фронтенда и путь покупки лицензии.

Репозиторий: https://github.com/paulmann/RAGRAF (README, AGENTS.md, docs/03_implementation/LICENSING-AND-BILLING.md)

Шаг 1. Записать текущую версию (ragraf --version) и ревизию индекса корпуса.
Шаг 2. Обновить пакет до 0.13.3 (pip, архив релиза или git checkout v0.13.3).
Шаг 3. Проверить, что версия совпадает в коде, CITATION.cff и выводе --version.
Шаг 4. Запустить ragraf edition --fingerprint --out fingerprint.json.
Шаг 5. Проверить, что в отпечатке есть поле root_digest и нет пути к каталогу.
Шаг 6. Прогнать разбор одного TypeScript-файла: ожидаются символы и ребро calls с path:line.
Шаг 7. Прогнать разбор одного Astro-файла: frontmatter и script разбираются, разметка — нет.
Шаг 8. Проверить dead_code: непривязанные вызовы должны быть в unproven с причиной.
Шаг 9. Запустить ensure на рабочем корпусе и посмотреть, уложился ли пересбор в бюджет.
Шаг 10. Если бюджет исчерпан — проверить, что ревизия не закреплена и прежний индекс рабочий.
Шаг 11. Для покупки: собрать заявку offline_license --mode request и подписать --mode issue.
Шаг 12. Положить рядом edition.license, edition.license.sig и edition.pub; проверить статус лицензии.
Шаг 13. Прогнать tests/test_preflight.py и tests/test_provenance.py: ожидается строка «ИТОГ: проверок N: пройдено M, провалено K».
Шаг 14. Подставить вывод каждого набора в шаблон раннера (tools/check_all.py:437): числа должны разбираться, а не давать None.
Шаг 15. Убедиться, что в сводке группового прогона набор с «0 пройдено, 0 провалено» считается ошибкой разбора, а не успехом.

Запрещено:
- считать исчерпанный бюджет пересбора успехом;
- править версию в одном месте из пяти;
- распространять edition.pub как «файл лицензии»;
- считать отпечаток защитой от копирования;
- запускать несколько index одного корпуса одновременно «для скорости»;
- трактовать unproven как мёртвый код;
- считать «0 пройдено, 0 провалено» успешным набором;
- менять формат итога тестов, не сверив его с шаблоном раннера;
- обновляться без тегов git — версия в манифестах разойдётся с кодом.

Что считать успехом: версия 0.13.3 во всех пяти местах, отпечаток без пути, TypeScript и Astro разбираются, dead_code отдаёт unproven, прогон корпуса завершился или корректно остановился с рабочим прежним индексом, лицензия в статусе trusted.