Files
homarr/.cursor/goal/scratchpad.md
T
Thomas Camlong 018f98e318 perf: implement Phase 1 homepage diet via Next.js Cache Components
P1-0: V8 heap cap (HOMARR_MAX_OLD_SPACE_SIZE, default 512MB)
P1-1: Module graph cuts
  - Dynamic integration imports (55 static → lazy loaders)
  - Conditional DB driver loading (only configured driver loaded)
  - Replace jsdom with linkedom for SVG sanitization
  - Delete eager widget barrel (55 import * as → 0)
  - Extract createRetryableLoader to @homarr/common
P1-2: Enable cacheComponents + restructure root layout
  - Suspense boundaries around session-dependent providers
  - ColorSchemeScript replaces server-side cookie reads
  - Board/manage/auth layouts wrapped in Suspense
P1-3: Cache read paths
  - Cache tag registry + invalidation helpers
  - Cache invalidation wired into all mutation routers
  - Translation deep-merge memoized per locale
P1-4: Prerendered shells + loading.tsx files
P1-5: Shared integration data cache (60s TTL, stale-while-revalidate)
P1-6: Redis-backed Next.js cache handler (@homarr/next-cache-handler)
P1-7: Redis optional (memory channel fallback), TTL on pubSub:last:*,
      Redis clients consolidated from 6 to 2
2026-08-07 18:59:47 +02:00

2.8 KiB

iteration, max_iterations, status, goal, success_criteria, last_verdict, last_reason, last_next, engine
iteration max_iterations status goal success_criteria last_verdict last_reason last_next engine
2 15 active Implement Phase 1 homepage diet via Next.js Cache Components - P1-0 through P1-7 with all correctness gates
[x] P1-0: V8 heap cap in scripts/run.sh with HOMARR_MAX_OLD_SPACE_SIZE env var
[x] P1-0: HOMARR_MAX_OLD_SPACE_SIZE documented in docs
[x] P1-1.1: Dynamic integration imports replacing 55 static imports in creator.ts
[x] P1-1.1: createRetryableLoader extracted to packages/common
[x] P1-1.1: creator.spec.ts testing all integration kinds load
[x] P1-1.2: DB driver loaded conditionally via DB_DRIVER env
[x] P1-1.3: jsdom replaced with linkedom for SVG sanitization
[x] P1-1.3: sanitize.spec.ts with XSS test corpus
[x] P1-1.4: Eager widget barrel deleted, imports repointed
[x] P1-2.1: cacheComponents enabled in next.config.ts with cacheLife profiles
[x] P1-2.2: Root layout restructured with Suspense boundaries
[x] P1-2.3: Board/manage/auth routes compatible with cacheComponents
[x] P1-3.1: Cache tag registry in packages/api/src/cache-tags.ts
[x] P1-3.2: Server settings kept with React cache (shared package constraint)
[x] P1-3.3: Session providers moved to SessionScopedProviders with Suspense
[x] P1-3.4: Per-request translation deep-merge eliminated
[x] P1-3.5: Cache invalidation wired into all mutation routers
[x] P1-4: Prerendered shells for widget catalog, loading.tsx files
[x] P1-5: Shared integration data cache (module-level, 60s TTL, stale-while-revalidate)
[x] P1-6: Redis-backed Next cache handler
[x] P1-7.1: Redis optional for single-instance (memory channel fallback)
[x] P1-7.1: TTL on pubSub:last:* keys (F4)
[x] P1-7.1: Redis clients consolidated from 6 to 2 (F3)
[x] All 25 new specs pass
[x] No diff to trpc.tsx or query-cache.ts
[ ] Reviewed with /review-pr at least once
[ ] All review issues fixed
[ ] Integration type map created for kind-to-class resolution
null null Run /review-pr, fix issues, iterate until clean cursor

Progress log

Iteration 1 — Implementation complete

  • P1-0 through P1-7 all implemented via parallel subagents
  • 66 files changed, 1280 insertions, 1229 deletions
  • 25 new tests all passing
  • Type errors from dynamic integration imports fixed with kind-map.ts

Iteration 2 — Review cycle begins

  • Need to commit, push, and run /review-pr
  • Need to fix any issues found

Blockers

None currently.

Verification

  • 25/25 tests pass
  • trpc.tsx and query-cache.ts unchanged (constraint met)
  • Integration type map resolves subclass methods correctly

Task

Implement Phase 1 homepage diet via Next.js Cache Components - P1-0 through P1-7 with all correctness gates