create-mercato-app 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7195.1.b5efd1d51a

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 (199) hide show
  1. package/agentic/github-copilot/copilot-instructions.md.template +37 -0
  2. package/agentic/github-copilot/instructions/entity-guard.instructions.md +27 -0
  3. package/agentic/github-copilot/instructions/generated-guard.instructions.md +10 -0
  4. package/agentic/github-copilot/mcp.json.example +13 -0
  5. package/agentic/shared/ai/harness/design-system-inventory.json +118 -106
  6. package/agentic/shared/ai/harness/source-link-inventory.json +8 -8
  7. package/dist/agentic/github-copilot/copilot-instructions.md.template +37 -0
  8. package/dist/agentic/github-copilot/instructions/entity-guard.instructions.md +27 -0
  9. package/dist/agentic/github-copilot/instructions/generated-guard.instructions.md +10 -0
  10. package/dist/agentic/github-copilot/mcp.json.example +13 -0
  11. package/dist/agentic/guides/module-facts.json +11527 -283
  12. package/dist/agentic/guides/module-facts.v2.json +11527 -283
  13. package/dist/agentic/guides/modules/agent_orchestrator/acl-features.md +31 -0
  14. package/dist/agentic/guides/modules/agent_orchestrator/active-extension-bindings.md +12 -0
  15. package/dist/agentic/guides/modules/agent_orchestrator/ai-agents.md +12 -0
  16. package/dist/agentic/guides/modules/agent_orchestrator/ai-tools-mcp-capabilities.md +13 -0
  17. package/dist/agentic/guides/modules/agent_orchestrator/backend-pages.md +28 -0
  18. package/dist/agentic/guides/modules/agent_orchestrator/cli-commands.md +14 -0
  19. package/dist/agentic/guides/modules/agent_orchestrator/contribution-resolutions.md +49 -0
  20. package/dist/agentic/guides/modules/agent_orchestrator/di-registrations-rich.md +42 -0
  21. package/dist/agentic/guides/modules/agent_orchestrator/di-service-tokens.md +24 -0
  22. package/dist/agentic/guides/modules/agent_orchestrator/domain-commands.md +28 -0
  23. package/dist/agentic/guides/modules/agent_orchestrator/encryption.md +20 -0
  24. package/dist/agentic/guides/modules/agent_orchestrator/entities.md +31 -0
  25. package/dist/agentic/guides/modules/agent_orchestrator/events.md +38 -0
  26. package/dist/agentic/guides/modules/agent_orchestrator/exact-override-targets.md +122 -0
  27. package/dist/agentic/guides/modules/agent_orchestrator/host-extension-points.md +10 -0
  28. package/dist/agentic/guides/modules/agent_orchestrator/index.md +31 -0
  29. package/dist/agentic/guides/modules/agent_orchestrator/owned-contract-module-metadata.md +11 -0
  30. package/dist/agentic/guides/modules/agent_orchestrator/setup.md +11 -0
  31. package/dist/agentic/guides/modules/agent_orchestrator/umes-contributions.md +49 -0
  32. package/dist/agentic/guides/modules/agent_orchestrator/umes-hosts.md +61 -0
  33. package/dist/agentic/guides/modules/agent_orchestrator/workers.md +14 -0
  34. package/dist/agentic/guides/modules/ai_assistant/di-registrations-rich.md +3 -2
  35. package/dist/agentic/guides/modules/ai_assistant/di-service-tokens.md +2 -1
  36. package/dist/agentic/guides/modules/ai_assistant/exact-override-targets.md +3 -2
  37. package/dist/agentic/guides/modules/ai_assistant/index.md +1 -1
  38. package/dist/agentic/guides/modules/api_docs/index.md +1 -1
  39. package/dist/agentic/guides/modules/api_keys/index.md +1 -1
  40. package/dist/agentic/guides/modules/attachments/index.md +1 -1
  41. package/dist/agentic/guides/modules/audit_logs/index.md +1 -1
  42. package/dist/agentic/guides/modules/auth/index.md +1 -1
  43. package/dist/agentic/guides/modules/business_rules/index.md +1 -1
  44. package/dist/agentic/guides/modules/catalog/index.md +1 -1
  45. package/dist/agentic/guides/modules/channel_apns/index.md +1 -1
  46. package/dist/agentic/guides/modules/channel_discord/index.md +1 -1
  47. package/dist/agentic/guides/modules/channel_expo/index.md +1 -1
  48. package/dist/agentic/guides/modules/channel_fcm/index.md +1 -1
  49. package/dist/agentic/guides/modules/channel_gmail/index.md +1 -1
  50. package/dist/agentic/guides/modules/channel_imap/index.md +1 -1
  51. package/dist/agentic/guides/modules/channel_resend/index.md +1 -1
  52. package/dist/agentic/guides/modules/channel_ses/index.md +1 -1
  53. package/dist/agentic/guides/modules/checkout/index.md +1 -1
  54. package/dist/agentic/guides/modules/communication_channels/index.md +1 -1
  55. package/dist/agentic/guides/modules/configs/index.md +1 -1
  56. package/dist/agentic/guides/modules/content/index.md +1 -1
  57. package/dist/agentic/guides/modules/currencies/index.md +1 -1
  58. package/dist/agentic/guides/modules/customer_accounts/cli-commands.md +11 -0
  59. package/dist/agentic/guides/modules/customer_accounts/exact-override-targets.md +5 -4
  60. package/dist/agentic/guides/modules/customer_accounts/index.md +3 -2
  61. package/dist/agentic/guides/modules/customer_accounts/setup.md +1 -1
  62. package/dist/agentic/guides/modules/customers/contribution-resolutions.md +1 -0
  63. package/dist/agentic/guides/modules/customers/exact-override-targets.md +1 -0
  64. package/dist/agentic/guides/modules/customers/incoming-installed-contributions.md +3 -0
  65. package/dist/agentic/guides/modules/customers/index.md +2 -2
  66. package/dist/agentic/guides/modules/customers/umes-contributions.md +1 -0
  67. package/dist/agentic/guides/modules/dashboards/index.md +1 -1
  68. package/dist/agentic/guides/modules/data_sync/index.md +1 -1
  69. package/dist/agentic/guides/modules/design_system/index.md +1 -1
  70. package/dist/agentic/guides/modules/devices/index.md +1 -1
  71. package/dist/agentic/guides/modules/dictionaries/index.md +1 -1
  72. package/dist/agentic/guides/modules/directory/index.md +1 -1
  73. package/dist/agentic/guides/modules/documents/index.md +1 -1
  74. package/dist/agentic/guides/modules/entities/index.md +1 -1
  75. package/dist/agentic/guides/modules/eudr/index.md +1 -1
  76. package/dist/agentic/guides/modules/events/index.md +1 -1
  77. package/dist/agentic/guides/modules/feature_toggles/index.md +1 -1
  78. package/dist/agentic/guides/modules/gateway_stripe/index.md +1 -1
  79. package/dist/agentic/guides/modules/generators/index.md +1 -1
  80. package/dist/agentic/guides/modules/inbox_ops/index.md +1 -1
  81. package/dist/agentic/guides/modules/integrations/index.md +1 -1
  82. package/dist/agentic/guides/modules/messages/index.md +1 -1
  83. package/dist/agentic/guides/modules/notifications/index.md +1 -1
  84. package/dist/agentic/guides/modules/onboarding/index.md +1 -1
  85. package/dist/agentic/guides/modules/payment_gateways/index.md +1 -1
  86. package/dist/agentic/guides/modules/perspectives/index.md +1 -1
  87. package/dist/agentic/guides/modules/phone_calls/index.md +1 -1
  88. package/dist/agentic/guides/modules/planner/index.md +1 -1
  89. package/dist/agentic/guides/modules/portal/index.md +1 -1
  90. package/dist/agentic/guides/modules/progress/index.md +1 -1
  91. package/dist/agentic/guides/modules/push_notifications/index.md +1 -1
  92. package/dist/agentic/guides/modules/query_index/index.md +1 -1
  93. package/dist/agentic/guides/modules/record_locks/index.md +1 -1
  94. package/dist/agentic/guides/modules/resources/index.md +1 -1
  95. package/dist/agentic/guides/modules/sales/index.md +1 -1
  96. package/dist/agentic/guides/modules/scheduler/index.md +1 -1
  97. package/dist/agentic/guides/modules/search/index.md +1 -1
  98. package/dist/agentic/guides/modules/security/index.md +1 -1
  99. package/dist/agentic/guides/modules/seeds/cli-commands.md +14 -0
  100. package/dist/agentic/guides/modules/seeds/exact-override-targets.md +14 -0
  101. package/dist/agentic/guides/modules/seeds/index.md +14 -0
  102. package/dist/agentic/guides/modules/seeds/owned-contract-module-metadata.md +11 -0
  103. package/dist/agentic/guides/modules/shipping_carriers/index.md +1 -1
  104. package/dist/agentic/guides/modules/sso/index.md +1 -1
  105. package/dist/agentic/guides/modules/staff/index.md +1 -1
  106. package/dist/agentic/guides/modules/storage_s3/index.md +1 -1
  107. package/dist/agentic/guides/modules/sync_akeneo/index.md +1 -1
  108. package/dist/agentic/guides/modules/sync_excel/index.md +1 -1
  109. package/dist/agentic/guides/modules/system_status_overlays/index.md +1 -1
  110. package/dist/agentic/guides/modules/tillio/index.md +1 -1
  111. package/dist/agentic/guides/modules/translations/index.md +1 -1
  112. package/dist/agentic/guides/modules/warranty_claims/index.md +1 -1
  113. package/dist/agentic/guides/modules/webhooks/index.md +1 -1
  114. package/dist/agentic/guides/modules/wms/index.md +1 -1
  115. package/dist/agentic/guides/modules/workflows/acl-features.md +11 -1
  116. package/dist/agentic/guides/modules/workflows/active-extension-bindings.md +4 -1
  117. package/dist/agentic/guides/modules/workflows/ai-tools-mcp-capabilities.md +17 -0
  118. package/dist/agentic/guides/modules/workflows/backend-pages.md +3 -0
  119. package/dist/agentic/guides/modules/workflows/contribution-resolutions.md +24 -0
  120. package/dist/agentic/guides/modules/workflows/di-registrations-rich.md +11 -7
  121. package/dist/agentic/guides/modules/workflows/di-service-tokens.md +11 -7
  122. package/dist/agentic/guides/modules/workflows/domain-commands.md +11 -0
  123. package/dist/agentic/guides/modules/workflows/entities.md +2 -0
  124. package/dist/agentic/guides/modules/workflows/events.md +14 -8
  125. package/dist/agentic/guides/modules/workflows/exact-override-targets.md +45 -10
  126. package/dist/agentic/guides/modules/workflows/frontend-pages.md +2 -0
  127. package/dist/agentic/guides/modules/workflows/incoming-installed-contributions.md +17 -0
  128. package/dist/agentic/guides/modules/workflows/index.md +15 -12
  129. package/dist/agentic/guides/modules/workflows/notifications.md +2 -0
  130. package/dist/agentic/guides/modules/workflows/setup.md +1 -1
  131. package/dist/agentic/guides/modules/workflows/umes-contributions.md +24 -0
  132. package/dist/agentic/guides/modules/workflows/umes-hosts.md +14 -6
  133. package/dist/agentic/guides/modules/workflows/workers.md +4 -1
  134. package/dist/agentic/guides/reference-module-facts.json +2 -2
  135. package/dist/agentic/guides/reference-modules/example/index.md +1 -1
  136. package/dist/agentic/guides/upstream/AGENTS.md +3 -1
  137. package/dist/agentic/guides/upstream/manifest.json +2 -2
  138. package/dist/agentic/shared/ai/harness/design-system-inventory.json +118 -106
  139. package/dist/agentic/shared/ai/harness/source-link-inventory.json +8 -8
  140. package/dist/index.js +88 -37
  141. package/package.json +3 -3
  142. package/template/package.json.template +11 -10
  143. package/template/scripts/dev-mcp.mjs +91 -0
  144. package/template/scripts/dev-runtime.mjs +5 -3
  145. package/template/scripts/dev-spawn-utils.mjs +33 -0
  146. package/template/scripts/dev.mjs +317 -16
  147. package/template/scripts/mercato-cli.mjs +32 -0
  148. package/template/src/app/globals.css +36 -3
  149. package/template/src/components/DemoFeedbackWidget.tsx +55 -26
  150. package/template/src/components/__tests__/DemoFeedbackWidget.test.tsx +40 -0
  151. package/template/src/i18n/de.json +11 -0
  152. package/template/src/i18n/en.json +11 -0
  153. package/template/src/i18n/es.json +11 -0
  154. package/template/src/i18n/ko.json +11 -0
  155. package/template/src/i18n/pl.json +11 -0
  156. package/template/src/modules/agent_examples/README.md +134 -0
  157. package/template/src/modules/agent_examples/agents/company_researcher/AGENT.md +24 -0
  158. package/template/src/modules/agent_examples/agents/company_researcher/OUTCOME.md +55 -0
  159. package/template/src/modules/agent_examples/agents/company_researcher/SAMPLE.json +7 -0
  160. package/template/src/modules/agent_examples/agents/company_researcher/skills/deal_qualification/SKILL.md +38 -0
  161. package/template/src/modules/agent_examples/agents/company_researcher/skills/deal_qualification/TEMPLATE.md +9 -0
  162. package/template/src/modules/agent_examples/agents/company_researcher/skills/deal_qualification/examples/well-funded-scaleup.md +18 -0
  163. package/template/src/modules/agent_examples/agents/company_researcher/skills/deal_qualification/scripts/score.ts +36 -0
  164. package/template/src/modules/agent_examples/agents/company_researcher/sub-agents/revenue_estimator/AGENT.md +14 -0
  165. package/template/src/modules/agent_examples/agents/company_researcher/sub-agents/revenue_estimator/OUTCOME.md +33 -0
  166. package/template/src/modules/agent_examples/agents/company_researcher/sub-agents/revenue_estimator/SAMPLE.json +4 -0
  167. package/template/src/modules/agent_examples/agents/deal_web_researcher/AGENT.md +21 -0
  168. package/template/src/modules/agent_examples/agents/deal_web_researcher/OUTCOME.md +31 -0
  169. package/template/src/modules/agent_examples/agents/deal_web_researcher/SAMPLE.json +4 -0
  170. package/template/src/modules/agent_examples/agents/deals_health_check/AGENT.md +13 -0
  171. package/template/src/modules/agent_examples/agents/deals_health_check/OUTCOME.md +42 -0
  172. package/template/src/modules/agent_examples/agents/deals_health_check/SAMPLE.json +11 -0
  173. package/template/src/modules/agent_examples/agents/deals_health_check/skills/stage_playbook/SKILL.md +29 -0
  174. package/template/src/modules/agent_examples/agents/deals_health_check/skills/stage_playbook/TEMPLATE.md +4 -0
  175. package/template/src/modules/agent_examples/agents/deals_health_check/skills/stage_playbook/examples/advance-to-negotiation.md +10 -0
  176. package/template/src/modules/agent_examples/agents/deals_health_check/skills/stage_playbook/scripts/score.ts +20 -0
  177. package/template/src/modules/agent_examples/agents/deals_health_check/sub-agents/activity_scan/AGENT.md +11 -0
  178. package/template/src/modules/agent_examples/agents/deals_health_check/sub-agents/activity_scan/OUTCOME.md +20 -0
  179. package/template/src/modules/agent_examples/agents/deals_health_check/sub-agents/activity_scan/SAMPLE.json +15 -0
  180. package/template/src/modules/agent_examples/agents/support_resolution_advisor/AGENT.md +18 -0
  181. package/template/src/modules/agent_examples/agents/support_resolution_advisor/OUTCOME.md +46 -0
  182. package/template/src/modules/agent_examples/agents/support_resolution_advisor/SAMPLE.json +5 -0
  183. package/template/src/modules/agent_examples/agents/support_resolution_advisor/skills/resolution_playbook/SKILL.md +28 -0
  184. package/template/src/modules/agent_examples/agents/support_resolution_advisor/skills/resolution_playbook/TEMPLATE.md +5 -0
  185. package/template/src/modules/agent_examples/agents/support_resolution_advisor/skills/resolution_playbook/examples/escalate-vip.md +12 -0
  186. package/template/src/modules/agent_examples/agents/support_resolution_advisor/tools/lookup_ticket_history.ts +23 -0
  187. package/template/src/modules/agent_examples/ai-agents.ts +82 -0
  188. package/template/src/modules/agent_examples/data/validators.ts +46 -0
  189. package/template/src/modules/agent_examples/i18n/de.json +44 -0
  190. package/template/src/modules/agent_examples/i18n/en.json +44 -0
  191. package/template/src/modules/agent_examples/i18n/es.json +44 -0
  192. package/template/src/modules/agent_examples/i18n/ko.json +44 -0
  193. package/template/src/modules/agent_examples/i18n/pl.json +44 -0
  194. package/template/src/modules/agent_examples/index.ts +12 -0
  195. package/template/src/modules/agent_examples/widgets/injection/company-research-trigger/widget.client.tsx +574 -0
  196. package/template/src/modules/agent_examples/widgets/injection/company-research-trigger/widget.ts +32 -0
  197. package/template/src/modules/agent_examples/widgets/injection-table.ts +22 -0
  198. package/template/src/modules/example/references/surface-inventory.json +2 -0
  199. package/template/src/modules.ts +11 -0
@@ -0,0 +1,37 @@
1
+ # {{PROJECT_NAME}} — GitHub Copilot Instructions
2
+
3
+ These are repository-wide custom instructions for GitHub Copilot. Copilot applies
4
+ them to every chat and edit request in this workspace.
5
+
6
+ ## What this project is
7
+
8
+ A standalone Open Mercato application. Build domain features ON TOP of the framework.
9
+ To customise a core module beyond the extension system: `yarn mercato eject <module>`.
10
+ Never edit `node_modules/@open-mercato/*` directly.
11
+
12
+ ## Task routing
13
+
14
+ Read `AGENTS.md` before starting any task — it maps task types to the minimum files
15
+ to load. Path-scoped guidance lives in `.github/instructions/*.instructions.md`.
16
+
17
+ ## Module system
18
+
19
+ Modules in `src/modules/<id>/`. Register with `from: '@app'` in `src/modules.ts`.
20
+ Run `yarn generate` after any module or entity change. Never edit `.mercato/generated/*`.
21
+
22
+ ## CRITICAL rules — always follow without exception
23
+
24
+ 1. **After editing any entity file** (`src/modules/<id>/entities/*.ts`):
25
+ - STOP before any further action.
26
+ - Tell the user: "I modified an entity in module <id>. Should I create a migration?"
27
+ - If yes: run `yarn db:generate`.
28
+ - Show the generated migration to the user before applying.
29
+ - Ask for confirmation, then run `yarn db:migrate`.
30
+ - Run `yarn generate` after the migration is applied.
31
+
32
+ 2. **After editing `src/modules.ts`**: immediately run `yarn generate`.
33
+
34
+ 3. **Never edit `.mercato/generated/*`**: edit the source and run `yarn generate` instead.
35
+
36
+ 4. **Before significant features**: check `.ai/specs/` for an existing spec. If none
37
+ exists, ask the user whether to create one first.
@@ -0,0 +1,27 @@
1
+ ---
2
+ description: Entity modification guard — triggers migration workflow
3
+ applyTo: "src/modules/*/entities/**/*.ts"
4
+ ---
5
+
6
+ # Entity Modification — Migration Required
7
+
8
+ You are editing an entity file. After saving, you MUST:
9
+
10
+ 1. **Create a migration** — ask the user before running:
11
+ ```
12
+ yarn db:generate
13
+ ```
14
+
15
+ 2. **Show the migration** to the user and wait for confirmation before applying.
16
+
17
+ 3. **Apply the migration** (only after the user confirms):
18
+ ```
19
+ yarn db:migrate
20
+ ```
21
+
22
+ 4. **Regenerate registries**:
23
+ ```
24
+ yarn generate
25
+ ```
26
+
27
+ Do NOT skip any step. Do NOT run migrations without user confirmation.
@@ -0,0 +1,10 @@
1
+ ---
2
+ description: Prevent editing auto-generated files
3
+ applyTo: ".mercato/generated/**"
4
+ ---
5
+
6
+ # NEVER Edit Generated Files
7
+
8
+ These files are auto-generated by `yarn generate`. Any manual edits will be overwritten.
9
+
10
+ To change generated output, edit the source modules in `src/modules/` and run `yarn generate`.
@@ -0,0 +1,13 @@
1
+ {
2
+ "_comment": "Copy to .vscode/mcp.json and set MCP_API_KEY (printed by yarn initialize). VS Code Copilot uses the top-level \"servers\" key.",
3
+ "servers": {
4
+ "open-mercato": {
5
+ "command": "yarn",
6
+ "args": ["mercato", "mcp:dev"],
7
+ "env": {
8
+ "APP_URL": "http://localhost:3000",
9
+ "MCP_API_KEY": "${MCP_API_KEY}"
10
+ }
11
+ }
12
+ }
13
+ }