@cisco_open/linting-orchestrator 1.0.0-rc.4

package/build/document-accessor.js

@@ -0,0 +1,148 @@
+// Copyright 2026 Cisco Systems, Inc. and its affiliates
+//
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * DocumentAccessor - Filesystem access to MCP document store
+ *
+ * Provides minimal filesystem wrapper to access OpenAPI documents
+ * stored by the MCP OpenAPI Analysis server. Uses direct filesystem
+ * access for performance (zero-copy architecture).
+ *
+ * Design: Workers receive file paths, not document content, to avoid
+ * expensive serialization across thread boundaries.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * DocumentAccessor - Direct filesystem access to MCP document store
+ */
+export class DocumentAccessor {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get absolute file path for a document ID
+     *
+     * @param documentId - Document UUID from MCP server
+     * @returns Absolute path to document JSON file
+     */
+    getDocumentPath(documentId) {
+        // MCP server stores documents as: uploads/{documentId}.json
+        return path.resolve(this.config.documentStorePath, `${documentId}.json`);
+    }
+    /**
+     * Check if document exists in filesystem
+     *
+     * @param documentId - Document UUID
+     * @returns True if file exists
+     */
+    async documentExists(documentId) {
+        const filePath = this.getDocumentPath(documentId);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get metadata about a document without loading content
+     *
+     * @param documentId - Document UUID
+     * @returns Document metadata including file stats
+     */
+    async getDocumentMetadata(documentId) {
+        const filePath = this.getDocumentPath(documentId);
+        try {
+            const stats = await fs.stat(filePath);
+            return {
+                documentId,
+                filePath,
+                exists: true,
+                size: stats.size,
+                createdAt: stats.birthtime,
+                modifiedAt: stats.mtime,
+            };
+        }
+        catch (error) {
+            return {
+                documentId,
+                filePath,
+                exists: false,
+            };
+        }
+    }
+    /**
+     * Load document content from filesystem
+     *
+     * NOTE: Workers should use this directly in their threads to avoid
+     * passing large document content across thread boundaries.
+     *
+     * @param documentId - Document UUID
+     * @returns Parsed OpenAPI document
+     */
+    async loadDocument(documentId) {
+        const filePath = this.getDocumentPath(documentId);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to load document ${documentId} from ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Validate document store accessibility
+     *
+     * @throws {Error} If document store directory is not accessible
+     */
+    async validateDocumentStore() {
+        try {
+            await fs.access(this.config.documentStorePath);
+            const stats = await fs.stat(this.config.documentStorePath);
+            if (!stats.isDirectory()) {
+                throw new Error(`Document store path is not a directory: ${this.config.documentStorePath}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Document store not accessible at ${this.config.documentStorePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * List all documents in the store
+     *
+     * @returns Array of document IDs (without .json extension)
+     */
+    async listDocuments() {
+        try {
+            const files = await fs.readdir(this.config.documentStorePath);
+            return files
+                .filter(file => file.endsWith('.json'))
+                .map(file => file.replace('.json', ''));
+        }
+        catch (error) {
+            throw new Error(`Failed to list documents in ${this.config.documentStorePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get document store statistics
+     */
+    async getStoreStats() {
+        const documents = await this.listDocuments();
+        let totalSize = 0;
+        for (const docId of documents) {
+            const metadata = await this.getDocumentMetadata(docId);
+            if (metadata.size) {
+                totalSize += metadata.size;
+            }
+        }
+        return {
+            documentCount: documents.length,
+            totalSize,
+            storePath: this.config.documentStorePath,
+        };
+    }
+}
+//# sourceMappingURL=document-accessor.js.map

package/build/document-accessor.js.map

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

package/build/formatters/reproduce-markdown.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Reproduction Markdown Generator
+ *
+ * Generates step-by-step Markdown instructions for reproducing an orchestrator
+ * lint job using only the native Spectral CLI.
+ */
+import type { LintJobResult, RulesetSourceMetadata } from '../types.js';
+/**
+ * Generate Markdown reproduction instructions for a completed lint job.
+ *
+ * Pure function — no I/O, no side effects.
+ */
+export declare function generateReproductionMarkdown(jobResult: LintJobResult, sourceMetadata: RulesetSourceMetadata): string;
+//# sourceMappingURL=reproduce-markdown.d.ts.map

package/build/formatters/reproduce-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproduce-markdown.d.ts","sourceRoot":"","sources":["../../src/formatters/reproduce-markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAiB,MAAM,aAAa,CAAC;AAiGvF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,qBAAqB,GACpC,MAAM,CA0FR"}

package/build/formatters/reproduce-markdown.js

@@ -0,0 +1,182 @@
+/**
+ * Reproduction Markdown Generator
+ *
+ * Generates step-by-step Markdown instructions for reproducing an orchestrator
+ * lint job using only the native Spectral CLI.
+ */
+/**
+ * Determine the git checkout target from the source version.
+ * Date-based versions (e.g., "2025-11-19") → "main" (no tag exists).
+ * Semver-like versions → use as tag (e.g., "v1.1.0" or "1.1.0").
+ */
+function getCheckoutTarget(sourceVersion) {
+    // Date pattern: YYYY-MM-DD (with optional suffix)
+    if (/^\d{4}-\d{2}-\d{2}/.test(sourceVersion)) {
+        return { ref: 'main', isDateBased: true };
+    }
+    // Assume semver — prefix with "v" if not already present
+    const ref = sourceVersion.startsWith('v') ? sourceVersion : `v${sourceVersion}`;
+    return { ref, isDateBased: false };
+}
+/**
+ * Extract the repository name from its URL.
+ * "https://github.com/CiscoDevNet/api-insights-openapi-rulesets" → "api-insights-openapi-rulesets"
+ */
+function getRepoName(repositoryUrl) {
+    const cleaned = repositoryUrl.replace(/\/+$/, '').replace(/\.git$/, '');
+    return cleaned.split('/').pop() || 'ruleset';
+}
+/**
+ * Generate the rule overrides section of the Markdown, including:
+ * - Summary table of overrides
+ * - YAML wrapper ruleset example
+ * - JS wrapper fallback note
+ */
+function generateOverridesSection(ruleOverrides, entrypoint) {
+    const entries = Object.entries(ruleOverrides);
+    if (entries.length === 0)
+        return '';
+    // Build overrides table
+    const tableRows = entries.map(([rule, severity]) => {
+        const effect = severity === 'off'
+            ? 'Rule excluded from results'
+            : `Severity changed to ${severity}`;
+        return `| \`${rule}\` | \`${severity}\` | ${effect} |`;
+    });
+    // Build YAML rules block for wrapper
+    const yamlRules = entries
+        .map(([rule, severity]) => `      ${rule}: "${severity}"`)
+        .join('\n');
+    // Build JS rules object for fallback
+    const jsRules = entries
+        .map(([rule, severity]) => `        '${rule}': '${severity}'`)
+        .join(',\n');
+    return `
+## Step 3: Configure Rule Overrides
+
+The original lint run applied the following rule overrides:
+
+| Rule | Override | Effect |
+|------|----------|--------|
+${tableRows.join('\n')}
+
+To reproduce the same behavior with Spectral, create a **wrapper ruleset** that extends the original and adds an [overrides section](https://docs.stoplight.io/docs/spectral/293426e270fac-overrides).
+
+Save the following as \`spectify-overrides.yaml\` in the same directory as the cloned ruleset:
+
+\`\`\`yaml
+extends:
+  - ./${entrypoint}
+overrides:
+  - files:
+      - "**"
+    rules:
+${yamlRules}
+\`\`\`
+
+> **Note:** This is provided as an example. You can also add the \`overrides\` section directly to \`${entrypoint}\` instead of creating a wrapper file.
+
+> **Troubleshooting:** If overrides don't take effect (rare edge case with deeply nested \`extends\` chains), use a JavaScript wrapper instead:
+> \`\`\`js
+> // spectify-overrides.mjs
+> export default {
+>   extends: ['./${entrypoint}'],
+>   overrides: [
+>     {
+>       files: ['**'],
+>       rules: {
+${jsRules}
+>       }
+>     }
+>   ]
+> };
+> \`\`\`
+`;
+}
+/**
+ * Generate Markdown reproduction instructions for a completed lint job.
+ *
+ * Pure function — no I/O, no side effects.
+ */
+export function generateReproductionMarkdown(jobResult, sourceMetadata) {
+    const repoName = getRepoName(sourceMetadata.repositoryUrl);
+    const { ref, isDateBased } = getCheckoutTarget(sourceMetadata.sourceVersion);
+    const hasOverrides = jobResult.ruleOverrides && Object.keys(jobResult.ruleOverrides).length > 0;
+    const rulesetFile = hasOverrides ? 'spectify-overrides.yaml' : sourceMetadata.entrypoint;
+    const overrideCount = hasOverrides ? Object.keys(jobResult.ruleOverrides).length : 0;
+    // Step numbering shifts when overrides are present
+    const runStepNumber = hasOverrides ? 4 : 3;
+    const lines = [];
+    // ── Header ──
+    lines.push(`# Spectral Reproduction: ${sourceMetadata.displayName}`);
+    lines.push('');
+    // ── Job Information ──
+    lines.push('## Job Information');
+    lines.push('');
+    lines.push('| Field | Value |');
+    lines.push('|-------|-------|');
+    lines.push(`| Job ID | \`${jobResult.jobId}\` |`);
+    lines.push(`| Ruleset | ${sourceMetadata.rulesetName} (${sourceMetadata.displayName}) |`);
+    lines.push(`| Version | ${sourceMetadata.version} |`);
+    lines.push(`| Document ID | \`${jobResult.documentId}\` |`);
+    lines.push(`| Timestamp | ${jobResult.timestamp instanceof Date ? jobResult.timestamp.toISOString() : jobResult.timestamp} |`);
+    if (hasOverrides) {
+        lines.push(`| Rule Overrides | ${overrideCount} rule${overrideCount !== 1 ? 's' : ''} modified (see below) |`);
+    }
+    lines.push('');
+    // ── Prerequisites ──
+    lines.push('## Prerequisites');
+    lines.push('');
+    lines.push('```bash');
+    lines.push('# Install Spectral CLI (if not already installed)');
+    lines.push('npm install -g @stoplight/spectral-cli');
+    lines.push('');
+    lines.push('# Verify installation');
+    lines.push('spectral --version');
+    lines.push('```');
+    lines.push('');
+    // ── Step 1: Clone ──
+    lines.push('## Step 1: Clone the Ruleset');
+    lines.push('');
+    lines.push('```bash');
+    lines.push(`git clone ${sourceMetadata.repositoryUrl}`);
+    lines.push(`cd ${repoName}`);
+    if (isDateBased) {
+        lines.push(`# Source is a snapshot from ${sourceMetadata.sourceVersion} — using main branch`);
+        lines.push(`git checkout ${ref}`);
+    }
+    else {
+        lines.push(`git checkout ${ref}`);
+    }
+    lines.push('```');
+    lines.push('');
+    // ── Step 2: Install Dependencies ──
+    if (sourceMetadata.hasPackageJson) {
+        lines.push('## Step 2: Install Dependencies');
+        lines.push('');
+        lines.push('```bash');
+        lines.push('npm install');
+        lines.push('```');
+        lines.push('');
+    }
+    // ── Step 3 (optional): Rule Overrides ──
+    if (hasOverrides) {
+        lines.push(generateOverridesSection(jobResult.ruleOverrides, sourceMetadata.entrypoint));
+    }
+    // ── Run Spectral ──
+    lines.push(`## Step ${runStepNumber}: Run Spectral`);
+    lines.push('');
+    lines.push('```bash');
+    lines.push(`spectral lint <your-document.yaml> --ruleset ${rulesetFile}`);
+    lines.push('```');
+    lines.push('');
+    lines.push('Replace `<your-document.yaml>` with the path to your OpenAPI document.');
+    lines.push('');
+    // ── Footer ──
+    lines.push('---');
+    lines.push('');
+    lines.push(`*Generated by the linting orchestrator — reproduced from job \`${jobResult.jobId}\`*`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=reproduce-markdown.js.map

package/build/formatters/reproduce-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproduce-markdown.js","sourceRoot":"","sources":["../../src/formatters/reproduce-markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,aAAqB;IAC9C,kDAAkD;IAClD,IAAI,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,yDAAyD;IACzD,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC;IAChF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,aAAqB;IACxC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,aAA4B,EAAE,UAAkB;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,wBAAwB;IACxB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,QAAQ,KAAK,KAAK;YAC/B,CAAC,CAAC,4BAA4B;YAC9B,CAAC,CAAC,uBAAuB,QAAQ,EAAE,CAAC;QACtC,OAAO,OAAO,IAAI,UAAU,QAAQ,QAAQ,MAAM,IAAI,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,SAAS,GAAG,OAAO;SACtB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,SAAS,IAAI,MAAM,QAAQ,GAAG,CAAC;SACzD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,qCAAqC;IACrC,MAAM,OAAO,GAAG,OAAO;SACpB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,YAAY,IAAI,OAAO,QAAQ,GAAG,CAAC;SAC7D,IAAI,CAAC,KAAK,CAAC,CAAC;IAEf,OAAO;;;;;;;EAOP,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;QAQd,UAAU;;;;;EAKhB,SAAS;;;uGAG4F,UAAU;;;;;;mBAM9F,UAAU;;;;;EAK3B,OAAO;;;;;;CAMR,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,SAAwB,EACxB,cAAqC;IAErC,MAAM,QAAQ,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAChG,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC;IACzF,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,aAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtF,mDAAmD;IACnD,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,eAAe;IACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,wBAAwB;IACxB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,eAAe,cAAc,CAAC,WAAW,KAAK,cAAc,CAAC,WAAW,KAAK,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,eAAe,cAAc,CAAC,OAAO,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,qBAAqB,SAAS,CAAC,UAAU,MAAM,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC;IAC/H,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,sBAAsB,aAAa,QAAQ,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IACjH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,aAAa,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;IAC7B,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,+BAA+B,cAAc,CAAC,aAAa,sBAAsB,CAAC,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,qCAAqC;IACrC,IAAI,cAAc,CAAC,cAAc,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,0CAA0C;IAC1C,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,aAAc,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,IAAI,CAAC,WAAW,aAAa,gBAAgB,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,gDAAgD,WAAW,EAAE,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACrF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,eAAe;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kEAAkE,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC;IACnG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/build/formatters/sarif-builder.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SARIF 2.1.0 Builder
+ *
+ * Transforms LintJobResult into SARIF (Static Analysis Results Interchange Format)
+ * Spec: https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html
+ *
+ * @module formatters/sarif-builder
+ */
+import type { LintJobResult, SarifReport, ReportGenerationOptions } from '../types.js';
+/**
+ * SarifBuilder - Converts lint results to SARIF 2.1.0 format
+ */
+export declare class SarifBuilder {
+    /**
+     * Build a complete SARIF report from lint job result
+     */
+    buildSarif(result: LintJobResult, options?: ReportGenerationOptions): SarifReport;
+    /**
+     * Build a SARIF run from lint result
+     */
+    private buildRun;
+    /**
+     * Build tool metadata
+     */
+    private buildTool;
+    /**
+     * Build rule catalog from lint issues
+     * Creates unique rule entries from all issues
+     */
+    private buildRules;
+    /**
+     * Extract short description from message (first sentence or up to 80 chars)
+     */
+    private extractShortDescription;
+    /**
+     * Build help URI for a rule
+     */
+    private buildHelpUri;
+    /**
+     * Extract category from issue (if available in path or code)
+     */
+    private extractCategory;
+    /**
+     * Extract tags from issue
+     */
+    private extractTags;
+    /**
+     * Map severity to SARIF level
+     */
+    private mapSeverityToSarifLevel;
+    /**
+     * Build artifact metadata (document being analyzed)
+     */
+    private buildArtifacts;
+    /**
+     * Build SARIF results from lint issues
+     */
+    private buildResults;
+    /**
+     * Build a single SARIF result from a lint issue
+     */
+    private buildResult;
+    /**
+     * Build locations for an issue
+     */
+    private buildLocations;
+    /**
+     * Build region (line/column range) for an issue
+     */
+    private buildRegion;
+    /**
+     * Generate fingerprints for deduplication
+     * Uses primaryLocationLineHash scheme (path + line + rule)
+     */
+    private generateFingerprints;
+    /**
+     * Build primary location hash for fingerprinting
+     * Format: hash(documentId + path + line + ruleId)
+     */
+    private buildPrimaryLocationHash;
+    /**
+     * Build run properties (orchestrator-specific metadata)
+     */
+    private buildRunProperties;
+}
+//# sourceMappingURL=sarif-builder.d.ts.map

package/build/formatters/sarif-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif-builder.d.ts","sourceRoot":"","sources":["../../src/formatters/sarif-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,aAAa,EAEb,WAAW,EASX,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,WAAW;IAQjF;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA4BlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAqB3B"}