codeforge-dev 1.13.0 → 1.14.2

package/.devcontainer/plugins/devs-marketplace/plugins/workspace-scope-guard/scripts/inject-workspace-cwd.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""
+CWD context injector — injects working directory into Claude's context
+on every session start, user prompt, tool call, and subagent spawn.
+
+Fires on: SessionStart, UserPromptSubmit, PreToolUse, SubagentStart
+Always exits 0 (advisory, never blocking).
+"""
+
+import json
+import os
+import sys
+
+
+def main():
+    cwd = os.getcwd()
+    try:
+        input_data = json.load(sys.stdin)
+        # Some hook events provide cwd override
+        cwd = input_data.get("cwd", cwd)
+        hook_event = input_data.get("hook_event_name", "PreToolUse")
+    except (json.JSONDecodeError, ValueError):
+        hook_event = "PreToolUse"
+
+    context = (
+        f"Working Directory: {cwd}\n"
+        f"All file operations and commands MUST target paths within {cwd}. "
+        f"Do not read, write, or execute commands against paths outside this directory."
+    )
+
+    json.dump(
+        {
+            "hookSpecificOutput": {
+                "hookEventName": hook_event,
+                "additionalContext": context,
+            }
+        },
+        sys.stdout,
+    )
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/.devcontainer/scripts/setup-aliases.sh

@@ -70,6 +70,7 @@ for rc in ~/.bashrc ~/.zshrc; do
 
 ${BLOCK_START}
 export CLAUDE_CONFIG_DIR="${CLAUDE_CONFIG_DIR}"
+export GH_CONFIG_DIR="${GH_CONFIG_DIR:-/workspaces/.gh}"
 export LANG=en_US.UTF-8
 export LC_ALL=en_US.UTF-8
 
@@ -82,10 +83,17 @@ else
     _CLAUDE_BIN=claude
 fi
 
-alias cc='CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 command "\$_CLAUDE_BIN" --system-prompt-file "\$CLAUDE_CONFIG_DIR/main-system-prompt.md" --permission-mode plan --allow-dangerously-skip-permissions'
-alias claude='CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 command "\$_CLAUDE_BIN" --system-prompt-file "\$CLAUDE_CONFIG_DIR/main-system-prompt.md" --permission-mode plan --allow-dangerously-skip-permissions'
+# ChromaTerm wrapper (if ct is installed, wrap claude through it)
+if command -v ct >/dev/null 2>&1; then
+    _CLAUDE_WRAP="ct"
+else
+    _CLAUDE_WRAP="command"
+fi
+
+alias cc='CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 "\$_CLAUDE_WRAP" "\$_CLAUDE_BIN" --system-prompt-file "\$CLAUDE_CONFIG_DIR/main-system-prompt.md" --permission-mode plan --allow-dangerously-skip-permissions'
+alias claude='CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 "\$_CLAUDE_WRAP" "\$_CLAUDE_BIN" --system-prompt-file "\$CLAUDE_CONFIG_DIR/main-system-prompt.md" --permission-mode plan --allow-dangerously-skip-permissions'
 alias ccraw='command "\$_CLAUDE_BIN"'
-alias ccw='CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 command "\$_CLAUDE_BIN" --system-prompt-file "\$CLAUDE_CONFIG_DIR/writing-system-prompt.md" --permission-mode plan --allow-dangerously-skip-permissions'
+alias ccw='CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 "\$_CLAUDE_WRAP" "\$_CLAUDE_BIN" --system-prompt-file "\$CLAUDE_CONFIG_DIR/writing-system-prompt.md" --permission-mode plan --allow-dangerously-skip-permissions'
 
 cc-tools() {
   echo "CodeForge Available Tools"
@@ -93,9 +101,9 @@ cc-tools() {
   printf "  %-20s %s\n" "COMMAND" "STATUS"
   echo "  ────────────────────────────────────"
   for cmd in claude cc ccw ccraw ccusage ccburn claude-monitor \\
-             ccms cargo ruff biome dprint shfmt shellcheck hadolint \\
+             ccms ct cargo ruff biome dprint shfmt shellcheck hadolint \\
              ast-grep tree-sitter pyright typescript-language-server \\
-             agent-browser gh docker git jq tmux bun go; do
+             agent-browser gh docker git jq tmux bun go infocmp; do
     if command -v "\$cmd" >/dev/null 2>&1; then
       ver=\$("\$cmd" --version 2>/dev/null | head -1 || echo "installed")
       printf "  %-20s ✓ %s\n" "\$cmd" "\$ver"

package/.devcontainer/scripts/setup-config.sh

@@ -45,6 +45,7 @@ expand_vars() {
 	local val="$1"
 	val="${val//\$\{CLAUDE_CONFIG_DIR\}/$CLAUDE_CONFIG_DIR}"
 	val="${val//\$\{WORKSPACE_ROOT\}/$WORKSPACE_ROOT}"
+	val="${val//\$\{HOME\}/$HOME}"
 	# Warn on any remaining unresolved ${...} tokens
 	if [[ "$val" =~ \$\{[^}]+\} ]]; then
 		warn "Unresolved variable in: $val"

package/README.md

@@ -66,13 +66,13 @@ tree-sitter (JS/TS/Python), ast-grep, Pyright, TypeScript LSP
 
 `claude`, `cc` (wrapper), `ccw` (writing mode wrapper), `ccusage`, `ccburn`, `ccstatusline`, `claude-monitor`
 
-### Custom Features (18)
+### Custom Features (21)
 
-tmux, agent-browser, claude-monitor, ccusage, ccburn, ccstatusline, ast-grep, tree-sitter, lsp-servers, biome, ruff, shfmt, shellcheck, hadolint, dprint, ccms, notify-hook, mcp-qdrant
+tmux, agent-browser, claude-monitor, ccusage, ccburn, ccstatusline, ast-grep, tree-sitter, lsp-servers, biome, ruff, shfmt, shellcheck, hadolint, dprint, ccms, notify-hook, mcp-qdrant, chromaterm, kitty-terminfo, claude-session-dashboard
 
-### Agents (17) & Skills (28)
+### Agents (17) & Skills (34)
 
-The `code-directive` plugin includes 17 specialized agents (architect, explorer, test-writer, security-auditor, etc.) and 28 domain-specific coding reference skills (fastapi, svelte5, docker, testing, spec-workflow, security-checklist, etc.).
+The `agent-system` plugin includes 17 specialized agents (architect, explorer, test-writer, security-auditor, etc.). The `skill-engine` plugin provides 21 general coding skills, `spec-workflow` adds 8 spec lifecycle skills, and `ticket-workflow` provides 4 ticket management skills.
 
 ## Quick Start
 
@@ -102,7 +102,7 @@ npm publish
 
 ## Changelog
 
-See [CHANGELOG.md](.devcontainer/CHANGELOG.md) for release history. Current version: **1.12.0** (2026-02-18).
+See [CHANGELOG.md](.devcontainer/CHANGELOG.md) for release history. Current version: **1.14.0** (2026-02-23).
 
 ## Further Reading
 

package/package.json

@@ -1,13 +1,17 @@
 {
 	"name": "codeforge-dev",
-	"version": "1.13.0",
+	"version": "1.14.2",
 	"description": "Complete development container that sets up Claude Code with modular devcontainer features, modern dev tools, and persistent configurations. Drop it into any project and get a production-ready AI development environment in minutes.",
 	"main": "setup.js",
 	"bin": {
 		"codeforge": "setup.js"
 	},
 	"scripts": {
-		"test": "node test.js"
+		"test": "node test.js",
+		"prepublishOnly": "npm test",
+		"docs:dev": "npm run dev --prefix docs",
+		"docs:build": "npm run build --prefix docs",
+		"docs:preview": "npm run preview --prefix docs"
 	},
 	"keywords": [
 		"devcontainer",

package/setup.js

@@ -10,6 +10,7 @@ const DEFAULT_PRESERVE = [
 	"config/defaults/settings.json",
 	"config/defaults/main-system-prompt.md",
 	"config/defaults/keybindings.json",
+	"config/defaults/ccstatusline-settings.json",
 	"config/file-manifest.json",
 	".codeforge-preserve",
 ];
@@ -244,8 +245,8 @@ function printNextSteps() {
 function printFeatures() {
 	console.log("Features included:");
 	console.log("  - Claude Code CLI with optimized tool configuration");
-	console.log("  - MCP servers: Qdrant (vector memory), Reasoner");
-	console.log("  - Development tools: Node.js LTS, Python 3.14, Go, Bun");
+	console.log("  - MCP servers: Qdrant (vector memory)");
+	console.log("  - Development tools: Node.js LTS, Python 3.14, Rust, Bun");
 	console.log("  - Persistent configuration and shell history");
 	console.log("");
 }

package/.devcontainer/.env

@@ -1,33 +0,0 @@
-# CodeForge Environment Configuration
-
-# Paths
-CLAUDE_CONFIG_DIR=/workspaces/.claude
-# CONFIG_SOURCE_DIR is derived from script location; uncomment to override:
-# CONFIG_SOURCE_DIR=/custom/path/to/config
-
-# Setup: copy config files to CLAUDE_CONFIG_DIR
-SETUP_CONFIG=true
-
-# Setup: add cc alias to shell rc files
-SETUP_ALIASES=true
-
-# Setup: configure Git and NPM auth from .secrets file
-SETUP_AUTH=true
-
-# Setup: install official Anthropic plugins
-SETUP_PLUGINS=true
-
-# Setup: auto-update Claude Code CLI to latest on container start (runs in background)
-SETUP_UPDATE_CLAUDE=true
-
-# Setup: configure VS Code Shift+Enter keybinding for Claude Code terminal
-SETUP_TERMINAL=true
-
-# Setup: auto-detect and register projects for VS Code Project Manager
-SETUP_PROJECTS=true
-
-# Setup: run post-start hooks from /usr/local/devcontainer-poststart.d/
-SETUP_POSTSTART=true
-
-# Plugin blacklist (comma-separated plugin names to skip during auto-install)
-PLUGIN_BLACKLIST=""

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