@devo-bmad-custom/agent-orchestration 1.0.15 → 1.0.18

package/lib/installer.js

@@ -234,6 +234,19 @@ async function install(opts) {
     console.log(chalk.green(`  ✓ .agents/skills/ (${skillFiles.length} files)`));
   }
 
+  // ── Orchestration template ─────────────────────────────────────────────────
+  const pkgOrchSrc = path.join(SRC_DIR, '.agents', 'orchestration', 'session-template.md');
+  if (await fs.pathExists(pkgOrchSrc)) {
+    const destOrch = path.join(projectRoot, '.agents', 'orchestration');
+    await fs.ensureDir(destOrch);
+    const destFile = path.join(destOrch, 'session-template.md');
+    await fs.copy(pkgOrchSrc, destFile, { overwrite: true });
+    const content = await fs.readFile(pkgOrchSrc);
+    newFileEntries.push({ relPath: '.agents/orchestration/session-template.md', hash: sha256(content) });
+    installedCount++;
+    console.log(chalk.green('  ✓ .agents/orchestration/session-template.md'));
+  }
+
   // ── Orphan removal (update only) ──────────────────────────────────────────
   if (isUpdate) {
     const oldEntries = await readFilesManifest(bmadDir);
@@ -711,19 +724,22 @@ async function setupTmux(projectRoot, chalk) {
   console.log('    ' + chalk.cyan('sudo apt-get install -y wl-clipboard imagemagick wslu'));
   console.log('  ' + chalk.white('⑤ Docker Desktop WSL integration') + chalk.dim(' — GUI only:'));
   console.log('    ' + chalk.dim('Docker Desktop → Settings → Resources → WSL Integration → toggle Ubuntu → Apply & Restart'));
+  console.log('  ' + chalk.white('⑥ gsudo') + chalk.dim(' (Windows sudo — allows WSL to run elevated PowerShell):'));
+  console.log('    ' + chalk.cyan('winget install gerardog.gsudo'));
+  console.log('    ' + chalk.dim('    Or via scoop: scoop install gsudo'));
 
   console.log('');
   console.log(chalk.bold.yellow('  ✦ Can be done manually OR by an AI with relaxed permissions:'));
   console.log(chalk.dim('     These are safe to automate — no sudo or system-level access needed.\n'));
-  console.log('  ' + chalk.white('⑥ NVM + Node') + chalk.dim(' (required for Node-based MCP servers):'));
+  console.log('  ' + chalk.white('⑧ NVM + Node') + chalk.dim(' (required for Node-based MCP servers):'));
   console.log('    ' + chalk.cyan('curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash'));
   console.log('    ' + chalk.cyan('source ~/.bashrc && nvm install --lts'));
-  console.log('  ' + chalk.white('⑦ TPM (tmux Plugin Manager):'));
+  console.log('  ' + chalk.white('⑨ TPM (tmux Plugin Manager):'));
   console.log('    ' + chalk.cyan('git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm'));
   console.log('    ' + chalk.dim('    Then inside tmux: press Ctrl+B I to install plugins'));
-  console.log('  ' + chalk.white('⑧ fzf') + chalk.dim(' (required for Actions popup menu):'));
+  console.log('  ' + chalk.white('⑩ fzf') + chalk.dim(' (required for Actions popup menu):'));
   console.log('    ' + chalk.cyan('mkdir -p ~/.local/bin && curl -Lo /tmp/fzf.tar.gz https://github.com/junegunn/fzf/releases/download/v0.54.3/fzf-0.54.3-linux_amd64.tar.gz && tar -xzf /tmp/fzf.tar.gz -C ~/.local/bin'));
-  console.log('  ' + chalk.white('⑨ Nerd Fonts') + chalk.dim(' (required for Powerline status bar separators):'));
+  console.log('  ' + chalk.white('⑪ Nerd Fonts') + chalk.dim(' (required for Powerline status bar separators):'));
   console.log('    ' + chalk.dim('    Download JetBrainsMono NFM from https://www.nerdfonts.com/'));
   console.log('    ' + chalk.dim('    Install JetBrainsMonoNerdFontMono-Regular.ttf to Windows (double-click → Install for all users)'));
   console.log('    ' + chalk.white('    Cursor/VS Code:') + ' ' + chalk.cyan('"terminal.integrated.fontFamily": "JetBrainsMono NFM"'));
@@ -785,6 +801,33 @@ async function setupTmux(projectRoot, chalk) {
     console.log(chalk.dim(`  ○ ${xdgOpenPath} already exists`));
   }
 
+  // gsudo shim — lets WSL call Windows-side gsudo.exe without full path
+  const gsudoShimPath = path.join(homeDir, '.local', 'bin', 'gsudo');
+  if (!await fs.pathExists(gsudoShimPath)) {
+    // Find gsudo.exe on Windows side
+    const { execSync } = require('child_process');
+    let gsudoExe = null;
+    try {
+      // cmd.exe /c where gsudo returns Windows paths — convert first result to WSL path
+      const winPath = execSync('cmd.exe /c where gsudo 2>NUL', { stdio: 'pipe' })
+        .toString().split('\n')[0].trim();
+      if (winPath && winPath.endsWith('.exe')) {
+        // Convert C:\... → /mnt/c/...
+        gsudoExe = '/mnt/' + winPath.replace(/\\/g, '/').replace(/^([A-Za-z]):/, (_, d) => d.toLowerCase());
+      }
+    } catch { /* gsudo not installed on Windows yet */ }
+
+    if (gsudoExe) {
+      const shimContent = `#!/bin/bash\nexec '${gsudoExe}' "$@"\n`;
+      await fs.writeFile(gsudoShimPath, shimContent, { mode: 0o755 });
+      console.log(chalk.green(`  ✓ gsudo shim → ${gsudoShimPath} (delegates to ${gsudoExe})`));
+    } else {
+      console.log(chalk.yellow('  ⚠  gsudo not found on Windows — install it first (winget install gerardog.gsudo), then re-run setup'));
+    }
+  } else {
+    console.log(chalk.dim(`  ○ gsudo shim already exists at ${gsudoShimPath}`));
+  }
+
   // ── Step 3: TPM check ────────────────────────────────────────────────────
   console.log('\n' + chalk.bold('Step 3 — TPM check'));
   if (await fs.pathExists(tpmPath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devo-bmad-custom/agent-orchestration",
-  "version": "1.0.15",
+  "version": "1.0.18",
   "description": "BMAD Method — AI-native agile workflow system for Claude Code and compatible AI assistants",
   "keywords": [
     "bmad",

package/src/.agents/orchestration/session-template.md

@@ -0,0 +1,94 @@
+# Agent Session: {{session_id}}
+<!-- Fill all {{placeholders}} on creation. Do not leave unfilled placeholders in an active session. -->
+
+## Context
+| Field | Value |
+|-------|-------|
+| **Session ID** | `{{session_id}}` |
+| **Created** | {{iso_timestamp}} |
+| **Creator** | {{creator_role}} (pane `{{creator_pane_id}}`) |
+| **Project Root** | `{{project_root}}` |
+| **Branch** | `{{git_branch}}` |
+| **Base Branch** | `{{base_branch}}` |
+| **Track** | {{track}} <!-- Nano / Small / Compact / Medium / Extended / Large / Review / General --> |
+| **Execution Mode** | {{execution_mode}} <!-- inline / command-blocks / scripts / agent-teams --> |
+| **Session File** | `{{session_file_path}}` |
+
+## Git Snapshot
+<!-- Captured at session start. Refresh with `git status` if session runs long. -->
+
+**Uncommitted files:**
+```
+{{git_status_output}}
+```
+
+**Recent commits (last 5):**
+```
+{{git_log_output}}
+```
+
+**Diff summary (base..HEAD):**
+```
+{{git_diff_stat}}
+```
+
+---
+
+## Track Progress
+<!-- Master agent updates this at the START of each step and marks done when complete. -->
+<!-- Step status: ⬜ pending · 🔄 in-progress · ✅ done · ⛔ blocked · ⏭ skipped -->
+
+**Current Step:** {{current_step_name}} ({{current_step_number, or 1 if General track}} / {{total_steps, or ? if General track}})
+
+| # | Step | Status | Started | Notes |
+|---|------|--------|---------|-------|
+<!-- Master fills this table as the track runs. One row per step. -->
+<!-- Example: | 1 | Target Definition | ✅ done | 14:02 | Targeted depth, branch feature/x | -->
+
+---
+
+## Active Agents
+<!-- Register on startup. Update Status as work progresses. -->
+
+| Pane ID | Role | Status | CWD | Claude Session ID |
+|---------|------|--------|-----|-------------------|
+| {{creator_pane_id}} | {{creator_role}} | active | `{{project_root}}` | — |
+
+**Status values:** `active` · `busy` · `idle` · `ready-to-close` · `closed`
+
+---
+
+## Pane Lifecycle
+<!-- Coordinator checks after every task. Close any pane showing `ready-to-close`. -->
+
+| Pane ID | Role | Task | Status | Agent ✓ | Coord ✓ |
+|---------|------|------|--------|---------|---------|
+<!-- Agent ✓ columns: rb=report-back · sid=session-id · done=task-done -->
+<!-- Coord ✓ columns: exit=/exit sent · kill=kill-pane · closed=status updated · rebal=layout rebalanced -->
+
+---
+
+## Tasks
+<!-- Format: ### TASK-NNN · {status} · {assigned_role} -->
+<!-- Status values: pending · in-progress · blocked · done -->
+
+<!-- Add tasks below. Example:
+### TASK-001 · pending · dev
+- **Description:** Fix the user profile API endpoint
+- **Status:** pending
+- **Acceptance:** API returns 200 with correct user data
+-->
+
+---
+
+## Decisions & Notes
+<!-- Running log of decisions made during this session. Append, never overwrite. -->
+
+- `{{iso_timestamp}}` — Session created. Branch: `{{git_branch}}`.
+
+---
+
+## Blockers
+<!-- Items requiring user input before work can continue. -->
+
+<!-- | ID | Description | Needs | Since | -->

package/src/.agents/skills/tmux-commands/SKILL.md

@@ -212,7 +212,7 @@ case "$MASTER_POS" in
     tmux select-layout main-horizontal
     ;;
   *)
-    tmux select-layout tiled
+    tmux select-layout main-vertical
     ;;
 esac
 sleep 10
@@ -254,7 +254,11 @@ SESSION_NAME=$(tmux display-message -p "#{session_name}")
 WINDOW_ID=$(tmux display-message -p "#{window_id}")
 PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")
 
-# 3. Find session file
+# 2. Determine role (passed via spawn context — $ROLE should be set)
+ROLE="${ROLE:-unknown}"
+
+# 3. Find session file — SESSION_FILE should be passed explicitly in spawn context.
+#    Fall back to most recent only if not provided (fragile — prefer explicit pass).
 if [ -n "$BMAD_SESSION_ID" ]; then
   SESSION_FILE="$PROJECT_ROOT/_bmad-output/sessions/$BMAD_SESSION_ID/agent-sessions.md"
 else
@@ -336,16 +340,22 @@ SPAWNER_PANE=$(tmux display-message -p "#{pane_id}")
 sleep 10
 tmux split-window -h -c "$PROJECT_ROOT" \
   "claude --dangerously-skip-permissions 'You are the $ROLE agent. \
-FIRST: run /color $ROLE_COLOR then /rename $ROLE-agent. \
 Spawner pane: $SPAWNER_PANE. Session file: $SESSION_FILE. \
+Always use -l flag for message content in tmux send-keys. \
 Always sleep 10 before and after every tmux command. \
 Always append Enter to every tmux send-keys call. \
 Always verify pane exists before targeting it. \
 $TASK_CONTEXT'"
-sleep 10
+sleep 15
 
 # Capture ID
 NEW_PANE_ID=$(tmux list-panes -F "#{pane_id}" | tail -1)
+
+# Set agent identity — spawner sends /color and /rename as separate commands
+sleep 10
+tmux send-keys -t "$NEW_PANE_ID" "/color $ROLE_COLOR" Enter
+sleep 10
+tmux send-keys -t "$NEW_PANE_ID" "/rename ${ROLE}-agent" Enter
 sleep 10
 
 # Set tmux pane title (border label)
@@ -475,7 +485,7 @@ fi
 
 1. **Killing own pane** — always check `TARGET_PANE_ID != $(tmux display-message -p "#{pane_id}")` AND `TARGET_PANE_ID != MASTER_PANE` before `kill-pane`
 2. **No `Enter` on send-keys** — message typed but never submitted
-2. **No sleep between tmux commands** — race conditions, stale pane lists
+3. **No sleep between tmux commands** — race conditions, stale pane lists
 3. **Combining `/color` and `/rename` in one send-keys call** — only the first command runs; send each as a separate call with `sleep 10` between
 4. **Using OSC 2 / `select-pane -T` for naming** — Claude Code overwrites these
 5. **Killing pane without `/exit` first** — leaves partial writes, git locks