@skillsmith/core 0.1.0

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

@@ -0,0 +1,102 @@
+/**
+ * GitLab Source Adapter (SMI-591)
+ *
+ * Implements the ISourceAdapter interface for GitLab repositories.
+ * Provides search, repository metadata, and skill content fetching.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
+/**
+ * GitLab Source Adapter
+ *
+ * Connects to GitLab API to search for and fetch skill repositories.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitLabSourceAdapter({
+ *   id: 'gitlab',
+ *   name: 'GitLab',
+ *   type: 'gitlab',
+ *   baseUrl: 'https://gitlab.com/api/v4',
+ *   enabled: true,
+ *   auth: {
+ *     type: 'token',
+ *     credentials: process.env.GITLAB_TOKEN
+ *   }
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export declare class GitLabSourceAdapter extends BaseSourceAdapter {
+    private readonly apiBaseUrl;
+    constructor(config: SourceConfig);
+    /**
+     * Validate API access on initialization
+     */
+    protected doInitialize(): Promise<void>;
+    /**
+     * Check GitLab API health
+     */
+    protected doHealthCheck(): Promise<Partial<SourceHealth>>;
+    /**
+     * Search GitLab for skill repositories
+     */
+    search(options?: SourceSearchOptions): Promise<SourceSearchResult>;
+    /**
+     * Get repository metadata by location
+     */
+    getRepository(location: SourceLocation): Promise<SourceRepository>;
+    /**
+     * Fetch skill content from repository
+     */
+    fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
+    /**
+     * Check if skill file exists
+     */
+    skillExists(location: SourceLocation): Promise<boolean>;
+    /**
+     * Get skill file SHA for change detection
+     */
+    getSkillSha(location: SourceLocation): Promise<string | null>;
+    /**
+     * Paginated search with page number
+     */
+    searchWithCursor(options: SourceSearchOptions, page: number): Promise<SourceSearchResult>;
+    /**
+     * Map GitLab API project to SourceRepository
+     */
+    private mapApiProject;
+}
+/**
+ * Configuration for createGitLabAdapter factory
+ */
+export interface GitLabAdapterConfig {
+    /** Unique identifier for this source instance */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Whether this source is enabled */
+    enabled: boolean;
+    /** Base URL for API requests (default: https://gitlab.com/api/v4) */
+    baseUrl?: string;
+    /** Rate limiting configuration */
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+        minDelayMs: number;
+    };
+    /** Authentication configuration */
+    auth?: {
+        type: 'token' | 'basic' | 'oauth' | 'none';
+        credentials?: string;
+    };
+    /** Additional source-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Factory function for creating GitLab adapters
+ */
+export declare function createGitLabAdapter(config: GitLabAdapterConfig): GitLabSourceAdapter;
+//# sourceMappingURL=GitLabSourceAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GitLabSourceAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/GitLabSourceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAQ1D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAoDnB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,MAAM,EAAE,YAAY;IAMhC;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAuB/D;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkD5E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCxE;;OAEG;IACY,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBtE;;OAEG;IACY,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwB5E;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoD/F;;OAEG;IACH,OAAO,CAAC,aAAa;CAsBtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,SAAS,CAAC,EAAE;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAMpF"}

package/dist/src/sources/GitLabSourceAdapter.js

@@ -0,0 +1,310 @@
+/**
+ * GitLab Source Adapter (SMI-591)
+ *
+ * Implements the ISourceAdapter interface for GitLab repositories.
+ * Provides search, repository metadata, and skill content fetching.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import { validateUrl } from '../validation/index.js';
+import { decodeBase64Content, isRateLimitStatus, SKILL_FILE_PATHS as SHARED_SKILL_FILE_PATHS, } from './shared.js';
+import { ApiError } from '../errors/SkillsmithError.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('GitLabAdapter');
+/**
+ * Default topics to search for skill repositories
+ */
+const DEFAULT_TOPICS = ['claude-code-skill', 'claude-code', 'claude-skill'];
+/**
+ * Default skill file paths to check (use shared paths, SMI-879)
+ */
+const SKILL_FILE_PATHS = SHARED_SKILL_FILE_PATHS;
+/**
+ * GitLab Source Adapter
+ *
+ * Connects to GitLab API to search for and fetch skill repositories.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitLabSourceAdapter({
+ *   id: 'gitlab',
+ *   name: 'GitLab',
+ *   type: 'gitlab',
+ *   baseUrl: 'https://gitlab.com/api/v4',
+ *   enabled: true,
+ *   auth: {
+ *     type: 'token',
+ *     credentials: process.env.GITLAB_TOKEN
+ *   }
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export class GitLabSourceAdapter extends BaseSourceAdapter {
+    apiBaseUrl;
+    constructor(config) {
+        super(config);
+        this.apiBaseUrl = config.baseUrl || 'https://gitlab.com/api/v4';
+        validateUrl(this.apiBaseUrl);
+    }
+    /**
+     * Validate API access on initialization
+     */
+    async doInitialize() {
+        // Validate API access on initialization
+        const health = await this.doHealthCheck();
+        if (!health.healthy) {
+            log.warn(`API health check warning: ${health.error ?? 'unknown issue'}`);
+        }
+    }
+    /**
+     * Check GitLab API health
+     */
+    async doHealthCheck() {
+        const response = await this.fetchWithRateLimit(`${this.apiBaseUrl}/version`);
+        if (!response.ok) {
+            return {
+                healthy: false,
+                error: `GitLab API returned ${response.status}`,
+            };
+        }
+        // Check rate limit headers
+        const rateLimitRemaining = response.headers.get('ratelimit-remaining');
+        const rateLimitReset = response.headers.get('ratelimit-reset');
+        return {
+            healthy: true,
+            rateLimitRemaining: rateLimitRemaining ? parseInt(rateLimitRemaining, 10) : undefined,
+            rateLimitReset: rateLimitReset
+                ? new Date(parseInt(rateLimitReset, 10) * 1000).toISOString()
+                : undefined,
+        };
+    }
+    /**
+     * Search GitLab for skill repositories
+     */
+    async search(options = {}) {
+        await this.waitForRateLimit();
+        const topics = options.topics ?? DEFAULT_TOPICS;
+        const limit = options.limit ?? 100;
+        const perPage = Math.min(limit, 100);
+        // Build search URL - GitLab uses separate topic parameter
+        const params = new URLSearchParams({
+            per_page: String(perPage),
+            order_by: 'last_activity_at',
+            sort: 'desc',
+            topics: topics.join(','),
+        });
+        if (options.query) {
+            params.set('search', options.query);
+        }
+        const url = `${this.apiBaseUrl}/projects?${params}`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (isRateLimitStatus(response.status)) {
+                throw new ApiError('GitLab API rate limit exceeded', {
+                    statusCode: response.status,
+                    url,
+                });
+            }
+            throw new ApiError(`GitLab API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        const repositories = data.map((item) => this.mapApiProject(item));
+        // Check pagination headers
+        const totalHeader = response.headers.get('x-total');
+        const totalCount = totalHeader ? parseInt(totalHeader, 10) : data.length;
+        return {
+            repositories,
+            totalCount,
+            hasMore: totalCount > perPage,
+            nextCursor: perPage < totalCount ? '2' : undefined,
+        };
+    }
+    /**
+     * Get repository metadata by location
+     */
+    async getRepository(location) {
+        await this.waitForRateLimit();
+        const projectPath = encodeURIComponent(`${location.owner}/${location.repo}`);
+        const url = `${this.apiBaseUrl}/projects/${projectPath}`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new ApiError(`Repository not found: ${location.owner}/${location.repo}`, {
+                    statusCode: 404,
+                    url,
+                });
+            }
+            throw new ApiError(`GitLab API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        return this.mapApiProject(data);
+    }
+    /**
+     * Fetch skill content from repository
+     */
+    async fetchSkillContent(location) {
+        await this.waitForRateLimit();
+        const branch = this.getDefaultBranch(location);
+        const paths = location.path ? [location.path] : SKILL_FILE_PATHS;
+        const projectPath = encodeURIComponent(`${location.owner}/${location.repo}`);
+        // Try each possible skill file path
+        for (const path of paths) {
+            try {
+                const filePath = encodeURIComponent(path);
+                const url = `${this.apiBaseUrl}/projects/${projectPath}/repository/files/${filePath}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                if (response.ok) {
+                    const data = (await response.json());
+                    // SMI-879: Use shared decodeBase64Content utility
+                    const rawContent = decodeBase64Content(data.content, data.encoding);
+                    return {
+                        rawContent,
+                        sha: data.content_sha256,
+                        location,
+                        filePath: data.file_path,
+                        encoding: 'utf-8',
+                    };
+                }
+            }
+            catch {
+                // Try next path
+                continue;
+            }
+        }
+        throw new Error(`No skill file found in ${location.owner}/${location.repo}. Searched: ${paths.join(', ')}`);
+    }
+    /**
+     * Check if skill file exists
+     */
+    async skillExists(location) {
+        const paths = location.path ? [location.path] : SKILL_FILE_PATHS;
+        const branch = this.getDefaultBranch(location);
+        const projectPath = encodeURIComponent(`${location.owner}/${location.repo}`);
+        for (const path of paths) {
+            try {
+                await this.waitForRateLimit();
+                const filePath = encodeURIComponent(path);
+                const url = `${this.apiBaseUrl}/projects/${projectPath}/repository/files/${filePath}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url, { method: 'HEAD' });
+                if (response.ok) {
+                    return true;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get skill file SHA for change detection
+     */
+    async getSkillSha(location) {
+        const paths = location.path ? [location.path] : SKILL_FILE_PATHS;
+        const branch = this.getDefaultBranch(location);
+        const projectPath = encodeURIComponent(`${location.owner}/${location.repo}`);
+        for (const path of paths) {
+            try {
+                await this.waitForRateLimit();
+                const filePath = encodeURIComponent(path);
+                const url = `${this.apiBaseUrl}/projects/${projectPath}/repository/files/${filePath}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                if (response.ok) {
+                    const data = (await response.json());
+                    return data.content_sha256;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    /**
+     * Paginated search with page number
+     */
+    async searchWithCursor(options, page) {
+        await this.waitForRateLimit();
+        const topics = options.topics ?? DEFAULT_TOPICS;
+        const perPage = Math.min(options.limit ?? 30, 100);
+        const params = new URLSearchParams({
+            per_page: String(perPage),
+            page: String(page),
+            order_by: 'last_activity_at',
+            sort: 'desc',
+            topics: topics.join(','),
+        });
+        if (options.query) {
+            params.set('search', options.query);
+        }
+        const url = `${this.apiBaseUrl}/projects?${params}`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (isRateLimitStatus(response.status)) {
+                throw new ApiError('GitLab API rate limit exceeded', {
+                    statusCode: response.status,
+                    url,
+                });
+            }
+            throw new ApiError(`GitLab API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        const repositories = data.map((item) => this.mapApiProject(item));
+        const totalHeader = response.headers.get('x-total');
+        const totalPagesHeader = response.headers.get('x-total-pages');
+        const totalCount = totalHeader ? parseInt(totalHeader, 10) : data.length;
+        const totalPages = totalPagesHeader ? parseInt(totalPagesHeader, 10) : 1;
+        const hasMore = page < totalPages;
+        return {
+            repositories,
+            totalCount,
+            hasMore,
+            nextCursor: hasMore ? String(page + 1) : undefined,
+        };
+    }
+    /**
+     * Map GitLab API project to SourceRepository
+     */
+    mapApiProject(item) {
+        return {
+            id: String(item.id),
+            name: item.name,
+            url: item.web_url,
+            description: item.description,
+            owner: item.namespace.path,
+            defaultBranch: item.default_branch,
+            stars: item.star_count,
+            forks: item.forks_count,
+            topics: item.topics || [],
+            updatedAt: item.last_activity_at,
+            createdAt: item.created_at,
+            license: item.license?.key ?? null,
+            metadata: {
+                fullPath: item.path_with_namespace,
+                namespace: item.namespace.name,
+            },
+        };
+    }
+}
+/**
+ * Factory function for creating GitLab adapters
+ */
+export function createGitLabAdapter(config) {
+    return new GitLabSourceAdapter({
+        ...config,
+        type: 'gitlab',
+        baseUrl: config.baseUrl ?? 'https://gitlab.com/api/v4',
+    });
+}
+//# sourceMappingURL=GitLabSourceAdapter.js.map

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

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

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

@@ -0,0 +1,110 @@
+/**
+ * Source Adapter Interface
+ * Defines the contract for all skill source adapters
+ */
+import type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
+/**
+ * Interface for skill source adapters
+ *
+ * Implementations provide access to different skill sources:
+ * - GitHub repositories
+ * - GitLab repositories
+ * - Local filesystem
+ * - Custom registries
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitHubSourceAdapter({
+ *   id: 'github-main',
+ *   name: 'GitHub',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true
+ * })
+ *
+ * const results = await adapter.search({ topics: ['claude-skill'] })
+ * for (const repo of results.repositories) {
+ *   const content = await adapter.fetchSkillContent({ owner: repo.owner, repo: repo.name })
+ *   // Process content...
+ * }
+ * ```
+ */
+export interface ISourceAdapter {
+    /**
+     * Source configuration
+     */
+    readonly config: SourceConfig;
+    /**
+     * Unique identifier for this adapter instance
+     */
+    readonly id: string;
+    /**
+     * Human-readable name
+     */
+    readonly name: string;
+    /**
+     * Source type identifier
+     */
+    readonly type: string;
+    /**
+     * Initialize the adapter
+     * Called once before first use
+     *
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if initialization fails
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the source is healthy and reachable
+     *
+     * @returns Health status of the source
+     */
+    checkHealth(): Promise<SourceHealth>;
+    /**
+     * Search for repositories containing skills
+     *
+     * @param options - Search options (query, filters, pagination)
+     * @returns Search results with repositories
+     */
+    search(options: SourceSearchOptions): Promise<SourceSearchResult>;
+    /**
+     * Get repository information
+     *
+     * @param location - Repository location (owner, repo)
+     * @returns Repository metadata
+     * @throws Error if repository not found
+     */
+    getRepository(location: SourceLocation): Promise<SourceRepository>;
+    /**
+     * Fetch raw skill content from a repository
+     *
+     * @param location - Skill location (owner, repo, path)
+     * @returns Skill content with metadata
+     * @throws Error if skill file not found
+     */
+    fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
+    /**
+     * Check if a skill exists at the given location
+     *
+     * @param location - Skill location to check
+     * @returns True if skill exists
+     */
+    skillExists(location: SourceLocation): Promise<boolean>;
+    /**
+     * Get the SHA/hash of a skill file for change detection
+     *
+     * @param location - Skill location
+     * @returns SHA hash of the file, or null if not found
+     */
+    getSkillSha(location: SourceLocation): Promise<string | null>;
+    /**
+     * Dispose of any resources held by the adapter
+     * Called when the adapter is no longer needed
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Type guard to check if an object implements ISourceAdapter
+ */
+export declare function isSourceAdapter(obj: unknown): obj is ISourceAdapter;
+//# sourceMappingURL=ISourceAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ISourceAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/ISourceAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;;;OAMG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3B;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;IAEpC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAEjE;;;;;;OAMG;IACH,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAElE;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAElE;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEvD;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAE7D;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAYnE"}

package/dist/src/sources/ISourceAdapter.js

@@ -0,0 +1,19 @@
+/**
+ * Source Adapter Interface
+ * Defines the contract for all skill source adapters
+ */
+/**
+ * Type guard to check if an object implements ISourceAdapter
+ */
+export function isSourceAdapter(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const adapter = obj;
+    return (typeof adapter.id === 'string' &&
+        typeof adapter.name === 'string' &&
+        typeof adapter.type === 'string' &&
+        typeof adapter.initialize === 'function' &&
+        typeof adapter.search === 'function' &&
+        typeof adapter.fetchSkillContent === 'function');
+}
+//# sourceMappingURL=ISourceAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ISourceAdapter.js","sourceRoot":"","sources":["../../../src/sources/ISourceAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4HH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAEzD,MAAM,OAAO,GAAG,GAA8B,CAAA;IAC9C,OAAO,CACL,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAC9B,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU;QACxC,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;QACpC,OAAO,OAAO,CAAC,iBAAiB,KAAK,UAAU,CAChD,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,112 @@
+/**
+ * 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 type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
+/**
+ * Configuration for local filesystem adapter
+ */
+export interface LocalFilesystemConfig extends SourceConfig {
+    /** Root directory to scan for skills */
+    rootDir: string;
+    /** Maximum directory depth to search (default: 5) */
+    maxDepth?: number;
+    /** Patterns to exclude (glob-style) */
+    excludePatterns?: string[];
+    /** Whether to follow symlinks (default: false) */
+    followSymlinks?: boolean;
+}
+/**
+ * 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 declare class LocalFilesystemAdapter extends BaseSourceAdapter {
+    private readonly rootDir;
+    private readonly maxDepth;
+    private readonly excludePatterns;
+    private readonly followSymlinks;
+    private discoveredSkills;
+    constructor(config: LocalFilesystemConfig);
+    /**
+     * Initialize by scanning the filesystem
+     */
+    protected doInitialize(): Promise<void>;
+    /**
+     * Check if root directory exists and is accessible
+     */
+    protected doHealthCheck(): Promise<Partial<SourceHealth>>;
+    /**
+     * Search for skills in the scanned directories
+     */
+    search(options?: SourceSearchOptions): Promise<SourceSearchResult>;
+    /**
+     * Get repository info for a skill location
+     */
+    getRepository(location: SourceLocation): Promise<SourceRepository>;
+    /**
+     * Fetch skill content from local file
+     */
+    fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
+    /**
+     * Check if skill exists at location
+     */
+    skillExists(location: SourceLocation): Promise<boolean>;
+    /**
+     * Rescan the filesystem for new skills
+     */
+    rescan(): Promise<number>;
+    /**
+     * Get count of discovered skills
+     */
+    get skillCount(): number;
+    /**
+     * Scan a directory recursively for skill files
+     */
+    private scanDirectory;
+    /**
+     * Check if a path/name should be excluded (SMI-722, SMI-726)
+     * Uses centralized safe pattern matching to prevent RegExp injection
+     */
+    private isExcluded;
+    /**
+     * 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)
+     */
+    private resolveSkillPath;
+    /**
+     * Convert discovered skill to SourceRepository
+     */
+    private skillToRepository;
+    /**
+     * Generate a deterministic ID from a path
+     */
+    private generateId;
+    /**
+     * Generate SHA hash for content
+     */
+    private generateSha;
+}
+/**
+ * Factory function for creating local filesystem adapters
+ */
+export declare function createLocalFilesystemAdapter(config: LocalFilesystemConfig): LocalFilesystemAdapter;
+//# sourceMappingURL=LocalFilesystemAdapter.d.ts.map