clawdie-iso/CHANGELOG.md

4.8 KiB

Clawdie Changelog

All notable changes to Clawdie-ISO are documented here.


[Unreleased]

Nothing yet.


[0.10.0] — 2026-06-15

Codename: Operator Image

First numbered milestone since the architecture settled on zot (agent) + Colibri (control plane). Not production, but a real, flashable operator image: the XFCE live experience is stable and the Colibri service bugs are fixed, so the image is meant to work out of the box. Work continues from here toward 1.0.0.

Versioning

  • The ISO now carries its own product version and no longer borrows zot's number. ISO_VERSION is explicit (set in build.cfg); auto/zot-tracking is gone and a build with no version fails fast. Component versions (zot, colibri, clawdie-ai, clawdie-iso) are recorded as provenance in build-manifest.json.
  • build-manifest.json now records colibri_commit/colibri_modified — the image stages adjacent colibri binaries, so the commit that produced them is captured for reproducibility.

Added

  • colibri-live-rebuild helper staged at /usr/local/bin (with the Colibri service): one command to rebuild + redeploy Colibri from source on a booted USB (clone/build/stop/install/restart/validate/record). See docs/LIVE-COLIBRI-REBUILD.md.
  • Image-size headroom guard: the build reports df/du on the mounted live filesystem and fails before shipping if free space is under a floor (IMAGE_MIN_FREE_MB, default 1024) — catches a 32 GB-stick overflow at build time, not on the stick.
  • Live rebuild lane now covers the whole agent stack: go added to the live-operator package list and the zot source seeded at /home/clawdie/ai/zot, so a booted USB can rebuild zot (Go) as well as Colibri (Rust). See docs/LIVE-COLIBRI-REBUILD.md.
  • Aider+Pi harness venv provisioning — firstboot/shell-deploy.sh now creates /opt/clawdie/venv/aider with pinned deps: aider-chat==0.86.2, litellm==1.81.10, tree_sitter==0.20.4
  • Aider availability check in post-install verification (logs aider version at end of deployment)

Fixed

  • Colibri daemon now handles SIGTERM (graceful socket cleanup + agent reaping on service stop), refuses to steal a live socket, and fails closed if it cannot bind a control socket (colibri PR #75).

Improvements

  • Updated firstboot completion messages to highlight Aider and Pi as primary harnesses (Codex listed as optional alternative)

[0.9.0] — 2026-04-06

Codename: Unified Architecture

Breaking Changes

  • ✂️ Unified ISO: Single ./build.sh builds for all targets (VPS, baremetal, cloud)
  • ✂️ Removed --target and --gpu-driver flags (runtime detection now handles this)
  • ✂️ Dropped doas/sudo from the live image — privileged operations use FreeBSD mac_do/mdo
  • ✂️ clawdie-shell repo archived (merged into clawdie-iso)

New Features

  • 🎯 Runtime GPU detection (Intel, AMD, NVIDIA 390/470/590)
  • 🎯 Runtime display detection (VPS headless, baremetal with desktop session)
  • 🎯 PF firewall with glasspane VNC (secure remote browser access)
  • 🎯 Tailscale integration (mandatory, with optional opt-out)
  • 🎯 12 shell modules for modular firstboot orchestration

Improvements

  • 📈 Comprehensive REQUIREMENTS.md (pre-install checklist)
  • 📈 NETWORKING.md with architecture diagrams
  • 📈 SHELL-MODULES.md with all 8 module specifications
  • 📈 BUILD.md with detailed build process
  • 📈 Integration tests for full module flow validation
  • 📈 Preflight validation scripts

Deprecations

  • ⚠️ PLAN-UNIFY.md (archived — planning complete)
  • ⚠️ IMPLEMENTATION-PLAN.md (archived — implementation merged)
  • ⚠️ clawdie-shell repo (archived — use clawdie-iso main)

Performance

  • ISO size: 50 GB (includes all packages for offline installation)
  • Build time: ~13 minutes (with package cache)
  • GPU support: 3 NVIDIA versions + AMD + Intel firmware (all bundled)

Repository Status

The agent stack is zot (Go agent) + Colibri (Rust control plane); "Clawdie" is the product name for the two together. The image carries its own product version; component versions are recorded as provenance in build-manifest.json.

Repo Status Version source
zot Active — the agent (front door) pinned tag (ZOT_VERSION)
colibri Active — control plane + installer workspace Cargo.toml
clawdie-iso Active — image builder product version (ISO_VERSION)
clawdie-ai Being pruned (features → zot/Colibri)
pi Demoted — spawnable backend, not default upstream npm
clawdie-shell Archived (merged into clawdie-iso)