feat(0.5.0)!: retire the legacy React UI

The Cowork dashboard at / has been the only thing anyone uses since
0.4.0 shipped. Time to drop the dual-UI maintenance burden.

Removed:
  - ui/                          (React + Vite + node_modules sources)
  - sidecar/attune_gui/static/   (the bundled React build that shipped in the wheel)
  - build_hooks.py               (npm-driven hatchling hook)
  - scripts/dev.sh               (Vite + sidecar dual-runner)
  - /legacy/ URL route + _mount_legacy_ui in app.py
  - 'Legacy UI ↗' link in the sidebar + .legacy-link CSS rules
  - sdist 'ui/*' includes + [tool.hatch.*.hooks.custom] blocks in pyproject.toml

Kept:
  - Every JSON API (/api/*) exactly as before
  - The Cowork dashboard at / (Health, Templates, Specs, Summaries,
    Living Docs, Commands, Jobs)
  - All 124 tests, all passing

Build impact:
  - Wheel size: 122K → 65K (-47%)
  - Sdist size: 139K → 62K (-55%)
  - No more 'npm install' required to build the wheel
  - No Node/Vite anywhere in the toolchain

Anyone with a /legacy/ bookmark gets a 404. Anyone who needs the React
UI for any reason can install attune-gui==0.4.0.

Verified end-to-end: ruff clean, 124 tests pass, wheel installs cleanly
in an isolated env, all routes resolve as expected (/ → 307 /dashboard,
/legacy → 404).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: silversurfer562

CHANGELOG.md

@@ -3,6 +3,40 @@
 All notable changes to `attune-gui` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.5.0] — 2026-05-04
+
+### Removed — legacy React UI
+
+The React/Vite UI has been retired. The Cowork dashboard at `/` is now
+the only surface. This was always the plan from the `cowork-dashboard`
+spec; 0.4.0 ran the two side-by-side to give you time to vet the new
+one. With everything verified in production, the bundled React assets
+are dead weight.
+
+What goes away:
+- `/legacy/` URL route — anyone with a bookmark gets a 404.
+- `ui/` source tree (React + Vite + node_modules) — no more `npm install`
+  to build the wheel.
+- `sidecar/attune_gui/static/` — the built React assets that shipped in
+  the wheel. Wheel size drops dramatically as a result.
+- `build_hooks.py` — the hatchling hook that drove `npm run build`.
+- `scripts/dev.sh` — the dual-runner script.
+- The "Legacy UI ↗" link in the dashboard sidebar.
+
+What stays the same:
+- All JSON APIs (`/api/*`) — including the old ones that powered the
+  React UI. Any external scripts hitting those continue to work.
+- The Cowork dashboard at `/` — same routes, same look.
+- Tests (124, all passing) — none of them hit the legacy mount.
+
+If you need the old React UI for any reason, install `attune-gui==0.4.0`.
+
+### Changed
+- `pyproject.toml` description updated; sdist no longer includes `ui/*`
+  or `build_hooks.py`.
+
+---
+
 ## [0.4.0] — 2026-05-04
 
 ### Added — Spec authoring

README.md

@@ -22,9 +22,6 @@ Sidebar nav with seven pages, each consuming the existing JSON API:
 Click any spec or template to open the **Preview / Edit** panel — server-side
 Markdown rendering plus a raw `<textarea>` for editing.
 
-> Prefer the React UI? It's still bundled and reachable at
-> `/legacy/`. Both surfaces talk to the same FastAPI sidecar.
-
 > Looking for AI dev workflows (code review, security audits, refactor
 > planning, multi-agent orchestration)? Those live in
 > [`attune-ai`](https://pypi.org/project/attune-ai/) — a separate
@@ -81,17 +78,14 @@ uv sync
 uv run attune-gui --port 8765 --reload
 ```
 
-For HMR work on the React UI at `/legacy/`:
-
-```bash
-cd ui && npm install && cd ..
-./scripts/dev.sh   # starts sidecar + Vite dev server
-```
+Templates auto-reload — edit anything under `sidecar/attune_gui/templates/`
+and refresh the browser. Python code changes reload automatically with
+`--reload`.
 
 ### Tests
 
 ```bash
-uv run pytest                # 105 tests, ~2s
+uv run pytest                # 124 tests, ~2s
 uv run ruff check .          # lint
 ```
 
@@ -100,7 +94,6 @@ uv run ruff check .          # lint
 ```
 ┌──────────────────────────────────────┐
 │  Cowork dashboard (Jinja2)  /        │
-│  Legacy React UI            /legacy/ │
 └──────────────────┬───────────────────┘
                    │  /api/*
 ┌──────────────────▼───────────────────┐

build_hooks.py

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "attune-gui"
-version = "0.4.0"
-description = "Local dashboard for attune-rag / attune-help / attune-author. Server-rendered Jinja2 UI (Cowork) with React UI preserved at /legacy/."
+version = "0.5.0"
+description = "Local dashboard for attune-rag / attune-help / attune-author. Server-rendered Jinja2 UI — ships clean via PyPI with no npm step."
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "Apache-2.0"}
@@ -61,25 +61,13 @@ packages = ["sidecar/attune_gui"]
 [tool.hatch.build.targets.sdist]
 include = [
     "sidecar/attune_gui",
-    "ui/src",
-    "ui/index.html",
-    "ui/package.json",
-    "ui/package-lock.json",
-    "ui/vite.config.js",
-    "scripts",
-    "build_hooks.py",
+    "sidecar/tests",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
     "pyproject.toml",
 ]
 
-[tool.hatch.build.targets.wheel.hooks.custom]
-path = "build_hooks.py"
-
-[tool.hatch.build.targets.sdist.hooks.custom]
-path = "build_hooks.py"
-
 [tool.ruff]
 line-length = 100
 target-version = "py310"

pyproject.toml

@@ -0,0 +1,23 @@
+version: 1
+features:
+  attune-gui:
+    description: "attune-gui \u2014 local FastAPI sidecar that drives attune-rag,\
+      \ attune-author, and (later) attune-ai."
+    files:
+    - attune_gui/**
+  attune-gui.egg-info:
+    description: Attune Gui.Egg Info
+    files:
+    - attune_gui.egg-info/**
+  attune_gui-entry:
+    description: 'Entry point: attune_gui/app.py'
+    files:
+    - attune_gui/app.py
+    tags:
+    - entry-point
+  tests:
+    description: Tests
+    files:
+    - tests/**
+    tags:
+    - testing

scripts/dev.sh

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"

sidecar/.help/features.yaml

@@ -1,7 +1,7 @@
 """FastAPI app factory — wires routes, CORS, and the origin guard.
 
-Mounts the new Cowork dashboard at ``/`` (Jinja2 server-rendered) and keeps
-the legacy React UI available at ``/legacy/`` for fallback.
+Serves the Cowork dashboard (Jinja2) at ``/`` and the JSON APIs under
+``/api/*``. The legacy React UI was retired in 0.5.0.
 """
 
 from __future__ import annotations
@@ -11,7 +11,7 @@
 
 from fastapi import Depends, FastAPI
 from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import HTMLResponse, PlainTextResponse
+from fastapi.responses import PlainTextResponse
 from fastapi.staticfiles import StaticFiles
 
 from attune_gui import __version__
@@ -34,10 +34,8 @@
 
 logger = logging.getLogger(__name__)
 
-# Package-relative dirs.
-_PKG_DIR = Path(__file__).parent
-_STATIC_DIR = _PKG_DIR / "static"  # legacy React build output
-_CW_STATIC_DIR = _PKG_DIR / "static_cw"  # Cowork dashboard CSS/JS
+# Cowork dashboard CSS/JS lives next to the package.
+_CW_STATIC_DIR = Path(__file__).parent / "static_cw"
 
 
 def create_app() -> FastAPI:
@@ -58,7 +56,7 @@ def create_app() -> FastAPI:
         allow_headers=["*"],
     )
 
-    # ---- JSON APIs (existing) -------------------------------------------------
+    # ---- JSON APIs (existing) -----------------------------------------------
     app.include_router(system.router)
     app.include_router(fs.router)
     app.include_router(rag.router)
@@ -78,8 +76,10 @@ def create_app() -> FastAPI:
     if _CW_STATIC_DIR.is_dir():
         app.mount("/cw-static", StaticFiles(directory=_CW_STATIC_DIR), name="cw-static")
 
-    # ---- Legacy React UI at /legacy/ ----------------------------------------
-    _mount_legacy_ui(app)
+    # ---- robots --------------------------------------------------------------
+    @app.get("/robots.txt", response_class=PlainTextResponse, include_in_schema=False)
+    async def _robots() -> str:
+        return "User-agent: *\nDisallow: /\n"
 
     # ---- Cowork HTML pages (registered LAST so /api/* still resolves first) -
     # The pages router defines /, /dashboard, /dashboard/<page>. Specific
@@ -88,37 +88,3 @@ def create_app() -> FastAPI:
     app.include_router(cowork_pages.router)
 
     return app
-
-
-def _mount_legacy_ui(app: FastAPI) -> None:
-    """Mount the React UI at ``/legacy/`` so the new dashboard owns ``/``."""
-    if _STATIC_DIR.is_dir() and (_STATIC_DIR / "index.html").is_file():
-        app.mount(
-            "/legacy",
-            StaticFiles(directory=_STATIC_DIR, html=True),
-            name="legacy-ui",
-        )
-        return
-
-    # Development fallback: serve the Vite build output.
-    repo_root = Path(__file__).resolve().parents[2]
-    dist_ui = repo_root / "ui" / "dist"
-    if dist_ui.is_dir() and (dist_ui / "index.html").is_file():
-        app.mount(
-            "/legacy",
-            StaticFiles(directory=dist_ui, html=True),
-            name="legacy-ui-dist",
-        )
-        return
-
-    @app.get("/legacy", response_class=HTMLResponse)
-    async def _legacy_placeholder() -> str:
-        return (
-            "<h1>Legacy React UI not built</h1>"
-            "<p>Run <code>cd ui && npm run build</code> to enable the legacy UI.</p>"
-            "<p><a href='/dashboard'>← Back to dashboard</a></p>"
-        )
-
-    @app.get("/robots.txt", response_class=PlainTextResponse)
-    async def _robots() -> str:
-        return "User-agent: *\nDisallow: /\n"

sidecar/attune_gui/__init__.py

@@ -101,15 +101,6 @@ code, .mono {
   color: var(--sidebar-active);
 }
 
-.sidebar-foot { margin-top: auto; }
-.legacy-link {
-  font-size: 0.75rem;
-  color: var(--ink-mute);
-  padding: 8px 12px;
-  display: block;
-}
-.legacy-link:hover { color: var(--sidebar-active); text-decoration: none; }
-
 /* ── Main canvas ───────────────────────────────────────────────────────── */
 
 .main {

sidecar/attune_gui/app.py

@@ -17,9 +17,6 @@
            data-slug="{{ item.slug }}">{{ item.label }}</a>
       {% endfor %}
     </nav>
-    <div class="sidebar-foot">
-      <a href="/legacy/" class="legacy-link" title="Open the React UI">Legacy UI ↗</a>
-    </div>
   </aside>
 
   <main class="main">