speccrew 0.7.42 → 0.7.44

package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md

@@ -32,6 +32,15 @@ tools: Read, Write, Glob, Grep
    - API Contract template file does not exist → STOP
    - `node ... update-progress.js` script execution fails → **HARD STOP**: Do NOT manually create or edit JSON progress files. Report the script error and wait for user resolution.
 
+### Error Categories
+
+| Category | Condition | Recovery |
+|----------|-----------|----------|
+| `DEPENDENCY_MISSING` | Feature Spec document not found or empty | Ensure feature design phase completed for this feature |
+| `DEPENDENCY_MISSING` | API Contract template not found | Verify skill installation integrity |
+| `VALIDATION_ERROR` | Feature Spec missing required API sections | Review and fix feature spec content |
+| `RUNTIME_ERROR` | update-progress.js script execution failed | Check script errors; do NOT manually edit JSON |
+
 > **NOTE**: This skill does NOT include user confirmation. Confirmation is handled at the orchestrator/dispatcher level after all features are processed. This enables continuous batch execution.
 
 ## Step 1: Read Input

package/.speccrew/skills/speccrew-fd-api-contract/workflow.agentflow.xml

@@ -44,7 +44,7 @@
 
     <!-- Gateway: Validate Feature Spec exists -->
     <block type="gateway" id="G1" mode="guard" desc="Verify Feature Spec exists"
-           test="${feature_spec} != null" fail-action="stop">
+           test="${feature_spec} != null" fail-action="goto:E1">
       <field name="message">Feature Spec document not found. Check path: ${iteration_path}/02.feature-design/</field>
     </block>
 
@@ -56,7 +56,7 @@
 
     <!-- Gateway: Validate template exists -->
     <block type="gateway" id="G2" mode="guard" desc="Verify template exists"
-           test="${template_content} != null" fail-action="stop">
+           test="${template_content} != null" fail-action="goto:E2">
       <field name="message">API Contract template not found at speccrew-fd-api-contract/templates/API-CONTRACT-TEMPLATE.md</field>
     </block>
 
@@ -172,6 +172,19 @@ ${api_list.error_codes}</field>
 
   </sequence>
 
+  <!-- ============================================================
+       Error Handling Blocks
+       ============================================================ -->
+  <block type="task" id="E1" action="run-script" desc="Record error for missing Feature Spec">
+    <field name="command">node "${workspace_path}/scripts/update-progress.js" update-task --file "${dispatch_progress_path}" --task-id "${feature_id}" --status failed --error "Feature Spec document not found at: ${feature_spec_path}" --error-category "DEPENDENCY_MISSING"</field>
+    <field name="on-complete">abort</field>
+  </block>
+
+  <block type="task" id="E2" action="run-script" desc="Record error for missing API Contract template">
+    <field name="command">node "${workspace_path}/scripts/update-progress.js" update-task --file "${dispatch_progress_path}" --task-id "${feature_id}" --status failed --error "API Contract template not found at: speccrew-fd-api-contract/templates/API-CONTRACT-TEMPLATE.md" --error-category "DEPENDENCY_MISSING"</field>
+    <field name="on-complete">abort</field>
+  </block>
+
   <!-- ============================================================
        Output Results
        ============================================================ -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.7.42",
+  "version": "0.7.44",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {

package/workspace-template/scripts/update-progress.js

@@ -727,15 +727,20 @@ function cmdUpdateTask(args) {
             }
         }
 
-        // Update task
-        taskArray[taskIndex] = task;
+        // Update task (only needed for array mode; object mode is updated by reference)
+        if (taskArray && taskIndex >= 0) {
+            taskArray[taskIndex] = task;
+        }
         data.updated_at = now;
 
         // Recalculate counts
         if (isStageMode && targetStage.counts) {
             // Update stage-level counts
-            targetStage.counts = calculateCounts(taskArray);
-        } else {
+            const countSource = Array.isArray(targetStage.features)
+                ? targetStage.features
+                : Object.values(targetStage.features);
+            targetStage.counts = calculateCounts(countSource);
+        } else if (data.tasks) {
             // Update global counts
             data.counts = calculateCounts(data.tasks);
         }