forge-workflow 1.4.7 → 1.5.0

package/lib/agents/claude.plugin.json

@@ -0,0 +1,28 @@
+{
+  "id": "claude",
+  "name": "Claude Code",
+  "version": "1.0.0",
+  "description": "Anthropic's CLI agent",
+  "homepage": "https://claude.ai/code",
+  "capabilities": {
+    "commands": true,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "commands": ".claude/commands",
+    "rules": ".claude/rules",
+    "skills": ".claude/skills/forge-workflow",
+    "scripts": ".claude/scripts"
+  },
+  "files": {
+    "rootConfig": "CLAUDE.md",
+    "skillDefinition": ".claude/skills/forge-workflow/SKILL.md"
+  },
+  "setup": {
+    "copyCommands": true,
+    "copyRules": true,
+    "copyScripts": true,
+    "createSkill": true
+  }
+}

package/lib/agents/cline.plugin.json

@@ -0,0 +1,21 @@
+{
+  "id": "cline",
+  "name": "Cline",
+  "version": "1.0.0",
+  "description": "VS Code agent extension",
+  "homepage": "https://github.com/cline/cline",
+  "capabilities": {
+    "commands": false,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "skills": ".cline/skills/forge-workflow"
+  },
+  "files": {
+    "rootConfig": ".clinerules"
+  },
+  "setup": {
+    "createSkill": true
+  }
+}

package/lib/agents/continue.plugin.json

@@ -0,0 +1,21 @@
+{
+  "id": "continue",
+  "name": "Continue",
+  "version": "1.0.0",
+  "description": "Open-source AI assistant",
+  "homepage": "https://continue.dev",
+  "capabilities": {
+    "commands": false,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "prompts": ".continue/prompts",
+    "skills": ".continue/skills/forge-workflow"
+  },
+  "setup": {
+    "createSkill": true,
+    "needsConversion": true,
+    "continueFormat": true
+  }
+}

package/lib/agents/copilot.plugin.json

@@ -0,0 +1,23 @@
+{
+  "id": "copilot",
+  "name": "GitHub Copilot",
+  "version": "1.0.0",
+  "description": "GitHub's AI assistant",
+  "homepage": "https://github.com/features/copilot",
+  "capabilities": {
+    "commands": false,
+    "skills": false,
+    "hooks": false
+  },
+  "directories": {
+    "prompts": ".github/prompts",
+    "instructions": ".github/instructions"
+  },
+  "files": {
+    "rootConfig": ".github/copilot-instructions.md"
+  },
+  "setup": {
+    "needsConversion": true,
+    "promptFormat": true
+  }
+}

package/lib/agents/cursor.plugin.json

@@ -0,0 +1,24 @@
+{
+  "id": "cursor",
+  "name": "Cursor",
+  "version": "1.0.0",
+  "description": "AI-first code editor",
+  "homepage": "https://cursor.sh",
+  "capabilities": {
+    "commands": false,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "rules": ".cursor/rules",
+    "skills": ".cursor/skills/forge-workflow"
+  },
+  "files": {
+    "rootConfig": ".cursorrules"
+  },
+  "setup": {
+    "copyRules": true,
+    "createSkill": true,
+    "customSetup": "cursor"
+  }
+}

package/lib/agents/kilocode.plugin.json

@@ -0,0 +1,22 @@
+{
+  "id": "kilocode",
+  "name": "Kilo Code",
+  "version": "1.0.0",
+  "description": "VS Code extension",
+  "homepage": "https://marketplace.visualstudio.com/items?itemName=kilo-code",
+  "capabilities": {
+    "commands": false,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "workflows": ".kilocode/workflows",
+    "rules": ".kilocode/rules",
+    "skills": ".kilocode/skills/forge-workflow"
+  },
+  "setup": {
+    "copyRules": true,
+    "createSkill": true,
+    "needsConversion": true
+  }
+}

package/lib/agents/opencode.plugin.json

@@ -0,0 +1,20 @@
+{
+  "id": "opencode",
+  "name": "OpenCode",
+  "version": "1.0.0",
+  "description": "Open-source agent",
+  "homepage": "https://github.com/opencode",
+  "capabilities": {
+    "commands": true,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "commands": ".opencode/commands",
+    "skills": ".opencode/skills/forge-workflow"
+  },
+  "setup": {
+    "copyCommands": true,
+    "createSkill": true
+  }
+}

package/lib/agents/roo.plugin.json

@@ -0,0 +1,22 @@
+{
+  "id": "roo",
+  "name": "Roo Code",
+  "version": "1.0.0",
+  "description": "Cline fork with modes",
+  "homepage": "https://github.com/roocode/roo",
+  "capabilities": {
+    "commands": true,
+    "skills": false,
+    "hooks": false
+  },
+  "directories": {
+    "commands": ".roo/commands"
+  },
+  "files": {
+    "rootConfig": ".clinerules"
+  },
+  "setup": {
+    "copyCommands": true,
+    "needsConversion": true
+  }
+}

package/lib/agents/windsurf.plugin.json

@@ -0,0 +1,25 @@
+{
+  "id": "windsurf",
+  "name": "Windsurf",
+  "version": "1.0.0",
+  "description": "Codeium's agentic IDE",
+  "homepage": "https://codeium.com/windsurf",
+  "capabilities": {
+    "commands": false,
+    "skills": true,
+    "hooks": false
+  },
+  "directories": {
+    "workflows": ".windsurf/workflows",
+    "rules": ".windsurf/rules",
+    "skills": ".windsurf/skills/forge-workflow"
+  },
+  "files": {
+    "rootConfig": ".windsurfrules"
+  },
+  "setup": {
+    "copyRules": true,
+    "createSkill": true,
+    "needsConversion": true
+  }
+}

package/lib/plugin-manager.js

@@ -0,0 +1,115 @@
+/**
+ * Plugin Manager
+ *
+ * Handles loading, validating, and managing agent plugin JSON files.
+ * Provides discoverable plugin architecture for AI coding agents.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+class PluginManager {
+  constructor() {
+    this.plugins = new Map();
+    this.loadPlugins();
+  }
+
+  /**
+   * Load all plugin files from lib/agents/ directory
+   */
+  loadPlugins() {
+    const pluginDir = path.join(__dirname, 'agents');
+
+    // Create directory if it doesn't exist (for first-time setup)
+    if (!fs.existsSync(pluginDir)) {
+      fs.mkdirSync(pluginDir, { recursive: true });
+      return;
+    }
+
+    const files = fs.readdirSync(pluginDir)
+      .filter(f => f.endsWith('.plugin.json'));
+
+    files.forEach(file => {
+      try {
+        const content = fs.readFileSync(path.join(pluginDir, file), 'utf-8');
+        const plugin = JSON.parse(content);
+        this.validatePlugin(plugin);
+
+        // Check for duplicate IDs
+        if (this.plugins.has(plugin.id)) {
+          throw new Error(`Plugin with ID "${plugin.id}" already exists`);
+        }
+
+        this.plugins.set(plugin.id, plugin);
+      } catch (error) {
+        // Re-throw with file context
+        throw new Error(`Failed to load plugin ${file}: ${error.message}`);
+      }
+    });
+  }
+
+  /**
+   * Validate plugin schema
+   * @param {Object} plugin - Plugin object to validate
+   * @throws {Error} If validation fails
+   */
+  validatePlugin(plugin) {
+    const required = ['id', 'name', 'version', 'directories'];
+
+    // Check required fields exist
+    required.forEach(field => {
+      if (!plugin[field]) {
+        throw new Error(`Plugin validation failed: missing required field "${field}"`);
+      }
+    });
+
+    // Validate field types
+    if (typeof plugin.id !== 'string') {
+      throw new Error('Plugin validation failed: "id" must be a string');
+    }
+    if (typeof plugin.name !== 'string') {
+      throw new Error('Plugin validation failed: "name" must be a string');
+    }
+    if (typeof plugin.version !== 'string') {
+      throw new Error('Plugin validation failed: "version" must be a string');
+    }
+    if (typeof plugin.directories !== 'object' || Array.isArray(plugin.directories)) {
+      throw new Error('Plugin validation failed: "directories" must be an object');
+    }
+
+    // Validate optional fields if present
+    if (plugin.description && typeof plugin.description !== 'string') {
+      throw new Error('Plugin validation failed: "description" must be a string');
+    }
+    if (plugin.homepage && typeof plugin.homepage !== 'string') {
+      throw new Error('Plugin validation failed: "homepage" must be a string');
+    }
+  }
+
+  /**
+   * Get plugin by ID
+   * @param {string} id - Plugin ID
+   * @returns {Object|undefined} Plugin object or undefined if not found
+   */
+  getPlugin(id) {
+    return this.plugins.get(id);
+  }
+
+  /**
+   * Get all plugins as a Map
+   * @returns {Map} Map of plugin ID to plugin object
+   */
+  getAllPlugins() {
+    return this.plugins;
+  }
+
+  /**
+   * Get list of all agent IDs
+   * @returns {Array<string>} Array of plugin IDs
+   */
+  listAgents() {
+    return Array.from(this.plugins.keys());
+  }
+}
+
+module.exports = PluginManager;

package/package.json

@@ -1,15 +1,29 @@
 {
   "name": "forge-workflow",
-  "version": "1.4.7",
+  "version": "1.5.0",
   "description": "9-stage TDD workflow for ALL AI coding agents (Claude, Cursor, Windsurf, Kilo, OpenCode, Copilot, Cline, Roo, Aider, Continue, Antigravity)",
   "bin": {
-    "forge": "bin/forge.js"
+    "forge": "bin/forge.js",
+    "forge-validate": "bin/forge-validate.js"
   },
   "scripts": {
+    "test": "node --test test/**/*.test.js",
     "postinstall": "node ./bin/forge.js",
+    "prepare": "lefthook install || echo 'Note: lefthook not installed. Git hooks disabled. Run: npm install -D lefthook'",
     "setup": "node ./bin/forge.js setup",
     "help": "node ./bin/forge.js --help"
   },
+  "peerDependencies": {
+    "lefthook": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "lefthook": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "lefthook": "^1.10.1"
+  },
   "keywords": [
     "ai",
     "workflow",
@@ -41,12 +55,16 @@
   },
   "files": [
     "bin/",
+    "lib/",
     ".claude/commands/",
     ".claude/rules/",
     ".claude/scripts/",
     ".claude/skills/",
+    ".forge/hooks/",
+    ".github/PLUGIN_TEMPLATE.json",
     "docs/",
     "install.sh",
+    "lefthook.yml",
     "AGENTS.md",
     "CLAUDE.md",
     ".mcp.json.example"

package/.claude/skills/forge-workflow/SKILL.md

@@ -1,46 +0,0 @@
----
-name: forge-workflow
-description: 9-stage TDD-first workflow for feature development. Use when building features, fixing bugs, or shipping PRs.
-category: Development Workflow
-tags: [tdd, workflow, pr, git, testing]
-tools: [Bash, Read, Write, Edit, Grep, Glob]
----
-
-# Forge Workflow Skill
-
-A TDD-first workflow for AI coding agents. Ship features with confidence.
-
-## When to Use
-
-Automatically invoke this skill when the user wants to:
-- Build a new feature
-- Fix a bug
-- Create a pull request
-- Run the development workflow
-
-## 9 Stages
-
-| Stage | Command | Description |
-|-------|---------|-------------|
-| 1 | `/status` | Check current context, active work, recent completions |
-| 2 | `/research` | Deep research with web search, document to docs/research/ |
-| 3 | `/plan` | Create implementation plan, branch, OpenSpec if strategic |
-| 4 | `/dev` | TDD development (RED-GREEN-REFACTOR cycles) |
-| 5 | `/check` | Validation (type/lint/security/tests) |
-| 6 | `/ship` | Create PR with full documentation |
-| 7 | `/review` | Address ALL PR feedback |
-| 8 | `/merge` | Update docs, merge PR, cleanup |
-| 9 | `/verify` | Final documentation verification |
-
-## Workflow Flow
-
-```
-/status -> /research -> /plan -> /dev -> /check -> /ship -> /review -> /merge -> /verify
-```
-
-## Core Principles
-
-- **TDD-First**: Write tests BEFORE implementation (RED-GREEN-REFACTOR)
-- **Research-First**: Understand before building, document decisions
-- **Security Built-In**: OWASP Top 10 analysis for every feature
-- **Documentation Progressive**: Update at each stage, verify at end