Factory docs, home
Page navigation

See the input → responsibility → output diagram.

Status: One committed Branch health poll projection. Build review records accepted snapshots and current verification gates. Live hosting and application delivery remain unqualified.

A useful notification says what was observed, where it came from and how to request authorised detail. This projection retains the Product's recorded red, unknown or green state, the poll's actual start time and immutable source identity. It carries no private provider response or free-form instructions.

A compact blue bob ringing a small hand bell.

Meet the herald. Small news, clearly sourced. Projects committed facts into small, attributable notifications. Meet the whole Plumb family.

The application supplies a trusted source pin and a current permission decision. Unknown permission remains unavailable. Unchanged polls are quiet by default, but a repeated changed poll still returns the same notification. The host owns durable conflict handling, later delivery and current access to detail.

A notification is evidence about that recorded poll. It proves neither present health nor a completed reaction. The separate Provider subscriptions component implements bounded caller-owned lifecycle and verification. Webhook delivery, tool requests and their independently verified effects remain separate bounded work.

Honest limits:

  • The caller authenticates source identity and supplies current permission; matching hashes grant no authority.
  • The poll timestamp is its recorded start, not a commit time or a statement of present health.
  • The subscription component requires caller-owned durable storage and current authority; a live MCP HTTP host, webhook delivery and admitted reactions still need separate qualification.

Source: docs/guide/provider-events.md