the-grid-cc 1.7.27 → 1.7.28

package/.claude-plugin/README.md

@@ -0,0 +1,78 @@
+# The Grid - Claude Code Plugin
+
+This directory contains the plugin manifest for installing The Grid via Claude Code's plugin system.
+
+## Plugin Installation
+
+### Via Claude Code Commands
+
+```bash
+# Add the Grid marketplace
+/plugin marketplace add JamesWeatherhead/grid
+
+# Install The Grid
+/plugin install the-grid@grid-marketplace
+```
+
+### Via CLI
+
+```bash
+claude plugin install the-grid@grid-marketplace --scope user
+```
+
+## What Gets Installed
+
+When you install The Grid plugin, the following components are added:
+
+### Skills (Commands)
+- `/grid` - Start The Grid (main entry point)
+- `/grid:quick` - Quick task execution
+- `/grid:budget` - Budget and cost management
+- `/grid:refine` - Refinement swarm for testing
+- `/grid:branch` - Branch management
+- `/grid:update` - Update The Grid
+- `/grid:resume` - Resume interrupted missions
+- `/grid:init` - Initialize Grid state
+- `/grid:help` - Command reference
+- `/grid:daemon` - Background execution mode
+- `/grid:status` - Grid status display
+- `/grid:mc` - Master Control interface
+- `/grid:program_disc` - View program identity discs
+- `/grid:doctor` - Diagnostic tool
+- `/grid:model` - Configure model selection
+- `/grid:debug` - Systematic bug investigation
+
+### Agents (Identity Discs)
+- `Planner.md` - Strategic planning agent
+- `Executor.md` - Code implementation agent
+- `Scout.md` - Research and discovery agent
+- `Recognizer.md` - Quality verification agent
+- `Visual.md` - Visual verification agent
+- `Persona.md` - User persona simulation agent
+
+### Hooks
+- Pre and post execution hooks for Grid operations
+
+## File Structure
+
+```
+.claude-plugin/
+├── plugin.json      # Plugin manifest
+├── marketplace.json # Marketplace metadata
+└── README.md        # This file
+```
+
+## Requirements
+
+- Claude Code CLI
+- macOS, Linux, or Windows (WSL)
+
+## More Information
+
+- GitHub: https://github.com/JamesWeatherhead/grid
+- npm: https://www.npmjs.com/package/the-grid-cc
+- Documentation: See main README.md
+
+## License
+
+MIT License - see LICENSE file for details.

package/.claude-plugin/marketplace.json

@@ -0,0 +1,24 @@
+{
+  "name": "grid-marketplace",
+  "owner": {
+    "name": "James Weatherhead",
+    "email": "james@thegrid.dev"
+  },
+  "metadata": {
+    "description": "The Grid - Multi-Agent Framework for Claude Code",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "the-grid",
+      "source": "./",
+      "description": "Autonomous multi-agent orchestration framework with Planner, Executor, Scout, and Recognizer programs",
+      "version": "1.7.28",
+      "category": "automation",
+      "tags": ["agents", "automation", "orchestration", "multi-agent", "swarm"],
+      "homepage": "https://github.com/JamesWeatherhead/grid",
+      "license": "MIT",
+      "strict": false
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,24 +1,16 @@
 {
-  "name": "grid",
-  "description": "Multi-agent orchestration for Claude Code. Master Control coordinates specialized Programs for complex development tasks.",
-  "version": "1.7.22",
+  "name": "the-grid",
+  "version": "1.7.28",
+  "description": "The Grid - Autonomous Multi-Agent Framework for Claude Code. Orchestrate complex missions with Planner, Executor, Scout, and Recognizer programs.",
   "author": {
-    "name": "James Weatherhead & Claude",
-    "url": "https://github.com/JamesWeatherhead/grid"
+    "name": "James Weatherhead",
+    "url": "https://github.com/JamesWeatherhead"
   },
   "homepage": "https://github.com/JamesWeatherhead/grid",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/JamesWeatherhead/grid.git"
-  },
+  "repository": "https://github.com/JamesWeatherhead/grid",
   "license": "MIT",
-  "keywords": ["agents", "orchestration", "multi-agent", "agentic", "automation", "tron"],
-  "claude-code": {
-    "minVersion": "1.0.0"
-  },
-  "directories": {
-    "commands": "../commands",
-    "agents": "../agents",
-    "docs": "../docs"
-  }
+  "keywords": ["agents", "automation", "multi-agent", "orchestration", "swarm", "grid"],
+  "skills": "./commands/grid/",
+  "agents": "./agents/",
+  "hooks": "./commands/grid/hooks/hooks.json"
 }

package/README.md

@@ -1,15 +1,11 @@
 <h1 align="center">THE GRID</h1>
 
 <p align="center">
-  <strong>Multi-agent orchestration for Claude Code that keeps your context clean.</strong>
+  <strong>Ship faster. Stay sane.</strong>
 </p>
 
 <p align="center">
-  Solves context rot, the quality degradation that happens as Claude fills its context window.
-</p>
-
-<p align="center">
-  <em>You talk to Master Control. Master Control handles the rest.</em>
+  <em>"I fight for the Users."</em>
 </p>
 
 <p align="center">
@@ -45,17 +41,18 @@ npx the-grid-cc    # Install (one command)
   <strong>That's it. Works on Mac, Windows, and Linux.</strong>
 </p>
 
-<br>
-
-<p align="center">
-  <img src="assets/install-demo.png" alt="The Grid Installation" width="700"/>
-</p>
-
 ---
 
 ## The Problem
 
-You're building something complex in Claude Code. Your context window fills up. Claude starts forgetting your original goals. You lose the forest for the trees.
+You're building something in Claude Code.
+Sessions get long. Context fills up.
+Claude forgets what you're building.
+Quality degrades. Frustration builds.
+
+**Sound familiar?**
+
+---
 
 ## The Solution
 
@@ -69,8 +66,28 @@ YOU <-> Master Control <-> Worker Agents
      Master Control remembers your goals
 ```
 
-**Without Grid**: One exhausted conversation doing everything
-**With Grid**: Focused Master Control delegating to specialized workers
+**Without Grid**: One exhausted conversation doing everything.
+**With Grid**: Focused Master Control delegating to specialized workers.
+
+---
+
+## No Ceremony
+
+No sprint planning. No story points. No stakeholder syncs. No Jira.
+
+Just you, Claude, and code that ships.
+
+---
+
+## Beyond Code Generation
+
+Other tools stop at code. The Grid goes further:
+
+**Visual Inspector** - Screenshots your app, catches visual bugs
+**E2E Exerciser** - Clicks everything like a real user
+**Persona Simulator** - Reviews from your target users' POV
+
+Run `/grid:refine` after building. Catch issues before users do.
 
 ---
 
@@ -153,6 +170,14 @@ Researches best practices. Injects industry standards. You get expert-level spec
 
 ---
 
+## Who Uses The Grid
+
+*(Notable users section coming soon)*
+
+> "The Grid is like having a senior engineering team on demand."
+
+---
+
 ## Commands
 
 | Command | What It Does |
@@ -182,6 +207,34 @@ Researches best practices. Injects industry standards. You get expert-level spec
 
 ---
 
+## Installation
+
+<details>
+<summary><strong>Alternative: Plugin Installation</strong></summary>
+
+```bash
+# Add Grid marketplace
+/plugin marketplace add JamesWeatherhead/grid
+
+# Install The Grid
+/plugin install the-grid@grid-marketplace
+```
+
+Or via CLI:
+```bash
+claude plugin install the-grid@grid-marketplace --scope user
+```
+
+</details>
+
+<br>
+
+<p align="center">
+  <img src="assets/install-demo.png" alt="The Grid Installation" width="700"/>
+</p>
+
+---
+
 ## FAQ
 
 <details>

package/commands/grid/VERSION

@@ -1 +1 @@
-1.7.27
+1.7.28

package/commands/grid/doctor.md

@@ -12,113 +12,193 @@ disable-model-invocation: true
 argument-hint: "[--fix]"
 ---
 
-Run comprehensive health checks on The Grid installation and suggest fixes for any issues found.
+Run comprehensive health checks on The Grid installation and environment. Diagnoses issues and suggests (or automatically applies) fixes.
 
 ## USAGE
 
 `/grid:doctor`        - Run diagnostics and report issues
 `/grid:doctor --fix`  - Run diagnostics and attempt automatic repairs
 
-## CHECKS TO PERFORM
+## DIAGNOSTIC CHECKS
+
+### 1. Environment Check
+Detect and validate the runtime environment:
+
+- [ ] Detect platform (macOS, Linux, WSL, Windows)
+- [ ] Check Node.js version and installation path
+- [ ] Verify npm installation
+- [ ] Check for WSL PATH issues (Windows only)
+- [ ] Verify Claude Code CLI is installed
+
+**Implementation:**
+```bash
+# Platform detection
+uname -s  # Darwin, Linux, etc.
+uname -r  # Kernel version
+
+# Node.js
+which node
+node --version
+
+# npm
+which npm
+npm --version
+
+# Claude Code
+which claude
+claude --version 2>/dev/null || echo "Not found"
+```
+
+### 2. Installation Check
+Verify Grid files are properly installed:
 
-### 1. Installation Check
 - [ ] `~/.claude/commands/grid/` exists
 - [ ] `~/.claude/agents/` contains grid-*.md files (expect 17)
 - [ ] VERSION file exists and contains valid semver
 
-### 2. Agent Health
+**Implementation:**
+```bash
+# Commands directory
+ls -la ~/.claude/commands/grid/
+
+# Agent count
+ls ~/.claude/agents/grid-*.md 2>/dev/null | wc -l
+
+# VERSION
+cat ~/.claude/commands/grid/VERSION
+```
+
+### 3. Agent Health
 For each agent in `~/.claude/agents/grid-*.md`:
+
 - [ ] File exists and is readable
 - [ ] Has valid YAML frontmatter (starts with `---` block)
 - [ ] Has `name:` field in frontmatter
 - [ ] Has `model:` field (opus, sonnet, haiku, or inherit)
 - [ ] Has `permissionMode:` field (plan or acceptEdits)
 
-### 3. State Health (if .grid/ exists)
+### 4. State Health (if .grid/ exists)
+If an active Grid session exists:
+
 - [ ] STATE.md exists and is parseable
 - [ ] config.json is valid JSON (if exists)
 - [ ] budget.json is valid JSON (if exists)
 - [ ] No orphaned phase files (PLAN.md without corresponding directory structure)
 
-### 4. Hook Health
+**Implementation:**
+```bash
+# Check STATE.md
+cat .grid/STATE.md 2>/dev/null || echo "No active session"
+
+# Validate JSON files
+python3 -c "import json; json.load(open('.grid/config.json'))" 2>/dev/null && echo "config.json: valid" || echo "config.json: invalid or missing"
+
+python3 -c "import json; json.load(open('.grid/budget.json'))" 2>/dev/null && echo "budget.json: valid" || echo "budget.json: invalid or missing"
+```
+
+### 5. Hook Health
+Verify hooks are properly configured:
+
 - [ ] `hooks/` directory exists
 - [ ] `enforce-delegation.sh` exists and is executable
 - [ ] `hooks.json` is valid JSON
 
-### 5. Configuration Health
-- [ ] Model tier is valid (quality, balanced, or budget)
-- [ ] Budget limit is non-negative number (if set)
-- [ ] No conflicting settings between config files
+### 6. Dependencies
+Check for required external tools:
 
-## IMPLEMENTATION
+- [ ] ripgrep (rg) is installed
+- [ ] git is installed and configured
+- [ ] Python 3 is available (for JSON validation)
 
-When invoked:
+**Implementation:**
+```bash
+# ripgrep
+which rg && rg --version
 
-1. **Run all checks** collecting results
-2. **Display categorized results** with pass/warn/fail status
-3. **Generate actionable suggestions** for each issue
-4. **If `--fix` flag**: Attempt automatic repairs for fixable issues
+# git
+which git && git --version
+
+# Python 3
+which python3 && python3 --version
+```
+
+### 7. Configuration Health
+Validate settings:
+
+- [ ] Model tier is valid (quality, balanced, or budget)
+- [ ] Budget limit is non-negative number (if set)
+- [ ] No conflicting settings between config files
 
 ## OUTPUT FORMAT
 
 ```
-GRID DOCTOR
-===========
-
-Installation:  [PASS|WARN|FAIL]
-  [icon] Commands directory exists
-  [icon] {N} agent files found
-  [icon] VERSION file: {version}
-
-Agents:        [PASS|WARN|FAIL]
-  [icon] All agents have valid frontmatter
-  [icon] All agents have name field
-  [icon] {N}/{total} agents have model field
-  [icon] {N}/{total} agents have permissionMode field
-
-State:         [PASS|SKIP|WARN|FAIL]
-  [icon] STATE.md {exists/missing}
-  [icon] config.json {valid/invalid/missing}
-  [icon] budget.json {valid/invalid/missing}
-
-Hooks:         [PASS|WARN|FAIL]
-  [icon] hooks/ directory exists
-  [icon] enforce-delegation.sh {executable/not executable}
-  [icon] hooks.json {valid/invalid}
-
-Configuration: [PASS|WARN|FAIL]
-  [icon] Model tier: {tier}
-  [icon] Budget limit: {limit}
+GRID DOCTOR v{VERSION}
+======================
+
+Environment
+-----------
+  Platform:     {Darwin/Linux/WSL/Windows}
+  Node:         {version} ({path})
+  npm:          {version}
+  Claude CLI:   {version or "not found"}
+
+Installation
+------------
+  Commands:     ~/.claude/commands/grid/ [OK]
+  Agents:       {N}/17 found [OK/WARN/FAIL]
+  VERSION:      {version} [OK]
+
+Agents
+------
+  Frontmatter:  [OK/WARN]
+  name field:   {N}/17 [OK/WARN]
+  model field:  {N}/17 [OK/WARN]
+  permissions:  {N}/17 [OK/WARN]
+
+State
+-----
+  .grid/:       [EXISTS/MISSING]
+  STATE.md:     [OK/EMPTY/MISSING]
+  config.json:  [OK/INVALID/MISSING]
+  budget.json:  [OK/INVALID/MISSING]
+
+Hooks
+-----
+  hooks/:       [OK/MISSING]
+  delegation:   [OK/NOT EXECUTABLE/MISSING]
+  hooks.json:   [OK/INVALID/MISSING]
+
+Dependencies
+------------
+  ripgrep:      [OK] {version}
+  git:          [OK] {version}
+  python3:      [OK] {version}
+
+Configuration
+-------------
+  Model tier:   {quality/balanced/budget}
+  Budget limit: {$amount or "none"}
 
 ---------------------------------
 Overall: HEALTHY / NEEDS ATTENTION / UNHEALTHY
 
-Suggestions:
-  1. {Specific fix for first issue}
-  2. {Specific fix for second issue}
-  ...
+{Suggestions section if issues found}
 
 End of Line.
 ```
 
-## STATUS ICONS
+## STATUS INDICATORS
 
-```
-[check] = Pass (green checkmark)
-[warn]  = Warning (yellow triangle)
-[fail]  = Fail (red X)
-[skip]  = Skipped (gray dash)
-```
+Use these symbols for status:
 
-Rendered as:
-- Pass: checkmark
-- Warn: warning
-- Fail: X
-- Skip: dash
+- `[OK]` - Pass (all good)
+- `[WARN]` - Warning (functional but suboptimal)
+- `[FAIL]` - Fail (broken, needs fix)
+- `[SKIP]` - Skipped (not applicable)
 
 ## EXPECTED AGENT FILES
 
-The Grid expects these 17 agent files:
+The Grid expects these 17 agent files in `~/.claude/agents/`:
 
 1. grid-planner.md
 2. grid-executor.md
@@ -167,51 +247,114 @@ When `--fix` is provided, doctor will attempt:
 | Missing .grid/ directory | Create it |
 | Invalid config.json | Reset to defaults |
 | Non-executable hook script | `chmod +x` the script |
-| Missing VERSION file | Create with "1.7.0" |
+| Missing VERSION file | Create with current version |
 | Malformed budget.json | Reset to `{}` |
+| Missing ripgrep | Suggest install command |
 
 Issues that CANNOT be auto-fixed:
 - Missing agent files (requires reinstall)
 - Invalid agent frontmatter (requires manual review)
 - Corrupted STATE.md (requires mission restart)
+- Missing Node.js or Claude CLI
 
 ## NO ISSUES FOUND
 
 If all checks pass:
 
 ```
-GRID DOCTOR
-===========
+GRID DOCTOR v1.7.x
+==================
+
+Environment
+-----------
+  Platform:     Darwin (macOS 14.x)
+  Node:         v20.x.x (/usr/local/bin/node)
+  npm:          10.x.x
+  Claude CLI:   1.x.x
+
+Installation
+------------
+  Commands:     ~/.claude/commands/grid/ [OK]
+  Agents:       17/17 found [OK]
+  VERSION:      1.7.x [OK]
+
+Agents
+------
+  Frontmatter:  [OK]
+  name field:   17/17 [OK]
+  model field:  17/17 [OK]
+  permissions:  17/17 [OK]
+
+State
+-----
+  .grid/:       [SKIP] No active session
+  STATE.md:     [SKIP]
+  config.json:  [SKIP]
+  budget.json:  [SKIP]
+
+Hooks
+-----
+  hooks/:       [OK]
+  delegation:   [OK]
+  hooks.json:   [OK]
+
+Dependencies
+------------
+  ripgrep:      [OK] 14.x.x
+  git:          [OK] 2.x.x
+  python3:      [OK] 3.x.x
+
+Configuration
+-------------
+  Model tier:   balanced
+  Budget limit: none
 
-Installation:  PASS
-  checkmark Commands directory exists
-  checkmark 17 agent files found
-  checkmark VERSION file: 1.7.20
+---------------------------------
+Overall: HEALTHY
 
-Agents:        PASS
-  checkmark All agents have valid frontmatter
-  checkmark All agents have name field
-  checkmark 17/17 agents have model field
-  checkmark 17/17 agents have permissionMode field
+The Grid is functioning within normal parameters.
 
-State:         SKIP
-  dash No active Grid session (.grid/ not found)
+End of Line.
+```
 
-Hooks:         PASS
-  checkmark hooks/ directory exists
-  checkmark enforce-delegation.sh executable
-  checkmark hooks.json valid
+## COMMON ISSUES AND FIXES
+
+### Issue: "ripgrep not found"
+**Fix:**
+- macOS: `brew install ripgrep`
+- Linux: `apt install ripgrep` or `cargo install ripgrep`
+- Windows: `choco install ripgrep`
+
+### Issue: "Agent files missing"
+**Fix:**
+```bash
+# Reinstall The Grid
+npm install -g the-grid-cc
+# Or copy from source
+cp -r /path/to/grid/agents/* ~/.claude/agents/
+```
 
-Configuration: PASS
-  checkmark Model tier: balanced
-  checkmark Budget limit: none
+### Issue: "Invalid config.json"
+**Fix with --fix flag:**
+```bash
+/grid:doctor --fix
+# Resets to: {"modelTier": "balanced", "budgetLimit": null}
+```
 
----------------------------------
-Overall: HEALTHY
+### Issue: "hooks not executable"
+**Fix with --fix flag:**
+```bash
+/grid:doctor --fix
+# Runs: chmod +x hooks/enforce-delegation.sh
+```
 
-The Grid is functioning within normal parameters.
+## CONTEXT USAGE WARNING
+
+If context usage exceeds 50%, doctor will add a warning:
 
-End of Line.
+```
+Context Warning: {N}% context used
+  Consider running /compact before continuing.
 ```
 
 ## DATA SOURCES
@@ -226,15 +369,6 @@ End of Line.
 | Budget | `.grid/budget.json` |
 | Hooks | Grid installation `hooks/` directory |
 
-## CONTEXT USAGE WARNING
-
-If context usage exceeds 50%, doctor will add a warning:
-
-```
-Context Warning: {N}% context used
-  Consider running /compact before continuing.
-```
-
 ## RELATED COMMANDS
 
 - `/grid:status` - Show current mission progress