strawberry/UX.md
trvon ad1676a594
Some checks failed
Build and Test / build (debug, clang) (push) Has been cancelled
Build and Test / build (debug, gcc) (push) Has been cancelled
Build and Test / build (release, clang) (push) Has been cancelled
Build and Test / build (release, gcc) (push) Has been cancelled
Build and Test / docker (push) Has been cancelled
Integrate features into the daemon, build and docs
Wire the policy, feeds, containment, exec guard, behavior, governor,
crash safety and event store into the daemon, detection pipeline, CLI
and meson build (zstd now required); Dockerfile, conan, systemd unit
(LimitCORE=0, resource limits) and installer updates; existing tests
adapted (store paths are directories now). Detections are counted and
notified even when evidence cannot be persisted (persist_failures in
status). prevention_timeout_ms is clamped and behavior dedupe handles
out-of-order events. Docs: API contract, developer guide, plan, UX,
agent rules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 18:17:30 -06:00

126 lines
4 KiB
Markdown

# Analyst UX Notes
Working notes for Strawberry's operator-facing search and investigation surface.
## Linked Documents
- [RESEARCH.md](RESEARCH.md)
- [PLAN.md](PLAN.md)
- [AGENTS.md](AGENTS.md)
## Current State
As of **October 24, 2026**:
- Strawberry's operator surface is a **Qt6 desktop app with a tray indicator**
(`strawberry-tray`). It replaced the temporary Python web evaluator, which
was removed together with its HTTP port.
- The tray shows scanner health (gray unreachable, green healthy, yellow
degraded or unseen low/medium finding, red unseen high/critical finding). It
raises desktop notifications for new high/critical findings; clicking one
opens the finding.
- Window tabs:
- **Findings**: severity filter, unseen-only, mark seen, details, pivots to
processes
- **Processes**: search, identity, deleted/memfd flags, lineage, related
evidence, incident trace
- **Diagnostics**: backend, tracepoints, rules, counters, plus reload/rescan
controls
- "Seen" state is per desktop user (QSettings) and never touches the daemon.
- Strawberry is still **process-centric**, not **thread-centric**.
- Finding, process-search and trace output are also available as CLI JSON for
automation; see [API_CONTRACT.md](API_CONTRACT.md).
- Strawberry does **not** yet have a general multi-rule incident correlation engine.
## UX Goal
The target workflow should be:
1. search for a process, executable image, hash, rule, or finding
2. inspect the correlated summary first
3. pivot into lineage, related files, and related indicators
4. expand into raw edges and nodes only when needed
## Direction: Native Desktop App
The operator surface is a native Qt app rather than a web UI. The reasons:
- **No listening port.** A local web server is reachable by every local user
and, through DNS rebinding, by websites the analyst visits. The app talks to
the daemon only over a group-restricted Unix socket.
- **Least privilege.** The app runs as the desktop user, reads evidence
read-only, and can trigger only the fixed control verbs (`status`,
`reload-rules`, `rescan`).
- **Same process as the data model.** The app links the existing C++
`Database`, `ProcessQuery` and `IncidentReporter` code directly, so there is
no second API layer to keep in sync.
- **Ambient awareness.** A tray indicator plus notifications fits a scanner
that runs in the background better than a page you have to keep open.
Remote or headless hosts are out of scope for now. If needed, they should get
a separate, authenticated interface designed for that purpose, not a
loopback web server exposed through tunnels.
## Suggested v1 Analyst Views
### 1) Findings
- finding ID
- severity / score
- short explanation
- first seen / last seen
- primary process
- related indicator count
### 2) Process search
- PID
- executable path
- hash
- command line
- parent PID
- timestamp
### 3) Process detail
- process metadata
- parent/child lineage
- executed file image
- matched indicators
- related correlated findings
### 4) Indicator detail
- rule name
- hash
- source / tags / metadata
- linked process executions
- linked executable images
## Thread Support
“Find threads” is a valid long-term UX goal, but it should be treated as **post-v1** unless Strawberry first gains:
- TID/thread telemetry
- thread-to-process relationships
- per-thread execution or activity context
Until then, the safest UX is:
- **process-first**
- lineage-aware
- evidence-pivot friendly
## Correlation Engine Relationship
The UX should not sit directly on raw nodes and edges alone.
It should primarily consume:
- correlated findings
- process-centric pivots
- explainable summaries
Findings, process search, lineage, traces and diagnostics now exist in the desktop app. The next UX dependencies are richer evidence (argv, file-write and network telemetry) and an agent-facing interface over the same read-only evidence and control verbs.
Timestamp note: event times are wall-clock nanoseconds (eBPF timestamps are converted from boot time); synthetic demo data may still use small raw values.