npm - arkgate - Versions diffs - 2.11.0 → 2.13.0 - Mend

arkgate 2.11.0 → 2.13.0

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 (77) hide show

package/CHANGELOG.md +147 -0
package/README.md +70 -41
package/bin/ark-check.mjs +95 -36
package/bin/ark-mcp.mjs +11 -5
package/bin/ark-shared.mjs +88 -56
package/bin/ark.mjs +97 -29
package/bin/lib/agent-gates.mjs +79 -2093
package/bin/lib/architecture-scan.mjs +8 -0
package/bin/lib/ci-and-commands.mjs +392 -0
package/bin/lib/codex-home.mjs +7 -0
package/bin/lib/config-contract.mjs +331 -0
package/bin/lib/deploy-path.mjs +205 -0
package/bin/lib/doctor-plan.mjs +43 -16
package/bin/lib/enforcement-profiles.mjs +97 -0
package/bin/lib/gate-files.mjs +223 -0
package/bin/lib/hook-templates.mjs +99 -0
package/bin/lib/host-support-matrix.mjs +77 -0
package/bin/lib/install-migrate.mjs +473 -0
package/bin/lib/mcp-adoption.mjs +455 -0
package/bin/lib/open-html.mjs +75 -0
package/bin/lib/presets.mjs +6 -2
package/bin/lib/safety-diagnostics.mjs +31 -11
package/bin/lib/skill-install.mjs +323 -0
package/bin/lib/ts-resolve.mjs +2 -1
package/bin/lib/typescript-host.mjs +88 -0
package/bin/lib/weakest-link.mjs +417 -0
package/bin/lib/write-path-capabilities.mjs +182 -0
package/bin/lib/write-path-detect.mjs +101 -0
package/dist/configContract-iBLxx5Tz.d.cts +53 -0
package/dist/configContract-iBLxx5Tz.d.ts +53 -0
package/dist/eslint/index.cjs +375 -13
package/dist/eslint/index.cjs.map +1 -1
package/dist/eslint/index.d.cts +30 -20
package/dist/eslint/index.d.ts +30 -20
package/dist/eslint/index.js +375 -13
package/dist/eslint/index.js.map +1 -1
package/dist/index.cjs +723 -61
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +95 -5
package/dist/index.d.ts +95 -5
package/dist/index.js +716 -61
package/dist/index.js.map +1 -1
package/dist/nestjs/index.cjs +150 -42
package/dist/nestjs/index.cjs.map +1 -1
package/dist/nestjs/index.d.cts +2 -1
package/dist/nestjs/index.d.ts +2 -1
package/dist/nestjs/index.js +150 -42
package/dist/nestjs/index.js.map +1 -1
package/dist/runtime/index.cjs +723 -61
package/dist/runtime/index.cjs.map +1 -1
package/dist/runtime/index.d.cts +3 -2
package/dist/runtime/index.d.ts +3 -2
package/dist/runtime/index.js +716 -61
package/dist/runtime/index.js.map +1 -1
package/dist/{types-BZ17b9i5.d.cts → types-BxBwnBpC.d.cts} +9 -36
package/dist/{types-BZ17b9i5.d.ts → types-Wcs_l1_J.d.ts} +9 -36
package/docs/agent-guide.md +43 -21
package/docs/ai-gates.md +53 -18
package/docs/configuration.md +97 -0
package/docs/enthusiast/README.md +3 -3
package/docs/enthusiast/how-to-agent-gates.md +7 -3
package/docs/migrate-from-ark-runtime-kernel.md +3 -0
package/docs/package-surface.md +22 -10
package/docs/production-hardening.md +15 -2
package/docs/threat-model.md +65 -0
package/docs/typescript-support.md +3 -3
package/package.json +15 -2
package/schemas/ark.config.schema.json +750 -0
package/server.json +2 -2
package/templates/hooks/pre-commit-ark +37 -0
package/templates/skills/ark-autopilot.md +77 -45
package/templates/skills/ark-coverage.md +2 -2
package/templates/skills/ark-explain.md +2 -1
package/templates/skills/ark-explore.md +135 -34
package/templates/skills/ark-runtime.md +8 -5
package/templates/skills/ark-upgrade.md +36 -16
package/tests/fixtures/ts-consumer/ark.config.json +2 -0

package/schemas/ark.config.schema.json ADDED Viewed

@@ -0,0 +1,750 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",
+  "title": "ArkGate architecture contract",
+  "description": "Versioned contract consumed identically by ArkGate CLI, MCP, and ESLint surfaces.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "include",
+    "layers",
+    "rules"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "minLength": 1,
+      "default": "https://unpkg.com/arkgate@2/schemas/ark.config.schema.json",
+      "description": "Editor-facing URL or local path for this JSON Schema."
+    },
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0",
+      "default": "1.0"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "include": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true,
+      "minItems": 1,
+      "default": [
+        "src"
+      ]
+    },
+    "exclude": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true,
+      "default": []
+    },
+    "excludeGenerated": {
+      "type": "boolean",
+      "default": true
+    },
+    "frameworkOverlay": {
+      "type": "string",
+      "minLength": 1
+    },
+    "layers": {
+      "type": "array",
+      "default": [],
+      "items": {
+        "$ref": "#/$defs/layer"
+      }
+    },
+    "rules": {
+      "type": "array",
+      "default": [
+        {
+          "from": "DomainModel",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "DomainModel",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "ApplicationOrchestration",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "PersistenceAdapters",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "IntegrationAdapters",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "WorkflowSagaEngine",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "BackgroundJobsScheduling",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "PresentationAdapters",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "ReportingReadModels",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        },
+        {
+          "from": "ExtensibilityMetadata",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "SecurityAuditObservability",
+          "to": "Kernel",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "DomainModel",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "ApplicationOrchestration",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "PersistenceAdapters",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "IntegrationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "WorkflowSagaEngine",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "BackgroundJobsScheduling",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "PresentationAdapters",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "ReportingReadModels",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "ExtensibilityMetadata",
+          "allowed": false
+        },
+        {
+          "from": "Kernel",
+          "to": "SecurityAuditObservability",
+          "allowed": false
+        }
+      ],
+      "items": {
+        "$ref": "#/$defs/rule"
+      }
+    },
+    "cyclePolicy": {
+      "type": "string",
+      "enum": [
+        "strict",
+        "soft",
+        "framework-soft",
+        "off"
+      ],
+      "default": "strict"
+    },
+    "dynamicImportAllowlist": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true,
+      "default": []
+    },
+    "safety": {
+      "$ref": "#/$defs/safety",
+      "default": {
+        "maxTsSuppressions": 0,
+        "maxAnyCasts": 0,
+        "allowInMemory": false,
+        "allowDisabledPeerIsolation": false
+      }
+    }
+  },
+  "$defs": {
+    "layer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "patterns"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "patterns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true,
+          "minItems": 1
+        },
+        "exclude": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "intentPrefixes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "forbiddenGlobals": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "mayImportInfrastructure": {
+          "type": "boolean"
+        },
+        "optional": {
+          "type": "boolean"
+        }
+      }
+    },
+    "rule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to",
+        "allowed"
+      ],
+      "properties": {
+        "from": {
+          "type": "string",
+          "minLength": 1
+        },
+        "to": {
+          "type": "string",
+          "minLength": 1
+        },
+        "allowed": {
+          "type": "boolean"
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        },
+        "peerIsolation": {
+          "type": "boolean"
+        },
+        "sliceFolders": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true,
+          "minItems": 1
+        }
+      }
+    },
+    "safety": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxTsSuppressions": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0
+        },
+        "maxAnyCasts": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0
+        },
+        "allowInMemory": {
+          "type": "boolean",
+          "default": false
+        },
+        "allowDisabledPeerIsolation": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    }
+  }
+}