1 files changed, 17 insertions, 15 deletions
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/video-app.js b/packages/meshbay-hub/src/meshbay_hub/static/video-app.js
index d4af4ef..d4ec01a 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/video-app.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/video-app.js
@@ -10,16 +10,16 @@ import { usePager, Pager, pageSizeFrom } from './pager.js';
 // ── Videos ───────────────────────────────────────────────────────────────────
 //
 // A poster-grid (TMDB-enriched) or flat (thumbnail-only) browser for a
-// group's video files, per docs/mediacenter.md. Grouping: one card per movie,
-// one card per show — shows are grouped by `display_title` (already
+// group's video files, per docs/MESHBAY_DESIGN.md §9.7. Grouping: one card per
+// movie, one card per show — shows are grouped by `display_title` (already
 // resolved/corroborated at index time, §3.4), not by folder path, since a
 // client-side path convention would have to guess how many roots/subfolders
 // deep a show folder sits, which display_title already settled once.
 //
 // TMDB metadata is fetched lazily, only for a tile once it is actually
-// visible (LazyTile below) — apps.md §5's virtualization requirement for a
-// grid of many tiles. Thumbnails go through the same `file_req`/chunk path
-// as a real file (docs/mediacenter.md §5.3) via MediaThumb, reusing
+// visible (LazyTile below) — the virtualization requirement for a grid of
+// many tiles. Thumbnails go through the same `file_req`/chunk path
+// as a real file (docs/MESHBAY_DESIGN.md §6.5) via MediaThumb, reusing
 // chat-app.js's ChatImage pattern.
 
 const VIEW_MODE_KEY = 'meshbay_video_view_mode';
@@ -121,7 +121,7 @@ function groupVideoEntries(entries, videoDirectories) {
   return { movies, shows };
 }
 
-// ── lazy-mount tile (apps.md §5 virtualization) ─────────────────────────────
+// ── lazy-mount tile (virtualization) ───────────────────────────────────────
 
 const LAZY_TILE_MARGIN = 300;
 
@@ -485,7 +485,7 @@ function OverviewText({ text, reserve }) {
   `;
 }
 
-// ── season picker (docs/mediacenter.md §5.4's fix for a mis-scoped overview) ─
+// ── season picker (docs/MESHBAY_DESIGN.md §9.7's per-season text) ────────────
 //
 // A row of tabs, which this was, scrolls horizontally once a show has more
 // seasons than fit — a scrollbar nobody finds, hiding the seasons that matter
@@ -708,7 +708,7 @@ function VideoDetailModal({
   const [rematching, setRematching] = useState(false);
   const mediaType = show ? 'tv' : 'movie';
 
-  // §10.1/V13: drop this file's cached match on the node and let it
+  // V13: drop this file's cached match on the node and let it
   // re-resolve with the current matcher — the one-click alternative to the
   // full search-and-pick flow above.
   const doRematch = useCallback(async () => {
@@ -779,10 +779,11 @@ function VideoDetailModal({
           `}
           ${/* Both of these act on a TMDB match, and with TMDB off for this
                 group there is none to act on: "Fix match" opens a search the
-                node answers with an empty result list (§5.7's silent
-                degradation), and "Rematch" drops a cached match that was
-                never made. Two buttons that cannot do anything, offered to
-                the one person who already knows why. */''}
+                node answers with an empty result list
+                (docs/MESHBAY_DESIGN.md §9.7's silent degradation), and
+                "Rematch" drops a cached match that was never made. Two
+                buttons that cannot do anything, offered to the one person
+                who already knows why. */''}
           ${isNodeAdmin && tmdbEnabled && html`
             <div class="video-admin-actions">
               <button class="admin-btn video-fix-match" onClick=${() => setSearching(true)}>
@@ -1182,9 +1183,10 @@ function VideoApp({
   `;
 }
 
-// MediaThumb and LazyTile are also used by music-app.js (docs/musicbay.md
-// §7.1): the same "decrypt a thumb_hash via the chunk path into a cached
+// MediaThumb and LazyTile are also used by music-app.js
+// (docs/MESHBAY_DESIGN.md §9.8): the same "decrypt a thumb_hash via the
+// chunk path into a cached
 // blob" and "mount only once actually scrolled near" mechanisms apply to a
 // track's cover art unchanged, so Music imports them here rather than
-// re-implementing (apps.md §4's checklist).
+// re-implementing (docs/MESHBAY_DESIGN.md §9.4's checklist).
 export { VideoApp, MediaThumb, LazyTile, groupVideoEntries, bumpMediaMetaGeneration, bumpThumbGeneration };