Skip to content

docs: the glue event axis - process-step events and inbound message/file arrivals - #21

Open
delchev wants to merge 1 commit into
mainfrom
docs/glue-event-axis
Open

docs: the glue event axis - process-step events and inbound message/file arrivals#21
delchev wants to merge 1 commit into
mainfrom
docs/glue-event-axis

Conversation

@delchev

@delchev delchev commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Documents the two additions proposed in intent-specification#21.

The event axis — a new section on the glue page: a reacting entry (notifications, integrations) binds to an entity lifecycle event or a process step reached/completed. A step event is an event about the record the process runs on, so every recipient path, placeholder, guard and forwarded body reads exactly as it does for a lifecycle event. Covers what is rejected at parse (undeclared process/step, a step with no observable moment, a process with no trigger) and when each moment fires (reached before the step's work; completed after its writes are persisted).

inbound — arrivals from outside — the section grows from "webhooks" to the three arrivals: path, source: { queue | topic }, source: { folder, cron }. Same create, same ordinary write path; a folder is polled, not watched, and a read file leaves the drop folder so nothing is ingested twice.

Reference index and the scope-boundary cross-links updated to match. vitepress build is clean.

…ile arrivals

The glue page said an event is an entity lifecycle event and an inbound is a webhook.
Both grew:

- a new "The event axis" section documents the two axes a reacting entry binds to,
  with the process-step shape, what is rejected at parse, and when each moment fires
  (reached before the step's work, completed after its writes are persisted);
- "inbound - webhooks" becomes "inbound - arrivals from outside": the same create,
  three arrivals (path / queue-topic / polled folder), with the polled-not-watched
  caveat and the file handling rules.

Reference index and the scope-boundary cross-links updated to match.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant