# Turn Report: Docker frozen-lockfile build fix

Date/Time: 2026-05-15 18:53:46 EDT

## Summary

Docker build failures were caused by an out-of-sync deployment workspace snapshot at `deployment/docker/workspace-root/`. I refreshed the snapshot files so Docker builds use current manifest and lock data for `bun install --frozen-lockfile`.

## Changes Made

- Created and claimed Beads issue `islandflow-xll`.
- Ran `bun run sync:docker-workspace`.
- Updated:
  - `deployment/docker/workspace-root/package.json`
  - `deployment/docker/workspace-root/bun.lock`
- Added this turn report in `docs/turns/`.

## Context

The deployment compose stack uses additional build context named `workspace`, pointing to `deployment/docker/workspace-root`. Dockerfiles copy root files from that snapshot instead of directly from repository root. If snapshot files are stale, frozen lockfile installs fail in container builds.

## Important Implementation Details

- Pre-sync check failed with snapshot drift and missing workspace entries in deployment lock data.
- Post-sync check passed and reported the deployment snapshot is in sync.
- This directly addresses the server-side error where frozen lockfile install detected changes.

## Validation

- Passed: `bun run check:docker-workspace` (after sync).
- Passed: `bun install --frozen-lockfile` at repo root.
- Could not run: `docker compose -f deployment/docker/docker-compose.yml build candles web` because local Docker daemon was unavailable.

    Cannot connect to the Docker daemon at unix:///Users/kell/.orbstack/run/docker.sock. Is the docker daemon running?

## Issues, Limitations, and Mitigations

- Limitation: Full container build validation was not possible in this environment.
- Mitigation: Updated the exact snapshot files Docker consumes and verified snapshot consistency with the project check script.

## Follow-up Work

- On the deployment host, pull and rebuild target images:

    cd /home/delta/islandflow
    git pull --ff-only
    docker compose -f deployment/docker/docker-compose.yml build candles web ingest-equities

- If this recurs after dependency changes, run and commit:

    bun run sync:docker-workspace
    bun run check:docker-workspace

- Tracking issue: `islandflow-xll`.