@sugar-crash-studios/vibe-forge 0.4.0

package/bin/lib/json.sh

@@ -0,0 +1,264 @@
+#!/usr/bin/env bash
+#
+# Vibe Forge - JSON Utilities (Node.js based)
+#
+# Provides safe JSON operations using Node.js instead of jq.
+# This standardizes JSON handling across the codebase and removes
+# the implicit jq dependency.
+#
+# SECURITY: All functions pass values as command-line arguments,
+# never interpolated into the Node.js code.
+#
+
+# =============================================================================
+# JSON Reading Functions
+# =============================================================================
+
+# json_read FILE KEY [DEFAULT]
+# Reads a single key from a JSON file.
+# Returns the value or default (empty string if not provided).
+#
+# Example: value=$(json_read config.json "name" "unknown")
+json_read() {
+    local file="$1"
+    local key="$2"
+    local default="${3:-}"
+
+    if [[ ! -f "$file" ]]; then
+        echo "$default"
+        return 1
+    fi
+
+    local result
+    result=$(node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        const key = process.argv[2];
+        const defaultVal = process.argv[3] || "";
+        try {
+            const data = JSON.parse(fs.readFileSync(file, "utf8"));
+            const value = data[key];
+            if (value !== undefined && value !== null) {
+                console.log(String(value));
+            } else {
+                console.log(defaultVal);
+            }
+        } catch (e) {
+            console.log(defaultVal);
+            process.exit(1);
+        }
+    ' -- "$file" "$key" "$default" 2>/dev/null)
+
+    echo "$result"
+}
+
+# json_read_multi FILE KEY1 KEY2 ...
+# Reads multiple keys from a JSON file efficiently (single Node.js call).
+# Outputs tab-separated values in the order of keys provided.
+# Missing keys return empty string.
+#
+# Example: read -r name status task <<< "$(json_read_multi file.json name status task)"
+json_read_multi() {
+    local file="$1"
+    shift
+    local keys=("$@")
+
+    if [[ ! -f "$file" ]]; then
+        # Output empty strings for each key
+        local empty=""
+        for ((i=0; i<${#keys[@]}; i++)); do
+            empty+="\t"
+        done
+        echo "${empty:1}"  # Remove leading tab
+        return 1
+    fi
+
+    # Pass keys as JSON array for clean parsing
+    local keys_json
+    keys_json=$(printf '%s\n' "${keys[@]}" | node -e '
+        const lines = require("fs").readFileSync(0, "utf8").trim().split("\n");
+        console.log(JSON.stringify(lines));
+    ')
+
+    node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        const keys = JSON.parse(process.argv[2]);
+        try {
+            const data = JSON.parse(fs.readFileSync(file, "utf8"));
+            const values = keys.map(k => {
+                const v = data[k];
+                return (v !== undefined && v !== null) ? String(v) : "";
+            });
+            console.log(values.join("\t"));
+        } catch (e) {
+            console.log(keys.map(() => "").join("\t"));
+            process.exit(1);
+        }
+    ' -- "$file" "$keys_json" 2>/dev/null
+}
+
+# json_read_all FILE
+# Reads all keys from a JSON file and outputs key=value lines.
+# Useful for loading all config values at once.
+#
+# SECURITY WARNING: Do NOT use this function with eval on untrusted JSON files.
+# JSON key names are NOT validated or escaped - a malicious key name like
+# "FOO=1; evil_command; export BAR" would result in arbitrary code execution.
+# Only use with fully trusted, version-controlled config files.
+#
+# Safe usage (read individual values): json_read FILE KEY
+# Unsafe pattern to avoid: eval "$(json_read_all untrusted.json | sed 's/^/export /')"
+json_read_all() {
+    local file="$1"
+
+    if [[ ! -f "$file" ]]; then
+        return 1
+    fi
+
+    node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        try {
+            const data = JSON.parse(fs.readFileSync(file, "utf8"));
+            for (const [key, value] of Object.entries(data)) {
+                if (typeof value !== "object") {
+                    // Escape for shell: single quotes, backslashes
+                    const escaped = String(value).replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+                    console.log(`${key}="${escaped}"`);
+                }
+            }
+        } catch (e) {
+            process.exit(1);
+        }
+    ' -- "$file" 2>/dev/null
+}
+
+# =============================================================================
+# JSON Writing Functions
+# =============================================================================
+
+# json_write FILE KEY VALUE
+# Writes/updates a single key in a JSON file.
+# Creates the file if it does not exist.
+#
+# Example: json_write config.json "enabled" "true"
+json_write() {
+    local file="$1"
+    local key="$2"
+    local value="$3"
+
+    node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        const key = process.argv[2];
+        const value = process.argv[3];
+        let data = {};
+        try {
+            if (fs.existsSync(file)) {
+                data = JSON.parse(fs.readFileSync(file, "utf8"));
+            }
+        } catch (e) {}
+
+        // Try to parse value as boolean or number
+        if (value === "true") {
+            data[key] = true;
+        } else if (value === "false") {
+            data[key] = false;
+        } else if (value === "null") {
+            data[key] = null;
+        } else if (!isNaN(value) && value.trim() !== "") {
+            data[key] = Number(value);
+        } else {
+            data[key] = value;
+        }
+
+        fs.writeFileSync(file, JSON.stringify(data, null, 2) + "\n");
+    ' -- "$file" "$key" "$value" 2>/dev/null
+}
+
+# json_write_bool FILE KEY BOOL_VALUE
+# Writes a boolean value (ensures proper true/false, not string).
+#
+# Example: json_write_bool config.json "enabled" true
+json_write_bool() {
+    local file="$1"
+    local key="$2"
+    local value="$3"
+
+    # Normalize to "true" or "false"
+    case "$value" in
+        true|1|on|yes|enabled) value="true" ;;
+        *) value="false" ;;
+    esac
+
+    node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        const key = process.argv[2];
+        const value = process.argv[3] === "true";
+        let data = {};
+        try {
+            if (fs.existsSync(file)) {
+                data = JSON.parse(fs.readFileSync(file, "utf8"));
+            }
+        } catch (e) {}
+        data[key] = value;
+        fs.writeFileSync(file, JSON.stringify(data, null, 2) + "\n");
+    ' -- "$file" "$key" "$value" 2>/dev/null
+}
+
+# =============================================================================
+# JSON Display Functions
+# =============================================================================
+
+# json_pretty FILE
+# Pretty-prints a JSON file with 2-space indentation.
+#
+# Example: json_pretty config.json
+json_pretty() {
+    local file="$1"
+
+    if [[ ! -f "$file" ]]; then
+        echo "{}"
+        return 1
+    fi
+
+    node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        try {
+            const data = JSON.parse(fs.readFileSync(file, "utf8"));
+            console.log(JSON.stringify(data, null, 2));
+        } catch (e) {
+            console.error("Invalid JSON:", e.message);
+            process.exit(1);
+        }
+    ' -- "$file" 2>/dev/null
+}
+
+# json_has_key FILE KEY
+# Checks if a key exists in a JSON file.
+# Returns 0 if key exists, 1 otherwise.
+#
+# Example: if json_has_key config.json "enabled"; then ...
+json_has_key() {
+    local file="$1"
+    local key="$2"
+
+    if [[ ! -f "$file" ]]; then
+        return 1
+    fi
+
+    node -e '
+        const fs = require("fs");
+        const file = process.argv[1];
+        const key = process.argv[2];
+        try {
+            const data = JSON.parse(fs.readFileSync(file, "utf8"));
+            process.exit(key in data ? 0 : 1);
+        } catch (e) {
+            process.exit(1);
+        }
+    ' -- "$file" "$key" 2>/dev/null
+}

package/bin/lib/terminal.js

@@ -0,0 +1,451 @@
+#!/usr/bin/env node
+/**
+ * Vibe Forge - Cross-Platform Terminal Detection & Spawning
+ *
+ * Detects available terminals and spawns new tabs/windows for worker agents.
+ *
+ * Supported terminals:
+ *   Windows: Windows Terminal, PowerShell
+ *   macOS:   Terminal.app, iTerm2, Kitty
+ *   Linux:   gnome-terminal, konsole, kitty, xterm
+ *
+ * Usage:
+ *   node terminal.js detect              List available terminals
+ *   node terminal.js spawn <terminal> <title> <command>
+ */
+
+const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// =============================================================================
+// Terminal Definitions
+// =============================================================================
+
+const TERMINALS = {
+  // Windows
+  'windows-terminal': {
+    name: 'Windows Terminal',
+    platform: 'win32',
+    detect: () => commandExists('wt') || commandExists('wt.exe'),
+    spawn: (title, command, opts) => spawnWindowsTerminal(title, command, opts),
+  },
+  'powershell': {
+    name: 'PowerShell',
+    platform: 'win32',
+    detect: () => commandExists('pwsh') || commandExists('powershell'),
+    spawn: (title, command, opts) => spawnPowerShell(title, command, opts),
+  },
+
+  // macOS
+  'terminal-app': {
+    name: 'Terminal.app',
+    platform: 'darwin',
+    detect: () => fs.existsSync('/System/Applications/Utilities/Terminal.app'),
+    spawn: (title, command, opts) => spawnTerminalApp(title, command, opts),
+  },
+  'iterm2': {
+    name: 'iTerm2',
+    platform: 'darwin',
+    detect: () => fs.existsSync('/Applications/iTerm.app'),
+    spawn: (title, command, opts) => spawnITerm2(title, command, opts),
+  },
+  'kitty-mac': {
+    name: 'Kitty',
+    platform: 'darwin',
+    detect: () => commandExists('kitty') || fs.existsSync('/Applications/kitty.app'),
+    spawn: (title, command, opts) => spawnKitty(title, command, opts),
+  },
+
+  // Linux
+  'gnome-terminal': {
+    name: 'GNOME Terminal',
+    platform: 'linux',
+    detect: () => commandExists('gnome-terminal'),
+    spawn: (title, command, opts) => spawnGnomeTerminal(title, command, opts),
+  },
+  'konsole': {
+    name: 'Konsole',
+    platform: 'linux',
+    detect: () => commandExists('konsole'),
+    spawn: (title, command, opts) => spawnKonsole(title, command, opts),
+  },
+  'kitty-linux': {
+    name: 'Kitty',
+    platform: 'linux',
+    detect: () => commandExists('kitty'),
+    spawn: (title, command, opts) => spawnKitty(title, command, opts),
+  },
+  'xterm': {
+    name: 'XTerm',
+    platform: 'linux',
+    detect: () => commandExists('xterm'),
+    spawn: (title, command, opts) => spawnXterm(title, command, opts),
+  },
+};
+
+// =============================================================================
+// Detection Helpers
+// =============================================================================
+
+function commandExists(cmd) {
+  try {
+    if (os.platform() === 'win32') {
+      execSync(`where ${cmd}`, { stdio: 'pipe' });
+    } else {
+      execSync(`which ${cmd}`, { stdio: 'pipe' });
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getPlatform() {
+  const p = os.platform();
+  if (p === 'win32') return 'win32';
+  if (p === 'darwin') return 'darwin';
+  return 'linux'; // Treat all other Unix-likes as Linux
+}
+
+function detectTerminals() {
+  const platform = getPlatform();
+  const available = [];
+
+  for (const [id, terminal] of Object.entries(TERMINALS)) {
+    if (terminal.platform === platform) {
+      try {
+        if (terminal.detect()) {
+          available.push({
+            id,
+            name: terminal.name,
+            platform: terminal.platform,
+          });
+        }
+      } catch {
+        // Detection failed, skip this terminal
+      }
+    }
+  }
+
+  return available;
+}
+
+function getBestTerminal() {
+  const available = detectTerminals();
+  return available.length > 0 ? available[0] : null;
+}
+
+// =============================================================================
+// Spawn Functions - Windows
+// =============================================================================
+
+function spawnWindowsTerminal(title, command, opts = {}) {
+  const { cwd, tabColor, suppressApplicationTitle = true } = opts;
+
+  // Build wt arguments
+  const args = ['-w', '0', 'new-tab', '--title', title];
+
+  // FORGE-9: Prevent the spawned process from overwriting the tab title
+  if (suppressApplicationTitle) {
+    args.push('--suppressApplicationTitle');
+  }
+
+  if (tabColor) {
+    args.push('--tabColor', tabColor);
+  }
+
+  // Determine bash path
+  const bashPath = findGitBash();
+
+  if (bashPath) {
+    args.push(bashPath, '-c', command);
+  } else {
+    args.push('bash', '-c', command);
+  }
+
+  const child = spawn('wt', args, {
+    detached: true,
+    stdio: 'ignore',
+    cwd: cwd || process.cwd(),
+    shell: true,
+  });
+
+  child.unref();
+  return { success: true, terminal: 'windows-terminal' };
+}
+
+function spawnPowerShell(title, command, opts = {}) {
+  const { cwd } = opts;
+
+  // PowerShell: Start-Process to open new window
+  // We wrap in bash since the command expects bash
+  const bashPath = findGitBash();
+  const bashCmd = bashPath ? `& '${bashPath}' -c '${command.replace(/'/g, "''")}'` : `bash -c '${command.replace(/'/g, "''")}'`;
+
+  const psCommand = `Start-Process pwsh -ArgumentList '-NoExit', '-Command', '${bashCmd.replace(/'/g, "''")}'`;
+
+  const child = spawn('pwsh', ['-Command', psCommand], {
+    detached: true,
+    stdio: 'ignore',
+    cwd: cwd || process.cwd(),
+    shell: true,
+  });
+
+  child.unref();
+  return { success: true, terminal: 'powershell' };
+}
+
+function findGitBash() {
+  if (os.platform() !== 'win32') return null;
+
+  const paths = [
+    'C:\\Program Files\\Git\\bin\\bash.exe',
+    'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
+    path.join(process.env.LOCALAPPDATA || '', 'Programs', 'Git', 'bin', 'bash.exe'),
+  ];
+
+  for (const p of paths) {
+    if (fs.existsSync(p)) {
+      return p;
+    }
+  }
+
+  // Try to find via where command
+  try {
+    const gitPath = execSync('where git', { stdio: 'pipe' }).toString().trim().split('\n')[0];
+    const gitDir = path.dirname(path.dirname(gitPath));
+    const bashPath = path.join(gitDir, 'bin', 'bash.exe');
+    if (fs.existsSync(bashPath)) {
+      return bashPath;
+    }
+  } catch {
+    // Ignore
+  }
+
+  return null;
+}
+
+// =============================================================================
+// Spawn Functions - macOS
+// =============================================================================
+
+function spawnTerminalApp(title, command, opts = {}) {
+  const { cwd } = opts;
+  const workDir = cwd || process.cwd();
+
+  // AppleScript to open new Terminal tab
+  const script = `
+    tell application "Terminal"
+      activate
+      do script "cd '${workDir.replace(/'/g, "'\\''")}' && ${command.replace(/"/g, '\\"')}"
+      set custom title of front window to "${title}"
+    end tell
+  `;
+
+  try {
+    execSync(`osascript -e '${script.replace(/'/g, "'\\''")}'`, { stdio: 'pipe' });
+    return { success: true, terminal: 'terminal-app' };
+  } catch (err) {
+    return { success: false, error: err.message, terminal: 'terminal-app' };
+  }
+}
+
+function spawnITerm2(title, command, opts = {}) {
+  const { cwd } = opts;
+  const workDir = cwd || process.cwd();
+
+  // AppleScript for iTerm2
+  const script = `
+    tell application "iTerm2"
+      activate
+      tell current window
+        create tab with default profile
+        tell current session
+          write text "cd '${workDir.replace(/'/g, "'\\''")}' && ${command.replace(/"/g, '\\"')}"
+          set name to "${title}"
+        end tell
+      end tell
+    end tell
+  `;
+
+  try {
+    execSync(`osascript -e '${script.replace(/'/g, "'\\''")}'`, { stdio: 'pipe' });
+    return { success: true, terminal: 'iterm2' };
+  } catch (err) {
+    return { success: false, error: err.message, terminal: 'iterm2' };
+  }
+}
+
+// =============================================================================
+// Spawn Functions - Linux & Cross-Platform
+// =============================================================================
+
+function spawnGnomeTerminal(title, command, opts = {}) {
+  const { cwd } = opts;
+
+  const child = spawn('gnome-terminal', [
+    '--tab',
+    '--title', title,
+    '--', 'bash', '-c', `${command}; exec bash`
+  ], {
+    detached: true,
+    stdio: 'ignore',
+    cwd: cwd || process.cwd(),
+  });
+
+  child.unref();
+  return { success: true, terminal: 'gnome-terminal' };
+}
+
+function spawnKonsole(title, command, opts = {}) {
+  const { cwd } = opts;
+
+  const child = spawn('konsole', [
+    '--new-tab',
+    '-p', `tabtitle=${title}`,
+    '-e', 'bash', '-c', `${command}; exec bash`
+  ], {
+    detached: true,
+    stdio: 'ignore',
+    cwd: cwd || process.cwd(),
+  });
+
+  child.unref();
+  return { success: true, terminal: 'konsole' };
+}
+
+function spawnKitty(title, command, opts = {}) {
+  const { cwd } = opts;
+
+  // Kitty can work in single-instance mode with remote control
+  // or spawn new windows
+  const child = spawn('kitty', [
+    '--title', title,
+    '--directory', cwd || process.cwd(),
+    'bash', '-c', `${command}; exec bash`
+  ], {
+    detached: true,
+    stdio: 'ignore',
+  });
+
+  child.unref();
+  return { success: true, terminal: 'kitty' };
+}
+
+function spawnXterm(title, command, opts = {}) {
+  const { cwd } = opts;
+
+  const child = spawn('xterm', [
+    '-T', title,
+    '-e', 'bash', '-c', `cd '${cwd || process.cwd()}' && ${command}; exec bash`
+  ], {
+    detached: true,
+    stdio: 'ignore',
+  });
+
+  child.unref();
+  return { success: true, terminal: 'xterm' };
+}
+
+// =============================================================================
+// Main Spawn Function
+// =============================================================================
+
+function spawnTerminal(terminalId, title, command, opts = {}) {
+  const terminal = TERMINALS[terminalId];
+
+  if (!terminal) {
+    return { success: false, error: `Unknown terminal: ${terminalId}` };
+  }
+
+  try {
+    return terminal.spawn(title, command, opts);
+  } catch (err) {
+    return { success: false, error: err.message, terminal: terminalId };
+  }
+}
+
+// =============================================================================
+// CLI Interface
+// =============================================================================
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'detect': {
+      const terminals = detectTerminals();
+      console.log(JSON.stringify({ platform: getPlatform(), terminals }, null, 2));
+      break;
+    }
+
+    case 'best': {
+      const best = getBestTerminal();
+      if (best) {
+        console.log(JSON.stringify(best, null, 2));
+      } else {
+        console.log(JSON.stringify({ error: 'No supported terminal found' }));
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'spawn': {
+      const terminalId = args[1];
+      const title = args[2];
+      const cmd = args[3];
+      const cwd = args[4];
+      const tabColor = args[5];
+
+      if (!terminalId || !title || !cmd) {
+        console.error('Usage: terminal.js spawn <terminal-id> <title> <command> [cwd] [tabColor]');
+        process.exit(1);
+      }
+
+      const result = spawnTerminal(terminalId, title, cmd, { cwd, tabColor });
+      console.log(JSON.stringify(result));
+      process.exit(result.success ? 0 : 1);
+      break;
+    }
+
+    case 'list': {
+      const platform = getPlatform();
+      const all = Object.entries(TERMINALS)
+        .filter(([, t]) => t.platform === platform)
+        .map(([id, t]) => ({ id, name: t.name }));
+      console.log(JSON.stringify({ platform, terminals: all }, null, 2));
+      break;
+    }
+
+    default:
+      console.log(`Vibe Forge Terminal Utility
+
+Usage:
+  node terminal.js detect         Detect available terminals (JSON)
+  node terminal.js best           Get best available terminal (JSON)
+  node terminal.js list           List all terminals for this platform
+  node terminal.js spawn <id> <title> <command> [cwd] [tabColor]
+
+Examples:
+  node terminal.js detect
+  node terminal.js spawn windows-terminal "Anvil" "claude --chat"
+`);
+  }
+}
+
+// Export for use as module
+module.exports = {
+  detectTerminals,
+  getBestTerminal,
+  spawnTerminal,
+  TERMINALS,
+  getPlatform,
+};
+
+// Run CLI if executed directly
+if (require.main === module) {
+  main();
+}