the-grid-cc 1.7.2 → 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.2
+1.7.4

package/commands/grid/help.md

@@ -19,6 +19,7 @@ COMMANDS
   /grid:refine       Run Refinement Swarm (visual, E2E, personas)
   /grid:debug        Start systematic bug investigation
   /grid:status       Show current Grid state
+  /grid:model        Configure model selection (opus/sonnet/haiku)
   /grid:help         This help
 
 MODES
@@ -26,6 +27,12 @@ MODES
   GUIDED             MC drives, asks only when essential.
   HANDS ON           Collaborative decisions.
 
+MODEL TIERS
+  /grid:model quality      Opus for all agents (default, best results)
+  /grid:model balanced     Sonnet for most (good balance)
+  /grid:model budget       Haiku where possible (lowest cost)
+  /grid:model custom       Configure per-agent
+
 REFINEMENT SWARM
   /grid:refine              Full swarm (visual + E2E + personas)
   /grid:refine visual       Screenshot + vision analysis only

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
 ---
@@ -259,20 +418,48 @@ depends_on: []
 
 ### Model Routing
 
-Route different Programs to different models based on task complexity:
+**Default: QUALITY tier (Opus for all agents)**
+
+Check `.grid/config.json` for user model preferences. Users can configure via `/grid:model`.
 
 | Program | Quality | Balanced | Budget |
 |---------|---------|----------|--------|
 | Planner | opus | sonnet | sonnet |
 | Executor | opus | sonnet | sonnet |
-| Recognizer | sonnet | sonnet | haiku |
+| Recognizer | opus | sonnet | haiku |
+| Visual Inspector | opus | sonnet | haiku |
+| E2E Exerciser | opus | sonnet | haiku |
+| Persona Simulator | opus | sonnet | sonnet |
+| Refinement Synth | opus | sonnet | sonnet |
+
+**Model Selection Logic:**
+```python
+def get_model(program_type):
+    """Get model based on .grid/config.json or default to opus."""
+    try:
+        config = json.loads(read(".grid/config.json"))
+        tier = config.get("model_tier", "quality")
+    except:
+        tier = "quality"  # Default: Opus
+
+    if tier == "quality":
+        return "opus"
+    elif tier == "balanced":
+        return "sonnet"
+    elif tier == "budget":
+        # Some programs need reasoning capability
+        if program_type in ["planner", "executor", "persona_simulator"]:
+            return "sonnet"
+        return "haiku"
+    return "opus"
+```
 
 Pass `model` parameter to Task():
 ```python
 Task(
   prompt="...",
   subagent_type="general-purpose",
-  model="sonnet",  # or "opus", "haiku"
+  model="opus",  # Default: quality tier
   description="..."
 )
 ```

package/commands/grid/model.md

@@ -0,0 +1,188 @@
+# /grid:model - Configure Model Selection
+
+---
+name: grid:model
+description: Configure which Claude model to use for Grid agents
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - AskUserQuestion
+---
+
+Configure which Claude models The Grid uses for its agents.
+
+## USAGE
+
+```
+/grid:model                    # Show current config + options
+/grid:model quality            # Use Opus for everything (best results, highest cost)
+/grid:model balanced           # Use Sonnet for most tasks (good balance)
+/grid:model budget             # Use Haiku where possible (lowest cost)
+/grid:model custom             # Configure per-agent models
+```
+
+## MODEL TIERS
+
+### QUALITY (Default)
+All agents use **Opus** - best reasoning, highest quality output.
+
+| Agent | Model |
+|-------|-------|
+| Planner | opus |
+| Executor | opus |
+| Recognizer | opus |
+| Visual Inspector | opus |
+| E2E Exerciser | opus |
+| Persona Simulator | opus |
+
+**Best for:** Complex projects, production code, when quality matters most.
+**Cost:** ~3-5x more than Balanced.
+
+### BALANCED
+Most agents use **Sonnet** - good reasoning, moderate cost.
+
+| Agent | Model |
+|-------|-------|
+| Planner | sonnet |
+| Executor | sonnet |
+| Recognizer | sonnet |
+| Visual Inspector | sonnet |
+| E2E Exerciser | sonnet |
+| Persona Simulator | sonnet |
+
+**Best for:** Most projects, good quality/cost tradeoff.
+**Cost:** Baseline.
+
+### BUDGET
+Use **Haiku** where possible, Sonnet for complex reasoning.
+
+| Agent | Model |
+|-------|-------|
+| Planner | sonnet (needs reasoning) |
+| Executor | sonnet (needs reasoning) |
+| Recognizer | haiku |
+| Visual Inspector | haiku |
+| E2E Exerciser | haiku |
+| Persona Simulator | sonnet (needs reasoning) |
+
+**Best for:** Prototypes, learning, cost-sensitive projects.
+**Cost:** ~50-70% less than Balanced.
+
+### CUSTOM
+Set each agent individually.
+
+## EXECUTION
+
+When user runs `/grid:model`:
+
+### No argument - Show current config
+```
+MODEL CONFIGURATION
+═══════════════════
+
+Current tier: {tier}
+
+| Agent             | Model   |
+|-------------------|---------|
+| Planner           | {model} |
+| Executor          | {model} |
+| Recognizer        | {model} |
+| Visual Inspector  | {model} |
+| E2E Exerciser     | {model} |
+| Persona Simulator | {model} |
+
+Commands:
+  /grid:model quality   - Opus for everything
+  /grid:model balanced  - Sonnet for most
+  /grid:model budget    - Haiku where possible
+  /grid:model custom    - Configure individually
+
+End of Line.
+```
+
+### With tier argument - Set tier
+```python
+# Read or create config
+config_path = ".grid/config.json"
+try:
+    config = json.loads(read(config_path))
+except:
+    config = {}
+
+# Set tier
+config["model_tier"] = tier  # "quality" | "balanced" | "budget"
+
+# Write config
+write(config_path, json.dumps(config, indent=2))
+```
+
+Display:
+```
+MODEL TIER SET: {TIER}
+═════════════════════
+
+All Grid agents will now use {tier} models.
+
+| Agent             | Model   |
+|-------------------|---------|
+| Planner           | {model} |
+| ...               | ...     |
+
+To change: /grid:model {other_tier}
+
+End of Line.
+```
+
+### Custom mode - Interactive selection
+Use AskUserQuestion to let user pick model for each agent type:
+
+```
+CUSTOM MODEL CONFIGURATION
+══════════════════════════
+
+Select model for each agent type:
+```
+
+Then save to `.grid/config.json`:
+```json
+{
+  "model_tier": "custom",
+  "models": {
+    "planner": "opus",
+    "executor": "sonnet",
+    "recognizer": "haiku",
+    "visual_inspector": "haiku",
+    "e2e_exerciser": "haiku",
+    "persona_simulator": "sonnet"
+  }
+}
+```
+
+## CONFIG FILE FORMAT
+
+`.grid/config.json`:
+```json
+{
+  "model_tier": "quality",
+  "models": {
+    "planner": "opus",
+    "executor": "opus",
+    "recognizer": "opus",
+    "visual_inspector": "opus",
+    "e2e_exerciser": "opus",
+    "persona_simulator": "opus"
+  },
+  "topology": "hierarchical"
+}
+```
+
+## RULES
+
+1. Default to "quality" (Opus) if no config exists
+2. Never use Haiku for Planner/Executor (needs reasoning capability)
+3. Show cost implications when changing tiers
+4. Config persists in `.grid/config.json`
+
+End of Line.

package/commands/grid/refine.md

@@ -127,7 +127,7 @@ Dev server command: {dev_command}
 Execute visual inspection. Save to .grid/refinement/
 """,
   subagent_type="general-purpose",
-  model="sonnet",
+  model="opus",  # Default: quality tier
   description="Visual Inspector"
 )
 
@@ -141,7 +141,7 @@ Dev server command: {dev_command}
 Execute E2E testing. Save to .grid/refinement/
 """,
   subagent_type="general-purpose",
-  model="sonnet",
+  model="opus",  # Default: quality tier
   description="E2E Exerciser"
 )
 
@@ -162,7 +162,7 @@ Become this persona. Use the product. Report findings.
 Save to .grid/refinement/personas/{persona.slug}.md
 """,
     subagent_type="general-purpose",
-    model="sonnet",
+    model="opus",  # Default: quality tier
     description=f"Persona: {persona.name}"
   )
 ```
@@ -196,7 +196,7 @@ Task(
 Synthesize all findings into .grid/REFINEMENT_PLAN.md
 """,
   subagent_type="general-purpose",
-  model="sonnet",
+  model="opus",  # Default: quality tier
   description="Refinement Synthesizer"
 )
 ```

package/package.json

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