@nitra/cursor 4.1.0 → 4.1.2

package/scripts/dispatcher/graph/lib/cmd-scan.mjs

@@ -0,0 +1,115 @@
+/**
+ * `n-cursor graph scan [--json]` — повний скан DAG, exit 1 якщо є failed-вузли.
+ *
+ * Обходить весь DAG, деривує стани, виводить зведення.
+ * exit 0 = все чисто (або лише needs-plan/waiting)
+ * exit 1 = є failed або pending-audit без відповіді
+ *
+ * FS ін'єктується для тестованості.
+ */
+import { execSync } from 'node:child_process'
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { cwd as processCwd } from 'node:process'
+
+import { loadConfig, resolveTasksDir } from './config.mjs'
+import { scanNodes, topoSort, areDepsResolved } from './scanner.mjs'
+import { listActiveWorktrees } from './worktree-ops.mjs'
+
+/**
+ * `graph scan [--json]` command handler.
+ * @param {string[]} args аргументи
+ * @param {{
+ *   cwd?: string,
+ *   log?: (m: string) => void,
+ *   readFile?: (p: string, enc: string) => string,
+ *   readdir?: (d: string) => string[],
+ *   exists?: (p: string) => boolean,
+ *   execSync?: (cmd: string, opts?: object) => string
+ * }} [deps] ін'єкції
+ * @returns {Promise<number>} exit code (0=clean, 1=attention)
+ */
+export async function cmdScan(args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
+  const exists = deps.exists ?? existsSync
+  const execSyncFn = deps.execSync ?? ((cmd, opts) => execSync(cmd, { ...opts, encoding: 'utf8' }))
+
+  const jsonMode = args.includes('--json')
+
+  const config = loadConfig({ root, readFile, exists })
+  const tasksDir = resolveTasksDir(config, root)
+
+  const activeWorktrees = listActiveWorktrees(root, { execSync: execSyncFn })
+
+  const allNodes = scanNodes(tasksDir, activeWorktrees, {
+    readdirSync: readdir,
+    existsSync: exists,
+    readFileSync: readFile
+  })
+
+  const sorted = topoSort(allNodes)
+
+  // Підрахунок по станах
+  const stateCounts = {}
+  for (const n of sorted) {
+    stateCounts[n.state] = (stateCounts[n.state] ?? 0) + 1
+  }
+
+  // Знаходимо проблемні вузли
+  const failed = sorted.filter(n => n.state === 'failed')
+  const pendingAudit = sorted.filter(n => n.state === 'pending-audit')
+  const needsPlan = sorted.filter(n => n.state === 'needs-plan')
+
+  // Знаходимо готові до запуску (waiting + deps resolved)
+  const nodeMap = new Map(sorted.map(n => [n.id, n]))
+  const ready = sorted.filter(n => n.state === 'waiting' && areDepsResolved(n, nodeMap))
+
+  const hasProblems = failed.length > 0
+
+  if (jsonMode) {
+    console.log(JSON.stringify({
+      ok: !hasProblems,
+      total: sorted.length,
+      counts: stateCounts,
+      failed: failed.map(n => n.path),
+      pending_audit: pendingAudit.map(n => n.path),
+      needs_plan: needsPlan.map(n => n.path),
+      ready: ready.map(n => n.path)
+    }, null, 2))
+  } else {
+    const summaryParts = Object.entries(stateCounts)
+      .map(([s, c]) => `${s}:${c}`)
+      .join(' ')
+
+    log(`scan: ${sorted.length} вузлів — ${summaryParts}`)
+
+    if (failed.length > 0) {
+      log(`\nFAILED (${failed.length}):`)
+      for (const n of failed) log(`  - ${n.path}`)
+    }
+
+    if (pendingAudit.length > 0) {
+      log(`\npending-audit (${pendingAudit.length}):`)
+      for (const n of pendingAudit) log(`  - ${n.path}`)
+    }
+
+    if (needsPlan.length > 0) {
+      log(`\nneeds-plan (${needsPlan.length}):`)
+      for (const n of needsPlan) log(`  - ${n.path}`)
+    }
+
+    if (ready.length > 0) {
+      log(`\nready to run (${ready.length}):`)
+      for (const n of ready) log(`  - ${n.path}`)
+    }
+
+    if (!hasProblems && failed.length === 0) {
+      log('\nscan: OK')
+    }
+  }
+
+  return hasProblems ? 1 : 0
+}

package/scripts/dispatcher/graph/lib/cmd-setup.mjs

@@ -0,0 +1,111 @@
+/**
+ * `n-cursor graph setup` — ініціалізація проєкту для graph task system.
+ *
+ * Створює:
+ * - .n-cursor.json з дефолтними налаштуваннями (якщо не існує)
+ * - tasks/ директорію
+ * - git hook (post-commit) для автоматичного оновлення стану (якщо є .git)
+ *
+ * FS ін'єктується для тестованості.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { cwd as processCwd } from 'node:process'
+
+import { CONFIG_DEFAULTS } from './config.mjs'
+
+/**
+ * `graph setup` command handler.
+ * @param {string[]} _args аргументи (не використовуються)
+ * @param {{
+ *   cwd?: string,
+ *   log?: (m: string) => void,
+ *   writeFile?: (p: string, c: string, enc: string) => void,
+ *   readFile?: (p: string, enc: string) => string,
+ *   exists?: (p: string) => boolean,
+ *   mkdir?: (p: string, opts?: object) => void
+ * }} [deps] ін'єкції
+ * @returns {Promise<number>} exit code
+ */
+export async function cmdSetup(_args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const writeFile = deps.writeFile ?? ((p, c, enc) => writeFileSync(p, c, enc))
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const exists = deps.exists ?? existsSync
+  const mkdir = deps.mkdir ?? ((p, opts) => mkdirSync(p, opts))
+
+  // 1. Створюємо .n-cursor.json якщо не існує
+  const configPath = join(root, '.n-cursor.json')
+  if (!exists(configPath)) {
+    try {
+      writeFile(configPath, JSON.stringify(CONFIG_DEFAULTS, null, 2) + '\n', 'utf8')
+      log(`setup: створено ${configPath}`)
+    } catch (err) {
+      log(`setup: не вдалося створити ${configPath} — ${err.message ?? String(err)}`)
+      return 1
+    }
+  } else {
+    log(`setup: ${configPath} вже існує — пропускаємо`)
+  }
+
+  // 2. Створюємо tasks/ директорію
+  const tasksDir = join(root, 'tasks')
+  if (!exists(tasksDir)) {
+    try {
+      mkdir(tasksDir, { recursive: true })
+      log(`setup: створено ${tasksDir}`)
+    } catch (err) {
+      log(`setup: не вдалося створити ${tasksDir} — ${err.message ?? String(err)}`)
+      return 1
+    }
+  } else {
+    log(`setup: ${tasksDir} вже існує — пропускаємо`)
+  }
+
+  // 3. Створюємо .n-cursor/ директорію
+  const ncursorDir = join(root, '.n-cursor')
+  if (!exists(ncursorDir)) {
+    try {
+      mkdir(ncursorDir, { recursive: true })
+      log(`setup: створено ${ncursorDir}`)
+    } catch (err) {
+      log(`setup: не вдалося створити ${ncursorDir} — ${err.message ?? String(err)}`)
+      return 1
+    }
+  }
+
+  // 4. Перевіряємо чи є .git і додаємо hook
+  const gitDir = join(root, '.git')
+  if (exists(gitDir)) {
+    const hooksDir = join(gitDir, 'hooks')
+    try {
+      mkdir(hooksDir, { recursive: true })
+    } catch {
+      // hooks/ може вже існувати
+    }
+
+    const hookPath = join(hooksDir, 'post-commit')
+    if (!exists(hookPath)) {
+      const hookContent = [
+        '#!/bin/sh',
+        '# n-cursor graph: automatic state refresh after commit',
+        'npx @nitra/cursor graph scan --json > /dev/null 2>&1 || true',
+        ''
+      ].join('\n')
+      try {
+        writeFile(hookPath, hookContent, 'utf8')
+        // chmod +x через окрему команду не робимо — залежить від FS dep
+        log(`setup: створено git hook ${hookPath}`)
+      } catch (err) {
+        log(`setup: не вдалося створити git hook — ${err.message ?? String(err)}`)
+        // Не критично — продовжуємо
+      }
+    } else {
+      log(`setup: git hook ${hookPath} вже існує — пропускаємо`)
+    }
+  }
+
+  log('setup: готово')
+  return 0
+}

package/scripts/dispatcher/graph/lib/cmd-signals.mjs

@@ -0,0 +1,328 @@
+/**
+ * Сигнальні команди: `done`, `audit`, `failed`, `spawn`.
+ *
+ * Ці команди викликаються зсередини worktree (агентом або скриптом),
+ * або зовні через `n-cursor graph done|audit|failed|spawn <path>`.
+ *
+ * done    → записує run_NNN.md (result:success), мерджить worktree
+ * audit   → знаходить latest fact_NNN.md, створює pending-audit_NNN.md,
+ *            записує run_NNN.md, мерджить worktree
+ * failed  → записує run_NNN.md (result:failed), залишає worktree
+ * spawn   → перевіряє що дочірні вузли зареєстровані (мають task.md)
+ *
+ * FS і child_process ін'єктуються для тестованості.
+ */
+import { execSync } from 'node:child_process'
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { cwd as processCwd } from 'node:process'
+
+import { buildMarkdown } from './frontmatter.mjs'
+import { latestFactNNN, nextRunNNN } from './nnn.mjs'
+import { loadConfig, resolveTasksDir, resolveWorktreesDir } from './config.mjs'
+import { findNodeWorktree, listActiveWorktrees, mergeWorktree } from './worktree-ops.mjs'
+
+/**
+ * Пише run_NNN.md артефакт.
+ * @param {string} nodeDir директорія вузла
+ * @param {string} nnn NNN рядок
+ * @param {'success'|'failed'} result результат
+ * @param {{ actor: string, now: string }} meta метадані
+ * @param {(p: string, c: string, enc: string) => void} writeFile функція запису
+ */
+function writeRunFile(nodeDir, nnn, result, meta, writeFile) {
+  const fm = {
+    created_at: meta.now,
+    actor: meta.actor,
+    result
+  }
+  const content = buildMarkdown(fm, `## Run ${nnn}\n\nactor: ${meta.actor}\nresult: ${result}\n`)
+  writeFile(join(nodeDir, `run_${nnn}.md`), content, 'utf8')
+}
+
+/**
+ * Резолвить шлях вузла з аргументів або env/fallback-файлу.
+ * @param {string[]} args аргументи командного рядка
+ * @param {{ env?: Record<string, string>, cwd?: string, exists?: (p: string) => boolean, readFile?: (p: string, enc: string) => string }} deps ін'єкції
+ * @returns {{ nodePath: string | null, error: string | null }} результат
+ */
+function resolveNodePath(args, deps) {
+  // 1. Прямий аргумент
+  if (args[0] && !args[0].startsWith('-')) {
+    return { nodePath: args[0], error: null }
+  }
+
+  // 2. ENV var
+  const env = deps.env ?? process.env
+  const fromEnv = env['NCURSOR_NODE_PATH']
+  if (fromEnv?.trim()) {
+    return { nodePath: fromEnv.trim(), error: null }
+  }
+
+  // 3. Fallback файл .n-cursor/current-node
+  const cwd = deps.cwd ?? processCwd()
+  const exists = deps.exists ?? existsSync
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  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 {
+      // пропускаємо
+    }
+  }
+
+  return { nodePath: null, error: 'NCURSOR_NODE_PATH not set and .n-cursor/current-node not found' }
+}
+
+/**
+ * `graph done <path>` — успіх → пише run_NNN.md (success), мерджить worktree.
+ * @param {string[]} args аргументи
+ * @param {object} [deps] ін'єкції
+ * @returns {Promise<number>} exit code
+ */
+export async function cmdDone(args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const writeFile = deps.writeFile ?? ((p, c, enc) => writeFileSync(p, c, enc))
+  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
+  const exists = deps.exists ?? existsSync
+  const execSyncFn = deps.execSync ?? ((cmd, o) => execSync(cmd, { ...o, encoding: 'utf8' }))
+  const nowFn = deps.now ?? (() => new Date().toISOString())
+
+  const { nodePath, error } = resolveNodePath(args, { env: deps.env, cwd: root, exists, readFile })
+  if (!nodePath) {
+    log(`done: ${error}`)
+    return 1
+  }
+
+  const config = loadConfig({ root, readFile, exists })
+  const tasksDir = resolveTasksDir(config, root)
+  const worktreesDir = resolveWorktreesDir(config, root)
+  const nodeDir = join(tasksDir, nodePath)
+
+  if (!exists(join(nodeDir, 'task.md'))) {
+    log(`done: вузол "${nodePath}" не знайдено`)
+    return 1
+  }
+
+  // Записуємо run_NNN.md
+  const nnn = nextRunNNN(nodeDir, readdir)
+  try {
+    writeRunFile(nodeDir, nnn, 'success', { actor: 'agent', now: nowFn() }, writeFile)
+    log(`done: записано run_${nnn}.md (result: success)`)
+  } catch (err) {
+    log(`done: не вдалося записати run_${nnn}.md — ${err.message ?? String(err)}`)
+    return 1
+  }
+
+  // Знаходимо і мерджимо worktree
+  const worktreePath = findNodeWorktree(nodePath, worktreesDir, {
+    readdirSync: readdir,
+    execSync: execSyncFn
+  })
+
+  if (worktreePath) {
+    const mergeResult = mergeWorktree(worktreePath, root, { execSync: execSyncFn })
+    if (!mergeResult.ok) {
+      log(`done: merge не вдався — ${mergeResult.error}`)
+      return 1
+    }
+    log(`done: worktree merged і видалено`)
+  } else {
+    log(`done: worktree не знайдено для "${nodePath}" — пропускаємо merge`)
+  }
+
+  log(`done: вузол "${nodePath}" успішно завершено`)
+  return 0
+}
+
+/**
+ * `graph audit <path>` — аудит → creates pending-audit_NNN.md, merge worktree.
+ * @param {string[]} args аргументи
+ * @param {object} [deps] ін'єкції
+ * @returns {Promise<number>} exit code
+ */
+export async function cmdAudit(args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const writeFile = deps.writeFile ?? ((p, c, enc) => writeFileSync(p, c, enc))
+  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
+  const exists = deps.exists ?? existsSync
+  const execSyncFn = deps.execSync ?? ((cmd, o) => execSync(cmd, { ...o, encoding: 'utf8' }))
+  const nowFn = deps.now ?? (() => new Date().toISOString())
+
+  const { nodePath, error } = resolveNodePath(args, { env: deps.env, cwd: root, exists, readFile })
+  if (!nodePath) {
+    log(`audit: ${error}`)
+    return 1
+  }
+
+  const config = loadConfig({ root, readFile, exists })
+  const tasksDir = resolveTasksDir(config, root)
+  const worktreesDir = resolveWorktreesDir(config, root)
+  const nodeDir = join(tasksDir, nodePath)
+
+  if (!exists(join(nodeDir, 'task.md'))) {
+    log(`audit: вузол "${nodePath}" не знайдено`)
+    return 1
+  }
+
+  // Знаходимо latest fact_NNN.md NNN
+  const factNNN = latestFactNNN(nodeDir, readdir)
+  if (!factNNN) {
+    log(`audit: fact_NNN.md не знайдено для "${nodePath}" — спершу виконайте задачу`)
+    return 1
+  }
+
+  // Створюємо pending-audit_NNN.md
+  const pendingPath = join(nodeDir, `pending-audit_${factNNN}.md`)
+  if (exists(pendingPath)) {
+    log(`audit: ${pendingPath} вже існує — audit вже запитано`)
+    return 1
+  }
+
+  const pendingContent = buildMarkdown({
+    created_at: nowFn(),
+    fact_ref: `fact_${factNNN}.md`,
+    actor: 'agent'
+  }, '')
+
+  try {
+    writeFile(pendingPath, pendingContent, 'utf8')
+    log(`audit: створено ${pendingPath}`)
+  } catch (err) {
+    log(`audit: не вдалося записати ${pendingPath} — ${err.message ?? String(err)}`)
+    return 1
+  }
+
+  // Записуємо run_NNN.md
+  const nnn = nextRunNNN(nodeDir, readdir)
+  try {
+    writeRunFile(nodeDir, nnn, 'success', { actor: 'agent', now: nowFn() }, writeFile)
+    log(`audit: записано run_${nnn}.md`)
+  } catch (err) {
+    log(`audit: не вдалося записати run_${nnn}.md — ${err.message ?? String(err)}`)
+  }
+
+  // Мерджимо worktree агента
+  const worktreePath = findNodeWorktree(nodePath, worktreesDir, {
+    readdirSync: readdir,
+    execSync: execSyncFn
+  })
+
+  if (worktreePath) {
+    const mergeResult = mergeWorktree(worktreePath, root, { execSync: execSyncFn })
+    if (!mergeResult.ok) {
+      log(`audit: merge не вдався — ${mergeResult.error}`)
+    } else {
+      log(`audit: agent worktree merged і видалено`)
+    }
+  }
+
+  log(`audit: запит аудиту для "${nodePath}" (fact_${factNNN}.md) успішно створено`)
+  return 0
+}
+
+/**
+ * `graph failed <path>` — провал → пише run_NNN.md (failed), залишає worktree.
+ * @param {string[]} args аргументи
+ * @param {object} [deps] ін'єкції
+ * @returns {Promise<number>} exit code
+ */
+export async function cmdFailed(args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const writeFile = deps.writeFile ?? ((p, c, enc) => writeFileSync(p, c, enc))
+  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
+  const exists = deps.exists ?? existsSync
+  const nowFn = deps.now ?? (() => new Date().toISOString())
+
+  const { nodePath, error } = resolveNodePath(args, { env: deps.env, cwd: root, exists, readFile })
+  if (!nodePath) {
+    log(`failed: ${error}`)
+    return 1
+  }
+
+  const config = loadConfig({ root, readFile, exists })
+  const tasksDir = resolveTasksDir(config, root)
+  const nodeDir = join(tasksDir, nodePath)
+
+  if (!exists(join(nodeDir, 'task.md'))) {
+    log(`failed: вузол "${nodePath}" не знайдено`)
+    return 1
+  }
+
+  // Записуємо run_NNN.md з result:failed
+  const nnn = nextRunNNN(nodeDir, readdir)
+  try {
+    writeRunFile(nodeDir, nnn, 'failed', { actor: 'agent', now: nowFn() }, writeFile)
+    log(`failed: записано run_${nnn}.md (result: failed)`)
+  } catch (err) {
+    log(`failed: не вдалося записати run_${nnn}.md — ${err.message ?? String(err)}`)
+    return 1
+  }
+
+  log(`failed: вузол "${nodePath}" позначено як failed — worktree збережено для діагностики`)
+  return 0
+}
+
+/**
+ * `graph spawn <path>` — composite → перевіряє що дочірні вузли зареєстровані.
+ * @param {string[]} args аргументи
+ * @param {object} [deps] ін'єкції
+ * @returns {Promise<number>} exit code
+ */
+export async function cmdSpawn(args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
+  const exists = deps.exists ?? existsSync
+
+  const { nodePath, error } = resolveNodePath(args, { env: deps.env, cwd: root, exists, readFile })
+  if (!nodePath) {
+    log(`spawn: ${error}`)
+    return 1
+  }
+
+  const config = loadConfig({ root, readFile, exists })
+  const tasksDir = resolveTasksDir(config, root)
+  const nodeDir = join(tasksDir, nodePath)
+
+  if (!exists(join(nodeDir, 'task.md'))) {
+    log(`spawn: вузол "${nodePath}" не знайдено`)
+    return 1
+  }
+
+  // Перевіряємо дочірні директорії
+  let entries
+  try {
+    entries = readdir(nodeDir)
+  } catch {
+    log(`spawn: не вдалося прочитати директорію вузла`)
+    return 1
+  }
+
+  const childDirs = entries.filter(name => {
+    if (name.startsWith('.') || name.endsWith('.md') || name.endsWith('.json')) return false
+    return exists(join(nodeDir, name, 'task.md'))
+  })
+
+  if (childDirs.length === 0) {
+    log(`spawn: вузол "${nodePath}" не має дочірніх вузлів із task.md`)
+    log(`spawn: для composite вузла треба створити дочірні директорії з task.md`)
+    return 1
+  }
+
+  log(`spawn: вузол "${nodePath}" є composite з ${childDirs.length} дочірніми вузлами:`)
+  for (const child of childDirs) {
+    log(`  - ${nodePath}/${child}`)
+  }
+
+  return 0
+}

package/scripts/dispatcher/graph/lib/cmd-status.mjs

@@ -0,0 +1,131 @@
+/**
+ * `n-cursor graph status [<path>] [--json]` — показує стан DAG вузлів.
+ *
+ * Без path — показує всі вузли. З path — лише вузол і його нащадків.
+ * --json — machine-readable JSON вивід.
+ *
+ * FS ін'єктується для тестованості.
+ */
+import { execSync } from 'node:child_process'
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { cwd as processCwd } from 'node:process'
+
+import { loadConfig, resolveTasksDir } from './config.mjs'
+import { scanNodes, topoSort } from './scanner.mjs'
+import { listActiveWorktrees } from './worktree-ops.mjs'
+
+/** Кольори для стану (ANSI). */
+const STATE_COLORS = {
+  'needs-plan': '\x1b[33m',   // жовтий
+  waiting: '\x1b[36m',         // блакитний
+  running: '\x1b[34m',         // синій
+  'pending-audit': '\x1b[35m', // фіолетовий
+  resolved: '\x1b[32m',        // зелений
+  failed: '\x1b[31m',           // червоний
+  invalidated: '\x1b[90m'      // сірий
+}
+const RESET = '\x1b[0m'
+
+/**
+ * Повертає colored рядок стану (якщо TTY).
+ * @param {string} state стан вузла
+ * @param {boolean} color чи потрібен колір
+ * @returns {string} рядок
+ */
+function colorState(state, color) {
+  if (!color) return state
+  const c = STATE_COLORS[state] ?? ''
+  return `${c}${state}${RESET}`
+}
+
+/**
+ * `graph status [<path>] [--json]` command handler.
+ * @param {string[]} args аргументи
+ * @param {{
+ *   cwd?: string,
+ *   log?: (m: string) => void,
+ *   readFile?: (p: string, enc: string) => string,
+ *   readdir?: (d: string) => string[],
+ *   exists?: (p: string) => boolean,
+ *   execSync?: (cmd: string, opts?: object) => string
+ * }} [deps] ін'єкції
+ * @returns {Promise<number>} exit code
+ */
+export async function cmdStatus(args, deps = {}) {
+  const root = deps.cwd ?? processCwd()
+  const log = deps.log ?? console.log
+  const readFile = deps.readFile ?? ((p, enc) => readFileSync(p, enc))
+  const readdir = deps.readdir ?? (d => (existsSync(d) ? readdirSync(d) : []))
+  const exists = deps.exists ?? existsSync
+  const execSyncFn = deps.execSync ?? ((cmd, opts) => execSync(cmd, { ...opts, encoding: 'utf8' }))
+
+  // Парсимо аргументи
+  let nodePath = null
+  let jsonMode = false
+
+  for (const arg of args) {
+    if (arg === '--json') jsonMode = true
+    else if (!arg.startsWith('-')) nodePath = arg
+  }
+
+  const config = loadConfig({ root, readFile, exists })
+  const tasksDir = resolveTasksDir(config, root)
+  const worktreesDir = join(root, config.worktrees_dir.startsWith('/') ? config.worktrees_dir : config.worktrees_dir.slice(2))
+
+  const activeWorktrees = listActiveWorktrees(root, { execSync: execSyncFn })
+
+  const allNodes = scanNodes(tasksDir, activeWorktrees, {
+    readdirSync: readdir,
+    existsSync: exists,
+    readFileSync: readFile
+  })
+
+  // Фільтруємо якщо є path
+  let nodes = allNodes
+  if (nodePath) {
+    nodes = allNodes.filter(n => n.path === nodePath || n.path.startsWith(nodePath + '/'))
+    if (nodes.length === 0) {
+      log(`status: вузол "${nodePath}" не знайдено`)
+      return 1
+    }
+  }
+
+  const sorted = topoSort(nodes)
+
+  if (jsonMode) {
+    console.log(JSON.stringify(sorted.map(n => ({
+      id: n.id,
+      path: n.path,
+      state: n.state,
+      deps: n.deps,
+      composite: n.composite,
+      children: n.children
+    })), null, 2))
+    return 0
+  }
+
+  // Текстовий вивід
+  const useColor = process.stdout.isTTY ?? false
+
+  // Підрахунок по станах
+  const stateCounts = {}
+  for (const n of sorted) {
+    stateCounts[n.state] = (stateCounts[n.state] ?? 0) + 1
+  }
+  const summary = Object.entries(stateCounts)
+    .map(([s, c]) => `${colorState(s, useColor)}:${c}`)
+    .join(' ')
+
+  log(`DAG tasks — ${summary}`)
+  log('')
+
+  for (const node of sorted) {
+    const indent = node.path.includes('/') ? '  '.repeat(node.path.split('/').length - 1) : ''
+    const composite = node.composite ? ' [composite]' : ''
+    const deps = node.deps.length > 0 ? ` ← [${node.deps.join(', ')}]` : ''
+    log(`${indent}${node.path} [${colorState(node.state, useColor)}]${composite}${deps}`)
+  }
+
+  return 0
+}