@nitra/cursor 3.6.0 → 3.6.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [3.6.1] - 2026-06-01
+
+### Fixed
+
+- flow: resolveArtifact обирає артефакт за mtime + пріоритетом slug гілки замість лексикографічного (spec/plan фіксували не той doc при кількох на одну дату)
+
 ## [3.6.0] - 2026-06-01
 
 ### Added

package/package.json

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

package/scripts/dispatcher/lib/artifact.mjs

@@ -6,24 +6,36 @@
  * Лінки front-matter (`spec.plan`/`plan.spec`/`plan.flow`) пише сам агент за
  * контрактом `flow.mdc` — тут лише ВЕРИФІКАЦІЯ (мутатора `trace link` нема).
  */
-import { existsSync, readdirSync } from 'node:fs'
+import { existsSync, readdirSync, statSync } from 'node:fs'
 import { join } from 'node:path'
 
 import { runTraceCli } from '../trace.mjs'
 
 /**
- * Найсвіжіший `docs/<kind>/*.md` (лексикографічно — дата у префіксі назви).
+ * Резолвить артефакт у `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) {
+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'))
-    .toSorted()
-  return md.length > 0 ? join(dir, md.at(-1)) : 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). */

package/scripts/dispatcher/lib/plan.mjs

@@ -35,7 +35,7 @@ export async function plan(rest, deps = {}) {
     log('plan: дизайн ще не зафіксовано — рекомендовано спершу `flow spec` (не блокує)')
   }
 
-  const doc = rest.find(a => a.endsWith('.md')) ?? resolveArtifact(cwd, 'plans')
+  const doc = rest.find(a => a.endsWith('.md')) ?? resolveArtifact(cwd, 'plans', state.branch)
   let steps
   if (rest.includes('--panel')) {
     let runner = deps.runner

package/scripts/dispatcher/lib/spec.mjs

@@ -48,7 +48,7 @@ export async function spec(rest, deps = {}) {
     }
   }
 
-  const doc = rest.find(a => a.endsWith('.md')) ?? resolveArtifact(cwd, 'specs')
+  const doc = rest.find(a => a.endsWith('.md')) ?? resolveArtifact(cwd, 'specs', state.branch)
   if (!doc || !existsSync(doc)) {
     log('spec: нема docs/specs/<date>-<slug>.md — спершу пройди brainstorm (див. flow.mdc)')
     return 1