Prechádzať zdrojové kódy

SVI Доработка документации

SVI 5 mesiacov pred
rodič
commit
3f82d7d6bc
9 zmenil súbory, kde vykonal 341 pridanie a 318 odobranie
  1. 36 24
      docs/docs/01_30.md
  2. 17 15
      docs/docs/01_40.md
  3. 41 39
      docs/docs/01_50.md
  4. 25 23
      docs/docs/01_55.md
  5. 36 36
      docs/docs/01_60.md
  6. 18 19
      docs/docs/01_70.md
  7. 60 60
      docs/docs/01_80.md
  8. 22 21
      docs/docs/01_90.md
  9. 86 81
      docs/docs/02_10.md

+ 36 - 24
docs/docs/01_30.md

@@ -39,22 +39,23 @@
             (Сравнить х > 10)
             (ФнКвадрат рез))
     )
-    вернуть рез
+    (вернуть рез)
 )
 ```
 
 ```prolet
 (// при необходимости — ручное управление)
-(прц КопироватьПамять @система (СисАдр источник
-                                СисАдр цель
-                                СисРазмер размер)
-    (асм (ПовторОтДо источник цель))
+(прц КопироватьПамять @система (
+       (СисАдр источник    СисАдр цель    СисРазмер размер)
+    (
+        асм (ПовторОтДо источник цель)
+    )
 )
 ```
 
 Философский смысл:
 
-`Единство абстрактного и конкретного`
+> `Единство абстрактного и конкретного`
 
 Сознание не отрывается от материи — программист видит, что происходит с памятью.
 
@@ -71,11 +72,13 @@
 
 > "Безопасность любой ценой" — язык становится *тюрьмой* (например, строгие ограничения в некоторых версиях `Ada` или `Rust`).
 
+Противоположность:
+
 > "Свобода любой ценой" — хаос, утечки, уязвимости, непредсказуемое поведение (`C`, `C++`, `JavaScript`).
 
 Диалектическое разрешение:
 
-`Безопасность по умолчанию, гибкость по необходимости, с явным указанием ответственности программиста.`
+> `Безопасность по умолчанию, гибкость по необходимости, с явным указанием ответственности программиста.`
 
 По умолчанию:
 
@@ -91,18 +94,19 @@
 
 ```prolet
 (// Функции никогда ничего не изменяют )
-(фн СложитьДист1 (
-        Км a
-        М  b): Км(
-    (СложитьКмМ a b))
+(фн СложитьДист1 (Км a   М b) Км(
+    (СложитьКмМ a b)
+    (вернуть рез)
+    )
 )
 
 ( // Процессы могут, но не обязаны иметь побочные эффекты)
-(прц ЗначПоАдр
-        @система
+(прц ЗначПоАдр @система
         @обоснование "взаимодействие с драйвером"
-        (Адр адр @мут): Адр (
-    (ЗначИз адр))
+        (Адр адр @мут) Адр (
+    (ЗначИз адр)
+    (вернуть рез)
+    )
 )
 ```
 
@@ -111,7 +115,8 @@
 > Свобода есть осознанная необходимость (по Гегелю, переосмысленному Марксом).
 
 Гибкость не отменяется, но подчиняется интересам целого — стабильности системы.
-> 💡 Это как общественный порядок: каждый член может высказать мнение, но после решения — действует в соответствие с общественным решением и дальнейшие высказывания не имеют влияния на принятое решение до следующего голосования(принцип демократического централизма).
+
+> 💡 Это как общественный порядок: каждый член может высказать мнение, но после решения — действует в соответствие с общественным решением и дальнейшие высказывания не имеют влияния на принятое решение до следующего голосования (принцип демократического централизма).
 
 ### ⚔️ Противоречие: Простота vs Мощность
 
@@ -127,7 +132,7 @@
 
 Диалектическое разрешение:
 
-`Язык растёт вместе с программистом.`
+> `Язык растёт вместе с программистом.`
 
 Начальный уровень:
 
@@ -137,15 +142,21 @@
 
 По мере роста:
 
-- Раскрываются продвинутые возможности: метапрограммирование, unsafe, concurrency.
+- Раскрываются продвинутые возможности: метапрограммирование, unsafe, concurrency;
 - Но только после прохождения проверки знаний (встроенный обучающий модуль).
 
 Это как путь солдата:
 
-- сначала — базовое вооружение,
-- затем — тактические приёмы,
+- сначала — базовое вооружение;
+- затем — тактические приёмы;
 - затем — стратегическое мышление.
 
+> Генералом не рождаются, генералом становятся. Плох тот солдат, что не стремится стать генералом.
+
+Даже при одиночном программировании трудящийся не остаётся в одиночестве.
+
+Программирование есть общественные отношения.
+
 Философский смысл:
 
 - Развитие идёт от простого к сложному, но в единстве с практикой.
@@ -167,9 +178,10 @@
 
 Диалектическое разрешение:
 
-`Гибридная система с постепенной типизацией и выводом.`
+> `Гибридная система с постепенной типизацией и выводом.`
+
+Все переменные имеют тип, и он может быть выведен при назначении имени значению.
 
-Все переменные имеют тип, но он может быть выведен.
 Можно использовать динамический тип, но:
 
 - Только в ограниченных зонах,
@@ -216,7 +228,7 @@
 
 Встроенные механизмы:
 
-- @автор, @соавторы, @история\_изменений,
+- `@автор`, `@соавторы`, `@история_изменений`,
 - Обязательные рецензии перед коммитом (на уровне языка),
 - Автоматическая генерация отчётов о вкладе (для оценки труда).
 - Код-ревью — не опционально, а обязательная фаза компиляции в производство.
@@ -263,4 +275,4 @@
 - Мыслит диалектически,
 - Действует материалистически,
 - Работает коллективно,
-- Служит прогрессу.
+- Служит общественному прогрессу.

+ 17 - 15
docs/docs/01_40.md

@@ -54,7 +54,7 @@
 Вариант 1: Явный блок низкоуровневый с контекстным предупреждением
 
 ```prolet
-(прц ОбработатьДанные (Список.Байт вход @мут): Список.Байт (
+(прц ОбработатьДанные (Список.Байт вход @мут) Список.Байт (
     (// Высокий уровень — чисто, безопасно)
     (ФильтрПо вход
         (x > 10)
@@ -71,7 +71,7 @@
          СбщДлина длина)(
     (Цикл для i от 0 до длина
         (// Прямое обращение к памяти)
-        (асм (рег0 загр i))
+        (асм (загр i статус))
     )
 )
 ```
@@ -79,8 +79,8 @@
 Психологические преимущества:
 
 - Свойство `@система` — семантический маркер, активирует режим повышенного внимания.
-- Цвет подсветки — красный или оранжевый (по стандартам UX).
-- IDE показывает подсказку: "Вы вошли в зону повышенного риска. Проверьте указатели, границы массивов."
+- Цвет подсветки — красный или оранжевый (по стандартам **UX**).
+- **IDE** показывает подсказку: "Вы вошли в зону повышенного риска. Проверьте указатели, границы массивов."
 
 Диалектический смысл:
 
@@ -92,7 +92,7 @@
 
 ```prolet
 (модуль БезопаснаяОбработка (
-    (прц Фильтровать(ДанныеПоток данные @мут ): ДанныеПоток (
+    (прц Фильтровать(ДанныеПоток данные @мут ) ДанныеПоток (
         если (Сравнить данные @длина > 10)
         тогда (ДобСписок данные))
     )
@@ -133,7 +133,7 @@
 
 ```prolet
 (прц ОбработатьГруппу @уровень_ниже(
-    (ПолучитьДанные): данные(
+    (ПолучитьДанные) данные(
     (// Высокий уровень)
     (ГруппироватьПо данные @ключ)(уст группа)
     (СуммироватьПо данные группа)(уст результат)
@@ -141,11 +141,12 @@
     (// Спуск в низкий уровень — через ключевое слово и атрибут)
         (// Теперь можно использовать указатели, asm)
         (асм
-            (рег0 cохр результат)
-            (рег0 инк))
+            (cохр результат рез)
+            (инк рез))
     )
 
     (// Подъём автоматически))
+    вернуть рез
 )
 ```
 
@@ -159,19 +160,20 @@
 Когнитивная выгода:
 
 - Мозг четко фиксирует границу.
-- Не нужно держать в памяти: "а я всё ещё в @система?".
+- Не нужно держать в памяти: "а я всё ещё в `@система`?".
 - Уменьшает когнитивную нагрузку.
 - На уровне компилятора перехватывает обращение к опасным средствам.
 
 Вариант 4: Интеграция с системой обучения (обучающий компилятор)
 
 ```prolet
-(прц ОбработатьПамять @система (Срез.Байт размер)): асм.адр(
+(прц ОбработатьПамять @система (Срез.Байт размер)) АсмИмя(
     (// Компилятор замечает:  "Вы используете сырые указатели")
     если (Сравнить уровень < 3)
     тогда (ПройтиМодуль "Управление памятью (5 мин)")
-    иначе (ИспользоватьБезопасныйАналог "Буфер.Байт")
+    иначе (ИспользоватьБезопасныйАналог "БуферБайт")
     )
+    вернуть рез
 )
 ```
 
@@ -188,7 +190,7 @@
 
 - Единство обучения и труда.
 - Программист не просто пишет код — он развивается в процессе.
-- Это — советская школа программирования, доведённая до совершенства.
+- Это — диалектическая школа программирования, отвечающая запросам сообщества.
 
 Рекомендованная модель: синтез вариантов (диалектический выбор)
 
@@ -204,9 +206,9 @@
 
 Язык программирования может быть спроектирован:
 
-- как многоуровневый по возможностям
-- как педагогический механизм
-- как дополнительное средство безопасности, встроенное в сам язык
+- как многоуровневый по возможностям;
+- как педагогический механизм;
+- как дополнительное средство безопасности, встроенное в сам язык.
 
 Синтаксис языка — это не абстрактная форма, а содержание практического, деятельного сознания.
 

+ 41 - 39
docs/docs/01_50.md

@@ -29,53 +29,53 @@
 
 Отношение к уровню абстракции: `Жёсткая иерархия, переходы запрещены, внешний (eval)`
 
-Экономия мыслетоплива: много boilerplate (как принуждение новичков), принуждает к шаблонам, тормозит квалифицированных специалистов
+Экономия мыслетоплива: много boilerplate (как принуждение новичков), принуждает к шаблонам, тормозит квалифицированных специалистов.
 
-Семантический контекст перехода: практически отсутствует — нет низкоуровневых операций
+Семантический контекст перехода: практически отсутствует — нет низкоуровневых операций.
 
-Вероятность ошибок: низкая (ограниченность), но не из-за понимания, а из-за цензуры
+Вероятность ошибок: низкая (ограниченность), но не из-за понимания, а из-за цензуры.
 
-Гибкость и развитие: низкая (язык заморожен, расширения — через диалекты)
+Гибкость и развитие: низкая (язык заморожен, расширения — через диалекты).
 
-Педагогическая эффективность: высокая (учит дисциплине)
+Педагогическая эффективность: высокая (учит дисциплине).
 
 ### Платонический идеализм
 
-Философия: `всё — форма, материя не важна`
+Философия: `всё — форма, материя не важна`.
 
-Отношение к уровню абстракции: `Нет уровней — всё выражается через (macro)`
+Отношение к уровню абстракции: `Нет уровней — всё выражается через (macro)`.
 
-Экономия мыслетоплива: высокая для экспертов, катастрофически высока для новичков
+Экономия мыслетоплива: высокая для экспертов, катастрофически высока для новичков.
 
-Семантический контекст перехода: отсутствует полностью — всё «на одном уровне»
+Семантический контекст перехода: отсутствует полностью — всё «на одном уровне».
 
-Вероятность ошибок: высокая (можно всё, включая саморазрушение)
+Вероятность ошибок: высокая (можно всё, включая саморазрушение).
 
-Гибкость и развитие: очень высокая (язык может породить себя заново)
+Гибкость и развитие: очень высокая (язык может породить себя заново).
 
-Педагогическая эффективность: низкая (не принуждает структурировать траекторию обучения)
+Педагогическая эффективность: низкая (не принуждает структурировать траекторию обучения).
 
 ### Смешанный подход
 
-Философия: `безопасность через практику владения`
+Философия: `безопасность через практику владения`.
 
-Отношение к уровню абстракции: `Чёткая граница: (unsafe) как зона сознательного риска`
+Отношение к уровню абстракции: `Чёткая граница: (unsafe) как зона сознательного риска`.
 
-Экономия мыслетоплива: сложный вывод типов, но безопасность снижает ошибки (ставит в ступор новичков, психологически давит на профи, вызывает стресс при длительном использовании)
+Экономия мыслетоплива: сложный вывод типов, но безопасность снижает ошибки (ставит в ступор новичков, психологически давит на профи, вызывает стресс при длительном использовании).
 
-Семантический контекст перехода: с использованием `unsafe` чёткая граница
+Семантический контекст перехода: с использованием `unsafe` чёткая граница.
 
-Вероятность ошибок: низкая (ошибки на этапе компиляции, если нарушено владение; высокая когнитивная нагрузка)
+Вероятность ошибок: низкая (ошибки на этапе компиляции, если нарушено владение; высокая когнитивная нагрузка).
 
-Гибкость и развитие: средняя (макросы, но в рамках системы типов)
+Гибкость и развитие: средняя (макросы, но в рамках системы типов).
 
-Педагогическая эффективность: низкая (высокий порог входа, крутая кривая обучения, не следует принципам научной педагогики)
+Педагогическая эффективность: низкая (высокий порог входа, крутая кривая обучения, не следует принципам научной педагогики).
 
 ## Диалектическая оценка каждого подхода
 
 ### `Pascal`
 
-Метафизический идеализм в синтаксисе
+Метафизический идеализм в синтаксисе.
 
 Суть: мир должен быть упорядочен сверху, иерархически, без противоречий.
 
@@ -86,7 +86,7 @@
 - отрицает движение,
 - подавляет противоречие, делает вид, что его нет.
 
-Это как попытаться указом правительства приказать гражданам быть счастливыми в условиях массового нищенского существования.
+Это как попытаться указом правительства приказать всем курицам в государстве нести яйца по команде.
 
 Противоречие не исчезает — оно вытесняется и возвращается с удвоенной силой.
 
@@ -100,7 +100,7 @@
 
 ### `Lisp`
 
-Платонический идеализм: «всё — форма»
+Платонический идеализм: «всё — форма».
 
 Суть: язык — это метаязык, способный породить любую парадигму.
 
@@ -113,7 +113,7 @@
 - Отрыв формы от содержания.
 - Программист может создать идеальную абстракцию, которая не отражает объективную реальность.
 
-Пример: можно написать макрос, который делает (Сложить 2 2) равным 5, если "так удобнее".
+Пример: можно написать макрос, который делает `(Сложить 2 2)` равным 5, если "так удобнее".
 Это — произвол сознания над бытием, чистый идеализм.
 
 Психологический эффект:
@@ -159,35 +159,35 @@
 
 ### Движение
 
-Язык должен развиваться вместе с практикой
+Язык должен развиваться вместе с практикой.
 
 ### Единство противоположностей
 
-Не запрет, а синтез
+Не запрет, а синтез.
 
 ### Переход количества в качество
 
-Накопление знаний → переход на новый уровень
+Накопление знаний → переход на новый уровень.
 
 ### Отрицание отрицания
 
-Язык может порождать новые формы, включая себя
+Язык может порождать новые формы, включая себя.
 
 ### Практика — критерий истины
 
-Конструкции проверяются реальным использованием
+Конструкции проверяются реальным использованием.
 
 ### Экономия мыслетоплива
 
-Минимум когнитивной нагрузки при максимуме понимания
+Минимум когнитивной нагрузки при максимуме понимания.
 
 ### Сужение семантического контекста
 
-Переход между уровнями — чётко ограничен, предсказуем
+Переход между уровнями — чётко ограничен, предсказуем.
 
 ### Педагогичность
 
-Язык учит, а не только позволяет
+Язык учит, а не только позволяет.
 
 ## Синтез: путь к диалектическому языку
 
@@ -199,21 +199,21 @@
 
 ### Pascal
 
-Чёткость, структура, строгая типизация
+Чёткость, структура, строгая типизация.
 
-Учит дисциплине, снижает хаос
+Учит дисциплине, снижает хаос.
 
 ### Lisp
 
-Гибкость, макросы, гомоиконичность, метапрограммирование
+Гибкость, макросы, гомоиконичность, метапрограммирование.
 
-Позволяет языку развиваться, порождать новые конструкции
+Позволяет языку развиваться, порождать новые конструкции.
 
 ### Rust
 
-unsafe, система владения как основы материалистического перемещения, граница риска
+`unsafe`, система владения как основы материалистического перемещения, граница риска.
 
-Чёткий семантический контекст перехода
+Чёткий семантический контекст перехода.
 
 ## Проект диалектического решения: prolet, как развивающийся язык
 
@@ -223,10 +223,12 @@ unsafe, система владения как основы материалис
 
 ```prolet
 (// Высокий уровень — по умолчанию)
-(прц Обработать(Список.Байт данные @мут): Список.Байт
+(прц Обработать(Список.Байт данные @мут) СписокБайт(
     (Фильтровать данные
         (> 10)
         (* 2))
+    (вернуть рез)
+    )
 )
 
 (// Низкий уровень — только явно, с контекстом)
@@ -246,7 +248,7 @@ unsafe, система владения как основы материалис
 )
 
 (// Использование:)
-(асинхронно (Список.Байт данные)(
+(асинхронно (СписокБайт данные)(
     (// Внутри вызова: определение "нечто @фикс")
     (ОжидатьЗапрос)(уст данные)
     (ОбработатьДанные))

+ 25 - 23
docs/docs/01_55.md

@@ -1,6 +1,6 @@
 # pro.01_55 Диалектика формы языка программирования
 
-В качестве базовой реализации языка программирования **prolet** принята форма заключение всех сущностей в круглые скобки. На первом месте стоит контекст, имеющий смысл "в заданных границах исполни действие в скобках".
+В качестве базовой реализации языка программирования **prolet** принята форма заключение всех сущностей в круглые скобки. На первом месте стоит контекст, имеющий смысл "в заданных границах исполни действие в скобках". Единственная форма, не имеющая контекста -- пара круглых скобок: контекст отменяющий результат (см. далее).
 
 Синтаксис закрепляет онтологический принцип в форме языка.
 
@@ -15,11 +15,12 @@
 > Только процесс может породить результат.
 > Нет "значения без действия", нет "сущего без движения".
 
-Форма `(%контекст %аргумент...)` — выражает единство формы и содержания:
+Форма `(%контекст %возможно_действие %возможно_аргументы...)` — выражает единство формы и содержания:
 
 - Круглые скобки — граница процесса, как диафрагма в лёгких в разных положениях, разделяющая состояние на вдох и выдох.
-- Первый элемент *контекст* — ограничитель и цель процесса, смысловая нагрузка всей формы, вектор направления.
-- Остальное — аргументы — материалы, подвергаемые преобразованию.
+- Первый элемент *контекст* — ограничитель и цель процесса, смысловая нагрузка всей формы, вектор направления, обязателен кроме описанного случая выше.
+- Второй элемент "возможно_действие" -- действие, допустимое в текущем контексте, необязательный параметр;
+- Остальное — аргументы — необязательные материалы, подвергаемые преобразованию.
 
 Это — не просто вызов функции, это — организация труда над данными.
 
@@ -27,13 +28,12 @@
 
 Контекст — не синтаксическое украшение, он — руководящее начало, идеологический центр процесса.
 
-- `(фн ...)` -- контекст организация труда по преобразованию, труд через установление порядка
-- `(структ ...)` -- контекст организация материи, создание сложных форм материи
-- `(если ...)` -- контекст поиска сущего в практике, реализация диалектики бытия
-- (... @система ...) -- свойство, задающий условия существования предельно конкретной истины, ограничивает границы возможного конкретного предметного труда
+- `(фн ...)` -- контекст организация труда по преобразованию, труд через установление порядка;
+- `(атом ...)` -- контекст организации нуклонов, создание сложных форм материи;
+- `(если ...)` -- контекст поиска сущего в практике, реализация диалектики бытия;
+- `(... @система ...)` -- свойство, задающее условия существования предельно конкретной истины, ограничивает границы возможного конкретного предметного труда
 
-> 💡 **Контекст** — это границы процесса и руководящая роль в процессе, его деятельная партия: как партия ставит цель, организует ресурсы, руководит исполнением, контролирует процесс и определяет форму результата процесса,
-но не конкретный результат процесса.
+> 💡 **Контекст** — это границы процесса и руководящая роль в процессе, его пространство возможного: как управляющий центр организует ресурсы, руководит исполнением, контролирует процесс и определяет форму результата процесса, но не конкретный результат процесса.
 
 ## Круглые скобки — диалектическая граница состояний
 
@@ -63,15 +63,17 @@
 ### Вычисление
 
 ```prolet
-(фн CложитьКм (Км a Км b): Км(
+(фн CложитьКм (Км a Км b) Км(
     (Слож a b)
+    (вернуть рез)
+    )
 )
 ```
 
-## Определение структуры
+## Определение атома (структуры)
 
 ```prolet
-(структ Пользователь
+(атом Пользователь
     @имя     Имя
     @возраст Возраст)
 ```
@@ -114,7 +116,7 @@
 
 ### Все конструкции — процессы и функции
 
-Даже определение типа — не декларация, а процесс создания категории бытия.
+Даже определение нуклона — не декларация, а процесс создания категории бытия.
 
 Даже комментарий — является процессом:
 
@@ -124,12 +126,12 @@
 
 В данном случае, комментарий -- это не физически выполняемый контекст, а контекст на этапе компиляции, который при оптимизированный сборке может быть полностью исключён после итоговой сборки программы.
 
-Также определение типов, структур и типажей -- это процессы на этапе компиляции, которые могут быть оптимизированы и исключены в финальной сборке.
+Также определение нуклонов, атомов и типажей -- это процессы на этапе компиляции, которые могут быть оптимизированы и исключены в финальной сборке.
 
 | Элемент | Этап компиляции | Этап выполнения | Влияние на бинарный файл |
 |---------|------------------|------------------|--------------------------|
 | **Комментарий** | Генерация документации | ❌ Не выполняется | ❌ Исключается |
-| **Тип** | Статическая проверка, оптимизация | ❌ Не выполняется | ✅ Оптимизирован |
+| **Атом** | Статическая проверка, оптимизация | ❌ Не выполняется | ✅ Оптимизирован |
 | **Код** | Генерация бинарного файла | ✅ Выполняется | ✅ Сохраняется |
 
 ### Нет "пассивного кода"
@@ -157,15 +159,15 @@
 
 Для новичка:
 
-- Легко запомнить: всё — в скобках, первое — что делать.
+- Легко запомнить: всё — в скобках, первое — что возможно сделать.
 - Не нужно учить 10 синтаксисов.
-- Учится мыслить процессуально, а не декларативно.
+- Учится мыслить процессуально, а не декларативно. В конкретных материальных условиях.
 
 Для мастера:
 
-- Видит: вся система — сеть процессов.
-- Может анализировать потоки, оптимизировать, рефакторить.
-- Может бесшовно расширять ядро языка
+- Видит: вся система — сеть процессов;
+- Может анализировать потоки, оптимизировать, рефакторить;
+- Может бесшовно расширять ядро языка.
 
 ## 🎯 Заключение: (%контекст ...) как онтологическая аксиома `prolet`
 
@@ -179,8 +181,8 @@
 
 > 💡 Это — не синтаксис, это — закон языка,
 
-- как закон перехода количества в качество
-- закон отрицания отрицания
+- как закон перехода количества в качество,
+- закон отрицания отрицания,
 - закон единства и борьбы противоположностей.
 
 ### Декларация

+ 36 - 36
docs/docs/01_60.md

@@ -2,7 +2,7 @@
 
 Как было отмечено ранее, синтаксис предлагаемый с опорой на `Си` / `Rust` не поддерживает (сопротивляется) развитию семантических форм языка. Слишком много форм представления алгоритмов и структур.
 
-Более узкие семантические формы в духе S-выражений (ближе по сути к Лисп), позволяют создавать на единой базе S-выражений предсказуемые по форме выражения, но c широкой по содержанию семантикой.
+Более узкие семантические формы в духе S-выражений (ближе по сути к **Лисп**), позволяют создавать на единой базе S-выражений предсказуемые по форме выражения, но c широкой по содержанию семантикой.
 
 ## Как совместить гибкость и простоту Лиспа с материалистической строгостью и безопасностью, не падая в хаос идеализма?
 
@@ -23,14 +23,14 @@
 
 Основной принцип:
 
-- Один синтаксис — множество смыслов.
+- Один синтаксис — множество контекстов.
 - Форма — минимальна,
-- Семантика — управляема контекстом,
+- Смыслы — управляемы контекстом,
 - Развитие — через метаязык.
 
 Это — не возврат к `Lisp` , а его диалектическое преодоление:
 
-- мы берём гомоиконичность (взаимность представления кода и данных)
+- мы берём гомоиконичность (взаимность представления кода и данных),
 - макросы,
 
 но встраиваем их в рамки объективной реальности — памяти, времени, безопасности, готовности программиста.
@@ -58,35 +58,35 @@
 
 ```prolet
 (фн Копировать  @система(
-		Cис.Адрес ист
-		Cис.Адрес цель
+		CисАдрес ист
+		CисАдрес цель
 		Дом размер)(
 	(асм
 		(ЦиклОт ист до цель (
-			(рег0 загр ист)
-			(рег1 слож рег0)
-			(рег1 сохр цель))
+			(загр ист рег0)
+			(слож рег1 рег0)
+			(сохр рег1 цель))
 	))
 )
 ```
 
-### Структура данных
+### Атомы
 
 ```prolet
-(структ Пользователь
+(атом Пользователь
     @имя      ЧеловекИмя
     @возраст  ЧеловекВозраст
     @роль     Роль
 )
 ```
 
-Интерфейсный тип
+Спецификация
 
 ```prolet
-(тип ИФайл
-    (Читать (ФайлИмя имя): Рез.Байты
+(спец ИФайл
+    (Читать (ФайлИмя имя) РезБайты
       @_док "Читает файл с указанным именем")
-    (Писать (ФайлИмя имя Ос.Права права ): Опт.Ош @мут
+    (Писать (ФайлИмя имя Ос.Права права ) ОптОш @мут
         @_док "Записывает файл с указанным именем и правами")
 )
 ```
@@ -94,9 +94,9 @@
 Все конструкции — одного синтаксического вида, но семантика управляется *контекстом в начале*:
 
 - `фн` (функция),
-- `структ` (структура),
+- `атом` ,
 - `система` (низкоуровневый),
-- `тип`.
+- `спец`.
 
 ## Узкие семантические формы: от простого к сложному
 
@@ -108,7 +108,7 @@
 
 - (прц ...)
 - (фн ...)
-- (спис ...),
+- (атом ...),
 - (словарь ...),
 - (если ...),
 - (для ...)
@@ -124,19 +124,19 @@
   (Печатать "Привет, " имя "!"))
 ```
 
-Простота Лиспа, но в безопасной оболочке диалектического языка.
+Простота **Лиспа**, но в безопасной оболочке диалектического языка.
 
 ### Уровень 2: Стажёр
 
 Открываются:
 
-- (структ ...)
-- (тип ...)
+- (атом ...)
+- (спец ...)
 - (макрос ...)
 - (форма ....)
 
 ```prolet
-(структ Точка
+(атом Точка
     @x ПозX
     @y ПоpY)
 
@@ -160,10 +160,10 @@
 
 ```prolet
 (прц @система КопироватьПамять (
-      Сис.Адр цель
-      Сис.Адр источник @мут
-      Сис.Колич длина)(
-  (асм (рег3 сохр длина))
+      СисАдр цель
+      СисАдр источник @мут
+      СисКолич длина)(
+  (асм (сохр рег3 длина))
     (асм (ЦиклОт рег0 до рег2
       (...))
   ))
@@ -174,17 +174,17 @@
 
 - одобрения ревью,
 - ссылки на стандарт (например, "форма драйвера PCI"),
-- пометки обоснования @причина "взаимодействие с железом".
+- пометки обоснования `@причина` "взаимодействие с железом".
 
 ## Семантическая экономия: один синтаксис — разный смысл по контексту
 
 ```prolet
 (спис 1 2 3)
-(структ Пользователь)
+(атом Пользователь)
 (выраж ...)
-(тип Проверятор)
+(спец Проверятор)
 (список Цел 1 2 3)
-(структ ПользовательНов
+(атом ПользовательНов
   @имя     "Анна"
   @возраст 28
   @роль    Админ)
@@ -213,7 +213,7 @@
 
 - Макросы только в модулях уровня 2+,
 - Должны быть задокументированы,
-- Не могут переопределять базовые формы (`если`,  `функция` и т.п.).
+- Не могут переопределять базовые формы (`если`,  `фн` и т.п.).
 
 Это — революционное преобразование старой формы со свободным содержанием, в новую форму с дисциплиной смысла.
 
@@ -222,12 +222,12 @@
 Переход на низкий уровень — не синтаксическое волшебство, а сознательный акт:
 
 ```prolet
-(фн @система СложитьАдреса (Сис.Адр a Сис.Адр b)
+(фн @система СложитьАдреса (СисАдр a СисАдр b)
   @_обоснование "оптимизация критического участка"
   @_требует_ревью
   @_уровень_доступа 3
-    (Сложить (Сис.Извлечь a)
-             (Сис.Извлечь b))
+    (Сложить (СисИзвлечь a)
+             (СисИзвлечь b))
 )
 ```
 
@@ -250,7 +250,7 @@
 
 - `Lisp` Низкая (всё — список)
 - `Rust` Высокая (много форм)
-- `prolet` Высокая (контекст + тег)
+- `prolet` Высокая (контекст + действие)
 
 ### Гибкость
 
@@ -274,7 +274,7 @@
 
 - `Lisp` Высокая для экспертов, низкая для новичков
 - `Rust` Низкая (много правил)
-- `prolet` Высокая для всех (одна форма; много фиксированных смыслов в конкретном контексте)
+- `prolet` Высокая для всех (одна форма; много разных смыслов в разных контекстах)
 
 ### Педагогичность
 

+ 18 - 19
docs/docs/01_70.md

@@ -25,22 +25,21 @@
 
 ### Ядро (Базис)
 
-- Устойчивая основа: типы, управление, память, вызовы
-- Последовательная разработка ядра на основе реальных потребностей
-- Объективный подход ко всем аспектам языка
+- Устойчивая основа: атомы, управление, память, вызовы;
+- Последовательная разработка ядра на основе реальных потребностей;
+- Объективный подход ко всем аспектам языка.
 
 ### Расширение (Творчество)
 
-- Развитие: новые парадигмы, DSL, оптимизации, замена частей ядра
-- Частные расширения синтаксиса но основе текущих потребностей
-- Субъективная инициатива
+- Развитие: новые парадигмы, **DSL**, оптимизации, замена частей ядра,
+- Частные расширения контекстов но основе текущих потребностей,
+- Субъективная инициатива.
 
-Это — единство и борьба форм,
-где форма выражает содержание диалектики.
+Это — единство и борьба форм, где форма выражает содержание диалектики.
 
 ## Ядро: стабильное, проверенное, материалистическое
 
-Основано на S-выражениях, как в Лиспе, но семантически строго:
+Основано на S-выражениях, как в **Лиспе**, но семантически строго:
 
 ```prolet
 (// Если не указан атрибут изменяемости -- по умолчанию @фикс)
@@ -48,7 +47,7 @@
     (СложитьЧас a b))
 )
 
-(структ Пользователь
+(атом Пользователь
     @имя     ЧеловекИмя
     @возраст ЧеловекВозраст)
 
@@ -59,9 +58,9 @@
 
 Особенности ядра:
 
-- Неизменно в рамках версии 1.x.
-- Компилируется во внутреннее представление напрямую.
-- Не может быть переопределено, но может быть перекрыто частным определением.
+- Неизменно в рамках версии 1.x;
+- Компилируется во внутреннее представление напрямую;
+- Не может быть переопределено, но может быть перекрыто частным определением;
 - Создаётся централизованно на основе теории и практики.
 
 > 💡 Это — материальная база, как производительные силы в экономике — нельзя менять каждый день, но можно развивать в следующей версии, с развитием производственных отношений.
@@ -70,7 +69,7 @@
 
 Работает в таких же круглых скобках, где сопровождающий контекст `макро` означает расширение, развитие, отрицание старого на уровне пользователя. Расширение способно заменить в текущей программе более высокоуровневые реализации.
 
-Внутри — новые формы, DSL, макросы, оптимизации. Снаружи -- прежний синтаксис.
+Внутри — новые формы, **DSL**, макросы, оптимизации. Снаружи -- прежний синтаксис.
 
 ```prolet
 (макро параллельно (
@@ -89,7 +88,7 @@
 
 ### Формы ядра
 
-- Форма: `(операция аргументы)`
+- Форма: `(контекст действие аргументы)`
 - Изменяемость: Запрещена в версии
 - Компиляция: На этапе 1
 - Авторство: разработчики ядра
@@ -143,7 +142,7 @@
 
 Для мастера:
 
-- Может писать `(макро ...)`, на пользовательском уровне, но осознаёт, что это — эксперимент, что он выходит за рамки устоявшегося, что за это несёт ответственность. При компиляции получает уведомление (если не подавлено атрибутом)
+- Может писать `(макро ...)`, на пользовательском уровне, но осознаёт, что это — эксперимент, что он выходит за рамки устоявшегося, что за это несёт ответственность. При компиляции получает уведомление (если не подавлено атрибутом).
 
 Расширения разработчиками ядра могут быть:
 
@@ -158,7 +157,7 @@
 Этап 1: Парсинг ядра
 
 - Обрабатывает только системные библиотеки, строит **AST**.
-- выполняет предварительную компиляцию ядра (однократно)
+- выполняет предварительную компиляцию ядра (однократно).
 
 Этап 2: Макро-раскрытие расширений на уровне пользователя
 
@@ -187,7 +186,7 @@
 )
 
 (// === РАСШИРЕНИЕ === )
-(структ ВебСервер
+(атом ВебСервер
   @маршрут ВебОбработчик
   @порт    СетьПорт
 )
@@ -212,7 +211,7 @@
 
 Разделение форм — материальное выражение закона отрицания отрицания.
 
-> ✅ Это — не просто язык программирования, это — модель социалистического информационного общества:
+> ✅ Это — не просто язык программирования, это — модель справедливого информационного общества:
 
 - стабильный базис,
 - свободное изменение по необходимости,

+ 60 - 60
docs/docs/01_80.md

@@ -42,7 +42,7 @@
 
 ### Статика по умолчанию
 
-Вся переменная, функция, структура — строго типизированы.
+Вся переменные, функции, атомы — строго типизированы.
 
 ### Динамика — как отрицание нормы
 
@@ -64,44 +64,42 @@
 
 Новичок не может использовать динамику без одобрения.
 
-## Механизм перехода: "шлюз"
+## Механизм перехода: "@вход"
 
-Введём новую конструкцию — `шлюз`,
-который ограничивает пространство и время действия динамики.
+Введём новую конструкцию — `@вход`, которая ограничивает пространство и время действия динамики.
 
-Динамический шлюз -- это форма диалектического преодоления несовершенства внешнего мира.
+`@вход` -- это форма диалектического преодоления несовершенства внешнего мира.
 
-`@шлюз_вход`, `@шлюз_выход` — это не просто синтаксический сахар, это — граница между мирами, между упорядоченным миром `prolet` и хаосом внешних данных, между типизированным бытием и бестиповым небытием.
+`@вход`, `@выход` — это не просто синтаксический сахар, это — граница между мирами, между упорядоченным миром `prolet` и хаосом внешних данных, между типизированным бытием и бестиповым небытием.
 
-Шлюз не всегда требуется при обмене с внешним миром. Если приём данных из внешнего источника из экосистемы `prolet` -- тогда такой поток байтовых данных будет сопровождаться метками типа. В этой ситуации шлюз не нужен.
+Входы и выходы всегда требуется при обмене с внешним миром. Если приём данных из внешнего источника из экосистемы `prolet` -- тогда такой поток байтовых данных будет сопровождаться метками типа. В этой ситуации контроль на входе не нужен.
 
 ```prolet
 (// Внутри — следует использовать байтовый поток,
     тип на выходе -- `нечто`)
-(ВебЗапросить "/data"
-    @шлюз_вход
+(ВебЗапросить "/data" @вход
     @требует_ревью)(уст нечто)
 (// тип: фиксированный срез байтов)
 
 (// Обратный переход — только через проверку)
- (ЕслиНечто нечто как Структ.Пользователь
+ (ЕслиНечто нечто как Пользователь
     тогда (
-    (Привести нечто к Пользователь)
-    (уст пользователь))
+      (Привести нечто к Пользователь)
+      (уст пользователь))
     иначе (ПечатьОшибка "неверный формат")
 )
 ```
 
-Особенности шлюза:
+Особенности входа:
 
-- всегда принимает поток байт.
-- прекращает работу, если свойство `@шлюз_вход` не указано, а формат байтового потока не имеет меток типов полей.
-- Запрещён в критических модулях (ядро, безопасность).
+- всегда принимает поток байт;
+- прекращает работу, если свойство `@вход` не указано, а формат байтового потока не имеет меток типов полей;
+- Запрещён в критических модулях (ядро, безопасность);
 - Только после ревью (для уровней < 3).
 
 Это — не либерализм, а учёт требований объективной реальности, как *военный коммунизм → нэп → социализм*.
 
-Суть `@шлюз_вход`: граница между мирами
+Суть `@вход`: граница между мирами
 
 🌍 Два мира:
 
@@ -112,7 +110,7 @@
 | Порядок — внутренний        | Хаос — норма                  |
 | @конст, @фикс, @мут — везде | Никаких категорий             |
 
-`@шлюз_вход` — это не функция, это — онтологическая граница, где байт становится сущим, а хаос — формой порядка.
+`@вход` — это не свойство, это — онтологическая граница, где байт становится сущим, а хаос — формой порядка.
 
 ## Динамический тип, как переходное состояние
 
@@ -122,28 +120,28 @@
 
 ```prolet
 (// по умолчанию статичность на выходе @фикс,
-  параметр контакта с внешним миром -- @шлюз_вход)
+  параметр контакта с внешним миром -- @вход)
 (ПолучитьИзApi)(уст x)
 
 (// Ошибка: (x + 1) — запрещено)
 (ЕслиНечто x как Целое
-    тогда (ОбработатьЧисло (Привести x в Целое))
+    тогда (ОбработатьЧисло (Привести x к Целое))
     иначе (ПечатьОшибка "ожидалось число")
 )
 ```
 
 Это — материалистическое требование: чтобы работать с реальностью, нужно понять её структуру.
 
-Если данные пришли от другого `prolet`-процесса, и сериализованы с метаданными (структуры в духе `prolet`), то `@шлюз_вход` не нужен — это внутренний поток выраженный иными средствами для внешнего хаотического мира, как товарообмен в социалистическом хозяйстве между различными предприятиями в одной цепочке производства и в одной стране, но разных городах.
+Если данные пришли от другого `prolet`-процесса, и сериализованы с метаданными (структуры в духе `prolet`), то `@вход` не нужен — это внутренний поток выраженный иными средствами для внешнего хаотического мира, как товарообмен в социалистическом хозяйстве между различными предприятиями в одной цепочке производства и в одной стране, но разных городах.
 
 Но если данные — извне:
 
-- JSON без схемы,
+- `JSON` без схемы,
 - бинарный протокол,
-- CSV,
-- XML с xsi:type="string"
+- `CSV`,
+- `XML` с xsi:type="string"
 
-тогда нужен `@шлюз_вход`, потому что форма несёт в себе противоречие: `байты есть, а типов — нет`.
+тогда нужен `@вход`, потому что форма несёт в себе противоречие: `байты есть, а типов — нет`.
 
 ## Система приведения типов: "путь к статике"
 
@@ -153,32 +151,34 @@
 - Безопасное извлечение типа
 
 ```prolet
-(ЕслиНечто х как Пользователь)
-    тогда (Обработать (Привести х в Пользователь))
-    иначе (ПечатьОшибка "ожидался пользователь"))
+(ЕслиНечто х как Пользователь
+    тогда (Обработать (Привести х к Пользователь))
+    иначе (ПечатьОшибка "ожидался пользователь")
+)
 ```
 
-Приведение с проверкой `(ТипКонверт х в Пользователь)(уст х @мут)` Падает, если не подходит.
+Приведение с проверкой `(ТипКонверт х к Пользователь)(уст х @мут)` падает, если не подходит.
 
 ### Функциональный стиль
 
 Схемная валидация для сложных форматов:
 
 ```prolet
-(ЕслиНечто байты к Схема.Пользователь
+(ЕслиНечто байты к Пользователь
     тогда (
-    (Привести байты в Схема.Пользователь)
+    (Привести байты в Пользователь)
     (уст х))
-    иначе (ПечатьОшибка "ожидалось число"))
+    иначе (ПечатьОшибка "ожидалось число")
+)
 ```
 
 Переход из динамики в статику — не автоматический, а требующий сознательного усилия, как переход от чувственного восприятия к рациональному пониманию.
 
 ## Контекстно-зависимая типизация: где разрешена динамика?
 
-- ввод: файлы (Внешний мир не контролируется)
-- ввод: внешние __API__ (не из экосистемы)
-- ввод: конфигурация (не из экосистемы)
+- ввод: файлы (Внешний мир не контролируется),
+- ввод: внешние **API** (не из экосистемы),
+- ввод: конфигурация (не из экосистемы).
 
 > 💡 Это — не абсолютизация, а диалектический релятивизм: истина — в конкретной практике, границы которой задаются контекстом.
 
@@ -188,18 +188,19 @@
 
 ```prolet
 (// Сначала — динамически,
-  "ЗапросАпи" определён как @шлюз_вход, и данные как @фикс)
-(прц ЗапросАпи @шлюз_вход(): нечто(
+  "ЗапросАпи" определён как @вход, и данные как @фикс)
+(прц ЗапросАпи @вход(): нечто(
   ....)
 )
-(ЕслиНечто нечто как Схема.ФорматV1
-        тогда (...)
-        иначе (...))
+(ЕслиНечто нечто как ФорматV1
+    тогда (...)
+    иначе (...)
+)
 
 (// Через месяц практики — выносим в структур)
 (структ ФорматV1
-  @поле1 Накладная.Название
-  @поле2 Список.Целое)
+  @поле1 НакладнаяНазвание
+  @поле2 СписокЦелое)
 
 (// Использование через приведение, результат определён как @фикс)
 (ЕслиНечто х как ФорматV1
@@ -211,7 +212,7 @@
 
 Это — отрицание отрицания: динамика отрицает статику, но на основе практического действия — порождает заново безопасную статику.
 
-## Почему именно `@шлюз_вход`, а не просто функция?
+## Почему именно `@вход`, а не просто функция?
 
 Потому что:
 
@@ -221,18 +222,17 @@
 
 > 💡 Как у диалектики: `Из хаоса — порядок, из количества — качество`.
 
-## Почему `@шлюз_вход` — однонаправленный?
+## Почему `@вход` — однонаправленный?
 
 Потому что:
 
-- Вход — из байт → в типизированное сущее — требует труда, проверки, интерпретации.
+- Вход — из байт → в типизированное сущее — требует труда, проверки, интерпретации,
 - Выход — из `prolet` → в байты — может быть автоматическим, если используется самоописывающий формат (например, `prolet-bin` с метками типов).
 
-Но если выход — в неструктурированный формат (например, `raw TCP`), то нужен обратный шлюз — `@шлюз_выход`:
+Но если выход — в неструктурированный формат (например, `raw TCP`), то нужен обратный шлюз — `@выход`:
 
 ```lisp
-(фн Отправить (Пользователь x)
-    @шлюз_выход
+(фн Отправить @выход (Пользователь x)
     @цель legacy_система(
    (СериализоватьБезТипов x)
 )
@@ -240,9 +240,9 @@
 
 Это — единство и борьба: вход и выход — разные по природе, потому что мир в динамике асимметричен.
 
-## Что делает `@шлюз_вход` на уровне ВМ?
+## Что делает `@вход` на уровне ВМ?
 
-При встрече `@шлюз_вход`:
+При встрече `@вход`:
 
 - Активируется режим проверки:
 - Все значения извне — являются срезом байт.
@@ -250,12 +250,12 @@
 
 Требуется явное приведение:
 
-- `(Привести х в Пользователь)` → с проверкой.
-- Или — `(ЕслиНечто ... как Схема.ХХХ)`.
+- `(Привести х к Пользователь)` → с проверкой.
+- Или — `(ЕслиНечто ... как СхемаХХХ)`.
 
 Фиксируется событие:
 
-- В лог: `(@шлюз_выход @логОткл)` (по умолчанию активно).
+- В лог: `(@выход @логОткл)` (по умолчанию активно).
 - В граф жизненного цикла — новая ветвь анализа.
 
 ## Психологические и педагогические механизмы
@@ -280,19 +280,19 @@
 
 ```prolet
 (// Внешний API — неизвестная структура)
-(ВебЗапросить "https://api.partner/data" @шлюз_вход)
+(ВебЗапросить "https://api.partner/data" @вход)
 (уст нечто)
 
 (// Проверка и переход к статике)
-(ЕслиНечто нечто как Схема.АнализДанных)
+(ЕслиНечто нечто как АнализДанных)
     тогда (
-    (Привести нечто в Схема.АнализДанных)
+    (Привести нечто в АнализДанных)
     (уст отчёт @мут)
         (ОтправитьОтчёт отчёт))
     иначе (ПечататьОшибку "некорректные данные"))
 
 (// Определение типа на основе практики)
-(структ АнализДанных
+(атом АнализДанных
   @показатель ПроцентПлана
   @дата       АбсолютнаяМетка
   @регион     РегионПеречисление
@@ -305,9 +305,9 @@
 
 Предлагаемое решение не устраняет противоречие, а развивает отношения внутренних форм в конкретной ситуации:
 
-- Статика — не догма, а результат победы над хаосом.
-- Динамика — не свобода, а временное отступление перед объективной необходимостью, но без отрыва от реальности.
-- Переход — не скачок, а контролируемый, документируемый, педагогически организованный процесс.
+- Статика — не догма, а результат победы над хаосом,
+- Динамика — не свобода, а временное отступление перед объективной необходимостью, но без отрыва от реальности,
+- Переход — не скачок, а контролируемый, документируемый, педагогически организованный процесс,
 - Язык — не набор правил, а механизм познания реальности через типы.
 
 > ✅ Это — не просто типовая система, это — диалектика познания: *от незнания → к гипотезе (динамика) → к истине (статика).*

+ 22 - 21
docs/docs/01_90.md

@@ -1,17 +1,17 @@
 # pro.01_90 Диалектическая несостоятельность nil
 
-Очередное диалектическое противоречие для рассмотрения `сущее - не сущее`. Ошибка на миллиард долларов в нашем новом, диалектическо-материалистическом языке недопустима. Наша модель языка должна отражать реально существующий мир.
+Очередное диалектическое противоречие для рассмотрения `сущее -- не_сущее`. Ошибка на миллиард долларов в нашем новом, диалектическо-материалистическом языке недопустима. Наша модель языка должна отражать реально существующий мир.
 
 Рассмотрим корень диалектического материализма, его онтологическую основу:
 
-- `Сущее` vs `не сущее`,
+- `Сущее` vs `не_сущее`,
 - `Бытие` vs `Небытие`,
 - `Материя` vs `Пустота`,
 - `Наличие` vs `Отсутствие`.
 
 Это не просто «обработка nil» — это фундаментальное противоречие, лежащее в основе всего сущего. И если мы хотим построить язык, который отражает реально существующий мир, а не идеальный мир платоновских форм, то мы обязаны решить это противоречие диалектически, а не технически, или прагматически, или сугубо субъективно.
 
-## Философская основа: "сущее и не сущее" в диалектическом материализме
+## Философская основа: "сущее и не_сущее" в диалектическом материализме
 
 ### Материя первична — сущее есть
 
@@ -21,11 +21,11 @@
 
 `Сущее` — это то, что взаимодействует с миром, что занимает место в пространстве-времени, что оказывает воздействие.
 
-`Не сущее` — это отсутствие материи, небытие, ничто.
+`Не_сущее` — это отсутствие материи, небытие, ничто.
 
 Но! Диалектика учит: ничто не возникает из ничего, и ничто не исчезает в ничто.
 
-Следовательно, `не сущее` — не абстракция, а момент развития материи вне установленных философских категорий -- `нечто`.
+Следовательно, `не_сущее` — то, с чем нельзя взаимодействовать, а момент развития материи вне установленных философских категорий -- есть `нечто`.
 
 ### Противоречие в программировании: null, undefined, None, nil
 
@@ -43,9 +43,9 @@ String name = user.getName();
 int len = name.length();
 ```
 
-Это — не ошибка программиста, это — ошибка *онтологии языка*, который допускает, что `не сущее` может передаваться как `сущее`.
+Это — не ошибка программиста, это — ошибка *онтологии языка*, который допускает, что `не_сущее` может передаваться как `сущее`.
 
-## Идеалистические ошибки в типизации "сущее/не сущее"
+## Идеалистические ошибки в типизации "сущее/не_сущее"
 
 ### C/C++
 
@@ -90,15 +90,15 @@ int len = name.length();
 
 Нет `null`. Нет `None`. Есть `нечто` как сущее, но неопределённое.
 
-## 📔 Механизм: нечто — тип, как пространство поиска сущего
+## 📔 Механизм: нечто — особая форма материи, как пространство поиска сущего
 
 Вместо `Option<T>` или `null` — вводим сущность `нечто`, которая является типом, обозначает пространство неопределённости, в котором ещё не решено, есть ли сущее. Но сама содержащая неопределённость сущность `нечто` -- существует всегда.
 
 ```prolet
 (// 1. Внешний источник — может не дать сущего,
 если шлюз принимает данные не от prolet-процесса)
-(прц ЗапросИзАпи @шлюз_вход(): нечто
-    ...)
+(прц ЗапросИзАпи @вход () нечто
+    (...)
 )
 
 (// Внутри `нечто` — нельзя использовать напрямую,
@@ -118,9 +118,9 @@ int len = name.length();
 
 Ключевые особенности:
 
-- `нечто` — тип для определения пространства возможного.
-- Переменная `нечто` имеет значение до проверки, но не имеет определённого типа
-- После контекста `ЕслиНечто` — в ветке `тогда` переменная становится сущей.
+- `нечто` — тип для определения пространства возможного,
+- Переменная `нечто` имеет значение до проверки, но не имеет определённого типа,
+- После контекста `ЕслиНечто` — в ветке `тогда` переменная становится сущей,
 - В ветке `иначе` — альтернативное действие.
 
 Это — единство бытия и небытия в процессе познания:
@@ -147,7 +147,7 @@ let s: Option<String> = None;
 ### ✔️ Нечто — не значение, а состояние поиска
 
 ```prolet
-(прц ИзПорта @шлюз_вход (...): нечто
+(прц ИзПорта @вход (...) нечто
 	(...)
 )
 ```
@@ -160,17 +160,18 @@ let s: Option<String> = None;
 
 Потому *что ничего не есть*.
 
-## Практическая реализация: три формы работы с *не сущим*
+## Практическая реализация: три формы работы с *не_сущим*
 
 ### Форма 1: Проверка (познание через практику)
 
 ```prolet
-(НайтиПоНомеру (123 125)(уст нечто)
+(НайтиПоНомеру 123 125)(уст нечто)
 
 (ЕслиНечто нечто как Пользователь
 	тогда (
 		(Привести нечто к Пользователь)
 		(уст пользователь)
+		)
 	иначе (Пользователь Валюта))
 	(напечатать "Здравствуй, " пользователь имя))
 	иначе (напечатать "Пользователь не найден"))
@@ -181,7 +182,7 @@ let s: Option<String> = None;
 ## Форма 2: Принудительное извлечение (с ответственностью)
 
 ```lisp
-(фн ПрочитатьФайл @шлюз_вход() -> нечто)
+(фн ПрочитатьФайл @вход () нечто)
 
 (ГарантНечто нечто как Пользователь
 	@_док "данные обязательны, иначе сбой конфигурации"
@@ -211,13 +212,13 @@ let s: Option<String> = None;
 
 ### Бытие
 
-- Только то, что существует, имеет форму, действует
-- Переход от `нечто` к `сущему` через проверку
+- Только то, что существует, имеет форму, действует;
+- Переход от `нечто` к `сущему` только через проверку.
 
 ### Небытие
 
-- Не может иметь форму
-- Нет возможности перехода к сущему, и даже к нечто
+- Не может иметь форму;
+- Нет возможности перехода к сущему, и даже к нечто.
 
 ### Ошибка онтологии
 

+ 86 - 81
docs/docs/02_10.md

@@ -26,24 +26,26 @@
 
 Базовый тип — ярлык, классификация. Неподвижен.
 
-`int` , `string` , `bool`
+В терминах `prolet` базовый тип называется кварк. Кварки встроены в `prolet` и являются инвариантами информационной материи. Кварки нельзя ни отменить, не переопределить.
 
-> 💡 Противоречие: базовые типы не отражают сложность мира. Возникает потребность в практических. Базовые типы поглощаются практическими.
+`пусто`, `бул`, `байт`, `целое`, `вещ`, `строка`
 
-`struct` , `type` , `tuple`, `list`
+> 💡 Противоречие: кварки не отражают в полной мере структурную сложность мира. Возникает потребность в практических типах -- нуклонах. Нуклоны основаны на кварках.
 
-Кроме того, `Целое` — как базовый тип не просто число, а объект с поведением. Поведение объекта, способы взаимодействия с миром определяются свойствами самого объекта. С другой стороны, те же свойства объекта диалектически накладывают ограничения на тот же объект.
+`Яблоко` , `Груша` , `Час`, `СписокРабот`
+
+Кроме того, `целое` — как кварк не просто число, а объект с поведением. Поведение объекта, способы взаимодействия с миром определяются свойствами самого объекта. С другой стороны, те же свойства объекта диалектически накладывают ограничения на тот же объект.
 
 ### Снятие противоречия (синтез)
 
-Базовый тип-процесс, отношение, структура в движении. Универсальный тип, порождающий себя и служащий строительным материалом для порождения практических типов.
+Кварк, отношение, материя в движении. Универсальный тип, порождающий себя и служащий строительным материалом для порождения нуклонов.
 
 Это — не эволюция, а революция в мышлении:
 
-- базовый тип перестаёт быть статической меткой,
-- и становится практическим типом -- формой существования материи в информационной сфере.
+- кварк перестаёт быть самостоятельной сущностью,
+- и становится нуклоном -- формой существования материи в информационной сфере.
 
-> 💡 `Целое` не просто как один из типов, а как фундаментальный тип реальности.
+> 💡 `целое` не просто как один из кварков, а как фундаментальный тип реальности.
 
 ## Критика метафизического подхода к типам
 
@@ -72,95 +74,95 @@
 
 Принципы:
 
-### Практический тип — не ярлык, а категория бытия
+### Нуклон — не ярлык, а категория бытия
 
-Отражает объективную структуру предметной области
+Отражает объективную структуру предметной области.
 
-### Практический тип возникает в практике
+### Нуклон возникает в практике
 
-Не задаётся сверху, а вырастает из задачи
+Не задаётся сверху, а вырастает из задачи, из реальных условий.
 
-### Практический тип — в движении форм материи
+### Нуклон — в движении форм материи
 
-Развивается, дополняется, трансформируется
+Развивается, дополняется, трансформируется.
 
-### Практический тип — отношение форм материи
+### Нуклон — отношение форм материи
 
-Не изолирован, а связан с другими типами, с памятью, с временем
+Не изолирован, а связан с другими нуклонами через кварки, с памятью, с временем.
 
-### Практический тип — результат познания материи
+### Нуклон — результат познания материи
 
-Чем глубже понимание — тем точнее тип. Практический тип — это не только ответ на вопрос "что это", но и "почему", "каким образом", "зачем".
+Чем глубже понимание — тем точнее свойства нуклона. Нуклон — это не только ответ на вопрос "что это", но и "почему", "каким образом", "зачем".
 
 ## Путь от базового к универсальному: три стадии онтологического развития
 
 ### Стадия 1: Отрицание абстрактов (антипод метафизике)
 
-Мы отрицаем существование "абстрактных типов" как таковых.
+Мы отрицаем существование "абстрактных типов" как таковых. Как свободные кварки отсутствуют в природе, так и:
 
 Нет `int` . Есть `Счёт` , `Индекс` , `Количество` , `КодОшибки` .
 
 Нет `string` . Есть `Имя` , `Хэш` , `Запрос` , `Ответ` .
 
 ```prolet
-(тип Рубль или Рубля или Рублей (// синонимы типа)
-  (// Абстракция в основе типа)
-  @_база    Целое
+(нуклон Рубль или Рубля или Рублей (// синонимы типа)
+  (// Абстракция на основе кварка)
+  @_база    целое
 
-  (// Допустимый диапазон на базе абстрактного типа)
+  (// Допустимый диапазон на базе кварка)
   @_диапазон (0 999_999_999)
 
   (// Допустимые операции над конкретным типом)
   @_операции (слож выч))
 ```
 
-> 💡 Базовый тип не уничтожен, но воспроизведён на новом уровне — уровне практического типа как осмысленная категория.
+> 💡 Кварк не уничтожен, но воспроизведён на новом уровне — уровне нуклона как осмысленная категория с политиками общественных отношений.
 
-### Онтологическое уточнение: атрибут `@_база Целое`
+### Онтологическое уточнение: атрибут `@_база целое`
 
-Атрибут `@_база` опирается на математическую абстракцию `Целое`, но по отношению к материалистичному миру является сущим *только в рамках математического дискурса*. Т.е. математические типы не ограничиваются типом `Целое`. Но этим типом ограничивает аппаратура. Аппаратный тип `Целое` обобщается таким же математическим типом с известными наложенными ограничениями.
+Атрибут `@_база` опирается на кварк `целое`, но по отношению к материалистичному миру является сущим *только в рамках физического дискурса*. Т.е. кварки не ограничиваются типом `целое`. Но этим типом ограничивает мир цифровой материи в своей основе. Кварк `целое` обобщается конкретным нуклоном с известными наложенными ограничениями (политиками).
 
-Это — *ключевое* уточнение, которое позволяет не отступать от диалектического материализма, но признать относительную самостоятельность аппаратного, равно и математического мышления как *специфической формы отражения реальности*.
+Это — *ключевое* уточнение, которое позволяет не отступать от диалектического материализма, но признать относительную самостоятельность цифрового, равно и математического мышления как *специфической формы отражения реальности*.
 
 ### Интерпретация
 
 | ПОНЯТИЕ                | СТАТУС В ОНТОЛОГИИ PROLET                                                                                                                                                                                                                                                                                                                          |
 |------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Математический дискурс | Специфическая математическая практика, в которой абстракция (вроде `Целое`) обращаются как не первичная данность, а результат высшего обобщения практики счёта (считали камни, яблоки, дни — и выделили общую форму)                                                                                                                                 |
-| Языковой дискурс       | Специфическая общественная практика, в которой абстракция `Целое` приобретает явные множественные формы (число камней, яблок, дней) с общими и частными атрибутами, но контекст задаётся программистом (определяется конкретный тип).                                                                                                                |
+| Физический дискурс | Специфическая физическая практика, в которой абстракция (вроде кварка `целое`) обращаются как первичная данность, и результат высшего обобщения физической практики (исследовали камни, яблоки, дни — и выделили первичную форму)                                                                                                                                 |
+| Языковой дискурс       | Специфическая общественная практика, в которой кварк `целое` приобретает явные множественные формы (число камней, яблок, дней) с общими и частными атрибутами, но контекст задаётся программистом (определяется конкретный тип).                                                                                                                |
 | Аппаратный дискурс     | Специфическая вычислительная практика, в которой произвольно смоделированный тип программистом отражается на реально существующую аппаратуру в доступной форме. В ходе изменения формы сущности преходят атрибуты типа, которые фактически становятся ограниченными конкретными операциями в конкретном алгоритме (переход качества в количество). |
-| @_база                 | Указание на форму, заимствованную из математического дискурса, но используемую как инструмент для организации сущего                                                                                                                                                                                                                               |
+| @_база                 | Указание на форму, заимствованную из физического дискурса, но используемую как инструмент для организации сущего                                                                                                                                                                                                                               |
 
 Это — далеко от платонизма, по сути это признание автономии отражения на разных уровнях бытия.
 
-Как язык отражает мир, так и аппаратура, так и математика — отражает количественные отношения, и эти отношения не существуют вне практики.
+Как язык отражает мир, так и аппаратура, так и физика — отражает количественные отношения, и эти отношения не существуют вне практики.
 
-## 📜 Принципы объявления практических типов `prolet`
+## 📜 Принципы объявления нуклонов `prolet`
 
-- Практический тип — только материализованная форма сущего
-- `Целое`,  `Строка`,  `Дробное`,  `Логическое` — базовые типы, получающие отражение на низком уровне в аппаратуру.
-- `@база` — не наследование, а заимствование формы из дискурса математического аппарата
-- Практический тип всегда имеет социальный, экономический или технический контекст
-- Без атрибутов, отражающих практику — *нет типа*
-- Определение вида c использованием математического типа `(тип Целое ...)` — ошибка онтологии, запрещено
-- Практический тип может быть построен на любом базовом типе, но только одном базовом типе. Но атрибутов базового типа может быть по необходимости.
+- Нуклон — только материализованная форма сущего
+- `целое`,  `строка`,  `вещ`,  `бул`, `байт`, `пусто` — связанные кварки, получающие отражение на низком уровне в аппаратуру (реальность).
+- `@_база` — не наследование, а заимствование формы из дискурса физического аппарата
+- Нуклон всегда имеет социальный, экономический или технический контекст
+- Без атрибутов, отражающих практику — *нет нуклона*
+- Определение вида c использованием кварка `(нуклон целое ...)` — ошибка онтологии, запрещено
+- Нуклон может быть основан на любом кварке, но только одном кварке. Но атрибутов нуклона может быть по необходимости.
 
 ## Стадия 2: Сложное — как единство противоположностей
 
-Структура — не просто набор свойств, а единство противоречий:
+Атом — не просто структура с набор свойств, а единство противоречий:
 
 ```prolet
 
-(// любой тип имеет одно значение и один базовый тип,
-		не число атрибутов может быть любым)
-(тип Роль или Права
+(// любой нуклон построен на единственном кварке,
+        но число атрибутов может быть любым)
+(нуклон Роль или Права
     @_обязательно
     @_база Перечисление
     @_выбор_ (Админ Пользователь Гость)
     @значение Гость (// По умолчанию, можно менять)
     @_док "Роль пользователя в системе"
 
-(тип ПользовательНомер
+(нуклон ПользовательНомер
     @_обязательно
     @_база          Целое
     @_диапазон      (1 999_999_999)
@@ -168,12 +170,14 @@
     @_уникально
     @_док ( "идентификация пользователя в системе")
 
-(тип Имя или Название
+(нуклон Имя или Название
     @_база      Строка
     @_умолчание "Иван"
     @_док       "идентификация пользователя в системе")
 
-(структ Пользователь
+(// любой атом имеет множество нуклонов и атомов,
+        но число атрибутов может быть любым)
+(атом Пользователь
     @_номер ПользовательНомер
     @имя  Имя (// Можно менять)
     @счёт Счёт
@@ -182,20 +186,20 @@
 )
 ```
 
-Свойство в структуре может ссылаться только на практические типы или на структуру (эту же или другую) — то есть на материализованное сущее (тип или структура).
+Свойство в атоме может ссылаться только на нуклоны или на атом (этот же или другой) — то есть на материализованное сущее (нуклон или атом).
 
-Структуры и типы, которые содержит конкретная структура могут быть определены позже, но до момента начала семантического анализа.
+Атом, который содержит другой атом или нуклоны -- могут быть определены позже, но до момента начала семантического анализа.
 
-Прямая ссылка на базовый тип вне практического типа — запрещена.
+Прямая ссылка на кварк вне нуклона — запрещена.
 
-Все атрибуты в типе, помечены префиксами:
+Все атрибуты в нуклоне, помечены префиксами:
 
 - `@_база` -- системный, нельзя изменить
 - `@значение` -- пользовательский, можно изменять.
 
-В приведённом синтаксисе объявления структуры достигается единство формы и содержания:
+В приведённом синтаксисе объявления атома достигается единство формы и содержания:
 
-- Разделение "атрибут vs поле" — идеализм, ведущий к ложному противопоставлению "сущности" и "её атрибутов". В предлагаемом подходе всё является атрибутом. Абстракция `Целое` *должна* быть отражена на реально существующий носитель, который *неизбежно* приобретает дополнительные атрибуты.
+- Разделение "атрибут vs поле" — идеализм, ведущий к ложному противопоставлению "сущности" и "её атрибутов". В предлагаемом подходе всё является свойством. Кварк `целое` *должен* быть отражён на реально существующий носитель -- нуклон, который *неизбежно* приобретает дополнительные атрибуты (в том числе контракт, как социальная политика).
 - В реальности — есть только объект с характеристиками: у человека — имя, возраст, роль, статус, история.
 - Нет "основных данных" и "метаданных" — есть все данные как единое сущее.
 
@@ -203,30 +207,30 @@
 
 |      АСПЕКТ       | ОБЪЯСНЕНИЕ                                                                                                                                                                                                                  |
 |:-----------------:|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-|     Онтология     | Практический тип — не шаблон, а форма сущего в практике. Если в практике номер всегда уникален и присваивается автоматически, то такое значение — часть его бытия, а не внешнее условие. Контекст не может переопределить базовый тип. |
-|  Единство формы   | Если ПользовательНомер используется в 10 структурах — не нужно 10 раз писать `@уникально`. Нарушение — на уровне типа, а не контекста.                                                                                        |
-|   Безопасность    | Система гарантирует уникальность и обязательность на уровне типа, а не доверяет типу "не забыть".                                                                                                                           |
-| Эволюция практики | Если правило изменится (например, номер перестанет быть авто-инкрементным), —  меняется один атрибут в типе, а не в конкретном контексте.                                                                                  |
+|     Онтология     | Нуклон — не шаблон, а форма сущего в практике. Если в практике номер всегда уникален и присваивается автоматически, то такое значение — часть его бытия, а не внешнее условие. Контекст не может переопределить его кварк. |
+|  Единство формы   | Если ПользовательНомер используется в 10 атомах — не нужно 10 раз писать `@уникально`. Нарушение — на уровне нуклона, а не контекста.                                                                                        |
+|   Безопасность    | Система гарантирует уникальность и обязательность на уровне нуклона, а не доверяет нуклону.  "не забыть".                                                                                                                           |
+| Эволюция практики | Если правило изменится (например, номер перестанет быть авто-инкрементным), —  меняется один атрибут в нуклоне, а не в конкретном контексте.                                                                                  |
 
 ### Принципы проектирования в prolet
 
-- Тип несёт свои нормы: `@обязательно`, `@уникально`, `@авто-инкремент`, `@умолчание` — определяются в (тип ...)
-- Структура — композиция, а не конфигурация: она не задаёт правила, а использует уже заданные
-- Свойства в структуре — только контекстные: например, `@источник`, `@момент`, `@ответственный`, но не свойства базового типа
-- Повторное указание атрибутов типа в структуре — избыточно и запрещено, но не запрещены свойства самого свойства (свойство структуры рассматривается как тип на своём уровне)
-- Тип — со всеми своими атрибутами, законченная форма сущего, пригодная к использованию в любой структуре
+- Нуклон несёт свои нормы: `@обязательно`, `@уникально`, `@авто-инкремент`, `@умолчание` — определяются в (нуклон ...)
+- Атом — композиция нуклонов, а не конфигурация: она не задаёт правила, а использует уже заданные
+- Свойства в атоме — только контекстные: например, `@источник`, `@момент`, `@ответственный`, но не свойства кварков
+- Повторное указание свойств типа в атоме — избыточно и запрещено, но не запрещены свойства самого свойства (свойство атома рассматривается как нуклон на своём уровне)
+- Нуклон — со всеми своими атрибутами, законченная форма сущего, пригодная к использованию в любом атоме
 
-## Форма 3: типаж — тип как отношение
+## Форма 3: спецификация — тип как отношение
 
 ```prolet
-(типаж Хранилище
+(спец Хранилище
     @_док "Абстракция работы с хранилищем"
-	(Нов (ХранилищеИмя имя): Результат Хранилище)
+	(Нов (ХранилищеИмя имя) Результат Хранилище)
 		@_док "Создаёт новое именованное хранилище"
-    (ПолучФайл (ИмяФайла имя): Результат Спис.Байт)
+    (ПолучФайл (ИмяФайла имя) Результат СписБайт)
         @_док "Читает файл с диска")
     (ЗаписатьФайл (ИмяФайла  имя
-				   Спис.Байт данные): Результат Бул @мут)
+				   СписБайт данные) Результат ЕслиОк @мут)
         @_док "Записывает файл на диск")
     (ЗакрытьХранилище)
 )
@@ -235,20 +239,20 @@
 (хран ПолучФайл "test.txt")
 ```
 
-Типаж определяется не сущностью, а связями — как в диалектике.
+Спецификация определяется не сущностью, а связями — как в диалектике.
 
-- типаж — объявляет форму взаимодействия, а не математическую сигнатуру
+- спецификация — объявляет форму взаимодействия, а не математическую сигнатуру
 - Каждое действие — глагол, отражающий практику
-- Параметры: `(%Тип %имя %Тип %данные)` — именованные, ссылаются на типы
-- Возврат: (%Результат %Тип) — структура, отражающая результат практики
+- Параметры: `(%Тип %имя %Тип %данные)` — именованные, ссылаются на нуклоны и атомы
+- Возврат: (%Результат %Тип) — атом, отражающий результат практики
 - Возвращаемый результат может отсутствовать
-- Все типы в типаже — практические, определённые через (тип, структ, ...)
-- @_док и др. атрибуты — не обязательны для каждого метода и типажа, но можно потребовать обязательность на уровне проекта или конкретного действия
-- Типаж не содержит реализации — только действия с параметрами и возвращаемые значения
+- Все нуклоны и атомы в спецификации — практические, кварки запрещены, определённые через (нуклон, атом, ...)
+- @_док и др. свойства — не обязательны для каждого метода и спецификации, но можно потребовать обязательность на уровне проекта или конкретного действия
+- Спецификация не содержит реализации — только действия с параметрами и возвращаемые значения
 
 ## Онтологическая иерархия типов
 
-> 💡 Это — спираль развития, а не лестница. Каждый новый тип — не просто добавление,  а результат борьбы и единства противоположностей.
+> 💡 Это — спираль развития, а не лестница. Каждый новый уровень — не просто добавление, а результат борьбы и единства противоположностей.
 
 ```mermaid
 flowchart LR
@@ -256,13 +260,14 @@ subgraph Практика
     direction TB
     Субъект --> Цели
     Цели --> Задачи
-    Задачи --> Атрибуты
+    Задачи --> Свойства
 end
 subgraph prolet
     direction TB
-    Типажи --> Структуры
-    Структуры --> Типы
-    Типы --> БазовыеТипы
+    Спецификации --> Атомы
+    Спецификации --> Нуклоны
+    Атомы --> Нуклоны
+    Нуклоны --> Кварки
 end
 
 subgraph СинтезАппарат
@@ -278,8 +283,8 @@ prolet --> СинтезАппарат
 
 ## Практические гарантии онтологии
 
-- Нет "голых" примитивов в публичных типажах.
-- Все типажи — документированы, семантически обогащены.
+- Нет "голых" примитивов в публичных спецификациях.
+- Все спецификации — документированы, семантически обогащены.
 - Переход от простого к сложному — не волевой, а мотивированный практикой.
 - Форма — не обязательна, но поощряется в крупных системах.
 
@@ -288,7 +293,7 @@ prolet --> СинтезАппарат
 - предложенная онтология отрицает метафизику примитивов,
 - Разрешает противоречие между простым и сложным,
 - Снимает противоречие в универсальной форме,
-- Делает типаж не абстрактной сущностью, а категорией бытия, движения и отношения.
+- Делает спецификацию не абстрактной сущностью, а категорией бытия, движения и отношения.
 
 Это — не просто система типов, это — модель познания мира: