@nitra/cursor 12.9.0 → 12.10.0

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/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/main.md

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

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/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/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)

package/rules/feedback/docs/main.md

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

package/rules/ga/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 90
 ---
 
-## Огляд
-
 Цей модуль є CLI-обгорткою над канонічним `lint-ga` (ga.mdc). Він автоматично встановлює `shellcheck` та `conftest` через `ensureTool` (використовуючи brew/scoop/GitHub Release залежно від платформи), перевіряє наявність `uv` (для `uvx zizmor`), а потім послідовно виконує `bunx github-actionlint`, `uvx zizmor --offline --collect=workflows .` та делегує до `rules/ga/check.mjs::check`. Функція `lint` викликає `runLintGaCli`, який є частиною оркестраторного адаптера `n-cursor lint ga`. При відсутності `uv`, користувачеві надається підказка з командою встановлення, наприклад, https://astral.sh/uv/install.sh, оскільки `uv` не в реєстрі `ensureTool`.
 
 ## Поведінка

package/rules/ga/js/docs/index.md

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

package/rules/ga/main.mdc

@@ -5,34 +5,4 @@ globs: ".github/workflows/*.yml"
 alwaysApply: false
 ---
 
-Правило **ga** перевіряє структуру `.github/workflows/`, наявність обов'язкових workflow-файлів і їх відповідність канонам, а також налаштування VS Code та zizmor для роботи з GitHub Actions.
-
-[ga-workflows](./js/workflows.mdc)
-
-[ga-workflow_common](./js/workflow_common.mdc)
-
-[ga-required_workflows](./js/required_workflows.mdc)
-
-[ga-vscode](./js/vscode.mdc)
-
-[ga-zizmor](./js/zizmor.mdc)
-
-[ga-lint_toolchain](./js/lint_toolchain.mdc)
-
-## Швидкий gate через conftest
-
-[ga-workflow_common](./policy/workflow_common/workflow_common.mdc)
-
-[ga-clean_ga_workflows](./policy/clean_ga_workflows/clean_ga_workflows.mdc)
-
-[ga-clean_merged_branch](./policy/clean_merged_branch/clean_merged_branch.mdc)
-
-[ga-lint_ga](./policy/lint_ga/lint_ga.mdc)
-
-[ga-git_ai](./policy/git_ai/git_ai.mdc)
-
-[ga-vscode_extensions](./policy/vscode_extensions/vscode_extensions.mdc)
-
-[ga-vscode_settings](./policy/vscode_settings/vscode_settings.mdc)
-
-[ga-zizmor_yml](./policy/zizmor_yml/zizmor_yml.mdc)
+Правило **ga** перевіряє структуру `.github/workflows/`, наявність обов'язкових workflow-файлів і їх відповідність канонам, а також налаштування VS Code та zizmor для роботи з GitHub Actions.

package/rules/graphql/docs/main.md

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

package/rules/graphql/main.mdc

@@ -7,8 +7,3 @@ alwaysApply: false
 
 Якщо у `.vue` або JavaScript / TypeScript джерелах зустрічається **tagged template literal** з тегом **`gql`**, у корені репозиторію мають бути `.graphqlrc.yml` та запис `graphql.vscode-graphql` у `.vscode/extensions.json`.
 
-[graphql-tooling](./js/tooling.mdc)
-
-[graphql-vscode-extensions](./js/vscode_extensions.mdc)
-
-[graphql-vscode-extensions-policy](./policy/vscode_extensions/vscode_extensions.mdc)

package/rules/hasura/docs/main.md

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

package/rules/hasura/js/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/hasura/js/
 
 # npm/rules/hasura/js
 
-| Файл | Тип |
-|---|---|
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
 | [internal_urls.mjs](internal_urls.md) | JS Module |
-| [migrations.mjs](migrations.md) | JS Module |
+| [migrations.mjs](migrations.md)       | JS Module |

package/rules/hasura/js/docs/migrations.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Функція перевіряє вміст директорії міграцій Hasura. Вона гарантує, що в директорії `hasura/migrations` відсутні файли з назвою `down.sql`, оскільки там мають бути лише файли `up.sql` (hasura.mdc).
 
 ## Поведінка

package/rules/hasura/main.mdc

@@ -5,14 +5,4 @@ globs: "**/hasura/**,**/*.env"
 alwaysApply: false
 ---
 
-Правило охоплює: коректність підключення Hasura у CI-середовищі (внутрішній URL кластера), конвенцію іменування k8s-сервісів та структуру директорій міграцій.
-
-[hasura-internal_urls](./js/internal_urls.mdc)
-
-[hasura-svc_hl](./js/svc_hl.mdc)
-
-[hasura-migrations](./js/migrations.mdc)
-
-## Швидкий gate через conftest
-
-[hasura-svc_hl](./policy/svc_hl/svc_hl.mdc)
+Правило охоплює: коректність підключення Hasura у CI-середовищі (внутрішній URL кластера), конвенцію іменування k8s-сервісів та структуру директорій міграцій.

package/rules/image-avif/docs/main.md

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

package/rules/image-avif/main.mdc

@@ -5,12 +5,4 @@ globs: "**/*.{png,jpg,jpeg,gif,avif,vue,html}"
 alwaysApply: false
 ---
 
-Правило забезпечує, що кожне raster-зображення (`png`, `jpg`, `jpeg`, `gif`), на яке посилаються `.vue`/`.html` файли, має AVIF-двійник і що посилання переписані на нього. Генерація, rewrite і cleanup AVIF-сиріт виконуються автоматично через `npx @nitra/cursor fix image-avif`.
-
-[image-avif-avif_generation](./js/avif_generation.mdc)
-
-[image-avif-package_json_optout](./js/package_json_optout.mdc)
-
-## Швидкий gate через conftest
-
-[image-avif-package_json](./policy/package_json/package_json.mdc)
+Правило забезпечує, що кожне raster-зображення (`png`, `jpg`, `jpeg`, `gif`), на яке посилаються `.vue`/`.html` файли, має AVIF-двійник і що посилання переписані на нього. Генерація, rewrite і cleanup AVIF-сиріт виконуються автоматично через `npx @nitra/cursor fix image-avif`.

package/rules/image-compress/docs/main.md

@@ -8,8 +8,6 @@ docgen:
   score: 90
 ---
 
-## Огляд
-
 Модуль забезпечує механізми для виконання та валідації контенту відповідно до визначених правил. Функція `run` виконує перевірку відповідності контенту визначеним критеріям у межах поточного контексту прогону. Функція `lint` виконує виявлення або стиснення зображень залежно від режиму `readOnly`.
 
 ## Поведінка

package/rules/image-compress/js/docs/index.md

@@ -8,5 +8,4 @@ resource: npm/rules/image-compress/js/
 
 | Файл                                  | Тип       |
 | ------------------------------------- | --------- |
-| [lint.mjs](lint.md)                   | JS Module |
 | [package_setup.mjs](package_setup.md) | JS Module |

package/rules/image-compress/main.mdc

@@ -7,12 +7,4 @@ alwaysApply: false
 
 CLI [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image) (≥ **4.0.1**) запускається через `npx` і **не** додається в `dependencies` / `devDependencies`. Запуск — через **`n-cursor lint image-compress`**: локально (fix) виконує `npx @nitra/minify-image --src=. --write`, у `--read-only` виконує `npx @nitra/minify-image --src=. --json` і падає, якщо `summary.needsCompression > 0`. **AVIF-генерація (`--avif`) у `image-compress` не входить** — її виконує окреме правило `image-avif`.
 
-Окремий workflow `lint-image.yml` створювати не треба; якщо потрібен CI-gate для зображень, використовуй `n-cursor lint image-compress --read-only`.
-
-[image-compress-package_setup](./js/package_setup.mdc)
-
-[image-compress-package_json](./js/package_json.mdc)
-
-## Швидкий gate через conftest
-
-[image-compress-package_json](./policy/package_json/package_json.mdc)
+Окремий workflow `lint-image.yml` створювати не треба; якщо потрібен CI-gate для зображень, використовуй `n-cursor lint image-compress --read-only`.

package/rules/js/docs/main.md

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

package/rules/js/js/dep-policy.mjs

@@ -11,7 +11,7 @@ import {
   dynamicImportModule,
   langFromPath,
   requireCallModule,
-  walkAstWithAncestors,
+  walkAstWithAncestors
 } from '../../../scripts/utils/ast-scan-utils.mjs'
 
 const JS_SOURCE_RE = /\.(?:[cm]?[jt]sx?)$/u
@@ -60,9 +60,13 @@ export async function check(cwdParam = process.cwd()) {
   const ignorePaths = await loadCursorIgnorePaths(cwd)
 
   const files = []
-  await walkDir(cwd, p => {
-    if (JS_SOURCE_RE.test(p)) files.push(p)
-  }, ignorePaths)
+  await walkDir(
+    cwd,
+    p => {
+      if (JS_SOURCE_RE.test(p)) files.push(p)
+    },
+    ignorePaths
+  )
 
   let violations = 0
   for (const absPath of files) {

package/rules/js/js/docs/check.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль виконує валідацію конфігураційних файлів, включаючи `package.json`, `.oxlintrc.json`, `knip.json`, `knip-canonical.json` та `.eslintrc.json`. Він перевіряє відповідність структури та конфігурацій встановленим стандартам. (js.mdc) (text.mdc)
 
 ## Поведінка

package/rules/js/js/docs/dep-policy.md

@@ -3,28 +3,26 @@ type: JS Module
 title: dep-policy.mjs
 resource: npm/rules/js/js/dep-policy.mjs
 docgen:
-  crc: 82035584
+  crc: 020620cb
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-## Огляд
-
-Модуль сканує JavaScript та TypeScript файли проєкту для перевірки відповідності політикам залежностей. Він знаходить усі імпорти у файлах і порівнює їх із переліком заборонених специфікаторів. При виявленні порушень політики, вони реєструються. Модуль працює у режимі, що перехоплює помилки (fail-safe), і не кидає винятків назовні. Він є лише для читання (Read-only) і не змінює файлову систему чи бази даних. Результат роботи визначається кодом виходу, що інформує про наявність чи відсутність порушень політики (dep-policy.mdc) та успішну перевірку (js.mdc).
+Модуль сканує файли з розширеннями JS/TS у проєкті. Він перевіряє, чи не містять ці файли імпортів, заборонених відповідно до політики (dep-policy.mdc). Модуль виконує перевірку у режимі лише для читання. У разі виявлення порушень, він реєструє їх у звіті. Модуль перехоплює всі можливі помилки (fail-safe) і не генерує винятків назовні. Результат роботи відображається через код виходу, що інформує про статус перевірки (js.mdc).
 
 ## Поведінка
 
 1. Ініціалізує звітність.
 2. Визначає кореневу директорію проєкту.
-3. Зчитує список шляхів, які слід ігнорувати під час сканування.
-4. Знаходить усі файли з розширеннями JavaScript/TypeScript у кореневій директорії, ігноруючи визначені шляхи.
-5. Для кожного знайденого файлу:
-    а. Зчитує вміст файлу.
-    б. Витягує всі імпортовані специфікатори з вмісту файлу.
-    в. Перевіряє кожен витягнутий специфікатор на відповідність списку заборонених специфікаторів (dep-policy.mdc).
-    г. Якщо специфікатор заборонений, реєструє помилку, вказуючи відносний шлях до файлу та заборонений імпорт. Збільшує лічильник порушень.
+3. Завантажує списки шляхів, які слід ігнорувати.
+4. Збирає список усіх файлів з розширеннями JS/TS у кореневій директорії, ігноруючи визначені шляхи.
+5. Для кожного зібраного файлу:
+   а. Зчитує вміст файлу.
+   б. Витягує з вмісту всі імпортовані специфікатори (статичні, динамічні та через `require`).
+   в. Для кожного витягнутого специфікатора перевіряє, чи він є забороненим відповідно до політики (dep-policy.mdc).
+   г. Якщо специфікатор заборонений, реєструє помилку у звіті, вказуючи шлях до файлу та заборонений імпорт. Збільшує лічильник порушень.
 6. Якщо порушень не знайдено, реєструє повідомлення про успішну перевірку (js.mdc).
-7. Повертає код виходу, що відображає наявність порушень.
+7. Повертає код виходу звіту.
 
 ## Публічний API
 

package/rules/js/js/docs/index.md

@@ -6,10 +6,10 @@ resource: npm/rules/js/js/
 
 # npm/rules/js/js
 
-| Файл | Тип |
-|---|---|
-| [check.mjs](check.md) | JS Module |
-| [dep-policy.mjs](dep-policy.md) | JS Module |
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
+| [check.mjs](check.md)                 | JS Module |
+| [dep-policy.mjs](dep-policy.md)       | JS Module |
 | [lint-findings.mjs](lint-findings.md) | JS Module |
-| [tooling.mjs](tooling.md) | JS Module |
+| [tooling.mjs](tooling.md)             | JS Module |
 | [utils_imports.mjs](utils_imports.md) | JS Module |

package/rules/js/js/docs/tooling.md

@@ -8,8 +8,6 @@ docgen:
   score: 95
 ---
 
-## Огляд
-
 Визначає шляхи до канонічних JSON-файлів для інструментів oxlint та knip через OXLINT_CANONICAL_JSON_PATH та KNIP_CANONICAL_JSON_PATH. Також перевіряє відповідність конфігураційного файлу .oxlintrc.json значенням, встановленим у oxlint-canonical.json, за допомогою verifyOxlintRcAgainstCanonical.
 
 ## Поведінка