codeforge-dev 1.12.0 → 1.14.1

package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/README.md

@@ -50,45 +50,31 @@ Biome is resolved in this order:
 
 ## Installation
 
-### 1. Place the plugin
+### CodeForge DevContainer
 
-Copy the `auto-code-quality/` directory into your Claude Code plugin marketplace:
+Pre-installed and activated automatically — no setup needed.
 
-```
-your-marketplace/
-├── .claude-plugin/
-│   └── marketplace.json
-└── plugins/
-    └── auto-code-quality/    ← this directory
-```
+### From GitHub
 
-### 2. Register in marketplace.json
+Use this plugin in any Claude Code setup:
 
-Add this entry to your `marketplace.json` `plugins` array:
-
-```json
-{
-  "name": "auto-code-quality",
-  "description": "Self-contained code quality: auto-format + auto-lint edited files",
-  "version": "1.0.0",
-  "source": "./plugins/auto-code-quality",
-  "category": "development"
-}
-```
+1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
 
-### 3. Enable in settings.json
+   ```bash
+   git clone https://github.com/AnExiledDev/CodeForge.git
+   ```
 
-Add to your Claude Code `settings.json` under `enabledPlugins`:
+2. Enable the plugin in your `.claude/settings.json`:
 
-```json
-{
-  "enabledPlugins": {
-    "auto-code-quality@your-marketplace": true
-  }
-}
-```
+   ```json
+   {
+     "enabledPlugins": {
+       "auto-code-quality@<clone-path>/.devcontainer/plugins/devs-marketplace": true
+     }
+   }
+   ```
 
-Replace `your-marketplace` with the name of your marketplace.
+   Replace `<clone-path>` with the absolute path to your CodeForge clone.
 
 ## How It Works
 

package/.devcontainer/plugins/devs-marketplace/plugins/auto-code-quality/hooks/hooks.json

@@ -20,7 +20,6 @@
 		],
 		"Stop": [
 			{
-				"matcher": "",
 				"hooks": [
 					{
 						"type": "command",
@@ -31,6 +30,11 @@
 						"type": "command",
 						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lint-file.py",
 						"timeout": 60
+					},
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/advisory-test-runner.py",
+						"timeout": 20
 					}
 				]
 			}

package/.devcontainer/plugins/devs-marketplace/plugins/{code-directive → auto-code-quality}/scripts/advisory-test-runner.py

@@ -4,11 +4,11 @@ Advisory test runner — Stop hook that injects test results as context.
 
 Reads the list of files edited this session (written by collect-edited-files.py),
 maps them to affected test files, and runs only those tests. Skips entirely
-if no files were edited. Results are returned as additionalContext so Claude
-sees pass/fail info without being blocked.
+if no files were edited. Results are returned as systemMessage (pass/timeout) or decision/reason
+block (failure) so Claude acts on test failures before finishing.
 
 Reads hook input from stdin (JSON). Returns JSON on stdout.
-Always exits 0 (advisory, never blocking).
+Always exits 0. Failures use decision: "block" to prevent stopping.
 """
 
 import json
@@ -310,9 +310,7 @@ def main():
         )
     except subprocess.TimeoutExpired:
         json.dump(
-            {
-                "additionalContext": f"[Tests] {framework} timed out after {TIMEOUT_SECONDS}s"
-            },
+            {"systemMessage": f"[Tests] {framework} timed out after {TIMEOUT_SECONDS}s"},
             sys.stdout,
         )
         sys.exit(0)
@@ -323,7 +321,7 @@ def main():
 
     if result.returncode == 0:
         json.dump(
-            {"additionalContext": f"[Tests] All tests passed ({framework})"},
+            {"systemMessage": f"[Tests] All tests passed ({framework})"},
             sys.stdout,
         )
         sys.exit(0)
@@ -337,7 +335,10 @@ def main():
         output = "...(truncated)\n" + "\n".join(lines[-30:])
 
     json.dump(
-        {"additionalContext": (f"[Tests] Some tests FAILED ({framework}):\n{output}")},
+        {
+            "decision": "block",
+            "reason": f"[Tests] Some tests FAILED ({framework}):\n{output}",
+        },
         sys.stdout,
     )
     sys.exit(0)

package/.devcontainer/plugins/devs-marketplace/plugins/codeforge-lsp/README.md

@@ -20,6 +20,34 @@ The plugin uses the `lspServers` field in `plugin.json` to declare server config
 
 Each server maps file extensions to language identifiers. When Claude Code opens a file matching a registered extension, it routes it to the corresponding LSP server for diagnostics, completions, and other language features.
 
+## Installation
+
+### CodeForge DevContainer
+
+Pre-installed and activated automatically — no setup needed.
+
+### From GitHub
+
+Use this plugin in any Claude Code setup:
+
+1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
+
+   ```bash
+   git clone https://github.com/AnExiledDev/CodeForge.git
+   ```
+
+2. Enable the plugin in your `.claude/settings.json`:
+
+   ```json
+   {
+     "enabledPlugins": {
+       "codeforge-lsp@<clone-path>/.devcontainer/plugins/devs-marketplace": true
+     }
+   }
+   ```
+
+   Replace `<clone-path>` with the absolute path to your CodeForge clone.
+
 ## Plugin Structure
 
 ```

package/.devcontainer/plugins/devs-marketplace/plugins/dangerous-command-blocker/README.md

@@ -53,6 +53,34 @@ Claude calls the Bash tool
 
 The hook has a 5-second timeout. If the script takes longer, Claude Code proceeds with the command.
 
+## Installation
+
+### CodeForge DevContainer
+
+Pre-installed and activated automatically — no setup needed.
+
+### From GitHub
+
+Use this plugin in any Claude Code setup:
+
+1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
+
+   ```bash
+   git clone https://github.com/AnExiledDev/CodeForge.git
+   ```
+
+2. Enable the plugin in your `.claude/settings.json`:
+
+   ```json
+   {
+     "enabledPlugins": {
+       "dangerous-command-blocker@<clone-path>/.devcontainer/plugins/devs-marketplace": true
+     }
+   }
+   ```
+
+   Replace `<clone-path>` with the absolute path to your CodeForge clone.
+
 ## Plugin Structure
 
 ```

package/.devcontainer/plugins/devs-marketplace/plugins/dangerous-command-blocker/scripts/block-dangerous.py

@@ -116,8 +116,8 @@ def main():
         is_dangerous, message = check_command(command)
 
         if is_dangerous:
-            # Output error message and exit 2 to block
-            print(json.dumps({"error": message}))
+            # Output error to stderr (exit 2 ignores stdout)
+            print(message, file=sys.stderr)
             sys.exit(2)
 
         # Allow command to proceed

package/.devcontainer/plugins/devs-marketplace/plugins/notify-hook/README.md

@@ -25,6 +25,34 @@ Claude stops responding (Stop event)
 
 The hook has a 5-second timeout. The plugin contains no scripts of its own — it delegates entirely to the `claude-notify` binary.
 
+## Installation
+
+### CodeForge DevContainer
+
+Pre-installed and activated automatically — no setup needed.
+
+### From GitHub
+
+Use this plugin in any Claude Code setup:
+
+1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
+
+   ```bash
+   git clone https://github.com/AnExiledDev/CodeForge.git
+   ```
+
+2. Enable the plugin in your `.claude/settings.json`:
+
+   ```json
+   {
+     "enabledPlugins": {
+       "notify-hook@<clone-path>/.devcontainer/plugins/devs-marketplace": true
+     }
+   }
+   ```
+
+   Replace `<clone-path>` with the absolute path to your CodeForge clone.
+
 ## Plugin Structure
 
 ```

package/.devcontainer/plugins/devs-marketplace/plugins/notify-hook/hooks/hooks.json

@@ -3,7 +3,6 @@
   "hooks": {
     "Stop": [
       {
-        "matcher": "",
         "hooks": [
           {
             "type": "command",

package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/README.md

@@ -66,6 +66,34 @@ The Bash guard parses commands for write-indicating patterns and extracts the ta
 
 Both hooks have a 5-second timeout.
 
+## Installation
+
+### CodeForge DevContainer
+
+Pre-installed and activated automatically — no setup needed.
+
+### From GitHub
+
+Use this plugin in any Claude Code setup:
+
+1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
+
+   ```bash
+   git clone https://github.com/AnExiledDev/CodeForge.git
+   ```
+
+2. Enable the plugin in your `.claude/settings.json`:
+
+   ```json
+   {
+     "enabledPlugins": {
+       "protected-files-guard@<clone-path>/.devcontainer/plugins/devs-marketplace": true
+     }
+   }
+   ```
+
+   Replace `<clone-path>` with the absolute path to your CodeForge clone.
+
 ## Plugin Structure
 
 ```

package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/scripts/guard-protected-bash.py

@@ -104,7 +104,7 @@ def main():
         for target in targets:
             is_protected, message = check_path(target)
             if is_protected:
-                print(json.dumps({"error": f"{message} (via bash command)"}))
+                print(f"{message} (via bash command)", file=sys.stderr)
                 sys.exit(2)
 
         sys.exit(0)

package/.devcontainer/plugins/devs-marketplace/plugins/protected-files-guard/scripts/guard-protected.py

@@ -89,8 +89,8 @@ def main():
         is_protected, message = check_path(file_path)
 
         if is_protected:
-            # Output error message and exit 2 to block
-            print(json.dumps({"error": message}))
+            # Output error to stderr (exit 2 ignores stdout)
+            print(message, file=sys.stderr)
             sys.exit(2)
 
         # Allow edit to proceed

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

@@ -0,0 +1,7 @@
+{
+	"name": "session-context",
+	"description": "Session lifecycle hooks: git state injection, TODO harvesting, and commit reminders",
+	"author": {
+		"name": "AnExiledDev"
+	}
+}

package/.devcontainer/plugins/devs-marketplace/plugins/session-context/README.md

@@ -0,0 +1,140 @@
+# session-context
+
+Claude Code plugin that injects contextual information at session boundaries. Provides git state awareness at session start, surfaces TODO/FIXME markers, and reminds about uncommitted changes when Claude finishes responding.
+
+## What It Does
+
+Three hooks that run automatically at session lifecycle boundaries:
+
+| Phase | Script | What It Injects |
+|-------|--------|-----------------|
+| Session start | `git-state-injector.py` | Current branch, status, recent commits, uncommitted changes |
+| Session start | `todo-harvester.py` | Count and top 10 TODO/FIXME/HACK/XXX markers in the codebase |
+| Stop | `commit-reminder.py` | Advisory about staged/unstaged changes that should be committed |
+
+All hooks are non-blocking and cap their output to prevent context bloat.
+
+### Git State Injection
+
+Runs at session start and injects:
+- Current branch name
+- Working tree status (up to 20 lines)
+- Recent commit log
+- Diff stat of uncommitted changes (up to 15 lines)
+- Total output capped at 2000 characters
+
+### TODO Harvesting
+
+Scans source files for tech debt markers and injects a summary:
+- Searches for `TODO`, `FIXME`, `HACK`, `XXX` comments
+- File types: `.py`, `.ts`, `.tsx`, `.js`, `.jsx`, `.go`, `.rs`, `.sh`, `.svelte`, `.vue`, `.rb`, `.java`, `.kt`
+- Shows total count plus top 10 items
+- Output capped at 800 characters
+
+### Commit Reminder
+
+Fires when Claude stops responding and checks for uncommitted work:
+- Detects staged and unstaged changes
+- Injects an advisory so Claude can naturally ask if the user wants to commit
+- Uses a guard flag to prevent infinite loops (the reminder itself is a Stop event)
+
+## How It Works
+
+### Hook Lifecycle
+
+```
+Session starts
+  |
+  +-> SessionStart fires
+  |     |
+  |     +-> git-state-injector.py
+  |     |     |
+  |     |     +-> Runs git branch, status, log, diff --stat
+  |     |     +-> Caps output, injects as additionalContext
+  |     |
+  |     +-> todo-harvester.py
+  |           |
+  |           +-> Greps codebase for TODO/FIXME/HACK/XXX
+  |           +-> Injects count + top 10 as additionalContext
+  |
+  |  ... Claude works ...
+  |
+Claude stops responding
+  |
+  +-> Stop fires
+        |
+        +-> commit-reminder.py
+              |
+              +-> Checks git status for changes
+              +-> Has changes? -> Inject commit advisory
+              +-> No changes? -> Silent (no output)
+```
+
+### Exit Code Behavior
+
+All three scripts exit 0 (advisory only). They never block operations.
+
+### Error Handling
+
+| Scenario | Behavior |
+|----------|----------|
+| Not a git repository | Silent exit (no output) |
+| Git command failure | Silent exit (no output) |
+| JSON parse failure | Silent exit |
+
+### Timeouts
+
+| Hook | Timeout |
+|------|---------|
+| Git state injection | 10s |
+| TODO harvesting | 8s |
+| Commit reminder | 8s |
+
+## Installation
+
+### CodeForge DevContainer
+
+Pre-installed and activated automatically — no setup needed.
+
+### From GitHub
+
+Use this plugin in any Claude Code setup:
+
+1. Clone the [CodeForge](https://github.com/AnExiledDev/CodeForge) repository:
+
+   ```bash
+   git clone https://github.com/AnExiledDev/CodeForge.git
+   ```
+
+2. Enable the plugin in your `.claude/settings.json`:
+
+   ```json
+   {
+     "enabledPlugins": {
+       "session-context@<clone-path>/.devcontainer/plugins/devs-marketplace": true
+     }
+   }
+   ```
+
+   Replace `<clone-path>` with the absolute path to your CodeForge clone.
+
+## Plugin Structure
+
+```
+session-context/
++-- .claude-plugin/
+|   +-- plugin.json            # Plugin metadata
++-- hooks/
+|   +-- hooks.json             # Hook registrations (SessionStart + Stop)
++-- scripts/
+|   +-- git-state-injector.py  # Git state context (SessionStart)
+|   +-- todo-harvester.py      # Tech debt markers (SessionStart)
+|   +-- commit-reminder.py     # Uncommitted changes advisory (Stop)
++-- README.md                  # This file
+```
+
+## Requirements
+
+- Python 3.11+
+- Git (for git state injection and commit reminders)
+- Claude Code with plugin hook support

package/.devcontainer/plugins/devs-marketplace/plugins/session-context/hooks/hooks.json

@@ -0,0 +1,33 @@
+{
+	"description": "Context injection at session boundaries: git state, TODO harvesting, commit reminders",
+	"hooks": {
+		"SessionStart": [
+			{
+				"matcher": "",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/git-state-injector.py",
+						"timeout": 10
+					},
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/todo-harvester.py",
+						"timeout": 8
+					}
+				]
+			}
+		],
+		"Stop": [
+			{
+				"hooks": [
+					{
+						"type": "command",
+						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/commit-reminder.py",
+						"timeout": 8
+					}
+				]
+			}
+		]
+	}
+}

package/.devcontainer/plugins/devs-marketplace/plugins/{code-directive → session-context}/scripts/commit-reminder.py

@@ -7,7 +7,8 @@ an advisory reminder as additionalContext. Claude sees it and can
 naturally ask the user if they want to commit.
 
 Reads hook input from stdin (JSON). Returns JSON on stdout.
-Always exits 0 (advisory, never blocking).
+Blocks with decision/reason so Claude addresses uncommitted changes
+before finishing. The stop_hook_active guard prevents infinite loops.
 """
 
 import json
@@ -82,7 +83,7 @@ def main():
         "Consider asking the user if they'd like to commit before finishing."
     )
 
-    json.dump({"additionalContext": message}, sys.stdout)
+    json.dump({"decision": "block", "reason": message}, sys.stdout)
     sys.exit(0)
 
 

package/.devcontainer/plugins/devs-marketplace/plugins/{code-directive → session-context}/scripts/git-state-injector.py

@@ -64,7 +64,15 @@ def main():
             f"Working Directory: {cwd} — restrict all file operations to this "
             f"directory unless explicitly instructed otherwise."
         )
-        json.dump({"additionalContext": output}, sys.stdout)
+        json.dump(
+            {
+                "hookSpecificOutput": {
+                    "hookEventName": "SessionStart",
+                    "additionalContext": output,
+                }
+            },
+            sys.stdout,
+        )
         sys.exit(0)
 
     sections = []
@@ -117,7 +125,15 @@ def main():
     if len(output) > TOTAL_OUTPUT_CAP:
         output = output[:TOTAL_OUTPUT_CAP] + "\n...(truncated)"
 
-    json.dump({"additionalContext": output}, sys.stdout)
+    json.dump(
+        {
+            "hookSpecificOutput": {
+                "hookEventName": "SessionStart",
+                "additionalContext": output,
+            }
+        },
+        sys.stdout,
+    )
     sys.exit(0)
 
 

package/.devcontainer/plugins/devs-marketplace/plugins/{code-directive → session-context}/scripts/todo-harvester.py

@@ -122,7 +122,15 @@ def main():
     if len(body) > TOTAL_OUTPUT_CAP:
         body = body[:TOTAL_OUTPUT_CAP] + "\n...(truncated)"
 
-    json.dump({"additionalContext": body}, sys.stdout)
+    json.dump(
+        {
+            "hookSpecificOutput": {
+                "hookEventName": "SessionStart",
+                "additionalContext": body,
+            }
+        },
+        sys.stdout,
+    )
     sys.exit(0)
 
 

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

@@ -0,0 +1,7 @@
+{
+	"name": "skill-engine",
+	"description": "21 coding knowledge packs with auto-suggestion for frameworks, tools, and patterns",
+	"author": {
+		"name": "AnExiledDev"
+	}
+}