@open-mercato/cli 0.6.7-develop.6863.1.61001cf9a8 → 0.6.7

package/dist/agentic/guides/modules/workflows.md

@@ -1,109 +1,59 @@
 # workflows — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6863.1.61001cf9a8; core 0.6.7-develop.6863.1.61001cf9a8 — R1 staleness stamp -->
-Source root: [node_modules/@open-mercato/core/src/modules/workflows](../../../node_modules/@open-mercato/core/src/modules/workflows)
+<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields | Source |
-|---|---|---|---|---|---|
-| workflows:workflow_definition | WorkflowDefinition | workflow_definitions | yes | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
-| workflows:workflow_instance | WorkflowInstance | workflow_instances | yes | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
-| workflows:workflow_branch_instance | WorkflowBranchInstance | workflow_branch_instances | yes | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
-| workflows:step_instance | StepInstance | step_instances | yes | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
-| workflows:user_task | UserTask | user_tasks | yes | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
-| workflows:workflow_event | WorkflowEvent | workflow_events | no | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
-| workflows:workflow_event_trigger | WorkflowEventTrigger | workflow_event_triggers | yes | no | [node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/data/entities.ts) |
+| Entity ID | Class | Table | Editable | CustomFields |
+|---|---|---|---|---|
+| workflows:workflow_definition | WorkflowDefinition | workflow_definitions | yes | no |
+| workflows:workflow_instance | WorkflowInstance | workflow_instances | yes | no |
+| workflows:workflow_branch_instance | WorkflowBranchInstance | workflow_branch_instances | yes | no |
+| workflows:step_instance | StepInstance | step_instances | yes | no |
+| workflows:user_task | UserTask | user_tasks | yes | no |
+| workflows:workflow_event | WorkflowEvent | workflow_events | no | no |
+| workflows:workflow_event_trigger | WorkflowEventTrigger | workflow_event_triggers | yes | no |
 
-## Events  (26)
+## Events  (25)
 
-| ID | Category | Entity | Browser transport | Source |
-|---|---|---|---|---|
-| workflows.definition.created | crud | definition | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.definition.updated | crud | definition | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.definition.deleted | crud | definition | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.definition.customized | lifecycle | definition | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.definition.reset_to_code | lifecycle | definition | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.created | crud | instance | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.updated | crud | instance | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.deleted | crud | instance | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.started | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.completed | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.failed | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.cancelled | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.paused | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.instance.resumed | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.activity.started | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.activity.completed | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.activity.failed | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.task.assigned | lifecycle | task | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.trigger.created | crud | trigger | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.trigger.updated | crud | trigger | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.trigger.deleted | crud | trigger | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.branch.opened | lifecycle | branch | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.branch.completed | lifecycle | branch | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.branch.cancelled | lifecycle | branch | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.branch.failed | lifecycle | branch | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
-| workflows.join.completed | lifecycle | branch | — | [node_modules/@open-mercato/core/src/modules/workflows/events.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/events.ts) |
+| ID | Category | Entity |
+|---|---|---|
+| workflows.definition.created | crud | definition |
+| workflows.definition.updated | crud | definition |
+| workflows.definition.deleted | crud | definition |
+| workflows.definition.customized | lifecycle | definition |
+| workflows.definition.reset_to_code | lifecycle | definition |
+| workflows.instance.created | crud | instance |
+| workflows.instance.updated | crud | instance |
+| workflows.instance.deleted | crud | instance |
+| workflows.instance.started | lifecycle | — |
+| workflows.instance.completed | lifecycle | — |
+| workflows.instance.failed | lifecycle | — |
+| workflows.instance.cancelled | lifecycle | — |
+| workflows.instance.paused | lifecycle | — |
+| workflows.instance.resumed | lifecycle | — |
+| workflows.activity.started | lifecycle | — |
+| workflows.activity.completed | lifecycle | — |
+| workflows.activity.failed | lifecycle | — |
+| workflows.trigger.created | crud | trigger |
+| workflows.trigger.updated | crud | trigger |
+| workflows.trigger.deleted | crud | trigger |
+| workflows.branch.opened | lifecycle | branch |
+| workflows.branch.completed | lifecycle | branch |
+| workflows.branch.cancelled | lifecycle | branch |
+| workflows.branch.failed | lifecycle | branch |
+| workflows.join.completed | lifecycle | branch |
 
 ## ACL features  (18)
 
-| Feature | Source |
-|---|---|
-| workflows.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.manage | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.view_logs | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.view_tasks | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.definitions.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.definitions.create | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.definitions.edit | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.definitions.delete | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.instances.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.instances.create | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.instances.cancel | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.instances.retry | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.instances.signal | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.tasks.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.tasks.claim | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.tasks.complete | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.signals.send | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| workflows.events.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
+workflows.view · workflows.manage · workflows.view_logs · workflows.view_tasks · workflows.definitions.view · workflows.definitions.create · workflows.definitions.edit · workflows.definitions.delete · workflows.instances.view · workflows.instances.create · workflows.instances.cancel · workflows.instances.retry · workflows.instances.signal · workflows.tasks.view · workflows.tasks.claim · workflows.tasks.complete · workflows.signals.send · workflows.events.view
 
 ## API routes
 
 _none_
 
-## Backend pages
-
-| ID / path | Source |
-|---|---|
-| /backend/definitions | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/page.tsx) |
-| /backend/definitions/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/[id]/page.tsx) |
-| /backend/definitions/create | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/create/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/create/page.tsx) |
-| /backend/definitions/visual-editor | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/visual-editor/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/visual-editor/page.tsx) |
-| /backend/events | [node_modules/@open-mercato/core/src/modules/workflows/backend/events/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/events/page.tsx) |
-| /backend/events/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/events/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/events/[id]/page.tsx) |
-| /backend/instances | [node_modules/@open-mercato/core/src/modules/workflows/backend/instances/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/instances/page.tsx) |
-| /backend/instances/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/instances/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/instances/[id]/page.tsx) |
-| /backend/tasks | [node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/page.tsx) |
-| /backend/tasks/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/[id]/page.tsx) |
-
-## Frontend pages
-
-| ID / path | Source |
-|---|---|
-| /checkout-demo | [node_modules/@open-mercato/core/src/modules/workflows/frontend/checkout-demo/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/frontend/checkout-demo/page.tsx) |
-
 ## DI service tokens
 
-| Token | Source |
-|---|---|
-| workflowExecutor | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:39](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L39) |
-| stepHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:40](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L40) |
-| transitionHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:41](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L41) |
-| activityExecutor | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:42](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L42) |
-| eventLogger | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:43](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L43) |
-| signalHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:44](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L44) |
-| timerHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:45](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L45) |
+workflowExecutor · stepHandler · transitionHandler · activityExecutor · eventLogger · signalHandler · timerHandler
 
 ## Search entities
 
@@ -114,219 +64,10 @@ _none_
 - Entity IDs: _none_
 - Table IDs: workflows.definitions.list · workflows.instances.list · workflows.tasks.list
 
-## UMES hosts
-
-| ID / pattern | Family | Supports | Context | Stability | Source |
-|---|---|---|---|---|---|
-| data-table:workflows.definitions.list | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.definitions.list:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.instances.list:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| data-table:workflows.tasks.list:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/extension-points.ts) |
-| workflows:step_instance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:step_instance |
-| workflows:user_task | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:user_task |
-| workflows:workflow_branch_instance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:workflow_branch_instance |
-| workflows:workflow_definition | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:workflow_definition |
-| workflows:workflow_event | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:workflow_event |
-| workflows:workflow_event_trigger | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:workflow_event_trigger |
-| workflows:workflow_instance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:workflows:workflow_instance |
-| workflows.definition | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/workflows/api/definitions/[id]/customize/route.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/api/definitions/[id]/customize/route.ts) |
-| workflows.activity.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.activity.completed |
-| workflows.activity.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.activity.failed |
-| workflows.activity.started | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.activity.started |
-| workflows.branch.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.branch.cancelled |
-| workflows.branch.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.branch.completed |
-| workflows.branch.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.branch.failed |
-| workflows.branch.opened | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.branch.opened |
-| workflows.definition.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.definition.created |
-| workflows.definition.customized | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.definition.customized |
-| workflows.definition.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.definition.deleted |
-| workflows.definition.reset_to_code | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.definition.reset_to_code |
-| workflows.definition.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.definition.updated |
-| workflows.instance.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.cancelled |
-| workflows.instance.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.completed |
-| workflows.instance.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.created |
-| workflows.instance.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.deleted |
-| workflows.instance.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.failed |
-| workflows.instance.paused | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.paused |
-| workflows.instance.resumed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.resumed |
-| workflows.instance.started | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.started |
-| workflows.instance.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.instance.updated |
-| workflows.join.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.join.completed |
-| workflows.task.assigned | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.task.assigned |
-| workflows.trigger.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.trigger.created |
-| workflows.trigger.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.trigger.deleted |
-| workflows.trigger.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:workflows.trigger.updated |
-
-## UMES contributions
-
-| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
-|---|---|---|---|---|---|---|
-| notification:workflows.task.assigned | specialized-registry | workflows.task.assigned | — | registry=notification; registryId=workflows.task.assigned; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/core/src/modules/workflows/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/notifications.ts) |
-| workflow:workflows.checkout-demo | specialized-registry | workflows.checkout-demo | — | registry=workflow; registryId=workflows.checkout-demo; specialistRoute=workflows | fact-ref | [node_modules/@open-mercato/core/src/modules/workflows/workflows.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/workflows.ts) |
-| workflow:workflows.simple-approval | specialized-registry | workflows.simple-approval | — | registry=workflow; registryId=workflows.simple-approval; specialistRoute=workflows | fact-ref | [node_modules/@open-mercato/core/src/modules/workflows/workflows.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/workflows.ts) |
-| workflows:event-trigger | subscriber | * | async-delivery | event=*; persistent=true; subscriberId=workflows:event-trigger; sync=false | pattern | [node_modules/@open-mercato/core/src/modules/workflows/subscribers/event-trigger.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/subscribers/event-trigger.ts) |
-| workflows:task-assigned-notification | subscriber | workflows.task.assigned | async-delivery | event=workflows.task.assigned; persistent=true; subscriberId=workflows:task-assigned-notification; sync=false | fact-ref | [node_modules/@open-mercato/core/src/modules/workflows/subscribers/task-assigned-notification.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/subscribers/task-assigned-notification.ts) |
-| workflows.injection.order-approval@sales.document.detail.order:details | widget | sales.document.detail.order:details | — | executionGuard=host; payload=render; registryKey=workflows.injection.order-approval | pattern | [node_modules/@open-mercato/core/src/modules/workflows/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/widgets/injection-table.ts) |
-
-## Active extension bindings
-
-| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
-|---|---|---|---|---|---|---|
-| entity:workflows.definition:mutation-guard | mutation-guard | entity:workflows.definition @workflows | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/workflows/api/definitions/[id]/customize/route.ts:64](../../../node_modules/@open-mercato/core/src/modules/workflows/api/definitions/[id]/customize/route.ts#L64) |
-
-## Incoming installed contributions
-
-_none_
-
-## Contribution resolutions
-
-| Contribution | Target | Resolution | Activations | Source |
-|---|---|---|---|---|
-| notification:workflows.task.assigned | module:workflows.task.assigned @workflows | capability-only | — | [node_modules/@open-mercato/core/src/modules/workflows/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/notifications.ts) |
-| workflow:workflows.checkout-demo | module:workflows.checkout-demo | capability-only | — | [node_modules/@open-mercato/core/src/modules/workflows/workflows.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/workflows.ts) |
-| workflow:workflows.simple-approval | module:workflows.simple-approval | capability-only | — | [node_modules/@open-mercato/core/src/modules/workflows/workflows.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/workflows.ts) |
-| workflows:event-trigger | wildcard:* | wildcard | — | [node_modules/@open-mercato/core/src/modules/workflows/subscribers/event-trigger.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/subscribers/event-trigger.ts) |
-| workflows:task-assigned-notification | event:workflows.task.assigned @workflows | capability-only | — | [node_modules/@open-mercato/core/src/modules/workflows/subscribers/task-assigned-notification.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/subscribers/task-assigned-notification.ts) |
-| workflows.injection.order-approval@sales.document.detail.order:details | widget-spot:sales.document.detail.order:details | wildcard | — | [node_modules/@open-mercato/core/src/modules/workflows/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/widgets/injection-table.ts) |
-
-## UMES diagnostics
-
-- unbound-helper: data-table:workflows.definitions.list:empty-state
-- unbound-helper: data-table:workflows.instances.list:empty-state
-- unbound-helper: data-table:workflows.tasks.list:empty-state
-
 ## Notifications
 
-| Notification ID | Source |
-|---|---|
-| workflows.task.assigned | [node_modules/@open-mercato/core/src/modules/workflows/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/notifications.ts) |
-
-## CLI commands
-
-| ID / path | Source |
-|---|---|
-| start-worker | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| process-activities | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| seed-demo | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| seed-demo-with-rules | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| seed-sales-pipeline | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| seed-simple-approval | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| seed-order-approval | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| seed-all | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-
-## AI tools / MCP capabilities
-
-_none_
-
-## AI agents
-
-_none_
-
-## Exact override targets
-
-| Domain | Path / key | Supported modes | Referenced fact | Source |
-|---|---|---|---|---|
-| acl | `overrides.acl.features["workflows.definitions.create"]` | disable-replace | aclFeatures:workflows.definitions.create | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.definitions.delete"]` | disable-replace | aclFeatures:workflows.definitions.delete | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.definitions.edit"]` | disable-replace | aclFeatures:workflows.definitions.edit | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.definitions.view"]` | disable-replace | aclFeatures:workflows.definitions.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.events.view"]` | disable-replace | aclFeatures:workflows.events.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.instances.cancel"]` | disable-replace | aclFeatures:workflows.instances.cancel | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.instances.create"]` | disable-replace | aclFeatures:workflows.instances.create | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.instances.retry"]` | disable-replace | aclFeatures:workflows.instances.retry | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.instances.signal"]` | disable-replace | aclFeatures:workflows.instances.signal | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.instances.view"]` | disable-replace | aclFeatures:workflows.instances.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.manage"]` | disable-replace | aclFeatures:workflows.manage | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.signals.send"]` | disable-replace | aclFeatures:workflows.signals.send | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.tasks.claim"]` | disable-replace | aclFeatures:workflows.tasks.claim | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.tasks.complete"]` | disable-replace | aclFeatures:workflows.tasks.complete | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.tasks.view"]` | disable-replace | aclFeatures:workflows.tasks.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.view"]` | disable-replace | aclFeatures:workflows.view | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.view_logs"]` | disable-replace | aclFeatures:workflows.view_logs | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| acl | `overrides.acl.features["workflows.view_tasks"]` | disable-replace | aclFeatures:workflows.view_tasks | [node_modules/@open-mercato/core/src/modules/workflows/acl.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/acl.ts) |
-| cli | `overrides.cli["process-activities"]` | disable-replace | cliCommands:process-activities | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["seed-all"]` | disable-replace | cliCommands:seed-all | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["seed-demo"]` | disable-replace | cliCommands:seed-demo | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["seed-demo-with-rules"]` | disable-replace | cliCommands:seed-demo-with-rules | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["seed-order-approval"]` | disable-replace | cliCommands:seed-order-approval | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["seed-sales-pipeline"]` | disable-replace | cliCommands:seed-sales-pipeline | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["seed-simple-approval"]` | disable-replace | cliCommands:seed-simple-approval | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| cli | `overrides.cli["start-worker"]` | disable-replace | cliCommands:start-worker | [node_modules/@open-mercato/core/src/modules/workflows/cli.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/cli.ts) |
-| di | `overrides.di["activityExecutor"]` | disable-replace | ownedContracts.di-registration:activityExecutor | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:42](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L42) |
-| di | `overrides.di["eventLogger"]` | disable-replace | ownedContracts.di-registration:eventLogger | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:43](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L43) |
-| di | `overrides.di["signalHandler"]` | disable-replace | ownedContracts.di-registration:signalHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:44](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L44) |
-| di | `overrides.di["stepHandler"]` | disable-replace | ownedContracts.di-registration:stepHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:40](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L40) |
-| di | `overrides.di["timerHandler"]` | disable-replace | ownedContracts.di-registration:timerHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:45](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L45) |
-| di | `overrides.di["transitionHandler"]` | disable-replace | ownedContracts.di-registration:transitionHandler | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:41](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L41) |
-| di | `overrides.di["workflowExecutor"]` | disable-replace | ownedContracts.di-registration:workflowExecutor | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:39](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L39) |
-| events | `overrides.events.subscribers["workflows:event-trigger"]` | disable-replace | extensionSurfaces.contributions:workflows:event-trigger | [node_modules/@open-mercato/core/src/modules/workflows/subscribers/event-trigger.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/subscribers/event-trigger.ts) |
-| events | `overrides.events.subscribers["workflows:task-assigned-notification"]` | disable-replace | extensionSurfaces.contributions:workflows:task-assigned-notification | [node_modules/@open-mercato/core/src/modules/workflows/subscribers/task-assigned-notification.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/subscribers/task-assigned-notification.ts) |
-| notifications | `overrides.notifications.types["workflows.task.assigned"]` | disable-replace | notifications:workflows.task.assigned | [node_modules/@open-mercato/core/src/modules/workflows/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/notifications.ts) |
-| routes | `overrides.routes.pages["backend:/backend/definitions"]` | disable-replace | backendPages:/backend/definitions | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/definitions/[id]"]` | disable-replace | backendPages:/backend/definitions/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/[id]/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/definitions/create"]` | disable-replace | backendPages:/backend/definitions/create | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/create/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/create/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/definitions/visual-editor"]` | disable-replace | backendPages:/backend/definitions/visual-editor | [node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/visual-editor/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/definitions/visual-editor/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/events"]` | disable-replace | backendPages:/backend/events | [node_modules/@open-mercato/core/src/modules/workflows/backend/events/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/events/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/events/[id]"]` | disable-replace | backendPages:/backend/events/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/events/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/events/[id]/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/instances"]` | disable-replace | backendPages:/backend/instances | [node_modules/@open-mercato/core/src/modules/workflows/backend/instances/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/instances/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/instances/[id]"]` | disable-replace | backendPages:/backend/instances/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/instances/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/instances/[id]/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/tasks"]` | disable-replace | backendPages:/backend/tasks | [node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/page.tsx) |
-| routes | `overrides.routes.pages["backend:/backend/tasks/[id]"]` | disable-replace | backendPages:/backend/tasks/[id] | [node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/backend/tasks/[id]/page.tsx) |
-| routes | `overrides.routes.pages["frontend:/checkout-demo"]` | disable-replace | frontendPages:/checkout-demo | [node_modules/@open-mercato/core/src/modules/workflows/frontend/checkout-demo/page.tsx](../../../node_modules/@open-mercato/core/src/modules/workflows/frontend/checkout-demo/page.tsx) |
-| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:workflows:setup | [node_modules/@open-mercato/core/src/modules/workflows/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/workflows/setup.ts#L5) |
-| setup | `overrides.setup.seedDefaults` | replace | ownedContracts.setup:workflows:setup | [node_modules/@open-mercato/core/src/modules/workflows/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/workflows/setup.ts#L5) |
-| widgets | `overrides.widgets.injection["workflows.injection.order-approval"]` | disable-replace | extensionSurfaces.contributions:workflows.injection.order-approval@sales.document.detail.order:details | [node_modules/@open-mercato/core/src/modules/workflows/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/workflows/widgets/injection-table.ts) |
-| workers | `overrides.workers["workflows:workflow-activities"]` | disable-replace | ownedContracts.worker:workflows:workflow-activities | [node_modules/@open-mercato/core/src/modules/workflows/workers/workflow-activities.worker.ts:39](../../../node_modules/@open-mercato/core/src/modules/workflows/workers/workflow-activities.worker.ts#L39) |
-
-## Owned contract — module metadata
-
-| ID | Metadata | Source |
-|---|---|---|
-| workflows | ejectable=true; name=workflows; version=1.0.0 | [node_modules/@open-mercato/core/src/modules/workflows/index.ts:10](../../../node_modules/@open-mercato/core/src/modules/workflows/index.ts#L10) |
-
-## Workers
-
-| ID | Metadata | Source |
-|---|---|---|
-| workflows:workflow-activities | queue=workflow-activities | [node_modules/@open-mercato/core/src/modules/workflows/workers/workflow-activities.worker.ts:39](../../../node_modules/@open-mercato/core/src/modules/workflows/workers/workflow-activities.worker.ts#L39) |
-
-## Setup
-
-| ID | Metadata | Source |
-|---|---|---|
-| workflows:setup | hooks=seedDefaults; roles=admin | [node_modules/@open-mercato/core/src/modules/workflows/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/workflows/setup.ts#L5) |
+workflows.task.assigned
 
-## DI registrations (rich)
+## CLI
 
-| Token | Kind | Lifetime | Injection | Provider | Source |
-|---|---|---|---|---|---|
-| activityExecutor | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:42](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L42) |
-| eventLogger | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:43](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L43) |
-| signalHandler | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:44](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L44) |
-| stepHandler | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:40](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L40) |
-| timerHandler | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:45](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L45) |
-| transitionHandler | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:41](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L41) |
-| workflowExecutor | function | scoped | — | — | [node_modules/@open-mercato/core/src/modules/workflows/di.ts:39](../../../node_modules/@open-mercato/core/src/modules/workflows/di.ts#L39) |
+start-worker · process-activities · seed-demo · seed-demo-with-rules · seed-sales-pipeline · seed-simple-approval · seed-order-approval · seed-all

package/dist/agentic/guides/queue.md

@@ -0,0 +1,53 @@
+# Queue Package — Standalone Developer Guide
+
+`@open-mercato/queue` provides background job processing. MUST NOT implement custom job queues or polling loops.
+
+## Strategy Selection
+
+| Strategy | When | Config |
+|----------|------|--------|
+| Local | Development — processes from `.mercato/queue/` | `QUEUE_STRATEGY=local` |
+| BullMQ | Production — Redis-backed with retries | `QUEUE_STRATEGY=async` |
+
+## Adding a Worker
+
+Create `src/modules/<module>/workers/<name>.ts`:
+
+```typescript
+export const metadata = {
+  queue: 'my-queue',
+  id: 'my-worker',
+  concurrency: 5,
+}
+
+export default async function handler(job) {
+  // MUST be idempotent — jobs may be retried on failure
+  // Check state before mutating
+}
+```
+
+Run `yarn generate` after adding.
+
+## Concurrency Guidelines
+
+| Worker type | Concurrency | Rationale |
+|-------------|-------------|-----------|
+| I/O-bound (API calls, email) | 5–10 | Network latency allows parallelism |
+| CPU-bound (calculations) | 1–2 | Avoid blocking event loop |
+| Database-heavy (bulk writes) | 3–5 | Balance with connection pool |
+
+Max concurrency: 20.
+
+## MUST Rules
+
+1. **MUST make workers idempotent** — duplicate execution MUST NOT corrupt data
+2. **MUST export `metadata`** with `{ queue, id?, concurrency? }`
+3. **MUST test with both strategies** (`local` and `async`)
+
+## Running Workers (Production)
+
+```bash
+yarn mercato <module> worker <queue-name> --concurrency=5
+```
+
+Development: local strategy auto-processes from `.mercato/queue/`.

package/dist/agentic/guides/search.md

@@ -0,0 +1,115 @@
+# Search Package — Standalone Developer Guide
+
+`@open-mercato/search` provides fulltext, vector, and token-based search. Configure search for your entities via `search.ts` in your module.
+
+## Strategy Overview
+
+| Strategy | Backend | Use when |
+|----------|---------|----------|
+| **Fulltext** | Meilisearch | Fast, typo-tolerant search (names, titles, descriptions) |
+| **Vector** | OpenAI / Ollama | Semantic, meaning-based search ("find customers interested in X") |
+| **Tokens** | PostgreSQL | Baseline keyword search, always available, no external services |
+
+Strategies auto-degrade when their backend is not configured.
+
+## Adding Search to a Module
+
+Create `src/modules/<module>/search.ts`:
+
+```typescript
+import type { SearchModuleConfig, SearchBuildContext } from '@open-mercato/shared/modules/search'
+
+export const searchConfig: SearchModuleConfig = {
+  entities: [{
+    entityId: 'my_module:my_entity',  // MUST match entity registry
+    priority: 10,
+
+    // Fulltext: control field indexing
+    fieldPolicy: {
+      searchable: ['name', 'description'],
+      hashOnly: ['email', 'phone'],      // exact match only
+      excluded: ['password', 'api_key'],  // never indexed
+    },
+
+    // Vector: generate text for embeddings
+    buildSource: async (ctx: SearchBuildContext) => ({
+      text: [`Name: ${ctx.record.name}`, `Description: ${ctx.record.description}`],
+      presenter: { title: ctx.record.name, subtitle: ctx.record.status, icon: 'lucide:file', badge: 'Item' },
+      links: [{ href: `/backend/my-module/${ctx.record.id}`, label: 'View', kind: 'primary' }],
+      checksumSource: { record: ctx.record, customFields: ctx.customFields },
+    }),
+
+    // Tokens: format at search time
+    formatResult: async (ctx: SearchBuildContext) => ({
+      title: ctx.record.name ?? 'Unknown',
+      subtitle: ctx.record.status,
+      icon: 'lucide:file',
+      badge: 'Item',
+    }),
+
+    resolveUrl: async (ctx) => `/backend/my-module/${ctx.record.id}`,
+  }],
+}
+export default searchConfig
+```
+
+Run `yarn generate` after creating the file.
+
+## MUST Rules
+
+1. **MUST create `search.ts`** for every module with searchable entities
+2. **MUST define `fieldPolicy.excluded`** for sensitive fields (passwords, tokens, SSNs)
+3. **MUST define `formatResult`** for every entity using the tokens strategy
+4. **MUST include `checksumSource`** in every `buildSource` return value
+5. **MUST NOT** include encrypted/sensitive fields in `buildSource` text
+6. **MUST NOT** use raw `fetch` against search API — use `apiCall`/`apiCallOrThrow`
+
+## Auto-Indexing
+
+When CRUD routes have `indexer: { entityType }`, the search module automatically subscribes to entity CRUD events and indexes/removes records. No manual indexing code needed.
+
+## CLI Commands
+
+```bash
+yarn mercato search status                           # Check strategies and connectivity
+yarn mercato search query -q "term" --tenant <id>    # Run a search
+yarn mercato search reindex --tenant <id>             # Reindex all entities
+yarn mercato search reindex --entity my_module:my_entity --tenant <id>  # Reindex specific entity
+yarn mercato search test-meilisearch                  # Test Meilisearch connection
+```
+
+## Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `MEILISEARCH_HOST` | Meilisearch URL (enables fulltext) |
+| `MEILISEARCH_API_KEY` | Meilisearch auth key |
+| `OPENAI_API_KEY` | OpenAI API key (enables vector search) |
+| `OM_SEARCH_DEBUG` | Enable verbose debug logging |
+
+## Programmatic Search via DI
+
+```typescript
+const searchService = container.resolve('searchService')
+const results = await searchService.search('query', {
+  tenantId: 'tenant-123',
+  limit: 20,
+  strategies: ['fulltext', 'vector'],
+})
+```
+
+## SearchBuildContext
+
+Both `buildSource` and `formatResult` receive this context:
+
+```typescript
+interface SearchBuildContext {
+  record: Record<string, unknown>       // The database record
+  customFields: Record<string, unknown> // Custom fields (without cf: prefix)
+  tenantId?: string | null
+  organizationId?: string | null
+  queryEngine?: QueryEngine             // For loading related entities
+}
+```
+
+Use `queryEngine` to load parent/related entities for richer presenter data.