create-mercato-app 0.6.7 → 0.6.8-develop.6874.1.982d6097d8

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 (419) hide show
  1. package/README.md +72 -0
  2. package/agentic/claude-code/hooks/entity-migration-check.ts +32 -88
  3. package/agentic/codex/enforcement-rules.md +2 -16
  4. package/agentic/cursor/hooks/entity-migration-check.mjs +19 -50
  5. package/agentic/cursor/rules/entity-guard.mdc +9 -21
  6. package/agentic/cursor/rules/generated-guard.mdc +3 -5
  7. package/agentic/cursor/rules/open-mercato.mdc +3 -29
  8. package/agentic/guides/ai-workflows.md +76 -0
  9. package/agentic/guides/architecture.md +107 -0
  10. package/agentic/guides/backend-ui.md +80 -0
  11. package/agentic/guides/contracts.md +92 -0
  12. package/agentic/guides/extensions.md +121 -0
  13. package/agentic/guides/integrations.md +81 -0
  14. package/agentic/guides/module-system.md +12 -127
  15. package/agentic/guides/spec-delivery.md +22 -0
  16. package/agentic/guides/testing-debugging.md +80 -0
  17. package/agentic/shared/AGENTS.md.template +124 -311
  18. package/agentic/shared/ai/agentic.config.json +2 -0
  19. package/agentic/shared/ai/harness/README.md +50 -0
  20. package/agentic/shared/ai/harness/RELEASE.md +57 -0
  21. package/agentic/shared/ai/harness/cases.json +13680 -0
  22. package/agentic/shared/ai/harness/cases.schema.json +133 -0
  23. package/agentic/shared/ai/harness/fixtures/index.json +49 -0
  24. package/agentic/shared/ai/harness/fixtures/seeds.json +162 -0
  25. package/agentic/shared/ai/harness/generated-code-review-policy.md +21 -0
  26. package/agentic/shared/ai/harness/generated-code-review-response.schema.json +96 -0
  27. package/agentic/shared/ai/harness/generated-code-review-result.schema.json +172 -0
  28. package/agentic/shared/ai/harness/release-matrix.json +158 -0
  29. package/agentic/shared/ai/harness/release-result.schema.json +219 -0
  30. package/agentic/shared/ai/harness/result.schema.json +76 -0
  31. package/agentic/shared/ai/harness/routing-response.schema.json +12 -0
  32. package/agentic/shared/ai/harness/target-validation-result.schema.json +73 -0
  33. package/agentic/shared/ai/harness/validators.json +78 -0
  34. package/agentic/shared/ai/harness/writable-ast-oracles.mjs +2121 -0
  35. package/agentic/shared/ai/harness/writable-behavior-oracles.mjs +1096 -0
  36. package/agentic/shared/ai/lessons/_template.md +16 -0
  37. package/agentic/shared/ai/lessons.md +26 -3
  38. package/agentic/shared/ai/review-checklist.md +36 -0
  39. package/agentic/shared/ai/skills/om-auto-implement-spec/SKILL.md +21 -0
  40. package/agentic/shared/ai/skills/om-auto-review-pr/SKILL.md +4 -0
  41. package/agentic/shared/ai/skills/om-auto-upgrade-0.6.6-to-0.6.7/SKILL.md +98 -0
  42. package/agentic/shared/ai/skills/om-backend-ui-design/SKILL.md +20 -241
  43. package/agentic/shared/ai/skills/om-backend-ui-design/references/crud-surfaces.md +16 -0
  44. package/agentic/shared/ai/skills/om-backend-ui-design/references/frontend-and-design-system.md +53 -0
  45. package/agentic/shared/ai/skills/om-backend-ui-design/references/page-and-navigation.md +13 -0
  46. package/agentic/shared/ai/skills/om-backend-ui-design/references/quality-states.md +11 -0
  47. package/agentic/shared/ai/skills/om-build-workflow/SKILL.md +30 -0
  48. package/agentic/shared/ai/skills/om-build-workflow/references/activity-contracts.md +12 -0
  49. package/agentic/shared/ai/skills/om-build-workflow/references/durability-and-progress.md +13 -0
  50. package/agentic/shared/ai/skills/om-build-workflow/references/workflow-design.md +14 -0
  51. package/agentic/shared/ai/skills/om-create-ai-agent/SKILL.md +28 -0
  52. package/agentic/shared/ai/skills/om-create-ai-agent/references/attachments-and-overrides.md +12 -0
  53. package/agentic/shared/ai/skills/om-create-ai-agent/references/module-agents-and-tools.md +22 -0
  54. package/agentic/shared/ai/skills/om-create-ai-agent/references/orchestrator-agents.md +12 -0
  55. package/agentic/shared/ai/skills/om-create-ai-agent/references/surface-selector.md +19 -0
  56. package/agentic/shared/ai/skills/om-data-model-design/SKILL.md +16 -601
  57. package/agentic/shared/ai/skills/om-data-model-design/references/integrity-and-concurrency.md +19 -0
  58. package/agentic/shared/ai/skills/om-data-model-design/references/migration-workflow.md +13 -0
  59. package/agentic/shared/ai/skills/om-data-model-design/references/schema-design.md +14 -0
  60. package/agentic/shared/ai/skills/om-data-model-design/references/sensitive-data.md +10 -0
  61. package/agentic/shared/ai/skills/om-eject-and-customize/SKILL.md +14 -310
  62. package/agentic/shared/ai/skills/om-eject-and-customize/references/decision-and-procedure.md +17 -0
  63. package/agentic/shared/ai/skills/om-evolve-harness/SKILL.md +29 -0
  64. package/agentic/shared/ai/skills/om-evolve-harness/references/case-template.md +100 -0
  65. package/agentic/shared/ai/skills/om-evolve-harness/references/case-workflow.md +16 -0
  66. package/agentic/shared/ai/skills/om-evolve-harness/references/owner-selection.md +17 -0
  67. package/agentic/shared/ai/skills/om-framework-context/SKILL.md +25 -0
  68. package/agentic/shared/ai/skills/om-framework-context/references/resolver-procedure.md +11 -0
  69. package/agentic/shared/ai/skills/om-framework-context/references/skew-and-escalation.md +13 -0
  70. package/agentic/shared/ai/skills/om-help/SKILL.md +15 -97
  71. package/agentic/shared/ai/skills/om-help/references/delivery-workflows.md +18 -0
  72. package/agentic/shared/ai/skills/om-help/references/task-families.md +20 -0
  73. package/agentic/shared/ai/skills/om-implement-spec/SKILL.md +33 -152
  74. package/agentic/shared/ai/skills/om-implement-spec/references/phases-and-gates.md +33 -0
  75. package/agentic/shared/ai/skills/om-implement-spec/references/planning-and-progress.md +40 -0
  76. package/agentic/shared/ai/skills/om-implement-spec/references/report-templates.md +27 -0
  77. package/agentic/shared/ai/skills/om-implement-spec/references/spec-resolution.md +24 -0
  78. package/agentic/shared/ai/skills/om-integration-builder/SKILL.md +24 -708
  79. package/agentic/shared/ai/skills/om-integration-builder/references/package-and-activation.md +16 -0
  80. package/agentic/shared/ai/skills/om-integration-builder/references/provider-families.md +14 -0
  81. package/agentic/shared/ai/skills/om-integration-builder/references/security-and-reliability.md +15 -0
  82. package/agentic/shared/ai/skills/om-integration-builder/references/sync-and-files.md +12 -0
  83. package/agentic/shared/ai/skills/om-judge-agent-session/SKILL.md +34 -0
  84. package/agentic/shared/ai/skills/om-judge-agent-session/agents/openai.yaml +4 -0
  85. package/agentic/shared/ai/skills/om-judge-agent-session/references/agentic-setup.md +11 -0
  86. package/agentic/shared/ai/skills/om-judge-agent-session/references/input-normalization.md +31 -0
  87. package/agentic/shared/ai/skills/om-judge-agent-session/references/judge-workflow.md +39 -0
  88. package/agentic/shared/ai/skills/om-judge-agent-session/references/report-template.md +43 -0
  89. package/agentic/shared/ai/skills/om-judge-agent-session/references/rules.md +11 -0
  90. package/agentic/shared/ai/skills/om-module-scaffold/SKILL.md +20 -820
  91. package/agentic/shared/ai/skills/om-module-scaffold/references/api-and-domain.md +19 -0
  92. package/agentic/shared/ai/skills/om-module-scaffold/references/business-one-shot-blueprints.md +172 -0
  93. package/agentic/shared/ai/skills/om-module-scaffold/references/data-and-migrations.md +12 -0
  94. package/agentic/shared/ai/skills/om-module-scaffold/references/discovery-surface-catalog.md +83 -0
  95. package/agentic/shared/ai/skills/om-module-scaffold/references/module-surfaces.md +21 -0
  96. package/agentic/shared/ai/skills/om-module-scaffold/references/planning.md +11 -0
  97. package/agentic/shared/ai/skills/om-module-scaffold/references/runtime-cache-and-queues.md +22 -0
  98. package/agentic/shared/ai/skills/om-module-scaffold/references/verification.md +13 -0
  99. package/agentic/shared/ai/skills/om-share-this-session/SKILL.md +41 -0
  100. package/agentic/shared/ai/skills/om-share-this-session/references/agentic-setup.md +19 -0
  101. package/agentic/shared/ai/skills/om-share-this-session/references/bundle-preparation.md +44 -0
  102. package/agentic/shared/ai/skills/om-share-this-session/references/consent-and-review.md +39 -0
  103. package/agentic/shared/ai/skills/om-share-this-session/references/publication.md +20 -0
  104. package/agentic/shared/ai/skills/om-share-this-session/references/report-templates.md +57 -0
  105. package/agentic/shared/ai/skills/om-share-this-session/references/rules.md +11 -0
  106. package/agentic/shared/ai/skills/om-share-this-session/scripts/prepare-share-bundle.mjs +486 -0
  107. package/agentic/shared/ai/skills/om-system-extension/SKILL.md +19 -843
  108. package/agentic/shared/ai/skills/om-system-extension/references/extension-branches.md +18 -0
  109. package/agentic/shared/ai/skills/om-system-extension/references/mechanism-selector.md +27 -0
  110. package/agentic/shared/ai/skills/om-system-extension/references/read-write-roundtrip.md +13 -0
  111. package/agentic/shared/ai/skills/om-system-extension/references/unified-overrides.md +41 -0
  112. package/agentic/shared/ai/skills/om-system-extension/references/verification.md +11 -0
  113. package/agentic/shared/ai/skills/om-trim-unused-modules/SKILL.md +15 -63
  114. package/agentic/shared/ai/skills/om-trim-unused-modules/references/dependency-and-redirect.md +15 -0
  115. package/agentic/shared/ai/skills/om-troubleshooter/SKILL.md +16 -467
  116. package/agentic/shared/ai/skills/om-troubleshooter/references/diagnosis-map.md +16 -0
  117. package/agentic/shared/ai/skills/om-troubleshooter/references/regression-oracles.md +14 -0
  118. package/agentic/shared/ai/skills/tiers.json +143 -21
  119. package/agentic/shared/ai/skills/tiers.schema.json +52 -40
  120. package/agentic/shared/ai/specs/README.md +4 -3
  121. package/agentic/shared/ai/specs/SPEC-000-template.md +226 -10
  122. package/agentic/shared/ai/trackers/github.md +108 -4
  123. package/agentic/shared/scripts/agent-harness-tool-server.mjs +187 -0
  124. package/agentic/shared/scripts/check-lessons.mjs +178 -0
  125. package/agentic/shared/scripts/evaluate-agent-harness.mjs +2958 -0
  126. package/agentic/shared/scripts/execution-sandbox.mjs +329 -0
  127. package/agentic/shared/scripts/framework-context.mjs +888 -0
  128. package/agentic/shared/scripts/install-skills.mjs +1029 -0
  129. package/agentic/shared/scripts/install-skills.sh +4 -694
  130. package/agentic/shared/scripts/prepare-agent-harness-fixture.mjs +222 -0
  131. package/agentic/shared/scripts/run-agent-harness-release.mjs +1774 -0
  132. package/dist/agentic/claude-code/hooks/entity-migration-check.ts +32 -88
  133. package/dist/agentic/codex/enforcement-rules.md +2 -16
  134. package/dist/agentic/cursor/hooks/entity-migration-check.mjs +19 -50
  135. package/dist/agentic/cursor/rules/entity-guard.mdc +9 -21
  136. package/dist/agentic/cursor/rules/generated-guard.mdc +3 -5
  137. package/dist/agentic/cursor/rules/open-mercato.mdc +3 -29
  138. package/dist/agentic/guides/ai-workflows.md +76 -0
  139. package/dist/agentic/guides/architecture.md +107 -0
  140. package/dist/agentic/guides/backend-ui.md +80 -0
  141. package/dist/agentic/guides/contracts.md +92 -0
  142. package/dist/agentic/guides/extensions.md +121 -0
  143. package/dist/agentic/guides/framework-extension-points.md +36 -0
  144. package/dist/agentic/guides/integrations.md +81 -0
  145. package/dist/agentic/guides/module-facts.json +115537 -3951
  146. package/dist/agentic/guides/module-system.md +12 -127
  147. package/dist/agentic/guides/modules/ai_assistant.md +227 -28
  148. package/dist/agentic/guides/modules/api_docs.md +58 -2
  149. package/dist/agentic/guides/modules/api_keys.md +92 -7
  150. package/dist/agentic/guides/modules/attachments.md +119 -14
  151. package/dist/agentic/guides/modules/audit_logs.md +131 -10
  152. package/dist/agentic/guides/modules/auth.md +276 -33
  153. package/dist/agentic/guides/modules/business_rules.md +149 -14
  154. package/dist/agentic/guides/modules/catalog.md +475 -43
  155. package/dist/agentic/guides/modules/channel_gmail.md +82 -3
  156. package/dist/agentic/guides/modules/channel_imap.md +82 -3
  157. package/dist/agentic/guides/modules/checkout.md +299 -27
  158. package/dist/agentic/guides/modules/communication_channels.md +315 -33
  159. package/dist/agentic/guides/modules/configs.md +104 -8
  160. package/dist/agentic/guides/modules/content.md +57 -2
  161. package/dist/agentic/guides/modules/currencies.md +152 -17
  162. package/dist/agentic/guides/modules/customer_accounts.md +387 -45
  163. package/dist/agentic/guides/modules/customers.md +746 -85
  164. package/dist/agentic/guides/modules/dashboards.md +155 -10
  165. package/dist/agentic/guides/modules/data_sync.md +149 -16
  166. package/dist/agentic/guides/modules/design_system.md +102 -0
  167. package/dist/agentic/guides/modules/dictionaries.md +107 -12
  168. package/dist/agentic/guides/modules/directory.md +148 -15
  169. package/dist/agentic/guides/modules/entities.md +145 -13
  170. package/dist/agentic/guides/modules/events.md +59 -2
  171. package/dist/agentic/guides/modules/feature_toggles.md +119 -9
  172. package/dist/agentic/guides/modules/gateway_stripe.md +92 -4
  173. package/dist/agentic/guides/modules/generators.md +45 -2
  174. package/dist/agentic/guides/modules/inbox_ops.md +207 -27
  175. package/dist/agentic/guides/modules/integrations.md +146 -16
  176. package/dist/agentic/guides/modules/messages.md +223 -24
  177. package/dist/agentic/guides/modules/notifications.md +96 -8
  178. package/dist/agentic/guides/modules/onboarding.md +77 -6
  179. package/dist/agentic/guides/modules/payment_gateways.md +164 -21
  180. package/dist/agentic/guides/modules/perspectives.md +77 -7
  181. package/dist/agentic/guides/modules/planner.md +136 -18
  182. package/dist/agentic/guides/modules/portal.md +93 -2
  183. package/dist/agentic/guides/modules/progress.md +104 -14
  184. package/dist/agentic/guides/modules/query_index.md +154 -15
  185. package/dist/agentic/guides/modules/record_locks.md +206 -21
  186. package/dist/agentic/guides/modules/resources.md +197 -30
  187. package/dist/agentic/guides/modules/sales.md +678 -84
  188. package/dist/agentic/guides/modules/scheduler.md +133 -14
  189. package/dist/agentic/guides/modules/search.md +170 -6
  190. package/dist/agentic/guides/modules/security.md +294 -35
  191. package/dist/agentic/guides/modules/shipping_carriers.md +134 -18
  192. package/dist/agentic/guides/modules/sso.md +151 -26
  193. package/dist/agentic/guides/modules/staff.md +369 -57
  194. package/dist/agentic/guides/modules/storage_s3.md +95 -5
  195. package/dist/agentic/guides/modules/sync_akeneo.md +85 -3
  196. package/dist/agentic/guides/modules/sync_excel.md +75 -6
  197. package/dist/agentic/guides/modules/system_status_overlays.md +60 -2
  198. package/dist/agentic/guides/modules/translations.md +104 -10
  199. package/dist/agentic/guides/modules/webhooks.md +203 -24
  200. package/dist/agentic/guides/modules/wms.md +441 -46
  201. package/dist/agentic/guides/modules/workflows.md +302 -43
  202. package/dist/agentic/guides/spec-delivery.md +22 -0
  203. package/dist/agentic/guides/testing-debugging.md +80 -0
  204. package/dist/agentic/guides/upstream/AGENTS.md +299 -0
  205. package/dist/agentic/guides/upstream/BACKWARD_COMPATIBILITY.md +316 -0
  206. package/dist/agentic/guides/upstream/manifest.json +8 -0
  207. package/dist/agentic/shared/AGENTS.md.template +124 -311
  208. package/dist/agentic/shared/ai/agentic.config.json +2 -0
  209. package/dist/agentic/shared/ai/harness/README.md +50 -0
  210. package/dist/agentic/shared/ai/harness/RELEASE.md +57 -0
  211. package/dist/agentic/shared/ai/harness/cases.json +13680 -0
  212. package/dist/agentic/shared/ai/harness/cases.schema.json +133 -0
  213. package/dist/agentic/shared/ai/harness/fixtures/index.json +49 -0
  214. package/dist/agentic/shared/ai/harness/fixtures/seeds.json +162 -0
  215. package/dist/agentic/shared/ai/harness/generated-code-review-policy.md +21 -0
  216. package/dist/agentic/shared/ai/harness/generated-code-review-response.schema.json +96 -0
  217. package/dist/agentic/shared/ai/harness/generated-code-review-result.schema.json +172 -0
  218. package/dist/agentic/shared/ai/harness/release-matrix.json +158 -0
  219. package/dist/agentic/shared/ai/harness/release-result.schema.json +219 -0
  220. package/dist/agentic/shared/ai/harness/result.schema.json +76 -0
  221. package/dist/agentic/shared/ai/harness/routing-response.schema.json +12 -0
  222. package/dist/agentic/shared/ai/harness/target-validation-result.schema.json +73 -0
  223. package/dist/agentic/shared/ai/harness/validators.json +78 -0
  224. package/dist/agentic/shared/ai/harness/writable-ast-oracles.mjs +2121 -0
  225. package/dist/agentic/shared/ai/harness/writable-behavior-oracles.mjs +1096 -0
  226. package/dist/agentic/shared/ai/lessons/_template.md +16 -0
  227. package/dist/agentic/shared/ai/lessons.md +26 -3
  228. package/dist/agentic/shared/ai/review-checklist.md +36 -0
  229. package/dist/agentic/shared/ai/skills/om-auto-implement-spec/SKILL.md +21 -0
  230. package/dist/agentic/shared/ai/skills/om-auto-review-pr/SKILL.md +4 -0
  231. package/dist/agentic/shared/ai/skills/om-auto-upgrade-0.6.6-to-0.6.7/SKILL.md +98 -0
  232. package/dist/agentic/shared/ai/skills/om-backend-ui-design/SKILL.md +20 -241
  233. package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/crud-surfaces.md +16 -0
  234. package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/frontend-and-design-system.md +53 -0
  235. package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/page-and-navigation.md +13 -0
  236. package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/quality-states.md +11 -0
  237. package/dist/agentic/shared/ai/skills/om-build-workflow/SKILL.md +30 -0
  238. package/dist/agentic/shared/ai/skills/om-build-workflow/references/activity-contracts.md +12 -0
  239. package/dist/agentic/shared/ai/skills/om-build-workflow/references/durability-and-progress.md +13 -0
  240. package/dist/agentic/shared/ai/skills/om-build-workflow/references/workflow-design.md +14 -0
  241. package/dist/agentic/shared/ai/skills/om-create-ai-agent/SKILL.md +28 -0
  242. package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/attachments-and-overrides.md +12 -0
  243. package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/module-agents-and-tools.md +22 -0
  244. package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/orchestrator-agents.md +12 -0
  245. package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/surface-selector.md +19 -0
  246. package/dist/agentic/shared/ai/skills/om-data-model-design/SKILL.md +16 -601
  247. package/dist/agentic/shared/ai/skills/om-data-model-design/references/integrity-and-concurrency.md +19 -0
  248. package/dist/agentic/shared/ai/skills/om-data-model-design/references/migration-workflow.md +13 -0
  249. package/dist/agentic/shared/ai/skills/om-data-model-design/references/schema-design.md +14 -0
  250. package/dist/agentic/shared/ai/skills/om-data-model-design/references/sensitive-data.md +10 -0
  251. package/dist/agentic/shared/ai/skills/om-eject-and-customize/SKILL.md +14 -310
  252. package/dist/agentic/shared/ai/skills/om-eject-and-customize/references/decision-and-procedure.md +17 -0
  253. package/dist/agentic/shared/ai/skills/om-evolve-harness/SKILL.md +29 -0
  254. package/dist/agentic/shared/ai/skills/om-evolve-harness/references/case-template.md +100 -0
  255. package/dist/agentic/shared/ai/skills/om-evolve-harness/references/case-workflow.md +16 -0
  256. package/dist/agentic/shared/ai/skills/om-evolve-harness/references/owner-selection.md +17 -0
  257. package/dist/agentic/shared/ai/skills/om-framework-context/SKILL.md +25 -0
  258. package/dist/agentic/shared/ai/skills/om-framework-context/references/resolver-procedure.md +11 -0
  259. package/dist/agentic/shared/ai/skills/om-framework-context/references/skew-and-escalation.md +13 -0
  260. package/dist/agentic/shared/ai/skills/om-help/SKILL.md +15 -97
  261. package/dist/agentic/shared/ai/skills/om-help/references/delivery-workflows.md +18 -0
  262. package/dist/agentic/shared/ai/skills/om-help/references/task-families.md +20 -0
  263. package/dist/agentic/shared/ai/skills/om-implement-spec/SKILL.md +33 -152
  264. package/dist/agentic/shared/ai/skills/om-implement-spec/references/phases-and-gates.md +33 -0
  265. package/dist/agentic/shared/ai/skills/om-implement-spec/references/planning-and-progress.md +40 -0
  266. package/dist/agentic/shared/ai/skills/om-implement-spec/references/report-templates.md +27 -0
  267. package/dist/agentic/shared/ai/skills/om-implement-spec/references/spec-resolution.md +24 -0
  268. package/dist/agentic/shared/ai/skills/om-integration-builder/SKILL.md +24 -708
  269. package/dist/agentic/shared/ai/skills/om-integration-builder/references/package-and-activation.md +16 -0
  270. package/dist/agentic/shared/ai/skills/om-integration-builder/references/provider-families.md +14 -0
  271. package/dist/agentic/shared/ai/skills/om-integration-builder/references/security-and-reliability.md +15 -0
  272. package/dist/agentic/shared/ai/skills/om-integration-builder/references/sync-and-files.md +12 -0
  273. package/dist/agentic/shared/ai/skills/om-judge-agent-session/SKILL.md +34 -0
  274. package/dist/agentic/shared/ai/skills/om-judge-agent-session/agents/openai.yaml +4 -0
  275. package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/agentic-setup.md +11 -0
  276. package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/input-normalization.md +31 -0
  277. package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/judge-workflow.md +39 -0
  278. package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/report-template.md +43 -0
  279. package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/rules.md +11 -0
  280. package/dist/agentic/shared/ai/skills/om-module-scaffold/SKILL.md +20 -820
  281. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/api-and-domain.md +19 -0
  282. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/business-one-shot-blueprints.md +172 -0
  283. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/data-and-migrations.md +12 -0
  284. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/discovery-surface-catalog.md +83 -0
  285. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/module-surfaces.md +21 -0
  286. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/planning.md +11 -0
  287. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/runtime-cache-and-queues.md +22 -0
  288. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/verification.md +13 -0
  289. package/dist/agentic/shared/ai/skills/om-share-this-session/SKILL.md +41 -0
  290. package/dist/agentic/shared/ai/skills/om-share-this-session/references/agentic-setup.md +19 -0
  291. package/dist/agentic/shared/ai/skills/om-share-this-session/references/bundle-preparation.md +44 -0
  292. package/dist/agentic/shared/ai/skills/om-share-this-session/references/consent-and-review.md +39 -0
  293. package/dist/agentic/shared/ai/skills/om-share-this-session/references/publication.md +20 -0
  294. package/dist/agentic/shared/ai/skills/om-share-this-session/references/report-templates.md +57 -0
  295. package/dist/agentic/shared/ai/skills/om-share-this-session/references/rules.md +11 -0
  296. package/dist/agentic/shared/ai/skills/om-share-this-session/scripts/prepare-share-bundle.mjs +486 -0
  297. package/dist/agentic/shared/ai/skills/om-system-extension/SKILL.md +19 -843
  298. package/dist/agentic/shared/ai/skills/om-system-extension/references/extension-branches.md +18 -0
  299. package/dist/agentic/shared/ai/skills/om-system-extension/references/mechanism-selector.md +27 -0
  300. package/dist/agentic/shared/ai/skills/om-system-extension/references/read-write-roundtrip.md +13 -0
  301. package/dist/agentic/shared/ai/skills/om-system-extension/references/unified-overrides.md +41 -0
  302. package/dist/agentic/shared/ai/skills/om-system-extension/references/verification.md +11 -0
  303. package/dist/agentic/shared/ai/skills/om-trim-unused-modules/SKILL.md +15 -63
  304. package/dist/agentic/shared/ai/skills/om-trim-unused-modules/references/dependency-and-redirect.md +15 -0
  305. package/dist/agentic/shared/ai/skills/om-troubleshooter/SKILL.md +16 -467
  306. package/dist/agentic/shared/ai/skills/om-troubleshooter/references/diagnosis-map.md +16 -0
  307. package/dist/agentic/shared/ai/skills/om-troubleshooter/references/regression-oracles.md +14 -0
  308. package/dist/agentic/shared/ai/skills/tiers.json +143 -21
  309. package/dist/agentic/shared/ai/skills/tiers.schema.json +52 -40
  310. package/dist/agentic/shared/ai/specs/README.md +4 -3
  311. package/dist/agentic/shared/ai/specs/SPEC-000-template.md +226 -10
  312. package/dist/agentic/shared/ai/trackers/github.md +108 -4
  313. package/dist/agentic/shared/scripts/agent-harness-tool-server.mjs +187 -0
  314. package/dist/agentic/shared/scripts/check-lessons.mjs +178 -0
  315. package/dist/agentic/shared/scripts/evaluate-agent-harness.mjs +2958 -0
  316. package/dist/agentic/shared/scripts/execution-sandbox.mjs +329 -0
  317. package/dist/agentic/shared/scripts/framework-context.mjs +888 -0
  318. package/dist/agentic/shared/scripts/install-skills.mjs +1029 -0
  319. package/dist/agentic/shared/scripts/install-skills.sh +4 -694
  320. package/dist/agentic/shared/scripts/prepare-agent-harness-fixture.mjs +222 -0
  321. package/dist/agentic/shared/scripts/run-agent-harness-release.mjs +1774 -0
  322. package/dist/index.js +175 -184
  323. package/package.json +9 -7
  324. package/template/.env.example +59 -2
  325. package/template/.yarnrc.yml.template +9 -0
  326. package/template/AGENTS.md +93 -663
  327. package/template/eslint.config.mjs +1 -0
  328. package/template/gitignore +8 -0
  329. package/template/jest.config.cjs +2 -1
  330. package/template/jest.setup.ts +29 -0
  331. package/template/next.config.ts +55 -0
  332. package/template/package.json.template +31 -25
  333. package/template/scripts/dev-memory-monitor.mjs +92 -0
  334. package/template/scripts/dev-memory-sampler.mjs +464 -0
  335. package/template/scripts/dev-runtime-log-policy.mjs +33 -0
  336. package/template/scripts/dev-runtime.mjs +142 -76
  337. package/template/scripts/dev.mjs +129 -7
  338. package/template/scripts/evaluate-agent-harness.mjs +4 -0
  339. package/template/scripts/framework-context.mjs +4 -0
  340. package/template/scripts/install-skills.mjs +10 -0
  341. package/template/scripts/install-skills.sh +2 -19
  342. package/template/scripts/prepare-agent-harness-fixture.mjs +4 -0
  343. package/template/scripts/run-agent-harness-release.mjs +4 -0
  344. package/template/src/app/(backend)/backend/__tests__/layout-route-registry.test.tsx +1 -0
  345. package/template/src/app/(backend)/backend/layout.tsx +5 -3
  346. package/template/src/app/(frontend)/layout.tsx +1 -1
  347. package/template/src/app/api/[...slug]/route.ts +9 -0
  348. package/template/src/app/globals.css +61 -3
  349. package/template/src/app/layout.tsx +2 -18
  350. package/template/src/app/page.tsx +4 -1
  351. package/template/src/components/AppProviders.tsx +4 -1
  352. package/template/src/components/DemoFeedbackWidget.tsx +1 -1
  353. package/template/src/components/__tests__/AppProviders.test.tsx +11 -2
  354. package/template/src/components/__tests__/StartPageContent.test.tsx +69 -0
  355. package/template/src/components/__tests__/starter-chrome-ds.test.ts +35 -0
  356. package/template/src/i18n/de.json +21 -1
  357. package/template/src/i18n/en.json +21 -1
  358. package/template/src/i18n/es.json +21 -1
  359. package/template/src/i18n/ko.json +970 -0
  360. package/template/src/i18n/pl.json +21 -1
  361. package/template/src/instrumentation.ts +14 -1
  362. package/template/src/lib/i18n/register-dictionary-loader.ts +2 -0
  363. package/template/src/modules/example/__integration__/TC-EXAMPLE-001-todo-label-edit.spec.ts +123 -0
  364. package/template/src/modules/example/__integration__/TC-EXAMPLE-002-query-index-failure.spec.ts +155 -0
  365. package/template/src/modules/example/__integration__/TC-UMES-003.spec.ts +7 -3
  366. package/template/src/modules/example/__integration__/TC-UMES-005.spec.ts +7 -1
  367. package/template/src/modules/example/__integration__/TC-UMES-009.spec.ts +11 -10
  368. package/template/src/modules/example/__integration__/todo-priority-validation.spec.ts +31 -1
  369. package/template/src/modules/example/acl.ts +6 -0
  370. package/template/src/modules/example/backend/mutation-lifecycle/page.meta.ts +1 -9
  371. package/template/src/modules/example/backend/page.meta.ts +1 -10
  372. package/template/src/modules/example/backend/payments/page.meta.ts +1 -10
  373. package/template/src/modules/example/backend/payments/page.tsx +2 -2
  374. package/template/src/modules/example/backend/todos/create/page.meta.ts +1 -11
  375. package/template/src/modules/example/backend/todos/page.meta.ts +1 -10
  376. package/template/src/modules/example/backend/umes-extensions/page.meta.ts +1 -9
  377. package/template/src/modules/example/backend/umes-handlers/page.meta.ts +1 -10
  378. package/template/src/modules/example/backend/umes-integrations/page.meta.ts +1 -10
  379. package/template/src/modules/example/backend/umes-next-phases/page.meta.ts +1 -11
  380. package/template/src/modules/example/backend/umes-query-extensions/page.meta.ts +1 -11
  381. package/template/src/modules/example/commands/__tests__/todos.prepare-scope.test.ts +77 -0
  382. package/template/src/modules/example/commands/todos.ts +47 -2
  383. package/template/src/modules/example/i18n/ko.json +481 -0
  384. package/template/src/modules/example/i18n/pl.json +68 -68
  385. package/template/src/modules/example/lib/__tests__/mock-webhook-endpoint-adapter.test.ts +14 -0
  386. package/template/src/modules/example_customers_sync/i18n/ko.json +11 -0
  387. package/template/src/modules.ts +17 -0
  388. package/template/tsconfig.json +3 -2
  389. package/agentic/shared/ai/skills/om-auto-continue-pr-loop/SKILL.md +0 -27
  390. package/agentic/shared/ai/skills/om-auto-create-pr-loop/SKILL.md +0 -27
  391. package/agentic/shared/ai/skills/om-backend-ui-design/references/ui-components.md +0 -260
  392. package/agentic/shared/ai/skills/om-data-model-design/references/mikro-orm-cheatsheet.md +0 -146
  393. package/agentic/shared/ai/skills/om-help/references/skills-catalog.md +0 -84
  394. package/agentic/shared/ai/skills/om-help/references/workflow-sequences.md +0 -193
  395. package/agentic/shared/ai/skills/om-integration-builder/STANDALONE.md +0 -34
  396. package/agentic/shared/ai/skills/om-integration-builder/references/adapter-contracts.md +0 -762
  397. package/agentic/shared/ai/skills/om-module-scaffold/references/naming-conventions.md +0 -50
  398. package/agentic/shared/ai/skills/om-module-scaffold/references/navigation-patterns.md +0 -97
  399. package/agentic/shared/ai/skills/om-system-extension/references/extension-contracts.md +0 -271
  400. package/agentic/shared/ai/skills/om-troubleshooter/references/diagnostic-commands.md +0 -101
  401. package/dist/agentic/guides/cache.md +0 -45
  402. package/dist/agentic/guides/core.md +0 -453
  403. package/dist/agentic/guides/events.md +0 -117
  404. package/dist/agentic/guides/queue.md +0 -53
  405. package/dist/agentic/guides/search.md +0 -115
  406. package/dist/agentic/guides/shared.md +0 -108
  407. package/dist/agentic/guides/ui.md +0 -347
  408. package/dist/agentic/shared/ai/skills/om-auto-continue-pr-loop/SKILL.md +0 -27
  409. package/dist/agentic/shared/ai/skills/om-auto-create-pr-loop/SKILL.md +0 -27
  410. package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/ui-components.md +0 -260
  411. package/dist/agentic/shared/ai/skills/om-data-model-design/references/mikro-orm-cheatsheet.md +0 -146
  412. package/dist/agentic/shared/ai/skills/om-help/references/skills-catalog.md +0 -84
  413. package/dist/agentic/shared/ai/skills/om-help/references/workflow-sequences.md +0 -193
  414. package/dist/agentic/shared/ai/skills/om-integration-builder/STANDALONE.md +0 -34
  415. package/dist/agentic/shared/ai/skills/om-integration-builder/references/adapter-contracts.md +0 -762
  416. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/naming-conventions.md +0 -50
  417. package/dist/agentic/shared/ai/skills/om-module-scaffold/references/navigation-patterns.md +0 -97
  418. package/dist/agentic/shared/ai/skills/om-system-extension/references/extension-contracts.md +0 -271
  419. package/dist/agentic/shared/ai/skills/om-troubleshooter/references/diagnostic-commands.md +0 -101
@@ -1,130 +1,15 @@
1
- # Open Mercato Module System — Conceptual Guide
1
+ # Module System Compatibility Router
2
2
 
3
- 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.
3
+ Use the concern guides below. This path remains only so older prompts and links do not load a stale module tutorial.
4
4
 
5
- ## How the guides are layered
6
-
7
- - **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.
8
- - **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.
9
- - **Package guides (`.ai/guides/core.md`, `ui.md`, `shared.md`, …):** package-specific depth (patterns, helpers, deeper APIs).
10
-
11
- 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.
12
-
13
- ## Module anatomy
14
-
15
- 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.
16
-
17
- ```
18
- src/modules/<id>/
19
- ├── index.ts # Module metadata
20
- ├── data/
21
- │ ├── entities.ts # MikroORM entity classes (decorators from @mikro-orm/decorators/legacy)
22
- │ ├── validators.ts # Zod validation schemas
23
- │ ├── extensions.ts # Cross-module entity links (export `extensions`)
24
- │ └── enrichers.ts # Response enrichers (export `enrichers`)
25
- ├── api/
26
- │ ├── <resource>/route.ts # REST handlers (auto-discovered by method) + `metadata` + `openApi`
27
- │ └── interceptors.ts # API route interception hooks (export `interceptors`)
28
- ├── backend/ # Admin UI pages (auto-discovered) + paired `page.meta.ts`
29
- ├── frontend/ # Public pages (auto-discovered); customer portal under `[orgSlug]/portal/`
30
- ├── subscribers/ # Event handlers (export `metadata` + default handler)
31
- ├── workers/ # Background jobs (export `metadata` + default handler)
32
- ├── widgets/
33
- │ ├── injection/ # UI widgets injected into other modules
34
- │ ├── injection-table.ts # Widget-to-slot mappings
35
- │ └── components.ts # Component replacement/wrapper definitions (export `componentOverrides`)
36
- ├── di.ts # Awilix DI registrations (export `register(container)`)
37
- ├── acl.ts # Permission features (export `features`)
38
- ├── setup.ts # Tenant init, role features, seed data (export `setup`)
39
- ├── events.ts # Typed event declarations (export `eventsConfig`)
40
- ├── search.ts # Search indexing configuration (export `searchConfig`)
41
- ├── ce.ts # Custom entities / custom field sets (export `entities`)
42
- ├── translations.ts # Translatable fields per entity
43
- ├── notifications.ts # Notification type definitions (export `notificationTypes`)
44
- └── encryption.ts # Tenant data encryption maps for sensitive / GDPR fields
45
- ```
46
-
47
- ### Auto-discovery paths
48
-
49
- | Path pattern | Becomes |
50
- |---|---|
51
- | `frontend/<path>.tsx` | `/<path>` (public page) |
52
- | `frontend/[orgSlug]/portal/<path>/page.tsx` | `/{orgSlug}/portal/<path>` (customer portal page; `[orgSlug]` MUST be first) |
53
- | `backend/<path>.tsx` | `/backend/<path>` (admin page) |
54
- | `backend/page.tsx` | `/backend/<module>` (module root page) |
55
- | `api/<method>/<path>.ts` | `/api/<path>` dispatched by HTTP method |
56
- | `subscribers/*.ts` | event subscriber (export `metadata` + default handler) |
57
- | `workers/*.ts` | background worker (export `metadata` + default handler) |
58
-
59
- ### Convention-file reference
60
-
61
- | File | Export | Purpose |
62
- |------|--------|---------|
63
- | `index.ts` | `metadata` | Module metadata |
64
- | `di.ts` | `register(container)` | DI registrations (Awilix) |
65
- | `acl.ts` | `features` | Permission features (`['mod.view', 'mod.manage', …]`) |
66
- | `setup.ts` | `setup` | Tenant init, default role features, seed data |
67
- | `ce.ts` | `entities` | Custom entities / custom field sets |
68
- | `events.ts` | `eventsConfig` | Typed event declarations (`createModuleEvents`) |
69
- | `search.ts` | `searchConfig` | Search indexing config |
70
- | `translations.ts` | `translatableFields` | Translatable fields per entity |
71
- | `notifications.ts` | `notificationTypes` | Notification type definitions |
72
- | `data/entities.ts` | — | MikroORM entity classes |
73
- | `data/validators.ts` | — | Zod validation schemas |
74
- | `data/extensions.ts` | `extensions` | Entity extensions (cross-module links) |
75
- | `data/enrichers.ts` | `enrichers` | Response enrichers |
76
- | `api/interceptors.ts` | `interceptors` | API route interception hooks |
77
- | `widgets/components.ts` | `componentOverrides` | Component replacement/wrapper definitions |
78
-
79
- ## Naming conventions
80
-
81
- - **Module IDs:** plural, snake_case (`order_items`). Special cases: `auth`, `example`.
82
- - **Event IDs:** `module.entity.action` (singular entity, past-tense action, e.g. `sales.order.created`).
83
- - **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.
84
- - **DB tables:** plural, snake_case with a module prefix (`catalog_products`).
85
- - **DB columns:** snake_case (`created_at`, `organization_id`). Common columns: `id`, `created_at`, `updated_at`, `deleted_at`, `is_active`, `organization_id`, `tenant_id`.
86
- - **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.
87
- - **JS/TS identifiers:** camelCase. UUID primary keys, explicit foreign keys, junction tables for M2M.
88
-
89
- ## Mandatory module mechanisms
90
-
91
- 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.
92
-
93
- | Concern | Canonical mechanism |
5
+ | When you need | Load |
94
6
  |---|---|
95
- | 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` |
96
- | 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 |
97
- | 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`) |
98
- | CRUD forms | `<CrudForm />` from `@open-mercato/ui/backend/CrudForm` + `createCrud`/`updateCrud`/`deleteCrud`. Never raw `<form>`, never raw `fetch` |
99
- | Data tables | `<DataTable entityId apiPath … />` from `@open-mercato/ui/backend/DataTable`. Keep `entityId` / `extensionTableId` stable so widget injection keeps working |
100
- | HTTP from the client | `apiCall` / `apiCallOrThrow` from `@open-mercato/ui/backend/utils/apiCall` — never raw `fetch` |
101
- | 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 |
102
- | 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` |
103
- | Encryption for sensitive data | Declare `encryption.ts` `defaultEncryptionMaps`; read via `findWithDecryption` / `findOneWithDecryption`. NEVER hand-roll AES/KMS, NEVER `em.find` on encrypted columns |
104
- | Cache | Resolve from DI (`container.resolve('cache')`) — never `new Redis(...)`. Tag with `tenant:<id>` / `org:<id>` so invalidation stays tenant-scoped |
105
- | Background workers | `workers/*.ts` exporting `metadata: { queue, id?, concurrency? }` + default handler. Never spin up custom queues |
106
- | Events between modules | `events.ts` with `createModuleEvents({ moduleId, events } as const)`; subscribe in `subscribers/`. Never call another module's services directly across boundaries |
107
- | 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 |
108
- | i18n | `useT()` client-side, `resolveTranslations()` server-side; keys in `src/i18n/<locale>.json`. Never hard-code user-facing strings |
109
-
110
- > 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.
111
-
112
- ## Entity-update safety & data integrity
113
-
114
- - **`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`.
115
- - **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.
116
- - **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.
117
- - **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.
118
-
119
- ## Generate & migration workflow
120
-
121
- - **After editing `src/modules.ts` or any structural module file:** run `yarn generate`. Never hand-edit anything under `.mercato/generated/*`.
122
- - **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.
123
- - **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.
124
- - **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.
125
-
126
- ## Where to go next
127
-
128
- - A specific module's surface (entities, events, routes, auth, search, CLI): its **fact-sheet** at `.ai/guides/modules/<module>.md`.
129
- - Deeper package patterns: the matching **package guide** (`core.md`, `ui.md`, `shared.md`, `events.md`, `queue.md`, `cache.md`, `search.md`).
130
- - Scaffolding a module end-to-end: the `om-module-scaffold` skill.
7
+ | Module ownership, layout, discovery, registration, or installed source | `.ai/guides/architecture.md` |
8
+ | Entities, CRUD/API, commands, scoping, ACL, setup, events, workers, search, cache, or migrations | `.ai/guides/contracts.md` |
9
+ | Forms, tables, pages, navigation, portal, translations, or design-system behavior | `.ai/guides/backend-ui.md` |
10
+ | Enrichers, interceptors, guards, widgets, extensions, menus, replacements, or overrides | `.ai/guides/extensions.md` |
11
+ | Provider packages, data sync, webhooks, import/export, shipping, payment, or email | `.ai/guides/integrations.md` |
12
+ | AI agents/tools/orchestrators or workflows | `.ai/guides/ai-workflows.md` |
13
+ | Diagnosis and regression verification | `.ai/guides/testing-debugging.md` |
14
+
15
+ 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.
@@ -1,44 +1,75 @@
1
1
  # ai_assistant — module facts (generated, do not edit)
2
- <!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
2
+ <!-- generated from @open-mercato/ai-assistant 0.6.8-develop.6874.1.982d6097d8; core 0.6.8-develop.6874.1.982d6097d8 — R1 staleness stamp -->
3
+ Source root: [node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant](../../../node_modules/@open-mercato/ai-assistant/src/modules/ai_assistant)
3
4
 
4
5
  ## Entities
5
6
 
6
- | Entity ID | Class | Table | Editable | CustomFields |
7
+ | Entity ID | Class | Table | Editable | CustomFields | Source |
8
+ |---|---|---|---|---|---|
9
+ | 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) |
10
+ | 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) |
11
+ | 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) |
12
+ | 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) |
13
+ | 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) |
14
+ | 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) |
15
+ | 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) |
16
+ | 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) |
17
+ | 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) |
18
+ | 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) |
19
+ | 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) |
20
+
21
+ ## Events (7)
22
+
23
+ | ID | Category | Entity | Browser transport | Source |
7
24
  |---|---|---|---|---|
8
- | ai_assistant:ai_agent_prompt_override | AiAgentPromptOverride | ai_agent_prompt_overrides | yes | no |
9
- | ai_assistant:ai_pending_action | AiPendingAction | ai_pending_actions | no | no |
10
- | ai_assistant:ai_agent_runtime_override | AiAgentRuntimeOverride | ai_agent_runtime_overrides | yes | no |
11
- | ai_assistant:ai_token_usage_event | AiTokenUsageEvent | ai_token_usage_events | yes | no |
12
- | ai_assistant:ai_token_usage_daily | AiTokenUsageDaily | ai_token_usage_daily | yes | no |
13
- | ai_assistant:ai_tenant_model_allowlist | AiTenantModelAllowlist | ai_tenant_model_allowlists | yes | no |
14
- | ai_assistant:ai_agent_mutation_policy_override | AiAgentMutationPolicyOverride | ai_agent_mutation_policy_overrides | yes | no |
15
- | ai_assistant:ai_chat_conversation | AiChatConversation | ai_chat_conversations | yes | no |
16
- | ai_assistant:ai_chat_conversation_participant | AiChatConversationParticipant | ai_chat_conversation_participants | yes | no |
17
- | ai_assistant:ai_chat_message | AiChatMessage | ai_chat_messages | yes | no |
18
-
19
- ## Events (6)
20
-
21
- | ID | Category | Entity |
22
- |---|---|---|
23
- | ai.action.confirmed | — | ai_pending_action |
24
- | ai.action.cancelled | — | ai_pending_action |
25
- | ai.action.expired | — | ai_pending_action |
26
- | ai.token_usage.recorded | — | token_usage |
27
- | ai_assistant.conversation.shared | — | ai_chat_conversation |
28
- | ai_assistant.conversation.unshared | — | ai_chat_conversation |
25
+ | 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) |
26
+ | 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) |
27
+ | 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) |
28
+ | 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) |
29
+ | 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) |
30
+ | 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) |
31
+ | 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) |
29
32
 
30
33
  ## ACL features (8)
31
34
 
32
- 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
35
+ | Feature | Source |
36
+ |---|---|
37
+ | 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) |
38
+ | 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) |
39
+ | 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) |
40
+ | 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) |
41
+ | 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) |
42
+ | 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) |
43
+ | 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) |
44
+ | 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) |
33
45
 
34
46
  ## API routes
35
47
 
36
48
  _none_
37
49
 
38
- ## DI service tokens
50
+ ## Backend pages
51
+
52
+ | ID / path | Source |
53
+ |---|---|
54
+ | /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) |
55
+ | /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) |
56
+ | /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) |
57
+ | /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) |
58
+ | /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) |
59
+ | /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) |
60
+ | /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) |
61
+ | /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) |
62
+
63
+ ## Frontend pages
39
64
 
40
65
  _none_
41
66
 
67
+ ## DI service tokens
68
+
69
+ | Token | Source |
70
+ |---|---|
71
+ | 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) |
72
+
42
73
  ## Search entities
43
74
 
44
75
  _none_
@@ -48,10 +79,178 @@ _none_
48
79
  - Entity IDs: _none_
49
80
  - Table IDs: _none_
50
81
 
82
+ ## UMES hosts
83
+
84
+ | ID / pattern | Family | Supports | Context | Stability | Source |
85
+ |---|---|---|---|---|---|
86
+ | 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 |
87
+ | 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 |
88
+ | 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 |
89
+ | ai_assistant:ai_chat_conversation | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_chat_conversation |
90
+ | 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 |
91
+ | ai_assistant:ai_chat_message | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_chat_message |
92
+ | ai_assistant:ai_moderation_flag | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_moderation_flag |
93
+ | ai_assistant:ai_pending_action | entity | response-enricher, query-enricher, mutation-guard, entity-extension | tenant-and-organization | STABLE | entities:ai_assistant:ai_pending_action |
94
+ | 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 |
95
+ | 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 |
96
+ | 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 |
97
+ | ai_assistant.conversation.shared | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:ai_assistant.conversation.shared |
98
+ | ai_assistant.conversation.unshared | event | async-subscriber, sync-subscriber, browser-client | tenant-organization-and-audience | STABLE | events:ai_assistant.conversation.unshared |
99
+ | ai_assistant.moderation_flag.created | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai_assistant.moderation_flag.created |
100
+ | ai.action.cancelled | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.action.cancelled |
101
+ | ai.action.confirmed | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.action.confirmed |
102
+ | ai.action.expired | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.action.expired |
103
+ | ai.token_usage.recorded | event | async-subscriber, sync-subscriber | tenant-organization-and-audience | STABLE | events:ai.token_usage.recorded |
104
+
105
+ ## UMES contributions
106
+
107
+ | ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
108
+ |---|---|---|---|---|---|---|
109
+ | 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) |
110
+ | 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) |
111
+ | 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) |
112
+ | 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) |
113
+ | 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) |
114
+ | 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) |
115
+ | 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) |
116
+ | 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) |
117
+ | 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) |
118
+ | 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) |
119
+ | 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) |
120
+ | 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) |
121
+
122
+ ## Active extension bindings
123
+
124
+ _none_
125
+
126
+ ## Incoming installed contributions
127
+
128
+ _none_
129
+
130
+ ## Contribution resolutions
131
+
132
+ | Contribution | Target | Resolution | Activations | Source |
133
+ |---|---|---|---|---|
134
+ | 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) |
135
+ | 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) |
136
+ | 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) |
137
+ | 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) |
138
+ | 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) |
139
+ | 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) |
140
+ | 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) |
141
+ | 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) |
142
+ | 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) |
143
+ | 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) |
144
+ | 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) |
145
+ | 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) |
146
+
147
+
148
+
51
149
  ## Notifications
52
150
 
53
- ai_assistant.conversation_shared
151
+ | Notification ID | Source |
152
+ |---|---|
153
+ | 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) |
154
+
155
+ ## CLI commands
156
+
157
+ | ID / path | Source |
158
+ |---|---|
159
+ | 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) |
160
+ | 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) |
161
+ | 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) |
162
+ | 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) |
163
+ | 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) |
164
+ | 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) |
165
+ | 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) |
166
+ | 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) |
167
+ | 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) |
168
+
169
+ ## AI tools / MCP capabilities
170
+
171
+ | ID / path | Source |
172
+ |---|---|
173
+ | 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) |
174
+ | 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) |
175
+ | 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) |
176
+ | 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) |
177
+ | 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) |
178
+ | 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) |
179
+ | 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) |
180
+ | 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) |
181
+
182
+ ## AI agents
183
+
184
+ _none_
185
+
186
+ ## Exact override targets
187
+
188
+ | Domain | Path / key | Supported modes | Referenced fact | Source |
189
+ |---|---|---|---|---|
190
+ | 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) |
191
+ | 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) |
192
+ | 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) |
193
+ | 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) |
194
+ | 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) |
195
+ | 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) |
196
+ | 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) |
197
+ | 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) |
198
+ | 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) |
199
+ | 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) |
200
+ | 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) |
201
+ | 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) |
202
+ | 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) |
203
+ | 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) |
204
+ | 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) |
205
+ | 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) |
206
+ | 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) |
207
+ | 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) |
208
+ | 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) |
209
+ | 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) |
210
+ | 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) |
211
+ | 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) |
212
+ | 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) |
213
+ | 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) |
214
+ | 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) |
215
+ | 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) |
216
+ | 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) |
217
+ | 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) |
218
+ | 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) |
219
+ | 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) |
220
+ | 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) |
221
+ | 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) |
222
+ | 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) |
223
+ | 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) |
224
+ | 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) |
225
+ | 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) |
226
+ | 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) |
227
+ | 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) |
228
+ | 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) |
229
+ | 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) |
230
+ | 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) |
231
+
232
+ ## Owned contract — module metadata
233
+
234
+ | ID | Metadata | Source |
235
+ |---|---|---|
236
+ | 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) |
237
+
238
+ ## Workers
239
+
240
+ | ID | Metadata | Source |
241
+ |---|---|---|
242
+ | 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) |
243
+ | 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) |
244
+
245
+ ## Setup
246
+
247
+ | ID | Metadata | Source |
248
+ |---|---|---|
249
+ | 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) |
54
250
 
55
- ## CLI
251
+ ## DI registrations (rich)
56
252
 
57
- 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
253
+ | Token | Kind | Lifetime | Injection | Provider | Source |
254
+ |---|---|---|---|---|---|
255
+ | 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) |
256
+ | 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) |
@@ -1,5 +1,6 @@
1
1
  # api_docs — module facts (generated, do not edit)
2
- <!-- generated from @open-mercato/core 0.6.7 — R1 staleness stamp -->
2
+ <!-- generated from @open-mercato/core 0.6.8-develop.6874.1.982d6097d8; core 0.6.8-develop.6874.1.982d6097d8 — R1 staleness stamp -->
3
+ Source root: [node_modules/@open-mercato/core/src/modules/api_docs](../../../node_modules/@open-mercato/core/src/modules/api_docs)
3
4
 
4
5
  ## Entities
5
6
 
@@ -17,6 +18,18 @@ _none_
17
18
 
18
19
  _none_
19
20
 
21
+ ## Backend pages
22
+
23
+ | ID / path | Source |
24
+ |---|---|
25
+ | /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) |
26
+
27
+ ## Frontend pages
28
+
29
+ | ID / path | Source |
30
+ |---|---|
31
+ | /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) |
32
+
20
33
  ## DI service tokens
21
34
 
22
35
  _none_
@@ -30,10 +43,53 @@ _none_
30
43
  - Entity IDs: _none_
31
44
  - Table IDs: _none_
32
45
 
46
+ ## UMES hosts
47
+
48
+ _none_
49
+
50
+ ## UMES contributions
51
+
52
+ _none_
53
+
54
+ ## Active extension bindings
55
+
56
+ _none_
57
+
58
+ ## Incoming installed contributions
59
+
60
+ _none_
61
+
62
+ ## Contribution resolutions
63
+
64
+ _none_
65
+
66
+
67
+
33
68
  ## Notifications
34
69
 
35
70
  _none_
36
71
 
37
- ## CLI
72
+ ## CLI commands
73
+
74
+ _none_
75
+
76
+ ## AI tools / MCP capabilities
38
77
 
39
78
  _none_
79
+
80
+ ## AI agents
81
+
82
+ _none_
83
+
84
+ ## Exact override targets
85
+
86
+ | Domain | Path / key | Supported modes | Referenced fact | Source |
87
+ |---|---|---|---|---|
88
+ | 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) |
89
+ | 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) |
90
+
91
+ ## Owned contract — module metadata
92
+
93
+ | ID | Metadata | Source |
94
+ |---|---|---|
95
+ | 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) |