doc update

Author: Trojan-Dev-AFK

docs/API_DOCS.md

@@ -623,24 +623,15 @@ Return persisted messages for one conversation owned by the authenticated user.
   {
     "id": "message-uuid-1",
     "conversation_id": "conversation-uuid-123",
-    "role": "user",
-    "content": "What are the key terms in our contracts?",
-    "created_at": "27:06:2026 10:15:00.123"
-  },
-  {
-    "id": "message-uuid-2",
-    "conversation_id": "conversation-uuid-123",
-    "role": "assistant",
-    "content": "Based on the analyzed contracts, the key terms include...",
+    "query": "What are the key terms in our contracts?",
+    "response": "Based on the analyzed contracts, the key terms include...",
     "created_at": "27:06:2026 10:15:02.512"
   }
 ]
 ```
 
 **Errors:**
 - `404 Not Found` — conversation does not exist or does not belong to the authenticated user
-
-**Errors:**
 - `502 Bad Gateway` — agent orchestration failed (LLM/tool failure surfaced as `AgentError`)
 - `500 Internal Server Error` — unexpected unhandled server error
 

docs/ARCHITECTURE.md

@@ -136,7 +136,7 @@ POST /v1/chat/invoke { "query": "...", "conversation_id": optional }
 
     → loop back to Agent node until no more tool calls
 
-  → persist USER and ASSISTANT turns in chat_messages
+  → persist one Q/A turn row in chat_messages (user_query + assistant_response)
   → update chat_conversations.updated_at
   → return { response: "...", conversation_id: "..." }
 

docs/CHANGELOG.md

@@ -24,13 +24,20 @@ Project history up to 2026-06-27.
   - Creates a new conversation when `conversation_id` is absent.
   - Validates user/company ownership when `conversation_id` is provided.
   - Loads prior turns into graph input context.
-  - Persists both user and assistant turns for every invoke.
+  - Persists one row per chat turn in `chat_messages` (`user_query` + `assistant_response`).
 - Startup schema verification now requires chat history tables.
 
 ### Database
 
 - Added migration `0005_add_chat_history_tables.py`.
-- Applied migration path now includes `0001 -> 0005`.
+- Added migration `0006_chat_messages_single_turn_rows.py`.
+- Added migration `0007_remove_legacy_chat_message_columns.py`.
+- Applied migration path now includes `0001 -> 0007`.
+
+### Removed
+
+- Legacy chat columns `chat_messages.role` and `chat_messages.content`.
+- Legacy enum type `chatmessagerole`.
 
 ### Testing