oscura 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

oscura/extensibility/templates.py

@@ -1,4 +1,4 @@
-"""Plugin template generation for creating new TraceKit plugins.
+"""Plugin template generation for creating new Oscura plugins.
 
 This module provides tools for generating plugin skeletons with all necessary
 boilerplate code, tests, and documentation.
@@ -46,7 +46,7 @@ class PluginTemplate:
     plugin_type: PluginType
     output_dir: Path
     author: str = "Plugin Author"
-    description: str = "Custom TraceKit plugin"
+    description: str = "Custom Oscura plugin"
     version: str = "0.1.0"
 
 
@@ -117,7 +117,7 @@ def generate_plugin_template(
 
     # Generate default description if not provided
     if description is None:
-        description = f"Custom {plugin_type} plugin for TraceKit"
+        description = f"Custom {plugin_type} plugin for Oscura"
 
     # Create template configuration
     template = PluginTemplate(
@@ -176,7 +176,7 @@ def _write_init_py(template: PluginTemplate) -> None:
     content = textwrap.dedent(f'''\
         """{template.description}
 
-        This plugin integrates with TraceKit via entry points.
+        This plugin integrates with Oscura via entry points.
 
         Plugin Metadata:
             Name: {template.name}
@@ -188,7 +188,7 @@ def _write_init_py(template: PluginTemplate) -> None:
             pip install -e .
 
         Usage:
-            import oscura as tk
+            import oscura as osc
             # Plugin auto-discovered via entry points
             # See README.md for usage examples
 
@@ -328,10 +328,10 @@ def _write_readme(template: PluginTemplate) -> None:
 
         ## Usage
 
-        The plugin integrates automatically with TraceKit via entry points:
+        The plugin integrates automatically with Oscura via entry points:
 
         ```python
-        import oscura as tk
+        import oscura as osc
 
         # Plugin is automatically discovered
         # USER: Add usage examples specific to your plugin
@@ -350,7 +350,7 @@ def _write_readme(template: PluginTemplate) -> None:
 
         ## CLI Integration
 
-        After installation, the plugin is available in TraceKit CLI:
+        After installation, the plugin is available in Oscura CLI:
 
         ```bash
         # List installed plugins
@@ -383,7 +383,7 @@ def _write_readme(template: PluginTemplate) -> None:
 
         ## Plugin Type: {template.plugin_type}
 
-        This is a **{template.plugin_type}** plugin for TraceKit.
+        This is a **{template.plugin_type}** plugin for Oscura.
 
         ### Entry Point
 
@@ -391,7 +391,7 @@ def _write_readme(template: PluginTemplate) -> None:
 
         ## Requirements
 
-        - TraceKit >= 0.1.0
+        - Oscura >= 0.1.0
         - Python >= 3.12
 
         ## License
@@ -453,7 +453,7 @@ def _write_pyproject_toml(template: PluginTemplate) -> None:
             "mypy>=1.13.0",
         ]
 
-        # TraceKit plugin entry point
+        # Oscura plugin entry point
         [project.entry-points."{entry_point_group}"]
         {template.name} = "{template.name}:{class_name}"
 
@@ -528,7 +528,7 @@ def _generate_decoder_stub(template: PluginTemplate, class_name: str) -> str:
     return textwrap.dedent(f'''\
         """{template.description}
 
-        This decoder implements protocol decoding for TraceKit.
+        This decoder implements protocol decoding for Oscura.
 
         References:
             PLUG-008: Plugin Template Generator
@@ -617,7 +617,7 @@ def _generate_analyzer_stub(template: PluginTemplate, class_name: str) -> str:
     return textwrap.dedent(f'''\
         """{template.description}
 
-        This analyzer implements custom signal analysis for TraceKit.
+        This analyzer implements custom signal analysis for Oscura.
 
         References:
             PLUG-008: Plugin Template Generator
@@ -692,7 +692,7 @@ def _generate_loader_stub(template: PluginTemplate, class_name: str) -> str:
     return textwrap.dedent(f'''\
         """{template.description}
 
-        This loader implements file format loading for TraceKit.
+        This loader implements file format loading for Oscura.
 
         References:
             PLUG-008: Plugin Template Generator
@@ -777,7 +777,7 @@ def _generate_exporter_stub(template: PluginTemplate, class_name: str) -> str:
     return textwrap.dedent(f'''\
         """{template.description}
 
-        This exporter implements custom export format for TraceKit.
+        This exporter implements custom export format for Oscura.
 
         References:
             PLUG-008: Plugin Template Generator
@@ -866,7 +866,7 @@ def _generate_generic_stub(template: PluginTemplate, class_name: str) -> str:
     return textwrap.dedent(f'''\
         """{template.description}
 
-        This is a generic plugin implementation for TraceKit.
+        This is a generic plugin implementation for Oscura.
 
         References:
             PLUG-008: Plugin Template Generator

oscura/extensibility/validation.py

@@ -1,4 +1,4 @@
-"""Extension validation system for TraceKit plugins and custom decoders.
+"""Extension validation system for Oscura plugins and custom decoders.
 
 This module provides comprehensive validation of extensions including metadata
 validation, interface compliance checking, dependency verification, and
@@ -515,7 +515,7 @@ def _validate_entry_points(extension_path: Path, result: ValidationResult) -> No
 
         if not oscura_groups:
             result.add_warning(
-                "No TraceKit entry points found",
+                "No Oscura entry points found",
                 location="[project.entry-points]",
                 fix_hint="Add entry point like: oscura.decoders = ...",
             )
@@ -589,7 +589,7 @@ def _check_dependencies(extension_path: Path, result: ValidationResult) -> None:
         oscura_deps = [d for d in dependencies if "oscura" in d.lower()]
         if not oscura_deps:
             result.add_warning(
-                "TraceKit not listed in dependencies",
+                "Oscura not listed in dependencies",
                 location="[project.dependencies]",
                 fix_hint='Add: "oscura>=0.1.0"',
             )

oscura/filtering/__init__.py

@@ -1,4 +1,4 @@
-"""Signal filtering module for TraceKit.
+"""Signal filtering module for Oscura.
 
 Provides digital filter design, application, and introspection capabilities
 including IIR and FIR filters, various filter types (Butterworth, Chebyshev,

oscura/filtering/base.py

@@ -1,4 +1,4 @@
-"""Base filter classes for TraceKit filtering module.
+"""Base filter classes for Oscura filtering module.
 
 Provides abstract base classes for IIR and FIR filter implementations
 with common interface for filter application and introspection.

oscura/filtering/convenience.py

@@ -1,4 +1,4 @@
-"""Convenience filtering functions for TraceKit.
+"""Convenience filtering functions for Oscura.
 
 Provides simple one-call filter functions for common operations like
 moving average, median filter, Savitzky-Golay smoothing, and matched

oscura/filtering/design.py

@@ -1,4 +1,4 @@
-"""Filter design functions for TraceKit.
+"""Filter design functions for Oscura.
 
 Provides high-level filter design API with support for Butterworth,
 Chebyshev, Bessel, and Elliptic filter types. Supports automatic

oscura/filtering/introspection.py

@@ -1,4 +1,4 @@
-"""Filter introspection and visualization for TraceKit.
+"""Filter introspection and visualization for Oscura.
 
 Provides filter analysis tools including Bode plots, impulse response,
 step response, and pole-zero diagrams.

oscura/guidance/__init__.py

@@ -1,4 +1,4 @@
-"""TraceKit guidance module.
+"""Oscura guidance module.
 
 Provides guided analysis workflows and recommendations.
 """

oscura/guidance/recommender.py

@@ -11,7 +11,7 @@ Example:
     ...     print(f"{rec.title}: {rec.explanation}")
 
 References:
-    TraceKit Auto-Discovery Specification
+    Oscura Auto-Discovery Specification
 """
 
 from __future__ import annotations

oscura/guidance/wizard.py

@@ -11,7 +11,7 @@ Example:
     >>> result = wizard.run()
 
 References:
-    TraceKit Auto-Discovery Specification
+    Oscura Auto-Discovery Specification
     Phase 34 Task-247
 """
 

oscura/inference/__init__.py

@@ -1,4 +1,4 @@
-"""Auto-inference and smart defaults for TraceKit.
+"""Auto-inference and smart defaults for Oscura.
 
 This module provides automatic parameter detection and intelligent defaults
 for common analysis tasks.

oscura/inference/adaptive_tuning.py

@@ -5,9 +5,9 @@ reducing the need for manual parameter specification.
 
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load('signal.wfm')
-    >>> tuner = tk.AdaptiveParameterTuner(trace.data, trace.metadata.sample_rate)
+    >>> import oscura as osc
+    >>> trace = osc.load('signal.wfm')
+    >>> tuner = osc.AdaptiveParameterTuner(trace.data, trace.metadata.sample_rate)
     >>> params = tuner.get_spectral_params()
     >>> print(f"NFFT: {params.get('nfft')}")
     >>> print(f"Window: {params.get('window')}")

oscura/inference/logic.py

@@ -5,9 +5,9 @@ detect the logic family (TTL, CMOS, LVTTL, LVCMOS, etc.).
 
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load('digital_signal.wfm')
-    >>> family = tk.detect_logic_family(trace)
+    >>> import oscura as osc
+    >>> trace = osc.load('digital_signal.wfm')
+    >>> family = osc.detect_logic_family(trace)
     >>> print(f"Detected: {family['primary']['name']}")
     >>> print(f"Confidence: {family['primary']['confidence']:.1%}")
 
@@ -122,8 +122,8 @@ def detect_logic_family(
         AnalysisError: If signal is not bimodal or levels are ambiguous.
 
     Example:
-        >>> trace = tk.load('cmos_signal.wfm')
-        >>> result = tk.detect_logic_family(trace, return_candidates=True)
+        >>> trace = osc.load('cmos_signal.wfm')
+        >>> result = osc.detect_logic_family(trace, return_candidates=True)
         >>> print(f"Primary: {result['primary']['name']}")
         >>> print(f"Confidence: {result['primary']['confidence']:.1%}")
         >>> for candidate in result['candidates']:

oscura/inference/protocol.py

@@ -5,9 +5,9 @@ automatically detect serial protocol types.
 
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load('serial_data.wfm')
-    >>> result = tk.detect_protocol(trace)
+    >>> import oscura as osc
+    >>> trace = osc.load('serial_data.wfm')
+    >>> result = osc.detect_protocol(trace)
     >>> print(f"Protocol: {result['protocol']}")
     >>> print(f"Confidence: {result['confidence']:.1%}")
 
@@ -67,8 +67,8 @@ def detect_protocol(
         AnalysisError: If no protocol can be detected with sufficient confidence.
 
     Example:
-        >>> trace = tk.load('unknown_serial.wfm')
-        >>> result = tk.detect_protocol(trace, return_candidates=True)
+        >>> trace = osc.load('unknown_serial.wfm')
+        >>> result = osc.detect_protocol(trace, return_candidates=True)
         >>> print(f"Detected: {result['protocol']}")
         >>> print(f"Baud rate: {result['config'].get('baud_rate', 'N/A')}")
         >>> for candidate in result['candidates']:

oscura/inference/signal_intelligence.py

@@ -1,4 +1,4 @@
-"""Signal classification and measurement intelligence for TraceKit.
+"""Signal classification and measurement intelligence for Oscura.
 
 This module provides intelligent signal type detection, quality assessment,
 and measurement suitability checking to help users understand why they might
@@ -6,14 +6,14 @@ get NaN results and which measurements are appropriate for their signals.
 
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load('signal.wfm')
-    >>> classification = tk.classify_signal(trace)
+    >>> import oscura as osc
+    >>> trace = osc.load('signal.wfm')
+    >>> classification = osc.classify_signal(trace)
     >>> print(f"Signal type: {classification['type']}")
     >>> print(f"Characteristics: {classification['characteristics']}")
-    >>> quality = tk.assess_signal_quality(trace)
+    >>> quality = osc.assess_signal_quality(trace)
     >>> print(f"SNR: {quality['snr']:.1f} dB")
-    >>> suggestions = tk.suggest_measurements(trace)
+    >>> suggestions = osc.suggest_measurements(trace)
     >>> print(f"Recommended measurements: {suggestions}")
 
 References:
@@ -71,8 +71,8 @@ def classify_signal(
         - levels: For digital signals, dict with "low" and "high" levels
 
     Example:
-        >>> trace = tk.load('square_wave.wfm')
-        >>> info = tk.classify_signal(trace)
+        >>> trace = osc.load('square_wave.wfm')
+        >>> info = osc.classify_signal(trace)
         >>> print(f"Type: {info['signal_type']}")
         Type: digital
         >>> print(f"Characteristics: {info['characteristics']}")
@@ -289,8 +289,8 @@ def assess_signal_quality(
         - crest_factor: Peak-to-RMS ratio
 
     Example:
-        >>> trace = tk.load('noisy_sine.wfm')
-        >>> quality = tk.assess_signal_quality(trace)
+        >>> trace = osc.load('noisy_sine.wfm')
+        >>> quality = osc.assess_signal_quality(trace)
         >>> print(f"SNR: {quality['snr']:.1f} dB")
         SNR: 42.3 dB
         >>> if quality['warnings']:
@@ -487,8 +487,8 @@ def check_measurement_suitability(
         - expected_result: "valid", "nan", or "unreliable"
 
     Example:
-        >>> trace = tk.load('dc_signal.wfm')
-        >>> check = tk.check_measurement_suitability(trace, "frequency")
+        >>> trace = osc.load('dc_signal.wfm')
+        >>> check = osc.check_measurement_suitability(trace, "frequency")
         >>> if not check['suitable']:
         ...     print(f"Warning: {check['warnings']}")
         Warning: ['Frequency measurement not suitable for DC signal']
@@ -661,8 +661,8 @@ def suggest_measurements(
         - confidence: Confidence in recommendation (0.0-1.0)
 
     Example:
-        >>> trace = tk.load('square_wave.wfm')
-        >>> suggestions = tk.suggest_measurements(trace)
+        >>> trace = osc.load('square_wave.wfm')
+        >>> suggestions = osc.suggest_measurements(trace)
         >>> for s in suggestions[:3]:
         ...     print(f"{s['name']}: {s['rationale']}")
         frequency: Periodic digital signal detected
@@ -1268,11 +1268,11 @@ def recommend_analyses(
 
     Example:
         >>> import numpy as np
-        >>> import oscura as tk
+        >>> import oscura as osc
         >>> # Generate test signal
         >>> t = np.linspace(0, 1, 10000)
         >>> signal = np.sin(2 * np.pi * 100 * t)
-        >>> recommendations = tk.recommend_analyses(signal, sample_rate=10000)
+        >>> recommendations = osc.recommend_analyses(signal, sample_rate=10000)
         >>> for rec in recommendations[:3]:
         ...     print(f"{rec.domain.value}: {rec.reasoning}")
         waveform: Basic waveform measurements are always applicable
@@ -1452,12 +1452,12 @@ def get_optimal_domain_order(
 
     Example:
         >>> import numpy as np
-        >>> import oscura as tk
+        >>> import oscura as osc
         >>> # Generate test signal
         >>> t = np.linspace(0, 1, 10000)
         >>> signal = np.sin(2 * np.pi * 100 * t)
-        >>> recommendations = tk.recommend_analyses(signal, sample_rate=10000)
-        >>> order = tk.get_optimal_domain_order(recommendations)
+        >>> recommendations = osc.recommend_analyses(signal, sample_rate=10000)
+        >>> order = osc.get_optimal_domain_order(recommendations)
         >>> print([d.value for d in order])
         ['waveform', 'statistics', 'spectral', 'patterns', 'entropy']
     """

oscura/inference/spectral.py

@@ -5,9 +5,9 @@ based on signal characteristics.
 
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load('signal.wfm')
-    >>> config = tk.auto_spectral_config(trace)
+    >>> import oscura as osc
+    >>> trace = osc.load('signal.wfm')
+    >>> config = osc.auto_spectral_config(trace)
     >>> print(f"Method: {config['method']}")
     >>> print(f"Window: {config['window']}")
 
@@ -60,13 +60,13 @@ def auto_spectral_config(
         - rationale: Explanation of selection (if log_rationale=True)
 
     Example:
-        >>> trace = tk.load('noisy_signal.wfm')
-        >>> config = tk.auto_spectral_config(trace, dynamic_range_db=80)
+        >>> trace = osc.load('noisy_signal.wfm')
+        >>> config = osc.auto_spectral_config(trace, dynamic_range_db=80)
         >>> print(f"Method: {config['method']}")
         >>> print(f"Window: {config['window']}")
         >>> print(f"Rationale: {config['rationale']}")
         >>> # Use configuration
-        >>> freq, psd = tk.psd(trace, **config)
+        >>> freq, psd = osc.psd(trace, **config)
 
     References:
         Welch, P. D. (1967): Use of FFT for estimation of power spectra

oscura/integrations/__init__.py

@@ -1,4 +1,4 @@
-"""TraceKit Integrations.
+"""Oscura Integrations.
 
 Third-party and external system integrations.
 """

oscura/integrations/llm.py

@@ -1,4 +1,4 @@
-"""LLM Integration for TraceKit.
+"""LLM Integration for Oscura.
 
 Provides hooks for Large Language Model integration to enable natural language
 analysis and assistance.
@@ -33,7 +33,7 @@ from enum import Enum
 from threading import Lock
 from typing import Any, Protocol
 
-from oscura.core.exceptions import TraceKitError
+from oscura.core.exceptions import OscuraError
 
 # ==============================================================================
 # Cost Constants (API-020: Cost Tracking)
@@ -339,7 +339,7 @@ class LLMResponse:
     Attributes:
         answer: Main text response
         confidence: Confidence score (0-1) if available
-        suggested_commands: List of suggested TraceKit commands
+        suggested_commands: List of suggested Oscura commands
         metadata: Additional metadata from LLM
         raw_response: Raw response data for debugging
         estimated_cost: Estimated cost in USD for this request (API-020)
@@ -385,7 +385,7 @@ class LLMClient(Protocol):
         ...
 
 
-class LLMError(TraceKitError):
+class LLMError(OscuraError):
     """LLM integration error."""
 
 
@@ -875,7 +875,7 @@ class OpenAIClient:
         return "\n".join(summary_parts)
 
     def _extract_commands(self, text: str) -> list[str]:
-        """Extract suggested TraceKit commands from LLM response.
+        """Extract suggested Oscura commands from LLM response.
 
         Args:
             text: LLM response text
@@ -1225,7 +1225,7 @@ class AnthropicClient:
         return "\n".join(summary_parts)
 
     def _extract_commands(self, text: str) -> list[str]:
-        """Extract suggested TraceKit commands from LLM response.
+        """Extract suggested Oscura commands from LLM response.
 
         Args:
             text: LLM response text

oscura/jupyter/__init__.py

@@ -1,4 +1,4 @@
-"""Jupyter and IPython integration for TraceKit.
+"""Jupyter and IPython integration for Oscura.
 
 This package provides IPython magic commands, rich display integration,
 and Jupyter notebook-specific features.
@@ -17,14 +17,14 @@ from oscura.jupyter.display import (
     display_trace,
 )
 from oscura.jupyter.magic import (
-    TracekitMagics,
+    OscuraMagics,
     load_ipython_extension,
 )
 
 __all__ = [
     "MeasurementDisplay",
+    "OscuraMagics",
     "TraceDisplay",
-    "TracekitMagics",
     "display_measurements",
     "display_spectrum",
     "display_trace",

oscura/jupyter/display.py

@@ -1,6 +1,6 @@
 """Rich display integration for Jupyter notebooks.
 
-This module provides rich HTML display for TraceKit objects including
+This module provides rich HTML display for Oscura objects including
 traces, measurements, and spectral data.
 
   - HTML tables for measurements