agileflow 3.2.0 → 3.3.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.3.0] - 2026-02-24
+
+### Added
+- Per-agent file tracking, tmux restore, and completeness audit
+
+## [3.2.1] - 2026-02-21
+
+### Added
+- Agentic browser QA system with Playwright integration
+
 ## [3.2.0] - 2026-02-21
 
 ### Added

package/README.md

@@ -3,8 +3,8 @@
 </p>
 
 [![npm version](https://img.shields.io/npm/v/agileflow?color=brightgreen)](https://www.npmjs.com/package/agileflow)
-[![Commands](https://img.shields.io/badge/commands-98-blue)](https://docs.agileflow.projectquestorg.com/docs/commands)
-[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-83-orange)](https://docs.agileflow.projectquestorg.com/docs/agents)
+[![Commands](https://img.shields.io/badge/commands-99-blue)](https://docs.agileflow.projectquestorg.com/docs/commands)
+[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-91-orange)](https://docs.agileflow.projectquestorg.com/docs/agents)
 [![Skills](https://img.shields.io/badge/skills-dynamic-purple)](https://docs.agileflow.projectquestorg.com/docs/features/skills)
 
 **AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
@@ -54,8 +54,8 @@ Traditional project management tools create friction between planning and execut
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| [Commands](https://docs.agileflow.projectquestorg.com/docs/commands) | 98 | Slash commands for agile workflows |
-| [Agents/Experts](https://docs.agileflow.projectquestorg.com/docs/agents) | 83 | Specialized agents with self-improving knowledge bases |
+| [Commands](https://docs.agileflow.projectquestorg.com/docs/commands) | 99 | Slash commands for agile workflows |
+| [Agents/Experts](https://docs.agileflow.projectquestorg.com/docs/agents) | 91 | Specialized agents with self-improving knowledge bases |
 | [Skills](https://docs.agileflow.projectquestorg.com/docs/features/skills) | Dynamic | Generated on-demand with `/agileflow:skill:create` |
 
 ---

package/lib/feature-flags.js

@@ -11,6 +11,12 @@
 
 const fs = require('fs');
 
+/**
+ * Tools expected to be available when Agent Teams native mode is enabled.
+ * Used for feature detection and capability reporting.
+ */
+const AGENT_TEAMS_TOOLS = Object.freeze(['TeamCreate', 'SendMessage', 'ListTeams']);
+
 // Lazy-load paths to avoid circular dependency issues
 let _paths;
 function getPaths() {
@@ -67,6 +73,24 @@ function getAgentTeamsMode(options = {}) {
   return 'native';
 }
 
+/**
+ * Get the list of Agent Teams tools available in the current environment.
+ *
+ * When Agent Teams is enabled (native mode), returns the expected tool names.
+ * When disabled, returns an empty array.
+ *
+ * @param {object} [options] - Options
+ * @param {string} [options.rootDir] - Project root directory
+ * @param {object} [options.metadata] - Pre-loaded metadata
+ * @returns {string[]} Array of available tool names
+ */
+function getAvailableTools(options = {}) {
+  if (!isAgentTeamsEnabled(options)) {
+    return [];
+  }
+  return [...AGENT_TEAMS_TOOLS];
+}
+
 /**
  * Get all feature flags as an object.
  *
@@ -77,10 +101,12 @@ function getAgentTeamsMode(options = {}) {
  */
 function getFeatureFlags(options = {}) {
   const metadata = options.metadata || loadMetadataSafe(options.rootDir);
+  const opts = { ...options, metadata };
 
   return {
-    agentTeams: isAgentTeamsEnabled({ ...options, metadata }),
-    agentTeamsMode: getAgentTeamsMode({ ...options, metadata }),
+    agentTeams: isAgentTeamsEnabled(opts),
+    agentTeamsMode: getAgentTeamsMode(opts),
+    availableTools: getAvailableTools(opts),
   };
 }
 
@@ -93,12 +119,12 @@ function getFeatureFlags(options = {}) {
  */
 function getAgentTeamsDisplayInfo(options = {}) {
   const enabled = isAgentTeamsEnabled(options);
-  const mode = getAgentTeamsMode(options);
 
   if (enabled) {
+    const tools = getAvailableTools(options);
     return {
       label: 'Agent Teams',
-      value: 'ENABLED (native)',
+      value: `ENABLED (native, ${tools.length} tools)`,
       status: 'enabled',
     };
   }
@@ -136,8 +162,10 @@ function loadMetadataSafe(rootDir) {
 }
 
 module.exports = {
+  AGENT_TEAMS_TOOLS,
   isAgentTeamsEnabled,
   getAgentTeamsMode,
+  getAvailableTools,
   getFeatureFlags,
   getAgentTeamsDisplayInfo,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/scripts/babysit-clear-restore.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+/**
+ * babysit-clear-restore.js - SessionStart hook for babysit context preservation
+ *
+ * When context is cleared (e.g., after plan approval), this hook:
+ * 1. Detects source="clear" from Claude Code's SessionStart event
+ * 2. Checks if /babysit is active in session-state.json
+ * 3. If both, outputs the COMPACT_SUMMARY from the babysit command file
+ * 4. Sets last_precompact_at so the welcome script preserves active_commands
+ *
+ * This eliminates the need to manually embed babysit rules in plan files (Rule #6).
+ * The hook automatically injects the rules into the fresh context after clear.
+ *
+ * Exit codes:
+ *   0 = Success (always - SessionStart hooks should never block)
+ *
+ * Input: JSON on stdin with { source: "startup"|"resume"|"clear"|"compact", ... }
+ * Output: Babysit compact summary to stdout (appears as system-reminder)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const STDIN_TIMEOUT_MS = 3000;
+
+function findProjectRoot() {
+  let dir = process.cwd();
+  while (dir !== '/') {
+    if (fs.existsSync(path.join(dir, '.agileflow'))) return dir;
+    if (fs.existsSync(path.join(dir, 'docs', '09-agents'))) return dir;
+    dir = path.dirname(dir);
+  }
+  return process.cwd();
+}
+
+const ROOT = findProjectRoot();
+
+function getSessionState() {
+  const statePath = path.join(ROOT, 'docs', '09-agents', 'session-state.json');
+  try {
+    if (fs.existsSync(statePath)) {
+      return JSON.parse(fs.readFileSync(statePath, 'utf8'));
+    }
+  } catch (e) {
+    // Silently fail
+  }
+  return null;
+}
+
+function isBabysitActive(state) {
+  if (!state) return false;
+  const activeCommands = state.active_commands || [];
+  return activeCommands.some(cmd => cmd.name === 'babysit');
+}
+
+function setPrecompactTimestamp(state) {
+  const statePath = path.join(ROOT, 'docs', '09-agents', 'session-state.json');
+  try {
+    state.last_precompact_at = new Date().toISOString();
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2) + '\n');
+  } catch (e) {
+    // Silently fail
+  }
+}
+
+function getBabysitCompactSummary() {
+  // Search for the babysit command file in known locations
+  const locations = [
+    path.join(ROOT, 'packages', 'cli', 'src', 'core', 'commands', 'babysit.md'),
+    path.join(ROOT, '.agileflow', 'commands', 'babysit.md'),
+    path.join(ROOT, '.claude', 'commands', 'agileflow', 'babysit.md'),
+  ];
+
+  for (const filePath of locations) {
+    try {
+      if (!fs.existsSync(filePath)) continue;
+      const content = fs.readFileSync(filePath, 'utf8');
+      const match = content.match(
+        /<!-- COMPACT_SUMMARY_START[\s\S]*?-->([\s\S]*?)<!-- COMPACT_SUMMARY_END -->/
+      );
+      if (match) {
+        return match[1].trim();
+      }
+    } catch (e) {
+      // Try next location
+    }
+  }
+  return null;
+}
+
+// Read stdin for hook event data
+let inputData = '';
+
+process.stdin.setEncoding('utf8');
+
+process.stdin.on('data', chunk => {
+  inputData += chunk;
+});
+
+process.stdin.on('end', () => {
+  try {
+    const input = JSON.parse(inputData);
+    const source = input.source;
+
+    // Only act on "clear" events (context cleared after plan approval, /clear, etc.)
+    if (source !== 'clear') {
+      process.exit(0);
+      return;
+    }
+
+    const state = getSessionState();
+    if (!isBabysitActive(state)) {
+      process.exit(0);
+      return;
+    }
+
+    // Set last_precompact_at so the welcome script preserves active_commands
+    // instead of clearing them (it checks this timestamp)
+    setPrecompactTimestamp(state);
+
+    // Output the babysit compact summary
+    const summary = getBabysitCompactSummary();
+    if (summary) {
+      console.log('## ACTIVE COMMAND: /agileflow:babysit (restored after context clear)');
+      console.log('');
+      console.log(summary);
+    } else {
+      // Fallback: output minimal babysit rules if command file not found
+      console.log('## /agileflow:babysit IS ACTIVE (restored after context clear)');
+      console.log('');
+      console.log('MANDATORY RULES:');
+      console.log('1. ALWAYS end responses with AskUserQuestion tool (specific options, not text)');
+      console.log('2. Use EnterPlanMode for non-trivial tasks');
+      console.log('3. Delegate complex work to domain experts via Task tool');
+      console.log('4. Track progress with TaskCreate/TaskUpdate for multi-step work');
+      console.log(
+        '5. ALWAYS suggest logic audit post-implementation (after tests pass, make Recommended)'
+      );
+    }
+  } catch (e) {
+    // Parse failed or other error - fail open
+  }
+  process.exit(0);
+});
+
+// Handle no stdin (direct invocation or timeout)
+process.stdin.on('error', () => {
+  process.exit(0);
+});
+
+// Timeout safety - don't hang
+setTimeout(() => {
+  process.exit(0);
+}, STDIN_TIMEOUT_MS);

package/scripts/claude-tmux.sh

@@ -112,6 +112,7 @@ WINDOWS:
   Alt+n/p          Next/previous window
   Alt+r            Rename window
   Alt+w            Close window
+  Alt+t            Reopen closed window
 
 PANES:
   Alt+d            Split side by side
@@ -308,8 +309,11 @@ configure_tmux_session() {
   # Alt+x to close current pane (with confirmation)
   tmux bind-key -n M-x confirm-before -p "Close pane? (y/n)" kill-pane
 
-  # Alt+w to close current window (with confirmation)
-  tmux bind-key -n M-w confirm-before -p "Close window? (y/n)" kill-window
+  # Alt+w to close current window (save state for Alt+T restore, then kill)
+  tmux bind-key -n M-w confirm-before -p "Close window? (y/n)" "run-shell '\"\$AGILEFLOW_SCRIPTS/tmux-save-closed-window.sh\"' ; kill-window"
+
+  # Alt+t to restore the most recently closed window (like Ctrl+Shift+T in browsers)
+  tmux bind-key -n M-t run-shell '"$AGILEFLOW_SCRIPTS/tmux-restore-window.sh"'
 
   # Alt+n/p for next/previous window
   tmux bind-key -n M-n next-window
@@ -335,7 +339,7 @@ configure_tmux_session() {
 
   # ─── Help Panel ──────────────────────────────────────────────────────────
   # Alt+h to show all Alt keybindings in a popup
-  tmux bind-key -n M-h display-popup -E -w 52 -h 30 "\
+  tmux bind-key -n M-h display-popup -E -w 52 -h 31 "\
     printf '\\n';\
     printf '  \\033[1;38;5;208mSESSIONS\\033[0m\\n';\
     printf '  Alt+s      New Claude session\\n';\
@@ -348,6 +352,7 @@ configure_tmux_session() {
     printf '  Alt+n/p    Next / previous window\\n';\
     printf '  Alt+r      Rename window\\n';\
     printf '  Alt+w      Close window\\n';\
+    printf '  Alt+t      Reopen closed window\\n';\
     printf '\\n';\
     printf '  \\033[1;38;5;208mPANES\\033[0m\\n';\
     printf '  Alt+d      Split side by side\\n';\