Track 2: Logging Surface (JSONL + query/tail + redaction)

[pikaxinge]

Context

Depends on Track 0 (event backbone). Can run in parallel with Track 1.

Scope

Track 2: Logging Surface

• T2.1 Structured JSONL sink
• T2.2 Query/tail commands
• T2.3 Redaction layer

File Anchors

• snapagent/observability/logging_sink.py (new)
• snapagent/observability/redaction.py (new)
• snapagent/cli/commands.py

Acceptance Criteria

• Structured logs are append-only and queryable by session_key/run_id
• CLI supports logs --follow, --session, --run, --json
• Sensitive fields are masked by default

[pikaxinge]

Claiming this issue. I will implement T2.1/T2.2/T2.3 with tests, and align field keys with Track 0 event backbone for session/run correlation.

[pikaxinge]

Superseded by corrected update in the next comment: #10 (comment)

[pikaxinge]

Update (corrected formatting):

Implemented Track 2 on branch feat/obs-track2-logging-surface.

Delivered:

• structured JSONL diagnostic sink with append-only writes and rotation
• redaction layer for token/api-key/cookie/email-sensitive fields
• snapagent logs query/tail command with --follow, --session, --run, --json
• runtime wiring so gateway/agent/cron emit diagnostic events into the sink
• tests: tests/test_observability_logging_surface.py

Verification:

• pytest tests/ --ignore=tests/test_matrix_channel.py -q (270 passed)
• ruff check snapagent/cli/commands.py snapagent/observability/logging_sink.py snapagent/observability/redaction.py tests/test_observability_logging_surface.py