@pi-stef/superpowers-adapter 0.3.4 → 0.3.7

package/README.md

@@ -64,6 +64,9 @@ Load skill instructions by name. Discovers skills from standard pi skill directo
 - `<cwd>/.agents/skills/`
 - `~/.pi/agent/skills/`
 - `~/.agents/skills/`
+- Workspace packages: `<cwd>/packages/<pkg>/skills/`
+- Locally installed packages: `<cwd>/node_modules/<pkg>/skills/` (any scope)
+- Globally installed packages: `~/.pi/agent/npm/node_modules/<pkg>/skills/` (any scope)
 - Recursively under `~/.pi/agent/git/` (depth 10)
 
 **Limitation:** The YAML frontmatter parser handles simple `key: value` pairs only. Nested values, multi-line values, and quoted strings with complex escaping are not supported.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-stef/superpowers-adapter",
-  "version": "0.3.4",
+  "version": "0.3.7",
   "description": "Bridges the superpowers skill system to pi's extension API with TodoWrite, Task, and Skill tools.",
   "keywords": [
     "pi-package",

package/src/tools/skill.ts

@@ -94,11 +94,54 @@ function findSkillsDirs(
   }
 }
 
-export function discoverSkills(cwd: string): Map<string, SkillMeta> {
+/**
+ * Collect `skills/` directories from a node_modules layout.
+ * Handles scoped (@scope/pkg) and unscoped (pkg) packages.
+ */
+function collectNodeModulesSkillPaths(
+  nodeModulesDir: string,
+  skillPaths: string[],
+): void {
+  if (!existsSync(nodeModulesDir)) return;
+  let entries;
+  try {
+    entries = readdirSync(nodeModulesDir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name.startsWith("@")) {
+      // Scope directory: iterate packages one level deeper.
+      const scopeDir = join(nodeModulesDir, entry.name);
+      let scopedEntries;
+      try {
+        scopedEntries = readdirSync(scopeDir, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const pkg of scopedEntries) {
+        if (!pkg.isDirectory()) continue;
+        const pkgSkillsDir = join(scopeDir, pkg.name, "skills");
+        if (existsSync(pkgSkillsDir)) {
+          skillPaths.push(pkgSkillsDir);
+        }
+      }
+    } else {
+      // Unscoped package directory.
+      const pkgSkillsDir = join(nodeModulesDir, entry.name, "skills");
+      if (existsSync(pkgSkillsDir)) {
+        skillPaths.push(pkgSkillsDir);
+      }
+    }
+  }
+}
+
+export function discoverSkills(cwd: string, homeDir?: string): Map<string, SkillMeta> {
   if (skillCache) return skillCache;
 
   const skills = new Map<string, SkillMeta>();
-  const home = homedir();
+  const home = homeDir ?? homedir();
 
   const skillPaths = [
     join(cwd, ".pi", "skills"),
@@ -107,6 +150,34 @@ export function discoverSkills(cwd: string): Map<string, SkillMeta> {
     join(home, ".agents", "skills"),
   ];
 
+  // Add workspace package skills (monorepo pattern)
+  const packagesDir = join(cwd, "packages");
+  if (existsSync(packagesDir)) {
+    try {
+      const packages = readdirSync(packagesDir, { withFileTypes: true });
+      for (const pkg of packages) {
+        if (pkg.isDirectory()) {
+          const pkgSkillsDir = join(packagesDir, pkg.name, "skills");
+          if (existsSync(pkgSkillsDir)) {
+            skillPaths.push(pkgSkillsDir);
+          }
+        }
+      }
+    } catch {
+      // Skip if can't read packages directory
+    }
+  }
+
+  // Add locally installed package skills (node_modules pattern), any scope.
+  collectNodeModulesSkillPaths(join(cwd, "node_modules"), skillPaths);
+
+  // Add globally installed package skills (~/.pi/agent/npm/node_modules pattern).
+  // This is where `pi install`/catalog packages live on consumer machines.
+  collectNodeModulesSkillPaths(
+    join(home, ".pi", "agent", "npm", "node_modules"),
+    skillPaths,
+  );
+
   const gitPackagesDir = join(home, ".pi", "agent", "git");
   if (existsSync(gitPackagesDir)) {
     findSkillsDirs(gitPackagesDir, skillPaths);