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
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@
5
5
  import { createInterface } from "node:readline";
6
6
  import { spawnSync as spawnSync2 } from "node:child_process";
7
7
  import { basename as basename2, dirname as dirname6, join as join8, resolve } from "node:path";
8
- import { existsSync as existsSync7, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync2, writeFileSync as writeFileSync8, copyFileSync as copyFileSync5 } from "node:fs";
8
+ import { existsSync as existsSync7, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync3, writeFileSync as writeFileSync8, copyFileSync as copyFileSync5 } from "node:fs";
9
9
  import { fileURLToPath as fileURLToPath6 } from "node:url";
10
10
  import pc from "picocolors";
11
11
 
@@ -448,24 +448,27 @@ import { existsSync as existsSync6, readFileSync as readFileSync6, writeFileSync
448
448
  import { basename, join as join7 } from "node:path";
449
449
 
450
450
  // src/setup/tools/shared.ts
451
- import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3, copyFileSync, readdirSync as readdirSync2 } from "node:fs";
452
- import { join as join3, dirname as dirname2 } from "node:path";
451
+ import { chmodSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3, copyFileSync, readdirSync as readdirSync2, renameSync, rmSync as rmSync3, statSync as statSync2 } from "node:fs";
452
+ import { createHash } from "node:crypto";
453
+ import { join as join3, dirname as dirname2, relative as relative2 } from "node:path";
453
454
  import { fileURLToPath as fileURLToPath2 } from "node:url";
454
455
  import { Project, SyntaxKind } from "ts-morph";
455
456
  var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
456
- var AGENTIC_DIR = join3(__dirname2, "agentic", "shared");
457
- var GUIDES_DIR = join3(__dirname2, "agentic", "guides");
457
+ var bundledAgenticRoot = join3(__dirname2, "agentic");
458
+ var AGENTIC_ROOT = existsSync2(bundledAgenticRoot) ? bundledAgenticRoot : join3(__dirname2, "..", "..", "..", "agentic");
459
+ var AGENTIC_DIR = join3(AGENTIC_ROOT, "shared");
460
+ var GUIDES_DIR = join3(AGENTIC_ROOT, "guides");
458
461
  function resolvePlaceholders(content, config) {
459
462
  return content.replace(/\{\{PROJECT_NAME\}\}/g, config.projectName);
460
463
  }
461
- function readEnabledModuleIds(modulesPath) {
462
- if (!existsSync2(modulesPath)) return [];
464
+ function tryReadEnabledModuleIds(modulesPath) {
465
+ if (!existsSync2(modulesPath)) return { parsed: false, ids: [] };
463
466
  try {
464
467
  const project = new Project({ useInMemoryFileSystem: true });
465
468
  const sourceFile = project.createSourceFile("modules.ts", readFileSync2(modulesPath, "utf-8"));
466
469
  const declaration = sourceFile.getVariableDeclaration("enabledModules");
467
470
  const arrayLiteral = declaration?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression);
468
- if (!arrayLiteral) return [];
471
+ if (!arrayLiteral) return { parsed: false, ids: [] };
469
472
  const ids = [];
470
473
  for (const element of arrayLiteral.getElements()) {
471
474
  const objectLiteral = element.asKind(SyntaxKind.ObjectLiteralExpression);
@@ -474,44 +477,33 @@ function readEnabledModuleIds(modulesPath) {
474
477
  const idValue = idProperty?.getInitializerIfKind(SyntaxKind.StringLiteral)?.getLiteralValue();
475
478
  if (idValue) ids.push(idValue);
476
479
  }
477
- return ids;
480
+ return { parsed: true, ids };
478
481
  } catch {
479
- return [];
482
+ return { parsed: false, ids: [] };
480
483
  }
481
484
  }
482
485
  function selectModuleFactSheets(targetDir, modulesSubdir) {
483
486
  const available = existsSync2(modulesSubdir) ? readdirSync2(modulesSubdir).filter((file) => file.endsWith(".md")).map((file) => file.replace(/\.md$/, "")) : [];
484
487
  if (available.length === 0) return [];
485
- const enabled = new Set(readEnabledModuleIds(join3(targetDir, "src", "modules.ts")));
488
+ const parsed = tryReadEnabledModuleIds(join3(targetDir, "src", "modules.ts"));
489
+ if (!parsed.parsed) return available;
490
+ const enabled = new Set(parsed.ids);
486
491
  const selected = available.filter((moduleId) => enabled.has(moduleId));
487
- return selected.length > 0 ? selected : available;
492
+ return selected;
488
493
  }
489
494
  var MODULE_GUIDES_START = "<!-- om:module-guides:start -->";
490
495
  var MODULE_GUIDES_END = "<!-- om:module-guides:end -->";
491
- function readModuleGuideLabels(guidesDir) {
492
- const factsPath = join3(guidesDir, "module-facts.json");
493
- if (!existsSync2(factsPath)) return {};
494
- try {
495
- const parsed = JSON.parse(readFileSync2(factsPath, "utf-8"));
496
- const labels = {};
497
- for (const [moduleId, entry] of Object.entries(parsed)) {
498
- const label = entry && typeof entry.description === "string" && entry.description || entry && typeof entry.title === "string" && entry.title || "";
499
- if (label) labels[moduleId] = label;
500
- }
501
- return labels;
502
- } catch {
503
- return {};
504
- }
505
- }
506
- function renderModuleGuidesBlock(selected, labels) {
496
+ var STANDALONE_ROOT_TARGET_BYTES = 12 * 1024;
497
+ function renderModuleGuidesBlock(selected, options = {}) {
507
498
  if (selected.length === 0) return "_No module fact-sheets are bundled for this app._";
508
- const rows = selected.map((moduleId) => {
509
- const label = labels[moduleId] ?? `Use the ${moduleId} module`;
510
- return `| ${label} | \`.ai/guides/modules/${moduleId}.md\` |`;
511
- });
512
- return ["| Task | Load |", "|---|---|", ...rows].join("\n");
513
- }
514
- function injectModuleGuides(agentsMdPath, selected, labels = {}) {
499
+ const index = options.compact ? `Enabled module facts: ${selected.length} sheets bundled, too many to index inline \u2014 list the module facts directory to see which modules have one.` : `Enabled module facts: ${selected.map((moduleId) => `\`${moduleId}\``).join(",")}.`;
500
+ return [
501
+ index,
502
+ "",
503
+ "Load `.ai/guides/modules/<id>.md` only for a named or targeted installed module/host; never preload all module facts."
504
+ ].join("\n");
505
+ }
506
+ function injectModuleGuides(agentsMdPath, selected, options = {}) {
515
507
  if (!existsSync2(agentsMdPath)) return;
516
508
  const content = readFileSync2(agentsMdPath, "utf-8");
517
509
  const startIndex = content.indexOf(MODULE_GUIDES_START);
@@ -525,10 +517,16 @@ function injectModuleGuides(agentsMdPath, selected, labels = {}) {
525
517
  const before = content.slice(0, startIndex + MODULE_GUIDES_START.length);
526
518
  const after = content.slice(endIndex);
527
519
  const next = `${before}
528
- ${renderModuleGuidesBlock(selected, labels)}
520
+ ${renderModuleGuidesBlock(selected, options)}
529
521
  ${after}`;
530
522
  if (next !== content) writeFileSync3(agentsMdPath, next);
531
523
  }
524
+ function enforceRootInstructionBudget(agentsMdPath, selected, maxBytes = STANDALONE_ROOT_TARGET_BYTES) {
525
+ if (!existsSync2(agentsMdPath)) return false;
526
+ if (Buffer.byteLength(readFileSync2(agentsMdPath)) <= maxBytes) return false;
527
+ injectModuleGuides(agentsMdPath, selected, { compact: true });
528
+ return true;
529
+ }
532
530
  function ensureDir(filePath) {
533
531
  const dir = dirname2(filePath);
534
532
  if (!existsSync2(dir)) {
@@ -541,129 +539,118 @@ function writeTemplate(srcRelative, destPath, config) {
541
539
  ensureDir(destPath);
542
540
  writeFileSync3(destPath, resolvePlaceholders(content, config));
543
541
  }
544
- function copyFile(srcRelative, destPath) {
545
- const srcPath = join3(AGENTIC_DIR, srcRelative);
546
- ensureDir(destPath);
547
- copyFileSync(srcPath, destPath);
542
+ var TEXT_EXTENSIONS = /* @__PURE__ */ new Set([".cjs", ".json", ".md", ".mdc", ".mjs", ".sh", ".ts", ".txt"]);
543
+ function isTextAsset(path) {
544
+ const dot = path.lastIndexOf(".");
545
+ return dot === -1 || TEXT_EXTENSIONS.has(path.slice(dot));
546
+ }
547
+ function listFiles(root) {
548
+ if (!existsSync2(root)) return [];
549
+ const files = [];
550
+ for (const entry of readdirSync2(root, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
551
+ const absolute = join3(root, entry.name);
552
+ if (entry.isDirectory()) {
553
+ files.push(...listFiles(absolute));
554
+ } else if (entry.isFile()) {
555
+ files.push(absolute);
556
+ }
557
+ }
558
+ return files;
548
559
  }
549
- function generateShared(config) {
560
+ function copyTree(sourceRoot, destinationRoot, config) {
561
+ for (const sourcePath of listFiles(sourceRoot)) {
562
+ const destinationPath = join3(destinationRoot, relative2(sourceRoot, sourcePath));
563
+ ensureDir(destinationPath);
564
+ if (isTextAsset(sourcePath)) {
565
+ writeFileSync3(destinationPath, resolvePlaceholders(readFileSync2(sourcePath, "utf8"), config));
566
+ } else {
567
+ copyFileSync(sourcePath, destinationPath);
568
+ }
569
+ if (process.platform !== "win32") chmodSync(destinationPath, statSync2(sourcePath).mode & 511);
570
+ }
571
+ }
572
+ function targetPathsForTree(sourceRoot, destinationRoot) {
573
+ return listFiles(sourceRoot).map((sourcePath) => join3(destinationRoot, relative2(sourceRoot, sourcePath)));
574
+ }
575
+ function hashFile(path) {
576
+ return createHash("sha256").update(readFileSync2(path)).digest("hex");
577
+ }
578
+ function harnessGeneratorId() {
579
+ try {
580
+ const upstream = JSON.parse(readFileSync2(join3(GUIDES_DIR, "upstream", "manifest.json"), "utf8"));
581
+ const generator = typeof upstream.generator === "string" ? upstream.generator : "";
582
+ const version = generator.slice(generator.lastIndexOf("@") + 1);
583
+ if (version && version !== generator) return `open-mercato-agentic@${version}`;
584
+ } catch {
585
+ }
586
+ return "open-mercato-agentic@unknown";
587
+ }
588
+ function externalSkillNames(targetDir) {
589
+ try {
590
+ const tiers = JSON.parse(readFileSync2(join3(targetDir, ".ai", "skills", "tiers.json"), "utf8"));
591
+ return new Set(Array.isArray(tiers.external?.skills) ? tiers.external.skills.filter((name) => typeof name === "string") : []);
592
+ } catch {
593
+ return /* @__PURE__ */ new Set();
594
+ }
595
+ }
596
+ function finalizeHarnessManifest(config, selectedTools) {
550
597
  const { targetDir } = config;
551
598
  const selectedModules = selectModuleFactSheets(targetDir, join3(GUIDES_DIR, "modules"));
552
- const moduleGuideLabels = readModuleGuideLabels(GUIDES_DIR);
553
- writeTemplate("AGENTS.md.template", join3(targetDir, "AGENTS.md"), config);
554
- injectModuleGuides(join3(targetDir, "AGENTS.md"), selectedModules, moduleGuideLabels);
555
- writeTemplate("ai/specs/README.md", join3(targetDir, ".ai", "specs", "README.md"), config);
556
- copyFile("ai/specs/SPEC-000-template.md", join3(targetDir, ".ai", "specs", "SPEC-000-template.md"));
557
- copyFile("ai/lessons.md", join3(targetDir, ".ai", "lessons.md"));
558
- copyFile("ai/skills/tiers.json", join3(targetDir, ".ai", "skills", "tiers.json"));
559
- copyFile("ai/skills/tiers.schema.json", join3(targetDir, ".ai", "skills", "tiers.schema.json"));
560
- copyFile("ai/agentic.config.json", join3(targetDir, ".ai", "agentic.config.json"));
561
- copyFile("ai/trackers/github.md", join3(targetDir, ".ai", "trackers", "github.md"));
562
- copyFile("scripts/install-skills.sh", join3(targetDir, "scripts", "install-skills.sh"));
563
- copyFile(
564
- "ai/skills/om-backend-ui-design/SKILL.md",
565
- join3(targetDir, ".ai", "skills", "om-backend-ui-design", "SKILL.md")
566
- );
567
- copyFile(
568
- "ai/skills/om-backend-ui-design/references/ui-components.md",
569
- join3(targetDir, ".ai", "skills", "om-backend-ui-design", "references", "ui-components.md")
570
- );
571
- copyFile(
572
- "ai/skills/om-integration-builder/SKILL.md",
573
- join3(targetDir, ".ai", "skills", "om-integration-builder", "SKILL.md")
574
- );
575
- copyFile(
576
- "ai/skills/om-integration-builder/references/adapter-contracts.md",
577
- join3(targetDir, ".ai", "skills", "om-integration-builder", "references", "adapter-contracts.md")
578
- );
579
- if (existsSync2(join3(AGENTIC_DIR, "ai", "skills", "om-integration-builder", "STANDALONE.md"))) {
580
- copyFile(
581
- "ai/skills/om-integration-builder/STANDALONE.md",
582
- join3(targetDir, ".ai", "skills", "om-integration-builder", "STANDALONE.md")
583
- );
584
- }
585
- copyFile(
586
- "ai/skills/om-system-extension/SKILL.md",
587
- join3(targetDir, ".ai", "skills", "om-system-extension", "SKILL.md")
588
- );
589
- copyFile(
590
- "ai/skills/om-system-extension/references/extension-contracts.md",
591
- join3(targetDir, ".ai", "skills", "om-system-extension", "references", "extension-contracts.md")
592
- );
593
- copyFile(
594
- "ai/skills/om-module-scaffold/SKILL.md",
595
- join3(targetDir, ".ai", "skills", "om-module-scaffold", "SKILL.md")
596
- );
597
- copyFile(
598
- "ai/skills/om-module-scaffold/references/naming-conventions.md",
599
- join3(targetDir, ".ai", "skills", "om-module-scaffold", "references", "naming-conventions.md")
600
- );
601
- copyFile(
602
- "ai/skills/om-module-scaffold/references/navigation-patterns.md",
603
- join3(targetDir, ".ai", "skills", "om-module-scaffold", "references", "navigation-patterns.md")
604
- );
605
- copyFile(
606
- "ai/skills/om-troubleshooter/SKILL.md",
607
- join3(targetDir, ".ai", "skills", "om-troubleshooter", "SKILL.md")
608
- );
609
- copyFile(
610
- "ai/skills/om-troubleshooter/references/diagnostic-commands.md",
611
- join3(targetDir, ".ai", "skills", "om-troubleshooter", "references", "diagnostic-commands.md")
612
- );
613
- copyFile(
614
- "ai/skills/om-eject-and-customize/SKILL.md",
615
- join3(targetDir, ".ai", "skills", "om-eject-and-customize", "SKILL.md")
616
- );
617
- copyFile(
618
- "ai/skills/om-data-model-design/SKILL.md",
619
- join3(targetDir, ".ai", "skills", "om-data-model-design", "SKILL.md")
620
- );
621
- copyFile(
622
- "ai/skills/om-data-model-design/references/mikro-orm-cheatsheet.md",
623
- join3(targetDir, ".ai", "skills", "om-data-model-design", "references", "mikro-orm-cheatsheet.md")
624
- );
625
- copyFile(
626
- "ai/skills/om-implement-spec/SKILL.md",
627
- join3(targetDir, ".ai", "skills", "om-implement-spec", "SKILL.md")
628
- );
629
- copyFile(
630
- "ai/skills/om-help/SKILL.md",
631
- join3(targetDir, ".ai", "skills", "om-help", "SKILL.md")
632
- );
633
- copyFile(
634
- "ai/skills/om-help/references/skills-catalog.md",
635
- join3(targetDir, ".ai", "skills", "om-help", "references", "skills-catalog.md")
636
- );
637
- copyFile(
638
- "ai/skills/om-help/references/workflow-sequences.md",
639
- join3(targetDir, ".ai", "skills", "om-help", "references", "workflow-sequences.md")
640
- );
641
- copyFile(
642
- "ai/skills/om-auto-upgrade-0.4.10-to-0.5.0/SKILL.md",
643
- join3(targetDir, ".ai", "skills", "om-auto-upgrade-0.4.10-to-0.5.0", "SKILL.md")
644
- );
645
- for (const autoSkill of [
646
- "om-auto-create-pr",
647
- "om-auto-continue-pr",
648
- "om-auto-create-pr-loop",
649
- "om-auto-continue-pr-loop",
650
- "om-auto-review-pr",
651
- "om-auto-fix-issue",
652
- "om-prepare-test-env"
653
- ]) {
654
- if (!existsSync2(join3(AGENTIC_DIR, "ai", "skills", autoSkill, "SKILL.md"))) {
655
- continue;
599
+ const paths = /* @__PURE__ */ new Set([
600
+ join3(targetDir, "AGENTS.md"),
601
+ ...targetPathsForTree(join3(AGENTIC_DIR, "ai"), join3(targetDir, ".ai")),
602
+ ...targetPathsForTree(join3(AGENTIC_DIR, "scripts"), join3(targetDir, "scripts"))
603
+ ]);
604
+ for (const file of readdirSync2(GUIDES_DIR)) {
605
+ if (file.endsWith(".md") || file === "module-facts.json") paths.add(join3(targetDir, ".ai", "guides", file));
606
+ }
607
+ for (const file of listFiles(join3(GUIDES_DIR, "upstream"))) {
608
+ paths.add(join3(targetDir, ".ai", "guides", "upstream", relative2(join3(GUIDES_DIR, "upstream"), file)));
609
+ }
610
+ for (const moduleId of selectedModules) paths.add(join3(targetDir, ".ai", "guides", "modules", `${moduleId}.md`));
611
+ if (selectedTools.includes("claude-code")) {
612
+ paths.add(join3(targetDir, "CLAUDE.md"));
613
+ paths.add(join3(targetDir, ".claude", "settings.json"));
614
+ paths.add(join3(targetDir, ".claude", "hooks", "entity-migration-check.ts"));
615
+ paths.add(join3(targetDir, ".mcp.json.example"));
616
+ }
617
+ if (selectedTools.includes("codex")) paths.add(join3(targetDir, ".codex", "mcp.json.example"));
618
+ if (selectedTools.includes("cursor")) {
619
+ for (const file of listFiles(join3(AGENTIC_ROOT, "cursor"))) {
620
+ const rel = relative2(join3(AGENTIC_ROOT, "cursor"), file);
621
+ const mapped = rel === "mcp.json.example" ? join3(targetDir, ".cursor", "mcp.json.example") : join3(targetDir, ".cursor", rel);
622
+ paths.add(mapped);
656
623
  }
657
- copyFile(
658
- `ai/skills/${autoSkill}/SKILL.md`,
659
- join3(targetDir, ".ai", "skills", autoSkill, "SKILL.md")
660
- );
661
624
  }
662
- copyFile(
663
- "ai/skills/om-trim-unused-modules/SKILL.md",
664
- join3(targetDir, ".ai", "skills", "om-trim-unused-modules", "SKILL.md")
665
- );
666
- copyFile("ai/qa/tests/playwright.config.ts", join3(targetDir, ".ai", "qa", "tests", "playwright.config.ts"));
625
+ const manifestPath = join3(targetDir, ".ai", "harness", "manifest.json");
626
+ const externalSkills = externalSkillNames(targetDir);
627
+ paths.delete(manifestPath);
628
+ const files = [...paths].filter((path) => existsSync2(path)).sort((left, right) => left.localeCompare(right)).map((path) => {
629
+ const relativePath = relative2(targetDir, path).replace(/\\/g, "/");
630
+ const skillName = relativePath.match(/^\.ai\/skills\/([^/]+)\//)?.[1];
631
+ return {
632
+ path: relativePath,
633
+ sha256: hashFile(path),
634
+ source: skillName ? externalSkills.has(skillName) ? "external-override" : "local-skill" : "generated",
635
+ userEditable: relativePath === "AGENTS.md" || relativePath === ".ai/agentic.config.json" || relativePath === ".ai/lessons.md" || relativePath.startsWith(".ai/lessons/")
636
+ };
637
+ });
638
+ ensureDir(manifestPath);
639
+ const temporaryManifestPath = `${manifestPath}.tmp-${process.pid}-${Date.now()}`;
640
+ try {
641
+ writeFileSync3(temporaryManifestPath, `${JSON.stringify({ version: 1, generator: harnessGeneratorId(), files }, null, 2)}
642
+ `);
643
+ renameSync(temporaryManifestPath, manifestPath);
644
+ } finally {
645
+ rmSync3(temporaryManifestPath, { force: true });
646
+ }
647
+ }
648
+ function generateShared(config) {
649
+ const { targetDir } = config;
650
+ const selectedModules = selectModuleFactSheets(targetDir, join3(GUIDES_DIR, "modules"));
651
+ writeTemplate("AGENTS.md.template", join3(targetDir, "AGENTS.md"), config);
652
+ copyTree(join3(AGENTIC_DIR, "ai"), join3(targetDir, ".ai"), config);
653
+ copyTree(join3(AGENTIC_DIR, "scripts"), join3(targetDir, "scripts"), config);
667
654
  if (existsSync2(GUIDES_DIR)) {
668
655
  const guidesDestDir = join3(targetDir, ".ai", "guides");
669
656
  for (const file of readdirSync2(GUIDES_DIR)) {
@@ -679,6 +666,7 @@ function generateShared(config) {
679
666
  ensureDir(destPath);
680
667
  copyFileSync(moduleFactsPath, destPath);
681
668
  }
669
+ copyTree(join3(GUIDES_DIR, "upstream"), join3(guidesDestDir, "upstream"), config);
682
670
  const modulesSubdir = join3(GUIDES_DIR, "modules");
683
671
  for (const moduleId of selectedModules) {
684
672
  const destPath = join3(guidesDestDir, "modules", `${moduleId}.md`);
@@ -686,10 +674,16 @@ function generateShared(config) {
686
674
  copyFileSync(join3(modulesSubdir, `${moduleId}.md`), destPath);
687
675
  }
688
676
  }
677
+ injectModuleGuides(join3(targetDir, "AGENTS.md"), selectedModules);
678
+ }
679
+ function enforceGeneratedRootBudget(config, maxBytes = STANDALONE_ROOT_TARGET_BYTES) {
680
+ const { targetDir } = config;
681
+ const selectedModules = selectModuleFactSheets(targetDir, join3(GUIDES_DIR, "modules"));
682
+ return enforceRootInstructionBudget(join3(targetDir, "AGENTS.md"), selectedModules, maxBytes);
689
683
  }
690
684
 
691
685
  // src/setup/tools/claude-code.ts
692
- import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync4, copyFileSync as copyFileSync2, symlinkSync, lstatSync, unlinkSync } from "node:fs";
686
+ import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync4, copyFileSync as copyFileSync2 } from "node:fs";
693
687
  import { join as join4, dirname as dirname3 } from "node:path";
694
688
  import { fileURLToPath as fileURLToPath3 } from "node:url";
695
689
  var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
@@ -709,7 +703,7 @@ function writeTemplate2(srcRelative, destPath, config) {
709
703
  ensureDir2(destPath);
710
704
  writeFileSync4(destPath, resolvePlaceholders2(content, config));
711
705
  }
712
- function copyFile2(srcRelative, destPath) {
706
+ function copyFile(srcRelative, destPath) {
713
707
  const srcPath = join4(AGENTIC_DIR2, srcRelative);
714
708
  ensureDir2(destPath);
715
709
  copyFileSync2(srcPath, destPath);
@@ -717,20 +711,9 @@ function copyFile2(srcRelative, destPath) {
717
711
  function generateClaudeCode(config) {
718
712
  const { targetDir } = config;
719
713
  writeTemplate2("CLAUDE.md.template", join4(targetDir, "CLAUDE.md"), config);
720
- copyFile2("settings.json", join4(targetDir, ".claude", "settings.json"));
721
- copyFile2("hooks/entity-migration-check.ts", join4(targetDir, ".claude", "hooks", "entity-migration-check.ts"));
722
- copyFile2("mcp.json.example", join4(targetDir, ".mcp.json.example"));
723
- ensureSkillsLink(join4(targetDir, ".claude", "skills"), join4("..", ".ai", "skills"));
724
- }
725
- function ensureSkillsLink(linkPath, target) {
726
- ensureDir2(linkPath);
727
- if (existsSync3(linkPath) && !lstatSync(linkPath).isSymbolicLink()) {
728
- return;
729
- }
730
- if (lstatSync(linkPath, { throwIfNoEntry: false })?.isSymbolicLink()) {
731
- unlinkSync(linkPath);
732
- }
733
- symlinkSync(target, linkPath);
714
+ copyFile("settings.json", join4(targetDir, ".claude", "settings.json"));
715
+ copyFile("hooks/entity-migration-check.ts", join4(targetDir, ".claude", "hooks", "entity-migration-check.ts"));
716
+ copyFile("mcp.json.example", join4(targetDir, ".mcp.json.example"));
734
717
  }
735
718
 
736
719
  // src/setup/tools/codex.ts
@@ -738,7 +721,9 @@ import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as rea
738
721
  import { join as join5, dirname as dirname4 } from "node:path";
739
722
  import { fileURLToPath as fileURLToPath4 } from "node:url";
740
723
  var __dirname4 = dirname4(fileURLToPath4(import.meta.url));
741
- var AGENTIC_DIR3 = join5(__dirname4, "agentic", "codex");
724
+ var bundledAgenticRoot2 = join5(__dirname4, "agentic");
725
+ var AGENTIC_ROOT2 = existsSync4(bundledAgenticRoot2) ? bundledAgenticRoot2 : join5(__dirname4, "..", "..", "..", "agentic");
726
+ var AGENTIC_DIR3 = join5(AGENTIC_ROOT2, "codex");
742
727
  var MARKER_START = "<!-- CODEX_ENFORCEMENT_RULES_START -->";
743
728
  var MARKER_END = "<!-- CODEX_ENFORCEMENT_RULES_END -->";
744
729
  function ensureDir3(filePath) {
@@ -747,7 +732,7 @@ function ensureDir3(filePath) {
747
732
  mkdirSync4(dir, { recursive: true });
748
733
  }
749
734
  }
750
- function copyFile3(srcRelative, destPath) {
735
+ function copyFile2(srcRelative, destPath) {
751
736
  const srcPath = join5(AGENTIC_DIR3, srcRelative);
752
737
  ensureDir3(destPath);
753
738
  copyFileSync3(srcPath, destPath);
@@ -775,7 +760,7 @@ function generateCodex(config) {
775
760
  }
776
761
  writeFileSync5(agentsPath, agents);
777
762
  }
778
- copyFile3("mcp.json.example", join5(targetDir, ".codex", "mcp.json.example"));
763
+ copyFile2("mcp.json.example", join5(targetDir, ".codex", "mcp.json.example"));
779
764
  }
780
765
 
781
766
  // src/setup/tools/cursor.ts
@@ -799,7 +784,7 @@ function writeTemplate3(srcRelative, destPath, config) {
799
784
  ensureDir4(destPath);
800
785
  writeFileSync6(destPath, resolvePlaceholders3(content, config));
801
786
  }
802
- function copyFile4(srcRelative, destPath) {
787
+ function copyFile3(srcRelative, destPath) {
803
788
  const srcPath = join6(AGENTIC_DIR4, srcRelative);
804
789
  ensureDir4(destPath);
805
790
  copyFileSync4(srcPath, destPath);
@@ -807,11 +792,11 @@ function copyFile4(srcRelative, destPath) {
807
792
  function generateCursor(config) {
808
793
  const { targetDir } = config;
809
794
  writeTemplate3("rules/open-mercato.mdc", join6(targetDir, ".cursor", "rules", "open-mercato.mdc"), config);
810
- copyFile4("rules/entity-guard.mdc", join6(targetDir, ".cursor", "rules", "entity-guard.mdc"));
811
- copyFile4("rules/generated-guard.mdc", join6(targetDir, ".cursor", "rules", "generated-guard.mdc"));
812
- copyFile4("hooks.json", join6(targetDir, ".cursor", "hooks.json"));
813
- copyFile4("hooks/entity-migration-check.mjs", join6(targetDir, ".cursor", "hooks", "entity-migration-check.mjs"));
814
- copyFile4("mcp.json.example", join6(targetDir, ".cursor", "mcp.json.example"));
795
+ copyFile3("rules/entity-guard.mdc", join6(targetDir, ".cursor", "rules", "entity-guard.mdc"));
796
+ copyFile3("rules/generated-guard.mdc", join6(targetDir, ".cursor", "rules", "generated-guard.mdc"));
797
+ copyFile3("hooks.json", join6(targetDir, ".cursor", "hooks.json"));
798
+ copyFile3("hooks/entity-migration-check.mjs", join6(targetDir, ".cursor", "hooks", "entity-migration-check.mjs"));
799
+ copyFile3("mcp.json.example", join6(targetDir, ".cursor", "mcp.json.example"));
815
800
  }
816
801
 
817
802
  // src/setup/wizard.ts
@@ -862,7 +847,7 @@ async function promptSelection(ask) {
862
847
  console.log(` ${tool.key}. ${tool.label}`);
863
848
  }
864
849
  console.log("");
865
- if (!process.stdin.isTTY || !process.stdout.isTTY) {
850
+ if (!process.stdin.isTTY) {
866
851
  console.log(` Non-interactive shell; using the default (${DEFAULT_TOOL_ID}).`);
867
852
  console.log(" Pass --agents <list|all|none> to choose explicitly.");
868
853
  console.log("");
@@ -911,7 +896,9 @@ async function runAgenticSetup(targetDir, ask, options) {
911
896
  if (selectedIds.includes("claude-code")) generateClaudeCode(config);
912
897
  if (selectedIds.includes("codex")) generateCodex(config);
913
898
  if (selectedIds.includes("cursor")) generateCursor(config);
899
+ enforceGeneratedRootBudget(config);
914
900
  persistAgentSelection(targetDir, selectedIds);
901
+ finalizeHarnessManifest(config, selectedIds);
915
902
  installSkills(targetDir);
916
903
  printSummary(selectedIds);
917
904
  return true;
@@ -930,11 +917,11 @@ function persistAgentSelection(targetDir, selectedIds) {
930
917
  `);
931
918
  }
932
919
  function installSkills(targetDir) {
933
- const installScript = join7(targetDir, "scripts", "install-skills.sh");
920
+ const installScript = join7(targetDir, "scripts", "install-skills.mjs");
934
921
  if (!existsSync6(installScript)) return;
935
922
  console.log("");
936
923
  console.log(" Installing agent skills (local tiers + external open-mercato/skills subset)...");
937
- const result = spawnSync("sh", [installScript], { cwd: targetDir, stdio: "inherit" });
924
+ const result = spawnSync(process.execPath, [installScript], { cwd: targetDir, stdio: "inherit" });
938
925
  if (result.error || result.status !== 0) {
939
926
  console.log(" \u26A0 Skill installation did not complete; run `yarn install-skills` inside the app when online.");
940
927
  }
@@ -964,7 +951,9 @@ function printSummary(selectedIds) {
964
951
  console.log(" The external open-mercato/skills subset installs automatically");
965
952
  console.log(" (including chain steps like om-prepare-test-env and the autofix");
966
953
  console.log(" chain om-verify-in-repo \u2192 om-root-cause \u2192 om-fix \u2192 om-open-pr);");
967
- console.log(" re-run anytime with `yarn install-skills`. The local override");
954
+ console.log(" setup pins the current shared commit; refresh later with");
955
+ console.log(" `yarn install-skills --update` or reinstall the pin with");
956
+ console.log(" `yarn install-skills`. The local override");
968
957
  console.log(" SKILL.md files adjust them for your app (base-branch discovery,");
969
958
  console.log(" opt-in pipeline labels, script probing).");
970
959
  }
@@ -1232,6 +1221,7 @@ function buildRegistryConfig(registryUrl) {
1232
1221
  configLines.push("npmScopes:");
1233
1222
  configLines.push(" open-mercato:");
1234
1223
  configLines.push(` npmRegistryServer: "${registryUrl}"`);
1224
+ configLines.push(" npmMinimalAgeGate: 0");
1235
1225
  return configLines.join("\n");
1236
1226
  }
1237
1227
  var FILE_RENAMES = {
@@ -1248,7 +1238,7 @@ function copyDirRecursive(src, dest, placeholders) {
1248
1238
  const srcPath = join8(src, entry);
1249
1239
  const destName = FILE_RENAMES[entry] ?? entry;
1250
1240
  let destPath = join8(dest, destName);
1251
- const stat = statSync2(srcPath);
1241
+ const stat = statSync3(srcPath);
1252
1242
  if (stat.isDirectory()) {
1253
1243
  if (SKIP_DIRS.has(entry)) continue;
1254
1244
  copyDirRecursive(srcPath, destPath, placeholders);
@@ -1457,6 +1447,7 @@ if (isEntrypoint) {
1457
1447
  });
1458
1448
  }
1459
1449
  export {
1450
+ buildRegistryConfig,
1460
1451
  main,
1461
1452
  normalizePresetAnswer
1462
1453
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-mercato-app",
3
- "version": "0.6.7",
3
+ "version": "0.6.8-develop.6874.1.982d6097d8",
4
4
  "type": "module",
5
5
  "description": "Create a new Open Mercato application",
6
6
  "main": "./dist/index.js",
@@ -18,16 +18,17 @@
18
18
  },
19
19
  "dependencies": {
20
20
  "picocolors": "^1.1.0",
21
- "tar": "^7.5.20",
21
+ "tar": "^7.5.22",
22
22
  "ts-morph": "^28.0.0"
23
23
  },
24
24
  "devDependencies": {
25
- "@open-mercato/cli": "0.6.7",
26
- "@open-mercato/shared": "0.6.7",
27
- "@types/node": "^26.0.1",
25
+ "@open-mercato/cli": "0.6.8-develop.6874.1.982d6097d8",
26
+ "@open-mercato/shared": "0.6.8-develop.6874.1.982d6097d8",
27
+ "@types/node": "^26.1.2",
28
28
  "esbuild": "^0.28.1",
29
29
  "tsx": "^4.23.1",
30
- "typescript": "7.0.2"
30
+ "typescript": "7.0.2",
31
+ "typescript-standalone": "npm:typescript@6.0.3"
31
32
  },
32
33
  "publishConfig": {
33
34
  "access": "public"
@@ -44,5 +45,6 @@
44
45
  "scaffolding",
45
46
  "cli"
46
47
  ],
47
- "license": "MIT"
48
+ "license": "MIT",
49
+ "stableVersion": "0.6.7"
48
50
  }