Merge pull request #6 from noxify/cli-changes

update changesets

Author: noxify

.changeset/adapter-drizzle-initial-release.md

@@ -9,12 +9,14 @@ Database adapter supporting PostgreSQL and MariaDB/MySQL via Drizzle ORM.
 ## 🗄️ Database Support
 
 ### PostgreSQL
+
 - **PostgreSQL 12+** with SKIP LOCKED support for concurrent processing
 - **Multiple drivers**: node-postgres, postgres.js, PGlite
 - **Full feature support**: JSONB payloads, UUID primary keys, timezone-aware timestamps
 - **Connection pooling** and transaction support
 
-### MariaDB/MySQL  
+### MariaDB/MySQL
+
 - **MariaDB 10.6+** and **MySQL 8.0+** with SKIP LOCKED functionality
 - **mysql2 driver** with promise support and connection pooling
 - **JSON payloads** with proper serialization/deserialization
@@ -36,21 +38,21 @@ Database adapter supporting PostgreSQL and MariaDB/MySQL via Drizzle ORM.
 
 ## 📦 Easy Integration
 
+**with PostgreSQL:**
+
 ```typescript
 // PostgreSQL
 import { PostgresQueueAdapter, postgresSchema } from "@vorsteh-queue/adapter-drizzle"
+
 const db = drizzle(pool, { schema: postgresSchema })
 const adapter = new PostgresQueueAdapter(db, "my-queue")
+```
 
+**with MariaDB/MySQL:**
+
+```
 // MariaDB/MySQL
 import { MariaDBQueueAdapter, mariadbSchema } from "@vorsteh-queue/adapter-drizzle"
 const db = drizzle(connection, { schema: mariadbSchema })
 const adapter = new MariaDBQueueAdapter(db, "my-queue")
 ```
-
-## 🛡️ Enterprise Features
-
-- **Connection pooling** support for high-throughput applications
-- **Transaction support** for atomic job operations
-- **Error handling** with proper database-specific error types
-- **Schema validation** and type safety throughout

.changeset/create-vorsteh-queue-initial-release.md

@@ -17,56 +17,33 @@ Interactive CLI tool for creating new Vorsteh Queue projects with zero configura
 ## 🎯 Usage Options
 
 ### Interactive Mode
+
 ```bash
 npx create-vorsteh-queue
 # Prompts for project name, template, and package manager
 ```
 
-### Direct Mode  
+### Direct Mode
+
 ```bash
-npx create-vorsteh-queue my-app --template=drizzle-pglite --package-manager=pnpm
+npx create-vorsteh-queue my-app --template=drizzle-pglite --package-manager=pnpm --no-install
 # Fully automated project creation
 ```
 
 ### CLI Flags
+
 - `--template=<name>` or `-t=<name>` - Choose template
 - `--package-manager=<pm>` or `-pm=<pm>` - Package manager (npm/pnpm/yarn/bun)
+- `--no-install` - Skip dependency install
 - `--quiet` or `-q` - Minimal output for automation
 
 ## 📦 Available Templates
 
 Templates are **dynamically discovered** from the repository:
 
-- **drizzle-postgres-example** - Advanced example using Drizzle ORM with postgres.js and recurring jobs
-- **drizzle-pg-example** - Basic example using Drizzle ORM with node-postgres (pg)
-- **drizzle-pglite-example** - Zero-setup example using Drizzle ORM with PGlite (embedded PostgreSQL)
-- **progress-tracking-example** - Real-time job progress tracking using Drizzle ORM with postgres.js
-- **event-system-example** - Comprehensive event monitoring and statistics using Drizzle ORM with postgres.js
-
-## 🔧 Smart Features
-
-- **Latest versions** - Automatically fetches current package versions from npm registry
-- **Workspace replacement** - Converts workspace dependencies to npm versions
-- **Template validation** - Ensures selected templates exist and are valid
-- **Package manager detection** - Validates and uses specified package manager
-- **Error handling** - Graceful fallbacks and helpful error messages
-
-## 🤖 Automation Ready
-
-Perfect for CI/CD pipelines and scripting:
-
-```bash
-# Silent project creation
-npx create-vorsteh-queue worker-service \
-  --template=drizzle-postgres \
-  --package-manager=pnpm \
-  --quiet
-```
-
-## 🎨 Developer Experience
-
-- **Colorful output** with picocolors for enhanced readability
-- **Progress indicators** with spinners for long-running operations
-- **Helpful links** to documentation and examples
-- **Validation** with clear error messages and suggestions
-- **Cross-platform** support for Windows, macOS, and Linux
+- **drizzle-pg** - Basic example using Drizzle ORM with node-postgres (pg)
+- **drizzle-pglite** - Zero-setup example using Drizzle ORM with PGlite (embedded PostgreSQL)
+- **drizzle-postgres** - Advanced example using Drizzle ORM with postgres.js and recurring jobs
+- **event-system** - Comprehensive event monitoring and statistics using Drizzle ORM with postgres.js
+- **pm2-workers** - Manage multiple Vorsteh Queues with PM2 using Drizzle ORM with postgres.js
+- **progress-tracking** - Real-time job progress tracking using Drizzle ORM with postgres.js

examples/pm2-workers/package.json

@@ -1,6 +1,7 @@
 {
   "name": "pm2-workers-example",
   "version": "1.0.0",
+  "description": "Manage multiple Vorsteh Queues with PM2 using Drizzle ORM with postgres.js",
   "type": "module",
   "private": true,
   "scripts": {

packages/create-vorsteh-queue/README.md

@@ -29,17 +29,21 @@ npx create-vorsteh-queue my-app -pm=yarn
 npx create-vorsteh-queue my-app --quiet
 npx create-vorsteh-queue my-app -q
 
-# Fully automated
+# Fully automated (no prompts)
 npx create-vorsteh-queue my-app -t=drizzle-pglite -pm=pnpm --quiet
+
+# Skip dependency installation
+npx create-vorsteh-queue my-app -t=drizzle-pglite --no-install --quiet
 ```
 
 ## CLI Options
 
-| Option                   | Short       | Description     | Example             |
-| ------------------------ | ----------- | --------------- | ------------------- |
-| `--template=<name>`      | `-t=<name>` | Choose template | `-t=drizzle-pglite` |
-| `--package-manager=<pm>` | `-pm=<pm>`  | Package manager | `-pm=pnpm`          |
-| `--quiet`                | `-q`        | Minimal output  | `--quiet`           |
+| Option                   | Short       | Description             | Example             |
+| ------------------------ | ----------- | ----------------------- | ------------------- |
+| `--template=<name>`      | `-t=<name>` | Choose template         | `-t=drizzle-pglite` |
+| `--package-manager=<pm>` | `-pm=<pm>`  | Package manager         | `-pm=pnpm`          |
+| `--no-install`           | -           | Skip dependency install | `--no-install`      |
+| `--quiet`                | `-q`        | Minimal output          | `--quiet`           |
 
 ### Package Managers
 
@@ -48,39 +52,19 @@ npx create-vorsteh-queue my-app -t=drizzle-pglite -pm=pnpm --quiet
 - **yarn** - Popular alternative
 - **bun** - Ultra-fast (experimental)
 
-## Available Templates
+## 📦 Available Templates
 
-Templates are **dynamically discovered** from the GitHub repository:
+Templates are **dynamically discovered** from the repository:
 
-- **drizzle-postgres-example** - Advanced example using Drizzle ORM with postgres.js and recurring jobs
-- **drizzle-pg-example** - Basic example using Drizzle ORM with node-postgres (pg)
-- **drizzle-pglite-example** - Zero-setup example using Drizzle ORM with PGlite (embedded PostgreSQL)
-- **progress-tracking-example** - Real-time job progress tracking using Drizzle ORM with postgres.js
-- **event-system-example** - Comprehensive event monitoring and statistics using Drizzle ORM with postgres.js
+- **drizzle-pg** - Basic example using Drizzle ORM with node-postgres (pg)
+- **drizzle-pglite** - Zero-setup example using Drizzle ORM with PGlite (embedded PostgreSQL)
+- **drizzle-postgres** - Advanced example using Drizzle ORM with postgres.js and recurring jobs
+- **event-system** - Comprehensive event monitoring and statistics using Drizzle ORM with postgres.js
+- **pm2-workers** - Manage multiple Vorsteh Queues with PM2 using Drizzle ORM with postgres.js
+- **progress-tracking** - Real-time job progress tracking using Drizzle ORM with postgres.js
 
 > Templates are automatically fetched from the examples directory, so new examples are immediately available!
 
-## Features
-
-- 🚀 **Interactive CLI** - Beautiful prompts with @clack/prompts
-- 📦 **Dynamic templates** - Auto-discovered from GitHub repository
-- 🔄 **Latest versions** - Fetches current versions from npm registry
-- 🎨 **Colorful output** - Enhanced terminal experience with picocolors
-- 🔗 **Helpful links** - Direct links to documentation
-- ⚡ **Fast downloads** - Efficient template downloading with giget
-- 🤫 **Quiet mode** - Silent operation for automation
-- 🛠️ **Multiple package managers** - npm, pnpm, yarn, bun support
-- 🎯 **CLI flags** - Full automation support
-
-## What it does
-
-1. **Discovers templates** - Dynamically fetches available templates from GitHub
-2. **Prompts for details** - Name, template, package manager (if not provided via CLI)
-3. **Downloads template** - Uses giget to efficiently download from GitHub
-4. **Updates package.json** - Replaces workspace dependencies with latest npm versions
-5. **Installs dependencies** - Uses selected package manager
-6. **Provides guidance** - Shows next steps with correct commands
-
 ## Examples
 
 ### Interactive Usage
@@ -114,7 +98,8 @@ Next steps:
 npx create-vorsteh-queue worker-service \
   --template=drizzle-postgres \
   --package-manager=pnpm \
-  --quiet
+  --quiet \
+  --no-install
 ```
 
 ## Development
@@ -128,15 +113,4 @@ pnpm dev
 
 # Build for production
 pnpm build
-
-# Test locally
-npx tsx src/index.ts my-test-app
 ```
-
-## Architecture
-
-- **Dynamic Discovery** - Templates fetched from GitHub API
-- **Smart Caching** - giget handles efficient downloads
-- **Version Management** - npm registry API for latest versions
-- **Graceful Fallbacks** - Works offline with cached templates
-- **Cross-platform** - Works on Windows, macOS, Linux

packages/create-vorsteh-queue/src/index.ts

@@ -175,6 +175,7 @@ async function main() {
   const pmFlag = args.find((arg) => arg.startsWith("--package-manager=") || arg.startsWith("-pm="))
   const templateFlag = args.find((arg) => arg.startsWith("--template=") || arg.startsWith("-t="))
   const quietMode = args.includes("--quiet") || args.includes("-q")
+  const noInstall = args.includes("--no-install")
   const cliPackageManager = pmFlag?.split("=")[1]
   const cliTemplate = templateFlag?.split("=")[1]
 
@@ -255,14 +256,20 @@ async function main() {
     }
   }
 
-  const installDeps = await confirm({
-    message: "Install dependencies?",
-    initialValue: true,
-  })
+  // Skip dependency prompt if all CLI args provided (full automation) or --no-install flag
+  let installDeps = !noInstall
+  if (!noInstall && (!cliTemplate || !cliPackageManager)) {
+    const result = await confirm({
+      message: "Install dependencies?",
+      initialValue: true,
+    })
+
+    if (isCancel(result)) {
+      cancel("Operation cancelled")
+      return process.exit(0)
+    }
 
-  if (isCancel(installDeps)) {
-    cancel("Operation cancelled")
-    return process.exit(0)
+    installDeps = result
   }
 
   let packageManager = "npm"