@sibyllinesoft/arbiter 0.1.0

package/dist/templates/plopfiles/_modules/infra/github-actions/templates/.github/workflows/ci.yml.hbs

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Lint
+        run: bun run lint
+        continue-on-error: true
+
+      - name: Type check
+        run: bun run typecheck
+        continue-on-error: true
+
+      - name: Test
+        run: bun test
+        continue-on-error: true
+
+{{#if backend}}
+{{#unless (eq backend "none")}}
+  build-backend:
+    runs-on: ubuntu-latest
+    needs: lint-and-test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build backend
+        run: bun run build:backend
+{{/unless}}
+{{/if}}
+
+{{#if frontend}}
+{{#unless (eq frontend "none")}}
+  build-frontend:
+    runs-on: ubuntu-latest
+    needs: lint-and-test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build frontend
+        run: bun run build:frontend
+{{/unless}}
+{{/if}}

package/dist/templates/plopfiles/_modules/infra/github-actions/templates/.github/workflows/deploy.yml.hbs

@@ -0,0 +1,60 @@
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=sha,prefix=
+
+{{#if backend}}
+{{#unless (eq backend "none")}}
+      - name: Build and push backend
+        uses: docker/build-push-action@v5
+        with:
+          context: ./{{backendDir}}
+          push: true
+          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}-backend:${{ steps.meta.outputs.version }}
+          target: production
+{{/unless}}
+{{/if}}
+
+{{#if frontend}}
+{{#unless (eq frontend "none")}}
+      - name: Build and push frontend
+        uses: docker/build-push-action@v5
+        with:
+          context: ./{{frontendDir}}
+          push: true
+          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}-frontend:${{ steps.meta.outputs.version }}
+          target: production
+{{/unless}}
+{{/if}}

package/dist/templates/plopfiles/_modules/infra/just/module.js

@@ -0,0 +1,26 @@
+/**
+ * Just Command Runner Module
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "add",
+      path: "{{projectDir}}/justfile",
+      templateFile: `${templatesDir}/justfile.hbs`,
+      data,
+    },
+  ];
+}
+
+export const description = "Just command runner recipes";
+
+export const scripts = {
+  just: "just",
+};

package/dist/templates/plopfiles/_modules/infra/just/templates/justfile.hbs

@@ -0,0 +1,205 @@
+# {{titleCase name}} - Project Commands
+# Run `just` to see available recipes
+
+set dotenv-load
+
+# Default recipe: show help
+default:
+    @just --list
+
+# Development
+# -----------
+
+# Start development server
+dev:
+{{#if (eq backend "node-hono")}}
+    bun run --watch {{backendDir}}/src/index.ts
+{{else if (eq backend "node-express")}}
+    bun run --watch {{backendDir}}/src/index.ts
+{{else if (eq backend "python-fastapi")}}
+    cd {{backendDir}} && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+{{else if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo watch -x run
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && air
+{{else if (eq backend "kotlin-ktor")}}
+    cd {{backendDir}} && ./gradlew run --continuous
+{{else}}
+    @echo "Starting development server..."
+    bun run dev
+{{/if}}
+
+# Run tests
+test *args:
+{{#if (eq backend "python-fastapi")}}
+    cd {{backendDir}} && pytest {{{{raw}}}}{{args}}{{{{/raw}}}}
+{{else if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo test {{{{raw}}}}{{args}}{{{{/raw}}}}
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && go test ./... {{{{raw}}}}{{args}}{{{{/raw}}}}
+{{else if (eq backend "kotlin-ktor")}}
+    cd {{backendDir}} && ./gradlew test {{{{raw}}}}{{args}}{{{{/raw}}}}
+{{else}}
+    bun test {{{{raw}}}}{{args}}{{{{/raw}}}}
+{{/if}}
+
+# Run linter
+lint:
+{{#if (eq backend "python-fastapi")}}
+    cd {{backendDir}} && ruff check . && ruff format --check .
+{{else if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo clippy -- -D warnings
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && golangci-lint run
+{{else}}
+    bun run lint
+{{/if}}
+
+# Format code
+fmt:
+{{#if (eq backend "python-fastapi")}}
+    cd {{backendDir}} && ruff format .
+{{else if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo fmt
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && gofmt -w .
+{{else}}
+    bun run format
+{{/if}}
+
+# Build
+# -----
+
+# Build for production
+build:
+{{#if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo build --release
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && go build -o bin/server ./cmd/server
+{{else if (eq backend "kotlin-ktor")}}
+    cd {{backendDir}} && ./gradlew build
+{{else}}
+    bun run build
+{{/if}}
+
+# Clean build artifacts
+clean:
+{{#if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo clean
+{{else if (eq backend "go-chi")}}
+    rm -rf {{backendDir}}/bin
+{{else if (eq backend "kotlin-ktor")}}
+    cd {{backendDir}} && ./gradlew clean
+{{else}}
+    rm -rf dist node_modules/.cache
+{{/if}}
+
+# Docker
+# ------
+
+# Start all services with docker-compose
+up *args:
+    docker compose up -d {{{{raw}}}}{{args}}{{{{/raw}}}}
+
+# Stop all services
+down:
+    docker compose down
+
+# View logs
+logs *service:
+    docker compose logs -f {{{{raw}}}}{{service}}{{{{/raw}}}}
+
+# Rebuild and restart containers
+rebuild *service:
+    docker compose up -d --build {{{{raw}}}}{{service}}{{{{/raw}}}}
+
+{{#if database}}
+# Database
+# --------
+
+# Run database migrations
+db-migrate:
+{{#if (eq database "postgres-drizzle")}}
+    bun run drizzle-kit push
+{{else}}
+    @echo "Run database migrations"
+{{/if}}
+
+# Generate migration from schema changes
+db-generate:
+{{#if (eq database "postgres-drizzle")}}
+    bun run drizzle-kit generate
+{{else}}
+    @echo "Generate database migration"
+{{/if}}
+
+# Open database studio/UI
+db-studio:
+{{#if (eq database "postgres-drizzle")}}
+    bun run drizzle-kit studio
+{{else}}
+    @echo "Open database UI"
+{{/if}}
+
+# Reset database (drop and recreate)
+db-reset:
+    docker compose down -v
+    docker compose up -d db
+    @echo "Waiting for database to be ready..."
+    sleep 3
+    just db-migrate
+{{/if}}
+
+{{#if (has infra "kubernetes")}}
+# Kubernetes
+# ----------
+
+# Apply kubernetes manifests (dev)
+k8s-apply:
+    kubectl apply -k k8s/overlays/dev
+
+# Delete kubernetes resources (dev)
+k8s-delete:
+    kubectl delete -k k8s/overlays/dev
+
+# View pod logs
+k8s-logs:
+    kubectl logs -l app={{kebabCase name}} -f
+
+# Get pod status
+k8s-status:
+    kubectl get pods -l app={{kebabCase name}}
+{{/if}}
+
+# Utilities
+# ---------
+
+# Install dependencies
+install:
+{{#if (eq backend "python-fastapi")}}
+    cd {{backendDir}} && pip install -r requirements.txt -r requirements-dev.txt
+{{else if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo fetch
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && go mod download
+{{else if (eq backend "kotlin-ktor")}}
+    cd {{backendDir}} && ./gradlew dependencies
+{{else}}
+    bun install
+{{/if}}
+
+# Check for outdated dependencies
+outdated:
+{{#if (eq backend "python-fastapi")}}
+    cd {{backendDir}} && pip list --outdated
+{{else if (eq backend "rust-axum")}}
+    cd {{backendDir}} && cargo outdated
+{{else if (eq backend "go-chi")}}
+    cd {{backendDir}} && go list -u -m all
+{{else}}
+    bun outdated
+{{/if}}
+
+# Run a shell in the backend container
+shell:
+    docker compose exec backend sh

package/dist/templates/plopfiles/_modules/infra/kubernetes/module.js

@@ -0,0 +1,30 @@
+/**
+ * Kubernetes Infrastructure Module
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "addMany",
+      destination: "{{projectDir}}",
+      base: templatesDir,
+      templateFiles: `${templatesDir}/**/*.hbs`,
+      stripExtensions: ["hbs"],
+      data,
+    },
+  ];
+}
+
+export const description = "Kubernetes deployment manifests";
+
+export const scripts = {
+  "k8s:apply": "kubectl apply -k k8s/overlays/dev",
+  "k8s:delete": "kubectl delete -k k8s/overlays/dev",
+  "k8s:logs": "kubectl logs -l app={{kebabCase name}} -f",
+};

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/base/deployment.yaml.hbs

@@ -0,0 +1,48 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{kebabCase name}}
+  labels:
+    app: {{kebabCase name}}
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: {{kebabCase name}}
+  template:
+    metadata:
+      labels:
+        app: {{kebabCase name}}
+    spec:
+      containers:
+        - name: {{kebabCase name}}
+          image: {{kebabCase name}}:latest
+          ports:
+            - containerPort: 3000
+          env:
+            - name: NODE_ENV
+              value: "production"
+            - name: PORT
+              value: "3000"
+          envFrom:
+            - secretRef:
+                name: {{kebabCase name}}-secrets
+          resources:
+            requests:
+              memory: "128Mi"
+              cpu: "100m"
+            limits:
+              memory: "256Mi"
+              cpu: "500m"
+          livenessProbe:
+            httpGet:
+              path: /health/live
+              port: 3000
+            initialDelaySeconds: 10
+            periodSeconds: 10
+          readinessProbe:
+            httpGet:
+              path: /health/ready
+              port: 3000
+            initialDelaySeconds: 5
+            periodSeconds: 5

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/base/ingress.yaml.hbs

@@ -0,0 +1,23 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{kebabCase name}}
+  annotations:
+    kubernetes.io/ingress.class: nginx
+    cert-manager.io/cluster-issuer: letsencrypt-prod
+spec:
+  tls:
+    - hosts:
+        - {{kebabCase name}}.example.com
+      secretName: {{kebabCase name}}-tls
+  rules:
+    - host: {{kebabCase name}}.example.com
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: {{kebabCase name}}
+                port:
+                  number: 80

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/base/kustomization.yaml.hbs

@@ -0,0 +1,11 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources:
+  - deployment.yaml
+  - service.yaml
+  - ingress.yaml
+
+commonLabels:
+  app.kubernetes.io/name: {{kebabCase name}}
+  app.kubernetes.io/managed-by: kustomize

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/base/service.yaml.hbs

@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{kebabCase name}}
+  labels:
+    app: {{kebabCase name}}
+spec:
+  type: ClusterIP
+  ports:
+    - port: 80
+      targetPort: 3000
+      protocol: TCP
+      name: http
+  selector:
+    app: {{kebabCase name}}

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/overlays/dev/deployment-patch.yaml.hbs

@@ -0,0 +1,17 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{kebabCase name}}
+spec:
+  replicas: 1
+  template:
+    spec:
+      containers:
+        - name: {{kebabCase name}}
+          resources:
+            requests:
+              memory: "64Mi"
+              cpu: "50m"
+            limits:
+              memory: "128Mi"
+              cpu: "200m"

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/overlays/dev/kustomization.yaml.hbs

@@ -0,0 +1,15 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+namespace: {{kebabCase name}}-dev
+
+resources:
+  - ../../base
+
+patches:
+  - path: deployment-patch.yaml
+
+configMapGenerator:
+  - name: {{kebabCase name}}-config
+    literals:
+      - NODE_ENV=development

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/overlays/prod/deployment-patch.yaml.hbs

@@ -0,0 +1,17 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{kebabCase name}}
+spec:
+  replicas: 3
+  template:
+    spec:
+      containers:
+        - name: {{kebabCase name}}
+          resources:
+            requests:
+              memory: "256Mi"
+              cpu: "200m"
+            limits:
+              memory: "512Mi"
+              cpu: "1000m"

package/dist/templates/plopfiles/_modules/infra/kubernetes/templates/k8s/overlays/prod/kustomization.yaml.hbs

@@ -0,0 +1,15 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+namespace: {{kebabCase name}}-prod
+
+resources:
+  - ../../base
+
+patches:
+  - path: deployment-patch.yaml
+
+configMapGenerator:
+  - name: {{kebabCase name}}-config
+    literals:
+      - NODE_ENV=production

package/dist/templates/plopfiles/_modules/infra/pulumi/module.js

@@ -0,0 +1,30 @@
+/**
+ * Pulumi Infrastructure Module
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "addMany",
+      destination: "{{projectDir}}/infra/pulumi",
+      base: templatesDir,
+      templateFiles: `${templatesDir}/**/*.hbs`,
+      stripExtensions: ["hbs"],
+      data,
+    },
+  ];
+}
+
+export const description = "Pulumi infrastructure as code (TypeScript)";
+
+export const scripts = {
+  "pulumi:preview": "cd infra/pulumi && pulumi preview",
+  "pulumi:up": "cd infra/pulumi && pulumi up",
+  "pulumi:destroy": "cd infra/pulumi && pulumi destroy",
+};

package/dist/templates/plopfiles/_modules/infra/pulumi/templates/.gitignore.hbs

@@ -0,0 +1,5 @@
+# Pulumi
+bin/
+node_modules/
+Pulumi.*.yaml
+!Pulumi.dev.yaml

package/dist/templates/plopfiles/_modules/infra/pulumi/templates/Pulumi.dev.yaml.hbs

@@ -0,0 +1,3 @@
+config:
+  {{kebabCase name}}-infra:environment: dev
+  {{kebabCase name}}-infra:appPort: "3000"

package/dist/templates/plopfiles/_modules/infra/pulumi/templates/Pulumi.yaml.hbs

@@ -0,0 +1,7 @@
+name: {{kebabCase name}}-infra
+runtime: nodejs
+description: Infrastructure for {{titleCase name}}
+config:
+  pulumi:tags:
+    value:
+      pulumi:template: ""

package/dist/templates/plopfiles/_modules/infra/pulumi/templates/index.ts.hbs

@@ -0,0 +1,26 @@
+import * as pulumi from "@pulumi/pulumi";
+
+// Configuration
+const config = new pulumi.Config();
+const environment = config.get("environment") || "dev";
+const appPort = config.getNumber("appPort") || 3000;
+
+// Common tags for all resources
+const commonTags = {
+  Project: "{{kebabCase name}}",
+  Environment: environment,
+  ManagedBy: "pulumi",
+};
+
+// Export stack outputs
+export const projectName = "{{kebabCase name}}";
+export const env = environment;
+
+// Example: Create resources based on your cloud provider
+// import * as aws from "@pulumi/aws";
+//
+// const bucket = new aws.s3.Bucket("{{kebabCase name}}-bucket", {
+//   tags: commonTags,
+// });
+//
+// export const bucketName = bucket.bucket;

package/dist/templates/plopfiles/_modules/infra/pulumi/templates/package.json.hbs

@@ -0,0 +1,12 @@
+{
+  "name": "{{kebabCase name}}-infra",
+  "version": "0.1.0",
+  "main": "index.ts",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@pulumi/pulumi": "^3.0.0"
+  }
+}

package/dist/templates/plopfiles/_modules/infra/pulumi/templates/tsconfig.json.hbs

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "outDir": "bin",
+    "target": "ES2020",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "sourceMap": true,
+    "experimentalDecorators": true,
+    "pretty": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitReturns": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "files": ["index.ts"]
+}