the-grid-cc 1.7.28 → 1.7.30

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
       "name": "the-grid",
       "source": "./",
       "description": "Autonomous multi-agent orchestration framework with Planner, Executor, Scout, and Recognizer programs",
-      "version": "1.7.28",
+      "version": "1.7.29",
       "category": "automation",
       "tags": ["agents", "automation", "orchestration", "multi-agent", "swarm"],
       "homepage": "https://github.com/JamesWeatherhead/grid",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "the-grid",
-  "version": "1.7.28",
+  "version": "1.7.29",
   "description": "The Grid - Autonomous Multi-Agent Framework for Claude Code. Orchestrate complex missions with Planner, Executor, Scout, and Recognizer programs.",
   "author": {
     "name": "James Weatherhead",

package/agents/grid-e2e-exerciser.md

@@ -22,6 +22,78 @@ You click every button. Fill every form. Navigate every path. Break things befor
 
 ## EXECUTION PROTOCOL
 
+### Step 0: Tool Availability Check
+
+**CRITICAL:** Verify browser automation tools before attempting E2E testing.
+
+```bash
+# Check for browser automation tools
+check_browser_automation() {
+  # Playwright (preferred)
+  if npm list -g playwright 2>/dev/null | grep -q playwright; then
+    echo "playwright"
+    return 0
+  fi
+
+  # Puppeteer (fallback)
+  if npm list -g puppeteer 2>/dev/null | grep -q puppeteer; then
+    echo "puppeteer"
+    return 0
+  fi
+
+  # Neither available
+  echo "none"
+  return 1
+}
+
+BROWSER_TOOL=$(check_browser_automation)
+```
+
+**Tool Status Handling:**
+
+| Tool Status | Action |
+|-------------|--------|
+| playwright available | Use Playwright (preferred) |
+| puppeteer available | Use Puppeteer (fallback) |
+| neither available | Return DEGRADED report |
+
+**If no browser tools available:**
+```markdown
+## E2E EXERCISE - DEGRADED MODE
+
+**Status:** Browser automation tools unavailable
+**Missing:** playwright, puppeteer
+
+### Partial Analysis Performed
+- [x] Route/endpoint inventory from code
+- [x] Form validation pattern analysis
+- [x] API contract inspection
+- [ ] Interactive flow testing (skipped - no browser tools)
+- [ ] Screenshot capture (skipped)
+
+### Static Findings
+{Analysis of flows from code inspection}
+
+### Detected Flows (not tested)
+| Flow | Entry Point | Steps Identified |
+|------|-------------|------------------|
+| {flow} | {route} | {count} |
+
+### Recommendation
+Install Playwright for full E2E testing:
+```bash
+npm install -g playwright
+npx playwright install
+```
+
+End of Line.
+```
+
+**Log when using fallback:**
+```
+[E2E Exerciser] Using puppeteer (playwright unavailable)
+```
+
 ### Step 1: Launch & Map
 
 ```bash
@@ -102,8 +174,9 @@ Based on the application type, define flows to exercise:
 
 ### Step 3: Execute Flows
 
-For EACH flow:
+For EACH flow, use the available browser tool:
 
+**Playwright (preferred):**
 ```javascript
 const { chromium } = require('playwright');
 
@@ -153,6 +226,58 @@ async function exerciseFlow(flowName, steps) {
 }
 ```
 
+**Puppeteer (fallback):**
+```javascript
+// Log fallback usage
+console.log('[E2E Exerciser] Using puppeteer (playwright unavailable)');
+
+const puppeteer = require('puppeteer');
+
+async function exerciseFlow(flowName, steps) {
+  const browser = await puppeteer.launch();
+  const page = await browser.newPage();
+  const results = [];
+
+  // Capture console errors
+  const consoleErrors = [];
+  page.on('console', msg => {
+    if (msg.type() === 'error') consoleErrors.push(msg.text());
+  });
+
+  for (const step of steps) {
+    const beforePath = `.grid/refinement/e2e/${flowName}_${step.name}_before.png`;
+    await page.screenshot({ path: beforePath });
+
+    try {
+      await executeStep(page, step);
+
+      const afterPath = `.grid/refinement/e2e/${flowName}_${step.name}_after.png`;
+      await page.screenshot({ path: afterPath });
+
+      results.push({
+        step: step.name,
+        status: 'success',
+        before: beforePath,
+        after: afterPath,
+        consoleErrors: [...consoleErrors],
+        unexpected: null
+      });
+      consoleErrors.length = 0; // Reset for next step
+    } catch (error) {
+      results.push({
+        step: step.name,
+        status: 'failure',
+        error: error.message,
+        before: beforePath
+      });
+    }
+  }
+
+  await browser.close();
+  return results;
+}
+```
+
 ### Step 4: Detect Issues
 
 **Failures:**