Add run lifecycle report projection

platform/service/server_lifecycle_projection.go

@@ -2,13 +2,65 @@ package service
 
 import (
 	"strings"
-
 	"time"
 
 	"browser.local/platform/domain"
 	"browser.local/platform/validator"
 )
 
+func (svc *CoreService) ReportRunLifecycle(report domain.RunLifecycleReport) (domain.RunLifecycleReportResult, error) {
+	report = domain.CopyRunLifecycleReport(report)
+	if err := validator.ValidateRunLifecycleReport(report); err != nil {
+		return domain.RunLifecycleReportResult{}, err
+	}
+	if _, err := svc.validatedRunSession(report.RunEndpointID, report.SessionToken); err != nil {
+		return domain.RunLifecycleReportResult{}, err
+	}
+	instance, err := svc.store.ServerInstances().Get(report.ServerInstanceID)
+	if err != nil {
+		return domain.RunLifecycleReportResult{}, err
+	}
+	if instance.RunEndpointID != report.RunEndpointID {
+		return domain.RunLifecycleReportResult{}, validationError("runEndpointId must match server instance")
+	}
+	if instance.State == domain.ServerInstanceStateDeleted {
+		return domain.RunLifecycleReportResult{}, validationError("server instance must not be deleted")
+	}
+
+	stamp := svc.now()
+	nextState, projected := lifecycleProjectedState(report.Capability, report.State, report.ExecutionResult)
+	if projected {
+		instance.State = nextState
+		instance.UpdatedAt = stamp
+		if err := validator.ValidateServerInstance(instance); err != nil {
+			return domain.RunLifecycleReportResult{}, err
+		}
+		if err := svc.store.ServerInstances().Update(instance); err != nil {
+			return domain.RunLifecycleReportResult{}, err
+		}
+	}
+	auditResult := domain.AuditResultSuccess
+	if report.State == domain.JobStateFailed || report.State == domain.JobStateCancelled {
+		auditResult = domain.AuditResultFailed
+	}
+	if err := svc.recordAuditEvent("run:"+report.RunEndpointID, "lifecycle.report", "server-instance", instance.ID, auditResult, lifecycleReportSummary(report, nextState, projected)); err != nil {
+		return domain.RunLifecycleReportResult{}, err
+	}
+	return domain.CopyRunLifecycleReportResult(domain.RunLifecycleReportResult{Accepted: true, RunEndpointID: report.RunEndpointID, ServerInstanceID: report.ServerInstanceID, ProjectedState: nextState, ServerTime: stamp}), nil
+}
+
+func lifecycleReportSummary(report domain.RunLifecycleReport, projectedState domain.ServerInstanceState, projected bool) string {
+	for _, candidate := range []string{report.ExecutionResult.AuditSummary, report.Progress.Message, report.Message, report.ErrorCode} {
+		if strings.TrimSpace(candidate) != "" {
+			return candidate
+		}
+	}
+	if projected {
+		return "run reported " + report.Capability + " " + string(report.State) + "; projected server state " + string(projectedState)
+	}
+	return "run reported " + report.Capability + " " + string(report.State)
+}
+
 func (svc *CoreService) projectRemoteAdapterJobResult(job domain.Job, stamp time.Time) error {
 	if !strings.HasPrefix(job.Capability, "remote.") || job.ServerInstanceID == "" || !isTerminalJobState(job.State) {
 		return nil