Changelog

All notable changes to cloudmesh-ai-common will be documented in this file.

[7.0.6.dev1] - 2026-05-11

Added

• Enhanced DotDict: Significantly expanded DotDict capabilities:
  • merge(): Support for deep merging of nested dictionaries.
  • smart_get(): Flexible lookup supporting both direct dot-paths and recursive search.
  • to_dict() and .dict property: Recursive conversion to standard Python dictionaries.
  • to_json(): Direct serialization to JSON strings.
  • Dot-notation get(): Overrode standard get() to support nested path lookups.

Fixed

• DotDict: Fixed YAML representation to avoid !!python/object/apply tags.
• Shell: Improved SSH noise filtering in Shell.run.

[7.0.5.dev1] - 2026-04-26

Added

• Advanced Console UI: Expanded the Console class with high-impact visual components:
  • banner(): For creating highlighted information panels.
  • table(): For standardized, professional data presentation.
  • bold(): For semantic text emphasis.

[7.0.4.dev1] - 2026-04-26

Added

• Unified Remote Execution: Introduced cloudmesh.ai.common.remote.RemoteExecutor for standardized SSH and SFTP operations.
  • Support for command execution with exit status capture.
  • Simplified file upload and download.
  • Direct remote file writing (write_remote_file).
• Console Enhancements: Added semantic helpers to the Console class: ok(), error(), warning(), and ynchoice().
• Remote Testing: Added tests/test_remote.py with comprehensive mocks for verifying remote operations.

Changed

• I/O Utilities: Removed redundant SSHClient from cloudmesh.ai.common.io in favor of RemoteExecutor.

[7.0.3.dev1] - 2026-04-25

Added

• Enhanced DotDict: Implemented DotDict in cloudmesh.ai.common.util supporting recursive nested attribute access (e.g., d.a.b).
• Debug Utilities: Added HEADING in cloudmesh.ai.common.debug for formatted output with automatic caller context.
• I/O Utilities: Added readfile to cloudmesh.ai.common.io for standardized file reading.
• Common Tests: Added tests/test_common_utils.py to verify new shared utilities.

Changed

• Config System: Refactored cloudmesh.ai.common.Config to use DotDict for internal data management, simplifying dot-path access and updates.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[7.0.2.dev1] - 2026-04-19

Added

• Telemetry Module: Introduced a standardized telemetry system for recording performance metrics and events.
  • Support for multiple backends including JSONL and SQLite.
  • Automatic capture of system context (CPU, GPU, RAM).
  • Async-ready design for AI service integration.
• System Diagnostics: Added cloudmesh.ai.common.sys for GPU detection and system state monitoring.
• Performance Utilities:
  • Implemented thread-safe Stopwatch for precise timing of AI workloads.
  • Added time utilities for standardized time handling.
• I/O & Logging:
  • Specialized io utilities for AI data handling.
  • AI-focused logging module for better traceability of model interactions.
• Data Aggregation: Added aggregation module to handle the combining of AI responses.
• User Context: Implemented user module to manage user-specific AI context and preferences.
• Comprehensive Documentation: Added detailed user manuals for telemetry, system, time, and I/O modules.
• Test Suite: Added integration and unit tests for all core common utilities.

Changed

• Initial project structure established to provide a shared foundation for all cloudmesh-ai extensions.
• I/O Utilities: Updated console to use semantic methods (console.error, console.msg) instead of color-coded console.print for improved consistency.

Fixed

• StopWatch: Fixed TypeError in progress function by ensuring the progress value is handled as a string and corrected keyword arguments for progress and time.