dev3000 0.0.144 → 0.0.146

package/dist/skills/index.js

@@ -0,0 +1,185 @@
+/**
+ * Shared skill module for d3k
+ *
+ * Skills are prompt templates stored as SKILL.md files that provide
+ * specialized instructions for specific tasks.
+ *
+ * This module is used by both:
+ * - CLI: `d3k skill <name>`
+ * - MCP: `get_skill` tool
+ */
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+/**
+ * Get the base directories where skills can be found.
+ * Searches in order of priority:
+ * 1. Project-local skills (.claude/skills/)
+ * 2. Source skills (src/skills/) - for development
+ * 3. Dist skills (dist/skills/) - for installed packages
+ */
+export function getSkillDirectories(cwd) {
+    const dirs = [];
+    // 1. Project-local skills (highest priority)
+    const projectDir = cwd || process.cwd();
+    dirs.push(join(projectDir, ".claude", "skills"));
+    // 2. Check if we're running from a compiled binary (bun compile)
+    // In compiled binaries, import.meta.url returns /$bunfs/... virtual path
+    // We detect this by checking if the URL starts with /$bunfs
+    const moduleUrl = import.meta.url;
+    const isCompiledBinary = moduleUrl.startsWith("file:///$bunfs") || moduleUrl.startsWith("/$bunfs");
+    if (isCompiledBinary) {
+        // For compiled binaries, process.execPath contains the actual binary path
+        const binaryPath = process.execPath;
+        if (binaryPath && existsSync(binaryPath)) {
+            const binDir = dirname(binaryPath); // bin/
+            const packageDir = dirname(binDir); // platform package root (e.g., @d3k/darwin-arm64)
+            dirs.push(join(packageDir, "skills"));
+        }
+    }
+    // 3. Source and dist skills from the d3k package
+    // Handle both ESM (__dirname equivalent) and different execution contexts
+    try {
+        const currentFile = fileURLToPath(import.meta.url);
+        const srcDir = dirname(currentFile); // src/skills
+        const packageRoot = dirname(dirname(srcDir)); // package root
+        // Source skills (for development)
+        dirs.push(join(packageRoot, "src", "skills"));
+        // Dist skills (for installed package)
+        dirs.push(join(packageRoot, "dist", "skills"));
+        // Also check if we're in a binary distribution
+        dirs.push(join(packageRoot, "skills"));
+    }
+    catch {
+        // Fallback for CommonJS or other contexts
+    }
+    return dirs.filter((dir) => existsSync(dir));
+}
+/**
+ * Find a skill by name.
+ * Returns the path to the SKILL.md file if found.
+ */
+export function findSkill(name, cwd) {
+    const skillDirs = getSkillDirectories(cwd);
+    for (const dir of skillDirs) {
+        const skillPath = join(dir, name, "SKILL.md");
+        if (existsSync(skillPath)) {
+            return skillPath;
+        }
+    }
+    return null;
+}
+/**
+ * Get the content of a skill by name.
+ */
+export function getSkill(name, cwd) {
+    const skillPath = findSkill(name, cwd);
+    if (skillPath) {
+        try {
+            const content = readFileSync(skillPath, "utf-8");
+            return {
+                found: true,
+                name,
+                content,
+                path: skillPath
+            };
+        }
+        catch (error) {
+            return {
+                found: false,
+                name,
+                error: `Failed to read skill: ${error instanceof Error ? error.message : String(error)}`,
+                availableSkills: listAvailableSkills(cwd)
+            };
+        }
+    }
+    return {
+        found: false,
+        name,
+        error: `Skill "${name}" not found`,
+        availableSkills: listAvailableSkills(cwd)
+    };
+}
+/**
+ * List all available skills.
+ */
+export function listAvailableSkills(cwd) {
+    const skills = new Set();
+    const skillDirs = getSkillDirectories(cwd);
+    for (const dir of skillDirs) {
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const skillFile = join(dir, entry.name, "SKILL.md");
+                    if (existsSync(skillFile)) {
+                        skills.add(entry.name);
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory might not exist or be readable
+        }
+    }
+    return Array.from(skills).sort();
+}
+/**
+ * Get detailed info about all available skills.
+ */
+export function getSkillsInfo(cwd) {
+    const skillsMap = new Map();
+    const skillDirs = getSkillDirectories(cwd);
+    for (const dir of skillDirs) {
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && !skillsMap.has(entry.name)) {
+                    const skillPath = join(dir, entry.name, "SKILL.md");
+                    if (existsSync(skillPath)) {
+                        try {
+                            const content = readFileSync(skillPath, "utf-8");
+                            const description = extractDescription(content);
+                            skillsMap.set(entry.name, {
+                                name: entry.name,
+                                description,
+                                path: skillPath
+                            });
+                        }
+                        catch {
+                            // Skip unreadable skills
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory might not exist or be readable
+        }
+    }
+    return Array.from(skillsMap.values()).sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Extract description from SKILL.md frontmatter or first paragraph.
+ */
+function extractDescription(content) {
+    // Try to extract from YAML frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (frontmatterMatch) {
+        const frontmatter = frontmatterMatch[1];
+        const descMatch = frontmatter.match(/description:\s*(.+)/);
+        if (descMatch) {
+            return descMatch[1].trim();
+        }
+    }
+    // Fallback: use first non-heading, non-empty line
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith("#") && !trimmed.startsWith("---")) {
+            return trimmed.slice(0, 100) + (trimmed.length > 100 ? "..." : "");
+        }
+    }
+    return "No description available";
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/index.test.ts

@@ -0,0 +1,218 @@
+import { existsSync, readdirSync, readFileSync } from "fs"
+import { beforeEach, describe, expect, it, vi } from "vitest"
+import { findSkill, getSkill, getSkillDirectories, getSkillsInfo, listAvailableSkills, type SkillResult } from "./index"
+
+// Mock fs module
+vi.mock("fs", () => ({
+  existsSync: vi.fn(),
+  readdirSync: vi.fn(),
+  readFileSync: vi.fn()
+}))
+
+describe("skills module", () => {
+  const mockExistsSync = existsSync as unknown as ReturnType<typeof vi.fn>
+  const mockReaddirSync = readdirSync as unknown as ReturnType<typeof vi.fn>
+  const mockReadFileSync = readFileSync as unknown as ReturnType<typeof vi.fn>
+
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  describe("getSkillDirectories", () => {
+    it("should return directories that exist", () => {
+      // At minimum, should return project-local .claude/skills if it exists
+      mockExistsSync.mockImplementation((path: string) => {
+        return path.includes(".claude/skills") || path.includes("src/skills")
+      })
+
+      const dirs = getSkillDirectories("/test/project")
+      expect(dirs.length).toBeGreaterThan(0)
+    })
+
+    it("should include project-local skills directory", () => {
+      mockExistsSync.mockReturnValue(true)
+
+      const dirs = getSkillDirectories("/test/project")
+      const hasProjectLocal = dirs.some((d) => d.includes(".claude/skills"))
+      expect(hasProjectLocal).toBe(true)
+    })
+  })
+
+  describe("findSkill", () => {
+    it("should find a skill in the first matching directory", () => {
+      // Mock: directory exists AND skill file exists
+      mockExistsSync.mockImplementation((path: string) => {
+        // Return true for both the directory check and the SKILL.md file check
+        return path.includes(".claude/skills") || path.includes("src/skills") || path.includes("test-skill/SKILL.md")
+      })
+
+      const result = findSkill("test-skill", "/test/project")
+      expect(result).toBeTruthy()
+      expect(result).toContain("test-skill/SKILL.md")
+    })
+
+    it("should return null if skill not found", () => {
+      mockExistsSync.mockReturnValue(false)
+
+      const result = findSkill("nonexistent-skill", "/test/project")
+      expect(result).toBeNull()
+    })
+  })
+
+  describe("getSkill", () => {
+    it("should return skill content when found", () => {
+      const skillContent = `---
+description: Test skill description
+---
+
+# Test Skill
+
+This is test content.`
+
+      // Mock: directory exists AND skill file exists
+      mockExistsSync.mockImplementation((path: string) => {
+        return path.includes(".claude/skills") || path.includes("src/skills") || path.includes("test-skill/SKILL.md")
+      })
+      mockReadFileSync.mockReturnValue(skillContent)
+
+      const result: SkillResult = getSkill("test-skill", "/test/project")
+      expect(result.found).toBe(true)
+      expect(result.name).toBe("test-skill")
+      expect(result.content).toBe(skillContent)
+      expect(result.path).toBeTruthy()
+    })
+
+    it("should return error when skill not found", () => {
+      mockExistsSync.mockReturnValue(false)
+      mockReaddirSync.mockReturnValue([])
+
+      const result: SkillResult = getSkill("nonexistent", "/test/project")
+      expect(result.found).toBe(false)
+      expect(result.error).toContain("not found")
+      expect(result.availableSkills).toBeDefined()
+    })
+
+    it("should handle read errors gracefully", () => {
+      // Mock: directory and file exist but read fails
+      mockExistsSync.mockImplementation((path: string) => {
+        return path.includes(".claude/skills") || path.includes("src/skills") || path.includes("error-skill/SKILL.md")
+      })
+      mockReadFileSync.mockImplementation(() => {
+        throw new Error("Permission denied")
+      })
+      mockReaddirSync.mockReturnValue([])
+
+      const result: SkillResult = getSkill("error-skill", "/test/project")
+      expect(result.found).toBe(false)
+      expect(result.error).toContain("Failed to read skill")
+    })
+  })
+
+  describe("listAvailableSkills", () => {
+    it("should list skills from all directories", () => {
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation((dir: string) => {
+        if (dir.includes(".claude/skills")) {
+          return [
+            { name: "skill-a", isDirectory: () => true },
+            { name: "skill-b", isDirectory: () => true }
+          ]
+        }
+        if (dir.includes("src/skills")) {
+          return [
+            { name: "skill-c", isDirectory: () => true },
+            { name: "not-a-skill.txt", isDirectory: () => false }
+          ]
+        }
+        return []
+      })
+
+      const skills = listAvailableSkills("/test/project")
+      expect(skills).toContain("skill-a")
+      expect(skills).toContain("skill-b")
+      expect(skills).toContain("skill-c")
+      expect(skills).not.toContain("not-a-skill.txt")
+    })
+
+    it("should deduplicate skills across directories", () => {
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation(() => [{ name: "same-skill", isDirectory: () => true }])
+
+      const skills = listAvailableSkills("/test/project")
+      const sameSkillCount = skills.filter((s) => s === "same-skill").length
+      expect(sameSkillCount).toBe(1)
+    })
+
+    it("should return sorted list", () => {
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation(() => [
+        { name: "zebra", isDirectory: () => true },
+        { name: "alpha", isDirectory: () => true },
+        { name: "beta", isDirectory: () => true }
+      ])
+
+      const skills = listAvailableSkills("/test/project")
+      expect(skills).toEqual(["alpha", "beta", "zebra"])
+    })
+
+    it("should handle directory read errors gracefully", () => {
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation(() => {
+        throw new Error("Permission denied")
+      })
+
+      const skills = listAvailableSkills("/test/project")
+      expect(skills).toEqual([])
+    })
+  })
+
+  describe("getSkillsInfo", () => {
+    it("should return detailed skill info with descriptions", () => {
+      const skillContent = `---
+description: A helpful skill for testing
+---
+
+# Test Skill`
+
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation(() => [{ name: "test-skill", isDirectory: () => true }])
+      mockReadFileSync.mockReturnValue(skillContent)
+
+      const skills = getSkillsInfo("/test/project")
+      expect(skills.length).toBeGreaterThan(0)
+      expect(skills[0].name).toBe("test-skill")
+      expect(skills[0].description).toBe("A helpful skill for testing")
+      expect(skills[0].path).toBeTruthy()
+    })
+
+    it("should extract description from first paragraph if no frontmatter", () => {
+      const skillContent = `# Test Skill
+
+This is the first paragraph that should be used as description.
+
+More content here.`
+
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation(() => [{ name: "test-skill", isDirectory: () => true }])
+      mockReadFileSync.mockReturnValue(skillContent)
+
+      const skills = getSkillsInfo("/test/project")
+      expect(skills[0].description).toContain("This is the first paragraph")
+    })
+
+    it("should truncate long descriptions", () => {
+      const longDescription = "A".repeat(150)
+      const skillContent = `---
+description: ${longDescription}
+---`
+
+      mockExistsSync.mockReturnValue(true)
+      mockReaddirSync.mockImplementation(() => [{ name: "test-skill", isDirectory: () => true }])
+      mockReadFileSync.mockReturnValue(skillContent)
+
+      const skills = getSkillsInfo("/test/project")
+      // The frontmatter description isn't truncated, only first-paragraph fallback is
+      expect(skills[0].description).toBe(longDescription)
+    })
+  })
+})

package/dist/skills/index.ts

@@ -0,0 +1,219 @@
+/**
+ * Shared skill module for d3k
+ *
+ * Skills are prompt templates stored as SKILL.md files that provide
+ * specialized instructions for specific tasks.
+ *
+ * This module is used by both:
+ * - CLI: `d3k skill <name>`
+ * - MCP: `get_skill` tool
+ */
+
+import { existsSync, readdirSync, readFileSync } from "fs"
+import { dirname, join } from "path"
+import { fileURLToPath } from "url"
+
+export interface SkillInfo {
+  name: string
+  description: string
+  path: string
+}
+
+export interface SkillResult {
+  found: boolean
+  name: string
+  content?: string
+  path?: string
+  error?: string
+  availableSkills?: string[]
+}
+
+/**
+ * Get the base directories where skills can be found.
+ * Searches in order of priority:
+ * 1. Project-local skills (.claude/skills/)
+ * 2. Source skills (src/skills/) - for development
+ * 3. Dist skills (dist/skills/) - for installed packages
+ */
+export function getSkillDirectories(cwd?: string): string[] {
+  const dirs: string[] = []
+
+  // 1. Project-local skills (highest priority)
+  const projectDir = cwd || process.cwd()
+  dirs.push(join(projectDir, ".claude", "skills"))
+
+  // 2. Check if we're running from a compiled binary (bun compile)
+  // In compiled binaries, import.meta.url returns /$bunfs/... virtual path
+  // We detect this by checking if the URL starts with /$bunfs
+  const moduleUrl = import.meta.url
+  const isCompiledBinary = moduleUrl.startsWith("file:///$bunfs") || moduleUrl.startsWith("/$bunfs")
+
+  if (isCompiledBinary) {
+    // For compiled binaries, process.execPath contains the actual binary path
+    const binaryPath = process.execPath
+    if (binaryPath && existsSync(binaryPath)) {
+      const binDir = dirname(binaryPath) // bin/
+      const packageDir = dirname(binDir) // platform package root (e.g., @d3k/darwin-arm64)
+      dirs.push(join(packageDir, "skills"))
+    }
+  }
+
+  // 3. Source and dist skills from the d3k package
+  // Handle both ESM (__dirname equivalent) and different execution contexts
+  try {
+    const currentFile = fileURLToPath(import.meta.url)
+    const srcDir = dirname(currentFile) // src/skills
+    const packageRoot = dirname(dirname(srcDir)) // package root
+
+    // Source skills (for development)
+    dirs.push(join(packageRoot, "src", "skills"))
+
+    // Dist skills (for installed package)
+    dirs.push(join(packageRoot, "dist", "skills"))
+
+    // Also check if we're in a binary distribution
+    dirs.push(join(packageRoot, "skills"))
+  } catch {
+    // Fallback for CommonJS or other contexts
+  }
+
+  return dirs.filter((dir) => existsSync(dir))
+}
+
+/**
+ * Find a skill by name.
+ * Returns the path to the SKILL.md file if found.
+ */
+export function findSkill(name: string, cwd?: string): string | null {
+  const skillDirs = getSkillDirectories(cwd)
+
+  for (const dir of skillDirs) {
+    const skillPath = join(dir, name, "SKILL.md")
+    if (existsSync(skillPath)) {
+      return skillPath
+    }
+  }
+
+  return null
+}
+
+/**
+ * Get the content of a skill by name.
+ */
+export function getSkill(name: string, cwd?: string): SkillResult {
+  const skillPath = findSkill(name, cwd)
+
+  if (skillPath) {
+    try {
+      const content = readFileSync(skillPath, "utf-8")
+      return {
+        found: true,
+        name,
+        content,
+        path: skillPath
+      }
+    } catch (error) {
+      return {
+        found: false,
+        name,
+        error: `Failed to read skill: ${error instanceof Error ? error.message : String(error)}`,
+        availableSkills: listAvailableSkills(cwd)
+      }
+    }
+  }
+
+  return {
+    found: false,
+    name,
+    error: `Skill "${name}" not found`,
+    availableSkills: listAvailableSkills(cwd)
+  }
+}
+
+/**
+ * List all available skills.
+ */
+export function listAvailableSkills(cwd?: string): string[] {
+  const skills = new Set<string>()
+  const skillDirs = getSkillDirectories(cwd)
+
+  for (const dir of skillDirs) {
+    try {
+      const entries = readdirSync(dir, { withFileTypes: true })
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          const skillFile = join(dir, entry.name, "SKILL.md")
+          if (existsSync(skillFile)) {
+            skills.add(entry.name)
+          }
+        }
+      }
+    } catch {
+      // Directory might not exist or be readable
+    }
+  }
+
+  return Array.from(skills).sort()
+}
+
+/**
+ * Get detailed info about all available skills.
+ */
+export function getSkillsInfo(cwd?: string): SkillInfo[] {
+  const skillsMap = new Map<string, SkillInfo>()
+  const skillDirs = getSkillDirectories(cwd)
+
+  for (const dir of skillDirs) {
+    try {
+      const entries = readdirSync(dir, { withFileTypes: true })
+      for (const entry of entries) {
+        if (entry.isDirectory() && !skillsMap.has(entry.name)) {
+          const skillPath = join(dir, entry.name, "SKILL.md")
+          if (existsSync(skillPath)) {
+            try {
+              const content = readFileSync(skillPath, "utf-8")
+              const description = extractDescription(content)
+              skillsMap.set(entry.name, {
+                name: entry.name,
+                description,
+                path: skillPath
+              })
+            } catch {
+              // Skip unreadable skills
+            }
+          }
+        }
+      }
+    } catch {
+      // Directory might not exist or be readable
+    }
+  }
+
+  return Array.from(skillsMap.values()).sort((a, b) => a.name.localeCompare(b.name))
+}
+
+/**
+ * Extract description from SKILL.md frontmatter or first paragraph.
+ */
+function extractDescription(content: string): string {
+  // Try to extract from YAML frontmatter
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/)
+  if (frontmatterMatch) {
+    const frontmatter = frontmatterMatch[1]
+    const descMatch = frontmatter.match(/description:\s*(.+)/)
+    if (descMatch) {
+      return descMatch[1].trim()
+    }
+  }
+
+  // Fallback: use first non-heading, non-empty line
+  const lines = content.split("\n")
+  for (const line of lines) {
+    const trimmed = line.trim()
+    if (trimmed && !trimmed.startsWith("#") && !trimmed.startsWith("---")) {
+      return trimmed.slice(0, 100) + (trimmed.length > 100 ? "..." : "")
+    }
+  }
+
+  return "No description available"
+}