build: bound retained chat assets

apps/presentation/dashboard/vite.chat.config.ts

@@ -1,12 +1,67 @@
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import tailwindcss from "@tailwindcss/vite";
 import react from "@vitejs/plugin-react";
 import { resolve } from "node:path";
 import { defineConfig, type Plugin } from "vite";
 
 const dashboardPublicDir = resolve(import.meta.dirname, "public");
+const chatOutDir = resolve(import.meta.dirname, "../../../loopx/web/chat");
+const retainedAssetsPath = resolve(chatOutDir, "asset-retention.json");
 const sharedPwaAssets = ["manifest.webmanifest", "pwa/icon-192.png", "pwa/icon-512.png"] as const;
 
+function retainedChatAssets(): Plugin {
+  const previousIndex = resolve(chatOutDir, "index.html");
+  const previousEntryAssets = existsSync(previousIndex)
+    ? [...readFileSync(previousIndex, "utf8").matchAll(/(?:src|href)="\/chat\/(assets\/[^"]+)"/g)].map((match) => match[1])
+    : [];
+  const previousManifest = existsSync(retainedAssetsPath)
+    ? JSON.parse(readFileSync(retainedAssetsPath, "utf8"))
+    : { schema_version: "loopx_chat_asset_retention_v1", generations: [] };
+  const previousGenerations = previousManifest.generations;
+  if (previousManifest.schema_version !== "loopx_chat_asset_retention_v1"
+    || !Array.isArray(previousGenerations) || previousGenerations.some(
+    (generation) => !Array.isArray(generation) || generation.some(
+      (asset) => typeof asset !== "string" || !/^assets\/[A-Za-z0-9._-]+$/.test(asset),
+    ),
+  )) {
+    throw new Error("Invalid chat asset retention manifest");
+  }
+  const previousGeneration = previousGenerations.find((generation) =>
+    previousEntryAssets.every((asset) => generation.includes(asset)),
+  ) ?? previousEntryAssets;
+
+  return {
+    name: "loopx-bounded-chat-asset-retention",
+    writeBundle(_options, bundle) {
+      const generations: string[][] = [];
+      const retained = new Set<string>();
+      for (const generation of [
+        Object.keys(bundle).filter((path) => path.startsWith("assets/")).sort(),
+        previousGeneration,
+        ...previousGenerations,
+      ]) {
+        const normalized = [...new Set(generation)].sort();
+        if (normalized.some((asset) => !existsSync(resolve(chatOutDir, asset)))) continue;
+        if (normalized.every((asset) => retained.has(asset))) continue;
+        if (normalized.length && !generations.some((item) => item.join("\0") === normalized.join("\0"))) {
+          generations.push(normalized);
+          normalized.forEach((asset) => retained.add(asset));
+        }
+        // ponytail: one prior bundle protects rolling upgrades; add a larger
+        // retention window only if multi-release stale tabs become a real need.
+        if (generations.length === 2) break;
+      }
+      for (const name of readdirSync(resolve(chatOutDir, "assets"))) {
+        if (!retained.has(`assets/${name}`)) rmSync(resolve(chatOutDir, "assets", name));
+      }
+      writeFileSync(retainedAssetsPath, `${JSON.stringify({
+        schema_version: "loopx_chat_asset_retention_v1",
+        generations,
+      }, null, 2)}\n`);
+    },
+  };
+}
+
 function emitSharedPwaAssets(): Plugin {
   return {
     name: "loopx-shared-dashboard-pwa-assets",
@@ -28,12 +83,10 @@ export default defineConfig({
   // The chat bundle shares the root dashboard's manifest and icons without
   // copying unrelated showcase assets into the packaged chat directory.
   publicDir: false,
-  plugins: [react(), tailwindcss(), emitSharedPwaAssets()],
+  plugins: [react(), tailwindcss(), emitSharedPwaAssets(), retainedChatAssets()],
   build: {
-    outDir: resolve(import.meta.dirname, "../../../loopx/web/chat"),
-    // Keep prior hashed assets: a running dashboard or an in-flight page may
-    // still reference an older index.html; deleting old files turns a stale
-    // page into a white screen. index.html always points at the newest hashes.
+    outDir: chatOutDir,
+    // Retention is bounded by retainedChatAssets instead of growing forever.
     emptyOutDir: false,
   },
 });

examples/dashboard-pwa-bundle-smoke.py

@@ -4,6 +4,7 @@
 from __future__ import annotations
 
 import json
+import re
 from pathlib import Path
 
 
@@ -52,6 +53,27 @@ def assert_pwa_bundle(label: str, bundle: Path, manifest_href: str) -> None:
     )
 
 
+def assert_bounded_chat_assets() -> None:
+    retention = json.loads(
+        (CHAT_BUNDLE / "asset-retention.json").read_text(encoding="utf-8")
+    )
+    assert retention["schema_version"] == "loopx_chat_asset_retention_v1"
+    generations = retention["generations"]
+    assert 1 <= len(generations) <= 2, generations
+    retained = {asset for generation in generations for asset in generation}
+    referenced = set(
+        re.findall(
+            r'(?:src|href)="/chat/(assets/[^"]+)"',
+            (CHAT_BUNDLE / "index.html").read_text(encoding="utf-8"),
+        )
+    )
+    assert referenced <= set(generations[0]), (referenced, generations[0])
+    assert retained == {
+        f"assets/{path.name}" for path in (CHAT_BUNDLE / "assets").iterdir()
+    }
+    assert all((CHAT_BUNDLE / asset).is_file() for asset in retained)
+
+
 def main() -> int:
     # The full-public suite is Python-only and starts from a clean checkout, so
     # the ignored Vite output is not guaranteed to exist. Always validate the
@@ -66,6 +88,7 @@ def main() -> int:
     if ROOT_BUNDLE.is_dir():
         assert_pwa_bundle("root dashboard bundle", ROOT_BUNDLE, "manifest.webmanifest")
     assert_pwa_bundle("chat dashboard", CHAT_BUNDLE, "/chat/manifest.webmanifest")
+    assert_bounded_chat_assets()
     print("dashboard-pwa-bundle-smoke ok")
     return 0
 

loopx/web/chat/asset-retention.json

@@ -0,0 +1,35 @@
+{
+  "schema_version": "loopx_chat_asset_retention_v1",
+  "generations": [
+    [
+      "assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2",
+      "assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2",
+      "assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2",
+      "assets/geist-latin-wght-normal-BgDaEnEv.woff2",
+      "assets/geist-mono-cyrillic-ext-wght-normal-X_5orZeX.woff2",
+      "assets/geist-mono-cyrillic-wght-normal-DiZS0aHC.woff2",
+      "assets/geist-mono-latin-ext-wght-normal-Bwz-egvJ.woff2",
+      "assets/geist-mono-latin-wght-normal-XN7g48iV.woff2",
+      "assets/geist-mono-symbols2-wght-normal-CO5SzqOn.woff2",
+      "assets/geist-mono-vietnamese-wght-normal-DadHysG0.woff2",
+      "assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2",
+      "assets/index-Bb6tQe9a.js",
+      "assets/index-CAld8Q9B.css"
+    ],
+    [
+      "assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2",
+      "assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2",
+      "assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2",
+      "assets/geist-latin-wght-normal-BgDaEnEv.woff2",
+      "assets/geist-mono-cyrillic-ext-wght-normal-X_5orZeX.woff2",
+      "assets/geist-mono-cyrillic-wght-normal-DiZS0aHC.woff2",
+      "assets/geist-mono-latin-ext-wght-normal-Bwz-egvJ.woff2",
+      "assets/geist-mono-latin-wght-normal-XN7g48iV.woff2",
+      "assets/geist-mono-symbols2-wght-normal-CO5SzqOn.woff2",
+      "assets/geist-mono-vietnamese-wght-normal-DadHysG0.woff2",
+      "assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2",
+      "assets/index-BCCJib1i.css",
+      "assets/index-o5yb9gCp.js"
+    ]
+  ]
+}