Синтаксис и семантика
Всё ниже — канон языка, подтверждённый живым компилятором и машиной обучения (веб-интерпретатор внизу страницы исполняет канон прямо в браузере).
§1. Файл .deal — канон-AST
Файл хранит машиночитаемый AST в JSON — единственный источник компонента. Никакого «текста программы» не существует: проекция — вычисляемый вид, печатается из AST. Правила канона: детерминированный порядок сериализации (два серийных хеша одного смысла обязаны совпадать байт-в-байт), одна кодировка utf-8, одно написание каждой конструкции (никаких алиасов).
{"файл": "цена_за_единицу",
"сделки": [
{"имя": "деление",
"входы": [{"имя": "а", "тип": "число"}, {"имя": "б", "тип": "число"}],
"выход": "число",
"отказы": ["деление_на_ноль"],
"тело": [{"оп": "…", "…": "…"}],
"свидетель": [{"вход": {"а": 100000, "б": 4}, "выход": 25000.0},
{"вход": {"а": 100000, "б": 0}, "отказ": "деление_на_ноль"}]},
{"имя": "цена_за_единицу", "…": "…"}
]}
§2. Типы
число (float), строка, список,
словарь, статус (булево), файл (адрес на полке
состояния). Составных структур нет нарочно — сложное собирается сделками.
§3. Договор и сделка
Сделка — единица программы: заголовок-договор + тело + свидетель. Договор без тела — интерфейс: заявить можно, вызвать нельзя (компилятор откажет).
требует— предусловие; несоблюдение — канонический отказнарушен_договор, не падение.даёт— постусловие; исполняется на каждом свидетель-кейсе после тела (результат подаётся в выражение какэто).отказы— закрытый список канонических имён отказов сделки;стойв теле обязан называть имя из этого списка (или каноническое).
§4. Операции тела
| Оп | Пример | Суд |
|---|---|---|
присваивание | {"имя": "цена", "что": {…}} | выражение судится, имя объявляется |
верни | {"что": {…}} | возвращает значение сделки |
стой | {"отказ": "имя", "причина": "…"} | отказ назван в договоре; всплывает вверх по стеку зовов до свидетеля, который его ждёт |
присоединить | {"имя": "список", "что": {…}} | добавляет в список; первый элемент автосоздаёт его |
если / иначе | {"условие": {…}, "то": […], "иначе": […]} | обе ветви статически судятся |
для-каждого-до | {"переменная": "i", "до": {…}, "тело": […]} | цикл только с границей-в-договоре; неограниченный цикл невозможен |
полка-пиши | {"адрес": {…}, "значение": {…}} | состояние — только на полке, запись атомарна |
Нет: указателей, eval-подобных конструкций, свободных функций, побочных эффектов за границей полки.
§5. Выражения
| Оп | Поля | Примечание |
|---|---|---|
константа | значение | литерал |
поле | имя | имя объявлено во входах/пусть/присваивании до использования |
арифметика | лево, чем, право | + - * / %; деление/модуль на ноль — отказ деление_на_ноль |
сравнение | лево, чем, право | == != < > <= >=; несравнимые типы — отказ типы_не_сошлись |
и / или / не | лево, право / что | булевы, с коротким замыканием |
зов | договор, аргументы | примитивник или сделка файла; число аргументов — часть договора |
полка-читай | адрес | файла нет / не JSON — отказ полка_не_доступна |
§6. Примитивник — замороженный набор ВМ
Примитивник ИИ не пишет никогда: он реализован в ВМ и растёт только версионированным
решением. Важно: округлено работает по правилу половин вверх
(математическому), а не банковскому — округлено(2.5, 0) = 3,
округлено(0.125, 2) = 0.13.
| Примитивник | Смысл |
|---|---|
округлено(х, разряд) | половина вверх; округлено(0.125, 2) = 0.13 |
хеш(х) | sha256 строкового представления |
сумма · длина · максимум · минимум | по спискам и строкам |
склейка(список, разделитель) | строки из элементов |
нижний-регистр · логарифм · время | строки, математика, Unix-время |
элемент(список, номер) | за краем — канон-отказ за_краем, не IndexError |
тип-из(х) | имя типа значением |
список · словарь · ключи · поле-из-или · поле-записать · поставить | построение и хождение по данным |
полка-читай-или(адрес, умолчание) | чтение с умолчанием: файла нет — умолчание, не отказ |
Сырое исключение примитивника переводится в канон-отказ
типы_не_сошлись с именем примитивника и правкой — примитивник не падает
«питон-стеком», всегда отвечает словами.
§7. Свидетель — доказательство сделки
- Минимум 2 кейса (у сделок со входами — включая края), у сделки без входов — 1: входного пространства нет, краёв не бывает.
- Кейс:
{"вход": {…}, "выход": …}или{"вход": {…}, "отказ": "имя"}; свойство-кейс{"свойство": {…}}— для значений, которые нельзя зафиксировать числом. - Числа сравниваются с допуском 1e-9 (float-сравнение не хрупко).
- Постусловие
даётпроверяется на каждом кейсе автоматически — двойной суд: тело и договор. - Скрытые края: для каждого числового входа компилятор подставляет
0 и 1 000 000 — сделка обязана ответить каноническим отказом либо осмысленным числом;
непредсказуемый крах красит сделку. Границы ограждаются
требует-ом:
{"требует": {"оп": "и",
"лево": {"оп": "сравнение", "чем": ">=", "лево": {"оп": "поле", "имя": "n"},
"право": {"оп": "константа", "значение": 0}},
"право": {"оп": "сравнение", "чем": "<=", "лево": {"оп": "поле", "имя": "n"},
"право": {"оп": "константа", "значение": 100000}}}}
Живой урок: сделка «факториал» без ограждения на скрытом
крае n=1 000 000 честно молотила миллион итераций интерпретатора —
требует отсёк край канонически, компиляция вернулась к доле секунды.
Ограждение краёв — не украшение, а часть доказательства.
Пределы свидетелей — честно: свидетель доказывает «сошлось / не сошлось» на названных и скрытых кейсах — он доказывает наличие ошибки, не её отсутствие. Качество свидетелей — часть доказательства: слабые кейсы судят слабо (свидетели подаёт тот же ИИ — это названная граница языка, а не секрет). Смягчения в каноне: скрытые края 0 и 1 000 000, край-кейсы, свойство-кейсы, «даёт» на каждом кейсе.
§8.1. Реализация v0.1.1 — что судится сегодня, что следующий шов
Внешний аудит (независимый ИИ, 20.11) сверил описание с кодом пакета. Честный свод:
| Заявление | Реальность v0.1.1 |
|---|---|
| Стадия 2 — полнота | судит имя/входы/тело/свидетель; выход/отказы объявляются в файле, их enforcing — следующий шов |
| Стадия 3 — выполнимость | статически: зовы существуют, поля объявлены до использования, стой называет названный отказ; статической проверки типов нет — типы ловят свидетели (стадия 4) |
| Стадия 1 — форма | неизвестная операция падает на стадии 3/4 с именем; отдельная форма-проверка — следующий шов |
| «Отказ всегда словами» | отказ компилятора печатается JSON-ом: {стадия, виновник, причина, что_править}; никаких traceback |
| Граница полки | адрес не выходит за папку полки (сравнение с POLKA + os.sep); побег в соседнюю папку закрыт (проверено пробой ../polka_*) |
| Восемь зелёных компонентов | 8/8 в пакете, включая фикстуры полки; биективность проекции подтверждена внешним аудитом независимо |
§8.2. Второй раунд аудита — что чинит v0.1.2
Тот же внешний ИИ провёл глубже: семантика денег, типы, песочница, кодоген, детерминизм. Каждый пункт закрыт в v0.1.2 и верифицирован пробой на репро:
| Ошибка | Репро | Фикс v0.1.2 |
|---|---|---|
| Мутабельный литерал списка течёт между вызовами | два кейса [1,9] / [1,8] → [1,9,8] | литералы списков/словарей копируются при исполнении (глубокая копия) |
| Округление небезопасно во float | округлено(1.005, 2) → 1.0 | Decimal от строкового представления, ROUND_HALF_UP: 1.005 → 1.01; 2.5 → 3; 0.125 → 0.13 — канон «половина вверх» сохранён |
| Сравнение свидетелей теряет точность | 1e17+5 «равно» 1e17 | целые сравниваются точно (float-каст снят), дробные — допуск 1e-9 (названный канон) |
| Типы входов не судятся | строка под объявленное число — зелёная | типы входов судятся на каждом кейсе; несоответствие — канон-отказ |
| Побег из полки на запись | ../polka_evil/pwned.json создан | закрыто в v0.1.1 (граница POLKA + os.sep покрывает и запись) — перепроверено |
| Кодоген: инъекция имени в exec (CWE-94) | переменная i' — SyntaxError наружу | имя переменной — только идентификатор канона; кривое имя — канон-отказ |
| Нет лимита шагов | цикл до 10^12 вешал компилятор | топливо: 10 000 000 шагов — канон-отказ «топливо» за ~5 с вместо вечности; сброс на каждом кейсе |
| Отказы не пишутся в реестр | reestr.jsonl не изменился после отказа | отказ компилятора пишется в реестр (tip: otkaz, стадия, причина) |
| NaN принимается в AST | NaN сериализуется как невалидный JSON | NaN/Infinity запрещены при загрузке и сериализации (allow_nan=False) |
Честно названный остаток: допуск 1e-9 для дробных — канон (деньги: копейки), шум 1e-10 внутри него проходит; статическая проверка типов (стадия 3) — следующий шов языка, идёт в постройке. Методика бенчмарков и натив-бэкенд — вне пакета (цифры пилота, размечено).
§8.3. Третий раунд аудита — v0.1.3
Глубже: композиция, деньги, целостность, эквивалентность бэкендов. Всё закрыто в v0.1.3, верифицировано пробами на репро:
| Ошибка | Репро | Фикс v0.1.3 |
|---|---|---|
| Ромб-импорт ложно считался циклом | A→{B,C}, B→D, C→D — отказ «повторный» | цикл судится ПО ПУТИ (стек), ввоз того же ХЕША дедуплицируется; ввоз привозит транзитивное окружение (живая находка: зовы ввозимого файла падали нет_договора) |
| Сырой decimal.InvalidOperation наружу | округлено(1e100, 2) — traceback | Decimal-контекст с запасом + DecimalException в сети примитивника — канон-отказ; 1e30 считается |
| Топливо обходится в кодогене | цикл 1e9: кодоген висел | _sf() в каждом витке генерируемого кода — канон-отказ «топливо» за ~2 с |
| int↔float сравнение прятало потерю | (1e16+1)/1 → float 1e16 «равен» int 1e16+1 | смешанная пара сравнивается точно |
| Летопись без хеш-цепочки | «нельзя укоротить» — только соглашение | каждая запись несёт pred + hesh_zapisi — укорачивание ломает цепь и видно |
| Фиксированный .tmp — гонка писцов | две записи в один адрес | tmp уникален (pid+random), replace атомарен |
| Реестр растёт без ротации | полный AST на каждую зелёную компиляцию | повтор по хешу — лёгкая запись (tip: povtor, без AST) |
| Опечатка тии_не_сошлись в протоколе | — | типы |
| строка×число разрешена | "ab"*3 → "ababab" | арифметика строга: строки склеивает примитивник склейка |
| Глубина 300 зашита | факториал(>300) не решить | vm.ГЛУБИНА_ПОТОЛОК = N — настраиваемо |
Дифференциальная проба бэкендов (совет аудита — принята): 300 случайных выражений на интерпретаторе и байткоде — сошлись 300/300, расхождений 0. Осталось честно: статический суд типов (стадия 3), допуск 1e-9 для дробных (канон денег), натив-бэкенд и методика бенчмарков — вне пакета.
§8. Отказы — всегда словами
Канонические имена ВМ: деление_на_ноль · нарушен_договор ·
полка_не_доступна · нет_договора · нет_имени · нет_операции · полка_наружу ·
типы_не_сошлись · за_краем · глубина · топливо (топливо — v0.1.2:
расчёт израсходовал 10 000 000 шагов тела — вместо вечного цикла). Отказ
всплывает вверх по стеку зовов
до свидетеля, который его ожидает, — или до верха расчёта. Конструкции перехвата
нет нарочно: отказ всегда назван и всегда доезжает.
Компиляторский отказ — четыре поля:
{"стадия": 3, "виновник": "зов деление_не_то",
"причина": "договора нет в ввозах сделки; доступен деление (хеш a1b2c3)",
"что_править": "замени зов на деление или добавь ввоз хеша"}
§9. Шестнадцать превращений — весь способ работы ИИ
| # | Превращение | Суд компилятора |
|---|---|---|
| 1 | ввести-сделку | ≥1 кейс свидетеля, края |
| 2 | ввести-договор (вспомогательный) | договор полон, отвергнутых зовов нет |
| 3 | заменить-тело | все свидетели исполнены, «даёт» на каждом |
| 4 | добавить-кейс-свидетель | исполняется сейчас; недостающий край — претензия |
| 5 | убрать-кейс | остаются достаточные с краями |
| 6 | сузить-требует | все зовущие проверены заново |
| 7 | расширить-даёт | все свидетели перегнаны |
| 8 | добавить-отказ | тела зовущих называют новый отказ |
| 9 | заменить-зов | новый договор по хешу; типы и отказы учтены |
| 10 | переименовать-с-переносом-зовущих | все зовущие перенесены |
| 11 | расколоть-по-шву | две сделки в сумме эквивалентны |
| 12 | влить-сделки | слитая эквивалентна сумме |
| 13 | ввести-тип | применение типу — через сужение/расширение |
| 14 | пометить-карантин | непроверяемое живёт только в песочнице |
| 15 | вынести-в-примитивник | тело становится вызовом ВМ |
| 16 | удвоить-компонент-с-вариацией | новый компонент независим |
§10. Запреты языка
- Свободный текст в теле — только операции канона.
- Побочные эффекты за границей полки (сеть, процессы, экран).
- Неограниченные циклы — граница часть договора.
- Вольные зависимости по путям/именам — только хеш-адреса договоров.
- Мутабельное глобальное состояние — только полка.
- Два написания одной конструкции — канон enforced компилятором.
- Секреты в теле компонента.
§11. Веб-интерпретатор
Канон исполняется прямо в браузере — та же семантика, что у питон-ВМ: те же канон-отказы, то же округление, та же глубина зова и суд свидетелей.