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

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

@@ -1,34 +1,38 @@
 # query_index — 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/query_index](../../../node_modules/@open-mercato/core/src/modules/query_index)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| query_index:entity_index_row | EntityIndexRow | entity_indexes | yes | no |
-| query_index:entity_index_job | EntityIndexJob | entity_index_jobs | no | no |
-| query_index:entity_index_coverage | EntityIndexCoverage | entity_index_coverage | no | no |
-| query_index:indexer_error_log | IndexerErrorLog | indexer_error_logs | no | no |
-| query_index:indexer_status_log | IndexerStatusLog | indexer_status_logs | no | no |
-| query_index:search_token | SearchToken | search_tokens | no | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| query_index:entity_index_row | EntityIndexRow | entity_indexes | yes | no | [node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts) |
+| query_index:entity_index_job | EntityIndexJob | entity_index_jobs | no | no | [node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts) |
+| query_index:entity_index_coverage | EntityIndexCoverage | entity_index_coverage | no | no | [node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts) |
+| query_index:indexer_error_log | IndexerErrorLog | indexer_error_logs | no | no | [node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts) |
+| query_index:indexer_status_log | IndexerStatusLog | indexer_status_logs | no | no | [node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts) |
+| query_index:search_token | SearchToken | search_tokens | no | no | [node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/data/entities.ts) |
 
 ## Events  (8)
 
-| ID | Category | Entity | Browser transport |
-|---|---|---|---|
-| query_index.coverage.refresh | lifecycle | — | — |
-| query_index.coverage.warmup | lifecycle | — | — |
-| query_index.delete_one | lifecycle | — | — |
-| query_index.purge | lifecycle | — | — |
-| query_index.reindex | lifecycle | — | — |
-| query_index.upsert_one | lifecycle | — | — |
-| query_index.vectorize_one | lifecycle | — | — |
-| query_index.vectorize_purge | lifecycle | — | — |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| query_index.coverage.refresh | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.coverage.warmup | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.delete_one | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.purge | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.reindex | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.upsert_one | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.vectorize_one | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
+| query_index.vectorize_purge | lifecycle | — | — | [node_modules/@open-mercato/core/src/modules/query_index/events.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/events.ts) |
 
 ## ACL features  (3)
 
-query_index.status.view · query_index.reindex · query_index.purge
+| Feature | Source |
+|---|---|
+| query_index.status.view | [node_modules/@open-mercato/core/src/modules/query_index/acl.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/acl.ts) |
+| query_index.reindex | [node_modules/@open-mercato/core/src/modules/query_index/acl.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/acl.ts) |
+| query_index.purge | [node_modules/@open-mercato/core/src/modules/query_index/acl.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/acl.ts) |
 
 ## API routes
 
@@ -59,43 +63,69 @@ _none_
 
 ## UMES hosts
 
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| data-table:query_index.status.list | data-table | component-replacement | — | FROZEN |
-| data-table:query_index.status.list:bulk-actions | data-table | bulk-action | — | FROZEN |
-| data-table:query_index.status.list:columns | data-table | column-widget | — | FROZEN |
-| data-table:query_index.status.list:filters | data-table | filter-widget | — | FROZEN |
-| data-table:query_index.status.list:footer | data-table | render-widget | — | FROZEN |
-| data-table:query_index.status.list:header | data-table | render-widget | — | FROZEN |
-| data-table:query_index.status.list:row-actions | data-table | row-action | — | FROZEN |
-| data-table:query_index.status.list:search-trailing | data-table | render-widget | — | FROZEN |
-| data-table:query_index.status.list:toolbar | data-table | toolbar-widget | — | FROZEN |
-| query_index | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE |
-| query_index:entity_index_coverage | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| query_index:entity_index_job | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| query_index:entity_index_row | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| query_index:indexer_error_log | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| query_index:indexer_status_log | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| query_index:search_token | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| query_index.coverage.refresh | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.coverage.warmup | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.delete_one | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.purge | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.reindex | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.upsert_one | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.vectorize_one | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| query_index.vectorize_purge | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| data-table:query_index.status.list | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| data-table:query_index.status.list:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/extension-points.ts) |
+| query_index | entity | response-enricher, query-enricher, mutation-guard | tenant-and-organization | STABLE | [node_modules/@open-mercato/core/src/modules/query_index/api/purge.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/api/purge.ts) |
+| query_index:entity_index_coverage | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:query_index:entity_index_coverage |
+| query_index:entity_index_job | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:query_index:entity_index_job |
+| query_index:entity_index_row | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:query_index:entity_index_row |
+| query_index:indexer_error_log | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:query_index:indexer_error_log |
+| query_index:indexer_status_log | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:query_index:indexer_status_log |
+| query_index:search_token | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:query_index:search_token |
+| query_index.coverage.refresh | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.coverage.refresh |
+| query_index.coverage.warmup | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.coverage.warmup |
+| query_index.delete_one | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.delete_one |
+| query_index.purge | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.purge |
+| query_index.reindex | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.reindex |
+| query_index.upsert_one | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.upsert_one |
+| query_index.vectorize_one | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.vectorize_one |
+| query_index.vectorize_purge | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:query_index.vectorize_purge |
 
 ## UMES contributions
 
-| ID | Kind | Target | Phase / operations | Contract | Resolution |
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| query_index:coverage_refresh | subscriber | query_index.coverage.refresh | before-or-after | event=query_index.coverage.refresh; persistent=false; subscriberId=query_index:coverage_refresh; sync=true | fact-ref | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_refresh.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_refresh.ts) |
+| query_index:coverage_warmup | subscriber | query_index.coverage.warmup | before-or-after | event=query_index.coverage.warmup; persistent=false; subscriberId=query_index:coverage_warmup; sync=true | fact-ref | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_warmup.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_warmup.ts) |
+| query_index:delete_one | subscriber | query_index.delete_one | before-or-after | event=query_index.delete_one; persistent=false; subscriberId=query_index:delete_one; sync=true | fact-ref | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/delete_one.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/delete_one.ts) |
+| query_index:purge | subscriber | query_index.purge | async-delivery | event=query_index.purge; persistent=true; subscriberId=query_index:purge; sync=false | fact-ref | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/purge.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/purge.ts) |
+| query_index:reindex | subscriber | query_index.reindex | async-delivery | event=query_index.reindex; persistent=true; subscriberId=query_index:reindex; sync=false | fact-ref | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/reindex.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/reindex.ts) |
+| query_index:upsert_one | subscriber | query_index.upsert_one | before-or-after | event=query_index.upsert_one; persistent=false; subscriberId=query_index:upsert_one; sync=true | fact-ref | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/upsert_one.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/upsert_one.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| entity:query_index:mutation-guard | mutation-guard | entity:query_index @query_index | mutation-guard | — | — | [node_modules/@open-mercato/core/src/modules/query_index/api/purge.ts:31](../../../node_modules/@open-mercato/core/src/modules/query_index/api/purge.ts#L31) |
+
+## Incoming installed contributions
+
+| Contributor | Kind | Target | Resolution | Activation | Contribution · Source |
 |---|---|---|---|---|---|
-| query_index:coverage_refresh | subscriber | query_index.coverage.refresh | before-or-after | event=query_index.coverage.refresh; persistent=false; subscriberId=query_index:coverage_refresh; sync=true | fact-ref |
-| query_index:coverage_warmup | subscriber | query_index.coverage.warmup | before-or-after | event=query_index.coverage.warmup; persistent=false; subscriberId=query_index:coverage_warmup; sync=true | fact-ref |
-| query_index:delete_one | subscriber | query_index.delete_one | before-or-after | event=query_index.delete_one; persistent=false; subscriberId=query_index:delete_one; sync=true | fact-ref |
-| query_index:purge | subscriber | query_index.purge | async-delivery | event=query_index.purge; persistent=true; subscriberId=query_index:purge; sync=false | fact-ref |
-| query_index:reindex | subscriber | query_index.reindex | async-delivery | event=query_index.reindex; persistent=true; subscriberId=query_index:reindex; sync=false | fact-ref |
-| query_index:upsert_one | subscriber | query_index.upsert_one | before-or-after | event=query_index.upsert_one; persistent=false; subscriberId=query_index:upsert_one; sync=true | fact-ref |
+| search | subscriber | event:query_index.delete_one @query_index | capability-only | — | search:vector_delete · [node_modules/@open-mercato/search/src/modules/search/subscribers/vector_delete.ts](../../../node_modules/@open-mercato/search/src/modules/search/subscribers/vector_delete.ts) |
+| search | subscriber | event:query_index.vectorize_purge @query_index | capability-only | — | search:vector_purge · [node_modules/@open-mercato/search/src/modules/search/subscribers/vector_purge.ts](../../../node_modules/@open-mercato/search/src/modules/search/subscribers/vector_purge.ts) |
+| search | subscriber | event:query_index.vectorize_one @query_index | capability-only | — | search:vector_upsert · [node_modules/@open-mercato/search/src/modules/search/subscribers/vector_upsert.ts](../../../node_modules/@open-mercato/search/src/modules/search/subscribers/vector_upsert.ts) |
+| translations | subscriber | event:query_index.delete_one @query_index | capability-only | — | translations:cleanup · [node_modules/@open-mercato/core/src/modules/translations/subscribers/cleanup.ts](../../../node_modules/@open-mercato/core/src/modules/translations/subscribers/cleanup.ts) |
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| query_index:coverage_refresh | event:query_index.coverage.refresh @query_index | capability-only | — | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_refresh.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_refresh.ts) |
+| query_index:coverage_warmup | event:query_index.coverage.warmup @query_index | capability-only | — | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_warmup.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_warmup.ts) |
+| query_index:delete_one | event:query_index.delete_one @query_index | capability-only | — | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/delete_one.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/delete_one.ts) |
+| query_index:purge | event:query_index.purge @query_index | capability-only | — | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/purge.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/purge.ts) |
+| query_index:reindex | event:query_index.reindex @query_index | capability-only | — | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/reindex.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/reindex.ts) |
+| query_index:upsert_one | event:query_index.upsert_one @query_index | capability-only | — | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/upsert_one.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/upsert_one.ts) |
 
 ## UMES diagnostics
 
@@ -121,3 +151,35 @@ _none_
 ## AI agents
 
 _none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["query_index.purge"]` | disable-replace | aclFeatures:query_index.purge | [node_modules/@open-mercato/core/src/modules/query_index/acl.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/acl.ts) |
+| acl | `overrides.acl.features["query_index.reindex"]` | disable-replace | aclFeatures:query_index.reindex | [node_modules/@open-mercato/core/src/modules/query_index/acl.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/acl.ts) |
+| acl | `overrides.acl.features["query_index.status.view"]` | disable-replace | aclFeatures:query_index.status.view | [node_modules/@open-mercato/core/src/modules/query_index/acl.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/acl.ts) |
+| cli | `overrides.cli["purge"]` | disable-replace | cliCommands:purge | [node_modules/@open-mercato/core/src/modules/query_index/cli.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/cli.ts) |
+| cli | `overrides.cli["rebuild"]` | disable-replace | cliCommands:rebuild | [node_modules/@open-mercato/core/src/modules/query_index/cli.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/cli.ts) |
+| cli | `overrides.cli["rebuild-all"]` | disable-replace | cliCommands:rebuild-all | [node_modules/@open-mercato/core/src/modules/query_index/cli.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/cli.ts) |
+| cli | `overrides.cli["reindex"]` | disable-replace | cliCommands:reindex | [node_modules/@open-mercato/core/src/modules/query_index/cli.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/cli.ts) |
+| events | `overrides.events.subscribers["query_index:coverage_refresh"]` | disable-replace | extensionSurfaces.contributions:query_index:coverage_refresh | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_refresh.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_refresh.ts) |
+| events | `overrides.events.subscribers["query_index:coverage_warmup"]` | disable-replace | extensionSurfaces.contributions:query_index:coverage_warmup | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_warmup.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/coverage_warmup.ts) |
+| events | `overrides.events.subscribers["query_index:delete_one"]` | disable-replace | extensionSurfaces.contributions:query_index:delete_one | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/delete_one.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/delete_one.ts) |
+| events | `overrides.events.subscribers["query_index:purge"]` | disable-replace | extensionSurfaces.contributions:query_index:purge | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/purge.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/purge.ts) |
+| events | `overrides.events.subscribers["query_index:reindex"]` | disable-replace | extensionSurfaces.contributions:query_index:reindex | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/reindex.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/reindex.ts) |
+| events | `overrides.events.subscribers["query_index:upsert_one"]` | disable-replace | extensionSurfaces.contributions:query_index:upsert_one | [node_modules/@open-mercato/core/src/modules/query_index/subscribers/upsert_one.ts](../../../node_modules/@open-mercato/core/src/modules/query_index/subscribers/upsert_one.ts) |
+| routes | `overrides.routes.pages["backend:/backend/query-indexes"]` | disable-replace | backendPages:/backend/query-indexes | [node_modules/@open-mercato/core/src/modules/query_index/backend/query-indexes/page.tsx](../../../node_modules/@open-mercato/core/src/modules/query_index/backend/query-indexes/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:query_index:setup | [node_modules/@open-mercato/core/src/modules/query_index/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/query_index/setup.ts#L3) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| query_index | name=query_index; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/query_index/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/query_index/index.ts#L3) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| query_index:setup | roles=admin | [node_modules/@open-mercato/core/src/modules/query_index/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/query_index/setup.ts#L3) |

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

@@ -1,32 +1,37 @@
 # record_locks — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.6.7-develop.6814.1.0627c7e9f1; core 0.6.7-develop.6814.1.0627c7e9f1 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/enterprise/src/modules/record_locks](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks)
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| record_locks:record_lock | RecordLock | record_locks | yes | no |
-| record_locks:record_lock_conflict | RecordLockConflict | record_lock_conflicts | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| record_locks:record_lock | RecordLock | record_locks | yes | no | [node_modules/@open-mercato/enterprise/src/modules/record_locks/data/entities.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/data/entities.ts) |
+| record_locks:record_lock_conflict | RecordLockConflict | record_lock_conflicts | yes | no | [node_modules/@open-mercato/enterprise/src/modules/record_locks/data/entities.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/data/entities.ts) |
 
 ## Events  (10)
 
-| ID | Category | Entity | Browser transport |
-|---|---|---|---|
-| record_locks.lock.acquired | crud | lock | — |
-| record_locks.participant.joined | lifecycle | lock | — |
-| record_locks.participant.left | lifecycle | lock | — |
-| record_locks.lock.contended | lifecycle | lock | — |
-| record_locks.lock.released | crud | lock | — |
-| record_locks.lock.force_released | crud | lock | — |
-| record_locks.record.deleted | crud | record | — |
-| record_locks.conflict.detected | crud | conflict | — |
-| record_locks.conflict.resolved | crud | conflict | — |
-| record_locks.incoming_changes.available | lifecycle | change | — |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| record_locks.lock.acquired | crud | lock | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.participant.joined | lifecycle | lock | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.participant.left | lifecycle | lock | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.lock.contended | lifecycle | lock | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.lock.released | crud | lock | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.lock.force_released | crud | lock | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.record.deleted | crud | record | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.conflict.detected | crud | conflict | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.conflict.resolved | crud | conflict | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
+| record_locks.incoming_changes.available | lifecycle | change | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/events.ts) |
 
 ## ACL features  (4)
 
-record_locks.view · record_locks.manage · record_locks.force_release · record_locks.override_incoming
+| Feature | Source |
+|---|---|
+| record_locks.view | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| record_locks.manage | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| record_locks.force_release | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| record_locks.override_incoming | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
 
 ## API routes
 
@@ -44,7 +49,11 @@ _none_
 
 ## DI service tokens
 
-recordLockService · crudMutationGuardService · commandOptimisticLockGuardService
+| Token | Source |
+|---|---|
+| recordLockService | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:16](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L16) |
+| crudMutationGuardService | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:33](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L33) |
+| commandOptimisticLockGuardService | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:49](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L49) |
 
 ## Search entities
 
@@ -57,54 +66,101 @@ _none_
 
 ## UMES hosts
 
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| record_locks:record_lock | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| record_locks:record_lock_conflict | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| record_locks.conflict.detected | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.conflict.resolved | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.incoming_changes.available | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.lock.acquired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.lock.contended | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.lock.force_released | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.lock.released | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.participant.joined | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.participant.left | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| record_locks.record.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| record_locks:record_lock | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:record_locks:record_lock |
+| record_locks:record_lock_conflict | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:record_locks:record_lock_conflict |
+| record_locks.conflict.detected | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.conflict.detected |
+| record_locks.conflict.resolved | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.conflict.resolved |
+| record_locks.incoming_changes.available | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.incoming_changes.available |
+| record_locks.lock.acquired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.lock.acquired |
+| record_locks.lock.contended | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.lock.contended |
+| record_locks.lock.force_released | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.lock.force_released |
+| record_locks.lock.released | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.lock.released |
+| record_locks.participant.joined | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.participant.joined |
+| record_locks.participant.left | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.participant.left |
+| record_locks.record.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:record_locks.record.deleted |
 
 ## UMES contributions
 
-| ID | Kind | Target | Phase / operations | Contract | Resolution |
-|---|---|---|---|---|---|
-| record_locks.force-released-toast | browser-reaction | record_locks.lock.force_released | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; transports=notification-effect | fact-ref |
-| record_locks.incoming-changes-event | browser-reaction | record_locks.incoming_changes.available | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; transports=notification-effect | fact-ref |
-| record_locks.lock-contended-event | browser-reaction | record_locks.lock.contended | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; transports=notification-effect | fact-ref |
-| record_locks.record-deleted-event | browser-reaction | record_locks.record.deleted | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; transports=notification-effect | fact-ref |
-| record_locks.injection.crud-form-locking@crud-form:* | crud-form | crud-form:* | — | entityId=*; payload=render; requestHeaderCapability=false | pattern |
-| notification:record_locks.conflict.detected | specialized-registry | record_locks.conflict.detected | — | registry=notification; registryId=record_locks.conflict.detected; specialistRoute=notifications | fact-ref |
-| notification:record_locks.conflict.resolved | specialized-registry | record_locks.conflict.resolved | — | registry=notification; registryId=record_locks.conflict.resolved; specialistRoute=notifications | fact-ref |
-| notification:record_locks.incoming_changes.available | specialized-registry | record_locks.incoming_changes.available | — | registry=notification; registryId=record_locks.incoming_changes.available; specialistRoute=notifications | fact-ref |
-| notification:record_locks.lock.contended | specialized-registry | record_locks.lock.contended | — | registry=notification; registryId=record_locks.lock.contended; specialistRoute=notifications | fact-ref |
-| notification:record_locks.lock.force_released | specialized-registry | record_locks.lock.force_released | — | registry=notification; registryId=record_locks.lock.force_released; specialistRoute=notifications | fact-ref |
-| notification:record_locks.participant.joined | specialized-registry | record_locks.participant.joined | — | registry=notification; registryId=record_locks.participant.joined; specialistRoute=notifications | fact-ref |
-| notification:record_locks.participant.left | specialized-registry | record_locks.participant.left | — | registry=notification; registryId=record_locks.participant.left; specialistRoute=notifications | fact-ref |
-| notification:record_locks.record.deleted | specialized-registry | record_locks.record.deleted | — | registry=notification; registryId=record_locks.record.deleted; specialistRoute=notifications | fact-ref |
-| record_locks:conflict-detected-notification | subscriber | record_locks.conflict.detected | async-delivery | event=record_locks.conflict.detected; persistent=true; subscriberId=record_locks:conflict-detected-notification; sync=false | fact-ref |
-| record_locks:conflict-resolved-notification | subscriber | record_locks.conflict.resolved | async-delivery | event=record_locks.conflict.resolved; persistent=true; subscriberId=record_locks:conflict-resolved-notification; sync=false | fact-ref |
-| record_locks:incoming-changes-notification | subscriber | record_locks.incoming_changes.available | async-delivery | event=record_locks.incoming_changes.available; persistent=true; subscriberId=record_locks:incoming-changes-notification; sync=false | fact-ref |
-| record_locks:lock-contended-notification | subscriber | record_locks.lock.contended | async-delivery | event=record_locks.lock.contended; persistent=true; subscriberId=record_locks:lock-contended-notification; sync=false | fact-ref |
-| record_locks:lock-force-released-notification | subscriber | record_locks.lock.force_released | async-delivery | event=record_locks.lock.force_released; persistent=true; subscriberId=record_locks:lock-force-released-notification; sync=false | fact-ref |
-| record_locks:participant-joined-notification | subscriber | record_locks.participant.joined | async-delivery | event=record_locks.participant.joined; persistent=true; subscriberId=record_locks:participant-joined-notification; sync=false | fact-ref |
-| record_locks:participant-left-notification | subscriber | record_locks.participant.left | async-delivery | event=record_locks.participant.left; persistent=true; subscriberId=record_locks:participant-left-notification; sync=false | fact-ref |
-| record_locks:record-deleted-notification | subscriber | record_locks.record.deleted | async-delivery | event=record_locks.record.deleted; persistent=true; subscriberId=record_locks:record-deleted-notification; sync=false | fact-ref |
-| record_locks.injection.crud-form-locking@backend-mutation:global | widget | backend-mutation:global | — | executionGuard=host; payload=render; registryKey=record_locks.injection.crud-form-locking | framework |
-| record_locks.injection.crud-form-locking@backend:record:current | widget | backend:record:current | — | executionGuard=host; payload=render; registryKey=record_locks.injection.crud-form-locking | optional-external |
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| record_locks.force-released-toast | browser-reaction | record_locks.lock.force_released | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; overrideKey=record_locks.force-released-toast; transports=notification-effect | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.incoming-changes-event | browser-reaction | record_locks.incoming_changes.available | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; overrideKey=record_locks.incoming-changes-event; transports=notification-effect | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.lock-contended-event | browser-reaction | record_locks.lock.contended | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; overrideKey=record_locks.lock-contended-event; transports=notification-effect | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.record-deleted-event | browser-reaction | record_locks.record.deleted | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; overrideKey=record_locks.record-deleted-event; transports=notification-effect | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.injection.crud-form-locking@crud-form:* | crud-form | crud-form:* | — | entityId=*; payload=render; requestHeaderCapability=false | pattern | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+| notification:record_locks.conflict.detected | specialized-registry | record_locks.conflict.detected | — | registry=notification; registryId=record_locks.conflict.detected; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.conflict.resolved | specialized-registry | record_locks.conflict.resolved | — | registry=notification; registryId=record_locks.conflict.resolved; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.incoming_changes.available | specialized-registry | record_locks.incoming_changes.available | — | registry=notification; registryId=record_locks.incoming_changes.available; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.lock.contended | specialized-registry | record_locks.lock.contended | — | registry=notification; registryId=record_locks.lock.contended; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.lock.force_released | specialized-registry | record_locks.lock.force_released | — | registry=notification; registryId=record_locks.lock.force_released; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.participant.joined | specialized-registry | record_locks.participant.joined | — | registry=notification; registryId=record_locks.participant.joined; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.participant.left | specialized-registry | record_locks.participant.left | — | registry=notification; registryId=record_locks.participant.left; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.record.deleted | specialized-registry | record_locks.record.deleted | — | registry=notification; registryId=record_locks.record.deleted; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks:conflict-detected-notification | subscriber | record_locks.conflict.detected | async-delivery | event=record_locks.conflict.detected; persistent=true; subscriberId=record_locks:conflict-detected-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-detected-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-detected-notification.ts) |
+| record_locks:conflict-resolved-notification | subscriber | record_locks.conflict.resolved | async-delivery | event=record_locks.conflict.resolved; persistent=true; subscriberId=record_locks:conflict-resolved-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-resolved-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-resolved-notification.ts) |
+| record_locks:incoming-changes-notification | subscriber | record_locks.incoming_changes.available | async-delivery | event=record_locks.incoming_changes.available; persistent=true; subscriberId=record_locks:incoming-changes-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/incoming-changes-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/incoming-changes-notification.ts) |
+| record_locks:lock-contended-notification | subscriber | record_locks.lock.contended | async-delivery | event=record_locks.lock.contended; persistent=true; subscriberId=record_locks:lock-contended-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-contended-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-contended-notification.ts) |
+| record_locks:lock-force-released-notification | subscriber | record_locks.lock.force_released | async-delivery | event=record_locks.lock.force_released; persistent=true; subscriberId=record_locks:lock-force-released-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-force-released-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-force-released-notification.ts) |
+| record_locks:participant-joined-notification | subscriber | record_locks.participant.joined | async-delivery | event=record_locks.participant.joined; persistent=true; subscriberId=record_locks:participant-joined-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-joined-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-joined-notification.ts) |
+| record_locks:participant-left-notification | subscriber | record_locks.participant.left | async-delivery | event=record_locks.participant.left; persistent=true; subscriberId=record_locks:participant-left-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-left-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-left-notification.ts) |
+| record_locks:record-deleted-notification | subscriber | record_locks.record.deleted | async-delivery | event=record_locks.record.deleted; persistent=true; subscriberId=record_locks:record-deleted-notification; sync=false | fact-ref | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/record-deleted-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/record-deleted-notification.ts) |
+| record_locks.injection.crud-form-locking@backend-mutation:global | widget | backend-mutation:global | — | executionGuard=host; payload=render; registryKey=record_locks.injection.crud-form-locking | framework | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+| record_locks.injection.crud-form-locking@backend:record:current | widget | backend:record:current | — | executionGuard=host; payload=render; registryKey=record_locks.injection.crud-form-locking | optional-external | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| widget-spot:backend-mutation:global:widget-injection-consumer | widget-injection-consumer | widget-spot:backend-mutation:global @framework | widget, data-table, crud-form | — | hosts:framework.backend-mutation | [packages/ui/src](../../../packages/ui/src) |
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| notification:record_locks.conflict.detected | module:record_locks.conflict.detected @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.conflict.resolved | module:record_locks.conflict.resolved @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.incoming_changes.available | module:record_locks.incoming_changes.available @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.lock.contended | module:record_locks.lock.contended @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.lock.force_released | module:record_locks.lock.force_released @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.participant.joined | module:record_locks.participant.joined @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.participant.left | module:record_locks.participant.left @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notification:record_locks.record.deleted | module:record_locks.record.deleted @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks:conflict-detected-notification | event:record_locks.conflict.detected @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-detected-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-detected-notification.ts) |
+| record_locks:conflict-resolved-notification | event:record_locks.conflict.resolved @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-resolved-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-resolved-notification.ts) |
+| record_locks:incoming-changes-notification | event:record_locks.incoming_changes.available @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/incoming-changes-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/incoming-changes-notification.ts) |
+| record_locks:lock-contended-notification | event:record_locks.lock.contended @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-contended-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-contended-notification.ts) |
+| record_locks:lock-force-released-notification | event:record_locks.lock.force_released @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-force-released-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-force-released-notification.ts) |
+| record_locks:participant-joined-notification | event:record_locks.participant.joined @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-joined-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-joined-notification.ts) |
+| record_locks:participant-left-notification | event:record_locks.participant.left @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-left-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-left-notification.ts) |
+| record_locks:record-deleted-notification | event:record_locks.record.deleted @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/record-deleted-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/record-deleted-notification.ts) |
+| record_locks.force-released-toast | notification:record_locks.lock.force_released @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.incoming-changes-event | notification:record_locks.incoming_changes.available @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.injection.crud-form-locking@backend-mutation:global | widget-spot:backend-mutation:global | bound | widget-spot:backend-mutation:global:widget-injection-consumer | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+| record_locks.injection.crud-form-locking@backend:record:current | widget-spot:backend:record:current | optional-target-missing | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+| record_locks.injection.crud-form-locking@crud-form:* | wildcard:crud-form:* | wildcard | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+| record_locks.lock-contended-event | notification:record_locks.lock.contended @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| record_locks.record-deleted-event | notification:record_locks.record.deleted @record_locks | capability-only | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
 
 
 
 ## Notifications
 
-record_locks.participant.joined · record_locks.participant.left · record_locks.lock.contended · record_locks.lock.force_released · record_locks.record.deleted · record_locks.conflict.detected · record_locks.incoming_changes.available · record_locks.conflict.resolved
+| Notification ID | Source |
+|---|---|
+| record_locks.participant.joined | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.participant.left | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.lock.contended | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.lock.force_released | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.record.deleted | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.conflict.detected | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.incoming_changes.available | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| record_locks.conflict.resolved | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
 
 ## CLI commands
 
@@ -117,3 +173,66 @@ _none_
 ## AI agents
 
 _none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["record_locks.force_release"]` | disable-replace | aclFeatures:record_locks.force_release | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| acl | `overrides.acl.features["record_locks.manage"]` | disable-replace | aclFeatures:record_locks.manage | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| acl | `overrides.acl.features["record_locks.override_incoming"]` | disable-replace | aclFeatures:record_locks.override_incoming | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| acl | `overrides.acl.features["record_locks.view"]` | disable-replace | aclFeatures:record_locks.view | [node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/acl.ts) |
+| di | `overrides.di["commandOptimisticLockGuardService"]` | disable-replace | ownedContracts.di-registration:commandOptimisticLockGuardService | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:49](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L49) |
+| di | `overrides.di["crudMutationGuardService"]` | disable-replace | ownedContracts.di-registration:crudMutationGuardService | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:33](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L33) |
+| di | `overrides.di["recordLockService"]` | disable-replace | ownedContracts.di-registration:recordLockService | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:16](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L16) |
+| events | `overrides.events.subscribers["record_locks:conflict-detected-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:conflict-detected-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-detected-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-detected-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:conflict-resolved-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:conflict-resolved-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-resolved-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/conflict-resolved-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:incoming-changes-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:incoming-changes-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/incoming-changes-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/incoming-changes-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:lock-contended-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:lock-contended-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-contended-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-contended-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:lock-force-released-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:lock-force-released-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-force-released-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/lock-force-released-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:participant-joined-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:participant-joined-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-joined-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-joined-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:participant-left-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:participant-left-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-left-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/participant-left-notification.ts) |
+| events | `overrides.events.subscribers["record_locks:record-deleted-notification"]` | disable-replace | extensionSurfaces.contributions:record_locks:record-deleted-notification | [node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/record-deleted-notification.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/subscribers/record-deleted-notification.ts) |
+| notifications | `overrides.notifications.handlers["record_locks.force-released-toast"]` | disable-replace | extensionSurfaces.contributions:record_locks.force-released-toast | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| notifications | `overrides.notifications.handlers["record_locks.incoming-changes-event"]` | disable-replace | extensionSurfaces.contributions:record_locks.incoming-changes-event | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| notifications | `overrides.notifications.handlers["record_locks.lock-contended-event"]` | disable-replace | extensionSurfaces.contributions:record_locks.lock-contended-event | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| notifications | `overrides.notifications.handlers["record_locks.record-deleted-event"]` | disable-replace | extensionSurfaces.contributions:record_locks.record-deleted-event | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.handlers.ts) |
+| notifications | `overrides.notifications.types["record_locks.conflict.detected"]` | disable-replace | notifications:record_locks.conflict.detected | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.conflict.resolved"]` | disable-replace | notifications:record_locks.conflict.resolved | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.incoming_changes.available"]` | disable-replace | notifications:record_locks.incoming_changes.available | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.lock.contended"]` | disable-replace | notifications:record_locks.lock.contended | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.lock.force_released"]` | disable-replace | notifications:record_locks.lock.force_released | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.participant.joined"]` | disable-replace | notifications:record_locks.participant.joined | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.participant.left"]` | disable-replace | notifications:record_locks.participant.left | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| notifications | `overrides.notifications.types["record_locks.record.deleted"]` | disable-replace | notifications:record_locks.record.deleted | [node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/notifications.ts) |
+| routes | `overrides.routes.pages["backend:/backend/settings/record-locks"]` | disable-replace | backendPages:/backend/settings/record-locks | [node_modules/@open-mercato/enterprise/src/modules/record_locks/backend/settings/record-locks/page.tsx](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/backend/settings/record-locks/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:record_locks:setup | [node_modules/@open-mercato/enterprise/src/modules/record_locks/setup.ts:5](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/setup.ts#L5) |
+| setup | `overrides.setup.onTenantCreated` | replace | ownedContracts.setup:record_locks:setup | [node_modules/@open-mercato/enterprise/src/modules/record_locks/setup.ts:5](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/setup.ts#L5) |
+| widgets | `overrides.widgets.injection["record_locks.injection.crud-form-locking"]` | disable-replace | extensionSurfaces.contributions:record_locks.injection.crud-form-locking@backend-mutation:global | [node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/widgets/injection-table.ts) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| record_locks | name=record_locks; version=0.1.0 | [node_modules/@open-mercato/enterprise/src/modules/record_locks/index.ts:3](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/index.ts#L3) |
+
+## Domain commands
+
+| ID | Metadata | Source |
+|---|---|---|
+| record_locks.conflict.accept_incoming | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/commands/conflicts.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/commands/conflicts.ts) |
+| record_locks.conflict.accept_mine | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/commands/conflicts.ts](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/commands/conflicts.ts) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| record_locks:setup | hooks=onTenantCreated; roles=admin, employee, superadmin | [node_modules/@open-mercato/enterprise/src/modules/record_locks/setup.ts:5](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/setup.ts#L5) |
+
+## DI registrations (rich)
+
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| commandOptimisticLockGuardService | function | scoped | — | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:49](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L49) |
+| crudMutationGuardService | function | scoped | — | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:33](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L33) |
+| recordLockService | function | scoped | — | — | [node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts:16](../../../node_modules/@open-mercato/enterprise/src/modules/record_locks/di.ts#L16) |