[Enhancement] Legacy Systems (v86): self-host OS/disk catalogue parity with copy.sh/v86 — remove third‑party CDN dependency #47
Assignees
spikerj (Joseph Spiker)
Clear assignees
spikerj (Joseph Spiker)
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: spikerj/spikersoft-issues#47
Reference in New Issue
Block a user
Summary
Expand Learn → Legacy Systems (v86) so OS / disk images are hosted on SpikerSoft infrastructure, achieving catalog parity with the public copy.sh/v86 emulator image list—without runtime dependency on copy.sh / third‑party CDN for fetching those payloads.
Motivation
Constraints / compliance
Many entries are historic proprietary software (Microsoft Windows lineage, proprietary BSD/OS, QNX demo, Unix V7, etc.). Before mirroring:
license,homepage,source URL,checksum).Engineering approach (high level)
sha256,sizebyte, emulator profile flags (ne2k/virtio, boot order).https://…/legacy-systems/v86/...(never hard-code copy.sh); optional staging CDN for DEV.Acceptance criteria
Target catalogue (parity list)
Stakeholder-authored tabular list spanning Linux/BSD/Hurd/Unices/Windows/DOS/custom hobby images is attached in comments #33–#35 (Linux/Unix/Windows/ReactOS/BSD lineage; DOS; Custom). Reconcile rows against copy.sh/v86 at implementation time—the site’s live table is authoritative for new BIOS pairs / image updates (e.g. build version footer
4e4bf556as of stakeholder review). Replace any divergence with synced manifest exports.Complete stakeholder parity list (tabular paste — legal gate + checksum each line at ingest time). Source catalogue UI: copy.sh/v86.
(Part 2 follows — DOS + Custom — due to comment length)
Part 2 of 3 — DOS family (full rows).
Part 3 of 3 — Custom / hobby OS (full rows).
Status update from implementation pass (Cursor Agent)
Kicked off Phase 1 work in
spikersoft-angular. Hit a tooling issue mid-stream where large file writes were silently dropping their payloads, so I'm parking progress here with a clear plan rather than leave half-baked code in the tree. Picking this up in a fresh session.Decisions locked in with the stakeholder
.gitignore-d folder underspikersoft-angular/projects/spikersoft/src/assets/v86/...so the runtime keeps using/assets/v86/...(same-origin, no CORS, no backend changes). A separate one-time copy script (built by the operator, out of scope for this PR) will populate the eventual production location. No runtime fetch ofcopy.shor any third-party CDN.v86-demos.tsactually work end-to-end plus expand the catalogue to all clearly-open-source entries from the parity list in this issue (~70 entries total). Proprietary entries (Microsoft Windows lineage, BeOS 5, BSD/OS, Unix V7, QNX 4.05, MS-DOS 4 / 6.22, 86-DOS, Sol OS, Chokanji 4, etc.) ship as bring-your-own-image (BYO) placeholders in the UI: a<input type="file">feeds v86 viaURL.createObjectURL, so we expose them in the catalogue UI without hosting any proprietary bytes ourselves. Legal review for hosting any of those is deferred to a follow-up issue.Background context surfaced during research
The feature was effectively broken in
mainbefore this work: the runtime URLs inv86-emulator.component.ts/v86-demos.tswere already migrated to/assets/v86/...paths, but onlyv86.jsis on disk — nov86.wasm, nobios/seabios.bin, nobios/vgabios.bin, no disk images. Every Start click 404s. The leftoverv86-emulator.component.ts.backupstill hard-codeshttps://copy.sh/v86/...URLs and needs to go.What landed in this pass
spikersoft-angular/projects/spikersoft/src/assets/v86/.gitignore— excludesimages/,bios/,*.wasm; keepsv86.js,README.md, and.gitignoreitself.spikersoft-angular/projects/spikersoft/src/assets/v86/README.md— canonical filename layout, hosted vs BYO explanation, instructions for adding a new image. This is the contract the operator's copy script reads against.spikersoft-angular/projects/spikersoft/src/app/_components/_emulators/v86/v86-catalogue.ts(skeleton) — typed manifest with the full set of types (V86Family,V86Arch,V86Era,V86License,V86Medium,V86HostingTier,V86CatalogueEntry), boot-order / RAM helpers, and an emptyV86_CATALOGUEarray. Entry rows still need to be filled in (see below).What's still to do (next session)
V86_CATALOGUEinv86-catalogue.tswith rows for all parity entries from comments #1–#3 of this issue. Plan is ~85 entries: ~70 hosted-open-source + ~15 BYO-proprietary. Each row carriesid,name,description,family,arch,era,license,language,medium,approxSizeMB,hostingTier,homepage, and the appropriate disk/cdrom/floppy/bzImage URL slot (or none for BYO).v86-emulator.component.tsto consume the manifest directly (drop the currentV86_DEMOS.map(...)).v86-emulator.component.htmlto:<mat-select>with multi-select chip filters (family, arch, era, medium, license).<input type="file">instead of an immediate Start button; on file pick, build aBlob-backed disk ref viaURL.createObjectURLand feed it through the existing start path.v86-emulator.component.scssfor filter chips + grouped list styling (theme tokens only, perangular-theming.mdc).v86-emulator.component.spec.tsto assert (a) every URL in the manifest matches^/assets/v86/, (b) BYO entries have no disk URLs, (c) filtering produces expected subsets.README.md— drop the misleading "Images are loaded on-demand from CDN" / "All external resources loaded from official v86 CDN" claims; document the manifest schema and BYO flow.v86-emulator.component.ts.backup(still contains hard-codedcopy.shURLs, would be a footgun if anyone copy-pasted from it).Explicitly out of scope for this PR (separate follow-ups)
assets/v86/images,assets/v86/bios, andv86.wasm(operator-built).TryConfigureStaticFiles+ a FusionIO mount under/legacy-systems. Not needed yet because dev and prod will both serve from/assets/v86/...packaged with the Angular static host. Easy to add later if total payload outgrows what we want shipped from the Angular host.sha256verification (manifest schema reserves a slot, Phase 1 leaves it unset).Acceptance check (will run after step 7)
copy.shreturns zero hits in shipping code.https?://insidev86-emulator.*andv86-catalogue.tsreturns zero non-doc hits.kolibri.img+seabios.bin+vgabios.bin+v86.wasmintoassets/v86/..., pick KolibriOS, click Start, OS boots end-to-end with no outbound network requests visible in DevTools.Board-sweep verified (medium confidence): angular PR #64 merged the 106-entry same-origin V86 catalogue (84 hosted + 22 BYO), faceted filters, and a spec asserting no copy.sh URLs — v86-catalogue.ts verified in tree; the stale 'parked' comment is superseded. Caveat: the hosted image BYTES are ops-side and unverifiable from the repos — if any catalogue entry 404s in prod, reopen with the entry name. Closing on the code evidence.