= core-observability

== purpose

Placeholder module reserved for observability primitives (metrics, structured logging, tracing). Currently contains no source files — the module is a Gradle subproject with no implementation.

== responsibilities

* Intended: define observability contracts (metric types, span interfaces)
* Intended: provide base abstractions used by `infra:telemetry`

== non-responsibilities

* Does not implement telemetry infrastructure — that belongs to `infra:telemetry`
* Does not collect runtime metrics directly
* Does not manage log output destinations

== key types

*None.* The module has no source files.

== event flow

*None.* No events are consumed or emitted. This is a placeholder.

== integration points

No integration points. The module has no dependencies beyond `core:events`.

== invariants

None — module is empty.

== PlantUML diagram

[plantuml, core-observability, "png"]
----
include::../../diagrams/core-observability.puml[]
----




== known issues

Module is a placeholder — no observability contract exists.

== open questions

* Which metrics framework will be used (Micrometer, OpenTelemetry, custom)?
* Will observability be event-sourced or side-channel?