@oculum/scanner 1.0.11 → 1.0.12

package/dist/formatters/ide/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * IDE Integration Module
+ * Exports formatters and utilities for IDE-specific config files
+ */
+export { formatCursorRules } from './cursor';
+export { formatWindsurfRules } from './windsurf';
+export { formatClaudeCodeSection, OCULUM_SECTION_START, OCULUM_SECTION_END } from './claude-code';
+/** Supported IDE types */
+export type IDEType = 'cursor' | 'windsurf' | 'claude-code';
+/** Default file paths for each IDE */
+export declare const IDE_FILE_PATHS: Record<IDEType, string>;
+/** Result of a file write operation */
+export interface WriteIDEFileResult {
+    success: boolean;
+    path: string;
+    error?: string;
+}
+/** Result of a file clear operation */
+export interface ClearIDEFilesResult {
+    success: boolean;
+    clearedFiles: string[];
+    errors: string[];
+}
+/**
+ * Detect which IDE configurations exist in the project
+ *
+ * @param projectPath - Path to the project root
+ * @returns Array of detected IDE types
+ */
+export declare function detectIDEConfigs(projectPath: string): IDEType[];
+/**
+ * Write an IDE-specific file
+ *
+ * @param projectPath - Path to the project root
+ * @param relativePath - Relative path for the file
+ * @param content - Content to write
+ * @returns Result object
+ */
+export declare function writeIDEFile(projectPath: string, relativePath: string, content: string): WriteIDEFileResult;
+/**
+ * Update the Oculum section in CLAUDE.md
+ * Replaces content between OCULUM_SECURITY_START and OCULUM_SECURITY_END markers
+ * If markers don't exist, appends the section at the end
+ *
+ * @param projectPath - Path to the project root
+ * @param section - The section content (including markers)
+ * @returns Result object
+ */
+export declare function updateClaudeMdSection(projectPath: string, section: string): WriteIDEFileResult;
+/**
+ * Clear IDE rule files
+ *
+ * @param projectPath - Path to the project root
+ * @param types - Optional array of IDE types to clear. If not provided, clears all.
+ * @returns Result object with list of cleared files
+ */
+export declare function clearIDEFiles(projectPath: string, types?: IDEType[]): ClearIDEFilesResult;
+/**
+ * Get the default file path for an IDE type
+ */
+export declare function getIDEFilePath(ide: IDEType): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/formatters/ide/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formatters/ide/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEjG,0BAA0B;AAC1B,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAA;AAE3D,sCAAsC;AACtC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAIlD,CAAA;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAmB/D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,kBAAkB,CAqBpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,kBAAkB,CAwCpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,GAChB,mBAAmB,CA6CrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/formatters/ide/index.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * IDE Integration Module
+ * Exports formatters and utilities for IDE-specific config files
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDE_FILE_PATHS = exports.OCULUM_SECTION_END = exports.OCULUM_SECTION_START = exports.formatClaudeCodeSection = exports.formatWindsurfRules = exports.formatCursorRules = void 0;
+exports.detectIDEConfigs = detectIDEConfigs;
+exports.writeIDEFile = writeIDEFile;
+exports.updateClaudeMdSection = updateClaudeMdSection;
+exports.clearIDEFiles = clearIDEFiles;
+exports.getIDEFilePath = getIDEFilePath;
+const fs_1 = require("fs");
+const path_1 = require("path");
+// Export formatters
+var cursor_1 = require("./cursor");
+Object.defineProperty(exports, "formatCursorRules", { enumerable: true, get: function () { return cursor_1.formatCursorRules; } });
+var windsurf_1 = require("./windsurf");
+Object.defineProperty(exports, "formatWindsurfRules", { enumerable: true, get: function () { return windsurf_1.formatWindsurfRules; } });
+var claude_code_1 = require("./claude-code");
+Object.defineProperty(exports, "formatClaudeCodeSection", { enumerable: true, get: function () { return claude_code_1.formatClaudeCodeSection; } });
+Object.defineProperty(exports, "OCULUM_SECTION_START", { enumerable: true, get: function () { return claude_code_1.OCULUM_SECTION_START; } });
+Object.defineProperty(exports, "OCULUM_SECTION_END", { enumerable: true, get: function () { return claude_code_1.OCULUM_SECTION_END; } });
+/** Default file paths for each IDE */
+exports.IDE_FILE_PATHS = {
+    cursor: '.cursor/rules/security.mdc',
+    windsurf: '.windsurfrules',
+    'claude-code': 'CLAUDE.md',
+};
+/**
+ * Detect which IDE configurations exist in the project
+ *
+ * @param projectPath - Path to the project root
+ * @returns Array of detected IDE types
+ */
+function detectIDEConfigs(projectPath) {
+    const detected = [];
+    // Check for Cursor
+    if ((0, fs_1.existsSync)((0, path_1.join)(projectPath, '.cursor'))) {
+        detected.push('cursor');
+    }
+    // Check for Windsurf rules
+    if ((0, fs_1.existsSync)((0, path_1.join)(projectPath, '.windsurfrules'))) {
+        detected.push('windsurf');
+    }
+    // Check for Claude Code
+    if ((0, fs_1.existsSync)((0, path_1.join)(projectPath, 'CLAUDE.md'))) {
+        detected.push('claude-code');
+    }
+    return detected;
+}
+/**
+ * Write an IDE-specific file
+ *
+ * @param projectPath - Path to the project root
+ * @param relativePath - Relative path for the file
+ * @param content - Content to write
+ * @returns Result object
+ */
+function writeIDEFile(projectPath, relativePath, content) {
+    const fullPath = (0, path_1.join)(projectPath, relativePath);
+    try {
+        // Ensure directory exists
+        const dir = (0, path_1.dirname)(fullPath);
+        if (!(0, fs_1.existsSync)(dir)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        }
+        // Write file
+        (0, fs_1.writeFileSync)(fullPath, content);
+        return { success: true, path: fullPath };
+    }
+    catch (err) {
+        return {
+            success: false,
+            path: fullPath,
+            error: `Failed to write ${relativePath}: ${err instanceof Error ? err.message : 'Unknown error'}`,
+        };
+    }
+}
+/**
+ * Update the Oculum section in CLAUDE.md
+ * Replaces content between OCULUM_SECURITY_START and OCULUM_SECURITY_END markers
+ * If markers don't exist, appends the section at the end
+ *
+ * @param projectPath - Path to the project root
+ * @param section - The section content (including markers)
+ * @returns Result object
+ */
+function updateClaudeMdSection(projectPath, section) {
+    const filePath = (0, path_1.join)(projectPath, 'CLAUDE.md');
+    try {
+        let content;
+        if ((0, fs_1.existsSync)(filePath)) {
+            content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+            // Check if markers exist
+            const startMarker = '<!-- OCULUM_SECURITY_START -->';
+            const endMarker = '<!-- OCULUM_SECURITY_END -->';
+            const startIndex = content.indexOf(startMarker);
+            const endIndex = content.indexOf(endMarker);
+            if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+                // Replace existing section
+                content =
+                    content.substring(0, startIndex) +
+                        section +
+                        content.substring(endIndex + endMarker.length);
+            }
+            else {
+                // Append section at end
+                content = content.trimEnd() + '\n\n' + section;
+            }
+        }
+        else {
+            // Create new file with section
+            content = `# CLAUDE.md\n\n${section}`;
+        }
+        (0, fs_1.writeFileSync)(filePath, content);
+        return { success: true, path: filePath };
+    }
+    catch (err) {
+        return {
+            success: false,
+            path: filePath,
+            error: `Failed to update CLAUDE.md: ${err instanceof Error ? err.message : 'Unknown error'}`,
+        };
+    }
+}
+/**
+ * Clear IDE rule files
+ *
+ * @param projectPath - Path to the project root
+ * @param types - Optional array of IDE types to clear. If not provided, clears all.
+ * @returns Result object with list of cleared files
+ */
+function clearIDEFiles(projectPath, types) {
+    const toCheck = types || ['cursor', 'windsurf', 'claude-code'];
+    const clearedFiles = [];
+    const errors = [];
+    for (const ide of toCheck) {
+        const relativePath = exports.IDE_FILE_PATHS[ide];
+        const fullPath = (0, path_1.join)(projectPath, relativePath);
+        try {
+            if (ide === 'claude-code') {
+                // For CLAUDE.md, remove only the Oculum section, not the whole file
+                if ((0, fs_1.existsSync)(fullPath)) {
+                    const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+                    const startMarker = '<!-- OCULUM_SECURITY_START -->';
+                    const endMarker = '<!-- OCULUM_SECURITY_END -->';
+                    const startIndex = content.indexOf(startMarker);
+                    const endIndex = content.indexOf(endMarker);
+                    if (startIndex !== -1 && endIndex !== -1) {
+                        // Remove section (including potential surrounding newlines)
+                        let newContent = content.substring(0, startIndex) + content.substring(endIndex + endMarker.length);
+                        // Clean up extra newlines
+                        newContent = newContent.replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
+                        (0, fs_1.writeFileSync)(fullPath, newContent);
+                        clearedFiles.push(relativePath);
+                    }
+                }
+            }
+            else {
+                // For other IDEs, delete the file
+                if ((0, fs_1.existsSync)(fullPath)) {
+                    (0, fs_1.unlinkSync)(fullPath);
+                    clearedFiles.push(relativePath);
+                }
+            }
+        }
+        catch (err) {
+            errors.push(`Failed to clear ${relativePath}: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        }
+    }
+    return {
+        success: errors.length === 0,
+        clearedFiles,
+        errors,
+    };
+}
+/**
+ * Get the default file path for an IDE type
+ */
+function getIDEFilePath(ide) {
+    return exports.IDE_FILE_PATHS[ide];
+}
+//# sourceMappingURL=index.js.map

package/dist/formatters/ide/index.js.map

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

package/dist/formatters/ide/windsurf.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Windsurf IDE Integration
+ * Generates .windsurfrules format
+ */
+import type { ScanResult } from '../../types';
+/**
+ * Format scan result as Windsurf rules
+ *
+ * @param result - The scan result to format
+ * @returns Markdown string for .windsurfrules
+ */
+export declare function formatWindsurfRules(result: ScanResult): string;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/formatters/ide/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../../src/formatters/ide/windsurf.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAwC,MAAM,aAAa,CAAA;AA0BnF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiG9D"}

package/dist/formatters/ide/windsurf.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Windsurf IDE Integration
+ * Generates .windsurfrules format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatWindsurfRules = formatWindsurfRules;
+const grouping_1 = require("../grouping");
+/**
+ * Get security pattern rule for a category
+ */
+function getPatternRule(category) {
+    const rules = {
+        sql_injection: 'ALWAYS use parameterized queries for database operations.',
+        xss: 'ALWAYS escape user input before inserting into HTML.',
+        hardcoded_secret: 'NEVER hardcode secrets, API keys, or credentials in source code.',
+        high_entropy_string: 'NEVER commit high-entropy strings that could be secrets.',
+        missing_auth: 'ALWAYS add authentication middleware to API endpoints.',
+        dangerous_function: 'NEVER use eval(), exec(), or similar functions with user input.',
+        command_injection: 'ALWAYS sanitize input before passing to shell commands.',
+        sensitive_url: 'NEVER hardcode localhost or internal URLs in production code.',
+        insecure_config: 'ALWAYS review configuration files for security issues.',
+        data_exposure: 'NEVER log or expose sensitive data in error messages.',
+        weak_crypto: 'ALWAYS use strong cryptographic algorithms (avoid MD5, SHA1).',
+        ai_prompt_injection: 'ALWAYS sanitize user input before including in AI prompts.',
+        ai_unsafe_execution: 'NEVER execute code generated by AI without validation.',
+    };
+    return rules[category] || null;
+}
+/**
+ * Format scan result as Windsurf rules
+ *
+ * @param result - The scan result to format
+ * @returns Markdown string for .windsurfrules
+ */
+function formatWindsurfRules(result) {
+    const { vulnerabilities, timestamp } = result;
+    // Sort by severity
+    const sorted = (0, grouping_1.sortBySeverity)(vulnerabilities);
+    let md = '';
+    // Header
+    md += `# Oculum Security Rules\n\n`;
+    md += `> Generated: ${timestamp}\n\n`;
+    // No findings case
+    if (vulnerabilities.length === 0) {
+        md += `## Status\n\n`;
+        md += `No security issues found.\n\n`;
+        md += `*Run \`oculum scan --windsurf --clear\` to remove this file.*\n`;
+        return md;
+    }
+    // Security Issues Section
+    md += `## Security Issues\n\n`;
+    md += `The following security issues were detected and need attention:\n\n`;
+    // Group by file
+    const byFile = new Map();
+    for (const vuln of sorted) {
+        const group = byFile.get(vuln.filePath) || [];
+        group.push(vuln);
+        byFile.set(vuln.filePath, group);
+    }
+    // List by file
+    for (const [filePath, vulns] of byFile) {
+        md += `### ${filePath}\n\n`;
+        for (const vuln of vulns) {
+            const severityEmoji = vuln.severity === 'critical' ? '!!' :
+                vuln.severity === 'high' ? '!' :
+                    vuln.severity === 'medium' ? '*' : '-';
+            md += `- ${severityEmoji} **Line ${vuln.lineNumber}:** ${vuln.title}`;
+            if (vuln.suggestedFix) {
+                md += ` - ${vuln.suggestedFix}`;
+            }
+            md += '\n';
+        }
+        md += '\n';
+    }
+    // Code Patterns Section
+    md += `## Code Patterns\n\n`;
+    md += `Follow these security patterns when writing code:\n\n`;
+    // Collect unique pattern rules
+    const patternRules = new Set();
+    for (const vuln of vulnerabilities) {
+        const rule = getPatternRule(vuln.category);
+        if (rule) {
+            patternRules.add(rule);
+        }
+    }
+    for (const rule of patternRules) {
+        md += `- ${rule}\n`;
+    }
+    md += '\n';
+    // Quick Reference
+    md += `## Quick Reference\n\n`;
+    md += `| Severity | Count | Action |\n`;
+    md += `|----------|-------|--------|\n`;
+    const { severityCounts } = result;
+    if (severityCounts.critical > 0) {
+        md += `| Critical | ${severityCounts.critical} | Fix immediately |\n`;
+    }
+    if (severityCounts.high > 0) {
+        md += `| High | ${severityCounts.high} | Fix before commit |\n`;
+    }
+    if (severityCounts.medium > 0) {
+        md += `| Medium | ${severityCounts.medium} | Review and fix |\n`;
+    }
+    if (severityCounts.low > 0) {
+        md += `| Low | ${severityCounts.low} | Consider fixing |\n`;
+    }
+    if (severityCounts.info > 0) {
+        md += `| Info | ${severityCounts.info} | For awareness |\n`;
+    }
+    md += '\n';
+    // Footer
+    md += `---\n\n`;
+    md += `*Run \`oculum scan\` to verify fixes. Run \`oculum scan --windsurf --clear\` to remove this file.*\n`;
+    return md;
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/formatters/ide/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../src/formatters/ide/windsurf.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAkCH,kDAiGC;AAhID,0CAA4C;AAE5C;;GAEG;AACH,SAAS,cAAc,CAAC,QAA+B;IACrD,MAAM,KAAK,GAAmD;QAC5D,aAAa,EAAE,2DAA2D;QAC1E,GAAG,EAAE,sDAAsD;QAC3D,gBAAgB,EAAE,kEAAkE;QACpF,mBAAmB,EAAE,0DAA0D;QAC/E,YAAY,EAAE,wDAAwD;QACtE,kBAAkB,EAAE,iEAAiE;QACrF,iBAAiB,EAAE,yDAAyD;QAC5E,aAAa,EAAE,+DAA+D;QAC9E,eAAe,EAAE,wDAAwD;QACzE,aAAa,EAAE,uDAAuD;QACtE,WAAW,EAAE,+DAA+D;QAC5E,mBAAmB,EAAE,4DAA4D;QACjF,mBAAmB,EAAE,wDAAwD;KAC9E,CAAA;IAED,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAA;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAkB;IACpD,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,MAAM,CAAA;IAE7C,mBAAmB;IACnB,MAAM,MAAM,GAAG,IAAA,yBAAc,EAAC,eAAe,CAAC,CAAA;IAE9C,IAAI,EAAE,GAAG,EAAE,CAAA;IAEX,SAAS;IACT,EAAE,IAAI,6BAA6B,CAAA;IACnC,EAAE,IAAI,gBAAgB,SAAS,MAAM,CAAA;IAErC,mBAAmB;IACnB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,EAAE,IAAI,eAAe,CAAA;QACrB,EAAE,IAAI,+BAA+B,CAAA;QACrC,EAAE,IAAI,iEAAiE,CAAA;QACvE,OAAO,EAAE,CAAA;IACX,CAAC;IAED,0BAA0B;IAC1B,EAAE,IAAI,wBAAwB,CAAA;IAC9B,EAAE,IAAI,qEAAqE,CAAA;IAE3E,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAA;IACjD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC7C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,eAAe;IACf,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACvC,EAAE,IAAI,OAAO,QAAQ,MAAM,CAAA;QAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,aAAa,GACjB,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAChC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YAExC,EAAE,IAAI,KAAK,aAAa,WAAW,IAAI,CAAC,UAAU,OAAO,IAAI,CAAC,KAAK,EAAE,CAAA;YACrE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,EAAE,IAAI,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;YACjC,CAAC;YACD,EAAE,IAAI,IAAI,CAAA;QACZ,CAAC;QACD,EAAE,IAAI,IAAI,CAAA;IACZ,CAAC;IAED,wBAAwB;IACxB,EAAE,IAAI,sBAAsB,CAAA;IAC5B,EAAE,IAAI,uDAAuD,CAAA;IAE7D,+BAA+B;IAC/B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAA;IACtC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,EAAE,IAAI,KAAK,IAAI,IAAI,CAAA;IACrB,CAAC;IACD,EAAE,IAAI,IAAI,CAAA;IAEV,kBAAkB;IAClB,EAAE,IAAI,wBAAwB,CAAA;IAC9B,EAAE,IAAI,iCAAiC,CAAA;IACvC,EAAE,IAAI,iCAAiC,CAAA;IAEvC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAA;IACjC,IAAI,cAAc,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChC,EAAE,IAAI,gBAAgB,cAAc,CAAC,QAAQ,wBAAwB,CAAA;IACvE,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC5B,EAAE,IAAI,YAAY,cAAc,CAAC,IAAI,0BAA0B,CAAA;IACjE,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,EAAE,IAAI,cAAc,cAAc,CAAC,MAAM,uBAAuB,CAAA;IAClE,CAAC;IACD,IAAI,cAAc,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QAC3B,EAAE,IAAI,WAAW,cAAc,CAAC,GAAG,wBAAwB,CAAA;IAC7D,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC5B,EAAE,IAAI,YAAY,cAAc,CAAC,IAAI,sBAAsB,CAAA;IAC7D,CAAC;IACD,EAAE,IAAI,IAAI,CAAA;IAEV,SAAS;IACT,EAAE,IAAI,SAAS,CAAA;IACf,EAAE,IAAI,sGAAsG,CAAA;IAE5G,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/formatters/index.d.ts

@@ -3,6 +3,8 @@
  * Export all formatting utilities for different workflows
  */
 export { groupByTheme, limitPerGroup, sortBySeverity, getBlockingIssues, getActionableIssues, getRiskTheme, THEME_CONFIG, type RiskTheme, type GroupedFindings, } from './grouping';
+export { formatAIContext, type AIContextOptions, } from './ai-context';
+export { formatCursorRules, formatWindsurfRules, formatClaudeCodeSection, detectIDEConfigs, writeIDEFile, updateClaudeMdSection, clearIDEFiles, getIDEFilePath, OCULUM_SECTION_START, OCULUM_SECTION_END, IDE_FILE_PATHS, type IDEType, type WriteIDEFileResult, type ClearIDEFilesResult, } from './ide';
 export { formatGitHubComment, formatShortStatus, formatAnnotation, type GitHubCommentOptions, } from './github-comment';
 export { formatDiagnostic, formatDiagnosticsByFile, generateCodeAction, formatForProblemsPanel, DiagnosticSeverity, type Diagnostic, type DiagnosticsByFile, type CodeAction, type Position, type Range, } from './vscode-diagnostic';
 export { formatTerminalOutput, formatSimpleList, formatJSON, formatSARIF, formatCompactSummary, getNumberedFindings, formatFindingDetail, type CompactSummaryOptions, } from './cli-terminal';

package/dist/formatters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,KAAK,GACX,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,OAAO,CAAA;AAGd,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,KAAK,GACX,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAA"}

package/dist/formatters/index.js

@@ -4,7 +4,7 @@
  * Export all formatting utilities for different workflows
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatFindingDetail = exports.getNumberedFindings = exports.formatCompactSummary = exports.formatSARIF = exports.formatJSON = exports.formatSimpleList = exports.formatTerminalOutput = exports.DiagnosticSeverity = exports.formatForProblemsPanel = exports.generateCodeAction = exports.formatDiagnosticsByFile = exports.formatDiagnostic = exports.formatAnnotation = exports.formatShortStatus = exports.formatGitHubComment = exports.THEME_CONFIG = exports.getRiskTheme = exports.getActionableIssues = exports.getBlockingIssues = exports.sortBySeverity = exports.limitPerGroup = exports.groupByTheme = void 0;
+exports.formatFindingDetail = exports.getNumberedFindings = exports.formatCompactSummary = exports.formatSARIF = exports.formatJSON = exports.formatSimpleList = exports.formatTerminalOutput = exports.DiagnosticSeverity = exports.formatForProblemsPanel = exports.generateCodeAction = exports.formatDiagnosticsByFile = exports.formatDiagnostic = exports.formatAnnotation = exports.formatShortStatus = exports.formatGitHubComment = exports.IDE_FILE_PATHS = exports.OCULUM_SECTION_END = exports.OCULUM_SECTION_START = exports.getIDEFilePath = exports.clearIDEFiles = exports.updateClaudeMdSection = exports.writeIDEFile = exports.detectIDEConfigs = exports.formatClaudeCodeSection = exports.formatWindsurfRules = exports.formatCursorRules = exports.formatAIContext = exports.THEME_CONFIG = exports.getRiskTheme = exports.getActionableIssues = exports.getBlockingIssues = exports.sortBySeverity = exports.limitPerGroup = exports.groupByTheme = void 0;
 // Grouping utilities
 var grouping_1 = require("./grouping");
 Object.defineProperty(exports, "groupByTheme", { enumerable: true, get: function () { return grouping_1.groupByTheme; } });
@@ -14,6 +14,22 @@ Object.defineProperty(exports, "getBlockingIssues", { enumerable: true, get: fun
 Object.defineProperty(exports, "getActionableIssues", { enumerable: true, get: function () { return grouping_1.getActionableIssues; } });
 Object.defineProperty(exports, "getRiskTheme", { enumerable: true, get: function () { return grouping_1.getRiskTheme; } });
 Object.defineProperty(exports, "THEME_CONFIG", { enumerable: true, get: function () { return grouping_1.THEME_CONFIG; } });
+// AI Context formatter
+var ai_context_1 = require("./ai-context");
+Object.defineProperty(exports, "formatAIContext", { enumerable: true, get: function () { return ai_context_1.formatAIContext; } });
+// IDE integrations
+var ide_1 = require("./ide");
+Object.defineProperty(exports, "formatCursorRules", { enumerable: true, get: function () { return ide_1.formatCursorRules; } });
+Object.defineProperty(exports, "formatWindsurfRules", { enumerable: true, get: function () { return ide_1.formatWindsurfRules; } });
+Object.defineProperty(exports, "formatClaudeCodeSection", { enumerable: true, get: function () { return ide_1.formatClaudeCodeSection; } });
+Object.defineProperty(exports, "detectIDEConfigs", { enumerable: true, get: function () { return ide_1.detectIDEConfigs; } });
+Object.defineProperty(exports, "writeIDEFile", { enumerable: true, get: function () { return ide_1.writeIDEFile; } });
+Object.defineProperty(exports, "updateClaudeMdSection", { enumerable: true, get: function () { return ide_1.updateClaudeMdSection; } });
+Object.defineProperty(exports, "clearIDEFiles", { enumerable: true, get: function () { return ide_1.clearIDEFiles; } });
+Object.defineProperty(exports, "getIDEFilePath", { enumerable: true, get: function () { return ide_1.getIDEFilePath; } });
+Object.defineProperty(exports, "OCULUM_SECTION_START", { enumerable: true, get: function () { return ide_1.OCULUM_SECTION_START; } });
+Object.defineProperty(exports, "OCULUM_SECTION_END", { enumerable: true, get: function () { return ide_1.OCULUM_SECTION_END; } });
+Object.defineProperty(exports, "IDE_FILE_PATHS", { enumerable: true, get: function () { return ide_1.IDE_FILE_PATHS; } });
 // GitHub comment formatter
 var github_comment_1 = require("./github-comment");
 Object.defineProperty(exports, "formatGitHubComment", { enumerable: true, get: function () { return github_comment_1.formatGitHubComment; } });

package/dist/formatters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qBAAqB;AACrB,uCAUmB;AATjB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AAKd,2BAA2B;AAC3B,mDAKyB;AAJvB,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,kHAAA,gBAAgB,OAAA;AAIlB,+BAA+B;AAC/B,yDAW4B;AAV1B,qHAAA,gBAAgB,OAAA;AAChB,4HAAA,uBAAuB,OAAA;AACvB,uHAAA,kBAAkB,OAAA;AAClB,2HAAA,sBAAsB,OAAA;AACtB,uHAAA,kBAAkB,OAAA;AAQpB,yBAAyB;AACzB,+CASuB;AARrB,oHAAA,oBAAoB,OAAA;AACpB,gHAAA,gBAAgB,OAAA;AAChB,0GAAA,UAAU,OAAA;AACV,2GAAA,WAAW,OAAA;AACX,oHAAA,oBAAoB,OAAA;AACpB,mHAAA,mBAAmB,OAAA;AACnB,mHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qBAAqB;AACrB,uCAUmB;AATjB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AAKd,uBAAuB;AACvB,2CAGqB;AAFnB,6GAAA,eAAe,OAAA;AAIjB,mBAAmB;AACnB,6BAec;AAdZ,wGAAA,iBAAiB,OAAA;AACjB,0GAAA,mBAAmB,OAAA;AACnB,8GAAA,uBAAuB,OAAA;AACvB,uGAAA,gBAAgB,OAAA;AAChB,mGAAA,YAAY,OAAA;AACZ,4GAAA,qBAAqB,OAAA;AACrB,oGAAA,aAAa,OAAA;AACb,qGAAA,cAAc,OAAA;AACd,2GAAA,oBAAoB,OAAA;AACpB,yGAAA,kBAAkB,OAAA;AAClB,qGAAA,cAAc,OAAA;AAMhB,2BAA2B;AAC3B,mDAKyB;AAJvB,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,kHAAA,gBAAgB,OAAA;AAIlB,+BAA+B;AAC/B,yDAW4B;AAV1B,qHAAA,gBAAgB,OAAA;AAChB,4HAAA,uBAAuB,OAAA;AACvB,uHAAA,kBAAkB,OAAA;AAClB,2HAAA,sBAAsB,OAAA;AACtB,uHAAA,kBAAkB,OAAA;AAQpB,yBAAyB;AACzB,+CASuB;AARrB,oHAAA,oBAAoB,OAAA;AACpB,gHAAA,gBAAgB,OAAA;AAChB,0GAAA,UAAU,OAAA;AACV,2GAAA,WAAW,OAAA;AACX,oHAAA,oBAAoB,OAAA;AACpB,mHAAA,mBAAmB,OAAA;AACnB,mHAAA,mBAAmB,OAAA"}

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export interface ScanOptions {
     projectPath?: string;
     /** Include suppressed findings in output (for --show-suppressed) */
     showSuppressed?: boolean;
+    /** Include filter audit trail in output (for debugging/explaining dismissals) */
+    includeFilterAudit?: boolean;
 }
 export interface ScanProgress {
     status: 'fetching' | 'layer1' | 'layer2' | 'layer3' | 'validating' | 'complete' | 'failed';
@@ -61,4 +63,6 @@ export { createCancellationToken } from './types';
 export { SuppressionManager, computeFindingHash, loadSuppressionConfig, addFindingSuppression, removeFindingSuppression, addRuleSuppression, listSuppressions, parseInlineSuppressions, generateSuppressionComment, isValidHash, type SuppressionConfig, type FindingSuppression, type RuleSuppression, type SuppressionResult, type SuppressedVulnerability, } from './suppression';
 export { BaselineManager, computeDiff, hasNewBlockingIssues, formatDiffSummary, BASELINE_FILE_PATH, OCULUM_DIR, type BaselineData, type BaselineFinding, type DiffResult, type BaselineDiff, type BaselineManagerOptions, type LoadBaselineResult, type SaveBaselineResult, type ClearBaselineResult, } from './baseline';
 export { RULE_REGISTRY, getRuleMetadata, getAllCategories, hasMetadata, type RuleMetadata, } from './rules';
+export { AIContextManager, AI_CONTEXT_FILE, AI_CONTEXT_PATH, type AIContextManagerOptions, type SaveContextResult, type LoadContextResult, type ClearContextResult, } from './ai-context';
+export { CATEGORY_GROUPS, ALL_CATEGORIES, normalizeCategory, expandCategoryPattern, matchesAnyCategory, shouldFailOnCategories, getMatchingCategories, parseCategoryList, validateCategories, getAvailableCategoryGroups, getCategoryGroupCounts, } from './category-filter';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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