Merge branch 'develop' into blcu-improvements

Author: msanlli

.github/workflows/release.yaml

@@ -393,9 +393,12 @@ jobs:
           # Copy common files
           cp -r artifacts/common-files/* release-linux/
           
+          # Set executable permissions
+          chmod +x release-linux/backend release-linux/updater release-linux/testadj
+          
           # Create Linux release archive
           cd release-linux
-          zip -r ../linux-$VERSION.zip .
+          tar -czf ../linux-$VERSION.tar.gz .
       
       - name: Organize Windows release files
         run: |
@@ -445,9 +448,12 @@ jobs:
           # Copy common files
           cp -r artifacts/common-files/* release-macos/
           
+          # Set executable permissions
+          chmod +x release-macos/backend release-macos/updater release-macos/testadj
+          
           # Create macOS Intel release archive
           cd release-macos
-          zip -r ../macos-intel-$VERSION.zip .
+          tar -czf ../macos-intel-$VERSION.tar.gz .
       
       - name: Organize macOS ARM64 release files
         run: |
@@ -471,15 +477,20 @@ jobs:
           # Copy common files
           cp -r artifacts/common-files/* release-macos-arm64/
           
+          # Set executable permissions
+          chmod +x release-macos-arm64/backend release-macos-arm64/updater release-macos-arm64/testadj
+          
           # Create macOS ARM64 release archive
           cd release-macos-arm64
-          zip -r ../macos-arm64-$VERSION.zip .
+          tar -czf ../macos-arm64-$VERSION.tar.gz .
       
       - name: Upload release packages
         uses: actions/upload-artifact@v4
         with:
           name: releases
-          path: "*.zip"
+          path: |
+            *.tar.gz
+            *.zip
           retention-days: 7
           compression-level: 9
 
@@ -502,9 +513,9 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./linux-${{ github.event.inputs.version }}.zip
-          asset_name: linux-${{ github.event.inputs.version }}.zip
-          asset_content_type: application/zip
+          asset_path: ./linux-${{ github.event.inputs.version }}.tar.gz
+          asset_name: linux-${{ github.event.inputs.version }}.tar.gz
+          asset_content_type: application/gzip
 
       - name: Upload Windows package to release
         if: github.event_name == 'workflow_dispatch'
@@ -524,9 +535,9 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./macos-intel-${{ github.event.inputs.version }}.zip
-          asset_name: macos-intel-${{ github.event.inputs.version }}.zip
-          asset_content_type: application/zip
+          asset_path: ./macos-intel-${{ github.event.inputs.version }}.tar.gz
+          asset_name: macos-intel-${{ github.event.inputs.version }}.tar.gz
+          asset_content_type: application/gzip
 
       - name: Upload macOS ARM64 package to release
         if: github.event_name == 'workflow_dispatch'
@@ -535,9 +546,9 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./macos-arm64-${{ github.event.inputs.version }}.zip
-          asset_name: macos-arm64-${{ github.event.inputs.version }}.zip
-          asset_content_type: application/zip
+          asset_path: ./macos-arm64-${{ github.event.inputs.version }}.tar.gz
+          asset_name: macos-arm64-${{ github.event.inputs.version }}.tar.gz
+          asset_content_type: application/gzip
 
       - name: Upload Linux package to existing release
         if: github.event_name == 'release'
@@ -546,9 +557,9 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ github.event.release.upload_url }}
-          asset_path: ./linux-${{ github.event.release.tag_name }}.zip
-          asset_name: linux-${{ github.event.release.tag_name }}.zip
-          asset_content_type: application/zip
+          asset_path: ./linux-${{ github.event.release.tag_name }}.tar.gz
+          asset_name: linux-${{ github.event.release.tag_name }}.tar.gz
+          asset_content_type: application/gzip
 
       - name: Upload Windows package to existing release
         if: github.event_name == 'release'
@@ -568,9 +579,9 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ github.event.release.upload_url }}
-          asset_path: ./macos-intel-${{ github.event.release.tag_name }}.zip
-          asset_name: macos-intel-${{ github.event.release.tag_name }}.zip
-          asset_content_type: application/zip
+          asset_path: ./macos-intel-${{ github.event.release.tag_name }}.tar.gz
+          asset_name: macos-intel-${{ github.event.release.tag_name }}.tar.gz
+          asset_content_type: application/gzip
 
       - name: Upload macOS ARM64 package to existing release
         if: github.event_name == 'release'
@@ -579,6 +590,6 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ github.event.release.upload_url }}
-          asset_path: ./macos-arm64-${{ github.event.release.tag_name }}.zip
-          asset_name: macos-arm64-${{ github.event.release.tag_name }}.zip
-          asset_content_type: application/zip
+          asset_path: ./macos-arm64-${{ github.event.release.tag_name }}.tar.gz
+          asset_name: macos-arm64-${{ github.event.release.tag_name }}.tar.gz
+          asset_content_type: application/gzip

.github/workflows/test-dev-scripts.yaml

@@ -0,0 +1,82 @@
+name: Test Development Scripts
+
+on:
+  pull_request:
+    paths:
+      - scripts/**
+  workflow_dispatch:
+
+jobs:
+  test-dev-scripts:
+    name: Test Development Scripts
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            name: linux
+            shell: bash
+            script: ./scripts/dev.sh
+            
+          - os: windows-latest
+            name: windows-powershell
+            shell: pwsh
+            script: .\scripts\dev.ps1
+            
+          - os: windows-latest
+            name: windows-cmd
+            shell: cmd
+            script: scripts\dev.cmd
+            
+          - os: macos-latest
+            name: macos
+            shell: bash
+            script: ./scripts/dev.sh
+
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: "1.21.3"
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          
+      - name: Install tmux (Linux/macOS)
+        if: matrix.os != 'windows-latest'
+        run: |
+          if [ "${{ matrix.os }}" = "ubuntu-latest" ]; then
+            sudo apt-get update && sudo apt-get install -y tmux
+          elif [ "${{ matrix.os }}" = "macos-latest" ]; then
+            brew install tmux
+          fi
+        shell: bash
+      
+      - name: Make script executable (Unix)
+        if: matrix.os != 'windows-latest'
+        run: chmod +x scripts/dev.sh
+        shell: bash
+      
+      - name: Test script help/usage
+        run: ${{ matrix.script }}
+        shell: ${{ matrix.shell }}
+        continue-on-error: true
+        
+      - name: Test dependency check
+        run: ${{ matrix.script }} setup
+        shell: ${{ matrix.shell }}
+        
+      - name: Test build command
+        run: ${{ matrix.script }} build
+        shell: ${{ matrix.shell }}
+        continue-on-error: true
+        
+      - name: Test backend build (quick test)
+        run: ${{ matrix.script }} test
+        shell: ${{ matrix.shell }}
+        continue-on-error: true

DOCUMENTATION_REORGANIZATION.md

@@ -0,0 +1,124 @@
+# Documentation Reorganization Summary
+
+This document outlines the reorganization of project documentation from scattered files to a centralized `docs/` folder structure.
+
+## 📁 New Documentation Structure
+
+```
+docs/
+├── README.md                    # Main documentation index
+├── architecture/
+│   └── README.md               # System architecture overview
+├── development/
+│   ├── DEVELOPMENT.md          # Development setup guide
+│   ├── CROSS_PLATFORM_DEV_SUMMARY.md  # Cross-platform scripts documentation
+│   └── scripts.md              # Scripts reference guide
+├── guides/
+│   └── getting-started.md      # New user getting started guide
+└── troubleshooting/
+    └── BLCU_FIX_SUMMARY.md     # BLCU repair documentation
+```
+
+## 📋 File Migrations
+
+### Moved Files
+| Original Location | New Location | Status |
+|-------------------|--------------|--------|
+| `DEVELOPMENT.md` | `docs/development/DEVELOPMENT.md` | ✅ Moved |
+| `CROSS_PLATFORM_DEV_SUMMARY.md` | `docs/development/CROSS_PLATFORM_DEV_SUMMARY.md` | ✅ Moved |
+| `scripts/README.md` | `docs/development/scripts.md` | ✅ Moved |
+| `backend/BLCU_FIX_SUMMARY.md` | `docs/troubleshooting/BLCU_FIX_SUMMARY.md` | ✅ Moved |
+
+### New Files Created
+| File | Purpose |
+|------|---------|
+| `docs/README.md` | Main documentation index with navigation |
+| `docs/architecture/README.md` | System architecture overview |
+| `docs/guides/getting-started.md` | Comprehensive new user guide |
+| `scripts/README.md` | Quick reference pointing to full docs |
+
+### Updated Files
+| File | Changes |
+|------|---------|
+| `README.md` | Added documentation section with quick links |
+| `docs/development/scripts.md` | Updated paths for new location |
+
+## 🎯 Benefits of New Structure
+
+### 1. **Improved Organization**
+- Clear categorization by purpose (development, architecture, guides, troubleshooting)
+- Logical hierarchy that scales as documentation grows
+- Centralized location for all project documentation
+
+### 2. **Better Discoverability**
+- Single entry point through `docs/README.md`
+- Clear navigation between related documents
+- Quick links in main README for common tasks
+
+### 3. **Enhanced User Experience**
+- Dedicated getting started guide for new users
+- Platform-specific guidance clearly organized
+- Troubleshooting docs easily accessible
+
+### 4. **Maintainability**
+- Related documentation grouped together
+- Easier to update and maintain consistency
+- Clear ownership and responsibility areas
+
+## 🚀 How to Use the New Structure
+
+### For New Users
+1. Start with [`docs/guides/getting-started.md`](docs/guides/getting-started.md)
+2. Follow platform-specific setup in [`docs/development/DEVELOPMENT.md`](docs/development/DEVELOPMENT.md)
+3. Refer to troubleshooting docs if needed
+
+### For Developers
+1. Check [`docs/development/`](docs/development/) for all development-related docs
+2. Use [`docs/architecture/`](docs/architecture/) to understand system design
+3. Reference [`docs/development/scripts.md`](docs/development/scripts.md) for tooling
+
+### For Contributors
+1. Review existing documentation structure before adding new docs
+2. Place new documentation in appropriate category folders
+3. Update main index (`docs/README.md`) when adding major new sections
+
+## 📝 Documentation Guidelines
+
+### Placement Rules
+- **Development docs** → `docs/development/`
+- **Architecture docs** → `docs/architecture/`  
+- **User guides** → `docs/guides/`
+- **Troubleshooting** → `docs/troubleshooting/`
+- **Component-specific** → Keep in respective component directories
+
+### Linking Guidelines
+- Use relative paths for internal documentation links
+- Update `docs/README.md` index when adding major new documents
+- Cross-reference related documentation where helpful
+
+### File Naming
+- Use lowercase with hyphens: `getting-started.md`
+- Use descriptive names that indicate content purpose
+- Keep README.md files for directory overviews
+
+## 🔗 Key Entry Points
+
+### Primary Documentation
+- **[docs/README.md](docs/README.md)** - Main documentation hub
+- **[README.md](README.md)** - Project overview with quick start
+
+### Quick Access
+- **New Users**: [Getting Started Guide](docs/guides/getting-started.md)
+- **Developers**: [Development Setup](docs/development/DEVELOPMENT.md)
+- **Troubleshooting**: [Common Issues](docs/troubleshooting/BLCU_FIX_SUMMARY.md)
+
+## 🎉 Migration Complete
+
+The documentation reorganization provides:
+- ✅ Better organization and navigation
+- ✅ Improved new user experience  
+- ✅ Clearer separation of concerns
+- ✅ Scalable structure for future growth
+- ✅ Maintained backward compatibility through redirect notes
+
+All existing functionality remains accessible while providing a much better documentation experience for users, developers, and contributors.

README.md

@@ -14,7 +14,7 @@ Download the latest release, unzip it and run the executable compatible with you
 
 ### For Developers
 
-See [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed setup instructions. Quick start:
+See our comprehensive [Documentation](./docs/README.md) or jump to [Getting Started](./docs/guides/getting-started.md). Quick start:
 
 ```bash
 # Clone and setup
@@ -34,7 +34,17 @@ When using the Control Station make sure that you have configured your IP as the
 
 To change the ADJ branch from `main`, change the option `adj/branch` at the end of the `config.toml` with the name of the branch you want to use or leave it blank if you'll be making use of a custom ADJ.
 
-### Contributing
+## Documentation
+
+📚 **[Complete Documentation](./docs/README.md)** - All guides and references
+
+### Quick Links
+- 🚀 **[Getting Started](./docs/guides/getting-started.md)** - New user guide
+- 🛠️ **[Development Setup](./docs/development/DEVELOPMENT.md)** - Developer environment setup  
+- 🏗️ **[Architecture](./docs/architecture/README.md)** - System design overview
+- 🔧 **[Troubleshooting](./docs/troubleshooting/BLCU_FIX_SUMMARY.md)** - Common issues and fixes
+
+## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for ways to contribute to the Control Station.