@nitra/cursor 1.8.151 → 1.8.152

package/AGENTS.template.md

@@ -18,6 +18,14 @@ The primary development rules are stored in the Cursor rules directory:
 {{name}}
 {{/skills}}
 
+## Commands
+
+Generated from the root `package.json` on each `npx @nitra/cursor` sync. Prefer `bun run <script>` for project scripts.
+
+{{#commands}}
+{{name}}
+{{/commands}}
+
 ## Instructions for all agents
 
 Before making changes, read the relevant rule files for the area you are working on.

package/README.md

@@ -63,7 +63,7 @@ CLI автоматично (команда завантаження правил
 1. Знайде або створить `.n-cursor.json` у поточній директорії (із полем `$schema` на JSON Schema пакету; якщо файл уже є без коректного `$schema`, поле буде додано або оновлено при зчитуванні конфігу)
 2. Створить директорію `.cursor/rules/`, якщо її ще немає
 3. Скопіює кожне з перелічених у конфігу правило з `mdc/` установленого пакету і збереже файли з префіксом `n-`
-4. Після оновлення файлів на диску згенерує в корені проєкту **`AGENTS.md`**: повний вміст береться з шаблону пакету `AGENTS.template.md`, а список правил у шаблоні формується з **усіх наявних файлів `*.mdc`** у `.cursor/rules/` (відсортовано за ім’ям)
+4. Після оновлення файлів на диску згенерує в корені проєкту **`AGENTS.md`**: повний вміст береться з шаблону пакету `AGENTS.template.md`, а список правил у шаблоні формується з **усіх наявних файлів `*.mdc`** у `.cursor/rules/` (відсортовано за ім’ям); секція команд — з **`package.json`** кореня (див. `{{#commands}}` у шаблоні).
 
 ## Приклад виводу
 
@@ -114,13 +114,18 @@ npm/
 
 Під час запуску CLI тіло між `{{#services}}` і `{{/services}}` повторюється для кожного `*.mdc` у `.cursor/rules/`; у `{{name}}` підставляється вже готовий markdown-рядок (наприклад `- .cursor/rules/n-text.mdc`).
 
-3. Після змін у шаблоні перевірте локально: у тестовому репозиторії з `.n-cursor.json` виконайте `npx`/`bunx` на зібраному пакеті або `node npm/bin/n-cursor.js` з кореня того репозиторію і переконайтеся, що **`AGENTS.md`** виглядає як очікується.
+3. Для секції **Skills** використовуйте блок **`{{#skills}}` … `{{/skills}}`** з тим самим `{{name}}`: рядки формуються з каталогів у `.cursor/skills/` (див. також `buildSkillBulletItems` у `bin/n-cursor.js`).
+
+4. Для секції **Commands** використовуйте **`{{#commands}}` … `{{/commands}}`**: список генерується з кореневого **`package.json`** (поле `scripts` — відомі ключі у фіксованому порядку, плюс додаткові `lint-*`) та завжди доповнюється рядками про **`npx @nitra/cursor`** і **`npx @nitra/cursor check`**. Логіка винесена в **`npm/scripts/build-agents-commands.mjs`**.
+
+5. Після змін у шаблоні перевірте локально: у тестовому репозиторії з `.n-cursor.json` виконайте `npx`/`bunx` на зібраному пакеті або `node npm/bin/n-cursor.js` з кореня того репозиторію і переконайтеся, що **`AGENTS.md`** виглядає як очікується.
 
 ### Логіка в коді CLI
 
 - Шлях до шаблону: поруч із `mdc/`, тобто `…/node_modules/@nitra/cursor/AGENTS.template.md` після встановлення пакету.
 - Оновлення **`AGENTS.md`** виконується **після** циклу завантаження правил, щоб список відображав актуальний вміст `.cursor/rules/` на диску.
 - Якщо каталогу `.cursor/rules/` немає або в ньому немає `*.mdc`, блок `{{#services}}` стає порожнім; решта шаблону все одно записується в **`AGENTS.md`**.
+- Секція **`commands`** залежить лише від **`package.json` у корені cwd**; якщо файлу немає або `scripts` відсутній, у блоці лишаються мінімальні рядки (`bun i`, виклики CLI).
 
 ## Мета проекту
 

package/bin/n-cursor.js

@@ -18,6 +18,7 @@
  *
  * Файл AGENTS.md у корені: щоразу повністю перезаписується змістом з AGENTS.template.md
  * пакету; список правил у шаблоні будується з файлів *.mdc у .cursor/rules поточного проєкту.
+ * Секція команд — з кореневого package.json (scripts) та фіксовані рядки про CLI синхрону/перевірок.
  *
  * Після завантаження: у .cursor/rules видаляються файли *.mdc з префіксом «n-» (керовані
  * пакетом), яких немає у списку rules у .n-cursor.json. Інші .mdc у цій директорії залишаються.
@@ -45,6 +46,7 @@ import { basename, dirname, join } from 'node:path'
 import { cwd } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
+import { buildAgentsCommandBulletItems } from '../scripts/build-agents-commands.mjs'
 import { detectAutoRulesAndSkills, mergeConfigWithAutoDetected, normalizeIdList } from '../scripts/auto-rules.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
 import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
@@ -424,19 +426,21 @@ function expandMustacheSection(template, section, items, prop) {
 }
 
 /**
- * Підставляє у вміст AGENTS.template.md список шляхів до файлів правил і skills
+ * Підставляє у вміст AGENTS.template.md список шляхів до файлів правил, skills і команд з package.json
  * @param {string} templateText вміст AGENTS.template.md
  * @param {string[]} mdcBasenames імена файлів (*.mdc) з .cursor/rules
  * @param {{ name: string }[]} skillItems рядки для секції Skills
+ * @param {{ name: string }[]} commandItems рядки для секції commands
  * @returns {string} готовий markdown для AGENTS.md
  */
-function renderAgentsTemplate(templateText, mdcBasenames, skillItems) {
+function renderAgentsTemplate(templateText, mdcBasenames, skillItems, commandItems) {
   let result = templateText
   const serviceItems = mdcBasenames.map(mdcName => ({
     name: `- ${RULES_DIR}/${mdcName}`
   }))
   result = expandMustacheSection(result, 'services', serviceItems, 'name')
   result = expandMustacheSection(result, 'skills', skillItems, 'name')
+  result = expandMustacheSection(result, 'commands', commandItems, 'name')
   return result
 }
 
@@ -650,7 +654,8 @@ async function syncAgentsMd(agentsTemplatePath = BUNDLED_AGENTS_TEMPLATE_PATH) {
   const templateText = await readFile(agentsTemplatePath, 'utf8')
   const mdcFiles = await listProjectRulesMdcFiles()
   const skillItems = await buildSkillBulletItems()
-  const body = renderAgentsTemplate(templateText, mdcFiles, skillItems)
+  const commandItems = await buildAgentsCommandBulletItems(cwd())
+  const body = renderAgentsTemplate(templateText, mdcFiles, skillItems, commandItems)
   const agentsPath = join(cwd(), AGENTS_FILE)
   const hadFile = existsSync(agentsPath)
   const out = body.endsWith('\n') ? body : `${body}\n`

package/package.json

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

package/scripts/build-agents-commands.mjs

@@ -0,0 +1,88 @@
+/**
+ * Формує markdown-рядки для секції «Команди» у AGENTS.md.
+ *
+ * Джерело істини — `package.json` у корені цільового репозиторію: з поля `scripts` беруться відомі ключі
+ * у стабільному порядку, додатково — усі `lint-*`, яких не було в основному списку.
+ *
+ * Наприкінці завжди додаються рядки про CLI `@nitra/cursor` (синхрон правил / programmatic check),
+ * на початку — рекомендована команда `bun i` за конвенціями monorepo.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+const PACKAGE_NAME = '@nitra/cursor'
+const AGENTS_MD = 'AGENTS.md'
+
+/** Порядок виводу скриптів із `package.json` (лише ті, що реально існують). */
+const SCRIPT_KEYS_ORDER = /** @type {const} */ ([
+  'test',
+  'lint',
+  'lint-js',
+  'lint-text',
+  'lint-ga',
+  'lint-k8s',
+  'lint-docker',
+  'start',
+  'dev',
+  'build'
+])
+
+/**
+ * Зчитує `scripts` з `package.json` у `projectRoot` або повертає порожній об'єкт.
+ * @param {string} projectRoot абсолютний шлях до кореня репозиторію
+ * @returns {Promise<Record<string, string>>} об'єкт скриптів
+ */
+async function readPackageScripts(projectRoot) {
+  const pkgPath = join(projectRoot, 'package.json')
+  if (!existsSync(pkgPath)) {
+    return {}
+  }
+  try {
+    const raw = await readFile(pkgPath, 'utf8')
+    const pkg = JSON.parse(raw)
+    if (pkg && typeof pkg === 'object' && pkg.scripts && typeof pkg.scripts === 'object') {
+      return /** @type {Record<string, string>} */ (pkg.scripts)
+    }
+  } catch {
+    // некоректний JSON або IO — секція команд лишиться з мінімумом (bun i + npx)
+  }
+  return {}
+}
+
+/**
+ * Повертає елементи для Mustache-секції `commands` у AGENTS.template.md.
+ * @param {string} projectRoot абсолютний шлях до кореня репозиторію (зазвичай `process.cwd()`)
+ * @returns {Promise<{ name: string }[]>} рядки з полем `name` для `expandMustacheSection`
+ */
+export async function buildAgentsCommandBulletItems(projectRoot) {
+  const scripts = await readPackageScripts(projectRoot)
+  const items = /** @type {{ name: string }[]} */ ([])
+
+  items.push({ name: `- **Залежності**: \`bun i\`` })
+
+  const added = new Set()
+
+  for (const key of SCRIPT_KEYS_ORDER) {
+    if (typeof scripts[key] === 'string' && scripts[key].length > 0) {
+      items.push({ name: `- **${key}**: \`bun run ${key}\`` })
+      added.add(key)
+    }
+  }
+
+  const lintExtraKeys = Object.keys(scripts)
+    .filter(k => k.startsWith('lint-') && !added.has(k) && typeof scripts[k] === 'string')
+    .toSorted((a, b) => a.localeCompare(b))
+
+  for (const key of lintExtraKeys) {
+    items.push({ name: `- **${key}**: \`bun run ${key}\`` })
+    added.add(key)
+  }
+
+  items.push({
+    name: `- **Оновити правила та ${AGENTS_MD}** (після змін у правилах/шаблоні CLI): \`npx ${PACKAGE_NAME}\``
+  })
+  items.push({ name: `- **Перевірки правил (programmatic)**: \`npx ${PACKAGE_NAME} check\`` })
+
+  return items
+}