@nitra/cursor 12.11.3 → 12.13.0

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

@@ -1,6 +1,7 @@
 import { existsSync } from 'node:fs'
-import { readFile, readdir } from 'node:fs/promises'
+import { readFile } from 'node:fs/promises'
 import { basename, extname, join } from 'node:path'
+import { globby } from 'globby'
 
 const MD_LINK_RE = /\[([^\]]{1,200})\]\((\.\/[^)]{1,500})\)/g
 const TEMPLATE_SEGMENT_RE = /\/templates?\//
@@ -80,27 +81,18 @@ export async function appendDiscoveredMdcFiles(text, ruleDir) {
 
   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 files = await globby('*.mdc', { cwd: jsDir, onlyFiles: true, gitignore: false })
+    for (const f of files.toSorted()) {
+      sections.push((await readFile(join(jsDir, f), 'utf8')).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())
-      }
+    // '*/*.mdc' → 'concern/file.mdc'; рядкове сортування дає concern-first, потім file
+    const files = await globby('*/*.mdc', { cwd: policyDir, onlyFiles: true, gitignore: false })
+    for (const rel of files.toSorted()) {
+      sections.push((await readFile(join(policyDir, rel), 'utf8')).trim())
     }
   }
 

package/scripts/lib/list-project-rules-mdc.mjs

@@ -3,9 +3,9 @@
  * Винесено зі `bin/n-cursor.js`, щоб ділити між CLI-dispatch і `run-conformance-check` (конформність-детект).
  */
 import { existsSync } from 'node:fs'
-import { readdir } from 'node:fs/promises'
 import { join } from 'node:path'
 import { cwd as processCwd } from 'node:process'
+import { globby } from 'globby'
 
 /** Каталог правил у проєкті-споживачі (відносно кореня). */
 export const CURSOR_RULES_DIR = '.cursor/rules'
@@ -17,6 +17,6 @@ export const CURSOR_RULES_DIR = '.cursor/rules'
 export async function listProjectRulesMdcFiles(cwd = processCwd()) {
   const dir = join(cwd, CURSOR_RULES_DIR)
   if (!existsSync(dir)) return []
-  const names = await readdir(dir)
-  return names.filter(n => n.endsWith('.mdc')).toSorted((a, b) => a.localeCompare(b))
+  const names = await globby('*.mdc', { cwd: dir, onlyFiles: true, gitignore: false })
+  return names.toSorted((a, b) => a.localeCompare(b))
 }

package/scripts/lib/run-rule.mjs

@@ -15,7 +15,6 @@
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import { findMissingMdcRefs } from './check-mdc-template-refs.mjs'
 import { createCheckReporter } from './check-reporter.mjs'
 import { resolveTargetFiles } from './resolve-target-files.mjs'
 import { runConftestBatch } from './run-conftest-batch.mjs'
@@ -180,15 +179,5 @@ export async function runRule(rule, bundledRulesDir, walkCache) {
     if (code !== 0) totalCode = 1
   }
 
-  const ruleDir = join(bundledRulesDir, rule.id)
-  const missing = await findMissingMdcRefs(ruleDir)
-  if (missing.length > 0) {
-    const reporter = createCheckReporter()
-    for (const rel of missing) {
-      reporter.fail(`main.mdc: відсутнє markdown-посилання на template-файл ${rel}`)
-    }
-    if (reporter.getExitCode() !== 0) totalCode = 1
-  }
-
   return totalCode
 }

package/scripts/update-blue-oak.mjs

@@ -0,0 +1,51 @@
+/**
+ * Оновлює вбудований snapshot Blue Oak Council license list.
+ *
+ * Fetching: https://blueoakcouncil.org/list.json
+ * Виводить: npm/data/blue-oak.json — SPDX-ідентифікатори рівнів Model+Gold+Silver+Bronze.
+ *
+ * Запуск (вручну, у @nitra/cursor):
+ *   bun npm/scripts/update-blue-oak.mjs
+ *
+ * Коли запускати:
+ *   - При апгрейді @nitra/cursor (n-taze або вручну) — Blue Oak список змінюється рідко,
+ *     але нові permissive ліцензії зʼявляються раз на кілька місяців;
+ *   - Якщо проєкт падає на license-check через ліцензію якої нема в списку,
+ *     а вона точно permissive — спочатку перевір, чи вона в Bronze+ на blueoakcouncil.org.
+ *
+ * Lead-рівень (найгірший, GPL-compatible) — навмисно виключений.
+ */
+import { writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const BLUE_OAK_URL = 'https://blueoakcouncil.org/list.json'
+const OUT_PATH = join(dirname(dirname(fileURLToPath(import.meta.url))), 'data', 'blue-oak.json')
+const KEEP_RATINGS = new Set(['Model', 'Gold', 'Silver', 'Bronze'])
+
+console.log(`⬇  Fetching ${BLUE_OAK_URL} …`)
+const res = await fetch(BLUE_OAK_URL)
+if (!res.ok) {
+  console.error(`✗ HTTP ${res.status}`)
+  process.exit(1)
+}
+
+/** @type {{ version: string, ratings: Array<{ name: string, licenses: Array<{ id: string, name: string, url: string }> }> }} */
+const data = await res.json()
+
+const bronzeAndAbove = []
+for (const rating of data.ratings) {
+  if (KEEP_RATINGS.has(rating.name)) {
+    bronzeAndAbove.push(...rating.licenses.map(l => l.id))
+  }
+}
+
+const out = {
+  version: data.version,
+  source: BLUE_OAK_URL,
+  bronzeAndAbove
+}
+
+writeFileSync(OUT_PATH, JSON.stringify(out, null, 2) + '\n', 'utf8')
+console.log(`✓ ${OUT_PATH}`)
+console.log(`  version=${out.version}  bronzeAndAbove=${bronzeAndAbove.length} licenses`)

package/scripts/utils/walkDir.mjs

@@ -1,84 +1,44 @@
-/**
- * Рекурсивний обхід каталогів для скриптів перевірки (Dockerfile, k8s YAML тощо).
- *
- * Обходить дерево від заданого кореня; для кожного звичайного файлу викликає переданий callback.
- * Каталоги node_modules, .git, dist, coverage, .turbo, .next не заходяться.
- * Додатково можна передати `ignorePaths` — повні шляхи каталогів (абсолютні posix), які слід
- * пропускати разом з усім вмістом (поле `ignore` у `.n-cursor.json`). Якщо readdir для каталогу
- * не вдається — тихо виходить без throw.
- */
-import { readdir } from 'node:fs/promises'
-import { isAbsolute, join, resolve, sep } from 'node:path'
+/** @see ./docs/walkDir.md */
+import { join, relative, resolve, sep } from 'node:path'
+import { globby } from 'globby'
 
-/**
- * Перетворює довільний шлях у абсолютний posix-формат без trailing-slash.
- * @param {string} p шлях
- * @returns {string} абсолютний posix-шлях
- */
-function toAbsPosix(p) {
-  const abs = isAbsolute(p) ? p : resolve(p)
-  let posix = abs.split(sep).join('/')
-  while (posix.endsWith('/')) posix = posix.slice(0, -1)
-  return posix
-}
+// .git ніколи не потрапляє в .gitignore — пропускаємо завжди.
+// node_modules — safety net: проєкт може не мати .gitignore або запускатись поза git-репо.
+const ALWAYS_IGNORE = ['.git/**', 'node_modules/**']
 
 /**
- * Чи каталог `dirAbsPosix` входить у список ignore (точний збіг або префікс з '/').
- * Часткові збіги басенейму не враховуються (postgres-master-test ≠ postgres-master).
- * @param {string} dirAbsPosix абсолютний posix-шлях каталогу
- * @param {string[]} ignorePosix вже нормалізовані ignore-шляхи
- * @returns {boolean} `true`, якщо шлях слід пропустити (точний збіг або префікс з `/`)
- */
-function isIgnoredDir(dirAbsPosix, ignorePosix) {
-  for (const ig of ignorePosix) {
-    if (dirAbsPosix === ig) return true
-    if (dirAbsPosix.startsWith(`${ig}/`)) return true
-  }
-  return false
-}
-
-/**
- * Рекурсивно обходить каталог, пропускає типові артефакти збірки/залежностей та `ignorePaths`.
- * @param {string} dir абсолютний шлях
- * @param {(filePath: string) => void} onFile виклик для кожного файлу
- * @param {string[]} [ignorePaths] шляхи каталогів (відносні від cwd або абсолютні), що повністю виключаються з обходу
- * @returns {Promise<void>} визначається по завершенню обходу
+ * Рекурсивно обходить каталог, поважаючи .gitignore (включно з вкладеними).
+ * @param {string} dir абсолютний або відносний шлях до кореня обходу
+ * @param {(filePath: string) => void} onFile колбек для кожного файлу (абсолютний шлях)
+ * @param {string[]} [ignorePaths] додаткові шляхи для пропуску (абсолютні або відносні від cwd)
+ * @returns {Promise<void>}
  */
 export async function walkDir(dir, onFile, ignorePaths = []) {
-  const ignorePosix = ignorePaths.map(p => toAbsPosix(p))
-  await walkDirInner(dir, onFile, ignorePosix)
-}
+  const absDir = resolve(dir)
 
-/**
- * Внутрішній рекурсор. ignorePosix вже нормалізовано — не нормалізуємо повторно на кожному рівні.
- * @param {string} dir абсолютний шлях каталогу для обходу
- * @param {(filePath: string) => void} onFile колбек, що викликається для кожного звичайного файлу
- * @param {string[]} ignorePosix вже нормалізовані абсолютні posix-шляхи ігнорованих каталогів
- * @returns {Promise<void>} визначається по завершенню рекурсії
- */
-async function walkDirInner(dir, onFile, ignorePosix) {
-  if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(dir), ignorePosix)) return
-  let entries
+  const extraIgnore = ignorePaths
+    .map(p => {
+      const abs = resolve(p.replace(/\/+$/, ''))
+      const rel = relative(absDir, abs).split(sep).join('/')
+      if (rel.startsWith('..') || rel === '') return null
+      return `${rel}/**`
+    })
+    .filter(Boolean)
+
+  let files
   try {
-    entries = await readdir(dir, { withFileTypes: true })
+    files = await globby('**/*', {
+      cwd: absDir,
+      gitignore: true,
+      dot: true,
+      onlyFiles: true,
+      ignore: [...ALWAYS_IGNORE, ...extraIgnore]
+    })
   } catch {
     return
   }
-  for (const e of entries) {
-    const p = join(dir, e.name)
-    if (e.isDirectory()) {
-      const skipDir =
-        e.name === 'node_modules' ||
-        e.name === '.git' ||
-        e.name === 'dist' ||
-        e.name === 'coverage' ||
-        e.name === '.turbo' ||
-        e.name === '.next'
-      if (skipDir) continue
-      if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(p), ignorePosix)) continue
-      await walkDirInner(p, onFile, ignorePosix)
-    } else if (e.isFile()) {
-      onFile(p)
-    }
+
+  for (const rel of files) {
+    onFile(join(absDir, rel))
   }
 }

package/skills/doc-aggregate/SKILL.md

@@ -44,6 +44,7 @@ node -e "const p=JSON.parse(require('fs').readFileSync('package.json','utf8'));
 ```
 
 Для кожного воркспейсу `<ws>`:
+
 - `relRoot` = `<ws>` (напр. `npm`, `demo`)
 - `docPath` = `<ws>/docs/ARCHITECTURE.md`
 - `members` — кодові файли (`.mjs .ts .vue .py`, крім тестів) у `<ws>/`

package/skills/publish-telegram/SKILL.md

@@ -11,12 +11,15 @@ version: '1.0'
 
 ## Формат Telegram
 
-Telegram підтримує моноширний шрифт через markdown-розмітку:
+Telegram підтримує Markdown-форматування безпосередньо в клієнті:
 
-- `` `inline code` `` — для inline
-- ` ```pre``` ` (потрійні backticks) — для блоку коду / моноширного тексту
+- `**bold**` — жирний (заголовки, мітки секцій)
+- `_italic_` — курсив (акценти)
+- `` `inline code` `` — inline-код, команди, назви файлів/пакетів
+- ` ```block``` ` (потрійні backticks) — блок коду, коли є реальний код
+- `~~strikethrough~~` — закреслення (опціонально)
 
-Весь пост оформлюй як **один блок** потрійних backticks, щоб текст був моноширним.
+Секції (Проблема:, Рішення: тощо) виділяй `**жирним**`. Технічні терміни (назви файлів, пакетів, команди) — в `` `inline code` ``.
 
 ## Workflow
 
@@ -28,23 +31,23 @@ Telegram підтримує моноширний шрифт через markdown-
 
 ## Шаблон посту
 
-```markdown
+```
 #тег
 
-📌 <Короткий заголовок>
+📌 **<Короткий заголовок>**
 
-Проблема:
+**Проблема:**
 <1-3 речення — що було не так / яке завдання>
 
-Рішення:
+**Рішення:**
 <2-5 речень — що зробили, який підхід>
 
-Деталі:
+**Деталі:**
 • <ключовий момент 1>
 • <ключовий момент 2>
 • <ключовий момент 3>
 
-Результат:
+**Результат:**
 <1-2 речення — що отримали, яка вигода>
 ```
 
@@ -64,32 +67,27 @@ Telegram підтримує моноширний шрифт через markdown-
 - Тег: рівно 1 хештег першим рядком поста (#devops, #frontend, #bugfix, #refactoring, #CI, #performance тощо)
 - Emoji: лише структурні (📌 для заголовка, • для списку), не перевантажувати
 - Цільова аудиторія: розробники та менеджери — тому пояснюй простою мовою, без надмірного жаргону
-- Весь текст повинен бути всередині потрійних backticks для моноширного відображення в Telegram
+- Назви файлів, пакетів, команди — у `` `inline code` ``
+- Блок коду (потрійні backticks) — лише якщо є реальний код/конфіг, не для всього тексту
 
 ## Приклад
 
-````
 ```
 #dev
 
-📌 Міграція з Prettier на oxfmt
+📌 **Міграція з Prettier на oxfmt**
 
-Проблема:
-Prettier повільно форматував великі файли і
-конфліктував з ESLint при роботі з Vue SFC.
+**Проблема:**
+Prettier повільно форматував великі файли і конфліктував з ESLint при роботі з Vue SFC.
 
-Рішення:
-Замінили Prettier на oxfmt — нативний
-форматер від OXC. Оновили VS Code settings,
-видалили prettier-конфіги, додали .oxfmtrc.json.
+**Рішення:**
+Замінили Prettier на `oxfmt` — нативний форматер від OXC. Оновили VS Code settings, видалили prettier-конфіги, додали `.oxfmtrc.json`.
 
-Деталі:
-• oxfmt працює в 10-50x швидше за Prettier
-• Єдиний конфіг .oxfmtrc.json у корені
-• CI перевіряє форматування через lint-js
+**Деталі:**
+• `oxfmt` працює в 10-50x швидше за Prettier
+• Єдиний конфіг `.oxfmtrc.json` у корені
+• CI перевіряє форматування через `lint-js`
 
-Результат:
-Форматування працює миттєво при збереженні,
-зникли конфлікти між форматером і лінтером.
+**Результат:**
+Форматування працює миттєво при збереженні, зникли конфлікти між форматером і лінтером.
 ```
-````

package/scripts/lib/check-mdc-template-refs.mjs

@@ -1,57 +0,0 @@
-/**
- * Returns list of template/ files that are NOT referenced in <id>.mdc as
- * markdown link targets. Paths returned are relative to ruleDir.
- */
-import { existsSync } from 'node:fs'
-import { readdir, readFile, stat } from 'node:fs/promises'
-import { join, relative } from 'node:path'
-
-/**
- * @param {string} ruleDir абсолютний шлях до каталогу правила
- * @returns {Promise<string[]>} абсолютні шляхи всіх файлів у template/
- */
-async function walkTemplateDirs(ruleDir) {
-  const out = []
-  for (const kind of ['fix', 'policy']) {
-    const kindDir = join(ruleDir, kind)
-    if (!existsSync(kindDir)) continue
-    for (const concern of await readdir(kindDir)) {
-      const tpl = join(kindDir, concern, 'template')
-      if (!existsSync(tpl)) continue
-      const tplStat = await stat(tpl)
-      if (!tplStat.isDirectory()) continue
-      out.push(...(await collectFiles(tpl)))
-    }
-  }
-  return out.map(p => relative(ruleDir, p))
-}
-
-/**
- * @param {string} dir каталог для обходу
- * @returns {Promise<string[]>} абсолютні шляхи знайдених файлів
- */
-async function collectFiles(dir) {
-  const out = []
-  for (const entry of await readdir(dir, { withFileTypes: true })) {
-    const full = join(dir, entry.name)
-    if (entry.isDirectory()) out.push(...(await collectFiles(full)))
-    else out.push(full)
-  }
-  return out
-}
-
-/**
- * @param {string} ruleDir абсолютний шлях до npm/rules/<id>/
- * @param {string} ruleId basename правила (напр. "security")
- * @returns {Promise<string[]>} відносні шляхи template-файлів без посилань у .mdc
- */
-export async function findMissingMdcRefs(ruleDir) {
-  const mdcPath = join(ruleDir, 'main.mdc')
-  if (!existsSync(mdcPath)) return []
-  const mdc = await readFile(mdcPath, 'utf8')
-  const allFiles = await walkTemplateDirs(ruleDir)
-  return allFiles.filter(rel => {
-    // Match markdown link to ./<rel> or (<rel>) anywhere in the .mdc
-    return !mdc.includes(`./${rel}`) && !mdc.includes(`(${rel})`)
-  })
-}

package/scripts/lib/docs/check-mdc-template-refs.md

@@ -1,22 +0,0 @@
----
-type: JS Module
-title: check-mdc-template-refs.mjs
-resource: npm/scripts/lib/check-mdc-template-refs.mjs
-docgen:
-  crc: c116210e
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-Визначає список файлів шаблонів, що знаходяться у каталогах `fix` та `policy`, які не є цільовими посиланнями у файлі `<id>.mdc` як markdown link targets. Це дозволяє ідентифікувати ресурси шаблонів, які не були згадані в контексті правила.
-
-## Поведінка
-
-1. Збирає абсолютні шляхи всіх файлів, що знаходяться у каталогах `template` всередині підкаталогів `fix` та `policy` у вказаному каталозі правила.
-2. Зчитує вміст файлу `main.mdc` у каталозі правила.
-3. Фільтрує зібрані шляхи, залишаючи лише ті, які не з'являються у вмісті `main.mdc` у вигляді посилання Markdown (`./<шлях>` або ``).
-4. Повертає відносні шляхи цих незгаданих шаблонних файлів відносно каталогу правила.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).