container-superposition 0.1.7 → 0.1.9

package/overlays/skaffold/devcontainer.patch.json

@@ -0,0 +1,9 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "features": {
+        "./features/cross-distro-packages": {
+            "apt": "curl",
+            "apk": "curl"
+        }
+    }
+}

package/overlays/skaffold/overlay.yml

@@ -0,0 +1,20 @@
+id: skaffold
+name: Skaffold
+description: Continuous development and deployment pipeline for Kubernetes applications
+category: dev
+supports: []
+requires: []
+suggests:
+    - kubectl-helm
+    - kind
+    - k3d
+conflicts:
+    - tilt
+tags:
+    - dev
+    - kubernetes
+    - k8s
+    - cicd
+    - deployment
+    - skaffold
+ports: []

package/overlays/skaffold/setup.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# Setup script for Skaffold
+
+set -e
+
+echo "🔧 Setting up Skaffold..."
+
+# Source shared setup utilities
+# shellcheck source=setup-utils.sh
+source "$(dirname "${BASH_SOURCE[0]}")/setup-utils.sh"
+
+detect_arch
+
+SKAFFOLD_VERSION="${SKAFFOLD_VERSION:-v2.13.2}"
+echo "📦 Installing Skaffold ${SKAFFOLD_VERSION}..."
+
+install_binary \
+    "https://storage.googleapis.com/skaffold/releases/${SKAFFOLD_VERSION}/skaffold-linux-${CS_ARCH}" \
+    "skaffold"
+
+# Verify installation
+if command -v skaffold &>/dev/null; then
+    echo "✅ Skaffold installed successfully"
+    skaffold version
+else
+    echo "❌ Skaffold installation failed"
+    exit 1
+fi
+
+echo "✅ Skaffold setup complete"
+echo ""
+echo "ℹ️  To start continuous development, run:"
+echo "   skaffold dev"

package/overlays/skaffold/verify.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Verification script for Skaffold overlay
+# Confirms Skaffold is installed
+
+set -e
+
+echo "🔍 Verifying Skaffold overlay..."
+echo ""
+
+# Check Skaffold is installed
+echo "1️⃣ Checking Skaffold installation..."
+if command -v skaffold &>/dev/null; then
+    skaffold version
+    echo "   ✅ Skaffold is installed"
+else
+    echo "   ❌ Skaffold is not installed"
+    exit 1
+fi
+
+echo ""
+echo "✅ Skaffold overlay verification complete"
+echo ""
+echo "ℹ️  To start continuous development, run:"
+echo "   skaffold dev"

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/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,11 +1,12 @@
 {
     "name": "container-superposition",
-    "version": "0.1.7",
+    "version": "0.1.9",
     "description": "Solution-ready devcontainer templates and features with guided initialization",
     "type": "module",
     "main": "dist/scripts/init.js",
     "bin": {
-        "container-superposition": "./dist/scripts/init.js"
+        "container-superposition": "./dist/scripts/init.js",
+        "cs": "./dist/scripts/init.js"
     },
     "scripts": {
         "build": "tsc",

package/tool/schema/config.schema.json

@@ -249,6 +249,29 @@
             "enum": ["vscode", "jetbrains", "none"],
             "description": "Editor customization profile"
         },
+        "env": {
+            "type": "object",
+            "description": "Project-level environment variables routed to remoteEnv or docker-compose based on stack/target",
+            "additionalProperties": {
+                "oneOf": [
+                    {
+                        "type": "string"
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "value": { "type": "string" },
+                            "target": {
+                                "type": "string",
+                                "enum": ["auto", "remoteEnv", "composeEnv"]
+                            }
+                        },
+                        "required": ["value"],
+                        "additionalProperties": false
+                    }
+                ]
+            }
+        },
         "customizations": {
             "type": "object",
             "properties": {
@@ -260,12 +283,19 @@
                     "type": "object",
                     "description": "Additional docker-compose content merged during generation"
                 },
+                "envTemplate": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "type": "string"
+                    },
+                    "description": "Variables written to .env.example; use env for runtime container environment"
+                },
                 "environment": {
                     "type": "object",
                     "additionalProperties": {
                         "type": "string"
                     },
-                    "description": "Environment variables written to custom/environment.env"
+                    "description": "Deprecated alias for envTemplate; variables written to .env.example"
                 },
                 "scripts": {
                     "type": "object",

package/tool/schema/overlay-manifest.schema.json

@@ -136,6 +136,14 @@
             },
             "default": []
         },
+        "compose_imports": {
+            "type": "array",
+            "description": "Shared docker-compose fragments to import from overlays/.shared/compose/ (merged before the overlay's own docker-compose.yml)",
+            "items": {
+                "type": "string"
+            },
+            "default": []
+        },
         "minimal": {
             "type": "boolean",
             "description": "Whether this overlay is excluded in minimal mode (true = extra/optional)",
@@ -145,6 +153,31 @@
             "type": "boolean",
             "description": "Whether this overlay is hidden from the interactive questionnaire (code-only use)",
             "default": false
+        },
+        "parameters": {
+            "type": "object",
+            "description": "Configurable parameters declared by this overlay. Users supply values in superposition.yml or via CLI. Substituted at generation time using {{cs.PARAM_NAME}} syntax.",
+            "additionalProperties": {
+                "type": "object",
+                "description": "Definition of a single overlay parameter",
+                "required": ["description"],
+                "properties": {
+                    "description": {
+                        "type": "string",
+                        "description": "Human-readable explanation of the parameter, shown in interactive prompts"
+                    },
+                    "default": {
+                        "type": "string",
+                        "description": "Default value used when no value is supplied. Absence makes the parameter required."
+                    },
+                    "sensitive": {
+                        "type": "boolean",
+                        "description": "When true, the parameter value is treated as a secret — masked in interactive prompts and redacted in plan output",
+                        "default": false
+                    }
+                },
+                "additionalProperties": false
+            }
         }
     },
     "additionalProperties": false

package/overlays/.shared/otel/otel-base-config.yaml

@@ -1,30 +0,0 @@
-# OpenTelemetry Base Configuration
-# This file provides common OTEL environment variables for instrumentation
-
-receivers:
-    otlp:
-        protocols:
-            grpc:
-                endpoint: 0.0.0.0:4317
-            http:
-                endpoint: 0.0.0.0:4318
-
-exporters:
-    logging:
-        loglevel: debug
-
-processors:
-    batch:
-        timeout: 10s
-        send_batch_size: 1024
-
-service:
-    pipelines:
-        traces:
-            receivers: [otlp]
-            processors: [batch]
-            exporters: [logging]
-        metrics:
-            receivers: [otlp]
-            processors: [batch]
-            exporters: [logging]