Upload README.md

README.md

@@ -1,3 +1,23 @@
----
-license: mit
----
+# viet-robot-task-priority-sorter
+
+A tiny helper that sorts robot tasks by priority and deadline, so that a
+scheduler or agent can pick the next best task to execute.
+
+Function:
+
+```python
+sort_tasks(tasks: list[TaskItem]) -> list[TaskItem]
+```
+
+where each `TaskItem` has:
+
+- `task_id`: string
+- `priority`: `low`, `normal`, `high`, or `urgent`
+- `deadline_local`: datetime string parseable by `datetime.fromisoformat`
+
+Tasks are ordered primarily by priority (urgent → high → normal → low),
+then by earliest deadline.
+
+## License
+
+MIT