From 786953c4031bc41fc916c72479d9770a2b9d6875 Mon Sep 17 00:00:00 2001 From: Bu5hm4nn Date: Sun, 29 Mar 2026 12:10:52 +0200 Subject: [PATCH] docs: add verified Forgejo CI debugging guide to AGENTS.md Verified: - Web UI URL for viewing workflow runs - SSH command to access runner logs - Common failure patterns and fixes --- .forgejo/workflows/deploy.yaml | 1 - AGENTS.md | 24 ++++++++++++++++++++++++ scripts/deploy-forgejo.sh | 1 - 3 files changed, 24 insertions(+), 2 deletions(-) diff --git a/.forgejo/workflows/deploy.yaml b/.forgejo/workflows/deploy.yaml index 796e652..533c691 100644 --- a/.forgejo/workflows/deploy.yaml +++ b/.forgejo/workflows/deploy.yaml @@ -136,7 +136,6 @@ jobs: APP_PORT: "8000" TURNSTILE_SITE_KEY: ${{ vars.TURNSTILE_SITE_KEY }} TURNSTILE_SECRET_KEY: ${{ secrets.TURNSTILE_SECRET_KEY }} - DATABENTO_API_KEY: ${{ secrets.DATABENTO_API_KEY }} steps: - uses: actions/checkout@v4 diff --git a/AGENTS.md b/AGENTS.md index 745c51e..836a722 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -88,3 +88,27 @@ validation_checklist: - no visible 500/runtime error - screenshot artifact captured when useful - relevant logs checked + +forgejo_ci: + viewing_job_logs: + web_ui: + url: "http://git.uncloud.vpn:3000/bu5hm4nn/vault-dash/actions" + steps: + - Navigate to Actions tab in Forgejo UI (VPN access required) + - Click on the workflow run to see job status + - Expand failing job (lint/test/type-check/build/deploy) + - Click on failed step to see detailed logs + runner_logs: + ssh: "ssh root@5.75.141.4" + command: "docker logs forgejo-runner --tail 100" + job_workspace: "/opt/forgejo-runner/data/" + common_failures: + missing_dependency: + symptom: "ModuleNotFoundError: No module named 'X'" + fix: "Add package to requirements.txt AND .forgejo/workflows/deploy.yaml (test + type-check jobs)" + type_error: + symptom: "error: Incompatible types..." + fix: "Run `mypy app --ignore-missing-imports` locally to reproduce" + test_failure: + symptom: "FAILED test_name" + fix: "Run failing test locally with pytest -xvs" diff --git a/scripts/deploy-forgejo.sh b/scripts/deploy-forgejo.sh index 3c947d7..494976b 100755 --- a/scripts/deploy-forgejo.sh +++ b/scripts/deploy-forgejo.sh @@ -47,7 +47,6 @@ NICEGUI_STORAGE_SECRET=${NICEGUI_STORAGE_SECRET:-} CORS_ORIGINS=${CORS_ORIGINS:-*} TURNSTILE_SITE_KEY=${TURNSTILE_SITE_KEY:-} TURNSTILE_SECRET_KEY=${TURNSTILE_SECRET_KEY:-} -DATABENTO_API_KEY=${DATABENTO_API_KEY:-} EOF # Upload docker-compose file