driftdetect-lsp 0.9.34 → 0.9.38

package/dist/bin/server.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Drift LSP Server Entry Point
+ *
+ * This is the executable entry point for the Drift LSP server.
+ * It can be run directly or spawned by an editor extension.
+ *
+ * Usage:
+ *   drift-lsp [--debug]
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/bin/server.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Drift LSP Server Entry Point
+ *
+ * This is the executable entry point for the Drift LSP server.
+ * It can be run directly or spawned by an editor extension.
+ *
+ * Usage:
+ *   drift-lsp [--debug]
+ */
+import { startDriftServer } from '../server.js';
+// Parse command line arguments
+const args = process.argv.slice(2);
+const debug = args.includes('--debug') || args.includes('-d');
+// Start the server
+const server = startDriftServer({ debug });
+// Handle process signals
+process.on('SIGINT', () => {
+    server.stop();
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    server.stop();
+    process.exit(0);
+});
+//# sourceMappingURL=server.js.map

package/dist/bin/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/bin/server.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,+BAA+B;AAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE9D,mBAAmB;AACnB,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAE3C,yBAAyB;AACzB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/capabilities.d.ts

@@ -0,0 +1,91 @@
+/**
+ * LSP Server Capabilities
+ *
+ * Defines the capabilities that the Drift LSP server advertises to clients.
+ * Based on the Language Server Protocol specification.
+ *
+ * @requirements 27.1 - THE LSP_Server SHALL implement the Language Server Protocol specification
+ * @requirements 27.2 - THE LSP_Server SHALL support document synchronization
+ * @requirements 27.3 - THE LSP_Server SHALL publish diagnostics for violations
+ * @requirements 27.4 - THE LSP_Server SHALL provide code actions for quick fixes
+ * @requirements 27.5 - THE LSP_Server SHALL provide hover information for violations
+ * @requirements 27.6 - THE LSP_Server SHALL provide code lens for pattern information
+ */
+import type { ServerCapabilities, InitializeResult } from 'vscode-languageserver';
+/**
+ * Server identification information
+ */
+export declare const SERVER_INFO: {
+    readonly name: "drift-lsp";
+    readonly version: "0.0.1";
+};
+/**
+ * All Drift LSP commands
+ * @requirements 28.1-28.9 - LSP Server Commands
+ */
+export declare const DRIFT_COMMANDS: {
+    /** Approve a pattern for enforcement */
+    readonly APPROVE_PATTERN: "drift.approvePattern";
+    /** Ignore a pattern (don't enforce) */
+    readonly IGNORE_PATTERN: "drift.ignorePattern";
+    /** Ignore a single occurrence of a violation */
+    readonly IGNORE_ONCE: "drift.ignoreOnce";
+    /** Create a variant (intentional deviation) */
+    readonly CREATE_VARIANT: "drift.createVariant";
+    /** Request AI explanation for a violation */
+    readonly EXPLAIN_AI: "drift.explainWithAI";
+    /** Request AI-generated fix for a violation */
+    readonly FIX_AI: "drift.fixWithAI";
+    /** Rescan workspace for patterns and violations */
+    readonly RESCAN: "drift.rescan";
+    /** Show all discovered patterns */
+    readonly SHOW_PATTERNS: "drift.showPatterns";
+    /** Show all current violations */
+    readonly SHOW_VIOLATIONS: "drift.showViolations";
+};
+/**
+ * Array of all command IDs for registration
+ */
+export declare const ALL_COMMANDS: readonly string[];
+/**
+ * Supported code action kinds
+ */
+export declare const SUPPORTED_CODE_ACTION_KINDS: readonly ["quickfix", "refactor", "source"];
+/**
+ * Build the full server capabilities object
+ *
+ * This defines what the Drift LSP server can do, following the spec:
+ * - textDocumentSync: Document synchronization with incremental changes
+ * - diagnosticProvider: Publish diagnostics for violations
+ * - codeActionProvider: Quick fixes and refactoring actions
+ * - hoverProvider: Show violation details on hover
+ * - codeLensProvider: Inline pattern information
+ * - executeCommandProvider: All drift.* commands
+ * - workspace: Workspace folder support and file operations
+ */
+export declare function buildServerCapabilities(): ServerCapabilities;
+/**
+ * Build the initialize result to send to the client
+ */
+export declare function buildInitializeResult(): InitializeResult;
+/**
+ * Check if client supports a specific capability path
+ */
+export declare function clientSupportsCapability(clientCapabilities: Record<string, unknown> | undefined, path: string): boolean;
+/**
+ * Check if client supports workspace configuration
+ */
+export declare function clientSupportsConfiguration(clientCapabilities: Record<string, unknown> | undefined): boolean;
+/**
+ * Check if client supports workspace folders
+ */
+export declare function clientSupportsWorkspaceFolders(clientCapabilities: Record<string, unknown> | undefined): boolean;
+/**
+ * Check if client supports work done progress
+ */
+export declare function clientSupportsWorkDoneProgress(clientCapabilities: Record<string, unknown> | undefined): boolean;
+/**
+ * Check if client supports diagnostic related information
+ */
+export declare function clientSupportsDiagnosticRelatedInfo(clientCapabilities: Record<string, unknown> | undefined): boolean;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/commands/approve-pattern.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Approve Pattern Command - drift.approvePattern
+ * @requirements 28.1
+ */
+import type { ServerContext, CommandResult } from '../server/types.js';
+/**
+ * Execute approve pattern command
+ * Marks a pattern as approved, removing all violations for that pattern
+ */
+export declare function executeApprovePattern(context: ServerContext, patternId: string): Promise<CommandResult>;
+/**
+ * Approve multiple patterns at once
+ */
+export declare function executeApprovePatterns(context: ServerContext, patternIds: string[]): Promise<CommandResult>;
+//# sourceMappingURL=approve-pattern.d.ts.map

package/dist/commands/approve-pattern.js

@@ -0,0 +1,83 @@
+/**
+ * Approve Pattern Command - drift.approvePattern
+ * @requirements 28.1
+ */
+/**
+ * Execute approve pattern command
+ * Marks a pattern as approved, removing all violations for that pattern
+ */
+export async function executeApprovePattern(context, patternId) {
+    const { state, logger, connection } = context;
+    if (!patternId) {
+        return {
+            success: false,
+            error: 'Pattern ID is required',
+        };
+    }
+    logger.info(`Approving pattern: ${patternId}`);
+    // Check if pattern exists
+    const pattern = state.patterns.get(patternId);
+    if (!pattern) {
+        // Pattern might not be in cache, but we can still approve it
+        logger.warn(`Pattern not found in cache: ${patternId}`);
+    }
+    // TODO: Integrate with driftdetect-core pattern store to persist approval
+    // For now, we'll update the in-memory state
+    // Remove violations for this pattern from all documents
+    let removedCount = 0;
+    for (const [uri, violations] of state.violations) {
+        const filtered = violations.filter((v) => v.patternId !== patternId);
+        const removed = violations.length - filtered.length;
+        if (removed > 0) {
+            state.violations.set(uri, filtered);
+            removedCount += removed;
+            // Update diagnostics for this document
+            const diagnostics = state.diagnostics.get(uri);
+            if (diagnostics) {
+                const filteredDiagnostics = diagnostics.filter((d) => d.patternId !== patternId);
+                state.diagnostics.set(uri, filteredDiagnostics);
+                // Publish updated diagnostics
+                connection.sendDiagnostics({
+                    uri,
+                    diagnostics: filteredDiagnostics.map((diag) => ({
+                        range: diag.range,
+                        severity: diag.severity === 'error' ? 1 : diag.severity === 'warning' ? 2 : diag.severity === 'info' ? 3 : 4,
+                        code: diag.code,
+                        source: diag.source,
+                        message: diag.message,
+                    })),
+                });
+            }
+        }
+    }
+    // Show notification
+    connection.window.showInformationMessage(`Pattern "${patternId}" approved. ${removedCount} violation${removedCount === 1 ? '' : 's'} removed.`);
+    logger.info(`Pattern approved: ${patternId}, removed ${removedCount} violations`);
+    return {
+        success: true,
+        message: `Pattern "${patternId}" approved`,
+        data: {
+            patternId,
+            removedViolations: removedCount,
+        },
+    };
+}
+/**
+ * Approve multiple patterns at once
+ */
+export async function executeApprovePatterns(context, patternIds) {
+    const results = [];
+    for (const patternId of patternIds) {
+        const result = await executeApprovePattern(context, patternId);
+        if (result.success && result.data) {
+            results.push(result.data);
+        }
+    }
+    const totalRemoved = results.reduce((sum, r) => sum + r.removedViolations, 0);
+    return {
+        success: true,
+        message: `Approved ${results.length} patterns, removed ${totalRemoved} violations`,
+        data: { results },
+    };
+}
+//# sourceMappingURL=approve-pattern.js.map

package/dist/commands/approve-pattern.js.map

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

package/dist/commands/create-variant.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Create Variant Command - drift.createVariant
+ * @requirements 28.4
+ */
+import type { ServerContext, CommandResult } from '../server/types.js';
+/**
+ * Execute create variant command
+ * Creates a new pattern variant from an existing violation
+ */
+export declare function executeCreateVariant(context: ServerContext, patternId: string, violationId?: string): Promise<CommandResult>;
+/**
+ * Validate variant name
+ */
+export declare function validateVariantName(name: string): string | null;
+/**
+ * Get suggested variant names based on violation context
+ */
+export declare function getSuggestedVariantNames(basePatternName: string, violationContext?: {
+    file?: string;
+    message?: string;
+}): string[];
+//# sourceMappingURL=create-variant.d.ts.map

package/dist/commands/create-variant.js

@@ -0,0 +1,109 @@
+/**
+ * Create Variant Command - drift.createVariant
+ * @requirements 28.4
+ */
+/**
+ * Execute create variant command
+ * Creates a new pattern variant from an existing violation
+ */
+export async function executeCreateVariant(context, patternId, violationId) {
+    const { state, logger, connection } = context;
+    if (!patternId) {
+        return {
+            success: false,
+            error: 'Pattern ID is required',
+        };
+    }
+    logger.info(`Creating variant for pattern: ${patternId}`);
+    // Get the base pattern
+    const basePattern = state.patterns.get(patternId);
+    if (!basePattern) {
+        return {
+            success: false,
+            error: `Pattern not found: ${patternId}`,
+        };
+    }
+    // If violation ID provided, get the violation for context
+    let violation = null;
+    if (violationId) {
+        for (const violations of state.violations.values()) {
+            const found = violations.find((v) => v.id === violationId);
+            if (found) {
+                violation = { file: found.file, location: found.range };
+                break;
+            }
+        }
+    }
+    // TODO: Integrate with driftdetect-core variant manager
+    // For now, we'll create a variant with a generated name
+    // Generate variant ID and name
+    const variantId = generateVariantId(patternId);
+    const variantName = `${basePattern.name ?? patternId} (variant)`;
+    // Create the variant (in-memory for now)
+    const variant = {
+        id: variantId,
+        basePatternId: patternId,
+        name: variantName,
+        description: undefined,
+        createdAt: new Date().toISOString(),
+        context: violation ? {
+            file: violation.file,
+            location: violation.location,
+        } : undefined,
+    };
+    logger.info(`Variant created: ${variantId}`);
+    // Show success message
+    connection.window.showInformationMessage(`Variant "${variantName}" created for pattern "${patternId}"`);
+    return {
+        success: true,
+        message: `Variant "${variantName}" created`,
+        data: {
+            variant,
+            basePatternId: patternId,
+        },
+    };
+}
+/**
+ * Generate a unique variant ID
+ */
+function generateVariantId(basePatternId) {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 6);
+    return `${basePatternId}:variant:${timestamp}${random}`;
+}
+/**
+ * Validate variant name
+ */
+export function validateVariantName(name) {
+    if (!name || name.trim().length === 0) {
+        return 'Variant name cannot be empty';
+    }
+    if (name.length > 100) {
+        return 'Variant name must be 100 characters or less';
+    }
+    if (!/^[a-zA-Z0-9\s\-_()]+$/.test(name)) {
+        return 'Variant name can only contain letters, numbers, spaces, hyphens, underscores, and parentheses';
+    }
+    return null;
+}
+/**
+ * Get suggested variant names based on violation context
+ */
+export function getSuggestedVariantNames(basePatternName, violationContext) {
+    const suggestions = [];
+    // Base suggestion
+    suggestions.push(`${basePatternName} (variant)`);
+    // File-based suggestion
+    if (violationContext?.file) {
+        const fileName = violationContext.file.split('/').pop()?.replace(/\.[^.]+$/, '');
+        if (fileName) {
+            suggestions.push(`${basePatternName} (${fileName})`);
+        }
+    }
+    // Context-based suggestions
+    suggestions.push(`${basePatternName} (alternative)`);
+    suggestions.push(`${basePatternName} (exception)`);
+    suggestions.push(`${basePatternName} (legacy)`);
+    return suggestions;
+}
+//# sourceMappingURL=create-variant.js.map

package/dist/commands/create-variant.js.map

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

package/dist/commands/explain-ai.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Explain AI Command - drift.explainWithAI
+ * @requirements 28.5
+ */
+import type { ServerContext, CommandResult } from '../server/types.js';
+/**
+ * Execute explain with AI command
+ * Uses AI to explain why a violation occurred and how to fix it
+ */
+export declare function executeExplainAI(context: ServerContext, violationId: string, patternId: string): Promise<CommandResult>;
+//# sourceMappingURL=explain-ai.d.ts.map

package/dist/commands/explain-ai.js

@@ -0,0 +1,144 @@
+/**
+ * Explain AI Command - drift.explainWithAI
+ * @requirements 28.5
+ */
+/**
+ * Execute explain with AI command
+ * Uses AI to explain why a violation occurred and how to fix it
+ */
+export async function executeExplainAI(context, violationId, patternId) {
+    const { state, logger, connection } = context;
+    if (!state.configuration.aiEnabled) {
+        return {
+            success: false,
+            error: 'AI features are not enabled. Enable them in settings.',
+        };
+    }
+    if (!violationId || !patternId) {
+        return {
+            success: false,
+            error: 'Violation ID and Pattern ID are required',
+        };
+    }
+    logger.info(`Explaining violation with AI: ${violationId}`);
+    // Find the violation
+    let violation = null;
+    let violationUri = '';
+    for (const [uri, violations] of state.violations) {
+        violation = violations.find((v) => v.id === violationId);
+        if (violation) {
+            violationUri = uri;
+            break;
+        }
+    }
+    if (!violation) {
+        return {
+            success: false,
+            error: `Violation not found: ${violationId}`,
+        };
+    }
+    // Get the pattern
+    const pattern = state.patterns.get(patternId);
+    // Get document content for context
+    const docState = state.documents.get(violationUri);
+    const documentContent = docState?.content ?? '';
+    // Extract relevant code snippet using range (ViolationInfo uses range, not location)
+    const startLine = violation.range.start.line;
+    const endLine = violation.range.end.line;
+    const codeSnippet = extractCodeSnippet(documentContent, startLine, endLine, 5 // context lines
+    );
+    // TODO: Integrate with @drift/ai package
+    // For now, show a placeholder explanation
+    // Build explanation context
+    const explanationContext = {
+        violation: {
+            id: violationId,
+            message: violation.message,
+            severity: violation.severity,
+            range: violation.range,
+        },
+        pattern: {
+            id: patternId,
+            name: pattern?.name,
+            description: pattern?.description,
+            category: pattern?.category,
+        },
+        codeSnippet,
+        file: violationUri,
+    };
+    // Note: withProgress is not available in vscode-languageserver
+    // Show a simple message instead
+    connection.window.showInformationMessage('Analyzing violation with AI...');
+    // Simulate AI processing
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    // Generate placeholder explanation
+    const explanation = generatePlaceholderExplanation(explanationContext);
+    // Show explanation in a message
+    connection.window.showInformationMessage(`AI Explanation for "${pattern?.name ?? patternId}":\n\n${explanation}`);
+    logger.info(`AI explanation generated for: ${violationId}`);
+    return {
+        success: true,
+        message: 'AI explanation generated',
+        data: {
+            violationId,
+            patternId,
+            explanation,
+            context: explanationContext,
+        },
+    };
+}
+/**
+ * Extract code snippet around a location
+ */
+function extractCodeSnippet(content, startLine, endLine, contextLines) {
+    const lines = content.split('\n');
+    const start = Math.max(0, startLine - contextLines - 1);
+    const end = Math.min(lines.length, endLine + contextLines);
+    return lines.slice(start, end).join('\n');
+}
+/**
+ * Generate placeholder explanation (to be replaced with actual AI)
+ */
+function generatePlaceholderExplanation(context) {
+    const lines = [];
+    lines.push(`## Why This Violation Occurred`);
+    lines.push('');
+    lines.push(context.violation.message);
+    lines.push('');
+    if (context.pattern.description) {
+        lines.push(`## Pattern Description`);
+        lines.push('');
+        lines.push(context.pattern.description);
+        lines.push('');
+    }
+    lines.push(`## How to Fix`);
+    lines.push('');
+    lines.push('To resolve this violation, consider the following approaches:');
+    lines.push('');
+    lines.push('1. **Follow the established pattern** - Update your code to match the expected pattern');
+    lines.push('2. **Create a variant** - If this is an intentional deviation, create a pattern variant');
+    lines.push('3. **Ignore this occurrence** - If this is a one-time exception, ignore this specific violation');
+    lines.push('');
+    lines.push(`## Severity: ${context.violation.severity}`);
+    lines.push('');
+    lines.push(getSeverityExplanation(context.violation.severity));
+    return lines.join('\n');
+}
+/**
+ * Get severity explanation
+ */
+function getSeverityExplanation(severity) {
+    switch (severity) {
+        case 'error':
+            return 'This is a critical violation that should be addressed before merging.';
+        case 'warning':
+            return 'This violation indicates a potential issue that should be reviewed.';
+        case 'info':
+            return 'This is an informational finding that may be worth considering.';
+        case 'hint':
+            return 'This is a suggestion for improvement.';
+        default:
+            return 'Review this violation and determine the appropriate action.';
+    }
+}
+//# sourceMappingURL=explain-ai.js.map

package/dist/commands/explain-ai.js.map

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

package/dist/commands/fix-ai.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fix AI Command - drift.fixWithAI
+ * @requirements 28.6
+ */
+import type { ServerContext, CommandResult } from '../server/types.js';
+/**
+ * Execute fix with AI command
+ * Uses AI to generate a fix for a violation
+ */
+export declare function executeFixAI(context: ServerContext, violationId: string, uri: string): Promise<CommandResult>;
+//# sourceMappingURL=fix-ai.d.ts.map