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
@@ -0,0 +1,329 @@
1
+ import { spawnSync } from 'node:child_process'
2
+ import crypto from 'node:crypto'
3
+ import fs from 'node:fs'
4
+ import os from 'node:os'
5
+ import path from 'node:path'
6
+ import process from 'node:process'
7
+
8
+ function pathEntries(env = process.env) {
9
+ return String(env.PATH ?? '').split(path.delimiter).filter(Boolean)
10
+ }
11
+
12
+ function executableCandidate(command, env = process.env) {
13
+ if (path.isAbsolute(command)) return command
14
+ for (const directory of pathEntries(env)) {
15
+ const candidate = path.join(directory, command)
16
+ try {
17
+ const stat = fs.statSync(candidate)
18
+ if (stat.isFile()) return candidate
19
+ } catch { /* keep looking */ }
20
+ }
21
+ throw new Error(`sandbox executable is unavailable: ${command}`)
22
+ }
23
+
24
+ function resolveExecutable(command, env = process.env) {
25
+ return fs.realpathSync(executableCandidate(command, env))
26
+ }
27
+
28
+ function trustedBubblewrapExecutable(env = process.env) {
29
+ const executable = resolveExecutable('bwrap', env)
30
+ const stat = fs.lstatSync(executable)
31
+ if (!stat.isFile() || stat.isSymbolicLink() || stat.uid !== 0 || (stat.mode & 0o022) !== 0) {
32
+ throw new Error('Linux target isolation requires a root-owned, non-group/world-writable Bubblewrap executable')
33
+ }
34
+ return executable
35
+ }
36
+
37
+ function regularDirectory(root, label) {
38
+ if (!path.isAbsolute(root)) throw new Error(`${label} must be absolute`)
39
+ const stat = fs.lstatSync(root)
40
+ if (!stat.isDirectory() || stat.isSymbolicLink()) throw new Error(`${label} must be a regular directory`)
41
+ return fs.realpathSync(root)
42
+ }
43
+
44
+ // True when `parent` is `candidate` or one of its ancestors.
45
+ function containsPath(parent, candidate) {
46
+ const relative = path.relative(parent, candidate)
47
+ return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative))
48
+ }
49
+
50
+ function uniqueExistingDirectories(values) {
51
+ return [...new Set(values)].filter((entry) => {
52
+ try { return fs.statSync(entry).isDirectory() } catch { return false }
53
+ }).map((entry) => fs.realpathSync(entry))
54
+ }
55
+
56
+ export function collapseReadOnlyRoots(values) {
57
+ const roots = [...new Set(uniqueExistingDirectories(values))]
58
+ .sort((left, right) => left.split(path.sep).length - right.split(path.sep).length || left.localeCompare(right))
59
+ const result = []
60
+ for (const root of roots) {
61
+ const nested = result.some((parent) => {
62
+ const relative = path.relative(parent, root)
63
+ return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative))
64
+ })
65
+ if (!nested) result.push(root)
66
+ }
67
+ return result
68
+ }
69
+
70
+ export function linuxMergedUsrSymlinkArgs() {
71
+ const aliases = [
72
+ ['/bin', 'usr/bin'],
73
+ ['/sbin', 'usr/sbin'],
74
+ ['/lib', 'usr/lib'],
75
+ ['/lib64', 'usr/lib64'],
76
+ ]
77
+ return aliases.flatMap(([alias, expected]) => {
78
+ try {
79
+ const stat = fs.lstatSync(alias)
80
+ return stat.isSymbolicLink() && fs.readlinkSync(alias) === expected
81
+ ? ['--symlink', expected, alias]
82
+ : []
83
+ } catch { return [] }
84
+ })
85
+ }
86
+
87
+ function uniqueExistingRegularFiles(values) {
88
+ return [...new Set(values)].filter((entry) => {
89
+ try { return fs.statSync(entry).isFile() } catch { return false }
90
+ })
91
+ }
92
+
93
+ function runtimeReadRoots(command, env) {
94
+ const executablePath = executableCandidate(command, env)
95
+ const executable = fs.realpathSync(executablePath)
96
+ const nodeInstallRoot = path.dirname(path.dirname(fs.realpathSync(process.execPath)))
97
+ const nodeLauncher = (() => {
98
+ try {
99
+ const candidate = executableCandidate(process.platform === 'win32' ? 'node.exe' : 'node', env)
100
+ if (fs.realpathSync(candidate) === fs.realpathSync(process.execPath)) return path.dirname(candidate)
101
+ if (process.platform !== 'win32') {
102
+ const launcher = fs.lstatSync(candidate)
103
+ const launcherRoot = path.dirname(candidate)
104
+ const root = fs.lstatSync(launcherRoot)
105
+ const realTemporary = fs.realpathSync(os.tmpdir())
106
+ const realLauncherRoot = fs.realpathSync(launcherRoot)
107
+ const relative = path.relative(realTemporary, realLauncherRoot)
108
+ const insideTemporary = relative !== '' && !relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative)
109
+ const exactWrapper = `#!/bin/sh\nexec ${JSON.stringify(fs.realpathSync(process.execPath))} "$@"\n`
110
+ if (insideTemporary && /^xfs-[a-f0-9]+$/.test(path.basename(realLauncherRoot))
111
+ && root.isDirectory() && !root.isSymbolicLink()
112
+ && launcher.isFile() && !launcher.isSymbolicLink() && launcher.size <= 256 && (launcher.mode & 0o111) !== 0
113
+ && fs.readFileSync(candidate, 'utf8') === exactWrapper) return realLauncherRoot
114
+ }
115
+ return undefined
116
+ } catch { return undefined }
117
+ })()
118
+ const system = process.platform === 'darwin'
119
+ ? ['/System', '/usr', '/bin', '/sbin', '/Library/Apple', '/Library/Fonts', '/Library/ColorSync', '/Library/Keyboard Layouts', '/Library/Keychains', '/Library/Security/Trust Settings', '/private/var/db', '/private/etc/ssl', '/etc/ssl', '/dev']
120
+ : ['/usr', '/bin', '/sbin', '/lib', '/lib64', '/etc/ssl', '/etc/ca-certificates']
121
+ return collapseReadOnlyRoots([
122
+ ...system,
123
+ nodeInstallRoot,
124
+ path.dirname(executablePath),
125
+ path.dirname(executable),
126
+ ...(nodeLauncher ? [nodeLauncher] : []),
127
+ ])
128
+ }
129
+
130
+ function sandboxLiteral(value) {
131
+ return String(value).replaceAll('\\', '\\\\').replaceAll('"', '\\"')
132
+ }
133
+
134
+ export function assertSandboxNetworkModeSupported(networkMode, platform = process.platform) {
135
+ if (!['none', 'loopback', 'all'].includes(networkMode)) {
136
+ throw new Error(`invalid sandbox network mode: ${String(networkMode)}`)
137
+ }
138
+ if (platform === 'darwin' && networkMode === 'loopback') {
139
+ throw new Error('isolated loopback is unavailable with macOS sandbox-exec; run this lane in a Linux VM/container with Bubblewrap')
140
+ }
141
+ }
142
+
143
+ export function assertSandboxRuntimeAvailable(networkMode, platform = process.platform, env = process.env) {
144
+ assertSandboxNetworkModeSupported(networkMode, platform)
145
+ if (platform === 'darwin') {
146
+ if (!fs.existsSync('/usr/bin/sandbox-exec')) throw new Error('macOS target isolation requires /usr/bin/sandbox-exec')
147
+ return '/usr/bin/sandbox-exec'
148
+ }
149
+ if (platform === 'linux') {
150
+ return trustedBubblewrapExecutable(env)
151
+ }
152
+ throw new Error(`target isolation is unsupported on ${platform}; use a Linux VM/container with Bubblewrap`)
153
+ }
154
+
155
+ export function verifyLinuxSandboxIsolation(env = process.env) {
156
+ const bubblewrap = trustedBubblewrapExecutable(env)
157
+ const probeRoot = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'om-bwrap-probe-')))
158
+ const nonce = crypto.randomBytes(18).toString('hex')
159
+ const marker = `OM_BWRAP_ISOLATED_${nonce}`
160
+ const node = fs.realpathSync(process.execPath)
161
+ const baseArgs = [
162
+ '--die-with-parent',
163
+ '--new-session',
164
+ ...linuxIsolationArgs('loopback'),
165
+ ...linuxMergedUsrSymlinkArgs(),
166
+ '--proc', '/proc',
167
+ '--dev', '/dev',
168
+ '--tmpfs', '/tmp',
169
+ '--bind', probeRoot, probeRoot,
170
+ ]
171
+ for (const root of runtimeReadRoots(node, env)) baseArgs.push('--ro-bind', root, root)
172
+ baseArgs.push('--chdir', probeRoot, '--', node, '-e')
173
+ const outerProbe = `
174
+ const { spawnSync } = require('node:child_process')
175
+ const net = require('node:net')
176
+ const bubblewrap = process.argv[1]
177
+ const args = JSON.parse(process.argv[2])
178
+ const marker = process.argv[3]
179
+ const host = net.createServer()
180
+ host.once('error', () => process.exit(71))
181
+ host.listen(0, '127.0.0.1', () => {
182
+ const address = host.address()
183
+ if (!address || typeof address === 'string') process.exit(72)
184
+ const inner = \`
185
+ const net = require('node:net')
186
+ const fs = require('node:fs')
187
+ const marker = \${JSON.stringify(marker)}
188
+ const hostPort = \${address.port}
189
+ const local = net.createServer((socket) => socket.end())
190
+ const fail = () => process.exit(81)
191
+ const capabilities = fs.readFileSync('/proc/self/status', 'utf8')
192
+ .split('\\\\n')
193
+ .filter((line) => /^Cap(?:Inh|Prm|Eff|Bnd|Amb):/.test(line))
194
+ .map((line) => line.split(/:\\\\s+/)[1])
195
+ if (capabilities.length !== 5 || capabilities.some((value) => !/^0+$/.test(value))) fail()
196
+ local.once('error', fail)
197
+ local.listen(0, '127.0.0.1', () => {
198
+ const address = local.address()
199
+ if (!address || typeof address === 'string') fail()
200
+ const self = net.connect(address.port, '127.0.0.1')
201
+ self.once('error', fail)
202
+ self.once('connect', () => {
203
+ self.destroy()
204
+ local.close()
205
+ const outside = net.connect(hostPort, '127.0.0.1')
206
+ outside.once('connect', () => process.exit(82))
207
+ outside.once('error', () => { console.log(marker); process.exit(0) })
208
+ outside.setTimeout(1500, () => { outside.destroy(); console.log(marker); process.exit(0) })
209
+ })
210
+ })
211
+ setTimeout(fail, 4000).unref()
212
+ \`
213
+ const result = spawnSync(bubblewrap, [...args, inner], { encoding: 'utf8', timeout: 7000 })
214
+ const passed = result.status === 0 && result.stdout.trim() === marker
215
+ host.close(() => process.exit(passed ? 0 : 73))
216
+ })
217
+ setTimeout(() => process.exit(74), 9000).unref()
218
+ `
219
+ try {
220
+ const result = spawnSync(node, ['-e', outerProbe, bubblewrap, JSON.stringify(baseArgs), marker], {
221
+ cwd: probeRoot,
222
+ env: { PATH: String(env.PATH ?? ''), TZ: 'UTC' },
223
+ encoding: 'utf8',
224
+ timeout: 10_000,
225
+ })
226
+ if (result.status !== 0 || result.error) {
227
+ throw new Error('Bubblewrap isolation probe failed: private user/network namespaces, capability-free payloads, and isolated loopback are required')
228
+ }
229
+ } finally {
230
+ fs.rmSync(probeRoot, { recursive: true, force: true })
231
+ }
232
+ }
233
+
234
+ export function macSandboxProfile({ command, writableRoots, readOnlyRoots, networkMode, env }) {
235
+ assertSandboxNetworkModeSupported(networkMode, 'darwin')
236
+ const writable = writableRoots.map((root, index) => regularDirectory(root, `writable sandbox root ${index + 1}`))
237
+ const readOnly = readOnlyRoots.map((root, index) => regularDirectory(root, `read-only sandbox root ${index + 1}`))
238
+ const readable = uniqueExistingDirectories([...writable, ...readOnly, ...runtimeReadRoots(command, env)])
239
+ return [
240
+ '(version 1)',
241
+ '(deny default)',
242
+ '(import "system.sb")',
243
+ '(allow process*)',
244
+ '(allow signal)',
245
+ '(allow sysctl-read)',
246
+ '(allow file-read-metadata)',
247
+ '(allow mach-lookup (global-name-regex #"^org\\.chromium\\.Chromium\\.MachPortRendezvousServer\\.[0-9]+$"))',
248
+ '(allow mach-register (global-name-regex #"^org\\.chromium\\.Chromium\\.MachPortRendezvousServer\\.[0-9]+$"))',
249
+ '(allow iokit-open-user-client (iokit-user-client-class "RootDomainUserClient"))',
250
+ ...readable.map((root) => `(allow file-read* (subpath "${sandboxLiteral(root)}"))`),
251
+ ...writable.map((root) => `(allow file-write* (subpath "${sandboxLiteral(root)}"))`),
252
+ ...(networkMode === 'all' ? ['(allow network*)'] : []),
253
+ ...readOnly.map((root) => `(deny file-write* (subpath "${sandboxLiteral(root)}"))`),
254
+ ].join(' ')
255
+ }
256
+
257
+ function macInvocation({ command, args, cwd, writableRoots, readOnlyRoots, networkMode, env }) {
258
+ const sandbox = '/usr/bin/sandbox-exec'
259
+ assertSandboxRuntimeAvailable(networkMode, 'darwin', env)
260
+ const profile = macSandboxProfile({ command, writableRoots, readOnlyRoots, networkMode, env })
261
+ return { command: sandbox, args: ['-p', profile, resolveExecutable(command, env), ...args], cwd: regularDirectory(cwd, 'sandbox cwd'), env }
262
+ }
263
+
264
+ export function linuxNamespaceArgs(networkMode) {
265
+ if (!['none', 'loopback', 'all'].includes(networkMode)) throw new Error(`invalid sandbox network mode: ${String(networkMode)}`)
266
+ return ['--unshare-all', ...(networkMode === 'all' ? ['--share-net'] : [])]
267
+ }
268
+
269
+ export function linuxIsolationArgs(networkMode) {
270
+ return [...linuxNamespaceArgs(networkMode), '--cap-drop', 'ALL']
271
+ }
272
+
273
+ export function linuxNetworkReadFiles(networkMode) {
274
+ linuxNamespaceArgs(networkMode)
275
+ return networkMode === 'all'
276
+ ? ['/etc/resolv.conf', '/etc/hosts', '/etc/nsswitch.conf']
277
+ : []
278
+ }
279
+
280
+ function linuxInvocation({ command, args, cwd, writableRoots, readOnlyRoots, networkMode, env }) {
281
+ const bubblewrap = assertSandboxRuntimeAvailable(networkMode, 'linux', env)
282
+ const writable = writableRoots.map((root, index) => regularDirectory(root, `writable sandbox root ${index + 1}`))
283
+ const readOnly = readOnlyRoots.map((root, index) => regularDirectory(root, `read-only sandbox root ${index + 1}`))
284
+ const readable = uniqueExistingDirectories([...readOnly, ...runtimeReadRoots(command, env)])
285
+ const networkReadable = uniqueExistingRegularFiles(linuxNetworkReadFiles(networkMode))
286
+ const sandboxArgs = [
287
+ '--die-with-parent',
288
+ '--new-session',
289
+ ...linuxIsolationArgs(networkMode),
290
+ ...linuxMergedUsrSymlinkArgs(),
291
+ '--proc', '/proc',
292
+ '--dev', '/dev',
293
+ '--tmpfs', '/tmp',
294
+ ]
295
+ for (const root of writable) sandboxArgs.push('--bind', root, root)
296
+ // Apply read-only mounts last so a nested dependency root cannot be shadowed
297
+ // by a later writable parent bind. Runtime roots are derived incidentally — the
298
+ // interpreter, the system tree, and the command's own directory — so one of them can
299
+ // be a writable root or its ANCESTOR, and mounting that last would re-mount the whole
300
+ // writable root read-only. Those are dropped: anything inside a writable bind is
301
+ // already reachable through it. Explicitly declared readOnlyRoots are never dropped,
302
+ // because a nested read-only dependency tree overriding its writable parent is exactly
303
+ // what this ordering exists to guarantee.
304
+ for (const root of readable) {
305
+ if (!readOnly.includes(root) && writable.some((writableRoot) => containsPath(root, writableRoot))) continue
306
+ sandboxArgs.push('--ro-bind', root, root)
307
+ }
308
+ for (const file of networkReadable) sandboxArgs.push('--ro-bind', file, file)
309
+ const realCwd = regularDirectory(cwd, 'sandbox cwd')
310
+ sandboxArgs.push('--chdir', realCwd, '--', resolveExecutable(command, env), ...args)
311
+ return { command: bubblewrap, args: sandboxArgs, cwd: realCwd, env }
312
+ }
313
+
314
+ export function sandboxedInvocation(options) {
315
+ const networkMode = options.networkMode ?? (options.networkAllowed === true ? 'all' : 'none')
316
+ assertSandboxNetworkModeSupported(networkMode)
317
+ const invocation = {
318
+ ...options,
319
+ args: options.args ?? [],
320
+ writableRoots: options.writableRoots ?? [],
321
+ readOnlyRoots: options.readOnlyRoots ?? [],
322
+ networkMode,
323
+ env: options.env ?? {},
324
+ }
325
+ resolveExecutable(invocation.command, invocation.env)
326
+ if (process.platform === 'darwin') return macInvocation(invocation)
327
+ if (process.platform === 'linux') return linuxInvocation(invocation)
328
+ throw new Error(`target isolation is unsupported on ${process.platform}; use macOS sandbox-exec or Linux bubblewrap`)
329
+ }