Dual-Provider Workflow Reference¶

Home > Reference > Dual-Provider Workflow

Field-level contract for provider detection, ADO work item creation, ADO PR creation, and the updated issue-number extraction regex.

Contents¶

• Provider Detection Contract
• Affected Workflow Steps
• step-03 ADO Path: Work Item Creation
• step-03b Regex Contract
• step-16 ADO Path: PR Creation
• Security Invariants
• Known Limitations
• Environment Requirements

Provider Detection Contract¶

Function: detect_git_provider()¶

Defined inline in each provider-aware bash step. Returns one of two string values.

Guarantees¶

• Never exits non-zero. If git remote get-url origin fails, the remote URL is treated as empty, and the function returns github.
• The check is substring-based, not regex. Both HTTPS (https://dev.azure.com/org/...) and SSH (git@ssh.dev.azure.com:v3/...) ADO remote formats are matched by the dev.azure.com pattern.
• The result is stored in GIT_PROVIDER and treated as read-only for the rest of the step.

Affected Workflow Steps¶

step-03 ADO Path: Work Item Creation¶

Input Variables¶

Idempotency Guards (evaluated in order)¶

Guard 1: Reference in task_description¶

If task_description matches #[0-9]+, the captured number is treated as an existing ADO work item ID.

• Calls az boards work-item show --id <NUM> --query id -o tsv
• If the work item exists: emits _workitems/edit/<NUM> and exits 0
• If not found: logs a warning and falls through to Guard 2

Guard 2: Title search (WIQL)¶

Searches for an open ADO work item with a title matching the first 100 characters of ISSUE_TITLE.

• Calls az boards query --wiql "SELECT [System.Id] FROM WorkItems WHERE [System.Title] = '...' AND [System.State] <> 'Closed'"
• Single quotes in the title are escaped to ''
• If a match is found: emits _workitems/edit/<ID> and exits 0
• If no match: falls through to creation

Creation¶

az boards work-item create \
  --type "Task" \
  --title "$ISSUE_TITLE" \
  --description "$ISSUE_BODY" \
  --query id \
  -o tsv

Uses the ADO defaults configured via az devops configure --defaults.

Output¶

Emits one line to stdout: _workitems/edit/<numeric-ID>

Exit Codes¶

step-03b Regex Contract¶

The regex used to extract a numeric issue number from the step-03 output:

(issues|_workitems/edit)/[0-9]+

The extracted number is the sequence of digits after the last /.

step-16 ADO Path: PR Creation¶

Input Variables¶

Idempotency Guard¶

Before creating a PR, calls:

az repos pr list \
  --source-branch "$CURRENT_BRANCH" \
  --query '[0].url' \
  -o tsv

If a non-empty, non-None result is returned, the existing PR URL is emitted and the step exits 0.

Creation¶

az repos pr create --draft \
  --title "$PR_TITLE" \
  --description "$PR_BODY" \
  --source-branch "$CURRENT_BRANCH" \
  --target-branch "main" \
  --query url \
  -o tsv

Timeout: 120 seconds (ADO REST API; slower than GitHub API).

Output¶

Emits the ADO PR URL to stdout:

https://dev.azure.com/org/project/_git/repo/pullrequest/NNN

Exit Codes¶

Security Invariants¶

Known Limitations¶

Environment Requirements¶