vibebox/docs/tasks.md

Tasks

SessionManager

1. Confirm requirements and scope from implementations.md.
2. Define SessionManager responsibilities and public API (create, load, list, update, delete, bump last_active, refcount handling, cleanup orphaned index entries).
3. Choose 3rd-party crates for UUIDv7, TOML persistence, and error handling (e.g., uuid with v7, serde + toml, thiserror).
4. Write user journeys and unit test cases first (happy paths + error paths) for session lifecycle and index persistence.
5. Implement SessionManager and supporting types with Result-based errors, filesystem IO, and atomic writes.
6. 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. Refactor for clarity and reliability while keeping tests green.

TUI

1. Review docs/tui.md requirements and translate into concrete UI sections and state model.
2. Add required dependencies for ratatui/crossterm/tokio/color-eyre/futures and pick a text input widget crate.
3. Write unit tests for layout calculations (header/terminal/input/status/completions), completion state transitions, and CLI argument parsing.
4. Implement TUI state model (header info, terminal history, input area, completion list, status bar visibility).
5. Implement rendering functions for header, terminal area, input area, completions, and status bar.
6. Implement async event loop (keyboard, resize, tick) with crossterm EventStream + tokio.
7. Add a standalone TUI CLI binary (no main.rs wiring) with placeholder VM info and TODOs for VM integration.
8. Run tests and validate coverage for the new module.

TUI

1. Fix the terminal component height issue.
2. 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. Wire up the vm and tui.
2. Use ssh to connect to vm.
3. allow multi vibebox to connect to the same vm.
4. use vm.lock to ensure process concurrency safety.
5. wire up SessionManager.
6. VM should be separated by a per-session VM daemon process (only accepts if to shut down vm and itself).
7. setup vibebox commands
8. setup cli commands.
   1. Organize all the params.
   2. Remove old cli.
   3. add an actual config file.
   4. set up the cli.
9. fix ui overlap, and consistency issue.
10. purge-cache to clear the cache.
11. intensive integration test.

Publish

1. write the docs.
2. setup quick install link.
3. setup website.

Stage 2

1. retouch the cli ux.
2. refactor the code.
3. refactor the mount system.
4. refactor the vm process lifetime.
5. Redirect vm output to log.
6. Redirect vm output to vibebox starting it.
7. use anyhow to sync api.
8. add support for ipv6.
9. use UnixStream instead of status file
10. liveness check should also happen when waiting for ssh port