deepflow 0.1.65 → 0.1.67

package/bin/{deepflow-auto.sh → archived/deepflow-auto.sh}

@@ -1138,70 +1138,129 @@ generate_report() {
   # Build report
   # -----------------------------------------------------------------
   {
-    # Section 1: Resultado
-    echo "## Resultado"
+    # Header
+    echo "# deepflow auto report"
     echo ""
-    echo "Status: ${overall_status}"
+    echo "**Status:** ${overall_status}  "
+    echo "**Date:** $(date -u '+%Y-%m-%d %H:%M UTC')"
     echo ""
 
-    # Winner info (if converged)
-    if [[ "$overall_status" == "converged" ]]; then
-      for sname in "${all_spec_names[@]}"; do
-        local w="$(_spec_get WINNER "$sname")"
-        if [[ -n "$w" ]]; then
-          local summary=""
-          local winner_file="${PROJECT_ROOT}/.deepflow/selection/${sname}-winner.json"
-          if [[ -f "$winner_file" ]]; then
-            summary="$(grep -o '"winner"[[:space:]]*:[[:space:]]*"[^"]*"' "$winner_file" | sed 's/.*"\([^"]*\)".*/\1/')" || summary=""
+    # Per-spec details
+    for sname in "${all_spec_names[@]}"; do
+      local s="$(_spec_get STATUS "$sname" "unknown")"
+      local w="$(_spec_get WINNER "$sname")"
+
+      echo "---"
+      echo ""
+      echo "## ${sname}"
+      echo ""
+      echo "**Status:** ${s}"
+      if [[ -n "$w" ]]; then
+        echo "**Winner:** ${w}"
+      fi
+      echo ""
+
+      # Hypotheses
+      local hyp_file="${PROJECT_ROOT}/.deepflow/hypotheses/${sname}-cycle-0.json"
+      if [[ -f "$hyp_file" ]]; then
+        echo "### Hypotheses"
+        echo ""
+        # Parse each hypothesis slug + description
+        local slug_list hyp_list
+        slug_list="$(grep -o '"slug"[[:space:]]*:[[:space:]]*"[^"]*"' "$hyp_file" | sed 's/.*"\([^"]*\)".*/\1/')" || slug_list=""
+        hyp_list="$(grep -o '"hypothesis"[[:space:]]*:[[:space:]]*"[^"]*"' "$hyp_file" | sed 's/.*"hypothesis"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')" || hyp_list=""
+
+        paste <(echo "$slug_list") <(echo "$hyp_list") | while IFS=$'\t' read -r hslug hhyp; do
+          [[ -z "$hslug" ]] && continue
+          echo "- **${hslug}:** ${hhyp}"
+        done
+        echo ""
+      fi
+
+      # Spike results
+      local has_spikes=false
+      for wt_dir in "${PROJECT_ROOT}/.deepflow/worktrees/${sname}-"*; do
+        [[ -d "$wt_dir" ]] || continue
+        local wt_slug
+        wt_slug="$(basename "$wt_dir")"
+        wt_slug="${wt_slug#${sname}-}"
+
+        local spike_yaml="${wt_dir}/.deepflow/results/spike-${wt_slug}.yaml"
+        if [[ -f "$spike_yaml" ]]; then
+          if [[ "$has_spikes" == "false" ]]; then
+            echo "### Spike Results"
+            echo ""
+            has_spikes=true
           fi
-          echo "Winner: ${w} (spec: ${sname})"
+          local spike_status spike_summary
+          spike_status="$(grep -m1 '^status:' "$spike_yaml" | sed 's/^status:[[:space:]]*//')" || spike_status="unknown"
+          spike_summary="$(grep -m1 '^summary:' "$spike_yaml" | sed 's/^summary:[[:space:]]*//')" || spike_summary=""
+          local status_icon="✅"
+          [[ "$spike_status" =~ fail ]] && status_icon="❌"
+          echo "- ${status_icon} **${wt_slug}** — ${spike_summary}"
         fi
       done
-      echo ""
-    fi
+      if [[ "$has_spikes" == "true" ]]; then
+        echo ""
+      fi
 
-    # Per-spec status table
-    echo "| Spec | Status | Winner |"
-    echo "|------|--------|--------|"
-    for sname in "${all_spec_names[@]}"; do
-      local s="$(_spec_get STATUS "$sname" "unknown")"
-      local w="$(_spec_get WINNER "$sname" "-")"
-      echo "| ${sname} | ${s} | ${w} |"
-    done
-    echo ""
+      # Selection rationale
+      local winner_file="${PROJECT_ROOT}/.deepflow/selection/${sname}-winner.json"
+      if [[ -f "$winner_file" ]]; then
+        echo "### Selection Rationale"
+        echo ""
 
-    # Section 2: Mudancas
-    echo "## Mudancas"
-    echo ""
+        # Parse rankings from winner file
+        local rankings
+        rankings="$(node -e "
+          try {
+            const d = JSON.parse(require('fs').readFileSync('${winner_file}','utf8'));
+            if (d.selection_output && d.selection_output.rankings) {
+              d.selection_output.rankings.forEach(r => {
+                const icon = r.rank === 1 ? '🏆' : '  ';
+                console.log(icon + ' **#' + r.rank + ' ' + r.slug + ':** ' + r.rationale);
+              });
+            }
+          } catch(e) {}
+        " 2>/dev/null)" || rankings=""
+
+        if [[ -n "$rankings" ]]; then
+          echo "$rankings"
+        fi
+        echo ""
+      fi
 
-    local has_changes=false
-    for sname in "${all_spec_names[@]}"; do
-      local w="$(_spec_get WINNER "$sname")"
+      # Changes (git diff stat)
       if [[ -n "$w" ]]; then
-        has_changes=true
         local branch_name="df/${sname}-${w}"
-        echo "### ${sname} (winner: ${w})"
+        echo "### Changes"
         echo ""
         echo '```'
-        git diff --stat "main...${branch_name}" 2>/dev/null || echo "(branch ${branch_name} not found)"
+        git -C "$PROJECT_ROOT" diff --stat "main...${branch_name}" 2>/dev/null || echo "(branch ${branch_name} not found)"
         echo '```'
         echo ""
       fi
     done
-    if [[ "$has_changes" == "false" ]]; then
-      echo "No changes selected"
-      echo ""
-    fi
 
-    # Section 3: Decisoes
-    echo "## Decisoes"
+    # Next steps
+    echo "---"
     echo ""
-
-    local decisions_log="${PROJECT_ROOT}/.deepflow/auto-decisions.log"
-    if [[ -f "$decisions_log" ]]; then
-      cat "$decisions_log"
+    echo "## Next Steps"
+    echo ""
+    if [[ "$overall_status" == "converged" ]]; then
+      for sname in "${all_spec_names[@]}"; do
+        local w="$(_spec_get WINNER "$sname")"
+        if [[ -n "$w" ]]; then
+          echo "To merge the winner:"
+          echo '```bash'
+          echo "git merge df/${sname}-${w}"
+          echo '```'
+        fi
+      done
+    elif [[ "$overall_status" == "in-progress" ]]; then
+      echo "Run \`deepflow auto --continue\` to resume."
     else
-      echo "No decisions logged"
+      echo "Review the spec and run \`deepflow auto\` again."
     fi
     echo ""
   } > "$report_file"

package/bin/install.js

@@ -10,11 +10,21 @@ const os = require('os');
 const readline = require('readline');
 const { execFileSync } = require('child_process');
 
-// Subcommand routing: `deepflow auto [...]` -> bin/deepflow-auto.sh
+// Subcommand routing: `deepflow auto [...]` -> claude --agent .claude/agents/deepflow-auto.md
 if (process.argv[2] === 'auto') {
-  const scriptPath = path.join(__dirname, 'deepflow-auto.sh');
+  if (!process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS) {
+    console.error('Error: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable is not set.');
+    console.error('');
+    console.error('The `deepflow auto` command now uses Claude Code Agent Teams.');
+    console.error('To enable it, set the environment variable before running:');
+    console.error('');
+    console.error('  export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1');
+    console.error('  deepflow auto');
+    console.error('');
+    process.exit(1);
+  }
   try {
-    execFileSync('bash', [scriptPath, ...process.argv.slice(3)], { stdio: 'inherit' });
+    execFileSync('claude', ['--agent', '.claude/agents/deepflow-auto.md', ...process.argv.slice(3)], { stdio: 'inherit' });
   } catch (e) {
     process.exit(e.status || 1);
   }
@@ -150,12 +160,8 @@ async function main() {
     }
   }
 
-  // Ensure deepflow-auto.sh is executable
-  const autoScript = path.join(PACKAGE_DIR, 'bin', 'deepflow-auto.sh');
-  if (fs.existsSync(autoScript)) {
-    fs.chmodSync(autoScript, 0o755);
-    log('deepflow-auto.sh marked executable');
-  }
+  // deepflow-auto.sh has been archived; auto mode now uses Agent Teams
+  // via `claude --agent .claude/agents/deepflow-auto.md`
 
   // Get version from package.json (single source of truth)
   const packageJson = require(path.join(PACKAGE_DIR, 'package.json'));

package/hooks/df-spec-lint.js

@@ -9,6 +9,9 @@
 
 'use strict';
 
+const fs = require('fs');
+const path = require('path');
+
 // Each entry: [canonical name, ...aliases that also satisfy the requirement]
 const REQUIRED_SECTIONS = [
   ['Objective', 'overview', 'goal', 'goals', 'summary'],
@@ -27,7 +30,7 @@ const REQUIRED_SECTIONS = [
  * @param {'interactive'|'auto'} opts.mode
  * @returns {{ hard: string[], advisory: string[] }}
  */
-function validateSpec(content, { mode = 'interactive' } = {}) {
+function validateSpec(content, { mode = 'interactive', specsDir = null } = {}) {
   const hard = [];
   const advisory = [];
 
@@ -135,6 +138,24 @@ function validateSpec(content, { mode = 'interactive' } = {}) {
     advisory.push(`Too many requirements (${seenIds.size}, limit 20)`);
   }
 
+  // (adv-e) Dependencies reference existing specs
+  const depsSection = extractSection(content, 'Dependencies');
+  if (depsSection !== null) {
+    const depLines = depsSection.split('\n');
+    for (const line of depLines) {
+      const depMatch = line.match(/depends_on:\s*(.+)/);
+      if (depMatch) {
+        const specName = depMatch[1].trim();
+        if (specsDir) {
+          const specPath = path.join(specsDir, `${specName}.md`);
+          if (!fs.existsSync(specPath)) {
+            advisory.push(`Dependency not found: "${specName}" (no file specs/${specName}.md)`);
+          }
+        }
+      }
+    }
+  }
+
   // ── Auto-mode escalation ─────────────────────────────────────────────
   if (mode === 'auto') {
     hard.push(...advisory.splice(0, advisory.length));
@@ -180,8 +201,6 @@ function extractSection(content, sectionName) {
 
 // ── CLI entry point ──────────────────────────────────────────────────────
 if (require.main === module) {
-  const fs = require('fs');
-
   const filePath = process.argv[2];
   if (!filePath) {
     console.error('Usage: df-spec-lint.js <spec-file.md>');
@@ -190,7 +209,8 @@ if (require.main === module) {
 
   const content = fs.readFileSync(filePath, 'utf8');
   const mode = process.argv.includes('--auto') ? 'auto' : 'interactive';
-  const result = validateSpec(content, { mode });
+  const specsDir = path.resolve(path.dirname(filePath));
+  const result = validateSpec(content, { mode, specsDir });
 
   if (result.hard.length > 0) {
     console.error('HARD invariant failures:');

package/package.json

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

package/templates/spec-template.md

@@ -15,6 +15,11 @@
 - [Constraint 1: e.g., "Max file size 10MB"]
 - [Constraint 2: e.g., "Must work offline"]
 
+## Dependencies
+
+<!-- Optional. List specs that must be completed before this one. -->
+<!-- - depends_on: doing-other-spec-name -->
+
 ## Out of Scope
 
 - [Explicitly excluded: e.g., "Video upload is NOT included"]