@venizia/ignis-docs 0.0.1-4 → 0.0.1-6

package/mcp-server/dist/common/config.d.ts

@@ -1,27 +1,64 @@
-export declare const MCP_CONFIG: {
-    readonly server: {
+/**
+ * Centralized configuration for the Ignis MCP Documentation Server.
+ * All tool constants and settings are defined here for easy maintenance.
+ */
+export declare class MCPConfigs {
+    static readonly server: {
         readonly name: "ignis-docs";
         readonly version: "0.0.1";
     };
-    readonly search: {
-        readonly snippetLength: 300;
-        readonly defaultLimit: 10;
-        readonly maxLimit: 50;
-        readonly minQueryLength: 2;
+    /** Runtime-configurable branch (set via CLI argument) */
+    private static _branch;
+    static readonly github: {
+        apiBase: string;
+        rawContentBase: string;
+        repoOwner: string;
+        repoPath: string;
+        repoName: string;
+        userAgent: string;
+        /** Get current branch (configurable at runtime) */
+        readonly branch: string;
     };
-    readonly fuse: {
-        readonly includeScore: true;
-        readonly threshold: 0.4;
-        readonly minMatchCharLength: 2;
-        readonly findAllMatches: true;
-        readonly ignoreLocation: true;
-        readonly keys: readonly [{
-            readonly name: "title";
-            readonly weight: 0.7;
-        }, {
-            readonly name: "content";
-            readonly weight: 0.3;
-        }];
+    /**
+     * Set the GitHub branch to use for fetching source code.
+     * Call this before starting the server.
+     * @param branch - Branch name (e.g., 'main', 'develop', 'feature/xyz')
+     */
+    static setBranch(opts: {
+        branch: string;
+    }): void;
+    static readonly search: {
+        /** Maximum characters for content snippet in search results */
+        snippetLength: number;
+        /** Default number of results to return */
+        defaultLimit: number;
+        /** Maximum allowed results per search */
+        maxLimit: number;
+        /** Minimum query length required */
+        minQueryLength: number;
     };
-};
+    static readonly codeSearch: {
+        /** Default number of results to return */
+        defaultLimit: number;
+        /** Maximum allowed results per search (GitHub API limit) */
+        maxLimit: number;
+        /** Minimum query length required */
+        minQueryLength: number;
+        /** Rate limit warning threshold */
+        rateLimitWarningThreshold: number;
+    };
+    static readonly fuse: {
+        includeScore: boolean;
+        /** Lower threshold = stricter matching (0.0 = exact, 1.0 = match anything) */
+        threshold: number;
+        minMatchCharLength: number;
+        findAllMatches: boolean;
+        ignoreLocation: boolean;
+        /** Search field weights: title matches are prioritized over content */
+        keys: {
+            name: string;
+            weight: number;
+        }[];
+    };
+}
 //# sourceMappingURL=config.d.ts.map

package/mcp-server/dist/common/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../common/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CAsBb,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../common/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAU;IAIrB,MAAM,CAAC,QAAQ,CAAC,MAAM;;;MAAqD;IAM3E,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAkB;IAExC,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;QAQpB,mDAAmD;yBACrC,MAAM;MAGpB;IAEF;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAOzC,MAAM,CAAC,QAAQ,CAAC,MAAM;QACpB,+DAA+D;;QAE/D,0CAA0C;;QAE1C,yCAAyC;;QAEzC,oCAAoC;;MAEpC;IAKF,MAAM,CAAC,QAAQ,CAAC,UAAU;QACxB,0CAA0C;;QAE1C,4DAA4D;;QAE5D,oCAAoC;;QAEpC,mCAAmC;;MAEnC;IAKF,MAAM,CAAC,QAAQ,CAAC,IAAI;;QAElB,8EAA8E;;;;;QAK9E,uEAAuE;;;;;MAKvE;CACH"}

package/mcp-server/dist/common/config.js

@@ -1,27 +1,82 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCP_CONFIG = void 0;
-exports.MCP_CONFIG = {
-    server: {
-        name: 'ignis-docs',
-        version: '0.0.1',
-    },
-    search: {
-        snippetLength: 300,
+exports.MCPConfigs = void 0;
+/**
+ * Centralized configuration for the Ignis MCP Documentation Server.
+ * All tool constants and settings are defined here for easy maintenance.
+ */
+class MCPConfigs {
+    // ----------------------------------------------------------------------------
+    // SERVER CONFIGURATION
+    // ----------------------------------------------------------------------------
+    static { this.server = { name: 'ignis-docs', version: '0.0.1' }; }
+    // ----------------------------------------------------------------------------
+    // GITHUB CONFIGURATION
+    // ----------------------------------------------------------------------------
+    /** Runtime-configurable branch (set via CLI argument) */
+    static { this._branch = 'main'; }
+    static { this.github = {
+        apiBase: 'https://api.github.com',
+        rawContentBase: 'https://raw.githubusercontent.com',
+        repoOwner: 'VENIZIA-AI',
+        repoPath: 'repos',
+        repoName: 'ignis',
+        userAgent: 'Ignis-MCP-Server',
+        /** Get current branch (configurable at runtime) */
+        get branch() {
+            return MCPConfigs._branch;
+        },
+    }; }
+    /**
+     * Set the GitHub branch to use for fetching source code.
+     * Call this before starting the server.
+     * @param branch - Branch name (e.g., 'main', 'develop', 'feature/xyz')
+     */
+    static setBranch(opts) {
+        MCPConfigs._branch = opts.branch;
+    }
+    // ----------------------------------------------------------------------------
+    // DOCUMENTATION SEARCH CONFIGURATION
+    // ----------------------------------------------------------------------------
+    static { this.search = {
+        /** Maximum characters for content snippet in search results */
+        snippetLength: 320,
+        /** Default number of results to return */
         defaultLimit: 10,
+        /** Maximum allowed results per search */
         maxLimit: 50,
+        /** Minimum query length required */
         minQueryLength: 2,
-    },
-    fuse: {
+    }; }
+    // ----------------------------------------------------------------------------
+    // CODE SEARCH CONFIGURATION
+    // ----------------------------------------------------------------------------
+    static { this.codeSearch = {
+        /** Default number of results to return */
+        defaultLimit: 10,
+        /** Maximum allowed results per search (GitHub API limit) */
+        maxLimit: 30,
+        /** Minimum query length required */
+        minQueryLength: 2,
+        /** Rate limit warning threshold */
+        rateLimitWarningThreshold: 5,
+    }; }
+    // ----------------------------------------------------------------------------
+    // FUSE.JS SEARCH ENGINE CONFIGURATION
+    // ----------------------------------------------------------------------------
+    static { this.fuse = {
         includeScore: true,
+        /** Lower threshold = stricter matching (0.0 = exact, 1.0 = match anything) */
         threshold: 0.4,
         minMatchCharLength: 2,
         findAllMatches: true,
         ignoreLocation: true,
+        /** Search field weights: title matches are prioritized over content */
         keys: [
             { name: 'title', weight: 0.7 },
             { name: 'content', weight: 0.3 },
         ],
-    },
-};
+    }; }
+}
+exports.MCPConfigs = MCPConfigs;
 //# sourceMappingURL=config.js.map

package/mcp-server/dist/common/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../common/config.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB;IACD,MAAM,EAAE;QACN,aAAa,EAAE,GAAG;QAClB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE,EAAE;QACZ,cAAc,EAAE,CAAC;KAClB;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,GAAG;QACd,kBAAkB,EAAE,CAAC;QACrB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI;QACpB,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE;YAC9B,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;SACjC;KACF;CACO,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../common/config.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,UAAU;IACrB,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;aAC/D,WAAM,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC;IAE3E,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;IAE/E,yDAAyD;aAC1C,YAAO,GAAW,MAAM,CAAC;aAExB,WAAM,GAAG;QACvB,OAAO,EAAE,wBAAwB;QACjC,cAAc,EAAE,mCAAmC;QACnD,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,kBAAkB;QAE7B,mDAAmD;QACnD,IAAI,MAAM;YACR,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,CAAC;KACF,CAAC;IAEF;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAwB;QACvC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,+EAA+E;IAC/E,qCAAqC;IACrC,+EAA+E;aAC/D,WAAM,GAAG;QACvB,+DAA+D;QAC/D,aAAa,EAAE,GAAG;QAClB,0CAA0C;QAC1C,YAAY,EAAE,EAAE;QAChB,yCAAyC;QACzC,QAAQ,EAAE,EAAE;QACZ,oCAAoC;QACpC,cAAc,EAAE,CAAC;KAClB,CAAC;IAEF,+EAA+E;IAC/E,4BAA4B;IAC5B,+EAA+E;aAC/D,eAAU,GAAG;QAC3B,0CAA0C;QAC1C,YAAY,EAAE,EAAE;QAChB,4DAA4D;QAC5D,QAAQ,EAAE,EAAE;QACZ,oCAAoC;QACpC,cAAc,EAAE,CAAC;QACjB,mCAAmC;QACnC,yBAAyB,EAAE,CAAC;KAC7B,CAAC;IAEF,+EAA+E;IAC/E,sCAAsC;IACtC,+EAA+E;aAC/D,SAAI,GAAG;QACrB,YAAY,EAAE,IAAI;QAClB,8EAA8E;QAC9E,SAAS,EAAE,GAAG;QACd,kBAAkB,EAAE,CAAC;QACrB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI;QACpB,uEAAuE;QACvE,IAAI,EAAE;YACJ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE;YAC9B,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;SACjC;KACF,CAAC;;AA/EJ,gCAgFC"}

package/mcp-server/dist/helpers/docs.helper.d.ts

@@ -15,7 +15,7 @@ export declare class DocsHelper {
     /**
      * Loads and caches documentation from the wiki.
      */
-    static loadDocumentation(): Promise<IDoc[]>;
+    static load(): Promise<IDoc[]>;
     /**
      * Clears the documentation cache.
      */
@@ -27,7 +27,7 @@ export declare class DocsHelper {
     /**
      * Searches the loaded documentation.
      */
-    static searchDocs(opts: ISearchOptions): Promise<{
+    static searchDocuments(opts: ISearchOptions): Promise<{
         id: string;
         title: string;
         category: string;
@@ -37,13 +37,13 @@ export declare class DocsHelper {
     /**
      * Gets the full content of a specific document.
      */
-    static getDocContent(opts: {
+    static getDocumentContent(opts: {
         id: string;
     }): Promise<string | null>;
     /**
      * Lists all available documentation files.
      */
-    static listDocs(opts: {
+    static listDocumentFiles(opts: {
         category?: string;
     }): Promise<{
         id: string;
@@ -57,7 +57,7 @@ export declare class DocsHelper {
     /**
      * Gets metadata about a specific document.
      */
-    static getDocMetadata(opts: {
+    static getDocumentMetadata(opts: {
         id: string;
     }): Promise<{
         id: string;

package/mcp-server/dist/helpers/docs.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.helper.d.ts","sourceRoot":"","sources":["../../helpers/docs.helper.ts"],"names":[],"mappings":"AAQA,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAc;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAA2B;IAE/C;;OAEG;WACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IA+CjD;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAc9B;;OAEG;WACU,UAAU,CAAC,IAAI,EAAE,cAAc;;;;;;;IAqB5C;;OAEG;WACU,aAAa,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYxE;;OAEG;WACU,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;IAgBjD;;OAEG;WACU,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAShD;;OAEG;WACU,cAAc,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;CAiCjD"}
+{"version":3,"file":"docs.helper.d.ts","sourceRoot":"","sources":["../../helpers/docs.helper.ts"],"names":[],"mappings":"AAQA,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAc;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAA2B;IAE/C;;OAEG;WACU,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAiDpC;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B;;OAEG;WACU,eAAe,CAAC,IAAI,EAAE,cAAc;;;;;;;IAqBjD;;OAEG;WACU,kBAAkB,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY7E;;OAEG;WACU,iBAAiB,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;IAgB1D;;OAEG;WACU,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAShD;;OAEG;WACU,mBAAmB,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;CAiCtD"}

package/mcp-server/dist/helpers/docs.helper.js

@@ -11,13 +11,14 @@ const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const common_1 = require("../common");
 const logger_helper_1 = require("./logger.helper");
+// --------------------------------------------------------------------------------------------------
 class DocsHelper {
     static { this._docs = []; }
     static { this._fuse = null; }
     /**
      * Loads and caches documentation from the wiki.
      */
-    static async loadDocumentation() {
+    static async load() {
         if (this._docs.length > 0) {
             return this._docs;
         }
@@ -31,21 +32,23 @@ class DocsHelper {
                 logger_helper_1.Logger.warn(`No documentation files found in ${common_1.Paths.WIKI}`);
                 return [];
             }
-            this._docs = await Promise.all(files.map(async (file) => {
-                const rawContent = await promises_1.default.readFile(file, 'utf-8');
-                const { data, content } = (0, gray_matter_1.default)(rawContent);
-                return {
-                    id: node_path_1.default.relative(common_1.Paths.WIKI, file),
-                    title: data.title || node_path_1.default.basename(file, '.md'),
-                    content,
-                    category: data.category || 'Uncategorized',
-                    filePath: file,
-                };
+            this._docs = await Promise.all(files.map(file => {
+                return new Promise((resolve, reject) => {
+                    promises_1.default.readFile(file, 'utf-8')
+                        .then(rawContent => {
+                        const { data, content } = (0, gray_matter_1.default)(rawContent);
+                        resolve({
+                            id: node_path_1.default.relative(common_1.Paths.WIKI, file),
+                            title: data.title || node_path_1.default.basename(file, '.md'),
+                            content,
+                            category: data.category || 'Uncategorized',
+                            filePath: file,
+                        });
+                    })
+                        .catch(reject);
+                });
             }));
-            this._fuse = new fuse_js_1.default(this._docs, {
-                ...common_1.MCP_CONFIG.fuse,
-                keys: common_1.MCP_CONFIG.fuse.keys,
-            });
+            this._fuse = new fuse_js_1.default(this._docs, { ...common_1.MCPConfigs.fuse, keys: common_1.MCPConfigs.fuse.keys });
             logger_helper_1.Logger.info(`Loaded ${this._docs.length} documentation files`);
             return this._docs;
         }
@@ -65,7 +68,8 @@ class DocsHelper {
     /**
      * Generates a smart snippet from content.
      */
-    static generateSnippet(content, maxLength = common_1.MCP_CONFIG.search.snippetLength) {
+    static generateSnippet(opts) {
+        const { content, maxLength = common_1.MCPConfigs.search.snippetLength } = opts;
         if (content.length <= maxLength) {
             return content;
         }
@@ -76,29 +80,29 @@ class DocsHelper {
     /**
      * Searches the loaded documentation.
      */
-    static async searchDocs(opts) {
+    static async searchDocuments(opts) {
         if (!this._fuse) {
-            await this.loadDocumentation();
+            await this.load();
         }
         if (!this._fuse) {
             return [];
         }
-        const limit = opts.limit ?? common_1.MCP_CONFIG.search.defaultLimit;
+        const limit = opts.limit ?? common_1.MCPConfigs.search.defaultLimit;
         const results = this._fuse.search(opts.query).slice(0, limit);
         return results.map(result => ({
             id: result.item.id,
             title: result.item.title,
             category: result.item.category,
-            snippet: this.generateSnippet(result.item.content),
+            snippet: this.generateSnippet({ content: result.item.content }),
             score: result.score,
         }));
     }
     /**
      * Gets the full content of a specific document.
      */
-    static async getDocContent(opts) {
+    static async getDocumentContent(opts) {
         if (this._docs.length === 0) {
-            await this.loadDocumentation();
+            await this.load();
         }
         const doc = this._docs.find(d => d.id === opts.id);
         if (doc) {
@@ -109,9 +113,9 @@ class DocsHelper {
     /**
      * Lists all available documentation files.
      */
-    static async listDocs(opts) {
+    static async listDocumentFiles(opts) {
         if (this._docs.length === 0) {
-            await this.loadDocumentation();
+            await this.load();
         }
         const filteredDocs = opts.category
             ? this._docs.filter(d => d.category === opts.category)
@@ -127,7 +131,7 @@ class DocsHelper {
      */
     static async listCategories() {
         if (this._docs.length === 0) {
-            await this.loadDocumentation();
+            await this.load();
         }
         const categories = new Set(this._docs.map(d => d.category));
         return Array.from(categories).sort();
@@ -135,9 +139,9 @@ class DocsHelper {
     /**
      * Gets metadata about a specific document.
      */
-    static async getDocMetadata(opts) {
+    static async getDocumentMetadata(opts) {
         if (this._docs.length === 0) {
-            await this.loadDocumentation();
+            await this.load();
         }
         const doc = this._docs.find(d => d.id === opts.id);
         if (!doc) {

package/mcp-server/dist/helpers/docs.helper.js.map

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

package/mcp-server/dist/helpers/github.helper.d.ts

@@ -0,0 +1,37 @@
+export interface IGithubError {
+    error: string;
+    status: number;
+}
+export interface IGithubFile {
+    name: string;
+    path: string;
+    type: 'file' | 'dir';
+    size: number;
+    url: string;
+}
+export interface IGithubContent {
+    content: string;
+}
+/**
+ * A helper class for interacting with the VENIZIA-AI/ignis GitHub repository.
+ */
+export declare class GithubHelper {
+    private static getApiUrl;
+    /**
+     * Fetches the contents of a directory from the GitHub repository.
+     * @param opts.path - The path to the directory from the repository root.
+     * @returns A promise that resolves to the directory content or an error object.
+     */
+    static getDirectoryContents(opts?: {
+        path?: string;
+    }): Promise<IGithubFile[] | IGithubError>;
+    /**
+     * Fetches the content of a specific file from the GitHub repository.
+     * @param opts.filePath - The path to the file from the repository root.
+     * @returns A promise that resolves to the file content or an error object.
+     */
+    static getFileContent(opts: {
+        filePath: string;
+    }): Promise<IGithubContent | IGithubError>;
+}
+//# sourceMappingURL=github.helper.d.ts.map

package/mcp-server/dist/helpers/github.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.helper.d.ts","sourceRoot":"","sources":["../../helpers/github.helper.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,SAAS;IAKxB;;;;OAIG;WACU,oBAAoB,CAC/B,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3B,OAAO,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC;IA8CxC;;;;OAIG;WACU,cAAc,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,GAAG,YAAY,CAAC;CA8BhG"}

package/mcp-server/dist/helpers/github.helper.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubHelper = void 0;
+const common_1 = require("../common");
+const logger_helper_1 = require("./logger.helper");
+// --------------------------------------------------------------------------------------------------
+// Helper function to create a standardized error response
+const getError = (opts) => ({
+    error: opts.message,
+    status: opts.status || 500,
+});
+// --------------------------------------------------------------------------------------------------
+/**
+ * A helper class for interacting with the VENIZIA-AI/ignis GitHub repository.
+ */
+class GithubHelper {
+    static getApiUrl(opts) {
+        const { apiBase, repoOwner, repoName } = common_1.MCPConfigs.github;
+        return [apiBase, common_1.MCPConfigs.github.repoPath, repoOwner, repoName, opts.path].join('/');
+    }
+    /**
+     * Fetches the contents of a directory from the GitHub repository.
+     * @param opts.path - The path to the directory from the repository root.
+     * @returns A promise that resolves to the directory content or an error object.
+     */
+    static async getDirectoryContents(opts = {}) {
+        const dirPath = opts.path ?? '';
+        const { branch, userAgent } = common_1.MCPConfigs.github;
+        const url = this.getApiUrl({ path: `contents/${dirPath}?ref=${branch}` });
+        logger_helper_1.Logger.debug(`Fetching directory from GitHub: ${url}`);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': userAgent,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (!response.ok) {
+                logger_helper_1.Logger.error(`GitHub API error for path "${dirPath}": ${response.statusText}`);
+                return getError({ message: response.statusText, status: response.status });
+            }
+            const data = (await response.json());
+            if (!Array.isArray(data)) {
+                if (data.message) {
+                    logger_helper_1.Logger.error(`GitHub API error for path "${dirPath}": ${data.message}`);
+                    return getError({ message: data.message, status: 404 });
+                }
+                return getError({ message: 'Invalid response from GitHub API', status: 500 });
+            }
+            return data.map(item => ({
+                name: item.name,
+                path: item.path,
+                type: item.type, // 'file' or 'dir'
+                size: item.size,
+                url: item.html_url,
+            }));
+        }
+        catch (error) {
+            logger_helper_1.Logger.error(`Failed to fetch directory "${dirPath}" from GitHub:`, error);
+            return getError({
+                message: `Failed to fetch directory content. ${error instanceof Error ? error.message : ''}`,
+                status: 500,
+            });
+        }
+    }
+    /**
+     * Fetches the content of a specific file from the GitHub repository.
+     * @param opts.filePath - The path to the file from the repository root.
+     * @returns A promise that resolves to the file content or an error object.
+     */
+    static async getFileContent(opts) {
+        const { rawContentBase, repoOwner, repoName, branch } = common_1.MCPConfigs.github;
+        // We use the raw content URL for files to avoid API rate limits and base64 decoding.
+        const url = [rawContentBase, repoOwner, repoName, branch, opts.filePath].join('/');
+        logger_helper_1.Logger.debug(`Fetching file content from GitHub: ${url}`);
+        try {
+            const response = await fetch(url);
+            const content = await response.text();
+            // Check if the fetch was successful. GitHub returns a "404: Not Found" string for missing files
+            // when using raw.githubusercontent.com, OR returns 404 status.
+            if (response.status === 404 || (typeof content === 'string' && content.startsWith('404'))) {
+                logger_helper_1.Logger.warn(`File not found on GitHub: ${opts.filePath}`);
+                return getError({ message: 'File not found', status: 404 });
+            }
+            if (!response.ok) {
+                return getError({ message: response.statusText, status: response.status });
+            }
+            return { content };
+        }
+        catch (error) {
+            logger_helper_1.Logger.error(`Failed to fetch file "${opts.filePath}" from GitHub:`, error);
+            return getError({
+                message: `Failed to fetch file content. ${error instanceof Error ? error.message : ''}`,
+                status: 500,
+            });
+        }
+    }
+}
+exports.GithubHelper = GithubHelper;
+//# sourceMappingURL=github.helper.js.map

package/mcp-server/dist/helpers/github.helper.js.map

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

package/mcp-server/dist/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from './docs.helper';
 export * from './logger.helper';
+export * from './github.helper';
 //# sourceMappingURL=index.d.ts.map

package/mcp-server/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/mcp-server/dist/helpers/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./docs.helper"), exports);
 __exportStar(require("./logger.helper"), exports);
+__exportStar(require("./github.helper"), exports);
 //# sourceMappingURL=index.js.map

package/mcp-server/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,kDAAgC;AAChC,kDAAgC"}