@nitra/cursor 12.9.0 → 12.10.0

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"`.
 
 # Обмеження