@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAMhB,MAAM,YAAY,CAAC;AAyCpB;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAyB;IAE3C;;;;;OAKG;gBACS,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAOpD;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAmBZ;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,IAAI,IAAI,IAAI;IAiBZ;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAIhE;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAK7E;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAK/C;;;;OAIG;IACH,MAAM,IAAI,eAAe;IAIzB;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAOnD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IA2DrC;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;OAIG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CA2DjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAElD"}

package/dist/config/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Configuration Types
+ *
+ * Type definitions for Knowledge Graph configuration system.
+ *
+ * @module config/types
+ */
+/**
+ * Main configuration interface for the Knowledge Graph system
+ */
+export interface KGConfiguration {
+    /** Configuration version for migration support */
+    version: string;
+    /** Root directory of the project */
+    projectRoot: string;
+    /** Path to documentation directory (relative to projectRoot) */
+    docsPath: string;
+    /** Database configuration */
+    database: DatabaseConfig;
+    /** Cache configuration */
+    cache: CacheConfig;
+    /** Agent configuration */
+    agents: AgentConfig;
+    /** Services configuration */
+    services: ServicesConfig;
+    /** Logging configuration */
+    logging: LoggingConfig;
+}
+/**
+ * Database configuration settings
+ */
+export interface DatabaseConfig {
+    /** Path to database file (relative to projectRoot) */
+    path: string;
+    /** Enable automatic backups */
+    autoBackup: boolean;
+    /** Backup interval in milliseconds (default: 24 hours) */
+    backupInterval: number;
+    /** Maximum number of backup files to retain */
+    maxBackups: number;
+}
+/**
+ * Cache configuration settings
+ */
+export interface CacheConfig {
+    /** Enable caching */
+    enabled: boolean;
+    /** Maximum number of items in cache */
+    maxSize: number;
+    /** Time-to-live in milliseconds */
+    ttl: number;
+    /** Cache eviction policy */
+    evictionPolicy: 'lru' | 'lfu' | 'fifo';
+}
+/**
+ * Agent configuration settings
+ */
+export interface AgentConfig {
+    /** Maximum concurrent agent executions */
+    maxConcurrent: number;
+    /** Default timeout for agent operations in milliseconds */
+    defaultTimeout: number;
+    /** Number of retry attempts for failed operations */
+    retryAttempts: number;
+    /** Enable Claude Flow integration */
+    claudeFlowEnabled: boolean;
+}
+/**
+ * Services configuration settings
+ */
+export interface ServicesConfig {
+    /** Enable file system watcher service */
+    watcherEnabled: boolean;
+    /** Enable task scheduler service */
+    schedulerEnabled: boolean;
+    /** Enable sync service */
+    syncEnabled: boolean;
+    /** Health check interval in milliseconds */
+    healthCheckInterval: number;
+}
+/**
+ * Logging configuration settings
+ */
+export interface LoggingConfig {
+    /** Minimum log level */
+    level: 'debug' | 'info' | 'warn' | 'error';
+    /** Log output format */
+    format: 'json' | 'text';
+    /** Optional path for log file output */
+    outputPath?: string;
+}
+/**
+ * Configuration migration definition
+ */
+export interface ConfigMigration {
+    /** Target version for this migration */
+    version: string;
+    /** Upgrade function */
+    up: (config: Partial<KGConfiguration>) => Partial<KGConfiguration>;
+    /** Downgrade function */
+    down: (config: Partial<KGConfiguration>) => Partial<KGConfiguration>;
+}
+/**
+ * Configuration validation result
+ */
+export interface ConfigValidationResult {
+    /** Whether the configuration is valid */
+    valid: boolean;
+    /** Validation errors if any */
+    errors: ConfigValidationError[];
+    /** Validation warnings if any */
+    warnings: ConfigValidationError[];
+}
+/**
+ * Configuration validation error
+ */
+export interface ConfigValidationError {
+    /** Path to the invalid field */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Expected value or type */
+    expected?: string;
+    /** Actual value received */
+    actual?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB,0BAA0B;IAC1B,KAAK,EAAE,WAAW,CAAC;IAEnB,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB,4BAA4B;IAC5B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IAEpB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IAEZ,4BAA4B;IAC5B,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IAEvB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IAEtB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;IAExB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAC;IAErB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE3C,wBAAwB;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnE,yBAAyB;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IAEf,+BAA+B;IAC/B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAEhC,iCAAiC;IACjC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/core/cache.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Shadow Cache - File Metadata Caching
+ *
+ * Provides a caching layer for file metadata to enable incremental updates
+ * and improve performance when analyzing large codebases.
+ *
+ * @module core/cache
+ */
+/**
+ * File metadata stored in cache
+ */
+export interface FileMetadata {
+    /** Relative path from project root */
+    path: string;
+    /** File size in bytes */
+    size: number;
+    /** Modification time (Unix timestamp) */
+    mtime: number;
+    /** Content hash (MD5) */
+    hash: string;
+    /** File type inferred from extension */
+    type: FileType;
+    /** When this entry was cached */
+    cachedAt: number;
+}
+/**
+ * File types for classification
+ */
+export type FileType = 'markdown' | 'typescript' | 'javascript' | 'python' | 'rust' | 'go' | 'java' | 'php' | 'ruby' | 'yaml' | 'json' | 'toml' | 'config' | 'docker' | 'other';
+/**
+ * Cache entry change type
+ */
+export type ChangeType = 'added' | 'modified' | 'deleted' | 'unchanged';
+/**
+ * File change information
+ */
+export interface FileChange {
+    path: string;
+    change: ChangeType;
+    oldMeta?: FileMetadata;
+    newMeta?: FileMetadata;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    totalEntries: number;
+    hitCount: number;
+    missCount: number;
+    hitRate: number;
+    sizeBytes: number;
+    lastUpdated: number | null;
+    staleEntries: number;
+}
+/**
+ * Shadow Cache options
+ */
+export interface ShadowCacheOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Cache directory (relative to .kg) */
+    cacheDir?: string;
+    /** Default TTL in milliseconds (default: 1 hour) */
+    defaultTTL?: number;
+    /** Maximum entries before pruning (default: 10000) */
+    maxEntries?: number;
+    /** Enable persistence to disk (default: true) */
+    persist?: boolean;
+}
+/**
+ * Shadow Cache for file metadata
+ *
+ * Provides efficient caching of file metadata to enable:
+ * - Incremental graph updates (only process changed files)
+ * - Fast file existence/modification checks
+ * - Content hash comparison
+ *
+ * @example
+ * ```typescript
+ * const cache = new ShadowCache({ projectRoot: '/my/project' });
+ * await cache.load();
+ *
+ * // Check for changes
+ * const changes = await cache.detectChanges(['docs/**\/*.md']);
+ *
+ * // Process only changed files
+ * for (const change of changes) {
+ *   if (change.change !== 'unchanged') {
+ *     console.log(`${change.path}: ${change.change}`);
+ *   }
+ * }
+ *
+ * // Update cache with processed files
+ * await cache.save();
+ * ```
+ */
+export declare class ShadowCache {
+    private projectRoot;
+    private cacheDir;
+    private cachePath;
+    private defaultTTL;
+    private maxEntries;
+    private persist;
+    private entries;
+    private hitCount;
+    private missCount;
+    private loaded;
+    private dirty;
+    private createdAt;
+    private updatedAt;
+    constructor(options: ShadowCacheOptions);
+    /**
+     * Load cache from disk
+     */
+    load(): Promise<boolean>;
+    /**
+     * Save cache to disk
+     */
+    save(): Promise<boolean>;
+    /**
+     * Get cached metadata for a file
+     */
+    get(filePath: string): FileMetadata | undefined;
+    /**
+     * Set cached metadata for a file
+     */
+    set(filePath: string, metadata: Partial<FileMetadata>): FileMetadata;
+    /**
+     * Remove a file from cache
+     */
+    delete(filePath: string): boolean;
+    /**
+     * Check if a file exists in cache
+     */
+    has(filePath: string): boolean;
+    /**
+     * Check if a file has changed since caching
+     */
+    hasChanged(filePath: string): boolean;
+    /**
+     * Detect changes for a list of files
+     */
+    detectChanges(filePaths: string[]): Promise<FileChange[]>;
+    /**
+     * Update cache with detected changes
+     */
+    applyChanges(changes: FileChange[]): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Prune stale entries
+     */
+    prune(): Promise<number>;
+    /**
+     * Get all cached file paths
+     */
+    getAllPaths(): string[];
+    /**
+     * Get files by type
+     */
+    getByType(type: FileType): FileMetadata[];
+    /**
+     * Invalidate entries matching a pattern
+     */
+    invalidate(pattern: RegExp): number;
+    private normalizePath;
+    private computeMetadata;
+    private inferFileType;
+    private estimateSize;
+}
+/**
+ * Create a shadow cache for a project
+ */
+export declare function createShadowCache(options: ShadowCacheOptions): ShadowCache;
+/**
+ * Load or create shadow cache for a project
+ */
+export declare function loadShadowCache(projectRoot: string): Promise<ShadowCache>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

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