@sparkleideas/cli 3.1.0-alpha.19 → 3.1.0-alpha.21

package/dist/src/mcp-tools/analyze-tools.js

@@ -0,0 +1,317 @@
+/**
+ * Analyze MCP Tools
+ * Provides diff analysis and classification via MCP protocol
+ */
+import { analyzeDiff, assessFileRisk, assessOverallRisk, classifyDiff, suggestReviewers, getGitDiffNumstat, } from '../ruvector/diff-classifier.js';
+/**
+ * Diff Analysis Tool
+ * Analyzes git diffs for change risk assessment and classification
+ */
+export const analyzeDiffTool = {
+    name: 'analyze_diff',
+    description: 'Analyze git diff for change risk assessment and classification',
+    category: 'analyze',
+    tags: ['diff', 'risk', 'classification', 'git'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ref: {
+                type: 'string',
+                description: 'Git ref to compare against (e.g., HEAD~1, main..feature, commit hash)',
+                default: 'HEAD',
+            },
+            includeFileRisks: {
+                type: 'boolean',
+                description: 'Include detailed file-level risk analysis',
+                default: false,
+            },
+            includeReviewers: {
+                type: 'boolean',
+                description: 'Include recommended reviewers',
+                default: true,
+            },
+            useRuVector: {
+                type: 'boolean',
+                description: 'Attempt to use ruvector for analysis (graceful fallback if unavailable)',
+                default: true,
+            },
+        },
+    },
+    handler: async (params) => {
+        const ref = params.ref || 'HEAD';
+        const includeFileRisks = params.includeFileRisks !== false;
+        const includeReviewers = params.includeReviewers !== false;
+        const useRuVector = params.useRuVector !== false;
+        try {
+            const result = await analyzeDiff({
+                ref,
+                useRuVector,
+            });
+            // Build response
+            const response = {
+                ref: result.ref,
+                timestamp: result.timestamp,
+                files: result.files,
+                risk: result.risk,
+                classification: result.classification,
+                summary: result.summary,
+            };
+            if (includeFileRisks) {
+                response.fileRisks = result.fileRisks;
+            }
+            if (includeReviewers) {
+                response.recommendedReviewers = result.recommendedReviewers;
+            }
+            return response;
+        }
+        catch (error) {
+            return {
+                error: true,
+                message: error instanceof Error ? error.message : String(error),
+                ref,
+            };
+        }
+    },
+};
+/**
+ * Diff Risk Assessment Tool
+ * Focused risk assessment without full analysis
+ */
+export const diffRiskTool = {
+    name: 'analyze_diff-risk',
+    description: 'Quick risk assessment for git diff',
+    category: 'analyze',
+    tags: ['diff', 'risk', 'git'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ref: {
+                type: 'string',
+                description: 'Git ref to compare against',
+                default: 'HEAD',
+            },
+        },
+    },
+    handler: async (params) => {
+        const ref = params.ref || 'HEAD';
+        try {
+            const files = getGitDiffNumstat(ref);
+            const fileRisks = files.map(assessFileRisk);
+            const risk = assessOverallRisk(files, fileRisks);
+            return {
+                ref,
+                risk,
+                summary: `${risk.overall} risk (score: ${risk.score}/100) - ${files.length} files changed`,
+            };
+        }
+        catch (error) {
+            return {
+                error: true,
+                message: error instanceof Error ? error.message : String(error),
+                ref,
+            };
+        }
+    },
+};
+/**
+ * Diff Classification Tool
+ * Classify change type without full analysis
+ */
+export const diffClassifyTool = {
+    name: 'analyze_diff-classify',
+    description: 'Classify git diff change type',
+    category: 'analyze',
+    tags: ['diff', 'classification', 'git'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ref: {
+                type: 'string',
+                description: 'Git ref to compare against',
+                default: 'HEAD',
+            },
+        },
+    },
+    handler: async (params) => {
+        const ref = params.ref || 'HEAD';
+        try {
+            const files = getGitDiffNumstat(ref);
+            const classification = classifyDiff(files);
+            return {
+                ref,
+                classification,
+                files: files.length,
+            };
+        }
+        catch (error) {
+            return {
+                error: true,
+                message: error instanceof Error ? error.message : String(error),
+                ref,
+            };
+        }
+    },
+};
+/**
+ * Diff Reviewers Tool
+ * Suggest reviewers for changes
+ */
+export const diffReviewersTool = {
+    name: 'analyze_diff-reviewers',
+    description: 'Suggest reviewers for git diff changes',
+    category: 'analyze',
+    tags: ['diff', 'reviewers', 'git'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ref: {
+                type: 'string',
+                description: 'Git ref to compare against',
+                default: 'HEAD',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of reviewers to suggest',
+                default: 5,
+            },
+        },
+    },
+    handler: async (params) => {
+        const ref = params.ref || 'HEAD';
+        const limit = params.limit || 5;
+        try {
+            const files = getGitDiffNumstat(ref);
+            const fileRisks = files.map(assessFileRisk);
+            const reviewers = suggestReviewers(files, fileRisks);
+            return {
+                ref,
+                recommendedReviewers: reviewers.slice(0, limit),
+                filesAnalyzed: files.length,
+            };
+        }
+        catch (error) {
+            return {
+                error: true,
+                message: error instanceof Error ? error.message : String(error),
+                ref,
+            };
+        }
+    },
+};
+/**
+ * File Risk Tool
+ * Assess risk for a specific file path
+ */
+export const fileRiskTool = {
+    name: 'analyze_file-risk',
+    description: 'Assess risk for a specific file change',
+    category: 'analyze',
+    tags: ['file', 'risk'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'File path to assess',
+            },
+            additions: {
+                type: 'number',
+                description: 'Number of lines added',
+                default: 0,
+            },
+            deletions: {
+                type: 'number',
+                description: 'Number of lines deleted',
+                default: 0,
+            },
+            status: {
+                type: 'string',
+                description: 'File status: added, modified, deleted, renamed',
+                default: 'modified',
+            },
+        },
+        required: ['path'],
+    },
+    handler: async (params) => {
+        const file = {
+            path: params.path,
+            status: params.status || 'modified',
+            additions: params.additions || 0,
+            deletions: params.deletions || 0,
+            hunks: 1,
+            binary: false,
+        };
+        const risk = assessFileRisk(file);
+        return {
+            file: file.path,
+            risk: risk.risk,
+            score: risk.score,
+            reasons: risk.reasons,
+        };
+    },
+};
+/**
+ * Diff Stats Tool
+ * Get quick diff statistics
+ */
+export const diffStatsTool = {
+    name: 'analyze_diff-stats',
+    description: 'Get quick statistics for git diff',
+    category: 'analyze',
+    tags: ['diff', 'stats', 'git'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ref: {
+                type: 'string',
+                description: 'Git ref to compare against',
+                default: 'HEAD',
+            },
+        },
+    },
+    handler: async (params) => {
+        const ref = params.ref || 'HEAD';
+        try {
+            const files = getGitDiffNumstat(ref);
+            const totalAdditions = files.reduce((sum, f) => sum + f.additions, 0);
+            const totalDeletions = files.reduce((sum, f) => sum + f.deletions, 0);
+            const addedFiles = files.filter(f => f.status === 'added').length;
+            const modifiedFiles = files.filter(f => f.status === 'modified').length;
+            const deletedFiles = files.filter(f => f.status === 'deleted').length;
+            const renamedFiles = files.filter(f => f.status === 'renamed').length;
+            const binaryFiles = files.filter(f => f.binary).length;
+            return {
+                ref,
+                totalFiles: files.length,
+                totalAdditions,
+                totalDeletions,
+                totalChanges: totalAdditions + totalDeletions,
+                byStatus: {
+                    added: addedFiles,
+                    modified: modifiedFiles,
+                    deleted: deletedFiles,
+                    renamed: renamedFiles,
+                },
+                binaryFiles,
+            };
+        }
+        catch (error) {
+            return {
+                error: true,
+                message: error instanceof Error ? error.message : String(error),
+                ref,
+            };
+        }
+    },
+};
+// Export all analyze tools
+export const analyzeTools = [
+    analyzeDiffTool,
+    diffRiskTool,
+    diffClassifyTool,
+    diffReviewersTool,
+    fileRiskTool,
+    diffStatsTool,
+];
+export default analyzeTools;
+//# sourceMappingURL=analyze-tools.js.map

package/dist/src/mcp-tools/analyze-tools.js.map

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

package/dist/src/mcp-tools/auto-install.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Auto-install utility for optional MCP tool dependencies
+ *
+ * When an MCP tool requires an optional package that isn't installed,
+ * this utility attempts to install it automatically on first use.
+ */
+export interface AutoInstallOptions {
+    /**
+     * Timeout in milliseconds for npm install (default: 60000)
+     */
+    timeout?: number;
+    /**
+     * Whether to save to package.json (default: false)
+     */
+    save?: boolean;
+    /**
+     * Silent install (no console output)
+     */
+    silent?: boolean;
+}
+/**
+ * Auto-install a package if not available
+ *
+ * @param packageName - npm package name to install
+ * @param options - Installation options
+ * @returns true if installed successfully or already attempted
+ */
+export declare function autoInstallPackage(packageName: string, options?: AutoInstallOptions): Promise<boolean>;
+/**
+ * Try to import a package, auto-install if not found, and retry
+ *
+ * @param packageName - npm package name
+ * @param options - Installation options
+ * @returns The imported module or null if failed
+ */
+export declare function tryImportOrInstall<T = unknown>(packageName: string, options?: AutoInstallOptions): Promise<T | null>;
+/**
+ * Check if a package is available without installing
+ */
+export declare function isPackageAvailable(packageName: string): Promise<boolean>;
+/**
+ * Reset install attempts (useful for testing)
+ */
+export declare function resetInstallAttempts(): void;
+/**
+ * Optional package dependencies and their purposes
+ */
+export declare const OPTIONAL_PACKAGES: {
+    readonly '@sparkleideas/aidefence': {
+        readonly description: "AI manipulation defense (prompt injection, PII detection)";
+        readonly tools: readonly ["aidefence_scan", "aidefence_analyze", "aidefence_stats", "aidefence_learn"];
+    };
+    readonly '@sparkleideas/embeddings': {
+        readonly description: "Vector embeddings with ONNX support";
+        readonly tools: readonly ["embeddings_generate", "embeddings_search", "embeddings_batch"];
+    };
+    readonly 'onnxruntime-node': {
+        readonly description: "ONNX runtime for neural network inference";
+        readonly tools: readonly ["neural_*"];
+    };
+};
+declare const _default: {
+    autoInstallPackage: typeof autoInstallPackage;
+    tryImportOrInstall: typeof tryImportOrInstall;
+    isPackageAvailable: typeof isPackageAvailable;
+    resetInstallAttempts: typeof resetInstallAttempts;
+    OPTIONAL_PACKAGES: {
+        readonly '@sparkleideas/aidefence': {
+            readonly description: "AI manipulation defense (prompt injection, PII detection)";
+            readonly tools: readonly ["aidefence_scan", "aidefence_analyze", "aidefence_stats", "aidefence_learn"];
+        };
+        readonly '@sparkleideas/embeddings': {
+            readonly description: "Vector embeddings with ONNX support";
+            readonly tools: readonly ["embeddings_generate", "embeddings_search", "embeddings_batch"];
+        };
+        readonly 'onnxruntime-node': {
+            readonly description: "ONNX runtime for neural network inference";
+            readonly tools: readonly ["neural_*"];
+        };
+    };
+};
+export default _default;
+//# sourceMappingURL=auto-install.d.ts.map

package/dist/src/mcp-tools/auto-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-install.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/auto-install.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA8ClB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAClD,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAoBnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC;;;;;;;;;;;;;;;;;;;;;AAEX,wBAME"}

package/dist/src/mcp-tools/auto-install.js

@@ -0,0 +1,131 @@
+/**
+ * Auto-install utility for optional MCP tool dependencies
+ *
+ * When an MCP tool requires an optional package that isn't installed,
+ * this utility attempts to install it automatically on first use.
+ */
+import { spawnSync } from 'child_process';
+// Track which packages we've attempted to install this session
+const installAttempts = new Set();
+/**
+ * Auto-install a package if not available
+ *
+ * @param packageName - npm package name to install
+ * @param options - Installation options
+ * @returns true if installed successfully or already attempted
+ */
+export async function autoInstallPackage(packageName, options = {}) {
+    const { timeout = 60000, save = false, silent = false } = options;
+    // Validate package name to prevent command injection (CVE fix)
+    // Valid npm package names: @scope/name or name, alphanumeric with - . _ ~
+    const validPackageName = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*(@[a-z0-9-._~]+)?$/i;
+    if (!validPackageName.test(packageName)) {
+        if (!silent) {
+            console.error(`[@sparkleideas/claude-flow] Invalid package name: ${packageName}`);
+        }
+        return false;
+    }
+    // Only attempt once per session
+    if (installAttempts.has(packageName)) {
+        return false;
+    }
+    installAttempts.add(packageName);
+    try {
+        if (!silent) {
+            console.error(`[@sparkleideas/claude-flow] Auto-installing ${packageName}...`);
+        }
+        // Use spawn with array args to prevent shell injection
+        const args = ['install', packageName, save ? '--save' : '--no-save'];
+        const result = spawnSync('npm', args, {
+            stdio: silent ? 'pipe' : ['pipe', 'pipe', 'pipe'],
+            timeout,
+            shell: false, // Explicitly disable shell
+        });
+        if (result.status !== 0) {
+            throw new Error(result.stderr?.toString() || 'Installation failed');
+        }
+        if (!silent) {
+            console.error(`[@sparkleideas/claude-flow] Successfully installed ${packageName}`);
+        }
+        return true;
+    }
+    catch (error) {
+        if (!silent) {
+            console.error(`[@sparkleideas/claude-flow] Failed to auto-install ${packageName}: ${error}`);
+        }
+        return false;
+    }
+}
+/**
+ * Try to import a package, auto-install if not found, and retry
+ *
+ * @param packageName - npm package name
+ * @param options - Installation options
+ * @returns The imported module or null if failed
+ */
+export async function tryImportOrInstall(packageName, options = {}) {
+    try {
+        // First try to import
+        return await import(packageName);
+    }
+    catch {
+        // Package not found, try to install
+        const installed = await autoInstallPackage(packageName, options);
+        if (installed) {
+            try {
+                // ESM caches failed imports, so we need to bust the cache
+                // Add a timestamp query parameter to force a fresh import
+                const cacheBuster = `?t=${Date.now()}`;
+                return await import(`${packageName}${cacheBuster}`);
+            }
+            catch {
+                console.error(`[@sparkleideas/claude-flow] ${packageName} installed but failed to load. Restart MCP server.`);
+                return null;
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Check if a package is available without installing
+ */
+export async function isPackageAvailable(packageName) {
+    try {
+        await import(packageName);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Reset install attempts (useful for testing)
+ */
+export function resetInstallAttempts() {
+    installAttempts.clear();
+}
+/**
+ * Optional package dependencies and their purposes
+ */
+export const OPTIONAL_PACKAGES = {
+    '@sparkleideas/aidefence': {
+        description: 'AI manipulation defense (prompt injection, PII detection)',
+        tools: ['aidefence_scan', 'aidefence_analyze', 'aidefence_stats', 'aidefence_learn'],
+    },
+    '@sparkleideas/embeddings': {
+        description: 'Vector embeddings with ONNX support',
+        tools: ['embeddings_generate', 'embeddings_search', 'embeddings_batch'],
+    },
+    'onnxruntime-node': {
+        description: 'ONNX runtime for neural network inference',
+        tools: ['neural_*'],
+    },
+};
+export default {
+    autoInstallPackage,
+    tryImportOrInstall,
+    isPackageAvailable,
+    resetInstallAttempts,
+    OPTIONAL_PACKAGES,
+};
+//# sourceMappingURL=auto-install.js.map

package/dist/src/mcp-tools/auto-install.js.map

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

package/dist/src/mcp-tools/browser-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser MCP Tools
+ *
+ * CLI integration for @sparkleideas/browser package.
+ * Provides browser automation tools for web navigation, interaction, and data extraction.
+ */
+import type { MCPTool } from './types.js';
+/**
+ * Browser MCP Tools
+ */
+export declare const browserTools: MCPTool[];
+export default browserTools;
+//# sourceMappingURL=browser-tools.d.ts.map

package/dist/src/mcp-tools/browser-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAuDzD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,EAghBjC,CAAC;AAEF,eAAe,YAAY,CAAC"}