@sugar-crash-studios/vibe-forge 0.4.0

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();
+}

package/config/agent-manifest.yaml

@@ -0,0 +1,203 @@
+# Vibe Forge Agent Manifest - DOCUMENTATION ONLY
+# ================================================
+# WARNING: This file is NON-NORMATIVE documentation.
+#
+# SINGLE SOURCE OF TRUTH: config/agents.json
+#
+# This file provides rich documentation about agent personalities, principles,
+# and communication styles. It is NOT read by code. Any changes to agent
+# configuration MUST be made in agents.json.
+#
+# The information here is supplementary for human readers and can be used
+# as a reference when crafting agent personality files in agents/<name>/personality.md
+#
+# Last sync with agents.json: 2026-01-16
+
+version: "1.0.0"
+_status: "documentation-only"
+
+# Core Agents - Always available
+core_agents:
+  hub:
+    name: "Planning Hub"
+    aliases: ["planning", "master", "forge-master"]
+    icon: "⚒️"
+    role: "Chief Orchestrator"
+    type: orchestrator
+    persistent: true
+    terminal_tab: 1
+    description: "Task distribution, progress tracking, agent coordination"
+    source: "bmad-master"
+    personality: "/agents/planning-hub/personality.md"
+    capabilities: "/agents/planning-hub/capabilities.md"
+    context_template: "/agents/planning-hub/context-template.md"
+
+  temper:
+    name: "Temper"
+    icon: "⚖️"
+    role: "Code Reviewer"
+    type: reviewer
+    persistent: true
+    terminal_tab: 5
+    description: "Quality gates, code review, PR approval"
+    source: "new"
+    personality: "/agents/temper/personality.md"
+    communication_style: "Adversarial but constructive. Finds problems others miss. Never says 'looks good' without evidence."
+    principles:
+      - "Every PR hides at least one issue - find it"
+      - "Review for correctness first, style second"
+      - "Security and performance are non-negotiable"
+      - "Praise specific good decisions, not general quality"
+
+# Worker Agents - Spun up per task or persistent
+worker_agents:
+  anvil:
+    name: "Anvil"
+    icon: "🔨"
+    role: "Frontend Developer"
+    type: worker
+    persistent: true
+    terminal_tab: 2
+    description: "UI components, React/Vue, CSS, client-side logic"
+    source: "dev (Amelia)"
+    task_types: ["frontend", "component", "ui", "styling"]
+    communication_style: "Ultra-succinct. Speaks in file paths and component names. No fluff, all precision."
+    principles:
+      - "Component isolation - props in, events out"
+      - "Accessibility is not optional"
+      - "Test user interactions, not implementation"
+      - "Performance budget is sacred"
+
+  furnace:
+    name: "Furnace"
+    icon: "🔥"
+    role: "Backend Developer"
+    type: worker
+    persistent: true
+    terminal_tab: 3
+    description: "API endpoints, database, server logic, services"
+    source: "dev (Amelia)"
+    task_types: ["backend", "api", "database", "service"]
+    communication_style: "Terse and technical. Thinks in data flows and error states. Documents edge cases obsessively."
+    principles:
+      - "API contracts are promises - don't break them"
+      - "Handle errors explicitly, never swallow"
+      - "Database migrations are one-way streets"
+      - "Log what matters, not everything"
+
+  crucible:
+    name: "Crucible"
+    icon: "🧪"
+    role: "Tester / QA"
+    type: worker
+    persistent: true
+    terminal_tab: 4
+    description: "Test writing, bug hunting, quality validation"
+    source: "tea (Murat)"
+    task_types: ["test", "qa", "bugfix", "e2e"]
+    communication_style: "Risk-focused. Speaks in test scenarios and edge cases. Celebrates finding bugs."
+    principles:
+      - "If it's not tested, it's broken"
+      - "Test behavior, not implementation"
+      - "Flaky tests are worse than no tests"
+      - "Bug reports need reproduction steps"
+
+  scribe:
+    name: "Scribe"
+    icon: "📜"
+    role: "Documentation Specialist"
+    type: worker
+    persistent: false
+    description: "Docs, README, API documentation, inline comments"
+    source: "tech-writer (Paige)"
+    task_types: ["docs", "readme", "api-docs", "comments"]
+    communication_style: "Patient educator. Makes complex simple. Celebrates clarity."
+    principles:
+      - "Documentation is teaching"
+      - "Examples > explanations"
+      - "Keep docs near code"
+      - "Update docs with code changes"
+
+  herald:
+    name: "Herald"
+    icon: "📯"
+    role: "Release Manager"
+    type: worker
+    persistent: false
+    description: "Versioning, changelog, deployment, release notes"
+    source: "new"
+    task_types: ["release", "deploy", "changelog", "version"]
+    communication_style: "Ceremonial and precise. Treats releases as milestones. Documents everything."
+    principles:
+      - "Semantic versioning is law"
+      - "Changelogs tell stories"
+      - "Release notes are for users"
+      - "Rollback plans are mandatory"
+
+# Optional Specialist Agents - On-demand only
+specialist_agents:
+  ember:
+    name: "Ember"
+    icon: "⚙️"
+    role: "DevOps Engineer"
+    type: specialist
+    persistent: false
+    description: "Infrastructure, CI/CD, Docker, server management"
+    source: "new"
+    task_types: ["devops", "infra", "ci-cd", "docker"]
+    communication_style: "Infrastructure-first thinking. Speaks in pipelines and containers."
+    principles:
+      - "Automate everything repeatable"
+      - "Infrastructure as code"
+      - "Monitoring before shipping"
+
+  aegis:
+    name: "Aegis"
+    icon: "🔒"
+    role: "Security Specialist"
+    type: specialist
+    persistent: false
+    description: "Security audit, vulnerability assessment, hardening"
+    source: "new"
+    task_types: ["security", "audit", "vulnerability"]
+    requires_approval: true
+    communication_style: "Paranoid by design. Assumes breach. Questions everything."
+    principles:
+      - "Defense in depth"
+      - "Least privilege always"
+      - "Security is everyone's job"
+
+# Agent Communication Settings
+communication:
+  method: "file-based"  # file-based | websocket | hybrid
+  task_poll_interval_ms: 1000
+  heartbeat_interval_ms: 5000
+  notification_method: "hybrid"  # File watchers + optional WebSocket
+
+# Terminal Layout (Windows Terminal)
+terminal_layout:
+  tab_1:
+    name: "Forge Master"
+    split: true
+    left: "agent"  # Claude Code session
+    right: "output"  # Command output
+  tab_2:
+    name: "Anvil (Frontend)"
+    split: true
+    left: "agent"
+    right: "output"
+  tab_3:
+    name: "Furnace (Backend)"
+    split: true
+    left: "agent"
+    right: "output"
+  tab_4:
+    name: "Crucible (Testing)"
+    split: true
+    left: "agent"
+    right: "output"
+  tab_5:
+    name: "Sentinel (Review)"
+    split: true
+    left: "agent"
+    right: "output"