@jay-framework/plugin-validator 0.25.5 → 0.26.0

package/dist/index.js

@@ -1456,7 +1456,7 @@ async function validateSchema(context, result) {
     }
   }
   const hasCapability = Boolean(
-    manifest.contracts || manifest.dynamic_contracts || manifest.actions || manifest.validators || manifest.routes || manifest.services || manifest.contexts || manifest.init || manifest.setup || manifest.agentkit || manifest.commands
+    manifest.contracts || manifest.dynamic_contracts || manifest.actions || manifest.validators || manifest.projectValidators || manifest.routes || manifest.services || manifest.contexts || manifest.init || manifest.setup || manifest.agentkit || manifest.commands
   );
   if (!hasCapability) {
     if (manifest.global === true) {
@@ -1472,7 +1472,7 @@ async function validateSchema(context, result) {
     } else {
       result.warnings.push({
         type: "schema",
-        message: "Plugin declares no capabilities (contracts, dynamic_contracts, actions, validators, routes, services, contexts, init, setup, agentkit, commands)",
+        message: "Plugin declares no capabilities (contracts, dynamic_contracts, actions, validators, projectValidators, routes, services, contexts, init, setup, agentkit, commands)",
         location: "plugin.yaml",
         suggestion: "Declare at least one capability. See agent-kit/plugin/plugin-structure.md"
       });
@@ -1662,6 +1662,43 @@ async function validateSchema(context, result) {
       });
     }
   }
+  if (manifest.projectValidators) {
+    if (!Array.isArray(manifest.projectValidators)) {
+      result.errors.push({
+        type: "schema",
+        message: 'Field "projectValidators" must be an array',
+        location: "plugin.yaml"
+      });
+    } else {
+      manifest.projectValidators.forEach((validator, index) => {
+        if (!validator.name) {
+          result.errors.push({
+            type: "schema",
+            message: `Project validator at index ${index} is missing "name" field`,
+            location: "plugin.yaml"
+          });
+        }
+        if (!validator.handler) {
+          result.errors.push({
+            type: "schema",
+            message: `Project validator "${validator.name || index}" is missing "handler" field`,
+            location: "plugin.yaml",
+            suggestion: "Specify the relative path to the project validator handler module"
+          });
+        }
+        if (validator.handler) {
+          validateHandlerRef(
+            validator.handler,
+            `Project validator "${validator.name}" handler`,
+            "plugin.yaml projectValidators",
+            context,
+            result,
+            "./tools"
+          );
+        }
+      });
+    }
+  }
   if (manifest.setup) {
     if (typeof manifest.setup !== "string") {
       result.errors.push({
@@ -1743,7 +1780,7 @@ function hasComponentCapability(context) {
   return Boolean(m.contracts || m.dynamic_contracts || m.routes);
 }
 function needsToolsEntry(manifest) {
-  if (manifest.validators || manifest.commands || manifest.agentkit || manifest.setup) {
+  if (manifest.validators || manifest.projectValidators || manifest.commands || manifest.agentkit || manifest.setup) {
     return true;
   }
   if (manifest.actions) {
@@ -1845,6 +1882,25 @@ function resolveContractFile(contractSpec, context) {
 }
 async function validateContract(contract, index, context, generateTypes, result) {
   result.contractsChecked = (result.contractsChecked || 0) + 1;
+  const hasEditingGuide = typeof contract.editingGuide === "string" && contract.editingGuide.length > 0;
+  const isReadonly = contract.readonly === true;
+  if (!hasEditingGuide && !isReadonly) {
+    result.warnings.push({
+      type: "source-editing-coverage",
+      message: `Contract "${contract.name}" declares no source-editing story. Add "editingGuide: <path.md>" (how to edit its bound data) or "readonly: true" (not editable in place).`,
+      location: `plugin.yaml contracts[${index}]`,
+      suggestion: "See the plugin source-editing guide (DL#219)."
+    });
+  } else if (hasEditingGuide) {
+    const guideFullPath = path.resolve(context.pluginPath, contract.editingGuide);
+    if (!fs.existsSync(guideFullPath)) {
+      result.warnings.push({
+        type: "source-editing-coverage",
+        message: `Contract "${contract.name}" editingGuide file not found: ${contract.editingGuide}`,
+        location: `plugin.yaml contracts[${index}]`
+      });
+    }
+  }
   const contractPath = resolveContractFile(contract.contract, context);
   if (!contractPath) {
     result.errors.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/plugin-validator",
-  "version": "0.25.5",
+  "version": "0.26.0",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Validation tool for Jay Stack plugins",
@@ -25,19 +25,19 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.25.5",
-    "@jay-framework/compiler-shared": "^0.25.5",
-    "@jay-framework/typescript-bridge": "^0.25.5",
+    "@jay-framework/compiler-jay-html": "^0.26.0",
+    "@jay-framework/compiler-shared": "^0.26.0",
+    "@jay-framework/typescript-bridge": "^0.26.0",
     "chalk": "^4.1.2",
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.25.5",
+    "@jay-framework/dev-environment": "^0.26.0",
     "@types/node": "^22.15.21",
     "rimraf": "^5.0.5",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
-    "vite": "^5.0.11",
-    "vitest": "^1.2.1"
+    "vite": "^6.4.4",
+    "vitest": "^4.1.11"
   }
 }