@open-mercato/cli 0.6.7 → 0.6.8-canary.320.1.bf889f49e4

package/dist/agentic/guides/module-system.md

@@ -1,130 +1,15 @@
-# Open Mercato Module System — Conceptual Guide
+# Module System Compatibility Router
 
-This is the **hand-written, conceptual** layer of the module guides. It explains how an Open Mercato module is structured and how to build or extend one — the timeless concepts that rarely change. It is framework-wide; it does **not** describe any single module's data.
+Use the concern guides below. This path remains only so older prompts and links do not load a stale module tutorial.
 
-## How the guides are layered
-
-- **Layer 1 — this file (`.ai/guides/module-system.md`):** conceptual and framework-wide. Module anatomy, auto-discovery, naming, the mandatory mechanisms, data-integrity rules, and the generate/migration workflow.
-- **Layer 2 — generated per-module fact-sheets (`.ai/guides/modules/<module>.md` + `.ai/guides/module-facts.json`):** the concrete **facts** for one module, extracted from its source — entity IDs, events, ACL features, API routes with per-method auth, DI service tokens, searchable entities, host extension tokens, notifications, and CLI commands. These are generated; never hand-write them here.
-- **Package guides (`.ai/guides/core.md`, `ui.md`, `shared.md`, …):** package-specific depth (patterns, helpers, deeper APIs).
-
-When you need a concrete fact about a specific module — which events it emits, its entity IDs, which feature gates a route — open that module's fact-sheet. Do not infer module facts from this conceptual guide.
-
-## Module anatomy
-
-Each module lives in `src/modules/<id>/` and is **auto-discovered**. The only registration is one entry in `src/modules.ts` (`{ id: '<id>', from: '@app' }`). Run `yarn generate` after adding or changing any auto-discovered file.
-
-```
-src/modules/<id>/
-├── index.ts                # Module metadata
-├── data/
-│   ├── entities.ts         # MikroORM entity classes (decorators from @mikro-orm/decorators/legacy)
-│   ├── validators.ts       # Zod validation schemas
-│   ├── extensions.ts       # Cross-module entity links (export `extensions`)
-│   └── enrichers.ts        # Response enrichers (export `enrichers`)
-├── api/
-│   ├── <resource>/route.ts # REST handlers (auto-discovered by method) + `metadata` + `openApi`
-│   └── interceptors.ts     # API route interception hooks (export `interceptors`)
-├── backend/                # Admin UI pages (auto-discovered) + paired `page.meta.ts`
-├── frontend/               # Public pages (auto-discovered); customer portal under `[orgSlug]/portal/`
-├── subscribers/            # Event handlers (export `metadata` + default handler)
-├── workers/                # Background jobs (export `metadata` + default handler)
-├── widgets/
-│   ├── injection/          # UI widgets injected into other modules
-│   ├── injection-table.ts  # Widget-to-slot mappings
-│   └── components.ts        # Component replacement/wrapper definitions (export `componentOverrides`)
-├── di.ts                   # Awilix DI registrations (export `register(container)`)
-├── acl.ts                  # Permission features (export `features`)
-├── setup.ts                # Tenant init, role features, seed data (export `setup`)
-├── events.ts               # Typed event declarations (export `eventsConfig`)
-├── search.ts               # Search indexing configuration (export `searchConfig`)
-├── ce.ts                   # Custom entities / custom field sets (export `entities`)
-├── translations.ts         # Translatable fields per entity
-├── notifications.ts        # Notification type definitions (export `notificationTypes`)
-└── encryption.ts           # Tenant data encryption maps for sensitive / GDPR fields
-```
-
-### Auto-discovery paths
-
-| Path pattern | Becomes |
-|---|---|
-| `frontend/<path>.tsx` | `/<path>` (public page) |
-| `frontend/[orgSlug]/portal/<path>/page.tsx` | `/{orgSlug}/portal/<path>` (customer portal page; `[orgSlug]` MUST be first) |
-| `backend/<path>.tsx` | `/backend/<path>` (admin page) |
-| `backend/page.tsx` | `/backend/<module>` (module root page) |
-| `api/<method>/<path>.ts` | `/api/<path>` dispatched by HTTP method |
-| `subscribers/*.ts` | event subscriber (export `metadata` + default handler) |
-| `workers/*.ts` | background worker (export `metadata` + default handler) |
-
-### Convention-file reference
-
-| File | Export | Purpose |
-|------|--------|---------|
-| `index.ts` | `metadata` | Module metadata |
-| `di.ts` | `register(container)` | DI registrations (Awilix) |
-| `acl.ts` | `features` | Permission features (`['mod.view', 'mod.manage', …]`) |
-| `setup.ts` | `setup` | Tenant init, default role features, seed data |
-| `ce.ts` | `entities` | Custom entities / custom field sets |
-| `events.ts` | `eventsConfig` | Typed event declarations (`createModuleEvents`) |
-| `search.ts` | `searchConfig` | Search indexing config |
-| `translations.ts` | `translatableFields` | Translatable fields per entity |
-| `notifications.ts` | `notificationTypes` | Notification type definitions |
-| `data/entities.ts` | — | MikroORM entity classes |
-| `data/validators.ts` | — | Zod validation schemas |
-| `data/extensions.ts` | `extensions` | Entity extensions (cross-module links) |
-| `data/enrichers.ts` | `enrichers` | Response enrichers |
-| `api/interceptors.ts` | `interceptors` | API route interception hooks |
-| `widgets/components.ts` | `componentOverrides` | Component replacement/wrapper definitions |
-
-## Naming conventions
-
-- **Module IDs:** plural, snake_case (`order_items`). Special cases: `auth`, `example`.
-- **Event IDs:** `module.entity.action` (singular entity, past-tense action, e.g. `sales.order.created`).
-- **Entity IDs:** colon form `module:entity` (e.g. `customers:customer_person_profile`) — the canonical interop token, **not** the raw class name and **not** the dotted friendly alias some enrichers use.
-- **DB tables:** plural, snake_case with a module prefix (`catalog_products`).
-- **DB columns:** snake_case (`created_at`, `organization_id`). Common columns: `id`, `created_at`, `updated_at`, `deleted_at`, `is_active`, `organization_id`, `tenant_id`.
-- **Feature IDs:** `<module>.<action>` (`my_module.view`, `my_module.manage`). FROZEN once shipped — rename by adding the new ID alongside and keeping the old as a deprecated alias.
-- **JS/TS identifiers:** camelCase. UUID primary keys, explicit foreign keys, junction tables for M2M.
-
-## Mandatory module mechanisms
-
-The framework provides **one canonical primitive per concern**. Do not invent your own routing, auth, persistence, forms, caching, or cross-module calls. If a feature is not listed here, ask before rolling your own.
-
-| Concern | Canonical mechanism |
+| When you need | Load |
 |---|---|
-| Module structure & auto-discovery | `src/modules/<id>/{api,backend,frontend,data,subscribers,workers,widgets}` + `index.ts` + one line in `src/modules.ts` — discovered by `yarn generate` |
-| API routes | Files under `api/**/route.ts` exporting handlers + per-method `metadata` (`requireAuth` / `requireFeatures`) + `openApi`. NEVER a top-level `export const requireAuth` — the registry ignores it |
-| CRUD APIs | `makeCrudRoute({ orm, list, create, update, del, indexer })` from `@open-mercato/shared/lib/crud/factory`. Always set `indexer` for query-index coverage. Custom (non-factory) write routes MUST run the mutation guard registry (`runMutationGuards`) |
-| CRUD forms | `<CrudForm />` from `@open-mercato/ui/backend/CrudForm` + `createCrud`/`updateCrud`/`deleteCrud`. Never raw `<form>`, never raw `fetch` |
-| Data tables | `<DataTable entityId apiPath … />` from `@open-mercato/ui/backend/DataTable`. Keep `entityId` / `extensionTableId` stable so widget injection keeps working |
-| HTTP from the client | `apiCall` / `apiCallOrThrow` from `@open-mercato/ui/backend/utils/apiCall` — never raw `fetch` |
-| Authorization (RBAC) | Declare features in `acl.ts`, grant in `setup.ts` `defaultRoleFeatures`, gate with `requireFeatures` in `metadata` / `page.meta.ts`. NEVER `requireRoles` (role names mutate). Treat `module.*` / `*` wildcard grants as part of the contract |
-| Multi-tenant scoping | Every tenant-scoped entity has indexed `organization_id` + `tenant_id`; every read/write filters by them. The CRUD factory injects scope — do not bypass it. Ad-hoc queries use `withScopedPayload` |
-| Encryption for sensitive data | Declare `encryption.ts` `defaultEncryptionMaps`; read via `findWithDecryption` / `findOneWithDecryption`. NEVER hand-roll AES/KMS, NEVER `em.find` on encrypted columns |
-| Cache | Resolve from DI (`container.resolve('cache')`) — never `new Redis(...)`. Tag with `tenant:<id>` / `org:<id>` so invalidation stays tenant-scoped |
-| Background workers | `workers/*.ts` exporting `metadata: { queue, id?, concurrency? }` + default handler. Never spin up custom queues |
-| Events between modules | `events.ts` with `createModuleEvents({ moduleId, events } as const)`; subscribe in `subscribers/`. Never call another module's services directly across boundaries |
-| Domain writes | Implement through the Command pattern so audit, undo, cache, events, and indexing stay consistent — do not mutate domain state directly in route handlers |
-| i18n | `useT()` client-side, `resolveTranslations()` server-side; keys in `src/i18n/<locale>.json`. Never hard-code user-facing strings |
-
-> Rule of thumb: if you reach for raw `fetch`, raw `<form>`, ad-hoc `crypto`, ad-hoc `Redis`, or a manual cross-module join, stop and check the row above — there is a canonical helper.
-
-## Entity-update safety & data integrity
-
-- **`withAtomicFlush`.** MikroORM can silently discard pending scalar changes when a query (`em.find`/`em.findOne`/sync helper) runs on the same `EntityManager` between a scalar mutation and `em.flush()`. Multi-phase mutations MUST use `withAtomicFlush(em, phases, { transaction: true })` from `@open-mercato/shared/lib/commands/flush`. Keep `emitCrudSideEffects` and cache invalidation **outside** the block — they fire only after the DB write commits. For entity + custom fields + side effects in one write, prefer `runCrudCommandWrite`.
-- **Optimistic locking (default ON).** Every **new user-editable entity** MUST carry an `updated_at` column and return `updatedAt` in its list/detail responses, so the OSS optimistic lock can detect concurrent edits. `CrudForm` auto-derives the lock header from `initialValues.updatedAt` (covers update and delete). Append-only logs, junction/assignment tables, session/token rows, and parent-guarded sub-resource lines are exempt.
-- **Encryption.** Sensitive / GDPR fields go through the encryption-maps mechanism (`encryption.ts` + `findWithDecryption`), never hand-rolled crypto. Always pass `tenantId` and `organizationId` to the decryption helpers.
-- **Tenant isolation.** Never expose cross-tenant data; always filter by `organization_id` (and `tenant_id`). Never create direct ORM relationships between modules — reference by FK id and fetch separately.
-
-## Generate & migration workflow
-
-- **After editing `src/modules.ts` or any structural module file:** run `yarn generate`. Never hand-edit anything under `.mercato/generated/*`.
-- **After editing `data/entities.ts`:** run `yarn db:generate` as a schema-diff probe. Default to the generated SQL; if it emits unrelated churn from another module's stale snapshot, keep only the SQL for your change and update that module's `migrations/.snapshot-open-mercato.json` in the same commit.
-- **Do not run `yarn db:migrate`** unless the user explicitly asks. A PR should normally include the migration file plus snapshot, not local DB state. Never hand-edit a migration that has already shipped — add a new one.
-- **New ACL features must be visible immediately:** add the feature to `acl.ts` **and** to `setup.ts` `defaultRoleFeatures`, then run `yarn mercato auth sync-role-acls` so existing tenants pick it up.
-
-## Where to go next
-
-- A specific module's surface (entities, events, routes, auth, search, CLI): its **fact-sheet** at `.ai/guides/modules/<module>.md`.
-- Deeper package patterns: the matching **package guide** (`core.md`, `ui.md`, `shared.md`, `events.md`, `queue.md`, `cache.md`, `search.md`).
-- Scaffolding a module end-to-end: the `om-module-scaffold` skill.
+| Module ownership, layout, discovery, registration, or installed source | `.ai/guides/architecture.md` |
+| Entities, CRUD/API, commands, scoping, ACL, setup, events, workers, search, cache, or migrations | `.ai/guides/contracts.md` |
+| Forms, tables, pages, navigation, portal, translations, or design-system behavior | `.ai/guides/backend-ui.md` |
+| Enrichers, interceptors, guards, widgets, extensions, menus, replacements, or overrides | `.ai/guides/extensions.md` |
+| Provider packages, data sync, webhooks, import/export, shipping, payment, or email | `.ai/guides/integrations.md` |
+| AI agents/tools/orchestrators or workflows | `.ai/guides/ai-workflows.md` |
+| Diagnosis and regression verification | `.ai/guides/testing-debugging.md` |
+
+For a complete new module, invoke `om-module-scaffold`; it loads the relevant branches. For a concrete installed-module fact, read its generated `.ai/guides/modules/<id>.md` first. Invoke `om-framework-context` only when generated facts cannot answer the implementation question.

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

@@ -1,44 +1,75 @@
 # ai_assistant — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/ai-assistant 0.6.8-canary.320.1.bf889f49e4; core 0.6.8-canary.320.1.bf889f49e4 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant
 
 ## Entities
 
-| Entity ID | Class | Table | Editable | CustomFields |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| ai_assistant:ai_agent_prompt_override | AiAgentPromptOverride | ai_agent_prompt_overrides | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_pending_action | AiPendingAction | ai_pending_actions | no | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_agent_runtime_override | AiAgentRuntimeOverride | ai_agent_runtime_overrides | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_token_usage_event | AiTokenUsageEvent | ai_token_usage_events | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_token_usage_daily | AiTokenUsageDaily | ai_token_usage_daily | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_tenant_model_allowlist | AiTenantModelAllowlist | ai_tenant_model_allowlists | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_agent_mutation_policy_override | AiAgentMutationPolicyOverride | ai_agent_mutation_policy_overrides | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_chat_conversation | AiChatConversation | ai_chat_conversations | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_chat_conversation_participant | AiChatConversationParticipant | ai_chat_conversation_participants | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_chat_message | AiChatMessage | ai_chat_messages | yes | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+| ai_assistant:ai_moderation_flag | AiModerationFlag | ai_moderation_flags | no | no | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/data/entities.ts) |
+
+## Events  (7)
+
+| ID | Category | Entity | Browser transport | Source |
 |---|---|---|---|---|
-| ai_assistant:ai_agent_prompt_override | AiAgentPromptOverride | ai_agent_prompt_overrides | yes | no |
-| ai_assistant:ai_pending_action | AiPendingAction | ai_pending_actions | no | no |
-| ai_assistant:ai_agent_runtime_override | AiAgentRuntimeOverride | ai_agent_runtime_overrides | yes | no |
-| ai_assistant:ai_token_usage_event | AiTokenUsageEvent | ai_token_usage_events | yes | no |
-| ai_assistant:ai_token_usage_daily | AiTokenUsageDaily | ai_token_usage_daily | yes | no |
-| ai_assistant:ai_tenant_model_allowlist | AiTenantModelAllowlist | ai_tenant_model_allowlists | yes | no |
-| ai_assistant:ai_agent_mutation_policy_override | AiAgentMutationPolicyOverride | ai_agent_mutation_policy_overrides | yes | no |
-| ai_assistant:ai_chat_conversation | AiChatConversation | ai_chat_conversations | yes | no |
-| ai_assistant:ai_chat_conversation_participant | AiChatConversationParticipant | ai_chat_conversation_participants | yes | no |
-| ai_assistant:ai_chat_message | AiChatMessage | ai_chat_messages | yes | no |
-
-## Events  (6)
-
-| ID | Category | Entity |
-|---|---|---|
-| ai.action.confirmed | — | ai_pending_action |
-| ai.action.cancelled | — | ai_pending_action |
-| ai.action.expired | — | ai_pending_action |
-| ai.token_usage.recorded | — | token_usage |
-| ai_assistant.conversation.shared | — | ai_chat_conversation |
-| ai_assistant.conversation.unshared | — | ai_chat_conversation |
+| ai.action.confirmed | — | ai_pending_action | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai.action.cancelled | — | ai_pending_action | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai.action.expired | — | ai_pending_action | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai.token_usage.recorded | — | token_usage | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai_assistant.conversation.shared | — | ai_chat_conversation | client | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai_assistant.conversation.unshared | — | ai_chat_conversation | client | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai_assistant.moderation_flag.created | — | ai_moderation_flag | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
 
 ## ACL features  (8)
 
-ai_assistant.view · ai_assistant.settings.manage · ai_assistant.conversations.manage · ai_assistant.conversations.share · ai_assistant.mcp.serve · ai_assistant.tools.list · ai_assistant.mcp_servers.view · ai_assistant.mcp_servers.manage
+| Feature | Source |
+|---|---|
+| ai_assistant.view | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.settings.manage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.conversations.manage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.conversations.share | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.mcp.serve | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.tools.list | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.mcp_servers.view | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai_assistant.mcp_servers.manage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
 
 ## API routes
 
 _none_
 
-## DI service tokens
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/config/ai-assistant | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/page.tsx) |
+| /backend/config/ai-assistant/agents | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/agents/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/agents/page.tsx) |
+| /backend/config/ai-assistant/allowlist | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/allowlist/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/allowlist/page.tsx) |
+| /backend/config/ai-assistant/legacy | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/legacy/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/legacy/page.tsx) |
+| /backend/config/ai-assistant/moderation-flags | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/moderation-flags/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/moderation-flags/page.tsx) |
+| /backend/config/ai-assistant/playground | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/playground/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/playground/page.tsx) |
+| /backend/config/ai-assistant/settings | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/settings/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/settings/page.tsx) |
+| /backend/config/ai-assistant/usage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/usage/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/usage/page.tsx) |
+
+## Frontend pages
 
 _none_
 
+## DI service tokens
+
+| Token | Source |
+|---|---|
+| moderationService | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts:11](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts#L11) |
+
 ## Search entities
 
 _none_
@@ -48,10 +79,178 @@ _none_
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| ai_assistant:ai_agent_mutation_policy_override | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_agent_mutation_policy_override |
+| ai_assistant:ai_agent_prompt_override | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_agent_prompt_override |
+| ai_assistant:ai_agent_runtime_override | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_agent_runtime_override |
+| ai_assistant:ai_chat_conversation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_chat_conversation |
+| ai_assistant:ai_chat_conversation_participant | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_chat_conversation_participant |
+| ai_assistant:ai_chat_message | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_chat_message |
+| ai_assistant:ai_moderation_flag | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_moderation_flag |
+| ai_assistant:ai_pending_action | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_pending_action |
+| ai_assistant:ai_tenant_model_allowlist | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_tenant_model_allowlist |
+| ai_assistant:ai_token_usage_daily | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_token_usage_daily |
+| ai_assistant:ai_token_usage_event | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_token_usage_event |
+| ai_assistant.conversation.shared | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:ai_assistant.conversation.shared |
+| ai_assistant.conversation.unshared | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:ai_assistant.conversation.unshared |
+| ai_assistant.moderation_flag.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai_assistant.moderation_flag.created |
+| ai.action.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.action.cancelled |
+| ai.action.confirmed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.action.confirmed |
+| ai.action.expired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.action.expired |
+| ai.token_usage.recorded | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.token_usage.recorded |
+
+## UMES contributions
+
+| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
+|---|---|---|---|---|---|---|
+| ai_assistant.conversation.shared.browser | browser-reaction | ai_assistant.conversation.shared | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai_assistant.conversation.unshared.browser | browser-reaction | ai_assistant.conversation.unshared | — | audienceScopeContract=tenant-organization-user-role-and-customer; hooks=useAppEvent,useOperationProgress; transports=client | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai:attachments.list_record_attachments | specialized-registry | attachments.list_record_attachments | — | registry=ai; registryId=attachments.list_record_attachments; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai:attachments.read_attachment | specialized-registry | attachments.read_attachment | — | registry=ai; registryId=attachments.read_attachment; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai:attachments.transfer_record_attachments | specialized-registry | attachments.transfer_record_attachments | — | registry=ai; registryId=attachments.transfer_record_attachments; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai:meta.describe_agent | specialized-registry | meta.describe_agent | — | registry=ai; registryId=meta.describe_agent; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai:meta.list_agents | specialized-registry | meta.list_agents | — | registry=ai; registryId=meta.list_agents; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai:meta.update_task_plan | specialized-registry | meta.update_task_plan | — | registry=ai; registryId=meta.update_task_plan; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai:search.get_record_context | specialized-registry | search.get_record_context | — | registry=ai; registryId=search.get_record_context; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| ai:search.hybrid_search | specialized-registry | search.hybrid_search | — | registry=ai; registryId=search.hybrid_search; specialistRoute=aiTools | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| notification:ai_assistant.conversation_shared | specialized-registry | ai_assistant.conversation_shared | — | registry=notification; registryId=ai_assistant.conversation_shared; specialistRoute=notifications | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts) |
+| ai_assistant:conversation-shared-notify | subscriber | ai_assistant.conversation.shared | async-delivery | event=ai_assistant.conversation.shared; persistent=true; subscriberId=ai_assistant:conversation-shared-notify; sync=false | fact-ref | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts) |
+
+## Active extension bindings
+
+_none_
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+| Contribution | Target | Resolution | Activations | Source |
+|---|---|---|---|---|
+| ai_assistant:conversation-shared-notify | event:ai_assistant.conversation.shared @ai_assistant | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts) |
+| ai_assistant.conversation.shared.browser | event:ai_assistant.conversation.shared @ai_assistant | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai_assistant.conversation.unshared.browser | event:ai_assistant.conversation.unshared @ai_assistant | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/events.ts) |
+| ai:attachments.list_record_attachments | module:attachments.list_record_attachments | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai:attachments.read_attachment | module:attachments.read_attachment | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai:attachments.transfer_record_attachments | module:attachments.transfer_record_attachments | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai:meta.describe_agent | module:meta.describe_agent | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai:meta.list_agents | module:meta.list_agents | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai:meta.update_task_plan | module:meta.update_task_plan | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai:search.get_record_context | module:search.get_record_context | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| ai:search.hybrid_search | module:search.hybrid_search | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| notification:ai_assistant.conversation_shared | module:ai_assistant.conversation_shared | capability-only | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts) |
+
+
+
 ## Notifications
 
-ai_assistant.conversation_shared
+| Notification ID | Source |
+|---|---|
+| ai_assistant.conversation_shared | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts) |
+
+## CLI commands
+
+| ID / path | Source |
+|---|---|
+| mcp:serve | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| mcp:serve-http | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| mcp:dev | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| mcp:ensure-api-key | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| mcp:list-tools | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| entity-graph | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| run-pending-action-cleanup | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| run-token-usage-prune | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| test-tools | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+
+## AI tools / MCP capabilities
+
+| ID / path | Source |
+|---|---|
+| attachments.list_record_attachments | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| attachments.read_attachment | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| attachments.transfer_record_attachments | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| meta.describe_agent | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| meta.list_agents | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| meta.update_task_plan | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| search.get_record_context | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| search.hybrid_search | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+
+## AI agents
+
+_none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["ai_assistant.conversations.manage"]` | disable-replace | aclFeatures:ai_assistant.conversations.manage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.conversations.share"]` | disable-replace | aclFeatures:ai_assistant.conversations.share | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.mcp_servers.manage"]` | disable-replace | aclFeatures:ai_assistant.mcp_servers.manage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.mcp_servers.view"]` | disable-replace | aclFeatures:ai_assistant.mcp_servers.view | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.mcp.serve"]` | disable-replace | aclFeatures:ai_assistant.mcp.serve | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.settings.manage"]` | disable-replace | aclFeatures:ai_assistant.settings.manage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.tools.list"]` | disable-replace | aclFeatures:ai_assistant.tools.list | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| acl | `overrides.acl.features["ai_assistant.view"]` | disable-replace | aclFeatures:ai_assistant.view | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/acl.ts) |
+| ai | `overrides.ai.tools["attachments.list_record_attachments"]` | disable-replace | aiTools:attachments.list_record_attachments | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai | `overrides.ai.tools["attachments.read_attachment"]` | disable-replace | aiTools:attachments.read_attachment | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai | `overrides.ai.tools["attachments.transfer_record_attachments"]` | disable-replace | aiTools:attachments.transfer_record_attachments | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts) |
+| ai | `overrides.ai.tools["meta.describe_agent"]` | disable-replace | aiTools:meta.describe_agent | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai | `overrides.ai.tools["meta.list_agents"]` | disable-replace | aiTools:meta.list_agents | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai | `overrides.ai.tools["meta.update_task_plan"]` | disable-replace | aiTools:meta.update_task_plan | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/meta-pack.ts) |
+| ai | `overrides.ai.tools["search.get_record_context"]` | disable-replace | aiTools:search.get_record_context | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| ai | `overrides.ai.tools["search.hybrid_search"]` | disable-replace | aiTools:search.hybrid_search | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/ai-tools/search-pack.ts) |
+| cli | `overrides.cli["entity-graph"]` | disable-replace | cliCommands:entity-graph | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["mcp:dev"]` | disable-replace | cliCommands:mcp:dev | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["mcp:ensure-api-key"]` | disable-replace | cliCommands:mcp:ensure-api-key | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["mcp:list-tools"]` | disable-replace | cliCommands:mcp:list-tools | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["mcp:serve"]` | disable-replace | cliCommands:mcp:serve | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["mcp:serve-http"]` | disable-replace | cliCommands:mcp:serve-http | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["run-pending-action-cleanup"]` | disable-replace | cliCommands:run-pending-action-cleanup | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["run-token-usage-prune"]` | disable-replace | cliCommands:run-token-usage-prune | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| cli | `overrides.cli["test-tools"]` | disable-replace | cliCommands:test-tools | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/cli.ts) |
+| di | `overrides.di["mcpToolRegistry"]` | disable-replace | ownedContracts.di-registration:mcpToolRegistry | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts:8](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts#L8) |
+| di | `overrides.di["moderationService"]` | disable-replace | ownedContracts.di-registration:moderationService | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts:11](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts#L11) |
+| events | `overrides.events.subscribers["ai_assistant:conversation-shared-notify"]` | disable-replace | extensionSurfaces.contributions:ai_assistant:conversation-shared-notify | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts) |
+| notifications | `overrides.notifications.types["ai_assistant.conversation_shared"]` | disable-replace | notifications:ai_assistant.conversation_shared | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/notifications.ts) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant"]` | disable-replace | backendPages:/backend/config/ai-assistant | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/agents"]` | disable-replace | backendPages:/backend/config/ai-assistant/agents | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/agents/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/agents/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/allowlist"]` | disable-replace | backendPages:/backend/config/ai-assistant/allowlist | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/allowlist/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/allowlist/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/legacy"]` | disable-replace | backendPages:/backend/config/ai-assistant/legacy | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/legacy/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/legacy/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/moderation-flags"]` | disable-replace | backendPages:/backend/config/ai-assistant/moderation-flags | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/moderation-flags/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/moderation-flags/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/playground"]` | disable-replace | backendPages:/backend/config/ai-assistant/playground | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/playground/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/playground/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/settings"]` | disable-replace | backendPages:/backend/config/ai-assistant/settings | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/settings/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/settings/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/config/ai-assistant/usage"]` | disable-replace | backendPages:/backend/config/ai-assistant/usage | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/usage/page.tsx](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/backend/config/ai-assistant/usage/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:ai_assistant:setup | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/setup.ts:106](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/setup.ts#L106) |
+| setup | `overrides.setup.seedDefaults` | replace | ownedContracts.setup:ai_assistant:setup | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/setup.ts:106](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/setup.ts#L106) |
+| workers | `overrides.workers["ai_assistant:cleanup-expired-pending-actions"]` | disable-replace | ownedContracts.worker:ai_assistant:cleanup-expired-pending-actions | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-pending-action-cleanup.ts:63](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-pending-action-cleanup.ts#L63) |
+| workers | `overrides.workers["ai_assistant:token-usage-prune"]` | disable-replace | ownedContracts.worker:ai_assistant:token-usage-prune | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-token-usage-prune.ts:14](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-token-usage-prune.ts#L14) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| ai_assistant | name=ai_assistant; version=0.1.0 | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/index.ts:3](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/index.ts#L3) |
+
+## Workers
+
+| ID | Metadata | Source |
+|---|---|---|
+| ai_assistant:cleanup-expired-pending-actions | concurrency=1; queue=ai-pending-action-cleanup | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-pending-action-cleanup.ts:63](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-pending-action-cleanup.ts#L63) |
+| ai_assistant:token-usage-prune | concurrency=1; queue=ai-token-usage-prune | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-token-usage-prune.ts:14](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/workers/ai-token-usage-prune.ts#L14) |
+
+## Setup
+
+| ID | Metadata | Source |
+|---|---|---|
+| ai_assistant:setup | hooks=seedDefaults; roles=admin, employee | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/setup.ts:106](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/setup.ts#L106) |
 
-## CLI
+## DI registrations (rich)
 
-mcp:serve · mcp:serve-http · mcp:dev · mcp:ensure-api-key · mcp:list-tools · entity-graph · run-pending-action-cleanup · run-token-usage-prune · test-tools
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| mcpToolRegistry | value | — | — | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts:8](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts#L8) |
+| moderationService | function | singleton | — | — | [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts:11](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant/di.ts#L11) |

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

@@ -1,5 +1,6 @@
 # api_docs — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-canary.320.1.bf889f49e4; core 0.6.8-canary.320.1.bf889f49e4 — R1 staleness stamp -->
+Source root: node_modules/@open-mercato/core/src/modules/api_docs
 
 ## Entities
 
@@ -17,6 +18,18 @@ _none_
 
 _none_
 
+## Backend pages
+
+| ID / path | Source |
+|---|---|
+| /backend/docs | [node_modules/@open-mercato/core/src/modules/api_docs/backend/docs/page.tsx](../../../node_modules/@open-mercato/core/src/modules/api_docs/backend/docs/page.tsx) |
+
+## Frontend pages
+
+| ID / path | Source |
+|---|---|
+| /docs/api | [node_modules/@open-mercato/core/src/modules/api_docs/frontend/docs/api/page.tsx](../../../node_modules/@open-mercato/core/src/modules/api_docs/frontend/docs/api/page.tsx) |
+
 ## DI service tokens
 
 _none_
@@ -30,10 +43,53 @@ _none_
 - Entity IDs: _none_
 - Table IDs: _none_
 
+## UMES hosts
+
+_none_
+
+## UMES contributions
+
+_none_
+
+## Active extension bindings
+
+_none_
+
+## Incoming installed contributions
+
+_none_
+
+## Contribution resolutions
+
+_none_
+
+
+
 ## Notifications
 
 _none_
 
-## CLI
+## CLI commands
+
+_none_
+
+## AI tools / MCP capabilities
 
 _none_
+
+## AI agents
+
+_none_
+
+## Exact override targets
+
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| routes | `overrides.routes.pages["backend:/backend/docs"]` | disable-replace | backendPages:/backend/docs | [node_modules/@open-mercato/core/src/modules/api_docs/backend/docs/page.tsx](../../../node_modules/@open-mercato/core/src/modules/api_docs/backend/docs/page.tsx) |
+| routes | `overrides.routes.pages["frontend:/docs/api"]` | disable-replace | frontendPages:/docs/api | [node_modules/@open-mercato/core/src/modules/api_docs/frontend/docs/api/page.tsx](../../../node_modules/@open-mercato/core/src/modules/api_docs/frontend/docs/api/page.tsx) |
+
+## Owned contract — module metadata
+
+| ID | Metadata | Source |
+|---|---|---|
+| api_docs | name=api_docs | [node_modules/@open-mercato/core/src/modules/api_docs/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/api_docs/index.ts#L3) |