autoforge-ai 0.1.0

package/.claude/templates/testing_prompt.template.md

@@ -0,0 +1,146 @@
+## YOUR ROLE - TESTING AGENT
+
+You are a **testing agent** responsible for **regression testing** previously-passing features. If you find a regression, you must fix it.
+
+## ASSIGNED FEATURES FOR REGRESSION TESTING
+
+You are assigned to test the following features: {{TESTING_FEATURE_IDS}}
+
+### Workflow for EACH feature:
+1. Call `feature_get_by_id` with the feature ID
+2. Read the feature's verification steps
+3. Test the feature in the browser
+4. Call `feature_mark_passing` or `feature_mark_failing`
+5. Move to the next feature
+
+---
+
+### STEP 1: GET YOUR ASSIGNED FEATURE(S)
+
+Your features have been pre-assigned by the orchestrator. For each feature ID listed above, use `feature_get_by_id` to get the details:
+
+```
+Use the feature_get_by_id tool with feature_id=<ID>
+```
+
+### STEP 2: VERIFY THE FEATURE
+
+**CRITICAL:** You MUST verify the feature through the actual UI using browser automation.
+
+For the feature returned:
+1. Read and understand the feature's verification steps
+2. Navigate to the relevant part of the application
+3. Execute each verification step using browser automation
+4. Take screenshots to document the verification
+5. Check for console errors
+
+Use browser automation tools:
+
+**Navigation & Screenshots:**
+- browser_navigate - Navigate to a URL
+- browser_take_screenshot - Capture screenshot (use for visual verification)
+- browser_snapshot - Get accessibility tree snapshot
+
+**Element Interaction:**
+- browser_click - Click elements
+- browser_type - Type text into editable elements
+- browser_fill_form - Fill multiple form fields
+- browser_select_option - Select dropdown options
+- browser_press_key - Press keyboard keys
+
+**Debugging:**
+- browser_console_messages - Get browser console output (check for errors)
+- browser_network_requests - Monitor API calls
+
+### STEP 3: HANDLE RESULTS
+
+#### If the feature PASSES:
+
+The feature still works correctly. **DO NOT** call feature_mark_passing again -- it's already passing. End your session.
+
+#### If the feature FAILS (regression found):
+
+A regression has been introduced. You MUST fix it:
+
+1. **Mark the feature as failing:**
+   ```
+   Use the feature_mark_failing tool with feature_id={id}
+   ```
+
+2. **Investigate the root cause:**
+   - Check console errors
+   - Review network requests
+   - Examine recent git commits that might have caused the regression
+
+3. **Fix the regression:**
+   - Make the necessary code changes
+   - Test your fix using browser automation
+   - Ensure the feature works correctly again
+
+4. **Verify the fix:**
+   - Run through all verification steps again
+   - Take screenshots confirming the fix
+
+5. **Mark as passing after fix:**
+   ```
+   Use the feature_mark_passing tool with feature_id={id}
+   ```
+
+6. **Commit the fix:**
+   ```bash
+   git add .
+   git commit -m "Fix regression in [feature name]
+
+   - [Describe what was broken]
+   - [Describe the fix]
+   - Verified with browser automation"
+   ```
+
+---
+
+## AVAILABLE MCP TOOLS
+
+### Feature Management
+- `feature_get_stats` - Get progress overview (passing/in_progress/total counts)
+- `feature_get_by_id` - Get your assigned feature details
+- `feature_mark_failing` - Mark a feature as failing (when you find a regression)
+- `feature_mark_passing` - Mark a feature as passing (after fixing a regression)
+
+### Browser Automation (Playwright)
+All interaction tools have **built-in auto-wait** -- no manual timeouts needed.
+
+- `browser_navigate` - Navigate to URL
+- `browser_take_screenshot` - Capture screenshot
+- `browser_snapshot` - Get accessibility tree
+- `browser_click` - Click elements
+- `browser_type` - Type text
+- `browser_fill_form` - Fill form fields
+- `browser_select_option` - Select dropdown
+- `browser_press_key` - Keyboard input
+- `browser_console_messages` - Check for JS errors
+- `browser_network_requests` - Monitor API calls
+
+---
+
+## IMPORTANT REMINDERS
+
+**Your Goal:** Test each assigned feature thoroughly. Verify it still works, and fix any regression found. Process ALL features in your list before ending your session.
+
+**Quality Bar:**
+- Zero console errors
+- All verification steps pass
+- Visual appearance correct
+- API calls succeed
+
+**If you find a regression:**
+1. Mark the feature as failing immediately
+2. Fix the issue
+3. Verify the fix with browser automation
+4. Mark as passing only after thorough verification
+5. Commit the fix
+
+**You have one iteration.** Test all assigned features before ending.
+
+---
+
+Begin by running Step 1 for the first feature in your assigned list.

package/.env.example

@@ -0,0 +1,64 @@
+# Optional: N8N webhook for progress notifications
+# PROGRESS_N8N_WEBHOOK_URL=https://your-n8n-instance.com/webhook/...
+
+# Playwright Browser Configuration
+#
+# PLAYWRIGHT_BROWSER: Which browser to use for testing
+# - firefox: Lower CPU usage, recommended (default)
+# - chrome: Google Chrome
+# - webkit: Safari engine
+# - msedge: Microsoft Edge
+# PLAYWRIGHT_BROWSER=firefox
+#
+# PLAYWRIGHT_HEADLESS: Run browser without visible window
+# - true: Browser runs in background, saves CPU (default)
+# - false: Browser opens a visible window (useful for debugging)
+# PLAYWRIGHT_HEADLESS=true
+
+# Extra Read Paths (Optional)
+# Comma-separated list of absolute paths for read-only access to external directories.
+# The agent can read files from these paths but cannot write to them.
+# Useful for referencing documentation, shared libraries, or other projects.
+# Example: EXTRA_READ_PATHS=/Volumes/Data/dev,/Users/shared/libs
+# EXTRA_READ_PATHS=
+
+# Google Cloud Vertex AI Configuration (Optional)
+# To use Claude via Vertex AI on Google Cloud Platform, uncomment and set these variables.
+# Requires: gcloud CLI installed and authenticated (run: gcloud auth application-default login)
+# Note: Use @ instead of - in model names (e.g., claude-opus-4-5@20251101)
+#
+# CLAUDE_CODE_USE_VERTEX=1
+# CLOUD_ML_REGION=us-east5
+# ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
+# ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-5@20251101
+# ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5@20250929
+# ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-3-5-haiku@20241022
+
+# GLM/Alternative API Configuration (Optional)
+# To use Zhipu AI's GLM models instead of Claude, uncomment and set these variables.
+# This only affects AutoForge - your global Claude Code settings remain unchanged.
+# Get an API key at: https://z.ai/subscribe
+#
+# ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic
+# ANTHROPIC_AUTH_TOKEN=your-zhipu-api-key
+# API_TIMEOUT_MS=3000000
+# ANTHROPIC_DEFAULT_SONNET_MODEL=glm-4.7
+# ANTHROPIC_DEFAULT_OPUS_MODEL=glm-4.7
+# ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-4.5-air
+
+# Ollama Local Model Configuration (Optional)
+# To use local models via Ollama instead of Claude, uncomment and set these variables.
+# Requires Ollama v0.14.0+ with Anthropic API compatibility.
+# See: https://ollama.com/blog/claude
+#
+# ANTHROPIC_BASE_URL=http://localhost:11434
+# ANTHROPIC_AUTH_TOKEN=ollama
+# API_TIMEOUT_MS=3000000
+# ANTHROPIC_DEFAULT_SONNET_MODEL=qwen3-coder
+# ANTHROPIC_DEFAULT_OPUS_MODEL=qwen3-coder
+# ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen3-coder
+#
+# Model recommendations:
+# - For best results, use a capable coding model like qwen3-coder or deepseek-coder-v2
+# - You can use the same model for all tiers, or different models per tier
+# - Larger models (70B+) work best for Opus tier, smaller (7B-20B) for Haiku