@nitra/cursor 12.9.0 → 12.11.0

package/scripts/lib/fix/llm-worker.mjs

@@ -4,7 +4,7 @@ import { existsSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { env } from 'node:process'
 import { resolveModel } from '../../../lib/models.mjs'
-import { callLlm } from '../../../lib/llm.mjs'
+import { callLlmRich } from '../../../lib/llm.mjs'
 import { applyChanges, parseChangesResponse, readFilesForFix } from './llm-fix-apply.mjs'
 
 // Дефолтна модель, коли викликач не задав `opts.model` (legacy/прямі виклики).
@@ -12,6 +12,10 @@ import { applyChanges, parseChangesResponse, readFilesForFix } from './llm-fix-a
 // тут лишається тільки fallback на min-тир. Перевизначення — `N_CURSOR_FIX_MODEL`.
 const MODEL = env.N_CURSOR_FIX_MODEL ?? resolveModel('min')
 
+// Бюджет thinking-токенів для omlx-моделей (Gemma 4 та ін., що підтримують thinking_budget).
+// Значення 0 вимикає thinking. Перевизначення — `N_CURSOR_OMLX_THINKING_BUDGET`.
+const DEFAULT_THINKING_BUDGET = Number(env.N_CURSOR_OMLX_THINKING_BUDGET ?? 4096)
+
 const API_KEY_RE = /api key/i
 
 /**
@@ -112,23 +116,32 @@ function buildPrompt(ruleId, ruleMdc, output, files, feedback = null) {
 }
 
 /**
- * Викликає LLM через спільний `callLlm` (маршрут за префіксом model-id; wire-trace).
+ * Викликає LLM через `callLlmRich` (маршрут за префіксом model-id; wire-trace).
+ * Повертає reasoning поряд із текстом — для verbose-блоку оркестратора.
  * Зберігає дружнє повідомлення про відсутній API-ключ для хмарних провайдерів.
  * @param {string} prompt текст промпта
  * @param {string} model назва моделі (provider/id, `omlx/...` або '')
  * @param {string} caller мітка викликача для wire-trace (`fix:<rule>:<rung>`)
- * @param {number} [timeoutMs] ліміт виклику (драбина задає per-tier; undefined → дефолт callLlm)
- * @returns {{ text: string, error?: string }} текст відповіді або повідомлення про помилку
+ * @param {number} [timeoutMs] ліміт виклику (драбина задає per-tier; undefined → дефолт callLlmRich)
+ * @param {number} [thinkingBudget] бюджет thinking-токенів (лише omlx; 0 = вимкнено)
+ * @returns {{ text: string, reasoning: string|null, reasoningSource: string|null, error?: string }}
  */
-function callModel(prompt, model, caller, timeoutMs) {
+function callModel(prompt, model, caller, timeoutMs, thinkingBudget) {
   try {
-    return { text: callLlm([{ role: 'user', content: prompt }], model, { timeoutMs, caller }) }
+    const { content, reasoning, reasoningSource } = callLlmRich([{ role: 'user', content: prompt }], model, {
+      timeoutMs,
+      caller,
+      thinkingBudget
+    })
+    return { text: content, reasoning, reasoningSource }
   } catch (error) {
     const msg = String(error.message)
     if (API_KEY_RE.test(msg)) {
       const provider = model ? model.split('/')[0] : 'дефолтного провайдера'
       return {
         text: '',
+        reasoning: null,
+        reasoningSource: null,
         error: [
           `pi: немає ключа для ${provider}.`,
           `Встановіть N_CLOUD_MIN_MODEL=provider/model-id`,
@@ -136,7 +149,7 @@ function callModel(prompt, model, caller, timeoutMs) {
         ].join(' ')
       }
     }
-    return { text: '', error: msg }
+    return { text: '', reasoning: null, reasoningSource: null, error: msg }
   }
 }
 
@@ -144,21 +157,24 @@ function callModel(prompt, model, caller, timeoutMs) {
  * LLM-worker: виправляє одне rule-порушення через pi (C1 pattern).
  * Повертає `changes`/`diagnosis` навіть при невдачі — драбина ескалації
  * (`orchestrator.mjs`) логує їх і прокидає як feedback у наступний рунг.
+ * Поля `reasoning`/`reasoningSource`/`promptSummary` використовує оркестратор
+ * для verbose-блоку після кожного рунга (`--full` режим).
  * @param {string} ruleId ID правила
  * @param {string} violationOutput  output з fix check для цього rule
  * @param {string} projectRoot      абсолютний шлях до кореня проєкту
- * @param {{ model?: string, feedback?: object|null, caller?: string, timeoutMs?: number }} opts опції:
+ * @param {{ model?: string, feedback?: object|null, caller?: string, timeoutMs?: number, thinkingBudget?: number }} opts опції:
  *   `model` — перевизначення моделі; `feedback` — контекст попереднього рунга
  *   драбини (retry-with-feedback); `caller` — мітка для wire-trace; `timeoutMs` —
- *   per-tier ліміт виклику (драбина: локалі fail-fast, хмара повний)
- * @returns {{ ok: boolean, error?: string, changes: Array<{path:string}>, diagnosis: string|null }}
- *   статус виправлення, помилка, запропоновані зміни і само-аналіз моделі
+ *   per-tier ліміт виклику (драбина: локалі fail-fast, хмара повний);
+ *   `thinkingBudget` — кількість thinking-токенів для omlx (дефолт `DEFAULT_THINKING_BUDGET`)
+ * @returns {{ ok: boolean, error?: string, changes: Array<{path:string}>, diagnosis: string|null, reasoning: string|null, reasoningSource: string|null, promptSummary: object }}
  */
 export function runLlmWorker(ruleId, violationOutput, projectRoot, opts = {}) {
   const model = opts.model ?? MODEL
   const feedback = opts.feedback ?? null
   const caller = opts.caller ?? 'fix'
   const timeoutMs = opts.timeoutMs
+  const thinkingBudget = opts.thinkingBudget ?? DEFAULT_THINKING_BUDGET
 
   // 1. Читаємо rule .mdc
   const mdcPath = join(projectRoot, '.cursor', 'rules', `n-${ruleId}.mdc`)
@@ -167,24 +183,61 @@ export function runLlmWorker(ruleId, violationOutput, projectRoot, opts = {}) {
   // 2. Витягуємо файли з violation output і читаємо їх
   const files = readFilesForFix(extractFilePaths(violationOutput), projectRoot)
 
-  // 3. Будуємо prompt і викликаємо модель
-  const prompt = buildPrompt(ruleId, ruleMdc, violationOutput, files, feedback)
-  const { text, error: modelError } = callModel(prompt, model, caller, timeoutMs)
+  // 3. Будуємо summary промпту (для verbose-блоку) до виклику моделі
+  const promptSummary = {
+    ruleMdcLen: ruleMdc.length,
+    violationLen: violationOutput.length,
+    filesCount: files.length,
+    filesTotalBytes: files.reduce((s, f) => s + f.content.length, 0),
+    hasFeedback: !!feedback,
+    feedbackModel: feedback?.previousModel ?? null,
+    feedbackChangesCount: feedback?.previousChanges?.length ?? 0,
+    feedbackError: feedback?.previousError ?? null
+  }
 
-  if (modelError) return { ok: false, error: modelError, changes: [], diagnosis: null }
-  if (!text) return { ok: false, error: 'model returned empty response', changes: [], diagnosis: null }
+  // 4. Будуємо prompt і викликаємо модель
+  const prompt = buildPrompt(ruleId, ruleMdc, violationOutput, files, feedback)
+  const {
+    text,
+    error: modelError,
+    reasoning,
+    reasoningSource
+  } = callModel(prompt, model, caller, timeoutMs, thinkingBudget)
+
+  if (modelError)
+    return { ok: false, error: modelError, changes: [], diagnosis: null, reasoning, reasoningSource, promptSummary }
+  if (!text)
+    return {
+      ok: false,
+      error: 'model returned empty response',
+      changes: [],
+      diagnosis: null,
+      reasoning,
+      reasoningSource,
+      promptSummary
+    }
 
-  // 4. Парсимо відповідь
+  // 5. Парсимо відповідь
   const parsed = parseChangesResponse(text)
   if (!parsed) {
-    return { ok: false, error: `cannot parse pi response: ${text.slice(0, 200)}`, changes: [], diagnosis: null }
+    return {
+      ok: false,
+      error: `cannot parse pi response: ${text.slice(0, 200)}`,
+      changes: [],
+      diagnosis: null,
+      reasoning,
+      reasoningSource,
+      promptSummary
+    }
   }
   const diagnosis = typeof parsed.diagnosis === 'string' && parsed.diagnosis ? parsed.diagnosis : null
   const changes = parsed.changes ?? []
-  if (parsed.error) return { ok: false, error: parsed.error, changes, diagnosis }
-  if (changes.length === 0) return { ok: false, error: 'pi returned no changes', changes, diagnosis }
+  if (parsed.error)
+    return { ok: false, error: parsed.error, changes, diagnosis, reasoning, reasoningSource, promptSummary }
+  if (changes.length === 0)
+    return { ok: false, error: 'pi returned no changes', changes, diagnosis, reasoning, reasoningSource, promptSummary }
 
-  // 5. Застосовуємо зміни
+  // 6. Застосовуємо зміни
   const applied = applyChanges(changes, projectRoot)
-  return { ...applied, changes, diagnosis }
+  return { ...applied, changes, diagnosis, reasoning, reasoningSource, promptSummary }
 }

package/scripts/lib/fix/orchestrator.mjs

@@ -5,6 +5,7 @@ import { runConformanceCheck } from './run-conformance-check.mjs'
 import { runT0AutoCli } from './t0.mjs'
 import { logEscalation } from './escalation-log.mjs'
 import { runLlmWorker } from './llm-worker.mjs'
+import { printVerboseBlock } from './verbose-block.mjs'
 import { classifyOmlxError } from '../../../lib/llm.mjs'
 import { CLOUD_AVG, CLOUD_MIN, LOCAL_MIN } from '../../../lib/models.mjs'
 
@@ -147,11 +148,16 @@ export async function escalateRule(rule, cwd, deps) {
 
     if (recheckOk) {
       log(`  ✅ ${rung.tier} (${rung.model || 'pi'}): ${rule.ruleId}`)
-      return { resolved: true, avgUsed }
+    } else {
+      const hint = res.error ? ` ❌ ${res.error.slice(0, 120)}` : ' ❌ досі порушено'
+      log(`  ⚡ ${rung.tier} (${rung.model || 'pi'}): ${rule.ruleId}${hint}`)
     }
 
-    const hint = res.error ? ` ❌ ${res.error.slice(0, 120)}` : ' ❌ досі порушено'
-    log(`  ⚡ ${rung.tier} (${rung.model || 'pi'}): ${rule.ruleId}${hint}`)
+    if (env.N_CURSOR_FIX_VERBOSE !== 'off' && res.promptSummary) {
+      printVerboseBlock(rule.ruleId, res.promptSummary, res.reasoning ?? null, res.reasoningSource ?? null)
+    }
+
+    if (recheckOk) return { resolved: true, avgUsed }
 
     // Feedback для наступного рунга + оновлений violation.
     feedback = { previousModel: rung.model, previousChanges: res.changes ?? [], previousError: res.error ?? null }

package/scripts/lib/fix/verbose-block.mjs

@@ -0,0 +1,82 @@
+/**
+ * Verbose-блок після кожного LLM-рунга у `--full` режимі.
+ * Друкує стислий опис промпту і thinking-монолог моделі (якщо є).
+ * Вимикається через `N_CURSOR_FIX_VERBOSE=off`.
+ */
+
+const THINKING_PREVIEW_LEN = 500
+
+/**
+ * Форматує рядок файлів для prompt-блоку.
+ * @param {number} count кількість файлів
+ * @param {number} totalBytes сумарний розмір у байтах
+ * @returns {string}
+ */
+function formatFiles(count, totalBytes) {
+  if (count === 0) return '(none)'
+  const kb = (totalBytes / 1024).toFixed(1)
+  const word = count === 1 ? 'файл' : count < 5 ? 'файли' : 'файлів'
+  return `${count} ${word} (${kb} KB)`
+}
+
+/**
+ * Форматує рядок feedback для prompt-блоку.
+ * @param {boolean} hasFeedback чи є feedback
+ * @param {string|null} feedbackModel модель попереднього рунга
+ * @param {number} feedbackChangesCount кількість змін попереднього рунга
+ * @param {string|null} feedbackError помилка попереднього рунга
+ * @returns {string}
+ */
+function formatFeedback(hasFeedback, feedbackModel, feedbackChangesCount, feedbackError) {
+  if (!hasFeedback) return '(none)'
+  const parts = []
+  if (feedbackModel) parts.push(`model=${feedbackModel}`)
+  parts.push(`${feedbackChangesCount} changes`)
+  if (feedbackError) parts.push(`error="${feedbackError.slice(0, 60)}"`)
+  return parts.join(', ')
+}
+
+/**
+ * Друкує verbose-блок після рядка рунга (`⚡`/`✅`).
+ * Містить стислий опис промпту і thinking-монолог моделі (якщо є).
+ * Не викликається якщо `N_CURSOR_FIX_VERBOSE=off`.
+ * @param {string} ruleId ID правила
+ * @param {{ ruleMdcLen: number, violationLen: number, filesCount: number, filesTotalBytes: number, hasFeedback: boolean, feedbackModel: string|null, feedbackChangesCount: number, feedbackError: string|null }} promptSummary стислий опис промпту
+ * @param {string|null} reasoning thinking-монолог моделі
+ * @param {string|null} reasoningSource джерело reasoning ('field'|'think_tag'|'truncated'|null)
+ */
+export function printVerboseBlock(ruleId, promptSummary, reasoning, reasoningSource) {
+  const {
+    ruleMdcLen,
+    violationLen,
+    filesCount,
+    filesTotalBytes,
+    hasFeedback,
+    feedbackModel,
+    feedbackChangesCount,
+    feedbackError
+  } = promptSummary
+
+  console.log(``)
+  console.log(`  prompt:`)
+  console.log(`    rule:      n-${ruleId}.mdc (${ruleMdcLen} chars)`)
+  console.log(`    violation: ${violationLen} chars`)
+  console.log(`    files:     ${formatFiles(filesCount, filesTotalBytes)}`)
+  console.log(`    feedback:  ${formatFeedback(hasFeedback, feedbackModel, feedbackChangesCount, feedbackError)}`)
+
+  if (reasoning) {
+    const preview =
+      reasoning.length > THINKING_PREVIEW_LEN
+        ? reasoning.slice(0, THINKING_PREVIEW_LEN) + ` … (+${reasoning.length - THINKING_PREVIEW_LEN} chars)`
+        : reasoning
+    console.log(``)
+    console.log(`  thinking [${reasoningSource}, ${reasoning.length} chars]:`)
+    for (const line of preview.split('\n')) {
+      console.log(`    ${line}`)
+    }
+  } else {
+    console.log(``)
+    console.log(`  thinking: (none)`)
+  }
+  console.log(``)
+}

package/scripts/lib/inline-template-links.mjs

@@ -1,10 +1,9 @@
 import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
+import { readFile, readdir } from 'node:fs/promises'
 import { basename, extname, join } from 'node:path'
 
 const MD_LINK_RE = /\[([^\]]{1,200})\]\((\.\/[^)]{1,500})\)/g
 const TEMPLATE_SEGMENT_RE = /\/templates?\//
-const MDC_EXT_RE = /\.mdc$/
 /** Статичні regexp-літерали `^(.+)\.<slot>\.<ext>$` — без `RegExp(variable)`. */
 const SLOT_SUFFIX_RES = [/^(.+)\.snippet\.[^.]+$/, /^(.+)\.deny\.[^.]+$/, /^(.+)\.contains\.[^.]+$/]
 
@@ -69,31 +68,42 @@ export async function inlineTemplateLinks(text, ruleDir) {
 }
 
 /**
- * Finds markdown links whose href ends with `.mdc` (and is not a /template/ path) and
- * replaces them with the raw markdown content of the linked file (no fencing).
- * Intended for per-concern section files living alongside their .mjs implementations.
- * Throws Error if a matched link target doesn't exist (fail loud).
- * @param {string} text .mdc file contents (after inlineTemplateLinks)
+ * Appends all *.mdc files auto-discovered in js/ and policy/<concern>/ subdirectories.
+ * js/ direct files come first (alphabetically), then policy concern directories
+ * (alphabetically by concern name, then by file name within each concern).
+ * @param {string} text rule content (after inlineTemplateLinks)
  * @param {string} ruleDir absolute path to the rule directory
- * @returns {Promise<string>} transformed text
+ * @returns {Promise<string>} text with discovered concern docs appended
  */
-export async function inlineMarkdownIncludes(text, ruleDir) {
-  const matches = [...text.matchAll(MD_LINK_RE)].filter(m => MDC_EXT_RE.test(m[2]) && !TEMPLATE_SEGMENT_RE.test(m[2]))
-  if (matches.length === 0) return text
+export async function appendDiscoveredMdcFiles(text, ruleDir) {
+  const sections = []
 
-  let result = text
-  for (const match of matches) {
-    const [fullMatch, , href] = match
-    const relPath = href.slice(2) // strip leading ./
-    const absPath = join(ruleDir, relPath)
-
-    if (!existsSync(absPath)) {
-      throw new Error(`inlineMarkdownIncludes: file not found: ${absPath} (referenced from .mdc)`)
+  const jsDir = join(ruleDir, 'js')
+  if (existsSync(jsDir)) {
+    const entries = await readdir(jsDir, { withFileTypes: true })
+    for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+      if (e.isFile() && e.name.endsWith('.mdc')) {
+        sections.push((await readFile(join(jsDir, e.name), 'utf8')).trim())
+      }
     }
+  }
 
-    const raw = await readFile(absPath, 'utf8')
-    result = result.replace(fullMatch, () => raw.trim())
+  const policyDir = join(ruleDir, 'policy')
+  if (existsSync(policyDir)) {
+    const concerns = (await readdir(policyDir, { withFileTypes: true }))
+      .filter(e => e.isDirectory())
+      .sort((a, b) => a.name.localeCompare(b.name))
+    for (const concern of concerns) {
+      const concernDir = join(policyDir, concern.name)
+      const files = (await readdir(concernDir, { withFileTypes: true }))
+        .filter(e => e.isFile() && e.name.endsWith('.mdc'))
+        .sort((a, b) => a.name.localeCompare(b.name))
+      for (const f of files) {
+        sections.push((await readFile(join(concernDir, f.name), 'utf8')).trim())
+      }
+    }
   }
 
-  return result
+  if (sections.length === 0) return text
+  return text.trimEnd() + '\n\n' + sections.join('\n\n') + '\n'
 }

package/scripts/lib/mirror-parity.mjs

@@ -9,7 +9,7 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 
-import { inlineMarkdownIncludes, inlineTemplateLinks } from './inline-template-links.mjs'
+import { appendDiscoveredMdcFiles, inlineTemplateLinks } from './inline-template-links.mjs'
 
 const MIRROR_PREFIX = 'n-'
 const MDC_EXT = '.mdc'
@@ -44,7 +44,7 @@ export function listManagedMirrors(repoRoot) {
 export async function expectedMirrorContent(canonicalPath) {
   const dir = dirname(canonicalPath)
   const withTemplates = await inlineTemplateLinks(readFileSync(canonicalPath, 'utf8'), dir)
-  return inlineMarkdownIncludes(withTemplates, dir)
+  return appendDiscoveredMdcFiles(withTemplates, dir)
 }
 
 /**

package/scripts/sync-claude-config.mjs

@@ -30,11 +30,13 @@ import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
-/** Маркер PostToolUse fix-hook'а (`npx --no \@nitra/cursor post-tool-use-check`). */
-export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor post-tool-use-check'
-/** Маркер doc-files staleness-hook'ів (PostToolUse `--hook` і Stop-гейт `--git`). */
+/** Маркер hook-ів пакета (`hook --post-tool-use`, `hook --stop`). */
+export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor hook'
+/** @deprecated — замінено на `hook --post-tool-use`; маркер лишається для cleanup наявних конфігів при ресинку. */
+export const LEGACY_POST_TOOL_USE_HOOK_COMMAND_MARKER = '@nitra/cursor post-tool-use-check'
+/** @deprecated — doc-files hook перенесено до `hook --post-tool-use`; маркер лишається для cleanup наявних конфігів при ресинку. */
 export const DOC_FILES_HOOK_COMMAND_MARKER = '@nitra/cursor lint-doc-files'
-/** Legacy-маркер старих doc-files hook'ів (`doc-files check`) — cleanup при ресинку наявних інсталяцій. */
+/** @deprecated — ще старіший legacy-маркер doc-files hook'ів (`doc-files check`) — cleanup при ресинку. */
 export const LEGACY_DOC_FILES_HOOK_COMMAND_MARKER = '@nitra/cursor doc-files check'
 /** Legacy-маркер старого Stop-hook'а — лишаємо для cleanup-у при оновленні існуючих інсталяцій. */
 export const LEGACY_STOP_HOOK_COMMAND_MARKER = '@nitra/cursor stop-hook'
@@ -52,6 +54,7 @@ export const CURSOR_ADR_NORMALIZE_HOOK_COMMAND_MARKER = '.claude/hooks/normalize
  */
 export const MANAGED_HOOK_COMMAND_MARKERS = Object.freeze([
   MANAGED_HOOK_COMMAND_MARKER,
+  LEGACY_POST_TOOL_USE_HOOK_COMMAND_MARKER,
   DOC_FILES_HOOK_COMMAND_MARKER,
   LEGACY_DOC_FILES_HOOK_COMMAND_MARKER,
   LEGACY_STOP_HOOK_COMMAND_MARKER,

package/scripts/utils/docs/resolve-js-root.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Визначає корінь JS-коду в проєкті, відповідно до логіки для workspace-projects (перший workspace з підтримкою glob-патернів `cf/*`) або single-package (корінь cwd). Ця утиліта є спільною для coverage-провайдера JS та test-концерну `stryker_config` (DRY). Публічні функції дозволяють отримати один або повний список шляхів до всіх JS-коренів, при цьому свідомо виключаються каталоги `.git` та `node_modules`. Код спирається на конфігураційні файли `package.json` та `.n-cursor.json`.
 
 ## Поведінка

package/skills/doc-files/SKILL.md

@@ -31,8 +31,8 @@ docgen:
 
 ## Оркестрацію веде JS, не модель; конвеєр — local-only
 
-Уся важка робота — черга, батчинг, виклики LLM і штамп CRC — живе в JS-команді
-`fix-doc-files`. **Ти не диспатчиш субагентів і не тримаєш сотні файлів у контексті**
+Уся важка робота — черга, батчинг, виклики LLM і штамп CRC — живе у JS-оркестрації
+`lint doc-files`. **Ти не диспатчиш субагентів і не тримаєш сотні файлів у контексті**
 — тому навіть масовий перший прогін усього репо не «заморює». Цей скіл **тонкий**: твоє завдання —
 запустити генерацію і прочитати підсумок.
 
@@ -51,34 +51,20 @@ docgen:
 ### Крок 1: Генерація застарілих/відсутніх док
 
 ```bash
-npx @nitra/cursor fix-doc-files
+npx @nitra/cursor lint doc-files
 ```
 
-Команда сама: перевіряє omlx (preflight: «сервер лежить» / «модель не влазить у пам'ять
-зайнятої машини» / «потрібен API-ключ» → одна зрозуміла зупинка замість лавини «✗») →
-сканує проєкт → фільтрує застарілі (`stale`) → генерує локальною моделлю → пише доку зі
-**свіжим CRC** (і degraded-маркером, якщо не дотягнула) → друкує прогрес і підсумок.
-
-- Для дуже великого прогону можна порціями: `--from N --limit M`.
-- Перегенерувати **всі** доки (не лише застарілі): `--overwrite`.
-- Перегенерувати лише degraded (свіжі за CRC, score < порогу): `--retry-degraded`.
+Команда запускає doc-files лінтер у fix-режимі (весь репо): перевіряє omlx
+(preflight: «сервер лежить» / «модель не влазить у пам'ять зайнятої машини» /
+«потрібен API-ключ» → одна зрозуміла зупинка замість лавини «✗») → фільтрує застарілі
+(`stale`) → генерує локальною моделлю → пише доку зі **свіжим CRC** (і degraded-маркером,
+якщо не дотягнула) → друкує прогрес і підсумок.
 
 ### Крок 2: Підтвердження
 
 Дочекайся підсумку `✓ OK: <N>  ⚠ degraded: <D>  ✗ Err: <E>`. Якщо є помилки — перелічи
 проблемні файли. Exit-код `1` означає, що хоча б один файл не згенерувався (або не пройшов
-preflight). Degraded — не помилка: дока існує, борг видно у `lint-doc-files --degraded`.
-
-### Крок 3 (за потреби): перевірка перед завершенням
-
-```bash
-npx @nitra/cursor lint-doc-files --git
-```
-
-Перевіряє змінені у задачі джерела (`git diff --name-only HEAD`) проти CRC їхніх док.
-Цю ж перевірку виконує **Stop-hook** як твердий гейт: завершити задачу зі застарілими
-доками не можна (виняток — масовий прогін понад поріг `N_CURSOR_DOC_FILES_GATE_MAX`, дефолт 50).
-Degraded-доки гейт **не** блокує (CRC свіжий); їх список — `lint-doc-files --degraded`.
+preflight). Degraded — не помилка: дока існує, CRC свіжий.
 
 ## Правила стилю документа (за adr/ci4)
 
@@ -98,4 +84,3 @@ Degraded-доки гейт **не** блокує (CRC свіжий); їх спи
   усі теки `docs/`, а також `*.test.*` / `*.spec.*` / `*.d.ts`. Кореневий repo `docs/` —
   system-wide only: file-level docs туди не пишуться. Список glob-ів — `docgen-ignore.mjs`.
 - Агрегуюча документація (module-summary, доменні доки) — окремий скіл `doc-aggregate`, за запитом.
-- Для наявних док без CRC одноразово: `npx @nitra/cursor fix-doc-files --stamp` (штампує frontmatter без LLM).

package/skills/llm-patch/SKILL.md

@@ -74,12 +74,12 @@ version: '1.0'
   inflight-міграції, breaking-change політика, зовнішні залежності.
 - **Change-file flow,** якщо завдання змінює файли у пакетному workspace (код,
   правила, скіли, конфіги, тести — не лише `docs/`): промпт має вимагати
-  `npx @nitra/cursor change --bump <major|minor|patch> --section <Added|Changed|Fixed|Removed> --message "<опис>" [--ws <шлях>]`
+  `npx @7n/n ch [--bump <major|minor|patch>] [--section <Added|Changed|Fixed|Removed>] [--message "<опис>"]`
   і `npx @nitra/cursor fix changelog`. **Ніколи** не інструктуй ручне редагування
   `CHANGELOG.md` чи bump `version` — це робить release flow / CI (деталь —
   `.cursor/rules/n-changelog.mdc`, не дублюй її текст). Якщо потрібна реліз-нота —
   це change-файл `<ws>/.changes/<timestamp>-<rand>.md` з `bump:` і `section:`,
-  який створює саме `change` CLI, а не редагування файлу вручну.
+  який створює `@7n/n ch`, а не редагування файлу вручну.
 - **Як перевірити** — конкретні команди й специфічні до завдання сигнали
   успіху.
 
@@ -197,7 +197,7 @@ version: '1.0'
 - **Без ручного changelog/version у промпті:** не формулюй у виводі інструкції
   на кшталт "додати запис у `CHANGELOG.md`", "bump `version` вручну" чи
   "оновити `package.json#version`". Зміни у workspace фіксуються винятково
-  через change-file flow (`npx @nitra/cursor change …` → `npx @nitra/cursor fix changelog`);
+  через change-file flow (`npx @7n/n ch` → `npx @nitra/cursor fix changelog`);
   `version`/`CHANGELOG.md` формує CI.
 - **Не вмикай у промпт:** секрети, `.env`, `node_modules`, бінарні файли,
   довгі логи, дампи `tree`, повні JSON конфігів, цитати існуючих
@@ -239,7 +239,7 @@ version: '1.0'
 - Підняти `engines.node` до `>=25`; якщо peer `eslint ^9` несумісний —
   підняти range.
 - Зафіксувати зміну change-файлом (НЕ редагувати `CHANGELOG.md` чи `version`
-  вручну): `npx @nitra/cursor change --bump minor --section Changed --message "engines.node >=25"`.
+  вручну): `npx @7n/n ch --bump minor --section Changed --message "engines.node >=25"`.
 
 # Обмеження