Merge pull request #63 from appcircleio/feature/be-6103

#BE-6103 feat: enhance build command with status monitoring and log downloading

Author: fuatguzel

README.md

@@ -157,6 +157,26 @@ CURL_LOGGING= appcircle
 - Get the workflows of that build profile `appcircle build profile workflows --profileId="YOUR PROFILE ID"`
 - Start a new build using `appcircle build start --profileId="YOUR PROFILE ID" --branch="YOUR BRANCH" --workflow="YOUR WORKFLOW ID"`
 
+#### Build Log Download Improvements
+
+Appcircle CLI includes the following improvements for build log downloading functionality:
+
+- Build logs are automatically downloaded when a build is completed
+- A 2-minute waiting period with 5-second retry intervals is implemented for log files
+- User-friendly animation is displayed: "Waiting for build logs to be prepared..."
+- Support for manual log download with both task ID (`--taskId`) and commit/build ID (`--commitId`/`--buildId`) parameters
+- Automatic fallback to alternative download methods when the primary method fails
+- Log files are saved with descriptive filenames: `build-task-{taskId}-log.txt`
+
+To download build logs:
+```shell
+# Download using Task ID (preferred method)
+appcircle build download-log --taskId="YOUR_TASK_ID"
+
+# Download using Commit ID and Build ID (alternative method)
+appcircle build download-log --commitId="YOUR_COMMIT_ID" --buildId="YOUR_BUILD_ID"
+```
+
 ### Distributing an App via the Appcircle CLI
 
 - Create a distribution profile and [share with the testers](https://docs.appcircle.io/distribute/create-or-select-a-distribution-profile)

docs/build/download-log.md

@@ -1,22 +1,54 @@
 # `appcircle build download-log`
 
-Download build log to the given directory on your machine.
+Download build logs to the specified directory.
 
 ```plaintext
 appcircle build download-log [options]
 ```
 
+## Description
+
+This command downloads build logs to your computer. You can download logs using two different methods:
+
+1. Using `taskId` (preferred method)
+2. Using `commitId` and `buildId` (alternative method)
+
+When downloading logs, the CLI automatically checks if logs are ready at 5-second intervals for up to 2 minutes.
+
 ## Options
 
 ```plaintext
-  --path <string>    [OPTIONAL] The path for log to be downloaded. Defaults to the current directory
+  --path <string>     [OPTIONAL] Path where logs will be downloaded. Defaults to current directory or Downloads folder
 
-  --commitId <uuid>  Commit ID of your build
+  --taskId <uuid>     [METHOD 1] Task ID for the build process
 
-  --buildId <uuid>   Build ID
+  --commitId <uuid>   [METHOD 2] Commit ID
+
+  --buildId <uuid>    [METHOD 2] Build ID
 ```
+
+## Features
+
+- User-friendly animation is displayed while build logs are being prepared
+- Automatically switches to alternative download methods if the primary method fails
+- Logs are saved with descriptive filenames: `build-task-{taskId}-log.txt` or `{buildId}-log.txt`
+- Full file path is displayed to easily find log files
+
 ## Options inherited from parent commands
 
 ```plaintext
       --help   Show help for command
+``` 
+
+## Examples
+
+```plaintext
+# Download logs using Task ID (preferred method)
+appcircle build download-log --taskId="1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p"
+
+# Download logs using Commit ID and Build ID
+appcircle build download-log --commitId="1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p" --buildId="7q8r9s0t-1u2v-3w4x-5y6z-7a8b9c0d1e2f"
+
+# Download to a specific directory
+appcircle build download-log --taskId="1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p" --path="/Users/username/Downloads"
 ```