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

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

@@ -1,40 +1,59 @@
 # payment_gateways — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-canary.319.1.5b4be4bc52; core 0.6.8-canary.319.1.5b4be4bc52 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/core/src/modules/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 |
-|---|---|---|
-| 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
 
 _none_
 
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /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) |
+
+## Frontend pages
+
+_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
 
@@ -45,10 +64,138 @@ _none_
 - Entity IDs: _none_
 - Table IDs: payment_gateways.transactions.list
 
+## UMES hosts
+
+| 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 | 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) |
+| widget-spot:admin.page:payment-gateways/transactions:after:widget-injection-consumer | widget-injection-consumer | widget-spot:admin.page:payment-gateways/transactions:after @payment_gateways | widget, data-table, crud-form | — | hosts:transactionsAfter | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+| widget-spot:data-table:payment_gateways.transactions.list:toolbar:widget-injection-consumer | widget-injection-consumer | widget-spot:data-table:payment_gateways.transactions.list:toolbar @payment_gateways | widget, data-table, crud-form | — | hosts:transactionsTable.toolbar | [node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/payment_gateways/extension-points.ts) |
+
+## Incoming installed contributions
+
+| Contributor | Kind | Target | Resolution | Activation | Contribution · Source |
+|---|---|---|---|---|---|
+| 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) |
+| checkout | widget | widget-spot:admin.page:payment-gateways/transactions:after @payment_gateways | bound | widget-spot:admin.page:payment-gateways/transactions:after:widget-injection-consumer | checkout.injection.gateway-transaction-link@admin.page:payment-gateways/transactions:after · [node_modules/@open-mercato/checkout/src/modules/checkout/widgets/injection-table.ts](../../../node_modules/@open-mercato/checkout/src/modules/checkout/widgets/injection-table.ts) |
+| checkout | data-table | widget-spot:data-table:payment_gateways.transactions.list:toolbar @payment_gateways | bound | widget-spot:data-table:payment_gateways.transactions.list:toolbar:widget-injection-consumer | checkout.injection.payment-gateway-toolbar-link@data-table:payment_gateways.transactions.list:toolbar · [node_modules/@open-mercato/checkout/src/modules/checkout/widgets/injection-table.ts](../../../node_modules/@open-mercato/checkout/src/modules/checkout/widgets/injection-table.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
+
+- unbound-helper: data-table:payment_gateways.transactions.list: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["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,12 +1,13 @@
 # perspectives — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-canary.319.1.5b4be4bc52; core 0.6.8-canary.319.1.5b4be4bc52 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/core/src/modules/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)
 
@@ -14,12 +15,23 @@ _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
 
 _none_
 
+## Backend pages
+
+_none_
+
+## Frontend pages
+
+_none_
+
 ## DI service tokens
 
 _none_
@@ -33,10 +45,68 @@ _none_
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+| 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
 
 _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["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) |

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

@@ -1,49 +1,167 @@
 # planner — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-canary.319.1.5b4be4bc52; core 0.6.8-canary.319.1.5b4be4bc52 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/core/src/modules/planner
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| planner:planner_availability_rule_set | PlannerAvailabilityRuleSet | planner_availability_rule_sets | yes | no |
-| planner:planner_availability_rule | PlannerAvailabilityRule | planner_availability_rules | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| planner:planner_availability_rule_set | PlannerAvailabilityRuleSet | planner_availability_rule_sets | yes | no | [node_modules/@open-mercato/core/src/modules/planner/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/planner/data/entities.ts) |
+| planner:planner_availability_rule | PlannerAvailabilityRule | planner_availability_rules | yes | no | [node_modules/@open-mercato/core/src/modules/planner/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/planner/data/entities.ts) |
 
 ## Events  (6)
 
-| ID | Category | Entity |
-|---|---|---|
-| planner.availability_rule.created | crud | availability_rule |
-| planner.availability_rule.updated | crud | availability_rule |
-| planner.availability_rule.deleted | crud | availability_rule |
-| planner.availability_rule_set.created | crud | availability_rule_set |
-| planner.availability_rule_set.updated | crud | availability_rule_set |
-| planner.availability_rule_set.deleted | crud | availability_rule_set |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| planner.availability_rule.created | crud | availability_rule | — | [node_modules/@open-mercato/core/src/modules/planner/events.ts](../../../node_modules/@open-mercato/core/src/modules/planner/events.ts) |
+| planner.availability_rule.updated | crud | availability_rule | — | [node_modules/@open-mercato/core/src/modules/planner/events.ts](../../../node_modules/@open-mercato/core/src/modules/planner/events.ts) |
+| planner.availability_rule.deleted | crud | availability_rule | — | [node_modules/@open-mercato/core/src/modules/planner/events.ts](../../../node_modules/@open-mercato/core/src/modules/planner/events.ts) |
+| planner.availability_rule_set.created | crud | availability_rule_set | — | [node_modules/@open-mercato/core/src/modules/planner/events.ts](../../../node_modules/@open-mercato/core/src/modules/planner/events.ts) |
+| planner.availability_rule_set.updated | crud | availability_rule_set | — | [node_modules/@open-mercato/core/src/modules/planner/events.ts](../../../node_modules/@open-mercato/core/src/modules/planner/events.ts) |
+| planner.availability_rule_set.deleted | crud | availability_rule_set | — | [node_modules/@open-mercato/core/src/modules/planner/events.ts](../../../node_modules/@open-mercato/core/src/modules/planner/events.ts) |
 
 ## ACL features  (2)
 
-planner.view · planner.manage_availability
+| Feature | Source |
+|---|---|
+| planner.view | [node_modules/@open-mercato/core/src/modules/planner/acl.ts](../../../node_modules/@open-mercato/core/src/modules/planner/acl.ts) |
+| planner.manage_availability | [node_modules/@open-mercato/core/src/modules/planner/acl.ts](../../../node_modules/@open-mercato/core/src/modules/planner/acl.ts) |
 
 ## API routes
 
 _none_
 
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/planner/availability-rulesets | [node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/page.tsx](../../../node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/page.tsx) |
+| /backend/planner/availability-rulesets/[id] | [node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/[id]/page.tsx) |
+| /backend/planner/availability-rulesets/create | [node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/create/page.tsx](../../../node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/create/page.tsx) |
+
+## Frontend pages
+
+_none_
+
 ## DI service tokens
 
-plannerAvailabilityService
+| Token | Source |
+|---|---|
+| plannerAvailabilityService | [node_modules/@open-mercato/core/src/modules/planner/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/planner/di.ts#L7) |
 
 ## Search entities
 
-planner:planner_availability_rule_set
+| Entity ID | Source |
+|---|---|
+| planner:planner_availability_rule_set | [node_modules/@open-mercato/core/src/modules/planner/search.ts](../../../node_modules/@open-mercato/core/src/modules/planner/search.ts) |
 
 ## Host extension points
 
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| planner:planner_availability_rule | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:planner:planner_availability_rule |
+| planner:planner_availability_rule_set | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:planner:planner_availability_rule_set |
+| planner.availability | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/planner/api/availability-date-specific.ts](../../../node_modules/@open-mercato/core/src/modules/planner/api/availability-date-specific.ts) |
+| planner.availability_rule_set.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:planner.availability_rule_set.created |
+| planner.availability_rule_set.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:planner.availability_rule_set.deleted |
+| planner.availability_rule_set.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:planner.availability_rule_set.updated |
+| planner.availability_rule.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:planner.availability_rule.created |
+| planner.availability_rule.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:planner.availability_rule.deleted |
+| planner.availability_rule.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:planner.availability_rule.updated |
+| planner.planner_availability_rule_set.queried | query-lifecycle | sync-subscriber | tenant-and-organization-reapplied-after-result | STABLE | searchEntities:planner:planner_availability_rule_set |
+| planner.planner_availability_rule_set.querying | query-lifecycle | sync-subscriber | tenant-and-organization-reapplied-after-result | STABLE | searchEntities:planner:planner_availability_rule_set |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| search:planner:planner_availability_rule_set | specialized-registry | planner:planner_availability_rule_set | — | registry=search; registryId=planner:planner_availability_rule_set; specialistRoute=search | fact-ref | [node_modules/@open-mercato/core/src/modules/planner/search.ts](../../../node_modules/@open-mercato/core/src/modules/planner/search.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| entity:planner.availability:mutation-guard | mutation-guard | entity:planner.availability @planner | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/planner/api/availability-date-specific.ts:113](../../../node_modules/@open-mercato/core/src/modules/planner/api/availability-date-specific.ts#L113) |
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| search:planner:planner_availability_rule_set | module:planner:planner_availability_rule_set @planner | capability-only | — | [node_modules/@open-mercato/core/src/modules/planner/search.ts](../../../node_modules/@open-mercato/core/src/modules/planner/search.ts) |
+
+
+
 ## Notifications
 
 _none_
 
-## CLI
+## CLI commands
+
+| ID / path | Source |
+|---|---|
+| seed-availability-rulesets | [node_modules/@open-mercato/core/src/modules/planner/cli.ts](../../../node_modules/@open-mercato/core/src/modules/planner/cli.ts) |
+| seed-unavailability-reasons | [node_modules/@open-mercato/core/src/modules/planner/cli.ts](../../../node_modules/@open-mercato/core/src/modules/planner/cli.ts) |
+
+## AI tools / MCP capabilities
+
+_none_
+
+## AI agents
+
+_none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["planner.manage_availability"]` | disable-replace | aclFeatures:planner.manage_availability | [node_modules/@open-mercato/core/src/modules/planner/acl.ts](../../../node_modules/@open-mercato/core/src/modules/planner/acl.ts) |
+| acl | `overrides.acl.features["planner.view"]` | disable-replace | aclFeatures:planner.view | [node_modules/@open-mercato/core/src/modules/planner/acl.ts](../../../node_modules/@open-mercato/core/src/modules/planner/acl.ts) |
+| cli | `overrides.cli["seed-availability-rulesets"]` | disable-replace | cliCommands:seed-availability-rulesets | [node_modules/@open-mercato/core/src/modules/planner/cli.ts](../../../node_modules/@open-mercato/core/src/modules/planner/cli.ts) |
+| cli | `overrides.cli["seed-unavailability-reasons"]` | disable-replace | cliCommands:seed-unavailability-reasons | [node_modules/@open-mercato/core/src/modules/planner/cli.ts](../../../node_modules/@open-mercato/core/src/modules/planner/cli.ts) |
+| di | `overrides.di["plannerAvailabilityService"]` | disable-replace | ownedContracts.di-registration:plannerAvailabilityService | [node_modules/@open-mercato/core/src/modules/planner/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/planner/di.ts#L7) |
+| routes | `overrides.routes.pages["backend:/backend/planner/availability-rulesets"]` | disable-replace | backendPages:/backend/planner/availability-rulesets | [node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/page.tsx](../../../node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/planner/availability-rulesets/[id]"]` | disable-replace | backendPages:/backend/planner/availability-rulesets/[id] | [node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/[id]/page.tsx](../../../node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/[id]/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/planner/availability-rulesets/create"]` | disable-replace | backendPages:/backend/planner/availability-rulesets/create | [node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/create/page.tsx](../../../node_modules/@open-mercato/core/src/modules/planner/backend/planner/availability-rulesets/create/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:planner:setup | [node_modules/@open-mercato/core/src/modules/planner/setup.ts:4](../../../node_modules/@open-mercato/core/src/modules/planner/setup.ts#L4) |
+| setup | `overrides.setup.seedDefaults` | replace | ownedContracts.setup:planner:setup | [node_modules/@open-mercato/core/src/modules/planner/setup.ts:4](../../../node_modules/@open-mercato/core/src/modules/planner/setup.ts#L4) |
+| setup | `overrides.setup.seedExamples` | replace | ownedContracts.setup:planner:setup | [node_modules/@open-mercato/core/src/modules/planner/setup.ts:4](../../../node_modules/@open-mercato/core/src/modules/planner/setup.ts#L4) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| planner | ejectable=true; name=planner; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/planner/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/planner/index.ts#L3) |
+
+## Domain commands
+
+| ID | Metadata | Source |
+|---|---|---|
+| planner.availability-rule-sets.create | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability-rule-sets.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability-rule-sets.ts) |
+| planner.availability-rule-sets.delete | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability-rule-sets.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability-rule-sets.ts) |
+| planner.availability-rule-sets.update | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability-rule-sets.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability-rule-sets.ts) |
+| planner.availability.create | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability.ts) |
+| planner.availability.date-specific.replace | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability-date-specific.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability-date-specific.ts) |
+| planner.availability.delete | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability.ts) |
+| planner.availability.update | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability.ts) |
+| planner.availability.weekly.replace | — | [node_modules/@open-mercato/core/src/modules/planner/commands/availability-weekly.ts](../../../node_modules/@open-mercato/core/src/modules/planner/commands/availability-weekly.ts) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| planner:setup | hooks=seedDefaults, seedExamples; roles=admin, employee | [node_modules/@open-mercato/core/src/modules/planner/setup.ts:4](../../../node_modules/@open-mercato/core/src/modules/planner/setup.ts#L4) |
+
+## DI registrations (rich)
 
-seed-availability-rulesets · seed-unavailability-reasons
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| plannerAvailabilityService | function | singleton | — | — | [node_modules/@open-mercato/core/src/modules/planner/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/planner/di.ts#L7) |