specflow-cc 1.23.0 → 1.23.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.23.1] - 2026-05-28
+
+### Fixed
+
+- **spec-auditor could not emit its Recommendation line** (agent lacked the Bash tool, and both audit/review agents referenced a non-existent relative `bin/sf-tools.cjs` path). Granted Bash to spec-auditor and corrected both paths to the canonical `~/.claude/specflow-cc/bin/sf-tools.cjs`. Also prefixed the same latent bare-path bug in [`agents/spec-reviser.md`](agents/spec-reviser.md) (`todo next-id` / `todo reindex`) so no bare relative `bin/sf-tools.cjs` remains in any agent. Both audit/review Step 7.5 blocks now fall back to the deterministic action mapping if the shell-out fails.
+
 ## [1.23.0] - 2026-05-27
 
 ### Added

package/agents/impl-reviewer.md

@@ -289,8 +289,9 @@ Using the Critical, Major, and Minor counts determined in Step 5:
 
 1. Shell out to obtain the recommendation:
    ```
-   node bin/sf-tools.cjs recommend --source review --critical <N> --major <M> --minor <K>
+   node ~/.claude/specflow-cc/bin/sf-tools.cjs recommend --source review --critical <N> --major <M> --minor <K>
    ```
+   If the shell-out fails for any reason, derive the recommendation deterministically from the documented (critical/major/minor)→action mapping rather than omitting the line.
 
 2. Parse the JSON response: `{ "action": "...", "reason": "..." }`
 

package/agents/spec-auditor.md

@@ -1,7 +1,7 @@
 ---
 name: sf-spec-auditor
 description: Audits specifications for quality, completeness, and clarity in a fresh context
-tools: Read, Write, Glob, Grep
+tools: Read, Write, Glob, Grep, Bash
 ---
 
 <role>
@@ -776,9 +776,9 @@ Using the Critical count and Recommendations count determined in Step 5:
 
 1. Shell out to obtain the recommendation:
    ```
-   node bin/sf-tools.cjs recommend --source audit --critical <N> --minor <M>
+   node ~/.claude/specflow-cc/bin/sf-tools.cjs recommend --source audit --critical <N> --minor <M>
    ```
-   Note: The CLI flag is `--minor` even though the auditor uses the label "Recommendations" — this is intentional for parser symmetry across audit/review sources.
+   Note: The CLI flag is `--minor` even though the auditor uses the label "Recommendations" — this is intentional for parser symmetry across audit/review sources. If the shell-out fails for any reason, derive the recommendation deterministically from the documented (critical/minor)→action mapping rather than omitting the line.
 
 2. Parse the JSON response: `{ "action": "...", "reason": "..." }`
 

package/agents/spec-reviser.md

@@ -147,7 +147,7 @@ For each deferred item:
 
 1. Generate next TODO ID:
    ```bash
-   node bin/sf-tools.cjs todo next-id --raw
+   node ~/.claude/specflow-cc/bin/sf-tools.cjs todo next-id --raw
    ```
 2. Create `.specflow/todos/TODO-{XXX}.md` using the Write tool:
    ```markdown
@@ -181,7 +181,7 @@ For each deferred item:
 4. After the loop completes (at least one TODO created), refresh the INDEX.md cache so it reflects the newly-created files:
 
 ```bash
-node bin/sf-tools.cjs todo reindex
+node ~/.claude/specflow-cc/bin/sf-tools.cjs todo reindex
 ```
 
 **Important:** Both substeps are mandatory. Every deferred item MUST produce a TODO, and if any TODO is created the reindex helper MUST run before reporting completion. Skipping the reindex leaves `.specflow/todos/INDEX.md` missing the just-created entries, which the `/sf:status` freshness check will then flag. If TODO creation fails, report the failure — do not silently skip.
@@ -253,7 +253,7 @@ Tip: `/clear` recommended — auditor needs fresh context
 - [ ] Revision Response recorded in Audit History
 - [ ] Deferred items (if any) created as individual `.specflow/todos/TODO-XXX.md` files
 - [ ] TODOs Created subsection appended to Response (if deferred items exist)
-- [ ] INDEX.md refreshed via `node bin/sf-tools.cjs todo reindex` (if any TODO was created)
+- [ ] INDEX.md refreshed via `node ~/.claude/specflow-cc/bin/sf-tools.cjs todo reindex` (if any TODO was created)
 - [ ] Frontmatter status updated
 - [ ] STATE.md updated
 - [ ] Clear summary of changes provided

package/package.json

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