vibe-forge 0.3.12 → 0.8.1

package/bin/lib/util.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+#
+# Vibe Forge - Cross-Platform Utilities
+# Source this file in other scripts: source "$SCRIPT_DIR/lib/util.sh"
+#
+# Contains cross-platform helper functions that abstract away differences
+# between macOS/BSD, Linux, and Windows (Git Bash).
+#
+
+# =============================================================================
+# Cross-Platform sed In-Place Editing
+# =============================================================================
+# macOS/BSD sed requires `sed -i ''` (empty string for backup extension)
+# Linux/GNU sed requires `sed -i` (no argument after -i)
+# Windows Git Bash uses GNU sed, so same as Linux
+#
+# Usage:
+#   sed_inplace 's/foo/bar/' file.txt
+#   sed_inplace 's/foo/bar/g' file.txt
+#
+# Arguments:
+#   $1 - sed expression (the pattern to apply)
+#   $2 - file to edit
+#
+# Returns:
+#   0 on success, non-zero on failure
+#
+# Example:
+#   sed_inplace 's/"validated": false/"validated": true/' "$config_file"
+
+sed_inplace() {
+    local pattern="$1"
+    local file="$2"
+
+    # Validate arguments
+    if [[ -z "$pattern" ]]; then
+        echo "sed_inplace: error: pattern argument required" >&2
+        return 1
+    fi
+
+    if [[ -z "$file" ]]; then
+        echo "sed_inplace: error: file argument required" >&2
+        return 1
+    fi
+
+    if [[ ! -f "$file" ]]; then
+        echo "sed_inplace: error: file does not exist: $file" >&2
+        return 1
+    fi
+
+    # SECURITY: Refuse to edit symlinks to prevent symlink attacks
+    if [[ -L "$file" ]]; then
+        echo "sed_inplace: error: refusing to edit symlink: $file" >&2
+        return 1
+    fi
+
+    # Platform-specific sed invocation
+    if [[ "$(uname)" == "Darwin" ]]; then
+        # macOS/BSD sed requires empty string after -i
+        sed -i '' "$pattern" "$file"
+    else
+        # Linux and Windows (Git Bash) use GNU sed
+        sed -i "$pattern" "$file"
+    fi
+}
+
+# =============================================================================
+# Detect Platform
+# =============================================================================
+# Returns a normalized platform name
+#
+# Usage:
+#   platform=$(get_platform)
+#   if [[ "$platform" == "macos" ]]; then ...
+#
+# Returns:
+#   "windows" - Windows (detected via MINGW/MSYS/Cygwin environment)
+#   "macos"   - macOS (Darwin)
+#   "linux"   - Linux
+#   "unknown" - Unrecognized platform
+
+get_platform() {
+    case "$(uname -s)" in
+        MINGW*|MSYS*|CYGWIN*)
+            echo "windows"
+            ;;
+        Darwin)
+            echo "macos"
+            ;;
+        Linux)
+            echo "linux"
+            ;;
+        *)
+            echo "unknown"
+            ;;
+    esac
+}
+
+# =============================================================================
+# Check if running in Git Bash on Windows
+# =============================================================================
+# Useful for Windows-specific behavior that differs from Linux
+
+is_git_bash() {
+    [[ "$(uname -s)" == MINGW* ]] || [[ "$(uname -s)" == MSYS* ]]
+}
+
+# =============================================================================
+# Cross-Platform stat for File Size
+# =============================================================================
+# macOS uses `stat -f%z` while Linux uses `stat --format=%s`
+#
+# Usage:
+#   size=$(get_file_size file.txt)
+
+get_file_size() {
+    local file="$1"
+
+    if [[ ! -f "$file" ]]; then
+        echo 0
+        return 1
+    fi
+
+    # Try macOS/BSD syntax first, fall back to GNU syntax
+    stat -f%z "$file" 2>/dev/null || stat --format=%s "$file" 2>/dev/null || echo 0
+}

package/bin/lib/vcs.js

@@ -0,0 +1,349 @@
+#!/usr/bin/env node
+/**
+ * Vibe Forge - VCS Detection and Configuration
+ *
+ * Detects version control system and platform from project structure.
+ * Used by forge-setup.sh and /configure-vcs skill.
+ *
+ * Usage:
+ *   node vcs.js detect [project-path]     Detect VCS type
+ *   node vcs.js get [project-path]        Get current VCS config
+ *   node vcs.js set <type> [project-path] Set VCS type manually
+ *   node vcs.js init <type> [project-path] Initialize VCS folders
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// VCS types and their detection patterns
+const VCS_TYPES = {
+  github: {
+    name: 'GitHub',
+    detect: ['.github/', '.github/workflows/'],
+    folders: ['.github/workflows'],
+    prCommand: 'gh pr create',
+    ciFile: '.github/workflows/ci.yml',
+  },
+  gitlab: {
+    name: 'GitLab',
+    detect: ['.gitlab-ci.yml', '.gitlab/'],
+    folders: ['.gitlab'],
+    prCommand: 'git push -o merge_request.create',
+    ciFile: '.gitlab-ci.yml',
+  },
+  gitea: {
+    name: 'Gitea',
+    detect: ['.gitea/', '.gitea/workflows/'],
+    folders: ['.gitea/workflows'],
+    prCommand: 'tea pr create',
+    ciFile: '.gitea/workflows/ci.yml',
+  },
+  bitbucket: {
+    name: 'Bitbucket',
+    detect: ['bitbucket-pipelines.yml'],
+    folders: [],
+    prCommand: 'Manual PR via Bitbucket UI',
+    ciFile: 'bitbucket-pipelines.yml',
+  },
+  'azure-devops': {
+    name: 'Azure DevOps',
+    detect: ['azure-pipelines.yml', '.azure/'],
+    folders: ['.azure'],
+    prCommand: 'az repos pr create',
+    ciFile: 'azure-pipelines.yml',
+  },
+  'git-only': {
+    name: 'Git (no platform)',
+    detect: ['.git/'],
+    folders: [],
+    prCommand: null,
+    ciFile: null,
+  },
+  none: {
+    name: 'No VCS',
+    detect: [],
+    folders: [],
+    prCommand: null,
+    ciFile: null,
+  },
+};
+
+/**
+ * Detect VCS type from project structure
+ */
+function detectVcs(projectPath = process.cwd()) {
+  const result = {
+    type: 'none',
+    autoDetected: true,
+    hasGit: false,
+    platform: null,
+    confidence: 'low',
+  };
+
+  // Check for .git directory first
+  const gitDir = path.join(projectPath, '.git');
+  if (fs.existsSync(gitDir)) {
+    result.hasGit = true;
+    result.type = 'git-only';
+    result.confidence = 'medium';
+  }
+
+  // Check for platform-specific indicators (in order of specificity)
+  const platforms = ['github', 'gitlab', 'gitea', 'azure-devops', 'bitbucket'];
+
+  for (const platform of platforms) {
+    const config = VCS_TYPES[platform];
+    for (const pattern of config.detect) {
+      const checkPath = path.join(projectPath, pattern);
+      if (fs.existsSync(checkPath)) {
+        result.type = platform;
+        result.platform = config.name;
+        result.confidence = 'high';
+        return result;
+      }
+    }
+  }
+
+  // Try to detect from git remote
+  if (result.hasGit) {
+    try {
+      const gitConfigPath = path.join(gitDir, 'config');
+      if (fs.existsSync(gitConfigPath)) {
+        const gitConfig = fs.readFileSync(gitConfigPath, 'utf8');
+
+        if (gitConfig.includes('github.com')) {
+          result.type = 'github';
+          result.platform = 'GitHub';
+          result.confidence = 'medium';
+        } else if (gitConfig.includes('gitlab.com') || gitConfig.includes('gitlab')) {
+          result.type = 'gitlab';
+          result.platform = 'GitLab';
+          result.confidence = 'medium';
+        } else if (gitConfig.includes('gitea') || gitConfig.includes('codeberg.org')) {
+          // Gitea instances (including Codeberg which runs on Gitea)
+          result.type = 'gitea';
+          result.platform = 'Gitea';
+          result.confidence = 'medium';
+        } else if (gitConfig.includes('bitbucket.org')) {
+          result.type = 'bitbucket';
+          result.platform = 'Bitbucket';
+          result.confidence = 'medium';
+        } else if (gitConfig.includes('dev.azure.com') || gitConfig.includes('visualstudio.com')) {
+          result.type = 'azure-devops';
+          result.platform = 'Azure DevOps';
+          result.confidence = 'medium';
+        }
+      }
+    } catch (e) {
+      // Ignore git config read errors
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Get current VCS configuration from forge config
+ */
+function getVcsConfig(projectPath = process.cwd()) {
+  const configFile = path.join(projectPath, '.forge', 'config.json');
+
+  if (!fs.existsSync(configFile)) {
+    return null;
+  }
+
+  try {
+    const config = JSON.parse(fs.readFileSync(configFile, 'utf8'));
+    return config.vcs || null;
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * Save VCS configuration to forge config
+ */
+function setVcsConfig(vcsType, projectPath = process.cwd()) {
+  const configDir = path.join(projectPath, '.forge');
+  const configFile = path.join(configDir, 'config.json');
+
+  // Ensure directory exists
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+
+  // Load existing config or create new
+  let config = {};
+  if (fs.existsSync(configFile)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configFile, 'utf8'));
+    } catch (e) {
+      // Start fresh if invalid
+    }
+  }
+
+  // Validate VCS type
+  if (!VCS_TYPES[vcsType]) {
+    console.error(`Invalid VCS type: ${vcsType}`);
+    console.error(`Valid types: ${Object.keys(VCS_TYPES).join(', ')}`);
+    process.exit(1);
+  }
+
+  // Update VCS config
+  config.vcs = {
+    type: vcsType,
+    name: VCS_TYPES[vcsType].name,
+    autoDetected: false,
+    lastUpdated: new Date().toISOString(),
+  };
+
+  fs.writeFileSync(configFile, JSON.stringify(config, null, 2) + '\n');
+
+  return config.vcs;
+}
+
+/**
+ * Initialize VCS folders for the selected platform
+ */
+function initVcsFolders(vcsType, projectPath = process.cwd()) {
+  if (!VCS_TYPES[vcsType]) {
+    console.error(`Invalid VCS type: ${vcsType}`);
+    process.exit(1);
+  }
+
+  const config = VCS_TYPES[vcsType];
+  const created = [];
+
+  // Initialize .git if needed and type isn't 'none'
+  if (vcsType !== 'none') {
+    const gitDir = path.join(projectPath, '.git');
+    if (!fs.existsSync(gitDir)) {
+      // Don't auto-init git, just note it's needed
+      console.log('Note: Run "git init" to initialize git repository');
+    }
+  }
+
+  // Create platform-specific folders
+  for (const folder of config.folders) {
+    const folderPath = path.join(projectPath, folder);
+    if (!fs.existsSync(folderPath)) {
+      fs.mkdirSync(folderPath, { recursive: true });
+      created.push(folder);
+    }
+  }
+
+  return created;
+}
+
+/**
+ * Get workflow guidance for the detected VCS type
+ */
+function getWorkflowGuidance(vcsType) {
+  const config = VCS_TYPES[vcsType];
+  if (!config) return null;
+
+  return {
+    type: vcsType,
+    name: config.name,
+    prCommand: config.prCommand,
+    ciFile: config.ciFile,
+    branchWorkflow: vcsType !== 'none',
+    hasPullRequests: config.prCommand !== null,
+    hasCI: config.ciFile !== null,
+  };
+}
+
+// CLI interface
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] || 'detect';
+  const arg1 = args[1];
+  const arg2 = args[2];
+
+  switch (command) {
+    case 'detect': {
+      const projectPath = arg1 || process.cwd();
+      const result = detectVcs(projectPath);
+      console.log(JSON.stringify(result, null, 2));
+      break;
+    }
+
+    case 'get': {
+      const projectPath = arg1 || process.cwd();
+      const config = getVcsConfig(projectPath);
+      if (config) {
+        console.log(JSON.stringify(config, null, 2));
+      } else {
+        console.log('null');
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'set': {
+      const vcsType = arg1;
+      const projectPath = arg2 || process.cwd();
+      if (!vcsType) {
+        console.error('Usage: node vcs.js set <type> [project-path]');
+        console.error(`Types: ${Object.keys(VCS_TYPES).join(', ')}`);
+        process.exit(1);
+      }
+      const result = setVcsConfig(vcsType, projectPath);
+      console.log(JSON.stringify(result, null, 2));
+      break;
+    }
+
+    case 'init': {
+      const vcsType = arg1;
+      const projectPath = arg2 || process.cwd();
+      if (!vcsType) {
+        console.error('Usage: node vcs.js init <type> [project-path]');
+        process.exit(1);
+      }
+      const created = initVcsFolders(vcsType, projectPath);
+      setVcsConfig(vcsType, projectPath);
+      console.log(JSON.stringify({ type: vcsType, foldersCreated: created }, null, 2));
+      break;
+    }
+
+    case 'guidance': {
+      const vcsType = arg1;
+      if (!vcsType) {
+        console.error('Usage: node vcs.js guidance <type>');
+        process.exit(1);
+      }
+      const guidance = getWorkflowGuidance(vcsType);
+      console.log(JSON.stringify(guidance, null, 2));
+      break;
+    }
+
+    case 'types': {
+      const types = Object.entries(VCS_TYPES).map(([key, val]) => ({
+        type: key,
+        name: val.name,
+      }));
+      console.log(JSON.stringify(types, null, 2));
+      break;
+    }
+
+    default:
+      console.error(`Unknown command: ${command}`);
+      console.error('Commands: detect, get, set, init, guidance, types');
+      process.exit(1);
+  }
+}
+
+// Export for use as module
+module.exports = {
+  detectVcs,
+  getVcsConfig,
+  setVcsConfig,
+  initVcsFolders,
+  getWorkflowGuidance,
+  VCS_TYPES,
+};
+
+// Run CLI if executed directly
+if (require.main === module) {
+  main();
+}