@brightsideoy/kama 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/schema-compiler.js

@@ -30,19 +30,19 @@ async function f() {
 	if (n(f)) l = (await import(t(f).href)).compileDefinitions;
 	else if (n(p)) l = (await import(t(p).href)).compileDefinitions;
 	else try {
-		l = (await import("./dist-Dy7-HUEG.js")).compileDefinitions;
+		l = (await import("./dist-cK3xGnBZ.js")).compileDefinitions;
 	} catch (e) {
-		console.error("❌ Could not resolve Kama Schema Engine:", e), process.exit(1);
+		console.error("\x1B[31m  ✖\x1B[0m \x1B[31mCould not resolve Kama Schema Engine:\x1B[0m", e), process.exit(1);
 	}
-	l || (console.error("❌ compileDefinitions function missing from resolved module"), process.exit(1));
+	l || (console.error("\x1B[31m  ✖\x1B[0m \x1B[31mcompileDefinitions function missing from resolved module\x1B[0m"), process.exit(1));
 	let m = l(), h = Object.keys(m?.nodes || {}).length, g = Object.keys(m?.blocks || {}).length, _ = Object.keys(m?.taxonomies || {}).length, v = `// AUTO-GENERATED BUNDLE - DO NOT EDIT
 const defs = ${JSON.stringify(m, null, 2)};
 export const BUNDLED_DEFINITIONS = defs;
 export default defs;
 `;
-	a(c, v, "utf-8"), console.log(`✅ Schema securely compiled using engine.ts to ${c} (${h} nodes, ${g} blocks, ${_} taxonomies)`);
+	a(c, v, "utf-8"), console.log(`\x1b[32m  ✓\x1b[0m \x1b[2mSchemas bundled (${h} nodes, ${g} blocks, ${_} taxonomies)\x1b[0m`);
 }
 f().catch((e) => {
-	console.error("❌ Schema Compiler Runtime Error:", e), process.exit(1);
+	console.error("\x1B[31m  ✖\x1B[0m \x1B[31mSchema Compiler Runtime Error:\x1B[0m", e), process.exit(1);
 });
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightsideoy/kama",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -33,6 +33,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@clack/prompts": "^1.8.1",
     "@heroicons/vue": "^2.2.0",
     "@hono/node-server": "^2.1.1",
     "@hono/swagger-ui": "^0.6.1",

package/schema.sql

@@ -13,7 +13,7 @@ CREATE TABLE IF NOT EXISTS "content_schemas" (
 
 CREATE TABLE IF NOT EXISTS "users" (
     id TEXT PRIMARY KEY,
-    email TEXT UNIQUE NOT NULL,
+    email UNIQUE NOT NULL,
     name TEXT NOT NULL,
     globalRole TEXT DEFAULT 'editor',
     createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
@@ -201,6 +201,22 @@ CREATE TABLE IF NOT EXISTS "node_terms" (
     FOREIGN KEY (termId) REFERENCES taxonomy_terms(id) ON DELETE CASCADE
   );
 
+CREATE TABLE IF NOT EXISTS "node_routes" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    path TEXT NOT NULL,
+    channelId INTEGER NOT NULL,
+    nodeId INTEGER,
+    treeId INTEGER,
+    isCanonical INTEGER DEFAULT 1,
+    redirectUrl TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (channelId) REFERENCES channels(id) ON DELETE CASCADE,
+    FOREIGN KEY (nodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (treeId) REFERENCES trees(id) ON DELETE CASCADE,
+    UNIQUE(path, channelId)
+  );
+
 CREATE INDEX IF NOT EXISTS idx_tree_nodes_tree_parent ON tree_nodes(treeId, parentId);
 CREATE INDEX IF NOT EXISTS idx_tree_nodes_contentId ON tree_nodes(contentId);
 CREATE INDEX IF NOT EXISTS idx_content_nodes_slug_status ON content_nodes(slug, status);
@@ -233,3 +249,5 @@ CREATE INDEX IF NOT EXISTS idx_node_terms_node ON node_terms(nodeId);
 CREATE INDEX IF NOT EXISTS idx_node_terms_term ON node_terms(termId);
 CREATE INDEX IF NOT EXISTS idx_node_terms_node_term ON node_terms(nodeId, termId);
 CREATE INDEX IF NOT EXISTS idx_node_terms_term_node ON node_terms(termId, nodeId);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_node_routes_lookup ON node_routes(path, channelId);
+CREATE INDEX IF NOT EXISTS idx_node_routes_node ON node_routes(nodeId);

package/templates/astro-starter/src/components/global/Breadcrumb.astro

@@ -7,24 +7,60 @@ interface Props {
   isHomePage?: boolean;
 }
 
-const { title, slug, isHomePage } = Astro.props;
+const { title, isHomePage } = Astro.props;
 
-// 🎯 Detect home page via URL pathname or explicit flag
-const isHome = isHomePage || Astro.url.pathname === "/" || !slug || slug === "";
+const currentPath = Astro.url.pathname;
+
+// Extract non-empty path segments
+const rawSegments = currentPath.split("/").filter(Boolean);
+
+// Detect homepage
+const isHome = isHomePage || currentPath === "/" || rawSegments.length === 0;
+
+function formatSegmentTitle(segment: string): string {
+  return segment
+    .split("-")
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(" ");
+}
+
+// Build progressive paths: /some-page, /some-page/child-page, etc.
+let runningPath = "";
+const breadcrumbItems = rawSegments.map((segment, index) => {
+  runningPath += `/${segment}`;
+  const isLast = index === rawSegments.length - 1;
+
+  return {
+    label: isLast ? title : formatSegmentTitle(segment),
+    href: runningPath,
+    isCurrent: isLast,
+  };
+});
 ---
 
 <nav class="breadcrumb-nav" aria-label="Breadcrumb">
   <ol class="breadcrumb-list">
+    <!-- Home Link -->
     <li class="breadcrumb-item">
       <a href="/">Home</a>
     </li>
+
+    <!-- Subpage Breadcrumbs -->
     {
-      !isHome && (
-        <li class="breadcrumb-item active" aria-current="page">
-          <span class="separator">/</span>
-          <span>{title}</span>
-        </li>
-      )
+      !isHome &&
+        breadcrumbItems.map(item => (
+          <li
+            class={`breadcrumb-item ${item.isCurrent ? "active" : ""}`}
+            aria-current={item.isCurrent ? "page" : undefined}
+          >
+            <span class="separator">/</span>
+            {item.isCurrent ? (
+              <span>{item.label}</span>
+            ) : (
+              <a href={item.href}>{item.label}</a>
+            )}
+          </li>
+        ))
     }
   </ol>
 </nav>
@@ -45,6 +81,11 @@ const isHome = isHomePage || Astro.url.pathname === "/" || !slug || slug === "";
     color: #64748b;
   }
 
+  .breadcrumb-item {
+    display: flex;
+    align-items: center;
+  }
+
   .breadcrumb-item a {
     color: #334155;
     text-decoration: none;

package/templates/astro-starter/src/components/global/Footer.astro

@@ -2,60 +2,21 @@
 // src/components/global/Footer.astro
 
 import BlockRenderer from "@/components/blocks/BlockRenderer.astro";
-import { getChannelId } from "@/lib/cms";
 
-// 🎯 Fetch data natively during the server request
-const safeEnv = (Astro.locals as any).safeEnv || {};
-const cmsWorker = safeEnv.CMS_WORKER;
-const channelId = getChannelId() || "website";
-
-const customFetch = (input: RequestInfo | URL, init?: RequestInit) => {
-  const reqInit = { ...init };
-  delete reqInit.cache;
-
-  let urlStr = input instanceof URL ? input.toString() : String(input);
-  if (urlStr.startsWith("/")) {
-    const baseUrl =
-      import.meta.env.PUBLIC_API_URL ||
-      safeEnv.PUBLIC_API_URL ||
-      "http://127.0.0.1:8787";
-    urlStr = `${baseUrl}${urlStr}`;
-  }
-
-  const req = new Request(urlStr, reqInit);
-  if (cmsWorker && typeof cmsWorker.fetch === "function") {
-    return cmsWorker.fetch(req);
-  }
-  return fetch(req);
-};
-
-// 🎯 Resolve the Home Page slug
-const homeSlug = String(import.meta.env.PUBLIC_HOME_SLUG || "home").trim();
-
-let footerBlocks: any[] = [];
-let contentMap: Record<string, any[]> = {};
-
-try {
-  const res = await customFetch(
-    `/api/v1/node/${homeSlug}?channelId=${channelId}`,
-  );
-  if (res.ok) {
-    const data = await res.json();
-    const allContent = data.content || {};
-    footerBlocks = allContent.footer || [];
-    contentMap = allContent;
-  }
-} catch (e) {
-  console.error("[Footer] Failed to fetch home page blocks:", e);
+interface Props {
+  blocks?: any[];
+  contentMap?: Record<string, any[]>;
 }
+
+const { blocks = [], contentMap = {} } = Astro.props;
 ---
 
 <footer class="site-footer">
   <div class="footer-container">
     {
-      footerBlocks && footerBlocks.length > 0 ? (
+      blocks && blocks.length > 0 ? (
         <BlockRenderer
-          blocks={footerBlocks}
+          blocks={blocks}
           contentMap={contentMap}
           region="footer"
         />

package/templates/astro-starter/src/components/global/Header.astro

@@ -15,7 +15,6 @@ const props = Astro.props as Props;
 const currentPropsNode = props.node || {};
 let rawTree: TreeNode[] = props.tree || [];
 
-// 🎯 Read the safely extracted environment from middleware (Fixes Astro 7 crash)
 const safeEnv = (Astro.locals as any).safeEnv || {};
 const cmsWorker = safeEnv.CMS_WORKER;
 
@@ -41,29 +40,27 @@ const customFetch = (input: RequestInfo | URL, init?: RequestInit) => {
   return fetch(req);
 };
 
-// 🎯 Fetch Global Channel Metadata and Nav Tree in Parallel
-const channelId = getChannelId() || "website";
-const treeId = getTreeId() || "main-nav";
+// 🎯 Resolve Channel ID dynamically from env/lib without hardcoding "website"
+const channelId = getChannelId();
+const treeId = getTreeId();
 
 let channelData: Record<string, any> | null = null;
 
 try {
-  const [fetchedChannel, fetchedTree] = await Promise.all([
-    getChannel(channelId, customFetch),
-    !rawTree || rawTree.length === 0
-      ? getTree(treeId, channelId, customFetch)
-      : Promise.resolve(rawTree),
-  ]);
-
-  channelData = fetchedChannel;
   if (!rawTree || rawTree.length === 0) {
+    const [fetchedChannel, fetchedTree] = await Promise.all([
+      getChannel(channelId, customFetch),
+      getTree(treeId, channelId, customFetch),
+    ]);
+    channelData = fetchedChannel;
     rawTree = fetchedTree || [];
+  } else {
+    channelData = await getChannel(channelId, customFetch);
   }
 } catch (e) {
   console.error("[Header] Failed to load layout data:", e);
 }
 
-// 🎯 1. Resolve Logo Text (Strict waterfall prioritizing explicit strings)
 const rawLogoText = channelData?.logoText;
 const rawSiteTitle = channelData?.siteTitle;
 const rawLabel = channelData?.label;
@@ -82,11 +79,9 @@ if (typeof rawLogoText === "string" && rawLogoText.trim() !== "") {
   logoText = import.meta.env.PUBLIC_SITE_NAME || "KAMA";
 }
 
-// 🎯 2. Extract Raw Logo Asset (Unwraps array wrappers if present)
 const rawLogoAsset = channelData?.logoImage || channelData?.logo;
 const targetLogo = Array.isArray(rawLogoAsset) ? rawLogoAsset[0] : rawLogoAsset;
 
-// 🎯 3. Strict Image Validation Guard (Guarantees non-empty string or populated object)
 const hasValidLogoImage = Boolean(
   targetLogo &&
   ((typeof targetLogo === "string" && targetLogo.trim() !== "") ||
@@ -152,7 +147,6 @@ const hasValidLogoImage = Boolean(
     z-index: 1001;
   }
 
-  /* 🎯 Strict 16px Height Constraint for KamaImage output */
   :global(.logo-image) {
     height: 16px !important;
     max-height: 16px !important;

package/templates/astro-starter/src/components/global/NavigationMenu.astro

@@ -8,25 +8,28 @@ export interface Props {
 
 const { tree = [] } = Astro.props;
 
-// 🎯 Grab the current path directly from Astro's server request
 const currentPath = Astro.url.pathname.replace(/\/$/, "") || "/";
-const homeSlug = String(import.meta.env.PUBLIC_HOME_SLUG || "index").trim();
 
-const homeNode = tree.find(
-  item =>
-    item.slug === homeSlug ||
-    item.slug === "" ||
-    item.path === "/" ||
-    item.path === "",
-);
+// 🎯 FIX: Identify the root node in the tree structure
+const rootNode =
+  tree.find(
+    item =>
+      item.path === "/" ||
+      item.path === "" ||
+      item.slug === "index" ||
+      (item as any).isRoot === true ||
+      (item as any).isRootNode === 1,
+  ) || tree[0];
 
+// 🎯 FIX: If rootNode has children, display those children as top-level menu items.
+// If not, filter out the root node by ID AND path.
 const topLevelNavItems =
-  homeNode?.children && homeNode.children.length > 0
-    ? homeNode.children
+  rootNode?.children && rootNode.children.length > 0
+    ? rootNode.children
     : tree.filter(
         item =>
-          item.slug !== homeSlug &&
-          item.slug !== "" &&
+          item.id !== rootNode?.id &&
+          item.slug !== rootNode?.slug &&
           item.path !== "/" &&
           item.path !== "",
       );
@@ -125,58 +128,66 @@ const isExactActive = (itemPath?: string) => {
   </ul>
 </nav>
 
-<script>
-  // 🎯 Clean, standard event listeners that run when the HTML is parsed
-  document.addEventListener("DOMContentLoaded", () => {
+<script is:inline>
+  const initMobileMenu = () => {
     const toggleBtn = document.getElementById("menu-toggle");
     const navOverlay = document.getElementById("nav-overlay");
 
+    if (!toggleBtn || !navOverlay) return;
+
+    // Remove old listeners by replacing the nodes (prevents duplicate bindings)
+    const newToggleBtn = toggleBtn.cloneNode(true);
+    toggleBtn.parentNode.replaceChild(newToggleBtn, toggleBtn);
+
     const closeMenu = () => {
-      if (toggleBtn && navOverlay) {
-        toggleBtn.setAttribute("aria-expanded", "false");
-        toggleBtn.classList.remove("is-open");
-        navOverlay.classList.remove("is-open");
-        document.body.classList.remove("menu-lock-scroll");
-      }
+      newToggleBtn.setAttribute("aria-expanded", "false");
+      newToggleBtn.classList.remove("is-open");
+      navOverlay.classList.remove("is-open");
+      document.body.classList.remove("menu-lock-scroll");
     };
 
-    if (toggleBtn && navOverlay) {
-      toggleBtn.addEventListener("click", () => {
-        const isOpen = toggleBtn.getAttribute("aria-expanded") === "true";
-        toggleBtn.setAttribute("aria-expanded", (!isOpen).toString());
-        toggleBtn.classList.toggle("is-open");
-        navOverlay.classList.toggle("is-open");
-        document.body.classList.toggle("menu-lock-scroll");
-      });
+    newToggleBtn.addEventListener("click", e => {
+      e.stopPropagation();
+      const isOpen = newToggleBtn.getAttribute("aria-expanded") === "true";
+      newToggleBtn.setAttribute("aria-expanded", (!isOpen).toString());
+      newToggleBtn.classList.toggle("is-open");
+      navOverlay.classList.toggle("is-open");
+      document.body.classList.toggle("menu-lock-scroll");
+    });
 
-      const navLinks = navOverlay.querySelectorAll("a");
-      navLinks.forEach(link => {
-        link.addEventListener("click", () => {
-          const targetUrl = new URL(link.href);
-          const currentUrl = new window.URL(window.location.href);
-          if (targetUrl.pathname === currentUrl.pathname) closeMenu();
-        });
+    // Close menu when clicking nav links
+    const navLinks = navOverlay.querySelectorAll("a");
+    navLinks.forEach(link => {
+      link.addEventListener("click", () => {
+        closeMenu();
       });
-    }
-
-    window.addEventListener("pageshow", closeMenu);
+    });
 
+    // Close details dropdowns when clicking outside
     document.addEventListener("click", event => {
       const allDetails = document.querySelectorAll("details.nav-details");
       allDetails.forEach(details => {
-        if (
-          details.hasAttribute("open") &&
-          !details.contains(event.target as Node)
-        ) {
+        if (details.hasAttribute("open") && !details.contains(event.target)) {
           details.removeAttribute("open");
         }
       });
     });
-  });
+
+    window.addEventListener("pageshow", closeMenu);
+  };
+
+  // Run on first load
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", initMobileMenu);
+  } else {
+    initMobileMenu();
+  }
+
+  // Run on every Astro View Transition page navigation
+  document.addEventListener("astro:page-load", initMobileMenu);
 </script>
 
 <style>
-  /* Keeps all of your exact original CSS styles intact! */
   .mobile-toggle {
     display: flex;
     flex-direction: column;

package/templates/astro-starter/src/layouts/StandardLayout.astro

@@ -28,12 +28,11 @@ const {
   language,
 } = Astro.props;
 
-// 🎯 Language Cascade: explicit prop -> node language -> fallback undefined
-// (MetaHead will resolve channel.defaultLanguage if this remains undefined)
+// 🎯 Language Cascade
 const pageLang = language || node?.language || undefined;
 
-// ❌ Removed: const footerBlocks = content?.footer || [];
-// (The new Footer component handles its own data now!)
+// 🎯 Extract the footer blocks the backend already thoughtfully provided
+const footerBlocks = content?.footer || [];
 ---
 
 <!doctype html>
@@ -57,6 +56,7 @@ const pageLang = language || node?.language || undefined;
       </div>
     </main>
 
-    <Footer />
+    <!-- 🎯 Pass the blocks and content map directly -->
+    <Footer blocks={footerBlocks} contentMap={content} />
   </body>
 </html>

package/templates/astro-starter/src/lib/cms.ts

@@ -113,6 +113,12 @@ export async function getChannel(
 
         if (!res.ok) return null;
 
+        // 🎯 Defensive HTML check
+        if (res.headers.get("content-type")?.includes("text/html")) {
+            console.error(`❌ [CMS Client] API returned HTML instead of JSON for Channel: ${requestUrl}`);
+            return null;
+        }
+
         return (await res.json()) as ChannelResponse;
     } catch (err) {
         console.error('[CMS Client] Failed to fetch public channel:', err);
@@ -141,6 +147,12 @@ export async function getTree(
 
         if (!res.ok) return [];
 
+        // 🎯 Defensive HTML check
+        if (res.headers.get("content-type")?.includes("text/html")) {
+            console.error(`❌ [CMS Client] API returned HTML instead of JSON for Tree: ${requestUrl}`);
+            return [];
+        }
+
         const data = await res.json();
         return data.items || [];
     } catch (err) {
@@ -159,7 +171,9 @@ export async function getNodeByPath(
     preview = false,
     customFetch: typeof fetch = fetch
 ): Promise<NodeResponse | null> {
-    const cleanPath = path.replace(/^\/+|\/+$/g, '') || 'home';
+    // 🎯 We keep 'index' as the fallback string for Hono routing compatibility,
+    // because the backend dynamically intercepts 'index' and returns the channelRoot!
+    const cleanPath = path.replace(/^\/+|\/+$/g, '') || 'index';
     const baseUrl = getCmsUrl();
     const requestUrl = `${baseUrl}/api/v1/node/${cleanPath}?channelId=${channel}&preview=${preview}`;
 
@@ -172,9 +186,15 @@ export async function getNodeByPath(
 
         if (!res.ok) return null;
 
+        // 🎯 Defensive HTML check (Prevents the dreaded "<!DOCTYPE html" JSON parse crash)
+        if (res.headers.get("content-type")?.includes("text/html")) {
+            console.error(`❌ [CMS Client] API returned HTML instead of JSON for Node: ${requestUrl}`);
+            return null;
+        }
+
         return (await res.json()) as NodeResponse;
     } catch (err) {
-        console.error('[CMS Client] Failed to fetch node by path:', err);
+        console.error(`[CMS Client] Failed to fetch node by path (${cleanPath}):`, err);
         return null;
     }
 }

package/templates/astro-starter/src/middleware.ts

@@ -162,10 +162,8 @@ export const onRequest = defineMiddleware(async (context, next) => {
                     if (body.purge_everything) {
                         // 🎯 GLOBAL PURGE: Bumping site_version instantly invalidates ALL KV pages globally!
                         await HTML_CACHE.put("site_version", now);
-
-                        // 🎯 FIX: Force clear alias keys during global purge
+                        // Ensure root alias is forced to new version
                         await HTML_CACHE.put("v:/", now);
-                        await HTML_CACHE.put("v:/index", now);
 
                         console.log(`✅ [Version Tagging] Global site_version updated to ${now}`);
                     } else if (Array.isArray(body.urls) && body.urls.length > 0) {
@@ -176,12 +174,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
                             const cleanPath = urlPath.replace(/\/$/, "") || "/";
 
                             purgeTasks.push(HTML_CACHE.put(`v:${cleanPath}`, now));
-
-                            // 🎯 FIX: Always sync / and /index aliases together
-                            if (cleanPath === "/" || cleanPath === "/index") {
-                                purgeTasks.push(HTML_CACHE.put("v:/", now));
-                                purgeTasks.push(HTML_CACHE.put("v:/index", now));
-                            }
                         }
                         await Promise.all(purgeTasks);
                         console.log(`✅ [Version Tagging] Updated versions for ${body.urls.length} URLs`);
@@ -196,11 +188,8 @@ export const onRequest = defineMiddleware(async (context, next) => {
                 if (cache) {
                     const rootUrls = [
                         origin,
-                        `${origin}/`,
-                        `${origin}/index`,
-                        `${origin}/index/`
+                        `${origin}/`
                     ];
-
                     for (const url of rootUrls) {
                         await cache.delete(new Request(url));
                     }
@@ -215,7 +204,7 @@ export const onRequest = defineMiddleware(async (context, next) => {
                 });
             }
 
-            // D. Surgical Legacy Worker Cache Purge (For Updated Pages)
+            // D. Surgical Legacy Worker Cache Purge
             if (Array.isArray(body.urls) && body.urls.length > 0) {
                 const results = [];
 
@@ -223,17 +212,7 @@ export const onRequest = defineMiddleware(async (context, next) => {
                     const cleanUrl = targetUrl.split('?')[0];
                     const urlNoSlash = cleanUrl.replace(/\/$/, "");
                     const urlWithSlash = urlNoSlash + "/";
-
                     const pathsToClear = [urlNoSlash, urlWithSlash];
-                    const urlPath = new URL(targetUrl).pathname;
-
-                    // 🎯 FIX: Clear legacy cache alias if it's the home page
-                    if (urlPath === "/" || urlPath === "/index") {
-                        pathsToClear.push(`${origin}/`);
-                        pathsToClear.push(`${origin}/index`);
-                        pathsToClear.push(`${origin}/index/`);
-                        pathsToClear.push(`${origin}`);
-                    }
 
                     let purged = false;
                     if (cache) {
@@ -279,25 +258,12 @@ export const onRequest = defineMiddleware(async (context, next) => {
                         }
 
                         await HTML_CACHE.delete(`v:${cleanPath}`);
-
-                        // 🎯 FIX: Delete aliases from KV if applicable
-                        if (cleanPath === "/" || cleanPath === "/index") {
-                            await HTML_CACHE.delete("v:/");
-                            await HTML_CACHE.delete("v:/index");
-                        }
                     }
 
                     const cleanUrl = targetUrl.split('?')[0];
                     const urlNoSlash = cleanUrl.replace(/\/$/, "");
                     const urlWithSlash = urlNoSlash + "/";
-
                     const pathsToClear = [urlNoSlash, urlWithSlash];
-                    if (urlPath === "/" || urlPath === "/index") {
-                        pathsToClear.push(`${origin}/`);
-                        pathsToClear.push(`${origin}/index`);
-                        pathsToClear.push(`${origin}/index/`);
-                        pathsToClear.push(`${origin}`);
-                    }
 
                     let purgedLegacy = false;
                     if (cache) {
@@ -338,11 +304,13 @@ export const onRequest = defineMiddleware(async (context, next) => {
     // 🎯 1. KV STATIC "FILE" CACHE READ WITH VERSION TAGGING
     const isWarmer = context.request.headers.get("X-Cache-Warmer") === "true";
     const isHtmlPage = !pathname.includes('.') && !pathname.startsWith('/api/');
-    const cleanLookupPath = pathname.replace(/\/$/, "") || "/";
+    // 🎯 The ONLY way we refer to the homepage in KV is "/"
+    const cleanLookupPath = pathname === "/index" || pathname === "/index/"
+        ? "/"
+        : (pathname.replace(/\/$/, "") || "/");
 
     let activeCacheKey = cleanLookupPath;
 
-    // 🎯 FIX: Bypass KV Read in local dev OR if we are time traveling (previewing drafts/snapshots)
     if (!isDev && isHtmlPage && HTML_CACHE && !isWarmer && !isTimeTraveling) {
         try {
             const [siteVer, pageVer] = await Promise.all([
@@ -373,7 +341,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
     const response = await next();
 
     // 🎯 2. KV STATIC "FILE" CACHE WRITE (Save HTML under active Version Key)
-    // 🎯 FIX: Bypass KV Write in local dev OR if we are time traveling (never save drafts to public cache)
     if (
         !isDev &&
         isHtmlPage &&
@@ -390,14 +357,7 @@ export const onRequest = defineMiddleware(async (context, next) => {
 
                 await HTML_CACHE.put(`v:${cleanLookupPath}`, forcedVersion);
 
-                // 🎯 FIX: Sync both aliases when saving the homepage
-                if (cleanLookupPath === "/" || cleanLookupPath === "/index") {
-                    await HTML_CACHE.put(`v:/`, forcedVersion);
-                    await HTML_CACHE.put(`v:/index`, forcedVersion);
-                }
-
                 const siteVer = await HTML_CACHE.get("site_version") || "1";
-
                 activeCacheKey = `${cleanLookupPath}:v:${siteVer}:${forcedVersion}`;
             }
 
@@ -428,7 +388,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
     }
 
     // 🎯 4. STATIC ASSET CACHING FOR COMPRESSED BUNDLES / ASSETS
-    // 🎯 DEV FIX: Do not apply max-age=31536000 locally to prevent breaking Vite HMR
     if (!isDev) {
         if (
             pathname.startsWith("/_image") ||
@@ -465,8 +424,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
         } else {
             // Production headers
             response.headers.set("Cross-Origin-Opener-Policy", "same-origin-allow-popups");
-            // 🎯 FIX: Remove X-Frame-Options entirely since it breaks cross-subdomain framing.
-            // Rely completely on CSP frame-ancestors to whitelist ALL kamaengine subdomains + your env URL.
             response.headers.set(
                 "Content-Security-Policy",
                 `default-src 'self' https: data: 'unsafe-inline' 'unsafe-eval'; img-src 'self' https: data: blob:; connect-src 'self' https:; frame-ancestors 'self' https://*.kamaengine.com https://kama.kamaengine.com ${cmsOrigin};`