bump_overdue_priority

Category: tasks
Access: write
Audience: advanced (ordinary users do not normally call this directly)

Purpose

Raises every past-due live task below the target priority up to that priority. A maintenance pass for making overdue work surface again in priority order.

Arguments

Optional: target_priority.

target_priority. Note: Must be low, medium, high, or critical (default high). Only tasks strictly below it move. Targeting low is a no-op reporting bumped 0 with an explanatory message.

Result

JSON object with bumped (how many raised) and target_priority. Targeting the bottom rung returns bumped 0 with a message instead.

Boundaries

Only past-due live tasks (type task) visible under the caller's project grants are candidates; finished content and foreign projects are never touched. With no visible scope the sweep succeeds with bumped 0.

Lifecycle / side effects

Each raise travels through the canonical mutation path and records an audit/history event, so the escalation stays attributable.

Errors

Bad types are rejected (strict validator). An unknown priority name is rejected with Invalid priority. Failures raise nothing (atomic).

Example

{
  "target_priority": "high"
}

Result shape:

{
  "bumped": 2,
  "target_priority": "high"
}