the-grid-cc 1.7.3 → 1.7.4

package/assets/terminal-v3.svg

@@ -0,0 +1,112 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 520">
+  <defs>
+    <!-- Terminal background gradient -->
+    <linearGradient id="termBg" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" style="stop-color:#2d2d2d"/>
+      <stop offset="100%" style="stop-color:#1a1a1a"/>
+    </linearGradient>
+
+    <!-- TRON Cyan Glow Filter -->
+    <filter id="tron-glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="3" result="blur1"/>
+      <feGaussianBlur in="SourceGraphic" stdDeviation="6" result="blur2"/>
+      <feGaussianBlur in="SourceGraphic" stdDeviation="12" result="blur3"/>
+      <feMerge>
+        <feMergeNode in="blur3"/>
+        <feMergeNode in="blur2"/>
+        <feMergeNode in="blur1"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+
+    <!-- Subtle glow for smaller text -->
+    <filter id="subtle-glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="1" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Terminal window -->
+  <rect width="800" height="520" rx="10" fill="url(#termBg)"/>
+
+  <!-- Title bar -->
+  <rect width="800" height="32" rx="10" fill="#3d3d3d"/>
+  <rect y="22" width="800" height="10" fill="#3d3d3d"/>
+
+  <!-- Traffic lights -->
+  <circle cx="20" cy="16" r="6" fill="#ff5f57"/>
+  <circle cx="40" cy="16" r="6" fill="#febc2e"/>
+  <circle cx="60" cy="16" r="6" fill="#28c840"/>
+
+  <!-- Title -->
+  <text x="400" y="20" fill="#888" font-family="SF Mono, Monaco, Consolas, monospace" font-size="13" text-anchor="middle">Terminal</text>
+
+  <!-- Prompt line 1 -->
+  <text x="20" y="65" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
+    <tspan fill="#6cf">~</tspan>
+    <tspan fill="#888"> $ </tspan>
+    <tspan fill="#fff">npx the-grid-cc</tspan>
+  </text>
+
+  <!-- THE GRID Logo - Using text with glow effect -->
+  <text x="60" y="130"
+        font-family="Impact, Arial Black, Helvetica, sans-serif"
+        font-size="72"
+        font-weight="bold"
+        fill="#0ff"
+        filter="url(#tron-glow)"
+        letter-spacing="4">THE GRID</text>
+
+  <!-- Version and description -->
+  <text font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
+    <tspan x="60" y="170" fill="#fff">The Grid</tspan>
+    <tspan fill="#888"> v1.7.3</tspan>
+    <tspan x="60" y="190" fill="#888">Multi-agent orchestration for Claude Code</tspan>
+  </text>
+
+  <!-- Installation checkmarks -->
+  <text font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
+    <tspan x="60" y="230" fill="#28c840">✓</tspan>
+    <tspan fill="#ccc"> Installed commands/grid</tspan>
+    <tspan x="60" y="250" fill="#28c840">✓</tspan>
+    <tspan fill="#ccc"> Installed agents</tspan>
+  </text>
+
+  <!-- Done message -->
+  <text x="60" y="290" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
+    <tspan fill="#28c840">Done!</tspan>
+    <tspan fill="#ccc"> Run </tspan>
+    <tspan fill="#fff">/grid</tspan>
+    <tspan fill="#ccc"> to get started.</tspan>
+  </text>
+
+  <!-- Second prompt - /grid session -->
+  <text x="20" y="340" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
+    <tspan fill="#6cf">~</tspan>
+    <tspan fill="#888"> $ </tspan>
+    <tspan fill="#fff">/grid</tspan>
+  </text>
+
+  <!-- Master Control output with glow -->
+  <text x="60" y="390"
+        font-family="Impact, Arial Black, Helvetica, sans-serif"
+        font-size="28"
+        fill="#0ff"
+        filter="url(#subtle-glow)"
+        letter-spacing="2">THE GRID</text>
+
+  <text x="60" y="408" fill="#0ff" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14" filter="url(#subtle-glow)">════════════</text>
+
+  <text font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
+    <tspan x="60" y="440" fill="#fff">Master Control online.</tspan>
+    <tspan x="60" y="475" fill="#ccc">What would you like to build?</tspan>
+  </text>
+
+  <!-- Blinking cursor -->
+  <rect x="60" y="490" width="8" height="14" fill="#fff" opacity="0.8">
+    <animate attributeName="opacity" values="0.8;0;0.8" dur="1s" repeatCount="indefinite"/>
+  </rect>
+</svg>

package/commands/grid/VERSION

@@ -1 +1 @@
-1.7.3
+1.7.4

package/commands/grid/mc.md

@@ -169,6 +169,78 @@ def spawn_count(plan):
 
 ---
 
+## QUICK MODE DETECTION
+
+**For trivial builds, skip planning ceremony.**
+
+Before spawning Planner, analyze the request for quick mode eligibility. If ALL conditions pass, auto-invoke `/grid:quick` instead.
+
+### Detection Heuristics
+
+| Heuristic | Threshold | Rationale |
+|-----------|-----------|-----------|
+| **File count** | ≤ 5 files | Below spawn overhead threshold |
+| **Block structure** | Single block only | No dependency coordination needed |
+| **Checkpoints** | None required | Can run to completion |
+| **Ambiguity** | Requirements clear | No discovery phase needed |
+| **No architecture** | No schema/DB changes | Avoid risky auto-decisions |
+
+```python
+def should_use_quick_mode(request: str, codebase_context: dict) -> tuple[bool, str]:
+    """Returns: (use_quick_mode, reason)"""
+
+    # RULE 1: File count threshold
+    estimated_files = infer_file_count(request, codebase_context)
+    if estimated_files > 5:
+        return False, f"Estimated {estimated_files} files (threshold: 5)"
+
+    # RULE 2: Single block structure
+    if any(kw in request.lower() for kw in ["then", "after", "once", "multi-step"]):
+        return False, "Multi-phase work detected"
+
+    # RULE 3: No checkpoints
+    checkpoint_keywords = ["deploy", "test manually", "verify in browser", "2FA", "email"]
+    if any(kw in request.lower() for kw in checkpoint_keywords):
+        return False, "Checkpoint likely required"
+
+    # RULE 4: Clear requirements (ambiguity < 0.6)
+    if measure_ambiguity(request) > 0.6:
+        return False, "Requirements too ambiguous"
+
+    # RULE 5: No architectural changes
+    architecture_keywords = ["database", "schema", "migration", "new table", "auth system"]
+    if any(kw in request.lower() for kw in architecture_keywords):
+        return False, "Architectural changes detected"
+
+    return True, f"Quick mode eligible: {estimated_files} files, clear scope"
+```
+
+### User Override
+
+After detection, show decision:
+```
+QUICK MODE DETECTED
+═══════════════════
+
+Analysis: 2 files, single block, clear scope
+Proceeding with /grid:quick for faster execution.
+
+(Say "use full grid" if you want formal planning instead)
+```
+
+If User says "use full grid", respect the override immediately.
+
+### Complexity Escalation
+
+If quick mode executor discovers higher complexity during execution:
+- More than 5 files actually need changes
+- Architectural decisions required
+- Checkpoints unavoidable
+
+**STOP and escalate** back to MC with partial work. MC spawns Planner for remaining complexity.
+
+---
+
 ## PROGRAM SPAWNING PROTOCOL
 
 ### Available Programs
@@ -222,6 +294,74 @@ Task(
 )
 ```
 
+### Plan-Execute Direct Pipeline
+
+**Planner returns structured plan data.** MC receives plans directly in memory, no re-reading from disk.
+
+**Planner completion format:**
+```yaml
+## PLANNING COMPLETE
+
+cluster: {name}
+total_blocks: {N}
+total_waves: {M}
+
+plans:
+  - id: "01"
+    path: ".grid/phases/01-foundation/01-PLAN.md"
+    wave: 1
+    depends_on: []
+    autonomous: true
+    files_modified: [list]
+    objective: "{brief objective}"
+
+    frontmatter: {full YAML frontmatter}
+    content: |
+      <objective>...</objective>
+      <context>...</context>
+      <threads>...</threads>
+
+wave_structure:
+  1: ["01", "02"]
+  2: ["03"]
+```
+
+**MC workflow:**
+```python
+# Step 1: Spawn Planner
+planner_result = Task(prompt="...", ...)
+
+# Step 2: Parse plan data (already in memory!)
+plan_data = parse_yaml(planner_result)
+
+# Step 3: Execute by wave (no file reads needed!)
+for wave_num in sorted(plan_data['wave_structure'].keys()):
+    for plan_id in plan_data['wave_structure'][wave_num]:
+        plan = get_plan_by_id(plan_data['plans'], plan_id)
+
+        Task(
+          prompt=f"""
+First, read ~/.claude/agents/grid-executor.md for your role.
+
+<plan>
+---
+{plan['frontmatter']}
+---
+{plan['content']}
+</plan>
+
+Execute the plan.
+""",
+          ...
+        )
+```
+
+**Benefits:**
+- Zero file reads between planning and execution
+- MC has all plan metadata immediately
+- Wave execution begins instantly after planning
+- Files still written by Planner (for persistence/audit)
+
 ### Parallel Spawning (BatchTool Pattern)
 
 **To spawn Programs in parallel, issue multiple Task() calls in a SINGLE message.**
@@ -235,18 +375,37 @@ Task(prompt="...", subagent_type="general-purpose", description="Execute plan 03
 
 The Task tool blocks until ALL complete. No polling needed.
 
-### Wave-Based Execution
+### Wave-Based Execution with Auto-Verification
 
-Plans are assigned **wave numbers** during planning (not execution). Execute waves sequentially, plans within each wave in parallel:
+Plans are assigned **wave numbers** during planning. Execute waves sequentially, with **automatic verification** after each wave:
 
 ```
-WAVE 1: [plan-01, plan-02]  → Spawn both in parallel
-   ↓ (wait for completion)
-WAVE 2: [plan-03]           → Spawn after Wave 1
-   ↓ (wait for completion)
-WAVE 3: [plan-04, plan-05]  → Spawn both in parallel
+WAVE 1: [plan-01, plan-02]
+   ├─ Spawn Executors (parallel)
+   ├─ Wait for completion
+   ├─ Auto-spawn Recognizer (wave-level verification)
+   └─ If GAPS_FOUND → Spawn Planner --gaps
+   ↓
+WAVE 2: [plan-03]
+   ├─ Spawn Executor
+   ├─ Wait for completion
+   ├─ Auto-spawn Recognizer
+   └─ If CLEAR → Proceed
+   ↓
+WAVE 3: [plan-04, plan-05]
+   ├─ Spawn Executors (parallel)
+   ├─ Wait for completion
+   └─ Auto-spawn Recognizer
 ```
 
+**Verification Timing:** Wave-level, not plan-level. This prevents redundant checks on interdependent plans.
+
+**Verification Skipped When:**
+- Executor returned CHECKPOINT (incomplete work)
+- Executor returned FAILURE (broken state)
+- Plan frontmatter has `verify: false`
+- User said "skip verification"
+
 Read wave numbers from plan frontmatter:
 ```yaml
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-grid-cc",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "Agent orchestration for Claude Code. You talk to Master Control. Master Control handles the rest.",
   "main": "index.js",
   "bin": {

package/assets/terminal.svg

@@ -1,120 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 520">
-  <defs>
-    <linearGradient id="termBg" x1="0%" y1="0%" x2="0%" y2="100%">
-      <stop offset="0%" style="stop-color:#2d2d2d"/>
-      <stop offset="100%" style="stop-color:#1a1a1a"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Terminal window -->
-  <rect width="800" height="520" rx="10" fill="url(#termBg)"/>
-
-  <!-- Title bar -->
-  <rect width="800" height="32" rx="10" fill="#3d3d3d"/>
-  <rect y="22" width="800" height="10" fill="#3d3d3d"/>
-
-  <!-- Traffic lights -->
-  <circle cx="20" cy="16" r="6" fill="#ff5f57"/>
-  <circle cx="40" cy="16" r="6" fill="#febc2e"/>
-  <circle cx="60" cy="16" r="6" fill="#28c840"/>
-
-  <!-- Title -->
-  <text x="400" y="20" fill="#888" font-family="SF Mono, Monaco, monospace" font-size="13" text-anchor="middle">Terminal</text>
-
-  <!-- Prompt line -->
-  <text x="20" y="60" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
-    <tspan fill="#6cf">~</tspan>
-    <tspan fill="#888"> $ </tspan>
-    <tspan fill="#fff">npx the-grid-cc</tspan>
-  </text>
-
-  <!-- TRON-style GRID logo using rectangles -->
-  <g fill="#0ff" transform="translate(60, 85)">
-    <!-- T -->
-    <rect x="0" y="0" width="40" height="8"/>
-    <rect x="16" y="8" width="8" height="32"/>
-
-    <!-- H -->
-    <rect x="50" y="0" width="8" height="40"/>
-    <rect x="50" y="16" width="24" height="8"/>
-    <rect x="66" y="0" width="8" height="40"/>
-
-    <!-- E -->
-    <rect x="84" y="0" width="24" height="8"/>
-    <rect x="84" y="0" width="8" height="40"/>
-    <rect x="84" y="16" width="20" height="8"/>
-    <rect x="84" y="32" width="24" height="8"/>
-
-    <!-- Space -->
-
-    <!-- G -->
-    <rect x="130" y="0" width="28" height="8"/>
-    <rect x="130" y="0" width="8" height="40"/>
-    <rect x="130" y="32" width="28" height="8"/>
-    <rect x="150" y="20" width="8" height="20"/>
-    <rect x="142" y="20" width="16" height="8"/>
-
-    <!-- R - FIXED: proper R shape with diagonal leg -->
-    <rect x="168" y="0" width="8" height="40"/>
-    <rect x="168" y="0" width="28" height="8"/>
-    <rect x="188" y="0" width="8" height="20"/>
-    <rect x="168" y="16" width="28" height="8"/>
-    <!-- diagonal leg of R - approximated with angled rectangles -->
-    <rect x="180" y="24" width="8" height="8"/>
-    <rect x="188" y="32" width="8" height="8"/>
-
-    <!-- I -->
-    <rect x="210" y="0" width="24" height="8"/>
-    <rect x="218" y="8" width="8" height="24"/>
-    <rect x="210" y="32" width="24" height="8"/>
-
-    <!-- D -->
-    <rect x="244" y="0" width="8" height="40"/>
-    <rect x="244" y="0" width="20" height="8"/>
-    <rect x="264" y="4" width="8" height="32"/>
-    <rect x="244" y="32" width="20" height="8"/>
-  </g>
-
-  <!-- Version and description -->
-  <text font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
-    <tspan x="60" y="165" fill="#fff">The Grid</tspan>
-    <tspan fill="#888"> v1.7.2</tspan>
-    <tspan x="60" y="185" fill="#888">Multi-agent orchestration for Claude Code</tspan>
-  </text>
-
-  <!-- Installation checkmarks -->
-  <text font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
-    <tspan x="60" y="225" fill="#28c840">✓</tspan>
-    <tspan fill="#ccc"> Installed commands/grid</tspan>
-    <tspan x="60" y="245" fill="#28c840">✓</tspan>
-    <tspan fill="#ccc"> Installed agents</tspan>
-  </text>
-
-  <!-- Done message -->
-  <text x="60" y="285" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
-    <tspan fill="#28c840">Done!</tspan>
-    <tspan fill="#ccc"> Run </tspan>
-    <tspan fill="#fff">/grid</tspan>
-    <tspan fill="#ccc"> to get started.</tspan>
-  </text>
-
-  <!-- Second prompt - /grid session -->
-  <text x="20" y="330" font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
-    <tspan fill="#6cf">~</tspan>
-    <tspan fill="#888"> $ </tspan>
-    <tspan fill="#fff">/grid</tspan>
-  </text>
-
-  <!-- Master Control output -->
-  <text font-family="SF Mono, Monaco, Consolas, monospace" font-size="14">
-    <tspan x="60" y="375" fill="#0ff" font-weight="bold">THE GRID</tspan>
-    <tspan x="60" y="393" fill="#0ff">════════</tspan>
-    <tspan x="60" y="430" fill="#fff">Master Control online.</tspan>
-    <tspan x="60" y="465" fill="#ccc">What would you like to build?</tspan>
-  </text>
-
-  <!-- Blinking cursor -->
-  <rect x="60" y="480" width="8" height="14" fill="#fff" opacity="0.8">
-    <animate attributeName="opacity" values="0.8;0;0.8" dur="1s" repeatCount="indefinite"/>
-  </rect>
-</svg>