test contracts

backend/src/core/task_manager/context.py

@@ -19,6 +19,20 @@ from ..logger import belief_scope
 # @TIER: CRITICAL
 # @INVARIANT: logger is always a valid TaskLogger instance.
 # @UX_STATE: Idle -> Active -> Complete
+#
+# @TEST_CONTRACT: TaskContextInit ->
+# {
+#   required_fields: {task_id: str, add_log_fn: Callable, params: dict},
+#   optional_fields: {default_source: str},
+#   invariants: [
+#       "task_id matches initialized logger's task_id",
+#       "logger is a valid TaskLogger instance"
+#   ]
+# }
+# @TEST_FIXTURE: valid_context -> {"task_id": "123", "add_log_fn": lambda *args: None, "params": {"k": "v"}, "default_source": "plugin"}
+# @TEST_EDGE: missing_task_id -> raises TypeError
+# @TEST_EDGE: missing_add_log_fn -> raises TypeError
+# @TEST_INVARIANT: logger_initialized -> verifies: [valid_context]
 class TaskContext:
     """
     Execution context provided to plugins during task execution.