feat: merge metrics into structured.jsonl, add panther logs metrics CLI

.github/workflows/pr-validation.yml

@@ -28,8 +28,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -e .
-        pip install pytest black isort flake8
+        pip install -e .[tests,lint,web]
 
     - name: Get changed files
       id: changed-files

.github/workflows/unittests_codecov.yml

@@ -29,7 +29,7 @@ jobs:
         pip3 install --upgrade pip
         pip3 install --upgrade setuptools
         pip3 install --upgrade wheel
-        pip3 install .[tests]
+        pip3 install .[tests,web]
 
     - name: Generate coverage report
       run: |

.gitignore

@@ -16,6 +16,8 @@ locks/
 .coverage
 copy.git/
 .pytest_cache/
+pytest-of-*/
+.pytest_tmp/
 *.egg-info
 *.log
 pyvenv.cfg

.pre-commit-config.yaml

@@ -30,12 +30,11 @@ repos:
         args: ["--profile", "black"]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.6
+    rev: v0.8.6  # Keep in sync with pyproject.toml [project.optional-dependencies] lint
     hooks:
       - id: ruff
         files: ^(tests|panther)/.*\.py$
         exclude: ^tests/tests_ressources/
-        args: ["--select=D"]
 
   - repo: https://github.com/pycqa/flake8
     rev: 7.1.2

CLAUDE.md

@@ -24,10 +24,14 @@ git submodule update --init panther/plugins/services/testers/panther_ivy
 # Then re-run package-dev, or install manually:
 pip install -e panther/plugins/services/testers/panther_ivy/
 
-# Run tests
+# Run tests (no coverage by default — fast, low memory)
 pytest tests/ -n auto -m unit             # Fast unit tests
 pytest tests/ -n auto -m integration     # Requires Docker
 
+# Run with coverage (explicit — use -n 4 to cap memory)
+pytest tests/ --cov=panther --cov-report= -n 4
+coverage combine && coverage report --show-missing --fail-under=70
+
 # Code quality
 black panther/                           # Format
 isort panther/                           # Sort imports
@@ -155,7 +159,13 @@ Dependencies defined in `pyproject.toml`
 ## Testing
 
 ```bash
-pytest tests/ -n auto --cov=panther --cov-fail-under=70  # Coverage required: 70%
+# Quick tests (no coverage, low memory)
+pytest tests/ -n auto -m unit
+
+# Full coverage (explicit, capped workers to limit memory)
+pytest tests/ --cov=panther --cov-report= -n 4
+coverage combine && coverage report --show-missing --fail-under=70
+coverage html  # optional: generate HTML report
 ```
 
 **Test Markers**:

experiment-config/base/experiment_config_example_minimal.yaml

@@ -2,7 +2,6 @@ logging:
   level: DEBUG  # Set to DEBUG for detailed logs, or INFO for less verbosity
   format: "%(asctime)s [%(levelname)s] - %(module)s - %(message)s"
   enable_colors: true
-  debug_file_logging: true  # Set to true to enable debug file logging
 
   # Feature-specific log levels - set all to INFO to match global level
   feature_levels:

experiment-config/base/experiment_config_example_minimal_docker.yaml

@@ -1,41 +1,31 @@
 logging:
-  level: DEBUG  # Set to DEBUG for detailed logs, or INFO for less verbosity
+  level: INFO  # Set to DEBUG for detailed logs, or INFO for less verbosity
   format: "%(asctime)s [%(levelname)s] - %(module)s - %(message)s"
   enable_colors: true
-  debug_file_logging: true  # Set to true to enable debug file logging
 
-  # Feature-specific log levels - set all to INFO to match global level
+  # Feature-specific log levels — names must match feature_registry canonical names
   feature_levels:
     # Core Components
-    command_generation: DEBUG
-    template_rendering: DEBUG
-    docker_builder: DEBUG
-    docker_operations: DEBUG  # This was causing INFO logs to show
-    config_processing: DEBUG
+    command_generation: ERROR
+    template_rendering: ERROR
+    docker_operations: ERROR
+    config_processing: INFO
     event_system: ERROR
     file_operations: ERROR
 
     # Service Management
-    # service_managers: INFO
-    service_managers: DEBUG
+    service_managers: INFO
     ivy_operations: ERROR
     quic_services: ERROR
-    plugin_loading: DEBUG
-    service_coordination: ERROR
+    plugin_loading: INFO
+    service_coordination: INFO
 
     # Environment Management
-    network_environments: DEBUG
-    execution_environment: DEBUG
-    docker_compose: DEBUG
-    shadow_ns: DEBUG
-    localhost_container: DEBUG
-
-    # Event System
-    event_emission: ERROR
-    event_processing: ERROR
-    state_management: ERROR
-    observer_operations: ERROR
-    event_manager: ERROR
+    network_environments: ERROR
+    execution_environment: ERROR
+    docker_compose: ERROR
+    shadow_ns: ERROR
+    localhost_container: ERROR
 
     # Protocol Operations
     certificate_management: ERROR
@@ -51,9 +41,10 @@ logging:
 
     # Development and Testing
     test_execution: ERROR
-    experiment_workflow: ERROR
     validation_checks: ERROR
     error_handling: ERROR
+    state_management: ERROR
+    observer_operations: ERROR
 
 progress:
   enable_progress_bar: true
@@ -98,7 +89,7 @@ paths:
 
 docker:
   force_build_docker_image: false
-  no_docker_cache: true  # Set to true to disable Docker build cache for all builds
+  no_docker_cache: false  # Set to true to disable Docker build cache for all builds
   log_docker_image_build: true  # Enable Docker build log files
   use_buildx: true  # Set to true to use Docker Buildx for multi-platform builds
 
@@ -132,7 +123,7 @@ tests:
   #       timeout: 200
   #       docker:
   #         force_build_docker_image: true  # Force build for this service's Docker image
-  #         no_docker_cache: true  # Disable Docker build cache for this service's image
+  #         no_docker_cache: false  # Disable Docker build cache for this service's image
 
   #       implementation:
   #         # build_mode: "rel-lto"
@@ -177,8 +168,7 @@ tests:
         timeout: 200
         docker:
           force_build_docker_image: true  # Force build for this service's Docker image
-          no_docker_cache: true  # Disable Docker build cache for this service's image
-
+          no_docker_cache: false  # Disable Docker build cache for this service's image
         implementation:
           # build_mode: "rel-lto"
           # z3_source: "pip"  # "local" (default, ~30min build) or "pip" (fast, pip z3-solver only)

experiment-config/base/experiment_config_example_minimal_docker_no_buildx.yaml

@@ -2,7 +2,6 @@ logging:
   level: DEBUG
   format: "%(asctime)s [%(levelname)s] - %(module)s - %(message)s"
   enable_colors: true
-  debug_file_logging: true
 
   feature_levels:
     command_generation: DEBUG

panther/banner.py

@@ -1,11 +1,8 @@
-"""
-This module contains a function to display an ASCII art banner with a message and author information.
-"""
+"""This module contains a function to display an ASCII art banner with a message and author information."""
 
 
 def display_banner():
-    """
-    Displays an ASCII art banner with a message and author information.
+    """Displays an ASCII art banner with a message and author information.
 
     The banner includes:
     - An ASCII art design

panther/builder_metrics/resource_sampler.py

@@ -1,17 +1,17 @@
 """Resource monitoring for CPU and memory usage."""
 
+import logging
 import threading
 import time
 from typing import Dict, List, Optional
 
 import psutil
 
+logger = logging.getLogger(__name__)
 
-class ResourceSampler:
-    """
 
-    from typing import Dict, List, Optional, OptionalSamples system resources (CPU, memory) during operation.
-    """
+class ResourceSampler:
+    """from typing import Dict, List, Optional, OptionalSamples system resources (CPU, memory) during operation."""
 
     def __init__(self, interval: float = 1.0):
         """Initialize the resource sampler.
@@ -91,9 +91,13 @@ def _sample_loop(self) -> None:
                     self._process = psutil.Process()
                 except psutil.NoSuchProcess:
                     break
-            except Exception:
-                # Ignore sampling errors and continue
-                pass
+            except Exception as exc:
+                if not getattr(self, "_sampling_error_warned", False):
+                    self._sampling_error_warned = True
+                    logger.warning(
+                        "Resource sampling error (further errors suppressed): %s",
+                        exc,
+                    )
 
     def get_current_stats(self) -> Dict[str, float]:
         """Get current resource usage without stopping sampling.

panther/builder_metrics/utils.py

@@ -7,14 +7,12 @@
 
 
 def get_directory_size_mb(directory: Path) -> float:
-    """
-
-    from typing import Dict, List, Optional, Tuple, TupleGet the total size of a directory in megabytes.
+    """From typing import Dict, List, Optional, Tuple, TupleGet the total size of a directory in megabytes.
 
-        Args:
+    Args:
             directory: Path to the directory
 
-        Returns:
+    Returns:
             Size in megabytes
     """
     if not directory.exists() or not directory.is_dir():

panther/cli/commands/admin.py

@@ -18,6 +18,8 @@
     success_message,
 )
 
+logger = logging.getLogger(__name__)
+
 
 @featured_example("panther admin status")
 @click.group()
@@ -119,6 +121,7 @@ def teardown(ctx, force):
                         click.echo(f"  ⚠️ {step_name} completed with warnings")
 
                 except Exception as e:
+                    logger.debug("CLI error in teardown: %s", e, exc_info=True)
                     click.echo(f"  ⚠️ {step_name} failed: {e}")
 
                 bar.update(1)
@@ -385,6 +388,7 @@ def _clean_directories(dir_names):
                     total_removed += removed
                     click.echo(f"  ✅ {operation_name}: {removed} items removed")
                 except Exception as e:
+                    logger.debug("CLI error in clean: %s", e, exc_info=True)
                     click.echo(f"  ⚠️ {operation_name}: {e}")
 
         success_message(
@@ -754,6 +758,7 @@ def _system_cleanup_services():
                                 f"  ✅ {operation_name}: {processed} items processed"
                             )
                         except Exception as e:
+                            logger.debug("CLI error in docker: %s", e, exc_info=True)
                             click.echo(f"  ⚠️ {operation_name}: {e}")
             else:
                 # For registry operations, no progress bar needed
@@ -766,6 +771,7 @@ def _system_cleanup_services():
                             f"  ✅ {operation_name}: {processed} items processed"
                         )
                     except Exception as e:
+                        logger.debug("CLI error in docker: %s", e, exc_info=True)
                         click.echo(f"  ⚠️ {operation_name}: {e}")
 
         success_message(