Jean-Luc Makiola
9dbf019466
- SUMMARY.md: attribution columns, upsert service, Zod schemas - STATE.md: advance to plan 2, add decisions - ROADMAP.md: update phase 25 progress - REQUIREMENTS.md: mark CATL-01, CATL-02, CATL-05 complete
83 lines
2.8 KiB
Markdown
83 lines
2.8 KiB
Markdown
---
|
|
gsd_state_version: 1.0
|
|
milestone: v2.1
|
|
milestone_name: Public Discovery
|
|
status: executing
|
|
stopped_at: Completed 25-01-PLAN.md
|
|
last_updated: "2026-04-10T08:59:46.905Z"
|
|
last_activity: 2026-04-10
|
|
progress:
|
|
total_phases: 6
|
|
completed_phases: 1
|
|
total_plans: 4
|
|
completed_plans: 3
|
|
percent: 0
|
|
---
|
|
|
|
# Project State
|
|
|
|
## Project Reference
|
|
|
|
See: .planning/PROJECT.md (updated 2026-04-09)
|
|
|
|
**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:** Phase 25 — catalog-enrichment-agent-tools
|
|
|
|
## Current Position
|
|
|
|
Phase: 25 (catalog-enrichment-agent-tools) — EXECUTING
|
|
Plan: 2 of 2
|
|
Status: Ready to execute
|
|
Last activity: 2026-04-10
|
|
|
|
Progress: [░░░░░░░░░░] 0%
|
|
|
|
## Performance Metrics
|
|
|
|
**Velocity:**
|
|
|
|
- Total plans completed: 55 (all milestones through v2.0)
|
|
- v1.3: 6 plans across 4 phases (2026-03-16 to 2026-04-08)
|
|
- v2.0: 32 plans across 10 phases (2026-03-17 to 2026-04-08)
|
|
|
|
*Updated after each plan completion*
|
|
|
|
## Accumulated Context
|
|
|
|
### Decisions
|
|
|
|
Key decisions carried forward from v2.0:
|
|
|
|
- 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
|
|
|
|
v2.1 decisions:
|
|
|
|
- Product images: manufacturer images with attribution and source link, honor takedown requests — RESOLVED
|
|
- Catalog data: open datasets + manufacturer specs + agent MCP enrichment — RESOLVED
|
|
- Public-first: auth model rework before content features — RESOLVED
|
|
- Phase 999.3 (Public Access Auth Model backlog item) is now Phase 24 — PROMOTED
|
|
- [Phase 24-public-access-infrastructure]: createRateLimit factory pattern for configurable rate limiting per endpoint tier
|
|
- [Phase 24-public-access-infrastructure]: Browse tier 120/min, detail tier 60/min — same limits for auth and anon users
|
|
- [Phase 24]: Both auth prompt CTAs go to /login — Logto handles sign-in and sign-up at the same OIDC endpoint
|
|
- [Phase 24]: Soft navigate() replaces hard window.location.href for private route redirect — defers until auth resolves
|
|
- [Phase 25-catalog-enrichment-agent-tools]: Three-way tag sync: undefined=leave untouched, []=clear all, [names]=replace — enables selective tag updates from catalog agents
|
|
- [Phase 25-catalog-enrichment-agent-tools]: unique(brand, model) constraint on globalItems: enables safe ON CONFLICT DO UPDATE for catalog enrichment agents
|
|
|
|
### Pending Todos
|
|
|
|
None active.
|
|
|
|
### Blockers/Concerns
|
|
|
|
None.
|
|
|
|
## Session Continuity
|
|
|
|
Last session: 2026-04-10T08:59:46.903Z
|
|
Stopped at: Completed 25-01-PLAN.md
|
|
Resume file: None
|