codeforge-dev 1.12.0 → 1.14.1

package/.devcontainer/features/README.md

@@ -1,126 +0,0 @@
-# CodeForge DevContainer Features
-
-This directory contains DevContainer Features for AI coding agent environments. These features follow the [DevContainer Features specification](https://containers.dev/implementors/features/) and can be published to OCI registries for distribution.
-
-## Available Features
-
-| Feature | Description | Status |
-|---------|-------------|--------|
-| `tmux` | Terminal multiplexer with Catppuccin theme for Agent Teams | ✅ |
-| `agent-browser` | Headless browser automation for AI agents | ✅ |
-| `claude-monitor` | Real-time token usage monitoring | ✅ |
-| `ccusage` | Token usage analytics CLI | ✅ |
-| `ccburn` | Visual token burn rate tracker with pace indicators | ✅ |
-| `ccstatusline` | 6-line powerline status display (v1.1.0) | ✅ |
-| `ast-grep` | Structural code search using AST patterns | ✅ |
-| `tree-sitter` | Parser with JS/TS/Python grammars | ✅ |
-| `lsp-servers` | Pyright and TypeScript language servers | ✅ |
-| `biome` | Fast JS/TS/JSON/CSS formatter | ✅ |
-| `ruff` | Fast Python linter and formatter | ✅ |
-| `shfmt` | Shell script formatter | ✅ (disabled by default) |
-| `shellcheck` | Static analysis for shell scripts | ✅ (disabled by default) |
-| `hadolint` | Dockerfile linter | ✅ (disabled by default) |
-| `dprint` | Pluggable formatter for Markdown/YAML/TOML | ✅ (disabled by default) |
-| `ccms` | Claude Code session history search | ✅ |
-| `notify-hook` | Desktop notifications on Claude completion | ✅ |
-| `mcp-qdrant` | Qdrant vector database MCP server | ✅ (optional) |
-| `claude-code` | Fallback config for Anthropic's official Claude Code feature | ✅ (config only) |
-
-> **Note**: Claude Code itself is installed via `ghcr.io/anthropics/devcontainer-features/claude-code:1` (Anthropic's official feature). The local `claude-code/` directory provides only fallback configuration.
-
-## Feature Structure
-
-Each feature follows this structure:
-
-```
-feature-name/
-├── devcontainer-feature.json   # Feature metadata and options
-├── install.sh                  # Installation script (executable)
-└── README.md                   # Feature documentation
-```
-
-## Development Workflow
-
-### Creating a New Feature
-
-1. **Create directory**: `mkdir features/feature-name`
-2. **Add metadata**: Create `devcontainer-feature.json`
-3. **Write installer**: Create `install.sh` (make executable)
-4. **Document**: Create `README.md`
-5. **Test locally**: Reference in devcontainer.json
-
-### Local Testing
-
-To test a feature locally before publishing:
-
-```json
-{
-  "features": {
-    "./features/feature-name": {
-      "option1": "value1"
-    }
-  }
-}
-```
-
-### Publishing Features
-
-Features will be published to GitHub Container Registry (GHCR):
-
-```
-ghcr.io/yourorg/codeforge-features/feature-name:1
-```
-
-**Publishing workflow** (future):
-- Push to main branch
-- GitHub Actions builds and publishes
-- Tags create versioned releases
-
-## Feature Guidelines
-
-### Granularity
-- **One feature = One tool/service**
-- Bundle only if tools are always used together
-- See project README for guidance
-
-### Options
-- Use clear, descriptive option names
-- Provide sensible defaults
-- Support environment variable substitution: `"${env:VAR}"`
-- Document all options in README
-
-### Installation
-- Must be idempotent (safe to run multiple times)
-- Check if already installed before installing
-- Use appropriate user (not always root)
-- Clean up on failure
-
-### Configuration
-- Generate necessary config files
-- Provide helper scripts for manual setup
-- Print clear installation summary
-- Show next steps to user
-
-## Migration from Modules
-
-CodeForge modules have been converted to DevContainer Features:
-
-| Old Module | New Feature | Status |
-|-----------|-------------|---------|
-| mcp_qdrant | mcp-qdrant | ✅ Complete |
-
-## Resources
-
-- [DevContainer Features Specification](https://containers.dev/implementors/features/)
-- [Feature Authoring Guide](https://containers.dev/guide/author-a-feature)
-- [Feature Best Practices](https://containers.dev/guide/feature-authoring-best-practices)
-- [CodeForge Documentation](../../README.md)
-
-## Contributing
-
-Features are part of the CodeForge project. See main repository for contribution guidelines.
-
----
-
-**Status**: Active Development
-**Last Updated**: 2026-02-08

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

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

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/README.md

@@ -1,81 +0,0 @@
-# auto-formatter
-
-Claude Code plugin that batch-formats edited files when Claude finishes responding. Reads file paths collected by the `code-directive` plugin's `collect-edited-files.py` hook and formats each file based on its extension.
-
-## What It Does
-
-When Claude stops responding, the plugin reads the session's list of edited files and formats each one using the appropriate tool:
-
-| Language / File Type | Formatter | Fallback |
-|----------------------|-----------|----------|
-| Python (`.py`, `.pyi`) | [ruff format](https://docs.astral.sh/ruff/) | [black](https://github.com/psf/black) |
-| Go (`.go`) | gofmt (bundled with Go) | — |
-| JS/TS/CSS/JSON/GraphQL/HTML (`.js`, `.jsx`, `.ts`, `.tsx`, `.css`, `.json`, `.jsonc`, `.graphql`, `.gql`, `.html`, `.vue`, `.svelte`, `.astro`) | [biome](https://biomejs.dev/) check --write | — |
-| Shell (`.sh`, `.bash`, `.zsh`, `.mksh`, `.bats`) | [shfmt](https://github.com/mvdan/sh) | — |
-| Markdown/YAML/TOML (`.md`, `.markdown`, `.yaml`, `.yml`, `.toml`) | [dprint](https://dprint.dev/) | — |
-| Dockerfile | dprint | — |
-| Rust (`.rs`) | rustfmt (bundled with Rust) | — |
-
-All formatting is non-blocking. Missing tools are silently skipped. The plugin always exits 0 — it will never interrupt Claude.
-
-## How It Works
-
-### Hook Lifecycle
-
-```
-code-directive's collect-edited-files.py (PostToolUse on Edit/Write)
-  │
-  └─→ Appends edited file path to /tmp/claude-edited-files-{session_id}
-       │
-       │  ... Claude keeps working ...
-       │
-Claude stops responding (Stop event)
-  │
-  └─→ format-on-stop.py reads the temp file, deduplicates paths,
-      formats each file by extension, then cleans up the temp file
-```
-
-### Dependency on code-directive
-
-This plugin does **not** collect file paths itself. It relies on the `code-directive` plugin's `collect-edited-files.py` PostToolUse hook to write edited file paths to `/tmp/claude-edited-files-{session_id}`. Both plugins must be enabled for formatting to work.
-
-### 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`
-
-### 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.
-
-### Timeouts
-
-| Scope | Timeout |
-|-------|---------|
-| Entire Stop hook | 15s |
-| Individual tool invocation | 10-12s |
-
-## Conflict Warning
-
-Do **not** enable this plugin alongside `auto-code-quality`. That plugin bundles its own formatter with the same functionality. Enabling both won't corrupt data (different temp file prefixes: `claude-edited-files-*` vs `claude-cq-*`), but files would be formatted twice.
-
-## Plugin Structure
-
-```
-auto-formatter/
-├── .claude-plugin/
-│   └── plugin.json          # Plugin metadata
-├── hooks/
-│   └── hooks.json           # Stop hook registration
-├── scripts/
-│   └── format-on-stop.py    # Batch formatter (Stop)
-└── README.md                # This file
-```
-
-## Requirements
-
-- Python 3.11+
-- Claude Code with plugin hook support
-- `code-directive` plugin enabled (provides the file path collector)
-- Install the formatting tools for the languages you work with — everything is optional

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

@@ -1,17 +0,0 @@
-{
-  "description": "Batch-format collected files when Claude stops responding",
-  "hooks": {
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/format-on-stop.py",
-            "timeout": 15
-          }
-        ]
-      }
-    ]
-  }
-}

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

@@ -1,297 +0,0 @@
-#!/usr/bin/env python3
-"""
-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                                → 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.
-"""
-
-import json
-import os
-import subprocess
-import sys
-from pathlib import Path
-
-# ── Extension sets ──────────────────────────────────────────────────
-
-PYTHON_EXTS = {".py", ".pyi"}
-GO_EXTS = {".go"}
-BIOME_EXTS = {
-    ".js",
-    ".jsx",
-    ".ts",
-    ".tsx",
-    ".mjs",
-    ".cjs",
-    ".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_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:
-    """Walk up from file directory looking for node_modules/.bin/<tool>."""
-    current = Path(file_path).parent
-    for _ in range(20):
-        candidate = current / "node_modules" / ".bin" / tool_name
-        if candidate.is_file():
-            return str(candidate)
-        parent = current.parent
-        if parent == current:
-            break
-        current = parent
-    return None
-
-
-def find_global_tool(tool_name: str) -> str | None:
-    """Check if tool is available globally."""
-    try:
-        result = subprocess.run(
-            ["which", tool_name],
-            capture_output=True,
-            text=True,
-        )
-        if result.returncode == 0:
-            return result.stdout.strip()
-    except Exception:
-        pass
-    return None
-
-
-def find_biome(file_path: str) -> str | None:
-    """Find biome binary: project-local first, then global."""
-    local = find_tool_upward(file_path, "biome")
-    if local:
-        return local
-    return find_global_tool("biome")
-
-
-# ── Formatters ──────────────────────────────────────────────────────
-
-
-def format_python(file_path: str) -> None:
-    """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, "--quiet", file_path],
-            capture_output=True,
-            timeout=10,
-        )
-    except (subprocess.TimeoutExpired, OSError):
-        pass
-
-
-def format_go(file_path: str) -> None:
-    """Format with gofmt."""
-    gofmt = _resolve_tool("gofmt", GOFMT_PATH_FALLBACK)
-    if not gofmt:
-        return
-    try:
-        subprocess.run(
-            [gofmt, "-w", file_path],
-            capture_output=True,
-            timeout=10,
-        )
-    except (subprocess.TimeoutExpired, OSError):
-        pass
-
-
-def format_biome(file_path: str) -> None:
-    """Format with Biome in safe mode (no --unsafe)."""
-    biome = find_biome(file_path)
-    if not biome:
-        return
-    try:
-        subprocess.run(
-            [biome, "check", "--write", file_path],
-            capture_output=True,
-            timeout=12,
-        )
-    except (subprocess.TimeoutExpired, OSError):
-        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 / 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():
-    try:
-        input_data = json.load(sys.stdin)
-    except (json.JSONDecodeError, ValueError):
-        sys.exit(0)
-
-    # Prevent infinite loops if Stop hook triggers another stop
-    if input_data.get("stop_hook_active"):
-        sys.exit(0)
-
-    session_id = input_data.get("session_id", "")
-    if not session_id:
-        sys.exit(0)
-
-    tmp_path = f"/tmp/claude-edited-files-{session_id}"
-
-    try:
-        with open(tmp_path) as f:
-            raw_paths = f.read().splitlines()
-    except FileNotFoundError:
-        sys.exit(0)
-    except OSError:
-        sys.exit(0)
-    finally:
-        # Always clean up the temp file
-        try:
-            os.unlink(tmp_path)
-        except OSError:
-            pass
-
-    # Deduplicate while preserving order, filter to existing files
-    seen: set[str] = set()
-    paths: list[str] = []
-    for p in raw_paths:
-        p = p.strip()
-        if p and p not in seen and os.path.isfile(p):
-            seen.add(p)
-            paths.append(p)
-
-    for path in paths:
-        format_file(path)
-
-    sys.exit(0)
-
-
-if __name__ == "__main__":
-    main()

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

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

package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/README.md

@@ -1,92 +0,0 @@
-# auto-linter
-
-Claude Code plugin that batch-lints edited files when Claude finishes responding. Reads file paths collected by the `code-directive` plugin's `collect-edited-files.py` hook and lints each file using the appropriate tool. Lint results are returned as advisory context — never blocking.
-
-## What It Does
-
-When Claude stops responding, the plugin reads the session's list of edited files, lints each one, and injects any warnings as `additionalContext` so Claude sees them on its next response.
-
-| Language / File Type | Linter(s) |
-|----------------------|-----------|
-| Python (`.py`, `.pyi`) | [pyright](https://github.com/microsoft/pyright) (type checking) + [ruff check](https://docs.astral.sh/ruff/) (style/correctness) |
-| JS/TS/CSS/GraphQL (`.js`, `.jsx`, `.ts`, `.tsx`, `.css`, `.graphql`, `.gql`) | [biome lint](https://biomejs.dev/) |
-| Shell (`.sh`, `.bash`, `.zsh`, `.mksh`, `.bats`) | [shellcheck](https://github.com/koalaman/shellcheck) |
-| Go (`.go`) | go vet (bundled with Go) |
-| Dockerfile | [hadolint](https://github.com/hadolint/hadolint) |
-| Rust (`.rs`) | [clippy](https://doc.rust-lang.org/clippy/) (via cargo) |
-
-All linting is non-blocking. Missing tools are silently skipped. The plugin always exits 0 and returns warnings as `additionalContext` — it will never interrupt Claude.
-
-## How It Works
-
-### Hook Lifecycle
-
-```
-code-directive's collect-edited-files.py (PostToolUse on Edit/Write)
-  │
-  └─→ Appends edited file path to /tmp/claude-lint-files-{session_id}
-       │
-       │  ... Claude keeps working ...
-       │
-Claude stops responding (Stop event)
-  │
-  └─→ lint-file.py reads the temp file, deduplicates paths,
-      lints each file by extension, groups results by linter,
-      injects warnings as additionalContext, then cleans up
-```
-
-### Dependency on code-directive
-
-This plugin relies on the `code-directive` plugin's `collect-edited-files.py` PostToolUse hook to write edited file paths to `/tmp/claude-lint-files-{session_id}`. Both plugins must be enabled for linting to work.
-
-### Output Format
-
-Lint results are grouped by linter and returned as `additionalContext`. Each file shows up to 5 issues with severity, line number, and message:
-
-```
-[Auto-linter] Pyright results:
-  example.py: 2 issue(s)
-  ✗ Line 15: Cannot assign type "str" to declared type "int"
-  ! Line 42: Variable "x" is not defined
-
-[Auto-linter] Ruff results:
-  example.py: 1 issue(s)
-  ! Line 8: [F401] `os` imported but unused
-```
-
-### 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`
-
-### Timeouts
-
-| Scope | Timeout |
-|-------|---------|
-| Entire Stop hook | 60s |
-| Individual tool invocation | 10s |
-
-## Conflict Warning
-
-Do **not** enable this plugin alongside `auto-code-quality`. That plugin bundles its own linter with the same functionality. Enabling both won't corrupt data (different temp file prefixes: `claude-lint-files-*` vs `claude-cq-*`), but files would be linted twice.
-
-## Plugin Structure
-
-```
-auto-linter/
-├── .claude-plugin/
-│   └── plugin.json        # Plugin metadata
-├── hooks/
-│   └── hooks.json         # Stop hook registration
-├── scripts/
-│   └── lint-file.py       # Batch linter (Stop)
-└── README.md              # This file
-```
-
-## Requirements
-
-- Python 3.11+
-- Claude Code with plugin hook support
-- `code-directive` plugin enabled (provides the file path collector)
-- Install the linting tools for the languages you work with — everything is optional

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

@@ -1,17 +0,0 @@
-{
-  "description": "Batch-lint collected files when Claude stops responding",
-  "hooks": {
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lint-file.py",
-            "timeout": 60
-          }
-        ]
-      }
-    ]
-  }
-}