specflow-cc 1.22.0 → 1.22.1

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to SpecFlow will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.22.1] - 2026-05-20
+
+### Fixed
+
+- `todo next-id` now scans `.specflow/specs/` and `.specflow/archive/` for `source: TODO-XXX` frontmatter entries, preventing reissue of retired IDs. Previously, a TODO file deleted during promotion to a spec could have its ID reassigned to an unrelated new TODO, leaving downstream `/sf:plan` unable to operate on the new TODO (it rejects the ID as "already promoted").
+
 ## [1.22.0] - 2026-05-19
 
 ### Added

package/bin/lib/todo.cjs

@@ -183,6 +183,8 @@ function cmdTodoList(cwd, raw, { showAll } = {}) {
  * Scans:
  * 1. .specflow/todos/TODO-*.md filenames using fs.readdirSync() + JS regex
  * 2. .specflow/todos/TODO.md for legacy IDs using fs.readFileSync() + /TODO-(\d+)/g
+ * 3. .specflow/specs/*.md and .specflow/archive/*.md for `source: TODO-XXX`
+ *    frontmatter entries (retired IDs from promoted TODOs).
  *
  * NOTE: Does NOT use grep -oP (GNU-only, unavailable on macOS).
  *
@@ -222,6 +224,31 @@ function cmdTodoNextId(cwd, raw) {
     // file may not exist — skip
   }
 
+  // Scan promoted-spec frontmatter for retired TODO IDs.
+  // On promotion, the source TODO file is deleted; the only surviving
+  // record is `source: TODO-XXX` in the spec's frontmatter. Without this
+  // scan, next-id can reissue a retired ID and downstream `/sf:plan` will
+  // reject the new TODO because the archive still records the old promotion.
+  for (const sub of ['specs', 'archive']) {
+    const dir = path.join(cwd, '.specflow', sub);
+    let files;
+    try {
+      files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
+    } catch (e) { continue; }
+    for (const file of files) {
+      let content;
+      try {
+        content = fs.readFileSync(path.join(dir, file), 'utf8');
+      } catch (e) { continue; }
+      const regex = /(?:^|\n)source:\s*TODO-(\d+)/g;
+      let match;
+      while ((match = regex.exec(content)) !== null) {
+        const num = parseInt(match[1], 10);
+        if (num > maxNum) maxNum = num;
+      }
+    }
+  }
+
   const nextNumber = maxNum + 1;
   const nextId = 'TODO-' + String(nextNumber).padStart(3, '0');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specflow-cc",
-  "version": "1.22.0",
+  "version": "1.22.1",
   "description": "Spec-driven development system for Claude Code — quality-first workflow with explicit audit cycles",
   "bin": {
     "specflow-cc": "bin/install.js"