ci: add workflow to check CLI documentation sync

Add GitHub workflow that verifies CLI documentation stays in sync with implementation. The workflow runs on PRs, generates current docs, compares with existing docs, and comments on PR if outdated.

Author: kaincenteno

.github/workflows/check-cli-docs.yml

@@ -0,0 +1,72 @@
+name: Check CLI Documentation
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  check-docs:
+    name: Verify CLI documentation is up-to-date
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python3 -m pip install --upgrade pip
+          pip install -e .
+
+      - name: Generate current CLI documentation
+        run: |
+          typer pyaxm.cli utils docs --name pyaxm-cli --output /tmp/cli.md
+
+      - name: Compare with existing documentation
+        id: compare_docs
+        run: |
+          # Calculate MD5 hashes for both files
+          OLD_HASH=$(md5sum docs/cli.md | awk '{ print $1 }')
+          NEW_HASH=$(md5sum /tmp/cli.md | awk '{ print $1 }')
+          
+          # Compare hashes
+          if [ "$OLD_HASH" != "$NEW_HASH" ]; then
+            echo "docs_outdated=true" >> $GITHUB_OUTPUT
+            exit 1
+          else
+            echo "CLI documentation is up-to-date."
+            echo "Hash: $OLD_HASH"
+            echo "docs_outdated=false" >> $GITHUB_OUTPUT
+          fi
+          
+      - name: Comment on PR if documentation is outdated
+        if: ${{ steps.compare_docs.outputs.docs_outdated == 'true' }}
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const pull_request_number = context.issue.number;
+            const comment = `🚨 **CLI Documentation Check Failed** 🚨
+
+The CLI documentation in \`docs/cli.md\` is not up-to-date with the current code.
+
+**What to do:**
+1. Run the following command locally to update the documentation:
+   ```bash
+   typer pyaxm.cli utils docs --name pyaxm-cli --output docs/cli.md
+   ```
+2. Commit the updated \`docs/cli.md\` file
+3. Push your changes to update this pull request
+
+This ensures that the documentation always reflects the actual CLI functionality.`;
+            
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: pull_request_number,
+              body: comment
+            });

README.md

@@ -41,7 +41,19 @@ The token path is the location where the access token will be stored.
 ## CLI:
 A command-line interface (CLI) tool called `pyaxm-cli` is included for easy access to the API.
 
-For detailed usage instructions, available commands, options, and examples, please refer to the [CLI documentation](docs/cli.md).
+### Overview
+The CLI provides a convenient way to interact with the Apple Business Manager API directly from your terminal. It includes commands for managing devices, MDM servers, and retrieving device information.
+
+### Detailed Documentation
+For comprehensive documentation of all available commands, options, and usage examples, please refer to the [CLI documentation](docs/cli.md).
+
+### Updating Documentation
+The CLI documentation is automatically generated from the code. To update it after making changes to the CLI implementation, run:
+```bash
+typer pyaxm.cli utils docs --name pyaxm-cli --output docs/cli.md
+```
+
+A GitHub workflow automatically checks that the documentation stays in sync.
 
 # Client:
 Example usage: