docs(guide): add Terminal Capture & Signature Triage page #209

Merged

clawdie merged 2 commits from docs/guide-port into main

2026-06-26 09:35:20 +02:00

clawdie commented

2026-06-26 09:31:24 +02:00

Owner

Adds the missing guide coverage for the terminal-capture / signature-triage layer (the screen-scraping half of Glasspane). It had no page anywhere in docs/guide/ — the only prior keyword matches were false positives (provider "signature", scheduler "heartbeat").

New page docs/guide/operate/terminal-capture.md (linked from the operate index) documents, authoritatively from the shipped code:

content-hash framing + deduplicated ring-buffer history
edge-triggered signature alerts (fire on rising edge, re-fire after clear)
per-OS SignatureSet (severity / next_action / invoke)
config: COLIBRI_TERMINAL_CAPTURE, …_INTERVAL_SECS, COLIBRI_TERMINAL_WATCH, TELEGRAM_* (degrades to log-only when unset)
control-plane commands: terminal-watch / unwatch / list / history / poll
the boundary note: PNG rendering stays with the tmux-screenshot skill; Colibri owns capture + history + triage

Continues on the kept docs/guide-port branch; diff vs main is just this one page + the index link.

🤖 Generated with Claude Code

Adds the missing guide coverage for the **terminal-capture / signature-triage** layer (the screen-scraping half of Glasspane). It had no page anywhere in `docs/guide/` — the only prior keyword matches were false positives (provider "signature", scheduler "heartbeat"). New page `docs/guide/operate/terminal-capture.md` (linked from the operate index) documents, authoritatively from the shipped code: - content-hash framing + **deduplicated** ring-buffer history - **edge-triggered** signature alerts (fire on rising edge, re-fire after clear) - per-OS `SignatureSet` (severity / `next_action` / `invoke`) - config: `COLIBRI_TERMINAL_CAPTURE`, `…_INTERVAL_SECS`, `COLIBRI_TERMINAL_WATCH`, `TELEGRAM_*` (degrades to log-only when unset) - control-plane commands: `terminal-watch` / `unwatch` / `list` / `history` / `poll` - the boundary note: PNG rendering stays with the `tmux-screenshot` skill; Colibri owns capture + history + triage Continues on the kept `docs/guide-port` branch; diff vs `main` is just this one page + the index link. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

clawdie added 1 commit 2026-06-26 09:31:28 +02:00

docs(guide): add Terminal Capture & Signature Triage operate page

CI / rust (pull_request) Waiting to run

Details

CI / markdown (pull_request) Waiting to run

Details

CI / port (pull_request) Waiting to run

Details

CI / agent-jail-pkgs (pull_request) Waiting to run

Details

7ae22097e1

The terminal-capture / signature-triage layer (colibri-glasspane terminal.rs
+ signatures.rs, driven by the daemon poll loop) had no guide coverage. Document
it: content-hash dedup history, edge-triggered signature alerts, per-OS
signature sets, the COLIBRI_TERMINAL_* / TELEGRAM_* config, and the
terminal-watch/unwatch/list/history/poll socket commands. Linked from the
operate index.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

claude-domedog added 1 commit 2026-06-26 09:34:02 +02:00

docs(guide): add Control-Plane Bridge architecture page

CI / rust (pull_request) Waiting to run

Details

CI / markdown (pull_request) Waiting to run

Details

CI / port (pull_request) Waiting to run

Details

CI / agent-jail-pkgs (pull_request) Waiting to run

Details

5e2692c063

Document the cross-host control-plane bridge (socat TCP on tailscale0 →
colibri-daemon Unix socket): FreeBSD rc.d vs Linux systemd parity, the
interface-scoped firewall gate (pf / ufw), the "tailnet boundary is the auth"
security model (no socket auth; scope :9190 via Tailscale ACL), and config
notes (TAILSCALE_IP_REQUIRED placeholder, socket-path parity, 0770 group).
Points at packaging/{freebsd,linux}/ for install. Linked from the architecture
index next to Control Plane. No real tailnet IPs (placeholders only).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>