Merge MVP sample apps to main to trigger copy utility

.gitattributes

@@ -0,0 +1,8 @@
+# Git Attributes for docs-sample-apps
+# Marks auto-generated files that are committed to version control
+# so they're collapsed in GitHub PR diffs and excluded from code review
+
+# Maven Wrapper - Auto-generated by Apache Maven (committed to git)
+# See: https://maven.apache.org/wrapper/
+server/java-spring/mvnw linguist-generated=true
+server/java-spring/mvnw.cmd linguist-generated=true

.github/scripts/generate-test-summary-jest.sh

@@ -0,0 +1,122 @@
+#!/bin/bash
+set -e
+
+# Generate Detailed Test Summary from Multiple Jest JSON Output Files
+# Shows breakdown by test type (unit vs integration)
+# Usage: ./generate-test-summary-jest.sh <unit-json> <integration-json>
+
+UNIT_JSON="${1:-}"
+INTEGRATION_JSON="${2:-}"
+
+echo "## Test Results" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Function to parse Jest JSON file
+parse_json() {
+  local json_file="$1"
+  local test_type="$2"
+
+  if [ ! -f "$json_file" ]; then
+    echo "0 0 0 0"
+    return
+  fi
+
+  if command -v jq &> /dev/null; then
+    # Use jq if available (preferred)
+    total_tests=$(jq -r '.numTotalTests // 0' "$json_file")
+    passed=$(jq -r '.numPassedTests // 0' "$json_file")
+    failed=$(jq -r '.numFailedTests // 0' "$json_file")
+    skipped=$(jq -r '.numPendingTests // 0' "$json_file")
+  else
+    # Fallback to grep/sed if jq is not available
+    total_tests=$(grep -oP '"numTotalTests":\s*\K[0-9]+' "$json_file" | head -1)
+    passed=$(grep -oP '"numPassedTests":\s*\K[0-9]+' "$json_file" | head -1)
+    failed=$(grep -oP '"numFailedTests":\s*\K[0-9]+' "$json_file" | head -1)
+    skipped=$(grep -oP '"numPendingTests":\s*\K[0-9]+' "$json_file" | head -1)
+  fi
+
+  # Default to 0 if values are empty
+  total_tests=${total_tests:-0}
+  passed=${passed:-0}
+  failed=${failed:-0}
+  skipped=${skipped:-0}
+
+  echo "$total_tests $passed $failed $skipped"
+}
+
+# Parse both files
+read -r unit_tests unit_passed unit_failed unit_skipped <<< "$(parse_json "$UNIT_JSON" "Unit")"
+read -r int_tests int_passed int_failed int_skipped <<< "$(parse_json "$INTEGRATION_JSON" "Integration")"
+
+# Calculate totals
+total_tests=$((unit_tests + int_tests))
+total_passed=$((unit_passed + int_passed))
+total_failed=$((unit_failed + int_failed))
+total_skipped=$((unit_skipped + int_skipped))
+
+# Display detailed breakdown
+echo "### Summary by Test Type" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Test Type | Passed | Failed | Skipped | Total |" >> $GITHUB_STEP_SUMMARY
+echo "|-----------|--------|--------|---------|-------|" >> $GITHUB_STEP_SUMMARY
+
+if [ -f "$UNIT_JSON" ]; then
+  echo "| 🔧 Unit Tests | $unit_passed | $unit_failed | $unit_skipped | $unit_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+if [ -f "$INTEGRATION_JSON" ]; then
+  echo "| 🔗 Integration Tests | $int_passed | $int_failed | $int_skipped | $int_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+echo "| **Total** | **$total_passed** | **$total_failed** | **$total_skipped** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Overall status
+echo "### Overall Status" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+echo "| ✅ Passed | $total_passed |" >> $GITHUB_STEP_SUMMARY
+echo "| ❌ Failed | $total_failed |" >> $GITHUB_STEP_SUMMARY
+echo "| ⏭️ Skipped | $total_skipped |" >> $GITHUB_STEP_SUMMARY
+echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# List failed tests if any
+if [ $total_failed -gt 0 ]; then
+  echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
+  echo "" >> $GITHUB_STEP_SUMMARY
+
+  failed_tests_file=$(mktemp)
+
+  # Extract failed tests from both files
+  for json_file in "$UNIT_JSON" "$INTEGRATION_JSON"; do
+    if [ -f "$json_file" ]; then
+      if command -v jq &> /dev/null; then
+        jq -r '.testResults[]? | select(.status == "failed") | .assertionResults[]? | select(.status == "failed") | "\(.ancestorTitles | join(" > ")) > \(.title)"' "$json_file" >> "$failed_tests_file" 2>/dev/null || true
+      else
+        # Basic fallback without jq
+        grep -oP '"fullName":\s*"\K[^"]*' "$json_file" | while read -r line; do
+          if echo "$line" | grep -q "failed"; then
+            echo "$line" >> "$failed_tests_file"
+          fi
+        done 2>/dev/null || true
+      fi
+    fi
+  done
+
+  if [ -s "$failed_tests_file" ]; then
+    while IFS= read -r test; do
+      echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+    done < "$failed_tests_file"
+  else
+    echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+  fi
+
+  echo "" >> $GITHUB_STEP_SUMMARY
+  echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+  rm -f "$failed_tests_file"
+  exit 1
+else
+  echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+fi

.github/scripts/generate-test-summary-pytest.sh

@@ -0,0 +1,109 @@
+#!/bin/bash
+set -e
+
+# Generate Detailed Test Summary from Multiple Pytest JUnit XML Output Files
+# Shows breakdown by test type (unit vs integration)
+# Usage: ./generate-test-summary-pytest-detailed.sh <unit-xml> <integration-xml>
+
+UNIT_XML="${1:-}"
+INTEGRATION_XML="${2:-}"
+
+echo "## Test Results" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Function to parse XML file
+parse_xml() {
+  local xml_file="$1"
+  local test_type="$2"
+
+  if [ ! -f "$xml_file" ]; then
+    echo "0 0 0 0 0"
+    return
+  fi
+
+  tests=$(grep -oP 'tests="\K[0-9]+' "$xml_file" | head -1)
+  failures=$(grep -oP 'failures="\K[0-9]+' "$xml_file" | head -1)
+  errors=$(grep -oP 'errors="\K[0-9]+' "$xml_file" | head -1)
+  skipped=$(grep -oP 'skipped="\K[0-9]+' "$xml_file" | head -1)
+
+  tests=${tests:-0}
+  failures=${failures:-0}
+  errors=${errors:-0}
+  skipped=${skipped:-0}
+  passed=$((tests - failures - errors - skipped))
+
+  echo "$tests $failures $errors $skipped $passed"
+}
+
+# Parse both files
+read -r unit_tests unit_failures unit_errors unit_skipped unit_passed <<< "$(parse_xml "$UNIT_XML" "Unit")"
+read -r int_tests int_failures int_errors int_skipped int_passed <<< "$(parse_xml "$INTEGRATION_XML" "Integration")"
+
+# Calculate totals
+total_tests=$((unit_tests + int_tests))
+total_failures=$((unit_failures + int_failures))
+total_errors=$((unit_errors + int_errors))
+total_skipped=$((unit_skipped + int_skipped))
+total_passed=$((unit_passed + int_passed))
+total_failed=$((total_failures + total_errors))
+
+# Display detailed breakdown
+echo "### Summary by Test Type" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Test Type | Passed | Failed | Skipped | Total |" >> $GITHUB_STEP_SUMMARY
+echo "|-----------|--------|--------|---------|-------|" >> $GITHUB_STEP_SUMMARY
+
+if [ -f "$UNIT_XML" ]; then
+  echo "| 🔧 Unit Tests | $unit_passed | $((unit_failures + unit_errors)) | $unit_skipped | $unit_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+if [ -f "$INTEGRATION_XML" ]; then
+  echo "| 🔗 Integration Tests | $int_passed | $((int_failures + int_errors)) | $int_skipped | $int_tests |" >> $GITHUB_STEP_SUMMARY
+fi
+
+echo "| **Total** | **$total_passed** | **$total_failed** | **$total_skipped** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Overall status
+echo "### Overall Status" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+echo "| ✅ Passed | $total_passed |" >> $GITHUB_STEP_SUMMARY
+echo "| ❌ Failed | $total_failed |" >> $GITHUB_STEP_SUMMARY
+echo "| ⏭️ Skipped | $total_skipped |" >> $GITHUB_STEP_SUMMARY
+echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# List failed tests if any
+if [ $total_failed -gt 0 ]; then
+  echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
+  echo "" >> $GITHUB_STEP_SUMMARY
+
+  failed_tests_file=$(mktemp)
+
+  # Extract failed tests from both files
+  for xml_file in "$UNIT_XML" "$INTEGRATION_XML"; do
+    if [ -f "$xml_file" ]; then
+      grep -oP '<testcase[^>]*classname="[^"]*"[^>]*name="[^"]*"[^>]*>.*?<(failure|error)' "$xml_file" | \
+        grep -oP 'classname="\K[^"]*|name="\K[^"]*' | \
+        paste -d '.' - - >> "$failed_tests_file" 2>/dev/null || true
+    fi
+  done
+
+  if [ -s "$failed_tests_file" ]; then
+    while IFS= read -r test; do
+      echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+    done < "$failed_tests_file"
+  else
+    echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+  fi
+
+  echo "" >> $GITHUB_STEP_SUMMARY
+  echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+  rm -f "$failed_tests_file"
+  exit 1
+else
+  echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+fi
+

.github/scripts/generate-test-summary-surefire.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+set -e
+
+# Generate Test Summary from Maven Surefire Reports
+# Usage: ./generate-test-summary-surefire.sh <path-to-surefire-reports>
+
+REPORTS_DIR="${1:-target/surefire-reports}"
+
+echo "## Test Results" >> $GITHUB_STEP_SUMMARY
+echo "" >> $GITHUB_STEP_SUMMARY
+
+# Parse test results from Surefire reports
+if [ -d "$REPORTS_DIR" ]; then
+  total_tests=0
+  failures=0
+  errors=0
+  skipped=0
+  failed_tests_file=$(mktemp)
+
+  for file in "$REPORTS_DIR"/TEST-*.xml; do
+    if [ -f "$file" ]; then
+      # Extract test counts from XML
+      tests=$(grep -oP 'tests="\K[0-9]+' "$file" | head -1)
+      fails=$(grep -oP 'failures="\K[0-9]+' "$file" | head -1)
+      errs=$(grep -oP 'errors="\K[0-9]+' "$file" | head -1)
+      skip=$(grep -oP 'skipped="\K[0-9]+' "$file" | head -1)
+
+      total_tests=$((total_tests + ${tests:-0}))
+      failures=$((failures + ${fails:-0}))
+      errors=$((errors + ${errs:-0}))
+      skipped=$((skipped + ${skip:-0}))
+
+      # Extract failed test cases
+      if [ "${fails:-0}" -gt 0 ] || [ "${errs:-0}" -gt 0 ]; then
+        classname=$(basename "$file" .xml | sed 's/^TEST-//')
+
+        # Find failed testcases (with failure or error elements)
+        grep -oP '<testcase[^>]*name="[^"]*"[^>]*>.*?<(failure|error)' "$file" | \
+          grep -oP 'name="\K[^"]*' | while read -r testname; do
+            echo "$classname.$testname" >> "$failed_tests_file"
+          done
+      fi
+    fi
+  done
+
+  passed=$((total_tests - failures - errors - skipped))
+
+  echo "| Status | Count |" >> $GITHUB_STEP_SUMMARY
+  echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+  echo "| ✅ Passed | $passed |" >> $GITHUB_STEP_SUMMARY
+  echo "| ❌ Failed | $((failures + errors)) |" >> $GITHUB_STEP_SUMMARY
+  echo "| ⏭️ Skipped | $skipped |" >> $GITHUB_STEP_SUMMARY
+  echo "| **Total** | **$total_tests** |" >> $GITHUB_STEP_SUMMARY
+  echo "" >> $GITHUB_STEP_SUMMARY
+
+  # List failed tests if any
+  if [ $((failures + errors)) -gt 0 ]; then
+    echo "### ❌ Failed Tests" >> $GITHUB_STEP_SUMMARY
+    echo "" >> $GITHUB_STEP_SUMMARY
+
+    if [ -s "$failed_tests_file" ]; then
+      while IFS= read -r test; do
+        echo "- \`$test\`" >> $GITHUB_STEP_SUMMARY
+      done < "$failed_tests_file"
+    else
+      echo "_Unable to parse individual test names_" >> $GITHUB_STEP_SUMMARY
+    fi
+
+    echo "" >> $GITHUB_STEP_SUMMARY
+    echo "❌ **Tests failed!**" >> $GITHUB_STEP_SUMMARY
+    rm -f "$failed_tests_file"
+    exit 1
+  else
+    echo "✅ **All tests passed!**" >> $GITHUB_STEP_SUMMARY
+  fi
+
+  rm -f "$failed_tests_file"
+else
+  echo "⚠️ No test results found at: $REPORTS_DIR" >> $GITHUB_STEP_SUMMARY
+  exit 1
+fi
+

.github/workflows/run-express-tests.yml

@@ -0,0 +1,70 @@
+name: Run Express Tests
+
+on:
+  pull_request_target:
+    branches:
+      - development
+    paths:
+      - 'server/js-express/**'
+  push:
+    branches:
+      - development
+    paths:
+      - 'server/js-express/**'
+
+jobs:
+  test:
+    name: Run Express Tests
+    runs-on: ubuntu-latest
+    # Require manual approval for fork PRs
+    environment: testing
+
+    defaults:
+      run:
+        working-directory: server/js-express
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run unit tests
+        run: npm run test:unit -- --json --outputFile=test-results-unit.json || true
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+
+      - name: Run integration tests
+        run: npm run test:integration -- --json --outputFile=test-results-integration.json || true
+        env:
+          MONGODB_URI: ${{ secrets.MFLIX_URI }}
+          ENABLE_SEARCH_TESTS: true
+          VOYAGE_API_KEY: ${{ secrets.VOYAGE_AI }}
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-results
+          path: |
+            server/js-express/coverage/
+            server/js-express/test-results-unit.json
+            server/js-express/test-results-integration.json
+          retention-days: 30
+
+      - name: Generate Test Summary
+        if: always()
+        working-directory: .
+        run: |
+          chmod +x .github/scripts/generate-test-summary-jest.sh
+          .github/scripts/generate-test-summary-jest.sh \
+            server/js-express/test-results-unit.json \
+            server/js-express/test-results-integration.json