packwise-skills 1.0.0 → 1.2.0

package/sub-skills/backend/node-server.md

@@ -1,164 +1,164 @@
-# Node.js Backend Build Sub-Skill
-
-Build Node.js backend services (Express/NestJS/Fastify/Koa/Hono).
-
-**Current version**: Node.js 26 LTS / 22 LTS (2025-2026)
-
-> ⚠️ **Breaking changes since Node 22**: v23 enables `require(esm)` by default. v26 removes `http.writeHeader()` (use `writeHead()`), removes legacy `_stream_*` modules, enables Temporal API, upgrades V8 to 14.6 and Undici to 8.0. Native modules compiled for Node 22 need recompilation for Node 26.
-
-## When to Use
-
-- REST API / GraphQL API service
-- WebSocket service
-- Microservice / API gateway
-- Full-stack application backend
-- Serverless functions
-
-## Framework Quick Start
-
-### Express (Most Popular)
-
-```javascript
-const express = require('express');
-const app = express();
-app.use(express.json());
-app.get('/health', (req, res) => res.json({ status: 'ok' }));
-app.listen(3000);
-```
-
-### Fastify (High Performance)
-
-```javascript
-import Fastify from 'fastify';
-const app = Fastify({ logger: true });
-app.get('/health', async () => ({ status: 'ok' }));
-await app.listen({ port: 3000 });
-```
-
-### NestJS (Enterprise, TypeScript-first)
-
-```bash
-npm i -g @nestjs/cli
-nest new my-app
-npm run build    # outputs to dist/
-npm run start:prod
-```
-
-### Hono (Edge-first, ultra-lightweight)
-
-```javascript
-import { Hono } from 'hono';
-const app = new Hono();
-app.get('/health', (c) => c.json({ status: 'ok' }));
-export default app;
-```
-
-### Framework Comparison
-
-| Framework | Performance | TypeScript | Ecosystem | Best For |
-|-----------|------------|-----------|-----------|----------|
-| Express | Good | Optional | Largest | General purpose, tutorials |
-| Fastify | High | First-class | Large | Performance-critical APIs |
-| NestJS | Good | Required (default) | Large | Enterprise, complex architecture |
-| Koa | Good | Optional | Moderate | Minimalist Express alternative |
-| Hono | Highest | First-class | Growing | Edge runtime, serverless |
-
-## Build
-
-```bash
-# Express/Fastify/Koa/Hono: run directly (no build step for JS)
-node dist/server.js
-
-# TypeScript projects
-npx tsc                    # Compile TypeScript to JS
-# or esbuild (faster)
-npx esbuild src/index.ts --bundle --platform=node --format=cjs --outfile=dist/server.cjs
-# or tsx (run TypeScript directly, development)
-npx tsx src/index.ts
-
-# NestJS: requires compilation
-npm run build  # outputs to dist/
-
-# Bun runtime (alternative to Node.js, faster)
-bun run src/index.ts
-```
-
-## Docker
-
-```dockerfile
-FROM node:22-alpine AS builder
-WORKDIR /app
-COPY package*.json ./
-RUN npm ci
-COPY . .
-RUN npm run build
-
-FROM node:22-alpine
-WORKDIR /app
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/node_modules ./node_modules
-COPY --from=builder /app/package.json ./
-RUN apk add --no-cache tini && \
-    addgroup -S appgroup && adduser -S appuser -G appgroup && \
-    chown -R appuser:appgroup /app
-USER appuser
-EXPOSE 3000
-HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:3000/health || exit 1
-ENTRYPOINT ["/sbin/tini", "--"]
-CMD ["node", "dist/server.js"]
-```
-
-## PM2 Process Manager
-
-```bash
-npm install -g pm2
-pm2 start dist/server.js --name myapp -i max   # Cluster mode (all CPU cores)
-pm2 start dist/server.js --name myapp -i 4     # 4 instances
-pm2 save && pm2 startup                         # Auto-start on reboot
-pm2 logs myapp                                  # View logs
-pm2 monit                                       # Monitoring dashboard
-pm2 reload myapp                                # Zero-downtime restart
-```
-
-## Environment Variables
-
-```javascript
-// Use dotenv for development
-require('dotenv').config();
-
-// Access: process.env.DATABASE_URL, process.env.PORT, etc.
-// NEVER commit .env files to git
-```
-
-```bash
-# Local: .env file (add to .gitignore)
-# Production: platform env vars or secrets manager
-# Type-safe env: use @t3-oss/env-nextjs or zod
-```
-
-## Cloud Platforms
-
-| Platform | Method | Cost | Best For |
-|----------|--------|------|---------|
-| Railway | Git push auto-deploy | Free/pay-as-you-go | Quick deploy |
-| Render | Git push auto-deploy | Free/pay-as-you-go | Quick deploy |
-| Fly.io | Docker deploy | Free/pay-as-you-go | Global edge |
-| Vercel | Serverless Functions | Free/pay-as-you-go | Next.js, API routes |
-| AWS EC2 | PM2/Docker | Per instance | Full control |
-| Aliyun ECS | PM2/Docker | Per instance | China access |
-| Deno Deploy | Git push | Free tier | Hono, edge functions |
-| Bun.sh | `bun run` | Free tier | Ultra-fast startup |
-
-## Common Pitfalls
-
-| Issue | Fix |
-|-------|-----|
-| Port in use | `lsof -i :3000` to check; use `kill -9 <PID>` |
-| Memory leak | PM2: `--max-memory-restart 500M`; check for event listener leaks |
-| Process crash loop | Check logs: `pm2 logs`; add error handling middleware |
-| CORS error | `app.use(cors())` with Express; configure allowed origins |
-| HTTPS in production | Nginx reverse proxy + Let's Encrypt (see cloud/docker.md) |
-| `MODULE_NOT_FOUND` | Check `node_modules`; run `npm ci` (not `npm install` in production) |
-| TypeScript path aliases not working | Use `tsc-alias` or `tsconfig-paths` after build |
-| Async error not caught | Use `express-async-errors` or wrap in try/catch |
-| Bun compatibility | Some npm packages don't support Bun; test thoroughly |
+# Node.js Backend Build Sub-Skill
+
+Build Node.js backend services (Express/NestJS/Fastify/Koa/Hono).
+
+**Current version**: Node.js 26 LTS / 22 LTS (2025-2026)
+
+> ⚠️ **Breaking changes since Node 22**: v23 enables `require(esm)` by default. v26 removes `http.writeHeader()` (use `writeHead()`), removes legacy `_stream_*` modules, enables Temporal API, upgrades V8 to 14.6 and Undici to 8.0. Native modules compiled for Node 22 need recompilation for Node 26.
+
+## When to Use
+
+- REST API / GraphQL API service
+- WebSocket service
+- Microservice / API gateway
+- Full-stack application backend
+- Serverless functions
+
+## Framework Quick Start
+
+### Express (Most Popular)
+
+```javascript
+const express = require('express');
+const app = express();
+app.use(express.json());
+app.get('/health', (req, res) => res.json({ status: 'ok' }));
+app.listen(3000);
+```
+
+### Fastify (High Performance)
+
+```javascript
+import Fastify from 'fastify';
+const app = Fastify({ logger: true });
+app.get('/health', async () => ({ status: 'ok' }));
+await app.listen({ port: 3000 });
+```
+
+### NestJS (Enterprise, TypeScript-first)
+
+```bash
+npm i -g @nestjs/cli
+nest new my-app
+npm run build    # outputs to dist/
+npm run start:prod
+```
+
+### Hono (Edge-first, ultra-lightweight)
+
+```javascript
+import { Hono } from 'hono';
+const app = new Hono();
+app.get('/health', (c) => c.json({ status: 'ok' }));
+export default app;
+```
+
+### Framework Comparison
+
+| Framework | Performance | TypeScript | Ecosystem | Best For |
+|-----------|------------|-----------|-----------|----------|
+| Express | Good | Optional | Largest | General purpose, tutorials |
+| Fastify | High | First-class | Large | Performance-critical APIs |
+| NestJS | Good | Required (default) | Large | Enterprise, complex architecture |
+| Koa | Good | Optional | Moderate | Minimalist Express alternative |
+| Hono | Highest | First-class | Growing | Edge runtime, serverless |
+
+## Build
+
+```bash
+# Express/Fastify/Koa/Hono: run directly (no build step for JS)
+node dist/server.js
+
+# TypeScript projects
+npx tsc                    # Compile TypeScript to JS
+# or esbuild (faster)
+npx esbuild src/index.ts --bundle --platform=node --format=cjs --outfile=dist/server.cjs
+# or tsx (run TypeScript directly, development)
+npx tsx src/index.ts
+
+# NestJS: requires compilation
+npm run build  # outputs to dist/
+
+# Bun runtime (alternative to Node.js, faster)
+bun run src/index.ts
+```
+
+## Docker
+
+```dockerfile
+FROM node:22-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:22-alpine
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+RUN apk add --no-cache tini && \
+    addgroup -S appgroup && adduser -S appuser -G appgroup && \
+    chown -R appuser:appgroup /app
+USER appuser
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:3000/health || exit 1
+ENTRYPOINT ["/sbin/tini", "--"]
+CMD ["node", "dist/server.js"]
+```
+
+## PM2 Process Manager
+
+```bash
+npm install -g pm2
+pm2 start dist/server.js --name myapp -i max   # Cluster mode (all CPU cores)
+pm2 start dist/server.js --name myapp -i 4     # 4 instances
+pm2 save && pm2 startup                         # Auto-start on reboot
+pm2 logs myapp                                  # View logs
+pm2 monit                                       # Monitoring dashboard
+pm2 reload myapp                                # Zero-downtime restart
+```
+
+## Environment Variables
+
+```javascript
+// Use dotenv for development
+require('dotenv').config();
+
+// Access: process.env.DATABASE_URL, process.env.PORT, etc.
+// NEVER commit .env files to git
+```
+
+```bash
+# Local: .env file (add to .gitignore)
+# Production: platform env vars or secrets manager
+# Type-safe env: use @t3-oss/env-nextjs or zod
+```
+
+## Cloud Platforms
+
+| Platform | Method | Cost | Best For |
+|----------|--------|------|---------|
+| Railway | Git push auto-deploy | Free/pay-as-you-go | Quick deploy |
+| Render | Git push auto-deploy | Free/pay-as-you-go | Quick deploy |
+| Fly.io | Docker deploy | Free/pay-as-you-go | Global edge |
+| Vercel | Serverless Functions | Free/pay-as-you-go | Next.js, API routes |
+| AWS EC2 | PM2/Docker | Per instance | Full control |
+| Aliyun ECS | PM2/Docker | Per instance | China access |
+| Deno Deploy | Git push | Free tier | Hono, edge functions |
+| Bun.sh | `bun run` | Free tier | Ultra-fast startup |
+
+## Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| Port in use | `lsof -i :3000` to check; use `kill -9 <PID>` |
+| Memory leak | PM2: `--max-memory-restart 500M`; check for event listener leaks |
+| Process crash loop | Check logs: `pm2 logs`; add error handling middleware |
+| CORS error | `app.use(cors())` with Express; configure allowed origins |
+| HTTPS in production | Nginx reverse proxy + Let's Encrypt (see cloud/docker.md) |
+| `MODULE_NOT_FOUND` | Check `node_modules`; run `npm ci` (not `npm install` in production) |
+| TypeScript path aliases not working | Use `tsc-alias` or `tsconfig-paths` after build |
+| Async error not caught | Use `express-async-errors` or wrap in try/catch |
+| Bun compatibility | Some npm packages don't support Bun; test thoroughly |

package/sub-skills/backend/php-laravel.md

@@ -1,175 +1,175 @@
-# PHP Backend Build Sub-Skill
-
-Build and package PHP backend services (Laravel / Symfony / Slim).
-
-**Current version**: PHP 8.3 / 8.4 / Laravel 11.x / Symfony 7.x (2025-2026)
-
-## When to Use
-
-- Content management systems (WordPress plugins, custom CMS)
-- REST APIs / GraphQL APIs
-- Web applications with server-side rendering
-- Team has PHP experience
-- Shared hosting deployment
-
-## Laravel Build
-
-### Build & Package
-
-```bash
-# Install dependencies
-composer install --no-dev --optimize-autoloader
-
-# Cache configuration (production)
-php artisan config:cache
-php artisan route:cache
-php artisan view:cache
-php artisan event:cache
-
-# Build frontend assets
-npm ci && npm run build
-
-# Create distributable archive
-tar -czf myapp.tar.gz \
-    --exclude='.env' \
-    --exclude='node_modules' \
-    --exclude='tests' \
-    --exclude='.git' \
-    .
-```
-
-### Docker
-
-```dockerfile
-FROM php:8.3-fpm AS builder
-WORKDIR /app
-COPY composer.json composer.lock ./
-RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer && \
-    composer install --no-dev --optimize-autoloader --no-scripts
-COPY . .
-RUN php artisan config:cache && php artisan route:cache && php artisan view:cache
-
-FROM php:8.3-fpm
-WORKDIR /app
-COPY --from=builder /app /app
-RUN groupadd -r appuser && useradd -r -g appuser appuser && \
-    chown -R appuser:appuser /app/storage /app/bootstrap/cache
-USER appuser
-EXPOSE 9000
-HEALTHCHECK --interval=30s --timeout=3s CMD php artisan --version || exit 1
-CMD ["php-fpm"]
-```
-
-### Nginx + PHP-FPM
-
-```nginx
-server {
-    listen 80;
-    server_name example.com;
-    root /app/public;
-    index index.php;
-
-    location / {
-        try_files $uri $uri/ /index.php?$query_string;
-    }
-
-    location ~ \.php$ {
-        fastcgi_pass app:9000;
-        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
-        include fastcgi_params;
-    }
-}
-```
-
-### Shared Hosting Deployment
-
-```bash
-# 1. Run `composer install --no-dev` locally
-# 2. Upload via FTP/SFTP:
-#    - All files EXCEPT: .env.example, .git, node_modules, tests
-# 3. Set document root to `public/` directory
-# 4. Copy .env.example → .env and configure
-# 5. Run: php artisan key:generate
-# 6. Set permissions: chmod -R 775 storage bootstrap/cache
-```
-
-### Laravel Forge / Vapor / Ploi
-
-| Platform | Type | Best For |
-|----------|------|---------|
-| Laravel Forge | VPS management | Full control, traditional hosting |
-| Laravel Vapor | Serverless (AWS Lambda) | Auto-scaling, pay-per-request |
-| Ploi | VPS management | Alternative to Forge |
-
-## Symfony Build
-
-```bash
-# Install dependencies
-composer install --no-dev --optimize-autoloader
-
-# Warm up cache
-php bin/console cache:warmup --env=prod
-
-# Build frontend (if using Encore)
-npm ci && npm run build
-
-# Docker
-docker build -t myapp .
-```
-
-```dockerfile
-FROM php:8.3-fpm AS builder
-WORKDIR /app
-COPY composer.json composer.lock ./
-RUN composer install --no-dev --optimize-autoloader
-COPY . .
-RUN php bin/console cache:warmup --env=prod
-
-FROM php:8.3-fpm
-WORKDIR /app
-COPY --from=builder /app /app
-USER www-data
-EXPOSE 9000
-```
-
-## Slim / Lumen (Micro-frameworks)
-
-```php
-// Slim 4 — minimal API
-use Slim\Factory\AppFactory;
-
-$app = AppFactory::create();
-$app->get('/health', function ($request, $response) {
-    $response->getBody()->write('OK');
-    return $response;
-});
-$app->run();
-```
-
-```bash
-# Build
-composer install --no-dev
-php -S 0.0.0.0:8080 -t public public/index.php
-```
-
-## PHP Distribution Channels
-
-| Channel | Method | Best For |
-|---------|--------|---------|
-| Composer Packagist | `composer publish` | Libraries / packages |
-| Docker Hub | `docker push` | Containerized apps |
-| Shared hosting | FTP/SFTP upload | WordPress, small sites |
-| VPS | `git pull` + `composer install` | Full control |
-| Serverless (Bref) | `vendor/bin/bref deploy` | AWS Lambda |
-
-## Common Pitfalls
-
-| Issue | Fix |
-|-------|-----|
-| `composer install` fails in prod | Use `--no-dev`; check PHP version compatibility |
-| 500 error after deploy | Check `.env` config; run `php artisan config:clear` |
-| Storage permissions | `chmod -R 775 storage bootstrap/cache`; set correct owner |
-| OPcache not working | Enable `opcache.enable=1` in php.ini; restart PHP-FPM |
-| Memory limit exceeded | Increase `memory_limit` in php.ini (default 128M, use 256M+) |
-| Asset mix not compiling | Run `npm ci && npm run build`; check `webpack.mix.js` / `vite.config.js` |
-| Shared hosting: `artisan` not available | Use `php artisan` with full path; some hosts restrict CLI |
+# PHP Backend Build Sub-Skill
+
+Build and package PHP backend services (Laravel / Symfony / Slim).
+
+**Current version**: PHP 8.3 / 8.4 / Laravel 11.x / Symfony 7.x (2025-2026)
+
+## When to Use
+
+- Content management systems (WordPress plugins, custom CMS)
+- REST APIs / GraphQL APIs
+- Web applications with server-side rendering
+- Team has PHP experience
+- Shared hosting deployment
+
+## Laravel Build
+
+### Build & Package
+
+```bash
+# Install dependencies
+composer install --no-dev --optimize-autoloader
+
+# Cache configuration (production)
+php artisan config:cache
+php artisan route:cache
+php artisan view:cache
+php artisan event:cache
+
+# Build frontend assets
+npm ci && npm run build
+
+# Create distributable archive
+tar -czf myapp.tar.gz \
+    --exclude='.env' \
+    --exclude='node_modules' \
+    --exclude='tests' \
+    --exclude='.git' \
+    .
+```
+
+### Docker
+
+```dockerfile
+FROM php:8.3-fpm AS builder
+WORKDIR /app
+COPY composer.json composer.lock ./
+RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer && \
+    composer install --no-dev --optimize-autoloader --no-scripts
+COPY . .
+RUN php artisan config:cache && php artisan route:cache && php artisan view:cache
+
+FROM php:8.3-fpm
+WORKDIR /app
+COPY --from=builder /app /app
+RUN groupadd -r appuser && useradd -r -g appuser appuser && \
+    chown -R appuser:appuser /app/storage /app/bootstrap/cache
+USER appuser
+EXPOSE 9000
+HEALTHCHECK --interval=30s --timeout=3s CMD php artisan --version || exit 1
+CMD ["php-fpm"]
+```
+
+### Nginx + PHP-FPM
+
+```nginx
+server {
+    listen 80;
+    server_name example.com;
+    root /app/public;
+    index index.php;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        fastcgi_pass app:9000;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        include fastcgi_params;
+    }
+}
+```
+
+### Shared Hosting Deployment
+
+```bash
+# 1. Run `composer install --no-dev` locally
+# 2. Upload via FTP/SFTP:
+#    - All files EXCEPT: .env.example, .git, node_modules, tests
+# 3. Set document root to `public/` directory
+# 4. Copy .env.example → .env and configure
+# 5. Run: php artisan key:generate
+# 6. Set permissions: chmod -R 775 storage bootstrap/cache
+```
+
+### Laravel Forge / Vapor / Ploi
+
+| Platform | Type | Best For |
+|----------|------|---------|
+| Laravel Forge | VPS management | Full control, traditional hosting |
+| Laravel Vapor | Serverless (AWS Lambda) | Auto-scaling, pay-per-request |
+| Ploi | VPS management | Alternative to Forge |
+
+## Symfony Build
+
+```bash
+# Install dependencies
+composer install --no-dev --optimize-autoloader
+
+# Warm up cache
+php bin/console cache:warmup --env=prod
+
+# Build frontend (if using Encore)
+npm ci && npm run build
+
+# Docker
+docker build -t myapp .
+```
+
+```dockerfile
+FROM php:8.3-fpm AS builder
+WORKDIR /app
+COPY composer.json composer.lock ./
+RUN composer install --no-dev --optimize-autoloader
+COPY . .
+RUN php bin/console cache:warmup --env=prod
+
+FROM php:8.3-fpm
+WORKDIR /app
+COPY --from=builder /app /app
+USER www-data
+EXPOSE 9000
+```
+
+## Slim / Lumen (Micro-frameworks)
+
+```php
+// Slim 4 — minimal API
+use Slim\Factory\AppFactory;
+
+$app = AppFactory::create();
+$app->get('/health', function ($request, $response) {
+    $response->getBody()->write('OK');
+    return $response;
+});
+$app->run();
+```
+
+```bash
+# Build
+composer install --no-dev
+php -S 0.0.0.0:8080 -t public public/index.php
+```
+
+## PHP Distribution Channels
+
+| Channel | Method | Best For |
+|---------|--------|---------|
+| Composer Packagist | `composer publish` | Libraries / packages |
+| Docker Hub | `docker push` | Containerized apps |
+| Shared hosting | FTP/SFTP upload | WordPress, small sites |
+| VPS | `git pull` + `composer install` | Full control |
+| Serverless (Bref) | `vendor/bin/bref deploy` | AWS Lambda |
+
+## Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| `composer install` fails in prod | Use `--no-dev`; check PHP version compatibility |
+| 500 error after deploy | Check `.env` config; run `php artisan config:clear` |
+| Storage permissions | `chmod -R 775 storage bootstrap/cache`; set correct owner |
+| OPcache not working | Enable `opcache.enable=1` in php.ini; restart PHP-FPM |
+| Memory limit exceeded | Increase `memory_limit` in php.ini (default 128M, use 256M+) |
+| Asset mix not compiling | Run `npm ci && npm run build`; check `webpack.mix.js` / `vite.config.js` |
+| Shared hosting: `artisan` not available | Use `php artisan` with full path; some hosts restrict CLI |