Provenance stream #324

Open
opened 2026-07-01 13:31:38 -04:00 by didericis-claude · 0 comments
Collaborator

The provenance API should include an event stream another service can hook into for logging the provenance of all changes.

Protocol: Webhook push — the orchestrator POSTs events to a configured endpoint (e.g. Logstash HTTP input plugin).

Events:

  • Bot-bottle lifecycle transitions (start, freeze, rehydrate, destroy)
  • Forge events that triggered work (issue opened, comment received, PR closed)
  • Explicit provenance records written by the orchestrator
  • Container traffic in/out (togglable, off by default)

Durability: Events are buffered in SQLite as they accumulate; consumers can replay from a cursor on reconnect.

Ordering: Strict causal order per bot-bottle (required for auditing breach attempts).

Auth: Behind auth, consistent with the rest of the provenance API (both require auth).

Migrated from bot-bottle-orchestrator#2.

The provenance API should include an event stream another service can hook into for logging the provenance of all changes. **Protocol:** Webhook push — the orchestrator POSTs events to a configured endpoint (e.g. Logstash HTTP input plugin). **Events:** - Bot-bottle lifecycle transitions (start, freeze, rehydrate, destroy) - Forge events that triggered work (issue opened, comment received, PR closed) - Explicit provenance records written by the orchestrator - Container traffic in/out (togglable, off by default) **Durability:** Events are buffered in SQLite as they accumulate; consumers can replay from a cursor on reconnect. **Ordering:** Strict causal order per bot-bottle (required for auditing breach attempts). **Auth:** Behind auth, consistent with the rest of the provenance API (both require auth). *Migrated from [bot-bottle-orchestrator#2](https://gitea.dideric.is/didericis/bot-bottle-orchestrator/issues/2).*
didericis added the Kind/Feature label 2026-07-01 17:21:37 -04:00
didericis-codex added the
Priority
Low
4
label 2026-07-18 03:43:00 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: didericis/bot-bottle#324