Skip to content

Releases: discretewater/sitometry

v0.1.0---Initial Public Release

26 Mar 00:49

Choose a tag to compare

Sitometry v0.1.0

Initial public release of Sitometry, a static analyzer for single-file OpenTelemetry Collector YAML configurations.

What it does

Sitometry currently supports a focused semantic analysis workflow:

  • Parse a single Collector YAML config
  • Build an intermediate model
  • Bind component references through a unified registry
  • Run the initial rule set
  • Produce stable diagnostics
  • Render results as text or JSON
  • Exit with stable CLI status codes

Supported Rules

This release includes the initial rule set:

  • STM001 — pipeline references an undeclared receiver
  • STM002 — pipeline references an undeclared processor
  • STM003 — pipeline references an undeclared exporter
  • STM004 — configuration is missing service.pipelines
  • STM005 — declared receiver is unused
  • STM006 — declared processor is unused
  • STM007 — declared exporter is unused

CLI

Supported commands:

  • sitometry analyze <config-file>
  • sitometry analyze <config-file> --format json
  • sitometry version
  • sitometry --help

Exit Codes

  • 0 — analysis completed successfully and no error-level diagnostics were produced
  • 1 — analysis completed successfully and at least one error-level diagnostic was produced
  • 2 — execution failed and analysis could not be completed normally

Included Public Documentation

This release includes:

  • rule IDs reference
  • exit codes reference
  • fixtures reference
  • limitations reference
  • release checklist
  • release notes

Current Scope and Limitations

This release is intentionally narrow and conservative.

Not included in v0.1.0:

  • STM008STM010
  • deep connector rules
  • multi-file configuration support
  • automatic fixes
  • advanced CLI filtering options

Notes

This release is intended to be the public baseline for the project.
The current focus is correctness, explainability, stable output contracts, and CI-friendly static analysis.