@devo-bmad-custom/agent-orchestration 1.0.17 → 1.0.19

package/lib/installer.js

@@ -724,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"'));
@@ -798,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)) {
@@ -834,15 +864,7 @@ async function setupTmux(projectRoot, chalk) {
     const src = path.join(tmuxSrc, srcName);
     if (!await fs.pathExists(src)) continue;
 
-    const exists = await fs.pathExists(dest);
-    if (exists) {
-      const overwrite = await ask(chalk.dim(`  ${dest} already exists. Overwrite? (y/N): `));
-      if (!overwrite.toLowerCase().startsWith('y')) {
-        console.log(chalk.dim(`  ○ Skipped ${path.basename(dest)}`));
-        continue;
-      }
-    }
-
+    // Always overwrite tmux scripts — ensures fixes (e.g. PNG normalization) propagate on update
     await fs.copy(src, dest, { overwrite: true });
     if (dest.endsWith('.sh') || dest.endsWith('.py') || dest === xclipPath) {
       try { await fs.chmod(dest, 0o755); } catch {}

package/package.json

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

package/src/docs/dev/tmux/paste_image_wrapper.sh

@@ -54,15 +54,28 @@ if [ -n "$IMAGE_TYPE" ]; then
     # Fall back to PowerShell (Windows clipboard API) when wl-paste produces empty output.
     if [ ! -s "$PNGFILE" ]; then
         WINPATH=$(wslpath -w "$PNGFILE" 2>/dev/null)
+        # Normalize to 32bppArgb before saving — System.Drawing.Image.Save() can produce
+        # indexed/palette PNGs that the Anthropic API rejects with "image format not supported".
         powershell.exe -NoProfile -Command "
             Add-Type -AssemblyName System.Windows.Forms
+            Add-Type -AssemblyName System.Drawing
             \$img = [System.Windows.Forms.Clipboard]::GetImage()
-            if (\$img -ne \$null) { \$img.Save('$WINPATH') }
+            if (\$img -ne \$null) {
+                \$bmp = New-Object System.Drawing.Bitmap(\$img.Width, \$img.Height, [System.Drawing.Imaging.PixelFormat]::Format32bppArgb)
+                \$g = [System.Drawing.Graphics]::FromImage(\$bmp)
+                \$g.DrawImage(\$img, 0, 0)
+                \$g.Dispose()
+                \$bmp.Save('$WINPATH', [System.Drawing.Imaging.ImageFormat]::Png)
+                \$bmp.Dispose()
+                \$img.Dispose()
+            }
         " 2>/dev/null
     fi
 
     [ -s "$PNGFILE" ] || exit 1
     send_path "@$PNGFILE"
+    # Writeback normalized PNG to Wayland clipboard so subsequent pastes are also clean
+    /usr/bin/wl-copy --type image/png < "$PNGFILE" 2>/dev/null || true
     exit 0
 fi
 

package/src/docs/dev/tmux/tmux-setup.md

@@ -681,7 +681,11 @@ tmux kill-pane -t <pane_id>
 | `text/html` | Saved to `/tmp/tmux_clipboard_content.html`, path typed |
 | `text/plain` | If it's a valid path: `@path`; otherwise saved to `/tmp/tmux_clipboard_text.txt` |
 
-**Implementation:** `paste_image_wrapper.sh` uses `/usr/bin/wl-paste` (Linux-native Wayland clipboard — no PowerShell/vsock). Files are saved as `/tmp/tmux_clip_YYYYMMDD_HHMMSS.<ext>`. On each run, files from previous days are automatically deleted. The PNG is also copied back to the Wayland clipboard so `Ctrl+V` may also work in Claude Code.
+**Implementation:** `paste_image_wrapper.sh` uses `/usr/bin/wl-paste` (Linux-native Wayland clipboard — no PowerShell/vsock). Files are saved as `/tmp/tmux_clip_YYYYMMDD_HHMMSS.<ext>`. On each run, files from previous days are automatically deleted. The normalized PNG is also written back to the Wayland clipboard via `wl-copy` so subsequent pastes are also clean.
+
+**PNG normalization (WSLg PowerShell fallback):** When `wl-paste` produces empty output (common on WSLg), the script falls back to PowerShell's `System.Windows.Forms.Clipboard::GetImage()`. The raw `Image.Save()` call can produce indexed/palette-mode PNGs that the Anthropic API rejects with `"image format image/png not supported"`. The fix redraws the clipboard image onto a fresh `Format32bppArgb` bitmap before saving, ensuring the output is always standard RGBA PNG.
+
+> **Troubleshooting:** If Claude reports `"Image format image/png not supported"` after pasting a screenshot, your `paste_image_wrapper.sh` is outdated. Re-run the installer (it now always overwrites tmux scripts) or copy the latest version from `docs/dev/paste_image_wrapper.sh`.
 
 **`Ctrl+V` binding** uses `tmux paste-buffer -p` (no trailing newline). Without `-p`, `paste-buffer` appended a newline that auto-submitted the pasted content — fixed.