Developer tools #
Run Scripts/parcel-dev.sh COMMAND [ARGUMENTS]. Both commit hooks use this wrapper.
It builds parcel-dev in release once, then runs the cached executable. The cache
keys source contents, the package manifest/resolution, wrapper, and compiler/SDK
selection—not modification dates. Implicit, explicit, and symlinked selections of
the same SDK share the cache. Identical rewrites and unrelated app edits do not
rebuild it. Concurrent callers share one build; failed builds stop the command
without certifying the old executable. PARCEL_DEV_BINARY selects an already-built
executable for isolated fixtures. PARCEL_DEV_ROOT is the caller's checkout, not
the binary's.
The executable lives in the main package without app dependencies or resources.
That keeps one test plan and reuses product settings and version validation.
The release tool uses .build/parcel-dev as its own SwiftPM cache. Script fixtures
can therefore bootstrap it while their parent test process holds the app cache's
lock. The catalog plugin has an explicit tool dependency; native bundle planning
uses the bundle script's prebuilt executable. The warm staged name check executes
the binary, not SwiftPM. Casks use the pinned Ruby syntax checker; workflows use a
small strict parser rather than another dependency.
| Former helper | Command or test replacement |
|---|---|
| name-guard | name-guard check / name-guard generate |
| launch-feed | launch-feed |
| launch-policy | policy-* |
| release-order | release-order |
| update-metadata | update-metadata |
| generate-update-key | generate-update-key |
| check-workflows | check-workflows |
| check-binaries | check-binaries |
| check-ruby-syntax | check-ruby-syntax |
| install-tools | install-tools |
| install-bundle | install-bundle |
| strip-binary-paths | strip-binary-paths |
| bench-ab-summary | bench-ab-summary |
| bench-identity | bench-identity |
| idle-summary | idle-summary |
| quiet-readings | quiet-readings |
| trace-summary | trace-summary |
| tests/workflows | WorkflowTests / WorkflowContractTests |
| tests/launch-interactive | InteractiveLaunchTests |
| tests/measurement-tests | Measurement*Tests |
Native implementations are in Sources/ParcelDev. Pure and fixture-driven tests
are in Tests/ParcelDevTests; naming-policy oracles remain in
Scripts/tests/NameGuardTests. mise run test:scripts runs them and every shell
fixture. Unit and live-window lanes stay separate.
Update keys use CryptoKit. Explicit keychain access uses the system security
frontend with secret input on stdin, never process arguments. It verifies the
stored seed and never changes the keychain search list or default keychain.