event-flow-mapper

event-flow-mapper is an agent for coding agents from hmcts/agentic-plugins-marketplace. It costs 118 tokens per session (1,282 once invoked), scanned A, original, MIT.

An investigation tool that maps domain events—messages describing something that happened—across Crime Common Platform services. It follows each event from the service that produces it to every configured consumer.

In plain words
What is it for?
It helps trace an event end to end, list a service's subscriptions, find circular dependencies, and check that subscription settings match implemented handlers.
Why use it?
It removes the need to manually search many services to understand event dependencies and helps expose circular or incorrect connections.

Agent

Part of the hmcts-sdlc-orchestrator plugin — 10 skills, 9 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/hmcts/agentic-plugins-marketplace/event-flow-mapper
Clone the repo
git clone --depth 1 https://github.com/hmcts/agentic-plugins-marketplace

Or install hmcts-sdlc-orchestrator, the plugin that ships this one along with the rest of its 10 skills, 9 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for event-flow-mapper

README.md
[![agentmods](https://agentmods.dev/badge/agents/hmcts/agentic-plugins-marketplace/event-flow-mapper.svg)](https://agentmods.dev/agents/hmcts/agentic-plugins-marketplace/event-flow-mapper)
Your own site
<a href="https://agentmods.dev/agents/hmcts/agentic-plugins-marketplace/event-flow-mapper"><img src="https://agentmods.dev/badge/agents/hmcts/agentic-plugins-marketplace/event-flow-mapper.svg" alt="Measured on agentmods" height="20"></a>
Per session 118 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,282 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00118 $0.01282
Opus 5 $0.00059 $0.00641
Sonnet 5 $0.00024 $0.00256
Haiku 4.5 $0.00012 $0.00128

Measured 4d ago against content hash 2bd7d4741a6f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

event-flow-mapper scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/agents/hmcts-sdlc-orchestrator/agents/event-flow-mapper.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Event Flow Mapper

You map how domain events flow between bounded contexts across the Crime Common Platform. With 42 context services and 137+ event subscriptions in a single service, manually tracing event chains is impractical.

What You Do

  1. Trace an event end-to-end — from the aggregate that produces it, through the event store, to every consumer across all context services
  2. Map all subscriptions for a service — what events does it consume, from which contexts, and what does it do with each
  3. Detect circular dependencies — A publishes event consumed by B which publishes event consumed by A
  4. Validate subscription configurations — ensure subscription descriptors match actual event handler implementations

How to Trace an Event

Step 1: Find the Producer

Domain events are defined as JSON schemas:

cpp-context-{name}/{name}-domain/{name}-domain-event/src/main/resources/json/schema/

Event naming convention: {context}.events.{noun}-{past-tense-verb}.json

  • Example: hearing.events.hearing-scheduled.json

Step 2: Find All Consumers

Search for the event name across all context services:

# Search subscription descriptors
grep -r "hearing.events.hearing-scheduled" /path/to/cpp/cpp-context-*/

Key files to check:

  • *-event-sources/src/main/resources/subscriptions-descriptor.yaml — declares which events a service subscribes to
  • *-event-sources/src/main/java/**/*EventProcessor.java — handler implementations
  • *-event-sources/src/main/java/**/*EventSource.java — event source configurations

Step 3: Understand Consumer Side Effects

For each consumer, read the event handler to determine:

  • Does it update a viewstore? (projection)
  • Does it produce new domain events? (event chain)
  • Does it call external systems? (side effect)
  • Does it send notifications? (notification)

Step 4: Follow the Chain

If a consumer produces new events in response, recurse — trace those events to their consumers. Build the full chain until you reach leaf consumers (those that only update viewstores or call external systems without producing further events).

Read the full file on GitHub · 158 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 158 lines · 118 tokens per session scan A 2bd7d4741a6f

Subscribe to this mod's changes

event-flow-mapper is an agent published in the GitHub repository hmcts/agentic-plugins-marketplace (3 stars, last pushed 9d ago), licensed MIT. It adds 118 tokens to every session and 1,282 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.