@open-mercato/cli 0.6.8-develop.6961.1.5b7ca407e7 → 0.6.8-develop.6962.1.bd029a2bb2

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

@@ -1,201 +0,0 @@
-# payment_gateways — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.8-develop.6961.1.5b7ca407e7; core 0.6.8-develop.6961.1.5b7ca407e7 — R1 staleness stamp -->
-Source root: node_modules/@open-mercato/core/src/modules/payment_gateways
-
-## Entities
-
-| 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 | 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)
-
-| 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
-
-| 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
-
-_none_
-
-## Host extension points
-
-- 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 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; queue=payment-gateway-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) |
-| 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,112 +0,0 @@
-# perspectives — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.8-develop.6961.1.5b7ca407e7; core 0.6.8-develop.6961.1.5b7ca407e7 — R1 staleness stamp -->
-Source root: node_modules/@open-mercato/core/src/modules/perspectives
-
-## Entities
-
-| 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)
-
-_none_
-
-## ACL features  (2)
-
-| 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_
-
-## Search entities
-
-_none_
-
-## Host extension points
-
-- 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 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,167 +0,0 @@
-# planner — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.8-develop.6961.1.5b7ca407e7; core 0.6.8-develop.6961.1.5b7ca407e7 — R1 staleness stamp -->
-Source root: node_modules/@open-mercato/core/src/modules/planner
-
-## Entities
-
-| 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 | 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)
-
-| 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
-
-| 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
-
-| 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 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)
-
-| 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) |