@perfai/mcp 1.0.24

package/dist/utils/formatters.js

@@ -0,0 +1,510 @@
+export function formatSecurityIssues(issues, userInfo, search, hasMore, nextCursor) {
+    if (!issues.length) {
+        return `**Security Issues Report**\n\n✓ **No security issues found!**\n\n${search ? `Search: "${search}"\n` : ''}**Total Issues**: 0\n**User**: ${userInfo?.email || 'Unknown'}\n\nYour applications are secure!`;
+    }
+    // Sort issues by severity first (Critical -> High -> Medium -> Low -> Unknown)
+    const severityOrder = ['critical', 'severe', 'high', 'medium', 'moderate', 'low', 'minor'];
+    const sortedIssues = issues.sort((a, b) => {
+        const aSeverity = (a.severity || '').toString().toLowerCase().trim();
+        const bSeverity = (b.severity || '').toString().toLowerCase().trim();
+        const aIndex = severityOrder.indexOf(aSeverity);
+        const bIndex = severityOrder.indexOf(bSeverity);
+        // If both are in the order, sort by position
+        if (aIndex !== -1 && bIndex !== -1) {
+            return aIndex - bIndex;
+        }
+        // If only one is in the order, prioritize it
+        if (aIndex !== -1)
+            return -1;
+        if (bIndex !== -1)
+            return 1;
+        // If neither is in the order, sort alphabetically
+        return aSeverity.localeCompare(bSeverity);
+    });
+    // Format issues in clean table format
+    const lines = [`**Security Issues**\n`];
+    if (search) {
+        lines.push(`Search: "${search}"`);
+    }
+    lines.push(`**Showing**: ${issues.length}${hasMore ? ' of many' : ''} issues`);
+    lines.push(`**User**: ${userInfo?.email || 'Unknown'}\n`);
+    // Table: Seq | Issue Type | Endpoint | Severity | CVSS
+    const W_SEQ = 3;
+    const W_ISSUE = 36;
+    const W_ENDPOINT = 36;
+    const W_SEVERITY = 10;
+    const W_CVSS = 6;
+    const sep = (n) => '-'.repeat(n);
+    const top = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_CVSS + 2) + '+';
+    const mid = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_CVSS + 2) + '+';
+    const bot = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_CVSS + 2) + '+';
+    lines.push(top);
+    lines.push('| ' + 'Seq'.padEnd(W_SEQ) + ' | ' + 'Issue Type'.padEnd(W_ISSUE) + ' | ' + 'Endpoint'.padEnd(W_ENDPOINT) + ' | ' + 'Severity'.padEnd(W_SEVERITY) + ' | ' + 'CVSS'.padEnd(W_CVSS) + ' |');
+    lines.push(mid);
+    sortedIssues.forEach((issue, index) => {
+        const method = (issue.method || 'MULTIPLE').toUpperCase();
+        let path = (issue.path || '/unknown').trim();
+        if (path && !path.startsWith('/'))
+            path = '/' + path;
+        const label = issue.label || 'Unlabeled Issue';
+        const severity = issue.severity || 'Unknown';
+        const cvssScore = issue.cvss_score;
+        if (index < 3) {
+            console.error(`🔍 Debug Issue ${index + 1}: severity="${severity}" (type: ${typeof severity}), cvss_score="${cvssScore}" (type: ${typeof cvssScore})`);
+        }
+        const issueType = label;
+        let endpoint = '';
+        if (!issue.method && !issue.path) {
+            endpoint = 'Multiple Endpoints';
+        }
+        else {
+            endpoint = method + ' ' + path;
+        }
+        const truncatedIssueType = issueType.length > W_ISSUE ? issueType.substring(0, W_ISSUE - 3) + '...' : issueType;
+        const truncatedEndpoint = endpoint.length > W_ENDPOINT ? endpoint.substring(0, W_ENDPOINT - 3) + '...' : endpoint;
+        const paddedIssueType = truncatedIssueType.padEnd(W_ISSUE);
+        const paddedEndpoint = truncatedEndpoint.padEnd(W_ENDPOINT);
+        // ASCII-only severity so table aligns in all IDEs/terminals (no double-width Unicode)
+        const normalizedSeverity = (severity || '').toString().toLowerCase().trim();
+        let severityIndicator;
+        let severitySymbol;
+        if (normalizedSeverity === 'critical') {
+            severityIndicator = 'CRITICAL';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'severe') {
+            severityIndicator = 'SEVERE';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'high') {
+            severityIndicator = 'HIGH';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'medium' || normalizedSeverity === 'moderate') {
+            severityIndicator = 'MED';
+            severitySymbol = '-';
+        }
+        else if (normalizedSeverity === 'low' || normalizedSeverity === 'minor') {
+            severityIndicator = 'LOW';
+            severitySymbol = '.';
+        }
+        else {
+            severityIndicator = normalizedSeverity.toUpperCase() || 'UNK';
+            severitySymbol = '?';
+        }
+        const severityDisplay = (severitySymbol + ' ' + severityIndicator).padEnd(W_SEVERITY);
+        let cvssDisplay = 'N/A';
+        if (cvssScore !== undefined && cvssScore !== null) {
+            const score = parseFloat(cvssScore);
+            if (!isNaN(score)) {
+                cvssDisplay = score.toFixed(1);
+            }
+        }
+        const paddedCvss = cvssDisplay.padEnd(W_CVSS);
+        const rowNumber = (index + 1).toString().padStart(W_SEQ);
+        lines.push('| ' + rowNumber + ' | ' + paddedIssueType + ' | ' + paddedEndpoint + ' | ' + severityDisplay + ' | ' + paddedCvss + ' |');
+    });
+    lines.push(bot);
+    // Add pagination info
+    if (hasMore && nextCursor) {
+        lines.push(`\n📄 **Pagination Controls:**`);
+        lines.push(`• **Next 20 issues**: \`show_security_issues {"cursor": "${nextCursor}"}\``);
+        lines.push(`• **All remaining**: \`show_security_issues {"limit": 100, "cursor": "${nextCursor}"}\``);
+    }
+    else if (hasMore) {
+        lines.push(`\n📄 **More issues available** - Run \`show_security_issues\` again to see the next 20`);
+    }
+    return lines.join('\n');
+}
+export function formatAppList(apps, orgId, userInfo, selectedAppId, selectedAppData, authManager, filters) {
+    const filterDesc = [];
+    if (filters?.search)
+        filterDesc.push(`search="${filters.search}"`);
+    if (filters?.environment)
+        filterDesc.push(`environment="${filters.environment}"`);
+    if (!apps.length) {
+        const filterNote = filterDesc.length ? `\n**Active filters**: ${filterDesc.join(', ')}` : '';
+        return `**APP Catalog**\n\n✓ **No APPs found**\n\n**Organization**: ${orgId}\n**User**: ${userInfo?.email || 'Unknown'}${filterNote}\n\n**Note**: No APPs match the current filters. Try removing filters or checking the organization.`;
+    }
+    // Format APP list as a table
+    const lines = [`**APP Catalog**\n`];
+    lines.push(`**Organization**: ${orgId}`);
+    const pageNote = filters?.page && filters.page > 1 ? ` (page ${filters.page})` : '';
+    const totalNote = filters?.totalCount !== undefined ? ` of ${filters.totalCount} total` : '';
+    lines.push(`**APPs shown**: ${apps.length}${totalNote}${pageNote}`);
+    if (filterDesc.length)
+        lines.push(`**Filters**: ${filterDesc.join(', ')}`);
+    lines.push(`**User**: ${userInfo?.email || 'Unknown'}`);
+    if (selectedAppId && selectedAppData) {
+        const displayText = selectedAppData.label && selectedAppData.api_name
+            ? `${selectedAppData.label} - ${selectedAppData.api_name}`
+            : selectedAppData.label || selectedAppData.api_name || selectedAppId;
+        lines.push(`**Selected APP**: ${displayText}\n`);
+    }
+    else {
+        lines.push(`**Selected APP**: None\n`);
+    }
+    // Create table with programmatic widths so borders/header/rows align
+    const W_SEQ = 3;
+    const W_APP = 60;
+    const W_LABEL = 60;
+    const sep = (n) => '-'.repeat(n);
+    const top = '+' + sep(W_SEQ + 2) + '+' + sep(W_APP + 2) + '+' + sep(W_LABEL + 2) + '+';
+    const mid = '+' + sep(W_SEQ + 2) + '+' + sep(W_APP + 2) + '+' + sep(W_LABEL + 2) + '+';
+    const bot = '+' + sep(W_SEQ + 2) + '+' + sep(W_APP + 2) + '+' + sep(W_LABEL + 2) + '+';
+    lines.push(top);
+    lines.push('| ' + 'Seq'.padEnd(W_SEQ) + ' | ' + 'App Name'.padEnd(W_APP) + ' | ' + 'Label'.padEnd(W_LABEL) + ' |');
+    lines.push(mid);
+    // Process apps and create unique entries + sequence mapping
+    const uniqueApps = new Map();
+    const sequenceMap = new Map();
+    apps.forEach((app) => {
+        const appName = app.api_name || 'Unnamed APP';
+        const appLabel = app.label || 'No Label';
+        const appId = app._id;
+        const uniqueKey = `${appName}-${appLabel}-${appId}`;
+        if (!uniqueApps.has(uniqueKey)) {
+            const seq = uniqueApps.size + 1;
+            uniqueApps.set(uniqueKey, {
+                seq,
+                appName,
+                appLabel,
+                appId,
+                isSelected: appId === selectedAppId,
+                environment: app.environment
+            });
+            sequenceMap.set(seq, appId);
+        }
+    });
+    if (authManager) {
+        authManager.setAppSequenceMap(sequenceMap);
+    }
+    const selSuffix = ' [SELECTED]';
+    const maxNameLenWhenSelected = W_APP - selSuffix.length;
+    uniqueApps.forEach((app) => {
+        const { seq, appName, appLabel, isSelected } = app;
+        const maxNameLen = isSelected ? maxNameLenWhenSelected : W_APP;
+        const truncatedAppName = appName.length > maxNameLen ? appName.substring(0, maxNameLen - 3) + '...' : appName;
+        const appNameCell = (truncatedAppName + (isSelected ? selSuffix : '')).padEnd(W_APP);
+        const truncatedAppLabel = appLabel.length > W_LABEL ? appLabel.substring(0, W_LABEL - 3) + '...' : appLabel;
+        const paddedAppLabel = truncatedAppLabel.padEnd(W_LABEL);
+        const rowNumber = seq.toString().padStart(W_SEQ);
+        lines.push('| ' + rowNumber + ' | ' + appNameCell + ' | ' + paddedAppLabel + ' |');
+    });
+    lines.push(bot);
+    // Add environment info if available
+    const environments = [...new Set(Array.from(uniqueApps.values()).map(app => app.environment).filter(Boolean))];
+    if (environments.length > 0) {
+        lines.push(`\n**Environments**: ${environments.join(', ')}`);
+    }
+    // Pagination hint driven by the API's hasMore flag
+    const currentPage = filters?.page ?? 1;
+    if (filters?.hasMore) {
+        lines.push(`\n**More apps available** — fetch next page: \`list_apps {"page": ${currentPage + 1}}\``);
+    }
+    lines.push(`\n**To select an app**: \`select_app {"sequence": <n>}\` or \`select_app {"name_or_label": "<name>"}\` or \`select_app {"app_id": "<id>"}\``);
+    return lines.join('\n');
+}
+export function formatOrganizations(organizations, selectedOrgId) {
+    if (organizations.length === 0) {
+        return `**Organization Management**\n\n! **No Organizations Found**\n\n**Possible Causes**:\n• Organizations haven't been fetched yet\n• Account has no organization access\n• Response was empty\n\n**Try**: Use action=refresh to fetch organizations again\n\n**Note**: Some PerfAI features require organization membership`;
+    }
+    const W_SEQ = 3;
+    const W_NAME = 40;
+    const W_ROLE = 10;
+    const W_STATUS = 10;
+    const sep = (n) => '-'.repeat(n);
+    const border = '+' + sep(W_SEQ + 2) + '+' + sep(W_NAME + 2) + '+' + sep(W_ROLE + 2) + '+' + sep(W_STATUS + 2) + '+';
+    const lines = [
+        `**Organization Management**\n`,
+        `**Total Organizations**: ${organizations.length}`,
+        `**Currently Selected**: ${selectedOrgId || 'None'}\n`,
+        border,
+        '| ' + 'Seq'.padEnd(W_SEQ) + ' | ' + 'Name'.padEnd(W_NAME) + ' | ' + 'Role'.padEnd(W_ROLE) + ' | ' + 'Status'.padEnd(W_STATUS) + ' |',
+        border,
+    ];
+    organizations.forEach((org, index) => {
+        const seq = (index + 1).toString().padStart(W_SEQ);
+        const isSelected = org.org_id === selectedOrgId;
+        const rawName = org.orgDetails?.name || 'Unknown';
+        const selSuffix = isSelected ? ' [*]' : '';
+        const maxLen = W_NAME - selSuffix.length;
+        const name = ((rawName.length > maxLen ? rawName.substring(0, maxLen - 3) + '...' : rawName) + selSuffix).padEnd(W_NAME);
+        const role = (org.role || 'Unknown').substring(0, W_ROLE).padEnd(W_ROLE);
+        const status = (org.status || 'Unknown').substring(0, W_STATUS).padEnd(W_STATUS);
+        lines.push('| ' + seq + ' | ' + name + ' | ' + role + ' | ' + status + ' |');
+    });
+    lines.push(border);
+    lines.push(`\n**To switch organizations**:`);
+    lines.push(`• By sequence: \`manage_organizations {"action": "select", "sequence": <n>}\``);
+    lines.push(`• By ID:       \`manage_organizations {"action": "select", "org_id": "<id>"}\``);
+    return lines.join('\n');
+}
+export function formatFixedIssues(fixedIssues, userInfo) {
+    if (fixedIssues.length === 0) {
+        return `**Fixed Issues**\n\n✓ **No fixed issues yet**\n\n**User**: ${userInfo?.email || 'Unknown'}\n**Total Fixed**: 0\n\n**Note**: Use ai_fix_security_issue tool to generate AI fix prompts for security issues.`;
+    }
+    // Format fixed issues list with clean text formatting
+    const lines = [`**Fixed Issues**\n`];
+    lines.push(`**User**: ${userInfo?.email || 'Unknown'}`);
+    lines.push(`**Total Fixed**: ${fixedIssues.length}\n`);
+    for (const fixedIssue of fixedIssues) {
+        const issue = fixedIssue.issue;
+        const displayName = issue.label || 'Unknown Issue';
+        const severity = issue.severity || 'Unknown';
+        const method = issue.method || 'Multiple';
+        const path = issue.path || 'Endpoints';
+        const severitySymbol = severity === 'High' ? '●' : severity === 'Medium' ? '○' : severity === 'Low' ? '◯' : '?';
+        // Add method-specific symbols
+        const methodSymbol = method.toUpperCase() === 'GET' ? '→' :
+            method.toUpperCase() === 'POST' ? '↑' :
+                method.toUpperCase() === 'PUT' ? '↗' :
+                    method.toUpperCase() === 'DELETE' ? '×' : '?';
+        // Add status-specific indicators
+        const statusIndicator = fixedIssue.status === 'ai-fixed' ? '[AI-FIXED]' :
+            fixedIssue.status === 'fixed' ? '[FIXED]' :
+                fixedIssue.status === 'pending' ? '[PENDING]' : '[UNKNOWN]';
+        lines.push(`${severitySymbol} **${displayName}** (${severity})`);
+        lines.push(`   ID: ${fixedIssue.issueId}`);
+        lines.push(`   Endpoint: ${methodSymbol} ${method} ${path}`);
+        lines.push(`   Fixed: ${fixedIssue.fixedAt.toLocaleString()}`);
+        lines.push(`   Status: ${statusIndicator} ${fixedIssue.status}`);
+        lines.push('');
+    }
+    lines.push(`**To view a specific fix prompt**:\nCopy an issue ID and use ai_fix_security_issue again to see the full prompt.`);
+    return lines.join('\n');
+}
+export function formatDesignIssues(issues, userInfo, search, hasMore, nextCursor) {
+    if (!issues.length) {
+        return `**Design Issues Report**\n\n✓ **No design issues found!**\n\n${search ? `Search: "${search}"\n` : ''}**Total Issues**: 0\n**User**: ${userInfo?.email || 'Unknown'}\n\nYour app design looks good!`;
+    }
+    // Sort issues by priority/severity first (Critical -> High -> Medium -> Low -> Unknown)
+    const severityOrder = ['critical', 'severe', 'high', 'medium', 'moderate', 'low', 'minor'];
+    const sortedIssues = issues.sort((a, b) => {
+        const aSeverity = (a.priority || a.severity || '').toString().toLowerCase().trim();
+        const bSeverity = (b.priority || b.severity || '').toString().toLowerCase().trim();
+        const aIndex = severityOrder.indexOf(aSeverity);
+        const bIndex = severityOrder.indexOf(bSeverity);
+        // If both are in the order, sort by position
+        if (aIndex !== -1 && bIndex !== -1) {
+            return aIndex - bIndex;
+        }
+        // If only one is in the order, prioritize it
+        if (aIndex !== -1)
+            return -1;
+        if (bIndex !== -1)
+            return 1;
+        // If neither is in the order, sort alphabetically
+        return aSeverity.localeCompare(bSeverity);
+    });
+    // Format issues in clean table format
+    const lines = [`**Design Issues**\n`];
+    if (search) {
+        lines.push(`Search: "${search}"`);
+    }
+    lines.push(`**Showing**: ${issues.length}${hasMore ? ' of many' : ''} issues`);
+    lines.push(`**User**: ${userInfo?.email || 'Unknown'}\n`);
+    const W_SEQ = 3;
+    const W_ISSUE = 36;
+    const W_ENDPOINT = 36;
+    const W_SEVERITY = 10;
+    const W_SCORE = 6;
+    const sep = (n) => '-'.repeat(n);
+    const top = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_SCORE + 2) + '+';
+    const mid = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_SCORE + 2) + '+';
+    const bot = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_SCORE + 2) + '+';
+    lines.push(top);
+    lines.push('| ' + 'Seq'.padEnd(W_SEQ) + ' | ' + 'Issue Type'.padEnd(W_ISSUE) + ' | ' + 'Endpoint'.padEnd(W_ENDPOINT) + ' | ' + 'Severity'.padEnd(W_SEVERITY) + ' | ' + 'Score'.padEnd(W_SCORE) + ' |');
+    lines.push(mid);
+    sortedIssues.forEach((issue, index) => {
+        const method = (issue.method || 'MULTIPLE').toUpperCase();
+        let path = (issue.path || '/unknown').trim();
+        if (path && !path.startsWith('/'))
+            path = '/' + path;
+        const label = issue.category || issue.label || 'Unlabeled Issue';
+        const severity = issue.priority || issue.severity || 'Unknown';
+        const score = issue.score || issue.cvss_score;
+        if (index < 3) {
+            console.error(`🔍 Debug Design Issue ${index + 1}: severity="${severity}" (type: ${typeof severity}), score="${score}" (type: ${typeof score})`);
+        }
+        const issueType = label;
+        let endpoint = '';
+        if (!issue.method && !issue.path) {
+            endpoint = 'Multiple Endpoints';
+        }
+        else {
+            endpoint = method + ' ' + path;
+        }
+        const truncatedIssueType = issueType.length > W_ISSUE ? issueType.substring(0, W_ISSUE - 3) + '...' : issueType;
+        const truncatedEndpoint = endpoint.length > W_ENDPOINT ? endpoint.substring(0, W_ENDPOINT - 3) + '...' : endpoint;
+        const paddedIssueType = truncatedIssueType.padEnd(W_ISSUE);
+        const paddedEndpoint = truncatedEndpoint.padEnd(W_ENDPOINT);
+        const normalizedSeverity = (severity || '').toString().toLowerCase().trim();
+        let severityIndicator;
+        let severitySymbol;
+        if (normalizedSeverity === 'critical') {
+            severityIndicator = 'CRITICAL';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'severe') {
+            severityIndicator = 'SEVERE';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'high') {
+            severityIndicator = 'HIGH';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'medium' || normalizedSeverity === 'moderate') {
+            severityIndicator = 'MED';
+            severitySymbol = '-';
+        }
+        else if (normalizedSeverity === 'low' || normalizedSeverity === 'minor') {
+            severityIndicator = 'LOW';
+            severitySymbol = '.';
+        }
+        else {
+            severityIndicator = normalizedSeverity.toUpperCase() || 'UNK';
+            severitySymbol = '?';
+        }
+        const severityDisplay = (severitySymbol + ' ' + severityIndicator).padEnd(W_SEVERITY);
+        let scoreDisplay = 'N/A';
+        if (score !== undefined && score !== null) {
+            const scoreValue = parseFloat(score);
+            if (!isNaN(scoreValue)) {
+                scoreDisplay = scoreValue.toFixed(1);
+            }
+        }
+        const paddedScore = scoreDisplay.padEnd(W_SCORE);
+        const rowNumber = (index + 1).toString().padStart(W_SEQ);
+        lines.push('| ' + rowNumber + ' | ' + paddedIssueType + ' | ' + paddedEndpoint + ' | ' + severityDisplay + ' | ' + paddedScore + ' |');
+    });
+    lines.push(bot);
+    // Add pagination info
+    if (hasMore && nextCursor) {
+        lines.push(`\n📄 **Pagination Controls:**`);
+        lines.push(`• **Next 20 issues**: \`show_design_issues {"cursor": "${nextCursor}"}\``);
+        lines.push(`• **All remaining**: \`show_design_issues {"limit": 100, "cursor": "${nextCursor}"}\``);
+    }
+    else if (hasMore) {
+        lines.push(`\n📄 **More issues available** - Run \`show_design_issues\` again to see the next 20`);
+    }
+    return lines.join('\n');
+}
+export function formatQualityIssues(issues, userInfo, search, hasMore, nextCursor) {
+    if (!issues.length) {
+        return `**Quality Issues Report**\n\n✓ **No quality issues found!**\n\n${search ? `Search: "${search}"\n` : ''}**Total Issues**: 0\n**User**: ${userInfo?.email || 'Unknown'}\n\nYour app specifications are of high quality!`;
+    }
+    // Sort issues by severity first (Critical -> High -> Medium -> Low -> Unknown)
+    const severityOrder = ['critical', 'severe', 'high', 'medium', 'moderate', 'low', 'minor'];
+    const sortedIssues = issues.sort((a, b) => {
+        const aSeverity = (a.severity || a.priority || '').toString().toLowerCase().trim();
+        const bSeverity = (b.severity || b.priority || '').toString().toLowerCase().trim();
+        const aIndex = severityOrder.indexOf(aSeverity);
+        const bIndex = severityOrder.indexOf(bSeverity);
+        // If both are in the order, sort by position
+        if (aIndex !== -1 && bIndex !== -1) {
+            return aIndex - bIndex;
+        }
+        // If only one is in the order, prioritize it
+        if (aIndex !== -1)
+            return -1;
+        if (bIndex !== -1)
+            return 1;
+        // If neither is in the order, sort alphabetically
+        return aSeverity.localeCompare(bSeverity);
+    });
+    // Format issues in clean table format
+    const lines = [`**Quality Issues**\n`];
+    if (search) {
+        lines.push(`Search: "${search}"`);
+    }
+    lines.push(`**Showing**: ${issues.length}${hasMore ? ' of many' : ''} issues`);
+    lines.push(`**User**: ${userInfo?.email || 'Unknown'}\n`);
+    const W_SEQ = 3;
+    const W_ISSUE = 36;
+    const W_ENDPOINT = 36;
+    const W_SEVERITY = 10;
+    const W_SCORE = 6;
+    const sep = (n) => '-'.repeat(n);
+    const top = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_SCORE + 2) + '+';
+    const mid = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_SCORE + 2) + '+';
+    const bot = '+' + sep(W_SEQ + 2) + '+' + sep(W_ISSUE + 2) + '+' + sep(W_ENDPOINT + 2) + '+' + sep(W_SEVERITY + 2) + '+' + sep(W_SCORE + 2) + '+';
+    lines.push(top);
+    lines.push('| ' + 'Seq'.padEnd(W_SEQ) + ' | ' + 'Issue Type'.padEnd(W_ISSUE) + ' | ' + 'Endpoint'.padEnd(W_ENDPOINT) + ' | ' + 'Severity'.padEnd(W_SEVERITY) + ' | ' + 'Score'.padEnd(W_SCORE) + ' |');
+    lines.push(mid);
+    sortedIssues.forEach((issue, index) => {
+        const method = (issue.method || 'MULTIPLE').toUpperCase();
+        let path = (issue.path || '/unknown').trim();
+        if (path && !path.startsWith('/'))
+            path = '/' + path;
+        const bugTitle = issue.bug_title || 'Unlabeled Issue';
+        const tags = issue.tags && issue.tags.length > 0 ? `[${issue.tags.join(', ')}]` : '';
+        const label = tags ? `${bugTitle} ${tags}` : bugTitle;
+        const severity = issue.severity || issue.priority || 'Unknown';
+        const score = issue.score || issue.cvss_score || issue.execution_time_ms;
+        if (index < 3) {
+            console.error(`🔍 Debug Quality Issue ${index + 1}: severity="${severity}" (type: ${typeof severity}), score="${score}" (type: ${typeof score})`);
+        }
+        const issueType = label;
+        let endpoint = '';
+        if (!issue.method && !issue.path) {
+            endpoint = 'Multiple Endpoints';
+        }
+        else {
+            endpoint = method + ' ' + path;
+        }
+        const truncatedIssueType = issueType.length > W_ISSUE ? issueType.substring(0, W_ISSUE - 3) + '...' : issueType;
+        const truncatedEndpoint = endpoint.length > W_ENDPOINT ? endpoint.substring(0, W_ENDPOINT - 3) + '...' : endpoint;
+        const paddedIssueType = truncatedIssueType.padEnd(W_ISSUE);
+        const paddedEndpoint = truncatedEndpoint.padEnd(W_ENDPOINT);
+        const normalizedSeverity = (severity || '').toString().toLowerCase().trim();
+        let severityIndicator;
+        let severitySymbol;
+        if (normalizedSeverity === 'critical') {
+            severityIndicator = 'CRITICAL';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'severe') {
+            severityIndicator = 'SEVERE';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'high') {
+            severityIndicator = 'HIGH';
+            severitySymbol = '*';
+        }
+        else if (normalizedSeverity === 'medium' || normalizedSeverity === 'moderate') {
+            severityIndicator = 'MED';
+            severitySymbol = '-';
+        }
+        else if (normalizedSeverity === 'low' || normalizedSeverity === 'minor') {
+            severityIndicator = 'LOW';
+            severitySymbol = '.';
+        }
+        else {
+            severityIndicator = normalizedSeverity.toUpperCase() || 'UNK';
+            severitySymbol = '?';
+        }
+        const severityDisplay = (severitySymbol + ' ' + severityIndicator).padEnd(W_SEVERITY);
+        let scoreDisplay = 'N/A';
+        if (score !== undefined && score !== null) {
+            const scoreValue = parseFloat(score);
+            if (!isNaN(scoreValue)) {
+                scoreDisplay = scoreValue.toFixed(1);
+            }
+        }
+        const paddedScore = scoreDisplay.padEnd(W_SCORE);
+        const rowNumber = (index + 1).toString().padStart(W_SEQ);
+        lines.push('| ' + rowNumber + ' | ' + paddedIssueType + ' | ' + paddedEndpoint + ' | ' + severityDisplay + ' | ' + paddedScore + ' |');
+    });
+    lines.push(bot);
+    // Add pagination info
+    if (hasMore && nextCursor) {
+        lines.push(`\n📄 **Pagination Controls:**`);
+        lines.push(`• **Next 20 issues**: \`show_quality_issues {"cursor": "${nextCursor}"}\``);
+        lines.push(`• **All remaining**: \`show_quality_issues {"limit": 100, "cursor": "${nextCursor}"}\``);
+    }
+    else if (hasMore) {
+        lines.push(`\n📄 **More issues available** - Run \`show_quality_issues\` again to see the next 20`);
+    }
+    return lines.join('\n');
+}

package/dist/utils/promptBuilder.d.ts

@@ -0,0 +1,4 @@
+export declare function buildAIFixPrompt(issue: any, isRefix?: boolean): string;
+export declare function buildAIFixDesignPrompt(issue: any, isRefix?: boolean): string;
+export declare function buildAIFixQualityPrompt(issue: any, isRefix?: boolean): string;
+//# sourceMappingURL=promptBuilder.d.ts.map

package/dist/utils/promptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptBuilder.d.ts","sourceRoot":"","sources":["../../src/utils/promptBuilder.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CA6D7E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CAiEnF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CAmCpF"}

package/dist/utils/promptBuilder.js

@@ -0,0 +1,132 @@
+export function buildAIFixPrompt(issue, isRefix = false) {
+    const excludeMethodPathLabels = ["Shadow Data"];
+    let methodPathBlock = "";
+    if (!excludeMethodPathLabels.includes(issue.label)) {
+        if (issue.method && issue.path) {
+            methodPathBlock = `HTTP Method: ${issue.method.toUpperCase()}\nPath: ${issue.path}\n\n`;
+        }
+        else if (!issue.method && !issue.path) {
+            methodPathBlock = "Endpoint: Multiple Endpoints\n\n";
+        }
+        else {
+            methodPathBlock = `Endpoint: ${issue.method || 'UNKNOWN'} ${issue.path || '/unknown'}\n\n`;
+        }
+    }
+    const prompt = `I need help implementing a code fix for the following Security issue:
+
+${methodPathBlock}Category: ${issue.label}
+
+Recommended remediation:
+${issue.additionalDetails?.copilot_prompt || "No specific remediation prompt provided"}
+
+Description:
+${issue.additionalDetails?.description || "No description available"}
+
+Mitigation Steps:
+${Array.isArray(issue.additionalDetails?.mitigation)
+        ? issue.additionalDetails.mitigation
+            .map((step, index) => `${index + 1}. ${step}`)
+            .join("\n")
+        : issue.additionalDetails?.mitigation || "No mitigation steps provided"}
+
+${issue.label === "Shadow Data" && issue.errors
+        ? `\nDetected Shadow Data:\n\`\`\`\n${JSON.stringify(issue.errors, null, 2)}\n\`\`\``
+        : ""}${!excludeMethodPathLabels.includes(issue.label) &&
+        Array.isArray(issue.erroneousEndpoints) &&
+        issue.erroneousEndpoints.length > 0
+        ? `\nDetected Erroneous Endpoints:\n\`\`\`\n${JSON.stringify(issue.erroneousEndpoints, null, 2)}\n\`\`\``
+        : ""}
+
+Please follow these steps:
+1. Study the existing #codebase structure and patterns
+2. Implement the recommended remediation
+3. Ensure the fix adheres to best practices
+
+Your response should address this specific security issue while maintaining the current code architecture.`;
+    return prompt;
+}
+export function buildAIFixDesignPrompt(issue, isRefix = false) {
+    const excludeMethodPathCategories = ["Application Design Issues"];
+    let methodPathBlock = "";
+    if (!excludeMethodPathCategories.includes(issue.category)) {
+        if (issue.method && issue.path) {
+            methodPathBlock = `HTTP Method: ${issue.method.toUpperCase()}\nPath: ${issue.path}\n\n`;
+        }
+        else if (!issue.method && !issue.path) {
+            methodPathBlock = "Endpoint: Multiple Endpoints\n\n";
+        }
+        else {
+            methodPathBlock = `Endpoint: ${issue.method || 'UNKNOWN'} ${issue.path || '/unknown'}\n\n`;
+        }
+    }
+    const prompt = `I need help implementing a code fix for the following Design issue:
+
+${methodPathBlock}Category: ${issue.category || issue.label}
+
+Recommended remediation:
+${issue.remediation || "No specific remediation prompt provided"}
+
+Description:
+${issue.description || "No description available"}
+
+Priority: ${issue.priority || issue.severity || "Unknown"}
+
+Design Best Practices to Consider:
+- RESTful API design principles
+- Consistent naming conventions
+- Proper HTTP status codes
+- Resource hierarchy and relationships
+- API versioning strategies
+- Error handling patterns
+- Response structure consistency
+- Documentation standards
+
+${issue.category === "Application Design Issues" && issue.errors
+        ? `\nDetected Design Issues:\n\`\`\`\n${JSON.stringify(issue.errors, null, 2)}\n\`\`\``
+        : ""}${!excludeMethodPathCategories.includes(issue.category) &&
+        Array.isArray(issue.erroneousEndpoints) &&
+        issue.erroneousEndpoints.length > 0
+        ? `\nDetected Problematic Endpoints:\n\`\`\`\n${JSON.stringify(issue.erroneousEndpoints, null, 2)}\n\`\`\``
+        : ""}
+
+Please follow these steps:
+1. Study the existing #codebase structure and API design patterns
+2. Implement the recommended remediation following REST best practices
+3. Ensure the fix improves API consistency, maintainability, and user experience
+4. Consider backward compatibility and API versioning if needed
+
+Your response should address this specific design issue while maintaining the current code architecture and improving overall API design quality.`;
+    return prompt;
+}
+export function buildAIFixQualityPrompt(issue, isRefix = false) {
+    const methodPathBlock = issue.method && issue.path
+        ? `HTTP Method: ${issue.method.toUpperCase()}\nPath: ${issue.path}\n\n`
+        : issue.method || issue.path
+            ? `Endpoint: ${issue.method?.toUpperCase() || 'UNKNOWN'} ${issue.path || '/unknown'}\n\n`
+            : "Endpoint: Multiple Endpoints\n\n";
+    const tagsBlock = issue.tags && issue.tags.length > 0
+        ? `Tags: ${issue.tags.join(', ')}\n\n`
+        : "";
+    const metadataBlock = issue.metadata && Object.keys(issue.metadata).length > 0
+        ? `Additional Details:\n${JSON.stringify(issue.metadata, null, 2)}\n\n`
+        : "";
+    const prompt = `I need help implementing a code fix for the following Quality/Specification Validation issue:
+
+${methodPathBlock}${tagsBlock}Test Name: ${issue.display_name || issue.name}
+
+Bug Title: ${issue.bug_title || 'No specific title provided'}
+
+Status: ${issue.status}
+Status Code: ${issue.status_code}
+Severity: ${issue.severity}
+Execution Time: ${issue.execution_time_ms}ms
+
+${metadataBlock}Please follow these steps:
+1. Study the existing #codebase structure and API specification patterns
+2. Implement the recommended remediation to fix the specification validation issue
+3. Ensure the fix adheres to OpenAPI/Swagger best practices and standards
+4. Validate that the fix resolves the specific quality issue while maintaining API functionality
+
+Your response should address this specific quality issue while maintaining the current code architecture and improving API specification compliance.`;
+    return prompt;
+}