webdev-pipeline/backlog/tasks/task-16 - Orchestrate-recurring-Convex-agent-jobs-and-audit-lifecycle.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	references	priority	ordinal
TASK-16	Orchestrate recurring Convex agent jobs and audit lifecycle	In Progress		2026-06-03 19:14	2026-06-05 19:49	mvp convex jobs	TASK-6 TASK-12 TASK-15	PRD.md	high	16000

Description

Implement the scheduled and manual background workflow using Convex. The MVP permits only one active agent run at a time, supports campaign cron runs and manual Jetzt ausführen runs, and manages public audit lifecycle notifications and deactivation.

Acceptance Criteria

• #1 Convex cron or scheduled functions trigger active campaigns according to cadence
• #2 Jetzt ausführen starts a campaign run immediately only when no other agent run is active
• #3 Cron skips or queues safely when an agent run is already active, with visible run logs
• #4 Published audits older than 30 days create dashboard notifications asking whether to keep active
• #5 Published audits older than 60 days auto-deactivate unless manually extended or later reactivated

Implementation Plan

1. Add global agent-run lock or equivalent single-active-run guard.
2. Implement scheduled campaign runner using Convex cron/scheduling.
3. Wire manual Jetzt ausführen to the same runner and limits.
4. Add run logs and dashboard-visible status updates.
5. Add audit lifecycle checks for 30-day notification, 60-day deactivation, and reactivation.

Implementation Notes

Started implementation pass for recurring Convex agent jobs, run locking, logs, and audit lifecycle.

Implemented and verified Convex crons, due-campaign runner, single-active-run guard, visible campaign run logs, and audit lifecycle notification/deactivation controls. Verification: pnpm test 305/305; pnpm lint 0 errors.