dtoro
64f7d54011
Problem: the hexagon's Phase 2 (plans/2026-08-15-hexagonal-architecture.md) must give the use-cases-to-be their contract surface: driven-port interfaces, test fakes, the secrets interface moved into core, and the postgres package inside the adapters tree — before the first vertical slice (Phase 3) can wire a composition root. Change: - internal/core/ports: full driven-port catalog per plan §3.3 — repositories as transaction-scoped aggregates whose inputs carry derived checks, audit, and events (§3.6), plus CommandExecutor, TargetResolver, Checker, Secrets, EventPublisher, Provisioner. Port-local payload types (Event, AuditEntry, CheckDef, KnowledgeEntry, ExecResult) keep signatures off infrastructure; TypeTree aliases internal/ontology (pure over domain) until checkdefaults is absorbed. ReadModels intentionally not declared yet — it materializes with the Phase 3 slice and grows as report handlers rewire. - secrets.Backend is now an alias of ports.Secrets; implementations (Infisical, SOPS, Manager) unchanged. mcp's local secretBackend subset is deleted; tool constructors take ports.Secrets. - internal/db → internal/adapters/postgres (mechanical import rewrite; package identifier stays db until the Phase 3 repository split). sqlc.yaml, Makefile, golangci exclusions, and docs follow the move; make generate-check verified. - internal/adapters/ssh: Executor implements ports.CommandExecutor over the actuator dial pool + RunStreaming (10-min default timeout carried over from the httpapi path). - internal/adapters/remote: Resolver implements ports.TargetResolver delegating to internal/remote (still pool-based; drops onto ports.EntityRepository when repositories land in Phase 3 — documented transitional import). - internal/core/ports/portstest: importable fakes — in-memory EntityRepo (with check-then-act SetState, side-effect recording), RecordingExecutor, FakeChecker, SpyPublisher; port-satisfaction guards; tests. Risk: ports are declared ahead of implementations — signatures firm up per phase as slices land (documented in the package doc); the remote→postgres transitional import is explicit and dissolves in Phase 3. Verification: go vet, make test (race, 19 packages), generate-check, golangci on core+adapters — 0 issues; full-repo baseline down 365→344.
67 lines
1.9 KiB
Go
67 lines
1.9 KiB
Go
package observability
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
|
|
"github.com/dtoro/oikos/internal/adapters/postgres/sqlcgen"
|
|
"github.com/google/uuid"
|
|
)
|
|
|
|
// Audit writes an audit_log entry. Pass a transaction-bound Queries so the
|
|
// entry commits or rolls back atomically with the state change it records.
|
|
//
|
|
// actorLabel is the interim textual actor identity ("operator:dev",
|
|
// "agent:mcp") recorded in detail; actor_id (a Person/Agent entity UUID)
|
|
// starts being populated when OIDC identity resolution lands.
|
|
func Audit(ctx context.Context, q *sqlcgen.Queries, actorType, actorLabel,
|
|
action string, entityID *uuid.UUID, method, path, correlationID string,
|
|
sessionID *uuid.UUID, detail map[string]any) error {
|
|
|
|
if detail == nil {
|
|
detail = map[string]any{}
|
|
}
|
|
detail["actor"] = actorLabel
|
|
detailJSON, _ := json.Marshal(detail)
|
|
|
|
var corr *string
|
|
if correlationID != "" {
|
|
corr = &correlationID
|
|
}
|
|
return q.InsertAuditEntry(ctx, sqlcgen.InsertAuditEntryParams{
|
|
ActorType: actorType,
|
|
Action: action,
|
|
EntityID: entityID,
|
|
Method: &method,
|
|
Path: &path,
|
|
Detail: detailJSON,
|
|
CorrelationID: corr,
|
|
SessionID: sessionID,
|
|
})
|
|
}
|
|
|
|
// Event emits a structured event in the caller's transaction (SG10). The
|
|
// post-commit NOTIFY trigger (migration 008) fans it out to SSE subscribers.
|
|
func Event(ctx context.Context, q *sqlcgen.Queries, eventType string,
|
|
entityID *uuid.UUID, severity, source string, correlationID string,
|
|
data map[string]any) error {
|
|
|
|
dataJSON, _ := json.Marshal(data)
|
|
if data == nil {
|
|
dataJSON = []byte("{}")
|
|
}
|
|
var corr *string
|
|
if correlationID != "" {
|
|
corr = &correlationID
|
|
}
|
|
_, err := q.InsertEvent(ctx, sqlcgen.InsertEventParams{
|
|
Type: eventType,
|
|
EntityID: entityID,
|
|
Severity: severity,
|
|
Source: source,
|
|
Data: dataJSON,
|
|
CorrelationID: corr,
|
|
})
|
|
return err
|
|
}
|