codeforge-dev 1.10.0 → 1.12.0

package/.devcontainer/features/mcp-reasoner/README.md

@@ -1,177 +0,0 @@
-# MCP Reasoner Server Feature
-
-A DevContainer Feature that installs and configures the MCP Reasoner server for enhanced AI reasoning capabilities.
-
-## Quick Start
-
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/node:1": {},
-    "ghcr.io/devcontainers/features/common-utils:2": {},
-    "./features/mcp-reasoner": {}
-  }
-}
-```
-
-**Note:** This feature requires Node.js and common-utils features to be installed first.
-
-## Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `username` | string | `automatic` | User to install for (auto-detects: vscode, node, codespace, or root) |
-
-## What This Feature Installs
-
-- **mcp-reasoner**: Cloned from GitHub and built locally
-- **Native MCP Support**: Uses devcontainer native `mcpServers` configuration (declarative)
-- **Install Location**: `/home/{username}/mcp-reasoner`
-
-## Requirements
-
-This feature has explicit dependencies that **must** be installed first:
-
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/node:1": {},
-    "ghcr.io/devcontainers/features/common-utils:2": {},
-    "./features/mcp-reasoner": {}
-  }
-}
-```
-
-**Required by this feature:**
-- **Node.js + npm**: For building mcp-reasoner
-- **jq**: For safe JSON generation (from common-utils)
-
-The feature will validate these are present and exit with an error if missing.
-
-## Features
-
-- ✅ **Automatic Installation**: Clones and builds mcp-reasoner
-- ✅ **Idempotent**: Safe to run multiple times
-- ✅ **Multi-user**: Automatically detects container user
-- ✅ **Native DevContainer Support**: Uses native `mcpServers` configuration for declarative setup
-
-## Configuration
-
-### Native DevContainer MCP Support
-
-This feature uses the native devcontainer `mcpServers` configuration pattern, which means the MCP server is declared in the `devcontainer.json` settings automatically. The configuration is applied when the devcontainer is created:
-
-```json
-{
-  "customizations": {
-    "vscode": {
-      "settings": {
-        "mcp": {
-          "servers": {
-            "reasoner": {
-              "type": "stdio",
-              "command": "node",
-              "args": ["${userHome}/mcp-reasoner/dist/index.js"]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-**No manual steps required!** The MCP server is automatically available to your AI agent once the devcontainer starts.
-
-### Verify It Worked
-
-**1. Start your AI agent** (Claude Code or other MCP-compatible agent)
-
-**2. Verify the server is available:**
-
-Ask your AI agent:
-```
-"Show me what MCP servers you have available"
-```
-
-You should see `reasoner` listed among the available MCP servers.
-
-**3. Test directly (optional):**
-```bash
-node ~/mcp-reasoner/dist/index.js
-```
-
-## Usage with AI Agents
-
-### Claude Code
-
-The MCP Reasoner server provides enhanced reasoning capabilities for your AI agent.
-
-## Architecture
-
-```
-AI Agent (Claude Code, etc.)
-    ↓
-Model Context Protocol
-    ↓
-mcp-reasoner (Node.js)
-    ↓
-Reasoning capabilities
-```
-
-## Troubleshooting
-
-### Server Not Appearing in AI Agent
-
-**Symptom:** Installation succeeds but agent doesn't see MCP Reasoner server
-
-**Solution:**
-1. Ensure the devcontainer is running the latest image (rebuild if needed)
-2. Restart your AI agent to reload MCP server configurations
-3. Check that the dist file exists: `ls -la ~/mcp-reasoner/dist/index.js`
-
-### Installation Fails: "node is not available"
-
-**Cause:** Node feature not installed first
-
-**Solution:** Add Node feature before mcp-reasoner:
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/node:1": {},
-    "./features/mcp-reasoner": {}
-  }
-}
-```
-
-### Installation Fails: "jq is not available"
-
-**Cause:** common-utils feature not installed
-
-**Solution:** Add common-utils feature:
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/common-utils:2": {},
-    "./features/mcp-reasoner": {}
-  }
-}
-```
-
-### Build Fails
-
-**Symptom:** npm build errors during installation
-
-**Checks:**
-- Verify Node.js version is compatible: `node --version`
-- Check npm is available: `npm --version`
-- Review build output for specific errors
-
-## Resources
-
-- [MCP Reasoner GitHub](https://github.com/Jacck/mcp-reasoner)
-- [Model Context Protocol](https://modelcontextprotocol.io)
-
-## License
-
-MIT License - See repository for details.

package/.devcontainer/features/mcp-reasoner/devcontainer-feature.json

@@ -1,25 +0,0 @@
-{
-  "id": "mcp-reasoner",
-  "version": "1.0.3",
-  "name": "MCP Reasoner Server",
-  "description": "Installs MCP Reasoner server for enhanced AI reasoning capabilities",
-  "maintainer": "AnExiledDev",
-  "documentationURL": "https://github.com/Jacck/mcp-reasoner",
-  "options": {
-    "version": {
-      "type": "string",
-      "description": "Version to install (or 'none' to skip installation)",
-      "default": "latest"
-    },
-    "username": {
-      "type": "string",
-      "description": "Container user to install for",
-      "default": "automatic"
-    }
-  },
-  "installsAfter": [
-    "ghcr.io/devcontainers/features/node:1",
-    "ghcr.io/devcontainers/features/common-utils:2",
-    "ghcr.io/anthropics/devcontainer-features/claude-code:1"
-  ]
-}

package/.devcontainer/features/mcp-reasoner/install.sh

@@ -1,184 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-# No cleanup needed - using CLI instead of temp files
-
-# Import options
-VERSION="${VERSION:-latest}"
-USERNAME="${USERNAME:-automatic}"
-
-# Skip installation if version is "none"
-if [ "${VERSION}" = "none" ]; then
-    echo "[mcp-reasoner] Skipping installation (version=none)"
-    exit 0
-fi
-
-echo "[mcp-reasoner] Starting MCP Reasoner installation..."
-
-# Source NVM (Node is installed via NVM by the node feature)
-if [ -f /usr/local/share/nvm/nvm.sh ]; then
-    source /usr/local/share/nvm/nvm.sh
-fi
-
-# Validate node is available
-if ! command -v node &>/dev/null; then
-    echo "[mcp-reasoner] ERROR: node is not available. Please ensure node feature is installed first."
-    echo "  NVM path: /usr/local/share/nvm/nvm.sh"
-    exit 1
-fi
-
-# Validate npm is available
-if ! command -v npm &>/dev/null; then
-    echo "[mcp-reasoner] ERROR: npm is not available. Please ensure node feature is installed first."
-    exit 1
-fi
-
-# Determine the 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 "[mcp-reasoner] Installing for user: ${USERNAME}"
-
-INSTALL_DIR="/home/${USERNAME}/mcp-reasoner"
-DIST_FILE="${INSTALL_DIR}/dist/index.js"
-
-if [[ -f "$DIST_FILE" ]]; then
-    echo "[mcp-reasoner] MCP-reasoner installation already present. Skipping..."
-else
-    echo "[mcp-reasoner] Installing MCP-reasoner to ${INSTALL_DIR}"
-
-    # Clone and build as detected user with NVM environment
-    sudo -u "${USERNAME}" bash -c "
-        source /usr/local/share/nvm/nvm.sh
-        cd /home/${USERNAME}
-
-        # Remove existing directory if present (handles failed previous runs)
-        rm -rf mcp-reasoner
-
-        # Clone the repository
-        git clone https://github.com/Jacck/mcp-reasoner.git
-        cd mcp-reasoner
-
-        # Install dependencies and build
-        npm install
-        npm run build
-    "
-
-    # Verify installation
-    if [[ ! -f "$DIST_FILE" ]]; then
-        echo "[mcp-reasoner] ERROR: MCP-reasoner installation failed - dist/index.js not found"
-        exit 1
-    fi
-
-    echo "[mcp-reasoner] MCP-reasoner installed successfully"
-fi
-
-# Create post-start hook for Claude Code registration
-echo "[mcp-reasoner] Creating post-start hook for Claude Code registration..."
-mkdir -p /usr/local/devcontainer-poststart.d
-
-cat > /usr/local/devcontainer-poststart.d/51-mcp-reasoner.sh <<'HOOK_EOF'
-#!/bin/bash
-set -euo pipefail
-
-echo "[mcp-reasoner] Registering Reasoner MCP server with Claude Code..."
-
-# Determine user
-USERNAME="${USERNAME:-vscode}"
-if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
-    for CURRENT_USER in vscode node codespace; do
-        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
-            USERNAME=${CURRENT_USER}
-            break
-        fi
-    done
-fi
-
-# Check if reasoner is installed
-REASONER_PATH="/home/${USERNAME}/mcp-reasoner/dist/index.js"
-if [ ! -f "$REASONER_PATH" ]; then
-    echo "[mcp-reasoner] WARNING: Reasoner not found at $REASONER_PATH, skipping registration"
-    exit 0
-fi
-
-# Ensure settings.json exists
-SETTINGS_FILE="/workspaces/.claude/settings.json"
-if [ ! -f "$SETTINGS_FILE" ]; then
-    echo "[mcp-reasoner] ERROR: $SETTINGS_FILE not found"
-    exit 1
-fi
-
-# Check if jq is available
-if ! command -v jq &>/dev/null; then
-    echo "[mcp-reasoner] ERROR: jq not available"
-    exit 1
-fi
-
-# Build the server configuration
-SERVER_CONFIG=$(jq -n \
-    --arg cmd "node" \
-    --arg path "$REASONER_PATH" \
-    '{
-        command: $cmd,
-        args: [$path]
-    }')
-
-# Update settings.json - add or update reasoner server
-# Create temporary file for atomic update
-TEMP_FILE=$(mktemp)
-jq --argjson server "$SERVER_CONFIG" \
-    '.mcpServers.reasoner = $server' \
-    "$SETTINGS_FILE" > "$TEMP_FILE"
-
-# Verify the JSON is valid
-if jq empty "$TEMP_FILE" 2>/dev/null; then
-    mv "$TEMP_FILE" "$SETTINGS_FILE"
-    echo "[mcp-reasoner] ✓ Reasoner MCP server registered in Claude Code settings"
-else
-    echo "[mcp-reasoner] ERROR: Generated invalid JSON"
-    rm -f "$TEMP_FILE"
-    exit 1
-fi
-
-# Set proper permissions
-chmod 644 "$SETTINGS_FILE"
-chown "$(id -un):$(id -gn)" "$SETTINGS_FILE" 2>/dev/null || true
-
-echo "[mcp-reasoner] ✓ Configuration complete"
-HOOK_EOF
-
-chmod +x /usr/local/devcontainer-poststart.d/51-mcp-reasoner.sh
-echo "[mcp-reasoner] ✓ Post-start hook created at /usr/local/devcontainer-poststart.d/51-mcp-reasoner.sh"
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  MCP Reasoner Installation Complete"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "Configuration:"
-echo "  • Install Path: ${INSTALL_DIR}"
-echo "  • User: ${USERNAME}"
-echo "  • MCP Server: reasoner (native devcontainer support)"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  Next Steps"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "1. MCP server will auto-register with Claude Code on container start"
-echo ""
-echo "2. Test the server directly:"
-echo "   node ${DIST_FILE}"
-echo ""
-echo "3. Verify available MCP servers in your AI agent"
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/mcp-reasoner/poststart-hook.sh

@@ -1,67 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-echo "[mcp-reasoner] Registering Reasoner MCP server with Claude Code..."
-
-# Determine user
-USERNAME="${USERNAME:-vscode}"
-if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
-    for CURRENT_USER in vscode node codespace; do
-        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
-            USERNAME=${CURRENT_USER}
-            break
-        fi
-    done
-fi
-
-# Check if reasoner is installed
-REASONER_PATH="/home/${USERNAME}/mcp-reasoner/dist/index.js"
-if [ ! -f "$REASONER_PATH" ]; then
-    echo "[mcp-reasoner] WARNING: Reasoner not found at $REASONER_PATH, skipping registration"
-    exit 0
-fi
-
-# Ensure settings.json exists
-SETTINGS_FILE="/workspaces/.claude/settings.json"
-if [ ! -f "$SETTINGS_FILE" ]; then
-    echo "[mcp-reasoner] ERROR: $SETTINGS_FILE not found"
-    exit 1
-fi
-
-# Check if jq is available
-if ! command -v jq &>/dev/null; then
-    echo "[mcp-reasoner] ERROR: jq not available"
-    exit 1
-fi
-
-# Build the server configuration
-SERVER_CONFIG=$(jq -n \
-    --arg cmd "node" \
-    --arg path "$REASONER_PATH" \
-    '{
-        command: $cmd,
-        args: [$path]
-    }')
-
-# Update settings.json - add or update reasoner server
-# Create temporary file for atomic update
-TEMP_FILE=$(mktemp)
-jq --argjson server "$SERVER_CONFIG" \
-    '.mcpServers.reasoner = $server' \
-    "$SETTINGS_FILE" > "$TEMP_FILE"
-
-# Verify the JSON is valid
-if jq empty "$TEMP_FILE" 2>/dev/null; then
-    mv "$TEMP_FILE" "$SETTINGS_FILE"
-    echo "[mcp-reasoner] ✓ Reasoner MCP server registered in Claude Code settings"
-else
-    echo "[mcp-reasoner] ERROR: Generated invalid JSON"
-    rm -f "$TEMP_FILE"
-    exit 1
-fi
-
-# Set proper permissions
-chmod 644 "$SETTINGS_FILE"
-chown vscode:vscode "$SETTINGS_FILE" 2>/dev/null || true
-
-echo "[mcp-reasoner] ✓ Configuration complete"

package/.devcontainer/features/splitrail/README.md

@@ -1,140 +0,0 @@
-# Splitrail Token Usage Tracker Feature
-
-A DevContainer Feature that installs Splitrail - a real-time AI token usage tracker and cost monitor for AI coding agents.
-
-## Quick Start
-
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/rust:1": {},
-    "ghcr.io/devcontainers/features/common-utils:2": {},
-    "./features/splitrail": {}
-  }
-}
-```
-
-**Note:** This feature requires Rust and common-utils features to be installed first.
-
-## Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `repoUrl` | string | `https://github.com/Piebald-AI/splitrail.git` | Git repository URL |
-| `branch` | string | `main` | Git branch to checkout |
-| `username` | string | `automatic` | User to install for (auto-detects: vscode, node, codespace, or root) |
-
-## What This Feature Installs
-
-- **splitrail**: Compiled from source (Rust)
-- **Binary Location**: `/home/{username}/.cargo/bin/splitrail`
-- **Compile Time**: 2-3 minutes on first build
-- **Disk Usage**: ~50MB source + build artifacts
-
-## Requirements
-
-This feature has explicit dependencies that **must** be installed first:
-
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/rust:1": {},
-    "ghcr.io/devcontainers/features/common-utils:2": {},
-    "./features/splitrail": {}
-  }
-}
-```
-
-**Required by this feature:**
-- **Rust + Cargo**: For compiling splitrail from source
-- **Git**: For cloning the repository
-
-The feature will validate these are present and exit with an error if missing.
-
-## Features
-
-- ✅ **Real-time Tracking**: Monitor token usage as you code
-- ✅ **Cost Monitoring**: Track costs for different AI models
-- ✅ **Multi-agent Support**: Supports Claude Code, Gemini, Codex
-- ✅ **Cloud Upload**: Optional private cloud aggregation across machines
-- ✅ **Fast Performance**: Written in Rust for minimal overhead
-- ✅ **Idempotent**: Safe to run multiple times
-- ✅ **Multi-user**: Automatically detects container user
-
-## Usage
-
-### Start Monitoring
-
-```bash
-splitrail
-```
-
-### Check Version
-
-```bash
-splitrail --version
-```
-
-### View Help
-
-```bash
-splitrail --help
-```
-
-## Architecture
-
-```
-AI Agent (Claude Code, etc.)
-    ↓
-Splitrail monitors usage
-    ↓
-Real-time display + optional cloud upload
-```
-
-## Troubleshooting
-
-### Compilation Fails
-
-**Cause:** Rust/Cargo not available
-
-**Solution:** Ensure Rust feature is installed first:
-```json
-{
-  "features": {
-    "ghcr.io/devcontainers/features/rust:1": {},
-    "./features/splitrail": {}
-  }
-}
-```
-
-### Binary Not Found
-
-**Symptom:** `splitrail: command not found`
-
-**Solution:** Check the binary location:
-```bash
-ls -la /home/node/.cargo/bin/splitrail
-# Should exist
-
-# Verify PATH includes cargo bin
-echo $PATH | grep cargo
-```
-
-### Build Errors
-
-**Symptom:** Cargo build fails during compilation
-
-**Checks:**
-- Verify Rust version: `rustc --version`
-- Check cargo: `cargo --version`
-- Review build output for specific errors
-- Try cleaning: `cd ~/splitrail && cargo clean && cargo build --release`
-
-## Resources
-
-- [Splitrail GitHub](https://github.com/Piebald-AI/splitrail)
-- [Rust Language](https://www.rust-lang.org/)
-
-## License
-
-MIT License - See repository for details.

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

@@ -1,39 +0,0 @@
-{
-  "id": "splitrail",
-  "version": "1.0.1",
-  "name": "Splitrail Token Usage Tracker",
-  "description": "Installs Splitrail - real-time AI token usage tracker and cost monitor",
-  "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",
-      "default": "https://github.com/Piebald-AI/splitrail.git"
-    },
-    "branch": {
-      "type": "string",
-      "description": "Git branch to checkout",
-      "default": "main"
-    },
-    "username": {
-      "type": "string",
-      "description": "Container user to install for",
-      "default": "automatic"
-    }
-  },
-  "installsAfter": [
-    "ghcr.io/devcontainers/features/rust:1",
-    "ghcr.io/devcontainers/features/common-utils:2"
-  ],
-  "customizations": {
-    "vscode": {
-      "extensions": []
-    }
-  }
-}