joist-codegen 2.3.0-next.16 → 2.3.0-next.17

package/build/installSkills.d.ts

@@ -1,8 +1,12 @@
 /**
  * Copies Joist's bundled Agent Skills into the project so coding agents can
- * discover them.
+ * discover them, then prunes any previously-installed Joist skills that no
+ * longer ship with this version.
  *
  * The skills are framework-owned and rewritten on every codegen run, so users
  * should not hand-edit them (re-run codegen to pick up new Joist versions).
+ *
+ * Logs only what actually changed: the added and removed skill names, staying
+ * quiet when nothing changed.
  */
 export declare function installSkills(rootDir?: string): Promise<void>;

package/build/installSkills.js

@@ -12,26 +12,58 @@ const bundledSkillsDir = (0, path_1.resolve)(__dirname, "../skills");
  * by Codex (and opencode), so writing both gives native coverage across all three.
  */
 const skillTargets = [".claude/skills", ".agents/skills"];
+/** Joist owns the `joist-` skill namespace, so stale ones there are ours to prune. */
+const skillPrefix = "joist-";
 /**
  * Copies Joist's bundled Agent Skills into the project so coding agents can
- * discover them.
+ * discover them, then prunes any previously-installed Joist skills that no
+ * longer ship with this version.
  *
  * The skills are framework-owned and rewritten on every codegen run, so users
  * should not hand-edit them (re-run codegen to pick up new Joist versions).
+ *
+ * Logs only what actually changed: the added and removed skill names, staying
+ * quiet when nothing changed.
  */
 async function installSkills(rootDir = ".") {
-    let skillNames;
+    const bundled = await readSkillNames(bundledSkillsDir);
+    if (bundled.length === 0)
+        return;
+    const bundledSet = new Set(bundled);
+    // Snapshot what each target already has before we copy/remove, so we can diff.
+    const existingPerTarget = await Promise.all(skillTargets.map((target) => readSkillNames((0, path_1.join)(rootDir, target))));
+    // Always `cp` the bundled skills into each target, overwriting any existing ones
+    await Promise.all(skillTargets.flatMap((target) => bundled.map((name) => fs_1.promises.cp((0, path_1.join)(bundledSkillsDir, name), (0, path_1.join)(rootDir, target, name), { recursive: true, force: true }))));
+    // Prune stale Joist skills (previously installed here, but no longer bundled).
+    const removed = new Set();
+    await Promise.all(skillTargets.map(async (target, i) => {
+        const stale = existingPerTarget[i].filter((name) => name.startsWith(skillPrefix) && !bundledSet.has(name));
+        await Promise.all(stale.map(async (name) => {
+            removed.add(name);
+            await fs_1.promises.rm((0, path_1.join)(rootDir, target, name), { recursive: true, force: true });
+        }));
+    }));
+    // A skill is "new" if it was missing from at least one target before this run.
+    const added = bundled.filter((name) => existingPerTarget.some((names) => !names.includes(name)));
+    if (added.length > 0) {
+        console.log(`Added ${added.length} Joist skill(s) to ${skillTargets.join(" and ")}:`);
+        for (const name of added)
+            console.log(`  + ${name}`);
+    }
+    if (removed.size > 0) {
+        console.log(`Removed ${removed.size} stale Joist skill(s) from ${skillTargets.join(" and ")}:`);
+        for (const name of removed)
+            console.log(`  - ${name}`);
+    }
+}
+/** Lists the skill directory names in a dir, or `[]` if it's missing. I.e. ["joist-upsert", ...]. */
+async function readSkillNames(dir) {
     try {
-        const entries = await fs_1.promises.readdir(bundledSkillsDir, { withFileTypes: true });
-        skillNames = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+        const entries = await fs_1.promises.readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
     }
     catch {
-        // The bundled skills are missing (e.g. running against an unbuilt package); nothing to do.
-        return;
+        return [];
     }
-    if (skillNames.length === 0)
-        return;
-    await Promise.all(skillTargets.flatMap((target) => skillNames.map((name) => fs_1.promises.cp((0, path_1.join)(bundledSkillsDir, name), (0, path_1.join)(rootDir, target, name), { recursive: true, force: true }))));
-    console.log(`Installed ${skillNames.length} Joist skill(s) into ${skillTargets.join(" and ")}`);
 }
 //# sourceMappingURL=installSkills.js.map

package/build/installSkills.js.map

@@ -1 +1 @@
-{"version":3,"file":"installSkills.js","sourceRoot":"","sources":["../src/installSkills.ts"],"names":[],"mappings":";;AAqBA,sCAoBC;AAzCD,2BAAoC;AACpC,+BAAqC;AAErC,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAE1D;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CAAC,UAAkB,GAAG;IACvD,IAAI,UAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,2FAA2F;QAC3F,OAAO;IACT,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEpC,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAC9B,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,aAAE,CAAC,EAAE,CAAC,IAAA,WAAI,EAAC,gBAAgB,EAAE,IAAI,CAAC,EAAE,IAAA,WAAI,EAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CACnG,CACF,CACF,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,aAAa,UAAU,CAAC,MAAM,wBAAwB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC"}
+{"version":3,"file":"installSkills.js","sourceRoot":"","sources":["../src/installSkills.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joist-codegen",
-  "version": "2.3.0-next.16",
+  "version": "2.3.0-next.17",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -18,7 +18,7 @@
     "skills"
   ],
   "peerDependencies": {
-    "joist-utils": "2.3.0-next.16",
+    "joist-utils": "2.3.0-next.17",
     "knex": "^3.1.0",
     "pg": "^8.22.0"
   },