the-grid-cc 1.7.14 → 1.7.16

package/templates/grid-state/DECISIONS.md

@@ -0,0 +1,30 @@
+---
+cluster: null
+decision_count: 0
+last_updated: "{ISO timestamp}"
+---
+
+# Grid Decisions Log
+
+User decisions made via I/O Tower. Referenced during resume to maintain consistency.
+
+## Format
+
+Each decision follows this format:
+
+```
+## Decision {N}: {ISO timestamp}
+**Question:** {what was asked}
+**Options Presented:**
+  - {option_a}: "{description}"
+  - {option_b}: "{description}"
+**User Choice:** {choice}
+**Rationale:** "{user's reason if given}"
+**Affects:** {blocks/features affected}
+```
+
+---
+
+## Decisions
+
+*(Decisions will appear below)*

package/templates/grid-state/README.md

@@ -0,0 +1,138 @@
+# Grid State Templates
+
+This directory contains templates for the `.grid/` state persistence system.
+
+## Template Files
+
+### Core State Files
+
+| File | Purpose | Updated By | Update Frequency |
+|------|---------|------------|------------------|
+| `STATE.md` | Central state tracking | MC | Every wave |
+| `WARMTH.md` | Institutional knowledge | MC | After each block |
+| `SCRATCHPAD.md` | Live discoveries | Executors | During execution |
+| `DECISIONS.md` | User decision log | MC | On user decision |
+| `BLOCKERS.md` | Blocker tracking | MC/Executors | On blocker encountered |
+| `CHECKPOINT.md` | Interrupted thread state | Executor | On checkpoint/interrupt |
+| `config.json` | Grid configuration | User/MC | On config change |
+| `BLOCK-SUMMARY.md` | Completed block record | Executor | On block complete |
+
+## Directory Structure
+
+When `/grid:init` runs, it creates this structure:
+
+```
+.grid/
+├── STATE.md                    # Central state (read first on resume)
+├── WARMTH.md                   # Accumulated institutional knowledge
+├── SCRATCHPAD.md               # Live discoveries
+├── DECISIONS.md                # User decisions log
+├── BLOCKERS.md                 # Active and resolved blockers
+├── config.json                 # Grid configuration
+│
+├── plans/                      # Execution plans
+│   ├── {cluster}-PLAN-SUMMARY.md
+│   ├── {cluster}-block-01.md
+│   └── ...
+│
+├── phases/                     # Execution artifacts
+│   ├── 01-{phase-name}/
+│   │   ├── 01-PLAN.md
+│   │   └── 01-SUMMARY.md
+│   └── ...
+│
+├── discs/                      # Identity Discs for Programs
+│   └── {program-id}.md
+│
+├── debug/                      # Debug session state
+│   └── {timestamp}-{slug}/
+│
+└── refinement/                 # Refinement swarm outputs
+    ├── screenshots/
+    ├── e2e/
+    └── personas/
+```
+
+## Usage
+
+### Initialize New Project
+
+```bash
+/grid:init
+```
+
+Creates `.grid/` with all templates initialized.
+
+### Resume Interrupted Mission
+
+```bash
+/grid:resume
+```
+
+Reads STATE.md, validates consistency, reconstructs context, and continues execution.
+
+## State Lifecycle
+
+### 1. Initialize
+- STATUS: `initialized`
+- FILES: STATE.md, WARMTH.md, SCRATCHPAD.md, config.json
+
+### 2. Mission Start
+- STATUS: `active`
+- FILES: Plans written to `.grid/plans/`
+
+### 3. Block Execution
+- STATUS: `active`
+- FILES: SCRATCHPAD.md updated during work
+
+### 4. Block Complete
+- STATUS: `active`
+- FILES: SUMMARY.md written to `.grid/phases/`
+- WARMTH.md aggregated
+
+### 5. Checkpoint Hit
+- STATUS: `checkpoint`
+- FILES: CHECKPOINT.md written with thread state
+
+### 6. Session Death
+- STATUS: `interrupted` (if checkpoint written) or `active` (stale)
+- FILES: CHECKPOINT.md may or may not exist
+
+### 7. Resume
+- STATUS: `active`
+- FILES: CHECKPOINT.md archived or deleted
+- Context reconstructed from all state files
+
+### 8. Mission Complete
+- STATUS: `completed`
+- FILES: Final SUMMARY.md written
+- WARMTH.md finalized
+
+## State Validation
+
+Before resume, the system validates:
+
+1. **Commits exist** - All claimed commit hashes exist in git
+2. **Files exist** - All claimed artifacts exist on disk
+3. **Plans available** - Plans exist for pending blocks
+4. **Single checkpoint** - No conflicting checkpoint files
+5. **State parseable** - All YAML frontmatter is valid
+
+## Persistence Guarantees
+
+After initialization, The Grid guarantees:
+
+1. **State survives session death** - All progress recorded in files
+2. **Warmth accumulates** - Knowledge transfers across Programs
+3. **Decisions persist** - User choices never need repeating
+4. **Commits are verified** - Git hashes enable state validation
+5. **Plans are preserved** - Full execution plans available for resume
+
+## Related Commands
+
+- `/grid` - Begin a mission (auto-initializes if needed)
+- `/grid:init` - Initialize .grid/ structure
+- `/grid:resume` - Resume interrupted mission
+- `/grid:status` - Display current state
+
+End of Line.

package/templates/grid-state/SCRATCHPAD.md

@@ -0,0 +1,29 @@
+---
+updated: "{ISO timestamp}"
+active_programs: []
+---
+
+# Grid Scratchpad
+
+Live discoveries during execution. Programs write here when they learn something others need to know.
+
+## Format
+
+Each entry must follow:
+
+```
+### {program-id} | {ISO-timestamp} | {category}
+
+**Finding:** {one clear sentence}
+**Impact:** {who needs to know}
+**Action:** [INFORM_ONLY | REQUIRES_CHANGE | BLOCKER]
+**Details:** {additional context}
+```
+
+Categories: PATTERN | DECISION | BLOCKER | PROGRESS | CORRECTION
+
+---
+
+## Entries
+
+*(Entries will appear below)*

package/templates/grid-state/STATE.md

@@ -0,0 +1,47 @@
+---
+# Identity
+cluster: null
+session_id: "{timestamp}-init"
+status: initialized  # initialized | active | checkpoint | interrupted | completed | failed
+
+# Position tracking
+position:
+  phase: 0
+  phase_total: 0
+  phase_name: null
+  block: 0
+  block_total: 0
+  wave: 0
+  wave_total: 0
+
+# Progress
+progress_percent: 0
+energy_remaining: 10000
+
+# Execution mode
+mode: autopilot  # autopilot | guided | hands_on
+
+# Timestamps
+created_at: "{ISO timestamp}"
+updated_at: "{ISO timestamp}"
+---
+
+# Grid State
+
+## Current Position
+- Active Cluster: none
+- Active Block: none
+- Status: Initialized
+
+Progress: [----------] 0%
+
+## Session Info
+- Initialized: {current date}
+- Session ID: {session_id}
+- Mode: AUTOPILOT
+
+## Last Activity
+Initialized Grid state directory.
+
+## Notes
+Ready for /grid to begin a mission.

package/templates/grid-state/WARMTH.md

@@ -0,0 +1,48 @@
+---
+cluster: null
+accumulated_from: []
+last_updated: "{ISO timestamp}"
+---
+
+# Grid Warmth
+
+Accumulated knowledge from Programs. Survives session death.
+
+## Codebase Patterns
+
+*(Patterns discovered about the codebase)*
+
+- Example: "This project uses Astro content collections for blog posts"
+- Example: "Dark mode uses class strategy with localStorage"
+
+## Gotchas
+
+*(Traps and pitfalls to avoid)*
+
+- Example: "Astro config must use .mjs extension for ESM"
+- Example: "Shiki syntax highlighting is build-time only"
+
+## User Preferences
+
+*(Inferred user preferences)*
+
+- Example: "User prefers minimal dependencies"
+- Example: "User wants dark mode as default"
+
+## Decisions Made
+
+*(Key decisions and their rationale)*
+
+- Example: "Chose serverless adapter over static for future flexibility"
+
+## Almost Did
+
+*(Approaches considered but rejected)*
+
+- Example: "Considered MDX but stuck with plain MD for simplicity"
+
+## Fragile Areas
+
+*(Code that breaks easily)*
+
+- Example: "Content collection schema changes require restart"

package/templates/grid-state/config.json

@@ -0,0 +1,24 @@
+{
+  "model_tier": "quality",
+  "model_tier_options": [
+    "quality",
+    "balanced",
+    "budget"
+  ],
+  "auto_verify": true,
+  "scratchpad_heartbeat_minutes": 5,
+  "stale_threshold_minutes": 10,
+  "max_retry_attempts": 3,
+  "created_at": "{ISO timestamp}",
+  "git": {
+    "auto_branch": true,
+    "branch_prefix": "grid/",
+    "auto_push": "wave",
+    "auto_pr": false,
+    "protected_branches": ["main", "master", "production"],
+    "default_base": "main",
+    "sync_strategy": "merge",
+    "commit_signing": false,
+    "wip_commits": true
+  }
+}