specweave 0.28.7 → 0.28.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.28.7",
+  "version": "0.28.9",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/specweave-done.md

@@ -487,6 +487,34 @@ Closing increment 0001-user-authentication...
 
 ### Step 5: Post-Closure Sync (AUTOMATIC)
 
+**CRITICAL**: After increment closes, the following syncs happen AUTOMATICALLY via the `post-increment-completion.sh` hook:
+
+#### 0) Sync spec.md Status (ALWAYS - v0.28.8+)
+
+**MANDATORY**: Ensures spec.md frontmatter status matches metadata.json.
+
+```
+🔄 Syncing spec.md status to 'completed'...
+✅ spec.md status updated: active → completed
+✅ Status line cache updated
+```
+
+**Why this matters**:
+- Prevents desyncs between metadata.json and spec.md
+- Ensures status line shows correct increment count
+- Maintains source-of-truth discipline
+- No need to manually run `/specweave:sync-status`
+
+**What gets synced**:
+1. spec.md YAML frontmatter `status` field → `completed`
+2. Status line cache updated via `lib/update-status-line.sh`
+
+**If you still see desync after closure**:
+```bash
+# Manual fix (should rarely be needed)
+/specweave:sync-status --fix
+```
+
 **CRITICAL**: After increment closes, automatically perform these syncs:
 
 #### A) Sync Living Docs to GitHub Project

package/plugins/specweave/hooks/post-increment-completion.sh

@@ -117,10 +117,69 @@ Increment \`$INCREMENT_ID\` has been marked as complete.
   fi
 fi
 
+# ============================================================================
+# SYNC SPEC.MD STATUS (CRITICAL - v0.28.8)
+# ============================================================================
+# PROBLEM: metadata.json is updated to "completed" but spec.md frontmatter
+# may still say "active". This causes desyncs that break status line.
+#
+# SOLUTION: Explicitly update spec.md frontmatter to match metadata.json.
+# This ensures source-of-truth discipline is maintained.
+#
+# See: Incident 2025-11-20 - metadata.json="completed" but spec.md="active"
+# See: /specweave:sync-status command for manual recovery
+
+SPEC_FILE="$INCREMENT_DIR/spec.md"
+
+if [ -f "$SPEC_FILE" ]; then
+  echo "🔄 Syncing spec.md status to 'completed'..."
+
+  # Read current status from spec.md frontmatter
+  SPEC_STATUS=$(awk '
+    BEGIN { in_frontmatter=0 }
+    /^---$/ {
+      if (in_frontmatter == 0) {
+        in_frontmatter=1; next
+      } else {
+        exit
+      }
+    }
+    in_frontmatter == 1 && /^status:/ {
+      gsub(/^status:[ \t]*/, "");
+      gsub(/["'\''']/, "");
+      print;
+      exit
+    }
+  ' "$SPEC_FILE" | tr -d '\r\n')
+
+  if [ "$SPEC_STATUS" != "completed" ]; then
+    # Update spec.md frontmatter to "completed"
+    # Use sed for atomic in-place update
+    if [[ "$(uname)" == "Darwin" ]]; then
+      # macOS sed requires different syntax
+      sed -i '' 's/^status:.*$/status: completed/' "$SPEC_FILE" 2>/dev/null || {
+        echo "⚠️  Failed to update spec.md status (non-blocking)" >&2
+      }
+    else
+      # GNU sed
+      sed -i 's/^status:.*$/status: completed/' "$SPEC_FILE" 2>/dev/null || {
+        echo "⚠️  Failed to update spec.md status (non-blocking)" >&2
+      }
+    fi
+    echo "✅ spec.md status updated: $SPEC_STATUS → completed"
+  else
+    echo "✅ spec.md status already 'completed'"
+  fi
+else
+  echo "⚠️  spec.md not found at $SPEC_FILE" >&2
+fi
+
 # Update status line cache (increment no longer open)
 HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
 
+echo "✅ Status line cache updated"
+
 # ============================================================================
 # SYNC LIVING DOCS (NEW in v0.24.0 - Critical Missing Feature)
 # ============================================================================