Record passing terminal UX ISO acceptance and delivery artifacts

2026-10-13 18:10:39 +03:00
parent 1bc7965cca
commit be30e9dd49
9 changed files with 205 additions and 22 deletions
@@ -0,0 +1,45 @@
+# Hydra OS terminal UX preview
+
+Source revision: `1bc7965ccaddb76abc78aafa82bb59358cf4dc0e`.
+
+## Changes
+
+- Terminal VM menu accepts a number, name, or the remembered selection. Opening a stopped guest starts it explicitly; opening a live guest reconnects its screen. The selected VM receives the initial workspace after refresh, while other QEMU processes continue independently.
+- `hydra run URL --name NAME` downloads an ISO, creates a new guest and opens it. `hydra open NAME` reopens it; `hydra download URL` only downloads. Guided creation honors the same `--defaults` as direct CLI creation.
+- Downloads show progress, support cancellation and optional publisher SHA-256, validate ISO9660 declared extents, and preserve existing files/profiles. Pure UDF images are explicitly unsupported by this initial downloader; ISO9660/UDF hybrids are accepted through ISO9660 validation. A format check does not establish publisher authenticity or arbitrary guest OS bootability.
+- Visible system, boot, installer and viewer labels use **Hydra OS**. Fastfetch includes an original three-headed text logo and a concise host summary.
+- A separate self-contained developer update bundle supports dry-run, exact checksums, backups and best-effort exception rollback. It does not replace guest disks, profiles, kernel or networking.
+
+## Verification
+
+- Complete source suite: **293 tests passed**, 44.788 seconds.
+- Private two-guest focus probe: selecting Beta opens workspace 2; fresh keyboard focus, unchanged PID/UUID and continuing hidden counters survive refresh and compositor exit.
+- Private general graphics/input smoke: reserved switching while keybindings are inhibited, manual USB selector without automatic attachment, view reconnection and media lifecycle passed. Requested display mode is 1920×1080 at 144000 mHz; physical refresh/input behavior is not inferred from that request.
+- Independent task and final branch reviews completed; ISO extent validation, partial rollback reporting, shortcut help and custom menu defaults findings were resolved. No open review findings remain.
+- The final full update zipapp was exercised against a disposable installed-root fixture: dry-run, apply, all installed hashes, retained original metadata and relocated CLI passed. The existing user installation has not been updated.
+
+Rebuilt ISO boot/install acceptance: **all 13 checks passed**. The [complete report](acceptance.json) identifies the exact ISO and firmware. It includes real installation, ISO-free boot, password login, persistent data, the packaged terminal UX and Fastfetch, routed LAN-to-VM TCP, nested KVM, VM/socket survival through actual logout and normal shutdown. No check was skipped. The [Fastfetch capture](fastfetch.txt) comes from the installed test guest's default configuration.
+
+The previous preview record at `../2026-10-13/` describes only the earlier ISO and is unchanged.
+
+## Delivery and decisions
+
+ISO: `hydra-os.iso`, 2,345,932,800 bytes. SHA-256:
+
+```text
+1ed2cc79482ac5b14794ed6d4c4caf46ecc54af6457c5d38bc662cd3c104fbad
+```
+
+Runtime update: `hydra-os-update-1bc7965.pyz`, 56,425 bytes. SHA-256:
+
+```text
+3ed9288451894277797aa34f105f1969af0a892b1ec14dc27b1fadeed2a7e7f3
+```
+
+See [terminal usage](../../terminal-usage.md) for applying it inside an installed Hydra guest, logging out and in again, installing Fastfetch on older images, and manually reversing an update. The bundle includes Fastfetch configuration/artwork, not its executable package.
+
+The derivative OS identity is `ID=hydra-os`, `ID_LIKE=gentoo`; vendor `/usr/lib/os-release` remains intact. Consumers matching only `ID=gentoo` need to consider `ID_LIKE`. Technical hostname, bridge, storage paths and EFI bootloader identifier remain compatible.
+
+The downloader deliberately rejects pure UDF because it cannot verify its declared extent with the implemented validator. Such media needs a supported alternative or a separate manual download/lower-level workflow. Publisher hashes remain advisable for whole-image integrity.
+
+Physical ASUS graphics, touchpad, brightness keys, Wi-Fi, suspend, audio playback and actual USB-device redirection remain hardware checks. The updater is a trusted-source developer tool with backups, not a signed package manager or a guarantee of multi-file atomicity across power loss. No command channel into the existing manual test VM was available; staged delivery evidence does not mean that VM was updated.
@@ -0,0 +1,66 @@
+{
+  "schema": 1,
+  "status": "passed",
+  "scratch": "/home/workspaces/ubuntu-dev/home/.cache/hydra-tests/hydra-iso-smoke-rjtq89i8",
+  "iso": "/home/workspaces/ubuntu-dev/home/Projects/hydra-os/build/artifacts/hydra-os.iso",
+  "iso_sha256": "1ed2cc79482ac5b14794ed6d4c4caf46ecc54af6457c5d38bc662cd3c104fbad",
+  "checks": {
+    "live_qmp_kvm": {
+      "status": "passed",
+      "output": "{\"enabled\": true, \"present\": true}"
+    },
+    "live_boot": {
+      "status": "passed",
+      "output": "/usr/bin/hydra\n/usr/bin/hydra-install\n/usr/bin/qemu-system-x86_64\n/usr/bin/qemu-img\n/usr/bin/remote-viewer\n/usr/bin/foot\n/usr/bin/labwc\nactive\nactive\nactive\n"
+    },
+    "real_installer": {
+      "status": "passed",
+      "output": "Installer completed via guest controlling TTY"
+    },
+    "live_poweroff": {
+      "status": "passed",
+      "output": "QEMU exited before ISO-free reboot"
+    },
+    "installed_qmp_kvm": {
+      "status": "passed",
+      "output": "{\"enabled\": true, \"present\": true}"
+    },
+    "installed_password_login": {
+      "status": "passed",
+      "output": "hydratest\n"
+    },
+    "installed_terminal_ux": {
+      "status": "passed",
+      "output": "{\"status\": \"passed\", \"uid\": 1000, \"normal_user\": \"hydratest\", \"launcher\": \"/usr/bin/hydra\", \"fixture_bytes\": 43008, \"iso_sha256\": \"aa66329c263f560f514c00a71551490dd6593ee7632404e072584e2803e0a1c7\", \"cache_reused\": true, \"http_requests\": [\"/fixture.iso\"], \"before\": {\"name\": \"ux-407c8d94\", \"uuid\": \"708c7761-5d45-540b-9e50-ecbccab235dd\", \"pid\": 664, \"process_start\": \"1365\", \"kvm\": true}, \"after_open\": {\"name\": \"ux-407c8d94\", \"uuid\": \"708c7761-5d45-540b-9e50-ecbccab235dd\", \"pid\": 664, \"process_start\": \"1365\", \"kvm\": true}, \"after_menu\": {\"name\": \"ux-407c8d94\", \"uuid\": \"708c7761-5d45-540b-9e50-ecbccab235dd\", \"pid\": 664, \"process_start\": \"1365\", \"kvm\": true}, \"memory_mib\": 512, \"cpus\": 1, \"disk_size\": \"64M\", \"network\": \"bridge\", \"empty_menu\": \"\\nHydra OS \\u2014 virtual machines\\n\\nNo VM profiles. Use :run to create one from an ISO path or direct URL.\\n\\nNumber/name opens one VM; Enter opens the last (*) or only VM.\\n:run / :new  :download  :network  :shell  :help  :refresh  :quit\\n:shutdown NAME requests guest shutdown; :detach NAME removes ISO while stopped.\\nhydra> \", \"running_menu\": \"\\nHydra OS \\u2014 virtual machines\\n\\n  #  Name                             State            RAM\\n  1  ux-407c8d94                      running          512 MiB\\n\\nNumber/name opens one VM; Enter opens the last (*) or only VM.\\n:run / :new  :download  :network  :shell  :help  :refresh  :quit\\n:shutdown NAME requests guest shutdown; :detach NAME removes ISO while stopped.\\nhydra> \", \"run_output\": \"\", \"download_output\": \"/tmp/hux-cov4pymn/cache/hydra/iso/4341afe870c3591f6581e2c0c00554e8876cfe2f669a6208636261a2f6b069ee-fixture.iso\\n\", \"fastfetch_command\": [\"fastfetch\", \"--pipe\", \"false\", \"--show-errors\"], \"fastfetch_default_config_sha256\": \"2af12ce007705f039870867c89b0fc6f90bcf6c6b29c04b63ab75f345419b1a1\", \"fastfetch_logo_sha256\": \"ddd6d11f785aac99591fbcc5959e9f553287514459832131c70e48525ad76868\", \"fastfetch_output\": \"    /\\\\        /\\\\        /\\\\    hydratest@hydra-os\\n .-(o >    .-(o >    .-(o >   OS: Hydra OS x86_64\\n/  /      /  /      /  /      Kernel: Linux 6.18.54-gentoo-dist-bin\\n\\\\  \\\\______\\\\  \\\\______\\\\  \\\\      Uptime: 12 seconds\\n \\\\        \\\\          /        CPU: 12th Gen Intel(R) Core(TM) i7-12650H (2) @ 2.69 GHz\\n  '---.          .---'        Memory: 426.05 MiB / 3.80 GiB (11%)\\n       \\\\  /\\\\/\\\\  /             Disk (/): 6.98 GiB / 30.34 GiB (23%) - ext4\\n     ___\\\\/    \\\\/___           Local IP (enp0s2): 10.0.2.15/24\\n    /______________\\\\\\n       H Y D R A  O S\\n\\n\", \"scope\": \"Packaged installed CLI, cache, branding and live nested QMP/KVM; nonboot ISO fixture, no nested OS boot or performance claim\", \"cleanup\": \"Only the verified private fixture VM stopped through hydra stop --force\"}\n"
+    },
+    "disk_persistence": {
+      "status": "passed",
+      "output": "Sentinel content verified from command output frame"
+    },
+    "installed_contract": {
+      "status": "passed",
+      "output": "active\nactive\nactive\nactive\n3: hydrabr0    inet 10.203.0.1/24 brd 10.203.0.255 scope global noprefixroute hydrabr0\\       valid_lft forever preferred_lft forever\ndefault via 10.0.2.2 dev enp0s2 proto dhcp src 10.0.2.15 metric 100 \ntable ip hydra_nat {\n\tchain postrouting {\n\t\ttype nat hook postrouting priority srcnat; policy accept;\n\t\tip saddr 10.203.0.0/24 oifname != \"hydrabr0\" masquerade\n\t}\n}\nconnected\n198.18.0.41     STREAM gentoo.org\n198.18.0.41     DGRAM  \n198.18.0.41     RAW    \n/usr/bin/hydra\n/usr/bin/hydra-install\n/usr/bin/qemu-system-x86_64\n/usr/bin/qemu-img\n/usr/bin/remote-viewer\n/usr/bin/foot\n/usr/bin/labwc\n\u001b[1;34musage: \u001b[0m\u001b[1;35mhydra\u001b[0m [\u001b[32m-h\u001b[0m] [\u001b[36m--config \u001b[33mCONFIG\u001b[0m] [\u001b[36m--state \u001b[33mSTATE\u001b[0m] [\u001b[36m--runtime \u001b[33mRUNTIME\u001b[0m]\n             [\u001b[36m--defaults \u001b[33mDEFAULTS\u001b[0m]\n             \u001b[32m{menu,download,run,open,add,media,list,status,start,shutdown,stop,view,session,_session-helper} ...\u001b[0m\n\nHydra OS independent VM manager\n\n\u001b[1;34mpositional arguments:\u001b[0m\n  \u001b[1;32m{menu,download,run,open,add,media,list,status,start,shutdown,stop,view,session,_session-helper}\u001b[0m\n    \u001b[1;32mmenu\u001b[0m                Open the terminal VM menu\n    \u001b[1;32mdownload\u001b[0m            Download and validate a direct ISO URL\n    \u001b[1;32mrun\u001b[0m                 Create, start and display a VM from a local ISO or\n                        HTTP(S) URL\n    \u001b[1;32mopen\u001b[0m                Start a stopped VM or reconnect a running VM\n    \u001b[1;32madd\u001b[0m                 Create a VM profile without starting it\n    \u001b[1;32mmedia\u001b[0m               Attach or detach installation media while stopped\n    \u001b[1;32mlist\u001b[0m                List configured VMs\n    \u001b[1;32mstatus\u001b[0m              Query VM state through private QMP\n    \u001b[1;32mview\u001b[0m                Connect a viewer without changing VM power\n    \u001b[1;32msession\u001b[0m             Start the minimal Hydra OS labwc session\n    \u001b[1;32m_session-helper\u001b[0m     ==SUPPRESS==\n\n\u001b[1;34moptions:\u001b[0m\n  \u001b[1;32m-h\u001b[0m, \u001b[1;36m--help\u001b[0m            show this help message and exit\n  \u001b[1;36m--config\u001b[0m \u001b[1;33mCONFIG\u001b[0m\n  \u001b[1;36m--state\u001b[0m \u001b[1;33mSTATE\u001b[0m\n  \u001b[1;36m--runtime\u001b[0m \u001b[1;33mRUNTIME\u001b[0m\n  \u001b[1;36m--defaults\u001b[0m \u001b[1;33mDEFAULTS\u001b[0m   Distribution preferences for newly created profiles\nQEMU emulator version 10.2.3\nCopyright (c) 2003-2025 Fabrice Bellard and the QEMU Project developers\nqemu-img version 10.2.3\nCopyright (c) 2003-2025 Fabrice Bellard and the QEMU Project developers\n/usr/share/edk2/OvmfX64/OVMF_CODE.fd\n"
+    },
+    "lan_to_vm_tcp": {
+      "status": "passed",
+      "output": "PASS: routed new LAN-to-VM TCP connection on arbitrary port 43117\n"
+    },
+    "nested_kvm": {
+      "status": "passed",
+      "output": "Formatting '/tmp/hydra-nested-pmtnvwzh/fresh.qcow2', fmt=qcow2 cluster_size=65536 extended_l2=off compression_type=zlib size=67108864 lazy_refcounts=off refcount_bits=16\nPASS: normal-user nested KVM VM and bridge helper; fresh qcow2; private QMP\n"
+    },
+    "installed_user_logout": {
+      "status": "passed",
+      "output": "{\"status\": \"passed\", \"real_logout\": true, \"no_open_logins\": true, \"survival_seconds\": 15, \"same_vm\": {\"name\": \"logout-bc617dc9\", \"uuid\": \"0c031012-0f16-55bb-98c5-ed7352000c2c\", \"pid\": 943, \"process_start\": \"2192\", \"directories\": {\"/run/user/1000/hydra-logout-bc617dc9\": [46, 52, 16832], \"/run/user/1000/hydra-logout-bc617dc9/logout-bc617dc9\": [46, 53, 16832]}, \"sockets\": {\"qmp\": [46, 57, 1000, 49640], \"spice\": [46, 56, 1000, 49640], \"pipewire\": [46, 28, 1000, 49590], \"pulse\": [46, 27, 1000, 49590]}, \"audio_services\": {\"pipewire.service\": \"InvocationID=aac07ae95f15474894fc94690edfa62c\\nExecMainPID=916\\n\", \"pipewire-pulse.service\": \"InvocationID=55735e4672f2412398cfd82086b21030\\nExecMainPID=918\\n\", \"wireplumber.service\": \"InvocationID=1dc399b7b35c42c7bb43f44923805472\\nExecMainPID=917\\n\"}}, \"audio_scope\": \"Socket and service continuity only; signal/playback untested\"}\n"
+    },
+    "installed_poweroff": {
+      "status": "passed",
+      "output": "Normal installed guest shutdown"
+    }
+  },
+  "physical_hardware": "pending",
+  "nested_scope": "Normal-user KVM VM launch, bridge helper and QMP; no nested guest OS boot",
+  "ovmf_code_sha256": "f3ff7e73448ed2845ee15356f394882f5618eb5dab92c9a30ec6ee0e1468553a",
+  "ovmf_vars_input_sha256": "6ed987af3a3c155be71665f510eae3e007eda9b8b94afd59d45e91c4a11565cc",
+  "completed_utc": "2026-10-13T15:08:23Z"
+}
@@ -0,0 +1,33 @@
+{
+  "source_commit": "1bc7965ccaddb76abc78aafa82bb59358cf4dc0e",
+  "iso": {
+    "file": "hydra-os.iso",
+    "size": 2345932800,
+    "sha256": "1ed2cc79482ac5b14794ed6d4c4caf46ecc54af6457c5d38bc662cd3c104fbad"
+  },
+  "runtime_update": {
+    "status": "passed",
+    "bundle": "hydra-os-update-1bc7965.pyz",
+    "source_commit": "1bc7965ccaddb76abc78aafa82bb59358cf4dc0e",
+    "sha256": "3ed9288451894277797aa34f105f1969af0a892b1ec14dc27b1fadeed2a7e7f3",
+    "payload_files": 16,
+    "checks": [
+      "dry_run_no_changes",
+      "zipapp_apply",
+      "all_payload_hashes",
+      "original_image_manifest",
+      "vendor_release_preserved",
+      "branded_release",
+      "relocated_cli"
+    ],
+    "existing_user_guest_modified": false
+  },
+  "kernel": "6.18.54-gentoo-dist-bin",
+  "packages": 561,
+  "tests": {
+    "unit": 293,
+    "iso_acceptance": 13,
+    "iso_skipped": 0
+  },
+  "physical_hardware": "pending"
+}
@@ -0,0 +1,11 @@
+    /\        /\        /\    hydratest@hydra-os
+ .-(o >    .-(o >    .-(o >   OS: Hydra OS x86_64
+/  /      /  /      /  /      Kernel: Linux 6.18.54-gentoo-dist-bin
+\  \______\  \______\  \      Uptime: 12 seconds
+ \        \          /        CPU: 12th Gen Intel(R) Core(TM) i7-12650H (2) @ 2.69 GHz
+  '---.          .---'        Memory: 426.05 MiB / 3.80 GiB (11%)
+       \  /\/\  /             Disk (/): 6.98 GiB / 30.34 GiB (23%) - ext4
+     ___\/    \/___           Local IP (enp0s2): 10.0.2.15/24
+    /______________\
+       H Y D R A  O S
+
@@ -0,0 +1,17 @@
+{
+  "status": "passed",
+  "bundle": "hydra-os-update-1bc7965.pyz",
+  "source_commit": "1bc7965ccaddb76abc78aafa82bb59358cf4dc0e",
+  "sha256": "3ed9288451894277797aa34f105f1969af0a892b1ec14dc27b1fadeed2a7e7f3",
+  "payload_files": 16,
+  "checks": [
+    "dry_run_no_changes",
+    "zipapp_apply",
+    "all_payload_hashes",
+    "original_image_manifest",
+    "vendor_release_preserved",
+    "branded_release",
+    "relocated_cli"
+  ],
+  "existing_user_guest_modified": false
+}