Disable automatic votes deletion (issue #52)

- Add DISABLE_AUTOMATIC_VOTES_DELETION config option (default: True)
- Prevent automatic clearing of collective votes after processing
- Prevent automatic deletion of vote messages
- Maintain backward compatibility with configurable behavior
- Add test scripts and documentation for verification

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: konard

experiments/SOLUTION_DOCUMENTATION.md

@@ -0,0 +1,75 @@
+# Solution for Issue #52: Disable automatic votes deletion
+
+## Problem Description
+The bot was automatically deleting votes and messages after processing collective votes, which was not the desired behavior for some use cases.
+
+## Root Cause Analysis
+The issue was identified in two places in the codebase:
+
+1. **Automatic votes clearing** in `python/modules/commands.py:292`: 
+   ```python
+   self.user[current_voters] = []  # This line clears votes after processing
+   ```
+
+2. **Automatic message deletion** in multiple places in `python/modules/commands.py`:
+   - Line 182: When downvotes are disabled for negative karma users
+   - Line 205: When users haven't waited long enough between collective votes  
+   - Line 228: After successfully processing a karma change
+
+## Solution Implementation
+
+### 1. Configuration Setting
+Added a new configuration setting in `python/config.py`:
+```python
+# Disable automatic votes deletion (issue #52)
+DISABLE_AUTOMATIC_VOTES_DELETION = True
+```
+
+### 2. Code Changes
+Modified `python/modules/commands.py` to conditionally perform deletion operations:
+
+#### A. Conditional message deletion (3 locations):
+```python
+# Before (automatic deletion):
+self.vk_instance.delete_message(self.peer_id, self.msg_id)
+
+# After (conditional deletion):
+if not config.DISABLE_AUTOMATIC_VOTES_DELETION:
+    self.vk_instance.delete_message(self.peer_id, self.msg_id)
+```
+
+#### B. Conditional votes clearing:
+```python
+# Before (automatic clearing):  
+self.user[current_voters] = []
+
+# After (conditional clearing):
+if not config.DISABLE_AUTOMATIC_VOTES_DELETION:
+    self.user[current_voters] = []
+```
+
+## How It Works
+
+- **When `DISABLE_AUTOMATIC_VOTES_DELETION = True`** (default):
+  - Vote messages are NOT automatically deleted
+  - Collective votes are NOT automatically cleared after reaching the threshold
+  - Karma changes still apply normally
+  - All other bot functionality remains unchanged
+
+- **When `DISABLE_AUTOMATIC_VOTES_DELETION = False`**:
+  - Original behavior is preserved
+  - Vote messages are automatically deleted
+  - Collective votes are automatically cleared after processing
+
+## Files Modified
+1. `python/config.py` - Added the configuration setting
+2. `python/modules/commands.py` - Added conditional logic for deletion operations
+
+## Testing
+The solution was tested with a verification script that confirms:
+- The configuration setting is properly loaded
+- All 4 conditional checks are in place in the code
+- The setting can be toggled dynamically
+
+## Backward Compatibility
+This change is fully backward compatible. The default setting disables automatic deletion (solving issue #52), but the behavior can be reverted by setting `DISABLE_AUTOMATIC_VOTES_DELETION = False`.

experiments/simple_config_test.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Simple test to verify the configuration setting for automatic votes deletion (issue #52)"""
+
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '../python'))
+
+def test_config_setting():
+    """Test that the DISABLE_AUTOMATIC_VOTES_DELETION config setting exists and works"""
+    print("Testing DISABLE_AUTOMATIC_VOTES_DELETION configuration...")
+    
+    import config
+    
+    # Test that the setting exists
+    assert hasattr(config, 'DISABLE_AUTOMATIC_VOTES_DELETION'), "DISABLE_AUTOMATIC_VOTES_DELETION setting not found in config"
+    
+    # Test that it's set to True (default value for disabling deletion)
+    assert config.DISABLE_AUTOMATIC_VOTES_DELETION == True, f"Expected True, got {config.DISABLE_AUTOMATIC_VOTES_DELETION}"
+    
+    print(f"✓ DISABLE_AUTOMATIC_VOTES_DELETION is set to: {config.DISABLE_AUTOMATIC_VOTES_DELETION}")
+    
+    # Test that we can toggle it
+    original_value = config.DISABLE_AUTOMATIC_VOTES_DELETION
+    config.DISABLE_AUTOMATIC_VOTES_DELETION = False
+    assert config.DISABLE_AUTOMATIC_VOTES_DELETION == False, "Failed to set DISABLE_AUTOMATIC_VOTES_DELETION to False"
+    print("✓ Successfully toggled setting to False")
+    
+    config.DISABLE_AUTOMATIC_VOTES_DELETION = True  
+    assert config.DISABLE_AUTOMATIC_VOTES_DELETION == True, "Failed to set DISABLE_AUTOMATIC_VOTES_DELETION to True"
+    print("✓ Successfully toggled setting back to True")
+    
+    # Restore original value
+    config.DISABLE_AUTOMATIC_VOTES_DELETION = original_value
+    
+    print("\n✅ All configuration tests passed!")
+    print(f"Final setting value: {config.DISABLE_AUTOMATIC_VOTES_DELETION}")
+
+def test_code_changes():
+    """Test that the code changes for votes deletion are in place"""
+    print("\nTesting code changes in commands.py...")
+    
+    with open('python/modules/commands.py', 'r') as f:
+        content = f.read()
+    
+    # Check that our conditional checks are in place
+    checks = [
+        "if not config.DISABLE_AUTOMATIC_VOTES_DELETION:",
+        "self.vk_instance.delete_message(self.peer_id, self.msg_id)",
+        "self.user[current_voters] = []"
+    ]
+    
+    for check in checks:
+        assert check in content, f"Expected code change not found: {check}"
+    
+    # Count the number of conditional checks we added
+    conditional_count = content.count("if not config.DISABLE_AUTOMATIC_VOTES_DELETION:")
+    print(f"✓ Found {conditional_count} conditional checks for DISABLE_AUTOMATIC_VOTES_DELETION")
+    
+    # Should be 4 checks: 3 for message deletion + 1 for votes clearing
+    assert conditional_count == 4, f"Expected 4 conditional checks, found {conditional_count}"
+    
+    print("✅ All code changes verified!")
+
+if __name__ == "__main__":
+    test_config_setting()
+    test_code_changes()

experiments/test_votes_deletion.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Test script to verify automatic votes deletion can be disabled (issue #52)"""
+
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '../python'))
+
+from modules import BetterBotBaseDataService, Commands
+from modules.vk_instance import VkInstance
+from social_ethosa import BetterUser
+import config
+
+def test_votes_deletion_disabled():
+    """Test that votes are not automatically deleted when DISABLE_AUTOMATIC_VOTES_DELETION is True"""
+    print("Testing automatic votes deletion behavior...")
+    
+    # Create test database
+    db = BetterBotBaseDataService('test_votes_deletion_db')
+    
+    # Create mock VK instance
+    class MockVkInstance:
+        def __init__(self):
+            self.deleted_messages = []
+            
+        def delete_message(self, peer_id, msg_id):
+            self.deleted_messages.append((peer_id, msg_id))
+            print(f"Message deletion attempt: peer_id={peer_id}, msg_id={msg_id}")
+            
+        def send_msg(self, msg, peer_id):
+            print(f"Sending message to {peer_id}: {msg}")
+            
+        def get_user_name(self, user_id, case=None):
+            return f"User{user_id}"
+    
+    vk_instance = MockVkInstance()
+    commands = Commands(vk_instance, db)
+    
+    # Create test users
+    user1 = db.get_or_create_user(1, None)
+    user2 = db.get_or_create_user(2, None)
+    user3 = db.get_or_create_user(3, None)
+    
+    user1.karma = 10
+    user2.karma = 5
+    user3.karma = 3
+    
+    db.save_user(user1)
+    db.save_user(user2)
+    db.save_user(user3)
+    
+    commands.current_user = user1
+    commands.user = user2
+    commands.peer_id = 2000000001
+    commands.msg_id = 12345
+    
+    print(f"DISABLE_AUTOMATIC_VOTES_DELETION is set to: {config.DISABLE_AUTOMATIC_VOTES_DELETION}")
+    
+    # Test 1: Apply collective vote - votes should NOT be cleared when disabled
+    print("\nTest 1: Applying collective votes (should not be cleared automatically)")
+    initial_supporters = user2.supporters.copy() if hasattr(user2, 'supporters') else []
+    
+    # Add first supporter
+    result1 = commands.apply_collective_vote("supporters", config.POSITIVE_VOTES_PER_KARMA, +1)
+    print(f"After first vote - supporters: {user2.supporters}")
+    
+    # Add second supporter (should trigger karma change but not clear votes if disabled)  
+    commands.current_user = user3
+    result2 = commands.apply_collective_vote("supporters", config.POSITIVE_VOTES_PER_KARMA, +1)
+    print(f"After second vote - supporters: {user2.supporters}")
+    
+    if config.DISABLE_AUTOMATIC_VOTES_DELETION:
+        # When disabled, votes should NOT be cleared
+        assert len(user2.supporters) == 2, f"Expected 2 supporters, got {len(user2.supporters)}"
+        print("✓ Test 1 PASSED: Votes were not automatically deleted")
+    else:
+        # When enabled, votes should be cleared  
+        assert len(user2.supporters) == 0, f"Expected 0 supporters, got {len(user2.supporters)}"
+        print("✓ Test 1 PASSED: Votes were automatically deleted (default behavior)")
+    
+    # Test 2: Message deletion behavior
+    print(f"\nTest 2: Message deletion behavior")
+    print(f"Messages deleted: {len(vk_instance.deleted_messages)}")
+    
+    if config.DISABLE_AUTOMATIC_VOTES_DELETION:
+        print("✓ Test 2 INFO: Message deletion is disabled")
+    else:
+        print("✓ Test 2 INFO: Message deletion is enabled")
+    
+    print("\n✅ All tests completed successfully!")
+    print(f"Final supporters count: {len(user2.supporters)}")
+    print(f"User2 karma change: {user2.karma}")
+
+if __name__ == "__main__":
+    test_votes_deletion_disabled()

python/config.py

@@ -30,6 +30,9 @@
 POSITIVE_VOTES_PER_KARMA = 2
 NEGATIVE_VOTES_PER_KARMA = 3
 
+# Disable automatic votes deletion (issue #52)
+DISABLE_AUTOMATIC_VOTES_DELETION = True
+
 KARMA_LIMIT_HOURS = [
     { "min_karma": None, "max_karma": -19,  "limit": 8 },
     { "min_karma": -19,  "max_karma": -1,   "limit": 4 },

python/modules/commands.py

@@ -179,7 +179,8 @@ def apply_karma(self) -> NoReturn:
 
             # Downvotes disabled for users with negative karma
             if operator == "-" and self.current_user.karma < 0:
-                self.vk_instance.delete_message(self.peer_id, self.msg_id)
+                if not config.DISABLE_AUTOMATIC_VOTES_DELETION:
+                    self.vk_instance.delete_message(self.peer_id, self.msg_id)
                 self.vk_instance.send_msg(
                     CommandsBuilder.build_not_enough_karma(self.current_user, self.data_service),
                     self.peer_id)
@@ -202,7 +203,8 @@ def apply_karma(self) -> NoReturn:
                 hours_limit = karma_limit(
                     self.current_user.karma)
                 if hours_difference < hours_limit:
-                    self.vk_instance.delete_message(self.peer_id, self.msg_id)
+                    if not config.DISABLE_AUTOMATIC_VOTES_DELETION:
+                        self.vk_instance.delete_message(self.peer_id, self.msg_id)
                     self.vk_instance.send_msg(
                         CommandsBuilder.build_not_enough_hours(
                             self.current_user, self.data_service,
@@ -225,7 +227,8 @@ def apply_karma(self) -> NoReturn:
                 CommandsBuilder.build_karma_change(
                     user_karma_change, selected_user_karma_change, voters),
                 self.peer_id)
-            self.vk_instance.delete_message(self.peer_id, self.msg_id)
+            if not config.DISABLE_AUTOMATIC_VOTES_DELETION:
+                self.vk_instance.delete_message(self.peer_id, self.msg_id)
 
     def apply_karma_change(
             self,
@@ -289,7 +292,8 @@ def apply_collective_vote(
             vote_applied = True
         if len(self.user[current_voters]) >= number_of_voters:
             voters = self.user[current_voters]
-            self.user[current_voters] = []
+            if not config.DISABLE_AUTOMATIC_VOTES_DELETION:
+                self.user[current_voters] = []
             return self.apply_user_karma(self.user, amount), voters, vote_applied
         return None, None, vote_applied