codeforge-dev 1.7.0 → 1.9.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

@@ -1,106 +1,106 @@
 {
-  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
-  "name": "devs-marketplace",
-  "description": "CodeForge plugin marketplace for development tools",
-  "owner": {
-    "name": "AnExiledDev"
-  },
-  "plugins": [
-    {
-      "name": "codeforge-lsp",
-      "description": "LSP servers for CodeForge (Python, TypeScript, Go)",
-      "version": "1.0.0",
-      "source": "./plugins/codeforge-lsp",
-      "category": "development",
-      "lspServers": {
-        "pyright": {
-          "command": "pyright-langserver",
-          "args": ["--stdio"],
-          "extensionToLanguage": {
-            ".py": "python",
-            ".pyi": "python"
-          }
-        },
-        "typescript": {
-          "command": "typescript-language-server",
-          "args": ["--stdio"],
-          "extensionToLanguage": {
-            ".ts": "typescript",
-            ".tsx": "typescriptreact",
-            ".js": "javascript",
-            ".jsx": "javascriptreact",
-            ".mts": "typescript",
-            ".cts": "typescript",
-            ".mjs": "javascript",
-            ".cjs": "javascript"
-          }
-        },
-        "gopls": {
-          "command": "gopls",
-          "args": ["serve"],
-          "extensionToLanguage": {
-            ".go": "go",
-            ".mod": "go.mod",
-            ".sum": "go.sum"
-          }
-        }
-      }
-    },
-    {
-      "name": "ticket-workflow",
-      "description": "EARS-based ticket workflow with GitHub integration",
-      "version": "1.0.0",
-      "source": "./plugins/ticket-workflow",
-      "category": "workflow"
-    },
-    {
-      "name": "notify-hook",
-      "description": "Desktop notifications and audio chime when Claude finishes responding",
-      "version": "1.0.0",
-      "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)",
-      "version": "1.0.0",
-      "source": "./plugins/dangerous-command-blocker",
-      "category": "safety"
-    },
-    {
-      "name": "protected-files-guard",
-      "description": "Blocks modifications to .env, lock files, .git/, and credentials",
-      "version": "1.0.0",
-      "source": "./plugins/protected-files-guard",
-      "category": "safety"
-    },
-    {
-      "name": "auto-formatter",
-      "description": "Auto-formats files after editing (black for Python, gofmt for Go)",
-      "version": "1.0.0",
-      "source": "./plugins/auto-formatter",
-      "category": "development"
-    },
-    {
-      "name": "auto-linter",
-      "description": "Auto-lints files after editing (pyright for Python)",
-      "version": "1.0.0",
-      "source": "./plugins/auto-linter",
-      "category": "development"
-    },
-    {
-      "name": "code-directive",
-      "description": "Coding standards and skills for the CodeDirective project",
-      "version": "1.0.0",
-      "source": "./plugins/code-directive",
-      "category": "development"
-    }
-  ]
+	"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+	"name": "devs-marketplace",
+	"description": "CodeForge plugin marketplace for development tools",
+	"owner": {
+		"name": "AnExiledDev"
+	},
+	"plugins": [
+		{
+			"name": "codeforge-lsp",
+			"description": "LSP servers for CodeForge (Python, TypeScript, Go)",
+			"version": "1.0.0",
+			"source": "./plugins/codeforge-lsp",
+			"category": "development",
+			"lspServers": {
+				"pyright": {
+					"command": "pyright-langserver",
+					"args": ["--stdio"],
+					"extensionToLanguage": {
+						".py": "python",
+						".pyi": "python"
+					}
+				},
+				"typescript": {
+					"command": "typescript-language-server",
+					"args": ["--stdio"],
+					"extensionToLanguage": {
+						".ts": "typescript",
+						".tsx": "typescriptreact",
+						".js": "javascript",
+						".jsx": "javascriptreact",
+						".mts": "typescript",
+						".cts": "typescript",
+						".mjs": "javascript",
+						".cjs": "javascript"
+					}
+				},
+				"gopls": {
+					"command": "gopls",
+					"args": ["serve"],
+					"extensionToLanguage": {
+						".go": "go",
+						".mod": "go.mod",
+						".sum": "go.sum"
+					}
+				}
+			}
+		},
+		{
+			"name": "ticket-workflow",
+			"description": "EARS-based ticket workflow with GitHub integration",
+			"version": "1.0.0",
+			"source": "./plugins/ticket-workflow",
+			"category": "workflow"
+		},
+		{
+			"name": "notify-hook",
+			"description": "Desktop notifications and audio chime when Claude finishes responding",
+			"version": "1.0.0",
+			"source": "./plugins/notify-hook",
+			"category": "productivity"
+		},
+		{
+			"name": "dangerous-command-blocker",
+			"description": "Blocks dangerous bash commands (rm -rf, sudo rm, chmod 777, force push)",
+			"version": "1.0.0",
+			"source": "./plugins/dangerous-command-blocker",
+			"category": "safety"
+		},
+		{
+			"name": "protected-files-guard",
+			"description": "Blocks modifications to .env, lock files, .git/, and credentials",
+			"version": "1.0.0",
+			"source": "./plugins/protected-files-guard",
+			"category": "safety"
+		},
+		{
+			"name": "auto-formatter",
+			"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 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": "17 custom agents, 16 coding skills, agent redirection, syntax validation, and skill auto-suggestion",
+			"version": "1.0.0",
+			"source": "./plugins/code-directive",
+			"category": "development"
+		},
+		{
+			"name": "auto-code-quality",
+			"description": "Self-contained code quality: auto-format + auto-lint edited files (Ruff/Black, Biome, gofmt, shfmt, dprint, rustfmt, Pyright, ShellCheck, go vet, hadolint, clippy)",
+			"version": "1.0.0",
+			"source": "./plugins/auto-code-quality",
+			"category": "development"
+		}
+	]
 }

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

@@ -0,0 +1,7 @@
+{
+	"name": "auto-code-quality",
+	"description": "Self-contained code quality plugin: collects edited files, batch-formats at Stop (Ruff/Black 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), batch-lints 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), and validates JSON/JSONC/YAML/TOML syntax on edit",
+	"author": {
+		"name": "AnExiledDev"
+	}
+}

package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/README.md

@@ -0,0 +1,158 @@
+# auto-code-quality
+
+Self-contained Claude Code plugin that automatically formats and lints edited files. Drop it into any Claude Code plugin marketplace and enable it — no other plugins required.
+
+## What It Does
+
+Three-phase pipeline that runs transparently during your Claude Code session:
+
+1. **Collect** (PostToolUse on Edit/Write) — Records which files Claude edits
+2. **Format** (Stop hook) — Batch-formats all edited files when Claude finishes responding
+3. **Lint** (Stop hook) — Batch-lints all edited files and surfaces warnings as context
+
+Additionally validates JSON, JSONC, YAML, and TOML syntax immediately after each edit.
+
+All phases are non-blocking. Missing tools are silently skipped. The plugin always exits cleanly — it will never interrupt Claude.
+
+## Required Tools
+
+Install the tools for the languages you work with. Everything is optional — the plugin gracefully skips any tool that isn't found.
+
+| Language | Formatter | Linter(s) | Install |
+|----------|-----------|-----------|---------|
+| Python | [ruff](https://docs.astral.sh/ruff/) | [pyright](https://github.com/microsoft/pyright), ruff check | `pip install ruff` / `npm i -g pyright` |
+| Python (fallback) | [black](https://github.com/psf/black) | — | `pip install black` |
+| Go | gofmt (bundled with Go) | go vet (bundled with Go) | [Install Go](https://go.dev/dl/) |
+| JS/TS/CSS/GraphQL/HTML | [biome](https://biomejs.dev/) | biome lint | `npm i -D @biomejs/biome` or `npm i -g @biomejs/biome` |
+| Shell | [shfmt](https://github.com/mvdan/sh) | [shellcheck](https://github.com/koalaman/shellcheck) | `brew install shfmt shellcheck` |
+| Markdown/YAML/TOML | [dprint](https://dprint.dev/) | — | `brew install dprint` |
+| Dockerfile | dprint | [hadolint](https://github.com/hadolint/hadolint) | `brew install hadolint` |
+| Rust | rustfmt (bundled with Rust) | clippy (bundled with Rust) | [Install Rust](https://rustup.rs/) |
+| JSON/JSONC/YAML/TOML | — | syntax-validator (Python stdlib) | No extra install needed |
+
+### dprint Configuration
+
+The dprint formatter looks for a config file at `/usr/local/share/dprint/dprint.json`. If this file doesn't exist, dprint formatting is skipped. Create one with your preferred settings, or use a minimal config:
+
+```json
+{
+  "markdown": {},
+  "toml": {},
+  "yaml": {}
+}
+```
+
+### Biome Discovery
+
+Biome is resolved in this order:
+1. Project-local: walks up from the edited file looking for `node_modules/.bin/biome`
+2. Global: checks PATH via `which biome`
+
+## Installation
+
+### 1. Place the plugin
+
+Copy the `auto-code-quality/` directory into your Claude Code plugin marketplace:
+
+```
+your-marketplace/
+├── .claude-plugin/
+│   └── marketplace.json
+└── plugins/
+    └── auto-code-quality/    ← this directory
+```
+
+### 2. Register in marketplace.json
+
+Add this entry to your `marketplace.json` `plugins` array:
+
+```json
+{
+  "name": "auto-code-quality",
+  "description": "Self-contained code quality: auto-format + auto-lint edited files",
+  "version": "1.0.0",
+  "source": "./plugins/auto-code-quality",
+  "category": "development"
+}
+```
+
+### 3. Enable in settings.json
+
+Add to your Claude Code `settings.json` under `enabledPlugins`:
+
+```json
+{
+  "enabledPlugins": {
+    "auto-code-quality@your-marketplace": true
+  }
+}
+```
+
+Replace `your-marketplace` with the name of your marketplace.
+
+## How It Works
+
+### Hook Lifecycle
+
+```
+You edit a file (Edit/Write tool)
+  │
+  ├─→ collect-edited-files.py    Appends path to temp files
+  └─→ syntax-validator.py        Validates JSON/YAML/TOML syntax immediately
+       │
+       │  ... Claude keeps working ...
+       │
+Claude stops responding (Stop event)
+  │
+  ├─→ format-on-stop.py          Reads temp file, formats each file by extension
+  └─→ lint-file.py               Reads temp file, lints each file, injects warnings
+```
+
+### Temp File Convention
+
+Edited file paths are stored in session-scoped temp files:
+- `/tmp/claude-cq-edited-{session_id}` — consumed by the formatter
+- `/tmp/claude-cq-lint-{session_id}` — consumed by the linter
+
+Both are always cleaned up after processing (even on error).
+
+### Timeouts
+
+| Hook | Timeout |
+|------|---------|
+| File collection | 3s |
+| Syntax validation | 5s |
+| Batch formatting | 15s total |
+| Batch linting | 60s total |
+| Individual tool | 10-12s each |
+
+## Conflict Warning
+
+This plugin bundles functionality that may overlap with other plugins. If you're using any of the following, **disable them** before enabling this plugin to avoid duplicate processing:
+
+- `auto-formatter` — formatting is included here
+- `auto-linter` — linting is included here
+- `code-directive` `collect-edited-files.py` hook — file collection is included here
+
+The temp file prefixes are different (`claude-cq-*` vs `claude-edited-files-*` / `claude-lint-files-*`), so enabling both won't corrupt data — but files would be formatted and linted twice.
+
+## Plugin Structure
+
+```
+auto-code-quality/
+├── .claude-plugin/
+│   └── plugin.json              # Plugin metadata
+├── hooks/
+│   └── hooks.json               # Hook registrations (PostToolUse + Stop)
+├── scripts/
+│   ├── collect-edited-files.py  # File path collector (PostToolUse)
+│   ├── syntax-validator.py      # JSON/YAML/TOML validator (PostToolUse)
+│   ├── format-on-stop.py        # Batch formatter (Stop)
+│   └── lint-file.py             # Batch linter (Stop)
+└── README.md                    # This file
+```
+
+## Requirements
+
+- Python 3.11+ (for `tomllib` support in syntax validation; older Python skips TOML)
+- Claude Code with plugin hook support

package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/hooks/hooks.json

@@ -0,0 +1,39 @@
+{
+	"description": "Self-contained code quality: file collection on edit, syntax validation, batch formatting + linting at stop",
+	"hooks": {
+		"PostToolUse": [
+			{
+				"matcher": "Edit|Write",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/collect-edited-files.py",
+						"timeout": 3
+					},
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/syntax-validator.py",
+						"timeout": 5
+					}
+				]
+			}
+		],
+		"Stop": [
+			{
+				"matcher": "",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/format-on-stop.py",
+						"timeout": 15
+					},
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lint-file.py",
+						"timeout": 60
+					}
+				]
+			}
+		]
+	}
+}

package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/scripts/collect-edited-files.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""
+Collect edited file paths for batch formatting and linting at Stop.
+
+Lightweight PostToolUse hook that appends the edited file path
+to session-scoped temp files. The format and lint Stop hooks
+read these files to know which files need processing.
+
+Non-blocking: always exits 0. Runs in <10ms.
+"""
+
+import json
+import os
+import sys
+
+
+def main():
+    try:
+        input_data = json.load(sys.stdin)
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    session_id = input_data.get("session_id", "")
+    tool_input = input_data.get("tool_input", {})
+    file_path = tool_input.get("file_path", "")
+
+    if not file_path or not session_id:
+        sys.exit(0)
+
+    if not os.path.isfile(file_path):
+        sys.exit(0)
+
+    # Write to both formatter and linter temp files (independent pipelines)
+    # Uses "claude-cq-" prefix to avoid collision with other plugins
+    for prefix in ("claude-cq-edited", "claude-cq-lint"):
+        tmp_path = f"/tmp/{prefix}-{session_id}"
+        try:
+            with open(tmp_path, "a") as f:
+                f.write(file_path + "\n")
+        except OSError:
+            pass  # non-critical, don't block Claude
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()