aislop 0.3.2 → 0.4.0

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { Command } from "commander";
+import fs from "node:fs";
 import path from "node:path";
 import { performance } from "node:perf_hooks";
-import fs from "node:fs";
 import YAML from "yaml";
 import { z } from "zod/v4";
 import { spawn, spawnSync } from "node:child_process";
@@ -257,7 +257,9 @@ const loadConfig = (directory) => {
 	try {
 		const raw = fs.readFileSync(configPath, "utf-8");
 		return parseConfig(YAML.parse(raw));
-	} catch {
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		process.stderr.write(`  ⚠ Failed to parse ${configPath}: ${msg}\n  ⚠ Using default configuration.\n`);
 		return DEFAULT_CONFIG;
 	}
 };
@@ -406,15 +408,19 @@ const filterExplicitFiles = (rootDirectory, files, extraExtensions = []) => {
 	}).filter(({ relativePath }) => isWithinProject(relativePath) && hasAllowedExtension(relativePath, extraSet)).map(({ absolutePath }) => absolutePath);
 };
 const isAutoGenerated = (filePath) => {
+	let fd;
 	try {
-		const fd = fs.openSync(filePath, "r");
+		fd = fs.openSync(filePath, "r");
 		const buf = Buffer.alloc(512);
 		const bytesRead = fs.readSync(fd, buf, 0, 512, 0);
-		fs.closeSync(fd);
 		const header = buf.toString("utf-8", 0, bytesRead);
 		return AUTO_GENERATED_PATTERNS.some((pattern) => pattern.test(header));
 	} catch {
 		return false;
+	} finally {
+		if (fd !== void 0) try {
+			fs.closeSync(fd);
+		} catch {}
 	}
 };
 const getSourceFilesForRoot = (rootDirectory) => filterProjectFiles(rootDirectory, listProjectFiles(rootDirectory));
@@ -651,7 +657,11 @@ const TODO_PATTERN = new RegExp(`\\b(?:${[
 	"FIXME",
 	"HACK",
 	"XXX"
-].join("|")}|TEMP|PLACEHOLDER|STUB)\\b[:\\s]`, "i");
+].join("|")})\\b[:\\s]|\\b(?:${[
+	"TEMP",
+	"PLACEHOLDER",
+	"STUB"
+].join("|")})[:\\s]`);
 const detectTodoStubs = (content, relativePath) => {
 	const diagnostics = [];
 	const lines = content.split("\n");
@@ -753,18 +763,20 @@ const detectUnsafeTypePatterns = (content, relativePath, ext) => {
 			category: "AI Slop",
 			fixable: false
 		});
-		if (doubleAssertPattern.test(trimmed)) diagnostics.push({
-			filePath: relativePath,
-			engine: "ai-slop",
-			rule: "ai-slop/double-type-assertion",
-			severity: "warning",
-			message: `Double type assertion (as unknown as X) bypasses type checking`,
-			help: "Refactor to avoid needing a double assertion — it usually indicates a design issue",
-			line: i + 1,
-			column: 0,
-			category: "AI Slop",
-			fixable: false
-		});
+		if (doubleAssertPattern.test(trimmed)) {
+			if (!(/\.query[(<]/.test(trimmed) || /result\[0\]/.test(trimmed) || /rows\s/.test(trimmed))) diagnostics.push({
+				filePath: relativePath,
+				engine: "ai-slop",
+				rule: "ai-slop/double-type-assertion",
+				severity: "warning",
+				message: `Double type assertion (as unknown as X) bypasses type checking`,
+				help: "Refactor to avoid needing a double assertion. If this is an ORM query return, consider a typed wrapper function",
+				line: i + 1,
+				column: 0,
+				category: "AI Slop",
+				fixable: false
+			});
+		}
 	}
 	return diagnostics;
 };
@@ -1541,82 +1553,6 @@ const checkComplexity = async (context) => {
 	return diagnostics;
 };
 
-//#endregion
-//#region src/engines/code-quality/duplication.ts
-const MIN_DUPLICATE_LINES = 12;
-const MIN_DUPLICATE_CHARS = 240;
-const MAX_DUPLICATE_REPORTS = 50;
-const isIgnorableLine = (line) => {
-	const trimmed = line.trim();
-	return trimmed.length === 0 || trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*") || trimmed.startsWith("#");
-};
-const normalizeLine = (line) => line.trim().replace(/\s+/g, " ");
-const extractDuplicateBlocks = (content) => {
-	const blocks = [];
-	const lines = content.split("\n");
-	for (let i = 0; i <= lines.length - MIN_DUPLICATE_LINES; i++) {
-		const segment = lines.slice(i, i + MIN_DUPLICATE_LINES);
-		if (segment.some(isIgnorableLine)) continue;
-		const key = segment.map(normalizeLine).join("\n");
-		if (key.length < MIN_DUPLICATE_CHARS) continue;
-		blocks.push({
-			key,
-			startLine: i + 1
-		});
-	}
-	return blocks;
-};
-const checkDuplication = async (context) => {
-	const files = getSourceFiles(context);
-	const duplicates = /* @__PURE__ */ new Map();
-	for (const absoluteFilePath of files) {
-		if (isAutoGenerated(absoluteFilePath)) continue;
-		let content = "";
-		try {
-			content = fs.readFileSync(absoluteFilePath, "utf-8");
-		} catch {
-			continue;
-		}
-		const relativeFilePath = path.relative(context.rootDirectory, absoluteFilePath);
-		for (const block of extractDuplicateBlocks(content)) {
-			const occurrence = {
-				filePath: relativeFilePath,
-				startLine: block.startLine
-			};
-			const list = duplicates.get(block.key) ?? [];
-			list.push(occurrence);
-			duplicates.set(block.key, list);
-		}
-	}
-	const diagnostics = [];
-	const reportedPairs = /* @__PURE__ */ new Set();
-	for (const occurrences of duplicates.values()) {
-		if (occurrences.length < 2) continue;
-		const source = occurrences[0];
-		for (const occurrence of occurrences.slice(1)) {
-			if (diagnostics.length >= MAX_DUPLICATE_REPORTS) return diagnostics;
-			if (occurrence.filePath === source.filePath && occurrence.startLine === source.startLine) continue;
-			if (occurrence.filePath === source.filePath) continue;
-			const pairKey = `${source.filePath}->${occurrence.filePath}`;
-			if (reportedPairs.has(pairKey)) continue;
-			reportedPairs.add(pairKey);
-			diagnostics.push({
-				filePath: occurrence.filePath,
-				engine: "code-quality",
-				rule: "duplication/block",
-				severity: "warning",
-				message: `Possible duplicated code block (${MIN_DUPLICATE_LINES}+ lines) also found at ${source.filePath}:${source.startLine}`,
-				help: "Extract shared logic into a reusable function or module",
-				line: occurrence.startLine,
-				column: 0,
-				category: "Duplication",
-				fixable: false
-			});
-		}
-	}
-	return diagnostics;
-};
-
 //#endregion
 //#region src/utils/subprocess.ts
 const runSubprocess = (command, args, options = {}) => {
@@ -1731,7 +1667,7 @@ const collectIssues = (fileIssue, issueType, rootDir, knipCwd) => {
 	return diagnostics;
 };
 const findMonorepoRoot = (directory) => {
-	let current = path.dirname(directory);
+	let current = directory;
 	while (current !== path.dirname(current)) {
 		if (fs.existsSync(path.join(current, "pnpm-workspace.yaml")) || (() => {
 			const pkgPath = path.join(current, "package.json");
@@ -1791,6 +1727,16 @@ const fixUnusedDependencies = async (rootDirectory) => {
 	}
 	if (changed) fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, "	")}\n`);
 };
+const runKnipUnusedFiles = async (rootDirectory) => {
+	return (await runKnip(rootDirectory)).filter((d) => d.rule === "knip/files");
+};
+const fixUnusedFiles = async (rootDirectory) => {
+	const diagnostics = await runKnipUnusedFiles(rootDirectory);
+	for (const d of diagnostics) {
+		const absolutePath = path.resolve(rootDirectory, d.filePath);
+		if (fs.existsSync(absolutePath)) fs.unlinkSync(absolutePath);
+	}
+};
 const runKnip = async (rootDirectory) => {
 	const knipRuntime = findKnipBin(rootDirectory, findMonorepoRoot(rootDirectory));
 	if (!knipRuntime) return [];
@@ -1804,7 +1750,7 @@ const runKnip = async (rootDirectory) => {
 		];
 		const result = await runSubprocess(process.execPath, args, {
 			cwd: knipRuntime.cwd,
-			timeout: 2e4,
+			timeout: 6e4,
 			env: { FORCE_COLOR: "0" }
 		});
 		if (!result.stdout) return [];
@@ -1846,7 +1792,6 @@ const codeQualityEngine = {
 		const promises = [];
 		if (context.languages.includes("typescript") || context.languages.includes("javascript")) promises.push(runKnip(context.rootDirectory));
 		promises.push(checkComplexity(context));
-		promises.push(checkDuplication(context));
 		const results = await Promise.allSettled(promises);
 		for (const result of results) if (result.status === "fulfilled") diagnostics.push(...result.value);
 		return {
@@ -1888,6 +1833,24 @@ const BIOME_EXTENSIONS = new Set([
 	".mjs",
 	".cjs"
 ]);
+const projectHasBiomeConfig = (rootDir) => {
+	try {
+		const biomePath = path.join(rootDir, "biome.json");
+		return fs.existsSync(biomePath);
+	} catch {
+		return false;
+	}
+};
+const getBiomeLineWidth = (rootDir) => {
+	try {
+		const biomePath = path.join(rootDir, "biome.json");
+		if (!fs.existsSync(biomePath)) return 120;
+		const content = fs.readFileSync(biomePath, "utf-8");
+		return JSON.parse(content).formatter?.lineWidth ?? 120;
+	} catch {
+		return 120;
+	}
+};
 const getBiomeTargets = (context) => getSourceFiles(context).filter((filePath) => BIOME_EXTENSIONS.has(path.extname(filePath))).map((filePath) => path.relative(context.rootDirectory, filePath));
 const projectUsesDecorators = (rootDir) => {
 	try {
@@ -1902,9 +1865,11 @@ const projectUsesDecorators = (rootDir) => {
 const runBiomeFormat = async (context) => {
 	const targets = getBiomeTargets(context);
 	if (targets.length === 0) return [];
+	if (!projectHasBiomeConfig(context.rootDirectory)) return [];
 	const args = [
 		"format",
 		"--reporter=json",
+		`--line-width=${getBiomeLineWidth(context.rootDirectory)}`,
 		...targets
 	];
 	try {
@@ -1936,7 +1901,7 @@ const parseBiomeJsonOutput = (output, rootDir) => {
 		for (const entry of parsed.diagnostics) {
 			const rawPath = entry.location?.path;
 			if (!rawPath) continue;
-			const severity = entry.severity === "error" ? "error" : "warning";
+			const severity = "warning";
 			const rawMessage = entry.message ?? "";
 			const message = !rawMessage || rawMessage.toLowerCase().includes("would have printed") ? "File is not formatted correctly" : rawMessage;
 			diagnostics.push({
@@ -1961,6 +1926,7 @@ const fixBiomeFormat = async (context) => {
 	await runBiome([
 		"format",
 		"--write",
+		`--line-width=${getBiomeLineWidth(context.rootDirectory)}`,
 		...targets
 	], context.rootDirectory, 6e4);
 };
@@ -2438,12 +2404,12 @@ const resolveOxlintBinary = () => {
 };
 const parseRuleCode = (code) => {
 	if (!code) return {
-		plugin: "unknown",
-		rule: "unknown"
+		plugin: "eslint",
+		rule: "syntax-error"
 	};
 	const match = code.match(/^(.+)\((.+)\)$/);
 	if (!match) return {
-		plugin: "unknown",
+		plugin: "eslint",
 		rule: code
 	};
 	return {
@@ -2633,6 +2599,7 @@ const runOxlint = async (context) => {
 		} catch {
 			return [];
 		}
+		const seen = /* @__PURE__ */ new Set();
 		return output.diagnostics.map((d) => {
 			const { plugin, rule } = parseRuleCode(d.code);
 			const label = d.labels[0];
@@ -2648,6 +2615,11 @@ const runOxlint = async (context) => {
 				category: plugin === "react" ? "React" : plugin === "import" ? "Imports" : "Lint",
 				fixable: false
 			};
+		}).filter((d) => {
+			const key = `${d.filePath}:${d.line}:${d.rule}:${d.message}`;
+			if (seen.has(key)) return false;
+			seen.add(key);
+			return true;
 		});
 	} finally {
 		if (fs.existsSync(configPath)) fs.unlinkSync(configPath);
@@ -2774,7 +2746,7 @@ const runDependencyAudit = async (context) => {
 	const timeout = context.config.security.auditTimeout;
 	const promises = [];
 	if (context.languages.includes("typescript") || context.languages.includes("javascript")) {
-		if (fs.existsSync(path.join(context.rootDirectory, "pnpm-lock.yaml"))) promises.push(runPnpmAudit(context.rootDirectory, timeout));
+		if (fs.existsSync(path.join(context.rootDirectory, "pnpm-lock.yaml"))) promises.push(runPnpmAuditWithFallback(context.rootDirectory, timeout));
 		else if (fs.existsSync(path.join(context.rootDirectory, "package-lock.json")) || fs.existsSync(path.join(context.rootDirectory, "package.json"))) promises.push(runNpmAudit(context.rootDirectory, timeout));
 	}
 	if (context.languages.includes("python") && context.installedTools["pip-audit"]) promises.push(runPipAudit(context.rootDirectory, timeout));
@@ -2794,13 +2766,20 @@ const runNpmAudit = async (rootDir, timeout) => {
 		return [];
 	}
 };
-const runPnpmAudit = async (rootDir, timeout) => {
+const runPnpmAuditWithFallback = async (rootDir, timeout) => {
+	const canFallbackToNpm = fs.existsSync(path.join(rootDir, "package-lock.json"));
 	try {
-		return parseJsAudit((await runSubprocess("pnpm", ["audit", "--json"], {
+		const diagnostics = parseJsAudit((await runSubprocess("pnpm", ["audit", "--json"], {
 			cwd: rootDir,
 			timeout
 		})).stdout, "pnpm audit");
+		if (diagnostics.some((d) => d.rule === "security/dependency-audit-skipped")) {
+			if (canFallbackToNpm) return runNpmAudit(rootDir, timeout);
+			return [];
+		}
+		return diagnostics;
 	} catch {
+		if (canFallbackToNpm) return runNpmAudit(rootDir, timeout);
 		return [];
 	}
 };
@@ -2832,8 +2811,10 @@ const parseModernVulnerabilities = (vulnerabilities, source) => {
 	for (const [packageName, vulnerability] of Object.entries(vulnerabilities)) {
 		const severity = (vulnerability.severity ?? "moderate").toLowerCase();
 		const fixAvailable = vulnerability.fixAvailable;
+		const isDirect = vulnerability.isDirect === true;
 		let recommendation = `Run \`${defaultAuditFixCommand(source)}\` to resolve`;
-		if (fixAvailable === false) recommendation = "No automatic fix available.";
+		if (fixAvailable === false) recommendation = isDirect ? "No automatic fix available — check for a newer major version or an alternative package." : "Transitive vulnerability with no fix. Add an override in package.json or upgrade the parent dependency.";
+		else if (!isDirect && fixAvailable === true) recommendation = `Transitive dep — \`${defaultAuditFixCommand(source)}\` may not resolve this. If it persists, add an override in package.json or upgrade the parent package that depends on ${packageName}.`;
 		else if (fixAvailable && typeof fixAvailable === "object" && "name" in fixAvailable && "version" in fixAvailable) {
 			const target = fixAvailable;
 			if (target.name && target.version) recommendation = `Upgrade to ${target.name}@${target.version}.`;
@@ -3376,7 +3357,7 @@ const logger = {
 * Application version — injected at build time by tsdown from package.json.
 * The fallback should always match the "version" field in package.json.
 */
-const APP_VERSION = "0.3.2";
+const APP_VERSION = "0.4.0";
 
 //#endregion
 //#region src/output/layout.ts
@@ -3615,7 +3596,7 @@ const renderSummary = (diagnostics, scoreResult, elapsedMs, fileCount, threshold
 	const warningCount = diagnostics.filter((d) => d.severity === "warning").length;
 	const fixableCount = diagnostics.filter((d) => d.fixable).length;
 	const elapsed = toElapsedLabel(elapsedMs);
-	return `${[
+	const lines = [
 		highlighter.dim("------------------------------------------------------------"),
 		highlighter.bold("Summary"),
 		`  Score: ${colorByScore(`${scoreResult.score}/${PERFECT_SCORE}`, scoreResult.score, thresholds)} ${colorByScore(`(${scoreResult.label})`, scoreResult.score, thresholds)}`,
@@ -3624,7 +3605,15 @@ const renderSummary = (diagnostics, scoreResult, elapsedMs, fileCount, threshold
 		`  Files: ${highlighter.info(String(fileCount))}`,
 		`  Time: ${highlighter.info(elapsed)}`,
 		highlighter.dim("------------------------------------------------------------")
-	].join("\n")}\n`;
+	];
+	if (errorCount + warningCount > 0) {
+		lines.push("");
+		lines.push(highlighter.bold("Next steps"));
+		if (fixableCount > 0) lines.push(`  ${highlighter.info("→")} Run ${highlighter.info("fix")} to auto-fix ${fixableCount} issue${fixableCount === 1 ? "" : "s"}`);
+		lines.push(`  ${highlighter.info("→")} Run ${highlighter.info("fix -f")} to apply all available fixes (includes dependency audit)`);
+		lines.push(`  ${highlighter.dim("→")} Run ${highlighter.dim("fix --<agent>")} to hand off to a coding agent (see ${highlighter.dim("fix --help")} for supported agents)`);
+	}
+	return `${lines.join("\n")}\n`;
 };
 const printEngineStatus = (result) => {
 	const label = getEngineLabel(result.engine);
@@ -3929,6 +3918,18 @@ const ALL_ENGINE_NAMES = Object.keys(ENGINE_INFO);
 const scanCommand = async (directory, config, options) => {
 	const startTime = performance.now();
 	const resolvedDir = path.resolve(directory);
+	if (!fs.existsSync(resolvedDir)) {
+		const msg = `Path does not exist: ${resolvedDir}`;
+		if (options.json) console.log(JSON.stringify({ error: msg }, null, 2));
+		else logger.error(`  ${msg}`);
+		return { exitCode: 1 };
+	}
+	if (!fs.statSync(resolvedDir).isDirectory()) {
+		const msg = `Not a directory: ${resolvedDir}`;
+		if (options.json) console.log(JSON.stringify({ error: msg }, null, 2));
+		else logger.error(`  ${msg}`);
+		return { exitCode: 1 };
+	}
 	const showHeader = options.showHeader !== false;
 	const useLiveProgress = !options.json && shouldUseSpinner();
 	if (!options.json && showHeader) printCommandHeader("Scan");
@@ -4161,10 +4162,55 @@ const doctorCommand = async (directory) => {
 //#endregion
 //#region src/engines/ai-slop/dead-patterns-fix.ts
 /**
+* Given a starting line that contains an opening `(`, find all lines
+* through the matching `)`. Returns the set of 1-based line numbers.
+*/
+const findStatementSpan = (lines, startIndex) => {
+	const span = /* @__PURE__ */ new Set();
+	let depth = 0;
+	let started = false;
+	for (let i = startIndex; i < lines.length; i++) {
+		const line = lines[i];
+		span.add(i + 1);
+		for (const ch of line) if (ch === "(") {
+			depth++;
+			started = true;
+		} else if (ch === ")") depth--;
+		if (started && depth <= 0) break;
+	}
+	return span;
+};
+/**
+* Patterns that indicate a console.log is communicating an error or important
+* status to the user — should be upgraded to console.error, not removed.
+*/
+const ERROR_MESSAGE_PATTERNS = [
+	/\b(?:error|err|fail|failed|failure|fatal|crash|exception)\b/i,
+	/\b(?:not found|missing|invalid|unable|cannot|couldn'?t|won'?t)\b/i,
+	/\b(?:denied|unauthorized|forbidden|refused|rejected|timeout|timed?\s*out)\b/i,
+	/\bno\s+(?:\w+\s+)*found\b/i,
+	/\bprocess\.exit\b/
+];
+/**
+* Extracts the full text of a console statement spanning multiple lines.
+*/
+const getStatementText = (lines, startIndex, span) => {
+	const spanLines = [];
+	for (const lineNo of span) spanLines.push(lines[lineNo - 1]);
+	return spanLines.join("\n");
+};
+/**
+* Determine if a console.log should be replaced with console.error
+* rather than removed entirely.
+*/
+const shouldUpgradeToError = (statementText) => {
+	return ERROR_MESSAGE_PATTERNS.some((pattern) => pattern.test(statementText));
+};
+/**
 * Removes lines flagged as fixable by the trivial-comment and dead-pattern detectors.
-* Specifically handles:
-*   - ai-slop/trivial-comment  (trivial comments that restate the code)
-*   - ai-slop/console-leftover (console.log/debug/info left in production)
+*   - ai-slop/trivial-comment  → remove the line
+*   - ai-slop/console-leftover → remove the entire statement (multi-line safe),
+*     OR replace with console.error if the message indicates an error/failure
 */
 const fixDeadPatterns = async (context) => {
 	const fixable = [...await detectTrivialComments(context), ...await detectDeadPatterns(context)].filter((d) => d.fixable);
@@ -4172,26 +4218,48 @@ const fixDeadPatterns = async (context) => {
 	const byFile = /* @__PURE__ */ new Map();
 	for (const d of fixable) {
 		const absolute = path.isAbsolute(d.filePath) ? d.filePath : path.join(context.rootDirectory, d.filePath);
-		const lines = byFile.get(absolute) ?? /* @__PURE__ */ new Set();
-		lines.add(d.line);
-		byFile.set(absolute, lines);
+		const entries = byFile.get(absolute) ?? [];
+		entries.push({
+			line: d.line,
+			rule: d.rule
+		});
+		byFile.set(absolute, entries);
 	}
-	for (const [filePath, lineNumbers] of byFile) {
-		if (!fs.existsSync(filePath)) continue;
-		const lines = fs.readFileSync(filePath, "utf-8").split("\n");
-		const filtered = [];
-		for (let i = 0; i < lines.length; i++) {
-			const lineNo = i + 1;
-			if (lineNumbers.has(lineNo)) continue;
-			filtered.push(lines[i]);
-		}
-		const collapsed = [];
-		for (const line of filtered) {
-			if (line.trim() === "" && collapsed.length > 0 && collapsed[collapsed.length - 1].trim() === "") continue;
-			collapsed.push(line);
-		}
-		fs.writeFileSync(filePath, collapsed.join("\n"));
+	for (const [filePath, entries] of byFile) fixFileDeadPatterns(filePath, entries);
+};
+const fixFileDeadPatterns = (filePath, entries) => {
+	if (!fs.existsSync(filePath)) return;
+	const lines = fs.readFileSync(filePath, "utf-8").split("\n");
+	const linesToRemove = /* @__PURE__ */ new Set();
+	const lineReplacements = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		const index = entry.line - 1;
+		if (index < 0 || index >= lines.length) continue;
+		if (entry.rule === "ai-slop/console-leftover") {
+			const span = findStatementSpan(lines, index);
+			if (shouldUpgradeToError(getStatementText(lines, index, span))) {
+				const replaced = lines[index].replace(/console\.(?:log|debug|info|trace|dir|table)\s*\(/, "console.error(");
+				lineReplacements.set(entry.line, replaced);
+			} else for (const lineNo of span) linesToRemove.add(lineNo);
+		} else linesToRemove.add(entry.line);
+	}
+	const result = applyEditsAndCollapse(lines, linesToRemove, lineReplacements);
+	fs.writeFileSync(filePath, result);
+};
+const applyEditsAndCollapse = (lines, linesToRemove, lineReplacements) => {
+	const result = [];
+	for (let i = 0; i < lines.length; i++) {
+		const lineNo = i + 1;
+		if (linesToRemove.has(lineNo)) continue;
+		result.push(lineReplacements.get(lineNo) ?? lines[i]);
 	}
+	const collapsed = [];
+	for (const line of result) {
+		const prevEmpty = collapsed.length > 0 && collapsed[collapsed.length - 1].trim() === "";
+		if (line.trim() === "" && prevEmpty) continue;
+		collapsed.push(line);
+	}
+	return collapsed.join("\n");
 };
 
 //#endregion
@@ -4440,7 +4508,7 @@ const getStepSummary = (result) => {
 	if (result.beforeIssues === 0) return `0 issues, ${formatElapsed(result.elapsedMs)}`;
 	if (result.afterIssues === 0) return `${result.resolvedIssues} resolved, ${formatElapsed(result.elapsedMs)}`;
 	if (result.resolvedIssues > 0) return `${result.resolvedIssues} resolved, ${result.afterIssues} remaining, ${formatElapsed(result.elapsedMs)}`;
-	return `no changes, ${result.afterIssues} issue${result.afterIssues === 1 ? "" : "s"}, ${formatElapsed(result.elapsedMs)}`;
+	return `no changes, ${result.afterIssues} issue${result.afterIssues === 1 ? "" : "s"} remain, ${formatElapsed(result.elapsedMs)}`;
 };
 const getStatusParts = (state, frameIndex) => {
 	if (state.status === "running") return {
@@ -4536,6 +4604,241 @@ var FixProgressRenderer = class {
 	}
 };
 
+//#endregion
+//#region src/commands/fix-code.ts
+const CONTEXT_LINES = 3;
+const MAX_DIAGNOSTICS_PER_FILE = 10;
+const MAX_FILES = 20;
+const AGENT_CONFIGS = {
+	claude: {
+		type: "cli",
+		bin: "claude",
+		args: (p) => [p]
+	},
+	codex: {
+		type: "cli",
+		bin: "codex",
+		args: (p) => [p]
+	},
+	amp: {
+		type: "cli",
+		bin: "amp",
+		args: (p) => [p]
+	},
+	antigravity: {
+		type: "cli",
+		bin: "antigravity",
+		args: (p) => [p]
+	},
+	"deep-agents": {
+		type: "cli",
+		bin: "deep-agents",
+		args: (p) => [p]
+	},
+	gemini: {
+		type: "cli",
+		bin: "gemini",
+		args: (p) => [p]
+	},
+	kimi: {
+		type: "cli",
+		bin: "kimi",
+		args: (p) => [p]
+	},
+	opencode: {
+		type: "cli",
+		bin: "opencode",
+		args: (p) => ["run", p]
+	},
+	warp: {
+		type: "cli",
+		bin: "warp",
+		args: (p) => [p]
+	},
+	aider: {
+		type: "cli",
+		bin: "aider",
+		args: (p) => ["--message", p]
+	},
+	goose: {
+		type: "cli",
+		bin: "goose",
+		args: (p) => ["run", p]
+	},
+	cursor: {
+		type: "editor",
+		bin: "cursor"
+	},
+	windsurf: {
+		type: "editor",
+		bin: "windsurf"
+	},
+	vscode: {
+		type: "editor",
+		bin: "code"
+	}
+};
+const getCodeSnippet = (rootDirectory, diagnostic) => {
+	if (diagnostic.line <= 0) return null;
+	const absolutePath = path.resolve(rootDirectory, diagnostic.filePath);
+	let content;
+	try {
+		content = fs.readFileSync(absolutePath, "utf-8");
+	} catch {
+		return null;
+	}
+	const lines = content.split("\n");
+	const startLine = Math.max(0, diagnostic.line - 1 - CONTEXT_LINES);
+	const endLine = Math.min(lines.length, diagnostic.line + CONTEXT_LINES);
+	const snippet = [];
+	for (let i = startLine; i < endLine; i++) {
+		const lineNum = i + 1;
+		const marker = lineNum === diagnostic.line ? "→" : " ";
+		snippet.push(`${marker} ${String(lineNum).padStart(4)} │ ${lines[i]}`);
+	}
+	return snippet.join("\n");
+};
+const groupByFile = (diagnostics) => {
+	const map = /* @__PURE__ */ new Map();
+	for (const d of diagnostics) {
+		const list = map.get(d.filePath) ?? [];
+		list.push(d);
+		map.set(d.filePath, list);
+	}
+	return [...map.entries()].map(([filePath, diags]) => ({
+		filePath,
+		diagnostics: diags
+	})).sort((a, b) => {
+		const aErrors = a.diagnostics.filter((d) => d.severity === "error").length;
+		const bErrors = b.diagnostics.filter((d) => d.severity === "error").length;
+		if (aErrors !== bErrors) return bErrors - aErrors;
+		return b.diagnostics.length - a.diagnostics.length;
+	});
+};
+const isInstalled = (bin) => {
+	return spawnSync(process.platform === "win32" ? "where" : "which", [bin], { encoding: "utf-8" }).status === 0;
+};
+const copyToClipboard = (text) => {
+	const args = {
+		darwin: ["pbcopy"],
+		linux: [
+			"xclip",
+			"-selection",
+			"clipboard"
+		],
+		win32: ["clip"]
+	}[process.platform];
+	if (!args) return false;
+	const [bin, ...rest] = args;
+	return spawnSync(bin, rest, {
+		input: text,
+		encoding: "utf-8"
+	}).status === 0;
+};
+const buildAgentPrompt = (rootDirectory, diagnostics, score) => {
+	const groups = groupByFile(diagnostics).slice(0, MAX_FILES);
+	const errorCount = diagnostics.filter((d) => d.severity === "error").length;
+	const warningCount = diagnostics.filter((d) => d.severity === "warning").length;
+	const lines = [
+		`Fix the following ${diagnostics.length} code quality issue${diagnostics.length === 1 ? "" : "s"} found by aislop (current score: ${score}/100).`,
+		"",
+		`Summary: ${errorCount} error${errorCount === 1 ? "" : "s"}, ${warningCount} warning${warningCount === 1 ? "" : "s"} across ${groups.length} file${groups.length === 1 ? "" : "s"}.`,
+		""
+	];
+	for (const group of groups) {
+		lines.push(`## ${group.filePath}`);
+		lines.push("");
+		const fileDiags = group.diagnostics.slice(0, MAX_DIAGNOSTICS_PER_FILE);
+		for (const d of fileDiags) {
+			const severity = d.severity === "error" ? "ERROR" : d.severity === "warning" ? "WARN" : "INFO";
+			const location = d.line > 0 ? ` (line ${d.line})` : "";
+			lines.push(`**[${severity}]** \`${d.rule}\`${location}: ${d.message}`);
+			if (d.help) lines.push(`> ${d.help}`);
+			const snippet = getCodeSnippet(rootDirectory, d);
+			if (snippet) {
+				lines.push("```");
+				lines.push(snippet);
+				lines.push("```");
+			}
+			lines.push("");
+		}
+		if (group.diagnostics.length > MAX_DIAGNOSTICS_PER_FILE) {
+			lines.push(`_...and ${group.diagnostics.length - MAX_DIAGNOSTICS_PER_FILE} more issue${group.diagnostics.length - MAX_DIAGNOSTICS_PER_FILE === 1 ? "" : "s"} in this file._`);
+			lines.push("");
+		}
+	}
+	const totalGroups = groupByFile(diagnostics).length;
+	if (totalGroups > MAX_FILES) {
+		const remaining = totalGroups - MAX_FILES;
+		lines.push(`_...and ${remaining} more file${remaining === 1 ? "" : "s"} with issues._`);
+		lines.push("");
+	}
+	lines.push("---");
+	lines.push("Fix each issue following the guidance above. Prioritize errors over warnings.");
+	lines.push("After making changes, run `npx aislop scan` to verify all issues are resolved and the score improves.");
+	return lines.join("\n");
+};
+const SUPPORTED_AGENT_NAMES = Object.keys(AGENT_CONFIGS);
+const launchAgent = (agent, rootDirectory, diagnostics, score) => {
+	if (diagnostics.length === 0) {
+		logger.success("  No remaining issues — nothing to hand off.");
+		return;
+	}
+	const config = AGENT_CONFIGS[agent];
+	if (!config) {
+		logger.error(`  Unknown agent: ${agent}`);
+		logger.dim(`  Supported: ${SUPPORTED_AGENT_NAMES.join(", ")}`);
+		return;
+	}
+	if (!isInstalled(config.bin)) {
+		logger.error(`  ${agent} is not installed or not in PATH.`);
+		logger.dim(`  Install it first, or use ${highlighter.info("fix -p")} to print the prompt manually.`);
+		return;
+	}
+	const prompt = buildAgentPrompt(rootDirectory, diagnostics, score);
+	if (config.type === "editor") {
+		const copied = copyToClipboard(prompt);
+		logger.break();
+		if (copied) logger.log(`  ${highlighter.success("✓")} Prompt copied to clipboard (${diagnostics.length} issue${diagnostics.length === 1 ? "" : "s"})`);
+		else logger.warn("  Could not copy to clipboard. Use fix --prompt to print it instead.");
+		logger.log(`  ${highlighter.info("→")} Opening ${highlighter.bold(agent)}... paste the prompt into the agent chat.`);
+		logger.break();
+		spawnSync(config.bin, ["."], {
+			cwd: rootDirectory,
+			stdio: "inherit"
+		});
+		return;
+	}
+	logger.break();
+	logger.log(`  ${highlighter.info("→")} Opening ${highlighter.bold(agent)} with ${diagnostics.length} issue${diagnostics.length === 1 ? "" : "s"}...`);
+	logger.break();
+	spawnSync(config.bin, config.args(prompt), {
+		cwd: rootDirectory,
+		stdio: "inherit"
+	});
+};
+const printPrompt = (rootDirectory, diagnostics, score) => {
+	if (diagnostics.length === 0) {
+		logger.success("  No remaining issues — nothing to generate.");
+		return;
+	}
+	const prompt = buildAgentPrompt(rootDirectory, diagnostics, score);
+	if (!process.stdout.isTTY) {
+		process.stdout.write(prompt);
+		return;
+	}
+	logger.break();
+	logger.log(highlighter.bold("Agent prompt"));
+	logger.log(highlighter.dim("  Copy the prompt below, or pipe it: fix -p | pbcopy"));
+	logger.log(highlighter.dim("  Or launch directly: fix --claude, fix --cursor, fix --codex, etc."));
+	logger.log(highlighter.dim("  Editor agents (--cursor, --windsurf, --vscode) auto-copy to clipboard."));
+	logger.break();
+	logger.log(highlighter.dim("╭─────────────────────────────────────────────────────────╮"));
+	for (const line of prompt.split("\n")) logger.log(`  ${line}`);
+	logger.log(highlighter.dim("╰─────────────────────────────────────────────────────────╯"));
+	logger.break();
+};
+
 //#endregion
 //#region src/commands/fix-force.ts
 const getJsAuditFixCommand = (rootDirectory) => {
@@ -4556,9 +4859,69 @@ const fixDependencyAudit = async (context) => {
 		cwd: context.rootDirectory,
 		timeout: 18e4
 	});
-	if (result.exitCode !== 0) throw new Error(result.stderr || result.stdout || `${auditFix.command} audit fix failed`);
+	if (result.exitCode !== 0 && !result.stdout && !result.stderr) throw new Error(`${auditFix.command} audit fix failed`);
+	const installResult = await runSubprocess(auditFix.command, ["install"], {
+		cwd: context.rootDirectory,
+		timeout: 18e4
+	});
+	if (installResult.exitCode !== 0) throw new Error(installResult.stderr || installResult.stdout || `${auditFix.command} install failed after audit fix`);
+	if (auditFix.command === "npm") await tryNpmOverrides(context.rootDirectory);
+};
+/**
+* For unresolvable transitive vulnerabilities, attempt to add npm overrides
+* in package.json. This forces a newer version of the vulnerable transitive dep.
+*/
+const fetchLatestVersion = async (rootDir, pkgName) => {
+	try {
+		const result = await runSubprocess("npm", [
+			"view",
+			pkgName,
+			"version",
+			"--json"
+		], {
+			cwd: rootDir,
+			timeout: 1e4
+		});
+		return result.stdout ? JSON.parse(result.stdout) : null;
+	} catch {
+		return null;
+	}
+};
+const collectOverrides = async (rootDir, vulnerabilities) => {
+	const overrides = {};
+	for (const [pkgName, vuln] of Object.entries(vulnerabilities)) {
+		if (vuln.fixAvailable !== false || !vuln.range) continue;
+		const latest = await fetchLatestVersion(rootDir, pkgName);
+		if (latest) overrides[pkgName] = latest;
+	}
+	return overrides;
+};
+const tryNpmOverrides = async (rootDir) => {
+	try {
+		const auditResult = await runSubprocess("npm", ["audit", "--json"], {
+			cwd: rootDir,
+			timeout: 3e4
+		});
+		if (!auditResult.stdout) return;
+		const vulnerabilities = JSON.parse(auditResult.stdout).vulnerabilities;
+		if (!vulnerabilities) return;
+		const overrides = await collectOverrides(rootDir, vulnerabilities);
+		if (Object.keys(overrides).length === 0) return;
+		const pkgPath = path.join(rootDir, "package.json");
+		const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+		pkg.overrides = {
+			...pkg.overrides || {},
+			...overrides
+		};
+		fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+		await runSubprocess("npm", ["install"], {
+			cwd: rootDir,
+			timeout: 18e4
+		});
+	} catch {}
 };
 const fixExpoDependencies = async (context) => {
+	await removeDisallowedExpoPackages(context.rootDirectory);
 	if ((await runSubprocess("npx", [
 		"--yes",
 		"expo",
@@ -4579,6 +4942,56 @@ const fixExpoDependencies = async (context) => {
 	});
 	if (checkResult.exitCode !== 0) throw new Error(checkResult.stderr || checkResult.stdout || "expo dependency check failed");
 };
+/**
+* Run expo-doctor to detect packages that should not be installed directly,
+* then uninstall them. No hardcoded list — expo-doctor is the source of truth.
+*/
+const removeDisallowedExpoPackages = async (rootDir) => {
+	try {
+		const result = await runSubprocess("npx", [
+			"--yes",
+			"expo-doctor",
+			rootDir
+		], {
+			cwd: rootDir,
+			timeout: 12e4
+		});
+		const output = [result.stdout, result.stderr].filter(Boolean).join("\n");
+		const packagePattern = /The package "([^"]+)" should not be installed directly/g;
+		const toRemove = [];
+		let match;
+		while ((match = packagePattern.exec(output)) !== null) toRemove.push(match[1]);
+		if (toRemove.length === 0) return;
+		await runSubprocess("npm", ["uninstall", ...toRemove], {
+			cwd: rootDir,
+			timeout: 6e4
+		});
+	} catch {}
+};
+
+//#endregion
+//#region src/commands/fix-plan.ts
+const hasJsTs = (projectInfo) => projectInfo.languages.includes("typescript") || projectInfo.languages.includes("javascript");
+const buildFixStepNames = (projectInfo, config, options) => {
+	const stepNames = [];
+	if (config.engines["ai-slop"]) stepNames.push("Unused imports", "Dead code & comments");
+	if (config.engines.lint) {
+		if (hasJsTs(projectInfo)) stepNames.push("JS/TS lint fixes");
+		if (projectInfo.languages.includes("python") && projectInfo.installedTools.ruff) stepNames.push("Python lint fixes");
+	}
+	if (config.engines["code-quality"] && hasJsTs(projectInfo)) stepNames.push("Unused dependencies");
+	if (config.engines.format) {
+		if (hasJsTs(projectInfo)) stepNames.push("JS/TS formatting");
+		if (projectInfo.languages.includes("python") && projectInfo.installedTools.ruff) stepNames.push("Python formatting");
+		if (projectInfo.languages.includes("go") && projectInfo.installedTools.gofmt) stepNames.push("Go formatting");
+	}
+	if (options.force) {
+		if (config.engines["code-quality"] && hasJsTs(projectInfo)) stepNames.push("Remove unused files");
+		if (config.engines.security) stepNames.push("Dependency audit fixes");
+		if (projectInfo.frameworks.includes("expo")) stepNames.push("Expo dependency alignment");
+	}
+	return stepNames;
+};
 
 //#endregion
 //#region src/commands/fix-step.ts
@@ -4610,12 +5023,12 @@ const runFixStep = async (name, detect, applyFix, options, progress) => {
 	const stepStart = performance.now();
 	const before = await detect();
 	let applyError = null;
-	try {
+	if (before.length > 0) try {
 		await applyFix();
 	} catch (error) {
 		applyError = error;
 	}
-	const after = await detect();
+	const after = before.length > 0 ? await detect() : before;
 	const elapsedMs = performance.now() - stepStart;
 	const result = {
 		name,
@@ -4658,7 +5071,7 @@ const summarizeFixRun = (steps) => {
 		logger.log(`  Fix summary: checked ${steps.length} step(s), resolved ${totals.resolvedIssues} issue(s).`);
 		logger.warn(`  ${totals.failedSteps} step(s) reported tool errors; unresolved issue count is unknown for failed steps.`);
 	} else logger.log(`  Fix summary: checked ${steps.length} step(s), resolved ${totals.resolvedIssues} issue(s), remaining ${totals.afterIssues}.`);
-	if (totals.failedSteps === 0 && totals.beforeIssues > 0 && totals.resolvedIssues === 0) logger.dim("  No auto-fixable changes were applied. Current findings are likely manual-fix categories.");
+	if (totals.failedSteps === 0 && totals.beforeIssues > 0 && totals.resolvedIssues === 0) logger.dim("  Remaining issues require manual fixes or agent assistance. Run `scan` for details.");
 };
 
 //#endregion
@@ -4678,34 +5091,18 @@ const fixCommand = async (directory, config, options = {
 	showHeader: true
 }) => {
 	const resolvedDir = path.resolve(directory);
+	if (!fs.existsSync(resolvedDir) || !fs.statSync(resolvedDir).isDirectory()) {
+		const msg = !fs.existsSync(resolvedDir) ? `Path does not exist: ${resolvedDir}` : `Not a directory: ${resolvedDir}`;
+		logger.error(`  ${msg}`);
+		return;
+	}
 	if (options.showHeader !== false) printCommandHeader("Fix");
 	const projectInfo = await discoverProject(resolvedDir);
 	logger.success(`  ✓ ${formatProjectSummary(projectInfo)}`);
 	printProjectMetadata(projectInfo);
 	const context = createEngineContext(resolvedDir, projectInfo, config);
 	const steps = [];
-	const stepNames = [];
-	if (config.engines["ai-slop"]) {
-		stepNames.push("Unused imports");
-		stepNames.push("Dead code & comments");
-	}
-	if (config.engines.lint) {
-		if (projectInfo.languages.includes("typescript") || projectInfo.languages.includes("javascript")) stepNames.push("JS/TS lint fixes");
-		if (projectInfo.languages.includes("python") && projectInfo.installedTools.ruff) stepNames.push("Python lint fixes");
-	}
-	if (config.engines["code-quality"]) {
-		if (projectInfo.languages.includes("typescript") || projectInfo.languages.includes("javascript")) stepNames.push("Unused dependencies");
-	}
-	if (config.engines.format) {
-		if (projectInfo.languages.includes("typescript") || projectInfo.languages.includes("javascript")) stepNames.push("JS/TS formatting");
-		if (projectInfo.languages.includes("python") && projectInfo.installedTools.ruff) stepNames.push("Python formatting");
-		if (projectInfo.languages.includes("go") && projectInfo.installedTools.gofmt) stepNames.push("Go formatting");
-	}
-	if (options.force) {
-		if (config.engines.security) stepNames.push("Dependency audit fixes");
-		if (projectInfo.frameworks.includes("expo")) stepNames.push("Expo dependency alignment");
-	}
-	const progress = new FixProgressRenderer(stepNames);
+	const progress = new FixProgressRenderer(buildFixStepNames(projectInfo, config, options));
 	progress.start();
 	if (config.engines["ai-slop"]) {
 		steps.push(await runFixStep("Unused imports", () => detectUnusedImports(context), () => fixUnusedImports(context), options, progress));
@@ -4731,6 +5128,7 @@ const fixCommand = async (directory, config, options = {
 		else if (projectInfo.languages.includes("go")) logger.warn("  Go detected but gofmt is not installed; skipping Go formatting fixes.");
 	}
 	if (options.force) {
+		if (config.engines["code-quality"] && (projectInfo.languages.includes("typescript") || projectInfo.languages.includes("javascript"))) steps.push(await runFixStep("Remove unused files", () => runKnipUnusedFiles(resolvedDir), () => fixUnusedFiles(resolvedDir), options, progress));
 		if (config.engines.security) steps.push(await runFixStep("Dependency audit fixes", () => runDependencyAudit(context), () => fixDependencyAudit(context), options, progress));
 		if (projectInfo.frameworks.includes("expo")) steps.push(await runFixStep("Expo dependency alignment", () => runExpoDoctor(context), () => fixExpoDependencies(context), options, progress));
 	}
@@ -4748,6 +5146,7 @@ const fixCommand = async (directory, config, options = {
 		fixResolved: totalResolved
 	});
 	logger.break();
+	const verifySpinner = spinner("  Verifying results...").start();
 	const configDir = findConfigDir(resolvedDir);
 	const rulesPath = configDir ? path.join(configDir, RULES_FILE) : void 0;
 	const engineConfig = {
@@ -4755,13 +5154,15 @@ const fixCommand = async (directory, config, options = {
 		security: config.security,
 		architectureRulesPath: config.engines.architecture ? rulesPath : void 0
 	};
-	const allDiagnostics = (await runEngines({
+	const scanResults = await runEngines({
 		rootDirectory: resolvedDir,
 		languages: projectInfo.languages,
 		frameworks: projectInfo.frameworks,
 		installedTools: projectInfo.installedTools,
 		config: engineConfig
-	}, config.engines, () => {}, () => {})).flatMap((r) => r.diagnostics);
+	}, config.engines, () => {}, () => {});
+	verifySpinner.stop();
+	const allDiagnostics = scanResults.flatMap((r) => r.diagnostics);
 	const scoreResult = calculateScore(allDiagnostics, config.scoring.weights, config.scoring.thresholds, projectInfo.sourceFileCount, config.scoring.smoothing);
 	const errors = allDiagnostics.filter((d) => d.severity === "error").length;
 	const warnings = allDiagnostics.filter((d) => d.severity === "warning").length;
@@ -4776,6 +5177,26 @@ const fixCommand = async (directory, config, options = {
 	if (fixable > 0) logger.log(`  Auto-fixable: ${highlighter.info(String(fixable))}`);
 	if (manual > 0) logger.log(`  Manual effort: ${highlighter.dim(String(manual))}`);
 	logger.log(highlighter.dim("------------------------------------------------------------"));
+	if (options.agent) {
+		launchAgent(options.agent, resolvedDir, allDiagnostics, scoreResult.score);
+		return;
+	}
+	if (options.prompt) {
+		printPrompt(resolvedDir, allDiagnostics, scoreResult.score);
+		return;
+	}
+	const nextSteps = [];
+	if (!options.force && errors + warnings > 0) nextSteps.push(`Run ${highlighter.info("fix -f")} to try aggressive fixes (dependency audit, unused files, unsafe lint)`);
+	if (errors + warnings > 0 && !options.agent && !options.prompt) {
+		nextSteps.push(`Run ${highlighter.info("fix --<agent>")} to hand off to a coding agent, or ${highlighter.info("fix --prompt")} to copy the prompt`);
+		nextSteps.push(highlighter.dim("Agents: --claude, --codex, --gemini, --opencode, --cursor, --amp, --aider, --goose and more"));
+	}
+	if (errors + warnings > 0) nextSteps.push(`Run ${highlighter.info("scan")} to see remaining issues with full details`);
+	if (nextSteps.length > 0) {
+		logger.break();
+		logger.log(highlighter.bold("Next steps"));
+		for (let i = 0; i < nextSteps.length; i++) logger.log(`  ${i + 1}. ${nextSteps[i]}`);
+	}
 	logger.break();
 };
 
@@ -5149,7 +5570,10 @@ ${highlighter.dim("Examples:")}
   aislop scan --changes  Scan only changed files
   aislop scan --staged   Scan only staged files (for hooks)
   aislop fix             Auto-fix ai slop in codebase
-  aislop fix --force     Run aggressive fixes (includes audit and dependency alignment)
+  aislop fix -f          Run aggressive fixes (includes audit and dependency alignment)
+  aislop fix --claude    Open Claude Code to fix remaining issues
+  aislop fix --cursor    Open Cursor + copy prompt to clipboard
+  aislop fix -p          Print a prompt to paste into any coding agent
   aislop ci              JSON output for CI pipelines
 `);
 program.command("scan [directory]").description("Run full code quality scan").option("--changes", "only scan changed files").option("--staged", "only scan staged files").option("-d, --verbose", "show file details per rule").option("--json", "output JSON").action(async (directory = ".", _flags, command) => {
@@ -5165,11 +5589,33 @@ program.command("scan [directory]").description("Run full code quality scan").op
 		process.exit(exitCode);
 	}
 });
-program.command("fix [directory]").description("Auto-fix ai slop in codebase").option("-d, --verbose", "show detailed fix progress").option("-f, --force", "run aggressive fixes (audit and framework dependency alignment)").action(async (directory = ".", _flags, command) => {
+program.command("fix [directory]").description("Auto-fix ai slop in codebase").option("-d, --verbose", "show detailed fix progress").option("-f, --force", "run aggressive fixes (audit and framework dependency alignment)").option("-p, --prompt", "print a prompt for your coding agent to fix remaining issues").option("--claude", "open Claude Code to fix remaining issues").option("--codex", "open Codex to fix remaining issues").option("--cursor", "open Cursor and copy prompt to clipboard").option("--windsurf", "open Windsurf and copy prompt to clipboard").option("--vscode", "open VS Code and copy prompt to clipboard").option("--amp", "open Amp to fix remaining issues").option("--antigravity", "open Antigravity to fix remaining issues").option("--deep-agents", "open Deep Agents to fix remaining issues").option("--gemini", "open Gemini CLI to fix remaining issues").option("--kimi", "open Kimi Code CLI to fix remaining issues").option("--opencode", "open OpenCode to fix remaining issues").option("--warp", "open Warp to fix remaining issues").option("--aider", "open Aider to fix remaining issues").option("--goose", "open Goose to fix remaining issues").action(async (directory = ".", _flags, command) => {
 	const flags = command.optsWithGlobals();
-	await fixCommand(directory, loadConfig(directory), {
+	const config = loadConfig(directory);
+	const agentNames = [
+		"claude",
+		"codex",
+		"cursor",
+		"windsurf",
+		"vscode",
+		"amp",
+		"antigravity",
+		"deepAgents",
+		"gemini",
+		"kimi",
+		"opencode",
+		"warp",
+		"aider",
+		"goose"
+	];
+	const flagToAgent = { deepAgents: "deep-agents" };
+	const matched = agentNames.find((name) => flags[name]);
+	const agent = matched ? flagToAgent[matched] ?? matched : void 0;
+	await fixCommand(directory, config, {
 		verbose: Boolean(flags.verbose),
-		force: Boolean(flags.force)
+		force: Boolean(flags.force),
+		prompt: Boolean(flags.prompt),
+		agent
 	});
 });
 program.command("init [directory]").description("Initialize aislop config in project").action(async (directory = ".") => {