@nitra/cursor 4.1.2 → 5.0.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [5.0.1] - 2026-06-09
+
+### Fixed
+
+- npm-module/npm_publish_yml: крок Release у канонічному сніпеті викликає бінарник `n-cursor release` з PATH замість `node npm/bin/n-cursor.js release` — шлях npm/bin/n-cursor.js не існує у downstream-споживачів і ламав їхній npm-publish (`Cannot find module .../npm/bin/n-cursor.js`, напр. @7n/n)
+- ci/setup-bun-deps: синхронізовано `bun.lock` з `package.json` — застарілий lockfile валив `bun install --frozen-lockfile` у workflow `npm-publish` ще до кроку release, блокуючи публікацію
+- npm-module/npm_publish_yml: крок Release викликає `bunx n-cursor release` замість `n-cursor release` — голий workflow-`run:` не має `node_modules/.bin` у PATH (на відміну від npm/bun-скриптів), тож `n-cursor` падав з `command not found` (exit 127); `bunx` резолвить бінарник із node_modules і працює і в @nitra/cursor, і в downstream-споживачів
+
+## [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

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/package.json

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

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/npm-module/npm-module.mdc

@@ -65,7 +65,7 @@ bunx -p typescript tsc src/**/*.js --declaration --allowJs --emitDeclarationOnly
 
 **`npm-publish.yml`:** push у **`main`**, **`on.push.paths`** з **`npm/**`**, **`JS-DevTools/npm-publish@v4.1.5`**, **`with.package: npm/package.json`**, **`permissions.id-token: write`** (OIDC на npm).
 
-Workflow робить **release + publish** одним job (`release-publish`): крок **`Release (bump + CHANGELOG + tag)`** (`node npm/bin/n-cursor.js release` — агрегує change-файли, bump `version`, генерує секцію `CHANGELOG.md`, ставить git-тег) виконується **перед** публікацією. Тому потрібні **`permissions.contents: write`** і **`persist-credentials: true`** з **`fetch-depth: 0`** на `checkout` (release пушить commit-back версії та тег), а також локальний composite **`./.github/actions/setup-bun-deps`** і крок `Configure git identity`. Це узгоджено з **`n-changelog`**: `version`/`CHANGELOG.md` змінює лише `n-cursor release` у CI на `main`. Програмна перевірка (`npm_module.npm_publish_yml`) звіряє **весь канонічний сніпет** напряму (`target.json:"check":"template"`, generic deep-subset): усі поля й кроки сніпета (`on.push.paths`/`branches`, `concurrency`, `permissions.contents/id-token`, `checkout` з `persist-credentials/fetch-depth`, `setup-bun-deps`, `Configure git identity`, `Release`, publish-крок) **обовʼязкові**; зайві кроки/поля дозволені (subset-of), масиви матчаться за наявністю (порядок кроків не важить). Сніпет — єдине джерело істини: його редагування одразу змінює enforce, без правок rego й без міграторів.
+Workflow робить **release + publish** одним job (`release-publish`): крок **`Release (bump + CHANGELOG + tag)`** (`bunx n-cursor release` — агрегує change-файли, bump `version`, генерує секцію `CHANGELOG.md`, ставить git-тег) виконується **перед** публікацією. Тому потрібні **`permissions.contents: write`** і **`persist-credentials: true`** з **`fetch-depth: 0`** на `checkout` (release пушить commit-back версії та тег), а також локальний composite **`./.github/actions/setup-bun-deps`** і крок `Configure git identity`. Це узгоджено з **`n-changelog`**: `version`/`CHANGELOG.md` змінює лише `n-cursor release` у CI на `main`. Програмна перевірка (`npm_module.npm_publish_yml`) звіряє **весь канонічний сніпет** напряму (`target.json:"check":"template"`, generic deep-subset): усі поля й кроки сніпета (`on.push.paths`/`branches`, `concurrency`, `permissions.contents/id-token`, `checkout` з `persist-credentials/fetch-depth`, `setup-bun-deps`, `Configure git identity`, `Release`, publish-крок) **обовʼязкові**; зайві кроки/поля дозволені (subset-of), масиви матчаться за наявністю (порядок кроків не важить). Сніпет — єдине джерело істини: його редагування одразу змінює enforce, без правок rego й без міграторів.
 
 - Канон: [npm-publish.yml.snippet.yml](./policy/npm_publish_yml/template/npm-publish.yml.snippet.yml)
 

package/rules/npm-module/policy/npm_publish_yml/template/npm-publish.yml.snippet.yml

@@ -37,7 +37,7 @@ jobs:
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
       - name: Release (bump + CHANGELOG + tag)
-        run: node npm/bin/n-cursor.js release
+        run: bunx n-cursor release
 
       - name: Publish package
         uses: JS-DevTools/npm-publish@v4.1.5

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)