specflow-cc 1.17.0 → 1.17.1

package/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.17.1] - 2026-04-07
+
+### Fixed
+
+- **TODO.md data loss prevention** — all 6 commands that modify TODO.md now use the `Edit` tool (targeted diff) instead of `Write` (full rewrite), preventing the agent from accidentally dropping entries when reconstructing large files
+  - Affected: `sf:todo`, `sf:plan`, `sf:done`, `sf:triage`, `sf:priority`, `spec-reviser`
+  - `Write` is now only used for initial TODO.md creation; all subsequent modifications use `Edit`
+  - Each command includes explicit "CRITICAL: never rewrite the entire file" guardrails
+
 ## [1.17.0] - 2026-03-29
 
 ### Added

package/agents/spec-reviser.md

@@ -1,7 +1,7 @@
 ---
 name: sf-spec-reviser
 description: Revises specifications based on audit feedback, applying targeted or full changes
-tools: Read, Write, Glob, Grep, AskUserQuestion
+tools: Read, Write, Edit, Glob, Grep, AskUserQuestion
 ---
 
 <role>
@@ -150,7 +150,7 @@ For each deferred item:
    - **Priority:** —
    - **Notes:** `Origin: {SPEC-XXX} Response v{N}. {reason for deferral}`
 
-4. Insert the new entry into `.specflow/todos/TODO.md` after the `# To-Do List` line
+4. Use the **Edit** tool (NOT Write) to insert the new entry into `.specflow/todos/TODO.md` after the first `---` following `# To-Do List` — never rewrite the entire file, as this would destroy existing todos
 
 5. Append a "TODOs Created" subsection to the Response in Audit History:
 

package/commands/sf/done.md

@@ -4,6 +4,7 @@ description: Finalize specification, archive, and update state
 allowed-tools:
   - Read
   - Write
+  - Edit
   - Bash
   - Glob
   - Grep
@@ -278,9 +279,10 @@ Check if the spec frontmatter contains a `source:` field (e.g., `source: TODO-00
 
 1. Read `.specflow/todos/TODO.md`
 2. Check if the referenced TODO-XXX entry still exists in the file
-3. **If it exists** — remove it (the entire block from `## TODO-XXX` heading through the next `---` separator, inclusive)
-4. Update `*Last updated:` timestamp with note: `TODO-XXX cleaned up (completed via SPEC-YYY)`
-5. Write the updated TODO.md
+3. **If it exists** — use the **Edit** tool (NOT Write) to remove the entire block (from `## TODO-XXX` heading through the next `---` separator, inclusive) — replace with empty string
+4. Use the **Edit** tool to update `*Last updated:` timestamp with note: `TODO-XXX cleaned up (completed via SPEC-YYY)`
+
+**CRITICAL:** Never rewrite the entire file with Write. Use Edit to remove the specific block and update the timestamp — this preserves all other todos.
 
 **If no `source:` field or TODO already removed:** Skip — no action needed.
 

package/commands/sf/plan.md

@@ -4,6 +4,7 @@ description: Convert a to-do item into a full specification
 allowed-tools:
   - Read
   - Write
+  - Edit
   - Bash
   - Glob
   - Grep
@@ -152,10 +153,11 @@ Use the priority from the todo as the spec's initial priority.
 **This step is MANDATORY. Do NOT skip it after the agent returns.**
 
 1. Read `.specflow/todos/TODO.md`
-2. Remove the entire todo block (from `## TODO-XXX` heading through the next `---` separator, inclusive)
-3. Update `*Last updated:` timestamp with note: `TODO-XXX converted to SPEC-YYY`
-4. Write the updated TODO.md
-5. **Verify** by reading TODO.md again — the converted todo MUST NOT appear
+2. Use the **Edit** tool (NOT Write) to remove the entire todo block (from `## TODO-XXX` heading through the next `---` separator, inclusive) — replace the block with empty string
+3. Use the **Edit** tool to update `*Last updated:` timestamp with note: `TODO-XXX converted to SPEC-YYY`
+4. **Verify** by reading TODO.md again — the converted todo MUST NOT appear
+
+**CRITICAL:** Never rewrite the entire file with Write. Use Edit to remove the specific block and update the timestamp — this preserves all other todos.
 
 **Important:** Only remove after confirmed spec creation.
 

package/commands/sf/priority.md

@@ -4,6 +4,7 @@ description: Interactive prioritization of specifications and to-dos
 allowed-tools:
   - Read
   - Write
+  - Edit
   - Bash
   - Glob
   - AskUserQuestion
@@ -117,7 +118,7 @@ Your choice:
 If input matches pattern `{ID}={priority}`:
 
 1. Validate priority (high | medium | low)
-2. Update frontmatter in spec file OR priority line in TODO.md
+2. Update frontmatter in spec file OR use the **Edit** tool (NOT Write) to update the priority line in TODO.md — never rewrite the entire file
 3. Display confirmation
 4. Return to Step 3
 

package/commands/sf/todo.md

@@ -4,6 +4,7 @@ description: Add a new to-do item for future work
 allowed-tools:
   - Read
   - Write
+  - Edit
   - Bash
   - AskUserQuestion
 ---
@@ -84,7 +85,9 @@ Create from template:
 ```
 
 **If TODO.md exists:**
-Insert new todo after `# To-Do List` line:
+Use the **Edit** tool (NOT Write) to make two targeted edits:
+
+1. Insert new todo block after the first `---` following `# To-Do List`:
 
 ```markdown
 ## TODO-{XXX} — {YYYY-MM-DD}
@@ -95,7 +98,9 @@ Insert new todo after `# To-Do List` line:
 ---
 ```
 
-Also update `*Last updated:` line at the bottom.
+2. Update the `*Last updated:` line at the bottom.
+
+**CRITICAL:** Never rewrite the entire file. Use Edit to insert the new block and update the timestamp — this preserves all existing todos.
 
 ## Step 6: Display Confirmation
 

package/commands/sf/triage.md

@@ -4,6 +4,7 @@ description: Convert scan findings into actionable TODO items
 allowed-tools:
   - Read
   - Write
+  - Edit
   - Bash
   - AskUserQuestion
 ---
@@ -182,7 +183,11 @@ If TODO.md doesn't exist, create with header:
 *Last updated: {YYYY-MM-DD}*
 ```
 
-If TODO.md exists, insert new entries after `# To-Do List` line and update timestamp.
+If TODO.md exists, use the **Edit** tool (NOT Write) to make two targeted edits:
+1. Insert new entries after the first `---` following `# To-Do List`
+2. Update the `*Last updated:` timestamp
+
+**CRITICAL:** Never rewrite the entire file with Write. Use Edit to insert new blocks and update the timestamp — this preserves all existing todos.
 
 ## Step 7: Display Results
 

package/package.json

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