How these docs are organized

• Product specification: end-to-end features, behaviors, and operations.
• API and graph store: HTTP/Socket APIs and persistence internals.
• Containers and security: workspace lifecycle and secret handling.
• Observability and UI: traces, spans, and the graph builder.
• Contributing and ADRs: internal engineering references.

Index

• Product Spec: product-spec.md
• API Reference: api/index.md
  • Realtime notifications: socket payloads are published via the notifications service and served by notifications-gateway when running docker-compose.yml.
• Graph
  • Filesystem Store: graph/fs-store.md
  • Status Updates: graph/status-updates.md
• Containers
  • Workspaces: containers/workspaces.md
  • Env Overlays: config/env-overlays.md
• Observability
  • Overview: observability/index.md
  • Heartbeats and Sweeper: observability/heartbeats-and-sweeper.md
  • Stage 1 Plan: observability/stage-1-plan.md
• UI
  • Graph Builder Overview: ui/graph/index.md
  • Config Views: ui/config-views.md
• Security
  • Vault: security/vault.md
• MCP Design: mcp-design.md
• Technical Overview: technical-overview.md
• ADR: Memory v2: adr/adr-0005-memory-v2.md
• Server Memory: server-memory.md
• Summarization: summarization.md
• Glossary: glossary.md
• Changelog Template: CHANGELOG_TEMPLATE.md

Slack integration

• For Slack-triggered flows and outbound messages, see:
  • Secrets and tokens: security/vault.md
  • Graph UI templates (SlackTrigger, SendSlackMessageTool): ui/graph/README.md