update the readme file

README.md

@@ -774,6 +774,31 @@ See `SUPABASE_SETUP.md` and `SUPABASE_MIGRATION_COMPLETE.md` for detailed instru
   - Check backend logs for specific error messages
   - Verify PostgreSQL connection for RAG storage
 
+#### Document Display Issues
+- **Issue**: Document list shows `[object Object]` instead of document details
+- **Solution**: This has been fixed. Documents now display properly with:
+  - Document ID (number)
+  - Document Type (text, pdf, faq, link)
+  - Preview (first 200 characters)
+  - Length (character count)
+  - Created date
+- **If still seeing issues**: Refresh the Knowledge Base Library tab
+
+#### Rule Addition Timeouts
+- **Issue**: "Chunk 1/1 timed out after 45s" when adding rules
+- **Solution**:
+  - **Quick Fix**: Uncheck the "Enable LLM Enhancement" checkbox before adding rules - rules will be added immediately without LLM processing
+  - **With Enhancement**: Keep checkbox checked but be patient - enhancement can take up to 180s for 5 rules (30s per rule)
+  - **Best Practice**: Add rules in smaller batches (1-3 rules at a time) when using enhancement
+- **Note**: Enhancement is optional - you can always add rules quickly without it, then enhance them later if needed
+
+#### Rule Deletion Issues
+- **Issue**: "404 Not Found" when trying to delete a rule
+- **Solution**: You can now delete rules in two ways:
+  - **By Number**: Enter the rule number (e.g., "1", "2", "3") as shown in the rules table
+  - **By Text**: Enter the exact rule text as displayed in the rules table
+- **If rule not found**: Make sure you're entering the exact text or a valid rule number. Refresh the rules table to see current rules.
+
 #### Tenant Isolation Issues
 - **Issue**: Documents or data leaking between tenants
 - **Solution**:
@@ -888,6 +913,17 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Recent Enhancements
 
+### UI & UX Improvements (Latest)
+- **Document Display Fix**: Fixed document list showing `[object Object]` - now properly displays document ID, type, preview, length, and creation date in a formatted table
+- **Rule Deletion Enhancement**: Can now delete rules by entering either:
+  - Rule number (e.g., "1", "2", "3") - automatically finds the corresponding rule
+  - Full rule text - deletes the exact matching rule
+- **LLM Enhancement Toggle**: Added checkbox to enable/disable LLM enhancement when adding rules:
+  - **Quick Add**: Uncheck to add rules immediately without LLM processing (no timeout issues)
+  - **Enhanced Add**: Check to get better patterns, explanations, and examples (takes longer but higher quality)
+- **Improved Timeouts**: Increased timeout for rule enhancement from 45s to 180s to handle multiple rules properly
+- **Better Error Messages**: Clearer error messages for rule deletion, document operations, and permission errors
+
 ### Role Propagation & Permission Handling (Latest)
 - **Fixed Role Propagation**: User role (`viewer`, `editor`, `admin`, `owner`) is now properly passed through the entire ingestion pipeline:
   - UI sends role in `x-user-role` header
@@ -904,9 +940,14 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ### Admin Rules System (Latest)
 - **File Upload Support**: Upload rules from TXT, PDF, DOC, DOCX files with drag-and-drop interface
-- **LLM Enhancement**: Automatic rule enhancement identifies edge cases, improves regex patterns, and suggests severity levels
+- **LLM Enhancement Toggle**: Optional LLM enhancement with checkbox control:
+  - **Quick Add Mode**: Uncheck to add rules immediately without LLM processing (no timeouts)
+  - **Enhanced Mode**: Check to get better patterns, explanations, examples, and edge case detection
+- **LLM Enhancement**: When enabled, automatic rule enhancement identifies edge cases, improves regex patterns, and suggests severity levels
 - **Intelligent Fallback Explanations**: When LLM enhancement times out or fails, the system automatically generates basic explanations using keyword extraction, providing useful examples and pattern suggestions without requiring LLM availability
 - **Chunk Processing**: Large rule sets processed in chunks of 5 to prevent timeouts (handles 100+ rules efficiently)
+- **Enhanced Timeouts**: Increased timeout from 45s to 180s per chunk to accommodate LLM processing
+- **Flexible Rule Deletion**: Delete rules by entering either rule number (e.g., "1") or full rule text
 - **Comment Filtering**: Comment lines (starting with #) automatically ignored when uploading rules
 - **Rule-First Processing**: Admin rules checked before intent classification - enables behavior control (brief responses vs blocking)
 - **Supabase Integration**: Production-ready Supabase support with automatic table creation

backend/README.md

@@ -185,6 +185,12 @@ Every tool now returns strict JSON schemas for consistency:
 
 **Schema Definitions**: `backend/api/services/tool_metadata.py` contains `TOOL_OUTPUT_SCHEMAS` with validation functions.
 
+### UI & UX Improvements
+- **Document Display**: Fixed document list formatting - now properly displays as table rows instead of `[object Object]`
+- **Rule Deletion**: Enhanced to support both rule numbers and rule text for easier deletion
+- **LLM Enhancement Toggle**: Added option to disable LLM enhancement for faster rule addition
+- **Timeout Improvements**: Increased timeout for bulk rule operations from 45s to 180s
+
 ### Role Propagation & Permission Handling
 - **Fixed Role Propagation**: User role is now properly passed from API route → `process_ingestion()` → RAG client → MCP server
   - `rag_client.ingest_with_metadata()` now accepts `user_role` parameter
@@ -381,6 +387,15 @@ Agents that speak the Model Context Protocol should connect to the `integrachat`
 - **404 Not Found**: Verify the document_id exists and belongs to the correct tenant
 - **Tenant ID mismatch**: The system normalizes tenant IDs, but ensure you're using the same tenant_id format as when documents were ingested
 - **Check logs**: Database deletion logs show detailed information about tenant ID matching and document existence
+- **Role Propagation**: Ensure user role is being passed correctly - deletion requires `admin` or `owner` role. The role is now properly propagated from UI → API → RAG Client → MCP Server
+
+### Rule Management Issues
+- **Timeout Errors**: If rule enhancement times out:
+  - Disable LLM enhancement in the UI (uncheck the checkbox)
+  - Add rules in smaller batches (1-3 rules at a time)
+  - Enhancement timeout increased to 180s per chunk (5 rules)
+- **Rule Deletion 404**: Can now delete by rule number or full text. If using number, ensure it's a valid index (1-based)
+- **Permission Errors**: Rule management requires `admin` or `owner` role. Check that role is set correctly in the UI
 
 ### Supabase Configuration Issues
 - **Data still going to SQLite**: Check that `SUPABASE_URL` and `SUPABASE_SERVICE_KEY` are set correctly in `.env` (no quotes, no spaces)