Commit Graph

11 Commits

Author SHA1 Message Date
d977620c92 feat: Step 8 - Deepgram token API
Implement serverless-friendly Deepgram token generation.

This provides a secure, stateless way for clients to use Deepgram's
real-time streaming without exposing the main API key:

1. Client requests temporary token from Next.js API
2. Server generates short-lived (60s) token with 'member' scope
3. Client uses token to connect directly to Deepgram WebSocket

This architecture bypasses Vercel's serverless WebSocket limitations
while maintaining security by keeping the main Deepgram API key
server-side only.

Security:
- Main API key never exposed to client
- Temporary tokens expire in 60 seconds
- Minimal 'member' scope permissions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 00:14:41 +00:00
e43d6493d2 feat: Step 6 - Write-through cache API
Implement the core write-through cache pattern for node creation.
This is the architectural foundation of the application.

Changes:
- Add @google/generative-ai dependency for embeddings
- Create lib/db.ts: SurrealDB connection helper with JWT auth
- Create lib/ai.ts: AI embedding generation using text-embedding-004
- Create app/api/nodes/route.ts: POST endpoint implementing write-through cache

Write-through cache flow:
1. Authenticate user via SurrealDB JWT
2. Publish node to ATproto PDS (source of truth)
3. Generate 768-dimensional embedding via Google AI
4. Cache node + embedding + links in SurrealDB

Updated schema to use 768-dimensional embeddings (text-embedding-004)
instead of 1536 dimensions.

Security:
- Row-level permissions enforced via SurrealDB JWT
- All secrets server-side only
- ATproto OAuth tokens from secure cookies

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 00:12:46 +00:00
414bf7d0db feat: Step 5 - ATproto lexicon definition
Define the custom ATproto lexicon for com.ponderants.node records.
This JSON schema specifies the exact structure of thought nodes that
will be published to the user's Personal Data Server.

Schema includes:
- Required fields: createdAt, title, body
- Optional links array for connecting nodes
- Max lengths: 256 chars (title), 3000 chars (body)
- Up to 50 links per node

This lexicon will be validated by the write-through cache API in Step 6.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 00:10:09 +00:00
93ebb0948c feat: Complete Step 3 & 4 - OAuth + SurrealDB schema
Step 3: ATproto OAuth + SurrealDB JWT
- Implement database-backed OAuth state storage (lib/auth/oauth-state.ts)
- Add session helpers for JWT decoding (lib/auth/session.ts)
- Fix OAuth callback to properly handle state retrieval
- Create /chat page displaying authenticated user handle
- Configure headless mode for Magnitude testing

Step 4: SurrealDB Schema & Permissions
- Define JWT-based access control (HS512 algorithm)
- Create user table with DID-based identity
- Create node table with row-level security (users can only access their own data)
- Create links_to relation table for graph edges
- Define vector search index (1536 dimensions for gemini-embedding-001)
- Add Docker Compose for local SurrealDB development

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 23:51:19 +00:00
878c3a7582 fix: Use ATproto localhost OAuth development mode
- Changed BLUESKY_CLIENT_ID to use http://localhost/ with redirect_uri parameter
- Updated magnitude.config.ts to use localhost:3000 for testing
- Removed public/client-metadata.json (no longer needed with localhost mode)
- Updated OAuth test to expect successful redirect to bsky.social

This leverages ATproto's special localhost client development mode which allows
local OAuth testing without requiring client metadata files.

See: https://atproto.com/specs/oauth#localhost-client-development

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 21:58:52 +00:00
06342d0d6c fix: Use 127.0.0.1 for OAuth per RFC 8252 and improve reliability
- Updated OAuth URLs from localhost to 127.0.0.1 (RFC 8252 requirement)
- Changed login page to use window.location.href for proper server redirects
- Added client-metadata.json for ATproto OAuth compliance
- Improved Step 2 theme test to check overall theme instead of specific details

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 21:38:59 +00:00
82031c3499 test: Improve auth tests with real OAuth flow validation
- Updated auth tests to use environment variables for credentials
- Tests now validate full OAuth redirect to Bluesky
- Added proper error checking for missing test credentials
- Updated .example.env with test credential placeholders
- All 3 auth tests passing (login page, error handling, OAuth redirect)
- OAuth successfully redirects to bsky.social/oauth (localhost limitation noted)

Note: Full E2E login requires public URL (ngrok) as Bluesky rejects localhost

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 21:19:49 +00:00
14f3789a57 feat: Step 3 - ATproto OAuth + SurrealDB JWT
Implemented complete OAuth flow with ATproto/Bluesky:
- Created login page with Mantine form components
- Implemented OAuth login route with PKCE and state verification
- Implemented OAuth callback route with JWT minting
- Created auth utility libraries for ATproto resolution and JWT generation
- Updated tsconfig path alias to support project structure
- Added @mantine/form and openid-client dependencies
- Updated CLAUDE.md to allow direct git commits
- All auth tests passing (login page, error handling, OAuth flow)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 21:13:00 +00:00
9d8aa87c52 feat: Step 2 - Mantine UI & grayscale theme
Integrate Mantine UI library and configure grayscale dark theme:
- Created postcss.config.mjs with Mantine preset and breakpoints
- Created app/theme.ts with custom 10-shade grayscale palette
- Configured dark mode enforcement (forceColorScheme)
- Set default component props for consistent styling:
  - Buttons: filled variant, gray color, xl radius
  - Paper: border, shadow, md radius, gray background
  - TextInput/Textarea: filled variant, rounded radius
- Updated app/globals.css to import Mantine core styles
- Updated app/layout.tsx with MantineProvider and ColorSchemeScript
- Updated app/page.tsx to use Mantine components (Center, Paper, Stack, Title, Button)

Theme achieves the "minimal, grayscale, unstyled" aesthetic with:
- 10-shade custom gray palette (ponderGray)
- Dark mode enforced via forceColorScheme
- Darkest gray background (#181a1d)
- Lightest gray text (#e9ecef)
- Consistent rounded corners and spacing

Tests: Verified Mantine theme applied correctly with rounded button corners and Paper component with border
Status: ✓ 2 tests passed (8.4s, 7.1s)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 20:40:35 +00:00
e544c95f2f feat: Step 1 - Project setup & smoke test
Initialize Next.js 16 (App Router) project with all core dependencies:
- Next.js, React 19, TypeScript configuration
- Mantine UI components (@mantine/core, @mantine/hooks)
- ATproto SDK for Bluesky integration
- SurrealDB client (updated to latest non-deprecated version)
- Vercel AI SDK with Google AI provider
- Deepgram SDK for voice-to-text
- React Three Fiber for 3D visualization
- UMAP.js for dimensionality reduction
- Magnitude test framework for E2E testing
- Playwright for browser automation

Created basic app structure with homepage displaying "Ponderants" text.
Configured magnitude.config.ts for testing framework.
Added .example.env with all required environment variables.

Test: Smoke test verifies app boots and renders homepage.
Status: ✓ Test passed (8.4s)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 20:38:55 +00:00
e867e626fe init 2025-11-08 12:44:39 +00:00