@isentinel/eslint-config 6.0.0-beta.2 → 6.0.0-beta.21

package/dist/formatter-agents.d.mts

@@ -0,0 +1,22 @@
+import { ESLint } from "eslint";
+//#region src/formatter-agents.d.ts
+/**
+ * ESLint custom formatter that prints one lint message per line in a stable,
+ * agent-friendly shape.
+ *
+ * Each line reads `path:line:column: severity ruleId: message`, with message
+ * whitespace collapsed to single spaces so a diagnostic never wraps across
+ * lines. Output is sorted deterministically (file, line, column, severity,
+ * ruleId) so identical lint runs produce byte-identical output, and returns an
+ * empty string when there are no messages.
+ *
+ * @param lintResults - The per-file lint results ESLint passes to the
+ *   formatter.
+ * @param lintResultData - Optional run metadata; `cwd` is used to relativize
+ *   file paths, falling back to `process.cwd()`.
+ * @returns The formatted report, terminated by a trailing newline, or an empty
+ *   string when nothing was reported.
+ */
+declare function eslintFormatterAgents(lintResults: ReadonlyArray<ESLint.LintResult>, lintResultData?: ESLint.LintResultData): string;
+//#endregion
+export { eslintFormatterAgents as default };

package/dist/formatter-agents.mjs

@@ -0,0 +1,69 @@
+import path from "node:path";
+import process from "node:process";
+//#region src/formatter-agents.ts
+function getSeverity(message) {
+	return message.fatal === true || message.severity === 2 ? "error" : "warning";
+}
+function getRuleId(message) {
+	return message.ruleId ?? "eslint";
+}
+function getRelativeFilePath(filePath, lintResultData) {
+	const currentWorkingDirectory = lintResultData?.cwd ?? process.cwd();
+	const relativeFilePath = path.relative(currentWorkingDirectory, filePath);
+	return relativeFilePath.length === 0 ? filePath : relativeFilePath;
+}
+function compareNumbers(first = 0, second = 0) {
+	return first - second;
+}
+function compareMessages(first, second) {
+	const fileComparison = first.filePath.localeCompare(second.filePath);
+	if (fileComparison !== 0) return fileComparison;
+	const lineComparison = compareNumbers(first.line, second.line);
+	if (lineComparison !== 0) return lineComparison;
+	const columnComparison = compareNumbers(first.column, second.column);
+	if (columnComparison !== 0) return columnComparison;
+	if (first.severity !== second.severity) return first.severity === "error" ? -1 : 1;
+	return first.ruleId.localeCompare(second.ruleId);
+}
+const WHITESPACE_REGEXP = /\s+/gu;
+/**
+* ESLint custom formatter that prints one lint message per line in a stable,
+* agent-friendly shape.
+*
+* Each line reads `path:line:column: severity ruleId: message`, with message
+* whitespace collapsed to single spaces so a diagnostic never wraps across
+* lines. Output is sorted deterministically (file, line, column, severity,
+* ruleId) so identical lint runs produce byte-identical output, and returns an
+* empty string when there are no messages.
+*
+* @param lintResults - The per-file lint results ESLint passes to the
+*   formatter.
+* @param lintResultData - Optional run metadata; `cwd` is used to relativize
+*   file paths, falling back to `process.cwd()`.
+* @returns The formatted report, terminated by a trailing newline, or an empty
+*   string when nothing was reported.
+*/
+function eslintFormatterAgents(lintResults, lintResultData) {
+	const messages = new Array();
+	for (const lintResult of lintResults) {
+		const filePath = getRelativeFilePath(lintResult.filePath, lintResultData);
+		for (const message of lintResult.messages) messages.push({
+			column: message.column,
+			filePath,
+			line: message.line,
+			message: normalizeMessage(message.message),
+			ruleId: getRuleId(message),
+			severity: getSeverity(message)
+		});
+	}
+	if (messages.length === 0) return "";
+	return `${messages.toSorted(compareMessages).map(formatMessage).join("\n")}\n`;
+}
+function normalizeMessage(message) {
+	return message.replaceAll(WHITESPACE_REGEXP, " ").trim();
+}
+function formatMessage({ column, filePath, line, message, ruleId, severity }) {
+	return `${line === void 0 ? filePath : `${filePath}:${line}:${column ?? 0}`}: ${severity} ${ruleId}: ${message}`;
+}
+//#endregion
+export { eslintFormatterAgents as default };