@7n/rules 1.0.0

package/rules/changelog/docs/index.md

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

package/rules/changelog/lib/docs/index.md

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

package/rules/changelog/lib/docs/package-manifest.md

@@ -0,0 +1,214 @@
+---
+type: JS Module
+title: package-manifest.mjs
+resource: npm/rules/changelog/lib/package-manifest.mjs
+docgen:
+  crc: ced8ad49
+---
+
+Модуль `package-manifest.mjs` реалізує **уніфіковану абстракцію маніфесту пакета** для перевірок changelog у багатомовному монорепо. Він приховує відмінності між двома типами маніфестів:
+
+- **npm / JS** — файл `package.json` (з полями `name`, `version`, `private`, `files`).
+- **Python** — файл `pyproject.toml` (PEP 621 → таблиця `[project]`, або застаріший формат Poetry → таблиця `[tool.poetry]`).
+
+Модуль надає три високорівневі операції:
+
+1. **Розбір** `pyproject.toml` для витягання `name` та `version` (через `smol-toml`).
+2. **Читання маніфесту воркспейсу** в єдиній структурі `PackageManifest` (з пріоритетом `package.json` над `pyproject.toml`).
+3. **Виявлення коренів усіх пакетів монорепо**: npm-воркспейси через скрипт `workspaces.mjs` + автоматичний пошук Python-проєктів за `pyproject.toml`.
+
+Базова мета — дати правилам категорії `changelog` єдину модель «пакет = (kind, ws, name, version, registryPublishable)», незалежно від мови.
+
+## Експорти / API
+
+Усі експорти — **іменовані** (`export function …`). Експорту за замовчуванням немає.
+
+| Експорт                                 | Тип                                                             | Призначення                                                                      |
+| --------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `parsePyprojectFields(text)`            | `(string) => { name: string \| null, version: string \| null }` | Розпарсити сирий TOML-текст `pyproject.toml` і витягти `name` / `version`.       |
+| `readPackageManifest(ws, cwd?)`         | `(string, string?) => Promise<PackageManifest \| null>`         | Прочитати маніфест конкретного воркспейсу (`package.json` або `pyproject.toml`). |
+| `getMonorepoProjectRootDirs(repoRoot?)` | `(string?) => Promise<string[]>`                                | Перелічити всі каталоги-корені пакетів монорепо (npm + Python).                  |
+| `manifestFilePath(ws, manifest)`        | `(string, PackageManifest) => string`                           | Зібрати відносний шлях до файлу маніфесту воркспейсу.                            |
+
+### Типи (JSDoc)
+
+```js
+/** @typedef {'npm' | 'python'} PackageKind */
+
+/**
+ * @typedef {object} PackageManifest
+ * @property {PackageKind} kind           тип маніфесту
+ * @property {string} ws                  відносний шлях воркспейсу ('.' для кореня)
+ * @property {string} manifestRel         'package.json' | 'pyproject.toml'
+ * @property {string | null} name         ім'я пакета (npm / PyPI)
+ * @property {string | null} version      semver-рядок
+ * @property {boolean} registryPublishable чи застосовується режим порівняння з реєстром
+ * @property {string[] | null} [npmFiles] лише npm: 'files' з package.json
+ */
+```
+
+### Константи модуля
+
+- `PYPROJECT_GLOB_IGNORE = ['**/node_modules/**', '**/.git/**', '**/.venv/**', '**/venv/**']` — патерни, що **виключаються** під час сканування `pyproject.toml` глобом, щоб не зачіпати чужі залежності та віртуальні середовища.
+
+## Функції
+
+### `projectFieldsFromPyprojectDoc(doc)` (внутрішня)
+
+- **Сигнатура:** `(doc: unknown) => { name: string | null, version: string | null }`
+- **Параметри:**
+  - `doc` — результат `parse` зі `smol-toml` (очікується об'єкт верхнього рівня TOML).
+- **Повертає:** об'єкт `{ name, version }`, де обидва поля — `string` або `null`.
+- **Логіка:**
+  1. Якщо `doc` не є чистим об'єктом (`null`, примітив, масив) — повертає `{ null, null }`.
+  2. Якщо є таблиця `[project]` (PEP 621): бере `project.name` і `project.version`, але лише якщо вони — `string`; інакше — `null`.
+  3. Якщо `[project]` відсутня — пробує застарілу таблицю `[tool.poetry]`: бере `tool.poetry.name` і `tool.poetry.version` за тим самим правилом.
+  4. Якщо обидві таблиці відсутні — повертає `{ null, null }`.
+- **Side effects:** немає (чиста функція).
+- **Примітка:** функція не експортується; зовнішній API — це `parsePyprojectFields`, який додає захист від помилок парсингу TOML.
+
+### `parsePyprojectFields(text)`
+
+- **Сигнатура:** `(text: string) => { name: string | null, version: string | null }`
+- **Параметри:**
+  - `text` — повний текст файлу `pyproject.toml`.
+- **Повертає:** ті самі поля, що й `projectFieldsFromPyprojectDoc`.
+- **Логіка:**
+  1. Викликає `parseToml(text)` (зі `smol-toml`).
+  2. Передає результат у `projectFieldsFromPyprojectDoc`.
+  3. На будь-якій помилці парсингу (синтаксис, тощо) — повертає `{ null, null }`. Помилка **проковтується** (catch без логування), щоб некоректний TOML не зривав весь процес перевірки changelog.
+- **Side effects:** немає (CPU-only; жодного IO).
+
+### `readPackageManifest(ws, cwd = process.cwd())`
+
+- **Сигнатура:** `(ws: string, cwd?: string) => Promise<PackageManifest | null>`
+- **Параметри:**
+  - `ws` — відносний шлях воркспейсу від `cwd` (наприклад, `npm/rules/changelog` або `.` для кореня).
+  - `cwd` — корінь репозиторію; за замовчуванням `process.cwd()`.
+- **Повертає:** `PackageManifest` або `null`, якщо ні `package.json`, ні `pyproject.toml` у воркспейсі не існують або не парсяться.
+- **Логіка (з пріоритетом npm > python):**
+  1. **Гілка npm:**
+     - Складає шлях `cwd/ws/package.json` (через `node:path.join`).
+     - `existsSync` → якщо файлу немає, переходить до гілки Python.
+     - Читає текст через `readFile(pkgPath, 'utf8')` і парсить як JSON.
+     - Якщо JSON — не об'єкт (null, масив, примітив), повертає `null`.
+     - Обчислює `registryPublishable = name є непорожнім рядком && private !== true && files є масивом`. Тобто пакет вважається «публікованим у реєстр», тільки якщо в `package.json` явно вказано непорожній `name`, не зведено `private: true`, і визначено поле `files` (whitelist того, що публікується).
+     - Повертає об'єкт із `kind: 'npm'`, `manifestRel: 'package.json'`, з `name`/`version` (тільки якщо вони — рядки, інакше `null`), `registryPublishable`, `npmFiles = pkg.files` або `null`.
+     - Будь-яка помилка читання/парсингу JSON у блоці `try` → повертає `null` (catch без логування).
+  2. **Гілка Python:**
+     - Складає шлях `cwd/ws/pyproject.toml`.
+     - `existsSync` → якщо файлу немає, повертає `null`.
+     - Читає файл і викликає `parsePyprojectFields`.
+     - `registryPublishable = Boolean(name && version)` — для Python публікація в PyPI потребує лише валідних `name` і `version` (PyPI не має аналога `files` whitelist).
+     - Повертає об'єкт із `kind: 'python'`, `manifestRel: 'pyproject.toml'`, `npmFiles: null`.
+- **Side effects:**
+  - Синхронний `existsSync` (двічі: на `package.json` і `pyproject.toml`).
+  - Асинхронне читання файлу через `fs/promises.readFile`.
+- **Гарантія:** функція **ніколи не кидає** — усі помилки IO/парсингу повертаються як `null`.
+
+### `getMonorepoProjectRootDirs(repoRoot = '.')`
+
+- **Сигнатура:** `(repoRoot?: string) => Promise<string[]>`
+- **Параметри:**
+  - `repoRoot` — корінь репозиторію (за замовчуванням `'.'`).
+- **Повертає:** відсортований масив **унікальних** відносних шляхів воркспейсів — кандидатів на пакет.
+- **Логіка:**
+  1. Створює `Set<string>` з результату `getMonorepoPackageRootDirs(repoRoot)` — це npm-воркспейси, оголошені в `package.json` (`workspaces`) кореня.
+  2. **Кореневий Python-проєкт:** якщо в корені існує `pyproject.toml`, але **немає** `package.json`, додає `'.'` у множину. Це покриває випадок «репо — чистий Python-проєкт без npm».
+  3. **Сканування підкаталогів:** через `fs/promises.glob('**/pyproject.toml', { cwd: repoRoot, ignore: PYPROJECT_GLOB_IGNORE })` ітерує по знайдених файлах:
+     - Обчислює абсолютний каталог `dirname(join(repoRoot, relPy))`.
+     - Перетворює його на відносний від `repoRoot` шлях; порожній рядок нормалізує до `'.'`.
+     - Додає у множину, **тільки якщо** одночасно:
+       - воркспейс **не** в чорному списку `isIgnoredWorkspaceRoot(ws)`;
+       - у тому самому каталозі **немає** `package.json` (тобто це чисто Python-пакет, а не змішаний).
+  4. Фінально фільтрує множину ще раз через `isIgnoredWorkspaceRoot` (захист на випадок, якщо `getMonorepoPackageRootDirs` повернув ігнорований шлях).
+  5. **Сортування:** `'.'` завжди першим, далі — лексикографічно за `localeCompare`.
+- **Side effects:**
+  - Синхронний `existsSync` (двічі для кореня + по разу для кожного знайденого підкаталогу).
+  - Асинхронна ітерація глобом по файловій системі (рекурсивний обхід `repoRoot`).
+- **Чому Python з `package.json` ігнорується:** пріоритет npm — якщо в одному каталозі є обидва файли, він уже потрапить як npm-воркспейс через `getMonorepoPackageRootDirs`; додавати його ще раз як Python — дубль.
+
+### `manifestFilePath(ws, manifest)`
+
+- **Сигнатура:** `(ws: string, manifest: PackageManifest) => string`
+- **Параметри:**
+  - `ws` — відносний шлях воркспейсу.
+  - `manifest` — об'єкт `PackageManifest`.
+- **Повертає:** `join(ws, manifest.manifestRel)` — наприклад, `'npm/rules/changelog/package.json'` або `'apps/foo/pyproject.toml'`.
+- **Side effects:** немає (чиста функція над рядками).
+- **Примітка:** не використовує `cwd` — повертає шлях відносний до кореня репо, придатний для логів та повідомлень про помилки.
+
+## Залежності
+
+### Зовнішні (npm)
+
+- **`smol-toml`** — мінімалістичний парсер TOML; імпортується іменований експорт `parse as parseToml`. Використовується тільки в `parsePyprojectFields` для розбору `pyproject.toml`.
+
+### Стандартна бібліотека Node.js
+
+- **`node:fs`** → `existsSync` — синхронна перевірка існування файлу. Використовується замість асинхронного `access`, бо викликається лінійно (не в гарячому циклі) і простіше у читанні.
+- **`node:fs/promises`** → `glob`, `readFile` — асинхронний обхід FS та читання тексту.
+- **`node:path`** → `dirname`, `join`, `relative` — кросплатформенна робота зі шляхами.
+
+### Внутрішні (монорепо)
+
+- **`../../../scripts/lib/workspaces.mjs`** (тобто `npm/scripts/lib/workspaces.mjs`):
+  - `getMonorepoPackageRootDirs(repoRoot)` — повертає список npm-воркспейсів кореневого `package.json`.
+  - `isIgnoredWorkspaceRoot(ws)` — фільтр для воркспейсів, які треба свідомо ігнорувати (`.git`, шаблони, тощо).
+
+### Контракти, що **не** імпортуються, але передбачаються
+
+- Структура `package.json`: поля `name: string`, `version: string`, `private?: boolean`, `files?: string[]`.
+- Структура `pyproject.toml`: таблиці `[project]` (PEP 621) і `[tool.poetry]` (legacy Poetry) з полями `name`, `version`.
+
+## Потік виконання / Використання
+
+### Типовий сценарій: перевірка changelog для всього монорепо
+
+```js
+import { getMonorepoProjectRootDirs, readPackageManifest, manifestFilePath } from './package-manifest.mjs'
+
+const roots = await getMonorepoProjectRootDirs(process.cwd())
+// roots ≈ ['.', 'apps/admin', 'npm/rules/changelog', 'python/tooling/foo', ...]
+
+for (const ws of roots) {
+  const manifest = await readPackageManifest(ws)
+  if (!manifest) continue // ні package.json, ні pyproject.toml — пропускаємо
+  if (!manifest.registryPublishable) continue // приватні / без 'files' / без version — не публікуються
+  console.log(manifest.kind, manifestFilePath(ws, manifest), manifest.name, manifest.version)
+}
+```
+
+### Послідовність викликів усередині `getMonorepoProjectRootDirs`
+
+1. `getMonorepoPackageRootDirs(repoRoot)` → npm-воркспейси.
+2. `existsSync('pyproject.toml')` + `existsSync('package.json')` на корені → опційно `'.'`.
+3. `glob('**/pyproject.toml')` → ітерація по підкаталогах:
+   - Для кожного `relPy` обчислити `ws`.
+   - `isIgnoredWorkspaceRoot(ws)` + `existsSync(join(repoRoot, ws, 'package.json'))` → фільтр.
+4. Фінальна фільтрація + сортування.
+
+### Послідовність викликів усередині `readPackageManifest`
+
+1. `existsSync(cwd/ws/package.json)`:
+   - **Так** → `readFile` + `JSON.parse` + перевірка типу → npm-маніфест або `null`.
+   - **Ні** → крок 2.
+2. `existsSync(cwd/ws/pyproject.toml)`:
+   - **Ні** → `null`.
+   - **Так** → `readFile` + `parsePyprojectFields` → python-маніфест.
+
+### Інваріанти
+
+- Якщо `kind === 'npm'`, то `manifestRel === 'package.json'`. Якщо `kind === 'python'`, то `manifestRel === 'pyproject.toml'`.
+- `npmFiles` ніколи не визначений для `kind === 'python'` (там завжди `null`).
+- `registryPublishable` має різний зміст за `kind`:
+  - npm: `name && !private && Array.isArray(files)`;
+  - python: `name && version`.
+- Усі функції безпечні щодо помилок IO/парсингу: повертають `null` / `{ null, null }` замість викидання винятків.
+
+### Обмеження та крайні випадки
+
+- **Глобальний обхід `**/pyproject.toml`** може бути повільним на дуже великих репо; список ігнорованих шляхів (`PYPROJECT_GLOB_IGNORE`) покриває типові важкі директорії, але не доменно-специфічні (наприклад, `dist/`).
+- **Перевірка типу JSON-кореня** — захист від `null`, масивів та примітивів, але не від «дивних» значень полів (наприклад, `version: 123`); такі значення безшумно перетворюються на `null`.
+- **`projectFieldsFromPyprojectDoc`** не підтримує **dynamic version** (PEP 621 `dynamic = ['version']`) — у такому разі `version === null`.
+- **`isIgnoredWorkspaceRoot`** застосовується двічі (під час додавання та фінальної фільтрації) — це навмисна перестраховка.

package/rules/changelog/lib/package-manifest.mjs

@@ -0,0 +1,158 @@
+/**
+ * Уніфікований маніфест пакета для перевірок changelog: `package.json` (npm/JS)
+ * або `pyproject.toml` (Python / PEP 621, Poetry).
+ */
+import { existsSync } from 'node:fs'
+import { glob, readFile } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+
+import { parse as parseToml } from 'smol-toml'
+
+import { getMonorepoPackageRootDirs, isIgnoredWorkspaceRoot } from '../../../scripts/lib/workspaces.mjs'
+
+/**
+ * @typedef {'npm' | 'python'} PackageKind
+ */
+
+/**
+ * @typedef {object} PackageManifest
+ * @property {PackageKind} kind тип маніфесту
+ * @property {string} ws відносний шлях воркспейсу (`'.'` для кореня)
+ * @property {string} manifestRel `package.json` | `pyproject.toml`
+ * @property {string | null} name ім'я пакета (npm / PyPI)
+ * @property {string | null} version semver-рядок
+ * @property {boolean} registryPublishable чи застосовується режим порівняння з реєстром
+ * @property {string[] | null} [npmFiles] лише npm: `files` з package.json
+ */
+
+const PYPROJECT_GLOB_IGNORE = ['**/node_modules/**', '**/.git/**', '**/.venv/**', '**/venv/**']
+
+/**
+ * @param {unknown} doc розпарсений pyproject.toml
+ * @returns {{ name: string | null, version: string | null }} витягнуті поля project / tool.poetry
+ */
+function projectFieldsFromPyprojectDoc(doc) {
+  if (!doc || typeof doc !== 'object' || Array.isArray(doc)) {
+    return { name: null, version: null }
+  }
+  const root = /** @type {Record<string, unknown>} */ (doc)
+  const project = root.project
+  if (project && typeof project === 'object' && !Array.isArray(project)) {
+    const p = /** @type {Record<string, unknown>} */ (project)
+    return {
+      name: typeof p.name === 'string' ? p.name : null,
+      version: typeof p.version === 'string' ? p.version : null
+    }
+  }
+  const tool = root.tool
+  if (tool && typeof tool === 'object' && !Array.isArray(tool)) {
+    const poetry = /** @type {Record<string, unknown>} */ (tool).poetry
+    if (poetry && typeof poetry === 'object' && !Array.isArray(poetry)) {
+      const po = /** @type {Record<string, unknown>} */ (poetry)
+      return {
+        name: typeof po.name === 'string' ? po.name : null,
+        version: typeof po.version === 'string' ? po.version : null
+      }
+    }
+  }
+  return { name: null, version: null }
+}
+
+/**
+ * @param {string} text вміст pyproject.toml
+ * @returns {{ name: string | null, version: string | null }} витягнуті поля project / tool.poetry
+ */
+export function parsePyprojectFields(text) {
+  try {
+    return projectFieldsFromPyprojectDoc(parseToml(text))
+  } catch {
+    return { name: null, version: null }
+  }
+}
+
+/**
+ * @param {string} ws шлях воркспейсу (відносно `cwd`)
+ * @param {string} [cwd] корінь репозиторію (за замовчуванням `process.cwd()`)
+ * @returns {Promise<PackageManifest | null>} маніфест пакета або null
+ */
+export async function readPackageManifest(ws, cwd = process.cwd()) {
+  const pkgPath = join(cwd, ws, 'package.json')
+  if (existsSync(pkgPath)) {
+    try {
+      const parsed = JSON.parse(await readFile(pkgPath, 'utf8'))
+      if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return null
+      }
+      const pkg = /** @type {Record<string, unknown>} */ (parsed)
+      const registryPublishable =
+        typeof pkg.name === 'string' && pkg.name.length > 0 && pkg.private !== true && Array.isArray(pkg.files)
+      return {
+        kind: 'npm',
+        ws,
+        manifestRel: 'package.json',
+        name: typeof pkg.name === 'string' ? pkg.name : null,
+        version: typeof pkg.version === 'string' ? pkg.version : null,
+        registryPublishable,
+        npmFiles: Array.isArray(pkg.files) ? pkg.files : null
+      }
+    } catch {
+      return null
+    }
+  }
+
+  const pyPath = join(cwd, ws, 'pyproject.toml')
+  if (!existsSync(pyPath)) {
+    return null
+  }
+  const fields = parsePyprojectFields(await readFile(pyPath, 'utf8'))
+  const registryPublishable = Boolean(fields.name && fields.version)
+  return {
+    kind: 'python',
+    ws,
+    manifestRel: 'pyproject.toml',
+    name: fields.name,
+    version: fields.version,
+    registryPublishable,
+    npmFiles: null
+  }
+}
+
+/**
+ * Каталоги пакетів: npm (`package.json` / workspaces) + Python (`pyproject.toml` без package.json).
+ * @param {string} [repoRoot] параметр
+ * @returns {Promise<string[]>} результат
+ */
+export async function getMonorepoProjectRootDirs(repoRoot = '.') {
+  const roots = new Set(await getMonorepoPackageRootDirs(repoRoot))
+
+  if (existsSync(join(repoRoot, 'pyproject.toml')) && !existsSync(join(repoRoot, 'package.json'))) {
+    roots.add('.')
+  }
+
+  for await (const relPy of glob('**/pyproject.toml', { cwd: repoRoot, ignore: PYPROJECT_GLOB_IGNORE })) {
+    const absDir = dirname(join(repoRoot, relPy))
+    const relRoot = relative(repoRoot, absDir)
+    const ws = relRoot === '' ? '.' : relRoot
+    if (!isIgnoredWorkspaceRoot(ws) && !existsSync(join(repoRoot, ws, 'package.json'))) {
+      roots.add(ws)
+    }
+  }
+
+  const list = [...roots].filter(ws => !isIgnoredWorkspaceRoot(ws))
+  list.sort((a, b) => {
+    if (a === '.') return -1
+    if (b === '.') return 1
+    return a.localeCompare(b)
+  })
+  return list
+}
+
+/**
+ * Шлях до файлу маніфесту воркспейсу.
+ * @param {string} ws параметр
+ * @param {PackageManifest} manifest параметр
+ * @returns {string} результат
+ */
+export function manifestFilePath(ws, manifest) {
+  return join(ws, manifest.manifestRel)
+}

package/rules/changelog/main.json

@@ -0,0 +1 @@
+{ "auto": ["bun"] }

package/rules/changelog/main.mdc

@@ -0,0 +1,7 @@
+---
+description: CHANGELOG.md в кожному workspace, з двома моделями бази порівняння (npm і Python)
+version: '3.4'
+alwaysApply: true
+---
+
+У кожному **пакетному** workspace (каталог із `package.json` або `pyproject.toml`) має бути власний **`CHANGELOG.md`**. Спільного на репозиторій змісту змін **не існує** — кожен пакет веде свій. Маніфест версії: **JS/Bun/npm** — `package.json` (`version`); **Python** — `pyproject.toml` (`[project].version` або `[tool.poetry].version`).

package/rules/changelog/presence/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "per-file",
+    "glob": ["**/*"]
+  }
+}

package/rules/changelog/presence/docs/main.md

@@ -0,0 +1,44 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/changelog/presence/main.mjs
+docgen:
+  crc: ede34018
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+  issues: internal-name:readChangeFiles,judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд:
+Цей компонент є легковаговим доповненням до повного контролю консистентності, забезпечуючи миттєвий "delta-гейт" щодо присутності необхідних файлів змін (`.changes/`) для кожного зачепленого не-root робочого простору. Він виконує мапінг зачеплених файлів (`ctx.files`) на відповідні робочі простори, перевіряючи, чи існує хоча б один файл changeset у директорії `.changes/` для кожного з них. Це дозволяє оперативно контролювати відповідність політикам, визначеним у `n-changelog.mdc`, відповідно до специфікації `spec docs/specs/2026-07-02-text-check-per-file-split-design.md §7`.
+
+Поведінка:
+1. Якщо вхідний список файлів для аналізу порожній, перевірка завершується успішно.
+2. Системно ідентифікує всі робочі простори (workspaces) у монорепозиторії, не покладаючись на мережеві чи Git-історичні дані.
+3. Для кожного зачепленого файлу, що не належить до ігнорованих шляхів, визначає його відповідний робочий простір.
+4. Для кожного визначеного робочого простору, що був зачеплений змінами, використовує `readChangeFiles` для перевірки.
+5. Якщо для робочого простору виявлено зміни, але відсутній хоча б один файл changeset у директорії `.changes/`, генерується порушення, що вказує на необхідність створення change-файлу згідно з вимогами `n-changelog.mdc`.
+6. Повертає статус виконання перевірки.
+
+## Поведінка
+
+Поведінка:
+1. Перевіряє, чи надано список файлів для аналізу. Якщо список порожній, аналіз завершується успішно.
+2. Ідентифікує всі робочі простори (workspaces) у монорепозиторії.
+3. Для кожного файлу у наданому списку, що не належить до ігнорованих шляхів (таких як документація чи інструментарій), визначає відповідний робочий простір.
+4. Пропускає аналіз для кореневого робочого простору, якщо він є єдиним.
+5. Для кожного визначеного робочого простору, який був зачеплений змінами:
+    а. Перевіряє наявність хоча б одного файлу changeset у директорії `.changes/` цього робочого простору.
+    б. Якщо змінний файл відсутній, генерує порушення, вказуючи на необхідність додавання change-файлу, як це описує (n-changelog.mdc).
+6. Повертає результат перевірки.
+
+## Публічний API
+
+- lint: Визначає наявність змін у файлі порівняно з історією (read-only).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/changelog/presence/main.mjs

@@ -0,0 +1,87 @@
+/**
+ * lint-поверхня changelog/presence: дешевий per-file companion до `changelog/consistency`
+ * (spec docs/specs/2026-07-02-text-check-per-file-split-design.md §7). Без мережі й без
+ * git-історії: мапить `ctx.files` на workspace-и й перевіряє, що для кожного зачепленого
+ * не-root workspace існує хоча б один change-файл у `.changes/` (`readChangeFiles`).
+ * Версійна коректність, registry-дрейф і merge-детекція лишаються в `changelog/consistency`
+ * (full, поза delta-планом) — presence лише повертає миттєвий delta-гейт "чи є changeset".
+ */
+import { getMonorepoProjectRootDirs } from '../lib/package-manifest.mjs'
+import { readChangeFiles } from '../../release/lib/change-file.mjs'
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+
+/**
+ * Префікси шляхів (posix), які не вважаються релізними змінами — та сама інверсія, що в
+ * `changelog/consistency` (`CHANGELOG_IGNORE_PATH_PREFIXES`): документація й синхронізований
+ * із `@7n/rules` інструментарій (`.cursor/`, `.claude/`).
+ */
+const CHANGELOG_IGNORE_PATH_PREFIXES = ['docs/', 'doc/', '.cursor/', '.claude/']
+
+const LEADING_DOTSLASH_RE = /^\.\//
+
+/**
+ * @param {string} relPath posix-relative шлях файлу.
+ * @returns {boolean} true — файл не рахується релізною зміною.
+ */
+function isChangelogIgnoredPath(relPath) {
+  const p = relPath.replaceAll('\\', '/').replace(LEADING_DOTSLASH_RE, '')
+  return CHANGELOG_IGNORE_PATH_PREFIXES.some(prefix => p.startsWith(prefix))
+}
+
+/**
+ * Знаходить workspace (найдовший префікс-збіг) для відносного шляху файлу.
+ * @param {string} relFile posix-relative шлях файлу.
+ * @param {string[]} workspaces усі workspace-каталоги монорепо (`.` — корінь).
+ * @returns {string} найкращий workspace-збіг (`.`, якщо жоден підкаталог не підійшов).
+ */
+function workspaceForFile(relFile, workspaces) {
+  let best = '.'
+  let bestLen = -1
+  for (const ws of workspaces) {
+    if (ws === '.') continue
+    const prefix = `${ws}/`
+    if (relFile.startsWith(prefix) && prefix.length > bestLen) {
+      best = ws
+      bestLen = prefix.length
+    }
+  }
+  return best
+}
+
+/**
+ * Detector changelog/presence (read-only, per-file).
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями.
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { fail } = reporter
+
+  if (ctx.files === undefined || ctx.files.length === 0) return reporter.result()
+
+  const cwd = ctx.cwd
+  const workspaces = await getMonorepoProjectRootDirs(cwd)
+  const subWorkspaces = workspaces.filter(w => w !== '.')
+  const isMonorepoRoot = subWorkspaces.length > 0
+
+  const touchedWorkspaces = new Set()
+  for (const f of ctx.files) {
+    if (isChangelogIgnoredPath(f)) continue
+    const ws = workspaceForFile(f, workspaces)
+    if (ws === '.' && isMonorepoRoot) continue // корінь монорепо — glue/tooling, без власного CHANGELOG
+    touchedWorkspaces.add(ws)
+  }
+
+  for (const ws of touchedWorkspaces) {
+    const changes = await readChangeFiles(ws, cwd)
+    if (changes.length === 0) {
+      const label = ws === '.' ? '<root>' : ws
+      fail(
+        `${label}: змінені файли без change-файлу в .changes/ — додай \`npx @7n/n ch\` (n-changelog.mdc)`,
+        'changeset-missing'
+      )
+    }
+  }
+
+  return reporter.result()
+}

package/rules/ci4/docs/index.md

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

package/rules/ci4/main.json

@@ -0,0 +1 @@
+{}