Kind: function.
Walk a processors/<PART>/<VARIANT>/ tree
and return a JSON-friendly dict describing it. The
returned shape includes:
part, variant, rootguide — short ordered list of steps for an agent
reading the tree (variant-aware).
key_files — logical name → relative path for the
spine files (<PART>.xml,
common/cores_info.xml,
common/sdk_features.xml,
sdk/sdk_components.xml,
processor.properties,
module_clocks.xml).
optional_sections — presence flags for
security/, dcdx/, ddr/,
mem_validation/.
package_variants — per-package SKU directories with
their sibling <VARIANT>.xml manifests.
codegen — scripts root, category list, and
Zephyr-DT entry points (when the variant ships them).
xml_namespaces — every distinct xmlns
URI seen in the tree, with parsed family + version and a short
label for recognized families
(registers, clocks,
pinsModel, part_number,
processor, dcd). There are no public
XSDs; this is identifier-only.
notes — caveats about the schema universe and the
canonical ksdk2_0 binder.
Pure on-disk read; does not fetch. Pass a path obtained from
fetch(), details().root, or a mirrored
tree under --output.