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

package/dist/agentic/guides/reference-modules/example.md

@@ -0,0 +1,451 @@
+# example — module facts (generated reference projection, do not edit)
+<!-- generated from local reference src/modules/example; source-fingerprint de76e2970088560071c926d4c13d2eb8a21d19623d8bc5d7435a6faa0d3563bc; taxonomy-fingerprint efcb086ab353a25d2056530357f853c5a16ddcc091e667aa048f435ddacebd98 — R1 staleness stamp -->
+> Reference projection: `example` is not selected by the current runtime. Its activations and exact override targets describe behavior only after opt-in in `src/modules.ts`.
+Source root: src/modules/example
+
+## Entities
+
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| example:example_item | ExampleItem | example_items | no | no | [src/modules/example/data/entities.ts](../../../src/modules/example/data/entities.ts) |
+| example:todo | Todo | todos | yes | yes | [src/modules/example/data/entities.ts](../../../src/modules/example/data/entities.ts) |
+| example:example_todo_bulk_operation | ExampleTodoBulkOperation | example_todo_bulk_operations | yes | no | [src/modules/example/data/entities.ts](../../../src/modules/example/data/entities.ts) |
+| example:example_customer_priority | ExampleCustomerPriority | example_customer_priorities | yes | no | [src/modules/example/data/entities.ts](../../../src/modules/example/data/entities.ts) |
+
+## Events  (4)
+
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| example.todo.created | crud | todo | client | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.updated | crud | todo | client | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.deleted | crud | todo | client | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo_announcement.published | lifecycle | todo_announcement | portal | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+
+## ACL features  (9)
+
+| Feature | Source |
+|---|---|
+| example.backend | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.manage | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.view | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.todos.view | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.todos.manage | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.widgets.injection | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.widgets.todo | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.widgets.welcome | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| example.widgets.notes | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+
+## API routes
+
+_none_
+
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/blog/[id] | [src/modules/example/backend/blog/[id]/page.tsx](../../../src/modules/example/backend/blog/[id]/page.tsx) |
+| /backend/example | [src/modules/example/backend/page.tsx](../../../src/modules/example/backend/page.tsx) |
+| /backend/mutation-lifecycle | [src/modules/example/backend/mutation-lifecycle/page.tsx](../../../src/modules/example/backend/mutation-lifecycle/page.tsx) |
+| /backend/payments | [src/modules/example/backend/payments/page.tsx](../../../src/modules/example/backend/payments/page.tsx) |
+| /backend/products | [src/modules/example/backend/products/page.tsx](../../../src/modules/example/backend/products/page.tsx) |
+| /backend/todos | [src/modules/example/backend/todos/page.tsx](../../../src/modules/example/backend/todos/page.tsx) |
+| /backend/todos/[id]/edit | [src/modules/example/backend/todos/[id]/edit/page.tsx](../../../src/modules/example/backend/todos/[id]/edit/page.tsx) |
+| /backend/todos/create | [src/modules/example/backend/todos/create/page.tsx](../../../src/modules/example/backend/todos/create/page.tsx) |
+| /backend/umes-extensions | [src/modules/example/backend/umes-extensions/page.tsx](../../../src/modules/example/backend/umes-extensions/page.tsx) |
+| /backend/umes-handlers | [src/modules/example/backend/umes-handlers/page.tsx](../../../src/modules/example/backend/umes-handlers/page.tsx) |
+| /backend/umes-integrations | [src/modules/example/backend/umes-integrations/page.tsx](../../../src/modules/example/backend/umes-integrations/page.tsx) |
+| /backend/umes-next-phases | [src/modules/example/backend/umes-next-phases/page.tsx](../../../src/modules/example/backend/umes-next-phases/page.tsx) |
+| /backend/umes-query-extensions | [src/modules/example/backend/umes-query-extensions/page.tsx](../../../src/modules/example/backend/umes-query-extensions/page.tsx) |
+
+## Frontend pages
+
+| ID / path | Source |
+|---|---|
+| /blog/[id] | [src/modules/example/frontend/blog/[id]/page.tsx](../../../src/modules/example/frontend/blog/[id]/page.tsx) |
+| /example | [src/modules/example/frontend/example.tsx](../../../src/modules/example/frontend/example.tsx) |
+
+## DI service tokens
+
+| Token | Source |
+|---|---|
+| exampleTodoSummaryService | [src/modules/example/di.ts:34](../../../src/modules/example/di.ts#L34) |
+
+## Search entities
+
+| Entity ID | Source |
+|---|---|
+| example:todo | [src/modules/example/search.ts](../../../src/modules/example/search.ts) |
+
+## Host extension points
+
+- Entity IDs: _none_
+- Table IDs: example.products.list · example.todos.list · example.umes.extensions
+
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| crud-form:example.todo | crud-form | render-widget, lifecycle-handler | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| crud-form:example.todo | crud-form | component-replacement | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| crud-form:example.todo:fields | crud-form | field-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| crud-form:example.todo:header | crud-form | render-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list | data-table | component-replacement | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:bulk-actions | data-table | bulk-action | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:columns | data-table | column-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:filters | data-table | filter-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:footer | data-table | render-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:header | data-table | render-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:row-actions | data-table | row-action | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:search-trailing | data-table | render-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| data-table:example.todos.list:toolbar | data-table | toolbar-widget | — | FROZEN | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| example:example_customer_priority | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:example:example_customer_priority |
+| example:example_item | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:example:example_item |
+| example:example_todo_bulk_operation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:example:example_todo_bulk_operation |
+| example:todo | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:example:todo |
+| example.todo_announcement.published | event | async-subscriber, sync-subscriber, browser-portal | tenant-organization-and-audience | STABLE | events:example.todo_announcement.published |
+| example.todo.created | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:example.todo.created |
+| example.todo.deleted | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:example.todo.deleted |
+| example.todo.updated | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:example.todo.updated |
+| example.todo.queried | query-lifecycle | sync-subscriber | tenant-and-organization-reapplied-after-result | STABLE | searchEntities:example:todo |
+| example.todo.querying | query-lifecycle | sync-subscriber | tenant-and-organization-reapplied-after-result | STABLE | searchEntities:example:todo |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| example.block-test-todos | api-interceptor | example/todos | before | activation=crud-pipeline; failurePosture=fallback; methods=POST,PUT; phases=before; route=example/todos; timeoutMs=2000 | fact-ref | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.customer-priority-filter | api-interceptor | customers/people | before | activation=crud-pipeline; failurePosture=fallback; methods=GET; phases=before; route=customers/people; timeoutMs=2000 | fact-ref | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-probe-bad-query | api-interceptor | example/todos | before | activation=crud-pipeline; failurePosture=fallback; methods=GET; phases=before; route=example/todos; timeoutMs=2000 | fact-ref | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-probe-crash | api-interceptor | example/todos | before | activation=crud-pipeline; failurePosture=fallback; methods=GET; phases=before; route=example/todos; timeoutMs=2000 | fact-ref | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-probe-timeout | api-interceptor | example/todos | before | activation=crud-pipeline; failurePosture=fallback; methods=GET; phases=before; route=example/todos; timeoutMs=2000 | fact-ref | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-response-meta | api-interceptor | example/todos | before, after | activation=crud-pipeline; failurePosture=fallback; methods=GET; phases=before,after; route=example/todos; timeoutMs=2000 | fact-ref | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.wildcard-probe | api-interceptor | example/* | before, after | activation=crud-pipeline; failurePosture=fallback; methods=GET; phases=before,after; route=example/*; timeoutMs=2000 | pattern | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todo_announcement.published.browser | browser-reaction | example.todo_announcement.published | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=usePortalAppEvent; transports=portal | fact-ref | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.created.browser | browser-reaction | example.todo.created | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.deleted.browser | browser-reaction | example.todo.deleted | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.updated.browser | browser-reaction | example.todo.updated | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.umes.actionable-toast | browser-reaction | example.umes.actionable | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useNotificationEffect; overrideKey=example.umes.actionable-toast; transports=notification-effect | fact-ref | [src/modules/example/notifications.handlers.ts](../../../src/modules/example/notifications.handlers.ts) |
+| example.audit-logging | command-interceptor | customers.* | before-execute, after-execute | phases=before-execute,after-execute; targetCommand=customers.* | pattern | [src/modules/example/commands/interceptors.ts](../../../src/modules/example/commands/interceptors.ts) |
+| example.component-override.0:section:ui.detail.NotesSection | component-override | section:ui.detail.NotesSection | — | handle=section:ui.detail.NotesSection; mode=wrapper; propsContract=component-props-schema | optional-external | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| example.component-override.1:section:checkout.pay-page.summary | component-override | section:checkout.pay-page.summary | — | handle=section:checkout.pay-page.summary; mode=wrapper; propsContract=component-props-schema | exact | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| example.component-override.2:section:checkout.pay-page.help | component-override | section:checkout.pay-page.help | — | handle=section:checkout.pay-page.help; mode=wrapper; propsContract=component-props-schema | exact | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| example.injection.crud-validation@crud-form:catalog.catalog_product | crud-form | crud-form:catalog.catalog_product | — | entityId=catalog.catalog_product; payload=render; requestHeaderCapability=false | framework | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.catalog_variant | crud-form | crud-form:catalog.catalog_variant | — | entityId=catalog.catalog_variant; payload=render; requestHeaderCapability=false | framework | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.product | crud-form | crud-form:catalog.product | — | entityId=catalog.product; payload=render; requestHeaderCapability=false | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.variant | crud-form | crud-form:catalog.variant | — | entityId=catalog.variant; payload=render; requestHeaderCapability=false | framework | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:example.todo | crud-form | crud-form:example.todo | — | entityId=example.todo; payload=render; requestHeaderCapability=false | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-field@crud-form:customers.customer_entity:fields | crud-form | crud-form:customers.customer_entity:fields | — | entityId=customers.customer_entity; payload=field; requestHeaderCapability=true | framework | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-field@crud-form:customers.person:fields | crud-form | crud-form:customers.person:fields | — | entityId=customers.person; payload=field; requestHeaderCapability=true | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.catalog-seo-report@data-table:catalog.products:header | data-table | data-table:catalog.products:header | — | executionGuard=host; payload=render; tableId=catalog.products | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-bulk-actions@data-table:customers.people:bulk-actions | data-table | data-table:customers.people:bulk-actions | — | executionGuard=host; payload=bulk-action; tableId=customers.people | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-bulk-actions@data-table:customers.people.list:bulk-actions | data-table | data-table:customers.people.list:bulk-actions | — | executionGuard=host; payload=bulk-action; tableId=customers.people.list | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-column@data-table:customers.people:columns | data-table | data-table:customers.people:columns | — | executionGuard=host; payload=column; tableId=customers.people | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-column@data-table:customers.people.list:columns | data-table | data-table:customers.people.list:columns | — | executionGuard=host; payload=column; tableId=customers.people.list | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-filter@data-table:customers.people:filters | data-table | data-table:customers.people:filters | — | executionGuard=host; payload=filter; tableId=customers.people | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-filter@data-table:customers.people.list:filters | data-table | data-table:customers.people.list:filters | — | executionGuard=host; payload=filter; tableId=customers.people.list | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-row-action@data-table:customers.people:row-actions | data-table | data-table:customers.people:row-actions | — | executionGuard=host; payload=row-action; tableId=customers.people | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-row-action@data-table:customers.people.list:row-actions | data-table | data-table:customers.people.list:row-actions | — | executionGuard=host; payload=row-action; tableId=customers.people.list | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.todo-bulk-complete@data-table:example.todos.list:bulk-actions | data-table | data-table:example.todos.list:bulk-actions | — | executionGuard=host; payload=bulk-action; tableId=example.todos.list | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.entity-extension.0:customers:customer_entity->example:example_customer_priority | entity-extension | customers:customer_entity | — | extensionEntityId=example:example_customer_priority; hostEntityId=customers:customer_entity; linkId=id:customer_id; orphanContract=optional; scopeContract=tenant-and-organization | fact-ref | [src/modules/example/data/extensions.ts](../../../src/modules/example/data/extensions.ts) |
+| example.todo-limit | mutation-guard | example.todo | create | capabilities=block,rewrite; entityId=example.todo; operations=create; optimisticLock=preserved | unresolved | [src/modules/example/data/guards.ts](../../../src/modules/example/data/guards.ts) |
+| example.customer-todo-count | response-enricher | customers.person | list, detail | cachePosture=rerun-on-list-cache-hit; critical=false; fallback=configured; surfaces=list,detail; targetEntity=customers.person; timeoutMs=2000 | exact | [src/modules/example/data/enrichers.ts](../../../src/modules/example/data/enrichers.ts) |
+| ai:example.get_customer_priority | specialized-registry | example.get_customer_priority | — | registry=ai; registryId=example.get_customer_priority; specialistRoute=aiTools | fact-ref | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| ai:example.get_todo_summary | specialized-registry | example.get_todo_summary | — | registry=ai; registryId=example.get_todo_summary; specialistRoute=aiTools | fact-ref | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| ai:example.todo_assistant | specialized-registry | example.todo_assistant | — | registry=ai; registryId=example.todo_assistant; specialistRoute=aiAgents | fact-ref | [src/modules/example/ai-agents.ts](../../../src/modules/example/ai-agents.ts) |
+| notification:example.umes.actionable | specialized-registry | example.umes.actionable | — | registry=notification; registryId=example.umes.actionable; specialistRoute=notifications | fact-ref | [src/modules/example/notifications.ts](../../../src/modules/example/notifications.ts) |
+| payment:mock | specialized-registry | mock | — | registry=payment; registryId=mock; specialistRoute=paymentGateways | fact-ref | [src/modules/example/di.ts](../../../src/modules/example/di.ts) |
+| payment:mock_processing | specialized-registry | mock_processing | — | registry=payment; registryId=mock_processing; specialistRoute=paymentGateways | fact-ref | [src/modules/example/di.ts](../../../src/modules/example/di.ts) |
+| payment:mock_usd | specialized-registry | mock_usd | — | registry=payment; registryId=mock_usd; specialistRoute=paymentGateways | fact-ref | [src/modules/example/di.ts](../../../src/modules/example/di.ts) |
+| search:example:todo | specialized-registry | example:todo | — | registry=search; registryId=example:todo; specialistRoute=search | fact-ref | [src/modules/example/search.ts](../../../src/modules/example/search.ts) |
+| example:announce-todo-to-portal | subscriber | example.todo.* | before-or-after | event=example.todo.*; persistent=false; subscriberId=example:announce-todo-to-portal; sync=true | pattern | [src/modules/example/subscribers/announce-todo-to-portal.ts](../../../src/modules/example/subscribers/announce-todo-to-portal.ts) |
+| example:audit-delete | subscriber | example.todo.deleted | before-or-after | event=example.todo.deleted; persistent=false; priority=50; subscriberId=example:audit-delete; sync=true | fact-ref | [src/modules/example/subscribers/audit-delete.ts](../../../src/modules/example/subscribers/audit-delete.ts) |
+| example:auto-default-priority | subscriber | example.todo.creating | before-or-after | event=example.todo.creating; persistent=false; priority=50; subscriberId=example:auto-default-priority; sync=true | unresolved | [src/modules/example/subscribers/auto-default-priority.ts](../../../src/modules/example/subscribers/auto-default-priority.ts) |
+| example:example-event | subscriber | example.ping | before-or-after | event=example.ping; persistent=false; subscriberId=example:example-event; sync=true | unresolved | [src/modules/example/subscribers/example-event.ts](../../../src/modules/example/subscribers/example-event.ts) |
+| example:invalidate-todo-summary | subscriber | example.todo.* | before-or-after | event=example.todo.*; persistent=false; subscriberId=example:invalidate-todo-summary; sync=true | pattern | [src/modules/example/subscribers/invalidate-todo-summary.ts](../../../src/modules/example/subscribers/invalidate-todo-summary.ts) |
+| example:prevent-uncomplete | subscriber | example.todo.updating | before-or-after | event=example.todo.updating; persistent=false; priority=60; subscriberId=example:prevent-uncomplete; sync=true | unresolved | [src/modules/example/subscribers/prevent-uncomplete.ts](../../../src/modules/example/subscribers/prevent-uncomplete.ts) |
+| dashboard:example.dashboard.notes | widget | dashboard:example.dashboard.notes | — | executionGuard=both; payload=dashboard; registryKey=example.dashboard.notes | framework | [src/modules/example/widgets/dashboard/notes/widget.ts](../../../src/modules/example/widgets/dashboard/notes/widget.ts) |
+| dashboard:example.dashboard.todos | widget | dashboard:example.dashboard.todos | — | executionGuard=both; payload=dashboard; registryKey=example.dashboard.todos | framework | [src/modules/example/widgets/dashboard/todos/widget.ts](../../../src/modules/example/widgets/dashboard/todos/widget.ts) |
+| dashboard:example.dashboard.welcome | widget | dashboard:example.dashboard.welcome | — | executionGuard=both; payload=dashboard; registryKey=example.dashboard.welcome | framework | [src/modules/example/widgets/dashboard/welcome/widget.ts](../../../src/modules/example/widgets/dashboard/welcome/widget.ts) |
+| example.injection.crud-validation-addon@widget:example.injection.crud-validation:addon | widget | widget:example.injection.crud-validation:addon | — | executionGuard=host; payload=render; registryKey=example.injection.crud-validation-addon | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@example:phase-c-handlers | widget | example:phase-c-handlers | — | executionGuard=host; payload=render; registryKey=example.injection.crud-validation | unresolved | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-detail@customers.person.detail:details | widget | customers.person.detail:details | — | executionGuard=host; payload=render; registryKey=example.injection.customer-priority-detail | exact | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.example-menus@menu:sidebar:main | widget | menu:sidebar:main | — | executionGuard=host; payload=render; registryKey=example.injection.example-menus | framework | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.example-profile-menu@menu:topbar:profile-dropdown | widget | menu:topbar:profile-dropdown | — | executionGuard=host; payload=render; registryKey=example.injection.example-profile-menu | framework | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.portal-quick-links@portal:dashboard:sections | widget | portal:dashboard:sections | — | executionGuard=host; payload=render; registryKey=example.injection.portal-quick-links | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.portal-recent-activity@portal:dashboard:sections | widget | portal:dashboard:sections | — | executionGuard=host; payload=render; registryKey=example.injection.portal-recent-activity | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.portal-stats@portal:dashboard:sections | widget | portal:dashboard:sections | — | executionGuard=host; payload=render; registryKey=example.injection.portal-stats | optional-external | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.sales-todos@sales.document.detail.order:tabs | widget | sales.document.detail.order:tabs | — | executionGuard=host; payload=render; registryKey=example.injection.sales-todos | pattern | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.sales-todos@sales.document.detail.quote:tabs | widget | sales.document.detail.quote:tabs | — | executionGuard=host; payload=render; registryKey=example.injection.sales-todos | pattern | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+
+## Active extension bindings
+
+| Activation | Kind | Host | Contribution kinds | Phases | Bridge | Source |
+|---|---|---|---|---|---|---|
+| api-route:example/todos:GET:api-interceptor-bridge | api-interceptor-bridge | api-route:example/todos GET @example | api-interceptor | before | apiRoutes:/example/todos | [src/modules/example/api/todos/route.ts](../../../src/modules/example/api/todos/route.ts) |
+| api-route:example/todos:POST:api-interceptor-bridge | api-interceptor-bridge | api-route:example/todos POST @example | api-interceptor | before | apiRoutes:/example/todos | [src/modules/example/api/todos/route.ts](../../../src/modules/example/api/todos/route.ts) |
+| api-route:example/todos:PUT:api-interceptor-bridge | api-interceptor-bridge | api-route:example/todos PUT @example | api-interceptor | before | apiRoutes:/example/todos | [src/modules/example/api/todos/route.ts](../../../src/modules/example/api/todos/route.ts) |
+| entity:example:todo:mutation-guard | mutation-guard | entity:example:todo @example | mutation-guard | — | — | [src/modules/example/api/todos/bulk-complete/route.ts:64](../../../src/modules/example/api/todos/bulk-complete/route.ts#L64) |
+| widget-spot:crud-form:catalog.catalog_product:widget-injection-consumer | widget-injection-consumer | widget-spot:crud-form:catalog.catalog_product @framework | widget, data-table, crud-form | — | hosts:framework.crud-form-wildcard | packages/ui/src |
+| widget-spot:crud-form:catalog.catalog_variant:widget-injection-consumer | widget-injection-consumer | widget-spot:crud-form:catalog.catalog_variant @framework | widget, data-table, crud-form | — | hosts:framework.crud-form-wildcard | packages/ui/src |
+| widget-spot:crud-form:catalog.variant:widget-injection-consumer | widget-injection-consumer | widget-spot:crud-form:catalog.variant @framework | widget, data-table, crud-form | — | hosts:framework.crud-form-wildcard | packages/ui/src |
+| widget-spot:crud-form:customers.customer_entity:fields:widget-injection-consumer | widget-injection-consumer | widget-spot:crud-form:customers.customer_entity:fields @framework | widget, data-table, crud-form | — | hosts:framework.crud-form-wildcard | packages/ui/src |
+| widget-spot:crud-form:example.todo:widget-injection-consumer | widget-injection-consumer | widget-spot:crud-form:example.todo @example | widget, data-table, crud-form | — | hosts:todoForm.base | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+| widget-spot:dashboard:example.dashboard.notes:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:example.dashboard.notes @framework | widget | — | hosts:framework.dashboard | packages/ui/src |
+| widget-spot:dashboard:example.dashboard.todos:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:example.dashboard.todos @framework | widget | — | hosts:framework.dashboard | packages/ui/src |
+| widget-spot:dashboard:example.dashboard.welcome:dashboard-host-consumer | dashboard-host-consumer | widget-spot:dashboard:example.dashboard.welcome @framework | widget | — | hosts:framework.dashboard | packages/ui/src |
+| widget-spot:data-table:example.todos.list:bulk-actions:widget-injection-consumer | widget-injection-consumer | widget-spot:data-table:example.todos.list:bulk-actions @example | widget, data-table, crud-form | — | hosts:todosTable.bulkActions | [src/modules/example/extension-points.ts](../../../src/modules/example/extension-points.ts) |
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| ai:example.get_customer_priority | module:example.get_customer_priority | capability-only | — | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| ai:example.get_todo_summary | module:example.get_todo_summary | capability-only | — | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| ai:example.todo_assistant | module:example.todo_assistant | capability-only | — | [src/modules/example/ai-agents.ts](../../../src/modules/example/ai-agents.ts) |
+| dashboard:example.dashboard.notes | widget-spot:dashboard:example.dashboard.notes | bound | widget-spot:dashboard:example.dashboard.notes:dashboard-host-consumer | [src/modules/example/widgets/dashboard/notes/widget.ts](../../../src/modules/example/widgets/dashboard/notes/widget.ts) |
+| dashboard:example.dashboard.todos | widget-spot:dashboard:example.dashboard.todos | bound | widget-spot:dashboard:example.dashboard.todos:dashboard-host-consumer | [src/modules/example/widgets/dashboard/todos/widget.ts](../../../src/modules/example/widgets/dashboard/todos/widget.ts) |
+| dashboard:example.dashboard.welcome | widget-spot:dashboard:example.dashboard.welcome | bound | widget-spot:dashboard:example.dashboard.welcome:dashboard-host-consumer | [src/modules/example/widgets/dashboard/welcome/widget.ts](../../../src/modules/example/widgets/dashboard/welcome/widget.ts) |
+| example:announce-todo-to-portal | wildcard:example.todo.* | wildcard | — | [src/modules/example/subscribers/announce-todo-to-portal.ts](../../../src/modules/example/subscribers/announce-todo-to-portal.ts) |
+| example:audit-delete | event:example.todo.deleted @example | capability-only | — | [src/modules/example/subscribers/audit-delete.ts](../../../src/modules/example/subscribers/audit-delete.ts) |
+| example:auto-default-priority | event:example.todo.creating | unresolved | — | [src/modules/example/subscribers/auto-default-priority.ts](../../../src/modules/example/subscribers/auto-default-priority.ts) |
+| example:example-event | event:example.ping | unresolved | — | [src/modules/example/subscribers/example-event.ts](../../../src/modules/example/subscribers/example-event.ts) |
+| example:invalidate-todo-summary | wildcard:example.todo.* | wildcard | — | [src/modules/example/subscribers/invalidate-todo-summary.ts](../../../src/modules/example/subscribers/invalidate-todo-summary.ts) |
+| example:prevent-uncomplete | event:example.todo.updating | unresolved | — | [src/modules/example/subscribers/prevent-uncomplete.ts](../../../src/modules/example/subscribers/prevent-uncomplete.ts) |
+| example.audit-logging | wildcard:customers.* | wildcard | — | [src/modules/example/commands/interceptors.ts](../../../src/modules/example/commands/interceptors.ts) |
+| example.block-test-todos | api-route:example/todos @example | bound | api-route:example/todos:POST:api-interceptor-bridge, api-route:example/todos:PUT:api-interceptor-bridge | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.component-override.0:section:ui.detail.NotesSection | component:section:ui.detail.NotesSection | optional-target-missing | — | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| example.component-override.1:section:checkout.pay-page.summary | component:section:checkout.pay-page.summary @checkout | bound | component:section:checkout.pay-page.summary:component-extension-consumer | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| example.component-override.2:section:checkout.pay-page.help | component:section:checkout.pay-page.help @checkout | bound | component:section:checkout.pay-page.help:component-extension-consumer | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| example.customer-priority-filter | api-route:customers/people @customers | bound | api-route:customers/people:GET:api-interceptor-bridge | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.customer-todo-count | entity:customers.person @customers | bound | entity:customers.person:crud-response-enricher | [src/modules/example/data/enrichers.ts](../../../src/modules/example/data/enrichers.ts) |
+| example.entity-extension.0:customers:customer_entity->example:example_customer_priority | entity:customers:customer_entity @customers | capability-only | — | [src/modules/example/data/extensions.ts](../../../src/modules/example/data/extensions.ts) |
+| example.injection.catalog-seo-report@data-table:catalog.products:header | widget-spot:data-table:catalog.products:header @catalog | bound | widget-spot:data-table:catalog.products:header:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation-addon@widget:example.injection.crud-validation:addon | widget-spot:widget:example.injection.crud-validation:addon | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.catalog_product | widget-spot:crud-form:catalog.catalog_product | bound | widget-spot:crud-form:catalog.catalog_product:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.catalog_variant | widget-spot:crud-form:catalog.catalog_variant | bound | widget-spot:crud-form:catalog.catalog_variant:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.product | widget-spot:crud-form:catalog.product @catalog | bound | widget-spot:crud-form:catalog.product:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:catalog.variant | widget-spot:crud-form:catalog.variant | bound | widget-spot:crud-form:catalog.variant:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@crud-form:example.todo | widget-spot:crud-form:example.todo @example | bound | widget-spot:crud-form:example.todo:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.crud-validation@example:phase-c-handlers | widget-spot:example:phase-c-handlers | unresolved | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-bulk-actions@data-table:customers.people:bulk-actions | widget-spot:data-table:customers.people:bulk-actions | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-bulk-actions@data-table:customers.people.list:bulk-actions | widget-spot:data-table:customers.people.list:bulk-actions @customers | bound | widget-spot:data-table:customers.people.list:bulk-actions:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-column@data-table:customers.people:columns | widget-spot:data-table:customers.people:columns | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-column@data-table:customers.people.list:columns | widget-spot:data-table:customers.people.list:columns @customers | bound | widget-spot:data-table:customers.people.list:columns:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-detail@customers.person.detail:details | widget-spot:customers.person.detail:details @customers | bound | widget-spot:customers.person.detail:details:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-field@crud-form:customers.customer_entity:fields | widget-spot:crud-form:customers.customer_entity:fields | bound | widget-spot:crud-form:customers.customer_entity:fields:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-field@crud-form:customers.person:fields | widget-spot:crud-form:customers.person:fields @customers | bound | widget-spot:crud-form:customers.person:fields:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-filter@data-table:customers.people:filters | widget-spot:data-table:customers.people:filters | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-filter@data-table:customers.people.list:filters | widget-spot:data-table:customers.people.list:filters @customers | bound | widget-spot:data-table:customers.people.list:filters:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-row-action@data-table:customers.people:row-actions | widget-spot:data-table:customers.people:row-actions | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.customer-priority-row-action@data-table:customers.people.list:row-actions | widget-spot:data-table:customers.people.list:row-actions @customers | bound | widget-spot:data-table:customers.people.list:row-actions:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.example-menus@menu:sidebar:main | widget-spot:menu:sidebar:main | capability-only | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.example-profile-menu@menu:topbar:profile-dropdown | widget-spot:menu:topbar:profile-dropdown | capability-only | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.portal-quick-links@portal:dashboard:sections | widget-spot:portal:dashboard:sections | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.portal-recent-activity@portal:dashboard:sections | widget-spot:portal:dashboard:sections | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.portal-stats@portal:dashboard:sections | widget-spot:portal:dashboard:sections | optional-target-missing | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.sales-todos@sales.document.detail.order:tabs | widget-spot:sales.document.detail.order:tabs | wildcard | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.sales-todos@sales.document.detail.quote:tabs | widget-spot:sales.document.detail.quote:tabs | wildcard | — | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.injection.todo-bulk-complete@data-table:example.todos.list:bulk-actions | widget-spot:data-table:example.todos.list:bulk-actions @example | bound | widget-spot:data-table:example.todos.list:bulk-actions:widget-injection-consumer | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| example.todo_announcement.published.browser | event:example.todo_announcement.published @example | capability-only | — | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo-limit | entity:example.todo | unresolved | — | [src/modules/example/data/guards.ts](../../../src/modules/example/data/guards.ts) |
+| example.todo.created.browser | event:example.todo.created @example | capability-only | — | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.deleted.browser | event:example.todo.deleted @example | capability-only | — | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todo.updated.browser | event:example.todo.updated @example | capability-only | — | [src/modules/example/events.ts](../../../src/modules/example/events.ts) |
+| example.todos-probe-bad-query | api-route:example/todos @example | bound | api-route:example/todos:GET:api-interceptor-bridge | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-probe-crash | api-route:example/todos @example | bound | api-route:example/todos:GET:api-interceptor-bridge | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-probe-timeout | api-route:example/todos @example | bound | api-route:example/todos:GET:api-interceptor-bridge | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.todos-response-meta | api-route:example/todos @example | bound | api-route:example/todos:GET:api-interceptor-bridge | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| example.umes.actionable-toast | notification:example.umes.actionable | capability-only | — | [src/modules/example/notifications.handlers.ts](../../../src/modules/example/notifications.handlers.ts) |
+| example.wildcard-probe | wildcard:example/* | wildcard | — | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| notification:example.umes.actionable | module:example.umes.actionable | capability-only | — | [src/modules/example/notifications.ts](../../../src/modules/example/notifications.ts) |
+| payment:mock_processing | module:mock_processing | capability-only | — | [src/modules/example/di.ts](../../../src/modules/example/di.ts) |
+| payment:mock_usd | module:mock_usd | capability-only | — | [src/modules/example/di.ts](../../../src/modules/example/di.ts) |
+| payment:mock | module:mock | capability-only | — | [src/modules/example/di.ts](../../../src/modules/example/di.ts) |
+| search:example:todo | module:example:todo @example | capability-only | — | [src/modules/example/search.ts](../../../src/modules/example/search.ts) |
+
+## UMES diagnostics
+
+- unbound-helper: crud-form:example.todo:after-fields
+- unbound-helper: crud-form:example.todo:before-fields
+- unbound-helper: crud-form:example.todo:field:{fieldId}:after
+- unbound-helper: crud-form:example.todo:field:{fieldId}:before
+- unbound-helper: crud-form:example.todo:footer
+- unbound-helper: crud-form:example.todo:group:{groupId}
+- unbound-helper: crud-form:example.todo:sidebar
+- unbound-helper: data-table:example.todos.list:empty-state
+- unresolved-first-party-target: example:auto-default-priority:example.todo.creating (src/modules/example/subscribers/auto-default-priority.ts)
+- unresolved-first-party-target: example:example-event:example.ping (src/modules/example/subscribers/example-event.ts)
+- unresolved-first-party-target: example:prevent-uncomplete:example.todo.updating (src/modules/example/subscribers/prevent-uncomplete.ts)
+- unresolved-first-party-target: example.injection.crud-validation@example:phase-c-handlers:example:phase-c-handlers (src/modules/example/widgets/injection-table.ts)
+- unresolved-first-party-target: example.todo-limit:example.todo (src/modules/example/data/guards.ts)
+
+## Notifications
+
+| Notification ID | Source |
+|---|---|
+| example.umes.actionable | [src/modules/example/notifications.ts](../../../src/modules/example/notifications.ts) |
+
+## CLI commands
+
+| ID / path | Source |
+|---|---|
+| hello | [src/modules/example/cli.ts](../../../src/modules/example/cli.ts) |
+| seed-todos | [src/modules/example/cli.ts](../../../src/modules/example/cli.ts) |
+
+## AI tools / MCP capabilities
+
+| ID / path | Source |
+|---|---|
+| example.get_customer_priority | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| example.get_todo_summary | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+
+## AI agents
+
+| ID / path | Source |
+|---|---|
+| example.todo_assistant | [src/modules/example/ai-agents.ts](../../../src/modules/example/ai-agents.ts) |
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["example.backend"]` | disable-replace | aclFeatures:example.backend | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.manage"]` | disable-replace | aclFeatures:example.manage | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.todos.manage"]` | disable-replace | aclFeatures:example.todos.manage | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.todos.view"]` | disable-replace | aclFeatures:example.todos.view | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.view"]` | disable-replace | aclFeatures:example.view | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.widgets.injection"]` | disable-replace | aclFeatures:example.widgets.injection | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.widgets.notes"]` | disable-replace | aclFeatures:example.widgets.notes | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.widgets.todo"]` | disable-replace | aclFeatures:example.widgets.todo | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| acl | `overrides.acl.features["example.widgets.welcome"]` | disable-replace | aclFeatures:example.widgets.welcome | [src/modules/example/acl.ts](../../../src/modules/example/acl.ts) |
+| ai | `overrides.ai.agents["example.todo_assistant"]` | disable-replace | aiAgents:example.todo_assistant | [src/modules/example/ai-agents.ts](../../../src/modules/example/ai-agents.ts) |
+| ai | `overrides.ai.extensions` | additive | ownedContracts.ai-extension:agent-extension:customers.account_assistant | [src/modules/example/ai-agents.ts:173](../../../src/modules/example/ai-agents.ts#L173) |
+| ai | `overrides.ai.tools["example.get_customer_priority"]` | disable-replace | aiTools:example.get_customer_priority | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| ai | `overrides.ai.tools["example.get_todo_summary"]` | disable-replace | aiTools:example.get_todo_summary | [src/modules/example/ai-tools.ts](../../../src/modules/example/ai-tools.ts) |
+| cli | `overrides.cli["hello"]` | disable-replace | cliCommands:hello | [src/modules/example/cli.ts](../../../src/modules/example/cli.ts) |
+| cli | `overrides.cli["seed-todos"]` | disable-replace | cliCommands:seed-todos | [src/modules/example/cli.ts](../../../src/modules/example/cli.ts) |
+| commandInterceptors | `overrides.commandInterceptors["example.audit-logging"]` | disable-replace | extensionSurfaces.contributions:example.audit-logging | [src/modules/example/commands/interceptors.ts](../../../src/modules/example/commands/interceptors.ts) |
+| di | `overrides.di["exampleTodoSummaryService"]` | disable-replace | ownedContracts.di-registration:exampleTodoSummaryService | [src/modules/example/di.ts:34](../../../src/modules/example/di.ts#L34) |
+| encryption | `overrides.encryption.maps["example:todo"]` | disable-replace | ownedContracts.encryption:example:todo | [src/modules/example/encryption.ts:21](../../../src/modules/example/encryption.ts#L21) |
+| enrichers | `overrides.enrichers["example.customer-todo-count"]` | disable-replace | extensionSurfaces.contributions:example.customer-todo-count | [src/modules/example/data/enrichers.ts](../../../src/modules/example/data/enrichers.ts) |
+| events | `overrides.events.subscribers["example:announce-todo-to-portal"]` | disable-replace | extensionSurfaces.contributions:example:announce-todo-to-portal | [src/modules/example/subscribers/announce-todo-to-portal.ts](../../../src/modules/example/subscribers/announce-todo-to-portal.ts) |
+| events | `overrides.events.subscribers["example:audit-delete"]` | disable-replace | extensionSurfaces.contributions:example:audit-delete | [src/modules/example/subscribers/audit-delete.ts](../../../src/modules/example/subscribers/audit-delete.ts) |
+| events | `overrides.events.subscribers["example:auto-default-priority"]` | disable-replace | extensionSurfaces.contributions:example:auto-default-priority | [src/modules/example/subscribers/auto-default-priority.ts](../../../src/modules/example/subscribers/auto-default-priority.ts) |
+| events | `overrides.events.subscribers["example:example-event"]` | disable-replace | extensionSurfaces.contributions:example:example-event | [src/modules/example/subscribers/example-event.ts](../../../src/modules/example/subscribers/example-event.ts) |
+| events | `overrides.events.subscribers["example:invalidate-todo-summary"]` | disable-replace | extensionSurfaces.contributions:example:invalidate-todo-summary | [src/modules/example/subscribers/invalidate-todo-summary.ts](../../../src/modules/example/subscribers/invalidate-todo-summary.ts) |
+| events | `overrides.events.subscribers["example:prevent-uncomplete"]` | disable-replace | extensionSurfaces.contributions:example:prevent-uncomplete | [src/modules/example/subscribers/prevent-uncomplete.ts](../../../src/modules/example/subscribers/prevent-uncomplete.ts) |
+| guards | `overrides.guards["example.backend.todo-edit-id-guard"]` | disable-replace | ownedContracts.page-middleware:example.backend.todo-edit-id-guard | [src/modules/example/backend/middleware.ts:48](../../../src/modules/example/backend/middleware.ts#L48) |
+| interceptors | `overrides.interceptors["example.block-test-todos"]` | disable-replace | extensionSurfaces.contributions:example.block-test-todos | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| interceptors | `overrides.interceptors["example.customer-priority-filter"]` | disable-replace | extensionSurfaces.contributions:example.customer-priority-filter | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| interceptors | `overrides.interceptors["example.todos-probe-bad-query"]` | disable-replace | extensionSurfaces.contributions:example.todos-probe-bad-query | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| interceptors | `overrides.interceptors["example.todos-probe-crash"]` | disable-replace | extensionSurfaces.contributions:example.todos-probe-crash | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| interceptors | `overrides.interceptors["example.todos-probe-timeout"]` | disable-replace | extensionSurfaces.contributions:example.todos-probe-timeout | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| interceptors | `overrides.interceptors["example.todos-response-meta"]` | disable-replace | extensionSurfaces.contributions:example.todos-response-meta | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| interceptors | `overrides.interceptors["example.wildcard-probe"]` | disable-replace | extensionSurfaces.contributions:example.wildcard-probe | [src/modules/example/api/interceptors.ts](../../../src/modules/example/api/interceptors.ts) |
+| notifications | `overrides.notifications.handlers["example.umes.actionable-toast"]` | disable-replace | extensionSurfaces.contributions:example.umes.actionable-toast | [src/modules/example/notifications.handlers.ts](../../../src/modules/example/notifications.handlers.ts) |
+| notifications | `overrides.notifications.types["example.umes.actionable"]` | disable-replace | notifications:example.umes.actionable | [src/modules/example/notifications.ts](../../../src/modules/example/notifications.ts) |
+| routes | `overrides.routes.pages["backend:/backend/blog/[id]"]` | disable-replace | backendPages:/backend/blog/[id] | [src/modules/example/backend/blog/[id]/page.tsx](../../../src/modules/example/backend/blog/[id]/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/example"]` | disable-replace | backendPages:/backend/example | [src/modules/example/backend/page.tsx](../../../src/modules/example/backend/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/mutation-lifecycle"]` | disable-replace | backendPages:/backend/mutation-lifecycle | [src/modules/example/backend/mutation-lifecycle/page.tsx](../../../src/modules/example/backend/mutation-lifecycle/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/payments"]` | disable-replace | backendPages:/backend/payments | [src/modules/example/backend/payments/page.tsx](../../../src/modules/example/backend/payments/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/products"]` | disable-replace | backendPages:/backend/products | [src/modules/example/backend/products/page.tsx](../../../src/modules/example/backend/products/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/todos"]` | disable-replace | backendPages:/backend/todos | [src/modules/example/backend/todos/page.tsx](../../../src/modules/example/backend/todos/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/todos/[id]/edit"]` | disable-replace | backendPages:/backend/todos/[id]/edit | [src/modules/example/backend/todos/[id]/edit/page.tsx](../../../src/modules/example/backend/todos/[id]/edit/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/todos/create"]` | disable-replace | backendPages:/backend/todos/create | [src/modules/example/backend/todos/create/page.tsx](../../../src/modules/example/backend/todos/create/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/umes-extensions"]` | disable-replace | backendPages:/backend/umes-extensions | [src/modules/example/backend/umes-extensions/page.tsx](../../../src/modules/example/backend/umes-extensions/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/umes-handlers"]` | disable-replace | backendPages:/backend/umes-handlers | [src/modules/example/backend/umes-handlers/page.tsx](../../../src/modules/example/backend/umes-handlers/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/umes-integrations"]` | disable-replace | backendPages:/backend/umes-integrations | [src/modules/example/backend/umes-integrations/page.tsx](../../../src/modules/example/backend/umes-integrations/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/umes-next-phases"]` | disable-replace | backendPages:/backend/umes-next-phases | [src/modules/example/backend/umes-next-phases/page.tsx](../../../src/modules/example/backend/umes-next-phases/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/umes-query-extensions"]` | disable-replace | backendPages:/backend/umes-query-extensions | [src/modules/example/backend/umes-query-extensions/page.tsx](../../../src/modules/example/backend/umes-query-extensions/page.tsx) |
+| routes | `overrides.routes.pages["frontend:/blog/[id]"]` | disable-replace | frontendPages:/blog/[id] | [src/modules/example/frontend/blog/[id]/page.tsx](../../../src/modules/example/frontend/blog/[id]/page.tsx) |
+| routes | `overrides.routes.pages["frontend:/example"]` | disable-replace | frontendPages:/example | [src/modules/example/frontend/example.tsx](../../../src/modules/example/frontend/example.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:example:setup | [src/modules/example/setup.ts:104](../../../src/modules/example/setup.ts#L104) |
+| setup | `overrides.setup.onTenantCreated` | replace | ownedContracts.setup:example:setup | [src/modules/example/setup.ts:104](../../../src/modules/example/setup.ts#L104) |
+| setup | `overrides.setup.seedDefaults` | replace | ownedContracts.setup:example:setup | [src/modules/example/setup.ts:104](../../../src/modules/example/setup.ts#L104) |
+| setup | `overrides.setup.seedExamples` | replace | ownedContracts.setup:example:setup | [src/modules/example/setup.ts:104](../../../src/modules/example/setup.ts#L104) |
+| widgets | `overrides.widgets.components["section:checkout.pay-page.help"]` | disable-replace | extensionSurfaces.contributions:example.component-override.2:section:checkout.pay-page.help | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| widgets | `overrides.widgets.components["section:checkout.pay-page.summary"]` | disable-replace | extensionSurfaces.contributions:example.component-override.1:section:checkout.pay-page.summary | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| widgets | `overrides.widgets.components["section:ui.detail.NotesSection"]` | disable-replace | extensionSurfaces.contributions:example.component-override.0:section:ui.detail.NotesSection | [src/modules/example/widgets/components.ts](../../../src/modules/example/widgets/components.ts) |
+| widgets | `overrides.widgets.dashboard["example.dashboard.notes"]` | disable-replace | extensionSurfaces.contributions:dashboard:example.dashboard.notes | [src/modules/example/widgets/dashboard/notes/widget.ts](../../../src/modules/example/widgets/dashboard/notes/widget.ts) |
+| widgets | `overrides.widgets.dashboard["example.dashboard.todos"]` | disable-replace | extensionSurfaces.contributions:dashboard:example.dashboard.todos | [src/modules/example/widgets/dashboard/todos/widget.ts](../../../src/modules/example/widgets/dashboard/todos/widget.ts) |
+| widgets | `overrides.widgets.dashboard["example.dashboard.welcome"]` | disable-replace | extensionSurfaces.contributions:dashboard:example.dashboard.welcome | [src/modules/example/widgets/dashboard/welcome/widget.ts](../../../src/modules/example/widgets/dashboard/welcome/widget.ts) |
+| widgets | `overrides.widgets.injection["example.injection.catalog-seo-report"]` | disable-replace | extensionSurfaces.contributions:example.injection.catalog-seo-report@data-table:catalog.products:header | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.crud-validation"]` | disable-replace | extensionSurfaces.contributions:example.injection.crud-validation@example:phase-c-handlers | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.crud-validation-addon"]` | disable-replace | extensionSurfaces.contributions:example.injection.crud-validation-addon@widget:example.injection.crud-validation:addon | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.customer-priority-bulk-actions"]` | disable-replace | extensionSurfaces.contributions:example.injection.customer-priority-bulk-actions@data-table:customers.people:bulk-actions | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.customer-priority-column"]` | disable-replace | extensionSurfaces.contributions:example.injection.customer-priority-column@data-table:customers.people:columns | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.customer-priority-detail"]` | disable-replace | extensionSurfaces.contributions:example.injection.customer-priority-detail@customers.person.detail:details | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.customer-priority-field"]` | disable-replace | extensionSurfaces.contributions:example.injection.customer-priority-field@crud-form:customers.customer_entity:fields | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.customer-priority-filter"]` | disable-replace | extensionSurfaces.contributions:example.injection.customer-priority-filter@data-table:customers.people:filters | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.customer-priority-row-action"]` | disable-replace | extensionSurfaces.contributions:example.injection.customer-priority-row-action@data-table:customers.people:row-actions | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.example-menus"]` | disable-replace | extensionSurfaces.contributions:example.injection.example-menus@menu:sidebar:main | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.example-profile-menu"]` | disable-replace | extensionSurfaces.contributions:example.injection.example-profile-menu@menu:topbar:profile-dropdown | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.portal-quick-links"]` | disable-replace | extensionSurfaces.contributions:example.injection.portal-quick-links@portal:dashboard:sections | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.portal-recent-activity"]` | disable-replace | extensionSurfaces.contributions:example.injection.portal-recent-activity@portal:dashboard:sections | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.portal-stats"]` | disable-replace | extensionSurfaces.contributions:example.injection.portal-stats@portal:dashboard:sections | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.sales-todos"]` | disable-replace | extensionSurfaces.contributions:example.injection.sales-todos@sales.document.detail.order:tabs | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| widgets | `overrides.widgets.injection["example.injection.todo-bulk-complete"]` | disable-replace | extensionSurfaces.contributions:example.injection.todo-bulk-complete@data-table:example.todos.list:bulk-actions | [src/modules/example/widgets/injection-table.ts](../../../src/modules/example/widgets/injection-table.ts) |
+| workers | `overrides.workers["example:todos-bulk-complete"]` | disable-replace | ownedContracts.worker:example:todos-bulk-complete | [src/modules/example/workers/todos-bulk-complete.ts:14](../../../src/modules/example/workers/todos-bulk-complete.ts#L14) |
+| workers | `overrides.workers["example:todos-bulk-dispatch"]` | disable-replace | ownedContracts.worker:example:todos-bulk-dispatch | [src/modules/example/workers/todos-bulk-dispatch.ts:26](../../../src/modules/example/workers/todos-bulk-dispatch.ts#L26) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| example | name=example; version=0.1.0 | [src/modules/example/index.ts:3](../../../src/modules/example/index.ts#L3) |
+
+## Domain commands
+
+| ID | Metadata | Source |
+|---|---|---|
+| example.todos.create | — | [src/modules/example/commands/todos.ts](../../../src/modules/example/commands/todos.ts) |
+| example.todos.delete | — | [src/modules/example/commands/todos.ts](../../../src/modules/example/commands/todos.ts) |
+| example.todos.update | — | [src/modules/example/commands/todos.ts](../../../src/modules/example/commands/todos.ts) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| example:todos-bulk-complete | concurrency=1 | [src/modules/example/workers/todos-bulk-complete.ts:14](../../../src/modules/example/workers/todos-bulk-complete.ts#L14) |
+| example:todos-bulk-dispatch | concurrency=1 | [src/modules/example/workers/todos-bulk-dispatch.ts:26](../../../src/modules/example/workers/todos-bulk-dispatch.ts#L26) |
+
+## Page middleware
+
+| ID | Metadata | Source |
+|---|---|---|
+| example.backend.todo-edit-id-guard | mode=backend; priority=40; surface=backend | [src/modules/example/backend/middleware.ts:48](../../../src/modules/example/backend/middleware.ts#L48) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| example:setup | hooks=onTenantCreated, seedDefaults, seedExamples; roles=admin, employee, superadmin | [src/modules/example/setup.ts:104](../../../src/modules/example/setup.ts#L104) |
+
+## Encryption
+
+| ID | Metadata | Source |
+|---|---|---|
+| example:todo | fields=notes | [src/modules/example/encryption.ts:21](../../../src/modules/example/encryption.ts#L21) |
+
+## DI registrations (rich)
+
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| exampleTodoSummaryService | function | scoped | — | createExampleTodoSummaryService | [src/modules/example/di.ts:34](../../../src/modules/example/di.ts#L34) |
+
+## Custom entities
+
+| ID | Metadata | Source |
+|---|---|---|
+| example:calendar_entity | — | [src/modules/example/ce.ts](../../../src/modules/example/ce.ts) |
+| example:todo | — | [src/modules/example/ce.ts](../../../src/modules/example/ce.ts) |
+
+## AI extensions
+
+| ID | Metadata | Source |
+|---|---|---|
+| agent-extension:customers.account_assistant | mode=extension; target=agent; targetAgentId=customers.account_assistant | [src/modules/example/ai-agents.ts:173](../../../src/modules/example/ai-agents.ts#L173) |

package/dist/agentic/guides/spec-delivery.md

@@ -0,0 +1,42 @@
+# Specification Delivery
+
+Use this guide for a new application, multi-module feature, or other non-trivial business slice.
+
+## Spec-first decision gate
+
+`AGENTS.md` owns the ordered rule; this section only expands it with examples and the surrounding delivery procedure. Apply it before writing code, in order:
+
+1. Search the configured specs path (`.ai/specs`, plus any enterprise directory the config names) once for a covering specification. Open the one match; a plan-only request stops there.
+2. A new user-facing or platform capability, an architecture decision, a schema or public API contract, cross-module behavior, or multi-phase behavior means authoring or amending a spec **before** coding (`spec-first`). Examples: "add a rental-booking module", "let customers self-serve returns", "introduce a second pricing engine".
+3. A bug fix, minor behavioral correction, small documentation change, dependency maintenance, or an isolated refactor that adds no architecture and no public contract proceeds without a spec (`direct`). Examples: "the overdue filter is off by one day", "rename an internal helper", "bump the queue dependency".
+4. A covering spec already exists: implement against it and update it in place (`reuse-spec`). Never open a second spec for the same capability.
+5. A new feature skips the spec **only** when the user's current request explicitly says to skip or bypass it. Silence, urgency, an "it's small" estimate, and an earlier generic preference are not overrides; neither is your own time estimate.
+6. When the classification is genuinely ambiguous **and** the answer materially changes the workflow, ask one bounded question (`ask`). Do not ask when repository evidence — an existing spec, an existing module, a reproducible defect — already resolves it.
+
+After `spec-first` or `reuse-spec`, implementation routing is a one-way handoff: module work loads `om-module-scaffold`, which starts at `src/modules/example/README.md` and its `references/surface-inventory.json`, and adapts only the capability-linked source files. UI-bearing work additionally loads `om-backend-ui-design`. Never propose a second teaching module, copy the example tree wholesale, or treat `ratelimit_probe` as a blueprint. Every newly added or materially changed extension surface names its own self-contained integration test in the plan.
+
+## Delivery skills
+
+- Pinned delivery skills install with `yarn install-skills` (refresh: `--update`). When a skill is absent, run `yarn install-skills` once; never substitute a similarly named skill or improvise its workflow.
+- `om-implement-spec` runs approved phases locally; `om-auto-implement-spec`, `om-auto-create-pr`, `om-auto-fix-issue`, and `om-auto-review-pr` own whole-spec, commit+ready PR, issue, and review delivery.
+- Integration, E2E, and UI QA delivery uses `om-integration-tests` and `om-auto-qa-pr`.
+- Routing note: specs themselves are `spec-pr` work; implementation owns the domain guides. Do not load delivery skills when no PR or spec workflow was requested.
+
+## Authoring readiness gate
+
+1. Invoke `om-spec-writing` before authoring or revising. Mentioning the skill or reading only `SPEC-000-template.md` is not sufficient.
+2. After invocation, read `.ai/specs/SPEC-000-template.md` and preserve every section; use `N/A — reason` only when a section genuinely does not apply.
+3. Keep status `Draft` until no blocking open question remains and every requirement maps to an acceptance criterion, implementation phase, and self-contained test oracle.
+4. For each affected UI route, inspect and cite the closest existing Open Mercato page plus `.ai/guides/backend-ui.md`; specify its text mockup/structure, actions, data source and mutations, permissions, canonical shell/components, and loading/empty/error/conflict/keyboard/a11y/responsive/light/dark states. Tabular admin data names `DataTable`; CRUD create/edit names `CrudForm`; backend reads name shared API helpers; every exception has an explicit rationale.
+5. New applications and multi-module requests also define domain vocabulary/invariants, measurable success, navigation/widgets, module ownership and extension points, architecture/data flow, and concrete risk scenarios. A page inventory alone is not an app architecture.
+6. Phases are dependency-ordered complete vertical slices with concrete deliverables, acceptance IDs, bounded slices, tests, validation commands, business value, and observable exit gates. Do not defer required behavior to a catch-all “integration/polish” phase.
+7. Mark the spec `Ready for implementation` only after the traceability and final compliance matrices pass and the user approves implementation.
+
+## Implementation phase gate
+
+- Use `om-implement-spec` for interactive local delivery and `om-auto-implement-spec` for whole-spec PR delivery. The local skill's progressive resolution, planning/progress, and report references own its exact workflow and final `Spec:` marker; it never claims PR/tracker output.
+- Only the current unblocked phase may be in progress. Parallelize independent slices inside that phase only; never start a dependent module/phase before its prerequisite exit gate passes.
+- Delegation does not bypass routing. Before any UI slice, actually invoke `om-backend-ui-design` and read `.ai/guides/backend-ui.md`; naming them in an agent prompt is not invocation. Every implementation brief names the active phase, routed guides/skills, closest reference page, canonical primitives, acceptance IDs, owned files, and validation oracle.
+- Reject raw backend tables/forms/fetch, copied component families, arbitrary values, hard-coded palette/status colors, and light-only styling unless the approved spec records a necessary exception. UI phase evidence exercises affected routes in light and dark mode and at narrow width, including loading/empty/error/conflict and keyboard behavior.
+- A phase remains open while it has stubs, missing integration evidence, unmet acceptance IDs, or failing validation. Generated discovery, file count, and typecheck alone do not prove completion.
+- If no remote/tracker exists, report PR delivery unavailable and invoke local `om-implement-spec` phase-by-phase; never improvise a concurrent whole-spec build.