container-superposition 0.1.6 → 0.1.8

package/tool/schema/config.schema.json

@@ -34,6 +34,79 @@
             },
             "description": "Preset parameter choices keyed by parameter name"
         },
+        "overlays": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "enum": [
+                    "alertmanager",
+                    "amp",
+                    "aws-cli",
+                    "azure-cli",
+                    "bun",
+                    "claude-code",
+                    "cloudflared",
+                    "codex",
+                    "commitlint",
+                    "direnv",
+                    "docker-in-docker",
+                    "docker-sock",
+                    "dotnet",
+                    "duckdb",
+                    "gcloud",
+                    "gemini-cli",
+                    "git-helpers",
+                    "go",
+                    "grafana",
+                    "grpc-tools",
+                    "jaeger",
+                    "java",
+                    "jupyter",
+                    "just",
+                    "keycloak",
+                    "kind",
+                    "kubectl-helm",
+                    "localstack",
+                    "loki",
+                    "mailpit",
+                    "minio",
+                    "mkdocs",
+                    "modern-cli-tools",
+                    "mongodb",
+                    "mysql",
+                    "nats",
+                    "ngrok",
+                    "nodejs",
+                    "openapi-tools",
+                    "opencode",
+                    "otel-collector",
+                    "otel-demo-nodejs",
+                    "otel-demo-python",
+                    "pandoc",
+                    "playwright",
+                    "postgres",
+                    "powershell",
+                    "pre-commit",
+                    "prometheus",
+                    "promtail",
+                    "pulumi",
+                    "python",
+                    "rabbitmq",
+                    "redis",
+                    "redpanda",
+                    "rust",
+                    "spec-kit",
+                    "sqlite",
+                    "sqlserver",
+                    "tempo",
+                    "terraform",
+                    "tilt",
+                    "windsurf-cli"
+                ]
+            },
+            "default": [],
+            "description": "Flat list of overlay IDs to include (preferred). Accepts any overlay regardless of category."
+        },
         "language": {
             "type": "array",
             "items": {
@@ -47,11 +120,12 @@
                     "go",
                     "rust",
                     "bun",
+                    "jupyter",
                     "powershell"
                 ]
             },
             "default": [],
-            "description": "Language/framework overlays"
+            "description": "Deprecated: use 'overlays' instead. Language/framework overlays (kept for backward compatibility)."
         },
         "database": {
             "type": "array",
@@ -64,6 +138,7 @@
                     "mysql",
                     "sqlserver",
                     "sqlite",
+                    "duckdb",
                     "minio",
                     "rabbitmq",
                     "redpanda",
@@ -71,21 +146,31 @@
                 ]
             },
             "default": [],
-            "description": "Database overlays"
+            "description": "Deprecated: use 'overlays' instead. Database overlays (kept for backward compatibility)."
         },
         "playwright": {
             "type": "boolean",
             "default": false,
-            "description": "Include Playwright for browser automation"
+            "description": "Deprecated: use 'overlays: [playwright]' instead. Include Playwright for browser automation (kept for backward compatibility)."
         },
         "cloudTools": {
             "type": "array",
             "items": {
                 "type": "string",
-                "enum": ["azure-cli", "aws-cli", "gcloud", "kubectl-helm", "terraform", "pulumi"]
+                "enum": [
+                    "azure-cli",
+                    "aws-cli",
+                    "gcloud",
+                    "cloudflared",
+                    "kubectl-helm",
+                    "kind",
+                    "localstack",
+                    "terraform",
+                    "pulumi"
+                ]
             },
             "default": [],
-            "description": "Cloud/orchestration tools to include"
+            "description": "Deprecated: use 'overlays' instead. Cloud/orchestration tools (kept for backward compatibility)."
         },
         "devTools": {
             "type": "array",
@@ -97,13 +182,19 @@
                     "codex",
                     "playwright",
                     "git-helpers",
+                    "grpc-tools",
+                    "keycloak",
+                    "mailpit",
                     "pre-commit",
                     "commitlint",
                     "just",
                     "direnv",
                     "modern-cli-tools",
                     "ngrok",
+                    "openapi-tools",
+                    "pandoc",
                     "spec-kit",
+                    "tilt",
                     "claude-code",
                     "gemini-cli",
                     "amp",
@@ -112,16 +203,27 @@
                 ]
             },
             "default": [],
-            "description": "Developer tooling overlays"
+            "description": "Deprecated: use 'overlays' instead. Developer tooling overlays (kept for backward compatibility)."
         },
         "observability": {
             "type": "array",
             "items": {
                 "type": "string",
-                "enum": ["otel-collector", "jaeger", "prometheus", "grafana", "loki"]
+                "enum": [
+                    "alertmanager",
+                    "otel-collector",
+                    "otel-demo-nodejs",
+                    "otel-demo-python",
+                    "jaeger",
+                    "prometheus",
+                    "promtail",
+                    "grafana",
+                    "loki",
+                    "tempo"
+                ]
             },
             "default": [],
-            "description": "Observability tools to include"
+            "description": "Deprecated: use 'overlays' instead. Observability tools (kept for backward compatibility)."
         },
         "portOffset": {
             "type": "number",
@@ -147,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": {
@@ -158,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,10 +136,48 @@
             },
             "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)",
             "default": false
+        },
+        "hidden": {
+            "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/compose/common-healthchecks.yml

@@ -1,38 +0,0 @@
-# Common Docker Compose Healthcheck Patterns
-# These can be referenced by overlays to ensure consistent healthcheck configuration
-
-healthchecks:
-    http:
-        test: ['CMD-SHELL', 'curl -f http://localhost:${PORT}/health || exit 1']
-        interval: 30s
-        timeout: 10s
-        retries: 3
-        start_period: 40s
-
-    postgres:
-        test: ['CMD-SHELL', 'pg_isready -U ${POSTGRES_USER:-postgres}']
-        interval: 10s
-        timeout: 5s
-        retries: 5
-        start_period: 10s
-
-    redis:
-        test: ['CMD', 'redis-cli', 'ping']
-        interval: 10s
-        timeout: 5s
-        retries: 5
-        start_period: 10s
-
-    mongodb:
-        test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
-        interval: 10s
-        timeout: 5s
-        retries: 5
-        start_period: 10s
-
-    mysql:
-        test: ['CMD', 'mysqladmin', 'ping', '-h', 'localhost']
-        interval: 10s
-        timeout: 5s
-        retries: 5
-        start_period: 10s