@open-mercato/cli 0.6.7-develop.6862.1.c11a64ce0a → 0.6.7

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

@@ -1,15 +1,130 @@
-# Module System Compatibility Router
+# Open Mercato Module System — Conceptual Guide
 
-Use the concern guides below. This path remains only so older prompts and links do not load a stale module tutorial.
+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.
 
-| When you need | Load |
+## 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 |
 |---|---|
-| 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.
+| 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.

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

@@ -1,74 +1,43 @@
 # ai_assistant — module facts (generated, do not edit)
-<!-- generated from @open-mercato/ai-assistant 0.6.7-develop.6862.1.c11a64ce0a; core 0.6.7-develop.6862.1.c11a64ce0a — R1 staleness stamp -->
-Source root: [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant)
+<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
 
 ## Entities
 
-| 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 |
+| Entity ID | Class | Table | Editable | CustomFields |
 |---|---|---|---|---|
-| 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) |
+| 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 |
 
 ## ACL features  (8)
 
-| 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) |
+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
 
 ## API routes
 
 _none_
 
-## 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) |
+_none_
 
 ## Search entities
 
@@ -79,178 +48,10 @@ _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
 
-| 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) |
+ai_assistant.conversation_shared
 
-## DI registrations (rich)
+## CLI
 
-| 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) |
+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

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

@@ -1,6 +1,5 @@
 # api_docs — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6862.1.c11a64ce0a; core 0.6.7-develop.6862.1.c11a64ce0a — R1 staleness stamp -->
-Source root: [node_modules/@open-mercato/core/src/modules/api_docs](../../../node_modules/@open-mercato/core/src/modules/api_docs)
+<!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
 
 ## Entities
 
@@ -18,18 +17,6 @@ _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_
@@ -43,53 +30,10 @@ _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 commands
-
-_none_
-
-## AI tools / MCP capabilities
+## CLI
 
 _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) |