Add permissions for GitHub Action (#263)

Author: JakeSCahill

.github/workflows/update-docs.yml

@@ -6,15 +6,19 @@ on:
     types: [generate-rpcn-docs]
 
 jobs:
-  generate-and-pr:
+  generate-docs-and-submit-pull-request:
     runs-on: ubuntu-latest
 
+    permissions:
+      id-token: write
+      contents: read
+
     concurrency:
       group: update-rpcn-connector-docs
       cancel-in-progress: true
 
     env:
-      NODE_VERSION: '16'
+      NODE_VERSION: '18'
       DOCS_OVERRIDES: docs-data/overrides.json
 
     steps:
@@ -40,7 +44,12 @@ jobs:
           cache: 'npm'
 
       - name: Install dependencies
-        run: npm ci
+        run: npm install
+
+      - name: Install tools
+        run: |
+          npx doc-tools install-test-dependencies
+          rpk connect install
 
       - name: Generate RPCN Connector docs
         id: generate
@@ -50,36 +59,18 @@ jobs:
             --overrides $DOCS_OVERRIDES \
             --draft-missing > full_output.txt
 
-          # Extract full delta report block (stopping at the first non-bullet or EOF)
-          awk '/📋 RPCN Connector Delta Report/{flag=1; next} flag {if (/^➤/ || /^•/) print; else exit}' full_output.txt > raw_delta.txt
-
-          {
-            echo "📋 RPCN Connector Delta Report"
-            echo ""
-
-            if grep -q 'components:' raw_delta.txt; then
-              echo "<details>"
-              echo "<summary>Newly added components:</summary>"
-              grep '• ' raw_delta.txt | grep 'components:' -A 1000 | grep -v 'fields:' | grep '• ' | sed 's/• /- /'
-              echo "</details>"
-              echo ""
-            fi
-
-            if grep -q 'fields:' raw_delta.txt; then
-              echo "<details>"
-              echo "<summary>Newly added fields:</summary>"
-              grep '• ' raw_delta.txt | grep 'fields:' -A 1000 | sed 's/• /- /'
-              echo "</details>"
-            fi
-          } > delta_report.md
-
-          # Set multiline output safely
           {
             echo "delta_report<<EOF"
-            cat delta_report.md
+            echo "<details><summary>RPCN Connector Generation Output</summary>"
+            echo ""
+            cat full_output.txt
+            echo ""
+            echo "</details>"
             echo "EOF"
           } >> "$GITHUB_OUTPUT"
 
+          rm -f full_output.txt delta_report.md
+
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v6
         with: