@brightsideoy/kama 0.1.0-alpha.110 → 0.1.0-alpha.112

package/README.md

@@ -87,40 +87,61 @@ At the heart of KAMA is the Schema Engine. Instead of complex database migration
 
 ## Getting Started
 
-KAMA comes with a scaffolding CLI to instantly spin up a full monorepo (Backend + Astro Frontend).
+KAMA comes with an interactive executable CLI to instantly spin up a full monorepo (Backend Worker + optional Astro Frontend), add new sites to existing workspaces, or promote local setups to Cloudflare Edge.
 
-## 1. Initialize a Workspace
+### 1. Initialize a Workspace\*\*
+
+Run the KAMA CLI to start the workspace wizard:
 
 ```bash
-npx @brightsideoy/kama@alpha
+npx kama init
 ```
 
-Select **"Kickstart new KAMA Monorepo"**. The CLI will automatically:
+The CLI will prompt you for your setup preferences and automatically:
 
-- Authenticate with Cloudflare (if deploying to the Edge).
-- Create a new D1 database (or local SQLite equivalent).
-- Bind your R2 media buckets.
-- Setup the Worker backend and Astro frontend.
+- Scaffold the `kama-worker` engine and content definition directories (`content/definitions/`).
+- Authenticate with Cloudflare and auto-provision a remote D1 database + R2 bucket bindings (if deploying to Edge).
+- Scaffold a fully configured Astro frontend site inside `sites/` with built-in edge-caching middleware.
+- Configure local SQLite fallback environments for completely offline development.
 
-## 2. Local Development
+### 2. Local Development
 
-Start the backend and frontend simultaneously on your local machine:
+Start the local CMS dev server from your workspace root:
 
 ```bash
 npm run dev:cms
 ```
 
-This bundles your local YAML schemas, syncs the local SQLite/D1 database, and starts the Wrangler dev server on your localhost.
+This command automatically compiles your YAML/JSON schemas into runtime JavaScript definitions, syncs your local SQLite database, and launches the Miniflare worker environment on `http://localhost:8787`.
+
+### 3. Management Commands\*\*
+
+You can run CLI commands anytime inside your workspace.
+
+#### Add a New Astro Frontend Site
+
+```bash
+npx kama add site
+```
+
+#### Promote a Local Workspace to Cloudflare Edge
+
+Convert a local offline workspace to Cloudflare Edge (auto-links domains & D1 databases):
 
-## 3. Deploy
+```bash
+npx kama promote
+```
 
-Push your API, schemas, and database migrations to Cloudflare's global network, or package it for your virtual server:
+### 4. Deploy
+
+Deploy your CMS engine, content definitions, and database migrations to Cloudflare Edge:
 
 ```bash
 npm run deploy:cms
 ```
 
-<br>
+> **Note:** For self-hosted virtual servers (VPS) or Docker environments, you can run `npm run dev:cms` under PM2/Docker as a standalone `workerd` server.
+> <br>
 
 ## Directory Structure Overview
 
@@ -134,7 +155,7 @@ my-kama-workspace/
 │       ├── nodes/           # e.g., page.yaml, product.yaml
 │       ├── blocks/          # e.g., hero.yaml, image_card.yaml
 │       └── node-layouts/    # e.g., two-column.yaml
-├── cms-worker/              # 👉 BACKEND PIPELINE
+├── kama-worker/              # 👉 BACKEND PIPELINE
 │   ├── index.js             # Worker entrypoint (ES Module)
 │   ├── wrangler.json        # Bindings (D1, R2, Vars)
 │   └── package.json

package/bin/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { execSync } from 'node:child_process';
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import * as readline from 'node:readline/promises';
 
-// Dynamically resolve the current CLI version to inject into package.json files
+// Dynamically resolve current package version
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 let currentKamaVersion = 'alpha';
@@ -25,25 +25,42 @@ const rl = readline.createInterface({
 });
 
 async function main() {
-    console.log('\n🔥 --- KAMA SITE GENERATOR --- 🔥\n');
+    const args = process.argv.slice(2);
+    const command = args[0]?.toLowerCase();
+    const subCommand = args[1]?.toLowerCase();
 
-    console.log('Select mode:');
-    console.log('  1) Kickstart new Kama Monorepo (CMS + Optional Site)');
-    console.log('  2) Add a new Astro Site to current workspace (sites/)');
+    console.log('\n🔥 --- KAMA ENGINE CLI --- 🔥\n');
 
-    const choice = await rl.question('\nChoice [1/2]: ');
-
-    if (choice.trim() === '2') {
+    if (command === 'init') {
+        await createFullWorkspace();
+    } else if (command === 'add' && subCommand === 'site') {
         await createNewSiteOnly();
+    } else if (command === 'promote') {
+        await promoteLocalToCloudflare();
     } else {
-        await createFullWorkspace();
+        // Interactive menu when invoked without arguments or unrecognized command
+        console.log('Available Commands:');
+        console.log('  1) npx kama init         - Kickstart new Monorepo (CMS + Optional Site)');
+        console.log('  2) npx kama add site     - Add new Astro Site to current workspace (sites/)');
+        console.log('  3) npx kama promote      - Promote current Local workspace to Cloudflare Edge');
+
+        const choice = await rl.question('\nSelect choice [1/2/3]: ');
+
+        if (choice.trim() === '3') {
+            await promoteLocalToCloudflare();
+        } else if (choice.trim() === '2') {
+            await createNewSiteOnly();
+        } else {
+            await createFullWorkspace();
+        }
     }
 
     rl.close();
 }
 
 /**
- * MODE 1: Kickstart full Monorepo Workspace
+ * COMMAND: npx kama init
+ * Kickstart full Monorepo Workspace
  */
 async function createFullWorkspace() {
     const projName = (await rl.question('Project folder name [kama-workspace]: ')) || 'kama-workspace';
@@ -54,14 +71,12 @@ async function createFullWorkspace() {
     const envChoice = await rl.question('\nChoice [1/2]: ');
     const isCloudflare = envChoice.trim() === '2';
 
-    // 🎯 Ask if user wants an Astro frontend site scaffolded
     const createSiteInput = await rl.question('\n🚀 Do you want to scaffold an initial Astro frontend site? (y/n) [y]: ');
     const shouldCreateSite = createSiteInput.trim().toLowerCase() !== 'n';
 
     let cmsDomain = 'localhost:8787';
     let siteDomain = 'localhost:4321';
 
-    // Only ask for domains if deploying to Cloudflare Edge
     if (isCloudflare) {
         cmsDomain = (await rl.question('\nCMS Admin Domain (e.g., admin.t3cloud.eu): ')) || 'admin.t3cloud.eu';
         if (shouldCreateSite) {
@@ -69,13 +84,10 @@ async function createFullWorkspace() {
         }
     }
 
-    // Standardize scheme for localhost vs custom edge domains
     const cmsProtocol = isCloudflare ? 'https://' : 'http://';
     const cmsFullUrl = `${cmsProtocol}${cmsDomain.replace(/^https?:\/\//, '')}`;
-
     const rootDir = join(process.cwd(), projName);
 
-    // 🎯 Derive dynamic worker, database, and bucket names from project folder name
     const workerName = `${projName}-worker`.toLowerCase().replace(/[^a-z0-9_-]/g, '-');
     let dbName = `${projName}-db`.replace(/[^a-zA-Z0-9_-]/g, '_');
     const bucketName = `${projName}-media-prod`.toLowerCase().replace(/[^a-z0-9_-]/g, '-');
@@ -83,22 +95,21 @@ async function createFullWorkspace() {
     console.log(`\n📁 Creating workspace folder at ./${projName}...`);
     mkdirSync(rootDir, { recursive: true });
 
-    // 🎯 Generate root .gitignore so auto-generated bundles and secrets stay out of git
     writeFileSync(
         join(rootDir, '.gitignore'),
         `node_modules/
 .env
 .DS_Store
-cms-worker/.dev.vars
-cms-worker/bundled-definitions.js
-cms-worker/.wrangler/
+kama-worker/.dev.vars
+kama-worker/bundled-definitions.js
+kama-worker/bundled-definitions.ts
+kama-worker/.wrangler/
 sites/*/.env
 sites/*/.astro/
 sites/*/dist/
 `
     );
 
-    // 🎯 Scaffold full schema directory structure
     const schemaCategories = [
         'block-layouts',
         'blocks',
@@ -113,10 +124,8 @@ sites/*/dist/
         mkdirSync(join(rootDir, 'content', 'definitions', category), { recursive: true });
     }
 
-    // 🎯 Populate starter example YAML files
     scaffoldSampleSchemas(rootDir);
 
-    // --- AUTO D1 CREATION MAGIC ---
     let d1DatabaseId = '00000000-0000-0000-0000-000000000000';
     let isAuthenticated = false;
 
@@ -188,20 +197,18 @@ sites/*/dist/
     } else {
         console.log(`\n💻 Local mode selected. Skipping Cloudflare authentication and domain setup...`);
     }
-    // ------------------------------
 
-    // 🎯 1. Root package.json (includes 'sites/*' wildcard in workspaces so user can add sites later)
     writeFileSync(
         join(rootDir, 'package.json'),
         JSON.stringify({
             name: projName,
             private: true,
             type: 'module',
-            workspaces: ['cms-worker', 'sites/*'],
+            workspaces: ['kama-worker', 'sites/*'],
             scripts: {
                 'bundle:schemas': 'node node_modules/@brightsideoy/kama/scripts/bundle-definitions.js',
-                'dev:cms': 'npm run bundle:schemas && npm run dev -w cms-worker',
-                'deploy:cms': 'npm run bundle:schemas && npm run deploy -w cms-worker',
+                'dev:cms': 'npm run bundle:schemas && npm run dev -w kama-worker',
+                'deploy:cms': 'npm run bundle:schemas && npm run deploy -w kama-worker',
             },
             dependencies: {
                 '@brightsideoy/kama': currentKamaVersion,
@@ -209,16 +216,13 @@ sites/*/dist/
         }, null, 2)
     );
 
-    // 🎯 2. Setup CMS Worker with Dynamic Names
     console.log(`\n☁️ Configuring CMS Worker '${workerName}' (${cmsDomain})...`);
-    const cmsDir = join(rootDir, 'cms-worker');
+    const cmsDir = join(rootDir, 'kama-worker');
     mkdirSync(cmsDir, { recursive: true });
 
-    // 🎯 Properly wrap and inject BUNDLED_DEFINITIONS from LOCAL workspace, not node_modules
     const cmsWorkerIndexContent = `import kamaWorker from '@brightsideoy/kama';
 import * as bundledModule from './bundled-definitions.js';
 
-// Resolve BUNDLED_DEFINITIONS across all module resolution formats
 const BUNDLED_DEFINITIONS =
   bundledModule.BUNDLED_DEFINITIONS ||
   bundledModule.default?.BUNDLED_DEFINITIONS ||
@@ -237,10 +241,7 @@ export default {
 };
 `;
 
-    writeFileSync(
-        join(cmsDir, 'index.js'),
-        cmsWorkerIndexContent
-    );
+    writeFileSync(join(cmsDir, 'index.js'), cmsWorkerIndexContent);
 
     writeFileSync(
         join(cmsDir, 'package.json'),
@@ -259,13 +260,12 @@ export default {
                 '@brightsideoy/kama': currentKamaVersion,
             },
             devDependencies: {
-                wrangler: '^3.80.0',
+                wrangler: '^4.0.0',
                 tsx: '^4.19.2',
             },
         }, null, 2)
     );
 
-    // 🎯 Fixed CMS wrangler.json
     const cmsWranglerConfig = {
         $schema: '../node_modules/wrangler/config-schema.json',
         name: workerName,
@@ -299,23 +299,18 @@ export default {
         cmsWranglerConfig.routes = [{ pattern: cmsDomain, custom_domain: true }];
     }
 
-    writeFileSync(
-        join(cmsDir, 'wrangler.json'),
-        JSON.stringify(cmsWranglerConfig, null, 2)
-    );
+    writeFileSync(join(cmsDir, 'wrangler.json'), JSON.stringify(cmsWranglerConfig, null, 2));
 
-    // 🎯 Fixed .dev.vars
     writeFileSync(
         join(cmsDir, '.dev.vars'),
         `# Cloudflare Edge Cache Purging Secrets\nCLOUDFLARE_API_TOKEN=${isCloudflare ? 'cfut_YOUR_CUSTOM_PURGE_TOKEN' : 'local_token'}\n`
     );
 
-    // 🎯 3. Setup Astro Site (ONLY if requested)
     if (shouldCreateSite) {
         const siteFolderName = isCloudflare ? siteDomain.split('.')[0] : 'web';
         await generateAstroSite(rootDir, siteFolderName, siteDomain, cmsFullUrl, workerName, isCloudflare);
     } else {
-        console.log(`\nℹ️ Skipping Astro site creation. You can add a site later by running 'npx create-kama' (Mode 2) inside this workspace.`);
+        console.log(`\nℹ️ Skipping Astro site creation. You can add a site later by running 'npx kama add site' inside this workspace.`);
     }
 
     console.log(`\n✨ Workspace ready! Next steps:`);
@@ -326,17 +321,18 @@ export default {
         if (d1DatabaseId === '00000000-0000-0000-0000-000000000000' || d1DatabaseId === 'REPLACE_WITH_YOUR_D1_ID') {
             console.log(`  3. Run 'npx wrangler login' and create a D1 database manually.`);
         }
-        console.log(`  4. Update CLOUDFLARE_ZONE_ID in cms-worker/wrangler.json with your actual Zone ID`);
-        console.log(`  5. Securely store your purge token: cd cms-worker && npx wrangler secret put CLOUDFLARE_API_TOKEN`);
+        console.log(`  4. Update CLOUDFLARE_ZONE_ID in kama-worker/wrangler.json with your actual Zone ID`);
+        console.log(`  5. Securely store your purge token: cd kama-worker && npx wrangler secret put CLOUDFLARE_API_TOKEN`);
         console.log(`  6. Run 'npm run dev:cms' from the workspace root to start the backend.`);
     } else {
         console.log(`  3. Run 'npm run dev:cms' from the workspace root to start the local SQLite backend.`);
-        console.log(`\n💡 Note: You can deploy to Cloudflare later by updating 'cms-worker/wrangler.json' with real IDs.`);
+        console.log(`\n💡 Note: You can deploy to Cloudflare later by running 'npx kama promote'.`);
     }
 }
 
 /**
- * MODE 2: Add Site to existing workspace
+ * COMMAND: npx kama add site
+ * Add Astro Site to existing workspace
  */
 async function createNewSiteOnly() {
     const rootDir = process.cwd();
@@ -347,7 +343,7 @@ async function createNewSiteOnly() {
     }
 
     let targetWorkerName = 'kama-worker';
-    const cmsWranglerPath = join(rootDir, 'cms-worker', 'wrangler.json');
+    const cmsWranglerPath = join(rootDir, 'kama-worker', 'wrangler.json');
     if (existsSync(cmsWranglerPath)) {
         try {
             const cmsWrangler = JSON.parse(readFileSync(cmsWranglerPath, 'utf-8'));
@@ -378,12 +374,88 @@ async function createNewSiteOnly() {
 }
 
 /**
- * Helper: Scaffolds initial starter schemas for all category folders
+ * COMMAND: npx kama promote
+ * Promote current Local workspace to Cloudflare Edge
  */
+async function promoteLocalToCloudflare() {
+    const rootDir = process.cwd();
+    const workerWranglerPath = join(rootDir, 'kama-worker', 'wrangler.json');
+
+    if (!existsSync(workerWranglerPath)) {
+        console.error('❌ Error: Could not find kama-worker/wrangler.json. Run this command inside your workspace root.');
+        return;
+    }
+
+    console.log('\n🌐 --- PROMOTING WORKSPACE TO CLOUDFLARE EDGE --- 🌐\n');
+
+    try {
+        execSync('npx wrangler whoami', { stdio: 'pipe' });
+        console.log('✅ Logged in to Cloudflare.');
+    } catch (e) {
+        console.log('🌐 Launching browser for Cloudflare login...');
+        try {
+            execSync('npx wrangler login', { stdio: 'inherit' });
+        } catch (loginError) {
+            console.log('❌ Cloudflare login failed or was cancelled.');
+            return;
+        }
+    }
+
+    const cmsDomain = (await rl.question('\nCMS Admin Domain (e.g., admin.t3cloud.eu): ')) || 'admin.t3cloud.eu';
+
+    const sitesFolderDir = join(rootDir, 'sites');
+    let siteDomain = '';
+    if (existsSync(sitesFolderDir)) {
+        siteDomain = await rl.question('Frontend Website Domain (e.g., kama.t3cloud.eu): ');
+    }
+
+    const currentConfig = JSON.parse(readFileSync(workerWranglerPath, 'utf-8'));
+    const dbName = currentConfig.d1_databases?.[0]?.database_name || 'kama_db';
+
+    console.log(`\n🗄️ Provisioning remote Cloudflare D1 Database '${dbName}'...`);
+    let d1DatabaseId = '00000000-0000-0000-0000-000000000000';
+
+    try {
+        const d1Output = execSync(`npx wrangler d1 create ${dbName}`, { encoding: 'utf-8', stdio: 'pipe' });
+        const match = d1Output.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);
+        if (match) d1DatabaseId = match[0];
+    } catch (err) {
+        console.log('⚠️ Could not auto-create D1 (it may already exist). Please verify on your Cloudflare dashboard.');
+    }
+
+    currentConfig.vars.CDN_DOMAIN = cmsDomain;
+    if (siteDomain) {
+        currentConfig.vars.PUBLIC_FRONTEND_URL = `https://${siteDomain}`;
+    }
+    currentConfig.routes = [{ pattern: cmsDomain, custom_domain: true }];
+    if (currentConfig.d1_databases?.[0]) {
+        currentConfig.d1_databases[0].database_id = d1DatabaseId;
+    }
+
+    writeFileSync(workerWranglerPath, JSON.stringify(currentConfig, null, 2));
+
+    if (siteDomain && existsSync(sitesFolderDir)) {
+        const sites = readdirSync(sitesFolderDir);
+        if (sites.length > 0) {
+            const siteWranglerPath = join(sitesFolderDir, sites[0], 'wrangler.json');
+            if (existsSync(siteWranglerPath)) {
+                const siteConfig = JSON.parse(readFileSync(siteWranglerPath, 'utf-8'));
+                siteConfig.routes = [{ pattern: siteDomain, custom_domain: true }];
+                siteConfig.vars.PUBLIC_CMS_URL = `https://${cmsDomain}`;
+                siteConfig.vars.PUBLIC_API_URL = `https://${cmsDomain}`;
+                writeFileSync(siteWranglerPath, JSON.stringify(siteConfig, null, 2));
+            }
+        }
+    }
+
+    console.log(`\n✅ Workspace successfully configured for Cloudflare Edge!`);
+    console.log(`\nNext steps:`);
+    console.log(`  1. Run 'npm run deploy:cms' from the root to publish your backend and database.`);
+}
+
 function scaffoldSampleSchemas(rootDir) {
     const defsDir = join(rootDir, 'content', 'definitions');
 
-    // 1. Channels
     writeFileSync(join(defsDir, 'channels', 'website.yaml'), `id: website
 label: Main Website
 defaultLanguage: en
@@ -392,7 +464,6 @@ languages:
   - fi
 `);
 
-    // 2. Nodes
     writeFileSync(join(defsDir, 'nodes', 'page.yaml'), `id: page
 label: Page
 inTree: true
@@ -431,7 +502,6 @@ tabs:
         linkedTo: title
 `);
 
-    // 3. Blocks
     writeFileSync(join(defsDir, 'blocks', 'hero.yaml'), `id: hero
 label: Hero Section
 fields:
@@ -452,7 +522,6 @@ fields:
     type: richtext
 `);
 
-    // 4. Block Layouts
     writeFileSync(join(defsDir, 'block-layouts', 'two-column.yaml'), `id: two-column
 label: Two Column Layout
 regions:
@@ -462,7 +531,6 @@ regions:
     label: Right Column
 `);
 
-    // 5. Node Layouts
     writeFileSync(join(defsDir, 'node-layouts', 'single-column.yml'), `id: single-column
 label: Single Column Page
 regions:
@@ -470,7 +538,6 @@ regions:
     label: Main Content Area
 `);
 
-    // 6. Field Sets
     writeFileSync(join(defsDir, 'field-sets', 'page-base.yaml'), `id: page-base
 label: Base Page Fields
 fields:
@@ -482,7 +549,6 @@ fields:
     type: text
 `);
 
-    // 7. Trees
     writeFileSync(join(defsDir, 'trees', 'navigation.yaml'), `id: navigation
 label: Main Navigation Tree
 maxDepth: 3
@@ -491,9 +557,6 @@ allowedNodeTypes:
 `);
 }
 
-/**
- * Helper: Scaffolds the Astro site with middleware, wrangler.json, & slug page
- */
 async function generateAstroSite(rootDir, siteFolder, siteDomain, cmsFullUrl, workerName = 'kama-worker', isCloudflare = false) {
     console.log(`\n🚀 Scaffolding Astro site (${siteFolder}) mapped to ${siteDomain} (Service: ${workerName})...`);
 
@@ -520,7 +583,7 @@ async function generateAstroSite(rootDir, siteFolder, siteDomain, cmsFullUrl, wo
                 '@astrojs/cloudflare': '^14.2.5',
                 '@brightsideoy/kama': currentKamaVersion,
                 astro: '^7.2.0',
-                wrangler: '^3.80.0',
+                wrangler: '^4.0.0',
             },
         }, null, 2)
     );
@@ -582,7 +645,6 @@ export default defineConfig({
         `PUBLIC_CMS_URL="${cmsFullUrl}"\nPUBLIC_API_URL="${cmsFullUrl}"\n`
     );
 
-    // 🎯 Scaffold the Base Layout
     writeFileSync(
         join(siteDir, 'src/layouts/Layout.astro'),
         `---
@@ -606,7 +668,6 @@ const { title } = Astro.props;
 </html>`
     );
 
-    // 🎯 Scaffold the Dynamic Slug Page
     writeFileSync(
         join(siteDir, 'src/pages/[...slug].astro'),
         `---
@@ -614,10 +675,6 @@ import Layout from '../layouts/Layout.astro';
 
 const { slug } = Astro.params;
 const cmsUrl = import.meta.env.PUBLIC_CMS_URL;
-
-// Example Data Fetch: Replace with actual KAMA fetch logic
-// const response = await fetch(\`\${cmsUrl}/api/pages/\${slug || 'home'}\`);
-// const pageData = await response.json();
 ---
 <Layout title="Kama Generated Site">
 \t<main>
@@ -627,7 +684,6 @@ const cmsUrl = import.meta.env.PUBLIC_CMS_URL;
 </Layout>`
     );
 
-    // 🎯 Scaffold the Full Edge-Caching Middleware
     writeFileSync(
         join(siteDir, 'src/middleware.ts'),
         `import { defineMiddleware } from "astro:middleware";
@@ -639,7 +695,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
     const workerEnv = cfContext?.env || (env as any);
     const HTML_CACHE = workerEnv?.HTML_CACHE; 
 
-    // 🎯 1. CACHE PURGE ENDPOINT
     if (pathname === "/api/purge" || pathname === "/api/purge/") {
         if (context.request.method !== "POST") return new Response("Method Not Allowed", { status: 405 });
         
@@ -657,12 +712,11 @@ export const onRequest = defineMiddleware(async (context, next) => {
                     }));
                 }
                 
-                // Surgical delete
                 if (Array.isArray(body.deleted_urls) && body.deleted_urls.length > 0) {
                     await Promise.all(body.deleted_urls.map(async (u: string) => {
                         const path = new URL(u).pathname.replace(/\\/$/, "") || "/";
                         const [siteVer, pageVer] = await Promise.all([
-                            HTML_CACHE.get("site_version"), HTML_CACHE.get(\`v:\${path}\`)
+                            HTML_CACHE.get("site_version"), HTML_CACHE.get(\`v:\${cleanLookupPath}\`)
                         ]);
                         if (siteVer || pageVer) {
                             await HTML_CACHE.delete(\`\${path}:v:\${siteVer || "1"}:\${pageVer || "1"}\`);
@@ -672,7 +726,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
                 }
             }
             
-            // Astro Worker Cache layer flush
             if (typeof cfContext?.cache?.purge === 'function') await cfContext.cache.purge({ purgeEverything: true });
 
             return new Response(JSON.stringify({ success: true }), { status: 200 });
@@ -681,7 +734,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
         }
     }
 
-    // 🎯 2. KV HTML STATIC LOOKUP
     const isWarmer = context.request.headers.get("X-Cache-Warmer") === "true";
     const isHtmlPage = !pathname.includes('.') && !pathname.startsWith('/api/');
     const cleanLookupPath = pathname.replace(/\\/$/, "") || "/";
@@ -713,7 +765,6 @@ export const onRequest = defineMiddleware(async (context, next) => {
 
     const response = await next();
 
-    // 🎯 3. KV HTML STATIC WRITE
     if (isHtmlPage && HTML_CACHE && response.status === 200 && response.headers.get("content-type")?.includes("text/html")) {
         const htmlText = await response.clone().text();
         const writeTask = (async () => {