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>
This commit is contained in:
123kupola
parent
f3faef067f
commit
1000f28245
1 changed files with 209 additions and 0 deletions
209
ROADMAP-v1.0.0.md
Normal file
209
ROADMAP-v1.0.0.md
Normal file
|
|
@ -0,0 +1,209 @@
|
|||
# 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**
|
||||
```bash
|
||||
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
|
||||
Loading…
Add table
Reference in a new issue