List Jenkins jobs. Pass folder (e.g. 'team/sub') to scope; empty lists root.

Get details about a job: description, parameters (with defaults), last build numbers, health.

Trigger a build with raw Jenkins parameter names.

If wait=True (default), polls the queue until a build number is assigned. For a higher-level deploy with friendly names (branch, tickets…), use deploy().

Poll a single queue item URL — returned by trigger_build / deploy when wait=False.

Block polling a queue URL until a build number is assigned (or timeout).

Full info about a specific build: result, timestamp, duration, parameters, git.

Console output for a build. Returns the last tail_lines lines by default.

List recent builds for a job with timestamps, durations, and results.

Last SUCCESSFUL build with timestamp, duration, parameters, and git info.

Primary use case: compare timestamp vs a GitLab MR merge time to verify deployment.

List items currently waiting in the build queue.

Check whether the job's last successful build ran AFTER a given ISO timestamp.

Intended for: "was this GitLab MR (merged at ) deployed?" Accepts ISO 8601 like '2026-04-24T10:15:00+00:00' or '2026-04-24T10:15:00Z'.

List deployment-type jobs grouped by environment, with last build time + status.

Use this to discover what you can deploy. Returns groups: dev, stage, automation, utility, other.

Given a rough name ('dev backend'), show the matched job and close candidates.

High-level deploy. Maps friendly args to the job's actual Jenkins parameters.

Args: job: Deploy target (fuzzy). A bare environment defaults to the configured app job: 'dev' / 'deploy dev' → 'dev_app_deployment'; say 'dev backend' for the backend job. Other job names resolve by fuzzy match. branch: Git branch to deploy. Sets whichever branch parameter the job defines (see config). tickets: Ticket URL(s) for the deployment purpose. Multiple URLs may be passed comma-separated ('url1, url2'); they are normalized to a comma-joined list. install_dependencies: If True, sets INSTALL_BE_REQUIREMENTS + INSTALL_FE_PACKAGES (whichever exist). use_server_secrets: Sets USE_SECRETS_FROM_SERVER. config_branch: Sets CONFIGURATION_MANAGEMENT_BRANCH. Default is already 'main' on most jobs. use_dummy_purpose: When the job mandates a deployment purpose and the user has no ticket URL, set this True to deploy with the placeholder purpose (<configured dummy_purpose>). Leave False to be told the purpose is required. allow_mr_purpose: Set True to accept a merge-request URL as the purpose after the user confirms (see the 'mr_url_as_purpose' guard below). extra: Raw Jenkins param overrides {name: value}. Used for anything the friendly API misses. wait: Poll the queue until a build number is assigned. timeout: Max seconds to wait for the queue→build transition.

Mandatory deployment purpose: if the resolved job enforces a non-empty purpose (DEPLOYMENT_PURPOSE) and no tickets was given, this returns {"error": "deployment_purpose_required", ...} WITHOUT deploying. When you get that, ask the user whether to (a) paste a ticket/URL — then re-call with tickets=... — or (b) proceed with a dummy URL — then re-call with use_dummy_purpose=True.

Merge-request URL guard: the purpose should be ticket URL(s). If any supplied URL is a merge request (/merge_requests/<id>) this returns {"error": "mr_url_as_purpose", ...} WITHOUT deploying. Tell the user the URL is an MR, not a ticket, and ask them to either paste the correct ticket URL or re-call with allow_mr_purpose=True to proceed anyway.

Returns the trigger result with build_number, build_url, and parameters_sent.

One-shot deploy by ticket URL(s) + environment.

Use when the user says things like:

• "deploy on dev"

• "deploy , to stage"

• "deploy on dev backend"

Args: tickets: Ticket URL, or multiple URLs (comma, semicolon, or whitespace-separated). environment: 'dev' / 'stage' (aliases: 'development', 'staging', 'stg'). scope: 'app' (combined FE+BE, default) or 'backend' (backend-only). branch: Optional git branch override. If omitted, Jenkins uses the job's default ('dev' for dev jobs, 'stage' for stage jobs). install_dependencies: Optional override for INSTALL_BE_REQUIREMENTS / INSTALL_FE_PACKAGES. wait: Poll the queue until a build number is assigned. timeout: Max seconds to wait for the queue→build transition.

Find MRs linked to a ticket URL (matched in MR title/description).

Args: ticket_url: Full URL of the GitLab ticket/issue. state: 'all' | 'opened' | 'merged' | 'closed'. Default 'all'.

Verify whether a ticket's merged MRs are deployed on dev or stage.

For each merged MR:

• classifies files as frontend (frontend/, .scss/.css outside static/) or backend (static/**, requirements/, apps/, common/, hrdb/**, *.py)

• checks if the MR's merge commit was an ancestor of the deployed branch at the time the relevant Jenkins build ran:

  • FE changes: only <env>_app_deployment can cover

  • BE changes: <env>_app_deployment or <env>_backend_deployment

• reports per-MR deployed=true/false with reasons

Overall ticket is "deployed" only when every merged MR is fully covered. Un-merged MRs are reported separately.