@nitra/cursor 12.9.0 → 12.11.0

package/rules/adr/js/hooks.mjs

@@ -55,6 +55,9 @@ function gitignoreLineCoversHookLog(line, logPath) {
   if (line === '.claude/hooks/*.log' || line === '.claude/hooks/**/*.log') {
     return true
   }
+  if (line === '.claude/hooks/*' || line === '.claude/hooks/**') {
+    return true
+  }
   if (line === '*.log' || line === '**/*.log') {
     return true
   }
@@ -264,6 +267,60 @@ function checkLlmCliAvailable(reporter) {
  * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
+/** Файли стану/блокування normalize-хука, які не мають потрапляти в git. */
+const NORMALIZE_STATE_FILES = ['.normalize-state', '.normalize.lock']
+const CLAUDE_HOOKS_REL = '.claude/hooks'
+
+/**
+ * Перевіряє рядок `.gitignore` на покриття конкретного state/lock файлу.
+ * @param {string} line нормалізований (trim) рядок
+ * @param {string} statePath відносний шлях файлу (наприклад `.claude/hooks/.normalize-state`)
+ * @returns {boolean} true — рядок покриває файл
+ */
+function gitignoreLineCoversStatePath(line, statePath) {
+  if (line === statePath) return true
+  // .claude/hooks/* або .claude/hooks/**
+  if (line === `${CLAUDE_HOOKS_REL}/*` || line === `${CLAUDE_HOOKS_REL}/**`) return true
+  return false
+}
+
+/**
+ * Перевіряє `.gitignore` на наявність рядків для файлів стану normalize-хука.
+ * @param {import('../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter
+ * @param {string} cwd корінь репозиторію
+ * @returns {Promise<void>}
+ */
+async function checkGitignoreForStateFiles(reporter, cwd) {
+  const { pass, fail } = reporter
+  const gitignoreAbs = join(cwd, '.gitignore')
+  const content = existsSync(gitignoreAbs) ? await readFile(gitignoreAbs, 'utf8') : ''
+  const lines = content.split(EOL_RE).map(l => l.trim())
+  for (const file of NORMALIZE_STATE_FILES) {
+    const statePath = `${CLAUDE_HOOKS_REL}/${file}`
+    if (lines.some(l => gitignoreLineCoversStatePath(l, statePath))) {
+      pass(`.gitignore покриває ${statePath}`)
+    } else {
+      fail(`.gitignore не ігнорує \`${statePath}\` — додай рядок (adr.mdc)`)
+    }
+  }
+}
+
+/**
+ * Перевіряє наявність каталогу `docs/adr/` — обов'язкового місця зберігання ADR-ів.
+ * @param {import('../../../scripts/lib/check-reporter.mjs').CheckReporter} reporter
+ * @param {string} cwd корінь репозиторію
+ * @returns {void}
+ */
+function checkDocsAdrDir(reporter, cwd) {
+  const { pass, fail } = reporter
+  const adrDir = join(cwd, 'docs', 'adr')
+  if (existsSync(adrDir)) {
+    pass('docs/adr/ існує (каталог ADR-ів)')
+  } else {
+    fail('docs/adr/ відсутній — створи каталог для ADR-ів (adr.mdc)')
+  }
+}
+
 export async function check(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   for (const { scriptName } of HOOK_ARTIFACTS) {
@@ -272,6 +329,8 @@ export async function check(cwd = process.cwd()) {
   checkProjectSettings(reporter, cwd)
   await checkCursorHooks(reporter, cwd)
   await checkGitignore(reporter, cwd)
+  await checkGitignoreForStateFiles(reporter, cwd)
+  checkDocsAdrDir(reporter, cwd)
   checkLlmCliAvailable(reporter)
   return reporter.getExitCode()
 }

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

@@ -1,5 +1,7 @@
 /** @see ./docs/consistency.md */
 import { execFile } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { promisify } from 'node:util'
 
@@ -379,6 +381,46 @@ function createDefaultGetPublishedVersion() {
  * @param {(msg: string) => void} pass параметр
  * @param {(msg: string) => void} fail параметр
  */
+/**
+ * Перевіряє наявність `CHANGELOG.md` у воркспейсі.
+ * @param {string} ws відносний шлях воркспейсу від кореня репо
+ * @param {string} label мітка для повідомлень
+ * @param {string} cwd корінь репозиторію
+ * @param {(msg: string) => void} pass
+ * @param {(msg: string) => void} fail
+ * @returns {boolean} true — файл існує
+ */
+function checkChangelogFileExists(ws, label, cwd, pass, fail) {
+  const path = join(cwd, ws, 'CHANGELOG.md')
+  if (existsSync(path)) {
+    pass(`${label}: CHANGELOG.md існує`)
+    return true
+  }
+  fail(`${label}: CHANGELOG.md відсутній — створи файл за форматом Keep a Changelog (n-changelog.mdc)`)
+  return false
+}
+
+/**
+ * Перевіряє базовий формат `CHANGELOG.md`: наявність H1 `# Changelog`.
+ * Версійні секції `## [x.y.z]` не вимагаються для нових workspace-ів без релізів.
+ * @param {string} ws відносний шлях воркспейсу від кореня репо
+ * @param {string} label мітка для повідомлень
+ * @param {string} cwd корінь репозиторію
+ * @param {(msg: string) => void} pass
+ * @param {(msg: string) => void} fail
+ * @returns {Promise<void>}
+ */
+async function checkChangelogFormat(ws, label, cwd, pass, fail) {
+  const path = join(cwd, ws, 'CHANGELOG.md')
+  const content = await readFile(path, 'utf8')
+  const hasH1 = content.split('\n').some(l => l.trimEnd() === '# Changelog')
+  if (hasH1) {
+    pass(`${label}: CHANGELOG.md має рядок "# Changelog"`)
+  } else {
+    fail(`${label}: CHANGELOG.md не має рядка "# Changelog" — перший рядок має бути H1-заголовком (n-changelog.mdc)`)
+  }
+}
+
 function checkNpmFilesArrayContainsChangelog(manifest, pass, fail) {
   if (manifest.kind !== 'npm' || !manifest.npmFiles) return
   const pkgPath = manifestFilePath(manifest.ws, manifest)
@@ -406,7 +448,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)`
   )
 }
@@ -542,6 +584,10 @@ async function checkPublishedWorkspacePendingGitChanges(manifest, _Vcurrent, sub
 async function checkPublishedWorkspace(manifest, subWorkspaces, getPublishedVersion, autofix, pass, fail, cwd) {
   const label = workspaceLabel(manifest)
   const mf = manifestFilePath(manifest.ws, manifest)
+  const changelogExists = checkChangelogFileExists(manifest.ws, label, cwd, pass, fail)
+  if (changelogExists) {
+    await checkChangelogFormat(manifest.ws, label, cwd, pass, fail)
+  }
   const Vcurrent = manifest.version
   if (!Vcurrent) {
     fail(`${label}: у ${mf} відсутнє поле version (registry-published воркспейс)`)
@@ -574,7 +620,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 +659,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
   }
@@ -635,6 +681,14 @@ async function checkLocalOnlyChangedWorkspace(comparisonRef, manifest, baseLabel
 async function runLocalOnlyChecks(localOnly, subWorkspaces, autofix, pass, fail, cwd) {
   if (localOnly.length === 0) return
 
+  for (const manifest of localOnly) {
+    const label = workspaceLabel(manifest)
+    const exists = checkChangelogFileExists(manifest.ws, label, cwd, pass, fail)
+    if (exists) {
+      await checkChangelogFormat(manifest.ws, label, cwd, pass, fail)
+    }
+  }
+
   if (!(await isInsideGitRepo(cwd))) {
     pass('changelog: не git-репозиторій — local-only перевірку пропущено')
     return

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

@@ -3,36 +3,38 @@ type: JS Module
 title: consistency.mjs
 resource: npm/rules/changelog/js/consistency.mjs
 docgen:
-  crc: eaf98d6d
-  score: 100
+  crc: a9bebf31
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 95
 ---
 
-Перевіряє версіонування проектів у монорепозиторії, порівнюючи версії, зазначені в маніфестах, з даними, отриманими з мережі з https://pypi.org/pypi/. Аналізує відповідність версій встановленим правилам, визначеним у конфігурації res.json. Визначає, чи відповідають версії формату, а також перевіряє наявність змін, порівнюючи їх із даними, описаними у (n-changelog.mdc). При невдачі перевірки повертає false/null, не кидаючи винятків.
+## Огляд
+
+Модуль сканує монорепозиторій, ідентифікує проєкти та порівнює їхні версії з даними, отриманими з https://pypi.org/pypi/, для верифікації відповідності версій. Для проєктів, що не призначені для публікації, виконуються локальні перевірки на відповідність файлу `CHANGELOG.md` конфігурації, визначеній у res.json.
 
 ## Поведінка
 
-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. Для кожного проєкту, що може бути опублікованим, `check` перевіряє його відповідність вимогам:
+    а. Перевіряє наявність файлу `CHANGELOG.md`.
+    б. Перевіряє базовий формат `CHANGELOG.md` на наявність заголовка `# Changelog`.
+    в. Якщо проєкт має поле `version` у маніфесті, `check` порівнює його з опублікованою версією, отриманою через мережевий запит до https://pypi.org/pypi/ або `npm view`.
+    г. Якщо версія у проєкті випереджає опубліковану, `check` повідомляє про заборонений ручний bump.
+    д. Якщо версія у проєкті відстає від опублікованої, `check` повідомляє про відставання локальної копії від реєстру.
+    е. Якщо версії збігаються, `check` перевіряє, чи є незрелі зміни у проєкті відносно базового релізу.
+    ж. Якщо проєкт має незрелі зміни, `check` перевіряє наявність change-файлу. Якщо його немає, `check` або повідомляє про необхідність створити його (якщо не в режимі autofix), або автоматично створює його та додає до індексу.
+6. `check` виконує локальні перевірки для проєктів, які не призначені для публікації:
+    а. Для кожного локального проєкту `check` перевіряє наявність файлу `CHANGELOG.md` та його формат.
+    б. `check` визначає точку порівняння (базу) на основі поточної гілки.
+    в. `check` перевіряє, чи є релевантні зміни у проєкті відносно цієї бази.
+    г. Якщо зміни є, `check` перевіряє наявність change-файлу. Якщо його немає, `check` або повідомляє про необхідність створити його (якщо не в режимі autofix), або автоматично створює його та додає до індексу.
+7. `check` повертає кінцевий код завершення, що відображає результати всіх перевірок.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
+- Read-only: не виконує операцій запису (ФС/БД).
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдалої перевірки повертає `false`/`null` замість винятку.
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

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

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

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 |