@nitra/cursor 12.8.9 → 12.10.0

package/rules/abie/policy/health_check_policy/health_check_policy.mdc

@@ -8,10 +8,12 @@ Rego-пакет: `abie.health_check_policy`
 
 - `apiVersion` — точно `networking.gke.io/v1`;
 - `metadata.name` — непорожній рядок;
+- `metadata.namespace` — `dev`;
 - `spec.default.config.type` — `HTTP`;
 - `spec.default.config.httpHealthCheck.requestPath` — непорожній, починається з `/`;
-- `spec.default.config.httpHealthCheck.port` — `8080`;
+- `spec.default.config.httpHealthCheck.port` — `8080` (обов'язковий, відсутність теж помилка);
 - `spec.targetRef.kind` — `Service`;
+- `spec.targetRef.group` — порожній рядок `''` (якщо поле присутнє);
 - `spec.targetRef.name` — `<metadata.name>-hl` (якщо `metadata.name` вже закінчується на `-hl` — використовується як є).
 
 FS-парність HCP↔Deployment та modeline `$schema` у `hc.yaml` — поза Rego, у `js/hc_pairing.mjs`. JS-опис структури та приклад — у `js/hc_pairing.mdc`.

package/rules/abie/policy/health_check_policy/health_check_policy.rego

@@ -61,6 +61,15 @@ deny contains "HealthCheckPolicy: metadata.name має бути непорожн
 	trim_space(name) == ""
 }
 
+# ── deny: metadata.namespace ──────────────────────────────────────────────
+
+deny contains msg if {
+	is_health_check_policy
+	ns := object.get(object.get(input, "metadata", {}), "namespace", "")
+	ns != "dev"
+	msg := sprintf("HealthCheckPolicy: metadata.namespace має бути dev (зараз %q) (abie.mdc)", [ns])
+}
+
 # ── deny: spec.default.config.type ────────────────────────────────────────
 
 deny contains "HealthCheckPolicy: spec.default.config.type має бути HTTP (abie.mdc)" if {
@@ -87,6 +96,12 @@ deny contains msg if {
 
 # ── deny: port == 8080 ────────────────────────────────────────────────────
 
+deny contains "HealthCheckPolicy: spec.default.config.httpHealthCheck.port має бути 8080 (abie.mdc)" if {
+	is_health_check_policy
+	is_object(http_health_check)
+	object.get(http_health_check, "port", null) == null
+}
+
 deny contains msg if {
 	is_health_check_policy
 	is_object(http_health_check)
@@ -108,6 +123,18 @@ deny contains msg if {
 	msg := sprintf("HealthCheckPolicy: targetRef.kind має бути Service (зараз %q) (abie.mdc)", [kind])
 }
 
+# ── deny: targetRef.group == '' ───────────────────────────────────────────
+
+deny contains msg if {
+	is_health_check_policy
+	target_ref := object.get(object.get(input, "spec", {}), "targetRef", {})
+	is_object(target_ref)
+	group := object.get(target_ref, "group", null)
+	group != null
+	group != ""
+	msg := sprintf("HealthCheckPolicy: targetRef.group має бути порожнім рядком '' (зараз %q) (abie.mdc)", [group])
+}
+
 # ── deny: targetRef.name = `<hcp.metadata.name>-hl` (exact, з нормалізацією)
 
 deny contains msg if {

package/rules/adr/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/adr/
 
 | Файл | Тип |
 |---|---|
-| [fix.mjs](fix.md) | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/adr/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль виконує логіку перевірок, обробляючи JS-запити та звертаючись до MDC. При запуску як окремий інструмент, він ініціює повний цикл правил, включаючи завантаження конфігурацій з meta.json. Модуль має лише читачний доступ до файлової системи та баз даних. Під час виконання він використовує кешування у межах прогону для оптимізації.
 
 ## Поведінка

package/rules/adr/js/madr_format.mdc

@@ -93,4 +93,16 @@ docs/adr/
 └── hooks.json                 # Cursor Agent stop-hooks для тих самих скриптів
 ```
 
-`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене): [.gitignore.snippet](./templates/hooks/.gitignore.snippet).
+`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене):
+
+```gitignore
+node_modules/
+dist/
+*.secret
+
+# @nitra/cursor (adr) — локальні артефакти Stop-hook, не коміти
+.claude/hooks/*.log
+.claude/hooks/.normalize-state
+.claude/hooks/.normalize.lock
+.claude/scheduled_tasks.lock
+```

package/rules/adr/main.mdc

@@ -6,8 +6,6 @@ version: '2.2'
 
 Правило `adr` автоматично фіксує архітектурні рішення (ADR) після кожної сесії через Stop-хуки і батч-нормалізує чернетки у канонічний формат MADR v4.
 
-[adr-madr-format](./js/madr_format.mdc)
-
 ## Stop-hook у `.claude/settings.json`
 
 Канонічний запис, який вставляє sync (поряд із PostToolUse fix-хуком — той живе в іншій події, тут не показаний):
@@ -76,10 +74,3 @@ Cursor Agent читає project-level **`.cursor/hooks.json`**. `npx @nitra/curs
 | `adr.settings_json` | `.claude/settings.json` | Наявність обох Stop-хуків у `hooks.Stop[]` |
 | `adr.settings_local_json` | `.claude/settings.local.json` | Відсутність дублів Stop-хуків у local-файлі |
 
-[adr-settings-policy](./js/settings_policy.mdc)
-
-[adr-settings_json-policy](./policy/settings_json/settings_json.mdc)
-
-[adr-settings_local_json-policy](./policy/settings_local_json/settings_local_json.mdc)
-
-[adr-hooks](./js/hooks.mdc)

package/rules/bun/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/bun/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/bun/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль валідує дані, застосовуючи правила, визначені у конфігурації meta.json, та збирає посилання на MDC. При виклику публічної функції run він здійснює повний запуск правила, включаючи завантаження конфігурацій та застосування білих списків. Результат виконання повертається як код виходу процесу.
 
 ## Поведінка

package/rules/bun/main.mdc

@@ -5,18 +5,4 @@ alwaysApply: false
 version: '2.1'
 ---
 
-Проект використовує тільки Bun для керування залежностями та запуску скриптів.
-
-[bun-layout](./js/layout.mdc)
-
-[bun-bunfig](./js/bunfig.mdc)
-
-[bun-package_json](./js/package_json.mdc)
-
-[bun-lint](./js/lint.mdc)
-
-## Швидкий gate через conftest
-
-[bun-policy-bunfig](./policy/bunfig/bunfig.mdc)
-
-[bun-policy-package_json](./policy/package_json/package_json.mdc)
+Проект використовує тільки Bun для керування залежностями та запуску скриптів.

package/rules/bun/policy/package_json/package_json.rego

@@ -24,6 +24,18 @@ deny contains msg if {
 	msg := sprintf("package.json: поле %s — %s", [field, reason])
 }
 
+# ── deny: scripts.lint / scripts.lint-* заборонені (bun.mdc lint) ────────
+
+deny contains msg if {
+	is_object(input.scripts)
+	some script_name, _ in input.scripts
+	regex.match(`^lint(-.*)?$`, script_name)
+	msg := sprintf(
+		"package.json: scripts.%s заборонений — лінт запускається через n-cursor lint, не через package.json-скрипти (bun.mdc)",
+		[script_name]
+	)
+}
+
 # ── deny: devDependencies — лише `@nitra/*` + root-only тестові peer/tools ─
 
 deny contains msg if {

package/rules/capacitor/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/capacitor/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/capacitor/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль застосовує політику та логіку, визначену в конфігурації meta.json, для валідації. При запуску як CLI ініціюється повний запуск правила, що включає завантаження конфігурацій, застосування білих списків та підбиття підсумків. Модуль є лише для читання (не виконує записів у файлову систему чи базу даних) і використовує кешування даних у межах одного прогону.
 
 ## Поведінка

package/rules/capacitor/main.mdc

@@ -7,12 +7,6 @@ version: '1.1'
 
 Правило перевіряє версію `@capacitor/core` у `package.json` та коректність використання CocoaPods/SPM у iOS-шарі Capacitor-проєкту.
 
-[capacitor-version](./js/version.mdc)
-
-[capacitor-ios-spm](./js/ios_spm.mdc)
-
 ## Швидкий gate через conftest
 
-[capacitor-package_json](./policy/package_json/package_json.mdc)
-
 JS-перевірка (`platforms.mjs`) — authoritative: підтримує `||`-діапазони, hyphen-range, workspace-monorepo та iOS-специфічну логіку (Podfile).

package/rules/changelog/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/changelog/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/changelog/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль відповідає за виконання політики, використовуючи дані з meta.json. Він забезпечує перевірку та застосування логіки, визначеної в конфігурації. Виклик функції run ініціює процес виконання правила, включаючи кешування даних у межах одного прогону.
 
 ## Поведінка

package/rules/changelog/js/agent-workflow.mdc

@@ -2,7 +2,7 @@
 
 > **Якщо в цій сесії ти змінив(ла) файли в пакетному workspace** (код, rego, правила, скіли, скрипти, конфіги, тести — **не** лише `docs/` / `doc/`) — **не завершуй задачу**, поки не виконаєш **усі три** кроки нижче в **тому ж** наборі змін. Це не «опційно після синку» — це частина PR.
 
-1. **Поклади change-файл** `<ws>/.changes/YYMMDD-HHMM.md` з frontmatter `bump:` (`major|minor|patch`) + `section:` (`Added|Changed|Fixed|Removed`) і текстом опису. Команда: `npx @nitra/cursor change --bump <…> --section <…> --message "<…>" [--ws <шлях>]`. Якщо файл за ту саму хвилину вже існує, CLI атомарно створює `YYMMDD-HHMM-2.md`, потім `-3` тощо.
+1. **Поклади change-файл** `<ws>/.changes/YYMMDD-HHMM.md` з frontmatter `bump:` (`major|minor|patch`) + `section:` (`Added|Changed|Fixed|Removed`) і текстом опису. Команда: `npx @7n/n ch [--bump <…>] [--section <…>] [--message "<…>"]` — автоматично знаходить зачеплені workspaces за git status і пише окремий change-файл у кожен; без `--message` генерує опис через omlx з diff.
 2. **Ніколи** не редагуй `version` і `CHANGELOG.md` вручну — навіть для hotfix. Єдиний артефакт зміни — change-файл; `version`/CHANGELOG формує `n-cursor release` у CI на `main` (агрегує change-файли, ставить git-тег `<name>@<version>`). Будь-яка зміна `version` поза CI (drift від бази чи опублікованої) завалює `check changelog` — навіть якщо поряд є change-файл.
 3. **`npx @nitra/cursor fix changelog`** → exit **`0`** (достатньо наявності change-файлу; `version` лишається незмінним).
 

package/rules/changelog/js/consistency.mjs

@@ -406,7 +406,7 @@ function workspaceLabel(manifest) {
 function missingChangeFileMessage(label, mf) {
   return (
     `${label}: є релевантні зміни, але немає change-файлу (version у ${mf} не чіпай вручну). ` +
-    `Поклади change-файл: npx @nitra/cursor change --bump <major|minor|patch> --section <Added|Changed|Fixed|Removed> --message "<…>"; ` +
+    `Поклади change-файл: npx @7n/n ch [--bump <major|minor|patch>] [--section <Added|Changed|Fixed|Removed>] [--message "<…>"]; ` +
     `bump зробить CI на main (n-changelog.mdc)`
   )
 }
@@ -574,7 +574,7 @@ async function checkPublishedWorkspace(manifest, subWorkspaces, getPublishedVers
     fail(
       `${label}: version у ${mf} (${Vcurrent}) випереджає опубліковану (${Vpublished}) — ` +
         `ручний bump поза CI заборонено. Відкоти version і поклади change-файл ` +
-        `(npx @nitra/cursor change …); bump зробить CI на main (n-changelog.mdc)`
+        `(npx @7n/n ch); bump зробить CI на main (n-changelog.mdc)`
     )
     return
   }
@@ -613,7 +613,7 @@ async function checkLocalOnlyChangedWorkspace(comparisonRef, manifest, baseLabel
   if (Vbase !== null && Vcurrent !== null && versionIsAhead(Vcurrent, Vbase)) {
     fail(
       `${label}: version у ${mf} змінено поза CI (${Vbase} → ${Vcurrent}) — ручний bump заборонено (на ${baseLabel} — ${Vbase}). ` +
-        `Відкоти version і поклади change-файл (npx @nitra/cursor change …); bump зробить CI (n-changelog.mdc)`
+        `Відкоти version і поклади change-файл (npx @7n/n ch); bump зробить CI (n-changelog.mdc)`
     )
     return
   }

package/rules/changelog/js/docs/consistency.md

@@ -3,36 +3,31 @@ type: JS Module
 title: consistency.mjs
 resource: npm/rules/changelog/js/consistency.mjs
 docgen:
-  crc: eaf98d6d
+  crc: 92b7c3f0
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Перевіряє версіонування проектів у монорепозиторії, порівнюючи версії, зазначені в маніфестах, з даними, отриманими з мережі з https://pypi.org/pypi/. Аналізує відповідність версій встановленим правилам, визначеним у конфігурації res.json. Визначає, чи відповідають версії формату, а також перевіряє наявність змін, порівнюючи їх із даними, описаними у (n-changelog.mdc). При невдачі перевірки повертає false/null, не кидаючи винятків.
+## Огляд
+
+Компонент виконує перевірку стану проєктів у монорепозиторії. Він звертається до мережі для порівняння версій з реєстром, зокрема https://pypi.org/pypi/, та аналізує зміни, посилаючись на (n-changelog.mdc). Код спирається на конфігурацію, визначену у res.json. При виявленні невідповідностей компонент перехоплює помилки (fail-safe) і повертає порожнє значення замість кидання винятків.
 
 ## Поведінка
 
-1. Ініціалізує репортер для збору результатів перевірки.
-2. Визначає робочий каталог та стан autofix-режиму.
-3. Зчитує всі кореневі каталоги проектів у монорепо.
-4. Класифікує кожен проект як публікувальний (registryPublishable) або локальний.
-5. Для кожного публікувального проекту виконує перевірку:
-   а. Зчитує маніфест проекту.
-   б. Якщо у маніфесті відсутнє ім'я або поле version, фіксує помилку.
-   в. Якщо є change-файл(и) у .changes/, фіксує успіх, оскільки bump зробить CI (n-changelog.mdc), і перевіряє наявність "CHANGELOG.md" у файлах проекту.
-   г. Якщо немає change-файлу, визначає точку порівняння на основі поточної гілки.
-   д. Порівнює версію в маніфесті з опублікованою версією (за допомогою npm view або запиту до https://pypi.org/pypi/).
-   е. Якщо версія в маніфесті випереджає опубліковану, фіксує помилку, оскільки ручний bump поза CI заборонений.
-   ж. Якщо версія в маніфесті позаду опублікованої, фіксує успіх, оскільки це відставання локального репозиторію від реєстру.
-   з. Якщо версії збігаються, перевіряє змінений код відносно точки порівняння. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
-6. Для кожного локального проекту виконує перевірку:
-   а. Зчитує маніфест проекту.
-   б. Визначає точку порівняння на основі поточної гілки.
-   в. Перевіряє, чи є релевантні зміни у проекті відносно точки порівняння.
-   г. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
-7. Повертає кінцевий код виходу, що відображає результат перевірки.
+1. `check` ініціалізує репортер та визначає режим автоматичного виправлення на основі змінної середовища.
+2. `check` зчитує список усіх кореневих каталогів проєктів у монорепозиторії.
+3. `check` класифікує знайдені проєкти на ті, що можуть бути опубліковані в реєстрі, та ті, що є локальними.
+4. Для кожного проєкту, що може бути опублікований, `check` викликає перевірку опублікованого воркспейсу.
+5. Перевірка опублікованого воркспейсу порівнює версію у маніфесті з опублікованою версією, отриманою через мережевий запит до реєстру (наприклад, https://pypi.org/pypi/).
+6. Якщо версія у маніфесті випереджає опубліковану, `check` повідомляє про заборонений ручний bump поза CI.
+7. Якщо версія у маніфесті відповідає опублікованій, `check` перевіряє, чи є релевантні зміни у файловій системі відносно базової точки порівняння (наприклад, `origin/main`).
+8. Якщо зміни існують, але відсутній change-файл, `check` або автоматично створює його (у режимі autofix), або повідомляє про необхідність ручного створення, посилаючись на (n-changelog.mdc).
+9. Для кожного локального проєкту `check` порівнює стан з базовою точкою порівняння.
+10. Якщо зміни існують, але відсутній change-файл, `check` або автоматично створює його (у режимі autofix), або повідомляє про необхідність ручного створення, посилаючись на (n-changelog.mdc).
+11. `check` повертає кінцевий код виходу на основі накопичених повідомлень про помилки.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
+- Read-only: не виконує операцій запису (ФС/БД).
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдалої перевірки повертає `false`/`null` замість винятку.
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/rules/changelog/main.mdc

@@ -6,8 +6,3 @@ alwaysApply: true
 
 У кожному **пакетному** workspace (каталог із `package.json` або `pyproject.toml`) має бути власний **`CHANGELOG.md`**. Спільного на репозиторій змісту змін **не існує** — кожен пакет веде свій. Маніфест версії: **JS/Bun/npm** — `package.json` (`version`); **Python** — `pyproject.toml` (`[project].version` або `[tool.poetry].version`).
 
-[changelog-agent-workflow](./js/agent-workflow.mdc)
-
-[changelog-comparison-models](./js/comparison-models.mdc)
-
-[changelog-format](./js/changelog-format.mdc)

package/rules/ci4/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/ci4/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/ci4/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль валідує дані відповідно до правил, використовуючи конфігурацію, визначену в meta.json. Він застосовує білий список та виконує логіку перевірки. При запуску як окрема програма, він повертає код виходу, що інформує про успіх чи виявлені порушення. Модуль є Read-only, тобто не здійснює записів у файлову систему чи бази даних. Кешування даних відбувається у межах одного прогону.
 
 ## Поведінка

package/rules/ci4/main.mdc

@@ -372,8 +372,3 @@ Rego-перевірки, що запускаються через `conftest` у
 | --------------------------- | -------------------------------------------------------------------- |
 | `ci4.vscode_extensions`     | `.vscode/extensions.json` містить `arr.marksman` у `recommendations` |
 
-[ci4-marksman_config](./js/marksman_config.mdc)
-
-[ci4-vscode_extensions](./js/vscode_extensions.mdc)
-
-[ci4-vscode_extensions-policy](./policy/vscode_extensions/vscode_extensions.mdc)

package/rules/doc-files/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/doc-files/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/doc-files/docs/main.md

@@ -3,26 +3,22 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/doc-files/main.mjs
 docgen:
-  crc: 64f215a5
+  crc: 82caefcd
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
+  score: 90
 ---
 
-## Огляд
-
-Модуль перевіряє відповідність коду та документації, спираючись на конфігурацію `meta.json`. Функція `run` перевіряє консистентність між кодом та документацією. Функція `lint` перевіряє застарілі описи документації.
+Модуль перевіряє відповідність конфігурацій політики джерелам коду, спираючись на `meta.json`. Він також аналізує документацію на відповідність джерелам коду, виявляючи застарілі або нерелевантні описи.
 
 ## Поведінка
 
-run виконує перевірку консистентності між кодом та документацією.
-
-lint перевіряє, чи не застаріли описи документації, і може автоматично їх оновлювати, якщо це дозволено конфігурацією `meta.json`.
+run виконує перевірку відповідності до політики, порівнюючи конфігурації з джерелами коду.
+lint перевіряє, чи відповідає документація джерелам коду, виявляючи застарілі описи та сирітські доки, а також може автоматично їх виправляти за умови наявності конфігурації `meta.json: llmFix:true`.
 
 ## Публічний API
 
-run — виконує основну перевірку, яка включає аналіз JS-задач, застосування політик та посилання на MDC.
-lint — сканує файли документації на наявність застарілих елементів, з можливістю автоматичного виправлення за умови активації LLM.
-llmFix — виконує добровільну генерацію виправлень за допомогою LLM, якщо це дозволено в конфігурації.
+run — основна точка входу, яка виконує перевірку (JS-залежності $\rightarrow$ політики $\rightarrow$ посилання MDC) та запускає перевірку на застарілі файли.
+lint — збирає дані для перевірки документаційних файлів, з можливістю автоматичного виправлення за умови ввімкнення LLM-функціоналу.
 
 ## Гарантії поведінки
 

package/rules/doc-files/js/docs/docgen-crc.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль забезпечує роботу з метаданими та оцінкою якості документів. Він дозволяє парсити метадані з Markdown-файлів за допомогою `parseDocFrontmatter`, створювати та заповнювати блоки метаданих за допомогою `buildDocFrontmatter`. Документи можуть бути промарковані за допомогою `stampDoc`. Якість документа оцінюється за допомогою `readDocQuality`, а його актуальність визначається функцією `staleness`, яка використовує `crc32` для перевірки хеш-суми. Модель документа зчитується через `readDocModel`.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-extract.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль витягує структурований факт-лист з вмісту файлів, звертаючись до мережі. Функція `extractFacts` аналізує вміст файлів, визначаючи публічні експорти, локальні символи та поведінкові маркери для Rust та JavaScript/TypeScript файлів. При цьому ігноруються системні та залежності, включаючи каталоги `.github`, `.git`, `node_modules`, `base/`, `ua/` та `.firebase`. Результати аналізу кешуються протягом одного прогону.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-files-batch.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль керує життєвим циклом документації. Він вибирає цілі для оновлення за допомогою `selectTargets`, очищає від неіснуючих джерел за допомогою `purgeOrphanedDocs`, запускає генерацію файлів через `runDocFilesGenCli` та `runDocFilesStampCli`, а також виконує пакетну генерацію за допомогою `runGenerationBatch`. Усі операції виконуються з механізмом перехоплення помилок, що запобігає виникненню винятків назовні.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-gen.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль забезпечує повний цикл роботи з документами: відокремлює захищений блок за допомогою `splitProtected`, вставляє його у визначене місце за допомогою `insertProtected`, генерує повний Markdown-документ через `generateDoc` (з використанням `DEFAULT_LOCAL_MODEL`), а також оцінює якість документа за допомогою `scoreDoc`. Кешування застосовується протягом прогону. (abie.mdc)
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-judge-measure.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Файл аналізує надані файли коду, створюючи документацію та оцінюючи її якість відповідно до конфігурації, що міститься у report.json. Процес збирає результати для кожного файлу, використовуючи кешування у межах прогону на основі вмісту джерела та вже згенерованої документації. У кінці процес агрегує дані та зберігає повний звіт у report.json, а також виводить його у консоль.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-judge.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль реалізує механізм оцінки якості документації. Він визначає модель для оцінки за допомогою `JUDGE_MODEL`, перевіряє статус активності гейту через `JUDGE_ENABLED` та встановлює поріг впевненості за допомогою `JUDGE_CONFIDENCE`. Модуль отримує, парсить та визначає фінальний статус документації, викликаючи `judgeDoc` для отримання висновків, а також може використовувати `judgeFailsDoc` для визначення провалу.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-scan.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль визначає, які файли є кодовим джерелом за допомогою `isSourceFile`. Він обчислює відповідні шляхи до Markdown-документів для коду за допомогою `docPathForSource`. Модуль ідентифікує потенційні кандидати для документування за допомогою `isDocCandidate` та надає опис файлу за допомогою `describeFile`. Для аналізу файлової системи використовуються `scanOrphanedDocs` для пошуку "сирітських" документів та `scanForDocFiles` для сканування файлів. Модуль також може визначати кореневий каталог за допомогою `resolveRoot` та виконувати сканування файлів документації через `runDocFilesScanCli` або перевірку через `runDocFilesCheckCli`.
 
 ## Поведінка

package/rules/doc-files/js/docs/run-lint.md

@@ -8,8 +8,6 @@ docgen:
   score: 80
 ---
 
-## Огляд
-
 Цей модуль надає CLI-обгортку для канонічного `lint-doc-files` (doc-files.mdc): детермінованого детектора застарілості файлових док (`<dir>/docs/<stem>.md`). При відсутності прапорців або при вказанні шляхів (`[paths…]`) виконується повний або точковий детекст застарілості. Якщо знайдено застарілі файли, повертається код виходу 1. Можливі режими: `--missing-only` звужує перевірку до відсутніх файлів. Прапорець `--json` виводить JSON-лістинг усіх кандидатів. Режими `--hook`, `--git` та `--degraded` делегують перевірку через `runDocFilesCheckCli` (hook-протокол: exit 2/0). Повний прогін здійснюється через `runStandardLint` (ключ `lint-doc-files`), тоді як хук/git/degraded форми використовують канон scripts.mdc, не генеруючи логів. Поведінка описується у (doc-files.mdc).
 
 ## Поведінка

package/rules/doc-files/main.mjs

@@ -101,8 +101,7 @@ function collectStale(files, cwd) {
  */
 export async function lint(files, cwd = process.cwd(), { readOnly = false, llmFix = false } = {}) {
   const stale = collectStale(files, cwd)
-  // Orphan-детект тільки при повному скані; при точковому (files визначено) — не релевантно
-  const orphans = files === undefined ? scanOrphanedDocs(cwd) : []
+  const orphans = scanOrphanedDocs(cwd)
 
   if (stale.length === 0 && orphans.length === 0) return 0
   if (readOnly || !llmFix) {
@@ -132,7 +131,7 @@ export async function lint(files, cwd = process.cwd(), { readOnly = false, llmFi
   }
 
   const stillStale = collectStale(files, cwd)
-  const stillOrphans = files === undefined ? scanOrphanedDocs(cwd) : []
+  const stillOrphans = scanOrphanedDocs(cwd)
   if (stillStale.length === 0 && stillOrphans.length === 0) return 0
   if (stillStale.length > 0) reportStale(stillStale)
   if (stillOrphans.length > 0) {

package/rules/docker/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/docker/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/docker/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль виконує перевірку на відповідність логіці JS-зацікавленостей, політикам та посиланням MDC. Запуск правила ініціюється через публічну функцію `run`.
 
 ## Поведінка

package/rules/docker/js/docs/lint.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль аналізує файли `Dockerfile` та `Containerfile` у репозиторії, використовуючи `isDockerfileName` та `findDockerfilePaths` для ідентифікації конфігурацій. Він розбиває знайдені файли на етапи за допомогою `parseFromStages` та `splitDockerfileStages`. Модуль перевіряє конфігурацію, використовуючи `check` та `lint`, щоб оцінити відповідність стандартам, враховуючи дані з `package.json`. Він визначає інформацію про багатоетапну збірку, теги образів та права користувача, відповідно до вимог (docker.mdc).
 
 ## Поведінка

package/rules/docker/lib/docs/docker-hadolint.md

@@ -8,8 +8,6 @@ docgen:
   score: 90
 ---
 
-## Огляд
-
 Спільна логіка виклику hadolint для шляхів до Dockerfile. Модуль створює стандартизовані відносні шляхи з прямими слешами. Він ініціює перевірку Dockerfile, використовуючи hadolint як нативний бінарник, який резолвиться через `ensureTool` (PATH → кеш → авто-install brew/scoop/GitHub Release per-platform). Для отримання інформації про встановлення можна звертатися до https://github.com/hadolint/hadolint/releases. Публічна функція `lintDockerfileWithHadolint` виконує перевірку за правилом `n-cursor lint docker` / check-docker.
 
 ## Поведінка

package/rules/docker/main.mdc

@@ -11,24 +11,4 @@ alwaysApply: false
 
 ## Активація
 
-Спрацьовує на всі файли `Dockerfile*`; `check docker` (`fix.mjs`) обробляє також `Containerfile` та `Containerfile.*`.
-
-## Швидкий gate через conftest
-
-[docker-lint_docker_yml](./policy/lint_docker_yml/lint_docker_yml.mdc)
-
-[docker-mirror](./js/mirror.mdc)
-
-[docker-multistage](./js/multistage.mdc)
-
-[docker-compile](./js/compile.mdc)
-
-[docker-native-addon](./js/native-addon.mdc)
-
-[docker-non-root](./js/non-root.mdc)
-
-[docker-nginx-tag](./js/nginx-tag.mdc)
-
-[docker-nginx-user](./js/nginx-user.mdc)
-
-[docker-hadolint](./js/hadolint.mdc)
+Спрацьовує на всі файли `Dockerfile*`; `check docker` (`fix.mjs`) обробляє також `Containerfile` та `Containerfile.*`.

package/rules/efes/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/efes/
 
 | Файл                | Тип       |
 | ------------------- | --------- |
-| [fix.mjs](fix.md)   | JS Module |
 | [main.mjs](main.md) | JS Module |

package/rules/efes/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль перевіряє відповідність коду визначеним правилам, використовуючи конфігурацію з meta.json. Він виконує аналіз, який може бути ініційований через публічну функцію run. Модуль є read-only, тобто не здійснює записів у файлову систему чи бази даних. Кешування даних відбувається у межах одного прогону. При завершенні роботи як окремий інструмент, він надає підсумковий звіт.
 
 ## Поведінка

package/rules/efes/main.mdc

@@ -20,4 +20,3 @@ bun add -d @nitra/efes-shared
 
 Пакети (директорія в **`npm/rules/efes/policy/`** → namespace → що перевіряє):
 
-[efes-package_json_shared](./policy/package_json_shared/package_json_shared.mdc)