# 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.

```bash
# 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.