@nitra/cursor 1.8.204 → 1.8.207

package/scripts/check-image-compress.mjs

@@ -1,121 +1,32 @@
 /**
- * Перевіряє відповідність репозиторію правилу `image-compress.mdc`: канонічний скрипт
- * `lint-image` для оптимізації raster/SVG через `@nitra/minify-image` ≥ 3.2.0 (локально).
+ * Перевіряє вимоги правила `image-compress.mdc` для оптимізації raster/SVG через
+ * `@nitra/minify-image` ≥ 3.2.0 (локально).
  *
- * Очікування:
- * - у кореневому `package.json` є скрипт `lint-image`, який викликає `npx @nitra/minify-image`
- *   з обовʼязковими `--src=.` і `--write`. Прапорець `--avif` у `lint-image` заборонений —
- *   AVIF-генерацію виконує окреме правило `image-avif` (інакше `bun run lint` плодив би `.avif`
- *   для зображень, що ніде не вживаються);
- * - якщо в `package.json` є агрегований скрипт `lint`, він викликає `bun run lint-image`
- *   (симетрично до `lint-text`, `lint-js`, `lint-ga`);
- * - `@nitra/minify-image` не оголошений у `dependencies`/`devDependencies` —
- *   CLI запускається лише через `npx` (як `markdownlint-cli2` у `text.mdc`);
- * - `.n-minify-image.tsv` (committed source of truth з sha1/originalSize/size) НЕ
- *   в `.gitignore` — він має бути в git. Локальний mtime-кеш у
- *   `node_modules/.cache/@nitra/minify-image/mtime.tsv` авто-gitignored через `node_modules/`,
- *   окремої перевірки не вимагає;
- * - застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений з кореня — інакше
- *   проєкт лишається у напівпереміщеному стані.
+ * **Що тут лишилося** (FS / cross-file):
+ *  - наявність `package.json` у корені;
+ *  - `.n-minify-image.tsv` (committed source of truth з sha1/originalSize/size) НЕ
+ *    в `.gitignore` — він має бути в git;
+ *  - застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений з кореня та
+ *    з `.gitignore`.
+ *
+ * **Що покрила Rego** (`bun run lint-conftest`,
+ * `npm/policy/image_compress/package_json/`):
+ *  - `scripts.lint-image` викликає `npx @nitra/minify-image --src=. --write`
+ *    без `--avif` (AVIF — окреме правило `image-avif`);
+ *  - агрегований `lint` (якщо є) містить `bun run lint-image`;
+ *  - `@nitra/minify-image` НЕ у `dependencies` / `devDependencies` (через `npx`).
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
 
-/** Імʼя CLI-пакета: рядок у `lint-image` і заборонений у залежностях. */
-const MINIFY_PACKAGE_NAME = '@nitra/minify-image'
-
 /** Імʼя committed-кешу (sha1 + originalSize + size) у `@nitra/minify-image` ≥ 3.2.0. */
 const HASH_CACHE_FILENAME = '.n-minify-image.tsv'
 
 /** Імʼя застарілого 4-колонкового кешу (`@nitra/minify-image` < 3.2). Має бути видалений після міграції. */
 const LEGACY_CACHE_FILENAME = '.minify-image-cache.tsv'
 
-/**
- * Перевіряє скрипт `lint-image` у `package.json`.
- *
- * Має містити виклик `npx @nitra/minify-image` з обовʼязковими прапорцями `--src=.`
- * і `--write` (авто-оптимізація на місці). Прапорець `--avif` у `lint-image`
- * заборонений — AVIF-генерацію виконує `check image-avif`, інакше `bun run lint` плодить
- * `.avif` для зображень, що ніде не вживаються.
- * @param {string|undefined} lintImage значення `scripts['lint-image']`
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {void}
- */
-function checkLintImageScript(lintImage, pass, fail) {
-  const canonical = `npx ${MINIFY_PACKAGE_NAME} --src=. --write`
-  if (typeof lintImage !== 'string' || !lintImage.trim()) {
-    fail(`package.json: додай скрипт "lint-image" з \`${canonical}\` (image-compress.mdc)`)
-    return
-  }
-  if (!lintImage.includes(`npx ${MINIFY_PACKAGE_NAME}`)) {
-    fail(`package.json: lint-image має викликати \`npx ${MINIFY_PACKAGE_NAME}\` (image-compress.mdc)`)
-    return
-  }
-  /** @type {{ flag: string, variants: string[], hint: string }[]} */
-  const requiredFlags = [
-    { flag: '--src=.', variants: ['--src=.', '--src .'], hint: '`--src=.`' },
-    { flag: '--write', variants: ['--write'], hint: '`--write` (авто-оптимізація на місці)' }
-  ]
-  const missing = requiredFlags.filter(f => !f.variants.some(v => lintImage.includes(v)))
-  if (missing.length > 0) {
-    fail(
-      `package.json: lint-image має містити ${missing.map(f => f.hint).join(', ')} — канонічний виклик: \`${canonical}\` (image-compress.mdc)`
-    )
-    return
-  }
-  if (lintImage.includes('--avif')) {
-    fail(
-      `package.json: прибери \`--avif\` з lint-image — AVIF-генерацію виконує \`npx @nitra/cursor check image-avif\` (image-compress.mdc). Канонічний виклик: \`${canonical}\``
-    )
-    return
-  }
-  pass(`package.json: lint-image викликає \`${canonical}\``)
-}
-
-/**
- * Перевіряє, що агрегований `lint` (якщо є) кличе `bun run lint-image` —
- * симетрично до `lint-text`, `lint-js`, `lint-ga`.
- * @param {string|undefined} lintAggregate значення `scripts.lint`
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {void}
- */
-function checkLintAggregateIncludesImage(lintAggregate, pass, fail) {
-  if (typeof lintAggregate !== 'string' || !lintAggregate.trim()) {
-    return
-  }
-  if (lintAggregate.includes('bun run lint-image')) {
-    pass('package.json: агрегований `lint` викликає `bun run lint-image`')
-  } else {
-    fail(
-      'package.json: у `lint` додай `bun run lint-image` (image-compress.mdc, симетрично до lint-text / lint-js / lint-ga)'
-    )
-  }
-}
-
-/**
- * Забороняє `@nitra/minify-image` у `dependencies` чи `devDependencies` —
- * CLI завжди запускається через `npx` (як `markdownlint-cli2` у `text.mdc`).
- * @param {{ dependencies?: Record<string, unknown>, devDependencies?: Record<string, unknown> }} pkg розібраний package.json
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {void}
- */
-function checkMinifyImageNotInDeps(pkg, pass, fail) {
-  const inDeps = Boolean(pkg.dependencies && MINIFY_PACKAGE_NAME in pkg.dependencies)
-  const inDevDeps = Boolean(pkg.devDependencies && MINIFY_PACKAGE_NAME in pkg.devDependencies)
-  if (inDeps || inDevDeps) {
-    fail(
-      `package.json: ${MINIFY_PACKAGE_NAME} не додавай у dependencies/devDependencies — лише через \`npx\` (image-compress.mdc)`
-    )
-  } else {
-    pass(`package.json: ${MINIFY_PACKAGE_NAME} не оголошено в dependencies/devDependencies`)
-  }
-}
-
 /**
  * Зчитує всі змістовні рядки `.gitignore` (без коментарів і порожніх). Якщо файла нема — `null`.
  * @returns {Promise<string[] | null>} список trim-нутих рядків або `null`
@@ -176,41 +87,23 @@ async function checkLegacyCacheRemoved(pass, fail) {
 }
 
 /**
- * Перевіряє кореневий `package.json`: скрипти, заборонені залежності, агрегований `lint`.
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<boolean>} `true`, якщо `package.json` знайдено й оброблено; `false` — нема
- */
-async function checkPackageJsonImage(pass, fail) {
-  if (!existsSync('package.json')) {
-    fail('package.json не знайдено в корені — додай (image-compress.mdc)')
-    return false
-  }
-  const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-  const scripts = /** @type {Record<string, unknown>} */ (pkg.scripts || {})
-  checkLintImageScript(typeof scripts['lint-image'] === 'string' ? scripts['lint-image'] : undefined, pass, fail)
-  checkLintAggregateIncludesImage(typeof scripts.lint === 'string' ? scripts.lint : undefined, pass, fail)
-  checkMinifyImageNotInDeps(pkg, pass, fail)
-  return true
-}
-
-/**
- * Перевіряє відповідність проєкту правилу `image-compress.mdc`: канонічний `lint-image`
- * (через `npx @nitra/minify-image --src=. --write`, без `--avif`!), агрегований `lint`,
- * `@nitra/minify-image` не у залежностях, `.n-minify-image.tsv` НЕ в `.gitignore`,
- * застарілий `.minify-image-cache.tsv` видалений. CI-workflow для image не вимагається —
- * лінт зображень виконується лише локально.
+ * Перевіряє відповідність проєкту правилу `image-compress.mdc`: `.n-minify-image.tsv` НЕ
+ * в `.gitignore`, застарілий `.minify-image-cache.tsv` видалений. CI-workflow для image
+ * не вимагається — лінт зображень виконується лише локально.
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const pkgFound = await checkPackageJsonImage(pass, fail)
-  if (pkgFound) {
-    await checkHashCacheNotIgnored(pass, fail)
-    await checkLegacyCacheRemoved(pass, fail)
+  if (!existsSync('package.json')) {
+    fail('package.json не знайдено в корені — додай (image-compress.mdc)')
+    return reporter.getExitCode()
   }
+  pass('package.json є (структуру перевіряє bun run lint-conftest → image_compress.package_json)')
+
+  await checkHashCacheNotIgnored(pass, fail)
+  await checkLegacyCacheRemoved(pass, fail)
 
   return reporter.getExitCode()
 }

package/scripts/check-js-bun-db.mjs

@@ -39,18 +39,6 @@ import { findAllPackageJsonPaths } from './utils/find-package-json-paths.mjs'
 import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
-/** Імена забороненої залежності у будь-якому `package.json`. */
-const FORBIDDEN_DEPENDENCIES = Object.freeze(['pg', 'pg-format', 'mysql2'])
-
-/**
- * @param {unknown} v parsed JSON
- * @returns {Record<string, unknown>} object або {}
- */
-function asObject(v) {
-  if (!v || typeof v !== 'object' || Array.isArray(v)) return {}
-  return /** @type {Record<string, unknown>} */ (v)
-}
-
 /**
  * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану Bun SQL патернів.
  * @param {string} repoRoot абсолютний шлях до кореня репозиторію
@@ -74,43 +62,6 @@ async function findAllSourcePathsForBunSqlScan(repoRoot, ignorePaths) {
   return paths
 }
 
-/**
- * Перевіряє, чи в кореневому `package.json` присутні заборонені пакети у `dependencies`.
- * @param {string[]} pkgJsonPaths абсолютні шляхи всіх `package.json` у репо
- * @param {string} repoRoot абсолютний шлях до кореня
- * @param {{ pass: (m: string) => void, fail: (m: string) => void }} reporter колбеки pass і fail з перевірки
- * @returns {Promise<number>} кількість знайдених порушень
- */
-async function checkForbiddenDependencies(pkgJsonPaths, repoRoot, reporter) {
-  const { pass, fail } = reporter
-  let bad = 0
-  for (const absPath of pkgJsonPaths) {
-    const rel = relative(repoRoot, absPath).split('\\').join('/')
-    let parsed
-    try {
-      parsed = JSON.parse(await readFile(absPath, 'utf8'))
-    } catch {
-      fail(`js-bun-db: ${rel} — невалідний JSON`)
-      bad++
-      continue
-    }
-    const deps = asObject(parsed.dependencies)
-    for (const name of FORBIDDEN_DEPENDENCIES) {
-      if (Object.hasOwn(deps, name)) {
-        bad++
-        fail(
-          `js-bun-db: ${rel}: dependencies.${name} — замінити на Bun native SQL ` +
-            `(import { sql, SQL } from 'bun', https://bun.com/docs/runtime/sql) (js-bun-db.mdc)`
-        )
-      }
-    }
-  }
-  if (bad === 0) {
-    pass(`js-bun-db: жоден package.json не містить ${FORBIDDEN_DEPENDENCIES.join(' / ')} у dependencies`)
-  }
-  return bad
-}
-
 /**
  * Сканує JS/TS-джерела на небезпечні патерни Bun SQL.
  * @param {string[]} sourcePaths абсолютні шляхи джерел
@@ -233,7 +184,9 @@ export async function check() {
     return reporter.getExitCode()
   }
 
-  await checkForbiddenDependencies(pkgJsonPaths, repoRoot, reporter)
+  // Перевірку `dependencies` (заборона `pg` / `pg-format` / `mysql2`) перенесено
+  // в Rego-полісі `npm/policy/js_bun_db/package_json/`; `bun run lint-conftest`
+  // запускає її по всіх workspace-`package.json`. Тут лишився лише AST-скан коду.
 
   const sourcePaths = await findAllSourcePathsForBunSqlScan(repoRoot, ignorePaths)
   if (sourcePaths.length === 0) {

package/scripts/check-js-run.mjs

@@ -47,10 +47,7 @@ import {
   resolveConnDirFromPackageJson
 } from './utils/conn-imports-scan.mjs'
 import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
-import {
-  findPromiseSetTimeoutInText,
-  isPromiseSetTimeoutScanSourceFile
-} from './utils/promise-settimeout-scan.mjs'
+import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from './utils/promise-settimeout-scan.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
@@ -68,9 +65,9 @@ const CANONICAL_BACKEND_JSCONFIG = Object.freeze({
 
 /**
  * Глибока рівність для JSON-подібних значень (масиви — порядок важливий).
- * @param {unknown} a
- * @param {unknown} b
- * @returns {boolean}
+ * @param {unknown} a перше значення
+ * @param {unknown} b друге значення
+ * @returns {boolean} true, якщо значення структурно ідентичні
  */
 function deepEqualJson(a, b) {
   if (a === b) return true
@@ -86,8 +83,8 @@ function deepEqualJson(a, b) {
   }
   const ao = /** @type {Record<string, unknown>} */ (a)
   const bo = /** @type {Record<string, unknown>} */ (b)
-  const keysA = Object.keys(ao).sort()
-  const keysB = Object.keys(bo).sort()
+  const keysA = Object.keys(ao).toSorted()
+  const keysB = Object.keys(bo).toSorted()
   if (keysA.length !== keysB.length) return false
   for (const [i, k] of keysA.entries()) {
     if (k !== keysB[i]) return false
@@ -99,7 +96,7 @@ function deepEqualJson(a, b) {
 /**
  * Чи існує непорожній за змістом маркер каталогу `src/` (рекомендована структура js-run).
  * @param {string} absPackageRoot абсолютний корінь пакета
- * @returns {boolean}
+ * @returns {boolean} true, якщо `src/` існує і є каталогом
  */
 function backendPackageHasSrcDir(absPackageRoot) {
   const srcPath = join(absPackageRoot, 'src')
@@ -115,8 +112,8 @@ function backendPackageHasSrcDir(absPackageRoot) {
  * @param {string} rootDir відносний шлях workspace
  * @param {string} absPackageRoot абсолютний корінь пакета
  * @param {string} label префікс `[pkg] `
- * @param {(msg: string) => void} fail
- * @param {(msg: string) => void} passFn
+ * @param {(msg: string) => void} fail callback для повідомлень про порушення
+ * @param {(msg: string) => void} passFn callback для повідомлень про успішну перевірку
  * @returns {Promise<void>}
  */
 async function checkBackendJsconfigWhenSrcPresent(rootDir, absPackageRoot, label, fail, passFn) {

package/scripts/check-k8s.mjs

@@ -524,7 +524,8 @@ function kustomizationPatchSortKey(patchItem) {
   const rec = /** @type {Record<string, unknown>} */ (patchItem)
   const t = rec.target
   /** @type {Record<string, unknown>} */
-  const target = t !== null && typeof t === 'object' && !Array.isArray(t) ? /** @type {Record<string, unknown>} */ (t) : {}
+  const target =
+    t !== null && typeof t === 'object' && !Array.isArray(t) ? /** @type {Record<string, unknown>} */ (t) : {}
   const kind = typeof target.kind === 'string' ? target.kind : ''
   const name = typeof target.name === 'string' ? target.name : ''
   const ns = typeof target.namespace === 'string' ? target.namespace : ''
@@ -5647,8 +5648,8 @@ export function imageReplaceDeploymentPatchInfo(patchObj) {
 
   /** @type {Array<{ containerIndex: number, newImage: string, opIndex: number }>} */
   const ops = []
-  for (let i = 0; i < parsedArr.length; i++) {
-    const op = asPlainObject(parsedArr[i])
+  for (const [i, element] of parsedArr.entries()) {
+    const op = asPlainObject(element)
     if (op === null) continue
     const containerIndex = singleImageReplaceContainerIndex(op)
     if (containerIndex === null) continue
@@ -6017,7 +6018,7 @@ function applyConversionsToDoc(doc, conversions) {
     byPatch.set(c.index, slot)
   }
 
-  const sortedIdx = [...byPatch.keys()].sort((a, b) => b - a)
+  const sortedIdx = byPatch.keys().toSorted((a, b) => b - a)
   for (const i of sortedIdx) {
     const slot = byPatch.get(i)
     if (slot === undefined) continue
@@ -6070,7 +6071,7 @@ function rewriteInlinePatchWithoutOps(patchText, opIndices) {
   const seq = inner.contents
   if (!isSeq(seq)) return null
 
-  const toRemove = [...new Set(opIndices)].sort((a, b) => b - a)
+  const toRemove = new Set(opIndices).toSorted((a, b) => b - a)
   for (const i of toRemove) {
     if (i < 0 || i >= seq.items.length) return null
     seq.delete(i)

package/scripts/check-npm-module.mjs

@@ -39,6 +39,9 @@ const TYPES_FILE_RE = /^\.\/types\/.+\.d\.(ts|mts)$/
 /** Перший заголовок релізу у Keep a Changelog (`## [1.2.3]`). */
 const CHANGELOG_FIRST_VERSION_RE = /^## \[([^\]]+)\]/m
 
+/** Поле `version` у текстовому зрізі `package.json` (для `git show HEAD:npm/package.json`). */
+const PACKAGE_JSON_VERSION_RE = /"version":\s*"([^"]+)"/u
+
 /** Канонічний entrypoint типів для пакетів із вихідним `.js` під каталогом `npm/src` */
 const TYPES_INDEX = './types/index.d.ts'
 
@@ -246,7 +249,7 @@ async function checkEmitTypesConfig(passFn, failFn) {
  */
 /**
  * Чи виконано `git` у корені робочого дерева.
- * @returns {Promise<boolean>}
+ * @returns {Promise<boolean>} true, якщо процес запущено в межах git work tree
  */
 async function gitInsideWorkTree() {
   try {
@@ -273,7 +276,7 @@ async function gitDiffNameOnlyNpm() {
 /**
  * Поле `version` з `npm/package.json` на заданому git-ref (`HEAD:npm/package.json`).
  * @param {string} refPath на кшталт `HEAD:npm/package.json`
- * @returns {Promise<string | null>}
+ * @returns {Promise<string | null>} значення поля `version` або `null`, якщо ref недоступний
  */
 async function gitShowNpmPackageVersionAt(refPath) {
   try {
@@ -287,8 +290,8 @@ async function gitShowNpmPackageVersionAt(refPath) {
 
 /**
  * Версія з першого заголовка `## […]` у тексті CHANGELOG.
- * @param {string} changelogText
- * @returns {string | null}
+ * @param {string} changelogText вміст файлу CHANGELOG.md
+ * @returns {string | null} версія з першої секції або `null`, якщо заголовка немає
  */
 function firstChangelogSectionVersion(changelogText) {
   const m = changelogText.match(CHANGELOG_FIRST_VERSION_RE)
@@ -297,8 +300,8 @@ function firstChangelogSectionVersion(changelogText) {
 
 /**
  * Перший реліз у CHANGELOG має збігатися з `version` у `npm/package.json`.
- * @param {(msg: string) => void} passFn
- * @param {(msg: string) => void} failFn
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при виявленому порушенні
  * @returns {Promise<void>}
  */
 async function checkChangelogTopMatchesPackageVersion(passFn, failFn) {
@@ -327,8 +330,8 @@ async function checkChangelogTopMatchesPackageVersion(passFn, failFn) {
 
 /**
  * Незакомічені зміни під `npm/` вимагають підвищення `version` відносно `HEAD`.
- * @param {(msg: string) => void} passFn
- * @param {(msg: string) => void} failFn
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при виявленому порушенні
  * @returns {Promise<void>}
  */
 async function checkDirtyNpmRequiresVersionBump(passFn, failFn) {
@@ -360,6 +363,12 @@ async function checkDirtyNpmRequiresVersionBump(passFn, failFn) {
   passFn(`npm/: незакомічені зміни під npm/ узгоджені з підвищенням version (${headVer} → ${cur})`)
 }
 
+/**
+ * Перевіряє npm-publish.yml workflow на наявність потрібних полів і кроків.
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при виявленому порушенні
+ * @returns {Promise<void>}
+ */
 async function checkPublishWorkflow(passFn, failFn) {
   const publishWf = '.github/workflows/npm-publish.yml'
   if (!existsSync(publishWf)) {

package/scripts/check-php.mjs

@@ -1,79 +1,44 @@
 /**
  * Перевіряє вимоги правила php.mdc для PHP-проєктів.
  *
- * Очікування:
- * - у корені є `composer.json`;
- * - у `package.json` є скрипт `lint-php` (рекомендовано делегувати в `run-php.mjs`);
- * - у `.github/workflows/lint-php.yml` є крок `run: bun run lint-php` (для Bun-репозиторіїв).
+ * **Що тут лишилося** (FS-existence — не покривається conftest):
+ *  - наявність `composer.json` у корені;
+ *  - наявність `.github/workflows/lint-php.yml`.
+ *
+ * **Що покрила Rego** (`bun run lint-conftest`):
+ *  - `npm/policy/php/package_json/` — наявність скрипта `lint-php` у `package.json`;
+ *  - `npm/policy/php/lint_php_yml/` — крок `run: bun run lint-php` у workflow.
  */
 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'
 
 /**
- * Перевіряє наявність `composer.json`.
- * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
+ * Перевіряє відповідність проєкту правилам php.mdc.
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
-function checkComposer(reporter) {
+export async function check() {
+  const reporter = createCheckReporter()
   const { pass, fail } = reporter
+
   if (existsSync('composer.json')) {
     pass('composer.json існує')
   } else {
     fail('composer.json не знайдено в корені — додай (php.mdc)')
   }
-}
 
-/**
- * Перевіряє кореневий `package.json` на скрипт `lint-php`.
- * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
- */
-async function checkPackageJson(reporter) {
-  const { pass, fail } = reporter
   if (!existsSync('package.json')) {
     fail('package.json не знайдено в корені — додай (php.mdc)')
-    return
-  }
-  const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-  const lintPhp = pkg.scripts?.['lint-php']
-  if (lintPhp) {
-    pass('package.json містить скрипт lint-php')
   } else {
-    fail('package.json: додай скрипт "lint-php" (php.mdc)')
+    pass('package.json є (наявність lint-php перевіряє bun run lint-conftest → php.package_json)')
   }
-}
 
-/**
- * Перевіряє workflow `lint-php.yml`.
- * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
- */
-async function checkWorkflow(reporter) {
-  const { pass, fail } = reporter
   const wfPath = '.github/workflows/lint-php.yml'
-  if (!existsSync(wfPath)) {
-    fail(`${wfPath} не існує — створи згідно php.mdc`)
-    return
-  }
-  const content = await readFile(wfPath, 'utf8')
-  pass('lint-php.yml існує')
-  const root = parseWorkflowYaml(content)
-  const ok = root ? anyRunStepIncludes(root, 'bun run lint-php') : content.includes('bun run lint-php')
-  if (ok) {
-    pass('lint-php.yml викликає bun run lint-php')
+  if (existsSync(wfPath)) {
+    pass(`${wfPath} є (структуру перевіряє bun run lint-conftest → php.lint_php_yml)`)
   } else {
-    fail('lint-php.yml має містити крок run: bun run lint-php (php.mdc)')
+    fail(`${wfPath} не існує — створи згідно php.mdc`)
   }
-}
 
-/**
- * Перевіряє відповідність проєкту правилам php.mdc.
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
- */
-export async function check() {
-  const reporter = createCheckReporter()
-  checkComposer(reporter)
-  await checkPackageJson(reporter)
-  await checkWorkflow(reporter)
   return reporter.getExitCode()
 }

package/scripts/check-style-lint.mjs

@@ -1,74 +1,44 @@
 /**
  * Перевіряє CSS/SCSS лінт за правилом style-lint.mdc.
  *
- * Очікування: `@nitra/stylelint-config`, `lint-style` через `npx stylelint`, `.stylelintignore`,
- * workflow `lint-style.yml` (у `run` — лише `npx stylelint`, не `bun run lint-style`), VSCode stylelint,
- * `css.validate` / `scss.validate` / `less.validate`: false.
+ * **Що тут лишилося** (FS / VSCode-конфіги — не покривається conftest):
+ *  - наявність зовнішнього файлу конфігу stylelint (`.stylelintrc.*`,
+ *    `stylelint.config.js`) як альтернатива полю `stylelint` у `package.json`
+ *    (cross-file: треба знати, чи є поле, чи немає);
+ *  - `.stylelintignore` у корені;
+ *  - `.vscode/extensions.json` recommendation `stylelint.vscode-stylelint`;
+ *  - `.vscode/settings.json` `css.validate` / `scss.validate` / `less.validate: false`.
+ *
+ * **Що покрила Rego** (`bun run lint-conftest`):
+ *  - `npm/policy/style_lint/package_json/` — скрипт `lint-style` через `npx stylelint`,
+ *    `@nitra/stylelint-config` у `devDependencies`, поле `stylelint.extends`;
+ *  - `npm/policy/style_lint/lint_style_yml/` — `npx stylelint` у `run` workflow.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
-import { anyRunStepIncludesStylelint, parseWorkflowYaml } from './utils/gha-workflow.mjs'
 
 /**
- * @param {{ pass: (msg: string) => void, fail: (msg: string) => void }} reporter репортер для збору результатів
+ * Альтернатива полю `stylelint` у `package.json` — зовнішній файл конфігу. Якщо
+ * поля немає і файлу немає, фейлимося; якщо є хоч щось — пропускаємо. Поле
+ * `stylelint.extends == "@nitra/stylelint-config"` сам формат — у Rego.
+ * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер
  */
-async function checkPackageJson(reporter) {
+async function checkStylelintConfigPresence(reporter) {
   const { pass, fail } = reporter
   if (!existsSync('package.json')) return
   const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-
-  const lintStyle = pkg.scripts?.['lint-style']
-  if (lintStyle) {
-    pass('package.json містить скрипт lint-style')
-    if (String(lintStyle).includes('npx stylelint')) {
-      pass('lint-style викликає stylelint через npx')
-    } else {
-      fail("lint-style має викликати stylelint через npx — наприклад: npx stylelint '**/*.{css,scss,vue}' --fix")
-    }
-  } else {
-    fail('package.json не містить скрипт "lint-style"')
-  }
-
-  if (pkg.devDependencies?.['@nitra/stylelint-config']) {
-    pass('@nitra/stylelint-config є в devDependencies')
-  } else {
-    fail('@nitra/stylelint-config відсутній — bun add -d @nitra/stylelint-config')
-  }
-
-  const stylelintCfg = pkg.stylelint
+  const hasField = pkg.stylelint && typeof pkg.stylelint === 'object'
   const hasExternalCfg =
     existsSync('.stylelintrc.json') || existsSync('.stylelintrc.js') || existsSync('stylelint.config.js')
-  if (stylelintCfg?.extends === '@nitra/stylelint-config') {
-    pass('package.json stylelint extends @nitra/stylelint-config')
-  } else if (hasExternalCfg) {
-    pass('Окремий файл конфігу stylelint існує')
+  if (hasField || hasExternalCfg) {
+    pass('Конфіг stylelint є — у package.json або окремим файлом')
   } else {
     fail('Немає конфігу stylelint — додай "stylelint": { "extends": "@nitra/stylelint-config" } до package.json')
   }
 }
 
-/**
- * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
- */
-async function checkStylelintWorkflow(reporter) {
-  const { pass, fail } = reporter
-  if (!existsSync('.github/workflows/lint-style.yml')) {
-    fail('.github/workflows/lint-style.yml не існує — створи його')
-    return
-  }
-  const content = await readFile('.github/workflows/lint-style.yml', 'utf8')
-  pass('lint-style.yml існує')
-  const root = parseWorkflowYaml(content)
-  const ok = root ? anyRunStepIncludesStylelint(root) : content.includes('npx stylelint')
-  if (ok) {
-    pass('lint-style.yml містить npx stylelint у кроці run')
-  } else {
-    fail("lint-style.yml має викликати stylelint у CI через npx — наприклад: npx stylelint '**/*.{css,scss,vue}' --fix")
-  }
-}
-
 /**
  * @param {import('./utils/check-reporter.mjs').CheckReporter} reporter репортер для збору результатів
  */
@@ -104,7 +74,7 @@ export async function check() {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  await checkPackageJson(reporter)
+  await checkStylelintConfigPresence(reporter)
 
   if (existsSync('.stylelintignore')) {
     pass('.stylelintignore існує')
@@ -112,7 +82,13 @@ export async function check() {
     fail('.stylelintignore не існує — створи з вмістом: dist/')
   }
 
-  await checkStylelintWorkflow(reporter)
+  const wfPath = '.github/workflows/lint-style.yml'
+  if (existsSync(wfPath)) {
+    pass(`${wfPath} є (структуру перевіряє bun run lint-conftest → style_lint.lint_style_yml)`)
+  } else {
+    fail(`${wfPath} не існує — створи його`)
+  }
+
   await checkVscodeStylelint(reporter)
 
   return reporter.getExitCode()