Skip to content

docs(eventing): an executive summary of the phases and architecture #954

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mrsabath merged 3 commits into from
Oct 9, 2026
Merged

docs(eventing): an executive summary of the phases and architecture #954

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2b3252b
docs(eventing): add an executive summary of the phases and architecture
mrsabath Oct 9, 2026
d71dd99
docs(eventing): point the agentdocs index at the executive summary
mrsabath Oct 9, 2026
f5b8c61
docs(eventing): fix the citations and framing a review found (#954)
mrsabath Oct 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion eventing/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1083,14 +1083,22 @@ multi-replica EventBridge, and TLS to Kafka.

The long-form designs, build reports and full runbooks live in
**[`agentdocs/`](agentdocs/)**, which has [its own index](agentdocs/README.md). They
are the authoritative references this file summarizes:
are the authoritative references this file summarizes. The one-page summary of all of
them, for a reader who will not open the code, is in
[`docs/`](docs/EXECUTIVE_SUMMARY.md):

| | |
|---|---|
| [`docs/EXECUTIVE_SUMMARY.md`](docs/EXECUTIVE_SUMMARY.md) | **start here if you are not going to open the code** — what each phase decided, what is built as opposed to designed, and the KubeCon commitment with its gaps |
| [`agentdocs/DESIGN_PHASE0.md`](agentdocs/DESIGN_PHASE0.md) | the wire contract, the `uuid5` session scheme, and the §4.5 per-correlation ordering guarantee |
| [`agentdocs/DESIGN_PHASE1.md`](agentdocs/DESIGN_PHASE1.md) | the KEDA scaling model, the §16 gaps, and §3.2 on the local Kind target |
| [`agentdocs/DESIGN_PHASE2.md`](agentdocs/DESIGN_PHASE2.md) | identity on the event path — and §8, the thirteen control claims a docs review disproved, with §8.5's five questions |
| [`agentdocs/DESIGN_PHASE3.md`](agentdocs/DESIGN_PHASE3.md) | per-user isolation, `AgentSpec`, and event triggers — partly implemented, `EB_TENANCY_MODE` still defaults to `single` |
| [`agentdocs/DESIGN_PHASE4.md`](agentdocs/DESIGN_PHASE4.md) | enrollment and human-in-the-loop approval — design only, with §2 the measured mechanism the rest rests on |
| [`agentdocs/IMPLEMENTATION_REPORT0.md`](agentdocs/IMPLEMENTATION_REPORT0.md) | what Phase 0 built, and the follow-ups it left |
| [`agentdocs/IMPLEMENTATION_REPORT1.md`](agentdocs/IMPLEMENTATION_REPORT1.md) | what Phase 1 built, measured results on both clusters, 28 findings, and what is still blocked |
| [`agentdocs/IMPLEMENTATION_REPORT3.md`](agentdocs/IMPLEMENTATION_REPORT3.md) | what Phase 3 has built so far, measured — and §5, which is explicit that `multi` does not work end to end |
| [`agentdocs/KUBECON_NA_2026.md`](agentdocs/KUBECON_NA_2026.md) | the KubeCon NA talk: the abstract's five demo beats, their status, the SPIRE decision, and the MVP cut |
| [`agentdocs/README_PHASE0.md`](agentdocs/README_PHASE0.md) | the laptop runbook in full detail |
| [`agentdocs/README_PHASE1.md`](agentdocs/README_PHASE1.md) | the Phase 1 runbook in full detail — local, Docker, Kind, OpenShift |

Expand Down
5 changes: 5 additions & 0 deletions eventing/agentdocs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,11 @@ and what is *not* verified.

## Reading order

- **Deciding whether to fund, demo or depend on this?**
[`../docs/EXECUTIVE_SUMMARY.md`](../docs/EXECUTIVE_SUMMARY.md) — what each phase
decided, what is built as opposed to designed, and the KubeCon commitment with its
gaps. It cites these documents rather than restating them, and it is the only one
written for a reader who will not open the code.
Comment thread
mrsabath marked this conversation as resolved.
- **Running it?** [`README_PHASE1.md`](README_PHASE1.md), or the [Phase 1
section](../README.md#phase-1--kubernetes-and-keda) of the component README for
the short version.
Expand Down
Loading
Loading