@open-mercato/cli 0.6.7-develop.6756.1.5300c41145 → 0.6.7-develop.6766.1.40c9011995

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

@@ -1,5 +1,5 @@
 # webhooks — module facts (generated, do not edit)
-<!-- generated from @open-mercato/webhooks 0.6.7-develop.6756.1.5300c41145; core 0.6.7-develop.6756.1.5300c41145 — R1 staleness stamp -->
+<!-- generated from @open-mercato/webhooks 0.6.7-develop.6766.1.40c9011995; core 0.6.7-develop.6766.1.40c9011995 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/webhooks/src/modules/webhooks](../../../node_modules/@open-mercato/webhooks/src/modules/webhooks)
 
 ## Entities
@@ -14,20 +14,20 @@ Source root: [node_modules/@open-mercato/webhooks/src/modules/webhooks](../../..
 
 ## Events  (12)
 
-| ID | Category | Entity |
-|---|---|---|
-| webhooks.webhook.created | — | webhook |
-| webhooks.webhook.updated | — | webhook |
-| webhooks.webhook.deleted | — | webhook |
-| webhooks.delivery.enqueued | — | delivery |
-| webhooks.delivery.succeeded | — | delivery |
-| webhooks.delivery.failed | — | delivery |
-| webhooks.delivery.exhausted | — | delivery |
-| webhooks.webhook.disabled | — | webhook |
-| webhooks.inbound.received | — | inbound |
-| webhooks.inbound.processed | — | inbound |
-| webhooks.inbound.handler_failed | — | inbound |
-| webhooks.secret.rotated | — | webhook |
+| ID | Category | Entity | Browser transport |
+|---|---|---|---|
+| webhooks.webhook.created | — | webhook | — |
+| webhooks.webhook.updated | — | webhook | — |
+| webhooks.webhook.deleted | — | webhook | — |
+| webhooks.delivery.enqueued | — | delivery | — |
+| webhooks.delivery.succeeded | — | delivery | client |
+| webhooks.delivery.failed | — | delivery | client |
+| webhooks.delivery.exhausted | — | delivery | client |
+| webhooks.webhook.disabled | — | webhook | client |
+| webhooks.inbound.received | — | inbound | — |
+| webhooks.inbound.processed | — | inbound | — |
+| webhooks.inbound.handler_failed | — | inbound | client |
+| webhooks.secret.rotated | — | webhook | — |
 
 ## ACL features  (4)
 
@@ -62,6 +62,76 @@ _none_
 - Entity IDs: webhooks:webhook_entity · webhooks:webhook_delivery_entity · webhooks:webhook_inbound_receipt_entity · webhooks:webhook_ingestion_entity · webhooks:inbound_endpoint_config_entity
 - Table IDs: webhooks.deliveries · webhooks.integration-deliveries · webhooks.list
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability |
+|---|---|---|---|---|
+| data-table:webhooks.deliveries | data-table | component-replacement | — | FROZEN |
+| data-table:webhooks.deliveries:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:webhooks.deliveries:columns | data-table | column-widget | — | FROZEN |
+| data-table:webhooks.deliveries:filters | data-table | filter-widget | — | FROZEN |
+| data-table:webhooks.deliveries:footer | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.deliveries:header | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.deliveries:row-actions | data-table | row-action | — | FROZEN |
+| data-table:webhooks.deliveries:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.deliveries:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:webhooks.integration-deliveries | data-table | component-replacement | — | FROZEN |
+| data-table:webhooks.integration-deliveries:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:webhooks.integration-deliveries:columns | data-table | column-widget | — | FROZEN |
+| data-table:webhooks.integration-deliveries:filters | data-table | filter-widget | — | FROZEN |
+| data-table:webhooks.integration-deliveries:footer | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.integration-deliveries:header | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.integration-deliveries:row-actions | data-table | row-action | — | FROZEN |
+| data-table:webhooks.integration-deliveries:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.integration-deliveries:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:webhooks.list | data-table | component-replacement | — | FROZEN |
+| data-table:webhooks.list:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:webhooks.list:columns | data-table | column-widget | — | FROZEN |
+| data-table:webhooks.list:filters | data-table | filter-widget | — | FROZEN |
+| data-table:webhooks.list:footer | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.list:header | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.list:row-actions | data-table | row-action | — | FROZEN |
+| data-table:webhooks.list:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:webhooks.list:toolbar | data-table | toolbar-widget | — | FROZEN |
+| webhooks:inbound_endpoint_config_entity | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| webhooks:webhook_delivery_entity | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| webhooks:webhook_entity | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| webhooks:webhook_inbound_receipt_entity | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| webhooks:webhook_ingestion_entity | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| webhooks.delivery.enqueued | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| webhooks.delivery.exhausted | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
+| webhooks.delivery.failed | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
+| webhooks.delivery.succeeded | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
+| webhooks.inbound.handler_failed | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
+| webhooks.inbound.processed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| webhooks.inbound.received | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| webhooks.secret.rotated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| webhooks.webhook.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| webhooks.webhook.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| webhooks.webhook.disabled | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
+| webhooks.webhook.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution |
+|---|---|---|---|---|---|
+| webhooks.delivery.exhausted.browser | browser-reaction | webhooks.delivery.exhausted | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref |
+| webhooks.delivery.failed.browser | browser-reaction | webhooks.delivery.failed | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref |
+| webhooks.delivery.succeeded.browser | browser-reaction | webhooks.delivery.succeeded | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref |
+| webhooks.inbound.handler_failed.browser | browser-reaction | webhooks.inbound.handler_failed | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref |
+| webhooks.webhook.disabled.browser | browser-reaction | webhooks.webhook.disabled | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref |
+| integration:webhook_custom | specialized-registry | webhook_custom | — | registry=integration; registryId=webhook_custom; specialistRoute=integrations | fact-ref |
+| notification:webhooks.delivery.failed | specialized-registry | webhooks.delivery.failed | — | registry=notification; registryId=webhooks.delivery.failed; specialistRoute=notifications | fact-ref |
+| webhooks:failed-delivery-notification | subscriber | webhooks.delivery.exhausted | async-delivery | event=webhooks.delivery.exhausted; persistent=true; subscriberId=webhooks:failed-delivery-notification; sync=false | fact-ref |
+| webhooks:inbound-process | subscriber | webhooks.inbound.received | async-delivery | event=webhooks.inbound.received; persistent=true; subscriberId=webhooks:inbound-process; sync=false | fact-ref |
+| webhooks:outbound-dispatch | subscriber | * | async-delivery | event=*; persistent=true; subscriberId=webhooks:outbound-dispatch; sync=false | pattern |
+
+## UMES diagnostics
+
+- unbound-helper: data-table:webhooks.deliveries:empty-state
+- unbound-helper: data-table:webhooks.integration-deliveries:empty-state
+- unbound-helper: data-table:webhooks.list:empty-state
+
 ## Notifications
 
 webhooks.delivery.failed

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

@@ -1,5 +1,5 @@
 # wms — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6756.1.5300c41145; core 0.6.7-develop.6756.1.5300c41145 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6766.1.40c9011995; core 0.6.7-develop.6766.1.40c9011995 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/wms](../../../node_modules/@open-mercato/core/src/modules/wms)
 
 ## Entities
@@ -18,35 +18,35 @@ Source root: [node_modules/@open-mercato/core/src/modules/wms](../../../node_mod
 
 ## Events  (27)
 
-| ID | Category | Entity |
-|---|---|---|
-| wms.warehouse.created | crud | warehouse |
-| wms.warehouse.updated | crud | warehouse |
-| wms.zone.created | crud | zone |
-| wms.zone.updated | crud | zone |
-| wms.location.created | crud | location |
-| wms.location.updated | crud | location |
-| wms.inventory_profile.created | crud | inventory_profile |
-| wms.inventory_profile.updated | crud | inventory_profile |
-| wms.inventory_balance.created | crud | inventory_balance |
-| wms.inventory_balance.updated | crud | inventory_balance |
-| wms.inventory_balance.deleted | crud | inventory_balance |
-| wms.inventory_reservation.created | crud | inventory_reservation |
-| wms.inventory_reservation.updated | crud | inventory_reservation |
-| wms.inventory_reservation.deleted | crud | inventory_reservation |
-| wms.inventory_movement.created | crud | inventory_movement |
-| wms.inventory_movement.updated | crud | inventory_movement |
-| wms.inventory_movement.deleted | crud | inventory_movement |
-| wms.inventory.received | custom | inventory |
-| wms.inventory.adjusted | custom | inventory |
-| wms.inventory.reserved | custom | inventory |
-| wms.inventory.released | custom | inventory |
-| wms.inventory.allocated | custom | inventory |
-| wms.inventory.moved | custom | inventory |
-| wms.inventory.reconciled | custom | inventory |
-| wms.inventory.low_stock | lifecycle | inventory |
-| wms.inventory.balance_drift | lifecycle | inventory |
-| wms.inventory.reservation_shortfall | lifecycle | inventory |
+| ID | Category | Entity | Browser transport |
+|---|---|---|---|
+| wms.warehouse.created | crud | warehouse | — |
+| wms.warehouse.updated | crud | warehouse | — |
+| wms.zone.created | crud | zone | — |
+| wms.zone.updated | crud | zone | — |
+| wms.location.created | crud | location | — |
+| wms.location.updated | crud | location | — |
+| wms.inventory_profile.created | crud | inventory_profile | — |
+| wms.inventory_profile.updated | crud | inventory_profile | — |
+| wms.inventory_balance.created | crud | inventory_balance | — |
+| wms.inventory_balance.updated | crud | inventory_balance | — |
+| wms.inventory_balance.deleted | crud | inventory_balance | — |
+| wms.inventory_reservation.created | crud | inventory_reservation | — |
+| wms.inventory_reservation.updated | crud | inventory_reservation | — |
+| wms.inventory_reservation.deleted | crud | inventory_reservation | — |
+| wms.inventory_movement.created | crud | inventory_movement | — |
+| wms.inventory_movement.updated | crud | inventory_movement | — |
+| wms.inventory_movement.deleted | crud | inventory_movement | — |
+| wms.inventory.received | custom | inventory | — |
+| wms.inventory.adjusted | custom | inventory | — |
+| wms.inventory.reserved | custom | inventory | — |
+| wms.inventory.released | custom | inventory | — |
+| wms.inventory.allocated | custom | inventory | — |
+| wms.inventory.moved | custom | inventory | — |
+| wms.inventory.reconciled | custom | inventory | — |
+| wms.inventory.low_stock | lifecycle | inventory | — |
+| wms.inventory.balance_drift | lifecycle | inventory | — |
+| wms.inventory.reservation_shortfall | lifecycle | inventory | — |
 
 ## ACL features  (10)
 
@@ -88,7 +88,210 @@ _none_
 ## Host extension points
 
 - Entity IDs: _none_
-- Table IDs: wms.config.inventoryProfiles · wms.config.locations · wms.config.warehouses · wms.config.zones · wms.location.activity · wms.location.items · wms.lot.activity · wms.lot.distribution · wms.lots.list · wms.sku.activity · wms.sku.distribution
+- Table IDs: wms.config.inventoryProfiles · wms.config.locations · wms.config.warehouses · wms.config.zones · wms.inventory.balances · wms.inventory.movements · wms.inventory.reservations · wms.location.activity · wms.location.items · wms.lot.activity · wms.lot.distribution · wms.lots.list · wms.sku.activity · wms.sku.distribution
+
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability |
+|---|---|---|---|---|
+| data-table:wms.config.inventoryProfiles | data-table | component-replacement | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.inventoryProfiles:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.config.locations | data-table | component-replacement | — | FROZEN |
+| data-table:wms.config.locations:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.config.locations:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.config.locations:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.config.locations:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.locations:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.locations:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.config.locations:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.locations:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.config.warehouses | data-table | component-replacement | — | FROZEN |
+| data-table:wms.config.warehouses:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.config.warehouses:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.config.warehouses:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.config.warehouses:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.warehouses:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.warehouses:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.config.warehouses:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.warehouses:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.config.zones | data-table | component-replacement | — | FROZEN |
+| data-table:wms.config.zones:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.config.zones:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.config.zones:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.config.zones:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.zones:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.zones:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.config.zones:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.config.zones:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.inventory.balances | data-table | component-replacement | — | FROZEN |
+| data-table:wms.inventory.balances:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.inventory.balances:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.inventory.balances:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.inventory.balances:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.balances:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.balances:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.inventory.balances:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.balances:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.inventory.movements | data-table | component-replacement | — | FROZEN |
+| data-table:wms.inventory.movements:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.inventory.movements:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.inventory.movements:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.inventory.movements:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.movements:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.movements:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.inventory.movements:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.movements:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.inventory.reservations | data-table | component-replacement | — | FROZEN |
+| data-table:wms.inventory.reservations:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.inventory.reservations:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.inventory.reservations:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.inventory.reservations:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.reservations:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.reservations:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.inventory.reservations:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.inventory.reservations:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.location.activity | data-table | component-replacement | — | FROZEN |
+| data-table:wms.location.activity:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.location.activity:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.location.activity:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.location.activity:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.location.activity:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.location.activity:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.location.activity:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.location.activity:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.location.items | data-table | component-replacement | — | FROZEN |
+| data-table:wms.location.items:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.location.items:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.location.items:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.location.items:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.location.items:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.location.items:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.location.items:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.location.items:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.lot.activity | data-table | component-replacement | — | FROZEN |
+| data-table:wms.lot.activity:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.lot.activity:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.lot.activity:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.lot.activity:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.lot.activity:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.lot.activity:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.lot.activity:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.lot.activity:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.lot.distribution | data-table | component-replacement | — | FROZEN |
+| data-table:wms.lot.distribution:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.lot.distribution:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.lot.distribution:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.lot.distribution:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.lot.distribution:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.lot.distribution:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.lot.distribution:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.lot.distribution:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.lots.list | data-table | component-replacement | — | FROZEN |
+| data-table:wms.lots.list:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.lots.list:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.lots.list:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.lots.list:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.lots.list:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.lots.list:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.lots.list:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.lots.list:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.sku.activity | data-table | component-replacement | — | FROZEN |
+| data-table:wms.sku.activity:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.sku.activity:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.sku.activity:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.sku.activity:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.sku.activity:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.sku.activity:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.sku.activity:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.sku.activity:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:wms.sku.distribution | data-table | component-replacement | — | FROZEN |
+| data-table:wms.sku.distribution:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:wms.sku.distribution:columns | data-table | column-widget | — | FROZEN |
+| data-table:wms.sku.distribution:filters | data-table | filter-widget | — | FROZEN |
+| data-table:wms.sku.distribution:footer | data-table | render-widget | — | FROZEN |
+| data-table:wms.sku.distribution:header | data-table | render-widget | — | FROZEN |
+| data-table:wms.sku.distribution:row-actions | data-table | row-action | — | FROZEN |
+| data-table:wms.sku.distribution:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:wms.sku.distribution:toolbar | data-table | toolbar-widget | — | FROZEN |
+| wms:inventory_balance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:inventory_lot | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:inventory_movement | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:inventory_reservation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:product_inventory_profile | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:sales_order_warehouse_assignment | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:warehouse | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:warehouse_location | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms:warehouse_zone | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| wms.inventory | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE |
+| wms.inventory_balance.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_balance.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_balance.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_movement.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_movement.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_movement.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_profile.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_profile.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_reservation.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_reservation.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory_reservation.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.adjusted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.allocated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.balance_drift | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.low_stock | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.moved | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.received | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.reconciled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.released | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.reservation_shortfall | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.inventory.reserved | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.location.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.location.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.warehouse.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.warehouse.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.zone.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| wms.zone.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution |
+|---|---|---|---|---|---|
+| wms.catalog-products.inventory-profile-sync | api-interceptor | catalog/products | before, after | activation=crud-pipeline; failurePosture=fallback; methods=POST,PUT; phases=before,after; route=catalog/products; timeoutMs=2000 | fact-ref |
+| wms.catalog-variants.inventory-profile-sync | api-interceptor | catalog/variants | before, after | activation=crud-pipeline; failurePosture=fallback; methods=POST,PUT; phases=before,after; route=catalog/variants; timeoutMs=2000 | fact-ref |
+| wms.injection.catalog-inventory-profile@crud-form:catalog.catalog_product_variant:fields | crud-form | crud-form:catalog.catalog_product_variant:fields | — | entityId=catalog.catalog_product_variant; payload=field; requestHeaderCapability=true | framework |
+| wms.injection.catalog-inventory-profile@crud-form:catalog.product:fields | crud-form | crud-form:catalog.product:fields | — | entityId=catalog.product; payload=field; requestHeaderCapability=true | exact |
+| wms.catalog-product-inventory | response-enricher | catalog:catalog_product | list, detail | cachePosture=rerun-on-list-cache-hit; critical=false; fallback=configured; surfaces=list,detail; targetEntity=catalog:catalog_product; timeoutMs=2000 | fact-ref |
+| wms.catalog-variant-inventory | response-enricher | catalog:catalog_product_variant | list, detail | cachePosture=rerun-on-list-cache-hit; critical=false; fallback=configured; surfaces=list,detail; targetEntity=catalog:catalog_product_variant; timeoutMs=2000 | fact-ref |
+| wms.sales-order-inventory | response-enricher | sales:sales_order | list, detail | cachePosture=rerun-on-list-cache-hit; critical=false; fallback=configured; surfaces=list,detail; targetEntity=sales:sales_order; timeoutMs=2000 | fact-ref |
+| notification:wms.inventory.low_stock | specialized-registry | wms.inventory.low_stock | — | registry=notification; registryId=wms.inventory.low_stock; specialistRoute=notifications | fact-ref |
+| notification:wms.inventory.reservation_shortfall | specialized-registry | wms.inventory.reservation_shortfall | — | registry=notification; registryId=wms.inventory.reservation_shortfall; specialistRoute=notifications | fact-ref |
+| wms:low-stock-notification | subscriber | wms.inventory.low_stock | async-delivery | event=wms.inventory.low_stock; persistent=true; subscriberId=wms:low-stock-notification; sync=false | fact-ref |
+| wms:reservation-shortfall-notification | subscriber | wms.inventory.reservation_shortfall | async-delivery | event=wms.inventory.reservation_shortfall; persistent=true; subscriberId=wms:reservation-shortfall-notification; sync=false | fact-ref |
+| wms:sales-order-cancelled-release | subscriber | sales.order.cancelled | async-delivery | event=sales.order.cancelled; persistent=true; subscriberId=wms:sales-order-cancelled-release; sync=false | fact-ref |
+| wms:sales-order-confirmed-reserve | subscriber | sales.order.confirmed | async-delivery | event=sales.order.confirmed; persistent=true; subscriberId=wms:sales-order-confirmed-reserve; sync=false | fact-ref |
+
+## UMES diagnostics
+
+- unbound-helper: data-table:wms.config.inventoryProfiles:empty-state
+- unbound-helper: data-table:wms.config.locations:empty-state
+- unbound-helper: data-table:wms.config.warehouses:empty-state
+- unbound-helper: data-table:wms.config.zones:empty-state
+- unbound-helper: data-table:wms.inventory.balances:empty-state
+- unbound-helper: data-table:wms.inventory.movements:empty-state
+- unbound-helper: data-table:wms.inventory.reservations:empty-state
+- unbound-helper: data-table:wms.location.activity:empty-state
+- unbound-helper: data-table:wms.location.items:empty-state
+- unbound-helper: data-table:wms.lot.activity:empty-state
+- unbound-helper: data-table:wms.lot.distribution:empty-state
+- unbound-helper: data-table:wms.lots.list:empty-state
+- unbound-helper: data-table:wms.sku.activity:empty-state
+- unbound-helper: data-table:wms.sku.distribution:empty-state
 
 ## Notifications
 

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

@@ -1,5 +1,5 @@
 # workflows — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6756.1.5300c41145; core 0.6.7-develop.6756.1.5300c41145 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6766.1.40c9011995; core 0.6.7-develop.6766.1.40c9011995 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/workflows](../../../node_modules/@open-mercato/core/src/modules/workflows)
 
 ## Entities
@@ -14,35 +14,36 @@ Source root: [node_modules/@open-mercato/core/src/modules/workflows](../../../no
 | workflows:workflow_event | WorkflowEvent | workflow_events | no | no |
 | workflows:workflow_event_trigger | WorkflowEventTrigger | workflow_event_triggers | yes | no |
 
-## Events  (25)
-
-| 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 |
+## Events  (26)
+
+| ID | Category | Entity | Browser transport |
+|---|---|---|---|
+| 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.task.assigned | lifecycle | task | — |
+| 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)
 
@@ -86,6 +87,89 @@ _none_
 - Entity IDs: _none_
 - Table IDs: workflows.definitions.list · workflows.instances.list · workflows.tasks.list
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability |
+|---|---|---|---|---|
+| data-table:workflows.definitions.list | data-table | component-replacement | — | FROZEN |
+| data-table:workflows.definitions.list:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:workflows.definitions.list:columns | data-table | column-widget | — | FROZEN |
+| data-table:workflows.definitions.list:filters | data-table | filter-widget | — | FROZEN |
+| data-table:workflows.definitions.list:footer | data-table | render-widget | — | FROZEN |
+| data-table:workflows.definitions.list:header | data-table | render-widget | — | FROZEN |
+| data-table:workflows.definitions.list:row-actions | data-table | row-action | — | FROZEN |
+| data-table:workflows.definitions.list:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:workflows.definitions.list:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:workflows.instances.list | data-table | component-replacement | — | FROZEN |
+| data-table:workflows.instances.list:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:workflows.instances.list:columns | data-table | column-widget | — | FROZEN |
+| data-table:workflows.instances.list:filters | data-table | filter-widget | — | FROZEN |
+| data-table:workflows.instances.list:footer | data-table | render-widget | — | FROZEN |
+| data-table:workflows.instances.list:header | data-table | render-widget | — | FROZEN |
+| data-table:workflows.instances.list:row-actions | data-table | row-action | — | FROZEN |
+| data-table:workflows.instances.list:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:workflows.instances.list:toolbar | data-table | toolbar-widget | — | FROZEN |
+| data-table:workflows.tasks.list | data-table | component-replacement | — | FROZEN |
+| data-table:workflows.tasks.list:bulk-actions | data-table | bulk-action | — | FROZEN |
+| data-table:workflows.tasks.list:columns | data-table | column-widget | — | FROZEN |
+| data-table:workflows.tasks.list:filters | data-table | filter-widget | — | FROZEN |
+| data-table:workflows.tasks.list:footer | data-table | render-widget | — | FROZEN |
+| data-table:workflows.tasks.list:header | data-table | render-widget | — | FROZEN |
+| data-table:workflows.tasks.list:row-actions | data-table | row-action | — | FROZEN |
+| data-table:workflows.tasks.list:search-trailing | data-table | render-widget | — | FROZEN |
+| data-table:workflows.tasks.list:toolbar | data-table | toolbar-widget | — | FROZEN |
+| workflows:step_instance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows:user_task | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows:workflow_branch_instance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows:workflow_definition | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows:workflow_event | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows:workflow_event_trigger | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows:workflow_instance | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| workflows.definition | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE |
+| workflows.activity.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.activity.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.activity.started | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.branch.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.branch.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.branch.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.branch.opened | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.definition.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.definition.customized | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.definition.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.definition.reset_to_code | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.definition.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.paused | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.resumed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.started | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.instance.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.join.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.task.assigned | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.trigger.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.trigger.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| workflows.trigger.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution |
+|---|---|---|---|---|---|
+| notification:workflows.task.assigned | specialized-registry | workflows.task.assigned | — | registry=notification; registryId=workflows.task.assigned; specialistRoute=notifications | fact-ref |
+| workflow:workflows.checkout-demo | specialized-registry | workflows.checkout-demo | — | registry=workflow; registryId=workflows.checkout-demo; specialistRoute=workflows | fact-ref |
+| workflow:workflows.simple-approval | specialized-registry | workflows.simple-approval | — | registry=workflow; registryId=workflows.simple-approval; specialistRoute=workflows | fact-ref |
+| workflows:event-trigger | subscriber | * | async-delivery | event=*; persistent=true; subscriberId=workflows:event-trigger; sync=false | pattern |
+| 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 |
+| 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 |
+
+## 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
 
 workflows.task.assigned

package/dist/agentic/guides/upstream/BACKWARD_COMPATIBILITY.md

@@ -26,6 +26,7 @@ The following file names, their expected export names, and their role in module
 | `ce.ts` | `entities: CustomEntitySpec[]` | MUST NOT change `CustomEntitySpec` required fields; may add optional fields |
 | `search.ts` | `searchConfig: SearchModuleConfig` | MUST NOT change `SearchEntityConfig` required fields; may add optional fields |
 | `events.ts` | `eventsConfig` via `createModuleEvents()` | MUST NOT change `EventDefinition` required fields (`id`, `label`); may add optional fields |
+| `extension-points.ts` | `extensionPoints: ModuleExtensionPoints` | New additive convention; declared exact/pattern host IDs, aliases, fallbacks, family/capability semantics, and bound call-site meaning MUST NOT change incompatibly |
 | `translations.ts` | `translatableFields` | MUST NOT change record shape |
 | `notifications.ts` | `notificationTypes: NotificationTypeDefinition[]` | MUST NOT change required fields; may add optional fields |
 | `notifications.client.ts` | — | MUST NOT change renderer props contract |
@@ -63,6 +64,8 @@ These exported types are consumed by module developers. Required fields MUST NOT
 - `EventDefinition`: `id`, `label` — MUST NOT remove; `category`, `module`, `entity`, `description` — MUST NOT remove
 - `EventPayload`: `id`, `tenantId`, `organizationId` — MUST NOT remove
 - `EntityExtension`: `base`, `extension`, `join` — MUST NOT remove
+- `ModuleExtensionPoints`: `moduleId`, `hosts` — MUST NOT remove; host declaration discriminants and exact/pattern address semantics are STABLE, and new optional metadata/capabilities may be added
+- `ModuleExtensionSurfaceFacts`: `hosts`, `contributions`, `unresolved` — MUST NOT remove; host IDs/patterns, contribution identities/targets, resolution classes, activation/phases/operations, scope contracts, round-trip IDs, override identities, and sanitized unresolved provenance MUST retain their meaning
 - `CustomFieldDefinition`: `key`, `kind` — MUST NOT remove; all other fields remain optional
 - `CustomEntitySpec`: `id` — MUST NOT remove
 - `InjectionWidgetMetadata`: `id`, `title` — MUST NOT remove
@@ -97,6 +100,8 @@ These functions are called directly by module code. Their signatures MUST NOT ch
 | `findAndCountWithDecryption(...)` | `@open-mercato/shared/lib/encryption/find` | Same as above |
 | `entityId(moduleId, entity)` | `@open-mercato/shared/modules/dsl` | MUST NOT change |
 | `defineLink(base, extension, opts)` | `@open-mercato/shared/modules/dsl` | MUST NOT change |
+| `defineModuleExtensionPoints(declaration)` | `@open-mercato/shared/modules/widgets/extension-points` | MUST preserve immutable data-only declaration semantics and exact module/host values |
+| `injectionExtensionHost`, `dataTableExtensionHost`, `crudFormExtensionHost`, `componentExtensionHost` | `@open-mercato/shared/modules/widgets/extension-points` | MUST preserve family discrimination, exact/pattern validation, and returned IDs |
 | `defineFields(entity, fields, source?)` | `@open-mercato/shared/modules/dsl` | MUST NOT change |
 | `cf.text`, `cf.multiline`, `cf.integer`, `cf.float`, `cf.boolean`, `cf.select`, `cf.currency`, `cf.dictionary` | `@open-mercato/shared/modules/dsl` | MUST NOT remove any helper or change required params |
 | `lazyDashboardWidget(loader)` | `@open-mercato/shared/modules/dashboard/widgets` | MUST NOT change |
@@ -244,6 +249,8 @@ Files in `apps/mercato/.mercato/generated/` are produced by the CLI generators.
 - MUST NOT change generated AI entry shapes: agent entries keep `{ moduleId, agents, overrides, extensions }`; tool entries keep `{ moduleId, tools, overrides }`
 - MAY add new generated files and new optional fields to `BootstrapData`
 - MAY add new generated AI registry exports additively
+- Generated `.ai/guides/module-facts.json` keeps its existing top-level module record and legacy sections; optional per-module `extensionSurfaces` is ADDITIVE. Its `hosts`, `contributions`, and `unresolved` arrays, correlation-resolution values, and exact public IDs are STABLE once published.
+- Generated `.ai/guides/framework-extension-points.md` is a sibling framework-owned catalog, not a synthetic module-facts key. Existing module Markdown headings, including `Host extension points`, MUST remain available; additive `UMES hosts`/`UMES contributions` sections may not redefine existing IDs.
 
 ---
 

package/dist/agentic/guides/upstream/manifest.json

@@ -1,8 +1,8 @@
 {
   "version": 1,
-  "generator": "@open-mercato/cli@0.6.7-develop.6756.1.5300c41145",
+  "generator": "@open-mercato/cli@0.6.7-develop.6766.1.40c9011995",
   "files": {
     "AGENTS.md": "7dd1e874d8abf251d891b0341d8e05fb5bb7724f2fbfb2b3aaa36d23b8188e28",
-    "BACKWARD_COMPATIBILITY.md": "80ee9c270b6b763e14f9f16922396b6415409ec6a0416a45cf75514677a7c205"
+    "BACKWARD_COMPATIBILITY.md": "692d6402e8d0d85bd1885558e7f164a4621c0b899a0a802136da5a137b83747c"
   }
 }