synthos 0.8.0 → 0.10.0

package/src/files.ts

@@ -72,3 +72,60 @@ export async function copyFolderRecursive(srcFolder: string, destFolder: string)
 export async function deleteFolder(dirPath: string): Promise<void> {
     await fs.rm(dirPath, { recursive: true });
 }
+
+// --- Multi-folder helpers ---
+
+/**
+ * Search folders in order, return the full path to the first existing match
+ * for the given filename.
+ */
+export async function findFileInFolders(folders: string[], filename: string): Promise<string | undefined> {
+    for (const folder of folders) {
+        const candidate = path.join(folder, filename);
+        if (await checkIfExists(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+
+/**
+ * Merge file listings from multiple folders. First folder takes priority on
+ * name collisions (earlier occurrence wins).
+ */
+export async function listFilesFromFolders(folders: string[]): Promise<string[]> {
+    const seen = new Set<string>();
+    const result: string[] = [];
+    for (const folder of folders) {
+        if (!await checkIfExists(folder)) continue;
+        const files = await listFiles(folder);
+        for (const f of files) {
+            if (!seen.has(f)) {
+                seen.add(f);
+                result.push(f);
+            }
+        }
+    }
+    return result;
+}
+
+/**
+ * Copy files from multiple source folders into a single destination.
+ * First folder takes priority on duplicate filenames (copy is skipped
+ * if the file already exists in dest from an earlier folder).
+ */
+export async function copyFilesFromFolders(folders: string[], destFolder: string): Promise<void> {
+    await ensureFolderExists(destFolder);
+    const copied = new Set<string>();
+    for (const folder of folders) {
+        if (!await checkIfExists(folder)) continue;
+        const files = await fs.readdir(folder);
+        for (const file of files) {
+            if (copied.has(file)) continue;
+            copied.add(file);
+            const srcPath = path.join(folder, file);
+            const destPath = path.join(destFolder, file);
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}

package/src/index.ts

@@ -3,4 +3,6 @@ export * from './files';
 export * from './init';
 export * from './pages';
 export * from './scripts';
-export * from './settings';
+export * from './settings';
+export * from './customizer';
+export * from './storage';

package/src/init.ts

@@ -1,159 +1,165 @@
 import * as fs from 'fs/promises';
 import path from "path";
-import { checkIfExists, copyFile, copyFiles, deleteFile, ensureFolderExists, listFiles, saveFile } from "./files";
-import { PAGE_VERSION } from "./pages";
+import { checkIfExists, findFileInFolders, listFolders } from "./files";
+import { PAGE_VERSION, getRequiredPages } from "./pages";
 import { DefaultSettings } from "./settings";
-import { getOutdatedThemes, parseThemeFilename } from "./themes";
+import { Customizer } from './customizer';
+import { StorageProvider, FsStorageProvider } from './storage';
 
 export interface SynthOSConfig {
+    localFolder: string;
     pagesFolder: string;
-    requiredPagesFolder: string;
-    defaultPagesFolder: string;
-    defaultScriptsFolder: string;
-    defaultThemesFolder: string;
-    pageScriptsFolder: string;
+    requiredPagesFolders: string[];
+    defaultPagesFolders: string[];
+    defaultScriptsFolders: string[];
+    defaultThemesFolders: string[];
+    staticFilesFolders: string[];
+    serviceConnectorsFolders: string[];
+    requiredPages: string[];
+    storageProvider: StorageProvider;
     debug: boolean;
     debugPageUpdates: boolean;
 }
 
-export function createConfig(pagesFolder = '.synthos', options?: { debug?: boolean; debugPageUpdates?: boolean }): SynthOSConfig {
+/**
+ * Resolve a folder array from a Customizer getter: replace the `'default'`
+ * sentinel with the built-in SynthOS path.
+ */
+function resolveFolders(folders: string[], builtInPath: string): string[] {
+    return folders.map(f => f === 'default' ? builtInPath : f);
+}
+
+export async function createConfig(
+    pagesFolder = '.synthos',
+    options?: { debug?: boolean; debugPageUpdates?: boolean },
+    customizer?: Customizer
+): Promise<SynthOSConfig> {
+    const requiredPagesFolders = resolveFolders(
+        customizer?.requiredPagesFolders ?? ['default'],
+        path.join(__dirname, '../required-pages')
+    );
+    const requiredPages = await getRequiredPages(requiredPagesFolders);
     return {
+        localFolder: pagesFolder,
         pagesFolder: path.join(process.cwd(), pagesFolder),
-        requiredPagesFolder: path.join(__dirname, '../required-pages'),
-        defaultPagesFolder: path.join(__dirname, '../default-pages'),
-        defaultScriptsFolder: path.join(__dirname, '../default-scripts'),
-        defaultThemesFolder: path.join(__dirname, '../default-themes'),
-        pageScriptsFolder: path.join(__dirname, '../page-scripts'),
+        requiredPagesFolders,
+        defaultPagesFolders: resolveFolders(
+            customizer?.defaultPagesFolders ?? ['default'],
+            path.join(__dirname, '../default-pages')
+        ),
+        defaultScriptsFolders: resolveFolders(
+            customizer?.defaultScriptsFolders ?? ['default'],
+            path.join(__dirname, '../default-scripts')
+        ),
+        defaultThemesFolders: resolveFolders(
+            customizer?.defaultThemesFolders ?? ['default'],
+            path.join(__dirname, '../default-themes')
+        ),
+        staticFilesFolders: resolveFolders(
+            customizer?.staticFilesFolders ?? ['default'],
+            path.join(__dirname, '../static-files')
+        ),
+        serviceConnectorsFolders: resolveFolders(
+            customizer?.serviceConnectorsFolders ?? ['default'],
+            path.join(__dirname, '../service-connectors')
+        ),
+        requiredPages,
+        storageProvider: customizer?.storageProvider ?? new FsStorageProvider(),
         debug: options?.debug ?? false,
         debugPageUpdates: options?.debugPageUpdates ?? false
     };
 }
 
 export async function init(config: SynthOSConfig, includeDefaultPages: boolean = true): Promise<boolean> {
+    const sp = config.storageProvider;
+
     // Check for existing folder
-    if (await checkIfExists(config.pagesFolder)) {
+    if (await sp.checkIfExists(config.pagesFolder)) {
         await repairMissingFolders(config);
         return false;
     }
 
-    console.log(`Initializing .synthos folder...`);
+    console.log(`Initializing ${config.localFolder} folder...`);
 
     // Create pages folder
-    await ensureFolderExists(config.pagesFolder);
+    await sp.ensureFolderExists(config.pagesFolder);
 
     // Create mandatory files
-    await saveFile(path.join(config.pagesFolder, '.gitignore'), 'settings.json\n');
-    await saveFile(path.join(config.pagesFolder, 'settings.json'), JSON.stringify(DefaultSettings, null, 4));
-    await saveFile(path.join(config.pagesFolder, 'settings.json.example'), JSON.stringify(DefaultSettings, null, 4));
+    await sp.saveFile(path.join(config.pagesFolder, '.gitignore'), 'settings.json\n');
+    await sp.saveFile(path.join(config.pagesFolder, 'settings.json'), JSON.stringify(DefaultSettings, null, 4));
+    await sp.saveFile(path.join(config.pagesFolder, 'settings.json.example'), JSON.stringify(DefaultSettings, null, 4));
 
     // Setup default scripts
-    console.log(`Copying default scripts to .synthos folder...`);
+    console.log(`Copying default scripts to ${config.localFolder} folder...`);
     const scriptsFolder = path.join(config.pagesFolder, 'scripts');
-    await ensureFolderExists(scriptsFolder);
-    switch (process.platform) {
-        case 'win32':
-            await copyFile(path.join(config.defaultScriptsFolder, 'windows-terminal.json'), scriptsFolder);
-            break;
-        case 'darwin':
-            await copyFile(path.join(config.defaultScriptsFolder, 'mac-terminal.json'), scriptsFolder);
-            break;
-        case 'android':
-            await copyFile(path.join(config.defaultScriptsFolder, 'android-terminal.json'), scriptsFolder);
-            break;
-        case 'linux':
-        default:
-            await copyFile(path.join(config.defaultScriptsFolder, 'linux-terminal.json'), scriptsFolder);
-            break;
-    }  
-
-    await saveFile(path.join(scriptsFolder, 'example.sh'), '#!/bin/bash\n\n# This is an example script\n\n# You can run this script using the following command:\n# sh .synthos/scripts/example.sh\n\n# This script will print "Hello, World!" to the console\n\necho "Hello, World!"\n');
-
-    // Setup default themes
-    console.log(`Copying default themes to .synthos folder...`);
-    const themesFolder = path.join(config.pagesFolder, 'themes');
-    await ensureFolderExists(themesFolder);
-    await copyFiles(config.defaultThemesFolder, themesFolder);
+    await sp.ensureFolderExists(scriptsFolder);
+    const scriptFilename = ({
+        win32: 'windows-terminal.json',
+        darwin: 'mac-terminal.json',
+        android: 'android-terminal.json',
+    } as Record<string, string>)[process.platform] ?? 'linux-terminal.json';
+    const scriptSrc = await findFileInFolders(config.defaultScriptsFolders, scriptFilename);
+    if (scriptSrc) {
+        // Read from package (local fs), write to user storage (provider)
+        const data = await fs.readFile(scriptSrc);
+        await sp.saveBuffer(path.join(scriptsFolder, path.basename(scriptSrc)), data);
+    }
+
+    await sp.saveFile(path.join(scriptsFolder, 'example.sh'), `#!/bin/bash\n\n# This is an example script\n\n# You can run this script using the following command:\n# sh ${config.localFolder}/scripts/example.sh\n\n# This script will print "Hello, World!" to the console\n\necho "Hello, World!"\n`);
+
+    // Create empty themes folder — default themes are served directly from
+    // defaultThemesFolders; users can add custom themes here.
+    await sp.ensureFolderExists(path.join(config.pagesFolder, 'themes'));
 
     // Copy pages
     if (includeDefaultPages) {
-        console.log(`Copying default pages to .synthos folder...`);
-        await copyDefaultPages(config.defaultPagesFolder, config.pagesFolder);
+        console.log(`Copying default pages to ${config.localFolder} folder...`);
+        await copyDefaultPages(config, config.defaultPagesFolders);
     }
 
     return true;
 }
 
 async function repairMissingFolders(config: SynthOSConfig): Promise<void> {
+    const sp = config.storageProvider;
+
     // Rebuild scripts folder from defaults if missing
     const scriptsFolder = path.join(config.pagesFolder, 'scripts');
-    if (!await checkIfExists(scriptsFolder)) {
-        console.log(`Restoring default scripts to .synthos folder...`);
-        await ensureFolderExists(scriptsFolder);
-        switch (process.platform) {
-            case 'win32':
-                await copyFile(path.join(config.defaultScriptsFolder, 'windows-terminal.json'), scriptsFolder);
-                break;
-            case 'darwin':
-                await copyFile(path.join(config.defaultScriptsFolder, 'mac-terminal.json'), scriptsFolder);
-                break;
-            case 'android':
-                await copyFile(path.join(config.defaultScriptsFolder, 'android-terminal.json'), scriptsFolder);
-                break;
-            case 'linux':
-            default:
-                await copyFile(path.join(config.defaultScriptsFolder, 'linux-terminal.json'), scriptsFolder);
-                break;
+    if (!await sp.checkIfExists(scriptsFolder)) {
+        console.log(`Restoring default scripts to ${config.localFolder} folder...`);
+        await sp.ensureFolderExists(scriptsFolder);
+        const scriptFilename = ({
+            win32: 'windows-terminal.json',
+            darwin: 'mac-terminal.json',
+            android: 'android-terminal.json',
+        } as Record<string, string>)[process.platform] ?? 'linux-terminal.json';
+        const scriptSrc = await findFileInFolders(config.defaultScriptsFolders, scriptFilename);
+        if (scriptSrc) {
+            const data = await fs.readFile(scriptSrc);
+            await sp.saveBuffer(path.join(scriptsFolder, path.basename(scriptSrc)), data);
         }
-        await saveFile(path.join(scriptsFolder, 'example.sh'), '#!/bin/bash\n\n# This is an example script\n\n# You can run this script using the following command:\n# sh .synthos/scripts/example.sh\n\n# This script will print "Hello, World!" to the console\n\necho "Hello, World!"\n');
+        await sp.saveFile(path.join(scriptsFolder, 'example.sh'), `#!/bin/bash\n\n# This is an example script\n\n# You can run this script using the following command:\n# sh ${config.localFolder}/scripts/example.sh\n\n# This script will print "Hello, World!" to the console\n\necho "Hello, World!"\n`);
     }
 
-    // Rebuild themes folder from defaults if missing
-    const themesFolder = path.join(config.pagesFolder, 'themes');
-    if (!await checkIfExists(themesFolder)) {
-        console.log(`Restoring default themes to .synthos folder...`);
-        await ensureFolderExists(themesFolder);
-        await copyFiles(config.defaultThemesFolder, themesFolder);
-    } else {
-        // Upgrade outdated themes — copy newer versioned CSS from defaults
-        const outdated = await getOutdatedThemes(config);
-        if (outdated.length > 0) {
-            console.log(`Upgrading ${outdated.length} theme(s): ${outdated.join(', ')}...`);
-            const defaultFiles = await listFiles(config.defaultThemesFolder);
-            for (const themeName of outdated) {
-                // Remove old versioned CSS files for this theme
-                const localFiles = await listFiles(themesFolder);
-                for (const f of localFiles) {
-                    const parsed = parseThemeFilename(f);
-                    if (parsed && parsed.name === themeName) {
-                        await deleteFile(path.join(themesFolder, f));
-                    }
-                }
-                // Copy the new versioned CSS from defaults
-                for (const f of defaultFiles) {
-                    const parsed = parseThemeFilename(f);
-                    if (parsed && parsed.name === themeName) {
-                        await copyFile(path.join(config.defaultThemesFolder, f), themesFolder);
-                    }
-                }
-            }
-        }
-    }
+    // Ensure themes folder exists — default themes are served directly from
+    // defaultThemesFolders; this folder is for user-added custom themes only.
+    await sp.ensureFolderExists(path.join(config.pagesFolder, 'themes'));
 
     // Ensure pages/ subfolder exists
     const pagesSubdir = path.join(config.pagesFolder, 'pages');
-    if (!await checkIfExists(pagesSubdir)) {
+    if (!await sp.checkIfExists(pagesSubdir)) {
         // No pages folder and no flat files — rebuild from defaults
-        const htmlFiles = (await listFiles(config.pagesFolder)).filter(f => f.endsWith('.html'));
+        const htmlFiles = (await sp.listFiles(config.pagesFolder)).filter(f => f.endsWith('.html'));
         if (htmlFiles.length === 0) {
-            console.log(`Restoring default pages to .synthos/pages/ folder...`);
-            await copyDefaultPages(config.defaultPagesFolder, config.pagesFolder);
+            console.log(`Restoring default pages to ${config.localFolder}/pages/ folder...`);
+            await copyDefaultPages(config, config.defaultPagesFolders);
         } else {
-            await ensureFolderExists(pagesSubdir);
+            await sp.ensureFolderExists(pagesSubdir);
         }
     }
 
     // Migrate any stray flat .html files from root into pages/<name>/
-    await migrateFlatPages(config.pagesFolder);
+    await migrateFlatPages(config);
 }
 
 function toTitleCase(name: string): string {
@@ -164,13 +170,15 @@ function toTitleCase(name: string): string {
         .replace(/\b\w/g, c => c.toUpperCase());
 }
 
-async function migrateFlatPages(pagesFolder: string): Promise<void> {
+async function migrateFlatPages(config: SynthOSConfig): Promise<void> {
+    const sp = config.storageProvider;
+    const pagesFolder = config.pagesFolder;
     const pagesSubdir = path.join(pagesFolder, 'pages');
-    const htmlFiles = (await listFiles(pagesFolder)).filter(f => f.endsWith('.html'));
+    const htmlFiles = (await sp.listFiles(pagesFolder)).filter(f => f.endsWith('.html'));
     if (htmlFiles.length === 0) return;
 
-    console.log(`Migrating ${htmlFiles.length} page(s) to .synthos/pages/ folder...`);
-    await ensureFolderExists(pagesSubdir);
+    console.log(`Migrating ${htmlFiles.length} page(s) to ${config.localFolder}/pages/ folder...`);
+    await sp.ensureFolderExists(pagesSubdir);
     const now = new Date().toISOString();
 
     for (const file of htmlFiles) {
@@ -178,12 +186,11 @@ async function migrateFlatPages(pagesFolder: string): Promise<void> {
         const category = pageName.startsWith('[') ? 'Builder' : 'Pages';
         const title = toTitleCase(pageName);
         const pageFolder = path.join(pagesSubdir, pageName);
-        await ensureFolderExists(pageFolder);
-        await fs.copyFile(
-            path.join(pagesFolder, file),
-            path.join(pageFolder, 'page.html')
-        );
-        await saveFile(
+        await sp.ensureFolderExists(pageFolder);
+        // Both source and destination are user storage
+        const content = await sp.loadFile(path.join(pagesFolder, file));
+        await sp.saveFile(path.join(pageFolder, 'page.html'), content);
+        await sp.saveFile(
             path.join(pageFolder, 'page.json'),
             JSON.stringify({
                 title,
@@ -196,44 +203,87 @@ async function migrateFlatPages(pagesFolder: string): Promise<void> {
                 mode: 'unlocked',
             }, null, 4)
         );
-        await deleteFile(path.join(pagesFolder, file));
+        await sp.deleteFile(path.join(pagesFolder, file));
     }
 }
 
-async function copyDefaultPages(srcFolder: string, destFolder: string): Promise<void> {
-    const pagesDir = path.join(destFolder, 'pages');
-    await ensureFolderExists(pagesDir);
-    const files = await fs.readdir(srcFolder);
+async function copyDefaultPages(config: SynthOSConfig, srcFolders: string[]): Promise<void> {
+    const sp = config.storageProvider;
+    const pagesDir = path.join(config.pagesFolder, 'pages');
+    await sp.ensureFolderExists(pagesDir);
     const now = new Date().toISOString();
-    for (const file of files) {
-        if (!file.endsWith('.html')) continue;
-        const pageName = file.replace(/\.html$/, '');
-        const pageFolder = path.join(pagesDir, pageName);
-        await ensureFolderExists(pageFolder);
-        await fs.copyFile(path.join(srcFolder, file), path.join(pageFolder, 'page.html'));
-
-        // Read companion .json metadata from source folder, fall back to defaults
-        let metadata: Record<string, unknown> = {};
-        const jsonPath = path.join(srcFolder, `${pageName}.json`);
-        if (await checkIfExists(jsonPath)) {
-            try {
-                const raw = await fs.readFile(jsonPath, 'utf-8');
-                metadata = JSON.parse(raw);
-            } catch {
-                // use defaults
+    const seen = new Set<string>();
+
+    for (const srcFolder of srcFolders) {
+        if (!await checkIfExists(srcFolder)) continue;  // source is always local fs
+        const dirs = await listFolders(srcFolder);       // source is always local fs
+        for (const dir of dirs) {
+            const srcPageDir = path.join(srcFolder, dir);
+            if (!await checkIfExists(path.join(srcPageDir, 'page.html'))) continue;
+            if (seen.has(dir)) continue; // first folder wins
+            seen.add(dir);
+
+            const pageFolder = path.join(pagesDir, dir);
+            await sp.ensureFolderExists(pageFolder);
+
+            // Read from local fs, write via provider
+            const htmlData = await fs.readFile(path.join(srcPageDir, 'page.html'));
+            await sp.saveBuffer(path.join(pageFolder, 'page.html'), htmlData);
+
+            // Read companion page.json metadata from source folder, fall back to defaults
+            let metadata: Record<string, unknown> = {};
+            const jsonPath = path.join(srcPageDir, 'page.json');
+            if (await checkIfExists(jsonPath)) {
+                try {
+                    const raw = await fs.readFile(jsonPath, 'utf-8');
+                    metadata = JSON.parse(raw);
+                } catch {
+                    // use defaults
+                }
+            }
+            const fullMetadata = {
+                title: typeof metadata.title === 'string' ? metadata.title : '',
+                categories: Array.isArray(metadata.categories) ? metadata.categories : [],
+                pinned: typeof metadata.pinned === 'boolean' ? metadata.pinned : false,
+                showInAll: typeof metadata.showInAll === 'boolean' ? metadata.showInAll : true,
+                createdDate: now,
+                lastModified: now,
+                pageVersion: typeof metadata.pageVersion === 'number' ? metadata.pageVersion
+                    : typeof metadata.uxVersion === 'number' ? metadata.uxVersion : PAGE_VERSION,
+                mode: metadata.mode === 'locked' ? 'locked' : 'unlocked',
+            };
+            await sp.saveFile(path.join(pageFolder, 'page.json'), JSON.stringify(fullMetadata, null, 4));
+
+            // Copy data subfolders (anything that isn't page.html/page.json)
+            // Read from local fs, write via provider using cross-provider copy
+            const subEntries = await fs.readdir(srcPageDir, { withFileTypes: true });
+            for (const entry of subEntries) {
+                if (!entry.isDirectory()) continue;
+                await crossProviderCopyFolder(
+                    path.join(srcPageDir, entry.name),
+                    path.join(pageFolder, entry.name),
+                    sp
+                );
             }
         }
-        const fullMetadata = {
-            title: typeof metadata.title === 'string' ? metadata.title : '',
-            categories: Array.isArray(metadata.categories) ? metadata.categories : [],
-            pinned: typeof metadata.pinned === 'boolean' ? metadata.pinned : false,
-            showInAll: typeof metadata.showInAll === 'boolean' ? metadata.showInAll : true,
-            createdDate: now,
-            lastModified: now,
-            pageVersion: typeof metadata.pageVersion === 'number' ? metadata.pageVersion
-                : typeof metadata.uxVersion === 'number' ? metadata.uxVersion : PAGE_VERSION,
-            mode: metadata.mode === 'locked' ? 'locked' : 'unlocked',
-        };
-        await saveFile(path.join(pageFolder, 'page.json'), JSON.stringify(fullMetadata, null, 4));
+    }
+}
+
+/**
+ * Copy a folder from local filesystem to the storage provider.
+ * Reads from local fs, writes via provider.
+ */
+async function crossProviderCopyFolder(srcFolder: string, destFolder: string, sp: StorageProvider): Promise<void> {
+    await sp.ensureFolderExists(destFolder);
+    const entries = await fs.readdir(srcFolder, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcFolder, entry.name);
+        const destPath = path.join(destFolder, entry.name);
+        if (entry.isDirectory()) {
+            await crossProviderCopyFolder(srcPath, destPath, sp);
+        } else {
+            const data = await fs.readFile(srcPath);
+            await sp.saveBuffer(destPath, data);
+        }
     }
 }

package/src/migrations.ts

@@ -10,6 +10,7 @@ import { deduplicateInlineScripts } from './service/transformPage';
  */
 const migrations: Record<number, (html: string, completePrompt: completePrompt) => Promise<string>> = {
     1: migrateV1toV2,
+    2: migrateV2toV3,
 };
 
 /**
@@ -36,7 +37,6 @@ const SHARED_CSS_SELECTORS = [
     '.chat-panel', '.chat-header', '.chat-messages',
     '.chat-message', '.chat-message p', '.chat-message p strong', '.chat-message p code',
     '.chat-message strong', '.chat-message pre', '.chat-message code', '.chat-message a',
-    '.link-group', '.link-group a', '.link-group a:hover',
     'form',
     '.chat-input', '.chat-input:focus', '.chat-input::placeholder', '.chat-input:disabled',
     '.chat-submit', '.chat-submit:hover', '.chat-submit:active', '.chat-submit:disabled',
@@ -80,14 +80,8 @@ const DEFAULT_CHAT_PANEL = `
         <div class="chat-messages" id="chatMessages">
             <div class="chat-message"><p>Welcome! How can I help you?</p></div>
         </div>
-        <div class="link-group">
-            <a href="#" id="saveLink">Save</a>
-            <a href="/pages" id="pagesLink">Pages</a>
-            <a href="#" id="resetLink">Reset</a>
-        </div>
         <form action="/" method="POST" id="chatForm">
-            <input type="text" class="chat-input" id="chatInput" name="message" placeholder="Type a message...">
-            <button type="submit" class="chat-submit">Send</button>
+            <textarea class="chat-input" id="chatInput" name="message" rows="2" placeholder="Type a message..."></textarea>
         </form>
     </div>`;
 
@@ -125,6 +119,33 @@ async function migrateV1toV2(html: string, completePrompt: completePrompt): Prom
     return migrated;
 }
 
+/**
+ * v2 -> v3: Cheerio-based migration (no LLM).
+ * - Removes .link-group div
+ * - Converts chat <input> to <textarea>
+ * - Removes .chat-submit button (v3 creates it dynamically)
+ */
+async function migrateV2toV3(html: string, _completePrompt: completePrompt): Promise<string> {
+    const $ = cheerio.load(html, { decodeEntities: false });
+
+    // 1. Remove .link-group div and its children
+    $('.link-group').remove();
+
+    // 2. Replace <input type="text" id="chatInput" ...> with <textarea>
+    const chatInput = $('input#chatInput, input.chat-input');
+    if (chatInput.length > 0) {
+        chatInput.replaceWith(
+            '<textarea class="chat-input" id="chatInput" name="message" rows="2" placeholder="Type a message..."></textarea>'
+        );
+    }
+
+    // 3. Remove .chat-submit button inside #chatForm (or anywhere)
+    $('button.chat-submit').remove();
+
+    // Run through postProcessV2 to ensure structural integrity
+    return postProcessV2($.html());
+}
+
 /**
  * Cheerio-based post-processing to verify the LLM output meets v2 requirements.
  * Uses the original HTML as a fallback source for critical elements.
@@ -146,8 +167,7 @@ export function postProcessV2(html: string, originalHtml?: string): string {
                 // Append default form
                 $('.chat-panel').append(`
         <form action="/" method="POST" id="chatForm">
-            <input type="text" class="chat-input" id="chatInput" name="message" placeholder="Type a message...">
-            <button type="submit" class="chat-submit">Send</button>
+            <textarea class="chat-input" id="chatInput" name="message" rows="2" placeholder="Type a message..."></textarea>
         </form>`);
             }
         } else {