From ffcceb360ca803cce032d27b4c276df359204e1c Mon Sep 17 00:00:00 2001 From: Jer Miller Date: Sat, 30 May 2026 20:19:09 -0600 Subject: [PATCH] docs(observe): prune dated in-box Linux observer content from OBSERVE.md Remove the 'Linux Observer State Machine' section (capture internals that now live in solstone-linux), drop 'built-in' observer wording, and make the Standalone Observers section list all three external observer packages. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/OBSERVE.md | 28 ++++++---------------------- 1 file changed, 6 insertions(+), 22 deletions(-) diff --git a/docs/OBSERVE.md b/docs/OBSERVE.md index afd19ae2d..25c9c157e 100644 --- a/docs/OBSERVE.md +++ b/docs/OBSERVE.md @@ -44,7 +44,7 @@ sol observer revoke ## Architecture ``` -Observers (standalone or built-in) +Observers (standalone, per-platform repos) ↓ HTTP multipart upload Observer Ingest API (/app/observer/ingest/) ↓ @@ -55,24 +55,6 @@ journal sense (coordination) └── journal describe → screen.jsonl ``` -## Linux Observer State Machine - -The Linux observer operates in two modes based on desktop activity: - -``` -SCREENCAST ←→ IDLE -``` - -| Mode | Trigger | Captures | -|------|---------|----------| -| SCREENCAST | Screen active (not idle/locked/power-save) | Video + Audio | -| IDLE | Screen idle, locked, or power-save | Audio only (if threshold met) | - -**Segment boundaries** are triggered by: -- Transitions between SCREENCAST and IDLE modes -- Mute state changes -- 5-minute window elapsed - ## Key Components Capture components (screen/audio grab, platform activity detection, the upload @@ -87,11 +69,13 @@ What remains in this package is the home-side ingest-and-processing pipeline: ## Standalone Observers -**Tmux capture** is handled by the `solstone-tmux` package, which runs as its own systemd user service. See `solstone-tmux` repo for setup instructions. +Each observer is a standalone package in its own repo (see the Observer Architecture table above), with its own capture internals and lifecycle: -**macOS capture** is handled by the `solstone-macos` native Swift app. See `solstone-macos` repo. +- **`solstone-linux`** — screen + audio capture on Linux; runs as a systemd user service. +- **`solstone-macos`** — screen + audio capture on macOS; native Swift menu-bar app. +- **`solstone-tmux`** — tmux terminal-session capture; runs as a systemd user service. -Both upload segments via the same HTTP ingest API used by the built-in Linux observer. +All upload segments via the same HTTP ingest API (`/app/observer/ingest/`). ## Output Formats -- 2.51.2