Синтаксис и семантика

Всё ниже — канон языка, подтверждённый живым компилятором и машиной обучения (веб-интерпретатор внизу страницы исполняет канон прямо в браузере).

§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. Свидетель — доказательство сделки

{"требует": {"оп": "и",
  "лево":  {"оп": "сравнение", "чем": ">=", "лево": {"оп": "поле", "имя": "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.0Decimal от строкового представления, 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 принимается в ASTNaN сериализуется как невалидный JSONNaN/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) — tracebackDecimal-контекст с запасом + 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. Запреты языка

  1. Свободный текст в теле — только операции канона.
  2. Побочные эффекты за границей полки (сеть, процессы, экран).
  3. Неограниченные циклы — граница часть договора.
  4. Вольные зависимости по путям/именам — только хеш-адреса договоров.
  5. Мутабельное глобальное состояние — только полка.
  6. Два написания одной конструкции — канон enforced компилятором.
  7. Секреты в теле компонента.

§11. Веб-интерпретатор

Канон исполняется прямо в браузере — та же семантика, что у питон-ВМ: те же канон-отказы, то же округление, та же глубина зова и суд свидетелей.