feat: Add js-libp2p Echo Protocol Interoperability Tests

.github/actions/detect-changed-impls/action.yml

@@ -3,7 +3,7 @@ description: "Detect which implementations/relays/routers have changed in images
 
 inputs:
   test-type:
-    description: "Type of test (transport, hole-punch, or perf)"
+    description: "Type of test (transport, hole-punch, perf, or misc)"
     required: true
   base-ref:
     description: "Base branch to compare against"
@@ -55,8 +55,11 @@ runs:
         elif [ "$TEST_TYPE" = "perf" ]; then
           IMPLS_FILE="perf/images.yaml"
           IMAGES_DIR="perf/images"
+        elif [ "$TEST_TYPE" = "misc" ]; then
+          IMPLS_FILE="misc/images.yaml"
+          IMAGES_DIR="misc/images"
         else
-          echo "Error: Invalid test-type. Must be 'transport', 'hole-punch', or 'perf'"
+          echo "Error: Invalid test-type. Must be 'transport', 'hole-punch', 'perf', or 'misc'"
           exit 1
         fi
 
@@ -201,6 +204,8 @@ runs:
                   FULL_SOURCE_PATH="hole-punch/$SOURCE_PATH"
                 elif [ "$TEST_TYPE" = "perf" ]; then
                   FULL_SOURCE_PATH="perf/$SOURCE_PATH"
+                elif [ "$TEST_TYPE" = "misc" ]; then
+                  FULL_SOURCE_PATH="misc/$SOURCE_PATH"
                 fi
 
                 # Check if changed file is within this source path

.github/actions/run-bash-misc-test/action.yml

@@ -0,0 +1,156 @@
+name: "Run Misc Protocol Interop Tests (Bash)"
+description: "Run the miscellaneous protocol interoperability test suite (ping, echo, identify) using bash scripts"
+
+inputs:
+  test-select:
+    description: "Select tests (pipe-separated substrings)"
+    required: false
+    default: ""
+  test-ignore:
+    description: "Ignore tests (pipe-separated substrings)"
+    required: false
+    default: ""
+  protocol-select:
+    description: "Select protocols to test (pipe-separated, e.g. 'ping|echo')"
+    required: false
+    default: ""
+  protocol-ignore:
+    description: "Ignore protocols (pipe-separated, e.g. '~failing')"
+    required: false
+    default: ""
+  cache-dir:
+    description: "Local directory to use for build cache"
+    required: false
+    default: "/srv/cache"
+  snapshot:
+    description: "Create test pass snapshot after completion"
+    required: false
+    default: "false"
+  force-matrix-rebuild:
+    description: "Force test matrix regeneration (bypass cache)"
+    required: false
+    default: "false"
+  force-image-rebuild:
+    description: "Force Docker image rebuilds (bypass cache)"
+    required: false
+    default: "false"
+  debug:
+    description: "Enable debug mode (sets DEBUG=true in test containers)"
+    required: false
+    default: "false"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install docker-compose
+      shell: bash
+      run: |
+        mkdir -p $HOME/.docker/cli-plugins
+        wget -q -O- https://github.com/docker/compose/releases/download/v2.21.0/docker-compose-linux-x86_64 > $HOME/.docker/cli-plugins/docker-compose
+        chmod +x $HOME/.docker/cli-plugins/docker-compose
+        docker compose version
+
+    - name: Run misc protocol interop tests
+      shell: bash
+      working-directory: misc
+      run: |
+        set -uo pipefail
+
+        # Capture exit code but don't fail immediately
+        EXIT_CODE=0
+
+        SNAPSHOT_FLAG=""
+        if [ "${{ inputs.snapshot }}" = "true" ]; then
+          SNAPSHOT_FLAG="--snapshot"
+        fi
+
+        FORCE_MATRIX_FLAG=""
+        if [ "${{ inputs.force-matrix-rebuild }}" = "true" ]; then
+          FORCE_MATRIX_FLAG="--force-matrix-rebuild"
+        fi
+
+        FORCE_IMAGE_FLAG=""
+        if [ "${{ inputs.force-image-rebuild }}" = "true" ]; then
+          FORCE_IMAGE_FLAG="--force-image-rebuild"
+        fi
+
+        DEBUG_FLAG=""
+        if [ "${{ inputs.debug }}" = "true" ]; then
+          DEBUG_FLAG="--debug"
+        fi
+
+        PROTOCOL_SELECT_FLAG=""
+        if [ -n "${{ inputs.protocol-select }}" ]; then
+          PROTOCOL_SELECT_FLAG="--protocol-select '${{ inputs.protocol-select }}'"
+        fi
+
+        PROTOCOL_IGNORE_FLAG=""
+        if [ -n "${{ inputs.protocol-ignore }}" ]; then
+          PROTOCOL_IGNORE_FLAG="--protocol-ignore '${{ inputs.protocol-ignore }}'"
+        fi
+
+        eval ./run.sh \
+          --test-select "'${{ inputs.test-select }}'" \
+          --test-ignore "'${{ inputs.test-ignore }}'" \
+          --cache-dir "'${{ inputs.cache-dir }}'" \
+          $SNAPSHOT_FLAG \
+          $FORCE_MATRIX_FLAG \
+          $FORCE_IMAGE_FLAG \
+          $DEBUG_FLAG \
+          $PROTOCOL_SELECT_FLAG \
+          $PROTOCOL_IGNORE_FLAG \
+          -y || EXIT_CODE=$?
+
+        # Save exit code for later
+        echo "$EXIT_CODE" > /tmp/misc-test-exit-code.txt
+
+    - name: Find test pass directory
+      if: always()
+      id: find-test-pass
+      shell: bash
+      run: |
+        # Find the most recent test pass directory
+        TEST_PASS_DIR=$(ls -td ${{ inputs.cache-dir }}/test-run/misc-* 2>/dev/null | grep -v '\.zip$' | head -1 || echo "")
+
+        if [ -z "$TEST_PASS_DIR" ]; then
+          echo "Error: Could not find test pass directory"
+          exit 1
+        fi
+
+        TEST_PASS_NAME=$(basename "$TEST_PASS_DIR")
+        echo "test-pass-dir=$TEST_PASS_DIR" >> $GITHUB_OUTPUT
+        echo "test-pass-name=$TEST_PASS_NAME" >> $GITHUB_OUTPUT
+        echo "→ Test pass: $TEST_PASS_NAME"
+
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: misc-test-results-${{ steps.find-test-pass.outputs.test-pass-name }}
+        path: |
+          ${{ steps.find-test-pass.outputs.test-pass-dir }}/results.yaml
+          ${{ steps.find-test-pass.outputs.test-pass-dir }}/results.md
+          ${{ steps.find-test-pass.outputs.test-pass-dir }}/results.html
+          ${{ steps.find-test-pass.outputs.test-pass-dir }}/LATEST_TEST_RESULTS.md
+        if-no-files-found: warn
+
+    - name: Upload snapshot archive
+      if: always() && inputs.snapshot == 'true'
+      uses: actions/upload-artifact@v4
+      with:
+        name: misc-snapshot-${{ steps.find-test-pass.outputs.test-pass-name }}
+        path: |
+          ${{ steps.find-test-pass.outputs.test-pass-dir }}
+        if-no-files-found: error
+
+    - name: Fail if tests failed
+      if: always()
+      shell: bash
+      run: |
+        if [ -f /tmp/misc-test-exit-code.txt ]; then
+          EXIT_CODE=$(cat /tmp/misc-test-exit-code.txt)
+          if [ "$EXIT_CODE" -ne 0 ]; then
+            echo "Tests failed with exit code $EXIT_CODE"
+            exit $EXIT_CODE
+          fi
+        fi