@nitra/cursor 1.9.21 → 1.10.0

package/{scripts/run-k8s.mjs → rules/k8s/js/run.mjs}

@@ -15,10 +15,10 @@
 import { spawnSync } from 'node:child_process'
 import { basename, dirname, relative } from 'node:path'
 
-import { isRunAsCli } from './cli-entry.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const PATH_SEPARATOR_RE = /[/\\]/u
 const YAML_EXT_RE = /\.yaml$/iu

package/rules/nginx-default-tpl/auto.md

@@ -0,0 +1 @@
+якщо присутній хоч один файл з переліку - default.conf.template, default.conf, nginx.conf

package/{scripts/check-nginx-default-tpl.mjs → rules/nginx-default-tpl/js/check.mjs}

@@ -17,11 +17,11 @@ import { existsSync } from 'node:fs'
 import { readdir, readFile, rename, unlink, writeFile } from 'node:fs/promises'
 import { basename, dirname, join, relative } from 'node:path'
 
-import { findDockerfilePaths } from './check-docker.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { findDockerfilePaths } from '../../docker/js/check.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const LINE_SPLIT_RE = /\r?\n/u
 const INI_KEY_RE = /^([A-Za-z_]\w*)\s*=/u
@@ -363,7 +363,7 @@ function checkVscodeNginx(passFn, failFn) {
   const extPath = '.vscode/extensions.json'
   if (existsSync(extPath)) {
     const violations = runConftestBatch({
-      policyDirRel: 'nginx_default_tpl/vscode_extensions',
+      policyDirRel: 'nginx-default-tpl/vscode_extensions',
       namespace: 'nginx_default_tpl.vscode_extensions',
       files: [extPath]
     })
@@ -382,7 +382,7 @@ function checkVscodeNginx(passFn, failFn) {
     return
   }
   const violations = runConftestBatch({
-    policyDirRel: 'nginx_default_tpl/vscode_settings',
+    policyDirRel: 'nginx-default-tpl/vscode_settings',
     namespace: 'nginx_default_tpl.vscode_settings',
     files: [setPath]
   })

package/rules/npm-module/auto.md

@@ -0,0 +1 @@
+якщо в корені присутня директорія npm

package/{scripts/check-npm-module.mjs → rules/npm-module/js/check.mjs}

@@ -32,10 +32,10 @@ import { promisify } from 'node:util'
 
 import { parseSync } from 'oxc-parser'
 
-import { dynamicImportModule, langFromPath, requireCallModule, walkAstWithAncestors } from './utils/ast-scan-utils.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { dynamicImportModule, langFromPath, requireCallModule, walkAstWithAncestors } from '../../../scripts/utils/ast-scan-utils.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 const execFileAsync = promisify(execFile)
 

package/rules/php/auto.md

@@ -0,0 +1 @@
+якщо в корені є composer.json

package/{scripts/check-php.mjs → rules/php/js/check.mjs}

@@ -11,7 +11,7 @@
  */
 import { existsSync } from 'node:fs'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 /**
  * Перевіряє відповідність проєкту правилам php.mdc.

package/{scripts/run-php.mjs → rules/php/js/run.mjs}

@@ -12,9 +12,9 @@ import { spawnSync } from 'node:child_process'
 import { existsSync, statSync } from 'node:fs'
 import { join, resolve } from 'node:path'
 
-import { isRunAsCli } from './cli-entry.mjs'
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
+import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
 
 const PHPCS_CODE_DIR_CANDIDATES = ['app', 'src', 'lib', 'public', 'www']
 

package/rules/rego/auto.md

@@ -0,0 +1 @@
+якщо в проекті є хоч один rego

package/{scripts/check-rego.mjs → rules/rego/js/check.mjs}

@@ -25,10 +25,10 @@
  */
 import { existsSync } from 'node:fs'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
-import { walkDir } from './utils/walkDir.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 /** Список (path, namespace, policyDirRel) для трьох канонічних конфігів rego.mdc. */
 const REGO_TARGETS = [

package/{scripts/lint-rego.mjs → rules/rego/js/lint.mjs}

@@ -26,7 +26,7 @@ import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { resolve } from 'node:path'
 
-import { resolveCmd } from './utils/resolve-cmd.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
 
 /** Шляхи з Rego-полісі (відносно cwd). Існують не всі на ранніх стадіях — фільтруємо нижче. */
 const LINT_TARGETS = ['npm/policy']

package/rules/style-lint/auto.md

@@ -0,0 +1 @@
+якщо присутній хоч один vue або css файл

package/{scripts/check-style-lint.mjs → rules/style-lint/js/check.mjs}

@@ -19,7 +19,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 
 /**
  * Альтернатива полю `stylelint` у `package.json` — зовнішній файл конфігу. Якщо

package/rules/tauri/auto.md

@@ -0,0 +1 @@
+якщо в хоч в package.json в секції dependencies присутній пакет @tauri-apps/api

package/{scripts/check-tauri.mjs → rules/tauri/js/check.mjs}

@@ -18,8 +18,8 @@
 import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { runConftestBatch } from './utils/run-conftest-batch.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
 
 /**
  * Чи є префікс `@tauri-apps/` у ключах `dependencies` або `devDependencies`.

package/rules/text/auto.md

@@ -0,0 +1 @@
+завжди

package/{scripts/check-text.mjs → rules/text/js/check.mjs}

@@ -32,8 +32,8 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
-import { anyRunStepIncludes, parseWorkflowYaml } from './utils/gha-workflow.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { anyRunStepIncludes, parseWorkflowYaml } from '../../../scripts/utils/gha-workflow.mjs'
 
 /** Заголовок абзацу про апостроф у text.mdc / n-text.mdc. */
 const UK_APOSTROPHE_HEADING = '**Український апостроф:**'

package/{scripts/run-shellcheck-text.mjs → rules/text/js/run-shellcheck.mjs}

@@ -19,8 +19,8 @@ import { spawnSync } from 'node:child_process'
 import { globSync } from 'node:fs'
 import { resolve } from 'node:path'
 
-import { isRunAsCli } from './cli-entry.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
+import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
 
 /** Підрядок у stderr ShellCheck, коли є зауваження, але без авто-виправлення у форматі diff. */
 const NON_AUTOFIXABLE_HINT = 'none were auto-fixable'

package/{scripts → rules/text/js}/run-v8r.mjs

@@ -18,8 +18,8 @@ import { existsSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
-import { isRunAsCli } from './cli-entry.mjs'
-import { resolveCmd } from './utils/resolve-cmd.mjs'
+import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
 
 /** Типові glob-и для форматів, які обробляє v8r (див. опис CLI v8r). */
 export const DEFAULT_V8R_GLOBS = ['**/*.json', '**/*.json5', '**/*.yml', '**/*.yaml', '**/*.toml']

package/{mdc → rules/text}/text.mdc

@@ -296,6 +296,10 @@ jobs:
 
 Якщо потрібна мова вже є в залежностях **`@nitra/cspell-dict`** — додай лише код у **`language`**, без окремих **`@cspell/dict-*`** у споживачі. Якщо мови немає в корпоративному пакеті — розширюй **`@nitra/cspell-dict`**, а не підключай **`@cspell/dict-*`** у корені репозиторію-споживача. Огляд upstream-словників: [streetsidesoftware/cspell-dicts](https://github.com/streetsidesoftware/cspell-dicts).
 
+## Найменування каталогів
+
+kebab-case
+
 ## Перевірка
 
 `npx @nitra/cursor check text` (охоплює oxfmt, cspell, shellcheck у `lint-text`, markdownlint, v8r, CI для `lint-text`)

package/rules/vue/auto.md

@@ -0,0 +1 @@
+якщо присутній хоч один vue файл

package/{scripts/check-vue.mjs → rules/vue/js/check.mjs}

@@ -21,16 +21,16 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from './utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
 import {
   findForbiddenNodeImportsInVueFile,
   findForbiddenVueImportsInSourceFile,
   isVueImportScanSourceFile,
   shouldSkipFileForVueImportScan
-} from './utils/vue-forbidden-imports.mjs'
-import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import { walkDir } from './utils/walkDir.mjs'
-import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
+} from '../../../scripts/utils/vue-forbidden-imports.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
 
 const ESBUILD_RE = /\besbuild\b/
 

package/scripts/auto-rules.mjs

@@ -1,5 +1,5 @@
 /**
- * Автовизначення правил для `.n-cursor.json` за умовами з `npm/bin/auto-rules.md`.
+ * Автовизначення правил для `.n-cursor.json` за умовами з `npm/rules/<rule>/auto.md`.
  *
  * Модуль аналізує дерево проєкту (наявність файлів/директорій, `gql\`...\`` у source,
  * залежності `mssql` / `pg` / `pg-format` / `mysql2` / `ioredis` / `node-redis` у `package.json`,
@@ -8,7 +8,7 @@
  *
  * Враховує винятки `disable-rules`: елементи зі списку не додаються автоматично.
  *
- * Автодетект скілів — у `./auto-skills.mjs` (умови — у `npm/bin/auto-skills.md`).
+ * Автодетект скілів — у `./auto-skills.mjs` (умови — у `npm/skills/<skill>/auto.md`).
  * `mergeConfigWithAutoDetected` нижче приймає вже виявлені rules і skills і вливає
  * їх у конфіг із поправкою на legacy-id (`migrateRuleIds`).
  */
@@ -24,7 +24,7 @@ import {
 } from './utils/graphql-gql-scan.mjs'
 import { contentForVueImportScan } from './utils/vue-forbidden-imports.mjs'
 
-/** Порядок автододавання правил відповідно до `auto-rules.md`. */
+/** Порядок автододавання правил відповідно до `rules/<rule>/auto.md`. */
 export const AUTO_RULE_ORDER = Object.freeze([
   'abie',
   'bun',
@@ -91,7 +91,7 @@ export function detectLegacyRuleIds(ids) {
 }
 
 /**
- * Граф залежностей між правилами (`auto-rules.md` синтаксис `rule - [other]`).
+ * Граф залежностей між правилами (`rules/<rule>/auto.md` синтаксис `rule - [other]`).
  * Ключ варто автододати, коли всі правила-залежності вже додані до конфігу — щоб
  * не дублювати вихідну умову, достатньо описати її у залежності.
  */
@@ -576,7 +576,7 @@ function resolveRuleDependencies(detectedRules, addRule) {
 }
 
 /**
- * Визначає авто-правила згідно з `auto-rules.md`.
+ * Визначає авто-правила згідно з `rules/<rule>/auto.md`.
  * @param {object} params параметри аналізу
  * @param {string} params.root абсолютний шлях до кореня репозиторію
  * @param {string[]} params.availableRules перелік доступних правил з пакету

package/scripts/auto-skills.mjs

@@ -1,5 +1,5 @@
 /**
- * Автовизначення skills для `.n-cursor.json` за умовами з `npm/bin/auto-skills.md`.
+ * Автовизначення skills для `.n-cursor.json` за умовами з `npm/skills/<skill>/auto.md`.
  *
  * Скіли автододаються залежно від уже виявлених правил (auto-rules) — щоб не дублювати
  * умови, які вже формалізовані для відповідного правила. Наприклад:
@@ -7,13 +7,14 @@
  * - `abie-kustomize - [abie]` — додається разом з правилом `abie`
  * - `taze - [bun]` — додається разом з правилом `bun`
  *
- * Скіли без секції `[rules]` у `auto-skills.md` (`fix`, `lint`, `llm-patch`, `publish-telegram`)
+ * Скіли без секції `[rules]` у `skills/<skill>/auto.md` (`fix`, `lint`, `llm-patch`, `publish-telegram`)
  * додаються завжди, якщо доступні в пакеті й не у `disable-skills`.
  */
 
-/** Порядок автододавання skills відповідно до `auto-skills.md`. */
+/** Порядок автододавання skills відповідно до `skills/<skill>/auto.md`. */
 export const AUTO_SKILL_ORDER = Object.freeze([
   'abie-kustomize',
+  'adr-normalize',
   'fix',
   'lint',
   'llm-patch',
@@ -22,23 +23,24 @@ export const AUTO_SKILL_ORDER = Object.freeze([
 ])
 
 /**
- * Залежність скілів від правил (`auto-skills.md` синтаксис `skill - [rules]`).
+ * Залежність скілів від правил (`skills/<skill>/auto.md` синтаксис `skill - [rules]`).
  * Ключ варто автододати, коли всі правила-залежності вже додані до конфігу автодетектом.
  */
 export const AUTO_SKILL_RULE_DEPENDENCIES = Object.freeze(
   /** @type {Record<string, readonly string[]>} */ ({
     'abie-kustomize': Object.freeze(['abie']),
+    'adr-normalize': Object.freeze(['adr']),
     taze: Object.freeze(['bun'])
   })
 )
 
-/** Скіли без залежностей — додаються завжди (рядок «завжди» в `auto-skills.md`). */
+/** Скіли без залежностей — додаються завжди (рядок «завжди» в `skills/<skill>/auto.md`). */
 const ALWAYS_ON_SKILLS = Object.freeze(['fix', 'lint', 'llm-patch', 'publish-telegram'])
 
 const DEFAULT_DISABLED_LIST = Object.freeze([])
 
 /**
- * Визначає авто-skills згідно з `auto-skills.md`.
+ * Визначає авто-skills згідно з `skills/<skill>/auto.md`.
  * @param {object} params параметри
  * @param {string[]} params.availableSkills перелік доступних skills із пакету (id без префікса n-)
  * @param {string[]} params.detectedRules id правил, виявлених auto-rules (вхідні залежності)

package/scripts/lint-conftest.mjs

@@ -1,17 +1,17 @@
 /**
- * Прогоняє `conftest test` по всіх Rego-полісі з `npm/policy/` (окрім `ga/*`,
- * які вже виконуються через `lint-ga.mjs`).
+ * Прогоняє `conftest test` по всіх Rego-полісі з `npm/rules/<rule>/policy/` (окрім `ga/*`,
+ * які вже виконуються через `npm/rules/ga/js/lint.mjs`).
  *
- * Кожна полісі має свій namespace, опційний `rule` (id у `.n-cursor.json:rules`,
- * інакше таргет пропускається — як гейтинг у `check-*.mjs`), і список цільових
+ * Кожна полісі має свій namespace, обов'язковий `rule` (id у `.n-cursor.json:rules`,
+ * інакше таргет пропускається — як гейтинг у `check.mjs`), і список цільових
  * файлів — single-file або walk-предикат для дерева. Якщо цільових файлів немає
  * або правило не активне — таргет мовчки пропускається.
  *
  * Поведінка fallback:
  *  - якщо `conftest` не в `PATH` — друкуємо `ℹ` повідомлення з підказкою
- *    встановлення і повертаємо 0 (структурні JS-перевірки в `check-*.mjs`
- *    лишаються паралельно). Те саме рішення — у `lint-ga.mjs`.
- *  - якщо `npm/policy/` не існує (нетипова інсталяція) — також `ℹ` skip.
+ *    встановлення і повертаємо 0 (структурні JS-перевірки в `check.mjs`
+ *    лишаються паралельно). Те саме рішення — у `rules/ga/js/lint.mjs`.
+ *  - якщо `npm/rules/` не існує (нетипова інсталяція) — також `ℹ` skip.
  *
  * Перший ненульовий exit-код conftest — повертаємо як результат, але всі
  * наступні таргети все одно виконуємо, щоб одразу побачити повний список
@@ -27,11 +27,11 @@ import { fileURLToPath } from 'node:url'
 
 import { resolveCmd } from './utils/resolve-cmd.mjs'
 
-/** Каталог пакету `@nitra/cursor`, від якого ресолвимо вшиту директорію policy/. */
+/** Каталог пакету `@nitra/cursor`, від якого ресолвимо вшиті директорії правил. */
 const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
 
-/** Шлях до кореня Rego-полісі. У npm-tarball публікується через `files: ["policy"]`. */
-const POLICY_DIR = join(PACKAGE_ROOT, 'policy')
+/** Шлях до кореня правил. У npm-tarball публікується через `files: ["rules"]`. Кожне правило: `rules/<id>/policy/`. */
+const RULES_DIR = join(PACKAGE_ROOT, 'rules')
 
 /**
  * Опис одного таргета: namespace + спосіб розвʼязати цільові файли.
@@ -438,7 +438,7 @@ function resolveTargetFiles(target, cwd) {
  * @returns {number} exit-код
  */
 function runConftestForTarget(conftestBin, target, files) {
-  const policyAbs = join(POLICY_DIR, target.policyDir)
+  const policyAbs = join(RULES_DIR, target.rule, 'policy')
   if (!existsSync(policyAbs)) {
     return 0
   }
@@ -471,8 +471,8 @@ export function runLintConftestCli() {
     )
     return 0
   }
-  if (!existsSync(POLICY_DIR)) {
-    console.log(`ℹ Каталог Rego-полісі не знайдено (${POLICY_DIR}) — пропускаю conftest.`)
+  if (!existsSync(RULES_DIR)) {
+    console.log(`ℹ Каталог правил не знайдено (${RULES_DIR}) — пропускаю conftest.`)
     return 0
   }
 

package/scripts/sync-claude-config.mjs

@@ -10,10 +10,12 @@
  * - `npm/CLAUDE.md` — **fully owned**: завжди перезаписується; пропускається,
  *   якщо в проєкті немає каталогу `npm/`.
  * - `.claude/commands/n-check.md` — fully owned slash-команда.
- * - `.claude/hooks/capture-decisions.sh` — fully owned bash-скрипт ADR Stop-hook;
+ * - `.claude/hooks/capture-decisions.sh` — fully owned bash-скрипт ADR capture Stop-hook;
  *   копіюється з `.claude-template/hooks/`, лише коли в `.n-cursor.json` `rules`
  *   присутнє `adr` (правило вмикається вручну). Якщо правила немає, керована
  *   ADR-група в hooks так само автоматично прибирається з settings.json.
+ * - `.claude/hooks/normalize-decisions.sh` — fully owned bash-скрипт ADR normalize
+ *   Stop-hook (батч-нормалізація чернеток); умови — ті самі, що для `capture`.
  *
  * Опт-аут — `claude-config: false` у `.n-cursor.json`.
  */
@@ -23,20 +25,27 @@ import { join } from 'node:path'
 
 /** Маркер lint Stop-hook'а (`npx --no \@nitra/cursor stop-hook`). */
 export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor stop-hook'
-/** Маркер ADR Stop-hook'а — підрядок шляху до bash-скрипта. */
+/** Маркер ADR Stop-hook'а — підрядок шляху до bash-скрипта capture-decisions. */
 export const ADR_HOOK_COMMAND_MARKER = '.claude/hooks/capture-decisions.sh'
+/** Маркер ADR Stop-hook'а — підрядок шляху до bash-скрипта normalize-decisions. */
+export const ADR_NORMALIZE_HOOK_COMMAND_MARKER = '.claude/hooks/normalize-decisions.sh'
 /** Усі маркери managed-hook'ів пакета — за ними відрізняємо свої записи від користувацьких. */
-export const MANAGED_HOOK_COMMAND_MARKERS = Object.freeze([MANAGED_HOOK_COMMAND_MARKER, ADR_HOOK_COMMAND_MARKER])
+export const MANAGED_HOOK_COMMAND_MARKERS = Object.freeze([
+  MANAGED_HOOK_COMMAND_MARKER,
+  ADR_HOOK_COMMAND_MARKER,
+  ADR_NORMALIZE_HOOK_COMMAND_MARKER
+])
 
 const CLAUDE_DIR = '.claude'
 const CLAUDE_SETTINGS_FILE = `${CLAUDE_DIR}/settings.json`
 const CLAUDE_COMMANDS_DIR = `${CLAUDE_DIR}/commands`
 const CLAUDE_HOOKS_DIR = `${CLAUDE_DIR}/hooks`
 const ADR_HOOK_SCRIPT_NAME = 'capture-decisions.sh'
+const ADR_NORMALIZE_HOOK_SCRIPT_NAME = 'normalize-decisions.sh'
 const NPM_CLAUDE_MD_FILE = 'npm/CLAUDE.md'
 const TEMPLATE_DIR_NAME = '.claude-template'
 
-/** Канонічна група hooks для ADR Stop-hook'а — додається в settings, коли `adr` у `rules`. */
+/** Канонічна група hooks для ADR capture Stop-hook'а — додається в settings, коли `adr` у `rules`. */
 const ADR_STOP_HOOK_GROUP = Object.freeze({
   matcher: '',
   hooks: Object.freeze([
@@ -49,6 +58,19 @@ const ADR_STOP_HOOK_GROUP = Object.freeze({
   ])
 })
 
+/** Канонічна група hooks для ADR normalize Stop-hook'а — батч-нормалізація чернеток у `docs/adr/`. */
+const ADR_NORMALIZE_STOP_HOOK_GROUP = Object.freeze({
+  matcher: '',
+  hooks: Object.freeze([
+    Object.freeze({
+      type: 'command',
+      command: `bash "$CLAUDE_PROJECT_DIR/${ADR_NORMALIZE_HOOK_COMMAND_MARKER}"`,
+      async: true,
+      timeout: 600
+    })
+  ])
+})
+
 /**
  * @typedef {object} HookEntry
  * @property {string} type тип hook'а у форматі Claude Code (зазвичай `'command'`)
@@ -140,7 +162,11 @@ function templateWithAdrHook(template) {
   for (const [event, groups] of Object.entries(template.hooks ?? {})) {
     hooks[event] = Array.isArray(groups) ? [...groups] : []
   }
-  hooks.Stop = [...(hooks.Stop ?? []), /** @type {HookGroup} */ (ADR_STOP_HOOK_GROUP)]
+  hooks.Stop = [
+    ...(hooks.Stop ?? []),
+    /** @type {HookGroup} */ (ADR_STOP_HOOK_GROUP),
+    /** @type {HookGroup} */ (ADR_NORMALIZE_STOP_HOOK_GROUP)
+  ]
   return { ...template, hooks }
 }
 
@@ -209,24 +235,45 @@ export async function syncClaudeSettings(projectRoot, templateDir, options = {})
 }
 
 /**
- * Копіює канонічний `.claude/hooks/capture-decisions.sh` з темплейту пакета.
+ * Копіює один канонічний bash-скрипт hook'а з темплейту пакета у `.claude/hooks/`.
  * Файл повністю керується пакетом — на кожен sync перезаписується (як setup-bun-deps).
  * @param {string} projectRoot корінь проєкту, куди писати
  * @param {string} templateDir каталог `.claude-template/` усередині пакету
+ * @param {string} scriptName базове ім'я скрипта (наприклад `capture-decisions.sh`)
  * @returns {Promise<{ written: boolean, path: string }>} результат: чи писали файл, та його відносний шлях
  */
-export async function syncAdrHookScript(projectRoot, templateDir) {
-  const templatePath = join(templateDir, 'hooks', ADR_HOOK_SCRIPT_NAME)
+async function syncHookScript(projectRoot, templateDir, scriptName) {
+  const templatePath = join(templateDir, 'hooks', scriptName)
   if (!existsSync(templatePath)) {
     return { written: false, path: '' }
   }
   const content = await readFile(templatePath, 'utf8')
   const hooksDir = join(projectRoot, CLAUDE_HOOKS_DIR)
   await mkdir(hooksDir, { recursive: true })
-  const destPath = join(hooksDir, ADR_HOOK_SCRIPT_NAME)
+  const destPath = join(hooksDir, scriptName)
   await writeFile(destPath, content, 'utf8')
   await chmod(destPath, 0o755)
-  return { written: true, path: `${CLAUDE_HOOKS_DIR}/${ADR_HOOK_SCRIPT_NAME}` }
+  return { written: true, path: `${CLAUDE_HOOKS_DIR}/${scriptName}` }
+}
+
+/**
+ * Копіює канонічний `.claude/hooks/capture-decisions.sh` з темплейту пакета.
+ * @param {string} projectRoot корінь проєкту, куди писати
+ * @param {string} templateDir каталог `.claude-template/` усередині пакету
+ * @returns {Promise<{ written: boolean, path: string }>} результат: чи писали файл, та його відносний шлях
+ */
+export function syncAdrHookScript(projectRoot, templateDir) {
+  return syncHookScript(projectRoot, templateDir, ADR_HOOK_SCRIPT_NAME)
+}
+
+/**
+ * Копіює канонічний `.claude/hooks/normalize-decisions.sh` з темплейту пакета.
+ * @param {string} projectRoot корінь проєкту, куди писати
+ * @param {string} templateDir каталог `.claude-template/` усередині пакету
+ * @returns {Promise<{ written: boolean, path: string }>} результат: чи писали файл, та його відносний шлях
+ */
+export function syncAdrNormalizeHookScript(projectRoot, templateDir) {
+  return syncHookScript(projectRoot, templateDir, ADR_NORMALIZE_HOOK_SCRIPT_NAME)
 }
 
 /**
@@ -283,20 +330,29 @@ export async function syncClaudeCommands(projectRoot, templateDir) {
  * @param {string} options.bundledPackageRoot корінь установленого `@nitra/cursor`
  * @param {boolean} options.enabled чи увімкнено sync (з `.n-cursor.json` `claude-config`)
  * @param {string[]} [options.rules] список увімкнених правил із `.n-cursor.json` — впливає на ADR Stop-hook (`adr`)
- * @returns {Promise<{ settings: boolean, npmClaudeMd: boolean, commands: string[], adrHook: boolean }>} прапорці записів settings/CLAUDE.md/ADR-hook та список записаних slash-команд
+ * @returns {Promise<{ settings: boolean, npmClaudeMd: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean }>} прапорці записів settings/CLAUDE.md/ADR-hook(s) та список записаних slash-команд
  */
 export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enabled, rules = [] }) {
   if (!enabled) {
-    return { settings: false, npmClaudeMd: false, commands: [], adrHook: false }
+    return { settings: false, npmClaudeMd: false, commands: [], adrHook: false, adrNormalizeHook: false }
   }
   const templateDir = join(bundledPackageRoot, TEMPLATE_DIR_NAME)
   if (!existsSync(templateDir)) {
-    return { settings: false, npmClaudeMd: false, commands: [], adrHook: false }
+    return { settings: false, npmClaudeMd: false, commands: [], adrHook: false, adrNormalizeHook: false }
   }
   const includeAdrHook = Array.isArray(rules) && rules.includes('adr')
   const adrHook = includeAdrHook ? await syncAdrHookScript(projectRoot, templateDir) : { written: false, path: '' }
+  const adrNormalizeHook = includeAdrHook
+    ? await syncAdrNormalizeHookScript(projectRoot, templateDir)
+    : { written: false, path: '' }
   const settings = await syncClaudeSettings(projectRoot, templateDir, { includeAdrHook })
   const npmClaudeMd = await syncNpmClaudeMd(projectRoot, templateDir)
   const commands = await syncClaudeCommands(projectRoot, templateDir)
-  return { settings: settings.written, npmClaudeMd: npmClaudeMd.written, commands, adrHook: adrHook.written }
+  return {
+    settings: settings.written,
+    npmClaudeMd: npmClaudeMd.written,
+    commands,
+    adrHook: adrHook.written,
+    adrNormalizeHook: adrNormalizeHook.written
+  }
 }

package/scripts/utils/run-conftest-batch.mjs

@@ -21,11 +21,11 @@ import { fileURLToPath } from 'node:url'
 
 import { resolveCmd } from './resolve-cmd.mjs'
 
-/** Каталог пакета `@nitra/cursor`, від якого ресолвимо вшиту директорію `policy/`. */
+/** Каталог пакета `@nitra/cursor`, від якого ресолвимо вшиті директорії правил. */
 const PACKAGE_ROOT = dirname(dirname(dirname(fileURLToPath(import.meta.url))))
 
-/** Шлях до кореня rego-полісі. У npm-tarball публікується через `files: ["policy"]`. */
-const POLICY_ROOT = join(PACKAGE_ROOT, 'policy')
+/** Шлях до кореня правил. У npm-tarball публікується через `files: ["rules"]`. Кожне правило: `rules/<id>/policy/<name>/`. */
+const RULES_ROOT = join(PACKAGE_ROOT, 'rules')
 
 /**
  * Друкує install-hint для conftest і кидає виняток, щоб викликана `check-*`
@@ -72,7 +72,12 @@ export function runConftestBatch(opts) {
   if (!conftestBin) {
     failConftestMissing()
   }
-  const policyAbs = join(POLICY_ROOT, opts.policyDirRel)
+  // policyDirRel — формат `<rule>/<name>` (наприклад `abie/base_deployment_preem`).
+  // Реальний шлях у новій структурі: `rules/<rule>/policy/<name>`.
+  const slash = opts.policyDirRel.indexOf('/')
+  const ruleId = slash === -1 ? opts.policyDirRel : opts.policyDirRel.slice(0, slash)
+  const sub = slash === -1 ? '' : opts.policyDirRel.slice(slash + 1)
+  const policyAbs = sub ? join(RULES_ROOT, ruleId, 'policy', sub) : join(RULES_ROOT, ruleId, 'policy')
   if (!existsSync(policyAbs)) {
     throw new Error(`runConftestBatch: rego-каталог не знайдено: ${policyAbs}`)
   }

package/skills/abie-clean/auto.md

@@ -0,0 +1 @@
+[abie]

package/skills/abie-kustomize/auto.md

@@ -0,0 +1 @@
+[abie]