[P1] Implement CLI controls and query commands #27

New issue

Closed

opened 2026-07-18 00:02:13 +00:00 by lost-rob0t · 0 comments

lost-rob0t commented

2026-07-18 00:02:13 +00:00

(Migrated from github.com)

Goal

Provide a dependable command-line interface for controlling capture and querying recall data.

Commands

start, pause, resume, stop, and status.
privacy-on and privacy-off for an immediate sensitive-work mode.
ask, timeline, and search with explicit time filters.
config validate, providers, health, and storage stats.
Machine-readable JSON output where useful.

Requirements

Commands communicate with the running daemon through an authenticated local channel.
Stop/privacy commands receive priority over normal work.
Status clearly distinguishes off, paused, recording, locked, overloaded, and faulted.
Shell completion must not expose captured text.

Acceptance criteria

Control commands are idempotent and return meaningful exit codes.
stop confirms that capture and pending persistence have ceased.
ask "What was I doing Saturday?" produces cited output.
Tests cover unavailable daemon, locked key store, and concurrent control requests.

Depends on

## Goal Provide a dependable command-line interface for controlling capture and querying recall data. ## Commands - `start`, `pause`, `resume`, `stop`, and `status`. - `privacy-on` and `privacy-off` for an immediate sensitive-work mode. - `ask`, `timeline`, and `search` with explicit time filters. - `config validate`, `providers`, `health`, and `storage stats`. - Machine-readable JSON output where useful. ## Requirements - Commands communicate with the running daemon through an authenticated local channel. - Stop/privacy commands receive priority over normal work. - Status clearly distinguishes off, paused, recording, locked, overloaded, and faulted. - Shell completion must not expose captured text. ## Acceptance criteria - Control commands are idempotent and return meaningful exit codes. - `stop` confirms that capture and pending persistence have ceased. - `ask "What was I doing Saturday?"` produces cited output. - Tests cover unavailable daemon, locked key store, and concurrent control requests. ## Depends on - #7 - #26