@cisco_open/linting-orchestrator 1.0.0-rc.4

package/build/storage/redis-storage.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Redis Storage Implementation for OpenAPI Lint Orchestrator
+ *
+ * TODO: Future enhancement for distributed deployments.
+ *
+ * This storage adapter is designed but not yet implemented.
+ * It will provide shared storage across multiple orchestrator instances
+ * using Redis as the backend.
+ *
+ * Use cases:
+ * - Multi-instance deployments behind load balancer
+ * - Shared result cache across worker nodes
+ * - Persistent storage with Redis persistence
+ * - Pub/sub for cache invalidation notifications
+ *
+ * @module storage/redis-storage
+ */
+import type { LintJobResult } from '../types.js';
+import type { LintResultStorage, StorageOptions, StorageStats } from './storage-adapter.js';
+/**
+ * Redis-specific storage options
+ */
+export interface RedisStorageOptions extends StorageOptions {
+    /**
+     * Redis connection URL
+     * Example: redis://localhost:6379
+     */
+    url?: string;
+    /**
+     * Redis connection options
+     */
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    /**
+     * Key prefix for all storage keys
+     * Default: 'spectify:lint:'
+     */
+    keyPrefix?: string;
+    /**
+     * Enable pub/sub for distributed cache invalidation
+     * Default: false
+     */
+    enablePubSub?: boolean;
+}
+/**
+ * Redis storage implementation
+ *
+ * TODO: Implement using ioredis package
+ *
+ * Implementation plan:
+ * 1. Add ioredis dependency: npm install ioredis @types/ioredis
+ * 2. Implement connection management
+ * 3. Implement key-value storage with TTL
+ * 4. Implement indexing using Redis Sets
+ * 5. Implement pub/sub for invalidation (optional)
+ * 6. Add error handling and retry logic
+ * 7. Add comprehensive tests
+ *
+ * Example usage:
+ * ```typescript
+ * const storage = new RedisLintStorage();
+ * await storage.initialize({
+ *   url: 'redis://localhost:6379',
+ *   ttl: 3600, // 1 hour
+ *   keyPrefix: 'spectify:lint:'
+ * });
+ * ```
+ */
+export declare class RedisLintStorage implements LintResultStorage {
+    /**
+     * Initialize Redis storage
+     *
+     * TODO: Implement Redis connection
+     */
+    initialize(_options?: RedisStorageOptions): Promise<void>;
+    /**
+     * Store job result in Redis
+     *
+     * TODO: Implement Redis storage
+     *
+     * Storage strategy:
+     * - Key: spectify:lint:job:{jobId}
+     * - Value: JSON.stringify(result)
+     * - TTL: options.ttl (if set)
+     * - Index: spectify:lint:doc:{documentId} -> Set of jobIds
+     * - Index: spectify:lint:composite:{compositeKey} -> jobId
+     */
+    storeJob(_result: LintJobResult): Promise<void>;
+    /**
+     * Retrieve job by ID from Redis
+     *
+     * TODO: Implement retrieval
+     */
+    retrieveJobById(_jobId: string): Promise<LintJobResult | null>;
+    /**
+     * Retrieve job by document + ruleset
+     *
+     * TODO: Implement composite retrieval
+     */
+    retrieveJob(_documentId: string, _rulesetName: string, _rulesetVersion: string): Promise<LintJobResult | null>;
+    /**
+     * Check if results exist
+     *
+     * TODO: Implement existence check
+     */
+    exists(_documentId: string, _rulesetName: string, _rulesetVersion: string): Promise<boolean>;
+    /**
+     * Invalidate all results for a document
+     *
+     * TODO: Implement invalidation with pub/sub
+     */
+    invalidate(_documentId: string): Promise<number>;
+    /**
+     * Get storage statistics
+     *
+     * TODO: Implement stats collection
+     */
+    getStats(): Promise<StorageStats>;
+    /**
+     * Clear all data
+     *
+     * TODO: Implement clear
+     */
+    clear(): Promise<number>;
+    /**
+     * Close Redis connection
+     *
+     * TODO: Implement cleanup
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=redis-storage.d.ts.map

package/build/storage/redis-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-storage.d.ts","sourceRoot":"","sources":["../../src/storage/redis-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IAIxD;;;;OAIG;IACG,UAAU,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/D;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BrD;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAcpE;;;;OAIG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAehC;;;;OAIG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUnB;;;;OAIG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BtD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAcvC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAc9B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB7B"}

package/build/storage/redis-storage.js

@@ -0,0 +1,236 @@
+/**
+ * Redis Storage Implementation for OpenAPI Lint Orchestrator
+ *
+ * TODO: Future enhancement for distributed deployments.
+ *
+ * This storage adapter is designed but not yet implemented.
+ * It will provide shared storage across multiple orchestrator instances
+ * using Redis as the backend.
+ *
+ * Use cases:
+ * - Multi-instance deployments behind load balancer
+ * - Shared result cache across worker nodes
+ * - Persistent storage with Redis persistence
+ * - Pub/sub for cache invalidation notifications
+ *
+ * @module storage/redis-storage
+ */
+/**
+ * Redis storage implementation
+ *
+ * TODO: Implement using ioredis package
+ *
+ * Implementation plan:
+ * 1. Add ioredis dependency: npm install ioredis @types/ioredis
+ * 2. Implement connection management
+ * 3. Implement key-value storage with TTL
+ * 4. Implement indexing using Redis Sets
+ * 5. Implement pub/sub for invalidation (optional)
+ * 6. Add error handling and retry logic
+ * 7. Add comprehensive tests
+ *
+ * Example usage:
+ * ```typescript
+ * const storage = new RedisLintStorage();
+ * await storage.initialize({
+ *   url: 'redis://localhost:6379',
+ *   ttl: 3600, // 1 hour
+ *   keyPrefix: 'spectify:lint:'
+ * });
+ * ```
+ */
+export class RedisLintStorage {
+    // TODO: Add Redis client instance
+    // private redis?: Redis;
+    /**
+     * Initialize Redis storage
+     *
+     * TODO: Implement Redis connection
+     */
+    async initialize(_options) {
+        // TODO: Create Redis connection
+        // this.redis = new Redis(options?.url || {
+        //   host: options?.host || 'localhost',
+        //   port: options?.port || 6379,
+        //   password: options?.password,
+        //   db: options?.db || 0
+        // });
+        throw new Error('RedisLintStorage: TODO - Redis storage is not yet implemented.\n' +
+            'This is a future enhancement for distributed deployments.\n' +
+            'For local development, use MemoryLintStorage instead.\n\n' +
+            'To implement:\n' +
+            '1. Install: npm install ioredis @types/ioredis\n' +
+            '2. Uncomment Redis client initialization\n' +
+            '3. Implement all interface methods\n' +
+            '4. Add tests in tests/unit/redis-storage.test.ts');
+    }
+    /**
+     * Store job result in Redis
+     *
+     * TODO: Implement Redis storage
+     *
+     * Storage strategy:
+     * - Key: spectify:lint:job:{jobId}
+     * - Value: JSON.stringify(result)
+     * - TTL: options.ttl (if set)
+     * - Index: spectify:lint:doc:{documentId} -> Set of jobIds
+     * - Index: spectify:lint:composite:{compositeKey} -> jobId
+     */
+    async storeJob(_result) {
+        throw new Error('RedisLintStorage.storeJob: TODO - Not implemented');
+        // TODO: Implementation
+        // const key = this.makeJobKey(result.jobId);
+        // const value = JSON.stringify(result);
+        // 
+        // if (this.options?.ttl) {
+        //   await this.redis.setex(key, this.options.ttl, value);
+        // } else {
+        //   await this.redis.set(key, value);
+        // }
+        // 
+        // // Add to document index
+        // await this.redis.sadd(
+        //   this.makeDocumentIndexKey(result.documentId),
+        //   result.jobId
+        // );
+        // 
+        // // Add to composite index
+        // const compositeKey = makeCompositeKey(
+        //   result.documentId,
+        //   result.rulesetName,
+        //   result.rulesetVersion
+        // );
+        // await this.redis.set(
+        //   this.makeCompositeIndexKey(compositeKey),
+        //   result.jobId
+        // );
+    }
+    /**
+     * Retrieve job by ID from Redis
+     *
+     * TODO: Implement retrieval
+     */
+    async retrieveJobById(_jobId) {
+        throw new Error('RedisLintStorage.retrieveJobById: TODO - Not implemented');
+        // TODO: Implementation
+        // const key = this.makeJobKey(jobId);
+        // const value = await this.redis.get(key);
+        // 
+        // if (!value) {
+        //   return null;
+        // }
+        // 
+        // return JSON.parse(value) as LintJobResult;
+    }
+    /**
+     * Retrieve job by document + ruleset
+     *
+     * TODO: Implement composite retrieval
+     */
+    async retrieveJob(_documentId, _rulesetName, _rulesetVersion) {
+        throw new Error('RedisLintStorage.retrieveJob: TODO - Not implemented');
+        // TODO: Implementation
+        // const compositeKey = makeCompositeKey(documentId, rulesetName, rulesetVersion);
+        // const indexKey = this.makeCompositeIndexKey(compositeKey);
+        // const jobId = await this.redis.get(indexKey);
+        // 
+        // if (!jobId) {
+        //   return null;
+        // }
+        // 
+        // return this.retrieveJobById(jobId);
+    }
+    /**
+     * Check if results exist
+     *
+     * TODO: Implement existence check
+     */
+    async exists(_documentId, _rulesetName, _rulesetVersion) {
+        throw new Error('RedisLintStorage.exists: TODO - Not implemented');
+        // TODO: Implementation
+        // const compositeKey = makeCompositeKey(documentId, rulesetName, rulesetVersion);
+        // const indexKey = this.makeCompositeIndexKey(compositeKey);
+        // const exists = await this.redis.exists(indexKey);
+        // return exists === 1;
+    }
+    /**
+     * Invalidate all results for a document
+     *
+     * TODO: Implement invalidation with pub/sub
+     */
+    async invalidate(_documentId) {
+        throw new Error('RedisLintStorage.invalidate: TODO - Not implemented');
+        // TODO: Implementation
+        // const indexKey = this.makeDocumentIndexKey(documentId);
+        // const jobIds = await this.redis.smembers(indexKey);
+        // 
+        // if (jobIds.length === 0) {
+        //   return 0;
+        // }
+        // 
+        // // Delete all job keys
+        // const jobKeys = jobIds.map(id => this.makeJobKey(id));
+        // await this.redis.del(...jobKeys);
+        // 
+        // // Delete index
+        // await this.redis.del(indexKey);
+        // 
+        // // TODO: Publish invalidation event if pub/sub enabled
+        // if (this.options?.enablePubSub) {
+        //   await this.redis.publish(
+        //     'spectify:invalidate',
+        //     JSON.stringify({ documentId, jobIds })
+        //   );
+        // }
+        // 
+        // return jobIds.length;
+    }
+    /**
+     * Get storage statistics
+     *
+     * TODO: Implement stats collection
+     */
+    async getStats() {
+        throw new Error('RedisLintStorage.getStats: TODO - Not implemented');
+        // TODO: Implementation
+        // const pattern = `${this.options?.keyPrefix || 'spectify:lint:'}job:*`;
+        // const keys = await this.redis.keys(pattern);
+        // 
+        // return {
+        //   totalJobs: keys.length,
+        //   totalResults: 0, // Would need to scan all jobs
+        //   storageSize: await this.redis.dbsize()
+        // };
+    }
+    /**
+     * Clear all data
+     *
+     * TODO: Implement clear
+     */
+    async clear() {
+        throw new Error('RedisLintStorage.clear: TODO - Not implemented');
+        // TODO: Implementation
+        // const pattern = `${this.options?.keyPrefix || 'spectify:lint:'}*`;
+        // const keys = await this.redis.keys(pattern);
+        // 
+        // if (keys.length > 0) {
+        //   await this.redis.del(...keys);
+        // }
+        // 
+        // return keys.length;
+    }
+    /**
+     * Close Redis connection
+     *
+     * TODO: Implement cleanup
+     */
+    async close() {
+        throw new Error('RedisLintStorage.close: TODO - Not implemented');
+        // TODO: Implementation
+        // if (this.redis) {
+        //   await this.redis.quit();
+        //   this.redis = undefined;
+        // }
+    }
+}
+//# sourceMappingURL=redis-storage.js.map

package/build/storage/redis-storage.js.map

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

package/build/storage/storage-adapter.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Storage Adapter Interface for OpenAPI Lint Orchestrator
+ *
+ * Defines the contract for storing and retrieving lint job results.
+ * Implementations can use different backends (memory, Redis, database, etc.)
+ *
+ * @module storage/storage-adapter
+ */
+import type { LintJobResult, ListJobsOptions, JobSummary, DocumentLintActivity, LintResultQueryOptions, PaginatedLintResult, LintResultStats } from '../types.js';
+/**
+ * Storage configuration options
+ */
+export interface StorageOptions {
+    /**
+     * Time-to-live for cached results in seconds
+     * If undefined, results never expire
+     */
+    ttl?: number;
+    /**
+     * Additional backend-specific options
+     */
+    [key: string]: any;
+}
+/**
+ * Storage statistics
+ */
+export interface StorageStats {
+    /**
+     * Total number of jobs stored
+     */
+    totalJobs: number;
+    /**
+     * Total number of results across all jobs
+     */
+    totalResults: number;
+    /**
+     * Approximate storage size in bytes (if available)
+     */
+    storageSize?: number;
+    /**
+     * Number of expired entries (if TTL enabled)
+     */
+    expiredEntries?: number;
+    /**
+     * Failure statistics
+     */
+    failureStats?: {
+        totalFailed: number;
+        totalTimeout: number;
+        totalCompleted: number;
+        failureRate: number;
+    };
+    /**
+     * Backend-specific metrics
+     */
+    [key: string]: any;
+}
+/**
+ * Abstract storage adapter interface
+ *
+ * All storage implementations must implement this interface.
+ * Provides methods for storing, retrieving, and managing lint job results.
+ */
+export interface LintResultStorage {
+    /**
+     * Initialize the storage backend
+     *
+     * @param options - Storage configuration options
+     */
+    initialize?(options?: StorageOptions): Promise<void>;
+    /**
+     * Store complete job result
+     *
+     * @param result - The complete lint job result
+     * @throws {Error} If storage operation fails
+     */
+    storeJob(result: LintJobResult): Promise<void>;
+    /**
+     * Retrieve job result by job ID
+     *
+     * @param jobId - The unique job identifier
+     * @returns The job result, or null if not found or expired
+     */
+    retrieveJobById(jobId: string): Promise<LintJobResult | null>;
+    /**
+     * Retrieve job result by document + ruleset combination
+     *
+     * Useful for checking if results already exist for a specific
+     * document and ruleset combination (caching).
+     *
+     * @param documentId - The document identifier
+     * @param rulesetName - The ruleset name
+     * @param rulesetVersion - The ruleset version
+     * @returns The most recent job result, or null if not found or expired
+     */
+    retrieveJob(documentId: string, rulesetName: string, rulesetVersion: string): Promise<LintJobResult | null>;
+    /**
+     * Check if cached results exist for a document + ruleset
+     *
+     * More efficient than retrieveJob when you only need existence check.
+     *
+     * @param documentId - The document identifier
+     * @param rulesetName - The ruleset name
+     * @param rulesetVersion - The ruleset version
+     * @returns True if results exist and haven't expired
+     */
+    exists(documentId: string, rulesetName: string, rulesetVersion: string): Promise<boolean>;
+    /**
+     * Invalidate all results for a specific document
+     *
+     * Useful when a document is updated and all cached results
+     * should be discarded.
+     *
+     * @param documentId - The document identifier
+     * @returns Number of invalidated jobs
+     */
+    invalidate(documentId: string): Promise<number>;
+    /**
+     * Get storage statistics
+     *
+     * @returns Storage statistics including total jobs, results, and size
+     */
+    getStats(): Promise<StorageStats>;
+    /**
+     * List jobs with filtering and pagination
+     *
+     * @param options - Filter and pagination options
+     * @returns Array of job summaries (lightweight, documentId only)
+     */
+    listJobs?(options?: ListJobsOptions): Promise<JobSummary[]>;
+    /**
+     * Retrieve job results with pagination and filtering
+     *
+     * @param jobId - The unique job identifier
+     * @param options - Pagination and filter options
+     * @returns Paginated result set with metadata
+     */
+    queryJobResults?(jobId: string, options: LintResultQueryOptions): Promise<PaginatedLintResult | null>;
+    /**
+     * Get aggregated statistics for a job's lint results
+     *
+     * @param jobId - The unique job identifier
+     * @returns Aggregated stats including rule breakdown and top paths
+     */
+    getJobStats?(jobId: string): Promise<LintResultStats | null>;
+    /**
+     * Get lint activity for a specific document
+     *
+     * @param documentId - The document identifier
+     * @returns Document lint activity summary
+     */
+    getDocumentLintActivity?(documentId: string): Promise<DocumentLintActivity | null>;
+    /**
+     * Clear all stored data
+     *
+     * USE WITH CAUTION: This removes all job results.
+     *
+     * @returns Number of jobs cleared
+     */
+    clear?(): Promise<number>;
+    /**
+     * Close/cleanup storage connection
+     *
+     * Called during graceful shutdown. Implementations should
+     * close connections, flush buffers, etc.
+     */
+    close?(): Promise<void>;
+}
+/**
+ * Create composite key for document + ruleset lookups
+ *
+ * @param documentId - The document identifier
+ * @param rulesetName - The ruleset name
+ * @param rulesetVersion - The ruleset version
+ * @returns Composite key string
+ */
+export declare function makeCompositeKey(documentId: string, rulesetName: string, rulesetVersion: string): string;
+/**
+ * Parse composite key back into components
+ *
+ * @param key - Composite key string
+ * @returns Parsed components or null if invalid
+ */
+export declare function parseCompositeKey(key: string): {
+    documentId: string;
+    rulesetName: string;
+    rulesetVersion: string;
+} | null;
+//# sourceMappingURL=storage-adapter.d.ts.map

package/build/storage/storage-adapter.d.ts.map

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

package/build/storage/storage-adapter.js

@@ -0,0 +1,36 @@
+/**
+ * Storage Adapter Interface for OpenAPI Lint Orchestrator
+ *
+ * Defines the contract for storing and retrieving lint job results.
+ * Implementations can use different backends (memory, Redis, database, etc.)
+ *
+ * @module storage/storage-adapter
+ */
+/**
+ * Create composite key for document + ruleset lookups
+ *
+ * @param documentId - The document identifier
+ * @param rulesetName - The ruleset name
+ * @param rulesetVersion - The ruleset version
+ * @returns Composite key string
+ */
+export function makeCompositeKey(documentId, rulesetName, rulesetVersion) {
+    return `${documentId}:${rulesetName}:${rulesetVersion}`;
+}
+/**
+ * Parse composite key back into components
+ *
+ * @param key - Composite key string
+ * @returns Parsed components or null if invalid
+ */
+export function parseCompositeKey(key) {
+    const parts = key.split(':');
+    if (parts.length !== 3)
+        return null;
+    return {
+        documentId: parts[0],
+        rulesetName: parts[1],
+        rulesetVersion: parts[2]
+    };
+}
+//# sourceMappingURL=storage-adapter.js.map

package/build/storage/storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.js","sourceRoot":"","sources":["../../src/storage/storage-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgMH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,WAAmB,EACnB,cAAsB;IAEtB,OAAO,GAAG,UAAU,IAAI,WAAW,IAAI,cAAc,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAK3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACpB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QACrB,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC;KACzB,CAAC;AACJ,CAAC"}