codeforge-dev 1.10.0 → 1.12.0

package/.devcontainer/features/ccms/install.sh

@@ -0,0 +1,122 @@
+#!/bin/bash
+set -euo pipefail
+
+# === SETUP ===
+cleanup() {
+    :
+}
+trap cleanup EXIT
+
+# === IMPORT OPTIONS ===
+CCMS_VERSION="${VERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+# Skip installation if version is "none"
+if [ "${CCMS_VERSION}" = "none" ]; then
+    echo "[ccms] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[ccms] Starting ccms installation..."
+
+# === VALIDATE DEPENDENCIES ===
+# Source cargo env if available (Rust feature installs via rustup)
+if [ -f /usr/local/cargo/env ]; then
+    source /usr/local/cargo/env
+elif [ -f "${HOME}/.cargo/env" ]; then
+    source "${HOME}/.cargo/env"
+fi
+
+if ! command -v cargo &>/dev/null; then
+    echo "[ccms] ERROR: cargo is not available"
+    echo "  Ensure the Rust devcontainer feature is installed first:"
+    echo "  \"ghcr.io/devcontainers/features/rust:1\": {}"
+    exit 1
+fi
+
+echo "[ccms] Using cargo: $(cargo --version)"
+
+# === DETECT USER ===
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    USERNAME=""
+    for CURRENT_USER in vscode node codespace; do
+        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
+            USERNAME=${CURRENT_USER}
+            break
+        fi
+    done
+    [ -z "${USERNAME}" ] && USERNAME=root
+elif [ "${USERNAME}" = "none" ] || ! id -u "${USERNAME}" >/dev/null 2>&1; then
+    USERNAME=root
+fi
+
+echo "[ccms] Installing for user: ${USERNAME}"
+
+# === BUILD CACHE ===
+CACHE_DIR="/workspaces/.devcontainer/.build-cache/bin"
+
+# === INSTALL ===
+REPO_URL="https://github.com/mkusaka/ccms"
+
+if [ -x "${CACHE_DIR}/ccms" ]; then
+    echo "[ccms] Using cached binary from ${CACHE_DIR}/ccms"
+    cp "${CACHE_DIR}/ccms" /usr/local/bin/ccms
+    chmod +x /usr/local/bin/ccms
+else
+    if [ "${CCMS_VERSION}" = "latest" ]; then
+        echo "[ccms] Building from main branch..."
+        cargo install --git "${REPO_URL}" --rev f90d259a4476 2>&1 | tail -5
+    else
+        echo "[ccms] Building from ref: ${CCMS_VERSION}..."
+        cargo install --git "${REPO_URL}" --rev "${CCMS_VERSION}" 2>&1 | tail -5
+    fi
+
+    # === ENSURE BINARY IS ON PATH ===
+    # cargo install puts binaries in $CARGO_HOME/bin or ~/.cargo/bin
+    # Symlink to /usr/local/bin so it's available to all users
+    CARGO_BIN="${CARGO_HOME:-$HOME/.cargo}/bin/ccms"
+    if [ -f "${CARGO_BIN}" ] && [ ! -f /usr/local/bin/ccms ]; then
+        ln -s "${CARGO_BIN}" /usr/local/bin/ccms
+        echo "[ccms] Symlinked ${CARGO_BIN} → /usr/local/bin/ccms"
+    fi
+
+    # Cache the binary for future rebuilds
+    mkdir -p "${CACHE_DIR}"
+    CARGO_BIN="${CARGO_HOME:-$HOME/.cargo}/bin/ccms"
+    if [ -f "${CARGO_BIN}" ]; then
+        cp "${CARGO_BIN}" "${CACHE_DIR}/ccms"
+        echo "[ccms] Cached binary to ${CACHE_DIR}/ccms"
+    fi
+fi
+
+# === VERIFICATION ===
+echo "[ccms] Verifying installation..."
+if command -v ccms &>/dev/null; then
+    INSTALLED_VERSION=$(ccms --version 2>/dev/null || echo "unknown")
+    echo "[ccms] ✓ ccms installed: ${INSTALLED_VERSION}"
+else
+    echo "[ccms] WARNING: ccms not found on PATH after installation"
+    echo "  Binary location: ${CARGO_BIN}"
+    echo "  You may need to add cargo bin to PATH"
+fi
+
+# === SUMMARY ===
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  ccms Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • User: ${USERNAME}"
+echo "  • Version: ${CCMS_VERSION}"
+echo "  • Binary: $(which ccms 2>/dev/null || echo "${CARGO_BIN}")"
+echo ""
+echo "Usage:"
+echo "  ccms \"query\"                    # Search all sessions"
+echo "  ccms --project \$(pwd) \"query\"   # Search current project"
+echo "  ccms -r user \"query\"            # Filter by role"
+echo "  ccms -f json \"query\" -n 10      # JSON output, limited"
+echo "  ccms --since \"1 day ago\" \"q\"    # Time-scoped search"
+echo "  ccms                            # Interactive TUI mode"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/ccstatusline/install.sh

@@ -100,6 +100,9 @@ CONFIG_JSON=$(jq -n '{
         [
             {id: "cc-resume-session", type: "custom-command", commandPath: "/usr/local/bin/ccstatusline-session-resume", timeout: 500, preserveColors: false, maxWidth: 50, color: "cyan", backgroundColor: "bgBrightBlack"}
         ],
+        [
+            {id: "cc-cwd", type: "custom-command", commandPath: "/usr/local/bin/ccstatusline-cwd", timeout: 500, preserveColors: false, maxWidth: 40, color: "brightWhite", backgroundColor: "bgBrightBlack"}
+        ],
         [
             {id: "ccburn-compact", type: "custom-command", commandPath: "/usr/local/bin/ccburn-statusline", timeout: 8000, preserveColors: true, maxWidth: 80, color: "green", backgroundColor: "bgBlack"}
         ]
@@ -181,6 +184,24 @@ SESSION_EOF
 chmod +x /usr/local/bin/ccstatusline-session-resume
 echo "[ccstatusline] ✓ Session resume helper installed at /usr/local/bin/ccstatusline-session-resume"
 
+# Create CWD helper script for custom-command widget
+# Reads Claude Code JSON from stdin, outputs the last path segment of cwd
+echo "[ccstatusline] Creating CWD helper..."
+cat > /usr/local/bin/ccstatusline-cwd <<'CWD_EOF'
+#!/bin/bash
+# Reads Claude Code JSON from stdin, outputs basename of cwd
+# Used by ccstatusline custom-command widget
+CWD=$(jq -r '.cwd // empty' 2>/dev/null)
+if [ -n "$CWD" ]; then
+    basename "$CWD"
+else
+    echo "..."
+fi
+CWD_EOF
+
+chmod +x /usr/local/bin/ccstatusline-cwd
+echo "[ccstatusline] ✓ CWD helper installed at /usr/local/bin/ccstatusline-cwd"
+
 # Create wrapper script to protect configuration
 echo "[ccstatusline] Creating wrapper script..."
 cat > /usr/local/bin/ccstatusline-wrapper <<'WRAPPER_EOF'
@@ -302,7 +323,7 @@ echo ""
 echo "Configuration:"
 echo "  • Config file: ${CONFIG_FILE}"
 echo "  • User: ${USERNAME}"
-echo "  • Theme: Powerline (7 lines, 16 widgets, ANSI colors)"
+echo "  • Theme: Powerline (8 lines, 17 widgets, ANSI colors)"
 echo "  • Protected by: /usr/local/bin/ccstatusline-wrapper"
 echo ""
 echo "Display:"
@@ -312,7 +333,8 @@ echo "  Line 3: Git Branch | Git Changes | Git Worktree"
 echo "  Line 4: Session Clock | Session Cost | Block Timer"
 echo "  Line 5: Tokens Total | Version"
 echo "  Line 6: Session ID"
-echo "  Line 7: Burn Rate (ccburn compact)"
+echo "  Line 7: Working Directory"
+echo "  Line 8: Burn Rate (ccburn compact)"
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  Next Steps"

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

@@ -1,45 +1,45 @@
 {
-  "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": {
-    "version": {
-      "type": "string",
-      "description": "Set to 'none' to skip installation of all LSP servers",
-      "default": "latest"
-    },
-    "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"
-  ]
+	"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": {
+		"version": {
+			"type": "string",
+			"description": "Set to 'none' to skip installation of all LSP servers",
+			"default": "latest"
+		},
+		"pyrightVersion": {
+			"type": "string",
+			"description": "Pyright npm package version (e.g., 'latest', '1.1.350')",
+			"default": "1.1.408"
+		},
+		"typescriptLspVersion": {
+			"type": "string",
+			"description": "typescript-language-server npm package version (e.g., 'latest', '4.3.0')",
+			"default": "5.1.3"
+		},
+		"typescriptVersion": {
+			"type": "string",
+			"description": "TypeScript npm package version (e.g., 'latest', '5.3.0')",
+			"default": "5.9.3"
+		},
+		"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/mcp-qdrant/poststart-hook.sh

@@ -35,7 +35,8 @@ if [ -n "${MODEL_URL}" ] && [ ! -d "${FASTEMBED_CACHE}/${MODEL_DIR}" ]; then
         tar -xzf "${TEMP_TAR}" -C "${FASTEMBED_CACHE}/" 2>/dev/null || true
         find "${FASTEMBED_CACHE}" -name "._*" -delete 2>/dev/null || true
         rm -f "${TEMP_TAR}"
-        chmod -R 777 "${FASTEMBED_CACHE}" 2>/dev/null || true
+        chown -R "vscode:vscode" "${FASTEMBED_CACHE}" 2>/dev/null || true
+        chmod -R 755 "${FASTEMBED_CACHE}" 2>/dev/null || true
         echo "[mcp-qdrant] ✓ Embedding model downloaded to ${FASTEMBED_CACHE}/${MODEL_DIR}"
     else
         echo "[mcp-qdrant] WARNING: Failed to download embedding model"

package/.devcontainer/features/ruff/devcontainer-feature.json

@@ -1,21 +1,19 @@
 {
-  "id": "ruff",
-  "version": "1.0.0",
-  "name": "Ruff",
-  "description": "Fast Python linter and formatter (replaces Black + Flake8)",
-  "options": {
-    "version": {
-      "type": "string",
-      "default": "latest",
-      "description": "Ruff version to install"
-    },
-    "username": {
-      "type": "string",
-      "default": "automatic",
-      "description": "Container user to install for"
-    }
-  },
-  "installsAfter": [
-    "ghcr.io/devcontainers-extra/features/uv"
-  ]
+	"id": "ruff",
+	"version": "1.0.0",
+	"name": "Ruff",
+	"description": "Fast Python linter and formatter (replaces Black + Flake8)",
+	"options": {
+		"version": {
+			"type": "string",
+			"default": "0.15.1",
+			"description": "Ruff version to install"
+		},
+		"username": {
+			"type": "string",
+			"default": "automatic",
+			"description": "Container user to install for"
+		}
+	},
+	"installsAfter": ["ghcr.io/devcontainers-extra/features/uv"]
 }

package/.devcontainer/features/tmux/install.sh

@@ -11,9 +11,9 @@ fi
 
 echo "Installing tmux for Claude Code Agent Teams..."
 
-# Install tmux via apt
+# Install tmux and inotify-tools via apt
 apt-get update
-apt-get install -y tmux
+apt-get install -y tmux inotify-tools
 
 # Install Catppuccin theme (shallow clone for fast builds)
 CATPPUCCIN_DIR="/usr/share/tmux/plugins/catppuccin"

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

@@ -90,7 +90,7 @@
 		},
 		{
 			"name": "code-directive",
-			"description": "17 custom agents, 16 coding skills, agent redirection, syntax validation, and skill auto-suggestion",
+			"description": "17 custom agents, 28 coding skills, agent redirection, syntax validation, and skill auto-suggestion",
 			"version": "1.0.0",
 			"source": "./plugins/code-directive",
 			"category": "development"
@@ -101,6 +101,13 @@
 			"version": "1.0.0",
 			"source": "./plugins/auto-code-quality",
 			"category": "development"
+		},
+		{
+			"name": "workspace-scope-guard",
+			"description": "Enforces working directory scope — blocks writes and warns on reads outside the project",
+			"version": "1.0.0",
+			"source": "./plugins/workspace-scope-guard",
+			"category": "safety"
 		}
 	]
 }

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

@@ -0,0 +1,81 @@
+# 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-linter/README.md

@@ -0,0 +1,92 @@
+# 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