Skip to content

Add Global Giving Activity Index with multi-platform aggregation#255

Merged
SebastienMelki merged 15 commits intofeat/happy-monitorfrom
claude/review-pr-zPvM9
Feb 23, 2026
Merged

Add Global Giving Activity Index with multi-platform aggregation#255
SebastienMelki merged 15 commits intofeat/happy-monitorfrom
claude/review-pr-zPvM9

Conversation

@koala73
Copy link
Owner

@koala73 koala73 commented Feb 23, 2026

Summary

Adds a new Global Giving Activity Index panel that aggregates personal charitable giving data from multiple crowdfunding and institutional sources into a composite activity metric. The implementation includes:

  • GetGivingSummary RPC that samples campaigns from GoFundMe, GlobalGiving, and JustGiving APIs
  • Campaign sampling & velocity estimation from live platform data with directional daily flow extrapolation
  • Category breakdown of giving activity (Medical, Disaster Relief, Education, etc.)
  • Crypto philanthropy tracking via on-chain wallet monitoring (Endaoment, The Giving Block)
  • Institutional baseline from OECD ODA and CAF World Giving Index data
  • Activity Index (0-100) computed from platform volume, donation velocity, and new campaign signals
  • GivingPanel UI component with tabbed interface for platforms, categories, crypto, and institutional data
  • Redis caching (1-hour TTL) for campaign data that shifts slowly

Type of change

  • New feature
  • New data source / feed
  • API endpoints (/api/*)

Affected areas

  • News panels / RSS feeds
  • API endpoints (/api/*)
  • Config / Settings

Implementation details

Backend (server/worldmonitor/giving/v1/get-giving-summary.ts):

  • Samples ~120 campaigns across 6 categories from GoFundMe public API
  • Extrapolates daily volume using campaign age and donation counts
  • Fetches GlobalGiving project stats and applies directional estimates
  • Uses published JustGiving annual reports ($7B+) for macro signal
  • Estimates crypto giving at ~$5.5M/day from on-chain tracking data
  • Computes composite activity index weighted by data quality and signal strength
  • Caches results in Redis for 1 hour

Frontend (src/components/GivingPanel.ts):

  • Displays activity index with color-coded severity (0-100 scale)
  • Shows trend direction (rising/stable/falling) with visual indicators
  • Tabbed interface for platforms, categories, crypto, and institutional data
  • Platform table with daily volume, donation velocity, and data freshness badges
  • Category breakdown with share percentages and trending indicators
  • Crypto section showing daily inflow, tracked wallets, and top receivers
  • Institutional section with OECD ODA and CAF World Giving Index metrics

Proto definitions (proto/worldmonitor/giving/v1/):

  • service.proto: GivingService RPC definition
  • giving.proto: Message types for summary, platforms, categories, crypto, and institutional data
  • get_giving_summary.proto: Request/response types with optional limits

Generated code:

  • Server-side handler types and route creation
  • Client-side service client with circuit breaker integration
  • TypeScript interfaces for all data structures

Checklist

  • Tested on worldmonitor.app variant
  • No API keys or secrets committed (uses public APIs)
  • TypeScript compiles without errors
  • Proto definitions follow existing patterns
  • Circuit breaker and error handling implemented
  • Redis caching configured with appropriate TTL

Notes

  • Campaign sampling is best-effort per category; failures are gracefully handled
  • Daily volume estimates are directional proxies, not precise measurements
  • Crypto giving percentage (~0.8% of total) based on 2024 industry estimates
  • Activity index baseline is 50; adjusted ±20 based on volume ratio, velocity, and new campaigns
  • Data freshness varies by source: "live" (GoFundMe), "weekly" (GlobalGiving), "annual" (JustGiving, OECD)

https://claude.ai/code/session_01MTSaVy4aB4xLgB9qa5Uayp

SebastienMelki and others added 15 commits February 22, 2026 16:26
…ty) (#226)

* docs: add community guidelines — contributing guide, code of conduct, and security policy

Add three community health files for the open-source project:

- CONTRIBUTING.md: comprehensive guide covering architecture overview (sebuf,
  variants, directory structure), development setup with make commands,
  AI-assisted development policy, sebuf RPC workflow, data source and RSS
  feed contribution guides, coding standards, and PR process
- CODE_OF_CONDUCT.md: Contributor Covenant v2.1 adapted for World Monitor
- SECURITY.md: responsible disclosure policy, security considerations for
  edge functions/sebuf handlers, and contributor best practices

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add missing blank line before list in CONTRIBUTING.md (MD032)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: expand AI section with LLM label attribution and rationale

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: remove GitHub link from AI section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: simplify AI section back to concise version with PR labels

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* chore: apply cargo fmt formatting to main.rs

Pure formatting normalization with no logic changes. Separated from
the behavioral fix to keep git blame clean.

https://claude.ai/code/session_01RPQ1PEqxTSEG6rB5XadzEz

* fix: restrict settings-window re-focus to macOS to avoid Windows focus churn

On Windows, the Focused(true) handler on the main window calls
show()+set_focus() on the settings window, which steals focus back,
retriggering the event in a tight loop and presenting as a UI hang.

Gate the match arm with #[cfg(target_os = "macos")] (compile-time
attribute) instead of cfg!() (runtime macro) to match the convention
used by the adjacent macOS-only handlers and eliminate dead code on
non-macOS builds entirely.

https://claude.ai/code/session_01RPQ1PEqxTSEG6rB5XadzEz

---------

Co-authored-by: Claude <noreply@anthropic.com>
)

* fix(sentry): add noise filters for 5 non-actionable error patterns

Filter dynamic import alt phrasing, script parse errors, maplibre
style/WebGL crashes, and CustomEvent promise rejections. Also fix
beforeSend to catch short Firefox null messages like "E is null".

* fix: cache write race, settings stale key status, yahoo gate concurrency

P1: Replace async background thread cache write with synchronous fs::write
to prevent out-of-order writes and dirty flag cleared before persistence.

P2: Add WorldMonitorTab.refresh() called after loadDesktopSecrets() so
the API key badge reflects actual keychain state.

P3: Replace timestamp-based Yahoo gate with promise queue to ensure
sequential execution under concurrent callers.

* feat: add Upstash Redis shared caching to all RPC handlers + fix cache key contamination

- Add Redis L2 cache (getCachedJson/setCachedJson) to 28 RPC handlers
  across all service domains (market, conflict, cyber, economic, etc.)
- Fix 10 P1 cache key contamination bugs where under-specified keys
  caused cross-request data pollution (e.g. filtered requests returning
  unfiltered cached data)
- Restructure list-internet-outages to cache-then-filter pattern so
  country/timeRange filters always apply after cache read
- Add write_lock mutex to PersistentCache in main.rs to prevent
  desktop cache write-race conditions
- Document FMP (Financial Modeling Prep) as Yahoo Finance fallback TODO
  in market/v1/_shared.ts

* fix: cache-key contamination and PizzINT/GDELT partial-failure regression

- tech-events: fetch with limit=0 and cache full result, apply limit
  slice after cache read to prevent low-limit requests poisoning cache
- pizzint: restore try-catch around PizzINT fetch so GDELT tension
  pairs are still returned when PizzINT API is down

* fix: remove extra closing brace in pizzint try-catch

* fix: recompute conferenceCount/mappableCount after limit slice

* fix: bypass WM API key gate for registration endpoint

/api/register-interest must reach cloud without a WorldMonitor API key,
otherwise desktop users can never register (circular dependency).
* fix: resolve AppImage blank white screen and font crash on Linux (#238)

Disable WebKitGTK DMA-BUF renderer by default on Linux to prevent blank
white screens caused by GPU buffer allocation failures (common with
NVIDIA drivers and immutable distros like Bazzite). Add Linux-native
monospace font fallbacks (DejaVu Sans Mono, Liberation Mono) to all font
stacks so WebKitGTK font resolution doesn't hit out-of-bounds vector
access when macOS-only fonts (SF Mono, Monaco) are unavailable.

https://claude.ai/code/session_01TF2NPgSSjgenmLT2XuR5b9

* fix: consolidate monospace font stacks into --font-mono variable

- Define --font-mono in :root (main.css) and .settings-shell (settings-window.css)
- Align font stack: SF Mono, Monaco, Cascadia Code, Fira Code, DejaVu Sans Mono, Liberation Mono
- Replace 3 hardcoded JetBrains Mono stacks with var(--font-mono)
- Replace 4 hardcoded settings-window stacks with var(--font-mono)
- Fix pre-existing bug: var(--font-mono) used in 4 places but never defined
- Match index.html skeleton font stack to --font-mono

---------

Co-authored-by: Claude <noreply@anthropic.com>
* feat: make intelligence alert popup opt-in via dropdown toggle

Auto-popup was interrupting users every 10s refresh cycle. Badge still
counts and pulses silently. New toggle in dropdown (default OFF) lets
users explicitly opt in to auto-popup behavior.

* chore: bump version to 2.5.5

## Changelog

### Features
- Intelligence alert popup is now opt-in (default OFF) — badge counts silently, toggle in dropdown to enable auto-popup

### Bug Fixes
- Linux: disable DMA-BUF renderer on WebKitGTK to prevent blank white screen (NVIDIA/immutable distros)
- Linux: add DejaVu Sans Mono + Liberation Mono font fallbacks for monospace rendering
- Consolidate monospace font stacks into --font-mono CSS variable (fixes undefined var bug)
- Reduce dedup coordinate rounding from 0.5° to 0.1° (~10km precision)
- Vercel build: handle missing previous deploy SHA
- Panel base class: add missing showRetrying method
- Vercel ignoreCommand shortened to fit 256-char limit

### Infrastructure
- Upstash Redis shared caching for all RPC handlers + cache key contamination fix
- Format Rust code and fix Windows focus handling

### Docs
- Community guidelines: contributing, code of conduct, security policy
- Updated .env.example

* chore: track Cargo.lock for reproducible Rust builds

* fix: update layer help popup with all current map layers

Added missing layers to the ? help popup across all 3 variants:
- Full: UCDP Events, Displacement, Spaceports, Cyber Threats, Fires,
  Climate Anomalies, Critical Minerals; renamed Shipping→Ship Traffic
- Tech: Tech Events, Cyber Threats, Fires
- Finance: GCC Investments

* docs: update README with crypto prices, analytics, typography, and dedup grid fix

* fix: add /ingest to service worker NetworkOnly routes

The SW was intercepting PostHog /ingest/* requests and returning
no-response (404) because no cache match existed. Adding NetworkOnly
ensures analytics requests pass through to Vercel's rewrite proxy.

* chore: update Cargo.lock for v2.5.5

* fix: use explicit colors for findings toggle switch visibility
vi → vn (ISO 3166-1 alpha-2 for Vietnam). Also add explicit th mapping for Thailand.
- Fix PostHog /ingest 404: Workbox registerRoute defaults to GET only,
  PostHog sends POST. Add POST routes for /api/ and /ingest/.
- Fix fullscreen crash: optional chaining on exitFullscreen()?.catch()
  for browsers returning undefined instead of Promise.
- Add 6 noise filters: __firefox__, ifameElement.contentDocument,
  Invalid video id, Fetch is aborted, Stylesheet append timeout,
  Cannot assign to read only property.
- Widen Program failed to link filter (remove ": null" suffix).
The broad regex /^https?:\/\/.*\/api\/.*/i matched ANY URL with /api/
in the path, including external APIs like NASA EONET
(eonet.gsfc.nasa.gov/api/v3/events). Workbox intercepted these
cross-origin requests with NetworkOnly, causing no-response errors
when CORS failed.

Changed all /api/, /ingest/, and /rss/ SW route patterns to use
sameOrigin callback check so only our Vercel routes get NetworkOnly
handling. External APIs now pass through without SW interference.
- Narrow /telegram route to exact prefix match (prevents /telegramXYZ matching)
- Remove lastError from public /telegram/feed and /health responses
- Remove relayUrl and internal details from Vercel proxy error responses
- Replace O(n^2) findIndex dedup with Set-based dedup
- Remove unused writeFileSync/existsSync imports
- Log top-level poll errors instead of swallowing silently
- Warn when selected channel bucket is empty

https://claude.ai/code/session_01MMR4VPJDcAW5PuhLu3Vt1b
@vercel
Copy link

vercel bot commented Feb 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
worldmonitor Ready Ready Preview, Comment Feb 23, 2026 1:23pm
worldmonitor-finance Ready Ready Preview, Comment Feb 23, 2026 1:23pm
worldmonitor-happy Ready Ready Preview, Comment Feb 23, 2026 1:23pm
worldmonitor-startup Ready Ready Preview, Comment Feb 23, 2026 1:23pm

Request Review

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4cb58901f4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

])
.setup(|app| {
// Load persistent cache into memory (avoids 14MB file I/O on every IPC call)
let cache_path = cache_file_path(&app.handle()).unwrap_or_default();

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Propagate cache path resolution failures

Using unwrap_or_default() here hides app_data_dir failures and initializes PersistentCache with an empty path, so read_cache_entry later returns Ok(None) instead of surfacing an error. In that failure mode, the frontend read path in getPersistentCache treats desktop cache reads as successful misses and does not fall back to IndexedDB/localStorage, while writes still fail and fall back, leading to inconsistent cache behavior and lost persisted reads across restarts on environments where app data dir resolution fails.

Useful? React with 👍 / 👎.

@SebastienMelki
Copy link
Collaborator

Thanks a lot @koala73

@SebastienMelki SebastienMelki merged commit 43effb6 into feat/happy-monitor Feb 23, 2026
6 checks passed
SebastienMelki added a commit that referenced this pull request Feb 24, 2026
Cherry-pick the giving feature that was left behind when PR #255
batch-merged without including #254's proto/handler/panel files.

Adds:
- Proto definitions (GivingService, GivingSummary, PlatformGiving, etc.)
- Server handler: GoFundMe/GlobalGiving/JustGiving/crypto/OECD aggregation
- Client service with circuit breaker
- GivingPanel with tabs (platforms, categories, crypto, institutional)
- Full wiring: API routes, vite dev server, data freshness, panel config
- Happy variant panel config entry

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
koala73 added a commit that referenced this pull request Feb 25, 2026
…#229)

* chore: add project config

* docs: add domain research (stack, features, architecture, pitfalls)

* docs: define v1 requirements

* docs: create roadmap (9 phases)

* docs(01): capture phase context

* docs(state): record phase 1 context session

* docs(01): research phase domain

* docs(01): create phase plan

* fix(01): revise plans based on checker feedback

* feat(01-01): register happy variant in config system and build tooling

- Add 'happy' to allowed stored variants in variant.ts
- Create variants/happy.ts with panels, map layers, and VariantConfig
- Add HAPPY_PANELS, HAPPY_MAP_LAYERS, HAPPY_MOBILE_MAP_LAYERS inline in panels.ts
- Update ternary export chains to select happy config when SITE_VARIANT === 'happy'
- Add happy entry to VARIANT_META in vite.config.ts
- Add dev:happy and build:happy scripts to package.json

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-01): update index.html for variant detection, CSP, and Google Fonts

- Add happy.worldmonitor.app to CSP frame-src directive
- Extend inline script to detect variant from hostname (happy/tech/finance) and localStorage
- Set data-variant attribute on html element before first paint to prevent FOUC
- Add Google Fonts preconnect and Nunito stylesheet links
- Add favicon variant path replacement in htmlVariantPlugin for non-full variants

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-01): create happy variant favicon assets

- Create SVG globe favicon in sage green (#6B8F5E) and warm gold (#C4A35A)
- Generate PNG favicons at all required sizes (16, 32, 180, 192, 512)
- Generate favicon.ico with PNG-in-ICO wrapper
- Create branded OG image (1200x630) with cream background, sage/gold scheme

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(01-01): complete variant registration plan

- Create 01-01-SUMMARY.md documenting variant registration
- Update STATE.md with plan 1 completion, metrics, decisions
- Update ROADMAP.md with phase 01 progress (1/3 plans)
- Mark INFRA-01, INFRA-02, INFRA-03 requirements complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-02): create happy variant CSS theme with warm palette and semantic overrides

- Complete happy-theme.css with light mode (cream/sage), dark mode (navy/warm), and semantic colors
- 179 lines covering all CSS custom properties: backgrounds, text, borders, overlays, map, panels
- Nunito typography and 14px panel border radius for soft rounded aesthetic
- Semantic colors remapped: gold (critical), sage (growth), blue (hope), pink (kindness)
- Dark mode uses warm navy/sage tones, never pure black
- Import added to main.css after panels.css

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-02): add happy variant skeleton shell overrides and theme-color meta

- Inline skeleton styles for happy variant light mode (cream bg, Nunito font, sage dot, warm shimmer)
- Inline skeleton styles for happy variant dark mode (navy bg, warm borders, sage tones)
- Rounded corners (14px) on skeleton panels and map for soft aesthetic
- Softer pill border-radius (8px) in happy variant
- htmlVariantPlugin: theme-color meta updated to #FAFAF5 for happy variant mobile chrome

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(01-02): complete happy theme CSS plan

- SUMMARY.md with execution results and self-check
- STATE.md advanced to plan 2/3, decisions logged
- ROADMAP.md progress updated (2/3 plans complete)
- REQUIREMENTS.md: THEME-01, THEME-03, THEME-04 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-03): create warm basemap styles and wire variant-aware map selection

- Add happy-light.json: sage land, cream background, light blue ocean (forked from CARTO Voyager)
- Add happy-dark.json: dark sage land, navy background, dark navy ocean (forked from CARTO Dark Matter)
- Both styles preserve CARTO CDN source/sprite/glyph URLs for tile loading
- DeckGLMap.ts selects happy basemap URLs when SITE_VARIANT is 'happy'

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-03): style panel chrome, empty states, and loading for happy variant

- Panels get 14px rounded corners with subtle warm shadows
- Panel titles use normal casing (no uppercase) for friendlier feel
- Empty states (.panel-empty, .empty-state) show nature-themed sprout SVG icon
- Loading radar animation softened to 3s rotation with sage-green glow
- Status dots use gentle happy-pulse animation (2.5s ease-in-out)
- Error states use warm gold tones instead of harsh red
- Map controls, tabs, badges all get rounded corners
- Severity badges use warm semantic colors
- Download banner and posture radar adapted to warm theme

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01-03): bridge SITE_VARIANT to data-variant attribute on <html>

The CSS theme overrides rely on [data-variant="happy"] on the document root,
but the inline script only detects variant from hostname/localStorage. This
leaves local dev (VITE_VARIANT=happy) and Vercel deployments without the
attribute set. Two fixes:

1. main.ts sets document.documentElement.dataset.variant from SITE_VARIANT
2. Vite htmlVariantPlugin injects build-time variant fallback into inline script

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01-03): boost CSS specificity so happy theme wins over :root

The happy-theme.css was imported before :root in main.css, and both
[data-variant="happy"] and :root have equal specificity (0-1-0), so
:root variables won after in the cascade. Fix by using :root[data-variant="happy"]
(specificity 0-2-0) which always beats :root (0-1-0).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01): fix CSS cascade — import happy-theme after main.css in main.ts

The root cause: happy-theme.css was @imported inside main.css (line 4),
which meant Vite loaded it BEFORE the :root block (line 9+). With equal
specificity, the later :root variables always won.

Fix: remove @import from main.css, import happy-theme.css directly in
main.ts after main.css. This ensures cascade order is correct — happy
theme variables come last and win. No !important needed.

Also consolidated semantic color variables into the same selector blocks
to reduce redundancy.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01): fix CSS cascade with @layer base and theme toggle for happy variant

- Wrap main.css in @layer base via base-layer.css so happy-theme.css
  (unlayered) always wins the cascade for custom properties
- Remove duplicate <link> stylesheet from index.html (was double-loading)
- Default happy variant to light theme (data-theme="light") so the
  theme toggle works on first click instead of requiring two clicks
- Force build-time variant in inline script — stale localStorage can no
  longer override the deployment variant
- Prioritize VITE_VARIANT env over localStorage in variant.ts so
  variant-specific builds are deterministic

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(01-03): complete map basemap & panel chrome plan — Phase 1 done

- Add 01-03-SUMMARY.md with task commits, deviations, and self-check
- Update STATE.md: Phase 1 complete, advance to ready for Phase 2
- Update ROADMAP.md: mark Phase 1 plans 3/3 complete
- Update REQUIREMENTS.md: mark THEME-02 and THEME-05 complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-01): complete phase execution

* docs(phase-02): research curated content pipeline

* docs(02): create phase plan — curated content pipeline

* feat(02-01): add positive RSS feeds for happy variant

- Add HAPPY_FEEDS record with 8 feeds across 5 categories (positive, science, nature, health, inspiring)
- Update FEEDS export ternary to route happy variant to HAPPY_FEEDS
- Add happy source tiers to SOURCE_TIERS (Tier 2 for main sources, Tier 3 for category feeds)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(02-01): extend GDELT with tone filtering and positive topic queries

- Add tone_filter (field 4) and sort (field 5) to SearchGdeltDocumentsRequest proto
- Regenerate TypeScript client/server types via buf generate
- Handler appends toneFilter to GDELT query string, uses req.sort for sort param
- Add POSITIVE_GDELT_TOPICS array with 5 positive topic queries
- Add fetchPositiveGdeltArticles() with tone>5 and ToneDesc defaults
- Add fetchPositiveTopicIntelligence() and fetchAllPositiveTopicIntelligence() helpers
- Existing fetchGdeltArticles() backward compatible (empty toneFilter/sort = no change)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-01): complete positive feeds & GDELT tone filtering plan

- Create 02-01-SUMMARY.md with execution results
- Update STATE.md: phase 2, plan 1 of 2, decisions, metrics
- Update ROADMAP.md: phase 02 progress (1/2 plans)
- Mark FEED-01 and FEED-03 requirements complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(02-02): add positive content classifier and extend NewsItem type

- Create positive-classifier.ts with 6 content categories (science-health, nature-wildlife, humanity-kindness, innovation-tech, climate-wins, culture-community)
- Source-based pre-mapping for GNN category feeds (fast path)
- Priority-ordered keyword classification for general positive feeds (slow path)
- Add happyCategory optional field to NewsItem interface
- Export HAPPY_CATEGORY_LABELS and HAPPY_CATEGORY_ALL for downstream UI use

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore(02-02): clean up happy variant config and verify feed wiring

- Remove dead FEEDS placeholder from happy.ts (now handled by HAPPY_FEEDS in feeds.ts)
- Remove unused Feed type import
- Verified SOURCE_TIERS has all 8 happy feed entries (Tier 2: GNN/Positive.News/RTBC/Optimist, Tier 3: GNN category feeds)
- Verified FEEDS export routes to HAPPY_FEEDS when SITE_VARIANT=happy
- Verified App.ts loadNews() dynamically iterates FEEDS keys
- Happy variant builds successfully

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-02): complete content category classifier plan

- SUMMARY.md documenting classifier implementation and feed wiring cleanup
- STATE.md updated: Phase 2 complete, 5 total plans done, 56% progress
- ROADMAP.md updated: Phase 02 marked complete (2/2 plans)
- REQUIREMENTS.md: FEED-04 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-03): create gap closure plan for classifier wiring

* feat(02-03): wire classifyNewsItem into happy variant news ingestion

- Import classifyNewsItem from positive-classifier service
- Add classification step in loadNewsCategory() after fetchCategoryFeeds
- Guard with SITE_VARIANT === 'happy' to avoid impact on other variants
- In-place mutation via for..of loop sets happyCategory on every NewsItem

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-03): complete classifier wiring gap closure plan

- Add 02-03-SUMMARY.md documenting classifier wiring completion
- Update STATE.md with plan 3/3 position and decisions
- Update ROADMAP.md with completed plan checkboxes
- Include 02-VERIFICATION.md phase verification document

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-2): complete phase execution

* test(02): complete UAT - 1 passed, 1 blocker diagnosed

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-3): research positive news feed & quality pipeline

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03): create phase plan for positive news feed and quality pipeline

* fix(03): revise plans based on checker feedback

* feat(03-02): add imageUrl to NewsItem and extract images from RSS

- Add optional imageUrl field to NewsItem interface
- Add extractImageUrl() helper to rss.ts with 4-strategy image extraction
  (media:content, media:thumbnail, enclosure, img-in-description)
- Wire image extraction into fetchFeed() for happy variant only

* feat(03-01): add happy variant guards to all App.ts code paths

- Skip DEFCON/PizzInt indicator for happy variant
- Add happy variant link (sun icon) to variant switcher header
- Show 'Good News Map' title for happy variant map section
- Skip LiveNewsPanel, LiveWebcams, TechEvents, ServiceStatus, TechReadiness, MacroSignals, ETFFlows, Stablecoin panels for happy
- Gate live-news first-position logic with happy exclusion
- Only load 'news' data for happy variant (skip markets, predictions, pizzint, fred, oil, spending, intelligence, military layers)
- Only schedule 'news' refresh interval for happy (skip all geopolitical/financial refreshes)
- Add happy-specific search modal with positive placeholder and no military/geopolitical sources

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(03-02): create PositiveNewsFeedPanel with filter bar and card rendering

- New PositiveNewsFeedPanel component extending Panel with:
  - Category filter bar (All + 6 positive categories)
  - Rich card rendering with image, title, source, category badge, time
  - Filter state preserved across data refreshes
  - Proper cleanup in destroy()
- Add CSS styles to happy-theme.css for cards and filter bar
  - Category-specific badge colors using theme variables
  - Scoped under [data-variant="happy"] to avoid affecting other variants

* feat(03-01): return empty channels for happy variant in LiveNewsPanel

- Defense-in-depth: LIVE_CHANNELS returns empty array for happy variant
- Ensures zero Bloomberg/war streams even if panel is somehow instantiated
- Combined with createPanels() guard from Task 1 for belt-and-suspenders safety

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03-02): complete positive news feed panel plan

- Created 03-02-SUMMARY.md with execution results
- Updated STATE.md with position, decisions, and metrics
- Updated ROADMAP.md with phase 03 progress (2/3 plans)
- Marked NEWS-01, NEWS-02 requirements as complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03-01): complete Happy Variant App.ts Integration plan

- SUMMARY.md with execution results and decisions
- STATE.md updated with 03-01 decisions and session info
- ROADMAP.md progress updated (2/3 phase 3 plans)
- NEWS-03 requirement marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(03-03): create sentiment gate service for ML-based filtering

- Exports filterBySentiment() wrapping mlWorker.classifySentiment()
- Default threshold 0.85 with localStorage override for tuning
- Graceful degradation: returns all items if ML unavailable
- Batches titles at 20 items per call (ML_THRESHOLDS.maxTextsPerBatch)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(03-03): wire multi-stage quality pipeline and positive-feed panel into App.ts

- Register 'positive-feed' in HAPPY_PANELS replacing 'live-news'
- Import PositiveNewsFeedPanel, filterBySentiment, fetchAllPositiveTopicIntelligence
- Add positivePanel + happyAllItems class properties
- Create PositiveNewsFeedPanel in createPanels() for happy variant
- Accumulate curated items in loadNewsCategory() for happy variant
- Implement loadHappySupplementaryAndRender() 4-stage pipeline:
  1. Curated feeds render immediately (non-blocking UX)
  2. GDELT positive articles fetched as supplementary
  3. Sentiment-filtered via DistilBERT-SST2 (filterBySentiment)
  4. Merged + sorted by date, re-rendered
- Auto-refresh on REFRESH_INTERVALS.feeds re-runs full pipeline
- ML failure degrades gracefully to curated-only display

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03-03): complete quality pipeline plan - phase 3 done

- Summary: multi-stage positive news pipeline with ML sentiment gate
- STATE.md: phase 3 complete (3/3), 89% progress
- ROADMAP.md: phase 03 marked complete
- REQUIREMENTS.md: FEED-02, FEED-05 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(03): wire positive-feed panel key in panels.ts and add happy map layer/legend config

The executor updated happy.ts but the actual HAPPY_PANELS export comes from
panels.ts — it still had 'live-news' instead of 'positive-feed', so the panel
never rendered. Also adds happyLayers (natural only) and happy legend to Map.ts
to hide military layer toggles and geopolitical legend items.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-3): complete phase execution

* docs(phase-4): research global map & positive events

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(04): create phase plan — global map & positive events

* fix(04): revise plans based on checker feedback

* feat(04-01): add positiveEvents and kindness keys to MapLayers interface and all variant configs

- Add positiveEvents and kindness boolean keys to MapLayers interface
- Update all 10 variant layer configs (8 in panels.ts + 2 in happy.ts)
- Happy variant: positiveEvents=true, kindness=true; all others: false
- Fix variant config files (full, tech, finance) and e2e harnesses for compilation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-01): add happy variant layer toggles and legend in DeckGLMap

- Add happy branch to createLayerToggles with 3 toggles: Positive Events, Acts of Kindness, Natural Events
- Add happy branch to createLegend with 4 items: Positive Event (green), Breakthrough (gold), Act of Kindness (light green), Natural Event (orange)
- Non-happy variants unchanged

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(04-01): complete map layer config & happy variant toggles plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-02): add positive events geocoding pipeline and map layer

- Proto service PositiveEventsService with ListPositiveGeoEvents RPC
- Server-side GDELT GEO fetch with positive topic queries, dedup, classification
- Client-side service calling server RPC + RSS geocoding via inferGeoHubsFromTitle
- DeckGLMap green/gold ScatterplotLayer with pulse animation for significant events
- Tooltip shows event name, category, and report count
- Routes registered in api gateway and vite dev server

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-02): wire positive events loading into App.ts happy variant pipeline

- Import fetchPositiveGeoEvents and geocodePositiveNewsItems
- Load positive events in loadAllData() for happy variant with positiveEvents toggle
- loadPositiveEvents() merges GDELT GEO RPC + geocoded RSS items, deduplicates by name
- loadDataForLayer switch case for toggling positiveEvents layer on/off
- MapContainer.setPositiveEvents() delegates to DeckGLMap

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(04-02): complete positive events geocoding pipeline plan

- SUMMARY.md with task commits, decisions, deviations
- STATE.md updated with position, metrics, decisions
- ROADMAP.md and REQUIREMENTS.md updated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-03): create kindness-data service with baseline generator and curated events

- Add KindnessPoint interface for map visualization data
- Add MAJOR_CITIES constant with ~60 cities worldwide (population-weighted)
- Implement generateBaselineKindness() producing 50-80 synthetic points per cycle
- Implement extractKindnessEvents() for real kindness items from curated news
- Export fetchKindnessData() merging baseline + real events

* feat(04-03): add kindness layer to DeckGLMap and wire into App.ts pipeline

- Add createKindnessLayers() with solid green fill + gentle pulse ring for real events
- Add kindness-layer tooltip showing city name and description
- Add setKindnessData() setter in DeckGLMap and MapContainer
- Wire loadKindnessData() into App.ts loadAllData and loadDataForLayer
- Kindness layer gated by mapLayers.kindness toggle (happy variant only)
- Pulse animation triggers when real kindness events are present

* docs(04-03): complete kindness data pipeline & map layer plan

- Create 04-03-SUMMARY.md documenting kindness layer implementation
- Update STATE.md: phase 04 complete (3/3 plans), advance position
- Update ROADMAP.md: phase 04 marked complete
- Mark KIND-01 and KIND-02 requirements as complete

* docs(phase-4): complete phase execution

* docs(phase-5): research humanity data panels domain

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-humanity-data-panels): create phase plan

* feat(05-01): create humanity counters service with metric definitions and rate calculations

- Define 6 positive global metrics with annual totals from UN/WHO/World Bank/UNESCO
- Calculate per-second rates from annual totals / 31,536,000 seconds
- Absolute-time getCounterValue() avoids drift across tabs/throttling
- Locale-aware formatCounterValue() using Intl.NumberFormat

* feat(05-02): install papaparse and create progress data service

- Install papaparse + @types/papaparse for potential OWID CSV fallback
- Create src/services/progress-data.ts with 4 World Bank indicators
- Export PROGRESS_INDICATORS (life expectancy, literacy, child mortality, poverty)
- Export fetchProgressData() using existing getIndicatorData() RPC
- Null value filtering, year sorting, invertTrend-aware change calculation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(05-01): create CountersPanel component with 60fps animated ticking numbers

- Extend Panel base class with counters-grid of 6 counter cards
- requestAnimationFrame loop updates all values at 60fps
- Absolute-time calculation via getCounterValue() prevents drift
- textContent updates (not innerHTML) avoid layout thrashing
- startTicking() / destroy() lifecycle methods for App.ts integration

* feat(05-02): create ProgressChartsPanel with D3.js area charts

- Extend Panel base class with id 'progress', title 'Human Progress'
- Render 4 stacked D3 area charts (life expectancy, literacy, child mortality, poverty)
- Warm happy-theme colors: sage green, soft blue, warm gold, muted rose
- d3.area() with curveMonotoneX for smooth filled curves
- Header with label, change badge (e.g., "+58.0% since 1960"), and unit
- Hover tooltip with bisector-based nearest data point detection
- ResizeObserver with 200ms debounce for responsive re-rendering
- Clean destroy() lifecycle with observer disconnection

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-01): complete ticking counters service & panel plan

- SUMMARY.md with execution results and self-check
- STATE.md updated to phase 5, plan 1/3
- ROADMAP.md progress updated
- Requirements COUNT-01, COUNT-02, COUNT-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-02): complete progress charts panel plan

- Create 05-02-SUMMARY.md with execution results
- Update STATE.md: plan 2/3, decisions, metrics
- Update ROADMAP.md: phase 05 progress (2/3 plans)
- Mark PROG-01, PROG-02, PROG-03 complete in REQUIREMENTS.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(05-03): wire CountersPanel and ProgressChartsPanel into App.ts lifecycle

- Import CountersPanel, ProgressChartsPanel, and fetchProgressData
- Add class properties for both new panels
- Instantiate both panels in createPanels() gated by SITE_VARIANT === 'happy'
- Add progress data loading task in refreshAll() for happy variant
- Add loadProgressData() private method calling fetchProgressData + setData
- Add destroy() cleanup for both panels (stops rAF loop and ResizeObserver)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(05-03): add counter and progress chart CSS styles to happy-theme.css

- Counters grid: responsive 3-column layout (3/2/1 at 900px/500px breakpoints)
- Counter cards: hover lift, tabular-nums for jitter-free 60fps updates
- Counter icon/value/label/source typography hierarchy
- Progress chart containers: stacked with border dividers
- Chart header with label, badge, and unit display
- D3 SVG axis styling (tick text fill, domain stroke)
- Hover tooltip with absolute positioning and shadow
- Dark mode adjustments for card hover shadow and tooltip shadow
- All selectors scoped under [data-variant='happy']

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-03): complete panel wiring & CSS plan

- Create 05-03-SUMMARY.md with execution results
- Update STATE.md: phase 5 complete (3/3 plans), decisions, metrics
- Update ROADMAP.md: phase 05 progress (3/3 summaries, Complete)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-5): complete phase execution

* docs(06): research phase 6 content spotlight panels

* docs(phase-6): create phase plan

* feat(06-01): add science RSS feeds and BreakthroughsTickerPanel

- Expand HAPPY_FEEDS.science from 1 to 5 feeds (ScienceDaily, Nature News, Live Science, New Scientist)
- Create BreakthroughsTickerPanel extending Panel with horizontal scrolling ticker
- Doubled content rendering for seamless infinite CSS scroll animation
- Sanitized HTML output using escapeHtml/sanitizeUrl

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-01): create HeroSpotlightPanel with photo, map location, and hero card

- Create HeroSpotlightPanel extending Panel for daily hero spotlight
- Render hero card with image, source, title, time, and optional map button
- Conditionally show "Show on map" button only when both lat and lon exist
- Expose onLocationRequest callback for App.ts map integration wiring
- Sanitized HTML output using escapeHtml/sanitizeUrl

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-02): add GoodThingsDigestPanel with progressive AI summarization

- Panel extends Panel base class with id 'digest', title '5 Good Things'
- Renders numbered story cards with titles immediately (progressive rendering)
- Summarizes each story in parallel via generateSummary() with Promise.allSettled
- AbortController cancels in-flight summaries on re-render or destroy
- Graceful fallback to truncated title on summarization failure
- Passes [title, source] to satisfy generateSummary's 2-headline minimum

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(06-02): complete Good Things Digest Panel plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(06-01): complete content spotlight panels plan

- Add 06-01-SUMMARY.md with execution results
- Update STATE.md with position, decisions, metrics
- Update ROADMAP.md and REQUIREMENTS.md progress

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-03): wire Phase 6 panels into App.ts lifecycle and update happy.ts config

- Import and instantiate BreakthroughsTickerPanel, HeroSpotlightPanel, GoodThingsDigestPanel in createPanels()
- Wire heroPanel.onLocationRequest callback to map.setCenter + map.flashLocation
- Distribute data to all three panels after content pipeline in loadHappySupplementaryAndRender()
- Add destroy calls for all three panels in App.destroy()
- Add digest key to DEFAULT_PANELS in happy.ts config

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-03): add CSS styles for ticker, hero card, and digest panels

- Add happy-ticker-scroll keyframe animation for infinite horizontal scroll
- Add breakthroughs ticker styles (wrapper, track, items with hover pause)
- Add hero spotlight card styles (image, body, source, title, location button)
- Add digest list styles (numbered cards, titles, sources, progressive summaries)
- Add dark mode overrides for all three panel types
- All selectors scoped under [data-variant="happy"]

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(06-03): complete panel wiring & CSS plan

- Create 06-03-SUMMARY.md with execution results
- Update STATE.md: phase 6 complete, 18 plans done, 78% progress
- Update ROADMAP.md: phase 06 marked complete (3/3 plans)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-6): complete phase execution

* docs(07): research conservation & energy trackers phase

* docs(07-conservation-energy-trackers): create phase plan

* feat(07-02): add renewable energy data service

- Fetch World Bank EG.ELC.RNEW.ZS indicator (IEA-sourced) for global + 7 regions
- Return global percentage, historical time-series, and regional breakdown
- Graceful degradation: individual region failures skipped, complete failure returns zeroed data
- Follow proven progress-data.ts pattern for getIndicatorData() RPC usage

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(07-01): add conservation wins dataset and data service

- Create conservation-wins.json with 10 species recovery stories and population timelines
- Create conservation-data.ts with SpeciesRecovery interface and fetchConservationWins() loader
- Species data sourced from USFWS, IUCN, NOAA, WWF, and other published reports

* feat(07-02): add RenewableEnergyPanel with D3 arc gauge and regional breakdown

- Animated D3 arc gauge showing global renewable electricity % with 1.5s easeCubicOut
- Historical trend sparkline using d3.area() + curveMonotoneX below gauge
- Regional breakdown with horizontal bars sorted by percentage descending
- All colors use getCSSColor() for theme-aware rendering
- Empty state handling when no data available

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(07-01): add SpeciesComebackPanel with D3 sparklines and species cards

- Create SpeciesComebackPanel extending Panel base class
- Render species cards with photo (lazy loading + error fallback), info badges, D3 sparkline, and summary
- D3 sparklines use area + line with curveMonotoneX and viewBox for responsive sizing
- Recovery status badges (recovered/recovering/stabilized) and IUCN category badges
- Population values formatted with Intl.NumberFormat for readability

* docs(07-02): complete renewable energy panel plan

- SUMMARY.md with task commits, decisions, self-check
- STATE.md updated to phase 7 plan 2, 83% progress
- ROADMAP.md phase 07 progress updated
- REQUIREMENTS.md: ENERGY-01, ENERGY-02, ENERGY-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(07-01): complete species comeback panel plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(07-03): wire species and renewable panels into App.ts lifecycle

- Add imports for SpeciesComebackPanel, RenewableEnergyPanel, and data services
- Add class properties for speciesPanel and renewablePanel
- Instantiate both panels in createPanels() gated by SITE_VARIANT === 'happy'
- Add loadSpeciesData() and loadRenewableData() tasks in refreshAll()
- Add destroy cleanup for both panels before map cleanup
- Add species and renewable entries to happy.ts DEFAULT_PANELS config

* feat(07-03): add CSS styles for species cards and renewable energy gauge

- Species card grid layout with 2-column responsive grid
- Photo, info, badges (recovered/recovering/stabilized/IUCN), sparkline, summary styles
- Renewable energy gauge section, historical sparkline, and regional bar chart styles
- Dark mode overrides for species card hover shadow and IUCN badge background
- All styles scoped with [data-variant='happy'] using existing CSS variables

* docs(07-03): complete panel wiring & CSS plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): add missing panel entries and RSS proxy for dev mode

HAPPY_PANELS in panels.ts was missing digest, species, and renewable
entries — panels were constructed but never appended to the grid because
the panelOrder loop only iterated the 6 original keys.

Also adds RSS proxy middleware for Vite dev server, fixes sebuf route
regex to match hyphenated domains (positive-events), and adds happy
feed domains to the rss-proxy allowlist.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: progress data lookup, ticker speed, ultrawide layout gap

1. Progress/renewable data: World Bank API returns countryiso3code "WLD"
   for world aggregate, but services were looking up by request code "1W".
   Changed lookups to use "WLD".

2. Breakthroughs ticker: slowed animation from 30s to 60s duration.

3. Ultrawide layout (>2000px): replaced float-based layout with CSS grid.
   Map stays in left column (60%), panels grid in right column (40%).
   Eliminates dead space under the map where panels used to wrap below.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: UI polish — counter overflow, ticker speed, monitors panel, filter tabs

- Counter values: responsive font-size with clamp(), overflow protection,
  tighter card padding to prevent large numbers from overflowing
- Breakthroughs ticker: slowed from 60s to 120s animation duration
- My Monitors panel: gate monitors from panel order in happy variant
  (was unconditionally pushed into panelOrder regardless of variant)
- Filter tabs: smaller padding/font, flex-shrink:0, fade mask on right
  edge to hint at scrollable overflow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): exclude APT groups layer from happy variant map

The APT groups layer (cyber threat actors like Fancy Bear, Cozy Bear)
was only excluded for the tech variant. Now also excluded for happy,
since cyber threat data has no place on a Good News Map.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(happy-map): labeled markers, remove fake baseline, fix APT leak

- Positive events now show category emoji + location name as colored
  text labels (TextLayer) instead of bare dots. Labels filter by zoom
  level to avoid clutter at global view.
- Removed synthetic kindness baseline (50-80 fake "Volunteers at work"
  dots in random cities). Only real kindness events from news remain.
- Kindness events also get labeled dots with headlines.
- Improved tooltips with proper category names and source counts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy-map): disable earthquakes, fix GDELT query syntax

- Disable natural events layer (earthquakes) for happy variant —
  not positive news
- Fix GDELT GEO positive queries: OR terms require parentheses
  per GDELT API syntax, added third query for charity/volunteer news
- Updated both desktop and mobile happy map layer configs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): ultrawide grid overflow, panel text polish

Ultrawide: set min-height:0 on map/panels grid children so they
respect 1fr row constraint and scroll independently instead of
pushing content below the viewport.

Panel CSS: softer word-break on counters, line-clamp on digest
and species summaries, ticker title max-width, consistent
text-dim color instead of opacity hacks.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(08-map-data-overlays): research phase domain

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(08-map-data-overlays): create phase plan

* Add Global Giving Activity Index with multi-platform aggregation (#255)

* feat(08-01): add static data for happiness scores, renewable installations, and recovery zones

- Create world-happiness.json with 152 country scores from WHR 2025
- Create renewable-installations.json with 92 global entries (solar/wind/hydro/geothermal)
- Extend conservation-wins.json with recoveryZone lat/lon for all 10 species

* feat(08-01): add service loaders, extend MapLayers with happiness/species/energy keys

- Create happiness-data.ts with fetchHappinessScores() returning Map<ISO2, score>
- Create renewable-installations.ts with fetchRenewableInstallations() returning typed array
- Extend SpeciesRecovery interface with optional recoveryZone field
- Add happiness, speciesRecovery, renewableInstallations to MapLayers interface
- Update all 8 variant MapLayers configs (happiness=true in happy, false elsewhere)
- Update e2e harness files with new layer keys

* docs(08-01): complete data foundation plan summary and state updates

- Create 08-01-SUMMARY.md with execution results
- Update STATE.md to phase 8, plan 1/2
- Update ROADMAP.md progress for phase 08
- Mark requirements MAP-03, MAP-04, MAP-05 complete

* feat(08-02): add happiness choropleth, species recovery, and renewable installation overlay layers

- Add three Deck.gl layer creation methods with color-coded rendering
- Add public data setters for happiness scores, species recovery zones, and renewable installations
- Wire layers into buildLayers() gated by MapLayers keys
- Add tooltip cases for all three new layer types
- Extend happy variant layer toggles (World Happiness, Species Recovery, Clean Energy)
- Extend happy variant legend with choropleth, species, and renewable entries
- Cache country GeoJSON reference in loadCountryBoundaries() for choropleth reuse

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(08-02): wire MapContainer delegation and App.ts data loading for map overlays

- Add MapContainer delegation methods for happiness, species recovery, and renewable installations
- Add happiness scores and renewable installations map data loading in App.ts refreshAll()
- Chain species recovery zone data to map from existing loadSpeciesData()
- All three overlay datasets flow from App.ts through MapContainer to DeckGLMap

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(08-02): complete map overlay layers plan

- Create 08-02-SUMMARY.md with execution results
- Update STATE.md: phase 8 complete (2/2 plans), 22 total plans, decisions logged
- Update ROADMAP.md: phase 08 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-8): complete phase execution

* docs(roadmap): add Phase 7.1 gap closure for renewable energy installation & coal data

Addresses Phase 7 verification gaps (ENERGY-01, ENERGY-03): renewable panel
lacks solar/wind installation growth and coal plant closure visualizations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(7.1): research renewable energy installation & coal retirement data

* docs(71): create phase plans for renewable energy installation & coal retirement data

* feat(71-01): add GetEnergyCapacity RPC proto and server handler

- Create get_energy_capacity.proto with request/response messages
- Add GetEnergyCapacity RPC to EconomicService in service.proto
- Implement server handler with EIA capability API integration
- Coal code fallback (COL -> BIT/SUB/LIG/RC) for sub-type support
- Redis cache with 24h TTL for annual capacity data
- Register handler in economic service handler

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(71-01): add client-side fetchEnergyCapacity with circuit breaker

- Add GetEnergyCapacityResponse import and capacityBreaker to economic service
- Export fetchEnergyCapacityRpc() with energyEia feature gating
- Add CapacitySeries/CapacityDataPoint types to renewable-energy-data.ts
- Export fetchEnergyCapacity() that transforms proto types to domain types

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(71-01): complete EIA energy capacity data pipeline plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(71-02): add setCapacityData() with D3 stacked area chart to RenewableEnergyPanel

- setCapacityData() renders D3 stacked area (solar yellow + wind blue) with coal decline (red)
- Chart labeled 'US Installed Capacity (EIA)' with compact inline legend
- Appends below existing gauge/sparkline/regions without replacing content
- CSS styles for capacity section, header, legend in happy-theme.css

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(71-02): wire EIA capacity data loading in App.ts loadRenewableData()

- Import fetchEnergyCapacity from renewable-energy-data service
- Call fetchEnergyCapacity() after World Bank gauge data, pass to setCapacityData()
- Wrapped in try/catch so EIA failure does not break existing gauge

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(71-02): complete EIA capacity visualization plan

- SUMMARY.md documenting D3 stacked area chart implementation
- STATE.md updated: Phase 7.1 complete (2/2 plans), progress 100%
- ROADMAP.md updated with plan progress

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-71): complete phase execution

* docs(phase-09): research sharing, TV mode & polish domain

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09): create phase plan for sharing, TV mode & polish

* docs(phase-09): plan Sharing, TV Mode & Polish

3 plans in 2 waves covering share cards (Canvas 2D renderer),
TV/ambient mode (fullscreen panel cycling + CSS particles),
and celebration animations (canvas-confetti milestones).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-01): create Canvas 2D renderer for happy share cards

- 1080x1080 branded PNG with warm gradient per category
- Category badge, headline word-wrap, source, date, HappyMonitor branding
- shareHappyCard() with Web Share API -> clipboard -> download fallback
- wrapText() helper for Canvas 2D manual line breaking

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-02): create TvModeController and TV mode CSS

- TvModeController class manages fullscreen, panel cycling with configurable 30s-2min interval
- CSS [data-tv-mode] attribute drives larger typography, hidden interactive elements, smooth panel transitions
- Ambient floating particles (CSS-only, opacity 0.04) with reduced motion support
- TV exit button appears on hover, hidden by default outside TV mode

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-02): wire TV mode into App.ts header and lifecycle

- TV mode button with monitor icon in happy variant header
- TV exit button at page level, visible on hover in TV mode
- Shift+T keyboard shortcut toggles TV mode
- TvModeController instantiated lazily on first toggle
- Proper cleanup in destroy() method

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-01): add share button to positive news cards with handler

- Share button (SVG upload icon) appears on card hover, top-right
- Delegated click handler prevents link navigation, calls shareHappyCard
- Brief .shared visual feedback (green, scale) for 1.5s on click
- Dark mode support for share button background
- Fix: tv-mode.ts panelKeys index guard (pre-existing build blocker)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09-02): complete TV Mode plan

- SUMMARY.md with task commits, deviations, decisions
- STATE.md updated: position, metrics, decisions, session
- ROADMAP.md updated: phase 09 progress (2/3 plans)
- REQUIREMENTS.md updated: TV-01, TV-02, TV-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09-01): complete positive news share cards plan

- SUMMARY.md with Canvas 2D renderer and share button accomplishments
- STATE.md updated with decisions and session continuity
- ROADMAP.md progress updated (2/3 plans in phase 09)
- REQUIREMENTS.md: SHARE-01, SHARE-02, SHARE-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-03): add celebration service with canvas-confetti

- Install canvas-confetti + @types/canvas-confetti
- Create src/services/celebration.ts with warm nature-inspired palette
- Session-level dedup (Set<string>) prevents repeat celebrations
- Respects prefers-reduced-motion media query
- Milestone detection for species recovery + renewable energy records
- Moderate particle counts (40-80) for "warm, not birthday party" feel

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-03): wire milestone celebrations into App.ts data pipelines

- Import checkMilestones in App.ts
- Call checkMilestones after species data loads with recovery statuses
- Call checkMilestones after renewable energy data loads with global percentage
- All celebration calls gated behind SITE_VARIANT === 'happy'
- Placed after panel setData() so data is visible before confetti fires

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09-03): complete celebration animations plan

- 09-03-SUMMARY.md with execution results
- STATE.md updated: phase 09 complete, 26 plans total, 100% progress
- ROADMAP.md updated with phase 09 completion
- REQUIREMENTS.md: THEME-06 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-09): complete phase execution

* fix(happy): remove natural events layer from happy variant

Natural events (earthquakes, volcanoes, storms) were leaking into the
happy variant through stale localStorage and the layer toggle UI. Force
all non-happy layers off regardless of localStorage state, and remove
the natural events toggle from both DeckGL and SVG map layer configs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-7.1): complete phase execution — mark all phases done

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(v1): complete milestone audit — 49/49 requirements satisfied

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): close audit tech debt — map layer defaults, theme-color meta

- Enable speciesRecovery and renewableInstallations layers by default
  in HAPPY_MAP_LAYERS (panels.ts + happy.ts) so MAP-04/MAP-05 are
  visible on first load
- Use happy-specific theme-color meta values (#FAFAF5 light, #1A2332
  dark) in setTheme() and applyStoredTheme() instead of generic colors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add checkpoint for giving integration handoff

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(giving): integrate Global Giving Activity Index from PR #254

Cherry-pick the giving feature that was left behind when PR #255
batch-merged without including #254's proto/handler/panel files.

Adds:
- Proto definitions (GivingService, GivingSummary, PlatformGiving, etc.)
- Server handler: GoFundMe/GlobalGiving/JustGiving/crypto/OECD aggregation
- Client service with circuit breaker
- GivingPanel with tabs (platforms, categories, crypto, institutional)
- Full wiring: API routes, vite dev server, data freshness, panel config
- Happy variant panel config entry

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(giving): move panel init and data fetch out of full-variant-only blocks

The GivingPanel was instantiated inside `if (SITE_VARIANT === 'full')` and
the data fetch was inside `loadIntelligenceSignals()` (also full-only).
Moved both to variant-agnostic scope so the panel works on happy variant.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(giving): bypass debounced setContent so tab buttons are clickable

Panel.setContent() is debounced (150ms), so event listeners attached
immediately after it were binding to DOM elements that got replaced by
the deferred innerHTML write. Write directly to this.content.innerHTML
like other interactive panels do.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: remove .planning/ from repo and gitignore it

Planning files served their purpose during happy monitor development.
They remain on disk for reference but no longer tracked.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: merge new panels into saved panelSettings so they aren't hidden

When panelSettings is loaded from localStorage, any panels added since
the user last saved settings would be missing from the config. The
applyPanelSettings loop wouldn't touch them, but without a config entry
they also wouldn't appear in the settings toggle UI correctly.

Now merges DEFAULT_PANELS entries into loaded settings for any keys
that don't exist yet, so new panels are visible by default.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: giving data baselines, theme toggle persistence, and client caching

- Replace broken GoFundMe (301→404) and GlobalGiving (401) API calls
  with hardcoded baselines from published annual reports. Activity index
  rises from 42 to 56 as all 3 platforms now report non-zero volumes.
- Fix happy variant theme toggle not persisting across page reloads:
  applyStoredTheme() couldn't distinguish "no preference" from "user
  chose dark" — both returned DEFAULT_THEME. Now checks raw localStorage.
- Fix inline script in index.html not setting data-theme="dark" for
  happy variant, causing CSS :root[data-variant="happy"] (light) to
  win over :root[data-variant="happy"][data-theme="dark"].
- Add client-side caching to giving service: persistCache on circuit
  breaker, 30min in-memory TTL, and request deduplication.
- Add Playwright E2E tests for theme toggle (8 tests, all passing).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* perf: add persistent cache to all 29 circuit breakers across 19 services

Enable persistCache and set appropriate cacheTtlMs on every circuit
breaker that lacked them. Data survives page reloads via IndexedDB
fallback and reduces redundant API calls on navigation.

TTLs matched to data freshness: 5min for real-time feeds (weather,
earthquakes, wildfires, aviation), 10min for event data (conflict,
cyber, unrest, climate, research), 15-30min for slow-moving data
(economic indicators, energy capacity, population exposure).

Market quotes breaker intentionally left at cacheTtlMs: 0 (real-time).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: expand map labels progressively as user zooms in

Labels now show more text at higher zoom levels instead of always
truncating at 30 chars. Zoom <3: 20 chars, <5: 35, <7: 60, 7+: full.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: keep 30-char baseline for map labels, expand to full text at zoom 6+

Previous change was too aggressive with low-zoom truncation (20 chars).
Now keeps original 30-char limit at global view, progressively expands
to 50/80/200 chars as user zooms in. Also scales font size with zoom.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Revert "fix: keep 30-char baseline for map labels, expand to full text at zoom 6+"

This reverts commit b10456851fb0e34cd3e999955543498956a0b18a.

* Revert "feat: expand map labels progressively as user zooms in"

This reverts commit a9cd2493740b94617efacae586ddffe2896615bc.

* perf: stale-while-revalidate for instant page load

Circuit breaker now returns stale cached data immediately and refreshes
in the background, instead of blocking on API calls when cache exceeds
TTL. Also persists happyAllItems to IndexedDB so Hero, Digest, and
Breakthroughs panels render instantly from cache on page reload.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: address PR #229 review — 4 issues from koala

1. P1: Fix duplicate event listeners in PositiveNewsFeedPanel.renderCards()
   — remove listener before re-adding to prevent stacking on re-renders

2. P1: Fix TV mode cycling hidden panels causing blank screen
   — filter out user-disabled panels from cycle list, rebuild keys on toggle

3. P2: Fix positive classifier false positives for short keywords
   — "ai" and "art" now use space-delimited matching to avoid substring hits
     (e.g. "aid", "rain", "said", "start", "part")

4. P3: Fix CSP blocking Google Fonts stylesheet for Nunito
   — add https://fonts.googleapis.com to style-src directive

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* refactor: decompose App.ts into focused modules under src/app/

Break the 4,597-line monolithic App class into 7 focused modules plus a
~460-line thin orchestrator. Each module implements the AppModule lifecycle
(init/destroy) and communicates via a shared AppContext state object with
narrow callback interfaces — no circular dependencies.

Modules extracted:
- app-context.ts: shared state types (AppContext, AppModule, etc.)
- desktop-updater.ts: desktop version checking + update badge
- country-intel.ts: country briefs, timeline, CII signals
- search-manager.ts: search modal, result routing, index updates
- refresh-scheduler.ts: periodic data refresh with jitter/backoff
- panel-layout.ts: panel creation, grid layout, drag-drop
- data-loader.ts: all 36 data loading methods
- event-handlers.ts: DOM events, shortcuts, idle detection, URL sync

Verified: tsc --noEmit (zero errors), all 3 variant builds pass
(full, tech, finance), runtime smoke test confirms no regressions.

* fix: resolve test failures and missing CSS token from PR review

1. flushStaleRefreshes test now reads from refresh-scheduler.ts (moved
   during App.ts modularization)
2. e2e runtime tests updated to import DesktopUpdater and DataLoaderManager
   instead of App.prototype for resolveUpdateDownloadUrl and loadMarkets
3. Add --semantic-positive CSS variable to main.css and happy-theme.css
   (both light and dark variants)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: hide happy variant button from other variants

The button is only visible when already on the happy variant. This
allows merging the modularized App.ts without exposing the unfinished
happy layout to users — layout work continues in a follow-up PR.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Elie Habib <elie.habib@gmail.com>
@koala73 koala73 deleted the claude/review-pr-zPvM9 branch February 25, 2026 07:59
andreteow pushed a commit to andreteow/worldmonitor-a47 that referenced this pull request Feb 25, 2026
…koala73#229)

* chore: add project config

* docs: add domain research (stack, features, architecture, pitfalls)

* docs: define v1 requirements

* docs: create roadmap (9 phases)

* docs(01): capture phase context

* docs(state): record phase 1 context session

* docs(01): research phase domain

* docs(01): create phase plan

* fix(01): revise plans based on checker feedback

* feat(01-01): register happy variant in config system and build tooling

- Add 'happy' to allowed stored variants in variant.ts
- Create variants/happy.ts with panels, map layers, and VariantConfig
- Add HAPPY_PANELS, HAPPY_MAP_LAYERS, HAPPY_MOBILE_MAP_LAYERS inline in panels.ts
- Update ternary export chains to select happy config when SITE_VARIANT === 'happy'
- Add happy entry to VARIANT_META in vite.config.ts
- Add dev:happy and build:happy scripts to package.json

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-01): update index.html for variant detection, CSP, and Google Fonts

- Add happy.worldmonitor.app to CSP frame-src directive
- Extend inline script to detect variant from hostname (happy/tech/finance) and localStorage
- Set data-variant attribute on html element before first paint to prevent FOUC
- Add Google Fonts preconnect and Nunito stylesheet links
- Add favicon variant path replacement in htmlVariantPlugin for non-full variants

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-01): create happy variant favicon assets

- Create SVG globe favicon in sage green (#6B8F5E) and warm gold (#C4A35A)
- Generate PNG favicons at all required sizes (16, 32, 180, 192, 512)
- Generate favicon.ico with PNG-in-ICO wrapper
- Create branded OG image (1200x630) with cream background, sage/gold scheme

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(01-01): complete variant registration plan

- Create 01-01-SUMMARY.md documenting variant registration
- Update STATE.md with plan 1 completion, metrics, decisions
- Update ROADMAP.md with phase 01 progress (1/3 plans)
- Mark INFRA-01, INFRA-02, INFRA-03 requirements complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-02): create happy variant CSS theme with warm palette and semantic overrides

- Complete happy-theme.css with light mode (cream/sage), dark mode (navy/warm), and semantic colors
- 179 lines covering all CSS custom properties: backgrounds, text, borders, overlays, map, panels
- Nunito typography and 14px panel border radius for soft rounded aesthetic
- Semantic colors remapped: gold (critical), sage (growth), blue (hope), pink (kindness)
- Dark mode uses warm navy/sage tones, never pure black
- Import added to main.css after panels.css

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-02): add happy variant skeleton shell overrides and theme-color meta

- Inline skeleton styles for happy variant light mode (cream bg, Nunito font, sage dot, warm shimmer)
- Inline skeleton styles for happy variant dark mode (navy bg, warm borders, sage tones)
- Rounded corners (14px) on skeleton panels and map for soft aesthetic
- Softer pill border-radius (8px) in happy variant
- htmlVariantPlugin: theme-color meta updated to #FAFAF5 for happy variant mobile chrome

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(01-02): complete happy theme CSS plan

- SUMMARY.md with execution results and self-check
- STATE.md advanced to plan 2/3, decisions logged
- ROADMAP.md progress updated (2/3 plans complete)
- REQUIREMENTS.md: THEME-01, THEME-03, THEME-04 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-03): create warm basemap styles and wire variant-aware map selection

- Add happy-light.json: sage land, cream background, light blue ocean (forked from CARTO Voyager)
- Add happy-dark.json: dark sage land, navy background, dark navy ocean (forked from CARTO Dark Matter)
- Both styles preserve CARTO CDN source/sprite/glyph URLs for tile loading
- DeckGLMap.ts selects happy basemap URLs when SITE_VARIANT is 'happy'

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(01-03): style panel chrome, empty states, and loading for happy variant

- Panels get 14px rounded corners with subtle warm shadows
- Panel titles use normal casing (no uppercase) for friendlier feel
- Empty states (.panel-empty, .empty-state) show nature-themed sprout SVG icon
- Loading radar animation softened to 3s rotation with sage-green glow
- Status dots use gentle happy-pulse animation (2.5s ease-in-out)
- Error states use warm gold tones instead of harsh red
- Map controls, tabs, badges all get rounded corners
- Severity badges use warm semantic colors
- Download banner and posture radar adapted to warm theme

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01-03): bridge SITE_VARIANT to data-variant attribute on <html>

The CSS theme overrides rely on [data-variant="happy"] on the document root,
but the inline script only detects variant from hostname/localStorage. This
leaves local dev (VITE_VARIANT=happy) and Vercel deployments without the
attribute set. Two fixes:

1. main.ts sets document.documentElement.dataset.variant from SITE_VARIANT
2. Vite htmlVariantPlugin injects build-time variant fallback into inline script

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01-03): boost CSS specificity so happy theme wins over :root

The happy-theme.css was imported before :root in main.css, and both
[data-variant="happy"] and :root have equal specificity (0-1-0), so
:root variables won after in the cascade. Fix by using :root[data-variant="happy"]
(specificity 0-2-0) which always beats :root (0-1-0).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01): fix CSS cascade — import happy-theme after main.css in main.ts

The root cause: happy-theme.css was @imported inside main.css (line 4),
which meant Vite loaded it BEFORE the :root block (line 9+). With equal
specificity, the later :root variables always won.

Fix: remove @import from main.css, import happy-theme.css directly in
main.ts after main.css. This ensures cascade order is correct — happy
theme variables come last and win. No !important needed.

Also consolidated semantic color variables into the same selector blocks
to reduce redundancy.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(01): fix CSS cascade with @layer base and theme toggle for happy variant

- Wrap main.css in @layer base via base-layer.css so happy-theme.css
  (unlayered) always wins the cascade for custom properties
- Remove duplicate <link> stylesheet from index.html (was double-loading)
- Default happy variant to light theme (data-theme="light") so the
  theme toggle works on first click instead of requiring two clicks
- Force build-time variant in inline script — stale localStorage can no
  longer override the deployment variant
- Prioritize VITE_VARIANT env over localStorage in variant.ts so
  variant-specific builds are deterministic

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(01-03): complete map basemap & panel chrome plan — Phase 1 done

- Add 01-03-SUMMARY.md with task commits, deviations, and self-check
- Update STATE.md: Phase 1 complete, advance to ready for Phase 2
- Update ROADMAP.md: mark Phase 1 plans 3/3 complete
- Update REQUIREMENTS.md: mark THEME-02 and THEME-05 complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-01): complete phase execution

* docs(phase-02): research curated content pipeline

* docs(02): create phase plan — curated content pipeline

* feat(02-01): add positive RSS feeds for happy variant

- Add HAPPY_FEEDS record with 8 feeds across 5 categories (positive, science, nature, health, inspiring)
- Update FEEDS export ternary to route happy variant to HAPPY_FEEDS
- Add happy source tiers to SOURCE_TIERS (Tier 2 for main sources, Tier 3 for category feeds)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(02-01): extend GDELT with tone filtering and positive topic queries

- Add tone_filter (field 4) and sort (field 5) to SearchGdeltDocumentsRequest proto
- Regenerate TypeScript client/server types via buf generate
- Handler appends toneFilter to GDELT query string, uses req.sort for sort param
- Add POSITIVE_GDELT_TOPICS array with 5 positive topic queries
- Add fetchPositiveGdeltArticles() with tone>5 and ToneDesc defaults
- Add fetchPositiveTopicIntelligence() and fetchAllPositiveTopicIntelligence() helpers
- Existing fetchGdeltArticles() backward compatible (empty toneFilter/sort = no change)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-01): complete positive feeds & GDELT tone filtering plan

- Create 02-01-SUMMARY.md with execution results
- Update STATE.md: phase 2, plan 1 of 2, decisions, metrics
- Update ROADMAP.md: phase 02 progress (1/2 plans)
- Mark FEED-01 and FEED-03 requirements complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(02-02): add positive content classifier and extend NewsItem type

- Create positive-classifier.ts with 6 content categories (science-health, nature-wildlife, humanity-kindness, innovation-tech, climate-wins, culture-community)
- Source-based pre-mapping for GNN category feeds (fast path)
- Priority-ordered keyword classification for general positive feeds (slow path)
- Add happyCategory optional field to NewsItem interface
- Export HAPPY_CATEGORY_LABELS and HAPPY_CATEGORY_ALL for downstream UI use

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore(02-02): clean up happy variant config and verify feed wiring

- Remove dead FEEDS placeholder from happy.ts (now handled by HAPPY_FEEDS in feeds.ts)
- Remove unused Feed type import
- Verified SOURCE_TIERS has all 8 happy feed entries (Tier 2: GNN/Positive.News/RTBC/Optimist, Tier 3: GNN category feeds)
- Verified FEEDS export routes to HAPPY_FEEDS when SITE_VARIANT=happy
- Verified App.ts loadNews() dynamically iterates FEEDS keys
- Happy variant builds successfully

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-02): complete content category classifier plan

- SUMMARY.md documenting classifier implementation and feed wiring cleanup
- STATE.md updated: Phase 2 complete, 5 total plans done, 56% progress
- ROADMAP.md updated: Phase 02 marked complete (2/2 plans)
- REQUIREMENTS.md: FEED-04 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-03): create gap closure plan for classifier wiring

* feat(02-03): wire classifyNewsItem into happy variant news ingestion

- Import classifyNewsItem from positive-classifier service
- Add classification step in loadNewsCategory() after fetchCategoryFeeds
- Guard with SITE_VARIANT === 'happy' to avoid impact on other variants
- In-place mutation via for..of loop sets happyCategory on every NewsItem

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(02-03): complete classifier wiring gap closure plan

- Add 02-03-SUMMARY.md documenting classifier wiring completion
- Update STATE.md with plan 3/3 position and decisions
- Update ROADMAP.md with completed plan checkboxes
- Include 02-VERIFICATION.md phase verification document

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-2): complete phase execution

* test(02): complete UAT - 1 passed, 1 blocker diagnosed

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-3): research positive news feed & quality pipeline

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03): create phase plan for positive news feed and quality pipeline

* fix(03): revise plans based on checker feedback

* feat(03-02): add imageUrl to NewsItem and extract images from RSS

- Add optional imageUrl field to NewsItem interface
- Add extractImageUrl() helper to rss.ts with 4-strategy image extraction
  (media:content, media:thumbnail, enclosure, img-in-description)
- Wire image extraction into fetchFeed() for happy variant only

* feat(03-01): add happy variant guards to all App.ts code paths

- Skip DEFCON/PizzInt indicator for happy variant
- Add happy variant link (sun icon) to variant switcher header
- Show 'Good News Map' title for happy variant map section
- Skip LiveNewsPanel, LiveWebcams, TechEvents, ServiceStatus, TechReadiness, MacroSignals, ETFFlows, Stablecoin panels for happy
- Gate live-news first-position logic with happy exclusion
- Only load 'news' data for happy variant (skip markets, predictions, pizzint, fred, oil, spending, intelligence, military layers)
- Only schedule 'news' refresh interval for happy (skip all geopolitical/financial refreshes)
- Add happy-specific search modal with positive placeholder and no military/geopolitical sources

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(03-02): create PositiveNewsFeedPanel with filter bar and card rendering

- New PositiveNewsFeedPanel component extending Panel with:
  - Category filter bar (All + 6 positive categories)
  - Rich card rendering with image, title, source, category badge, time
  - Filter state preserved across data refreshes
  - Proper cleanup in destroy()
- Add CSS styles to happy-theme.css for cards and filter bar
  - Category-specific badge colors using theme variables
  - Scoped under [data-variant="happy"] to avoid affecting other variants

* feat(03-01): return empty channels for happy variant in LiveNewsPanel

- Defense-in-depth: LIVE_CHANNELS returns empty array for happy variant
- Ensures zero Bloomberg/war streams even if panel is somehow instantiated
- Combined with createPanels() guard from Task 1 for belt-and-suspenders safety

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03-02): complete positive news feed panel plan

- Created 03-02-SUMMARY.md with execution results
- Updated STATE.md with position, decisions, and metrics
- Updated ROADMAP.md with phase 03 progress (2/3 plans)
- Marked NEWS-01, NEWS-02 requirements as complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03-01): complete Happy Variant App.ts Integration plan

- SUMMARY.md with execution results and decisions
- STATE.md updated with 03-01 decisions and session info
- ROADMAP.md progress updated (2/3 phase 3 plans)
- NEWS-03 requirement marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(03-03): create sentiment gate service for ML-based filtering

- Exports filterBySentiment() wrapping mlWorker.classifySentiment()
- Default threshold 0.85 with localStorage override for tuning
- Graceful degradation: returns all items if ML unavailable
- Batches titles at 20 items per call (ML_THRESHOLDS.maxTextsPerBatch)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(03-03): wire multi-stage quality pipeline and positive-feed panel into App.ts

- Register 'positive-feed' in HAPPY_PANELS replacing 'live-news'
- Import PositiveNewsFeedPanel, filterBySentiment, fetchAllPositiveTopicIntelligence
- Add positivePanel + happyAllItems class properties
- Create PositiveNewsFeedPanel in createPanels() for happy variant
- Accumulate curated items in loadNewsCategory() for happy variant
- Implement loadHappySupplementaryAndRender() 4-stage pipeline:
  1. Curated feeds render immediately (non-blocking UX)
  2. GDELT positive articles fetched as supplementary
  3. Sentiment-filtered via DistilBERT-SST2 (filterBySentiment)
  4. Merged + sorted by date, re-rendered
- Auto-refresh on REFRESH_INTERVALS.feeds re-runs full pipeline
- ML failure degrades gracefully to curated-only display

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(03-03): complete quality pipeline plan - phase 3 done

- Summary: multi-stage positive news pipeline with ML sentiment gate
- STATE.md: phase 3 complete (3/3), 89% progress
- ROADMAP.md: phase 03 marked complete
- REQUIREMENTS.md: FEED-02, FEED-05 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(03): wire positive-feed panel key in panels.ts and add happy map layer/legend config

The executor updated happy.ts but the actual HAPPY_PANELS export comes from
panels.ts — it still had 'live-news' instead of 'positive-feed', so the panel
never rendered. Also adds happyLayers (natural only) and happy legend to Map.ts
to hide military layer toggles and geopolitical legend items.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-3): complete phase execution

* docs(phase-4): research global map & positive events

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(04): create phase plan — global map & positive events

* fix(04): revise plans based on checker feedback

* feat(04-01): add positiveEvents and kindness keys to MapLayers interface and all variant configs

- Add positiveEvents and kindness boolean keys to MapLayers interface
- Update all 10 variant layer configs (8 in panels.ts + 2 in happy.ts)
- Happy variant: positiveEvents=true, kindness=true; all others: false
- Fix variant config files (full, tech, finance) and e2e harnesses for compilation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-01): add happy variant layer toggles and legend in DeckGLMap

- Add happy branch to createLayerToggles with 3 toggles: Positive Events, Acts of Kindness, Natural Events
- Add happy branch to createLegend with 4 items: Positive Event (green), Breakthrough (gold), Act of Kindness (light green), Natural Event (orange)
- Non-happy variants unchanged

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(04-01): complete map layer config & happy variant toggles plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-02): add positive events geocoding pipeline and map layer

- Proto service PositiveEventsService with ListPositiveGeoEvents RPC
- Server-side GDELT GEO fetch with positive topic queries, dedup, classification
- Client-side service calling server RPC + RSS geocoding via inferGeoHubsFromTitle
- DeckGLMap green/gold ScatterplotLayer with pulse animation for significant events
- Tooltip shows event name, category, and report count
- Routes registered in api gateway and vite dev server

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-02): wire positive events loading into App.ts happy variant pipeline

- Import fetchPositiveGeoEvents and geocodePositiveNewsItems
- Load positive events in loadAllData() for happy variant with positiveEvents toggle
- loadPositiveEvents() merges GDELT GEO RPC + geocoded RSS items, deduplicates by name
- loadDataForLayer switch case for toggling positiveEvents layer on/off
- MapContainer.setPositiveEvents() delegates to DeckGLMap

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(04-02): complete positive events geocoding pipeline plan

- SUMMARY.md with task commits, decisions, deviations
- STATE.md updated with position, metrics, decisions
- ROADMAP.md and REQUIREMENTS.md updated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(04-03): create kindness-data service with baseline generator and curated events

- Add KindnessPoint interface for map visualization data
- Add MAJOR_CITIES constant with ~60 cities worldwide (population-weighted)
- Implement generateBaselineKindness() producing 50-80 synthetic points per cycle
- Implement extractKindnessEvents() for real kindness items from curated news
- Export fetchKindnessData() merging baseline + real events

* feat(04-03): add kindness layer to DeckGLMap and wire into App.ts pipeline

- Add createKindnessLayers() with solid green fill + gentle pulse ring for real events
- Add kindness-layer tooltip showing city name and description
- Add setKindnessData() setter in DeckGLMap and MapContainer
- Wire loadKindnessData() into App.ts loadAllData and loadDataForLayer
- Kindness layer gated by mapLayers.kindness toggle (happy variant only)
- Pulse animation triggers when real kindness events are present

* docs(04-03): complete kindness data pipeline & map layer plan

- Create 04-03-SUMMARY.md documenting kindness layer implementation
- Update STATE.md: phase 04 complete (3/3 plans), advance position
- Update ROADMAP.md: phase 04 marked complete
- Mark KIND-01 and KIND-02 requirements as complete

* docs(phase-4): complete phase execution

* docs(phase-5): research humanity data panels domain

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-humanity-data-panels): create phase plan

* feat(05-01): create humanity counters service with metric definitions and rate calculations

- Define 6 positive global metrics with annual totals from UN/WHO/World Bank/UNESCO
- Calculate per-second rates from annual totals / 31,536,000 seconds
- Absolute-time getCounterValue() avoids drift across tabs/throttling
- Locale-aware formatCounterValue() using Intl.NumberFormat

* feat(05-02): install papaparse and create progress data service

- Install papaparse + @types/papaparse for potential OWID CSV fallback
- Create src/services/progress-data.ts with 4 World Bank indicators
- Export PROGRESS_INDICATORS (life expectancy, literacy, child mortality, poverty)
- Export fetchProgressData() using existing getIndicatorData() RPC
- Null value filtering, year sorting, invertTrend-aware change calculation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(05-01): create CountersPanel component with 60fps animated ticking numbers

- Extend Panel base class with counters-grid of 6 counter cards
- requestAnimationFrame loop updates all values at 60fps
- Absolute-time calculation via getCounterValue() prevents drift
- textContent updates (not innerHTML) avoid layout thrashing
- startTicking() / destroy() lifecycle methods for App.ts integration

* feat(05-02): create ProgressChartsPanel with D3.js area charts

- Extend Panel base class with id 'progress', title 'Human Progress'
- Render 4 stacked D3 area charts (life expectancy, literacy, child mortality, poverty)
- Warm happy-theme colors: sage green, soft blue, warm gold, muted rose
- d3.area() with curveMonotoneX for smooth filled curves
- Header with label, change badge (e.g., "+58.0% since 1960"), and unit
- Hover tooltip with bisector-based nearest data point detection
- ResizeObserver with 200ms debounce for responsive re-rendering
- Clean destroy() lifecycle with observer disconnection

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-01): complete ticking counters service & panel plan

- SUMMARY.md with execution results and self-check
- STATE.md updated to phase 5, plan 1/3
- ROADMAP.md progress updated
- Requirements COUNT-01, COUNT-02, COUNT-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-02): complete progress charts panel plan

- Create 05-02-SUMMARY.md with execution results
- Update STATE.md: plan 2/3, decisions, metrics
- Update ROADMAP.md: phase 05 progress (2/3 plans)
- Mark PROG-01, PROG-02, PROG-03 complete in REQUIREMENTS.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(05-03): wire CountersPanel and ProgressChartsPanel into App.ts lifecycle

- Import CountersPanel, ProgressChartsPanel, and fetchProgressData
- Add class properties for both new panels
- Instantiate both panels in createPanels() gated by SITE_VARIANT === 'happy'
- Add progress data loading task in refreshAll() for happy variant
- Add loadProgressData() private method calling fetchProgressData + setData
- Add destroy() cleanup for both panels (stops rAF loop and ResizeObserver)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(05-03): add counter and progress chart CSS styles to happy-theme.css

- Counters grid: responsive 3-column layout (3/2/1 at 900px/500px breakpoints)
- Counter cards: hover lift, tabular-nums for jitter-free 60fps updates
- Counter icon/value/label/source typography hierarchy
- Progress chart containers: stacked with border dividers
- Chart header with label, badge, and unit display
- D3 SVG axis styling (tick text fill, domain stroke)
- Hover tooltip with absolute positioning and shadow
- Dark mode adjustments for card hover shadow and tooltip shadow
- All selectors scoped under [data-variant='happy']

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(05-03): complete panel wiring & CSS plan

- Create 05-03-SUMMARY.md with execution results
- Update STATE.md: phase 5 complete (3/3 plans), decisions, metrics
- Update ROADMAP.md: phase 05 progress (3/3 summaries, Complete)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-5): complete phase execution

* docs(06): research phase 6 content spotlight panels

* docs(phase-6): create phase plan

* feat(06-01): add science RSS feeds and BreakthroughsTickerPanel

- Expand HAPPY_FEEDS.science from 1 to 5 feeds (ScienceDaily, Nature News, Live Science, New Scientist)
- Create BreakthroughsTickerPanel extending Panel with horizontal scrolling ticker
- Doubled content rendering for seamless infinite CSS scroll animation
- Sanitized HTML output using escapeHtml/sanitizeUrl

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-01): create HeroSpotlightPanel with photo, map location, and hero card

- Create HeroSpotlightPanel extending Panel for daily hero spotlight
- Render hero card with image, source, title, time, and optional map button
- Conditionally show "Show on map" button only when both lat and lon exist
- Expose onLocationRequest callback for App.ts map integration wiring
- Sanitized HTML output using escapeHtml/sanitizeUrl

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-02): add GoodThingsDigestPanel with progressive AI summarization

- Panel extends Panel base class with id 'digest', title '5 Good Things'
- Renders numbered story cards with titles immediately (progressive rendering)
- Summarizes each story in parallel via generateSummary() with Promise.allSettled
- AbortController cancels in-flight summaries on re-render or destroy
- Graceful fallback to truncated title on summarization failure
- Passes [title, source] to satisfy generateSummary's 2-headline minimum

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(06-02): complete Good Things Digest Panel plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(06-01): complete content spotlight panels plan

- Add 06-01-SUMMARY.md with execution results
- Update STATE.md with position, decisions, metrics
- Update ROADMAP.md and REQUIREMENTS.md progress

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-03): wire Phase 6 panels into App.ts lifecycle and update happy.ts config

- Import and instantiate BreakthroughsTickerPanel, HeroSpotlightPanel, GoodThingsDigestPanel in createPanels()
- Wire heroPanel.onLocationRequest callback to map.setCenter + map.flashLocation
- Distribute data to all three panels after content pipeline in loadHappySupplementaryAndRender()
- Add destroy calls for all three panels in App.destroy()
- Add digest key to DEFAULT_PANELS in happy.ts config

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(06-03): add CSS styles for ticker, hero card, and digest panels

- Add happy-ticker-scroll keyframe animation for infinite horizontal scroll
- Add breakthroughs ticker styles (wrapper, track, items with hover pause)
- Add hero spotlight card styles (image, body, source, title, location button)
- Add digest list styles (numbered cards, titles, sources, progressive summaries)
- Add dark mode overrides for all three panel types
- All selectors scoped under [data-variant="happy"]

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(06-03): complete panel wiring & CSS plan

- Create 06-03-SUMMARY.md with execution results
- Update STATE.md: phase 6 complete, 18 plans done, 78% progress
- Update ROADMAP.md: phase 06 marked complete (3/3 plans)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-6): complete phase execution

* docs(07): research conservation & energy trackers phase

* docs(07-conservation-energy-trackers): create phase plan

* feat(07-02): add renewable energy data service

- Fetch World Bank EG.ELC.RNEW.ZS indicator (IEA-sourced) for global + 7 regions
- Return global percentage, historical time-series, and regional breakdown
- Graceful degradation: individual region failures skipped, complete failure returns zeroed data
- Follow proven progress-data.ts pattern for getIndicatorData() RPC usage

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(07-01): add conservation wins dataset and data service

- Create conservation-wins.json with 10 species recovery stories and population timelines
- Create conservation-data.ts with SpeciesRecovery interface and fetchConservationWins() loader
- Species data sourced from USFWS, IUCN, NOAA, WWF, and other published reports

* feat(07-02): add RenewableEnergyPanel with D3 arc gauge and regional breakdown

- Animated D3 arc gauge showing global renewable electricity % with 1.5s easeCubicOut
- Historical trend sparkline using d3.area() + curveMonotoneX below gauge
- Regional breakdown with horizontal bars sorted by percentage descending
- All colors use getCSSColor() for theme-aware rendering
- Empty state handling when no data available

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(07-01): add SpeciesComebackPanel with D3 sparklines and species cards

- Create SpeciesComebackPanel extending Panel base class
- Render species cards with photo (lazy loading + error fallback), info badges, D3 sparkline, and summary
- D3 sparklines use area + line with curveMonotoneX and viewBox for responsive sizing
- Recovery status badges (recovered/recovering/stabilized) and IUCN category badges
- Population values formatted with Intl.NumberFormat for readability

* docs(07-02): complete renewable energy panel plan

- SUMMARY.md with task commits, decisions, self-check
- STATE.md updated to phase 7 plan 2, 83% progress
- ROADMAP.md phase 07 progress updated
- REQUIREMENTS.md: ENERGY-01, ENERGY-02, ENERGY-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(07-01): complete species comeback panel plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(07-03): wire species and renewable panels into App.ts lifecycle

- Add imports for SpeciesComebackPanel, RenewableEnergyPanel, and data services
- Add class properties for speciesPanel and renewablePanel
- Instantiate both panels in createPanels() gated by SITE_VARIANT === 'happy'
- Add loadSpeciesData() and loadRenewableData() tasks in refreshAll()
- Add destroy cleanup for both panels before map cleanup
- Add species and renewable entries to happy.ts DEFAULT_PANELS config

* feat(07-03): add CSS styles for species cards and renewable energy gauge

- Species card grid layout with 2-column responsive grid
- Photo, info, badges (recovered/recovering/stabilized/IUCN), sparkline, summary styles
- Renewable energy gauge section, historical sparkline, and regional bar chart styles
- Dark mode overrides for species card hover shadow and IUCN badge background
- All styles scoped with [data-variant='happy'] using existing CSS variables

* docs(07-03): complete panel wiring & CSS plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): add missing panel entries and RSS proxy for dev mode

HAPPY_PANELS in panels.ts was missing digest, species, and renewable
entries — panels were constructed but never appended to the grid because
the panelOrder loop only iterated the 6 original keys.

Also adds RSS proxy middleware for Vite dev server, fixes sebuf route
regex to match hyphenated domains (positive-events), and adds happy
feed domains to the rss-proxy allowlist.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: progress data lookup, ticker speed, ultrawide layout gap

1. Progress/renewable data: World Bank API returns countryiso3code "WLD"
   for world aggregate, but services were looking up by request code "1W".
   Changed lookups to use "WLD".

2. Breakthroughs ticker: slowed animation from 30s to 60s duration.

3. Ultrawide layout (>2000px): replaced float-based layout with CSS grid.
   Map stays in left column (60%), panels grid in right column (40%).
   Eliminates dead space under the map where panels used to wrap below.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: UI polish — counter overflow, ticker speed, monitors panel, filter tabs

- Counter values: responsive font-size with clamp(), overflow protection,
  tighter card padding to prevent large numbers from overflowing
- Breakthroughs ticker: slowed from 60s to 120s animation duration
- My Monitors panel: gate monitors from panel order in happy variant
  (was unconditionally pushed into panelOrder regardless of variant)
- Filter tabs: smaller padding/font, flex-shrink:0, fade mask on right
  edge to hint at scrollable overflow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): exclude APT groups layer from happy variant map

The APT groups layer (cyber threat actors like Fancy Bear, Cozy Bear)
was only excluded for the tech variant. Now also excluded for happy,
since cyber threat data has no place on a Good News Map.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(happy-map): labeled markers, remove fake baseline, fix APT leak

- Positive events now show category emoji + location name as colored
  text labels (TextLayer) instead of bare dots. Labels filter by zoom
  level to avoid clutter at global view.
- Removed synthetic kindness baseline (50-80 fake "Volunteers at work"
  dots in random cities). Only real kindness events from news remain.
- Kindness events also get labeled dots with headlines.
- Improved tooltips with proper category names and source counts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy-map): disable earthquakes, fix GDELT query syntax

- Disable natural events layer (earthquakes) for happy variant —
  not positive news
- Fix GDELT GEO positive queries: OR terms require parentheses
  per GDELT API syntax, added third query for charity/volunteer news
- Updated both desktop and mobile happy map layer configs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): ultrawide grid overflow, panel text polish

Ultrawide: set min-height:0 on map/panels grid children so they
respect 1fr row constraint and scroll independently instead of
pushing content below the viewport.

Panel CSS: softer word-break on counters, line-clamp on digest
and species summaries, ticker title max-width, consistent
text-dim color instead of opacity hacks.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(08-map-data-overlays): research phase domain

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(08-map-data-overlays): create phase plan

* Add Global Giving Activity Index with multi-platform aggregation (#255)

* feat(08-01): add static data for happiness scores, renewable installations, and recovery zones

- Create world-happiness.json with 152 country scores from WHR 2025
- Create renewable-installations.json with 92 global entries (solar/wind/hydro/geothermal)
- Extend conservation-wins.json with recoveryZone lat/lon for all 10 species

* feat(08-01): add service loaders, extend MapLayers with happiness/species/energy keys

- Create happiness-data.ts with fetchHappinessScores() returning Map<ISO2, score>
- Create renewable-installations.ts with fetchRenewableInstallations() returning typed array
- Extend SpeciesRecovery interface with optional recoveryZone field
- Add happiness, speciesRecovery, renewableInstallations to MapLayers interface
- Update all 8 variant MapLayers configs (happiness=true in happy, false elsewhere)
- Update e2e harness files with new layer keys

* docs(08-01): complete data foundation plan summary and state updates

- Create 08-01-SUMMARY.md with execution results
- Update STATE.md to phase 8, plan 1/2
- Update ROADMAP.md progress for phase 08
- Mark requirements MAP-03, MAP-04, MAP-05 complete

* feat(08-02): add happiness choropleth, species recovery, and renewable installation overlay layers

- Add three Deck.gl layer creation methods with color-coded rendering
- Add public data setters for happiness scores, species recovery zones, and renewable installations
- Wire layers into buildLayers() gated by MapLayers keys
- Add tooltip cases for all three new layer types
- Extend happy variant layer toggles (World Happiness, Species Recovery, Clean Energy)
- Extend happy variant legend with choropleth, species, and renewable entries
- Cache country GeoJSON reference in loadCountryBoundaries() for choropleth reuse

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(08-02): wire MapContainer delegation and App.ts data loading for map overlays

- Add MapContainer delegation methods for happiness, species recovery, and renewable installations
- Add happiness scores and renewable installations map data loading in App.ts refreshAll()
- Chain species recovery zone data to map from existing loadSpeciesData()
- All three overlay datasets flow from App.ts through MapContainer to DeckGLMap

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(08-02): complete map overlay layers plan

- Create 08-02-SUMMARY.md with execution results
- Update STATE.md: phase 8 complete (2/2 plans), 22 total plans, decisions logged
- Update ROADMAP.md: phase 08 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-8): complete phase execution

* docs(roadmap): add Phase 7.1 gap closure for renewable energy installation & coal data

Addresses Phase 7 verification gaps (ENERGY-01, ENERGY-03): renewable panel
lacks solar/wind installation growth and coal plant closure visualizations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(7.1): research renewable energy installation & coal retirement data

* docs(71): create phase plans for renewable energy installation & coal retirement data

* feat(71-01): add GetEnergyCapacity RPC proto and server handler

- Create get_energy_capacity.proto with request/response messages
- Add GetEnergyCapacity RPC to EconomicService in service.proto
- Implement server handler with EIA capability API integration
- Coal code fallback (COL -> BIT/SUB/LIG/RC) for sub-type support
- Redis cache with 24h TTL for annual capacity data
- Register handler in economic service handler

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(71-01): add client-side fetchEnergyCapacity with circuit breaker

- Add GetEnergyCapacityResponse import and capacityBreaker to economic service
- Export fetchEnergyCapacityRpc() with energyEia feature gating
- Add CapacitySeries/CapacityDataPoint types to renewable-energy-data.ts
- Export fetchEnergyCapacity() that transforms proto types to domain types

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(71-01): complete EIA energy capacity data pipeline plan

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(71-02): add setCapacityData() with D3 stacked area chart to RenewableEnergyPanel

- setCapacityData() renders D3 stacked area (solar yellow + wind blue) with coal decline (red)
- Chart labeled 'US Installed Capacity (EIA)' with compact inline legend
- Appends below existing gauge/sparkline/regions without replacing content
- CSS styles for capacity section, header, legend in happy-theme.css

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(71-02): wire EIA capacity data loading in App.ts loadRenewableData()

- Import fetchEnergyCapacity from renewable-energy-data service
- Call fetchEnergyCapacity() after World Bank gauge data, pass to setCapacityData()
- Wrapped in try/catch so EIA failure does not break existing gauge

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(71-02): complete EIA capacity visualization plan

- SUMMARY.md documenting D3 stacked area chart implementation
- STATE.md updated: Phase 7.1 complete (2/2 plans), progress 100%
- ROADMAP.md updated with plan progress

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-71): complete phase execution

* docs(phase-09): research sharing, TV mode & polish domain

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09): create phase plan for sharing, TV mode & polish

* docs(phase-09): plan Sharing, TV Mode & Polish

3 plans in 2 waves covering share cards (Canvas 2D renderer),
TV/ambient mode (fullscreen panel cycling + CSS particles),
and celebration animations (canvas-confetti milestones).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-01): create Canvas 2D renderer for happy share cards

- 1080x1080 branded PNG with warm gradient per category
- Category badge, headline word-wrap, source, date, HappyMonitor branding
- shareHappyCard() with Web Share API -> clipboard -> download fallback
- wrapText() helper for Canvas 2D manual line breaking

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-02): create TvModeController and TV mode CSS

- TvModeController class manages fullscreen, panel cycling with configurable 30s-2min interval
- CSS [data-tv-mode] attribute drives larger typography, hidden interactive elements, smooth panel transitions
- Ambient floating particles (CSS-only, opacity 0.04) with reduced motion support
- TV exit button appears on hover, hidden by default outside TV mode

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-02): wire TV mode into App.ts header and lifecycle

- TV mode button with monitor icon in happy variant header
- TV exit button at page level, visible on hover in TV mode
- Shift+T keyboard shortcut toggles TV mode
- TvModeController instantiated lazily on first toggle
- Proper cleanup in destroy() method

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-01): add share button to positive news cards with handler

- Share button (SVG upload icon) appears on card hover, top-right
- Delegated click handler prevents link navigation, calls shareHappyCard
- Brief .shared visual feedback (green, scale) for 1.5s on click
- Dark mode support for share button background
- Fix: tv-mode.ts panelKeys index guard (pre-existing build blocker)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09-02): complete TV Mode plan

- SUMMARY.md with task commits, deviations, decisions
- STATE.md updated: position, metrics, decisions, session
- ROADMAP.md updated: phase 09 progress (2/3 plans)
- REQUIREMENTS.md updated: TV-01, TV-02, TV-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09-01): complete positive news share cards plan

- SUMMARY.md with Canvas 2D renderer and share button accomplishments
- STATE.md updated with decisions and session continuity
- ROADMAP.md progress updated (2/3 plans in phase 09)
- REQUIREMENTS.md: SHARE-01, SHARE-02, SHARE-03 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-03): add celebration service with canvas-confetti

- Install canvas-confetti + @types/canvas-confetti
- Create src/services/celebration.ts with warm nature-inspired palette
- Session-level dedup (Set<string>) prevents repeat celebrations
- Respects prefers-reduced-motion media query
- Milestone detection for species recovery + renewable energy records
- Moderate particle counts (40-80) for "warm, not birthday party" feel

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(09-03): wire milestone celebrations into App.ts data pipelines

- Import checkMilestones in App.ts
- Call checkMilestones after species data loads with recovery statuses
- Call checkMilestones after renewable energy data loads with global percentage
- All celebration calls gated behind SITE_VARIANT === 'happy'
- Placed after panel setData() so data is visible before confetti fires

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(09-03): complete celebration animations plan

- 09-03-SUMMARY.md with execution results
- STATE.md updated: phase 09 complete, 26 plans total, 100% progress
- ROADMAP.md updated with phase 09 completion
- REQUIREMENTS.md: THEME-06 marked complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-09): complete phase execution

* fix(happy): remove natural events layer from happy variant

Natural events (earthquakes, volcanoes, storms) were leaking into the
happy variant through stale localStorage and the layer toggle UI. Force
all non-happy layers off regardless of localStorage state, and remove
the natural events toggle from both DeckGL and SVG map layer configs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(phase-7.1): complete phase execution — mark all phases done

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs(v1): complete milestone audit — 49/49 requirements satisfied

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(happy): close audit tech debt — map layer defaults, theme-color meta

- Enable speciesRecovery and renewableInstallations layers by default
  in HAPPY_MAP_LAYERS (panels.ts + happy.ts) so MAP-04/MAP-05 are
  visible on first load
- Use happy-specific theme-color meta values (#FAFAF5 light, #1A2332
  dark) in setTheme() and applyStoredTheme() instead of generic colors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add checkpoint for giving integration handoff

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(giving): integrate Global Giving Activity Index from PR #254

Cherry-pick the giving feature that was left behind when PR #255
batch-merged without including #254's proto/handler/panel files.

Adds:
- Proto definitions (GivingService, GivingSummary, PlatformGiving, etc.)
- Server handler: GoFundMe/GlobalGiving/JustGiving/crypto/OECD aggregation
- Client service with circuit breaker
- GivingPanel with tabs (platforms, categories, crypto, institutional)
- Full wiring: API routes, vite dev server, data freshness, panel config
- Happy variant panel config entry

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(giving): move panel init and data fetch out of full-variant-only blocks

The GivingPanel was instantiated inside `if (SITE_VARIANT === 'full')` and
the data fetch was inside `loadIntelligenceSignals()` (also full-only).
Moved both to variant-agnostic scope so the panel works on happy variant.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(giving): bypass debounced setContent so tab buttons are clickable

Panel.setContent() is debounced (150ms), so event listeners attached
immediately after it were binding to DOM elements that got replaced by
the deferred innerHTML write. Write directly to this.content.innerHTML
like other interactive panels do.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: remove .planning/ from repo and gitignore it

Planning files served their purpose during happy monitor development.
They remain on disk for reference but no longer tracked.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: merge new panels into saved panelSettings so they aren't hidden

When panelSettings is loaded from localStorage, any panels added since
the user last saved settings would be missing from the config. The
applyPanelSettings loop wouldn't touch them, but without a config entry
they also wouldn't appear in the settings toggle UI correctly.

Now merges DEFAULT_PANELS entries into loaded settings for any keys
that don't exist yet, so new panels are visible by default.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: giving data baselines, theme toggle persistence, and client caching

- Replace broken GoFundMe (301→404) and GlobalGiving (401) API calls
  with hardcoded baselines from published annual reports. Activity index
  rises from 42 to 56 as all 3 platforms now report non-zero volumes.
- Fix happy variant theme toggle not persisting across page reloads:
  applyStoredTheme() couldn't distinguish "no preference" from "user
  chose dark" — both returned DEFAULT_THEME. Now checks raw localStorage.
- Fix inline script in index.html not setting data-theme="dark" for
  happy variant, causing CSS :root[data-variant="happy"] (light) to
  win over :root[data-variant="happy"][data-theme="dark"].
- Add client-side caching to giving service: persistCache on circuit
  breaker, 30min in-memory TTL, and request deduplication.
- Add Playwright E2E tests for theme toggle (8 tests, all passing).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* perf: add persistent cache to all 29 circuit breakers across 19 services

Enable persistCache and set appropriate cacheTtlMs on every circuit
breaker that lacked them. Data survives page reloads via IndexedDB
fallback and reduces redundant API calls on navigation.

TTLs matched to data freshness: 5min for real-time feeds (weather,
earthquakes, wildfires, aviation), 10min for event data (conflict,
cyber, unrest, climate, research), 15-30min for slow-moving data
(economic indicators, energy capacity, population exposure).

Market quotes breaker intentionally left at cacheTtlMs: 0 (real-time).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: expand map labels progressively as user zooms in

Labels now show more text at higher zoom levels instead of always
truncating at 30 chars. Zoom <3: 20 chars, <5: 35, <7: 60, 7+: full.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: keep 30-char baseline for map labels, expand to full text at zoom 6+

Previous change was too aggressive with low-zoom truncation (20 chars).
Now keeps original 30-char limit at global view, progressively expands
to 50/80/200 chars as user zooms in. Also scales font size with zoom.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Revert "fix: keep 30-char baseline for map labels, expand to full text at zoom 6+"

This reverts commit b10456851fb0e34cd3e999955543498956a0b18a.

* Revert "feat: expand map labels progressively as user zooms in"

This reverts commit a9cd2493740b94617efacae586ddffe2896615bc.

* perf: stale-while-revalidate for instant page load

Circuit breaker now returns stale cached data immediately and refreshes
in the background, instead of blocking on API calls when cache exceeds
TTL. Also persists happyAllItems to IndexedDB so Hero, Digest, and
Breakthroughs panels render instantly from cache on page reload.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: address PR #229 review — 4 issues from koala

1. P1: Fix duplicate event listeners in PositiveNewsFeedPanel.renderCards()
   — remove listener before re-adding to prevent stacking on re-renders

2. P1: Fix TV mode cycling hidden panels causing blank screen
   — filter out user-disabled panels from cycle list, rebuild keys on toggle

3. P2: Fix positive classifier false positives for short keywords
   — "ai" and "art" now use space-delimited matching to avoid substring hits
     (e.g. "aid", "rain", "said", "start", "part")

4. P3: Fix CSP blocking Google Fonts stylesheet for Nunito
   — add https://fonts.googleapis.com to style-src directive

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* refactor: decompose App.ts into focused modules under src/app/

Break the 4,597-line monolithic App class into 7 focused modules plus a
~460-line thin orchestrator. Each module implements the AppModule lifecycle
(init/destroy) and communicates via a shared AppContext state object with
narrow callback interfaces — no circular dependencies.

Modules extracted:
- app-context.ts: shared state types (AppContext, AppModule, etc.)
- desktop-updater.ts: desktop version checking + update badge
- country-intel.ts: country briefs, timeline, CII signals
- search-manager.ts: search modal, result routing, index updates
- refresh-scheduler.ts: periodic data refresh with jitter/backoff
- panel-layout.ts: panel creation, grid layout, drag-drop
- data-loader.ts: all 36 data loading methods
- event-handlers.ts: DOM events, shortcuts, idle detection, URL sync

Verified: tsc --noEmit (zero errors), all 3 variant builds pass
(full, tech, finance), runtime smoke test confirms no regressions.

* fix: resolve test failures and missing CSS token from PR review

1. flushStaleRefreshes test now reads from refresh-scheduler.ts (moved
   during App.ts modularization)
2. e2e runtime tests updated to import DesktopUpdater and DataLoaderManager
   instead of App.prototype for resolveUpdateDownloadUrl and loadMarkets
3. Add --semantic-positive CSS variable to main.css and happy-theme.css
   (both light and dark variants)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: hide happy variant button from other variants

The button is only visible when already on the happy variant. This
allows merging the modularized App.ts without exposing the unfinished
happy layout to users — layout work continues in a follow-up PR.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Elie Habib <elie.habib@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants