@7n/rules 1.0.0

package/rules/adr/main.mdc

@@ -0,0 +1,93 @@
+---
+description: Автоматичний збір ADR/Runbook/Knowledge-чернеток і батч-нормалізація у `docs/adr/` через Stop-хуки Claude Code та Cursor Agent
+alwaysApply: true
+version: '2.2'
+---
+
+Правило `adr` автоматично фіксує архітектурні рішення (ADR) після кожної сесії через Stop-хуки і батч-нормалізує чернетки у канонічний формат MADR v4.
+
+## Stop-hook у `.claude/settings.json`
+
+Канонічний запис, який вставляє sync (поряд із PostToolUse fix-хуком — той живе в іншій події, тут не показаний):
+
+```json title=".claude/settings.json"
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/capture-decisions.sh\"",
+            "async": true,
+            "timeout": 180
+          }
+        ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/normalize-decisions.sh\"",
+            "async": true,
+            "timeout": 600
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Обидві ADR-групи ідентифікуються пакетом за маркером у `command` (`.claude/hooks/capture-decisions.sh`, `.claude/hooks/normalize-decisions.sh`) — користувацькі hook-групи поряд не чіпаються. Якщо `adr` прибрати з `rules`, обидві ADR-групи автоматично видаляються на наступному `npx @7n/rules`.
+
+## Stop-hook у `.cursor/hooks.json`
+
+Cursor Agent читає project-level **`.cursor/hooks.json`**. `npx @7n/rules` merge-ить файл: користувацькі hooks лишаються, managed entries для `capture-decisions.sh` і `normalize-decisions.sh` перезаписуються або видаляються разом із правилом `adr`.
+
+```json title=".cursor/hooks.json"
+{
+  "version": 1,
+  "hooks": {
+    "stop": [
+      {
+        "command": "bash -lc 'root=\"$PWD\"; if [ ! -f \"$root/.claude/hooks/capture-decisions.sh\" ] && [ -f \"$root/../.claude/hooks/capture-decisions.sh\" ]; then root=\"$root/..\"; fi; bash \"$root/.claude/hooks/capture-decisions.sh\"'",
+        "timeout": 180
+      },
+      {
+        "command": "bash -lc 'root=\"$PWD\"; if [ ! -f \"$root/.claude/hooks/normalize-decisions.sh\" ] && [ -f \"$root/../.claude/hooks/normalize-decisions.sh\" ]; then root=\"$root/..\"; fi; bash \"$root/.claude/hooks/normalize-decisions.sh\"'",
+        "timeout": 600
+      }
+    ]
+  }
+}
+```
+
+Обидва Stop-hook'и ADR живуть у **project-shared** `.claude/settings.json` (закомічений), щоб механізм працював у всіх членів команди. Якщо хук колись був у `.claude/settings.local.json` — прибери дубль вручну: project-shared і local-копія створили б два запуски на одну подію.
+
+## ADR_HOOKS_SKIP — оркестраторні сесії не потрапляють у ADR hooks
+
+Підкоманди-оркестратори (`npx @7n/rules lint`, `/n-lint`, `/n-doc-files`, `/n-taze`, `/n-release` тощо) можуть спавнити внутрішню agent/LLM-сесію. Такий транскрипт — технічний шум, не людська думка, тому JS-оркестратор (`npm/bin/n-rules.js`) виставляє `ADR_HOOKS_SKIP=1` перед `switch (command)`, до будь-якого дочірнього процесу. `capture-decisions.sh`, `normalize-decisions.sh` і `pi`-extension (`n-rules-adr`) перевіряють прапор одразу після власних recursion guards і мовчки виходять (`exit 0` / `return`) — без запису в лог.
+
+## Capture-бекенд: `CAPTURE_DECISIONS_BACKEND`
+
+`capture-decisions.sh` вибирає LLM-бекенд через env-селектор (дефолт `pi`):
+
+| Значення | Поведінка |
+| --- | --- |
+| `pi` (дефолт) | Тільки локальний `pi` (npm-first lookup: root `.bin`, nested `@7n/rules` `.bin`, `PATH`); без бінарника або без моделі (`CAPTURE_DECISIONS_PI_MODEL`/`N_LOCAL_MIN_MODEL`) — мовчки `exit 0`, без cloud-фолбеку |
+| `claude` | Примусово `claude -p --model "$CAPTURE_DECISIONS_CLAUDE_MODEL"` |
+| `cursor-agent` | Примусово `cursor-agent -p --mode ask --model "$CAPTURE_DECISIONS_CURSOR_MODEL"` |
+| `auto` | Каскад за доступністю: `pi` -> `claude` -> `cursor-agent` -> skip (не за результатом виклику — порожня відповідь обраного бекенду фінальна) |
+
+Дефолт `pi` тримає capture локальним і безкоштовним; cloud вмикається лише свідомим `CAPTURE_DECISIONS_BACKEND=auto` (або `claude`/`cursor-agent`). Виклик `pi` герметичний і офлайн: `--no-session --mode text --no-tools --no-context-files --no-extensions --no-skills --no-prompt-templates --offline`.
+
+## Швидкий gate через conftest
+
+| Namespace | Файл | Що перевіряє |
+| --- | --- | --- |
+| `adr.settings_json` | `.claude/settings.json` | Наявність обох Stop-хуків у `hooks.Stop[]` |
+| `adr.settings_local_json` | `.claude/settings.local.json` | Відсутність дублів Stop-хуків у local-файлі |
+

package/rules/adr/settings_json/concern.json

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

package/rules/adr/settings_json/settings_json.mdc

@@ -0,0 +1,7 @@
+## Наявність ADR Stop-хуків у `.claude/settings.json`
+
+Rego-пакет: `adr.settings_json`
+
+Цільовий файл: `.claude/settings.json`
+
+Перевіряє, що project-shared файл містить **обидва** managed Stop-хуки — `capture-decisions.sh` і `normalize-decisions.sh` — у `hooks.Stop[*].hooks[*].command`. Помилка, якщо маркер будь-якого зі скриптів відсутній.

package/rules/adr/settings_json/settings_json.rego

@@ -0,0 +1,37 @@
+# Перевірка `.claude/settings.json` для правила adr.mdc:
+# `hooks.Stop[*]` має містити дві managed-групи — capture і normalize — у
+# кожній хоча б один елемент `hooks[]` з відповідним маркером у `command`.
+#
+# Запуск (локально):
+#   conftest test .claude/settings.json -p npm/rules/adr/policy \
+#     --namespace adr.settings_json
+#
+# Hash-порівняння bash-скриптів з канонічними bundled-варіантами і `.gitignore`-перевірки
+# — у JS (`js/check.mjs`).
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
+# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
+package adr.settings_json
+
+import rego.v1
+
+capture_marker := ".claude/hooks/capture-decisions.sh"
+normalize_marker := ".claude/hooks/normalize-decisions.sh"
+
+deny contains msg if {
+	not has_stop_hook_with_marker(capture_marker)
+	msg := ".claude/settings.json: відсутній Stop-hook для `capture-decisions.sh` у hooks.Stop (adr.mdc)"
+}
+
+deny contains msg if {
+	not has_stop_hook_with_marker(normalize_marker)
+	msg := ".claude/settings.json: відсутній Stop-hook для `normalize-decisions.sh` у hooks.Stop (adr.mdc)"
+}
+
+# Чи є в `hooks.Stop[*].hooks[*].command` рядок з заданим маркером.
+has_stop_hook_with_marker(marker) if {
+	some group in object.get(object.get(input, "hooks", {}), "Stop", [])
+	some hook in object.get(group, "hooks", [])
+	contains(object.get(hook, "command", ""), marker)
+}

package/rules/adr/settings_local_json/concern.json

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

package/rules/adr/settings_local_json/settings_local_json.mdc

@@ -0,0 +1,7 @@
+## Відсутність дублів ADR Stop-хуків у `.claude/settings.local.json`
+
+Rego-пакет: `adr.settings_local_json`
+
+Цільовий файл: `.claude/settings.local.json`
+
+Перевіряє **зворотне** до `adr.settings_json`: local-файл **не повинен** містити маркерів `capture-decisions.sh` або `normalize-decisions.sh` у `hooks.Stop[*].hooks[*].command` — інакше кожен скрипт виконається двічі на одну Stop-подію.

package/rules/adr/settings_local_json/settings_local_json.rego

@@ -0,0 +1,40 @@
+# Перевірка `.claude/settings.local.json` для правила adr.mdc: після переходу на
+# project-shared `settings.json` цей файл (якщо є) НЕ повинен мати дубля жодного
+# з керованих Stop-хуків (`capture-decisions.sh` або `normalize-decisions.sh`),
+# інакше відповідний скрипт виконається двічі на одну подію.
+#
+# Запуск (локально):
+#   conftest test .claude/settings.local.json -p npm/rules/adr/policy \
+#     --namespace adr.settings_local_json
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
+# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
+package adr.settings_local_json
+
+import rego.v1
+
+capture_marker := ".claude/hooks/capture-decisions.sh"
+normalize_marker := ".claude/hooks/normalize-decisions.sh"
+
+deny contains msg if {
+	has_stop_hook_with_marker(capture_marker)
+	msg := concat(" ", [
+		".claude/settings.local.json: видали дубль Stop-хука для",
+		"`capture-decisions.sh` — він уже у project-shared settings.json (adr.mdc)",
+	])
+}
+
+deny contains msg if {
+	has_stop_hook_with_marker(normalize_marker)
+	msg := concat(" ", [
+		".claude/settings.local.json: видали дубль Stop-хука для",
+		"`normalize-decisions.sh` — він уже у project-shared settings.json (adr.mdc)",
+	])
+}
+
+has_stop_hook_with_marker(marker) if {
+	some group in object.get(object.get(input, "hooks", {}), "Stop", [])
+	some hook in object.get(group, "hooks", [])
+	contains(object.get(hook, "command", ""), marker)
+}

package/rules/bun/bunfig/bunfig.mdc

@@ -0,0 +1,12 @@
+## Rego-gate: відповідність bunfig.toml канонічному шаблону
+
+Rego-пакет: `bun.bunfig`
+
+Цільовий файл: `bunfig.toml` (корінь репо).
+
+Шаблон (leaf-значення, які gate порівнює): [bunfig.toml.snippet.toml](./template/bunfig.toml.snippet.toml)
+
+Gate порівнює кожен leaf-ключ у кожній секції шаблону з фактичним значенням у `bunfig.toml`. Зайві ключі та секції — ігноруються. Deny-повідомлення виникає, якщо:
+
+- секція відсутня або не є обʼєктом (`bunfig.toml: відсутня секція [install]`)
+- leaf-ключ має інше значення (`bunfig.toml: у секції [install] має бути linker = "hoisted"`)

package/rules/bun/bunfig/bunfig.rego

@@ -0,0 +1,29 @@
+# Перевірка `bunfig.toml` для bun (bun.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/bunfig.toml.snippet.toml.
+# Snippet — 2-рівнева мапа (section → key → expected). Walker такий самий,
+# як для ga.vscode_settings: leaf-by-leaf коли section-обʼєкт існує + окремий
+# deny коли section відсутній / не обʼєкт.
+package bun.bunfig
+
+import rego.v1
+
+# Leaf-by-leaf: section присутня й обʼєкт.
+deny contains msg if {
+	some section, expected_inner in data.template.snippet
+	inner := object.get(input, section, {})
+	is_object(inner)
+	some leaf_key, expected_value in expected_inner
+	actual := object.get(inner, leaf_key, null)
+	actual != expected_value
+	msg := sprintf("bunfig.toml: у секції [%s] має бути %s = %q (bun.mdc)", [section, leaf_key, expected_value])
+}
+
+# Section відсутня (null) або не обʼєкт.
+deny contains msg if {
+	some section in object.keys(data.template.snippet)
+	raw := object.get(input, section, null)
+	not is_object(raw)
+	msg := sprintf("bunfig.toml: відсутня секція [%s] (bun.mdc)", [section])
+}

package/rules/bun/bunfig/concern.json

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

package/rules/bun/bunfig/template/bunfig.toml.snippet.toml

@@ -0,0 +1,2 @@
+[install]
+linker = "hoisted"

package/rules/bun/docs/index.md

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

package/rules/bun/layout/concern.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "full",
+    "glob": [
+      "package-lock.json",
+      "yarn.lock",
+      "pnpm-lock.yaml",
+      ".yarnrc.yml",
+      ".yarn/**",
+      "bun.lock",
+      "bunfig.toml",
+      "package.json"
+    ]
+  }
+}

package/rules/bun/layout/docs/fix-layout.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: fix-layout.mjs
+resource: npm/rules/bun/layout/fix-layout.mjs
+docgen:
+  crc: 14f58bce
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Т0-autofix паттерни для `bun/js/layout.mjs` забезпечують детерміноване виправлення структури проєкту. Він виконує такі дії, керуючись конфігом `package-lock.json`: видаляє заборонені файли (наприклад, `package-lock.json`, `yarn.lock`), створює відсутні конфігураційні файли (`bunfig.toml`) та каталоги (`.yarn`). Ці механізми реалізуються через публічну змінну `patterns` без звернення до LLM.
+
+## Поведінка
+
+Поведінка:
+
+1. Виконується детерміноване автоматичне виправлення структури проєкту на основі попереднього логу.
+2. Перевіряється наявність заборонених файлів, таких як `package-lock.json`. У разі виявлення, ці файли фізично видаляються з робочої директорії.
+3. Перевіряється наявність файлу `bunfig.toml`. Якщо він відсутній, його створюється з базовим налаштуванням для встановлення залежностей.
+4. Перевіряється наявність каталогу `.yarn`. У разі його виявлення, цей каталог повністю видаляється.
+5. Усі ці дії інкапсульовані у публічній змінній `patterns`, що містить набір визначених механізмів виправлення.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/bun/layout/docs/main.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/bun/layout/main.mjs
+docgen:
+  crc: 457e5fcd
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 95
+  issues: anchor-miss:(bun.mdc),judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Цей модуль забезпечує автоматизовану перевірку конфігурації проекту, аналізуючи файли package.json та package-lock.json. Він діагностує відсутність ключових файлів або невідповідність усталеним стандартам управління залежностями. Успішна робота підтверджує відповідність проекту визначеним вимогам.
+
+## Поведінка
+
+Поведінка:
+
+1. При запуску `main` перевіряється наявність файлів блокування залежностей (`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `.yarnrc.yml`). Якщо будь-який з них присутній, це розцінюється як порушення.
+2. Перевіряється наявність директорії `.yarn`. Її наявність сприймається як порушення.
+3. Перевіряється наявність файлу `bun.lock`. Якщо його немає, це вказує на необхідність виконання `bun i`.
+4. Перевіряється наявність конфігураційного файлу `bunfig.toml`. Якщо його немає, це вимагає створення файлу з налаштуванням `[install] linker = "hoisted"` відповідно до вимог `bun.mdc`.
+5. Визначається шлях до `package.json` у корені репозиторію. Якщо цей файл відсутній, процес перевірки зупиняється.
+6. У разі успішної перевірки всіх умов, повертається код, що вказує на відсутність проблем.
+
+## Публічний API
+
+main — перевіряє, чи відповідає проєкт встановленим у bun.mdc правилам.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/bun/layout/fix-layout.mjs

@@ -0,0 +1,63 @@
+/**
+ * T0-autofix паттерни для `bun/layout` — детерміновані FS-виправлення
+ * заборонених файлів (package-lock.json, yarn.lock тощо), відсутнього bunfig.toml
+ * та каталогу .yarn без звернення до LLM.
+ *
+ * Unified lint surface: structured violations (test(violations)/apply(violations,ctx)).
+ * Імена заборонених файлів читаються з `v.message`, не з агрегованого output-рядка.
+ */
+import { existsSync, rmSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const FORBIDDEN_FILE_RE = /Знайдено заборонений файл: \S+/u
+const FORBIDDEN_FILE_NAME_RE = /Знайдено заборонений файл: (\S+)/u
+const BUNFIG_MISSING_RE = /Відсутній bunfig\.toml/u
+const YARN_DIR_RE = /Знайдено директорію \.yarn/u
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'rm-forbidden-file',
+    test: violations => violations.some(v => FORBIDDEN_FILE_RE.test(v.message)),
+    apply: (violations, ctx) => {
+      const cwd = ctx.cwd
+      const touchedFiles = []
+      for (const v of violations) {
+        const m = FORBIDDEN_FILE_NAME_RE.exec(v.message)
+        if (!m) continue
+        const filePath = join(cwd, m[1])
+        if (existsSync(filePath)) {
+          ctx.recordWrite?.(filePath)
+          rmSync(filePath, { force: true })
+          touchedFiles.push(filePath)
+        }
+      }
+      if (touchedFiles.length === 0) return { touchedFiles: [] }
+      return { touchedFiles, message: `видалено: ${touchedFiles.join(', ')}` }
+    }
+  },
+
+  {
+    id: 'bun-bunfig-create',
+    test: violations => violations.some(v => BUNFIG_MISSING_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const target = join(ctx.cwd, 'bunfig.toml')
+      if (existsSync(target)) return { touchedFiles: [] }
+      ctx.recordWrite?.(target)
+      writeFileSync(target, '[install]\nlinker = "hoisted"\n', 'utf8')
+      return { touchedFiles: [target], message: 'створено bunfig.toml' }
+    }
+  },
+
+  {
+    id: 'bun-yarn-dir-remove',
+    test: violations => violations.some(v => YARN_DIR_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const target = join(ctx.cwd, '.yarn')
+      if (!existsSync(target)) return { touchedFiles: [] }
+      ctx.recordWrite?.(target)
+      rmSync(target, { recursive: true, force: true })
+      return { touchedFiles: [target], message: 'видалено .yarn/' }
+    }
+  }
+]

package/rules/bun/layout/layout.mdc

@@ -0,0 +1,60 @@
+## Структура lockfile та менеджер пакетів
+
+Проект використовує **тільки Bun** для керування залежностями та запуску скриптів.
+
+**Заборонені lockfile / директорії** (мають бути відсутні у репозиторії):
+
+- `package-lock.json`
+- `yarn.lock`
+- `pnpm-lock.yaml`
+- `.yarnrc.yml`
+- `.yarn/`
+
+Якщо якийсь із цих файлів чи директорій існує — **видали** його.
+
+**Обовʼязковий lockfile:** `bun.lock` (має бути присутній у корені).
+
+**Заборонені команди менеджерів пакетів:**
+
+- `npm install`, `yarn`, `pnpm` і їх відповідники lockfile (крім `bun.lock`)
+
+**Дозволені команди:**
+
+- `bun i`
+- `bun run <script>`
+- `bun add <pkg>`
+- `bun add -d <pkg>`
+- `bun remove <pkg>`
+- `bunx <tool>`
+- `npx <tool>` — якщо у проєкті вже використовується `npx` (не замінюй на `bunx`)
+
+**Одноразові CLI (`bunx` / `npx`):**
+
+- Якщо в проєкті вже використовується **`npx`** (скрипти, CI, Dockerfile) — **залишай `npx`**, не замінюй на `bunx`.
+- Якщо новий виклик CLI додається з нуля і в репозиторії прийнято лише Bun — можна `bunx <tool>`.
+
+**Не додавай** у `dependencies` / `devDependencies` пакети, які **використовуються лише як CLI** і їх достатньо викликати через **`bunx <pkg>`** (або **`npx`**, якщо в проєкті так прийнято): наприклад **oxlint**, **jscpd**, **eslint** у корені тощо. Виняток — пакет потрібен як **бібліотека** (імпорт у коді), peer для іншого пакета, або інструмент **не** покривається `bunx` у вашому CI.
+
+**Monorepo:**
+
+- Встановлювати залежності у відповідному пакеті, а не в корені без потреби.
+- Якщо залежність потрібна лише одному пакету, додавати її в директорії цього пакета.
+- У CI та локально запускати скрипти через `bun run`.
+
+**Dockerfile:**
+
+```dockerfile
+FROM oven/bun:alpine AS build-env
+```
+
+замість образу node.
+
+**GitHub Actions:** не вставляй у workflow окремі кроки **`actions/setup-node`**, **`oven-sh/setup-bun`**, **`actions/cache`** та **`bun install`** — їх **заборонено** дублювати в кожному job; завжди використовуй **локальний composite** (деталі й заборона дублювання — **ga.mdc**). Під капотом composite уже містить Node **24**, Bun, кеш і **`bun install --frozen-lockfile`**.
+
+Після **`actions/checkout@v6`** (`persist-credentials: false`):
+
+```yaml
+- uses: ./.github/actions/setup-bun-deps
+```
+
+Якщо в репозиторії action збережено під **`./npm/github-actions/setup-bun-deps`**, у `uses:` вкажи цей шлях замість `.github/actions/…` (**ga.mdc**).

package/rules/bun/layout/main.mjs

@@ -0,0 +1,53 @@
+/** @see ./docs/layout.md */
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+
+// Перевірка `devDependencies` кореневого `package.json` (дозволено лише `@nitra/*`)
+// — у rego (`npm/policy/bun/package_json/`). JS-копії `isAllowedRootDevDependency`
+// видалено, щоб не було двох джерел істини.
+
+/**
+ * Перевіряє відповідність проєкту правилам bun.mdc
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
+ * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат перевірки
+ */
+export function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  for (const f of ['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', '.yarnrc.yml']) {
+    if (existsSync(join(cwd, f))) {
+      fail(`Знайдено заборонений файл: ${f} — видали його`)
+    } else {
+      pass(`Немає ${f}`)
+    }
+  }
+
+  if (existsSync(join(cwd, '.yarn'))) {
+    fail('Знайдено директорію .yarn — видали її')
+  } else {
+    pass('Немає .yarn/')
+  }
+  if (existsSync(join(cwd, 'bun.lock'))) {
+    pass('bun.lock є')
+  } else {
+    fail('Відсутній bun.lock — запусти bun i')
+  }
+
+  if (existsSync(join(cwd, 'bunfig.toml'))) {
+    pass('bunfig.toml є (структуру перевіряє npx @7n/rules fix → bun.bunfig)')
+  } else {
+    fail('Відсутній bunfig.toml — створи з [install] linker = "hoisted" (bun.mdc)')
+  }
+
+  const pkgPath = join(cwd, 'package.json')
+  if (!existsSync(pkgPath)) {
+    fail('Відсутній package.json у корені')
+    return reporter.result()
+  }
+
+  return reporter.result()
+}

package/rules/bun/licensee/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": {
+    "scope": "full"
+  }
+}

package/rules/bun/licensee/docs/fix-licensee.md

@@ -0,0 +1,28 @@
+---
+type: JS Module
+title: fix-licensee.mjs
+resource: npm/rules/bun/licensee/fix-licensee.mjs
+docgen:
+  crc: 23a211fd
+  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
+---
+
+## Огляд
+
+Цей модуль виконує детерміновану генерацію конфігураційного файлу `.licensee.json` у корені проекту. Генерація відбувається через виконання канонічної команди `licensee --init`, що ініціалізує файл `.licensee.json` для забезпечення метаданих ліцензування проекту. Це механізм для встановлення початкової конфігурації.
+
+## Поведінка
+
+Поведінка:
+1. Перевіряється, чи існують порушення, пов'язані з відсутністю конфігурації `licensee` у контексті.
+2. Якщо порушення виявлено, викликається команда `bun x licensee --init --production --quiet` у поточному робочому каталозі для створення або ініціалізації файлу `.licensee.json`.
+3. Результат виконання команди фіксується, а файл `.licensee.json` позначається як змінений.
+4. Якщо порушень немає, жодних дій не виконується.
+
+## Гарантії поведінки
+
+- Пише лише `.licensee.json`; за відсутності `bun` у PATH — no-op.

package/rules/bun/licensee/docs/index.md

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

package/rules/bun/licensee/docs/main.md

@@ -0,0 +1,37 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/bun/licensee/main.mjs
+docgen:
+  crc: bbaca446
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+  issues: surzhik,judge:inaccurate:0.96
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Встановлює конфігурацію ліцензій, спираючись на файл .licensee.json, якщо він відсутній. Виконує перевірку відповідності ліцензій усіх npm-залежностей проєкту встановленим вимогам, що визначаються в конфігурації. У випадку виявлення порушень, система повідомляє про них, підтверджуючи чисту відповідність або фіксуючи розбіжності. Маркери повідомлень згадуються у Поведінці: (bun.mdc).
+
+## Поведінка
+
+Поведінка:
+
+1. Викликається `lint` для запуску перевірки ліцензій npm-залежностей.
+2. Якщо файл конфігурації `.licensee.json` відсутній:
+   a. Якщо режим читання лише (`readOnly`) увімкнено, повідомляється, що необхідно запустити `npx @7n/rules fix bun` локально для генерації (bun.mdc).
+   b. Якщо режим читання лише вимкнено, створюється `.licensee.json` з дефолтним allowlist (`blueOak: bronze`) та повідомляється про створення конфігурації.
+3. Визначається команда `bun`. Якщо `bun` не знайдена у системному шляху, повідомляється про це (bun.mdc).
+4. Виконується команда `bun x licensee --production --quiet` у корені проєкту.
+5. Якщо команда `licensee` завершується успішно (статус 0), повідомляється, що ліцензії відповідають вимогам.
+6. Якщо команда `licensee` завершується з помилкою (не 0), повідомляється про порушення ліцензій (код) (bun.mdc).
+
+## Публічний API
+
+lint — аналізує код на відповідність заданим стилістичним нормам у контексті `bun`.
+licensee — перевіряє відповідність ліцензій усіх використаних npm-залежностей файлу `.licensee.json`.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)