Github Actions Troubleshooting

Example error:

Run npm run test -- --coverage

> [email protected] test
> jest --coverage

No tests found, exiting with code 1

Parse this as:

• Command: npm run test -- --coverage
• Problem: No tests found, jest exiting with code 1
• Likely fix needed: Add --passWithNoTests flag

Step 2: Locate the Failing Step

Read the workflow file at the specified line:

# If user mentions line 232 of deploy-stacks-main.yml

Look for:

• The name: of the step
• The run: command being executed
• Any working-directory: specified
• Conditional if: statements

Example:

- name: Stack Unit Tests
  working-directory: ./stacks/${{ matrix.stack_env.stack }}
  run: npm run test -- --coverage

Step 3: Identify the Root Cause

Common failure patterns:

Tests not found:

• Symptom: "No tests found, exiting with code 1"
• Cause: Test files deleted or no tests exist
• Fix: Add --passWithNoTests flag to jest command

Module not found:

• Symptom: "Cannot find module './some-file'"
• Cause: File deleted but still imported
• Fix: Remove import or restore file

Command not found:

• Symptom: "command not found: some-command"
• Cause: Missing dependency or wrong command name
• Fix: Install dependency or correct command

Wrong working directory:

• Symptom: "package.json not found" or similar
• Cause: Command run in wrong directory
• Fix: Update working-directory in workflow

Step 4: Determine Where to Fix

Fix in workflow file when:

• Issue is with how the step runs (flags, directory, conditions)
• Need to add/remove pipeline-specific configuration
• Example: Adding --passWithNoTests to workflow run command

Fix in package.json when:

• Issue affects both local and CI execution
• Test script needs permanent modification
• Want consistent behavior everywhere
• Example: Changing test script to include --passWithNoTests by default

Fix in source code when:

• Actual code/test failure
• Import errors, type errors, etc.
• Test assertions failing

Step 5: Apply the Fix

Update the appropriate file(s) and verify:

Workflow file fix:

# Before