@vodailoc/kilo-kit-mcp 1.1.0 → 1.2.0

package/skills/engineering/render-deploy/references/deployment-details.md

@@ -1,224 +1,224 @@
-# Deployment Details
-
-Use this reference for service discovery, configuration patterns, quick commands, and common issues.
-
-## Service Discovery
-
-**List all services:**
-```
-list_services()
-```
-Returns all services with IDs, names, types, and status.
-
-**Get specific service details:**
-```
-get_service(serviceId: "<id>")
-```
-Returns full configuration including environment variables and build/start commands.
-
-**List PostgreSQL databases:**
-```
-list_postgres_instances()
-```
-
-**List Key-Value stores:**
-```
-list_key_value()
-```
-
-## Configuration Details
-
-### Environment Variables
-
-**All environment variables must be declared in render.yaml.**
-
-**Three patterns for environment variables:**
-
-1. **Hardcoded values** (non-sensitive configuration):
-```yaml
-envVars:
-  - key: NODE_ENV
-    value: production
-  - key: API_URL
-    value: https://api.example.com
-```
-
-2. **Database connections** (auto-generated):
-```yaml
-envVars:
-  - key: DATABASE_URL
-    fromDatabase:
-      name: postgres
-      property: connectionString
-  - key: REDIS_URL
-    fromDatabase:
-      name: redis
-      property: connectionString
-```
-
-3. **Secrets** (user fills in Dashboard):
-```yaml
-envVars:
-  - key: JWT_SECRET
-    sync: false
-  - key: API_KEY
-    sync: false
-  - key: STRIPE_SECRET_KEY
-    sync: false
-```
-
-Complete environment variable guide: [configuration-guide.md](configuration-guide.md)
-
-### Port Binding
-
-**CRITICAL:** Web services must bind to `0.0.0.0:$PORT` (NOT `localhost`). Render sets the `PORT` environment variable.
-
-**Node.js Example:**
-```javascript
-const PORT = process.env.PORT || 3000;
-app.listen(PORT, '0.0.0.0', () => {
-  console.log(`Server running on port ${PORT}`);
-});
-```
-
-**Python Example:**
-```python
-import os
-
-port = int(os.environ.get('PORT', 5000))
-app.run(host='0.0.0.0', port=port)
-```
-
-**Go Example:**
-```go
-port := os.Getenv("PORT")
-if port == "" {
-    port = "3000"
-}
-http.ListenAndServe(":"+port, handler)
-```
-
-### Plan Defaults
-
-**Use `plan: free` unless the user specifies otherwise.** Refer to Render pricing for current limits and capacity.
-
-### Build Commands
-
-**Use non-interactive flags to prevent build hangs:**
-- npm: `npm ci`
-- yarn: `yarn install --frozen-lockfile`
-- pnpm: `pnpm install --frozen-lockfile`
-- bun: `bun install --frozen-lockfile`
-- pip: `pip install -r requirements.txt`
-- uv: `uv sync`
-- apt: `apt-get install -y <package>`
-- bundler: `bundle install --jobs=4 --retry=3`
-
-### Database Connections
-
-When services connect to databases in the same Render account, use `fromDatabase` references for internal URLs.
-
-### Health Checks
-
-Optional but recommended: add a `/health` endpoint for faster deployment detection.
-
-## Quick Reference
-
-### MCP Tools (Preferred)
-```
-# Service Discovery
-list_services()
-get_service(serviceId: "<id>")
-list_postgres_instances()
-list_key_value()
-
-# Service Creation
-create_web_service(name, runtime, buildCommand, startCommand, ...)
-create_static_site(name, buildCommand, publishPath, ...)
-create_cron_job(name, runtime, schedule, buildCommand, startCommand, ...)
-create_postgres(name, plan, region)
-create_key_value(name, plan, region)
-
-# Environment Variables
-update_environment_variables(serviceId, envVars: [{key, value}, ...])
-
-# Deployment & Monitoring
-list_deploys(serviceId, limit)
-list_logs(resource: ["<id>"], level: ["error"])
-get_metrics(resourceId, metricTypes: [...])
-
-# Workspace
-get_selected_workspace()
-list_workspaces()
-```
-
-### CLI Commands
-```bash
-# Validate Blueprint
-render blueprints validate
-
-# Check workspace
-render workspace current -o json
-render workspace set
-
-# List services
-render services -o json
-
-# View deployment logs
-render logs -r <service-id> -o json
-
-# Create deployment
-render deploys create <service-id> --wait
-```
-
-### Templates by Framework
-- Node.js Express: [../assets/node-express.yaml](../assets/node-express.yaml)
-- Next.js + Postgres: [../assets/nextjs-postgres.yaml](../assets/nextjs-postgres.yaml)
-- Django + Worker: [../assets/python-django.yaml](../assets/python-django.yaml)
-- Static Site: [../assets/static-site.yaml](../assets/static-site.yaml)
-- Go API: [../assets/go-api.yaml](../assets/go-api.yaml)
-- Docker: [../assets/docker.yaml](../assets/docker.yaml)
-
-### Documentation
-- Full Blueprint specification: [blueprint-spec.md](blueprint-spec.md)
-- Service types explained: [service-types.md](service-types.md)
-- Runtime options: [runtimes.md](runtimes.md)
-- Configuration guide: [configuration-guide.md](configuration-guide.md)
-
-## Common Issues
-
-**Issue:** Deployment fails with port binding error
-
-**Solution:** Ensure app binds to `0.0.0.0:$PORT` (see Port Binding section above)
-
----
-
-**Issue:** Build hangs or times out
-
-**Solution:** Use non-interactive build commands (see Build Commands section above)
-
----
-
-**Issue:** Missing environment variables in Dashboard
-
-**Solution:** All env vars must be declared in render.yaml. Add missing vars with `sync: false` for secrets.
-
----
-
-**Issue:** Database connection fails
-
-**Solution:** Use `fromDatabase` references for internal connection strings.
-
----
-
-**Issue:** Static site shows 404 for routes
-
-**Solution:** Add rewrite rules to render.yaml for SPA routing:
-```yaml
-routes:
-  - type: rewrite
-    source: /*
-    destination: /index.html
-```
-
-For more detailed troubleshooting, see the debug skill or [configuration-guide.md](configuration-guide.md).
+# Deployment Details
+
+Use this reference for service discovery, configuration patterns, quick commands, and common issues.
+
+## Service Discovery
+
+**List all services:**
+```
+list_services()
+```
+Returns all services with IDs, names, types, and status.
+
+**Get specific service details:**
+```
+get_service(serviceId: "<id>")
+```
+Returns full configuration including environment variables and build/start commands.
+
+**List PostgreSQL databases:**
+```
+list_postgres_instances()
+```
+
+**List Key-Value stores:**
+```
+list_key_value()
+```
+
+## Configuration Details
+
+### Environment Variables
+
+**All environment variables must be declared in render.yaml.**
+
+**Three patterns for environment variables:**
+
+1. **Hardcoded values** (non-sensitive configuration):
+```yaml
+envVars:
+  - key: NODE_ENV
+    value: production
+  - key: API_URL
+    value: https://api.example.com
+```
+
+2. **Database connections** (auto-generated):
+```yaml
+envVars:
+  - key: DATABASE_URL
+    fromDatabase:
+      name: postgres
+      property: connectionString
+  - key: REDIS_URL
+    fromDatabase:
+      name: redis
+      property: connectionString
+```
+
+3. **Secrets** (user fills in Dashboard):
+```yaml
+envVars:
+  - key: JWT_SECRET
+    sync: false
+  - key: API_KEY
+    sync: false
+  - key: STRIPE_SECRET_KEY
+    sync: false
+```
+
+Complete environment variable guide: [configuration-guide.md](configuration-guide.md)
+
+### Port Binding
+
+**CRITICAL:** Web services must bind to `0.0.0.0:$PORT` (NOT `localhost`). Render sets the `PORT` environment variable.
+
+**Node.js Example:**
+```javascript
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, '0.0.0.0', () => {
+  console.log(`Server running on port ${PORT}`);
+});
+```
+
+**Python Example:**
+```python
+import os
+
+port = int(os.environ.get('PORT', 5000))
+app.run(host='0.0.0.0', port=port)
+```
+
+**Go Example:**
+```go
+port := os.Getenv("PORT")
+if port == "" {
+    port = "3000"
+}
+http.ListenAndServe(":"+port, handler)
+```
+
+### Plan Defaults
+
+**Use `plan: free` unless the user specifies otherwise.** Refer to Render pricing for current limits and capacity.
+
+### Build Commands
+
+**Use non-interactive flags to prevent build hangs:**
+- npm: `npm ci`
+- yarn: `yarn install --frozen-lockfile`
+- pnpm: `pnpm install --frozen-lockfile`
+- bun: `bun install --frozen-lockfile`
+- pip: `pip install -r requirements.txt`
+- uv: `uv sync`
+- apt: `apt-get install -y <package>`
+- bundler: `bundle install --jobs=4 --retry=3`
+
+### Database Connections
+
+When services connect to databases in the same Render account, use `fromDatabase` references for internal URLs.
+
+### Health Checks
+
+Optional but recommended: add a `/health` endpoint for faster deployment detection.
+
+## Quick Reference
+
+### MCP Tools (Preferred)
+```
+# Service Discovery
+list_services()
+get_service(serviceId: "<id>")
+list_postgres_instances()
+list_key_value()
+
+# Service Creation
+create_web_service(name, runtime, buildCommand, startCommand, ...)
+create_static_site(name, buildCommand, publishPath, ...)
+create_cron_job(name, runtime, schedule, buildCommand, startCommand, ...)
+create_postgres(name, plan, region)
+create_key_value(name, plan, region)
+
+# Environment Variables
+update_environment_variables(serviceId, envVars: [{key, value}, ...])
+
+# Deployment & Monitoring
+list_deploys(serviceId, limit)
+list_logs(resource: ["<id>"], level: ["error"])
+get_metrics(resourceId, metricTypes: [...])
+
+# Workspace
+get_selected_workspace()
+list_workspaces()
+```
+
+### CLI Commands
+```bash
+# Validate Blueprint
+render blueprints validate
+
+# Check workspace
+render workspace current -o json
+render workspace set
+
+# List services
+render services -o json
+
+# View deployment logs
+render logs -r <service-id> -o json
+
+# Create deployment
+render deploys create <service-id> --wait
+```
+
+### Templates by Framework
+- Node.js Express: [../assets/node-express.yaml](../assets/node-express.yaml)
+- Next.js + Postgres: [../assets/nextjs-postgres.yaml](../assets/nextjs-postgres.yaml)
+- Django + Worker: [../assets/python-django.yaml](../assets/python-django.yaml)
+- Static Site: [../assets/static-site.yaml](../assets/static-site.yaml)
+- Go API: [../assets/go-api.yaml](../assets/go-api.yaml)
+- Docker: [../assets/docker.yaml](../assets/docker.yaml)
+
+### Documentation
+- Full Blueprint specification: [blueprint-spec.md](blueprint-spec.md)
+- Service types explained: [service-types.md](service-types.md)
+- Runtime options: [runtimes.md](runtimes.md)
+- Configuration guide: [configuration-guide.md](configuration-guide.md)
+
+## Common Issues
+
+**Issue:** Deployment fails with port binding error
+
+**Solution:** Ensure app binds to `0.0.0.0:$PORT` (see Port Binding section above)
+
+---
+
+**Issue:** Build hangs or times out
+
+**Solution:** Use non-interactive build commands (see Build Commands section above)
+
+---
+
+**Issue:** Missing environment variables in Dashboard
+
+**Solution:** All env vars must be declared in render.yaml. Add missing vars with `sync: false` for secrets.
+
+---
+
+**Issue:** Database connection fails
+
+**Solution:** Use `fromDatabase` references for internal connection strings.
+
+---
+
+**Issue:** Static site shows 404 for routes
+
+**Solution:** Add rewrite rules to render.yaml for SPA routing:
+```yaml
+routes:
+  - type: rewrite
+    source: /*
+    destination: /index.html
+```
+
+For more detailed troubleshooting, see the debug skill or [configuration-guide.md](configuration-guide.md).

package/skills/engineering/render-deploy/references/direct-creation.md

@@ -1,113 +1,113 @@
-# Direct Creation (MCP) Details
-
-Use this reference for MCP direct-creation examples and follow-on configuration.
-
-## Direct Creation Workflow
-
-### Step 1: Analyze Codebase
-
-Use [codebase-analysis.md](codebase-analysis.md) to determine runtime, build/start commands, env vars, and datastores.
-
-### Step 2: Create Resources via MCP
-
-**Create a Web Service:**
-```
-create_web_service(
-  name: "my-api",
-  runtime: "node",  # or python, go, rust, ruby, elixir, docker
-  repo: "https://github.com/username/repo",
-  branch: "main",  # optional, defaults to repo default branch
-  buildCommand: "npm ci",
-  startCommand: "npm start",
-  plan: "free",  # free, starter, standard, pro, pro_max, pro_plus, pro_ultra
-  region: "oregon",  # oregon, frankfurt, singapore, ohio, virginia
-  envVars: [
-    {"key": "NODE_ENV", "value": "production"}
-  ]
-)
-```
-
-**Create a Static Site:**
-```
-create_static_site(
-  name: "my-frontend",
-  repo: "https://github.com/username/repo",
-  branch: "main",
-  buildCommand: "npm run build",
-  publishPath: "dist",  # or build, public, out
-  envVars: [
-    {"key": "VITE_API_URL", "value": "https://api.example.com"}
-  ]
-)
-```
-
-**Create a Cron Job:**
-```
-create_cron_job(
-  name: "daily-cleanup",
-  runtime: "node",
-  repo: "https://github.com/username/repo",
-  schedule: "0 0 * * *",  # Daily at midnight (cron syntax)
-  buildCommand: "npm ci",
-  startCommand: "node scripts/cleanup.js",
-  plan: "free"
-)
-```
-
-**Create a PostgreSQL Database:**
-```
-create_postgres(
-  name: "myapp-db",
-  plan: "free",  # free, basic_256mb, basic_1gb, basic_4gb, pro_4gb, etc.
-  region: "oregon"
-)
-```
-
-**Create a Key-Value Store (Redis):**
-```
-create_key_value(
-  name: "myapp-cache",
-  plan: "free",  # free, starter, standard, pro, pro_plus
-  region: "oregon",
-  maxmemoryPolicy: "allkeys_lru"  # eviction policy
-)
-```
-
-### Step 3: Configure Environment Variables
-
-After creating services, add environment variables:
-
-```
-update_environment_variables(
-  serviceId: "<service-id-from-creation>",
-  envVars: [
-    {"key": "DATABASE_URL", "value": "<connection-string>"},
-    {"key": "JWT_SECRET", "value": "<secret-value>"},
-    {"key": "API_KEY", "value": "<api-key>"}
-  ]
-)
-```
-
-**Note:** For database connection strings, get the internal URL from the database details in Dashboard or via `get_postgres(postgresId: "<id>")`.
-
-### Step 4: Verify Deployment
-
-Services with `autoDeploy: "yes"` (default) will deploy automatically when created.
-
-**Check deployment status:**
-```
-list_deploys(serviceId: "<service-id>", limit: 1)
-```
-
-**Monitor logs for errors:**
-```
-list_logs(resource: ["<service-id>"], level: ["error"], limit: 50)
-```
-
-**Check health metrics:**
-```
-get_metrics(
-  resourceId: "<service-id>",
-  metricTypes: ["http_request_count", "cpu_usage", "memory_usage"]
-)
-```
+# Direct Creation (MCP) Details
+
+Use this reference for MCP direct-creation examples and follow-on configuration.
+
+## Direct Creation Workflow
+
+### Step 1: Analyze Codebase
+
+Use [codebase-analysis.md](codebase-analysis.md) to determine runtime, build/start commands, env vars, and datastores.
+
+### Step 2: Create Resources via MCP
+
+**Create a Web Service:**
+```
+create_web_service(
+  name: "my-api",
+  runtime: "node",  # or python, go, rust, ruby, elixir, docker
+  repo: "https://github.com/username/repo",
+  branch: "main",  # optional, defaults to repo default branch
+  buildCommand: "npm ci",
+  startCommand: "npm start",
+  plan: "free",  # free, starter, standard, pro, pro_max, pro_plus, pro_ultra
+  region: "oregon",  # oregon, frankfurt, singapore, ohio, virginia
+  envVars: [
+    {"key": "NODE_ENV", "value": "production"}
+  ]
+)
+```
+
+**Create a Static Site:**
+```
+create_static_site(
+  name: "my-frontend",
+  repo: "https://github.com/username/repo",
+  branch: "main",
+  buildCommand: "npm run build",
+  publishPath: "dist",  # or build, public, out
+  envVars: [
+    {"key": "VITE_API_URL", "value": "https://api.example.com"}
+  ]
+)
+```
+
+**Create a Cron Job:**
+```
+create_cron_job(
+  name: "daily-cleanup",
+  runtime: "node",
+  repo: "https://github.com/username/repo",
+  schedule: "0 0 * * *",  # Daily at midnight (cron syntax)
+  buildCommand: "npm ci",
+  startCommand: "node scripts/cleanup.js",
+  plan: "free"
+)
+```
+
+**Create a PostgreSQL Database:**
+```
+create_postgres(
+  name: "myapp-db",
+  plan: "free",  # free, basic_256mb, basic_1gb, basic_4gb, pro_4gb, etc.
+  region: "oregon"
+)
+```
+
+**Create a Key-Value Store (Redis):**
+```
+create_key_value(
+  name: "myapp-cache",
+  plan: "free",  # free, starter, standard, pro, pro_plus
+  region: "oregon",
+  maxmemoryPolicy: "allkeys_lru"  # eviction policy
+)
+```
+
+### Step 3: Configure Environment Variables
+
+After creating services, add environment variables:
+
+```
+update_environment_variables(
+  serviceId: "<service-id-from-creation>",
+  envVars: [
+    {"key": "DATABASE_URL", "value": "<connection-string>"},
+    {"key": "JWT_SECRET", "value": "<secret-value>"},
+    {"key": "API_KEY", "value": "<api-key>"}
+  ]
+)
+```
+
+**Note:** For database connection strings, get the internal URL from the database details in Dashboard or via `get_postgres(postgresId: "<id>")`.
+
+### Step 4: Verify Deployment
+
+Services with `autoDeploy: "yes"` (default) will deploy automatically when created.
+
+**Check deployment status:**
+```
+list_deploys(serviceId: "<service-id>", limit: 1)
+```
+
+**Monitor logs for errors:**
+```
+list_logs(resource: ["<service-id>"], level: ["error"], limit: 50)
+```
+
+**Check health metrics:**
+```
+get_metrics(
+  resourceId: "<service-id>",
+  metricTypes: ["http_request_count", "cpu_usage", "memory_usage"]
+)
+```