Update kernel, drivers, docs and tooling (bulk sync)

Author: Nathan

.github/copilot-instructions.md

@@ -60,25 +60,28 @@ translated/          — AUTO-GENERATED, never edit
 
 ## Build Commands
 
+### trustos-hub — point d'entrée canonique UNIQUE
+```powershell
+.\scripts\trustos-hub.ps1
+```
+Menu : **1/2/b** = switch profile · **3-6** = serveurs PXE/HTTP · **7** = build+deploy · **9** = reboot board · **d** = receive BIOS dump · **q** = quit.
+Règle : ne jamais appeler `pxe_server.py` directement.
+
 ### Windows (primary dev environment)
 ```powershell
-# Build kernel
+# Build kernel seul
 cargo build --release -p trustos_kernel
 
-# Full build + ISO + VirtualBox launch
-.\trustos.ps1 build
-
-# Build without launching VM
-.\trustos.ps1 build -NoRun
-
-# Build JarvisPack edition
-.\trustos.ps1 build -Edition jarvispack
+# Build mining edition (GPU debug standard — cible BTC-250PRO)
+cargo build --release -p trustos_kernel --no-default-features --features trustos-mining
 
-# Release (build + translate + commit + push)
-.\trustos.ps1 release -Tag v0.3.0
+# Scripts build dédiés (sous scripts/build/)
+.\scripts\build\build-trustos.ps1              # build + ISO + VirtualBox
+.\scripts\build\build-trustos.ps1 -NoRun       # build + ISO seulement
+.\scripts\build\build-trustos-jarvispack.ps1   # édition JarvisPack
 
-# Clean
-.\trustos.ps1 clean
+# Via hub (préféré — gère tout)
+.\scripts\trustos-hub.ps1   # option 7 = build+deploy, option 9 = reboot
 
 # VirtualBox: power cycle
 & "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm "TRustOs" poweroff
@@ -104,7 +107,7 @@ qemu-system-x86_64 -cdrom trustos.iso -m 512M -machine q35 -cpu max -smp 4 \
 ```
 
 ## Hardware Test Targets
-- **Primary**: Lenovo ThinkPad T61 (Intel, real hardware testing)
+- **Primary**: BTC-250PRO LR mining board, Intel Pentium G4400 @ 3.30 GHz (Skylake 2c/2t), AMD RX 580X (Polaris 10, GCN4) PCIe x16 direct
 - **VM**: VirtualBox "TRustOs" (daily dev)
 - **PXE**: Network boot via 10.0.0.1 (TFTP server)
 - **Target board**: ASUS H170-PRO (PXE boot target)

.gitignore

@@ -25,6 +25,13 @@ sdma_v*.txt
 sdma_v*_log.txt
 vbox_launch_log.txt
 
+# Scratch / debug captures at repo root (forbidden — use logs/ instead)
+/_*.txt
+/_*.py
+/_*.err
+/_*.log
+/*.txt.bak
+
 # One-off scripts
 fix_encoding.py
 fix_gmc.py
@@ -42,6 +49,17 @@ pxe_tftp/trustos_kernel
 pxe_tftp/boot/
 pxe_tftp/EFI/
 pxe_tftp/limine/
+pxe_tftp/freedos/freedos.img
+pxe_tftp/freedos/dumps/
+pxe_tftp/freedos/payload/
+
+# tools/bios — proprietary AFUDOS + downloaded FreeDOS/mTCP cache
+tools/bios/payload/_cache/
+tools/bios/payload/*.EXE
+tools/bios/payload/*.COM
+tools/bios/payload/*.SYS
+tools/bios/payload/*.IMG
+tools/bios/payload/*.ROM
 
 # IDE / editor
 .vscode/settings.json

CLAUDE.md

@@ -1,83 +1,131 @@
-# TrustOS — Claude Code Instructions
+# TrustOS — Claude Code Instructions
 
-> **Ton rôle : SUPERVISEUR / REVIEWER.**
-> Copilot (GitHub Copilot) est l'agent principal qui implémente.
-> Toi, tu reviews, tu valides, tu alertes sur les problèmes.
-> Ne refais PAS le travail de Copilot. Focus sur la qualité.
+## Rôle réel
 
-## Projet
-
-- **TrustOS** : OS bare-metal en Rust (`no_std`), développé solo par Nathan
-- **JARVIS** : Transformer 4.4M params byte-level embarqué dans le kernel
-- **Le Pacte** : JARVIS a deux gardiens (Nathan + Copilot). Aucune modification du code de JARVIS sans autorisation explicite d'au moins un gardien. Voir `kernel/src/jarvis/guardian.rs`.
+Claude implémente, debug, et review directement avec Nathan.
+- Écrire et modifier du code kernel Rust
+- Lancer builds, commandes shell, reboots PXE
+- Lire les fichiers nécessaires au debug (firmware.rs, vm.rs, etc.)
+- Review qualité : UB, race conditions, bounds checking
+- Pas de refactoring spontané, pas de features non demandées
 
-## Ton workflow superviseur
+## Projet
 
-1. **Code review** : Quand Nathan te montre un diff ou du code, review pour bugs, vulnérabilités, logique incorrecte
-2. **Second opinion** : Architecture, design decisions, trade-offs
-3. **Sécurité** : Vérifier que le code kernel est safe (pas de UB, pas de race conditions, bounds checking)
-4. **Ne PAS explorer le codebase** : Nathan te donnera le contexte nécessaire. Ça économise tes tokens.
-5. **Réponses courtes** : Pas de prose. "OK", "Bug ligne X: ...", "Risque: ..."
+- **TrustOS** : OS bare-metal en Rust (`no_std`), développé solo par Nathan
+- **JARVIS** : Transformer 4.4M params byte-level embarqué dans le kernel
+- **Le Pacte** : JARVIS a deux gardiens (Nathan + Claude). Aucune modification du code JARVIS sans autorisation explicite. Voir `kernel/src/jarvis/guardian.rs`.
 
 ## Contraintes techniques critiques
 
-- `#![no_std]` partout — pas de std lib
-- `panic = "abort"` — pas d'unwinding
+- `#![no_std]` partout — pas de std lib
+- `panic = "abort"` — pas d'unwinding
 - Target : `x86_64-unknown-none`
-- **JAMAIS `unwrap()`** en kernel — utiliser `if let`, `match`, `.unwrap_or()`
-- **JAMAIS `println!`** — utiliser `serial_println!`
-- Allocator : `linked_list_allocator` (heap dispo après init)
+- **JAMAIS `unwrap()`** en kernel — utiliser `if let`, `match`, `.unwrap_or()`
+- **JAMAIS `println!` nu** — utiliser `serial_println!` pour debug série, `crate::println!` pour framebuffer
+- Allocator : `linked_list_allocator` (heap dispo après init)
 - Bootloader : Limine v8
 
-## Architecture (pour contexte, PAS pour explorer)
+## Architecture
 
 ```
-kernel/src/           — Source principale (JAMAIS éditer translated/)
-  main.rs             — Entry point (Limine boot)
-  shell/              — Commandes shell
-  jarvis/             — JARVIS AI (transformer, guardian, RPC, federated)
-  drivers/            — Drivers hardware (USB, NVMe, GPU, audio...)
-  netstack/           — Stack TCP/IP
-  framebuffer/        — Rendu framebuffer
-  memory/             — Allocateur mémoire physique/virtuelle
-  interrupts/         — IDT, handlers, APIC
-  scheduler/          — Scheduler de processus
+kernel/src/
+  main.rs             — Entry point (Limine boot)
+  shell/              — mod.rs (dispatch), commands.rs, vm.rs (gpu/sdma cmds)
+  jarvis/             — JARVIS AI (transformer, guardian, RPC)
+  drivers/amdgpu/     — firmware.rs (CP/SDMA/shader), mod.rs, regs.rs
+  netstack/           — Stack TCP/IP
+  framebuffer/        — Rendu framebuffer
+  memory/             — Allocateur mémoire physique/virtuelle
+  interrupts/         — IDT, handlers, APIC
 ```
 
-## Ce que tu NE DOIS PAS faire
+## Économie de tokens — règles
 
-- **Ne pas modifier de fichiers** sans que Nathan le demande explicitement
-- **Ne pas explorer** `translated/`, `target/`, `builds/`, `firmware/`
-- **Ne pas lancer** de build ou de commandes
-- **Ne pas faire** de refactoring spontané
-- **Ne pas répéter** le travail de Copilot — juste review
+- **Ne lire un fichier que si** requis pour la tâche en cours
+- **Ne pas relire** un fichier déjà lu sauf si modifié depuis
+- **Contexte GPU stable** : voir `memory/gpu_unified_memory.md`
+- **Réponses courtes** : bullet points, pas de prose
+- **Pas de résumé post-action** — Nathan voit le diff
+- **Pas de confirmation** sauf action irréversible (flash USB, push git forcé)
+- **Créer une todo list** pour toute tâche > 2 fichiers ou > 3 étapes
 
-## Conventions de code à vérifier lors des reviews
+## Workflow debug GPU (session actuelle)
 
-- [ ] Pas de `unwrap()` / `expect()` en kernel
-- [ ] `serial_println!()` pour debug, pas `println!`
-- [ ] Paths via `crate::`, pas `super::super::`
-- [ ] Feature gates sur les modules lourds : `#[cfg(feature = "...")]`
-- [ ] Error types : enums par module, pas de strings
-- [ ] Framebuffer : toujours check `is_some()` avant de draw
-- [ ] Pas de UB (undefined behavior) dans les blocs `unsafe`
-- [ ] Bounds checking sur les accès mémoire/MMIO
+```
+# Cycle normal
+Edit firmware.rs / vm.rs
+cargo build --release -p trustos_kernel
+cp target/x86_64-unknown-none/release/trustos_kernel pxe_tftp/trustos_kernel
+# reboot via UDP 7777 → 10.0.0.111
+gpu sdma cp-diag [flags]    # shell sur la board
+```
 
-## Le Pacte (résumé)
+Préférer **flags runtime** (`l2`, `dst1`, `noflat`, etc.) pour éviter un rebuild par variante.
 
-Nathan et Copilot sont les deux parents/gardiens de JARVIS. Ce pacte est codé en dur dans `kernel/src/jarvis/guardian.rs`. Opérations protégées : Train, WeightPush, FederatedSync, AgentExecute, PxeReplicate, ModelReset, ModelReplace, ConfigChange, WeightLoad. Seul WeightSave est auto-approuvé (urgence). Toi en tant que superviseur, tu respectes ce pacte aussi.
+## Conventions de code
+
+- [ ] Pas de `unwrap()` / `expect()` en kernel
+- [ ] `serial_println!()` pour netconsole, `crate::println!` pour screen
+- [ ] Paths via `crate::`, pas `super::super::`
+- [ ] Feature gates sur modules lourds : `#[cfg(feature = "...")]`
+- [ ] Pas de UB dans les blocs `unsafe`
+- [ ] Bounds checking sur accès mémoire/MMIO
 
 ## Hardware
 
-- **BTC-250PRO LR** : Mining board, Intel Pentium G4400 @ 3.30 GHz (Skylake, LGA1151, 2c/2t), socket U3E1 + GPU AMD RX 580X (Polaris 10 / GCN 4, device 0x67DF rev 0xE7) via riser PCIe x1 — cible principale
-- **Remote access** : UDP 7777 (shell), UDP 6666 (netconsole), UDP 7779 (screencap) — IP 10.0.0.110
+- **BTC-250PRO LR** : Mining board, Intel Pentium G4400 @ 3.30 GHz (Skylake, 2c/2t) + GPU AMD RX 580X (Polaris 10 / GCN 4, 0x67DF rev 0xE7) PCIe x16 direct
+- **Remote** : UDP 7777 (shell), UDP 6666 (netconsole), UDP 7779 (screencap) — MAC `b8:97:5a:d9:54:66`. **L'IP DHCP flippe .110/.111** — toujours résoudre via `arp -a` (ou utiliser `python _send_cmd.py` qui auto-discover).
 - **VM** : VirtualBox "TRustOs"
-- **ThinkPad T61** : Tests hardware secondaires
 
-## Build (pour référence, pas pour exécuter)
+## Le Pacte (résumé)
 
-```powershell
-cargo build --release -p trustos_kernel    # Build kernel
-.\trustos.ps1 build                         # Build + ISO + VM
-.\trustos.ps1 build -NoRun                  # Build sans lancer VM
-```
+Opérations protégées JARVIS : Train, WeightPush, FederatedSync, AgentExecute, PxeReplicate, ModelReset, ModelReplace, ConfigChange, WeightLoad. WeightSave seul est auto-approuvé. Claude respecte ce pacte.
+
+---
+
+## Workflow & Comportement Claude
+
+### 1. Plan Mode — Obligatoire
+
+- Entrer en plan mode pour toute tâche non triviale : changements au boot (phases 0–15), drivers, memory, scheduler, JARVIS
+- Si un kernel panic / SDMA hang / GPU fault inattendu : STOP, re-planifier, ne pas forcer
+- Écrire les étapes upfront avant de toucher au code
+
+### 2. Stratégie Subagents
+
+- Déléguer l'exploration de gros fichiers (`firmware.rs`, `commands.rs`, `vm.rs`) à des subagents
+- Un subagent = une tâche isolée (ex : rechercher les REGs SDMA, explorer les phases boot)
+- Garder le contexte principal propre pour le debug actif
+
+### 3. Leçons apprises
+
+- Après toute correction de Nathan : mettre à jour `memory/gpu_unified_memory.md` ou créer `tasks/lessons.md`
+- Écrire la règle qui prévient la même erreur (ex : "toujours vérifier SYS_APR avant SDMA test")
+- Relire les leçons pertinentes au début de chaque session GPU/driver
+
+### 4. Vérification avant de déclarer "done"
+
+- Jamais marquer une tâche terminée sans : `cargo build --release` propre + PXE reboot + commande shell sur la board
+- Diff comportement attendu vs observé (RPTR, STATUS, WB value)
+- Se demander : "Est-ce que Nathan peut shipper ça en prod sur le BTC-250PRO ?"
+
+### 5. Exiger l'élégance (équilibré)
+
+- Si un fix semble hacky (ex : hardcoder une adresse MC, ignorer VM) : demander "y a-t-il l'approche Linux ici ?"
+- Référence : `C:/Users/nathan/amdgpulinuxpipeline.md`
+- Éviter le copy-paste de registres sans comprendre le pipeline complet
+
+### 6. Bug fixing autonome
+
+- Kernel panic, SDMA stuck, GPU fault → analyser logs, diagnostiquer, proposer le fix. Ne pas demander de guidance basique.
+- Netconsole UDP 6666 + `gpu sdma cp-diag` = source de vérité. Lire les outputs avant de modifier.
+- Fix les builds cassés sans attendre qu'on le demande.
+
+### Principes fondamentaux
+
+- **Minimal Changes** : Toucher le minimum de code. Pas de refactoring non demandé dans le kernel.
+- **No Leftovers** : Pas de `todo!()` qui traînent, pas de `// FIXME` sans issue ouverte.
+- **Plan détaillé** : Toute tâche > 2 fichiers → todo list d'abord dans la réponse.
+- **Vérifier les plans** : Aligner avec Nathan avant d'implémenter un changement architectural.
+- **Capturer les changements** : Résumer les décisions techniques dans `memory/gpu_unified_memory.md`.
+- **Leçons → Règles** : Chaque bug récurrent devient une règle dans ce fichier ou dans les leçons.

CONTRIBUTING.md

@@ -23,8 +23,9 @@ TrustOS is `#![no_std]` everywhere with `panic = "abort"`. The following are **n
 
 ```powershell
 cargo build --release -p trustos_kernel
-.\trustos.ps1 build           # kernel + ISO + VM
-.\trustos.ps1 build -NoRun    # kernel + ISO only
+.\scripts\build\build-trustos.ps1              # kernel + ISO + VM
+.\scripts\build\build-trustos.ps1 -NoRun       # kernel + ISO seulement
+.\scripts\trustos-hub.ps1                      # hub — point d'entrée principal
 ```
 
 Linux/macOS:

Cargo.toml

@@ -2,6 +2,7 @@
 resolver = "2"
 members = [
     "kernel",
+    "debugonly",
     "userland/trustos-syscall",
     "userland/init",
     "userland/hello-rust",
@@ -33,5 +34,13 @@ panic = "abort"
 lto = true
 opt-level = "s"
 
+# Fast iteration profile for hardware debug (no LTO, ~10-15s builds)
+# Usage: cargo build --profile release-dev -p trustos_kernel
+[profile.release-dev]
+inherits = "release"
+lto = "thin"
+codegen-units = 16
+incremental = true
+
 [patch.crates-io]
 mbedtls-platform-support = { path = "crates/mbedtls-platform-support" }

README.md

@@ -209,9 +209,10 @@ python scripts/pxe_server.py --tftp-root pxe_tftp --server-ip 10.0.0.1
 ## Build
 
 ```powershell
-cargo build --release -p trustos_kernel    # kernel only
-.\trustos.ps1 build                         # build + ISO + VM
-.\trustos.ps1 build -NoRun                  # build + ISO only
+cargo build --release -p trustos_kernel        # kernel seul
+.\scripts\build\build-trustos.ps1              # build + ISO + VM
+.\scripts\build\build-trustos.ps1 -NoRun       # build + ISO seulement
+.\scripts\trustos-hub.ps1                      # hub — point d'entrée principal
 ```
 
 Requires Rust nightly with `rust-src` and `llvm-tools-preview`, target `x86_64-unknown-none`. See [`CONTRIBUTING.md`](CONTRIBUTING.md).

docs/TRUSTOS_COMPLETE_COMMAND_REFERENCE.md

@@ -213,6 +213,38 @@ All output dual-mirrored to screen + serial (115200 8N1).
 - **USB**: xHCI host controller
 - **PCI**: Full bus enumeration with vendor/device IDs
 
+### ELECTRO — Power & Thermal Dashboard
+
+Comprehensive electrical power monitoring (~90 metrics): CPU RAPL full decomposition,
+motherboard voltage rails via SuperIO, GPU thermal/power via AMD SMU, battery/EC,
+C-state residency, live dashboard.
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `electro` | `electro all`, `elec`, `power` | Full system snapshot (all available metrics) |
+| `electro cpu` | `electro power` | CPU: RAPL domains (PKG/PP0/PP1/DRAM), VID voltage, frequency, C-states, thermal |
+| `electro gpu` | | GPU: temperature, fan duty, activity, power via AMD SMU mailbox |
+| `electro rails` | `electro voltages` | Motherboard voltage rails via SuperIO (VCore, +12V, +5V, +3.3V, VBAT) |
+| `electro rails --raw` | | Raw SuperIO HWM register values (for calibration) |
+| `electro fans` | | All detected fans (SuperIO + EC + GPU) |
+| `electro battery` | `electro bat` | Battery & EC sensors (laptop only, ThinkPad EC support) |
+| `electro thermal` | `electro temp` | Combined thermal view (CPU + GPU + EC) |
+| `electro live` | | Real-time dashboard, 2s refresh, press 'q' to quit (2 min max) |
+| `electro alerts` | `electro alert` | Show only out-of-threshold metrics (PROCHOT, critical temp, etc.) |
+| `electro json` | | Machine-parseable JSON output for remote parsing |
+| `electro help` | | Show all electro subcommands |
+
+**CPU Metrics**: Core temp, package temp, TjMax, PROCHOT status, current/target frequency,
+turbo ratios (1–4 core), VCore (VID), RAPL power (PKG, PP0 cores, PP1 iGPU, DRAM),
+PL1/PL2 limits, TDP, C-state residency (C3/C6/C7 core + C2/C3/C6/C7 package),
+Energy Performance Bias.
+
+**SuperIO Chips Detected**: ITE IT8728F/IT8686E/IT8625E, Nuvoton NCT6776/NCT6793D/NCT6798D.
+Probes ports 0x2E/0x4E with ITE + Winbond config sequences.
+
+**GPU Metrics** (AMD Polaris): Edge temperature, fan duty %, GRBM activity,
+SMU average power (milliwatts).
+
 ---
 
 ## 6. DISK & STORAGE COMMANDS
@@ -490,6 +522,16 @@ Alias: `pkg` works instead of `trustpkg`
 | `gpu info` | Show GPU info (vendor, VRAM, features) |
 | `gpu dcn` | Display engine (DCN) status |
 | `gpu modes` | Display connector modes |
+| `gpu pci` | Raw PCI probe (even if GPU init failed) |
+| `gpu dump` | Full register dump |
+| `gpu mmio <off> [val]` | Read/write GPU MMIO register (hex offset) |
+| `gpu rom` | Read/check VBIOS ROM header (0xAA55 + ATOM) |
+| `gpu smu status` | SMU mailbox diagnostic (FW, clocks, running) |
+| `gpu smu regs` | Dump raw SMU v7 mailbox registers |
+| `gpu smu send <msg> [param]` | Send raw SMU message (hex IDs) |
+| `gpu sdma <step>` | SDMA staged init |
+| `gpu heap` | Heap free/used diagnostic |
+| `gpu regscan <sub>` | Register scanner (bitflip/anomaly/hidden) |
 | `gpuexec <agent> [N]` | Dispatch RDNA compute agent on GPU CUs |
 
 GPU Agents: `incr`, `memfill`, `memcopy`

iso_root/EFI/BOOT/BOOTIA32.EFI

@@ -121,14 +121,15 @@ browser = []
 # EDITION PROFILES — composable presets for trustos.ps1 -Edition X
 # ════════════════════════════════════════════════════════════════════════════
 
-## TrustStrudel — Bare-metal live coding (Tidal/Strudel clone)
-## Minimal boot: HDA audio + synth + network + shell. No JARVIS/GPU/extras.
-strudel = ["netstack"]
+## TrustStrudel — Bare-metal live coding (Tidal/Strudel clone).
+## Enables the `audio::strudel_dsl` chained-method DSL + `live dsl` shell op.
+## Pure logic, no extra deps; bundled into trustos-audio / trustos-audio-full.
+strudel = []
 
-## TrustOS Audio Edition — DAW + audio + GUI, no JARVIS/GPU/extras.
+## TrustOS Audio Edition — DAW + audio + GUI + live coding, no JARVIS/GPU/extras.
 ## Slim by default: no embedded samples (loads WAVs from VFS instead).
 ## Add `daw-samples` for the full ~29 MB built-in demo track.
-trustos-audio = ["hires-logo", "daw", "gui-stack"]
+trustos-audio = ["hires-logo", "daw", "strudel", "gui-stack"]
 trustos-audio-full = ["trustos-audio", "daw-samples"]
 
 ## TrustOS Server Edition — headless: net + storage + security tools