trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/changes/pg-boss-background-jobs/specs/planner-session/spec.md
Ullrich Schäfer 32c5fbde8f Add pg-boss background job queue with session expiry 
Add @trails-cool/jobs package wrapping pg-boss for durable background job
execution using the existing PostgreSQL database. Wire up planner session
expiry as the first scheduled job (hourly, 7-day TTL) — this was previously
dead code that never ran. Add placeholder worker to journal for future
Komoot import and federation jobs.

Infrastructure: grant grafana_reader access to pgboss schema, add job queue
health panels to Service Health dashboard, add failed job alert.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 21:17:24 +02:00

781 B
Raw Blame History

MODIFIED Requirements

Requirement: Session expiry

Open sessions with no activity for 7 days SHALL be automatically deleted by a scheduled background job.

Scenario: Stale session cleanup

  • WHEN the hourly expire-sessions cron job runs
  • THEN all sessions with last_activity older than 7 days are deleted from the database
  • AND their Yjs documents are removed from memory

Scenario: Active session preserved

  • WHEN the expire-sessions job runs
  • THEN sessions with last_activity within the last 7 days are NOT deleted

Scenario: Cleanup is observable

  • WHEN the expire-sessions job completes
  • THEN the job output includes the count of expired sessions
  • AND the result is visible in the Grafana job queue dashboard