Add auto-commit step for generated CLI docs in CI

The CI workflow now commits updated CLI documentation back to the PR
branch when changes are detected. This ensures the generated docs
stay in sync with the CLI.

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: kylemclaren

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ on:
       - '*.md'
 
 permissions:
-  contents: read
+  contents: write
   pull-requests: write
 
 jobs:
@@ -20,6 +20,9 @@ jobs:
       cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+          token: ${{ secrets.GITHUB_TOKEN }}
 
       - uses: pnpm/action-setup@v4
         with:
@@ -49,6 +52,18 @@ jobs:
       - name: Generate CLI Docs
         run: pnpm generate:cli-docs
 
+      - name: Commit generated CLI docs
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          if git diff --quiet src/content/docs/cli/commands.mdx; then
+            echo "No changes to CLI docs"
+          else
+            git add src/content/docs/cli/commands.mdx
+            git commit -m "Update auto-generated CLI documentation"
+            git push
+          fi
+
       - name: Build
         run: pnpm build