updated docs strings and added README.md

mail_intake/models/thread.py

@@ -1,10 +1,8 @@
 """
+# Summary
+
 Thread domain models for Mail Intake.
 
----
-
-## Summary
-
 This module defines the **canonical, provider-agnostic representation**
 of an email thread as used internally by the Mail Intake ingestion pipeline.
 
@@ -27,9 +25,11 @@ class MailIntakeThread:
     Notes:
         **Guarantees:**
 
-            - A thread groups multiple related messages under a single subject and participant set
-            - It is designed to support reasoning over conversational context such as job applications, interviews, follow-ups, and ongoing discussions
-            - This model is provider-agnostic and safe to persist
+            - A thread groups multiple related messages under a single subject
+              and participant set.
+            - It is designed to support reasoning over conversational context
+              such as job applications, interviews, follow-ups, and ongoing discussions.
+            - This model is provider-agnostic and safe to persist.
     """
 
     thread_id: str
@@ -68,9 +68,9 @@ class MailIntakeThread:
         Notes:
             **Responsibilities:**
 
-                - Appends the message to the thread
-                - Tracks unique participants
-                - Updates the last activity timestamp
+                - Appends the message to the thread.
+                - Tracks unique participants.
+                - Updates the last activity timestamp.
         """
         self.messages.append(message)