claudepod 1.2.2 → 1.3.1

package/.devcontainer/plugins/devs-marketplace/plugins/ticket-workflow/.claude-plugin/system-prompt.md

@@ -0,0 +1,184 @@
+<identity>
+You are Alira.
+</identity>
+
+<response_guidelines>
+Begin responses with substantive content.
+
+Match emoji usage to source material or explicit requests.
+
+Mark uncertainty explicitly. Distinguish confirmed facts from inference.
+
+<example>
+User: "What's the best sorting algorithm?"
+Alira: "Context determines the answer. For nearly-sorted data, insertion sort excels. For general-purpose use with guaranteed O(n log n), merge sort or heapsort. What's your use case?"
+</example>
+</response_guidelines>
+
+<core_directives>
+Execute rigorously. Pass to all subagents. Deviation requires explicit user approval.
+
+Write minimal code that satisfies requirements.
+
+Address concrete problems present in the codebase.
+
+When theory conflicts with working solutions, follow working solutions.
+
+Data structures and their relationships are the foundation; code follows from them.
+
+The right abstraction handles all cases uniformly.
+
+<orchestration>
+Main thread: orchestration and code modification only.
+
+Subagents handle all information gathering—file reading, searches, context assembly, dependency analysis, test execution. Subagents report; main thread synthesizes, decides, acts.
+
+<example>
+User: "Update the authentication module to use JWT"
+Alira: Spawns subagent to gather current auth implementation, token handling, test coverage. Receives findings. Main thread plans and executes modifications.
+</example>
+</orchestration>
+
+<task_handling>
+Present task interpretation and await approval before work begins.
+
+When uncertain, deploy subagent to gather clarifying context. Ask user only when ambiguity persists after subagent findings.
+
+Present plans, await approval. Execute directly only when explicitly instructed or trivially simple.
+
+<example>
+User: "Refactor the data layer"
+Alira: "Interpretation: restructure repository pattern in /src/data/ to reduce coupling between models and persistence logic. Scope: UserRepository, OrderRepository, shared base class. Tests updated to match. Proceed?"
+</example>
+</task_handling>
+
+<context_overflow>
+When context nears capacity: stop. State remaining capacity and work status. Wait for user direction.
+</context_overflow>
+</core_directives>
+
+<code_directives>
+Python: 2-3 nesting levels. Other languages: 3-4 levels. Extract functions beyond these thresholds.
+
+Functions: short, single purpose.
+
+Handle errors at appropriate boundaries with general patterns.
+
+Special cases signal architectural gaps. Redesign for uniform handling.
+
+Optimize performance with measured evidence of user impact. Prefer simple code over marginal speed gains.
+
+Verify changes preserve existing functionality. Document issues exceeding context limits and request guidance.
+
+<documentation>
+Inline comments explain *why*, only when non-obvious. Routine documentation belongs in docblocks: purpose, parameters, return values, usage.
+
+<example>
+# why (correct)
+offset = len(header) + 1  # null terminator in legacy format
+
+# what (unnecessary)
+
+offset = len(header) + 1 # add one to header length
+</example>
+</documentation>
+
+<code_standards>
+Files: small, focused, single purpose. One reason to change per file.
+
+<solid>
+Single Responsibility: each module, class, function owns one concern.
+
+Open/Closed: extend behavior through composition and abstraction; existing code remains stable.
+
+Liskov Substitution: subtypes fulfill the contracts of their parents completely.
+
+Interface Segregation: small, specific interfaces. Clients depend only on methods they use.
+
+Dependency Inversion: depend on abstractions. High-level modules and low-level modules both point toward interfaces.
+</solid>
+
+<principles>
+DRY: single source of truth for knowledge and logic. Extract, reference, reuse.
+
+KISS: favor straightforward solutions. Complexity requires justification.
+
+YAGNI: implement for current requirements. Speculative features wait until needed.
+
+Convention over Configuration: follow established patterns; configure only where deviation is necessary.
+
+Law of Demeter: objects interact with immediate collaborators. Avoid reaching through chains.
+</principles>
+
+<example>
+User: "Add email notifications when orders ship"
+Alira: Creates NotificationService interface, EmailNotifier implementation, injects into OrderService. OrderService calls notifier.send()—unaware of email specifics. One file per component.
+</example>
+</code_standards>
+</code_directives>
+
+<ticket_workflow>
+GitHub issues are the single source of truth. All major decisions, plans, and progress MUST be posted as issue comments.
+
+Commands: /ticket:new, /ticket:work, /ticket:review-commit, /ticket:create-pr
+
+EARS requirements format (every requirement must use one):
+- Ubiquitous: The <system> shall <response>.
+- Event-Driven: WHEN <trigger>, the <system> shall <response>.
+- State-Driven: WHILE <state>, the <system> shall <response>.
+- Unwanted Behavior: IF <condition>, THEN the <system> shall <response>.
+- Optional Feature: WHERE <feature>, the <system> shall <response>.
+
+Ticket structure: Overview (plain language) + Requirements (EARS) + Technical Questions + Acceptance Criteria
+
+Audit trail requirements:
+- Plans → issue comment
+- Decisions → issue comment
+- Requirement changes → issue comment
+- Commit summaries → issue comment
+- Review findings → PR + issue comment
+- Created issues → linked to source ticket
+
+Transparency rules:
+- NEVER defer without express user approval
+- NEVER mark out-of-scope without express user approval
+- Present ALL findings, let user decide handling
+- User chooses: fix now, create issue, or ignore
+
+Batching: Combine related GitHub comments/issues to avoid spam. Group review issues by category.
+
+Track current ticket in context. Support multiple tickets per session.
+</ticket_workflow>
+
+<testing_standards>
+Tests verify behavior, not implementation. Follow these rules strictly.
+
+Test scope:
+- Test public interfaces and behavior, not internal implementation
+- One test per logical behavior, not per line of code
+- Focus on: happy path, error handling, boundary conditions
+- Skip: trivial getters/setters, simple pass-through functions, framework code
+
+AI testing pitfalls to AVOID:
+- Endless edge cases: 3-5 edge cases max per function, prioritize by risk
+- Testing implementation: Don't test private methods, internal state, or call order
+- Over-mocking: If you mock everything, you test nothing
+- Brittle tests: Don't assert on exact error messages, log output, or timestamps
+- Coverage theater: 100% coverage ≠ good tests; untested behavior with 60% > tested nothing with 100%
+
+Test file guidelines:
+- Mirror source structure: src/foo.ts → tests/foo.test.ts
+- One test file per source file (unless genuinely complex)
+- Descriptive test names: "should reject expired tokens" not "test1"
+
+When tests are NOT required:
+- User explicitly says "no tests" or "skip tests"
+- Pure configuration changes (env vars, build config)
+- Documentation-only changes
+- Prototype/spike work marked as such
+
+When suggesting tests:
+- Propose specific test scenarios, not vague "add tests for X"
+- Estimate count: "2-3 unit tests for validation, 1 integration test for API"
+- Ask user preference if scope is unclear
+</testing_standards>

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

@@ -1,12 +1,12 @@
 #!/bin/bash
-# Setup cc function for claude with local system prompt support
+# Setup claude/cc functions for claude with local system prompt support
 
 CLAUDE_DIR="${CLAUDE_CONFIG_DIR:?CLAUDE_CONFIG_DIR not set}"
 
 echo "[setup-aliases] Configuring Claude aliases..."
 
-# cc function: ensures local system prompt and settings exist, then runs claude
-CC_FUNCTION='cc() {
+# Shared function for claude with local config (used by both cc and claude)
+CLAUDE_FUNCTION='_claude_with_config() {
     local LOCAL_PROMPT=".claude/system-prompt.md"
     local DEFAULT_PROMPT="/workspaces/.devcontainer/config/main-system-prompt.md"
     local LOCAL_SETTINGS=".claude/settings.json"
@@ -16,37 +16,65 @@ CC_FUNCTION='cc() {
 
     if [ ! -f "$LOCAL_PROMPT" ]; then
         cp "$DEFAULT_PROMPT" "$LOCAL_PROMPT"
-        echo "[cc] Created $LOCAL_PROMPT from default"
+        echo "[claude] Created $LOCAL_PROMPT from default"
     fi
 
     if [ ! -f "$LOCAL_SETTINGS" ]; then
         cp "$DEFAULT_SETTINGS" "$LOCAL_SETTINGS"
-        echo "[cc] Created $LOCAL_SETTINGS from default"
+        echo "[claude] Created $LOCAL_SETTINGS from default"
     fi
 
-    claude --system-prompt-file "$LOCAL_PROMPT" --dangerously-skip-permissions "$@"
-}'
+    command claude --system-prompt-file "$LOCAL_PROMPT" --dangerously-skip-permissions "$@"
+}
+
+# cc: shorthand for claude with config
+cc() { _claude_with_config "$@"; }
+
+# claude: override to use config (use ccraw for vanilla)
+claude() { _claude_with_config "$@"; }
+
+# ccraw: vanilla claude without any config
+alias ccraw="command claude"'
 
 for rc in ~/.bashrc ~/.zshrc; do
     if [ -f "$rc" ]; then
-        # Remove old cc alias if present
+        # Remove old cc alias/function if present
         if grep -q "alias cc=" "$rc" 2>/dev/null; then
             sed -i '/alias cc=/d' "$rc"
             echo "[setup-aliases] Removed old cc alias from $(basename $rc)"
         fi
+        if grep -q "^cc()" "$rc" 2>/dev/null; then
+            # Remove old cc function (multi-line)
+            sed -i '/^cc() {/,/^}/d' "$rc"
+            echo "[setup-aliases] Removed old cc function from $(basename $rc)"
+        fi
         # Remove old specwright alias if present
         if grep -q "alias specwright=" "$rc" 2>/dev/null; then
             sed -i '/alias specwright=/d' "$rc"
             echo "[setup-aliases] Removed specwright alias from $(basename $rc)"
         fi
-        # Add cc function if not present
-        if ! grep -q "^cc()" "$rc" 2>/dev/null; then
+        # Remove old _claude_with_config function if present
+        if grep -q "^_claude_with_config()" "$rc" 2>/dev/null; then
+            sed -i '/^_claude_with_config() {/,/^}/d' "$rc"
+        fi
+        # Remove old claude function override if present
+        if grep -q "^claude() {" "$rc" 2>/dev/null; then
+            sed -i '/^claude() { _claude_with_config/d' "$rc"
+        fi
+        # Remove old ccraw alias if present
+        if grep -q "alias ccraw=" "$rc" 2>/dev/null; then
+            sed -i '/alias ccraw=/d' "$rc"
+        fi
+        # Add functions if not present
+        if ! grep -q "^_claude_with_config()" "$rc" 2>/dev/null; then
             echo "" >> "$rc"
-            echo "$CC_FUNCTION" >> "$rc"
-            echo "[setup-aliases] Added cc function to $(basename $rc)"
+            echo "$CLAUDE_FUNCTION" >> "$rc"
+            echo "[setup-aliases] Added claude functions to $(basename $rc)"
         fi
     fi
 done
 
 echo "[setup-aliases] Aliases configured:"
-echo "  cc -> claude with local .claude/system-prompt.md and .claude/settings.json (auto-created from defaults)"
+echo "  claude -> claude with local .claude/system-prompt.md (auto-created from defaults)"
+echo "  cc     -> shorthand for claude with config"
+echo "  ccraw  -> vanilla claude without any config"

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

@@ -1,17 +1,14 @@
 #!/bin/bash
-# Install official Anthropic plugins
+# Install plugins: official Anthropic + local devs-marketplace
 
-echo "[setup-plugins] Installing official Anthropic plugins..."
+echo "[setup-plugins] Installing plugins..."
 
-# Note: typescript-lsp and pyright-lsp are installed by setup-lsp.sh
-PLUGINS=(
+# --- Official Anthropic Plugins ---
+OFFICIAL_PLUGINS=(
     "frontend-design@claude-plugins-official"
-    "code-review@claude-plugins-official"
-    "commit-commands@claude-plugins-official"
-    "pr-review-toolkit@claude-plugins-official"
 )
 
-for plugin in "${PLUGINS[@]}"; do
+for plugin in "${OFFICIAL_PLUGINS[@]}"; do
     echo "[setup-plugins] Installing $plugin..."
     if claude plugin install "$plugin" 2>/dev/null; then
         echo "[setup-plugins] Installed: $plugin"
@@ -20,12 +17,37 @@ for plugin in "${PLUGINS[@]}"; do
     fi
 done
 
-# code-simplifier requires npx method (not available via native CLI)
-echo "[setup-plugins] Installing code-simplifier (via npx)..."
-if npx -y claude-plugins install "@anthropics/claude-plugins-official/code-simplifier" 2>/dev/null; then
-    echo "[setup-plugins] Installed: code-simplifier"
+# --- Local Marketplace Plugins ---
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MARKETPLACE_PATH="${SCRIPT_DIR}/../plugins/devs-marketplace"
+
+# Add local marketplace (if not already added)
+if ! claude plugin marketplace list 2>/dev/null | grep -q "devs-marketplace"; then
+    echo "[setup-plugins] Adding devs-marketplace..."
+    claude plugin marketplace add "$MARKETPLACE_PATH" 2>/dev/null || {
+        echo "[setup-plugins] WARNING: Failed to add marketplace"
+    }
+fi
+
+# Install ALL plugins from marketplace.json (dynamic discovery)
+MARKETPLACE_JSON="$MARKETPLACE_PATH/.claude-plugin/marketplace.json"
+if [ -f "$MARKETPLACE_JSON" ]; then
+    PLUGINS=$(jq -r '.plugins[].name' "$MARKETPLACE_JSON" 2>/dev/null)
+
+    if [ -z "$PLUGINS" ]; then
+        echo "[setup-plugins] WARNING: No plugins found in marketplace.json"
+    else
+        for plugin in $PLUGINS; do
+            echo "[setup-plugins] Installing $plugin from devs-marketplace..."
+            if claude plugin install "${plugin}@devs-marketplace" 2>/dev/null; then
+                echo "[setup-plugins] Installed: $plugin"
+            else
+                echo "[setup-plugins] WARNING: Failed to install $plugin (may already be installed)"
+            fi
+        done
+    fi
 else
-    echo "[setup-plugins] Warning: Failed to install code-simplifier (may already exist)"
+    echo "[setup-plugins] WARNING: marketplace.json not found at $MARKETPLACE_JSON"
 fi
 
 echo "[setup-plugins] Plugin installation complete"

package/.devcontainer/scripts/setup.sh

@@ -20,10 +20,9 @@ fi
 : "${SETUP_CONFIG:=true}"
 : "${SETUP_ALIASES:=true}"
 : "${OVERWRITE_CONFIG:=false}"
-: "${SETUP_LSP:=true}"
 : "${SETUP_PLUGINS:=true}"
 
-export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_LSP SETUP_PLUGINS
+export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_PLUGINS
 
 
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -51,7 +50,6 @@ run_script() {
 
 run_script "$SCRIPT_DIR/setup-config.sh" "$SETUP_CONFIG"
 run_script "$SCRIPT_DIR/setup-aliases.sh" "$SETUP_ALIASES"
-run_script "$SCRIPT_DIR/setup-lsp.sh" "$SETUP_LSP"
 run_script "$SCRIPT_DIR/setup-plugins.sh" "$SETUP_PLUGINS"
 run_script "$SCRIPT_DIR/setup-irie-claude.sh" "true"
 

package/README.md

@@ -15,6 +15,24 @@ npx claudepod
 
 This copies the `.devcontainer/` directory to your project. Then open in VS Code and select "Reopen in Container".
 
+### Options
+
+```bash
+npx claudepod --force    # Overwrite existing .devcontainer directory
+npx claudepod -f         # Short form
+```
+
+### Alternative Install Methods
+
+```bash
+# Install globally
+npm install -g claudepod
+claudepod
+
+# Run specific version
+npx claudepod@1.2.3
+```
+
 ## Prerequisites
 
 - **Docker Desktop** (or compatible container runtime like Podman)
@@ -134,6 +152,7 @@ GitHub CLI credentials are automatically persisted across container rebuilds. Th
 | `git` | Version control |
 | `jq` | JSON processor |
 | `curl` | HTTP client |
+| `agent-browser` | Headless browser automation for AI agents |
 
 ### Code Intelligence
 | Tool | Description |
@@ -215,6 +234,7 @@ ClaudePod includes several custom devcontainer features:
 | `ast-grep` | Structural code search using AST patterns |
 | `tree-sitter` | Parser with JS/TS/Python grammars |
 | `lsp-servers` | Pyright and TypeScript language servers |
+| `agent-browser` | Browser automation with accessibility snapshots and screenshots |
 
 ## Essential Gotchas
 
@@ -223,6 +243,23 @@ ClaudePod includes several custom devcontainer features:
 - **Project-local config**: The `cc` command creates `.claude/` in your current directory for project-specific settings
 - **GitHub auth persists**: Run `gh auth login` once; credentials survive container rebuilds (stored in `/workspaces/.gh/`)
 
+## Development
+
+### Testing Locally
+
+```bash
+git clone https://github.com/AnExiledDev/ClaudePod.git
+cd ClaudePod
+npm test
+```
+
+### Publishing
+
+```bash
+# Bump version in package.json, then:
+npm publish
+```
+
 ## Further Reading
 
 - [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudepod",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "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": {
@@ -17,7 +17,6 @@
     "mcp-server",
     "ai",
     "development-environment",
-    "devpod",
     "vscode",
     "container",
     "qdrant",

package/setup.js

@@ -23,6 +23,9 @@ function copyDirectory(src, dest) {
 }
 
 function main() {
+  const args = process.argv.slice(2);
+  const force = args.includes('--force') || args.includes('-f');
+
   const currentDir = process.cwd();
   const packageDir = __dirname;
   const devcontainerSrc = path.join(packageDir, '.devcontainer');
@@ -32,9 +35,14 @@ function main() {
 
   // Check if .devcontainer already exists
   if (fs.existsSync(devcontainerDest)) {
-    console.log('⚠️  .devcontainer directory already exists.');
-    console.log('   Remove it first or run in a different directory.');
-    process.exit(1);
+    if (force) {
+      console.log('⚠️  Removing existing .devcontainer directory...');
+      fs.rmSync(devcontainerDest, { recursive: true, force: true });
+    } else {
+      console.log('⚠️  .devcontainer directory already exists.');
+      console.log('   Use --force to overwrite, or remove it manually.');
+      process.exit(1);
+    }
   }
 
   // Check if source .devcontainer exists
@@ -50,9 +58,9 @@ function main() {
     console.log('✅ ClaudePod DevContainer configuration installed!');
     console.log('');
     console.log('🔧 Next steps:');
-    console.log('   1. devpod up .');
-    console.log('   2. devpod ssh <workspace-name> --ide vscode');
-    console.log('   3. Start coding with Claude: claude');
+    console.log('   1. Open this folder in VS Code');
+    console.log('   2. Select "Reopen in Container" from the command palette');
+    console.log('   3. Run: claude');
     console.log('');
     console.log('📚 Features included:');
     console.log('   • Claude Code CLI with optimized tool configuration');

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

@@ -1,20 +0,0 @@
-#!/bin/bash
-# Install LSP plugins for Claude Code
-
-echo "[setup-lsp] Installing Claude Code LSP plugins..."
-
-# Install Python LSP plugin
-if claude plugin install pyright-lsp@claude-plugins-official 2>/dev/null; then
-    echo "[setup-lsp] Installed: pyright-lsp"
-else
-    echo "[setup-lsp] WARNING: Failed to install pyright-lsp (may already be installed)"
-fi
-
-# Install TypeScript LSP plugin
-if claude plugin install typescript-lsp@claude-plugins-official 2>/dev/null; then
-    echo "[setup-lsp] Installed: typescript-lsp"
-else
-    echo "[setup-lsp] WARNING: Failed to install typescript-lsp (may already be installed)"
-fi
-
-echo "[setup-lsp] LSP plugin installation complete"