feature: add SSH debugging workflow for emoji width measurement

- Interactive workflow allows SSH access to macOS GitHub Actions runner
- Users can manually run measure-emoji-widths.sh and capture actual values
- Provides instructions for measuring and updating emoji-widths.json
- 10-minute SSH session timeout
- Useful for gathering precise emoji width measurements for Apple_Terminal or iTerm.app

Author: cowwoc

.github/workflows/measure-emoji-widths-macos.yml

@@ -0,0 +1,77 @@
+# Copyright (c) 2026 Gili Tzabari. All rights reserved.
+#
+# Licensed under the CAT Commercial License.
+# See LICENSE.md in the project root for license terms.
+name: Measure Emoji Widths (macOS)
+
+on:
+  workflow_dispatch:
+    inputs:
+      terminal_type:
+        description: 'Terminal to measure (apple_terminal or iterm)'
+        required: false
+        default: 'apple_terminal'
+        type: choice
+        options:
+          - apple_terminal
+          - iterm
+
+jobs:
+  measure:
+    runs-on: macos-latest
+    timeout-minutes: 60
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Instructions for SSH measurement
+        run: |
+          echo "=========================================="
+          echo "Emoji Width Measurement - SSH Debugging"
+          echo "=========================================="
+          echo ""
+          echo "To measure emoji widths on this macOS runner:"
+          echo ""
+          echo "1. Wait for the 'Enable SSH debugging' step to complete"
+          echo "2. Copy the SSH command from the output"
+          echo "3. SSH into the runner (paste the command in your terminal)"
+          echo "4. Run one of these commands:"
+          echo ""
+          echo "   # Text output:"
+          echo "   ./plugin/scripts/measure-emoji-widths.sh"
+          echo ""
+          echo "   # JSON output (recommended):"
+          echo "   ./plugin/scripts/measure-emoji-widths.sh --json"
+          echo ""
+          echo "5. Copy the output"
+          echo "6. Close the SSH session (ctrl+d or 'exit')"
+          echo "7. Create a GitHub issue with the measurements"
+          echo ""
+          echo "The SSH session will stay open for ~10 minutes while you measure."
+          echo "=========================================="
+
+      - name: Enable SSH debugging
+        uses: mxschmitt/action-tmate@v3
+        with:
+          limit-output-lines: 100
+          timeout-minutes: 10
+
+      - name: Measurement instructions for manual update
+        run: |
+          echo "If you completed the measurement, please:"
+          echo ""
+          echo "1. Copy the JSON output from your SSH session"
+          echo "2. Update plugin/emoji-widths.json with the actual measurements"
+          echo "3. Create a pull request with the updated widths"
+          echo ""
+          echo "Example JSON from measurement script:"
+          echo '{'
+          echo '  "terminal": "Apple_Terminal",'
+          echo '  "widths": {'
+          echo '    "☑️": 2,'
+          echo '    "🔄": 2,'
+          echo '    ...'
+          echo '  }'
+          echo '}'
+          echo ""
+          echo "Use the widths object to update emoji-widths.json terminals section."