Add validation strategy with webhooks.full.json

Author: ericsciple

json-optimization-plan.md

@@ -140,6 +140,73 @@ Example: The "user" object structure appears ~122 times with identical fields.
 
 ---
 
+## Validation Strategy
+
+### Source of Truth: `webhooks.full.json`
+
+Check in the complete, unoptimized webhook data from the npm package as `webhooks.full.json` (~17 MB). This serves as:
+
+1. **Source of truth** for validation
+2. **Debugging reference** when investigating issues
+3. **Reproducible input** for deterministic optimization
+
+### File Structure
+
+```
+languageservice/src/context-providers/events/
+├── webhooks.full.json    # Full unoptimized data (~17 MB, checked in)
+├── webhooks.json         # Human-readable optimized (generated)
+├── webhooks.min.json     # Minified optimized (generated, used at runtime)
+├── objects.json          # Deduplicated shared objects (generated)
+└── objects.min.json      # Minified shared objects (generated, used at runtime)
+```
+
+### Validation Test
+
+Add a unit test that:
+
+1. Loads event payload data from `webhooks.full.json` (parse + walk to build DescriptionDictionary)
+2. Loads event payload data from optimized `webhooks.min.json` + `objects.min.json` (existing code path)
+3. Walks both structures and verifies they produce identical results for:
+   - All event types and action types
+   - All property names at each level
+   - All descriptions
+   - All nested childParamsGroups
+
+```typescript
+describe("optimization validation", () => {
+  it("optimized data matches full source data", () => {
+    const fullPayload = loadFromFull("push", "default");
+    const optimizedPayload = getEventPayload("push", "default");
+    
+    expectStructuresMatch(fullPayload, optimizedPayload);
+  });
+  
+  it("validates all events and actions", () => {
+    for (const [event, actions] of Object.entries(fullWebhooks)) {
+      for (const action of Object.keys(actions)) {
+        const full = loadFromFull(event, action);
+        const optimized = getEventPayload(event, action);
+        expectStructuresMatch(full, optimized);
+      }
+    }
+  });
+});
+```
+
+### Generation Process
+
+The `update-webhooks` script should:
+
+1. Fetch webhook schema from npm package
+2. Write `webhooks.full.json` (complete, unmodified)
+3. Generate optimized `webhooks.json` + `objects.json`
+4. Minify to `webhooks.min.json` + `objects.min.json`
+
+This ensures the optimization pipeline is always validated against the true source.
+
+---
+
 ## Implementation Notes
 
 ### Phase 1: Short Property Names