Oven Local Development Setup #

Quick Start #

# Start the oven service
ac-oven

This will:

• Navigate to ~/aesthetic-computer/oven
• Clean up any stuck processes
• Kill port 3002
• Start the oven server with auto-reload on https://localhost:3002

Architecture #

Production Flow #

1. track-media.mjs (Netlify) → Creates tape record, POSTs to https://oven.aesthetic.computer/bake
2. oven → Downloads ZIP, processes video, uploads to Spaces
3. oven → Calls webhook POST /api/tape-mp4-complete on Netlify
4. tape-mp4-complete.mjs (Netlify) → Downloads MP4/thumbnail, syncs to ATProto

Local Dev Flow #

1. track-media.mjs (Netlify dev) → Creates tape record, POSTs to https://localhost:3002/bake
2. oven (local) → Downloads ZIP, processes video, uploads to Spaces
3. oven (local) → Calls webhook POST localhost:8888/api/tape-mp4-complete
4. tape-mp4-complete.mjs (Netlify dev) → Downloads MP4/thumbnail, syncs to ATProto

Key URLs #

• Oven dashboard: https://localhost:3002/
• Health check: https://localhost:3002/health
• Status API: https://localhost:3002/status
• Bake endpoint: https://localhost:3002/bake (POST)
• WebSocket: wss://localhost:3002/ws

Environment Detection #

The oven service is automatically selected based on environment:

const isDev = process.env.CONTEXT === 'dev' || process.env.NODE_ENV === 'development';
const ovenUrl = isDev ? 'https://localhost:3002' : 'https://oven.aesthetic.computer';

Testing Locally #

1. Start the oven service:

   ac-oven
   

2. Start Netlify dev (in another terminal):

   ac-site
   

3. Upload a tape through the site - it will automatically use the local oven

4. Monitor the oven dashboard at https://localhost:3002/ to see live processing status

Emacs Tab Configuration #

Add to your Emacs aesthetic-backend configuration:

;; Example tab configuration for oven
(add-to-list 'aesthetic-tabs
  '("oven" . (lambda ()
               (aesthetic-run-in-tab "oven" "ac-oven"))))

This allows you to switch to the oven tab using your Emacs aesthetic interface.

Files Modified #

• /oven/* - New oven service
• system/netlify/functions/track-media.mjs - Updated to call oven instead of inline processing
• system/netlify/functions/tape-mp4-complete.mjs - Updated webhook to handle oven callbacks
• .devcontainer/config.fish - Added ac-oven function

Code-Based File Naming #

Both guest and user tapes now use code for file identification:

• Guest ZIP: art-aesthetic-computer/tapes/{code}.zip
• User ZIP: user-aesthetic-computer/tapes/{code}.zip (future)
• Output MP4: at-blobs-aesthetic-computer/tapes/{code}.mp4
• Output thumbnail: at-blobs-aesthetic-computer/tapes/{code}-thumb.jpg

This provides consistency across the database and storage layer.

Next Steps #

1. Test full local flow (upload → oven → webhook → atproto)
2. Add oven tab to Emacs configuration
3. Deploy oven to DigitalOcean droplet
4. Set up production environment variables
5. Configure Caddy for HTTPS on oven.aesthetic.computer