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

mykola-zalizniak · web-flow · commit a2f194b87eb6 · 2026-03-26T11:56:00.000-04:00
* 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 &amp; 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 &amp; 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
diff --git a/launcher/src/app/app.component.html b/launcher/src/app/app.component.html
@@ -247,6 +247,10 @@
                                                 <mat-icon>upgrade</mat-icon>
                                                 <span>Export</span>
                                             </button>
+                                            <button mat-menu-item (click)="copyCliCommand(element)">
+                                                <mat-icon>terminal</mat-icon>
+                                                <span>Copy CLI</span>
+                                            </button>
                                             @if (
                                                 browserLauncherService.getRunningStatus(element) ==
                                                 BrowserProfileStatus.Idle
diff --git a/launcher/src/app/app.component.ts b/launcher/src/app/app.component.ts
@@ -11,6 +11,7 @@ import { MatProgressBarModule } from '@angular/material/progress-bar';
 import { MatSidenavModule } from '@angular/material/sidenav';
 import { MatSort, MatSortModule } from '@angular/material/sort';
 import { MatTableDataSource, MatTableModule } from '@angular/material/table';
+import { MatSnackBar, MatSnackBarModule } from '@angular/material/snack-bar';
 import { MatToolbarModule } from '@angular/material/toolbar';
 import { MatTooltipModule } from '@angular/material/tooltip';
 import { RouterOutlet } from '@angular/router';
@@ -54,6 +55,7 @@ export type NavItem = 'profiles' | 'proxies' | 'kernels';
         MatListModule,
         MatProgressBarModule,
         MatTooltipModule,
+        MatSnackBarModule,
         StopPropagationDirective,
         ProxyManagementComponent,
         KernelManagementComponent,
@@ -69,6 +71,7 @@ export class AppComponent implements AfterViewInit {
 
     readonly AppName = AppName;
     readonly #dialog = inject(MatDialog);
+    readonly #snackBar = inject(MatSnackBar);
     currentNav: NavItem = 'profiles';
     readonly formatDateTime = formatDateTime;
     readonly formatProxyDisplay = formatProxyDisplay;
@@ -312,6 +315,14 @@ export class AppComponent implements AfterViewInit {
             });
     }
 
+    async copyCliCommand(browserProfile: BrowserProfile): Promise<void> {
+        const flags = BrowserLauncherService.buildProfileFlags(browserProfile);
+        if (!flags.length) return;
+        const cli = `chromium-browser \\\n  --bot-profile=<path-to-profile> \\\n  ${flags.join(' \\\n  ')}`;
+        await Neutralino.clipboard.writeText(cli);
+        this.#snackBar.open('Copied to clipboard', '', { duration: 2000 });
+    }
+
     async refreshProfiles(): Promise<void> {
         this.loading = true;
         try {
diff --git a/launcher/src/app/data/browser-profile.ts b/launcher/src/app/data/browser-profile.ts
@@ -71,17 +71,12 @@ export const ColorSchemes: ColorScheme[] = ['light', 'dark'];
 export type OrientationOption = 'profile' | 'landscape' | 'portrait' | 'landscape-primary' | 'landscape-secondary' | 'portrait-primary' | 'portrait-secondary';
 export const OrientationOptions: OrientationOption[] = ['profile', 'landscape', 'portrait', 'landscape-primary', 'landscape-secondary', 'portrait-primary', 'portrait-secondary'];
 
-// Behavior toggles
+// Behavior toggles (pure browser UI/runtime behavior)
 export interface BehaviorToggles {
-    botLocalDns?: boolean;
     botDisableDebugger?: boolean;
     botMobileForceTouch?: boolean;
     botAlwaysActive?: boolean;
-    botInjectRandomHistory?: boolean;
     botDisableConsoleMessage?: boolean;
-    botPortProtection?: boolean;
-    botNetworkInfoOverride?: boolean;
-    botGpuEmulation?: boolean;
 }
 
 // Identity & Locale config
@@ -93,6 +88,8 @@ export interface IdentityLocaleConfig {
     botConfigLocale?: string;
     botConfigTimezone?: string;
     botConfigLocation?: string;
+    botInjectRandomHistory?: boolean | number;
+    botEnableVariationsInContext?: boolean;
 }
 
 // Custom User-Agent config
@@ -140,14 +137,19 @@ export interface RenderingMediaConfig {
     botConfigMediaTypes?: MediaTypesOption;
     botConfigWebrtc?: ProfileRealDisabled;
     botWebrtcIce?: string;
+    botGpuEmulation?: boolean;
 }
 
-// Proxy config
+// Proxy & Network config
 export interface ProxyConfig {
     proxyServer?: string;
     proxyIp?: string;
     botIpService?: string;
     proxyBypassRgx?: string;
+    // Network protection (moved from Behavior)
+    botLocalDns?: boolean;
+    botPortProtection?: boolean;
+    botNetworkInfoOverride?: boolean;
 }
 
 // Advanced config
diff --git a/launcher/src/app/edit-browser-profile.component.html b/launcher/src/app/edit-browser-profile.component.html
@@ -67,9 +67,9 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
             </button>
         </div>
 
-        <!-- Proxy -->
+        <!-- Proxy & Network -->
         <div class="section" id="section-proxy">
-            <div class="section-header">Proxy</div>
+            <div class="section-header">Proxy & Network</div>
             @if (proxies.length > 0) {
                 <mat-form-field>
                     <mat-label>Select existing proxy</mat-label>
@@ -114,6 +114,24 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                     <input matInput placeholder="e.g. \.(js|css|png)(\?|$)" formControlName="proxyBypassRgx" />
                     <mat-hint>RE2 regex to bypass proxy for matching URLs</mat-hint>
                 </mat-form-field>
+
+                <div class="section-title">Network Protection</div>
+                <div class="toggle-grid">
+                    <mat-slide-toggle formControlName="botLocalDns">
+                        Local DNS Resolution
+                        <span class="toggle-hint">Resolve DNS locally instead of through proxy (default: off)</span>
+                    </mat-slide-toggle>
+
+                    <mat-slide-toggle formControlName="botPortProtection">
+                        Port Protection
+                        <span class="toggle-hint">Protect local ports from scanning (default: off)</span>
+                    </mat-slide-toggle>
+
+                    <mat-slide-toggle formControlName="botNetworkInfoOverride">
+                        Network Info Override
+                        <span class="toggle-hint">Use profile-defined navigator.connection values (default: off)</span>
+                    </mat-slide-toggle>
+                </div>
             </form>
         </div>
 
@@ -172,6 +190,34 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                 <mat-hint class="section-hint">Leave empty or "auto" to derive from IP address</mat-hint>
             </form>
 
+            <div class="section-title">Session Authenticity</div>
+            <form [formGroup]="identityLocaleGroup">
+                <div class="form-row">
+                    <mat-form-field class="flex-1">
+                        <mat-label>History Injection</mat-label>
+                        <mat-select [(value)]="historyMode" (selectionChange)="onHistoryModeChange()">
+                            <mat-option value="">Off</mat-option>
+                            <mat-option value="random">Random</mat-option>
+                            <mat-option value="number">Custom count</mat-option>
+                        </mat-select>
+                        <mat-hint>Inject browsing history entries</mat-hint>
+                    </mat-form-field>
+
+                    @if (historyMode === 'number') {
+                        <mat-form-field class="flex-1">
+                            <mat-label>History Count</mat-label>
+                            <input matInput type="number" placeholder="e.g. 15" [(ngModel)]="historyCount" [ngModelOptions]="{standalone: true}" (input)="onHistoryCountChange()" />
+                            <mat-hint>Exact number of history entries</mat-hint>
+                        </mat-form-field>
+                    }
+                </div>
+
+                <mat-slide-toggle formControlName="botEnableVariationsInContext" class="standalone-toggle">
+                    X-Client-Data in Incognito
+                    <span class="toggle-hint">Include Chrome variations headers in incognito contexts (default: off)</span>
+                </mat-slide-toggle>
+            </form>
+
             <div class="section-title">Custom User-Agent Override</div>
             <form [formGroup]="customUserAgentGroup">
                 <mat-form-field>
@@ -464,6 +510,11 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                         <input matInput placeholder="Custom ICE candidates" formControlName="botWebrtcIce" />
                     </mat-form-field>
                 </div>
+
+                <mat-slide-toggle formControlName="botGpuEmulation" class="standalone-toggle">
+                    GPU Emulation
+                    <span class="toggle-hint">Auto-select optimal GPU rendering backend (default: off)</span>
+                </mat-slide-toggle>
             </form>
         </div>
 
@@ -486,35 +537,10 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                     <span class="toggle-hint">Suppress console output (default: on)</span>
                 </mat-slide-toggle>
 
-                <mat-slide-toggle formControlName="botLocalDns">
-                    Local DNS Resolution
-                    <span class="toggle-hint">Use local DNS (default: off)</span>
-                </mat-slide-toggle>
-
                 <mat-slide-toggle formControlName="botMobileForceTouch">
                     Force Touch (Mobile)
                     <span class="toggle-hint">Force touch events (default: off)</span>
                 </mat-slide-toggle>
-
-                <mat-slide-toggle formControlName="botInjectRandomHistory">
-                    Inject Random History
-                    <span class="toggle-hint">Add random history (default: off)</span>
-                </mat-slide-toggle>
-
-                <mat-slide-toggle formControlName="botPortProtection">
-                    Port Protection
-                    <span class="toggle-hint">Protect local ports from scanning (default: off)</span>
-                </mat-slide-toggle>
-
-                <mat-slide-toggle formControlName="botNetworkInfoOverride">
-                    Network Info Override
-                    <span class="toggle-hint">Use profile-defined navigator.connection values (default: off)</span>
-                </mat-slide-toggle>
-
-                <mat-slide-toggle formControlName="botGpuEmulation">
-                    GPU Emulation
-                    <span class="toggle-hint">Auto-select optimal GPU rendering backend (default: off)</span>
-                </mat-slide-toggle>
             </form>
         </div>
 
@@ -612,6 +638,22 @@ <h2 mat-dialog-title>{{ isEdit ? 'Edit' : 'Create' }} Browser Profile</h2>
                     <mat-hint>JSON object with header name-value pairs</mat-hint>
                 </mat-form-field>
             </form>
+
+            <!-- CLI Preview -->
+            <div class="section-title">CLI Command Preview</div>
+            @if (getCliPreview(); as cli) {
+                <div class="cli-preview">
+                    <div class="cli-header">
+                        <span class="cli-label">Command</span>
+                        <button mat-icon-button class="copy-btn" (click)="copyCliToClipboard()">
+                            <mat-icon>content_copy</mat-icon>
+                        </button>
+                    </div>
+                    <code class="cli-code">{{ cli }}</code>
+                </div>
+            } @else {
+                <div class="cli-preview cli-empty">No flags configured</div>
+            }
         </div>
     </div>
 </mat-dialog-content>
diff --git a/launcher/src/app/edit-browser-profile.component.scss b/launcher/src/app/edit-browser-profile.component.scss
@@ -212,3 +212,53 @@ mat-form-field {
     font-size: 13px;
     margin-top: 8px;
 }
+
+.cli-preview {
+    padding: 12px;
+    border-radius: 4px;
+    font-size: 13px;
+    line-height: 1.6;
+    background: rgba(0, 0, 0, 0.04);
+    border: 1px solid rgba(0, 0, 0, 0.08);
+
+    .cli-header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+    }
+
+    .cli-label {
+        font-weight: 500;
+        color: rgba(0, 0, 0, 0.6);
+    }
+
+    .copy-btn {
+        width: 24px;
+        height: 24px;
+        padding: 0;
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+
+        mat-icon {
+            font-size: 14px;
+            width: 14px;
+            height: 14px;
+            line-height: 14px;
+        }
+    }
+
+    .cli-code {
+        display: block;
+        font-family: 'Courier New', Courier, monospace;
+        font-size: 12px;
+        color: rgba(0, 0, 0, 0.87);
+        white-space: pre-wrap;
+        word-break: break-all;
+        margin-top: 4px;
+    }
+
+    &.cli-empty {
+        color: rgba(0, 0, 0, 0.38);
+    }
+}
diff --git a/launcher/src/app/edit-browser-profile.component.ts b/launcher/src/app/edit-browser-profile.component.ts
diff --git a/launcher/src/app/shared/browser-launcher.service.ts b/launcher/src/app/shared/browser-launcher.service.ts
