@skillsmith/core 0.1.0

package/dist/src/sources/LocalFilesystemAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalFilesystemAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/LocalFilesystemAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAcnB;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAoBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,gBAAgB,CAAwB;gBAEpC,MAAM,EAAE,qBAAqB;IAQzC;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAItD;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAe/D;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkC5E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBxE;;OAEG;IACY,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAM/B;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;YACW,aAAa;IAuD3B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;YACW,iBAAiB;IA6C/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,sBAAsB,CAMxB"}

package/dist/src/sources/LocalFilesystemAdapter.js

@@ -0,0 +1,340 @@
+/**
+ * Local Filesystem Source Adapter (SMI-591)
+ *
+ * Scans local directories for SKILL.md files.
+ * Useful for local development and testing.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import { createHash } from 'crypto';
+import { promises as fs } from 'fs';
+import { join, basename, dirname, relative, resolve } from 'path';
+import { createLogger } from '../utils/logger.js';
+import { validatePath, safePatternMatch } from '../validation/index.js';
+const log = createLogger('LocalFilesystemAdapter');
+/**
+ * Default skill file names to search for
+ */
+const SKILL_FILE_NAMES = ['SKILL.md', 'skill.md'];
+/**
+ * Local Filesystem Source Adapter
+ *
+ * Scans local directories to discover and index skills.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new LocalFilesystemAdapter({
+ *   id: 'local-skills',
+ *   name: 'Local Skills',
+ *   type: 'local',
+ *   baseUrl: 'file://',
+ *   enabled: true,
+ *   rootDir: '/home/user/.claude/skills'
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({})
+ * ```
+ */
+export class LocalFilesystemAdapter extends BaseSourceAdapter {
+    rootDir;
+    maxDepth;
+    excludePatterns;
+    followSymlinks;
+    discoveredSkills = [];
+    constructor(config) {
+        super(config);
+        this.rootDir = config.rootDir;
+        this.maxDepth = config.maxDepth ?? 5;
+        this.excludePatterns = config.excludePatterns ?? ['node_modules', '.git', '.svn', 'dist'];
+        this.followSymlinks = config.followSymlinks ?? false;
+    }
+    /**
+     * Initialize by scanning the filesystem
+     */
+    async doInitialize() {
+        await this.scanDirectory(this.rootDir, 0);
+    }
+    /**
+     * Check if root directory exists and is accessible
+     */
+    async doHealthCheck() {
+        try {
+            const stats = await fs.stat(this.rootDir);
+            return {
+                healthy: stats.isDirectory(),
+                error: stats.isDirectory() ? undefined : 'Root path is not a directory',
+            };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                error: error instanceof Error ? error.message : 'Directory not accessible',
+            };
+        }
+    }
+    /**
+     * Search for skills in the scanned directories
+     */
+    async search(options = {}) {
+        // Re-scan if needed
+        if (this.discoveredSkills.length === 0) {
+            await this.scanDirectory(this.rootDir, 0);
+        }
+        let filtered = [...this.discoveredSkills];
+        // Filter by query (search in path/directory name)
+        if (options.query) {
+            const query = options.query.toLowerCase();
+            filtered = filtered.filter((skill) => skill.relativePath.toLowerCase().includes(query) ||
+                skill.directory.toLowerCase().includes(query));
+        }
+        // Apply limit
+        const limit = options.limit ?? 100;
+        const limitedResults = filtered.slice(0, limit);
+        // Convert to SourceRepository format
+        const repositories = await Promise.all(limitedResults.map((skill) => this.skillToRepository(skill)));
+        return {
+            repositories,
+            totalCount: filtered.length,
+            hasMore: filtered.length > limit,
+        };
+    }
+    /**
+     * Get repository info for a skill location
+     */
+    async getRepository(location) {
+        const skillPath = this.resolveSkillPath(location);
+        const skill = this.discoveredSkills.find((s) => s.path === skillPath);
+        if (skill) {
+            return this.skillToRepository(skill);
+        }
+        // Try to get info even if not in discovered list
+        try {
+            const stats = await fs.stat(skillPath);
+            return {
+                id: this.generateId(skillPath),
+                name: basename(dirname(skillPath)),
+                url: `file://${skillPath}`,
+                description: null,
+                owner: 'local',
+                defaultBranch: 'main',
+                stars: 0,
+                forks: 0,
+                topics: ['local'],
+                updatedAt: stats.mtime.toISOString(),
+                createdAt: stats.ctime.toISOString(),
+                license: null,
+                metadata: {
+                    sourceType: 'local',
+                    path: skillPath,
+                },
+            };
+        }
+        catch (error) {
+            throw new Error(`Skill not found at ${skillPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Fetch skill content from local file
+     */
+    async fetchSkillContent(location) {
+        const skillPath = this.resolveSkillPath(location);
+        try {
+            const rawContent = await fs.readFile(skillPath, 'utf-8');
+            const stats = await fs.stat(skillPath);
+            const sha = this.generateSha(rawContent);
+            return {
+                rawContent,
+                sha,
+                location,
+                filePath: skillPath,
+                encoding: 'utf-8',
+                lastModified: stats.mtime.toISOString(),
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to read skill file at ${skillPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Check if skill exists at location
+     */
+    async skillExists(location) {
+        const skillPath = this.resolveSkillPath(location);
+        try {
+            await fs.access(skillPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Rescan the filesystem for new skills
+     */
+    async rescan() {
+        this.discoveredSkills = [];
+        await this.scanDirectory(this.rootDir, 0);
+        return this.discoveredSkills.length;
+    }
+    /**
+     * Get count of discovered skills
+     */
+    get skillCount() {
+        return this.discoveredSkills.length;
+    }
+    /**
+     * Scan a directory recursively for skill files
+     */
+    async scanDirectory(dirPath, depth) {
+        if (depth > this.maxDepth)
+            return;
+        try {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dirPath, entry.name);
+                // Skip excluded patterns
+                if (this.isExcluded(entry.name))
+                    continue;
+                // Handle symlinks
+                let isDirectory = entry.isDirectory();
+                let isFile = entry.isFile();
+                if (entry.isSymbolicLink()) {
+                    if (!this.followSymlinks)
+                        continue;
+                    try {
+                        const stats = await fs.stat(fullPath);
+                        isDirectory = stats.isDirectory();
+                        isFile = stats.isFile();
+                    }
+                    catch {
+                        continue; // Skip broken symlinks
+                    }
+                }
+                // Check for skill files
+                if (isFile && SKILL_FILE_NAMES.includes(entry.name)) {
+                    const stats = await fs.stat(fullPath);
+                    this.discoveredSkills.push({
+                        path: fullPath,
+                        relativePath: relative(this.rootDir, fullPath),
+                        directory: dirname(fullPath),
+                        stats: {
+                            size: stats.size,
+                            mtime: stats.mtime,
+                            ctime: stats.ctime,
+                        },
+                    });
+                }
+                // Recurse into directories
+                if (isDirectory) {
+                    await this.scanDirectory(fullPath, depth + 1);
+                }
+            }
+        }
+        catch (error) {
+            // Ignore permission errors and continue scanning
+            if (error.code !== 'EACCES') {
+                log.warn(`Error scanning directory ${dirPath}: ${error}`);
+            }
+        }
+    }
+    /**
+     * Check if a path/name should be excluded (SMI-722, SMI-726)
+     * Uses centralized safe pattern matching to prevent RegExp injection
+     */
+    isExcluded(name) {
+        return this.excludePatterns.some((pattern) => safePatternMatch(name, pattern));
+    }
+    /**
+     * Resolve a skill location to a full filesystem path
+     * Validates that the resolved path remains within rootDir to prevent path traversal attacks (SMI-720, SMI-726)
+     */
+    resolveSkillPath(location) {
+        let resolvedPath;
+        if (location.path?.startsWith('/')) {
+            resolvedPath = location.path;
+        }
+        else if (location.path) {
+            resolvedPath = join(this.rootDir, location.path);
+        }
+        else if (location.owner && location.repo) {
+            resolvedPath = join(this.rootDir, location.owner, location.repo, 'SKILL.md');
+        }
+        else if (location.repo) {
+            resolvedPath = join(this.rootDir, location.repo, 'SKILL.md');
+        }
+        else {
+            throw new Error('Invalid location: must specify path or repo');
+        }
+        // Use centralized path validation to prevent path traversal attacks
+        validatePath(resolvedPath, this.rootDir);
+        return resolve(resolvedPath);
+    }
+    /**
+     * Convert discovered skill to SourceRepository
+     */
+    async skillToRepository(skill) {
+        const dirName = basename(skill.directory);
+        // Try to extract metadata from the skill file
+        let description = null;
+        let name = dirName;
+        try {
+            const content = await fs.readFile(skill.path, 'utf-8');
+            // Try to extract name from frontmatter
+            const nameMatch = content.match(/^---[\s\S]*?name:\s*["']?([^"'\n]+)["']?/m);
+            if (nameMatch) {
+                name = nameMatch[1].trim();
+            }
+            // Try to extract description from frontmatter
+            const descMatch = content.match(/^---[\s\S]*?description:\s*["']?([^"'\n]+)["']?/m);
+            if (descMatch) {
+                description = descMatch[1].trim();
+            }
+        }
+        catch {
+            // Use defaults
+        }
+        return {
+            id: this.generateId(skill.path),
+            name,
+            url: `file://${skill.path}`,
+            description,
+            owner: 'local',
+            defaultBranch: 'main',
+            stars: 0,
+            forks: 0,
+            topics: ['local'],
+            updatedAt: skill.stats.mtime.toISOString(),
+            createdAt: skill.stats.ctime.toISOString(),
+            license: null,
+            metadata: {
+                sourceType: 'local',
+                path: skill.path,
+                relativePath: skill.relativePath,
+                size: skill.stats.size,
+            },
+        };
+    }
+    /**
+     * Generate a deterministic ID from a path
+     */
+    generateId(path) {
+        return createHash('sha256').update(path).digest('hex').slice(0, 16);
+    }
+    /**
+     * Generate SHA hash for content
+     */
+    generateSha(content) {
+        return createHash('sha256').update(content).digest('hex');
+    }
+}
+/**
+ * Factory function for creating local filesystem adapters
+ */
+export function createLocalFilesystemAdapter(config) {
+    return new LocalFilesystemAdapter({
+        ...config,
+        type: 'local',
+        baseUrl: config.baseUrl ?? 'file://',
+    });
+}
+//# sourceMappingURL=LocalFilesystemAdapter.js.map

package/dist/src/sources/LocalFilesystemAdapter.js.map

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

package/dist/src/sources/RawUrlSourceAdapter.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Raw URL Source Adapter (SMI-591)
+ *
+ * Fetches skills from arbitrary HTTP/HTTPS URLs.
+ * Useful for custom registries or standalone skill files.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
+/**
+ * Registry entry for a skill URL
+ */
+export interface SkillUrlEntry {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Full URL to the SKILL.md file */
+    url: string;
+    /** Optional description */
+    description?: string;
+    /** Optional author */
+    author?: string;
+    /** Optional tags for searching */
+    tags?: string[];
+}
+/**
+ * Configuration for Raw URL adapter
+ */
+export interface RawUrlSourceConfig extends SourceConfig {
+    /** Predefined list of skill URLs to index */
+    skillUrls?: SkillUrlEntry[];
+    /** URL to a JSON registry file containing skill entries */
+    registryUrl?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Raw URL Source Adapter
+ *
+ * Fetches skill files from arbitrary HTTP/HTTPS URLs.
+ * Can work with:
+ * - A predefined list of skill URLs
+ * - A JSON registry file containing skill entries
+ * - Direct URL locations
+ *
+ * @example
+ * ```typescript
+ * const adapter = new RawUrlSourceAdapter({
+ *   id: 'custom-registry',
+ *   name: 'Custom Registry',
+ *   type: 'raw-url',
+ *   baseUrl: 'https://example.com',
+ *   enabled: true,
+ *   skillUrls: [
+ *     { id: '1', name: 'My Skill', url: 'https://example.com/skill.md' }
+ *   ]
+ * })
+ *
+ * await adapter.initialize()
+ * const content = await adapter.fetchSkillContent({
+ *   owner: 'example.com',
+ *   repo: 'my-skill',
+ *   path: 'https://example.com/skill.md'
+ * })
+ * ```
+ */
+export declare class RawUrlSourceAdapter extends BaseSourceAdapter {
+    private skillUrls;
+    private readonly timeout;
+    constructor(config: RawUrlSourceConfig);
+    /**
+     * Initialize adapter - load registry if configured
+     */
+    protected doInitialize(): Promise<void>;
+    /**
+     * Load skill entries from a remote JSON registry
+     */
+    private loadRegistry;
+    /**
+     * Check if the source is reachable
+     */
+    protected doHealthCheck(): Promise<Partial<SourceHealth>>;
+    /**
+     * Search for skills in the configured registry
+     */
+    search(options?: SourceSearchOptions): Promise<SourceSearchResult>;
+    /**
+     * Get repository (skill entry) by location
+     */
+    getRepository(location: SourceLocation): Promise<SourceRepository>;
+    /**
+     * Fetch skill content from a URL
+     */
+    fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
+    /**
+     * Add a skill URL to the registry
+     */
+    addSkillUrl(entry: SkillUrlEntry): void;
+    /**
+     * Remove a skill URL from the registry
+     */
+    removeSkillUrl(id: string): boolean;
+    /**
+     * Get all registered skill URLs
+     */
+    getSkillUrls(): SkillUrlEntry[];
+    /**
+     * Convert a registry entry to SourceRepository
+     */
+    private entryToRepository;
+    /**
+     * Fetch with timeout
+     */
+    private fetchWithTimeout;
+    /**
+     * Generate a deterministic ID from a URL
+     */
+    private generateId;
+    /**
+     * Generate SHA hash for content
+     */
+    private generateSha;
+}
+/**
+ * Factory function for creating Raw URL adapters
+ */
+export declare function createRawUrlAdapter(config: RawUrlSourceConfig): RawUrlSourceAdapter;
+//# sourceMappingURL=RawUrlSourceAdapter.d.ts.map

package/dist/src/sources/RawUrlSourceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawUrlSourceAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/RawUrlSourceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAQnB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,6CAA6C;IAC7C,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;IAC3B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;gBAEpB,MAAM,EAAE,kBAAkB;IAMtC;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;YACW,YAAY;IAwB1B;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAgB/D;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuC5E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAyCxE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASnC;;OAEG;IACH,YAAY,IAAI,aAAa,EAAE;IAI/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,mBAAmB,CAKnF"}