# Package Build Output

**Purpose**: Platform-specific packages (deb, rpm, tar.gz, etc.) created from distribution artifacts.

## Contents

This directory contains the output from package creation tools that convert distribution artifacts into system-specific formats.

## Package Formats

Generated packages may include:

### Linux Packages

- **deb** - Debian/Ubuntu packages
- **rpm** - RedHat/CentOS packages
- **tar.gz** - Portable tarball archives
- **AppImage** - Universal Linux application format

### macOS Packages

- **pkg** - macOS installer packages
- **dmg** - macOS disk image
- **tar.gz** - Portable archive

### Windows Packages

- **msi** - Windows installer
- **zip** - Portable archive
- **exe** - Self-extracting executable

### Container Images

- **docker** - Docker container images
- **oci** - OCI container format

## Usage

This directory is generated by the package build system. Do not commit contents to git (configured in .gitignore).

Create packages:

```bash
just package-all                # All format packages
just package-linux              # Linux packages only
just package-macos              # macOS packages only
just package-deb                # Debian package only
```

Install a package:

```bash
# Linux
sudo dpkg -i provisioning-*.deb    # Debian
sudo rpm -i provisioning-*.rpm     # RedHat

# macOS
sudo installer -pkg provisioning-*.pkg -target /
```

## Package Verification

Verify package contents:

```bash
dpkg -c provisioning-*.deb       # List Debian package contents
rpm -ql provisioning-*.rpm        # List RedHat package contents
tar -tzf provisioning-*.tar.gz    # List tarball contents
```

## Cleanup

Remove all packages:

```bash
just clean                       # Clean all build artifacts
```

## Related Directories

- `dist/` - Build artifacts that packages are created from
- `distribution/` - Distribution generation (uses package outputs)
- `release/` - Version management for packages
