clawdie-iso/doc/CANONICAL-BUILD-PATHS-HANDOFF.md

2 KiB

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:

/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

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.)