@7n/rules 1.29.3 → 1.31.0

package/rules/style/tooling/tooling.mdc

@@ -1,85 +0,0 @@
-## Генерація та редагування стилів (Cursor і інші агенти)
-
-- **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам'яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
-- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
-- **Запуск stylelint:** лише через **`n-rules lint style`** (локально — з auto-fix; у CI — `--no-fix`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-rules lint style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-rules lint --full`.
-- **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
-
-## Канон налаштувань
-
-### `package.json`
-
-- `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
-
-Окремого `lint-style` скрипта немає — запуск через **`n-rules lint style`** (CI — `--no-fix`).
-
-```json title="package.json"
-  "devDependencies": {
-    "@nitra/stylelint-config": "^1.4.0"
-  },
-  "stylelint": {
-    "extends": "@nitra/stylelint-config"
-  },
-```
-
-У корені проєкту має бути **`.stylelintignore`**:
-
-```text title=".stylelintignore"
-dist/
-```
-
-### `.vscode/extensions.json`
-
-- Канон `recommendations`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
-
-### `.vscode/settings.json`
-
-- Вимкнення вбудованої CSS-валідації VS Code: [settings.json.snippet.json](./policy/vscode_settings/template/settings.json.snippet.json)
-
-### CI: `.github/workflows/lint-style.yml`
-
-- Канон: [lint-style.yml.snippet.yml](./policy/lint_style_yml/template/lint-style.yml.snippet.yml)
-
-Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-rules lint style --no-fix` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
-
-```yaml title=".github/workflows/lint-style.yml"
-name: StyleLint
-
-on:
-  push:
-    branches:
-      - dev
-      - main
-    paths:
-      - '**/*.css'
-      - '**/*.scss'
-      - '**/*.vue'
-
-  pull_request:
-    branches:
-      - dev
-      - main
-    paths:
-      - '**/*.css'
-      - '**/*.scss'
-      - '**/*.vue'
-
-concurrency:
-  group: ${{ github.ref }}-${{ github.workflow }}
-  cancel-in-progress: true
-
-jobs:
-  stylelint:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          persist-credentials: false
-
-      - uses: ./.github/actions/setup-bun-deps
-
-      - name: StyleLint
-        run: npx stylelint '**/*.{css,scss,vue}'
-```

package/rules/style/vscode_extensions/concern.json

@@ -1,9 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "config",
-  "policy": {
-    "files": {
-      "single": ".vscode/extensions.json"
-    }
-  }
-}

package/rules/style/vscode_extensions/docs/fix-vscode_extensions.md

@@ -1,25 +0,0 @@
----
-type: JS Module
-title: fix-vscode_extensions.mjs
-resource: npm/rules/style/vscode_extensions/fix-vscode_extensions.mjs
-docgen:
-  crc: 3353fe17
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Файл ініціює процес інтеграції визначених шаблонів у розширення VS Code шляхом запуску зовнішнього скрипта. Цей скрипт забезпечує впровадження архітектурних патернів у ці розширення.
-
-## Поведінка
-
-1. Ініціює процес застосування визначених шаблонів до розширень VS Code.
-2. Використовує зовнішній скрипт для додавання необхідних патернів до розширень.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/vscode_extensions/docs/index.md

@@ -1,11 +0,0 @@
----
-type: Directory Index
-title: npm/rules/style/vscode_extensions
-resource: npm/rules/style/vscode_extensions/
----
-
-# npm/rules/style/vscode_extensions
-
-| Файл                                                  | Тип       |
-| ----------------------------------------------------- | --------- |
-| [fix-vscode_extensions.mjs](fix-vscode_extensions.md) | JS Module |

package/rules/style/vscode_extensions/fix-vscode_extensions.mjs

@@ -1 +0,0 @@
-export { patterns } from '../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/style/vscode_extensions/template/extensions.json.snippet.json

@@ -1 +0,0 @@
-{ "recommendations": ["stylelint.vscode-stylelint"] }

package/rules/style/vscode_extensions/vscode_extensions.mdc

@@ -1,13 +0,0 @@
-## .vscode/extensions.json: розширення для stylelint
-
-Rego-пакет: `style_lint.vscode_extensions`
-
-Цільовий файл: `.vscode/extensions.json`
-
-Перевіряє, що масив `recommendations` містить усі записи з канонічного template (subset-check). Додаткові розширення поза списком — дозволені.
-
-Канонічний template: [extensions.json.snippet.json](./template/extensions.json.snippet.json)
-
-**✓ Правильно** — `recommendations` містить `"stylelint.vscode-stylelint"` (може бути і більше елементів).
-
-**✗ Неправильно** — `recommendations` відсутній або не містить `"stylelint.vscode-stylelint"`.

package/rules/style/vscode_extensions/vscode_extensions.rego

@@ -1,13 +0,0 @@
-# Перевірка `.vscode/extensions.json` для style (style.mdc).
-#
-# Канон надходить через --data: { "template": { "snippet": ... } }
-# Структура --data сформована з template/extensions.json.snippet.json.
-package style.vscode_extensions
-
-import rego.v1
-
-deny contains msg if {
-	some rec in data.template.snippet.recommendations
-	not rec in {r | some r in object.get(input, "recommendations", [])}
-	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (style.mdc)", [rec])
-}

package/rules/style/vscode_settings/concern.json

@@ -1,9 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "config",
-  "policy": {
-    "files": {
-      "single": ".vscode/settings.json"
-    }
-  }
-}

package/rules/style/vscode_settings/docs/fix-vscode_settings.md

@@ -1,27 +0,0 @@
----
-type: JS Module
-title: fix-vscode_settings.mjs
-resource: npm/rules/style/vscode_settings/fix-vscode_settings.mjs
-docgen:
-  crc: eee71672
-  model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-`patterns` описує узгоджені шаблони для `settings.json` і визначає, які значення в ньому мають відповідати очікуваному формату. Це потрібно, щоб конфіг лишався передбачуваним і однаково трактувався в різних місцях, де його використовують.
-
-## Поведінка
-
-1. `patterns` описує набір правил для приведення `.vscode/settings.json` до узгодженого стану з шаблонним стилем проєкту.
-2. На основі цього набору система знаходить конфігурацію `settings.json` і підтягує її в механізм виправлення, щоб зберігати єдиний формат налаштувань у робочому середовищі.
-3. Результат роботи `patterns` використовується як джерело стандарту для перевірки та вирівнювання вмісту `settings.json` без ручного втручання.
-4. Модуль не змінює файлову систему чи бази даних; він лише надає опис поведінки для подальшого застосування.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/vscode_settings/docs/index.md

@@ -1,9 +0,0 @@
----
-type: Directory Index
-title: npm/rules/style/vscode_settings
-resource: npm/rules/style/vscode_settings/
----
-
-| Файл                                              | Тип       |
-| ------------------------------------------------- | --------- |
-| [fix-vscode_settings.mjs](fix-vscode_settings.md) | JS Module |

package/rules/style/vscode_settings/fix-vscode_settings.mjs

@@ -1,5 +0,0 @@
-import { createTemplateFixPattern } from '../../../scripts/lib/fix/template-deep-merge.mjs'
-
-export const patterns = [
-  createTemplateFixPattern({ id: 'style-vscode_settings-template', targetPath: '.vscode/settings.json' })
-]

package/rules/style/vscode_settings/template/settings.json.snippet.json

@@ -1,5 +0,0 @@
-{
-  "css.validate": false,
-  "less.validate": false,
-  "scss.validate": false
-}

package/rules/style/vscode_settings/vscode_settings.mdc

@@ -1,19 +0,0 @@
-## .vscode/settings.json: вимкнення вбудованих CSS/SCSS/Less валідаторів
-
-Rego-пакет: `style_lint.vscode_settings`
-
-Цільовий файл: `.vscode/settings.json`
-
-Leaf-by-leaf walker: перевіряє кожен ключ з template — його значення у `settings.json` має точно збігатися. Додаткові ключі у файлі — дозволені.
-
-Канонічний template: [settings.json.snippet.json](./template/settings.json.snippet.json)
-
-Обов'язкові значення:
-
-- `"css.validate": false`
-- `"less.validate": false`
-- `"scss.validate": false`
-
-**✓ Правильно** — усі три ключі присутні зі значенням `false`; можуть бути й інші ключі.
-
-**✗ Неправильно** — будь-який з ключів відсутній, має значення `true` або рядок (`"off"`).

package/rules/style/vscode_settings/vscode_settings.rego

@@ -1,15 +0,0 @@
-# Перевірка `.vscode/settings.json` для style (style.mdc).
-#
-# Канон надходить через --data: { "template": { "snippet": ... } }
-# Структура --data сформована з template/settings.json.snippet.json.
-# Top-level літеральні keys — leaf-by-leaf walker.
-package style.vscode_settings
-
-import rego.v1
-
-deny contains msg if {
-	some key, expected_value in data.template.snippet
-	actual := object.get(input, key, null)
-	actual != expected_value
-	msg := sprintf(".vscode/settings.json: \"%s\" має бути %v (style.mdc)", [key, expected_value])
-}