@danieldeusing/seedr 0.1.129 → 0.1.130

package/dist/cli.js

@@ -148,7 +148,7 @@ function isTelemetryDisabled(env = process.env) {
   return env[TELEMETRY_OPT_OUT_VARIABLE] !== void 0;
 }
 function cliVersion() {
-  return true ? "0.1.129" : "dev";
+  return true ? "0.1.130" : "dev";
 }
 async function sendEvent(event) {
   try {
@@ -168,6 +168,36 @@ function trackInstalls(slug, type, results, scope) {
   return Promise.all(sends).then(() => void 0);
 }
 
+// src/utils/ledger.ts
+import { homedir } from "os";
+import { join } from "path";
+var LEDGER_PATH = join(homedir(), ".seedr", "installed.json");
+function ledgerKey(type, slug) {
+  return `${type}:${slug}`;
+}
+async function readLedger() {
+  const ledger = await readJson(LEDGER_PATH);
+  return { version: 1, items: ledger.items ?? {} };
+}
+async function recordInstall(entry) {
+  const ledger = await readLedger();
+  const key = ledgerKey(entry.type, entry.slug);
+  const previous = ledger.items[key];
+  const agents = previous && previous.version === entry.version ? [.../* @__PURE__ */ new Set([...previous.agents, ...entry.agents])].sort() : [...entry.agents].sort();
+  ledger.items[key] = { ...entry, agents };
+  await writeJson(LEDGER_PATH, ledger);
+}
+async function recordRemoval(type, slug, agents) {
+  const ledger = await readLedger();
+  const key = ledgerKey(type, slug);
+  const entry = ledger.items[key];
+  if (!entry) return;
+  const left = entry.agents.filter((agent) => !agents.includes(agent));
+  if (left.length === 0) delete ledger.items[key];
+  else ledger.items[key] = { ...entry, agents: left };
+  await writeJson(LEDGER_PATH, ledger);
+}
+
 // src/config/compatibility.ts
 function filterCompatibleAgents(type, agents) {
   const compatible = AGENT_COMPATIBILITY[type];
@@ -185,8 +215,8 @@ function describeIncompatibility(type, agent) {
 }
 
 // src/handlers/agent.ts
-import { join, relative } from "path";
-import { homedir } from "os";
+import { join as join2, relative } from "path";
+import { homedir as homedir2 } from "os";
 import { lstat, readdir, unlink } from "fs/promises";
 import chalk2 from "chalk";
 import ora from "ora";
@@ -197,7 +227,7 @@ function subagentFileName(agent, slug) {
 async function resolveAgentFilePath(agent, slug, scope, cwd) {
   const destDir = getContentPath(agent, "agent", scope, cwd);
   if (!destDir) return null;
-  const scopeRoot = scope === "user" ? homedir() : cwd;
+  const scopeRoot = scope === "user" ? homedir2() : cwd;
   return resolveContained(scopeRoot, relative(scopeRoot, destDir), subagentFileName(agent, slug));
 }
 async function installAgentForCodingAgent(item, agent, scope, method, force, cwd) {
@@ -212,7 +242,7 @@ async function installAgentForCodingAgent(item, agent, scope, method, force, cwd
     }
     await assertOverwritable(destPath, force);
     const sourcePath = getItemSourcePath(item);
-    const sourceFile = sourcePath ? join(sourcePath, mainFileName("agent")) : null;
+    const sourceFile = sourcePath ? join2(sourcePath, mainFileName("agent")) : null;
     if (method === "symlink" && sourceFile && await exists(sourceFile)) {
       await installFile(sourceFile, destPath, "symlink");
     } else {
@@ -273,12 +303,12 @@ async function planAgent(item, agents, scope, method, cwd) {
     const destPath = await resolveAgentFilePath(agent, item.slug, scope, cwd);
     if (!destPath) throw new Error(`${CODING_AGENTS[agent].name} does not support agents`);
     const sourcePath = getItemSourcePath(item);
-    const linked = method === "symlink" && sourcePath !== null && await exists(join(sourcePath, mainFileName("agent")));
+    const linked = method === "symlink" && sourcePath !== null && await exists(join2(sourcePath, mainFileName("agent")));
     changes.push({
       agent,
       kind: await exists(destPath) ? "modify" : "create",
       path: destPath,
-      detail: linked ? `symlink \u2192 ${join(sourcePath, mainFileName("agent"))}` : "agent definition file"
+      detail: linked ? `symlink \u2192 ${join2(sourcePath, mainFileName("agent"))}` : "agent definition file"
     });
   }
   return changes;
@@ -298,8 +328,8 @@ var agentHandler = {
 };
 
 // src/handlers/command.ts
-import { join as join2, relative as relative2 } from "path";
-import { homedir as homedir2 } from "os";
+import { join as join3, relative as relative2 } from "path";
+import { homedir as homedir3 } from "os";
 import { lstat as lstat2, readdir as readdir2, unlink as unlink2 } from "fs/promises";
 import chalk3 from "chalk";
 import ora2 from "ora";
@@ -307,7 +337,7 @@ var SLUG_LABEL2 = "command slug";
 async function resolveCommandFilePath(agent, slug, scope, cwd) {
   const destDir = getContentPath(agent, "command", scope, cwd);
   if (!destDir) return null;
-  const scopeRoot = scope === "user" ? homedir2() : cwd;
+  const scopeRoot = scope === "user" ? homedir3() : cwd;
   return resolveContained(scopeRoot, relative2(scopeRoot, destDir), `${slug}.md`);
 }
 async function installCommandForCodingAgent(item, agent, scope, method, force, cwd) {
@@ -322,7 +352,7 @@ async function installCommandForCodingAgent(item, agent, scope, method, force, c
     }
     await assertOverwritable(destPath, force);
     const sourcePath = getItemSourcePath(item);
-    const sourceFile = sourcePath ? join2(sourcePath, mainFileName("command")) : null;
+    const sourceFile = sourcePath ? join3(sourcePath, mainFileName("command")) : null;
     if (method === "symlink" && sourceFile && await exists(sourceFile)) {
       await installFile(sourceFile, destPath, "symlink");
     } else {
@@ -382,12 +412,12 @@ async function planCommand(item, agents, scope, method, cwd) {
     const destPath = await resolveCommandFilePath(agent, item.slug, scope, cwd);
     if (!destPath) throw new Error(`${CODING_AGENTS[agent].name} does not support commands`);
     const sourcePath = getItemSourcePath(item);
-    const linked = method === "symlink" && sourcePath !== null && await exists(join2(sourcePath, mainFileName("command")));
+    const linked = method === "symlink" && sourcePath !== null && await exists(join3(sourcePath, mainFileName("command")));
     changes.push({
       agent,
       kind: await exists(destPath) ? "modify" : "create",
       path: destPath,
-      detail: linked ? `symlink \u2192 ${join2(sourcePath, mainFileName("command"))}` : "slash command file"
+      detail: linked ? `symlink \u2192 ${join3(sourcePath, mainFileName("command"))}` : "slash command file"
     });
   }
   return changes;
@@ -407,8 +437,8 @@ var commandHandler = {
 };
 
 // src/handlers/hook.ts
-import { join as join3, basename, dirname } from "path";
-import { homedir as homedir3 } from "os";
+import { join as join4, basename, dirname } from "path";
+import { homedir as homedir4 } from "os";
 import { lstat as lstat3, mkdir, mkdtemp, readFile, realpath, rm, unlink as unlink3 } from "fs/promises";
 import chalk4 from "chalk";
 import ora3 from "ora";
@@ -416,10 +446,10 @@ var CLAUDE_ONLY_ERROR = "Hooks are only supported for Claude Code";
 var SCRIPT_NAME_LABEL = "hook script name";
 var SCRIPT_MODE = 493;
 function getScopeRoot(scope, cwd) {
-  return scope === "user" ? homedir3() : cwd;
+  return scope === "user" ? homedir4() : cwd;
 }
 function getHooksDir(scope, cwd) {
-  return scope === "user" ? join3(claudeUserRoot(), "hooks") : join3(getScopeRoot(scope, cwd), ".claude", "hooks");
+  return scope === "user" ? join4(claudeUserRoot(), "hooks") : join4(getScopeRoot(scope, cwd), ".claude", "hooks");
 }
 function getScriptPath(scope, scriptName) {
   switch (scope) {
@@ -465,13 +495,13 @@ async function assertRegularFileOrMissing(path) {
 async function loadScriptBytes(item, scriptFile, hooksDir) {
   const sourcePath = getItemSourcePath(item);
   if (sourcePath && await exists(sourcePath)) {
-    return readFile(join3(sourcePath, scriptFile));
+    return readFile(join4(sourcePath, scriptFile));
   }
-  const fetchDir = await mkdtemp(join3(dirname(hooksDir), ".seedr-hook-"));
+  const fetchDir = await mkdtemp(join4(dirname(hooksDir), ".seedr-hook-"));
   try {
-    const contentDir = join3(fetchDir, "content");
+    const contentDir = join4(fetchDir, "content");
     await fetchItemToDestination(item, contentDir);
-    return await readFile(join3(contentDir, scriptFile));
+    return await readFile(join4(contentDir, scriptFile));
   } finally {
     await rm(fetchDir, { recursive: true, force: true });
   }
@@ -1219,18 +1249,18 @@ var settingsHandler = {
 };
 
 // src/handlers/plugin.ts
-import { join as join5, relative as relative3 } from "path";
+import { join as join6, relative as relative3 } from "path";
 import { mkdir as mkdir3, mkdtemp as mkdtemp2, rm as rm2, stat } from "fs/promises";
 import chalk7 from "chalk";
 import ora6 from "ora";
 
 // src/handlers/pluginStores.ts
-import { homedir as homedir4 } from "os";
-import { basename as basename2, dirname as dirname3, isAbsolute, join as join4 } from "path";
+import { homedir as homedir5 } from "os";
+import { basename as basename2, dirname as dirname3, isAbsolute, join as join5 } from "path";
 import { mkdir as mkdir2, readFile as readFile3, writeFile } from "fs/promises";
 import { execFile } from "child_process";
 import { promisify } from "util";
-var home = homedir4();
+var home = homedir5();
 var CLAUDE_MANIFEST = ".claude-plugin/plugin.json";
 async function readTextOrEmpty2(path) {
   try {
@@ -1240,7 +1270,7 @@ async function readTextOrEmpty2(path) {
   }
 }
 async function writeText(path, text) {
-  await mkdir2(join4(path, ".."), { recursive: true });
+  await mkdir2(join5(path, ".."), { recursive: true });
   await writeFile(path, text, "utf-8");
 }
 function getPluginId(name, marketplace) {
@@ -1255,8 +1285,8 @@ function manifestsFor(ownManifest) {
   return ownManifest ? [ownManifest, CLAUDE_MANIFEST] : [CLAUDE_MANIFEST];
 }
 var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var CLAUDE_SELF_MARKETPLACE = join4(".claude-plugin", "marketplace.json");
-var COPILOT_SELF_MARKETPLACE = join4(".github", "plugin", "marketplace.json");
+var CLAUDE_SELF_MARKETPLACE = join5(".claude-plugin", "marketplace.json");
+var COPILOT_SELF_MARKETPLACE = join5(".github", "plugin", "marketplace.json");
 async function alignSelfMarketplace(path, marketplace, name, item) {
   const existing = await exists(path) ? await readJson(path) : {};
   const plugins = Array.isArray(existing.plugins) ? existing.plugins : [];
@@ -1272,17 +1302,17 @@ async function alignSelfMarketplace(path, marketplace, name, item) {
   });
 }
 async function ensureSelfMarketplace(contentPath, marketplace, name, item, alsoAlign = []) {
-  await alignSelfMarketplace(join4(contentPath, CLAUDE_SELF_MARKETPLACE), marketplace, name, item);
+  await alignSelfMarketplace(join5(contentPath, CLAUDE_SELF_MARKETPLACE), marketplace, name, item);
   for (const relative4 of alsoAlign) {
-    const path = join4(contentPath, relative4);
+    const path = join5(contentPath, relative4);
     if (await exists(path)) await alignSelfMarketplace(path, marketplace, name, item);
   }
 }
-var CLAUDE_PLUGINS_DIR = join4(claudeUserRoot(), "plugins");
-var CLAUDE_CACHE_DIR = join4(CLAUDE_PLUGINS_DIR, "cache");
-var CLAUDE_INSTALLED_PATH = join4(CLAUDE_PLUGINS_DIR, "installed_plugins.json");
-var CLAUDE_KNOWN_MARKETPLACES_PATH = join4(CLAUDE_PLUGINS_DIR, "known_marketplaces.json");
-var CLAUDE_MARKETPLACES_DIR = join4(CLAUDE_PLUGINS_DIR, "marketplaces");
+var CLAUDE_PLUGINS_DIR = join5(claudeUserRoot(), "plugins");
+var CLAUDE_CACHE_DIR = join5(CLAUDE_PLUGINS_DIR, "cache");
+var CLAUDE_INSTALLED_PATH = join5(CLAUDE_PLUGINS_DIR, "installed_plugins.json");
+var CLAUDE_KNOWN_MARKETPLACES_PATH = join5(CLAUDE_PLUGINS_DIR, "known_marketplaces.json");
+var CLAUDE_MARKETPLACES_DIR = join5(CLAUDE_PLUGINS_DIR, "marketplaces");
 function isScopeEntry(entry, scope, cwd) {
   return entry.scope === scope && (scope === "user" || entry.projectPath === cwd);
 }
@@ -1446,8 +1476,21 @@ var claudeStore = {
   }
 };
 var COPILOT_DIR = copilotUserRoot();
-var COPILOT_SETTINGS_PATH = join4(COPILOT_DIR, "settings.json");
-var COPILOT_PLUGINS_DIR = join4(COPILOT_DIR, "installed-plugins");
+var COPILOT_SETTINGS_PATH = join5(COPILOT_DIR, "settings.json");
+var COPILOT_PLUGINS_DIR = join5(COPILOT_DIR, "installed-plugins");
+var COPILOT_HOOKS_DIR = join5(COPILOT_DIR, "hooks");
+var COPILOT_PLUGIN_HOOKS = join5("hooks", "hooks-copilot.json");
+function copilotHooksPath(name) {
+  return resolveContained(COPILOT_HOOKS_DIR, name, "hooks.json");
+}
+async function writeCopilotHooks(cachePath, name) {
+  const source = join5(cachePath, COPILOT_PLUGIN_HOOKS);
+  if (!await exists(source)) return;
+  const destination = await copilotHooksPath(name);
+  const hooks = (await readFile3(source, "utf8")).replaceAll("${PLUGIN_ROOT}", cachePath);
+  await mkdir2(dirname3(destination), { recursive: true });
+  await writeFile(destination, hooks);
+}
 var copilotStore = {
   manifestPaths: manifestsFor(),
   userGlobal: true,
@@ -1515,7 +1558,14 @@ var copilotStore = {
       path: COPILOT_SETTINGS_PATH,
       detail: `enabledPlugins["${context.pluginId}"] = true`,
       apply: () => enableInJsonSettings(COPILOT_SETTINGS_PATH, context.pluginId)
-    }
+    },
+    ...context.cachePath ? [
+      {
+        path: join5(COPILOT_HOOKS_DIR, context.name, "hooks.json"),
+        detail: `${COPILOT_PLUGIN_HOOKS} with \${PLUGIN_ROOT} resolved \u2014 only when the plugin ships one`,
+        apply: () => writeCopilotHooks(context.cachePath, context.name)
+      }
+    ] : []
   ],
   async listInstalled() {
     const settings = await readJson(COPILOT_SETTINGS_PATH);
@@ -1526,6 +1576,7 @@ var copilotStore = {
     if (!disabled) return false;
     const split = splitPluginId(pluginId);
     if (split) {
+      await removePathEntry(dirname3(await copilotHooksPath(split.name)));
       let tree;
       try {
         tree = await resolveContained(COPILOT_PLUGINS_DIR, split.marketplace, split.name);
@@ -1544,8 +1595,8 @@ var copilotStore = {
   }
 };
 var CODEX_DIR = codexUserRoot();
-var CODEX_CONFIG_PATH = join4(CODEX_DIR, "config.toml");
-var CODEX_CACHE_DIR = join4(CODEX_DIR, "plugins", "cache");
+var CODEX_CONFIG_PATH = join5(CODEX_DIR, "config.toml");
+var CODEX_CACHE_DIR = join5(CODEX_DIR, "plugins", "cache");
 function toCodexMarketplaceTable(marketplace, url, revision) {
   return {
     keyPath: ["marketplaces", marketplace],
@@ -1617,9 +1668,9 @@ var codexStore = {
   }
 };
 function openCodeConfigPath(scope, cwd) {
-  return scope === "user" ? join4(openCodeUserConfigDir(), "opencode.json") : join4(cwd, "opencode.json");
+  return scope === "user" ? join5(openCodeUserConfigDir(), "opencode.json") : join5(cwd, "opencode.json");
 }
-var OPENCODE_PLUGINS_DIR = join4(openCodeUserConfigDir(), "plugins");
+var OPENCODE_PLUGINS_DIR = join5(openCodeUserConfigDir(), "plugins");
 function toOpenCodePluginSpec(item, name, cachePath) {
   if (isFirstParty(item.sourceType)) {
     if (!cachePath) throw new Error(`OpenCode cannot install "${name}": a first-party plugin needs a directory to load from`);
@@ -1691,9 +1742,9 @@ var openCodeStore = {
     return true;
   }
 };
-var GEMINI_CONFIG_DIR = join4(home, ".gemini", "config");
-var GEMINI_PLUGINS_DIR = join4(GEMINI_CONFIG_DIR, "plugins");
-var GEMINI_IMPORT_MANIFEST_PATH = join4(GEMINI_CONFIG_DIR, "import_manifest.json");
+var GEMINI_CONFIG_DIR = join5(home, ".gemini", "config");
+var GEMINI_PLUGINS_DIR = join5(GEMINI_CONFIG_DIR, "plugins");
+var GEMINI_IMPORT_MANIFEST_PATH = join5(GEMINI_CONFIG_DIR, "import_manifest.json");
 var antigravityStore = {
   manifestPaths: manifestsFor(),
   userGlobal: true,
@@ -1715,7 +1766,7 @@ var antigravityStore = {
    * (compound-engineering does) is left exactly as it is.
    */
   async prepareTree(contentPath, { name, version, item }) {
-    const manifestPath = join4(contentPath, "plugin.json");
+    const manifestPath = join5(contentPath, "plugin.json");
     if (await exists(manifestPath)) return;
     await writeJson(manifestPath, {
       name,
@@ -1814,7 +1865,7 @@ function resolvePluginIdentity(item, pluginJson) {
 }
 async function readManifestFromDir(dir, manifestPaths) {
   for (const manifest of manifestPaths) {
-    const path = join5(dir, ...manifest.split("/"));
+    const path = join6(dir, ...manifest.split("/"));
     if (await exists(path)) return readJson(path);
   }
   return {};
@@ -1833,7 +1884,7 @@ async function readManifestForPlan(item, manifestPaths) {
 async function createStagingDir(cacheRoot, slug) {
   const tmpRoot = await resolveContained(cacheRoot, ".tmp");
   await mkdir3(tmpRoot, { recursive: true });
-  const staging = await mkdtemp2(join5(tmpRoot, `${slug}-`));
+  const staging = await mkdtemp2(join6(tmpRoot, `${slug}-`));
   return resolveContained(cacheRoot, relative3(cacheRoot, staging));
 }
 async function stageContent(item, contentPath) {
@@ -1901,7 +1952,7 @@ async function installPluginForAgent(item, agent, scope, _method, force, cwd) {
     const cacheRoot = store.cacheRoot ?? (isFirstParty(item.sourceType) ? store.firstPartyCacheRoot ?? null : null);
     const staging = cacheRoot ? await createStagingDir(cacheRoot, item.slug) : null;
     try {
-      const contentPath = staging ? join5(staging, "content") : null;
+      const contentPath = staging ? join6(staging, "content") : null;
       const fetched = contentPath ? await stageContent(item, contentPath) : null;
       const pluginJson = contentPath ? await readManifestFromDir(contentPath, store.manifestPaths) : await readManifestForPlan(item, store.manifestPaths);
       const { name, version } = resolvePluginIdentity(item, pluginJson);
@@ -1929,7 +1980,7 @@ async function installPluginForAgent(item, agent, scope, _method, force, cwd) {
         ...store.mutations(context)
       ]);
       spinner.succeed(brand(`Installed ${item.name} for ${CODING_AGENTS[agent].name}`));
-      return { agent, success: true, path: cachePath ?? "" };
+      return { agent, success: true, path: cachePath ?? "", version };
     } finally {
       if (staging) await rm2(staging, { recursive: true, force: true });
     }
@@ -2056,35 +2107,35 @@ import chalk8 from "chalk";
 import ora7 from "ora";
 
 // src/handlers/ruleTargets.ts
-import { homedir as homedir5 } from "os";
-import { join as join6 } from "path";
-var home2 = homedir5();
+import { homedir as homedir6 } from "os";
+import { join as join7 } from "path";
+var home2 = homedir6();
 var markdownFile = (slug) => `${slug}.md`;
 var claudeTarget = {
   kind: "file",
-  dir: (scope, cwd) => join6(scope === "user" ? claudeUserRoot() : join6(cwd, ".claude"), "rules"),
+  dir: (scope, cwd) => join7(scope === "user" ? claudeUserRoot() : join7(cwd, ".claude"), "rules"),
   fileName: markdownFile,
   keepsFrontmatter: true
 };
 var antigravityTarget = {
   kind: "file",
-  dir: (scope, cwd) => join6(scope === "user" ? join6(home2, ".gemini", "config") : join6(cwd, ".agents"), "rules"),
+  dir: (scope, cwd) => join7(scope === "user" ? join7(home2, ".gemini", "config") : join7(cwd, ".agents"), "rules"),
   fileName: markdownFile,
   keepsFrontmatter: true
 };
 var copilotTarget = {
   kind: "file",
-  dir: (scope, cwd) => join6(scope === "user" ? copilotUserRoot() : join6(cwd, ".github"), "instructions"),
+  dir: (scope, cwd) => join7(scope === "user" ? copilotUserRoot() : join7(cwd, ".github"), "instructions"),
   fileName: (slug) => `${slug}.instructions.md`,
   keepsFrontmatter: true
 };
 var codexTarget = {
   kind: "section",
-  file: (scope, cwd) => scope === "user" ? join6(codexUserRoot(), "AGENTS.md") : join6(cwd, "AGENTS.md")
+  file: (scope, cwd) => scope === "user" ? join7(codexUserRoot(), "AGENTS.md") : join7(cwd, "AGENTS.md")
 };
 var openCodeTarget = {
   kind: "section",
-  file: (scope, cwd) => scope === "user" ? join6(openCodeUserConfigDir(), "AGENTS.md") : join6(cwd, "AGENTS.md")
+  file: (scope, cwd) => scope === "user" ? join7(openCodeUserConfigDir(), "AGENTS.md") : join7(cwd, "AGENTS.md")
 };
 var TARGETS = {
   claude: claudeTarget,
@@ -2354,6 +2405,24 @@ function formatPlan(changes) {
   }
   return lines;
 }
+async function noteInstall(item, results, scope) {
+  const succeeded = results.filter((r) => r.success);
+  const installed = succeeded.map((r) => r.agent);
+  if (installed.length === 0) return;
+  try {
+    await recordInstall({
+      type: item.type,
+      slug: item.slug,
+      version: succeeded.find((r) => r.version)?.version ?? item.version,
+      contentDigest: item.contentDigest,
+      agents: installed,
+      scope,
+      installedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  } catch (error2) {
+    warn(`Installed, but the install record could not be written: ${error2.message}`);
+  }
+}
 function summarizeResults(results) {
   const successful = results.filter((r) => r.success);
   const failed = results.filter((r) => !r.success);
@@ -2526,6 +2595,7 @@ async function runAdd(name, options, cwd = process.cwd()) {
   console.log();
   const results = await handler.install(item, agents, scope, method, decideForce(options), cwd);
   void trackInstalls(item.slug, item.type, results, scope);
+  await noteInstall(item, results, scope);
   const exitCode = printInstallSummary(results);
   if (exitCode === 0) outro("Installation complete");
   return exitCode;
@@ -2645,11 +2715,37 @@ ${itemType.toUpperCase()}S`));
   );
   return 0;
 }
+async function installedVersionAnnotator() {
+  let ledger;
+  try {
+    ledger = await readLedger();
+  } catch {
+    return () => "";
+  }
+  let current;
+  try {
+    const items = await listItems();
+    current = new Map(
+      items.filter((item) => item.contentDigest).map((item) => [ledgerKey(item.type, item.slug), item.contentDigest])
+    );
+  } catch {
+    current = /* @__PURE__ */ new Map();
+  }
+  return (type, slug) => {
+    const key = ledgerKey(type, slug);
+    const entry = ledger.items[key];
+    if (!entry?.version) return "";
+    const available = current.get(key);
+    const stale = entry.contentDigest && available && available !== entry.contentDigest;
+    return chalk10.gray(` ${entry.version}`) + (stale ? chalk10.yellow(" \u2192 update available") : "");
+  };
+}
 async function listInstalled(params) {
   console.log(brand(`
 Installed items (${params.scope} scope):
 `));
   const groups = await collectInstalledItems(params);
+  const annotate = await installedVersionAnnotator();
   let total = 0;
   let currentType = null;
   for (const group of groups) {
@@ -2660,7 +2756,7 @@ Installed items (${params.scope} scope):
     }
     console.log(chalk10.blue(`  ${CODING_AGENTS[group.agent].name}`));
     for (const slug of group.slugs) {
-      console.log(`    ${chalk10.white(slug)}`);
+      console.log(`    ${chalk10.white(slug)}${annotate(group.type, slug)}`);
       total++;
     }
     console.log("");
@@ -2707,6 +2803,7 @@ async function removeFromAgents(slug, type, agents, scope, cwd) {
   const handler = getHandler(type);
   if (!handler) return 0;
   let successCount = 0;
+  const removedFrom = [];
   for (const agent of agents) {
     if (!isTypeSupported(type, agent)) {
       ora8().start().info(
@@ -2718,11 +2815,18 @@ async function removeFromAgents(slug, type, agents, scope, cwd) {
     const removed = await handler.uninstall(slug, agent, scope, cwd);
     if (removed) {
       spinner.succeed(brand(`Removed from ${CODING_AGENTS[agent].name}`));
+      removedFrom.push(agent);
       successCount++;
     } else {
       spinner.info(chalk11.gray(`Not found in ${CODING_AGENTS[agent].name}`));
     }
   }
+  if (removedFrom.length > 0) {
+    try {
+      await recordRemoval(type, slug, removedFrom);
+    } catch {
+    }
+  }
   return successCount;
 }
 function validateRemoveRequest(name, options) {
@@ -2815,7 +2919,7 @@ var removeCommand = new Command3("remove").alias("rm").description("Remove an in
 import { Command as Command4 } from "commander";
 import chalk12 from "chalk";
 import ora9 from "ora";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 function readmeFor(agent) {
   return `# ${CODING_AGENTS[agent].name} Configuration
 
@@ -2833,7 +2937,7 @@ async function initializeAgent(agent, cwd) {
   const path = getAgentPath(agent, "project", cwd);
   if (await exists(path)) return false;
   await ensureDir(path);
-  await writeTextFile(join7(path, "README.md"), readmeFor(agent));
+  await writeTextFile(join8(path, "README.md"), readmeFor(agent));
   return true;
 }
 async function runInit(options, cwd = process.cwd()) {
@@ -2894,7 +2998,7 @@ var initCommand = new Command4("init").description("Initialize coding agent conf
 // package.json
 var package_default = {
   name: "@danieldeusing/seedr",
-  version: "0.1.129",
+  version: "0.1.130",
   description: "Seed your projects with AI configurations",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -72,6 +72,13 @@ interface InstallResult {
     success: boolean;
     path: string;
     error?: string;
+    /**
+     * The version that landed, when it differs from the registry item's own.
+     * A plugin carries its version in its manifest and the registry item carries
+     * a separate one for the catalogue entry — recording the item's would say
+     * "1.0.20" for a plugin every agent knows as 0.16.2.
+     */
+    version?: string;
 }
 
 declare function installSkill(item: RegistryItem, agents: CodingAgent[], scope: InstallScope, method: InstallMethod, force: boolean, cwd?: string): Promise<InstallResult[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danieldeusing/seedr",
-  "version": "0.1.129",
+  "version": "0.1.130",
   "description": "Seed your projects with AI configurations",
   "type": "module",
   "bin": {