plugnz 0.0.27 → 0.0.29

package/dist/plugnz.mjs

@@ -14225,7 +14225,8 @@ function readSemanticManifests(root) {
     "plugin.json",
     ".plugin/plugin.json",
     ".claude-plugin/plugin.json",
-    ".codex-plugin/plugin.json"
+    ".codex-plugin/plugin.json",
+    ".zcode-plugin/plugin.json"
   ].filter((path) => existsSync16(join21(root, path))).map((path) => ({
     ...parseJsonObject(join21(root, path), `plugin manifest ${path}`),
     path
@@ -14694,11 +14695,11 @@ function admitPackageSemanticsFromProfiles(request, profiles) {
   const version = normalizedDetectedVersion(request.detectedVersion);
   const candidates = version === undefined ? [] : profiles.filter((candidate) => candidate.host === request.host && candidate.detectedVersion === version && candidate.sourceTypes.includes(request.sourceType) && candidate.operations.includes(request.operation) && candidate.route === request.route);
   const portable = (request.operation === "install" || request.operation === "update") && request.inventory.hookDeclarations.some((declaration) => declaration.form === "portable-hooks");
-  const claudeNative = (request.operation === "install" || request.operation === "update") && !portable && request.inventory.hookDeclarations.some((declaration) => declaration.form !== "portable-hooks");
+  const native = (request.operation === "install" || request.operation === "update") && !portable && request.inventory.hookDeclarations.some((declaration) => declaration.form !== "portable-hooks");
   const portableSpecialized = candidates.filter((candidate) => candidate.packageFormat === "portable-hooks");
-  const claudeNativeSpecialized = candidates.filter((candidate) => candidate.packageFormat === "claude-native-hooks");
+  const nativeSpecialized = candidates.filter((candidate) => candidate.packageFormat === "native-hooks");
   const ordinary = candidates.filter((candidate) => candidate.packageFormat === undefined);
-  const matching = portable && portableSpecialized.length > 0 ? portableSpecialized : claudeNative && claudeNativeSpecialized.length > 0 ? claudeNativeSpecialized : request.operation === "install" || request.operation === "update" ? ordinary : ordinary.length > 0 ? ordinary : portableSpecialized.length > 0 ? portableSpecialized : claudeNativeSpecialized;
+  const matching = portable && portableSpecialized.length > 0 ? portableSpecialized : native && nativeSpecialized.length > 0 ? nativeSpecialized : request.operation === "install" || request.operation === "update" ? ordinary : ordinary.length > 0 ? ordinary : portableSpecialized.length > 0 ? portableSpecialized : nativeSpecialized;
   if (matching.length > 1) {
     throw new Error(`ambiguous capability evidence for ${request.host} ${version} ${request.sourceType} ${request.route} ${request.operation}`);
   }
@@ -18696,7 +18697,7 @@ function claudeAdvisorCandidateHookProfile() {
   return createCapabilityEvidenceProfile({
     host: "claude-code",
     detectedVersion: "2.1.285",
-    packageFormat: "claude-native-hooks",
+    packageFormat: "native-hooks",
     sourceTypes: ["local", "git"],
     operations: ["install", "update", "retire"],
     route: "managed",
@@ -27521,6 +27522,48 @@ function projectZcodePayload(source, resourceLinks, nativeVersion) {
   for (const key of ["hooks", "mcpServers", "agents", "agent", "executables"])
     if (Object.hasOwn(manifest, key))
       throw new Error(`ZCode root plugin semantic is unsupported: ${key}`);
+  if (payload.has(".zcode-plugin/plugin.json")) {
+    const native = JSON.parse(text3(payload, ".zcode-plugin/plugin.json"));
+    if (!object10(native) || native.name !== name)
+      throw new Error("ZCode native manifest identity differs from plugin.json");
+    const metadata = new Set(["name", "version", "description", "author", "license", "homepage", "repository", "keywords"]);
+    const conventional = { skills: "skills", commands: "commands", hooks: "hooks/hooks.json" };
+    for (const [key, value] of Object.entries(native)) {
+      if (metadata.has(key))
+        continue;
+      const path = conventional[key];
+      if (path !== undefined && (value === path || value === `./${path}`) && payload.has(path))
+        continue;
+      throw new Error(`ZCode projection cannot preserve native manifest field: ${key}`);
+    }
+  }
+  if (payload.has("hooks/hooks.json")) {
+    const document = JSON.parse(text3(payload, "hooks/hooks.json"));
+    if (!object10(document) || !object10(document.hooks))
+      throw new Error("ZCode hook document must contain hooks");
+    for (const groups of Object.values(document.hooks)) {
+      if (!Array.isArray(groups))
+        throw new Error("ZCode hook groups must be an array");
+      for (const group of groups) {
+        if (!object10(group) || !Array.isArray(group.hooks))
+          throw new Error("ZCode hook group must contain hooks");
+        for (const handler of group.hooks) {
+          if (!object10(handler) || handler.type !== "command" || typeof handler.command !== "string" || !handler.command.trim()) {
+            throw new Error("ZCode projection requires command hooks");
+          }
+          for (const key of Object.keys(handler)) {
+            if (!["type", "command", "timeout", "async"].includes(key))
+              throw new Error(`ZCode hook option is unqualified: ${key}`);
+          }
+          if (handler.async !== undefined && handler.async !== false)
+            throw new Error("ZCode asynchronous hook is unqualified");
+          if (handler.timeout !== undefined && (typeof handler.timeout !== "number" || !Number.isFinite(handler.timeout) || handler.timeout <= 0)) {
+            throw new Error("ZCode command timeout must be positive seconds");
+          }
+        }
+      }
+    }
+  }
   if (payload.has("commands")) {
     if (payload.get("commands")?.kind !== "directory")
       throw new Error("ZCode commands path is not a directory");
@@ -27990,10 +28033,41 @@ function zcodeInstallProfile() {
     evidence: [...ZCODE_EVIDENCE]
   });
 }
+function zcodeNativeHookProfile() {
+  return createCapabilityEvidenceProfile({
+    host: "zcode-cli",
+    detectedVersion: ZCODE_PROVEN_VERSION,
+    packageFormat: "native-hooks",
+    sourceTypes: ["local", "git"],
+    operations: ["install", "update"],
+    route: "native",
+    operationStatus: "supported",
+    semantics: zcodeSemantics({
+      hooks: "supported",
+      resources: "supported",
+      "auto-update-control": "supported",
+      "retention-safety": "supported",
+      readback: "supported",
+      rollback: "supported",
+      "activation-reload": "supported"
+    }),
+    hookPolicy: {
+      manifestPrecedence: [".zcode-plugin/plugin.json", ".claude-plugin/plugin.json", "plugin.json"],
+      supportedForms: ["default-file"],
+      supportedEvents: ["UserPromptSubmit", "PostToolUse", "PostToolUseFailure", "Stop"],
+      supportedHandlerTypes: ["command"],
+      matcherlessEvents: ["UserPromptSubmit", "PostToolUse", "PostToolUseFailure", "Stop"],
+      supportedMatcherKinds: ["all"],
+      unsupportedHandlerFacets: ["async-enabled", "async-non-boolean", "argv-invalid", "timeout-invalid", "status-message-invalid"]
+    },
+    evidence: [...ZCODE_EVIDENCE, "docs/evidence/zcode-native-advisor-hooks-20261021.json"]
+  });
+}
 var zcodeCliEvidenceProfiles = Object.freeze([
   zcodeRetireProfile("native", "unsupported", "unsupported", "unsupported"),
   zcodeRetireProfile("managed", "supported", "supported", "supported"),
   zcodeInstallProfile(),
+  zcodeNativeHookProfile(),
   portableHookProfile(hookAdapter6, "native", ["install", "update"])
 ]);
 function assertZcodeTarget(target) {
@@ -28461,7 +28535,8 @@ var ZCODE_INSTALL_SEMANTICS = new Set([
   "ordinary-skills",
   "commands",
   "model-invocation-control",
-  "resources"
+  "resources",
+  "hooks"
 ]);
 function installProjection(request) {
   if (request.operation !== "install" && request.operation !== "update")
@@ -28469,8 +28544,7 @@ function installProjection(request) {
   if (!("snapshot" in request) || request.pins.length > 0)
     return { kind: "unverified", reasonId: "zcode-native-projection-unverified" };
   const inventory = request.snapshot.inventory;
-  const portableHooks = inventory.hookDeclarations.length > 0 && inventory.hookDeclarations.every((declaration) => declaration.form === "portable-hooks");
-  const unsupported = inventory.requiredSemantics.find((semantic) => !ZCODE_INSTALL_SEMANTICS.has(semantic) && !(semantic === "hooks" && portableHooks));
+  const unsupported = inventory.requiredSemantics.find((semantic) => !ZCODE_INSTALL_SEMANTICS.has(semantic));
   if (unsupported !== undefined)
     return { kind: "unverified", reasonId: `zcode-semantic-unverified:${unsupported}` };
   return { kind: "equivalent", proofId: "zcode-marketplace-projection" };
@@ -34246,7 +34320,7 @@ function legacyCommandAction(command) {
 // package.json
 var package_default = {
   name: "plugnz",
-  version: "0.0.27",
+  version: "0.0.29",
   description: "Install, diagnose and update agent plugins (Agent Plugins spec) and MCP configs across Claude Code, Codex, Cursor, Kimi and more",
   license: "MIT",
   type: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plugnz",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "Install, diagnose and update agent plugins (Agent Plugins spec) and MCP configs across Claude Code, Codex, Cursor, Kimi and more",
   "license": "MIT",
   "type": "module",