@cisco_open/linting-orchestrator 1.0.0-rc.4

package/build/mock-server.js

@@ -0,0 +1,290 @@
+// Copyright 2026 Cisco Systems, Inc. and its affiliates
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Mock HTTP Server for OpenAPI Lint Orchestrator
+ *
+ * Provides realistic responses with simulated delays for testing
+ * before implementing the full worker pool and orchestration logic.
+ *
+ * Now integrated with RulesetLoader to serve real ruleset data!
+ *
+ * Usage: npm run mock
+ */
+import Fastify from 'fastify';
+import { RulesetLoader } from './ruleset-loader.js';
+import { loadConfig } from './config.js';
+const mockServer = Fastify({ logger: true });
+// Initialize RulesetLoader
+let rulesetLoader;
+const mockJobs = new Map();
+/**
+ * Generate mock job ID
+ */
+function generateJobId() {
+    return `mock-job-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * POST /lint - Submit lint job
+ */
+mockServer.post('/lint', async (request, reply) => {
+    const { documentId, rulesetName } = request.body;
+    // Validate request
+    if (!documentId || !rulesetName) {
+        return reply.code(400).send({
+            error: 'Invalid request',
+            details: {
+                documentId: documentId ? undefined : 'Required field missing',
+                rulesetName: rulesetName ? undefined : 'Required field missing'
+            },
+            timestamp: new Date().toISOString()
+        });
+    }
+    const jobId = generateJobId();
+    const mockJob = {
+        jobId,
+        request: request.body,
+        status: 'queued',
+        startTime: new Date(),
+        progress: {
+            totalTasks: 1,
+            completedTasks: 0,
+            failedTasks: 0,
+            runningTasks: 0,
+            queuedTasks: 1
+        }
+    };
+    mockJobs.set(jobId, mockJob);
+    // Simulate async processing
+    simulateJobProcessing(jobId);
+    return reply.code(202).send({
+        jobId,
+        status: 'queued',
+        estimatedCompletion: new Date(Date.now() + 3000).toISOString(),
+        message: 'Lint job queued successfully'
+    });
+});
+/**
+ * GET /lint/:jobId - Get job status
+ */
+mockServer.get('/lint/:jobId', async (request, reply) => {
+    const { jobId } = request.params;
+    const job = mockJobs.get(jobId);
+    if (!job) {
+        return reply.code(404).send({
+            error: 'Job not found',
+            details: { jobId },
+            timestamp: new Date().toISOString()
+        });
+    }
+    return {
+        jobId: job.jobId,
+        documentId: job.request.documentId,
+        rulesetName: job.request.rulesetName,
+        rulesetVersion: job.request.rulesetVersion || '1.1.0',
+        status: job.status,
+        progress: job.progress,
+        startTime: job.startTime.toISOString(),
+        endTime: job.endTime?.toISOString(),
+        estimatedCompletion: job.status === 'running'
+            ? new Date(Date.now() + 2000).toISOString()
+            : undefined
+    };
+});
+/**
+ * GET /lint/:jobId/results - Get job results
+ */
+mockServer.get('/lint/:jobId/results', async (request, reply) => {
+    const { jobId } = request.params;
+    const job = mockJobs.get(jobId);
+    if (!job) {
+        return reply.code(404).send({
+            error: 'Job not found',
+            details: { jobId },
+            timestamp: new Date().toISOString()
+        });
+    }
+    if (job.status !== 'completed' && job.status !== 'completed_with_errors') {
+        return reply.code(202).send({
+            status: job.status,
+            message: 'Job still in progress',
+            progress: job.progress
+        });
+    }
+    // Return mock results
+    const mockResult = {
+        jobId: job.jobId,
+        documentId: job.request.documentId,
+        rulesetName: job.request.rulesetName,
+        rulesetVersion: job.request.rulesetVersion || '1.1.0',
+        status: job.status,
+        timestamp: job.endTime,
+        totalExecutionTime: 2500,
+        summary: {
+            totalIssues: 15,
+            errorCount: 5,
+            warningCount: 8,
+            infoCount: 2,
+            hintCount: 0
+        },
+        results: [
+            {
+                ruleId: 'typed-enum',
+                code: 'typed-enum',
+                message: 'Enum values must be typed',
+                severity: 0,
+                path: ['paths', '/pets', 'get', 'responses', '200', 'content', 'application/json', 'schema', 'properties', 'status'],
+                range: {
+                    start: { line: 45, character: 10 },
+                    end: { line: 45, character: 30 }
+                }
+            },
+            {
+                ruleId: 'operation-tag-defined',
+                code: 'operation-tag-defined',
+                message: 'Operation tags must be defined in global tags',
+                severity: 1,
+                path: ['paths', '/pets', 'post', 'tags', 0]
+            },
+            {
+                ruleId: 'info-contact',
+                code: 'info-contact',
+                message: 'Info object must contain contact information',
+                severity: 1,
+                path: ['info']
+            }
+        ],
+        executionDetails: {
+            rulesetName: job.request.rulesetName,
+            rulesetVersion: job.request.rulesetVersion || '1.1.0',
+            executionTime: 2500,
+            success: true,
+            issueCount: 15,
+            issues: [],
+            metadata: {
+                ruleEngine: 'spectral',
+                documentId: job.request.documentId,
+                cacheHit: false
+            }
+        }
+    };
+    return mockResult;
+});
+/**
+ * GET /rulesets - List available rulesets
+ */
+mockServer.get('/rulesets', async () => {
+    const rulesets = rulesetLoader.listRulesets();
+    return { rulesets };
+});
+/**
+ * GET /rulesets/:name - Get ruleset details
+ */
+mockServer.get('/rulesets/:name', async (request, reply) => {
+    const { name } = request.params;
+    try {
+        const ruleset = await rulesetLoader.loadVersion(name);
+        return ruleset;
+    }
+    catch (error) {
+        return reply.code(404).send({
+            error: 'Ruleset not found',
+            details: {
+                name,
+                message: error instanceof Error ? error.message : String(error)
+            },
+            timestamp: new Date().toISOString()
+        });
+    }
+});
+/**
+ * GET /health - Health check
+ */
+mockServer.get('/health', async () => {
+    return {
+        status: 'healthy',
+        timestamp: new Date().toISOString(),
+        version: '0.1.0',
+        workerPool: {
+            activeWorkers: 3,
+            maxWorkers: 15,
+            idleWorkers: 2,
+            busyWorkers: 1,
+            queueDepth: 0
+        },
+        storage: {
+            connected: true,
+            type: 'memory'
+        }
+    };
+});
+/**
+ * Simulate job processing lifecycle
+ */
+function simulateJobProcessing(jobId) {
+    const job = mockJobs.get(jobId);
+    if (!job)
+        return;
+    // After 500ms: transition to running
+    setTimeout(() => {
+        job.status = 'running';
+        job.progress.queuedTasks = 0;
+        job.progress.runningTasks = 1;
+    }, 500);
+    // After 2500ms: transition to completed
+    setTimeout(() => {
+        job.status = 'completed';
+        job.endTime = new Date();
+        job.progress.runningTasks = 0;
+        job.progress.completedTasks = 1;
+    }, 2500);
+}
+/**
+ * Start mock server
+ */
+async function start() {
+    try {
+        // Initialize RulesetLoader
+        console.log('🔧 Initializing RulesetLoader...');
+        const config = await loadConfig();
+        rulesetLoader = new RulesetLoader({
+            configPath: `${config.rulesets.directory}/config/rulesets.yaml`,
+            sourcesBasePath: `${config.rulesets.directory}/sources`,
+            enableCache: config.rulesets.cacheEnabled,
+        });
+        await rulesetLoader.initialize();
+        const rulesets = rulesetLoader.listRulesets();
+        console.log(`✅ Loaded ${rulesets.length} rulesets:`);
+        for (const ruleset of rulesets) {
+            console.log(`   - ${ruleset.displayName} (${ruleset.name}): ${ruleset.ruleCount} rules`);
+        }
+        await mockServer.listen({ port: 3003, host: '0.0.0.0' });
+        console.log('\n🚀 Mock OpenAPI Lint Orchestrator running on port 3003');
+        console.log('\nAvailable endpoints:');
+        console.log('  POST   /lint             - Submit lint job');
+        console.log('  GET    /lint/:jobId      - Get job status');
+        console.log('  GET    /lint/:jobId/results - Get job results');
+        console.log('  GET    /rulesets         - List rulesets (REAL DATA!)');
+        console.log('  GET    /rulesets/:name   - Get ruleset details (REAL DATA!)');
+        console.log('  GET    /health           - Health check');
+        console.log('\nExample:');
+        console.log('  curl -X POST http://localhost:3003/lint \\');
+        console.log('    -H "Content-Type: application/json" \\');
+        console.log('    -d \'{"documentId": "test-doc", "rulesetName": "pubhub"}\'');
+        console.log('\n  curl http://localhost:3003/rulesets');
+        console.log('  curl http://localhost:3003/rulesets/pubhub | jq .rules | head -50');
+        console.log('\n');
+    }
+    catch (err) {
+        mockServer.log.error(err);
+        process.exit(1);
+    }
+}
+// Handle shutdown gracefully
+process.on('SIGINT', async () => {
+    console.log('\n\nShutting down mock server...');
+    await mockServer.close();
+    process.exit(0);
+});
+start();
+//# sourceMappingURL=mock-server.js.map

package/build/mock-server.js.map

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

package/build/orchestrator.d.ts

@@ -0,0 +1,149 @@
+import { WorkerPoolManager } from './worker-pool.js';
+import { RulesetLoader } from './ruleset-loader.js';
+import type { DocumentStoreAdapter } from '@cisco_open/linting-document-store';
+import { LintResultStorage } from './storage/storage-adapter.js';
+import type { ReportServiceConfig } from './types.js';
+import type { LintJob, LintJobRequest, LintJobResult, WorkerPoolConfig, ListJobsOptions, ListJobsResponse, DocumentLintActivity } from './types.js';
+/**
+ * Thrown when the orchestrator has reached its maximum concurrent job capacity.
+ * The HTTP layer should translate this into a 429 Too Many Requests response.
+ */
+export declare class CapacityExceededError extends Error {
+    readonly activeJobs: number;
+    readonly maxJobs: number;
+    constructor(message: string, activeJobs: number, maxJobs: number);
+}
+export interface OrchestratorConfig {
+    workerPool: WorkerPoolConfig;
+    maxConcurrentJobs?: number;
+    enableCache?: boolean;
+    reportService?: ReportServiceConfig;
+    /** Maximum number of issues to collect per job (safety limit). Default: 100000 */
+    maxIssuesPerJob?: number;
+}
+export declare class Orchestrator {
+    private workerPool;
+    private storage;
+    private rulesetLoader;
+    private documentStore;
+    private jobs;
+    private config;
+    private initialized;
+    private cacheHits;
+    private cacheMisses;
+    private activeJobCount;
+    private reportClient;
+    private reportServiceConfig;
+    constructor(workerPool: WorkerPoolManager, storage: LintResultStorage, rulesetLoader: RulesetLoader, documentStore: DocumentStoreAdapter, config: OrchestratorConfig);
+    /**
+     * Initialize orchestrator
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize Report Service client integration
+     *
+     * Requirements:
+     * - Info logs on successful start showing version compatibility
+     * - Always try to start if configured, warn if unavailable (graceful degradation)
+     * - stopIfUnavailable flag to fail startup for production safety
+     */
+    private initializeReportClient;
+    /**
+     * Submit a new lint job
+     */
+    submitJob(request: LintJobRequest): Promise<string>;
+    /**
+     * Execute a job (run tasks via worker pool)
+     */
+    private executeJob;
+    /**
+     * Execute task with exponential backoff retry
+     */
+    private executeTaskWithRetry;
+    /**
+     * Get job status
+     */
+    getJobStatus(jobId: string): Promise<LintJob | null>;
+    /**
+     * Get job result
+     */
+    getJobResult(jobId: string): Promise<LintJobResult | null>;
+    /**
+     * Check cache for existing result
+     */
+    private checkCache;
+    /**
+     * Invalidate cache for a document
+     */
+    invalidateCache(documentId: string): Promise<void>;
+    /**
+     * Get orchestrator statistics
+     */
+    getStats(): {
+        jobs: {
+            total: number;
+            queued: number;
+            running: number;
+            completed: number;
+            failed: number;
+        };
+        capacity: {
+            activeJobs: number;
+            maxConcurrentJobs: number;
+            utilizationPercent: number;
+        };
+        cache: {
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        workers: {
+            total: number;
+            active: number;
+            idle: number;
+        };
+    };
+    /**
+     * List jobs with filtering and pagination (lightweight - documentId only)
+     */
+    listJobs(options?: ListJobsOptions, runtimeSessionId?: string): Promise<ListJobsResponse>;
+    /**
+     * List jobs with document metadata enrichment (detailed)
+     */
+    listJobsDetailed(options?: ListJobsOptions, runtimeSessionId?: string): Promise<ListJobsResponse>;
+    /**
+     * Get lint activity for a specific document
+     */
+    getDocumentLintActivity(documentId: string): Promise<DocumentLintActivity | null>;
+    /**
+     * Build JobNotification from LintJobResult for Report Service
+     */
+    private buildJobNotification;
+    /**
+     * Notify Report Service about completed job (fire-and-forget)
+     *
+     * On errors, checks compatibility to diagnose version incompatibility issues
+     */
+    private notifyReportService;
+    /**
+     * Deliver job result to callback URL (fire-and-forget).
+     * Attempts one delivery with a 10s timeout.
+     */
+    private deliverCallback;
+    /**
+     * Check if Report Service client is active
+     */
+    hasReportClient(): boolean;
+    /**
+     * Get Report Service client status
+     *
+     * Note: Compatibility check is done once at startup, not on every health check
+     * for performance reasons. This method returns current client state only.
+     */
+    getReportClientStatus(): Promise<any | null>;
+    /**
+     * Shutdown orchestrator
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/build/orchestrator.d.ts.map

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