@open-mercato/cli 0.6.7 → 0.6.8-canary.319.1.5b4be4bc52

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

@@ -1,55 +1,254 @@
 # messages — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-canary.319.1.5b4be4bc52; core 0.6.8-canary.319.1.5b4be4bc52 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/core/src/modules/messages
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| messages:message | Message | messages | yes | no |
-| messages:message_recipient | MessageRecipient | message_recipients | no | no |
-| messages:message_object | MessageObject | message_objects | no | no |
-| messages:message_access_token | MessageAccessToken | message_access_tokens | no | no |
-| messages:message_confirmation | MessageConfirmation | message_confirmations | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| messages:message | Message | messages | yes | no | [node_modules/@open-mercato/core/src/modules/messages/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/messages/data/entities.ts) |
+| messages:message_recipient | MessageRecipient | message_recipients | no | no | [node_modules/@open-mercato/core/src/modules/messages/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/messages/data/entities.ts) |
+| messages:message_object | MessageObject | message_objects | no | no | [node_modules/@open-mercato/core/src/modules/messages/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/messages/data/entities.ts) |
+| messages:message_access_token | MessageAccessToken | message_access_tokens | no | no | [node_modules/@open-mercato/core/src/modules/messages/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/messages/data/entities.ts) |
+| messages:message_confirmation | MessageConfirmation | message_confirmations | yes | no | [node_modules/@open-mercato/core/src/modules/messages/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/messages/data/entities.ts) |
 
 ## Events  (9)
 
-| ID | Category | Entity |
-|---|---|---|
-| messages.message.sent | custom | message |
-| messages.message.read | custom | message |
-| messages.message.marked_unread | custom | message |
-| messages.message.archived | custom | message |
-| messages.message.unarchived | custom | message |
-| messages.message.deleted | custom | message |
-| messages.message.action_taken | custom | message |
-| messages.message.email_sent | custom | message |
-| messages.message.email_failed | custom | message |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| messages.message.sent | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.read | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.marked_unread | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.archived | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.unarchived | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.deleted | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.action_taken | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.email_sent | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.email_failed | custom | message | client | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
 
 ## ACL features  (7)
 
-messages.view · messages.compose · messages.attach · messages.attach_files · messages.email · messages.actions · messages.manage
+| Feature | Source |
+|---|---|
+| messages.view | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| messages.compose | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| messages.attach | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| messages.attach_files | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| messages.email | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| messages.actions | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| messages.manage | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
 
 ## API routes
 
 _none_
 
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/messages | [node_modules/@open-mercato/core/src/modules/messages/backend/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/backend/page.tsx) |
+| /backend/messages/[id] | [node_modules/@open-mercato/core/src/modules/messages/backend/messages/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/backend/messages/[id]/page.tsx) |
+| /backend/messages/compose | [node_modules/@open-mercato/core/src/modules/messages/backend/messages/compose/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/backend/messages/compose/page.tsx) |
+
+## Frontend pages
+
+| ID / path | Source |
+|---|---|
+| /messages/view/[token] | [node_modules/@open-mercato/core/src/modules/messages/frontend/messages/view/[token]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/frontend/messages/view/[token]/page.tsx) |
+
 ## DI service tokens
 
 _none_
 
 ## Search entities
 
-messages:message
+| Entity ID | Source |
+|---|---|
+| messages:message | [node_modules/@open-mercato/core/src/modules/messages/search.ts](../../../node_modules/@open-mercato/core/src/modules/messages/search.ts) |
 
 ## Host extension points
 
 - Entity IDs: _none_
-- Table IDs: _none_
+- Table IDs: messages
+
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| data-table:messages | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| data-table:messages:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| detail:messages:message:body:after | detail | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| detail:messages:message:sidebar | detail | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| messages:message | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:messages:message |
+| messages:message_access_token | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:messages:message_access_token |
+| messages:message_confirmation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:messages:message_confirmation |
+| messages:message_object | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:messages:message_object |
+| messages:message_recipient | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:messages:message_recipient |
+| messages.message.action_taken | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.action_taken |
+| messages.message.archived | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.archived |
+| messages.message.deleted | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.deleted |
+| messages.message.email_failed | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.email_failed |
+| messages.message.email_sent | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.email_sent |
+| messages.message.marked_unread | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.marked_unread |
+| messages.message.read | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.read |
+| messages.message.sent | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.sent |
+| messages.message.unarchived | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:messages.message.unarchived |
+| crud-form:messages:message:fields | generic | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| messages.message.queried | query-lifecycle | sync-subscriber | tenant-and-organization-reapplied-after-result | STABLE | searchEntities:messages:message |
+| messages.message.querying | query-lifecycle | sync-subscriber | tenant-and-organization-reapplied-after-result | STABLE | searchEntities:messages:message |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| messages.message.action_taken.browser | browser-reaction | messages.message.action_taken | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.archived.browser | browser-reaction | messages.message.archived | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.deleted.browser | browser-reaction | messages.message.deleted | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.email_failed.browser | browser-reaction | messages.message.email_failed | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.email_sent.browser | browser-reaction | messages.message.email_sent | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.marked_unread.browser | browser-reaction | messages.message.marked_unread | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.read.browser | browser-reaction | messages.message.read | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.sent.browser | browser-reaction | messages.message.sent | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.unarchived.browser | browser-reaction | messages.message.unarchived | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| notification:messages.new | specialized-registry | messages.new | — | registry=notification; registryId=messages.new; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/messages/notifications.ts) |
+| search:messages:message | specialized-registry | messages:message | — | registry=search; registryId=messages:message; specialistRoute=search | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/search.ts](../../../node_modules/@open-mercato/core/src/modules/messages/search.ts) |
+| messages:query-index-reindex-sent | subscriber | messages.message.sent | before-or-after | event=messages.message.sent; persistent=false; subscriberId=messages:query-index-reindex-sent; sync=true | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/subscribers/search-reindex-sent.ts](../../../node_modules/@open-mercato/core/src/modules/messages/subscribers/search-reindex-sent.ts) |
+| messages:queue-email-delivery | subscriber | messages.message.sent | async-delivery | event=messages.message.sent; persistent=true; subscriberId=messages:queue-email-delivery; sync=false | fact-ref | [node_modules/@open-mercato/core/src/modules/messages/subscribers/message-notification.ts](../../../node_modules/@open-mercato/core/src/modules/messages/subscribers/message-notification.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| widget-spot:data-table:messages:columns:widget-injection-consumer | widget-injection-consumer | widget-spot:data-table:messages:columns @messages | widget, data-table, crud-form | — | hosts:inboxTable.columns | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| widget-spot:detail:messages:message:body:after:widget-injection-consumer | widget-injection-consumer | widget-spot:detail:messages:message:body:after @messages | widget, data-table, crud-form | — | hosts:detailBodyAfter | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+| widget-spot:detail:messages:message:sidebar:widget-injection-consumer | widget-injection-consumer | widget-spot:detail:messages:message:sidebar @messages | widget, data-table, crud-form | — | hosts:detailSidebar | [node_modules/@open-mercato/core/src/modules/messages/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/messages/extension-points.ts) |
+
+## Incoming installed contributions
+
+| Contributor | Kind | Target | Resolution | Activation | Contribution · Source |
+|---|---|---|---|---|---|
+| communication_channels | subscriber | event:messages.message.sent @messages | capability-only | — | communication_channels:outbound-bridge · [node_modules/@open-mercato/core/src/modules/communication_channels/subscribers/outbound-bridge.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/subscribers/outbound-bridge.ts) |
+| communication_channels | entity-extension | entity:messages:message @messages | capability-only | — | communication_channels.entity-extension.0:messages:message->communication_channels:message_channel_link · [node_modules/@open-mercato/core/src/modules/communication_channels/data/extensions.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/data/extensions.ts) |
+| communication_channels | entity-extension | entity:messages:message @messages | capability-only | — | communication_channels.entity-extension.1:messages:message->communication_channels:message_reaction · [node_modules/@open-mercato/core/src/modules/communication_channels/data/extensions.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/data/extensions.ts) |
+| communication_channels | data-table | widget-spot:data-table:messages:columns @messages | bound | widget-spot:data-table:messages:columns:widget-injection-consumer | communication_channels.injection.channel-badge@data-table:messages:columns · [node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts) |
+| communication_channels | widget | widget-spot:detail:messages:message:sidebar @messages | bound | widget-spot:detail:messages:message:sidebar:widget-injection-consumer | communication_channels.injection.channel-info-panel@detail:messages:message:sidebar · [node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts) |
+| communication_channels | widget | widget-spot:detail:messages:message:body:after @messages | bound | widget-spot:detail:messages:message:body:after:widget-injection-consumer | communication_channels.injection.channel-payload-renderer@detail:messages:message:body:after · [node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts) |
+| communication_channels | widget | widget-spot:detail:messages:message:body:after @messages | bound | widget-spot:detail:messages:message:body:after:widget-injection-consumer | communication_channels.injection.reaction-bar@detail:messages:message:body:after · [node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts](../../../node_modules/@open-mercato/core/src/modules/communication_channels/widgets/injection-table.ts) |
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| messages:query-index-reindex-sent | event:messages.message.sent @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/subscribers/search-reindex-sent.ts](../../../node_modules/@open-mercato/core/src/modules/messages/subscribers/search-reindex-sent.ts) |
+| messages:queue-email-delivery | event:messages.message.sent @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/subscribers/message-notification.ts](../../../node_modules/@open-mercato/core/src/modules/messages/subscribers/message-notification.ts) |
+| messages.message.action_taken.browser | event:messages.message.action_taken @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.archived.browser | event:messages.message.archived @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.deleted.browser | event:messages.message.deleted @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.email_failed.browser | event:messages.message.email_failed @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.email_sent.browser | event:messages.message.email_sent @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.marked_unread.browser | event:messages.message.marked_unread @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.read.browser | event:messages.message.read @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.sent.browser | event:messages.message.sent @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| messages.message.unarchived.browser | event:messages.message.unarchived @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/events.ts](../../../node_modules/@open-mercato/core/src/modules/messages/events.ts) |
+| notification:messages.new | module:messages.new | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/messages/notifications.ts) |
+| search:messages:message | module:messages:message @messages | capability-only | — | [node_modules/@open-mercato/core/src/modules/messages/search.ts](../../../node_modules/@open-mercato/core/src/modules/messages/search.ts) |
+
+## UMES diagnostics
+
+- unbound-helper: data-table:messages:empty-state
 
 ## Notifications
 
-messages.new
+| Notification ID | Source |
+|---|---|
+| messages.new | [node_modules/@open-mercato/core/src/modules/messages/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/messages/notifications.ts) |
+
+## CLI commands
+
+_none_
+
+## AI tools / MCP capabilities
+
+_none_
 
-## CLI
+## AI agents
 
 _none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["messages.actions"]` | disable-replace | aclFeatures:messages.actions | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| acl | `overrides.acl.features["messages.attach"]` | disable-replace | aclFeatures:messages.attach | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| acl | `overrides.acl.features["messages.attach_files"]` | disable-replace | aclFeatures:messages.attach_files | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| acl | `overrides.acl.features["messages.compose"]` | disable-replace | aclFeatures:messages.compose | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| acl | `overrides.acl.features["messages.email"]` | disable-replace | aclFeatures:messages.email | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| acl | `overrides.acl.features["messages.manage"]` | disable-replace | aclFeatures:messages.manage | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| acl | `overrides.acl.features["messages.view"]` | disable-replace | aclFeatures:messages.view | [node_modules/@open-mercato/core/src/modules/messages/acl.ts](../../../node_modules/@open-mercato/core/src/modules/messages/acl.ts) |
+| encryption | `overrides.encryption.maps["messages:message"]` | disable-replace | ownedContracts.encryption:messages:message | [node_modules/@open-mercato/core/src/modules/messages/encryption.ts:4](../../../node_modules/@open-mercato/core/src/modules/messages/encryption.ts#L4) |
+| events | `overrides.events.subscribers["messages:query-index-reindex-sent"]` | disable-replace | extensionSurfaces.contributions:messages:query-index-reindex-sent | [node_modules/@open-mercato/core/src/modules/messages/subscribers/search-reindex-sent.ts](../../../node_modules/@open-mercato/core/src/modules/messages/subscribers/search-reindex-sent.ts) |
+| events | `overrides.events.subscribers["messages:queue-email-delivery"]` | disable-replace | extensionSurfaces.contributions:messages:queue-email-delivery | [node_modules/@open-mercato/core/src/modules/messages/subscribers/message-notification.ts](../../../node_modules/@open-mercato/core/src/modules/messages/subscribers/message-notification.ts) |
+| notifications | `overrides.notifications.types["messages.new"]` | disable-replace | notifications:messages.new | [node_modules/@open-mercato/core/src/modules/messages/notifications.ts](../../../node_modules/@open-mercato/core/src/modules/messages/notifications.ts) |
+| routes | `overrides.routes.pages["backend:/backend/messages"]` | disable-replace | backendPages:/backend/messages | [node_modules/@open-mercato/core/src/modules/messages/backend/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/backend/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/messages/[id]"]` | disable-replace | backendPages:/backend/messages/[id] | [node_modules/@open-mercato/core/src/modules/messages/backend/messages/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/backend/messages/[id]/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/messages/compose"]` | disable-replace | backendPages:/backend/messages/compose | [node_modules/@open-mercato/core/src/modules/messages/backend/messages/compose/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/backend/messages/compose/page.tsx) |
+| routes | `overrides.routes.pages["frontend:/messages/view/[token]"]` | disable-replace | frontendPages:/messages/view/[token] | [node_modules/@open-mercato/core/src/modules/messages/frontend/messages/view/[token]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/messages/frontend/messages/view/[token]/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:messages:setup | [node_modules/@open-mercato/core/src/modules/messages/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/messages/setup.ts#L3) |
+| workers | `overrides.workers["messages:send-email"]` | disable-replace | ownedContracts.worker:messages:send-email | [node_modules/@open-mercato/core/src/modules/messages/workers/send-email.worker.ts:36](../../../node_modules/@open-mercato/core/src/modules/messages/workers/send-email.worker.ts#L36) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| messages | name=messages; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/messages/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/messages/index.ts#L3) |
+
+## Domain commands
+
+| ID | Metadata | Source |
+|---|---|---|
+| messages.actions.execute | — | [node_modules/@open-mercato/core/src/modules/messages/commands/actions.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/actions.ts) |
+| messages.actions.record_terminal | — | [node_modules/@open-mercato/core/src/modules/messages/commands/actions.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/actions.ts) |
+| messages.attachments.link_to_draft | — | [node_modules/@open-mercato/core/src/modules/messages/commands/attachments.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/attachments.ts) |
+| messages.attachments.unlink_from_draft | — | [node_modules/@open-mercato/core/src/modules/messages/commands/attachments.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/attachments.ts) |
+| messages.confirmations.confirm | — | [node_modules/@open-mercato/core/src/modules/messages/commands/confirmations.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/confirmations.ts) |
+| messages.conversation.archive_for_actor | — | [node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts) |
+| messages.conversation.delete_for_actor | — | [node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts) |
+| messages.conversation.mark_read_for_actor | — | [node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts) |
+| messages.conversation.mark_unread_for_actor | — | [node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts) |
+| messages.conversation.unarchive_for_actor | — | [node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/conversation.ts) |
+| messages.messages.compose | — | [node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts) |
+| messages.messages.delete_for_actor | — | [node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts) |
+| messages.messages.forward | — | [node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts) |
+| messages.messages.reply | — | [node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts) |
+| messages.messages.update_draft | — | [node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/messages.ts) |
+| messages.recipients.archive | — | [node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts) |
+| messages.recipients.mark_read | — | [node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts) |
+| messages.recipients.mark_unread | — | [node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts) |
+| messages.recipients.unarchive | — | [node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/recipients.ts) |
+| messages.tokens.consume | — | [node_modules/@open-mercato/core/src/modules/messages/commands/tokens.ts](../../../node_modules/@open-mercato/core/src/modules/messages/commands/tokens.ts) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| messages:send-email | concurrency=10; queue=messages-email | [node_modules/@open-mercato/core/src/modules/messages/workers/send-email.worker.ts:36](../../../node_modules/@open-mercato/core/src/modules/messages/workers/send-email.worker.ts#L36) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| messages:setup | roles=admin, employee, superadmin | [node_modules/@open-mercato/core/src/modules/messages/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/messages/setup.ts#L3) |
+
+## Encryption
+
+| ID | Metadata | Source |
+|---|---|---|
+| messages:message | fields=action_data, action_result, body, external_email, external_name, subject | [node_modules/@open-mercato/core/src/modules/messages/encryption.ts:4](../../../node_modules/@open-mercato/core/src/modules/messages/encryption.ts#L4) |

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

@@ -1,11 +1,12 @@
 # notifications — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-canary.319.1.5b4be4bc52; core 0.6.8-canary.319.1.5b4be4bc52 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/core/src/modules/notifications
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| notifications:notification | Notification | notifications | no | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| notifications:notification | Notification | notifications | no | no | [node_modules/@open-mercato/core/src/modules/notifications/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/data/entities.ts) |
 
 ## Events  (0)
 
@@ -13,15 +14,31 @@ _none_
 
 ## ACL features  (3)
 
-notifications.view · notifications.create · notifications.manage
+| Feature | Source |
+|---|---|
+| notifications.view | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| notifications.create | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| notifications.manage | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
 
 ## API routes
 
 _none_
 
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/config/notifications | [node_modules/@open-mercato/core/src/modules/notifications/backend/config/notifications/page.tsx](../../../node_modules/@open-mercato/core/src/modules/notifications/backend/config/notifications/page.tsx) |
+
+## Frontend pages
+
+_none_
+
 ## DI service tokens
 
-notificationService
+| Token | Source |
+|---|---|
+| notificationService | [node_modules/@open-mercato/core/src/modules/notifications/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/notifications/di.ts#L7) |
 
 ## Search entities
 
@@ -32,10 +49,81 @@ _none_
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| notifications:notification | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:notifications:notification |
+
+## UMES contributions
+
+_none_
+
+## Active extension bindings
+
+_none_
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
+
+
 ## Notifications
 
 _none_
 
-## CLI
+## CLI commands
+
+| ID / path | Source |
+|---|---|
+| cleanup-expired | [node_modules/@open-mercato/core/src/modules/notifications/cli.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/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["notifications.create"]` | disable-replace | aclFeatures:notifications.create | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| acl | `overrides.acl.features["notifications.manage"]` | disable-replace | aclFeatures:notifications.manage | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| acl | `overrides.acl.features["notifications.view"]` | disable-replace | aclFeatures:notifications.view | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| cli | `overrides.cli["cleanup-expired"]` | disable-replace | cliCommands:cleanup-expired | [node_modules/@open-mercato/core/src/modules/notifications/cli.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/cli.ts) |
+| di | `overrides.di["notificationService"]` | disable-replace | ownedContracts.di-registration:notificationService | [node_modules/@open-mercato/core/src/modules/notifications/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/notifications/di.ts#L7) |
+| routes | `overrides.routes.pages["backend:/backend/config/notifications"]` | disable-replace | backendPages:/backend/config/notifications | [node_modules/@open-mercato/core/src/modules/notifications/backend/config/notifications/page.tsx](../../../node_modules/@open-mercato/core/src/modules/notifications/backend/config/notifications/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:notifications:setup | [node_modules/@open-mercato/core/src/modules/notifications/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/notifications/setup.ts#L3) |
+| workers | `overrides.workers["notifications:create"]` | disable-replace | ownedContracts.worker:notifications:create | [node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts:42](../../../node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts#L42) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| notifications | name=notifications; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/notifications/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/notifications/index.ts#L3) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| notifications:create | concurrency=5; queue=notifications | [node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts:42](../../../node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts#L42) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| notifications:setup | roles=admin, employee, superadmin | [node_modules/@open-mercato/core/src/modules/notifications/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/notifications/setup.ts#L3) |
+
+## DI registrations (rich)
 
-cleanup-expired
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| notificationService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/notifications/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/notifications/di.ts#L7) |

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

@@ -1,11 +1,12 @@
 # onboarding — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/onboarding 0.6.8-canary.319.1.5b4be4bc52; core 0.6.8-canary.319.1.5b4be4bc52 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/onboarding/src/modules/onboarding
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| onboarding:onboarding_request | OnboardingRequest | onboarding_requests | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| onboarding:onboarding_request | OnboardingRequest | onboarding_requests | yes | no | [node_modules/@open-mercato/onboarding/src/modules/onboarding/data/entities.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/data/entities.ts) |
 
 ## Events  (0)
 
@@ -13,12 +14,27 @@ _none_
 
 ## ACL features  (3)
 
-onboarding.access · onboarding.submit · onboarding.verify
+| Feature | Source |
+|---|---|
+| onboarding.access | [node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts) |
+| onboarding.submit | [node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts) |
+| onboarding.verify | [node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts) |
 
 ## API routes
 
 _none_
 
+## Backend pages
+
+_none_
+
+## Frontend pages
+
+| ID / path | Source |
+|---|---|
+| /onboarding | [node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/page.tsx](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/page.tsx) |
+| /onboarding/preparing | [node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/preparing/page.tsx](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/preparing/page.tsx) |
+
 ## DI service tokens
 
 _none_
@@ -32,10 +48,65 @@ _none_
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| onboarding:onboarding_request | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:onboarding:onboarding_request |
+
+## UMES contributions
+
+_none_
+
+## Active extension bindings
+
+_none_
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
+
+
 ## Notifications
 
 _none_
 
-## CLI
+## CLI commands
 
 _none_
+
+## AI tools / MCP capabilities
+
+_none_
+
+## AI agents
+
+_none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["onboarding.access"]` | disable-replace | aclFeatures:onboarding.access | [node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts) |
+| acl | `overrides.acl.features["onboarding.submit"]` | disable-replace | aclFeatures:onboarding.submit | [node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts) |
+| acl | `overrides.acl.features["onboarding.verify"]` | disable-replace | aclFeatures:onboarding.verify | [node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/acl.ts) |
+| encryption | `overrides.encryption.maps["onboarding:onboarding_request"]` | disable-replace | ownedContracts.encryption:onboarding:onboarding_request | [node_modules/@open-mercato/onboarding/src/modules/onboarding/encryption.ts:4](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/encryption.ts#L4) |
+| routes | `overrides.routes.pages["frontend:/onboarding"]` | disable-replace | frontendPages:/onboarding | [node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/page.tsx](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/page.tsx) |
+| routes | `overrides.routes.pages["frontend:/onboarding/preparing"]` | disable-replace | frontendPages:/onboarding/preparing | [node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/preparing/page.tsx](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/frontend/onboarding/preparing/page.tsx) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| onboarding | name=onboarding; version=0.1.0 | [node_modules/@open-mercato/onboarding/src/modules/onboarding/index.ts:3](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/index.ts#L3) |
+
+## Encryption
+
+| ID | Metadata | Source |
+|---|---|---|
+| onboarding:onboarding_request | fields=email, first_name, last_name, organization_name, password_hash | [node_modules/@open-mercato/onboarding/src/modules/onboarding/encryption.ts:4](../../../node_modules/@open-mercato/onboarding/src/modules/onboarding/encryption.ts#L4) |