feat(cli): add custom template support for init command

Add support for loading templates from GitHub repositories or local paths
when initializing LaunchQL workspaces and modules, similar to create-cosmos-app
and create-interchain-app patterns.

Features:
- Load templates from GitHub repositories via --repo option
- Load templates from local paths via --template-path option
- Specify branch when using GitHub templates via --from-branch option
- Automatic template type detection (workspace vs module)
- Support for both boilerplates root directory and direct template paths

Changes:
- Add loadTemplates() function in @launchql/templatizer package
- Add TemplateSource interface for template configuration
- Update init command to support new template options
- Update LaunchQLPackage.initModule() to accept templateSource parameter
- Improve makeTemplates.ts path handling with environment variable support
- Add comprehensive test coverage for template loading scenarios
- Update CLI documentation (README.md and AGENTS.md)

Technical notes:
- GitHub templates are cloned to temporary directories and cleaned up

Fixes: Template loading functionality for custom boilerplates

Author: sdqede

packages/cli/AGENTS.md

@@ -130,6 +130,23 @@ lql init --workspace    # Initialize workspace
 lql init               # Initialize module (in workspace)
 ```
 
+**Template Options:**
+- `--repo <repo>` - Use templates from GitHub repository (e.g., `owner/repo`)
+- `--template-path <path>` - Use templates from local path
+- `--from-branch <branch>` - Specify branch when using `--repo` (default: `main`)
+
+**Examples:**
+```bash
+lql init --workspace --repo launchql/launchql
+lql init --workspace --template-path ./custom-templates
+lql init --repo owner/repo --from-branch develop
+```
+
+**Implementation:**
+- Supports loading templates from GitHub repositories or local paths
+- Automatically detects template type (workspace vs module)
+- Uses `loadTemplates()` from `@launchql/templatizer` to load custom templates
+
 ### 3. Server Command
 **File:** `src/commands/server.ts`
 **Purpose:** Start GraphQL development server with hot-reload
@@ -318,7 +335,7 @@ try {
 ### Development Commands
 | Command | Purpose | Key Options |
 |---------|---------|-------------|
-| `init` | Initialize workspace/module | `--workspace` |
+| `init` | Initialize workspace/module | `--workspace`, `--repo`, `--template-path`, `--from-branch` |
 | `server` | Start development server | `--port`, `--no-postgis` |
 | `explorer` | Launch GraphiQL explorer | `--origin` |
 

packages/cli/README.md

@@ -8,7 +8,7 @@ LaunchQL CLI is a comprehensive command-line tool that transforms your PostgreSQ
 
 - 🚀 **Database-First Development** - Design your database, get your GraphQL API automatically
 - 🔐 **Built-in Security** - Role-based access control and security policies
-- 📦 **Module System** - Reusable database modules with dependency management  
+- 📦 **Module System** - Reusable database modules with dependency management
 - 🔄 **Smart Migrations** - Automated migration generation and deployment
 - 🛠️ **Developer Experience** - Hot-reload development server with GraphiQL explorer
 - 🏗️ **Production Ready** - Deployment plans, versioning, and rollback support
@@ -60,6 +60,7 @@ Visit `http://localhost:5555` to explore your GraphQL API!
 ### Getting Started
 
 #### `lql init`
+
 Initialize a new LaunchQL workspace or module.
 
 ```bash
@@ -68,11 +69,27 @@ lql init --workspace
 
 # Create a new module (run inside workspace)
 lql init
+
+# Use templates from GitHub repository
+lql init --workspace --repo owner/repo
+lql init --repo owner/repo --from-branch develop
+
+# Use templates from local path
+lql init --workspace --template-path ./custom-templates
+lql init --template-path ./custom-templates/module
 ```
 
+**Options:**
+
+- `--workspace` - Initialize workspace instead of module
+- `--repo <repo>` - Use templates from GitHub repository (e.g., `owner/repo`)
+- `--template-path <path>` - Use templates from local path
+- `--from-branch <branch>` - Specify branch when using `--repo` (default: `main`)
+
 ### Development
 
 #### `lql server`
+
 Start the GraphQL development server with hot-reload.
 
 ```bash
@@ -84,6 +101,7 @@ lql server --port 8080 --no-postgis
 ```
 
 #### `lql explorer`
+
 Launch GraphiQL explorer for your API.
 
 ```bash
@@ -97,6 +115,7 @@ lql explorer --origin http://localhost:3000
 ### Database Operations
 
 #### `lql deploy`
+
 Deploy your database changes and migrations.
 
 ```bash
@@ -114,6 +133,7 @@ lql deploy --fast --no-tx
 ```
 
 #### `lql verify`
+
 Verify your database state matches expected migrations.
 
 ```bash
@@ -125,6 +145,7 @@ lql verify --package mypackage
 ```
 
 #### `lql revert`
+
 Safely revert database changes.
 
 ```bash
@@ -138,13 +159,14 @@ lql revert --to @v1.0.0
 ### Migration Management
 
 #### `lql migrate`
+
 Comprehensive migration management.
 
 ```bash
 # Initialize migration tracking
 lql migrate init
 
-# Check migration status  
+# Check migration status
 lql migrate status
 
 # List all changes
@@ -157,6 +179,7 @@ lql migrate deps
 ### Module Management
 
 #### `lql install`
+
 Install LaunchQL modules as dependencies.
 
 ```bash
@@ -168,13 +191,15 @@ lql install @launchql/auth @launchql/utils
 ```
 
 #### `lql extension`
+
 Interactively manage module dependencies.
 
 ```bash
 lql extension
 ```
 
 #### `lql tag`
+
 Version your changes with tags.
 
 ```bash
@@ -191,13 +216,15 @@ lql tag v1.1.0 --package mypackage --changeName my-change
 ### Packaging and Distribution
 
 #### `lql plan`
+
 Generate deployment plans for your modules.
 
 ```bash
 lql plan
 ```
 
 #### `lql package`
+
 Package your module for distribution.
 
 ```bash
@@ -211,13 +238,15 @@ lql package --no-plan
 ### Utilities
 
 #### `lql export`
+
 Export migrations from existing databases.
 
 ```bash
 lql export
 ```
 
 #### `lql kill`
+
 Clean up database connections and optionally drop databases.
 
 ```bash
@@ -237,7 +266,7 @@ lql kill --no-drop
 mkdir my-app && cd my-app
 lql init --workspace
 
-# 2. Create your first module  
+# 2. Create your first module
 lql init
 
 # 3. Add some SQL migrations to sql/ directory
@@ -248,6 +277,31 @@ lql deploy --createdb
 lql server
 ```
 
+### Using Custom Templates
+
+You can use custom templates from GitHub repositories or local paths:
+
+```bash
+# Initialize workspace with templates from GitHub
+lql init --workspace --repo owner/repo
+
+# Initialize workspace with templates from local path
+lql init --workspace --template-path ./my-custom-templates
+
+# Initialize module with custom templates
+lql init --template-path ./my-custom-templates
+
+# Use specific branch from GitHub repository
+lql init --workspace --repo owner/repo --from-branch develop
+```
+
+**Template Structure:**
+Custom templates should follow the same structure as the default templates:
+
+- For workspace: `boilerplates/workspace/` directory
+- For module: `boilerplates/module/` directory
+- Or provide direct path to `workspace/` or `module/` directory
+
 ### Working with Existing Projects
 
 ```bash
@@ -302,7 +356,7 @@ export PGPASSWORD=password
 # Global help
 lql --help
 
-# Command-specific help  
+# Command-specific help
 lql deploy --help
 lql server -h
 ```
@@ -312,51 +366,50 @@ lql server -h
 Most commands support these global options:
 
 - `--help, -h` - Show help information
-- `--version, -v` - Show version information  
+- `--version, -v` - Show version information
 - `--cwd <dir>` - Set working directory
 
 ## Related LaunchQL Tooling
 
 ### 🧪 Testing
 
-* [launchql/pgsql-test](https://github.com/launchql/launchql/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
-* [launchql/graphile-test](https://github.com/launchql/launchql/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
-* [launchql/pg-query-context](https://github.com/launchql/launchql/tree/main/packages/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings.
+- [launchql/pgsql-test](https://github.com/launchql/launchql/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
+- [launchql/graphile-test](https://github.com/launchql/launchql/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
+- [launchql/pg-query-context](https://github.com/launchql/launchql/tree/main/packages/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings.
 
 ### 🧠 Parsing & AST
 
-* [launchql/pgsql-parser](https://github.com/launchql/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
-* [launchql/libpg-query-node](https://github.com/launchql/libpg-query-node): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
-* [launchql/pg-proto-parser](https://github.com/launchql/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
-* [@pgsql/enums](https://github.com/launchql/pgsql-parser/tree/main/packages/enums): **🏷️ TypeScript enums** for PostgreSQL AST for safe and ergonomic parsing logic.
-* [@pgsql/types](https://github.com/launchql/pgsql-parser/tree/main/packages/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
-* [@pgsql/utils](https://github.com/launchql/pgsql-parser/tree/main/packages/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
-* [launchql/pg-ast](https://github.com/launchql/launchql/tree/main/packages/pg-ast): **🔍 Low-level AST tools** and transformations for Postgres query structures.
+- [launchql/pgsql-parser](https://github.com/launchql/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
+- [launchql/libpg-query-node](https://github.com/launchql/libpg-query-node): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
+- [launchql/pg-proto-parser](https://github.com/launchql/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
+- [@pgsql/enums](https://github.com/launchql/pgsql-parser/tree/main/packages/enums): **🏷️ TypeScript enums** for PostgreSQL AST for safe and ergonomic parsing logic.
+- [@pgsql/types](https://github.com/launchql/pgsql-parser/tree/main/packages/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
+- [@pgsql/utils](https://github.com/launchql/pgsql-parser/tree/main/packages/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
+- [launchql/pg-ast](https://github.com/launchql/launchql/tree/main/packages/pg-ast): **🔍 Low-level AST tools** and transformations for Postgres query structures.
 
 ### 🚀 API & Dev Tools
 
-* [launchql/server](https://github.com/launchql/launchql/tree/main/packages/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
-* [launchql/explorer](https://github.com/launchql/launchql/tree/main/packages/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
+- [launchql/server](https://github.com/launchql/launchql/tree/main/packages/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
+- [launchql/explorer](https://github.com/launchql/launchql/tree/main/packages/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
 
 ### 🔁 Streaming & Uploads
 
-* [launchql/s3-streamer](https://github.com/launchql/launchql/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
-* [launchql/etag-hash](https://github.com/launchql/launchql/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
-* [launchql/etag-stream](https://github.com/launchql/launchql/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
-* [launchql/uuid-hash](https://github.com/launchql/launchql/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
-* [launchql/uuid-stream](https://github.com/launchql/launchql/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
-* [launchql/upload-names](https://github.com/launchql/launchql/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
+- [launchql/s3-streamer](https://github.com/launchql/launchql/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
+- [launchql/etag-hash](https://github.com/launchql/launchql/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
+- [launchql/etag-stream](https://github.com/launchql/launchql/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
+- [launchql/uuid-hash](https://github.com/launchql/launchql/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
+- [launchql/uuid-stream](https://github.com/launchql/launchql/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
+- [launchql/upload-names](https://github.com/launchql/launchql/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
 
 ### 🧰 CLI & Codegen
 
-* [@launchql/cli](https://github.com/launchql/launchql/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation.
-* [launchql/launchql-gen](https://github.com/launchql/launchql/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
-* [@launchql/query-builder](https://github.com/launchql/launchql/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.
-* [@launchql/query](https://github.com/launchql/launchql/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
+- [@launchql/cli](https://github.com/launchql/launchql/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation.
+- [launchql/launchql-gen](https://github.com/launchql/launchql/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
+- [@launchql/query-builder](https://github.com/launchql/launchql/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.
+- [@launchql/query](https://github.com/launchql/launchql/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
 
 ## Disclaimer
 
 AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
 
 No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.
-