dhurandhar 2.3.1 → 2.4.1

package/CHANGELOG.md

@@ -5,6 +5,59 @@ All notable changes to Dhurandhar will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.4.1] - 2026-04-02
+
+### Fixed - Critical Bug Fix
+- Fixed "require is not defined" error in setup
+- Added `chmodSync` to imports (was missing)
+- Removed `require()` call in ES module
+- Local executable now creates successfully
+
+### Error Fixed
+User saw: "Error creating directories: require is not defined"
+**FIXED**: Proper ES module imports now used!
+
+---
+
+## [2.4.0] - 2026-04-02
+
+### Added - LOCAL EXECUTABLE! No Global Install Needed! 🎉
+- **Created `./dhurandhar` executable** in project directory
+- **Created `dhurandhar.bat`** for Windows
+- Works just like BMAD - no global installation required!
+- Uses `npx` internally to always get latest version
+
+### Changed
+- All command files use `./dhurandhar` instead of global `dhurandhar`
+- Setup message updated: "No global installation needed!"
+- README updated: Instructions use `./dhurandhar`
+- Removed global install warnings
+
+### How It Works
+Setup creates:
+- `./dhurandhar` - Shell script (Linux/Mac)
+- `dhurandhar.bat` - Batch file (Windows)
+
+Both use `npx --yes dhurandhar@latest` internally.
+
+### User Feedback Implemented
+User: "I never needed to install bmad globally. So we should ensure
+that dhurandhar doesn't require global installation either."
+
+**SOLUTION**: Local executables just like BMAD! ✅
+
+### Benefits
+- ✅ No global npm install needed
+- ✅ Works immediately after setup
+- ✅ Always uses latest version
+- ✅ Same workflow as BMAD
+- ✅ Auggie commands work out of the box
+
+This is a MINOR version bump (2.3.x → 2.4.0) adding significant
+functionality while maintaining backward compatibility.
+
+---
+
 ## [2.3.1] - 2026-04-02
 
 ### Fixed - Installation Instructions Added

package/cli/commands/setup.js

@@ -10,7 +10,7 @@
 
 import * as clack from '@clack/prompts';
 import chalk from 'chalk';
-import { existsSync, writeFileSync, mkdirSync } from 'fs';
+import { existsSync, writeFileSync, mkdirSync, chmodSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
@@ -49,32 +49,16 @@ export default async function setupCommand(options) {
     clack.outro(chalk.green.bold('✅ Setup Complete!'));
 
     console.log(chalk.cyan('\n📚 Next Steps:'));
+    console.log(chalk.gray('  1. ./dhurandhar init (to initialize design)'));
+    console.log(chalk.gray('  2. ./dhurandhar yudhishthira (start Phase 1)\n'));
 
-    // Check if dhurandhar is installed globally
-    const { execSync } = await import('child_process');
-    let isInstalled = false;
-    try {
-      execSync('which dhurandhar', { stdio: 'ignore' });
-      isInstalled = true;
-    } catch (e) {
-      isInstalled = false;
-    }
-
-    if (!isInstalled) {
-      console.log(chalk.yellow('\n⚠️  Important: Install Dhurandhar globally to use commands'));
-      console.log(chalk.cyan('   npm install -g dhurandhar@latest\n'));
-      console.log(chalk.gray('  Then you can run:'));
-    } else {
-      console.log(chalk.gray('  To start:'));
-    }
-
-    console.log(chalk.gray('  1. dhurandhar init (to initialize design)'));
-    console.log(chalk.gray('  2. dhurandhar yudhishthira (start Phase 1)\n'));
+    console.log(chalk.green('✨ No global installation needed!'));
+    console.log(chalk.gray('  Use ./dhurandhar (just like BMAD)\n'));
 
     if (config.aiCodingAssistant === 'augment') {
       console.log(chalk.magenta('💡 Auggie Integration:'));
       console.log(chalk.gray('   - Type / in Auggie chat to see 32 commands'));
-      console.log(chalk.gray('   - Commands work after global install\n'));
+      console.log(chalk.gray('   - All commands use ./dhurandhar\n'));
     }
   } catch (error) {
     console.error(chalk.red('\n❌ Setup failed:'), error.message);
@@ -311,6 +295,9 @@ async function createProjectDirectories(config) {
       mkdirSync(join(dhurandharDir, 'phases'), { recursive: true });
     }
 
+    // Create local dhurandhar executable (like BMAD)
+    createLocalExecutable(cwd);
+
     // Create _dhurandhar-output directory (like BMAD's _bmad-output)
     const outputDir = join(cwd, '_dhurandhar-output');
     if (!existsSync(outputDir)) {
@@ -387,76 +374,75 @@ Setup completed on: ${new Date().toISOString()}
           // Create README first
           const readmeContent = `# Dhurandhar Commands
 
-## Installation Required
+## No Installation Needed!
 
-To use these commands, install Dhurandhar globally:
+Dhurandhar works locally (just like BMAD). Use the \`./dhurandhar\` script in your project directory.
 
-\`\`\`bash
-npm install -g dhurandhar@latest
-\`\`\`
+## Usage
 
-Then you can run any command like:
 \`\`\`bash
-dhurandhar yudhishthira
-dhurandhar status
-dhurandhar codegen -t all
+./dhurandhar yudhishthira  # Phase 1: Features
+./dhurandhar status        # Check status
+./dhurandhar codegen -t all  # Generate code
 \`\`\`
 
 ## All Commands
 
 See individual .md files in this directory for each command.
+
+All commands use \`./dhurandhar <command>\` - no global install required!
 `;
           writeFileSync(join(commandsDir, 'README.md'), readmeContent, 'utf-8');
 
           // Create comprehensive .md files for ALL commands
           const commands = [
             // Status & Navigation
-            { file: 'status.md', content: '---\ndescription: Check design project status\n---\n\n**Installation**: `npm install -g dhurandhar@latest`\n\nRun `dhurandhar status` to see the current state of your design project.' },
-            { file: 'next.md', content: '---\ndescription: Move to next phase\n---\n\n**Installation**: `npm install -g dhurandhar@latest`\n\nRun `dhurandhar next` to automatically move to the next design phase.' },
-            { file: 'back.md', content: '---\ndescription: Go back to previous phase\n---\n\n**Installation**: `npm install -g dhurandhar@latest`\n\nRun `dhurandhar back` to return to the previous design phase.' },
+            { file: 'status.md', content: '---\ndescription: Check design project status\n---\n\n**No installation needed!** Use the local executable.\n\nRun `./dhurandhar status` to see the current state of your design project.' },
+            { file: 'next.md', content: '---\ndescription: Move to next phase\n---\n\n**No installation needed!** Use the local executable.\n\nRun `./dhurandhar next` to automatically move to the next design phase.' },
+            { file: 'back.md', content: '---\ndescription: Go back to previous phase\n---\n\n**No installation needed!** Use the local executable.\n\nRun `./dhurandhar back` to return to the previous design phase.' },
 
             // Master Agents (All 8)
-            { file: 'yudhishthira.md', content: '---\ndescription: Phase 1 - Features with Yudhishthira (Dharma)\n---\n\nRun `dhurandhar yudhishthira` to define features with the master of dharma.' },
-            { file: 'bhishma.md', content: '---\ndescription: Phase 2 - Requirements with Bhishma (Grandfather)\n---\n\nRun `dhurandhar bhishma` to define functional and non-functional requirements.' },
-            { file: 'sahadeva.md', content: '---\ndescription: Phase 3 - Entities with Sahadeva (Wisdom)\n---\n\nRun `dhurandhar sahadeva` to design domain model and entities.' },
-            { file: 'nakula.md', content: '---\ndescription: Phase 4 - APIs with Nakula (Handsome)\n---\n\nRun `dhurandhar nakula` to design REST APIs.' },
-            { file: 'bheema.md', content: '---\ndescription: Phase 5 & 7 - HLD & Implementation with Bheema (Strength)\n---\n\nRun `dhurandhar bheema` for high-level design and implementation planning.' },
-            { file: 'arjuna.md', content: '---\ndescription: Phase 6 - LLD with Arjuna (Warrior)\n---\n\nRun `dhurandhar arjuna` for low-level design and class diagrams.' },
-            { file: 'draupadi.md', content: '---\ndescription: Phase 8 - Blessing with Draupadi (Queen)\n---\n\nRun `dhurandhar draupadi` for the final quality review and imperial blessing.' },
+            { file: 'yudhishthira.md', content: '---\ndescription: Phase 1 - Features with Yudhishthira (Dharma)\n---\n\nRun `./dhurandhar yudhishthira` to define features with the master of dharma.' },
+            { file: 'bhishma.md', content: '---\ndescription: Phase 2 - Requirements with Bhishma (Grandfather)\n---\n\nRun `./dhurandhar bhishma` to define functional and non-functional requirements.' },
+            { file: 'sahadeva.md', content: '---\ndescription: Phase 3 - Entities with Sahadeva (Wisdom)\n---\n\nRun `./dhurandhar sahadeva` to design domain model and entities.' },
+            { file: 'nakula.md', content: '---\ndescription: Phase 4 - APIs with Nakula (Handsome)\n---\n\nRun `./dhurandhar nakula` to design REST APIs.' },
+            { file: 'bheema.md', content: '---\ndescription: Phase 5 & 7 - HLD & Implementation with Bheema (Strength)\n---\n\nRun `./dhurandhar bheema` for high-level design and implementation planning.' },
+            { file: 'arjuna.md', content: '---\ndescription: Phase 6 - LLD with Arjuna (Warrior)\n---\n\nRun `./dhurandhar arjuna` for low-level design and class diagrams.' },
+            { file: 'draupadi.md', content: '---\ndescription: Phase 8 - Blessing with Draupadi (Queen)\n---\n\nRun `./dhurandhar draupadi` for the final quality review and imperial blessing.' },
 
             // Code Generation (All options)
-            { file: 'codegen-all.md', content: '---\ndescription: Generate complete full-stack application\n---\n\nRun `dhurandhar codegen -t all` to generate backend, frontend, tests, and infrastructure.' },
-            { file: 'codegen-backend.md', content: '---\ndescription: Generate NestJS backend only\n---\n\nRun `dhurandhar codegen -t backend` to generate NestJS + TypeORM backend code.' },
-            { file: 'codegen-frontend.md', content: '---\ndescription: Generate React frontend only\n---\n\nRun `dhurandhar codegen -t frontend` to generate React + Vite + Tailwind frontend.' },
-            { file: 'codegen-tests.md', content: '---\ndescription: Generate Jest tests only\n---\n\nRun `dhurandhar codegen -t tests` to generate unit and E2E tests.' },
-            { file: 'codegen-infra.md', content: '---\ndescription: Generate infrastructure code\n---\n\nRun `dhurandhar codegen -t infrastructure` to generate Docker and Kubernetes configs.' },
+            { file: 'codegen-all.md', content: '---\ndescription: Generate complete full-stack application\n---\n\nRun `./dhurandhar codegen -t all` to generate backend, frontend, tests, and infrastructure.' },
+            { file: 'codegen-backend.md', content: '---\ndescription: Generate NestJS backend only\n---\n\nRun `./dhurandhar codegen -t backend` to generate NestJS + TypeORM backend code.' },
+            { file: 'codegen-frontend.md', content: '---\ndescription: Generate React frontend only\n---\n\nRun `./dhurandhar codegen -t frontend` to generate React + Vite + Tailwind frontend.' },
+            { file: 'codegen-tests.md', content: '---\ndescription: Generate Jest tests only\n---\n\nRun `./dhurandhar codegen -t tests` to generate unit and E2E tests.' },
+            { file: 'codegen-infra.md', content: '---\ndescription: Generate infrastructure code\n---\n\nRun `./dhurandhar codegen -t infrastructure` to generate Docker and Kubernetes configs.' },
 
             // Export (All formats)
-            { file: 'export-markdown.md', content: '---\ndescription: Export design to Markdown\n---\n\nRun `dhurandhar export -f markdown` to export design as Markdown document.' },
-            { file: 'export-json.md', content: '---\ndescription: Export design to JSON\n---\n\nRun `dhurandhar export -f json` to export design as JSON data.' },
-            { file: 'export-html.md', content: '---\ndescription: Export design to HTML\n---\n\nRun `dhurandhar export -f html` to export design as interactive HTML.' },
+            { file: 'export-markdown.md', content: '---\ndescription: Export design to Markdown\n---\n\nRun `./dhurandhar export -f markdown` to export design as Markdown document.' },
+            { file: 'export-json.md', content: '---\ndescription: Export design to JSON\n---\n\nRun `./dhurandhar export -f json` to export design as JSON data.' },
+            { file: 'export-html.md', content: '---\ndescription: Export design to HTML\n---\n\nRun `./dhurandhar export -f html` to export design as interactive HTML.' },
 
             // Integrations
-            { file: 'integrate-github.md', content: '---\ndescription: Create GitHub issues from design\n---\n\nRun `dhurandhar integrate -p github` to create GitHub issues for all features.' },
-            { file: 'integrate-jira.md', content: '---\ndescription: Create Jira tickets from design\n---\n\nRun `dhurandhar integrate -p jira` to create Jira epics, stories, and tasks.' },
-            { file: 'integrate-confluence.md', content: '---\ndescription: Create Confluence documentation\n---\n\nRun `dhurandhar integrate -p confluence` to create Confluence pages from design.' },
+            { file: 'integrate-github.md', content: '---\ndescription: Create GitHub issues from design\n---\n\nRun `./dhurandhar integrate -p github` to create GitHub issues for all features.' },
+            { file: 'integrate-jira.md', content: '---\ndescription: Create Jira tickets from design\n---\n\nRun `./dhurandhar integrate -p jira` to create Jira epics, stories, and tasks.' },
+            { file: 'integrate-confluence.md', content: '---\ndescription: Create Confluence documentation\n---\n\nRun `./dhurandhar integrate -p confluence` to create Confluence pages from design.' },
 
             // AI Features
-            { file: 'ai-suggest.md', content: '---\ndescription: Get AI design suggestions\n---\n\nRun `dhurandhar ai suggest` to get AI-powered design improvement suggestions.' },
-            { file: 'ai-analyze.md', content: '---\ndescription: AI design analysis\n---\n\nRun `dhurandhar ai analyze` to get comprehensive AI analysis of your design.' },
+            { file: 'ai-suggest.md', content: '---\ndescription: Get AI design suggestions\n---\n\nRun `./dhurandhar ai suggest` to get AI-powered design improvement suggestions.' },
+            { file: 'ai-analyze.md', content: '---\ndescription: AI design analysis\n---\n\nRun `./dhurandhar ai analyze` to get comprehensive AI analysis of your design.' },
 
             // Diagrams
-            { file: 'diagrams.md', content: '---\ndescription: Generate architecture diagrams\n---\n\nRun `dhurandhar diagrams` to generate visual architecture diagrams.' },
+            { file: 'diagrams.md', content: '---\ndescription: Generate architecture diagrams\n---\n\nRun `./dhurandhar diagrams` to generate visual architecture diagrams.' },
 
             // Review & Audit
-            { file: 'review.md', content: '---\ndescription: Run cascading review\n---\n\nRun `dhurandhar review` to run a comprehensive design review across all phases.' },
-            { file: 'audit.md', content: '---\ndescription: Audit design quality\n---\n\nRun `dhurandhar audit` to check for design issues and quality problems.' },
+            { file: 'review.md', content: '---\ndescription: Run cascading review\n---\n\nRun `./dhurandhar review` to run a comprehensive design review across all phases.' },
+            { file: 'audit.md', content: '---\ndescription: Audit design quality\n---\n\nRun `./dhurandhar audit` to check for design issues and quality problems.' },
 
             // Decisions
-            { file: 'decisions.md', content: '---\ndescription: Manage technical decisions\n---\n\nRun `dhurandhar decisions` to view and manage technical decisions in the registry.' },
+            { file: 'decisions.md', content: '---\ndescription: Manage technical decisions\n---\n\nRun `./dhurandhar decisions` to view and manage technical decisions in the registry.' },
 
             // Undo
-            { file: 'undo.md', content: '---\ndescription: Undo last change\n---\n\nRun `dhurandhar undo` to undo the last change (up to 20 versions).' }
+            { file: 'undo.md', content: '---\ndescription: Undo last change\n---\n\nRun `./dhurandhar undo` to undo the last change (up to 20 versions).' }
           ];
 
           commands.forEach(cmd => {
@@ -492,3 +478,34 @@ See individual .md files in this directory for each command.
     clack.log.error(`Error creating directories: ${error.message}`);
   }
 }
+
+/**
+ * Create local dhurandhar executable (like BMAD)
+ */
+function createLocalExecutable(cwd) {
+  // Create dhurandhar shell script
+  const scriptContent = `#!/usr/bin/env bash
+# Local Dhurandhar executable (no global install needed!)
+# This works just like BMAD - local installation only
+
+# Get the directory of this script
+SCRIPT_DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" && pwd )"
+
+# Use npx to run dhurandhar with the exact version
+npx --yes dhurandhar@latest "$@"
+`;
+
+  const scriptPath = join(cwd, 'dhurandhar');
+  writeFileSync(scriptPath, scriptContent, 'utf-8');
+
+  // Make it executable
+  chmodSync(scriptPath, 0o755);
+
+  // Create Windows batch file too
+  const batContent = `@echo off
+REM Local Dhurandhar executable for Windows
+npx --yes dhurandhar@latest %*
+`;
+
+  writeFileSync(join(cwd, 'dhurandhar.bat'), batContent, 'utf-8');
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "dhurandhar",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "description": "The world's first AI-powered dharma-centric design framework. 8 Pandava agents + 21 sub-agents guide you from idea to production code. Features → Requirements → Entities → API → HLD → LLD → Implementation → Blessing. Complete with code generation, enterprise integrations, and mythological accuracy.",
   "keywords": [
     "system-design",