feat: add timed confirmation dialog with auto-resolve (#7)

* feat: add timed confirmation dialog with auto-resolve

* docs: update changelog

Author: kostyay

CHANGELOG.md

@@ -10,7 +10,13 @@ All notable changes to agent-stuff are documented here.
 
 
 
-## chore/eslint-typescript-config
+
+
+## feat/timed-confirm-dialog
+
+Introduces a reusable timed confirmation dialog component (#7) that displays a bordered prompt with an auto-resolving countdown timer, allowing users to confirm immediately via Enter or cancel with Escape. The dialog has been integrated into the PR merge workflow, replacing the standard confirmation prompt to streamline the merge process with a 5-second auto-confirm default. Includes comprehensive test coverage (336 lines) validating timer behavior, keyboard input handling, and configuration options, ensuring robust interaction across various scenarios.
+
+## [1.0.0](https://github.com/kostyay/agent-stuff/pull/6) - 2026-03-02
 
 Added ESLint configuration with TypeScript support (#6) to enforce syntax and error detection across the codebase. The setup leverages typescript-eslint with recommended rules while disabling noisy stylistic checks to align with the project's existing conventions. ESLint dependencies (eslint ^10.0.2 and typescript-eslint ^8.56.1) have been added to the dev stack. TypeScript files in pi-extensions were linted and adjusted to comply with the new configuration, focusing on catching genuine bugs rather than enforcing code style preferences.
 

lib/timed-confirm.ts

@@ -0,0 +1,116 @@
+/**
+ * Timed Confirm — a reusable confirmation dialog with a countdown timer.
+ *
+ * Shows a bordered confirmation prompt that auto-confirms after a
+ * configurable number of seconds. The user can press Enter to confirm
+ * immediately or Escape to cancel.
+ */
+
+import { DynamicBorder } from "@mariozechner/pi-coding-agent";
+import type { ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { Container, Key, Text, matchesKey } from "@mariozechner/pi-tui";
+
+// ---------------------------------------------------------------------------
+// Options
+// ---------------------------------------------------------------------------
+
+/** Configuration for the timed confirmation dialog. */
+export interface TimedConfirmOptions {
+	/** Dialog title. */
+	title: string;
+	/** Descriptive message shown below the title. */
+	message: string;
+	/** Countdown duration in seconds. Defaults to 5. */
+	seconds?: number;
+	/** Value returned when the timer expires. Defaults to `true`. */
+	defaultValue?: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/** Default countdown duration in seconds. */
+const DEFAULT_SECONDS = 5;
+
+/**
+ * Show a confirmation dialog with a countdown timer.
+ *
+ * Auto-resolves with `defaultValue` (default `true`) when the timer expires.
+ * The user can press Enter to confirm or Escape to cancel at any time.
+ *
+ * @example
+ * ```ts
+ * const ok = await timedConfirm(ctx, {
+ *   title: "Merge PR",
+ *   message: `Merge PR #${pr.number} into main?`,
+ *   seconds: 5,
+ * });
+ * ```
+ */
+export async function timedConfirm(
+	ctx: ExtensionCommandContext,
+	options: TimedConfirmOptions,
+): Promise<boolean> {
+	const { title, message, seconds = DEFAULT_SECONDS, defaultValue = true } = options;
+
+	return ctx.ui.custom<boolean>((tui, theme, _kb, done) => {
+		let remaining = seconds;
+		let resolved = false;
+
+		const finish = (value: boolean) => {
+			if (resolved) return;
+			resolved = true;
+			clearInterval(timer);
+			done(value);
+		};
+
+		const timer = setInterval(() => {
+			remaining--;
+			if (remaining <= 0) {
+				finish(defaultValue);
+			} else {
+				tui.requestRender();
+			}
+		}, 1000);
+
+		const container = new Container();
+		const borderTop = new DynamicBorder((s: string) => theme.fg("accent", s));
+		const titleText = new Text("", 1, 0);
+		const messageText = new Text("", 1, 0);
+		const helpText = new Text("", 1, 0);
+		const borderBottom = new DynamicBorder((s: string) => theme.fg("accent", s));
+
+		container.addChild(borderTop);
+		container.addChild(titleText);
+		container.addChild(messageText);
+		container.addChild(helpText);
+		container.addChild(borderBottom);
+
+		const defaultLabel = defaultValue ? "confirm" : "cancel";
+
+		const updateTexts = () => {
+			titleText.setText(theme.fg("accent", theme.bold(title)));
+			messageText.setText(message);
+			helpText.setText(
+				theme.fg("dim", `Auto-${defaultLabel} in ${remaining}s - enter confirm - esc cancel`),
+			);
+		};
+		updateTexts();
+
+		return {
+			render: (w: number) => {
+				updateTexts();
+				return container.render(w);
+			},
+			invalidate: () => container.invalidate(),
+			handleInput: (data: string) => {
+				if (matchesKey(data, Key.enter)) {
+					finish(true);
+				} else if (matchesKey(data, Key.escape)) {
+					finish(false);
+				}
+			},
+		};
+	});
+}

package.json

@@ -9,7 +9,7 @@
   "readme": "README.md",
   "type": "module",
   "scripts": {
-    "lint": "eslint pi-extensions/ tests/",
+    "lint": "eslint --fix pi-extensions/ tests/",
     "test": "npm run lint && node --experimental-strip-types --test tests/*.test.ts"
   },
   "keywords": [

pi-extensions/commit.ts

@@ -18,6 +18,7 @@ import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-cod
 import { readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 
+import { timedConfirm } from "../lib/timed-confirm.ts";
 import {
 	type ChangelogContext,
 	buildChangelogPrompt,
@@ -858,6 +859,8 @@ async function performRebase(
 	return false;
 }
 
+// ---------------------------------------------------------------------------
+// Extension entry point
 // ---------------------------------------------------------------------------
 // Extension entry point
 // ---------------------------------------------------------------------------
@@ -1011,11 +1014,11 @@ export default function commitExtension(pi: ExtensionAPI) {
 				if (!(await performRebase(pi, ctx, defaultBranch))) return;
 			}
 
-			// Step 6: Confirm with user
-			const confirmed = await ctx.ui.confirm(
-				"Merge PR",
-				`Merge PR #${pr.number} into ${defaultBranch}?`,
-			);
+			// Step 6: Confirm with user (auto-confirms after 5s)
+			const confirmed = await timedConfirm(ctx, {
+				title: "Merge PR",
+				message: `Merge PR #${pr.number} into ${defaultBranch}?`,
+			});
 			if (!confirmed) {
 				ctx.ui.notify("Merge cancelled", "info");
 				return;