feat(intent): generates completion hook — sourceStatus flips the source after the target is created

[delchev]

What

generates: (create-from) gains an optional sourceStatus: <EntityStatus seed id> — the completion hook the flow was missing:

generates:
  - name: invoice-from-proforma
    from: ProformaInvoice
    to: SalesInvoice
    map: { Customer: Customer, Company: Company }
    defaults: { date: now }
    sourceStatus: 3        # the proforma flips to INVOICED once the invoice exists

Until now the create-from link was one-way: the target was created through its repository (numbering, status init, calculated fields all fire), but the source stayed in its pre-generation status and the flip was a manual step.

Semantics

A workflow-style system write, consistent with the setter delegates: the source's EntityStatus FK is set after the target (and its cloned items) are saved, persisted via updateWithoutEvent — no -updated re-fire, so onUpdate reactions stay quiet — and the source's -transitioned topic is published, so posting glue and integrations observe the transition like any other status change.

• Parser: sourceStatus requires the from entity to declare a function: EntityStatus relation.
• Glue: pre-resolves the FK property (PascalCase) + seed id; empty when the hook is absent, so existing generates blocks generate byte-identical code.
• Template: the flip renders after the save + items clone in Generate.java.template.

Verification

• Live end-to-end on a generated application: proforma → Generate Invoice → invoice created → proforma Status == 3 (INVOICED).
• GlueGeneratesTest: the resolved hook fields and the no-hook default (guards the byte-identical path for existing blocks). Full engine-intent suite 114/114.
• Docs: intent-assistant-guide.md, module README (the item moves out of the Planned list).

🤖 Generated with Claude Code