clawdie/clawdie-iso
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
clawdie-iso/ROADMAP-v1.0.0.md
Sam & Claude 1000f28245 docs: v1.0.0 release roadmap (Sam & Claude) 
Define testing requirements and release criteria for v1.0.0:
- VM testing (bhyve): Full wizard flow + progress tracking
- Hardware testing: Optional, Intel/AMD/NVIDIA (post-release OK)
- Release prep: Version bump, release notes, git tags

Success criteria: All 6 automation tests pass (compilation, shell syntax,
ISO build, git status, test report). Awaiting VM testing.

Estimated time to release: 2-4 hours (testing + prep)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-04 20:04:22 +02:00

6.7 KiB
Raw Blame History

Roadmap: v1.0.0 Release

Status: Ready for release candidate testing
Current Version: v0.9.0 (6 Apr 2026)
Target Release: v1.0.0

What's Shipping in v1.0.0

✅ Completed (6 Apr 2026)

Phase 1: Qt6 Proof of Concept

  • Qt6 toolchain verification on FreeBSD
  • Hello World GUI (Qt widgets)
  • Build system (qmake6)
  • Commit: da32367

Phase 2: QML GUI Foundation

  • 8-page responsive UI (StackView navigation)
  • QML frontend (800x700 window, dark header)
  • C++ backend (GPUDetector class, mock detection)
  • Database model structure
  • Commit: e57e52e

Phase 3: Real Hardware Integration

  • Real GPU detection (pciconf -lv integration)
  • GPU vendor mapping (Intel/AMD/NVIDIA/VMware)
  • Disk enumeration (DiskModel from camcontrol)
  • User form validation (password confirmation, license gate)
  • Progress tracking infrastructure (ProgressTracker)
  • Commit: b259a48

Phase 4: Shell Integration

  • Config file writer (/tmp/clawdie-install.conf)
  • Shell sourcing in firstboot.sh (skip text wizard when GUI config exists)
  • Package selection flags (desktop, devtools, nvidia, llm)
  • Path detection (ISO vs dev environments)
  • Progress file format alignment (PROGRESS=1-8)
  • Sudo privilege wrapper
  • Commit: 51e101b, 4c670fe

Full ISO Build

  • All 7 stages successful
  • 50 GB bootable image created
  • All components bundled and integrated
  • Commit: bfb4d4c

Before v1.0.0 Release

Testing (1-2 days)

  • VM Testing (bhyve)

    • Boot ISO in bhyve VM (2GB RAM, 50GB disk)
    • Walk through full QML wizard (all 8 pages)
    • Verify disk detection, user creation, GPU selection
    • Verify progress bar updates as installation runs
    • Check firstboot.sh completes successfully
    • Verify SSH/Tailscale connectivity

  • Hardware Testing (if available)

    • Boot ISO on physical Intel hardware
    • Boot ISO on physical AMD hardware
    • Verify GPU detection accuracy on real hardware
    • Test NVIDIA driver selection (if NVIDIA GPU present)
    • Verify Lumina desktop boots correctly

  • Regression Testing

    • Test bsdinstall interaction (QML runs after)
    • Test VPS path (headless, no desktop)
    • Test resume/recovery if installation interrupts
    • Test with/without Tailscale auth key

Release Preparation

  • Version Bumps

    • Update clawdie-iso/build.cfg: CLAWDIE_VERSION="1.0.0"
    • Update clawdie-ai/package.json: "version": "1.0.0"
    • Update both README.md with v1.0.0 feature list

  • Release Notes (clawdie-iso/RELEASE-NOTES-v1.0.0.md)

    • Headline: "v1.0.0 — QML Installer Complete"
    • Breaking changes: Mandatory Tailscale, GUI replaces text wizard
    • New features: Phase 1-4 QML installer, real hardware detection, offline install
    • Known issues: Some packages missing from repo, X11 + Wayland hybrid
    • Installation: How to boot ISO, how to use QML wizard
    • Support: Link to issues, roadmap for v1.1.0

  • Git Tags

    git tag -a v1.0.0 -m "v1.0.0 Release: QML Installer Complete (Phase 1-4)"
git push origin v1.0.0

  • Codeberg Releases

    • Create release on Codeberg with tag v1.0.0
    • Upload ISO: clawdie-iso-unified-06.apr.2026.img
    • Attach release notes and checksums

Success Criteria for v1.0.0

Criterion Status Notes
Phase 1 GUI compilation ✅ Qt6 PoC works
Phase 2 QML rendering ✅ 8-page wizard, responsive
Phase 3 hardware detection ✅ GPU/disk real-time detection
Phase 4 shell integration ✅ Config file + firstboot.sh sourcing
All blockers fixed ✅ Path detection + progress + sudo
Full ISO build ✅ 50GB, all stages passed
Compilation clean ✅ No errors, 2 pre-existing warnings
Git validation ✅ Shell syntax valid (sh -n)
Test report ✅ PHASE4-TEST-REPORT-06.APR.2026.md
VM Testing ⏳ Pending
Hardware Testing ⏳ Pending (optional)
Release Prep ⏳ Pending

Known Issues / Limitations

For v1.0.0 (Acceptable)

  1. Some packages unavailable in FreeBSD repo (grafana10, hal, lumina-filemanager)
    • Workaround: Install from source during system setup
  2. X11 + Wayland hybrid (not pure Wayland desktop)
    • Reason: Lumina doesn't support pure Wayland yet
  3. Interactive baremetal wizard (no cloud-init pre-baking)
    • Reason: User customization required; cloud pre-bake for v1.1.0

Deferred to Phase 5 (v1.1.0+)

  1. Error recovery UI (retry failed steps)
  2. Full log viewer in QML
  3. Replace bsdinstall entirely
  4. Hardware compatibility matrix
  5. Wayland desktop support (wait for Lumina or switch DE)

Commits in v1.0.0 Release

Phases 1-4 (6 Apr 2026):

bfb4d4c docs: Phase 4 completion — test report + v0.9.0 status update
4c670fe fix: Phase 4 blockers — path detection + progress tracking
51e101b feat: Phase 4 shell integration - GUI config writer and firstboot.sh sourcing
b259a48 feat: Complete Phase 3 QML installer — 8-page wizard
e57e52e feat: Phase 2 QML GUI prototype with GPU detection backend
da32367 feat: Phase 1 Qt6 GUI proof of concept

Related infrastructure:

3d6f996 bump: align version to 0.9.0 + add build test report
84cc452 docs: complete Codex's public/internal restructure alignment
514949e docs: standardize subnet to 10.0.0 + fix stale references
3b28e9d docs: align install steps with default-on jails

Timeline

Date Milestone Status
6 Apr Phase 1-4 complete, blockers fixed, ISO build verified ✅
7-8 Apr VM testing (bhyve) ⏳
8 Apr Hardware testing (if available) ⏳
8 Apr Release preparation (version bump, notes, tags) ⏳
8 Apr v1.0.0 released ⏳

FAQ

Q: Can we ship v1.0.0 without hardware testing?
A: Yes. VM testing is sufficient for release. Hardware testing is recommended post-release for v1.0.1 patch.

Q: What if phase 4 blockers reappear during testing?
A: We have fix commits ready (4c670fe). Will revert and re-apply if needed.

Q: Is the GUI installer required for installation?
A: No. Text wizard still works (shell-sourced modules). GUI is optional improvement.

Q: What about the other agent's work (v0.9.0 release prep)?
A: Check with them. If complete, sync version numbers across all repos (clawdie-ai, clawdie-iso, clawdie-shell, clawdie-pi).

Next Session

  1. Run VM test (bhyve boot, full wizard flow)
  2. Verify progress bar updates during install
  3. Confirm all 8 steps complete successfully
  4. If VM test passes:
    • Bump versions to 1.0.0
    • Write release notes
    • Tag both repos
    • Publish release

Estimated time for release: 2-4 hours (testing + prep)

Document Version: 1.0
Last Updated: 6 Apr 2026 17:20
Owner: Sam + Claude