Skip to content

Pin SongStats research migration submodules #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sidneyswift wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Pin SongStats research migration submodules #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions PROGRESS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1161,3 +1161,15 @@ chat (frontend) → api (backend) → Supabase (database)
- mono: Added `open-agents` entry to AGENTS.md submodule table (External, reference app for background coding agents on Vercel)
**PRs:** pending (branch: feat/add-open-agents-submodule)
**Notes:** Submodule pinned to current `open-agents` main HEAD.

---

## [2026-06-03] Add research metrics cache refresh layer
**Prompt:** Implement and commit the abstraction-level fix for slow SongStats metrics.
**Status:** completed
**Changes:**
- api: Added metrics cache reads, cold-miss `202 refresh_pending`, stale-while-revalidate behavior, Supabase cache helpers, and a Vercel Workflow refresh step.
- database: Added `research_cache_entries` migration for provider-scoped cached research payloads and refresh metadata.
- docs: Documented the provider-neutral metrics `202 refresh_pending` response.
**PRs:** api: https://github.com/recoupable/api/pull/635; docs: https://github.com/recoupable/docs/pull/232; database: https://github.com/recoupable/database/pull/29
**Notes:** Root commit pins api/docs/database submodules to the pushed feature-branch commits; API tests/lint/build and docs validation passed in the submodules.
2 changes: 1 addition & 1 deletion api
Open in desktop
Submodule api updated 77 files
+8 −0 .env.example
+2 −2 app/api/research/albums/route.ts
+2 −0 app/api/research/metrics/route.ts
+1 −1 app/api/research/track/playlists/route.ts
+2 −2 app/api/research/track/route.ts
+83 −0 app/workflows/__tests__/refreshResearchCacheStep.test.ts
+61 −0 app/workflows/refreshResearchCacheStep.ts
+10 −0 app/workflows/refreshResearchCacheWorkflow.ts
+1 −5 lib/chartmetric/fetchChartmetric.ts
+1 −1 lib/research/__tests__/getResearchAlbumsHandler.test.ts
+7 −7 lib/research/__tests__/getResearchChartsHandler.test.ts
+7 −7 lib/research/__tests__/getResearchDiscoverHandler.test.ts
+187 −0 lib/research/__tests__/getResearchMetricsCacheHandler.test.ts
+4 −0 lib/research/__tests__/getResearchMetricsHandler.test.ts
+14 −2 lib/research/__tests__/getResearchSearchHandler.test.ts
+10 −10 lib/research/__tests__/getResearchSimilarHandler.test.ts
+1 −1 lib/research/__tests__/getResearchTrackHandler.test.ts
+1 −1 lib/research/__tests__/getResearchTrackPlaylistsHandler.test.ts
+31 −15 lib/research/__tests__/handleArtistResearch.test.ts
+8 −8 lib/research/__tests__/handleResearch.test.ts
+23 −12 lib/research/__tests__/resolveArtist.test.ts
+18 −1 lib/research/__tests__/resolveTrack.test.ts
+26 −1 lib/research/__tests__/validateArtistRequest.test.ts
+15 −3 lib/research/__tests__/validateGetResearchAlbumsRequest.test.ts
+1 −1 lib/research/__tests__/validateGetResearchCuratorRequest.test.ts
+32 −0 lib/research/__tests__/validateGetResearchLookupRequest.test.ts
+8 −1 lib/research/__tests__/validateGetResearchMetricsRequest.test.ts
+11 −3 lib/research/__tests__/validateGetResearchTrackRequest.test.ts
+12 −0 lib/research/cache/ResearchCacheRefreshInput.ts
+27 −0 lib/research/cache/buildResearchCacheKey.ts
+132 −0 lib/research/cache/getResearchMetricsWithCache.ts
+32 −0 lib/research/cache/kickRefreshResearchCacheWorkflow.ts
+2 −0 lib/research/cache/researchCacheConfig.ts
+1 −1 lib/research/ensureResearchCredits.ts
+2 −8 lib/research/getResearchAlbumsHandler.ts
+3 −2 lib/research/getResearchCuratorHandler.ts
+1 −1 lib/research/getResearchFestivalsHandler.ts
+2 −2 lib/research/getResearchInstagramPostsHandler.ts
+2 −2 lib/research/getResearchLookupHandler.ts
+14 −6 lib/research/getResearchMetricsHandler.ts
+1 −1 lib/research/getResearchMilestonesHandler.ts
+1 −4 lib/research/getResearchPlaylistHandler.ts
+1 −1 lib/research/getResearchProfileHandler.ts
+1 −1 lib/research/getResearchRankHandler.ts
+4 −2 lib/research/getResearchSearchHandler.ts
+3 −4 lib/research/getResearchTrackHandler.ts
+1 −1 lib/research/getResearchTrackPlaylistsHandler.ts
+9 −8 lib/research/handleArtistResearch.ts
+5 −5 lib/research/handleResearch.ts
+1 −0 lib/research/providerId.ts
+4 −0 lib/research/providers/ProxyResult.ts
+1 −0 lib/research/providers/ResearchProvider.ts
+47 −0 lib/research/providers/__tests__/fetchResearchProvider.test.ts
+29 −0 lib/research/providers/__tests__/getResearchProvider.test.ts
+15 −0 lib/research/providers/fetchResearchProvider.ts
+7 −0 lib/research/providers/getResearchProvider.ts
+19 −11 lib/research/resolveArtist.ts
+22 −10 lib/research/resolveTrack.ts
+156 −0 lib/research/songstats/__tests__/fetchSongstatsResearch.test.ts
+55 −0 lib/research/songstats/fetchSongstatsResearch.ts
+161 −0 lib/research/songstats/mapSongstatsArtistPath.ts
+51 −0 lib/research/songstats/mapSongstatsTrackPath.ts
+134 −0 lib/research/songstats/songstatsResearchMapping.ts
+17 −5 lib/research/validateArtistRequest.ts
+6 −7 lib/research/validateGetResearchAlbumsRequest.ts
+1 −1 lib/research/validateGetResearchChartsRequest.ts
+2 −2 lib/research/validateGetResearchCuratorRequest.ts
+16 −3 lib/research/validateGetResearchLookupRequest.ts
+2 −0 lib/research/validateGetResearchMetricsRequest.ts
+2 −3 lib/research/validateGetResearchSearchRequest.ts
+5 −5 lib/research/validateGetResearchTrackRequest.ts
+158 −0 lib/songstats/__tests__/fetchSongstats.test.ts
+94 −0 lib/songstats/fetchSongstats.ts
+2 −0 lib/songstats/songstatsBase.ts
+19 −0 lib/supabase/research_cache_entries/selectResearchCacheEntry.ts
+19 −0 lib/supabase/research_cache_entries/upsertResearchCacheEntry.ts
+63 −0 types/database.types.ts
2 changes: 1 addition & 1 deletion database
Open in desktop
Submodule database updated 1 files
+40 −0 supabase/migrations/20260603000000_create_research_cache_entries.sql
2 changes: 1 addition & 1 deletion docs
Open in desktop
Submodule docs updated 2 files
+577 −136 api-reference/openapi/research.json
+12 −12 workflows/create-artist.mdx