changelog.md for @push.rocks/smartmetrics

2026-03-23 - 3.0.3 - fix(prometheus)

clean up default Prometheus metric collectors on stop

• Return cleanup handlers from default metric registration for event loop and GC observers.
• Dispose registered Prometheus default metric collectors when stopping Smartmetrics to prevent lingering observers.

2026-03-02 - 3.0.2 - fix(pidusage)

prune history entries for PIDs not present in the requested set to avoid stale data and memory growth

• Deletes entries from the history map when a PID is not included in the current pids array
• Prevents accumulation of stale PID histories and potential memory growth
• Change implemented in ts/smartmetrics.pidusage.ts alongside the metrics result construction

2026-02-19 - 3.0.1 - fix(smartmetrics)

no code changes detected; no version bump or release required

• git diff contained no modifications
• current package.json version is 3.0.0
• no dependency or file changes to warrant a release

2026-02-19 - 3.0.0 - BREAKING CHANGE(smartmetrics)

add system-wide metrics collection, Prometheus gauges, and normalized CPU reporting

• Add new sysusage plugin (ts/smartmetrics.sysusage.ts) that reads /proc/stat and /proc/meminfo (with os fallback) and returns system CPU, memory and load averages.
• Expose system-wide Prometheus gauges: smartmetrics_system_cpu_percent, smartmetrics_system_memory_used_percent, smartmetrics_system_memory_used_bytes, smartmetrics_system_load_avg_1, smartmetrics_system_load_avg_5, smartmetrics_system_load_avg_15.
• Extend IMetricsSnapshot with system fields: systemCpuPercent, systemMemTotalBytes, systemMemAvailableBytes, systemMemUsedBytes, systemMemUsedPercent, systemLoadAvg1, systemLoadAvg5, systemLoadAvg15 (this is a breaking TypeScript API change).
• Normalize per-process CPU in pidusage by adding cpuCoreCount and cpuNormalizedPercent and use cpuNormalizedPercent when aggregating CPU across the process tree.
• Export the new sysusage plugin from ts/smartmetrics.plugins.ts and wire system metrics into metric collection and Prometheus gauge updates.

2026-02-19 - 2.0.11 - fix(deps)

bump dependencies, update build script, expand README and npm metadata

• Bumped runtime deps: @push.rocks/smartdelay ^3.0.5, @push.rocks/smartlog ^3.1.11
• Updated devDependencies: @git.zone/tsbuild, tsbundle, tsrun, tstest and @types/node versions
• Changed build script: "(tsbuild --web)" → "(tsbuild tsfolders)"
• Updated npmextra.json: renamed keys (gitzone → @git.zone/cli, tsdoc → @git.zone/tsdoc), added release registries and accessLevel, and added @ship.zone/szci entry
• Extensive README improvements: installation notes (pnpm), clearer API docs, examples, added Issue Reporting & Security section and utility docs (formatBytes)

2025-06-09 - 2.0.9 - fix(readme)

Update documentation with detailed usage instructions, API references and integration examples.

• Overhauled README to provide a clearer explanation of SmartMetrics features and API.
• Added a quick start guide, detailed examples, and code snippets for various integrations (Express, PM2, custom dashboards).
• Reorganized documentation sections to better highlight core concepts including process aggregation and memory limit detection.
• Updated installation instructions and usage examples to reflect the latest functionality.

2025-06-09 - 2.0.8 - fix(smartmetrics)

Refactor metrics calculation and update Prometheus integration documentation

• Removed dependency on registry.getMetricsAsJSON by directly calculating Node.js metrics
• Updated getMetrics to compute CPU time, heap size, and set default values for deprecated metrics
• Enhanced documentation with comprehensive Prometheus integration examples
• Improved logging on shutdown of the Prometheus endpoint

2025-06-09 - 2.0.7 - Prometheus Metrics Integration

feat: Implement Prometheus metrics exposure in SmartMetrics

• Added Prometheus gauges for CPU and memory metrics.
• Implemented HTTP server to expose metrics at the /metrics endpoint.
• Created methods to enable and disable the Prometheus endpoint.
• Updated getMetrics() to set gauge values.
• Added tests for Prometheus metrics functionality.
• Updated documentation plan for Prometheus integration.

2023-07-02 to 2023-08-08 - 2.0.0 to 2.0.6 - Maintenance Updates

Over this period several releases were published with iterative fixes and minor organizational changes.

• Applied multiple core fixes and routine maintenance updates.
• Switched to new organization scheme (recorded on 2023-07-10).
• Performed several version bumps and configuration updates.

2021-08-12 to 2022-07-27 - 1.0.1 to 1.0.17 - Maintenance and Breaking Changes

During this interval a series of minor fixes were combined with a significant breaking change.

• BREAKING CHANGE: Switched to ESM in 1.0.17 (2022-07-27).
• Numerous maintenance updates and core fixes were applied.