Персональный проект лабораторных: титульный лист СФУ, удалены данные компании и справочники сотрудников

.gitignore

@@ -13,3 +13,6 @@ archives/
 __pycache__/
 *.pyc
 tmp/
+
+# Артефакты сессий ZCode
+.zcode/

.template/companies/logo.svg

@@ -1,18 +1,4 @@
-<svg width="1174" height="734" viewBox="0 0 1174 734" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path fill-rule="evenodd" clip-rule="evenodd" d="M751.5 592V208H870.5V592H751.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M601.5 734V208H720.5V734H601.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M451.5 663V208H570.5V663H451.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M301.5 521V208H420.5V521H301.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M151.5 389V208H270.5V389H151.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 302V208H121.5V302H1.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M900.5 419V208H1020.5V419H900.5Z" fill="black"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M1050.5 284V206H1170.5V284H1050.5Z" fill="black"/>
-<path d="M1137.56 184.124L1136.36 160.159V94.4931C1136.36 88.2621 1134.04 83.3891 1129.41 79.8741C1124.78 76.1994 1118.39 74.3621 1110.24 74.3621C1102.41 74.3621 1096.02 76.0397 1091.07 79.3948C1086.28 82.5902 1083.48 87.1437 1082.68 93.0552H1046.5C1047.3 83.6287 1050.49 75.5603 1056.08 68.85C1061.68 62.1397 1069.18 57.027 1078.61 53.5121C1088.19 49.8374 1099.3 48 1111.92 48C1124.38 48 1135.24 49.9172 1144.51 53.7517C1153.77 57.4264 1160.88 62.9385 1165.83 70.2879C1170.94 77.4776 1173.5 86.3448 1173.5 96.8897V184.124H1137.56ZM1094.9 187C1086.12 187 1078.37 185.322 1071.66 181.967C1064.95 178.452 1059.76 173.659 1056.08 167.588C1052.41 161.517 1050.57 154.647 1050.57 146.978C1050.57 133.237 1055.85 122.613 1066.39 115.103C1077.09 107.434 1091.79 103.6 1110.48 103.6H1139.95V129.483L1109.52 129.722C1102.65 129.722 1097.14 131.001 1092.99 133.557C1088.99 135.953 1087 139.628 1087 144.581C1087 148.096 1088.43 151.132 1091.31 153.688C1094.34 156.244 1098.58 157.522 1104.01 157.522C1111.52 157.522 1118.15 155.685 1123.9 152.01C1129.81 148.176 1134.68 142.983 1138.52 136.433L1142.59 161.597C1138.59 170.384 1132.44 176.855 1124.14 181.009C1115.99 185.003 1106.25 187 1094.9 187Z" fill="black"/>
-<path d="M942.663 185V52.4485H980.071V185H942.663ZM899.5 185V154.961H1024.5V185H899.5ZM916.286 82.4871V52.4485H961.367V82.4871H916.286ZM941.224 34.8067V0H981.031V34.8067H941.224Z" fill="black"/>
-<path d="M823.27 184C814.318 184 806.405 182.018 799.531 178.054C792.816 173.932 787.621 168.303 783.944 161.168C780.267 153.875 778.429 145.63 778.429 136.434V29.6481L815.837 13V136.434C815.837 140.556 816.396 143.965 817.515 146.661C818.794 149.197 821.032 151.1 824.23 152.369C827.587 153.478 832.223 154.033 838.138 154.033H874.5V184H823.27ZM749.5 81.733V51.7663H845.163V81.733H749.5Z" fill="black"/>
-<path d="M687.239 186V104.477C687.239 97.6637 685.488 92.1972 681.985 88.0775C678.482 83.9577 672.69 81.8979 666.957 81.8979C660.429 81.8979 654.378 84.1162 648.805 88.5528C643.391 92.831 637.658 100.278 631.608 110.894L626.353 79.5211C632.404 69.2218 639.728 61.9331 648.327 57.6549C656.926 53.2183 665.684 51 674.601 51C684.792 51 694.644 53.1391 701.809 57.4173C709.134 61.6954 714.707 67.6373 718.529 75.243C722.51 82.8486 724.5 91.8011 724.5 102.1V186H687.239ZM599.993 185.676L599.5 53.5285H635.566L634.713 77.382L636.761 185.676H599.993Z" fill="black"/>
-<path d="M511.243 187C496.971 187 484.681 184.204 474.374 178.612C464.225 173.02 456.375 165.032 450.825 154.647C445.275 144.261 442.5 131.879 442.5 117.5C442.5 102.961 445.275 90.4989 450.825 80.1138C456.375 69.7287 464.383 61.8201 474.849 56.3879C485.474 50.796 498.239 48 513.146 48C536.456 48 553.345 54.7103 563.811 68.131C574.435 81.392 578.875 99.6856 577.131 123.012H471.995L472.233 97.369H539.311C538.835 91.2977 536.139 86.4247 531.223 82.75C526.307 78.9155 520.202 76.9983 512.908 76.9983C501.49 76.9983 493.086 80.5931 487.694 87.7828C482.303 94.9724 479.607 105.437 479.607 119.178C479.607 126.048 480.796 132.359 483.175 138.11C485.553 143.862 489.042 148.495 493.641 152.01C498.398 155.366 504.265 157.043 511.243 157.043C518.696 157.043 524.96 155.206 530.034 151.531C535.267 147.856 538.438 143.223 539.549 137.631H576.655C575.07 152.809 568.409 164.872 556.675 173.819C545.099 182.606 529.955 187 511.243 187Z" fill="black"/>
-<path d="M343.318 185V52.4485H380.427V185H343.318ZM300.5 185V154.961H424.5V185H300.5ZM317.151 82.4871V52.4485H361.872V82.4871H317.151ZM341.891 34.8067V0H381.378V34.8067H341.891Z" fill="black"/>
-<path d="M212.691 187C198.713 187 186.641 184.204 176.475 178.612C166.468 173.02 158.764 165.032 153.363 154.647C148.121 144.261 145.5 131.879 145.5 117.5C145.5 102.801 148.28 90.2592 153.839 79.8741C159.558 69.4891 167.5 61.5805 177.666 56.1483C187.832 50.7161 199.825 48 213.644 48C225.717 48 236.359 50.1569 245.572 54.4707C254.944 58.7845 262.33 64.8558 267.731 72.6845C273.291 80.3534 276.309 89.5402 276.785 100.245H239.616C238.345 92.8954 235.486 87.4632 231.038 83.9483C226.749 80.2736 220.951 78.4362 213.644 78.4362C207.608 78.4362 202.208 79.954 197.442 82.9897C192.836 86.0253 189.182 90.419 186.482 96.1707C183.94 101.922 182.67 109.032 182.67 117.5C182.67 130.122 185.529 139.868 191.247 146.738C197.125 153.608 204.273 157.043 212.691 157.043C217.616 157.043 221.904 156.164 225.558 154.407C229.37 152.649 232.547 150.173 235.088 146.978C237.63 143.622 239.377 139.868 240.33 135.714H277.5C276.547 146.099 273.211 155.126 267.493 162.795C261.774 170.464 254.229 176.455 244.857 180.769C235.486 184.923 224.764 187 212.691 187Z" fill="black"/>
-<path d="M63.0286 187C50.6183 187 39.7196 185.003 30.3323 181.009C20.9451 176.855 13.6262 171.023 8.37574 163.514C3.28435 155.845 0.659105 146.818 0.5 136.433H35.1055C34.7873 143.782 37.0943 149.534 42.0266 153.688C47.118 157.842 54.0391 159.919 62.7899 159.919C69.1542 159.919 74.2456 158.88 78.0641 156.803C82.0417 154.567 84.0306 151.531 84.0306 147.697C84.0306 144.341 82.5191 141.705 79.4961 139.788C76.6321 137.711 72.8136 136.113 68.0404 134.995C63.2673 133.717 58.0168 132.518 52.2889 131.4C46.5611 130.122 40.7538 128.604 34.8669 126.847C29.1391 125.089 23.8886 122.772 19.1154 119.897C14.3422 116.861 10.4441 112.947 7.4211 108.153C4.5572 103.201 3.12525 97.0494 3.12525 89.7C3.12525 81.2322 5.51183 73.8828 10.285 67.6517C15.0582 61.4207 21.6611 56.6276 30.0937 53.2724C38.6854 49.7575 48.55 48 59.6874 48C76.7117 48 90.4744 51.9943 100.975 59.9828C111.635 67.8115 117.522 78.8356 118.636 93.0552H84.2692C83.951 87.1437 81.5644 82.6701 77.1095 79.6345C72.6545 76.5989 66.9267 75.081 59.926 75.081C54.0391 75.081 49.3455 76.1195 45.8452 78.1965C42.3448 80.2736 40.5947 83.3891 40.5947 87.5431C40.5947 90.8983 42.0266 93.5345 44.8905 95.4517C47.9135 97.2092 51.8116 98.6471 56.5848 99.7655C61.358 100.884 66.6085 101.922 72.3363 102.881C78.2232 103.84 84.0306 105.198 89.7584 106.955C95.4862 108.553 100.737 110.79 105.51 113.666C110.283 116.541 114.102 120.376 116.965 125.169C119.989 129.962 121.5 136.113 121.5 143.622C121.5 157.203 116.17 167.828 105.51 175.497C95.0089 183.166 80.8485 187 63.0286 187Z" fill="black"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 220">
+  <rect x="8" y="8" width="584" height="204" rx="20" fill="#f5f5f5" stroke="#999" stroke-width="8" stroke-dasharray="18 12"/>
+  <text x="300" y="126" text-anchor="middle" font-family="Arial, sans-serif" font-size="44" font-weight="700" fill="#777">ЛОГОТИП</text>
 </svg>

.template/companies/scientia/data.json

@@ -1,21 +1,21 @@
 {
-    "name": "ООО «Скиентия»",
+    "name": "Личный проект",
     "short-name": "scientia",
     "brand-color": "#e39f49",
-    "email": "info@scientia.ru",
-    "website": "scientia.ru",
-    "phone": "+7 (922) 203-24-60",
-    "address": "620014, Свердловская область,\nг. Екатеринбург,\nул. Тверитина, 43",
-    "inn": "6686148633",
-    "kpp": "665801001",
-    "ogrn": "1236600002572",
-    "bank": "ООО «Банк Точка»",
-    "ks": "30101810745374525104",
-    "bik": "044525104",
-    "director-title": "Директор",
-    "director-name": "А.С. Мусихин",
-    "company_info": "ООО «Скиентия» ИНН 6686148633\nул. Шейнкмана, стр. 9, офис 65\nг. Екатеринбург, 620014, Россия\n+7 (922) 203-24-60 ☏\ninfo@scientia.ru 🖂",
-    "city": "Екатеринбург",
+    "email": "",
+    "website": "",
+    "phone": "",
+    "address": "",
+    "inn": "",
+    "kpp": "",
+    "ogrn": "",
+    "bank": "",
+    "ks": "",
+    "bik": "",
+    "director-title": "Автор",
+    "director-name": "Ткаченко А.С.",
+    "company_info": "",
+    "city": "Красноярск",
     "logo_image": "companies/logo.svg",
     "sign_image": null,
     "stamp_image": null

.template/companies/technology/data.json

@@ -1,22 +0,0 @@
-{
-  "name": "ООО «Скиентия Технологии»",
-  "short-name": "scientia",
-  "brand-color": "#e39f49",
-  "email": "technology@scientia.ru",
-  "website": "scientia.ru",
-  "phone": "+7 (922) 203-24-60",
-  "address": "620014, Свердловская область,\nг. Екатеринбург,\nул. Тверитина, 41, 434",
-  "inn": "6685220911",
-  "kpp": "668501001",
-  "ogrn": "1246600037771",
-  "bank": "Филиал «Екатеринбургский» АО «АЛЬФА-БАНК»",
-  "ks": "30101810100000000964",
-  "bik": "046577964",
-  "director-title": "Директор",
-  "director-name": "И.А. Гузеев",
-  "company_info": "ООО «Скиентия Технологии» ИНН 6685220911\nул. Тверитина, д. 41\nг. Екатеринбург, 620026, Россия\n+7 (995) 541-90-83 ☏\ninfo@scientia.ru 🖂",
-  "city": "Екатеринбург",
-  "logo_image": "companies/logo.svg",
-  "sign_image": null,
-  "stamp_image": null
-}

.template/companies/test-company/data.json

@@ -1,22 +0,0 @@
-{
-  "name": "ООО «Тестовая компания»",
-  "short-name": "Тест",
-  "brand-color": "#e39f49",
-  "email": "document@example.invalid",
-  "website": "example.invalid",
-  "phone": "+7 (000) 000-00-00",
-  "address": "000000, Тестовый регион, г. Пример, ул. Проверочная, 1",
-  "inn": "0000000000",
-  "kpp": "000000000",
-  "ogrn": "0000000000000",
-  "bank": "Тестовый банк",
-  "ks": "00000000000000000000",
-  "bik": "000000000",
-  "director-title": "Директор",
-  "director-name": "И.И. Тестов",
-  "company_info": "ООО «Тестовая компания» ИНН 0000000000\nг. Пример, ул. Проверочная, 1\n+7 (000) 000-00-00\ndocument@example.invalid",
-  "city": "Пример",
-  "logo_image": "companies/test-company/logo.svg",
-  "sign_image": "companies/test-company/sign.svg",
-  "stamp_image": "companies/test-company/stamp.svg"
-}

.template/companies/test-company/logo.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 220">
-  <rect width="600" height="220" rx="24" fill="#fbb20d"/>
-  <text x="300" y="112" text-anchor="middle" font-family="Arial, sans-serif" font-size="66" font-weight="700" fill="#111">TEST COMPANY</text>
-  <text x="300" y="166" text-anchor="middle" font-family="Arial, sans-serif" font-size="28" fill="#111">synthetic fixture</text>
-</svg>

.template/companies/test-company/sign.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 180">
-  <path d="M25 135 C90 25, 120 165, 185 55 S270 160, 330 60 S420 155, 565 35" fill="none" stroke="#2456c4" stroke-width="10" stroke-linecap="round"/>
-  <text x="300" y="174" text-anchor="middle" font-family="Arial, sans-serif" font-size="24" fill="#2456c4">TEST SIGNATURE</text>
-</svg>

.template/companies/test-company/stamp.svg

@@ -1,7 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 420 420">
-  <circle cx="210" cy="210" r="185" fill="none" stroke="#3b76a8" stroke-width="12"/>
-  <circle cx="210" cy="210" r="142" fill="none" stroke="#3b76a8" stroke-width="5"/>
-  <text x="210" y="190" text-anchor="middle" font-family="Arial, sans-serif" font-size="46" font-weight="700" fill="#3b76a8">TEST</text>
-  <text x="210" y="245" text-anchor="middle" font-family="Arial, sans-serif" font-size="30" fill="#3b76a8">NOT VALID</text>
-  <text x="210" y="292" text-anchor="middle" font-family="Arial, sans-serif" font-size="22" fill="#3b76a8">FIXTURE ONLY</text>
-</svg>

.template/companies/too/data.json

@@ -1,19 +0,0 @@
-{
-    "name": "ТОО «Скиентия»",
-    "short-name": "scientia",
-    "brand-color": "#e39f49",
-    "email": "info@weare.science",
-    "website": "weare.science",
-    "phone": "+7(777)635-63-10",
-    "address": "Республика Казахстан, 030007, Актюбинская область, город Актобе, проспект Абилкайыр-хана, дом 2, офис 72",
-    "address_en": "Republic of Kazakhstan, 030007, Aktobe Region, Aktobe city, Abilkhair Khan Avenue, building 2, office 72",
-    "bin": "231240017437",
-    "kbe": "17",
-    "director-title": "Директор",
-    "director-name": "Б.Т. Ильясов",
-    "company_info": "ТОО «Скиентия» БИН/ИИН 231240017437\nРеспублика Казахстан\nАктюбинская область г.Актобе, 030000\nпр-кт Абулхаир хана, 77\ninfo@weare.science 🖂",
-    "city": "Актобе",
-    "logo_image": "companies/logo.svg",
-    "sign_image": null,
-    "stamp_image": null
-}

.template/development/docs/ARCHITECTURE.md

@@ -1,251 +0,0 @@
-# Архитектура шаблона документов Scientia
-
-## Системный контекст
-
-```text
-┌────────────────────┐  редактирует  ┌──────────────────────────────────┐
-│ Автор документа    │ ────────────▶ │ main.typ + chapters/ + assets/  │
-└─────────┬──────────┘               └────────────────┬─────────────────┘
-          │ читает                                    │ один import фасада
-          ▼                                           ▼
-┌────────────────────┐               ┌──────────────────────────────────┐
-│ docs/              │               │ .template/lib/                  │
-│ инструкции и       │               │ domain → application →          │
-│ примеры            │               │ infrastructure → presentation   │
-└────────────────────┘               └────────────────┬─────────────────┘
-                                                      │
-┌────────────────────┐  условный import               │ PDF
-│ .private/          │ ────────────▶ main.typ ─────────┤
-│ PNG + settings.typ │  один boolean                  ▼
-                                             ┌────────────────────┐
-                                             │ document.pdf       │
-                                             └────────────────────┘
-
-┌────────────────────┐  сопровождает  ┌─────────────────────────────────┐
-│ Разработчик        │ ─────────────▶ │ .template/development/          │
-│ шаблона            │                │ docs + modules + tests + tools  │
-└────────────────────┘                └─────────────────────────────────┘
-```
-
-Публичная и developer-документация физически разделены. Автору не требуется открывать `.template/`, а разработчик не использует `docs/` как описание внутренних контрактов.
-
-## Архитектурные принципы
-
-1. **Один файл ежедневной настройки**. Компания, режим, metadata и `#include` находятся в `main.typ`.
-2. **Режим — значение, а не entrypoint**. `final`, `draft` и `clean-copy` являются вариантами одной переменной.
-3. **Публичное видно**. Инструкции и примеры находятся в `docs/`, который VS Code не скрывает.
-4. **Разработка скрыта**. Библиотека, tests, ADR и tools находятся в `.template/`.
-5. **Пример является исполняемой документацией**. Один исходник одновременно обучает, компилируется в CI и устанавливается как тип документа.
-6. **Важные параметры явные**. Даже отключённые значения показаны как `none`, `false` или `()`.
-7. **Приватное не отслеживается**. Вся папка `.private/`, включая настройки offsets, исключена из Git; tracked placeholders никогда не заменяются реальными файлами.
-8. **Один переключатель**. При `false` условный import не читает `.private`; при `true` обычный preview и обычная build task используют её настройки.
-9. **Фасад скрывает реализацию**. Пользователь импортирует только `/.template/lib/index.typ`.
-10. **Domain не зависит от layout**. Presentation использует domain contracts, но обратной зависимости нет.
-
-## Целевая структура
-
-```text
-README.md                         # короткий маршрут автора
-main.typ                          # единственная точка входа и настройки
-chapters/                         # пользовательский текст
-assets/                           # изображения, данные и bibliography
-docs/                             # публичная документация
-├── README.md
-├── documents.md
-├── formatting.md
-├── vscode.md
-├── git.md
-├── private-assets.md
-├── writing-style.md
-├── troubleshooting.md
-└── examples/
-    ├── README.md
-    ├── private/
-    │   └── settings.typ
-    ├── documents/
-    │   ├── report/
-    │   ├── letter/
-    │   ├── commercial-offer/
-    │   └── contract/
-    └── formatting/
-.vscode/                          # tracked workspace configuration
-├── extensions.json
-├── settings.json
-└── tasks.json
-.private/                         # ignored settings, private media и backups
-├── settings.typ
-├── executors/
-├── scientia/
-├── technology/
-└── too/
-.template/                        # скрытая реализация
-├── lib/
-├── companies/
-└── development/
-    ├── docs/
-    ├── modules/
-    ├── tests/
-    ├── tools/
-    └── vscode/
-```
-
-В чистом fork каталог `.private/` не обязателен. Обычная компиляция использует placeholders из `.template/lib/assets/placeholders/`.
-
-## Компоненты
-
-| Компонент | Ответственность | Публичный интерфейс |
-|-----------|-----------------|---------------------|
-| Рабочее пространство автора | Один входной файл, главы и ресурсы | `main.typ`, `chapters/`, `assets/` |
-| Публичная документация | Обучение без знания реализации | `README.md`, `docs/*.md` |
-| Публичные примеры | Исполняемые примеры и источники выбора типа | `docs/examples/**/main.typ` |
-| VS Code workspace | Рекомендации, автосохранение и задачи | `.vscode/*.json` |
-| Публичный фасад | Единственный пользовательский Typst import | `.template/lib/index.typ` |
-| Document Domain | Профиль, context и render options | `document-profile()`, `render-options()` |
-| Company Domain | Реквизиты и firm resources | `company-profile()` |
-| Parties Domain | Адресаты, подписанты и стороны | `recipient()`, `signer()`, `party()` |
-| Attachments Domain | Порядок и идентичность приложений | `attachment()`, `attachment-set()` |
-| Render Application | Resolve, normalize, validate, render | `render-document()` |
-| Company Adapter | JSON profiles и resource overrides | `load-company()` |
-| Presentation | Foundation, components и четыре renderer | `profiles.report/letter/commercial_offer/contract` |
-| Employee/Private Adapter | Справочник сотрудников, private media и offsets | `report-executor()`, `private-company-media()` |
-| Test Harness | Static, compile, semantic и visual gates | `run-tests.py` |
-
-## Data flow
-
-### Обычная сборка
-
-1. Автор выбирает `company-id` и `document-mode` в `main.typ`.
-2. `main.typ` создаёт profile, company overrides, bibliography и attachments.
-3. `#show: document.with(...)` передаёт последующие `#include` как тело документа.
-4. Facade вызывает application use case.
-5. Application разрешает компанию, нормализует и валидирует profile metadata.
-6. Renderer применяет foundation, нумерацию, media policy и компонует страницы.
-7. При `none` для подписи или печати final renderer использует круг или крест.
-8. Typst создаёт `document.pdf`.
-
-### Выбор типа документа
-
-1. Задача VS Code получает `report`, `letter`, `commercial-offer` или `contract`.
-2. Tool сохраняет текущие `main.typ` и `chapters/` в `.private/starter-backups/<timestamp>/`.
-3. Tool копирует соответствующий публичный пример из `docs/examples/documents/`.
-4. Автор проверяет явно перечисленные параметры нового `main.typ`.
-
-### Приватная сборка
-
-1. Пользователь копирует готовую папку `.private` с `settings.typ` и PNG.
-2. В `main.typ` значение `use-private-assets` меняется с `false` на `true`.
-3. Условный import загружает `.private/settings.typ`.
-4. Adapter сопоставляет публичный идентификатор сотрудника с фиксированным именем PNG и применяет private offset.
-5. Отсутствующая или отключённая запись возвращает `none`; строка подписи остаётся пустой.
-6. Обычная build task и Tinymist preview используют один и тот же `main.typ`.
-
-## Ключевые интерфейсы
-
-```typst
-// Единственный пользовательский вход.
-#let company-id = "scientia" // scientia | technology | too
-#let document-mode = "final" // final | draft | clean-copy
-#let use-private-assets = false // true, если скопирована .private
-```
-
-```typst
-// Порядок и состав глав видны внизу main.typ.
-#include "chapters/00-introduction.typ"
-#pagebreak()
-#include "chapters/10-main.typ"
-```
-
-```typst
-// Отсутствующая .private не читается при false.
-#let private-settings = if use-private-assets {
-  import "/.private/settings.typ": settings
-  settings
-} else {
-  empty-private-settings
-}
-```
-
-```typst
-#show: document.with(
-  company: company,
-  profile: profiles.report(..),
-  options: (
-    mode: document-mode,
-    watermark: if document-mode == "draft" { "ЧЕРНОВИК" } else { none },
-    media-policy: if document-mode == "final" { "placeholder" } else { "reserve-space" },
-    diagnostics: true,
-  ),
-)
-```
-
-## Публичная и developer-документация
-
-| Слой | Расположение | Содержит | Не содержит |
-|------|--------------|----------|-------------|
-| Публичный | `README.md`, `docs/` | первый запуск, Git, типы, formatting, папку `.private`, troubleshooting | DDD, ADR, snapshots, migration internals |
-| Developer | `.template/development/docs/`, `modules/` | архитектуру, решения, границы и тестирование | обязательный маршрут обычного автора |
-
-Корневой README обязан ссылаться на каждую публичную тему. Developer README доступен одной отдельной ссылкой и не конкурирует с пользовательской навигацией.
-
-## Публичные примеры
-
-| Пример | Обязательное покрытие |
-|--------|----------------------|
-| Report | титул, stage/volume, executors, includes, рисунки, таблица, formula, references, bibliography, appendix |
-| Letter | recipient, исходящий номер, основной текст, attachment list, signer |
-| Commercial offer | recipient, subject, price, tax, сроки, payment, scope appendix |
-| Contract | parties, representatives, sections, requisites, signing, appendix |
-| Formatting | варианты изображений, grid, простые/сложные таблицы, CSV, формулы, labels, lists |
-
-Публичный пример не должен ссылаться на скрытый developer asset. Допустим только импорт фасада `/.template/lib/index.typ`.
-
-## Политика приватных ресурсов
-
-| Ресурс | Git | Поведение |
-|--------|-----|-----------|
-| Публичные реквизиты и логотипы | tracked | Загружаются из `.template/companies/` |
-| Векторные placeholders | tracked | Используются обычной сборкой по умолчанию |
-| `docs/examples/private/settings.typ` | tracked | Полный безопасный пример с `enabled: false` |
-| `.template/lib/infrastructure/employees.typ` | tracked | ФИО, обычные роли и фиксированные имена PNG |
-| `.private/` | ignored | Настройки доступности, offsets, реальные изображения и backups |
-
-Typst 0.15 не предоставляет проверки существования файла. Поэтому отсутствие подписи моделируется отсутствующей записью или `enabled: false`; только включённая запись создаёт private path.
-
-## Технологические решения
-
-| Решение | Выбор | Обоснование |
-|---------|-------|-------------|
-| Compiler | Typst 0.15.1+ | Проверенный baseline и path type |
-| Архитектура | Модульный монолит | Один процесс сборки без лишней инфраструктуры |
-| Root entry | Один `main.typ` | Минимум выбора и все параметры в одном месте |
-| Режимы | Переменная `document-mode` | Варианты видны комментариями, нет дублирования файлов |
-| Public docs | Видимый `docs/` | Автор находит примеры в Explorer |
-| Examples | Executable documentation | Код и объяснение не расходятся |
-| Private activation | Literal `use-private-assets` + conditional import | Один понятный параметр, clean fork не читает отсутствующий каталог |
-| Internal boundary | `.template/` | Реализация и developer docs не мешают автору |
-| Testing | Python + Typst + Poppler | Контракты, PDF semantic и визуальный layout |
-
-## Режимы отказа
-
-| Сбой | Влияние | Митигация |
-|------|---------|-----------|
-| Автор меняет режим не в `main.typ` | Ожидаемый вариант PDF не получается | README и comments показывают единственную переменную |
-| Пример использует скрытый developer asset | После очистки development сборка падает | Static path audit и compile всех public examples |
-| Выбор типа уничтожает текст | Потеря работы | Timestamp backup до удаления `chapters/` |
-| Подпись ещё не получена | Private compile падает при прямом path | Запись отсутствует или `enabled: false`, resolver возвращает `none` |
-| Включённая запись не имеет PNG | Ошибка Typst с точным path | Включать запись только после копирования PNG; troubleshooting |
-| Реальный файл попадает в Git | Утечка подписи | `.gitignore`, ignored `.private/`, no overwrite tracked placeholders |
-| Сложная таблица переполняет страницу | Нарушение layout | Formatting example, stress fixture, repeated header tests |
-| Публичная ссылка устарела | Автор теряет маршрут | Automated Markdown link audit |
-| Изменение Typst меняет layout | Тихая регрессия | Version gate и snapshot review |
-
-## Вне области видимости v1
-
-- Поддержка старых root-файлов `document.typ`, `draft.typ` и `clean-copy.typ`.
-- Автоматическое определение существования private files внутри Typst.
-- Хранение реальных подписей и печатей в Git или Git LFS.
-- Публикация внутренних VSIX в этом репозитории.
-- Юридическая экспертиза договора.
-- Научная верификация пользовательского содержания.
-- Генерация DOCX.
-- Публичная публикация в Typst Universe и open-source лицензирование.

.template/development/docs/PLAN.md

@@ -1,136 +0,0 @@
-# План редизайна пользовательской поверхности Scientia
-
-## Обзор
-
-| Фаза | Результат | Статус |
-|------|-----------|--------|
-| 1 | Зафиксирован baseline до редизайна | [x] |
-| 2 | В корне оставлен один настраиваемый `main.typ` | [x] |
-| 3 | Публичные инструкции и компилируемые примеры перенесены в `docs/` | [x] |
-| 4 | Выбор типа выполняется задачей VS Code, private media — одним параметром | [x] |
-| 5 | Полная регрессия и визуальная приёмка | [x] |
-
-## План миграции
-
-**Текущее до редизайна**: пользовательская справка находилась в скрытой `.template/help/`, конфигурация была разделена между `document.typ`, `main.typ`, `draft.typ` и `clean-copy.typ`, а учебные примеры лежали среди developer fixtures.
-
-**Целевое состояние**: автор видит `main.typ`, `chapters/`, `assets/` и `docs/`. Режим задаётся одной переменной. Примеры четырёх типов документов и форматирования видимы, компилируемы и используются как заготовки. Приватная папка подключается одним параметром и содержит настройки индивидуальных подписей.
-
-**Стратегия**: атомарное переключение пользовательского контракта без compatibility-файлов. Обратная совместимость не требуется.
-
-| Фаза | Rollback |
-|------|----------|
-| 1 | Не требуется: только фиксация baseline |
-| 2 | Восстановить предыдущие четыре корневых файла одним change set |
-| 3 | Вернуть справку в `.template/help/`, не меняя библиотеку |
-| 4 | Отключить задачи и использовать обычную сборку с placeholders |
-| 5 | Откатить конкретную правку, повторить compile и visual suites |
-
----
-
-## Фаза 1 — Зафиксировать baseline
-
-**Цель**: доказать работоспособность библиотеки до изменения пользовательского контракта.  
-**Результат**: unit, negative, company matrix, semantic и visual suites проходят.  
-**Трудоёмкость**: S  
-**Статус**: [x] Готово
-
-### Задачи
-
-- [x] Сохранить compile и visual baseline (→ [Модуль: Тестирование](../modules/testing.md))
-- [x] Зафиксировать Typst 0.15.1 (→ [ADR-0001](adr/0001-typst-015.md))
-
-### Тесты
-
-- [x] Unit: domain и numbering
-- [x] Интеграционный: четыре профиля и компании
-- [x] Визуальный: утверждённые snapshot pages
-
----
-
-## Фаза 2 — Оставить один `main.typ`
-
-**Цель**: сделать все ежедневные настройки и `#include` видимыми в одном файле.  
-**Результат**: `document.typ`, `draft.typ` и `clean-copy.typ` отсутствуют; режим выбирается в `main.typ`.  
-**Трудоёмкость**: M  
-**Статус**: [x] Готово
-
-### Задачи
-
-- [x] Перенести компанию, режим, metadata и порядок глав в `main.typ` (→ [Рабочее пространство автора](../modules/author-workspace.md))
-- [x] Сохранить единый фасад импорта (→ [Публичный фасад](../modules/facade.md))
-- [x] Проверить profile/options contract (→ [Документ](../modules/domain-document.md))
-- [x] Сохранить границы организаций, сторон и приложений (→ [Организация](../modules/domain-company.md), [Стороны](../modules/domain-parties.md), [Приложения](../modules/domain-attachments.md))
-- [x] Проверить application flow и загрузку компаний (→ [Сборка](../modules/application-render.md), [Ресурсы компаний](../modules/infrastructure-assets.md))
-
-### Тесты
-
-- [x] Static: единственный root entrypoint
-- [x] Интеграционный: `final`, `draft`, `clean-copy` через profile fixtures
-- [x] Ручной: порядок глав меняется только списком `#include`
-
----
-
-## Фаза 3 — Открыть документацию и примеры
-
-**Цель**: дать автору видимую справку и копируемые примеры без чтения реализации.  
-**Результат**: `docs/` содержит навигацию, четыре полных документа и каталог оформления.  
-**Трудоёмкость**: L  
-**Статус**: [x] Готово
-
-### Задачи
-
-- [x] Разделить публичную и developer-документацию (→ [Публичная документация](../modules/user-documentation.md))
-- [x] Сделать примеры источником выбора типа документа (→ [Публичные примеры](../modules/starter-packs.md))
-- [x] Показать таблицы, формулы, подписи и media blocks (→ [Компоненты](../modules/components.md), [Основа вёрстки](../modules/presentation-foundation.md))
-- [x] Показать ссылки, bibliography и numbering (→ [Ссылки](../modules/references.md), [Нумерация](../modules/numbering.md))
-- [x] Подготовить адекватные примеры профилей (→ [Отчёт](../modules/presentation-report.md), [Письмо](../modules/presentation-letter.md), [ТКП](../modules/presentation-commercial-offer.md), [Договор](../modules/presentation-contract.md))
-
-### Тесты
-
-- [x] Интеграционный: пять публичных примеров компилируются
-- [x] Semantic: ожидаемые подписи, ссылки, приложения и реквизиты присутствуют
-- [x] Ручной: весь `docs/` доступен из корневого README
-
----
-
-## Фаза 4 — Упростить VS Code и приватные данные
-
-**Цель**: оставить одну build task и безопасно подключать папку `.private` одним параметром.  
-**Результат**: выбор типа создаёт backup, обычная сборка работает с private media и без неё, отсутствующая подпись не ломает документ.  
-**Трудоёмкость**: M  
-**Статус**: [x] Готово
-
-### Задачи
-
-- [x] Оставить в Typewriter единственный `main.typ` и обновить задачи (→ [Рабочая область VS Code](../modules/vscode-workspace.md))
-- [x] Добавить публичный справочник сотрудников, фиксированные PNG names и private offsets (→ [Приватные ресурсы](../modules/private-assets.md))
-- [x] Использовать conditional import при явном `use-private-assets` (→ [ADR-0010](adr/0010-private-folder-and-employees.md))
-
-### Тесты
-
-- [x] Static: `.vscode/` синхронизируется, `docs/` не скрыт
-- [x] Интеграционный: clean fork компилируется без `.private`
-- [x] Интеграционный: private compile отображает реальные подписи и offsets
-- [x] Интеграционный: `enabled: false` оставляет пустую строку без ошибки
-
----
-
-## Фаза 5 — Hardening и выпуск
-
-**Цель**: подтвердить отсутствие мёртвых путей, утечек и визуальных дефектов.  
-**Результат**: полный harness проходит, Markdown-ссылки валидны, приватные ресурсы игнорируются.  
-**Трудоёмкость**: M  
-**Статус**: [x] Готово
-
-### Задачи
-
-- [x] Обновить static workspace contract (→ [Тестирование](../modules/testing.md))
-- [x] Удалить скрытые дубликаты примеров и notes (→ [Публичная документация](../modules/user-documentation.md))
-- [x] Проверить визуально все страницы публичных примеров (→ [ADR-0006](adr/0006-visual-regression.md))
-
-### Тесты
-
-- [x] Полный automated harness
-- [x] Аудит Markdown links и legacy paths
-- [x] Визуальная проверка contact sheets и проблемных страниц

.template/development/docs/README.md

@@ -1,63 +0,0 @@
-# Разработка шаблона Scientia
-
-> Скрытая документация для сопровождающих Typst-библиотеки. Инструкции авторов находятся в публичном каталоге [`docs/`](../../../docs/README.md).
-
-## Текущее устройство
-
-Автор работает с единственным `main.typ`, каталогами `chapters/`, `assets/` и видимой документацией `docs/`. Внутренняя библиотека, профили организаций, тесты и архитектурные решения находятся в `.template/`.
-
-Режим `final`, `draft` или `clean-copy` выбирается переменной внутри `main.typ`. Компилируемые публичные примеры четырёх видов документов и элементов оформления одновременно являются источниками для задачи выбора типа документа.
-
-Обычная сборка использует векторные заглушки. Готовая папка `.private` подключается одним literal-переключателем в `main.typ`; отдельного ZIP installer и отдельной build task нет.
-
-## Команды сопровождающего
-
-```powershell
-# Пользовательский документ
-typst compile --root . main.typ document.pdf
-
-# Полная регрессия
-python .template/development/tests/run-tests.py
-```
-
-## Навигация
-
-| Документ | Назначение |
-|----------|------------|
-| [PLAN.md](PLAN.md) | Завершённые фазы редизайна и проверки |
-| [ARCHITECTURE.md](ARCHITECTURE.md) | Структура, компоненты, data flow и режимы отказа |
-| [ADR-0001](adr/0001-typst-015.md) | Typst 0.15.1 как baseline |
-| [ADR-0002](adr/0002-data-and-assets.md) | Границы данных и ресурсов |
-| [ADR-0003](adr/0003-rendering-model.md) | Детерминированная модель выполнения |
-| [ADR-0004](adr/0004-error-handling.md) | Ошибки и media fallback |
-| [ADR-0005](adr/0005-ddd-boundaries.md) | Направление зависимостей |
-| [ADR-0006](adr/0006-visual-regression.md) | Визуальная регрессия |
-| [ADR-0007, устарел](adr/0007-author-workspace.md) | Историческое решение о трёх entrypoints |
-| [ADR-0008](adr/0008-vscode-onboarding.md) | Версионируемая рабочая область VS Code |
-| [ADR-0009](adr/0009-single-main-and-public-docs.md) | Один `main.typ`, публичные примеры и приватная сборка |
-| [ADR-0010](adr/0010-private-folder-and-employees.md) | Папка `.private`, справочник сотрудников и частичные подписи |
-| [Рабочее пространство автора](../modules/author-workspace.md) | Минимальный корень и один входной файл |
-| [Публичные примеры](../modules/starter-packs.md) | Четыре вида документов и каталог оформления |
-| [Публичная документация](../modules/user-documentation.md) | Видимый `docs/` для авторов |
-| [Рабочая область VS Code](../modules/vscode-workspace.md) | Расширения, задачи и настройки |
-| [Приватные ресурсы](../modules/private-assets.md) | Справочник сотрудников, `.private/settings.typ`, offsets и placeholders |
-| [Публичный фасад](../modules/facade.md) | Стабильный Typst API |
-| [Документ](../modules/domain-document.md) | Профили и режимы выпуска |
-| [Организация](../modules/domain-company.md) | Реквизиты и ресурсы компании |
-| [Стороны](../modules/domain-parties.md) | Адресаты, подписанты и стороны |
-| [Приложения](../modules/domain-attachments.md) | Приложения разных видов документов |
-| [Сборка](../modules/application-render.md) | Application orchestration |
-| [Ресурсы компаний](../modules/infrastructure-assets.md) | Загрузка публичных профилей и overrides |
-| [Основа вёрстки](../modules/presentation-foundation.md) | Tokens и media policy |
-| [Отчёт](../modules/presentation-report.md) | Renderer отчёта |
-| [Письмо](../modules/presentation-letter.md) | Renderer письма |
-| [ТКП](../modules/presentation-commercial-offer.md) | Renderer предложения |
-| [Договор](../modules/presentation-contract.md) | Renderer договора |
-| [Компоненты](../modules/components.md) | Таблицы, формулы и подписи |
-| [Ссылки](../modules/references.md) | Перекрёстные ссылки и библиография |
-| [Нумерация](../modules/numbering.md) | Стратегии нумерации |
-| [Тестирование](../modules/testing.md) | Static, compile, semantic и visual suites |
-
-## Статус
-
-Редизайн принят. Корневой и публичные примеры компилируются на Typst 0.15.1; полная тестовая матрица является release gate.

.template/development/docs/adr/0001-typst-015.md

@@ -1,30 +0,0 @@
-# ADR-0001: Typst 0.15.1 как минимальная платформа
-
-**Дата**: 2026-08-26
-**Статус**: Принято
-
-## Контекст
-
-Шаблон уже реализован на Typst и использует его counters, introspection, show rules и PDF-рендер. После обновления окружения доступен Typst 0.15.1, который добавляет несколько bibliographies, тип `path` для передачи project-relative ресурсов и более подробные diagnostics. Одновременно 0.15 меняет baseline некоторых layout-элементов, поэтому обновление должно сопровождаться визуальным аудитом.
-
-Официальные основания: [changelog Typst 0.15.0](https://typst.app/docs/changelog/0.15.0/), [bibliography](https://typst.app/docs/reference/model/bibliography/), [path](https://typst.app/docs/reference/foundations/path/).
-
-## Рассматриваемые варианты
-
-1. **Остаться на Typst 0.14.2** — меньше миграционных рисков сейчас, но нет нативных нескольких bibliographies и нового `path`.
-2. **Принять Typst 0.15.1+** — доступны нужные возможности, но требуется новый baseline и контроль будущих обновлений.
-3. **Перейти на LaTeX или Word** — большая экосистема, но фактически требует переписать проверенную вёрстку и усложняет программируемые компоненты.
-
-## Решение
-
-Выбрали **Typst 0.15.1 как минимальную поддерживаемую версию**, потому что она уже установлена, поддерживает несколько bibliographies и даёт корректную модель передачи путей между пользовательским проектом и библиотекой.
-
-Каждое обновление Typst выполняется отдельным изменением: сначала полная компиляционная и визуальная матрица, затем принятие новых snapshots.
-
-## Последствия
-
-**Становится проще**: тематические и поглавные библиографии, автономное подключение шаблона, диагностика layout convergence.
-
-**Становится сложнее**: необходимо контролировать версию CLI и визуальные изменения baseline.
-
-**Закрывает дверь на**: поддержку Typst 0.14 и более ранних версий без отдельной compatibility-ветки.

.template/development/docs/adr/0002-data-and-assets.md

@@ -1,37 +0,0 @@
-# ADR-0002: Публичные, пользовательские и приватные ресурсы
-
-**Дата**: 2026-08-31
-**Статус**: Принято
-
-> Способ доставки через ZIP заменён папкой `.private` в [ADR-0010](0010-private-folder-and-employees.md). Граница публичных и приватных данных остаётся действующей.
-
-## Контекст
-
-Внутренний шаблон Scientia содержит фирменные реквизиты, логотипы, имена, подписи, печати и материалы конкретного документа. Логотипы, адреса, имена и реквизиты разрешено распространять внутри компании. Реальные подписи и печати нельзя хранить в Git вместе с шаблоном.
-
-Typst не читает ZIP напрямую и не умеет проверить наличие изображения без попытки его загрузить. Поэтому приватный архив должен быть внешним каналом доставки, а отсутствие ресурса должно моделироваться значением `none`.
-
-## Рассматриваемые варианты
-
-1. **Оставить всё в одном tracked-каталоге** — максимально просто, но подписи и печати неизбежно распространяются с каждым форком.
-2. **Хранить приватные изображения в Git LFS** — уменьшает основной репозиторий, но не устраняет доступ и историю распространения.
-3. **Хранить подписи и печати в отдельном ZIP** — требует извлечения, зато отделяет приватный канал от шаблона.
-4. **Не поддерживать реальные изображения вообще** — безопасно, но не покрывает подготовку финальных документов.
-
-## Решение
-
-Выбрали **три класса ресурсов**:
-
-- публичные фирменные данные и логотипы хранятся в `.template/companies/`;
-- материалы конкретного документа хранятся в `assets/`;
-- реальные подписи и печати поставляются отдельным `private-assets.zip`; проверенная задача извлекает их в `.private/` и включает через `sys.inputs` только на время приватной сборки `main.typ`.
-
-`.private/` и `private-assets*.zip` исключаются через `.gitignore`. В репозитории остаются только нейтральные placeholders: векторный круг для печати и крест для подписи. При значении ресурса `none` renderer использует placeholder; указанный путь обязан существовать.
-
-## Последствия
-
-**Становится проще**: безопасно форкать шаблон, централизованно обновлять публичные реквизиты и собирать документ без приватного архива.
-
-**Становится сложнее**: для финального подписанного PDF нужно получить ZIP, извлечь его и явно указать пути.
-
-**Закрывает дверь на**: хранение настоящих подписей и печатей в обычном Git, Git LFS или visual snapshots.

.template/development/docs/adr/0003-rendering-model.md

@@ -1,28 +0,0 @@
-# ADR-0003: Синхронная детерминированная модель сборки
-
-**Дата**: 2026-08-26
-**Статус**: Принято
-
-## Контекст
-
-Сборка документа выполняется локальным Typst compiler: данные читаются из файлов проекта, затем происходит несколько внутренних итераций layout и создаётся PDF. Внешних сетевых сервисов, конкурентной записи или длительных независимых операций в v1 нет.
-
-Добавление собственной async-модели не ускорит Typst-layout, но усложнит диагностику, воспроизводимость и тестирование.
-
-## Рассматриваемые варианты
-
-1. **Синхронная сборка одного документа** — простая, воспроизводимая и соответствует модели Typst.
-2. **Параллельные renderer-профили внутри Typst** — не поддерживаются как управляемая модель и не дают изоляции layout-state.
-3. **Внешний асинхронный build-сервис** — полезен для массовой генерации, но избыточен для локального шаблона.
-
-## Решение
-
-Выбрали **синхронную детерминированную сборку одного документа**. Параллельный запуск нескольких независимых fixtures допускается только во внешнем test harness, где каждый процесс получает собственный entry point и output.
-
-## Последствия
-
-**Становится проще**: воспроизводимость, порядок diagnostics, изоляция `state` и расследование visual regressions.
-
-**Становится сложнее**: массовая генерация большого набора документов должна оркестрироваться внешним скриптом.
-
-**Закрывает дверь на**: сетевые и фоновые операции непосредственно внутри шаблона v1.

.template/development/docs/adr/0004-error-handling.md

@@ -1,36 +0,0 @@
-# ADR-0004: Ранняя валидация и явные fallback-политики
-
-**Дата**: 2026-08-26
-**Статус**: Принято
-
-## Контекст
-
-Ошибки Typst часто проявляются во время layout далеко от места, где пользователь передал неверное значение. Для бизнес-документа особенно опасны тихие fallback: неверная компания, отсутствующая сторона, незаметно пропавшая подпись или citation, не попавшая в список источников.
-
-При этом распространяемый шаблон должен компилироваться без реальных подписей и печатей. Они поставляются отдельным ZIP; PowerShell task проверяет и извлекает архив, после чего запускает `main.typ` с явным `sys.inputs`. Typst 0.15 не предоставляет проверки существования файла без попытки загрузки.
-
-## Рассматриваемые варианты
-
-1. **Полагаться только на diagnostics Typst** — мало кода, но сообщения не отражают доменный путь поля.
-2. **Всегда аварийно завершаться при любом отсутствующем ресурсе** — строго, но шаблон нельзя удобно распространять без подписей.
-3. **Валидировать domain до layout и явно моделировать необязательные ресурсы** — больше контрактов, зато ошибки предсказуемы.
-
-## Решение
-
-Выбрали **раннюю profile-specific валидацию**. Каждая ошибка называет профиль, путь поля, фактическое значение и ожидаемое ограничение.
-
-Для подписи, печати и необязательных изображений поддерживаются политики:
-
-- `hide` — не показывать ресурс и не резервировать место;
-- `placeholder` — показать безопасную графическую заглушку: круг для печати или крест для подписи;
-- `reserve-space` — оставить место для ручной подписи или печати.
-
-Политика применяется только если поле равно `none`. Если поле содержит путь, но файл отсутствует, сборка завершается ошибкой.
-
-## Последствия
-
-**Становится проще**: распространение шаблона, поиск причины ошибки и тестирование негативных сценариев.
-
-**Становится сложнее**: каждый профиль обязан определить required/optional поля и defaults.
-
-**Закрывает дверь на**: молчаливое игнорирование неверно указанного пути к производственному ресурсу.

.template/development/docs/adr/0005-ddd-boundaries.md

@@ -1,37 +0,0 @@
-# ADR-0005: DDD-границы внутри модульного Typst-монолита
-
-**Дата**: 2026-08-26
-**Статус**: Принято
-
-## Контекст
-
-Шаблон должен расширяться новыми видами документов, но обычное использование должно оставаться простым. Один монолитный `show` с ветвлением по типу документа быстро свяжет корпоративные данные, file paths, domain-правила и пагинацию. Полноценные микросервисы или отдельные пакеты для каждого bounded context, напротив, избыточны для локальной Typst-библиотеки.
-
-## Рассматриваемые варианты
-
-1. **Одна функция с `if kind == ...`** — минимальный старт, но любое расширение меняет общее ядро и повышает риск регрессии.
-2. **Модульный монолит с DDD-границами и profile contract** — изоляция без инфраструктурной сложности.
-3. **Отдельный Typst package для каждого вида документа** — сильная физическая изоляция, но дублирование foundation и сложное совместное версионирование.
-
-## Решение
-
-Выбрали **модульный монолит** со слоями Domain → Application и адаптерами Infrastructure/Presentation. Domain не импортирует presentation или infrastructure. Новый вид документа добавляется новым `DocumentProfile`, а не новой веткой в `document()`.
-
-Разрешённое направление зависимостей:
-
-```text
-Facade → Application → Domain
-            │            ▲
-            ├→ Infrastructure
-            └→ Presentation → Shared Components
-```
-
-Presentation и Infrastructure могут создавать domain-значения или читать их, но не изменяют domain-инварианты.
-
-## Последствия
-
-**Становится проще**: добавление договора или другого профиля, независимые fixtures и локализация `show/state`.
-
-**Становится сложнее**: необходимо поддерживать явные contracts и проверять import graph.
-
-**Закрывает дверь на**: доступ domain-модулей к JSON, `image`, `page`, `context` и глобальным renderer-state.

.template/development/docs/adr/0006-visual-regression.md

@@ -1,32 +0,0 @@
-# ADR-0006: Трёхуровневая стратегия регрессионного тестирования
-
-**Дата**: 2026-08-26
-**Статус**: Принято
-
-## Контекст
-
-Шаблон содержит хрупкую пагинацию, сложные таблицы, подписи, формулы, кириллическую нумерацию и show rules. Успешная компиляция не обнаруживает тихий перенос строки, наложение печати или изменение количества страниц. Чистый pixel-perfect diff, в свою очередь, слишком чувствителен к версии renderer и системным шрифтам.
-
-## Рассматриваемые варианты
-
-1. **Проверять только exit code компилятора** — быстро, но не защищает макет.
-2. **Использовать только pixel-perfect snapshots** — ловит всё, но создаёт шум при допустимых изменениях окружения.
-3. **Совместить unit, semantic и visual проверки** — больше инфраструктуры, зато дефекты классифицируются точнее.
-
-## Решение
-
-Выбрали **три уровня тестов**:
-
-1. Domain unit tests через `typst eval` и `assert`.
-2. Compile/semantic tests: exit code, diagnostics, A4, количество страниц, наличие обязательных текстовых маркеров и PDF metadata.
-3. Visual regression: rasterize через Poppler, сравнивать контрольные области и полный perceptual diff с документированным порогом.
-
-Snapshots создаются только из синтетического `test-company`; реальные подписи и печати не включаются в публичные тестовые изображения. Новая версия Typst всегда проверяется отдельным прогоном до обновления snapshots.
-
-## Последствия
-
-**Становится проще**: находить как логические, так и визуальные регрессии и безопасно менять отдельные profiles.
-
-**Становится сложнее**: требуется Python/Poppler test runtime и процедура осознанного обновления эталонов.
-
-**Закрывает дверь на**: автоматическое принятие новых snapshots при обычном тестовом запуске.

.template/development/docs/adr/0007-author-workspace.md

@@ -1,39 +0,0 @@
-# ADR-0007: Минимальный корень и три режима одного документа
-
-**Дата**: 2026-08-31
-**Статус**: Устарело — заменено [ADR-0009](0009-single-main-and-public-docs.md)
-
-## Контекст
-
-> Этот ADR сохраняется как история промежуточного решения. Три entrypoint-файла были удалены после проверки на реальных отчётах: пользователю удобнее выбирать режим в одном `main.typ`.
-
-В текущем корне служебные каталоги конкурируют с `chapters/` и `assets/`, а `main.typ` смешивает демонстрационные данные, настройку и сборку. Автору после форка нужен короткий маршрут без изучения DDD-слоёв, тестов и примеров.
-
-Одновременно должны поддерживаться три выпуска одного содержания и четыре вида документов. Обратная совместимость со старыми путями не требуется.
-
-## Рассматриваемые варианты
-
-1. **Оставить служебные каталоги в корне** — удобно разработчику, но перегружает основной сценарий автора.
-2. **Удалить тесты и документацию** — очищает корень, но делает шаблон хрупким и плохо сопровождаемым.
-3. **Перенести внутреннее устройство в `.template/`** — сохраняет разработку и визуально отделяет её от пользовательских файлов.
-4. **Создать отдельный entrypoint для каждого типа и режима** — явно, но приводит минимум к двенадцати корневым файлам и дублированию конфигурации.
-
-## Решение
-
-Выбрали **один скрытый каталог `.template/`**, общий `document.typ` и три корневые точки входа:
-
-- `main.typ` передаёт `mode: "final"`;
-- `draft.typ` передаёт `mode: "draft"`;
-- `clean-copy.typ` передаёт `mode: "clean-copy"`.
-
-Все entrypoints импортируют `render(mode:)` из `document.typ`. Report, letter, commercial-offer и contract starters реализуют одинаковый контракт, поэтому выбор типа документа не меняет entrypoints.
-
-В starter явно записываются все семантически важные параметры, включая осознанные `none`, `false` и `()`. Низкоуровневые параметры layout остаются внутри библиотеки.
-
-## Последствия
-
-**Становится проще**: первый fork, переключение режима, выбор starter и обновление внутренней реализации.
-
-**Становится сложнее**: `document.typ` является обязательным стабильным контрактом, а каждый starter должен проходить contract-tests.
-
-**Закрывает дверь на**: compatibility-файлы в корне и отдельные копии полной конфигурации для каждого режима.

.template/development/docs/adr/0008-vscode-onboarding.md

@@ -1,35 +0,0 @@
-# ADR-0008: Версионируемая рабочая область VS Code и обучение автора
-
-**Дата**: 2026-08-31  
-**Статус**: Принято
-
-## Контекст
-
-Основные пользователи шаблона пишут документы, но могут никогда не работать с кодом, Git и Typst. Устные инструкции и личные настройки редактора не воспроизводятся в новом форке. Одновременно каталог `.vscode/` не должен отвлекать автора от текста.
-
-Часть расширений доступна в публичном Marketplace, а Typst Typewriter и Zotst распространяются внутри компании как локальные VSIX. Запись идентификатора расширения в рекомендациях VS Code не распространяет сам установочный пакет.
-
-## Рассматриваемые варианты
-
-1. **Не хранить настройки редактора** — корень формально проще, но каждый сотрудник вручную повторяет настройку и получает различное поведение.
-2. **Настроить всё глобально на рабочих станциях** — удобно на одном компьютере, но не переносится вместе с форком и требует администрирования.
-3. **Версионировать `.vscode/` и скрыть его в проводнике** — настройки синхронизируются через Git, оставаясь вне повседневной области автора.
-4. **Положить локальные VSIX в шаблон** — обеспечивает автономную установку, но смешивает бинарные пакеты с исходниками и затрудняет централизованное обновление.
-
-## Решение
-
-Выбран вариант **версионировать `.vscode/`, но скрывать его из Explorer**:
-
-- `extensions.json` содержит десять согласованных идентификаторов, включая два внутренних;
-- `settings.json` включает автосохранение, языки проверки орфографии, TODO-маркеры и защитные настройки Git;
-- `tasks.json` предоставляет обычную и приватную сборку, выбор одного из четырёх публичных примеров и компиляцию учебного каталога;
-- внутренние VSIX хранятся в корпоративном хранилище, а README объясняет их установку;
-- README и видимый `docs/` обучают Git в терминах истории документа, контрольных точек и параллельных версий.
-
-## Последствия
-
-**Становится проще**: первый запуск, одинаковая среда во всех форках, живой предпросмотр, проверка русского текста и совместная работа через Git.
-
-**Становится сложнее**: изменения `.vscode/` требуют такого же review, как изменения шаблона; сопровождающий должен отдельно публиковать совместимые VSIX.
-
-**Закрывает дверь на**: неявные обязательные глобальные настройки и распространение внутренних бинарных расширений внутри Git-шаблона.

.template/development/docs/adr/0009-single-main-and-public-docs.md

@@ -1,35 +0,0 @@
-# ADR-0009: Один main.typ, видимая документация и явная приватная сборка
-
-**Дата**: 2026-08-31  
-**Статус**: Принято
-
-> Часть решения об отдельной private build task заменена условным import из [ADR-0010](0010-private-folder-and-employees.md). Один `main.typ` и видимая публичная документация остаются действующими.
-
-## Контекст
-
-Проверка шаблона на реальных отчётах показала, что авторы ожидают менять компанию, стадию, режим и список глав в одном файле. Три корневых entrypoint-файла и скрытая пользовательская справка создавали лишний выбор. Одновременно Typst 0.15 не умеет безопасно проверять существование private path.
-
-## Рассматриваемые варианты
-
-1. **Сохранить `document.typ` и три entrypoints** — технически чисто, но пользователь должен понимать разделение ролей четырёх файлов.
-2. **Один `main.typ` и tracked private placeholders с заменой** — просто, но реальная подпись становится изменением уже отслеживаемого файла.
-3. **Один `main.typ`, public `docs/`, internal placeholders и private task** — минимальная поверхность без риска добавить реальный media в Git.
-
-## Решение
-
-Выбран третий вариант:
-
-- `main.typ` содержит `company-id`, `document-mode`, metadata и `#include`;
-- `docs/` видим и содержит executable examples;
-- examples одновременно являются источниками задачи выбора типа;
-- обычная сборка использует internal placeholders;
-- задача приватной сборки проверяет `private-assets.zip`, копирует PNG в `.private/` и передаёт `--input private-assets=true`;
-- прежний ADR-0007 считается устаревшим.
-
-## Последствия
-
-**Становится проще**: первый запуск, переключение режима, поиск примеров, выбор типа и выпуск с приватными изображениями.
-
-**Становится сложнее**: main-файлы четырёх примеров частично повторяют setup-код; PowerShell tool становится security boundary для ZIP.
-
-**Закрывает дверь на**: отдельные root entrypoints для режимов, скрытую public-документацию и замену tracked placeholders реальными файлами.

.template/development/docs/adr/0010-private-folder-and-employees.md

@@ -1,26 +0,0 @@
-# ADR-0010: Папка `.private`, справочник сотрудников и частичные подписи
-
-**Дата**: 2026-08-31  
-**Статус**: Принято
-
-## Контекст
-
-ZIP installer и отдельная build task скрывали второй переключатель private media от автора и не поддерживали реальные фамильные имена PNG. В проектах подписи поступают постепенно, а для каждого изображения уже подобрано индивидуальное вертикальное смещение. Чистый fork при этом обязан собираться без приватного каталога.
-
-## Рассматриваемые варианты
-
-1. **Оставить ZIP и `sys.inputs`** — безопасно для clean fork, но preview и обычная task не совпадают, а схема имён жёстко привязана к ролям.
-2. **Автоматически сканировать `.private`** — желаемый UX, но Typst 0.15 не предоставляет file-exists и падает при попытке открыть отсутствующий PNG.
-3. **Условный import и явная карта доступности** — один параметр в `main.typ`, отсутствие записи означает пустое место, offsets живут рядом с приватными PNG.
-
-## Решение
-
-Выбран вариант 3. Публичный tracked-справочник хранит идентификатор, ФИО, обычную должность и фиксированное имя PNG. Игнорируемый `.private/settings.typ` хранит доступность и offset. `main.typ` импортирует его только при literal `use-private-assets = true`. Все build/preview пути используют один entrypoint.
-
-## Последствия
-
-**Становится проще**: копировать `.private` целиком, менять роль сотрудника в одной строке, видеть реальные подписи в preview, работать при частично полученных PNG и публиковать clean fork с `false`.
-
-**Становится сложнее**: при получении нового PNG нужно вручную включить запись; включённый, но отсутствующий файл по-прежнему вызывает точную ошибку Typst.
-
-**Закрывает дверь на**: автоматическое определение файлов, role-based имена `responsible.png`, отдельную private build task и ZIP installer.

.template/development/modules/application-render.md

@@ -1,42 +0,0 @@
-# Модуль: Сборка документа
-
-**Ответственность**: выполняет use case «собрать документ» в фиксированном порядке от пользовательских параметров до вызова renderer.
-**Расположение**: `.template/lib/application/render-document.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `render-document()` | функция | Оркестрирует resolve company → normalize → validate → create context → render |
-| `resolve-profile()` | функция | Проверяет и нормализует встроенный или пользовательский `DocumentProfile` |
-| `build-context()` | функция | Создаёт итоговый `DocumentContext` из валидированных частей |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/document.typ` | Контракт профиля, context и render options |
-| `.template/lib/domain/company.typ` | Валидацию CompanyProfile |
-| `.template/lib/domain/parties.typ` | Валидацию сторон и подписантов |
-| `.template/lib/domain/attachments.typ` | Валидацию приложений |
-| `.template/lib/infrastructure/company-assets.typ` | Загрузку компании только если передан строковый id |
-
-## Инварианты
-
-- Renderer никогда не вызывается до завершения всех validators.
-- Строковый `company` разрешается infrastructure-адаптером; готовый `CompanyProfile` повторно не загружается.
-- Порядок normalize и validate одинаков для всех профилей.
-- Application не содержит `if profile.id == "report"` или другой profile-specific логики.
-- `body` передаётся renderer без изменения пользовательского content.
-- Ошибка содержит stage: `resolve-company`, `normalize-profile`, `validate-domain` или `render`.
-
-## Намеренно НЕ обрабатывает
-
-- Page layout и show rules.
-- Чтение пользовательского `assets/`.
-- Юридическую проверку содержимого.
-- Запуск Typst compiler или запись PDF на диск.
-
-## Заметки для агента
-
-> Этот модуль должен оставаться коротким и скучным: его ценность — стабильный pipeline. Если новая возможность требует ветвления по профилю, добавьте её в profile contract или domain service. Infrastructure подключается как адаптер только для удобного строкового company id.

.template/development/modules/author-workspace.md

@@ -1,42 +0,0 @@
-# Модуль: Рабочее пространство автора
-
-**Ответственность**: предоставляет один понятный входной файл и отделяет пользовательский текст от реализации.  
-**Расположение**: `main.typ`, `chapters/`, `assets/`, `docs/`
-
-## Публичный интерфейс
-
-| Элемент | Тип | Описание |
-|---------|-----|----------|
-| `main.typ` | entrypoint | Компания, режим, metadata, ресурсы и порядок `#include` |
-| `document-mode` | строка | `final`, `draft` или `clean-copy` |
-| `chapters/` | каталог | Текстовые разделы документа |
-| `assets/` | каталог | Рисунки, CSV/TSV, bibliography и другие материалы |
-| `docs/` | каталог | Публичная справка и компилируемые примеры |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/index.typ` | Единственный Typst facade import |
-| `chapters/*.typ` | Явно перечисленное содержимое |
-| `assets/*` | Пользовательские paths |
-| `.private/settings.typ` | Только при явном `use-private-assets = true` |
-
-## Инварианты
-
-- В корне существует только один Typst entrypoint `main.typ`.
-- Все ежедневные параметры и порядок глав видны в одном файле.
-- Режимы не представлены отдельными файлами.
-- `docs/` не скрыт настройками VS Code.
-- Автор не обязан открывать `.template/` для первого PDF.
-- Generated PDF и `.private/` не попадают в Git.
-
-## Намеренно НЕ обрабатывает
-
-- Layout renderer и profile validation.
-- Разработку нового вида документа.
-- Хранение настоящих подписей.
-
-## Заметки для агента
-
-> Корень является пользовательским интерфейсом. Новый обязательный параметр добавляйте в `main.typ` и public examples с вариантом в комментарии. Не создавайте дополнительный entrypoint ради режима сборки.

.template/development/modules/components.md

@@ -1,53 +0,0 @@
-# Модуль: Компоненты
-
-**Ответственность**: содержит проверенные переиспользуемые визуальные примитивы, которые не принадлежат одному профилю документа.
-**Расположение**: `.template/lib/presentation/components.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `corp-table()` | функция | Корпоративная таблица со сложной шапкой, spans и продолжениями |
-| `formula()` | функция | Блочная формула, совместимая с профильной нумерацией |
-| `signature-block()` | функция | Один подписант с media policy |
-| `multi-party-signing()` | функция | Подписание несколькими сторонами |
-| `approval-block()` | функция | Блок утверждения отчёта |
-| `company-footer()` | функция | Контакты и реквизиты организации в footer |
-| `letter-header()` | функция | Общая геометрия исходящего письма и ТКП |
-| `attachment-list()` | функция | Перечень приложений к письму или ТКП |
-| `requisites-table()` | функция | Реквизиты одной или нескольких сторон |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/company.typ` | Нормализованные реквизиты и brand |
-| `.template/lib/domain/parties.typ` | Signer, Approval и Party |
-| `.template/lib/domain/attachments.typ` | AttachmentSet для перечней |
-| `.template/lib/presentation/foundation.typ` | Design tokens и `render-media-slot()` |
-| `.template/lib/shared/numbering.typ` | Общие numbering functions |
-
-## Инварианты
-
-- Компонент не читает JSON и не конструирует пользовательский path.
-- Компонент не определяет global page settings.
-- `corp-table` сохраняет поддержку auto/multirow headers, rowspan/colspan, repeat header и continuation label.
-- `row_breakable: true` действительно передаётся в `table.cell(breakable:)`; режим проверяется fixture с одной строкой, которая продолжается на трёх страницах.
-- Центрирование блока `corp-table` не наследуется текстом ячеек: шапка по умолчанию центрирована, тело выровнено влево; явный `align` имеет приоритет.
-- Блок подписи сохраняет эталонную геометрию для обычных реквизитов и переключается на ограниченные равные боковые колонки при длинных наименованиях.
-- Письмо и ТКП используют один эталонный footer; на страницах приложений footer скрывается.
-- Обязательный positional `body` идёт первым в функциях, используемых через `.with`, если это требуется Typst.
-- Компонент принимает domain-значение и layout options отдельно.
-- Любая работа с изображением проходит через media slot или проверку `resource != none`.
-- Компоненты не импортируют profile renderers.
-
-## Намеренно НЕ обрабатывает
-
-- Полный жизненный цикл документа.
-- Profile-specific обязательность полей.
-- Выбор компании по id.
-- Сброс глобальных counters между главами.
-
-## Заметки для агента
-
-> `corp_table` считается особо хрупким: не переписывайте рекурсивное определение header rows без unit и visual fixtures на rowspan/colspan. Общность компонента доказывается использованием хотя бы в двух профилях; иначе оставьте его внутри конкретного renderer. Layout offsets изображений должны быть параметрами компонента или design tokens, но не данными Signer.

.template/development/modules/domain-attachments.md

@@ -1,39 +0,0 @@
-# Модуль: Приложения
-
-**Ответственность**: задаёт идентичность, порядок, заголовки и нумерацию приложений независимо от профиля и конкретной вёрстки.
-**Расположение**: `.template/lib/domain/attachments.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `attachment()` | конструктор dictionary | Создаёт приложение с `id`, `title`, `subtitle`, `body`, `numbering` |
-| `attachment-set()` | конструктор dictionary | Нормализует массив приложений и общую политику нумерации |
-| `validate-attachments()` | функция | Проверяет уникальность ids, номеров и допустимость body |
-| `attachment-label()` | чистая функция | Формирует семантическое обозначение без layout |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/shared/numbering.typ` | Стратегии арабской и кириллической нумерации как чистые функции |
-
-## Инварианты
-
-- `id` приложения уникален и пригоден для label.
-- Порядок массива является порядком документа, если пользователь явно не задал sort key.
-- Номер не хранится одновременно как вычисляемый и вручную заданный без явной override-policy.
-- `body` является content или функцией, которую renderer вызывает в локальном контексте.
-- Заголовок обязателен; subtitle необязателен.
-- Приложение не меняет global counter вне вызова своего renderer.
-
-## Намеренно НЕ обрабатывает
-
-- Размещение pagebreak и заголовка приложения.
-- Физическое объединение внешних PDF.
-- Подсчёт страниц вложения до компиляции.
-- Profile-specific текст «Приложение к договору».
-
-## Заметки для агента
-
-> Старые `make_appendices` и `appendix-header` решают presentation-задачи и не переносятся в domain. Domain должен одинаково поддерживать кириллические приложения отчёта, цифровые приложения ТКП и именованные приложения договора. Renderer выбирает display policy на основе profile metadata.

.template/development/modules/domain-company.md

@@ -1,39 +0,0 @@
-# Модуль: Организация
-
-**Ответственность**: описывает единый нормализованный профиль юридического лица и его фирменных ресурсов.
-**Расположение**: `.template/lib/domain/company.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `company-profile()` | конструктор dictionary | Создаёт профиль из секций `legal`, `contacts`, `banking`, `brand`, `director`, `resources` |
-| `validate-company()` | функция | Проверяет обязательные реквизиты и типы необязательных полей |
-| `company-display-name()` | чистая функция | Возвращает полное или краткое наименование по политике профиля |
-| `company-resource()` | чистая функция | Возвращает нормализованное значение ресурса из уже построенного profile |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| Нет | Domain не читает JSON и не строит пути |
-
-## Инварианты
-
-- `id`, полное наименование и юрисдикция заданы.
-- ИНН/КПП/ОГРН и БИН/КБЕ хранятся как строки, чтобы не терять ведущие нули и формат.
-- Контактные и банковские поля имеют единые ключи для всех компаний; неприменимое поле равно `none`.
-- Brand color нормализован до color до передачи renderer.
-- Логотип, подпись и печать имеют значение `none`, `path` или готовый content; произвольная строка после infrastructure-нормализации не допускается.
-- Director содержит должность и ФИО; ресурсы подписи и печати хранятся отдельно и не задают координаты на странице.
-
-## Намеренно НЕ обрабатывает
-
-- Поиск компании по содержимому документа.
-- Чтение `.template/companies/` и `.private/`.
-- Отрисовку логотипа, подписи, печати и реквизитов.
-- Валидацию законодательства конкретной юрисдикции.
-
-## Заметки для агента
-
-> Существующие JSON-файлы отличаются по набору полей. Нормализуйте их через infrastructure, не добавляйте условные ключи в renderer. Для РФ и Казахстана используйте общую структуру с `none` для неприменимых идентификаторов. Не переносите пользовательские изображения в CompanyProfile.

.template/development/modules/domain-document.md

@@ -1,40 +0,0 @@
-# Модуль: Документ
-
-**Ответственность**: владеет общей моделью документа, контрактом расширяемого профиля и режимами выпуска независимо от Typst-вёрстки.
-**Расположение**: `.template/lib/domain/document.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `document-context()` | конструктор dictionary | Создаёт полный неизменяемый контекст после нормализации и валидации |
-| `document-profile()` | конструктор dictionary | Создаёт контракт профиля с `id`, `metadata`, `normalize`, `validate`, `render` |
-| `render-options()` | конструктор dictionary | Нормализует режим выпуска, watermark и media policy |
-| `validate-profile-contract()` | функция | Проверяет, что расширение содержит все обязательные функции и поля |
-| `merge-known()` | чистая функция | Объединяет defaults с пользовательскими значениями по явным правилам |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| Нет | Модуль не импортирует infrastructure или presentation |
-
-## Инварианты
-
-- `DocumentProfile.id` — непустая стабильная строка.
-- `normalize`, `validate` и `render` являются functions.
-- Режим выпуска принадлежит конечному набору `final`, `draft`, `clean-copy`.
-- `DocumentContext` создаётся только после успешной валидации company, profile metadata, parties и attachments.
-- Domain-значения не содержат вызовов `page`, `image`, `place`, `context`, `query` или глобального `state`.
-- Merge не принимает неизвестные ключи молча: профиль либо объявляет extension bucket, либо возвращает ошибку.
-
-## Намеренно НЕ обрабатывает
-
-- Загрузку компании из JSON.
-- Пагинацию и выбор шрифта.
-- Физическое наличие файлов.
-- Состав обязательных полей конкретного отчёта или договора.
-
-## Заметки для агента
-
-> `DocumentProfile` — основной extension contract. Не превращайте его в строковый enum со switch в application. Renderer-function является портом presentation, переданным профилем. Для простого пользователя profile constructors скрывают этот контракт; вручную он нужен только разработчику нового вида документа.

.template/development/modules/domain-parties.md

@@ -1,40 +0,0 @@
-# Модуль: Стороны
-
-**Ответственность**: моделирует адресатов, стороны договора, представителей, подписантов и блоки утверждения независимо от их размещения.
-**Расположение**: `.template/lib/domain/parties.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `party()` | конструктор dictionary | Создаёт организацию или физическое лицо в роли стороны документа |
-| `recipient()` | конструктор dictionary | Создаёт адресата делового письма или ТКП |
-| `signer()` | конструктор dictionary | Создаёт подписанта с должностью, ФИО, основанием и ресурсом подписи |
-| `approval()` | конструктор dictionary | Создаёт данные блока утверждения отчёта |
-| `validate-parties()` | функция | Проверяет уникальность ролей и профильные обязательные поля |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/company.typ` | Может принять нормализованный `CompanyProfile` как сторону, не загружая его |
-
-## Инварианты
-
-- Каждая сторона имеет уникальный `id` внутри документа и непустую `role`.
-- Recipient допускает отдельно организацию, должность и имя; пустые строки нормализуются в `none`.
-- Signer хранит семантические данные и ресурс, но не layout offsets.
-- Contract-party содержит реквизиты либо ссылку на `CompanyProfile`, но не оба источника с конфликтующими значениями.
-- Approval date и document date являются разными полями и не подменяют друг друга.
-- Обязательность подписи определяется профилем и режимом выпуска, а не самим `Signer`.
-
-## Намеренно НЕ обрабатывает
-
-- Координаты и размеры изображений подписи.
-- Текст преамбулы договора.
-- Склонение ФИО и должностей.
-- Загрузку реквизитов из файлов.
-
-## Заметки для агента
-
-> Письмо, ТКП и договор должны использовать одинаковые базовые Party/Signer, но разные validators. Не добавляйте коммерческие поля в recipient и report-specific approval в party. Если понадобится склонение, создайте отдельный domain service, а не набор условий внутри renderer.

.template/development/modules/facade.md

@@ -1,48 +0,0 @@
-# Модуль: Публичный фасад
-
-**Ответственность**: предоставляет `main.typ` и публичным примерам стабильный API, скрывая внутренние DDD-слои и файловую структуру.
-**Расположение**: `.template/lib/index.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `document()` | show-функция | Собирает документ из явно переданных `company`, `profile`, `options` и `body` |
-| `profiles` | module namespace | Конструкторы `report`, `letter`, `commercial_offer`, `contract` |
-| `components` | module namespace | Поддерживаемые визуальные компоненты для пользовательского content |
-| `references` | module namespace | `vref`, `vrefs`, `eqref` и bibliography helpers |
-| `load-company()` | функция | Загружает публичный профиль и применяет явные resource overrides |
-| `report-executor()` | функция | Разрешает сотрудника, роль, private PNG и offset |
-| `private-company-media()` | функция | Разрешает private подпись и печать организации |
-| `document-profile()` | конструктор dictionary | Extension contract для нового вида документа |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/application/render-document.typ` | Единственный application use case |
-| `.template/lib/presentation/profiles/*.typ` | Публичные profile constructors |
-| `.template/lib/presentation/components.typ` | Разрешённый пользовательский набор компонентов |
-| `.template/lib/presentation/references.typ` | Публичные helpers ссылок |
-| `.template/lib/infrastructure/company-assets.typ` | Загрузка профилей компаний |
-| `.template/lib/infrastructure/employees.typ` | Справочник сотрудников и private settings adapter |
-
-## Инварианты
-
-- `main.typ` и public examples используют один import фасада и не знают внутренних путей.
-- В фасаде нет чтения пользовательских глав, page layout и profile-specific ветвлений.
-- Добавление нового профиля не меняет сигнатуру `document()`.
-- Resource override принимает явные `none`, `path` или content и не сканирует `.private/`.
-- В namespaces экспортируются только документированные символы.
-- В diagnostics используется бренд Scientia.
-
-## Намеренно НЕ обрабатывает
-
-- Включение пользовательских файлов из `chapters/`.
-- Создание пользовательских paths к `assets/`.
-- Выбор типа документа и режима выпуска.
-- Юридическую или смысловую проверку текста.
-
-## Заметки для агента
-
-> Фасад является границей между пользовательским `main.typ` и библиотекой. Если public example импортирует domain, infrastructure или конкретный renderer напрямую, фасад недостаточен. Обратная совместимость со старым корневым `template.typ` не требуется; не создавайте alias в корне.

.template/development/modules/infrastructure-assets.md

@@ -1,41 +0,0 @@
-# Модуль: Ресурсы компаний
-
-**Ответственность**: читает публичные данные `.template/companies/`, нормализует JSON, создаёт устойчивые Typst paths и применяет явные overrides подписи и печати.
-**Расположение**: `.template/lib/infrastructure/company-assets.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `load-company()` | функция | Загружает профиль по разрешённому id и принимает `logo`, `signature`, `stamp` overrides |
-| `available-companies()` | функция | Возвращает детерминированный список встроенных ids |
-| `merge-resources()` | чистая функция | Применяет только явно переданные resource overrides |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/company.typ` | `company-profile()` и `validate-company()` |
-| `.template/companies/*/data.json` | Публичные реквизиты организаций |
-| `.template/companies/*/logo.*` | Публичные логотипы |
-| `.template/lib/assets/placeholders/` | Безопасные круг и крест |
-
-## Инварианты
-
-- Адаптер не сканирует `assets/` или `.private/`.
-- Относительные внутренние paths создаются в infrastructure-файле.
-- Private paths организаций создаются адаптером сотрудников из явной настройки и передаются как готовые `path`.
-- Идентификатор компании выбирается из явного registry.
-- Публичные JSON не содержат путей к реальным подписям и печатям.
-- `none` сохраняется как отсутствие ресурса и обрабатывается media policy.
-- Указанный override не подменяется placeholder при ошибке загрузки.
-
-## Намеренно НЕ обрабатывает
-
-- Layout логотипа, подписи или печати.
-- Поиск файлов по имени.
-- Сетевую загрузку реквизитов.
-
-## Заметки для агента
-
-> Typst `path` сохраняет контекст файла, в котором создан. Public company paths создавайте здесь, а absolute `.private/` paths — только в private/employee adapter. Значения `auto` и `none` должны различаться: `auto` означает взять публичное значение профиля, `none` — осознанно применить media policy.

.template/development/modules/lists.md

@@ -1,42 +0,0 @@
-# Модуль: Настраиваемые списки
-
-**Ответственность**: формирует многоуровневые номера и маркеры, сохраняя нативную вёрстку `enum`.
-**Расположение**: `.template/lib/presentation/lists.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `numbered-list()` | function | Локально применяет схему и геометрию к стандартному нумерованному списку |
-| `list-scheme()` | constructor | Создаёт проверенную конфигурацию уровней, разделителей и окончаний |
-| `list-level()` | constructor | Описывает нестандартный уровень, включая prefix, suffix и width |
-| `list-numbering()` | function factory | Возвращает функцию нумерации для прямого использования в `enum` |
-| `list-schemes` | dictionary | Хранит публичные готовые схемы |
-
-## Инварианты
-
-- Модуль не заменяет `enum`: переносы страниц, вложенность и многоабзацные элементы остаются ответственностью Typst.
-- Внутренне `enum.full` всегда включён, чтобы форматтер знал глубину; показ родительских уровней определяет `scheme.full`.
-- Если массив levels, separators или suffixes короче глубины, повторяется его последнее значение.
-- Неизвестная именованная схема вызывает понятную ошибку и не подменяется схемой по умолчанию.
-- Локальные параметры `numbered-list` не должны менять списки за пределами переданного body.
-
-## Поддерживаемые обозначения
-
-- арабские числа: `1`;
-- арабские числа с ведущим нулём: `01` или `list-level("1", width: N)`;
-- римские числа: `I`, `i`;
-- латинские буквы: `A`, `a`;
-- кириллица по ГОСТ: `А`, `а`;
-- любой строковый или content-маркер;
-- пользовательская функция `value => content`.
-
-## Намеренно НЕ обрабатывает
-
-- собственную раскладку строк и переносы страниц;
-- скрытое глобальное продолжение счётчика между несвязанными списками;
-- автоматический выбор схемы по содержимому текста.
-
-## Заметки для агента
-
-> Не заменяйте нативный `enum` ручной сеткой или таблицей. Это ухудшит переносы, семантику документа и поддержку многоабзацных пунктов. Новые возможности добавляйте через форматирование массива родительских номеров и локальные set/show rules.

.template/development/modules/numbering.md

@@ -1,40 +0,0 @@
-# Модуль: Нумерация
-
-**Ответственность**: предоставляет чистые стратегии арабской, многоуровневой и кириллической нумерации без управления counters конкретного профиля.
-**Расположение**: `.template/lib/shared/numbering.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `cyrillic-numbering()` | чистая функция | Преобразует положительный номер в допустимую заглавную кириллическую букву |
-| `cyrillic-lower-numbering()` | чистая функция | Формирует строчную кириллическую часть списка |
-| `num-11()` | чистая функция | Формирует многоуровневый формат `1.1.` |
-| `num-1a()` | чистая функция | Чередует цифровые и кириллические уровни с наследованием |
-| `num-1-a()` | чистая функция | Чередует уровни без полного наследования родителей |
-| `attachment-numbering()` | чистая функция | Выбирает арабское или кириллическое обозначение из policy |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| Нет | Модуль состоит из чистых функций и неизменяемых массивов символов |
-
-## Инварианты
-
-- Исключённые ГОСТ-буквы не используются в кириллической последовательности.
-- Ноль и отрицательные значения не маскируются неявным fallback, несовместимым с будущими версиями Typst.
-- Функции не читают counters самостоятельно и форматируют только переданные числа.
-- Один и тот же вход всегда возвращает одинаковую строку.
-- Profile renderer управляет reset и scope counters, а не shared-модуль.
-
-## Намеренно НЕ обрабатывает
-
-- Сброс counters при новой главе.
-- Выбор numbering policy конкретного документа.
-- Формат заголовка приложения и supplement.
-- Локализацию на другие языки.
-
-## Заметки для агента
-
-> Typst 0.15 предупреждает о fallback для numbering systems, которые не умеют отображать ноль. Добавьте явные негативные unit tests. Сохраните существующие варианты `num_11`, `num_1a`, `num_1_a` семантически, но публичные имена можно унифицировать, поскольку обратная совместимость не требуется.

.template/development/modules/presentation-commercial-offer.md

@@ -1,43 +0,0 @@
-# Модуль: Технико-коммерческое предложение
-
-**Ответственность**: формирует ТКП как самостоятельный профиль с предметом, ценой, сроками, коммерческими условиями и приложениями.
-**Расположение**: `.template/lib/presentation/profiles/commercial-offer.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `commercial-offer-profile()` | конструктор `DocumentProfile` | Принимает адресата, предмет, стоимость, валюту, сроки и validity |
-| `render-commercial-offer()` | renderer-функция | Собирает шапку, резюме предложения, body, условия, подпись и приложения |
-| `commercial-terms()` | domain-normalizer | Нормализует цену, НДС, валюту, срок и порядок оплаты |
-| `commercial-offer-validators()` | массив functions | Проверяет предмет и обязательные коммерческие поля |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/document.typ` | `DocumentProfile` и context |
-| `.template/lib/domain/parties.typ` | Recipient и Signer |
-| `.template/lib/domain/attachments.typ` | Календарный план, ТЗ и другие приложения |
-| `.template/lib/presentation/foundation.typ` | Typography, page и media policy |
-| `.template/lib/presentation/components.typ` | Letter shell, money/date blocks, company footer, signature block |
-
-## Инварианты
-
-- ТКП имеет собственный `profile.id` и renderer, а не boolean-режим письма.
-- Стоимость хранится структурированно: amount, currency, tax note; renderer не разбирает свободную строку.
-- Срок выполнения и срок действия предложения являются разными полями.
-- Приложения используют общий AttachmentSet и могут иметь цифровую нумерацию.
-- Коммерческие defaults принадлежат constructor, но пользователь может заменить текстовые формулировки через content slots.
-- Renderer не импортирует внешний `G:/TYPST/TKP` и не читает его config.
-
-## Намеренно НЕ обрабатывает
-
-- Расчёт стоимости из сметы.
-- Юридическую проверку налоговой формулировки.
-- Автоматическое превращение ТКП в договор.
-- Специфические главы научного отчёта.
-
-## Заметки для агента
-
-> Используйте TKP только как контекст сценариев и визуальную подсказку. Не копируйте монолитный facade. Если уникальная иконка действительно нужна, перенесите её в `.template/lib/assets/icons/` и дайте ей семантическое имя. Таблицы календарного плана должны использовать общий `corp-table`, а не локальную реализацию.

.template/development/modules/presentation-contract.md

@@ -1,44 +0,0 @@
-# Модуль: Договор
-
-**Ответственность**: предоставляет расширяемый каркас договора с преамбулой, произвольными разделами, сторонами, реквизитами, подписанием и приложениями.
-**Расположение**: `.template/lib/presentation/profiles/contract.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `contract-profile()` | конструктор `DocumentProfile` | Принимает номер, дату, место, название, стороны и section options |
-| `render-contract()` | renderer-функция | Собирает header, preamble slot, body sections, requisites, signing и attachments |
-| `contract-section()` | конструктор dictionary | Описывает нумерованный или именованный раздел с body |
-| `contract-validators()` | массив functions | Проверяет стороны, номера, даты и уникальность sections |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/document.typ` | `DocumentProfile` и context |
-| `.template/lib/domain/parties.typ` | Contract parties, representatives и signers |
-| `.template/lib/domain/attachments.typ` | Приложения и спецификации |
-| `.template/lib/presentation/foundation.typ` | Base typography и signing-copy mode |
-| `.template/lib/presentation/components.typ` | Requisites table, multi-party signing, tables и numbering primitives |
-
-## Инварианты
-
-- В v1 поддерживается не менее двух сторон; модель не зашита строго на роли «Заказчик/Исполнитель».
-- Section id и display number уникальны.
-- Юридический текст sections остаётся пользовательским content.
-- Preamble можно передать content или собрать из сторон через явный helper; автоматический текст не является юридической гарантией.
-- Requisites берутся из Party/CompanyProfile, а не дублируются внутри renderer.
-- Signing-copy может резервировать место без реальных изображений подписи и печати.
-- Приложения используют тот же AttachmentSet, что отчёт и ТКП.
-
-## Намеренно НЕ обрабатывает
-
-- Юридическую достаточность и актуальность условий.
-- Электронную подпись и криптографию.
-- Согласование версий договора и tracked changes.
-- Автоматическую генерацию актов, счетов или УПД.
-
-## Заметки для агента
-
-> Не превращайте contract-profile в библиотеку юридических формулировок. Профиль отвечает за типографику и композицию. Чтобы будущие лицензионные, сервисные или смешанные договоры не требовали изменения renderer, sections должны быть открытым массивом с устойчивой numbering policy.

.template/development/modules/presentation-foundation.md

@@ -1,41 +0,0 @@
-# Модуль: Основа вёрстки
-
-**Ответственность**: предоставляет общие design tokens, режимы выпуска и безопасные presentation-примитивы без правил конкретного вида документа.
-**Расположение**: `.template/lib/presentation/foundation.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `design-tokens()` | конструктор dictionary | Шрифты, размеры, цвета, интервалы и стандартные поля страницы |
-| `apply-foundation()` | show-функция | Применяет локальные общие text/par/page defaults к body renderer |
-| `render-media-slot()` | функция | Отображает ресурс по policy `hide`, `placeholder`, `reserve-space` |
-| `render-mode()` | чистая функция | Нормализует `final`, `draft`, `clean-copy` |
-| `watermark-layer()` | функция | Создаёт слой watermark без изменения domain данных |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/document.typ` | `RenderOptions` и режим выпуска |
-| `.template/lib/domain/company.typ` | Brand color и нормализованные ресурсы |
-
-## Инварианты
-
-- Foundation не знает, является документ отчётом, письмом, ТКП или договором.
-- Общие defaults локальны body, не протекают в следующий независимый renderer.
-- `render-media-slot()` никогда не вызывает `image(none)`.
-- Размер placeholder и reserve-space задаётся вызывающим компонентом, чтобы не ломать профильную геометрию.
-- Watermark не влияет на layout flow и счётчики.
-- Внутри module scope не создаётся state, общий для нескольких документов.
-
-## Намеренно НЕ обрабатывает
-
-- Титульный лист отчёта.
-- Шапку письма и реквизиты договора.
-- Нумерацию приложений конкретного профиля.
-- Загрузку файлов и JSON.
-
-## Заметки для агента
-
-> Typst 0.15 изменил baseline у `box` и `block`; любые правки foundation требуют visual regression всех профилей. Не переносите сюда profile-specific отступ только потому, что он встречается в двух документах: сначала проверьте, является ли это действительно общим design token.

.template/development/modules/presentation-letter.md

@@ -1,43 +0,0 @@
-# Модуль: Деловое письмо
-
-**Ответственность**: формирует исходящее деловое письмо с адресатом, регистрационными данными, темой, основным текстом и подписанием.
-**Расположение**: `.template/lib/presentation/profiles/letter.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `letter-profile()` | конструктор `DocumentProfile` | Принимает дату, исходящий номер, адресата, тему и signing options |
-| `render-letter()` | renderer-функция | Собирает фирменную шапку, body, подпись и footer |
-| `letter-metadata()` | чистая функция | Нормализует регистрационные поля и тему |
-| `letter-validators()` | массив functions | Проверяет адресата, дату и подписанта |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/document.typ` | `DocumentProfile` и render options |
-| `.template/lib/domain/parties.typ` | Recipient и Signer |
-| `.template/lib/domain/attachments.typ` | Перечень приложений к письму |
-| `.template/lib/presentation/foundation.typ` | Общие tokens и media policy |
-| `.template/lib/presentation/components.typ` | Letter header, company footer, attachment list, signature block |
-
-## Инварианты
-
-- Letter profile не содержит коммерческой стоимости, графика работ или offer validity.
-- Recipient может быть частично заполнен, но validator требует хотя бы организацию или ФИО.
-- Исходящий номер и дата отображаются единым регистрационным блоком.
-- Footer включается profile option и не исчезает из-за состояния приложения другого документа.
-- Подпись, печать и место для ручного подписания obey media policy.
-- Renderer не импортирует report или commercial-offer profile.
-
-## Намеренно НЕ обрабатывает
-
-- Коммерческие условия ТКП.
-- Титул и содержание отчёта.
-- Разделы договора.
-- Регистрацию письма во внешней системе.
-
-## Заметки для агента
-
-> Внешний проект TKP содержит полезный визуальный референс шапки и footer, но его global `comp-data` и `in-appendix` не переносятся. Состояние footer, если оно понадобится, должно принадлежать только текущему renderer и сбрасываться внутри него. Общая геометрия письма выносится в components, чтобы ТКП переиспользовал её без импорта `render-letter()`.

.template/development/modules/presentation-report.md

@@ -1,46 +0,0 @@
-# Модуль: Отчёт
-
-**Ответственность**: реализует профиль научно-технического отчёта как стартовую заготовку, не влияя на деловые документы.
-**Расположение**: `.template/lib/presentation/profiles/report.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `report-profile()` | конструктор `DocumentProfile` | Принимает метаданные отчёта и безопасные defaults |
-| `render-report()` | renderer-функция | Собирает титул, служебные страницы, body, библиографии и приложения |
-| `report-metadata()` | чистая функция | Нормализует название, тему, договор, этап, том, год и режим исследования |
-| `report-validators()` | массив functions | Проверяет обязательные поля и совместимость опций |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `.template/lib/domain/document.typ` | `DocumentProfile`, `DocumentContext` |
-| `.template/lib/domain/parties.typ` | Approval и список исполнителей |
-| `.template/lib/domain/attachments.typ` | Приложения отчёта |
-| `.template/lib/presentation/foundation.typ` | Общую страницу, typography и render mode |
-| `.template/lib/presentation/components.typ` | Title primitives, signature rows, tables, formula |
-| `.template/lib/presentation/references.typ` | Cross-references и bibliography sections |
-| `.template/lib/shared/numbering.typ` | Нумерацию глав, фигур, формул и приложений |
-
-## Инварианты
-
-- Все report-specific `set/show/state` локальны `render-report()`.
-- Титульный лист, список исполнителей и содержание включаются profile options, а не наличием случайного поля.
-- `paper/clean-copy` не загружает изображения подписей и печатей при соответствующей media policy.
-- Counters фигур, таблиц и формул сбрасываются только в границах отчётной главы.
-- Приложения используют собственную стратегию numbering без изменения других profiles.
-- Bibliographies представлены массивом секций; renderer не ограничивает их количество одним `refs.bib`.
-- Пользовательский body не изменяется и размещается после служебных страниц.
-
-## Намеренно НЕ обрабатывает
-
-- Адресата исходящего письма.
-- Стоимость и срок действия ТКП.
-- Стороны и реквизиты договора.
-- Загрузку компании и пользовательских файлов.
-
-## Заметки для агента
-
-> Legacy renderer в `.template/lib/report.typ` является функциональной спецификацией, но его API можно менять. Переносите секции по одной и после каждой сравнивайте snapshots. Сохраните проверенные решения вокруг heading gaps, paragraph indent, continuation tables и executor signatures, пока тест не докажет, что упрощение безопасно.

.template/development/modules/private-assets.md

@@ -1,33 +0,0 @@
-# Модуль: Приватные ресурсы и сотрудники
-
-**Ответственность**: подключает игнорируемые Git подписи и печати через один переключатель, хранит публичный справочник сотрудников и оставляет пустое место при недоступной подписи.  
-**Расположение**: `.template/lib/infrastructure/employees.typ`, `.template/lib/assets/placeholders/`, `.private/`, `docs/examples/private/settings.typ`
-
-## Публичный интерфейс
-
-| Элемент | Назначение |
-|---------|------------|
-| `employee-directory` | ФИО, обычные должности и имена PNG |
-| `empty-private-settings` | Безопасная конфигурация без private paths |
-| `private-company-media()` | Возвращает подпись и печать выбранной организации либо `none` |
-| `report-executor()` | Строит legacy-compatible tuple исполнителя с необязательной подписью |
-| `.private/settings.typ` | Локальная доступность изображений и индивидуальные offsets |
-
-## Инварианты
-
-- При `use-private-assets = false` условный import не читает `.private/settings.typ`.
-- Включённая запись ссылается только на фиксированное имя из публичного справочника.
-- Отсутствующая или отключённая запись возвращает `none`, поэтому строка подписи остаётся пустой.
-- Реальные файлы не заменяют tracked placeholders.
-- Каталог `.private/` целиком игнорируется Git.
-- Обычная сборка и private-сборка используют одну VS Code task.
-
-## Намеренно НЕ обрабатывает
-
-- Доставку и шифрование папки `.private`.
-- Проверку подлинности подписи.
-- Автоматическую проверку наличия файла внутри Typst 0.15.
-
-## Заметки для агента
-
-> Typst не предоставляет безопасный file-exists. Поэтому при ещё не полученной подписи запись должна отсутствовать или иметь `enabled: false`. При добавлении сотрудника синхронно обновите directory, безопасный пример и публичную таблицу.

.template/development/modules/references.md

@@ -1,48 +0,0 @@
-# Модуль: Ссылки и библиографии
-
-**Ответственность**: предоставляет русскоязычные перекрёстные ссылки и модель одной или нескольких библиографических секций Typst 0.15.
-**Расположение**: `.template/lib/domain/references.typ`, `.template/lib/presentation/references.typ`
-
-## Публичный интерфейс
-
-| Символ | Тип | Описание |
-|--------|-----|----------|
-| `vref()` | contextual function | Форматирует одну ссылку с падежом для рисунка, таблицы, формулы или раздела |
-| `vrefs()` | contextual function | Форматирует массив однородных labels с корректным соединением |
-| `eqref()` | contextual function | Создаёт ссылку на формулу без лишнего supplement |
-| `bibliography-section()` | domain constructor | Описывает sources, title, style, target, group и политику переноса |
-| `render-bibliographies()` | function | Размещает произвольное число секций через нативный `bibliography()` |
-| `validate-bibliographies()` | function | Проверяет ids, sources, target/group и наличие default coverage policy |
-
-`vref()` и `vrefs()` по умолчанию используют предложный падеж и прописную первую букву названия объекта. Короткие коды — `"и"`, `"р"`, `"д"`, `"в"`, `"т"`, `"п"`; прежние сокращения и полные русские названия нормализуются во внутренние ключи `"имен"`, `"род"`, `"дат"`, `"вин"`, `"тв"`, `"предл"`. Строчная форма включается явно через `capitalized: false`.
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| Typst `query`, `selector`, `ref`, `cite` | Разрешение labels и citations |
-| Typst 0.15 `bibliography(target:, group:)` | Несколько списков источников и управление нумерацией |
-| `.template/lib/domain/document.typ` | Profile metadata и render options |
-
-## Инварианты
-
-- Cross-reference label и bibliography citation являются разными типами использования и не смешиваются в одной функции.
-- `vref` всегда обрабатывает состояние `element == none`, потому что Typst может ещё не обнаружить элемент.
-- `vref` поддерживает `имен`, `род`, `дат`, `вин`, `тв`, `предл`; неизвестный падеж является ошибкой, а не тихим fallback.
-- `vrefs` объединяет однородные labels под одной формой множественного числа (`рисунках 1 и 2`), смешанные типы форматирует поэлементно.
-- Каждая bibliography section имеет стабильный id и хотя бы один source.
-- Последующие секции по умолчанию начинаются с новой страницы (`page_break: true`), поэтому их заголовки и записи не могут наложиться; компактный режим включается явно.
-- `target` передаётся как `auto`, label, selector, location или function без преобразования в строку.
-- `group: none` сбрасывает нумерацию секции; одинаковая строковая группа продолжает нумерацию.
-- Если используется несколько sections, fixture обязан доказать, что каждая citation попала ровно в одну bibliography.
-
-## Намеренно НЕ обрабатывает
-
-- Редактирование `.bib` и Hayagriva-файлов.
-- Поиск научных источников.
-- Ссылки на внешние URL без label.
-- Автоматическое определение падежа по окружающему тексту.
-
-## Заметки для агента
-
-> Typst 0.15 нативно распределяет citations между несколькими bibliographies. Не воспроизводите этот алгоритм вручную. Domain хранит настройки, presentation вызывает built-in и смещает уровень заголовка библиографии по официальной схеме. Добавьте fixtures для поглавных, тематических, общей и раздельной нумерации.

.template/development/modules/starter-packs.md

@@ -1,42 +0,0 @@
-# Модуль: Публичные примеры документов
-
-**Ответственность**: хранит исполняемую документацию четырёх профилей и источник безопасной установки выбранного типа.  
-**Расположение**: `docs/examples/`
-
-## Публичный интерфейс
-
-| Каталог | Назначение |
-|---------|------------|
-| `documents/report/` | Полный отчёт с главами, bibliography и appendix |
-| `documents/letter/` | Деловое письмо |
-| `documents/commercial-offer/` | Технико-коммерческое предложение |
-| `documents/contract/` | Договор |
-| `formatting/` | Каталог рисунков, таблиц, формул, ссылок и списков |
-| `private/settings.typ` | Безопасный полный пример private settings без PNG |
-
-## Зависимости
-
-| Модуль | Что использует |
-|--------|----------------|
-| `/.template/lib/index.typ` | Только публичный фасад |
-| `use-starter.ps1` | Backup и копирование примера в корень |
-| Presentation profiles | Реальный layout каждого вида документа |
-
-## Инварианты
-
-- Каждый `main.typ` компилируется непосредственно из своего каталога.
-- Тот же каталог компилируется после копирования в корень.
-- Каждый пример явно показывает `company-id`, `document-mode`, `use-private-assets`, profile metadata и media policy.
-- Public example не зависит от `.template/development/`.
-- Formatting guide содержит пояснения рядом с копируемыми блоками.
-- Выбор типа создаёт backup до замены пользовательских файлов.
-
-## Намеренно НЕ обрабатывает
-
-- Обратную совместимость со старыми starters.
-- Синхронизацию уже изменённого примера с пользовательским fork.
-- Юридическую корректность демонстрационного договора.
-
-## Заметки для агента
-
-> Не создавайте отдельную showcase-копию: публичный пример должен одновременно быть тестовым fixture и источником установки. Изменение API считается завершённым только после обновления всех четырёх `main.typ` и formatting guide.

.template/development/modules/testing.md

@@ -1,44 +0,0 @@
-# Модуль: Тестирование
-
-**Ответственность**: защищает слои библиотеки, единственный root entrypoint, public examples, PDF semantics и визуальную стабильность.  
-**Расположение**: `.template/development/tests/`
-
-## Публичный интерфейс
-
-| Символ или файл | Тип | Описание |
-|-----------------|-----|----------|
-| `run-tests.py` | CLI | Полный release gate |
-| `manifest.json` | fixture manifest | Compile, semantic, negative и visual expectations |
-| `check_architecture()` | static check | Направление Typst imports |
-| `check_workspace()` | static check | Root surface, docs, VS Code, private settings и public examples |
-| `snapshots/` | visual baseline | Утверждённые страницы стабильных renderer fixtures |
-
-## Зависимости
-
-| Компонент | Что использует |
-|-----------|----------------|
-| Typst 0.15.1+ | Компиляция и PDF generation |
-| Poppler | Text extraction, links и PNG rendering |
-| Pillow | Pixel diff snapshots |
-| `docs/examples/` | Public executable documentation |
-
-## Инварианты
-
-- Корень не содержит `document.typ`, `draft.typ` и `clean-copy.typ`.
-- `docs/` видим и содержит обязательную public navigation.
-- Все четыре документа и formatting guide компилируются.
-- Generic profile fixtures проверяют `final`, `draft` и `clean-copy` без root entrypoint duplication.
-- Безопасный private settings example содержит всех сотрудников с отключёнными PNG.
-- Unit tests проверяют public directory, private offsets и отсутствие подписи.
-- Public company profiles не содержат настоящих sign/stamp.
-- Snapshot изменяется только после ручного visual review.
-
-## Намеренно НЕ обрабатывает
-
-- Юридическую корректность договоров.
-- Инженерную достоверность example values.
-- Установку сторонних extensions.
-
-## Заметки для агента
-
-> Public example является production-facing documentation: его compile failure блокирует выпуск так же, как regression renderer. Для layout changes сначала просмотрите rendered pages, затем осознанно обновите snapshots.

.template/development/modules/user-documentation.md

@@ -1,38 +0,0 @@
-# Модуль: Публичная документация
-
-**Ответственность**: проводит автора без опыта программирования от открытия fork до проверенного PDF.  
-**Расположение**: `README.md`, `docs/`
-
-## Публичный интерфейс
-
-| Документ | Назначение |
-|----------|------------|
-| `README.md` | Краткий обязательный маршрут и все важные ссылки |
-| `docs/README.md` | Полная пользовательская навигация |
-| `docs/documents.md` | Один main, режимы, профили, главы и assets |
-| `docs/formatting.md` | Таблицы, рисунки, формулы и ссылки |
-| `docs/examples/` | Компилируемые исходники |
-| `docs/vscode.md` | Расширения, preview и tasks |
-| `docs/git.md` | Совместная работа простыми словами |
-| `docs/private-assets.md` | Копирование `.private`, один переключатель, роли и offsets |
-| `docs/writing-style.md` | Заготовка для редактирования технического текста |
-| `docs/troubleshooting.md` | Диагностика типовых проблем |
-
-## Инварианты
-
-- `docs/` виден в Explorer и находится в корне.
-- Все обязательные сценарии доступны из root README.
-- Каждый Typst-фрагмент с нетривиальным API имеет компилируемую версию.
-- Термины Git объясняются бытовыми аналогиями.
-- Developer details остаются в `.template/development/`.
-- Документация не обещает автоматическую установку внутренних VSIX.
-
-## Намеренно НЕ обрабатывает
-
-- DDD architecture и migration internals.
-- Обучение программированию.
-- Администрирование Git-сервера.
-
-## Заметки для агента
-
-> Любое новое пользовательское действие сначала появляется в root README, затем раскрывается в `docs/`. Проверяйте относительные Markdown links и компиляцию public examples автоматически.

.template/development/modules/vscode-workspace.md

@@ -1,34 +0,0 @@
-# Модуль: Рабочая область VS Code
-
-**Ответственность**: синхронизирует воспроизводимую среду автора и предоставляет три понятные задачи.  
-**Расположение**: `.vscode/`, `.template/development/tools/`
-
-## Публичный интерфейс
-
-| Файл или задача | Назначение |
-|-----------------|------------|
-| `extensions.json` | Десять согласованных recommendations |
-| `settings.json` | Auto Save, spellcheck, TODO, скрытие служебных каталогов |
-| `Scientia: собрать PDF` | Компиляция текущего `main.typ` |
-| `Scientia: выбрать тип документа` | Backup и установка public example |
-| `Scientia: собрать учебный пример` | Компиляция выбранного исходника из `docs/examples/` |
-
-## Инварианты
-
-- `.vscode/` включён в Git, но скрыт в Explorer.
-- `docs/` никогда не скрыт.
-- Typewriter navigator содержит только `main.typ`.
-- Автосохранение не создаёт commit и не выполняет push.
-- Tasks не хранят приватные значения в tracked settings.
-- Одна build task собирает и public-, и private-режим согласно `main.typ`.
-- Внутренние VSIX не входят в репозиторий.
-
-## Намеренно НЕ обрабатывает
-
-- Установку VS Code, Git и Typst.
-- Авторизацию на Git-сервере.
-- Публикацию внутренних VSIX.
-
-## Заметки для агента
-
-> Не добавляйте отдельную build task для каждого режима: пользователь меняет `document-mode` в `main.typ`. Новая задача должна либо быть частой, либо существенно снижать риск потери данных.

.template/development/tests/domain/core.typ

@@ -1,67 +0,0 @@
-#import "/.template/lib/domain/document.typ": render-options, document-profile, validate-profile-contract
-#import "/.template/lib/domain/attachments.typ": attachment, attachment-set
-#import "/.template/lib/domain/references.typ": bibliography-section, validate-bibliographies
-#import "/.template/lib/infrastructure/company-assets.typ": load-company, available-companies
-#import "/.template/lib/infrastructure/employees.typ": employee-directory, empty-private-settings, private-company-media, report-executor
-
-#let passthrough(body, ctx) = body
-
-#let run() = {
-  let options = render-options()
-  assert.eq(options.mode, "final")
-  assert.eq(options.at("media-policy"), "placeholder")
-
-  let profile = document-profile("unit", passthrough)
-  assert.eq(validate-profile-contract(profile).id, "unit")
-
-  assert.eq(available-companies().len(), 4)
-  for id in available-companies() {
-    let loaded = load-company(id)
-    assert.eq(loaded.kind, "company-profile")
-    assert(type(loaded.legal.name) == str)
-  }
-  let company = load-company("test-company")
-  assert.eq(company.legal.name, "ООО «Тестовая компания»")
-  assert.eq(type(company.resources.logo), path)
-
-  assert.eq(employee-directory.len(), 9)
-  let unsigned = report-executor("fedorov")
-  assert.eq(unsigned.at(1), "Федоров Д.А.")
-  assert.eq(unsigned.at(2), none)
-
-  let private-settings = (
-    companies: (scientia: (signature: true, stamp: false)),
-    signatures: (
-      musikhin: (enabled: true, offset: 1.25cm),
-      fedorov: (enabled: false, offset: 0.7cm),
-    ),
-  )
-  let signed = report-executor(
-    "musikhin",
-    role: "Управляющий директор",
-    private-settings: private-settings,
-  )
-  assert.eq(signed.at(0), "Управляющий директор")
-  assert.eq(type(signed.at(2)), path)
-  assert.eq(signed.at(3), 1.25cm)
-  assert.eq(report-executor("fedorov", private-settings: private-settings).at(2), none)
-  let media = private-company-media(private-settings, "scientia")
-  assert.eq(type(media.signature), path)
-  assert.eq(media.stamp, none)
-  assert.eq(private-company-media(empty-private-settings, "scientia").signature, none)
-
-  let item = attachment("a", "Приложение", [Текст])
-  let items = attachment-set(items: (item,), numbering: "cyrillic")
-  assert.eq(items.items.len(), 1)
-
-  let bibliography = bibliography-section("main", path("/assets/references.bib"))
-  assert.eq(validate-bibliographies((bibliography,)).len(), 1)
-  assert.eq(bibliography.at("page-break"), true)
-  let compact-bibliography = bibliography-section(
-    "compact",
-    path("/assets/references.bib"),
-    page_break: false,
-  )
-  assert.eq(compact-bibliography.at("page-break"), false)
-  "ok"
-}

.template/development/tests/domain/legacy-numbering.typ

@@ -1,12 +0,0 @@
-#import "/.template/lib/numbering.typ": cyrillic_numbering, num_11, num_1a, num_1_a
-
-#let run() = {
-  assert.eq(cyrillic_numbering(1), "А")
-  assert.eq(cyrillic_numbering(8), "И")
-  assert.eq(cyrillic_numbering(25), "Я")
-  assert.eq(cyrillic_numbering(26), "26")
-  assert.eq(num_11(1, 2, 3), "1.2.3.")
-  assert.eq(num_1a(1, 2, 3), "1.б.3.")
-  assert.eq(num_1_a(1, 2), "б.")
-  "ok"
-}

.template/development/tests/domain/profiles.typ

@@ -1,46 +0,0 @@
-#import "/.template/lib/domain/parties.typ": recipient, party, signer
-#import "/.template/lib/presentation/profiles/index.typ" as profiles
-#import "/.template/lib/shared/numbering.typ": attachment_numbering
-
-#let run() = {
-  let addressee = recipient(company: "ООО «Адресат»")
-
-  let letter = profiles.letter(recipient: addressee)
-  assert.eq(letter.id, "letter")
-  assert.eq(((letter.validate)(letter.metadata)).recipient.kind, "recipient")
-
-  let offer = profiles.commercial_offer(
-    recipient: addressee,
-    subject: "Предмет",
-    amount: "100",
-  )
-  assert.eq(offer.id, "commercial-offer")
-  assert.eq(((offer.validate)(offer.metadata)).terms.amount, "100")
-
-  let left = party(
-    "left",
-    "Исполнитель",
-    "ООО «Исполнитель»",
-    representative: signer("И.И. Исполнитель", "Директор"),
-  )
-  let right = party(
-    "right",
-    "Заказчик",
-    "ООО «Заказчик»",
-    representative: signer("З.З. Заказчик", "Директор"),
-  )
-  let contract = profiles.contract(
-    number: "1",
-    parties: (left, right),
-    sections: (
-      profiles.contract_section("subject", "Предмет", [Текст раздела]),
-    ),
-  )
-  assert.eq(contract.id, "contract")
-  assert.eq(((contract.validate)(contract.metadata)).sections.len(), 1)
-
-  assert.eq(attachment_numbering("arabic", 2), "2")
-  assert.eq(attachment_numbering("cyrillic", 2), "Б")
-  assert.eq(attachment_numbering("none", 2), "")
-  "ok"
-}

.template/development/tests/fixtures/commercial-offer/main.typ

@@ -1,49 +0,0 @@
-#import "/.template/lib/api.typ": document, recipient, attachment, attachment-set
-#import "/.template/lib/presentation/profiles/commercial-offer.typ": commercial-offer-profile
-
-#let addressee = recipient(
-  company: "АО «Заказчик»",
-  title: "Руководителю службы автоматизации",
-  name: "С.С. Заказчикову",
-)
-
-#let appendices = attachment-set(items: (
-  attachment(
-    "scope",
-    "Техническое задание",
-    [
-      Поставка, настройка и ввод в эксплуатацию тестового комплекса.
-    ],
-  ),
-))
-
-#show: document.with(
-  company: "test-company",
-  profile: commercial-offer-profile(
-    recipient: addressee,
-    subject: "Поставка и внедрение тестового комплекса",
-    amount: "1 250 000",
-    currency: "руб.",
-    tax_note: "включая НДС 20 %",
-    delivery_term: "45 рабочих дней",
-    validity: "30 календарных дней",
-    payment_terms: "30 % аванс, 70 % после приёмки",
-    date: "26.08.2026",
-    reference: "ТКП-001",
-    note: "Контактное лицо: А.А. Автор",
-    attachments: appendices,
-  ),
-)
-
-Уважаемый Сергей Сергеевич!
-
-Предлагаем выполнить комплекс работ по поставке и внедрению оборудования.
-
-== Состав работ
-
-- обследование объекта;
-- поставка оборудования;
-- монтаж и пусконаладка;
-- обучение персонала заказчика.
-
-Гарантийный срок составляет 12 месяцев с даты подписания акта приёмки.

.template/development/tests/fixtures/contract/main.typ

@@ -1,85 +0,0 @@
-#import "/.template/lib/api.typ": document, party, signer, attachment, attachment-set, load-company
-#import "/.template/lib/presentation/profiles/contract.typ": contract-profile, contract-section
-
-#let company = load-company("test-company")
-
-#let contractor = party(
-  "contractor",
-  "Исполнитель",
-  company.legal.name,
-  legal: company.legal,
-  contacts: company.contacts,
-  banking: company.banking,
-  representative: signer(
-    company.director.name,
-    company.director.title,
-    basis: "Устава",
-    signature: company.resources.signature,
-    stamp: company.resources.stamp,
-  ),
-)
-
-#let customer = party(
-  "customer",
-  "Заказчик",
-  "ООО «Заказчик»",
-  legal: (
-    inn: "1111111111",
-    kpp: "111111111",
-    address: "г. Пример, ул. Договорная, 2",
-  ),
-  contacts: (email: "customer@example.invalid"),
-  banking: (
-    bank: "Банк заказчика",
-    account: "11111111111111111111",
-    bik: "111111111",
-  ),
-  representative: signer(
-    "П.П. Заказчиков",
-    "Генеральный директор",
-    basis: "Устава",
-  ),
-)
-
-#let sections = (
-  contract-section(
-    "subject",
-    "Предмет договора",
-    [Исполнитель обязуется выполнить работы, а Заказчик — принять и оплатить их на условиях настоящего договора.],
-  ),
-  contract-section(
-    "price",
-    "Цена и порядок расчётов",
-    [Цена договора составляет 1 250 000 рублей, включая НДС 20 %.],
-  ),
-  contract-section(
-    "liability",
-    "Ответственность сторон",
-    [Стороны несут ответственность в соответствии с законодательством Российской Федерации.],
-  ),
-)
-
-#let appendices = attachment-set(items: (
-  attachment(
-    "specification",
-    "Спецификация",
-    [
-      Перечень работ и оборудования согласуется сторонами в настоящем приложении.
-    ],
-  ),
-))
-
-#show: document.with(
-  company: "test-company",
-  profile: contract-profile(
-    number: "Д-001/2026",
-    date: "26 августа 2026 г.",
-    place: "г. Пример",
-    title: "Договор оказания услуг",
-    parties: (contractor, customer),
-    sections: sections,
-    attachments: appendices,
-  ),
-)
-
-Настоящий договор вступает в силу с момента подписания обеими сторонами.

.template/development/tests/fixtures/core-smoke/main.typ

@@ -1,26 +0,0 @@
-#import "/.template/lib/api.typ": document, document-profile
-
-#let smoke-renderer(body, ctx) = [
-  #set text(font: "Arial", size: 11pt, lang: "ru")
-  #set page(paper: "a4")
-  #text(weight: "bold")[DDD CORE SMOKE]
-
-  Компания: #ctx.company.legal.name
-
-  Профиль: #ctx.at("profile-id")
-
-  #body
-]
-
-#let smoke-profile = document-profile(
-  "smoke",
-  smoke-renderer,
-  metadata: (:),
-)
-
-#show: document.with(
-  company: "test-company",
-  profile: smoke-profile,
-)
-
-Изолированное ядро успешно собрано.

.template/development/tests/fixtures/default-report/main.typ

@@ -1,7 +0,0 @@
-#import "/.template/lib/index.typ": document
-
-#show: document.with(company: "test-company")
-
-#heading(numbering: none)[ПРОВЕРКА ПРОФИЛЯ ПО УМОЛЧАНИЮ]
-
-Корневой фасад формирует отчёт без явной передачи profile.

.template/development/tests/fixtures/facade-smoke/main.typ

@@ -1,13 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles, recipient
-
-#show: document.with(
-  company: "test-company",
-  profile: profiles.letter(
-    recipient: recipient(company: "ООО «Проверка фасада»"),
-    title: "Публичный фасад",
-    show_stamp: false,
-  ),
-  options: (mode: "clean-copy", media-policy: "hide"),
-)
-
-Корневой файл экспортирует единый фасад и namespace профилей.

.template/development/tests/fixtures/letter/main.typ

@@ -1,38 +0,0 @@
-#import "/.template/lib/api.typ": document, recipient, attachment, attachment-set
-#import "/.template/lib/presentation/profiles/letter.typ": letter-profile
-
-#let addressee = recipient(
-  company: "ООО «Получатель»",
-  title: "Генеральному директору",
-  name: "П.П. Получателю",
-  address: "г. Пример, ул. Адресная, 10",
-)
-
-#let appendices = attachment-set(items: (
-  attachment(
-    "specification",
-    "Краткая спецификация",
-    [
-      Состав приложения задаётся пользователем независимо от профиля письма.
-    ],
-  ),
-))
-
-#show: document.with(
-  company: "test-company",
-  profile: letter-profile(
-    recipient: addressee,
-    date: "26.08.2026",
-    reference: "Л-001",
-    title: "О направлении материалов",
-    note: "Исполнитель: А.А. Автор, +7 (000) 000-00-01",
-    attachments: appendices,
-    render_attachments: true,
-  ),
-)
-
-Уважаемый Пётр Петрович!
-
-Направляем материалы для рассмотрения. Профиль письма использует единый источник данных компании и самостоятельно формирует шапку, подвал, список приложений и блок подписи.
-
-Просим подтвердить получение документов.

.template/development/tests/fixtures/list-counters/main.typ

@@ -1,90 +0,0 @@
-#import "/.template/lib/index.typ": numbered-list
-
-#set page("a4", margin: 1cm)
-#set text(size: 9pt)
-#set par(first-line-indent: 0pt, leading: 0.4em)
-
-= SCIENTIA LIST COUNTERS
-
-#let compact-list(style, body) = numbered-list(
-  levels: (style,),
-  suffixes: ".",
-  line-leading: 0.4em,
-  item-spacing: 0pt,
-  body,
-)
-
-== Арабские числа
-
-#compact-list("1")[
-+ Арабские: первый
-+ Арабские: второй
-+ Арабские: третий
-]
-
-== Кириллица
-
-#grid(
-  columns: (1fr, 1fr),
-  gutter: 1cm,
-  [
-    #compact-list("А")[
-    + Кириллица верхняя: первый
-    + Кириллица верхняя: второй
-    + Кириллица верхняя: третий
-    ]
-  ],
-  [
-    #compact-list("а")[
-    + Кириллица нижняя: первый
-    + Кириллица нижняя: второй
-    + Кириллица нижняя: третий
-    ]
-  ],
-)
-
-== Латиница
-
-#grid(
-  columns: (1fr, 1fr),
-  gutter: 1cm,
-  [
-    #compact-list("A")[
-    + Латиница верхняя: первый
-    + Латиница верхняя: второй
-    + Латиница верхняя: третий
-    ]
-  ],
-  [
-    #compact-list("a")[
-    + Латиница нижняя: первый
-    + Латиница нижняя: второй
-    + Латиница нижняя: третий
-    ]
-  ],
-)
-
-== Ведущий ноль
-
-#compact-list("01")[
-+ Ведущий ноль: первый
-+ Ведущий ноль: второй
-+ Ведущий ноль: третий
-]
-
-== Вложенные счётчики
-
-#numbered-list(
-  levels: ("1", "а", "A"),
-  full: true,
-  separators: ".",
-  suffixes: ".",
-  line-leading: 0.4em,
-  item-spacing: 0pt,
-)[
-+ Корневой уровень
-  + Второй уровень: первый
-  + Второй уровень: второй
-    + Третий уровень: первый
-    + Третий уровень: второй
-]

.template/development/tests/fixtures/modes/main.typ

@@ -1,60 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles, recipient, party, signer, load-company
-
-#let profile-id = sys.inputs.at("profile", default: "letter")
-#let mode = sys.inputs.at("mode", default: "draft")
-#let company-id = sys.inputs.at("company", default: "test-company")
-#let company = load-company(company-id)
-#let addressee = recipient(company: "ООО «Проверка режима»")
-
-#let left = party(
-  "left",
-  "Исполнитель",
-  company.legal.name,
-  legal: company.legal,
-  contacts: company.contacts,
-  banking: company.banking,
-  representative: signer(
-    company.director.name,
-    company.director.title,
-    signature: company.resources.signature,
-    stamp: company.resources.stamp,
-  ),
-)
-#let right = party(
-  "right",
-  "Заказчик",
-  "ООО «Проверка режима»",
-  representative: signer("П.П. Проверяющий", "Директор"),
-)
-
-#let selected-profile = if profile-id == "report" {
-  profiles.report(title: "Проверка режима выпуска", year: 2026)
-} else if profile-id == "letter" {
-  profiles.letter(recipient: addressee, title: "Проверка режима выпуска")
-} else if profile-id == "commercial-offer" {
-  profiles.commercial_offer(
-    recipient: addressee,
-    subject: "Проверка режима выпуска",
-    amount: "100 000",
-    currency: "руб.",
-  )
-} else if profile-id == "contract" {
-  profiles.contract(
-    number: "MODE-1",
-    date: "26.08.2026",
-    parties: (left, right),
-    sections: (
-      profiles.contract_section("subject", "Предмет договора", [Проверка режима выпуска.]),
-    ),
-  )
-} else {
-  panic("Неизвестный тестовый profile: " + profile-id)
-}
-
-#show: document.with(
-  company: company,
-  profile: selected-profile,
-  options: (mode: mode, watermark: if mode == "draft" { "ЧЕРНОВИК" } else { none }),
-)
-
-Документ собран в режиме #mode для профиля #profile-id.

.template/development/tests/fixtures/negative-company/main.typ

@@ -1,5 +0,0 @@
-#import "/.template/lib/index.typ": document
-
-#show: document.with(company: "unknown-company")
-
-Этот текст не должен попасть в PDF.

.template/development/tests/fixtures/negative-contract/main.typ

@@ -1,13 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles, party
-
-#let duplicate = (
-  party("same", "Исполнитель", "ООО «Первый»"),
-  party("same", "Заказчик", "ООО «Второй»"),
-)
-
-#show: document.with(
-  company: "test-company",
-  profile: profiles.contract(number: "1", parties: duplicate),
-)
-
-Этот текст не должен попасть в PDF.

.template/development/tests/fixtures/negative-letter/main.typ

@@ -1,8 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles
-
-#show: document.with(
-  company: "test-company",
-  profile: profiles.letter(),
-)
-
-Этот текст не должен попасть в PDF.

.template/development/tests/fixtures/negative-list-scheme/main.typ

@@ -1,5 +0,0 @@
-#import "/.template/lib/index.typ": numbered-list
-
-#numbered-list(scheme: "неизвестная-схема")[
-+ Тестовый пункт
-]

.template/development/tests/fixtures/negative-offer/main.typ

@@ -1,11 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles, recipient
-
-#show: document.with(
-  company: "test-company",
-  profile: profiles.commercial_offer(
-    recipient: recipient(company: "ООО «Адресат»"),
-    subject: "Предложение без стоимости",
-  ),
-)
-
-Этот текст не должен попасть в PDF.

.template/development/tests/fixtures/negative-reference-case/main.typ

@@ -1,3 +0,0 @@
-#import "/.template/lib/index.typ": vref
-
-#vref(<missing-reference>, grammatical-case: "мест")

.template/development/tests/fixtures/negative-references/main.typ

@@ -1,5 +0,0 @@
-#import "/.template/lib/index.typ": vrefs
-
-#vrefs((<valid-label>, "not-a-label"))
-
-#figure(rect(width: 1cm, height: 1cm), caption: [Элемент]) <valid-label>

.template/development/tests/fixtures/no-media/main.typ

@@ -1,39 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles, recipient, company-profile
-
-#let policy = sys.inputs.at("policy", default: "placeholder")
-#let company = company-profile(
-  "no-media",
-  (
-    name: "ООО «Компания без встроенных графических ресурсов»",
-    short-name: "Без ресурсов",
-    jurisdiction: "RU",
-    inn: "0000000000",
-  ),
-  contacts: (
-    email: "no-media@example.invalid",
-    phone: "+7 (000) 000-00-00",
-    address: "г. Пример, очень длинный адрес для проверки переноса строк в деловом документе, дом 100, офис 200",
-  ),
-  banking: (:),
-  brand: (color: rgb("e39f49")),
-  director: (title: "Генеральный директор", name: "И.И. Подписант"),
-  resources: (logo: none, signature: none, stamp: none),
-)
-
-#show: document.with(
-  company: company,
-  profile: profiles.letter(
-    recipient: recipient(
-      company: "Акционерное общество «Организация с длинным наименованием для проверки устойчивости вёрстки»",
-      title: "Заместителю генерального директора по техническим и коммерческим вопросам",
-      name: "П.П. Получателю",
-      address: "г. Пример, проспект Испытательный, дом 123, строение 45",
-    ),
-    date: "26.08.2026",
-    reference: "NO-MEDIA-001",
-    title: "Проверка формирования документа без логотипа, подписи и печати",
-  ),
-  options: (mode: "final", media-policy: policy),
-)
-
-Документ без графических ресурсов собран с политикой #policy.

.template/development/tests/fixtures/presentation-smoke/main.typ

@@ -1,49 +0,0 @@
-#import "/.template/lib/api.typ": load-company, recipient, signer
-#import "/.template/lib/presentation/foundation.typ": apply-foundation, render-media-slot
-#import "/.template/lib/presentation/components.typ": corp_table, company-footer, letter-header, signature-block
-
-#let company = load-company("test-company")
-#let addressee = recipient(
-  company: "ООО «Получатель»",
-  title: "Руководителю проекта",
-  name: "П.П. Примерову",
-)
-#let director = signer(
-  company.director.name,
-  company.director.title,
-  signature: company.resources.signature,
-  stamp: company.resources.stamp,
-)
-#let ctx = (
-  company: company,
-  options: (watermark: none),
-)
-
-#show: apply-foundation.with(
-  ctx: ctx,
-  page-options: (margin: (x: 2cm, y: 1.5cm)),
-)
-
-#letter-header(
-  company,
-  addressee,
-  date: "26.08.2026",
-  reference: "TEST-1",
-  title: "Проверка компонентов",
-)
-
-#v(0.8cm)
-Общая presentation-основа не зависит от конкретного профиля документа.
-
-#v(0.8cm)
-#corp_table(
-  columns: 2,
-  [Компонент], [Состояние],
-  [Таблица], [Работает],
-  [Media slot], [#render-media-slot(none, width: 3cm, height: 1cm)],
-)
-
-#v(1cm)
-#signature-block(director, company: company)
-
-#place(bottom + left, dy: 0.5cm, company-footer(company))

.template/development/tests/fixtures/reference-cases/main.typ

@@ -1,49 +0,0 @@
-#import "/.template/lib/index.typ": vref, vrefs
-
-#set page(paper: "a4", margin: 15mm)
-#set text(lang: "ru", size: 9pt)
-#set heading(numbering: "1.")
-#set figure(numbering: "1")
-
-#figure(
-  rect(width: 12mm, height: 6mm),
-  caption: [Первый рисунок],
-) <case-figure-a>
-
-#figure(
-  rect(width: 12mm, height: 6mm),
-  caption: [Второй рисунок],
-) <case-figure-b>
-
-#figure(
-  table(columns: 1, [Значение]),
-  caption: [Тестовая таблица],
-) <case-table>
-
-#math.equation(block: true, numbering: "(1)")[$x = 1$] <case-equation>
-
-= Тестовый раздел <case-section>
-
-Предложный по умолчанию: на #vref(<case-figure-a>).
-
-Именительный коротко: #vref(<case-figure-a>, "и").
-
-Родительный коротко: без #vref(<case-figure-a>, "р").
-
-Дательный коротко: к #vref(<case-figure-a>, "д").
-
-Винительный коротко: вижу #vref(<case-figure-a>, "в").
-
-Творительный коротко: перед #vref(<case-figure-a>, "т").
-
-Предложный коротко: на #vref(<case-figure-a>, "п").
-
-Явная строчная форма: на #vref(<case-figure-a>, capitalized: false).
-
-Полное название: на #vref(<case-table>, "предложный").
-
-Формула: согласно #vref(<case-equation>, "дательный").
-
-Раздел: в #vref(<case-section>).
-
-Группа по умолчанию: на #vrefs((<case-figure-a>, <case-figure-b>)).

.template/development/tests/fixtures/report-baseline/main.typ

@@ -1,71 +0,0 @@
-#import "/.template/lib/report.typ": report
-#import "/.template/lib/company.typ": company-defaults
-#import "/.template/lib/components.typ": corp_table, formula
-#import "/.template/lib/appendices.typ": make_appendices
-#import "/.template/lib/references.typ": vref, eqref
-
-#show: report.with(
-  ..company-defaults(company-id: "test-company"),
-  udk: "000.000",
-  director_date: "«26» августа 2026 г.",
-  is_research: true,
-  title: "Тестовый отчёт",
-  theme: "Регрессионная проверка шаблона",
-  is_intermediate: true,
-  stage_num: 1,
-  vol_num: 1,
-  contract_num: "TEST-001",
-  contract_date: "«26» августа 2026",
-  year: 2026,
-  executors: (
-    ("Ответственный исполнитель", "Тестов И.И.", path("/.template/companies/test-company/sign.svg"), 0.5cm),
-    ("Инженер", "Примеров П.П.", path("/.template/companies/test-company/sign.svg"), 0.5cm),
-  ),
-)
-
-#heading(numbering: none)[ВВЕДЕНИЕ]
-
-Этот документ фиксирует исходное поведение шаблона перед архитектурным рефакторингом.
-
-= ОСНОВНОЙ РАЗДЕЛ
-
-Сложные элементы должны сохранять нумерацию, подписи и ссылки.
-
-#figure(
-  image("/.template/companies/test-company/logo.svg", width: 35%),
-  caption: [Синтетический логотип для визуального теста],
-) <baseline-figure>
-
-Ссылка на рисунок: #vref(<baseline-figure>, grammatical-case: "вин").
-
-#figure(
-  corp_table(
-    columns: (1fr, 1fr, 1fr),
-    table.cell(rowspan: 2, align: center + horizon)[Параметр],
-    table.cell(colspan: 2, align: center + horizon)[Значения],
-    [Минимум], [Максимум],
-    [Тестовая строка], [10], [20],
-    [Вторая строка], [30], [40],
-  ),
-  caption: [Таблица с многострочной шапкой],
-) <baseline-table>
-
-Ссылка на таблицу: #vref(<baseline-table>, grammatical-case: "предл").
-
-#formula($a^2 + b^2 = c^2$) <baseline-equation>
-
-Ссылка на формулу: #eqref(<baseline-equation>).
-
-#pagebreak()
-#heading(numbering: none)[ЗАКЛЮЧЕНИЕ]
-
-Компиляция и визуальное сравнение подтверждают стабильность ключевых элементов.
-
-#pagebreak()
-#heading(numbering: none)[СПИСОК ИСПОЛЬЗОВАННЫХ ИСТОЧНИКОВ]
-#bibliography("/assets/references.bib", title: none, style: "gost-r-705-2008-numeric")
-
-#show: make_appendices
-= ТЕСТОВОЕ ПРИЛОЖЕНИЕ
-
-Содержимое приложения используется для проверки кириллической нумерации.

.template/development/tests/fixtures/report-new/main.typ

@@ -1,90 +0,0 @@
-#import "/.template/lib/api.typ": document, attachment, attachment-set, bibliography-section
-#import "/.template/lib/presentation/profiles/report.typ": report-profile
-#import "/.template/lib/presentation/components.typ": corp_table, formula
-#import "/.template/lib/presentation/references.typ": vref, vrefs, eqref
-
-#let appendices = attachment-set(
-  numbering: "cyrillic",
-  items: (
-    attachment(
-      "test-appendix",
-      "Тестовое приложение",
-      [Приложение создано через независимую доменную модель.],
-    ),
-  ),
-)
-
-#let bibliographies = (
-  bibliography-section(
-    "normative",
-    path("normative.bib"),
-    title: [НОРМАТИВНЫЕ ИСТОЧНИКИ],
-    group: "report-sources",
-  ),
-  bibliography-section(
-    "science",
-    path("science.bib"),
-    title: [НАУЧНЫЕ ИСТОЧНИКИ],
-    group: "report-sources",
-  ),
-)
-
-#show: document.with(
-  company: "test-company",
-  profile: report-profile(
-    title: "Новый модульный отчёт",
-    theme: "Проверка DDD-профиля",
-    udk: "000.000",
-    director_date: "«26» августа 2026 г.",
-    is_research: true,
-    is_intermediate: true,
-    stage_number: 1,
-    volume_number: 1,
-    contract_number: "DDD-001",
-    contract_date: "«26» августа 2026",
-    city: "Пример",
-    year: 2026,
-    executors: (
-      ("Ответственный исполнитель", "Тестов И.И.", path("/.template/companies/test-company/sign.svg"), 0.5cm),
-    ),
-    attachments: appendices,
-    bibliographies: bibliographies,
-  ),
-)
-
-#heading(numbering: none)[ВВЕДЕНИЕ]
-
-Профиль отчёта использует нормативный источник @normative-test и научную публикацию @science-test.
-
-= ПРОВЕРКА ССЫЛОК
-
-#figure(
-  rect(width: 3cm, height: 1.5cm, fill: rgb("fbb20d")),
-  caption: [Первый тестовый рисунок],
-) <new-figure-a>
-
-#figure(
-  circle(radius: 0.7cm, fill: rgb("e39f49")),
-  caption: [Второй тестовый рисунок],
-) <new-figure-b>
-
-Одна ссылка: #vref(<new-figure-a>, grammatical-case: "предл").
-
-Несколько ссылок: #vrefs((<new-figure-a>, <new-figure-b>), grammatical-case: "вин").
-
-#figure(
-  corp_table(
-    columns: 2,
-    [Параметр], [Значение],
-    [Архитектура], [Изолированная],
-  ),
-  caption: [Проверочная таблица],
-)
-
-#formula($x^2 + y^2 = z^2$) <new-equation>
-
-Формула: #eqref(<new-equation>).
-
-#heading(numbering: none)[ЗАКЛЮЧЕНИЕ]
-
-Новый отчёт собирается через `document` и `report-profile`.

.template/development/tests/fixtures/report-new/normative.bib

@@ -1,6 +0,0 @@
-@book{normative-test,
-  title={Синтетический нормативный источник},
-  author={{Тестовый регулятор}},
-  year={2026},
-  publisher={Тестовое издательство}
-}

.template/development/tests/fixtures/report-new/science.bib

@@ -1,8 +0,0 @@
-@article{science-test,
-  title={Синтетическое исследование устойчивости шаблонов},
-  author={Тестов, И. И.},
-  year={2026},
-  journal={Журнал тестовых данных},
-  volume={1},
-  pages={1--10}
-}

.template/development/tests/fixtures/report-stress/main.typ

@@ -1,136 +0,0 @@
-#import "/.template/lib/index.typ": document, profiles, corp-table, formula, vref, vrefs, eqref
-
-#let stress-rows = range(1, 73).map(index => (
-  [#index],
-  [
-    #if index == 3 {
-      [Составной параметр:
-      - первый вложенный пункт;
-      - второй вложенный пункт с длинным пояснением внутри ячейки.]
-    } else {
-      [Параметр #index с достаточно длинным наименованием для проверки переноса строк]
-    }
-  ],
-  [
-    #if index == 4 {
-      [Значение #index. #link("https://example.invalid/table-cell")[Ссылка внутри ячейки] сохраняет кликабельность и не меняет отступы.]
-    } else {
-      [Значение #index. Текст ячейки переносится, но сохраняет одинаковые внутренние поля и межстрочный интервал.]
-    }
-  ],
-)).flatten()
-
-#show: document.with(
-  company: "test-company",
-  profile: profiles.report(
-    title: "Стресс-тест типографики",
-    theme: "Таблицы, списки, формулы и грамматические ссылки",
-    year: 2026,
-    executors: (),
-  ),
-)
-
-= КОНТЕКСТНЫЕ ИНТЕРВАЛЫ
-
-== Заголовок перед абзацем
-
-Обычный абзац после заголовка должен иметь устойчивую красную строку, нормативный межстрочный интервал и не зависеть от элемента, который находился перед заголовком.
-
-== Заголовок перед маркированным списком
-
-- Первый уровень маркированного списка;
-  - второй уровень с длинным текстом, который переносится на новую строку без смещения маркера;
-    - третий уровень.
-- Возврат на первый уровень.
-
-== Заголовок перед нумерованным списком
-
-+ Основной пункт
-  + Второй уровень
-    + Третий уровень
-+ Следующий основной пункт
-
-== Соседние заголовки
-=== Заголовок третьего уровня
-==== Заголовок четвёртого уровня
-
-Текст после цепочки заголовков.
-
-= ССЫЛКИ С ПАДЕЖАМИ <stress-section>
-
-#figure(
-  rect(width: 3cm, height: 1.3cm, fill: rgb("fbb20d")),
-  caption: [Первый контрольный рисунок],
-) <stress-figure-a>
-
-#figure(
-  circle(radius: 0.65cm, fill: rgb("e39f49")),
-  caption: [Второй контрольный рисунок],
-) <stress-figure-b>
-
-#formula($a^2 + b^2 = c^2$) <stress-equation>
-
-Именительный: #vref(<stress-figure-a>, grammatical-case: "имен").
-Родительный: без #vref(<stress-figure-a>, grammatical-case: "род").
-Дательный: к #vref(<stress-figure-a>, grammatical-case: "дат").
-Винительный: см. #vref(<stress-figure-a>, grammatical-case: "вин").
-Творительный: перед #vref(<stress-figure-a>, grammatical-case: "тв").
-Предложный: на #vref(<stress-figure-a>, grammatical-case: "предл").
-
-Групповая ссылка: на #vrefs(
-  (<stress-figure-a>, <stress-figure-b>),
-  grammatical-case: "предл",
-).
-
-Формула в дательном падеже: к #vref(<stress-equation>, grammatical-case: "дат"); короткая ссылка #eqref(<stress-equation>).
-
-Ссылка на раздел: в #vref(<stress-section>, grammatical-case: "предл").
-
-Внешняя ссылка: #link("https://example.invalid/specification")[контрольная спецификация].
-
-= МНОГОСТРАНИЧНАЯ ТАБЛИЦА
-
-#figure(
-  corp-table(
-    columns: (1.2cm, 1.7fr, 2.3fr),
-    header: (
-      table.cell(rowspan: 2, align: center + horizon)[№],
-      table.cell(colspan: 2, align: center + horizon)[Контрольные данные],
-      [Параметр],
-      [Описание и значение],
-    ),
-    body: stress-rows,
-    repeat_header: true,
-    continuation: true,
-    continuation_text: "Продолжение таблицы",
-    body-leading: 0.65em,
-    body-inset: (x: 4pt, y: 3pt),
-    justify: false,
-    hyphenate: false,
-  ),
-  caption: [Таблица, переходящая через несколько страниц],
-) <stress-table>
-
-= ПРОВЕРКА ПОСЛЕ ТАБЛИЦЫ
-
-Текст после таблицы не должен прилипать к последней строке. Ссылка на #vref(<stress-table>, grammatical-case: "вин") остаётся рабочей.
-
-#pagebreak()
-= ВЫСОКАЯ СТРОКА ТАБЛИЦЫ
-
-#let tall-cell = range(1, 66).map(index => [Строка высокой ячейки #index. Содержимое одной строки таблицы продолжается без потери границ.]).join(linebreak())
-
-#figure(
-  corp-table(
-    columns: (3cm, 1fr),
-    header: ([Идентификатор], [Высокая ячейка]),
-    body: ([ROW-ONE], tall-cell),
-    row_breakable: true,
-    page_break: "fit",
-    repeat_header: true,
-    continuation: true,
-    continuation_text: "Продолжение высокой таблицы",
-    justify: false,
-  ),
-  caption: [Одна высокая строка, переходящая через страницы],
-) <tall-row-table>

.template/development/tests/manifest.json

@@ -1,453 +0,0 @@
-{
-  "version": 1,
-  "typst_min": "0.15.1",
-  "creation_timestamp": 1787702400,
-  "dpi": 110,
-  "visual_threshold": 0.001,
-  "unit_tests": [
-    {
-      "id": "legacy-numbering",
-      "module": ".template/development/tests/domain/legacy-numbering.typ"
-    },
-    {
-      "id": "core-domain",
-      "module": ".template/development/tests/domain/core.typ"
-    },
-    {
-      "id": "profile-domain",
-      "module": ".template/development/tests/domain/profiles.typ"
-    }
-  ],
-  "fixtures": [
-    {
-      "id": "core-smoke",
-      "entry": ".template/development/tests/fixtures/core-smoke/main.typ",
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": [
-        "DDD CORE SMOKE",
-        "ООО «Тестовая компания»",
-        "Изолированное ядро успешно собрано"
-      ],
-      "snapshot_pages": []
-    },
-    {
-      "id": "facade-smoke",
-      "entry": ".template/development/tests/fixtures/facade-smoke/main.typ",
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ПУБЛИЧНЫЙ ФАСАД",
-        "Корневой файл экспортирует единый фасад"
-      ],
-      "snapshot_pages": []
-    },
-    {
-      "id": "default-report",
-      "entry": ".template/development/tests/fixtures/default-report/main.typ",
-      "expected_pages": 3,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ПРОВЕРКА ПРОФИЛЯ ПО УМОЛЧАНИЮ",
-        "Корневой фасад формирует отчёт"
-      ],
-      "snapshot_pages": []
-    },
-    {
-      "id": "presentation-smoke",
-      "entry": ".template/development/tests/fixtures/presentation-smoke/main.typ",
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ПРОВЕРКА КОМПОНЕНТОВ",
-        "Общая presentation-основа",
-        "Media slot"
-      ],
-      "snapshot_pages": [1]
-    },
-    {
-      "id": "report-new",
-      "entry": ".template/development/tests/fixtures/report-new/main.typ",
-      "expected_pages": 7,
-      "expected_page_size": "A4",
-      "required_text": [
-        "Проверка DDD-профиля",
-        "НОРМАТИВНЫЕ ИСТОЧНИКИ",
-        "НАУЧНЫЕ ИСТОЧНИКИ",
-        "Приложение А"
-      ],
-      "snapshot_pages": [1, 2, 5, 6]
-    },
-    {
-      "id": "report-stress",
-      "entry": ".template/development/tests/fixtures/report-stress/main.typ",
-      "expected_pages": 12,
-      "expected_page_size": "A4",
-      "required_text": [
-        "Таблицы, списки, формулы и грамматические ссылки",
-        "1. Основной пункт",
-        "а) Второй уровень",
-        "1) Третий уровень",
-        "на Рисунках 2.1 и 2.2",
-        "контрольная спецификация",
-        "Продолжение таблицы 3.1",
-        "Ссылка на Таблицу 3.1",
-        "Продолжение высокой таблицы 5.1",
-        "Строка высокой ячейки 65."
-      ],
-      "required_text_counts": {
-        "Контрольные данные": 6,
-        "Продолжение таблицы 3.1": 5,
-        "Высокая ячейка": 3,
-        "Продолжение высокой таблицы 5.1": 2
-      },
-      "minimum_external_links": 2,
-      "minimum_internal_links": 8,
-      "snapshot_pages": [3, 4, 5, 9, 10, 11, 12]
-    },
-    {
-      "id": "reference-cases",
-      "entry": ".template/development/tests/fixtures/reference-cases/main.typ",
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": [
-        "Предложный по умолчанию: на Рисунке",
-        "Именительный коротко: Рисунок",
-        "Родительный коротко: без Рисунка",
-        "Дательный коротко: к Рисунку",
-        "Винительный коротко: вижу Рисунок",
-        "Творительный коротко: перед Рисунком",
-        "Предложный коротко: на Рисунке",
-        "Явная строчная форма: на рисунке",
-        "Полное название: на Таблице",
-        "Формула: согласно Формуле",
-        "Раздел: в Разделе",
-        "Группа по умолчанию: на Рисунках"
-      ],
-      "snapshot_pages": []
-    },
-    {
-      "id": "letter",
-      "entry": ".template/development/tests/fixtures/letter/main.typ",
-      "expected_pages": 2,
-      "expected_page_size": "A4",
-      "required_text": [
-        "О НАПРАВЛЕНИИ МАТЕРИАЛОВ",
-        "Приложение 1: Краткая спецификация",
-        "КРАТКАЯ СПЕЦИФИКАЦИЯ"
-      ],
-      "snapshot_pages": [1, 2]
-    },
-    {
-      "id": "commercial-offer",
-      "entry": ".template/development/tests/fixtures/commercial-offer/main.typ",
-      "expected_pages": 2,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ТЕХНИКО-КОММЕРЧЕСКОЕ ПРЕДЛОЖЕНИЕ",
-        "1 250 000 руб.",
-        "ТЕХНИЧЕСКОЕ ЗАДАНИЕ"
-      ],
-      "snapshot_pages": [1, 2]
-    },
-    {
-      "id": "contract",
-      "entry": ".template/development/tests/fixtures/contract/main.typ",
-      "expected_pages": 3,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ДОГОВОР ОКАЗАНИЯ УСЛУГ",
-        "РЕКВИЗИТЫ И ПОДПИСИ СТОРОН",
-        "СПЕЦИФИКАЦИЯ"
-      ],
-      "snapshot_pages": [1, 2, 3]
-    },
-    {
-      "id": "root-report",
-      "entry": "main.typ",
-      "expected_pages": 0,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ГЕОМЕХАНИЧЕСКОЕ ОБОСНОВАНИЕ УСТОЙЧИВОСТИ БОРТОВ",
-        "СПИСОК ИСПОЛНИТЕЛЕЙ",
-        "Результаты проверочных расчётов",
-        "СПИСОК ИСПОЛЬЗОВАННЫХ ИСТОЧНИКОВ",
-        "Приложение А. Исходные данные"
-      ],
-      "snapshot_pages": []
-    },
-    {
-      "id": "public-report",
-      "entry": "docs/examples/documents/report/main.typ",
-      "expected_pages": 0,
-      "expected_page_size": "A4",
-      "required_text": ["Результаты проверочных расчётов", "СПИСОК ИСПОЛЬЗОВАННЫХ ИСТОЧНИКОВ"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "public-letter",
-      "entry": "docs/examples/documents/letter/main.typ",
-      "expected_pages": 0,
-      "expected_page_size": "A4",
-      "required_text": ["О НАПРАВЛЕНИИ МАТЕРИАЛОВ ЭТАПА 1", "Уважаемый Иван Иванович"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "public-commercial-offer",
-      "entry": "docs/examples/documents/commercial-offer/main.typ",
-      "expected_pages": 0,
-      "expected_page_size": "A4",
-      "required_text": ["Геомеханическое сопровождение горных работ", "Состав и результат работ", "ТЕХНИЧЕСКОЕ ЗАДАНИЕ"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "public-contract",
-      "entry": "docs/examples/documents/contract/main.typ",
-      "expected_pages": 0,
-      "expected_page_size": "A4",
-      "required_text": ["ДОГОВОР ОКАЗАНИЯ УСЛУГ", "ОТВЕТСТВЕННОСТЬ СТОРОН", "ТЕХНИЧЕСКОЕ ЗАДАНИЕ"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "report-draft",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "report", "mode": "draft"},
-      "expected_pages": 3,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме draft"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "report-clean-copy",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "report", "mode": "clean-copy"},
-      "expected_pages": 3,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме clean-copy"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "letter-draft",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "letter", "mode": "draft"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме draft"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "letter-clean-copy",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "letter", "mode": "clean-copy"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме clean-copy"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "commercial-offer-draft",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "commercial-offer", "mode": "draft"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме draft"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "commercial-offer-clean-copy",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "commercial-offer", "mode": "clean-copy"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме clean-copy"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "contract-draft",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "contract", "mode": "draft"},
-      "expected_pages": 2,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме draft"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "contract-clean-copy",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "inputs": {"profile": "contract", "mode": "clean-copy"},
-      "expected_pages": 2,
-      "expected_page_size": "A4",
-      "required_text": ["Документ собран в режиме clean-copy"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "no-media-placeholder",
-      "entry": ".template/development/tests/fixtures/no-media/main.typ",
-      "inputs": {"policy": "placeholder"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["политикой placeholder"],
-      "snapshot_pages": [1]
-    },
-    {
-      "id": "no-media-hide",
-      "entry": ".template/development/tests/fixtures/no-media/main.typ",
-      "inputs": {"policy": "hide"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["политикой hide"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "no-media-reserve-space",
-      "entry": ".template/development/tests/fixtures/no-media/main.typ",
-      "inputs": {"policy": "reserve-space"},
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": ["политикой reserve-space"],
-      "snapshot_pages": []
-    },
-    {
-      "id": "report-baseline",
-      "entry": ".template/development/tests/fixtures/report-baseline/main.typ",
-      "expected_pages": 7,
-      "expected_page_size": "A4",
-      "required_text": [
-        "ТЕСТОВЫЙ ОТЧЁТ",
-        "СПИСОК ИСПОЛНИТЕЛЕЙ",
-        "СОДЕРЖАНИЕ",
-        "Сложные элементы должны сохранять",
-        "ТЕСТОВОЕ ПРИЛОЖЕНИЕ"
-      ],
-      "snapshot_pages": [1, 2, 3, 4]
-    },
-    {
-      "id": "list-counters",
-      "entry": ".template/development/tests/fixtures/list-counters/main.typ",
-      "expected_pages": 1,
-      "expected_page_size": "A4",
-      "required_text": [
-        "1. Арабские: первый",
-        "2. Арабские: второй",
-        "3. Арабские: третий",
-        "А. Кириллица верхняя: первый",
-        "Б. Кириллица верхняя: второй",
-        "В. Кириллица верхняя: третий",
-        "а. Кириллица нижняя: первый",
-        "б. Кириллица нижняя: второй",
-        "в. Кириллица нижняя: третий",
-        "A. Латиница верхняя: первый",
-        "B. Латиница верхняя: второй",
-        "C. Латиница верхняя: третий",
-        "a. Латиница нижняя: первый",
-        "b. Латиница нижняя: второй",
-        "c. Латиница нижняя: третий",
-        "01. Ведущий ноль: первый",
-        "02. Ведущий ноль: второй",
-        "03. Ведущий ноль: третий",
-        "1.а. Второй уровень: первый",
-        "1.б. Второй уровень: второй",
-        "1.б.A. Третий уровень: первый",
-        "1.б.B. Третий уровень: второй"
-      ],
-      "snapshot_pages": []
-    },
-    {
-      "id": "public-formatting-guide",
-      "entry": "docs/examples/formatting/main.typ",
-      "expected_pages": 0,
-      "expected_page_size": "A4",
-      "required_text": [
-        "РИСУНКИ",
-        "ТАБЛИЦЫ",
-        "Обычная встроенная таблица",
-        "Многострочная шапка и объединение ячеек",
-        "ФОРМУЛЫ",
-        "СПИСКИ И ТЕКСТ",
-        "Быстрая многоуровневая схема ГОСТ",
-        "Полная десятичная нумерация",
-        "Доступные типы счётчиков",
-        "Произвольные разделители",
-        "Маркеры вместо чисел",
-        "Геометрия и интервалы",
-        "Продолжение с нужного номера",
-        "1. Первый уровень.",
-        "а) Второй уровень.",
-        "1.1.1. Вложенный пункт.",
-        "II. Второй.",
-        "III. Третий.",
-        "ii. Второй.",
-        "iii. Третий.",
-        "B. Второй.",
-        "C. Третий.",
-        "b. Второй.",
-        "c. Третий.",
-        "02. Второй.",
-        "03. Третий.",
-        "Б. Второй.",
-        "В. Третий.",
-        "б. Второй.",
-        "в. Третий.",
-        "1.а)A. Третий уровень",
-        "A)1. Цифровой уровень.",
-        "§ 001: Пользовательский уровень",
-        "• Маркер •.",
-        "∙ Маркер ∙.",
-        "‣ Маркер ‣.",
-        "⁃ Маркер ⁃.",
-        "◦ Маркер ◦.",
-        "08. Восьмой пункт",
-        "09. Следующий пункт"
-      ],
-      "snapshot_pages": []
-    }
-  ],
-  "negative_fixtures": [
-    {
-      "id": "negative-letter",
-      "entry": ".template/development/tests/fixtures/negative-letter/main.typ",
-      "required_errors": ["Scientia / letter.recipient"]
-    },
-    {
-      "id": "negative-offer",
-      "entry": ".template/development/tests/fixtures/negative-offer/main.typ",
-      "required_errors": ["Scientia / commercial-offer.terms.amount"]
-    },
-    {
-      "id": "negative-contract",
-      "entry": ".template/development/tests/fixtures/negative-contract/main.typ",
-      "required_errors": ["Scientia / parties", "повторяющийся id"]
-    },
-    {
-      "id": "negative-company",
-      "entry": ".template/development/tests/fixtures/negative-company/main.typ",
-      "required_errors": ["Scientia / load-company.id", "неизвестная компания"]
-    },
-    {
-      "id": "negative-references",
-      "entry": ".template/development/tests/fixtures/negative-references/main.typ",
-      "required_errors": ["Scientia / vrefs", "ожидался label"]
-    },
-    {
-      "id": "negative-reference-case",
-      "entry": ".template/development/tests/fixtures/negative-reference-case/main.typ",
-      "required_errors": ["Scientia / reference", "неизвестный падеж"]
-    },
-    {
-      "id": "negative-list-scheme",
-      "entry": ".template/development/tests/fixtures/negative-list-scheme/main.typ",
-      "required_errors": ["Scientia / numbered-list.scheme", "неизвестная схема"]
-    }
-  ],
-  "compile_matrices": [
-    {
-      "id": "company-profile-matrix",
-      "entry": ".template/development/tests/fixtures/modes/main.typ",
-      "parameters": {
-        "company": ["scientia", "technology", "too", "test-company"],
-        "profile": ["report", "letter", "commercial-offer", "contract"],
-        "mode": ["final"]
-      }
-    }
-  ]
-}

.template/development/tests/run-tests.py

@@ -1,642 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import itertools
-import json
-import os
-import re
-import shutil
-import subprocess
-import sys
-import tempfile
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[3]
-TEST_ROOT = ROOT / ".template" / "development" / "tests"
-MANIFEST_PATH = TEST_ROOT / "manifest.json"
-SNAPSHOT_ROOT = TEST_ROOT / "snapshots"
-
-
-class TestFailure(RuntimeError):
-    pass
-
-
-def check_architecture() -> None:
-    """Проверяет направление зависимостей без запуска Typst renderer."""
-    template_root = ROOT / ".template" / "lib"
-    import_pattern = re.compile(r'#import\s+"([^"]+)"')
-    graph: dict[Path, set[Path]] = {}
-
-    for source in template_root.rglob("*.typ"):
-        graph[source.resolve()] = set()
-        text = source.read_text(encoding="utf-8")
-        source_area = source.relative_to(template_root).parts[0]
-        code_without_line_comments = re.sub(r"//.*", "", text)
-        if source_area == "domain":
-            forbidden_runtime = re.search(
-                r"(?:#(?:set|show)\b|\b(?:page|place|image|query|state)\s*\()",
-                code_without_line_comments,
-            )
-            if forbidden_runtime:
-                raise TestFailure(
-                    f"Domain-модуль {source.relative_to(ROOT)} содержит presentation/runtime вызов "
-                    f"{forbidden_runtime.group(0)!r}."
-                )
-        for raw_target in import_pattern.findall(text):
-            if raw_target.startswith("@"):
-                continue
-            target = (source.parent / raw_target).resolve()
-            try:
-                relative = target.relative_to(template_root.resolve())
-            except ValueError:
-                continue
-            if target.suffix == ".typ":
-                graph[source.resolve()].add(target)
-
-            target_area = relative.parts[0]
-            forbidden = {
-                "domain": {"application", "infrastructure", "presentation"},
-                "infrastructure": {"application", "presentation"},
-                "application": {"presentation"},
-            }.get(source_area, set())
-            if target_area in forbidden:
-                raise TestFailure(
-                    "Нарушена DDD-граница: "
-                    f"{source.relative_to(ROOT)} -> {target.relative_to(ROOT)}"
-                )
-
-        if re.search(r'#import\s+"[^\"]*(?:main\.typ|chapters/|assets/|\.private/)', text):
-            raise TestFailure(
-                f"Library-модуль {source.relative_to(ROOT)} импортирует пользовательский слой."
-            )
-
-    visiting: set[Path] = set()
-    visited: set[Path] = set()
-
-    def visit(node: Path, stack: list[Path]) -> None:
-        if node in visiting:
-            cycle = stack[stack.index(node):] + [node]
-            rendered = " -> ".join(str(item.relative_to(ROOT)) for item in cycle)
-            raise TestFailure(f"Циклические Typst-импорты: {rendered}")
-        if node in visited:
-            return
-        visiting.add(node)
-        stack.append(node)
-        for target in graph.get(node, set()):
-            if target in graph:
-                visit(target, stack)
-        stack.pop()
-        visiting.remove(node)
-        visited.add(node)
-
-    for node in graph:
-        visit(node, [])
-
-
-def check_workspace() -> None:
-    """Проверяет минимальный корень и синхронизируемую конфигурацию VS Code."""
-    allowed_directories = {
-        ".git",
-        ".private",
-        ".template",
-        ".vscode",
-        "assets",
-        "chapters",
-        "docs",
-    }
-    actual_directories = {item.name for item in ROOT.iterdir() if item.is_dir()}
-    unexpected = actual_directories - allowed_directories
-    if unexpected:
-        raise TestFailure(
-            "В корне обнаружены лишние каталоги: " + ", ".join(sorted(unexpected))
-        )
-
-    required_files = {
-        ".gitignore",
-        "README.md",
-        "main.typ",
-    }
-    missing_files = {name for name in required_files if not (ROOT / name).is_file()}
-    if missing_files:
-        raise TestFailure(
-            "В корне отсутствуют обязательные файлы: " + ", ".join(sorted(missing_files))
-        )
-
-    extensions_path = ROOT / ".vscode" / "extensions.json"
-    settings_path = ROOT / ".vscode" / "settings.json"
-    extensions = json.loads(extensions_path.read_text(encoding="utf-8"))
-    recommendations = set(extensions.get("recommendations", []))
-    required_extensions = {
-        "alefragnani.bookmarks",
-        "streetsidesoftware.code-spell-checker",
-        "streetsidesoftware.code-spell-checker-russian",
-        "ms-ceintl.vscode-language-pack-ru",
-        "myriad-dreamin.tinymist",
-        "wayou.vscode-todo-highlight",
-        "gruntfuggly.todo-tree",
-        "mhutchie.git-graph",
-        "local.typst-typewriter",
-        "zotst.zotst",
-    }
-    missing_extensions = required_extensions - recommendations
-    if missing_extensions:
-        raise TestFailure(
-            "В extensions.json отсутствуют рекомендации: "
-            + ", ".join(sorted(missing_extensions))
-        )
-
-    settings = json.loads(settings_path.read_text(encoding="utf-8"))
-    if settings.get("files.autoSave") != "afterDelay":
-        raise TestFailure("Workspace должен включать files.autoSave=afterDelay.")
-    if settings.get("files.exclude", {}).get(".template") is not True:
-        raise TestFailure(".template должен быть скрыт в пользовательском Explorer VS Code.")
-    if settings.get("files.exclude", {}).get(".vscode") is not True:
-        raise TestFailure(".vscode должен быть скрыт в пользовательском Explorer VS Code.")
-    if settings.get("files.exclude", {}).get("docs") is True:
-        raise TestFailure("Публичная документация docs/ не должна быть скрыта.")
-    if settings.get("typstTypewriter.navigator.mainFiles") != ["main.typ"]:
-        raise TestFailure("Typewriter должен показывать единственный main.typ.")
-
-    gitignore = (ROOT / ".gitignore").read_text(encoding="utf-8")
-    if ".private/" not in gitignore:
-        raise TestFailure("В .gitignore отсутствует защита каталога .private/.")
-    if ".vscode/" in gitignore:
-        raise TestFailure(".vscode должен синхронизироваться через Git.")
-
-    private_example = ROOT / "docs" / "examples" / "private" / "settings.typ"
-    if not private_example.is_file():
-        raise TestFailure("Отсутствует безопасный пример .private/settings.typ.")
-    private_example_text = private_example.read_text(encoding="utf-8")
-    for employee_id in (
-        "musikhin", "guzeev", "fedorov", "ilyasov", "khimichev",
-        "brusnicin", "ozornin", "buhartdinov", "tkachenko",
-    ):
-        if f"{employee_id}:" not in private_example_text:
-            raise TestFailure(
-                f"В примере private settings отсутствует сотрудник {employee_id}."
-            )
-
-    tasks = json.loads((ROOT / ".vscode" / "tasks.json").read_text(encoding="utf-8"))
-    task_labels = {task.get("label") for task in tasks.get("tasks", [])}
-    if "Scientia: собрать PDF с приватными данными" in task_labels:
-        raise TestFailure("Отдельная private build task больше не должна использоваться.")
-    if (ROOT / ".template" / "development" / "tools" / "build-with-private-assets.ps1").exists():
-        raise TestFailure("Устаревший ZIP installer должен быть удалён.")
-
-    for company_id in ("scientia", "technology", "too"):
-        company_path = ROOT / ".template" / "companies" / company_id / "data.json"
-        company = json.loads(company_path.read_text(encoding="utf-8"))
-        if company.get("sign_image") is not None or company.get("stamp_image") is not None:
-            raise TestFailure(
-                f"Публичный профиль {company_id} не должен содержать подпись или печать."
-            )
-
-    public_docs = (
-        "README.md",
-        "documents.md",
-        "formatting.md",
-        "vscode.md",
-        "git.md",
-        "private-assets.md",
-        "writing-style.md",
-        "troubleshooting.md",
-    )
-    for name in public_docs:
-        if not (ROOT / "docs" / name).is_file():
-            raise TestFailure(f"Публичная документация неполна: docs/{name}.")
-
-    for starter in ("report", "letter", "commercial-offer", "contract"):
-        starter_root = ROOT / "docs" / "examples" / "documents" / starter
-        if not (starter_root / "main.typ").is_file() or not (starter_root / "chapters").is_dir():
-            raise TestFailure(f"Публичный пример {starter} неполон.")
-
-    for obsolete in ("document.typ", "draft.typ", "clean-copy.typ"):
-        if (ROOT / obsolete).exists():
-            raise TestFailure(f"Лишняя точка входа в корне: {obsolete}.")
-
-
-def run(command: list[str], *, cwd: Path = ROOT) -> str:
-    result = subprocess.run(
-        command,
-        cwd=cwd,
-        text=True,
-        encoding="utf-8",
-        errors="replace",
-        stdout=subprocess.PIPE,
-        stderr=subprocess.STDOUT,
-    )
-    if result.returncode != 0:
-        rendered = subprocess.list2cmdline(command)
-        raise TestFailure(f"Команда завершилась с кодом {result.returncode}:\n{rendered}\n{result.stdout}")
-    return result.stdout
-
-
-def find_executable(
-    name: str,
-    *,
-    env_var: str | None = None,
-    required: bool = True,
-) -> Path | None:
-    if env_var and os.environ.get(env_var):
-        candidate = Path(os.environ[env_var])
-        if candidate.is_file():
-            return candidate
-
-    located = shutil.which(name)
-    if located:
-        return Path(located)
-
-    executable = name + (".exe" if os.name == "nt" else "")
-    candidates: list[Path] = []
-
-    poppler_bin = os.environ.get("POPPLER_BIN")
-    if poppler_bin:
-        candidates.append(Path(poppler_bin) / executable)
-
-    if os.name == "nt":
-        candidates.append(
-            Path.home()
-            / ".cache"
-            / "codex-runtimes"
-            / "codex-primary-runtime"
-            / "dependencies"
-            / "native"
-            / "poppler"
-            / "Library"
-            / "bin"
-            / executable
-        )
-
-    for candidate in candidates:
-        if candidate.is_file():
-            return candidate
-
-    if required:
-        raise TestFailure(
-            f"Не найден исполняемый файл {name}. Добавьте его в PATH"
-            + (f" или задайте {env_var}" if env_var else "")
-            + ("/POPPLER_BIN." if name.startswith("pdf") else ".")
-        )
-    return None
-
-
-def parse_version(value: str) -> tuple[int, ...]:
-    match = re.search(r"(\d+)\.(\d+)\.(\d+)", value)
-    if not match:
-        raise TestFailure(f"Не удалось определить версию из строки: {value!r}")
-    return tuple(int(part) for part in match.groups())
-
-
-def load_manifest() -> dict:
-    return json.loads(MANIFEST_PATH.read_text(encoding="utf-8"))
-
-
-def compile_fixture(
-    typst: Path,
-    entry: Path,
-    output: Path,
-    creation_timestamp: int,
-    inputs: dict[str, str] | None = None,
-) -> str:
-    command = [
-        str(typst),
-        "compile",
-        "--root",
-        str(ROOT),
-        "--creation-timestamp",
-        str(creation_timestamp),
-    ]
-    for key, value in sorted((inputs or {}).items()):
-        command.extend(("--input", f"{key}={value}"))
-    command.extend((str(entry), str(output)))
-    return run(command)
-
-
-def compile_expected_failure(
-    typst: Path,
-    entry: Path,
-    output: Path,
-    creation_timestamp: int,
-    required_errors: list[str],
-    inputs: dict[str, str] | None = None,
-) -> None:
-    command = [
-        str(typst),
-        "compile",
-        "--root",
-        str(ROOT),
-        "--creation-timestamp",
-        str(creation_timestamp),
-    ]
-    for key, value in sorted((inputs or {}).items()):
-        command.extend(("--input", f"{key}={value}"))
-    command.extend((str(entry), str(output)))
-    result = subprocess.run(
-        command,
-        cwd=ROOT,
-        text=True,
-        encoding="utf-8",
-        errors="replace",
-        stdout=subprocess.PIPE,
-        stderr=subprocess.STDOUT,
-    )
-    if result.returncode == 0:
-        raise TestFailure(f"{entry.relative_to(ROOT)}: ожидалась ошибка компиляции.")
-    for marker in required_errors:
-        if marker not in result.stdout:
-            raise TestFailure(
-                f"{entry.relative_to(ROOT)}: в diagnostic не найден маркер {marker!r}.\n"
-                f"Фактический вывод:\n{result.stdout}"
-            )
-
-
-def run_unit_test(typst: Path, module: str, creation_timestamp: int) -> None:
-    expression = f'import "/{module.replace(os.sep, "/")}": run; run()'
-    output = run(
-        [
-            str(typst),
-            "eval",
-            "--root",
-            str(ROOT),
-            "--creation-timestamp",
-            str(creation_timestamp),
-            expression,
-        ]
-    ).strip()
-    if json.loads(output) != "ok":
-        raise TestFailure(f"Unit-модуль {module} вернул неожиданное значение: {output}")
-
-
-def inspect_pdf(pdfinfo: Path, pdf: Path) -> tuple[int, str]:
-    info = run([str(pdfinfo), str(pdf)])
-    pages_match = re.search(r"^Pages:\s+(\d+)$", info, flags=re.MULTILINE)
-    size_match = re.search(r"^Page size:.*\(([^)]+)\)$", info, flags=re.MULTILINE)
-    if not pages_match or not size_match:
-        raise TestFailure(f"Не удалось разобрать pdfinfo для {pdf}:\n{info}")
-    return int(pages_match.group(1)), size_match.group(1).strip()
-
-
-def extract_text(pdftotext: Path | None, pdf: Path, target: Path) -> str:
-    if pdftotext:
-        run([str(pdftotext), "-layout", str(pdf), str(target)])
-        return target.read_text(encoding="utf-8", errors="replace")
-
-    try:
-        from pypdf import PdfReader
-    except ImportError as exc:
-        raise TestFailure(
-            "Для проверки текста требуется pdftotext или Python-пакет pypdf."
-        ) from exc
-
-    reader = PdfReader(str(pdf))
-    return "\n".join((page.extract_text() or "") for page in reader.pages)
-
-
-def count_pdf_links(pdf: Path) -> tuple[int, int]:
-    try:
-        from pypdf import PdfReader
-    except ImportError as exc:
-        raise TestFailure("Для проверки PDF-ссылок требуется Python-пакет pypdf.") from exc
-
-    external = internal = 0
-    for page in PdfReader(str(pdf)).pages:
-        for raw_annotation in page.get("/Annots", ()):
-            annotation = raw_annotation.get_object()
-            if annotation.get("/Subtype") != "/Link":
-                continue
-            action = annotation.get("/A")
-            if action is not None and action.get_object().get("/URI") is not None:
-                external += 1
-            else:
-                internal += 1
-    return external, internal
-
-
-def render_page(pdftoppm: Path, pdf: Path, page: int, dpi: int, target: Path) -> Path:
-    target.parent.mkdir(parents=True, exist_ok=True)
-    run(
-        [
-            str(pdftoppm),
-            "-png",
-            "-r",
-            str(dpi),
-            "-f",
-            str(page),
-            "-l",
-            str(page),
-            "-singlefile",
-            str(pdf),
-            str(target.with_suffix("")),
-        ]
-    )
-    return target
-
-
-def image_difference(expected: Path, actual: Path) -> float:
-    try:
-        from PIL import Image, ImageChops
-    except ImportError as exc:
-        raise TestFailure("Для visual regression требуется пакет Pillow.") from exc
-
-    with Image.open(expected).convert("RGB") as left, Image.open(actual).convert("RGB") as right:
-        if left.size != right.size:
-            return 1.0
-        diff = ImageChops.difference(left, right)
-        histogram = diff.histogram()
-        total = sum(value * (index % 256) for index, value in enumerate(histogram))
-        maximum = left.width * left.height * 3 * 255
-        return total / maximum
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Регрессионные тесты шаблона документов Scientia")
-    parser.add_argument("--fixture", action="append", help="Запустить только fixture с указанным id")
-    parser.add_argument("--compile-only", action="store_true", help="Не запускать PDF и visual проверки")
-    parser.add_argument(
-        "--update-snapshots",
-        action="store_true",
-        help="Явно обновить visual snapshots после ручного подтверждения",
-    )
-    args = parser.parse_args()
-
-    manifest = load_manifest()
-    typst = find_executable("typst", env_var="TYPST_BIN")
-    version_output = run([str(typst), "--version"]).strip()
-    if parse_version(version_output) < parse_version(manifest["typst_min"]):
-        raise TestFailure(
-            f"Требуется Typst {manifest['typst_min']}+, найден {version_output}."
-        )
-
-    pdfinfo = pdftotext = pdftoppm = None
-    if not args.compile_only:
-        pdfinfo = find_executable("pdfinfo")
-        pdftotext = find_executable("pdftotext", required=False)
-        pdftoppm = find_executable("pdftoppm")
-
-    creation_timestamp = int(manifest["creation_timestamp"])
-    selected = set(args.fixture or [])
-    known = {
-        item["id"]
-        for item in (
-            *manifest["fixtures"],
-            *manifest.get("negative_fixtures", []),
-            *manifest.get("compile_matrices", []),
-        )
-    }
-    unknown = selected - known
-    if unknown:
-        raise TestFailure(f"Неизвестные fixtures: {', '.join(sorted(unknown))}")
-
-    if not selected:
-        print("[static] architecture")
-        check_architecture()
-        print("[static] workspace")
-        check_workspace()
-
-    for unit in manifest.get("unit_tests", []):
-        if selected:
-            continue
-        print(f"[unit] {unit['id']}")
-        run_unit_test(typst, unit["module"], creation_timestamp)
-
-    temp_dir = Path(tempfile.mkdtemp(prefix="scientia-tests-"))
-    failed = False
-    try:
-        for matrix in manifest.get("compile_matrices", []):
-            if selected and matrix["id"] not in selected:
-                continue
-            keys = tuple(matrix["parameters"])
-            values = tuple(matrix["parameters"][key] for key in keys)
-            for combination in itertools.product(*values):
-                inputs = dict(zip(keys, combination))
-                suffix = ",".join(f"{key}={value}" for key, value in inputs.items())
-                print(f"[matrix] {matrix['id']}[{suffix}]")
-                safe_suffix = re.sub(r"[^A-Za-z0-9_.-]+", "-", suffix)
-                compile_fixture(
-                    typst,
-                    ROOT / matrix["entry"],
-                    temp_dir / f"{matrix['id']}-{safe_suffix}.pdf",
-                    creation_timestamp,
-                    inputs=inputs,
-                )
-
-        for fixture in manifest.get("negative_fixtures", []):
-            if selected and fixture["id"] not in selected:
-                continue
-            fixture_id = fixture["id"]
-            print(f"[negative] {fixture_id}")
-            compile_expected_failure(
-                typst,
-                ROOT / fixture["entry"],
-                temp_dir / f"{fixture_id}.pdf",
-                creation_timestamp,
-                fixture.get("required_errors", []),
-                inputs=fixture.get("inputs"),
-            )
-
-        for fixture in manifest["fixtures"]:
-            if selected and fixture["id"] not in selected:
-                continue
-
-            fixture_id = fixture["id"]
-            print(f"[compile] {fixture_id}")
-            entry = ROOT / fixture["entry"]
-            output = temp_dir / f"{fixture_id}.pdf"
-            compile_fixture(
-                typst,
-                entry,
-                output,
-                creation_timestamp,
-                inputs=fixture.get("inputs"),
-            )
-
-            if args.compile_only:
-                continue
-
-            assert pdfinfo and pdftoppm
-            pages, page_size = inspect_pdf(pdfinfo, output)
-            expected_pages = int(fixture["expected_pages"])
-            if expected_pages and pages != expected_pages:
-                raise TestFailure(
-                    f"{fixture_id}: ожидалось {expected_pages} страниц, получено {pages}."
-                )
-            if page_size != fixture["expected_page_size"]:
-                raise TestFailure(
-                    f"{fixture_id}: ожидался формат {fixture['expected_page_size']}, получен {page_size}."
-                )
-
-            text = extract_text(pdftotext, output, temp_dir / f"{fixture_id}.txt")
-            for marker in fixture.get("required_text", []):
-                if marker not in text:
-                    raise TestFailure(f"{fixture_id}: в PDF не найден текстовый маркер {marker!r}.")
-            for marker, minimum in fixture.get("required_text_counts", {}).items():
-                actual = text.count(marker)
-                if actual < int(minimum):
-                    raise TestFailure(
-                        f"{fixture_id}: маркер {marker!r} найден {actual} раз; "
-                        f"требуется не менее {minimum}."
-                    )
-            if "minimum_external_links" in fixture or "minimum_internal_links" in fixture:
-                external_links, internal_links = count_pdf_links(output)
-                minimum_external = int(fixture.get("minimum_external_links", 0))
-                minimum_internal = int(fixture.get("minimum_internal_links", 0))
-                if external_links < minimum_external:
-                    raise TestFailure(
-                        f"{fixture_id}: внешних PDF-ссылок {external_links}; "
-                        f"требуется не менее {minimum_external}."
-                    )
-                if internal_links < minimum_internal:
-                    raise TestFailure(
-                        f"{fixture_id}: внутренних PDF-ссылок {internal_links}; "
-                        f"требуется не менее {minimum_internal}."
-                    )
-
-            for page in fixture.get("snapshot_pages", []):
-                if page > pages:
-                    raise TestFailure(f"{fixture_id}: snapshot page {page} больше количества страниц {pages}.")
-                actual = render_page(
-                    pdftoppm,
-                    output,
-                    page,
-                    int(manifest["dpi"]),
-                    temp_dir / fixture_id / f"page-{page}.png",
-                )
-                expected = SNAPSHOT_ROOT / fixture_id / f"page-{page}.png"
-                if args.update_snapshots:
-                    expected.parent.mkdir(parents=True, exist_ok=True)
-                    shutil.copy2(actual, expected)
-                    print(f"[snapshot:update] {expected.relative_to(ROOT)}")
-                    continue
-                if not expected.is_file():
-                    raise TestFailure(
-                        f"Нет snapshot {expected.relative_to(ROOT)}. "
-                        "После ручной проверки запустите --update-snapshots."
-                    )
-                difference = image_difference(expected, actual)
-                threshold = float(fixture.get("visual_threshold", manifest["visual_threshold"]))
-                if difference > threshold:
-                    raise TestFailure(
-                        f"{fixture_id}, страница {page}: visual diff {difference:.6f} "
-                        f"превышает порог {threshold:.6f}. Фактический файл: {actual}"
-                    )
-                print(f"[snapshot:ok] {fixture_id}/page-{page} diff={difference:.6f}")
-
-        print(f"OK: {version_output}")
-        return 0
-    except Exception:
-        failed = True
-        raise
-    finally:
-        if failed:
-            print(f"Временные результаты сохранены: {temp_dir}", file=sys.stderr)
-        else:
-            shutil.rmtree(temp_dir, ignore_errors=True)
-
-
-if __name__ == "__main__":
-    try:
-        raise SystemExit(main())
-    except TestFailure as exc:
-        print(f"FAIL: {exc}", file=sys.stderr)
-        raise SystemExit(1)

.template/development/tools/use-starter.ps1

@@ -1,63 +0,0 @@
-param(
-    [Parameter(Mandatory = $true)]
-    [ValidateSet('report', 'letter', 'commercial-offer', 'contract')]
-    [string]$Name
-)
-
-$ErrorActionPreference = 'Stop'
-
-$workspaceRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..\..\..'))
-$starterRoot = [System.IO.Path]::GetFullPath(
-    (Join-Path $workspaceRoot "docs\examples\documents\$Name")
-)
-$mainTarget = [System.IO.Path]::GetFullPath((Join-Path $workspaceRoot 'main.typ'))
-$chaptersTarget = [System.IO.Path]::GetFullPath((Join-Path $workspaceRoot 'chapters'))
-$assetsTarget = [System.IO.Path]::GetFullPath((Join-Path $workspaceRoot 'assets'))
-
-foreach ($path in @($starterRoot, $mainTarget, $chaptersTarget, $assetsTarget)) {
-    if (-not $path.StartsWith(
-        $workspaceRoot + [System.IO.Path]::DirectorySeparatorChar,
-        [System.StringComparison]::OrdinalIgnoreCase
-    )) {
-        throw "Небезопасный путь за пределами проекта: $path"
-    }
-}
-
-if (-not (Test-Path -LiteralPath (Join-Path $starterRoot 'main.typ'))) {
-    throw "Не найден пример документа: $Name"
-}
-
-# Выбор типа разрешён даже при незакоммиченных изменениях: перед заменой
-# создаётся локальная резервная копия, которая не попадает в Git.
-$timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
-$backupRoot = [System.IO.Path]::GetFullPath(
-    (Join-Path $workspaceRoot ".private\starter-backups\$timestamp")
-)
-if (-not $backupRoot.StartsWith(
-    $workspaceRoot + [System.IO.Path]::DirectorySeparatorChar,
-    [System.StringComparison]::OrdinalIgnoreCase
-)) {
-    throw "Небезопасный путь резервной копии: $backupRoot"
-}
-New-Item -ItemType Directory -Path $backupRoot -Force | Out-Null
-
-if (Test-Path -LiteralPath $mainTarget) {
-    Copy-Item -LiteralPath $mainTarget -Destination (Join-Path $backupRoot 'main.typ')
-}
-if (Test-Path -LiteralPath $chaptersTarget) {
-    Copy-Item -LiteralPath $chaptersTarget -Destination (Join-Path $backupRoot 'chapters') -Recurse
-    Remove-Item -LiteralPath $chaptersTarget -Recurse -Force
-}
-
-Copy-Item -LiteralPath (Join-Path $starterRoot 'main.typ') -Destination $mainTarget -Force
-Copy-Item -LiteralPath (Join-Path $starterRoot 'chapters') -Destination $chaptersTarget -Recurse
-
-$starterAssets = Join-Path $starterRoot 'assets'
-if (Test-Path -LiteralPath $starterAssets) {
-    New-Item -ItemType Directory -Path $assetsTarget -Force | Out-Null
-    Copy-Item -Path (Join-Path $starterAssets '*') -Destination $assetsTarget -Recurse -Force
-}
-
-Write-Host "Установлен тип документа '$Name'."
-Write-Host "Предыдущие main.typ и chapters/ сохранены в $backupRoot"
-Write-Host 'Откройте main.typ и последовательно проверьте параметры.'

.template/development/vscode/README.md

@@ -1,7 +0,0 @@
-# VS Code для сопровождающего шаблона
-
-Корневые `.vscode/extensions.json`, `.vscode/settings.json` и `.vscode/tasks.json` намеренно синхронизируются через Git: это часть пользовательского опыта шаблона.
-
-`local.typst-typewriter` и `zotst.zotst` обнаружены как локально установленные расширения. Рекомендация в `extensions.json` сообщает VS Code их идентификаторы, но не распространяет сам пакет. Для нового компьютера соответствующий `.vsix` нужно получить из внутреннего хранилища и выполнить команду **Extensions: Install from VSIX**.
-
-Если принято решение хранить внутренние `.vsix` рядом с шаблоном, размещайте их в `packages/` этого каталога и добавляйте только после проверки лицензии и отсутствия секретов.

.template/development/vscode/packages/README.md

@@ -1,8 +0,0 @@
-# Внутренние VSIX-пакеты
-
-Здесь могут храниться проверенные установочные пакеты локальных расширений:
-
-- `local.typst-typewriter`;
-- `zotst.zotst`.
-
-Перед добавлением `.vsix` проверьте лицензию, состав архива и отсутствие секретов. Само наличие extension ID в `.vscode/extensions.json` не распространяет локальное расширение.

.template/lib/company.typ

@@ -1,23 +1,20 @@
 // ==========================================
 // ДАННЫЕ КОМПАНИИ И ДЕФОЛТЫ ШАБЛОНА
 // ==========================================
-#let load-company-data(company-id: "too") = {
+#let load-company-data(company-id: "scientia") = {
   json("../companies/" + company-id + "/data.json")
 }
 
-#let company-defaults(company-id: "too") = {
+#let company-defaults(company-id: "scientia") = {
   let data = load-company-data(company-id: company-id)
-  let company-name = data.at("name", default: "ООО «Скиентия»")
-  let director-title = data.at("director-title", default: "Директор")
+  let company-name = data.at("name", default: "")
+  let director-title = data.at("director-title", default: "")
 
   (
-    company_info: data.at(
-      "company_info",
-      default: "ООО «Скиентия» ИНН 6686148633\nул. Шейнкмана, стр. 9, офис 65\nг. Екатеринбург, 620014, Россия\n+7 (922) 203-24-60 ☏\ninfo@scientia.ru 🖂",
-    ),
+    company_info: data.at("company_info", default: ""),
     director_company: director-title + " " + company-name,
-    director_name: data.at("director-name", default: "Мусихин А.С."),
-    city: data.at("city", default: "Екатеринбург"),
+    director_name: data.at("director-name", default: ""),
+    city: data.at("city", default: ""),
     sign_image: data.at("sign_image", default: none),
     stamp_image: data.at("stamp_image", default: none),
   )

.template/lib/infrastructure/employees.typ

@@ -8,101 +8,11 @@
 #import "../domain/document.typ": fail
 
 #let employee-directory = (
-  musikhin: (
-    name: "Мусихин А.С.",
-    default-role: "Ответственный исполнитель",
-    signature-file: "Musikhin.png",
-  ),
-  guzeev: (
-    name: "Гузеев И.А.",
-    default-role: "Главный геомеханик",
-    signature-file: "Guzeev.png",
-  ),
-  fedorov: (
-    name: "Федоров Д.А.",
-    default-role: "Инженер-геомеханик",
-    signature-file: "Fedorov.png",
-  ),
-  ilyasov: (
-    name: "Ильясов Б.Т.",
-    default-role: "Технический директор, к.т.н.",
-    signature-file: "Ilyasov.png",
-  ),
-  khimichev: (
-    name: "Химичев С.С.",
-    default-role: "Инженер-геомеханик",
-    signature-file: "Khimichev.png",
-  ),
-  brusnicin: (
-    name: "Брусницын И.В.",
-    default-role: "Инженер-геомеханик",
-    signature-file: "Brusnicin.png",
-  ),
-  ozornin: (
-    name: "Озорнин Д.А.",
-    default-role: "Геолог",
-    signature-file: "Ozornin.png",
-  ),
-  buhartdinov: (
-    name: "Бухартдинов А.С.",
-    default-role: "Главный маркшейдер",
-    signature-file: "Buhartdinov.png",
-  ),
   tkachenko: (
     name: "Ткаченко А.С.",
-    default-role: "Инженер-геомеханик",
+    default-role: "Автор",
     signature-file: "Tkachenko.png",
   ),
-  moshin: (
-    name: "Мошин В.Е.",
-    default-role: "Гидрогеолог",
-    signature-file: "Moshin.png",
-  ),
-  mitrokhin: (
-    name: "Митрохин В.А.",
-    default-role: "Главный гидрогеолог",
-    signature-file: "Mitrokhin.png",
-  ),
-  luzina: (
-    name: "Лузина М.В.",
-    default-role: "Геолог",
-    signature-file: "Luzina.png",
-  ),
-  balandin: (
-    name: "Баландин А.",
-    default-role: "Геолог",
-    signature-file: "Balandin.png",
-  ),
-  baigali: (
-    name: "Байгали Р.К.",
-    default-role: "Инженер-геомеханик",
-    signature-file: "Baigali.png",
-  ),
-  sugatov: (
-    name: "Сугатов Н.С.",
-    default-role: "Инженер-геомеханик",
-    signature-file: "Sugatov.png",
-  ),
-  soluyanov: (
-    name: "Солуянов Н.О.",
-    default-role: "Ведущий геомеханик",
-    signature-file: "Soluyanov.png",
-  ),
-  ecenkov: (
-    name: "ЛЕценков И.А.",
-    default-role: "Инженер-геомеханик",
-    signature-file: "Ecenkov.png",
-  ),
-  savin: (
-    name: "Савин Д.А.",
-    default-role: "Делопроизводитель",
-    signature-file: "Savin.png",
-  ),
-  trescov: (
-    name: "Тресцов Н.Н.",
-    default-role: "Геолог",
-    signature-file: "Trescov.png",
-  ),
 )
 
 #let empty-private-settings = (

.template/lib/presentation/profiles/report.typ

@@ -98,7 +98,13 @@
 #let render-report(body, ctx) = {
   let company = ctx.company
   let data = ctx.metadata
-  let mode = if ctx.options.mode == "final" { "default" } else { "draft" }
+  let mode = if ctx.options.mode == "final" {
+    "default"
+  } else if ctx.options.mode == "clean-copy" {
+    "paper"
+  } else {
+    "draft"
+  }
   let watermark = if ctx.options.mode == "draft" and ctx.options.watermark == none {
     "DRAFT"
   } else {

.template/lib/report.typ

@@ -6,11 +6,11 @@
 #let report(
   // ВАЖНО: позиционный аргумент (body) всегда должен идти ПЕРВЫМ
   body,
-  company_info: "ООО «Скиентия» ИНН 6686148633\nул. Шейнкмана, стр. 9, офис 65\nг. Екатеринбург, 620014, Россия\n+7 (922) 203-24-60 ☏\ninfo@scientia.ru 🖂",
+  company_info: "",
   udk: "622.023; 622.271",
-  director_company: "Директор ООО «Скиентия»",
-  director_name: "Мусихин А.С.",
-  director_date: "«23» августа 2025 г.",
+  director_company: "",
+  director_name: "",
+  director_date: "",
   sign_image: none,
   stamp_image: none,
   logo_image: path("../companies/logo.svg"),
@@ -45,6 +45,8 @@
   }
   let mode = if report_mode == "draft" or report_mode == "paper" { report_mode } else { "default" }
   let with-title-page = mode != "paper"
+  // Личный проект: содержание выводится и без фирменного титульного листа.
+  let with-toc = true
   let with-signs-and-stamps = mode == "default"
   let has-watermark = watermark != none
   let watermark-mark = (dx, dy) => place(center + horizon, dx: dx, dy: dy)[
@@ -408,7 +410,7 @@
   // ==========================================
   // 3. СОДЕРЖАНИЕ
   // ==========================================
-  if with-title-page {
+  if with-toc {
     service-title([СОДЕРЖАНИЕ])
 
     // Настройка внешнего вида содержания под стандарт

.vscode/tasks.json

@@ -2,7 +2,7 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "Scientia: собрать PDF",
+      "label": "Собрать PDF",
       "type": "process",
       "command": "typst",
       "args": ["compile", "--root", ".", "main.typ", "document.pdf"],
@@ -11,61 +11,6 @@
         "isDefault": true
       },
       "problemMatcher": []
-    },
-    {
-      "label": "Scientia: выбрать тип документа",
-      "type": "process",
-      "command": "powershell",
-      "args": [
-        "-NoProfile",
-        "-ExecutionPolicy",
-        "Bypass",
-        "-File",
-        ".template/development/tools/use-starter.ps1",
-        "-Name",
-        "${input:documentType}"
-      ],
-      "problemMatcher": []
-    },
-    {
-      "label": "Scientia: собрать учебный пример",
-      "type": "process",
-      "command": "typst",
-      "args": [
-        "compile",
-        "--root",
-        ".",
-        "${input:exampleEntry}",
-        "example.pdf"
-      ],
-      "problemMatcher": []
-    }
-  ],
-  "inputs": [
-    {
-      "id": "documentType",
-      "type": "pickString",
-      "description": "Выберите тип документа",
-      "options": [
-        "report",
-        "letter",
-        "commercial-offer",
-        "contract"
-      ],
-      "default": "report"
-    },
-    {
-      "id": "exampleEntry",
-      "type": "pickString",
-      "description": "Выберите компилируемый пример",
-      "options": [
-        "docs/examples/documents/report/main.typ",
-        "docs/examples/documents/letter/main.typ",
-        "docs/examples/documents/commercial-offer/main.typ",
-        "docs/examples/documents/contract/main.typ",
-        "docs/examples/formatting/main.typ"
-      ],
-      "default": "docs/examples/formatting/main.typ"
     }
   ]
 }

.zcode/plans/plan-sess_5340181a-04ed-4af9-a60a-a9cbd1445b6a.md

@@ -1,44 +0,0 @@
-Актуализировать таблицы КЗУ и выводы под числа в тексте анализа (источник истины — текст глав). Изменённые числа: разрез №9 контур 2026 — КЗУ 4,03 → 4,35; разрез №7 контур 2033 — КЗУ 1,26 → 3,69.
-
-## 1. CSV-таблицы
-
-- `assets/tables/kzu_2026.csv`, строка 12: `;400–579 (борт в целом);4,03` → `4,35` (в тексте: «Общий КЗУ борта составляет 4,35»).
-- `assets/tables/kzu_2033.csv`, строка 10: `;390–684 (борт в целом);1,26` → `3,69` (в тексте: «Общий КЗУ борта составляет 3,69»).
-
-Формат CSV (разделитель `;`, пустая первая колонка для rowspan, en-dash) сохраняю.
-
-## 2. Вывод в `chapters/analysis/Pit-design-analysis-2033.typ` (строки 114–116)
-
-- «Наименьший запас устойчивости получен для разреза №7 (общий КЗУ борта 1,26).» → «…для разреза №1 (общий КЗУ борта 2,35).»
-- «Общие КЗУ бортов изменяются от 1,26 до 7,1. Общий КЗУ борта на разрезе №7 ниже нормативного значения 1,35, поэтому запас устойчивости этого участка не обеспечен. На остальных разрезах общие КЗУ бортов превышают нормативное значение.» → «Общие КЗУ бортов изменяются от 2,35 до 7,1 и превышают нормативное значение 1,35.» (параллельно конструкциям глав 2026 и 2031).
-
-Вывод в главе 2026 проверен — числа уже соответствуют тексту (мин №1 = 2,85, макс №2 = 5,9), правок по числам не требуется.
-
-## 3. Общее заключение `chapters/90-conclusion.typ` (строка 3 и 5)
-
-- Убрать «, кроме разреза №7 на проектный контур 2033 г.» (исключение больше не существует).
-- «на проектный контур 2033 г. -- от 1,26 до 7,1» → «от 2,35 до 7,1».
-- «Наименьший запас устойчивости получен для разреза №7 на проектный контур 2033 г. (общий КЗУ борта 1,26), поэтому для этого участка борта необходимы мониторинг состояния и меры по оптимизации.» → «Наименьший запас устойчивости получен для разреза №6 на проектный контур 2035 г. (общий КЗУ борта 1,85).» Минимумы по контурам: 2026 — 2,85; 2031 — 4,55; 2033 — 2,35; 2035 — 1,85. Хвост про мониторинг удаляется: он был обусловлен КЗУ ниже норматива, а рекомендации по мониторингу локальных участков остаются во 2-м абзаце.
-- «КЗУ неустойчивых локальных участков составляет 1--1,3…» → «…составляет 1…»: значения 1,3 в таблицах больше нет, все локальные КЗУ ниже норматива равны 1.
-
-## 4. Попутные дефекты текста (подтверждено пользователем)
-
-`Pit-design-analysis-2026.typ`:
-- стр. 40: восстановить оборванный хвост «…в действительности смещения» → «…в действительности смещения будут незначительными» (хвост удалён при правке по git-истории);
-- стр. 68: «На разрезе №8 борта сохраняет» → «борт сохраняет»;
-- стр. 85: «в последствии» → «впоследствии»;
-- стр. 143: «считаем что» → «считаем, что».
-
-`Pit-design-analysis-2033.typ`:
-- стр. 14: «По результатм» → «По результатам», «напряженно-деформированного» → «напряжённо-деформированного»;
-- стр. 61: «наблюдюдается» → «наблюдается», убрать лишнюю запятую перед скобкой («очистных выработок, (» → «очистных выработок (»).
-
-## 5. Проверка
-
-- Скомпилировать документ (`typst compile`) — убедиться, что CSV читаются и таблицы собираются.
-- Финальная сверка: каждая строка таблиц = числам «борт в целом» из текста; выводы глав и заключение без противоречий.
-
-## Не трогаю (сообщу в итоге)
-
-- Расхождение в главе 2026 №8: текст «тело обрушения при КСП=3,65» vs подпись рисунка «при КСП=3,88» — сводить не просили.
-- Остаточные файлы: `assets/26/26_9/26-9-4.64.jpg` (нигде не подключён), старые `26-9-4.23.jpg` и `33-7-2.2.png`; опечатка «выработок в и наличием» в нетронутой главе 2031.

.zcode/plans/plan-sess_a40a23d8-8d23-45bc-8549-18476d7ddd5b.md

@@ -1,84 +0,0 @@
-# Синхронизация сводных таблиц КЗУ и выводов с текстом анализа
-
-## Контекст
-
-Тексты анализа (chapters/analysis/Pit-design-analysis-*.typ) были переписаны 23–24.09 (коммиты «bul 23.09», «tkach 24.09», «bul 24.09»), а сводные CSV-таблицы и выводы обновлены лишь частично. Источник истины — текст анализа, как и просил. Доказательства из git:
-- 23.09: разрез №8 (2026) переписан — локальные разрушения 566–581/540–550/489–510 удалены из текста вместе с рисунком, общий КЗУ 3,55 → 3,6;
-- 23.09: в 2033 значения 2,35 → 2,36 (р-з 1) и 3,69 → 3,71 (р-з 7); в 2035 отметки вывала при КСП=3 исправлены 308–368 → 370–390, общий КЗУ р-за 2: 4,9 → 4,87;
-- 24.09: в 2035 общий КЗУ р-за 7: 2 → 2,05, р-за 9: 3 → 2,9;
-- 24.09 (tkach): в kzu_2031.csv значение 3,0 записано в строку «396–562 (борт в целом)» вместо локальной строки 530–562 (по смыслу замечания «2 р-з - 3,0»); в тексте общий КЗУ р-за 2 = 8,7.
-
-## 1. assets/tables/kzu_2026.csv
-
-Удалить три устаревшие строки разреза №8 (566–581;2,03 / 540–550;2,98 / 489–510;3,32 — этих событий больше нет в тексте) и обновить его общий КЗУ. Итог:
-
-```
-№ разреза;Интервал отм. борта, м;КЗУ
-1;400–649 (борт в целом);2,85
-2;398–429;1
-;400–539 (борт в целом);5,9
-5;430–442;1,76
-;400–526 (борт в целом);4,35
-8;375–586 (борт в целом);3,6
-9;454–490;1
-;400–579 (борт в целом);4,35
-```
-
-## 2. assets/tables/kzu_2031.csv
-
-```
-№ разреза;Интервал отм. борта, м;КЗУ
-1;400–560;4,23
-;401–657 (борт в целом);4,95
-2;400–423;1
-;530–562;3,0
-;396–562 (борт в целом);8,7
-4;370–386;4,98
-;361–511 (борт в целом);6,2
-```
-
-Изменения: 400–560: 4,6 → 4,23 («при КСП=4,23»); 530–562: 1,86 → 3,0 («при КСП>3»); борт в целом: 3,0 → 8,7 («принято значение 8,7»).
-
-## 3. assets/tables/kzu_2033.csv
-
-Два изменения: р-з 1 «борт в целом»: 2,35 → 2,36; р-з 7 «борт в целом»: 3,69 → 3,71. Остальное без изменений.
-
-## 4. assets/tables/kzu_2035.csv
-
-```
-№ разреза;Интервал отм. борта, м;КЗУ
-1;300–322;1
-;300–656 (борт в целом);2,96
-2;300–335;2,74
-;370–390;3
-;408–422;3,9
-;368–422;4
-;300–561 (борт в целом);4,87
-3;300–522 (борт в целом);3,6
-6;350–370;1
-;300–522 (борт в целом);1,85
-7;300–330;1
-;330–350;1,7
-;300–640 (борт в целом);2,05
-9;451–511;1
-;311–578 (борт в целом);2,9
-```
-
-Изменения: 300–335: 1 → 2,74 (текст привязывает эти отметки к КСП=2,74, событие при КСП=1 описано без отметок); 308–368 → 370–390 (текст исправлен 23.09, интервал согласуется с группой 368–422 при КСП=4); «борт в целом» р-за 2: 4,9 → 4,87; р-за 7: 2 → 2,05; р-за 9: 3 → 2,9. Тире в интервалах — длинное «–», как в исходниках.
-
-## 5. Выводы в конце анализа каждого контура
-
-- **Pit-design-analysis-2031.typ** (~стр. 112): «Общие КЗУ бортов изменяются от 4,55 до 8,7» → «от 4,95 до 8,7».
-- **Pit-design-analysis-2033.typ** (~стр. 118, 120): «(общий КЗУ борта 2,35)» → 2,36; «от 2,35 до 7,1» → «от 2,36 до 7,1».
-- **Pit-design-analysis-2035.typ** (~стр. 166, 168): «общий КЗУ борта составляет 4,9» → 4,87; «изменяются от 1,85 до 4,9» → «от 1,85 до 4,87».
-- **2026**: вывод уже соответствует тексту — без изменений.
-
-## 6. Связанные правки для согласованности отчёта
-
-- **chapters/90-conclusion.typ** (стр. 3): «от 4,55 до 8,7» → «от 4,95 до 8,7»; «от 2,35 до 7,1» → «от 2,36 до 7,1»; «от 1,85 до 4,9» → «от 1,85 до 4,87». Стр. 7: «разрушения возникают при КСП от 1,7 до 4» → «от 1,7 до 4,98» (новый максимум локальных участков — 4,98, разрез №4 в 2031; диапазон и сейчас не сходился с таблицами).
-- **Pit-design-analysis-2035.typ**, подпись рисунка 35-2-3 (~стр. 41): «в отметках 308--368 м» → «370--390 м» (в тексте 23.09 исправлено, подпись осталась старой).
-
-## Проверка
-
-1. `typst compile --root . main.typ document.pdf` — сборка без ошибок.
-2. Визуальная проверка четырёх сводных таблиц в PDF (группировка строк по разрезам через rowspan сохраняется — код в .typ читает CSV как есть).

.zcode/plans/plan-sess_f4be0258-d5a5-4e06-9dbf-cb675941b15b.md

@@ -1,24 +0,0 @@
-Stop programs from defaulting to "OneDrive - iicx": redirect Windows' Desktop/Documents/Pictures known folders back to C:\Users\xander\..., so "Save to Documents" lands locally again. The iicx folder itself stays untouched as a plain archive.
-
-## Why this happens
-"OneDrive folder backup" (Known Folder Move) has redirected your Desktop, Documents and Pictures to C:\Users\xander\OneDrive - iicx\... Programs resolve "Documents" through this system setting — that's why they keep choosing that folder.
-
-## Phase 1 — Verify what's redirected (me, read-only commands)
-1. Read HKCU\...\Explorer\User Shell Folders registry to confirm exactly which known folders point into OneDrive - iicx (and whether personal OneDrive redirected any too).
-2. Check OneDrive's enforced-policy state if readable.
-
-## Phase 2 — Turn the redirect off at the source (user GUI step, ~2 min)
-3. OneDrive tray icon → Settings → Sync and backup → Manage backup → turn OFF Desktop, Documents, Pictures (on the iicx account). Windows immediately restores the default locations (C:\Users\xander\Desktop, \Documents, \Pictures).
-   - If a toggle is greyed out or comes back ON by itself (org-enforced policy), fallback: I reset the User Shell Folders registry values to defaults directly and add the KFMBlockOptIn=1 policy key so the iicx tenant can't re-redirect them.
-4. Same check for the personal OneDrive account — per your "local only" choice, its backup toggles should be OFF too so programs don't just default to the personal OneDrive instead.
-
-## Phase 3 — Bring your current files back into view (me, commands)
-5. Merge the live content from OneDrive - iicx\Desktop|Documents|Pictures into the local folders (robocopy, newer files win, nothing deleted from the iicx folder).
-6. Verify with you: Desktop and Documents show your current files; a test save in any app lands in C:\Users\xander\Documents.
-
-## Phase 4 — Make sure it never comes back (me + user)
-7. Optional but recommended: in OneDrive Settings → Account, "Unlink this PC" for iicx, then I rename the folder to C:\Users\xander\iicx-archive. The iicx account itself stays in Windows (your Office license needs it) — if OneDrive ever recreates the sync, the KFMBlockOptIn policy from step 3 keeps your folders local.
-8. Note: a few programs remember their own "last saved location" — those will follow the new default on next use or after picking the local folder once.
-
-## Nothing is deleted at any point
-The iicx folder (and its cloud copy) keep everything; we only change where Windows points "Documents/Desktop/Pictures" and copy the live files back locally.

.zcode/skills/engineering-writing-ru/SKILL.md

@@ -1,48 +0,0 @@
----
-name: engineering-writing-ru
-description: >-
-  Создавай, перестраивай, редактируй и проверяй личные инженерные тексты автора: главы и подразделы НИР, геомеханические отчёты, экспертные заключения, технические письма, Telegram-обзоры и комментарии профессионального сообщества. Используй для диктовки, транскриптов, заметок, численных данных, источников и черновиков, когда нужно сохранить факты, терминологию, инженерную логику и границы выводов. Дополнительно поддерживай профессиональный LinkedIn на английском. Не используй для обхода детекторов или маскировки авторства.
----
-
-# Engineering Writing RU
-
-Работать только по личной политике владельца. Не выбирать профили других авторов и не объявлять результат корпоративным стандартом.
-
-## Определить маршрут
-
-Сначала установить:
-
-- операция: создать, отредактировать, пересоздать или проверить
-- граница требуемого артефакта
-- язык и жанр
-- форма выдачи: готовый текст, review, исследовательские варианты или плейсхолдеры
-
-Для любой генерации, редакции или проверки прочитать [общие правила](references/writing.md), один языковой файл и один жанр.
-
-| Артефакт | Язык | Жанр |
-|---|---|---|
-| Глава или подраздел НИР | [ru.md](references/languages/ru.md) | [engineering-report.md](references/genres/engineering-report.md) |
-| Экспертное заключение | [ru.md](references/languages/ru.md) | [expert-opinion.md](references/genres/expert-opinion.md) |
-| Ответ по правкам, применимости или техническому вопросу | [ru.md](references/languages/ru.md) | [business-email.md](references/genres/business-email.md) |
-| Telegram-обзор | [ru.md](references/languages/ru.md) | [telegram-post.md](references/genres/telegram-post.md) |
-| Комментарий профессионального сообщества | [ru.md](references/languages/ru.md) | [community-comment.md](references/genres/community-comment.md) |
-| LinkedIn на английском | [en.md](references/languages/en.md) | [linkedin-en.md](references/genres/linkedin-en.md) |
-
-Подключать дополнение только при соответствующей задаче:
-
-- [analysis-and-facts.md](references/tasks/analysis-and-facts.md) при новом выводе, расчёте, сопоставлении с критерием, проверке источника или существенного конфликта
-- [review.md](references/tasks/review.md) при результате только с замечаниями. Для фактического review также подключать анализ
-- [placeholders.md](references/tasks/placeholders.md) только по прямой просьбе о плейсхолдерах
-- [geomechanics-analysis.md](references/domains/geomechanics-analysis.md) вместе с анализом при новой геомеханической интерпретации, оценке устойчивости, безопасности или применимости, а также при фактической проверке таких выводов
-- [document-standards.md](references/domains/document-standards.md) при обязательной нормативной, договорной или корпоративной форме
-- [gate.md](references/terminology/gate.md) при переводе, конфликте вариантов или прямой проверке термина
-
-Для чистой языковой правки не читать analysis, domain и словари. Наличие геомеханических слов само по себе не является сигналом. При review всегда читать жанр проверяемого текста.
-
-Не открывать остальные references на всякий случай и не переходить по локальным ссылкам вне выбранного маршрута. Полный снимок Scientia и служебные терминологические данные в контекст не загружать. Для точечного поиска следовать `gate.md` и использовать только компактный результат.
-
-## Выполнить задачу
-
-Применить выбранные файлы как единый набор без повторного изложения их правил. Если данных недостаточно, действовать по политике вопросов и форме выдачи из общего файла.
-
-Не отправлять и не публиковать материал без отдельной явной просьбы.

.zcode/skills/engineering-writing-ru/agents/openai.yaml

@@ -1,7 +0,0 @@
-interface:
-  display_name: "Инженерные тексты RU"
-  short_description: "Русские инженерные тексты без потери фактов"
-  default_prompt: "Используй $engineering-writing-ru, чтобы подготовить или проверить инженерный текст по моим материалам без потери фактов и границ выводов."
-
-policy:
-  allow_implicit_invocation: true

.zcode/skills/engineering-writing-ru/references/domains/document-standards.md

@@ -1,22 +0,0 @@
-# Нормативные, договорные и корпоративные требования
-
-Подключать этот файл только при обязательной внешней форме документа. Профессиональный текст сам по себе не требует оформления как полный ГОСТ-документ.
-
-Применять требования в таком порядке:
-
-1. обязательные нормы права и безопасности
-2. договор, задание заказчика и корпоративные правила в допустимой части
-3. утверждённый шаблон конкретного документа
-4. рекомендательные положения стандартов
-5. жанровые решения skill
-
-Перед нормативным утверждением проверить актуальную редакцию, область применения и точный пункт, если он влияет на вывод. Название документа само по себе не доказывает обязательность требования.
-
-Если официальная редакция недоступна или проверка не входит в задачу, сохранить ссылку как предоставленную и не заявлять подтверждённое соответствие. Для отдельной главы НИР не добавлять элементы полного отчёта, если запрошен только текст подраздела.
-
-Опорные источники для проверки:
-
-- ГОСТ 7.32-2017, отчёт о НИР: <https://protect.gost.ru/gost/details/7d280e43-7036-4a69-8e6e-d15867028343>
-- ГОСТ Р 2.105-2019, текстовые документы ЕСКД: <https://protect.gost.ru/gost/details/0dd3cdfa-c15a-47b3-9e3b-4a90a43005c8>
-- ГОСТ Р 7.0.99-2018, реферат и аннотация: <https://protect.gost.ru/gost/details/40bb663f-0fdf-4566-bba0-7e7e99060757>
-- ГОСТ Р 7.0.97-2025, организационно-распорядительные документы: <https://protect.gost.ru/gost/details/360994e3-9a70-47b9-ab3a-cf21809e26ed>

.zcode/skills/engineering-writing-ru/references/domains/geomechanics-analysis.md

@@ -1,11 +0,0 @@
-# Геомеханический анализ
-
-Подключать вместе с анализом при новой геомеханической интерпретации и оценке применимости, устойчивости, безопасности или допустимости. Для языковой правки он не нужен.
-
-Различать образец, породный материал, массив горных пород, структурный элемент и расчётную модель. Не смешивать точку, профиль, участок, выработку, борт и месторождение, а также поверхностное наблюдение и глубинное состояние. Перенос свойства между масштабами требует явного основания.
-
-Результат моделирования сохраняет расчётный статус. Согласование расчёта и измерения может поддерживать интерпретацию в проверенном диапазоне, но само по себе не устанавливает механизм или точность вне него.
-
-В расчётном контексте различать исходный параметр, результат испытания, калибруемую величину и выход модели. Сохранять принятую систему единиц, координаты, знаковую конвенцию, геометрию, сценарий, версию, начальные и граничные условия.
-
-Чувствительность параметра не превращать в доказанный механизм. Вывод об устойчивости, безопасности, допустимости или соответствии связывать с конкретным объектом, сценарием и применённым критерием. Рекомендация дополнительно должна задавать действие и область применения.

.zcode/skills/engineering-writing-ru/references/genres/business-email.md

@@ -1,13 +0,0 @@
-# Техническое письмо
-
-Учитывать канал, роль и статус адресата, историю переписки и требуемое действие. Длинное письмо остаётся письмом, а не главой отчёта.
-
-Основной ответ или позицию давать достаточно рано. Краткий фон ставить раньше, если он задаёт нужную границу или без него ответ можно понять неверно. В подробном письме начальный абзац даёт позицию без просьбы, а единственное требуемое действие следует после основания. В коротком письме просьба может стоять сразу, тогда отдельный финал не нужен.
-
-Несколько вопросов разбирать по нумерации адресата или смысловым блокам. Один связный вопрос излагать прозой без формальной рубрикации. Позицию по каждому элементу раскрывать один раз. Не предварять разбор сводкой тех же статусов и не добавлять после него пересказ начальной позиции. Финальная просьба может ссылаться на разобранный подход как целое, но не перечисляет все его статусы. Отдельный итог нужен, только если он добавляет решение или действие.
-
-Несогласие связывать с предметом, критерием и условием изменения оценки. Обозначать возможный вариант решения, когда он обеспечен материалами. Не смягчать позицию до неясности и не усиливать её сверх данных.
-
-В вопросе применимости сохранять статус каждого элемента. Непереносимость не расширять на неназванный класс и не превращать в требование о способе замены без основания.
-
-Сохранять переданную форму обращения. Тему, подпись, имя, срок, полномочия и вложения не добавлять без основания.

.zcode/skills/engineering-writing-ru/references/genres/community-comment.md

@@ -1,10 +0,0 @@
-# Профессиональный комментарий
-
-Отвечать на конкретный тезис обсуждения и достаточно рано обозначать позицию. Затем давать основание, условие или ограничение. Длина определяется сложностью аргумента.
-
-При согласии уточнять, какую часть позиции поддерживают данные. При возражении называть предмет несогласия, критерий и условие, при котором оценка может измениться. Личный опыт и интерпретацию отделять от установленного факта.
-
-Критиковать данные, метод, критерий или вывод, а не автора. Различать фактическую ошибку и допустимое расхождение интерпретаций. При недостатке сведений задавать точный предметный вопрос.
-
-Не пересказывать публикацию и не превращать комментарий в универсальное заключение. Приветствие, благодарность и приглашение к дискуссии сохранять только при естественной связи с текущим диалогом.
-

.zcode/skills/engineering-writing-ru/references/genres/engineering-report.md

@@ -1,13 +0,0 @@
-# Глава или подраздел НИР
-
-Готовить только запрошенную часть документа. Сохранять переданный внешний заголовок. Не добавлять обзор всего отчёта, содержание соседних глав или общее введение без запроса.
-
-Вести главу крупными связанными абзацами. Один абзац может объединять условия, метод, результат и интерпретацию одной инженерной линии. Новый абзац нужен при смене объекта, масштаба, временной ветви или самостоятельного аргумента, а не при каждой внутренней функции.
-
-По умолчанию обходиться без внутренних заголовков. Рубрикация нужна по шаблону документа либо для нескольких самостоятельных крупных блоков, каждый из которых развит несколькими абзацами. Не создавать заголовок для одного или двух коротких абзацев.
-
-Если материалы описывают ход исследования, вести читателя от объекта и условий к выполненной работе, затем к результату и его интерпретации. Отсутствующие звенья не дописывать и не выравнивать по объёму. Число располагать рядом с объектом, сценарием и условиями, необходимыми для правильного отнесения.
-
-Основное рассуждение вести прозой. Список использовать только для действительно однотипных параметров, состава работ или данных.
-
-Локальный вывод формулировать там, где он завершает рассуждение. Если отдельный раздел выводов обязателен, дать сжатый итог, выполняющий функцию этого раздела, без нового пересказа главы.

.zcode/skills/engineering-writing-ru/references/genres/expert-opinion.md

@@ -1,9 +0,0 @@
-# Экспертное заключение
-
-Готовить проверяемую профессиональную оценку в пределах переданных материалов и полномочий автора. Писать только запрошенную часть. Не добавлять реквизиты, подпись, правовой статус и отсутствующие сведения о рассмотренных материалах.
-
-Основной вывод формулировать ясно для конкретного объекта и условий. Недостаток данных отражать только там, где он меняет оценку: давать обеспеченный материалами условный вывод либо прямо указывать, какой вывод не имеет достаточного основания. Оценку применимости, соответствия, устойчивости, безопасности или допустимости связывать с фактически использованным критерием. Основание и существенные допущения располагать достаточно близко, чтобы решение можно было проверить.
-
-Не превращать предмет, данные, критерий и вывод в обязательные отдельные рубрики. При заданном шаблоне соблюдать его структуру. В остальных случаях вести заключение связно и включать только то, что влияет на оценку или требуемое действие.
-
-Не создавать обязательность сверх источника или полномочий автора.

.zcode/skills/engineering-writing-ru/references/genres/linkedin-en.md

@@ -1,7 +0,0 @@
-# English LinkedIn
-
-Write a professional post or comment for the supplied technical audience. Begin with the relevant engineering question, case, finding, or position rather than generic thought leadership.
-
-Develop one coherent argument from the available evidence. Include the author's supplied professional stance and the practical implication when supported. Do not invent a personal anecdote, project detail, case study, or universal lesson for relatability.
-
-Avoid a forced hook, marketing superlatives, listicle formatting, an engagement question, and an inspirational closing. Add hashtags, emoji, or a call to comment only when requested. Return only the requested publication.

.zcode/skills/engineering-writing-ru/references/genres/telegram-post.md

@@ -1,11 +0,0 @@
-# Telegram-обзор технологии, методики или практики
-
-Писать для специалиста, которому нужно понять предмет, проверить рассуждение и оценить практическую применимость. В первом абзаце сразу дать конкретный тезис из материалов и назвать его предмет. Общую справку вводить позже и только там, где она нужна для проверки рассуждения.
-
-Развивать конкретную линию теми опорами, которые есть в материалах: данными, различием условий, объяснением механизма или последствиями для практики. Не дописывать остальные элементы ради полноты. Не добавлять декоративную историю, риторический вопрос, искусственную разговорность, рекламное обещание и обязательный призыв к вовлечению.
-
-Заголовок допустим и часто полезен для самостоятельного поста. Он должен точно называть предмет без кликбейта. Если пользователь просит только тело, заголовок не добавлять. Подзаголовки использовать лишь для нескольких крупных самостоятельных блоков, а не для одного или двух коротких абзацев.
-
-Абзацы могут различаться по длине, но должны развивать одну линию, а не заново вводить тему. Основное разграничение формулировать в одном месте. Возвращаться к нему только с новым основанием, условием или следствием.
-
-Закончить там, где исчерпана предметная линия. Отдельный финальный абзац не нужен, если он только переформулирует уже понятный тезис.

.zcode/skills/engineering-writing-ru/references/languages/en.md

@@ -1,5 +0,0 @@
-# English professional register
-
-Write idiomatic professional English rather than translating Russian syntax word for word. Preserve technical meaning, established domain terms, source status, and claim scope.
-
-Choose tense from the actual time reference and continuing validity of the result. Use active or passive voice according to focus, naming the actor when responsibility or provenance matters. Do not import Russian guidance on participles or punctuation.

.zcode/skills/engineering-writing-ru/references/languages/ru.md

@@ -1,9 +0,0 @@
-# Русский профессиональный регистр
-
-Писать естественно для русскоязычного инженера и сохранять принятую предметную лексику. Причастные конструкции и технические номинализации допустимы, пока не скрывают объект и смысловую связь.
-
-В отчётах и заключениях свободно использовать пассивные и безличные конструкции, когда в центре метод, объект или результат. Исполнителя называть при существенной ответственности или происхождении данных.
-
-Для актуального состояния и сохраняющего силу результата выбирать настоящее время либо результативную конструкцию по фокусу и виду. Прошедшее время использовать, когда важна сама хронология: для датированного события, сопоставления этапов или прежнего состояния.
-
-По личному предпочтению избегать точки с запятой. Использовать её только в редком сложном перечислении, если точка, запятая, двоеточие или список делают связь менее ясной.

.zcode/skills/engineering-writing-ru/references/tasks/analysis-and-facts.md

@@ -1,23 +0,0 @@
-# Анализ данных и новые выводы
-
-Подключать этот файл для нового технического вывода, расчёта, сопоставления с критерием, проверки источника, применимости или существенного конфликта. Обычная языковая редактура его не требует.
-
-## Уровень допустимого вывода
-
-- Строгий уровень сохраняет переданные факты и непосредственно обеспеченные выводы.
-- Аналитический уровень допускает прозрачный расчёт и сопоставление по заданному правилу.
-- Исследовательский уровень создаёт отдельные кандидаты для проверки, а не публикационные утверждения.
-
-Для готового заключения по умолчанию использовать строгий уровень. Прямую просьбу проанализировать данные выполнять на аналитическом уровне. Исследовательский результат отделять и указывать, на чём он основан и какая проверка отсутствует.
-
-## Получение вывода
-
-Для каждого добавляемого утверждения внутренне зафиксировать исходные данные, допустимое преобразование или критерий, полученный результат и область, в которой он сохраняет силу. Если звена не хватает, не достраивать его правдоподобным объяснением.
-
-Простое производное значение или конверсию вычислять при известных исходных значениях и правиле. Сохранять формулу, единицы и допущения. Использовать детерминированный калькулятор, не повышать точность и обозначать округление, если оно влияет на решение.
-
-Выбор модели, критерия, коэффициента или граничного условия не считать простой конверсией. Он требует отдельного основания и достаточных исходных данных.
-
-## Сопоставление версий
-
-Несколько версий данных или источника сопоставлять по предмету, дате и области, а не выбирать автоматически более новую. Форму результата и неразрешённые конфликты обрабатывать по общим правилам.

.zcode/skills/engineering-writing-ru/references/tasks/placeholders.md

@@ -1,16 +0,0 @@
-# Плейсхолдеры в готовом тексте
-
-Использовать плейсхолдер только для конкретного отсутствующего элемента:
-
-- `⟦PH-NUM-01⟧` для числа или диапазона
-- `⟦PH-SOURCE-01⟧` для источника или ссылки
-- `⟦PH-REF-01⟧` для номера рисунка, таблицы, раздела или сценария
-- `⟦PH-TERM-01⟧` для термина или обозначения
-- `⟦PH-OBJECT-01⟧` для объекта, участка или адресата
-- `⟦PH-TEXT-01⟧` для локального фрагмента другой категории
-
-Один элемент во всех повторных местах получает один токен. Окружение должно быть грамматически готово к публикации после подстановки. Содержимое плейсхолдера не объяснять внутри повествования и не добавлять список расшифровок без запроса.
-
-Если неизвестны объект, критерий или основание главного вывода и подстановка изменит всю аргументацию, задать один сгруппированный вопрос вместо условно готового текста.
-
-Если такой вопрос прямо запрещён, не заменять фундаментальный пробел набором плейсхолдеров. Вернуть краткий блокер с отсутствующими опорами, не имитируя готовый вывод.

.zcode/skills/engineering-writing-ru/references/tasks/review.md

@@ -1,16 +0,0 @@
-# Проверка без переписывания
-
-Возвращать только замечания. Исправленный текст добавлять лишь по отдельной просьбе и отделять от диагностики. Проверять по общим правилам, языку и жанру выбранного артефакта.
-
-Сначала выявлять дефекты, способные изменить данные, область вывода, решение или действие. Затем проверять ход рассуждения, референцию, жанр, неоднозначность языка и терминологическую последовательность.
-
-Каждое замечание локализовать короткой цитатой или указанием места. Объяснить проблему, её влияние и требуемый тип исправления. Не придумывать замену отсутствующему числу, источнику или техническому выводу.
-
-Приоритет использовать только когда он помогает работе:
-
-- S0 для уверенного дефекта с риском тяжёлого или труднообратимого решения
-- S1 для необоснованного вывода, неверной области или существенной ошибки рекомендации
-- S2 для структуры и неоднозначности, заметно мешающих профессиональному использованию
-- S3 для локальной языковой правки
-
-Не перечислять мелочи, если запрошены только существенные замечания. Отсутствие типового раздела не считать дефектом, когда его функция уже выполнена.

.zcode/skills/engineering-writing-ru/references/terminology/gate.md

@@ -1,17 +0,0 @@
-# Точечная проверка терминологии
-
-Подключать терминологию при переводе, конфликте вариантов, незнакомом употреблении или прямом запросе на проверку термина. Геомеханическая тема сама по себе не требует загрузки словаря.
-
-Сначала определить понятие, носителя свойства, процесс, метод получения, область и направление перевода. Сохранять уже принятую терминологию документа, если она обозначает то же понятие и не конфликтует с обязательным источником или прямым решением пользователя.
-
-Для поиска по тексту запустить `scripts/lookup_scientia.py`, разрешив путь относительно каталога текущего `SKILL.md`:
-
-```powershell
-python <каталог-skill>\scripts\lookup_scientia.py --text-file <файл> --limit 12
-```
-
-Для отдельных выражений использовать `--query`. Если проверенные и контекстные записи ничего не дали либо пользователь прямо просит свериться с Scientia, повторить точечный запрос с `--include-raw-candidates`. Raw-результат считать только кандидатом для проверки смысла, а не утверждённым переводом. Рассматривать только компактный результат поиска. Полный снимок Scientia, служебные статусы и таблицы сопровождения не открывать в контексте модели.
-
-Однозначное проверенное соответствие применять только в указанном смысле. Для многозначного термина сначала разрешить значение по контексту. Если среда не позволяет выполнить поиск, сохранить терминологию исходного документа или использовать короткий словарь, явно переданный пользователем.
-
-Конфликт, меняющий понятие или вывод, передать пользователю. Терминологический плейсхолдер использовать только при выбранной форме с плейсхолдерами.

.zcode/skills/engineering-writing-ru/references/terminology/maintenance/pending-corrections.tsv

@@ -1,15 +0,0 @@
-english_raw	russian_raw	issue	proposed_change	status	evidence_needed	owner	reviewed_on
-bulk modulus	коэффициент объемного расширения	Русская пара, вероятно, обозначает другой параметр.	модуль объёмного сжатия	pending	Сверить определение, поддомен и принятую терминологию механики сплошной среды.	unassigned	
-effective stress	истинное напряжение (разница между горным и поровым давлением)	Термин «истинное напряжение» может смешивать разные понятия.	эффективное напряжение	pending	Сверить определение эффективного напряжения и принятую знаковую конвенцию.	unassigned	
-FDEM (Finite–Discrete element method)	МКДЭ (метод конено-дискретных элементов	Опечатка и незакрытая скобка в русском тексте.	МКДЭ (метод конечно-дискретных элементов)	pending	Подтверждение владельца словаря.	unassigned	
-fan dill pattern	веерная сетка шпуров	Вероятная опечатка dill в английской форме.	fan drill pattern	pending	Подтверждение исходного английского термина.	unassigned	
-instanteneous initiation	мгновенное взрывание (детонирование)	Вероятная опечатка instanteneous.	instantaneous initiation	pending	Подтверждение исходного английского термина.	unassigned	
-mining progerss longsection	продольный разрез, показывающий последовательность отработки всей шахты	Вероятная опечатка progerss; состав термина требует проверки.	mining progress longsection	pending	Проверить термин по исходному профессиональному источнику.	unassigned	
-tripple bench	строенный уступ	Вероятная опечатка tripple в английской форме.	triple bench	pending	Подтверждение исходного английского термина.	unassigned	
-ground support elements	крепежные материалы	Materials и elements неэквивалентны; перевод сужает состав системы крепи.	элементы крепи | элементы системы крепи	pending	Подтвердить предпочтительную форму и область, где речь именно о материалах.	unassigned	
-intact rock	цельная порода без естественных трещин	Форма «без естественных трещин» чрезмерно абсолютна и не фиксирует масштаб материала или образца.	ненарушенная горная порода | ненарушенный породный материал	pending	Утвердить форму для образца, материала и расчётного параметра.	unassigned	
-systematic (blanket) ground support	сплошная крепь	Systematic и blanket объединены как синонимы, хотя схема установки и сплошное покрытие не всегда совпадают.	Разделить systematic ground support и blanket ground support.	pending	Проверить определения и принятые русские термины для двух понятий.	unassigned	
-UCS of intact rock	прочность породы в образце (не нарушенном естественными трещинами)	Перевод не называет предел прочности и вид испытания.	предел прочности ненарушенной горной породы при одноосном сжатии (UCS)	pending	Утвердить форму с учётом терминологии применимой методики испытаний.	unassigned	
-UCS of rock mass	прочность породы в массиве (прочность массива)	UCS обычно относится к одноосному испытанию ненарушенного образца; интегральную прочность массива нельзя обозначать тем же носителем молча.	Не применять автоматически; различить UCS ненарушенной породы и прочность массива.	pending	Проверить, какой параметр и метод оценки подразумевает исходная статья.	unassigned	
-yielding ground support	податливая крепь (для динамических условий)	Ограничение только динамическими условиями слишком узкое; податливость применяют и при больших квазистатических деформациях.	податливая крепь	pending	Утвердить определение по механизму податливости и области применения.	unassigned	
-yielding rock bolt	деформируемый анкер	«Деформируемый» слишком широко и не раскрывает механизм податливости или поглощения энергии.	податливый анкер | энергопоглощающий анкер	pending	Разделить общий податливый анкер и динамический энергопоглощающий тип.	unassigned