Struct MockRuntime 

pub struct MockRuntime {
    pub sessions: Vec<SessionSnapshot>,
    pub gate_mode: Mutex<Option<BrainGateMode>>,
    pub decisions: Vec<DecisionSummary>,
    pub review_queue: Vec<ReviewItemSummary>,
    pub leases: Vec<LeaseSummary>,
    pub handoffs: Vec<HandoffSummary>,
    pub interrupts: Vec<InterruptSummary>,
    pub agents: Vec<AgentDirectoryEntry>,
    pub roles: Vec<RoleBinding>,
    pub actions_log: Mutex<Vec<MockAction>>,
}

In-memory runtime backed by Vecs and interior-mutable counters. Used by tests in this crate to verify the trait shapes compile and roundtrip cleanly, and by the future claudectl-tui crate’s tests to render the TUI against fixtures without dragging in brain / coord / bus.

Actions impls record their calls in actions_log so tests can assert “the TUI invoked the right side-effect” without spying on real I/O.

Fields

sessions: Vec<SessionSnapshot>

gate_mode: Mutex<Option<BrainGateMode>>

decisions: Vec<DecisionSummary>

review_queue: Vec<ReviewItemSummary>

leases: Vec<LeaseSummary>

handoffs: Vec<HandoffSummary>

interrupts: Vec<InterruptSummary>

agents: Vec<AgentDirectoryEntry>

roles: Vec<RoleBinding>

actions_log: Mutex<Vec<MockAction>>

Implementations

impl MockRuntime

pub fn into_runtime(self) -> Runtime

pub fn actions(&self) -> Vec<MockAction>

Trait Implementations

impl Actions for MockRuntime

fn terminate_session(&self, pid: u32) -> Result<(), String>

Terminate the OS process with the given PID. The TUI uses this for “kill session” hotkeys.

fn inject_text(&self, session_id: &str, text: &str) -> Result<(), String>

Inject text into the session’s terminal. Implementations pick the right backend (tmux, Kitty, etc.) from the session metadata.

fn set_gate_mode(&self, mode: BrainGateMode) -> Result<(), String>

Update the persisted brain gate mode. Reflected back through BrainView::gate_mode on the next call.

fn log_observation(&self, observation: ObservationInput) -> Result<(), String>

Record an observation about a user action — non-LLM “the user did X.” Drives the brain’s outcome telemetry and preference distillation.

fn log_decision(&self, input: LogDecisionInput) -> Result<(), String>

Record a user’s accept/reject decision on a brain suggestion. The distinction from log_observation is that log_decision carries the actual suggestion that was on screen — the brain pairs it with the user’s response for outcome telemetry, counterfactual analysis, and few-shot retrieval.

fn mark_canonical( &self, decision_id: &str, note: Option<String>, ) -> Result<(), String>

Mark a past brain decision as canonical for teaching. Optional note is the operator’s annotation. Used by the Brain Review surface.

fn bind_bus_role(&self, name: &str, cwd: &str, pid: u32) -> Result<(), String>

Bind an agent-bus role to a (cwd, pid) pair. The TUI calls this from the new role-bind key (Ctrl+R) so the operator can attach a role to a specific running Claude session without dropping to another terminal. Returns Err when the bus feature is compiled out or the DB write fails. See issue #307.

impl BrainReviewView for MockRuntime

fn all_decisions(&self) -> Vec<DecisionSummary>

Every decision on disk, newest first. Used by the Brain Review screen to render the full history list.

fn review_queue(&self) -> Vec<ReviewItemSummary>

Priority-ordered review queue. Built from all_decisions() plus the brain’s queue-building heuristics (counterfactual hits, Critical-tier safety cases, high-confidence misses).

impl BrainView for MockRuntime

fn gate_mode(&self) -> BrainGateMode

fn recent_decisions(&self, n: usize) -> Vec<DecisionSummary>

Most recent n decisions, newest first.

fn decision_count(&self) -> usize

Total count of brain decisions on disk. Drives the “decisions: N” status line.

impl BusView for MockRuntime

fn list_agents(&self) -> Vec<AgentDirectoryEntry>

fn list_roles(&self) -> Vec<RoleBinding>

impl CoordView for MockRuntime

fn active_leases(&self) -> Vec<LeaseSummary>

fn pending_handoffs(&self) -> Vec<HandoffSummary>

fn pending_interrupts(&self) -> Vec<InterruptSummary>

impl Default for MockRuntime

fn default() -> MockRuntime

Returns the “default value” for a type.

impl HiveActions for MockRuntime

fn shared_skill_keys(&self) -> HashSet<String>

Semantic keys (skill:<lowered-name>) of skills already shared into the local hive store. Used by the Skills overlay to mark “already shared” rows.

fn share_skill(&self, _skill: &DiscoveredSkill) -> Result<String, String>

Share a discovered skill into the local hive store. Returns the new unit ID on success.

fn hive_view_snapshot(&self) -> HiveViewSnapshot

Current view of the local relay identity + known peers for the Hive tab.

impl Orchestrator for MockRuntime

fn deliver_mailbox(&self, _sessions: &[SessionSnapshot]) -> Vec<(u32, String)>

Drain pending mailbox messages addressed to running sessions and deliver them to the live terminals. Used by App::tick to surface "Brain → sess_X: 'go ahead'" style messages.

fn deliver_interrupts( &self, _sessions: &[SessionSnapshot], ) -> Vec<(String, String)>

Deliver pending coordination interrupts (cross-agent signals) to running sessions. Returns (interrupt_id, status_message) tuples.

fn expire_stale(&self)

Expire stale leases and interrupts that have passed their deadline. Bookkeeping side-effect; best-effort, no return. Implementations log failures rather than propagating them.

impl SessionSource for MockRuntime

fn list(&self) -> Vec<SessionSnapshot>

Snapshot of every running Claude Code session. Order is the implementor’s choice; the TUI sorts again client-side.

fn detail(&self, session_id: &str) -> Option<SessionSnapshot>

Fetch a specific session by its ID. None when the session has exited or never existed.