codeforge-dev 1.5.8 → 1.8.0

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"
   }

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/scripts/format-on-stop.py

@@ -5,9 +5,17 @@ Unified batch formatter — runs as a Stop hook.
 Reads file paths collected by collect-edited-files.py during the
 conversation turn, deduplicates them, and formats each based on
 extension:
-  .py / .pyi       → Black
-  .go              → gofmt
-  .js/.jsx/.ts/.tsx/.mjs/.cjs/.mts/.cts/.css → Biome (safe mode)
+  .py / .pyi                                → Ruff format (fallback: Black)
+  .go                                       → gofmt
+  .js/.jsx/.ts/.tsx/.mjs/.cjs/.mts/.cts     → Biome check --write
+  .css/.json/.jsonc/.graphql/.gql           → Biome check --write
+  .html/.vue/.svelte/.astro                 → Biome check --write
+  .sh/.bash/.zsh/.mksh/.bats               → shfmt -w
+  .md/.markdown                             → dprint fmt
+  .yaml/.yml                                → dprint fmt
+  .toml                                     → dprint fmt
+  Dockerfile / .dockerfile                  → dprint fmt
+  .rs                                       → rustfmt
 
 Always cleans up the temp file. Always exits 0.
 """
@@ -18,7 +26,8 @@ import subprocess
 import sys
 from pathlib import Path
 
-# Formatter dispatch by extension
+# ── Extension sets ──────────────────────────────────────────────────
+
 PYTHON_EXTS = {".py", ".pyi"}
 GO_EXTS = {".go"}
 BIOME_EXTS = {
@@ -31,10 +40,39 @@ BIOME_EXTS = {
     ".mts",
     ".cts",
     ".css",
+    ".json",
+    ".jsonc",
+    ".graphql",
+    ".gql",
+    ".html",
+    ".vue",
+    ".svelte",
+    ".astro",
 }
+SHELL_EXTS = {".sh", ".bash", ".zsh", ".mksh", ".bats"}
+DPRINT_EXTS = {".md", ".markdown", ".yaml", ".yml", ".toml"}
+RUST_EXTS = {".rs"}
+
+# ── Fallback paths ──────────────────────────────────────────────────
 
-BLACK_PATH = "/usr/local/py-utils/bin/black"
-GOFMT_PATH = "/usr/local/go/bin/gofmt"
+BLACK_PATH_FALLBACK = "/usr/local/py-utils/bin/black"
+GOFMT_PATH_FALLBACK = "/usr/local/go/bin/gofmt"
+DPRINT_CONFIG = "/usr/local/share/dprint/dprint.json"
+
+# ── Tool resolution ─────────────────────────────────────────────────
+
+
+def _resolve_tool(name: str, fallback: str = "") -> str | None:
+    """Find tool via PATH first, fall back to hardcoded path."""
+    try:
+        result = subprocess.run(["which", name], capture_output=True, text=True)
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except Exception:
+        pass
+    if fallback and os.path.exists(fallback):
+        return fallback
+    return None
 
 
 def find_tool_upward(file_path: str, tool_name: str) -> str | None:
@@ -74,13 +112,30 @@ def find_biome(file_path: str) -> str | None:
     return find_global_tool("biome")
 
 
+# ── Formatters ──────────────────────────────────────────────────────
+
+
 def format_python(file_path: str) -> None:
-    """Format with Black (quiet mode)."""
-    if not os.path.exists(BLACK_PATH):
+    """Format with Ruff (preferred) or Black (fallback)."""
+    ruff = _resolve_tool("ruff")
+    if ruff:
+        try:
+            subprocess.run(
+                [ruff, "format", "--quiet", file_path],
+                capture_output=True,
+                timeout=10,
+            )
+            return
+        except (subprocess.TimeoutExpired, OSError):
+            pass
+
+    # Fallback to Black
+    black = _resolve_tool("black", BLACK_PATH_FALLBACK)
+    if not black:
         return
     try:
         subprocess.run(
-            [BLACK_PATH, "--quiet", file_path],
+            [black, "--quiet", file_path],
             capture_output=True,
             timeout=10,
         )
@@ -90,11 +145,12 @@ def format_python(file_path: str) -> None:
 
 def format_go(file_path: str) -> None:
     """Format with gofmt."""
-    if not os.path.exists(GOFMT_PATH):
+    gofmt = _resolve_tool("gofmt", GOFMT_PATH_FALLBACK)
+    if not gofmt:
         return
     try:
         subprocess.run(
-            [GOFMT_PATH, "-w", file_path],
+            [gofmt, "-w", file_path],
             capture_output=True,
             timeout=10,
         )
@@ -117,15 +173,79 @@ def format_biome(file_path: str) -> None:
         pass
 
 
+def format_shell(file_path: str) -> None:
+    """Format with shfmt."""
+    shfmt = _resolve_tool("shfmt")
+    if not shfmt:
+        return
+    try:
+        subprocess.run(
+            [shfmt, "-w", file_path],
+            capture_output=True,
+            timeout=10,
+        )
+    except (subprocess.TimeoutExpired, OSError):
+        pass
+
+
+def format_dprint(file_path: str) -> None:
+    """Format with dprint using the global config."""
+    dprint = _resolve_tool("dprint")
+    if not dprint:
+        return
+    if not os.path.isfile(DPRINT_CONFIG):
+        return
+    try:
+        subprocess.run(
+            [dprint, "fmt", "--config", DPRINT_CONFIG, file_path],
+            capture_output=True,
+            timeout=10,
+        )
+    except (subprocess.TimeoutExpired, OSError):
+        pass
+
+
+def format_rust(file_path: str) -> None:
+    """Format with rustfmt (conditional — only if installed)."""
+    rustfmt = _resolve_tool("rustfmt")
+    if not rustfmt:
+        return
+    try:
+        subprocess.run(
+            [rustfmt, file_path],
+            capture_output=True,
+            timeout=10,
+        )
+    except (subprocess.TimeoutExpired, OSError):
+        pass
+
+
+# ── Dispatch ────────────────────────────────────────────────────────
+
+
 def format_file(file_path: str) -> None:
-    """Dispatch to the correct formatter based on extension."""
-    ext = Path(file_path).suffix.lower()
+    """Dispatch to the correct formatter based on extension / filename."""
+    path = Path(file_path)
+    ext = path.suffix.lower()
+    name = path.name
+
     if ext in PYTHON_EXTS:
         format_python(file_path)
     elif ext in GO_EXTS:
         format_go(file_path)
     elif ext in BIOME_EXTS:
         format_biome(file_path)
+    elif ext in SHELL_EXTS:
+        format_shell(file_path)
+    elif ext in DPRINT_EXTS:
+        format_dprint(file_path)
+    elif ext in RUST_EXTS:
+        format_rust(file_path)
+    elif name == "Dockerfile" or ext == ".dockerfile":
+        format_dprint(file_path)
+
+
+# ── Main ────────────────────────────────────────────────────────────
 
 
 def main():

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

@@ -1,6 +1,6 @@
 {
   "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)",
   "author": {
     "name": "AnExiledDev"
   }

package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/hooks/hooks.json

@@ -1,15 +1,14 @@
 {
-  "description": "Auto-lint files after editing",
+  "description": "Batch-lint collected files when Claude stops responding",
   "hooks": {
-    "PostToolUse": [
+    "Stop": [
       {
-        "matcher": "Edit|Write",
+        "matcher": "",
         "hooks": [
           {
             "type": "command",
             "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lint-file.py",
-            "timeout": 15,
-            "async": true
+            "timeout": 60
           }
         ]
       }