Version Management¶

Release or archive Jira fix versions in bulk, with automatic validation and dry-run support.

Command¶

jira-runner \
  --project <KEY> \
  --yaml transition.yaml \
  --manage-versions \
  --action <release|archive> \
  (--versions "Name 1, Name 2" | --versions-file versions.xlsx) \
  [--release-date YYYY-MM-DD] \
  [--dry-run]

Flag	Required	Description
`--manage-versions`	Yes	Enable version management mode
`--action`	Yes	`release` or `archive`
`--versions`	One of	Comma-separated version names
`--versions-file`	One of	Excel file with a `version_name` column
`--release-date`	No	Release date in `YYYY-MM-DD` format; defaults to today
`--dry-run`	No	Simulate without applying changes

Release Versions¶

# From CLI
jira-runner --project PROJ --yaml transition.yaml \
  --manage-versions --versions "Sprint 1.0, Sprint 2.0" --action release

# With a custom release date
jira-runner --project PROJ --yaml transition.yaml \
  --manage-versions --versions "Q4 Release" --action release --release-date 2024-12-31

# From Excel
jira-runner --project PROJ --yaml transition.yaml \
  --manage-versions --versions-file versions.xlsx --action release

Archive Versions¶

jira-runner --project PROJ --yaml transition.yaml \
  --manage-versions --versions "Old Sprint 1, Old Sprint 2" --action archive

Excel Input Format¶

The --versions-file Excel must have a single column named version_name:

version_name
Sprint 1.0
Sprint 2.0
Q4 Release

Validation Rules¶

Condition	Result
Unresolved issues exist (release only)	`SKIPPED`
Version already released	`SKIPPED`
Version already archived	`SKIPPED`
Version not found in project	`FAILED`
Operation succeeded	`SUCCESS`

Output Report¶

Results are written to an Excel file:

From --versions-file input.xlsx → input_results.xlsx
From --versions "..." → {PROJECT}_{action}_versions_results.xlsx

Column	Description
`version_name`	Version name
`version_id`	Jira version ID
`project_key`	Project key
`action_requested`	`release` or `archive`
`execution_status`	`SUCCESS` / `FAILED` / `SKIPPED`
`execution_message`	Details about the operation
`unresolved_issues_count`	Open issue count (release only)
`was_released`	Release status before action
`was_archived`	Archive status before action
`executed_at`	ISO 8601 timestamp