Development -> Master

.gitignore

@@ -24,8 +24,8 @@ bld/
 [Oo]bj/
 [Cc]onfiguration[Cc]ache/
 Publish
-SEBrowser/DynamicAssemblies/
-SEBrowser/Scripts/SEBrowser.js
+PQBrowser/DynamicAssemblies/
+PQBrowser/Scripts/PQBrowser.js
 
 # Visual Studio 2015 cache/options directory
 .vs/
@@ -144,6 +144,10 @@ publish/
 # TODO: Comment the next line if you want to checkin your web deploy settings 
 # but database connection strings (with potential passwords) will be unencrypted
 *.pubxml
+!PQBrowser/Properties/PublishProfiles/Development Profile PQBrowser.pubxml
+!PQBrowser/Properties/PublishProfiles/Release Profile PQBrowser.pubxml
+!PQBrowser/Properties/PublishProfiles/Docker Development Profile PQBrowser.pubxml
+!PQBrowser/Properties/PublishProfiles/Docker Release Profile PQBrowser.pubxml
 *.publishproj
 
 # NuGet Packages
@@ -224,9 +228,9 @@ _Pvt_Extensions
 
 # Ignore files generated by web app in debug mode
 /Publish.zip
-/SEBrowser/NUglify.dll
+/PQBrowser/NUglify.dll
 /Dependencies/NuGet
-/SEBrowser/web.config.backup
-/SEBrowser/Scripts/vendors-node_modules_canvg_lib_index_es_js.js
-/SEBrowser/Scripts/vendors-node_modules_dompurify_dist_purify_js.js
-/SEBrowser/Web.config
+/PQBrowser/web.config.backup
+/PQBrowser/Scripts/vendors-node_modules_canvg_lib_index_es_js.js
+/PQBrowser/Scripts/vendors-node_modules_dompurify_dist_purify_js.js
+/PQBrowser/Web.config

.gitmodules

@@ -1,3 +1,3 @@
-[submodule "SEBrowser/EventWidgets"]
-	path = SEBrowser/EventWidgets
+[submodule "PQBrowser/EventWidgets"]
+	path = PQBrowser/EventWidgets
 	url = https://github.com/GridProtectionAlliance/EventWidgets.git

AGENTS.MD

@@ -0,0 +1,3 @@
+## React/TSX conventions
+
+Before creating, editing, refactoring, or reviewing any `.tsx` file, read and follow `docs/conventions/tsx-conventions.md`.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

Directory.Build.props

@@ -1,5 +1,5 @@
-<Project>
+<Project>
   <PropertyGroup>
-    <GemstoneVersion>1.0.179</GemstoneVersion>
+    <GemstoneVersion>1.0.181</GemstoneVersion>
   </PropertyGroup>
 </Project>

Jenkinsfile

@@ -0,0 +1,326 @@
+import hudson.model.Result
+import jenkins.model.CauseOfInterruption
+import org.jenkinsci.plugins.workflow.steps.FlowInterruptedException
+
+def haltBuildWithSuccess() {
+    currentBuild.rawBuild.@result = Result.SUCCESS
+    def cause = new CauseOfInterruption.UserInterruption("Build halted programmatically with SUCCESS status")
+    throw new FlowInterruptedException(Result.SUCCESS, false, cause)
+}
+
+pipeline {
+    agent any
+
+    environment {
+        github_pat = credentials('github-pat')
+        devBranch = "development"
+        mainBranch = "master"
+        NUGET_PACKAGES = "D:\\NuGetCache"
+    }
+
+    stages {
+        stage('Prepare Environment') {
+            steps {
+                script {
+                    // Set current Version
+                    def fileContent = powershell(returnStdout: true, script:  '''
+                        Get-Content -Path "./Scripts/PQBrowser.version" -Raw
+                    ''').trim()
+                    env.pqBrowserVersion = fileContent
+                    println("PQBrowser version: ${env.pqBrowserVersion}")
+                }
+                script {
+                    //Set current Commit
+                    env.GIT_COMMIT = bat(script: '@git rev-parse HEAD', returnStdout: true).trim()
+                    println("Current Git Commit: ${env.GIT_COMMIT}")
+                }
+                script {
+                    //Get last release from git tags
+                    bat( script: "@git fetch origin ${env.mainBranch}:refs/remotes/origin/${env.mainBranch}")
+                    def mainCommit = bat(script: "@git rev-parse origin/${env.mainBranch}", returnStdout: true).trim()
+
+                    try {
+                        env.LAST_RELEASE_TAG = bat(script: "@git describe --tags --abbrev=0 ${mainCommit}", returnStdout: true).trim()
+                    }
+                    catch (Exception ex) {
+                        println("No tags found, setting LAST_RELEASE_TAG to v3.0.0")
+                        env.LAST_RELEASE_TAG = "v3.0.0"
+                    }
+                    println("Last Release Tag: ${env.LAST_RELEASE_TAG}")
+                }
+            }
+        }
+
+        stage('Check Conditions') {
+            when {
+                anyOf {
+                    not {
+                        anyOf {
+                            expression { env.BRANCH_NAME.startsWith("PR") }
+                            expression { env.BRANCH_NAME == "${env.mainBranch}" }
+                        }
+                    }
+                    allOf {
+                        expression { env.BRANCH_NAME.startsWith("PR") }
+                        expression { env.CHANGE_BRANCH != "${env.devBranch}" }
+                    }
+                    allOf {
+                        expression { env.BRANCH_NAME.startsWith("PR") }
+                        expression { env.CHANGE_TARGET != "${env.mainBranch}" }
+                    }
+                }
+            }
+            steps {
+                haltBuildWithSuccess()
+            }
+        }
+
+        stage('Checkout Master Branch') {
+            when {
+                expression {
+                    return env.BRANCH_NAME == "${env.mainBranch}"
+                }
+            }
+            steps {
+                script {
+                    bat(script: "@git fetch origin ${env.BRANCH_NAME}:refs/remotes/origin/${env.BRANCH_NAME}")
+                    bat(script: "@git checkout origin/${env.BRANCH_NAME}")
+                }
+            }
+        }
+
+        stage('Checkout Development Branch') {
+            when {
+                expression {
+                    return env.CHANGE_BRANCH == "${env.devBranch}"
+                }
+            }
+            steps {
+                script {
+                    bat(script: "@git fetch origin ${env.CHANGE_BRANCH}:refs/remotes/origin/${env.CHANGE_BRANCH}")
+                    bat(script: "@git checkout origin/${env.CHANGE_BRANCH}")
+                }
+            }
+        }
+
+        stage('Checkout Submodules') {
+            steps {
+                bat(script: '@git submodule sync --recursive')
+                bat(script: '@git submodule update --init --recursive')
+                bat(script: '@git submodule status --recursive')
+            }
+        }
+
+        stage('Application Version') {
+            when {
+                expression {
+                    return env.BRANCH_NAME != "${env.mainBranch}"
+                }
+            }
+            steps {
+                script {
+                    env.GIT_COMMIT = bat(script: '@git rev-parse HEAD', returnStdout: true).trim()
+                }
+                powershell "powershell.exe -File .\\Scripts\\Versioning.ps1 -VersionFile './Scripts/PQBrowser.version' -Commit false"
+                bat(script: "@git add Scripts/PQBrowser.version")
+                bat(script: "git diff --cached --quiet || git commit -m \"Updated Version Number\"")
+            }
+        }
+
+        stage('Gemstone Updates') {
+            when {
+                expression {
+                    return env.BRANCH_NAME != "${env.mainBranch}"
+                }
+            }
+            steps {
+                powershell "powershell.exe -File .\\Scripts\\GemstoneUpdates.ps1 -VersionFile './Directory.Build.props'"
+                powershell "powershell.exe -File .\\Scripts\\CreateDependencyPR.ps1 -GithubToken '${github_pat}' -DevelopmentBranchName '${devBranch}'"
+                script {
+                    bat(script: "@git add Directory.Build.props")
+                    // Avoid an empty commit, which would return a failure code when the pointer is current.
+                    bat(script: "git diff --cached --quiet || git commit -m \"Updated Dependencies\"")
+                }
+            }
+        }
+
+        stage('EventWidgets Pointer Update') {
+            when {
+                expression {
+                    return env.BRANCH_NAME != "${env.mainBranch}"
+                }
+            }
+            steps {
+                dir('PQBrowser/EventWidgets') {
+                    bat(script: '@git fetch origin main')
+                    bat(script: '@git checkout origin/main')
+                }
+                script {
+                    bat(script: '@git add PQBrowser/EventWidgets')
+                    // Avoid an empty commit, which would return a failure code when the pointer is current.
+                    bat(script: 'git diff --cached --quiet || git commit -m "Updated EventWidgets Pointer"')
+                }
+            }
+        }
+
+        stage('Push Changes') {
+            when {
+                allOf {
+                    expression {
+                        return env.BRANCH_NAME != "${env.mainBranch}"
+                    }
+                    expression {
+                        return bat(script: '@git rev-parse HEAD', returnStdout: true).trim() != env.GIT_COMMIT
+                    }
+                }
+            }
+            steps {
+                powershell "git push origin HEAD:${env.devBranch}"
+                haltBuildWithSuccess()
+            }
+        }
+
+        stage('Install UI Dependencies') {
+            steps {
+                dir('PQBrowser') {
+                    bat(script: 'npm ci')
+                }
+            }
+        }
+
+        stage('Lint') {
+            when {
+                allOf {
+                    expression {
+                        return env.CHANGE_BRANCH == "${env.devBranch}"
+                    }
+                    expression {
+                        return env.CHANGE_TARGET == "${env.mainBranch}"
+                    }
+                }
+            }
+            steps {
+                dir('PQBrowser') {
+                    bat(script: 'npm run lint')
+                }
+            }
+        }
+
+        stage('Build Production UI') {
+            steps {
+                dir('PQBrowser') {
+                    bat(script: 'npm run build')
+                }
+            }
+        }
+
+        stage('Build Docker Images') {
+            when {
+                anyOf {
+                    expression {
+                        return env.CHANGE_BRANCH == "${env.devBranch}"
+                    }
+                    expression {
+                        return env.BRANCH_NAME == "${env.mainBranch}"
+                    }
+                }
+            }
+            steps {
+                script {
+                    env.pqBrowserDockerTag = env.CHANGE_BRANCH == "${env.devBranch}" ? "${env.pqBrowserVersion}a" : env.pqBrowserVersion
+                    println("Building PQBrowser Docker image tag: pqbrowser:${env.pqBrowserDockerTag}")
+                }
+
+                powershell """
+                    dotnet publish '.\\PQBrowser\\PQBrowser.csproj' `
+                        --configuration Release `
+                        '-p:PublishProfile=Docker Release Profile PQBrowser'
+                """
+
+                powershell "docker build --build-arg CONFIGURATION=Release -f .\\PQBrowser.dockerfile -t pqbrowser:${env.pqBrowserDockerTag} ."
+            }
+        }
+
+        stage('Publish Application') {
+            steps {
+                powershell """
+                    dotnet publish '.\\PQBrowser\\PQBrowser.csproj' `
+                        '-p:PublishProfile=Release Profile PQBrowser'
+                """
+            }
+        }
+
+        stage('Package Application') {
+            steps {
+                script {
+                    if (!env.WEBHOST_DELIVERY_DIRECTORY?.trim()) {
+                        error('WEBHOST_DELIVERY_DIRECTORY is not configured in Jenkins.')
+                    }
+
+                    env.archiveName = env.BRANCH_NAME == "${env.mainBranch}" ?
+                        "PQBrowser_v${env.pqBrowserVersion}.zip" :
+                        "PQBrowser_v${env.pqBrowserVersion}a.zip"
+                }
+                powershell """
+                    [xml]\$publishProfile = Get-Content `
+                        -LiteralPath '.\\PQBrowser\\Properties\\PublishProfiles\\Release Profile PQBrowser.pubxml' `
+                        -Raw
+                    \$publishDir = (\$publishProfile.Project.PropertyGroup |
+                        Where-Object { \$_.PublishDir }).PublishDir
+
+                    Compress-Archive `
+                        -Path (Join-Path '.\\PQBrowser' "\$publishDir*") `
+                        -DestinationPath '${WORKSPACE}\\${env.archiveName}' `
+                        -Force
+                """
+            }
+        }
+
+        stage('Comment Prerelease') {
+            when {
+                expression {
+                    return env.CHANGE_BRANCH == "${env.devBranch}"
+                }
+            }
+            steps {
+                powershell """
+                    powershell.exe -File .\\Scripts\\GithubComment.ps1 `
+                        -Comment 'Prerelease PQBrowser v${env.pqBrowserVersion}a is available.' `
+                        -BranchName '${env.devBranch}' `
+                        -GithubToken '${github_pat}' `
+                        -RepoOwner 'GridProtectionAlliance' `
+                        -RepoName 'SEBrowser'
+                """
+            }
+        }
+
+        stage('Deploy Prerelease') {
+            when {
+                expression {
+                    return env.CHANGE_BRANCH == "${env.devBranch}"
+                }
+            }
+            steps {
+                powershell "Move-Item -Path '${WORKSPACE}\\${env.archiveName}' -Destination '${env.WEBHOST_DELIVERY_DIRECTORY}\\PQBrowser\\PreRelease\\${env.archiveName}' -Force"
+            }
+        }
+
+        stage('Deploy Release') {
+            when {
+                allOf {
+                    expression {
+                        return env.BRANCH_NAME == "${env.mainBranch}"
+                    }
+                    expression {
+                        return "v${env.pqBrowserVersion}" != env.LAST_RELEASE_TAG
+                    }
+                }
+            }
+            steps {
+                powershell "Move-Item -Path '${WORKSPACE}\\${env.archiveName}' -Destination '${env.WEBHOST_DELIVERY_DIRECTORY}\\PQBrowser\\${env.archiveName}' -Force"
+                powershell "git tag -a v${env.pqBrowserVersion} -m 'Version ${env.pqBrowserVersion} release'"
+                powershell "git push origin --tags"
+            }
+        }
+    }
+}