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.
- package/README.md +72 -0
- package/agentic/claude-code/hooks/entity-migration-check.ts +32 -88
- package/agentic/codex/enforcement-rules.md +2 -16
- package/agentic/cursor/hooks/entity-migration-check.mjs +19 -50
- package/agentic/cursor/rules/entity-guard.mdc +9 -21
- package/agentic/cursor/rules/generated-guard.mdc +3 -5
- package/agentic/cursor/rules/open-mercato.mdc +3 -29
- package/agentic/guides/ai-workflows.md +76 -0
- package/agentic/guides/architecture.md +107 -0
- package/agentic/guides/backend-ui.md +80 -0
- package/agentic/guides/contracts.md +92 -0
- package/agentic/guides/extensions.md +121 -0
- package/agentic/guides/integrations.md +81 -0
- package/agentic/guides/module-system.md +12 -127
- package/agentic/guides/spec-delivery.md +22 -0
- package/agentic/guides/testing-debugging.md +80 -0
- package/agentic/shared/AGENTS.md.template +124 -311
- package/agentic/shared/ai/agentic.config.json +2 -0
- package/agentic/shared/ai/harness/README.md +50 -0
- package/agentic/shared/ai/harness/RELEASE.md +57 -0
- package/agentic/shared/ai/harness/cases.json +13680 -0
- package/agentic/shared/ai/harness/cases.schema.json +133 -0
- package/agentic/shared/ai/harness/fixtures/index.json +49 -0
- package/agentic/shared/ai/harness/fixtures/seeds.json +162 -0
- package/agentic/shared/ai/harness/generated-code-review-policy.md +21 -0
- package/agentic/shared/ai/harness/generated-code-review-response.schema.json +96 -0
- package/agentic/shared/ai/harness/generated-code-review-result.schema.json +172 -0
- package/agentic/shared/ai/harness/release-matrix.json +158 -0
- package/agentic/shared/ai/harness/release-result.schema.json +219 -0
- package/agentic/shared/ai/harness/result.schema.json +76 -0
- package/agentic/shared/ai/harness/routing-response.schema.json +12 -0
- package/agentic/shared/ai/harness/target-validation-result.schema.json +73 -0
- package/agentic/shared/ai/harness/validators.json +78 -0
- package/agentic/shared/ai/harness/writable-ast-oracles.mjs +2121 -0
- package/agentic/shared/ai/harness/writable-behavior-oracles.mjs +1096 -0
- package/agentic/shared/ai/lessons/_template.md +16 -0
- package/agentic/shared/ai/lessons.md +26 -3
- package/agentic/shared/ai/review-checklist.md +36 -0
- package/agentic/shared/ai/skills/om-auto-implement-spec/SKILL.md +21 -0
- package/agentic/shared/ai/skills/om-auto-review-pr/SKILL.md +4 -0
- package/agentic/shared/ai/skills/om-auto-upgrade-0.6.6-to-0.6.7/SKILL.md +98 -0
- package/agentic/shared/ai/skills/om-backend-ui-design/SKILL.md +20 -241
- package/agentic/shared/ai/skills/om-backend-ui-design/references/crud-surfaces.md +16 -0
- package/agentic/shared/ai/skills/om-backend-ui-design/references/frontend-and-design-system.md +53 -0
- package/agentic/shared/ai/skills/om-backend-ui-design/references/page-and-navigation.md +13 -0
- package/agentic/shared/ai/skills/om-backend-ui-design/references/quality-states.md +11 -0
- package/agentic/shared/ai/skills/om-build-workflow/SKILL.md +30 -0
- package/agentic/shared/ai/skills/om-build-workflow/references/activity-contracts.md +12 -0
- package/agentic/shared/ai/skills/om-build-workflow/references/durability-and-progress.md +13 -0
- package/agentic/shared/ai/skills/om-build-workflow/references/workflow-design.md +14 -0
- package/agentic/shared/ai/skills/om-create-ai-agent/SKILL.md +28 -0
- package/agentic/shared/ai/skills/om-create-ai-agent/references/attachments-and-overrides.md +12 -0
- package/agentic/shared/ai/skills/om-create-ai-agent/references/module-agents-and-tools.md +22 -0
- package/agentic/shared/ai/skills/om-create-ai-agent/references/orchestrator-agents.md +12 -0
- package/agentic/shared/ai/skills/om-create-ai-agent/references/surface-selector.md +19 -0
- package/agentic/shared/ai/skills/om-data-model-design/SKILL.md +16 -601
- package/agentic/shared/ai/skills/om-data-model-design/references/integrity-and-concurrency.md +19 -0
- package/agentic/shared/ai/skills/om-data-model-design/references/migration-workflow.md +13 -0
- package/agentic/shared/ai/skills/om-data-model-design/references/schema-design.md +14 -0
- package/agentic/shared/ai/skills/om-data-model-design/references/sensitive-data.md +10 -0
- package/agentic/shared/ai/skills/om-eject-and-customize/SKILL.md +14 -310
- package/agentic/shared/ai/skills/om-eject-and-customize/references/decision-and-procedure.md +17 -0
- package/agentic/shared/ai/skills/om-evolve-harness/SKILL.md +29 -0
- package/agentic/shared/ai/skills/om-evolve-harness/references/case-template.md +100 -0
- package/agentic/shared/ai/skills/om-evolve-harness/references/case-workflow.md +16 -0
- package/agentic/shared/ai/skills/om-evolve-harness/references/owner-selection.md +17 -0
- package/agentic/shared/ai/skills/om-framework-context/SKILL.md +25 -0
- package/agentic/shared/ai/skills/om-framework-context/references/resolver-procedure.md +11 -0
- package/agentic/shared/ai/skills/om-framework-context/references/skew-and-escalation.md +13 -0
- package/agentic/shared/ai/skills/om-help/SKILL.md +15 -97
- package/agentic/shared/ai/skills/om-help/references/delivery-workflows.md +18 -0
- package/agentic/shared/ai/skills/om-help/references/task-families.md +20 -0
- package/agentic/shared/ai/skills/om-implement-spec/SKILL.md +33 -152
- package/agentic/shared/ai/skills/om-implement-spec/references/phases-and-gates.md +33 -0
- package/agentic/shared/ai/skills/om-implement-spec/references/planning-and-progress.md +40 -0
- package/agentic/shared/ai/skills/om-implement-spec/references/report-templates.md +27 -0
- package/agentic/shared/ai/skills/om-implement-spec/references/spec-resolution.md +24 -0
- package/agentic/shared/ai/skills/om-integration-builder/SKILL.md +24 -708
- package/agentic/shared/ai/skills/om-integration-builder/references/package-and-activation.md +16 -0
- package/agentic/shared/ai/skills/om-integration-builder/references/provider-families.md +14 -0
- package/agentic/shared/ai/skills/om-integration-builder/references/security-and-reliability.md +15 -0
- package/agentic/shared/ai/skills/om-integration-builder/references/sync-and-files.md +12 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/SKILL.md +34 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/agents/openai.yaml +4 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/references/agentic-setup.md +11 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/references/input-normalization.md +31 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/references/judge-workflow.md +39 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/references/report-template.md +43 -0
- package/agentic/shared/ai/skills/om-judge-agent-session/references/rules.md +11 -0
- package/agentic/shared/ai/skills/om-module-scaffold/SKILL.md +20 -820
- package/agentic/shared/ai/skills/om-module-scaffold/references/api-and-domain.md +19 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/business-one-shot-blueprints.md +172 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/data-and-migrations.md +12 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/discovery-surface-catalog.md +83 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/module-surfaces.md +21 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/planning.md +11 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/runtime-cache-and-queues.md +22 -0
- package/agentic/shared/ai/skills/om-module-scaffold/references/verification.md +13 -0
- package/agentic/shared/ai/skills/om-share-this-session/SKILL.md +41 -0
- package/agentic/shared/ai/skills/om-share-this-session/references/agentic-setup.md +19 -0
- package/agentic/shared/ai/skills/om-share-this-session/references/bundle-preparation.md +44 -0
- package/agentic/shared/ai/skills/om-share-this-session/references/consent-and-review.md +39 -0
- package/agentic/shared/ai/skills/om-share-this-session/references/publication.md +20 -0
- package/agentic/shared/ai/skills/om-share-this-session/references/report-templates.md +57 -0
- package/agentic/shared/ai/skills/om-share-this-session/references/rules.md +11 -0
- package/agentic/shared/ai/skills/om-share-this-session/scripts/prepare-share-bundle.mjs +486 -0
- package/agentic/shared/ai/skills/om-system-extension/SKILL.md +19 -843
- package/agentic/shared/ai/skills/om-system-extension/references/extension-branches.md +18 -0
- package/agentic/shared/ai/skills/om-system-extension/references/mechanism-selector.md +27 -0
- package/agentic/shared/ai/skills/om-system-extension/references/read-write-roundtrip.md +13 -0
- package/agentic/shared/ai/skills/om-system-extension/references/unified-overrides.md +41 -0
- package/agentic/shared/ai/skills/om-system-extension/references/verification.md +11 -0
- package/agentic/shared/ai/skills/om-trim-unused-modules/SKILL.md +15 -63
- package/agentic/shared/ai/skills/om-trim-unused-modules/references/dependency-and-redirect.md +15 -0
- package/agentic/shared/ai/skills/om-troubleshooter/SKILL.md +16 -467
- package/agentic/shared/ai/skills/om-troubleshooter/references/diagnosis-map.md +16 -0
- package/agentic/shared/ai/skills/om-troubleshooter/references/regression-oracles.md +14 -0
- package/agentic/shared/ai/skills/tiers.json +143 -21
- package/agentic/shared/ai/skills/tiers.schema.json +52 -40
- package/agentic/shared/ai/specs/README.md +4 -3
- package/agentic/shared/ai/specs/SPEC-000-template.md +226 -10
- package/agentic/shared/ai/trackers/github.md +108 -4
- package/agentic/shared/scripts/agent-harness-tool-server.mjs +187 -0
- package/agentic/shared/scripts/check-lessons.mjs +178 -0
- package/agentic/shared/scripts/evaluate-agent-harness.mjs +2958 -0
- package/agentic/shared/scripts/execution-sandbox.mjs +329 -0
- package/agentic/shared/scripts/framework-context.mjs +888 -0
- package/agentic/shared/scripts/install-skills.mjs +1029 -0
- package/agentic/shared/scripts/install-skills.sh +4 -694
- package/agentic/shared/scripts/prepare-agent-harness-fixture.mjs +222 -0
- package/agentic/shared/scripts/run-agent-harness-release.mjs +1774 -0
- package/dist/agentic/claude-code/hooks/entity-migration-check.ts +32 -88
- package/dist/agentic/codex/enforcement-rules.md +2 -16
- package/dist/agentic/cursor/hooks/entity-migration-check.mjs +19 -50
- package/dist/agentic/cursor/rules/entity-guard.mdc +9 -21
- package/dist/agentic/cursor/rules/generated-guard.mdc +3 -5
- package/dist/agentic/cursor/rules/open-mercato.mdc +3 -29
- package/dist/agentic/guides/ai-workflows.md +76 -0
- package/dist/agentic/guides/architecture.md +107 -0
- package/dist/agentic/guides/backend-ui.md +80 -0
- package/dist/agentic/guides/contracts.md +92 -0
- package/dist/agentic/guides/extensions.md +121 -0
- package/dist/agentic/guides/framework-extension-points.md +36 -0
- package/dist/agentic/guides/integrations.md +81 -0
- package/dist/agentic/guides/module-facts.json +115537 -3951
- package/dist/agentic/guides/module-system.md +12 -127
- package/dist/agentic/guides/modules/ai_assistant.md +227 -28
- package/dist/agentic/guides/modules/api_docs.md +58 -2
- package/dist/agentic/guides/modules/api_keys.md +92 -7
- package/dist/agentic/guides/modules/attachments.md +119 -14
- package/dist/agentic/guides/modules/audit_logs.md +131 -10
- package/dist/agentic/guides/modules/auth.md +276 -33
- package/dist/agentic/guides/modules/business_rules.md +149 -14
- package/dist/agentic/guides/modules/catalog.md +475 -43
- package/dist/agentic/guides/modules/channel_gmail.md +82 -3
- package/dist/agentic/guides/modules/channel_imap.md +82 -3
- package/dist/agentic/guides/modules/checkout.md +299 -27
- package/dist/agentic/guides/modules/communication_channels.md +315 -33
- package/dist/agentic/guides/modules/configs.md +104 -8
- package/dist/agentic/guides/modules/content.md +57 -2
- package/dist/agentic/guides/modules/currencies.md +152 -17
- package/dist/agentic/guides/modules/customer_accounts.md +387 -45
- package/dist/agentic/guides/modules/customers.md +746 -85
- package/dist/agentic/guides/modules/dashboards.md +155 -10
- package/dist/agentic/guides/modules/data_sync.md +149 -16
- package/dist/agentic/guides/modules/design_system.md +102 -0
- package/dist/agentic/guides/modules/dictionaries.md +107 -12
- package/dist/agentic/guides/modules/directory.md +148 -15
- package/dist/agentic/guides/modules/entities.md +145 -13
- package/dist/agentic/guides/modules/events.md +59 -2
- package/dist/agentic/guides/modules/feature_toggles.md +119 -9
- package/dist/agentic/guides/modules/gateway_stripe.md +92 -4
- package/dist/agentic/guides/modules/generators.md +45 -2
- package/dist/agentic/guides/modules/inbox_ops.md +207 -27
- package/dist/agentic/guides/modules/integrations.md +146 -16
- package/dist/agentic/guides/modules/messages.md +223 -24
- package/dist/agentic/guides/modules/notifications.md +96 -8
- package/dist/agentic/guides/modules/onboarding.md +77 -6
- package/dist/agentic/guides/modules/payment_gateways.md +164 -21
- package/dist/agentic/guides/modules/perspectives.md +77 -7
- package/dist/agentic/guides/modules/planner.md +136 -18
- package/dist/agentic/guides/modules/portal.md +93 -2
- package/dist/agentic/guides/modules/progress.md +104 -14
- package/dist/agentic/guides/modules/query_index.md +154 -15
- package/dist/agentic/guides/modules/record_locks.md +206 -21
- package/dist/agentic/guides/modules/resources.md +197 -30
- package/dist/agentic/guides/modules/sales.md +678 -84
- package/dist/agentic/guides/modules/scheduler.md +133 -14
- package/dist/agentic/guides/modules/search.md +170 -6
- package/dist/agentic/guides/modules/security.md +294 -35
- package/dist/agentic/guides/modules/shipping_carriers.md +134 -18
- package/dist/agentic/guides/modules/sso.md +151 -26
- package/dist/agentic/guides/modules/staff.md +369 -57
- package/dist/agentic/guides/modules/storage_s3.md +95 -5
- package/dist/agentic/guides/modules/sync_akeneo.md +85 -3
- package/dist/agentic/guides/modules/sync_excel.md +75 -6
- package/dist/agentic/guides/modules/system_status_overlays.md +60 -2
- package/dist/agentic/guides/modules/translations.md +104 -10
- package/dist/agentic/guides/modules/webhooks.md +203 -24
- package/dist/agentic/guides/modules/wms.md +441 -46
- package/dist/agentic/guides/modules/workflows.md +302 -43
- package/dist/agentic/guides/spec-delivery.md +22 -0
- package/dist/agentic/guides/testing-debugging.md +80 -0
- package/dist/agentic/guides/upstream/AGENTS.md +299 -0
- package/dist/agentic/guides/upstream/BACKWARD_COMPATIBILITY.md +316 -0
- package/dist/agentic/guides/upstream/manifest.json +8 -0
- package/dist/agentic/shared/AGENTS.md.template +124 -311
- package/dist/agentic/shared/ai/agentic.config.json +2 -0
- package/dist/agentic/shared/ai/harness/README.md +50 -0
- package/dist/agentic/shared/ai/harness/RELEASE.md +57 -0
- package/dist/agentic/shared/ai/harness/cases.json +13680 -0
- package/dist/agentic/shared/ai/harness/cases.schema.json +133 -0
- package/dist/agentic/shared/ai/harness/fixtures/index.json +49 -0
- package/dist/agentic/shared/ai/harness/fixtures/seeds.json +162 -0
- package/dist/agentic/shared/ai/harness/generated-code-review-policy.md +21 -0
- package/dist/agentic/shared/ai/harness/generated-code-review-response.schema.json +96 -0
- package/dist/agentic/shared/ai/harness/generated-code-review-result.schema.json +172 -0
- package/dist/agentic/shared/ai/harness/release-matrix.json +158 -0
- package/dist/agentic/shared/ai/harness/release-result.schema.json +219 -0
- package/dist/agentic/shared/ai/harness/result.schema.json +76 -0
- package/dist/agentic/shared/ai/harness/routing-response.schema.json +12 -0
- package/dist/agentic/shared/ai/harness/target-validation-result.schema.json +73 -0
- package/dist/agentic/shared/ai/harness/validators.json +78 -0
- package/dist/agentic/shared/ai/harness/writable-ast-oracles.mjs +2121 -0
- package/dist/agentic/shared/ai/harness/writable-behavior-oracles.mjs +1096 -0
- package/dist/agentic/shared/ai/lessons/_template.md +16 -0
- package/dist/agentic/shared/ai/lessons.md +26 -3
- package/dist/agentic/shared/ai/review-checklist.md +36 -0
- package/dist/agentic/shared/ai/skills/om-auto-implement-spec/SKILL.md +21 -0
- package/dist/agentic/shared/ai/skills/om-auto-review-pr/SKILL.md +4 -0
- package/dist/agentic/shared/ai/skills/om-auto-upgrade-0.6.6-to-0.6.7/SKILL.md +98 -0
- package/dist/agentic/shared/ai/skills/om-backend-ui-design/SKILL.md +20 -241
- package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/crud-surfaces.md +16 -0
- package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/frontend-and-design-system.md +53 -0
- package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/page-and-navigation.md +13 -0
- package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/quality-states.md +11 -0
- package/dist/agentic/shared/ai/skills/om-build-workflow/SKILL.md +30 -0
- package/dist/agentic/shared/ai/skills/om-build-workflow/references/activity-contracts.md +12 -0
- package/dist/agentic/shared/ai/skills/om-build-workflow/references/durability-and-progress.md +13 -0
- package/dist/agentic/shared/ai/skills/om-build-workflow/references/workflow-design.md +14 -0
- package/dist/agentic/shared/ai/skills/om-create-ai-agent/SKILL.md +28 -0
- package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/attachments-and-overrides.md +12 -0
- package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/module-agents-and-tools.md +22 -0
- package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/orchestrator-agents.md +12 -0
- package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/surface-selector.md +19 -0
- package/dist/agentic/shared/ai/skills/om-data-model-design/SKILL.md +16 -601
- package/dist/agentic/shared/ai/skills/om-data-model-design/references/integrity-and-concurrency.md +19 -0
- package/dist/agentic/shared/ai/skills/om-data-model-design/references/migration-workflow.md +13 -0
- package/dist/agentic/shared/ai/skills/om-data-model-design/references/schema-design.md +14 -0
- package/dist/agentic/shared/ai/skills/om-data-model-design/references/sensitive-data.md +10 -0
- package/dist/agentic/shared/ai/skills/om-eject-and-customize/SKILL.md +14 -310
- package/dist/agentic/shared/ai/skills/om-eject-and-customize/references/decision-and-procedure.md +17 -0
- package/dist/agentic/shared/ai/skills/om-evolve-harness/SKILL.md +29 -0
- package/dist/agentic/shared/ai/skills/om-evolve-harness/references/case-template.md +100 -0
- package/dist/agentic/shared/ai/skills/om-evolve-harness/references/case-workflow.md +16 -0
- package/dist/agentic/shared/ai/skills/om-evolve-harness/references/owner-selection.md +17 -0
- package/dist/agentic/shared/ai/skills/om-framework-context/SKILL.md +25 -0
- package/dist/agentic/shared/ai/skills/om-framework-context/references/resolver-procedure.md +11 -0
- package/dist/agentic/shared/ai/skills/om-framework-context/references/skew-and-escalation.md +13 -0
- package/dist/agentic/shared/ai/skills/om-help/SKILL.md +15 -97
- package/dist/agentic/shared/ai/skills/om-help/references/delivery-workflows.md +18 -0
- package/dist/agentic/shared/ai/skills/om-help/references/task-families.md +20 -0
- package/dist/agentic/shared/ai/skills/om-implement-spec/SKILL.md +33 -152
- package/dist/agentic/shared/ai/skills/om-implement-spec/references/phases-and-gates.md +33 -0
- package/dist/agentic/shared/ai/skills/om-implement-spec/references/planning-and-progress.md +40 -0
- package/dist/agentic/shared/ai/skills/om-implement-spec/references/report-templates.md +27 -0
- package/dist/agentic/shared/ai/skills/om-implement-spec/references/spec-resolution.md +24 -0
- package/dist/agentic/shared/ai/skills/om-integration-builder/SKILL.md +24 -708
- package/dist/agentic/shared/ai/skills/om-integration-builder/references/package-and-activation.md +16 -0
- package/dist/agentic/shared/ai/skills/om-integration-builder/references/provider-families.md +14 -0
- package/dist/agentic/shared/ai/skills/om-integration-builder/references/security-and-reliability.md +15 -0
- package/dist/agentic/shared/ai/skills/om-integration-builder/references/sync-and-files.md +12 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/SKILL.md +34 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/agents/openai.yaml +4 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/agentic-setup.md +11 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/input-normalization.md +31 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/judge-workflow.md +39 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/report-template.md +43 -0
- package/dist/agentic/shared/ai/skills/om-judge-agent-session/references/rules.md +11 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/SKILL.md +20 -820
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/api-and-domain.md +19 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/business-one-shot-blueprints.md +172 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/data-and-migrations.md +12 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/discovery-surface-catalog.md +83 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/module-surfaces.md +21 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/planning.md +11 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/runtime-cache-and-queues.md +22 -0
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/verification.md +13 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/SKILL.md +41 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/references/agentic-setup.md +19 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/references/bundle-preparation.md +44 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/references/consent-and-review.md +39 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/references/publication.md +20 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/references/report-templates.md +57 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/references/rules.md +11 -0
- package/dist/agentic/shared/ai/skills/om-share-this-session/scripts/prepare-share-bundle.mjs +486 -0
- package/dist/agentic/shared/ai/skills/om-system-extension/SKILL.md +19 -843
- package/dist/agentic/shared/ai/skills/om-system-extension/references/extension-branches.md +18 -0
- package/dist/agentic/shared/ai/skills/om-system-extension/references/mechanism-selector.md +27 -0
- package/dist/agentic/shared/ai/skills/om-system-extension/references/read-write-roundtrip.md +13 -0
- package/dist/agentic/shared/ai/skills/om-system-extension/references/unified-overrides.md +41 -0
- package/dist/agentic/shared/ai/skills/om-system-extension/references/verification.md +11 -0
- package/dist/agentic/shared/ai/skills/om-trim-unused-modules/SKILL.md +15 -63
- package/dist/agentic/shared/ai/skills/om-trim-unused-modules/references/dependency-and-redirect.md +15 -0
- package/dist/agentic/shared/ai/skills/om-troubleshooter/SKILL.md +16 -467
- package/dist/agentic/shared/ai/skills/om-troubleshooter/references/diagnosis-map.md +16 -0
- package/dist/agentic/shared/ai/skills/om-troubleshooter/references/regression-oracles.md +14 -0
- package/dist/agentic/shared/ai/skills/tiers.json +143 -21
- package/dist/agentic/shared/ai/skills/tiers.schema.json +52 -40
- package/dist/agentic/shared/ai/specs/README.md +4 -3
- package/dist/agentic/shared/ai/specs/SPEC-000-template.md +226 -10
- package/dist/agentic/shared/ai/trackers/github.md +108 -4
- package/dist/agentic/shared/scripts/agent-harness-tool-server.mjs +187 -0
- package/dist/agentic/shared/scripts/check-lessons.mjs +178 -0
- package/dist/agentic/shared/scripts/evaluate-agent-harness.mjs +2958 -0
- package/dist/agentic/shared/scripts/execution-sandbox.mjs +329 -0
- package/dist/agentic/shared/scripts/framework-context.mjs +888 -0
- package/dist/agentic/shared/scripts/install-skills.mjs +1029 -0
- package/dist/agentic/shared/scripts/install-skills.sh +4 -694
- package/dist/agentic/shared/scripts/prepare-agent-harness-fixture.mjs +222 -0
- package/dist/agentic/shared/scripts/run-agent-harness-release.mjs +1774 -0
- package/dist/index.js +175 -184
- package/package.json +9 -7
- package/template/.env.example +59 -2
- package/template/.yarnrc.yml.template +9 -0
- package/template/AGENTS.md +93 -663
- package/template/eslint.config.mjs +1 -0
- package/template/gitignore +8 -0
- package/template/jest.config.cjs +2 -1
- package/template/jest.setup.ts +29 -0
- package/template/next.config.ts +55 -0
- package/template/package.json.template +31 -25
- package/template/scripts/dev-memory-monitor.mjs +92 -0
- package/template/scripts/dev-memory-sampler.mjs +464 -0
- package/template/scripts/dev-runtime-log-policy.mjs +33 -0
- package/template/scripts/dev-runtime.mjs +142 -76
- package/template/scripts/dev.mjs +129 -7
- package/template/scripts/evaluate-agent-harness.mjs +4 -0
- package/template/scripts/framework-context.mjs +4 -0
- package/template/scripts/install-skills.mjs +10 -0
- package/template/scripts/install-skills.sh +2 -19
- package/template/scripts/prepare-agent-harness-fixture.mjs +4 -0
- package/template/scripts/run-agent-harness-release.mjs +4 -0
- package/template/src/app/(backend)/backend/__tests__/layout-route-registry.test.tsx +1 -0
- package/template/src/app/(backend)/backend/layout.tsx +5 -3
- package/template/src/app/(frontend)/layout.tsx +1 -1
- package/template/src/app/api/[...slug]/route.ts +9 -0
- package/template/src/app/globals.css +61 -3
- package/template/src/app/layout.tsx +2 -18
- package/template/src/app/page.tsx +4 -1
- package/template/src/components/AppProviders.tsx +4 -1
- package/template/src/components/DemoFeedbackWidget.tsx +1 -1
- package/template/src/components/__tests__/AppProviders.test.tsx +11 -2
- package/template/src/components/__tests__/StartPageContent.test.tsx +69 -0
- package/template/src/components/__tests__/starter-chrome-ds.test.ts +35 -0
- package/template/src/i18n/de.json +21 -1
- package/template/src/i18n/en.json +21 -1
- package/template/src/i18n/es.json +21 -1
- package/template/src/i18n/ko.json +970 -0
- package/template/src/i18n/pl.json +21 -1
- package/template/src/instrumentation.ts +14 -1
- package/template/src/lib/i18n/register-dictionary-loader.ts +2 -0
- package/template/src/modules/example/__integration__/TC-EXAMPLE-001-todo-label-edit.spec.ts +123 -0
- package/template/src/modules/example/__integration__/TC-EXAMPLE-002-query-index-failure.spec.ts +155 -0
- package/template/src/modules/example/__integration__/TC-UMES-003.spec.ts +7 -3
- package/template/src/modules/example/__integration__/TC-UMES-005.spec.ts +7 -1
- package/template/src/modules/example/__integration__/TC-UMES-009.spec.ts +11 -10
- package/template/src/modules/example/__integration__/todo-priority-validation.spec.ts +31 -1
- package/template/src/modules/example/acl.ts +6 -0
- package/template/src/modules/example/backend/mutation-lifecycle/page.meta.ts +1 -9
- package/template/src/modules/example/backend/page.meta.ts +1 -10
- package/template/src/modules/example/backend/payments/page.meta.ts +1 -10
- package/template/src/modules/example/backend/payments/page.tsx +2 -2
- package/template/src/modules/example/backend/todos/create/page.meta.ts +1 -11
- package/template/src/modules/example/backend/todos/page.meta.ts +1 -10
- package/template/src/modules/example/backend/umes-extensions/page.meta.ts +1 -9
- package/template/src/modules/example/backend/umes-handlers/page.meta.ts +1 -10
- package/template/src/modules/example/backend/umes-integrations/page.meta.ts +1 -10
- package/template/src/modules/example/backend/umes-next-phases/page.meta.ts +1 -11
- package/template/src/modules/example/backend/umes-query-extensions/page.meta.ts +1 -11
- package/template/src/modules/example/commands/__tests__/todos.prepare-scope.test.ts +77 -0
- package/template/src/modules/example/commands/todos.ts +47 -2
- package/template/src/modules/example/i18n/ko.json +481 -0
- package/template/src/modules/example/i18n/pl.json +68 -68
- package/template/src/modules/example/lib/__tests__/mock-webhook-endpoint-adapter.test.ts +14 -0
- package/template/src/modules/example_customers_sync/i18n/ko.json +11 -0
- package/template/src/modules.ts +17 -0
- package/template/tsconfig.json +3 -2
- package/agentic/shared/ai/skills/om-auto-continue-pr-loop/SKILL.md +0 -27
- package/agentic/shared/ai/skills/om-auto-create-pr-loop/SKILL.md +0 -27
- package/agentic/shared/ai/skills/om-backend-ui-design/references/ui-components.md +0 -260
- package/agentic/shared/ai/skills/om-data-model-design/references/mikro-orm-cheatsheet.md +0 -146
- package/agentic/shared/ai/skills/om-help/references/skills-catalog.md +0 -84
- package/agentic/shared/ai/skills/om-help/references/workflow-sequences.md +0 -193
- package/agentic/shared/ai/skills/om-integration-builder/STANDALONE.md +0 -34
- package/agentic/shared/ai/skills/om-integration-builder/references/adapter-contracts.md +0 -762
- package/agentic/shared/ai/skills/om-module-scaffold/references/naming-conventions.md +0 -50
- package/agentic/shared/ai/skills/om-module-scaffold/references/navigation-patterns.md +0 -97
- package/agentic/shared/ai/skills/om-system-extension/references/extension-contracts.md +0 -271
- package/agentic/shared/ai/skills/om-troubleshooter/references/diagnostic-commands.md +0 -101
- package/dist/agentic/guides/cache.md +0 -45
- package/dist/agentic/guides/core.md +0 -453
- package/dist/agentic/guides/events.md +0 -117
- package/dist/agentic/guides/queue.md +0 -53
- package/dist/agentic/guides/search.md +0 -115
- package/dist/agentic/guides/shared.md +0 -108
- package/dist/agentic/guides/ui.md +0 -347
- package/dist/agentic/shared/ai/skills/om-auto-continue-pr-loop/SKILL.md +0 -27
- package/dist/agentic/shared/ai/skills/om-auto-create-pr-loop/SKILL.md +0 -27
- package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/ui-components.md +0 -260
- package/dist/agentic/shared/ai/skills/om-data-model-design/references/mikro-orm-cheatsheet.md +0 -146
- package/dist/agentic/shared/ai/skills/om-help/references/skills-catalog.md +0 -84
- package/dist/agentic/shared/ai/skills/om-help/references/workflow-sequences.md +0 -193
- package/dist/agentic/shared/ai/skills/om-integration-builder/STANDALONE.md +0 -34
- package/dist/agentic/shared/ai/skills/om-integration-builder/references/adapter-contracts.md +0 -762
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/naming-conventions.md +0 -50
- package/dist/agentic/shared/ai/skills/om-module-scaffold/references/navigation-patterns.md +0 -97
- package/dist/agentic/shared/ai/skills/om-system-extension/references/extension-contracts.md +0 -271
- 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
|
+
}
|