fix(launcher): prevent kernel update corruption and improve extraction (#101)

* refactor: rename BotBrowserConsole to BotBrowserLauncher

* feat: add kernel management, proxy management, and setup scripts

* fix: enable macOS native Edit menu for Cmd+C/V/X/A keyboard shortcuts

* chore: upgrade Neutralino runtime to 6.4.0

* chore: remove Neutralino binaries from repo, download via neu update

* fix: improve macOS clipboard support with JS fallback for Cmd+V paste

* fix: expand macOS clipboard fallback to Cmd+C/X, auto-download Neutralino via postinstall

* chore: upgrade Neutralino to 6.5.0 and simplify setup scripts

* fix: fix PowerShell setup script ZIP download corruption

* feat: enhance proxy workflow with IP check, quick change, and reusable input component

* fix: correct checkbox color override and setup script stdin handling

* feat: improve profile deletion with auto-stop, group WebRTC settings, prioritize custom exec path

* feat: add port protection toggle, fix kernel auto-update cleanup and UI refresh

* fix: detect kernel assets by file extension to support renamed Windows/Linux packages

* fix: handle non-browser process exits, add crash detection, validate kernel executable paths

* docs: add --bot-time-seed documentation, changelog 2026-03-03, value range and per-context cross-links

* feat: add proxy save/check, improve table layout and kernel date display

- Add "Save to proxy list" button in proxy input for reusing manually entered proxies
- Add batch proxy connectivity check with IP/status display in proxy management
- Sort proxy list by creation time (newest first)
- Fix kernel date display: parse from asset filename, fix timezone offset bug
- Simplify profile status column to icon-only (play/stop) with tooltips
- Remove year from "Last Launch" date to prevent truncation
- Widen window to 1080px, use fixed table layout to prevent horizontal scrollbar
- Add column width constraints for profile and proxy tables

* feat: redesign profile editor with left nav, advanced config modes, and new fields

- Add left-side anchor navigation with scrollspy (IntersectionObserver)
- Split Fingerprint into separate Noise and Rendering sections
- Replace expansion panel with flat Advanced section layout
- Add mode toggles for Executable (kernel/custom), Cookies and Bookmarks (file/input)
- Add FPS dropdown (profile/real/custom number) instead of free-text input
- Add Save IP button in proxy section for explicit IP saving
- Add new fields: Time Seed, Proxy Bypass Regex, Cookies, Bookmarks, Custom Headers
- Put username/password on same row in proxy input
- Widen status column to prevent icon clipping

* fix: replace Save IP with Save to proxy list, unify dropdown option labels

* fix: include username and password in proxy duplicate detection

Normalize both sides with `|| ''` to handle undefined values, and add
password to the comparison so proxies with the same host:port but
different credentials are treated as distinct entries.

* fix: prevent editing running profiles and remove auto-save IP on proxy check

- Block profile editing when browser is running/launching/stopping,
  show alert dialog instead of silently darkening the background
- Remove onIpCheckResult that auto-saved checked IP to proxyIp field

* feat(launcher): add automatic self-update with GitHub commit tracking

Check for launcher updates on startup and every hour by comparing
the local commit hash against the latest launcher-specific commit
from GitHub API (path=launcher). When an update is found, silently
download, rebuild, and prompt the user to restart.

- Add UpdateService with periodic check, ZIP download, and rebuild
- Show update status (checking/downloading/building/ready) in sidebar
- Display current version (commit hash) at sidebar bottom
- Update setup scripts to save commit hash after install/build
- Fix sidebar footer layout to stay at bottom via flex container

* feat(launcher): improve table UX, add new CLI flags, and proxy input enhancements

- Separate row highlight (single click) from checkbox selection (batch ops)
- Add double-click to edit on both profile and proxy tables
- Add clear proxy button in profile editor
- Combine proxy type/host/port into single row layout
- Add --bot-stack-seed and --bot-network-info-override CLI flags
- Update noise seed from float to integer range
- Stack seed uses dropdown (profile/real/custom) like FPS
- Rearrange noise settings: seed+scale+timeseed row, fps+stackseed row
- Widen proxy type column in proxy list table

* fix(launcher): auto-highlight new profiles/proxies and default noise text rects off

- Return created profile/proxy ID from dialog so the table highlights
  the new row after creation, matching the edit-then-highlight behavior
- Change botConfigNoiseTextRects default from on to off

* feat(launcher): add new CLI flags, clear user data, and unsaved changes guard

- Add --bot-config-orientation dropdown in Display & Input section with all orientation variants, noted as mobile profiles only
- Add --bot-gpu-emulation toggle in Behavior section for auto GPU rendering backend selection
- Add "Clear User Data" action in both profile edit dialog and profile list context menu to delete user-data-dir
- Guard profile and proxy edit dialogs against accidental close: Escape, backdrop click, and Cancel now prompt when forms have unsaved changes

* feat(launcher): reorganize flag categories, add CLI preview, new 2026-03-26 flags

- Restructure sections: Proxy → Proxy & Network, move GPU Emulation
  to Rendering, History Injection to Identity (now supports count)
- Add --bot-enable-variations-in-context and --bot-inject-random-history={number}
- Add CLI command preview in Advanced tab + Copy CLI in context menu
- Backward compat for old profiles with flags in behavior.*
- Fix history count type coercion, add copy snackbar feedback

* fix(launcher): prevent kernel update corruption and improve extraction

- Use unique directory per install (tagName_githubAssetId) to avoid overwriting running kernel files during auto-update
- Verify directory deletion before removing kernel record to prevent orphaned records when files are locked on Windows
- Clean up outdated kernels at runtime when browser exits, not only at launcher startup
- Check 7z availability early at init and before download, show warning banner when missing
- Fix nested 7z/zip extraction: use recursive dir search and trim \r from Windows dir output so chrome.7z is found and cleaned up
- Add open-folder button in kernel list to reveal install directory
- deleteKernel throws if files are locked instead of silently failing

Author: mykola-zalizniak

launcher/src/app/data/kernel.ts

@@ -1,6 +1,7 @@
 export type KernelPlatform = 'win_x86_64' | 'mac_arm64' | 'mac_x86_64' | 'linux_x86_64' | 'linux_arm64';
 
 export interface KernelAsset {
+    id: number; // GitHub asset ID, globally unique
     name: string;
     platform: KernelPlatform;
     downloadUrl: string;

launcher/src/app/kernel-management/kernel-management.component.html

@@ -7,6 +7,18 @@
     </button>
 </mat-toolbar>
 
+@if (kernelService.isExtractorChecked() && !kernelService.isExtractorAvailable()) {
+    <div class="error-banner">
+        <mat-icon>warning</mat-icon>
+        @if (kernelService.getCurrentPlatform() === 'win_x86_64') {
+            7-Zip is required to extract kernels. Please install it from
+            <a href="https://7-zip.org/" target="_blank">7-zip.org</a>
+        } @else {
+            dpkg-deb (or ar + tar) is required to extract kernels. Please install dpkg or binutils.
+        }
+    </div>
+}
+
 @if (error) {
     <div class="error-banner">
         <mat-icon>error</mat-icon>
@@ -67,6 +79,9 @@
                     <ng-container matColumnDef="actions">
                         <th mat-header-cell *matHeaderCellDef></th>
                         <td mat-cell *matCellDef="let element">
+                            <button mat-icon-button (click)="openInstallDir(element)" matTooltip="Open folder">
+                                <mat-icon>folder_open</mat-icon>
+                            </button>
                             <button mat-icon-button color="warn" (click)="deleteKernel(element)" matTooltip="Delete">
                                 <mat-icon>delete</mat-icon>
                             </button>

launcher/src/app/kernel-management/kernel-management.component.ts

@@ -7,7 +7,9 @@ import { MatProgressBarModule } from '@angular/material/progress-bar';
 import { MatTableDataSource, MatTableModule } from '@angular/material/table';
 import { MatToolbarModule } from '@angular/material/toolbar';
 import { MatTooltipModule } from '@angular/material/tooltip';
+import * as Neutralino from '@neutralinojs/lib';
 import type { InstalledKernel, KernelRelease } from '../data/kernel';
+import { AlertDialogComponent } from '../shared/alert-dialog.component';
 import { ConfirmDialogComponent } from '../shared/confirm-dialog.component';
 import { KernelService } from '../shared/kernel.service';
 
@@ -28,7 +30,7 @@ import { KernelService } from '../shared/kernel.service';
     styleUrl: './kernel-management.component.scss',
 })
 export class KernelManagementComponent implements OnInit {
-    readonly #kernelService = inject(KernelService);
+    readonly kernelService = inject(KernelService);
     readonly #dialog = inject(MatDialog);
 
     readonly displayedColumns = ['version', 'platform', 'installedAt', 'actions'];
@@ -41,36 +43,36 @@ export class KernelManagementComponent implements OnInit {
 
     constructor() {
         effect(() => {
-            const version = this.#kernelService.installedKernelsVersion();
+            const version = this.kernelService.installedKernelsVersion();
             if (version > 0) this.refresh();
         });
     }
 
     // Check if a specific release is being downloaded
     isDownloading(tagName: string): boolean {
-        return this.#kernelService.isDownloading(tagName);
+        return this.kernelService.isDownloading(tagName);
     }
 
     // Check if there are any active downloads
     get hasActiveDownloads(): boolean {
-        return this.#kernelService.hasActiveDownloads();
+        return this.kernelService.hasActiveDownloads();
     }
 
     // Get all download progresses for display
     get downloadProgresses() {
-        return this.#kernelService.downloadProgresses();
+        return this.kernelService.downloadProgresses();
     }
 
     async ngOnInit(): Promise<void> {
-        await this.#kernelService.initialize();
+        await this.kernelService.initialize();
         await this.refresh();
         await this.loadAvailableReleases();
     }
 
     async refresh(): Promise<void> {
         this.loading = true;
         try {
-            const kernels = await this.#kernelService.getInstalledKernels();
+            const kernels = await this.kernelService.getInstalledKernels();
             this.dataSource.data = kernels;
         } finally {
             this.loading = false;
@@ -81,7 +83,7 @@ export class KernelManagementComponent implements OnInit {
         this.loadingReleases = true;
         this.error = null;
         try {
-            this.availableReleases = await this.#kernelService.fetchAvailableReleases();
+            this.availableReleases = await this.kernelService.fetchAvailableReleases();
         } catch (e) {
             this.error = e instanceof Error ? e.message : 'Failed to load releases';
         } finally {
@@ -93,21 +95,29 @@ export class KernelManagementComponent implements OnInit {
         // Filter by majorVersion - if a major version is installed, don't show it
         // (auto-update will handle upgrades to newer releases within the same major version)
         const installedMajorVersions = new Set(this.dataSource.data.map((k) => k.majorVersion));
-        const platform = this.#kernelService.getCurrentPlatform();
+        const platform = this.kernelService.getCurrentPlatform();
         return this.availableReleases.filter(
             (r) => !installedMajorVersions.has(r.majorVersion) && r.assets.some((a) => a.platform === platform)
         );
     }
 
     async downloadKernel(release: KernelRelease): Promise<void> {
         try {
-            await this.#kernelService.downloadAndInstall(release);
+            await this.kernelService.downloadAndInstall(release);
             await this.refresh();
         } catch (e) {
             this.error = e instanceof Error ? e.message : 'Download failed';
         }
     }
 
+    async openInstallDir(kernel: InstalledKernel): Promise<void> {
+        try {
+            await Neutralino.os.open(kernel.installPath);
+        } catch (error) {
+            console.error('Failed to open directory:', error);
+        }
+    }
+
     deleteKernel(kernel: InstalledKernel): void {
         this.#dialog
             .open(ConfirmDialogComponent, {
@@ -116,8 +126,14 @@ export class KernelManagementComponent implements OnInit {
             .afterClosed()
             .subscribe(async (result: boolean) => {
                 if (!result) return;
-                await this.#kernelService.deleteKernel(kernel.id);
-                await this.refresh();
+                try {
+                    await this.kernelService.deleteKernel(kernel.id);
+                    await this.refresh();
+                } catch (error) {
+                    this.#dialog.open(AlertDialogComponent, {
+                        data: { message: error instanceof Error ? error.message : 'Failed to delete kernel.' },
+                    });
+                }
             });
     }
 
@@ -134,7 +150,7 @@ export class KernelManagementComponent implements OnInit {
     }
 
     getReleaseAssetDate(release: KernelRelease): string | null {
-        const platform = this.#kernelService.getCurrentPlatform();
+        const platform = this.kernelService.getCurrentPlatform();
         const asset = release.assets.find((a) => a.platform === platform);
         return this.formatAssetDate(asset?.assetDate);
     }

launcher/src/app/shared/browser-launcher.service.ts

@@ -18,6 +18,7 @@ export interface RunningInfo {
     spawnProcessInfo?: Neutralino.SpawnedProcess;
     resolver?: any;
     startTime?: number;
+    kernelId?: string;
 }
 
 @Injectable({ providedIn: 'root' })
@@ -53,6 +54,7 @@ export class BrowserLauncherService {
                         if (!runningInfo) break; // System process (7z, curl, etc.) — not a browser
 
                         const uptime = runningInfo.startTime ? Date.now() - runningInfo.startTime : Infinity;
+                        const exitedKernelId = runningInfo.kernelId;
                         runningInfo.status = BrowserProfileStatus.Idle;
                         runningInfo.spawnProcessInfo = undefined;
 
@@ -63,6 +65,11 @@ export class BrowserLauncherService {
                                 },
                             });
                         }
+
+                        // Try to clean up old kernels now that this browser exited
+                        if (exitedKernelId) {
+                            this.#tryCleanupOldKernel(exitedKernelId);
+                        }
                     }
                     break;
             }
@@ -205,7 +212,7 @@ export class BrowserLauncherService {
 
         const args = this.#buildCliArgs(browserProfile, { botProfilePath, userDataDirPath, diskCacheDirPath });
 
-        const runningInfo: RunningInfo = { browserProfileId: browserProfile.id, status: BrowserProfileStatus.Running, startTime: Date.now() };
+        const runningInfo: RunningInfo = { browserProfileId: browserProfile.id, status: BrowserProfileStatus.Running, startTime: Date.now(), kernelId: kernel?.id };
 
         const warmupUrls = (browserProfile.warmupUrls ?? '').split('\n');
         if (!warmupUrls.length) warmup = false;
@@ -408,6 +415,17 @@ export class BrowserLauncherService {
         return args;
     }
 
+    #tryCleanupOldKernel(kernelId: string): void {
+        // Check if any other running browser is still using this kernel
+        const stillInUse = Array.from(this.#runningStatuses.values()).some(
+            (info) => info.kernelId === kernelId && info.status === BrowserProfileStatus.Running
+        );
+        if (stillInUse) return;
+
+        // Ask kernel service to clean up old versions if this one is outdated
+        this.#kernelService.cleanupOldKernelIfOutdated(kernelId).catch(console.error);
+    }
+
     async stop(browserProfile: BrowserProfile): Promise<void> {
         if (this.getRunningStatus(browserProfile) !== BrowserProfileStatus.Running) {
             throw new Error('The profile is not running');