Guides
Tasks and pipelines
The nine V03 task contracts, queue model, review gate, and operations controls.
The TypeScript task registry is the only executable source of truth. Postgres stores immutable definition metadata and run snapshots; it never stores executable functions.
Every definition fixes its input and output schema, version, owner, risk, side effect, model policy, prompt, tools, quality threshold, cost budget, retry policy, timeout, and idempotency function.
Execution model
The Scheduler and manual/API triggers write task.execution.requested Outbox events. The Worker claims an event with a lease, validates the payload again, executes the registered workflow, writes checkpoints and usage, then creates an Inbox receipt. Five exhausted delivery attempts create a dead letter.
Site managers triage unresolved dead letters on Admin → Tasks. Replaying an Outbox dead letter requires recent authentication and an investigation note, atomically resets only a dead or failed event, and relies on the Inbox receipt to prevent duplicate effects. A non-replayable exception can be resolved with a required note. Both paths write the action ledger in the same transaction; repeated or cross-Site commands fail closed.
Equivalent manual requests reuse one deterministic event. A forced rerun creates a new execution only when the operator provides a reason.
Model-driven tasks create reviewable output and suspend. Review approval is parameter-bound, Site-bound, single-use, recently authenticated, and race-safe. Rejection records a reason and prevents publication.
The nine tasks
ranking-watcher
Reads approved ranking sources and records provenance-bound candidate signals. It makes no publication decision.
crawl
Uses the isolated browser or bounded HTTP fetcher, validates every destination and redirect against SSRF policy, stores a content-addressed snapshot, and classifies availability.
enrich
Produces schema-validated semantic and commercial candidate fields. The enrichment fingerprint includes content, prompt, schema, and model-policy versions. A deterministic quality score remains separate from model confidence.
change-detect
Compares two versioned structured snapshots and records evidence-backed field changes. It does not interpret unrelated page noise.
dimension-builder
Materializes a reviewable Dimension page from approved membership, provenance, schema, and publication policy.
task-builder
Derives task Dimensions from an approved parent Dimension and maintains the deterministic daily matchup candidate.
workflow-builder
Builds workflow DAG candidates from approved task Dimensions, validates graph structure, and preserves shared-node context through edges.
ai-digest
Synthesizes a cited period digest as a draft ContentItem. It cannot publish itself.
audit
Evaluates Site, Link, Dimension, TaskRun, and release invariants deterministically and emits blocking findings for release gates.
Legacy /api/cron/* routes are permanently retired and return 410 Gone with the replacement task identifiers.