npm - @open-mercato/cli - Versions diffs - 0.6.7-develop.6795.1.8a3f27921c → 0.6.7-develop.6824.1.21fff90682 - Mend

@open-mercato/cli 0.6.7-develop.6795.1.8a3f27921c → 0.6.7-develop.6824.1.21fff90682

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (102) hide show

package/.turbo/turbo-build.log +1 -1
package/build.mjs +1 -1
package/dist/agentic/guides/module-facts.json +90266 -20749
package/dist/agentic/guides/modules/ai_assistant.md +170 -60
package/dist/agentic/guides/modules/api_docs.md +26 -1
package/dist/agentic/guides/modules/api_keys.md +57 -17
package/dist/agentic/guides/modules/attachments.md +72 -19
package/dist/agentic/guides/modules/audit_logs.md +95 -29
package/dist/agentic/guides/modules/auth.md +218 -83
package/dist/agentic/guides/modules/business_rules.md +108 -34
package/dist/agentic/guides/modules/catalog.md +386 -157
package/dist/agentic/guides/modules/channel_gmail.md +55 -6
package/dist/agentic/guides/modules/channel_imap.md +55 -6
package/dist/agentic/guides/modules/checkout.md +254 -129
package/dist/agentic/guides/modules/communication_channels.md +280 -109
package/dist/agentic/guides/modules/configs.md +68 -11
package/dist/agentic/guides/modules/content.md +26 -1
package/dist/agentic/guides/modules/currencies.md +109 -44
package/dist/agentic/guides/modules/customer_accounts.md +350 -156
package/dist/agentic/guides/modules/customers.md +642 -294
package/dist/agentic/guides/modules/dashboards.md +122 -28
package/dist/agentic/guides/modules/data_sync.md +117 -37
package/dist/agentic/guides/modules/design_system.md +36 -2
package/dist/agentic/guides/modules/dictionaries.md +78 -20
package/dist/agentic/guides/modules/directory.md +110 -45
package/dist/agentic/guides/modules/entities.md +95 -38
package/dist/agentic/guides/modules/events.md +31 -1
package/dist/agentic/guides/modules/feature_toggles.md +79 -12
package/dist/agentic/guides/modules/gateway_stripe.md +61 -6
package/dist/agentic/guides/modules/generators.md +17 -1
package/dist/agentic/guides/modules/inbox_ops.md +171 -60
package/dist/agentic/guides/modules/integrations.md +116 -30
package/dist/agentic/guides/modules/messages.md +187 -66
package/dist/agentic/guides/modules/notifications.md +64 -9
package/dist/agentic/guides/modules/onboarding.md +47 -8
package/dist/agentic/guides/modules/payment_gateways.md +133 -48
package/dist/agentic/guides/modules/perspectives.md +50 -12
package/dist/agentic/guides/modules/planner.md +102 -32
package/dist/agentic/guides/modules/portal.md +58 -15
package/dist/agentic/guides/modules/progress.md +78 -30
package/dist/agentic/guides/modules/query_index.md +115 -53
package/dist/agentic/guides/modules/record_locks.md +178 -59
package/dist/agentic/guides/modules/resources.md +155 -78
package/dist/agentic/guides/modules/sales.md +620 -257
package/dist/agentic/guides/modules/scheduler.md +95 -19
package/dist/agentic/guides/modules/search.md +124 -20
package/dist/agentic/guides/modules/security.md +251 -105
package/dist/agentic/guides/modules/shipping_carriers.md +106 -37
package/dist/agentic/guides/modules/sso.md +121 -49
package/dist/agentic/guides/modules/staff.md +314 -126
package/dist/agentic/guides/modules/storage_s3.md +55 -6
package/dist/agentic/guides/modules/sync_akeneo.md +54 -4
package/dist/agentic/guides/modules/sync_excel.md +49 -11
package/dist/agentic/guides/modules/system_status_overlays.md +33 -5
package/dist/agentic/guides/modules/translations.md +76 -21
package/dist/agentic/guides/modules/webhooks.md +166 -82
package/dist/agentic/guides/modules/wms.md +383 -223
package/dist/agentic/guides/modules/workflows.md +248 -112
package/dist/agentic/guides/upstream/AGENTS.md +1 -1
package/dist/agentic/guides/upstream/BACKWARD_COMPATIBILITY.md +2 -0
package/dist/agentic/guides/upstream/manifest.json +3 -3
package/dist/agentic/shared/AGENTS.md.template +6 -5
package/dist/agentic/shared/ai/harness/README.md +2 -2
package/dist/agentic/shared/ai/harness/RELEASE.md +4 -4
package/dist/agentic/shared/ai/harness/cases.json +94 -1
package/dist/agentic/shared/ai/harness/cases.schema.json +3 -3
package/dist/agentic/shared/ai/harness/validators.json +1 -1
package/dist/agentic/shared/ai/lessons/_template.md +16 -0
package/dist/agentic/shared/ai/lessons.md +26 -3
package/dist/agentic/shared/ai/skills/om-evolve-harness/SKILL.md +7 -6
package/dist/agentic/shared/ai/skills/om-system-extension/SKILL.md +1 -1
package/dist/agentic/shared/ai/skills/om-system-extension/references/unified-overrides.md +4 -2
package/dist/agentic/shared/scripts/check-lessons.mjs +178 -0
package/dist/agentic/shared/scripts/evaluate-agent-harness.mjs +37 -12
package/dist/lib/agentic-setup.js +2 -2
package/dist/lib/agentic-setup.js.map +2 -2
package/dist/lib/generators/module-extension-facts.js +652 -24
package/dist/lib/generators/module-extension-facts.js.map +3 -3
package/dist/lib/generators/module-fact-sources.js +70 -0
package/dist/lib/generators/module-fact-sources.js.map +7 -0
package/dist/lib/generators/module-facts.js +1001 -26
package/dist/lib/generators/module-facts.js.map +3 -3
package/dist/lib/generators/module-override-targets.js +688 -0
package/dist/lib/generators/module-override-targets.js.map +7 -0
package/dist/lib/testing/integration.js +5 -0
package/dist/lib/testing/integration.js.map +2 -2
package/package.json +5 -5
package/src/lib/__tests__/agentic-setup.ownership.test.ts +6 -0
package/src/lib/agentic-setup.ts +6 -2
package/src/lib/generators/__tests__/activation-adapter-coverage.test.ts +92 -0
package/src/lib/generators/__tests__/module-extension-activations.test.ts +762 -0
package/src/lib/generators/__tests__/module-extension-facts.test.ts +4 -2
package/src/lib/generators/__tests__/module-facts.bc-guard.test.ts +37 -3
package/src/lib/generators/__tests__/module-facts.owned-contracts.test.ts +561 -0
package/src/lib/generators/__tests__/module-override-targets.roundtrip.test.ts +149 -0
package/src/lib/generators/__tests__/module-override-targets.test.ts +304 -0
package/src/lib/generators/module-extension-facts.ts +923 -27
package/src/lib/generators/module-fact-sources.ts +108 -0
package/src/lib/generators/module-facts.ts +1360 -25
package/src/lib/generators/module-override-targets.ts +863 -0
package/src/lib/testing/__tests__/integration.test.ts +4 -0
package/src/lib/testing/integration.ts +5 -0

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

@@ -1,38 +1,47 @@
 # ai_assistant — module facts (generated, do not edit)
-<!-- generated from @open-mercato/ai-assistant 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/ai-assistant 0.6.7-develop.6824.1.21fff90682; core 0.6.7-develop.6824.1.21fff90682 — 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)
 ## Entities
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| 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 |
-| ai_assistant:ai_moderation_flag | AiModerationFlag | ai_moderation_flags | no | no |
+| 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 |
-|---|---|---|---|
-| 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 | client |
-| ai_assistant.conversation.unshared | — | ai_chat_conversation | client |
-| ai_assistant.moderation_flag.created | — | ai_moderation_flag | — |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| 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
@@ -57,7 +66,9 @@ _none_
 ## DI service tokens
-moderationService
+| 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
@@ -70,49 +81,76 @@ _none_
 ## UMES hosts
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| ai_assistant:ai_agent_mutation_policy_override | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_agent_prompt_override | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_agent_runtime_override | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_chat_conversation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_chat_conversation_participant | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_chat_message | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_moderation_flag | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_pending_action | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_tenant_model_allowlist | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_token_usage_daily | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant:ai_token_usage_event | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| ai_assistant.conversation.shared | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
-| ai_assistant.conversation.unshared | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE |
-| ai_assistant.moderation_flag.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| ai.action.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| ai.action.confirmed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| ai.action.expired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| ai.token_usage.recorded | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| 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 |
-|---|---|---|---|---|---|
-| 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 |
-| 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 |
-| ai:attachments.list_record_attachments | specialized-registry | attachments.list_record_attachments | — | registry=ai; registryId=attachments.list_record_attachments; specialistRoute=aiTools | fact-ref |
-| ai:attachments.read_attachment | specialized-registry | attachments.read_attachment | — | registry=ai; registryId=attachments.read_attachment; specialistRoute=aiTools | fact-ref |
-| ai:attachments.transfer_record_attachments | specialized-registry | attachments.transfer_record_attachments | — | registry=ai; registryId=attachments.transfer_record_attachments; specialistRoute=aiTools | fact-ref |
-| ai:meta.describe_agent | specialized-registry | meta.describe_agent | — | registry=ai; registryId=meta.describe_agent; specialistRoute=aiTools | fact-ref |
-| ai:meta.list_agents | specialized-registry | meta.list_agents | — | registry=ai; registryId=meta.list_agents; specialistRoute=aiTools | fact-ref |
-| ai:meta.update_task_plan | specialized-registry | meta.update_task_plan | — | registry=ai; registryId=meta.update_task_plan; specialistRoute=aiTools | fact-ref |
-| ai:search.get_record_context | specialized-registry | search.get_record_context | — | registry=ai; registryId=search.get_record_context; specialistRoute=aiTools | fact-ref |
-| ai:search.hybrid_search | specialized-registry | search.hybrid_search | — | registry=ai; registryId=search.hybrid_search; specialistRoute=aiTools | fact-ref |
-| notification:ai_assistant.conversation_shared | specialized-registry | ai_assistant.conversation_shared | — | registry=notification; registryId=ai_assistant.conversation_shared; specialistRoute=notifications | fact-ref |
-| 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 |
+| 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
@@ -144,3 +182,75 @@ ai_assistant.conversation_shared
 ## 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) |
+## DI registrations (rich)
+| 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 CHANGED Viewed

@@ -1,5 +1,5 @@
 # api_docs — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6824.1.21fff90682; core 0.6.7-develop.6824.1.21fff90682 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/api_docs](../../../node_modules/@open-mercato/core/src/modules/api_docs)
 ## Entities
@@ -51,6 +51,18 @@ _none_
 _none_
+## Active extension bindings
+_none_
+## Incoming installed contributions
+_none_
+## Contribution resolutions
+_none_
 ## Notifications
@@ -68,3 +80,16 @@ _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) |

package/dist/agentic/guides/modules/api_keys.md CHANGED Viewed

@@ -1,12 +1,12 @@
 # api_keys — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6824.1.21fff90682; core 0.6.7-develop.6824.1.21fff90682 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/api_keys](../../../node_modules/@open-mercato/core/src/modules/api_keys)
 ## Entities
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| api_keys:api_key | ApiKey | api_keys | yes | no |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| api_keys:api_key | ApiKey | api_keys | yes | no | [node_modules/@open-mercato/core/src/modules/api_keys/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/data/entities.ts) |
 ## Events  (0)
@@ -14,7 +14,11 @@ _none_
 ## ACL features  (3)
-api_keys.view · api_keys.create · api_keys.delete
+| Feature | Source |
+|---|---|
+| api_keys.view | [node_modules/@open-mercato/core/src/modules/api_keys/acl.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/acl.ts) |
+| api_keys.create | [node_modules/@open-mercato/core/src/modules/api_keys/acl.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/acl.ts) |
+| api_keys.delete | [node_modules/@open-mercato/core/src/modules/api_keys/acl.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/acl.ts) |
 ## API routes
@@ -46,23 +50,35 @@ _none_
 ## UMES hosts
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| data-table:api_keys.list | data-table | component-replacement | — | FROZEN |
-| data-table:api_keys.list:bulk-actions | data-table | bulk-action | — | FROZEN |
-| data-table:api_keys.list:columns | data-table | column-widget | — | FROZEN |
-| data-table:api_keys.list:filters | data-table | filter-widget | — | FROZEN |
-| data-table:api_keys.list:footer | data-table | render-widget | — | FROZEN |
-| data-table:api_keys.list:header | data-table | render-widget | — | FROZEN |
-| data-table:api_keys.list:row-actions | data-table | row-action | — | FROZEN |
-| data-table:api_keys.list:search-trailing | data-table | render-widget | — | FROZEN |
-| data-table:api_keys.list:toolbar | data-table | toolbar-widget | — | FROZEN |
-| api_keys:api_key | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| data-table:api_keys.list | data-table | component-replacement | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:bulk-actions | data-table | bulk-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:columns | data-table | column-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:filters | data-table | filter-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:footer | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:header | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:row-actions | data-table | row-action | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:search-trailing | data-table | render-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| data-table:api_keys.list:toolbar | data-table | toolbar-widget | — | FROZEN | [node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/extension-points.ts) |
+| api_keys:api_key | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:api_keys:api_key |
 ## UMES contributions
 _none_
+## Active extension bindings
+_none_
+## Incoming installed contributions
+_none_
+## Contribution resolutions
+_none_
 ## UMES diagnostics
 - unbound-helper: data-table:api_keys.list:empty-state
@@ -84,3 +100,27 @@ _none_
 ## AI agents
 _none_
+## Exact override targets
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["api_keys.create"]` | disable-replace | aclFeatures:api_keys.create | [node_modules/@open-mercato/core/src/modules/api_keys/acl.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/acl.ts) |
+| acl | `overrides.acl.features["api_keys.delete"]` | disable-replace | aclFeatures:api_keys.delete | [node_modules/@open-mercato/core/src/modules/api_keys/acl.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/acl.ts) |
+| acl | `overrides.acl.features["api_keys.view"]` | disable-replace | aclFeatures:api_keys.view | [node_modules/@open-mercato/core/src/modules/api_keys/acl.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/acl.ts) |
+| cli | `overrides.cli["add"]` | disable-replace | cliCommands:add | [node_modules/@open-mercato/core/src/modules/api_keys/cli.ts](../../../node_modules/@open-mercato/core/src/modules/api_keys/cli.ts) |
+| routes | `overrides.routes.pages["backend:/backend/api-keys"]` | disable-replace | backendPages:/backend/api-keys | [node_modules/@open-mercato/core/src/modules/api_keys/backend/api-keys/page.tsx](../../../node_modules/@open-mercato/core/src/modules/api_keys/backend/api-keys/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/api-keys/create"]` | disable-replace | backendPages:/backend/api-keys/create | [node_modules/@open-mercato/core/src/modules/api_keys/backend/api-keys/create/page.tsx](../../../node_modules/@open-mercato/core/src/modules/api_keys/backend/api-keys/create/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:api_keys:setup | [node_modules/@open-mercato/core/src/modules/api_keys/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/api_keys/setup.ts#L3) |
+## Owned contract — module metadata
+| ID | Metadata | Source |
+|---|---|---|
+| api_keys | name=api_keys; requires=auth; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/api_keys/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/api_keys/index.ts#L3) |
+## Setup
+| ID | Metadata | Source |
+|---|---|---|
+| api_keys:setup | roles=admin | [node_modules/@open-mercato/core/src/modules/api_keys/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/api_keys/setup.ts#L3) |

package/dist/agentic/guides/modules/attachments.md CHANGED Viewed

@@ -1,25 +1,28 @@
 # attachments — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6795.1.8a3f27921c; core 0.6.7-develop.6795.1.8a3f27921c — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6824.1.21fff90682; core 0.6.7-develop.6824.1.21fff90682 — R1 staleness stamp -->
 Source root: [node_modules/@open-mercato/core/src/modules/attachments](../../../node_modules/@open-mercato/core/src/modules/attachments)
 ## Entities
-| Entity ID | Class | Table | Editable | CustomFields |
-|---|---|---|---|---|
-| attachments:attachment_partition | AttachmentPartition | attachment_partitions | yes | no |
-| attachments:attachment | Attachment | attachments | no | yes |
+| Entity ID | Class | Table | Editable | CustomFields | Source |
+|---|---|---|---|---|---|
+| attachments:attachment_partition | AttachmentPartition | attachment_partitions | yes | no | [node_modules/@open-mercato/core/src/modules/attachments/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/data/entities.ts) |
+| attachments:attachment | Attachment | attachments | no | yes | [node_modules/@open-mercato/core/src/modules/attachments/data/entities.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/data/entities.ts) |
 ## Events  (3)
-| ID | Category | Entity | Browser transport |
-|---|---|---|---|
-| attachments.attachment.created | crud | attachment | — |
-| attachments.attachment.updated | crud | attachment | — |
-| attachments.attachment.deleted | crud | attachment | — |
+| ID | Category | Entity | Browser transport | Source |
+|---|---|---|---|---|
+| attachments.attachment.created | crud | attachment | — | [node_modules/@open-mercato/core/src/modules/attachments/events.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/events.ts) |
+| attachments.attachment.updated | crud | attachment | — | [node_modules/@open-mercato/core/src/modules/attachments/events.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/events.ts) |
+| attachments.attachment.deleted | crud | attachment | — | [node_modules/@open-mercato/core/src/modules/attachments/events.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/events.ts) |
 ## ACL features  (2)
-attachments.view · attachments.manage
+| Feature | Source |
+|---|---|
+| attachments.view | [node_modules/@open-mercato/core/src/modules/attachments/acl.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/acl.ts) |
+| attachments.manage | [node_modules/@open-mercato/core/src/modules/attachments/acl.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/acl.ts) |
 ## API routes
@@ -38,7 +41,9 @@ _none_
 ## DI service tokens
-storageDriverFactory
+| Token | Source |
+|---|---|
+| storageDriverFactory | [node_modules/@open-mercato/core/src/modules/attachments/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/attachments/di.ts#L7) |
 ## Search entities
@@ -51,18 +56,30 @@ _none_
 ## UMES hosts
-| ID / pattern | Family | Supports | Context | Stability |
-|---|---|---|---|---|
-| attachments:attachment | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| attachments:attachment_partition | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE |
-| attachments.attachment.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| attachments.attachment.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
-| attachments.attachment.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE |
+| ID / pattern | Family | Supports | Context | Stability | Source |
+|---|---|---|---|---|---|
+| attachments:attachment | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:attachments:attachment |
+| attachments:attachment_partition | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:attachments:attachment_partition |
+| attachments.attachment.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:attachments.attachment.created |
+| attachments.attachment.deleted | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:attachments.attachment.deleted |
+| attachments.attachment.updated | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:attachments.attachment.updated |
 ## UMES contributions
 _none_
+## Active extension bindings
+_none_
+## Incoming installed contributions
+_none_
+## Contribution resolutions
+_none_
 ## Notifications
@@ -82,3 +99,39 @@ _none_
 ## AI agents
 _none_
+## Exact override targets
+| Domain | Path / key | Supported modes | Referenced fact | Source |
+|---|---|---|---|---|
+| acl | `overrides.acl.features["attachments.manage"]` | disable-replace | aclFeatures:attachments.manage | [node_modules/@open-mercato/core/src/modules/attachments/acl.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/acl.ts) |
+| acl | `overrides.acl.features["attachments.view"]` | disable-replace | aclFeatures:attachments.view | [node_modules/@open-mercato/core/src/modules/attachments/acl.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/acl.ts) |
+| cli | `overrides.cli["delete"]` | disable-replace | cliCommands:delete | [node_modules/@open-mercato/core/src/modules/attachments/cli.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/cli.ts) |
+| di | `overrides.di["storageDriverFactory"]` | disable-replace | ownedContracts.di-registration:storageDriverFactory | [node_modules/@open-mercato/core/src/modules/attachments/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/attachments/di.ts#L7) |
+| routes | `overrides.routes.pages["backend:/backend/config/attachments"]` | disable-replace | backendPages:/backend/config/attachments | [node_modules/@open-mercato/core/src/modules/attachments/backend/config/attachments/page.tsx](../../../node_modules/@open-mercato/core/src/modules/attachments/backend/config/attachments/page.tsx) |
+| routes | `overrides.routes.pages["backend:/backend/storage/attachments"]` | disable-replace | backendPages:/backend/storage/attachments | [node_modules/@open-mercato/core/src/modules/attachments/backend/storage/attachments/page.tsx](../../../node_modules/@open-mercato/core/src/modules/attachments/backend/storage/attachments/page.tsx) |
+| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:attachments:setup | [node_modules/@open-mercato/core/src/modules/attachments/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/attachments/setup.ts#L3) |
+## Owned contract — module metadata
+| ID | Metadata | Source |
+|---|---|---|
+| attachments | name=attachments; version=0.1.0 | [node_modules/@open-mercato/core/src/modules/attachments/index.ts:3](../../../node_modules/@open-mercato/core/src/modules/attachments/index.ts#L3) |
+## Setup
+| ID | Metadata | Source |
+|---|---|---|
+| attachments:setup | roles=admin, employee | [node_modules/@open-mercato/core/src/modules/attachments/setup.ts:3](../../../node_modules/@open-mercato/core/src/modules/attachments/setup.ts#L3) |
+## DI registrations (rich)
+| Token | Kind | Lifetime | Injection | Provider | Source |
+|---|---|---|---|---|---|
+| storageDriverFactory | function | singleton | proxy | — | [node_modules/@open-mercato/core/src/modules/attachments/di.ts:7](../../../node_modules/@open-mercato/core/src/modules/attachments/di.ts#L7) |
+## Custom entities
+| ID | Metadata | Source |
+|---|---|---|
+| attachments:attachment | — | [node_modules/@open-mercato/core/src/modules/attachments/ce.ts](../../../node_modules/@open-mercato/core/src/modules/attachments/ce.ts) |