contradiction-mcp 0.1.0

package/dist/connectors/github/githubClient.d.ts

@@ -0,0 +1,52 @@
+import { GitHubRepoResponse, GitHubContentFile, GitHubFilePayload, GitHubRateLimitInfo } from './githubTypes.js';
+export interface GitHubClientOptions {
+    token?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+export declare class GitHubClient {
+    private readonly token?;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(options?: GitHubClientOptions);
+    hasToken(): boolean;
+    /**
+     * Internal reusable HTTP request execution with rate limit handling,
+     * authentication headers, timeouts, and sanitized error mapping.
+     */
+    request<T>(endpoint: string, query?: Record<string, string | undefined>): Promise<{
+        data: T;
+        rateLimit?: GitHubRateLimitInfo;
+    }>;
+    /**
+     * Fetches metadata for a GitHub repository.
+     */
+    getRepository(owner: string, repo: string): Promise<GitHubRepoResponse>;
+    /**
+     * Fetches the default README file for a repository.
+     * Returns null if README does not exist (HTTP 404).
+     */
+    getReadme(owner: string, repo: string, ref?: string): Promise<GitHubFilePayload | null>;
+    /**
+     * Fetches a specific file's content from a repository.
+     * Returns null if the file does not exist.
+     */
+    getFileContent(owner: string, repo: string, filePath: string, ref?: string): Promise<GitHubFilePayload | null>;
+    /**
+     * Lists files in a specific directory.
+     */
+    listDirectory(owner: string, repo: string, dirPath: string, ref?: string): Promise<GitHubContentFile[] | null>;
+    /**
+     * Discovers and retrieves all GitHub Actions workflow YAML files
+     * from `.github/workflows`.
+     */
+    getWorkflowFiles(owner: string, repo: string, ref?: string): Promise<GitHubFilePayload[]>;
+    /**
+     * Extracts rate limit metrics from response headers.
+     */
+    private extractRateLimit;
+    /**
+     * Decodes a base64 GitHub content object into a UTF-8 string payload.
+     */
+    private parseContentFile;
+}

package/dist/connectors/github/githubClient.js

@@ -0,0 +1,207 @@
+import { sanitizeSecrets, sanitizeErrorMessage } from '../base/connectorUtils.js';
+import { AuthenticationError, NotFoundError, ConnectorError } from '../../domain/types/common.js';
+import { logger } from '../../utils/logger.js';
+export class GitHubClient {
+    token;
+    baseUrl;
+    timeoutMs;
+    constructor(options) {
+        this.token = options?.token?.trim() || undefined;
+        this.baseUrl = options?.baseUrl?.replace(/\/+$/, '') || 'https://api.github.com';
+        this.timeoutMs = options?.timeoutMs ?? 15000;
+    }
+    hasToken() {
+        return Boolean(this.token && this.token.length > 0);
+    }
+    /**
+     * Internal reusable HTTP request execution with rate limit handling,
+     * authentication headers, timeouts, and sanitized error mapping.
+     */
+    async request(endpoint, query) {
+        const url = new URL(`${this.baseUrl}${endpoint.startsWith('/') ? endpoint : `/${endpoint}`}`);
+        if (query) {
+            for (const [key, val] of Object.entries(query)) {
+                if (val !== undefined && val !== null) {
+                    url.searchParams.set(key, val);
+                }
+            }
+        }
+        const headers = {
+            Accept: 'application/vnd.github.v3+json',
+            'User-Agent': 'contradiction-mcp/0.1.0',
+        };
+        if (this.token) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            logger.debug('Executing GitHub API request', {
+                url: url.origin + url.pathname,
+                hasAuth: Boolean(this.token),
+            });
+            const response = await fetch(url.toString(), {
+                method: 'GET',
+                headers,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            const rateLimit = this.extractRateLimit(response.headers);
+            if (response.status === 401) {
+                throw new AuthenticationError('GitHub API authentication failed. Verify that GITHUB_TOKEN is valid.');
+            }
+            if (response.status === 403) {
+                if (rateLimit && rateLimit.remaining === 0) {
+                    throw new ConnectorError(`GitHub API rate limit exceeded (limit: ${rateLimit.limit}). Resets at ${rateLimit.resetAt.toISOString()}. Provide GITHUB_TOKEN for higher rate limits.`);
+                }
+                const errorBody = await response.text().catch(() => '');
+                throw new ConnectorError(`GitHub API access forbidden (HTTP 403): ${sanitizeSecrets(errorBody) || 'Permission denied'}`);
+            }
+            if (response.status === 404) {
+                throw new NotFoundError('GitHub resource', `${endpoint}${query?.ref ? ` (ref: ${query.ref})` : ''}`);
+            }
+            if (!response.ok) {
+                const errorBody = await response.text().catch(() => '');
+                throw new ConnectorError(`GitHub API request failed with HTTP ${response.status}: ${sanitizeSecrets(errorBody)}`);
+            }
+            const data = (await response.json());
+            return { data, rateLimit };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof AuthenticationError ||
+                error instanceof NotFoundError ||
+                error instanceof ConnectorError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new ConnectorError(`GitHub API request timed out after ${this.timeoutMs}ms`);
+            }
+            const cleanMessage = sanitizeErrorMessage(error);
+            throw new ConnectorError(`GitHub API communication failure: ${cleanMessage}`, error);
+        }
+    }
+    /**
+     * Fetches metadata for a GitHub repository.
+     */
+    async getRepository(owner, repo) {
+        const { data } = await this.request(`/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`);
+        return data;
+    }
+    /**
+     * Fetches the default README file for a repository.
+     * Returns null if README does not exist (HTTP 404).
+     */
+    async getReadme(owner, repo, ref) {
+        try {
+            const { data } = await this.request(`/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/readme`, ref ? { ref } : undefined);
+            return this.parseContentFile(data);
+        }
+        catch (error) {
+            if (error instanceof NotFoundError) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Fetches a specific file's content from a repository.
+     * Returns null if the file does not exist.
+     */
+    async getFileContent(owner, repo, filePath, ref) {
+        try {
+            const cleanPath = filePath.replace(/^\/+/, '');
+            const { data } = await this.request(`/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/contents/${encodeURI(cleanPath)}`, ref ? { ref } : undefined);
+            if (data.type !== 'file') {
+                return null;
+            }
+            return this.parseContentFile(data);
+        }
+        catch (error) {
+            if (error instanceof NotFoundError) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Lists files in a specific directory.
+     */
+    async listDirectory(owner, repo, dirPath, ref) {
+        try {
+            const cleanPath = dirPath.replace(/^\/+/, '');
+            const { data } = await this.request(`/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/contents/${encodeURI(cleanPath)}`, ref ? { ref } : undefined);
+            return Array.isArray(data) ? data : null;
+        }
+        catch (error) {
+            if (error instanceof NotFoundError) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Discovers and retrieves all GitHub Actions workflow YAML files
+     * from `.github/workflows`.
+     */
+    async getWorkflowFiles(owner, repo, ref) {
+        const dirEntries = await this.listDirectory(owner, repo, '.github/workflows', ref);
+        if (!dirEntries) {
+            return [];
+        }
+        const workflowFiles = dirEntries.filter((entry) => entry.type === 'file' && (entry.name.endsWith('.yml') || entry.name.endsWith('.yaml')));
+        const payloads = [];
+        for (const entry of workflowFiles) {
+            const file = await this.getFileContent(owner, repo, entry.path, ref);
+            if (file) {
+                payloads.push(file);
+            }
+        }
+        return payloads;
+    }
+    /**
+     * Extracts rate limit metrics from response headers.
+     */
+    extractRateLimit(headers) {
+        const limitHeader = headers.get('x-ratelimit-limit');
+        const remainingHeader = headers.get('x-ratelimit-remaining');
+        const resetHeader = headers.get('x-ratelimit-reset');
+        if (!limitHeader || !remainingHeader || !resetHeader) {
+            return undefined;
+        }
+        const limit = parseInt(limitHeader, 10);
+        const remaining = parseInt(remainingHeader, 10);
+        const resetSeconds = parseInt(resetHeader, 10);
+        if (isNaN(limit) || isNaN(remaining) || isNaN(resetSeconds)) {
+            return undefined;
+        }
+        return {
+            limit,
+            remaining,
+            resetAt: new Date(resetSeconds * 1000),
+        };
+    }
+    /**
+     * Decodes a base64 GitHub content object into a UTF-8 string payload.
+     */
+    parseContentFile(data) {
+        let content = '';
+        if (data.content) {
+            if (data.encoding === 'base64') {
+                const cleanBase64 = data.content.replace(/\r?\n|\r/g, '');
+                content = Buffer.from(cleanBase64, 'base64').toString('utf-8');
+            }
+            else {
+                content = data.content;
+            }
+        }
+        return {
+            path: data.path,
+            content,
+            url: data.html_url || data.url,
+            sha: data.sha,
+            size: data.size,
+        };
+    }
+}
+//# sourceMappingURL=githubClient.js.map

package/dist/connectors/github/githubClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubClient.js","sourceRoot":"","sources":["../../../src/connectors/github/githubClient.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAQ/C,MAAM,OAAO,YAAY;IACN,KAAK,CAAU;IACf,OAAO,CAAS;IAChB,SAAS,CAAS;IAEnC,YAAY,OAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,wBAAwB,CAAC;QACjF,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC;IAC/C,CAAC;IAEM,QAAQ;QACb,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO,CAClB,QAAgB,EAChB,KAA0C;QAE1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAC;QAE9F,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,gCAAgC;YACxC,YAAY,EAAE,yBAAyB;SACxC,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;gBAC3C,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ;gBAC9B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC3C,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAE1D,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,mBAAmB,CAC3B,sEAAsE,CACvE,CAAC;YACJ,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;oBAC3C,MAAM,IAAI,cAAc,CACtB,0CAA0C,SAAS,CAAC,KAAK,gBAAgB,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,gDAAgD,CACzJ,CAAC;gBACJ,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,IAAI,cAAc,CACtB,2CAA2C,eAAe,CAAC,SAAS,CAAC,IAAI,mBAAmB,EAAE,CAC/F,CAAC;YACJ,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,aAAa,CACrB,iBAAiB,EACjB,GAAG,QAAQ,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,IAAI,cAAc,CACtB,uCAAuC,QAAQ,CAAC,MAAM,KAAK,eAAe,CAAC,SAAS,CAAC,EAAE,CACxF,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;YAC1C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IACE,KAAK,YAAY,mBAAmB;gBACpC,KAAK,YAAY,aAAa;gBAC9B,KAAK,YAAY,cAAc,EAC/B,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,cAAc,CAAC,sCAAsC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACrF,CAAC;YAED,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,IAAI,cAAc,CAAC,qCAAqC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,IAAY;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,UAAU,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,SAAS,CACpB,KAAa,EACb,IAAY,EACZ,GAAY;QAEZ,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,UAAU,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,EACxE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAC1B,CAAC;YAEF,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,cAAc,CACzB,KAAa,EACb,IAAY,EACZ,QAAgB,EAChB,GAAY;QAEZ,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,UAAU,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,SAAS,CAAC,EAAE,EAClG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAC1B,CAAC;YAEF,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CACxB,KAAa,EACb,IAAY,EACZ,OAAe,EACf,GAAY;QAEZ,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,UAAU,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,SAAS,CAAC,EAAE,EAClG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAC1B,CAAC;YAEF,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB,CAC3B,KAAa,EACb,IAAY,EACZ,GAAY;QAEZ,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACnF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CACrC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CACzF,CAAC;QAEF,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACrE,IAAI,IAAI,EAAE,CAAC;gBACT,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAgB;QACvC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACrD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAErD,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE/C,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,KAAK;YACL,SAAS;YACT,OAAO,EAAE,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAuB;QAC9C,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC1D,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO;YACP,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG;YAC9B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;CACF"}

package/dist/connectors/github/githubConnector.d.ts

@@ -0,0 +1,26 @@
+import { Connector, ConnectorMetadata, ConnectionTestResult } from '../types/connector.js';
+import { FetchResult, ExtractedClaim } from '../types/fetchResult.js';
+import { GitHubConnectorInput, GitHubFetchData } from './githubTypes.js';
+import { GitHubClient } from './githubClient.js';
+import { GitHubExtractor } from './githubExtractor.js';
+import { GitHubNormalizer } from './githubNormalizer.js';
+export declare class GitHubConnector implements Connector<GitHubConnectorInput, GitHubFetchData> {
+    readonly type: "github";
+    readonly metadata: ConnectorMetadata;
+    private readonly client;
+    private readonly extractor;
+    private readonly normalizer;
+    constructor(client?: GitHubClient, extractor?: GitHubExtractor, normalizer?: GitHubNormalizer);
+    /**
+     * Tests connection to GitHub and verifies target repository accessibility.
+     */
+    testConnection(input?: GitHubConnectorInput): Promise<ConnectionTestResult>;
+    /**
+     * Fetches target repository metadata and files for claim extraction.
+     */
+    fetch(input: GitHubConnectorInput): Promise<FetchResult<GitHubFetchData>>;
+    /**
+     * Extracts and normalizes factual claims from fetched repository data.
+     */
+    extractClaims(fetchResult: FetchResult<GitHubFetchData>): Promise<ExtractedClaim[]>;
+}

package/dist/connectors/github/githubConnector.js

@@ -0,0 +1,169 @@
+import { GitHubClient } from './githubClient.js';
+import { GitHubExtractor } from './githubExtractor.js';
+import { GitHubNormalizer } from './githubNormalizer.js';
+import { createSourceExternalId, sanitizeErrorMessage } from '../base/connectorUtils.js';
+import { ValidationError } from '../../domain/types/common.js';
+import { logger } from '../../utils/logger.js';
+export class GitHubConnector {
+    type = 'github';
+    metadata = {
+        type: 'github',
+        displayName: 'GitHub Repository',
+        description: 'Extracts runtime versions, dependencies, port requirements, and configurations from GitHub repositories via the GitHub REST API.',
+        authRequirement: 'optional',
+        enabled: true,
+        capabilities: {
+            supportsIncrementalSync: true,
+            supportsFileInspection: true,
+            supportedFileTypes: ['package.json', 'Dockerfile', 'README.md', '.github/workflows/*.yml'],
+        },
+    };
+    client;
+    extractor;
+    normalizer;
+    constructor(client, extractor, normalizer) {
+        this.client = client || new GitHubClient();
+        this.extractor = extractor || new GitHubExtractor();
+        this.normalizer = normalizer || new GitHubNormalizer();
+    }
+    /**
+     * Tests connection to GitHub and verifies target repository accessibility.
+     */
+    async testConnection(input) {
+        const hasAuth = this.client.hasToken();
+        if (!input || !input.owner || !input.repo) {
+            // General API accessibility check
+            try {
+                const { rateLimit } = await this.client.request('/rate_limit');
+                return {
+                    accessible: true,
+                    authenticated: hasAuth,
+                    targetFound: true,
+                    rateLimit,
+                    details: { message: 'GitHub API is accessible' },
+                };
+            }
+            catch (error) {
+                return {
+                    accessible: false,
+                    authenticated: hasAuth,
+                    targetFound: false,
+                    error: sanitizeErrorMessage(error),
+                };
+            }
+        }
+        try {
+            const repo = await this.client.getRepository(input.owner, input.repo);
+            return {
+                accessible: true,
+                authenticated: hasAuth,
+                targetFound: true,
+                details: {
+                    owner: repo.owner.login,
+                    repo: repo.name,
+                    fullName: repo.full_name,
+                    defaultBranch: repo.default_branch,
+                    isPrivate: repo.private,
+                    htmlUrl: repo.html_url,
+                },
+            };
+        }
+        catch (error) {
+            const msg = sanitizeErrorMessage(error);
+            const isRateLimited = msg.toLowerCase().includes('rate limit');
+            return {
+                accessible: isRateLimited ? true : false,
+                authenticated: hasAuth,
+                targetFound: false,
+                error: msg,
+                details: isRateLimited ? { rateLimited: true, message: msg } : undefined,
+            };
+        }
+    }
+    /**
+     * Fetches target repository metadata and files for claim extraction.
+     */
+    async fetch(input) {
+        if (!input.owner || !input.repo) {
+            throw new ValidationError("GitHub connector requires both 'owner' and 'repo' in input");
+        }
+        logger.info('Fetching repository via GitHub connector', {
+            owner: input.owner,
+            repo: input.repo,
+            branch: input.branch,
+        });
+        const repoData = await this.client.getRepository(input.owner, input.repo);
+        const branch = input.branch || repoData.default_branch;
+        const files = [];
+        // 1. Fetch README
+        try {
+            const readme = await this.client.getReadme(input.owner, input.repo, branch);
+            if (readme) {
+                files.push(readme);
+            }
+        }
+        catch (err) {
+            logger.debug('No README found or error fetching README', { error: String(err) });
+        }
+        // 2. Fetch package.json
+        try {
+            const pkg = await this.client.getFileContent(input.owner, input.repo, 'package.json', branch);
+            if (pkg) {
+                files.push(pkg);
+            }
+        }
+        catch (err) {
+            logger.debug('No package.json found or error fetching package.json', { error: String(err) });
+        }
+        // 3. Fetch Dockerfile
+        try {
+            const dockerfile = await this.client.getFileContent(input.owner, input.repo, 'Dockerfile', branch);
+            if (dockerfile) {
+                files.push(dockerfile);
+            }
+        }
+        catch (err) {
+            logger.debug('No Dockerfile found or error fetching Dockerfile', { error: String(err) });
+        }
+        // 4. Fetch GitHub Actions workflows
+        try {
+            const workflows = await this.client.getWorkflowFiles(input.owner, input.repo, branch);
+            files.push(...workflows);
+        }
+        catch (err) {
+            logger.debug('No workflows found or error fetching workflows', { error: String(err) });
+        }
+        const repoInfo = {
+            owner: repoData.owner.login,
+            repo: repoData.name,
+            fullName: repoData.full_name,
+            defaultBranch: repoData.default_branch,
+            htmlUrl: repoData.html_url,
+            description: repoData.description,
+        };
+        const sourceExternalId = createSourceExternalId('github', repoInfo.fullName);
+        return {
+            sourceIdentifier: sourceExternalId,
+            sourceName: repoInfo.fullName,
+            sourceUri: repoInfo.htmlUrl,
+            fetchedAt: new Date(),
+            rawData: {
+                repository: repoInfo,
+                files,
+            },
+            metadata: {
+                branch,
+                filesCount: files.length,
+                inspectedFiles: files.map((f) => f.path),
+            },
+        };
+    }
+    /**
+     * Extracts and normalizes factual claims from fetched repository data.
+     */
+    async extractClaims(fetchResult) {
+        const rawClaims = this.extractor.extractClaims(fetchResult.rawData.repository, fetchResult.sourceIdentifier, fetchResult.rawData.files);
+        return this.normalizer.normalizeClaims(rawClaims);
+    }
+}
+//# sourceMappingURL=githubConnector.js.map

package/dist/connectors/github/githubConnector.js.map

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

package/dist/connectors/github/githubExtractor.d.ts

@@ -0,0 +1,26 @@
+import { GitHubFilePayload, GitHubRepoInfo } from './githubTypes.js';
+import { ExtractedClaim } from '../types/fetchResult.js';
+export declare class GitHubExtractor {
+    /**
+     * Extracts factual claims from a set of repository files.
+     */
+    extractClaims(repo: GitHubRepoInfo, sourceExternalId: string, files: GitHubFilePayload[]): ExtractedClaim[];
+    /**
+     * Extracts factual claims from package.json.
+     */
+    private extractFromPackageJson;
+    /**
+     * Extracts factual claims from Dockerfile.
+     */
+    private extractFromDockerfile;
+    /**
+     * Extracts factual claims from README.md.
+     */
+    private extractFromReadme;
+    /**
+     * Extracts factual claims from GitHub Actions workflow files.
+     */
+    private extractFromWorkflow;
+    private findLineNumber;
+    private extractEvidence;
+}