clawvault 3.1.0 → 3.2.1

package/dist/{chunk-33UGEQRT.js → chunk-X3SPPUFG.js}

@@ -4,6 +4,8 @@ import * as path from "path";
 import matter from "gray-matter";
 import { spawnSync } from "child_process";
 import { fileURLToPath } from "url";
+var REQUIRED_HOOK_EVENTS = ["gateway:startup", "command:new", "session:start"];
+var REQUIRED_HOOK_BIN = "clawvault";
 function readOptionalFile(filePath) {
   try {
     if (!fs.existsSync(filePath)) return null;
@@ -39,7 +41,7 @@ function checkOpenClawCli() {
       label: "openclaw CLI available",
       status: "warn",
       detail: "openclaw binary not found",
-      hint: "Install OpenClaw CLI to enable plugin runtime validation."
+      hint: "Install OpenClaw CLI to enable hook runtime validation."
     };
   }
   if (typeof result.status === "number" && result.status !== 0) {
@@ -60,106 +62,190 @@ function checkOpenClawCli() {
   }
   return { label: "openclaw CLI available", status: "ok" };
 }
-function checkPluginManifest(options) {
-  const manifestRaw = readOptionalFile(
-    resolveProjectFile("openclaw.plugin.json", options.baseDir)
-  );
-  if (!manifestRaw) {
+function checkPackageHookRegistration(options) {
+  const packageRaw = readOptionalFile(resolveProjectFile("package.json", options.baseDir));
+  if (!packageRaw) {
     return {
-      label: "plugin manifest",
+      label: "package hook registration",
       status: "error",
-      detail: "openclaw.plugin.json not found",
-      hint: "Create openclaw.plugin.json with id, kind, and configSchema fields."
+      detail: "package.json not found"
     };
   }
   try {
-    const manifest = JSON.parse(manifestRaw);
-    const issues = [];
-    if (!manifest.id) issues.push("missing id");
-    if (!manifest.kind) issues.push("missing kind");
-    if (!manifest.configSchema) issues.push("missing configSchema");
-    if (issues.length > 0) {
+    const parsed = JSON.parse(packageRaw);
+    const registeredHooks = parsed.openclaw?.hooks ?? [];
+    if (registeredHooks.includes("./hooks/clawvault")) {
       return {
-        label: "plugin manifest",
-        status: "error",
-        detail: issues.join(", ")
+        label: "package hook registration",
+        status: "ok",
+        detail: "./hooks/clawvault"
       };
     }
     return {
-      label: "plugin manifest",
-      status: "ok",
-      detail: `id=${manifest.id} kind=${manifest.kind}`
+      label: "package hook registration",
+      status: "error",
+      detail: "Missing ./hooks/clawvault in package openclaw.hooks"
     };
   } catch (err) {
     return {
-      label: "plugin manifest",
+      label: "package hook registration",
       status: "error",
-      detail: err?.message || "Unable to parse openclaw.plugin.json"
+      detail: err?.message || "Unable to parse package.json"
     };
   }
 }
-function checkPluginExtensions(options) {
-  let packageRaw = readOptionalFile(
-    resolveProjectFile("package.json", options.baseDir)
-  );
-  if (packageRaw && !options.baseDir) {
-    try {
-      const parsed = JSON.parse(packageRaw);
-      if (!parsed.openclaw?.extensions) {
-        const fallbackPath = path.resolve(findPackageRoot(), "package.json");
-        const fallbackRaw = readOptionalFile(fallbackPath);
-        if (fallbackRaw) packageRaw = fallbackRaw;
-      }
-    } catch {
+function checkHookManifest(options) {
+  const hookRaw = readOptionalFile(resolveProjectFile("hooks/clawvault/HOOK.md", options.baseDir));
+  if (!hookRaw) {
+    return {
+      label: "hook manifest",
+      status: "error",
+      detail: "HOOK.md not found"
+    };
+  }
+  try {
+    const parsed = matter(hookRaw);
+    const openclaw = parsed.data?.metadata?.openclaw;
+    const events = Array.isArray(openclaw?.events) ? openclaw?.events ?? [] : [];
+    const missingEvents = REQUIRED_HOOK_EVENTS.filter((event) => !events.includes(event));
+    if (missingEvents.length === 0) {
+      return {
+        label: "hook manifest events",
+        status: "ok",
+        detail: events.join(", ")
+      };
     }
+    return {
+      label: "hook manifest events",
+      status: "error",
+      detail: `Missing events: ${missingEvents.join(", ")}`
+    };
+  } catch (err) {
+    return {
+      label: "hook manifest events",
+      status: "error",
+      detail: err?.message || "Unable to parse HOOK.md frontmatter"
+    };
   }
-  if (!packageRaw) {
+}
+function checkHookManifestRequirements(options) {
+  const hookRaw = readOptionalFile(resolveProjectFile("hooks/clawvault/HOOK.md", options.baseDir));
+  if (!hookRaw) {
     return {
-      label: "plugin extensions registration",
+      label: "hook manifest requirements",
       status: "error",
-      detail: "package.json not found"
+      detail: "HOOK.md not found"
     };
   }
   try {
-    const parsed = JSON.parse(packageRaw);
-    const extensions = parsed.openclaw?.extensions ?? [];
-    if (extensions.length === 0) {
+    const parsed = matter(hookRaw);
+    const requiresBins = parsed.data?.metadata?.openclaw?.requires?.bins;
+    const bins = Array.isArray(requiresBins) ? requiresBins : [];
+    if (bins.includes(REQUIRED_HOOK_BIN)) {
+      return {
+        label: "hook manifest requirements",
+        status: "ok",
+        detail: `bins: ${bins.join(", ")}`
+      };
+    }
+    return {
+      label: "hook manifest requirements",
+      status: "warn",
+      detail: `Missing required hook bin "${REQUIRED_HOOK_BIN}"`,
+      hint: 'Add metadata.openclaw.requires.bins: ["clawvault"] to hooks/clawvault/HOOK.md.'
+    };
+  } catch (err) {
+    return {
+      label: "hook manifest requirements",
+      status: "error",
+      detail: err?.message || "Unable to parse HOOK.md frontmatter"
+    };
+  }
+}
+function checkHookHandlerSafety(options) {
+  const handlerRaw = readOptionalFile(resolveProjectFile("hooks/clawvault/handler.js", options.baseDir));
+  if (!handlerRaw) {
+    return {
+      label: "hook handler script",
+      status: "error",
+      detail: "handler.js not found"
+    };
+  }
+  const usesExecFileSync = handlerRaw.includes("execFileSync");
+  const usesExecSync = /\bexecSync\b/.test(handlerRaw);
+  const enablesShell = /\bshell\s*:\s*true\b/.test(handlerRaw);
+  const delegatesAutoProfile = /['"]--profile['"]\s*,\s*['"]auto['"]/.test(handlerRaw);
+  const violations = [];
+  if (!usesExecFileSync || usesExecSync) {
+    violations.push("execFileSync-only execution path");
+  }
+  if (enablesShell) {
+    violations.push("shell:false execution option");
+  }
+  if (!delegatesAutoProfile) {
+    violations.push("shared context profile delegation (--profile auto)");
+  }
+  if (violations.length > 0) {
+    return {
+      label: "hook handler safety",
+      status: "warn",
+      detail: `Missing conventions: ${violations.join(", ")}`,
+      hint: "Use execFileSync (no shell), avoid execSync, and delegate profile inference via --profile auto."
+    };
+  }
+  return { label: "hook handler safety", status: "ok" };
+}
+function checkPluginManifest(options) {
+  const manifestRaw = readOptionalFile(resolveProjectFile("hooks/clawvault/openclaw.plugin.json", options.baseDir));
+  if (!manifestRaw) {
+    return {
+      label: "plugin manifest",
+      status: "error",
+      detail: "hooks/clawvault/openclaw.plugin.json not found",
+      hint: "Add openclaw.plugin.json to hooks/clawvault/ for config schema registration."
+    };
+  }
+  try {
+    const parsed = JSON.parse(manifestRaw);
+    if (!parsed.id || parsed.id !== "clawvault") {
       return {
-        label: "plugin extensions registration",
+        label: "plugin manifest",
         status: "error",
-        detail: "Missing openclaw.extensions in package.json",
-        hint: 'Add openclaw.extensions: ["./dist/plugin/index.js"] to package.json.'
+        detail: `Invalid plugin id: expected "clawvault", got "${parsed.id || "(missing)"}"`
       };
     }
-    const baseDir = options.baseDir || findPackageRoot();
-    const missing = extensions.filter(
-      (ext) => !fs.existsSync(path.resolve(baseDir, ext))
-    );
-    if (missing.length > 0) {
+    if (!parsed.configSchema || typeof parsed.configSchema !== "object") {
       return {
-        label: "plugin extensions registration",
+        label: "plugin manifest",
         status: "error",
-        detail: `Entry file(s) not found: ${missing.join(", ")}`,
-        hint: "Run npm run build to generate dist files."
+        detail: "Missing configSchema in plugin manifest",
+        hint: "Add configSchema to openclaw.plugin.json for config validation."
+      };
+    }
+    const hasVaultPath = Boolean(parsed.configSchema.properties?.vaultPath);
+    if (!hasVaultPath) {
+      return {
+        label: "plugin manifest",
+        status: "warn",
+        detail: "configSchema missing vaultPath property",
+        hint: "Add vaultPath to configSchema.properties for vault path configuration."
       };
     }
     return {
-      label: "plugin extensions registration",
+      label: "plugin manifest",
       status: "ok",
-      detail: extensions.join(", ")
+      detail: `id: ${parsed.id}, configSchema defined`
     };
   } catch (err) {
     return {
-      label: "plugin extensions registration",
+      label: "plugin manifest",
       status: "error",
-      detail: err?.message || "Unable to parse package.json"
+      detail: err?.message || "Unable to parse openclaw.plugin.json"
     };
   }
 }
 function checkSkillMetadata(options) {
-  const skillRaw = readOptionalFile(
-    resolveProjectFile("SKILL.md", options.baseDir)
-  );
+  const skillRaw = readOptionalFile(resolveProjectFile("SKILL.md", options.baseDir));
   if (!skillRaw) {
     return {
       label: "skill metadata",
@@ -198,8 +284,11 @@ function checkSkillMetadata(options) {
 function checkOpenClawCompatibility(options = {}) {
   const checks = [
     checkOpenClawCli(),
+    checkPackageHookRegistration(options),
     checkPluginManifest(options),
-    checkPluginExtensions(options),
+    checkHookManifest(options),
+    checkHookManifestRequirements(options),
+    checkHookHandlerSafety(options),
     checkSkillMetadata(options)
   ];
   const warnings = checks.filter((check) => check.status === "warn").length;
@@ -219,9 +308,7 @@ function formatCompatibilityReport(report) {
   lines.push("");
   for (const check of report.checks) {
     const prefix = check.status === "ok" ? "\u2713" : check.status === "warn" ? "\u26A0" : "\u2717";
-    lines.push(
-      `${prefix} ${check.label}${check.detail ? ` \u2014 ${check.detail}` : ""}`
-    );
+    lines.push(`${prefix} ${check.label}${check.detail ? ` \u2014 ${check.detail}` : ""}`);
     if (check.hint) {
       lines.push(`  ${check.hint}`);
     }