🧨 Docs vs Reality

This page prevents the SSOT from becoming another optimistic changelog. It records where documentation claims outran the repository.

Archive deletion claims versus archive contents

• static wizard images:
  • archive changelog v2.25.0 and v2.26.0 claimed all static wizard-*.png assets were deleted
  • archive still contained wizard-1.png through wizard-16.png
  • self-hosted port intentionally keeps the 16 PNGs as public seed assets
• legacy partials:
  • multiple archive changelog entries claimed /partials was deleted
  • archive still contained partial HTML files
  • approved port deletes partials on arrival because React app entry does not need them
• partial loader:
  • archive changelog claimed load-partials.js was deleted
  • archive still contained javascript js/load-partials.js
  • approved port deletes it because index.html does not reference it
• CSS consolidation:
  • archive changelog claimed all CSS was consolidated into one file
  • archive index.html still linked many separate stylesheets
  • approved port uses src/styles/index.css as an import barrel preserving source order, not a false single-file claim
• ideas collection:
  • archive config and changelog mentioned ideas
  • verified app reads and writes did not depend on it
  • approved local database omits it

Archive feature claims that were retargeted

• WebSim-hosted identity:
  • replaced by Authelia-injected identity
• WebSim database:
  • replaced by local SQLite
• WebSim chat completions:
  • replaced by local omp text generation
• WebSim image generation:
  • replaced by the omp generate_image tool
• WebSim documentation overlay:
  • replaced by a local quickstart plus links to this wiki

Source cutover resolution

The source residues found during initial wiki authoring were removed as one clean cutover:

• src/main.jsx now boots the local React app without a hosted room
• collection access uses src/lib/room.js and the seven-table Bun API
• text-generation callers use src/lib/ai.js and /api/ai/text
• image generation and uploads use /api/ai/image and /api/uploads
• likes use one transactional server route rather than client-maintained counters
• DatabaseViewer.jsx imports the canonical seven collection names and omits ideas
• default prompts and UI copy are platform-neutral, with an optional persisted target-platform setting
• the docs overlay renders the local quickstart and links to this SSOT
• source and built-output scans contain no WebSim runtime imports, globals, direct calls, or provider bypasses

Consequence

• the local omp bridge page is the definitive server and operational contract
• imported feature claims remain historical even when the new port offers equivalent behavior
• pages distinguish:
  • implemented: verified source contract
  • live: behavior observed against the deployed service
  • inherited: imported archive claim

Clean acceptance boundary

The source-level incomplete-port finding is resolved. Final live acceptance is the repeatable checklist in verification, including server tests, text and image smokes, browser workflows, access gating, restart resilience, and wiki rendering.