Merge branch 'feat/enhanced_discovery_display' into dev

Author: LittleCoinCoin

.gitignore

@@ -215,3 +215,9 @@ yarn-error.log*
 
 # Semantic-release
 .semantic-release/final_test.json
+
+# Test artifacts and temporary files
+test_*.json
+discovery*.json
+discovery*.txt
+*.tmp

README.md

@@ -37,6 +37,14 @@ wobble --log-file test_results.json
 # CI/CD integration with file output
 wobble --format json --log-file ci_results.json --log-verbosity 3
 
+# Enhanced test discovery
+wobble --discover-only                    # Show test counts by category
+wobble --discover-only --discover-verbosity 2  # Show uncategorized test details
+wobble --discover-only --discover-verbosity 3  # Show all tests with decorators
+
+# Test execution with decorator display
+wobble --verbose                          # Shows [@decorator_name] for each test
+
 # Get help
 wobble --help
 ```
@@ -73,6 +81,27 @@ wobble --verbose
 python -m unittest discover tests
 ```
 
+### Enhanced Discovery Features
+
+Wobble provides enhanced test discovery with multiple verbosity levels and decorator display:
+
+```bash
+# Discovery verbosity levels
+wobble --discover-only --discover-verbosity 1  # Test counts by category (default)
+wobble --discover-only --discover-verbosity 2  # + Uncategorized test details
+wobble --discover-only --discover-verbosity 3  # + All tests with decorator info
+
+# Test execution with decorator display
+wobble --verbose                                # Shows [@decorator_name] for tests
+wobble --category regression --verbose          # Regression tests with decorators
+```
+
+**Decorator Display Examples:**
+- `[@regression_test]` - Regression test
+- `[@integration_test]` - Integration test
+- `[@slow_test]` - Slow-running test
+- `[@regression_test, @slow_test]` - Multiple decorators
+
 ### Making Commits
 
 We use [Conventional Commits](https://www.conventionalcommits.org/) for automated versioning:

docs/articles/devs/architecture/Overview.md

@@ -27,26 +27,91 @@ wobble/
 
 ### Test Discovery Engine (`discovery.py`)
 
-**Responsibility**: Locate and categorize tests across different repository structures.
+**Responsibility**: Locate and categorize tests across different repository structures with enhanced logging and file output capabilities.
 
 **Key Classes**:
-- `TestDiscoveryEngine`: Main discovery coordinator
+- `TestDiscoveryEngine`: Main discovery coordinator with progressive verbosity support
 - Supports hierarchical (`tests/regression/`) and flat (decorator-based) structures
 - Provides filtering capabilities by category, performance, and environment
+- Implements structured data output for JSON serialization and file integration
 
 **Design Patterns**:
 - **Strategy Pattern**: Different discovery strategies for hierarchical vs. flat structures
 - **Factory Pattern**: Test suite creation from discovered test information
 - **Filter Pattern**: Composable test filtering by multiple criteria
+- **Observer Pattern**: Integration with file output system for dual console/file logging
+
+**Enhanced Discovery Features**:
+- **Progressive Verbosity**: Three levels of detail with distinct JSON structures:
+  - Level 1: Basic counts only (`categories` field)
+  - Level 2: Level 1 + `uncategorized` field with test details
+  - Level 3: Level 1 + `tests_by_category` field with complete test listings
+- **File Path Detection**: Automatic detection and formatting of test file locations
+- **JSON Serialization**: Structured data output compatible with programmatic analysis
+- **Decorator Information**: Complete decorator metadata in detailed discovery output
 
 **Key Methods**:
 ```python
 def discover_tests(pattern: str) -> Dict[str, List]
 def filter_tests(categories: List[str], exclude_slow: bool, exclude_ci: bool) -> List[Dict]
+def get_discovery_summary(verbosity: int = 1) -> str
+def get_discovery_data(verbosity: int = 1) -> Dict[str, Any]
+def get_test_summary() -> str
 def supports_hierarchical_structure() -> bool
 def supports_decorator_structure() -> bool
 ```
 
+**Discovery Data Structure**:
+```python
+{
+    "discovery_summary": {
+        "timestamp": "2025-09-15T10:30:00.123456",
+        "total_tests": 42,
+        "categories": {
+            "regression": 15,
+            "integration": 12,
+            "development": 8,
+            "uncategorized": 7
+        },
+        # Verbosity level 2: uncategorized test details
+        "uncategorized": [  # Only present at verbosity level 2
+            {
+                "name": "test_example",
+                "class": "TestExample",
+                "module": "test_example",
+                "file": "tests/test_example.py",
+                "full_name": "test_example.TestExample.test_example",
+                "decorators": ["@slow_test"]
+            }
+        ],
+
+        # Verbosity level 3: complete test listings by category
+        "tests_by_category": {  # Only present at verbosity level 3
+            "regression": [
+                {
+                    "name": "TestRegression.test_feature",
+                    "class": "TestRegression",
+                    "module": "test_regression",
+                    "file": "tests/test_regression.py",
+                    "full_name": "test_regression.TestRegression.test_feature",
+                    "decorators": ["@regression_test"]
+                }
+            ],
+            "uncategorized": [
+                {
+                    "name": "test_example",
+                    "class": "TestExample",
+                    "module": "test_example",
+                    "file": "tests/test_example.py",
+                    "full_name": "test_example.TestExample.test_example",
+                    "decorators": ["@slow_test"]
+                }
+            ]
+        }
+    }
+}
+```
+
 ### Decorator System (`decorators.py`)
 
 **Responsibility**: Provide test categorization and metadata attachment.
@@ -149,6 +214,14 @@ def supports_decorator_structure() -> bool
 - Multiple output destinations (console + file simultaneously)
 - Format-specific strategies with auto-detection
 - Graceful error handling and resource cleanup
+- Discovery mode integration with independent verbosity control
+
+**Discovery Integration**:
+- Discovery results support both console and file output simultaneously
+- Independent verbosity control: `--discover-verbosity` for console, `--log-verbosity` for file
+- JSON format support for structured discovery data with complete test metadata
+- File path detection and serialization for programmatic analysis
+- Event-driven architecture enables discovery output through observer pattern
 
 **Threading Architecture**:
 ```python

docs/articles/users/CLIReference.md

@@ -179,22 +179,49 @@ wobble --quiet
 Analyze tests without executing them:
 
 ```bash
---discover-only         # Only discover tests, do not run them
---list-categories       # List available test categories and exit
+--discover-only                    # Only discover tests, do not run them
+--discover-verbosity {1,2,3}      # Control discovery output detail level
+--list-categories                  # List available test categories and exit
 ```
 
+### Discovery Verbosity Levels
+
+Control the amount of detail in discovery output:
+
+- **Level 1 (Default)**: Test counts by category
+- **Level 2**: Level 1 + detailed uncategorized test listings
+- **Level 3**: Level 2 + complete test listings with file paths and decorators
+
 **Examples:**
 ```bash
-# See what tests would be discovered
+# Basic discovery (counts only)
 wobble --discover-only
 
-# Get JSON summary of discovered tests
-wobble --discover-only --format json
+# Show uncategorized test details
+wobble --discover-only --discover-verbosity 2
+
+# Complete discovery report with all details
+wobble --discover-only --discover-verbosity 3
 
 # List available categories
 wobble --list-categories
 ```
 
+### Discovery Output Formats
+
+Discovery results can be output in different formats:
+
+```bash
+# Console output with file logging
+wobble --discover-only --log-file discovery.txt
+
+# JSON format for programmatic use
+wobble --discover-only --log-file discovery.json --log-file-format json
+
+# Different verbosity for console vs file
+wobble --discover-only --discover-verbosity 1 --log-file detailed.txt --log-verbosity 3
+```
+
 ## Repository Options
 
 ### Path Specification
@@ -302,6 +329,26 @@ wobble --log-file detailed.json --log-verbosity 2
 wobble --log-file complete.json --log-verbosity 3
 ```
 
+### Discovery Mode File Output
+
+When using `--discover-only`, file output behavior adapts to discovery mode:
+
+```bash
+# Discovery with independent console/file verbosity
+wobble --discover-only --discover-verbosity 1 --log-file discovery.json --log-verbosity 3
+
+# JSON discovery output with complete test details
+wobble --discover-only --log-file discovery.json --log-file-format json --log-verbosity 3
+
+# Text discovery output with basic counts
+wobble --discover-only --log-file discovery.txt --log-file-format txt --log-verbosity 1
+```
+
+**Discovery Verbosity Mapping:**
+- `--log-verbosity 1`: Test counts by category
+- `--log-verbosity 2`: Counts + uncategorized test details
+- `--log-verbosity 3`: Complete test listings with file paths and decorators
+
 ### File Management Options
 
 Control how files are handled:

docs/articles/users/GettingStarted.md

@@ -60,14 +60,32 @@ wobble --quiet
 Understand what tests wobble finds in your repository:
 
 ```bash
-# Discover tests without running them
+# Basic discovery (test counts by category)
 wobble --discover-only
 
+# Detailed discovery with uncategorized test listings
+wobble --discover-only --discover-verbosity 2
+
+# Complete discovery with file paths and decorators
+wobble --discover-only --discover-verbosity 3
+
 # List available test categories
 wobble --list-categories
+```
+
+### Discovery Output Options
+
+Save discovery results to files for analysis:
+
+```bash
+# Save discovery results to text file
+wobble --discover-only --log-file discovery.txt
+
+# Save as JSON for programmatic use
+wobble --discover-only --log-file discovery.json --log-file-format json
 
-# JSON output for programmatic use
-wobble --discover-only --format json
+# Different detail levels for console vs file
+wobble --discover-only --discover-verbosity 1 --log-file detailed.json --log-verbosity 3
 ```
 
 ### Category-Based Execution

docs/articles/users/IntegrationGuide.md

@@ -346,7 +346,15 @@ wobble --format json --exclude-ci
 ```bash
 # Compare test counts
 python -m unittest discover tests --dry-run | wc -l
-wobble --discover-only --format json | jq '.total_tests'
+wobble --discover-only --log-file discovery.json --log-file-format json
+cat discovery.json | jq '.discovery_summary.total_tests'
+
+# Detailed discovery analysis
+wobble --discover-only --discover-verbosity 3 --log-file detailed_discovery.txt
+
+# Validate category distribution
+wobble --discover-only --log-file discovery.json --log-file-format json
+cat discovery.json | jq '.discovery_summary.categories'
 ```
 
 **Execution validation**:

docs/articles/users/TestOrganization.md

@@ -290,8 +290,17 @@ wobble --category regression
 ### Test Organization Validation
 
 ```bash
-# Verify test discovery
-wobble --discover-only --format json
+# Basic test discovery with counts
+wobble --discover-only
+
+# Detailed discovery with uncategorized test analysis
+wobble --discover-only --discover-verbosity 2
+
+# Complete discovery report with file paths and decorators
+wobble --discover-only --discover-verbosity 3
+
+# Save discovery analysis to file for review
+wobble --discover-only --log-file organization_analysis.json --log-file-format json --log-verbosity 3
 
 # Check category distribution
 wobble --list-categories

tests/test_data_structures.py

@@ -17,6 +17,9 @@
     TestStatus, ErrorInfo, TestResult, TestRunSummary,
     TestResultEncoder, serialize_test_results, format_test_results_text
 )
+from tests.test_data_utils import (
+    get_test_result_template, get_timing_config, get_command_template
+)
 
 
 class TestTestStatus(unittest.TestCase):
@@ -35,15 +38,18 @@ class TestErrorInfo(unittest.TestCase):
 
     def test_error_info_creation(self):
         """Test basic ErrorInfo creation."""
+        # Get error info template from centralized test data
+        error_template = get_test_result_template('with_error_info')['error_info']
+
         error = ErrorInfo(
-            type="AssertionError",
-            message="Expected 5, got 3",
-            traceback="Traceback (most recent call last)..."
+            type=error_template['type'],
+            message=error_template['message'],
+            traceback=error_template['traceback']
         )
-        
-        self.assertEqual(error.type, "AssertionError")
-        self.assertEqual(error.message, "Expected 5, got 3")
-        self.assertEqual(error.traceback, "Traceback (most recent call last)...")
+
+        self.assertEqual(error.type, error_template['type'])
+        self.assertEqual(error.message, error_template['message'])
+        self.assertEqual(error.traceback, error_template['traceback'])
         self.assertIsNone(error.file_path)
         self.assertIsNone(error.line_number)
 
@@ -116,27 +122,35 @@ class TestTestResult(unittest.TestCase):
 
     def setUp(self):
         """Set up test fixtures."""
-        self.timestamp = datetime(2024, 1, 15, 14, 30, 25)
+        # Get standard timestamp from centralized test data
+        timestamp_str = get_timing_config('standard_timestamp')
+        self.timestamp = datetime.fromisoformat(timestamp_str)
+
+        # Get error info template from centralized test data
+        error_template = get_test_result_template('with_error_info')['error_info']
         self.error_info = ErrorInfo(
-            type="AssertionError",
-            message="Expected 5, got 3",
-            traceback="Traceback (most recent call last)..."
+            type=error_template['type'],
+            message=error_template['message'],
+            traceback=error_template['traceback']
         )
 
     def test_test_result_creation(self):
         """Test basic TestResult creation."""
+        # Get test result template from centralized test data
+        template = get_test_result_template('test_example')
+
         result = TestResult(
-            name="test_example",
-            classname="TestClass",
+            name=template['name'],
+            classname=template['classname'],
             status=TestStatus.PASS,
-            duration=0.123,
+            duration=template['duration'],
             timestamp=self.timestamp
         )
-        
-        self.assertEqual(result.name, "test_example")
-        self.assertEqual(result.classname, "TestClass")
+
+        self.assertEqual(result.name, template['name'])
+        self.assertEqual(result.classname, template['classname'])
         self.assertEqual(result.status, TestStatus.PASS)
-        self.assertEqual(result.duration, 0.123)
+        self.assertEqual(result.duration, template['duration'])
         self.assertEqual(result.timestamp, self.timestamp)
         self.assertEqual(result.metadata, {})
         self.assertIsNone(result.error_info)