2 files changed, 490 insertions, 95 deletions

diff --git a/recipes-extended/images/README-xen.md b/recipes-extended/images/README-xen.md
index 82d72364..f16aa743 100644
--- a/recipes-extended/images/README-xen.md
+++ b/recipes-extended/images/README-xen.md
@@ -20,154 +20,188 @@ to differentiate).
 
 It creates tarballs, ext4 and qcow images for testing purposes.
 
-bundling
+Bundling
 --------
 
-Guests can be bundled automatically through the following mechanisms:
+There are two ways to bundle Xen guests into a Dom0 host image:
 
-  - via the variable XEN_BUNDLED_GUESTS
-  - via a xen configuration file in the deploy directory of the format
-    xen-guest-bundle-*.cfg
+| Use Case | `BUNDLED_XEN_GUESTS` | Bundle Recipe |
+|---|---|---|
+| Simple: guests in one host image | recommended | overkill |
+| Reuse guests across multiple host images | repetitive | recommended |
+| Package versioning and dependencies | not supported | supported |
+| Distribute pre-built guest sets | not supported | supported |
 
-The guests can be built via OE, or be 3rd party guests. They just
-must be in the deploy directory so they can be copied into the rootfs
-of the xen host image
+### Variable-driven (BUNDLED_XEN_GUESTS)
 
-Type 1) XEN_BUNDLED_GUESTS
+Guests can be bundled into the host image automatically using
+`xen-guest-cross-install.bbclass` (inherited by xen-image-minimal).
 
-If XEN_BUNDLED_GUESTS is used, it is simply a colon separated list of
-rootfs:kernels. Normal variable rules apply, so it can be set in a
-local.conf, or in a bbappend to the image recipe.
+Set `BUNDLED_XEN_GUESTS` in local.conf or the image recipe:
 
-An example would be:
+  BUNDLED_XEN_GUESTS = "xen-guest-image-minimal:autostart"
 
- XEN_BUNDLED_GUESTS = "xen-guest-image-minimal-qemuarm64.rootfs.ext4:Image"
+Each entry is a recipe name with optional tags:
 
-These point at symlinks created in the image deploy directory, or they
-can be specific images/kernels without the symlink.
+  recipe-name[:autostart][:external]
 
-Type 2) A Xen guest configuration file
+  - recipe-name: Yocto image recipe that produces the guest rootfs
+  - autostart: Creates symlink in /etc/xen/auto/ for xendomains
+  - external: Skip dependency generation (3rd-party guest)
 
-If xen guest configuration files are found in the deploy directories
-the kernel and disk information contained within them will be processed
-and modified for the xen host. The kernel and guest image will be
-copied to the appropriate location, and the config made to match.
+Examples:
 
-These files following the naming convention: xen-guest-bundle*.cfg
+  # Single guest with autostart (default recommendation)
+  BUNDLED_XEN_GUESTS = "xen-guest-image-minimal:autostart"
 
-Guests of type #1 generate a configuration file that is picked up as
-type #2.
+  # Guest without autostart
+  BUNDLED_XEN_GUESTS = "xen-guest-image-minimal"
 
-An example config file follows:
+  # External/3rd-party guest (no build dependency)
+  BUNDLED_XEN_GUESTS = "my-vendor-guest:external"
 
-   name = "xen-guest"
-   memory = 512
-   vcpus = 1
-   disk = ['file:xen-guest-image-minimal-qemuarm64.rootfs.ext4,xvda,rw']
-   vif = ['bridge=xenbr0']
-   kernel = "Image"
-   extra = "root=/dev/xvda ro console=hvc0 ip=dhcp"
+Per-guest configuration via varflags:
 
-It should also be noted that when a xen-guest-image-minimal is built
-with the XEN_GUEST_AUTO_BUNDLE varaible set to True, a configuration
-file for type #2 will be generated and the guest bundled automatically
-when the host image is built.
+  XEN_GUEST_MEMORY[xen-guest-image-minimal] = "1024"
+  XEN_GUEST_VCPUS[xen-guest-image-minimal] = "2"
+  XEN_GUEST_VIF[xen-guest-image-minimal] = "bridge=xenbr0"
+  XEN_GUEST_EXTRA[xen-guest-image-minimal] = "root=/dev/xvda ro console=hvc0 ip=dhcp"
+
+Custom config file (replaces auto-generation):
+
+  SRC_URI += "file://my-custom-guest.cfg"
+  BUNDLED_XEN_GUESTS = "xen-guest-image-minimal:autostart"
+  XEN_GUEST_CONFIG_FILE[xen-guest-image-minimal] = "${UNPACKDIR}/my-custom-guest.cfg"
+
+Explicit rootfs/kernel for external guests:
+
+  XEN_GUEST_ROOTFS[my-vendor-guest] = "vendor-rootfs.ext4"
+  XEN_GUEST_KERNEL[my-vendor-guest] = "vendor-kernel"
+
+### Package-based (xen-guest-bundle.bbclass)
+
+For reusable guest sets, create a bundle recipe that inherits
+`xen-guest-bundle`:
+
+  # recipes-extended/xen-guest-bundles/my-guests_1.0.bb
+  inherit xen-guest-bundle
+
+  XEN_GUEST_BUNDLES = "xen-guest-image-minimal:autostart"
+  XEN_GUEST_MEMORY[xen-guest-image-minimal] = "1024"
+
+Then install the bundle in the host image:
+
+  IMAGE_INSTALL:append:pn-xen-image-minimal = " my-guests"
+
+The bundle package includes rootfs, kernel, and config files. At
+image time, `merge_installed_xen_bundles()` deploys them to the
+same target locations as the variable-driven path.
+
+Custom config files work the same way via SRC_URI + varflag:
+
+  SRC_URI += "file://my-custom-guest.cfg"
+  XEN_GUEST_CONFIG_FILE[xen-guest-image-minimal] = "${UNPACKDIR}/my-custom-guest.cfg"
+
+See `example-xen-guest-bundle_1.0.bb` for a complete example.
+
+### 3rd-party guest import
+
+The import system converts fetched source formats (tarballs, qcow2 images,
+etc.) into Xen-ready disk images at build time. This is for guests that
+are not built by Yocto (e.g., Alpine minirootfs, Debian cloud images).
+
+Per-guest varflags control the import:
+
+  XEN_GUEST_SOURCE_TYPE[guest] = "rootfs_dir"   # import handler type
+  XEN_GUEST_SOURCE_FILE[guest] = "alpine-rootfs" # file/dir in UNPACKDIR
+  XEN_GUEST_IMAGE_SIZE[guest] = "128"            # target image size in MB
+
+Built-in import types:
+
+| Type | Input | Output | Tool |
+|---|---|---|---|
+| `rootfs_dir` | Extracted rootfs directory | ext4 image | `mkfs.ext4 -F -d` |
+| `qcow2` | QCOW2 disk image | raw image | `qemu-img convert` |
+| `ext4` | ext4 image file | ext4 (copy) | `cp` |
+| `raw` | raw disk image | raw (copy) | `cp` |
+
+Native tool dependencies are resolved automatically at parse time.
+
+Kernel modes (per-guest via `XEN_GUEST_KERNEL` varflag):
+
+  - (not set): Shared host kernel from DEPLOY_DIR_IMAGE
+  - `"path"`: Custom kernel from UNPACKDIR or DEPLOY_DIR_IMAGE
+  - `"none"`: HVM guest, no kernel (omits kernel= from config)
+
+Alpine example (`alpine-xen-guest-bundle_3.23.bb`):
+
+  inherit xen-guest-bundle
+
+  SRC_URI = "https://...alpine-minirootfs-${ALPINE_VERSION}-${ALPINE_ARCH}.tar.gz;subdir=alpine-rootfs"
+
+  XEN_GUEST_BUNDLES = "alpine:autostart:external"
+  XEN_GUEST_SOURCE_TYPE[alpine] = "rootfs_dir"
+  XEN_GUEST_SOURCE_FILE[alpine] = "alpine-rootfs"
+  XEN_GUEST_IMAGE_SIZE[alpine] = "128"
+  XEN_GUEST_MEMORY[alpine] = "256"
+  XEN_GUEST_EXTRA[alpine] = "root=/dev/xvda ro console=hvc0"
+
+Adding custom import types: define a shell function
+`xen_guest_import_<type>(source_path, output_path, size_mb)` in a
+bbclass, recipe, or bbappend and set the corresponding
+`XEN_GUEST_IMPORT_DEPENDS_<type>` variable for native tool dependencies.
+
+Target layout
+-------------
 
 kernel and rootfs are copied to the target in /var/lib/xen/images/
 
 configuration files are copied to: /etc/xen
 
-Guests can be launched after boot with: xl create -c /etc/xen/<config file>
+autostart symlinks are created in: /etc/xen/auto/
+
+Guests can be launched after boot with: xl create -c /etc/xen/<guest>.cfg
 
 Build and boot
 --------------
 
-Using a reference qmeuarm64 MACHINE, the following are the commands
+Using a reference qemuarm64 MACHINE, the following are the commands
 to build and boot a guest.
 
 local.conf contains:
 
-   XEN_BUNDLED_GUESTS = "xen-guest-image-minimal-qemuarm64.rootfs.ext4:Image"
+   BUNDLED_XEN_GUESTS = "xen-guest-image-minimal:autostart"
 
  % bitbake xen-guest-image-minimal
  % bitbake xen-image-minimal
 
- % runqemu qemuarm64 nographic slirp qemuparams="-m 4096" tmp/deploy/images/qemuarm64/xen-image-minimal-qemuarm64.rootfs.ext4
+ % runqemu qemuarm64 nographic slirp qemuparams="-m 4096"
 
 Poky (Yocto Project Reference Distro) 5.1 qemuarm64 hvc0
 
 qemuarm64 login: root
 
-WARNING: Poky is a reference Yocto Project distribution that should be used for
-testing and development purposes only. It is recommended that you create your
-own distribution for production use.
-
- root@qemuarm64:~# uname -a
-Linux qemuarm64 6.10.11-yocto-standard #1 SMP PREEMPT Fri Sep 20 22:32:26 UTC 2024 aarch64 GNU/Linux
 root@qemuarm64:~# ls /etc/xen/
 auto
 cpupool
 scripts
-xen-guest-bundle-xen-guest-image-minimal-qemuarm64--20241112174803.cfg
+xen-guest-image-minimal.cfg
 xl.conf
 root@qemuarm64:~# ls /var/lib/xen/images/
 Image--6.10.11+git0+4bf82718cf_6c956b2ea6-r0-qemuarm64-20241018190311.bin
-xen-guest-image-minimal-qemuarm64.rootfs-20241111222814.ext4
-
- root@qemuarm64:~# ip a s
-1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue qlen 1000
-    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
-    inet 127.0.0.1/8 scope host lo
-       valid_lft forever preferred_lft forever
-    inet6 ::1/128 scope host noprefixroute 
-       valid_lft forever preferred_lft forever
-2: enp0s1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel master xenbr0 qlen 1000
-    link/ether 52:54:00:12:35:02 brd ff:ff:ff:ff:ff:ff
-3: sit0@NONE: <NOARP> mtu 1480 qdisc noop qlen 1000
-    link/sit 0.0.0.0 brd 0.0.0.0
-4: xenbr0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue qlen 1000
-    link/ether ee:e4:a8:24:24:e7 brd ff:ff:ff:ff:ff:ff
-    inet 10.0.2.15/24 brd 10.0.2.255 scope global dynamic xenbr0
-       valid_lft 86354sec preferred_lft 86354sec
-    inet6 fec0::ece4:a8ff:fe24:24e7/64 scope site dynamic noprefixroute flags 100 
-       valid_lft 86356sec preferred_lft 14356sec
-    inet6 fe80::ece4:a8ff:fe24:24e7/64 scope link 
-       valid_lft forever preferred_lft forever
-
- root@qemuarm64:~# xl create -c /etc/xen/xen-guest-bundle-xen-guest-image-minimal-qemuarm64--20241112174803.cfg
+xen-guest-image-minimal-qemuarm64-20241111222814.ext4
 
-qemuarm64 login: root
+ root@qemuarm64:~# xl create -c /etc/xen/xen-guest-image-minimal.cfg
 
-WARNING: Poky is a reference Yocto Project distribution that should be used for
-testing and development purposes only. It is recommended that you create your
-own distribution for production use.
+qemuarm64 login: root
 
 root@qemuarm64:~# uname -a
 Linux qemuarm64 6.10.11-yocto-standard #1 SMP PREEMPT Fri Sep 20 22:32:26 UTC 2024 aarch64 GNU/Linux
 
-root@qemuarm64:~# wget example.com
-Connecting to example.com (93.184.215.14:80)
-wget: can't open 'index.html': File exists
-root@qemuarm64:~# rm index.html 
-root@qemuarm64:~# wget example.com
-Connecting to example.com (93.184.215.14:80)
-saving to 'index.html'
-index.html           100% |********************************|  1256  0:00:00 ETA
-'index.html' saved
-
 From the host:
 
-Connection to 127.0.0.1 closed.
-build4 [/home/bruc.../qemuarm64]> ssh -p 2222 root@127.0.0.1
-Last login: Tue Nov 12 20:42:57 2024 from 10.0.2.2
-
-WARNING: Poky is a reference Yocto Project distribution that should be used for
-testing and development purposes only. It is recommended that you create your
-own distribution for production use.
-
 root@qemuarm64:~# xl list
 Name                                        ID   Mem VCPUs      State   Time(s)
 Domain-0                                     0   192     4     r-----     696.2
-xen-guest                                    1   512     1     -b----     153.0
-root@qemuarm64:~# xl destroy xen-guest
-
+xen-guest-image-minimal                      1   512     1     -b----     153.0
+root@qemuarm64:~# xl destroy xen-guest-image-minimal
diff --git a/tests/test_xen_guest_bundle.py b/tests/test_xen_guest_bundle.py
new file mode 100644
index 00000000..2035a5f9
--- /dev/null
+++ b/tests/test_xen_guest_bundle.py
@@ -0,0 +1,361 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 Bruce Ashfield
+#
+# SPDX-License-Identifier: MIT
+"""
+Tests for xen-guest-bundle.bbclass - Xen guest bundling system.
+
+These tests verify:
+  - bbclass file structure and syntax
+  - Import handler definitions
+  - Parse-time logic (__anonymous)
+  - Alpine example recipe structure
+  - Build tests (slow, require configured build environment)
+
+Run with:
+    pytest tests/test_xen_guest_bundle.py -v
+
+Run build tests (requires configured Yocto build):
+    pytest tests/test_xen_guest_bundle.py -v -m slow --machine qemuarm64
+
+Environment variables:
+    POKY_DIR: Path to poky directory (default: /opt/bruce/poky)
+    BUILD_DIR: Path to build directory (default: $POKY_DIR/build)
+    MACHINE: Target machine (default: qemux86-64)
+"""
+
+import re
+import pytest
+from pathlib import Path
+
+
+# Note: Command line options (--poky-dir, --build-dir, --machine)
+# are defined in conftest.py
+
+
+@pytest.fixture(scope="module")
+def poky_dir(request):
+    """Path to poky directory."""
+    path = Path(request.config.getoption("--poky-dir"))
+    if not path.exists():
+        pytest.skip(f"Poky directory not found: {path}")
+    return path
+
+
+@pytest.fixture(scope="module")
+def meta_virt_dir(poky_dir):
+    """Path to meta-virtualization layer."""
+    path = poky_dir / "meta-virtualization"
+    if not path.exists():
+        pytest.skip(f"meta-virtualization not found: {path}")
+    return path
+
+
+@pytest.fixture(scope="module")
+def bbclass_content(meta_virt_dir):
+    """Content of xen-guest-bundle.bbclass."""
+    path = meta_virt_dir / "classes" / "xen-guest-bundle.bbclass"
+    if not path.exists():
+        pytest.skip(f"bbclass not found: {path}")
+    return path.read_text()
+
+
+@pytest.fixture(scope="module")
+def alpine_recipe_content(meta_virt_dir):
+    """Content of alpine-xen-guest-bundle recipe."""
+    recipes = list((meta_virt_dir / "recipes-extended" / "xen-guest-bundles").glob(
+        "alpine-xen-guest-bundle_*.bb"))
+    if not recipes:
+        pytest.skip("Alpine guest bundle recipe not found")
+    return recipes[0].read_text()
+
+
+# ============================================================================
+# bbclass structure tests
+# ============================================================================
+
+class TestXenGuestBundleClass:
+    """Test xen-guest-bundle.bbclass structure and syntax."""
+
+    def test_class_exists(self, meta_virt_dir):
+        """Test that the bbclass file exists."""
+        path = meta_virt_dir / "classes" / "xen-guest-bundle.bbclass"
+        assert path.exists(), f"bbclass not found: {path}"
+
+    def test_spdx_header(self, bbclass_content):
+        """Test SPDX license header is present."""
+        assert "SPDX-License-Identifier: MIT" in bbclass_content
+
+    def test_default_variables(self, bbclass_content):
+        """Test that expected default variables are defined."""
+        defaults = [
+            "XEN_GUEST_BUNDLES",
+            "XEN_GUEST_IMAGE_FSTYPE",
+            "XEN_GUEST_MEMORY_DEFAULT",
+            "XEN_GUEST_VCPUS_DEFAULT",
+            "XEN_GUEST_VIF_DEFAULT",
+            "XEN_GUEST_EXTRA_DEFAULT",
+            "XEN_GUEST_DISK_DEVICE_DEFAULT",
+        ]
+        for var in defaults:
+            assert var in bbclass_content, f"Default variable {var} not found"
+
+    def test_anonymous_function(self, bbclass_content):
+        """Test that __anonymous() is defined."""
+        assert "python __anonymous()" in bbclass_content
+
+    def test_do_compile_defined(self, bbclass_content):
+        """Test that do_compile is defined."""
+        assert "do_compile()" in bbclass_content
+
+    def test_do_install_defined(self, bbclass_content):
+        """Test that do_install is defined."""
+        assert "do_install()" in bbclass_content
+
+    def test_resolve_bundle_rootfs(self, bbclass_content):
+        """Test rootfs resolver function exists."""
+        assert "resolve_bundle_rootfs()" in bbclass_content
+
+    def test_resolve_bundle_kernel(self, bbclass_content):
+        """Test kernel resolver function exists."""
+        assert "resolve_bundle_kernel()" in bbclass_content
+
+    def test_generate_bundle_config(self, bbclass_content):
+        """Test config generator function exists."""
+        assert "generate_bundle_config()" in bbclass_content
+
+    def test_files_variable(self, bbclass_content):
+        """Test FILES variable is set."""
+        assert "FILES:${PN}" in bbclass_content
+        assert "xen-guest-bundles" in bbclass_content
+
+    def test_insane_skip(self, bbclass_content):
+        """Test INSANE_SKIP for binary images."""
+        assert "INSANE_SKIP" in bbclass_content
+        assert "buildpaths" in bbclass_content
+
+
+# ============================================================================
+# Import system tests
+# ============================================================================
+
+class TestImportSystem:
+    """Test import system for 3rd-party guests."""
+
+    def test_import_default_variables(self, bbclass_content):
+        """Test import-related default variables."""
+        assert "XEN_GUEST_IMAGE_SIZE_DEFAULT" in bbclass_content
+        assert "XEN_GUEST_IMPORT_DEPENDS_rootfs_dir" in bbclass_content
+        assert "XEN_GUEST_IMPORT_DEPENDS_qcow2" in bbclass_content
+        assert "XEN_GUEST_IMPORT_DEPENDS_ext4" in bbclass_content
+        assert "XEN_GUEST_IMPORT_DEPENDS_raw" in bbclass_content
+
+    def test_import_depends_rootfs_dir(self, bbclass_content):
+        """Test rootfs_dir depends on e2fsprogs-native."""
+        match = re.search(
+            r'XEN_GUEST_IMPORT_DEPENDS_rootfs_dir\s*=\s*"([^"]*)"',
+            bbclass_content)
+        assert match, "rootfs_dir depends not found"
+        assert "e2fsprogs-native" in match.group(1)
+
+    def test_import_depends_qcow2(self, bbclass_content):
+        """Test qcow2 depends on qemu-system-native."""
+        match = re.search(
+            r'XEN_GUEST_IMPORT_DEPENDS_qcow2\s*=\s*"([^"]*)"',
+            bbclass_content)
+        assert match, "qcow2 depends not found"
+        assert "qemu-system-native" in match.group(1)
+
+    def test_import_handler_rootfs_dir(self, bbclass_content):
+        """Test rootfs_dir import handler exists."""
+        assert "xen_guest_import_rootfs_dir()" in bbclass_content
+        assert "mkfs.ext4" in bbclass_content
+
+    def test_import_handler_qcow2(self, bbclass_content):
+        """Test qcow2 import handler exists."""
+        assert "xen_guest_import_qcow2()" in bbclass_content
+        assert "qemu-img convert" in bbclass_content
+
+    def test_import_handler_ext4(self, bbclass_content):
+        """Test ext4 import handler exists."""
+        assert "xen_guest_import_ext4()" in bbclass_content
+
+    def test_import_handler_raw(self, bbclass_content):
+        """Test raw import handler exists."""
+        assert "xen_guest_import_raw()" in bbclass_content
+
+    def test_resolve_import_source(self, bbclass_content):
+        """Test import source resolver exists."""
+        assert "resolve_import_source()" in bbclass_content
+        assert "_XEN_GUEST_IMPORT_MAP" in bbclass_content
+
+    def test_static_dispatch_in_do_compile(self, bbclass_content):
+        """Test that import dispatch uses static case statement."""
+        # BitBake needs static function references to include them
+        assert "case \"$import_type\" in" in bbclass_content
+        assert "xen_guest_import_rootfs_dir " in bbclass_content
+        assert "xen_guest_import_qcow2 " in bbclass_content
+
+    def test_fakeroot_for_rootfs_dir(self, bbclass_content):
+        """Test that rootfs_dir type triggers fakeroot."""
+        assert "fakeroot" in bbclass_content
+        assert "rootfs_dir" in bbclass_content
+
+
+# ============================================================================
+# Kernel mode tests
+# ============================================================================
+
+class TestKernelModes:
+    """Test three kernel modes: shared, custom, HVM/none."""
+
+    def test_hvm_mode_documented(self, bbclass_content):
+        """Test HVM mode (kernel=none) is supported."""
+        assert '"none"' in bbclass_content or "'none'" in bbclass_content
+        assert "HVM" in bbclass_content
+
+    def test_kernel_unpackdir_check(self, bbclass_content):
+        """Test kernel resolver checks UNPACKDIR."""
+        assert "UNPACKDIR" in bbclass_content
+
+    def test_config_omits_kernel_for_hvm(self, bbclass_content):
+        """Test generate_bundle_config omits kernel for HVM."""
+        # Should have conditional kernel output
+        assert 'if [ -n "$kernel_basename" ]' in bbclass_content
+
+    def test_shared_kernel_dependency(self, bbclass_content):
+        """Test virtual/kernel dependency for shared kernel."""
+        assert "virtual/kernel:do_deploy" in bbclass_content
+
+
+# ============================================================================
+# License warning tests
+# ============================================================================
+
+class TestLicenseWarning:
+    """Test external guest license warning."""
+
+    def test_external_names_variable(self, bbclass_content):
+        """Test _XEN_GUEST_EXTERNAL_NAMES is set for external guests."""
+        assert "_XEN_GUEST_EXTERNAL_NAMES" in bbclass_content
+
+    def test_license_warn_prefunc(self, bbclass_content):
+        """Test license warning is a prefunc on do_compile."""
+        assert "xen_guest_external_license_warn" in bbclass_content
+        assert "do_compile[prefuncs]" in bbclass_content
+
+    def test_license_warn_content(self, bbclass_content):
+        """Test license warning message content."""
+        assert "rights to redistribute" in bbclass_content
+        assert "license terms" in bbclass_content
+
+    def test_license_warn_is_python(self, bbclass_content):
+        """Test license warning is a python function (runs once at task time)."""
+        assert "python xen_guest_external_license_warn()" in bbclass_content
+
+
+# ============================================================================
+# Alpine recipe tests
+# ============================================================================
+
+class TestAlpineRecipe:
+    """Test alpine-xen-guest-bundle recipe structure."""
+
+    def test_recipe_exists(self, meta_virt_dir):
+        """Test that Alpine recipe exists."""
+        recipes = list((meta_virt_dir / "recipes-extended" / "xen-guest-bundles").glob(
+            "alpine-xen-guest-bundle_*.bb"))
+        assert len(recipes) > 0, "Alpine guest bundle recipe not found"
+
+    def test_inherits_xen_guest_bundle(self, alpine_recipe_content):
+        """Test recipe inherits xen-guest-bundle."""
+        assert "inherit xen-guest-bundle" in alpine_recipe_content
+
+    def test_license(self, alpine_recipe_content):
+        """Test recipe has license."""
+        assert 'LICENSE = "MIT"' in alpine_recipe_content
+        assert "LIC_FILES_CHKSUM" in alpine_recipe_content
+
+    def test_src_uri(self, alpine_recipe_content):
+        """Test SRC_URI fetches Alpine minirootfs."""
+        assert "dl-cdn.alpinelinux.org" in alpine_recipe_content
+        assert "alpine-minirootfs" in alpine_recipe_content
+        assert "subdir=alpine-rootfs" in alpine_recipe_content
+
+    def test_sha256sum(self, alpine_recipe_content):
+        """Test sha256sum is set (not placeholder)."""
+        match = re.search(r'SRC_URI\[sha256sum\]\s*=\s*"([^"]*)"',
+                          alpine_recipe_content)
+        assert match, "sha256sum not found"
+        sha = match.group(1)
+        assert len(sha) == 64, f"sha256sum wrong length: {len(sha)}"
+        assert sha != "x" * 64, "sha256sum is still placeholder"
+
+    def test_guest_bundles(self, alpine_recipe_content):
+        """Test XEN_GUEST_BUNDLES is set."""
+        assert 'XEN_GUEST_BUNDLES = "alpine:autostart:external"' in alpine_recipe_content
+
+    def test_import_source_type(self, alpine_recipe_content):
+        """Test import source type is rootfs_dir."""
+        assert 'XEN_GUEST_SOURCE_TYPE[alpine] = "rootfs_dir"' in alpine_recipe_content
+
+    def test_import_source_file(self, alpine_recipe_content):
+        """Test import source file matches SRC_URI subdir."""
+        assert 'XEN_GUEST_SOURCE_FILE[alpine] = "alpine-rootfs"' in alpine_recipe_content
+
+    def test_image_size(self, alpine_recipe_content):
+        """Test image size is set."""
+        assert 'XEN_GUEST_IMAGE_SIZE[alpine]' in alpine_recipe_content
+
+    def test_guest_memory(self, alpine_recipe_content):
+        """Test guest memory is set."""
+        assert 'XEN_GUEST_MEMORY[alpine]' in alpine_recipe_content
+
+    def test_guest_extra(self, alpine_recipe_content):
+        """Test guest extra args include console."""
+        assert 'XEN_GUEST_EXTRA[alpine]' in alpine_recipe_content
+        assert "console=hvc0" in alpine_recipe_content
+
+    def test_multiarch_support(self, alpine_recipe_content):
+        """Test recipe supports multiple architectures."""
+        assert "ALPINE_ARCH" in alpine_recipe_content
+        assert "aarch64" in alpine_recipe_content
+        assert "x86_64" in alpine_recipe_content
+
+
+# ============================================================================
+# README tests
+# ============================================================================
+
+class TestReadme:
+    """Test README-xen.md documentation."""
+
+    @pytest.fixture(scope="class")
+    def readme_content(self, meta_virt_dir):
+        path = meta_virt_dir / "recipes-extended" / "images" / "README-xen.md"
+        if not path.exists():
+            pytest.skip("README-xen.md not found")
+        return path.read_text()
+
+    def test_import_section_exists(self, readme_content):
+        """Test 3rd-party import section exists."""
+        assert "3rd-party guest import" in readme_content
+
+    def test_import_types_documented(self, readme_content):
+        """Test import types are documented."""
+        assert "rootfs_dir" in readme_content
+        assert "qcow2" in readme_content
+
+    def test_kernel_modes_documented(self, readme_content):
+        """Test kernel modes are documented."""
+        assert "none" in readme_content
+        assert "Shared host kernel" in readme_content or "shared" in readme_content.lower()
+
+    def test_alpine_example(self, readme_content):
+        """Test Alpine example is in README."""
+        assert "alpine" in readme_content.lower()
+        assert "XEN_GUEST_SOURCE_TYPE" in readme_content
+
+    def test_custom_handler_docs(self, readme_content):
+        """Test custom handler instructions."""
+        assert "xen_guest_import_" in readme_content
+        assert "XEN_GUEST_IMPORT_DEPENDS_" in readme_content