agileflow 3.0.1 → 3.1.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.1.0] - 2026-02-14
+
+### Added
+- Legal audit system, native Agent Teams integration, and startup performance improvements
+
+## [3.0.2] - 2026-02-14
+
+### Added
+- Automatic tmux window naming and configuration agent consolidation
+
 ## [3.0.1] - 2026-02-13
 
 ### Fixed

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-93-blue)](docs/04-architecture/commands.md)
-[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-47-orange)](docs/04-architecture/subagents.md)
+[![Commands](https://img.shields.io/badge/commands-94-blue)](docs/04-architecture/commands.md)
+[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-55-orange)](docs/04-architecture/subagents.md)
 [![Skills](https://img.shields.io/badge/skills-dynamic-purple)](docs/04-architecture/skills.md)
 
 **AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex CLI, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
@@ -39,9 +39,9 @@ npx agileflow@latest update
 | IDE | Status | Config Location |
 |-----|--------|-----------------|
 | Claude Code | Supported | `.claude/commands/agileflow/` |
-| Cursor | Supported | `.cursor/rules/agileflow/` |
+| Cursor | Supported | `.cursor/commands/agileflow/` |
 | Windsurf | Supported | `.windsurf/workflows/agileflow/` |
-| OpenAI Codex CLI | Supported | `.codex/skills/` |
+| OpenAI Codex CLI | Supported | `.codex/skills/` and `~/.codex/prompts/` |
 
 ---
 
@@ -65,8 +65,8 @@ AgileFlow combines three proven methodologies:
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| [Commands](docs/04-architecture/commands.md) | 93 | Slash commands for agile workflows |
-| [Agents/Experts](docs/04-architecture/subagents.md) | 47 | Specialized agents with self-improving knowledge bases |
+| [Commands](docs/04-architecture/commands.md) | 94 | Slash commands for agile workflows |
+| [Agents/Experts](docs/04-architecture/subagents.md) | 55 | Specialized agents with self-improving knowledge bases |
 | [Skills](docs/04-architecture/skills.md) | Dynamic | Generated on-demand with `/agileflow:skill:create` |
 
 ---
@@ -76,8 +76,8 @@ AgileFlow combines three proven methodologies:
 Full documentation lives in [`docs/04-architecture/`](docs/04-architecture/):
 
 ### Reference
-- [Commands](docs/04-architecture/commands.md) - All 93 slash commands
-- [Agents/Experts](docs/04-architecture/subagents.md) - 47 specialized agents with self-improving knowledge
+- [Commands](docs/04-architecture/commands.md) - All 94 slash commands
+- [Agents/Experts](docs/04-architecture/subagents.md) - 55 specialized agents with self-improving knowledge
 - [Skills](docs/04-architecture/skills.md) - Dynamic skill generator with MCP integration
 
 ### Architecture

package/lib/api-server.js

@@ -71,7 +71,7 @@ class ApiCache {
  * @returns {{ server: http.Server, options: Object, cache: ApiCache }}
  */
 function createApiServer(options = {}) {
-  const port = options.port || DEFAULT_PORT;
+  const port = options.port != null ? options.port : DEFAULT_PORT;
   const host = options.host || DEFAULT_HOST;
   const rootDir = options.rootDir || getProjectRoot();
   const cacheTTL = options.cacheTTL || 2000;
@@ -238,7 +238,8 @@ function startApiServer(serverInstance) {
     });
 
     server.listen(port, host, () => {
-      const url = `http://${host}:${port}`;
+      const actualPort = server.address().port;
+      const url = `http://${host}:${actualPort}`;
       console.log(`[AgileFlow API] Server running at ${url}`);
       console.log(`[AgileFlow API] Project root: ${options.rootDir}`);
       resolve({

package/lib/feedback.js

@@ -34,7 +34,14 @@
  */
 
 const { c, BRAND_HEX } = require('./colors');
-const chalk = require('chalk');
+const { lazyRequire } = require('./lazy-require');
+
+// Lazy-load chalk: feedback.js is imported by scripts that run as hooks in
+// user projects (.agileflow/scripts/).  If chalk isn't resolvable from the
+// user's node_modules the eager require() would crash every hook that
+// imports feedback.  Deferring the require() to the single call-site that
+// actually needs chalk (brand()) avoids the crash entirely.
+const getChalk = lazyRequire('chalk');
 
 // Symbols for consistent output
 const SYMBOLS = {
@@ -182,7 +189,7 @@ class Feedback {
   brand(message) {
     if (this.quiet) return this;
     const prefix = this._indent();
-    console.log(`${prefix}${chalk.hex(BRAND_HEX)(message)}`);
+    console.log(`${prefix}${getChalk().hex(BRAND_HEX)(message)}`);
     return this;
   }
 

package/lib/flag-detection.js

@@ -219,7 +219,8 @@ function detectFromPs() {
       // Get command line for this PID
       let cmdline;
       const cmdResult = executeCommandSync('ps', ['-p', String(pid), '-o', 'args='], {
-        timeout: 1000, fallback: null,
+        timeout: 1000,
+        fallback: null,
       });
       if (!cmdResult.ok || cmdResult.data === null) break;
       cmdline = cmdResult.data;
@@ -239,7 +240,8 @@ function detectFromPs() {
 
       // Get parent PID
       const ppidResult = executeCommandSync('ps', ['-p', String(pid), '-o', 'ppid='], {
-        timeout: 1000, fallback: null,
+        timeout: 1000,
+        fallback: null,
       });
       if (!ppidResult.ok || ppidResult.data === null) break;
       pid = parseInt(ppidResult.data, 10);

package/lib/git-operations.js

@@ -176,12 +176,14 @@ function getSessionPhase(session) {
   try {
     const mainBranch = getMainBranch(sessionPath);
     const commitResult = git(['rev-list', '--count', `${mainBranch}..HEAD`], {
-      cwd: sessionPath, fallback: '0',
+      cwd: sessionPath,
+      fallback: '0',
     });
     const commits = parseInt(commitResult.data, 10);
 
     const statusResult = git(['status', '--porcelain'], {
-      cwd: sessionPath, fallback: '',
+      cwd: sessionPath,
+      fallback: '',
     });
     const status = statusResult.data;
 

package/lib/lazy-require.js

@@ -0,0 +1,59 @@
+/**
+ * lazy-require.js - Reusable Lazy-Loading Utility
+ *
+ * AgileFlow scripts are copied to user projects (.agileflow/scripts/) and run
+ * as hooks. When these scripts eagerly require() npm dependencies at module
+ * load time, they crash if the dependency isn't resolvable from the user's
+ * project directory. This utility standardizes the lazy-loading pattern used
+ * ad-hoc in yaml-utils.js and dashboard-server.js.
+ *
+ * Usage:
+ *   const { lazyRequire } = require('./lazy-require');
+ *
+ *   // Returns a getter function; require() is deferred until first call
+ *   const getChalk = lazyRequire('chalk');
+ *
+ *   // With fallback resolution paths
+ *   const getYaml = lazyRequire('js-yaml',
+ *     path.join(__dirname, '..', 'node_modules', 'js-yaml')
+ *   );
+ *
+ *   // Later, when actually needed:
+ *   const chalk = getChalk();
+ */
+
+'use strict';
+
+/**
+ * Create a lazy-loading getter for an npm module.
+ *
+ * The returned function defers require() until first invocation, then caches
+ * the result. Multiple resolution paths are tried in order, so the module can
+ * be found from the user's node_modules, AgileFlow's own node_modules, or any
+ * other location.
+ *
+ * @param {string} name - Primary module name (passed to require())
+ * @param {...string} fallbackPaths - Additional paths to try if primary fails
+ * @returns {function(): any} Getter that returns the loaded module
+ */
+function lazyRequire(name, ...fallbackPaths) {
+  let cached = null;
+  return () => {
+    if (cached) return cached;
+    const paths = [name, ...fallbackPaths];
+    for (const p of paths) {
+      try {
+        cached = require(p);
+        return cached;
+      } catch (_e) {
+        // Continue to next path
+      }
+    }
+    throw new Error(
+      `${name} not found. Run: npm install ${name}\n` +
+        'Or reinstall AgileFlow: npx agileflow setup --force'
+    );
+  };
+}
+
+module.exports = { lazyRequire };

package/lib/process-executor.js

@@ -91,13 +91,20 @@ function executeCommand(cmd, args = [], opts = {}) {
     let stderr = '';
     let timedOut = false;
 
-    const timer = timeout > 0 ? setTimeout(() => {
-      timedOut = true;
-      proc.kill('SIGTERM');
-    }, timeout) : null;
-
-    proc.stdout.on('data', chunk => { stdout += chunk; });
-    proc.stderr.on('data', chunk => { stderr += chunk; });
+    const timer =
+      timeout > 0
+        ? setTimeout(() => {
+            timedOut = true;
+            proc.kill('SIGTERM');
+          }, timeout)
+        : null;
+
+    proc.stdout.on('data', chunk => {
+      stdout += chunk;
+    });
+    proc.stderr.on('data', chunk => {
+      stderr += chunk;
+    });
 
     proc.on('error', err => {
       if (timer) clearTimeout(timer);
@@ -115,7 +122,11 @@ function executeCommand(cmd, args = [], opts = {}) {
         if (fallback !== undefined) {
           resolve({ ok: true, data: fallback });
         } else {
-          resolve({ ok: false, error: `Command timed out after ${timeout}ms: ${cmd}`, exitCode: null });
+          resolve({
+            ok: false,
+            error: `Command timed out after ${timeout}ms: ${cmd}`,
+            exitCode: null,
+          });
         }
         return;
       }
@@ -124,7 +135,11 @@ function executeCommand(cmd, args = [], opts = {}) {
         if (fallback !== undefined) {
           resolve({ ok: true, data: fallback });
         } else {
-          const result = { ok: false, error: `Command failed: ${cmd} ${args.join(' ')} (exit ${code})`, exitCode: code };
+          const result = {
+            ok: false,
+            error: `Command failed: ${cmd} ${args.join(' ')} (exit ${code})`,
+            exitCode: code,
+          };
           if (captureStderr) {
             result.stderr = trim ? stderr.trim() : stderr;
           }

package/lib/skill-loader.js

@@ -57,13 +57,21 @@ function parseSkillFrontmatter(content) {
     let value = trimmed.substring(colonIndex + 1).trim();
 
     // Remove surrounding quotes
-    if ((value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))) {
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
       value = value.slice(1, -1);
     }
 
     // Type coercion for known fields
-    if (key === 'version' || key === 'model' || key === 'category' || key === 'name' || key === 'type') {
+    if (
+      key === 'version' ||
+      key === 'model' ||
+      key === 'category' ||
+      key === 'name' ||
+      key === 'type'
+    ) {
       result.metadata[key] = value;
     } else if (value === 'true') {
       result.metadata[key] = true;

package/package.json

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

package/scripts/agileflow-configure.js

@@ -18,6 +18,7 @@
  *   --enable=<features>                 Enable specific features
  *   --disable=<features>                Disable specific features
  *   --archival-days=<N>                 Set archival threshold
+ *   --startup-mode=<MODE>              Set default startup mode (atomic)
  *   --migrate                           Fix old formats without changing features
  *   --validate                          Check for issues
  *   --detect                            Show current status
@@ -42,6 +43,7 @@ const {
   listStatuslineComponents,
   migrateSettings,
   upgradeFeatures,
+  enableStartupMode,
 } = require('./lib/configure-features');
 const { listScripts, showVersionInfo, repairScripts } = require('./lib/configure-repair');
 const { feedback } = require('../lib/feedback');
@@ -144,6 +146,7 @@ ${c.cyan}Statusline Components:${c.reset}
 
 ${c.cyan}Settings:${c.reset}
   --archival-days=N   Set archival threshold (default: 30)
+  --startup-mode=MODE Set default startup mode (skip-permissions, accept-edits, normal, no-claude)
 
 ${c.cyan}Maintenance:${c.reset}
   --migrate           Fix old/invalid formats
@@ -201,6 +204,7 @@ function main() {
   let repairFeature = null;
   let showVersion = false;
   let listScriptsMode = false;
+  let startupMode = null;
 
   args.forEach(arg => {
     if (arg.startsWith('--profile=')) profile = arg.split('=')[1];
@@ -237,6 +241,8 @@ function main() {
       repairFeature = arg.split('=')[1].trim().toLowerCase();
     } else if (arg === '--version' || arg === '-v') showVersion = true;
     else if (arg === '--list-scripts' || arg === '--scripts') listScriptsMode = true;
+    else if (arg.startsWith('--startup-mode='))
+      startupMode = arg.split('=')[1].trim().toLowerCase();
   });
 
   // Help mode
@@ -289,6 +295,12 @@ function main() {
   spinner.succeed('Configuration detected');
   const { hasIssues, hasOutdated } = printStatus(status);
 
+  // Startup mode (atomic - sets BOTH metadata AND settings.json)
+  if (startupMode) {
+    enableStartupMode(startupMode, VERSION);
+    return;
+  }
+
   // Detect only mode
   if (detect && !migrate && !upgrade && !profile && enable.length === 0 && disable.length === 0) {
     return;