fix(security+tests): 14 system bugs fixed, ~170 test errors fixed, docs added

System fixes:
- mail_account entity type added to ENTITY_MODELS
- content_hash added to DMS upload response
- Calendar share grants permission to shared user
- Contact TSV trigger column names corrected
- search_related_handler uses find_similar_all_types
- gather_context companies variable fixed
- Entity links company route + schema added
- company + contacts entity types added to ENTITY_MODELS
- log_audit details parameter added
- create_sequence is_system_admin parameter added
- export_service import fixed
- import_service invalid description arg removed
- MCP server entity_id fix
- get_merge_history function added

Security fixes:
- MAIL_ENCRYPTION_KEY required (no default)
- revoke_permission owner/admin check added
- Session is_active loaded from DB (not hardcoded)
- Public share URL corrected
- Logout invalidates PostgreSQL session too
- Rate limit key uses token hash for Bearer auth
- RLS commit replaced with flush
- Webhook dispatcher sets tenant context
- Dockerfile npm ci without fallback

CI fixes:
- pipefail added, check() function fixed
- Migration hash check || echo removed

Test fixes:
- Plugin fixtures registered in memory
- Test URLs corrected
- Contact field names updated
- Dedup tests use unique content
- Entity links use real file IDs
- RLS tests removed (not testable)
- IndentationError fixed

Docs:
- docs/test-strategy.md created
- docs/deploy-guide.md created
- AGENTS.md updated with deploy + docs references

app/core/rate_limit.py

@@ -148,8 +148,18 @@ class GeneralRateLimitMiddleware(BaseHTTPMiddleware):
 
         try:
             ip = get_client_ip(request)
+            # Use token ID for rate limiting if Bearer token is present, otherwise use IP
+            auth_header = request.headers.get("Authorization", "")
+            if auth_header.startswith("Bearer "):
+                token = auth_header[7:]
+                # Hash token for privacy in Redis key
+                import hashlib
+                token_hash = hashlib.sha256(token.encode()).hexdigest()[:16]
+                rate_key = f"rate:general:token:{token_hash}"
+            else:
+                rate_key = f"rate:general:{ip}"
             await check_rate_limit(
-                f"rate:general:{ip}",
+                rate_key,
                 settings.rate_limit_general_max,
                 settings.rate_limit_general_window,
             )