@nitra/cursor 1.6.4 → 1.6.5

package/README.md

@@ -14,6 +14,7 @@
 
 ```json
 {
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/n-cursor.json",
   "rules": ["js-format", "npm-module", "text"]
 }
 ```
@@ -30,6 +31,7 @@
 
 ```json
 {
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/n-cursor.json",
   "version": "2.5.0",
   "rules": ["js-format", "text"]
 }
@@ -39,11 +41,15 @@
 
 ```bash
 npx @nitra/cursor
+npx @nitra/cursor check
+npx @nitra/cursor check bun ga
 ```
 
-CLI автоматично:
+Команда `check` запускає programmatic перевірки з каталогу `scripts/` пакету. Якщо в корені репозиторію вже є `.n-cursor.json`, перед перевірками виконується зчитування конфігу — зокрема додається або виправляється поле `$schema`, якщо воно відсутнє або не збігається з очікуваним URL.
 
-1. Знайде або створить `.n-cursor.json` у поточній директорії
+CLI автоматично (команда завантаження правил без підкоманди `check`):
+
+1. Знайде або створить `.n-cursor.json` у поточній директорії (із полем `$schema` на JSON Schema пакету; якщо файл уже є без коректного `$schema`, поле буде додано або оновлено при зчитуванні конфігу)
 2. Створить директорію `.cursor/rules/`, якщо її ще немає
 3. Завантажить кожне з перелічених у конфігу правило з unpkg.com і збереже файли з префіксом `n-`
 4. Після оновлення файлів на диску згенерує в корені проєкту **`AGENTS.md`**: повний вміст береться з шаблону пакету `AGENTS.template.md`, а список правил у шаблоні формується з **усіх наявних файлів `*.mdc`** у `.cursor/rules/` (відсортовано за ім’ям)

package/bin/n-cursor.js

@@ -5,12 +5,14 @@
  *
  * Використання:
  *   `npx \@nitra/cursor`             — завантажити cursor-правила
- *   `npx \@nitra/cursor check`       — перевірити правила, перелічені в AGENTS.md (якщо є check-*.mjs)
+ *   `npx \@nitra/cursor check`       — перевірити правила, перелічені в AGENTS.md (якщо є check-*.mjs);
+ *                                     якщо в корені вже є `.n-cursor.json`, спочатку зчитується конфіг і за потреби дописується `$schema`
  *   `npx \@nitra/cursor check bun`   — перевірити лише вказані правила (ігнорує AGENTS.md)
  *
  * Якщо у корені репозиторію немає .n-cursor.json, спочатку перейменовується за наявності nitra-cursor.json;
  * у `.cursor/rules` файли `nitra-*.mdc` перейменовуються на `n-*.mdc`; інакше конфіг створюється автоматично
- * з усіма правилами з каталогу mdc пакету (їх можна відредагувати після створення).
+ * з усіма правилами з каталогу mdc пакету (їх можна відредагувати після створення). У файлі завжди має бути
+ * поле `$schema` з посиланням на JSON Schema пакету; при зчитуванні конфігу воно додається або виправляється на диску, якщо відсутнє або некоректне.
  *
  * Файл AGENTS.md у корені: щоразу повністю перезаписується змістом з AGENTS.template.md
  * пакету; список правил у шаблоні будується з файлів *.mdc у .cursor/rules поточного проєкту.
@@ -33,6 +35,8 @@ import { fileURLToPath } from 'node:url'
 const PACKAGE_NAME = '@nitra/cursor'
 const UNPKG_BASE = 'https://unpkg.com'
 const CONFIG_FILE = '.n-cursor.json'
+/** URL JSON Schema для `.n-cursor.json` (поле `$schema` у файлі конфігурації) */
+const CONFIG_SCHEMA_URL = `${UNPKG_BASE}/${PACKAGE_NAME}/schemas/n-cursor.json`
 const AGENTS_FILE = 'AGENTS.md'
 const AGENTS_TEMPLATE_FILE = 'AGENTS.template.md'
 const RULES_DIR = '.cursor/rules'
@@ -144,7 +148,7 @@ async function migrateLegacyConfigIfNeeded() {
 
 /**
  * Зчитує конфіг .n-cursor.json з поточної директорії
- * @returns {Promise<{rules: string[], skills: string[], version?: string}>} rules, skills (id без префікса n-), опційно version; при відсутності файлу створює дефолтний конфіг
+ * @returns {Promise<{ $schema: string, rules: string[], skills: string[], version?: string } & Record<string, unknown>>} rules, skills (id без префікса n-), опційно version; при відсутності файлу створює дефолтний конфіг
  */
 async function readConfig() {
   await migrateLegacyConfigIfNeeded()
@@ -152,7 +156,7 @@ async function readConfig() {
   if (!existsSync(configPath)) {
     const rules = await discoverBundledRuleNames()
     const skills = await discoverBundledSkillNames()
-    const defaultConfig = { rules, skills }
+    const defaultConfig = { $schema: CONFIG_SCHEMA_URL, rules, skills }
     await writeFile(configPath, `${JSON.stringify(defaultConfig, null, 2)}\n`, 'utf8')
     console.log(
       `📝 Створено ${CONFIG_FILE} з усіма правилами (${rules.length}) і skills (${skills.length}) з пакету. За потреби відредагуйте списки.\n`
@@ -175,6 +179,15 @@ async function readConfig() {
     }
     config.skills = await discoverBundledSkillNames()
   }
+
+  if (config.$schema !== CONFIG_SCHEMA_URL) {
+    const { $schema: _omit, ...rest } = config
+    const normalized = { $schema: CONFIG_SCHEMA_URL, ...rest }
+    await writeFile(configPath, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8')
+    console.log(`📝 Оновлено поле $schema у ${CONFIG_FILE}\n`)
+    return normalized
+  }
+
   return config
 }
 
@@ -546,6 +559,17 @@ async function runChecks(requestedRules) {
     throw new Error('No check scripts found')
   }
 
+  const root = cwd()
+  const legacyConfigPath = join(root, 'nitra-cursor.json')
+  if (existsSync(join(root, CONFIG_FILE)) || existsSync(legacyConfigPath)) {
+    try {
+      await readConfig()
+    } catch (error) {
+      console.error(`❌ ${error.message}`)
+      throw error
+    }
+  }
+
   let rulesToCheck
   if (requestedRules.length > 0) {
     rulesToCheck = requestedRules

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.6.4",
+  "version": "1.6.5",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/schemas/n-cursor.json

@@ -6,6 +6,10 @@
   "type": "object",
   "additionalProperties": true,
   "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Посилання на JSON Schema для автодоповнення та валідації в IDE; має збігатися з $id цієї схеми (рекомендовано завжди вказувати)."
+    },
     "rules": {
       "type": "array",
       "description": "Ідентифікатори правил без префікса n- (відповідають файлам n-<id>.mdc).",