Skip to content

docs: phases - a moment an enrichment announces - #42

Open
delchev wants to merge 1 commit into
mainfrom
docs/enrichment-phases
Open

docs: phases - a moment an enrichment announces#42
delchev wants to merge 1 commit into
mainfrom
docs/enrichment-phases

Conversation

@delchev

@delchev delchev commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

The site half of intent-specification#57 (proposal 0028).

A value a listener computes after the insert must be written back without raising an update event, since an enrichment is not a user's edit. So it announced nothing at all, and a declarative consumer of that value had no moment to bind: bound to the create event it runs as a sibling of the enriching listener, with nothing ordering the two, and can produce a perfectly balanced journal entry for a null amount with every step green.

  • spec/entities.md - the phases section: the declaration, the announce-in-one-write contract the generated data-access layer must satisfy, and the rules.
  • spec/glue.md - the enrichment row in the event-axis table (now three axes).
  • reference.md - the index rows for phases, the event axis and postings.

npm run docs:build is clean.

A value a listener computes after the insert must be written back without
raising an update event, since an enrichment is not a user's edit. So it
announced nothing at all, and a declarative consumer of that value had no
moment to bind: bound to the create event it runs as a sibling of the
enriching listener, with nothing ordering the two, and can produce a
perfectly balanced journal entry for a null amount with every step green.

Document the entity-level `phases:` declaration and the `onPhase` event
axis: the generated data-access layer applies the enriched values and
announces the phase in ONE write, so no consumer can observe one without
the other.

- spec/entities.md: the `phases` section.
- spec/glue.md: the enrichment row in the event-axis table.
- reference.md: the index rows.
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