feat: update GitHub Actions workflows with path-based triggers and comprehensive documentation

Author: Harmanpreet Kaur

.github/workflows/codeql.yml

@@ -14,8 +14,22 @@ name: "CodeQL Advanced"
 on:
   push:
     branches: [ "main", "dev", "demo" ]
+    paths:
+      - 'src/**/*.py'
+      - 'src/**/*.js'
+      - 'src/**/*.ts'
+      - 'src/**/*.tsx'
+      - 'tests/**/*.py'
+      - '.github/workflows/codeql.yml'
   pull_request:
     branches: [ "main", "dev", "demo" ]
+    paths:
+      - 'src/**/*.py'
+      - 'src/**/*.js'
+      - 'src/**/*.ts'
+      - 'src/**/*.tsx'
+      - 'tests/**/*.py'
+      - '.github/workflows/codeql.yml'
   schedule:
     - cron: '44 20 * * 2'
 

.github/workflows/deploy.yml

@@ -1,6 +1,28 @@
 name: Validate Deployment v3
 
 on:
+  push:
+    branches:
+      - main
+      - dev-v3
+      - hotfix
+    paths:
+      - 'infra/main.bicep'
+      - 'infra/modules/**/*.bicep'
+      - 'infra/*.parameters.json'
+      - 'infra/scripts/**'
+      - '.github/workflows/deploy.yml'
+  pull_request:
+    branches:
+      - main
+      - dev-v3
+      - hotfix
+    paths:
+      - 'infra/main.bicep'
+      - 'infra/modules/**/*.bicep'
+      - 'infra/*.parameters.json'
+      - 'infra/scripts/**'
+      - '.github/workflows/deploy.yml'
   workflow_run:
     workflows: ["Build Docker and Optional Push v3"]
     types:

.github/workflows/docker-build-and-push.yml

@@ -7,6 +7,11 @@ on:
       - dev-v3
       - demo-v3
       - hotfix
+    paths:
+      - 'src/frontend/**'
+      - 'src/backend/**'
+      - 'src/mcp_server/**'
+      - '.github/workflows/docker-build-and-push.yml'
   pull_request:
     types:
       - opened
@@ -18,6 +23,11 @@ on:
       - dev-v3
       - demo-v3
       - hotfix
+    paths:
+      - 'src/frontend/**'
+      - 'src/backend/**'
+      - 'src/mcp_server/**'
+      - '.github/workflows/docker-build-and-push.yml'
   workflow_dispatch:
 
 jobs:

.github/workflows/pylint.yml

@@ -1,6 +1,18 @@
 name: PyLint
 
-on: [push]
+on: 
+  push:
+    paths:
+      - 'src/backend/**/*.py'
+      - 'src/backend/requirements.txt'
+      - '.flake8'
+      - '.github/workflows/pylint.yml'
+  pull_request:
+    paths:
+      - 'src/backend/**/*.py'
+      - 'src/backend/requirements.txt'
+      - '.flake8'
+      - '.github/workflows/pylint.yml'
 
 jobs:
   build:

.github/workflows/test.yml

@@ -7,18 +7,35 @@ on:
       - dev
       - demo
       - hotfix
+    paths:
+      - 'src/backend/**/*.py'
+      - 'src/tests/**/*.py'
+      - 'src/mcp_server/**/*.py'
+      - 'pytest.ini'
+      - 'conftest.py'
+      - 'src/backend/requirements.txt'
+      - 'pyproject.toml'
+      - '.github/workflows/test.yml'
   pull_request:
     types:
       - opened
       - ready_for_review
       - reopened
       - synchronize
     branches:
-      - main
       - main
       - dev
       - demo
       - hotfix
+    paths:
+      - 'src/backend/**/*.py'
+      - 'src/tests/**/*.py'
+      - 'src/mcp_server/**/*.py'
+      - 'pytest.ini'
+      - 'conftest.py'
+      - 'src/backend/requirements.txt'
+      - 'pyproject.toml'
+      - '.github/workflows/test.yml'
 
 jobs:
   test: