@nitra/cursor 12.13.0 → 12.15.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.15.0] - 2026-06-26
+
+### Changed
+
+- Видалено скіл start-check та пов'язані файли
+
+## [12.14.0] - 2026-06-26
+
+### Changed
+
+- Заміна picomatch на ignore для обробки glob-ів у docgen та resolve-target-files
+
 ## [12.13.0] - 2026-06-26
 
 ### Changed

package/bin/docs/n-cursor.md

@@ -5,7 +5,7 @@
 Файл `npm/bin/n-cursor.js` — це виконуваний скрипт (shebang `#!/usr/bin/env node`), що слугує єдиною точкою входу CLI пакета `@nitra/cursor`. Скрипт виконує дві ролі:
 
 1. **Синхронізатор пакетних артефактів у проєкті-споживачі** — без аргументів копіює `.mdc`-правила, скіли, slash-команди, генерує `AGENTS.md`, `CLAUDE.md`, синхронізує `.claude/settings.json`, `.cursor/hooks.json`, composite GitHub Action `setup-bun-deps`, `.pi/skills`, а також `.gitignore` для `.worktrees/`.
-2. **Маршрутизатор підкоманд** — диспатчить `fix`, `check`, `rename-yaml-extensions`, `post-tool-use-fix`, `lint`, `lint-ci`, `lint-doc-files`, `fix-doc-files`, `coverage`, `coverage-fix`, `analyze-escalation`, `taze`, `start-check`, `change`, `release`, `skill`, `worktree`, `trace`, `doc-aggregate`, `adr-normalize-local` у відповідні внутрішні модулі пакета.
+2. **Маршрутизатор підкоманд** — диспатчить `rename-yaml-extensions`, `hook`, `lint`, `analyze-escalation`, `taze`, `release`, `skill`, `trace`, `adr-normalize-local`, `doc-aggregate` у відповідні внутрішні модулі пакета.
 
 Скрипт — ES-модуль (`import` синтаксис). Виконує реальні файлові операції в `cwd()` і у каталогах пакету (`BUNDLED_PACKAGE_ROOT`). Усі шляхи відносно поточної робочої директорії проєкту-споживача.
 
@@ -20,7 +20,6 @@
 - `npx @nitra/cursor lint` — data-driven оркестратор lint+конформності: `--full` (весь репо, включно з `full`-правилами), `--read-only` (CI, нуль мутацій); без прапорів — per-file дельта vs origin.
 - `npx @nitra/cursor lint-ci` — те саме у CI-режимі.
 - `npx @nitra/cursor coverage [--fix] [--changed]` — оркестратор покриття та мутаційного тестування.
-- `npx @nitra/cursor change` — створення change-файлу.
 - `npx @nitra/cursor release` — реліз-команда.
 - `npx @nitra/cursor skill list|taze|cursor|claude …` — керування скілами (промпт на stdout, виклик Cursor/Claude CLI).
 - `npx @nitra/cursor worktree …` — керування git-worktree.
@@ -462,7 +461,6 @@ try {
 - `'lint'` → `runLint({ full, readOnly, rules })` (прапори `--full`, `--read-only`; позиційні аргументи — фільтр правил конформності).
 - `'lint-ci'` → `runLint({ ci: true })`.
 - `'coverage'` → динамічний import `../rules/test/coverage/coverage.mjs`, виклик `runCoverageCli({ fix: args.includes('--fix'), changed: args.includes('--changed') })`.
-- `'change'` → динамічний import `../rules/release/change.mjs` → `runChangeCli(args)`.
 - `'release'` → динамічний import `../rules/release/release.mjs` → `runReleaseCli(args)`.
 - `'skill'` → `runSkillsCli(args)` (синхронний).
 - `'worktree'` → `runWorktreeCli(args)`.
@@ -519,7 +517,6 @@ try {
 ### Динамічні (lazy) залежності
 
 - `../rules/test/coverage/coverage.mjs` — `runCoverageCli`.
-- `../rules/release/change.mjs` — `runChangeCli`.
 - `../rules/release/release.mjs` — `runReleaseCli`.
 - `../scripts/dispatcher/trace.mjs` — `runTraceCli`.
 - `../skills/docgen/js/docgen-scan.mjs` — `runDocgenScanCli`, `runDocgenModulesCli`.

package/bin/n-cursor.js

@@ -1546,15 +1546,6 @@ try {
 
       break
     }
-    case 'start-check': {
-      // n-cursor start-check scan|run — детермінована частина smoke-перевірки для
-      // скілу n-start-check: scan виявляє воркспейси зі start і їх тип, run запускає
-      // один із grace-таймаутом і класифікує OK/FAIL. Агент лишається з діагностикою.
-      const { runStartCheckCli } = await import('../skills/start-check/js/check.mjs')
-      process.exitCode = await runStartCheckCli(args)
-
-      break
-    }
     case 'release': {
       const { runReleaseCli } = await import('../rules/release/release.mjs')
       process.exitCode = await runReleaseCli(args)
@@ -1584,7 +1575,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, hook, adr-normalize-local, lint (включно зі scope: lint ga|rego|k8s|docker|text), analyze-escalation, taze, start-check, release, skill, doc-aggregate`
+        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, hook, adr-normalize-local, lint (включно зі scope: lint ga|rego|k8s|docker|text), analyze-escalation, taze, release, skill, doc-aggregate`
       )
       process.exitCode = 1
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.13.0",
+  "version": "12.15.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -55,6 +55,7 @@
   "dependencies": {
     "@7n/mt": "^0.5.1",
     "globby": "^16.0.0",
+    "ignore": "^7.0.5",
     "oxc-parser": "^0.137.0",
     "picomatch": "^4.0.4",
     "smol-toml": "^1.7.0",

package/rules/doc-files/js/docgen-ignore.mjs

@@ -1,5 +1,5 @@
 /** @see ./docs/docgen-ignore.md */
-import picomatch from 'picomatch'
+import ignore from 'ignore'
 
 /** Базовий список glob-ів для `docgen` ignore. */
 export const DOCGEN_IGNORE_GLOBS = Object.freeze([
@@ -22,7 +22,7 @@ export const DOCGEN_IGNORE_GLOBS = Object.freeze([
   'npm/rules/k8s/js/manifests.mjs'
 ])
 
-const IGNORE_MATCHERS = DOCGEN_IGNORE_GLOBS.map(glob => picomatch(glob, { dot: true }))
+const ig = ignore().add(DOCGEN_IGNORE_GLOBS)
 
 /**
  * Нормалізує відносний шлях до posix-формату для glob-matching.
@@ -36,7 +36,7 @@ function toPosixRelPath(relPath) {
 /**
  * Перевіряє, чи шлях має бути пропущений `docgen`.
  * Для `kind = 'dir'` це працює і на піддерево каталогу, тож glob на кшталт
- * `**\\/demo/**` спрацьовує на `demo/x` під час рекурсивного обходу.
+ * `**\/demo/**` спрацьовує на `demo/x` під час рекурсивного обходу.
  * @param {string} relPath відносний шлях від кореня проєкту
  * @param {'path'|'dir'} [kind] тип перевірки (за замовчуванням `'path'`)
  * @returns {boolean} `true`, якщо шлях ігнорується
@@ -47,7 +47,8 @@ export function isDocgenIgnored(relPath, kind = 'path') {
   }
   const posixRelPath = toPosixRelPath(relPath)
   if (kind === 'dir') {
-    return IGNORE_MATCHERS.some(match => match(posixRelPath) || match(`${posixRelPath}/__docgen__`))
+    // `**/demo/**` не матчить `demo` напряму — перевіряємо фіктивний файл всередині
+    return ig.ignores(posixRelPath) || ig.ignores(`${posixRelPath}/__docgen__`)
   }
-  return IGNORE_MATCHERS.some(match => match(posixRelPath))
+  return ig.ignores(posixRelPath)
 }

package/rules/doc-files/js/docs/docgen-ignore.md

@@ -3,7 +3,7 @@ type: JS Module
 title: docgen-ignore.mjs
 resource: npm/rules/doc-files/js/docgen-ignore.mjs
 docgen:
-  crc: c17cd785
+  crc: 00687334
   score: 100
 ---
 

package/scripts/lib/docs/resolve-target-files.md

@@ -3,7 +3,7 @@ type: JS Module
 title: resolve-target-files.mjs
 resource: npm/scripts/lib/resolve-target-files.mjs
 docgen:
-  crc: a3b361d9
+  crc: 4d3546e6
 ---
 
 Цей файл відповідає за перевірку наявності файлів, що відповідають певним правилам, вказаним у файлах `policy/<name>/target.json`. Він створює список файлів для подальшого використання, використовуючи або конкретні відносні шляхи, або обхід каталогу з використанням шаблонів та ігнорування файлів. Це забезпечує узгодженість та контроль над файлами, які потрібно обробити, відповідно до заданих політик.
@@ -16,7 +16,7 @@ docgen:
 4.  **Завантаження ігнорування:** Завантажує список абсолютних шляхів, які слід ігнорувати, з конфігурації `.n-cursor.json:ignore`.
 5.  **Кешування обходу:** Використовує кеш обходу дерева (Map) для запобігання повторному обходу одного й того ж набору ігнорування. Якщо обхід вже виконано для заданого набору ігнорування, повертає результат з кешу.
 6.  **Обхід дерева:** Якщо обхід не кешований або кеш порожній, виконує обхід дерева файлів від заданого кореня, використовуючи `walkDir`. Під час обходу генерує відносні шляхи файлів від кореня.
-7.  **Фільтрація за масками:** Для кожного відносного шляху файлу застосовує маски `walkGlob` за допомогою `picomatch`. Фільтрує файли, які відповідають маскам, та виключає ті, що відповідають негативним маскам.
+7.  **Фільтрація за масками:** Для кожного відносного шляху файлу застосовує маски `walkGlob` за допомогою `ignore`. Фільтрує файли, які відповідають маскам, та виключає ті, що відповідають негативним маскам.
 8.  **Збіг з ігноруванням:** Перевіряє, чи файл не входить до списку ігнорування.
 9.  **Збіг шляху:** Перетворює відносні шляхи файлів у абсолютні шляхи, додавши корень.
 10. **Повернення результатів:** Повертає масив абсолют
@@ -29,7 +29,7 @@ resolveTargetFiles — Знаходить файли, що вказані в `ta
 
 - **Контракт на поліси:** Зчитуються лише файли з репозиторію.
 - **`single`:** Якщо `existsSync`, повертається список файлів, що відповідають `single`. Інакше, повертається порожній список.
-- **`walkGlob`:** Використовується picomatch для обробки glob-шаблонів відносно шляхів, отриманих з обходу `walkDir` від `root`.
+- **`walkGlob`:** Використовується ignore для обробки glob-шаблонів відносно шляхів, отриманих з обходу `walkDir` від `root`.
 - **Ігнорування:** Підтримується ігнорування файлів за допомогою `.n-cursor.json:ignore` та кешування шляхів ігнорування у `walkCache`.
 - **Кешування:** Результати обходу кешуються для повторного використання при однаковому наборі ігнорувань.
 - **Path-traversal:** При розв'язанні шляхів у формі `single` виникає помилка.

package/scripts/lib/resolve-target-files.mjs

@@ -4,7 +4,7 @@
  * Дві форми у `target.json:files`:
  *   - `{ "single": "<rel>" }` — конкретний відносний шлях. Якщо `existsSync(root/single)` → `[single]`;
  *     інакше `[]` (caller сам вирішує fail vs silent skip за `required`).
- *   - `{ "walkGlob": <glob | glob[]> }` — picomatch проти posix-відносних шляхів, отриманих обходом
+ *   - `{ "walkGlob": <glob | glob[]> }` — `ignore` проти posix-відносних шляхів, отриманих обходом
  *     `walkDir` від `root` із загальними skip-ами та `.n-cursor.json:ignore`. Обхід кешований у
  *     `walkCache` (Map ключ — підпис ignorePaths) — повторні таргети з тим самим набором ignore
  *     перевикористовують список без нового readdir.
@@ -15,7 +15,7 @@
 import { existsSync } from 'node:fs'
 import { isAbsolute, join, normalize, relative, sep } from 'node:path'
 
-import picomatch from 'picomatch'
+import ignore from 'ignore'
 
 import { loadCursorIgnorePaths } from './load-cursor-config.mjs'
 import { walkDir } from '../utils/walkDir.mjs'
@@ -96,14 +96,8 @@ export async function resolveTargetFiles(filesSpec, root, walkCache) {
     const ignorePaths = await loadCursorIgnorePaths(root)
     const all = await getAllFilesCached(root, ignorePaths, walkCache)
     const globs = Array.isArray(filesSpec.walkGlob) ? filesSpec.walkGlob : [filesSpec.walkGlob]
-    // picomatch у масиві трактує `!neg` як ОКРЕМИЙ позитивний матчер «не-neg» (some-OR логіка),
-    // тож наївне `picomatch(['pos','!neg'])` повертає true майже на всьому. Розділяємо вручну:
-    // позитиви join-имо через picomatch(...), негативні фільтруємо окремим isExcluded.
-    const positives = globs.filter(g => !g.startsWith('!'))
-    const negatives = globs.filter(g => g.startsWith('!')).map(g => g.slice(1))
-    const isMatch = positives.length > 0 ? picomatch(positives, { dot: false }) : () => false
-    const isExcluded = negatives.length > 0 ? picomatch(negatives, { dot: false }) : () => false
-    return all.filter(rel => isMatch(rel) && !isExcluded(rel)).map(rel => join(root, rel))
+    const ig = ignore().add(globs)
+    return all.filter(rel => ig.ignores(rel)).map(rel => join(root, rel))
   }
   throw new Error(`target.json: files має містити single або walkGlob (отримано: ${JSON.stringify(filesSpec)})`)
 }

package/scripts/lib/root-notice.mjs

@@ -5,8 +5,8 @@
  *
  * Worktree-скіли (`worktree: true`) свій root-assert уже мають у worktree-блоці
  * (`worktree-notice.mjs`): корінь worktree = його toplevel. Цей модуль — для
- * не-worktree-кейсу (напр. `n-start-check`, що прогоняє `start` усіх воркспейсів
- * у місці й має стартувати з кореня монорепо).
+ * не-worktree-кейсу (напр. `n-taze`, що мутує `package.json` безпосередньо
+ * й має стартувати з кореня монорепо).
  *
  * Блок — інструкція агенту, що читає `SKILL.md`; вставляється між стабільними
  * маркерами, ре-синк ідемпотентний: наявний блок замінюється, при `false` —

package/scripts/lib/skill-meta.mjs

@@ -7,7 +7,7 @@
  *  - `requireRoot` — boolean, опційне: чи скіл вимагає запуску з кореня репо.
  *    Worktree-скіли (`worktree:true`) вимагають кореня неявно (корінь worktree =
  *    його toplevel), тож для них поле зайве. Явний `requireRoot:true` — для
- *    in-place скілів, що мутують CWD без worktree-ізоляції (напр. `n-start-check`).
+ *    in-place скілів, що мутують CWD без worktree-ізоляції (напр. `n-taze`).
  *
  * Цим хелпером користуються `auto-skills.mjs` (автоактивація), `n-cursor.js`
  * (sync + вшивання worktree/root-блоку) і check-концерн `npm-module/js/skill_meta.mjs`,

package/skills/start-check/SKILL.md

@@ -1,74 +0,0 @@
----
-name: n-start-check
-description: >-
-  Smoke-перевірка bun-монорепо: зайти в кожен воркспейс зі `start`-скриптом, прогнати
-  `start` і зафіксувати, чи проєкт взагалі запускається без негайного краху
-version: '1.0'
----
-
-# n-start-check — чи запускається кожен воркспейс
-
-## Мета
-
-Прогнати `start`-скрипт у кожному воркспейсі bun-монорепо й зафіксувати, чи проєкт **взагалі стартує**. Це smoke-перевірка: ціль — спіймати негайний крах (синтаксична помилка, відсутній модуль, падіння на старті), а не протестувати поведінку.
-
-## Передумови
-
-- Bun-монорепо: кореневий `package.json` має поле `workspaces`.
-- Залежності встановлені (`bun i`) — інакше `start` упаде на відсутньому модулі, а не на реальній проблемі.
-- Запуск з кореня репозиторію (де лежить кореневий `package.json` / `bun.lock`).
-
-## Workflow
-
-### 1. Зібрати список воркспейсів
-
-> **Не парси `package.json`/glob вручну.** Розгортання воркспейсів і класифікацію `start` несе CLI.
-
-```bash
-n-cursor start-check scan
-```
-
-Друкує JSON `[{ workspace, name, hasStart, startCmd, type }]` для root + усіх воркспейсів. `type` — `server` (dev-сервер/демон) чи `cli` (разова дія). Воркспейси з `hasStart:false` — `SKIP (немає start)` у звіті; решту прогоняй послідовно (крок 2).
-
-### 2. Прогнати `start` кожного воркспейсу — по черзі
-
-> **Не запускай `perl alarm` і не інтерпретуй exit-коди вручну.** CLI запускає процес із grace-таймаутом (крос-платформно через `spawnSync`), класифікує OK/FAIL за типом і парсить лог.
-
-Для кожного воркспейсу з `hasStart:true` (**по одному, НЕ паралельно** — dev-сервери конфліктують за портами):
-
-```bash
-n-cursor start-check run <workspace>   # напр. demo  (--grace <ms>, дефолт 12000)
-```
-
-Друкує JSON:
-
-```
-{ workspace, type, exitCode, timedOut, status, ready, firstError, logTail, sideEffects }
-```
-
-- `status: "OK"` — server дожив до кінця grace (`timedOut`) або встиг віддати рядок готовності; cli вийшов із кодом `0`.
-- `status: "FAIL"` — крах/ненульовий код до grace. `firstError` + `logTail` — для діагностики.
-- `sideEffects: { newFiles, changedTracked }` — read-only git-diff проти стану до запуску (для кроку 3).
-
-Розрізняй **помилку коду** (синтаксис, відсутній імпорт, падіння на ініціалізації) і **середовищний збій** (немає `.env`, недоступна БД/порт зайнятий) — останній не означає, що проєкт зламаний.
-
-### 3. Відкотити побічні ефекти прогону
-
-CLI **не** мутує дерево сам (відкат — деструктивний, лишається явним). Якщо `run` повернув непорожній `sideEffects`, відкоти **лише те, що зʼявилося через прогін**, перш ніж запускати наступний воркспейс:
-
-- `sideEffects.newFiles` — нові невідстежувані файли/директорії → видали (`rm`);
-- `sideEffects.changedTracked` — відстежувані файли, що стали зміненими → `git checkout -- <path>`.
-
-Усе, що було брудним **до** прогону, у `sideEffects` не потрапляє (CLI рахує лише різницю) — зміни користувача не чіпай. Gitignored-артефакти (кеші, `node_modules`) у git-diff не зʼявляються.
-
-### 4. Звіт
-
-Підсумкова таблиця: `воркспейс | статус | примітка`, з даних `scan` + `run`:
-
-- `OK` — `status:"OK"` (живий dev-сервер або вихід `0`).
-- `FAIL` — `status:"FAIL"`; додай `firstError` / `logTail`.
-- `SKIP` — `hasStart:false`.
-
-Якщо `run` повернув непорожній `sideEffects` — познач у примітці: проєкт стартує, але `start` не є чистим запуском (мутує репо). Якщо є хоч один `FAIL` — винеси його окремо з повною помилкою.
-
-Скіл лише **діагностує** запуск. Виправлення коду — поза скоупом; якщо причина FAIL очевидна, познач її у звіті, але не правь, поки про це не попросять окремо.

package/skills/start-check/js/check.mjs

@@ -1,198 +0,0 @@
-/** @see ./docs/check.md */
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
-
-/** Маркери довгого процесу (dev-сервер/демон) у команді `start`. */
-const SERVER_CMD_RE = /\b(vite|next|nuxt|nodemon|serve|astro|remix|webpack-dev-server|http-server)\b|\bdev\b|--watch/
-/** Рядки готовності dev-сервера в логу (`\b` лише де треба — щоб «already» не матчив «ready»). */
-const READY_RE = /\bready\b|\blistening\b|\bstarted\b|\bcompiled\b|server running|local:/i
-/** Сигнатури помилок у логу. */
-const ERROR_RE = /(error|exception|fatal|cannot find|module not found|unhandled|panic|traceback)/i
-/** Скільки останніх рядків логу повертати. */
-const LOG_TAIL_LINES = 15
-
-/**
- * Класифікує `start`-команду: довгий процес (сервер) чи разова дія (CLI).
- * @param {string} startCmd значення `scripts.start`
- * @returns {'server'|'cli'} тип процесу
- */
-export function classifyStartType(startCmd) {
-  return typeof startCmd === 'string' && SERVER_CMD_RE.test(startCmd) ? 'server' : 'cli'
-}
-
-/**
- * Зчитує `package.json` воркспейсу або повертає null.
- * @param {string} dir абсолютний шлях до каталогу воркспейсу
- * @returns {Promise<object|null>} розпарсений package.json або null
- */
-async function readPkg(dir) {
-  const path = join(dir, 'package.json')
-  if (!existsSync(path)) return null
-  try {
-    return JSON.parse(await readFile(path, 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-/**
- * Сканує монорепо: для кожного воркспейсу — чи є `start`, його команда і тип.
- * @param {string} cwd корінь репозиторію
- * @returns {Promise<Array<{workspace:string, name:string|null, hasStart:boolean, startCmd:string|null, type:('server'|'cli'|null)}>>} список воркспейсів
- */
-export async function scanStartWorkspaces(cwd) {
-  const roots = await getMonorepoPackageRootDirs(cwd)
-  const out = []
-  for (const ws of roots) {
-    const pkg = await readPkg(join(cwd, ws))
-    const startCmd = pkg?.scripts?.start ?? null
-    const hasStart = typeof startCmd === 'string' && startCmd.length > 0
-    out.push({
-      workspace: ws,
-      name: pkg?.name ?? null,
-      hasStart,
-      startCmd: hasStart ? startCmd : null,
-      type: hasStart ? classifyStartType(startCmd) : null
-    })
-  }
-  return out
-}
-
-/**
- * Парсить лог процесу: готовність (сервер), перша помилка, хвіст.
- * @param {string} log обʼєднаний stdout+stderr
- * @returns {{ready:boolean, firstError:string|null, logTail:string}} витяг
- */
-export function parseStartLog(log = '') {
-  const text = log
-  const lines = text.split('\n')
-  const firstError = lines.find(l => ERROR_RE.test(l))?.trim() ?? null
-  const logTail = lines
-    .filter(l => l.trim() !== '')
-    .slice(-LOG_TAIL_LINES)
-    .join('\n')
-  return { ready: READY_RE.test(text), firstError, logTail }
-}
-
-/**
- * Read-only знімок `git status --porcelain` як множина рядків.
- * @param {string} cwd корінь репозиторію
- * @returns {Set<string>} рядки porcelain (статус + шлях)
- */
-function gitPorcelain(cwd) {
-  const res = spawnSync('git', ['status', '--porcelain'], { cwd, encoding: 'utf8' })
-  if (res.status !== 0 || typeof res.stdout !== 'string') return new Set()
-  return new Set(res.stdout.split('\n').filter(l => l.trim() !== ''))
-}
-
-/**
- * Обчислює побічні ефекти прогону як різницю git-станів до/після.
- * @param {Set<string>} before знімок до
- * @param {Set<string>} after знімок після
- * @returns {{newFiles:string[], changedTracked:string[]}} нові untracked і ново-змінені tracked шляхи
- */
-function diffSideEffects(before, after) {
-  const newFiles = []
-  const changedTracked = []
-  for (const line of after) {
-    if (before.has(line)) continue
-    const path = line.slice(3)
-    if (line.startsWith('??')) newFiles.push(path)
-    else changedTracked.push(path)
-  }
-  return { newFiles, changedTracked }
-}
-
-/**
- * Запускає `start` одного воркспейсу з grace-таймаутом і класифікує результат.
- * @param {string} cwd корінь репозиторію
- * @param {string} workspace відносний шлях воркспейсу
- * @param {{graceMs?:number, type?:('server'|'cli'), spawnImpl?:typeof import('node:child_process').spawnSync}} [opts] grace-період, тип (інакше з package.json), інʼєкція spawn для тестів
- * @returns {Promise<{workspace:string, type:string, exitCode:number|null, timedOut:boolean, status:('OK'|'FAIL'), ready:boolean, firstError:string|null, logTail:string, sideEffects:{newFiles:string[], changedTracked:string[]}}>} результат прогону
- */
-export async function runWorkspaceStart(cwd, workspace, opts = {}) {
-  const { graceMs = 12_000, spawnImpl = spawnSync } = opts
-  const dir = join(cwd, workspace)
-  const pkg = await readPkg(dir)
-  const startCmd = pkg?.scripts?.start
-  if (typeof startCmd !== 'string' || startCmd.length === 0) {
-    throw new Error(`У воркспейсі ${workspace} немає scripts.start`)
-  }
-  const type = opts.type ?? classifyStartType(startCmd)
-
-  const before = gitPorcelain(cwd)
-  const res = spawnImpl('bun', ['run', 'start'], {
-    cwd: dir,
-    encoding: 'utf8',
-    timeout: graceMs,
-    killSignal: 'SIGTERM'
-  })
-  const timedOut = res.error?.code === 'ETIMEDOUT' || res.signal === 'SIGTERM'
-  const exitCode = typeof res.status === 'number' ? res.status : null
-  const { ready, firstError, logTail } = parseStartLog(`${res.stdout ?? ''}${res.stderr ?? ''}`)
-
-  // server: успіх = дожив до кінця grace (timedOut) або встиг віддати рядок готовності.
-  // cli: успіх = чистий вихід 0 у межах grace.
-  let status
-  if (type === 'server') status = timedOut || ready ? 'OK' : 'FAIL'
-  else status = exitCode === 0 ? 'OK' : 'FAIL'
-
-  return {
-    workspace,
-    type,
-    exitCode,
-    timedOut,
-    status,
-    ready,
-    firstError,
-    logTail,
-    sideEffects: diffSideEffects(before, gitPorcelain(cwd))
-  }
-}
-
-const USAGE = 'Usage: n-cursor start-check <scan | run <workspace> [--grace <ms>]>'
-
-/**
- * CLI: `scan` друкує список воркспейсів зі `start`; `run <ws>` запускає один і
- * друкує класифікований результат. Обидва — JSON у stdout.
- * @param {string[]} args аргументи після `start-check`
- * @param {string} [cwd] корінь репозиторію (інʼєкція для тестів)
- * @returns {Promise<number>} exit code
- */
-export async function runStartCheckCli(args, cwd = process.cwd()) {
-  const sub = args[0]
-
-  if (sub === 'scan') {
-    process.stdout.write(`${JSON.stringify(await scanStartWorkspaces(cwd))}\n`)
-    return 0
-  }
-
-  if (sub === 'run') {
-    const workspace = args[1] && !args[1].startsWith('--') ? args[1] : undefined
-    if (!workspace) {
-      console.error(USAGE)
-      return 1
-    }
-    const graceAt = args.indexOf('--grace')
-    const graceMs = graceAt === -1 ? undefined : Number(args[graceAt + 1])
-    if (graceAt !== -1 && (!Number.isFinite(graceMs) || graceMs <= 0)) {
-      console.error('✗ --grace очікує додатнє число (мс)')
-      return 1
-    }
-    try {
-      const result = await runWorkspaceStart(cwd, workspace, graceMs ? { graceMs } : {})
-      process.stdout.write(`${JSON.stringify(result)}\n`)
-      return 0
-    } catch (error) {
-      console.error(`✗ ${error.message}`)
-      return 1
-    }
-  }
-
-  console.error(USAGE)
-  return 1
-}

package/skills/start-check/js/docs/check.md

@@ -1,42 +0,0 @@
----
-type: JS Module
-title: check.mjs
-resource: npm/skills/start-check/js/check.mjs
-docgen:
-  crc: 1f8fb2f0
-  score: 95
----
-
-Файл надає інструменти для класифікації типів процесу, сканування конфігурації воркспейсів, парсингу логів та запуску скриптів.
-
-## Поведінка
-
-classifyStartType
-Визначає тип процесу як сервер чи CLI на основі команди.
-
-scanStartWorkspaces
-Сканує монорепо для отримання інформації про наявність та конфігурацію `start` скриптів у воркспейсах.
-
-parseStartLog
-Парсить лог процесу для визначення готовності, першої помилки та останніх рядків.
-
-runWorkspaceStart
-Запускає `start` для одного воркспейсу з тайм-аутом і класифікує результат.
-
-runStartCheckCli
-Обробляє аргументи командного рядка для сканування або запуску тестування воркспейсів.
-
-## Публічний API
-
-- classifyStartType — визначає, чи команда `start` належить до довготривалого процесу (серверу) чи одноразової дії (CLI).
-- scanStartWorkspaces — переглядає монорепо, витягуючи команду `start`, її команду та тип для кожного воркспейсу.
-- parseStartLog — витягує з логу стадії: готовність (сервер), перша помилка або фінальний результат.
-- runWorkspaceStart — ініціює запуск `start` для одного воркспейсу з обмеженням часу та класифікує отриманий результат.
-- runStartCheckCli — CLI-команда: команда `scan` генерує список воркспейсів зі `start`; команда `run <ws>` запускає один воркспейс і виводить класифікований результат у stdout.
-
-## Гарантії поведінки
-
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.

package/skills/start-check/js/docs/index.md

@@ -1,11 +0,0 @@
----
-type: Directory Index
-title: npm/skills/start-check/js
-resource: npm/skills/start-check/js/
----
-
-# npm/skills/start-check/js
-
-| Файл                  | Тип       |
-| --------------------- | --------- |
-| [check.mjs](check.md) | JS Module |

package/skills/start-check/main.json

@@ -1 +0,0 @@
-{ "auto": "завжди", "worktree": false, "requireRoot": true }