Files
vibebox/docs/tasks.md
Finn Sheng 23726d7420 Refactor (#10)
* refactor: cleanup duplicated logic

* refactor: cleanup config.rs

* refactor: cleanup explain.rs

* refactor: cleanup instance.rs

* refactor: cleanup

* refactor: use UnixStream instead of status file

* Refactor vm lifetime (#8)

* fix: handle vm supervisor being killed

* fix: fixed the loop connection retry

* refactor: extracted vm_manager liveness check logic

* Script failure report (#9)

* feat: added script failure report

* feat: vm error report can also report ssh.sh

* refactor: liveness check when connecting to ssh

* fix: fixed the wrong InstanceError::VMError

* fix: fixed the is_lock_stable
2026-02-15 18:09:38 -05:00

72 lines
3.1 KiB
Markdown

# Tasks
## SessionManager
1. [x] Confirm requirements and scope from `implementations.md`.
2. [x] Define `SessionManager` responsibilities and public API (create, load, list, update, delete, bump last_active,
refcount handling, cleanup orphaned index entries).
3. [x] Choose 3rd-party crates for UUIDv7, TOML persistence, and error handling (e.g., `uuid` with v7, `serde` + `toml`,
`thiserror`).
4. [x] Write user journeys and unit test cases first (happy paths + error paths) for session lifecycle and index
persistence.
5. [x] Implement `SessionManager` and supporting types with `Result`-based errors, filesystem IO, and atomic writes.
6. [x] Add tests for edge cases (missing index, invalid TOML, duplicate sessions, refcount transitions, cleanup on
missing instance dir).
7. [ ] Run tests and coverage; target >=80% line/branch coverage using a Rust coverage tool (e.g., `cargo llvm-cov`).
8. [x] Refactor for clarity and reliability while keeping tests green.
## TUI
1. [x] Review `docs/tui.md` requirements and translate into concrete UI sections and state model.
2. [x] Add required dependencies for ratatui/crossterm/tokio/color-eyre/futures and pick a text input widget crate.
3. [x] Write unit tests for layout calculations (header/terminal/input/status/completions), completion state
transitions, and CLI argument parsing.
4. [x] Implement TUI state model (header info, terminal history, input area, completion list, status bar visibility).
5. [x] Implement rendering functions for header, terminal area, input area, completions, and status bar.
6. [x] Implement async event loop (keyboard, resize, tick) with crossterm EventStream + tokio.
7. [x] Add a standalone TUI CLI binary (no main.rs wiring) with placeholder VM info and TODOs for VM integration.
8. [x] Run tests and validate coverage for the new module.
## TUI
1. [x] Fix the terminal component height issue.
2. [x] Fix the input field that does not expand its height (currently, it just roll the text horizontally). The
inputfield it should not be scrollable.
## Stage 1
1. [x] Wire up the vm and tui.
2. [x] Use ssh to connect to vm.
3. [x] allow multi vibebox to connect to the same vm.
4. [x] use vm.lock to ensure process concurrency safety.
5. [x] wire up SessionManager.
6. [x] VM should be separated by a per-session VM daemon process (only accepts if to shut down vm and itself).
7. [x] setup vibebox commands
8. [x] setup cli commands.
1. [x] Organize all the params.
2. [x] Remove old cli.
3. [x] add an actual config file.
4. [x] set up the cli.
9. [x] fix ui overlap, and consistency issue.
10. [x] `purge-cache` to clear the cache.
11. [x] intensive integration test.
## Publish
1. [x] write the docs.
2. [x] setup quick install link.
3. [x] setup website.
## Stage 2
1. [ ] retouch the cli ux.
2. [x] refactor the code.
3. [ ] refactor the mount system.
4. [x] refactor the vm process lifetime.
5. [x] Redirect vm output to log.
6. [x] Redirect vm output to vibebox starting it.
7. [x] use anyhow to sync api.
8. [ ] add support for ipv6.
9. [x] use UnixStream instead of status file
10. [x] liveness check should also happen when waiting for ssh port