@evo-dev/evodev 0.0.1-alpha.18 → 0.0.1-alpha.19

package/dist/plugins/evodev/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "evodev",
   "description": "EvoDev hook, skill, and Teams MCP integration for disciplined AI coding workflows.",
-  "version": "0.0.1-alpha.18",
+  "version": "0.0.1-alpha.19",
   "author": {
     "name": "EvoDev"
   },

package/dist/plugins/evodev/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "evodev",
-  "version": "0.0.1-alpha.18",
+  "version": "0.0.1-alpha.19",
   "description": "EvoDev hook, skill, and Teams MCP integration for disciplined AI coding workflows.",
   "author": {
     "name": "EvoDev"

package/dist/plugins/evodev/hooks/codex.ts

@@ -54,6 +54,7 @@ export interface CodexPluginOptions {
   pluginSelector?: string;
   pluginMarketplaceSource?: string;
   pluginMarketplaceFallbackSource?: string;
+  pluginVersion?: string;
   paths?: CodexPaths;
   syncFileSystem?: CodexSyncFileSystem;
 }
@@ -195,6 +196,7 @@ async function installCodexPlugin(
     | "pluginSelector"
     | "pluginMarketplaceSource"
     | "pluginMarketplaceFallbackSource"
+    | "pluginVersion"
     | "paths"
   >,
 ): Promise<PluginInstallResult> {
@@ -202,8 +204,46 @@ async function installCodexPlugin(
   const selector = options.pluginSelector ?? "evodev@evodev";
   const args = ["plugin", "add", selector];
   const runner = options.commandRunner ?? new NodeCodexCommandRunner();
+  const installedPlugin =
+    input.force === true || options.pluginVersion === undefined
+      ? null
+      : await readInstalledCodexPlugin(runner, selector);
+  let needsRepair = false;
+
+  if (
+    installedPlugin !== null &&
+    installedPlugin.version === options.pluginVersion &&
+    installedPlugin.enabled
+  ) {
+    try {
+      const hydration = await hydrateCodexWorkspaceCoreDependency({
+        paths: options.paths,
+        selector,
+      });
+      if (hydration.warnings.length === 0 && hydration.errors.length === 0) {
+        return createPluginInstallResult(
+          input.targetPlugin,
+          "already-installed",
+          command,
+          args,
+          `Codex plugin ${selector} already matches EvoDev ${options.pluginVersion}; skipped marketplace refresh.`,
+        );
+      }
+    } catch {
+      // Fall through to the normal repair path, which returns a structured install failure.
+    }
+    needsRepair = true;
+  }
+
+  const effectiveInput =
+    input.force === true ||
+    needsRepair ||
+    (installedPlugin !== null &&
+      (installedPlugin.version !== options.pluginVersion || !installedPlugin.enabled))
+      ? { ...input, force: true }
+      : input;
   const primaryResult = await installCodexPluginOnce({
-    input,
+    input: effectiveInput,
     command,
     selector,
     args,
@@ -224,7 +264,7 @@ async function installCodexPlugin(
   }
 
   const fallbackResult = await installCodexPluginOnce({
-    input,
+    input: effectiveInput,
     command,
     selector,
     args,
@@ -243,6 +283,33 @@ async function installCodexPlugin(
   };
 }
 
+interface InstalledCodexPlugin {
+  version: string | null;
+  enabled: boolean;
+}
+
+async function readInstalledCodexPlugin(
+  runner: CodexCommandRunner,
+  selector: string,
+): Promise<InstalledCodexPlugin | null> {
+  try {
+    const result = await runner.run("codex", ["plugin", "list", "--json"]);
+    if (result.exitCode !== 0 || result.stdout === undefined) return null;
+    const parsed = JSON.parse(result.stdout) as unknown;
+    const plugins = isRecord(parsed) && Array.isArray(parsed.installed) ? parsed.installed : [];
+    const plugin = plugins.find(
+      (candidate) => isRecord(candidate) && candidate.pluginId === selector,
+    );
+    if (!isRecord(plugin)) return null;
+    return {
+      version: typeof plugin.version === "string" ? plugin.version : null,
+      enabled: plugin.enabled !== false,
+    };
+  } catch {
+    return null;
+  }
+}
+
 async function installCodexPluginOnce(input: {
   input: PluginInstallInput;
   command: string;

package/dist/plugins/evodev/hooks/plugin.ts

@@ -56,6 +56,7 @@ export interface ClaudePluginOptions {
   pluginSelector?: string;
   pluginMarketplaceSource?: string;
   pluginScope?: "user";
+  pluginVersion?: string;
 }
 
 export function createClaudePlugin(options: ClaudePluginOptions = {}): CodeAgentPlugin {
@@ -186,7 +187,12 @@ async function installClaudeCodePlugin(
   input: PluginInstallInput,
   options: Pick<
     ClaudePluginOptions,
-    "commandRunner" | "paths" | "pluginSelector" | "pluginMarketplaceSource" | "pluginScope"
+    | "commandRunner"
+    | "paths"
+    | "pluginSelector"
+    | "pluginMarketplaceSource"
+    | "pluginScope"
+    | "pluginVersion"
   >,
 ): Promise<PluginInstallResult> {
   const command = "claude";
@@ -195,6 +201,42 @@ async function installClaudeCodePlugin(
   const args = ["plugin", "install", selector, "--scope", scope];
   const runner = options.commandRunner ?? new NodeClaudeCommandRunner();
   const warnings: string[] = [];
+  const installedPlugin =
+    input.force === true || options.pluginVersion === undefined
+      ? null
+      : await readInstalledClaudePlugin(runner, selector);
+  let needsRepair = false;
+
+  if (
+    installedPlugin !== null &&
+    installedPlugin.version === options.pluginVersion &&
+    installedPlugin.enabled
+  ) {
+    try {
+      const hydration = await hydrateClaudeWorkspaceCoreDependency({
+        paths: options.paths,
+        selector,
+      });
+      if (hydration.warnings.length === 0 && hydration.errors.length === 0) {
+        return createPluginInstallResult(
+          input.targetPlugin,
+          "already-installed",
+          command,
+          args,
+          `Claude Code plugin ${selector} already matches EvoDev ${options.pluginVersion}; skipped marketplace refresh.`,
+        );
+      }
+    } catch {
+      // Fall through to the normal repair path, which returns a structured install failure.
+    }
+    needsRepair = true;
+  }
+
+  const forceRefresh =
+    input.force === true ||
+    needsRepair ||
+    (installedPlugin !== null &&
+      (installedPlugin.version !== options.pluginVersion || !installedPlugin.enabled));
 
   try {
     if (options.pluginMarketplaceSource !== undefined) {
@@ -244,7 +286,7 @@ async function installClaudeCodePlugin(
       }
     }
 
-    if (input.force === true) {
+    if (forceRefresh) {
       const uninstallArgs = [
         "plugin",
         "uninstall",
@@ -293,7 +335,7 @@ async function installClaudeCodePlugin(
           result.stdout,
           [
             ...warnings,
-            input.force === true
+            forceRefresh
               ? "Claude Code reported the plugin is already installed after forced refresh; check the local plugin cache if changes are not visible."
               : "Claude Code reported the plugin is already installed; if local plugin files changed without a version bump, Claude may keep the existing cached copy. Bump the plugin version or uninstall and reinstall to refresh the cache.",
           ],
@@ -330,6 +372,35 @@ async function installClaudeCodePlugin(
   }
 }
 
+interface InstalledClaudePlugin {
+  version: string | null;
+  enabled: boolean;
+}
+
+async function readInstalledClaudePlugin(
+  runner: ClaudeCommandRunner,
+  selector: string,
+): Promise<InstalledClaudePlugin | null> {
+  try {
+    const result = await runner.run("claude", ["plugin", "list", "--json"]);
+    if (result.exitCode !== 0 || result.stdout === undefined) return null;
+    const parsed = JSON.parse(result.stdout) as unknown;
+    const plugins = Array.isArray(parsed)
+      ? parsed
+      : isRecord(parsed) && Array.isArray(parsed.plugins)
+        ? parsed.plugins
+        : [];
+    const plugin = plugins.find((candidate) => isRecord(candidate) && candidate.id === selector);
+    if (!isRecord(plugin)) return null;
+    return {
+      version: typeof plugin.version === "string" ? plugin.version : null,
+      enabled: plugin.enabled !== false,
+    };
+  } catch {
+    return null;
+  }
+}
+
 function isAlreadyInstalledMessage(message: string | undefined): boolean {
   return message !== undefined && /already\s+installed/i.test(message);
 }
@@ -655,6 +726,10 @@ function isNotDirectoryError(error: unknown): boolean {
   );
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 function describeError(error: unknown): string {
   if (error instanceof Error) {
     return error.message;

package/dist/plugins/evodev/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evo-dev/plugin",
-  "version": "0.0.1-alpha.18",
+  "version": "0.0.1-alpha.19",
   "type": "module",
   "exports": {
     ".": "./hooks/index.ts"