@nitra/cursor 3.29.0 → 4.1.0

package/scripts/dispatcher/lib/artifact.mjs

@@ -1,79 +0,0 @@
-/**
- * Спільні утиліти фаз `spec`/`plan` (Пасивний Турнікет): резолв traceable-
- * артефакту в `docs/<kind>/`, екстракт кроків плану зі секції `## Кроки`, і
- * read-only перевірка цілісності ланцюга через `n-cursor trace` (`trace.mjs`).
- *
- * Лінки front-matter (`spec.plan`/`plan.spec`/`plan.flow`) пише сам агент за
- * контрактом `flow.mdc` — тут лише ВЕРИФІКАЦІЯ (мутатора `trace link` нема).
- */
-import { existsSync, readdirSync, statSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { runTraceCli } from '../trace.mjs'
-
-/**
- * Резолвить артефакт у `docs/<kind>/`. Пріоритет: файли, чия назва містить
- * хвіст гілки (slug, напр. `flow-gate` з `claude/flow-gate`); серед них (або
- * серед усіх, якщо збігу нема) — **найсвіжіший за mtime**. Лексикографічний
- * вибір був хибним при кількох артефактах на одну дату (виявлено dogfood'ом).
- * @param {string} cwd корінь worktree
- * @param {'specs' | 'plans'} kind підкаталог `docs`
- * @param {string} [branch] гілка задачі — для пріоритету за slug
- * @returns {string | null} абсолютний шлях або null, якщо каталог/файли відсутні
- */
-export function resolveArtifact(cwd, kind, branch) {
-  const dir = join(cwd, 'docs', kind)
-  if (!existsSync(dir)) return null
-  const md = readdirSync(dir).filter(f => f.endsWith('.md'))
-  if (md.length === 0) return null
-
-  const slug = branch ? branch.split('/').pop() : null
-  const matched = slug ? md.filter(f => f.includes(slug)) : []
-  const pool = matched.length > 0 ? matched : md
-
-  const best = pool
-    .map(f => ({ f, mtime: statSync(join(dir, f)).mtimeMs }))
-    .toSorted((a, b) => a.mtime - b.mtime || (a.f < b.f ? -1 : 1))
-    .at(-1)
-  return join(dir, best.f)
-}
-
-/** Маркер критерію приймання в рядку кроку (порівняння — case-insensitive). */
-const ACCEPTANCE_MARK = '— acceptance:'
-/** Лише цифри — перевірка нумерації кроку (лінійний, без backtracking). */
-const DIGITS_RE = /^\d+$/u
-
-/**
- * Кроки зі секції плану — нумерований список `N. <task> — acceptance: <crit>`.
- * Best-effort парсинг через `indexOf` (без regex-backtracking): рядки поза
- * форматом ігноруються.
- * @param {string} text вміст plan-doc
- * @returns {{ task: string, acceptance?: string }[]} кроки у порядку появи
- */
-export function extractSteps(text) {
-  const steps = []
-  for (const raw of String(text).split('\n')) {
-    const line = raw.trim()
-    const dot = line.indexOf('. ')
-    if (dot <= 0 || !DIGITS_RE.test(line.slice(0, dot))) continue
-    const body = line.slice(dot + 2).trim()
-    const sep = body.toLowerCase().indexOf(ACCEPTANCE_MARK)
-    if (sep === -1) {
-      steps.push({ task: body })
-    } else {
-      steps.push({ task: body.slice(0, sep).trim(), acceptance: body.slice(sep + ACCEPTANCE_MARK.length).trim() })
-    }
-  }
-  return steps
-}
-
-/**
- * Read-only перевірка цілісності ланцюга артефактів (не мутує — лише сигнал).
- * @param {string} cwd корінь worktree
- * @param {(cwd: string) => number} [runTrace] runner trace (0 — цілісно, 1 — розрив); ін'єкція для тестів
- * @returns {boolean} true, якщо ланцюг цілісний
- */
-export function verifyTrace(cwd, runTrace) {
-  const run = runTrace ?? (c => runTraceCli([], { cwd: c, log: () => {} }))
-  return run(cwd) === 0
-}

package/scripts/dispatcher/lib/budget.mjs

@@ -1,36 +0,0 @@
-/**
- * Budget guard для автономного режиму (spec §9.4): обгортає SubagentRunner
- * лічильником викликів і кидає `BudgetExceeded` при перевищенні `maxApiCalls`.
- * Це запобіжник проти неконтрольованих витрат на сервері (де нема людини).
- *
- * (`maxCostUsd` — коли runner повертатиме tokens/cost; наразі рахуємо виклики.)
- */
-
-/** Помилка перевищення бюджету (ловиться в `run`, §9.4). */
-export class BudgetExceeded extends Error {}
-
-/**
- * Обгортає runner лічильником API-викликів.
- * @param {{ backend?: string, runStep: (prompt: string, opts?: object) => object }} runner базовий runner
- * @param {{ maxApiCalls?: number, log?: (m: string) => void }} [opts] ліміт і лог
- * @returns {{ backend: string, runStep: (prompt: string, opts?: object) => Promise<object>, readonly calls: number }} обгорнутий runner
- */
-export function withBudget(runner, opts = {}) {
-  const maxApiCalls = opts.maxApiCalls ?? Number.POSITIVE_INFINITY
-  const log = opts.log ?? (() => {})
-  let calls = 0
-  return {
-    backend: runner.backend,
-    get calls() {
-      return calls
-    },
-    async runStep(prompt, stepOpts) {
-      if (calls >= maxApiCalls) {
-        throw new BudgetExceeded(`budget: вичерпано maxApiCalls=${maxApiCalls}`)
-      }
-      calls += 1
-      log(`budget: API-виклик ${calls}/${maxApiCalls}`)
-      return runner.runStep(prompt, stepOpts)
-    }
-  }
-}

package/scripts/dispatcher/lib/capability.mjs

@@ -1,59 +0,0 @@
-/**
- * Capability Router — резолвер режиму оркестрації (`native` vs `polyfill`)
- * за **явною декларацією моделі** (spec §2.2).
- *
- * Рантайм-детекції моделі в кодобазі немає — тому модель НЕ вгадуємо, а
- * оголошуємо за пріоритетом: CLI `--model` > env `N_CURSOR_FLOW_MODEL` >
- * config `flow.model`. Default-режим (`polyfill`) дозволений ЛИШЕ за наявного
- * `SubagentRunner` (§15.1); інакше — fail (caller кидає помилку), бо polyfill
- * без runner-а не «працює з будь-якою моделлю».
- *
- * Усі функції чисті (без I/O) — джерела (`args`/`env`/`config`/`matrix`/
- * `hasRunner`) передаються ззовні, що робить модуль тривіально тестованим.
- */
-
-export const DEFAULT_ORCHESTRATION = 'polyfill'
-
-/**
- * Витягує значення `--model <value>` з argv. Не мутує вхід.
- * @param {string[]} args аргументи підкоманди flow
- * @returns {string | null} оголошена модель або null
- */
-export function parseModelFlag(args) {
-  const i = args.indexOf('--model')
-  return i !== -1 && i + 1 < args.length ? args[i + 1] : null
-}
-
-/**
- * Оголошена модель за пріоритетом CLI > env > config.
- * @param {{ cliModel?: string | null, envModel?: string | null, configModel?: string | null }} sources джерела декларації
- * @returns {string | null} модель або null, якщо ніде не оголошено
- */
-export function declaredModel({ cliModel = null, envModel = null, configModel = null } = {}) {
-  return cliModel || envModel || configModel || null
-}
-
-/**
- * Режим оркестрації для оголошеної моделі за `capability-matrix`.
- * Невідома/неоголошена модель → `matrix.default` → `DEFAULT_ORCHESTRATION`.
- * @param {string | null} model оголошена модель
- * @param {{ models?: Record<string, { orchestration?: string }>, default?: { orchestration?: string } }} matrix матриця можливостей
- * @returns {'native' | 'polyfill'} режим
- */
-export function orchestrationFor(model, matrix) {
-  const entry = model && matrix && matrix.models ? matrix.models[model] : null
-  return (
-    (entry && entry.orchestration) ||
-    (matrix && matrix.default && matrix.default.orchestration) ||
-    DEFAULT_ORCHESTRATION
-  )
-}
-
-/**
- * Чи стартує polyfill: потрібен доступний `SubagentRunner`.
- * @param {{ hasRunner: boolean }} ctx контекст середовища
- * @returns {boolean} true, якщо runner у наявності
- */
-export function polyfillStartable({ hasRunner }) {
-  return hasRunner === true
-}

package/scripts/dispatcher/lib/commands.mjs

@@ -1,296 +0,0 @@
-/**
- * Handler-и підкоманд `flow` (spec §8). Уся IO — через ін'єктовані `run`/`log`/
- * `fingerprint`/`now`, щоб логіку тестувати без реальних процесів.
- *
- * Ф2 (Пасивний Турнікет): `init` (worktree + стан), `verify` (Суддя), `release`
- * (change + completion snapshot). `run`/`resume`/`cancel`/`repair` — Ф4.
- */
-import { spawnSync } from 'node:child_process'
-import { isAbsolute, join } from 'node:path'
-import { cwd as processCwd } from 'node:process'
-
-import { worktreePaths } from '../../lib/worktree.mjs'
-import { collectChangedFilesSince } from '../../lib/changed-files.mjs'
-import { worktreeFingerprint } from '../../utils/worktree-fingerprint.mjs'
-import { getMonorepoProjectRootDirs } from '../../../rules/changelog/lib/package-manifest.mjs'
-import { flowEventsPath } from './events.mjs'
-import { detectLevel, detectRisk } from './level.mjs'
-import { runReview } from './reviewer.mjs'
-import { buildCompletionSnapshot, writeSummaryToTaskRecord } from './snapshot.mjs'
-import { flowStatePath, readState, recordTransition, writeState } from './state-store.mjs'
-import { resolveActiveFlowState } from './flow-resolve.mjs'
-
-/**
- * Реальний sync-runner із захопленням виводу.
- * @param {string} cmd виконуваний
- * @param {string[]} args аргументи
- * @param {object} [opts] додаткові опції spawnSync (напр. `cwd`)
- * @returns {{ status: number, stdout: string, stderr: string }} результат
- */
-export function realRun(cmd, args, opts = {}) {
-  const r = spawnSync(cmd, args, { encoding: 'utf8', ...opts })
-  return { status: r.status ?? 1, stdout: r.stdout ?? '', stderr: r.stderr ?? '' }
-}
-
-/**
- * Чи `cwd` — уже linked worktree (не основний checkout і не submodule).
- * @param {(cmd: string, args: string[], opts: object) => { status: number, stdout: string }} run runner
- * @param {string} cwd робочий каталог
- * @returns {boolean} true, якщо вже в worktree
- */
-function inLinkedWorktree(run, cwd) {
-  const gitDir = run('git', ['rev-parse', '--git-dir'], { cwd })
-  const gitCommon = run('git', ['rev-parse', '--git-common-dir'], { cwd })
-  if ((gitDir.status ?? 1) !== 0 || (gitCommon.status ?? 1) !== 0) return false
-  const superproject = run('git', ['rev-parse', '--show-superproject-working-tree'], { cwd })
-  const isSubmodule = (superproject.stdout ?? '').trim() !== ''
-  return !isSubmodule && (gitDir.stdout ?? '').trim() !== (gitCommon.stdout ?? '').trim()
-}
-
-/**
- * `flow init <branch> "<опис>"` — ізоляція + ініціалізація стану (§8.1). Якщо вже
- * в worktree — не вкладає новий (detect existing isolation).
- * @param {string[]} rest аргументи: `<branch> <опис...>`
- * @param {{ run?: (cmd: string, args: string[], opts: object) => { status: number, stdout: string, stderr: string }, cwd?: string, log?: (m: string) => void, now?: () => number }} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-/**
- * Гарантує worktree для задачі: парсить `<branch> <опис>`, детектить існуючу
- * ізоляцію (§8.1) або створює новий worktree, читає `base_commit`. Спільне для
- * `init` (Фасад A) і `run` (Фасад B).
- * @param {string[]} rest аргументи `<branch> <опис...>`
- * @param {{ run?: (cmd: string, args: string[], opts: object) => object, cwd?: string, log?: (m: string) => void }} [deps] ін'єкції
- * @returns {{ code: number, worktreeDir?: string, branch?: string, desc?: string, baseCommit?: string | null }} результат
- */
-export function ensureWorktree(rest, deps = {}) {
-  const run = deps.run ?? realRun
-  const cwd = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-
-  const branch = rest[0]
-  const desc = rest.slice(1).join(' ').trim()
-  if (!branch || !desc) {
-    log('Usage: n-cursor flow <init|run> <branch> "<опис>"')
-    return { code: 1 }
-  }
-
-  let worktreeDir
-  if (inLinkedWorktree(run, cwd)) {
-    worktreeDir = cwd
-    log(`flow: уже в worktree (${cwd}) — не вкладаю новий`)
-  } else {
-    const add = run('npx', ['@nitra/cursor', 'worktree', 'add', branch, desc], { cwd })
-    if ((add.status ?? 1) !== 0) {
-      const detail = add.stderr ? `: ${add.stderr.trim()}` : ''
-      log(`flow: worktree add не вдався${detail}`)
-      return { code: 1 }
-    }
-    worktreeDir = worktreePaths(cwd, branch).checkout
-  }
-
-  const head = run('git', ['rev-parse', 'HEAD'], { cwd: worktreeDir })
-  const baseCommit = (head.status ?? 1) === 0 ? (head.stdout ?? '').trim() : null
-  return { code: 0, worktreeDir, branch, desc, baseCommit }
-}
-
-/**
- * `flow init <branch> "<опис>"` — ізоляція + ініціалізація стану (§8.1).
- * @param {string[]} rest аргументи `<branch> <опис...>`
- * @param {{ run?: (cmd: string, args: string[], opts: object) => object, cwd?: string, log?: (m: string) => void, now?: () => number }} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-export async function init(rest, deps = {}) {
-  const ew = ensureWorktree(rest, deps)
-  if (ew.code !== 0) return ew.code
-  const now = deps.now ?? Date.now
-  const log = deps.log ?? console.error
-  const statePath = flowStatePath(ew.worktreeDir)
-  const level = detectLevel(ew.desc)
-  const risk = detectRisk(ew.desc)
-  writeState(statePath, {
-    branch: ew.branch,
-    status: 'in_progress',
-    started_at: new Date(now()).toISOString(),
-    metadata: { base_commit: ew.baseCommit },
-    level,
-    risk,
-    plan: []
-  })
-  log(`init: ${ew.branch} (level ${level}, risk ${risk}) → ${statePath}`)
-  return 0
-}
-
-/**
- * `flow verify` — проганяє Quality Gates у поточному worktree (Турнікет, §8.1).
- * На фейл друкує вивід проваленого gate. Якщо поряд є стан — записує
- * gate-результати + fingerprint. Read-only щодо коду.
- * @param {string[]} _rest аргументи (не використовуються)
- * @param {{ run?: (cmd: string, args: string[], opts: object) => { status: number, stdout: string, stderr: string }, cwd?: string, log?: (m: string) => void, fingerprint?: () => string | null }} [deps] ін'єкції
- * @returns {Promise<number>} exit code (0 — pass, 1 — fail)
- */
-export async function verify(_rest, deps = {}) {
-  const run = deps.run ?? realRun
-  const cwd0 = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-
-  // cwd-незалежний резолв активного flow. verify толерантний: без активного flow
-  // гейти все одно прогоняються (standalone) у поточному cwd, лише без запису стану.
-  const resolved = resolveActiveFlowState({ cwd: cwd0, branch: deps.branch }, deps)
-  if (resolved.statePath && resolved.autoResolved) {
-    log(`flow: авторезолвлено активний flow «${resolved.label}» (cwd поза worktree)`)
-  }
-  // Явний `--branch`, що не резолвиться, — це помилка наміру: не деградуємо тихо
-  // на поточний cwd (інакше `flow verify --branch typo` міг би «зеленіти» в CI).
-  if (deps.branch && !resolved.statePath) {
-    log(`❌ verify: ${resolved.error}`)
-    return 1
-  }
-  const cwd = resolved.worktreeDir ?? cwd0
-  const fingerprint =
-    deps.fingerprint ?? (() => worktreeFingerprint((cmd, args, opts) => spawnSync(cmd, args, { ...opts, cwd })))
-
-  const statePath = resolved.statePath
-  const state = statePath ? readState(statePath) : null
-  if (!state) {
-    // statePath null → resolved.error пояснює (нема/кілька активних); statePath є,
-    // але стан не читається → пошкоджений .flow.json. В обох випадках verify
-    // толерантний: гейти прогоняються standalone у `cwd`, без запису стану.
-    if (resolved.error) log(`⚠️ verify: ${resolved.error}`)
-    log(`⚠️ verify: активного flow не визначено — гейти прогнано у ${cwd} без запису стану`)
-  }
-  // М'які ворота: відсутній план — лише попередження, exit-код визначають gate-и.
-  if (state && !state.plan?.length) {
-    log('⚠️ verify: плану не зафіксовано (`flow plan`) — рекомендовано спершу сформувати план')
-  }
-
-  const verdict = runReview({ run, cwd, fingerprint })
-
-  for (const g of verdict.gates) {
-    log(`${g.ok ? '✅' : '❌'} gate: ${g.name}`)
-  }
-  if (!verdict.pass && verdict.failedOutput) log(verdict.failedOutput)
-  log(verdict.pass ? '✅ verify: усі gate-и пройдено' : '❌ verify: провалено')
-
-  if (state) {
-    recordTransition({ statePath, eventsPath: flowEventsPath(cwd) }, { type: 'verify', pass: verdict.pass }, state => ({
-      ...state,
-      gates: verdict.gates,
-      fingerprint: verdict.fingerprint,
-      status: verdict.pass ? state.status : 'failed'
-    }))
-  }
-
-  return verdict.pass ? 0 : 1
-}
-
-/**
- * Які з subworkspace-тек мають змінені файли — для авто-`--ws` у `release`.
- * Кожен файл відноситься до НАЙГЛИБШОГО воркспейсу-збігу, тож вкладені воркспейси
- * (`apps` + `apps/web`) не дають хибного «кілька воркспейсів» для `apps/web/x`.
- * @param {string[]} subWorkspaces теки воркспейсів без кореня (`.`)
- * @param {string[]} changedFiles змінені шляхи відносно кореня репо (posix)
- * @returns {string[]} підмножина `subWorkspaces`, під якими є зміни (у вхідному порядку)
- */
-export function matchChangedWorkspaces(subWorkspaces, changedFiles) {
-  const byDepthDesc = subWorkspaces.toSorted((a, b) => b.length - a.length)
-  const hit = new Set()
-  for (const f of changedFiles) {
-    const ws = byDepthDesc.find(w => f === w || f.startsWith(`${w}/`))
-    if (ws) hit.add(ws)
-  }
-  return subWorkspaces.filter(w => hit.has(w))
-}
-
-/**
- * Додає `--ws <шлях>` до аргументів `change`, інферячи воркспейс зі змін від
- * `base_commit`, якщо `--ws` не задано явно. Один змінений subworkspace → авто-`--ws`;
- * кілька → `{ error: true }` (fail-hard, exit 1 у release); нуль / без subworkspace →
- * лишаємо як є (change дефолтиться на `.`). Помилку самого інференсу (недосяжний base,
- * збій `listWorkspaces`) трактуємо fail-soft — не блокуємо, лишаємо дефолт.
- * @param {{ rest: string[], baseCommit: string | null, cwd: string, listWorkspaces: (cwd: string) => Promise<string[]>, changedFilesSince: (base: string | null, cwd: string) => string[], log: (m: string) => void }} input ін'єкції
- * @returns {Promise<{ args: string[], error?: boolean }>} аргументи для `change` або `{ error: true }`
- */
-async function resolveChangeWsArgs({ rest, baseCommit, cwd, listWorkspaces, changedFilesSince, log }) {
-  // Поважаємо явно заданий воркспейс в обох формах (`--ws x` і `--ws=x`).
-  if (rest.includes('--ws') || rest.some(a => a.startsWith('--ws='))) return { args: rest }
-  try {
-    const workspaces = await listWorkspaces(cwd)
-    const subWs = workspaces.filter(w => w !== '.')
-    if (subWs.length === 0) return { args: rest }
-    const hits = matchChangedWorkspaces(subWs, changedFilesSince(baseCommit, cwd))
-    if (hits.length > 1) {
-      log(`release: зміни у кількох воркспейсах (${hits.join(', ')}) — вкажи --ws явно`)
-      return { args: rest, error: true }
-    }
-    if (hits.length === 1) {
-      log(`release: change → воркспейс «${hits[0]}» (інферено з diff від base)`)
-      return { args: [...rest, '--ws', hits[0]] }
-    }
-    return { args: rest }
-  } catch (error) {
-    log(`⚠️ release: інференс воркспейсу пропущено (${error instanceof Error ? error.message : String(error)})`)
-    return { args: rest }
-  }
-}
-
-/**
- * `flow release [--bump … --section … --message …]` — генерує `.changes` і пише
- * completion snapshot (§3 Ф5, §7). Потребує наявного стану (`init`).
- * @param {string[]} rest аргументи, що прокидаються у `n-cursor change`
- * @param {{ run?: (cmd: string, args: string[], opts: object) => { status: number, stdout: string, stderr: string }, cwd?: string, log?: (m: string) => void, now?: () => number }} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-export async function release(rest, deps = {}) {
-  const run = deps.run ?? realRun
-  const cwd = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-  const now = deps.now ?? Date.now
-
-  const resolved = resolveActiveFlowState({ cwd, branch: deps.branch }, deps)
-  if (!resolved.statePath) {
-    log(`release: ${resolved.error}`)
-    return 1
-  }
-  if (resolved.autoResolved) log(`flow: авторезолвлено активний flow «${resolved.label}» (cwd поза worktree)`)
-  const effectiveCwd = resolved.worktreeDir ?? cwd
-  const statePath = resolved.statePath
-  const state = readState(statePath)
-  if (!state) {
-    log('release: стану нема — спершу `flow init`')
-    return 1
-  }
-  // М'які ворота: FAIL-гейт — лише попередження, рішення за людиною.
-  if (state.gate?.verdict === 'FAIL') {
-    log(`⚠️ release: gate = FAIL (score ${state.gate.score}) — релізиш свідомо? (див. flow gate)`)
-  }
-
-  const wsResolved = await resolveChangeWsArgs({
-    rest,
-    baseCommit: state.metadata?.base_commit ?? null,
-    cwd: effectiveCwd,
-    listWorkspaces: deps.listWorkspaces ?? getMonorepoProjectRootDirs,
-    changedFilesSince: deps.changedFilesSince ?? collectChangedFilesSince,
-    log
-  })
-  if (wsResolved.error) return 1
-
-  const ch = run('npx', ['@nitra/cursor', 'change', ...wsResolved.args], { cwd: effectiveCwd })
-  if ((ch.status ?? 1) !== 0) {
-    const detail = ch.stderr ? `: ${ch.stderr.trim()}` : ''
-    log(`release: change не вдався${detail}`)
-    return 1
-  }
-
-  const snapshot = buildCompletionSnapshot({ ...state, status: 'done' }, now)
-  recordTransition(
-    { statePath, eventsPath: flowEventsPath(effectiveCwd) },
-    { type: 'release' },
-    state_ => ({ ...state_, status: 'done', completion: snapshot }),
-    now
-  )
-  if (state.task) {
-    writeSummaryToTaskRecord(isAbsolute(state.task) ? state.task : join(effectiveCwd, state.task), snapshot)
-  }
-  log('release: done')
-  return 0
-}

package/scripts/dispatcher/lib/flow-lock.mjs

@@ -1,39 +0,0 @@
-/**
- * Серіалізація мутацій стану `flow` через **reuse** спільного `withLock`
- * (spec §4.1.3). `withLock` уже коректно чистить stale-локи (TTL +
- * `process.kill(pid,0)`) і релізить на SIGINT/SIGTERM — не дублюємо це.
- *
- * **Override для flow:** `onWaitTimeout: 'fail'` — на відміну від lint (де
- * прийнятно «після таймауту запустити без локу»), мутацію стану двома writer-ами
- * не допускаємо → fail-closed. Dedup за fingerprint вимкнено (`getFingerprint:
- * () => null`): flow завжди має виконатись, а не пропуститись за «тим самим
- * деревом».
- *
- * Лок-кеш — sibling `.worktrees/.flow-lock-<branch>/` (поряд зі станом), щоб не
- * залежати від глобального кеш-каталогу.
- */
-import { basename, dirname, isAbsolute, join } from 'node:path'
-
-import { withLock } from '../../utils/with-lock.mjs'
-
-/**
- * Виконує `runFn` під per-branch локом flow. Кидає (fail-closed), якщо лок не
- * вдалося взяти за `waitTimeout`.
- * @param {string} worktreeDir абсолютний шлях checkout (`…/.worktrees/feat-x`)
- * @param {() => unknown | Promise<unknown>} runFn критична секція
- * @param {object} [opts] прокидається у `withLock` (напр. `waitTimeout`, `pollInterval`)
- * @returns {Promise<unknown>} результат `runFn`
- */
-export function withFlowLock(worktreeDir, runFn, opts = {}) {
-  if (!isAbsolute(worktreeDir)) {
-    throw new Error(`withFlowLock: очікується абсолютний шлях (отримано: ${worktreeDir})`)
-  }
-  const base = basename(worktreeDir)
-  const cacheDir = join(dirname(worktreeDir), `.flow-lock-${base}`)
-  return withLock(`flow-${base}`, runFn, {
-    onWaitTimeout: 'fail',
-    cacheDir,
-    getFingerprint: () => null,
-    ...opts
-  })
-}

package/scripts/dispatcher/lib/gate.mjs

@@ -1,91 +0,0 @@
-/**
- * `flow gate` — структурований вердикт релізної готовності (ідея BMAD qa-gate, у
- * нашому стані). Синтезує механічні гейти `verify` (`state.gates`) і adversarial
- * findings `review` (`state.review.findings`) у єдине PASS/CONCERNS/FAIL + score
- * + причини. Дає traceability «чому готово/не готово». `gate` лише агрегує —
- * рішення verify/review не дублює.
- *
- * Уся IO (`now`) ін'єктується; `computeGate` — чиста (тестується без стану на диску).
- */
-import { cwd as processCwd } from 'node:process'
-
-import { flowEventsPath } from './events.mjs'
-import { readState, recordTransition } from './state-store.mjs'
-import { resolveActiveFlowState } from './flow-resolve.mjs'
-
-/** Штрафи score за кожен тип проблеми. */
-const PENALTY = { failedGate: 40, high: 25, med: 8, noVerify: 15 }
-
-/**
- * Чистий синтез вердикту з наявного стану.
- * @param {{ gates?: { name: string, ok: boolean }[], review?: { findings?: { severity?: string }[] } }} state стан flow
- * @returns {{ verdict: 'PASS' | 'CONCERNS' | 'FAIL', score: number, reasons: string[] }} вердикт
- */
-export function computeGate(state) {
-  const gates = state.gates ?? []
-  const findings = state.review?.findings ?? []
-  const failedGates = gates.filter(g => !g.ok)
-  const high = findings.filter(f => f.severity === 'high')
-  const med = findings.filter(f => f.severity === 'med')
-  const noVerify = gates.length === 0
-
-  const reasons = []
-  for (const g of failedGates) reasons.push(`gate «${g.name}» провалено`)
-  if (high.length > 0) reasons.push(`${high.length} high-severity review finding(s)`)
-  if (med.length > 0) reasons.push(`${med.length} med-severity review finding(s)`)
-  if (noVerify) reasons.push('verify ще не запускався')
-
-  let verdict = 'PASS'
-  if (failedGates.length > 0 || high.length > 0) {
-    verdict = 'FAIL'
-  } else if (med.length > 0 || noVerify) {
-    verdict = 'CONCERNS'
-  }
-
-  const penalty =
-    PENALTY.failedGate * failedGates.length +
-    PENALTY.high * high.length +
-    PENALTY.med * med.length +
-    (noVerify ? PENALTY.noVerify : 0)
-  const score = Math.max(0, Math.min(100, 100 - penalty))
-
-  return { verdict, score, reasons }
-}
-
-/**
- * `flow gate` — обчислює й фіксує вердикт у `.flow.json`.
- * @param {string[]} _rest аргументи (не використовуються)
- * @param {{ cwd?: string, log?: (m: string) => void, now?: () => number }} [deps] ін'єкції
- * @returns {Promise<number>} exit code (FAIL → 1; PASS/CONCERNS → 0)
- */
-export async function gate(_rest, deps = {}) {
-  const cwd0 = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-  const now = deps.now ?? Date.now
-
-  const resolved = resolveActiveFlowState({ cwd: cwd0, branch: deps.branch }, deps)
-  if (!resolved.statePath) {
-    log(`gate: ${resolved.error}`)
-    return 1
-  }
-  if (resolved.autoResolved) log(`flow: авторезолвлено активний flow «${resolved.label}» (cwd поза worktree)`)
-  const cwd = resolved.worktreeDir ?? cwd0
-  const statePath = resolved.statePath
-  const state = readState(statePath)
-  if (!state) {
-    log('gate: стану нема — спершу `flow init`')
-    return 1
-  }
-
-  const result = computeGate(state)
-  recordTransition(
-    { statePath, eventsPath: flowEventsPath(cwd) },
-    { type: 'gate', verdict: result.verdict },
-    s => ({ ...s, gate: { ...result, at: new Date(now()).toISOString() } }),
-    now
-  )
-
-  log(`gate: ${result.verdict} (score ${result.score})`)
-  for (const r of result.reasons) log(`  · ${r}`)
-  return result.verdict === 'FAIL' ? 1 : 0
-}