yeknal 1.3.3 → 1.4.0

package/README.md

@@ -41,7 +41,7 @@ Behavior:
 - If GitHub API rate limit is hit, it automatically falls back to `git clone` (Git must be installed).
 - Top-level folders are included only if they contain `SKILL.md`.
 - Installs each synced skill with a `yeknal-` folder prefix, for example `taste-skill` installs as `yeknal-taste-skill`.
-- Only the matching `yeknal-*` managed destination folders are overwritten during sync.
+- Matching `yeknal-*` managed destination folders are overwritten during sync, and stale `yeknal-*` folders removed from an earlier repository version are cleaned up. Unprefixed personal skill folders are never touched.
 - Sync targets (if parent folder exists):
 - Gemini: `~/.gemini/antigravity` or `~/.antigravity`
 - Codex: `~/.codex`

package/bin/yeknal.js

@@ -195,6 +195,26 @@ async function copyDirRecursive(sourceDir, targetDir) {
   }
 }
 
+async function removeStaleManagedSkillFolders(skillsPath, expectedFolders) {
+  const entries = await fsp.readdir(skillsPath, { withFileTypes: true });
+  const removed = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory() || !entry.name.startsWith(MANAGED_SKILL_FOLDER_PREFIX)) {
+      continue;
+    }
+
+    if (expectedFolders.has(entry.name)) {
+      continue;
+    }
+
+    await fsp.rm(path.join(skillsPath, entry.name), { recursive: true, force: true });
+    removed.push(entry.name);
+  }
+
+  return removed;
+}
+
 function execCommand(command, options = {}) {
   return new Promise((resolve, reject) => {
     exec(command, options, (error, stdout, stderr) => {
@@ -408,6 +428,17 @@ async function runSkillsCommand() {
       try {
         await fsp.mkdir(target.skillsPath, { recursive: true });
         let copiedCount = 0;
+        const expectedFolders = new Set(
+          skillFolders.map((folder) => getManagedSkillFolderName(folder)),
+        );
+        const removedFolders = await removeStaleManagedSkillFolders(
+          target.skillsPath,
+          expectedFolders,
+        );
+
+        for (const removedFolder of removedFolders) {
+          console.log(`  [removed] ${target.label}: stale managed skill ${removedFolder}`);
+        }
 
         for (const folder of skillFolders) {
           const sourceFolder = path.join(tempRoot, folder);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yeknal",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "CLI to fetch markdown templates and sync AI agent skills",
   "main": "bin/yeknal.js",
   "bin": {