codeforge-dev 1.7.0 → 1.8.0

package/.devcontainer/features/mcp-qdrant/install.sh

@@ -4,6 +4,14 @@ set -euo pipefail
 # Import options from devcontainer-feature.json
 # NOTE: DevContainer converts camelCase options to UPPERCASE without underscores
 # Example: "qdrantUrl" becomes $QDRANTURL (not $QDRANT_URL)
+VERSION="${VERSION:-latest}"
+
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[mcp-qdrant] Skipping installation (version=none)"
+    exit 0
+fi
+
 QDRANT_URL="${QDRANTURL:-}"
 QDRANT_API_KEY="${QDRANTAPIKEY:-}"
 QDRANT_LOCAL_PATH="${QDRANTLOCALPATH:-/workspaces/.qdrant/storage}"
@@ -76,7 +84,7 @@ pip uninstall hf-xet -y 2>/dev/null || true
 # Pre-download the embedding model from GCS (more reliable than HuggingFace Hub in containers)
 # This is critical to avoid network timeouts from huggingface_hub
 echo "[mcp-qdrant] Pre-downloading embedding model from GCS..."
-FASTEMBED_CACHE="/tmp/fastembed_cache"
+FASTEMBED_CACHE="/workspaces/.qdrant/fastembed_cache"
 mkdir -p "${FASTEMBED_CACHE}"
 
 # Map embedding model names to GCS URLs and legacy cache directory names
@@ -117,8 +125,7 @@ if [ -n "${MODEL_URL}" ]; then
             # Remove macOS extended attribute files
             find "${FASTEMBED_CACHE}" -name "._*" -delete 2>/dev/null || true
             rm -f "${TEMP_TAR}"
-            # Make cache world-readable/writable since it's in /tmp
-            chmod -R 777 "${FASTEMBED_CACHE}" 2>/dev/null || true
+            chmod -R 755 "${FASTEMBED_CACHE}" 2>/dev/null || true
             echo "[mcp-qdrant] ✓ Embedding model pre-downloaded to ${FASTEMBED_CACHE}/${MODEL_DIR}"
         else
             echo "[mcp-qdrant] WARNING: Failed to download model from GCS"
@@ -208,7 +215,7 @@ if [ -n "$QDRANT_URL" ]; then
             args: ["mcp-server-qdrant"],
             env: {
                 HF_HUB_OFFLINE: "1",
-                FASTEMBED_CACHE_PATH: "/tmp/fastembed_cache",
+                FASTEMBED_CACHE_PATH: "/workspaces/.qdrant/fastembed_cache",
                 QDRANT_URL: $url,
                 QDRANT_API_KEY: $key,
                 COLLECTION_NAME: $collection
@@ -224,7 +231,7 @@ else
             args: ["mcp-server-qdrant"],
             env: {
                 HF_HUB_OFFLINE: "1",
-                FASTEMBED_CACHE_PATH: "/tmp/fastembed_cache",
+                FASTEMBED_CACHE_PATH: "/workspaces/.qdrant/fastembed_cache",
                 QDRANT_LOCAL_PATH: $path,
                 COLLECTION_NAME: $collection
             }
@@ -250,7 +257,7 @@ fi
 
 # Set proper permissions
 chmod 644 "$SETTINGS_FILE"
-chown vscode:vscode "$SETTINGS_FILE" 2>/dev/null || true
+chown "$(id -un):$(id -gn)" "$SETTINGS_FILE" 2>/dev/null || true
 
 echo "[mcp-qdrant] ✓ Configuration complete"
 HOOK_EOF

package/.devcontainer/features/mcp-reasoner/devcontainer-feature.json

@@ -6,6 +6,11 @@
   "maintainer": "AnExiledDev",
   "documentationURL": "https://github.com/Jacck/mcp-reasoner",
   "options": {
+    "version": {
+      "type": "string",
+      "description": "Version to install (or 'none' to skip installation)",
+      "default": "latest"
+    },
     "username": {
       "type": "string",
       "description": "Container user to install for",

package/.devcontainer/features/mcp-reasoner/install.sh

@@ -4,8 +4,15 @@ set -euo pipefail
 # No cleanup needed - using CLI instead of temp files
 
 # Import options
+VERSION="${VERSION:-latest}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[mcp-reasoner] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[mcp-reasoner] Starting MCP Reasoner installation..."
 
 # Source NVM (Node is installed via NVM by the node feature)
@@ -145,7 +152,7 @@ fi
 
 # Set proper permissions
 chmod 644 "$SETTINGS_FILE"
-chown vscode:vscode "$SETTINGS_FILE" 2>/dev/null || true
+chown "$(id -un):$(id -gn)" "$SETTINGS_FILE" 2>/dev/null || true
 
 echo "[mcp-reasoner] ✓ Configuration complete"
 HOOK_EOF

package/.devcontainer/features/notify-hook/devcontainer-feature.json

@@ -5,6 +5,11 @@
   "description": "Desktop notifications and audio chime when Claude finishes responding",
   "documentationURL": "https://github.com/AnExiledDev/CodeForge",
   "options": {
+    "version": {
+      "type": "string",
+      "description": "Version to install (or 'none' to skip installation)",
+      "default": "latest"
+    },
     "enableBell": {
       "type": "boolean",
       "description": "Enable terminal bell (audio chime) on completion",

package/.devcontainer/features/notify-hook/install.sh

@@ -1,9 +1,16 @@
 #!/bin/bash
 set -euo pipefail
 
+VERSION="${VERSION:-latest}"
 ENABLEBELL="${ENABLEBELL:-true}"
 ENABLEOSC="${ENABLEOSC:-true}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[notify-hook] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[notify-hook] Starting installation..."
 echo "[notify-hook] Bell enabled: ${ENABLEBELL}"
 echo "[notify-hook] OSC notifications enabled: ${ENABLEOSC}"

package/.devcontainer/features/ruff/README.md

@@ -0,0 +1,26 @@
+# Ruff
+
+Fast Python linter and formatter, replacing Black + Flake8.
+
+## What It Does
+
+Installs [Ruff](https://docs.astral.sh/ruff/) via `uv tool install`. Ruff is an extremely fast Python linter and formatter written in Rust, compatible with Flake8, isort, and Black rules.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `latest` | Ruff version to install. Set `"none"` to skip. |
+| `username` | `automatic` | Container user to install for. |
+
+## Usage
+
+```bash
+ruff check .              # lint
+ruff check --fix .        # lint and auto-fix
+ruff format .             # format (Black-compatible)
+```
+
+## Configuration
+
+Used by both `auto-formatter` (formatting) and `auto-linter` (linting) plugins for Python files. For project-specific config, add a `[tool.ruff]` section to `pyproject.toml` or create a `ruff.toml`. See [Ruff docs](https://docs.astral.sh/ruff/configuration/).

package/.devcontainer/features/ruff/devcontainer-feature.json

@@ -0,0 +1,21 @@
+{
+  "id": "ruff",
+  "version": "1.0.0",
+  "name": "Ruff",
+  "description": "Fast Python linter and formatter (replaces Black + Flake8)",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "latest",
+      "description": "Ruff version to install"
+    },
+    "username": {
+      "type": "string",
+      "default": "automatic",
+      "description": "Container user to install for"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers-extra/features/uv"
+  ]
+}

package/.devcontainer/features/ruff/install.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# Ruff DevContainer Feature
+# Installs via uv tool install
+# ==============================
+
+RUFF_VERSION="${VERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+# Skip installation if version is "none"
+if [ "${RUFF_VERSION}" = "none" ]; then
+    echo "[ruff] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[ruff] Starting installation..."
+
+# ---------- USER ----------
+if [[ "${USERNAME}" == "auto" || "${USERNAME}" == "automatic" ]]; then
+    for u in vscode node codespace; do
+        if id -u "$u" >/dev/null 2>&1; then
+            USERNAME="$u"
+            break
+        fi
+    done
+    USERNAME="${USERNAME:-root}"
+fi
+
+USER_HOME="$(eval echo "~${USERNAME}")"
+
+echo "[ruff] Target user: ${USERNAME}"
+echo "[ruff] Version: ${RUFF_VERSION}"
+
+run_as_user() {
+    sudo -u "${USERNAME}" env \
+        HOME="${USER_HOME}" \
+        "$@"
+}
+
+# ---------- UV DISCOVERY ----------
+find_uv() {
+    command -v uv 2>/dev/null && return 0
+    for p in /usr/local/bin/uv /usr/bin/uv /opt/uv/bin/uv; do
+        [[ -x "$p" ]] && echo "$p" && return 0
+    done
+    find /usr /opt -maxdepth 4 -type f -name uv -executable 2>/dev/null | head -n 1
+}
+
+# ---------- INSTALL ----------
+UV_BIN="$(find_uv || true)"
+if [[ -z "${UV_BIN}" ]]; then
+    echo "[ruff] ERROR: uv is not installed" >&2
+    exit 1
+fi
+
+echo "[ruff] Using uv at: ${UV_BIN}"
+
+if [[ "${RUFF_VERSION}" == "latest" ]]; then
+    run_as_user "${UV_BIN}" tool install ruff
+else
+    run_as_user "${UV_BIN}" tool install "ruff==${RUFF_VERSION}"
+fi
+
+# ---------- VERIFY ----------
+BIN_DIR="${USER_HOME}/.local/bin"
+if [[ -x "${BIN_DIR}/ruff" ]]; then
+    INSTALLED="$("${BIN_DIR}/ruff" --version 2>/dev/null || echo "unknown")"
+    echo "[ruff] Installed: ${INSTALLED}"
+else
+    echo "[ruff] ERROR: ruff not found in ${BIN_DIR}" >&2
+    exit 1
+fi

package/.devcontainer/features/shellcheck/README.md

@@ -0,0 +1,38 @@
+# ShellCheck
+
+Static analysis tool for shell scripts.
+
+## What It Does
+
+Installs [ShellCheck](https://www.shellcheck.net/) via apt. ShellCheck finds bugs and style issues in bash/sh/zsh scripts, catching common pitfalls like unquoted variables, incorrect test syntax, and POSIX compatibility issues.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `latest` | Version to install (or `"none"` to skip). |
+
+## Usage
+
+```bash
+shellcheck script.sh
+shellcheck -x script.sh           # follow source'd files
+shellcheck -f json script.sh      # JSON output
+shellcheck -e SC2086 script.sh    # exclude specific rule
+```
+
+## Configuration
+
+Used by the `auto-linter` plugin to lint shell scripts. For per-file directives, add comments at the top of your script:
+
+```bash
+# shellcheck disable=SC2086
+# shellcheck shell=bash
+```
+
+For project-wide config, create a `.shellcheckrc`:
+
+```
+disable=SC2086,SC2034
+shell=bash
+```

package/.devcontainer/features/shellcheck/devcontainer-feature.json

@@ -0,0 +1,13 @@
+{
+  "id": "shellcheck",
+  "version": "1.0.0",
+  "name": "ShellCheck",
+  "description": "Static analysis tool for shell scripts",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "Version to install (or 'none' to skip installation)",
+      "default": "latest"
+    }
+  }
+}

package/.devcontainer/features/shellcheck/install.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# ShellCheck DevContainer Feature
+# Installed via apt
+# ==============================
+
+VERSION="${VERSION:-latest}"
+
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[shellcheck] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[shellcheck] Starting installation..."
+
+apt-get update -y
+apt-get install -y --no-install-recommends shellcheck
+apt-get clean -y
+rm -rf /var/lib/apt/lists/*
+
+echo "[shellcheck] Installed: $(shellcheck --version 2>/dev/null | head -2 || echo 'unknown')"

package/.devcontainer/features/shfmt/README.md

@@ -0,0 +1,37 @@
+# shfmt
+
+Shell script formatter supporting bash, mksh, and POSIX sh.
+
+## What It Does
+
+Installs [shfmt](https://github.com/mvdan/sh) as a static binary. shfmt formats shell scripts consistently, supporting bash, mksh, and POSIX sh dialects.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `v3.12.0` | shfmt version to install. Set `"latest"` for newest, `"none"` to skip. |
+
+## Usage
+
+```bash
+shfmt script.sh              # print formatted output
+shfmt -w script.sh           # format in place
+shfmt -d script.sh           # show diff
+shfmt -i 4 script.sh         # use 4-space indent
+shfmt -l .                   # list files that need formatting
+```
+
+## Configuration
+
+Used by the `auto-formatter` plugin for shell script formatting. Default formatting uses shfmt's defaults (tabs for indentation). For project-specific config, create an `.editorconfig`:
+
+```ini
+[*.sh]
+indent_style = space
+indent_size = 4
+```
+
+## Checksum Verification
+
+Downloads are verified against `sha256sums.txt` published with each GitHub release.

package/.devcontainer/features/shfmt/devcontainer-feature.json

@@ -0,0 +1,13 @@
+{
+  "id": "shfmt",
+  "version": "1.0.0",
+  "name": "shfmt",
+  "description": "Shell script formatter supporting bash, mksh, and POSIX sh",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "v3.12.0",
+      "description": "shfmt version to install. Set 'latest' to always get newest."
+    }
+  }
+}

package/.devcontainer/features/shfmt/install.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# shfmt DevContainer Feature
+# Direct binary from GitHub releases
+# ==============================
+
+SHFMT_VERSION="${VERSION:-latest}"
+
+# Skip installation if version is "none"
+if [ "${SHFMT_VERSION}" = "none" ]; then
+    echo "[shfmt] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[shfmt] Starting installation..."
+
+# ---------- HELPERS ----------
+download_with_retry() {
+    local url="$1" dest="$2" retries="${3:-3}" delay="${4:-2}"
+    local attempt=1
+    while [ $attempt -le $retries ]; do
+        if curl -fsSL ${GITHUB_AUTH_HEADER:-} "$url" -o "$dest" 2>/dev/null; then
+            return 0
+        fi
+        echo "[shfmt] Download attempt $attempt/$retries failed, retrying in ${delay}s..."
+        sleep "$delay"
+        attempt=$((attempt + 1))
+        delay=$((delay * 2))
+    done
+    echo "[shfmt] ERROR: Download failed after $retries attempts: $url"
+    return 1
+}
+
+# GitHub API auth header (avoids rate limiting)
+GITHUB_AUTH_HEADER=""
+if [ -n "${GH_TOKEN:-}" ] || [ -n "${GITHUB_TOKEN:-}" ]; then
+    GITHUB_AUTH_HEADER="-H Authorization: token ${GH_TOKEN:-$GITHUB_TOKEN}"
+fi
+
+ARCH="$(dpkg --print-architecture)"
+case "${ARCH}" in
+    amd64) GOARCH="amd64" ;;
+    arm64) GOARCH="arm64" ;;
+    *)
+        echo "[shfmt] ERROR: Unsupported architecture: ${ARCH}" >&2
+        exit 1
+        ;;
+esac
+
+# Version pinned for reproducible builds. Set "latest" to always get newest.
+if [[ "${SHFMT_VERSION}" == "latest" ]]; then
+    SHFMT_VERSION="$(curl -fsSL ${GITHUB_AUTH_HEADER:-} https://api.github.com/repos/mvdan/sh/releases/latest | grep -o '"tag_name": *"[^"]*"' | head -1 | cut -d'"' -f4)"
+    echo "[shfmt] Resolved latest version: ${SHFMT_VERSION}"
+fi
+
+URL="https://github.com/mvdan/sh/releases/download/${SHFMT_VERSION}/shfmt_${SHFMT_VERSION}_linux_${GOARCH}"
+echo "[shfmt] Downloading from: ${URL}"
+
+TMP_DIR="$(mktemp -d)"
+download_with_retry "${URL}" "${TMP_DIR}/shfmt"
+
+# ---------- CHECKSUM VERIFICATION ----------
+CHECKSUM_URL="https://github.com/mvdan/sh/releases/download/${SHFMT_VERSION}/sha256sums.txt"
+if curl -fsSL "${CHECKSUM_URL}" -o "${TMP_DIR}/checksums.txt" 2>/dev/null; then
+    EXPECTED=$(grep "shfmt_${SHFMT_VERSION}_linux_${GOARCH}" "${TMP_DIR}/checksums.txt" | awk '{print $1}')
+    ACTUAL=$(sha256sum "${TMP_DIR}/shfmt" | cut -d' ' -f1)
+    if [ -n "$EXPECTED" ] && [ "$ACTUAL" != "$EXPECTED" ]; then
+        echo "[shfmt] ERROR: Checksum verification failed"
+        echo "  Expected: $EXPECTED"
+        echo "  Actual:   $ACTUAL"
+        rm -rf "${TMP_DIR}"
+        exit 1
+    fi
+    echo "[shfmt] Checksum verified"
+else
+    echo "[shfmt] WARNING: Could not fetch checksums, skipping verification"
+fi
+
+cp "${TMP_DIR}/shfmt" /usr/local/bin/shfmt
+chmod +x /usr/local/bin/shfmt
+rm -rf "${TMP_DIR}"
+
+echo "[shfmt] Installed: $(shfmt --version 2>/dev/null || echo 'unknown')"

package/.devcontainer/features/splitrail/devcontainer-feature.json

@@ -6,6 +6,11 @@
   "maintainer": "AnExiledDev",
   "documentationURL": "https://github.com/Piebald-AI/splitrail",
   "options": {
+    "version": {
+      "type": "string",
+      "description": "Version to install (or 'none' to skip installation)",
+      "default": "latest"
+    },
     "repoUrl": {
       "type": "string",
       "description": "Git repository URL for splitrail",

package/.devcontainer/features/splitrail/install.sh

@@ -9,10 +9,17 @@ trap cleanup EXIT
 
 # Import options
 # NOTE: DevContainer converts camelCase to UPPERCASE without underscores
+VERSION="${VERSION:-latest}"
 REPO_URL="${REPOURL:-https://github.com/Piebald-AI/splitrail.git}"
 BRANCH="${BRANCH:-main}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[splitrail] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[splitrail] Starting Splitrail installation..."
 
 # Validate git is available

package/.devcontainer/features/tmux/install.sh

@@ -1,6 +1,14 @@
 #!/bin/bash
 set -e
 
+VERSION="${VERSION:-latest}"
+
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[tmux] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "Installing tmux for Claude Code Agent Teams..."
 
 # Install tmux via apt

package/.devcontainer/features/tree-sitter/install.sh

@@ -9,6 +9,12 @@ INSTALL_CLI="${INSTALLCLI:-true}"
 GRAMMARS="${GRAMMARS:-}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[tree-sitter] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[tree-sitter] Starting tree-sitter installation..."
 echo "[tree-sitter] Options: version=${VERSION}, bindings=${BINDINGS}, cli=${INSTALL_CLI}"
 

package/.devcontainer/plugins/devs-marketplace/.claude-plugin/marketplace.json

@@ -60,13 +60,6 @@
       "source": "./plugins/notify-hook",
       "category": "productivity"
     },
-    {
-      "name": "planning-reminder",
-      "description": "Encourages plan-before-implement workflow",
-      "version": "1.0.0",
-      "source": "./plugins/planning-reminder",
-      "category": "workflow"
-    },
     {
       "name": "dangerous-command-blocker",
       "description": "Blocks dangerous bash commands (rm -rf, sudo rm, chmod 777, force push)",
@@ -83,21 +76,21 @@
     },
     {
       "name": "auto-formatter",
-      "description": "Auto-formats files after editing (black for Python, gofmt for Go)",
+      "description": "Batch-formats edited files at Stop (Ruff for Python, gofmt for Go, Biome for JS/TS/CSS/JSON/GraphQL/HTML, shfmt for Shell, dprint for Markdown/YAML/TOML/Dockerfile, rustfmt for Rust)",
       "version": "1.0.0",
       "source": "./plugins/auto-formatter",
       "category": "development"
     },
     {
       "name": "auto-linter",
-      "description": "Auto-lints files after editing (pyright for Python)",
+      "description": "Auto-lints edited files at Stop (Pyright + Ruff for Python, Biome for JS/TS/CSS/GraphQL, ShellCheck for Shell, go vet for Go, hadolint for Dockerfile, clippy for Rust)",
       "version": "1.0.0",
       "source": "./plugins/auto-linter",
       "category": "development"
     },
     {
       "name": "code-directive",
-      "description": "Coding standards and skills for the CodeDirective project",
+      "description": "17 custom agents, 16 coding skills, agent redirection, syntax validation, and skill auto-suggestion",
       "version": "1.0.0",
       "source": "./plugins/code-directive",
       "category": "development"

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "auto-formatter",
-  "description": "Batch-formats edited files at Stop (Black for Python, gofmt for Go, Biome for JS/TS/CSS)",
+  "description": "Batch-formats edited files at Stop (Ruff for Python, gofmt for Go, Biome for JS/TS/CSS/JSON/GraphQL/HTML, shfmt for Shell, dprint for Markdown/YAML/TOML/Dockerfile, rustfmt for Rust)",
   "author": {
     "name": "AnExiledDev"
   }