Sam & Claude
c47cd44251
Codifies the markdown format Sam applied in bd94b87 / 30cf590 as a project rule rather than per-file judgment. Prettier 3 defaults with proseWrap=preserve (no prose reflow), printWidth=80, embedded code formatting off so we don't touch fenced shell/JSON blocks. .prettierignore scopes Prettier to active docs: - excludes tmp/, cache/, node_modules/, build artifacts - excludes CHANGELOG.md + RELEASE-NOTES-*.md (hand-formatted, rigid) - excludes .archive/ and .opencode/ (historical / tooling internal) - excludes bundled bootstrap.html Reformatted 16 active .md files: padded markdown tables, blank line before lists (CommonMark-strict), `*emph*` -> `_emph_`. No content changes — diffs are all whitespace/alignment/emphasis style. Verified: `npx prettier@3 --check '**/*.md'` reports all clean. Build: not run — docs + tooling config only. Tests: pass — prettier --check is green; git diff confirms no content deletions, only formatting. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
222 lines
7.4 KiB
Markdown
222 lines
7.4 KiB
Markdown
# Roadmap: v1.0.0 Release
|
|
|
|
> Historical roadmap. This reflects the earlier QML-installer / Lumina plan
|
|
> and is not the current operator-USB direction.
|
|
|
|
**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
|