@7n/rules 1.0.0

package/rules/text/cspell-fix/main.mjs

@@ -0,0 +1,185 @@
+/**
+ * cspell у ланцюжку lint-text із omlx-класифікацією (нова схема — спека
+ * docs/specs/2026-06-15-opportunistic-llm-fix-tier.md).
+ *
+ * cspell не має нативного `--fix`, а емпірично ~90% «Unknown word» на укр+тех-репо —
+ * валідні терміни, не одруки (вимір: 1406 знахідок / 292 файли, ~90% словникові
+ * кандидати). Тому fix-режим НЕ переписує файли (старий whole-file `llmLintFix`
+ * таймаутив/парс-фейлив — bounded-output принцип спеки), а **класифікує** знахідки:
+ *   detect → omlx-класифікація distinct-слів (bounded JSON-вихід) → валідні слова
+ *   авто-дописуються у `.cspell.json#words` (sorted/dedup, видно в diff) → ймовірні
+ *   одруки лишаються списком на рев'ю (НЕ авто-виправляються — апплай небезпечний) →
+ *   re-detect. Класифікація виконується у `fix-worker.mjs` (Central Runner Pipeline);
+ *   тут — лише read-only детект і shared-хелпери класифікації.
+ *
+ * Гейт: валідні слова після дописування у словник зникають; нерозкласифіковані та
+ * typo лишаються → cspell повертає !=0 → exit 1 (людина доправляє одруки вручну).
+ */
+import { env } from 'node:process'
+import { spawnSync } from 'node:child_process'
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+
+/** Слово у рядку cspell: `<file>:<line>:<col> - Unknown word (xxx)`. */
+const UNKNOWN_WORD_RE = /Unknown word \(([^)]+)\)/u
+/** Підсумковий рядок cspell: `CSpell: Files checked: N, Issues found: M in K files.` */
+const FILES_CHECKED_RE = /Files checked:\s*(\d+)/u
+/** Максимум distinct-слів під класифікацію за прогін (без тихого обрізання — логуємо надлишок). */
+export const MAX_CLASSIFY_WORDS = 80
+
+/**
+ * Локальна fix-модель (рішення: єдиний knob `N_LOCAL_MIN_MODEL`).
+ * @returns {string} ідентифікатор моделі з env або порожній рядок.
+ */
+export const fixModel = () => env.N_LOCAL_MIN_MODEL || ''
+
+/**
+ * Запускає `cspell` над `files` (delta) або над `.` (full), захоплюючи вивід. Скоуп файлів, які
+ * cspell реально перевіряє, і так визначає сам `.cspell.json` (globs/ignorePaths) — переданий
+ * `files` лише звужує аргументи CLI, не дублює цю логіку. Без `verbose` вимикає власний
+ * per-file прогрес-репортер cspell (`--no-progress`), щоб не засмічувати `lint --full`; підсумковий
+ * рядок (`--no-summary` НЕ передається) лишається — з нього парситься `FILES_CHECKED_RE`.
+ * @param {string} cwd корінь
+ * @param {string} bin шлях до cspell (npx/локальний)
+ * @param {string[]} [files] явний перелік файлів (delta); без нього — `cspell .`
+ * @param {boolean} [verbose] показати повний нативний вивід cspell (включно з прогресом)
+ * @returns {{ code:number, out:string }} код + обʼєднаний stdout/stderr
+ */
+export function detectCspell(cwd, bin, files, verbose = false) {
+  const targets = files === undefined ? ['.'] : files
+  const quietArgs = verbose ? [] : ['--no-progress']
+  const r = spawnSync(bin, ['cspell', ...quietArgs, ...targets], {
+    cwd,
+    encoding: 'utf8',
+    maxBuffer: 32 * 1024 * 1024,
+    env: process.env
+  })
+  const out = `${r.stdout ?? ''}${r.stderr ?? ''}`
+  const code = typeof r.status === 'number' ? r.status : 1
+  // cspell повертає !=0 і коли жоден переданий файл не пройшов ignorePaths
+  // (`.cspell.json`) — «Files checked: 0» означає «нічого перевіряти», не порушення.
+  const checked = FILES_CHECKED_RE.exec(out)
+  if (checked && Number(checked[1]) === 0) return { code: 0, out }
+  return { code, out }
+}
+
+/**
+ * Унікальні «Unknown word» зі stdout cspell.
+ * @param {string} out вивід cspell
+ * @returns {string[]} distinct-слова у порядку першої появи
+ */
+export function unknownWords(out) {
+  const set = new Set()
+  for (const line of out.split('\n')) {
+    const m = UNKNOWN_WORD_RE.exec(line)
+    if (m) set.add(m[1])
+  }
+  return [...set]
+}
+
+/**
+ * Промпт класифікації: для укр+тех-репо bias у «valid» (додати валідне слово безпечно,
+ * «виправити» валідне — шкода). Вихід bounded — JSON-масив вердиктів.
+ * @param {string[]} words distinct-слова
+ * @returns {string} prompt
+ */
+export function classifyPrompt(words) {
+  return [
+    'You triage cspell "unknown word" findings for a Ukrainian + technical codebase.',
+    'For each word decide:',
+    '- "valid": correct technical term, identifier, abbreviation, transliteration, jargon, or intentional Ukrainian word → dictionary candidate.',
+    '- "typo": a genuine misspelling of a real word.',
+    'Default to "valid" when unsure (adding a real word to the dictionary is safe; "fixing" a valid word is harmful).',
+    'Return ONLY a JSON array, no markdown fences: [{"w":"<word>","verdict":"valid"|"typo","fix":"<correction or null>"}]',
+    'Words:',
+    ...words.map(w => `- ${w}`)
+  ].join('\n')
+}
+
+/**
+ * Витягує JSON-масив із відповіді моделі (бере від першої «[» до останньої «]» — зрізає прозу й markdown-обрамлення).
+ * @param {string} text відповідь
+ * @returns {Array<{w:string, verdict:string, fix:string|null}>|null} вердикти або null
+ */
+export function parseClassify(text) {
+  const start = text.indexOf('[')
+  const end = text.lastIndexOf(']')
+  if (start === -1 || end <= start) return null
+  try {
+    const arr = JSON.parse(text.slice(start, end + 1))
+    return Array.isArray(arr) ? arr : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Дописує слова у `.cspell.json#words` (sorted/dedup) — видно в git diff для рев'ю.
+ * @param {string} cwd корінь
+ * @param {string[]} words валідні слова
+ * @returns {number} к-сть фактично доданих (нових) слів
+ */
+export function appendWordsToDict(cwd, words) {
+  const cfgPath = join(cwd, '.cspell.json')
+  if (words.length === 0 || !existsSync(cfgPath)) return 0
+  const cfg = JSON.parse(readFileSync(cfgPath, 'utf8'))
+  const set = new Set(cfg.words)
+  const before = set.size
+  for (const w of words) set.add(w)
+  if (set.size === before) return 0
+  cfg.words = [...set].toSorted((a, b) => a.localeCompare(b))
+  writeFileSync(cfgPath, `${JSON.stringify(cfg, null, 2)}\n`)
+  return set.size - before
+}
+
+/**
+ * cspell-крок lint-text: read-only детект (нуль мутацій). LLM-класифікація знахідок
+ * і поповнення `.cspell.json#words` живуть у `fix-worker.mjs` (Central Runner Pipeline).
+ * @param {string[]} [files] явний перелік файлів (delta); без нього — `cspell .`
+ * @param {string} [cwd] корінь
+ * @param {boolean} [verbose] показати повний нативний вивід cspell (включно з прогресом)
+ * @returns {number} 0 — чисто; 1 — лишились знахідки / помилка середовища
+ */
+export function runCspellText(files, cwd = process.cwd(), verbose = false) {
+  const bin = resolveCmd('npx')
+  if (!bin) {
+    process.stderr.write('❌ npx не знайдено в PATH (cspell).\n')
+    return 1
+  }
+
+  const first = detectCspell(cwd, bin, files, verbose)
+  if (first.code === 0) {
+    // «Files checked: 0» при явно переданих файлах — легітимно (усі під ignorePaths),
+    // але так само виглядає зламане середовище (спостережено 2026-07-12: cspell-gitignore
+    // у git-worktree застосовував .gitignore основного репо і мовчки ігнорував УСЕ,
+    // поки .cspell.json#gitignoreRoot не обмежив обхід коренем конфіга). Сигналимо
+    // в stderr, щоб розрив local/CI не був німим, — без фейлу.
+    if (files !== undefined && files.length > 0 && FILES_CHECKED_RE.exec(first.out)?.[1] === '0')
+      process.stderr.write(
+        `⚠️ cspell: 0 із ${files.length} переданих файлів перевірено — або всі під ignorePaths, або зламаний скоуп (gitignore/worktree).\n`
+      )
+    return 0
+  }
+  process.stdout.write(first.out)
+  return first.code
+}
+
+/**
+ * Detector text/cspell-fix: read-only cspell по `ctx.files` (delta) або по всьому репо (full).
+ * Скоуп файлів, які реально перевіряються, керується `.cspell.json` (glob/ignorePaths) — тут
+ * лише звужуємо аргументи CLI до `ctx.files`, коли вони задані.
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат детектора
+ */
+export function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { fail } = reporter
+  if (ctx.files !== undefined && ctx.files.length === 0) return reporter.result()
+
+  const code = runCspellText(ctx.files, ctx.cwd, ctx.verbose === true)
+  if (code !== 0) fail('cspell знайшов порушення правопису (text.mdc)', 'cspell')
+  return reporter.result()
+}

package/rules/text/docs/index.md

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

package/rules/text/forbidden-prettier/concern.json

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

package/rules/text/forbidden-prettier/docs/index.md

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

package/rules/text/forbidden-prettier/docs/main.md

@@ -0,0 +1,38 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/text/forbidden-prettier/main.mjs
+docgen:
+  crc: 23cf1482
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд: Перевіряє, чи відповідає конфігураційна структура проєкту встановленим стандартам форматування, скануючи кореневу директорію на наявність файлів конфігурації Prettier, зокрема `.prettierrc.json`.
+
+Поведінка:
+Викликається `main` для запуску перевірки.
+Система сканує кореневу директорію проєкту на наявність конфігураційних файлів, що стосуються Prettier.
+Якщо виявлено заборонений конфігураційний файл Prettier у корені, система видає повідомлення з маркуванням (text.mdc) про необхідність корекції, оскільки необхідно використовувати oxfmt.
+Якщо жодних заборонених файлів Prettier не знайдено, перевірка вважається успішною.
+
+## Поведінка
+
+Поведінка:
+
+1. Викликається `main` для запуску перевірки.
+2. Система сканує кореневу директорію проєкту на наявність конфігураційних файлів, що стосуються Prettier (зокрема, `.prettierrc.json`).
+3. Якщо виявлено будь-який заборонений файл Prettier у корені, відбувається відхилення з повідомленням, що необхідно використовувати oxfmt, з посиланням на `text.mdc`.
+4. Якщо жодних заборонених файлів Prettier не знайдено, перевірка вважається успішною.
+
+## Публічний API
+
+- main — перевіряє відсутність конфігураційних файлів форматування (Prettier) або файлів ігнорування у корені проєкту.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/text/forbidden-prettier/forbidden-prettier.mdc

@@ -0,0 +1,14 @@
+## Заборона Prettier
+
+Prettier **повністю заборонено** — форматування лише через **oxfmt**.
+
+Також потрібно прибрати, якщо є в проєкті, модуль **`@nitra/prettier-config`**, **prettier** та всі виклики prettier і налаштування для нього. Канон заборонених top-level/`dependencies`/`devDependencies` (prettier, `@nitra/prettier-config`, `markdownlint-cli2`): [package.json.deny.json](./policy/package_json/template/package.json.deny.json)
+
+Перевірка `npx @7n/rules fix text` падає, якщо у корені є `.prettierignore`, `.prettierrc*`, `prettier.config.*` або у `package.json#scripts` зустрічається команда з `prettier`.
+
+Заборонені файли конфігурації Prettier у корені:
+
+- `.prettierignore`, `.prettierrc`, `.prettierrc.json`, `.prettierrc.jsonc`, `.prettierrc.json5`
+- `.prettierrc.yaml`, `.prettierrc.yml`, `.prettierrc.toml`
+- `.prettierrc.js`, `.prettierrc.cjs`, `.prettierrc.mjs`, `.prettierrc.ts`, `.prettierrc.cts`, `.prettierrc.mts`
+- `prettier.config.js`, `prettier.config.cjs`, `prettier.config.mjs`, `prettier.config.ts`, `prettier.config.cts`, `prettier.config.mts`

package/rules/text/forbidden-prettier/main.mjs

@@ -0,0 +1,56 @@
+/** @see ./docs/forbidden-prettier.md */
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+
+/** Файли, які Prettier шукає у корені; всі заборонені (text.mdc). */
+const FORBIDDEN_PRETTIER_FILES = [
+  '.prettierignore',
+  '.prettierrc',
+  '.prettierrc.json',
+  '.prettierrc.jsonc',
+  '.prettierrc.json5',
+  '.prettierrc.yaml',
+  '.prettierrc.yml',
+  '.prettierrc.toml',
+  '.prettierrc.js',
+  '.prettierrc.cjs',
+  '.prettierrc.mjs',
+  '.prettierrc.ts',
+  '.prettierrc.cts',
+  '.prettierrc.mts',
+  'prettier.config.js',
+  'prettier.config.cjs',
+  'prettier.config.mjs',
+  'prettier.config.ts',
+  'prettier.config.cts',
+  'prettier.config.mts'
+]
+
+/**
+ * Перевіряє, що жоден Prettier-конфіг чи ignore-файл не лежить у корені проєкту.
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту (cwd, репортер).
+ * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат перевірки з pass/fail.
+ */
+export function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  const cwd = ctx.cwd
+
+  let anyFound = false
+  for (const file of FORBIDDEN_PRETTIER_FILES) {
+    if (!existsSync(join(cwd, file))) {
+      continue
+    }
+
+    fail(`${file} заборонено — Prettier не використовуємо, перейди на oxfmt (text.mdc)`)
+    anyFound = true
+  }
+  if (!anyFound) {
+    pass('Prettier-конфігів і .prettierignore немає в корені')
+  }
+
+  return reporter.result()
+}

package/rules/text/formatting/concern.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "full",
+    "glob": [
+      ".v8rignore",
+      ".oxfmtrc.json",
+      ".cspell.json",
+      ".markdownlint-cli2.jsonc",
+      ".vscode/extensions.json",
+      ".vscode/settings.json",
+      ".cursor/rules/n-text.mdc",
+      "npm/mdc/text.mdc",
+      ".github/workflows/lint-text.yml"
+    ]
+  }
+}

package/rules/text/formatting/docs/index.md

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

package/rules/text/formatting/docs/main.md

@@ -0,0 +1,39 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/text/formatting/main.mjs
+docgen:
+  crc: 2621711a
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: best-of-2:retry-won,judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+**Огляд**
+Цей код забезпечує консистентність конфігурації проєкту, перевіряючи наявність ключових конфігураційних файлів. Він також підтверджує відповідність налаштувань тексту та вимогам CI-процесів, спираючись на конфіги: extensions.json, settings.json, target.json, .oxfmtrc.json, .cspell.json, package.json.
+
+**Поведінка**
+При виклику функції main, код перевіряє наявність конфігураційних файлів для текстового стеку: .oxfmtrc.json, .cspell.json, extensions.json, settings.json, target.json, package.json. Якщо знаходяться правила text.mdc, відбувається перевірка щодо українського апострофа у цих правилах. Також перевіряється файл .github/workflows/lint-text.yml на відповідність вимогам до CI-workflow. Функція main повертає код завершення, відображаючи результат усіх перевірок. Код не взаємодіє з файловою системою чи базами даних.
+
+## Поведінка
+
+Поведінка:
+
+1. Викликається функція main.
+2. Проводиться перевірка файлу .v8rignore на наявність посилань на .vscode/extensions.json та .vscode/settings.json.
+3. Проводиться перевірка наявності конфігураційних файлів для текстового стеку: .oxfmtrc.json, .cspell.json, .markdownlint-cli2.jsonc, .vscode/extensions.json, .vscode/settings.json.
+4. Якщо знайдено правила text.mdc, виконується перевірка абзацу про український апостроф у цих правилах.
+5. Проводиться перевірка файлу .github/workflows/lint-text.yml на відповідність вимогам до CI-workflow.
+6. Функція main повертає код завершення, що відображає результат усіх перевірок. Не перевіряються шляхи .github та .git.
+
+## Публічний API
+
+main — перевіряє дотримання проєкту правил text.mdc.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/text/formatting/main.mjs

@@ -0,0 +1,149 @@
+/** @see ./docs/formatting.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { anyRunStepIncludes, parseWorkflowYaml } from '../../../scripts/lib/gha-workflow.mjs'
+
+/** Заголовок абзацу про апостроф у text.mdc / n-text.mdc. */
+const UK_APOSTROPHE_HEADING = '**Український апостроф:**'
+
+/**
+ * Перевіряє абзац про український апостроф у вмісті правила text.
+ * @param {string} filePath шлях до файлу (для повідомлень)
+ * @param {string} body вміст .mdc у UTF-8
+ * @param {(msg: string) => void} failFn реєструє порушення (exit 1)
+ * @param {(msg: string) => void} passFn реєструє успішну перевірку
+ * @returns {void}
+ */
+function verifyUkApostropheRuleParagraph(filePath, body, failFn, passFn) {
+  if (!body.includes(UK_APOSTROPHE_HEADING)) {
+    failFn(`${filePath}: додай абзац **Український апостроф:** (U+0027 / U+2019, масив words) — див. text.mdc`)
+    return
+  }
+  if (!body.includes('U+0027') || !body.includes('U+2019')) {
+    failFn(`${filePath}: абзац про апостроф має містити позначки U+0027 та U+2019`)
+    return
+  }
+  if (!body.includes('’')) {
+    failFn(`${filePath}: у прикладі має бути типографський символ U+2019 (’)`)
+    return
+  }
+  passFn(`${filePath}: абзац про український апостроф на місці`)
+}
+
+/**
+ * Перевіряє .v8rignore.
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
+ */
+async function checkV8rIgnore(passFn, failFn, cwd) {
+  const required = ['.vscode/extensions.json', '.vscode/settings.json']
+  const v8rPath = join(cwd, '.v8rignore')
+  if (!existsSync(v8rPath)) {
+    failFn('.v8rignore не існує — створи згідно n-text.mdc (мінімум .vscode/extensions.json і .vscode/settings.json)')
+    return
+  }
+  const raw = await readFile(v8rPath, 'utf8')
+  const lines = new Set(
+    raw
+      .split('\n')
+      .map(l => l.trim())
+      .filter(l => l.length > 0 && !l.startsWith('#'))
+  )
+  for (const path of required) {
+    if (lines.has(path)) {
+      passFn(`.v8rignore містить ${path}`)
+    } else {
+      failFn(`.v8rignore: додай рядок "${path}" (JSON без схеми в Schema Store — див. n-text.mdc)`)
+    }
+  }
+}
+
+// `.vscode/extensions.json` (`DavidAnson.vscode-markdownlint`, `oxc.oxc-vscode`,
+// `timonwong.shellcheck`) і `.vscode/settings.json` (`editor.formatOnSave` +
+// `[lang].editor.defaultFormatter`) валідують rego-пакети `text.vscode_extensions`
+// і `text.vscode_settings` (auto-discovered через `target.json` поруч з `.rego`).
+// FS-existence файлів — у `checkTextConfigsExistence`.
+
+/**
+ * FS-existence стек текстових конфігів. Контент-валідація — у Rego
+ * (`text.oxfmtrc`, `text.cspell`, `text.markdownlint`).
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ * @returns {Promise<void>}
+ * @param {string} cwd корінь репозиторію
+ */
+function checkTextConfigsExistence(passFn, failFn, cwd) {
+  for (const [path, mdcRef] of [
+    ['.oxfmtrc.json', 'text.oxfmtrc'],
+    ['.cspell.json', 'text.cspell'],
+    ['.markdownlint-cli2.jsonc', 'text.markdownlint'],
+    ['.vscode/extensions.json', 'text.vscode_extensions'],
+    ['.vscode/settings.json', 'text.vscode_settings']
+  ]) {
+    if (existsSync(join(cwd, path))) {
+      passFn(`${path} є (структуру перевіряє npx @7n/rules fix → ${mdcRef})`)
+    } else {
+      failFn(`${path} не існує — створи згідно n-text.mdc`)
+    }
+  }
+  return Promise.resolve()
+}
+
+/**
+ * Перевіряє CI-workflow текстового стека: крок `n-rules lint text --no-fix` у
+ * `.github/workflows/lint-text.yml` (CI — нуль мутацій). Окремого `lint-text` скрипта в
+ * `package.json` немає — лінт через `n-rules lint text`. Решта package.json-перевірок
+ * (Prettier-заборона, `@nitra/cspell-dict`, `@nitra/*` гейт) — у Rego (`text.package_json`, `bun.package_json`).
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ * @param {string} cwd корінь репозиторію
+ */
+async function checkLintTextWorkflow(passFn, failFn, cwd) {
+  const lintTextWf = join(cwd, '.github/workflows/lint-text.yml')
+  if (existsSync(lintTextWf)) {
+    const wf = await readFile(lintTextWf, 'utf8')
+    const root = parseWorkflowYaml(wf)
+    const canonRun = 'n-rules lint text --no-fix'
+    const ok = root ? anyRunStepIncludes(root, canonRun) : wf.includes(canonRun)
+    if (ok) {
+      passFn(`lint-text.yml викликає ${canonRun}`)
+    } else {
+      failFn(`lint-text.yml має містити крок ${canonRun} (CI — read-only, нуль мутацій)`)
+    }
+  } else {
+    failFn('.github/workflows/lint-text.yml не існує — створи згідно n-text.mdc')
+  }
+}
+
+/**
+ * Перевіряє відповідність проєкту правилам text.mdc.
+ * @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 { pass, fail } = reporter
+
+  const cwd = ctx.cwd
+  await checkV8rIgnore(pass, fail, cwd)
+  await checkTextConfigsExistence(pass, fail, cwd)
+
+  // Prettier-конфіги/ignore — окремий concern `text.forbidden-prettier` (rules/text/js/forbidden-prettier.mjs).
+
+  const textRulePaths = ['.cursor/rules/n-text.mdc', 'npm/mdc/text.mdc'].filter(p => existsSync(join(cwd, p)))
+  if (textRulePaths.length === 0) {
+    pass('n-text.mdc / npm/mdc/text.mdc відсутні — перевірку абзацу про апостроф пропущено')
+  } else {
+    for (const p of textRulePaths) {
+      verifyUkApostropheRuleParagraph(p, await readFile(join(cwd, p), 'utf8'), fail, pass)
+    }
+  }
+
+  await checkLintTextWorkflow(pass, fail, cwd)
+
+  return reporter.result()
+}

package/rules/text/lint_text/concern.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "policy": {
+    "files": {
+      "single": ".github/workflows/lint-text.yml"
+    }
+  }
+}

package/rules/text/lint_text/lint_text.mdc

@@ -0,0 +1,19 @@
+## Перевірка `.github/workflows/lint-text.yml` — структура CI-workflow
+
+Rego-пакет: `text.lint_text`
+
+Цільовий файл: `.github/workflows/lint-text.yml`
+
+**Що перевіряється:**
+
+- `name` — має бути `"Lint Text"`
+- `on.push.branches` та `on.pull_request.branches` — мають містити `dev` і `main`
+- `on.push.paths` — має бути надмножиною канонічних glob-ів (усі текстові розширення)
+- `jobs.text` — job обов'язковий
+- `jobs.text.runs-on` — має бути `ubuntu-latest`
+- `jobs.text.permissions.contents` — має бути `read`
+- `jobs.text.steps` — не порожній; має містити всі канонічні `uses:` та `run:` підрядки
+
+Канонічна структура workflow: [lint-text.yml.snippet.yml](./template/lint-text.yml.snippet.yml)
+
+**Примітка:** conftest парсить YAML 1.1, де ключ `on:` без лапок перетворюється на булевий `true` — rego читає on-блок через `input["true"]`.