diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index c79b34499..e5e0b94ec 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -9,11 +9,11 @@ on:
branches: ["main"]
tags-ignore: ["v*-*"]
pull_request:
- branches: ["main"]
+ branches: ["main"]
workflow_dispatch:
inputs:
ForceRelease:
- description: 'Force a release! Use when changes hapen out of sync and `src` and `docs` folder changes are not detected.'
+ description: "Force a release! Use when changes hapen out of sync and `src` and `docs` folder changes are not detected."
required: false
default: false
type: boolean
@@ -27,8 +27,7 @@ defaults:
shell: pwsh
jobs:
-
- # Setup & Configuration
+ # Setup & Configuration
Setup:
name: "Setup & Configuration "
runs-on: ubuntu-latest
@@ -55,247 +54,247 @@ jobs:
nkdAgility_RunRelease: ${{ steps.nkdagility.outputs.RunRelease }}
nkdAgility_AzureSitesEnvironment: ${{ steps.nkdagility.outputs.AzureSitesEnvironment }}
steps:
- - name: Checkout
- uses: actions/checkout@v4
- with:
- fetch-depth: 0
- - name: "Fix contibutions if main"
- shell: pwsh
- if: ${{ (github.event.pull_request.head.repo.fork && github.ref == 'refs/heads/main') }}
- id: contributionbranchfix
- run: |
- # Get environment variables
- $branchName = "pr-temp-${{ github.event.pull_request.number }}"
- $newBranchName = "contrib/$branchName"
- git checkout -b $newBranchName
- - name: Install GitVersion
- uses: gittools/actions/gitversion/setup@v3.0.2
- with:
- versionSpec: '5.x'
- includePrerelease: true
- - name: Execute GitVersion
- id: gitversion
- uses: gittools/actions/gitversion/execute@v3.0.2
- with:
- useConfigFile: true
-
- - name: "Ring Detection"
- shell: pwsh
- id: RingDetection
- run: |
- # Get Branch Name
- Write-Output "::group::Get Branch Name"
- Write-Output "-------------------------------------------"
- $branchName = "${{ github.head_ref || github.ref_name }}"
- Write-Output "We are running on: $branchName!"
- $branchSafeName = $branchName.Replace("/", "-")
- Write-Output "branchSafeName: $branchSafeName!"
- Write-Output "-------------------------------------------"
- Write-Output "::endgroup::"
-
- # Ring Setup
- Write-Output "::group::Ring Control Setup"
- Write-Output "-------------------------------------------"
- Write-Output "Ring Control Setup"
- Write-Output "-------------------------------------------"
- $Ring = "Canary"
-
- # Use GitVersion output directly instead of environment variable
- $preReleaseLabel = "${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}"
- Write-Output "GitVersion_PreReleaseLabel: '$preReleaseLabel'"
-
- switch ($preReleaseLabel) {
- "" {
- $Ring = "Production";
- }
- "Preview" {
- $Ring = "Preview";
- }
- default {
- $Ring = "Canary";
- }
- }
-
- Write-Output "We are running for the $Ring Ring!"
- echo "Ring=$Ring" >> $env:GITHUB_OUTPUT
- Write-Output "-------------------------------------------"
- Write-Output "::endgroup::"
-
- - name: "Determine Filter Base"
- id: filter-base
- shell: pwsh
- run: |
- try {
- # Debug current context
- Write-Output "=== FILTER BASE DEBUG ==="
- Write-Output "Event: ${{ github.event_name }}"
- Write-Output "Ref: ${{ github.ref }}"
- Write-Output "Ring: ${{ steps.RingDetection.outputs.Ring }}"
- Write-Output "GitVersion_PreReleaseLabel: '${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}'"
- Write-Output "GitVersion_SemVer: '${{ steps.gitversion.outputs.GitVersion_SemVer }}'"
- Write-Output "=========================="
-
- # For production builds (no pre-release label), find the last production tag
- if ("${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}" -eq "") {
- Write-Output "Production build detected - finding last production release"
-
- # Get current version to exclude it from the search
- $currentVersion = "v${{ steps.gitversion.outputs.GitVersion_SemVer }}"
- Write-Output "Current version: $currentVersion"
-
- # Get all production tags, exclude current, sort by version
- $allProductionTags = git tag -l | Where-Object { $_ -match '^v\d+\.\d+\.\d+$' }
- Write-Output "All production tags found: $($allProductionTags -join ', ')"
-
- $lastProductionTag = $allProductionTags |
- Where-Object { $_ -ne $currentVersion } |
- Sort-Object { [Version]($_ -replace '^v', '') } |
- Select-Object -Last 1
-
- if ($lastProductionTag) {
- Write-Output "Last production tag: $lastProductionTag"
- echo "base=$lastProductionTag" >> $env:GITHUB_OUTPUT
+ - name: Checkout
+ uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+ - name: "Fix contibutions if main"
+ shell: pwsh
+ if: ${{ (github.event.pull_request.head.repo.fork && github.ref == 'refs/heads/main') }}
+ id: contributionbranchfix
+ run: |
+ # Get environment variables
+ $branchName = "pr-temp-${{ github.event.pull_request.number }}"
+ $newBranchName = "contrib/$branchName"
+ git checkout -b $newBranchName
+ - name: Install GitVersion
+ uses: gittools/actions/gitversion/setup@v3.0.2
+ with:
+ versionSpec: "5.x"
+ includePrerelease: true
+ - name: Execute GitVersion
+ id: gitversion
+ uses: gittools/actions/gitversion/execute@v3.0.2
+ with:
+ useConfigFile: true
+
+ - name: "Ring Detection"
+ shell: pwsh
+ id: RingDetection
+ run: |
+ # Get Branch Name
+ Write-Output "::group::Get Branch Name"
+ Write-Output "-------------------------------------------"
+ $branchName = "${{ github.head_ref || github.ref_name }}"
+ Write-Output "We are running on: $branchName!"
+ $branchSafeName = $branchName.Replace("/", "-")
+ Write-Output "branchSafeName: $branchSafeName!"
+ Write-Output "-------------------------------------------"
+ Write-Output "::endgroup::"
+
+ # Ring Setup
+ Write-Output "::group::Ring Control Setup"
+ Write-Output "-------------------------------------------"
+ Write-Output "Ring Control Setup"
+ Write-Output "-------------------------------------------"
+ $Ring = "Canary"
+
+ # Use GitVersion output directly instead of environment variable
+ $preReleaseLabel = "${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}"
+ Write-Output "GitVersion_PreReleaseLabel: '$preReleaseLabel'"
+
+ switch ($preReleaseLabel) {
+ "" {
+ $Ring = "Production";
+ }
+ "Preview" {
+ $Ring = "Preview";
+ }
+ default {
+ $Ring = "Canary";
+ }
+ }
+
+ Write-Output "We are running for the $Ring Ring!"
+ echo "Ring=$Ring" >> $env:GITHUB_OUTPUT
+ Write-Output "-------------------------------------------"
+ Write-Output "::endgroup::"
+
+ - name: "Determine Filter Base"
+ id: filter-base
+ shell: pwsh
+ run: |
+ try {
+ # Debug current context
+ Write-Output "=== FILTER BASE DEBUG ==="
+ Write-Output "Event: ${{ github.event_name }}"
+ Write-Output "Ref: ${{ github.ref }}"
+ Write-Output "Ring: ${{ steps.RingDetection.outputs.Ring }}"
+ Write-Output "GitVersion_PreReleaseLabel: '${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}'"
+ Write-Output "GitVersion_SemVer: '${{ steps.gitversion.outputs.GitVersion_SemVer }}'"
+ Write-Output "=========================="
+
+ # For production builds (no pre-release label), find the last production tag
+ if ("${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}" -eq "") {
+ Write-Output "Production build detected - finding last production release"
+
+ # Get current version to exclude it from the search
+ $currentVersion = "v${{ steps.gitversion.outputs.GitVersion_SemVer }}"
+ Write-Output "Current version: $currentVersion"
+
+ # Get all production tags, exclude current, sort by version
+ $allProductionTags = git tag -l | Where-Object { $_ -match '^v\d+\.\d+\.\d+$' }
+ Write-Output "All production tags found: $($allProductionTags -join ', ')"
+
+ $lastProductionTag = $allProductionTags |
+ Where-Object { $_ -ne $currentVersion } |
+ Sort-Object { [Version]($_ -replace '^v', '') } |
+ Select-Object -Last 1
+
+ if ($lastProductionTag) {
+ Write-Output "Last production tag: $lastProductionTag"
+ echo "base=$lastProductionTag" >> $env:GITHUB_OUTPUT
+ } else {
+ Write-Output "No previous production tag found - this is the first release"
+ # For first release, compare against repository root to include all files
+ $rootCommit = git rev-list --max-parents=0 HEAD
+ Write-Output "Using root commit: $rootCommit"
+ echo "base=$rootCommit" >> $env:GITHUB_OUTPUT
+ }
} else {
- Write-Output "No previous production tag found - this is the first release"
- # For first release, compare against repository root to include all files
- $rootCommit = git rev-list --max-parents=0 HEAD
- Write-Output "Using root commit: $rootCommit"
- echo "base=$rootCommit" >> $env:GITHUB_OUTPUT
+ Write-Output "Pre-release build (Label: '${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}') - using default base"
+ echo "base=" >> $env:GITHUB_OUTPUT
}
- } else {
- Write-Output "Pre-release build (Label: '${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}') - using default base"
+ } catch {
+ Write-Error "Error determining filter base: $_"
+ Write-Output "Falling back to default base"
echo "base=" >> $env:GITHUB_OUTPUT
}
- } catch {
- Write-Error "Error determining filter base: $_"
- Write-Output "Falling back to default base"
- echo "base=" >> $env:GITHUB_OUTPUT
- }
-
- - uses: dorny/paths-filter@v3
- id: filter
- with:
- list-files: json
- base: ${{ steps.filter-base.outputs.base }}
- filters: |
- src:
- - 'src/**'
- docs:
- - 'docs/**'
- automation:
- - 'build/**'
- - '.github/**'
- - name: "Debug Filter Results"
- shell: pwsh
- run: |
- Write-Output "=== PATH FILTER DEBUG ==="
- Write-Output "Event: ${{ github.event_name }}"
- Write-Output "Ref: ${{ github.ref }}"
- Write-Output "Filter base used: '${{ steps.filter-base.outputs.base }}'"
- Write-Output "Ring: '${{ steps.RingDetection.outputs.Ring }}'"
- Write-Output "Current GitVersion: v${{ steps.gitversion.outputs.GitVersion_SemVer }}"
- Write-Output "Pre-release label: '${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}'"
- Write-Output "---"
- Write-Output "Filter results:"
- Write-Output " src: ${{ steps.filter.outputs.src }}"
- Write-Output " docs: ${{ steps.filter.outputs.docs }}"
- Write-Output " automation: ${{ steps.filter.outputs.automation }}"
- Write-Output "---"
- Write-Output "Files that matched filters:"
- Write-Output "src files:"
- Write-Output '${{ steps.filter.outputs.src_files }}'
- Write-Output "docs files:"
- Write-Output '${{ steps.filter.outputs.docs_files }}'
- Write-Output "automation files:"
- Write-Output '${{ steps.filter.outputs.automation_files }}'
- Write-Output "changes array:"
- Write-Output '${{ steps.filter.outputs.changes }}'
- Write-Output "========================="
- - name: "Build NKDAgility Outputs"
- shell: pwsh
- id: nkdagility
- run: |
- # Get Branch Name
- Write-Output "::group::Get Branch Name"
- Write-Output "-------------------------------------------"
- $branchName = "${{ github.head_ref || github.ref_name }}"
- Write-Output "We are running on: $branchName!"
- $branchSafeName = $branchName.Replace("/", "-")
- Write-Output "branchSafeName: $branchSafeName!"
- Write-Output "-------------------------------------------"
- Write-Output "::endgroup::"
-
- # Ring Setup
- Write-Output "::group::Ring Control Setup"
- Write-Output "-------------------------------------------"
- Write-Output "Ring Control Setup"
- Write-Output "-------------------------------------------"
- $Ring = "${{ steps.RingDetection.outputs.Ring }}"
- $WingetApplicationId = "nkdagility.azure-devops-migration-tools"
-
- switch ("${{ steps.RingDetection.outputs.Ring }}") {
- "Production" {
- $WingetApplicationId = "nkdagility.azure-devops-migration-tools";
- $AzureSitesEnvironment = ""
- # Production: Release app when ForceRelease OR src changed
- $RunRelease = ( ('${{ inputs.ForceRelease }}' -eq 'true' ) -or ('${{ steps.filter.outputs.src }}' -eq 'true') )
- }
- "Preview" {
- $WingetApplicationId = "nkdagility.azure-devops-migration-tools.Preview";
- $AzureSitesEnvironment = "preview";
- # Preview: Release app when ForceRelease OR src changed
- $RunRelease = ( ('${{ inputs.ForceRelease }}' -eq 'true' ) -or ('${{ steps.filter.outputs.src }}' -eq 'true') )
- }
- default {
- $WingetApplicationId = "nkdagility.azure-devops-migration-tools.Canary";
- $AzureSitesEnvironment = "${{ steps.RingDetection.outputs.Ring }}-${{ github.event.pull_request.number }}".ToLower()
- $RunRelease = 'false'
- }
- }
- Write-Output "We are running for the $Ring Ring!"
- echo "Ring=$Ring" >> $env:GITHUB_OUTPUT
- Write-Output "We are focused on Winget ID $WingetApplicationId!"
- echo "WingetApplicationId=$WingetApplicationId" >> $env:GITHUB_OUTPUT
- Write-Output "We are running for the $AzureSitesEnvironment AzureSitesEnvironment!"
- echo "AzureSitesEnvironment=$AzureSitesEnvironment" >> $env:GITHUB_OUTPUT
- Write-Output "RunRelease=$RunRelease (App releases when ForceRelease OR src changed)"
- echo "RunRelease=$RunRelease" >> $env:GITHUB_OUTPUT
- Write-Output "-------------------------------------------"
- Write-Output "::endgroup::"
- # Get-ReleaseDescription
- Write-Output "::group::Release Description Setup"
- Write-Output "-------------------------------------------"
- Write-Output "Get-ReleaseDescription"
- Write-Output "-------------------------------------------"
- if ($env:GITHUB_EVENT_NAME -ne "pull_request" -and $eventName -ne "pull_request_target")
- {
- Write-Output "Running Get-ReleaseDescription.ps1"
- . .\build\include\Get-ReleaseDescription.ps1
- $description = Get-ReleaseDescription -mode log -OPEN_AI_KEY ${{ secrets.OPENAI_API_KEY }}
- if ($description -eq $null) {
- $description = "No release description found";
- echo "release_description_state=false" >> $env:GITHUB_OUTPUT
- } else {
- echo "release_description_state=true" >> $env:GITHUB_OUTPUT
-
- }
- $EOF = -join (1..15 | ForEach {[char]((48..57)+(65..90)+(97..122) | Get-Random)})
- echo "release_description<<$EOF" >> $env:GITHUB_OUTPUT
- echo $description >> $env:GITHUB_OUTPUT
- echo "$EOF" >> $env:GITHUB_OUTPUT
- } else {
- $description = "Skipping for PR!"
- echo "release_description=$description" >> $env:GITHUB_OUTPUT
- Write-Output $description
- }
+ - uses: dorny/paths-filter@v3
+ id: filter
+ with:
+ list-files: json
+ base: ${{ steps.filter-base.outputs.base }}
+ filters: |
+ src:
+ - 'src/**'
+ docs:
+ - 'docs/**'
+ automation:
+ - 'build/**'
+ - '.github/**'
+ - name: "Debug Filter Results"
+ shell: pwsh
+ run: |
+ Write-Output "=== PATH FILTER DEBUG ==="
+ Write-Output "Event: ${{ github.event_name }}"
+ Write-Output "Ref: ${{ github.ref }}"
+ Write-Output "Filter base used: '${{ steps.filter-base.outputs.base }}'"
+ Write-Output "Ring: '${{ steps.RingDetection.outputs.Ring }}'"
+ Write-Output "Current GitVersion: v${{ steps.gitversion.outputs.GitVersion_SemVer }}"
+ Write-Output "Pre-release label: '${{ steps.gitversion.outputs.GitVersion_PreReleaseLabel }}'"
+ Write-Output "---"
+ Write-Output "Filter results:"
+ Write-Output " src: ${{ steps.filter.outputs.src }}"
+ Write-Output " docs: ${{ steps.filter.outputs.docs }}"
+ Write-Output " automation: ${{ steps.filter.outputs.automation }}"
+ Write-Output "---"
+ Write-Output "Files that matched filters:"
+ Write-Output "src files:"
+ Write-Output '${{ steps.filter.outputs.src_files }}'
+ Write-Output "docs files:"
+ Write-Output '${{ steps.filter.outputs.docs_files }}'
+ Write-Output "automation files:"
+ Write-Output '${{ steps.filter.outputs.automation_files }}'
+ Write-Output "changes array:"
+ Write-Output '${{ steps.filter.outputs.changes }}'
+ Write-Output "========================="
+ - name: "Build NKDAgility Outputs"
+ shell: pwsh
+ id: nkdagility
+ run: |
+ # Get Branch Name
+ Write-Output "::group::Get Branch Name"
+ Write-Output "-------------------------------------------"
+ $branchName = "${{ github.head_ref || github.ref_name }}"
+ Write-Output "We are running on: $branchName!"
+ $branchSafeName = $branchName.Replace("/", "-")
+ Write-Output "branchSafeName: $branchSafeName!"
+ Write-Output "-------------------------------------------"
+ Write-Output "::endgroup::"
+
+ # Ring Setup
+ Write-Output "::group::Ring Control Setup"
+ Write-Output "-------------------------------------------"
+ Write-Output "Ring Control Setup"
+ Write-Output "-------------------------------------------"
+ $Ring = "${{ steps.RingDetection.outputs.Ring }}"
+ $WingetApplicationId = "nkdagility.azure-devops-migration-tools"
+
+ switch ("${{ steps.RingDetection.outputs.Ring }}") {
+ "Production" {
+ $WingetApplicationId = "nkdagility.azure-devops-migration-tools";
+ $AzureSitesEnvironment = ""
+ # Production: Release app when ForceRelease OR src changed
+ $RunRelease = ( ('${{ inputs.ForceRelease }}' -eq 'true' ) -or ('${{ steps.filter.outputs.src }}' -eq 'true') )
+ }
+ "Preview" {
+ $WingetApplicationId = "nkdagility.azure-devops-migration-tools.Preview";
+ $AzureSitesEnvironment = "preview";
+ # Preview: Release app when ForceRelease OR src changed
+ $RunRelease = ( ('${{ inputs.ForceRelease }}' -eq 'true' ) -or ('${{ steps.filter.outputs.src }}' -eq 'true') )
+ }
+ default {
+ $WingetApplicationId = "nkdagility.azure-devops-migration-tools.Canary";
+ $AzureSitesEnvironment = "${{ steps.RingDetection.outputs.Ring }}-${{ github.event.pull_request.number }}".ToLower()
+ $RunRelease = 'false'
+ }
+ }
- Write-Output "-------------------------------------------"
- Write-Output "::endgroup::"
- - uses: actions/upload-artifact@v4
- with:
- name: AzureDevOpsMigrationTools-Scripts
- path: ./build/**
+ Write-Output "We are running for the $Ring Ring!"
+ echo "Ring=$Ring" >> $env:GITHUB_OUTPUT
+ Write-Output "We are focused on Winget ID $WingetApplicationId!"
+ echo "WingetApplicationId=$WingetApplicationId" >> $env:GITHUB_OUTPUT
+ Write-Output "We are running for the $AzureSitesEnvironment AzureSitesEnvironment!"
+ echo "AzureSitesEnvironment=$AzureSitesEnvironment" >> $env:GITHUB_OUTPUT
+ Write-Output "RunRelease=$RunRelease (App releases when ForceRelease OR src changed)"
+ echo "RunRelease=$RunRelease" >> $env:GITHUB_OUTPUT
+ Write-Output "-------------------------------------------"
+ Write-Output "::endgroup::"
+ # Get-ReleaseDescription
+ Write-Output "::group::Release Description Setup"
+ Write-Output "-------------------------------------------"
+ Write-Output "Get-ReleaseDescription"
+ Write-Output "-------------------------------------------"
+ if ($env:GITHUB_EVENT_NAME -ne "pull_request" -and $eventName -ne "pull_request_target")
+ {
+ Write-Output "Running Get-ReleaseDescription.ps1"
+ . .\build\include\Get-ReleaseDescription.ps1
+ $description = Get-ReleaseDescription -mode log -OPEN_AI_KEY ${{ secrets.OPENAI_API_KEY }}
+ if ($description -eq $null) {
+ $description = "No release description found";
+ echo "release_description_state=false" >> $env:GITHUB_OUTPUT
+ } else {
+ echo "release_description_state=true" >> $env:GITHUB_OUTPUT
+
+ }
+ $EOF = -join (1..15 | ForEach {[char]((48..57)+(65..90)+(97..122) | Get-Random)})
+ echo "release_description<<$EOF" >> $env:GITHUB_OUTPUT
+ echo $description >> $env:GITHUB_OUTPUT
+ echo "$EOF" >> $env:GITHUB_OUTPUT
+ } else {
+ $description = "Skipping for PR!"
+ echo "release_description=$description" >> $env:GITHUB_OUTPUT
+ Write-Output $description
+ }
+
+ Write-Output "-------------------------------------------"
+ Write-Output "::endgroup::"
+ - uses: actions/upload-artifact@v4
+ with:
+ name: AzureDevOpsMigrationTools-Scripts
+ path: ./build/**
# Setup Validator
SetupSummeryStage:
@@ -303,46 +302,46 @@ jobs:
runs-on: ubuntu-latest
needs: Setup
steps:
- - name: "Show Summery"
- if: always()
- shell: pwsh
- id: nkdagility-summery
- run: |
- $markdown = @"
- ## ${{needs.Setup.outputs.GitVersion_SemVer}} (${{needs.Setup.outputs.nkdAgility_Ring}})
- ### NKDAgility
- - nkdAgility_Ring: ${{needs.Setup.outputs.nkdAgility_Ring}}
- - nkdAgility_WingetApplicationId: ${{needs.Setup.outputs.nkdAgility_WingetApplicationId}}
- - nkdAgility_DocsVersionFolder: ${{needs.Setup.outputs.nkdAgility_DocsVersionFolder}}
- - nkdAgility_DocsDeployFolder: ${{needs.Setup.outputs.nkdAgility_DocsDeployFolder}}
- - nkdAgility_DocsBaseURL: ${{needs.Setup.outputs.nkdAgility_DocsBaseURL}}
- - nkdAgility_AzureSitesEnvironment: ${{needs.Setup.outputs.nkdAgility_AzureSitesEnvironment}}
- - nkdAgility_ReleaseDescriptionState: ${{needs.Setup.outputs.nkdAgility_ReleaseDescriptionState}}
- - nkdAgility_RunRelease: ${{needs.Setup.outputs.nkdAgility_RunRelease}}
- ### GitVersion
- - GitVersion_BranchName: ${{needs.Setup.outputs.GitVersion_BranchName}}
- - GitVersion_SemVer: ${{needs.Setup.outputs.GitVersion_SemVer}}
- - GitVersion_PreReleaseLabel: ${{needs.Setup.outputs.GitVersion_PreReleaseLabel}}
- - GitVersion_AssemblySemVer: ${{needs.Setup.outputs.GitVersion_AssemblySemVer}}
- - GitVersion_InformationalVersion: ${{needs.Setup.outputs.GitVersion_InformationalVersion}}
- - GitVersion_NuGetVersion: ${{needs.Setup.outputs.GitVersion_NuGetVersion}}
- ### Has Changed
- - HasChanged_src: ${{needs.Setup.outputs.HasChanged_src}}
- - HasChanged_docs: ${{needs.Setup.outputs.HasChanged_docs}}
- - HasChanged_automation: ${{needs.Setup.outputs.HasChanged_automation}}
- "@
- echo $markdown >> $Env:GITHUB_STEP_SUMMARY
- - name: "Show Release Description"
- if: always()
- shell: pwsh
- id: nkdAgility_ReleaseDescription
- run: |
- Write-Host "::debug::nkdAgility_ReleaseDescription | $Env:GITHUB_STEP_SUMMARY"
- $markdown = @"
- ## nkdAgility_ReleaseDescription
- ${{needs.Setup.outputs.nkdAgility_ReleaseDescription}}
- "@
- echo $markdown >> $Env:GITHUB_STEP_SUMMARY
+ - name: "Show Summery"
+ if: always()
+ shell: pwsh
+ id: nkdagility-summery
+ run: |
+ $markdown = @"
+ ## ${{needs.Setup.outputs.GitVersion_SemVer}} (${{needs.Setup.outputs.nkdAgility_Ring}})
+ ### NKDAgility
+ - nkdAgility_Ring: ${{needs.Setup.outputs.nkdAgility_Ring}}
+ - nkdAgility_WingetApplicationId: ${{needs.Setup.outputs.nkdAgility_WingetApplicationId}}
+ - nkdAgility_DocsVersionFolder: ${{needs.Setup.outputs.nkdAgility_DocsVersionFolder}}
+ - nkdAgility_DocsDeployFolder: ${{needs.Setup.outputs.nkdAgility_DocsDeployFolder}}
+ - nkdAgility_DocsBaseURL: ${{needs.Setup.outputs.nkdAgility_DocsBaseURL}}
+ - nkdAgility_AzureSitesEnvironment: ${{needs.Setup.outputs.nkdAgility_AzureSitesEnvironment}}
+ - nkdAgility_ReleaseDescriptionState: ${{needs.Setup.outputs.nkdAgility_ReleaseDescriptionState}}
+ - nkdAgility_RunRelease: ${{needs.Setup.outputs.nkdAgility_RunRelease}}
+ ### GitVersion
+ - GitVersion_BranchName: ${{needs.Setup.outputs.GitVersion_BranchName}}
+ - GitVersion_SemVer: ${{needs.Setup.outputs.GitVersion_SemVer}}
+ - GitVersion_PreReleaseLabel: ${{needs.Setup.outputs.GitVersion_PreReleaseLabel}}
+ - GitVersion_AssemblySemVer: ${{needs.Setup.outputs.GitVersion_AssemblySemVer}}
+ - GitVersion_InformationalVersion: ${{needs.Setup.outputs.GitVersion_InformationalVersion}}
+ - GitVersion_NuGetVersion: ${{needs.Setup.outputs.GitVersion_NuGetVersion}}
+ ### Has Changed
+ - HasChanged_src: ${{needs.Setup.outputs.HasChanged_src}}
+ - HasChanged_docs: ${{needs.Setup.outputs.HasChanged_docs}}
+ - HasChanged_automation: ${{needs.Setup.outputs.HasChanged_automation}}
+ "@
+ echo $markdown >> $Env:GITHUB_STEP_SUMMARY
+ - name: "Show Release Description"
+ if: always()
+ shell: pwsh
+ id: nkdAgility_ReleaseDescription
+ run: |
+ Write-Host "::debug::nkdAgility_ReleaseDescription | $Env:GITHUB_STEP_SUMMARY"
+ $markdown = @"
+ ## nkdAgility_ReleaseDescription
+ ${{needs.Setup.outputs.nkdAgility_ReleaseDescription}}
+ "@
+ echo $markdown >> $Env:GITHUB_STEP_SUMMARY
# Build, Test, Sonar Cloud Analysis, & Package
@@ -354,9 +353,9 @@ jobs:
if: ${{ success() && (needs.Setup.outputs.HasChanged_src == 'true' || needs.Setup.outputs.HasChanged_automation == 'true') }}
env:
- solution: '**/*.sln'
- buildPlatform: 'Any CPU'
- buildConfiguration: 'Release'
+ solution: "**/*.sln"
+ buildPlatform: "Any CPU"
+ buildConfiguration: "Release"
nkdAgility_Ring: ${{ needs.Setup.outputs.nkdAgility_Ring }}
GitVersion_SemVer: ${{ needs.Setup.outputs.GitVersion_SemVer }}
GitVersion_AssemblySemVer: ${{ needs.Setup.outputs.GitVersion_AssemblySemVer }}
@@ -371,7 +370,7 @@ jobs:
if: ${{ !(github.event.pull_request.head.repo.fork) }}
with:
java-version: 17
- distribution: 'zulu'
+ distribution: "zulu"
- name: Checkout
uses: actions/checkout@v4
- uses: cschleiden/replace-tokens@v1
@@ -383,36 +382,36 @@ jobs:
uses: actions/setup-dotnet@v4
with:
dotnet-version: |
- 8.x
+ 8.x
- name: "Find solution files"
shell: pwsh
run: |
- Get-Item -Path .\
- Get-ChildItem -Path .\ -Recurse -Filter '*.sln' | ForEach-Object { $_.FullName }
+ Get-Item -Path .\
+ Get-ChildItem -Path .\ -Recurse -Filter '*.sln' | ForEach-Object { $_.FullName }
- name: sonar install
if: ${{ !(github.event.pull_request.head.repo.fork) }}
run: dotnet tool install --global dotnet-sonarscanner
- name: sonar begin
if: ${{ !(github.event.pull_request.head.repo.fork) }}
run: dotnet sonarscanner begin
- /o:"nkdagility"
- /k:"vsts-sync-migrator:master"
- /d:sonar.host.url="https://sonarcloud.io"
- /d:sonar.token="${{ secrets.SONAR_TOKEN }}"
+ /o:"nkdagility"
+ /k:"vsts-sync-migrator:master"
+ /d:sonar.host.url="https://sonarcloud.io"
+ /d:sonar.token="${{ secrets.SONAR_TOKEN }}"
- run: dotnet build MigrationTools.sln /p:Version=${{ env.GitVersion_SemVer }} /p:FileVersion=${{ env.GitVersion_AssemblySemVer }} /p:InformationalVersion=${{ env.GitVersion_InformationalVersion }} /p:GitVersionTag=${{ env.GitVersion_PreReleaseLabel }}
name: Build MigrationTools.sln
id: Build
- name: "Check that required files exist!"
shell: pwsh
run: |
- $foundFiles = Get-ChildItem -Path .\ -Recurse -Filter '*WITDataStore64*' | ForEach-Object { $_.FullName }
- if ($foundFiles -eq $null) {
- Write-Output "No WITDataStore64 found"
- exit 1
- } else {
- Write-Output "Found WITDataStore64"
- }
- $foundFiles
+ $foundFiles = Get-ChildItem -Path .\ -Recurse -Filter '*WITDataStore64*' | ForEach-Object { $_.FullName }
+ if ($foundFiles -eq $null) {
+ Write-Output "No WITDataStore64 found"
+ exit 1
+ } else {
+ Write-Output "Found WITDataStore64"
+ }
+ $foundFiles
- run: dotnet test "MigrationTools.sln" --results-directory ".\test-results\" --logger trx --collect "Code coverage" --no-build --filter "(TestCategory=L0|TestCategory=L1)"
- run: dotnet test "MigrationTools.sln" --results-directory ".\test-results\" --logger trx --collect "Code coverage" --no-build --filter "(TestCategory=L2|TestCategory=L3)"
- run: dotnet test "MigrationTools.sln" --results-directory ".\test-results\" --logger trx --collect "Code coverage" --no-build --filter "(TestCategory!=L0&TestCategory!=L1&TestCategory!=L2&TestCategory!=L3)"
@@ -424,24 +423,24 @@ jobs:
shell: pwsh
if: ${{ steps.Build.outcome == 'success' }}
run: |
- ./build/packageExecutable.ps1 -version ${{ env.GitVersion_SemVer }} -outfolder "./staging"
+ ./build/packageExecutable.ps1 -version ${{ env.GitVersion_SemVer }} -outfolder "./staging"
- name: "Package Chocolatey Files"
shell: pwsh
if: ${{ steps.packageExecutable.outcome == 'success' }}
run: |
- $item = Get-ChildItem -Path ./staging/ -Recurse -Filter 'MigrationTools-${{ env.GitVersion_SemVer }}.zip' | Select-Object -First 1
- Write-Output "Found: $item.FullName"
- .\build\packageChocolatey.ps1 -SemVer ${{ env.GitVersion_SemVer }} -NuGetVersion ${{ env.GitVersion_NuGetVersion }} -outfolder "./staging" -migrationToolsFilename $item.FullName
+ $item = Get-ChildItem -Path ./staging/ -Recurse -Filter 'MigrationTools-${{ env.GitVersion_SemVer }}.zip' | Select-Object -First 1
+ Write-Output "Found: $item.FullName"
+ .\build\packageChocolatey.ps1 -SemVer ${{ env.GitVersion_SemVer }} -NuGetVersion ${{ env.GitVersion_NuGetVersion }} -outfolder "./staging" -migrationToolsFilename $item.FullName
- name: "Package Extension Files"
shell: pwsh
if: ${{ steps.Build.outcome == 'success' }}
run: |
- .\build\packageExtension.ps1 -version ${{ env.GitVersion_AssemblySemVer }} -outfolder "./staging"
+ .\build\packageExtension.ps1 -version ${{ env.GitVersion_AssemblySemVer }} -outfolder "./staging"
- name: "List Package Files"
shell: pwsh
if: ${{ steps.Build.outcome == 'success' }}
run: |
- Get-ChildItem -Path ./staging/ -Recurse | ForEach-Object { $_.FullName }
+ Get-ChildItem -Path ./staging/ -Recurse | ForEach-Object { $_.FullName }
- uses: actions/upload-artifact@v4
with:
name: AzureDevOpsMigrationTools-Packages
@@ -465,7 +464,7 @@ jobs:
- uses: actions/checkout@v4
- uses: cschleiden/replace-tokens@v1
with:
- files: '["**/*.html", "**/*.yaml", "**/*.yml"]'
+ files: '["**/*.html", "**/*.yaml", "**/*.yml", "**/*.json"]'
tokenPrefix: "#{"
tokenSuffix: "}#"
env:
@@ -478,7 +477,7 @@ jobs:
uses: peaceiris/actions-hugo@v3
with:
extended: true
- hugo-version: 'latest'
+ hugo-version: "latest"
- name: Build
run: |
$environment = "${{ needs.Setup.outputs.nkdAgility_Ring }}".ToLower()
@@ -493,7 +492,6 @@ jobs:
name: AzureDevOpsMigrationTools-Site2
path: ./public/**/*
-
# GitHubRelease
GitHubRelease:
name: "Release to GitHub Releases"
@@ -524,14 +522,14 @@ jobs:
- name: "Package Files"
shell: pwsh
run: |
- Get-ChildItem -Path .\ -Recurse | ForEach-Object { $_.FullName }
+ Get-ChildItem -Path .\ -Recurse | ForEach-Object { $_.FullName }
- name: "Release options"
id: release-options
shell: pwsh
run: |
- if ($Env:nkdAgility_Ring -eq 'Production') {
- echo "discussion_category_name=Releases" >> $env:GITHUB_OUTPUT
- }
+ if ($Env:nkdAgility_Ring -eq 'Production') {
+ echo "discussion_category_name=Releases" >> $env:GITHUB_OUTPUT
+ }
- name: Release
uses: softprops/action-gh-release@v2
with:
@@ -567,7 +565,7 @@ jobs:
append_body: true
-# ElmahDeployment
+ # ElmahDeployment
ElmahDeployemnt:
name: "Create Elmah.io Deployment"
runs-on: ubuntu-latest
@@ -577,13 +575,12 @@ jobs:
# Only when app was released
if: ${{ success() && needs.Setup.outputs.nkdAgility_RunRelease == 'true' }}
steps:
- - name: Create Deployment on elmah.io
- uses: elmahio/github-create-deployment-action@v1
- with:
- apiKey: ${{ secrets.ELMAH_IO_API_KEY }}
- version: ${{ needs.Setup.outputs.GitVersion_SemVer }}
- logId: ${{ secrets.ELMAH_IO_LOG_ID }}
-
+ - name: Create Deployment on elmah.io
+ uses: elmahio/github-create-deployment-action@v1
+ with:
+ apiKey: ${{ secrets.ELMAH_IO_API_KEY }}
+ version: ${{ needs.Setup.outputs.GitVersion_SemVer }}
+ logId: ${{ secrets.ELMAH_IO_LOG_ID }}
# Release to Marketplace
MarketplaceRelease:
@@ -599,21 +596,20 @@ jobs:
- name: "Find files"
shell: pwsh
run: |
- Get-Item -Path .\
- Write-Output "Build Files"
- Get-ChildItem -Path .\ -Recurse -Filter '*.ps1' | ForEach-Object { $_.FullName }
+ Get-Item -Path .\
+ Write-Output "Build Files"
+ Get-ChildItem -Path .\ -Recurse -Filter '*.ps1' | ForEach-Object { $_.FullName }
- name: "Marketplace"
shell: pwsh
run: |
- $vsixFile = Get-ChildItem -Path .\ -Recurse -Filter '*.vsix'
- if ($vsixFile -eq $null) {
- Write-Output "No VSIX file found"
- exit 1
- } else {
- Write-Output $"Running with {$vsixFile}"
- }
- .\build\releaseExtension.ps1 -vsixFile $vsixFile.FullName -marketplaceToken ${{ secrets.VS_MARKET_TOKEN }}
-
+ $vsixFile = Get-ChildItem -Path .\ -Recurse -Filter '*.vsix'
+ if ($vsixFile -eq $null) {
+ Write-Output "No VSIX file found"
+ exit 1
+ } else {
+ Write-Output $"Running with {$vsixFile}"
+ }
+ .\build\releaseExtension.ps1 -vsixFile $vsixFile.FullName -marketplaceToken ${{ secrets.VS_MARKET_TOKEN }}
# Release to Chocolatey
ChocolateyRelease:
@@ -629,16 +625,15 @@ jobs:
- name: "Choco"
shell: pwsh
run: |
- $chocoFile = Get-ChildItem -Path .\ -Recurse -Filter 'vsts-sync-migrator.${{ needs.Setup.outputs.GitVersion_NuGetVersion }}.nupkg'
- if ($chocoFile -eq $null) {
- Write-Output "No Choco file found"
- exit 1
- } else {
- Write-Output $"Running with {$chocoFile}"
- }
- Write-Output 'choco push "$chocoFile" --key "${{ secrets.CHOCO_APIKEY }}" --source "https://push.chocolatey.org/"'
- choco push "$chocoFile" --key "${{ secrets.CHOCO_APIKEY }}" --source "https://push.chocolatey.org/"
-
+ $chocoFile = Get-ChildItem -Path .\ -Recurse -Filter 'vsts-sync-migrator.${{ needs.Setup.outputs.GitVersion_NuGetVersion }}.nupkg'
+ if ($chocoFile -eq $null) {
+ Write-Output "No Choco file found"
+ exit 1
+ } else {
+ Write-Output $"Running with {$chocoFile}"
+ }
+ Write-Output 'choco push "$chocoFile" --key "${{ secrets.CHOCO_APIKEY }}" --source "https://push.chocolatey.org/"'
+ choco push "$chocoFile" --key "${{ secrets.CHOCO_APIKEY }}" --source "https://push.chocolatey.org/"
# Release to Winget
WingetRelease:
@@ -654,13 +649,13 @@ jobs:
- name: "Find files"
shell: pwsh
run: |
- Get-Item -Path .\
- Write-Output "Build Files"
- Get-ChildItem -Path .\ -Recurse -Filter '*.ps1' | ForEach-Object { $_.FullName }
+ Get-Item -Path .\
+ Write-Output "Build Files"
+ Get-ChildItem -Path .\ -Recurse -Filter '*.ps1' | ForEach-Object { $_.FullName }
- name: "Winget Release"
shell: pwsh
run: |
- .\build\releaseWingetPackage.ps1 -version ${{ needs.Setup.outputs.GitVersion_SemVer }} -ring ${{needs.Setup.outputs.nkdAgility_Ring}} -GH_TOKEN ${{ secrets.NKD_MRHINSH_TOKEN }}
+ .\build\releaseWingetPackage.ps1 -version ${{ needs.Setup.outputs.GitVersion_SemVer }} -ring ${{needs.Setup.outputs.nkdAgility_Ring}} -GH_TOKEN ${{ secrets.NKD_MRHINSH_TOKEN }}
# Release to Docs
DocsRelease:
@@ -678,7 +673,7 @@ jobs:
- name: "Find files"
shell: pwsh
run: |
- Get-Item -Path .\
+ Get-Item -Path .\
- uses: actions/create-github-app-token@v1
id: app-token
with:
@@ -690,15 +685,15 @@ jobs:
id: azureDeploy
with:
repo_token: ${{ steps.app-token.outputs.token }}
- action: 'upload'
+ action: "upload"
app_location: ./_site2
skip_app_build: true
skip_api_build: true
- output_location: ''
+ output_location: ""
deployment_environment: ${{ (needs.Setup.outputs.nkdAgility_AzureSitesEnvironment) }}
azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
- - name: 'Show Summery'
+ - name: "Show Summery"
if: always()
shell: pwsh
id: nkdagility-summery
diff --git a/.powershell/docs/Get-DiscussionId.ps1 b/.powershell/docs/Get-DiscussionId.ps1
index 9b9fba98f..eb58f6df7 100644
--- a/.powershell/docs/Get-DiscussionId.ps1
+++ b/.powershell/docs/Get-DiscussionId.ps1
@@ -529,7 +529,7 @@ function Find-OrCreateDiscussion {
if (-not $docCategory) {
Write-ErrorLog "Documentation category '$GitHubDiscussionCategory' not found"
Write-InformationLog "Available categories: $($categories.name -join ', ')"
- return $null
+ exit 1
}
# Generate documentation URL
diff --git a/docs/content/docs/config/_index.md b/docs/content/docs/config/_index.md
index fac372c29..33d3454b6 100644
--- a/docs/content/docs/config/_index.md
+++ b/docs/content/docs/config/_index.md
@@ -5,4 +5,7 @@ description: |
short_title: Configuration
weight: 50
date: 2025-06-24T12:07:31Z
+discussionId: 2904
+
---
+
diff --git a/docs/content/docs/config/config-wizard/index.md b/docs/content/docs/config/config-wizard/index.md
index 8d39a3d26..f1fb9494c 100644
--- a/docs/content/docs/config/config-wizard/index.md
+++ b/docs/content/docs/config/config-wizard/index.md
@@ -4,20 +4,20 @@ short_title: Config Wizard
description: Build your Azure DevOps Migration Tools configuration with our interactive step-by-step wizard supporting three migration type architectures
weight: 50
date: 2025-06-26T12:00:00Z
-discussionId:
+discussionId: 2902
aliases:
- - /config-wizard/
- - /wizard/
- - /configure/
+- /config-wizard/
+- /wizard/
+- /configure/
layout: config-wizard
cascade:
- - build:
- list: never
- render: never
- target:
- environment: production
----
+- build:
+ list: never
+ render: never
+ target:
+ environment: production
+---
Use this interactive wizard to build your Azure DevOps Migration Tools configuration. The wizard supports three primary migration types:
- **Work Items**: Standard work item migration with pre-configured TfsWorkItemEndpoint and TfsWorkItemMigrationProcessor
diff --git a/docs/content/docs/config/schema/index.md b/docs/content/docs/config/schema/index.md
index 6cb738411..b789e3716 100644
--- a/docs/content/docs/config/schema/index.md
+++ b/docs/content/docs/config/schema/index.md
@@ -1,12 +1,16 @@
---
-title: "JSON Schemas"
-description: "JSON Schema definitions for Azure DevOps Migration Tools configuration"
+title: JSON Schemas
+description: JSON Schema definitions for Azure DevOps Migration Tools configuration
weight: 10
-outputs: ["html", "schema-catalog"]
+outputs:
+- html
+- schema-catalog
aliases:
- - /schema/
----
+- /schema/
+date: 2025-07-23T09:41:21Z
+discussionId: 2901
+---
The Azure DevOps Migration Tools provide JSON Schema definitions for configuration validation and IDE support.
## Main Configuration Schema
diff --git a/docs/content/docs/reference/processors/tfs-workitemtype-validator-processor/index.md b/docs/content/docs/reference/processors/tfs-workitemtype-validator-processor/index.md
new file mode 100644
index 000000000..e94d3d015
--- /dev/null
+++ b/docs/content/docs/reference/processors/tfs-workitemtype-validator-processor/index.md
@@ -0,0 +1,41 @@
+---
+title: Tfs WorkItemType Validator Processor
+description: Validates Work Item Types against a set of rules. Does not migrate Work Items, only validates types.
+dataFile: reference.processors.tfsworkitemtypevalidatorprocessor.yaml
+slug: tfs-workitem-type-validator-processor
+aliases:
+- /docs/Reference/Processors/TfsWorkItemTypeValidatorProcessor
+- /Reference/Processors/TfsWorkItemTypeValidatorProcessor
+- /learn/azure-devops-migration-tools/Reference/Processors/TfsWorkItemTypeValidatorProcessor
+- /learn/azure-devops-migration-tools/Reference/Processors/TfsWorkItemTypeValidatorProcessor/index.md
+date: 2025-06-24T12:07:31Z
+discussionId: 2905
+
+---
+{{< class-description >}}
+
+## Options
+
+{{< class-options >}}
+
+## Samples
+
+### Sample
+
+{{< class-sample sample="sample" >}}
+
+### Defaults
+
+{{< class-sample sample="defaults" >}}
+
+### Classic
+
+{{< class-sample sample="classic" >}}
+
+## Metadata
+
+{{< class-metadata >}}
+
+## Schema
+
+{{< class-schema >}}
diff --git a/docs/content/docs/reference/tools/tfs-workitemtype-validator-tool/index.md b/docs/content/docs/reference/tools/tfs-workitemtype-validator-tool/index.md
new file mode 100644
index 000000000..e5cf6ce58
--- /dev/null
+++ b/docs/content/docs/reference/tools/tfs-workitemtype-validator-tool/index.md
@@ -0,0 +1,42 @@
+---
+title: Tfs WorkItemType Validator Tool
+description: Validates Work Item Types against a set of rules. Does not migrate Work Items, only validates types.
+dataFile: reference.tools.tfsworkitemtypevalidatortool.yaml
+schemaFile: schema.tools.tfsworkitemtypevalidatortool.json
+slug: work-item-type-validator-tool
+aliases:
+- /docs/Reference/Tools/WorkItemTypeValidatorTool
+- /Reference/Tools/WorkItemTypeValidatorTool
+- /learn/azure-devops-migration-tools/Reference/Tools/WorkItemTypeValidatorTool
+- /learn/azure-devops-migration-tools/Reference/Tools/WorkItemTypeMappingTool/index.md
+date: 2025-06-24T12:07:31Z
+discussionId: 2903
+
+---
+{{< class-description >}}
+
+## Options
+
+{{< class-options >}}
+
+## Samples
+
+### Sample
+
+{{< class-sample sample="sample" >}}
+
+### Defaults
+
+{{< class-sample sample="defaults" >}}
+
+### Classic
+
+{{< class-sample sample="classic" >}}
+
+## Metadata
+
+{{< class-metadata >}}
+
+## Schema
+
+{{< class-schema >}}
diff --git a/docs/data/classes/reference.processors.keepoutboundlinktargetprocessor.yaml b/docs/data/classes/reference.processors.keepoutboundlinktargetprocessor.yaml
index cbddba47c..60e10e5f8 100644
--- a/docs/data/classes/reference.processors.keepoutboundlinktargetprocessor.yaml
+++ b/docs/data/classes/reference.processors.keepoutboundlinktargetprocessor.yaml
@@ -20,7 +20,7 @@ configurationSamples:
"Enabled": false,
"WIQLQuery": "Select [System.Id] From WorkItems Where [System.TeamProject] = @project and not [System.WorkItemType] contains 'Test Suite, Test Plan,Shared Steps,Shared Parameter,Feedback Request'",
"TargetLinksToKeepOrganization": "https://dev.azure.com/nkdagility",
- "TargetLinksToKeepProject": "10464ecf-816d-4fca-a547-81f230b9069a",
+ "TargetLinksToKeepProject": "916bd342-1db7-45e3-bef1-a370734362a4",
"CleanupFileName": "c:/temp/OutboundLinkTargets.bat",
"PrependCommand": "start",
"DryRun": true,
diff --git a/docs/data/classes/reference.processors.tfsworkitemtypevalidatorprocessor.yaml b/docs/data/classes/reference.processors.tfsworkitemtypevalidatorprocessor.yaml
new file mode 100644
index 000000000..943432e10
--- /dev/null
+++ b/docs/data/classes/reference.processors.tfsworkitemtypevalidatorprocessor.yaml
@@ -0,0 +1,49 @@
+optionsClassName: TfsWorkItemTypeValidatorProcessorOptions
+optionsClassFullName: MigrationTools.Processors.TfsWorkItemTypeValidatorProcessorOptions
+configurationSamples:
+- name: defaults
+ order: 2
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.TfsWorkItemTypeValidatorProcessorOptions
+- name: sample
+ order: 1
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.TfsWorkItemTypeValidatorProcessorOptions
+- name: classic
+ order: 3
+ description:
+ code: >-
+ {
+ "$type": "TfsWorkItemTypeValidatorProcessorOptions",
+ "Enabled": false,
+ "StopIfValidationFails": true,
+ "SourceName": null,
+ "TargetName": null
+ }
+ sampleFor: MigrationTools.Processors.TfsWorkItemTypeValidatorProcessorOptions
+description: Work item type validation processor. Basically it just runs the to validate work item types. The validation is run always, even if the tool iself is disabled. Neither this processor, nor the tool do not perform any changes to the source or target system.
+className: TfsWorkItemTypeValidatorProcessor
+typeName: Processors
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missing XML code comments
+- parameterName: SourceName
+ type: String
+ description: This is the `IEndpoint` that will be used as the source of the Migration. Can be null for a write only processor.
+ defaultValue: missing XML code comments
+- parameterName: StopIfValidationFails
+ type: Boolean
+ description: If set to , migration process will stop if there are some validation errors. If set to , migration process will continue, for example to support some other validation processors. Default value is .
+ defaultValue: missing XML code comments
+- parameterName: TargetName
+ type: String
+ description: This is the `IEndpoint` that will be used as the Target of the Migration. Can be null for a read only processor.
+ defaultValue: missing XML code comments
+status: missing XML code comments
+processingTarget: missing XML code comments
+classFile: src/MigrationTools.Clients.TfsObjectModel/Processors/TfsWorkItemTypeValidatorProcessor.cs
+optionsClassFile: src/MigrationTools.Clients.TfsObjectModel/Processors/TfsWorkItemTypeValidatorProcessorOptions.cs
diff --git a/docs/hugo.yaml b/docs/hugo.yaml
index f9acd6de5..63fca886f 100644
--- a/docs/hugo.yaml
+++ b/docs/hugo.yaml
@@ -35,6 +35,7 @@ params:
keywords: "Azure DevOps, Migration Tools, DevOps, Migration"
og_image: "/images/og-image.jpg" # URL to the default Open Graph image
siteProdUrl: "https://devopsmigration.io"
+ sitePreviewUrl: "https://blue-river-093197403-preview.westeurope.5.azurestaticapps.net"
supportEmail: "support@devopsmigration.io"
githubUrl: "https://github.com/nkdAgility/azure-devops-migration-tools"
editPage: "https://github.com/nkdAgility/azure-devops-migration-tools/tree/main/docs/content/"
diff --git a/docs/layouts/_partials/components/menu-version.html b/docs/layouts/_partials/components/menu-version.html
new file mode 100644
index 000000000..f45f93037
--- /dev/null
+++ b/docs/layouts/_partials/components/menu-version.html
@@ -0,0 +1,106 @@
+
+
+
+
+
+
+
diff --git a/docs/layouts/_partials/components/menu.html b/docs/layouts/_partials/components/menu.html
index 52b7c1d38..c5b31ef6c 100644
--- a/docs/layouts/_partials/components/menu.html
+++ b/docs/layouts/_partials/components/menu.html
@@ -32,102 +32,28 @@
-
-
-
-
-
-
-
-
-
-
-
+
-
-
-
-
-
+
+
+
+ {{ partial "components/menu-version.html" . }}
+
+
+
+
} - The version string
+ */
+async function getVersion(url) {
+ // Check cache first
+ const cached = versionCache.get(url);
+ if (cached && Date.now() - cached.timestamp < CACHE_DURATION) {
+ console.log("Returning cached version for:", url);
+ return cached.version;
+ }
+
+ try {
+ console.log("Fetching fresh version from:", url);
+ const response = await fetch(url);
+
+ if (!response.ok) {
+ throw new Error(`HTTP error! status: ${response.status}`);
+ }
+
+ const data = await response.json();
+
+ // Cache the result
+ versionCache.set(url, {
+ version: data.version,
+ timestamp: Date.now(),
+ });
+
+ return data.version;
+ } catch (error) {
+ console.error("Error fetching version:", error);
+ throw error;
+ }
+}
+
+// Export functions for use in modules or other scripts
+if (typeof module !== "undefined" && module.exports) {
+ module.exports = {
+ getVersion,
+ };
+}
diff --git a/docs/static/schema/configuration.schema.json b/docs/static/schema/configuration.schema.json
index 5d02a0cbb..66c6b0dc2 100644
--- a/docs/static/schema/configuration.schema.json
+++ b/docs/static/schema/configuration.schema.json
@@ -913,6 +913,35 @@
}
}
},
+ {
+ "title": "TfsWorkItemTypeValidatorProcessor",
+ "description": "Work item type validation processor. Basically it just runs the to validate work item types. The validation is run always, even if the tool iself is disabled. Neither this processor, nor the tool do not perform any changes to the source or target system.",
+ "type": "object",
+ "properties": {
+ "enabled": {
+ "description": "If set to `true` then the processor will run. Set to `false` and the processor will not run.",
+ "type": "boolean"
+ },
+ "sourceName": {
+ "description": "This is the `IEndpoint` that will be used as the source of the Migration. Can be null for a write only processor.",
+ "type": "string"
+ },
+ "stopIfValidationFails": {
+ "description": "If set to , migration process will stop if there are some validation errors. If set to , migration process will continue, for example to support some other validation processors. Default value is .",
+ "type": "boolean"
+ },
+ "targetName": {
+ "description": "This is the `IEndpoint` that will be used as the Target of the Migration. Can be null for a read only processor.",
+ "type": "string"
+ },
+ "processorType": {
+ "type": "string",
+ "enum": [
+ "TfsWorkItemTypeValidatorProcessor"
+ ]
+ }
+ }
+ },
{
"title": "WorkItemTrackingProcessor",
"description": "This processor is intended, with the aid of [ProcessorEnrichers](../ProcessorEnrichers/index.md), to allow the migration of Work Items between two [Endpoints](../Endpoints/index.md).",
diff --git a/docs/static/schema/schema.processors.tfsworkitemtypevalidatorprocessor.json b/docs/static/schema/schema.processors.tfsworkitemtypevalidatorprocessor.json
new file mode 100644
index 000000000..5d50182c1
--- /dev/null
+++ b/docs/static/schema/schema.processors.tfsworkitemtypevalidatorprocessor.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://devopsmigration.io/schema/schema.processors.tfsworkitemtypevalidatorprocessor.json",
+ "title": "TfsWorkItemTypeValidatorProcessor",
+ "description": "Work item type validation processor. Basically it just runs the to validate work item types. The validation is run always, even if the tool iself is disabled. Neither this processor, nor the tool do not perform any changes to the source or target system.",
+ "type": "object",
+ "properties": {
+ "enabled": {
+ "description": "If set to `true` then the processor will run. Set to `false` and the processor will not run.",
+ "type": "boolean"
+ },
+ "sourceName": {
+ "description": "This is the `IEndpoint` that will be used as the source of the Migration. Can be null for a write only processor.",
+ "type": "string"
+ },
+ "stopIfValidationFails": {
+ "description": "If set to , migration process will stop if there are some validation errors. If set to , migration process will continue, for example to support some other validation processors. Default value is .",
+ "type": "boolean"
+ },
+ "targetName": {
+ "description": "This is the `IEndpoint` that will be used as the Target of the Migration. Can be null for a read only processor.",
+ "type": "string"
+ }
+ }
+}
\ No newline at end of file
diff --git a/docs/static/version.json b/docs/static/version.json
new file mode 100644
index 000000000..fa2b442a2
--- /dev/null
+++ b/docs/static/version.json
@@ -0,0 +1,3 @@
+{
+ "version": "#{GitVersion.SemVer}#"
+}
diff --git a/test-categories.ps1 b/test-categories.ps1
new file mode 100644
index 000000000..e69de29bb
diff --git a/test-github-permissions.ps1 b/test-github-permissions.ps1
new file mode 100644
index 000000000..e69de29bb