Skip to content

PROGRESS.md

Latest commit

 

History

History
977 lines (795 loc) · 77.3 KB

PROGRESS.md

File metadata and controls

977 lines (795 loc) · 77.3 KB

PROGRESS.md

Last updated: 2026-04-14

[2026-04-14] Tasks — AI overlay position for editorial templates (REC-67)

Prompt: Overlaid images always placed top-left; use AI to determine ideal corner Status: in_progress (PR open, awaiting code review) Changes:

  • tasks: New ToolLoopAgent (createOverlayPositionAgent) analyzes editorial image to pick best overlay corner
  • tasks: New overlayPosition.ts with shared type and coordinate calculation for top-left/top-right/bottom-left/bottom-right
  • tasks: Updated buildStaticImageArgs, buildFilterComplex, buildFfmpegArgs, renderFinalVideo, createContentTask to accept overlayPosition
  • tasks: 14 new tests for position calculation and filter complex positioning PRs: recoupable/tasks#138 Notes: Backward-compatible — defaults to top-left when position not provided. Independent of REC-66 overlay size changes.

[2026-04-14] Tasks — Larger playlist cover images (REC-66)

Prompt: Playlist cover images overlaid on editorial template videos are too small for record label customers Status: in_progress (PR open, awaiting code review) Changes:

  • tasks: Increased OVERLAY_SIZE from 150px to 250px in buildStaticImageArgs.ts and buildFilterComplex.ts
  • tasks: Updated tests in both test files to reflect new dimensions PRs: recoupable/tasks#137 Notes: Depends on REC-65 (PR #136) being merged first. PR branches from feature/rec-65-editorial-static-image.

[2026-04-14] Tasks/API — Editorial template static image (REC-65)

Prompt: Editorial content template should return both video and a static image with playlist covers overlaid Status: in_progress (PRs open, awaiting code review) Changes:

  • tasks: New buildStaticImageArgs.ts — ffmpeg args for single-frame image render with overlays
  • tasks: New renderStaticImage.ts — downloads base + overlays, runs ffmpeg, uploads PNG to fal.ai
  • tasks: createContentTask renders static image when template uses overlay, returns staticImageUrl
  • tasks: pollContentRuns extracts imageUrl from task output
  • api: contentRunResultSchema accepts optional imageUrl field
  • api: postVideoResults downloads and posts static images before videos in Slack threads
  • 15 new tests across both submodules (all green) PRs:
  • recoupable/tasks#136
  • recoupable/api#438 Notes: API PR targets test branch. Tasks PR targets main. Both submodules must be deployed together.

[2026-04-14] API — Slackbot default no artist (REC-64)

Prompt: Remove hardcoded Gatsby Grace default from content agent Slack bot; require artist name in prompt Status: in_progress (PR open, awaiting code review) Changes:

  • api: Removed hardcoded artistAccountId from registerOnNewMention.ts
  • api: Added artistName to contentPromptFlagsSchema for AI extraction from prompts
  • api: New selectAccountByNameInOrg.ts for case-insensitive artist name lookup within an organization
  • api: Bot now prompts user if no artist specified, shows error if not found
  • api: 38 tests passing (20 registerOnNewMention + 13 parseContentPrompt + 5 selectAccountByNameInOrg) PRs: recoupable/api#437 Notes: Related to REC-40 (artist name param) which had an unmerged PR#382. REC-64 supersedes by making null the default instead of Gatsby Grace as fallback.

[2026-04-14] API/Tasks/Docs — DSP logo overlay for editorial template (REC-63)

Prompt: Add dsp enum parameter so editorial videos can include Spotify/Apple Music logo overlay Status: in_progress (PRs open, awaiting code review) Changes:

  • api: Added dsp enum (none/spotify/apple) to validation schema, trigger payload, content prompt agent, and Slack mention handler
  • api: New dspValues.ts constant file following captionLengths.ts pattern
  • api: 4 new tests for dsp validation and prompt extraction
  • tasks: Added dsp to content creation schema, new resolveDspLogoUrl utility
  • tasks: createContentTask appends DSP logo URL to overlay images for ffmpeg render
  • tasks: 5 new tests for DSP resolution and pipeline integration
  • docs: Added dsp field to OpenAPI spec and Content Agent Slack bot docs PRs:
  • recoupable/api#436
  • recoupable/tasks#135
  • recoupable/docs#131 Notes: API PR targets test branch. Tasks/docs PRs target main. DSP logo URLs are placeholders — actual images will be added by the user after PR merge. All three submodules must be deployed together.

[2026-04-13] API/Tasks — Default captions to none (REC-62)

Prompt: Slack bot generates captions even when not requested; default should be no captions Status: in_progress (PRs open, awaiting code review) Changes:

  • api: Added "none" to CAPTION_LENGTHS enum, changed default from "short" to "none" across all schemas
  • api: Updated prompt agent to only set captions when explicitly requested by user
  • api: Updated 4 test files to reflect new defaults
  • tasks: Added "none" to content creation schema, changed default to "none"
  • tasks: Skip caption generation API call when captionLength === "none", pass empty string to ffmpeg render
  • tasks: Added test for caption skip behavior PRs:
  • recoupable/api#433
  • recoupable/tasks#132 Notes: API PR targets test branch. Tasks PR targets main. Both submodules must be deployed together.

[2026-04-13] Admin/API — Track embedded Slack videos instead of URLs (REC-61)

Prompt: Admin page tracks embedded videos from Slack bot instead of extracted video URLs Status: in_progress (PRs open, awaiting code review) Changes:

  • api: Replaced extractVideoLinks (URL text parsing) with extractVideoFiles (Slack file object extraction)
  • api: Replaced fetchThreadVideoLinks with fetchThreadVideoFiles to read files array on bot messages
  • api: 12 new tests for extraction logic
  • admin: Renamed "Video Links" column to "Videos", display friendly labels instead of raw URLs PRs:
  • recoupable/api#432
  • recoupable/admin#27 Notes: API PR targets test branch. Admin PR targets main.

[2026-04-13] API — Add View Task button to content agent Slack response (REC-60)

Prompt: Add "View Task" button to content agent Slack response, matching coding agent behavior Status: in_progress (PR open, awaiting code review) Changes:

  • api: Moved buildTaskCard from lib/coding-agent/ to shared lib/agents/ (DRY)
  • api: Added "View Task" button card to content agent registerOnNewMention handler
  • api: Updated coding agent imports to use shared location
  • api: 18 tests pass (2 new for buildTaskCard, 2 new for content agent View Task) PRs:
  • recoupable/api#430 Notes: Button links to chat.recoupable.com/tasks/{runId} using the first triggered run ID.

[2026-04-13] Tasks — Editorial image detection in content pipeline (REC-59)

Prompt: Detect editorial press photos in attachments and skip AI image generation when one is found Status: in_progress (PR open, awaiting code review) Changes:

  • tasks: Added detectEditorialImage.ts + createEditorialDetectionAgent.ts for AI-based editorial photo classification
  • tasks: Updated classifyImages, resolveFaceGuide, createContentTask to support editorialImageUrl
  • tasks: When editorial image detected, pipeline skips image generation and uses it directly for video gen
  • tasks: 11 new tests, all 347 tests pass PRs:
  • recoupable/tasks#131 Notes: Follows same pattern as face detection (few-shot AI classification). Editorial detection only runs when usesImageOverlay is true.

[2026-04-12] Admin — Agent Sign-Ups page (REC-56)

Prompt: Add admin page for tracking agent API key signups with docs and API endpoint Status: in_progress (PRs open, awaiting code review) Changes:

  • docs: OpenAPI spec and MDX page for GET /api/admins/agent-signups endpoint
  • api: New admin endpoint querying account_api_keys joined with account_emails filtered by agent+ email prefix, with period filtering
  • admin: New /agent-signups page with line chart, stats bar, data table following /content page pattern PRs:
  • recoupable/docs#127
  • recoupable/api#428
  • recoupable/admin#26 Notes: All 3 PRs created and pushed. TypeScript compiles cleanly. Awaiting Code Reviewer.

[2026-04-02] Content creation V2 plan + caption bug investigation

Prompt: Investigate caption bug (captions not based on song lyrics), then iterate on V2 modular plan for content creation pipeline Status: completed Changes:

  • tasks: Investigated caption generation bug by pulling Trigger.dev run data via SDK, triggered reproduction run with "Safe Boy Bestie" mp3. Confirmed lyrics DO flow through transcription → caption prompt. The template's caption-guide.json style rules overpower the lyrics context, but captions are loosely connected to the song — not a hard bug, more a prompt tuning issue.
  • plans: Updated .local/plans/content-creation/plan.md — V2 modular plan with: API endpoints nested under /api/content/create/, clear api vs tasks repo split, renamed "caption" → "text" (text = content + style including font), renamed "clip" → "audio", clarified face guide is artist-specific (not template-level), added text-style.json and fonts/ to template structure PRs: none (plan + investigation only) Notes: Key architectural decisions: (1) generate-text is inline in api (2-5s LLM call), all other primitives are Trigger.dev tasks. (2) Text primitive returns content + style (font, color, size), render just draws it. (3) Templates define scenes, artists provide faces — the two are independent. (4) createContentTask becomes an orchestrator calling individual tasks via triggerAndWait. Remaining gaps to address during implementation: artist context fetching, text object schema, template renaming, partial retry UX, docs updates.

[2026-04-02] Two new skills from Alexis x Sid meeting transcript

Prompt: Extract domain knowledge from Alexis x Sid meeting transcript (April 1) and create skills Status: completed Changes:

  • skills: Created trend-to-song/SKILL.md — pipeline for turning trending cultural moments into songs and test campaigns in 72 hours. Covers trend spotting, emotional DNA extraction, AI song generation, burner page distribution, and monitoring. Based on the Bravo reality TV example discussed in the meeting
  • skills: Created artist-growth-threshold/SKILL.md — playbook for getting new artists past streaming milestones (1K monthly listeners for Showcase, 5K for Marquee, Popularity 50 for algorithmic boosting). Includes three paths to 1K (playlist pitching, social-to-DSP ads, organic), real cost benchmarks ($500 playlist push, $0.34 CPC, ~30% click-to-listen), content strategy (relatable first lines, mouth movement for unmutes, posting cadence), and decision framework
  • skills: Updated README.md — added both skills to the skills table and directory structure PRs: none (local skill creation) Notes: Domain knowledge extracted from Alexis (Rostrum Records) sharing music marketing expertise during the Gatsby Grace growth planning discussion. Key data points are from real campaigns (playlist pitching benchmarks, Spotify Popularity mechanics, content engagement patterns). The trend-to-song workflow is novel — reverse engineering from cultural moment to song using AI generation, which Alexis described as something he "never thought in practice" would work but was excited about.

[2026-04-01] Financial docs for fundraise deck (cap table, P&L, projections)

Prompt: Jules asked for cap table, historical financials, and projections for the investor deck. Build all three. Status: completed Changes:

  • strategy: Created cap-table.md — current ownership (Sid 99%, Jules 1% advisor), vesting schedule, pre-money valuation benchmarks, notes on LLC→C-Corp conversion for fundraise
  • strategy: Created financials.md — historical revenue by month (Jan 2025→Apr 2026), current expense breakdown ($11,277/mo), P&L summary showing cash-flow positive with Seeker, pipeline detail, two 12-month projection scenarios (organic: exit $68k MRR; post-raise: exit $108k MRR), use of funds breakdown for ~$1M raise
  • strategy: Updated customers.md — corrected MRR to ~$17,995 with full breakdown (added Atlantic $1k/mo, 300 $1k/mo, 5 B2C at $99/mo), added expense summary and net income
  • strategy: Updated investor-memo.md — corrected MRR to ~$18K, added cash-flow positive status and $0 external funding raised PRs: none (local strategy docs) Notes: Several items marked [?] in financials.md need Sid to fill in: exact start dates for Atlantic and 300 pilot payments, and any missing expenses. Two projection scenarios model organic growth (no raise, exit $68k MRR) and post-raise acceleration ($750K-$1.25M raise, exit $108k MRR). Key insight for deck: company reaches cash-flow positive the month Seeker closes — raise is for acceleration, not survival.

[2026-04-01] Strategy docs updated from Jules x Sid transcript (April 1)

Prompt: Process Jules x Sid meeting transcript (April 1) and route insights to strategy docs per AGENTS.md classification rules (DECISION / IDEA / SIGNAL / CONTEXT) Status: completed Changes:

  • strategy: Saved structured transcript to transcripts/jules-sid-2026-04-01.md with 11 topic sections and action items table
  • strategy: pmf-journal.md — appended 13 classified entries: 7 IDEAS (YC for Creators model, warrants, SAFR instrument, agent org chart product, parent entity restructuring, prove-then-raise path, accelerator expansion), 2 SIGNALs (Broke Records signing AI artists, cohort hustle vs. talent divide), 4 CONTEXT entries (EA resource, NYC trip logistics, Meng situation, Jules role evolution)
  • strategy: decisions-log.md — appended 1 DECISION: keep initial artist signings lightweight (term sheet + email, no heavy legal)
  • strategy: roster.md — expanded Meng/Alma entry with company context and NYC plans; added accelerator cohort observations (Pear, Amanda); added "Potential Partners" section with Broke Records and Nashville musicians-fundable group
  • strategy: roster.md — rewrote "Acquired IP Deals" section to reflect evolving YC-for-creators model with warrants, SAFR, and prove-then-raise path (tagged as IDEA, not DECISION)
  • strategy: deals/README.md — added "Emerging Framing" section for YC model, warrants, SAFR; noted potential v0.3 evolution
  • strategy: roadmap.md — expanded label play table with 12 specific action items (advisor agreement, Slack invite, onboarding call, Claude setup, term sheets, podcast logistics, Broke Records meeting, NYC accelerator fall program)
  • strategy: mission-and-vision.md — added "Emerging Ideas (April 2026)" subsection flagging YC for Creators frame, parent entity restructuring, agent org chart product, Jules's potential formal role; added 3 new resonant phrases
  • strategy: customers.md — updated sales pipeline table with Jules agreement timeline, Broke Records intro, and NYC trip details PRs: none (local strategy docs) Notes: Per AGENTS.md rules: nothing from this transcript was treated as a firm decision except the lightweight legal approach for initial signings. All strategic shifts (YC model, warrants, SAFR, parent entity restructuring, agent org chart) are tagged [IDEA] in pmf-journal.md and flagged for human review in static docs. The transcript is a discussion, not a commitment. Key action items with deadlines: advisor agreement (this week), Jules onboarding (Apr 2), Broke Records coffee (Apr 7-8), podcast filming (Apr 22), NYC investor meetings (Apr 23).

[2026-03-31] Deals template — Platform & Shopping Agreement for acquired IP

Prompt: Create a deals directory with a template for signing acquired IP, based on the Gatsby Grace/Rostrum agreement. Iterated through studio model, YC model, and landed on a lightweight "platform + shopping rights" approach. Status: completed Changes:

  • strategy: Created .local/strategy/deals/ directory with 3 files
  • strategy: analysis-gatsby-grace.md — extracted all key concepts, language, and structure from the Rostrum/Recoupable Gatsby Grace agreement
  • strategy: template-ip-partnership.md — v0.2 "Platform & Shopping Agreement." Two things: (1) onboard IP to Recoupable platform for content automation, (2) Recoupable gets exclusive right to shop the IP to upstream partners. Creator keeps ownership. No management obligations. No capital. If a deal lands, Recoupable gets an override and stays as platform provider.
  • strategy: README.md — overview of created IP (Gatsby Grace JV model) vs acquired IP (lightweight platform + shopping model) PRs: none (local strategy docs) Notes: Key strategic insight from iteration: signing external IP and promising to manage it creates obligations Recoupable can't fulfill at this stage (no team, no capital, no bandwidth for artist management). What Recoupable CAN do: automate content and shop the IP. v0.1 was a full 14-section label-style term sheet — too heavy. v0.2 is 8 sections, fits on 1-2 pages. The override % on upstream deals is TBD — needs to be decided per deal. Jules is the key person for actually facilitating upstream partnerships.

Purpose: Handoff notes for the next dev/agent picking up work.

[2026-03-31] Fix template files not loading in production (esbuild __dirname)

Prompt: Debug why artist-bedroom-caption template pipeline produces wrong content via Slack content agent Status: completed Changes:

  • tasks: src/content/loadTemplate.ts — replaced hardcoded __dirname-relative path with resolveTemplatesDir() that tries __dirname first, then falls back to process.cwd()-relative path. esbuild changes __dirname to the build output directory at bundle time, so template files (style guide, caption guide, moods, movements, reference images) were silently failing to load in production. Added diagnostic logging and distinguished ENOENT from parse errors in loadJsonFile. PRs: recoupable/tasks#117 (merged) Notes: Deployed to Trigger.dev production as version 20260331.3. Verified fix: before = bright outdoor portrait ignoring all template rules; after = dark bedroom with purple LED, deadpan expression, proper caption style. Pre-existing SRP violation in loadTemplate.ts (4 exported functions) noted for follow-up PR. The loadTemplate.ts file also has console.log debug lines removed — only logger calls remain for Trigger.dev dashboard visibility.

[2026-03-30] Marketing web: globals.css visual utilities

Prompt: Append noise overlay, glass card, stagger animation delays, and scan lines utilities to globals.css without changing existing rules Status: completed Changes:

  • marketing/apps/web: app/globals.css — appended .noise-overlay, .glass-card, .stagger-1–.stagger-5, .scan-lines (film grain SVG, glassmorphism, CRT-style lines) PRs: none Notes: Use .noise-overlay / .scan-lines on a position: relative container so pseudo-elements layer correctly. Pair .stagger-* with animated elements (e.g. fade-in-up).

[2026-03-30] Marketing: Marquee + FigureLabel components

Prompt: Add brutalist keyword ticker (CSS marquee, inverted fg/bg) and Linear-style FIG labels for marketing web Status: completed Changes:

  • marketing/apps/web: components/home/Marquee.tsx — duplicated keyword row, animate-marquee, monospace + separators, border-y border-(--border), aria-hidden decorative strip
  • marketing/apps/web: components/ui/FigureLabel.tsx — FIG {number}, monospace 10px, tracking-widest, text-(--muted-foreground) + opacity-50, cn() for className PRs: none Notes: Not imported on app/page.tsx yet — add <Marquee /> / <FigureLabel number="0.1" /> where needed. pnpm build from marketing/ passed.

[2026-03-30] Marketing home: VisionOverlay + StatusBar

Prompt: Add two server components from moodboard — B&W HUD bounding box + terminal readout (CSS-only); thin status bar with SYS.STATUS, version, MCP tools; use #c8ff00, animate-blink on green dot, staggered keyframes like AgentChat Status: completed Changes:

  • marketing/apps/web: components/home/VisionOverlay.tsx — 60vh section, gradient “photo” mood, #c8ff00 frame + L-corner brackets, SUBJECT_08X pill, artist placeholder + silhouette SVG, staggered terminal lines + deployment badge
  • marketing/apps/web: components/home/StatusBar.tsx — max-w-7xl row, dividers, monospace 10–11px caps, ONLINE + blinking green dot, version + MCP copy; pnpm build from marketing/ passed PRs: none Notes: Components are not wired into app/page.tsx yet — import when replacing hero/section placeholders.

[2026-03-30] Marketing homepage + header polish

Prompt: Hero border under proof; proof stat text glow; module card min-height + rounded; terminal label brand color + container rounding; segment left border; Blog nav plain link when no dropdown items; mobile nav comment; nav typing for empty learn items Status: completed Changes:

  • marketing/apps/web: app/page.tsx — border-b border-[var(--border)] on hero; proof number drop-shadow-[0_0_30px_rgba(200,255,0,0.3)]; modules min-h-[320px] rounded-lg; terminal eyebrow text-[var(--brand)]; segments border-l-2 border-[var(--brand)]/30 pl-4
  • marketing/apps/web: components/layout/NavDropdown.tsx — if items.length === 0, render a single Link (no empty hover panel)
  • marketing/apps/web: lib/nav.ts — explicit NavSection / NavItem types so learn.items: [] is readonly NavItem[] (fixes /learn page + copy never errors vs as const empty tuple)
  • marketing/apps/web: components/layout/Header.tsx — mobile nav comment aligned to desktop order PRs: none Notes: Terminal.tsx root already has rounded-lg overflow-hidden. /learn index still renders zero cards while nav.learn.items is empty; add fallback links if that page should stay useful.

[2026-03-30] Marketing home: AgentChat + SystemDiagram mockups

Prompt: Add CSS-only product mockups — fake agent chat UI with staggered fade-in; three-node CONNECT/PROCESS/DEPLOY diagram with SVG arrows and brand glow Status: completed Changes:

  • marketing/apps/web: components/home/AgentChat.tsx — macOS chrome, Gatsby Grace sidebar, chat bubbles + 66% progress bar, scoped keyframes + animation-delay classes (no client JS)
  • marketing/apps/web: components/home/SystemDiagram.tsx — 01–03 nodes, horizontal SVG connectors (vertical on mobile), var(--brand) numbers/arrows, color-mix glow shadow PRs: none Notes: pnpm build from marketing/ passed. Wire into app/page.tsx or other sections when replacing placeholders.

[2026-03-30] Marketing homepage: fade-in-up, proof strip, terminal polish

Prompt: Append globals.css utilities (view-timeline fade-in-up, glow-brand); refine Terminal colors and keyword highlighting; soften proof strip; add fade-in-up to major homepage sections Status: completed Changes:

  • marketing/apps/web: app/globals.css — @keyframes fade-in-up, .fade-in-up (animation-timeline view), .glow-brand
  • marketing/apps/web: components/home/Terminal.tsx — base text #e5e5e5, SUCCESS #c8ff00, error/warning tokens #ff9f43, TerminalLine split rendering
  • marketing/apps/web: app/page.tsx — proof section dark bg, yellow stat + glow-brand, brand-tint borders; fade-in-up on proof, modules, terminal, segments, subscribe sections PRs: none Notes: pnpm build from marketing/ passed. Scroll-driven animation needs browsers with animation-timeline: view() support; others show static content.

[2026-03-29] Docs overhaul — full rewrite with positioning and developer experience

Prompt: Rewrite Recoup docs to properly communicate what the product is, inspired by Composio's clear documentation style Status: completed Changes:

  • docs: Rewrote index.mdx — positions Recoup as autonomous music infrastructure with three integration paths (API, MCP, CLI); shows "Who It's For" (Artists, Labels, Developers); uses brand positioning from marketing/content/brand/
  • docs: Rewrote quickstart.mdx — starts with Spotify search (works immediately, no data needed); shows CLI and MCP setup in same page; concise and value-focused
  • docs: Created how-it-works.mdx — explains three layers (Entry Points, Agent Layer, Context Layer); covers agents, sandboxes, data flow, and integration options; "What Makes Recoup Different" comparison table
  • docs: Rewrote cli.mdx — workflow-oriented structure (like Composio CLI docs); content creation workflow as primary path; command summary table at end
  • docs: Rewrote mcp.mdx — config snippets for Claude Desktop, Cursor, VS Code; full tool list (43 tools in 12 categories); usage examples; TypeScript SDK connection
  • docs: Rewrote api-reference/introduction.mdx — developer-focused with base URL, auth, response format, rate limits, and explore cards
  • docs: Created authentication.mdx — unified auth guide covering API keys, MCP Bearer tokens, CLI env vars, org access, and admin auth
  • docs: Restructured docs.json navigation — "Get Started" (Welcome, Quickstart, How It Works, Auth) + "Integrate" (MCP, CLI, Content Agent); updated anchors (Dashboard, API Keys, Website) PRs: Branch feat/docs-overhaul pushed to recoupable/docs — PR targets main Notes: Voice follows marketing/content/brand/voice.md — specific, no-BS, show-don't-tell. Positioning aligned with marketing/content/brand/positioning.md — "Run your music business with agents." Pre-existing broken nav references (admins/check, admins/sandboxes, etc.) were not introduced by this change.

[2026-03-29] CodeRabbit: research POST Zod, playlists popularIndie, skill + CLI fixes

Prompt: Zod inline validation on research POST handlers; popularIndie overridable in playlists handler; recoup-research SKILL angle brackets + YouTube audience vs metrics note; CLI parseInt NaN checks for web/people Status: completed Changes:

  • api: postResearch{Web,Deep,People,Extract,Enrich}Handler.ts — inline Zod body schemas + unified 400 handling; getResearchPlaylistsHandler.ts — popularIndie in explicit filter branch; minimal JSDoc @returns / param fixes where eslint required
  • skills/recoup-research: SKILL.md — replaced --genre <id> pattern; clarified youtube_channel applies to metrics only, audience uses --platform youtube
  • cli: src/commands/research.ts — validate --max-results / --num-results after parseInt (radix 10) PRs: none Notes: Extract full_content is strict boolean in Zod (no string coercion). Enrich schema uses z.record(z.string(), z.unknown()) (object with string keys).

[2026-03-29] MCP research tools: proxy status checks and platform validation

Prompt: After proxyToChartmetric, return tool errors when result.status !== 200; add VALID_PLATFORMS where platform is interpolated; charts tool validates alphanumeric platform (no path injection) Status: completed Changes:

  • api: lib/mcp/tools/research/registerResearch{Artist,Metrics,Audience,Cities,Similar,Playlists,Urls,InstagramPosts,Albums,Tracks,Career,Insights,Milestones,Venues,Rank,Lookup,Track,Playlist,Curator,Discover,Genres,Festivals,Charts,Radio}Tool.ts — status guard before getToolResultSuccess; playlist/track search paths check proxy status too; VALID_PLATFORMS on playlists, playlist info, curator; charts uses /^[a-zA-Z0-9]+$/ on platform PRs: none Notes: Ran eslint --fix on touched files. registerResearchMilestonesTool / registerResearchRankTool still have pre-existing @typescript-eslint/no-explicit-any on parsed bodies.

[2026-03-29] Rename MCP research tool registerTool() names

Prompt: Rename the first argument to server.registerTool() in all 27 research MCP tool files; update descriptions for discography/URLs/tracks overlap with other tools Status: completed Changes:

  • api: lib/mcp/tools/research/registerResearch*.ts — tool IDs now use get_* / lookup_* / discover_* / find_* / extract_* / enrich_* naming; get_artist_tracks description notes get_spotify_artist_top_tracks; albums and URLs descriptions were already aligned with the requested copy PRs: none Notes: JSDoc lines still mention old research_* names in some files; update separately if docs should match registered IDs. Any clients hardcoding old tool names must switch to the new strings.

[2026-03-27] Create research-artist skill

Prompt: Turn artist deep research prompt into a skill for the Recoupable platform, with design thinking about research method, static vs dynamic data, and downstream use Status: completed Changes:

  • skills/research-artist: Created SKILL.md — multi-source research pipeline that works in sandbox (MCP tools + Perplexity deep research) and Cursor/local (WebSearch + last30days). Produces timestamped research report with career-stage assessment, fan personas, competitive white-space, revenue opportunities. Respects artist-workspace static/dynamic context separation.
  • skills/research-artist/references: Created report-template.md (full output template with YAML frontmatter, confidence markers, 8 report sections) and research-queries.md (3 research strategies: Perplexity deep research, multi-query WebSearch, MCP platform APIs) PRs: none — local skill creation Notes: Key design decisions: (1) Uses web_deep_research MCP tool (Perplexity sonar-deep-research) as the ChatGPT deep research replacement in sandbox. (2) Static context (artist.md, audience.md) is created but never blindly overwritten — suggests updates for human review. (3) Dynamic context (research report) is timestamped in research/. (4) Optionally chains with last30days skill for Reddit/X social pulse. (5) Structured output with confidence markers ([confirmed], [estimated], [inferred], [gap]) so downstream agents know what to trust.

[2026-03-26] Web-researched artist.md profiles for all 44 rostrum artists

Prompt: Do deep web research on every artist in the rostrum directory and create artist.md profiles Status: completed Changes:

  • rostrum/artists: Created context/artist.md for all 42 artists that were missing profiles (Alé Araya + Gatsby Grace already had them)
  • Each profile built from 2-3 web searches per artist with real biographical data, genre descriptions, aesthetic direction, brand voice, and sacred rules
  • Profiles cover: 7 hip-hop legends (Mac Miller, Wiz Khalifa, Jeezy, Raekwon, Mobb Deep, Sean Price, Smif-N-Wessun), 7 hip-hop artists (DC The Don, Jae Skeese, THE REAL RYU, Natural Elements, YUNGMORPHEUS, Like, Chip Fu), 7 labels/entities (Rostrum Records, Fat Beats, Cantora Records, Javotti Media, Spaceheater, Soul In The Horn, Murdermart), 7 emerging artists (Julius Black, Gliiico, Amxxr, Baro Sura, Neek, Nicole Bus, Niko Is), 7 bands/artists (Bear Hands, El Michels Affair, MGMT, Mod Sun, Theo Croker, TeamMate, Henri), 6 artists (Goosebytheway, Jada, Mike Taylor, No Love for the Middle Child, Rashad Thomas, Solene) PRs: none — pushed directly to rostrum repo main Notes: Two artists have thinner profiles due to limited public information: Neek (multiple "Neek" artists exist, couldn't confirm which one) and Jada (no public info found confirming which "Jada" is on Rostrum). These should be enriched when the label provides details. THE REAL RYU has two directories (the-real-ryu and the-real-ryu-19447895) — both received identical profiles. TeamMate correction: they're former romantic partners (not brother-sister as initially thought). 43 files, 3,558 lines of real research-backed content.

[2026-03-25] Purge YAGNI scaffolding from rostrum artists

Prompt: Follow setup-artist skill and remove all unneeded scaffolding files/folders from rostrum artist directories (except gatsby-grace) Status: completed Changes:

  • rostrum/artists: Deleted scaffolding from 43 artist directories — removed .env.example, README.md, apps/, config/, content/, memory/, placeholder context/ files (template artist.md, audience.md, era.json, tasks.md, images/README.md), releases/README.md, songs/README.md, and empty directories
  • rostrum/artists: Cleaned RECOUP.md body text for all 43 artists (kept frontmatter only, matching gatsby-grace format)
  • 38 artists now have only RECOUP.md; 5 artists retain real content alongside RECOUP.md (fat-beats: social-reports + weekly dashboard; gliiico: spotify tracking CSV; julius-black: tiktok tracking + snapshot; mac-miller: weekly news; spaceheater: competitor analysis report)
  • gatsby-grace left untouched (already follows the new skill structure) PRs: none — changes are local in .local/records/rostrum/ Notes: Per the setup-artist skill: "Nothing gets created until there's real content to put in it." All deleted files were empty scaffolding or placeholder templates with {curly brace tokens}. Real content files (tracking CSVs, reports, analysis) were preserved. When an artist gets real context, create context/artist.md and other files per the setup-artist skill.

[2026-03-25] Song filtering for content creation pipeline

Prompt: Add optional songs array to content creation payload so the pipeline can restrict which songs it picks from Status: completed Changes:

  • tasks: Added songs field to createContentPayloadSchema, filtering logic in selectAudioClip, pass-through in createContentTask
  • api: Added songs to Zod validation (validateCreateContentBody), handler (createContentHandler), and trigger interface (triggerCreateContent)
  • docs: Added songs property to ContentCreateRequest schema in openapi.json
  • cli: Added --songs <slugs> comma-separated flag to recoup content create command PRs:
  • recoupable/tasks#112 (base: main)
  • recoupable/api#348 (base: test)
  • recoupable/docs#80 (base: main)
  • recoupable/cli#19 (base: main) Notes: Backward compatible — when songs is omitted, all songs remain eligible. Song slugs match filenames without extension (e.g. hiccups for hiccups.mp3). The caller (chat agent, Slack bot, CLI) is responsible for resolving user intent into song slugs. All existing tests pass (183 tasks, 1553 api).

[2026-03-25] YAGNI setup-artist skill + consolidate Gatsby Grace

Prompt: Simplify the setup-artist skill and consolidate three gatsby-grace directories into one Status: completed Changes:

  • skills/setup-artist: Rewrote SKILL.md (178→120 lines, 9→5 steps, 10→2 directories). Deleted all 6 reference files (memory-system.md, services-guide.md, env-template.md, directory-readmes.md, root-readme.md, context-files.md). Skill now only creates context/ and songs/ — other directories created by other skills when needed.
  • rostrum/gatsby-grace: Consolidated data from 3 directories. Merged filled artist.md (from local) + brand.md content. Replaced placeholder audience.md with filled version (from old). Copied 17 songs with proper {slug}.mp3 naming + wav + lyrics.json + clips.json. Renamed library/ → research/. Dropped stale reports/. Deleted all scaffolding (memory/, config/, content/, apps/, era.json, tasks.md, .env.example, 8 READMEs). Updated RECOUP.md with minimal "What's Here" + "Adding Things" guidance. PRs: none yet — changes are local, need to commit and push to rostrum repo and skills repo Notes: The tasks content pipeline only reads context/artist.md, context/audience.md, context/images/face-guide.png, and songs/*.mp3 via GitHub API. No per-artist config needed — pipeline uses hardcoded defaults. Song naming matters: pipeline derives title from filename, so {slug}.mp3 not audio.mp3. Old gatsby-grace directories (.local/records/artists/gatsby-grace and gatsby-grace-old) can be deleted after verifying pipeline works. Other rostrum artists still have the old bloated scaffolding — migrate separately.

[2026-03-25] Round 5 lint + KISS fixes for PR #342 (REC-7)

Prompt: Fix the failing checks on PR #342 Status: completed Changes:

  • api: Deleted lib/coding-agent/getThread.ts wrapper (KISS nit from code reviewer) — callers now import getThread directly from lib/agents/getThread with type parameter
  • api: Fixed unused message parameter lint error in registerOnNewMention.ts
  • api: Updated test mocks to match new import paths PRs: recoupable/api#342 (commit 694f201) Notes: All CI checks (test, format, CodeRabbit, Vercel) were already passing. These fixes address the last code review nit and lint cleanliness. 6 files changed, 9 ins, 19 del.

[2026-03-25] Round 2 review fixes for PR #342 (REC-7)

Prompt: Address new board + CodeRabbit feedback on content-agent PR #342 Status: completed Changes:

  • api: SRP — split validateEnv.ts into isContentAgentConfigured.ts + validateContentAgentEnv.ts
  • api: KISS — refactored bot.ts to eager singleton variable matching coding-agent pattern
  • api: KISS — refactored registerHandlers.ts to module-level side-effect registration (removed flag)
  • api: DRY — extracted shared getThread to lib/agents/getThread.ts (both agents use it)
  • api: CodeRabbit — added Zod platform validation + JSON error responses in createPlatformRoutes.ts PRs: recoupable/api#342 (commit 2abed88) Notes: 10 files changed, 60 ins / 65 del. Bot init DRY question addressed: both agents already share createAgentState + agentLogger; remaining adapter config differs per agent so further abstraction would violate KISS. Awaiting Code Reviewer re-review.

[2026-03-25] TDD mandate for SR Dev — API & Tasks (REC-11)

Prompt: Update SR Dev AGENTS.md to mandate TDD red-green-refactor for API and Tasks codebases Status: completed Changes:

  • agents/sr-dev/AGENTS.md: Added "Test-Driven Development (API & Tasks)" section mandating strict red-green-refactor cycle for all work in api and tasks codebases PRs: none (local instruction change) Notes: SR Dev must now write failing tests before any production code in api or tasks. Includes rules for bug fixes (reproduce first) and commit-per-phase guidance.

[2026-03-25] CLEAN code review fixes for PR #342 (REC-7)

Prompt: Address 7 board feedback items on PR #342 (YAGNI, SRP, DRY, KISS, restructure) Status: completed Changes:

  • api: Removed unused /api/launch endpoint and lib/launch/ (YAGNI)
  • api: Extracted parseMentionArgs to own file, renamed handler → registerOnNewMention.ts (SRP)
  • api: Created shared lib/agents/createPlatformRoutes.ts factory used by both coding-agent and content-agent (DRY)
  • api: Created shared lib/agents/createAgentState.ts for Redis/ioredis state (DRY)
  • api: Moved callback auth into handler to match coding-agent pattern (KISS)
  • api: Restructured lib/content-agent/ → lib/agents/content/ PRs: recoupable/api#342 Notes: 21 files changed, 206 ins, 511 del. Awaiting Code Reviewer re-review.

[2026-03-25] QA Test PR #342 — content-agent & launch endpoints (REC-7)

Prompt: Test the changes in PR #342 against Vercel deployment preview Status: completed Changes:

  • none (testing only) PRs: none Notes: Initial test run (11 cases) found 5 failures — content-agent endpoints returned 500 due to missing env vars crashing getContentAgentBot(). Sr Dev fixed with isContentAgentConfigured() guard and moved auth before bot init (commit 9da3aef). Re-test: all 11 cases pass. Results posted on GitHub PR #342 and Slack #code-review thread. Task marked done.

[2026-03-25] Hire QA Tester agent (REC-10)

Prompt: Create a QA Tester agent that tests API PRs by running fetch requests against Vercel deployment previews Status: completed Changes:

  • mono: Created agents/qa-tester/AGENTS.md — full instructions for deployment preview testing, endpoint discovery from PR diffs, structured test reporting
  • mono: Updated agents/code-reviewer/AGENTS.md — added QA Tester Integration section (trigger QA Tester after approving API PRs)
  • mono: Updated agents/sr-dev/AGENTS.md — added QA Tester Feedback section (handle test failure reports)
  • Paperclip: Submitted hire request for QA Tester agent (f4d6bc75-b9ea-4fca-a456-4b889548ad83, claude-sonnet-4-6, reports to CTO) PRs: none (local instruction changes) Notes: Approval granted (d2fcb05e). Agent ID: f4d6bc75-b9ea-4fca-a456-4b889548ad83, urlKey: qa-tester. Agent workflow: Code Reviewer approves API PR → @-mentions QA Tester → QA Tester runs fetch tests against Vercel preview → reports on GitHub PR + Slack → routes failures to Sr Dev.

[2026-03-24] API — review PR #342 (REC-7)

Prompt: Review clean PR #342 (superseding #341) for content-agent feature, identify Vercel build failure cause Status: completed Changes:

  • none (review only) PRs: recoupable/api#342 (approved after 1 review cycle) Notes: Initial review found 2 blocking issues: (1) module-level env validation crashed Vercel build, (2) fragile thread ID parsing. Sr Dev fixed both (commit 5ca4293). Re-review confirmed fixes + all CI checks pass (test, format, Vercel). PR approved and ready to merge. Slack thread updated.

[2026-03-24] Connect Code Reviewer and Sr Dev review loop (REC-9)

Prompt: Set up automated review loop between Sr Dev and Code Reviewer agents Status: completed Changes:

  • agents/code-reviewer/AGENTS.md: Added "Review Loop with Sr Dev" section — when @-mentioned by Sr Dev, review the PR; if changes needed, @-mention Sr Dev back; if approved, @-mention Sr Dev and close
  • agents/sr-dev/AGENTS.md: Added "Review Loop with Code Reviewer" section — after creating/updating a PR, @-mention Code Reviewer; when feedback arrives, fix and @-mention again; loop until approved PRs: none (local instruction changes) Notes: Both agents now have symmetric handoff instructions. The loop uses Paperclip @-mentions to trigger heartbeats. Sr Dev starts the cycle by @-mentioning Code Reviewer after pushing a PR. Code Reviewer closes the cycle by @-mentioning Sr Dev with approval/feedback.

[2026-03-24] API — fix PR #341 review feedback (REC-7)

Prompt: Fix code review feedback on content-agent PR #341 Status: completed Changes:

  • api: Created clean branch fix/content-agent-clean from test with only 17 new feature files (removed ~90 JSDoc-only changes)
  • api: Renamed handlers/handleContentAgentCallback.ts → registerOnSubscribedMessage.ts (naming collision fix)
  • api: Added crypto.timingSafeEqual for callback secret comparison in handleContentAgentCallback.ts
  • api: Fixed all JSDoc lint errors in new feature files PRs: recoupable/api#342 (supersedes #341) Notes: Old PR #341 had 106 files changed (90 unrelated JSDoc noise). New PR #342 has only 17 files. Posted update to Slack thread and commented on #341. Task reassigned to board for review.

[2026-03-24] API — review PR #341 (REC-7)

Prompt: Review PR recoupable/api#341 and provide feedback Status: completed Changes:

  • none (review only) PRs: recoupable/api#341 (reviewed, request changes) Notes: PR adds Recoup Content Agent Slack bot + /api/launch endpoint. Verdict: request changes. Blocking issue: ~90 unrelated JSDoc-only changes inflate PR from ~16 new feature files to 106. Feature code itself is clean. Also flagged naming collision between two handleContentAgentCallback files and suggested crypto.timingSafeEqual for callback secret. Review comment: recoupable/api#341 (comment)

[2026-03-24] Docs — fix PR #78 feedback (REC-6)

Prompt: Fix feedback comments on docs PR #78 and update Slack thread Status: completed Changes:

  • docs: Linked POST /api/content-agent/callback to its API reference page in data flow and endpoints table
  • docs: Added missing RECOUP_API_KEY to environment variables table PRs: recoupable/docs#78 (updated, commit 2149b60) Notes: Posted summary to #code-review Slack thread. PR still open for review.

[2026-03-24] Code Reviewer agent created (REC-4)

Prompt: Create a new agent to review unmerged PRs in Recoup mono repo submodules Status: completed Changes:

  • Paperclip: Created "Code Reviewer" agent (QA role, claude-sonnet-4-6, reports to CTO)
  • Agent ID: 8dec924a-7c20-4280-985d-f3ea996e0c4e (urlKey: code-reviewer-2)
  • Approval: d2fbd753 (approved after revision to add CLEAN code principles)
  • mono: Created agents/code-reviewer/AGENTS.md with review instructions (SRP, OCP, DRY, YAGNI, security checklist)
  • Set instructions path via API PRs: none (instructions file created locally, not yet committed) Notes: Agent is idle and ready for tasks. First revision was requested by board to emphasize CLEAN coding principles — incorporated into capabilities and instructions. Old agent 815e3d4f (Code Reviewer 1) was from the rejected first hire attempt.

[2026-03-24] Recoup Content Agent scaffold

Prompt: Scaffold the content-agent Slack bot following the coding-agent pattern Status: completed Changes:

  • api: Added content-agent Slack bot (routes, handlers, bot singleton, callback) on feature/content-agent branch
  • tasks: Added poll-content-run Trigger.dev task on feature/content-agent branch PRs: Branches pushed — PRs need to be created manually (api → test, tasks → main) Notes: New env vars needed: SLACK_CONTENT_BOT_TOKEN, SLACK_CONTENT_SIGNING_SECRET, CONTENT_AGENT_CALLBACK_SECRET. Also needs RECOUP_API_BASE_URL in tasks env. Slack App must be created with app_mentions:read + chat:write scopes.

Current State of Each Submodule

tasks (on main)

Latest commits:

  • fad189e fix: push mono repo root progress files directly to main (#96)
  • e2599e7 fix: set cwd to /vercel/sandbox/mono for Claude Code agent (#94)
  • 70f345c feat: increase maxDuration of coding-agent task (#89)
  • 6625395 feat: inject CLAUDE_CODE_OAUTH_TOKEN into sandbox environment (#86)

Status: Stable. The coding agent pipeline is working end-to-end:

  1. Sandbox spins up → monorepo cloned → submodules synced
  2. Claude Code agent runs with the user prompt (cwd = /vercel/sandbox/mono)
  3. Changes are committed and PRs opened via pushAndCreatePRsViaAgent
  4. Mono repo root files (e.g., PROGRESS.md) are pushed directly to main

What to know: runClaudeCodeAgent now defaults cwd to /vercel/sandbox/mono. The pushAndCreatePRsViaAgent agent handles both mono root changes (direct push to main) and submodule changes (feature branch + PR).

api (on test)

Latest commits:

  • 6ff735d feat: add Slack chat bot integration for Record Label Agent (#296)
  • f1d9035 feat: add content-creation API endpoints and video persistence (#259)
  • 5b1f6bc feat: admin accounts table endpoint (#288)
  • 6c5eda3 feat: endpoint to check if authenticated account is admin (#281)

Status: Stable on test. PRs target test branch, not main.

What to know: Slack integration added for Record Label Agent. Content-creation endpoints live. Admin-check endpoint added.

chat (on test)

Latest commits:

  • 03714296 feat: add navbar item for accounts (#1574)
  • 729a9062 feat: task page top-left back link (#1573)
  • 6efe316d fix: duration stuck at 0ms for in-progress tasks (#1572)
  • eaeb5799 feat: polling UI for prompt_sandbox when runId present (#1563)
  • c3611b31 feat: move pulse to tasks page as Schedule/Recent/Pulse tabs (#1561)
  • c7fb2744 feat: artist connectors UI with tabbed settings modal (#1558)

Status: Stable on test. PRs target test branch.

What to know: Tasks page has been significantly built out — duration display, polling UI for sandbox runs, and pulse moved to tabs. Navbar now has accounts link.

cli (on main, v0.1.11)

Latest commits:

  • a09929a chore: bump version to 0.1.11
  • e4d4548 feat: add recoup content command suite (#13)
  • 07e2b85 feat: add music analyze command (#7)
  • 056257a feat: add --account flag to notifications command (#12)

Status: Stable. Published to npm as 0.1.11.

What to know: recoup content command suite added. music analyze command added. Version auto-bumped via CI.

docs (on main, feature branch feat/mcp-docs-full-tool-list open)

Latest commits:

  • 05c455c docs: improve user journey — navigation, quickstart, MCP client configs
  • e083670 docs: expand MCP page with full tool list and docs search MCP explanation
  • fd82b14 feat: add authentication page (#62)

Status: Feature branch feat/mcp-docs-full-tool-list pushed, PR needs to be opened against main.

What changed (2026-03-24 user journey improvements):

  • Navigation order fixed: Authentication now comes before MCP in sidebar
  • Homepage (index.mdx): integration path cards (REST/MCP/CLI), clearer "what you can build" framing
  • Quickstart (quickstart.mdx): new first example uses Spotify search (works immediately, no existing data needed); Tasks list removed as first example
  • MCP page (mcp.mdx): ready-to-paste config snippets for Claude Desktop, Cursor, and VS Code added before TypeScript SDK
  • API reference intro (api-reference/introduction.mdx): stripped duplicate auth/base URL content, now links to auth guide

admin (on main)

Latest commits:

  • 3fcd006 feat: update favicon to match app (#6)
  • 11b64e2 feat: accounts table with subscription status (#5)
  • 5dd9571 feat: endpoint to check if account is admin (#3)
  • 47295e8 feat: Privy login support (#2)
  • b53363f feat: initial Next.js app setup (#1)

Status: Stable. Basic admin dashboard with Privy auth, accounts table, admin check, and new Org Repos commits table.

What to know: Added /sandboxes/orgs page showing a data table of commits per org sub-module. Key column is "Recent Commits" (latest_commit_messages array) showing up to 5 latest commit messages per repo. Data from GET /api/admins/sandboxes/orgs. New files: types/sandbox.ts (OrgRepoRow), lib/fetchAdminSandboxOrgs.ts, hooks/useAdminSandboxOrgs.ts, components/SandboxOrgs/*, app/sandboxes/orgs/page.tsx, components/Home/OrgReposNavButton.tsx. Nav button added to AdminDashboard.

[2026-03-25] marketing: Clarify deployment domain and two-app structure in AGENTS.md

Prompt: Apply code review feedback on branch agent/-u0ajm7x8fbr-update-or-codebas-1774058502626 — answer Sweets' questions: what domain does marketing deploy to, and why are there multiple apps? Status: completed Changes:

  • marketing: Updated AGENTS.md — Deployment section now explicitly states public site deploys to https://recoupable.com. Added new "Why Two Apps?" section explaining apps/web (public site, SEO, blog) vs apps/ops (internal marketing ops tooling, private workflows). Pushed to existing branch. PRs: Branch agent/-u0ajm7x8fbr-update-or-codebas-1774058502626 pushed to recoupable/marketing — PR targets main Notes: The marketing repo was already on this feature branch. AGENTS.md is symlinked as CLAUDE.md — both updated together automatically.

[2026-03-24] chat: implement PR review feedback — streamdown plugins

Prompt: Implement PR review comments on recoupable/chat#1592 (streamdown v1→v2 upgrade) Status: completed Changes:

  • chat: Installed @streamdown/code@1.1.1, @streamdown/math@1.0.2, @streamdown/mermaid@1.0.2.
  • chat: Updated components/ai-elements/response.tsx to import and pass plugins={{ code, math, mermaid }} to <Streamdown>. defaultPlugins defined as module-level constant for stable reference.
  • chat: Added @source directives in app/globals.css for the three new plugin packages so Tailwind scans their classes. PRs: recoupable/chat#1592 (branch agent/-u0ajm7x8fbr-update-chat-to-th-1774075858898) Notes:
  • P1 bot review resolved: streamdown v2 moved code highlighting, math, and mermaid behind optional plugins — without them, code blocks had no syntax highlighting and mermaid/math wouldn't render.
  • katex/dist/katex.min.css was already imported in globals.css — math CSS was pre-existing.

[2026-03-24] Code Review — chat: streamdown v1→v2 upgrade

Prompt: Code review for branch agent/-u0ajm7x8fbr-update-chat-to-th-1774075858898 (streamdown v1.1.6 → v2.5.0) Status: completed — no fixes needed, changes are correct Changes:

  • chat: Reviewed 3-file diff: package.json (version bump), app/globals.css (@source glob), pnpm-lock.yaml. PRs: Branch agent/-u0ajm7x8fbr-update-chat-to-th-1774075858898 — PR needs to be opened targeting test. Notes:
  • @source dist/*.js glob is the official v2 recommendation (v2 splits classes across 4 files vs 1 in v1).
  • Streamdown component API is backward compatible — className, children, components, rehypePlugins, remarkPlugins all still present.
  • data-streamdown='code-block' CSS selectors in response.tsx still valid in v2 (confirmed in chunk-BO2N2NFS.js).
  • v2 ships streamdown/styles.css with animation keyframes — not imported, not needed unless animated prop is used.

[2026-03-20] Fix Chartmetric Proxy Route TypeScript Build Error

Prompt: Verify the build works on feature/chartmetric-proxy branch Status: completed Changes:

  • api: Fixed app/api/chartmetric/[...path]/route.ts — params must be Promise<{path: string[]}> and awaited in Next.js 15+. The type error .next/types/validator.ts TS2344 is now resolved. TypeScript compiles successfully (✓ Compiled successfully). All 5 Chartmetric tests pass. PRs: recoupable/api#318 (feature/chartmetric-proxy → test, existing PR updated) Notes: Build still fails at "collect page data" step due to missing SUPABASE_URL/SUPABASE_KEY env vars in sandbox — pre-existing environment issue, not from our changes. TypeScript itself is clean for the new code.

[2026-03-16] Account Task Runs Page + Pulse Sub-Task Tagging

Prompt: Admin page to view recent Pulse task runs for a specific account (e.g., "What Pulse emails has Alexis received in the past 7 days?") Status: completed Changes:

  • tasks: Created sendPulseTask sub-task (src/tasks/sendPulseTask.ts). sendPulsesTask now calls sendPulseTask.triggerAndWait(..., { tags: ['account:<id>'] }) per account so each run is queryable by account.
  • api: Updated validateGetTaskRunQuery.ts to accept optional account_id query param. Admins (Bearer) can query any account; org API keys can query org members. New supabase fn selectAllAccountSnapshotsWithOwners returns {account_id, github_repo}[]. buildSubmoduleRepoMap now returns AccountRepoEntry[] with account_id. getOrgRepoStats + getAdminSandboxOrgsHandler enriched to include email in account_repos.
  • docs: openapi.json — added account_id param to GET /api/tasks/runs, updated OrgRepoRow.account_repos schema to {account_id, email, repo_url}[].
  • admin: New /accounts/[account_id] page with AccountDetailPage + TaskRunsTable showing Pulse runs. AccountReposList updated — each entry shows clickable email → /accounts/[id]. sandboxesColumns — account email is now a clickable link to /accounts/[id]. PRs: Branches pushed, PRs need to be created manually (gh not available in sandbox):
  • tasks: feature/pulse-sub-task-account-tag
  • api: feature/task-runs-account-id-param (target: test)
  • docs: feature/task-runs-account-id-param
  • admin: feature/account-task-runs-page Notes: To answer "What Pulse emails has Alexis received?": find Alexis's account_id via /sandboxes page (or /sandboxes/orgs), then go to /accounts/<id> — the page shows all send-pulse-task runs for that account with status and timestamps.

[2026-03-16] Pulse Run onClick — Email HTML Preview

Prompt: On /accounts/[account_id], clicking a send-pulse-task row should show the Resend email HTML sent during that task run. Status: completed Changes:

  • api: New lib/supabase/memory_emails/selectAccountEmailIds.ts — joins rooms → memories → memory_emails to get Resend email IDs for an account. New lib/admins/emails/getAdminEmailsHandler.ts + app/api/admins/emails/route.ts — GET /api/admins/emails?account_id=<id> fetches each email from Resend SDK (returns id, subject, to, from, html, created_at). Admin Bearer auth required.
  • admin: TaskRunsTable — added optional onRunClick prop; rows show cursor-pointer when clickable. AccountDetailPage — tracks selectedRun state, passes onRunClick to pulse runs table. New PulseEmailModal — fetches all emails for the account via usePulseEmails, matches the email closest to the run's time window (±5 min buffer), renders HTML in a sandboxed iframe. New usePulseEmails hook (lazy, enabled only when modal opens). New fetchAccountPulseEmails lib function. PRs: Branches pushed, PRs need to be created manually:
  • api: feature/admin-pulse-email-preview (target: test)
  • admin: feature/pulse-email-preview (target: main) Notes: Email matching uses the run's startedAt/finishedAt window ±5 min. Falls back to the most recent email for the account if no match. The memory_emails table is the link — emails only appear here if handleSendEmailToolOutputs was called after the pulse (i.e., the sandbox chat flow ran through the standard chat handler). If pulse emails aren't showing, check that memory_emails rows are being inserted for pulse runs.

[2026-03-17] Admin README — API Calls Documentation

Prompt: Update the Admin README to highlight the API calls used and link to the docs where devs can learn more. Status: completed Changes:

  • admin: Rewrote README.md — added "API Calls" section with a table of all 5 endpoints (/api/admins, /api/admins/emails, /api/admins/sandboxes, /api/admins/sandboxes/orgs, /api/tasks/runs), doc links to developers.recoupable.com, and a "Where each call is made" breakdown per hook/lib file. Also updated Tech Stack section to include Privy and TanStack React Query. PRs: none (README-only change) Notes: Doc links point to https://developers.recoupable.com/api-reference/admins/* and .../tasks/runs. All admin endpoints require Bearer auth (Privy access token).

[2026-03-17] Admin Privy Logins Page

Prompt: Admin dashboard page to review Privy logins on a daily, weekly, and monthly basis — total count + table of results per time frame. Status: completed Changes:

  • docs: Added GET /api/admins/privy to openapi.json (path + PrivyLoginRow / AdminPrivyLoginsResponse schemas), new api-reference/admins/privy.mdx, updated docs.json nav.
  • api: New lib/admins/privy/fetchPrivyLogins.ts — paginates Privy Management API, stops early once users are older than the cutoff. New validateGetPrivyLoginsQuery.ts (period: daily/weekly/monthly, default daily). New getPrivyLoginsHandler.ts. New app/api/admins/privy/route.ts. 11 unit tests, all green.
  • admin: New types/privy.ts, lib/recoup/fetchPrivyLogins.ts, hooks/usePrivyLogins.ts. New /privy page with period toggle (Daily/Weekly/Monthly), total count badge, and login table (email, Privy DID, timestamp). Added "View Privy Logins" nav button to AdminDashboard. PRs: Branches pushed — PRs need to be opened via GitHub:
  • docs: feature/admin-privy-logins-docs → main: https://github.com/recoupable/docs/pull/new/feature/admin-privy-logins-docs
  • api: feature/admin-privy-logins → test: https://github.com/recoupable/api/pull/new/feature/admin-privy-logins
  • admin: feature/privy-logins-page → main: https://github.com/recoupable/admin/pull/new/feature/privy-logins-page Notes: fetchPrivyLogins paginates GET https://api.privy.io/v1/users?order=desc and stops early once created_at < cutoff. This keeps the daily call fast (only fetches recent pages). If Privy returns users without linked_accounts email, the row shows null for email.

[2026-03-17] API — Remove Org API Key Logic (All Keys Are Personal)

Prompt: All API keys are personal. If a personal account has access to an org, it can use account_id filtering within that org. Remove the distinction between personal and org API keys for access control. Status: completed Changes:

  • api: New lib/organizations/canAccessAccountViaAnyOrg.ts — checks if two accounts share any org membership (2 DB queries: get current account's orgs, then check if target is in any of them). New lib/organizations/__tests__/canAccessAccountViaAnyOrg.test.ts (4 tests). Updated lib/auth/validateAccountIdOverride.ts — when orgId is null (personal key) and target ≠ self, falls back to canAccessAccountViaAnyOrg() instead of immediately returning 403. Updated lib/auth/__tests__/validateAuthContext.test.ts — updated "denies personal key" test to mock the new function, added "allows personal key with shared org" test. All 1526 tests pass. PRs: Branch agent/remove-org-api-key-logic pushed to recoupable/api (target: test):
  • https://github.com/recoupable/api/pull/new/agent/remove-org-api-key-logic Notes: Only validateAccountIdOverride.ts was changed in auth. The buildGet*Params functions that receive orgId from auth context don't need changes — when a personal key accesses via shared org, orgId in the auth context stays null, and the query params builders already handle orgId: null by not filtering on org. The access gate is purely in validateAccountIdOverride.

[2026-03-24] Docs — MCP Page Rewrite (Full Tool List + Docs Search MCP)

Prompt: Document both MCP servers in docs: (1) the Mintlify docs search MCP and (2) the Recoup API MCP with a full list of all tools. Status: completed Changes:

  • docs: Rewrote mcp.mdx — now explains both servers (Mintlify docs search MCP via contextual menu, and the Recoup API MCP at https://recoup-api.vercel.app/mcp). Documents all 44 tools grouped by category (Artists, Chats, Tasks, Pulses, Catalogs, Spotify, YouTube, Search, Images, Video, Audio, Files, Communication, Segments, Sandboxes, Utilities). Removed outdated run_sandbox_command entry (tool doesn't exist). Added connection snippet and two call examples. PRs: Branch feat/mcp-docs-full-tool-list pushed — open PR via: https://github.com/recoupable/docs/pull/new/feat/mcp-docs-full-tool-list Notes: Tool list was derived from all register*Tool.ts files in api/lib/mcp/tools/. The run_sandbox_command in the old mcp.mdx was stale — no such tool is registered. If new tools are added to the API, update this page.

[2026-03-26] Song Filtering for Content Creation Pipeline

Prompt: Add optional songs array to content creation payload so callers can restrict clip selection to specific songs (e.g., for an EP, a single, or a named album track). Status: completed Changes:

  • tasks: src/schemas/contentCreationSchema.ts — added songs: z.array(z.string()).optional(). src/content/selectAudioClip.ts — filters songPaths by slug before random pick; throws clear error if none found. src/tasks/createContentTask.ts — passes payload.songs to selectAudioClip. New src/content/__tests__/selectAudioClip.test.ts — 4 tests covering filter-to-one, filter-to-many, missing-song error, and no-filter (all-songs) cases. src/schemas/__tests__/contentCreationSchema.test.ts — 2 new tests for songs field.
  • api: lib/trigger/triggerCreateContent.ts — added songs?: string[] to TriggerCreateContentPayload. PRs: gh not available in sandbox — PRs need to be opened via GitHub:
  • tasks: feature/song-filtering-for-content-pipeline → main: https://github.com/recoupable/tasks/pull/new/feature/song-filtering-for-content-pipeline
  • api: changes committed to test branch directly (was already on test with many staged changes) Notes: Filtering is path-based: path.includes('/songs/${slug}/'). Callers (Slack bot, chat agent) are responsible for translating user intent (e.g., "ADHD EP") into song slugs before passing to the task. When songs is omitted, all songs remain eligible (backward-compatible).

[2026-03-26] Artist profile creation — 6 Rostrum artists

Prompt: Create context/artist.md profiles for 6 Rostrum artists using web research Status: completed (5 full profiles, 1 placeholder) Changes:

  • rostrum/artists: Created context/artist.md for goosebytheway (Drumwork/Conway the Machine rapper, Buffalo), mike-taylor (Philly pop-soul, "Feel Good" EP), no-love-for-the-middle-child (Andrew Migliore, multi-instrumentalist producer-artist), rashad-thomas (Columbus producer/rapper, "I Was Told There'd Be Gold" via Fat Beats), solene (cyber jazz pioneer, "Mother of Cyber Jazz", minthaze collaborator)
  • rostrum/artists: Created placeholder context/artist.md for jada — no public information found linking any "Jada" artist to Rostrum Records; profile marked for update when label provides details PRs: none — changes are local in .local/records/rostrum/ Notes: Jada is the only artist with insufficient research results. Multiple search variations tried (Jada rapper, Jada musician Rostrum, Jada hip hop, etc.) — found Jada Kingdom (Republic Records), Jada Lee (Philly independent), and JADA (East London) but none confirmed on Rostrum. Profile written as honest placeholder rather than fabricated content. All other profiles built from confirmed web sources with real proof points.

[2026-03-26] Artist Profile Creation — 7 Rostrum Artists

Prompt: Create context/artist.md profiles for 7 Rostrum Records artists using web research and the established template format Status: completed Changes:

  • rostrum/artists: Created context/artist.md for mac-miller (legacy, deceased 2018), wiz-khalifa (Rostrum flagship), jeezy (trap pioneer), raekwon (Wu-Tang/mafioso rap), mobb-deep (Queensbridge duo, Prodigy deceased 2017), sean-price (Boot Camp Clik, deceased 2015), smif-n-wessun (Boot Camp Clik duo)
  • All 7 profiles follow the established template format (matching ale-araya's structure): personality, topics, genre, comparables, positioning, aesthetic, mood, colors, settings, fashion, voice, tone, sacred rules, avoid
  • Each profile built from web research with real biographical data, chart positions, album details, and cultural context — no placeholders or fabricated details PRs: none — changes are local in .local/records/rostrum/ Notes: Three of the seven artists are legacy/catalog acts (Mac Miller d. 2018, Prodigy/Mobb Deep d. 2017, Sean Price d. 2015). Profiles for deceased artists are written to guide catalog/legacy content management. All profiles include extra sections (Signature Elements, Visual References) only when real information was available.

[2026-03-29] Add 5 new research endpoints across all layers

Prompt: Create milestones, venues, rank, charts, and radio research endpoints across API, MCP, docs, and CLI Status: completed Changes:

  • api: Created 5 handler files (lib/research/getResearch{Milestones,Venues,Rank,Charts,Radio}Handler.ts) — milestones/venues/rank use handleArtistResearch pattern, charts/radio use non-artist direct proxy pattern
  • api: Created 5 route files (app/api/research/{milestones,venues,rank,charts,radio}/route.ts)
  • api: Created 5 MCP tool files (lib/mcp/tools/research/registerResearch{Milestones,Venues,Rank,Charts,Radio}Tool.ts) and updated index.ts to register all 5
  • docs: Added 5 paths + 5 response schemas to openapi.json, created 5 MDX files, updated docs.json navigation, added CLI docs to cli.mdx
  • cli: Added 5 commands to src/commands/research.ts (milestones, venues, rank, charts, radio) with examples and help text PRs: none yet — changes on existing feature branches Notes: Artist-scoped endpoints (milestones, venues, rank) use handleArtistResearch shared handler. Non-artist endpoints (charts, radio) follow the genres/festivals pattern (auth + deductCredits + proxyToChartmetric). Charts requires --platform flag; radio has no params. All lint-clean.

[2026-03-29] Fix response normalization in research handlers

Prompt: Fix array-spreading bug in all research handlers — when Chartmetric returns an array as obj, the spread operator produces { "0": item, "1": item } instead of wrapping under a named key Status: completed Changes:

  • api: Added transformResponse to 8 artist handlers via handleArtistResearch(): albums→{albums}, tracks→{tracks}, insights→{insights}, career→{career}, similar→{artists, total}, playlists→{placements}, cities→transforms city map to sorted array {cities}, urls→{urls}
  • api: Fixed 3 non-artist handlers (genres, festivals, discover) that manually spread result.data — replaced with named-key wrapping: {genres}, {festivals}, {artists} PRs: none yet Notes: handleArtistResearch already had the transformResponse parameter wired up (4th arg). Each handler now passes the appropriate transform. Cities handler is the most complex — converts Chartmetric's { "Chicago": [{timestp, code2, listeners}] } map into a flat sorted array. Similar handler handles both relatedartists (returns array) and by-configurations (returns {data, total}).

[2026-03-31] Marketing — Install coreyhaines31/marketingskills

Prompt: Install npx skills add coreyhaines31/marketingskills in the marketing repo. Status: completed Changes:

  • marketing: Ran npx skills add coreyhaines31/marketingskills --yes — installed all 34 skills from the package. Skills live in .agents/skills/, symlinked to .claude/skills/ and skills/. skills-lock.json also created. Committed and pushed directly to main. PRs: none (pushed directly to main) Notes: Skills installed: ab-test-setup, ad-creative, ai-seo, analytics-tracking, churn-prevention, cold-email, competitor-alternatives, content-strategy, copy-editing, copywriting, customer-research, email-sequence, form-cro, free-tool-strategy, launch-strategy, lead-magnets, marketing-ideas, marketing-psychology, onboarding-cro, page-cro, paid-ads, paywall-upgrade-cro, popup-cro, pricing-strategy, product-marketing-context, programmatic-seo, referral-program, revops, sales-enablement, schema-markup, seo-audit, signup-flow-cro, site-architecture, social-content.

Known Issues / Next Steps

  • SUBMODULE_CONFIG in tasks/src/sandboxes/submoduleConfig.ts does not include admin or marketing — if the agent modifies those submodules, PRs won't be auto-created. Consider adding them.
  • No PROGRESS_USAGE.md exists yet — if this file should have a companion usage guide, create it.
  • The progress.txt init file referenced in the task prompt was not found — likely hasn't been created yet, or was intended as a seed for future use.

Architecture Reminder

chat (frontend) → api (backend) → Supabase (database)
                              ↘ tasks (async Trigger.dev jobs)
  • Coding agent flow: Trigger.dev task → Vercel Sandbox → Claude Code CLI (claude -p --dangerously-skip-permissions) → git commit/push → PR via gh
  • PRs for api and chat target test branch; all others target main
  • Admin check: POST /api/admins/check — verifies if authenticated Privy user is in admins table

[2026-03-17] Docs — Added response items for GET /api/admins/privy

Prompt: Update docs for GET /api/admins/privy to include the latest API response — missing default of all for period and missing response fields (total_new, total_active, total_privy_users) Status: completed Changes:

  • docs: Updated api-reference/openapi.json — added all to period enum (set as default, replacing incorrect daily default); added missing 200 response fields: total_new, total_active, total_privy_users; updated endpoint description to reflect actual API behavior. PRs: Branch agent/-u0ajm7x8fbr-docs---added-resp-1773769254740 pushed to recoupable/docs — PR targeting main. Notes: Actual API code (validateGetPrivyLoginsQuery.ts) defaults period to "all" (no date filter). Handler returns { status, total, total_new, total_active, total_privy_accounts, logins }.

[2026-03-17] Docs — Rename total_privy_users to total_privy_accounts

Prompt: Change total_privy_users to total_privy_accounts in the GET /api/admins/privy OpenAPI spec. Status: completed Changes:

  • docs: Renamed total_privy_users → total_privy_accounts in api-reference/openapi.json (required field list, property name, and description). PRs: Pushed to existing branch agent/-u0ajm7x8fbr-docs---added-resp-1773769254740 on recoupable/docs. Notes: Matches the API response field naming convention (accounts, not users).

[2026-03-24] Docs User Journey Improvements

Prompt: Review docs from a user journey perspective — are they clear for Humans and Agents? Status: completed Changes:

  • docs: Navigation order fixed — authentication before MCP in sidebar
  • docs: Homepage (index.mdx) — integration path cards (REST API / MCP / CLI), clearer "what you can build" framing for humans and agents
  • docs: Quickstart (quickstart.mdx) — first example now uses Spotify search (no existing data needed, works immediately); removed Tasks list as first example; added MCP in next steps
  • docs: MCP page (mcp.mdx) — added copy-paste config snippets for Claude Desktop, Cursor, and VS Code before the TypeScript SDK; moved tool reference after connection guides
  • docs: API reference intro (api-reference/introduction.mdx) — removed duplicate auth/base URL content; now a clean page linking to auth guide PRs: Branch feat/mcp-docs-full-tool-list pushed to recoupable/docs. PR needs to be opened against main. Notes: gh CLI not available in this sandbox — PR must be created manually or via the next agent run that has GitHub access.

[2026-03-24] Composio connectors expansion

Status: completed Changes:

  • api: Expanded SUPPORTED_TOOLKITS from 4 to 12 connectors (added Gmail, Google Calendar, Spotify, Instagram, Twitter/X, YouTube, Slack, LinkedIn)
  • api: Expanded ALLOWED_ARTIST_CONNECTORS to include spotify, instagram, twitter, youtube (in addition to tiktok)
  • api: Updated CONNECTOR_DISPLAY_NAMES with 8 new entries
  • api: Updated 3 test files — all 13 tests pass PRs: recoupable/api#337 Notes: PR targets test branch. Changes are in feature/composio-more-connectors branch.

[2026-03-24] Coding agent tag-based filtering

Prompt: Add tag filter chips to admin coding page with new API endpoint for filter options Status: completed Changes:

  • api: Added optional tag query param to GET /api/admins/coding/slack (filters by user_id); created new GET /api/admins/coding-agent/slack-tags endpoint returning distinct Slack users; added 5 passing tests
  • admin: Added SlackTagOption/SlackTagOptionsResponse types; created fetchSlackTagOptions and useSlackTagOptions; updated useSlackTags to accept optional tag param; updated CodingAgentSlackTagsPage with clickable filter chips, toggle, and clear-filter UX PRs:
  • api: recoupable/api#338 (base: test)
  • admin: recoupable/admin#23 (base: main) Notes: Admin lint was non-functional due to pre-existing monorepo root eslint.config.js missing @eslint/js package — unrelated to this task. API lint errors in my new files match the same pattern as existing route files (pre-existing jsdoc rules). All new tests pass.

[2026-03-24] Hire Sr Dev agent (REC-8)

Prompt: Create a new Sr Dev agent that handles coding tasks delegated by the CTO, working closely with the Code Reviewer agent Status: completed Changes:

  • mono/agents/sr-dev/AGENTS.md: Created instructions file for the Sr Dev agent covering code standards, git workflow, build commands, and Code Reviewer integration PRs: none Notes: Hire approved by board. Sr Dev agent (81d2b822-486a-4d29-8d43-87d83d740239) is active and idle. Workflow: CTO delegates coding tasks → Sr Dev implements → Code Reviewer reviews → feedback tasks routed back to Sr Dev.

[2026-03-26] Song Filtering for Content Creation Pipeline

Prompt: Add optional songs filter to content creation pipeline so callers can limit generation to specific songs/EPs Status: completed Changes:

  • tasks: Added songs?: string[] to contentCreationSchema; selectAudioClip now filters by slug before random selection; createContentTask passes payload.songs through; 6 new tests passing
  • api: Added songs?: string[] to TriggerCreateContentPayload interface in lib/trigger/triggerCreateContent.ts PRs:
  • tasks: pending (branch: feature/song-filtering-for-content-pipeline)
  • api: pending (branch: agent/-u0ajm7x8fbr---song-filtering--1774495678034) Notes: Caller is responsible for translating user intent (e.g. "ADHD EP") into song slug arrays. Pipeline just filters — no release detection logic.

[2026-04-12] REC-57: Admin - Content - Missing Tags

Prompt: Fix /content page to show Content Agent mentions from Slack thread replies, not just top-level messages Status: in_progress (awaiting code review) Changes:

  • api: Extended fetchBotMentions to scan conversations.replies for thread mentions with cutoff filtering
  • api: Added 3 new test cases for thread mention scenarios PRs: recoupable/api#429 Notes: PR targets test branch. @Code Reviewer notified for review.