feat: expose effective runtime settings in metrics

internal/observability/catalog.go

@@ -62,5 +62,7 @@ func catalog() map[string]descriptor {
 	c["orbit_business_snapshot_duration_seconds"] = descriptor{histogram, "Bounded business-state snapshot duration in seconds", nil}
 	c["orbit_business_snapshot_last_success_timestamp_seconds"] = descriptor{gauge, "Unix time of the last successful bounded business-state snapshot", nil}
 	c["orbit_business_snapshot_truncated"] = descriptor{gauge, "Whether a bounded business-state sample hit its per-state cap", nil}
+	c["orbit_runtime_tick_interval_seconds"] = descriptor{gauge, "Configured background controller tick interval in seconds", map[string][]string{"component": components}}
+	c["orbit_runtime_batch_limit"] = descriptor{gauge, "Configured maximum candidates per background batch", nil}
 	return c
 }

internal/observability/metrics_test.go

@@ -96,6 +96,7 @@ func TestInvalidNumbersAndMonotoneCounters(t *testing.T) {
 }
 func TestRuntimeObservationDoesNotExposeErrors(t *testing.T) {
 	r := NewRegistry()
+	r.RecordRuntimeConfig(RuntimeConfig{WorkflowTickInterval: time.Second, ScheduleTickInterval: 1500 * time.Millisecond, RecoveryTickInterval: 2 * time.Second, BatchLimit: 37})
 	r.RecordBatch("workflow", time.Now().Add(-time.Millisecond), nil)
 	r.RecordBatch("workflow", time.Now(), errors.New("private-dsn"))
 	r.RecordBatch("schedule", time.Now(), context.Canceled)
@@ -106,6 +107,11 @@ func TestRuntimeObservationDoesNotExposeErrors(t *testing.T) {
 			t.Fatal("missing runtime evidence", want)
 		}
 	}
+	for _, want := range []string{`orbit_runtime_tick_interval_seconds{component="workflow"} 1`, `orbit_runtime_tick_interval_seconds{component="schedule"} 1.5`, `orbit_runtime_tick_interval_seconds{component="execution_recovery"} 2`, "orbit_runtime_batch_limit 37\n"} {
+		if !strings.Contains(out, want) {
+			t.Fatal("missing runtime configuration", want)
+		}
+	}
 	if !strings.Contains(out, `orbit_build_info{go_version="`+runtime.Version()+`",revision="unknown",version="dev"} 1`) {
 		t.Fatal("missing build identity")
 	}

internal/observability/runtime.go

@@ -10,6 +10,26 @@ import (
 	"git.yuntuo.hk/k2safe/orbit/internal/buildinfo"
 )
 
+// RuntimeConfig 是节点启动后实际生效的后台控制参数。
+// 它只用于固定基数观测，不参与业务授权或持久化状态判断。
+type RuntimeConfig struct {
+	WorkflowTickInterval time.Duration
+	ScheduleTickInterval time.Duration
+	RecoveryTickInterval time.Duration
+	BatchLimit           int
+}
+
+// RecordRuntimeConfig records the effective bounded controller settings.
+func (r *Registry) RecordRuntimeConfig(config RuntimeConfig) {
+	if r == nil || config.WorkflowTickInterval <= 0 || config.ScheduleTickInterval <= 0 || config.RecoveryTickInterval <= 0 || config.BatchLimit <= 0 {
+		return
+	}
+	r.SetGauge("orbit_runtime_tick_interval_seconds", config.WorkflowTickInterval.Seconds(), Labels{"component": "workflow"})
+	r.SetGauge("orbit_runtime_tick_interval_seconds", config.ScheduleTickInterval.Seconds(), Labels{"component": "schedule"})
+	r.SetGauge("orbit_runtime_tick_interval_seconds", config.RecoveryTickInterval.Seconds(), Labels{"component": "execution_recovery"})
+	r.SetGauge("orbit_runtime_batch_limit", float64(config.BatchLimit), nil)
+}
+
 // initializeProcess is called once by the registry constructor.
 func (r *Registry) initializeProcess() {
 	if r == nil {