docs: codify testing constraints and God Node invariants via /learn

Author: hateem2121

AGENTS.md

@@ -69,6 +69,10 @@ When creating or generating unit test files:
 
 4. **Always run the new tests before marking task items complete.** Execute `npx vitest run <path>` on the newly created test files to confirm they parse and pass before checking off items in `task.md`.
 
+5. **CLI Tool & Script Testing:** When writing tests for CLI scripts (e.g., in `scripts/`), ensure the target script's execution blocks are wrapped in `if (process.env.NODE_ENV !== "test")`. Importing scripts that contain top-level `process.exit()` calls will crash the Vitest runner prematurely.
+
+6. **JSDOM Animation Stubbing:** When writing DOM-based React tests for components that utilize GSAP (`ScrollTrigger`) or `locomotive-scroll`, you must provide extensive global stubs for `IntersectionObserver`, `window.matchMedia`, and GSAP's matchMedia hooks, as JSDOM does not support layout engines.
+
 ### 6.11 React Router v8 & Vite 8 Resolution Rules (Addendum)
 
 - **CSP Nonce Hydration Mismatch**: In React 19, Chrome hides the `nonce` attribute on `<link>` tags for security, causing a fatal hydration mismatch if the Virtual DOM expects a value. When rendering React Router's `<Links />` component in the root layout or error boundaries, you **MUST** pass an empty string on the client (e.g., `<Links nonce="" />`) to bypass the mismatch and prevent React from crashing the client-side render tree.

gemini.md

@@ -381,6 +381,12 @@ When writing or updating unit tests for services/repositories that return `never
 2. **Assertions (Success)**: NEVER use `expect(result).resolves.toEqual(...)`. Wait for the result and assert the value via `.isOk()`, `.isErr()`, or by using `_unsafeUnwrap()` *only* in tests: `expect((await service.method())._unsafeUnwrap()).toEqual(mockData)`.
 3. **Assertions (Failures)**: NEVER use `await expect(...).rejects.toThrow()`. The function does not throw; it returns an `err()`. You MUST assert failure using `expect((await service.method()).isErr()).toBe(true)`.
 
+### 6.5.3 MemoryStorage "God Node" Invariant
+
+The `tests/integration/server/memory-storage.ts` mock repository is the foundational dependency for over 343+ test files. 
+- It **MUST** remain perfectly synchronized with the `IStorage` interface in `server/repositories/storage-interfaces.ts`. 
+- Any refactoring to the storage interface requires an immediate mirroring update to the `MemoryStorage` class. Failure to do so will cascade into hundreds of integration test failures.
+
 ### 6.6 Drizzle + Zod Schema Pattern (Mandatory)
 
 ```typescript