feat(build): implement build synchronization and Docker context management

ROADMAP.md

@@ -126,10 +126,10 @@ Be a **valid** Docker Desktop replacement for local development: same CLI (`dock
 - [x] Basic metrics (CPU, RAM, network per container)
 - [x] Volumes list, detail, file browser, clone, and remove
 - [x] Image layers, run, and push actions
-- [x] Builds list (history from daemon)
+- [x] Builds list (history persisted to disk)
 - [x] Docker Hub registry login (device flow)
 - [ ] Network management UI
-- [ ] Build detail view UI
+- [x] Build detail view UI
 
 **Exit criteria:** 3 reference stacks (LAMP, Node+Postgres, Laravel Sail) start with `docker compose up -d` without modifications.
 

backend/cmd/calf/main.go

@@ -56,6 +56,9 @@ func run() int {
 		}
 	}()
 
+	go server.StartBuildSync(rtCtx)
+	go server.StartDockerContextManager(rtCtx)
+
 	errCh := make(chan error, 1)
 	go func() {
 		errCh <- server.Run()

backend/internal/api/build_sync.go

@@ -0,0 +1,232 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"time"
+
+	"github.com/enegalan/calf/backend/internal/buildhistory"
+	"github.com/enegalan/calf/backend/internal/runtime"
+)
+
+const buildSyncInterval = 30 * time.Second
+
+func (s *Server) StartBuildSync(ctx context.Context) {
+	interval := buildSyncInterval
+	if s.cfg.PollIntervalMs > 0 {
+		interval = time.Duration(s.cfg.PollIntervalMs) * time.Millisecond
+	}
+
+	ticker := time.NewTicker(interval)
+	defer ticker.Stop()
+
+	s.syncBuildHistory(ctx)
+
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-ticker.C:
+			s.syncBuildHistory(ctx)
+		}
+	}
+}
+
+func (s *Server) syncBuildHistory(ctx context.Context) {
+	socket := s.runtime.DockerSocket()
+	if socket == "" {
+		return
+	}
+
+	if _, err := os.Stat(socket); err != nil {
+		return
+	}
+
+	status, err := s.runtime.Status(ctx)
+	if err != nil || status.State != runtime.StateRunning {
+		return
+	}
+
+	rows, err := buildhistory.List(ctx, socket)
+	if err != nil {
+		s.logger.Debug("build history sync skipped", "error", err)
+		return
+	}
+
+	if len(rows) == 0 {
+		return
+	}
+
+	s.buildsMu.Lock()
+	defer s.buildsMu.Unlock()
+
+	known := make(map[string]struct{}, len(s.builds))
+	for _, build := range s.builds {
+		if build.HistoryRef != "" {
+			known[build.HistoryRef] = struct{}{}
+		}
+	}
+
+	byHistoryID := buildhistory.RowByHistoryID(rows)
+	changed := s.updateSyncedBuilds(ctx, socket, byHistoryID)
+
+	imported := buildhistory.MergeRows(known, rows)
+	for _, row := range imported {
+		s.builds = append([]runtime.Build{s.buildFromHistoryRow(ctx, socket, row)}, s.builds...)
+		changed = true
+	}
+
+	if changed {
+		_ = s.persistBuildsLocked()
+	}
+}
+
+func (s *Server) updateSyncedBuilds(ctx context.Context, socket string, rows map[string]buildhistory.Row) bool {
+	changed := false
+
+	for index, build := range s.builds {
+		if build.HistoryRef == "" {
+			continue
+		}
+
+		row, ok := rows[build.HistoryRef]
+		if !ok {
+			continue
+		}
+
+		updated := s.enrichHistoryBuild(ctx, socket, applyHistoryRow(build, row))
+		if buildsEqual(updated, build) {
+			continue
+		}
+
+		s.builds[index] = updated
+		changed = true
+	}
+
+	return changed
+}
+
+func buildsEqual(left, right runtime.Build) bool {
+	return left.Tag == right.Tag &&
+		left.Status == right.Status &&
+		left.CreatedAt == right.CreatedAt &&
+		left.FinishedAt == right.FinishedAt &&
+		left.DurationMs == right.DurationMs &&
+		left.CachedSteps == right.CachedSteps &&
+		left.TotalSteps == right.TotalSteps &&
+		left.Context == right.Context &&
+		left.Dockerfile == right.Dockerfile &&
+		len(left.Steps) == len(right.Steps) &&
+		len(left.RawLog) == len(right.RawLog) &&
+		len(left.Dependencies) == len(right.Dependencies) &&
+		len(left.Results) == len(right.Results) &&
+		len(left.Tags) == len(right.Tags) &&
+		timingEqual(left.Timing, right.Timing)
+}
+
+func timingEqual(left, right runtime.BuildTiming) bool {
+	return left.ImagePullsMs == right.ImagePullsMs &&
+		left.LocalTransfersMs == right.LocalTransfersMs &&
+		left.ExecutionsMs == right.ExecutionsMs &&
+		left.FileOperationsMs == right.FileOperationsMs &&
+		left.ResultExportsMs == right.ResultExportsMs &&
+		left.IdleMs == right.IdleMs
+}
+
+func (s *Server) enrichHistoryBuild(ctx context.Context, socket string, build runtime.Build) runtime.Build {
+	if build.HistoryRef == "" {
+		return build
+	}
+
+	if !runtime.IsResolvableBuildContext(build.Context) {
+		detail, err := buildhistory.Inspect(ctx, socket, build.HistoryRef)
+		if err == nil {
+			build.Context = detail.Context
+			if detail.Dockerfile != "" {
+				build.Dockerfile = runtime.NormalizeDockerfilePath(detail.Context, detail.Dockerfile)
+			}
+
+			if revision, remote := runtime.CollectGitMetadata(build.Context); revision != "" || remote != "" {
+				build.SourceRevision = revision
+				build.RemoteSource = remote
+			}
+		}
+	}
+
+	if isTerminalBuildStatus(build.Status) && build.RawLog == "" && len(build.Steps) == 0 {
+		logs, err := buildhistory.Logs(ctx, socket, build.HistoryRef)
+		if err == nil {
+			runtime.ApplyBuildLogs(&build, logs)
+		}
+	}
+
+	runtime.EnrichSyncedBuild(ctx, socket, &build)
+
+	if artifacts, err := buildhistory.BuildArtifacts(ctx, socket, build.HistoryRef, build.Platform); err == nil && len(artifacts) > 0 {
+		build.Results = artifacts
+	}
+
+	return build
+}
+
+func isTerminalBuildStatus(status string) bool {
+	switch status {
+	case "success", "failed":
+		return true
+	default:
+		return false
+	}
+}
+
+func (s *Server) buildFromHistoryRow(ctx context.Context, socket string, row buildhistory.Row) runtime.Build {
+	createdAt := row.BuildCreatedAt()
+	if createdAt == "" {
+		createdAt = time.Now().UTC().Format(time.RFC3339)
+	}
+
+	s.buildSeq++
+	build := runtime.Build{
+		ID:           fmt.Sprintf("history-%d", s.buildSeq),
+		HistoryRef:   row.HistoryID(),
+		Tag:          buildhistory.NormalizeTag(row.BuildName()),
+		Context:      "",
+		Dockerfile:   "Dockerfile",
+		Platform:     defaultBuildPlatform(),
+		Status:       buildhistory.NormalizeStatus(row.BuildStatus()),
+		CreatedAt:    createdAt,
+		FinishedAt:   row.CompletedAt,
+		DurationMs:   row.BuildDurationMs(),
+		Builder:      "default",
+		CachedSteps:  row.CachedSteps,
+		TotalSteps:   row.TotalSteps,
+		Steps:        []runtime.BuildStep{},
+		Dependencies: []runtime.BuildDependency{},
+		Results:      []runtime.BuildArtifact{},
+		Tags:         []runtime.BuildTag{},
+	}
+
+	return s.enrichHistoryBuild(ctx, socket, build)
+}
+
+func applyHistoryRow(build runtime.Build, row buildhistory.Row) runtime.Build {
+	updated := build
+	updated.Tag = buildhistory.NormalizeTag(row.BuildName())
+	updated.Status = buildhistory.NormalizeStatus(row.BuildStatus())
+	if createdAt := row.BuildCreatedAt(); createdAt != "" {
+		updated.CreatedAt = createdAt
+	}
+	if row.CompletedAt != "" {
+		updated.FinishedAt = row.CompletedAt
+	}
+	if durationMs := row.BuildDurationMs(); durationMs > 0 {
+		updated.DurationMs = durationMs
+	}
+	if row.CachedSteps > 0 {
+		updated.CachedSteps = row.CachedSteps
+	}
+	if row.TotalSteps > 0 {
+		updated.TotalSteps = row.TotalSteps
+	}
+	return updated
+}