codeforge-dev 1.4.0

package/.devcontainer/features/tree-sitter/README.md

@@ -0,0 +1,138 @@
+# Tree-sitter Parser Feature
+
+Installs [tree-sitter](https://tree-sitter.github.io/tree-sitter/) parsing library with Node.js and Python bindings.
+
+## Usage
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {}
+  }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `version` | string | `latest` | tree-sitter version (e.g., `0.24.4`) |
+| `bindings` | enum | `both` | Language bindings: `node`, `python`, `both`, `none` |
+| `installCli` | boolean | `true` | Install tree-sitter CLI tool (requires Node.js) |
+| `grammars` | string | `javascript,typescript,python` | Comma-separated grammars to preload |
+| `username` | string | `automatic` | Container user to install for |
+
+## Examples
+
+### Default (CLI + Node + Python + JS/TS/Python grammars)
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {}
+  }
+}
+```
+
+### With Additional Grammars
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {
+      "grammars": "javascript,typescript,python,rust,json"
+    }
+  }
+}
+```
+
+### Node.js Only
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {
+      "bindings": "node",
+      "grammars": "javascript,typescript"
+    }
+  }
+}
+```
+
+### Python Only (No CLI)
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {
+      "bindings": "python",
+      "installCli": false,
+      "grammars": "python"
+    }
+  }
+}
+```
+
+## Installed Components
+
+### CLI (`installCli: true`)
+
+- `tree-sitter` CLI installed via npm ([tree-sitter-cli](https://www.npmjs.com/package/tree-sitter-cli))
+- Requires Node.js to be installed
+
+### Node.js Bindings (`bindings: "node"` or `"both"`)
+
+- `web-tree-sitter` - WebAssembly-based tree-sitter for Node.js
+- Grammar packages as `tree-sitter-{language}`
+
+### Python Bindings (`bindings: "python"` or `"both"`)
+
+- `tree-sitter` - Python bindings package
+- Grammar packages as `tree-sitter-{language}`
+
+## Available Grammars
+
+Common grammars available via npm/pip:
+
+- `javascript`, `typescript`, `tsx`
+- `python`, `rust`, `c`, `cpp`
+- `java`, `ruby`, `php`, `swift`
+- `json`, `yaml`, `toml`, `html`, `css`
+- `bash`, `markdown`, `regex`
+
+## Dependencies
+
+This feature requires:
+
+- **Node.js** (via `ghcr.io/devcontainers/features/node:1`) - required for CLI and Node bindings
+- **Python** (via `ghcr.io/devcontainers/features/python:1`) - for Python bindings only
+
+## Quick Start
+
+### Node.js
+
+```javascript
+const Parser = require('web-tree-sitter');
+
+await Parser.init();
+const parser = new Parser();
+
+const JavaScript = await Parser.Language.load('path/to/tree-sitter-javascript.wasm');
+parser.setLanguage(JavaScript);
+
+const tree = parser.parse('const x = 1;');
+console.log(tree.rootNode.toString());
+```
+
+### Python
+
+```python
+import tree_sitter_python as tspython
+from tree_sitter import Language, Parser
+
+PY_LANGUAGE = Language(tspython.language())
+parser = Parser(PY_LANGUAGE)
+
+tree = parser.parse(b"def hello(): pass")
+print(tree.root_node.sexp())
+```

package/.devcontainer/features/tree-sitter/devcontainer-feature.json

@@ -0,0 +1,52 @@
+{
+  "id": "tree-sitter",
+  "version": "1.1.0",
+  "name": "Tree-sitter Parser",
+  "description": "Installs tree-sitter CLI (via npm) and parsing library with Node.js and Python bindings",
+  "maintainer": "AnExiledDev",
+  "documentationURL": "https://tree-sitter.github.io/tree-sitter/",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "tree-sitter-cli npm package version (e.g., 'latest', '0.24.4')",
+      "default": "latest"
+    },
+    "bindings": {
+      "type": "string",
+      "description": "Language bindings to install (node, python, both, none)",
+      "default": "both",
+      "enum": [
+        "node",
+        "python",
+        "both",
+        "none"
+      ],
+      "proposals": [
+        "node",
+        "python",
+        "both",
+        "none"
+      ]
+    },
+    "installCli": {
+      "type": "boolean",
+      "description": "Install tree-sitter CLI tool (requires Node.js)",
+      "default": true
+    },
+    "grammars": {
+      "type": "string",
+      "description": "Comma-separated list of grammars to preload (e.g., 'javascript,python,rust'). Empty for none.",
+      "default": "javascript,typescript,python"
+    },
+    "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/python:1"
+  ]
+}

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

@@ -0,0 +1,173 @@
+#!/bin/bash
+set -euo pipefail
+
+# === IMPORT OPTIONS ===
+# DevContainer converts camelCase to UPPERCASE without underscores
+VERSION="${VERSION:-latest}"
+BINDINGS="${BINDINGS:-both}"
+INSTALL_CLI="${INSTALLCLI:-true}"
+GRAMMARS="${GRAMMARS:-}"
+USERNAME="${USERNAME:-automatic}"
+
+echo "[tree-sitter] Starting tree-sitter installation..."
+echo "[tree-sitter] Options: version=${VERSION}, bindings=${BINDINGS}, cli=${INSTALL_CLI}"
+
+# === SOURCE NVM ===
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# === VALIDATE BINDINGS OPTION ===
+if [[ ! "${BINDINGS}" =~ ^(node|python|both|none)$ ]]; then
+    echo "[tree-sitter] ERROR: bindings must be 'node', 'python', 'both', or 'none'"
+    echo "  Provided: ${BINDINGS}"
+    exit 1
+fi
+
+# === VALIDATE DEPENDENCIES ===
+NEED_NODE=false
+NEED_PYTHON=false
+
+if [ "${BINDINGS}" = "node" ] || [ "${BINDINGS}" = "both" ]; then
+    NEED_NODE=true
+fi
+if [ "${BINDINGS}" = "python" ] || [ "${BINDINGS}" = "both" ]; then
+    NEED_PYTHON=true
+fi
+
+# CLI installation requires npm
+if [ "${INSTALL_CLI}" = "true" ]; then
+    NEED_NODE=true
+fi
+
+if [ "${NEED_NODE}" = "true" ]; then
+    if ! command -v npm &>/dev/null; then
+        echo "[tree-sitter] ERROR: npm not available but required for CLI or node bindings"
+        echo "  Ensure node feature is installed first"
+        exit 1
+    fi
+    echo "[tree-sitter] Node.js: $(node --version)"
+fi
+
+if [ "${NEED_PYTHON}" = "true" ]; then
+    if ! command -v pip &>/dev/null && ! command -v pip3 &>/dev/null; then
+        echo "[tree-sitter] ERROR: pip not available but python bindings requested"
+        echo "  Ensure python feature is installed first"
+        exit 1
+    fi
+    echo "[tree-sitter] Python: $(python3 --version)"
+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
+
+if [ "${USERNAME}" = "root" ]; then
+    USER_HOME="/root"
+else
+    USER_HOME=$(getent passwd "${USERNAME}" | cut -d: -f6)
+fi
+
+echo "[tree-sitter] Installing for user: ${USERNAME} (home: ${USER_HOME})"
+
+# === INSTALL CLI VIA NPM ===
+if [ "${INSTALL_CLI}" = "true" ]; then
+    echo "[tree-sitter] Installing tree-sitter CLI via npm..."
+
+    # Build version specifier
+    if [ "${VERSION}" = "latest" ]; then
+        NPM_PACKAGE="tree-sitter-cli"
+    else
+        NPM_PACKAGE="tree-sitter-cli@${VERSION}"
+    fi
+
+    npm install -g "${NPM_PACKAGE}" 2>/dev/null || {
+        echo "[tree-sitter] WARNING: Global npm install failed, trying user install"
+        su - "${USERNAME}" -c "npm install -g ${NPM_PACKAGE}" 2>/dev/null || true
+    }
+
+    echo "[tree-sitter] CLI installed: $(tree-sitter --version 2>/dev/null || echo 'unknown')"
+fi
+
+# === INSTALL NODE BINDINGS ===
+if [ "${BINDINGS}" = "node" ] || [ "${BINDINGS}" = "both" ]; then
+    echo "[tree-sitter] Installing Node.js bindings..."
+
+    # Install web-tree-sitter for runtime parsing
+    npm install -g web-tree-sitter 2>/dev/null || {
+        echo "[tree-sitter] WARNING: Global npm install failed, trying user install"
+        su - "${USERNAME}" -c "npm install -g web-tree-sitter" 2>/dev/null || true
+    }
+
+    # Install grammars if specified
+    if [ -n "${GRAMMARS}" ]; then
+        echo "[tree-sitter] Installing Node.js grammars: ${GRAMMARS}"
+        IFS=',' read -ra GRAMMAR_LIST <<< "${GRAMMARS}"
+        for grammar in "${GRAMMAR_LIST[@]}"; do
+            grammar=$(echo "${grammar}" | xargs)  # trim whitespace
+            if [ -n "${grammar}" ]; then
+                npm install -g "tree-sitter-${grammar}" 2>/dev/null || {
+                    echo "[tree-sitter] WARNING: Failed to install grammar: ${grammar}"
+                }
+            fi
+        done
+    fi
+
+    echo "[tree-sitter] Node.js bindings installed"
+fi
+
+# === INSTALL PYTHON BINDINGS ===
+if [ "${NEED_PYTHON}" = "true" ]; then
+    echo "[tree-sitter] Installing Python bindings..."
+
+    # Use pip3 with --break-system-packages for system python
+    PIP_CMD="pip3"
+    if command -v pip &>/dev/null; then
+        PIP_CMD="pip"
+    fi
+
+    # Install tree-sitter python package
+    ${PIP_CMD} install --break-system-packages tree-sitter 2>/dev/null || \
+    ${PIP_CMD} install tree-sitter 2>/dev/null || {
+        echo "[tree-sitter] WARNING: System pip install failed, trying user install"
+        su - "${USERNAME}" -c "${PIP_CMD} install --user tree-sitter" 2>/dev/null || true
+    }
+
+    # Install grammars if specified
+    if [ -n "${GRAMMARS}" ]; then
+        echo "[tree-sitter] Installing Python grammars: ${GRAMMARS}"
+        IFS=',' read -ra GRAMMAR_LIST <<< "${GRAMMARS}"
+        for grammar in "${GRAMMAR_LIST[@]}"; do
+            grammar=$(echo "${grammar}" | xargs)  # trim whitespace
+            if [ -n "${grammar}" ]; then
+                ${PIP_CMD} install --break-system-packages "tree-sitter-${grammar}" 2>/dev/null || \
+                ${PIP_CMD} install "tree-sitter-${grammar}" 2>/dev/null || {
+                    echo "[tree-sitter] WARNING: Failed to install grammar: ${grammar}"
+                }
+            fi
+        done
+    fi
+
+    echo "[tree-sitter] Python bindings installed"
+fi
+
+# === SUMMARY ===
+echo ""
+echo "[tree-sitter] Installation complete!"
+echo "  CLI:     $(command -v tree-sitter &>/dev/null && echo "installed ($(tree-sitter --version 2>/dev/null || echo 'unknown'))" || echo "not installed")"
+echo "  Node.js: $([ "${NEED_NODE}" = "true" ] && echo "installed" || echo "skipped")"
+echo "  Python:  $([ "${NEED_PYTHON}" = "true" ] && echo "installed" || echo "skipped")"
+if [ -n "${GRAMMARS}" ]; then
+    echo "  Grammars: ${GRAMMARS}"
+fi

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

@@ -0,0 +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": "codedirective-skills",
+      "description": "Coding standards and skills for the CodeDirective project",
+      "version": "1.0.0",
+      "source": "./plugins/codedirective-skills",
+      "category": "development"
+    }
+  ]
+}

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

@@ -0,0 +1,7 @@
+{
+  "name": "auto-formatter",
+  "description": "Auto-formats files after editing (black for Python, gofmt for Go)",
+  "author": {
+    "name": "AnExiledDev"
+  }
+}

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

@@ -0,0 +1,17 @@
+{
+  "description": "Auto-format files after editing",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/format-file.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""
+Auto-format files after editing.
+
+Reads tool input from stdin, detects file type by extension,
+runs appropriate formatter if available.
+Outputs JSON with additionalContext on success.
+Non-blocking: exit 0 regardless of formatting result.
+"""
+
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+# Formatter configuration: extension -> (command, args, name)
+FORMATTERS = {
+    ".py": ("/usr/local/py-utils/bin/black", ["--quiet"], "Black"),
+    ".pyi": ("/usr/local/py-utils/bin/black", ["--quiet"], "Black"),
+    ".go": ("/usr/local/go/bin/gofmt", ["-w"], "gofmt"),
+}
+
+
+def get_formatter(file_path: str) -> tuple[str, list[str], str] | None:
+    """Get formatter config for file extension."""
+    ext = Path(file_path).suffix.lower()
+    return FORMATTERS.get(ext)
+
+
+def format_file(file_path: str) -> tuple[bool, str]:
+    """Run formatter on file.
+
+    Returns:
+        (success, message)
+    """
+    formatter = get_formatter(file_path)
+    if formatter is None:
+        return True, ""  # No formatter available, that's OK
+
+    cmd_path, args, name = formatter
+
+    # Check if formatter exists
+    if not os.path.exists(cmd_path):
+        return True, f"[Auto-formatter] {name} not found, skipping"
+
+    # Check if file exists
+    if not os.path.exists(file_path):
+        return True, ""
+
+    try:
+        # Run formatter
+        cmd = [cmd_path] + args + [file_path]
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=25
+        )
+
+        if result.returncode == 0:
+            return True, f"[Auto-formatter] Formatted with {name}"
+        else:
+            # Formatting failed, but don't block
+            error = result.stderr.strip() if result.stderr else "Unknown error"
+            return True, f"[Auto-formatter] {name} warning: {error}"
+
+    except subprocess.TimeoutExpired:
+        return True, f"[Auto-formatter] {name} timed out"
+    except Exception as e:
+        return True, f"[Auto-formatter] Error: {e}"
+
+
+def main():
+    try:
+        input_data = json.load(sys.stdin)
+        tool_input = input_data.get("tool_input", {})
+        file_path = tool_input.get("file_path", "")
+
+        if not file_path:
+            sys.exit(0)
+
+        _, message = format_file(file_path)
+
+        if message:
+            # Output context for Claude
+            print(json.dumps({
+                "additionalContext": message
+            }))
+
+        sys.exit(0)
+
+    except json.JSONDecodeError:
+        sys.exit(0)
+    except Exception as e:
+        print(f"Hook error: {e}", file=sys.stderr)
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,7 @@
+{
+  "name": "auto-linter",
+  "description": "Auto-lints files after editing (pyright for Python)",
+  "author": {
+    "name": "AnExiledDev"
+  }
+}

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

@@ -0,0 +1,17 @@
+{
+  "description": "Auto-lint files after editing",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lint-file.py",
+            "timeout": 60
+          }
+        ]
+      }
+    ]
+  }
+}