@meistrari/tela-cli 1.10.0 → 1.10.1

package/dist/commands/skills.js

@@ -196,22 +196,24 @@ async function upgradeSkills(args, options, io) {
         getClient: async () => (await (0, session_1.loadPantry)(flags)).client,
         onDiagnostic: diagnostic => writeSkillManagerDiagnostic(io, diagnostic),
     });
-    const { upgraded, unchanged } = await manager.upgradeSkills(flags.rest, {
+    const { upgraded, unchanged, replaced } = await manager.upgradeSkills(flags.rest, {
         force: flags.force,
         ignoreScripts: flags.ignoreScripts,
         ...(flags.symlink ? {} : { targets: [] }),
     });
-    if (upgraded.length === 0 && unchanged.length === 0) {
+    if (upgraded.length === 0 && unchanged.length === 0 && replaced.length === 0) {
         if (options.json)
-            (0, output_1.writeJson)(io, { upgraded: [], unchanged: [] });
+            (0, output_1.writeJson)(io, { upgraded: [], unchanged: [], replaced: [] });
         else
             (0, output_1.writeLine)(io, 'No skills installed.');
         return 0;
     }
     if (options.json) {
-        (0, output_1.writeJson)(io, { upgraded, unchanged });
+        (0, output_1.writeJson)(io, { upgraded, unchanged, replaced });
         return 0;
     }
+    for (const { from, to } of replaced)
+        (0, output_1.writeLine)(io, `Replaced deprecated ${from} with ${to.slug} at ${to.sha.slice(0, 7)}`);
     for (const entry of upgraded)
         (0, output_1.writeLine)(io, `Upgraded ${entry.slug} to ${entry.sha.slice(0, 7)}`);
     for (const slug of unchanged)

package/dist/index.js

@@ -77216,6 +77216,7 @@ var require_skills = __commonJS({
             name: ingredient.name,
             description: ingredient.description,
             status: ingredient.status,
+            replacement: ingredient.replacement,
             // A listing carries the skill-only fields under `skillDetails`,
             // which is null for anything Pantry has not synced as a skill.
             bundle: ingredient.skillDetails?.bundle ?? null,
@@ -77338,13 +77339,42 @@ Run \`tela skills install ${slug} --force\` to replace it, or remove it by hand.
           const diagnostics = [];
           const upgraded = [];
           const unchanged = [];
+          const replaced = [];
           const emit = createDiagnosticEmitter(options2, diagnostics);
           if (selected.length === 0)
-            return { upgraded, unchanged, diagnostics };
+            return { upgraded, unchanged, replaced, diagnostics };
           const targets = normalizeTargets(upgradeOptions.targets ?? paths.targets, paths.installRoot);
           const client = await resolveClient();
           for (const current of selected) {
-            const { snapshot } = await (0, skills_1.fetchSkillFile)(client, current.slug);
+            const { ingredient, snapshot } = await (0, skills_1.fetchSkillFile)(client, current.slug);
+            const replacementSlug = await resolveReplacementSlug(client, current.slug, ingredient);
+            if (replacementSlug) {
+              const installedReplacement = (await (0, tela_local_config_1.listInstalledSkills)(inventoryFile)).find((entry2) => entry2.slug === replacementSlug);
+              const replacement = await installOne({
+                client,
+                diagnostics: emit,
+                ...installedReplacement ? { expectedCurrent: installedReplacement, operation: "upgrade" } : {},
+                force: upgradeOptions.force ?? false,
+                ignoreScripts: upgradeOptions.ignoreScripts ?? false,
+                inventoryFile,
+                paths,
+                slug: replacementSlug,
+                targets
+              });
+              if (!replacement)
+                continue;
+              if (await uninstallOne({
+                diagnostics: emit,
+                entry: current,
+                ignoreScripts: upgradeOptions.ignoreScripts ?? false,
+                inventoryFile,
+                operation: "upgrade",
+                paths
+              })) {
+                replaced.push({ from: current.slug, to: replacement });
+              }
+              continue;
+            }
             if (snapshot.sha === current.sha) {
               unchanged.push(current.slug);
               continue;
@@ -77364,7 +77394,7 @@ Run \`tela skills install ${slug} --force\` to replace it, or remove it by hand.
             if (entry)
               upgraded.push(entry);
           }
-          return { upgraded, unchanged, diagnostics };
+          return { upgraded, unchanged, replaced, diagnostics };
         },
         uninstallSkills: async (slugs, uninstallOptions = {}) => {
           for (const slug of slugs)
@@ -77375,44 +77405,77 @@ Run \`tela skills install ${slug} --force\` to replace it, or remove it by hand.
           const removed = [];
           const emit = createDiagnosticEmitter(options2, diagnostics);
           for (const entry of selected) {
-            assertManagedInstallDir(entry.slug, entry, paths);
-            await runLifecycle(entry, "uninstall", uninstallOptions.ignoreScripts ?? false, emit);
-            let gone = false;
-            await (0, tela_local_config_1.updateInstalledSkill)(entry.slug, async (registered) => {
-              if (registered === null)
-                return null;
-              if (!isSameInstall(registered, entry)) {
-                emit({
-                  type: "concurrent-change",
-                  slug: entry.slug,
-                  operation: "uninstall",
-                  message: `Skipped ${entry.slug}: it was reinstalled while this uninstall ran`
-                });
-                return registered;
-              }
-              assertManagedInstallDir(entry.slug, registered, paths);
-              for (const linkPath of registered.symlinks) {
-                const outcome = await (0, skill_filesystem_1.removeManagedSymlink)(linkPath, registered.dir);
-                if (outcome.reason) {
-                  emit({
-                    type: "link-removal-skipped",
-                    slug: entry.slug,
-                    path: linkPath,
-                    message: outcome.reason
-                  });
-                }
-              }
-              await (0, promises_1.rm)(registered.dir, { recursive: true, force: true });
-              gone = true;
-              return null;
-            }, inventoryFile);
-            if (gone)
+            if (await uninstallOne({
+              diagnostics: emit,
+              entry,
+              ignoreScripts: uninstallOptions.ignoreScripts ?? false,
+              inventoryFile,
+              operation: "uninstall",
+              paths
+            })) {
               removed.push(entry.slug);
+            }
           }
           return { removed, diagnostics };
         }
       };
     }
+    var MAX_REPLACEMENT_HOPS = 5;
+    async function resolveReplacementSlug(client, slug, ingredient) {
+      let replacement = deprecatedReplacement(ingredient);
+      if (!replacement)
+        return null;
+      const visited = /* @__PURE__ */ new Set([slug]);
+      for (let hop = 0; hop < MAX_REPLACEMENT_HOPS; hop++) {
+        (0, skill_filesystem_1.assertSafeSlug)(replacement, "upgrade");
+        if (visited.has(replacement))
+          throw new Error(`Pantry replacements for ${slug} form a cycle through ${replacement}.`);
+        visited.add(replacement);
+        const next = deprecatedReplacement((await (0, skills_1.fetchSkillFile)(client, replacement)).ingredient);
+        if (!next)
+          return replacement;
+        replacement = next;
+      }
+      throw new Error(`Pantry replacements for ${slug} chain through more than ${MAX_REPLACEMENT_HOPS} deprecated skills.`);
+    }
+    function deprecatedReplacement(ingredient) {
+      return ingredient.status === "deprecated" && ingredient.replacement ? ingredient.replacement : null;
+    }
+    async function uninstallOne(options2) {
+      const { entry, paths } = options2;
+      assertManagedInstallDir(entry.slug, entry, paths);
+      await runLifecycle(entry, "uninstall", options2.ignoreScripts, options2.diagnostics);
+      let gone = false;
+      await (0, tela_local_config_1.updateInstalledSkill)(entry.slug, async (registered) => {
+        if (registered === null)
+          return null;
+        if (!isSameInstall(registered, entry)) {
+          options2.diagnostics({
+            type: "concurrent-change",
+            slug: entry.slug,
+            operation: options2.operation,
+            message: `Skipped ${entry.slug}: it was reinstalled while this ${options2.operation} ran`
+          });
+          return registered;
+        }
+        assertManagedInstallDir(entry.slug, registered, paths);
+        for (const linkPath of registered.symlinks) {
+          const outcome = await (0, skill_filesystem_1.removeManagedSymlink)(linkPath, registered.dir);
+          if (outcome.reason) {
+            options2.diagnostics({
+              type: "link-removal-skipped",
+              slug: entry.slug,
+              path: linkPath,
+              message: outcome.reason
+            });
+          }
+        }
+        await (0, promises_1.rm)(registered.dir, { recursive: true, force: true });
+        gone = true;
+        return null;
+      }, options2.inventoryFile);
+      return gone;
+    }
     function createDiagnosticEmitter(options2, diagnostics) {
       return (diagnostic) => {
         diagnostics.push(diagnostic);
@@ -389037,22 +389100,24 @@ async function upgradeSkills(args, options2, io) {
     getClient: async () => (await loadPantry(flags)).client,
     onDiagnostic: (diagnostic) => writeSkillManagerDiagnostic(io, diagnostic)
   });
-  const { upgraded, unchanged } = await manager.upgradeSkills(flags.rest, {
+  const { upgraded, unchanged, replaced } = await manager.upgradeSkills(flags.rest, {
     force: flags.force,
     ignoreScripts: flags.ignoreScripts,
     ...flags.symlink ? {} : { targets: [] }
   });
-  if (upgraded.length === 0 && unchanged.length === 0) {
+  if (upgraded.length === 0 && unchanged.length === 0 && replaced.length === 0) {
     if (options2.json)
-      writeJson(io, { upgraded: [], unchanged: [] });
+      writeJson(io, { upgraded: [], unchanged: [], replaced: [] });
     else
       writeLine(io, "No skills installed.");
     return 0;
   }
   if (options2.json) {
-    writeJson(io, { upgraded, unchanged });
+    writeJson(io, { upgraded, unchanged, replaced });
     return 0;
   }
+  for (const { from, to } of replaced)
+    writeLine(io, `Replaced deprecated ${from} with ${to.slug} at ${to.sha.slice(0, 7)}`);
   for (const entry of upgraded)
     writeLine(io, `Upgraded ${entry.slug} to ${entry.sha.slice(0, 7)}`);
   for (const slug of unchanged)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/tela-cli",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Tela command line tools for local state and agent workflows.",
   "engines": {
     "node": ">=22"