@paretools/python 0.21.0 → 0.22.0

package/dist/lib/formatters.js

@@ -1,10 +1,28 @@
+import { compactStreamFields } from "@paretools/shared";
+/** Maximum diagnostic entries kept in compact mode (mypy/ruff). */
+const COMPACT_MAX_DIAGNOSTICS = 20;
+/** Maximum vulnerability entries kept in compact mode (pip-audit). */
+const COMPACT_MAX_VULNS = 10;
+/** Maximum characters of a vulnerability description kept in compact mode. */
+const COMPACT_VULN_DESCRIPTION_MAX = 140;
+/** Maximum package/artifact/version entries kept in compact mode (pip-list/poetry/pyenv). */
+const COMPACT_MAX_ENTRIES = 50;
+/** Maximum message lines kept in compact mode (poetry). */
+const COMPACT_MAX_MESSAGES = 20;
 /** Formats structured pip install results into a human-readable summary of installed packages. */
 export function formatPipInstall(data) {
     const total = (data.installed ?? []).length;
-    if (data.alreadySatisfied && total === 0)
+    if (data.alreadySatisfied && total === 0 && data.success) {
         return "All requirements already satisfied.";
-    if (!data.success)
-        return "pip install failed.";
+    }
+    if (!data.success) {
+        const lines = [
+            `pip install failed${data.exitCode !== undefined ? ` (exit code ${data.exitCode})` : ""}.`,
+        ];
+        if (data.error)
+            lines.push(data.error);
+        return lines.join("\n");
+    }
     const verb = data.dryRun ? "Would install" : "Installed";
     const lines = [`${verb} ${total} packages:`];
     for (const pkg of data.installed ?? []) {
@@ -15,6 +33,9 @@ export function formatPipInstall(data) {
 /** Formats structured mypy type-check results into a human-readable diagnostic summary. */
 export function formatMypy(data) {
     const diagnostics = data.diagnostics ?? [];
+    if (data.error && diagnostics.length === 0) {
+        return [`mypy: run failed (exit code ${data.exitCode ?? "?"}).`, data.error].join("\n");
+    }
     if (data.success && diagnostics.length === 0)
         return "mypy: no errors found.";
     const errors = diagnostics.filter((d) => d.severity === "error").length;
@@ -26,12 +47,17 @@ export function formatMypy(data) {
         const code = d.code ? ` [${d.code}]` : "";
         lines.push(`  ${d.file}:${d.line}${col} ${d.severity}: ${d.message}${code}`);
     }
+    if (data.error)
+        lines.push(data.error);
     return lines.join("\n");
 }
 /** Formats structured ruff lint results into a human-readable diagnostic listing. */
 export function formatRuff(data) {
     const diagnostics = data.diagnostics ?? [];
     const total = diagnostics.length;
+    if (data.error && total === 0) {
+        return [`ruff: run failed (exit code ${data.exitCode ?? "?"}).`, data.error].join("\n");
+    }
     if (total === 0)
         return "ruff: no issues found.";
     const fixable = diagnostics.filter((d) => d.fixable).length;
@@ -47,6 +73,12 @@ export function formatRuff(data) {
 export function formatPipAudit(data) {
     const vulns = data.vulnerabilities ?? [];
     const total = vulns.length;
+    if (data.error && total === 0) {
+        return [
+            `pip-audit: audit failed (exit code ${data.exitCode ?? "?"}) — result is NOT a clean scan.`,
+            data.error,
+        ].join("\n");
+    }
     if (total === 0)
         return "No vulnerabilities found.";
     const lines = [`${total} vulnerabilities:`];
@@ -61,8 +93,14 @@ export function formatPipAudit(data) {
 /** Formats structured pytest results into a human-readable test summary. */
 export function formatPytest(data) {
     const total = data.passed + data.failed + data.errors + data.skipped;
-    if (total === 0)
-        return "pytest: no tests collected.";
+    if (total === 0) {
+        if (data.success)
+            return "pytest: no tests collected.";
+        const lines = [`pytest: run failed with no test results (exit code ${data.exitCode ?? "?"}).`];
+        if (data.errorOutput)
+            lines.push(data.errorOutput);
+        return lines.join("\n");
+    }
     const parts = [];
     if (data.passed > 0)
         parts.push(`${data.passed} passed`);
@@ -78,6 +116,9 @@ export function formatPytest(data) {
     for (const f of data.failures ?? []) {
         lines.push(`  FAILED ${f.test}: ${f.message}`);
     }
+    if (data.errorOutput) {
+        lines.push(data.errorOutput);
+    }
     return lines.join("\n");
 }
 /** Formats structured uv install results into a human-readable summary. */
@@ -157,7 +198,7 @@ export function formatBlack(data) {
     return lines.join("\n");
 }
 export function compactPytestMap(data) {
-    return {
+    const compact = {
         success: data.success,
         passed: data.passed,
         failed: data.failed,
@@ -166,11 +207,22 @@ export function compactPytestMap(data) {
         warnings: data.warnings,
         failedTests: (data.failures ?? []).map((f) => f.test),
     };
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    if (data.errorOutput !== undefined)
+        compact.errorOutput = data.errorOutput;
+    return compact;
 }
 export function formatPytestCompact(data) {
     const total = data.passed + data.failed + data.errors + data.skipped;
-    if (total === 0)
-        return "pytest: no tests collected.";
+    if (total === 0) {
+        if (data.success)
+            return "pytest: no tests collected.";
+        const lines = [`pytest: run failed with no test results (exit code ${data.exitCode ?? "?"}).`];
+        if (data.errorOutput)
+            lines.push(data.errorOutput);
+        return lines.join("\n");
+    }
     const parts = [];
     if (data.passed > 0)
         parts.push(`${data.passed} passed`);
@@ -186,29 +238,97 @@ export function formatPytestCompact(data) {
     for (const t of data.failedTests) {
         lines.push(`  FAILED ${t}`);
     }
+    if (data.errorOutput) {
+        lines.push(data.errorOutput);
+    }
     return lines.join("\n");
 }
 export function compactMypyMap(data) {
-    return {
+    const diagnostics = data.diagnostics ?? [];
+    const compact = {
         success: data.success,
+        errorCount: diagnostics.filter((d) => d.severity === "error").length,
+        warningCount: diagnostics.filter((d) => d.severity === "warning").length,
     };
+    if (diagnostics.length > 0) {
+        compact.diagnostics = diagnostics.slice(0, COMPACT_MAX_DIAGNOSTICS).map((d) => ({
+            file: d.file,
+            line: d.line,
+            severity: d.severity,
+            message: d.message,
+            ...(d.code ? { code: d.code } : {}),
+        }));
+        if (diagnostics.length > COMPACT_MAX_DIAGNOSTICS)
+            compact.truncated = true;
+    }
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    return compact;
 }
 export function formatMypyCompact(data) {
-    if (data.success)
+    const diagnostics = data.diagnostics ?? [];
+    if (data.error && diagnostics.length === 0) {
+        return [`mypy: run failed (exit code ${data.exitCode ?? "?"}).`, data.error].join("\n");
+    }
+    if (data.success && diagnostics.length === 0)
         return "mypy: no errors found.";
-    return "mypy: errors found.";
+    const lines = [`mypy: ${data.errorCount} errors, ${data.warningCount} warnings`];
+    for (const d of diagnostics) {
+        const code = d.code ? ` [${d.code}]` : "";
+        lines.push(`  ${d.file}:${d.line} ${d.severity}: ${d.message}${code}`);
+    }
+    if (data.truncated) {
+        lines.push("  … more diagnostics omitted (run with compact:false for the full list)");
+    }
+    if (data.error)
+        lines.push(data.error);
+    return lines.join("\n");
 }
 export function compactRuffMap(data) {
-    return {
+    const diagnostics = data.diagnostics ?? [];
+    const compact = {
         success: data.success,
+        total: diagnostics.length,
+        fixableCount: diagnostics.filter((d) => d.fixable).length,
         fixedCount: data.fixedCount,
     };
+    if (diagnostics.length > 0) {
+        compact.diagnostics = diagnostics.slice(0, COMPACT_MAX_DIAGNOSTICS).map((d) => ({
+            file: d.file,
+            line: d.line,
+            column: d.column,
+            code: d.code,
+            message: d.message,
+            fixable: d.fixable,
+        }));
+        if (diagnostics.length > COMPACT_MAX_DIAGNOSTICS)
+            compact.truncated = true;
+    }
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    return compact;
 }
 export function formatRuffCompact(data) {
-    if (data.success && !data.fixedCount)
+    if (data.error && data.total === 0) {
+        return [`ruff: run failed (exit code ${data.exitCode ?? "?"}).`, data.error].join("\n");
+    }
+    if (data.total === 0 && !data.fixedCount)
         return "ruff: no issues found.";
     const fixedPart = data.fixedCount !== undefined ? `, ${data.fixedCount} fixed` : "";
-    return `ruff: issues found${fixedPart}`;
+    const lines = [`ruff: ${data.total} issues (${data.fixableCount} fixable${fixedPart})`];
+    for (const d of data.diagnostics ?? []) {
+        lines.push(`  ${d.file}:${d.line}:${d.column} ${d.code}: ${d.message}`);
+    }
+    if (data.truncated) {
+        lines.push(`  … ${data.total - (data.diagnostics ?? []).length} more issues omitted (run with compact:false for the full list)`);
+    }
+    if (data.error)
+        lines.push(data.error);
+    return lines.join("\n");
 }
 export function compactBlackMap(data) {
     return {
@@ -230,29 +350,89 @@ export function formatBlackCompact(data) {
     return `black: ${data.filesChanged} reformatted, ${data.filesUnchanged} unchanged`;
 }
 export function compactPipInstallMap(data) {
-    return {
+    const compact = {
         success: data.success,
         alreadySatisfied: data.alreadySatisfied,
         dryRun: data.dryRun || undefined,
     };
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    return compact;
 }
 export function formatPipInstallCompact(data) {
+    if (!data.success) {
+        const lines = [
+            `pip install failed${data.exitCode !== undefined ? ` (exit code ${data.exitCode})` : ""}.`,
+        ];
+        if (data.error)
+            lines.push(data.error);
+        return lines.join("\n");
+    }
     if (data.alreadySatisfied)
         return "All requirements already satisfied.";
-    if (!data.success)
-        return "pip install failed.";
     const verb = data.dryRun ? "Would install" : "Installed";
     return `${verb} packages.`;
 }
 export function compactPipAuditMap(data) {
-    return {
+    const vulns = data.vulnerabilities ?? [];
+    const compact = {
         success: data.success,
+        total: vulns.length,
     };
+    if (vulns.length > 0) {
+        const severityCounts = {};
+        for (const v of vulns) {
+            const severity = v.severity ?? "unknown";
+            severityCounts[severity] = (severityCounts[severity] ?? 0) + 1;
+        }
+        compact.severityCounts = severityCounts;
+        compact.vulnerabilities = vulns.slice(0, COMPACT_MAX_VULNS).map((v) => ({
+            name: v.name,
+            version: v.version,
+            id: v.id,
+            description: v.description.length > COMPACT_VULN_DESCRIPTION_MAX
+                ? v.description.slice(0, COMPACT_VULN_DESCRIPTION_MAX) + "…"
+                : v.description,
+            fixVersions: v.fixVersions,
+            ...(v.severity ? { severity: v.severity } : {}),
+        }));
+        if (vulns.length > COMPACT_MAX_VULNS)
+            compact.truncated = true;
+    }
+    if (data.skipped && data.skipped.length > 0)
+        compact.skippedCount = data.skipped.length;
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    return compact;
 }
 export function formatPipAuditCompact(data) {
-    if (data.success)
+    if (data.error && data.total === 0) {
+        return [
+            `pip-audit: audit failed (exit code ${data.exitCode ?? "?"}) — result is NOT a clean scan.`,
+            data.error,
+        ].join("\n");
+    }
+    if (data.total === 0)
         return "No vulnerabilities found.";
-    return "Vulnerabilities found.";
+    const severityPart = data.severityCounts
+        ? ` (${Object.entries(data.severityCounts)
+            .map(([sev, count]) => `${count} ${sev}`)
+            .join(", ")})`
+        : "";
+    const lines = [`${data.total} vulnerabilities${severityPart}:`];
+    for (const v of data.vulnerabilities ?? []) {
+        const fix = v.fixVersions.length ? ` (fix: ${v.fixVersions.join(", ")})` : "";
+        const severity = v.severity ? ` [${v.severity}]` : "";
+        lines.push(`  ${v.name}==${v.version} ${v.id}${severity}${fix}`);
+    }
+    if (data.truncated) {
+        lines.push(`  … ${data.total - (data.vulnerabilities ?? []).length} more omitted (run with compact:false for the full list)`);
+    }
+    return lines.join("\n");
 }
 export function compactUvInstallMap(data) {
     return {
@@ -278,12 +458,23 @@ export function compactUvRunMap(data) {
         exitCode: data.exitCode,
         success: data.success,
         truncated: data.truncated,
+        ...compactStreamFields(data.stdout, data.commandStderr ?? data.stderr),
     };
 }
 export function formatUvRunCompact(data) {
     const status = data.success ? "completed" : `failed (exit ${data.exitCode})`;
     const truncated = data.truncated ? " (truncated)" : "";
-    return `uv run ${status}${truncated}`;
+    const lines = [`uv run ${status}${truncated}`];
+    if (data.stdout?.trim()) {
+        lines.push("stdout:", data.stdout.trim());
+    }
+    if (data.stderr?.trim()) {
+        lines.push("stderr:", data.stderr.trim());
+    }
+    if (data.stdoutTruncated || data.stderrTruncated) {
+        lines.push("… streams truncated to compact budget (run with compact:false for full output)");
+    }
+    return lines.join("\n");
 }
 // ── pip-list formatters ──────────────────────────────────────────────
 /** Formats structured pip list results into a human-readable package listing. */
@@ -301,17 +492,37 @@ export function formatPipList(data) {
     return lines.join("\n");
 }
 export function compactPipListMap(data) {
-    return {
+    const packages = data.packages ?? [];
+    const compact = {
         success: data.success,
+        total: packages.length,
         error: data.error,
     };
+    if (packages.length > 0) {
+        compact.packages = packages.slice(0, COMPACT_MAX_ENTRIES).map((p) => ({
+            name: p.name,
+            version: p.version,
+            ...(p.latestVersion ? { latestVersion: p.latestVersion } : {}),
+        }));
+        if (packages.length > COMPACT_MAX_ENTRIES)
+            compact.truncated = true;
+    }
+    return compact;
 }
 export function formatPipListCompact(data) {
     if (data.error)
         return `pip list error: ${data.error}`;
-    if (data.success)
-        return "Packages listed.";
-    return "No packages installed.";
+    if (data.total === 0)
+        return "No packages installed.";
+    const lines = [`${data.total} packages installed:`];
+    for (const pkg of data.packages ?? []) {
+        const latest = pkg.latestVersion ? ` (latest: ${pkg.latestVersion})` : "";
+        lines.push(`  ${pkg.name}==${pkg.version}${latest}`);
+    }
+    if (data.truncated) {
+        lines.push(`  … ${data.total - (data.packages ?? []).length} more omitted (run with compact:false for the full list)`);
+    }
+    return lines.join("\n");
 }
 // ── pip-show formatters ──────────────────────────────────────────────
 /** Formats structured pip show results into a human-readable package info display. */
@@ -376,6 +587,9 @@ export function formatPipShowCompact(data) {
 // ── ruff-format formatters ───────────────────────────────────────────
 /** Formats structured ruff format results into a human-readable summary. */
 export function formatRuffFormat(data) {
+    if (data.error && data.filesChanged === 0) {
+        return [`ruff format: run failed (exit code ${data.exitCode ?? "?"}).`, data.error].join("\n");
+    }
     if (data.success && data.filesChanged === 0) {
         const unchanged = data.filesUnchanged > 0 ? ` (${data.filesUnchanged} unchanged)` : "";
         return `ruff format: all files already formatted.${unchanged}`;
@@ -392,14 +606,22 @@ export function formatRuffFormat(data) {
     return lines.join("\n");
 }
 export function compactRuffFormatMap(data) {
-    return {
+    const compact = {
         success: data.success,
         filesChanged: data.filesChanged,
         filesUnchanged: data.filesUnchanged,
         checkMode: data.checkMode || undefined,
     };
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    return compact;
 }
 export function formatRuffFormatCompact(data) {
+    if (data.error && data.filesChanged === 0) {
+        return [`ruff format: run failed (exit code ${data.exitCode ?? "?"}).`, data.error].join("\n");
+    }
     if (data.success && data.filesChanged === 0) {
         const unchanged = data.filesUnchanged > 0 ? ` (${data.filesUnchanged} unchanged)` : "";
         return `ruff format: all files already formatted.${unchanged}`;
@@ -672,6 +894,29 @@ export function formatPyenv(data) {
     }
 }
 export function compactPyenvMap(data) {
+    const compact = {
+        action: data.action,
+        success: data.success,
+    };
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.action === "versions") {
+        if (data.versions)
+            compact.versions = data.versions;
+        if (data.current)
+            compact.current = data.current;
+        return compact;
+    }
+    if (data.action === "installList") {
+        const avail = data.availableVersions ?? [];
+        compact.availableVersionCount = avail.length;
+        if (avail.length > 0) {
+            compact.availableVersions = avail.slice(0, COMPACT_MAX_ENTRIES);
+            if (avail.length > COMPACT_MAX_ENTRIES)
+                compact.truncated = true;
+        }
+        return compact;
+    }
     let keyValue;
     if (data.action === "version")
         keyValue = data.current;
@@ -685,15 +930,31 @@ export function compactPyenvMap(data) {
         keyValue = data.uninstalled;
     if (data.action === "which")
         keyValue = data.commandPath;
-    return {
-        action: data.action,
-        success: data.success,
-        keyValue,
-    };
+    compact.keyValue = keyValue;
+    return compact;
 }
 export function formatPyenvCompact(data) {
-    if (!data.success)
-        return `pyenv ${data.action} failed.`;
+    if (!data.success) {
+        return `pyenv ${data.action} failed${data.error ? `: ${data.error}` : "."}`;
+    }
+    if (data.versions) {
+        const lines = [`${data.versions.length} versions installed:`];
+        for (const v of data.versions) {
+            const marker = v === data.current ? " *" : "";
+            lines.push(`  ${v}${marker}`);
+        }
+        return lines.join("\n");
+    }
+    if (data.availableVersionCount !== undefined) {
+        const lines = [`${data.availableVersionCount} versions available for installation:`];
+        for (const v of data.availableVersions ?? []) {
+            lines.push(`  ${v}`);
+        }
+        if (data.truncated) {
+            lines.push(`  … ${data.availableVersionCount - (data.availableVersions ?? []).length} more omitted (run with compact:false for the full list)`);
+        }
+        return lines.join("\n");
+    }
     if (data.keyValue)
         return `pyenv ${data.action}: ${data.keyValue}`;
     return `pyenv ${data.action}: success.`;
@@ -702,8 +963,17 @@ export function formatPyenvCompact(data) {
 /** Formats structured poetry results into a human-readable summary.
  *  action is passed separately since it is not included in the output schema. */
 export function formatPoetry(data, action) {
-    if (!data.success)
-        return `poetry ${action} failed.`;
+    if (!data.success) {
+        const lines = [
+            `poetry ${action} failed${data.exitCode !== undefined ? ` (exit code ${data.exitCode})` : ""}.`,
+        ];
+        for (const m of data.messages ?? []) {
+            lines.push(`  ${m}`);
+        }
+        if (data.error)
+            lines.push(data.error);
+        return lines.join("\n");
+    }
     if (action === "show") {
         const pkgs = data.packages ?? [];
         if (pkgs.length === 0)
@@ -746,13 +1016,59 @@ export function formatPoetry(data, action) {
     return lines.join("\n");
 }
 export function compactPoetryMap(data) {
-    return {
+    const compact = {
         success: data.success,
     };
+    if (data.packages) {
+        compact.packageCount = data.packages.length;
+        compact.packages = data.packages
+            .slice(0, COMPACT_MAX_ENTRIES)
+            .map((p) => ({ name: p.name, version: p.version }));
+        if (data.packages.length > COMPACT_MAX_ENTRIES)
+            compact.truncated = true;
+    }
+    if (data.artifacts) {
+        compact.artifactCount = data.artifacts.length;
+        compact.artifacts = data.artifacts.slice(0, COMPACT_MAX_ENTRIES).map((a) => ({ file: a.file }));
+        if (data.artifacts.length > COMPACT_MAX_ENTRIES)
+            compact.truncated = true;
+    }
+    if (data.messages) {
+        compact.messageCount = data.messages.length;
+        compact.messages = data.messages.slice(0, COMPACT_MAX_MESSAGES);
+        if (data.messages.length > COMPACT_MAX_MESSAGES)
+            compact.truncated = true;
+    }
+    if (data.error !== undefined)
+        compact.error = data.error;
+    if (data.exitCode !== undefined)
+        compact.exitCode = data.exitCode;
+    return compact;
 }
 export function formatPoetryCompact(data) {
-    if (!data.success)
-        return "poetry: failed.";
-    return "poetry: success.";
+    const lines = [data.success ? "poetry: success." : "poetry: failed."];
+    if (data.packageCount !== undefined) {
+        lines.push(`${data.packageCount} packages:`);
+        for (const pkg of data.packages ?? []) {
+            lines.push(`  ${pkg.name}==${pkg.version}`);
+        }
+    }
+    if (data.artifactCount !== undefined) {
+        lines.push(`${data.artifactCount} artifacts:`);
+        for (const a of data.artifacts ?? []) {
+            lines.push(`  ${a.file}`);
+        }
+    }
+    if (data.messages && data.messages.length > 0) {
+        for (const m of data.messages) {
+            lines.push(`  ${m}`);
+        }
+    }
+    if (data.truncated) {
+        lines.push("  … entries omitted (run with compact:false for the full list)");
+    }
+    if (data.error)
+        lines.push(data.error);
+    return lines.join("\n");
 }
 //# sourceMappingURL=formatters.js.map