🏗️ Architecture

The port changes the archive from a WebSim-hosted React app into a conventional self-hosted app with local persistence and local omp generation. The current source implements that boundary without WebSim runtime imports, globals, database calls, or provider SDK bypasses.

• primary pages:
  • runtime:
    • Bun serves the API and production assets
    • Vite builds the React SPA
    • SQLite stores user data
    • server-sent events invalidate live queries
  • omp-integration:
    • text generation command
    • image generation command
    • concurrency, timeouts, JSON retry contract
    • known fidelity gaps versus the archive
  • data-model:
    • seven table contract
    • server-assigned identity and timestamps
    • transaction rules
    • schema-drift fixes reconciled from the archive

Current decisions

• remove WebSim runtime dependencies:
  • no window.websim shim
  • no WebsimSocket
  • no remote WebSim database
  • no platform image CDN dependency
• keep the application platform-neutral:
  • targetPlatform is optional user input, not a hardcoded host
  • DatabaseViewer.jsx lists exactly the seven local collections
  • local quickstart content links to this wiki for full documentation
• prevent provider bypass:
  • no provider SDKs
  • no API keys
  • no app-selected model flag
  • model selection stays in the user’s omp configuration
• SSOT rule:
  • imported docs and changelogs are history pages
  • current behavior must be reconciled against source evidence before claiming completion
  • see docs-vs-reality for mismatch tracking