container-superposition 0.1.8 → 0.1.10

package/overlays/pgvector/devcontainer.patch.json

@@ -14,10 +14,16 @@
             "apk": "postgresql-client"
         }
     },
-    "containerEnv": {
-        "PGHOST": "pgvector",
-        "PGPORT": "5432",
-        "PGDATABASE": "devdb",
-        "PGUSER": "postgres"
+    "remoteEnv": {
+        "PGVECTOR_HOST": "pgvector",
+        "PGVECTOR_PORT": "5432",
+        "PGVECTOR_DB": "{{cs.PGVECTOR_DB}}",
+        "PGVECTOR_USER": "{{cs.PGVECTOR_USER}}",
+        "PGVECTOR_PASSWORD": "{{cs.PGVECTOR_PASSWORD}}",
+        "POSTGRES_HOST": "pgvector",
+        "POSTGRES_PORT": "5432",
+        "POSTGRES_DB": "{{cs.PGVECTOR_DB}}",
+        "POSTGRES_USER": "{{cs.PGVECTOR_USER}}",
+        "POSTGRES_PASSWORD": "{{cs.PGVECTOR_PASSWORD}}"
     }
 }

package/overlays/pgvector/docker-compose.yml

@@ -30,3 +30,4 @@ volumes:
 
 networks:
     devnet:
+        name: devnet

package/overlays/pgvector/overlay.yml

@@ -9,8 +9,11 @@ suggests:
     - ollama
     - python
     - nodejs
+    - prometheus
+    - grafana
 conflicts:
     - postgres
+serviceOrder: 0
 tags:
     - database
     - sql

package/overlays/playwright/devcontainer.patch.json

@@ -1,10 +1,5 @@
 {
     "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
-    "features": {
-        "ghcr.io/devcontainers/features/node:1": {
-            "version": "lts"
-        }
-    },
     "postCreateCommand": {
         "setup-playwright": "bash .devcontainer/scripts/setup-playwright.sh"
     }

package/overlays/playwright/overlay.yml

@@ -3,7 +3,8 @@ name: Playwright
 description: Browser automation and testing framework
 category: dev
 supports: []
-requires: []
+requires:
+    - nodejs
 suggests: []
 conflicts: []
 tags:

package/overlays/postgres/docker-compose.yml

@@ -30,3 +30,4 @@ volumes:
 
 networks:
     devnet:
+        name: devnet

package/overlays/postgres/overlay.yml

@@ -5,9 +5,12 @@ category: database
 supports:
     - compose
 requires: []
-suggests: []
+suggests:
+    - prometheus
+    - grafana
 conflicts:
     - pgvector
+serviceOrder: 0
 tags:
     - database
     - sql

package/overlays/pre-commit/devcontainer.patch.json

@@ -1,9 +1,3 @@
 {
-    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
-    "features": {
-        "ghcr.io/devcontainers/features/python:1": {
-            "version": "3.12",
-            "installTools": true
-        }
-    }
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json"
 }

package/overlays/prometheus/devcontainer.patch.json

@@ -1,7 +1,6 @@
 {
     "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
     "runServices": ["prometheus"],
-    "_serviceOrder": 1,
     "forwardPorts": [9090],
     "portsAttributes": {
         "9090": {

package/overlays/prometheus/docker-compose.yml

@@ -2,6 +2,7 @@ version: '3.8'
 services:
     prometheus:
         image: prom/prometheus:${PROMETHEUS_VERSION:-latest}
+        restart: unless-stopped
         command:
             - '--config.file=/etc/prometheus/prometheus.yml'
             - '--storage.tsdb.path=/prometheus'
@@ -14,9 +15,16 @@ services:
             - '${PROMETHEUS_PORT:-9090}:9090'
         networks:
             - devnet
+        healthcheck:
+            test: ['CMD', 'wget', '-qO-', 'http://localhost:9090/-/ready']
+            interval: 10s
+            timeout: 5s
+            retries: 5
+            start_period: 15s
 
 volumes:
     prometheus_data:
 
 networks:
     devnet:
+        name: devnet

package/overlays/prometheus/overlay.yml

@@ -20,5 +20,6 @@ ports:
       path: /
       onAutoForward: openBrowser
 order: 1
+serviceOrder: 1
 imports:
     - .shared/otel/instrumentation.env

package/overlays/promtail/devcontainer.patch.json

@@ -1,5 +1,4 @@
 {
     "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
-    "runServices": ["promtail"],
-    "_serviceOrder": 2
+    "runServices": ["promtail"]
 }

package/overlays/promtail/docker-compose.yml

@@ -2,6 +2,7 @@ version: '3.8'
 services:
     promtail:
         image: grafana/promtail:${PROMTAIL_VERSION:-latest}
+        restart: unless-stopped
         command: -config.file=/etc/promtail/promtail-config.yaml
         volumes:
             - ./promtail-config-promtail.yaml:/etc/promtail/promtail-config.yaml
@@ -11,6 +12,13 @@ services:
             - loki
         networks:
             - devnet
+        healthcheck:
+            test: ['CMD', 'wget', '-qO-', 'http://localhost:9080/ready']
+            interval: 10s
+            timeout: 5s
+            retries: 5
+            start_period: 10s
 
 networks:
     devnet:
+        name: devnet

package/overlays/promtail/overlay.yml

@@ -15,3 +15,4 @@ tags:
     - loki
 ports: []
 order: 2
+serviceOrder: 2

package/overlays/qdrant/docker-compose.yml

@@ -23,3 +23,4 @@ volumes:
 
 networks:
     devnet:
+        name: devnet

package/overlays/qdrant/overlay.yml

@@ -9,7 +9,11 @@ suggests:
     - ollama
     - python
     - nodejs
+    - prometheus
+    - grafana
+    - otel-collector
 conflicts: []
+serviceOrder: 0
 tags:
     - database
     - vector
@@ -31,7 +35,7 @@ ports:
 parameters:
     QDRANT_VERSION:
         description: Qdrant Docker image tag
-        default: latest
+        default: v1.9.0
     QDRANT_PORT:
         description: Host port mapped to Qdrant REST API (6333 inside container)
         default: '6333'

package/overlays/rabbitmq/docker-compose.yml

@@ -28,3 +28,4 @@ volumes:
 
 networks:
     devnet:
+        name: devnet

package/overlays/rabbitmq/overlay.yml

@@ -1,12 +1,35 @@
 id: rabbitmq
 name: RabbitMQ
 description: Message broker with AMQP protocol and management UI
-category: database
+category: messaging
 supports:
     - compose
 requires: []
-suggests: []
+suggests:
+    - prometheus
+    - grafana
 conflicts: []
+serviceOrder: 0
+parameters:
+    RABBITMQ_VERSION:
+        description: RabbitMQ image version tag (management variant used)
+        default: 3-management
+    RABBITMQ_PORT:
+        description: Host port mapped to AMQP (5672 inside container)
+        default: '5672'
+    RABBITMQ_MANAGEMENT_PORT:
+        description: Host port mapped to management UI (15672 inside container)
+        default: '15672'
+    RABBITMQ_USER:
+        description: RabbitMQ default username
+        default: guest
+    RABBITMQ_PASSWORD:
+        description: RabbitMQ default password
+        default: guest
+        sensitive: true
+    RABBITMQ_VHOST:
+        description: RabbitMQ default virtual host
+        default: /
 tags:
     - database
     - messaging

package/overlays/redis/docker-compose.yml

@@ -13,9 +13,16 @@ services:
             REDIS_PASSWORD: ${REDIS_PASSWORD:-}
         networks:
             - devnet
+        healthcheck:
+            test: ['CMD', 'redis-cli', 'ping']
+            interval: 10s
+            timeout: 5s
+            retries: 5
+            start_period: 10s
 
 volumes:
     redis-data:
 
 networks:
     devnet:
+        name: devnet

package/overlays/redis/overlay.yml

@@ -5,8 +5,22 @@ category: database
 supports:
     - compose
 requires: []
-suggests: []
+suggests:
+    - prometheus
+    - grafana
 conflicts: []
+serviceOrder: 0
+parameters:
+    REDIS_VERSION:
+        description: Redis image version tag
+        default: '7'
+    REDIS_PORT:
+        description: Host port mapped to Redis (6379 inside container)
+        default: '6379'
+    REDIS_PASSWORD:
+        description: Redis password (leave empty to disable authentication)
+        default: ''
+        sensitive: true
 tags:
     - database
     - cache

package/overlays/redpanda/docker-compose.yml

@@ -63,3 +63,4 @@ volumes:
 
 networks:
     devnet:
+        name: devnet

package/overlays/redpanda/overlay.yml

@@ -1,12 +1,24 @@
 id: redpanda
 name: Redpanda
 description: Kafka-compatible event streaming with web console
-category: database
+category: messaging
 supports:
     - compose
 requires: []
-suggests: []
-conflicts: []
+suggests:
+    - prometheus
+    - grafana
+conflicts:
+    - mysql
+    - mongodb
+    - nodejs
+    - bun
+    - go
+    - java
+    - dotnet
+    - otel-demo-nodejs
+    - otel-demo-python
+serviceOrder: 0
 tags:
     - database
     - messaging

package/overlays/rocm/overlay.yml

@@ -4,7 +4,8 @@ description: AMD ROCm libraries and GPU passthrough for containerized ML/inferen
 category: dev
 supports: []
 requires: []
-suggests: []
+suggests:
+    - comfyui
 conflicts:
     - cuda
 tags:

package/overlays/rust/overlay.yml

@@ -5,7 +5,9 @@ category: language
 supports: []
 requires: []
 suggests: []
-conflicts: []
+conflicts:
+    - grafana
+    - open-webui
 tags:
     - language
     - rust

package/overlays/sqlserver/docker-compose.yml

@@ -30,3 +30,4 @@ volumes:
 
 networks:
     devnet:
+        name: devnet

package/overlays/sqlserver/overlay.yml

@@ -7,7 +7,24 @@ supports:
 requires: []
 suggests:
     - dotnet
+    - prometheus
+    - grafana
 conflicts: []
+serviceOrder: 0
+parameters:
+    MSSQL_VERSION:
+        description: SQL Server image version tag
+        default: 2022-latest
+    MSSQL_PORT:
+        description: Host port mapped to SQL Server (1433 inside container)
+        default: '1433'
+    MSSQL_SA_PASSWORD:
+        description: SQL Server SA (system administrator) password
+        default: YourStrong@Passw0rd
+        sensitive: true
+    MSSQL_PID:
+        description: SQL Server product ID / edition (Developer, Express, Standard, Enterprise)
+        default: Developer
 tags:
     - database
     - sql

package/overlays/task/README.md

@@ -0,0 +1,47 @@
+# Taskfile (task) Overlay
+
+Adds [Task](https://taskfile.dev/) (`task`) to run project automation via `Taskfile.yml`.
+
+## Features
+
+- **Task CLI** — fast, modern task runner (`task`)
+- **Taskfile workflows** — declarative task definitions with dependencies and variables
+- **Architecture-aware install** — installs amd64 or arm64 binary automatically
+
+## Quick Start
+
+```bash
+task --version
+task --list
+```
+
+Create a basic `Taskfile.yml`:
+
+```yaml
+version: '3'
+
+tasks:
+    default:
+        cmds:
+            - task --list
+
+    lint:
+        cmds:
+            - npm run lint
+
+    test:
+        cmds:
+            - npm test
+```
+
+Run tasks:
+
+```bash
+task lint
+task test
+```
+
+## Suggested Pairings
+
+- `modern-cli-tools` — useful companion CLIs for day-to-day development
+- `kubectl-helm` — pair task automation with Kubernetes workflows

package/overlays/task/devcontainer.patch.json

@@ -0,0 +1,9 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "postCreateCommand": {
+        "setup-task": "bash .devcontainer/scripts/setup-task.sh"
+    },
+    "postStartCommand": {
+        "verify-task": "bash .devcontainer/scripts/verify-task.sh"
+    }
+}

package/overlays/task/overlay.yml

@@ -0,0 +1,16 @@
+id: task
+name: Taskfile (task)
+description: Modern task runner and build tool using Taskfiles
+category: dev
+supports: []
+requires: []
+suggests:
+    - modern-cli-tools
+    - kubectl-helm
+conflicts: []
+tags:
+    - dev
+    - automation
+    - taskfile
+    - build
+ports: []

package/overlays/task/setup.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Setup script for Taskfile (task)
+
+set -e
+
+echo "🔧 Setting up Taskfile (task)..."
+
+# Source shared setup utilities
+# shellcheck source=setup-utils.sh
+source "$(dirname "${BASH_SOURCE[0]}")/setup-utils.sh"
+
+detect_arch
+
+TASK_VERSION="${TASK_VERSION:-v3.45.4}"
+echo "📦 Installing task ${TASK_VERSION}..."
+
+install_binary_from_tar \
+    "https://github.com/go-task/task/releases/download/${TASK_VERSION}/task_linux_${CS_ARCH}.tar.gz" \
+    "task"
+
+if command -v task >/dev/null 2>&1; then
+    echo "✅ task installed successfully"
+    task --version
+else
+    echo "❌ task installation failed"
+    exit 1
+fi
+
+echo "✅ Taskfile setup complete"

package/overlays/task/verify.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Verification script for Taskfile (task) overlay
+
+set -e
+
+echo "🔍 Verifying Taskfile overlay..."
+
+if command -v task >/dev/null 2>&1; then
+    task --version
+    echo "✅ task is installed"
+else
+    echo "❌ task is not installed"
+    exit 1
+fi

package/overlays/tempo/devcontainer.patch.json

@@ -1,7 +1,6 @@
 {
     "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
     "runServices": ["tempo"],
-    "_serviceOrder": 1,
     "forwardPorts": [3200],
     "portsAttributes": {
         "3200": {

package/overlays/tempo/docker-compose.yml

@@ -2,6 +2,7 @@ version: '3.8'
 services:
     tempo:
         image: grafana/tempo:${TEMPO_VERSION:-latest}
+        restart: unless-stopped
         command: ['-config.file=/etc/tempo/tempo-config.yaml']
         volumes:
             - ./tempo-config-tempo.yaml:/etc/tempo/tempo-config.yaml
@@ -12,9 +13,16 @@ services:
             # Apps should send traces to otel-collector, which forwards to Tempo
         networks:
             - devnet
+        healthcheck:
+            test: ['CMD', 'wget', '-qO-', 'http://localhost:3200/ready']
+            interval: 10s
+            timeout: 5s
+            retries: 5
+            start_period: 15s
 
 volumes:
     tempo_data:
 
 networks:
     devnet:
+        name: devnet

package/overlays/tempo/overlay.yml

@@ -18,3 +18,4 @@ tags:
 ports:
     - 3200
 order: 1
+serviceOrder: 1

package/overlays/windsurf-cli/devcontainer.patch.json

@@ -1,3 +1,6 @@
 {
-    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json"
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "postCreateCommand": {
+        "setup-windsurf-cli": "bash .devcontainer/scripts/setup-windsurf-cli.sh"
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "container-superposition",
-    "version": "0.1.8",
+    "version": "0.1.10",
     "description": "Solution-ready devcontainer templates and features with guided initialization",
     "type": "module",
     "main": "dist/scripts/init.js",

package/tool/schema/config.schema.json

@@ -272,6 +272,41 @@
                 ]
             }
         },
+        "mounts": {
+            "description": "Project-level mount specs routed to devcontainer.json mounts or docker-compose volumes based on stack/target",
+            "oneOf": [
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/$defs/projectMountEntry"
+                    }
+                },
+                {
+                    "type": "object",
+                    "description": "Named mount map form",
+                    "additionalProperties": {
+                        "$ref": "#/$defs/projectMountObject"
+                    }
+                }
+            ]
+        },
+        "shell": {
+            "type": "object",
+            "description": "Shell profile customizations written via a managed shell-init hook",
+            "properties": {
+                "aliases": {
+                    "type": "object",
+                    "additionalProperties": { "type": "string" },
+                    "description": "Alias name -> command map (e.g. k: kubectl)"
+                },
+                "snippets": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Raw shell snippets appended to generated shell-init"
+                }
+            },
+            "additionalProperties": false
+        },
         "customizations": {
             "type": "object",
             "properties": {
@@ -328,5 +363,43 @@
         }
     },
     "required": [],
-    "additionalProperties": false
+    "additionalProperties": false,
+    "$defs": {
+        "projectMountTarget": {
+            "type": "string",
+            "enum": ["auto", "devcontainerMount", "composeVolume"]
+        },
+        "projectMountObject": {
+            "type": "object",
+            "properties": {
+                "value": {
+                    "type": "string",
+                    "description": "Raw mount spec string (escape hatch)"
+                },
+                "source": { "type": "string", "description": "Mount source path or volume name" },
+                "destination": { "type": "string", "description": "Container destination path" },
+                "type": { "type": "string", "enum": ["bind", "volume", "tmpfs"] },
+                "consistency": { "type": "string", "enum": ["consistent", "cached", "delegated"] },
+                "cached": {
+                    "type": "boolean",
+                    "description": "Convenience alias for consistency: cached"
+                },
+                "readOnly": { "type": "boolean" },
+                "target": { "$ref": "#/$defs/projectMountTarget" }
+            },
+            "additionalProperties": false,
+            "oneOf": [{ "required": ["value"] }, { "required": ["source", "destination"] }]
+        },
+        "projectMountEntry": {
+            "oneOf": [
+                {
+                    "type": "string",
+                    "description": "Raw mount spec string"
+                },
+                {
+                    "$ref": "#/$defs/projectMountObject"
+                }
+            ]
+        }
+    }
 }