added timing

data_acq_and_processing/common_cpp/ipc/include/shared_types.hpp

@@ -83,6 +83,11 @@ struct ResultBlock {
 struct ResultCollection {
     std::uint64_t collection_id = 0;
     std::uint64_t monotonic_ns = 0;
+    // Wall-clock duration of `process_collection()` for this collection,
+    // measured on the data_processor side with a monotonic clock. Used by the
+    // Python pipeline to report processing-time metrics. Zero is a valid
+    // "unmeasured" sentinel for legacy producers.
+    std::uint64_t processing_duration_ns = 0;
     std::vector<ResultPayload> collection_payloads{};
     std::vector<ResultBlock> blocks{};
 };

data_acq_and_processing/common_cpp/ipc/src/shared_types.cpp

@@ -14,7 +14,7 @@ namespace {
 
 constexpr std::uint32_t kRawCollectionMagic = 0x32574152U;      // RAW2
 constexpr std::uint32_t kPreprocessedCollectionMagic = 0x32525050U;  // PRP2
-constexpr std::uint32_t kResultCollectionMagic = 0x314C5352U;   // RSL1
+constexpr std::uint32_t kResultCollectionMagic = 0x324C5352U;   // RSL2
 
 template <typename T>
 concept TriviallySerializable = std::is_trivially_copyable_v<T>;
@@ -408,6 +408,7 @@ auto serialize_result_collection(const ResultCollection& collection) -> std::vec
     writer.write(kResultCollectionMagic);
     writer.write(collection.collection_id);
     writer.write(collection.monotonic_ns);
+    writer.write(collection.processing_duration_ns);
     writer.write(checked_count_to_u32(collection.collection_payloads.size(), "Collection payload count"));
     writer.write(checked_count_to_u32(collection.blocks.size(), "Result block count"));
 
@@ -432,6 +433,7 @@ auto deserialize_result_collection(std::span<const std::uint8_t> bytes) -> Resul
     ResultCollection collection{};
     collection.collection_id = reader.read<std::uint64_t>();
     collection.monotonic_ns = reader.read<std::uint64_t>();
+    collection.processing_duration_ns = reader.read<std::uint64_t>();
 
     const auto collection_payload_count = reader.read<std::uint32_t>();
     const auto block_count = reader.read<std::uint32_t>();