Files
vphone-cli/Documents
LakrandClaude Opus 5.5 ae5e4531a5 Name every patch {component}-{effect}-{name}
The 117 bundled patch identifiers had grown five naming schemes
(kernel.x, jb.x, kernelcache_jb.x, txm_dev.x, bare names). Each one is now
{component}-{effect}-{name}:

- component: avpbooter, ibss, ibec, llb, txm, kernel, devicetree, dyld,
  preboot, or system-<binary> for a guest binary or file.
- effect: boot when the patch is boot-essential, exp when the standard
  preset leaves it off, cfw otherwise. A catalog test enforces this.
- name: snake_case, no hyphen, so the identifier splits from the right.

Record sites are now always <identifier>.<site>. The underscore-prefix
rule in covers(recordIdentifier:) and in the gate is gone: the new names
contain underscores, so kernel-boot-post_validation would otherwise have
covered kernel-boot-post_validation_unsigned. The 25 records that relied
on it (amfi_trustcache_1, launch_constraints_mov, sandbox_ext_N, ...) now
use a dot.

Old identifiers are not migrated. A VM whose PatchPlan or PatchSelection
names one must be patched again. The bundle becomes 2.2.0 and Launchpad
requires 2.2.0, so it never meets an old identifier from a bundle.

Launchpad's patch table shows Component, Effect and Name columns in place
of Identifier and Patch Set; the set moves to the detail line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 15:20:20 +09:00
..

Documentation

Research notes

Start with the Launchpad quick start. For terminal use, see the one-command VM flow. Version 2.x applies the complete firmware patch set, including the former EXP changes; selectable patch variants are not available. Earlier experiments remain in the research notes as historical context.

Guide Use it for
Host setup Apple Silicon, SIP/AMFI settings, signing and preflight
Create and run a VM Firmware inputs, full or manual pipeline, vphoned, storage and backups
Compatibility Verified firmware pairs and what the checks actually prove
Troubleshooting Launch refusals, restore failures, Home key and app problems

Translations

中文 · 日本語 · 한국어

These pages give a translated overview and quick start. The guides above hold the detailed, current procedures so that a change to the host or firmware flow has one place to update.

For contributors

  • Research index groups the patch and implementation records by subject.
  • Patch inventory is the canonical per-component comparison.
  • xcodebuild -workspace VPhone.xcworkspace -scheme VPhone build produces and validates VPhone.bundle; run each project's test scheme separately.
  • vphone-cli <group> --help shows the CLI command surface.