refactor(reports): reorganize health report generation and update paths for automated reports

Author: sayak-sarkar

.github/workflows/realtime-status-dashboard.yml

@@ -11,11 +11,11 @@ on:
     branches: [main, develop]
   schedule:
     # Update status twice daily during business hours (9 AM and 5 PM UTC)
-    - cron: '0 9,17 * * 1-5'
+    - cron: "0 9,17 * * 1-5"
   workflow_dispatch:
 
 env:
-  NODE_VERSION: '20'
+  NODE_VERSION: "20"
 
 jobs:
   # Real-time status collection
@@ -211,7 +211,7 @@ jobs:
           - [📚 Documentation](./frontend/docs/)
           - [🔒 Security Architecture](./frontend/docs/security-architecture.md)
           - [🚀 CI/CD Pipeline](https://github.com/${{ github.repository }}/actions)
-          - [📝 Health Report](./reports/health-report.md)
+          - [📝 Health Report](./reports/automated/health-report.md)
 
           ## 📋 Service Level Objectives (SLOs)
 

.github/workflows/repository-health-monitor.yml

@@ -3,17 +3,17 @@ name: 📊 Repository Health Monitor
 on:
   schedule:
     # Run daily at 6 AM UTC
-    - cron: '0 6 * * *'
+    - cron: "0 6 * * *"
   workflow_dispatch:
   push:
     branches: [main]
     paths:
-      - 'package.json'
-      - 'package-lock.json'
-      - '.github/workflows/**'
+      - "package.json"
+      - "package-lock.json"
+      - ".github/workflows/**"
 
 env:
-  NODE_VERSION: '20'
+  NODE_VERSION: "20"
 
 jobs:
   # Health check and metrics collection
@@ -33,7 +33,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
-          cache: 'npm'
+          cache: "npm"
 
       - name: Install dependencies
         run: |
@@ -189,7 +189,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
-          cache: 'npm'
+          cache: "npm"
 
       - name: Install dependencies
         run: |
@@ -313,7 +313,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
-          cache: 'npm'
+          cache: "npm"
 
       - name: Check dependency health
         id: deps
@@ -498,7 +498,7 @@ jobs:
           mkdir -p reports
 
           # Create health report
-          cat > reports/health-report.md << EOF
+          cat > reports/automated/health-report.md << EOF
           # 📊 Repository Health Report
 
           **Generated:** $(date -u)
@@ -533,22 +533,22 @@ jobs:
 
           # Add action items based on status
           if [[ "${{ needs.dependency-health.outputs.health-status }}" != "healthy" ]]; then
-            echo "- 📦 Address dependency issues (outdated: ${{ needs.dependency-health.outputs.outdated-count }})" >> reports/health-report.md
+            echo "- 📦 Address dependency issues (outdated: ${{ needs.dependency-health.outputs.outdated-count }})" >> reports/automated/health-report.md
           fi
 
           if [[ "${{ needs.documentation-health.outputs.coverage-score }}" -lt 90 ]]; then
-            echo "- 📚 Improve documentation coverage (missing: ${{ needs.documentation-health.outputs.missing-docs }})" >> reports/health-report.md
+            echo "- 📚 Improve documentation coverage (missing: ${{ needs.documentation-health.outputs.missing-docs }})" >> reports/automated/health-report.md
           fi
 
           if [[ "${{ needs.performance-monitor.outputs.performance-score }}" -lt 80 ]]; then
-            echo "- ⚡ Optimize performance (bundle size, code splitting)" >> reports/health-report.md
+            echo "- ⚡ Optimize performance (bundle size, code splitting)" >> reports/automated/health-report.md
           fi
 
-          echo "" >> reports/health-report.md
-          echo "### 🔗 Quick Links" >> reports/health-report.md
-          echo "- [Security Architecture](./docs/security-architecture.md)" >> reports/health-report.md
-          echo "- [Website Overview](./docs/website-overview.md)" >> reports/health-report.md
-          echo "- [GitHub Actions](https://github.com/${{ github.repository }}/actions)" >> reports/health-report.md
+          echo "" >> reports/automated/health-report.md
+          echo "### 🔗 Quick Links" >> reports/automated/health-report.md
+          echo "- [Security Architecture](./docs/security-architecture.md)" >> reports/automated/health-report.md
+          echo "- [Website Overview](./docs/website-overview.md)" >> reports/automated/health-report.md
+          echo "- [GitHub Actions](https://github.com/${{ github.repository }}/actions)" >> reports/automated/health-report.md
 
       - name: Commit status updates
         run: |
@@ -564,7 +564,7 @@ jobs:
             if [ -z "$last_health_commit" ]; then
               echo "Creating daily health report update"
               git add reports/
-              git add -f reports/health-report.md
+              git add -f reports/automated/health-report.md
               git commit -m "📊 Update repository health status and metrics [skip ci]"
               git push
             else
@@ -585,6 +585,6 @@ jobs:
           echo "| Documentation | ${{ needs.documentation-health.outputs.coverage-score }}/100 | $([ ${{ needs.documentation-health.outputs.coverage-score }} -ge 90 ] && echo '✅ Complete' || echo '⚠️ Incomplete') |" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "### 🔗 Resources" >> $GITHUB_STEP_SUMMARY
-          echo "- [Health Report](./reports/health-report.md)" >> $GITHUB_STEP_SUMMARY
+          echo "- [Health Report](./reports/automated/health-report.md)" >> $GITHUB_STEP_SUMMARY
           echo "- [Live Website](https://www.thinkred.tech)" >> $GITHUB_STEP_SUMMARY
           echo "- [Documentation](./docs/)" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -5,22 +5,22 @@ node_modules/
 **/node_modules/
 /.pnp
 .pnp.js
-package-lock.json
+# Package lock files should be committed for consistency
+# package-lock.json is now tracked for dependency consistency
 
 # testing
 /coverage
 **/coverage/
 
-# production
+# production build outputs (generated by build process)
 build/
 **/build/
-hostinger-deploy/
+frontend/dist/
+**/frontend/dist/
+frontend/hostinger-deploy/
 **/hostinger-deploy/
 thinkred-website.zip
 **/thinkred-website.zip
-# Keep dist/ for potential future use or other build tools
-dist/
-**/dist/
 
 # Build artifacts and source maps
 *.map
@@ -34,15 +34,15 @@ dist/
 *.bundle.css
 **/*.bundle.css
 
-# Automated reports and status files (generated, not tracked)
-**/automated/health-report.md
-**/automated/status-dashboard.md
-scripts/reports/automated/
-reports/automated/*.md
+# Automated reports directory (generated content only)
 reports/automated/
 !reports/automated/.gitkeep
+!reports/automated/README.md
 !reports/automated/templates/
 
+# Manual reports in incidents/, operational/, security/ should be tracked
+# Only ignore reports that are clearly in the wrong location (root reports/ dir)
+
 # Vite build cache and temp files
 .vite/
 **/.vite/
@@ -136,8 +136,3 @@ coverage/
 
 # Deployment configuration backups
 .deployment-config.json.backup*
-
-# Auto-generated reports (keep directory structure, ignore generated files)
-# Note: Workflows may force-add specific reports using git add -f
-reports/*.md
-!reports/README.md

config/.markdownlint.json

@@ -1,17 +1,32 @@
+# Build outputs and generated files
 build/
+frontend/dist/
 node_modules/
-*.md
-*.json
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
 coverage/
+
+# Package and lock files
 package-lock.json
+*.tgz
+
+# Environment files
+.env*
+
+# Generated reports (formatted manually)
+reports/automated/
+reports/automated/health-report.md
+reports/*-fix-*.md
+
+# Asset files (non-text)
 *.svg
 *.png
 *.jpg
 *.jpeg
 *.gif
 *.ico
+*.woff
+*.woff2
+*.ttf
+*.eot
+
+# Configuration that shouldn't be formatted
+.clasp.json

config/.prettierignore

@@ -0,0 +1,116 @@
+# Configuration Files Documentation
+
+This document explains the purpose and usage of configuration files in the ThinkRED monorepo.
+
+## 📁 Root Configuration Files
+
+### `.gitignore`
+**Purpose**: Specifies which files and directories Git should ignore
+**Updated**: June 30, 2025
+**Key Features**:
+- ✅ Tracks `package-lock.json` for dependency consistency
+- ✅ Completely ignores all build outputs (`build/`, `frontend/dist/`)
+- ✅ Properly organizes reports: tracks incidents/operational/security, ignores automated
+- ✅ Proper environment file exclusions
+- ✅ Security-sensitive files excluded
+- ✅ Clean report organization with appropriate directory structure
+
+### `.prettierrc.json`
+**Purpose**: Code formatting configuration for Prettier
+**Settings**:
+- Print width: 120 characters (standard code), 100 (markdown)
+- Tab width: 2 spaces
+- Single quotes, trailing commas (ES5)
+- LF line endings for cross-platform compatibility
+
+### `.prettierignore`
+**Purpose**: Files and directories Prettier should not format
+**Updated**: June 30, 2025
+**Excludes**:
+- Build outputs and generated files
+- Asset files (images, fonts)
+- Package lock files
+- Environment files
+- Generated reports
+
+### `.markdownlint.json`
+**Purpose**: Markdown linting rules configuration
+**Settings**:
+- Line length: 150 characters (accommodates technical documentation)
+- Disabled strict heading rules for flexibility
+- Enabled whitespace and blank line rules
+
+## 📁 Backend Configuration
+
+### `backend/.gitignore`
+**Purpose**: Backend-specific ignore patterns
+**Key Exclusions**:
+- `.env` files (contain sensitive Google Apps Script credentials)
+- `.clasprc.json` (CLASP authentication)
+- Node modules and logs
+
+### `backend/.clasp.json`
+**Purpose**: Google Apps Script deployment configuration
+**Contains**:
+- Script ID for Google Apps Script project
+- File extension mappings
+- **Status**: ✅ Active and properly configured
+
+## 📁 Config Directory
+
+### `config/.gitleaks.toml`
+**Purpose**: Security scanning configuration for GitLeaks
+**Features**:
+- Allows documented placeholder patterns
+- Prevents false positives from examples
+- Maintains security while allowing documentation
+
+### `config/.deployment-config.json`
+**Purpose**: Deployment environment configuration
+**Environments**:
+- Production (GitHub Pages)
+- Hostinger (backup deployment)
+- Staging and Development
+**Status**: ✅ Active template
+
+### `config/.env.example`
+**Purpose**: Environment variable template
+**Usage**: Copy to `.env.local` for local development
+
+### `config/.prettierignore`
+**Purpose**: Additional Prettier ignore patterns for config files
+**Status**: ✅ Active
+
+## 📁 Directory Structure Preservation
+
+### `reports/automated/.gitkeep`
+**Purpose**: Preserve automated reports directory structure
+**Usage**: Ensures directory exists for CI/CD processes
+
+### `reports/templates/.gitkeep`
+**Purpose**: Preserve report templates directory
+**Usage**: Maintains directory for report generation templates
+
+## 🔧 Configuration Management Best Practices
+
+### ✅ Active Configurations
+- All configuration files are actively used
+- No duplicate or conflicting configurations
+- Environment-specific settings properly isolated
+
+### 🧹 Cleanup Completed
+- Removed duplicate `.prettierrc.json` and `.markdownlint.json` from config/
+- Updated `.gitignore` for better precision
+- Added necessary `.gitkeep` files
+- Improved `.prettierignore` accuracy
+
+### 🔒 Security Considerations
+- Environment files properly excluded
+- Sensitive credentials not tracked
+- GitLeaks configuration prevents security issues
+- Documentation examples safely allowed
+
+---
+
+**Last Updated**: June 30, 2025
+**Next Review**: July 30, 2025