deepflow 0.1.54 → 0.1.56

package/bin/deepflow-auto.sh

@@ -28,11 +28,30 @@ INTERRUPTED=false
 # restarted with --resume to get a fresh context window.
 CONTEXT_THRESHOLD_PCT=50
 
-# Associative array for per-spec status tracking
-# Values: "converged", "halted", "in-progress"
-declare -A SPEC_STATUS
-# Associative array for per-spec winner slugs
-declare -A SPEC_WINNER
+# Per-spec status/winner tracking (bash 3.2 compatible, no associative arrays)
+# Uses a temp directory with one file per key.
+_SPEC_MAP_DIR=""
+_spec_map_init() {
+  if [[ -z "$_SPEC_MAP_DIR" ]]; then
+    _SPEC_MAP_DIR="$(mktemp -d "${TMPDIR:-/tmp}/deepflow-spec-map.XXXXXX")"
+  fi
+}
+_spec_set() {   # usage: _spec_set STATUS myspec converged
+  _spec_map_init
+  printf '%s' "$3" > "${_SPEC_MAP_DIR}/${1}__${2}"
+}
+_spec_get() {   # usage: _spec_get STATUS myspec [default]
+  _spec_map_init
+  local f="${_SPEC_MAP_DIR}/${1}__${2}"
+  if [[ -f "$f" ]]; then cat "$f"; else printf '%s' "${3:-}"; fi
+}
+_spec_isset() { # usage: _spec_isset STATUS myspec
+  _spec_map_init
+  [[ -f "${_SPEC_MAP_DIR}/${1}__${2}" ]]
+}
+_spec_map_cleanup() {
+  [[ -n "$_SPEC_MAP_DIR" && -d "$_SPEC_MAP_DIR" ]] && rm -rf "$_SPEC_MAP_DIR"
+}
 
 # ---------------------------------------------------------------------------
 # Logging
@@ -436,6 +455,7 @@ run_single_spike() {
   local slug="$2"
   local hypothesis="$3"
   local method="$4"
+  local spec_file="$5"
 
   local worktree_path="${PROJECT_ROOT}/.deepflow/worktrees/${spec_name}-${slug}"
   local branch_name="df/${spec_name}-${slug}"
@@ -455,6 +475,12 @@ run_single_spike() {
     }
   fi
 
+  # Extract acceptance criteria from spec (the human's judgment proxy)
+  local acceptance_criteria=""
+  if [[ -f "$spec_file" ]]; then
+    acceptance_criteria="$(sed -n '/^## Acceptance Criteria/,/^## /{ /^## Acceptance Criteria/d; /^## /d; p; }' "$spec_file")"
+  fi
+
   # Build spike prompt
   local spike_prompt
   spike_prompt="You are running a spike experiment to validate a hypothesis for spec '${spec_name}'.
@@ -465,13 +491,19 @@ Hypothesis: ${hypothesis}
 Method: ${method}
 --- END HYPOTHESIS ---
 
+--- ACCEPTANCE CRITERIA (from spec — the human's judgment proxy) ---
+${acceptance_criteria}
+--- END ACCEPTANCE CRITERIA ---
+
 Your tasks:
 1. Validate this hypothesis by implementing the minimum necessary to prove or disprove it.
+   The spike must demonstrate that the approach can satisfy the acceptance criteria above.
 2. Write an experiment file at: .deepflow/experiments/${spec_name}--${slug}--active.md
    The experiment file should contain:
    - ## Hypothesis: restate the hypothesis
    - ## Method: what you did to validate
    - ## Results: what you observed
+   - ## Criteria Check: for each acceptance criterion, can this approach satisfy it? (yes/no/unclear)
    - ## Conclusion: PASSED or FAILED with reasoning
 3. Write a result YAML file at: .deepflow/results/spike-${slug}.yaml
    The YAML must contain:
@@ -573,7 +605,7 @@ run_spikes() {
     auto_log "Spawning spike for ${slug} (hypothesis ${i}/${count})"
     echo "Spawning spike: ${slug}"
 
-    run_single_spike "$spec_name" "$slug" "$hypothesis" "$method" &
+    run_single_spike "$spec_name" "$slug" "$hypothesis" "$method" "$spec_file" &
     pids+=($!)
   done
 
@@ -875,6 +907,13 @@ $(cat "$experiment_file")
   # -----------------------------------------------------------------------
   # 2. Build selection prompt
   # -----------------------------------------------------------------------
+
+  # Extract acceptance criteria from spec (the human's judgment proxy)
+  local acceptance_criteria=""
+  if [[ -f "$spec_file" ]]; then
+    acceptance_criteria="$(sed -n '/^## Acceptance Criteria/,/^## /{ /^## Acceptance Criteria/d; /^## /d; p; }' "$spec_file")"
+  fi
+
   local selection_prompt
   selection_prompt="You are an adversarial quality judge in an autonomous development workflow.
 Your job is to compare implementation approaches for spec '${spec_name}' and select the best one — or reject all if quality is insufficient.
@@ -883,6 +922,11 @@ IMPORTANT:
 - This selection phase ALWAYS runs, even with only 1 approach. With a single approach you act as a quality gate.
 - You CAN and SHOULD reject all approaches if the quality is insufficient. Do not rubber-stamp poor work.
 - Base your judgment ONLY on the artifacts provided below. Do NOT read code files.
+- Judge each approach against the ACCEPTANCE CRITERIA below — these represent the human's intent.
+
+--- ACCEPTANCE CRITERIA (from spec) ---
+${acceptance_criteria}
+--- END ACCEPTANCE CRITERIA ---
 
 There are ${#approach_slugs[@]} approach(es) to evaluate:
 
@@ -1025,18 +1069,18 @@ generate_report() {
       all_spec_names+=("$sname")
 
       # If status was not set by the main loop, determine it now
-      if [[ -z "${SPEC_STATUS[$sname]+x}" ]]; then
+      if ! _spec_isset STATUS "$sname"; then
         # Check if winner file exists
         if [[ -f "${PROJECT_ROOT}/.deepflow/selection/${sname}-winner.json" ]]; then
-          SPEC_STATUS[$sname]="converged"
+          _spec_set STATUS "$sname" "converged"
           # Extract winner slug
           local w_slug
           w_slug="$(grep -o '"winner"[[:space:]]*:[[:space:]]*"[^"]*"' "${PROJECT_ROOT}/.deepflow/selection/${sname}-winner.json" | sed 's/.*"winner"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')" || w_slug=""
-          SPEC_WINNER[$sname]="$w_slug"
+          _spec_set WINNER "$sname" "$w_slug"
         elif [[ "$INTERRUPTED" == "true" ]]; then
-          SPEC_STATUS[$sname]="in-progress"
+          _spec_set STATUS "$sname" "in-progress"
         else
-          SPEC_STATUS[$sname]="halted"
+          _spec_set STATUS "$sname" "halted"
         fi
       fi
     done
@@ -1045,15 +1089,15 @@ generate_report() {
   # If interrupted, override any unfinished specs
   if [[ "$INTERRUPTED" == "true" ]]; then
     for sname in "${all_spec_names[@]}"; do
-      if [[ "${SPEC_STATUS[$sname]}" != "converged" ]]; then
-        SPEC_STATUS[$sname]="in-progress"
+      if [[ "$(_spec_get STATUS "$sname")" != "converged" ]]; then
+        _spec_set STATUS "$sname" "in-progress"
       fi
     done
     overall_status="in-progress"
   else
     # Determine overall status from per-spec statuses
     for sname in "${all_spec_names[@]}"; do
-      local s="${SPEC_STATUS[$sname]}"
+      local s="$(_spec_get STATUS "$sname")"
       if [[ "$s" == "halted" ]]; then
         overall_status="halted"
       elif [[ "$s" == "in-progress" ]]; then
@@ -1075,7 +1119,7 @@ generate_report() {
     # Winner info (if converged)
     if [[ "$overall_status" == "converged" ]]; then
       for sname in "${all_spec_names[@]}"; do
-        local w="${SPEC_WINNER[$sname]:-}"
+        local w="$(_spec_get WINNER "$sname")"
         if [[ -n "$w" ]]; then
           local summary=""
           local winner_file="${PROJECT_ROOT}/.deepflow/selection/${sname}-winner.json"
@@ -1092,8 +1136,8 @@ generate_report() {
     echo "| Spec | Status | Winner |"
     echo "|------|--------|--------|"
     for sname in "${all_spec_names[@]}"; do
-      local s="${SPEC_STATUS[$sname]:-unknown}"
-      local w="${SPEC_WINNER[$sname]:--}"
+      local s="$(_spec_get STATUS "$sname" "unknown")"
+      local w="$(_spec_get WINNER "$sname" "-")"
       echo "| ${sname} | ${s} | ${w} |"
     done
     echo ""
@@ -1104,7 +1148,7 @@ generate_report() {
 
     local has_changes=false
     for sname in "${all_spec_names[@]}"; do
-      local w="${SPEC_WINNER[$sname]:-}"
+      local w="$(_spec_get WINNER "$sname")"
       if [[ -n "$w" ]]; then
         has_changes=true
         local branch_name="df/${sname}-${w}"
@@ -1171,10 +1215,10 @@ run_spec_cycle() {
       auto_log "Selection accepted for ${spec_file} at cycle ${cycle}"
       echo "Selection accepted for $(basename "$spec_file") at cycle ${cycle}"
       # Track convergence
-      SPEC_STATUS[$spec_name]="converged"
+      _spec_set STATUS "$spec_name" "converged"
       local w_slug
       w_slug="$(grep -o '"winner"[[:space:]]*:[[:space:]]*"[^"]*"' "${PROJECT_ROOT}/.deepflow/selection/${spec_name}-winner.json" | sed 's/.*"winner"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')" || w_slug=""
-      SPEC_WINNER[$spec_name]="$w_slug"
+      _spec_set WINNER "$spec_name" "$w_slug"
       break
     fi
 
@@ -1183,8 +1227,8 @@ run_spec_cycle() {
   done
 
   # If we exited the loop without converging, mark as halted
-  if [[ "${SPEC_STATUS[$spec_name]:-}" != "converged" ]]; then
-    SPEC_STATUS[$spec_name]="halted"
+  if [[ "$(_spec_get STATUS "$spec_name")" != "converged" ]]; then
+    _spec_set STATUS "$spec_name" "halted"
   fi
 }
 
@@ -1257,6 +1301,7 @@ handle_signal() {
 }
 
 trap handle_signal SIGINT SIGTERM
+trap _spec_map_cleanup EXIT
 
 # Safety assertions: this script must never modify spec files or push to remotes.
 # These constraints are enforced by design — no write/push commands exist in this script.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepflow",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "description": "Stay in flow state - lightweight spec-driven task orchestration for Claude Code",
   "keywords": [
     "claude",