feat(intent): transitions - guarded on-demand status flips (void/cancel/close)

[delchev]

What

A document whose create-time process has ended (an issued invoice, a posted entry) has no declarative affordance left to change its status: process triggers fire only on create/update/delete, and actions: only opens a custom page. The new top-level transitions: block adds one - a per-record button that moves the record into a designated EntityStatus, guarded server-side:

transitions:
  - name: VoidInvoice
    forEntity: Invoice          # must declare a function: EntityStatus relation
    from: [3, 4]                # allowed source status seed ids - 409 from any other status
    setStatus: 8                # the target status seed id
    when: "Paid == 0"           # optional <Field> ==|!= <number> guard (Calc semantics: null reads as 0)
    label: Void
    icon: ban

The classic consumers: void/cancel an issued document (анулиране keeps the number for the audit trail), cancel a confirmed order, close a case, reopen a ticket.

How

Two generated halves, mirroring generates:

• Client: TransitionsIntentGenerator (@Order(470)) contributes <name>-transition-action.extension/.js to the app's <project>-custom-action point; the descriptor carries an endpoint (always per-record).
• Server: GlueIntentGenerator.buildTransitions pre-renders everything (the allowed-statuses expression over an int currentStatus local; the when guard as a full Calc.eval(...).compareTo(...) expression) into the transitions glue collection, rendered by Transition.java.template into a @Controller at gen/events/<ClassName>Transition/run. The controller re-loads the record, returns 409 with the reason when a guard fails, flips ONLY the status column via the targeted updateProperty (a workflow-style system write - no -updated re-fire), and publishes -transitioned - the same channel the workflow setters and generates.sourceStatus publish, so postings: glue observes a manual void exactly like a workflow transition (the enabler for a follow-up red-storno reversal posting).

Also: ControllerInvoker no longer stamps text/plain over a content type a controller set explicitly on a String return (default unchanged when unset) - the transition controller returns JSON.

Docs: intent-assistant-guide.md gains the ### transitions section + quick-reference and allowed-values rows; engine-intent/CLAUDE.md gains the semantics bullet.

Testing

• TransitionsIntentTest (parse + 6 validation rejections), GlueTransitionsTest (pre-rendered guards) - full engine-intent suite green.
• ControllerInvokerBindingTest +2 content-type tests - full engine-java suite green.
• IntentEmissionCoverageIT extended per the engine-intent testing contract (fixture transition + emission tokens + runtime: allowed cancel returns 200 with the status flipped and -transitioned observable; wrong-status re-cancel 409; when-guard 409 leaving the record untouched) - green locally.

🤖 Generated with Claude Code