Install/distribution assets: native package recipes, launch/service assets, notices, manual pages, and platform entrypoints.
| File | Role |
|---|---|
| README.md | Human guide and operating/background notes for this folder; AGENTS.md provides the local navigation map. |
| archive.py | Canonical native release archives using Python's standard library (3.12+). |
| replay_archive_junctions.py | Windows CLI replay for root, nested, and dangling directory junction rejection, plus ordinary archive readback. |
| native-build.md | Document: Native release compilation. |
| native_build.py | Compile native daemon libraries and their binary consumers in observed phases. |
| native_inputs.py | Observed inputs for native daemon libraries and their same-run binary consumers. |
| native_release.py | Build and package the current release on its native host. |
| native_transport.py | Bounded, same-candidate transport of native daemon libraries, never a binary cache. |
| real_startup.py | Install and operate an actual Unix release package on a disposable CI runner. |
| rebuild.py | Retain real assembly observations and compare the complete native output inventory. |
| windows_release.py | Native x86-64 Windows release builds with an explicit, reproducible C compiler. |
| Folder | Role / next waypoint |
|---|---|
| containers/ | Pinned Debian/RPM package-builder container recipes and their dependency/toolchain setup. |
| debian/ | Debian package metadata templates and maintainer lifecycle scripts. |
| distro/ | Distribution package identities, release-input metadata, dependency selection, and preparation notes. |
| keys/ | Checked-in public release-signing key material; private signing credentials are external. |
| licenses/ | Supplemental upstream license notices shipped with source bundles. Preserve the notices and their exact scope. |
| linux/ | Linux native install/upgrade/uninstall scripts, desktop entry, and user-service integration. |
| macos/ | macOS native install/upgrade/uninstall scripts and launch-agent integration. |
| man/ | User-facing manual pages for Peritus native commands. |
| rpm/ | RPM specification and package lifecycle/install layout declarations. |
| schemas/ | Versioned native-package/platform report contracts retained for packaging and release consumers. |
| windows/ | PowerShell native install/upgrade/uninstall scripts and Windows launch/service integration. |
- Unix bootstrap installer.
- Windows bootstrap installer.
- Packaging command implementation.
- Release assets.
Start with README.md and trace the corresponding xtask or installer caller before changing an artifact. Preserve platform-specific install, upgrade, uninstall, ownership, and complete-package behavior together; a recipe or retained report is not proof of a published release.
Navigation: Parent waypoint · Repository map.
Keep this waypoint aligned when local files or child responsibilities change. Descriptions are orientation, not a substitute for reading the current implementation.