nfunc-mcp 0.1.0

package/dist/utils/outputParsers.d.ts

@@ -0,0 +1,56 @@
+export interface LighthouseAuditRef {
+    id: string;
+    title: string;
+    description: string;
+    score: number;
+    displayValue: string;
+    numericValue?: number;
+    numericUnit?: string;
+}
+export interface ParsedLighthouse {
+    categoryScores: Record<string, number>;
+    totalScore: number;
+    ttfbMs: number | null;
+    failedAudits: LighthouseAuditRef[];
+}
+export declare function parseLighthouseJSON(rawJson: string): ParsedLighthouse;
+export type WcagLevel = "A" | "AA" | "AAA" | "unknown";
+export interface Pa11yViolation {
+    code: string;
+    technique: string;
+    message: string;
+    selector: string;
+    context: string;
+    type: "error" | "warning" | "notice";
+    wcagLevel: WcagLevel;
+    criterion: string | null;
+}
+export interface ParsedPa11y {
+    violationCount: number;
+    violations: Pa11yViolation[];
+}
+export interface ESLintIssue {
+    filePath: string;
+    line: number;
+    column: number;
+    ruleId: string;
+    message: string;
+    severity: 1 | 2;
+}
+export interface ParsedESLint {
+    issues: ESLintIssue[];
+}
+export declare function parseESLintJSON(rawJson: string): ParsedESLint;
+export interface SemgrepFinding {
+    filePath: string;
+    line: number;
+    ruleId: string;
+    message: string;
+    severity: string;
+    category?: string;
+}
+export interface ParsedSemgrep {
+    findings: SemgrepFinding[];
+}
+export declare function parseSemgrepJSON(rawJson: string): ParsedSemgrep;
+export declare function parsePa11yJSON(rawJson: string): ParsedPa11y;

package/dist/utils/outputParsers.js

@@ -0,0 +1,184 @@
+export function parseLighthouseJSON(rawJson) {
+    const lhr = JSON.parse(rawJson);
+    const categoryScores = {};
+    for (const [key, cat] of Object.entries(lhr.categories ?? {})) {
+        if (typeof cat?.score === "number") {
+            categoryScores[key] = Math.round(cat.score * 100);
+        }
+    }
+    const scoreValues = Object.values(categoryScores);
+    const totalScore = scoreValues.length > 0
+        ? Math.round(scoreValues.reduce((a, b) => a + b, 0) / scoreValues.length)
+        : 0;
+    const serverResponse = lhr.audits?.["server-response-time"];
+    const ttfbMs = typeof serverResponse?.numericValue === "number"
+        ? Math.round(serverResponse.numericValue)
+        : null;
+    const failedAudits = [];
+    for (const [id, audit] of Object.entries(lhr.audits ?? {})) {
+        if (audit?.score === null || audit?.score === undefined)
+            continue;
+        const scorePct = Math.round(audit.score * 100);
+        if (scorePct >= 90)
+            continue;
+        failedAudits.push({
+            id,
+            title: audit.title ?? id,
+            description: audit.description ?? "",
+            score: scorePct,
+            displayValue: audit.displayValue ?? "",
+            numericValue: typeof audit.numericValue === "number" ? audit.numericValue : undefined,
+            numericUnit: audit.numericUnit,
+        });
+    }
+    return { categoryScores, totalScore, ttfbMs, failedAudits };
+}
+const WCAG_CRITERION_LEVELS = {
+    "1.1.1": "A",
+    "1.2.1": "A",
+    "1.2.2": "A",
+    "1.2.3": "A",
+    "1.2.4": "AA",
+    "1.2.5": "AA",
+    "1.3.1": "A",
+    "1.3.2": "A",
+    "1.3.3": "A",
+    "1.3.4": "AA",
+    "1.3.5": "AA",
+    "1.4.1": "A",
+    "1.4.2": "A",
+    "1.4.3": "AA",
+    "1.4.4": "AA",
+    "1.4.5": "AA",
+    "1.4.6": "AAA",
+    "1.4.10": "AA",
+    "1.4.11": "AA",
+    "1.4.12": "AA",
+    "1.4.13": "AA",
+    "2.1.1": "A",
+    "2.1.2": "A",
+    "2.1.4": "A",
+    "2.2.1": "A",
+    "2.2.2": "A",
+    "2.4.1": "A",
+    "2.4.2": "A",
+    "2.4.3": "A",
+    "2.4.4": "A",
+    "2.4.5": "AA",
+    "2.4.6": "AA",
+    "2.4.7": "AA",
+    "2.5.1": "A",
+    "2.5.2": "A",
+    "2.5.3": "A",
+    "2.5.4": "A",
+    "3.1.1": "A",
+    "3.1.2": "AA",
+    "3.2.1": "A",
+    "3.2.2": "A",
+    "3.2.3": "AA",
+    "3.2.4": "AA",
+    "3.3.1": "A",
+    "3.3.2": "A",
+    "3.3.3": "AA",
+    "3.3.4": "AA",
+    "4.1.1": "A",
+    "4.1.2": "A",
+    "4.1.3": "AA",
+};
+function deriveWcagLevel(code) {
+    // pa11y/HTMLCS code shape: WCAG2AA.Principle1.Guideline1_1.1_1_1.H37
+    const segments = code.split(".");
+    let criterion = null;
+    for (const seg of segments) {
+        if (/^\d+(_\d+)+$/.test(seg)) {
+            criterion = seg.replace(/_/g, ".");
+            break;
+        }
+    }
+    if (criterion && WCAG_CRITERION_LEVELS[criterion]) {
+        return { level: WCAG_CRITERION_LEVELS[criterion], criterion };
+    }
+    // Fallback: infer from standard prefix when criterion is unknown.
+    const prefix = segments[0] ?? "";
+    if (prefix === "WCAG2AAA")
+        return { level: "AAA", criterion };
+    if (prefix === "WCAG2AA")
+        return { level: "AA", criterion };
+    if (prefix === "WCAG2A")
+        return { level: "A", criterion };
+    return { level: "unknown", criterion };
+}
+function extractTechnique(code) {
+    // pa11y/HTMLCS code shape: WCAG2AA.PrincipleN.GuidelineN_N.N_N_N.<technique>[.<variant>...]
+    // The technique starts at the segment immediately after the criterion (e.g. "1_1_1").
+    // We return the technique plus any variant suffix joined with dots, so callers can
+    // disambiguate sub-rules like "H91.InputText.Name" vs "H91.A.NoContent".
+    const segments = code.split(".");
+    for (let i = 0; i < segments.length; i++) {
+        if (/^\d+(_\d+)+$/.test(segments[i] ?? "")) {
+            const suffix = segments.slice(i + 1).join(".");
+            if (suffix)
+                return suffix;
+        }
+    }
+    return segments[segments.length - 1] ?? code;
+}
+export function parseESLintJSON(rawJson) {
+    const files = JSON.parse(rawJson);
+    const issues = [];
+    for (const file of files) {
+        const filePath = file.filePath ?? "";
+        for (const msg of file.messages ?? []) {
+            if (!msg.ruleId)
+                continue;
+            issues.push({
+                filePath,
+                line: msg.line ?? 0,
+                column: msg.column ?? 0,
+                ruleId: msg.ruleId,
+                message: msg.message ?? "",
+                severity: msg.severity === 1 ? 1 : 2,
+            });
+        }
+    }
+    return { issues };
+}
+export function parseSemgrepJSON(rawJson) {
+    const parsed = JSON.parse(rawJson);
+    const findings = [];
+    for (const result of parsed.results ?? []) {
+        findings.push({
+            filePath: result.path ?? "",
+            line: result.start?.line ?? 0,
+            ruleId: result.check_id ?? "",
+            message: result.extra?.message ?? "",
+            severity: (result.extra?.severity ?? "info").toLowerCase(),
+            category: result.extra?.metadata?.category,
+        });
+    }
+    return { findings };
+}
+export function parsePa11yJSON(rawJson) {
+    const parsed = JSON.parse(rawJson);
+    const issues = Array.isArray(parsed)
+        ? parsed
+        : (parsed.issues ?? []);
+    const violations = [];
+    for (const issue of issues) {
+        const code = issue.code ?? "";
+        const type = (issue.type ?? "error");
+        const { level, criterion } = deriveWcagLevel(code);
+        violations.push({
+            code,
+            technique: extractTechnique(code),
+            message: issue.message ?? "",
+            selector: issue.selector ?? "",
+            context: issue.context ?? "",
+            type,
+            wcagLevel: level,
+            criterion,
+        });
+    }
+    return { violationCount: violations.length, violations };
+}
+//# sourceMappingURL=outputParsers.js.map

package/dist/utils/outputParsers.js.map

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

package/dist/utils/reportGenerator.d.ts

@@ -0,0 +1,21 @@
+export interface ReportData {
+    url?: string;
+    path?: string;
+    release_readiness: string;
+    composite_score: number;
+    scorecard: Array<{
+        tool: string;
+        gate: string;
+        score?: number;
+        breakdown?: Record<string, number>;
+        issues?: number;
+    }>;
+    summary: string;
+    corroborated_findings: Array<Record<string, unknown>>;
+    all_findings: Array<Record<string, unknown>>;
+    correlations_found: number;
+    errors?: string[];
+    generated_at: string;
+}
+export declare function buildReportHtml(data: ReportData): string;
+export declare function generateHtmlReport(data: ReportData): Promise<string>;

package/dist/utils/reportGenerator.js

@@ -0,0 +1,291 @@
+import { writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+// ---------------------------------------------------------------------------
+// Colour helpers
+// ---------------------------------------------------------------------------
+function readinessColors(r) {
+    if (r === "BLOCKED")
+        return { bg: "#fef2f2", text: "#b91c1c", border: "#fca5a5" };
+    if (r === "CONDITIONAL")
+        return { bg: "#fffbeb", text: "#b45309", border: "#fcd34d" };
+    if (r === "ADVISORY")
+        return { bg: "#fefce8", text: "#854d0e", border: "#fde047" };
+    return { bg: "#f0fdf4", text: "#15803d", border: "#86efac" };
+}
+function gateStyle(g) {
+    if (g === "PASS")
+        return { bg: "#dcfce7", text: "#15803d" };
+    if (g === "WARN")
+        return { bg: "#fef9c3", text: "#854d0e" };
+    if (g === "FAIL")
+        return { bg: "#fee2e2", text: "#b91c1c" };
+    if (g === "SKIPPED")
+        return { bg: "#f3f4f6", text: "#6b7280" };
+    return { bg: "#f3f4f6", text: "#374151" }; // UNAVAILABLE
+}
+function priorityStyle(p) {
+    if (p === "P1")
+        return { bg: "#fee2e2", text: "#b91c1c" };
+    if (p === "P2")
+        return { bg: "#fef9c3", text: "#854d0e" };
+    return { bg: "#fefce8", text: "#854d0e" };
+}
+function scoreColor(s) {
+    if (s >= 80)
+        return "#16a34a";
+    if (s >= 50)
+        return "#d97706";
+    return "#dc2626";
+}
+// ---------------------------------------------------------------------------
+// SVG gauge (half-circle, 0-100)
+// ---------------------------------------------------------------------------
+function gauge(score) {
+    const r = 40;
+    const cx = 55, cy = 58;
+    const arcLen = Math.PI * r; // ≈ 125.66
+    const filled = (score / 100) * arcLen;
+    const color = scoreColor(score);
+    return `
+    <svg viewBox="0 0 110 65" width="130" height="80" aria-label="Composite score ${score}">
+      <path d="M ${cx - r} ${cy} A ${r} ${r} 0 0 1 ${cx + r} ${cy}"
+        fill="none" stroke="#e5e7eb" stroke-width="9" stroke-linecap="round"/>
+      <path d="M ${cx - r} ${cy} A ${r} ${r} 0 0 1 ${cx + r} ${cy}"
+        fill="none" stroke="${color}" stroke-width="9" stroke-linecap="round"
+        stroke-dasharray="${filled.toFixed(1)} ${arcLen.toFixed(1)}"
+        transform="rotate(0 ${cx} ${cy})"/>
+      <text x="${cx}" y="${cy - 4}" text-anchor="middle"
+        font-size="22" font-weight="700" fill="${color}">${score}</text>
+      <text x="${cx}" y="${cy + 10}" text-anchor="middle"
+        font-size="9" fill="#6b7280">/ 100</text>
+    </svg>`;
+}
+// ---------------------------------------------------------------------------
+// HTML fragments
+// ---------------------------------------------------------------------------
+function badge(label, bg, text) {
+    return `<span style="display:inline-block;padding:2px 10px;border-radius:999px;
+    font-size:12px;font-weight:600;background:${bg};color:${text}">${esc(label)}</span>`;
+}
+function esc(s) {
+    return String(s ?? "")
+        .replace(/&/g, "&amp;").replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function scorecardHtml(scorecard) {
+    const rows = scorecard.map(e => {
+        const gs = gateStyle(e.gate);
+        const gateBadge = badge(e.gate, gs.bg, gs.text);
+        let detail = "";
+        if (e.score !== undefined) {
+            detail = `<span style="font-weight:600">${e.score}</span><span style="color:#9ca3af;font-size:12px">/100</span>`;
+            if (e.breakdown) {
+                const parts = Object.entries(e.breakdown)
+                    .map(([k, v]) => `<span style="color:#6b7280;font-size:11px">${esc(k)}&nbsp;<b style="color:#111">${v}</b></span>`)
+                    .join("&ensp;·&ensp;");
+                detail += `<div style="margin-top:4px">${parts}</div>`;
+            }
+        }
+        else if (e.issues !== undefined) {
+            detail = `<span style="font-weight:600">${e.issues}</span><span style="color:#9ca3af;font-size:12px">&nbsp;issue${e.issues !== 1 ? "s" : ""}</span>`;
+        }
+        else {
+            detail = `<span style="color:#9ca3af;font-size:12px">—</span>`;
+        }
+        return `<tr>
+      <td style="padding:12px 16px;font-weight:500">${esc(e.tool)}</td>
+      <td style="padding:12px 16px">${gateBadge}</td>
+      <td style="padding:12px 16px">${detail}</td>
+    </tr>`;
+    }).join("");
+    return `
+    <table style="width:100%;border-collapse:collapse">
+      <thead>
+        <tr style="border-bottom:2px solid #e5e7eb">
+          <th style="padding:10px 16px;text-align:left;font-size:12px;color:#6b7280;text-transform:uppercase;letter-spacing:.05em">Tool</th>
+          <th style="padding:10px 16px;text-align:left;font-size:12px;color:#6b7280;text-transform:uppercase;letter-spacing:.05em">Gate</th>
+          <th style="padding:10px 16px;text-align:left;font-size:12px;color:#6b7280;text-transform:uppercase;letter-spacing:.05em">Result</th>
+        </tr>
+      </thead>
+      <tbody>${rows}</tbody>
+    </table>`;
+}
+function findingCard(f, showConfidence = false) {
+    const p = String(f["priority"] ?? "P3");
+    const ps = priorityStyle(p);
+    const title = String(f["title"] ?? "");
+    const desc = String(f["description"] ?? "");
+    const source = String(f["source_tool"] ?? "");
+    const confirmedBy = Array.isArray(f["confirmed_by"]) ? f["confirmed_by"] : [];
+    const evidence = f["evidence"];
+    const evidenceParts = evidence
+        ? Object.entries(evidence)
+            .filter(([, v]) => v !== "" && v !== null && v !== undefined)
+            .map(([k, v]) => `<span style="font-size:11px;color:#6b7280"><b>${esc(k)}:</b>&nbsp;${esc(v)}</span>`)
+            .join("&ensp;·&ensp;")
+        : "";
+    const corroborationBadge = showConfidence && confirmedBy.length > 0
+        ? `<span style="margin-left:8px;display:inline-block;padding:2px 8px;border-radius:4px;
+        font-size:11px;font-weight:600;background:#dbeafe;color:#1d4ed8">
+        ★ confirmed by ${confirmedBy.join(" + ")}</span>`
+        : "";
+    const sourceBadge = `<span style="padding:2px 8px;border-radius:4px;font-size:11px;
+    background:#f3f4f6;color:#374151">${esc(source)}</span>`;
+    return `
+    <details style="margin-bottom:8px;border:1px solid #e5e7eb;border-radius:8px;overflow:hidden">
+      <summary style="display:flex;align-items:center;gap:10px;padding:12px 16px;
+        cursor:pointer;list-style:none;background:#fff;user-select:none">
+        <span style="min-width:36px">${badge(p, ps.bg, ps.text)}</span>
+        <span style="flex:1;font-weight:500;font-size:14px">${esc(title)}</span>
+        ${corroborationBadge}
+        <span style="margin-left:auto">${sourceBadge}</span>
+      </summary>
+      <div style="padding:12px 16px;background:#fafafa;border-top:1px solid #e5e7eb">
+        <p style="margin:0 0 8px;font-size:14px;color:#374151;line-height:1.5">${esc(desc)}</p>
+        ${evidenceParts ? `<div style="margin-top:8px;padding:8px;background:#f3f4f6;border-radius:4px">${evidenceParts}</div>` : ""}
+      </div>
+    </details>`;
+}
+function findingSection(label, findings, bg, text, showConfidence = false, open = false) {
+    if (findings.length === 0)
+        return "";
+    const cards = findings.map(f => findingCard(f, showConfidence)).join("");
+    return `
+    <details ${open ? "open" : ""} style="margin-bottom:16px">
+      <summary style="cursor:pointer;list-style:none;padding:10px 14px;
+        background:${bg};color:${text};border-radius:8px;font-weight:600;
+        font-size:14px;user-select:none">
+        ${esc(label)} &nbsp;<span style="font-weight:400;opacity:.8">(${findings.length})</span>
+      </summary>
+      <div style="margin-top:8px">${cards}</div>
+    </details>`;
+}
+// ---------------------------------------------------------------------------
+// Full page
+// ---------------------------------------------------------------------------
+export function buildReportHtml(data) {
+    const rc = readinessColors(data.release_readiness);
+    const target = data.url ?? data.path ?? "—";
+    const isUrl = !!data.url;
+    const p1 = data.all_findings.filter(f => f["priority"] === "P1");
+    const p2 = data.all_findings.filter(f => f["priority"] === "P2");
+    const p3 = data.all_findings.filter(f => f["priority"] === "P3");
+    const corrobSection = data.corroborated_findings.length > 0
+        ? `<div style="margin-bottom:24px">
+        <h2 style="font-size:16px;font-weight:700;margin:0 0 12px;color:#1d4ed8">
+          ★ Cross-confirmed findings
+          <span style="font-size:12px;font-weight:400;color:#6b7280;margin-left:8px">
+            flagged independently by two tools — highest confidence
+          </span>
+        </h2>
+        ${data.corroborated_findings.map(f => findingCard(f, true)).join("")}
+      </div>`
+        : "";
+    const errorsHtml = data.errors && data.errors.length > 0
+        ? `<div style="margin-bottom:24px;padding:12px 16px;background:#fef3c7;
+        border:1px solid #fcd34d;border-radius:8px">
+        <p style="margin:0 0 6px;font-weight:600;font-size:13px;color:#92400e">Tool warnings</p>
+        ${data.errors.map(e => `<p style="margin:2px 0;font-size:13px;color:#78350f">${esc(e)}</p>`).join("")}
+      </div>`
+        : "";
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>QA Report — ${esc(target)}</title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; }
+    body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      background: #f3f4f6; color: #111827; }
+    details > summary::-webkit-details-marker { display: none; }
+    details > summary::marker { display: none; }
+    a { color: #2563eb; }
+  </style>
+</head>
+<body>
+  <!-- Top bar -->
+  <div style="background:#1e293b;padding:14px 32px;display:flex;
+      align-items:center;justify-content:space-between">
+    <div>
+      <span style="font-size:13px;font-weight:700;color:#94a3b8;
+        text-transform:uppercase;letter-spacing:.08em">QA Gate Report</span>
+      <div style="margin-top:2px;font-size:14px;color:#e2e8f0">
+        ${isUrl ? `<a href="${esc(data.url)}" style="color:#7dd3fc" target="_blank">${esc(target)}</a>`
+        : `<code style="color:#7dd3fc">${esc(target)}</code>`}
+      </div>
+    </div>
+    <div style="font-size:12px;color:#64748b">${esc(data.generated_at)}</div>
+  </div>
+
+  <div style="max-width:960px;margin:0 auto;padding:32px 24px">
+
+    <!-- Release readiness + composite score -->
+    <div style="display:grid;grid-template-columns:1fr auto;gap:16px;
+        background:${rc.bg};border:1px solid ${rc.border};border-radius:12px;
+        padding:24px;margin-bottom:24px;align-items:center">
+      <div>
+        <div style="font-size:13px;font-weight:600;color:${rc.text};
+          text-transform:uppercase;letter-spacing:.06em;margin-bottom:6px">
+          Release Readiness
+        </div>
+        <div style="font-size:36px;font-weight:800;color:${rc.text};margin-bottom:8px">
+          ${esc(data.release_readiness)}
+        </div>
+        <p style="margin:0;font-size:14px;color:${rc.text};opacity:.85;line-height:1.5">
+          ${esc(data.summary)}
+        </p>
+      </div>
+      <div style="text-align:center">
+        ${gauge(data.composite_score)}
+        <div style="font-size:11px;color:#6b7280;margin-top:2px">Composite Score</div>
+      </div>
+    </div>
+
+    <!-- Scorecard -->
+    <div style="background:#fff;border:1px solid #e5e7eb;border-radius:12px;
+        padding:0;margin-bottom:24px;overflow:hidden">
+      <div style="padding:14px 16px;border-bottom:1px solid #e5e7eb">
+        <h2 style="margin:0;font-size:15px;font-weight:700">Scorecard</h2>
+      </div>
+      ${scorecardHtml(data.scorecard)}
+    </div>
+
+    ${errorsHtml}
+
+    <!-- Findings -->
+    <div style="background:#fff;border:1px solid #e5e7eb;border-radius:12px;padding:20px">
+      <h2 style="margin:0 0 16px;font-size:15px;font-weight:700">
+        Findings
+        <span style="font-size:13px;font-weight:400;color:#6b7280;margin-left:8px">
+          ${data.all_findings.length} total — ${p1.length} P1 · ${p2.length} P2 · ${p3.length} P3
+        </span>
+      </h2>
+
+      ${corrobSection}
+
+      ${findingSection("P1 — Blockers", p1, "#fee2e2", "#b91c1c", false, true)}
+      ${findingSection("P2 — Warnings", p2, "#fef9c3", "#854d0e", false, false)}
+      ${findingSection("P3 — Advisories", p3, "#fefce8", "#854d0e", false, false)}
+
+      ${data.all_findings.length === 0
+        ? `<p style="text-align:center;padding:32px;color:#6b7280">No findings — all clear.</p>`
+        : ""}
+    </div>
+
+  </div>
+</body>
+</html>`;
+}
+export async function generateHtmlReport(data) {
+    const timestamp = Date.now();
+    const host = (data.url
+        ? new URL(data.url).hostname
+        : String(data.path ?? "local").split("/").pop() ?? "local").replace(/[^a-z0-9]/gi, "-").toLowerCase();
+    const filename = `qa-report-${host}-${timestamp}.html`;
+    const filepath = join(tmpdir(), filename);
+    await writeFile(filepath, buildReportHtml(data), "utf8");
+    return filepath;
+}
+//# sourceMappingURL=reportGenerator.js.map

package/dist/utils/reportGenerator.js.map

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

package/dist/utils/shellRunner.d.ts

@@ -0,0 +1,12 @@
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+}
+export interface ShellRunOptions {
+    timeoutMs?: number;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function runShell(command: string, args?: string[], options?: ShellRunOptions): Promise<ShellResult>;

package/dist/utils/shellRunner.js

@@ -0,0 +1,31 @@
+import { execa } from "execa";
+export async function runShell(command, args = [], options = {}) {
+    const { timeoutMs = 60_000, cwd, env } = options;
+    const start = Date.now();
+    try {
+        const result = await execa(command, args, {
+            timeout: timeoutMs,
+            cwd,
+            env,
+            reject: false,
+        });
+        return {
+            stdout: typeof result.stdout === "string" ? result.stdout : "",
+            stderr: typeof result.stderr === "string" ? result.stderr : "",
+            exitCode: typeof result.exitCode === "number" ? result.exitCode : -1,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: typeof e.stdout === "string" ? e.stdout : "",
+            stderr: typeof e.stderr === "string"
+                ? e.stderr
+                : (e.message ?? "shellRunner: unknown error"),
+            exitCode: typeof e.exitCode === "number" ? e.exitCode : -1,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=shellRunner.js.map

package/dist/utils/shellRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellRunner.js","sourceRoot":"","sources":["../../src/utils/shellRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,OAAO,CAAC;AAe/C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAe,EACf,OAAiB,EAAE,EACnB,UAA2B,EAAE;IAE7B,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACxC,OAAO,EAAE,SAAS;YAClB,GAAG;YACH,GAAG;YACH,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC9D,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC9D,QAAQ,EAAE,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAAiB,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACpD,MAAM,EACJ,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;gBAC1B,CAAC,CAAC,CAAC,CAAC,MAAM;gBACV,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,4BAA4B,CAAC;YACjD,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/toolResponse.d.ts

@@ -0,0 +1,12 @@
+import type { ShellResult } from "./shellRunner.js";
+interface McpErrorResponse {
+    [x: string]: unknown;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+}
+export declare function shellErrorResponse(reason: string, result: ShellResult): McpErrorResponse;
+export declare function parseErrorResponse(reason: string, err: unknown, result: ShellResult): McpErrorResponse;
+export {};