codeforge-dev 1.4.0

package/.devcontainer/features/claude-monitor/install.sh

@@ -0,0 +1,99 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# Claude Monitor DevContainer Feature
+# ABSOLUTE, PATH-INDEPENDENT
+# ==============================
+
+MONITOR_VERSION="${VERSION:-latest}"
+INSTALLER="${INSTALLER:-uv}"
+USERNAME="${USERNAME:-automatic}"
+
+echo "[claude-monitor] 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 "[claude-monitor] Target user: ${USERNAME}"
+echo "[claude-monitor] Home: ${USER_HOME}"
+echo "[claude-monitor] Installer: ${INSTALLER}"
+
+fail() {
+    echo "[claude-monitor] ERROR: $1" >&2
+    exit 1
+}
+
+run_as_user() {
+    sudo -u "${USERNAME}" env \
+        HOME="${USER_HOME}" \
+        "$@"
+}
+
+# ---------- UV DISCOVERY (THE IMPORTANT PART) ----------
+find_uv() {
+    # 1. PATH (if lucky)
+    command -v uv 2>/dev/null && return 0
+    command -v uvx 2>/dev/null && return 0
+
+    # 2. Known devcontainer locations
+    for p in \
+        /usr/local/bin/uv \
+        /usr/bin/uv \
+        /opt/uv/bin/uv \
+        /usr/local/bin/uvx \
+        /usr/bin/uvx \
+        /opt/uv/bin/uvx
+    do
+        [[ -x "$p" ]] && echo "$p" && return 0
+    done
+
+    # 3. Last resort: shallow filesystem scan (bounded, safe)
+    find /usr /opt -maxdepth 4 -type f \( -name uv -o -name uvx \) -executable 2>/dev/null | head -n 1
+}
+
+# ---------- INSTALL ----------
+case "${INSTALLER}" in
+    uv)
+        UV_BIN="$(find_uv || true)"
+        [[ -n "${UV_BIN}" ]] || fail "uv is not installed (devcontainer uv feature missing or broken)"
+
+        echo "[claude-monitor] Using uv at: ${UV_BIN}"
+
+        if [[ "${MONITOR_VERSION}" == "latest" ]]; then
+            run_as_user "${UV_BIN}" tool install claude-monitor
+        else
+            run_as_user "${UV_BIN}" tool install "claude-monitor==${MONITOR_VERSION}"
+        fi
+        ;;
+    *)
+        fail "Only uv is supported in this feature. Use the uv devcontainer feature."
+        ;;
+esac
+
+# === VERIFICATION ===
+echo "[claude-monitor] Verifying installation..."
+
+BIN_DIR="${USER_HOME}/.local/bin"
+
+if [ -x "${BIN_DIR}/claude-monitor" ]; then
+    INSTALLED_VERSION="$("${BIN_DIR}/claude-monitor" --version 2>/dev/null || echo "unknown")"
+    echo "[claude-monitor] ✓ claude-monitor installed (${INSTALLED_VERSION})"
+elif [ -x "${BIN_DIR}/cmonitor" ]; then
+    INSTALLED_VERSION="$("${BIN_DIR}/cmonitor" --version 2>/dev/null || echo "unknown")"
+    echo "[claude-monitor] ✓ cmonitor installed (${INSTALLED_VERSION})"
+else
+    echo "[claude-monitor] ERROR: Executable not found in ${BIN_DIR}"
+    ls -la "${BIN_DIR}" || true
+    exit 1
+fi

package/.devcontainer/features/lsp-servers/README.md

@@ -0,0 +1,85 @@
+# LSP Servers for Claude Code
+
+**Installs language server binaries for Python and TypeScript to enable Claude Code's code intelligence features.**
+
+This feature installs the LSP server binaries that Claude Code's code-intelligence plugins require. The binaries must be in `$PATH` for the plugins to function.
+
+## What Gets Installed
+
+| Language | Binary | Package |
+|----------|--------|---------|
+| Python | `pyright-langserver` | `pyright` |
+| TypeScript | `typescript-language-server` | `typescript-language-server` + `typescript` |
+
+## Usage
+
+Add to your `devcontainer.json`:
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "./features/lsp-servers": {}
+  }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `pyrightVersion` | string | `"latest"` | Pyright package version |
+| `typescriptLspVersion` | string | `"latest"` | typescript-language-server version |
+| `typescriptVersion` | string | `"latest"` | TypeScript package version |
+| `username` | string | `"automatic"` | Container user for fallback install |
+
+## Example with Pinned Versions
+
+```json
+{
+  "features": {
+    "./features/lsp-servers": {
+      "pyrightVersion": "1.1.350",
+      "typescriptLspVersion": "4.3.0",
+      "typescriptVersion": "5.3.0"
+    }
+  }
+}
+```
+
+## Prerequisites
+
+- Node.js feature must be installed first (provides npm)
+
+## Claude Code Plugin Installation
+
+After the container builds, install the Claude Code LSP plugins:
+
+```bash
+claude plugin install pyright-lsp@claude-plugins-official
+claude plugin install typescript-lsp@claude-plugins-official
+```
+
+Or use the `setup-lsp.sh` script which handles this automatically.
+
+## Verification
+
+Check that binaries are available:
+
+```bash
+pyright-langserver --version
+typescript-language-server --version
+```
+
+Check Claude Code plugin status:
+
+```bash
+/plugin
+# Navigate to Errors tab - should show no "Executable not found" errors
+```
+
+## See Also
+
+- [Claude Code: Discover Plugins](https://code.claude.com/docs/en/discover-plugins#code-intelligence)
+- [Pyright](https://github.com/microsoft/pyright)
+- [TypeScript Language Server](https://github.com/typescript-language-server/typescript-language-server)

package/.devcontainer/features/lsp-servers/devcontainer-feature.json

@@ -0,0 +1,40 @@
+{
+  "id": "lsp-servers",
+  "version": "1.0.0",
+  "name": "LSP Servers for Claude Code",
+  "description": "Installs language server binaries for Python (pyright), TypeScript (typescript-language-server), and Go (gopls)",
+  "maintainer": "AnExiledDev",
+  "documentationURL": "https://code.claude.com/docs/en/discover-plugins#code-intelligence",
+  "options": {
+    "pyrightVersion": {
+      "type": "string",
+      "description": "Pyright npm package version (e.g., 'latest', '1.1.350')",
+      "default": "latest"
+    },
+    "typescriptLspVersion": {
+      "type": "string",
+      "description": "typescript-language-server npm package version (e.g., 'latest', '4.3.0')",
+      "default": "latest"
+    },
+    "typescriptVersion": {
+      "type": "string",
+      "description": "TypeScript npm package version (e.g., 'latest', '5.3.0')",
+      "default": "latest"
+    },
+    "goplsVersion": {
+      "type": "string",
+      "description": "gopls version (e.g., 'latest', 'v0.16.0')",
+      "default": "latest"
+    },
+    "username": {
+      "type": "string",
+      "description": "Container user to install for",
+      "default": "automatic"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/common-utils:2",
+    "ghcr.io/devcontainers/features/node:1",
+    "ghcr.io/devcontainers/features/go:1"
+  ]
+}

package/.devcontainer/features/lsp-servers/install.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+# LSP Servers for Claude Code
+# Installs pyright, typescript-language-server, and gopls binaries
+
+set -euo pipefail
+
+PYRIGHT_VERSION="${PYRIGHTVERSION:-latest}"
+TSLSP_VERSION="${TYPESCRIPTLSPVERSION:-latest}"
+TS_VERSION="${TYPESCRIPTVERSION:-latest}"
+GOPLS_VERSION="${GOPLSVERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+echo "[lsp-servers] Starting installation..."
+echo "[lsp-servers] Pyright version: ${PYRIGHT_VERSION}"
+echo "[lsp-servers] TypeScript LSP version: ${TSLSP_VERSION}"
+echo "[lsp-servers] TypeScript version: ${TS_VERSION}"
+echo "[lsp-servers] gopls version: ${GOPLS_VERSION}"
+
+# Source nvm if available
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# Validate npm is available
+if ! command -v npm &>/dev/null; then
+    echo "[lsp-servers] ERROR: npm not available"
+    echo "  Ensure node feature is installed first"
+    exit 1
+fi
+
+# Detect user
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    if [ -n "${_REMOTE_USER:-}" ]; then
+        USERNAME="${_REMOTE_USER}"
+    elif getent passwd vscode >/dev/null 2>&1; then
+        USERNAME="vscode"
+    elif getent passwd node >/dev/null 2>&1; then
+        USERNAME="node"
+    elif getent passwd codespace >/dev/null 2>&1; then
+        USERNAME="codespace"
+    else
+        USERNAME="root"
+    fi
+fi
+
+echo "[lsp-servers] Installing for user: ${USERNAME}"
+
+install_npm_package() {
+    local name="$1"
+    local package="$2"
+    local version="$3"
+
+    if [ "${version}" = "latest" ]; then
+        NPM_PACKAGE="${package}"
+    else
+        NPM_PACKAGE="${package}@${version}"
+    fi
+
+    echo "[lsp-servers] Installing ${name}..."
+    npm install -g "${NPM_PACKAGE}" 2>/dev/null || {
+        echo "[lsp-servers] WARNING: Global install failed for ${name}, trying user install"
+        su - "${USERNAME}" -c "npm install -g ${NPM_PACKAGE}" 2>/dev/null || {
+            echo "[lsp-servers] ERROR: Failed to install ${name}"
+            return 1
+        }
+    }
+}
+
+# Install Pyright (Python LSP)
+install_npm_package "pyright" "pyright" "${PYRIGHT_VERSION}"
+
+# Install TypeScript (required by typescript-language-server)
+install_npm_package "typescript" "typescript" "${TS_VERSION}"
+
+# Install TypeScript Language Server
+install_npm_package "typescript-language-server" "typescript-language-server" "${TSLSP_VERSION}"
+
+# Install gopls (Go LSP) - uses go install since it's a Go package
+echo "[lsp-servers] Installing gopls..."
+if command -v go &>/dev/null; then
+    if [ "${GOPLS_VERSION}" = "latest" ]; then
+        go install "golang.org/x/tools/gopls@latest" || {
+            echo "[lsp-servers] WARNING: Failed to install gopls"
+        }
+    else
+        go install "golang.org/x/tools/gopls@${GOPLS_VERSION}" || {
+            echo "[lsp-servers] WARNING: Failed to install gopls"
+        }
+    fi
+else
+    echo "[lsp-servers] WARNING: Go not available, skipping gopls"
+fi
+
+# Verify installations
+echo ""
+echo "[lsp-servers] Verifying installations..."
+
+if command -v pyright-langserver &>/dev/null; then
+    echo "[lsp-servers] pyright-langserver: $(pyright-langserver --version 2>/dev/null || echo 'installed')"
+else
+    echo "[lsp-servers] WARNING: pyright-langserver not found in PATH"
+fi
+
+if command -v typescript-language-server &>/dev/null; then
+    echo "[lsp-servers] typescript-language-server: $(typescript-language-server --version 2>/dev/null || echo 'installed')"
+else
+    echo "[lsp-servers] WARNING: typescript-language-server not found in PATH"
+fi
+
+if command -v gopls &>/dev/null; then
+    echo "[lsp-servers] gopls: $(gopls version 2>/dev/null | head -1 || echo 'installed')"
+else
+    echo "[lsp-servers] WARNING: gopls not found in PATH (Go may not be installed)"
+fi
+
+echo "[lsp-servers] Installation complete"