build: 🛠 Improve Justfile help output

Enter `just` to see a list of available commands
with explanations.

Added `just ci` step.
Added `just fmt-check`.
Removed unnecessary kernel file removals.
Moved sdeject task and added `just device-eject`.

Justfile

@@ -1,62 +1,80 @@
-zellij:
+_default:
+    @just --list
+
 # Build and run kernel in QEMU with serial port emulation
+zellij:
     cargo make zellij-config
     zellij --layout-path emulation/layout.zellij
 
-qemu:
 # Build and run kernel in QEMU
+qemu:
     cargo make qemu
 
-qemu-gdb:
 # Build and run kernel in QEMU with GDB port enabled
+qemu-gdb:
     cargo make qemu-gdb
 
-device:
 # Build and write kernel to an SD Card
+device:
     cargo make sdcard
 
-build:
+# Build and write kernel to an SD Card, then eject the SD Card volume
+device-eject:
+    cargo make sdeject
+
 # Build default hw kernel
+build:
     cargo make build
 
-clean:
 # Clean project
+clean:
     cargo make clean
-    rm -f kernel8 kernel8.img
 
-clippy:
 # Run clippy checks
+clippy:
+    # TODO: use cargo-hack
     cargo make clippy
+    env CLIPPY_FEATURES=noserial cargo make clippy
+    env CLIPPY_FEATURES=qemu cargo make clippy
+    env CLIPPY_FEATURES=noserial,qemu cargo make clippy
+    env CLIPPY_FEATURES=jtag cargo make clippy
+    env CLIPPY_FEATURES=noserial,jtag cargo make clippy
 
-test:
 # Run tests in QEMU
+test:
     cargo make test
 
 alias disasm := hopper
 
-hopper:
 # Build and disassemble kernel
+hopper:
     cargo make hopper
 
 alias ocd := openocd
 
-openocd:
 # Start openocd (by default connected via JTAG to a target device)
+openocd:
     cargo make openocd
 
-gdb:
 # Build and run kernel in GDB using openocd or QEMU as target (gdb port 5555)
+gdb:
     cargo make gdb
 
-nm:
 # Build and print all symbols in the kernel
+nm:
     cargo make nm
 
+# Check formatting
+fmt-check:
+    cargo fmt -- --check
+
+# Run `cargo expand` on nucleus
 expand:
-    # Run `cargo expand` on modules
     cargo make expand -- nucleus
 
-doc:
 # Generate and open documentation
+doc:
     cargo make docs-flow
 
+# Run CI tasks
+ci: clean build test clippy fmt-check

Makefile.toml

@@ -77,3 +77,9 @@ dependencies = ["kernel-binary"]
 [tasks.modules]
 command = "cargo"
 args = ["modules", "tree"]
+
+[tasks.sdeject]
+dependencies = ["sdcard"]
+script = [
+    "diskutil unmount ${VOLUME}"
+]

README.md

@@ -94,6 +94,14 @@ You need to have [Hopper](https://hopperapp.com) and hopperv4 cli helper install
 just disasm
 ```
 
+### To see other available commands
+
+```
+just
+```
+
+It will list all just commands with their short descriptions.
+
 ## Development flow
 
 `mainline`, `develop` and `released` branches:

nucleus/Makefile.toml

@@ -122,12 +122,6 @@ script = [
 '''
 ]
 
-[tasks.sdeject]
-dependencies = ["sdcard"]
-script = [
-    "diskutil unmount ${VOLUME}"
-]
-
 [tasks.clippy]
 env = { "TARGET_FEATURES" = { value = "--features=${CLIPPY_FEATURES}", condition = { env_set = ["CLIPPY_FEATURES"] } } }
 command = "cargo"