# Canonical build paths handoff

**From:** Pi ISO Developer

**To:** Codex ISO Builder / Hermes USB-IMG Deployer

**Status:** open until the next image is rebuilt from `/home/clawdie/ai` paths

## Decision

Use `/home/clawdie/ai` as the build-host source root across systems. Do not rely on
adjacent checkout fallbacks such as `../colibri` or `../clawdie-ai`.

Canonical checkouts:

```text
/home/clawdie/ai/clawdie-iso
/home/clawdie/ai/colibri
/home/clawdie/ai/clawdie-ai
```

Runtime/live-user paths such as `/home/clawdie/clawdie-ai` are separate and are
not part of this build-host source-root change.

## Task checklist

- [ ] Create `/home/clawdie/ai` on each build/validation host, owned by the operator user.
- [ ] Move or reclone the three source repos into the canonical paths above.
- [ ] Refresh each repo from Forgejo `origin/main` before building.
- [ ] Build Colibri release artifacts from `/home/clawdie/ai/colibri`.
- [ ] Build the ISO from `/home/clawdie/ai/clawdie-iso`.
- [ ] Confirm the build log no longer reports skipped `clawdie-ai` or `colibri`
      source snapshots.

## Rebuild command

```sh
cd /home/clawdie/ai/colibri
git fetch origin --prune
git checkout main
git pull --ff-only
cargo build --workspace --release

cd /home/clawdie/ai/clawdie-iso
git fetch origin --prune
git checkout main
git pull --ff-only
sudo env NVIDIA_UNIVERSAL=YES \
  FEATURE_CLAWDIE=YES CLAWDIE_ENABLE=NO COLIBRI_DAEMON_ENABLE=NO \
  CLAWDIE_AI_REPO=/home/clawdie/ai/clawdie-ai \
  COLIBRI_REPO=/home/clawdie/ai/colibri \
  CLAWDIE_ARTIFACT_DIR=/home/clawdie/ai/colibri/target/release \
  ./build.sh --skip-memstick-fetch --live-default-password
```

## Deletion criteria

Delete this handoff after one rebuilt image confirms all three source snapshots
are present under `/home/clawdie/ai` in the live image and the build log contains
no source-snapshot skips for `clawdie-ai` or `colibri`.

## Results

_(Codex/Hermes: paste build host, commit SHAs, source-snapshot log lines, and
mounted-image source snapshot paths here.)_