From c07cf7cd81d3a2c8715414bdbfd601cce01157f6 Mon Sep 17 00:00:00 2001
From: Stuart Axelbrooke <stuart@axelbrooke.com>
Date: Mon, 15 Sep 2025 21:18:41 -0700
Subject: [PATCH] Add test descriptions

---
 databuild/orchestrator.rs | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/databuild/orchestrator.rs b/databuild/orchestrator.rs
index e07d7c9..1b2b429 100644
--- a/databuild/orchestrator.rs
+++ b/databuild/orchestrator.rs
@@ -153,6 +153,43 @@ impl<B: BELStorage + Debug> Orchestrator<B> {
 
 #[cfg(test)]
 mod tests {
+    mod poll_jobs {
+        // Use case: we find a job that has completed, BEL should be written with appropriate event
+        //  (both for success and fail cases)
+        #[test]
+        fn test_job_completion_events() {
+            // TODO
+        }
+
+        //Use case: a job has written new stdout, it should produce a new heartbeat event in the BEL
+        // TODO - we should come back here later and ensure we have a minimum heartbeat period
+        #[test]
+        fn test_heartbeat_from_stdout() {
+            // TODO
+        }
+    }
+
+    mod poll_wants {
+        // Use case: Empty schedulable wants is a valid case, and should create no new jobs.
+        #[test]
+        fn test_empty_wants_noop() {
+            // TODO
+        }
+
+        // Use case: Some schedulable wants with jobs that can be matched should launch those jobs
+        //  (but in this case using a noop/mock child process)
+        #[test]
+        fn test_schedulable_wants_should_schedule() {
+            // TODO
+        }
+
+        // Use case: A schedulable want that can't be matched to a job should return an error
+        #[test]
+        fn test_schedulable_want_no_matching_job() {
+            // TODO
+        }
+    }
+
     mod want_group {
         use super::super::*;
         use crate::build_event_log::MemoryBELStorage;