@open-mercato/cli 0.6.7 → 0.6.8-develop.6875.1.871a4afc94

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

@@ -1,13 +1,14 @@
 # dashboards — 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-develop.6875.1.871a4afc94; core 0.6.8-develop.6875.1.871a4afc94 — R1 staleness stamp -->
+Source root: [node_modules/@open-mercato/core/src/modules/dashboards](../../../node_modules/@open-mercato/core/src/modules/dashboards)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| dashboards:dashboard_layout | DashboardLayout | dashboard_layouts | yes | no |
-| dashboards:dashboard_role_widgets | DashboardRoleWidgets | dashboard_role_widgets | yes | no |
-| dashboards:dashboard_user_widgets | DashboardUserWidgets | dashboard_user_widgets | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| dashboards:dashboard_layout | DashboardLayout | dashboard_layouts | yes | no | [node_modules/@open-mercato/core/src/modules/dashboards/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/data/entities.ts) |
+| dashboards:dashboard_role_widgets | DashboardRoleWidgets | dashboard_role_widgets | yes | no | [node_modules/@open-mercato/core/src/modules/dashboards/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/data/entities.ts) |
+| dashboards:dashboard_user_widgets | DashboardUserWidgets | dashboard_user_widgets | yes | no | [node_modules/@open-mercato/core/src/modules/dashboards/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/data/entities.ts) |
 
 ## Events  (0)
 
@@ -15,15 +16,30 @@ _none_
 
 ## ACL features  (4)
 
-dashboards.view · dashboards.configure · dashboards.admin.assign-widgets · analytics.view
+| Feature | Source |
+|---|---|
+| dashboards.view | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| dashboards.configure | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| dashboards.admin.assign-widgets | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| analytics.view | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
 
 ## API routes
 
 _none_
 
+## Backend pages
+
+_none_
+
+## Frontend pages
+
+_none_
+
 ## DI service tokens
 
-analyticsRegistry
+| Token | Source |
+|---|---|
+| analyticsRegistry | [node_modules/@open-mercato/core/src/modules/dashboards/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/dashboards/di.ts#L7) |
 
 ## Search entities
 
@@ -34,10 +50,139 @@ _none_
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| dashboards:dashboard_layout | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:dashboards:dashboard_layout |
+| dashboards:dashboard_role_widgets | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:dashboards:dashboard_role_widgets |
+| dashboards:dashboard_user_widgets | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:dashboards:dashboard_user_widgets |
+| dashboards.layout | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/dashboards/api/layout/[itemId]/route.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/layout/[itemId]/route.ts) |
+| dashboards.roleWidgets | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/dashboards/api/roles/widgets/route.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/roles/widgets/route.ts) |
+| dashboards.userWidgets | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/dashboards/api/users/widgets/route.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/users/widgets/route.ts) |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| dashboards:invalidate-widget-data-on-currency-change | subscriber | currencies.currency.* | before-or-after | event=currencies.currency.*; persistent=false; subscriberId=dashboards:invalidate-widget-data-on-currency-change; sync=true | pattern | [node_modules/@open-mercato/core/src/modules/dashboards/subscribers/invalidateWidgetDataCache.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/subscribers/invalidateWidgetDataCache.ts) |
+| dashboard:dashboards.analytics.aovKpi | widget | dashboard:dashboards.analytics.aovKpi | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.aovKpi | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts) |
+| dashboard:dashboards.analytics.newCustomersKpi | widget | dashboard:dashboards.analytics.newCustomersKpi | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.newCustomersKpi | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.ts) |
+| dashboard:dashboards.analytics.ordersByStatus | widget | dashboard:dashboards.analytics.ordersByStatus | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.ordersByStatus | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.ts) |
+| dashboard:dashboards.analytics.ordersKpi | widget | dashboard:dashboards.analytics.ordersKpi | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.ordersKpi | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.ts) |
+| dashboard:dashboards.analytics.pipelineSummary | widget | dashboard:dashboards.analytics.pipelineSummary | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.pipelineSummary | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.ts) |
+| dashboard:dashboards.analytics.revenueKpi | widget | dashboard:dashboards.analytics.revenueKpi | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.revenueKpi | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.ts) |
+| dashboard:dashboards.analytics.revenueTrend | widget | dashboard:dashboards.analytics.revenueTrend | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.revenueTrend | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.ts) |
+| dashboard:dashboards.analytics.salesByRegion | widget | dashboard:dashboards.analytics.salesByRegion | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.salesByRegion | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.ts) |
+| dashboard:dashboards.analytics.topCustomers | widget | dashboard:dashboards.analytics.topCustomers | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.topCustomers | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-customers/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-customers/widget.ts) |
+| dashboard:dashboards.analytics.topProducts | widget | dashboard:dashboards.analytics.topProducts | — | executionGuard=both; payload=dashboard; registryKey=dashboards.analytics.topProducts | framework | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-products/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-products/widget.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| api-route:dashboards/widgets/data:POST:api-interceptor-bridge | api-interceptor-bridge | api-route:dashboards/widgets/data POST @dashboards | api-interceptor | before | apiRoutes:/dashboards/widgets/data | [node_modules/@open-mercato/core/src/modules/dashboards/api/widgets/data/route.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/widgets/data/route.ts) |
+| entity:dashboards.layout:mutation-guard | mutation-guard | entity:dashboards.layout @dashboards | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/dashboards/api/layout/[itemId]/route.ts:66](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/layout/[itemId]/route.ts#L66) |
+| entity:dashboards.roleWidgets:mutation-guard | mutation-guard | entity:dashboards.roleWidgets @dashboards | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/dashboards/api/roles/widgets/route.ts:153](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/roles/widgets/route.ts#L153) |
+| entity:dashboards.userWidgets:mutation-guard | mutation-guard | entity:dashboards.userWidgets @dashboards | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/dashboards/api/users/widgets/route.ts:153](../../../node_modules/@open-mercato/core/src/modules/dashboards/api/users/widgets/route.ts#L153) |
+| widget-spot:dashboard:dashboards.analytics.aovKpi:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.aovKpi @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.newCustomersKpi:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.newCustomersKpi @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.ordersByStatus:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.ordersByStatus @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.ordersKpi:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.ordersKpi @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.pipelineSummary:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.pipelineSummary @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.revenueKpi:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.revenueKpi @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.revenueTrend:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.revenueTrend @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.salesByRegion:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.salesByRegion @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.topCustomers:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.topCustomers @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+| widget-spot:dashboard:dashboards.analytics.topProducts:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:dashboards.analytics.topProducts @framework | widget | — | hosts:framework.dashboard | [packages/ui/src](../../../packages/ui/src) |
+
+## Incoming installed contributions
+
+| Contributor | Kind | Target | Resolution | Activation | Contribution · Source |
+|---|---|---|---|---|---|
+| staff | api-interceptor | api-route:dashboards/widgets/data @dashboards | bound | api-route:dashboards/widgets/data:POST:api-interceptor-bridge | staff.timesheets.self-scope-widget-data · [node_modules/@open-mercato/core/src/modules/staff/api/interceptors.ts](../../../node_modules/@open-mercato/core/src/modules/staff/api/interceptors.ts) |
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| dashboard:dashboards.analytics.aovKpi | widget-spot:dashboard:dashboards.analytics.aovKpi | bound | widget-spot:dashboard:dashboards.analytics.aovKpi:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts) |
+| dashboard:dashboards.analytics.newCustomersKpi | widget-spot:dashboard:dashboards.analytics.newCustomersKpi | bound | widget-spot:dashboard:dashboards.analytics.newCustomersKpi:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.ts) |
+| dashboard:dashboards.analytics.ordersByStatus | widget-spot:dashboard:dashboards.analytics.ordersByStatus | bound | widget-spot:dashboard:dashboards.analytics.ordersByStatus:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.ts) |
+| dashboard:dashboards.analytics.ordersKpi | widget-spot:dashboard:dashboards.analytics.ordersKpi | bound | widget-spot:dashboard:dashboards.analytics.ordersKpi:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.ts) |
+| dashboard:dashboards.analytics.pipelineSummary | widget-spot:dashboard:dashboards.analytics.pipelineSummary | bound | widget-spot:dashboard:dashboards.analytics.pipelineSummary:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.ts) |
+| dashboard:dashboards.analytics.revenueKpi | widget-spot:dashboard:dashboards.analytics.revenueKpi | bound | widget-spot:dashboard:dashboards.analytics.revenueKpi:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.ts) |
+| dashboard:dashboards.analytics.revenueTrend | widget-spot:dashboard:dashboards.analytics.revenueTrend | bound | widget-spot:dashboard:dashboards.analytics.revenueTrend:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.ts) |
+| dashboard:dashboards.analytics.salesByRegion | widget-spot:dashboard:dashboards.analytics.salesByRegion | bound | widget-spot:dashboard:dashboards.analytics.salesByRegion:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.ts) |
+| dashboard:dashboards.analytics.topCustomers | widget-spot:dashboard:dashboards.analytics.topCustomers | bound | widget-spot:dashboard:dashboards.analytics.topCustomers:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-customers/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-customers/widget.ts) |
+| dashboard:dashboards.analytics.topProducts | widget-spot:dashboard:dashboards.analytics.topProducts | bound | widget-spot:dashboard:dashboards.analytics.topProducts:dashboard-host-consumer | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-products/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-products/widget.ts) |
+| dashboards:invalidate-widget-data-on-currency-change | wildcard:currencies.currency.* | wildcard | — | [node_modules/@open-mercato/core/src/modules/dashboards/subscribers/invalidateWidgetDataCache.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/subscribers/invalidateWidgetDataCache.ts) |
+
+
+
 ## Notifications
 
 _none_
 
-## CLI
+## CLI commands
+
+| ID / path | Source |
+|---|---|
+| seed-defaults | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| enable-analytics-widgets | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| seed-analytics | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| debug-analytics | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+
+## AI tools / MCP capabilities
+
+_none_
+
+## AI agents
+
+_none_
 
-seed-defaults · enable-analytics-widgets · seed-analytics · debug-analytics
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["analytics.view"]` | disable-replace | aclFeatures:analytics.view | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| acl | `overrides.acl.features["dashboards.admin.assign-widgets"]` | disable-replace | aclFeatures:dashboards.admin.assign-widgets | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| acl | `overrides.acl.features["dashboards.configure"]` | disable-replace | aclFeatures:dashboards.configure | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| acl | `overrides.acl.features["dashboards.view"]` | disable-replace | aclFeatures:dashboards.view | [node_modules/@open-mercato/core/src/modules/dashboards/acl.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/acl.ts) |
+| cli | `overrides.cli["debug-analytics"]` | disable-replace | cliCommands:debug-analytics | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| cli | `overrides.cli["enable-analytics-widgets"]` | disable-replace | cliCommands:enable-analytics-widgets | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| cli | `overrides.cli["seed-analytics"]` | disable-replace | cliCommands:seed-analytics | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| cli | `overrides.cli["seed-defaults"]` | disable-replace | cliCommands:seed-defaults | [node_modules/@open-mercato/core/src/modules/dashboards/cli.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/cli.ts) |
+| di | `overrides.di["analyticsRegistry"]` | disable-replace | ownedContracts.di-registration:analyticsRegistry | [node_modules/@open-mercato/core/src/modules/dashboards/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/dashboards/di.ts#L7) |
+| events | `overrides.events.subscribers["dashboards:invalidate-widget-data-on-currency-change"]` | disable-replace | extensionSurfaces.contributions:dashboards:invalidate-widget-data-on-currency-change | [node_modules/@open-mercato/core/src/modules/dashboards/subscribers/invalidateWidgetDataCache.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/subscribers/invalidateWidgetDataCache.ts) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:dashboards:setup | [node_modules/@open-mercato/core/src/modules/dashboards/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/dashboards/setup.ts#L5) |
+| setup | `overrides.setup.onTenantCreated` | replace | ownedContracts.setup:dashboards:setup | [node_modules/@open-mercato/core/src/modules/dashboards/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/dashboards/setup.ts#L5) |
+| setup | `overrides.setup.seedDefaults` | replace | ownedContracts.setup:dashboards:setup | [node_modules/@open-mercato/core/src/modules/dashboards/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/dashboards/setup.ts#L5) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.aovKpi"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.aovKpi | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/aov-kpi/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.newCustomersKpi"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.newCustomersKpi | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/new-customers-kpi/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.ordersByStatus"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.ordersByStatus | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-by-status/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.ordersKpi"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.ordersKpi | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/orders-kpi/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.pipelineSummary"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.pipelineSummary | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/pipeline-summary/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.revenueKpi"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.revenueKpi | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-kpi/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.revenueTrend"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.revenueTrend | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/revenue-trend/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.salesByRegion"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.salesByRegion | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/sales-by-region/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.topCustomers"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.topCustomers | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-customers/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-customers/widget.ts) |
+| widgets | `overrides.widgets.dashboard["dashboards.analytics.topProducts"]` | disable-replace | extensionSurfaces.contributions:dashboard:dashboards.analytics.topProducts | [node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-products/widget.ts](../../../node_modules/@open-mercato/core/src/modules/dashboards/widgets/dashboard/top-products/widget.ts) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| dashboards | name=dashboards; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/dashboards/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/dashboards/index.ts#L3) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| dashboards:setup | hooks=onTenantCreated, seedDefaults; roles=admin, employee | [node_modules/@open-mercato/core/src/modules/dashboards/setup.ts:5](../../../node_modules/@open-mercato/core/src/modules/dashboards/setup.ts#L5) |
+
+## DI registrations (rich)
+
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| analyticsRegistry | function | singleton | — | — | [node_modules/@open-mercato/core/src/modules/dashboards/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/dashboards/di.ts#L7) |

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

@@ -1,35 +1,56 @@
 # data_sync — 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-develop.6875.1.871a4afc94; core 0.6.8-develop.6875.1.871a4afc94 — R1 staleness stamp -->
+Source root: [node_modules/@open-mercato/core/src/modules/data_sync](../../../node_modules/@open-mercato/core/src/modules/data_sync)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| data_sync:sync_run | SyncRun | sync_runs | yes | no |
-| data_sync:sync_cursor | SyncCursor | sync_cursors | yes | no |
-| data_sync:sync_mapping | SyncMapping | sync_mappings | yes | no |
-| data_sync:sync_schedule | SyncSchedule | sync_schedules | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| data_sync:sync_run | SyncRun | sync_runs | yes | no | [node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts) |
+| data_sync:sync_cursor | SyncCursor | sync_cursors | yes | no | [node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts) |
+| data_sync:sync_mapping | SyncMapping | sync_mappings | yes | no | [node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts) |
+| data_sync:sync_schedule | SyncSchedule | sync_schedules | yes | no | [node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/data/entities.ts) |
 
 ## Events  (4)
 
-| ID | Category | Entity |
-|---|---|---|
-| data_sync.run.started | lifecycle | run |
-| data_sync.run.completed | lifecycle | run |
-| data_sync.run.failed | lifecycle | run |
-| data_sync.run.cancelled | lifecycle | run |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| data_sync.run.started | lifecycle | run | — | [node_modules/@open-mercato/core/src/modules/data_sync/events.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/events.ts) |
+| data_sync.run.completed | lifecycle | run | — | [node_modules/@open-mercato/core/src/modules/data_sync/events.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/events.ts) |
+| data_sync.run.failed | lifecycle | run | — | [node_modules/@open-mercato/core/src/modules/data_sync/events.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/events.ts) |
+| data_sync.run.cancelled | lifecycle | run | — | [node_modules/@open-mercato/core/src/modules/data_sync/events.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/events.ts) |
 
 ## ACL features  (3)
 
-data_sync.view · data_sync.run · data_sync.configure
+| Feature | Source |
+|---|---|
+| data_sync.view | [node_modules/@open-mercato/core/src/modules/data_sync/acl.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/acl.ts) |
+| data_sync.run | [node_modules/@open-mercato/core/src/modules/data_sync/acl.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/acl.ts) |
+| data_sync.configure | [node_modules/@open-mercato/core/src/modules/data_sync/acl.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/acl.ts) |
 
 ## API routes
 
 _none_
 
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/data-sync | [node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/page.tsx](../../../node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/page.tsx) |
+| /backend/data-sync/runs/[id] | [node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/runs/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/runs/[id]/page.tsx) |
+
+## Frontend pages
+
+_none_
+
 ## DI service tokens
 
-externalIdMappingService · dataSyncRunService · dataSyncScheduleService · dataSyncEngine
+| Token | Source |
+|---|---|
+| externalIdMappingService | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:28](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L28) |
+| dataSyncRunService | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:29](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L29) |
+| dataSyncScheduleService | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:30](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L30) |
+| dataSyncEngine | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:31](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L31) |
 
 ## Search entities
 
@@ -40,10 +61,122 @@ _none_
 - Entity IDs: _none_
 - Table IDs: data_sync.runs
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| data-table:data_sync.runs | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data-table:data_sync.runs:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/extension-points.ts) |
+| data_sync:sync_cursor | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:data_sync:sync_cursor |
+| data_sync:sync_mapping | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:data_sync:sync_mapping |
+| data_sync:sync_run | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:data_sync:sync_run |
+| data_sync:sync_schedule | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:data_sync:sync_schedule |
+| data_sync.mapping | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/data_sync/api/mappings/[id]/route.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/api/mappings/[id]/route.ts) |
+| data_sync.run | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/data_sync/api/run.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/api/run.ts) |
+| data_sync.schedule | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/data_sync/api/schedules/[id]/route.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/api/schedules/[id]/route.ts) |
+| data_sync.run.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:data_sync.run.cancelled |
+| data_sync.run.completed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:data_sync.run.completed |
+| data_sync.run.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:data_sync.run.failed |
+| data_sync.run.started | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:data_sync.run.started |
+
+## UMES contributions
+
+_none_
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| entity:data_sync.mapping:mutation-guard | mutation-guard | entity:data_sync.mapping @data_sync | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/api/mappings/[id]/route.ts:124](../../../node_modules/@open-mercato/core/src/modules/data_sync/api/mappings/[id]/route.ts#L124) |
+| entity:data_sync.run:mutation-guard | mutation-guard | entity:data_sync.run @data_sync | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/api/run.ts:95](../../../node_modules/@open-mercato/core/src/modules/data_sync/api/run.ts#L95) |
+| entity:data_sync.schedule:mutation-guard | mutation-guard | entity:data_sync.schedule @data_sync | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/api/schedules/[id]/route.ts:99](../../../node_modules/@open-mercato/core/src/modules/data_sync/api/schedules/[id]/route.ts#L99) |
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
+## UMES diagnostics
+
+- unbound-helper: data-table:data_sync.runs:empty-state
+
 ## 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["data_sync.configure"]` | disable-replace | aclFeatures:data_sync.configure | [node_modules/@open-mercato/core/src/modules/data_sync/acl.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/acl.ts) |
+| acl | `overrides.acl.features["data_sync.run"]` | disable-replace | aclFeatures:data_sync.run | [node_modules/@open-mercato/core/src/modules/data_sync/acl.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/acl.ts) |
+| acl | `overrides.acl.features["data_sync.view"]` | disable-replace | aclFeatures:data_sync.view | [node_modules/@open-mercato/core/src/modules/data_sync/acl.ts](../../../node_modules/@open-mercato/core/src/modules/data_sync/acl.ts) |
+| di | `overrides.di["dataSyncEngine"]` | disable-replace | ownedContracts.di-registration:dataSyncEngine | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:31](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L31) |
+| di | `overrides.di["dataSyncRunService"]` | disable-replace | ownedContracts.di-registration:dataSyncRunService | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:29](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L29) |
+| di | `overrides.di["dataSyncScheduleService"]` | disable-replace | ownedContracts.di-registration:dataSyncScheduleService | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:30](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L30) |
+| di | `overrides.di["externalIdMappingService"]` | disable-replace | ownedContracts.di-registration:externalIdMappingService | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:28](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L28) |
+| di | `overrides.di["SyncCursor"]` | disable-replace | ownedContracts.di-registration:SyncCursor | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:43](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L43) |
+| di | `overrides.di["SyncMapping"]` | disable-replace | ownedContracts.di-registration:SyncMapping | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:44](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L44) |
+| di | `overrides.di["SyncRun"]` | disable-replace | ownedContracts.di-registration:SyncRun | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:42](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L42) |
+| di | `overrides.di["SyncSchedule"]` | disable-replace | ownedContracts.di-registration:SyncSchedule | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:45](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L45) |
+| routes | `overrides.routes.pages["backend:/backend/data-sync"]` | disable-replace | backendPages:/backend/data-sync | [node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/page.tsx](../../../node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/data-sync/runs/[id]"]` | disable-replace | backendPages:/backend/data-sync/runs/[id] | [node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/runs/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/data_sync/backend/data-sync/runs/[id]/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:data_sync:setup | [node_modules/@open-mercato/core/src/modules/data_sync/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/data_sync/setup.ts#L3) |
+| workers | `overrides.workers["data-sync:export"]` | disable-replace | ownedContracts.worker:data-sync:export | [node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-export.ts:24](../../../node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-export.ts#L24) |
+| workers | `overrides.workers["data-sync:import"]` | disable-replace | ownedContracts.worker:data-sync:import | [node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-import.ts:24](../../../node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-import.ts#L24) |
+| workers | `overrides.workers["data-sync:scheduled"]` | disable-replace | ownedContracts.worker:data-sync:scheduled | [node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-scheduled.ts:18](../../../node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-scheduled.ts#L18) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| data_sync | — | [node_modules/@open-mercato/core/src/modules/data_sync/index.ts:1](../../../node_modules/@open-mercato/core/src/modules/data_sync/index.ts#L1) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| data-sync:export | concurrency=5 | [node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-export.ts:24](../../../node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-export.ts#L24) |
+| data-sync:import | concurrency=5 | [node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-import.ts:24](../../../node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-import.ts#L24) |
+| data-sync:scheduled | concurrency=3; queue=data-sync-scheduled | [node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-scheduled.ts:18](../../../node_modules/@open-mercato/core/src/modules/data_sync/workers/sync-scheduled.ts#L18) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| data_sync:setup | roles=admin, employee, superadmin | [node_modules/@open-mercato/core/src/modules/data_sync/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/data_sync/setup.ts#L3) |
+
+## DI registrations (rich)
+
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| dataSyncEngine | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:31](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L31) |
+| dataSyncRunService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:29](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L29) |
+| dataSyncScheduleService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:30](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L30) |
+| externalIdMappingService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:28](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L28) |
+| SyncCursor | value | — | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:43](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L43) |
+| SyncMapping | value | — | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:44](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L44) |
+| SyncRun | value | — | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:42](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L42) |
+| SyncSchedule | value | — | — | — | [node_modules/@open-mercato/core/src/modules/data_sync/di.ts:45](../../../node_modules/@open-mercato/core/src/modules/data_sync/di.ts#L45) |

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

@@ -0,0 +1,102 @@
+# design_system — module facts (generated, do not edit)
+<!-- generated from @open-mercato/core 0.6.8-develop.6875.1.871a4afc94; core 0.6.8-develop.6875.1.871a4afc94 — R1 staleness stamp -->
+Source root: [node_modules/@open-mercato/core/src/modules/design_system](../../../node_modules/@open-mercato/core/src/modules/design_system)
+
+## Entities
+
+_none_
+
+## Events  (0)
+
+_none_
+
+## ACL features  (1)
+
+| Feature | Source |
+|---|---|
+| design_system.view | [node_modules/@open-mercato/core/src/modules/design_system/acl.ts](../../../node_modules/@open-mercato/core/src/modules/design_system/acl.ts) |
+
+## API routes
+
+_none_
+
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/design-system | [node_modules/@open-mercato/core/src/modules/design_system/backend/design-system/page.tsx](../../../node_modules/@open-mercato/core/src/modules/design_system/backend/design-system/page.tsx) |
+
+## Frontend pages
+
+_none_
+
+## DI service tokens
+
+_none_
+
+## Search entities
+
+_none_
+
+## Host extension points
+
+- Entity IDs: _none_
+- Table IDs: _none_
+
+## UMES hosts
+
+_none_
+
+## UMES contributions
+
+_none_
+
+## Active extension bindings
+
+_none_
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
+
+
+## Notifications
+
+_none_
+
+## 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["design_system.view"]` | disable-replace | aclFeatures:design_system.view | [node_modules/@open-mercato/core/src/modules/design_system/acl.ts](../../../node_modules/@open-mercato/core/src/modules/design_system/acl.ts) |
+| routes | `overrides.routes.pages["backend:/backend/design-system"]` | disable-replace | backendPages:/backend/design-system | [node_modules/@open-mercato/core/src/modules/design_system/backend/design-system/page.tsx](../../../node_modules/@open-mercato/core/src/modules/design_system/backend/design-system/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:design_system:setup | [node_modules/@open-mercato/core/src/modules/design_system/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/design_system/setup.ts#L3) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| design_system | name=design_system | [node_modules/@open-mercato/core/src/modules/design_system/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/design_system/index.ts#L3) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| design_system:setup | roles=admin, employee | [node_modules/@open-mercato/core/src/modules/design_system/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/design_system/setup.ts#L3) |