[#119] Add agent overlap analysis script for Python

[pierrehanne]

Implement AgentOverlapAnalyzer in Python [Issue #119] @cornelcroi

Adding Unit tests to verify:

• Correct behavior when no agents are provided.
• Correct behavior when only one agent is provided.
• Correct handling of identical descriptions across agents.
• Correct calculation of overlap percentages and uniqueness scores.

[brnaba-aws]

please also add in the documentation the python version. Thanks

[brnaba-aws]

from unittest.mock import patch

[brnaba-aws]

Add another test to have 100% coverage and also checking on the log:

def test_analyze_overlap_logging_with_mock(sample_agents):
    """Test that analyze_overlap calls Logger.info with expected messages"""
    with patch.object(Logger, 'info') as mock_logger:
        analyzer = AgentOverlapAnalyzer(sample_agents)
        analyzer.analyze_overlap()

        # Verify Logger.info was called
        assert mock_logger.call_count > 0

        # Get all the logged messages
        logged_messages = [call.args[0] for call in mock_logger.call_args_list]

        # Verify specific log messages are present
        assert "Pairwise Overlap Results:" in logged_messages
        assert "_________________________\n" in logged_messages
        assert "Uniqueness Scores:" in logged_messages
        assert "_________________\n" in logged_messages

        # Verify agent pair combinations are logged
        agent_pairs_found = []
        for message in logged_messages:
            if " - " in message and "Overlap Percentage" in message:
                agent_pairs_found.append(message)

        # Should have 3 pairs: AgentA-AgentB, AgentA-AgentC, AgentB-AgentC
        assert len(agent_pairs_found) == 3

        # Verify uniqueness scores are logged for each agent
        uniqueness_messages = [msg for msg in logged_messages if "Agent:" in msg and "Uniqueness Score:" in msg]
        assert len(uniqueness_messages) == 3