Clean up env vars and fix retrospective last-Sunday check

- .env/.env.example: remove JWT_EXPIRES_IN, VITE_APP_NAME, HF_SPACE_URL, HF_TOKEN
(none are read by code; HF_TOKEN is a GitHub Actions secret only)
- retrospective/run_retrospective.py: use America/Chicago timezone in
is_last_sunday_of_month() so Mon-5AM-UTC cron is still Sunday in CST;
also honour FORCE_RUN env var to let admin workflow_dispatch bypass date check
- retrospective.yml: call script with --triggered-by flag (argparse, not sys.argv)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.env.example

@@ -11,17 +11,12 @@ DATABASE_URL=postgresql://user:pass@host/db?sslmode=require
 
 # ── NestJS API ───────────────────────────────────────────────────────────────
 JWT_SECRET=change-me-to-a-long-random-string
-JWT_EXPIRES_IN=7d
 API_PORT=3000
 
-# ── Vue UI (VITE_ prefix exposes vars to the browser) ────────────────────────
+# ── Vue UI ───────────────────────────────────────────────────────────────────
 VITE_API_URL=http://localhost:3000/api
 
-# ── HuggingFace Deployment ───────────────────────────────────────────────────
-HF_SPACE_URL=https://huggingface.co/spaces/<username>/<space-name>
-HF_TOKEN=hf_...
-
-# ── GitHub (artifacts + workflow dispatch) ───────────────────────────────────
+# ── GitHub (artifact storage + workflow dispatch) ─────────────────────────────
 GITHUB_TOKEN=github_pat_...
 GITHUB_REPO=<owner>/<repo>
 ARTIFACTS_PATH=https://github.com/<owner>/<artifacts-repo>/<prefix>

.github/workflows/retrospective.yml

@@ -37,4 +37,4 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
           ARTIFACTS_PATH: ${{ secrets.ARTIFACTS_PATH }}
           FORCE_RUN: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.force || 'false' }}
-        run: python -m agents.retrospective.run_retrospective scheduler
+        run: python -m agents.retrospective.run_retrospective --triggered-by scheduler

agents/retrospective/run_retrospective.py

@@ -18,13 +18,14 @@ from sqlalchemy import select
 
 
 def is_last_sunday_of_month() -> bool:
-    today = date.today()
+    # Use CST/CDT — the cron fires Mon 5AM UTC which is still Sunday in Chicago
+    import pytz
+    chicago = pytz.timezone("America/Chicago")
+    today = datetime.now(chicago).date()
     if today.weekday() != 6:  # 6 = Sunday
         return False
-    # Is next Sunday in a different month?
-    next_sunday = today.day + 7
     _, days_in_month = monthrange(today.year, today.month)
-    return next_sunday > days_in_month
+    return (today.day + 7) > days_in_month
 
 
 def get_previous_month(today: date) -> tuple[int, int]:
@@ -105,4 +106,6 @@ if __name__ == "__main__":
     parser.add_argument("--force", action="store_true", help="Run regardless of date")
     parser.add_argument("--triggered-by", default="manual")
     args = parser.parse_args()
-    main(args.triggered_by, args.force)
+    # FORCE_RUN env var (set by GitHub Actions workflow_dispatch) overrides --force
+    force = args.force or os.getenv("FORCE_RUN", "false").lower() == "true"
+    main(args.triggered_by, force)