OSIS island missing in default web build (404 on hero_archipelagos_osis.js) #120

New issue

Open

opened 2026-04-30 10:49:23 +00:00 by zaelgohary · 0 comments

zaelgohary commented

2026-04-30 10:49:23 +00:00

Member

Symptom

Opening the OSIS island in hero_os fires HEAD /hero_os/ui/islands/osis/hero_archipelagos_osis.js → 404. The island appears in the dock but never loads.

Root cause

FEATURES=web (the default in hero_os_app/Makefile) doesn't enable island-osis (dynamic) or island-osis-native. The OSIS metadata is still registered in registry.rs, so the dock shows it; the dynamic loader then probes for a JS bundle that was never built.

Repro

HEAD http://127.0.0.1:9988/hero_os/ui/islands/osis/hero_archipelagos_osis.js → 404

Discovered via QA audit, hits 13 times across "osis", "development", "office" island opens.

Fix options

Add island-osis-native to web (recommended — same approach as voice/embedder/etc.).
Add island-osis (dynamic) to web and ship the standalone WASM bundle.
Gate the OSIS metadata registration behind a feature flag so the dock doesn't show it when no impl is built in.

## Symptom Opening the OSIS island in hero_os fires `HEAD /hero_os/ui/islands/osis/hero_archipelagos_osis.js` → 404. The island appears in the dock but never loads. ## Root cause `FEATURES=web` (the default in hero_os_app/Makefile) doesn't enable `island-osis` (dynamic) or `island-osis-native`. The OSIS metadata is still registered in `registry.rs`, so the dock shows it; the dynamic loader then probes for a JS bundle that was never built. ## Repro ``` HEAD http://127.0.0.1:9988/hero_os/ui/islands/osis/hero_archipelagos_osis.js → 404 ``` Discovered via QA audit, hits 13 times across "osis", "development", "office" island opens. ## Fix options 1. Add `island-osis-native` to `web` (recommended — same approach as voice/embedder/etc.). 2. Add `island-osis` (dynamic) to `web` and ship the standalone WASM bundle. 3. Gate the OSIS metadata registration behind a feature flag so the dock doesn't show it when no impl is built in.