codeforge-dev 1.9.0 → 1.10.0

package/.devcontainer/connect-external-terminal.sh

@@ -30,15 +30,15 @@ echo "Searching for running devcontainer..."
 CONTAINER_ID=$(docker ps --filter "label=$CONTAINER_LABEL" --format "{{.ID}}" | head -n1)
 
 if [ -z "$CONTAINER_ID" ]; then
-    echo ""
-    echo "ERROR: No running devcontainer found."
-    echo ""
-    echo "Make sure your devcontainer is running:"
-    echo "  1. Open VS Code"
-    echo "  2. Open the folder containing .devcontainer/"
-    echo "  3. Use 'Dev Containers: Reopen in Container'"
-    echo ""
-    exit 1
+	echo ""
+	echo "ERROR: No running devcontainer found."
+	echo ""
+	echo "Make sure your devcontainer is running:"
+	echo "  1. Open VS Code"
+	echo "  2. Open the folder containing .devcontainer/"
+	echo "  3. Use 'Dev Containers: Reopen in Container'"
+	echo ""
+	exit 1
 fi
 
 # Get container name for display
@@ -47,10 +47,10 @@ echo "Found container: $CONTAINER_NAME ($CONTAINER_ID)"
 echo ""
 
 # Check if tmux is available in the container
-if ! docker exec "$CONTAINER_ID" which tmux > /dev/null 2>&1; then
-    echo "ERROR: tmux is not installed in the container."
-    echo "Rebuild the devcontainer to install the tmux feature."
-    exit 1
+if ! docker exec "$CONTAINER_ID" which tmux >/dev/null 2>&1; then
+	echo "ERROR: tmux is not installed in the container."
+	echo "Rebuild the devcontainer to install the tmux feature."
+	exit 1
 fi
 
 echo "Connecting to tmux session '$TMUX_SESSION'..."
@@ -68,14 +68,14 @@ echo ""
 # Pass UTF-8 locale so tmux renders Unicode correctly (not as underscores)
 # Use tmux -u to force UTF-8 mode as a belt-and-suspenders measure
 exec docker exec -it \
-  -e LANG=en_US.UTF-8 \
-  -e LC_ALL=en_US.UTF-8 \
-  --user vscode "$CONTAINER_ID" bash -c "
+	-e LANG=en_US.UTF-8 \
+	-e LC_ALL=en_US.UTF-8 \
+	--user vscode "$CONTAINER_ID" bash -c "
   export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
   if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
     tmux -u attach-session -t '$TMUX_SESSION'
   else
-    tmux -u new-session -d -s '$TMUX_SESSION' -c /workspaces
+    tmux -u new-session -d -s '$TMUX_SESSION' -c \"\${WORKSPACE_ROOT:-/workspaces}\"
     sleep 0.5
     tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
     tmux -u attach-session -t '$TMUX_SESSION'

package/.devcontainer/devcontainer.json

@@ -1,144 +1,143 @@
-{
-  "name": "CodeForge - ${localWorkspaceFolderBasename}",
-  "image": "mcr.microsoft.com/devcontainers/python:3.14",
-
-  "workspaceFolder": "/workspaces",
-  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces,type=bind",
-
-  "remoteEnv": {
-    "WORKSPACE_ROOT": "/workspaces",
-    "CLAUDE_CONFIG_DIR": "/workspaces/.claude",
-    "GH_CONFIG_DIR": "/workspaces/.gh",
-    "TMPDIR": "/workspaces/.tmp"
-  },
-
-  // Feature install order: external runtimes first (Node, uv, Go, Bun),
-  // then Claude Code (needs Node), then custom features.
-  // npm-dependent features (agent-browser, ccusage, ccburn, biome, lsp-servers)
-  // must come after Node. uv-dependent features (ruff, claude-monitor) must
-  // come after uv. notify-hook is last (lightweight, no dependencies).
-  "overrideFeatureInstallOrder": [
-    "ghcr.io/devcontainers/features/node",
-    "ghcr.io/devcontainers/features/github-cli",
-    "ghcr.io/devcontainers/features/docker-outside-of-docker",
-    "ghcr.io/devcontainers-extra/features/uv",
-    "ghcr.io/devcontainers/features/go",
-    "ghcr.io/rails/devcontainer/features/bun",
-    "ghcr.io/anthropics/devcontainer-features/claude-code",
-    "./features/tmux",
-    "./features/agent-browser",
-    "./features/claude-monitor",
-    "./features/ccusage",
-    "./features/ccburn",
-    "./features/ccstatusline",
-    "./features/ast-grep",
-    "./features/tree-sitter",
-    "./features/lsp-servers",
-    "./features/ruff",
-    "./features/shfmt",
-    "./features/dprint",
-    "./features/shellcheck",
-    "./features/hadolint",
-    "./features/biome",
-    "./features/notify-hook"
-  ],
-
-  "features": {
-    "ghcr.io/devcontainers/features/node:1": {
-      "version": "lts",
-      "nodeGypDependencies": true
-    },
-    "ghcr.io/devcontainers/features/github-cli:1": {},
-    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": 
-    {
-      "moby": false
-    },
-    "ghcr.io/devcontainers-extra/features/uv:1": {},
-    "ghcr.io/rails/devcontainer/features/bun:1.0.2": {},
-    "ghcr.io/anthropics/devcontainer-features/claude-code:1": {},
-    "./features/tmux": {},
-    "./features/ccusage": {
-      "version": "latest",
-      "shells": "both",
-      "username": "automatic"
-    },
-    "./features/claude-monitor": {
-      "version": "latest",
-      "installer": "uv",
-      "username": "automatic"
-    },
-    "./features/ccburn": {
-      "version": "latest",
-      "shells": "both",
-      "username": "automatic"
-    },
-    "./features/ccstatusline": {
-      "username": "automatic"
-    },
-    "./features/ast-grep": {},
-    "./features/tree-sitter": {},
-    "./features/lsp-servers": {},
-    "./features/agent-browser": {},
-    "./features/ruff": {
-      "version": "latest",
-      "username": "automatic"
-    },
-    "./features/shfmt": {},
-    "./features/dprint": {
-      "username": "automatic"
-    },
-    "./features/shellcheck": {},
-    "./features/hadolint": {},
-    "./features/biome": {},
-    "./features/notify-hook": {
-      "enableBell": true,
-      "enableOsc": true
-    }
-  },
-
-  "postStartCommand": "bash ${containerWorkspaceFolder}/.devcontainer/scripts/setup.sh",
-
-  "remoteUser": "vscode",
-  "containerUser": "vscode",
-
-  "customizations": {
-    "vscode": {
-      "settings": {
-        "terminal.integrated.profiles.linux": {
-          "bash": {
-            "path": "bash"
-          },
-          "Claude Teams (tmux)": {
-            "path": "bash",
-            "args": ["-c", "if tmux has-session -t claude-teams 2>/dev/null; then exec tmux -u new-session -t claude-teams; else exec tmux -u new-session -s claude-teams; fi"]
-          }
-        },
-        "terminal.integrated.defaultProfile.linux": "bash",
-        "terminal.integrated.enableBell": true,
-        "terminal.integrated.commandsToSkipShell": [
-          "-workbench.action.quickOpen",
-          "-workbench.action.terminal.focusFind"
-        ],
-        "remote.extensionKind": {
-          "wenbopan.vscode-terminal-osc-notifier": ["ui"]
-        },
-        "projectManager.git.baseFolders": ["/workspaces"],
-        "projectManager.git.maxDepthRecursion": 1,
-        "projectManager.showProjectNameInStatusBar": true,
-        "projectManager.openInNewWindowWhenClickingInStatusBar": false,
-        "projectManager.projectsLocation": "/workspaces/.config/project-manager"
-      },
-      "extensions": [
-        "wenbopan.vscode-terminal-osc-notifier",
-        "GitHub.vscode-github-actions",
-        "fabiospampinato.vscode-todo-plus",
-        "alefragnani.project-manager"
-      ]
-    }
-  },
-
-  "runArgs": [
-    "--memory=4g",
-    "--memory-swap=8g"
-  ]
-}
+{
+	"name": "CodeForge - ${localWorkspaceFolderBasename}",
+	"image": "mcr.microsoft.com/devcontainers/python:3.14",
+
+	"workspaceFolder": "/workspaces",
+	"workspaceMount": "source=${localWorkspaceFolder},target=/workspaces,type=bind",
+
+	"remoteEnv": {
+		"WORKSPACE_ROOT": "/workspaces",
+		"CLAUDE_CONFIG_DIR": "/workspaces/.claude",
+		"GH_CONFIG_DIR": "/workspaces/.gh",
+		"TMPDIR": "/workspaces/.tmp"
+	},
+
+	// Feature install order: external runtimes first (Node, uv, Go, Bun),
+	// then Claude Code (needs Node), then custom features.
+	// npm-dependent features (agent-browser, ccusage, ccburn, biome, lsp-servers)
+	// must come after Node. uv-dependent features (ruff, claude-monitor) must
+	// come after uv. notify-hook is last (lightweight, no dependencies).
+	"overrideFeatureInstallOrder": [
+		"ghcr.io/devcontainers/features/node",
+		"ghcr.io/devcontainers/features/github-cli",
+		"ghcr.io/devcontainers/features/docker-outside-of-docker",
+		"ghcr.io/devcontainers-extra/features/uv",
+		"ghcr.io/rails/devcontainer/features/bun",
+		"ghcr.io/anthropics/devcontainer-features/claude-code",
+		"./features/tmux",
+		"./features/agent-browser",
+		"./features/claude-monitor",
+		"./features/ccusage",
+		"./features/ccburn",
+		"./features/ccstatusline",
+		"./features/ast-grep",
+		"./features/tree-sitter",
+		"./features/lsp-servers",
+		"./features/ruff",
+		"./features/shfmt",
+		"./features/dprint",
+		"./features/shellcheck",
+		"./features/hadolint",
+		"./features/biome",
+		"./features/notify-hook"
+	],
+
+	"features": {
+		"ghcr.io/devcontainers/features/node:1": {
+			"version": "lts",
+			"nodeGypDependencies": true
+		},
+		"ghcr.io/devcontainers/features/github-cli:1": {},
+		"ghcr.io/devcontainers/features/docker-outside-of-docker:1": {
+			"moby": false
+		},
+		"ghcr.io/devcontainers-extra/features/uv:1": {},
+		"ghcr.io/rails/devcontainer/features/bun:1.0.2": {},
+		"ghcr.io/anthropics/devcontainer-features/claude-code:1": {},
+		"./features/tmux": {},
+		"./features/ccusage": {
+			"version": "latest",
+			"shells": "both",
+			"username": "automatic"
+		},
+		"./features/claude-monitor": {
+			"version": "latest",
+			"installer": "uv",
+			"username": "automatic"
+		},
+		"./features/ccburn": {
+			"version": "latest",
+			"shells": "both",
+			"username": "automatic"
+		},
+		"./features/ccstatusline": {
+			"username": "automatic"
+		},
+		"./features/ast-grep": {},
+		"./features/tree-sitter": {},
+		"./features/lsp-servers": {},
+		"./features/agent-browser": {},
+		"./features/ruff": {
+			"version": "latest",
+			"username": "automatic"
+		},
+		"./features/shfmt": { "version": "none" },
+		"./features/dprint": {
+			"version": "none",
+			"username": "automatic"
+		},
+		"./features/shellcheck": { "version": "none" },
+		"./features/hadolint": { "version": "none" },
+		"./features/biome": {},
+		"./features/notify-hook": {
+			"enableBell": true,
+			"enableOsc": true
+		}
+	},
+
+	"postStartCommand": "bash ${containerWorkspaceFolder}/.devcontainer/scripts/setup.sh",
+
+	"remoteUser": "vscode",
+	"containerUser": "vscode",
+
+	"customizations": {
+		"vscode": {
+			"settings": {
+				"terminal.integrated.profiles.linux": {
+					"bash": {
+						"path": "bash"
+					},
+					"Claude Teams (tmux)": {
+						"path": "bash",
+						"args": [
+							"-c",
+							"if tmux has-session -t claude-teams 2>/dev/null; then exec tmux -u new-session -t claude-teams; else exec tmux -u new-session -s claude-teams; fi"
+						]
+					}
+				},
+				"terminal.integrated.defaultProfile.linux": "bash",
+				"terminal.integrated.enableBell": true,
+				"terminal.integrated.commandsToSkipShell": [
+					"-workbench.action.quickOpen",
+					"-workbench.action.terminal.focusFind"
+				],
+				"remote.extensionKind": {
+					"wenbopan.vscode-terminal-osc-notifier": ["ui"]
+				},
+				"projectManager.git.baseFolders": ["/workspaces"],
+				"projectManager.git.maxDepthRecursion": 2,
+				"projectManager.showProjectNameInStatusBar": true,
+				"projectManager.openInNewWindowWhenClickingInStatusBar": false,
+				"projectManager.projectsLocation": "/workspaces/.config/project-manager"
+			},
+			"extensions": [
+				"wenbopan.vscode-terminal-osc-notifier",
+				"GitHub.vscode-github-actions",
+				"fabiospampinato.vscode-todo-plus",
+				"alefragnani.project-manager"
+			]
+		}
+	},
+
+	"runArgs": ["--memory=6g", "--memory-swap=12g"]
+}

package/.devcontainer/plugins/devs-marketplace/plugins/code-directive/agents/architect.md

@@ -171,8 +171,9 @@ Based on your exploration:
    or update. Distinguish:
    - **Roadmap entry**: one-line description of what the version delivers (no
      implementation detail — that belongs in specs)
-   - **Feature spec**: ≤200 line file following the standard template (Version,
-     Status, Intent, Acceptance Criteria, Key Files, Schema, API, Dependencies)
+   - **Feature spec**: file following the standard template (Version,
+     Status, Intent, Acceptance Criteria, Key Files, Schema, API, Dependencies).
+     Aim for ~200 lines; split into sub-specs if significantly longer.
    - **As-built update**: if modifying an existing feature, identify which spec
      to update post-implementation
    Plans that mix roadmap-level and spec-level detail produce artifacts too
@@ -239,7 +240,7 @@ List the 3-7 files most critical for implementing this plan:
 - `/path/to/test_file.py` — Brief reason (e.g., "Test patterns to follow")
 
 ### Documentation Outputs
-- New spec: `.specs/vX.Y.0/feature-name.md` (≤200 lines)
+- New spec: `.specs/vX.Y.0/feature-name.md`
 - Updated spec: `.specs/vX.Y.0/existing-feature.md` — changes: [list]
 - Roadmap update: `.specs/roadmap.md` — add `[ ] feature` to vX.Y.0
 

package/.devcontainer/plugins/devs-marketplace/plugins/code-directive/agents/doc-writer.md

@@ -160,9 +160,9 @@ For large codebases, focus on the public API surface rather than trying to docum
 
 Produce documentation that serves the target audience. Different doc types have different readers.
 
-**Sizing rule:** Documentation files consumed by AI (CLAUDE.md, specs, architecture docs)
-should be ≤200 lines each. Split large documents by concern. Each file should be
-independently useful without requiring other docs in the same context window.
+**Sizing guideline:** Documentation files consumed by AI (CLAUDE.md, specs, architecture docs)
+should aim for ~200 lines each. Split large documents by concern when practical. Each file
+should be independently useful without requiring other docs in the same context window.
 
 ## Documentation Types
 

package/.devcontainer/plugins/devs-marketplace/plugins/code-directive/agents/spec-writer.md

@@ -20,6 +20,7 @@ skills:
   - spec-update
   - spec-check
   - spec-init
+  - spec-refine
 ---
 
 # Spec Writer Agent
@@ -57,10 +58,14 @@ When uncertain, investigate first — read the code, check the docs — rather t
 - **NEVER** make assumptions about behavior without checking the codebase. Use `Read`, `Glob`, and `Grep` to understand the current system before specifying changes.
 - **NEVER** write vague requirements like "the system should be fast" or "the UI should be user-friendly." Every requirement must be specific, measurable, and testable.
 - **NEVER** combine multiple independent requirements into a single statement. One requirement per line — this makes requirements individually testable and trackable.
-- **NEVER** produce a specification exceeding 200 lines. If a feature requires
-  more, split it into independently loadable sub-specs (one per sub-feature)
-  with a parent overview file that links them. Monolithic specs rot faster
-  than they're consumed — no AI context window can use a 4,000-line spec.
+- **NEVER** present decisions as settled facts unless the user explicitly approved them. Tech choices, architecture decisions, scope boundaries, performance targets, and behavioral defaults that you chose without user input MUST go in `## Open Questions` with options and trade-offs — not in Requirements as decided items.
+- **ALL** requirements you generate MUST be tagged `[assumed]`. You never produce `[user-approved]` requirements — only `/spec-refine` does that after explicit user validation.
+- **ALL** specs you produce MUST carry `**Approval:** draft`. After presenting a draft, state: "This spec requires `/spec-refine` before implementation can begin. All requirements are marked [assumed] until user-approved."
+- **Aim for ~200 lines per spec.** When a spec grows beyond that, recommend
+  splitting into sub-specs in a feature subdirectory with a parent overview
+  that links them. Shorter specs are easier to consume and maintain, but
+  complex features sometimes need more space — don't sacrifice completeness
+  for an arbitrary cap.
 - **NEVER** reproduce source code, SQL schemas, or type definitions inline.
   Reference file paths instead (e.g., "see `src/engine/db/migrations/002.sql`
   lines 48-70"). The code is the source of truth; duplicated snippets go stale.
@@ -116,9 +121,10 @@ Write the specification using the formats below.
 3. **Write acceptance criteria** — Given/When/Then scenarios that define "done."
 4. **Define non-functional requirements** — Performance, security, accessibility where relevant.
 5. **List open questions** — Any unresolved decisions or unknowns that need stakeholder input.
-6. **Check length** — Count lines. If the draft exceeds 200 lines, split into
-   sub-specs by feature boundary. Create a parent overview (≤50 lines) linking
-   the sub-specs. Each sub-spec must be independently loadable.
+6. **Check length** — If the draft exceeds ~200 lines, consider whether it
+   would be clearer as sub-specs split by feature boundary with a parent
+   overview linking them. Each sub-spec should be independently loadable.
+   If the length is justified by complexity, note it and proceed.
 7. **Reference, don't reproduce** — Scan your draft for inline code blocks
    containing schemas, SQL, type definitions, or configuration. Replace with
    file path references and brief descriptions of what's there.
@@ -235,6 +241,7 @@ Present specifications in this structure:
 **Version:** v0.X.0
 **Status:** planned
 **Last Updated:** YYYY-MM-DD
+**Approval:** draft
 
 ## Intent
 [Problem statement + why — what exists now, what should change, who is affected]
@@ -258,18 +265,21 @@ Present specifications in this structure:
 ## Requirements
 
 ### Functional Requirements
-FR-1: [EARS requirement]
-FR-2: [EARS requirement]
+FR-1 [assumed]: [EARS requirement]
+FR-2 [assumed]: [EARS requirement]
 ...
 
 ### Non-Functional Requirements
-NFR-1: [EARS requirement]
-NFR-2: [EARS requirement]
+NFR-1 [assumed]: [EARS requirement]
+NFR-2 [assumed]: [EARS requirement]
 ...
 
 ## Dependencies
 - [External system or module this feature depends on]
 
+## Resolved Questions
+[Populated by `/spec-refine`. Decisions explicitly approved by the user.]
+
 ## Open Questions
 [Group related unknowns. For each question, provide:]
 1. [Question] — **Type**: missing info / ambiguous behavior / policy decision

package/.devcontainer/plugins/devs-marketplace/plugins/code-directive/hooks/hooks.json

@@ -49,7 +49,7 @@
 					{
 						"type": "command",
 						"command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/advisory-test-runner.py",
-						"timeout": 65
+						"timeout": 20
 					},
 					{
 						"type": "command",