enodia-sentinal/go-agent/internal/rootcheck/manager.go
Luna d835386381
feat(go): port FIM/pkgdb/rootcheck integrity engines and add go-sidecar dashboard consumer
Adds sidecar-only, --state-dir-gated FIM, package-DB-anchor, and rootcheck
engines to the Go migration sidecar, wired into agent.Sweep/Initialize
behind the existing baseline lifecycle. Adds a read-only, schema-checked
Python dashboard consumer (go_sidecar_state_dir, /api/go-sidecar/*, Sidecar
tab) that never starts, stops, or mutates the Go sidecar's state.

Also fixes drift found while reconciling this work: enodia_sentinel/web.py
had reinvented local schema constants instead of using the canonical
enodia_sentinel/schemas.py catalog (now registers enodia.go.sidecar.v1
there and reuses ALERT_SNAPSHOT_V1/INCIDENT_V1); docs/RULES.md had drifted
from what `rules docs` actually generates for SIDs 100069-100078 (ruleops.py
was missing metadata for four SIDs and had stale drill text for four more),
now back in sync with a regression test pinning them together.

Updates CLAUDE.md, README.md, go-agent/README.md, and docs/{ROADMAP,
GO_PORT_HANDOFF,SURICATA_ASSIMILATION,THREAT_MODEL,OPERATIONS,SCHEMAS,
COMMAND_REFERENCE}.md to reflect the landed work.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NQivSKBqQJsayz1xcYqWzZ
2026-07-24 09:59:09 -07:00

72 lines
2 KiB
Go

// SPDX-License-Identifier: GPL-3.0-or-later
package rootcheck
import (
"context"
"sync"
"time"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/config"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
const runTimeout = 30 * time.Second
// Manager schedules the expensive cross-view collection independently from
// polling. One bounded check may run at a time; completed alerts return to the
// Agent's existing cooldown, incident, and snapshot path on the next sweep.
type Manager struct {
Config config.Config
Now func() time.Time
Run func(context.Context, model.State) []model.Alert
mu sync.Mutex
lastRun time.Time
running bool
pending []model.Alert
}
func New(cfg config.Config) *Manager {
manager := &Manager{Config: cfg, Now: time.Now}
manager.Run = func(ctx context.Context, state model.State) []model.Alert {
return Run(ctx, state, cfg.RootcheckPIDCap, cfg.RootcheckModuleAllow)
}
return manager
}
func (m *Manager) MaybeStart(now time.Time, state model.State) {
if !m.Config.RootcheckEnabled {
return
}
m.mu.Lock()
defer m.mu.Unlock()
if m.running || (!m.lastRun.IsZero() && now.Sub(m.lastRun) < m.Config.RootcheckInterval) {
return
}
// Record the start before launching the goroutine. This prevents a fast
// polling loop from scheduling duplicates while collection is still running
// or while a timed-out external command unwinds.
m.running, m.lastRun = true, now
go m.run(state)
}
func (m *Manager) run(state model.State) {
// Rootcheck compares several host views and may invoke ps; its deadline
// makes that diagnostic work bounded even on a degraded host.
ctx, cancel := context.WithTimeout(context.Background(), runTimeout)
defer cancel()
alerts := m.Run(ctx, state)
m.mu.Lock()
m.pending = append(m.pending, alerts...)
m.running = false
m.mu.Unlock()
}
func (m *Manager) Drain() []model.Alert {
m.mu.Lock()
defer m.mu.Unlock()
alerts := append([]model.Alert(nil), m.pending...)
m.pending = nil
return alerts
}