Add Maven Central publishing configuration, update npm build output handling, and enhance documentation

Author: CoderYellow

.gitignore

@@ -27,3 +27,5 @@ yarn-error.log*
 /buildSrc/build
 /.gradle
 
+/.build.env
+/frontend-build/

README.md

@@ -25,6 +25,7 @@ npm start
 ```
 
 The app uses `REACT_APP_API_BASE_URL=http://localhost:9090/api` in local development.
+The login flow is token-based: the UI calls the mock login API, stores the returned token, and sends it as a bearer token on later API calls.
 
 ## Gradle
 
@@ -43,19 +44,42 @@ Available Gradle tasks:
 ./gradlew npmBuild
 ./gradlew npmTest
 ./gradlew npmStart
+./gradlew frontendJar
+./gradlew frontendSourcesJar
+./gradlew assemble
+./gradlew release --no-configuration-cache
 ```
 
 The Node integration is configured to use the local Node runtime from `nvm` rather than downloading a separate Node distribution.
 
+Archive outputs:
+
+- `frontendJar`: packages the npm `build/` output as the main JAR artifact
+- `frontendSourcesJar`: packages all git-tracked files as the sources JAR
+
+`frontendSourcesJar` uses `git ls-files`, so if Gradle reports configuration-cache incompatibility, run it with:
+
+```bash
+./gradlew frontendSourcesJar --no-configuration-cache
+```
+
+Project versioning is driven by `gradle.properties`.
+
 ## Mock APIs
 
 WireMock mappings live in [`wiremock/mappings`](/data/Git/error-sense-ui/wiremock/mappings).
 
-- `GET /api/developer-reports`
-- `GET /api/reviewer-reports`
-- `PUT /api/reviewer-reports/:id`
+- `POST /api/v1/auth/login`
+- `GET /api/v1/errsense/report/dev-summary`
+- `GET /api/v1/errsense/report/owner-review`
+- `PUT /api/v1/errsense/report/owner-review/:id`
 - Generic `OPTIONS /api/*` preflight handler for local CORS
 
+Mock login response:
+
+- returns a bearer token: `mock-errsense-token`
+- report APIs require `Authorization: Bearer mock-errsense-token`
+
 ## Build
 
 ```bash
@@ -68,6 +92,42 @@ Or with Gradle:
 ./gradlew npmBuild
 ```
 
+## Publishing
+
+The Gradle build is configured for Maven Central publishing with:
+
+- `maven-publish`
+- `signing`
+- `io.github.gradle-nexus.publish-plugin`
+- `net.researchgate.release`
+
+Publish flow:
+
+```bash
+./gradlew publishToSonatype closeAndReleaseSonatypeStagingRepository --no-configuration-cache
+```
+
+Required environment variables:
+
+- `OSSRH_USERNAME`
+- `OSSRH_PASSWORD`
+- `SIGNING_KEY_FILE`
+- `SIGNING_KEY_PASSWORD`
+
+Release flow:
+
+```bash
+./gradlew release --no-configuration-cache
+```
+
+The release plugin:
+
+- reads and updates the version from `gradle.properties`
+- publishes to Sonatype
+- closes and releases the Sonatype staging repository
+- creates a Git tag using `<project-name>-<version>`
+- requires releases to run from the `master` branch
+
 ## Docker
 
 This project uses a standard multi-stage Docker build for container images. Jib is not the recommended path for this frontend-only repo.
@@ -101,3 +161,13 @@ Login example:
 ```bash
 echo "$GITHUB_TOKEN" | docker login ghcr.io -u YOUR_GITHUB_USERNAME --password-stdin
 ```
+
+## GitHub Actions
+
+GitHub Actions builds and pushes the container image to GHCR using the first 8 characters of the commit SHA as the tag.
+
+Example tag:
+
+```text
+ghcr.io/openprojectx/error-sense-ui:5a9619ee
+```

build.gradle.kts

@@ -1,14 +1,88 @@
+import net.researchgate.release.ReleaseExtension
+
 plugins {
+    `maven-publish`
+    signing
+    id("io.github.gradle-nexus.publish-plugin") version "2.0.0"
+    id("net.researchgate.release") version "3.1.0"
     id("node-frontend")
     id("frontend-archive")
     id("frontend-jib")
 }
 
 group = "org.openprojectx.ai"
-version = "0.1.0-SNAPSHOT"
 
 allprojects {
     repositories {
         mavenCentral()
     }
 }
+
+publishing {
+    publications {
+        create<MavenPublication>("mavenFrontend") {
+            artifactId = project.name
+            artifact(tasks.named("frontendJar"))
+            artifact(tasks.named("frontendSourcesJar"))
+
+            pom {
+                name.set(project.name)
+                description.set("React frontend for the Error Sense dashboard")
+                url.set("https://github.com/openprojectx/error-sense-ui")
+
+                licenses {
+                    license {
+                        name.set("Apache License 2.0")
+                        url.set("https://www.apache.org/licenses/LICENSE-2.0")
+                    }
+                }
+
+                developers {
+                    developer {
+                        id.set("openprojectx")
+                        name.set("OpenProjectX")
+                        email.set("admin@openprojectx.org")
+                    }
+                }
+
+                scm {
+                    url.set("https://github.com/openprojectx/error-sense-ui")
+                    connection.set("scm:git:https://github.com/openprojectx/error-sense-ui.git")
+                    developerConnection.set("scm:git:ssh://git@github.com:openprojectx/error-sense-ui.git")
+                }
+            }
+        }
+    }
+}
+
+signing {
+    val keyFile = System.getenv("SIGNING_KEY_FILE")
+    val keyPass = System.getenv("SIGNING_KEY_PASSWORD")
+
+    if (!keyFile.isNullOrBlank()) {
+        val keyText = file(keyFile).readText()
+        useInMemoryPgpKeys(keyText, keyPass)
+        sign(publishing.publications)
+    }
+}
+
+nexusPublishing {
+    repositories {
+        sonatype {
+            nexusUrl.set(uri("https://ossrh-staging-api.central.sonatype.com/service/local/"))
+            snapshotRepositoryUrl.set(uri("https://central.sonatype.com/repository/maven-snapshots/"))
+            username.set(System.getenv("OSSRH_USERNAME"))
+            password.set(System.getenv("OSSRH_PASSWORD"))
+        }
+    }
+}
+
+configure<ReleaseExtension> {
+    buildTasks.set(listOf("publishToSonatype", "closeAndReleaseSonatypeStagingRepository"))
+    versionPropertyFile.set("gradle.properties")
+    tagTemplate.set("\$name-\$version")
+
+    with(git) {
+        requireBranch.set("master")
+    }
+}

buildSrc/src/main/kotlin/frontend-archive.gradle.kts

@@ -1,5 +1,6 @@
 import org.gradle.jvm.tasks.Jar
 import org.gradle.api.file.DuplicatesStrategy
+import java.io.File
 
 plugins {
     base
@@ -26,24 +27,28 @@ val frontendJar = tasks.register<Jar>("frontendJar") {
     archiveBaseName.set(project.name)
     archiveClassifier.set("")
 
-    from(layout.projectDirectory.dir("build")) {
-        exclude("libs/**")
-        exclude("tmp/**")
+    from(layout.projectDirectory.dir("frontend-build")) {
         into("/")
     }
 }
 
 val frontendSourcesJar = tasks.register<Jar>("frontendSourcesJar") {
     description = "Packages all git-tracked files as a sources JAR."
     group = "build"
+    dependsOn("npmInstall")
     notCompatibleWithConfigurationCache("Uses git ls-files to resolve tracked source inputs.")
 
     archiveBaseName.set(project.name)
     archiveClassifier.set("sources")
     duplicatesStrategy = DuplicatesStrategy.FAIL
 
-    from(layout.projectDirectory) {
-        include(trackedFilePatterns)
+    trackedFilePatterns.forEach { relativePath ->
+        val parentPath = File(relativePath).parent
+        from(layout.projectDirectory.file(relativePath)) {
+            if (parentPath != null) {
+                into(parentPath)
+            }
+        }
     }
 }
 

buildSrc/src/main/kotlin/node-frontend.gradle.kts

@@ -26,6 +26,11 @@ tasks.register<NpmTask>("npmBuild") {
     dependsOn("npmInstall")
     args.set(listOf("run", "build"))
     workingDir.set(projectDir)
+    environment.set(
+        mapOf(
+            "BUILD_PATH" to "frontend-build"
+        )
+    )
 }
 //
 //tasks.register<NpmTask>("npmTest") {