internal/

Package app implements the xkvm processing pipeline.

Package appbundle operates on an extracted *.app bundle: metadata edits (name/version/bundle id/min-OS), plist merging, icon replacement, watch app / extension removal, and mass fakesigning/thinning.

Package artifact collects injectable file types from a directory tree: *.dylib files and *.appex / *.framework / *.bundle directories, following cyan's extract_deb conventions.

Package cli wires the xkvm command line: flag definitions, help text and subcommands (xkvm, xkvm cgen, ...).

Package cyanfile parses and generates .cyan config archives (the cyan/pyzule-rw shareable-patch format: a zip with config.json + inject/ payloads + optional icon.idk / merge.plist / new.entitlements).

Package deb extracts jailbreak tweak packages (.deb) and returns the injectable artifacts (dylibs, frameworks, appex, bundles) that cyan's extract_deb collects.

Package decrypt downloads App Store apps by Apple ID (the ipatool / PancakeStore flow) so they can be injected and sideloaded.

Package device wraps go-ios (github.com/danielpaulus/go-ios) with the xkvm contract: typed errors with remediation text, a deterministic device-resolution policy, and a Handler seam so every operation is testable without hardware.

Package extras embeds the hooking frameworks xkvm auto-injects (CydiaSubstrate, Orion, Cephei, CepheiUI, CepheiPrefs, ElleKit) and the sideload-fix dylibs --patch injects — the same set cyan ships in its extras/ directory.

Package inject implements tweak injection into an extracted app bundle, ported from cyan's MainExecutable.inject(): deb expansion, per-type placement (dylib/framework → Frameworks, appex → PlugIns, other → root), common-dependency fixing (CydiaSubstrate→ElleKit-style paths, Orion, Cephei*), auto-injection of missing hooking frameworks from extras/, and entitlement preservation across the binary edits.

Package ipa handles .ipa/.tipa containers: extraction of the app bundle from a Payload/ archive and repacking with configurable compression.

Package log implements xkvm's console output conventions, mirroring cyan's terminal style: [*] info, [?] warning, [!] error, [<] prompt.

Package patch implements Feather-style togglable compatibility patches applied to an extracted app bundle.

Package plist wraps howett.net/plist for Info.plist-style files: binary and XML decoding, binary encoding (the format real app Info.plists ship in, and the safest default when rewriting), and XML encoding for plists that were authored as XML.

Rootful conversion (rootless deb -> rootful deb), the reverse of both the standard rootless pipeline (rootless-patcher) and the Xina-style pipeline (Xinam1nePatcher — see NOTICE).

Package testutil builds real Mach-O fixtures for xkvm's end-to-end tests: the app main executable and a "tweak" dylib are produced by the actual Go toolchain on the host, then exercised through the native (pure-Go) macho operations.

Art and color helpers for the xkvm TUI.