forgestack-os-cli 0.3.3 → 0.3.5

package/README.md

@@ -4,69 +4,476 @@ Generate production-ready full-stack SaaS projects with one command.
 
 ## Installation
 
+### Option 1: Using npx (Recommended - No Installation Needed)
+
 ```bash
-# Recommended: npx (no install)
 npx forgestack-os-cli create my-app
+```
+
+No setup required! The fastest way to get started. The CLI is downloaded and run on the fly.
 
-# Or install globally
+### Option 2: Install Globally
+
+```bash
 npm install -g forgestack-os-cli
-# then
-forgestack create my-app
+```
+
+Then create projects using:
+
+```bash
+forgestack-os-cli create my-app
+```
+
+**Note on Global Install:** After installing globally, the command `forgestack-os-cli` should be in your PATH. If you get `command not found` errors:
+
+1. Verify your npm bin directory is in PATH:
+   ```bash
+   npm config get prefix
+   ```
+2. Add it to PATH if needed:
+   - **Windows (PowerShell):** `[System.Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Users\YourUsername\AppData\Roaming\npm", [System.EnvironmentVariableTarget]::User)`
+   - **macOS/Linux:** Add `export PATH="~/.npm-global/bin:$PATH"` to `~/.bash_profile` or `~/.zshrc`
+
+3. Verify installation:
+   ```bash
+   forgestack-os-cli --version
+   ```
+
+## Quick Start
+
+**Fastest way to create a project:**
+
+```bash
+# Interactive mode - we'll ask you questions
+npx forgestack-os-cli create my-app
+
+# With a preset - production-ready stack
+npx forgestack-os-cli create my-enterprise --preset next-nest-clerk-pg
+
+# With specific flags
+npx forgestack-os-cli create my-api --frontend nextjs --backend nestjs --auth supabase --database postgresql --docker
 ```
 
 ## Usage
 
 ```bash
-forgestack create <project-name> [options]
+forgestack-os-cli create <project-name> [options]
+```
+
+Or with npx:
+
+```bash
+npx forgestack-os-cli create <project-name> [options]
+```
+
+### Available Options
+
+| Option           | Values                                                                            | Description                             |
+| ---------------- | --------------------------------------------------------------------------------- | --------------------------------------- |
+| `--frontend`     | `react-vite` \| `nextjs` \| `vue-vite` \| `sveltekit`                             | Frontend framework                      |
+| `--backend`      | `express` \| `fastify` \| `nestjs` \| `bun-elysia` \| `go-fiber`                  | Backend framework                       |
+| `--auth`         | `jwt` \| `clerk` \| `supabase` \| `authjs` \| `firebase`                          | Authentication provider                 |
+| `--database`     | `postgresql` \| `mongodb` \| `mysql` \| `sqlite` \| `supabase-db`                 | Database                                |
+| `--api`          | `rest` \| `graphql` \| `trpc`                                                     | API style                               |
+| `--preset`       | `next-nest-clerk-pg` \| `react-express-jwt-mongo` \| `next-fastify-supabase-trpc` | Predefined stack                        |
+| `--stack`        | JSON string                                                                       | Full stack config as JSON               |
+| `--docker`       | -                                                                                 | Include Docker configuration            |
+| `--no-docker`    | -                                                                                 | Skip Docker configuration (default)     |
+| `--multi-tenant` | -                                                                                 | Enable multi-tenancy scaffolding        |
+| `--skip-install` | -                                                                                 | Skip npm install after project creation |
+| `--skip-git`     | -                                                                                 | Skip git initialization                 |
+
+## Examples
+
+### Interactive Mode (Recommended)
+
+```bash
+npx forgestack-os-cli create my-saas
+```
+
+You'll be guided through selecting your stack options with interactive prompts.
+
+### Using Presets
+
+**Next.js + NestJS + Clerk + PostgreSQL (Full-featured):**
+
+```bash
+npx forgestack-os-cli create my-enterprise --preset next-nest-clerk-pg
+```
+
+**React + Express + JWT + MongoDB (Simple SPA):**
+
+```bash
+npx forgestack-os-cli create my-app --preset react-express-jwt-mongo
+```
+
+**Next.js + Fastify + Supabase + tRPC (Modern fullstack):**
+
+```bash
+npx forgestack-os-cli create my-trpc-app --preset next-fastify-supabase-trpc
+```
+
+### Using Flags
+
+**RESTful API with React + Express:**
+
+```bash
+npx forgestack-os-cli create my-rest-api \
+  --frontend react-vite \
+  --backend express \
+  --auth jwt \
+  --database postgresql \
+  --api rest
+```
+
+**GraphQL Backend with Vue:**
+
+```bash
+npx forgestack-os-cli create my-graphql-app \
+  --frontend vue-vite \
+  --backend nestjs \
+  --auth firebase \
+  --database mongodb \
+  --api graphql \
+  --docker
+```
+
+**Minimal Setup (SQLite + No Docker):**
+
+```bash
+npx forgestack-os-cli create my-minimal-app \
+  --frontend react-vite \
+  --backend express \
+  --auth jwt \
+  --database sqlite \
+  --no-docker
+```
+
+### Using JSON Stack Config
+
+Provide complete configuration as a JSON string:
+
+```bash
+npx forgestack-os-cli create my-custom-stack --stack '{
+  "frontend": "nextjs",
+  "backend": "fastify",
+  "auth": "supabase",
+  "database": "supabase-db",
+  "apiStyle": "trpc",
+  "docker": true,
+  "multiTenant": true
+}'
+```
+
+**Multi-tenancy with Docker:**
+
+```bash
+npx forgestack-os-cli create my-multitenant-app \
+  --preset next-nest-clerk-pg \
+  --multi-tenant \
+  --docker
+```
+
+**Skip Dependency Installation:**
+
+```bash
+npx forgestack-os-cli create my-app --preset next-nest-clerk-pg --skip-install
+cd my-app
+npm install  # Install later when you're ready
+```
+
+## Additional Commands
+
+### `organize` - File Organization Utility
+
+Organize files in a folder by type or date, with optional duplicate detection. Supports MD5-based duplicate identification and automatic system folder exclusion for performance.
+
+```bash
+npx forgestack-os-cli organize <folder-path> [options]
+```
+
+**Options:**
+- `--strategy <type>` - Organization strategy: `type` (default) or `date`
+- `--duplicates` - Move duplicate files to a `Duplicates` folder
+
+**File Categories (when using `--strategy type`):**
+- **Images**: jpg, png, gif, svg, webp, bmp, ico
+- **Documents**: pdf, doc, docx, txt, xlsx, csv, md
+- **Videos**: mp4, mkv, avi, mov, wmv, flv
+- **Audio**: mp3, wav, flac, aac, m4a, ogg
+- **Code**: js, ts, py, java, cpp, go, rs, rb
+- **Archives**: zip, rar, 7z, tar, gz, bz2
+- **Data**: json, xml, yaml, sql, db, sqlite
+- **Executables**: exe, msi, app, deb, rpm
+- **Others**: All other file types
+
+**Date Format (when using `--strategy date`):**
+Files organized into folders using format: `YYYY-MM` (e.g., `2026-01`, `2025-12`)
+
+**Features:**
+- ✅ Automatically skips system folders (node_modules, .git, dist, build, .next, .env, .DS_Store, .vscode)
+- ✅ MD5-based duplicate detection (prevents moving the same file twice)
+- ✅ Graceful error handling for permission denied or inaccessible files
+- ✅ Summary report showing total files organized and categories
+- ✅ Interactive prompts if options not provided
+
+**Examples:**
+
+```bash
+# Organize by file type with duplicate detection
+npx forgestack-os-cli organize ~/Downloads --strategy type --duplicates
+
+# Organize photos by month
+npx forgestack-os-cli organize ~/Pictures --strategy date
+
+# Interactive mode (prompts for folder and options)
+npx forgestack-os-cli organize
+
+# Organize current directory
+npx forgestack-os-cli organize .
+```
+
+**Output Example:**
+```
+✓ Found and organized 1,250 files
+✓ Categories:
+  - Images: 450 files
+  - Documents: 280 files
+  - Videos: 320 files
+  - Code: 145 files
+  - Others: 55 files
+✓ Found 12 set(s) of duplicate files moved to Duplicates folder
+```
+
+**Edge Cases Handled:**
+- Empty folders: Displays "No files to organize" message
+- Invalid paths: Shows clear error message with validation
+- Permission errors: Skips files with access denied, continues processing
+- Unreadable files: Skips during hash calculation, no crash
+- Large monorepos: Excludes node_modules, .git, and build folders automatically
+
+---
+
+### `run-tasks` - Batch Task Runner
+
+Execute shell commands from a JSON configuration file, sequentially or in parallel. Supports task-specific working directories and comprehensive error handling.
+
+```bash
+npx forgestack-os-cli run-tasks <config-path> [options]
 ```
 
-**Common flags**
+**Options:**
+- `--parallel` - Run tasks concurrently instead of sequentially (default: false)
+- `--stop-on-error` - Stop execution on first task failure (default: true)
+
+**Config File Format (tasks.json):**
 
-- `--frontend <framework>`: react-vite | nextjs
-- `--backend <framework>`: express | fastify | nestjs | bun-elysia | go-fiber
-- `--auth <provider>`: jwt | clerk | supabase | authjs | firebase
-- `--database <db>`: postgresql | mongodb | mysql | sqlite | supabase-db
-- `--api <style>`: rest | graphql | trpc
-- `--preset <name>`: use a predefined stack (e.g., next-nest-clerk-pg)
-- `--stack <json>`: provide full stack config as JSON
-- `--docker` / `--no-docker`: include or skip Docker config
-- `--multi-tenant`: enable multi-tenancy scaffolding
-- `--skip-install`: skip dependency installation
-- `--skip-git`: skip git init
+```json
+{
+  "tasks": [
+    {
+      "name": "Build",
+      "command": "npm run build",
+      "cwd": "./"
+    },
+    {
+      "name": "Test",
+      "command": "npm test",
+      "cwd": "./"
+    }
+  ],
+  "parallel": false,
+  "stopOnError": true
+}
+```
+
+**Features:**
+- ✅ Cross-platform shell execution (Windows CMD, Unix bash)
+- ✅ Task-specific working directory support
+- ✅ Sequential or parallel execution modes
+- ✅ Configurable failure handling
+- ✅ Comprehensive error reporting
+- ✅ Interactive mode with default config file detection
+- ✅ Proper exit codes for CI/CD integration
 
-### Examples
+**Examples:**
 
 ```bash
-# Interactive
-forgestack create my-saas
+# Run tasks sequentially (stops on first error)
+npx forgestack-os-cli run-tasks ./tasks.json
+
+# Run tasks in parallel
+npx forgestack-os-cli run-tasks ./tasks.json --parallel
 
-# Preset
-forgestack create my-enterprise --preset next-nest-clerk-pg
+# Continue on errors
+npx forgestack-os-cli run-tasks ./tasks.json --stop-on-error false
+
+# Interactive mode (looks for ./tasks.json automatically)
+npx forgestack-os-cli run-tasks
+```
+
+**Task Properties:**
+- `name` (required) - Display name for the task (for logging)
+- `command` (required) - Shell command to execute
+- `cwd` (optional) - Working directory for command execution (must exist)
+
+**Example: Monorepo Build Pipeline**
+
+```json
+{
+  "tasks": [
+    {
+      "name": "Clean Build Artifacts",
+      "command": "rm -rf dist"
+    },
+    {
+      "name": "Build Frontend",
+      "command": "npm run build",
+      "cwd": "./packages/frontend"
+    },
+    {
+      "name": "Build Backend",
+      "command": "npm run build",
+      "cwd": "./packages/backend"
+    },
+    {
+      "name": "Run Tests",
+      "command": "npm test",
+      "cwd": "./packages/backend"
+    },
+    {
+      "name": "Generate Docs",
+      "command": "npm run docs"
+    }
+  ],
+  "parallel": false,
+  "stopOnError": true
+}
+```
 
-# Full JSON config
-forgestack create my-app --stack '{"frontend":"nextjs","backend":"fastify","auth":"supabase","database":"supabase-db","apiStyle":"trpc","docker":true,"multiTenant":true}'
+**Output Example:**
+```
+⏳ Running tasks sequentially...
+✓ Task 1/5: Clean Build Artifacts completed
+✓ Task 2/5: Build Frontend completed
+✓ Task 3/5: Build Backend completed
+✓ Task 4/5: Run Tests completed
+✓ Task 5/5: Generate Docs completed
 
-# Minimal flags
-forgestack create api-only --frontend=react-vite --backend=express --auth=jwt --database=postgresql --api=rest --no-docker
+✓ All 5 tasks completed successfully
 ```
 
+**Error Handling:**
+- **Invalid config path**: Shows clear error, no crash
+- **Malformed JSON**: Displays JSON parsing error
+- **Missing command**: Validates all tasks have required fields
+- **Invalid working directory**: Shows warning, continues with project root
+- **Task execution fails**: Respects `stopOnError` flag
+- **Cross-platform compatibility**: Automatically handles Windows vs Unix paths
+
+---
+
 ## Features
 
-- 150+ stack combinations across frontend, backend, auth, database, and API styles
-- Multi-tenancy ready scaffolds
-- Docker Compose and env templates
-- API docs (Swagger) for REST backends
-- TypeScript-first across generated code
+### Project Generation
+- **150+ Stack Combinations** - Frontend (React, Next.js, Vue, Svelte) × Backend (Express, Fastify, NestJS, Bun, Go) × Auth × Database × API Style
+- **Multi-tenancy Ready** - Scaffolding support for SaaS applications
+- **Docker Compose** - Complete Docker setup with frontend and backend services
+- **Environment Templates** - Pre-configured `.env.example` files
+- **API Documentation** - Swagger/OpenAPI docs for REST APIs
+- **TypeScript First** - Full TypeScript support across all generated code
+- **Production Ready** - Best practices, security headers, error handling
 
-## Generated Project
+### Utility Commands
+- **File Organization** (`organize`) - Sort files by type or date, with MD5-based duplicate detection and automatic system folder exclusion
+- **Batch Task Runner** (`run-tasks`) - Execute complex workflows with sequential or parallel task execution, cross-platform compatibility, and comprehensive error handling
+
+## Generated Project Structure
 
 ```
 my-app/
-├─ frontend/   # Next.js or React+Vite
-├─ backend/    # Express, Fastify, NestJS, Bun+Elysia, or Go+Fiber
-├─ .env.example
-├─ package.json (workspaces)
-└─ README.md (per-project runbook)
+├── frontend/              # React+Vite, Next.js, Vue, or SvelteKit
+│   ├── src/
+│   ├── public/
+│   ├── package.json
+│   ├── tsconfig.json
+│   └── vite.config.ts (or next.config.js)
+│
+├── backend/               # Express, Fastify, NestJS, Bun+Elysia, or Go
+│   ├── src/
+│   ├── dist/
+│   ├── package.json
+│   ├── tsconfig.json
+│   └── .env.example
+│
+├── docker/                # Optional - if --docker enabled
+│   ├── docker-compose.yml
+│   ├── frontend.Dockerfile
+│   └── backend.Dockerfile
+│
+├── .env.example           # Environment variables template
+├── package.json           # Workspace configuration (monorepo)
+├── README.md              # Per-project setup guide
+└── .gitignore
+```
+
+## Troubleshooting
+
+### "command not found: forgestack-os-cli"
+
+**Using npx?** Make sure you use the full package name:
+
+```bash
+npx forgestack-os-cli create my-app
+```
+
+**Installed globally?** Try:
+
+1. Verify npm global bin is in PATH: `echo $PATH` (Unix) or `$env:Path` (Windows)
+2. Reinstall: `npm install -g forgestack-os-cli@latest`
+3. Check Node.js version: `node --version` (requires 18+)
+
+### "404 Not Found - forgestack"
+
+The package name is **`forgestack-os-cli`**, not `forgestack`:
+
+```bash
+# ✅ Correct
+npx forgestack-os-cli create my-app
+
+# ❌ Wrong
+npx forgestack create my-app
+```
+
+### "Unknown command"
+
+Ensure you're using `create`, not `init`:
+
+```bash
+# ✅ Correct
+npx forgestack-os-cli create my-app
+
+# ❌ Wrong
+npx forgestack-os-cli init my-app
+```
+
+### Preset not found
+
+Available presets:
+
+- `next-nest-clerk-pg` - Next.js, NestJS, Clerk, PostgreSQL
+- `react-express-jwt-mongo` - React+Vite, Express, JWT, MongoDB
+- `next-fastify-supabase-trpc` - Next.js, Fastify, Supabase, tRPC
+
+Use exact preset names (case-sensitive).
+
+### Node.js version error
+
+ForgeStack requires Node.js 18 or higher:
+
+```bash
+node --version  # Check your version
+nvm install 18  # Or use nvm/fnm to upgrade
 ```
 
 ## Author

package/dist/commands/organize.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function organizeCommand(folderPath: string | undefined, options: Record<string, unknown>, _command?: Command): Promise<void>;

package/dist/commands/organize.js

@@ -0,0 +1,126 @@
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { logger } from '../utils/logger.js';
+import { organizeFilesByType, organizeFilesByDate, detectDuplicates } from '../utils/file-organizer.js';
+export async function organizeCommand(folderPath, options, _command) {
+    try {
+        let targetPath = folderPath || '';
+        // If no folder path provided, use interactive prompt
+        if (!targetPath) {
+            const answers = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'path',
+                    message: 'Enter the folder path to organize:',
+                    default: process.cwd(),
+                    validate: (input) => {
+                        if (!input.trim())
+                            return 'Path cannot be empty';
+                        return true;
+                    },
+                },
+            ]);
+            targetPath = answers.path;
+        }
+        // Resolve to absolute path
+        const absolutePath = path.resolve(targetPath);
+        // Validate folder exists
+        if (!(await fs.pathExists(absolutePath))) {
+            logger.error(`Folder does not exist: ${absolutePath}`);
+            process.exit(1);
+        }
+        const stats = await fs.stat(absolutePath);
+        if (!stats.isDirectory()) {
+            logger.error(`Path is not a directory: ${absolutePath}`);
+            process.exit(1);
+        }
+        // Get organization strategy
+        let strategy = options.strategy || '';
+        if (!['type', 'date'].includes(strategy)) {
+            const answers = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'strategy',
+                    message: 'How would you like to organize files?',
+                    choices: [
+                        { name: 'By File Type (images, documents, etc.)', value: 'type' },
+                        { name: 'By Date (YYYY-MM)', value: 'date' },
+                    ],
+                },
+            ]);
+            strategy = answers.strategy;
+        }
+        // Check if user wants to handle duplicates
+        let handleDuplicates = !!options.duplicates;
+        if (!options.duplicates) {
+            const answers = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'duplicates',
+                    message: 'Move duplicate files to a "Duplicates" folder?',
+                    default: false,
+                },
+            ]);
+            handleDuplicates = answers.duplicates;
+        }
+        console.log('');
+        logger.title('📁 Organizing files...');
+        // Detect duplicates if needed
+        let duplicates = new Map();
+        if (handleDuplicates) {
+            logger.info('Detecting duplicate files...');
+            duplicates = await detectDuplicates(absolutePath);
+            if (duplicates.size === 0) {
+                console.log(chalk.gray('No duplicates found.'));
+            }
+            else {
+                console.log(chalk.gray(`Found ${duplicates.size} set(s) of duplicate files.`));
+            }
+        }
+        // Organize files
+        let result;
+        if (strategy === 'type') {
+            result = await organizeFilesByType(absolutePath, duplicates);
+        }
+        else {
+            result = await organizeFilesByDate(absolutePath, duplicates);
+        }
+        // Display results
+        console.log('');
+        logger.success('Organization complete!');
+        console.log('');
+        console.log(chalk.bold('Summary:'));
+        console.log(chalk.gray('─'.repeat(50)));
+        let totalFilesMoved = 0;
+        const categorizedEntries = Object.entries(result.categorized);
+        if (categorizedEntries.length === 0) {
+            console.log(chalk.gray('No files to organize.'));
+        }
+        else {
+            for (const [folder, count] of categorizedEntries) {
+                console.log(`${chalk.cyan('→')} ${folder}: ${chalk.bold(count)} files`);
+                totalFilesMoved += count;
+            }
+        }
+        if (result.duplicates > 0) {
+            console.log(`${chalk.cyan('→')} Duplicates: ${chalk.bold(result.duplicates)} files`);
+            totalFilesMoved += result.duplicates;
+        }
+        console.log(chalk.gray('─'.repeat(50)));
+        console.log(`${chalk.bold('Total files moved:')} ${chalk.green(totalFilesMoved)}`);
+        console.log('');
+    }
+    catch (error) {
+        logger.error('Failed to organize files');
+        if (error instanceof Error) {
+            console.error(chalk.red(error.message));
+        }
+        else {
+            console.error(error);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=organize.js.map

package/dist/commands/organize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organize.js","sourceRoot":"","sources":["../../src/commands/organize.ts"],"names":[],"mappings":"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"}

package/dist/commands/run-tasks.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+export interface Task {
+    name: string;
+    command: string;
+    cwd?: string;
+}
+export interface TasksConfig {
+    tasks: Task[];
+    parallel?: boolean;
+    stopOnError?: boolean;
+}
+export declare function runTasksCommand(configPath: string | undefined, options: Record<string, unknown>, _command?: Command): Promise<void>;

package/dist/commands/run-tasks.js

@@ -0,0 +1,125 @@
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { logger } from '../utils/logger.js';
+import { executeTasksSequentially, executeTasksInParallel } from '../utils/task-runner.js';
+export async function runTasksCommand(configPath, options, _command) {
+    try {
+        let tasksFilePath = configPath || '';
+        // If no config path provided, use interactive prompt
+        if (!tasksFilePath) {
+            const answers = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'path',
+                    message: 'Enter the path to tasks.json config file:',
+                    default: './tasks.json',
+                    validate: (input) => {
+                        if (!input.trim())
+                            return 'Path cannot be empty';
+                        return true;
+                    },
+                },
+            ]);
+            tasksFilePath = answers.path;
+        }
+        // Resolve to absolute path
+        const absolutePath = path.resolve(tasksFilePath);
+        // Validate file exists
+        if (!(await fs.pathExists(absolutePath))) {
+            logger.error(`Config file not found: ${absolutePath}`);
+            process.exit(1);
+        }
+        // Validate it's a file
+        const stats = await fs.stat(absolutePath);
+        if (!stats.isFile()) {
+            logger.error(`Path is not a file: ${absolutePath}`);
+            process.exit(1);
+        }
+        // Parse config file
+        let config;
+        try {
+            const fileContent = await fs.readFile(absolutePath, 'utf-8');
+            config = JSON.parse(fileContent);
+        }
+        catch (error) {
+            logger.error(`Failed to parse config file: ${absolutePath}`);
+            if (error instanceof SyntaxError) {
+                console.error(chalk.red(`JSON Error: ${error.message}`));
+            }
+            process.exit(1);
+        }
+        // Validate config
+        if (!config.tasks || !Array.isArray(config.tasks) || config.tasks.length === 0) {
+            logger.error('Config file must contain a "tasks" array with at least one task');
+            process.exit(1);
+        }
+        // Validate each task
+        for (const task of config.tasks) {
+            if (!task.name || !task.command) {
+                logger.error('Each task must have a "name" and "command" field');
+                process.exit(1);
+            }
+            if (task.cwd && !(await fs.pathExists(task.cwd))) {
+                logger.warning(`Working directory does not exist for task "${task.name}": ${task.cwd}`);
+            }
+        }
+        // Determine execution mode (CLI options override config file)
+        const parallel = options.parallel === true || (config.parallel === true && options.parallel !== false);
+        const stopOnError = options.stopOnError !== false && (config.stopOnError !== false || options.stopOnError === true);
+        console.log('');
+        logger.title('🚀 Running Tasks');
+        console.log(chalk.gray(`Total tasks: ${config.tasks.length}`));
+        console.log(chalk.gray(`Mode: ${parallel ? 'Parallel' : 'Sequential'}`));
+        console.log(chalk.gray(`Stop on error: ${stopOnError ? 'Yes' : 'No'}`));
+        console.log('');
+        // Execute tasks
+        let results;
+        if (parallel) {
+            results = await executeTasksInParallel(config.tasks, stopOnError);
+        }
+        else {
+            results = await executeTasksSequentially(config.tasks, stopOnError);
+        }
+        // Display results
+        console.log('');
+        logger.title('📊 Task Results');
+        console.log(chalk.gray('─'.repeat(60)));
+        let successCount = 0;
+        let failureCount = 0;
+        for (const result of results) {
+            const statusIcon = result.success ? chalk.green('✔') : chalk.red('✖');
+            const statusText = result.success ? chalk.green('SUCCESS') : chalk.red('FAILED');
+            console.log(`${statusIcon} ${chalk.bold(result.name)}: ${statusText}`);
+            if (!result.success) {
+                failureCount++;
+                if (result.error) {
+                    console.log(chalk.red(`   Error: ${result.error}`));
+                }
+            }
+            else {
+                successCount++;
+            }
+        }
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log('');
+        console.log(chalk.bold(`Results: ${chalk.green(`${successCount} succeeded`)} / ${chalk.red(`${failureCount} failed`)}`));
+        console.log('');
+        // Exit with appropriate code
+        if (failureCount > 0 && stopOnError) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        logger.error('Failed to run tasks');
+        if (error instanceof Error) {
+            console.error(chalk.red(error.message));
+        }
+        else {
+            console.error(error);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=run-tasks.js.map

package/dist/commands/run-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tasks.js","sourceRoot":"","sources":["../../src/commands/run-tasks.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,6 +2,8 @@
 import { createRequire } from 'module';
 import { Command } from 'commander';
 import { createCommand } from './commands/create.js';
+import { organizeCommand } from './commands/organize.js';
+import { runTasksCommand } from './commands/run-tasks.js';
 const pkgRequire = createRequire(import.meta.url);
 const { version: CLI_VERSION } = pkgRequire('../package.json');
 const program = new Command();
@@ -25,5 +27,17 @@ program
     .option('--multi-tenant', 'Enable multi-tenancy')
     .option('--skip-install', 'Skip dependency installation')
     .option('--skip-git', 'Skip Git initialization');
+program
+    .command('organize [folder-path]')
+    .description('Organize files by type or date')
+    .action(organizeCommand)
+    .option('--strategy <type>', 'Organization strategy: type or date')
+    .option('--duplicates', 'Move duplicate files to a Duplicates folder');
+program
+    .command('run-tasks [config-path]')
+    .description('Run batch tasks from a JSON config file')
+    .action(runTasksCommand)
+    .option('--parallel', 'Run tasks in parallel instead of sequentially')
+    .option('--stop-on-error', 'Stop execution if any task fails');
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAwB,CAAC;AAEtF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,4DAA4D,CAAC;KACzE,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B,OAAO;KACF,OAAO,CAAC,uBAAuB,CAAC;KAChC,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,aAAa,CAAC;KACrB,MAAM,CAAC,wBAAwB,EAAE,oBAAoB,CAAC;KACtD,MAAM,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;KACpD,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC5C,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC;KACrC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC;KACpC,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;KAC1D,MAAM,CAAC,gBAAgB,EAAE,mCAAmC,CAAC;KAC7D,MAAM,CAAC,UAAU,EAAE,8BAA8B,CAAC;KAClD,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;KAClD,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;KAChD,MAAM,CAAC,gBAAgB,EAAE,8BAA8B,CAAC;KACxD,MAAM,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;AAErD,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAwB,CAAC;AAEtF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,4DAA4D,CAAC;KACzE,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B,OAAO;KACF,OAAO,CAAC,uBAAuB,CAAC;KAChC,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,aAAa,CAAC;KACrB,MAAM,CAAC,wBAAwB,EAAE,oBAAoB,CAAC;KACtD,MAAM,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;KACpD,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC5C,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC;KACrC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC;KACpC,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;KAC1D,MAAM,CAAC,gBAAgB,EAAE,mCAAmC,CAAC;KAC7D,MAAM,CAAC,UAAU,EAAE,8BAA8B,CAAC;KAClD,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;KAClD,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;KAChD,MAAM,CAAC,gBAAgB,EAAE,8BAA8B,CAAC;KACxD,MAAM,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;AAErD,OAAO;KACF,OAAO,CAAC,wBAAwB,CAAC;KACjC,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,eAAe,CAAC;KACvB,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;KAClE,MAAM,CAAC,cAAc,EAAE,6CAA6C,CAAC,CAAC;AAE3E,OAAO;KACF,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,eAAe,CAAC;KACvB,MAAM,CAAC,YAAY,EAAE,+CAA+C,CAAC;KACrE,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC,CAAC;AAEnE,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/file-organizer.d.ts

@@ -0,0 +1,17 @@
+interface OrganizeResult {
+    categorized: Record<string, number>;
+    duplicates: number;
+}
+/**
+ * Detect duplicate files by hash
+ */
+export declare function detectDuplicates(folderPath: string): Promise<Map<string, string[]>>;
+/**
+ * Organize files by type into categorized folders
+ */
+export declare function organizeFilesByType(folderPath: string, duplicates?: Map<string, string[]>): Promise<OrganizeResult>;
+/**
+ * Organize files by date (YYYY-MM format)
+ */
+export declare function organizeFilesByDate(folderPath: string, duplicates?: Map<string, string[]>): Promise<OrganizeResult>;
+export {};

package/dist/utils/file-organizer.js

@@ -0,0 +1,170 @@
+import path from 'path';
+import fs from 'fs-extra';
+import crypto from 'crypto';
+// File type categories
+const FILE_CATEGORIES = {
+    Images: ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.svg', '.webp', '.ico', '.tiff'],
+    Documents: ['.pdf', '.doc', '.docx', '.txt', '.xls', '.xlsx', '.ppt', '.pptx', '.odt'],
+    Archives: ['.zip', '.rar', '.7z', '.tar', '.gz', '.bz2', '.iso'],
+    Videos: ['.mp4', '.avi', '.mkv', '.mov', '.wmv', '.flv', '.webm', '.m4v'],
+    Audio: ['.mp3', '.wav', '.flac', '.aac', '.ogg', '.wma', '.m4a'],
+    Code: ['.js', '.ts', '.py', '.java', '.cpp', '.c', '.go', '.rs', '.rb', '.php', '.html', '.css', '.json', '.xml', '.yaml', '.yml'],
+    Data: ['.csv', '.sql', '.db', '.sqlite', '.json', '.yaml'],
+    Executables: ['.exe', '.msi', '.app', '.bin', '.sh', '.bat'],
+    Others: [],
+};
+/**
+ * Calculate MD5 hash of a file
+ */
+async function getFileHash(filePath) {
+    try {
+        const content = await fs.readFile(filePath);
+        return crypto.createHash('md5').update(content).digest('hex');
+    }
+    catch {
+        // Return empty string for unreadable files
+        return '';
+    }
+}
+/**
+ * Detect duplicate files by hash
+ */
+export async function detectDuplicates(folderPath) {
+    const fileHashes = new Map();
+    const duplicates = new Map();
+    // System folders to skip
+    const skipFolders = new Set(['.git', '.env', 'node_modules', '.next', 'dist', 'build', '.DS_Store', '.vscode']);
+    async function scanDirectory(dir) {
+        try {
+            const files = await fs.readdir(dir);
+            for (const file of files) {
+                if (skipFolders.has(file) || file.startsWith('.')) {
+                    continue;
+                }
+                const filePath = path.join(dir, file);
+                try {
+                    const stats = await fs.stat(filePath);
+                    if (stats.isDirectory()) {
+                        await scanDirectory(filePath);
+                    }
+                    else if (stats.isFile() && stats.size > 0) {
+                        try {
+                            const hash = await getFileHash(filePath);
+                            if (hash) {
+                                if (!fileHashes.has(hash)) {
+                                    fileHashes.set(hash, []);
+                                }
+                                fileHashes.get(hash).push(filePath);
+                            }
+                        }
+                        catch {
+                            // Skip files that can't be hashed
+                        }
+                    }
+                }
+                catch {
+                    // Skip files/folders that can't be accessed
+                }
+            }
+        }
+        catch {
+            // Skip directories that can't be read
+        }
+    }
+    await scanDirectory(folderPath);
+    // Identify actual duplicates
+    for (const [hash, files] of fileHashes) {
+        if (files.length > 1) {
+            duplicates.set(hash, files);
+        }
+    }
+    return duplicates;
+}
+/**
+ * Organize files by type into categorized folders
+ */
+export async function organizeFilesByType(folderPath, duplicates = new Map()) {
+    const result = { categorized: {}, duplicates: 0 };
+    const duplicateSet = new Set();
+    // Build a set of duplicate files for quick lookup
+    for (const files of duplicates.values()) {
+        files.forEach(f => duplicateSet.add(f));
+    }
+    async function scanAndOrganize(dir) {
+        const files = await fs.readdir(dir);
+        for (const file of files) {
+            const filePath = path.join(dir, file);
+            const stats = await fs.stat(filePath);
+            if (stats.isDirectory()) {
+                // Skip special folders
+                if (file === 'Duplicates' || file.startsWith('.')) {
+                    continue;
+                }
+                await scanAndOrganize(filePath);
+            }
+            else {
+                const ext = path.extname(file).toLowerCase();
+                // Find category
+                let category = 'Others';
+                for (const [cat, extensions] of Object.entries(FILE_CATEGORIES)) {
+                    if (extensions.includes(ext)) {
+                        category = cat;
+                        break;
+                    }
+                }
+                const destFolder = path.join(folderPath, duplicateSet.has(filePath) ? 'Duplicates' : category);
+                await fs.ensureDir(destFolder);
+                await fs.move(filePath, path.join(destFolder, file), { overwrite: true });
+                if (duplicateSet.has(filePath)) {
+                    result.duplicates++;
+                }
+                else {
+                    result.categorized[category] = (result.categorized[category] || 0) + 1;
+                }
+            }
+        }
+    }
+    await scanAndOrganize(folderPath);
+    return result;
+}
+/**
+ * Organize files by date (YYYY-MM format)
+ */
+export async function organizeFilesByDate(folderPath, duplicates = new Map()) {
+    const result = { categorized: {}, duplicates: 0 };
+    const duplicateSet = new Set();
+    // Build a set of duplicate files
+    for (const files of duplicates.values()) {
+        files.forEach(f => duplicateSet.add(f));
+    }
+    async function scanAndOrganize(dir) {
+        const files = await fs.readdir(dir);
+        for (const file of files) {
+            const filePath = path.join(dir, file);
+            const stats = await fs.stat(filePath);
+            if (stats.isDirectory()) {
+                if (file.startsWith('.') || /^\d{4}-\d{2}$/.test(file)) {
+                    continue;
+                }
+                await scanAndOrganize(filePath);
+            }
+            else {
+                // Get file modification date
+                const mtime = new Date(stats.mtime);
+                const dateFolder = mtime.toISOString().slice(0, 7); // YYYY-MM
+                const destFolder = path.join(folderPath, duplicateSet.has(filePath) ? 'Duplicates' : dateFolder);
+                await fs.ensureDir(destFolder);
+                await fs.move(filePath, path.join(destFolder, file), { overwrite: true });
+                if (duplicateSet.has(filePath)) {
+                    result.duplicates++;
+                }
+                else {
+                    result.categorized[dateFolder] = (result.categorized[dateFolder] || 0) + 1;
+                }
+            }
+        }
+    }
+    await scanAndOrganize(folderPath);
+    return result;
+}
+//# sourceMappingURL=file-organizer.js.map

package/dist/utils/file-organizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-organizer.js","sourceRoot":"","sources":["../../src/utils/file-organizer.ts"],"names":[],"mappings":"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"}

package/dist/utils/task-runner.d.ts

@@ -0,0 +1,14 @@
+import { Task } from '../commands/run-tasks.js';
+export interface TaskResult {
+    name: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Execute tasks sequentially (one after another)
+ */
+export declare function executeTasksSequentially(tasks: Task[], stopOnError?: boolean): Promise<TaskResult[]>;
+/**
+ * Execute tasks in parallel
+ */
+export declare function executeTasksInParallel(tasks: Task[], stopOnError?: boolean): Promise<TaskResult[]>;

package/dist/utils/task-runner.js

@@ -0,0 +1,79 @@
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import os from 'os';
+/**
+ * Execute a single task
+ */
+async function executeTask(task) {
+    try {
+        console.log(`${chalk.cyan('→')} Running: ${chalk.bold(task.name)}`);
+        // Use shell: true for cross-platform command execution
+        const options = {
+            stdio: 'pipe',
+            encoding: 'utf-8',
+            shell: true,
+        };
+        if (task.cwd) {
+            options.cwd = task.cwd;
+        }
+        // Add shell option for cross-platform compatibility
+        if (os.platform() === 'win32') {
+            options.shell = 'cmd.exe';
+        }
+        try {
+            execSync(task.command, options);
+        }
+        catch (error) {
+            // execSync throws on non-zero exit code
+            // Extract stderr if available
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(`Command failed: ${task.command}`);
+        }
+        console.log(`${chalk.green('✔')} ${task.name} completed`);
+        return { name: task.name, success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        console.log(`${chalk.red('✖')} ${task.name} failed`);
+        return { name: task.name, success: false, error: errorMessage };
+    }
+}
+/**
+ * Execute tasks sequentially (one after another)
+ */
+export async function executeTasksSequentially(tasks, stopOnError = true) {
+    const results = [];
+    for (const task of tasks) {
+        console.log('');
+        const result = await executeTask(task);
+        results.push(result);
+        if (!result.success && stopOnError) {
+            console.log('');
+            console.log(chalk.yellow('⚠ Stopping execution due to task failure'));
+            break;
+        }
+    }
+    return results;
+}
+/**
+ * Execute tasks in parallel
+ */
+export async function executeTasksInParallel(tasks, stopOnError = true) {
+    console.log('');
+    const promises = tasks.map(task => executeTask(task)
+        .catch(error => ({
+        name: task.name,
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+    })));
+    const results = await Promise.all(promises);
+    // If stopOnError is true and any task failed, we should note this
+    if (stopOnError && results.some(r => !r.success)) {
+        console.log('');
+        console.log(chalk.yellow('⚠ Some tasks failed during parallel execution'));
+    }
+    return results;
+}
+//# sourceMappingURL=task-runner.js.map

package/dist/utils/task-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.js","sourceRoot":"","sources":["../../src/utils/task-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "forgestack-os-cli",
-    "version": "0.3.3",
-    "description": "ForgeStack OS CLI - Generate production-ready full-stack SaaS applications",
+    "version": "0.3.5",
+    "description": "ForgeStack OS CLI - Generate production-ready full-stack SaaS applications with file organization and batch task execution utilities",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "exports": {
@@ -32,7 +32,13 @@
         "cli",
         "generator",
         "saas",
-        "full-stack"
+        "full-stack",
+        "organize-files",
+        "file-organization",
+        "task-runner",
+        "batch-execution",
+        "duplicate-detection",
+        "workflow"
     ],
     "author": {
         "name": "Sumit Chauhan",
@@ -48,11 +54,12 @@
     },
     "homepage": "https://github.com/halloffame12/forgestack-os#readme",
     "engines": {
-        "node": ">=20"
+        "node": ">=18"
     },
     "dependencies": {
         "chalk": "^4.1.2",
         "commander": "^13.0.0",
+        "crypto": "^1.0.1",
         "ejs": "^3.1.10",
         "execa": "^5.1.1",
         "fs-extra": "^11.2.0",