servcraft 0.1.7 → 0.3.1

package/.github/workflows/ci.yml

@@ -82,10 +82,15 @@ jobs:
           retention-days: 7
 
   test:
-    name: Tests
+    name: Tests (Node ${{ matrix.node-version }})
     runs-on: ubuntu-latest
     needs: [lint, typecheck]
 
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+      fail-fast: false
+
     services:
       postgres:
         image: postgres:16-alpine
@@ -124,7 +129,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: ${{ matrix.node-version }}
           cache: 'npm'
 
       - name: Install dependencies
@@ -145,9 +150,9 @@ jobs:
 
       - name: Upload coverage report
         uses: actions/upload-artifact@v4
-        if: github.event_name == 'pull_request'
+        if: github.event_name == 'pull_request' && matrix.node-version == 20
         with:
-          name: coverage
+          name: coverage-node-${{ matrix.node-version }}
           path: coverage/
           retention-days: 7
 

package/README.md

@@ -265,11 +265,13 @@ servcraft init --ts             # Use TypeScript (default)
 servcraft init --esm            # Use ES Modules (default)
 servcraft init --cjs            # Use CommonJS
 servcraft init --db postgresql  # Specify database
+servcraft init --dry-run        # Preview files without writing
 
 # Combined examples
 servcraft init my-app --js --esm --db postgresql -y   # JS + ESM + PostgreSQL
 servcraft init my-app --js --cjs --db mongodb -y      # JS + CommonJS + MongoDB
 servcraft init my-app --ts --db mysql -y              # TypeScript + MySQL
+servcraft init my-app --dry-run -y                    # Preview without creating
 ```
 
 ### Generate resources
@@ -277,7 +279,9 @@ servcraft init my-app --ts --db mysql -y              # TypeScript + MySQL
 ```bash
 # Generate complete module
 servcraft generate module product
-servcraft g m product --prisma   # Include Prisma model
+servcraft g m product --prisma      # Include Prisma model
+servcraft g m product --with-tests  # Include test files (__tests__ directory)
+servcraft g m product --dry-run     # Preview files
 
 # Generate individual files
 servcraft generate controller user
@@ -291,8 +295,65 @@ servcraft g c user              # controller
 servcraft g s order             # service
 servcraft g r item              # repository
 servcraft g v post              # schema/validator
+
+# Preview before generating
+servcraft g m product name:string price:number --dry-run
+```
+
+### List available modules
+
+```bash
+servcraft list                      # Show all available modules
+servcraft list --installed          # Show only installed modules
+servcraft list --available          # Show only available modules
+servcraft list --category Security  # Filter by category
+servcraft list --json               # Output as JSON
+
+# Aliases
+servcraft ls                        # Same as list
 ```
 
+### Module Management
+
+```bash
+# Update modules
+servcraft update                    # Update all installed modules
+servcraft update auth               # Update specific module
+servcraft update --check            # Check for updates without applying
+servcraft update auth --yes         # Skip confirmation
+
+# Remove a module
+servcraft remove auth               # Interactive confirmation
+servcraft rm auth --yes             # Skip confirmation
+servcraft remove auth --keep-env    # Keep environment variables
+
+# Diagnose project
+servcraft doctor                    # Check configuration and dependencies
+```
+
+### Shell Auto-completion
+
+Enable tab completion for servcraft commands in your shell:
+
+```bash
+# Bash - Add to ~/.bashrc or ~/.bash_profile
+servcraft completion bash >> ~/.bashrc
+source ~/.bashrc
+
+# Zsh - Add to ~/.zshrc
+servcraft completion zsh >> ~/.zshrc
+source ~/.zshrc
+
+# Or save to completion directory (Zsh)
+servcraft completion zsh > ~/.zsh/completion/_servcraft
+```
+
+After enabling, you can use tab to autocomplete:
+- Commands: `servcraft <TAB>`
+- Subcommands: `servcraft generate <TAB>`
+- Module names: `servcraft add <TAB>`
+- Options and flags
+
 ### Add pre-built modules
 
 ```bash
@@ -312,7 +373,7 @@ servcraft add feature-flag      # Feature flags & A/B testing
 servcraft add analytics         # Prometheus metrics & tracking
 servcraft add media-processing  # Image/video processing
 servcraft add api-versioning    # API version management
-servcraft add --list            # Show all modules
+servcraft add auth --dry-run    # Preview module files
 ```
 
 **Automatic Environment Configuration:**

package/ROADMAP.md

@@ -4,7 +4,11 @@ This document outlines the planned features and improvements for Servcraft.
 
 ## Version History
 
-- **v0.1.7** (Current) - ESM/CommonJS module system choice
+- **v0.3.0** (Current) - Shell auto-completion, update command, comprehensive CLI tests (30 tests) - Phase 2 in progress 🚧
+- **v0.2.0** - Better errors, remove, doctor, update (stub) - Phase 1 complete ✅
+- **v0.1.9** - Added `--dry-run` option for all commands (init, add, generate)
+- **v0.1.8** - Added `servcraft list` command
+- **v0.1.7** - ESM/CommonJS module system choice
 - **v0.1.6.3** - JavaScript/TypeScript support, docs command, bug fixes
 - **v0.1.6.2** - Fixed empty modules, added config/middleware/utils generators
 - **v0.1.6.1** - Added @fastify/jwt compatibility fix
@@ -12,23 +16,37 @@ This document outlines the planned features and improvements for Servcraft.
 
 ---
 
-## Phase 1: Core CLI Improvements (v0.2.x)
+## Phase 1: Core CLI Improvements (v0.2.x) ✅ COMPLETE
+
+**Achievements:**
+- ✅ `servcraft list` - List available and installed modules
+- ✅ `--dry-run` - Preview changes for init, add, generate commands
+- ✅ Better error messages - Suggestions, colored output, docs links
+- ✅ `servcraft remove` - Remove modules with confirmation
+- ✅ `servcraft doctor` - Diagnose project configuration
+- ⏳ `servcraft update` - Stub created for v0.2.1
+
+---
 
 ### v0.2.0 - CLI Enhancements
 
-#### `servcraft list`
+#### `servcraft list` ✅ Completed in v0.1.8
 List available and installed modules.
 ```bash
-servcraft list              # List all available modules
-servcraft list --installed  # List installed modules only
+servcraft list                      # List all available modules
+servcraft list --installed          # List installed modules only
+servcraft list --category Security  # Filter by category
+servcraft list --json               # Output as JSON
 ```
 
-#### `--dry-run` Option
+#### `--dry-run` Option ✅ Completed in v0.1.9
 Preview changes without writing files.
 ```bash
-servcraft init my-app --dry-run
-servcraft add auth --dry-run
-servcraft generate module users --dry-run
+servcraft init my-app --dry-run       # ✅ Implemented
+servcraft add auth --dry-run           # ✅ Implemented
+servcraft generate module users --dry-run  # ✅ Implemented
+servcraft generate controller users --dry-run  # ✅ Implemented
+servcraft generate service users --dry-run     # ✅ Implemented
 ```
 
 #### Better Error Messages
@@ -42,89 +60,108 @@ servcraft generate module users --dry-run
 
 ### v0.2.1 - Module Management
 
-#### `servcraft remove <module>`
+#### `servcraft remove <module>` ✅ Completed in v0.2.0
 Remove an installed module.
 ```bash
 servcraft remove auth
-servcraft remove auth --keep-migrations  # Keep database migrations
+servcraft remove auth --yes          # Skip confirmation
+servcraft remove auth --keep-env     # Keep environment variables
 ```
 
 Features:
-- Remove module files from `src/modules/`
-- Clean up related environment variables
-- Optionally remove database migrations
-- Update imports in main files
+- ✅ Remove module files from `src/modules/`
+- ✅ Interactive confirmation
+- ✅ Show cleanup instructions
+- ✅ Alias: rm
 
-#### `servcraft update [module]`
+#### `servcraft update [module]` ✅ Completed in v0.3.0
 Update modules to latest version.
 ```bash
 servcraft update           # Update all modules
 servcraft update auth      # Update specific module
 servcraft update --check   # Check for updates without applying
+servcraft update --yes     # Skip confirmation
 ```
 
+Features:
+- ✅ Update specific module or all installed modules
+- ✅ Interactive confirmation before updating
+- ✅ Check mode to see what would be updated
+- ✅ Overwrites existing files with latest version
+- ✅ Error handling and validation
+
+Note: Version tracking will be added in a future release. Currently always installs latest version.
+
 **Estimated complexity:** Medium
 
 ---
 
 ### v0.2.2 - Developer Experience
 
-#### `servcraft doctor`
+#### `servcraft doctor` ✅ Completed in v0.2.0
 Diagnose project configuration issues.
 ```bash
 servcraft doctor
 ```
 
 Checks:
-- Node.js version compatibility
-- Missing dependencies
-- Environment variables validation
-- Database connection
-- TypeScript configuration
-- Prisma schema sync status
-
-#### Shell Auto-completion
+- ✅ Node.js version compatibility
+- ✅ package.json and Fastify
+- ✅ Project directories (src, node_modules)
+- ✅ Git repository
+- ✅ .env file
+
+#### Shell Auto-completion ✅ Completed in v0.3.0
 ```bash
 servcraft completion bash >> ~/.bashrc
 servcraft completion zsh >> ~/.zshrc
 ```
 
+Features:
+- ✅ Bash completion script with command and module suggestions
+- ✅ Zsh completion script with descriptions
+- ✅ Autocomplete for all commands, subcommands, and modules
+- ✅ Support for aliases (g, m, c, s, etc.)
+
 **Estimated complexity:** Medium
 
 ---
 
-## Phase 2: Testing & Quality (v0.3.x)
+## Phase 2: Testing & Quality (v0.3.x) 🚧 In Progress
 
 ### v0.3.0 - CLI Tests
 
 #### Unit Tests for CLI Commands
-- Test `init` command with various options
-- Test `add` command for all 20 modules
-- Test `generate` command (module, controller, service, etc.)
-- Test `db` commands
-- Test `docs` commands
-
-#### Integration Tests
-- Full project generation and startup
-- Module installation and removal
-- Database operations
+- ✅ Test `list` command (3 tests passing)
+- ✅ Test `doctor` command (3 tests passing)
+- ✅ Test `--dry-run` option (2 tests passing)
+- ✅ Test `init` command with various options (4 tests: --js, --cjs, --esm, --dry-run)
+- ✅ Test `generate` command variants (3 tests: controller, service, module)
+- ✅ Test error handling (2 tests: invalid module, documentation links)
+- ✅ Test `add` command for modules (3 tests: validation, error handling, help)
+- ✅ Test `remove` command (3 tests: validation, help, alias)
+- ✅ Test `update` command (3 tests: validation, check flag, help)
+- ✅ Test `completion` command (4 tests: bash, zsh, error, help)
 
 #### CI/CD Pipeline
-- GitHub Actions for automated testing
-- Test on Node.js 18, 20, 22
-- Code coverage reporting
+- ✅ GitHub Actions configured
+- ✅ Tests run on Node.js 18, 20, 22 (matrix strategy)
+- ✅ Coverage reporting configured
+- ✅ PostgreSQL and Redis services for integration tests
+- ✅ Lint, typecheck, build, test, security audit jobs
+
+**Status:** 30 CLI tests added and passing ✅ (111 total tests including integration tests)
 
 **Estimated complexity:** High
 
 ---
 
-### v0.3.1 - Generated Project Tests
+### v0.3.1 - Generated Project Tests ✅ Completed
 
 #### Test Templates
 Generate test files alongside modules:
 ```bash
 servcraft generate module users --with-tests
-servcraft add auth  # Includes test files
 ```
 
 Generated test structure:
@@ -139,6 +176,14 @@ src/modules/users/
 │   └── users.integration.test.ts
 ```
 
+Features:
+- ✅ Controller test templates with Fastify injection
+- ✅ Service test templates with unit test structure
+- ✅ Integration test templates with full CRUD workflow
+- ✅ --with-tests flag for generate module command
+- ✅ Vitest test structure and assertions
+- ✅ TODO comments for customization
+
 **Estimated complexity:** Medium
 
 ---