various cli updates

Signed-off-by: Yujong Lee <yujonglee.dev@gmail.com>

Author: yujonglee

AGENTS.md

@@ -31,6 +31,27 @@ TinyBase as the primary data store (schema at `packages/store/src/tinybase.ts`),
 - Use `cn` from `@hypr/utils` for conditional classNames. Always pass an array, split by logical grouping.
 - Use `motion/react` instead of `framer-motion`.
 
+## CLI TUI Command Architecture
+
+Each TUI command in `apps/cli/src/commands/` follows this layout:
+
+```
+commands/<name>/
+  mod.rs        -- Screen impl, Args, run()          [glue]
+  app.rs        -- App, dispatch(Action)->Vec<Effect> [pure state machine]
+  action.rs     -- Action enum                        [input events]
+  effect.rs     -- Effect enum                        [output commands]
+  runtime.rs    -- Runtime, RuntimeEvent              [async I/O]
+  ui.rs         -- draw(frame, app)                   [rendering]
+```
+
+Naming rules:
+- Types drop the command prefix: `App`, `Action`, `Effect`, `Runtime`, `RuntimeEvent`
+- `app.rs` → `app/mod.rs` with private submodules when state is complex
+- `ui.rs` → `ui/mod.rs` with sub-files when rendering is complex
+- `action.rs`/`effect.rs` are siblings of `mod.rs`, never nested inside `app/`
+- `app.rs` contains no rendering logic, no API calls, no async code
+
 ## Misc
 
 - Do not create summary docs or example code files unless requested.

Cargo.lock

@@ -63,6 +63,7 @@ hypr-cactus = { path = "crates/cactus", package = "cactus" }
 hypr-cactus-model = { path = "crates/cactus-model", package = "cactus-model" }
 hypr-calendar-interface = { path = "crates/calendar-interface", package = "calendar-interface" }
 hypr-chatwoot = { path = "crates/chatwoot", package = "chatwoot" }
+hypr-cli-tui = { path = "crates/cli-tui", package = "cli-tui" }
 hypr-data = { path = "crates/data", package = "data" }
 hypr-db-core = { path = "crates/db-core", package = "db-core" }
 hypr-db-parser = { path = "crates/db-parser", package = "db-parser" }

Cargo.toml

@@ -15,7 +15,9 @@ path = "src/main.rs"
 hypr-api-env = { workspace = true }
 hypr-audio = { workspace = true }
 hypr-audio-actual = { workspace = true }
+hypr-audio-mock = { workspace = true, optional = true }
 hypr-audio-utils = { workspace = true }
+hypr-cli-tui = { workspace = true }
 hypr-file = { workspace = true }
 hypr-fs-sync-core = { workspace = true }
 hypr-language = { workspace = true }
@@ -61,3 +63,6 @@ tokio = { workspace = true, features = ["rt-multi-thread", "macros", "signal", "
 tokio-stream = { workspace = true }
 url = { workspace = true }
 uuid = { workspace = true, features = ["v4"] }
+
+[features]
+mock-audio = ["dep:hypr-audio-mock"]

apps/cli/Cargo.toml

@@ -4,7 +4,7 @@ const AUTH_URL: &str = "https://char.com/auth";
 
 pub fn run() -> CliResult<()> {
     if let Err(e) = open::that(AUTH_URL) {
-        return Err(CliError::external_action_failed(
+        return Err(CliError::operation_failed(
             "open auth page",
             format!("{e}\nPlease visit: {AUTH_URL}"),
         ));