@open-mercato/cli 0.6.7-develop.6795.1.8a3f27921c → 0.6.7-develop.6814.1.0627c7e9f1

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

@@ -1,12 +1,12 @@
 # notifications — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6814.1.0627c7e9f1; core 0.6.7-develop.6814.1.0627c7e9f1 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/notifications](../../../node_modules/@open-mercato/core/src/modules/notifications)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| notifications:notification | Notification | notifications | no | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| notifications:notification | Notification | notifications | no | no | [node_modules/@open-mercato/core/src/modules/notifications/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/data/entities.ts) |
 
 ## Events  (0)
 
@@ -14,7 +14,11 @@ _none_
 
 ## ACL features  (3)
 
-notifications.view · notifications.create · notifications.manage
+| Feature | Source |
+|---|---|
+| notifications.view | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| notifications.create | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| notifications.manage | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
 
 ## API routes
 
@@ -32,7 +36,9 @@ _none_
 
 ## DI service tokens
 
-notificationService
+| Token | Source |
+|---|---|
+| notificationService | [node_modules/@open-mercato/core/src/modules/notifications/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/notifications/di.ts#L7) |
 
 ## Search entities
 
@@ -45,14 +51,26 @@ _none_
 
 ## UMES hosts
 
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| notifications:notification | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| notifications:notification | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:notifications:notification |
 
 ## UMES contributions
 
 _none_
 
+## Active extension bindings
+
+_none_
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
 
 
 ## Notifications
@@ -72,3 +90,40 @@ _none_
 ## AI agents
 
 _none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["notifications.create"]` | disable-replace | aclFeatures:notifications.create | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| acl | `overrides.acl.features["notifications.manage"]` | disable-replace | aclFeatures:notifications.manage | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| acl | `overrides.acl.features["notifications.view"]` | disable-replace | aclFeatures:notifications.view | [node_modules/@open-mercato/core/src/modules/notifications/acl.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/acl.ts) |
+| cli | `overrides.cli["cleanup-expired"]` | disable-replace | cliCommands:cleanup-expired | [node_modules/@open-mercato/core/src/modules/notifications/cli.ts](../../../node_modules/@open-mercato/core/src/modules/notifications/cli.ts) |
+| di | `overrides.di["notificationService"]` | disable-replace | ownedContracts.di-registration:notificationService | [node_modules/@open-mercato/core/src/modules/notifications/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/notifications/di.ts#L7) |
+| routes | `overrides.routes.pages["backend:/backend/config/notifications"]` | disable-replace | backendPages:/backend/config/notifications | [node_modules/@open-mercato/core/src/modules/notifications/backend/config/notifications/page.tsx](../../../node_modules/@open-mercato/core/src/modules/notifications/backend/config/notifications/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:notifications:setup | [node_modules/@open-mercato/core/src/modules/notifications/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/notifications/setup.ts#L3) |
+| workers | `overrides.workers["notifications:create"]` | disable-replace | ownedContracts.worker:notifications:create | [node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts:42](../../../node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts#L42) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| notifications | name=notifications; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/notifications/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/notifications/index.ts#L3) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| notifications:create | concurrency=5; queue=notifications | [node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts:42](../../../node_modules/@open-mercato/core/src/modules/notifications/workers/create-notification.worker.ts#L42) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| notifications:setup | roles=admin, employee, superadmin | [node_modules/@open-mercato/core/src/modules/notifications/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/notifications/setup.ts#L3) |
+
+## DI registrations (rich)
+
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| notificationService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/notifications/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/notifications/di.ts#L7) |

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

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

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

@@ -1,33 +1,38 @@
 # payment_gateways — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6814.1.0627c7e9f1; core 0.6.7-develop.6814.1.0627c7e9f1 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/payment_gateways](../../../node_modules/@open-mercato/core/src/modules/payment_gateways)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| payment_gateways:gateway_transaction | GatewayTransaction | gateway_transactions | yes | no |
-| payment_gateways:gateway_payment_operation | GatewayPaymentOperation | gateway_payment_operations | yes | no |
-| payment_gateways:gateway_session_initialization | GatewaySessionInitialization | gateway_session_initializations | yes | no |
-| payment_gateways:webhook_processed_event | WebhookProcessedEvent | gateway_webhook_events | no | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| payment_gateways:gateway_transaction | GatewayTransaction | gateway_transactions | yes | no | [node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts) |
+| payment_gateways:gateway_payment_operation | GatewayPaymentOperation | gateway_payment_operations | yes | no | [node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts) |
+| payment_gateways:gateway_session_initialization | GatewaySessionInitialization | gateway_session_initializations | yes | no | [node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts) |
+| payment_gateways:webhook_processed_event | WebhookProcessedEvent | gateway_webhook_events | no | no | [node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/data/entities.ts) |
 
 ## Events  (9)
 
-| ID | Category | Entity | Browser transport |
-|---|---|---|---|
-| payment_gateways.session.created | lifecycle | session | — |
-| payment_gateways.session.expired | lifecycle | session | — |
-| payment_gateways.payment.authorized | lifecycle | payment | — |
-| payment_gateways.payment.captured | lifecycle | payment | — |
-| payment_gateways.payment.failed | lifecycle | payment | — |
-| payment_gateways.payment.refunded | lifecycle | payment | — |
-| payment_gateways.payment.cancelled | lifecycle | payment | — |
-| payment_gateways.webhook.received | system | webhook | — |
-| payment_gateways.webhook.failed | system | webhook | — |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| payment_gateways.session.created | lifecycle | session | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.session.expired | lifecycle | session | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.payment.authorized | lifecycle | payment | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.payment.captured | lifecycle | payment | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.payment.failed | lifecycle | payment | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.payment.refunded | lifecycle | payment | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.payment.cancelled | lifecycle | payment | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.webhook.received | system | webhook | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
+| payment_gateways.webhook.failed | system | webhook | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/events.ts) |
 
 ## ACL features  (4)
 
-payment_gateways.view · payment_gateways.manage · payment_gateways.capture · payment_gateways.refund
+| Feature | Source |
+|---|---|
+| payment_gateways.view | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| payment_gateways.manage | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| payment_gateways.capture | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| payment_gateways.refund | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
 
 ## API routes
 
@@ -45,7 +50,10 @@ _none_
 
 ## DI service tokens
 
-paymentGatewayService · paymentGatewayDescriptorService
+| Token | Source |
+|---|---|
+| paymentGatewayService | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:40](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L40) |
+| paymentGatewayDescriptorService | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:49](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L49) |
 
 ## Search entities
 
@@ -58,38 +66,59 @@ _none_
 
 ## UMES hosts
 
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| data-table:payment_gateways.transactions.list | data-table | component-replacement | — | FROZEN |
-| data-table:payment_gateways.transactions.list:bulk-actions | data-table | bulk-action | — | FROZEN |
-| data-table:payment_gateways.transactions.list:columns | data-table | column-widget | — | FROZEN |
-| data-table:payment_gateways.transactions.list:filters | data-table | filter-widget | — | FROZEN |
-| data-table:payment_gateways.transactions.list:footer | data-table | render-widget | — | FROZEN |
-| data-table:payment_gateways.transactions.list:header | data-table | render-widget | — | FROZEN |
-| data-table:payment_gateways.transactions.list:row-actions | data-table | row-action | — | FROZEN |
-| data-table:payment_gateways.transactions.list:search-trailing | data-table | render-widget | — | FROZEN |
-| data-table:payment_gateways.transactions.list:toolbar | data-table | toolbar-widget | — | FROZEN |
-| admin.page:payment-gateways/transactions:after | detail | render-widget | — | FROZEN |
-| payment_gateways:gateway_payment_operation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| payment_gateways:gateway_session_initialization | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| payment_gateways:gateway_transaction | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| payment_gateways:webhook_processed_event | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| payment_gateways.gateway_transaction | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE |
-| payment_gateways.payment.authorized | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.payment.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.payment.captured | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.payment.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.payment.refunded | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.session.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.session.expired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.webhook.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| payment_gateways.webhook.received | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| data-table:payment_gateways.transactions.list | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| data-table:payment_gateways.transactions.list:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| admin.page:payment-gateways/transactions:after | detail | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| payment_gateways:gateway_payment_operation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:payment_gateways:gateway_payment_operation |
+| payment_gateways:gateway_session_initialization | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:payment_gateways:gateway_session_initialization |
+| payment_gateways:gateway_transaction | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:payment_gateways:gateway_transaction |
+| payment_gateways:webhook_processed_event | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:payment_gateways:webhook_processed_event |
+| payment_gateways.gateway_transaction | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/payment_gateways/api/status/route.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/api/status/route.ts) |
+| payment_gateways.payment.authorized | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.payment.authorized |
+| payment_gateways.payment.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.payment.cancelled |
+| payment_gateways.payment.captured | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.payment.captured |
+| payment_gateways.payment.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.payment.failed |
+| payment_gateways.payment.refunded | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.payment.refunded |
+| payment_gateways.session.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.session.created |
+| payment_gateways.session.expired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.session.expired |
+| payment_gateways.webhook.failed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.webhook.failed |
+| payment_gateways.webhook.received | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:payment_gateways.webhook.received |
 
 ## UMES contributions
 
-| ID | Kind | Target | Phase / operations | Contract | Resolution |
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| payment_gateways.validate-provider | api-interceptor | sessions | before | activation=crud-pipeline; failurePosture=fallback; methods=POST; phases=before; route=sessions; timeoutMs=2000 | fact-ref | [node_modules/@open-mercato/core/src/modules/payment_gateways/api/interceptors.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/api/interceptors.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| entity:payment_gateways.gateway_transaction:mutation-guard | mutation-guard | entity:payment_gateways.gateway_transaction @payment_gateways | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/api/status/route.ts:91](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/api/status/route.ts#L91) |
+
+## Incoming installed contributions
+
+| Contributor | Kind | Target | Resolution | Activation | Contribution · Source |
 |---|---|---|---|---|---|
-| payment_gateways.validate-provider | api-interceptor | sessions | before | activation=crud-pipeline; failurePosture=fallback; methods=POST; phases=before; route=sessions; timeoutMs=2000 | fact-ref |
+| checkout | subscriber | event:payment_gateways.payment.authorized @payment_gateways | capability-only | — | checkout-gateway-payment-authorized · [node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-authorized.ts](../../../node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-authorized.ts) |
+| checkout | subscriber | event:payment_gateways.payment.cancelled @payment_gateways | capability-only | — | checkout-gateway-payment-cancelled · [node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-cancelled.ts](../../../node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-cancelled.ts) |
+| checkout | subscriber | event:payment_gateways.payment.captured @payment_gateways | capability-only | — | checkout-gateway-payment-captured · [node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-captured.ts](../../../node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-captured.ts) |
+| checkout | subscriber | event:payment_gateways.payment.failed @payment_gateways | capability-only | — | checkout-gateway-payment-failed · [node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-failed.ts](../../../node_modules/@open-mercato/checkout/src/modules/checkout/subscribers/gateway-payment-failed.ts) |
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| payment_gateways.validate-provider | api-route:sessions | capability-only | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/api/interceptors.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/api/interceptors.ts) |
 
 ## UMES diagnostics
 
@@ -110,3 +139,59 @@ _none_
 ## AI agents
 
 _none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["payment_gateways.capture"]` | disable-replace | aclFeatures:payment_gateways.capture | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| acl | `overrides.acl.features["payment_gateways.manage"]` | disable-replace | aclFeatures:payment_gateways.manage | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| acl | `overrides.acl.features["payment_gateways.refund"]` | disable-replace | aclFeatures:payment_gateways.refund | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| acl | `overrides.acl.features["payment_gateways.view"]` | disable-replace | aclFeatures:payment_gateways.view | [node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/acl.ts) |
+| di | `overrides.di["GatewayTransaction"]` | disable-replace | ownedContracts.di-registration:GatewayTransaction | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:53](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L53) |
+| di | `overrides.di["paymentGatewayDescriptorService"]` | disable-replace | ownedContracts.di-registration:paymentGatewayDescriptorService | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:49](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L49) |
+| di | `overrides.di["paymentGatewayService"]` | disable-replace | ownedContracts.di-registration:paymentGatewayService | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:40](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L40) |
+| di | `overrides.di["WebhookProcessedEvent"]` | disable-replace | ownedContracts.di-registration:WebhookProcessedEvent | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:54](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L54) |
+| encryption | `overrides.encryption.maps["payment_gateways:gateway_transaction"]` | disable-replace | ownedContracts.encryption:payment_gateways:gateway_transaction | [node_modules/@open-mercato/core/src/modules/payment_gateways/encryption.ts:10](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/encryption.ts#L10) |
+| interceptors | `overrides.interceptors["payment_gateways.validate-provider"]` | disable-replace | extensionSurfaces.contributions:payment_gateways.validate-provider | [node_modules/@open-mercato/core/src/modules/payment_gateways/api/interceptors.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/api/interceptors.ts) |
+| routes | `overrides.routes.pages["backend:/backend/payment-gateways"]` | disable-replace | backendPages:/backend/payment-gateways | [node_modules/@open-mercato/core/src/modules/payment_gateways/backend/payment-gateways/page.tsx](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/backend/payment-gateways/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:payment_gateways:setup | [node_modules/@open-mercato/core/src/modules/payment_gateways/setup.ts:61](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/setup.ts#L61) |
+| setup | `overrides.setup.seedDefaults` | replace | ownedContracts.setup:payment_gateways:setup | [node_modules/@open-mercato/core/src/modules/payment_gateways/setup.ts:61](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/setup.ts#L61) |
+| workers | `overrides.workers["payment_gateways:session-initialization-prune"]` | disable-replace | ownedContracts.worker:payment_gateways:session-initialization-prune | [node_modules/@open-mercato/core/src/modules/payment_gateways/workers/session-initialization-prune.ts:30](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/workers/session-initialization-prune.ts#L30) |
+| workers | `overrides.workers["payment-gateways:status-poller"]` | disable-replace | ownedContracts.worker:payment-gateways:status-poller | [node_modules/@open-mercato/core/src/modules/payment_gateways/workers/status-poller.ts:18](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/workers/status-poller.ts#L18) |
+| workers | `overrides.workers["payment-gateways:webhook-processor"]` | disable-replace | ownedContracts.worker:payment-gateways:webhook-processor | [node_modules/@open-mercato/core/src/modules/payment_gateways/workers/webhook-processor.ts:16](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/workers/webhook-processor.ts#L16) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| payment_gateways | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/index.ts:1](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/index.ts#L1) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| payment_gateways:session-initialization-prune | concurrency=1 | [node_modules/@open-mercato/core/src/modules/payment_gateways/workers/session-initialization-prune.ts:30](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/workers/session-initialization-prune.ts#L30) |
+| payment-gateways:status-poller | concurrency=2; queue=payment-gateways-status-poller | [node_modules/@open-mercato/core/src/modules/payment_gateways/workers/status-poller.ts:18](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/workers/status-poller.ts#L18) |
+| payment-gateways:webhook-processor | concurrency=5; queue=payment-gateways-webhook | [node_modules/@open-mercato/core/src/modules/payment_gateways/workers/webhook-processor.ts:16](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/workers/webhook-processor.ts#L16) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| payment_gateways:setup | hooks=seedDefaults; roles=admin, employee, superadmin | [node_modules/@open-mercato/core/src/modules/payment_gateways/setup.ts:61](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/setup.ts#L61) |
+
+## Encryption
+
+| ID | Metadata | Source |
+|---|---|---|
+| payment_gateways:gateway_transaction | fields=client_secret, gateway_metadata, webhook_log | [node_modules/@open-mercato/core/src/modules/payment_gateways/encryption.ts:10](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/encryption.ts#L10) |
+
+## DI registrations (rich)
+
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| GatewayTransaction | value | — | — | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:53](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L53) |
+| paymentGatewayDescriptorService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:49](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L49) |
+| paymentGatewayService | function | scoped | proxy | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:40](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L40) |
+| WebhookProcessedEvent | value | — | — | — | [node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts:54](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/di.ts#L54) |

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

@@ -1,13 +1,13 @@
 # perspectives — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6814.1.0627c7e9f1; core 0.6.7-develop.6814.1.0627c7e9f1 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/perspectives](../../../node_modules/@open-mercato/core/src/modules/perspectives)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| perspectives:perspective | Perspective | perspectives | yes | no |
-| perspectives:role_perspective | RolePerspective | role_perspectives | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| perspectives:perspective | Perspective | perspectives | yes | no | [node_modules/@open-mercato/core/src/modules/perspectives/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/data/entities.ts) |
+| perspectives:role_perspective | RolePerspective | role_perspectives | yes | no | [node_modules/@open-mercato/core/src/modules/perspectives/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/data/entities.ts) |
 
 ## Events  (0)
 
@@ -15,7 +15,10 @@ _none_
 
 ## ACL features  (2)
 
-perspectives.use · perspectives.role_defaults
+| Feature | Source |
+|---|---|
+| perspectives.use | [node_modules/@open-mercato/core/src/modules/perspectives/acl.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/acl.ts) |
+| perspectives.role_defaults | [node_modules/@open-mercato/core/src/modules/perspectives/acl.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/acl.ts) |
 
 ## API routes
 
@@ -44,17 +47,32 @@ _none_
 
 ## UMES hosts
 
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| perspectives:perspective | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| perspectives:role_perspective | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| perspectives.perspective | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE |
-| perspectives.role_perspective | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| perspectives:perspective | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:perspectives:perspective |
+| perspectives:role_perspective | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:perspectives:role_perspective |
+| perspectives.perspective | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/[perspectiveId]/route.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/[perspectiveId]/route.ts) |
+| perspectives.role_perspective | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/roles/[roleId]/route.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/roles/[roleId]/route.ts) |
 
 ## UMES contributions
 
 _none_
 
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| entity:perspectives.perspective:mutation-guard | mutation-guard | entity:perspectives.perspective @perspectives | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/[perspectiveId]/route.ts:48](../../../node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/[perspectiveId]/route.ts#L48) |
+| entity:perspectives.role_perspective:mutation-guard | mutation-guard | entity:perspectives.role_perspective @perspectives | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/roles/[roleId]/route.ts:77](../../../node_modules/@open-mercato/core/src/modules/perspectives/api/[tableId]/roles/[roleId]/route.ts#L77) |
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
 
 
 ## Notifications
@@ -72,3 +90,23 @@ _none_
 ## AI agents
 
 _none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["perspectives.role_defaults"]` | disable-replace | aclFeatures:perspectives.role_defaults | [node_modules/@open-mercato/core/src/modules/perspectives/acl.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/acl.ts) |
+| acl | `overrides.acl.features["perspectives.use"]` | disable-replace | aclFeatures:perspectives.use | [node_modules/@open-mercato/core/src/modules/perspectives/acl.ts](../../../node_modules/@open-mercato/core/src/modules/perspectives/acl.ts) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:perspectives:setup | [node_modules/@open-mercato/core/src/modules/perspectives/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/perspectives/setup.ts#L3) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| perspectives | ejectable=true; name=perspectives; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/perspectives/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/perspectives/index.ts#L3) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| perspectives:setup | roles=admin, employee | [node_modules/@open-mercato/core/src/modules/perspectives/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/perspectives/setup.ts#L3) |