Step 5: Enrich Components

Objective

Add semantic information to DomainOps — state changes and business rules.

Prerequisites

• Do not use plan mode. Execute directly.
• Graph with linked components from Step 4.

Generate Checklist

riviere builder component-checklist --type=DomainOp --output=".riviere/step-5-checklist.md"

Process

Prefix every message with: [Working through step-5 checklist and marking items as done]

The checklist is the only source of work. Do not explore the codebase or generate your own list.

1. Generate checklist (if not exists)
2. Read .riviere/step-5-checklist.md
3. Find unchecked items - [ ]
4. For each item, read source file and enrich
5. Mark items as - [x] in the checklist
6. Continue until all items are checked

For each DomainOp:

1. Identify State Changes

Look for entity state transitions:

this.status = 'placed';           // Draft → Placed
this.state = OrderState.CONFIRMED; // Placed → Confirmed

Capture as: from:[States],to:[States] (brackets = array, can list multiple) Examples:

• from:[Draft],to:[Placed] — single state transition
• from:[Draft,Pending],to:[Active] — multiple source states

2. Identify Business Rules

Look for validation logic:

if (this.items.length === 0) throw new Error('...');   // must have items
if (this.total <= 0) throw new Error('...');           // total must be positive

Capture as plain English rules.

3. Enrich via CLI

riviere builder enrich \
  --id "[component-id]" \
  --state-change "from:[State1],to:[State2]" \
  --business-rule "Rule description"

4. Mark Done

- [x] orders:domainop:order.begin (src/domain/Order.ts:23)

Output

Updated .riviere/step-5-checklist.md with all DomainOps checked.

Feedback

If user reports problems or missing elements, identify the root cause, update the relevant config files, and re-run the affected step.

Completion

Present enrichment summary showing how many DomainOps were enriched.

Step 5 complete. Wait for user feedback before proceeding.