@imayuur/contexthub-core 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+export interface ContexthubConfig {
+    roots?: string[];
+    query?: {
+        rrfK?: number;
+    };
+    embeddings?: {
+        mode?: 'local' | 'off' | 'transformers';
+    };
+    graph?: {
+        maxNodes?: number;
+        reportPath?: string;
+    };
+    watch?: {
+        debounceMs?: number;
+        maxFilesPerBatch?: number;
+    };
+    memory?: {
+        maxAgeDays?: number;
+    };
+}
+export declare function loadConfig(repoPath: string): ContexthubConfig;

package/dist/config.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const module_1 = require("module");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const security_1 = require("./security");
+function loadConfig(repoPath) {
+    const configPath = path.join(repoPath, 'contexthub.config.js');
+    let config = { roots: ['.'] };
+    if (fs.existsSync(configPath)) {
+        try {
+            // Use createRequire to safely load .js file relative to the repoPath
+            const requireRel = (0, module_1.createRequire)(path.join(repoPath, 'index.js'));
+            const loaded = requireRel('./contexthub.config.js');
+            if (loaded && typeof loaded === 'object') {
+                config = { ...config, ...loaded };
+            }
+        }
+        catch (e) {
+            console.error(`Warning: Failed to load config from ${configPath}:`, e);
+        }
+    }
+    // Validate numbers with validateLimit
+    const security = new security_1.SecurityManager(repoPath);
+    if (config.query && typeof config.query.rrfK === 'number') {
+        config.query.rrfK = security.validateLimit(config.query.rrfK, 1, 1000);
+    }
+    if (config.graph && typeof config.graph.maxNodes === 'number') {
+        config.graph.maxNodes = security.validateLimit(config.graph.maxNodes, 1, 100000);
+    }
+    if (config.watch && typeof config.watch.debounceMs === 'number') {
+        config.watch.debounceMs = security.validateLimit(config.watch.debounceMs, 100, 60000);
+    }
+    if (config.watch && typeof config.watch.maxFilesPerBatch === 'number') {
+        config.watch.maxFilesPerBatch = security.validateLimit(config.watch.maxFilesPerBatch, 1, 10000);
+    }
+    if (config.memory && typeof config.memory.maxAgeDays === 'number') {
+        config.memory.maxAgeDays = security.validateLimit(config.memory.maxAgeDays, 1, 3650);
+    }
+    return config;
+}

package/dist/contexthub-ignore.d.ts

@@ -0,0 +1,7 @@
+export declare class ContexthubIgnore {
+    private repoPath;
+    private rules;
+    constructor(repoPath: string);
+    private loadIgnoreFiles;
+    ignores(targetPath: string): boolean;
+}

package/dist/contexthub-ignore.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContexthubIgnore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class ContexthubIgnore {
+    constructor(repoPath) {
+        this.repoPath = repoPath;
+        this.rules = [];
+        this.loadIgnoreFiles();
+        // Default ignores
+        this.rules.push(/^\.git([\\/]|$)/);
+        this.rules.push(/^\.contexthub([\\/]|$)/);
+        this.rules.push(/^node_modules([\\/]|$)/);
+    }
+    loadIgnoreFiles() {
+        const filesToTry = ['.contexthubignore', '.gitignore'];
+        for (const filename of filesToTry) {
+            const filePath = path.join(this.repoPath, filename);
+            if (fs.existsSync(filePath)) {
+                const content = fs.readFileSync(filePath, 'utf8');
+                const lines = content.split('\n').map(l => l.trim()).filter(l => l && !l.startsWith('#'));
+                for (const line of lines) {
+                    try {
+                        // Simple conversion of glob to regex
+                        let regexStr = line
+                            .replace(/\./g, '\\.')
+                            .replace(/\*\*/g, '.*')
+                            .replace(/\*/g, '[^/\\\\]*')
+                            .replace(/\?/g, '.');
+                        if (line.startsWith('/')) {
+                            regexStr = '^' + regexStr.substring(1);
+                        }
+                        else if (!line.startsWith('**') && !line.startsWith('.*')) {
+                            // If it's a file or directory name, it could match anywhere unless specified
+                            regexStr = '(^|[\\\\/])' + regexStr;
+                        }
+                        if (!line.endsWith('/') && !line.endsWith('*')) {
+                            regexStr = regexStr + '([\\\\/]|$)';
+                        }
+                        this.rules.push(new RegExp(regexStr));
+                    }
+                    catch (e) {
+                        // Ignore invalid regex
+                    }
+                }
+            }
+        }
+    }
+    ignores(targetPath) {
+        // Normalize path to relative posix path for testing
+        let relPath = path.relative(this.repoPath, targetPath);
+        // Replace windows separators with posix for consistent regex matching if needed
+        // but our regex handles both
+        for (const rule of this.rules) {
+            if (rule.test(relPath) || rule.test('/' + relPath)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+exports.ContexthubIgnore = ContexthubIgnore;

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import type { Session, MemoryEntry, ProjectMetadata } from '@imayuur/contexthub-shared-types';
+export { SecurityManager } from './security';
+export { runUnifiedQuery, UnifiedQueryResult } from './query-pipeline';
+export * from './limits';
+export * from './contexthub-ignore';
+export { ContexthubConfig, loadConfig } from './config';
+export declare class ContextHubCore {
+    private storage;
+    private repoPath;
+    constructor(repoPath: string);
+    initStorage(): Promise<void>;
+    createSession(agent: string, metadata?: Record<string, any>): Promise<string>;
+    endSession(sessionId: string): Promise<void>;
+    getSession(sessionId: string): Promise<Session | null>;
+    getSessions(limit?: number): Promise<Session[]>;
+    saveMemory(memory: Omit<MemoryEntry, 'id'>): Promise<string>;
+    getMemory(id: string): Promise<MemoryEntry | null>;
+    searchMemories(options: {
+        sessionId?: string;
+        type?: string;
+        tags?: string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<MemoryEntry[]>;
+    archiveOldMemories(maxAgeDays: number): Promise<number>;
+    compactMemories(): Promise<number>;
+    saveProjectMetadata(metadata: ProjectMetadata): Promise<void>;
+    getProjectMetadata(): Promise<ProjectMetadata | null>;
+    close(): Promise<void>;
+}

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextHubCore = exports.loadConfig = exports.runUnifiedQuery = exports.SecurityManager = void 0;
+const memory_storage_1 = require("./memory-storage");
+var security_1 = require("./security");
+Object.defineProperty(exports, "SecurityManager", { enumerable: true, get: function () { return security_1.SecurityManager; } });
+var query_pipeline_1 = require("./query-pipeline");
+Object.defineProperty(exports, "runUnifiedQuery", { enumerable: true, get: function () { return query_pipeline_1.runUnifiedQuery; } });
+__exportStar(require("./limits"), exports);
+__exportStar(require("./contexthub-ignore"), exports);
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+class ContextHubCore {
+    constructor(repoPath) {
+        this.repoPath = repoPath;
+        this.storage = new memory_storage_1.MemoryStorage(repoPath);
+    }
+    async initStorage() {
+        // The storage is initialized in the constructor
+        // This method is for any additional initialization if needed
+    }
+    // Session management
+    async createSession(agent, metadata = {}) {
+        return this.storage.createSession(agent, metadata);
+    }
+    async endSession(sessionId) {
+        return this.storage.endSession(sessionId);
+    }
+    async getSession(sessionId) {
+        return this.storage.getSession(sessionId);
+    }
+    async getSessions(limit) {
+        return this.storage.getSessions(limit);
+    }
+    // Memory management
+    async saveMemory(memory) {
+        return this.storage.saveMemory(memory);
+    }
+    async getMemory(id) {
+        return this.storage.getMemory(id);
+    }
+    async searchMemories(options) {
+        return this.storage.searchMemories(options);
+    }
+    // Maintenance & Compaction
+    async archiveOldMemories(maxAgeDays) {
+        return this.storage.archiveOldMemories(maxAgeDays);
+    }
+    async compactMemories() {
+        return this.storage.compactMemories();
+    }
+    // Project metadata
+    async saveProjectMetadata(metadata) {
+        return this.storage.saveProjectMetadata(metadata);
+    }
+    async getProjectMetadata() {
+        return this.storage.getProjectMetadata();
+    }
+    // Cleanup
+    async close() {
+        await this.storage.close();
+    }
+}
+exports.ContextHubCore = ContextHubCore;

package/dist/limits.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Centralized system limits and performance caps for ContextHub.
+ *
+ * These constants enforce strict boundaries on memory consumption,
+ * response payload sizes, and parsing limits to ensure the MCP server
+ * remains lightweight and stable.
+ */
+export declare const MAX_MEMORY_CONTENT_LENGTH = 51200;
+export declare const MAX_MEMORY_TAGS = 20;
+export declare const MAX_RELATED_PATHS = 20;
+export declare const MAX_RELATED_SYMBOLS = 20;
+export declare const MAX_MEMORIES_TOTAL = 10000;
+export declare const MAX_QUERY_LIMIT = 100;
+export declare const DEFAULT_QUERY_LIMIT = 10;
+export declare const MAX_SEARCH_CANDIDATES = 1000;
+export declare const MAX_QUERY_LENGTH = 1000;
+export declare const MAX_GRAPH_DISPLAY_NODES = 5000;
+export declare const MAX_FILES_PER_SCAN = 1000;
+export declare const MAX_INGEST_FILE_SIZE: number;
+export declare const MAX_PDF_PAGES = 50;
+export declare const MAX_PDF_SIZE_BYTES: number;
+export declare const MAX_WATCH_FILES_PER_BATCH = 100;
+export declare const DASHBOARD_MAX_RECORDS = 500;
+export declare const MAX_COMMIT_HASH_LENGTH = 40;
+export declare const MAX_BRANCH_LENGTH = 100;

package/dist/limits.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Centralized system limits and performance caps for ContextHub.
+ *
+ * These constants enforce strict boundaries on memory consumption,
+ * response payload sizes, and parsing limits to ensure the MCP server
+ * remains lightweight and stable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_BRANCH_LENGTH = exports.MAX_COMMIT_HASH_LENGTH = exports.DASHBOARD_MAX_RECORDS = exports.MAX_WATCH_FILES_PER_BATCH = exports.MAX_PDF_SIZE_BYTES = exports.MAX_PDF_PAGES = exports.MAX_INGEST_FILE_SIZE = exports.MAX_FILES_PER_SCAN = exports.MAX_GRAPH_DISPLAY_NODES = exports.MAX_QUERY_LENGTH = exports.MAX_SEARCH_CANDIDATES = exports.DEFAULT_QUERY_LIMIT = exports.MAX_QUERY_LIMIT = exports.MAX_MEMORIES_TOTAL = exports.MAX_RELATED_SYMBOLS = exports.MAX_RELATED_PATHS = exports.MAX_MEMORY_TAGS = exports.MAX_MEMORY_CONTENT_LENGTH = void 0;
+// Memory limits
+exports.MAX_MEMORY_CONTENT_LENGTH = 51200; // 50KB
+exports.MAX_MEMORY_TAGS = 20;
+exports.MAX_RELATED_PATHS = 20;
+exports.MAX_RELATED_SYMBOLS = 20;
+exports.MAX_MEMORIES_TOTAL = 10000;
+// Query limits
+exports.MAX_QUERY_LIMIT = 100;
+exports.DEFAULT_QUERY_LIMIT = 10;
+exports.MAX_SEARCH_CANDIDATES = 1000;
+exports.MAX_QUERY_LENGTH = 1000;
+// Graph & Parsing limits
+exports.MAX_GRAPH_DISPLAY_NODES = 5000;
+exports.MAX_FILES_PER_SCAN = 1000;
+exports.MAX_INGEST_FILE_SIZE = 1024 * 1024; // 1MB
+exports.MAX_PDF_PAGES = 50;
+exports.MAX_PDF_SIZE_BYTES = 20 * 1024 * 1024; // 20MB
+// Watcher limits
+exports.MAX_WATCH_FILES_PER_BATCH = 100;
+// Dashboard limits
+exports.DASHBOARD_MAX_RECORDS = 500;
+// Security limits
+exports.MAX_COMMIT_HASH_LENGTH = 40;
+exports.MAX_BRANCH_LENGTH = 100;

package/dist/memory-storage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MemoryStorage — Secure, encrypted file-based storage for ContextHub
+ *
+ * Security features:
+ * - AES-256-GCM encryption at rest for all JSON data files
+ * - Atomic writes (write to .tmp, then rename) to prevent corruption
+ * - In-process mutex to prevent race conditions on concurrent access
+ * - File size limits to prevent OOM/DoS
+ * - Entry count caps with automatic archival
+ * - Secure file permissions (0600 for files, 0700 for directories)
+ * - Automatic migration from plaintext to encrypted format
+ */
+import { Session, MemoryEntry, ProjectMetadata } from '@imayuur/contexthub-shared-types';
+export declare class MemoryStorage {
+    private repoPath;
+    private contexthubPath;
+    private sessionsPath;
+    private memoriesPath;
+    private projectMetadataPath;
+    private security;
+    private mutex;
+    constructor(repoPath: string);
+    private initFile;
+    /**
+     * Read and decrypt a JSON file from disk.
+     * Handles both encrypted and plaintext formats (for migration).
+     */
+    private readJSONFile;
+    /**
+     * Encrypt and write JSON data to disk using atomic write.
+     * Writes to a .tmp file first, then renames — prevents corruption on crash.
+     */
+    private writeJSONFileSync;
+    createSession(agent: string, metadata?: Record<string, any>): Promise<string>;
+    endSession(sessionId: string): Promise<void>;
+    getSession(sessionId: string): Promise<Session | null>;
+    getSessions(limit?: number): Promise<Session[]>;
+    private calculateJaccard;
+    saveMemory(memory: Omit<MemoryEntry, 'id'>): Promise<string>;
+    getMemory(id: string): Promise<MemoryEntry | null>;
+    searchMemories(options: {
+        sessionId?: string;
+        type?: string;
+        tags?: string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<MemoryEntry[]>;
+    saveProjectMetadata(metadata: ProjectMetadata): Promise<void>;
+    getProjectMetadata(): Promise<ProjectMetadata | null>;
+    archiveOldMemories(maxAgeDays: number): Promise<number>;
+    compactMemories(): Promise<number>;
+    close(): Promise<void>;
+}