vibe-forge 0.4.0 → 0.8.1

package/bin/lib/vcs.js

@@ -1,349 +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();
-}
+#!/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();
+}