@nitra/cursor 4.1.1 → 5.0.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [5.0.0] - 2026-06-08
+
+### Changed
+
+- docs: додати план extraction Meta-task
+
+### Fixed
+
+- coverage `--changed` більше не залежить від runtime-стану `.flow.json`; scope визначається через git merge-base
+
+### Removed
+
+- видалено вбудовані flow і graph; Meta-task винесено в окремий пакет @7n/mt
+
+## [4.1.2] - 2026-06-08
+
+### Added
+
+- 1
+
 ## [4.1.1] - 2026-06-08
 
 ### 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-ga`, `lint-rego`, `lint-k8s`, `lint-docker`, `lint-text`, `coverage`, `change`, `release`, `skill`, `worktree`, `flow`, `trace`, `graph`, `docgen` у відповідні внутрішні модулі пакета.
+2. **Маршрутизатор підкоманд** — диспатчить `fix`, `check`, `rename-yaml-extensions`, `post-tool-use-fix`, `lint`, `lint-ci`, `lint-ga`, `lint-rego`, `lint-k8s`, `lint-docker`, `lint-text`, `coverage`, `change`, `release`, `skill`, `worktree`, `trace`, `docgen` у відповідні внутрішні модулі пакета.
 
 Скрипт — ES-модуль (`import` синтаксис). Виконує реальні файлові операції в `cwd()` і у каталогах пакету (`BUNDLED_PACKAGE_ROOT`). Усі шляхи відносно поточної робочої директорії проєкту-споживача.
 
@@ -29,9 +29,7 @@
 - `npx @nitra/cursor release` — реліз-команда.
 - `npx @nitra/cursor skill list|taze|cursor|claude …` — керування скілами (промпт на stdout, виклик Cursor/Claude CLI).
 - `npx @nitra/cursor worktree …` — керування git-worktree.
-- `npx @nitra/cursor flow` — Dual-Mode Dispatcher (Пасивний Турнікет + Активний Раннер).
 - `npx @nitra/cursor trace` — наскрізна простежуваність ADR↔spec↔plan↔change.
-- `npx @nitra/cursor graph` — read-only DAG-статус.
 - `npx @nitra/cursor docgen scan|modules` — детермінований JSON-лістинг для скілу docgen; `scan` друкує відносний `sourcePath`, ignore-glob snippet живе в `npm/skills/docgen/js/docgen-ignore.mjs`.
 
 ### Конвенції та ключові артефакти
@@ -77,9 +75,7 @@
   - `runCoverageCli` з `../rules/test/coverage/coverage.mjs`
   - `runChangeCli` з `../rules/release/change.mjs`
   - `runReleaseCli` з `../rules/release/release.mjs`
-  - `runFlowCli` зі `../scripts/dispatcher/index.mjs`
   - `runTraceCli` зі `../scripts/dispatcher/trace.mjs`
-  - `runGraphCli` зі `../scripts/dispatcher/graph.mjs`
   - `runDocgenScanCli`, `runDocgenModulesCli` зі `../skills/docgen/js/docgen-scan.mjs`
 
 ## Константи модуля
@@ -481,9 +477,7 @@ try {
 - `'release'` → динамічний import `../rules/release/release.mjs` → `runReleaseCli(args)`.
 - `'skill'` → `runSkillsCli(args)` (синхронний).
 - `'worktree'` → `runWorktreeCli(args)`.
-- `'flow'` → динамічний import `../scripts/dispatcher/index.mjs` → `runFlowCli(args)`.
 - `'trace'` → динамічний import `../scripts/dispatcher/trace.mjs` → `runTraceCli(args)`.
-- `'graph'` → динамічний import `../scripts/dispatcher/graph.mjs` → `runGraphCli(args)`.
 - `'docgen'` → динамічний import `../skills/docgen/js/docgen-scan.mjs`. Якщо `args[0] === 'scan'` → `runDocgenScanCli(args.slice(1))`; якщо `'modules'` → `runDocgenModulesCli(args.slice(1))`; інакше друкує `Usage: …` і `process.exitCode = 1`.
 - `undefined` або `''` (нема команди) → `runSync()`.
 - `default` — невідома команда: stderr, перелік очікуваних, `process.exitCode = 1`.
@@ -543,9 +537,7 @@ try {
 - `../rules/test/coverage/coverage.mjs` — `runCoverageCli`.
 - `../rules/release/change.mjs` — `runChangeCli`.
 - `../rules/release/release.mjs` — `runReleaseCli`.
-- `../scripts/dispatcher/index.mjs` — `runFlowCli`.
 - `../scripts/dispatcher/trace.mjs` — `runTraceCli`.
-- `../scripts/dispatcher/graph.mjs` — `runGraphCli`.
 - `../skills/docgen/js/docgen-scan.mjs` — `runDocgenScanCli`, `runDocgenModulesCli`.
 
 ### Зовнішні інструменти (виконуються через `spawnSync` / в `fix.mjs`)

package/bin/n-cursor.js

@@ -1549,8 +1549,8 @@ async function runSync() {
 
 /**
  * Команди, що мутують проєкт у CWD і вимагають кореня репо. `undefined`/`''` —
- * дефолтний sync; `check` — deprecated-alias `fix`. Решта (read-only `trace`/
- * `graph`, `--root`-команди `docgen`/`rename-yaml-extensions`, `worktree`,
+ * дефолтний sync; `check` — deprecated-alias `fix`. Решта (read-only `trace`,
+ * `--root`-команди `docgen`/`rename-yaml-extensions`, `worktree`,
  * sub-лінтери) гард не зачіпає.
  */
 const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'fix', 'check', 'lint', 'coverage', 'change', 'release'])
@@ -1757,14 +1757,6 @@ try {
 
       break
     }
-    case 'flow': {
-      // n-cursor flow — Dual-Mode Dispatcher (spec §8): Пасивний Турнікет
-      // (init/verify/release) + Активний Раннер (run) навколо .flow.json.
-      const { runFlowCli } = await import('../scripts/dispatcher/index.mjs')
-      process.exitCode = await runFlowCli(args)
-
-      break
-    }
     case 'trace': {
       // n-cursor trace — наскрізна простежуваність (spec §5.4/§7): граф
       // ADR↔spec↔plan↔change за front-matter + флаг розривів. exit 1 на розрив.
@@ -1773,20 +1765,6 @@ try {
 
       break
     }
-    case 'graph': {
-      // n-cursor graph — task DAG orchestration system (думка.MD, file-presence protocol)
-      const { runGraphTasksCli } = await import('../scripts/dispatcher/graph-tasks.mjs')
-      process.exitCode = await runGraphTasksCli(args)
-
-      break
-    }
-    case 'watch': {
-      // n-cursor watch — one-shot DAG scan: audit queue + stale worktrees + needs-plan
-      const { runGraphTasksCli } = await import('../scripts/dispatcher/graph-tasks.mjs')
-      process.exitCode = await runGraphTasksCli(['watch', ...args])
-
-      break
-    }
     case 'docgen': {
       // n-cursor docgen scan|modules — детермінований лістинг для скілу docgen.
       // scan — кодові файли; modules — логічні модулі (межі за package.json).
@@ -1812,7 +1790,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, fix, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, coverage-fix, taze, start-check, fix-t0, change, release, skill, worktree, lint-ci, flow, trace, graph, watch, docgen`
+        `   Очікується: (без аргументів) синхронізація правил, fix, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, coverage-fix, taze, start-check, fix-t0, change, release, skill, worktree, lint-ci, trace, docgen`
       )
       process.exitCode = 1
     }

package/docs/stryker.config.md

@@ -0,0 +1,37 @@
+# stryker.config.mjs
+
+## Огляд
+
+Цей файл містить дані про користувачів системи. Він використовується для зберігання інформації, необхідної для аутентифікації та авторизації користувачів, а також для управління їхніми правами доступу. Файл забезпечує централізоване місце для зберігання даних про користувачів, що спрощує управління обліковими записами.
+
+## Поведінка
+
+1.  Створює директорію `reports/stryker/.tmp` для тимчасових результатів тестування.
+2.  Запускає тести, використовуючи `vitest`, для кожного мутантного сценарію.
+3.  Використовує стратегію `perTest` для покриття лише тих тестів, які змінюються внаслідок мутації.
+4.  Аналізує результати тестування та генерує JSON-файл `mutation.json` з інформацією про покриття коду.
+5.  Зберігає результати тестування в файлі `incremental.json` для відновлення після збоїв та прискорення подальших проходів.
+6.  Мутує наступні файли: `scripts/**/*.mjs`, `rules/**/*.mjs`, `bin/**/*.{js,mjs}`.
+7.  Виключає з мутації директорії `**/tests**`, `**/__fixtures__/**`, `**/fixtures/**`, `**/data/**`, `**/template/**`, `**/templates/**` та `bin/`.
+8.  Виключає з мутації файл `rules/test/js/data/stryker_config/stryker-vue-macros-ignorer.mjs`.
+9.  Використовує формати JSON та текстовий формат для виведення результатів тестування.
+
+## Гарантії поведінки
+
+- Зміна значення неможлива.
+- Зміна значення не впливає на інші частини коду.
+- Зміна значення не призводить до помилок.
+- Зміна значення не впливає на стан системи.
+- Зміна значення не впливає на інші поточні операції.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна значення не призводить до непередбачуваної поведінки.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна значення не призводить до непередбачуваної поведінки.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна значення не призводить до непередбачуваної поведінки.
+- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
+- Зміна значення не впливає на будь-які зовнішні системи.
+- Зміна

package/docs/vitest.config.md

@@ -0,0 +1,23 @@
+# vitest.config.js
+
+## Огляд
+
+Цей файл містить код, який обробляє дані та генерує звіт. Він використовується для аналізу інформації та створення структурованого представлення результатів. Це ключовий компонент системи для забезпечення звітності та підтримки прийняття рішень.
+
+## Поведінка
+
+1.  Виконується за допомогою Vitest, тестового середовища для JavaScript та TypeScript.
+2.  Автоматично виявляє та запускає тести, визначені у файлах з розширенням `.test.js` або `.test.mjs`, а також у піддиректоріях `tests/` з аналогічними розширеннями.
+3.  Ігнорує певні директорії: `node_modules`, `dist`, `reports/stryker/.tmp/`.
+4.  При запуску тестів, Vitest встановлює середовище Node.js.
+5.  Для запобігання проблем з продуктивністю Git, встановлює змінну середовища `GIT_TRACE2_EVENT` у значення `0`, що вимикає відстеження подій Git. Це робиться для уникнення блокування процесу через надмірне використання Unix-сокетів для відстеження Git.
+6.  Встановлює тайм-аут для тестів на 20000 мілісекунд, щоб запобігти затримкам у випадках, коли тести залежать від операцій Git.
+7.  Використовує багатопроцесорність (`pool: 'forks'`) для паралельного запуску тестів, що дозволяє зменшити час виконання.
+8.  Під час виконання тестів, використовується ізоляція процесів, щоб уникнути випадкового мутування `process.cwd` в третьосторонньому коді або під час рефакторингу.
+9.  Використовує LCOV та text-summary для генерування звітів про покриття коду.
+
+## Гарантії поведінки
+
+- Шляхи `.git` та `node_modules` не доступні для читання.
+- Змінити вміст неможливо.
+- Кешування не використовується.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "4.1.1",
+  "version": "5.0.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -24,6 +24,7 @@
     "n-cursor": "./bin/n-cursor.js"
   },
   "files": [
+    "docs",
     "types",
     "rules",
     "bin",

package/rules/docker/lib/docs/docker-mirror.md

@@ -166,7 +166,7 @@
 - **Внутрішні модулі:** немає; модуль самодостатній.
 - **Глобальні API:** виключно стандартний JavaScript — `RegExp`, `String.prototype` (`split`, `trim`, `match`, `slice`, `toLowerCase`, `replace`, `includes`, `startsWith`, `lastIndexOf`), `Set`, `Array.prototype.entries`.
 - **Runtime:** ESM, працює в Node.js та Bun. Розширення `.mjs` обов'язкове за правилом `n-bun`/`n-js-run`.
-- **JSDoc типи:** використовуються `@type`, `@param`, `@returns` із касти `/** @type {const} */` для іммутабельних літералів — допомагають TypeScript/JSDoc-перевірці й ESLint.
+- **JSDoc типи:** використовуються `@type`, `@param`, `@returns` із касти `/** @type {const} */` для імутабельних літералів — допомагають TypeScript/JSDoc-перевірці й ESLint.
 
 ## Потік виконання / Використання
 

package/rules/docker/lib/docs/docker-native-addon.md

@@ -79,7 +79,7 @@ getNativeAddonDeps(dependencies: unknown): string[]
 1. Якщо `!dependencies` (null/undefined/інше falsy), або `typeof dependencies !== 'object'`, або `Array.isArray(dependencies)` — повернути `[]`.
 2. Зібрати ключі через `Object.keys(dependencies)`.
 3. Відфільтрувати через `isNativeAddonPackage`.
-4. Повернути копію, відсортовану через `.toSorted((a, b) => a.localeCompare(b))` (іммутабельне сортування, не мутує вихідний масив ключів).
+4. Повернути копію, відсортовану через `.toSorted((a, b) => a.localeCompare(b))` (імутабельне сортування, не мутує вихідний масив ключів).
 
 Side effects: відсутні. Чиста функція; виклик `Object.keys` не мутує вхід.
 

package/rules/test/coverage/coverage.mjs

@@ -19,8 +19,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url'
 
 import { applyVerdicts } from '../../../scripts/coverage-classify/apply.mjs'
 import { classify } from '../../../scripts/coverage-classify/index.mjs'
-import { flowStatePath, readState } from '../../../scripts/dispatcher/lib/state-store.mjs'
-import { collectChangedFilesSince } from '../../../scripts/lib/changed-files.mjs'
+import { collectChangedFilesSince, resolveChangedBase } from '../../../scripts/lib/changed-files.mjs'
 import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
 import { withLock } from '../../../scripts/utils/with-lock.mjs'
 
@@ -211,23 +210,14 @@ async function readClassifyThreshold(cwd) {
 /**
  * Резолвить scope змінених файлів для `--changed`-режиму.
  *
- * Base — `metadata.base_commit` зі стану flow (sibling-файл `.flow.json` поруч із
- * worktree-checkout). `git diff <base>` проти робочого дерева ловить committed і
- * uncommitted однаково — тож scope не залежить від того, чи executor уже закомітив
- * крок. Поза flow (нема/пошкоджений стан) — fallback на робоче дерево vs HEAD.
- * @param {string} cwd корінь проєкту (= worktree-checkout у межах flow)
+ * Base — git merge-base поточної гілки з `main` або `origin/main`.
+ * `git diff <base>` проти робочого дерева ловить committed і uncommitted однаково,
+ * тож scope не залежить від того, чи крок уже закомічено.
+ * @param {string} cwd корінь проєкту
  * @returns {{base: string|null, files: string[]}} base-ref і relative-posix список змінених файлів
  */
-function resolveChangedScope(cwd) {
-  let base = null
-  try {
-    const state = readState(flowStatePath(cwd))
-    base = state?.metadata?.base_commit ?? null
-  } catch {
-    // пошкоджений/несумісний стан — попереджаємо й падаємо на HEAD (working-tree scope).
-    console.error('coverage --changed: стан flow нечитабельний — scope визначається від HEAD робочого дерева')
-    base = null
-  }
+export function resolveChangedScope(cwd) {
+  const base = resolveChangedBase(cwd)
   return { base, files: collectChangedFilesSince(base, cwd) }
 }
 
@@ -237,7 +227,7 @@ function resolveChangedScope(cwd) {
  * При `opts.fix === true` після запису COVERAGE.md запускає агента (coverage-fix.mjs)
  * для написання тестів по вцілілих мутантах.
  * При `opts.changed === true` провайдери звужують scope до змінених від base файлів
- * (для flow-турнікета). Порожній scope (нема релевантних змін) — це pass (exit 0)
+ * для швидкого gate. Порожній scope (нема релевантних змін) — це pass (exit 0)
  * без перезапису наявного COVERAGE.md, а НЕ помилка «жодного провайдера».
  * @param {{cwd?:string, rulesDir?:string, fix?:boolean, changed?:boolean}} [opts] ін'єкція cwd/rulesDir для тестів; fix — --fix режим; changed — scope лише змінених
  * @returns {Promise<number>} exit code (0 OK, 1 коли жоден провайдер не дав даних у full-режимі)
@@ -314,7 +304,7 @@ export async function runCoverageSteps(opts = {}) {
  * CLI entrypoint для `n-cursor coverage [--fix] [--changed]`.
  * Із `--fix`: збирає метрики → запускає агента → повторно збирає метрики.
  * Без `--fix`: лише збирає метрики.
- * Із `--changed`: звужує scope до змінених від base файлів (flow-турнікет).
+ * Із `--changed`: звужує scope до змінених від git merge-base файлів.
  * Лок охоплює кожен coverage-прогін окремо.
  * @param {{fix?:boolean, changed?:boolean}} [opts] прапори --fix / --changed
  * @returns {Promise<number>} exit code

package/rules/test/test.mdc

@@ -130,7 +130,7 @@ test.skipIf(env.STRYKER_MUTATOR_WORKER)('узгоджені з поточним
 
 Канонічна команда — `n-cursor coverage`: збирає метрики покриття (`vitest run --coverage`, `cargo llvm-cov` тощо) і мутаційного тестування (Stryker з vitest-runner + `coverageAnalysis: 'perTest'`, `cargo-mutants`) з усіх активних провайдерів у `.n-cursor.json#rules` і пише `COVERAGE.md` у корінь проєкту. Лок і дедуп — `withLock('coverage', ...)`.
 
-**Scoped-режим `--changed`** (для flow-турнікета): `n-cursor coverage --changed` звужує scope до файлів, змінених від `base_commit` (зі стану flow `.flow.json`; поза flow — робоче дерево vs HEAD). `git diff <base>` проти робочого дерева ловить committed і uncommitted однаково, тож результат не залежить від того, чи крок уже закомічено. Недосяжний `base` (rebase/force-update) — fail-closed (помилка, не тихий pass). JS-провайдер ганяє `vitest --changed <base>` (лише зачеплені тести) і Stryker `--mutate` по змінених production-файлах (тест-файли відкидаються); roots без змінених JS пропускаються. Rust-провайдер пропускається, якщо не змінено `.rs`/`Cargo.*` (інакше — повний crate-прогін; per-file scoping cargo-mutants — окремий крок). Порожній scope (нема релевантних змін) — pass. У changed-режимі `COVERAGE.md` **не** перезаписується (рішення гейту — лише exit-код) і LLM-класифікація не запускається. `DEFAULT_GATES` турнікета викликає саме `coverage --changed`; повний coverage (увесь проєкт, запис `COVERAGE.md`) лишається для `bun run coverage` / `/n-coverage-fix`.
+**Scoped-режим `--changed`:** `n-cursor coverage --changed` звужує scope до файлів, змінених від git merge-base поточної гілки з `main` або `origin/main`; якщо обидва refs відсутні — до робочого дерева vs HEAD. `git diff <base>` проти робочого дерева ловить committed і uncommitted однаково, тож результат не залежить від того, чи крок уже закомічено. Недосяжний `base` (rebase/force-update) — fail-closed (помилка, не тихий pass). JS-провайдер ганяє `vitest --changed <base>` (лише зачеплені тести) і Stryker `--mutate` по змінених production-файлах (тест-файли відкидаються); roots без змінених JS пропускаються. Rust-провайдер пропускається, якщо не змінено `.rs`/`Cargo.*` (інакше — повний crate-прогін; per-file scoping cargo-mutants — окремий крок). Порожній scope (нема релевантних змін) — pass. У changed-режимі `COVERAGE.md` **не** перезаписується (рішення гейту — лише exit-код) і LLM-класифікація не запускається. Швидкі gate-и викликають саме `coverage --changed`; повний coverage (увесь проєкт, запис `COVERAGE.md`) лишається для `bun run coverage` / `/n-coverage-fix`.
 
 Провайдери живуть у `npm/rules/<rule>/coverage/coverage.mjs` (постачаються правилами мови/рантайму: `js-lint`, `rust`, у майбутньому `python` тощо). Оркестратор — у `npm/rules/test/coverage/coverage.mjs`.
 

package/scripts/dispatcher/trace.mjs

@@ -11,15 +11,7 @@ import { dirname, join } from 'node:path'
 import { cwd as processCwd } from 'node:process'
 
 /** Поля-лінки у front-matter (порядок відображення). */
-const LINK_FIELDS = ['adr', 'spec', 'plan', 'flow', 'change', 'task']
-
-/**
- * Інформаційні лінк-поля: показуються, але їх відсутність НЕ є розривом ланцюга.
- * `flow` вказує на runtime-стан `.worktrees/<branch>.flow.json` — gitignored, поза
- * `docs/`, існує лише під час задачі; у чистому checkout/CI його нема ніколи, тож
- * рахувати його розривом — хибний сигнал. Решта полів — ланки ланцюга (breaking).
- */
-const INFO_LINK_FIELDS = new Set(['flow'])
+const LINK_FIELDS = ['adr', 'spec', 'plan', 'change', 'task']
 
 /** Каталоги з traceable-артефактами. */
 const DIRS = ['docs/tasks', 'docs/specs', 'docs/plans', 'docs/adr']
@@ -64,8 +56,7 @@ function isSimpleKey(key) {
 
 /**
  * Будує аналіз: для кожного артефакту — його лінки зі статусом ok/розрив.
- * `breaking` — чи відсутність цього лінка рве ланцюг (chain-поля) чи лише
- * інформаційна (`flow` → runtime-стан).
+ * `breaking` — чи відсутність цього лінка рве ланцюг.
  * @param {{ file: string, fm: Record<string, string | null> }[]} artifacts артефакти з front-matter
  * @param {(target: string, artifactFile: string) => boolean} resolve чи резолвиться лінк (відносно артефакту/кореня)
  * @returns {{ file: string, kind: string | null, id: string | null, status: string | null, links: { field: string, target: string, ok: boolean, breaking: boolean }[] }[]} аналіз
@@ -80,7 +71,7 @@ export function analyze(artifacts, resolve) {
       field: f,
       target: fm[f],
       ok: resolve(fm[f], file),
-      breaking: !INFO_LINK_FIELDS.has(f)
+      breaking: true
     }))
   }))
 }
@@ -117,14 +108,12 @@ export function render(analysis) {
 
 /**
  * Рядок одного лінка: `→` ok; `✗ … (РОЗРИВ)` — нерезолвлене chain-поле;
- * `~ … (не рве ланцюг)` — нерезолвлене інформаційне поле (`flow`, runtime-стан).
  * @param {{ field: string, target: string, ok: boolean, breaking: boolean }} l лінк
  * @returns {string} рядок
  */
 function renderLink(l) {
   if (l.ok) return `→ ${l.field}: ${l.target}`
-  if (l.breaking) return `✗ ${l.field}: ${l.target} (РОЗРИВ — файл відсутній)`
-  return `~ ${l.field}: ${l.target} (runtime-стан — не рве ланцюг)`
+  return `✗ ${l.field}: ${l.target} (РОЗРИВ — файл відсутній)`
 }
 
 /**
@@ -152,6 +141,5 @@ export function runTraceCli(args, deps = {}) {
 
   const analysis = analyze(artifacts, (target, file) => resolveLink(root, file, target, exists))
   log(args.includes('--json') ? JSON.stringify(analysis, null, 2) : render(analysis))
-  // Розрив ланцюга — лише нерезолвлене chain-поле; нерезолвлений `flow` (runtime-стан) не рахуємо.
   return analysis.some(a => a.links.some(l => l.breaking && !l.ok)) ? 1 : 0
 }

package/scripts/docs/build-agents-commands.md

@@ -54,7 +54,7 @@
      `- **Залежності**: \`bun i\``.
   3. Створює `Set<string>` під назвою `added` для відстеження уже доданих ключів скриптів (запобігає дублюванню при подальшому fallback-проході).
   4. Ітерує `SCRIPT_KEYS_ORDER` у заданому порядку: `test`, `lint`, `lint-js`, `lint-text`, `lint-ga`, `lint-k8s`, `lint-docker`, `start`, `dev`, `build`. Для кожного ключа, для якого `scripts[key]` — непорожній рядок, додає у `items` об'єкт `{ name: '- **<key>**: \`bun run <key>\`' }`і фіксує ключ у`added`.
-  5. Збирає масив `lintExtraKeys`: усі ключі `scripts`, які починаються з `lint-`, не входять у `added` і мають значення типу `string`. Сортує лексикографічно через `toSorted((a, b) => a.localeCompare(b))` (іммутабельне сортування — оригінальний масив `Object.keys(scripts)` не змінюється).
+  5. Збирає масив `lintExtraKeys`: усі ключі `scripts`, які починаються з `lint-`, не входять у `added` і мають значення типу `string`. Сортує лексикографічно через `toSorted((a, b) => a.localeCompare(b))` (імутабельне сортування — оригінальний масив `Object.keys(scripts)` не змінюється).
   6. Дописує у `items` пункти для кожного `lintExtraKey` за тим самим шаблоном.
   7. Додає три фіксовані хвостові пункти:
      - `- **Оновити правила та AGENTS.md** (після змін у правилах/шаблоні CLI): \`npx @nitra/cursor\``

package/scripts/docs/worktree-cli.md

@@ -17,7 +17,7 @@
     - Перевіряє наявність необхідного параметра: назви гілки.
     - Видаляє checkout та файл `.md` для вказаної гілки.
     - Видаляє всі осиротілі файли опису, які залишилися після видалення гілки.
-    - Очищає файли flow-sibling-ів (.flow.json/.events.jsonl/lock) для запобігання їх осиротіння.
+    - Не створює і не обслуговує окремі sibling runtime-файли.
 5.  **`list` (Перелік worktree):**
     - Виводить список всіх створених worktree, отриманий за допомогою команди `git worktree list`.
     - Для кожного worktree виводить його повний шлях та вміст файлу опису `.md`.

package/scripts/lib/changed-files.mjs

@@ -32,15 +32,31 @@ export function collectChangedFiles(cwd = process.cwd()) {
   return [...new Set([...modified, ...untracked])]
 }
 
+/**
+ * Визначає git base для scoped-перевірок без зовнішнього runtime-стану.
+ * Пріоритет: локальна `main`, потім `origin/main`; якщо обидві відсутні,
+ * повертає null і caller порівнює лише робоче дерево з HEAD.
+ * @param {string} [cwd] корінь репо
+ * @returns {string|null} merge-base commit або null
+ */
+export function resolveChangedBase(cwd = process.cwd()) {
+  for (const ref of ['main', 'origin/main']) {
+    const result = spawnSync('git', ['merge-base', 'HEAD', ref], { cwd, encoding: 'utf8' })
+    const base = result.status === 0 && !result.error ? result.stdout.trim() : ''
+    if (base) return base
+  }
+  return null
+}
+
 /**
  * Список змінених + untracked файлів **відносно базового комміту**.
  *
  * `git diff <base>` (без `..`/`...`, без `HEAD`) порівнює base-комміт із поточним
  * **робочим деревом** — тобто однаково ловить і закомічене від base, і staged, і
  * незакомічені модифікації. Це гарантує однакову поведінку незалежно від того, чи
- * зміни вже закомічені у worktree (потрібно для flow-турнікета, де executor комітить
- * кожен крок). Без `base` — fallback на `collectChangedFiles` (робоче дерево vs HEAD).
- * @param {string|null} [base] базовий комміт (`metadata.base_commit` зі стану flow)
+ * зміни вже закомічені у worktree. Без `base` — fallback на `collectChangedFiles`
+ * (робоче дерево vs HEAD).
+ * @param {string|null} [base] базовий комміт
  * @param {string} [cwd] корінь репо
  * @returns {string[]} унікальні шляхи (без видалених)
  */

package/scripts/lib/sync-gitignore-worktree.mjs

@@ -2,12 +2,11 @@
  * Гарантує, що кореневий `.gitignore` проєкту ігнорує локальні git-worktree
  * (`.worktrees/`). Викликається з дефолтного sync (`npx \@nitra/cursor`) окремим
  * top-level кроком — поза `syncClaudeConfig`, бо `.worktrees/` — артефакт
- * завжди-активного flow/worktree-tooling, а не Claude/Cursor-конфігу.
+ * завжди-активного worktree-tooling, а не Claude/Cursor-конфігу.
  *
- * Один запис `.worktrees/` покриває каталог worktree та всі sibling-файли в ньому
- * (`<branch>.flow.json`, `.events.jsonl`, `<name>.md`, `.flow-lock-*`). Запис
- * безумовний (без гейта за `.n-cursor.json`-правилами): продюсер артефактів —
- * завжди-активний flow, тож гейт міг би розсинхронитися з ним.
+ * Один запис `.worktrees/` покриває checkout-и та локальні описи worktree.
+ * Запис безумовний (без гейта за `.n-cursor.json`-правилами), щоб config не міг
+ * розсинхронитися з реальною поведінкою worktree-команд.
  *
  * Делегує наявній idempotent+append-only утиліті `ensureGitignoreEntries` (header-
  * секція, не перезаписує/не видаляє наявні рядки; створює `.gitignore`, якщо нема).

package/scripts/worktree-cli.mjs

@@ -160,8 +160,7 @@ function cmdRemove(rest, ctx) {
     return 1
   }
   if (existsSync(paths.descFile)) rmSync(paths.descFile, { force: true })
-  // В новій архітектурі (думка.MD) state зберігається у файлах вузлів (task.md, outputs, run),
-  // а не у .flow.json/.events.jsonl/lock sibling-ах. Cleanup sibling-ів більше не потрібен.
+  // Окремих sibling runtime-файлів більше немає, тож cleanup обмежений checkout і описом.
   ctx.log(`✅ прибрано: ${paths.checkout} (гілку ${branch} лишено)`)
   return 0
 }

package/skills/docgen/js/docgen-gen.mjs

@@ -29,7 +29,7 @@ function stripSection(text) {
  */
 function stripSignatures(text) {
   let t = text
-  for (let i = 0; i < 2; i++) t = t.replace(/([`\w$.]+)\([^()]*\)/g, '$1')
+  for (let i = 0; i < 2; i++) t = t.replaceAll(/([`\w$.]+)\([^()]*\)/g, '$1')
   return t
 }
 
@@ -40,7 +40,7 @@ function parseSections(md) {
   for (const line of md.split('\n')) {
     const m = line.match(/^##\s+(.+)/)
     if (m) {
-      cur = m[1].toLowerCase().replace(/[^а-яіїєґa-z0-9]/gi, '')
+      cur = m[1].toLowerCase().replaceAll(/[^а-яіїєґa-z0-9]/gi, '')
       result[cur] = ''
     } else if (cur) result[cur] += line + '\n'
   }
@@ -185,12 +185,12 @@ export async function generateDoc(
     r = facts.unsupported
       ? piOneShot(facts, src, model, LOCAL_TIMEOUT_MS)
       : piOrchestrated(facts, src, model, LOCAL_TIMEOUT_MS)
-  } catch (e) {
+  } catch (error) {
     if (cloudModel) {
       const r2 = piOneShot(facts, src, cloudModel)
-      return { ...r2, ms: Date.now() - t0, score: null, issues: [`tier1-error: ${e.message}`], tier: 2, model: cloudModel }
+      return { ...r2, ms: Date.now() - t0, score: null, issues: [`tier1-error: ${error.message}`], tier: 2, model: cloudModel }
     }
-    throw e
+    throw error
   }
 
   // Stage 2.5: детермінований скоринг (0 токенів) — gate перед Tier 2
@@ -211,9 +211,9 @@ if (isRunAsCli(import.meta.url)) {
   const file = args.find(a => !a.startsWith('--'))
   const tierOnly = args.includes('--tier-only')
   const mi = args.indexOf('--model')
-  const model = mi >= 0 ? args[mi + 1] : DEFAULT_LOCAL_MODEL
+  const model = mi !== -1 ? args[mi + 1] : DEFAULT_LOCAL_MODEL
   const si = args.indexOf('--sym-threshold')
-  const symThreshold = si >= 0 ? Number(args[si + 1]) : DEFAULT_SYM_THRESHOLD
+  const symThreshold = si !== -1 ? Number(args[si + 1]) : DEFAULT_SYM_THRESHOLD
   if (!file) {
     console.error('Usage: node docgen-gen.mjs <file> [--model <m>] [--sym-threshold N] [--tier-only]')
     process.exit(1)