docs: comprehensive documentation and simulation overhaul

.github/LOCAL_DEV_DIAGRAM.md

@@ -55,9 +55,8 @@ Start Anvil
     │
     ├─► Core Protocol Contracts
     │   ├─► ELTA Token ─────────────► 0x5FbDB...
-    │   ├─► ElataXP ────────────────► 0xe7f17...
+    │   ├─► ElataPoints ────────────► 0xe7f17...
     │   ├─► VeELTA ────────────────► 0x9fE46...
-    │   ├─► LotPool ───────────────► 0xCf7Ed...
     │   ├─► RewardsDistributor ────► 0xDc64a...
     │   ├─► ElataTimelock ─────────► 0x5FC8d...
     │   └─► ElataGovernor ─────────► 0x0165...
@@ -127,7 +126,7 @@ generate-config.ts
     └─► Generate: frontend/src/config/contracts.ts
         export const contracts = {
           ELTA: '0x5FbDB...' as const,
-          ElataXP: '0xe7f17...' as const,
+          ElataPoints: '0xe7f17...' as const,
           ...
         };
 ```
@@ -258,7 +257,7 @@ Persistence: Ephemeral (resets on restart)
 ## What Gets Created
 
 ### Contracts (12)
-- ✅ ELTA, ElataXP, VeELTA, LotPool
+- ✅ ELTA, ElataPoints, VeELTA
 - ✅ RewardsDistributor, ElataTimelock, ElataGovernor
 - ✅ AppFactory, AppModuleFactory, TournamentFactory
 - ✅ Mock Uniswap Factory + Router

.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [main, develop]
+    branches: [main, develop, vNext]
   pull_request:
-    branches: [main, develop]
+    branches: [main, develop, vNext]
 
 env:
   FOUNDRY_PROFILE: ci
@@ -22,14 +22,27 @@ jobs:
         uses: foundry-rs/foundry-toolchain@v1
         with:
           version: v1.4.2
+          cache: true
+
+      - name: Cache Foundry build
+        uses: actions/cache@v4
+        with:
+          path: |
+            cache/
+            out/
+          key: foundry-build-${{ hashFiles('foundry.toml', 'src/**/*.sol', 'test/**/*.sol', 'lib/**') }}
+          restore-keys: |
+            foundry-build-
 
       - name: Show Foundry version
         run: forge --version
 
-      - name: Run Forge build
+      - name: Run Forge build (source only)
         run: |
           forge --version
-          forge build
+          forge build src/ --sizes
+        env:
+          FOUNDRY_PROFILE: default
 
       - name: Run Forge tests
         run: |
@@ -39,20 +52,6 @@ jobs:
         run: |
           forge test --match-contract CoreSecurityVerification
 
-  lint:
-    name: Code Quality
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install Foundry
-        uses: foundry-rs/foundry-toolchain@v1
-        with:
-          version: v1.4.2
-
-      - name: Run gas report
-        run: forge test --gas-report
-
   coverage:
     name: Test Coverage
     runs-on: ubuntu-latest
@@ -78,4 +77,32 @@ jobs:
           flags: foundry
           token: ${{ secrets.CODECOV_TOKEN }}
         continue-on-error: true
-        if: success() || failure()
+
+  snapshot:
+    name: Gas Snapshot
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+        with:
+          version: v1.4.2
+
+      - name: Generate gas snapshot
+        run: forge snapshot
+
+      - name: Compare gas snapshot (PR only)
+        if: github.event_name == 'pull_request'
+        run: forge snapshot --check
+        continue-on-error: true
+
+      - name: Upload snapshot artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: gas-snapshot
+          path: .gas-snapshot
+          retention-days: 30

.github/workflows/pr-checks.yml

@@ -58,38 +58,6 @@ jobs:
           forge test --match-contract Security -vv
           forge test --match-contract CoreSecurityVerification -vv
 
-  gas-report:
-    name: Gas Report
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-
-      - name: Install Foundry
-        uses: foundry-rs/foundry-toolchain@v1
-        with:
-          version: v1.4.2
-
-      - name: Generate gas report
-        run: forge test --gas-report
-
-      - name: Post gas report as comment
-        uses: actions/github-script@v7
-        if: github.event_name == 'pull_request'
-        with:
-          script: |
-            const fs = require('fs');
-            const gasReport = await exec.getExecOutput('forge test --gas-report');
-
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: '## ⛽ Gas Report\n\n```\n' + gasReport.stdout + '\n```'
-            });
-        continue-on-error: true
-
   coverage:
     name: Test Coverage
     runs-on: ubuntu-latest