---
title: "Paths" component_type: script version: "1.0.0" audience: contributor status: stable summary: "Work Items Management - Pop-the-Top Task Automation for CODITECT" keywords: ['automation', 'database', 'items', 'work'] tokens: ~500 created: 2025-12-22 updated: 2025-12-22 script_name: "work_items.py" language: python executable: true usage: "python3 scripts/work_items.py [options]" python_version: "3.10+" dependencies: [] modifies_files: false network_access: false requires_auth: false
Work Items Management - Pop-the-Top Task Automation for CODITECT
Provides task queue management for the V2 project plan, enabling automatic selection and management of the next priority task.
Usage: python3 scripts/work_items.py next # Get next priority task python3 scripts/work_items.py next E001 # Next task from specific epic python3 scripts/work_items.py next --sprint Sprint-26 # Next task from sprint python3 scripts/work_items.py start E001-T001 # Mark task as in_progress python3 scripts/work_items.py complete E001-T001 # Mark task as completed python3 scripts/work_items.py show E001-T001 # Show task details python3 scripts/work_items.py dashboard # Show work overview python3 scripts/work_items.py search "query" # Search tasks
Version: 1.0.0
File: work_items.py
Functions
get_db()
Get database connection.
get_next_task(epic_id, sprint_id, task_type)
Get the next priority task that's planned (not started).
get_task_context(task_id)
Get full context for a task including hierarchy and related items.
update_task_status(task_id, new_status)
Update task status and return result.
start_task(task_id)
Mark a task as in_progress.
complete_task(task_id)
Mark a task as completed.
search_tasks(query, status, task_type, limit)
Search tasks by title/description.
get_dashboard()
Get work item dashboard overview.
print_task_details(task, full)
Pretty print task details.
print_dashboard(dashboard)
Pretty print dashboard.
main()
No description
Usage
python work_items.py