agileflow 2.99.0 → 2.99.2

package/scripts/spawn-parallel.js

@@ -31,6 +31,7 @@ const { c, success, warning, error, dim, bold } = require('../lib/colors');
 const { getProjectRoot, getStatusPath } = require('../lib/paths');
 const { safeReadJSON } = require('../lib/errors');
 const { getInheritedFlags, detectParentSessionFlags } = require('../lib/flag-detection');
+const { feedback } = require('../lib/feedback');
 
 // Import session manager functions
 const sessionManager = require('./session-manager');
@@ -319,15 +320,19 @@ async function spawn(args) {
     console.log('');
   }
 
+  const task = feedback.task('Creating parallel sessions', sessionsToCreate.length);
   const createdSessions = [];
   for (const sessionSpec of sessionsToCreate) {
+    const spinner = feedback.spinner(`Creating session: ${sessionSpec.nickname}`);
+    spinner.start();
+
     const result = await sessionManager.createSession({
       nickname: sessionSpec.nickname,
       branch: sessionSpec.branch,
     });
 
     if (!result.success) {
-      console.error(error(`Failed to create session ${sessionSpec.nickname}: ${result.error}`));
+      spinner.fail(`Failed: ${sessionSpec.nickname} - ${result.error}`);
       continue;
     }
 
@@ -343,8 +348,10 @@ async function spawn(args) {
     // Show what was copied
     const copied = [...(result.envFilesCopied || []), ...(result.foldersCopied || [])];
     const copyInfo = copied.length ? dim(` (copied: ${copied.join(', ')})`) : '';
-    console.log(success(`  ✓ Session ${result.sessionId}: ${sessionSpec.nickname}${copyInfo}`));
+    spinner.succeed(`Session ${result.sessionId}: ${sessionSpec.nickname}${copyInfo}`);
+    task.step(`${sessionSpec.nickname}`);
   }
+  task.complete(`Created ${createdSessions.length} sessions`);
 
   if (createdSessions.length === 0) {
     console.error(error('\nNo sessions were created.'));
@@ -520,17 +527,14 @@ async function addWindow(args) {
   // Get window number
   let windowIndex;
   try {
-    windowIndex = execFileSync(
-      'tmux',
-      ['list-windows', '-t', currentSession, '-F', '#I:#W'],
-      {
+    windowIndex =
+      execFileSync('tmux', ['list-windows', '-t', currentSession, '-F', '#I:#W'], {
         encoding: 'utf8',
         stdio: ['pipe', 'pipe', 'pipe'],
-      }
-    )
-      .split('\n')
-      .find(line => line.endsWith(`:${windowName}`))
-      ?.split(':')[0] || '?';
+      })
+        .split('\n')
+        .find(line => line.endsWith(`:${windowName}`))
+        ?.split(':')[0] || '?';
   } catch {
     windowIndex = '?';
   }

package/src/core/agents/configuration/archival.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-archival
 description: Configure AgileFlow auto-archival system for story status management
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/agents/configuration/attribution.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-attribution
 description: Configure CLAUDE.md file with git attribution preferences
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/agents/configuration/ci.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-ci
 description: Configure CI/CD workflow for automated testing and quality checks
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/agents/configuration/damage-control.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-damage-control
 description: Configure AgileFlow damage control to protect against destructive commands
-tools:   - Read
+tools:
+  - Read
   - Write
   - Edit
   - Bash

package/src/core/agents/configuration/git-config.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-git-config
 description: Configure git repository initialization and remote setup
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/agents/configuration/hooks.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-hooks
 description: Configure AgileFlow hooks system for event-driven automation
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/agents/configuration/precompact.md

@@ -1,7 +1,8 @@
 ---
 name: precompact
 description: Configure PreCompact hook for context preservation during conversation compacts
-tools:   - Read
+tools:
+  - Read
   - Write
   - Edit
   - Bash

package/src/core/agents/configuration/status-line.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-status-line
 description: Configure AgileFlow status line for Claude Code
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/agents/configuration/verify.md

@@ -1,7 +1,8 @@
 ---
 name: configuration-verify
 description: Verify configuration and test that everything works
-tools:   - Bash
+tools:
+  - Bash
   - Read
   - Edit
   - Write

package/src/core/commands/adr/list.md

@@ -1,6 +1,6 @@
 ---
 description: List all Architecture Decision Records
-argument-hint: [STATUS=<status>]
+argument-hint: "[STATUS=<status>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/adr/update.md

@@ -1,6 +1,6 @@
 ---
 description: Update ADR status or content
-argument-hint: NUMBER=<number> [STATUS=<status>] [REASON=<text>]
+argument-hint: "NUMBER=<number> [STATUS=<status>] [REASON=<text>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/adr/view.md

@@ -1,6 +1,6 @@
 ---
 description: View ADR details with contextual actions
-argument-hint: NUMBER=<number>
+argument-hint: "NUMBER=<number>"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/adr.md

@@ -1,6 +1,6 @@
 ---
 description: Create an Architecture Decision Record
-argument-hint: NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> [LINKS=<text>]
+argument-hint: "NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> [LINKS=<text>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/agent.md

@@ -1,6 +1,6 @@
 ---
 description: Onboard a new agent with profile and contract
-argument-hint: AGENT_ID=<id> ROLE=<text> [TOOLS=<list>] [SCOPE=<list>]
+argument-hint: "AGENT_ID=<id> ROLE=<text> [TOOLS=<list>] [SCOPE=<list>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/api.md

@@ -1,6 +1,6 @@
 ---
 description: Start REST API server to expose AgileFlow state
-argument-hint: ACTION=start|stop|status [PORT=3456]
+argument-hint: "ACTION=start|stop|status [PORT=3456]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/assign.md

@@ -1,6 +1,6 @@
 ---
 description: Assign or reassign a story to an owner
-argument-hint: STORY=<US-ID> NEW_OWNER=<id> [NEW_STATUS=<status>] [NOTE=<text>]
+argument-hint: "STORY=<US-ID> NEW_OWNER=<id> [NEW_STATUS=<status>] [NOTE=<text>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/audit.md

@@ -1,6 +1,6 @@
 ---
 description: Audit story completion - tests + acceptance criteria verification (GSD pattern)
-argument-hint: STORY=<US-ID>
+argument-hint: "STORY=<US-ID>"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/auto.md

@@ -1,6 +1,6 @@
 ---
 description: Auto-generate stories from PRDs, mockups, or specs
-argument-hint: SOURCE=<path|url> [EPIC=<EP-ID>] [OWNER=<id>] [AUTO_CREATE=true|false]
+argument-hint: "SOURCE=<path|url> [EPIC=<EP-ID>] [OWNER=<id>] [AUTO_CREATE=true|false]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/automate.md

@@ -1,6 +1,6 @@
 ---
 description: Manage scheduled automations for recurring tasks
-argument-hint: ACTION=list|add|edit|remove|run|presets [ID=<automation-id>]
+argument-hint: "ACTION=list|add|edit|remove|run|presets [ID=<automation-id>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/babysit.md

@@ -1,6 +1,6 @@
 ---
 description: Interactive mentor for end-to-end feature implementation
-argument-hint: [EPIC=<EP-ID>]
+argument-hint: "[EPIC=<EP-ID>]"
 compact_context:
   priority: critical
   preserve_rules:

package/src/core/commands/baseline.md

@@ -1,6 +1,6 @@
 ---
 description: Mark current state as verified baseline
-argument-hint: [<message>]
+argument-hint: "[<message>]"
 compact_context:
   priority: critical
   preserve_rules:

package/src/core/commands/batch.md

@@ -1,6 +1,6 @@
 ---
 description: Process multiple items with functional patterns (map/pmap/filter/reduce)
-argument-hint: <operation> <pattern> [<action>]
+argument-hint: "<operation> <pattern> [<action>]"
 compact_context:
   priority: normal
   preserve_rules:

package/src/core/commands/blockers.md

@@ -1,6 +1,6 @@
 ---
 description: Track and resolve blockers with actionable suggestions
-argument-hint: [AGENT=<id>] [SHOW_RESOLVED=true|false] [DETAILED=true|false]
+argument-hint: "[AGENT=<id>] [SHOW_RESOLVED=true|false] [DETAILED=true|false]"
 model: haiku
 compact_context:
   priority: high

package/src/core/commands/board.md

@@ -1,6 +1,6 @@
 ---
 description: Display visual kanban board with WIP limits
-argument-hint: [EPIC=<EP-ID>] [OWNER=<id>] [FORMAT=ascii|markdown|html] [GROUP_BY=status|owner|epic]
+argument-hint: "[EPIC=<EP-ID>] [OWNER=<id>] [FORMAT=ascii|markdown|html] [GROUP_BY=status|owner|epic]"
 model: haiku
 type: output-only  # Board display - read-only visualization, not an ongoing task
 compact_context:

package/src/core/commands/changelog.md

@@ -1,6 +1,6 @@
 ---
 description: Auto-generate changelog from commit history
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/choose.md

@@ -1,6 +1,6 @@
 ---
 description: AI-directed decision making with structured options
-argument-hint: <decision> [<context>]
+argument-hint: "<decision> [<context>]"
 compact_context:
   priority: normal
   preserve_rules:

package/src/core/commands/ci.md

@@ -1,6 +1,6 @@
 ---
 description: Bootstrap CI/CD workflow with testing and quality checks
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/compress.md

@@ -1,6 +1,6 @@
 ---
 description: Compress status.json by removing verbose fields and keeping only tracking metadata
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/configure.md

@@ -1,6 +1,6 @@
 ---
 description: Configure AgileFlow features, hooks, and project infrastructure (Visual E2E, CI, git)
-argument-hint: [--profile=<name>] [--save-profile=<name>] [--list-profiles] [--export-profile=<name>] [--import-profile=<file>] [--enable/--disable=features]
+argument-hint: "[--profile=<name>] [--save-profile=<name>] [--list-profiles] [--export-profile=<name>] [--import-profile=<file>] [--enable/--disable=features]"
 compact_context:
   priority: critical
   preserve_rules:
@@ -443,6 +443,61 @@ When creating new sessions with /agileflow:session:new, this will be the
 recommended option. You can still choose a different mode per-session.
 ```
 
+**If user selected "Skip permissions" or "Accept edits only"**, offer Claude settings integration:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Also configure Claude to default to this mode?",
+  "header": "Claude settings",
+  "multiSelect": false,
+  "options": [
+    {"label": "af wrapper only (Recommended)", "description": "The 'af' command already uses this setting. No other changes needed."},
+    {"label": "Also add shell alias", "description": "Add alias to your shell profile so 'claude' also uses this mode"},
+    {"label": "No thanks", "description": "Keep current setup"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+**If "Also add shell alias" selected:**
+
+Determine the flag based on the selected mode:
+- `skip-permissions` → `--dangerously-skip-permissions`
+- `accept-edits` → `--permission-mode acceptEdits`
+
+```bash
+# Detect shell config file
+SHELL_RC="$HOME/.bashrc"
+[ -f "$HOME/.zshrc" ] && SHELL_RC="$HOME/.zshrc"
+
+# Check if alias already exists
+grep -q 'alias claude=' "$SHELL_RC" 2>/dev/null
+```
+
+If alias doesn't exist, add it using the Edit tool on the shell RC file:
+```bash
+# Append alias (idempotent - only if not already present)
+# For skip-permissions:
+echo 'alias claude="claude --dangerously-skip-permissions"' >> "$SHELL_RC"
+# For accept-edits:
+echo 'alias claude="claude --permission-mode acceptEdits"' >> "$SHELL_RC"
+```
+
+Display:
+```
+✅ Shell alias added to {SHELL_RC}
+Run `source {SHELL_RC}` or open a new terminal for the alias to take effect.
+
+To remove later: edit {SHELL_RC} and remove the 'alias claude=' line.
+```
+
+**If "af wrapper only" or "No thanks" selected:**
+```
+The 'af' command already reads the configured startup mode automatically.
+No additional changes needed.
+```
+
 ---
 
 ### If "Infrastructure" selected

package/src/core/commands/context/export.md

@@ -1,6 +1,6 @@
 ---
 description: Export concise context excerpt for web AI tools
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/context/full.md

@@ -1,6 +1,6 @@
 ---
 description: Generate/refresh full context brief for web AI tools
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/context/note.md

@@ -1,6 +1,6 @@
 ---
 description: Add timestamped note to context file
-argument-hint: NOTE=<text>
+argument-hint: "NOTE=<text>"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/council.md

@@ -1,6 +1,6 @@
 ---
 description: Convene AI Council for strategic decisions with three perspectives (Optimist, Advocate, Analyst)
-argument-hint: <question> [--mode parallel|debate] [--rounds N]
+argument-hint: "<question> [--mode parallel|debate] [--rounds N]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/debt.md

@@ -1,6 +1,6 @@
 ---
 description: Track and prioritize technical debt items
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/deploy.md

@@ -1,6 +1,6 @@
 ---
 description: Set up automated deployment pipeline
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/deps.md

@@ -1,6 +1,6 @@
 ---
 description: Visualize dependency graph with critical path detection
-argument-hint: [SCOPE=story|epic|all] [EPIC=<EP-ID>] [STORY=<US-ID>] [FORMAT=ascii|mermaid|graphviz|json] [ANALYSIS=critical-path|circular|blocking|all]
+argument-hint: "[SCOPE=story|epic|all] [EPIC=<EP-ID>] [STORY=<US-ID>] [FORMAT=ascii|mermaid|graphviz|json] [ANALYSIS=critical-path|circular|blocking|all]"
 model: haiku
 compact_context:
   priority: high

package/src/core/commands/diagnose.md

@@ -1,6 +1,6 @@
 ---
 description: System health diagnostics
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/docs.md

@@ -1,6 +1,6 @@
 ---
 description: Synchronize documentation with code changes
-argument-hint: [BRANCH=<name>] [BASE=<branch>] [AUTO_CREATE=true|false]
+argument-hint: "[BRANCH=<name>] [BASE=<branch>] [AUTO_CREATE=true|false]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/epic/list.md

@@ -1,6 +1,6 @@
 ---
 description: List all epics with status and progress
-argument-hint: [STATUS=<status>]
+argument-hint: "[STATUS=<status>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/epic/view.md

@@ -1,6 +1,6 @@
 ---
 description: View epic details with stories and contextual actions
-argument-hint: EPIC=<EP-ID>
+argument-hint: "EPIC=<EP-ID>"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/epic.md

@@ -1,6 +1,6 @@
 ---
 description: Create a new epic with stories
-argument-hint: EPIC=<EP-ID> TITLE=<text> OWNER=<id> GOAL=<text> [STORIES=<list>] [RESEARCH=<file>]
+argument-hint: "EPIC=<EP-ID> TITLE=<text> OWNER=<id> GOAL=<text> [STORIES=<list>] [RESEARCH=<file>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/feedback.md

@@ -1,6 +1,6 @@
 ---
 description: Collect and process agent feedback
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/handoff.md

@@ -1,6 +1,6 @@
 ---
 description: Document work handoff between agents
-argument-hint: STORY=<US-ID> FROM=<id> TO=<id> [SUMMARY=<text>] [BLOCKERS=<list>]
+argument-hint: "STORY=<US-ID> FROM=<id> TO=<id> [SUMMARY=<text>] [BLOCKERS=<list>]"
 compact_context:
   priority: high
   preserve_rules: