﻿OutOS Easy Installer - MVP1 bundle
==================================

This ZIP is the fallback/inspectable form of a PRE-RELEASE, UNSIGNED, script-driven build for
testing the installation experience. The normal user download is outos-easy-installer-mvp1.cmd,
which embeds this bundle, extracts it automatically, and starts the same guided installer.
It is not a finished product: no auto-update, no telemetry, no AI features.

How to run
----------
Primary path:
1. Download outos-easy-installer-mvp1.cmd.
2. Open the downloaded file. It extracts this bundle to LocalAppData and starts the GUI.

Fallback ZIP path:
1. EXTRACT the ZIP first: right-click the downloaded ZIP -> "Extract All...".
   Do NOT double-click the launcher from inside the ZIP window - Windows then extracts only the
   launcher without the installer files, and nothing can start.
2. In the EXTRACTED folder, double-click  Launch-OutOS-Easy-Installer.cmd  (it opens the
   preflight GUI; give it a few seconds).
   If Windows SmartScreen warns about the .cmd, choose "More info" -> "Run anyway" (it is an
   unsigned local script). You can read it in a text editor first - it only launches PowerShell
   against aw-os-easy-installer.ps1.

What it does
------------
- Scans this PC (UEFI vs legacy, Secure Boot, BitLocker, GPU, disks, USB devices, Bluetooth input).
- Includes the custom OutOS MVP1 ISO builder. The GUI reads the expected image path from
  scripts\targets\ubuntu-26.04.json. On this lab machine the current verified image is
  D:\aw-os-mvp\outos-mvp1-plymouth-v3\outos-mvp1-ubuntu-26.04-amd64.iso with
  D:\aw-os-mvp\outos-mvp1-plymouth-v3\SHA256SUMS.
- Builds a local Migration Pack v0: selected user files, browser bookmarks, app inventory,
  locale/timezone/keyboard settings, Wi-Fi profile names, Bluetooth inventory, and safe dev config.
- Ships an Ubuntu import script: scripts\ubuntu\outos-import-migration.sh.
- Detects your likely boot-menu key and offers a guided "boot handoff":
    * Restart into the boot menu  (Windows Advanced Startup -> "Use a device")
    * Restart into UEFI firmware settings  (on UEFI machines)
    * Per-vendor boot key, then a graceful "your hardware may not be compatible" fallback.

What it will NOT do without YOUR explicit action
------------------------------------------------
- It NEVER writes/erases a disk without an exact  DiskNumber:Serial  confirmation that you type.
- It NEVER reboots on its own - the handoff PREPARES the restart and asks you to confirm; you
  perform the actual restart.
- It does NOT change boot order, BCD, firmware variables, Secure Boot, or BitLocker.
- Firmware boot entries are READ ONLY (bcdedit /enum). The experimental one-time-boot option is
  shown as text only and is never executed in MVP1.
- It does NOT export browser cookies, logged-in sessions, Chrome/Google passwords, Windows
  Credential Manager secrets, DPAPI keys, Bluetooth pairing keys, Wi-Fi passwords, or SSH private
  keys in Migration Pack v0.

Reference
---------
See docs\EasyBootHandoff.md in this bundle for the full boot-handoff design and the reasons a
fully automatic USB boot cannot be promised across all consumer PCs.

Brand note
----------
This MVP1 bundle is branded OutOS. Some internal script and folder names still contain aw-os for
compatibility with existing tests, handoff docs, and staged paths.
