codeforge-dev 1.14.1 → 2.0.0

package/.devcontainer/scripts/setup.sh

@@ -1,4 +1,6 @@
 #!/bin/bash
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (c) 2026 Marcus Krueger
 # Master setup script for CodeForge devcontainer
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -12,9 +14,50 @@ if [ -f "$ENV_FILE" ]; then
     set +a
 fi
 
+# Deprecation guard: .env may still set CLAUDE_CONFIG_DIR=/workspaces/.claude
+# (pre-v2.0 default). Since .env is gitignored, PR updates can't fix it.
+# Override with warning so all child scripts use the correct home location.
+if [ "$CLAUDE_CONFIG_DIR" = "/workspaces/.claude" ]; then
+    echo "[setup] WARNING: CLAUDE_CONFIG_DIR=/workspaces/.claude is deprecated (moved to home dir in v2.0)"
+    echo "[setup]   Updating .devcontainer/.env automatically."
+    CLAUDE_CONFIG_DIR="$HOME/.claude"
+    # Fix the file on disk so subsequent restarts don't trigger this guard
+    if [ -f "$ENV_FILE" ]; then
+        sed -i 's|^CLAUDE_CONFIG_DIR=.*/workspaces/\.claude.*|# CLAUDE_CONFIG_DIR removed (v2.0: now uses $HOME/.claude)|' "$ENV_FILE"
+        echo "[setup]   .env updated — CLAUDE_CONFIG_DIR line commented out."
+    fi
+fi
+
+# Deprecation guard: CONFIG_SOURCE_DIR may still point to /workspaces/.claude
+# (pre-v2.0 default was to keep config source in workspace .claude dir).
+# Override with correct path.
+if [ "$CONFIG_SOURCE_DIR" = "/workspaces/.claude" ]; then
+    echo "[setup] WARNING: CONFIG_SOURCE_DIR=/workspaces/.claude is deprecated (moved to .devcontainer/config in v2.0)"
+    echo "[setup]   Updating .devcontainer/.env automatically."
+    CONFIG_SOURCE_DIR="$DEVCONTAINER_DIR/config"
+    if [ -f "$ENV_FILE" ]; then
+        sed -i 's|^CONFIG_SOURCE_DIR=.*/workspaces/\.claude.*|# CONFIG_SOURCE_DIR removed (v2.0: now uses .devcontainer/config)|' "$ENV_FILE"
+        echo "[setup]   .env updated — CONFIG_SOURCE_DIR line commented out."
+    fi
+fi
+
+# Deprecation guard: CONFIG_SOURCE_DIR may still point to .devcontainer/config
+# (pre-v2.0 default). Redirect to .codeforge.
+if [ "$CONFIG_SOURCE_DIR" = "$DEVCONTAINER_DIR/config" ] || [ "$CONFIG_SOURCE_DIR" = "/workspaces/.devcontainer/config" ]; then
+    echo "[setup] WARNING: CONFIG_SOURCE_DIR pointing to .devcontainer/config is deprecated (moved to .codeforge in v2.0)"
+    echo "[setup]   Redirecting to .codeforge."
+    : "${CODEFORGE_DIR:=${WORKSPACE_ROOT:?}/.codeforge}"
+    unset CONFIG_SOURCE_DIR
+    if [ -f "$ENV_FILE" ]; then
+        sed -i 's|^CONFIG_SOURCE_DIR=.*\.devcontainer/config.*|# CONFIG_SOURCE_DIR removed (v2.0: now uses .codeforge)|' "$ENV_FILE"
+        echo "[setup]   .env updated — CONFIG_SOURCE_DIR line commented out."
+    fi
+fi
+
 # Apply defaults for any unset variables
-: "${CLAUDE_CONFIG_DIR:=/workspaces/.claude}"
-: "${CONFIG_SOURCE_DIR:=$DEVCONTAINER_DIR/config}"
+: "${CLAUDE_CONFIG_DIR:=$HOME/.claude}"
+: "${CODEFORGE_DIR:=${WORKSPACE_ROOT:?}/.codeforge}"
+: "${CONFIG_SOURCE_DIR:=$CODEFORGE_DIR}"
 : "${SETUP_CONFIG:=true}"
 : "${SETUP_ALIASES:=true}"
 : "${SETUP_AUTH:=true}"
@@ -24,7 +67,13 @@ fi
 : "${SETUP_TERMINAL:=true}"
 : "${SETUP_POSTSTART:=true}"
 
-export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES SETUP_AUTH SETUP_PLUGINS SETUP_UPDATE_CLAUDE SETUP_PROJECTS SETUP_TERMINAL SETUP_POSTSTART
+export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR CODEFORGE_DIR SETUP_CONFIG SETUP_ALIASES SETUP_AUTH SETUP_PLUGINS SETUP_UPDATE_CLAUDE SETUP_PROJECTS SETUP_TERMINAL SETUP_POSTSTART
+
+# Fix named volume ownership — Docker creates named volumes as root:root
+# regardless of remoteUser. This is the only setup script requiring sudo.
+if ! sudo chown "$(id -un):$(id -gn)" "$HOME/.claude" 2>/dev/null; then
+    echo "[setup] WARNING: Could not fix volume ownership on $HOME/.claude — subsequent scripts may fail"
+fi
 
 SETUP_START=$(date +%s)
 SETUP_RESULTS=()
@@ -88,7 +137,8 @@ run_poststart_hooks() {
     fi
 }
 
-run_script "$SCRIPT_DIR/setup-symlink-claude.sh" "true"
+run_script "$SCRIPT_DIR/setup-migrate-claude.sh" "true"
+run_script "$SCRIPT_DIR/setup-migrate-codeforge.sh" "true"
 run_script "$SCRIPT_DIR/setup-auth.sh" "$SETUP_AUTH"
 run_script "$SCRIPT_DIR/setup-config.sh" "$SETUP_CONFIG"
 run_script "$SCRIPT_DIR/setup-aliases.sh" "$SETUP_ALIASES"
@@ -98,7 +148,9 @@ run_script "$SCRIPT_DIR/setup-terminal.sh" "$SETUP_TERMINAL"
 
 # Background the update to avoid blocking container start
 if [ "$SETUP_UPDATE_CLAUDE" = "true" ] && [ -f "$SCRIPT_DIR/setup-update-claude.sh" ]; then
-    bash "$SCRIPT_DIR/setup-update-claude.sh" &>/dev/null &
+    CLAUDE_UPDATE_LOG="${CLAUDE_UPDATE_LOG:-/workspaces/.tmp/claude-update.log}"
+    mkdir -p "$(dirname "$CLAUDE_UPDATE_LOG")"
+    bash "$SCRIPT_DIR/setup-update-claude.sh" >>"$CLAUDE_UPDATE_LOG" 2>&1 &
     disown
     SETUP_RESULTS+=("setup-update-claude:background")
 else

package/LICENSE.txt

@@ -1,3 +1,17 @@
+CodeForge — Copyright (c) 2026 Marcus Krueger (AnExiledDev)
+
+This software is dual-licensed:
+
+  1. GNU General Public License v3.0 (see below) — for open source use
+  2. Commercial License — available upon request for proprietary use
+
+For commercial licensing inquiries, contact:
+  696222+AnExiledDev@users.noreply.github.com
+
+SPDX-License-Identifier: GPL-3.0-only
+
+────────────────────────────────────────────────────────────────────────
+
                     GNU GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
 

package/README.md

@@ -7,9 +7,16 @@
 [![npm downloads](https://img.shields.io/npm/dm/codeforge-dev)](https://www.npmjs.com/package/codeforge-dev)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org/)
 [![GitHub issues](https://img.shields.io/github/issues/AnExiledDev/CodeForge)](https://github.com/AnExiledDev/CodeForge/issues)
+[![CI](https://github.com/AnExiledDev/CodeForge/actions/workflows/ci.yml/badge.svg)](https://github.com/AnExiledDev/CodeForge/actions/workflows/ci.yml)
 
 A curated development environment optimized for AI-powered coding with Claude Code. CodeForge comes pre-configured with language servers, code intelligence tools, and official Anthropic plugins to streamline your development workflow.
 
+## Why CodeForge?
+
+Claude Code is powerful out of the box, but getting the most from it takes significant configuration — custom agents, safety plugins, code quality hooks, system prompts, and development tools that aren't obvious from the docs. CodeForge is a Claude Code power user's personal development environment, packaged so anyone can use it.
+
+Instead of spending hours discovering and configuring advanced features like built-in agent replacement, automated code quality pipelines, or spec-driven workflows, you get a production-tested setup in one command. It's opinionated by design — every default reflects real daily use, not theoretical best practices.
+
 ## Installation
 
 Add CodeForge to any project:
@@ -41,7 +48,12 @@ npx codeforge-dev@1.2.3
 ## Prerequisites
 
 - **Docker Desktop** (or compatible container runtime like Podman)
-- **VS Code** with the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers), or **GitHub Codespaces**
+- **A DevContainer client** — any of:
+  - **VS Code** with the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
+  - **DevContainer CLI** — `npm install -g @devcontainers/cli` ([docs](https://containers.dev/supporting#devcontainer-cli))
+  - **GitHub Codespaces** — zero local setup
+  - **JetBrains Gateway** with [Dev Containers plugin](https://plugins.jetbrains.com/plugin/21962-dev-containers)
+  - **DevPod** — open-source, editor-agnostic ([devpod.sh](https://devpod.sh/))
 - **Claude Code authentication** — run `claude` on first start to authenticate
 
 ## What's Included
@@ -70,18 +82,80 @@ tree-sitter (JS/TS/Python), ast-grep, Pyright, TypeScript LSP
 
 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 (34)
+### Agents (17) & Skills (35)
+
+The `agent-system` plugin includes 17 specialized agents (architect, explorer, test-writer, security-auditor, etc.). The `skill-engine` plugin provides 22 general coding skills, `spec-workflow` adds 8 spec lifecycle skills, and `ticket-workflow` provides 4 ticket management skills.
+
+## Architecture
+
+CodeForge operates in three layers, each building on the one below:
+
+```
+┌──────────────────────────────────────────────┐
+│                 Claude Code                   │
+│   AI assistant, tool execution, Agent Teams   │
+├──────────────────────────────────────────────┤
+│               CodeForge Layer                 │
+│   Plugins · Agents · Skills · Hooks · Rules   │
+├──────────────────────────────────────────────┤
+│                DevContainer                   │
+│   Runtimes · CLI Tools · LSP Servers          │
+└──────────────────────────────────────────────┘
+```
+
+**DevContainer** — The foundation. A Python 3.14 container with Node.js, Rust, and Bun runtimes, plus 22 custom features that install development tools (ast-grep, tree-sitter, biome, ruff, and others).
+
+**CodeForge Layer** — The intelligence. 13 plugins register hooks that validate commands, inject context, and enforce safety. 17 agents provide specialized personas. 35 skills offer on-demand reference material. System prompts and rules shape behavior.
 
-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.
+**Claude Code** — The AI assistant, executing tools and coordinating work. CodeForge enhances it through configuration — replacing built-in subagents, adding safety guardrails, and wiring up quality checks that run automatically.
+
+For the full architecture breakdown — hook pipeline, agent routing, skill loading, and design principles — see the [Architecture Reference](https://codeforge.core-directive.com/reference/architecture/).
+
+## Configuration
+
+All configuration lives in `.devcontainer/` and deploys automatically on container start. Key files:
+
+| File | What It Configures | User-Modifiable? |
+|------|--------------------|------------------|
+| `config/defaults/settings.json` | Model, plugins, permissions, environment variables | Yes |
+| `config/defaults/main-system-prompt.md` | Claude's behavioral guidelines and directives | Yes |
+| `config/defaults/keybindings.json` | Keyboard shortcuts | Yes |
+| `config/defaults/ccstatusline-settings.json` | Terminal status bar widgets and layout | Yes |
+| `config/file-manifest.json` | Which config files deploy and how they update | Yes |
+| `devcontainer.json` | Container image, features, runtimes, ports | Yes |
+| `.env` | Setup phase toggles (auth, plugins, aliases, etc.) | Yes |
+
+Config files use SHA-256 change detection — your edits persist across container rebuilds unless the source changes. Set a file's overwrite mode to `"never"` in `file-manifest.json` to permanently preserve your customizations.
+
+For the complete configuration guide, see the [documentation site](https://codeforge.core-directive.com/customization/configuration/).
 
 ## Quick Start
 
 1. **Install**: `npx codeforge-dev`
-2. **Open in Container**: "Reopen in Container" in VS Code, or create a Codespace
+2. **Open in Container**:
+   - **VS Code**: "Reopen in Container" from the Command Palette
+   - **CLI**: `devcontainer up --workspace-folder .` then `docker exec -it <container> zsh`
+   - **Codespaces**: Create a Codespace from the repo
 3. **Authenticate**: Run `claude` and follow prompts
 4. **Start coding**: Run `cc`
 
-For full usage documentation — authentication, configuration, tools, agents, and keybindings — see [`.devcontainer/README.md`](.devcontainer/README.md).
+CodeForge uses the open [Dev Containers specification](https://containers.dev/) — any compatible client works. For full usage documentation — authentication, configuration, tools, agents, and keybindings — see [`.devcontainer/README.md`](.devcontainer/README.md).
+
+## Contributing
+
+We welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md)
+before submitting a pull request. All contributions require signing our
+[Contributor License Agreement](CLA.md).
+
+## License
+
+This project is licensed under the [GNU General Public License v3.0](LICENSE.txt).
+
+**Commercial licensing** is available for organizations that need to use CodeForge
+without GPL-3.0 obligations. Contact
+[696222+AnExiledDev@users.noreply.github.com](mailto:696222+AnExiledDev@users.noreply.github.com)
+or [open a GitHub issue](https://github.com/AnExiledDev/CodeForge/issues/new)
+for terms.
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "codeforge-dev",
-	"version": "1.14.1",
+	"version": "2.0.0",
 	"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": {
@@ -30,6 +30,7 @@
 	"license": "GPL-3.0",
 	"files": [
 		".devcontainer/**/*",
+		".codeforge/**/*",
 		"setup.js",
 		"README.md"
 	],