forge-workflow 0.0.3 → 0.0.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Harsha Nandak
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Harsha Nandak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -45,7 +45,7 @@ Ship features with confidence using a 7-stage TDD-first workflow for AI coding a
 **With Forge** (systematic):
 - Tests written BEFORE code (TDD)
 - Research-backed decisions
-- OWASP Top 10 analysis built-in
+- OWASP Top 10 analysis in every /plan
 - Documentation at every stage
 
 → [See complete walkthrough in QUICKSTART.md](QUICKSTART.md)
@@ -78,7 +78,7 @@ bunx forge setup
 
 | Stage | Command | Purpose |
 |-------|---------|---------|
-| **utility** | `/status` | Check current context, active work |
+| **utility** | `/status` | Ranked issue dashboard with conflict detection |
 | **1. Plan** | `/plan` | Design Q&A → research → branch + task list |
 | **2. Dev** | `/dev` | Subagent TDD per task (spec + quality review) |
 | **3. Validate** | `/validate` | Validate: types, lint, tests, security |
@@ -87,13 +87,13 @@ bunx forge setup
 | **6. Premerge** | `/premerge` | Complete docs on feature branch, hand off PR |
 | **7. Verify** | `/verify` | Post-merge health check (CI on main) |
 
-**Full workflow guide**: [docs/WORKFLOW.md](docs/WORKFLOW.md)
+**Full workflow guide**: [AGENTS.md](AGENTS.md)
 
 ---
 
 ## Supported AI Agents
 
-Works with **7 AI coding agents** via universal AGENTS.md:
+Works with **8 AI coding agents** via universal AGENTS.md:
 
 ### Tier 1 (Primary Support)
 
@@ -163,7 +163,7 @@ One workflow, works with ALL major AI agents:
 
 Switch agents anytime without changing your workflow.
 
-### 4. Built-in TDD Enforcement (v1.5.0)
+### 4. Built-in TDD Enforcement
 Git hooks automatically enforce TDD practices:
 - **Pre-commit**: Blocks source commits without tests
 - **Pre-push**: Runs full test suite before push
@@ -172,16 +172,16 @@ Git hooks automatically enforce TDD practices:
 
 ```bash
 # Validation CLI
-forge-validate status    # Check project prerequisites
-forge-validate dev       # Validate before /dev stage
-forge-validate ship      # Validate before /ship stage
+forge-preflight status    # Check project prerequisites
+forge-preflight dev       # Validate before /dev stage
+forge-preflight ship      # Validate before /ship stage
 ```
 
-### 5. Smart Tool Recommendations (v1.7.0)
-Intelligent plugin catalog with 30+ curated tools:
+### 5. Smart Tool Recommendations
+Curated plugin catalog across 7 workflow stages — plan, dev, validate, ship, review, and more:
 - **Auto-detection**: Scans your project for frameworks, databases, auth, payments, and more
 - **Budget modes**: free, open-source, startup, professional, custom
-- **CLI-first**: Prefers CLI tools over MCPs for portability
+- **Portability-first**: MCPs included only when they add clear value over CLI alternatives
 - **Free alternatives**: Every paid tool shows free alternatives
 
 ```bash
@@ -189,9 +189,9 @@ bunx forge recommend                  # Recommendations for your project
 bunx forge recommend --budget free    # Only free tools
 ```
 
-→ [Validation docs](docs/VALIDATION.md) | [Plugin docs](lib/agents/README.md)
+→ [Validation docs](docs/VALIDATION.md) | [Plugin docs](docs/TOOLCHAIN.md)
 
-### 6. Enhanced Onboarding (v1.6.0) 🆕
+### 6. Enhanced Onboarding
 Smart setup that adapts to your project:
 
 **Intelligent File Merging**
@@ -210,11 +210,13 @@ bunx forge setup --merge=smart    # Intelligent merge
 - Saves to `.forge/context.json`
 
 **Workflow Profiles**
-- Adapts workflow based on work type:
-  - `feature`: Full 7-stage workflow (auto-escalates to critical for auth/payment)
-  - `fix`: Streamlined 5-stage workflow (auto-escalates to hotfix for production)
+- Adapts workflow based on work type (3-8 stages):
+  - `critical`: Full 8-stage workflow (auth, payments, security-sensitive)
+  - `standard`: 7-stage workflow (typical features)
   - `refactor`: Behavior-preserving 5-stage workflow
-  - `chore`: Minimal 3-stage workflow (docs/deps/config)
+  - `simple`: Streamlined 4-stage workflow
+  - `hotfix`: Minimal 3-stage workflow (production fixes)
+  - `docs`: Minimal 3-stage workflow (documentation/config)
 ```bash
 bunx forge setup --type=critical    # Set workflow manually
 ```
@@ -348,7 +350,7 @@ gh auth login
 **Documentation Progressive**: Update at each stage
 **Multi-Session**: Work persists across sessions
 
-→ [Read the philosophy in docs/WORKFLOW.md](docs/WORKFLOW.md)
+→ [Read the philosophy in AGENTS.md](AGENTS.md)
 
 ---
 
@@ -358,7 +360,7 @@ gh auth login
 → [QUICKSTART.md](QUICKSTART.md) - Your first feature in 5 minutes
 
 📖 **Learn the workflow**
-→ [docs/WORKFLOW.md](docs/WORKFLOW.md) - Complete guide with examples
+→ [AGENTS.md](AGENTS.md) - Complete guide with examples
 
 🛠️ **Setup the toolchain**
 → [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) - Beads, GitHub CLI

package/bin/{forge-validate.js → forge-preflight.js}

@@ -1,22 +1,21 @@
 #!/usr/bin/env node
 
 /**
- * Forge Validate CLI
+ * Forge Preflight CLI
  *
  * Prerequisite validation for workflow stages.
  * Helps ensure developers have required tools and files before proceeding.
  *
  * Usage:
- *   forge-validate status  - Check project prerequisites
- *   forge-validate dev     - Validate before /dev stage
- *   forge-validate ship    - Validate before /ship stage
+ *   forge-preflight status  - Check project prerequisites
+ *   forge-preflight dev     - Validate before /dev stage
+ *   forge-preflight ship    - Validate before /ship stage
  *
  * Security: Uses execFileSync to prevent command injection.
  */
 
 const { execFileSync } = require("node:child_process");
 const fs = require("node:fs");
-// const path = require("node:path"); // Currently unused
 
 // Validation results
 let checks = [];
@@ -52,6 +51,7 @@ function printResults() {
 // Validation functions
 
 function validateStatus() {
+  checks = [];
   console.log("Checking project prerequisites...\n");
 
   check(
@@ -100,6 +100,7 @@ function validateStatus() {
 }
 
 function validateDev() {
+  checks = [];
   console.log("Validating prerequisites for /dev stage...\n");
 
   check(
@@ -129,15 +130,15 @@ function validateDev() {
     "Plan file exists",
     () => {
       try {
-        const plansDir = ".claude/plans";
+        const plansDir = "docs/plans";
         if (!fs.existsSync(plansDir)) return false;
-        const plans = fs.readdirSync(plansDir).filter((f) => f.endsWith(".md"));
+        const plans = fs.readdirSync(plansDir).filter((f) => f.endsWith("-design.md"));
         return plans.length > 0;
       } catch {
         return false;
       }
     },
-    "No plan file found in .claude/plans/. Run: /plan",
+    "No plan file found in docs/plans/. Run: /plan",
   );
 
   check(
@@ -173,6 +174,7 @@ function validateDev() {
 }
 
 function validateShip() {
+  checks = [];
   console.log("Validating prerequisites for /ship stage...\n");
 
   check(
@@ -182,7 +184,7 @@ function validateShip() {
       return testDirs.some((dir) => {
         if (!fs.existsSync(dir)) return false;
         try {
-          const files = fs.readdirSync(dir, { recursive: true });
+          const files = fs.readdirSync(dir);
           return files.some(
             (f) => f.includes(".test.") || f.includes(".spec."),
           );
@@ -200,7 +202,11 @@ function validateShip() {
       try {
         execFileSync("npm", ["test"], { stdio: "pipe" });
         return true;
-      } catch {
+      } catch (err) {
+        const output = ((err.stdout || "") + "\n" + (err.stderr || "")).trim();
+        if (output) {
+          console.error("\nTest output:\n" + output.slice(0, 2000));
+        }
         return false;
       }
     },
@@ -235,10 +241,10 @@ function validateShip() {
 
 function showHelp() {
   console.log(`
-Forge Validate - Prerequisite validation for workflow stages
+Forge Preflight - Prerequisite validation for workflow stages
 
 Usage:
-  forge-validate <command>
+  forge-preflight <command>
 
 Commands:
   status    Check project prerequisites (git, npm, tests)
@@ -247,9 +253,9 @@ Commands:
   help      Show this help message
 
 Examples:
-  forge-validate status
-  forge-validate dev
-  forge-validate ship
+  forge-preflight status
+  forge-preflight dev
+  forge-preflight ship
 `);
 }