@nitra/cursor 1.11.0 → 1.11.3

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.11.3] - 2026-05-15
+
+### Fixed
+
+- **`npm/bin/n-cursor.js`** — `detectAutoSkills` тепер отримує **ефективний** список правил (опт-ін вручну з `.n-cursor.json:rules` ∪ auto-detected, мінус `disable-rules`), а не лише auto-detected. Без цього скіли із залежністю на правило, додане вручну (наприклад, `adr` без `auto.md`-умови), не активувалися — у репо з `"rules": ["adr", …]` скіл `adr-normalize` залишався відсутнім, попри `[adr]` у його `skills/adr-normalize/auto.md`. Тепер `adr-normalize`, `abie-clean`, `abie-kustomize`, `taze` авто-додаються коректно як при auto-detected, так і при manual-opt-in відповідних правил.
+
+## [1.11.2] - 2026-05-15
+
+### Fixed
+
+- **`npm/scripts/auto-skills.mjs`** — джерело правди для автоактивації скілів тепер `skills/<skill>/auto.md`, а не hardcoded мапа в JS. Парсер розпізнає три формати: `завжди` (always-on), `[rule, rule, …]` (умова на правила), відсутній/нерозпізнаний файл (opt-in). Експортовані константи `AUTO_SKILL_ORDER` та `AUTO_SKILL_RULE_DEPENDENCIES` тепер похідні від сканування `npm/skills/` під час завантаження модуля (зберігаються для зворотної сумісності). Побічно виправлено пропуск `abie-clean` у hardcoded мапі попри `[abie]` у його `auto.md` — тепер скіл коректно автоактивується разом з правилом `abie`.
+
+## [1.11.1] - 2026-05-15
+
+### Fixed
+
+- **`npm/bin/n-cursor.js`** — `runSync()` (entry для `npx @nitra/cursor` без аргументів) шукав
+  `<packageRoot>/mdc` після того, як phase 1-4 перейменував каталог у `rules/`. Виправлено: тепер
+  вказує на коректний шлях `<packageRoot>/rules` — більше не кидає «Не знайдено каталог правил пакету».
+
 ## [1.11.0] - 2026-05-15
 
 ### Added
@@ -37,9 +57,6 @@
   - **Walk-glob правила** (6): `js-mssql`, `js-bun-db`, `js-bun-redis`, `js-run` (package_json + configmap), `vue`, `image-avif` — `walkGlob: "**/package.json"` або відповідний патерн.
   - **k8s.* концерни** (8): `manifest`, `gateway`, `hpa_pdb`, `kustomization`, `svc_yaml`, `svc_hl_yaml`, `base_kustomization`, `base_manifest` — `walkGlob` по YAML під сегментом `k8s/`; `base_manifest` використовує негативний glob для виключення `kustomization.yaml`.
   - **abie концерни** (4): `clean_merged_ignore_branches` (single), `health_check_policy` (walkGlob `**/k8s/**/hc.yaml`), `http_route_base` (walkGlob `**/k8s/**/base/**/hr.yaml`), `base_deployment_preem` (walkGlob `**/k8s/**/base/**/*.{yaml,yml}` з виключенням `kustomization.yaml`).
-
-### Changed
-
 - **`capture-decisions.sh` тепер пише чернетки напряму в `docs/adr/<timestamp>-<sid>.md`** (раніше — у `docs/adr/_inbox/`). Сам каталог `_inbox/` більше не створюється, але `normalize-decisions.sh` бачить його рекурсивно — старі чернетки з `_inbox/` поступово розчищаються нормалізацією. Можна також одноразово `git mv docs/adr/_inbox/*.md docs/adr/` і прибрати порожній каталог.
 - **Правило `adr` (`npm/rules/adr/adr.mdc`)**: повне переписування під дві фази (capture + normalize). Видалено згадки `_inbox/`. Версія `version: '2.0'`.
 - **`npm/rules/adr/js/check.mjs`**: перевірка обох hook-скриптів (canonicity), обох log-файлів у `.gitignore`.

package/bin/n-cursor.js

@@ -261,9 +261,16 @@ async function readConfig(paths = {}) {
       packageJsonParsed: rootPkg,
       disableRules
     })
+    // Skills залежать від ефективного списку правил, який буде у конфізі після merge:
+    // вже існуючі (опт-ін вручну) + auto-detected, мінус `disable-rules`. Без цього
+    // правило, додане вручну (напр. `adr` без auto.md-умови), не активувало б залежні
+    // скіли (`adr-normalize`).
+    const disableRulesSet = new Set(disableRules)
+    const effectiveRulesForSkills = [...new Set([...normalizeIdList(parsedConfig.rules), ...autoDetectedRules.rules])]
+      .filter(id => !disableRulesSet.has(id))
     const autoDetectedSkills = detectAutoSkills({
       availableSkills,
-      detectedRules: autoDetectedRules.rules,
+      detectedRules: effectiveRulesForSkills,
       disableSkills
     })
 
@@ -945,7 +952,7 @@ async function runSyncStep(prefix, action) {
 /**
  * Копіює керовані `.mdc` файли з пакету до `.cursor/rules`.
  * @param {string[]} rules список rules з конфігу
- * @param {string} bundledRulesDir каталог `mdc` пакету-джерела
+ * @param {string} bundledRulesDir каталог `rules` пакету-джерела
  * @param {string} rulesDir абсолютний шлях до `.cursor/rules`
  * @returns {Promise<{ successCount: number, failCount: number }>} статистика копіювання
  */
@@ -1207,7 +1214,7 @@ async function runSync() {
 
   await reexecIfPackageVersionChanged(effectivePackageRoot)
 
-  const bundledRulesDir = join(effectivePackageRoot, 'mdc')
+  const bundledRulesDir = join(effectivePackageRoot, 'rules')
   const bundledSkillsDir = join(effectivePackageRoot, 'skills')
   const bundledAgentsTemplatePath = join(effectivePackageRoot, AGENTS_TEMPLATE_FILE)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.11.0",
+  "version": "1.11.3",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -51,8 +51,5 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
-  },
-  "devDependencies": {
-    "@nitra/cursor": "^1.9.22"
   }
 }

package/rules/abie/utils/k8s-tree.mjs

@@ -9,7 +9,7 @@
  */
 import { dirname, relative } from 'node:path'
 
-import { pathHasK8sSegment } from '../../k8s/js/check.mjs'
+import { pathHasK8sSegment } from '../../k8s/js/manifests/check.mjs'
 import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 import { isDeploymentDoc, readAndParseYamlDocs } from './yaml.mjs'
 

package/rules/adr/js/{check.mjs → hooks/check.mjs}

@@ -22,7 +22,7 @@ import { delimiter, dirname, join } from 'node:path'
 import { env } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 /** Один hook-артефакт: bash-скрипт + його лог-файл, які перевіряємо однотипно. */
 const HOOK_ARTIFACTS = /** @type {const} */ ([
@@ -34,7 +34,7 @@ const PROJECT_SETTINGS_PATH = '.claude/settings.json'
 const EOL_RE = /\r?\n/u
 
 const here = dirname(fileURLToPath(import.meta.url))
-const BUNDLED_HOOKS_DIR = join(here, '..', '..', '..', '.claude-template', 'hooks')
+const BUNDLED_HOOKS_DIR = join(here, '..', '..', '..', '..', '.claude-template', 'hooks')
 
 /**
  * Відносний шлях до managed hook-скрипта у проєкті.

package/rules/bun/js/{check.mjs → layout/check.mjs}

@@ -18,7 +18,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 // Перевірка `devDependencies` кореневого `package.json` (дозволено лише `@nitra/*`)
 // — у rego (`npm/policy/bun/package_json/`). JS-копії `isAllowedRootDevDependency`

package/rules/capacitor/js/{check.mjs → platforms/check.mjs}

@@ -25,7 +25,7 @@ import { existsSync } from 'node:fs'
 import { readdir, readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 /** Мінімальна допустима мажорна версія Capacitor (capacitor.mdc) */
 const MIN_CAPACITOR_MAJOR = 8

package/rules/changelog/js/{check.mjs → consistency/check.mjs}

@@ -27,8 +27,8 @@ import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { promisify } from 'node:util'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { getMonorepoPackageRootDirs } from '../../../../scripts/utils/workspaces.mjs'
 
 const execFileAsync = promisify(execFile)
 

package/rules/docker/js/{check.mjs → lint/check.mjs}

@@ -30,11 +30,11 @@
 import { readFile } from 'node:fs/promises'
 import { basename } from 'node:path'
 
-import { getMirrorGcrHint, getFromImageToken } from '../../../scripts/utils/docker-mirror.mjs'
-import { lintDockerfileWithHadolint, posixRel } from '../../../scripts/utils/docker-hadolint.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'
+import { getMirrorGcrHint, getFromImageToken } from '../../../../scripts/utils/docker-mirror.mjs'
+import { lintDockerfileWithHadolint, posixRel } from '../../../../scripts/utils/docker-hadolint.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 NEWLINE_RE = /\r?\n/
 const BUN_INSTALL_RE = /\bbun\s+(?:install|i)\b/iu

package/rules/ga/js/lint.mjs

@@ -22,7 +22,7 @@
 import { spawnSync } from 'node:child_process'
 import { platform } from 'node:process'
 
-import { check as checkGa } from './check.mjs'
+import { check as checkGa } from './workflows/check.mjs'
 import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
 
 /**

package/rules/ga/js/{check.mjs → workflows/check.mjs}

@@ -19,10 +19,10 @@ import { readdir, readFile } from 'node:fs/promises'
 import { execFileSync } from 'node:child_process'
 import { join } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { eventPathsIncludeExact, parseWorkflowYaml } from '../../../scripts/utils/gha-workflow.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { eventPathsIncludeExact, parseWorkflowYaml } from '../../../../scripts/utils/gha-workflow.mjs'
+import { resolveCmd } from '../../../../scripts/utils/resolve-cmd.mjs'
+import { runConftestBatch } from '../../../../scripts/utils/run-conftest-batch.mjs'
 
 /** Шаблони наявності MegaLinter у вмісті workflow */
 const MEGALINTER_USE_PATTERNS = [/oxsecurity\/megalinter-action/i, /megalinter\/megalinter/i]

package/rules/graphql/js/{check.mjs → tooling/check.mjs}

@@ -10,15 +10,15 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 import {
   isGqlScanSourceFile,
   shouldSkipFileForGqlScan,
   sourceFileHasGqlTaggedTemplate
-} from '../../../scripts/utils/graphql-gql-scan.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'
+} from '../../../../scripts/utils/graphql-gql-scan.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'
 
 /** Очікуваний файл GraphQL Config у корені (graphql.mdc). */
 export const GRAPHQL_RC_FILENAME = '.graphqlrc.yml'

package/rules/hasura/js/{check.mjs → internal_urls/check.mjs}

@@ -27,10 +27,10 @@ import { basename, join, relative } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
 
-import { getRepositoryUrl } from '../../../scripts/auto-rules.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'
+import { getRepositoryUrl } from '../../../../scripts/auto-rules.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 NITRA_REPOSITORY_URL_MARKER = 'https://github.com/nitra/'
 const ABIE_REPOSITORY_URL_MARKER = 'https://github.com/abinbevefes/'

package/rules/image-avif/js/{check.mjs → avif_generation/check.mjs}

@@ -25,11 +25,11 @@ import { join, relative } from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { env } from 'node:process'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.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'
-import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.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'
+import { getMonorepoPackageRootDirs } from '../../../../scripts/utils/workspaces.mjs'
 
 /** Імʼя CLI-пакета, який генерує AVIF. */
 const MINIFY_PACKAGE_NAME = '@nitra/minify-image'

package/rules/image-compress/js/{check.mjs → package_setup/check.mjs}

@@ -19,7 +19,7 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 /** Імʼя committed-кешу (sha1 + originalSize + size) у `@nitra/minify-image` ≥ 3.2.0. */
 const HASH_CACHE_FILENAME = '.n-minify-image.tsv'

package/rules/js-bun-db/js/{check.mjs → safety/check.mjs}

@@ -25,7 +25,7 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 import {
   findBunSqlPerRequestConnectionInText,
   findBunSqlPgLeftoverCallInText,
@@ -36,10 +36,10 @@ import {
   findUnsafeBunSqlInListMissingEmptyGuardInText,
   isBunSqlScanSourceFile,
   textHasBunSqlImport
-} from '../../../scripts/utils/bun-sql-scan.mjs'
-import { findAllPackageJsonPaths } from '../../../scripts/utils/find-package-json-paths.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+} from '../../../../scripts/utils/bun-sql-scan.mjs'
+import { findAllPackageJsonPaths } from '../../../../scripts/utils/find-package-json-paths.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
 
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану Bun SQL патернів.

package/rules/js-bun-redis/js/{check.mjs → imports/check.mjs}

@@ -14,10 +14,10 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
-import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from '../../../scripts/utils/redis-imports.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from '../../../../scripts/utils/redis-imports.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
 
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану заборонених redis-імпортів.

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

@@ -16,17 +16,31 @@ import { copyFile, readFile } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 
 /** Шлях до канонічного oxlint JSON у цьому пакеті (для перевірки та тестів). */
 export const OXLINT_CANONICAL_JSON_PATH = join(
   dirname(fileURLToPath(import.meta.url)),
+  '..',
+  '..',
+  '..',
+  '..',
+  'scripts',
   'utils',
   'oxlint-canonical.json'
 )
 
 /** Шлях до канонічного knip JSON у цьому пакеті — копіюється у корінь проєкту-споживача, якщо відсутній. */
-export const KNIP_CANONICAL_JSON_PATH = join(dirname(fileURLToPath(import.meta.url)), 'utils', 'knip-canonical.json')
+export const KNIP_CANONICAL_JSON_PATH = join(
+  dirname(fileURLToPath(import.meta.url)),
+  '..',
+  '..',
+  '..',
+  '..',
+  'scripts',
+  'utils',
+  'knip-canonical.json'
+)
 
 /** Мінімальні рекомендації розширень редактора з js-lint.mdc (eslint, oxlint, GA). */
 export const REQUIRED_VSCODE_EXTENSIONS = ['dbaeumer.vscode-eslint', 'github.vscode-github-actions', 'oxc.oxc-vscode']

package/rules/js-mssql/js/{check.mjs → deps/check.mjs}

@@ -12,8 +12,8 @@ import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { findAllPackageJsonPaths } from '../../../scripts/utils/find-package-json-paths.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { findAllPackageJsonPaths } from '../../../../scripts/utils/find-package-json-paths.mjs'
 import {
   findMssqlPerRequestConnectionInText,
   findSharedMssqlRequestInText,
@@ -22,9 +22,9 @@ import {
   findUnsafeMssqlInListUnparsedInText,
   findUnsafeMssqlInListMissingEmptyGuardInText,
   isMssqlScanSourceFile
-} from '../../../scripts/utils/mssql-pool-scan.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+} from '../../../../scripts/utils/mssql-pool-scan.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
 
 const VERSION_PREFIX_RE = /^[\^~>=<]+\s*/u
 const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)/u

package/rules/js-run/js/{check.mjs → runtime/check.mjs}

@@ -37,21 +37,21 @@ import {
   findBunyanImportsInText,
   isBunyanScanSourceFile,
   shouldSkipFileForBunyanScan
-} from '../../../scripts/utils/bunyan-imports.mjs'
-import { findUncheckedProcessEnvInText, isCheckEnvScanSourceFile } from '../../../scripts/utils/check-env-scan.mjs'
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { runConftestBatch } from '../../../scripts/utils/run-conftest-batch.mjs'
-import { findConnFileRuleViolations, isConnFileRulesSourceFile } from '../../../scripts/utils/conn-file-rules.mjs'
+} from '../../../../scripts/utils/bunyan-imports.mjs'
+import { findUncheckedProcessEnvInText, isCheckEnvScanSourceFile } from '../../../../scripts/utils/check-env-scan.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
+import { runConftestBatch } from '../../../../scripts/utils/run-conftest-batch.mjs'
+import { findConnFileRuleViolations, isConnFileRulesSourceFile } from '../../../../scripts/utils/conn-file-rules.mjs'
 import {
   findConnFactoryImportsInText,
   isConnImportsScanSourceFile,
   isInsideConnDir,
   resolveConnDirFromPackageJson
-} from '../../../scripts/utils/conn-imports-scan.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/utils/load-cursor-config.mjs'
-import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from '../../../scripts/utils/promise-settimeout-scan.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
-import { getMonorepoPackageRootDirs } from '../../../scripts/utils/workspaces.mjs'
+} from '../../../../scripts/utils/conn-imports-scan.mjs'
+import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
+import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from '../../../../scripts/utils/promise-settimeout-scan.mjs'
+import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
+import { getMonorepoPackageRootDirs } from '../../../../scripts/utils/workspaces.mjs'
 
 /**
  * Чи існує непорожній за змістом маркер каталогу `src/` (рекомендована структура js-run).

package/rules/k8s/js/{check.mjs → manifests/check.mjs}

@@ -134,10 +134,10 @@ import { basename, dirname, join, relative, resolve } from 'node:path'
 
 import { isSeq, parseAllDocuments, parseDocument } from 'yaml'
 
-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'
+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'
 
 /** Версія набору схем yannh — узгоджено з k8s.mdc */
 const YANNH_PIN = 'v1.33.9-standalone-strict'

package/rules/nginx-default-tpl/js/{check.mjs → template/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 '../../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'
+import { findDockerfilePaths } from '../../../docker/js/lint/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

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

@@ -32,10 +32,10 @@ import { promisify } from 'node:util'
 
 import { parseSync } from 'oxc-parser'
 
-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'
+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/js/{check.mjs → tooling/check.mjs}

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

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

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

package/rules/tauri/js/{check.mjs → tooling/check.mjs}

@@ -18,8 +18,8 @@
 import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { runConftestBatch } from '../../../scripts/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/js/{check.mjs → formatting/check.mjs}

@@ -32,8 +32,8 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
-import { anyRunStepIncludes, parseWorkflowYaml } from '../../../scripts/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/rules/vue/js/{check.mjs → packages/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 '../../../scripts/utils/check-reporter.mjs'
+import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 import {
   findForbiddenNodeImportsInVueFile,
   findForbiddenVueImportsInSourceFile,
   isVueImportScanSourceFile,
   shouldSkipFileForVueImportScan
-} 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'
+} 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-skills.mjs

@@ -1,81 +1,122 @@
 /**
- * Автовизначення skills для `.n-cursor.json` за умовами з `npm/skills/<skill>/auto.md`.
+ * Автовизначення skills для `.n-cursor.json` за умовами зі `npm/skills/<skill>/auto.md`.
  *
- * Скіли автододаються залежно від уже виявлених правил (auto-rules) — щоб не дублювати
- * умови, які вже формалізовані для відповідного правила. Наприклад:
+ * `auto.md` — джерело правди (а не hardcoded мапа). Підтримуються три варіанти:
  *
- * - `abie-kustomize - [abie]` — додається разом з правилом `abie`
- * - `taze - [bun]` — додається разом з правилом `bun`
+ *  - `завжди` — скіл активується незалежно від інших правил
+ *    (приклади: `fix`, `lint`, `llm-patch`, `publish-telegram`).
+ *  - `[rule, rule, …]` — скіл активується, якщо ВСІ перелічені правила вже виявлені
+ *    auto-rules (приклади: `abie-clean - [abie]`, `taze - [bun]`).
+ *  - файл відсутній або формат не розпізнано — скіл opt-in лише через `.n-cursor.json:skills`.
  *
- * Скіли без секції `[rules]` у `skills/<skill>/auto.md` (`fix`, `lint`, `llm-patch`, `publish-telegram`)
- * додаються завжди, якщо доступні в пакеті й не у `disable-skills`.
+ * Сканування `npm/skills/` — sync під час завантаження модуля (детермінізм + sync API
+ * `auto-rules.mjs`-сусіда). Кеш на час процесу.
  */
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
-/** Порядок автододавання skills відповідно до `skills/<skill>/auto.md`. */
-export const AUTO_SKILL_ORDER = Object.freeze([
-  'abie-kustomize',
-  'adr-normalize',
-  'fix',
-  'lint',
-  'llm-patch',
-  'publish-telegram',
-  'taze'
-])
+const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
+const SKILLS_DIR = join(PACKAGE_ROOT, 'skills')
+
+const ALWAYS_LITERAL = 'завжди'
+const BRACKET_LIST_RE = /^\[([^\]]+)\]$/u
 
 /**
- * Залежність скілів від правил (`skills/<skill>/auto.md` синтаксис `skill - [rules]`).
- * Ключ варто автододати, коли всі правила-залежності вже додані до конфігу автодетектом.
+ * @typedef {{ always: true } | { rules: readonly string[] }} SkillAutoSpec
  */
-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.md` одного скіла.
+ * @param {string} text вміст файла (без `trim`)
+ * @returns {SkillAutoSpec | null} `null` — формат не розпізнано (= opt-in)
+ */
+function parseSkillAutoSpec(text) {
+  const trimmed = text.trim()
+  if (trimmed === ALWAYS_LITERAL) {
+    return { always: true }
+  }
+  const m = trimmed.match(BRACKET_LIST_RE)
+  if (m) {
+    const rules = m[1]
+      .split(',')
+      .map(s => s.trim())
+      .filter(s => s.length > 0)
+    if (rules.length === 0) return null
+    return { rules: Object.freeze(rules) }
+  }
+  return null
+}
+
+/**
+ * Сканує `npm/skills/<id>/auto.md`. Скіли без `auto.md` або з нерозпізнаним
+ * вмістом не потрапляють у результат — їх можна вмикати лише вручну в конфізі.
+ * @param {string} [skillsDir] override для тестів
+ * @returns {Record<string, SkillAutoSpec>}
+ */
+export function discoverSkillAutoActivation(skillsDir = SKILLS_DIR) {
+  if (!existsSync(skillsDir)) return {}
+  /** @type {Record<string, SkillAutoSpec>} */
+  const out = {}
+  for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory() || entry.name.startsWith('.')) continue
+    const autoMdPath = join(skillsDir, entry.name, 'auto.md')
+    if (!existsSync(autoMdPath)) continue
+    const spec = parseSkillAutoSpec(readFileSync(autoMdPath, 'utf8'))
+    if (spec) out[entry.name] = spec
+  }
+  return out
+}
+
+/** Cache на час процесу: один скан `npm/skills/` дає всю автоактивацію. */
+const SKILL_AUTO_ACTIVATION = discoverSkillAutoActivation()
+
+/**
+ * Стабільний алфавітний порядок скілів з автоактивацією. Експортовано для зворотної
+ * сумісності (попередня версія мала жорстко прописаний `AUTO_SKILL_ORDER`).
+ */
+export const AUTO_SKILL_ORDER = Object.freeze(
+  Object.keys(SKILL_AUTO_ACTIVATION).toSorted((a, b) => a.localeCompare(b))
 )
 
-/** Скіли без залежностей — додаються завжди (рядок «завжди» в `skills/<skill>/auto.md`). */
-const ALWAYS_ON_SKILLS = Object.freeze(['fix', 'lint', 'llm-patch', 'publish-telegram'])
+/**
+ * Похідна view на `SKILL_AUTO_ACTIVATION`: лише скіли з rule-залежностями.
+ * Експортовано для зворотної сумісності та автодоку.
+ */
+export const AUTO_SKILL_RULE_DEPENDENCIES = Object.freeze(
+  Object.fromEntries(
+    Object.entries(SKILL_AUTO_ACTIVATION)
+      .filter(([, spec]) => 'rules' in spec)
+      .map(([id, spec]) => [id, /** @type {{ rules: readonly string[] }} */ (spec).rules])
+  )
+)
 
 const DEFAULT_DISABLED_LIST = Object.freeze([])
 
 /**
- * Визначає авто-skills згідно з `skills/<skill>/auto.md`.
+ * Визначає авто-skills згідно з вмістом `skills/<skill>/auto.md`.
  * @param {object} params параметри
  * @param {string[]} params.availableSkills перелік доступних skills із пакету (id без префікса n-)
  * @param {string[]} params.detectedRules id правил, виявлених auto-rules (вхідні залежності)
  * @param {string[]} [params.disableSkills] список `disable-skills` з конфігу
- * @returns {{ skills: string[] }} список id у стабільному порядку (за `AUTO_SKILL_ORDER`)
+ * @returns {{ skills: string[] }} список id у стабільному алфавітному порядку
  */
 export function detectAutoSkills({ availableSkills, detectedRules, disableSkills = DEFAULT_DISABLED_LIST }) {
   const normalizedSkills = new Set(availableSkills.map(s => s.trim().toLowerCase()))
   const disableSkillsSet = new Set(disableSkills)
   const detectedRulesSet = new Set(detectedRules)
 
-  /** @type {string[]} */
-  const detected = []
-
-  /**
-   * Додає skill до результату, якщо він доступний і не в disable-списку.
-   * @param {string} skillId id skill
-   * @returns {void}
-   */
-  function addSkill(skillId) {
-    if (!normalizedSkills.has(skillId) || disableSkillsSet.has(skillId) || detected.includes(skillId)) {
-      return
-    }
-    detected.push(skillId)
-  }
-
-  for (const skillId of ALWAYS_ON_SKILLS) {
-    addSkill(skillId)
-  }
+  /** @type {Set<string>} */
+  const detected = new Set()
 
-  for (const [skillId, deps] of Object.entries(AUTO_SKILL_RULE_DEPENDENCIES)) {
-    if (deps.every(d => detectedRulesSet.has(d))) {
-      addSkill(skillId)
+  for (const [skillId, spec] of Object.entries(SKILL_AUTO_ACTIVATION)) {
+    if (!normalizedSkills.has(skillId) || disableSkillsSet.has(skillId)) continue
+    if ('always' in spec) {
+      detected.add(skillId)
+    } else if (spec.rules.every(d => detectedRulesSet.has(d))) {
+      detected.add(skillId)
     }
   }
 
-  return { skills: AUTO_SKILL_ORDER.filter(id => detected.includes(id)) }
+  return { skills: AUTO_SKILL_ORDER.filter(id => detected.has(id)) }
 }

package/scripts/utils/discover-checkable-rules.mjs

@@ -2,11 +2,11 @@
  * Discovery rules для CLI `check`. Шукає правила, для яких є щось «прогонне»:
  *   - JS concerns:   `rules/<id>/js/<concern>/<check.mjs | check-*.mjs>` — кожен concern окремий вузол.
  *   - Policy concerns: `rules/<id>/policy/<concern>/target.json` — пара з `<concern>.rego`.
- *   - Legacy JS (на час міграції): `rules/<id>/js/check.mjs` (плаский) — мапиться у concern `legacy`,
- *     щоб не ламати ще не мігровані правила.
  *
  * Каталог `utils/` всередині `js/` свідомо пропускається — це хелпери, не концерни.
  * Файли `*.test.mjs` фільтруються regex (`^check(?:-.+)?\.mjs$`).
+ * Top-level плаский `js/check.mjs` (legacy) більше не підтримується — усі вшиті правила
+ * у пакеті розпиляні на concern-структуру.
  *
  * Намеренно НЕ парсимо `target.json` тут (це робить runner). Discovery — швидкий скан структури:
  * шляхи + назви, без I/O вмісту.
@@ -20,9 +20,8 @@ const TEST_SUFFIX = '.test.mjs'
 
 /**
  * @typedef {object} JsConcern
- * @property {string} name імʼя концерну (`<name>` у `js/<name>/`); для legacy — `'legacy'`
+ * @property {string} name імʼя концерну (`<name>` у `js/<name>/`)
  * @property {string[]} files імена `check*.mjs` у концерні (відсортовані алфавітно)
- * @property {boolean} legacy чи це fallback на плаский `js/check.mjs`
  */
 
 /**
@@ -38,8 +37,7 @@ const TEST_SUFFIX = '.test.mjs'
  */
 
 /**
- * Перелічує JS-концерни одного правила: підкаталоги `js/<name>/` з принаймні одним `check*.mjs`,
- * плюс legacy-fallback на плаский `js/check.mjs` (без підкаталогу).
+ * Перелічує JS-концерни одного правила: підкаталоги `js/<name>/` з принаймні одним `check*.mjs`.
  *
  * `js/utils/` свідомо пропускається — це хелпери, а не концерни.
  * @param {string} jsDir абсолютний шлях `rules/<id>/js/`
@@ -49,7 +47,6 @@ async function listJsConcerns(jsDir) {
   if (!existsSync(jsDir)) return []
   const topLevel = await readdir(jsDir, { withFileTypes: true })
 
-  // Перевага — нова concern-структура (`js/<concern>/check*.mjs`).
   /** @type {JsConcern[]} */
   const concerns = []
   for (const entry of topLevel) {
@@ -59,21 +56,7 @@ async function listJsConcerns(jsDir) {
       .filter(n => CHECK_FILENAME_RE.test(n) && !n.endsWith(TEST_SUFFIX))
       .toSorted((a, b) => a.localeCompare(b))
     if (files.length > 0) {
-      concerns.push({ name: entry.name, files, legacy: false })
-    }
-  }
-
-  // Legacy fallback — лише якщо subdir-концернів немає взагалі. Гібридні правила
-  // (одночасно legacy check.mjs + нові концерни) трактуються як уже мігровані:
-  // CLI запускає тільки субдиректорні концерни, flat-файл лишається для backward-compat
-  // тестів, які імпортують `check` напряму.
-  if (concerns.length === 0) {
-    const flatChecks = topLevel
-      .filter(e => e.isFile() && CHECK_FILENAME_RE.test(e.name) && !e.name.endsWith(TEST_SUFFIX))
-      .map(e => e.name)
-      .toSorted((a, b) => a.localeCompare(b))
-    if (flatChecks.length > 0) {
-      concerns.push({ name: 'legacy', files: flatChecks, legacy: true })
+      concerns.push({ name: entry.name, files })
     }
   }
 

package/scripts/utils/run-rule.mjs

@@ -6,8 +6,6 @@
  *      false — друкуємо `✅ правило не застосовне` і завершуємо без подальших викликів.
  *   2. **JS-концерни** — кожен `check*.mjs` у `js/<concern>/`. Concern `applies` теж може мати
  *      `check()` для друку контексту (його `applies()` уже відпрацював на кроці 1, він не повторюється).
- *      Legacy-fallback: плаский `js/check.mjs` лежить як concern `legacy` — імпортується з кореня `js/`,
- *      а не з підкаталога.
  *   3. **Policy-концерни** — кожен `policy/<concern>/target.json` через `runConftestBatch`.
  *      Реcолвер `resolveTargetFiles` ділить cache (`walkCache`) між концернами.
  *
@@ -32,9 +30,7 @@ const APPLIES_CONCERN_NAME = 'applies'
  * @returns {string} абсолютний шлях
  */
 function resolveJsCheckPath(bundledRulesDir, ruleId, concern, fileName) {
-  return concern.legacy
-    ? join(bundledRulesDir, ruleId, 'js', fileName)
-    : join(bundledRulesDir, ruleId, 'js', concern.name, fileName)
+  return join(bundledRulesDir, ruleId, 'js', concern.name, fileName)
 }
 
 /**