provisioning/tools/package/README.md

Package Build Output\n\nPurpose: Platform-specific packages (deb, rpm, tar.gz, etc.) created from distribution artifacts.\n\n## Contents\n\nThis directory contains the output from package creation tools that convert distribution artifacts into system-specific formats.\n\n## Package Formats\n\nGenerated packages may include:\n\n### Linux Packages\n\n- deb - Debian/Ubuntu packages\n- rpm - RedHat/CentOS packages\n- tar.gz - Portable tarball archives\n- AppImage - Universal Linux application format\n\n### macOS Packages\n\n- pkg - macOS installer packages\n- dmg - macOS disk image\n- tar.gz - Portable archive\n\n### Windows Packages\n\n- msi - Windows installer\n- zip - Portable archive\n- exe - Self-extracting executable\n\n### Container Images\n\n- docker - Docker container images\n- oci - OCI container format\n\n## Usage\n\nThis directory is generated by the package build system. Do not commit contents to git (configured in .gitignore).\n\nCreate packages:\n\n\njust package-all # All format packages\njust package-linux # Linux packages only\njust package-macos # macOS packages only\njust package-deb # Debian package only\n\n\nInstall a package:\n\n\n# Linux\nsudo dpkg -i provisioning-*.deb # Debian\nsudo rpm -i provisioning-*.rpm # RedHat\n\n# macOS\nsudo installer -pkg provisioning-*.pkg -target /\n\n\n## Package Verification\n\nVerify package contents:\n\n\ndpkg -c provisioning-*.deb # List Debian package contents\nrpm -ql provisioning-*.rpm # List RedHat package contents\ntar -tzf provisioning-*.tar.gz # List tarball contents\n\n\n## Cleanup\n\nRemove all packages:\n\n\njust clean # Clean all build artifacts\n\n\n## Related Directories\n\n- dist/ - Build artifacts that packages are created from\n- distribution/ - Distribution generation (uses package outputs)\n- release/ - Version management for packages