forge-workflow 1.1.2 → 1.2.0

package/.claude/settings.local.json

@@ -12,7 +12,9 @@
       "Bash(git add:*)",
       "Bash(git commit:*)",
       "Bash(git push)",
-      "Bash(\"C:\\\\Program Files\\\\nodejs\\\\npm.cmd\" pkg fix)"
+      "Bash(\"C:\\\\Program Files\\\\nodejs\\\\npm.cmd\" pkg fix)",
+      "WebFetch(domain:www.aihero.dev)",
+      "Bash(\"C:\\\\Program Files\\\\nodejs\\\\npm.cmd\" version minor --no-git-tag-version)"
     ]
   }
 }

package/bin/forge.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * Forge v1.1.2 - Universal AI Agent Workflow
+ * Forge v1.2.0 - Universal AI Agent Workflow
  * https://github.com/harshanandak/forge
  *
  * Usage:
@@ -11,6 +11,7 @@
  *   npx forge setup --agents claude,cursor,windsurf
  *
  * CLI Flags:
+ *   --path, -p <dir>     Target project directory (creates if needed)
  *   --quick, -q          Use all defaults, minimal prompts
  *   --skip-external      Skip external services configuration
  *   --agents <list>      Specify agents (--agents claude cursor OR --agents=claude,cursor)
@@ -19,6 +20,7 @@
  *
  * Examples:
  *   npx forge setup --quick                    # All defaults, no prompts
+ *   npx forge setup -p ./my-project            # Setup in specific directory
  *   npx forge setup --agents claude cursor     # Just these agents
  *   npx forge setup --skip-external            # No service prompts
  *   npx forge setup --agents claude --quick    # Quick + specific agent
@@ -589,6 +591,27 @@ function writeEnvTokens(tokens, preserveExisting = true) {
 }
 
 // Detect existing project installation status
+// Helper function for yes/no prompts with validation
+async function askYesNo(question, prompt, defaultNo = true) {
+  const defaultText = defaultNo ? '[n]' : '[y]';
+  while (true) {
+    const answer = await question(`${prompt} (y/n) ${defaultText}: `);
+    const normalized = answer.trim().toLowerCase();
+
+    // Handle empty input (use default)
+    if (normalized === '') return defaultNo ? false : true;
+
+    // Accept yes variations
+    if (normalized === 'y' || normalized === 'yes') return true;
+
+    // Accept no variations
+    if (normalized === 'n' || normalized === 'no') return false;
+
+    // Invalid input - re-prompt
+    console.log('  Please enter y or n');
+  }
+}
+
 function detectProjectStatus() {
   const status = {
     type: 'fresh', // 'fresh', 'upgrade', or 'partial'
@@ -602,10 +625,10 @@ function detectProjectStatus() {
   // Determine installation type
   if (status.hasAgentsMd && status.hasClaudeCommands && status.hasDocsWorkflow) {
     status.type = 'upgrade'; // Full forge installation exists
-  } else if (status.hasAgentsMd || status.hasClaudeCommands || status.hasEnvLocal) {
-    status.type = 'partial'; // Some files exist
+  } else if (status.hasClaudeCommands || status.hasEnvLocal) {
+    status.type = 'partial'; // Agent-specific files exist (not just base files from postinstall)
   }
-  // else: 'fresh' - new installation
+  // else: 'fresh' - new installation (or just postinstall baseline with AGENTS.md)
 
   // Parse existing env vars if .env.local exists
   if (status.hasEnvLocal) {
@@ -639,8 +662,8 @@ async function configureExternalServices(rl, question, selectedAgents = [], proj
     }
     console.log('');
 
-    const reconfigure = await question('Reconfigure external services? (y/n) [n]: ');
-    if (reconfigure.toLowerCase() !== 'y' && reconfigure.toLowerCase() !== 'yes') {
+    const reconfigure = await askYesNo(question, 'Reconfigure external services?', true);
+    if (!reconfigure) {
       console.log('');
       console.log('Keeping existing configuration.');
       return;
@@ -652,9 +675,9 @@ async function configureExternalServices(rl, question, selectedAgents = [], proj
   console.log('(You can also add them later to .env.local)');
   console.log('');
 
-  const configure = await question('Configure external services? (y/n): ');
+  const configure = await askYesNo(question, 'Configure external services?', false);
 
-  if (configure.toLowerCase() !== 'y' && configure.toLowerCase() !== 'yes') {
+  if (!configure) {
     console.log('');
     console.log('Skipping external services. You can configure them later by editing .env.local');
     return;
@@ -865,7 +888,7 @@ function showBanner(subtitle = 'Universal AI Agent Workflow') {
   console.log('  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  ');
   console.log('  ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗');
   console.log('  ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝');
-  console.log('  v1.1.2');
+  console.log('  v1.2.0');
   console.log('');
   if (subtitle) {
     console.log(`  ${subtitle}`);
@@ -874,6 +897,23 @@ function showBanner(subtitle = 'Universal AI Agent Workflow') {
 
 // Minimal installation (postinstall)
 function minimalInstall() {
+  // Check if this looks like a project (has package.json)
+  const hasPackageJson = fs.existsSync(path.join(projectRoot, 'package.json'));
+
+  if (!hasPackageJson) {
+    console.log('');
+    console.log('  ✅ Forge installed successfully!');
+    console.log('');
+    console.log('  To set up in a project:');
+    console.log('    cd your-project');
+    console.log('    npx forge setup');
+    console.log('');
+    console.log('  Or specify a project directory:');
+    console.log('    npx forge setup --path ./my-project');
+    console.log('');
+    return;
+  }
+
   showBanner();
   console.log('');
 
@@ -1123,6 +1163,11 @@ async function interactiveSetup() {
 
   showBanner('Agent Configuration');
 
+  // Show target directory
+  console.log(`  Target directory: ${process.cwd()}`);
+  console.log('  (Use --path <dir> to change target directory)');
+  console.log('');
+
   // Check prerequisites first
   checkPrerequisites();
   console.log('');
@@ -1159,8 +1204,8 @@ async function interactiveSetup() {
 
   // Ask about overwriting AGENTS.md if it exists
   if (projectStatus.hasAgentsMd) {
-    const overwriteAgents = await question('Found existing AGENTS.md. Overwrite? (y/n) [n]: ');
-    if (overwriteAgents.toLowerCase() !== 'y' && overwriteAgents.toLowerCase() !== 'yes') {
+    const overwriteAgents = await askYesNo(question, 'Found existing AGENTS.md. Overwrite?', true);
+    if (!overwriteAgents) {
       skipFiles.agentsMd = true;
       console.log('  Keeping existing AGENTS.md');
     } else {
@@ -1170,8 +1215,8 @@ async function interactiveSetup() {
 
   // Ask about overwriting .claude/commands/ if it exists
   if (projectStatus.hasClaudeCommands) {
-    const overwriteCommands = await question('Found existing .claude/commands/. Overwrite? (y/n) [n]: ');
-    if (overwriteCommands.toLowerCase() !== 'y' && overwriteCommands.toLowerCase() !== 'yes') {
+    const overwriteCommands = await askYesNo(question, 'Found existing .claude/commands/. Overwrite?', true);
+    if (!overwriteCommands) {
       skipFiles.claudeCommands = true;
       console.log('  Keeping existing .claude/commands/');
     } else {
@@ -1303,7 +1348,7 @@ async function interactiveSetup() {
   // =============================================
   console.log('');
   console.log('==============================================');
-  console.log('  Forge v1.1.2 Setup Complete!');
+  console.log('  Forge v1.2.0 Setup Complete!');
   console.log('==============================================');
   console.log('');
   console.log('What\'s installed:');
@@ -1347,7 +1392,8 @@ function parseFlags() {
     skipExternal: false,
     agents: null,
     all: false,
-    help: false
+    help: false,
+    path: null
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -1361,6 +1407,15 @@ function parseFlags() {
       flags.all = true;
     } else if (arg === '--help' || arg === '-h') {
       flags.help = true;
+    } else if (arg === '--path' || arg === '-p') {
+      // --path <directory> or -p <directory>
+      if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+        flags.path = args[i + 1];
+        i++; // Skip next arg
+      }
+    } else if (arg.startsWith('--path=')) {
+      // --path=/some/dir format
+      flags.path = arg.replace('--path=', '');
     } else if (arg === '--agents') {
       // --agents claude cursor format
       const agentList = [];
@@ -1403,6 +1458,8 @@ function showHelp() {
   console.log('  npx forge                     Minimal install (AGENTS.md + docs)');
   console.log('');
   console.log('Options:');
+  console.log('  --path, -p <dir>     Target project directory (default: current directory)');
+  console.log('                       Creates the directory if it doesn\'t exist');
   console.log('  --quick, -q          Use all defaults, minimal prompts');
   console.log('                       Auto-selects: all agents, GitHub Code Quality, ESLint');
   console.log('  --skip-external      Skip external services configuration');
@@ -1421,6 +1478,8 @@ function showHelp() {
   console.log('Examples:');
   console.log('  npx forge setup                          # Interactive setup');
   console.log('  npx forge setup --quick                  # All defaults, no prompts');
+  console.log('  npx forge setup -p ./my-project          # Setup in specific directory');
+  console.log('  npx forge setup --path=/home/user/app    # Same, different syntax');
   console.log('  npx forge setup --agents claude cursor   # Just these agents');
   console.log('  npx forge setup --agents=claude,cursor   # Same, different syntax');
   console.log('  npx forge setup --skip-external          # No service configuration');
@@ -1510,7 +1569,7 @@ async function quickSetup(selectedAgents, skipExternal) {
   // Final summary
   console.log('');
   console.log('==============================================');
-  console.log('  Forge v1.1.2 Quick Setup Complete!');
+  console.log('  Forge v1.2.0 Quick Setup Complete!');
   console.log('==============================================');
   console.log('');
   console.log('Next steps:');
@@ -1548,6 +1607,11 @@ async function interactiveSetupWithFlags(flags) {
 
   showBanner('Agent Configuration');
 
+  // Show target directory
+  console.log(`  Target directory: ${process.cwd()}`);
+  console.log('  (Use --path <dir> to change target directory)');
+  console.log('');
+
   // Check prerequisites first
   checkPrerequisites();
   console.log('');
@@ -1584,8 +1648,8 @@ async function interactiveSetupWithFlags(flags) {
 
   // Ask about overwriting AGENTS.md if it exists
   if (projectStatus.hasAgentsMd) {
-    const overwriteAgents = await question('Found existing AGENTS.md. Overwrite? (y/n) [n]: ');
-    if (overwriteAgents.toLowerCase() !== 'y' && overwriteAgents.toLowerCase() !== 'yes') {
+    const overwriteAgents = await askYesNo(question, 'Found existing AGENTS.md. Overwrite?', true);
+    if (!overwriteAgents) {
       skipFiles.agentsMd = true;
       console.log('  Keeping existing AGENTS.md');
     } else {
@@ -1595,8 +1659,8 @@ async function interactiveSetupWithFlags(flags) {
 
   // Ask about overwriting .claude/commands/ if it exists
   if (projectStatus.hasClaudeCommands) {
-    const overwriteCommands = await question('Found existing .claude/commands/. Overwrite? (y/n) [n]: ');
-    if (overwriteCommands.toLowerCase() !== 'y' && overwriteCommands.toLowerCase() !== 'yes') {
+    const overwriteCommands = await askYesNo(question, 'Found existing .claude/commands/. Overwrite?', true);
+    if (!overwriteCommands) {
       skipFiles.claudeCommands = true;
       console.log('  Keeping existing .claude/commands/');
     } else {
@@ -1733,7 +1797,7 @@ async function interactiveSetupWithFlags(flags) {
   // =============================================
   console.log('');
   console.log('==============================================');
-  console.log('  Forge v1.1.2 Setup Complete!');
+  console.log('  Forge v1.2.0 Setup Complete!');
   console.log('==============================================');
   console.log('');
   console.log('What\'s installed:');
@@ -1781,6 +1845,38 @@ async function main() {
     return;
   }
 
+  // Handle --path option: change to target directory
+  if (flags.path) {
+    const targetPath = path.resolve(flags.path);
+
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(targetPath)) {
+      try {
+        fs.mkdirSync(targetPath, { recursive: true });
+        console.log(`Created directory: ${targetPath}`);
+      } catch (err) {
+        console.error(`Error creating directory: ${err.message}`);
+        process.exit(1);
+      }
+    }
+
+    // Verify it's a directory
+    if (!fs.statSync(targetPath).isDirectory()) {
+      console.error(`Error: ${targetPath} is not a directory`);
+      process.exit(1);
+    }
+
+    // Change to target directory
+    try {
+      process.chdir(targetPath);
+      console.log(`Working directory: ${targetPath}`);
+      console.log('');
+    } catch (err) {
+      console.error(`Error changing to directory: ${err.message}`);
+      process.exit(1);
+    }
+  }
+
   if (command === 'setup') {
     // Determine agents to install
     let selectedAgents = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-workflow",
-  "version": "1.1.2",
+  "version": "1.2.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"