q-blog/docs/CI_TROUBLESHOOTING.md

CI Troubleshooting

1) "Unable to pull refs/heads/v4: worktree contains unstaged changes"

The runner caches cloned actions (e.g., actions/checkout@v4). If those folders get modified, auto-update fails.

Fix (on the runner host): stop the runner, then clean caches.

# stop your gitea act runner first

# common cache locations (try any that exist)
CANDIDATES=(
  "$HOME/.cache/act/actions"
  "$HOME/.cache/actions"
  "$HOME/_actions"
  "/var/lib/act_runner/data/actions"
  "/var/lib/act_runner/_actions"
)

for d in "${CANDIDATES[@]}"; do
  if [ -d "$d" ]; then
    echo "Cleaning $d"
    rm -rf "$d"
  fi
done

# start the runner again

2) npm errors during "Install dependencies"

• Ensure package-lock.json is committed.
• If you purposely avoid a lockfile, CI will run npm install as a fallback.
• Verify Node/npm versions (workflow sets Node 20).

3) Workflow not triggering

• In the repo: Settings → Actions must be enabled.
• Ensure the file lives at: .gitea/workflows/ci-no-marketplace.yml.
• The runner must advertise labels that the workflow requires.