servcraft 0.2.0 → 0.4.2

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

@@ -277,10 +277,15 @@ servcraft init my-app --dry-run -y                    # Preview without creating
 ### Generate resources
 
 ```bash
+# Scaffold complete CRUD resource (recommended)
+servcraft scaffold product --fields "name:string price:number category:string?"
+servcraft scaffold user --fields "name:string email:email age:number?" --validator zod
+
 # Generate complete module
 servcraft generate module product
-servcraft g m product --prisma   # Include Prisma model
-servcraft g m product --dry-run  # Preview files
+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
@@ -312,6 +317,69 @@ servcraft list --json               # Output as JSON
 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
+```
+
+### Custom Templates
+
+Customize code generation templates for your project:
+
+```bash
+# Initialize custom templates directory
+servcraft templates init        # Creates .servcraft/templates/
+
+# List available templates
+servcraft templates list         # Shows project, user, and built-in templates
+```
+
+**Template locations (priority order):**
+1. Project: `.servcraft/templates/` - Project-specific templates
+2. User: `~/.servcraft/templates/` - User-wide templates
+3. Built-in: Default ServCraft templates
+
+**Available template types:**
+- controller.ts, service.ts, repository.ts
+- types.ts, schemas.ts, routes.ts, module-index.ts
+- controller-test.ts, service-test.ts, integration-test.ts
+
+### 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

package/ROADMAP.md

@@ -4,7 +4,12 @@ This document outlines the planned features and improvements for Servcraft.
 
 ## Version History
 
-- **v0.2.0** (Current) - Better error messages, servcraft remove, servcraft doctor (stub)
+- **v0.4.2** (Current) - Custom template loading in generate/scaffold - Phase 3 in progress 🚧
+- **v0.4.1** - Custom templates management (init/list)
+- **v0.4.0** - Scaffold command for complete CRUD generation
+- **v0.3.1** - Test templates with --with-tests flag - Phase 2 complete ✅
+- **v0.3.0** - Shell auto-completion, update command, comprehensive CLI tests (30 tests), CI/CD on Node.js 18/20/22
+- **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
@@ -15,7 +20,17 @@ 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
 
@@ -49,89 +64,108 @@ servcraft generate service users --dry-run     # ✅ Implemented
 
 ### 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:
@@ -146,34 +180,52 @@ 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
 
 ---
 
 ## Phase 3: Advanced Features (v0.4.x)
 
-### v0.4.0 - Scaffolding
+### v0.4.0 - Scaffolding ✅ Completed
 
 #### `servcraft scaffold <resource>`
 Generate complete CRUD with single command.
 ```bash
-servcraft scaffold product --fields "name:string price:number category:relation"
+servcraft scaffold product --fields "name:string price:number category:string?"
+servcraft scaffold user --fields "name:string email:email age:number?" --validator zod
 ```
 
 Generates:
-- Prisma model
-- Controller with CRUD endpoints
-- Service with business logic
-- Repository with data access
-- Routes with validation
-- Types/DTOs
-- Tests
+- ✅ Prisma model (with proper types and indexes)
+- ✅ Controller with CRUD endpoints
+- ✅ Service with business logic
+- ✅ Repository with data access
+- ✅ Routes with validation
+- ✅ Types/DTOs (interface, Create, Update, Filters)
+- ✅ Schemas (Zod/Joi/Yup validators)
+- ✅ Test files (controller, service, integration)
+
+Features:
+- Parses field definitions with types and modifiers
+- Supports optional fields (?)
+- Generates complete Prisma model ready to copy
+- Includes all CRUD operations
+- Automatically generates tests with --with-tests behavior
+- Supports all validators (zod, joi, yup)
 
 **Estimated complexity:** High
 
 ---
 
-### v0.4.1 - Custom Templates
+### v0.4.1 - Custom Templates ✅ Completed
 
 #### Template System
 Allow users to customize generated code.
@@ -181,10 +233,18 @@ Allow users to customize generated code.
 ```bash
 servcraft templates init           # Create .servcraft/templates/
 servcraft templates list           # List available templates
-servcraft generate module --template custom-module
 ```
 
-Template locations:
+Features:
+- ✅ `servcraft templates init` - Initialize custom template directory
+- ✅ `servcraft templates list` - List project/user/built-in templates
+- ✅ Project templates in `.servcraft/templates/`
+- ✅ User templates in `~/.servcraft/templates/`
+- ✅ Built-in template fallback
+- ✅ Example template file created on init
+- ✅ Support for all 10 template types
+
+Template locations (priority order):
 1. Project `.servcraft/templates/`
 2. User `~/.servcraft/templates/`
 3. Built-in defaults
@@ -193,7 +253,24 @@ Template locations:
 
 ---
 
-### v0.4.2 - Plugin System
+### v0.4.2 - Template Loading ✅ Completed
+
+#### Custom Template Loading
+Automatically use custom templates in generate/scaffold commands.
+
+Features:
+- ✅ Template loader utility with priority-based loading
+- ✅ `generate` command uses custom templates automatically
+- ✅ `scaffold` command uses custom templates automatically
+- ✅ Falls back to built-in templates when custom not found
+- ✅ Supports all 10 template types seamlessly
+- ✅ No additional flags needed - works out of the box
+
+**Estimated complexity:** Medium
+
+---
+
+### v0.4.3 - Plugin System
 
 #### Third-party Plugins
 ```bash