Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

CLI, REPL & TUI Testing

CLI One-Shot Commands

Help

cargo run -- --help

Expected: Shows usage, subcommands (session, forge, shell, brief, browser, finance, growth, distro, legal, support, infra, product, code, harvest, content, gtm), and flags (--mcp, --mcp-http, --tui).

Session Management

# Create a session
cargo run -- session create "test-project"

Expected: Prints session ID (UUID). Session is now active.

# List sessions
cargo run -- session list

Expected: Table showing session ID, name, kind, created_at. Should include “test-project”.

# Switch session
cargo run -- session switch <session-id>

Expected: Confirms switch to the specified session.

Forge / Mission

# Daily mission plan (requires Ollama)
cargo run -- forge mission today

Expected: AI-generated daily plan with prioritized tasks. Streams text to stdout. May take 5-30s depending on model.

# List goals
cargo run -- forge mission goals

Expected: Table of goals (may be empty on fresh install).

# Add a goal
cargo run -- forge mission goal add "Launch MVP" \
  --description "Ship v1 to production" --timeframe month

Expected: Prints goal ID. Goal appears in subsequent goals listing.

# Periodic review
cargo run -- forge mission review --period week

Expected: AI-generated weekly review (requires Ollama).

Executive Brief

cargo run -- brief

Expected: Generates an executive daily digest summarizing activity across departments.

Department Commands (Generic)

Every department supports status, list, and events:

# Status (repeat for each department)
cargo run -- finance status
cargo run -- growth status
cargo run -- code status
cargo run -- content status
cargo run -- harvest status
cargo run -- gtm status
cargo run -- product status
cargo run -- distro status
cargo run -- legal status
cargo run -- support status
cargo run -- infra status

Expected: Each prints a status summary. May show “No active items” on fresh install.

# List with kind filter
cargo run -- finance list --kind transactions
cargo run -- support list --kind tickets
cargo run -- legal list --kind contracts
cargo run -- growth list --kind funnel_stages
cargo run -- product list --kind features

Expected: Table of domain objects. Empty on fresh install, but no error.

# Events
cargo run -- finance events --limit 5

Expected: Recent events for that department. Empty on fresh install.

Engine-Specific Commands

# Code: analyze current directory
cargo run -- code analyze .

Expected: Prints analysis results (file count, complexity metrics, dependency info). Works without Ollama.

# Code: search symbols
cargo run -- code search "DepartmentApp"

Expected: BM25 search results showing matching symbols/definitions.

# Content: draft a topic (requires Ollama)
cargo run -- content draft "Why Rust is great for CLI tools"

Expected: AI-generated markdown draft. Streams to stdout.

# Harvest: pipeline stats
cargo run -- harvest pipeline

Expected: Pipeline stage counts (Cold, Contacted, Qualified, etc.). All zeros on fresh install.

Browser Commands

# Check browser status (no Chrome needed)
cargo run -- browser status

Expected: Shows “Not connected” or connection info.

# Connect to Chrome (requires Chrome with --remote-debugging-port=9222)
cargo run -- browser connect

Expected: Connects to Chrome DevTools Protocol endpoint.


Interactive REPL Shell

cargo run -- shell

Expected: Launches interactive prompt: rusvel>

REPL Commands

CommandExpected Behavior
helpLists all available commands
statusOverview across all departments
use financeSwitches context -> prompt becomes rusvel:finance>
status (in dept)Shows finance-specific status
list transactionsLists finance transactions
eventsShows finance events
backReturns to top-level rusvel>
use codeSwitches to code department
session listLists all sessions
session create fooCreates a new session
exit or Ctrl+DExits the REPL

REPL Features

FeatureHow to testExpected
Tab completionType us then press TabCompletes to use
Department completionType use then TabShows all 14 departments
HistoryType a command, exit, re-enter shellUp arrow recalls previous commands
History searchPress Ctrl+R, type partial commandFinds matching history entry

TUI Dashboard

cargo run -- --tui

Expected: Full-screen terminal dashboard with 4 panels.

TUI Panels

PanelContentExpected
Tasks (top-left)Active tasks with priority markersShows tasks or “No active tasks”
Goals (top-right)Goals with progress barsShows goals or “No goals”
Pipeline (bottom-left)Opportunity counts by stageShows stages with counts
Events (bottom-right)Recent system eventsShows recent events or empty

TUI Keybindings

KeyExpected
q or EscExits TUI cleanly, returns to terminal
tToggles terminal pane focus
Arrow keys (in terminal mode)Navigate between terminal panes

TUI Verification

  • No crash on empty data – Fresh install should render all panels without panic
  • Resize handling – Resize terminal window; panels should reflow
  • Clean exit – Terminal should restore to normal state after q