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:

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
  • 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