GearBox/.planning/STATE.md

gsd_state_version, milestone, milestone_name, status, stopped_at, last_updated, last_activity, progress

gsd_state_version	milestone	milestone_name	status	stopped_at	last_updated	last_activity	progress
1.0	v2.4	Admin Foundation	executing	Completed 35-01-PLAN.md — FIX-01, FIX-02, FIX-04 resolved	2026-04-19T17:48:30.721Z	2026-04-19	total_phases completed_phases total_plans completed_plans percent 20 7 32 31 97

Project State

Project Reference

See: .planning/PROJECT.md (updated 2026-04-19)

Core value: Help people make better gear decisions — discover what others use, compare real-world data, and see how a potential buy affects your setup before committing. Current focus: Milestone v2.4 — Admin Foundation | Phase 35: Bug Fixes

Current Position

Phase: 35 — Bug Fixes Plan: 2 of 3 complete Status: In progress — 35-01 and 35-02 complete, 35-03 remaining Last activity: 2026-04-19 — 35-02 complete (FIX-03)

Progress: [██████████] 97%

Performance Metrics

Velocity:

• Total plans completed: 110+ (all milestones through v2.3)
• v2.3: 18 plans across 3 phases (2026-04-13 → 2026-04-19)

Updated after each plan completion

Accumulated Context

Decisions

Key decisions carried forward from v2.3:

• External auth provider: Logto (self-hosted OIDC) — RESOLVED
• Structured UGC only — ratings and predefined fields, no freeform text — ACTIVE
• Separate globalItems table — not a flag on user items table — RESOLVED
• COALESCE merge for reference items — RESOLVED
• Detail pages replacing slide-out panels — RESOLVED
• Setup visibility: private/link/public column + shares table — RESOLVED
• Multi-currency: market_prices + community_prices + ECB rates — RESOLVED
• i18n: react-i18next, 7 namespaces, English + German — RESOLVED

v2.4 decisions:

• Admin role: isAdmin boolean flag on users table (simplest, no Logto role claims needed)
• Admin grant mechanism: CLI script or seed — no public UI for granting admin
• Sub-items/component attachment: explicitly deferred to a future milestone
• Catalog spec system (typed specs per tag): deferred to v2.5
• Engagement stats (views/likes/saves/appearances): deferred to v2.5

Phase 35 decisions (35-01):

• FIX-01: Add Candidate on thread page routes through CatalogSearchOverlay (thread mode), not a local modal
• FIX-02: ItemWithCategory type extended client-side only — server already returns image fields via withImageUrls()
• FIX-04: Login page is a server pass-through; no client auth check or card UI needed

Phase 35 decisions (35-02):

• FIX-03: Browser-native loading=lazy used for image deferral — no library needed, zero bundle overhead
• FIX-03: Skeleton is absolute inset-0 overlay removed on onLoad (not conditional branch swap) for stable layout
• FIX-03: GearImage accepts optional onLoad prop forwarded to all three img render paths

Pending Todos

• Cursor pointer on all clickable links — Phase 35 (FIX-05, plan 35-03)

Resolved in 35-01:

• Fix Add Candidate button shows wrong modal on thread page — DONE (FIX-01)
• Fix item image not showing on collection overview — DONE (FIX-02)
• Auth prompt sign-in button should redirect directly to Logto — DONE (FIX-04)

Resolved in 35-02:

• Investigate slow image loading — DONE (FIX-03)

Blockers/Concerns

None.

Deferred Items

Items carried forward from v2.3:

Category	Item	Status
todo	2026-04-10-add-cursor-pointer-to-all-clickable-links	promoted to v2.4 FIX-05
todo	2026-04-10-fix-item-image-not-showing-on-collection-overview	promoted to v2.4 FIX-02
todo	2026-04-10-investigate-slow-image-loading	promoted to v2.4 FIX-03
todo	2026-04-13-auth-prompt-sign-in-button-should-redirect-directly-to-logto	promoted to v2.4 FIX-04
todo	2026-04-13-fix-add-candidate-button-shows-wrong-modal-on-thread-page	promoted to v2.4 FIX-01

Session Continuity

Last session: 2026-04-19 Stopped at: Completed 35-02-PLAN.md — FIX-03 (image lazy loading + skeleton) resolved Resume file: .planning/phases/35-bug-fixes/35-03-PLAN.md