aislop 0.8.1 → 0.8.2

package/dist/cli.js

@@ -730,9 +730,14 @@ const detectOverAbstraction = async (context) => {
 	return diagnostics;
 };
 
+//#endregion
+//#region src/engines/ai-slop/non-production-paths.ts
+const DIR_PATTERN = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3|cli|cli-[\w-]+|[\w-]+-cli)\//i;
+const BASENAME_PATTERN = /(?:^|\/)(?:benchmark|bench|demo|example|script|seed|migrate|profile|smoke|stress|load|debug|repro)[-_.][^/]*\.[mc]?[jt]sx?$|(?:^|\/)[^/]+[-_](?:benchmark|bench|demo|example)\.[mc]?[jt]sx?$/i;
+const isNonProductionPath = (relativePath) => DIR_PATTERN.test(relativePath) || BASENAME_PATTERN.test(relativePath);
+
 //#endregion
 //#region src/engines/ai-slop/comments.ts
-const NON_PRODUCTION_DIR_PATTERN$2 = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3)\//i;
 const TRIVIAL_VERB_STEMS = "Import|Defin|Initializ|Setting|Set\\s+up|Setup|Return|Check|Loop|Iterat|Creat|Updat|Delet|Remov|Handl|Get|Fetch|Increment|Decrement|Writ|Runn|Run|Pars|Execut|Extract|Sav|Load|Build|Start|Stopp|Stop|Clean(?:up|\\s+up)?|Configur|Validat|Process|Queue|Fire|Emit|Dispatch|Log|Print|Render";
 const TRIVIAL_JS_COMMENT_PATTERNS = [/\/\/\s*This (?:function|method|class|variable|constant) (?:will |is used to |is responsible for )?/i, new RegExp(`\\/\\/\\s*(?:${TRIVIAL_VERB_STEMS})(?:e|es|ing|s)?\\b`, "i")];
 const TRIVIAL_PYTHON_COMMENT_PATTERNS = [/^#\s*This (?:function|method|class) (?:will |is used to )?/i, new RegExp(`^#\\s*(?:${TRIVIAL_VERB_STEMS})(?:e|es|ing|s)?\\b`, "i")];
@@ -789,7 +794,7 @@ const detectTrivialComments = async (context) => {
 	for (const filePath of files) {
 		if (isAutoGenerated(filePath)) continue;
 		const relativePath = path.relative(context.rootDirectory, filePath);
-		if (NON_PRODUCTION_DIR_PATTERN$2.test(relativePath)) continue;
+		if (isNonProductionPath(relativePath)) continue;
 		let content;
 		try {
 			content = fs.readFileSync(filePath, "utf-8");
@@ -825,11 +830,10 @@ const slop = (filePath, line, rule, severity, message, help, fixable) => ({
 	fixable
 });
 const LOGGER_FILE_PATTERN = /(?:^|\/)(?:logger|logging|log)\.[^/]+$/i;
-const NON_PRODUCTION_DIR_PATTERN$1 = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|cli|cli-[\w-]+|[\w-]+-cli)\//;
 const detectConsoleLeftovers = (content, relativePath, ext) => {
 	if (!JS_EXTENSIONS$4.has(ext)) return [];
 	if (LOGGER_FILE_PATTERN.test(relativePath)) return [];
-	if (NON_PRODUCTION_DIR_PATTERN$1.test(relativePath)) return [];
+	if (isNonProductionPath(relativePath)) return [];
 	const diagnostics = [];
 	const lines = content.split("\n");
 	for (let i = 0; i < lines.length; i++) {
@@ -879,7 +883,7 @@ const asAnyPattern = new RegExp(`\\bas\\s+any\\b`);
 const doubleAssertPattern = new RegExp(`\\bas\\s+unknown\\s+as\\s+`);
 const detectUnsafeTypePatterns = (content, relativePath, ext) => {
 	if (ext !== ".ts" && ext !== ".tsx") return [];
-	if (NON_PRODUCTION_DIR_PATTERN$1.test(relativePath)) return [];
+	if (isNonProductionPath(relativePath)) return [];
 	const diagnostics = [];
 	const lines = content.split("\n");
 	for (let i = 0; i < lines.length; i++) {
@@ -1784,7 +1788,6 @@ const PHP_DECL_START = /^\s*(?:public|private|protected|static|final|abstract|re
 
 //#endregion
 //#region src/engines/ai-slop/narrative-comments.ts
-const NON_PRODUCTION_DIR_PATTERN = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3)\//i;
 const stripJsdocLine = (line) => line.replace(/^\s*\/\*\*+\s?/, "").replace(/\s*\*+\/\s*$/, "").replace(/^\s*\*\s?/, "").trim();
 const stripLineComment = (line) => line.replace(/^\s*(?:(?:\/\/)|#)\s?/, "");
 const getCommentSyntax = (ext) => {
@@ -1935,13 +1938,21 @@ const looksLikeGoDocComment = (block, ext) => {
 	if (!declMatch) return false;
 	return ((block.prose.find((l) => l.length > 0) ?? "").split(/\s+/)[0] ?? "") === declMatch[1];
 };
-const DOC_INDICATOR_RE = /`[^`]+`|\|\s*[-:]+\s*\||```|\b(?:note|warning|warn|caveat|example|caution|see):/i;
+const DOC_INDICATOR_RE = /`[^`]+`|\|\s*[-:]+\s*\||```|\b(?:note|warning|warn|caveat|example|caution|see):|\(e\.g\.[^)]+\)|\(i\.e\.[^)]+\)/i;
 const hasDocIndicator = (block) => {
 	const joined = block.prose.join(" ");
 	if (DOC_INDICATOR_RE.test(joined)) return true;
 	for (const l of block.prose) if (/^[-]\s/.test(l)) return true;
 	return false;
 };
+const hasPreambleSlopSignal = (block) => {
+	const joined = block.prose.join(" ");
+	for (const l of block.prose) {
+		if (EXPLANATORY_OPENERS.test(l)) return true;
+		if (JUSTIFICATION_OPENERS.some((re) => re.test(l))) return true;
+	}
+	return CROSS_REFERENCE_PHRASES.some((re) => re.test(joined));
+};
 const detectNarrativeInBlock = (block, ext) => {
 	if (looksLikeLicenseHeader(block)) return {
 		matched: false,
@@ -1981,9 +1992,13 @@ const detectNarrativeInBlock = (block, ext) => {
 		matched: false,
 		reason: ""
 	};
-	if (block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext)) return {
+	if (block.kind === "line" && block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext)) return {
+		matched: true,
+		reason: "multi-line preamble before declaration"
+	};
+	if (block.kind === "jsdoc" && block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext) && hasPreambleSlopSignal(block)) return {
 		matched: true,
-		reason: block.kind === "jsdoc" ? "JSDoc preamble before declaration" : "multi-line preamble before declaration"
+		reason: "JSDoc preamble with slop signal"
 	};
 	if (CROSS_REFERENCE_PHRASES.some((re) => re.test(joined))) return {
 		matched: true,
@@ -2023,7 +2038,7 @@ const detectNarrativeComments = async (context) => {
 		const syntax = getCommentSyntax(ext);
 		if (!syntax) continue;
 		const relativePath = path.relative(context.rootDirectory, filePath);
-		if (NON_PRODUCTION_DIR_PATTERN.test(relativePath)) continue;
+		if (isNonProductionPath(relativePath)) continue;
 		let content;
 		try {
 			content = fs.readFileSync(filePath, "utf-8");
@@ -7556,7 +7571,7 @@ const renderCleanRun = (input, deps = {}) => {
 
 //#endregion
 //#region src/version.ts
-const APP_VERSION = "0.8.1";
+const APP_VERSION = "0.8.2";
 
 //#endregion
 //#region src/utils/telemetry.ts
@@ -9382,13 +9397,77 @@ const fixDependencyAudit = async (context, onProgress) => {
 	}
 	onProgress?.("Dependency audit fixes · skipping (pnpm audit unavailable and no package-lock.json for npm fallback)");
 };
+const SEMVER_PREFIX_RE = /^[~^]?/;
+const parseSemverMin = (spec) => {
+	const match = spec.replace(SEMVER_PREFIX_RE, "").match(/^(\d+|x|X|\*)(?:\.(\d+|x|X|\*))?(?:\.(\d+|x|X|\*))?/);
+	if (!match) return null;
+	const head = match[1];
+	if (!/^\d+$/.test(head)) return null;
+	const toNum = (part) => {
+		if (!part) return 0;
+		return /^\d+$/.test(part) ? Number(part) : 0;
+	};
+	return [
+		Number(head),
+		toNum(match[2]),
+		toNum(match[3])
+	];
+};
+const isDowngrade = (oldSpec, newSpec) => {
+	const oldV = parseSemverMin(oldSpec);
+	const newV = parseSemverMin(newSpec);
+	if (!oldV || !newV) return false;
+	for (let i = 0; i < 3; i++) {
+		if ((newV[i] ?? 0) < (oldV[i] ?? 0)) return true;
+		if ((newV[i] ?? 0) > (oldV[i] ?? 0)) return false;
+	}
+	return false;
+};
+const DEP_BUCKETS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+const snapshotPackageVersions = (pkg) => {
+	const map = /* @__PURE__ */ new Map();
+	for (const bucket of DEP_BUCKETS) {
+		const deps = pkg[bucket];
+		if (!deps || typeof deps !== "object") continue;
+		for (const [name, version] of Object.entries(deps)) if (typeof version === "string") map.set(`${bucket}:${name}`, version);
+	}
+	return map;
+};
+const revertDowngrades = (rootDir, before) => {
+	const pkgPath = path.join(rootDir, "package.json");
+	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	const reverted = [];
+	for (const bucket of DEP_BUCKETS) {
+		const deps = pkg[bucket];
+		if (!deps) continue;
+		for (const [name, version] of Object.entries(deps)) {
+			const prior = before.get(`${bucket}:${name}`);
+			if (!prior) continue;
+			if (isDowngrade(prior, version)) {
+				deps[name] = prior;
+				reverted.push(`${name} ${version} → ${prior}`);
+			}
+		}
+	}
+	if (reverted.length > 0) fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+	return reverted;
+};
 const runNpmAuditFix = async (rootDir, onProgress) => {
+	const pkgPath = path.join(rootDir, "package.json");
+	const before = snapshotPackageVersions(JSON.parse(fs.readFileSync(pkgPath, "utf-8")));
 	onProgress?.("Dependency audit fixes · running npm audit fix (can take a few minutes)");
 	const result = await runSubprocess("npm", ["audit", "fix"], {
 		cwd: rootDir,
 		timeout: INSTALL_TIMEOUT
 	});
 	if (result.exitCode !== 0 && !result.stdout && !result.stderr) throw new Error("npm audit fix failed");
+	const reverted = revertDowngrades(rootDir, before);
+	if (reverted.length > 0) onProgress?.(`Dependency audit fixes · reverted ${reverted.length} downgrade(s): ${reverted.join(", ")}`);
 	onProgress?.("Dependency audit fixes · running npm install");
 	const installResult = await runSubprocess("npm", ["install"], {
 		cwd: rootDir,

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as ENGINE_INFO, r as getEngineLabel, t as APP_VERSION } from "./version-B7_FRirI.js";
+import { n as ENGINE_INFO, r as getEngineLabel, t as APP_VERSION } from "./version-G3ekYjY1.js";
 import { n as runSubprocess, t as isToolInstalled } from "./subprocess-CQUJDGgn.js";
 import { r as runGenericLinter, t as fixRubyLint } from "./generic-BrcWMW7E.js";
 import { n as runExpoDoctor } from "./expo-doctor-Bz0LZhQ6.js";
@@ -1272,9 +1272,14 @@ const detectOverAbstraction = async (context) => {
 	return diagnostics;
 };
 
+//#endregion
+//#region src/engines/ai-slop/non-production-paths.ts
+const DIR_PATTERN = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3|cli|cli-[\w-]+|[\w-]+-cli)\//i;
+const BASENAME_PATTERN = /(?:^|\/)(?:benchmark|bench|demo|example|script|seed|migrate|profile|smoke|stress|load|debug|repro)[-_.][^/]*\.[mc]?[jt]sx?$|(?:^|\/)[^/]+[-_](?:benchmark|bench|demo|example)\.[mc]?[jt]sx?$/i;
+const isNonProductionPath = (relativePath) => DIR_PATTERN.test(relativePath) || BASENAME_PATTERN.test(relativePath);
+
 //#endregion
 //#region src/engines/ai-slop/comments.ts
-const NON_PRODUCTION_DIR_PATTERN$2 = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3)\//i;
 const TRIVIAL_VERB_STEMS = "Import|Defin|Initializ|Setting|Set\\s+up|Setup|Return|Check|Loop|Iterat|Creat|Updat|Delet|Remov|Handl|Get|Fetch|Increment|Decrement|Writ|Runn|Run|Pars|Execut|Extract|Sav|Load|Build|Start|Stopp|Stop|Clean(?:up|\\s+up)?|Configur|Validat|Process|Queue|Fire|Emit|Dispatch|Log|Print|Render";
 const TRIVIAL_JS_COMMENT_PATTERNS = [/\/\/\s*This (?:function|method|class|variable|constant) (?:will |is used to |is responsible for )?/i, new RegExp(`\\/\\/\\s*(?:${TRIVIAL_VERB_STEMS})(?:e|es|ing|s)?\\b`, "i")];
 const TRIVIAL_PYTHON_COMMENT_PATTERNS = [/^#\s*This (?:function|method|class) (?:will |is used to )?/i, new RegExp(`^#\\s*(?:${TRIVIAL_VERB_STEMS})(?:e|es|ing|s)?\\b`, "i")];
@@ -1331,7 +1336,7 @@ const detectTrivialComments = async (context) => {
 	for (const filePath of files) {
 		if (isAutoGenerated(filePath)) continue;
 		const relativePath = path.relative(context.rootDirectory, filePath);
-		if (NON_PRODUCTION_DIR_PATTERN$2.test(relativePath)) continue;
+		if (isNonProductionPath(relativePath)) continue;
 		let content;
 		try {
 			content = fs.readFileSync(filePath, "utf-8");
@@ -1367,11 +1372,10 @@ const slop = (filePath, line, rule, severity, message, help, fixable) => ({
 	fixable
 });
 const LOGGER_FILE_PATTERN = /(?:^|\/)(?:logger|logging|log)\.[^/]+$/i;
-const NON_PRODUCTION_DIR_PATTERN$1 = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|cli|cli-[\w-]+|[\w-]+-cli)\//;
 const detectConsoleLeftovers = (content, relativePath, ext) => {
 	if (!JS_EXTENSIONS$4.has(ext)) return [];
 	if (LOGGER_FILE_PATTERN.test(relativePath)) return [];
-	if (NON_PRODUCTION_DIR_PATTERN$1.test(relativePath)) return [];
+	if (isNonProductionPath(relativePath)) return [];
 	const diagnostics = [];
 	const lines = content.split("\n");
 	for (let i = 0; i < lines.length; i++) {
@@ -1421,7 +1425,7 @@ const asAnyPattern = new RegExp(`\\bas\\s+any\\b`);
 const doubleAssertPattern = new RegExp(`\\bas\\s+unknown\\s+as\\s+`);
 const detectUnsafeTypePatterns = (content, relativePath, ext) => {
 	if (ext !== ".ts" && ext !== ".tsx") return [];
-	if (NON_PRODUCTION_DIR_PATTERN$1.test(relativePath)) return [];
+	if (isNonProductionPath(relativePath)) return [];
 	const diagnostics = [];
 	const lines = content.split("\n");
 	for (let i = 0; i < lines.length; i++) {
@@ -2326,7 +2330,6 @@ const PHP_DECL_START = /^\s*(?:public|private|protected|static|final|abstract|re
 
 //#endregion
 //#region src/engines/ai-slop/narrative-comments.ts
-const NON_PRODUCTION_DIR_PATTERN = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3)\//i;
 const stripJsdocLine = (line) => line.replace(/^\s*\/\*\*+\s?/, "").replace(/\s*\*+\/\s*$/, "").replace(/^\s*\*\s?/, "").trim();
 const stripLineComment = (line) => line.replace(/^\s*(?:(?:\/\/)|#)\s?/, "");
 const getCommentSyntax = (ext) => {
@@ -2477,13 +2480,21 @@ const looksLikeGoDocComment = (block, ext) => {
 	if (!declMatch) return false;
 	return ((block.prose.find((l) => l.length > 0) ?? "").split(/\s+/)[0] ?? "") === declMatch[1];
 };
-const DOC_INDICATOR_RE = /`[^`]+`|\|\s*[-:]+\s*\||```|\b(?:note|warning|warn|caveat|example|caution|see):/i;
+const DOC_INDICATOR_RE = /`[^`]+`|\|\s*[-:]+\s*\||```|\b(?:note|warning|warn|caveat|example|caution|see):|\(e\.g\.[^)]+\)|\(i\.e\.[^)]+\)/i;
 const hasDocIndicator = (block) => {
 	const joined = block.prose.join(" ");
 	if (DOC_INDICATOR_RE.test(joined)) return true;
 	for (const l of block.prose) if (/^[-]\s/.test(l)) return true;
 	return false;
 };
+const hasPreambleSlopSignal = (block) => {
+	const joined = block.prose.join(" ");
+	for (const l of block.prose) {
+		if (EXPLANATORY_OPENERS.test(l)) return true;
+		if (JUSTIFICATION_OPENERS.some((re) => re.test(l))) return true;
+	}
+	return CROSS_REFERENCE_PHRASES.some((re) => re.test(joined));
+};
 const detectNarrativeInBlock = (block, ext) => {
 	if (looksLikeLicenseHeader(block)) return {
 		matched: false,
@@ -2523,9 +2534,13 @@ const detectNarrativeInBlock = (block, ext) => {
 		matched: false,
 		reason: ""
 	};
-	if (block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext)) return {
+	if (block.kind === "line" && block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext)) return {
+		matched: true,
+		reason: "multi-line preamble before declaration"
+	};
+	if (block.kind === "jsdoc" && block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext) && hasPreambleSlopSignal(block)) return {
 		matched: true,
-		reason: block.kind === "jsdoc" ? "JSDoc preamble before declaration" : "multi-line preamble before declaration"
+		reason: "JSDoc preamble with slop signal"
 	};
 	if (CROSS_REFERENCE_PHRASES.some((re) => re.test(joined))) return {
 		matched: true,
@@ -2565,7 +2580,7 @@ const detectNarrativeComments = async (context) => {
 		const syntax = getCommentSyntax(ext);
 		if (!syntax) continue;
 		const relativePath = path.relative(context.rootDirectory, filePath);
-		if (NON_PRODUCTION_DIR_PATTERN.test(relativePath)) continue;
+		if (isNonProductionPath(relativePath)) continue;
 		let content;
 		try {
 			content = fs.readFileSync(filePath, "utf-8");
@@ -6361,7 +6376,7 @@ const scanCommand = async (directory, config, options) => {
 		});
 	}
 	if (options.json) {
-		const { buildJsonOutput } = await import("./json-7EtVVIhd.js");
+		const { buildJsonOutput } = await import("./json-DxLkV8n2.js");
 		const jsonOut = buildJsonOutput(results, scoreResult, projectInfo.sourceFileCount, elapsedMs);
 		console.log(JSON.stringify(jsonOut, null, 2));
 		return { exitCode };
@@ -7361,13 +7376,77 @@ const fixDependencyAudit = async (context, onProgress) => {
 	}
 	onProgress?.("Dependency audit fixes · skipping (pnpm audit unavailable and no package-lock.json for npm fallback)");
 };
+const SEMVER_PREFIX_RE = /^[~^]?/;
+const parseSemverMin = (spec) => {
+	const match = spec.replace(SEMVER_PREFIX_RE, "").match(/^(\d+|x|X|\*)(?:\.(\d+|x|X|\*))?(?:\.(\d+|x|X|\*))?/);
+	if (!match) return null;
+	const head = match[1];
+	if (!/^\d+$/.test(head)) return null;
+	const toNum = (part) => {
+		if (!part) return 0;
+		return /^\d+$/.test(part) ? Number(part) : 0;
+	};
+	return [
+		Number(head),
+		toNum(match[2]),
+		toNum(match[3])
+	];
+};
+const isDowngrade = (oldSpec, newSpec) => {
+	const oldV = parseSemverMin(oldSpec);
+	const newV = parseSemverMin(newSpec);
+	if (!oldV || !newV) return false;
+	for (let i = 0; i < 3; i++) {
+		if ((newV[i] ?? 0) < (oldV[i] ?? 0)) return true;
+		if ((newV[i] ?? 0) > (oldV[i] ?? 0)) return false;
+	}
+	return false;
+};
+const DEP_BUCKETS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+const snapshotPackageVersions = (pkg) => {
+	const map = /* @__PURE__ */ new Map();
+	for (const bucket of DEP_BUCKETS) {
+		const deps = pkg[bucket];
+		if (!deps || typeof deps !== "object") continue;
+		for (const [name, version] of Object.entries(deps)) if (typeof version === "string") map.set(`${bucket}:${name}`, version);
+	}
+	return map;
+};
+const revertDowngrades = (rootDir, before) => {
+	const pkgPath = path.join(rootDir, "package.json");
+	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	const reverted = [];
+	for (const bucket of DEP_BUCKETS) {
+		const deps = pkg[bucket];
+		if (!deps) continue;
+		for (const [name, version] of Object.entries(deps)) {
+			const prior = before.get(`${bucket}:${name}`);
+			if (!prior) continue;
+			if (isDowngrade(prior, version)) {
+				deps[name] = prior;
+				reverted.push(`${name} ${version} → ${prior}`);
+			}
+		}
+	}
+	if (reverted.length > 0) fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+	return reverted;
+};
 const runNpmAuditFix = async (rootDir, onProgress) => {
+	const pkgPath = path.join(rootDir, "package.json");
+	const before = snapshotPackageVersions(JSON.parse(fs.readFileSync(pkgPath, "utf-8")));
 	onProgress?.("Dependency audit fixes · running npm audit fix (can take a few minutes)");
 	const result = await runSubprocess("npm", ["audit", "fix"], {
 		cwd: rootDir,
 		timeout: INSTALL_TIMEOUT
 	});
 	if (result.exitCode !== 0 && !result.stdout && !result.stderr) throw new Error("npm audit fix failed");
+	const reverted = revertDowngrades(rootDir, before);
+	if (reverted.length > 0) onProgress?.(`Dependency audit fixes · reverted ${reverted.length} downgrade(s): ${reverted.join(", ")}`);
 	onProgress?.("Dependency audit fixes · running npm install");
 	const installResult = await runSubprocess("npm", ["install"], {
 		cwd: rootDir,

package/dist/{json-7EtVVIhd.js → json-DxLkV8n2.js}

@@ -1,4 +1,4 @@
-import { n as ENGINE_INFO, t as APP_VERSION } from "./version-B7_FRirI.js";
+import { n as ENGINE_INFO, t as APP_VERSION } from "./version-G3ekYjY1.js";
 
 //#region src/output/json.ts
 const buildJsonOutput = (results, scoreResult, fileCount, elapsedMs) => {

package/dist/mcp.js

@@ -531,9 +531,14 @@ const detectOverAbstraction = async (context) => {
 	return diagnostics;
 };
 
+//#endregion
+//#region src/engines/ai-slop/non-production-paths.ts
+const DIR_PATTERN = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3|cli|cli-[\w-]+|[\w-]+-cli)\//i;
+const BASENAME_PATTERN = /(?:^|\/)(?:benchmark|bench|demo|example|script|seed|migrate|profile|smoke|stress|load|debug|repro)[-_.][^/]*\.[mc]?[jt]sx?$|(?:^|\/)[^/]+[-_](?:benchmark|bench|demo|example)\.[mc]?[jt]sx?$/i;
+const isNonProductionPath = (relativePath) => DIR_PATTERN.test(relativePath) || BASENAME_PATTERN.test(relativePath);
+
 //#endregion
 //#region src/engines/ai-slop/comments.ts
-const NON_PRODUCTION_DIR_PATTERN$2 = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3)\//i;
 const TRIVIAL_VERB_STEMS = "Import|Defin|Initializ|Setting|Set\\s+up|Setup|Return|Check|Loop|Iterat|Creat|Updat|Delet|Remov|Handl|Get|Fetch|Increment|Decrement|Writ|Runn|Run|Pars|Execut|Extract|Sav|Load|Build|Start|Stopp|Stop|Clean(?:up|\\s+up)?|Configur|Validat|Process|Queue|Fire|Emit|Dispatch|Log|Print|Render";
 const TRIVIAL_JS_COMMENT_PATTERNS = [/\/\/\s*This (?:function|method|class|variable|constant) (?:will |is used to |is responsible for )?/i, new RegExp(`\\/\\/\\s*(?:${TRIVIAL_VERB_STEMS})(?:e|es|ing|s)?\\b`, "i")];
 const TRIVIAL_PYTHON_COMMENT_PATTERNS = [/^#\s*This (?:function|method|class) (?:will |is used to )?/i, new RegExp(`^#\\s*(?:${TRIVIAL_VERB_STEMS})(?:e|es|ing|s)?\\b`, "i")];
@@ -590,7 +595,7 @@ const detectTrivialComments = async (context) => {
 	for (const filePath of files) {
 		if (isAutoGenerated(filePath)) continue;
 		const relativePath = path.relative(context.rootDirectory, filePath);
-		if (NON_PRODUCTION_DIR_PATTERN$2.test(relativePath)) continue;
+		if (isNonProductionPath(relativePath)) continue;
 		let content;
 		try {
 			content = fs.readFileSync(filePath, "utf-8");
@@ -626,11 +631,10 @@ const slop = (filePath, line, rule, severity, message, help, fixable) => ({
 	fixable
 });
 const LOGGER_FILE_PATTERN = /(?:^|\/)(?:logger|logging|log)\.[^/]+$/i;
-const NON_PRODUCTION_DIR_PATTERN$1 = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|cli|cli-[\w-]+|[\w-]+-cli)\//;
 const detectConsoleLeftovers = (content, relativePath, ext) => {
 	if (!JS_EXTENSIONS$3.has(ext)) return [];
 	if (LOGGER_FILE_PATTERN.test(relativePath)) return [];
-	if (NON_PRODUCTION_DIR_PATTERN$1.test(relativePath)) return [];
+	if (isNonProductionPath(relativePath)) return [];
 	const diagnostics = [];
 	const lines = content.split("\n");
 	for (let i = 0; i < lines.length; i++) {
@@ -680,7 +684,7 @@ const asAnyPattern = new RegExp(`\\bas\\s+any\\b`);
 const doubleAssertPattern = new RegExp(`\\bas\\s+unknown\\s+as\\s+`);
 const detectUnsafeTypePatterns = (content, relativePath, ext) => {
 	if (ext !== ".ts" && ext !== ".tsx") return [];
-	if (NON_PRODUCTION_DIR_PATTERN$1.test(relativePath)) return [];
+	if (isNonProductionPath(relativePath)) return [];
 	const diagnostics = [];
 	const lines = content.split("\n");
 	for (let i = 0; i < lines.length; i++) {
@@ -1585,7 +1589,6 @@ const PHP_DECL_START = /^\s*(?:public|private|protected|static|final|abstract|re
 
 //#endregion
 //#region src/engines/ai-slop/narrative-comments.ts
-const NON_PRODUCTION_DIR_PATTERN = /(?:^|\/)(?:scripts|bin|examples?|demos?|bench|benches|benchmarks?|fixtures?|__fixtures__|__mocks__|__tests__|vendor|_vendor|vendored|third_party|blib2to3|lib2to3)\//i;
 const stripJsdocLine = (line) => line.replace(/^\s*\/\*\*+\s?/, "").replace(/\s*\*+\/\s*$/, "").replace(/^\s*\*\s?/, "").trim();
 const stripLineComment = (line) => line.replace(/^\s*(?:(?:\/\/)|#)\s?/, "");
 const getCommentSyntax = (ext) => {
@@ -1736,13 +1739,21 @@ const looksLikeGoDocComment = (block, ext) => {
 	if (!declMatch) return false;
 	return ((block.prose.find((l) => l.length > 0) ?? "").split(/\s+/)[0] ?? "") === declMatch[1];
 };
-const DOC_INDICATOR_RE = /`[^`]+`|\|\s*[-:]+\s*\||```|\b(?:note|warning|warn|caveat|example|caution|see):/i;
+const DOC_INDICATOR_RE = /`[^`]+`|\|\s*[-:]+\s*\||```|\b(?:note|warning|warn|caveat|example|caution|see):|\(e\.g\.[^)]+\)|\(i\.e\.[^)]+\)/i;
 const hasDocIndicator = (block) => {
 	const joined = block.prose.join(" ");
 	if (DOC_INDICATOR_RE.test(joined)) return true;
 	for (const l of block.prose) if (/^[-]\s/.test(l)) return true;
 	return false;
 };
+const hasPreambleSlopSignal = (block) => {
+	const joined = block.prose.join(" ");
+	for (const l of block.prose) {
+		if (EXPLANATORY_OPENERS.test(l)) return true;
+		if (JUSTIFICATION_OPENERS.some((re) => re.test(l))) return true;
+	}
+	return CROSS_REFERENCE_PHRASES.some((re) => re.test(joined));
+};
 const detectNarrativeInBlock = (block, ext) => {
 	if (looksLikeLicenseHeader(block)) return {
 		matched: false,
@@ -1782,9 +1793,13 @@ const detectNarrativeInBlock = (block, ext) => {
 		matched: false,
 		reason: ""
 	};
-	if (block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext)) return {
+	if (block.kind === "line" && block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext)) return {
+		matched: true,
+		reason: "multi-line preamble before declaration"
+	};
+	if (block.kind === "jsdoc" && block.prose.length >= 3 && looksLikeDeclarationPreamble(block.nextNonBlankLine, ext) && hasPreambleSlopSignal(block)) return {
 		matched: true,
-		reason: block.kind === "jsdoc" ? "JSDoc preamble before declaration" : "multi-line preamble before declaration"
+		reason: "JSDoc preamble with slop signal"
 	};
 	if (CROSS_REFERENCE_PHRASES.some((re) => re.test(joined))) return {
 		matched: true,
@@ -1824,7 +1839,7 @@ const detectNarrativeComments = async (context) => {
 		const syntax = getCommentSyntax(ext);
 		if (!syntax) continue;
 		const relativePath = path.relative(context.rootDirectory, filePath);
-		if (NON_PRODUCTION_DIR_PATTERN.test(relativePath)) continue;
+		if (isNonProductionPath(relativePath)) continue;
 		let content;
 		try {
 			content = fs.readFileSync(filePath, "utf-8");
@@ -5056,7 +5071,7 @@ const handleAislopBaseline = (input) => {
 
 //#endregion
 //#region src/version.ts
-const APP_VERSION = "0.8.1";
+const APP_VERSION = "0.8.2";
 
 //#endregion
 //#region src/mcp.ts

package/dist/{version-B7_FRirI.js → version-G3ekYjY1.js}

@@ -29,7 +29,7 @@ const getEngineLabel = (engine) => ENGINE_INFO[engine].label;
 
 //#endregion
 //#region src/version.ts
-const APP_VERSION = "0.8.1";
+const APP_VERSION = "0.8.2";
 
 //#endregion
 export { ENGINE_INFO as n, getEngineLabel as r, APP_VERSION as t };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aislop",
-	"version": "0.8.1",
+	"version": "0.8.2",
 	"description": "The engineering standards layer and quality gate for AI-written code. Define your standard once. Every agent — Claude Code, Cursor, Codex — is held to it automatically, on every edit and every PR. Catches the slop they leave behind, enforces the rules your team sets. 8+ languages. Deterministic.",
 	"type": "module",
 	"bin": {