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
@@ -47,6 +47,13 @@ APP_URL=http://localhost:3000
47
47
  # Example: APP_ALLOWED_ORIGINS=https://admin.example.com,https://ops.example.com
48
48
  # APP_ALLOWED_ORIGINS=
49
49
 
50
+ # Base URL for customer-portal links embedded in outbound emails (invitations,
51
+ # magic links, password resets, notification digests). Falls back to
52
+ # http://localhost:3000 outside production; REQUIRED in production, where
53
+ # sending a portal email without it fails the request rather than mailing a
54
+ # localhost link to a real customer.
55
+ # PLATFORM_PORTAL_BASE_URL=https://portal.your-domain.com
56
+
50
57
  # Enable self-service onboarding (default: false)
51
58
  SELF_SERVICE_ONBOARDING_ENABLED=false
52
59
  # Enable Open Mercato demo widgets (default: false)
@@ -137,6 +144,13 @@ NEXT_PUBLIC_OM_EXAMPLE_CHECKOUT_TEST_INJECTIONS_ENABLED=false
137
144
  # Required for webhook verification in standalone integration and local test flows.
138
145
  # MOCK_CARRIER_WEBHOOK_SECRET=open-mercato-mock-dev-carrier-webhook-secret
139
146
 
147
+ # Default raw body limit for public webhook routes that use the global cap.
148
+ # Payment gateway handlers opt into their own limit per provider registration.
149
+ # InboxOps inherits this value when set; override only that source with
150
+ # INBOX_OPS_WEBHOOK_MAX_BODY_BYTES (its legacy fallback is 2 MiB).
151
+ OM_WEBHOOK_MAX_BODY_BYTES=1048576
152
+ # INBOX_OPS_WEBHOOK_MAX_BODY_BYTES=2097152
153
+
140
154
  # Checkout origin allowlist (optional, comma-separated)
141
155
  # Extra origins allowed to submit payments via the public pay-link endpoint.
142
156
  # By default, only the server's own origin (derived from the request URL,
@@ -197,8 +211,13 @@ QUERY_ENGINE_DEBUG_SQL=false
197
211
  # Enable cache for CRUD API responses (default: false)
198
212
  ENABLE_CRUD_API_CACHE=false
199
213
 
214
+ # Make query-index read-projection tail synchronous and loud on write (default: false)
215
+ OM_CACHE_SAFETY_ALWAYS_CONSISTENT=false
216
+
200
217
  # Auto-reindex query indexes when coverage gaps are detected (default: true)
201
218
  SCHEDULE_AUTO_REINDEX=true
219
+ # Collapse repeated auto-reindex scheduling for the same scope (default: 30000 ms; 0 disables)
220
+ OM_QUERY_INDEX_AUTO_REINDEX_DEBOUNCE_MS=30000
202
221
 
203
222
  # Skip immediate coverage recalculation on read (default: false)
204
223
  OPTIMIZE_INDEX_COVERAGE_STATS=false
@@ -212,8 +231,17 @@ OM_SEARCH_MIN_LEN=3
212
231
  OM_SEARCH_ENABLE_PARTIAL=true
213
232
  OM_SEARCH_HASH_ALGO=sha256
214
233
  OM_SEARCH_STORE_RAW_TOKENS=false
215
- # Optional comma-separated blocklist of field name substrings to skip during tokenization
216
- # OM_SEARCH_FIELD_BLOCKLIST=password,token,secret,hash
234
+ # Bound token fan-out per indexed record (0 disables an individual limit)
235
+ OM_SEARCH_MAX_FIELD_CHARS=20000
236
+ OM_SEARCH_MAX_TOKENS_PER_FIELD=5000
237
+ OM_SEARCH_MAX_TOKENS_PER_RECORD=20000
238
+ # Optional comma-separated blocklist of field name substrings to skip during tokenization.
239
+ # Applies to per-field tokens AND to the aggregate `search_text` field, so blocklisting a
240
+ # large free-text column genuinely keeps it out of the token index. password,token,secret,hash
241
+ # are always blocked. Prefix an entry with `entityType@` to scope it to one entity type.
242
+ # OM_SEARCH_FIELD_BLOCKLIST=body,customers:customer_interaction@notes
243
+ # TTL for the process-level "does this entity have search tokens?" probe cache (ms, 0 disables).
244
+ OM_SEARCH_TOKEN_PRESENCE_CACHE_MS=30000
217
245
 
218
246
  # Search module debug logging (Meilisearch, vector search, reindex operations)
219
247
  OM_SEARCH_DEBUG=false
@@ -718,3 +746,32 @@ ACME_EMAIL=
718
746
  # Activates only when NODE_ENV=test. Used by Playwright to drive arbitrary
719
747
  # Host values without DNS. Generate with: openssl rand -hex 32
720
748
  # FORCE_HOST_SECRET=
749
+
750
+ # --- Telemetry & Observability (vendor-neutral OTLP: traces, logs, metrics, errors) ---
751
+ # Off by default: leave TELEMETRY_BACKEND unset (or =noop) and the telemetry
752
+ # runtime is not imported. Set to 'console' for local span/metric output, or an
753
+ # OTLP backend to export: 'signoz' | 'newrelic' | 'otlp' (generic).
754
+ # All three OTLP names use the same exporter — they differ only by the endpoint +
755
+ # headers below. Any OTLP backend is a one-line swap; no code change.
756
+ # TELEMETRY_BACKEND=otlp
757
+ # Logs use the shared logger's OM_LOG_LEVEL / OM_LOG_PRETTY /
758
+ # OM_LOG_DESTINATION controls above. Telemetry only adds remote export.
759
+ # TELEMETRY_SAMPLING_RATIO=1.0 # 0.0–1.0 (default 1.0 dev / 0.1 prod)
760
+ # TELEMETRY_TRUST_INBOUND_TRACE=false # default false: root-per-request (ignore an
761
+ # # inbound traceparent from a proxy/LB). Set true
762
+ # # only behind a trusted upstream whose trace continues.
763
+ # # This also enables richer bullmq-otel spans;
764
+ # # otherwise async queues use metadata._trace.
765
+ #
766
+ # OTLP endpoint + auth — pick ONE vendor (use your region's host):
767
+ # SigNoz Cloud:
768
+ # OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.<region>.signoz.cloud:443
769
+ # OTEL_EXPORTER_OTLP_HEADERS=signoz-ingestion-key=<your-ingestion-key>
770
+ # New Relic (OTLP-native; EU host shown, US is https://otlp.nr-data.net):
771
+ # OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net
772
+ # OTEL_EXPORTER_OTLP_HEADERS=api-key=<your-ingest-license-key>
773
+ #
774
+ # Resource identity: keep one stable service name across environments and
775
+ # separate envs via the deployment.environment resource attribute.
776
+ # OTEL_SERVICE_NAME=open-mercato
777
+ # OTEL_RESOURCE_ATTRIBUTES=deployment.environment=local
@@ -1,2 +1,11 @@
1
1
  nodeLinker: node-modules
2
+
3
+ # Yarn refuses versions younger than `npmMinimalAgeGate` (default 1 day) with
4
+ # "All versions satisfying ... are quarantined". This app pins the exact
5
+ # @open-mercato release it was scaffolded from, which is usually minutes old, so
6
+ # the first-party scope opts out while every third-party package keeps the
7
+ # cooldown. A per-scope `npmRegistryServer` entry shadows a top-level
8
+ # `npmMinimalAgeGate: 0`, so the opt-out has to be expressed as a preapproval.
9
+ npmPreapprovedPackages:
10
+ - "@open-mercato/*"
2
11
  {{REGISTRY_CONFIG}}