Emil Simeonov
e1173aeeb8
- Add CONTRIBUTING.md with branch naming, commit format, and PR workflow - Add TROUBLESHOOTING.md with common issues and solutions - Update README.md with CI badge and commit convention section - Update pyproject.toml with pythonpath and coverage settings for scripts
1.1 KiB
1.1 KiB
Troubleshooting
| Symptom | Likely Cause | Solution |
|---|---|---|
| Pre-commit rejects commit message | Missing conventional format or GRM-N prefix present | Use feat: description format without GRM-N: |
make molecule fails with runner_name is undefined |
Verify playbook missing variable | Fixed in Phase 1.1; ensure you're on latest master |
| CI molecule job fails | Docker not available on runner host | Ensure Gitea runner host has Docker installed and running |
| Auto-merge doesn't trigger | Label not exactly ready-to-merge or CI checks not all green |
Verify label spelling; check CI status |
| Vikunja task not updated after merge | VIKUNJA_TOKEN expired or task ID missing from commit | Regenerate token; verify merge commit has GRM-N: prefix |
| Post-merge can't find Vikunja task | Task not in project 6 or identifier mismatch | Verify task exists in Vikunja project 6 with correct identifier |
make pytest-cov fails |
Coverage below 100% | Add tests for new code paths |
scripts/configure_repo.py fails |
GITEA_ADMIN_TOKEN missing or invalid | Set token with repo admin scope and re-run |