specflow-cc 1.18.2 → 1.18.3

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.18.3] - 2026-04-11
+
+### Fixed
+
+- **Auto-heal for users upgrading from 1.18.0 / 1.18.1** — the installer now scans `hooks.PostToolUse` during every install and removes any flat `{ type, command }` entry that references `context-monitor`. These entries were written by the buggy `1.18.0`/`1.18.1` installer and would otherwise linger in `settings.json` next to the newly written correct matcher group, still tripping Claude Code's `"Expected array, but received undefined"` parse error. Foreign flat entries (belonging to other tools) are left untouched — only entries unambiguously written by prior SpecFlow versions are removed.
+- Three new smoke tests cover clean auto-heal, preservation of foreign flat entries, and the mixed state (pre-existing correct hook + flat broken duplicate).
+
 ## [1.18.2] - 2026-04-11
 
 ### Fixed

package/bin/install.js

@@ -289,6 +289,32 @@ function finishInstall(settingsPath, settings, statuslineCommand, shouldInstallS
   if (!settings.hooks) settings.hooks = {};
   if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = [];
 
+  // Auto-heal: remove flat, broken context-monitor entries written by
+  // installer versions 1.18.0 and 1.18.1. Those versions pushed
+  // { type: "command", command: "..." } directly into PostToolUse, but
+  // Claude Code requires every PostToolUse entry to be a matcher group
+  // of shape { matcher?, hooks: [{ type, command }, ...] }. A flat entry
+  // makes Claude Code fail to parse settings.json entirely. Only entries
+  // that are unambiguously ours (flat + command references context-monitor)
+  // are removed; everything else is left untouched.
+  {
+    const before = settings.hooks.PostToolUse.length;
+    settings.hooks.PostToolUse = settings.hooks.PostToolUse.filter(entry => {
+      const isFlatBrokenMonitor =
+        entry &&
+        !Array.isArray(entry.hooks) &&
+        entry.type === 'command' &&
+        typeof entry.command === 'string' &&
+        entry.command.includes('context-monitor');
+      return !isFlatBrokenMonitor;
+    });
+    const removed = before - settings.hooks.PostToolUse.length;
+    if (removed > 0) {
+      const plural = removed === 1 ? 'y' : 'ies';
+      console.log(`  ${green}✓${reset} Repaired settings.json (removed ${removed} broken hook entr${plural} from prior install)`);
+    }
+  }
+
   // Claude Code expects each PostToolUse entry to be a matcher group:
   //   { matcher?: string, hooks: [{ type, command }, ...] }
   // Detect an existing context-monitor hook inside any matcher group.

package/package.json

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