[CI] Update output directory handling in build scripts and documentation

Author: Odyno

.github/workflows/README.md

@@ -282,16 +282,16 @@ clang-format-version: '9'
    - `--version <tag>`: Version to inject (SHA for dev, tag for prod)
    - `--mode <dev|prod>`: Build mode (enables/disables OTA)
    - `--deploy-ready`: Prepare artifacts for deployment
-   - `--output <dir>`: Output directory for artifacts
+   - `--output <dir>`: Output directory for artifacts (default: `generated/artifacts/`)
 
 **Command Flow**:
 ```bash
-./scripts/ci.sh build esp32dev-ble --version v1.8.0 --mode prod --deploy-ready --output artifacts
+./scripts/ci.sh build esp32dev-ble --version v1.8.0 --mode prod --deploy-ready
     ↓
     ├─→ ci_build.sh (orchestrator)
     │   ├─→ ci_set_version.sh v1.8.0 [--dev]
     │   ├─→ ci_build_firmware.sh esp32dev-ble [--dev-ota]
-    │   └─→ ci_prepare_artifacts.sh esp32dev-ble [--deploy] --output artifacts
+    │   └─→ ci_prepare_artifacts.sh esp32dev-ble [--deploy] → outputs to generated/artifacts/
 ```
 
 **Technical Details**:
@@ -527,10 +527,12 @@ end
 - `stale.yml` → standalone (no dependencies)
 
 **Task → CI Script Mapping**:
-- `task-build.yml` → `ci.sh build <env> --version --mode --deploy-ready --output`
+- `task-build.yml` → `ci.sh build <env> --version --mode --deploy-ready`
   - Routes to: `ci_build.sh` → `ci_set_version.sh`, `ci_build_firmware.sh`, `ci_prepare_artifacts.sh`
+  - Output: `generated/artifacts/` (default, can be overridden with `--output`)
 - `task-docs.yml` → `ci.sh site --mode --version-source --url-prefix --webuploader-args`
   - Routes to: `ci_site.sh` → `generate_board_docs.py`, `gen_wu.py`, VuePress
+  - Output: `generated/site/`
 - `task-lint.yml` → `ci.sh qa --check --source --extensions --clang-format-version`
   - Routes to: `ci_qa.sh` → `clang-format`
 

.github/workflows/task-build.yml

@@ -93,15 +93,12 @@ jobs:
             BUILD_ARGS="$BUILD_ARGS --deploy-ready"
           fi
           
-          # Add output directory
-          BUILD_ARGS="$BUILD_ARGS --output artifacts"
-          
-          # Execute build
+          # Execute build (uses default generated/artifacts/ directory)
           ./scripts/ci.sh build $BUILD_ARGS
 
       - name: Upload firmware artifacts
         uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.artifact-name-prefix }}${{ matrix.environments }}
-          path: artifacts/
+          path: generated/artifacts/
           retention-days: ${{ inputs.artifact-retention-days }}

scripts/ci_build.sh

@@ -178,6 +178,7 @@ Options:
     --mode MODE            Build mode: 'prod' or 'dev' [default: prod]
                            'dev' enables OTA and development version
     --deploy-ready         Prepare for deployment (renamed artifacts)
+    --output DIR           Output directory for artifacts [default: generated/artifacts/]
     --skip-verification    Skip build tools verification
     --clean                Clean build before starting
     --verbose              Enable verbose output
@@ -212,6 +213,7 @@ main() {
     local set_version=false
     local mode=""
     local deploy=false
+    local output_dir=""
     local skip_verification=false
     local clean=false
     local verbose=false
@@ -247,6 +249,15 @@ main() {
                 deploy=true
                 shift
                 ;;
+            --output)
+                if [[ $# -lt 2 ]]; then
+                    log_error "--output requires a directory argument"
+                    usage
+                    exit 1
+                fi
+                output_dir="$2"
+                shift 2
+                ;;
             --skip-verification)
                 skip_verification=true
                 shift
@@ -268,7 +279,6 @@ main() {
                 exit 0
                 ;;
             -*)
-                log_error "Unknown option: $1"
                 log_error "Unknown option: $1"
                 usage
                 exit 1
@@ -357,6 +367,7 @@ main() {
     local artifact_opts=()
     [[ "$deploy" == "true" ]] && artifact_opts+=(--deploy) || artifact_opts+=(--standard)
     artifact_opts+=(--manifest)
+    [[ -n "$output_dir" ]] && artifact_opts+=(--output "$output_dir")
 
     "${SCRIPT_DIR}/ci_prepare_artifacts.sh" "$environment" "${artifact_opts[@]}" || exit 1
     echo ""