uip maestro bpmn pack

Syntax and options for `uip maestro bpmn pack`, which packages a Maestro project directory into a `.nupkg` for Orchestrator publication.

uip maestro bpmn pack packages a Maestro project directory into a .nupkg ready to publish to Orchestrator as a Process Orchestration release. It's registered under the bpmn branch.

Synopsis

uip maestro bpmn pack <projectPath> <outputPath> [-n <name>] [-v <version>]
                       [--author <author>] [--description <text>]
                       [--repository-url <url>] [--repository-commit <sha>]
                       [--repository-branch <branch>] [--repository-type <type>]
                       [--release-notes <text>] [--project-url <url>]

Honors global options. Exit codes follow the standard contract.

Arguments

• <projectPath> (required) — path to the Maestro project directory (must contain project.uiproj, a .bpmn, and the metadata files created by init).
• <outputPath> (required) — output directory where the .nupkg will be written.

Options

Option	Description
-n, --name <name>	Package name. Defaults to the project folder name.
-v, --version <version>	Package version. Defaults to 1.0.0.
--author <author>	Package author.
--description <text>	Package description.
--repository-url <url>	Source repository URL, recorded in the package for traceability.
--repository-commit <sha>	Source repository commit hash, recorded for traceability.
--repository-branch <branch>	Source repository branch.
--repository-type <type>	Source repository type. Defaults to git when --repository-url is set.
--release-notes <text>	Release notes for the package.
--project-url <url>	Automation Hub idea URL.

Examples

# Pack with defaults
uip maestro bpmn pack ./invoice-orchestration ./dist

# Pack with an explicit version
uip maestro bpmn pack ./invoice-orchestration ./dist --version 1.2.0

# Pack with traceability metadata for CI provenance
uip maestro bpmn pack ./invoice-orchestration ./dist --version 1.2.0 \
  --repository-url https://github.com/acme/invoice-orchestration \
  --repository-commit "$GIT_SHA" --repository-branch main

Data shape (--output json)

{
  "Code": "MaestroPack",
  "Data": {
    "Package": "invoice-orchestration@1.2.0",
    "Output":  "./dist/invoice-orchestration.processOrchestration.ProcessOrchestration.1.2.0.nupkg"
  }
}

The generated .nupkg filename encodes <name>.processOrchestration.ProcessOrchestration.<version>.nupkg.

See also

• uip maestro bpmn init — scaffold the project first
• uip maestro bpmn debug — smoke-test before packing
• uip maestro bpmn validate — validate before packing
• uip maestro bpmn process publish — pack and publish to Orchestrator in one step
• Maestro overview