use oci:// prefix to mark OCI images

Signed-off-by: Benny Zlotnik <bzlotnik@redhat.com>

Author: bennyz

README.md

@@ -118,13 +118,13 @@ fls from-url \
 using the system `fastboot` CLI:
 
 ```bash
-fls fastboot quay.io/org/image:latest
+fls fastboot oci://quay.io/org/image:latest
 ```
 
 Provide explicit partition mappings when the OCI image contains multiple files:
 
 ```bash
-fls fastboot quay.io/org/image:latest \
+fls fastboot oci://quay.io/org/image:latest \
   -t boot_a:boot_a.simg \
   -t system_a:system_a.simg
 ```

src/fls/fastboot.rs

@@ -47,7 +47,8 @@ impl Error for FastbootError {}
 /// Main entry point for fastboot flashing
 ///
 /// Downloads an OCI image and flashes it to a fastboot device via the system fastboot CLI.
-/// The image_ref should be an OCI image reference (e.g., "registry.example.com/my-image:latest")
+/// The image_ref should be an OCI image reference without a scheme
+/// (e.g., "registry.example.com/my-image:latest").
 pub async fn flash_from_fastboot(
     image_ref: &str,
     options: FastbootOptions,

src/main.rs

@@ -84,7 +84,7 @@ enum Commands {
     },
     /// Flash an OCI image to fastboot partitions via USB
     Fastboot {
-        /// OCI image reference to download and flash (e.g., "registry.example.com/my-image:latest")
+        /// OCI image reference to download and flash (must be prefixed with "oci://")
         image_ref: String,
         /// Device serial number (optional, will use first device if not specified)
         #[arg(short = 's', long)]
@@ -301,8 +301,20 @@ async fn main() {
             username,
             password,
         } => {
+            let image_ref_input = image_ref;
+            let image_ref = match image_ref_input.strip_prefix("oci://") {
+                Some(reference) => reference,
+                None => {
+                    eprintln!(
+                        "Error: fastboot expects an OCI image reference prefixed with 'oci://'"
+                    );
+                    eprintln!("  Example: fls fastboot oci://quay.io/org/image:latest");
+                    std::process::exit(1);
+                }
+            };
+
             println!("Fastboot flash command:");
-            println!("  Image: {}", image_ref);
+            println!("  Image: {}", image_ref_input);
             if let Some(ref serial) = serial {
                 println!("  Device serial: {}", serial);
             }
@@ -347,7 +359,7 @@ async fn main() {
                 password,
             };
 
-            match fls::flash_from_fastboot(&image_ref, options).await {
+            match fls::flash_from_fastboot(image_ref, options).await {
                 Ok(_) => {
                     println!("Result: FLASH_COMPLETED");
                     std::process::exit(0);