plugnz 0.0.26 → 0.0.27

package/dist/plugnz.mjs

@@ -7852,7 +7852,12 @@ function homeRoot() {
   return process.env["HOME"] ?? ".";
 }
 function claudeCodeRoot() {
-  return process.env["OPEN_PLUGIN_CLAUDE_CODE_ROOT"] ?? join(homeRoot(), ".claude");
+  const explicitRoot = process.env["OPEN_PLUGIN_CLAUDE_CODE_ROOT"];
+  if (explicitRoot !== undefined)
+    return explicitRoot;
+  if (process.env["OPEN_PLUGIN_HOME"])
+    return join(homeRoot(), ".claude");
+  return process.env["CLAUDE_CONFIG_DIR"] || join(homeRoot(), ".claude");
 }
 function codexHome() {
   return process.env["OPEN_PLUGIN_CODEX_HOME"] ?? join(homeRoot(), ".codex");
@@ -14532,7 +14537,7 @@ function parseComponentDefinition(absolute, path, kind, dialect, filenameIdentit
     declarations
   };
   return {
-    definition: { kind, dialect, identity, path },
+    definition: { kind, dialect, identity, path, ...kind === "agent" ? { metadataKeys: Object.keys(record).sort() } : {} },
     policy,
     hasPermissionsPreprocessing: hasAny(record, PERMISSION_FIELDS) || /!`[\s\S]*?`/u.test(body)
   };
@@ -14689,9 +14694,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 specialized = candidates.filter((candidate) => candidate.packageFormat === "portable-hooks");
+  const claudeNative = (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 ordinary = candidates.filter((candidate) => candidate.packageFormat === undefined);
-  const matching = portable && specialized.length > 0 ? specialized : request.operation === "install" || request.operation === "update" ? ordinary : ordinary.length > 0 ? ordinary : specialized;
+  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;
   if (matching.length > 1) {
     throw new Error(`ambiguous capability evidence for ${request.host} ${version} ${request.sourceType} ${request.route} ${request.operation}`);
   }
@@ -14717,7 +14724,7 @@ function admitPackageSemanticsFromProfiles(request, profiles) {
   }
   const gaps = requirements.flatMap((semantic) => {
     const sourceOperation = request.operation === "install" || request.operation === "update";
-    const hookProblem = semantic === "hooks" && sourceOperation ? unsupportedHookDeclaration(request.inventory, profile.hookPolicy) : semantic === "auto-update-control" && sourceOperation && profile.packageFormat === "portable-hooks" && request.inventory.autoUpdate.length > 0 ? unsupportedHookProblem("portable hook installation does not project authored native auto-update directives") : null;
+    const hookProblem = semantic === "agents" && sourceOperation && profile.agentPolicy === "prompt-resources" ? unsupportedPromptPersona(request.inventory) : semantic === "hooks" && sourceOperation ? unsupportedHookDeclaration(request.inventory, profile.hookPolicy) : semantic === "auto-update-control" && sourceOperation && profile.packageFormat === "portable-hooks" && request.inventory.autoUpdate.length > 0 ? unsupportedHookProblem("portable hook installation does not project authored native auto-update directives") : null;
     const status = profile.semantics[semantic] === "supported" && hookProblem !== null ? hookProblem.status : profile.semantics[semantic];
     return status === "supported" ? [] : [capabilityReason(status, semantic, profile, profile.semantics[semantic] === "supported" && hookProblem !== null ? hookProblem.diagnostic : `target '${request.host}' ${profile.detectedVersion} ${profile.route} ${request.operation} is ${status} for ${semantic}`)];
   });
@@ -14768,6 +14775,7 @@ function createCapabilityEvidenceProfile(input) {
     operationStatus: input.operationStatus,
     semantics: PACKAGE_SEMANTICS.map((semantic) => [semantic, input.semantics[semantic]]),
     hookPolicy,
+    ...input.agentPolicy === undefined ? {} : { agentPolicy: input.agentPolicy },
     evidence
   };
   const hash = new CryptoHasher("sha256");
@@ -14785,9 +14793,25 @@ function createCapabilityEvidenceProfile(input) {
     operationStatus: input.operationStatus,
     semantics: Object.freeze({ ...input.semantics }),
     hookPolicy,
+    ...input.agentPolicy === undefined ? {} : { agentPolicy: input.agentPolicy },
     evidence: Object.freeze(evidence)
   });
 }
+function unsupportedPromptPersona(inventory) {
+  for (const path of inventory.components.agents) {
+    const agent = inventory.componentDefinitions.find((item) => item.kind === "agent" && item.path === path);
+    if (agent?.root !== "agents" || agent.dialect !== "markdown" || agent.metadataKeys === undefined) {
+      return unsupportedHookProblem(`prompt-resource agent adaptation cannot prove '${path}' as a canonical Markdown persona`);
+    }
+    const field = agent.metadataKeys.find((key) => key !== "name" && key !== "description");
+    if (field !== undefined)
+      return unsupportedHookProblem(`prompt-resource agent adaptation cannot preserve '${path}' metadata '${field}'; native agent registration is unsupported`);
+  }
+  if (inventory.components.agents.length > 0 && inventory.components.commands.length === 0) {
+    return unsupportedHookProblem("prompt-resource agent adaptation requires a projected command with persona loading instructions");
+  }
+  return null;
+}
 function unsupportedHookDeclaration(inventory, policy) {
   if (policy === null)
     return unverifiedHookProblem("target profile has no evidence for authored hook declaration dialects");
@@ -15868,7 +15892,7 @@ function writeCommandSkill(stage, command, namespace, commandNames) {
 `;
   const preface = `Use the user's text after the skill invocation as command arguments; no text means empty arguments. Load referenced skills from sibling directories (../<skill>/SKILL.md). Plugin personas live at ../../agents/<persona>.md and shared references at ../../references/, relative to this file.
 
-For persona work, read the persona file and use the current harness's available delegation facility with those instructions. Persona names are not assumed to be registered tools or agent types. If delegation is unavailable, perform the passes sequentially and report that limitation.
+For persona work, read the persona file and use the current harness's available delegation facility with those instructions. Persona names are not assumed to be registered tools or agent types. These adaptation instructions override any native-agent registration assumptions in the command body below. If delegation is unavailable, perform the passes sequentially and report that limitation.
 
 `;
   mkdirSync5(join25(skillDir, "agents"), { recursive: true });
@@ -16471,7 +16495,7 @@ function selectLifecycleRoute(adapterId, profiles, request) {
       return selectedDecision(adapterId, target, request, detectedVersion, "managed", managedAdmission);
     }
     const versionDiagnostic = request.version.kind === "detected" ? undefined : request.version.diagnostic;
-    const gaps = dedupeGaps([...nativeGaps, ...managedAdmission.gaps].map((gap) => versionDiagnostic === undefined ? gap : { ...gap, diagnostic: `${gap.diagnostic}. ${versionDiagnostic}` }));
+    const gaps = dedupeGaps([...nativeGaps, ...managedAdmission.gaps].map((gap) => versionDiagnostic === undefined ? gap : { ...gap, diagnostic: `${gap.diagnostic}. ${versionDiagnostic}` })).sort((left, right) => Number(left.capabilityId === "profile") - Number(right.capabilityId === "profile"));
     if (gaps.length === 0)
       invariant("a refused route decision must retain at least one capability gap");
     return deepFreeze({
@@ -18668,12 +18692,51 @@ function claudeReflectionHookProfile() {
     evidence: [...hooks.evidence, "docs/evidence/claude-code-2.1.285-reflection-20261016.json"]
   });
 }
+function claudeAdvisorCandidateHookProfile() {
+  return createCapabilityEvidenceProfile({
+    host: "claude-code",
+    detectedVersion: "2.1.285",
+    packageFormat: "claude-native-hooks",
+    sourceTypes: ["local", "git"],
+    operations: ["install", "update", "retire"],
+    route: "managed",
+    operationStatus: "supported",
+    semantics: Object.fromEntries(PACKAGE_SEMANTICS.map((semantic) => [
+      semantic,
+      ["hooks", "auto-update-control", "readback", "rollback", "activation-reload", "retirement", "retention-safety"].includes(semantic) ? "supported" : "unsupported"
+    ])),
+    hookPolicy: {
+      manifestPrecedence: [".claude-plugin/plugin.json", "plugin.json"],
+      supportedForms: ["manifest-file"],
+      supportedEvents: ["UserPromptSubmit", "PostToolUse", "PostToolUseFailure", "Stop"],
+      supportedHandlerTypes: ["command"],
+      matcherlessEvents: ["UserPromptSubmit", "Stop", "PostToolUse", "PostToolUseFailure"],
+      supportedMatcherKinds: ["all"],
+      unsupportedHandlerFacets: [
+        "async-enabled",
+        "async-non-boolean",
+        "argv-invalid",
+        "timeout-invalid",
+        "status-message-invalid"
+      ]
+    },
+    evidence: [
+      "docs/hosts/claude-code.md",
+      "docs/research/native-plugin-update-capabilities-2026-10-09.md",
+      "docs/evidence/claude-code-2.1.285-advisor-candidate-20261019.json"
+    ]
+  });
+}
 function claudeCodeLifecycleDefinition(contracts) {
   const version = claudeVersionObservation(observeClaudeCodeVersion());
   const detectedVersion = version.kind === "detected" ? version.version : undefined;
   return {
     id: "claude-code",
-    evidenceProfiles: [...claudeEvidenceProfiles(detectedVersion, contracts), claudeReflectionHookProfile()],
+    evidenceProfiles: [
+      ...claudeEvidenceProfiles(detectedVersion, contracts),
+      claudeReflectionHookProfile(),
+      ...detectedVersion === "2.1.285" ? [claudeAdvisorCandidateHookProfile()] : []
+    ],
     probeVersion: async () => version,
     observeTarget: async (target) => ({ target, installations: observeClaudeInstallations(target, detectedVersion) }),
     observeNativeMutationScope: async (request) => ({
@@ -19693,7 +19756,7 @@ function disableMarketplaceAutoUpdate(nativeId) {
 
 // src/hosts/codex-writer.ts
 init_codex_hooks();
-import { chmodSync, cpSync as cpSync6, existsSync as existsSync22, lstatSync as lstatSync15, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync6, readFileSync as readFileSync23, readdirSync as readdirSync14, renameSync as renameSync4, rmSync as rmSync7, statSync as statSync10, writeFileSync as writeFileSync7 } from "node:fs";
+import { chmodSync, cpSync as cpSync6, existsSync as existsSync22, lstatSync as lstatSync15, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync6, readFileSync as readFileSync23, readdirSync as readdirSync14, readlinkSync as readlinkSync2, renameSync as renameSync4, rmSync as rmSync7, statSync as statSync10, writeFileSync as writeFileSync7 } from "node:fs";
 import { dirname as dirname9, join as join29, resolve as resolve16 } from "node:path";
 import { tmpdir as tmpdir3 } from "node:os";
 
@@ -20215,13 +20278,14 @@ function nativeUpgradeTimeout() {
 }
 var RELOAD_EFFECTIVE = { requirement: "reload", status: "effective" };
 var UPDATE_SEMANTICS = ["ordinary-skills", "resources", "auto-update-control", "readback", "rollback", "activation-reload"];
-var MANAGED_SEMANTICS = [...UPDATE_SEMANTICS, "retirement", "retention-safety", "model-invocation-control", "commands", "mcp"];
+var MANAGED_SEMANTICS = [...UPDATE_SEMANTICS, "retirement", "retention-safety", "model-invocation-control", "commands", "mcp", "agents"];
 var OH_MY_AI_INSTALL_SEMANTICS2 = ["ordinary-skills", "mcp", "resources", "auto-update-control", "readback", "rollback", "activation-reload"];
 var codexEvidenceProfiles = [
   portableHookProfile(hookAdapter2, "managed", ["install", "update", "retire"]),
   codexRouteProfile(CODEX_NATIVE_ROUTE_VERSION, "native", ["update"], UPDATE_SEMANTICS, ["docs/research/native-plugin-update-capabilities-2026-10-09.md", "docs/evidence/codex-native-released-20261011.md"]),
-  ...CODEX_MANAGED_ROUTE_VERSIONS.map((version) => codexRouteProfile(version, "managed", ["install", "update", "retire"], version === "0.161.0" ? [...OH_MY_AI_INSTALL_SEMANTICS2, "retirement", "retention-safety"] : MANAGED_SEMANTICS, [
+  ...CODEX_MANAGED_ROUTE_VERSIONS.map((version) => codexRouteProfile(version, "managed", ["install", "update", "retire"], version === "0.161.0" ? [...OH_MY_AI_INSTALL_SEMANTICS2, "retirement", "retention-safety", "commands", "model-invocation-control", "agents"] : MANAGED_SEMANTICS, [
     "docs/hosts/codex.md",
+    ...["0.161.0", "0.162.0"].includes(version) ? ["docs/evidence/codex-addy-20261019.json"] : [],
     "docs/adr/0004-retain-plugin-state-on-removal.md",
     "docs/evidence/codex-policy-mcp-20261013.json",
     "docs/evidence/codex-native-released-20261011.md",
@@ -20272,6 +20336,8 @@ function codexRouteProfile(detectedVersion, route, operations, supportedSemantic
     throw new Error("codex marketplace checkout rollback must stay unverified");
   }
   const supported = new Set(supportedSemantics);
+  if (!["0.161.0", "0.162.0"].includes(detectedVersion))
+    supported.delete("agents");
   const semantics = {};
   for (const semantic of PACKAGE_SEMANTICS)
     semantics[semantic] = supported.has(semantic) ? "supported" : "unsupported";
@@ -20283,6 +20349,7 @@ function codexRouteProfile(detectedVersion, route, operations, supportedSemantic
     route,
     operationStatus: "supported",
     semantics,
+    ...supported.has("agents") ? { agentPolicy: "prompt-resources" } : {},
     evidence
   });
 }
@@ -21190,7 +21257,8 @@ function parseRollbackVersions(value) {
   return value;
 }
 function installationRecord(plugin) {
-  const owned = plugin.path === undefined ? null : readOwnership2(plugin.path);
+  const linked = plugin.path !== undefined && lstatSync15(plugin.path).isSymbolicLink();
+  const owned = plugin.path === undefined || linked ? null : readOwnership2(plugin.path);
   const ownership = owned?.pluginId === plugin.id ? { kind: "owned", proof: "created", scopeId: owned.scopeId ?? `codex:${plugin.id}`, proofId: `marker:${plugin.id}` } : { kind: "unmanaged" };
   if (plugin.path === undefined) {
     return {
@@ -21206,7 +21274,7 @@ function installationRecord(plugin) {
       contentRoots: []
     };
   }
-  const installedFingerprint = fingerprintTree(plugin.path);
+  const installedFingerprint = linked ? new CryptoHasher("sha256").update(`codex-unmanaged-symlink\x00${readlinkSync2(plugin.path)}`).digest("hex") : fingerprintTree(plugin.path);
   return {
     nativeId: plugin.id,
     packageName: plugin.name,
@@ -23500,7 +23568,7 @@ function receipt(kind, handle) {
 
 // src/hosts/omp-writer.ts
 init_omp_hooks();
-import { cpSync as cpSync9, existsSync as existsSync25, lstatSync as lstatSync19, mkdirSync as mkdirSync10, mkdtempSync as mkdtempSync9, readFileSync as readFileSync27, readdirSync as readdirSync18, readlinkSync as readlinkSync2, renameSync as renameSync7, rmSync as rmSync10, symlinkSync, writeFileSync as writeFileSync10 } from "node:fs";
+import { cpSync as cpSync9, existsSync as existsSync25, lstatSync as lstatSync19, mkdirSync as mkdirSync10, mkdtempSync as mkdtempSync9, readFileSync as readFileSync27, readdirSync as readdirSync18, readlinkSync as readlinkSync3, renameSync as renameSync7, rmSync as rmSync10, symlinkSync, writeFileSync as writeFileSync10 } from "node:fs";
 import { dirname as dirname12, join as join33, resolve as resolve20 } from "node:path";
 import { tmpdir as tmpdir6 } from "node:os";
 var MARKER6 = ".plgnz-install.json";
@@ -23716,7 +23784,7 @@ function lstatExists(path) {
 }
 function linkPointsTo(path, target) {
   try {
-    return lstatSync19(path).isSymbolicLink() && resolve20(dirname12(path), readlinkSync2(path)) === resolve20(target);
+    return lstatSync19(path).isSymbolicLink() && resolve20(dirname12(path), readlinkSync3(path)) === resolve20(target);
   } catch {
     return false;
   }
@@ -24287,7 +24355,7 @@ function restoreLockRow(saved) {
 }
 function currentLinkTarget(path) {
   try {
-    return lstatSync19(path).isSymbolicLink() ? resolve20(dirname12(path), readlinkSync2(path)) : null;
+    return lstatSync19(path).isSymbolicLink() ? resolve20(dirname12(path), readlinkSync3(path)) : null;
   } catch {
     return null;
   }
@@ -26275,7 +26343,7 @@ var opencodeHookWriter = createNativeHookWriter({
 
 // src/hosts/grok-writer.ts
 import { spawnSync as spawnSync6 } from "node:child_process";
-import { cpSync as cpSync13, existsSync as existsSync30, lstatSync as lstatSync24, mkdirSync as mkdirSync15, mkdtempSync as mkdtempSync14, readFileSync as readFileSync32, readdirSync as readdirSync22, readlinkSync as readlinkSync3, renameSync as renameSync12, rmSync as rmSync15, symlinkSync as symlinkSync2, writeFileSync as writeFileSync15 } from "node:fs";
+import { cpSync as cpSync13, existsSync as existsSync30, lstatSync as lstatSync24, mkdirSync as mkdirSync15, mkdtempSync as mkdtempSync14, readFileSync as readFileSync32, readdirSync as readdirSync22, readlinkSync as readlinkSync4, renameSync as renameSync12, rmSync as rmSync15, symlinkSync as symlinkSync2, writeFileSync as writeFileSync15 } from "node:fs";
 import { dirname as dirname17, join as join38, resolve as resolve24 } from "node:path";
 import { tmpdir as tmpdir11 } from "node:os";
 var stableId = (plugin) => plugin.marketplace === undefined ? plugin.name : `${plugin.name}@${plugin.marketplace}`;
@@ -26703,7 +26771,7 @@ function legacyCandidate(plugin, adopt, prior) {
     throw new Error(`Grok ${plugin.name}: legacy source, version, and native bytes must match before adoption`);
   const link = join38(grokRoot(), "plugins", plugin.name);
   if (existsSync30(link) || lstatExists2(link)) {
-    if (!lstatSync24(link).isSymbolicLink() || canonical(resolve24(dirname17(link), readlinkSync3(link))) !== installed)
+    if (!lstatSync24(link).isSymbolicLink() || canonical(resolve24(dirname17(link), readlinkSync4(link))) !== installed)
       throw new Error(`Grok ${plugin.name}: unmanaged same-name plugin link blocks adoption`);
   }
   return { source, fingerprint: fingerprintTree(installed), ...lstatExists2(link) ? { link } : {} };
@@ -27084,7 +27152,7 @@ function captureHostSnapshot(directory, nativeId, packageName, attemptId, operat
   writeFileSync15(join38(directory, "registry-repo.json"), JSON.stringify(matched === undefined ? { key: null } : { key: matched[0], repo: matched[1] }));
   const link = join38(grokRoot(), "plugins", packageName);
   if (lstatExists2(link) && lstatSync24(link).isSymbolicLink())
-    writeFileSync15(join38(directory, "link.txt"), readlinkSync3(link));
+    writeFileSync15(join38(directory, "link.txt"), readlinkSync4(link));
 }
 function freshNativePaths(directory, marketplacePath) {
   const paths = new Set;
@@ -34178,7 +34246,7 @@ function legacyCommandAction(command) {
 // package.json
 var package_default = {
   name: "plugnz",
-  version: "0.0.26",
+  version: "0.0.27",
   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.26",
+  "version": "0.0.27",
   "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",