agileflow 2.93.0 → 2.94.0

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.94.0] - 2026-01-24
+
+### Added
+- Shared docs/ across sessions via symlink for multi-session coordination
+
 ## [2.93.0] - 2026-01-24
 
 ### Added

package/package.json

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

package/scripts/agileflow-welcome.js

@@ -1756,11 +1756,10 @@ async function main() {
   // === SESSION HEALTH WARNINGS ===
   // Check for forgotten sessions with uncommitted changes, stale sessions, orphaned entries
   try {
-    const healthResult = spawnSync(
-      'node',
-      [SESSION_MANAGER_PATH, 'health'],
-      { encoding: 'utf8', timeout: 10000 }
-    );
+    const healthResult = spawnSync('node', [SESSION_MANAGER_PATH, 'health'], {
+      encoding: 'utf8',
+      timeout: 10000,
+    });
 
     if (healthResult.stdout) {
       const health = JSON.parse(healthResult.stdout);
@@ -1777,14 +1776,12 @@ async function main() {
           console.log(
             `${c.coral}⚠️  ${health.uncommitted.length} session(s) have uncommitted changes:${c.reset}`
           );
-          health.uncommitted.slice(0, 3).forEach((sess) => {
+          health.uncommitted.slice(0, 3).forEach(sess => {
             const name = sess.nickname ? `"${sess.nickname}"` : `Session ${sess.id}`;
             console.log(`${c.dim}   └─ ${name}: ${sess.changeCount} file(s)${c.reset}`);
           });
           if (health.uncommitted.length > 3) {
-            console.log(
-              `${c.dim}   └─ ... and ${health.uncommitted.length - 3} more${c.reset}`
-            );
+            console.log(`${c.dim}   └─ ... and ${health.uncommitted.length - 3} more${c.reset}`);
           }
           console.log(
             `${c.slate}   Run: ${c.skyBlue}/agileflow:session:status${c.slate} to see details${c.reset}`

package/scripts/session-manager.js

@@ -238,7 +238,7 @@ async function cleanupStaleLocksAsync(registry, options = {}) {
  * @returns {Object[]} Array of file details with analysis
  */
 function getFileDetails(sessionPath, changes) {
-  return changes.map((change) => {
+  return changes.map(change => {
     const status = change.substring(0, 2).trim();
     const file = change.substring(3);
 
@@ -294,8 +294,8 @@ function getSessionsHealth(options = {}) {
   const staleThreshold = staleDays * 24 * 60 * 60 * 1000;
 
   const health = {
-    stale: [],           // Sessions with no activity > staleDays
-    uncommitted: [],     // Sessions with uncommitted git changes
+    stale: [], // Sessions with no activity > staleDays
+    uncommitted: [], // Sessions with uncommitted git changes
     orphanedRegistry: [], // Registry entries where path doesn't exist
     orphanedWorktrees: [], // Worktrees not in registry
     healthy: 0,
@@ -333,7 +333,7 @@ function getSessionsHealth(options = {}) {
       if (result.stdout && result.stdout.trim()) {
         // Don't use trim() on the whole string - it removes leading space from first status
         // Split by newline and filter empty lines instead
-        const changes = result.stdout.split('\n').filter((line) => line.length > 0);
+        const changes = result.stdout.split('\n').filter(line => line.length > 0);
         const sessionData = {
           id,
           ...session,
@@ -345,7 +345,7 @@ function getSessionsHealth(options = {}) {
         if (detailed) {
           sessionData.fileDetails = getFileDetails(session.path, changes);
           // Calculate if session is safe to delete (all changes trivial)
-          sessionData.allTrivial = sessionData.fileDetails.every((f) => f.trivial);
+          sessionData.allTrivial = sessionData.fileDetails.every(f => f.trivial);
         }
 
         health.uncommitted.push(sessionData);
@@ -365,12 +365,12 @@ function getSessionsHealth(options = {}) {
     if (worktreeList.stdout) {
       const worktrees = worktreeList.stdout
         .split('\n')
-        .filter((line) => line.startsWith('worktree '))
-        .map((line) => line.replace('worktree ', ''));
+        .filter(line => line.startsWith('worktree '))
+        .map(line => line.replace('worktree ', ''));
 
       const mainPath = ROOT;
       for (const wtPath of worktrees) {
-        const inRegistry = Object.values(registry.sessions).some((s) => s.path === wtPath);
+        const inRegistry = Object.values(registry.sessions).some(s => s.path === wtPath);
         if (!inRegistry && wtPath !== mainPath) {
           // Check if it's an AgileFlow worktree (has .agileflow folder)
           if (fs.existsSync(path.join(wtPath, '.agileflow'))) {
@@ -798,12 +798,11 @@ async function createSession(options = {}) {
     }
   }
 
-  // Copy Claude Code, AgileFlow config, and docs folders (gitignored contents won't copy with worktree)
+  // Copy Claude Code and AgileFlow config folders (gitignored contents won't copy with worktree)
   // Note: The folder may exist with some tracked files, but gitignored subfolders (commands/, agents/) won't be there
-  // docs/ contains gitignored state files like status.json, session-state.json that need to be shared
-  const configFolders = ['.claude', '.agileflow', 'docs'];
+  const configFoldersToCopy = ['.claude', '.agileflow'];
   const copiedFolders = [];
-  for (const folder of configFolders) {
+  for (const folder of configFoldersToCopy) {
     const src = path.join(ROOT, folder);
     const dest = path.join(worktreePath, folder);
     if (fs.existsSync(src)) {
@@ -818,6 +817,37 @@ async function createSession(options = {}) {
     }
   }
 
+  // Symlink docs/ to main project docs (shared state: status.json, session-state.json, bus/)
+  // This enables story claiming, status bus, and session coordination across worktrees
+  const foldersToSymlink = ['docs'];
+  const symlinkedFolders = [];
+  for (const folder of foldersToSymlink) {
+    const src = path.join(ROOT, folder);
+    const dest = path.join(worktreePath, folder);
+    if (fs.existsSync(src)) {
+      try {
+        // Remove if exists (worktree may have empty/partial tracked folder)
+        if (fs.existsSync(dest)) {
+          fs.rmSync(dest, { recursive: true, force: true });
+        }
+
+        // Create relative symlink (works across project moves)
+        const relPath = path.relative(worktreePath, src);
+        fs.symlinkSync(relPath, dest, 'dir');
+        symlinkedFolders.push(folder);
+      } catch (e) {
+        // Fallback to copy if symlink fails (e.g., Windows without dev mode)
+        console.warn(`Warning: Could not symlink ${folder}, copying instead: ${e.message}`);
+        try {
+          fs.cpSync(src, dest, { recursive: true, force: true });
+          copiedFolders.push(folder);
+        } catch (copyErr) {
+          console.warn(`Warning: Could not copy ${folder}: ${copyErr.message}`);
+        }
+      }
+    }
+  }
+
   // Register session - worktree sessions are always parallel threads
   registry.next_id++;
   registry.sessions[sessionId] = {
@@ -842,6 +872,7 @@ async function createSession(options = {}) {
     command: `cd "${worktreePath}" && claude`,
     envFilesCopied: copiedEnvFiles,
     foldersCopied: copiedFolders,
+    foldersSymlinked: symlinkedFolders,
   };
 }
 
@@ -1536,7 +1567,7 @@ function main() {
     case 'health': {
       // Get health status for all sessions
       // Usage: health [staleDays] [--detailed]
-      const staleDaysArg = args.find((a) => /^\d+$/.test(a));
+      const staleDaysArg = args.find(a => /^\d+$/.test(a));
       const staleDays = staleDaysArg ? parseInt(staleDaysArg, 10) : 7;
       const detailed = args.includes('--detailed');
       const health = getSessionsHealth({ staleDays, detailed });

package/scripts/spawn-parallel.js

@@ -64,7 +64,13 @@ function hasScreen() {
  * Build the Claude command for a session
  */
 function buildClaudeCommand(sessionPath, options = {}) {
-  const { init = false, dangerous = false, prompt = null, claudeArgs = null, noClaude = false } = options;
+  const {
+    init = false,
+    dangerous = false,
+    prompt = null,
+    claudeArgs = null,
+    noClaude = false,
+  } = options;
   const parts = [`cd "${sessionPath}"`];
 
   if (init) {
@@ -324,7 +330,13 @@ async function spawn(args) {
     outputCommands(createdSessions, { init, dangerous, prompt, claudeArgs, noClaude });
   } else if (hasTmux()) {
     // Tmux available - use it
-    const tmuxResult = spawnInTmux(createdSessions, { init, dangerous, prompt, claudeArgs, noClaude });
+    const tmuxResult = spawnInTmux(createdSessions, {
+      init,
+      dangerous,
+      prompt,
+      claudeArgs,
+      noClaude,
+    });
 
     if (tmuxResult.success) {
       console.log(success(`\n✅ Tmux session created: ${tmuxResult.sessionName}`));

package/tools/cli/lib/content-injector.js

@@ -711,9 +711,11 @@ function getPlaceholderDocs() {
       '<!-- {{COMMAND_LIST}} -->': 'Full formatted command list',
     },
     templates: {
-      '<!-- {{SESSION_HARNESS}} -->': 'Session harness protocol (auto-detects agent ID from frontmatter)',
+      '<!-- {{SESSION_HARNESS}} -->':
+        'Session harness protocol (auto-detects agent ID from frontmatter)',
       '<!-- {{SESSION_HARNESS:AG-API}} -->': 'Session harness protocol with explicit agent ID',
-      '<!-- {{QUALITY_GATE_PRIORITIES}} -->': 'Quality gate priorities with CRITICAL/HIGH/MEDIUM levels',
+      '<!-- {{QUALITY_GATE_PRIORITIES}} -->':
+        'Quality gate priorities with CRITICAL/HIGH/MEDIUM levels',
     },
     preserve_rules: {
       '{{RULES:json_operations}}': 'Rules for safe JSON file modifications',