docs(02-04): complete companion text module plan

- SUMMARY.md with task commits and decisions
- STATE.md advanced to plan 4 of 5, 80% progress
- ROADMAP.md updated with plan progress
- Requirements COMP-01 through COMP-04 marked complete

.planning/REQUIREMENTS.md

@@ -75,10 +75,10 @@ Requirements for initial release (MVP). Each maps to roadmap phases.
 
 ### Companion
 
-- [ ] **COMP-01**: Begrüssungstext bei App-Start (KI-generiert, tageszeit-abhängig, oder Fallback)
+- [x] **COMP-01**: Begrüssungstext bei App-Start (KI-generiert, tageszeit-abhängig, oder Fallback)
-- [ ] **COMP-02**: Buchstaben-Vorstellungstext (KI-generiert mit Eselsbrücke, oder Fallback)
+- [x] **COMP-02**: Buchstaben-Vorstellungstext (KI-generiert mit Eselsbrücke, oder Fallback)
-- [ ] **COMP-03**: Waldbelohnungs-Kommentar (KI-generiert, Staunen + Freude, oder Fallback)
+- [x] **COMP-03**: Waldbelohnungs-Kommentar (KI-generiert, Staunen + Freude, oder Fallback)
-- [ ] **COMP-04**: Alle Texte max 25 Wörter, einfache Sprache, kein Leistungslob, kein Englisch
+- [x] **COMP-04**: Alle Texte max 25 Wörter, einfache Sprache, kein Leistungslob, kein Englisch
 
 ### Reward
 
@@ -183,10 +183,10 @@ Which phases cover which requirements. Updated during roadmap creation.
 | ASST-02 | Phase 2 | Pending |
 | ASST-03 | Phase 2 | Pending |
 | ASST-04 | Phase 2 | Pending |
-| COMP-01 | Phase 2 | Pending |
+| COMP-01 | Phase 2 | Complete |
-| COMP-02 | Phase 2 | Pending |
+| COMP-02 | Phase 2 | Complete |
-| COMP-03 | Phase 2 | Pending |
+| COMP-03 | Phase 2 | Complete |
-| COMP-04 | Phase 2 | Pending |
+| COMP-04 | Phase 2 | Complete |
 | TYPE-05 | Phase 3 | Pending |
 | TYPE-06 | Phase 3 | Pending |
 | TYPE-07 | Phase 3 | Pending |

.planning/ROADMAP.md

@@ -55,7 +55,7 @@ Plans:
 - [x] 02-01-PLAN.md — Config loader, Gemini API client (text + image), retry logic, rate-limiting (TDD)
 - [x] 02-02-PLAN.md — Fallback texts (greetings, forest comments, letter intros) and fallback SVG images
 - [ ] 02-03-PLAN.md — IndexedDB store accessors, build script for asset generation, generate all character assets
-- [ ] 02-04-PLAN.md — Companion text module (getGreeting, getLetterIntro, getForestComment) with API-first fallback
+- [x] 02-04-PLAN.md — Companion text module (getGreeting, getLetterIntro, getForestComment) with API-first fallback
 - [ ] 02-05-PLAN.md — Wire avatars into welcome screen, companion greeting on forest screen, visual verification
 
 ### Phase 3: Komplettes Spielerlebnis

.planning/STATE.md

@@ -3,14 +3,14 @@ gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
 status: executing
-stopped_at: Completed 02-01-PLAN.md
+stopped_at: Completed 02-04-PLAN.md
-last_updated: "2026-03-29T09:57:41.199Z"
+last_updated: "2026-03-29T10:06:43.421Z"
 last_activity: 2026-03-29
 progress:
   total_phases: 4
   completed_phases: 1
   total_plans: 10
-  completed_plans: 7
+  completed_plans: 8
   percent: 0
 ---
 
@@ -26,7 +26,7 @@ See: .planning/PROJECT.md (updated 2026-03-29)
 ## Current Position
 
 Phase: 02 (gemini-integration-asset-pipeline) — EXECUTING
-Plan: 3 of 5
+Plan: 4 of 5
 Status: Ready to execute
 Last activity: 2026-03-29
 
@@ -59,6 +59,7 @@ Progress: [░░░░░░░░░░] 0%
 | Phase 01 P05 | 2min | 2 tasks | 4 files |
 | Phase 02 P02 | 2min | 2 tasks | 8 files |
 | Phase 02 P01 | 3min | 1 tasks | 6 files |
+| Phase 02 P04 | 1min | 1 tasks | 2 files |
 
 ## Accumulated Context
 
@@ -81,6 +82,7 @@ Recent decisions affecting current work:
 - [Phase 02]: Rate limiting stored in Settings singleton, no new IndexedDB store
 - [Phase 02]: Image generation no retry (expensive), text retries 3x exponential backoff
 - [Phase 02]: Config loader caches after first fetch, resetConfigCache() for testing
+- [Phase 02]: Each companion function independently checks config and rate limits (no shared wrapper) for clarity
 
 ### Pending Todos
 
@@ -92,6 +94,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-03-29T09:57:41.192Z
+Last session: 2026-03-29T10:06:43.414Z
-Stopped at: Completed 02-01-PLAN.md
+Stopped at: Completed 02-04-PLAN.md
 Resume file: None

.planning/phases/02-gemini-integration-asset-pipeline/02-04-SUMMARY.md

@@ -0,0 +1,94 @@
+---
+phase: 02-gemini-integration-asset-pipeline
+plan: 04
+subsystem: companion
+tags: [gemini, ai-text, fallback, companion, german]
+
+# Dependency graph
+requires:
+  - phase: 02-01
+    provides: "generateText, checkRateLimit, incrementApiCall, loadConfig"
+  - phase: 02-02
+    provides: "fallback greetings, letter intros, forest comments"
+provides:
+  - "getGreeting: AI or fallback greeting with time-of-day context"
+  - "getLetterIntro: AI or fallback letter introduction with finger description"
+  - "getForestComment: AI or fallback forest element comment"
+affects: [03-exercise-flow, 04-forest-rendering]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [api-first-fallback, rate-limit-guard, companion-prompt-templates]
+
+key-files:
+  created: [src/companion/companion.ts, src/companion/companion.test.ts]
+  modified: []
+
+key-decisions:
+  - "Prompt templates use ue/oe/ae transliteration consistent with codebase convention"
+  - "Each function independently checks config and rate limits (no shared wrapper) for clarity"
+
+patterns-established:
+  - "API-first fallback: loadConfig -> checkRateLimit -> generateText -> fallback on any null"
+  - "System prompts enforce max 25 words, simple German, no performance praise per COMP-04"
+
+requirements-completed: [COMP-01, COMP-02, COMP-03, COMP-04]
+
+# Metrics
+duration: 1min
+completed: 2026-03-29
+---
+
+# Phase 02 Plan 04: Companion Text Module Summary
+
+**Companion text module with 3 exported functions (getGreeting, getLetterIntro, getForestComment) using Gemini API-first strategy with curated German fallbacks**
+
+## Performance
+
+- **Duration:** 1 min
+- **Started:** 2026-03-29T10:04:46Z
+- **Completed:** 2026-03-29T10:06:01Z
+- **Tasks:** 1 (TDD: RED + GREEN)
+- **Files modified:** 2
+
+## Accomplishments
+- Companion text module with API-first fallback strategy for all 3 dialogue types
+- System prompts enforce max 25 words, simple German, no performance praise
+- 13 tests covering API success, API failure, no config, and rate-limited paths
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1 (RED): Companion test suite** - `6fba02c` (test)
+2. **Task 1 (GREEN): Companion text module implementation** - `4b4aa8e` (feat)
+
+_TDD task: test file committed first (RED), then implementation (GREEN)._
+
+## Files Created/Modified
+- `src/companion/companion.ts` - Companion text module with getGreeting, getLetterIntro, getForestComment
+- `src/companion/companion.test.ts` - 13 tests covering all fallback paths and API integration
+
+## Decisions Made
+- Prompt templates use ue/oe/ae transliteration consistent with existing codebase convention
+- Each function independently checks config and rate limits rather than using a shared wrapper, keeping the code straightforward and readable
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+None
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- Companion text module ready for integration into exercise flow
+- All 3 functions exported and tested, ready for import by UI screens
+- Depends on config.json with valid Gemini API key for AI-generated text; works without it via fallbacks
+
+---
+*Phase: 02-gemini-integration-asset-pipeline*
+*Completed: 2026-03-29*