tramai-spring-boot-starter-sovereign-ops-actuator

Version: 0.6.0
Status: Preview
Role: Read-only operational visibility for the sovereign ops workers. Every surface is disabled until enabled by property.

Purpose

Background workers fail silently unless something reports their state. This add-on exposes worker status and health through Spring Boot Actuator while keeping the payload deliberately sparse: cycle counts, last run timestamps and UP/DOWN/DEGRADED status — no prompts, model responses, stack traces, tool arguments or identifiers.

What it provides

SovereignOpsWorkerStatusEndpointProperties and ApprovedContinuationResumeWorkerMetricsProperties bind those keys. Actuator must be on the classpath and the corresponding status store beans must exist; a custom bean with the same name suppresses the auto-configured one. A health indicator degrades to DOWN rather than throwing when the underlying store is unavailable.

Dependencies

dependencies {
    implementation(platform("dev.tramai:tramai-bom:0.6.0"))
    implementation("dev.tramai:tramai-spring-boot-starter")
    implementation("dev.tramai:tramai-spring-boot-starter-sovereign-ops")
    implementation("dev.tramai:tramai-spring-boot-starter-sovereign-ops-actuator")
}

tramai:
  sovereign:
    ops:
      outbox:
        worker:
          enabled: true
      actuator:
        worker-status:
          enabled: true
        worker-health:
          enabled: true

management:
  endpoints:
    web:
      exposure:
        include: health,tramaiSovereignOpsWorker

curl http://localhost:8080/actuator/tramaiSovereignOpsWorker
curl http://localhost:8080/actuator/health

When to use this add-on

• Operators need to see whether the audit outbox or resume worker is running and healthy.
• You want the health component wired into your existing Actuator health endpoint.
• You need queue snapshots without adopting a metrics backend.

When NOT to use this add-on

• You need time-series metrics or PromQL: use tramai-spring-boot-starter-sovereign-ops-micrometer.
• You need spans and distributed tracing: use tramai-spring-boot-starter-sovereign-ops-observability.
• The application does not use Actuator — nothing is exposed without it.