Sol-37 is a static archive shell with a live service spine. The shell is what visitors see, but the real system includes Caddy, Cloudflare, IRC-backed logbook services, a read-only knowledge query API, generated site indexes, traffic snapshots, and media watchers. This page documents the stack as it exists now instead of pretending it is cleaner than it is.
Archive reference: committed base tag sol37-audit-2026-04-13; machine-state note at
/home/david/random/docs/archive-points/sol37-archive-2026-04-13.md.
The site is a Windows 95 style operating environment wrapped around a public archive. It is not a framework
app and not a CMS. The shell in index.html opens document windows, program windows, archive views,
and runtime-backed tools over a mostly static filesystem.
Several features only work because local services and timers are running: traffic monitor snapshots, site index refreshes, public logbook APIs, the Sol chat API plus model backend, read-only semantic search, GUI share metadata, IRC logging, Cloudflare publishing, and media playlist rebuilds.
The shell behaves like a tiny operating system: desktop icons, Start menu, taskbar buttons, draggable windows, maximize/minimize controls, a command prompt, and iframe-backed program surfaces.
Embedded pages are not all passive documents. The site map, logbook, media player, star map, and DOSBox each bring their own interaction model inside the shell window.
The alternate /gui entry can open a specific shell window directly via share links. Shared GUI
links preserve the target page, can also preserve maximized state when copied from a maximized window, and
now receive entry-specific social metadata while keeping the raw /gui?i=... URL shape. The
floating desktop assistant stays hidden by default on shared links unless assistant=1 is added.
index.html for the retro desktop shellchat/ for the public Sol chat consolesitemap.html for archive browsingsite-metrics.html for traffic and telemetryprograms/logbook.html for the public logbookprograms/media-player.html for video and audio playbackprograms/dosbox.html for the DOS sandbox surfacesite-index.json from the site-index watcherknowledge-index.json from the knowledge/site index bridgesite-metrics.json from the traffic snapshot generatorvideo/playlist.json and audio/playlist.json from the media watchersassets/share-previews/ngircd backs the local IRC transport/chat to /chat/index.html and marks the chat surface no-store to avoid stale mobile assets/api/chat/* to the local Sol chat API/api/logbook/* to the Python API/api/knowledge/* to the read-only semantic search APIcaddy-sol37.servicepkd-cloudflared-quick-tunnel.servicepublic-logbook-api.servicepublic-logbook-irc-logger.serviceknowledge-query-api.servicesol-chat-api.servicesol-chat-model.servicesol37-gui-share.servicesite-index-watch.servicevideo-playlist-watch.serviceaudio-playlist-watch.servicesite-metrics-snapshot.timersynthetic-logbook-snapshot.timerngircd.service as the system IRC daemon
User services are configured in ~/.config/systemd/user and now survive reboot through user linger.
The critical machine fact is simple: without loginctl enable-linger david, the stack would wait for
a login and quietly fail the illusion of being a server.
The dedicated /chat page is now the public Sol console rather than a placeholder widget. It uses
the same Sol orb vocabulary as the desktop assistant, keeps the browser on same-origin routes, and exposes
voice controls plus site-wide debug metrics.
sol_session/api/chat/speak/api/chat/gui?i=...&assistant=1 into /api/chatsite-metrics.json
A real failure mode appeared on mobile: the HTML for /chat updated, but public
chat.js and chat.css stayed cached long enough to make the page look and behave like
an older build.
www/chat/index.html now uses versioned asset URLs/chat and /chat/* as Cache-Control: no-storebin/check_sol_chat_asset_versioning.pyThe media player is currently functioning well in live use, but it remains the least trustworthy subsystem in the stack. Public playback quality is shaped by both player behavior and the tunnel/range-request path, especially for large audio and video payloads.
This machine now has an explicit audit-era archive point. Use the tag and archive note above when you need to distinguish committed history from the larger working-tree/runtime state that was live during review.
The traffic monitor is honest about what it measures. It reports the current access-log window, not all-time traffic. It now separates raw host hits from visible archive hits and shows suppressed polling paths so the smaller number does not masquerade as the whole story.
The monitor also mirrors the same Home Assistant and local system readouts used by MasterBot: ambient temperature, particulate, light, Apollo presence data, uptime, CPU temp, and GPU temp.
The public semantic search surface is read-only and intentionally plain. It exposes
GET /api/knowledge/query and GET /api/knowledge/health through the same host as the
site instead of hiding behind a separate API domain.
https://sol.system42.one/api/knowledge/healthhttps://sol.system42.one/api/knowledge/query?query=hello%20friend&top_k=3https://sol.system42.one/knowledge-openapi.jsonhttps://sol.system42.one/privacy.html
A browser address bar is enough. Because the public route is GET-only, you can paste a query URL
directly into a browser and receive raw JSON with no extra client, auth flow, or SDK.
Example:
https://sol.system42.one/api/knowledge/query?query=what%20is%20Sol%3F&top_k=2
The site keeps a backend-specific query-embedding sidecar so repeated identical queries do not need a fresh upstream embedding request every time.
sol_ingest
Live service run on 2026-04-15 for Sol knowledge API:
query_cache_hit: false, about 3149.48msquery_cache_hit: true, about 11.65msSol-37 is deliberately hybrid. Some pages are just files. Some pages are generated. Some windows are backed by live daemons. Some content is synthetic by design. The system works best when those layers stay visible instead of being flattened into marketing language about a “website.”