From 0fa7cfdf9b76211b6eea4c9ca7930daa96c707a3 Mon Sep 17 00:00:00 2001
From: jordan <jordan.washburn@gmail.com>
Date: Sat, 7 Mar 2026 02:54:10 -0700
Subject: [PATCH] fix: restore missing doc comments on aphoria DTOs (build
 failure)

---
 applications/aphoria/src/hosted.rs | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/applications/aphoria/src/hosted.rs b/applications/aphoria/src/hosted.rs
index 92e582a..4161ad5 100644
--- a/applications/aphoria/src/hosted.rs
+++ b/applications/aphoria/src/hosted.rs
@@ -32,39 +32,56 @@ pub struct HostedClient {
 /// Request payload for pushing observations (team storage).
 #[derive(Debug, Clone, Serialize)]
 pub struct PushObservationsRequest {
+    /// Batch of observations to store.
     pub observations: Vec<ObservationDto>,
+    /// Project identifier.
     pub project_id: String,
+    /// Optional team scope.
     #[serde(skip_serializing_if = "Option::is_none")]
     pub team_id: Option<String>,
+    /// Aphoria client version string.
     pub client_version: String,
 }
 
 /// Request payload for pushing community observations (corpus aggregation).
 #[derive(Debug, Clone, Serialize)]
 pub struct PushCommunityObservationsRequest {
+    /// Batch of anonymized community observations.
     pub observations: Vec<CommunityObservationDto>,
     /// BLAKE3 hash of project name (prevents name leakage).
     pub project_hash: String,
+    /// Aphoria client version string.
     pub client_version: String,
 }
-
+/// Response from community observation push.
 #[derive(Debug, Clone, Deserialize)]
 pub struct PushCommunityObservationsResponse {
+    /// Number of observations recorded.
     pub recorded: usize,
+    /// New patterns detected.
     pub new_patterns: usize,
+    /// Existing patterns updated.
     pub updated_patterns: usize,
 }
 
 /// A single observation in the request (team storage).
 #[derive(Debug, Clone, Serialize)]
 pub struct ObservationDto {
+    /// Subject path (e.g., `code://rust/stemedb-core/imports/tokio`).
     pub subject: String,
+    /// Predicate name (e.g., "imported", "enabled").
     pub predicate: String,
+    /// Extracted value.
     pub object: ObjectValueDto,
+    /// Extraction confidence (0.0 to 1.0).
     pub confidence: f32,
+    /// BLAKE3 hash of source file content.
     pub source_hash: String,
+    /// Ed25519 signatures for provenance.
     pub signatures: Vec<SignatureDto>,
+    /// Unix timestamp (ms).
     pub timestamp: u64,
+    /// Optional extraction source metadata.
     #[serde(skip_serializing_if = "Option::is_none")]
     pub source_metadata: Option<String>,
 }