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
13 lines
1.1 KiB
Markdown
13 lines
1.1 KiB
Markdown
# 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 |
|