# Distribution Package Generation

**Purpose**: Generate complete distribution packages from compiled binaries and libraries.

## Contents

Scripts and outputs for creating distribution-ready packages across multiple platforms and formats.

## What is Distribution Generation

Distribution generation takes the compiled artifacts from `dist/` and packages them into:

- Installable archives (tar.gz, zip)
- Platform-specific installers (deb, rpm, brew)
- Docker/container images
- Binary distributions with configuration templates

## Build Process

The distribution build system:

1. Takes binaries from `dist/platform/`
2. Takes libraries from `dist/core/`
3. Takes configuration templates from `dist/config/`
4. Combines with installation scripts
5. Creates platform-specific packages

Generate a distribution:

```bash
just dist-generate              # Full distribution generation
just dist-validate              # Validate generated distribution
```

## Output Artifacts

Generated distribution includes:

- Compiled binaries (orchestrator, control-center, MCP server)
- Installation script (install.sh)
- Configuration templates
- Documentation
- License files

## Related Directories

- `dist/` - Build output (source for distribution)
- `package/` - Alternative packaging (low-level format creation)
- `release/` - Version management and release tagging

## Integration

The distribution output is used by:

- Installation system (`provisioning-installer`)
- Package managers
- CI/CD pipelines
- End-user downloads