OSMT Update 2026

.cursorrules

@@ -0,0 +1,49 @@
+you are an expert Angular programmer using TypeScript, Angular 18 and Jest that focuses on producing clear, readable code.
+
+this project uses SDKMAN for Java/Kotlin/Maven version management. ensure you run `sdk env install` or `sdk env` to load the versions specified in .sdkmanrc before building or running the project.
+
+RUN TESTS before telling the user that you're done.
+
+run format:check before committing (ui/: npm run format:check). run prettier --write to fix any issues.
+
+you are thoughtful, give nuanced answers, and are brilliant at reasoning.
+
+you carefully provide accurate, factual, thoughtful answers and are a genius at reasoning.
+
+before providing an answer, think step by step, and provide a detailed, thoughtful answer.
+
+if you need more information, ask for it.
+
+write tests for your code.
+
+break down complex problems into smaller, more manageable pieces.
+
+place most abstract / general functions first in files.
+
+prefer a one-concept-per-file approach with a matching .spec.ts file.
+
+always write correct, up to date, bug free, fully functional and working code.
+
+focus on performance, readability, and maintainability.
+
+before providing an answer, double check your work
+
+include all required imports, and ensure proper naming of key components
+
+do not nest code more than 2 levels deep
+
+code should obey the rules defined in the .eslintrc.json, .prettierrc, .htmlhintrc, and .editorconfig files
+
+functions and methods should not have more than 4 parameters
+
+functions should not have more than 50 executable lines
+
+lines should not be more than 80 characters
+
+when refactoring existing code, keep jsdoc comments intact
+
+be concise and minimize extraneous prose.
+
+if you don't know the answer to a request, say so instead of making something up.
+
+linting: configure ktlint in .editorconfig, not in mvn.xml

.dockerignore

@@ -0,0 +1,8 @@
+Dockerfile
+/ui/node_modules
+/ui/reports
+/ui/.angular
+
+# Exclude previously built artifacts
+/ui/dist
+/api/target

.editorconfig

@@ -0,0 +1,27 @@
+# Editor configuration, see https://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{ts,js,json,html,scss,css}]
+indent_size = 2
+
+[*.{kt,kts}]
+indent_size = 4
+max_line_length = 100
+ktlint_standard_no-wildcard-imports = disabled
+ktlint_standard_property-naming = disabled
+
+[**/test/**/*.{kt,kts}]
+ktlint_standard_max-line-length = off
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false
+
+[*/target/**]
+ktlint_standard = disabled

.github/workflows/ci.yml

@@ -0,0 +1,176 @@
+name: CI Validation
+
+on:
+  pull_request:
+    branches:
+      - "main"
+      - "feature/*"
+      - "renovate/*"
+
+jobs:
+  version-check:
+    name: Version Consistency Check
+    runs-on: ubuntu-latest
+    if: |
+      github.event.pull_request.draft == false && (
+        contains(github.event.pull_request.head.ref, 'skip-ci') == false
+      )
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Validate version consistency
+        run: |
+          chmod +x bin/validate-versions.sh
+          bin/validate-versions.sh
+
+  ui-build-test:
+    name: UI Build & Tests
+    runs-on: ubuntu-latest
+    if: |
+      github.event.pull_request.draft == false && (
+        contains(github.event.pull_request.head.ref, 'skip-ci') == false
+      )
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: ".nvmrc"
+          cache: "npm"
+          cache-dependency-path: ui/package-lock.json
+
+      - name: Install dependencies
+        working-directory: ui
+        run: npm ci
+
+      - name: Build UI
+        id: ui-build
+        working-directory: ui
+        run: |
+          echo "::group::Building UI"
+          npm run build-prod
+          echo "::endgroup::"
+
+      - name: Validation (format check)
+        id: ui-validation
+        working-directory: ui
+        run: |
+          echo "::group::Validating code format"
+          npm run format:check
+          echo "::endgroup::"
+
+      - name: Lint UI
+        id: ui-lint
+        working-directory: ui
+        run: |
+          echo "::group::Linting UI code"
+          npm run lint
+          echo "::endgroup::"
+
+      - name: Test UI
+        id: ui-test
+        working-directory: ui
+        run: |
+          echo "::group::Running UI tests"
+          npm run ci-test
+          echo "::endgroup::"
+
+  api-build-test:
+    name: API Build & Tests
+    runs-on: ubuntu-latest
+    if: |
+      github.event.pull_request.draft == false && (
+        contains(github.event.pull_request.head.ref, 'skip-ci') == false
+      )
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: "21"
+          distribution: "temurin"
+          cache: "maven"
+
+      - name: Setup SDKMAN
+        uses: sdkman/sdkman-action@master
+        with:
+          candidate: maven
+          version: "3.9.6"
+
+      - name: Maven version
+        run: mvn -version
+
+      - name: Build API module
+        id: api-build
+        run: |
+          echo "::group::Building API module"
+          mvn clean install -pl api -am --batch-mode
+          echo "::endgroup::"
+
+      - name: Run API unit tests
+        id: api-tests
+        run: |
+          echo "::group::Running API unit tests"
+          mvn test -pl api --batch-mode
+          echo "::endgroup::"
+
+#  integration-tests:
+#    name: Integration Tests
+#    runs-on: ubuntu-latest
+#    needs: [ ui-build-test, api-build-test ]
+#    if: |
+#      github.event.pull_request.draft == false && (
+#        contains(github.event.pull_request.head.ref, 'skip-ci') == false
+#      )
+#
+#    steps:
+#      - name: Checkout code
+#        uses: actions/checkout@v4
+#
+#      - name: Set up JDK 21
+#        uses: actions/setup-java@v4
+#        with:
+#          java-version: "21"
+#          distribution: "temurin"
+#          cache: "maven"
+#
+#      - name: Setup SDKMAN
+#        uses: sdkman/sdkman-action@master
+#        with:
+#          candidate: maven
+#          version: "3.9.6"
+#
+#      - name: Maven version
+#        run: mvn -version
+#
+#      - name: Build API and test modules
+#        id: build-all
+#        run: |
+#          echo "::group::Building API and test modules"
+#          mvn clean install -pl api,test -am -DskipTests --batch-mode
+#          echo "::endgroup::"
+#
+#      - name: Run API integration tests
+#        id: integration-tests
+#        run: |
+#          echo "::group::Running API integration tests"
+#          mvn verify -pl test -Prun-api-tests --batch-mode
+#          echo "::endgroup::"
+#        env:
+#          OAUTH_CLIENTID: "${{secrets.OAUTH_CLIENTID}}"
+#          OAUTH_CLIENTSECRET: "${{secrets.OAUTH_CLIENTSECRET}}"
+#          OAUTH_AUDIENCE: "${{secrets.OAUTH_AUDIENCE}}"
+#          OAUTH_ISSUER: "${{secrets.OAUTH_ISSUER}}"
+#          OKTA_USERNAME: "${{secrets.OKTA_USERNAME}}"
+#          OKTA_PASSWORD: "${{secrets.OKTA_PASSWORD}}"
+#          OKTA_URL: "${{secrets.OKTA_URL}}"
+#          BASE_URL: "http://localhost:8080"
+#          APP_START_CHECK_RETRY_LIMIT: 100

.github/workflows/main-push.yml

@@ -0,0 +1,29 @@
+name: Main push - Version tag
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: main-push-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  tag-next-version:
+    name: Tag next patch version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate and push tag
+        env:
+          BRANCH: main
+          CI: "true"
+        run: bin/tag-next-version.sh

.github/workflows/trigger-monorepo-version-bump.yml

@@ -0,0 +1,31 @@
+name: Trigger Monorepo Version Bump
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  trigger:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate GitHub App token
+        id: generate-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ vars.MONOREPO_APP_ID }}
+          private-key: ${{ secrets.MONOREPO_APP_PRIVATE_KEY }}
+          owner: skybridgeskills
+          repositories: skybridgeskills-monorepo
+
+      - name: Trigger monorepo version bump workflow
+        env:
+          GH_TOKEN: ${{ steps.generate-token.outputs.token }}
+        run: |
+          gh workflow run osmt-bump-version.yml \
+            --repo skybridgeskills/skybridgeskills-monorepo \
+            --ref main
+          echo "✅ Triggered monorepo version bump workflow"