feat(amiga): scaffold MagicWB /amiga/ MPA at 2.4.0

Add parallel Workbench skin with self-hosted Topaz, MagicWB tokens,
and Vite MPA entry; keep legacy and v25 skins untouched.

Co-authored-by: Cursor <cursoragent@cursor.com>

.agents/skills/dev-protocol/lessons-learned.md

@@ -288,11 +288,20 @@ Portable findings from VHectorLab 3D `v2.1.0` — apply if the older app shares
 
 ## 6. Dev tooling / ngrok / Vite ↔ backend
 
+### 6.0e. `/amiga` (MagicWB) — proyecto aparte; v25 y legado off-limits
+- **Regla**: el skin Amiga Workbench / MagicWB vive **solo** bajo `amiga/` + `src/amiga/**` (MPA `/amiga/`). Es un epic **independiente** de `gui-art` / `gui-art-v25` / `/v25/`.
+- **PROHIBIDO** en el epic Amiga: editar `src/v25/**`, `v25/**`, o “alinear” v25 (versión, tokens, copy). También evitar contaminar `src/style.css` / `src/main.js` / `src/ui/*` legado salvo cambios MPA compartidos mínimos (`vite.mpa.js`, redirect `/amiga`, tests MPA).
+- **Invariante**: SemVer de producto en este epic = línea **`2.4.x`** (MINOR `2.4.0` al primer scaffold demoable). HF Space público = **último** slice del roadmap, no en slices intermedios.
+- **Verificación**: antes de approval / merge Amiga → `git diff -- src/v25 v25` vacío; revisar que el diff legado no meta skin Amiga en `/`.
+- **Norte visual**: Topaz self-hosted + sin antialiasing (múltiplos de 8px) + paleta MagicWB 8 colores; CSS estático (no inyección `<style>` por JS). Cosplay full (iconos/drawers) = roadmap futuro, no este epic.
+- **Mobile**: desktop y mobile desde el inicio; si Topaz/density falla → preguntar al humano, no bajar de múltiplos de 8 “a ciegas”.
+
 ### 6.0d. `src/v25/**` — no tocar salvo pedido explícito del humano
 - **Regla**: el árbol `src/v25/` (y `v25/index.html` / assets MPA asociados) es un **proyecto aparte**. En roadmaps/epics del UI legado (`src/main.js`, `src/ui/*`, `src/visualizer/*`) está **prohibido** editar `src/v25/**`.
 - **Invariante**: no “sync de cortesía” (versión, copy, presets compartidos, imports) en v25 **a menos que el humano lo indique explícitamente** en el prompt (“tocá v25”, “sync version en v25”, “también en /v25/”, etc.). Silencio ≠ permiso.
 - **Verificación**: antes de approval gate / merge, `git diff -- src/v25` debe estar vacío si el epic no autorizó v25.
 - **Excepción**: solo cuando el humano lo pida; no inferir desde SemVer, CHANGELOG, o que v25 importe módulos de `src/ui/`.
+- **Nota**: el epic `/amiga` (§6.0e) también deja v25 intacto; no usar Amiga como excusa para tocar v25.
 
 ### 6.0c. `v25:` MODE switch = visibility toggle, never wipe left host
 - **Problema**: montar Compare con `zones.left.innerHTML = …` destruye el panel Arithmetic (form state + Top-10). Además `display: flex` en `.lab-left-host > [data-panel]` **pisa** el UA `[hidden]{display:none}` → el slot Arithmetic oculto sigue ocupando flex y deja un **hueco negro** arriba del Compare (lista cosine aplastada abajo).
@@ -305,15 +314,15 @@ Portable findings from VHectorLab 3D `v2.1.0` — apply if the older app shares
 - **Invariante**: no fork de `SceneSetup` solo por MPA; no contaminar `src/style.css` legado. Startup canvas = `ARITHMETIC|ANALYSIS|POINTS` (`canvasStartupContext` / `appViewDefaults`).
 - **No hacer en Fase 8+ inmediata**: wire live de sliders (Fase 9) ni MODE Compare (Fase 10) desde header tabs.
 
-### 6.0. `v25:` Vite MPA + FastAPI directory index
-- **Problema**: un solo `index.html` en la raíz no alcanza para la bandera blanca `/v25/`. En prod, el catch-all que solo chequea `is_file()` trata `dist/v25/` como miss y cae al SPA legado. En **dev**, Vite SPA fallback sirve el legado en `/v25` **sin** trailing slash → canvas oscuro “vacío”.
+### 6.0. `v25:` / `amiga:` Vite MPA + FastAPI directory index
+- **Problema**: un solo `index.html` en la raíz no alcanza para banderas blancas (`/v25/`, `/amiga/`). En prod, el catch-all que solo chequea `is_file()` trata `dist/<dir>/` como miss y cae al SPA legado. En **dev**, Vite SPA fallback sirve el legado en `/v25` o `/amiga` **sin** trailing slash.
 - **Solución Obligatoria**:
-  - Vite `build.rollupOptions.input` vía `getViteInputs(root)` (`vite.mpa.js`) → `main` + `v25` → emite `dist/index.html` y `dist/v25/index.html`.
-  - `appType: 'mpa'` + plugin `mpaTrailingSlashRedirect` → `/v25` 302 → `/v25/`.
+  - Vite `build.rollupOptions.input` vía `getViteInputs(root)` (`vite.mpa.js`) → `main` + `v25` + `amiga` → emite `dist/index.html`, `dist/v25/index.html`, `dist/amiga/index.html`.
+  - `appType: 'mpa'` + plugin `mpaTrailingSlashRedirect` → bare dir 302 → trailing slash (`/v25/`, `/amiga/`).
   - FastAPI: `resolve_dist_file(dist, path)` → archivo exacto, si no `path/index.html`, si no root `index.html`.
-- **Invariante**: nuevas páginas MPA = entry en `getViteInputs` **y** redirect bare-dir → slash; no hardcodear solo `/v25/index.html` en el cliente si `/v25/` debe funcionar.
-- **No hacer**: contaminar `src/style.css` / `src/main.js` legado desde v25.
-- **URL de prueba**: preferí `http://127.0.0.1:5173/v25/` (con slash); sin slash debe redirigir, no cargar el legado.
+- **Invariante**: nuevas páginas MPA = entry en `getViteInputs` **y** redirect bare-dir → slash; no hardcodear solo `…/index.html` en el cliente si `/dir/` debe funcionar.
+- **No hacer**: contaminar `src/style.css` / `src/main.js` legado desde v25 o amiga; no editar `src/v25/**` desde el epic amiga (ver §6.0e).
+- **URL de prueba**: preferí `http://127.0.0.1:5173/v25/` y `http://127.0.0.1:5173/amiga/` (con slash); sin slash debe redirigir, no cargar el legado.
 
 ### 6.1. Proxy `/api` en Vite: prefijo general, no ruta-a-ruta
 - **Problema**: Exponer frontend y backend con **el mismo** hostname ngrok (dos agentes → `:5173` y `:8000`) se pisa; el celu no puede llamar a `127.0.0.1:8000`.

CHANGELOG.md

@@ -23,6 +23,11 @@ All notable changes to VHectorLab 3D will be documented in this file.
 - **v25 layout shell** (Fase 3): 5-zone grid (header / left / canvas / right / footer); mobile stack via legacy `MOBILE_MQ`.
 - **v25 design tokens** (Fase 2): dark/fluo lab `:root`, Oxanium + IBM Plex Mono, `.lab-panel` / `.lab-btn` pressable utilities, WCAG contrast checks via `contrastRatio`.
 
+## [2.4.0] - 2026-08-08
+
+### Added
+- **`/amiga/` MPA scaffold** (Slice 1): Magic Workbench skin — self-hosted Topaz (`Topaz_a1200`), serrucho (no AA), 8-pen MagicWB tokens; Vite MPA entry + `/amiga` → `/amiga/` redirect. Parallel to legacy `/` and `/v25/` (neither skin touched). Plan: `roadmap/amiga-workbench.md`.
+
 ## [2.3.0] - 2026-08-08
 
 ### Added

CONTEXT.md

@@ -61,6 +61,11 @@ Percent of the |t| range held at the zero color (default black) before blending
 ### Group Contrast
 Visualization paint for Compare with ≥2 groups: **Shared noise** blackens same-sign dims by similarity; **Sign conflict** highlights opposite-sign dims (custom color × |Δ|) and can blacken them by difference. Uses group means on raw embeddings; geometry Y unchanged.
 
+### Amiga Skin
+Parallel MPA UI at `/amiga/` with Magic Workbench palette and Topaz pixel typography. Independent of legacy `/` and of `/v25/`; does not change product math or API contracts.
+
+_Avoid_: treating Amiga as a reskin of v25 or legacy; editing `src/v25/**` for Amiga work.
+
 ### Shared Noise Similarity
 `1 − |mean_G1 − mean_G2| / (|mean_G1| + |mean_G2|)` per dimension — high values mean shared-sign “noise” between groups.
 

amiga/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+  <title>VHectorLab-3D Amiga</title>
+  <meta name="description" content="VHectorLab-3D Amiga — Magic Workbench skin (parallel MPA)." />
+  <link rel="stylesheet" href="/src/amiga/style.css" />
+</head>
+<body>
+  <div id="app"></div>
+  <script type="module" src="/src/amiga/main.js"></script>
+</body>
+</html>

backend/server.py

@@ -51,7 +51,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     title="VHectorLab 3D API",
     description="Backend API for 3D Vector Arithmetic & Semantic Embedding Visualizer",
-    version="2.3.0",
+    version="2.4.0",
     lifespan=lifespan,
 )
 

manifest.json

@@ -1,6 +1,6 @@
 {
   "project": "vhectorlab-3d",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "bootstrap_run": false,
   "state_schema": {
     "model_name": "all-mpnet-base-v2",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "vhectorlab-3d",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

roadmap/PROMPT-amiga-workbench.md

@@ -0,0 +1,81 @@
+# Prompt — Amiga Workbench `/amiga` (MagicWB)
+
+**Modo:** **serial** — una sesión / un slice. No agentes en paralelo.  
+Empezá por el slice que indique el humano (default: **Slice 1** tras Slice 0 docs). No re-litigar Q1–Q10.
+
+---
+
+```text
+Usando dev-protocol, implementá el roadmap Amiga Workbench `/amiga`.
+
+## Contexto
+Repo: VHectorLab 3D / vhectorlab (Python/uv + Vite/Three.js + FastAPI).
+Base: `main` actualizado (`git pull`).
+SemVer: línea **2.4.x** (Slice 1 cierra con MINOR **2.4.0**).
+
+Roadmap canónico (leelo COMPLETO antes de código):
+  `roadmap/amiga-workbench.md`
+Lecciones: `.agents/skills/dev-protocol/lessons-learned.md` — **§6.0e obligatorio**
+  (+ §6.0d v25; §6.0 MPA).
+
+## AISLAMIENTO (NO negociable)
+1. **PROHIBIDO** tocar `src/v25/**`, `v25/**`, o “sync” a v25.
+2. Trabajo nuevo SOLO en `amiga/` + `src/amiga/**`.
+3. Legado `/` intacto salvo cambios MPA compartidos mínimos (`vite.mpa.js`, `vite.config.js`, tests MPA).
+4. Antes de approval: `git diff -- src/v25 v25` vacío.
+5. Este epic **NO** es gui-art / gui-art-v25. Cero dependencia de ese norte visual.
+
+## Decisiones CERRADAS (no re-preguntar)
+- Bandera blanca `/amiga/`; Magic Workbench palette; Topaz self-host; CSS estático.
+- Q2-A only (tipo+paleta+chrome mínimo). Cosplay Q2-C = otro roadmap.
+- Canvas 3D look no se artea (Q3-A).
+- Desktop + mobile; si mobile se complica → preguntar con diseño, no improvisar.
+- HF Space = Slice 7 / final solamente.
+
+## Estilo
+No-fluff; TDD donde haya helpers puros (tokens, MPA inputs); módulos profundos.
+Seguí `.agents/skills/dev-protocol/SKILL.md`
+(clarify → branch `feat/amiga-<slice>` → implement → verify → docs → approval gate → git delivery con OK).
+
+## Slice 1 — DoD (sesión típica de arranque)
+1. `amiga/index.html` + `src/amiga/main.js` + `tokens.css` / `style.css`.
+2. Topaz self-hosted bajo `src/amiga/assets/fonts/` (+ nota LICENSE en carpeta o README amiga).
+3. Clase raíz / `:root` con serrucho (no AA) + font-size 16px (múltiplos de 8) + paleta MagicWB (§3.2 roadmap).
+4. Vite MPA: entry `amiga` + redirect `/amiga` → `/amiga/`.
+5. Tests MPA actualizados (amiga en `getViteInputs` / redirect).
+6. Bump producto a **2.4.0** (manifest / package / CHANGELOG; Navbar legado solo si el DoD de SemVer del repo lo exige — **no** tocar version.js de v25).
+7. Smoke: `/` y `/v25/` sin cambios visuales; `/amiga/` se ve MagicWB+Topaz.
+8. APPROVAL GATE; ESPERÁ OK antes de push/merge.
+
+## Slices siguientes
+Ver tabla §6 de `roadmap/amiga-workbench.md`. Un slice por sesión.
+```
+
+---
+
+## Prompt — Slice 2+
+
+```text
+Usando dev-protocol, continuá Amiga `/amiga` — SOLO Slice N.
+
+Roadmap: `roadmap/amiga-workbench.md` §6 Slice N.
+PROHIBIDO: `src/v25/**`, `v25/**`.
+Legado `/` solo MPA shared si hace falta.
+SemVer: PATCH 2.4.x salvo que el humano diga otro bump.
+
+DoD: el de la fila Slice N del roadmap.
+APPROVAL GATE; no push/merge sin OK.
+```
+
+---
+
+## Prompt — Slice 7 (HF Space)
+
+```text
+Usando dev-protocol, cerrá Amiga `/amiga` — Slice 7 polish + HF Space.
+
+Roadmap: `roadmap/amiga-workbench.md` §7–§9.
+Confirmá con el humano si Space default queda en `/`, `/amiga/`, o link.
+PROHIBIDO: tocar v25.
+APPROVAL GATE → OK → git delivery + publish Space según proceso del repo.
+```

roadmap/README.md

@@ -4,6 +4,8 @@ Documentos de planificación **activos** viven en esta carpeta. Históricos en *
 
 | Doc | Tema | Estado |
 |---|---|---|
+| [`amiga-workbench.md`](./amiga-workbench.md) | Skin **Amiga**/MagicWB en bandera blanca `/amiga/` (Topaz + paleta; SemVer 2.4.x) | **Activo (plan)** |
+| [`PROMPT-amiga-workbench.md`](./PROMPT-amiga-workbench.md) | Prompt serial por slice para agentes `/amiga` | **Activo** |
 | [`galaxy-view.md`](./galaxy-view.md) | VIEW **Galaxy**: UMAP backend, 1 punto/token, COMPARE+POINTS locked, IT core×100 | **Activo (plan)** |
 | [`PROMPT-galaxy-view.md`](./PROMPT-galaxy-view.md) | Prompt serial por slice (1→7) para agentes Galaxy | **Activo** |
 | [`gui-art-v25.md`](./gui-art-v25.md) | GUI/Art **v25**: layout+skin paralelo en `/v25/` (fases 0–13, hand-offs) | **Activo (plan)** |

roadmap/amiga-workbench.md

@@ -0,0 +1,241 @@
+# Amiga Workbench skin — `/amiga` (MagicWB)
+
+**Estado:** activo — Slice 1 listo (approval gate)  
+**Protocolo:** `.agents/skills/dev-protocol/` (ciclo completo + approval gate)  
+**Prompt agente:** [`PROMPT-amiga-workbench.md`](./PROMPT-amiga-workbench.md)  
+**SemVer:** línea **`2.4.x`** (MINOR `2.4.0` en Slice 1)  
+**HF Space público:** **solo al final** (§7 Slice final) — no en slices intermedios
+
+---
+
+## 0. Norte
+
+Bandera blanca **`/amiga/`**: UI paralela con estética **Commodore Amiga Workbench 3.0 + Magic Workbench** (tipografía pixel / efecto serrucho + paleta MagicWB).
+
+- **No** es un reskin del legado `/`.
+- **No** es v25 ni continúa `gui-art` / `gui-art-v25`.
+- Canvas 3D **no se toca** en este epic (clear color / shaders / POINTS / RIBBONS quedan como el engine actual cuando se cablee).
+- Profundidad de este epic = **Q2-A**: tipografía + paleta + chrome mínimo legible.  
+  **Q2-C** (cosplay full: iconos MagicWB, drawers, pointer, metaphors) → roadmap **aparte**, después de que `/amiga` esté usable.
+
+---
+
+## 1. Decisiones cerradas (Q1–Q10)
+
+| ID | Decisión |
+| :--- | :--- |
+| **Q1** | Bandera blanca **`/amiga/`**. Legado `/` intacto. **`src/v25/**` y `v25/**` — PROHIBIDO tocar (explícito; ver lessons §6.0e). |
+| **Q2** | **A** — tipografía pixel + paleta MagicWB (+ chrome 2D mínimo para que se lea como WB). **C** (cosplay) → epic futuro aparte. |
+| **Q3** | **A** — no artear el look 3D; canvas héroe reusa engine sin “pixelizar” puntos/ribbons. |
+| **Q4** | **A** — self-host Topaz (`.ttf` / `.woff2` en repo bajo `amiga/` o `src/amiga/assets/`). Sin CDN GitHub raw. |
+| **Q5** | **A** — CSS estático (tokens + clase raíz). **No** inyección dinámica de `<style>` por JS. |
+| **Q6** | Paleta **Magic Workbench** (8 colores canónicos + tokens semánticos). |
+| **Q7** | Desktop **y** mobile desde el inicio. Si mobile se complica (legibilidad Topaz / density) → **parar y preguntar** con propuesta, no inventar. |
+| **Q8** | Cero relación con `gui-art` / v25. Separación total. Lesson obligatoria. SemVer **2.4.x**. |
+| **Q9** | HF Space público = **último slice** del epic (§7). |
+| **Q10** | Primer slice demoable = shell `/amiga/` con Topaz + serrucho + fondo/paleta MagicWB. |
+
+### Fuera de alcance (este epic)
+
+- Editar `src/v25/**`, `v25/index.html`, tokens/skin v25.
+- Contaminar `src/style.css` / `src/main.js` legado “para que amiga funcione”.
+- Cosplay Q2-C (icon packs, drawer metaphors, Amiga pointer custom) — doc futuro.
+- Cambiar contratos `/api/*` / SAE math / Galaxy.
+- Publicar HF Space antes del slice final.
+
+---
+
+## 2. Arquitectura bandera blanca `/amiga/`
+
+### 2.1 Layout de archivos (objetivo)
+
+```text
+amiga/index.html                 # entry MPA → /amiga/
+src/amiga/
+  main.js                        # bootstrap solo amiga
+  style.css                      # importa tokens + skin
+  tokens.css                     # :root MagicWB + Topaz
+  assets/fonts/                  # TopazNew self-hosted (+ LICENSE)
+  ui/                            # shell / paneles (crecer por slice)
+  …                              # copy-adapt desde legado si hace falta; NO editar legado para “arreglar” amiga
+```
+
+Legado intacto: `index.html`, `src/main.js`, `src/ui/*`, `src/style.css`.  
+v25 intacto: `v25/**`, `src/v25/**`.
+
+### 2.2 Vite / serve
+
+Extender el MPA existente (mismo patrón que v25):
+
+- `getViteInputs` → agregar `amiga: …/amiga/index.html`.
+- `mpaTrailingSlashRedirect` / `mpaTrailingSlashLocation` → incluir `'/amiga'`.
+- Dev: `http://127.0.0.1:5173/amiga/` (con slash).
+- Build: `dist/amiga/index.html`; FastAPI `resolve_dist_file` ya cubre `path/index.html`.
+- Proxy `/api` sin cambios.
+
+### 2.3 Reglas de convivencia
+
+| Árbol | Política en este epic |
+| :--- | :--- |
+| `/` legado | **No modificar** salvo smoke check de no-regresión (idealmente `git diff` vacío en paths legado). |
+| `/v25/` | **PROHIBIDO**. Verificación: `git diff -- src/v25 v25` vacío antes de approval. |
+| `/amiga/` | Único lugar de trabajo nuevo. |
+| `src/engine/*`, `src/visualizer/*`, `src/core/*` | Reusar por import en slices de wire (como v25); **no** fork de math/shaders. |
+| Helpers puros compartidos | Preferir copy-adapt en `src/amiga/` al inicio; extraer a módulo neutro solo con test + OK humano. |
+
+---
+
+## 3. Norte visual (MagicWB + Topaz)
+
+### 3.1 Tipografía
+
+- Familia: **TopazNew** (o Topaz equivalente self-hosted).
+- Tamaños en **múltiplos de 8** (base **16px**; line-height tip. **20px**).
+- Sin antialiasing / efecto serrucho:
+
+```css
+-webkit-font-smoothing: none;
+-moz-osx-font-smoothing: grayscale; /* o unset según plataforma; documentar en lesson si diverge */
+text-rendering: optimizeSpeed;
+font-smooth: never; /* non-standard; harmless where ignored */
+```
+
+- Imágenes UI (si hay): `image-rendering: pixelated` / `crisp-edges`.
+
+### 3.2 Paleta Magic Workbench (8 pens)
+
+Fuente canónica (Wikipedia / MagicWB docs), RGB → hex:
+
+| Idx | Hex | Rol sugerido (token) |
+| :---: | :--- | :--- |
+| 0 | `#959595` | `--mwb-gray` fondo escritorio / paneles |
+| 1 | `#000000` | `--mwb-black` texto |
+| 2 | `#FFFFFF` | `--mwb-white` highlight / shine |
+| 3 | `#3B67A2` | `--mwb-blue` acento / titlebar-ish |
+| 4 | `#7B7B7B` | `--mwb-halfshadow` |
+| 5 | `#AFAFAF` | `--mwb-halfshine` |
+| 6 | `#AA907C` | `--mwb-tan` |
+| 7 | `#FFA997` | `--mwb-peach` |
+
+Tokens semánticos mínimos (Slice 1+):
+
+```text
+--amiga-bg: var(--mwb-gray);
+--amiga-fg: var(--mwb-black);
+--amiga-accent: var(--mwb-blue);
+--amiga-font: 'TopazNew', monospace;
+--amiga-font-size: 16px;
+--amiga-line-height: 20px;
+```
+
+> Nota: el gris clásico WB `#aaaaaa` / azul titlebar `#0055aa` del snippet original **ceden** a MagicWB (§Q6). Si hace falta un azul más “WB 3.0 puro” para titlebars en un slice de chrome, preguntar antes de desviarse.
+
+### 3.3 Mobile
+
+- Mismos tokens; tipografía 16px puede ser densa → medir portrait + landscape corto (`MOBILE_MQ` del legado como referencia).
+- Si Topaz ilegible o docks imposibles: **diseñar 1–2 opciones y preguntar** (no bajar a 14px “porque sí”; múltiplos de 8 o pregunta).
+
+---
+
+## 4. SemVer / docs
+
+| Entrega | SemVer | Docs |
+| :--- | :--- | :--- |
+| Slice 1: scaffold `/amiga/` + Topaz + tokens MagicWB visibles | **MINOR `2.4.0`** | CHANGELOG + CONTEXT término `amiga` + lessons §6.0e |
+| Slices siguientes (shell, wire producto) | **PATCH `2.4.x`** | CHANGELOG Unreleased / sección 2.4.x |
+| Cosplay Q2-C (otro roadmap) | a decidir | — |
+| HF Space cutover / demo pública | Slice final (§7) | README/HF docs según `hf-space-cpu-demo.md` |
+
+Versión producto en Navbar/manifest: **solo** cuando el slice de amiga lo pida en su DoD; **no** sync cortesía a v25 (§6.0d + §6.0e).
+
+---
+
+## 5. Invariantes que NO romper
+
+- English-only product copy.
+- Contratos API `/api/*`.
+- Lecciones WebGL existentes si se cablea canvas (frustum, fog, etc.).
+- `git diff -- src/v25 v25` vacío siempre en este epic.
+- Preferir `git diff` vacío en legado `/` (`index.html`, `src/main.js`, `src/style.css`, `src/ui/*`) salvo cambios MPA compartidos inevitables (`vite.mpa.js`, `vite.config.js`, tests MPA).
+
+Cambios MPA compartidos permitidos (mínimos):
+
+- `vite.mpa.js` / `vite.config.js` — agregar entry + redirect `/amiga`.
+- `tests/viteMpaInputs.test.js` (o equivalente) — cubrir `amiga`.
+- FastAPI solo si hace falta test de `resolve_dist_file` con `/amiga/` (probablemente ya genérico).
+
+---
+
+## 6. Slices secuenciales
+
+> **No en paralelo.** Un slice / sesión. Approval gate → OK → merge antes del siguiente.
+
+| Slice | Nombre | DoD (testeable) | Dep | Status |
+| :---: | :--- | :--- | :---: | :--- |
+| **0** | Plan + prompt | Este doc + `PROMPT-amiga-workbench.md` + README roadmap + lesson §6.0e | — | ✅ 2026-08-08 |
+| **1** | Scaffold MPA + Topaz + tokens | `/amiga/` carga; Topaz self-host; serrucho; fondo MagicWB; `/` y `/v25/` intactos; bump **2.4.0**; tests MPA verdes | 0 | ✅ 2026-08-08 (branch `feat/amiga-scaffold`) |
+| **2** | Shell layout desktop+mobile | Zonas mínimas (header / left / canvas-host / right o equivalente) con tokens; responsive OK o pregunta si falla | 1 |
+| **3** | Chrome 2D mínimo | Paneles legibles “WB-ish” **sin** cosplay Q2-C (bordes/contraste MagicWB, no icon packs) | 2 |
+| **4** | Wire Arithmetic (o panel primario legado) | CTA real vía `/api`; lista resultados; canvas aún stub OK | 3 |
+| **5** | Canvas host + engine reuse | Montar scene existente en host amiga; POINTS startup; **sin** retocar shaders/look 3D | 4 |
+| **6** | Compare / SAE / viz (según prioridad humana) | Port vertical de superficies críticas; mobile no roto | 5 |
+| **7** | Polish + HF Space | Smoke desktop+mobile; CONTEXT/CHANGELOG; **publicar Space** con OK explícito | 6 |
+
+### Hand-off (plantilla)
+
+```markdown
+### Hand-off — Slice N
+- **Branch / commit:** …
+- **Cómo probar:** `/amiga/` … ; smoke `/` y `/v25/` sin cambios visuales
+- **Tests:** …
+- **Hecho:** …
+- **NO hecho:** …
+- **Verificación aislamiento:** `git diff -- src/v25 v25` vacío; legado solo MPA shared si aplica
+- **Riesgos / preguntas mobile:** …
+```
+
+---
+
+## 7. HF Space (último)
+
+Solo cuando Slices 1–6 cumplan DoD y el humano diga OK:
+
+1. Confirmar qué URL es default en Space (`/` vs `/amiga/` vs link). **Preguntar** si no está cerrado.
+2. Seguir proceso existente de publish (`hf-space-cpu-demo.md` / force-push Space).
+3. Documentar en CHANGELOG + README cómo abrir el skin Amiga.
+
+---
+
+## 8. Epic futuro (no este doc)
+
+**`amiga-workbench-cosplay.md`** (crear cuando se pida): Q2-C — iconos MagicWB/NewIcons, drawers, pointer, patterns de escritorio, gadgets pressable full. Depende de `/amiga` usable.
+
+---
+
+## 9. Smoke checklist (acumulativa)
+
+1. `http://127.0.0.1:5173/` — legado igual.
+2. `http://127.0.0.1:5173/v25/` — v25 igual (no tocado).
+3. `http://127.0.0.1:5173/amiga/` — Topaz + MagicWB visibles.
+4. `/amiga` sin slash → redirect a `/amiga/`.
+5. Phone portrait + landscape corto: texto legible o issue abierto al humano.
+6. Tras wire: Arithmetic/Compare no rompen contratos Top-10 / cosine.
+
+---
+
+## 10. Slice 0 — hecho al crear este plan
+
+- [x] Decisiones Q1–Q10 cerradas
+- [x] Este roadmap
+- [x] Prompt agente
+- [x] Entrada README roadmap
+- [x] Lesson §6.0e aislamiento `/amiga` + v25 off-limits en este epic
+
+### Hand-off — Slice 1
+- **Branch / commit:** `feat/amiga-scaffold` (local; approval gate)
+- **Cómo probar:** `npm run dev` → `http://127.0.0.1:5173/amiga/` (Topaz + gris MagicWB + titlebar azul + 8 swatches); smoke `/` y `/v25/` sin cambios de skin; `/amiga` sin slash → `/amiga/`
+- **Tests:** `npm test` (incl. `amigaTokens`, `viteMpaInputs`)
+- **Hecho:** MPA entry, tokens MagicWB, Topaz self-host GPL-FE, SemVer **2.4.0**, CONTEXT término Amiga Skin, lessons §6.0/§6.0e
+- **NO hecho:** shell 5 zonas (Slice 2), wire API/canvas, HF Space
+- **Verificación aislamiento:** `git diff -- src/v25 v25` vacío; legado solo version-tag Navbar + MPA shared
+- **Riesgos / preguntas mobile:** Topaz 16px en phone portrait — revisar visualmente; si ilegible, preguntar (no bajar de múltiplos de 8 a ciegas)

src/amiga/assets/fonts/LICENSE.txt

@@ -0,0 +1,10 @@
+Topaz (TrueType remake) — Multi Platform Amiga Fonts
+Source: https://github.com/rewtnull/amigafonts (ttf/Topaz_a1200_v1.0.ttf)
+
+License: GPL with Font Exception (GPL-FE)
+  https://www.gnu.org/licenses/gpl-faq.html#FontException
+
+Topaz is © AmigaInc.
+TrueType version © dMG/t!s^dS! (Trueschool / Divine Stylers), 2009.
+
+Vendored here for the VHectorLab `/amiga` MagicWB skin (self-host; no CDN).

src/amiga/main.js

@@ -0,0 +1,30 @@
+import './style.css';
+import { PRODUCT_NAME, PRODUCT_VERSION } from './version.js';
+
+document.body.classList.add('amiga-workbench');
+
+const app = document.getElementById('app');
+if (app) {
+  app.innerHTML = `
+    <div class="amiga-shell" data-amiga-shell>
+      <header class="amiga-titlebar">
+        <h1 class="amiga-titlebar__brand">${PRODUCT_NAME}</h1>
+        <span class="amiga-titlebar__meta">Amiga / MagicWB · v${PRODUCT_VERSION}</span>
+      </header>
+      <section class="amiga-panel" aria-label="Workbench scaffold">
+        <p>Topaz + Magic Workbench palette scaffold.</p>
+        <p>Parallel skin at /amiga/ — legacy / and /v25/ untouched.</p>
+        <ul class="amiga-swatches" aria-label="MagicWB pens">
+          <li data-pen="0" title="0 gray"></li>
+          <li data-pen="1" title="1 black"></li>
+          <li data-pen="2" title="2 white"></li>
+          <li data-pen="3" title="3 blue"></li>
+          <li data-pen="4" title="4 halfshadow"></li>
+          <li data-pen="5" title="5 halfshine"></li>
+          <li data-pen="6" title="6 tan"></li>
+          <li data-pen="7" title="7 peach"></li>
+        </ul>
+      </section>
+    </div>
+  `;
+}

src/amiga/style.css

@@ -0,0 +1,113 @@
+@import './tokens.css';
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+  min-height: 100%;
+}
+
+body.amiga-workbench {
+  font-family: var(--amiga-font);
+  font-size: var(--amiga-font-size);
+  line-height: var(--amiga-line-height);
+  letter-spacing: 0.5px;
+  color: var(--amiga-fg);
+  background-color: var(--amiga-bg);
+
+  /* Pixel / sawtooth — disable font smoothing */
+  -webkit-font-smoothing: none;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeSpeed;
+  font-smooth: never;
+}
+
+body.amiga-workbench img {
+  image-rendering: pixelated;
+  image-rendering: crisp-edges;
+}
+
+#app {
+  min-height: 100vh;
+  min-height: 100dvh;
+  padding: 16px;
+}
+
+.amiga-shell {
+  max-width: 960px;
+  margin: 0 auto;
+}
+
+.amiga-titlebar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  background: var(--amiga-accent);
+  color: var(--mwb-white);
+  padding: 4px 8px;
+  margin-bottom: 0;
+}
+
+.amiga-titlebar__brand {
+  margin: 0;
+  font-size: 16px;
+  line-height: 20px;
+  font-weight: normal;
+}
+
+.amiga-titlebar__meta {
+  font-size: 16px;
+  line-height: 20px;
+  white-space: nowrap;
+}
+
+.amiga-panel {
+  background: var(--amiga-bg);
+  border: 2px solid var(--mwb-black);
+  border-top: none;
+  padding: 16px;
+}
+
+.amiga-panel p {
+  margin: 0 0 16px;
+}
+
+.amiga-panel p:last-child {
+  margin-bottom: 0;
+}
+
+.amiga-swatches {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin: 16px 0 0;
+  padding: 0;
+  list-style: none;
+}
+
+.amiga-swatches li {
+  width: 32px;
+  height: 32px;
+  border: 2px solid var(--mwb-black);
+}
+
+.amiga-swatches li[data-pen='0'] { background: var(--mwb-gray); }
+.amiga-swatches li[data-pen='1'] { background: var(--mwb-black); }
+.amiga-swatches li[data-pen='2'] { background: var(--mwb-white); }
+.amiga-swatches li[data-pen='3'] { background: var(--mwb-blue); }
+.amiga-swatches li[data-pen='4'] { background: var(--mwb-halfshadow); }
+.amiga-swatches li[data-pen='5'] { background: var(--mwb-halfshine); }
+.amiga-swatches li[data-pen='6'] { background: var(--mwb-tan); }
+.amiga-swatches li[data-pen='7'] { background: var(--mwb-peach); }
+
+@media (max-width: 640px), ((max-height: 500px) and (orientation: landscape)) {
+  #app {
+    padding: 8px;
+  }
+}

src/amiga/tokenValues.js

@@ -0,0 +1,28 @@
+/**
+ * Magic Workbench 8-pen palette + semantic aliases.
+ * Keep hex in sync with `tokens.css`.
+ * Source: MagicWB canonical RGB (Wikipedia / MagicWB docs).
+ */
+export const MWB_PENS = Object.freeze({
+  0: '#959595',
+  1: '#000000',
+  2: '#FFFFFF',
+  3: '#3B67A2',
+  4: '#7B7B7B',
+  5: '#AFAFAF',
+  6: '#AA907C',
+  7: '#FFA997',
+});
+
+export const AMIGA_TOKEN_HEX = Object.freeze({
+  bg: MWB_PENS[0],
+  fg: MWB_PENS[1],
+  white: MWB_PENS[2],
+  accent: MWB_PENS[3],
+  halfshadow: MWB_PENS[4],
+  halfshine: MWB_PENS[5],
+  tan: MWB_PENS[6],
+  peach: MWB_PENS[7],
+  fontSizePx: 16,
+  lineHeightPx: 20,
+});

src/amiga/tokens.css

@@ -0,0 +1,30 @@
+/**
+ * Magic Workbench tokens — source of truth for `/amiga` chrome.
+ * Hex mirrored in `tokenValues.js` for tests.
+ */
+
+@font-face {
+  font-family: 'TopazNew';
+  src: url('./assets/fonts/Topaz_a1200_v1.0.ttf') format('truetype');
+  font-weight: normal;
+  font-style: normal;
+  font-display: block;
+}
+
+:root {
+  --mwb-gray: #959595;
+  --mwb-black: #000000;
+  --mwb-white: #ffffff;
+  --mwb-blue: #3b67a2;
+  --mwb-halfshadow: #7b7b7b;
+  --mwb-halfshine: #afafaf;
+  --mwb-tan: #aa907c;
+  --mwb-peach: #ffa997;
+
+  --amiga-bg: var(--mwb-gray);
+  --amiga-fg: var(--mwb-black);
+  --amiga-accent: var(--mwb-blue);
+  --amiga-font: 'TopazNew', monospace;
+  --amiga-font-size: 16px;
+  --amiga-line-height: 20px;
+}

src/amiga/version.js

@@ -0,0 +1,3 @@
+/** Product version for the `/amiga` MPA shell (sync with manifest on bump). */
+export const PRODUCT_NAME = 'VHectorLab-3D';
+export const PRODUCT_VERSION = '2.4.0';

src/ui/Navbar.js

@@ -53,7 +53,7 @@ export class Navbar {
         <div class="logo-icon">🌐</div>
         <div class="title-group">
           <h1>VHectorLab <span class="accent-3d">3D</span></h1>
-          <span class="version-tag">v2.3.0</span>
+          <span class="version-tag">v2.4.0</span>
         </div>
       </div>
 

tests/amigaTokens.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+import { AMIGA_TOKEN_HEX, MWB_PENS } from '../src/amiga/tokenValues.js';
+import { PRODUCT_VERSION } from '../src/amiga/version.js';
+
+describe('MagicWB pens', () => {
+  it('exposes the canonical 8-pen palette', () => {
+    expect(MWB_PENS).toEqual({
+      0: '#959595',
+      1: '#000000',
+      2: '#FFFFFF',
+      3: '#3B67A2',
+      4: '#7B7B7B',
+      5: '#AFAFAF',
+      6: '#AA907C',
+      7: '#FFA997',
+    });
+  });
+});
+
+describe('amiga semantic tokens', () => {
+  it('maps bg/fg/accent to MagicWB pens', () => {
+    expect(AMIGA_TOKEN_HEX.bg).toBe(MWB_PENS[0]);
+    expect(AMIGA_TOKEN_HEX.fg).toBe(MWB_PENS[1]);
+    expect(AMIGA_TOKEN_HEX.accent).toBe(MWB_PENS[3]);
+  });
+
+  it('uses pixel-perfect 16/20 typography sizes', () => {
+    expect(AMIGA_TOKEN_HEX.fontSizePx).toBe(16);
+    expect(AMIGA_TOKEN_HEX.lineHeightPx).toBe(20);
+    expect(AMIGA_TOKEN_HEX.fontSizePx % 8).toBe(0);
+  });
+});
+
+describe('amiga product version', () => {
+  it('starts the 2.4.x line', () => {
+    expect(PRODUCT_VERSION).toMatch(/^2\.4\.\d+$/);
+  });
+});

tests/viteMpaInputs.test.js

@@ -3,12 +3,13 @@ import { describe, expect, it } from 'vitest';
 import { getViteInputs, mpaTrailingSlashLocation } from '../vite.mpa.js';
 
 describe('getViteInputs', () => {
-  it('includes legacy root and v25 MPA HTML entries', () => {
+  it('includes legacy root, v25, and amiga MPA HTML entries', () => {
     const root = path.resolve('/tmp/vhectorlab-fixture');
     const inputs = getViteInputs(root);
     expect(inputs).toEqual({
       main: path.resolve(root, 'index.html'),
       v25: path.resolve(root, 'v25/index.html'),
+      amiga: path.resolve(root, 'amiga/index.html'),
     });
   });
 });
@@ -18,13 +19,20 @@ describe('mpaTrailingSlashLocation', () => {
     expect(mpaTrailingSlashLocation('/v25')).toBe('/v25/');
   });
 
+  it('redirects bare /amiga to /amiga/', () => {
+    expect(mpaTrailingSlashLocation('/amiga')).toBe('/amiga/');
+  });
+
   it('preserves query string', () => {
     expect(mpaTrailingSlashLocation('/v25?x=1')).toBe('/v25/?x=1');
+    expect(mpaTrailingSlashLocation('/amiga?x=1')).toBe('/amiga/?x=1');
   });
 
-  it('leaves /v25/ and legacy / alone', () => {
+  it('leaves trailing-slash MPA paths and legacy / alone', () => {
     expect(mpaTrailingSlashLocation('/v25/')).toBeNull();
+    expect(mpaTrailingSlashLocation('/amiga/')).toBeNull();
     expect(mpaTrailingSlashLocation('/')).toBeNull();
     expect(mpaTrailingSlashLocation('/v25/index.html')).toBeNull();
+    expect(mpaTrailingSlashLocation('/amiga/index.html')).toBeNull();
   });
 });

vite.mpa.js

@@ -1,28 +1,29 @@
 import path from 'node:path';
 
 /**
- * Vite multi-page inputs: legacy `/` + parallel skin `/v25/`.
- * Keep keys stable — build emits `dist/index.html` and `dist/v25/index.html`.
+ * Vite multi-page inputs: legacy `/` + parallel skins `/v25/` + `/amiga/`.
+ * Keep keys stable — build emits matching `dist/.../index.html` paths.
  *
  * @param {string} rootDir Absolute project root (repo cwd).
- * @returns {{ main: string, v25: string }}
+ * @returns {{ main: string, v25: string, amiga: string }}
  */
 export function getViteInputs(rootDir) {
   return {
     main: path.resolve(rootDir, 'index.html'),
     v25: path.resolve(rootDir, 'v25/index.html'),
+    amiga: path.resolve(rootDir, 'amiga/index.html'),
   };
 }
 
 /**
- * Vite SPA fallback treats `/v25` (no slash) as unknown → serves legacy `index.html`.
+ * Vite SPA fallback treats bare MPA dirs (no slash) as unknown → serves legacy `index.html`.
  * Redirect bare MPA dirs to their trailing-slash URL.
  *
  * @param {string} urlPath `req.url` (path + optional query)
  * @param {string[]} mpaDirs Absolute path prefixes without trailing slash
  * @returns {string | null} Location header value, or null if no redirect
  */
-export function mpaTrailingSlashLocation(urlPath, mpaDirs = ['/v25']) {
+export function mpaTrailingSlashLocation(urlPath, mpaDirs = ['/v25', '/amiga']) {
   const qIndex = urlPath.indexOf('?');
   const pathname = qIndex === -1 ? urlPath : urlPath.slice(0, qIndex);
   const query = qIndex === -1 ? '' : urlPath.slice(qIndex);
@@ -32,8 +33,8 @@ export function mpaTrailingSlashLocation(urlPath, mpaDirs = ['/v25']) {
   return null;
 }
 
-/** Vite plugin: 302 `/v25` → `/v25/` (dev + preview). */
-export function mpaTrailingSlashRedirect(mpaDirs = ['/v25']) {
+/** Vite plugin: 302 bare MPA dirs → trailing slash (dev + preview). */
+export function mpaTrailingSlashRedirect(mpaDirs = ['/v25', '/amiga']) {
   const attach = (middlewares) => {
     middlewares.use((req, res, next) => {
       const location = mpaTrailingSlashLocation(req.url || '', mpaDirs);