@nitra/cursor 4.1.0 → 4.1.2

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

@@ -1,156 +0,0 @@
-/**
- * cwd-незалежний резолвер активного flow (беклог адаптації #1).
- *
- * Команди `spec/plan/verify/review/gate/release` мають знаходити `.flow.json`
- * поточної задачі навіть коли їх запущено НЕ з кореня worktree (напр. з головного
- * дерева чи з підтеки worktree) — інакше `flowStatePath(cwd)` обчислює хибний шлях
- * і видає «стану нема», хоча flow активний.
- *
- * Порядок (spec 2026-06-01-flow-cwd-state-resolution):
- *  1. явний `branch` → `.worktrees/<sanitizeBranch>.flow.json`;
- *  2. toplevel-резолвинг: `git rev-parse --show-toplevel` від `cwd`; якщо toplevel
- *     лежить безпосередньо під `<repoRoot>/.worktrees/` і для нього є стан — беремо;
- *  3. скан `<repoRoot>/.worktrees/*.flow.json` зі `status: in_progress`: рівно один →
- *     авторезолв; кілька → помилка зі списком; нуль → «стану нема».
- *
- * Резолвер не пише на диск. `git`/FS ін'єктуються — тестується без репозиторію.
- */
-import { existsSync, readdirSync } from 'node:fs'
-import { spawnSync } from 'node:child_process'
-import { basename, dirname, join } from 'node:path'
-import { cwd as processCwd } from 'node:process'
-
-import { sanitizeBranch, worktreePaths } from '../../lib/worktree.mjs'
-import { flowStatePath, readState as defaultReadState } from './state-store.mjs'
-
-const FLOW_STATE_SUFFIX = '.flow.json'
-
-/**
- * Реальний sync git-runner у заданому `cwd`.
- * @param {string[]} args аргументи git
- * @param {string} cwd робочий каталог
- * @returns {{ status: number, stdout: string }} результат
- */
-function realGit(args, cwd) {
-  const r = spawnSync('git', args, { encoding: 'utf8', cwd })
-  return { status: r.status ?? 1, stdout: r.stdout ?? '' }
-}
-
-/**
- * Корінь головного worktree через `git worktree list --porcelain` (перший запис).
- * @param {(args: string[]) => { status: number, stdout: string }} git git-runner
- * @returns {string | null} абсолютний шлях кореня репо або `null`
- */
-function mainRepoRoot(git) {
-  const r = git(['worktree', 'list', '--porcelain'])
-  if ((r.status ?? 1) !== 0) return null
-  const line = r.stdout.split('\n').find(l => l.startsWith('worktree '))
-  const root = line ? line.slice('worktree '.length).trim() : ''
-  return root.length > 0 ? root : null
-}
-
-/**
- * Корінь поточного worktree (`git rev-parse --show-toplevel`).
- * @param {(args: string[]) => { status: number, stdout: string }} git git-runner
- * @returns {string | null} абсолютний шлях або `null`
- */
-function currentToplevel(git) {
-  const r = git(['rev-parse', '--show-toplevel'])
-  return (r.status ?? 1) === 0 && r.stdout.trim().length > 0 ? r.stdout.trim() : null
-}
-
-/**
- * @typedef {object} ResolvedFlow
- * @property {string | null} statePath абсолютний шлях `.flow.json` або `null`
- * @property {string | null} worktreeDir тека worktree (ефективний cwd для гейтів) або `null`
- * @property {string | null} label мітка flow (sanitized branch) або `null`
- * @property {boolean} autoResolved `true`, якщо знайдено скануванням (cwd поза worktree)
- * @property {string | null} error повідомлення для логу, якщо `statePath === null`
- */
-
-/**
- * Резолвить активний flow незалежно від `cwd`.
- * @param {{ cwd?: string, branch?: string }} [params] параметри
- * @param {{ git?: (args: string[]) => { status: number, stdout: string }, exists?: (p: string) => boolean, readState?: (p: string) => object | null, readdir?: (d: string) => string[], repoRoot?: string }} [deps] ін'єкції
- * @returns {ResolvedFlow} результат
- */
-export function resolveActiveFlowState({ cwd = processCwd(), branch } = {}, deps = {}) {
-  const git = deps.git ?? (args => realGit(args, cwd))
-  const exists = deps.exists ?? existsSync
-  const readState = deps.readState ?? defaultReadState
-  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
-
-  const resolveRoot = () => deps.repoRoot ?? mainRepoRoot(git)
-
-  // 1. Явний --branch завжди перемагає. Валідуємо існування теки worktree, щоб
-  //    команда не пішла виконувати гейти в неіснуючому каталозі (ENOENT).
-  if (branch) {
-    const repoRoot = resolveRoot()
-    if (!repoRoot) return notFound('стану нема — спершу `flow init`')
-    const label = sanitizeBranch(branch)
-    const worktreeDir = worktreePaths(repoRoot, branch).checkout
-    if (!exists(worktreeDir)) {
-      return notFound(
-        `worktree для гілки «${branch}» не знайдено (${worktreeDir}) — перевір назву або зроби \`flow init\``
-      )
-    }
-    return { statePath: flowStatePath(worktreeDir), worktreeDir, label, autoResolved: false, error: null }
-  }
-
-  // 2. Швидкий шлях без git: `cwd` уже є текою worktree зі станом-sibling
-  //    (звичайний запуск із кореня worktree).
-  const direct = flowStatePath(cwd)
-  if (exists(direct)) {
-    return { statePath: direct, worktreeDir: cwd, label: basename(cwd), autoResolved: false, error: null }
-  }
-
-  // Далі потрібен корінь репо (git). Якщо недоступний — трактуємо як «стану нема».
-  const repoRoot = resolveRoot()
-  if (!repoRoot) return notFound('стану нема — спершу `flow init`')
-  const worktreesDir = join(repoRoot, '.worktrees')
-
-  // 3. Якщо ми ВСЕРЕДИНІ worktree (toplevel під .worktrees/, у т.ч. з підтеки) —
-  //    беремо стан саме цього worktree. Якщо його нема — це проблема цього worktree
-  //    (`flow init` не зроблено); чужий активний flow НЕ підтягуємо.
-  const top = currentToplevel(git)
-  if (top && dirname(top) === worktreesDir) {
-    const statePath = flowStatePath(top)
-    if (exists(statePath)) {
-      return { statePath, worktreeDir: top, label: basename(top), autoResolved: false, error: null }
-    }
-    return notFound('стану нема — спершу `flow init`')
-  }
-
-  // 4. Поза worktree (головне дерево) — скан активних flow.
-  const active = []
-  for (const name of readdir(worktreesDir)) {
-    if (!name.endsWith(FLOW_STATE_SUFFIX)) continue
-    const statePath = join(worktreesDir, name)
-    let state
-    try {
-      state = readState(statePath)
-    } catch {
-      continue // пошкоджений стан — пропускаємо при скануванні
-    }
-    if (state?.status === 'in_progress') {
-      const label = name.slice(0, -FLOW_STATE_SUFFIX.length)
-      active.push({ statePath, worktreeDir: join(worktreesDir, label), label })
-    }
-  }
-  if (active.length === 1) {
-    return { ...active[0], autoResolved: true, error: null }
-  }
-  if (active.length > 1) {
-    const list = active.map(a => `  - ${a.label}`).join('\n')
-    return notFound(`кілька активних flow — уточни \`--branch <гілка>\` або \`cd\` у потрібний worktree:\n${list}`)
-  }
-  return notFound('стану нема — спершу `flow init`')
-}
-
-/**
- * @param {string} error повідомлення
- * @returns {ResolvedFlow} результат без statePath
- */
-function notFound(error) {
-  return { statePath: null, worktreeDir: null, label: null, autoResolved: false, error }
-}

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

@@ -1,235 +0,0 @@
-/**
- * Handlers сигнальних команд `flow done/audit/failed/spawn` (думка.MD).
- *
- * Агент ніколи не знає свій абсолютний path — команди обчислюють path вузла з
- * env var `NCURSOR_NODE_PATH` (встановлюється wrapper-скриптом) або з файлу
- * `.n-cursor/current-node` у корені worktree. Якщо нічого — error.
- *
- * done    → делегує `n-cursor graph done <path>`
- * audit   → створює `pending-audit_NNN.md` → делегує `n-cursor graph audit <path>`
- * failed  → делегує `n-cursor graph failed <path>`
- * spawn   → делегує `n-cursor graph spawn <path>`
- *
- * Всі IO ін'єктуються для тестування без реальних процесів і диска.
- */
-import { spawnSync } from 'node:child_process'
-import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
-import { cwd as processCwd } from 'node:process'
-
-/**
- * Резолвить шлях вузла з env або fallback-файлу.
- * @param {{
- *   env?: Record<string, string | undefined>,
- *   cwd?: string,
- *   readFile?: (p: string, enc: string) => string,
- *   exists?: (p: string) => boolean
- * }} deps ін'єкції
- * @returns {{ nodePath: string | null, error: string | null }} результат
- */
-export function resolveNodePath(deps = {}) {
-  const env = deps.env ?? process.env
-  const cwd = deps.cwd ?? processCwd()
-  const exists = deps.exists ?? existsSync
-  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
-
-  // 1. Env var
-  const fromEnv = env['NCURSOR_NODE_PATH']
-  if (fromEnv && fromEnv.trim().length > 0) {
-    return { nodePath: fromEnv.trim(), error: null }
-  }
-
-  // 2. Fallback-файл .n-cursor/current-node у CWD (корінь worktree)
-  const fallbackPath = join(cwd, '.n-cursor', 'current-node')
-  if (exists(fallbackPath)) {
-    try {
-      const content = readFile(fallbackPath, 'utf8').trim()
-      if (content.length > 0) {
-        return { nodePath: content, error: null }
-      }
-    } catch {
-      // якщо не читається — fallthrough до error
-    }
-  }
-
-  return { nodePath: null, error: 'NCURSOR_NODE_PATH not set and .n-cursor/current-node not found' }
-}
-
-/**
- * Знаходить поточний найбільший номер `outputs_NNN.md`.
- * @param {string} dir директорія вузла
- * @param {(dir: string) => string[]} readdir ін'єктована readdir
- * @returns {string | null} рядок типу `001` або null якщо не знайдено
- */
-function findCurrentOutputsNum(dir, readdir) {
-  const files = readdir(dir)
-  let max = -1
-  for (const f of files) {
-    const m = f.match(/^outputs_(\d+)\.md$/)
-    if (m) {
-      const n = parseInt(m[1], 10)
-      if (n > max) max = n
-    }
-  }
-  return max >= 0 ? String(max).padStart(3, '0') : null
-}
-
-/**
- * Виконує n-cursor graph <sub> <nodePath>.
- * @param {string} sub підкоманда graph
- * @param {string} nodePath шлях вузла
- * @param {{
- *   run: (cmd: string, args: string[]) => { status: number, stdout: string, stderr: string }
- * }} deps
- * @returns {number} exit code
- */
-function delegateToGraph(sub, nodePath, deps) {
-  const result = deps.run('npx', ['@nitra/cursor', 'graph', sub, nodePath])
-  return result.status ?? 1
-}
-
-/**
- * Реальний sync-runner процесу.
- * @param {string} cmd
- * @param {string[]} args
- * @returns {{ status: number, stdout: string, stderr: string }}
- */
-function realRun(cmd, args) {
-  const r = spawnSync(cmd, args, { encoding: 'utf8' })
-  return { status: r.status ?? 1, stdout: r.stdout ?? '', stderr: r.stderr ?? '' }
-}
-
-/**
- * Базовий handler для сигнальних команд без аудиту.
- * @param {string} sub підкоманда graph
- * @param {{
- *   cwd?: string,
- *   env?: Record<string, string | undefined>,
- *   log?: (m: string) => void,
- *   run?: (cmd: string, args: string[]) => { status: number, stdout: string, stderr: string },
- *   readFile?: (p: string, enc: string) => string,
- *   exists?: (p: string) => boolean
- * }} deps ін'єкції
- * @returns {Promise<number>} exit code
- */
-async function signalHandler(sub, deps = {}) {
-  const cwd = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-  const run = deps.run ?? realRun
-
-  const { nodePath, error } = resolveNodePath({ env: deps.env, cwd, readFile: deps.readFile, exists: deps.exists })
-  if (!nodePath) {
-    log(`flow ${sub}: ${error}`)
-    return 1
-  }
-
-  log(`flow ${sub}: node path = ${nodePath}`)
-  const code = delegateToGraph(sub, nodePath, { run })
-  if (code !== 0) {
-    log(`flow ${sub}: graph ${sub} завершився з кодом ${code}`)
-  }
-  return code
-}
-
-/**
- * `flow done` — сигналізує успіх → `graph done <path>`.
- * @param {string[]} _rest аргументи (не використовуються)
- * @param {object} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-export async function done(_rest, deps = {}) {
-  return signalHandler('done', deps)
-}
-
-/**
- * `flow failed` — сигналізує провал → `graph failed <path>`.
- * @param {string[]} _rest аргументи (не використовуються)
- * @param {object} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-export async function failed(_rest, deps = {}) {
-  return signalHandler('failed', deps)
-}
-
-/**
- * `flow spawn` — сигналізує розклад → `graph spawn <path>`.
- * @param {string[]} _rest аргументи (не використовуються)
- * @param {object} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-export async function spawn(_rest, deps = {}) {
-  return signalHandler('spawn', deps)
-}
-
-/**
- * `flow audit` — створює `pending-audit_NNN.md` → `graph audit <path>`.
- *
- * NNN у `pending-audit_NNN.md` = NNN відповідного `outputs_NNN.md`.
- * Якщо outputs відсутні — error.
- *
- * @param {string[]} _rest аргументи (не використовуються)
- * @param {{
- *   cwd?: string,
- *   env?: Record<string, string | undefined>,
- *   log?: (m: string) => void,
- *   run?: (cmd: string, args: string[]) => { status: number, stdout: string, stderr: string },
- *   readFile?: (p: string, enc: string) => string,
- *   writeFile?: (p: string, content: string, enc: string) => void,
- *   readdir?: (dir: string) => string[],
- *   exists?: (p: string) => boolean,
- *   now?: () => string
- * }} [deps] ін'єкції
- * @returns {Promise<number>} exit code
- */
-export async function audit(_rest, deps = {}) {
-  const cwd = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
-  const writeFile = deps.writeFile ?? ((p, c, enc) => writeFileSync(p, c, enc))
-  const exists = deps.exists ?? existsSync
-  const nowFn = deps.now ?? (() => new Date().toISOString())
-  const run = deps.run ?? realRun
-
-  const { nodePath, error } = resolveNodePath({ env: deps.env, cwd, readFile: deps.readFile, exists })
-  if (!nodePath) {
-    log(`flow audit: ${error}`)
-    return 1
-  }
-
-  // Знаходимо поточний outputs NNN
-  const outputsNum = findCurrentOutputsNum(cwd, readdir)
-  if (!outputsNum) {
-    log('flow audit: outputs_NNN.md не знайдено — спершу напиши outputs')
-    return 1
-  }
-
-  const pendingPath = join(cwd, `pending-audit_${outputsNum}.md`)
-  if (exists(pendingPath)) {
-    log(`flow audit: ${pendingPath} вже існує — audit вже запитано для outputs_${outputsNum}.md`)
-    return 1
-  }
-
-  const content = [
-    '---',
-    `created_at: ${nowFn()}`,
-    `outputs_ref: outputs_${outputsNum}.md`,
-    `actor: agent`,
-    '---',
-    ''
-  ].join('\n')
-
-  try {
-    writeFile(pendingPath, content, 'utf8')
-  } catch (err) {
-    log(`flow audit: не вдалося записати ${pendingPath} — ${err instanceof Error ? err.message : String(err)}`)
-    return 1
-  }
-
-  log(`flow audit: ${pendingPath} створено`)
-  log(`flow audit: node path = ${nodePath}`)
-  const code = delegateToGraph('audit', nodePath, { run })
-  if (code !== 0) {
-    log(`flow audit: graph audit завершився з кодом ${code}`)
-  }
-  return code
-}

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

@@ -1,127 +0,0 @@
-/**
- * Handler `flow verify` — Stage 2 structural check (думка.MD § "flow verify").
- *
- * Перевіряє що `outputs_NNN.md` існує і непорожній у директорії поточного вузла
- * (CWD). Якщо так — виводить `## Done when` секцію з `task.md` та вміст
- * `outputs_NNN.md` на stdout для агентської self-evaluation.
- *
- * exit 0 = структурно OK
- * exit 1 = структурна помилка (outputs відсутній або порожній)
- *
- * НІЯКОГО артефакту не пишеться. FS ін'єктується для тестування без диска.
- */
-import { existsSync, readdirSync, readFileSync } from 'node:fs'
-import { join } from 'node:path'
-import { cwd as processCwd } from 'node:process'
-
-const FRONT_MATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/
-const SECTION_RE = /^## (.+)$/m
-
-/**
- * Читає секцію за заголовком із markdown-файлу.
- * Повертає вміст від заголовка до наступного `## ` або кінця файлу.
- * @param {string} text вміст файлу
- * @param {string} heading заголовок без `## `
- * @returns {string | null} вміст секції (включно з рядком заголовка) або null
- */
-function extractSection(text, heading) {
-  const lines = text.split(/\r?\n/)
-  const start = lines.findIndex(l => l === `## ${heading}`)
-  if (start === -1) return null
-  const end = lines.findIndex((l, i) => i > start && SECTION_RE.test(l))
-  const section = end === -1 ? lines.slice(start) : lines.slice(start, end)
-  return section.join('\n').trimEnd()
-}
-
-/**
- * Знаходить outputs-файл з найбільшим NNN у директорії вузла.
- * @param {string[]} files список файлів директорії
- * @returns {string | null} ім'я файлу (напр. `outputs_001.md`) або null
- */
-export function findLatestOutputs(files) {
-  let max = -1
-  let best = null
-  for (const f of files) {
-    const m = f.match(/^outputs_(\d+)\.md$/)
-    if (m) {
-      const n = parseInt(m[1], 10)
-      if (n > max) {
-        max = n
-        best = f
-      }
-    }
-  }
-  return best
-}
-
-/**
- * `flow verify` handler.
- *
- * @param {string[]} _rest аргументи після `verify` (не використовуються)
- * @param {{
- *   cwd?: string,
- *   log?: (m: string) => void,
- *   readFile?: (path: string, enc: string) => string,
- *   readdir?: (dir: string) => string[],
- *   exists?: (path: string) => boolean
- * }} [deps] ін'єкції
- * @returns {Promise<number>} exit code (0=OK, 1=структурна помилка)
- */
-export async function verify(_rest, deps = {}) {
-  const cwd = deps.cwd ?? processCwd()
-  const log = deps.log ?? console.error
-  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
-  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
-  const exists = deps.exists ?? existsSync
-
-  // Перевіряємо outputs_NNN.md
-  const files = readdir(cwd)
-  const outputsName = findLatestOutputs(files)
-  if (!outputsName) {
-    log('flow verify: outputs_NNN.md не знайдено — структурна помилка')
-    return 1
-  }
-
-  const outputsPath = join(cwd, outputsName)
-  if (!exists(outputsPath)) {
-    log(`flow verify: ${outputsName} не існує — структурна помилка`)
-    return 1
-  }
-
-  let outputsContent
-  try {
-    outputsContent = readFile(outputsPath, 'utf8')
-  } catch (err) {
-    log(`flow verify: не вдалося прочитати ${outputsName} — ${err instanceof Error ? err.message : String(err)}`)
-    return 1
-  }
-
-  // Перевіряємо що файл не порожній (без front-matter — суто тіло)
-  const withoutFm = outputsContent.replace(FRONT_MATTER_RE, '').trim()
-  if (withoutFm.length === 0) {
-    log(`flow verify: ${outputsName} порожній — структурна помилка`)
-    return 1
-  }
-
-  // Виводимо Done when + outputs на stdout для агентської self-evaluation
-  const outLines = [`## verify context`, ``]
-
-  const taskPath = join(cwd, 'task.md')
-  if (exists(taskPath)) {
-    try {
-      const taskContent = readFile(taskPath, 'utf8')
-      const doneWhen = extractSection(taskContent, 'Done when')
-      if (doneWhen) {
-        outLines.push(doneWhen, '')
-      }
-    } catch {
-      // якщо task.md недоступний — не блокуємо verify
-    }
-  }
-
-  outLines.push(`### ${outputsName}`, ``, outputsContent.trimEnd())
-
-  console.log(outLines.join('\n'))
-
-  return 0
-}