@nitra/cursor 1.28.5 → 1.28.7

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.28.7] - 2026-05-28
+
+### Fixed
+
+- **`rules/js-lint/coverage/coverage.mjs`** — `n-cursor coverage` із кореня тепер працює у monorepo з частковим покриттям тестами (наприклад, `ai`: тести лише у `gt/`, інші `cf/*`/`run/*` без тестів). До цього перший workspace без тестів обривав ланцюг із `JS coverage exit 1`. Зміни: `defaultRunner.runJsCoverage` отримує `--passWithNoTests` (vitest 4.x — exit 0 у workspace без тестів); `collect()` розпиляно на `collectOneRoot(jsRoot, cwd, runner)` (per-workspace) і публічний агрегатор. `collectOneRoot` повертає `null` для workspace із порожнім lcov — Stryker у такому випадку не запускається. Реальні помилки (vitest exit ≠ 0, mutation.json відсутній при наявних тестах, compile errors) — throw, не маскуються. Якщо тестів немає у жодному workspace — `collect()` повертає `[]`, оркестратор `rules/test/coverage/coverage.mjs:runCoverageSteps` обробляє це як exit 1 із explainer-ом. Helpers `addCoverage`/`addMutation` беруться з `rules/test/coverage/coverage.mjs` (DRY, замість локальних копій). Додано 4 тести: monorepo з порожніми workspaces (skip), all-empty (`[]`), single-package без тестів, vitest exit ≠ 0 у monorepo (throw). ADR — `docs/adr/2026-05-28-coverage-multi-workspace-iteration.md`.
+- **`rules/test/test.mdc`** (`version` 2.4 → 2.5) і дзеркало `.cursor/rules/n-test.mdc` — секція "Multi-workspace iteration" з описом ітерації `resolveAllJsRoots()` і поведінки skip workspaces без тестів.
+
+### Changed
+
+- `abie` rule: `abie.package_json_docs` → `abie.package_json_shared`; пакет, що його перевіряє правило, перейменовано з `@nitra/abie-docs` на `@nitra/abie-shared` (паралель до `efes.package_json_shared` / `@nitra/efes-shared`). Реалізація: `npm/rules/abie/policy/package_json_shared/` (перейменовано з `package_json_docs/`). Bump `abie.mdc` `1.21` → `1.22`. Зачеплено: `.cursor/rules/conftest.mdc`.
+
 ## [1.28.5] - 2026-05-28
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.28.5",
+  "version": "1.28.7",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/abie/abie.mdc

@@ -1,7 +1,7 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.21'
+version: '1.22'
 ---
 
 Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua**)), гілки **dev**, **ua** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
@@ -140,12 +140,12 @@ KVCMS_URL=http://kvcms-hl.ua-apruv.svc.abie-ua.internal:8080
 
 Загальне правило про **внутрішній** URL (не публічний домен) для `HASURA_GRAPHQL_ENDPOINT` лишається у **`hasura.mdc`** (для nitra і abie) — `rules/hasura/fix.mjs` приймає кластерний DNS-формат `<cluster>.internal`.
 
-## `@nitra/abie-docs` у `devDependencies`
+## `@nitra/abie-shared` у `devDependencies`
 
-У кореневому **`package.json`** abie-проєкту в **`devDependencies`** має бути **`@nitra/abie-docs`** — пакет з канонічними контрактами/схемами abie-сервісів (наприклад, шляхи `node_modules/@nitra/abie-docs/...` для імпорту схем). Версію правило не фіксує — лише presence. Додати:
+У кореневому **`package.json`** abie-проєкту в **`devDependencies`** має бути **`@nitra/abie-shared`** — пакет зі спільними abie-ресурсами: канонічні GraphQL-схеми, скіли, типи (наприклад, шляхи `node_modules/@nitra/abie-shared/schema/...` для імпорту схем). Версію правило не фіксує — лише presence. Додати:
 
 ```bash
-bun add -d @nitra/abie-docs
+bun add -d @nitra/abie-shared
 ```
 
 ## Firebase Hosting
@@ -168,7 +168,7 @@ bun add -d @nitra/abie-docs
 - **`health_check_policy/`** → `abie.health_check_policy` — структура HealthCheckPolicy: `apiVersion: networking.gke.io/v1`, `metadata.name`, `spec.default.config.type: HTTP`, `httpHealthCheck.requestPath` починається з `/`, `port: 8080`, `targetRef.kind: Service`, `targetRef.name` має суфікс `-hl`. **Цільові файли:** `…/k8s/.../hc.yaml`.
 - **`base_deployment_preem/`** → `abie.base_deployment_preem` — Deployment у base/ має `spec.template.spec.nodeSelector.preem` зі значенням `true` (boolean або рядок). **Цільові файли:** ресурсні YAML під `…/k8s/.../base/...`.
 - **`clean_merged_ignore_branches/`** → `abie.clean_merged_ignore_branches` — у workflow `.github/workflows/clean-merged-branch.yml` крок з `uses: phpdocker-io/github-actions-delete-abandoned-branches` має `with.ignore_branches`, що містить токени `dev,ua` (case-insensitive). **Цільові файли:** `.github/workflows/clean-merged-branch.yml`.
-- **`package_json_docs/`** → `abie.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/abie-docs` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.
+- **`package_json_shared/`** → `abie.package_json_shared` — у кореневому `package.json` `devDependencies` має містити `@nitra/abie-shared` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.
 
 Cross-file / FS-логіка лишається у JS-частинах (`js/<concern>.mjs`) — Rego не читає файлову систему й не робить cross-document резолюцію:
 

package/rules/abie/policy/{package_json_docs/package_json_docs.rego → package_json_shared/package_json_shared.rego}

@@ -1,16 +1,16 @@
 # Перевірка кореневого `package.json` abie-проєкту: у `devDependencies` має бути
-# `@nitra/abie-docs` (контракти/схеми abie-сервісів — наприклад
-# `node_modules/@nitra/abie-docs/...`). Версію не фіксуємо — лише presence.
+# `@nitra/abie-shared` (контракти/схеми/скіли abie-сервісів — наприклад
+# `node_modules/@nitra/abie-shared/...`). Версію не фіксуємо — лише presence.
 #
 # Inverse-presence перевірка — лишається inline у rego (як `@nitra/cspell-dict`
 # у `text.package_json`), бо у template/ зберігаємо позитивні snippet/deny канони,
 # а не одиничний required-ключ.
-package abie.package_json_docs
+package abie.package_json_shared
 
 import rego.v1
 
 deny contains msg if {
 	dev := object.get(input, "devDependencies", {})
-	not "@nitra/abie-docs" in object.keys(dev)
-	msg := "package.json: devDependencies має містити @nitra/abie-docs — bun add -d @nitra/abie-docs (abie.mdc)"
+	not "@nitra/abie-shared" in object.keys(dev)
+	msg := "package.json: devDependencies має містити @nitra/abie-shared — bun add -d @nitra/abie-shared (abie.mdc)"
 }

package/rules/abie/policy/{package_json_docs → package_json_shared}/target.json

@@ -1,5 +1,5 @@
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
   "files": { "single": "package.json", "required": true },
-  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/abie-docs'] (abie.mdc)"
+  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/abie-shared'] (abie.mdc)"
 }

package/rules/js-bun-db/js-bun-db.mdc

@@ -46,6 +46,60 @@ PostgreSQL 18+, MariaDB 10.6+ (сумісний з MySQL-протоколом,
 
 Для multi-row `VALUES` у `MERGE` / `INSERT` з конкретними типами — паралельні масиви по колонках і `unnest($1::TYPE[], $2::TYPE[], ...) AS t(col1, col2, ...)`. Кожна колонка передається одним параметром-масивом; типи задаються кастом масиву (`::uuid[]`, `::bigint[]`, `::numeric[]`, `::text[]`, …).
 
+#### Приклад: MERGE з UNNEST і динамічними колонками
+
+```javascript
+// ❌ format + pgWrite.unsafe — N×7 окремих значень, план змінюється при кожному batch.length
+const valuesSql = batch
+  .map(row => format('(%L::int, %L::date, %L::jsonb)', row.id, row.date, JSON.stringify(row.data)))
+  .join(',')
+const sql = format(`MERGE INTO t USING (VALUES %s) AS s(id, date, data) ON ...`, valuesSql)
+await pgWrite.unsafe(sql)
+
+// ✅ UNNEST — 3 параметри незалежно від розміру batch; план стабільний і може кешуватись
+const ids   = batch.map(r => r.id)
+const dates = batch.map(r => r.date)
+const data  = batch.map(r => JSON.stringify(r.data))
+
+await pgWrite`
+  WITH s(id, date, data) AS (
+    SELECT * FROM unnest(
+      ${ids}::int[],
+      ${dates}::date[],
+      ${data}::jsonb[]
+    )
+  )
+  MERGE INTO my_table AS t
+  USING s ON t.id = s.id
+  WHEN MATCHED THEN
+    UPDATE SET date = s.date, data = s.data
+  WHEN NOT MATCHED THEN
+    INSERT (id, date, data) VALUES (s.id, s.date, s.data)
+`
+```
+
+Якщо частина колонок у SET/INSERT залежить від параметра (plan/fact, тип тощо) — динамічні імена колонок не можна параметризувати через `${value}`; використовуй умовні Bun SQL фрагменти:
+
+```javascript
+// ✅ умовні фрагменти для динамічних ідентифікаторів колонок
+const colFrag  = isPlan ? pgWrite`plan_value`  : pgWrite`fact_value`
+const hashFrag = isPlan ? pgWrite`hash = s.hash,` : pgWrite``
+
+await pgWrite`
+  ...
+  WHEN MATCHED THEN
+    UPDATE SET
+      ${colFrag} = s.value,
+      ${hashFrag}
+      updated_by = s.updated_by
+  WHEN NOT MATCHED THEN
+    INSERT (id, ${colFrag}, updated_by)
+    VALUES (s.id, s.value, s.updated_by)
+`
+```
+
+`UNION ALL`-цикл замість `unnest` підходить для малих динамічних запитів (2–5 рядків), де кожна гілка семантично різна. Для bulk upsert — завжди `unnest`.
+
 ### Заборонений «drop-in» шим
 
 ```javascript
@@ -285,6 +339,26 @@ const ids = [1, 2, 3]
 await sql`SELECT * FROM users WHERE id IN ${sql(ids)}`
 ```
 
+Multi-row INSERT з масиву об'єктів — `sql(rows)` генерує column list і VALUES автоматично:
+
+```javascript
+// ❌ format + pgWrite.unsafe — ручне склеювання рядків, injection-вектор
+const insertWfQry = `insert into approval.workflow (request_id, job_title_id, name, status)
+  values ${approverJobs.map(job => `('${request.id}', ${job.id}, '${job.short_name}', 'pending')`).join(', ')}`
+await pgWrite.unsafe(insertWfQry)
+
+// ✅ sql(rows) — один параметр-масив, bind через wire-protocol
+const wfRows = approverJobs.map(job => ({
+  request_id: request.id,
+  job_title_id: job.id,
+  name: job.short_name,
+  status: job.id === nextJobId ? 'current' : 'pending'
+}))
+await sql`INSERT INTO approval.workflow ${sql(wfRows)}`
+```
+
+Коли потрібен стабільний план для великих batch'ів (N > 20) або строгі типи колонок — використовуй `unnest` (деталі у `#### Приклад: MERGE з UNNEST і динамічними колонками`). Для невеликих INSERT'ів де колонки відомі — `sql(rows)` коротший і зрозуміліший.
+
 ## `IN (...)`: значення з template literal — тільки через змінну + guard на пустоту
 
 Якщо список для `IN (...)` підставляється через `${...}` у template literal, його **потрібно**:

package/rules/js-lint/coverage/coverage.mjs

@@ -13,6 +13,7 @@ import { tmpdir } from 'node:os'
 import { join, relative } from 'node:path'
 
 import { resolveAllJsRoots } from '../../../scripts/utils/resolve-js-root.mjs'
+import { addCoverage, addMutation } from '../../test/coverage/coverage.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
@@ -210,12 +211,23 @@ export function parseStrykerReport(report, jsRoot) {
 /**
  * Default runner — спавнить реальні bun-команди через `node:child_process.spawnSync`
  * (працює і в Node-runtime через shebang `n-cursor`, і в Bun). Замінюється у тестах.
+ *
+ * Прапор `--passWithNoTests` робить vitest non-failing у workspaces без тестів
+ * (типовий патерн monorepo, де тести зосереджені в одному пакеті); пустий lcov
+ * у такому випадку сигналізує "no tests" → collectOneRoot пропускає workspace.
  */
 const defaultRunner = {
   runJsCoverage({ cwd, lcovDir }) {
     const r = spawnSync(
       'bunx',
-      ['vitest', 'run', '--coverage', '--coverage.reporter=lcov', `--coverage.reportsDirectory=${lcovDir}`],
+      [
+        'vitest',
+        'run',
+        '--passWithNoTests',
+        '--coverage',
+        '--coverage.reporter=lcov',
+        `--coverage.reportsDirectory=${lcovDir}`
+      ],
       { cwd, stdio: 'inherit', env: process.env }
     )
     return r.status ?? 1
@@ -227,91 +239,108 @@ const defaultRunner = {
 }
 
 /**
- * Збирає JS-метрики покриття + мутаційного тестування. У monorepo ітерує кожен
- * JS-root з `resolveAllJsRoots()` (включно з glob-патернами на кшталт `cf/*`),
- * запускає vitest+Stryker у кожному та сумує lcov/mutation. Шляхи файлів у
- * `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs` знаходив джерела.
+ * Збирає метрики покриття + мутаційного тестування для **одного** JS-root.
+ * Пропускає workspace без тестів (повертає `null`): vitest у такому випадку
+ * пройшов з `--passWithNoTests`, але lcov порожній — нема сенсу запускати
+ * Stryker. Реальні помилки (vitest exit ≠ 0, mutation.json відсутній попри
+ * наявні тести) кидаються — у multi-root режимі це не маскує справжній збій.
+ * @param {string} jsRoot абсолютний шлях до workspace-кореня
+ * @param {string} cwd корінь проєкту (для рібейзингу `survived[].file`)
+ * @param {{runJsCoverage:Function, runStryker:Function}} runner spawn-ін'єкція
+ * @returns {Promise<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>} | null>} результати або null коли workspace без тестів
+ */
+async function collectOneRoot(jsRoot, cwd, runner) {
+  const wsRel = relative(cwd, jsRoot)
+
+  // 1. Coverage через vitest run --passWithNoTests --coverage
+  const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
+  let coverage
+  try {
+    const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
+    if (code !== 0) throw new Error(`JS coverage exit ${code}`)
+    const lcovPath = join(lcovDir, 'lcov.info')
+    coverage = existsSync(lcovPath)
+      ? parseLcov(await readFile(lcovPath, 'utf8'))
+      : { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  } finally {
+    await rm(lcovDir, { recursive: true, force: true })
+  }
+
+  // Порожній lcov ⇔ vitest з --passWithNoTests не знайшов тестів. Пропускаємо
+  // workspace, щоб не запускати Stryker марно і не псувати агрегат.
+  const hasTests = coverage.lines.total > 0 || coverage.functions.total > 0
+  if (!hasTests) return null
+
+  // 2. Mutation через Stryker
+  await runner.runStryker({ cwd: jsRoot })
+  const mutationPath = join(jsRoot, 'reports', 'stryker', 'mutation.json')
+  if (!existsSync(mutationPath)) {
+    throw new Error(
+      'js-lint coverage: stryker не залишив mutation.json — ' +
+        'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
+        'або налаштуй його вручну'
+    )
+  }
+  const mutationReport = JSON.parse(await readFile(mutationPath, 'utf8'))
+  const parsed = parseStrykerReport(mutationReport, jsRoot)
+
+  return {
+    coverage,
+    mutation: { caught: parsed.caught, total: parsed.total },
+    survived: parsed.survived.map(group => ({
+      ...group,
+      file: wsRel === '' ? group.file : join(wsRel, group.file),
+      exampleTest: group.exampleTest
+        ? {
+            ...group.exampleTest,
+            testFile: wsRel === '' ? group.exampleTest.testFile : join(wsRel, group.exampleTest.testFile)
+          }
+        : null
+    }))
+  }
+}
+
+/**
+ * Збирає JS-метрики покриття + мутаційного тестування. У monorepo ітерує усі
+ * JS-roots з `resolveAllJsRoots()` (включно з glob-патернами `cf/*`), запускає
+ * vitest+Stryker у кожному та сумує lcov/mutation через `addCoverage`/`addMutation`
+ * з оркестратора. Workspaces без тестів пропускаються (див. `collectOneRoot`).
+ * Якщо тестів немає у жодному workspace — повертає `[]`; оркестратор
+ * `rules/test/coverage/coverage.mjs:runCoverageSteps` обробить це як exit 1
+ * з зрозумілим повідомленням ("Жодного провайдера покриття не знайдено").
+ * Шляхи у `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs`
+ * знаходив джерела через `join(projectRoot, file)`.
  * @param {string} cwd корінь проєкту
  * @param {{runner?: typeof defaultRunner}} [opts] runner-ін'єкція для тестів
- * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}}>>} рядки для COVERAGE.md
+ * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>>} рядок `JS` або `[]` коли тестів нема ніде
  */
 export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
   const jsRoots = await resolveAllJsRoots(cwd)
   if (jsRoots.length === 0) throw new Error('js-lint coverage: package.json не знайдено')
 
-  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
-  let mutation = { caught: 0, total: 0 }
-  const survived = []
-
+  const results = []
   for (const jsRoot of jsRoots) {
-    const wsRel = relative(cwd, jsRoot)
-
-    // 1. Coverage через vitest run --coverage (v8 provider пише lcov.info у lcovDir)
-    const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
-    try {
-      const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
-      if (code !== 0) throw new Error(`JS coverage exit ${code}`)
-      coverage = addCoverage(coverage, parseLcov(await readFile(join(lcovDir, 'lcov.info'), 'utf8')))
-    } finally {
-      await rm(lcovDir, { recursive: true, force: true })
-    }
-
-    // 2. Mutation через Stryker
-    await runner.runStryker({ cwd: jsRoot })
-    let mutationReport
-    try {
-      mutationReport = JSON.parse(await readFile(join(jsRoot, 'reports', 'stryker', 'mutation.json'), 'utf8'))
-    } catch {
-      throw new Error(
-        'js-lint coverage: stryker не залишив mutation.json — ' +
-          'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
-          'або налаштуй його вручну'
-      )
-    }
-    const parsed = parseStrykerReport(mutationReport, jsRoot)
-    mutation = addMutation(mutation, { caught: parsed.caught, total: parsed.total })
-
-    for (const group of parsed.survived) {
-      survived.push({
-        ...group,
-        file: wsRel === '' ? group.file : join(wsRel, group.file),
-        exampleTest: group.exampleTest
-          ? {
-              ...group.exampleTest,
-              testFile: wsRel === '' ? group.exampleTest.testFile : join(wsRel, group.exampleTest.testFile)
-            }
-          : null
-      })
-    }
+    const r = await collectOneRoot(jsRoot, cwd, runner)
+    if (r !== null) results.push(r)
   }
 
-  return [{ area: 'JS', coverage, mutation, survived }]
-}
-
-/**
- * Сумування coverage-totals — імпортується з оркестратора при потребі; тут
- * локальна копія, щоб уникнути циклу test/coverage → js-lint/coverage.
- * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} a перший
- * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} b другий
- * @returns {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} сума
- */
-function addCoverage(a, b) {
-  return {
-    lines: { covered: a.lines.covered + b.lines.covered, total: a.lines.total + b.lines.total },
-    functions: {
-      covered: a.functions.covered + b.functions.covered,
-      total: a.functions.total + b.functions.total
-    }
+  if (results.length === 0) {
+    console.error(
+      'js-lint coverage: жоден workspace не має тестів ' +
+        '(`*.test.{js,mjs}` у `tests/` або поряд із джерелом) — ' +
+        'додай тести або вилучи `js-lint` з .n-cursor.json#rules'
+    )
+    return []
   }
-}
 
-/**
- * Сумування mutation-counts.
- * @param {{caught:number,total:number}} a перший
- * @param {{caught:number,total:number}} b другий
- * @returns {{caught:number,total:number}} сума
- */
-function addMutation(a, b) {
-  return { caught: a.caught + b.caught, total: a.total + b.total }
+  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  let mutation = { caught: 0, total: 0 }
+  const survived = []
+  for (const r of results) {
+    coverage = addCoverage(coverage, r.coverage)
+    mutation = addMutation(mutation, r.mutation)
+    survived.push(...r.survived)
+  }
+  return [{ area: 'JS', coverage, mutation, survived }]
 }

package/rules/style-lint/style-lint.mdc

@@ -5,6 +5,92 @@ globs: "**/*.{css,scss,vue}"
 alwaysApply: false
 ---
 
+## Quasar як стильова основа
+
+У Vue-проектах використовуй **Quasar** як базову стильову систему:
+
+- **Класи компонентів:** `q-pa-*`, `q-ma-*`, `q-mt-*`, `q-mb-*`, `row`, `col`, `col-*`, `items-center`, `justify-between`, `text-*`, `bg-*`, `shadow-*` тощо — стандартні утиліти Quasar.
+- **Кольори:** використовуй Quasar CSS-змінні через класи (`text-primary`, `bg-accent`, `text-negative` тощо) або через SCSS-змінні (`$primary`, `$accent`) у `.scss`-файлах.
+- **Не пиши власні утиліти**, якщо є відповідний Quasar-клас.
+
+## Кольори: quasar-variables.scss і app.scss
+
+Основні кольори визначай виключно через стандартні Quasar-змінні: `$primary`, `$secondary`, `$accent`, `$positive`, `$negative`, `$warning`.
+
+Якщо потрібен додатковий колір — визнач його в `quasar-variables.scss`, і **обов'язково** додай до `app.scss` відповідні `.text-*` / `.bg-*` класи:
+
+```scss
+/* quasar-variables.scss */
+$white-a1: color.adjust(white, $alpha: -0.85);
+```
+
+```scss
+/* app.scss */
+.text-white-a1 {
+  color: $white-a1 !important;
+}
+
+.bg-white-a1 {
+  background-color: $white-a1 !important;
+}
+```
+
+## Gap між flex/grid-елементами — .n-gap-*
+
+Для відступів між плаваючими елементами (flex, grid) використовуй класи `.n-gap-*` замість `q-gutter-*`. Якщо класів немає в `app.scss` — додай:
+
+```scss
+// GAP
+.n-gap-xs {
+  gap: 4px;
+}
+
+.n-gap-sm {
+  gap: 8px;
+}
+
+.n-gap-md {
+  gap: 16px;
+}
+
+.n-gap-lg {
+  gap: 24px;
+}
+```
+
+## Фікси компонентів Quasar
+
+При використанні компонента `q-scroll-area` або `q-tooltip` додай до `app.scss` відповідні фікси. Аналогічно — фікс масштабування на iOS.
+
+```scss
+// FIX стилі для прокручуваної області по висоті екрана
+.q-scrollarea {
+  display: flex;
+  flex-direction: column;
+  height: auto;
+  min-height: 0;
+  max-height: 100%;
+
+  .scroll {
+    flex: 10000 1 0%;
+  }
+}
+
+// FIX tooltip
+.q-tooltip {
+  font-size: 1em;
+}
+
+// FIX не зумувати на iOS
+@media (width <= 600px) {
+  input,
+  textarea,
+  select {
+    font-size: 16px;
+  }
+}
+```
+
 ## Генерація та редагування стилів (Cursor і інші агенти)
 
 - **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам’яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
@@ -94,3 +180,92 @@ jobs:
 ```text title=".stylelintignore"
 dist/
 ```
+
+## Адмінські таблиці — n-admin-table
+
+Для таблиць, що мають займати всю висоту сторінки (або блоку), додавай клас `n-admin-table` і атрибути `hide-no-data`, `dense`, `flat`. Таблиця автоматично розтягнеться на весь доступний простір. У блоках меншої висоти — задай їм явний `height`.
+
+```vue
+<!-- ТАБЛИЦЯ -->
+<q-table class="n-admin-table" hide-no-data flat dense />
+```
+
+Якщо клас `.n-admin-table` не визначено в `app.scss` — додай:
+
+```scss
+// ADMIN TABLE
+.n-admin-table {
+  height: calc(100vh - 106px);
+
+  thead {
+    position: sticky;
+    z-index: 3;
+    top: 0;
+
+    tr th {
+      background-color: $grey-3;
+      height: 36px !important;
+    }
+  }
+
+  // tbody td {
+  //   font-size: 14px;
+  // }
+
+  tbody tr:last-child td {
+    border-bottom: 1px solid rgb(0 0 0 / 12%) !important;
+  }
+
+  th:first-child,
+  td:first-child,
+  th:last-child,
+  td:last-child {
+    width: 1px;
+    white-space: nowrap;
+  }
+
+  .q-table__bottom {
+    background-color: $grey-3;
+  }
+
+  .q-table__progress th {
+    height: 1px !important;
+  }
+
+  .text-wrap {
+    max-width: 250px;
+    white-space: normal;
+  }
+
+  // sticky columns
+  td.sticky-left {
+    position: sticky;
+    left: 0;
+    z-index: 2;
+    background-color: white;
+    box-shadow: 2px 0 5px #0002;
+  }
+
+  td.sticky-right {
+    position: sticky;
+    right: 0;
+    z-index: 2;
+    background-color: white;
+    box-shadow: -2px 0 5px #0002;
+  }
+
+  th.sticky-left {
+    position: sticky;
+    left: 0;
+    z-index: 3;
+    box-shadow: 2px 0 5px #0002;
+  }
+
+  th.sticky-right {
+    position: sticky;
+    right: 0;
+    z-index: 3;
+    box-shadow: -2px 0 5px #0002;
+  }
+}
+```

package/rules/test/test.mdc

@@ -1,6 +1,6 @@
 ---
 description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.js (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
-version: '2.4'
+version: '2.5'
 globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,vitest.config.js,.cargo/mutants.toml},**/*.test.mjs"
 alwaysApply: false
 ---
@@ -91,6 +91,10 @@ Canonical `vitest.config.js` (для довідки — `pool: 'forks'` + `inclu
 
 Канон `scripts.coverage` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
 
+### Multi-workspace iteration
+
+У monorepo `n-cursor coverage` ітерує усі workspaces з власним `package.json` (через `resolveAllJsRoots()`, з розгортанням glob-патернів `cf/*`/`packages/*`) і агрегує метрики lcov + Stryker у єдиний `JS`-рядок `COVERAGE.md`. Workspace без тестів пропускається без помилки (vitest викликається з `--passWithNoTests`, порожній lcov → skip-сигнал, Stryker не запускається). `n-cursor coverage` падає лише коли тестів немає в **жодному** workspace проєкту або коли vitest повертає non-zero exit (реальний test failure / compile error — це не маскується).
+
 ## Налаштування mutation-testing
 
 Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` + `vitest.config.js` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` + `app/vitest.config.js` і `scripts/stryker.config.mjs` + `scripts/vitest.config.js`.

package/rules/vue/vue.mdc

@@ -12,18 +12,30 @@ alwaysApply: false
 ```javascript
 const vue3CompositionApiBestPractices = [
   'Використовуй функцію setup() для логіки компонента',
-  'Реалізуй computed properties через $computed()',
-  'Використовуй watch і watchEffect для side effects',
+  'Реалізуй computed змінні через $computed()',
+  'Реалізуй ref змінні через $ref',
+  'Використовуй watch і watchEffect для побічних ефектів',
   'Підключай lifecycle hooks: onMounted, onUpdated тощо',
-  'не використовуй provide/inject для dependency injection'
+  'Для глибоко вкладених залежностей використовуй composables, props/emits або store'
+  'не використовуй provide/inject для залежностей'
 ]
 ```
 
+## Quasar як UI-основа
+
+У Vue-проектах використовуй **Quasar** як базовий UI-фреймворк:
+
+- **Компоненти:** `q-btn`, `q-input`, `q-select`, `q-table`, `q-dialog`, `q-card`, `q-layout`, `q-page`, `q-drawer` тощо — основа UI.
+- **Плагіни:** `Notify`, `Dialog`, `Loading` та інші Quasar-плагіни.
+- **Кольори:** використовуй Quasar CSS-змінні (`primary`, `secondary`, `accent`, `positive`, `negative`, `warning`, `info`, `dark`) і утиліти (`text-primary`, `bg-accent` тощо).
+- **Утиліти:** flex-layout (`row`, `col`, `items-center`), spacing (`q-pa-md`, `q-mt-sm`), shadow (`shadow-2`) — зі стандартної бібліотеки Quasar.
+- **Кастомні компоненти** `@nitra/components` — **надбудова** над Quasar, а не заміна; їх слід надавати перевагу лише там, де вони є (див. розділ `@nitra/components` нижче).
+
 ## Структура папок
 
 ```javascript
 const folderStructure = `
-src/
+  src/
   components/
   composables/
   views/
@@ -76,7 +88,7 @@ const additionalInstructions = `
 
 ### Патерни та антипатерни
 
-- **provide/inject** — для глибоко вкладених залежностей; **renderless**-компоненти / **slots** — коли логіку відділяєш від розмітки.
+- Для глибоко вкладених залежностей використовуй **composables**, **props/emits** або **store**; **renderless**-компоненти / **slots** — коли логіку відділяєш від розмітки.
 - **HTTP:** окремі модулі **services** або **composables** для API; **async/await**.
 - **Події:** батько–дитина через **emits**; для не пов’язаних гілок — **store**.
 - Не мутуй **props** напряму — оновлення через подію вгору або v-model.
@@ -343,6 +355,292 @@ import path from 'node:path'
 Правило стосується саме `.vue` файлів. Допоміжні `.ts`/`.js` модулі, які споживаються лише server-side
 (наприклад, окремий пакет утіліт), можуть імпортувати Node-built-ins без обмежень.
 
+## @nitra/components — надавай перевагу перед Quasar-компонентами
+
+При створенні нової функціональності використовуй компоненти `@nitra/components`, якщо логіка компонента дозволяє отримати потрібний функціонал. Заміни:
+
+| Завдання | `@nitra/components` | Замість Quasar |
+| --- | --- | --- |
+| Діалоги | `NDialog` | `q-dialog` |
+| Multi-вибір | `NSelectMulti` | `q-select` (multiple) |
+| Текстовий редактор | `NEditor` | `q-editor` |
+| Вибір дати | `NDate` | — |
+| Вибір місяця/року | `NDateMonthYear` | — |
+| Діапазон дат | `NDateRange` | — |
+| Дата і час | `NDateTime` | — |
+| Drag&drop список | `NDraggableList` | — |
+| Редаговане значення | `NEditableString` | — |
+| Повідомлення | `NCallout` | — |
+| Хедер проекту | `NHeader` | — |
+| Перемикання мов | `NLang` | — (якщо `NHeader` не використовується) |
+| Меню проекту | `NMenu` | — |
+| Зображення (масив / одиночне) | `NImages` | — |
+| Завантаження файлів | `NUploader` | — |
+| Вибір колонок `q-table` | `NTableColumns` | — |
+
+## NHeader — телепорт-слоти на сторінках
+
+У проектах з `NHeader` використовуй `<teleport>` для вбудовування контенту сторінки в шапку:
+
+| Слот | Призначення |
+| --- | --- |
+| `#header-subtitle` | Заголовок сторінки (якщо потрібно перевизначити subtitle) |
+| `#header-center` | Важливі повідомлення та елементи управління |
+| `#header-filters` | Фільтри, кнопки та інші елементи управління сторінки |
+
+Оскільки `NHeader` за замовчуванням темний, додавай до полів і селектів у телепортах: `dark`, `standout="bg-white text-primary"`, `:options-dark="false"`.
+
+Завжди обгортай `<teleport>` в `v-if="mounted"` (де `mounted` — `$ref(false)`, що встановлюється в `onMounted`), щоб уникнути помилки відсутності target-елемента при SSR / першому рендері.
+
+```vue
+<template>
+  <q-page>
+    <!-- ФІЛЬТРИ В ШАПЦІ -->
+    <teleport v-if="mounted" to="#header-filters">
+      <div class="col row items-center n-gap-sm q-pa-sm">
+        <q-input
+          v-model="pageStore.filterName"
+          :label="t`Поиск по названию`"
+          debounce="200"
+          standout="bg-white text-primary"
+          clearable
+          dense
+          dark
+          class="col"
+          style="min-width: 120px">
+          <template #prepend>
+            <q-icon name="search" />
+          </template>
+        </q-input>
+
+        <n-select-multi
+          v-model="pageStore.filterRequestTypes"
+          :options="requestTypeOptions"
+          :label="t`Тип запроса`"
+          dark
+          standout="bg-white text-primary"
+          :options-dark="false"
+          style="min-width: 180px; max-width: 400px"
+          dense
+          emit-value
+          map-options
+          clearable
+          searchable
+          :stack-label="false" />
+
+        <q-btn
+          @click="addItem"
+          icon="add"
+          :label="t`Добавить`"
+          color="primary"
+          no-caps
+          padding="8px 12px"
+          unelevated />
+      </div>
+    </teleport>
+
+    <!-- ОСНОВНИЙ КОНТЕНТ -->
+    ...
+  </q-page>
+</template>
+<script setup>
+const mounted = $ref(false)
+onMounted(() => { mounted = true })
+</script>
+```
+
+## @nitra/tfm — переклади
+
+Використовуй `@nitra/tfm` для всіх текстів. Переклади для всіх мов проекту оголошуй наприкінці `<script setup>` у функції `getTr()`. Змінна `lang` із `@nitra/tfm` — для визначення або зміни поточної мови застосунку.
+
+```vue
+<template>
+  {{ lang }}
+  {{ t`Анкеты` }}
+  {{ subtitle }}
+</template>
+<script setup>
+import { lang, tf as tfm } from '@nitra/tfm'
+const t = tfm.bind({ tr: getTr() })
+const subtitle = $computed(() => t`Анкеты`)
+
+/**
+ * LOCALIZATION
+ * @returns {object} translations
+ */
+function getTr() {
+  return {
+    Анкеты: { en: 'Surveys', ro: 'Sondaje', tr: 'Anketler' }
+  }
+}
+</script>
+```
+
+## Layout з NHeader
+
+Для нових layout-ів використовуй `NHeader` з вбудованими `NLang` і `NMenu`.
+
+```vue
+<template>
+  <q-layout view="hHh Lpr lFf">
+    <n-header
+      v-model="leftSideOpened"
+      :logo="baseUrl + 'logo.png'"
+      :logo-url="homeUrl"
+      title="My App"
+      :subtitle="subtitle"
+      :username="userName"
+      toolbar-dark>
+      <template #top-toolbar>
+        <div class="platform-ios-only q-py-lg" />
+      </template>
+      <div>default slot content</div>
+    </n-header>
+
+    <!-- ЛЕВАЯ КОЛОНКА -->
+    <q-drawer v-model="leftSideOpened" :breakpoint="700" :width="300" overlay class="col column shadow-5 bg-grey-1">
+      <div class="platform-ios-only q-py-lg" />
+      <div v-if="!$q.screen.gt.xs" class="q-pa-sm row items-center">
+        <q-icon name="account_circle" color="primary" size="32px" class="q-mr-sm" />
+        <div class="text-subtitle1">{{ user.name }}</div>
+      </div>
+      <n-menu v-model="activeMenu" :menu="menu" />
+      <q-space />
+      <n-menu :menu="homeMenu" />
+      <div class="platform-ios-only q-py-md" />
+    </q-drawer>
+
+    <q-page-container>
+      <router-view />
+    </q-page-container>
+  </q-layout>
+</template>
+<script setup>
+import { lang, tf as tfm } from '@nitra/tfm'
+const t = tfm.bind({ tr: getTr() })
+
+const baseUrl = import.meta.env.BASE_URL
+const homeUrl = String.raw`https:\\` + import.meta.env.VITE_DOMAIN
+
+// Ліва колонка
+const leftSideOpened = $ref(false)
+const activeMenu = $ref(null)
+
+// Заголовок у шапці з поточного пункту меню
+const subtitle = computed(() => (activeMenu ? getTr()[activeMenu.labelKey]?.[lang.value] || activeMenu?.labelKey : ''))
+
+// Меню
+const menu = computed(() =>
+  [
+    {
+      icon: 'sym_o_store',
+      label: t`Клиенты`,
+      labelKey: t`Клиенты`,
+      routeName: 'customer'
+    },
+    {
+      icon: 'sym_o_route',
+      label: t`Маршруты и визиты`,
+      items: [
+        {
+          icon: 'sym_o_route',
+          label: t`Маршруты`,
+          labelKey: t`Маршруты`,
+          routeName: 'route'
+        },
+        {
+          icon: 'sym_o_event_upcoming',
+          label: t`Переносы маршрутов`,
+          labelKey: t`Переносы маршрутов`,
+          routeName: 'route_postpone'
+        }
+      ]
+    }
+  ].filter(item => {
+    if (item.items?.length) {
+      item.items = item.items.filter(i => can[i.permissionRoute || i.routeName])
+      return item.items.length > 0
+    }
+    return can[item.routeName]
+  })
+)
+
+/**
+ * LOCALIZATION
+ * @returns {object} translations
+ */
+function getTr() {
+  return {
+    Клиенты: { en: 'Customers', ro: 'Clienți', tr: 'Müşteriler' }
+  }
+}
+</script>
+```
+
+## Pinia store для стану сторінки
+
+Зберігай у Pinia store:
+
+- вибрані значення фільтрів
+- вибрані для відображення колонки (`NTableColumns`)
+- кількість записів на сторінці (pagination)
+
+Називай store за назвою сторінки або компонента — `customerPageStore`, `routePageStore` тощо. На сторінці звертайся до нього через змінну `pageStore`.
+
+```javascript
+// store/customerPage.js
+export const useCustomerPageStore = defineStore('customerPage', {
+  state: () => ({
+    filterName: '',
+    filterStatus: [],
+    columns: [],
+    rowsPerPage: 20
+  })
+})
+```
+
+```vue
+<script setup>
+const pageStore = useCustomerPageStore()
+</script>
+```
+
+## Коментарі в `<template>`
+
+Додавай коментарі в `<template>` відповідно до логічного призначення блоку. Коментарі допомагають швидко орієнтуватися в розмітці.
+
+```vue
+<template>
+  <q-page>
+    <!-- ФІЛЬТРИ В ШАПЦІ -->
+    <teleport v-if="mounted" to="#header-filters">...</teleport>
+
+    <!-- ТАБЛИЦЯ -->
+    <q-table ... />
+
+    <!-- ДІАЛОГ РЕДАГУВАННЯ -->
+    <n-dialog v-model="editDialog">...</n-dialog>
+  </q-page>
+</template>
+```
+
+## Статичні файли — BASE_URL
+
+Для підключення статичних файлів не використовуй відносні шляхи. Завжди будуй URL через `import.meta.env.BASE_URL`:
+
+```vue
+<!-- Погано -->
+<img src="/logo.png" />
+<img src="./assets/logo.png" />
+
+<!-- Добре -->
+<img :src="baseUrl + 'logo.png'" />
+```
+
+```javascript
+const baseUrl = import.meta.env.BASE_URL
+```
+
 ## Перевірка
 
 `npx @nitra/cursor fix vue` — перевіряє залежності, `vite.config`, наявність **`src/vite-env.d.ts`** з `/// <reference types="vite/client" />` та **`jsconfig.json`** у корені Vue-пакета; обходить джерела Vue-пакета (`.vue`, `.ts`, `.js` тощо) на заборонені value-імпорти з модуля `vue` (дозволені лише type-only та side-effect `import 'vue'`) і додатково сканує `.vue` SFC на імпорти Node-нативних модулів (`node:*` префікс або bare-ім’я вбудованого модуля Node — `fs`, `path`, `timers/promises` тощо). Імпорти аналізуються через **oxc-parser** (`module.staticImports`); для `.vue` вміст `<script>` витягується з SFC, далі той самий парсер (логіка в `npm/rules/vue/js/packages/vue-forbidden-imports.mjs`).

package/skills/llm-patch/SKILL.md

@@ -25,6 +25,54 @@ description: >-
   на XML-тегах, file refs (`path/to/file.ts:42`), markdown.
 - **Один блок виводу:** результат — це **один** markdown-блок у відповіді
   чату, готовий до копіювання.
+- **Лаконічність — головне:** промпт містить **інтент + покажчики**, а не
+  цитати + готовий код. Цільова LLM має повний доступ до свого CWD через
+  `Read`/`Grep`/`Glob` і прочитає актуальний стан сама — наш патч не повинен
+  дублювати те, до чого вона додумається з 2-3 файлів.
+
+## Що **не** включати у промпт (cut list)
+
+Цільова LLM сама прочитає файли — не дублюй їх. Викидай:
+
+- **Великі цитати коду** з файлів, які LLM знайде за file ref. Замість блоку
+  з 30 рядками функції — один рядок: `див. rules/foo/bar.mjs:120-150 (collect)`.
+  Цитуй **тільки**: вже видалений код (тобто LLM його не знайде), або фрагмент
+  з зовнішнього джерела (логи, stderr, помилка з CI).
+- **Готові імплементації** ("ось як має виглядати новий `defaultRunner`")
+  з повним кодом. Опиши інтент і обмеження — LLM напише код сама й краще
+  під поточний стиль файлу. Виняток: один-два рядки, які важко описати словами
+  (наприклад, точна назва прапора CLI).
+- **Покрокові підказки рівня "крок 1: import X, крок 2: split into a) і b)…"**
+  з псевдо-кодом. Це передчасна архітектура — описуй **бажану поведінку**
+  (input → output, edge cases), а декомпозицію довір LLM.
+- **Повний вміст `package.json`, конфігів, helpers** — досить імені поля та
+  значення, що змінюється: `engines.node: ">=22" → ">=25"`. Якщо значення
+  специфічне (peer ranges, exports map) — цитуй **тільки цей фрагмент**.
+- **Огляд альтернатив, які ти відкинув,** із розгорнутими аргументами. Один
+  рядок: "розглянутий варіант X відкинуто — Y" або взагалі прибрати, якщо
+  LLM сама дійде того самого висновку.
+- **Списки існуючих helpers ("вже є addCoverage у rules/test/coverage")** —
+  досить рядка-покажчика; LLM зайде `Grep`'ом і прочитає сигнатуру сама.
+- **Дублювання правил репо** (`CLAUDE.md`, `.cursor/rules/*.mdc`) — досить
+  згадки "дотриматись n-test.mdc"; LLM прочитає файл сама.
+- **Готовий `tree -L 2`-дамп** — досить рядка "монорепо з workspaces
+  cf/_, run/_, gt (bun)"; повна структура майже завжди шум.
+- **Самоочевидні acceptance-checks** ("тести зелені", "лінтер чистий") —
+  пиши тільки специфічні до завдання ("на репо `ai`: `bun run coverage`
+  не падає з `JS coverage exit 1`").
+
+## Що **обов'язково** включити
+
+- **Інтент** — 1-3 речення, що саме треба і чому (1 речення на причину).
+- **Симптом / репро,** якщо це bugfix: справжній stderr, точна команда,
+  exit code. Це **не** виводиться з коду — без нього LLM не знає, що
+  саме ламається.
+- **File refs** на ключові точки правки: `path:line` або `path:line-range`,
+  з одним рядком пояснення кожна.
+- **Реальні обмеження,** які не виводяться з коду: версії в репо-споживачі,
+  inflight-міграції, breaking-change політика, зовнішні залежності.
+- **Як перевірити** — конкретні команди й специфічні до завдання сигнали
+  успіху.
 
 ## Виклик
 
@@ -48,102 +96,98 @@ description: >-
    пакета / шлях. Аргумент = намір користувача, передається у промпт
    як розділ "Завдання".
 
-2. **Зібрати read-only контекст з CWD:**
-   - `package.json` — поля `name`, `version`, `engines`, `peerDependencies`,
-     `dependencies`, `devDependencies`, `scripts`, `type`, `exports`.
-   - Структура репо: `tree -L 2 -I 'node_modules|.git|dist|build|.next|.nuxt'`
-     (або `ls -la` коли `tree` недоступний).
-   - `README.md` — перші 40-60 рядків (head).
-   - `CLAUDE.md` / `AGENTS.md` / `.cursor/rules/*.mdc` — якщо є, відмітити їх
-     існування й перелік.
-   - **Релевантні до завдання config-файли** — підбирати за ключовими
-     словами з аргументу (наприклад, "node" → `engines`, `.nvmrc`,
-     `.node-version`; "eslint" → `eslint.config.*`, `.eslintrc*`;
-     "vite" → `vite.config.*`; "ts" → `tsconfig.json`).
-
-3. **Визначити "точку патчу"** — короткий список файлів, які найімовірніше
-   доведеться правити цільовому агенту, з обґрунтуванням.
-
-4. **Сформувати промпт за шаблоном нижче.** Дрібні релевантні файли
-   (≤ ~80 рядків) вбудовуй **повністю**; великі — цитуй фрагмент з
-   посиланням на шлях:рядки.
-
-5. **Вивести один markdown-блок у чат** — без додаткових коментарів
+2. **Зібрати read-only контекст з CWD — мінімум, потрібний для опису
+   інтенту й покажчиків:**
+   - `package.json` — лише поля, релевантні до завдання (напр., для "node"
+     — `engines`, `name`, `version`; для "eslint" — `peerDependencies`,
+     `exports`). Не читай поля, які потім не з'являться у промпті.
+   - Структура репо — швидкий огляд (`ls` верхнього рівня), щоб згадати
+     **тип** ("монорепо bun з 7 workspaces" — рядком, не дампом).
+   - **Релевантні файли** — відкривай саме ті, що потрібні щоб знайти
+     `file:line` покажчики на точки правки. Не читай "про запас".
+   - `CLAUDE.md` / `.cursor/rules/*.mdc` — лише **перевір наявність**
+     і назви файлів-правил, які стосуються завдання (LLM прочитає сама).
+
+3. **Визначити "точку патчу"** — 1-5 `path:line` покажчиків на місця, які
+   найімовірніше треба правити, з одним рядком пояснення на кожен.
+
+4. **Сформувати промпт за шаблоном нижче.** Цитуй код **тільки** коли він
+   зовнішній (stderr, лог CI) або уже видалений. Існуючий код у CWD не
+   цитуй — давай `path:line` ref.
+
+5. **Прорахуй cut list:** перед видачею пройдись по секції "Що **не**
+   включати" вище і видали все, що цільова LLM може отримати з 2-3
+   `Read`/`Grep`-викликів у своєму CWD.
+
+6. **Вивести один markdown-блок у чат** — без додаткових коментарів
    поза блоком, окрім однорядкового підпису "готово до копіювання".
 
 ## Шаблон вихідного промпта
 
+Тільки секції, які несуть навантаження. Порожніх не залишай. Зразок:
+
 ````markdown
 ```markdown
 # Завдання
 
-<нормалізований опис з аргументу — 1-3 речення без води>
-
-# Контекст проєкту
+<1-3 речення: що треба і яка причина (баг / новий стек / requirement).
+Якщо bugfix — вкажи симптом одним рядком.>
 
-- Назва / версія: `<name>@<version>`
-- Тип: <library | app | eslint-config | monorepo | …>
-- Стек: Node `<engines.node>`, <TS/JS>, <ключові залежності>
-- Документи правил: <CLAUDE.md / .cursor/rules — або "немає">
+# Симптом / репро
 
-## Структура (skim)
-```
+<тільки для bugfix: точна команда + ключовий рядок stderr/exit code.
+Пропусти секцію, якщо не bugfix.>
 
-<вивід tree -L 2>
-````
+# Точки правки
 
-# Релевантні файли
-
-## `package.json`
-
-```text
-<повний вміст або ключові поля>
-```
-
-## `<інший релевантний файл>`
-
-```<lang>
-<вміст або фрагмент з посиланням на шлях:рядки>
-```
+- `path/to/file.mjs:120` — <одне речення: що тут не так / що зробити>
+- `path/to/other.mjs:34-50` — <…>
 
 # Що треба зробити
 
-- крок 1 — у файлі `X` (`<коротке пояснення>`)
-- крок 2 — у файлі `Y`
-- крок 3 — оновити `CHANGELOG.md` / bump `version`, якщо це npm-пакет
+<бажана поведінка input → output, edge cases, без псевдо-коду й
+покрокових імплементаційних підказок. 3-8 буллетів.>
 
 # Обмеження
 
-- Не ламати публічний API
-- <constraints, виявлені з package.json / конфігів — наприклад "engines.node вже >=22, треба >=25">
-- Дотриматись правил репо (CLAUDE.md / .cursor/rules — посилання вище)
+<тільки реальні, не виводяться з коду: версії у репо-споживачі, breaking-change політика, inflight-міграції. Пропусти секцію, якщо їх нема.>
 
 # Як перевірити
 
-- `<команда з scripts — npm test / bun test / lint>`
-- <конкретні acceptance-checks: "у `engines.node` має бути `>=25`",
-  "CI зелений" тощо>
-
+- `<команда>` — <специфічний до завдання сигнал успіху>
 ```
+````
 
-```
+### Контр-приклад (так робити не треба)
 
-````
+- Секція `# Контекст проєкту` з name/version/stack/docs — LLM прочитає
+  `package.json` сама за 1 виклик.
+- `## Структура (skim)` з `tree -L 2` дампом — шум.
+- `## package.json` з повним JSON — досить рядка про конкретне поле
+  у `Що треба зробити` або `Обмеження`.
+- `## <функція>` з 30 рядками існуючого коду — давай `path:line` ref
+  у `Точки правки`.
+- Покрокові підказки з кодом ("крок 1: import X, крок 2: split…") —
+  опиши поведінку, код напише LLM.
 
 ## Правила
 
 - **Мова промпту:** українська за замовчуванням; якщо аргумент англійською —
   можна англійською. Технічні терміни — англійською.
-- **Обсяг:** прагни вмістити промпт у ~200-500 рядків. Якщо релевантних
-  файлів багато — обери 3-5 найважливіших, решту згадай посиланнями.
-- **Без галюцинацій:** не вигадуй полів `package.json`, версій, шляхів —
-  лише те, що реально прочитав з CWD. Якщо чогось бракує — явно так і
-  напиши ("`engines.node` відсутнє").
+- **Обсяг:** прагни до **30-100 рядків**. Якщо вийшло більше — пройдись
+  по cut list і викинь усе, до чого LLM додумається з кількох
+  `Read`/`Grep`. Більше 150 рядків — майже завжди ознака, що ти цитуєш
+  код, який LLM прочитає сама.
+- **Без галюцинацій:** не вигадуй полів `package.json`, версій, шляхів,
+  номерів рядків — лише те, що реально прочитав з CWD. Якщо чогось
+  бракує — явно так і напиши ("`engines.node` відсутнє").
 - **Без імперативного тону до користувача:** промпт адресований **іншому
   агенту**, не людині. Використовуй "зроби", "онови", "додай".
-- **Без секцій-пустушок:** якщо немає `Обмежень` — пропусти секцію.
+- **Без секцій-пустушок:** якщо немає `Обмежень` чи `Симптому` — пропусти
+  секцію цілком.
 - **Не вмикай у промпт:** секрети, `.env`, `node_modules`, бінарні файли,
-  довгі логи.
+  довгі логи, дампи `tree`, повні JSON конфігів, цитати існуючих
+  helpers/функцій з CWD.
 - **Усе в одному блоці:** результат — це **один** ` ```markdown ` блок;
   ніяких додаткових міркувань поза ним (крім фінального підпису
   "готово до копіювання").
@@ -163,47 +207,32 @@ description: >-
 /n-llm-patch у @nitra/eslint-config підняти engines.node до >=25
 ```
 
-Очікуваний вивід (схематично):
-
-````
+Очікуваний вивід:
 
 ````markdown
+```markdown
 # Завдання
 
-Підняти `engines.node` у `@nitra/eslint-config` до `>=25` і переглянути
-сумісність peer-залежностей з новою версією.
+Підняти `engines.node` у `@nitra/eslint-config` з `>=22` до `>=25`,
+переконатися що peer `eslint ^9` сумісний з Node 25.
 
-# Контекст проєкту
+# Точки правки
 
-- Назва / версія: `@nitra/eslint-config@2.4.0`
-- Тип: shared eslint preset (library)
-- Стек: Node `>=22` (поточне), ESM, eslint `^9`
-- Документи правил: `.cursor/rules/n-js-lint.mdc`
+- `package.json:18` — `engines.node`
+- `CHANGELOG.md` — додати запис; bump `version` (minor)
 
-## Структура (skim)
-
-…
+# Обмеження
 
-# Релевантні файли
+- Дотриматись `.cursor/rules/n-js-lint.mdc`.
+- Якщо `eslint ^9` офіційно не підтримує Node 25 — підняти peer range.
 
-## `package.json`
+# Як перевірити
 
-```json
-{ "engines": { "node": ">=22" }, "peerDependencies": { "eslint": "^9" } }
+- `bun test` — зелений
+- `node -p "require('./package.json').engines.node"` → `>=25`
 ```
 ````
 
-# Що треба зробити
-
-- `package.json` → `engines.node`: `>=22` → `>=25`
-- Перевірити, чи `peerDependencies.eslint ^9` сумісне з Node 25
-- Bump `version` (minor) + запис у `CHANGELOG.md`
-
-# Як перевірити
-
-- `bun test`
-- `node -v` у CI ≥ 25
-
 ```
 готово до копіювання — встав у чат з агентом у цільовому проєкті
 ```