test(js): isolate frontmatter GitHub API test as integration (#27213)

Author: Copilot

.github/workflows/ci.yml

@@ -377,11 +377,11 @@ jobs:
         if [ -z "$GITHUB_TOKEN" ]; then
           echo "⚠️ GITHUB_TOKEN not available - test will be skipped" >> $GITHUB_STEP_SUMMARY
           echo "ℹ️ This is expected in forks or when secrets are not available" >> $GITHUB_STEP_SUMMARY
-          cd actions/setup/js && npm test -- frontmatter_hash_github_api.test.cjs
+          cd actions/setup/js && npm run test:js-integration-live-api
         else
           echo "✅ GITHUB_TOKEN available - running live API test" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
-          cd actions/setup/js && npm test -- frontmatter_hash_github_api.test.cjs
+          cd actions/setup/js && npm run test:js-integration-live-api
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "✨ Live API test completed successfully" >> $GITHUB_STEP_SUMMARY
         fi

actions/setup/js/TESTING_LIVE_API.md

@@ -4,20 +4,20 @@ This directory includes tests for the JavaScript frontmatter hash implementation
 
 ## Running Tests
 
-### Standard Test Suite (with mocks)
+### Integration Test Suite (not part of default `npm run test:js`)
 ```bash
-npm test -- frontmatter_hash_github_api.test.cjs
+npm run test:js-integration-live-api
 ```
 
-This runs all tests including mocked GitHub API calls.
+This runs `frontmatter_hash_github_api.test.cjs`, including mocked GitHub API coverage and the optional live API check.
 
 ### Live GitHub API Test (no mocks)
 
 The test suite includes a live API test that fetches real data from the GitHub repository. To run it, you need a GitHub token:
 
-#### Option 1: Run via npm test
+#### Option 1: Run via npm integration script
 ```bash
-GITHUB_TOKEN=ghp_your_token_here npm test -- frontmatter_hash_github_api.test.cjs
+GITHUB_TOKEN=ghp_your_token_here npm run test:js-integration-live-api
 ```
 
 #### Option 2: Run standalone script
@@ -56,7 +56,7 @@ This validates that the JavaScript hash implementation works correctly with real
 stdout | frontmatter_hash_github_api.test.cjs > live GitHub API integration > should compute hash using real GitHub API (no mocks)
 Skipping live API test - no GITHUB_TOKEN or GH_TOKEN available
 To run this test, set GITHUB_TOKEN or GH_TOKEN environment variable
-Example: GITHUB_TOKEN=ghp_xxx npm test -- frontmatter_hash_github_api.test.cjs
+Example: GITHUB_TOKEN=ghp_xxx npm run test:js-integration-live-api
 
  ✓ frontmatter_hash_github_api.test.cjs (10 tests) 16ms
 ```

actions/setup/js/frontmatter_hash_github_api.test.cjs

@@ -378,7 +378,7 @@ describe("frontmatter_hash with GitHub API", () => {
       if (!token) {
         console.log("Skipping live API test - no GITHUB_TOKEN or GH_TOKEN available");
         console.log("To run this test, set GITHUB_TOKEN or GH_TOKEN environment variable");
-        console.log("Example: GITHUB_TOKEN=ghp_xxx npm test -- frontmatter_hash_github_api.test.cjs");
+        console.log("Example: GITHUB_TOKEN=ghp_xxx npm run test:js-integration-live-api");
         return;
       }
 

actions/setup/js/package.json

@@ -23,6 +23,7 @@
     "typecheck": "tsc --noEmit",
     "test": "npm run typecheck && vitest run --no-file-parallelism",
     "test:js": "vitest run",
+    "test:js-integration-live-api": "vitest run --config vitest.integration.config.mjs --no-file-parallelism",
     "test:js-watch": "vitest",
     "test:js-coverage": "vitest run --coverage",
     "format:cjs": "npx prettier --write '**/*.cjs' '**/*.ts' '**/*.json' --ignore-path ../../../.prettierignore",

actions/setup/js/vitest.config.mjs

@@ -1,10 +1,11 @@
-import { defineConfig } from "vitest/config";
+import { configDefaults, defineConfig } from "vitest/config";
 
 export default defineConfig({
   test: {
     environment: "node",
     globals: true,
     include: ["**/*.test.{js,cjs}"],
+    exclude: ["**/frontmatter_hash_github_api.test.cjs", ...configDefaults.exclude],
     testTimeout: 10000,
     hookTimeout: 10000,
     coverage: {

actions/setup/js/vitest.integration.config.mjs

@@ -0,0 +1,11 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: true,
+    include: ["frontmatter_hash_github_api.test.cjs"],
+    testTimeout: 30000,
+    hookTimeout: 10000,
+  },
+});