@skillsmith/core 0.5.5 → 0.5.6

package/dist/sources/GitHubSourceAdapter.d.ts

@@ -0,0 +1,98 @@
+/**
+ * GitHub Source Adapter (SMI-590)
+ *
+ * Implements the ISourceAdapter interface for GitHub 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';
+/**
+ * GitHub Source Adapter
+ *
+ * Connects to GitHub API to search for and fetch skill repositories.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitHubSourceAdapter({
+ *   id: 'github',
+ *   name: 'GitHub',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true,
+ *   auth: {
+ *     type: 'token',
+ *     credentials: process.env.GITHUB_TOKEN
+ *   }
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export declare class GitHubSourceAdapter extends BaseSourceAdapter {
+    private readonly apiBaseUrl;
+    constructor(config: SourceConfig);
+    /**
+     * Check GitHub API health via rate limit endpoint
+     */
+    protected doHealthCheck(): Promise<Partial<SourceHealth>>;
+    /**
+     * Search GitHub 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 cursor
+     */
+    searchWithCursor(options: SourceSearchOptions, page: number): Promise<SourceSearchResult>;
+    /**
+     * Map GitHub API repository to SourceRepository
+     */
+    private mapApiRepository;
+}
+/**
+ * Configuration for createGitHubAdapter factory
+ */
+export interface GitHubAdapterConfig {
+    /** 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://api.github.com) */
+    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 GitHub adapters
+ */
+export declare function createGitHubAdapter(config: GitHubAdapterConfig): GitHubSourceAdapter;
+//# sourceMappingURL=GitHubSourceAdapter.d.ts.map

package/dist/sources/GitHubSourceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubSourceAdapter.d.ts","sourceRoot":"","sources":["../../src/sources/GitHubSourceAdapter.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;AA0EnB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,MAAM,EAAE,YAAY;IAMhC;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAoB/D;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwC5E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAoCxE;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB7D;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBnE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0C/F;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB;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,kEAAkE;IAClE,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/sources/GitHubSourceAdapter.js

@@ -0,0 +1,269 @@
+/**
+ * GitHub Source Adapter (SMI-590)
+ *
+ * Implements the ISourceAdapter interface for GitHub 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';
+/**
+ * Default topics to search for skill repositories
+ */
+const DEFAULT_TOPICS = ['claude-code-skill', 'claude-code', 'anthropic-claude', 'claude-skill'];
+/**
+ * Default skill file paths to check (use shared paths, SMI-879)
+ */
+const SKILL_FILE_PATHS = SHARED_SKILL_FILE_PATHS;
+/**
+ * GitHub Source Adapter
+ *
+ * Connects to GitHub API to search for and fetch skill repositories.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitHubSourceAdapter({
+ *   id: 'github',
+ *   name: 'GitHub',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true,
+ *   auth: {
+ *     type: 'token',
+ *     credentials: process.env.GITHUB_TOKEN
+ *   }
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export class GitHubSourceAdapter extends BaseSourceAdapter {
+    apiBaseUrl;
+    constructor(config) {
+        super(config);
+        this.apiBaseUrl = config.baseUrl || 'https://api.github.com';
+        validateUrl(this.apiBaseUrl);
+    }
+    /**
+     * Check GitHub API health via rate limit endpoint
+     */
+    async doHealthCheck() {
+        const response = await this.fetchWithRateLimit(`${this.apiBaseUrl}/rate_limit`);
+        if (!response.ok) {
+            return {
+                healthy: false,
+                error: `GitHub API returned ${response.status}`,
+            };
+        }
+        const data = (await response.json());
+        const searchLimit = data.resources.search;
+        return {
+            healthy: true,
+            rateLimitRemaining: searchLimit.remaining,
+            rateLimitReset: new Date(searchLimit.reset * 1000).toISOString(),
+        };
+    }
+    /**
+     * Search GitHub 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 query
+        const topicQueries = topics.map((t) => `topic:${t}`).join(' ');
+        const query = options.query ? `${options.query} ${topicQueries}` : topicQueries;
+        const searchQuery = encodeURIComponent(query);
+        const url = `${this.apiBaseUrl}/search/repositories?q=${searchQuery}&per_page=${perPage}&sort=updated&order=desc`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (isRateLimitStatus(response.status)) {
+                throw new ApiError('GitHub API rate limit exceeded', {
+                    statusCode: response.status,
+                    url,
+                });
+            }
+            throw new ApiError(`GitHub API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        const repositories = data.items.map((item) => this.mapApiRepository(item));
+        return {
+            repositories,
+            totalCount: data.total_count,
+            hasMore: data.total_count > perPage,
+            nextCursor: perPage < data.total_count ? String(perPage) : undefined,
+        };
+    }
+    /**
+     * Get repository metadata by location
+     */
+    async getRepository(location) {
+        await this.waitForRateLimit();
+        const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}`;
+        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(`GitHub API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        return this.mapApiRepository(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;
+        // Try each possible skill file path
+        for (const path of paths) {
+            try {
+                const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}/contents/${path}?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.sha,
+                        location,
+                        filePath: data.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);
+        for (const path of paths) {
+            try {
+                await this.waitForRateLimit();
+                const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}/contents/${path}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                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);
+        for (const path of paths) {
+            try {
+                await this.waitForRateLimit();
+                const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}/contents/${path}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                if (response.ok) {
+                    const data = (await response.json());
+                    return data.sha;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    /**
+     * Paginated search with cursor
+     */
+    async searchWithCursor(options, page) {
+        await this.waitForRateLimit();
+        const topics = options.topics ?? DEFAULT_TOPICS;
+        const perPage = Math.min(options.limit ?? 30, 100);
+        // Build search query
+        const topicQueries = topics.map((t) => `topic:${t}`).join(' ');
+        const query = options.query ? `${options.query} ${topicQueries}` : topicQueries;
+        const searchQuery = encodeURIComponent(query);
+        const url = `${this.apiBaseUrl}/search/repositories?q=${searchQuery}&per_page=${perPage}&page=${page}&sort=updated&order=desc`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (isRateLimitStatus(response.status)) {
+                throw new ApiError('GitHub API rate limit exceeded', {
+                    statusCode: response.status,
+                    url,
+                });
+            }
+            throw new ApiError(`GitHub API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        const repositories = data.items.map((item) => this.mapApiRepository(item));
+        const totalPages = Math.ceil(data.total_count / perPage);
+        const hasMore = page < totalPages;
+        return {
+            repositories,
+            totalCount: data.total_count,
+            hasMore,
+            nextCursor: hasMore ? String(page + 1) : undefined,
+        };
+    }
+    /**
+     * Map GitHub API repository to SourceRepository
+     */
+    mapApiRepository(item) {
+        return {
+            id: String(item.id),
+            name: item.name,
+            url: item.html_url,
+            description: item.description,
+            owner: item.owner.login,
+            defaultBranch: item.default_branch,
+            stars: item.stargazers_count,
+            forks: item.forks_count,
+            topics: item.topics || [],
+            updatedAt: item.updated_at,
+            createdAt: item.created_at,
+            license: item.license?.spdx_id ?? null,
+            metadata: {
+                fullName: item.full_name,
+            },
+        };
+    }
+}
+/**
+ * Factory function for creating GitHub adapters
+ */
+export function createGitHubAdapter(config) {
+    return new GitHubSourceAdapter({
+        ...config,
+        type: 'github',
+        baseUrl: config.baseUrl ?? 'https://api.github.com',
+    });
+}
+//# sourceMappingURL=GitHubSourceAdapter.js.map

package/dist/sources/GitHubSourceAdapter.js.map

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

package/dist/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/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"}