feat(coding-agent/cleanse): introduced discovery subagent and tui flows

- Added discovery subagent and custom checker specifications for alternative toolings across multiple languages. - Implemented interactive TUI flows for target picking and free-form request discovery. - Added output parsers for popular static analysis and linting tools. - Increased default maximum subagents cap and documented the new capabilities.
2026-08-12 00:58:12 +02:00
parent 1217ee1317
commit 93fed035f6
9 changed files with 1037 additions and 87 deletions
@@ -0,0 +1,86 @@
+/**
+ * Standalone TUI pickers for `omp cleanse`.
+ *
+ * Mirrors {@link ./setup-model-picker.ts}: one-shot {@link TUI} instances over a
+ * {@link SelectList} or {@link Input}, resolved on select/submit/cancel and torn
+ * down immediately so the command can keep writing plain stdout afterwards.
+ */
+import { Input, ProcessTerminal, type SelectItem, SelectList, TUI } from "@oh-my-pi/pi-tui";
+import type { CleanseCheckerDescriptor } from "../cleanse/checkers";
+import { getSelectListTheme } from "../modes/theme/theme";
+
+/** Outcome of the interactive cleanse target picker. */
+export type CleanseTargetChoice =
+	| { kind: "all" }
+	| { kind: "checker"; id: string }
+	| { kind: "request"; request: string }
+	| { kind: "cancel" };
+
+/** Pick between running every discovered checker, one specific checker, or a free-form request. */
+export async function pickCleanseTarget(checkers: readonly CleanseCheckerDescriptor[]): Promise<CleanseTargetChoice> {
+	const items: SelectItem[] = [
+		{
+			value: "all",
+			label: `Run all ${checkers.length} discovered checker${checkers.length === 1 ? "" : "s"}`,
+		},
+		...checkers.map(checker => ({
+			value: `checker:${checker.id}`,
+			label: checker.label,
+			description: `${checker.language} — ${checker.command}`,
+		})),
+		{
+			value: "request",
+			label: "Describe what to fix…",
+			description: "A discovery agent figures out the command to run",
+		},
+	];
+	const selection = await selectOne("Select what to cleanse:", items);
+	if (selection === null) return { kind: "cancel" };
+	if (selection === "all") return { kind: "all" };
+	if (selection === "request") {
+		const request = await promptCleanseRequest();
+		return request === null ? { kind: "cancel" } : { kind: "request", request };
+	}
+	return { kind: "checker", id: selection.slice("checker:".length) };
+}
+
+/** One-shot text prompt for a free-form cleanse request; `null` when cancelled or left empty. */
+export async function promptCleanseRequest(): Promise<string | null> {
+	const { promise, resolve } = Promise.withResolvers<string | null>();
+	const ui = new TUI(new ProcessTerminal());
+	let resolved = false;
+	const finish = (value: string | null): void => {
+		if (resolved) return;
+		resolved = true;
+		ui.stop();
+		resolve(value);
+	};
+	const input = new Input();
+	input.onSubmit = value => finish(value.trim() || null);
+	input.onEscape = () => finish(null);
+	process.stdout.write('Describe what to detect and fix (e.g. "ts errors"):\n');
+	ui.addChild(input);
+	ui.setFocus(input);
+	ui.start();
+	return promise;
+}
+
+async function selectOne(title: string, items: SelectItem[]): Promise<string | null> {
+	const { promise, resolve } = Promise.withResolvers<string | null>();
+	const ui = new TUI(new ProcessTerminal());
+	let resolved = false;
+	const finish = (value: string | null): void => {
+		if (resolved) return;
+		resolved = true;
+		ui.stop();
+		resolve(value);
+	};
+	const list = new SelectList(items, Math.min(items.length, 12), getSelectListTheme());
+	list.onSelect = item => finish(item.value);
+	list.onCancel = () => finish(null);
+	process.stdout.write(`${title}\n`);
+	ui.addChild(list);
+	ui.setFocus(list);
+	ui.start();
+	return promise;
+}