---

name: pulse description: PULSE is the world's first true AI-powered Integrated Trading Environment (ITE) under **Priced In Research.

Overview

PULSE — Project Rules

MVP Features

• PsychAssist: Prevents tilting/overtrading via emotional resonance + duration-based execution monitoring
• RiskFlow: AI-powered news feed interpreting macro data with IV Scoring Matrix

UI Inspiration

• macroscope.app + Cursor.com aesthetic

---

Tech Stack

Deployment (Priority Order)

Frontend

• TypeScript (94%+ of codebase)
• Next.js + Tailwind CSS
• Electron for desktop app
• Framer for landing pages (limited deps: Framer Motion, Framer React only)

Backend

• Encore.dev (TypeScript runtime)
• PostgreSQL (Encore managed)
• AWS Bedrock (session management)
• Clerk (@clerk/clerk-sdk-node) for auth
• LangChain v0.3.x for AI orchestration
• VectorDB for embeddings/semantic search

DevOps

• GitHub Actions for CI/CD
• Cloudflare Workers for edge compute
• Secrets via Encore secrets + env vars

---

Required Patterns

Encore API Endpoints

import { api, APIError } from "encore.dev/api"; export const myEndpoint = api( { method: "POST", path: "/api/resource", auth: true }, async (req: RequestType): Promise => { // Implementation } );

Defensive Null Checks

​ if (!auth?.userID) { console.error("Missing auth data"); return { conversations: [] }; }

Circuit Breaker

​ let circuitBreakerTripped = false; const fetchWithCircuitBreaker = async (url: string) => { if (circuitBreakerTripped) { return { error: "System offline", data: null }; } try { const response = await fetch(url); if (response.status === 500) circuitBreakerTripped = true; return { data: await response.json(), error: null }; } catch (e) { return { error: e.message, data: null }; } };

---

API Documentation Sources

---

Codebase Summary

For a comprehensive overview of the codebase architecture, services, APIs, and implementation details, see: .cursor/skills/pulse/CODEBASE-SUMMARY.md

This summary includes:

• Complete API endpoint documentation
• Database schema and migrations
• Service architecture and module breakdown
• Integration points (TopstepX, AWS Bedrock, Clerk)
• Known issues and build-time considerations
• Development patterns and code examples

---

Current Status

✅ Completed

• Encore.dev backend (Express migration done)
• AWS Bedrock Session Management
• Cloudflare architecture
• Database migrations + tagged template syntax
• Circuit breaker + error handling
• CORS + lazy initialization
• Clerk auth SDK
• Secrets management
• LangChain v0.3.x + VectorDB
• TypeScript frontend + Electron desktop
• CI/CD (GitHub Actions)

🚧 In Progress

• Autopilot Integration
• News Feed Launch & Debugging
• Agentic AI for IV Scoring
• Day-Bound Conversation Thread History
• App-Agentic Brain Layer ​