container-superposition 0.1.8 → 0.1.10

package/overlays/ansible/overlay.yml

@@ -0,0 +1,18 @@
+id: ansible
+name: Ansible
+description: Automation and configuration management with Ansible and ansible-lint
+category: cloud
+supports: []
+requires: []
+suggests:
+    - aws-cli
+    - azure-cli
+    - gcloud
+    - terraform
+conflicts: []
+tags:
+    - cloud
+    - iac
+    - automation
+    - ansible
+ports: []

package/overlays/argocd/README.md

@@ -0,0 +1,158 @@
+# Argo CD CLI Overlay
+
+Adds the [`argocd`](https://argo-cd.readthedocs.io/) CLI for managing GitOps workflows with an Argo CD server — log in, inspect apps, trigger syncs, and manage rollouts without leaving your devcontainer.
+
+## Features
+
+- **Argo CD CLI** — `argocd` client for login, app sync, rollback, and lifecycle operations
+- **Release install** — binary downloaded from official Argo CD GitHub releases
+- **Architecture-aware** — installs `amd64` or `arm64` automatically
+
+## How It Works
+
+The `argocd` binary is downloaded from the official Argo CD GitHub releases page (`github.com/argoproj/argo-cd`) during devcontainer creation via `setup.sh`.
+
+- Detects host architecture (`amd64` / `arm64`) automatically
+- Downloads the matching pre-built binary and places it in `/usr/local/bin/argocd`
+- No Argo CD server is run inside the devcontainer — the CLI connects to an external (or locally port-forwarded) Argo CD server
+
+**Dependencies:** None required. Pair with `kubectl-helm` for full cluster access, and `k3d` or `kind` for local Kubernetes clusters where you can deploy Argo CD for testing.
+
+## Common Commands
+
+### Authentication
+
+```bash
+# Login to an Argo CD server
+argocd login argocd.example.com
+
+# Login with TLS disabled (for local/dev servers)
+argocd login localhost:8080 --insecure
+
+# Login and save context (avoids re-entering credentials)
+argocd login argocd.example.com --grpc-web
+
+# Check current logged-in context
+argocd context
+
+# Switch context
+argocd context my-cluster
+
+# Logout
+argocd logout argocd.example.com
+```
+
+### Application Management
+
+```bash
+# List all applications
+argocd app list
+
+# Get detailed status of an app
+argocd app get my-app
+
+# Create an app (GitOps source)
+argocd app create my-app \
+  --repo https://github.com/myorg/my-manifests.git \
+  --path k8s/overlays/dev \
+  --dest-server https://kubernetes.default.svc \
+  --dest-namespace my-app
+
+# Sync (deploy) an app
+argocd app sync my-app
+
+# Wait for sync to complete
+argocd app wait my-app --sync
+
+# Delete an app (without deleting cluster resources)
+argocd app delete my-app
+
+# Delete an app and all managed cluster resources
+argocd app delete my-app --cascade
+```
+
+### Sync Operations
+
+```bash
+# Sync only specific resources
+argocd app sync my-app --resource apps:Deployment:my-app
+
+# Force sync (ignores resource health)
+argocd app sync my-app --force
+
+# Dry-run sync (show diff without applying)
+argocd app diff my-app
+
+# Rollback to a previous revision
+argocd app rollback my-app 3
+
+# View app history
+argocd app history my-app
+```
+
+### Projects & RBAC
+
+```bash
+# List projects
+argocd proj list
+
+# Create a project
+argocd proj create my-project \
+  --description "My project" \
+  --src https://github.com/myorg/my-manifests.git \
+  --dest https://kubernetes.default.svc,my-namespace
+
+# List project roles
+argocd proj role list my-project
+```
+
+## Local Port-Forward Workflow
+
+When testing Argo CD in a local cluster (k3d / kind):
+
+```bash
+# Install Argo CD in the cluster
+kubectl create namespace argocd
+kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
+
+# Wait for pods to be ready
+kubectl -n argocd wait --for=condition=ready pod -l app.kubernetes.io/name=argocd-server --timeout=120s
+
+# Port-forward the API server
+kubectl -n argocd port-forward svc/argocd-server 8080:443 &
+
+# Get the initial admin password
+argocd admin initial-password -n argocd
+
+# Login
+argocd login localhost:8080 --insecure
+```
+
+## Use Cases
+
+- **GitOps deployments** — Sync Kubernetes manifests from Git to a cluster via Argo CD
+- **Multi-environment promotion** — Manage dev/staging/production app variants with app-of-apps patterns
+- **Rollback workflows** — Inspect history and revert to a previous known-good revision
+- **Local GitOps testing** — Deploy Argo CD to a local `k3d` or `kind` cluster to test GitOps pipelines without a cloud environment
+- **Drift detection** — Use `argocd app diff` to detect config drift before syncing
+
+**Integrates well with:**
+
+- `kubectl-helm` — Kubernetes CLI and Helm for inspecting or patching resources managed by Argo CD
+- `k3d` — Lightweight local clusters for GitOps development and testing
+- `kind` — Full-conformance local clusters for Argo CD testing
+- `terraform` — Provision the cluster and bootstrap Argo CD with Terraform, then manage apps with the CLI
+
+## References
+
+- [Argo CD Documentation](https://argo-cd.readthedocs.io/)
+- [Argo CD CLI Reference](https://argo-cd.readthedocs.io/en/stable/user-guide/commands/argocd/)
+- [Argo CD GitHub Releases](https://github.com/argoproj/argo-cd/releases)
+- [Argo CD Getting Started](https://argo-cd.readthedocs.io/en/stable/getting_started/)
+- [App of Apps Pattern](https://argo-cd.readthedocs.io/en/stable/operator-manual/cluster-bootstrapping/)
+
+**Related Overlays:**
+
+- [`kubectl-helm`](../kubectl-helm/README.md) — Kubernetes CLI and Helm package manager
+- [`k3d`](../k3d/README.md) — Lightweight local Kubernetes clusters
+- [`kind`](../kind/README.md) — Full-conformance local Kubernetes clusters

package/overlays/argocd/devcontainer.patch.json

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

package/overlays/argocd/overlay.yml

@@ -0,0 +1,17 @@
+id: argocd
+name: Argo CD CLI
+description: GitOps CLI for managing Argo CD applications and sync workflows
+category: cloud
+supports: []
+requires: []
+suggests:
+    - kubectl-helm
+    - k3d
+    - kind
+conflicts: []
+tags:
+    - cloud
+    - kubernetes
+    - gitops
+    - argocd
+ports: []

package/overlays/argocd/setup.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Setup script for Argo CD CLI
+
+set -e
+
+echo "🔧 Setting up Argo CD CLI..."
+
+# Source shared setup utilities
+# shellcheck source=setup-utils.sh
+source "$(dirname "${BASH_SOURCE[0]}")/setup-utils.sh"
+
+detect_arch
+
+ARGOCD_VERSION="${ARGOCD_VERSION:-v2.14.12}"
+echo "📦 Installing argocd ${ARGOCD_VERSION}..."
+
+install_binary \
+    "https://github.com/argoproj/argo-cd/releases/download/${ARGOCD_VERSION}/argocd-linux-${CS_ARCH}" \
+    "argocd"
+
+if command -v argocd >/dev/null 2>&1; then
+    echo "✅ Argo CD CLI installed successfully"
+    argocd version --client --short || argocd version --client
+else
+    echo "❌ Argo CD CLI installation failed"
+    exit 1
+fi
+
+echo "✅ Argo CD CLI setup complete"

package/overlays/argocd/verify.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Verification script for Argo CD CLI overlay
+
+set -e
+
+echo "🔍 Verifying Argo CD CLI overlay..."
+
+if command -v argocd >/dev/null 2>&1; then
+    argocd version --client --short || argocd version --client
+    echo "✅ Argo CD CLI is installed"
+else
+    echo "❌ Argo CD CLI is not installed"
+    exit 1
+fi

package/overlays/bun/devcontainer.patch.json

@@ -12,16 +12,7 @@
     },
     "customizations": {
         "vscode": {
-            "extensions": ["oven.bun-vscode", "dbaeumer.vscode-eslint", "esbenp.prettier-vscode"],
-            "settings": {
-                "editor.defaultFormatter": "esbenp.prettier-vscode",
-                "[typescript]": {
-                    "editor.defaultFormatter": "esbenp.prettier-vscode"
-                },
-                "[javascript]": {
-                    "editor.defaultFormatter": "esbenp.prettier-vscode"
-                }
-            }
+            "extensions": ["oven.bun-vscode"]
         }
     },
     "remoteEnv": {

package/overlays/bun/overlay.yml

@@ -5,7 +5,12 @@ category: language
 supports: []
 requires: []
 suggests: []
-conflicts: []
+conflicts:
+    - grafana
+    - open-webui
+    - mysql
+    - redpanda
+    - otel-demo-nodejs
 tags:
     - language
     - bun
@@ -14,3 +19,5 @@ tags:
 ports:
     - 3000
     - 8080
+imports:
+    - .shared/vscode/js-ts-settings.json

package/overlays/claude-code/devcontainer.patch.json

@@ -1,3 +1,8 @@
 {
-    "$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",
+    "customizations": {
+        "vscode": {
+            "extensions": ["anthropic.claude-code"]
+        }
+    }
 }

package/overlays/codex/devcontainer.patch.json

@@ -5,5 +5,10 @@
             "apt": "bubblewrap",
             "apk": "bubblewrap"
         }
+    },
+    "customizations": {
+        "vscode": {
+            "extensions": ["openai.chatgpt"]
+        }
     }
 }

package/overlays/comfyui/docker-compose.yml

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

package/overlays/comfyui/overlay.yml

@@ -7,9 +7,13 @@ supports:
 requires: []
 suggests:
     - cuda
+    - rocm
     - python
     - ollama
+compose_imports:
+    - .shared/compose/nvidia-gpu-devcontainer.yml
 conflicts: []
+serviceOrder: 3
 tags:
     - dev
     - ai

package/overlays/commitlint/devcontainer.patch.json

@@ -1,8 +1,3 @@
 {
-    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
-    "features": {
-        "ghcr.io/devcontainers/features/node:1": {
-            "version": "lts"
-        }
-    }
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json"
 }

package/overlays/docker-sock/overlay.yml

@@ -7,6 +7,7 @@ requires: []
 suggests: []
 conflicts:
     - docker-in-docker
+serviceOrder: 0
 tags:
     - dev
     - docker

package/overlays/dotnet/overlay.yml

@@ -5,7 +5,10 @@ category: language
 supports: []
 requires: []
 suggests: []
-conflicts: []
+conflicts:
+    - mysql
+    - redpanda
+    - otel-demo-nodejs
 tags:
     - language
     - dotnet

package/overlays/fuseki/.env.example

@@ -0,0 +1,5 @@
+# Apache Jena Fuseki Configuration
+FUSEKI_VERSION={{cs.FUSEKI_VERSION}}
+FUSEKI_PORT={{cs.FUSEKI_PORT}}
+FUSEKI_ADMIN_PASSWORD={{cs.FUSEKI_ADMIN_PASSWORD}}
+FUSEKI_DATASET={{cs.FUSEKI_DATASET}}

package/overlays/fuseki/README.md

@@ -0,0 +1,173 @@
+# Apache Jena Fuseki Overlay
+
+SPARQL 1.1 server and RDF triplestore powered by Apache Jena TDB2, with a built-in web administration UI.
+
+## Features
+
+- **Apache Jena Fuseki** — SPARQL 1.1 server supporting queries, updates, and the Graph Store Protocol
+- **TDB2 triplestore** — High-performance persistent RDF storage with better concurrency than TDB1
+- **Admin web UI** — Browser-based interface for managing datasets, running ad-hoc queries, and monitoring the server (port 3030)
+- **REST management API** — Create, list, and delete datasets without restarting the server
+- **Dataset auto-creation** — A default dataset is created automatically on first start
+- **Persistent storage** — RDF data is stored in a named Docker volume (`fuseki-data`) and survives container restarts
+- **Docker Compose service** — Runs as an isolated sidecar container accessible on the `devnet` network
+
+## How It Works
+
+This overlay adds Fuseki as a separate Docker Compose service. Fuseki runs inside its own container and is reachable from your development container using the hostname `fuseki`.
+
+**Service configuration:**
+
+- Image: `ghcr.io/stain/jena-fuseki`
+- Network: `devnet` (shared with the dev container)
+- Persistence: `fuseki-data` volume for TDB2 database files
+- Port: 3030 (customizable via `FUSEKI_PORT` host mapping)
+
+**Environment variables set in the dev container:**
+
+| Variable                | Value                | Description                               |
+| ----------------------- | -------------------- | ----------------------------------------- |
+| `FUSEKI_HOST`           | `fuseki`             | Container hostname for internal access    |
+| `FUSEKI_PORT`           | `3030`               | Container-internal port for SPARQL access |
+| `FUSEKI_URL`            | `http://fuseki:3030` | Base URL for SPARQL requests              |
+| `FUSEKI_DATASET`        | `ds` (default)       | Name of the default dataset               |
+| `FUSEKI_ADMIN_PASSWORD` | see `.env`           | Admin user password (set in `.env`)       |
+
+## Common Commands
+
+### SPARQL Queries
+
+```bash
+# Simple SELECT query
+curl -X POST \
+  -H "Content-Type: application/sparql-query" \
+  -d "SELECT * WHERE { ?s ?p ?o } LIMIT 10" \
+  "$FUSEKI_URL/$FUSEKI_DATASET/query"
+
+# Query with URL encoding (GET request)
+curl -G "$FUSEKI_URL/$FUSEKI_DATASET/query" \
+  --data-urlencode "query=SELECT * WHERE { ?s ?p ?o } LIMIT 10"
+```
+
+### Loading RDF Data
+
+```bash
+# Load a Turtle file into the default graph
+curl -X PUT \
+  -H "Content-Type: text/turtle" \
+  --data-binary @data.ttl \
+  "$FUSEKI_URL/$FUSEKI_DATASET/data"
+
+# Add data without replacing existing triples (POST)
+curl -X POST \
+  -H "Content-Type: text/turtle" \
+  --data-binary @more-data.ttl \
+  "$FUSEKI_URL/$FUSEKI_DATASET/data"
+
+# Load into a named graph
+curl -X PUT \
+  -H "Content-Type: text/turtle" \
+  --data-binary @data.ttl \
+  "$FUSEKI_URL/$FUSEKI_DATASET/data?graph=http://example.org/mygraph"
+```
+
+### SPARQL Update
+
+```bash
+# Insert triples via SPARQL Update
+curl -X POST \
+  -H "Content-Type: application/sparql-update" \
+  -d "INSERT DATA { <http://example.org/s> <http://example.org/p> \"o\" . }" \
+  "$FUSEKI_URL/$FUSEKI_DATASET/update"
+```
+
+### Dataset Management
+
+```bash
+# List all datasets (requires admin credentials)
+curl -u "admin:$FUSEKI_ADMIN_PASSWORD" "$FUSEKI_URL/\$/datasets"
+
+# Create a new TDB2-backed dataset
+curl -X POST \
+  -u "admin:$FUSEKI_ADMIN_PASSWORD" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "dbName=mydata&dbType=tdb2" \
+  "$FUSEKI_URL/\$/datasets"
+
+# Delete a dataset
+curl -X DELETE \
+  -u "admin:$FUSEKI_ADMIN_PASSWORD" \
+  "$FUSEKI_URL/\$/datasets/mydata"
+```
+
+### Admin UI
+
+```bash
+# Open in browser (from the host machine)
+open http://localhost:3030
+```
+
+Log in with username `admin` and the configured `FUSEKI_ADMIN_PASSWORD`. From the UI you can browse and query datasets, upload RDF files, create/delete datasets, and monitor server statistics.
+
+## Use Cases
+
+- **Semantic web development** — Prototype and test OWL/RDFS ontologies and SPARQL queries locally
+- **Linked data applications** — Build applications that consume or publish RDF data
+- **Knowledge graph projects** — Store, update, and query knowledge graphs during development
+- **Data integration** — Use SPARQL Federation or CONSTRUCT queries to merge heterogeneous data sources
+- **Research and education** — Run SPARQL 1.1 workloads without a cloud account
+
+**Integrates well with:**
+
+- `java` — Use Apache Jena client library (`jena-arq`) for typed SPARQL queries
+- `python` — Use `SPARQLWrapper` or `rdflib-endpoint` for data science workflows
+- `nodejs` — Use `n3` or `comunica` for JavaScript/TypeScript SPARQL clients
+
+## Configuration
+
+### Environment Variables
+
+The overlay includes a `.env.example` file. Copy and customize:
+
+```bash
+cd .devcontainer
+cp .env.example .env
+```
+
+**Default values (`.devcontainer/.env.example`):**
+
+```bash
+FUSEKI_VERSION=latest
+FUSEKI_PORT=3030
+FUSEKI_ADMIN_PASSWORD=admin   # ⚠ Change this for any shared environment
+FUSEKI_DATASET=ds
+```
+
+⚠️ **Security:** The default `FUSEKI_ADMIN_PASSWORD=admin` must be changed for any environment accessible beyond localhost.
+
+### SPARQL Endpoints
+
+Default dataset `ds` endpoints (from inside the dev container):
+
+| Endpoint          | URL                            |
+| ----------------- | ------------------------------ |
+| SPARQL Query      | `http://fuseki:3030/ds/query`  |
+| SPARQL Update     | `http://fuseki:3030/ds/update` |
+| Graph Store (GSP) | `http://fuseki:3030/ds/data`   |
+| Admin UI          | `http://fuseki:3030`           |
+
+All endpoints are also forwarded to `localhost:3030` on the host machine.
+
+## References
+
+- [Apache Jena Fuseki Documentation](https://jena.apache.org/documentation/fuseki2/)
+- [SPARQL 1.1 Query Language](https://www.w3.org/TR/sparql11-query/)
+- [SPARQL 1.1 Update](https://www.w3.org/TR/sparql11-update/)
+- [Fuseki Docker Image (stain/jena-docker)](https://github.com/stain/jena-docker)
+- [Apache Jena TDB2](https://jena.apache.org/documentation/tdb2/)
+
+**Related Overlays:**
+
+- `java` — Develop JVM applications using Apache Jena client libraries
+- `python` — Use RDFLib or SPARQLWrapper for Python-based SPARQL workflows
+- `nodejs` — Build JavaScript SPARQL clients with Comunica or N3.js

package/overlays/fuseki/devcontainer.patch.json

@@ -0,0 +1,18 @@
+{
+    "$schema": "https://raw.githubusercontent.com/devcontainers/spec/main/schemas/devContainer.base.schema.json",
+    "runServices": ["fuseki"],
+    "forwardPorts": [3030],
+    "portsAttributes": {
+        "3030": {
+            "label": "Fuseki SPARQL Server",
+            "onAutoForward": "openBrowser"
+        }
+    },
+    "remoteEnv": {
+        "FUSEKI_HOST": "fuseki",
+        "FUSEKI_PORT": "3030",
+        "FUSEKI_DATASET": "{{cs.FUSEKI_DATASET}}",
+        "FUSEKI_ADMIN_PASSWORD": "{{cs.FUSEKI_ADMIN_PASSWORD}}",
+        "FUSEKI_URL": "http://fuseki:3030"
+    }
+}

package/overlays/fuseki/docker-compose.yml

@@ -0,0 +1,29 @@
+version: '3.8'
+
+services:
+    fuseki:
+        image: stain/jena-fuseki:${FUSEKI_VERSION:-{{cs.FUSEKI_VERSION}}}
+        restart: unless-stopped
+        volumes:
+            - fuseki-data:/fuseki
+        environment:
+            ADMIN_PASSWORD: ${FUSEKI_ADMIN_PASSWORD:-{{cs.FUSEKI_ADMIN_PASSWORD}}}
+            FUSEKI_DATASET_1: ${FUSEKI_DATASET:-{{cs.FUSEKI_DATASET}}}
+            TDB: '2'
+        ports:
+            - '${FUSEKI_PORT:-{{cs.FUSEKI_PORT}}}:3030'
+        networks:
+            - devnet
+        healthcheck:
+            test: ['CMD-SHELL', 'curl -sf http://localhost:3030/$/ping || exit 1']
+            interval: 10s
+            timeout: 5s
+            retries: 5
+            start_period: 20s
+
+volumes:
+    fuseki-data:
+
+networks:
+    devnet:
+        name: devnet

package/overlays/fuseki/overlay.yml

@@ -0,0 +1,42 @@
+id: fuseki
+name: Apache Jena Fuseki
+description: SPARQL 1.1 server and triplestore backed by Apache Jena TDB
+category: database
+supports:
+    - compose
+requires: []
+suggests:
+    - java
+    - python
+    - nodejs
+conflicts: []
+serviceOrder: 0
+tags:
+    - database
+    - rdf
+    - sparql
+    - triplestore
+    - semantic-web
+    - linked-data
+    - jena
+ports:
+    - port: 3030
+      service: fuseki
+      protocol: http
+      description: Fuseki SPARQL server and admin UI
+      path: /
+      onAutoForward: openBrowser
+parameters:
+    FUSEKI_VERSION:
+        description: Apache Jena Fuseki image version tag
+        default: latest
+    FUSEKI_PORT:
+        description: Host port mapped to Fuseki (3030 inside container)
+        default: '3030'
+    FUSEKI_ADMIN_PASSWORD:
+        description: Fuseki admin user password
+        default: admin
+        sensitive: true
+    FUSEKI_DATASET:
+        description: Name of the default dataset to create on first start
+        default: ds