@mrclrchtr/supi-ask-user 0.1.0 → 0.2.0

package/{types.ts → src/types.ts}

@@ -2,9 +2,9 @@
 // The external (model-facing) schema lives in `schema.ts`; everything beyond
 // parsing passes through normalization into the shapes defined here.
 
-export type QuestionType = "choice" | "multichoice" | "text" | "yesno";
+export type QuestionType = "choice" | "text";
 
-export type TerminalState = "submitted" | "cancelled" | "aborted";
+export type TerminalState = "submitted" | "cancelled" | "aborted" | "skipped";
 
 export interface NormalizedOption {
   value: string;
@@ -18,6 +18,7 @@ interface BaseQuestion {
   header: string;
   prompt: string;
   type: QuestionType;
+  required: boolean;
 }
 
 interface StructuredQuestionBase extends BaseQuestion {
@@ -25,60 +26,39 @@ interface StructuredQuestionBase extends BaseQuestion {
   allowOther: boolean;
   allowDiscuss: boolean;
   recommendedIndexes: number[];
+  defaultIndexes: number[];
+  multi: boolean;
 }
 
 export interface NormalizedChoiceQuestion extends StructuredQuestionBase {
   type: "choice";
 }
 
-export interface NormalizedMultiChoiceQuestion extends StructuredQuestionBase {
-  type: "multichoice";
-}
-
-export interface NormalizedYesNoQuestion extends StructuredQuestionBase {
-  type: "yesno";
-}
-
 export interface NormalizedTextQuestion extends BaseQuestion {
   type: "text";
   options: [];
+  default?: string;
 }
 
-export type NormalizedStructuredQuestion =
-  | NormalizedChoiceQuestion
-  | NormalizedMultiChoiceQuestion
-  | NormalizedYesNoQuestion;
+export type NormalizedStructuredQuestion = NormalizedChoiceQuestion;
 
-export type NormalizedQuestion =
-  | NormalizedChoiceQuestion
-  | NormalizedMultiChoiceQuestion
-  | NormalizedTextQuestion
-  | NormalizedYesNoQuestion;
+export type NormalizedQuestion = NormalizedChoiceQuestion | NormalizedTextQuestion;
 
 export interface NormalizedQuestionnaire {
   questions: NormalizedQuestion[];
+  allowSkip: boolean;
 }
 
-export interface OptionAnswer {
-  questionId: string;
-  source: "option";
-  value: string;
-  optionIndex: number;
-  note?: string;
-}
-
-export interface MultiSelection {
+export interface Selection {
   value: string;
   optionIndex: number;
   note?: string;
 }
 
-export interface OptionsAnswer {
+export interface ChoiceAnswer {
   questionId: string;
-  source: "options";
-  values: string[];
-  optionIndexes: number[];
-  selections: MultiSelection[];
+  source: "choice";
+  selections: Selection[];
 }
 
 export interface OtherAnswer {
@@ -99,41 +79,28 @@ export interface TextAnswer {
   value: string;
 }
 
-export interface YesNoAnswer {
-  questionId: string;
-  source: "yesno";
-  value: "yes" | "no";
-  optionIndex: 0 | 1;
-  note?: string;
-}
-
-export type Answer =
-  | OptionAnswer
-  | OptionsAnswer
-  | OtherAnswer
-  | DiscussAnswer
-  | TextAnswer
-  | YesNoAnswer;
+export type Answer = ChoiceAnswer | OtherAnswer | DiscussAnswer | TextAnswer;
 
 export interface QuestionnaireOutcome {
   terminalState: TerminalState;
   answers: Answer[];
+  skipped?: true;
 }
 
 export interface AskUserDetails {
   questions: NormalizedQuestion[];
   answers: Answer[];
-  answersById: Record<string, Answer>;
+  answersById: Record<string, Answer | undefined>;
   terminalState: TerminalState;
 }
 
 export const QUESTION_LIMITS = {
   minQuestions: 1,
   maxQuestions: 4,
-  maxHeaderLength: 40,
-  maxPromptLength: 2000,
+  maxHeaderLength: 60,
+  maxPromptLength: 4000,
   minChoiceOptions: 2,
-  maxChoiceOptions: 8,
+  maxChoiceOptions: 12,
 } as const;
 
 export function isStructuredQuestion(
@@ -143,7 +110,7 @@ export function isStructuredQuestion(
 }
 
 export function needsReview(questions: NormalizedQuestion[]): boolean {
-  return questions.length > 1 || questions.some((q) => q.type === "multichoice");
+  return questions.length > 1 || questions.some((q) => q.type !== "text" && q.multi);
 }
 
 export function primaryRecommendationIndex(question: NormalizedQuestion): number | undefined {

package/{ui-rich-handlers.ts → src/ui/ui-rich-handlers.ts}

@@ -1,17 +1,18 @@
 // Input handlers for the rich overlay questionnaire UI.
 
-import { Key, matchesKey } from "@mariozechner/pi-tui";
-import type { NormalizedQuestion, NormalizedStructuredQuestion } from "./types.ts";
-import { isEditorMode, selectedIndexesForQuestion } from "./ui-rich-render.ts";
-import { currentNote, currentRowSupportsNotes } from "./ui-rich-render-notes.ts";
+import { Key, matchesKey } from "@earendil-works/pi-tui";
+import { currentNote, currentRowSupportsNotes } from "../render/ui-rich-render-notes.ts";
+import type { NormalizedQuestion, NormalizedStructuredQuestion } from "../types.ts";
 import {
   existingStructuredInputValue,
   interactiveRows,
+  isEditorMode,
   mergedMultiNoteMap,
   multiNoteMapFromAnswer,
   type OverlayDeps,
   resetStateForCurrent,
   rowCount,
+  selectedIndexesForQuestion,
   singleNoteFromAnswer,
 } from "./ui-rich-state.ts";
 
@@ -21,7 +22,7 @@ export function onEditorSubmit(value: string, deps: OverlayDeps): void {
   const trimmed = value.trim();
   const { state, editor, refresh } = deps;
   if (state.subMode === "text-input") {
-    if (trimmed.length === 0) return;
+    if (trimmed.length === 0 && question.required) return;
     deps.flow.setAnswer({ questionId: question.id, source: "text", value: trimmed });
     moveAfterAnswer(deps);
     return;
@@ -33,11 +34,13 @@ export function onEditorSubmit(value: string, deps: OverlayDeps): void {
       refresh();
       return;
     }
+    clearStructuredDrafts(question, deps);
     deps.flow.setAnswer({ questionId: question.id, source: "other", value: trimmed });
     moveAfterAnswer(deps);
     return;
   }
   if (state.subMode === "discuss-input") {
+    clearStructuredDrafts(question, deps);
     deps.flow.setAnswer(
       trimmed.length > 0
         ? { questionId: question.id, source: "discuss", value: trimmed }
@@ -74,13 +77,44 @@ function applyNoteEdit(note: string, deps: OverlayDeps): void {
   else state.stagedMultiNotes.delete(target.questionId);
 }
 
+function clearStructuredDrafts(question: NormalizedQuestion, deps: OverlayDeps): void {
+  if (question.type === "text" || !question.multi) return;
+  deps.state.stagedSelections.delete(question.id);
+  deps.state.stagedMultiNotes.delete(question.id);
+}
+
+function handleInlineEditorNav(data: string, deps: OverlayDeps): boolean {
+  const { state, flow } = deps;
+  if (
+    (state.subMode !== "other-input" && state.subMode !== "discuss-input") ||
+    (!matchesKey(data, Key.up) && !matchesKey(data, Key.down))
+  ) {
+    return false;
+  }
+  const question = flow.currentQuestion;
+  if (!question || question.type === "text") return false;
+  const maxIndex = Math.max(0, rowCount(question) - 1);
+  const nextIndex = matchesKey(data, Key.up)
+    ? Math.max(0, state.selectedIndex - 1)
+    : Math.min(maxIndex, state.selectedIndex + 1);
+  state.subMode = "select";
+  deps.editor.setText("");
+  moveSelection(question, nextIndex, deps);
+  return true;
+}
+
 export function handleOverlayInput(data: string, deps: OverlayDeps): void {
   const { state, flow } = deps;
   if (isEditorMode(state.subMode)) {
+    if (state.subMode === "text-input" && matchesKey(data, Key.ctrl("s")) && flow.showSkip) {
+      handleSkipAction(deps);
+      return;
+    }
     if (matchesKey(data, Key.escape)) {
       handleEditorEscape(deps);
       return;
     }
+    if (handleInlineEditorNav(data, deps)) return;
     deps.editor.handleInput(data);
     deps.refresh();
     return;
@@ -100,6 +134,17 @@ export function handleOverlayInput(data: string, deps: OverlayDeps): void {
 function handleEditorEscape(deps: OverlayDeps): void {
   const { state, editor, flow, refresh } = deps;
   if (state.subMode === "text-input") {
+    const question = flow.currentQuestion;
+    if (question && !question.required) {
+      flow.advance();
+      if (flow.isTerminal()) {
+        deps.finish(flow.outcome());
+        return;
+      }
+      resetStateForCurrent(deps);
+      refresh();
+      return;
+    }
     flow.cancel();
     deps.finish(flow.outcome());
     return;
@@ -113,7 +158,7 @@ function handleEditorEscape(deps: OverlayDeps): void {
 function handleSelectInput(data: string, deps: OverlayDeps): void {
   const { flow, state } = deps;
   const question = flow.currentQuestion;
-  if (!question) return;
+  if (!question || question.type === "text") return;
   const maxIndex = Math.max(0, rowCount(question) - 1);
   if (matchesKey(data, Key.up)) {
     moveSelection(question, Math.max(0, state.selectedIndex - 1), deps);
@@ -124,7 +169,7 @@ function handleSelectInput(data: string, deps: OverlayDeps): void {
     return;
   }
   if (handleSelectNav(data, deps)) return;
-  if (question.type === "multichoice" && matchesKey(data, Key.space)) {
+  if (question.multi && matchesKey(data, Key.space)) {
     toggleCurrentSelection(question, deps);
     return;
   }
@@ -136,17 +181,39 @@ function handleSelectInput(data: string, deps: OverlayDeps): void {
     handleSelectEnter(question, deps);
     return;
   }
+  if (matchesKey(data, "s") && flow.showSkip) {
+    handleSkipAction(deps);
+    return;
+  }
+}
+
+/** Skip action shared by Ctrl-S (text-input) and 's' (select) handlers. */
+function handleSkipAction(deps: OverlayDeps): void {
+  const { flow } = deps;
+  const question = flow.currentQuestion;
+  if (flow.isMultiQuestion && question && !question.required && !flow.hasAnswer(question.id)) {
+    flow.advance();
+    if (flow.isTerminal()) {
+      deps.finish(flow.outcome());
+      return;
+    }
+    resetStateForCurrent(deps);
+    deps.refresh();
+    return;
+  }
+  flow.skip();
+  deps.finish(flow.outcome());
 }
 
 function openNoteEditor(question: NormalizedQuestion, deps: OverlayDeps): void {
   if (question.type === "text") return;
-  const row = interactiveRows(question)[deps.state.selectedIndex];
+  const rows = interactiveRows(question);
+  const row = rows[deps.state.selectedIndex];
   if (!row || row.kind !== "option") return;
   deps.state.subMode = "note-input";
-  deps.state.noteTarget =
-    question.type === "multichoice"
-      ? { mode: "multi", questionId: question.id, optionIndex: row.optionIndex }
-      : { mode: "single", questionId: question.id };
+  deps.state.noteTarget = question.multi
+    ? { mode: "multi", questionId: question.id, optionIndex: row.optionIndex }
+    : { mode: "single", questionId: question.id };
   deps.editor.setText(currentNote(deps.flow, deps.state, question) ?? "");
   deps.refresh();
 }
@@ -161,7 +228,13 @@ function handleSelectNav(data: string, deps: OverlayDeps): boolean {
     return true;
   }
   if (matchesKey(data, Key.tab) || matchesKey(data, Key.right)) {
-    if (flow.allAnswered() && flow.enterReview()) refresh();
+    const question = flow.currentQuestion;
+    if (flow.allRequiredAnswered() && flow.enterReview()) {
+      refresh();
+    } else if (question && !question.required && !flow.hasAnswer(question.id) && flow.advance()) {
+      resetStateForCurrent(deps);
+      refresh();
+    }
     return true;
   }
   return false;
@@ -172,7 +245,7 @@ function handleSelectEnter(question: NormalizedQuestion, deps: OverlayDeps): voi
   const row = interactiveRows(question)[deps.state.selectedIndex];
   if (!row) return;
   if (row.kind === "option") {
-    if (question.type === "multichoice") {
+    if (question.multi) {
       handleSubmitSelections(question, deps);
       return;
     }
@@ -187,38 +260,18 @@ function handleOptionRow(
   optionIndex: number,
   deps: OverlayDeps,
 ): void {
-  if (question.type === "multichoice") {
-    toggleSelection(question, optionIndex, deps);
-    deps.refresh();
-    return;
-  }
   const option = question.options[optionIndex];
   const note =
     deps.state.stagedSingleNotes.get(question.id) ?? singleNoteFromAnswer(deps.flow, question.id);
-  deps.flow.setAnswer(
-    question.type === "yesno"
-      ? {
-          questionId: question.id,
-          source: "yesno",
-          value: option.value as "yes" | "no",
-          optionIndex: optionIndex as 0 | 1,
-          note,
-        }
-      : {
-          questionId: question.id,
-          source: "option",
-          value: option.value,
-          optionIndex,
-          note,
-        },
-  );
+  deps.flow.setAnswer({
+    questionId: question.id,
+    source: "choice",
+    selections: [{ value: option.value, optionIndex, note }],
+  });
   moveAfterAnswer(deps);
 }
 
-function toggleCurrentSelection(
-  question: Extract<NormalizedStructuredQuestion, { type: "multichoice" }>,
-  deps: OverlayDeps,
-): void {
+function toggleCurrentSelection(question: NormalizedStructuredQuestion, deps: OverlayDeps): void {
   const row = interactiveRows(question)[deps.state.selectedIndex];
   if (!row || row.kind !== "option") return;
   toggleSelection(question, row.optionIndex, deps);
@@ -269,7 +322,7 @@ function toggleSelection(
 }
 
 function handleSubmitSelections(question: NormalizedStructuredQuestion, deps: OverlayDeps): void {
-  if (question.type !== "multichoice") return;
+  if (!question.multi) return;
   const indexes = selectedIndexesForQuestion(deps.flow, deps.state, question);
   if (indexes.length === 0) return;
   const noteMap = mergedMultiNoteMap(deps, question.id);
@@ -280,9 +333,7 @@ function handleSubmitSelections(question: NormalizedStructuredQuestion, deps: Ov
   }));
   deps.flow.setAnswer({
     questionId: question.id,
-    source: "options",
-    values: selections.map((s) => s.value),
-    optionIndexes: selections.map((s) => s.optionIndex),
+    source: "choice",
     selections,
   });
   moveAfterAnswer(deps);
@@ -299,6 +350,11 @@ function handleReviewInput(data: string, deps: OverlayDeps): void {
       resetStateForCurrent(deps);
       refresh();
     }
+    return;
+  }
+  if (matchesKey(data, "s") && flow.showSkip) {
+    flow.skip();
+    deps.finish(flow.outcome());
   }
 }
 

package/{ui-rich-inline.ts → src/ui/ui-rich-inline.ts}

@@ -1,10 +1,10 @@
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import type { Editor } from "@mariozechner/pi-tui";
-import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
-import type { QuestionnaireFlow } from "./flow.ts";
-import { DISCUSS_LABEL, OTHER_LABEL } from "./format.ts";
-import type { NormalizedStructuredQuestion } from "./types.ts";
-import type { OverlayRenderState } from "./ui-rich-render.ts";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { Editor } from "@earendil-works/pi-tui";
+import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import type { QuestionnaireFlow } from "../flow.ts";
+import { DISCUSS_LABEL, OTHER_LABEL } from "../format.ts";
+import type { OverlayRenderState } from "../render/ui-rich-render-types.ts";
+import type { NormalizedStructuredQuestion } from "../types.ts";
 import type { InteractiveRow } from "./ui-rich-state.ts";
 
 export function structuredRowLabel(
@@ -50,10 +50,23 @@ function renderInlineEditorLines(
 ): string[] {
   const lines = editor.getLines();
   const cursor = editor.getCursor();
-  return lines.map((line, index) => {
+  const out: string[] = [];
+  const lineWidth = Math.max(1, width);
+  const prefixWidth = visibleWidth(prefix);
+  const contentWidth = Math.max(1, lineWidth - prefixWidth);
+  const continuationPrefix = " ".repeat(prefixWidth);
+
+  for (const [index, line] of lines.entries()) {
     const content = index === cursor.line ? highlightCursor(theme, line, cursor.col) : line;
-    return truncateToWidth(`${prefix}${content}`, Math.max(1, width));
-  });
+    const wrapped = wrapTextWithAnsi(content, contentWidth);
+    for (const [chunkIndex, chunk] of wrapped.entries()) {
+      out.push(
+        truncateToWidth(`${chunkIndex === 0 ? prefix : continuationPrefix}${chunk}`, lineWidth),
+      );
+    }
+  }
+
+  return out.length > 0 ? out : [truncateToWidth(prefix, lineWidth)];
 }
 
 function highlightCursor(theme: Theme, line: string, col: number): string {

package/{ui-rich-state.ts → src/ui/ui-rich-state.ts}

@@ -1,14 +1,15 @@
 // Shared state types and pure helpers for the rich overlay.
 
-import type { Editor } from "@mariozechner/pi-tui";
-import type { QuestionnaireFlow } from "./flow.ts";
+import type { Editor } from "@earendil-works/pi-tui";
+import type { QuestionnaireFlow } from "../flow.ts";
+import type { OverlayRenderState, SubMode } from "../render/ui-rich-render-types.ts";
 import type {
   NormalizedQuestion,
   NormalizedStructuredQuestion,
+  NormalizedTextQuestion,
   QuestionnaireOutcome,
-} from "./types.ts";
-import { isStructuredQuestion, primaryRecommendationIndex } from "./types.ts";
-import type { OverlayRenderState, SubMode } from "./ui-rich-render.ts";
+} from "../types.ts";
+import { isStructuredQuestion, primaryRecommendationIndex } from "../types.ts";
 
 export interface NoteTargetSingle {
   mode: "single";
@@ -27,6 +28,7 @@ export interface OverlayState extends OverlayRenderState {
   noteTarget?: NoteTarget;
   cachedLines: string[] | undefined;
   cachedWidth: number | undefined;
+  maxHeight: number;
 }
 
 export interface OverlayDeps {
@@ -65,12 +67,23 @@ export function initialSubMode(question: NormalizedQuestion | undefined): SubMod
   return question.type === "text" ? "text-input" : "select";
 }
 
+export function textDefaultOrAnswer(
+  flow: Pick<QuestionnaireFlow, "getAnswer">,
+  question: NormalizedTextQuestion,
+): string {
+  const answer = flow.getAnswer(question.id);
+  if (answer?.source === "text") return answer.value;
+  return question.default ?? "";
+}
+
 export function resetStateForCurrent(deps: OverlayDeps): void {
   const question = deps.flow.currentQuestion;
   deps.state.subMode = deps.flow.currentMode === "reviewing" ? "select" : initialSubMode(question);
   deps.state.selectedIndex = selectedRowIndex(deps.flow, question);
   deps.state.noteTarget = undefined;
-  deps.editor.setText("");
+  deps.state.maxHeight = 0;
+  const editorText = question?.type === "text" ? textDefaultOrAnswer(deps.flow, question) : "";
+  deps.editor.setText(editorText);
 }
 
 export function existingStructuredInputValue(
@@ -88,9 +101,8 @@ export function singleNoteFromAnswer(
   questionId: string,
 ): string | undefined {
   const answer = flow.getAnswer(questionId);
-  if (!answer) return undefined;
-  if (answer.source === "option" || answer.source === "yesno") return answer.note;
-  return undefined;
+  if (!answer || answer.source !== "choice") return undefined;
+  return answer.selections[0]?.note;
 }
 
 export function multiNoteMapFromAnswer(
@@ -99,7 +111,7 @@ export function multiNoteMapFromAnswer(
 ): Map<number, string> {
   const answer = flow.getAnswer(questionId);
   const map = new Map<number, string>();
-  if (!answer || answer.source !== "options") return map;
+  if (!answer || answer.source !== "choice") return map;
   for (const selection of answer.selections) {
     if (selection.note) map.set(selection.optionIndex, selection.note);
   }
@@ -115,6 +127,32 @@ export function mergedMultiNoteMap(deps: OverlayDeps, questionId: string): Map<n
   return merged;
 }
 
+export function isEditorMode(mode: SubMode): boolean {
+  return (
+    mode === "text-input" ||
+    mode === "other-input" ||
+    mode === "discuss-input" ||
+    mode === "note-input"
+  );
+}
+
+export function selectedIndexesForQuestion(
+  flow: Pick<QuestionnaireFlow, "getAnswer">,
+  state: Pick<OverlayRenderState, "stagedSelections">,
+  question: NormalizedStructuredQuestion,
+): number[] {
+  const answer = flow.getAnswer(question.id);
+  if (answer?.source === "other" || answer?.source === "discuss") return [];
+  const staged = state.stagedSelections.get(question.id);
+  if (staged) return [...staged];
+  if (!answer) {
+    if (question.defaultIndexes.length > 0) return [...question.defaultIndexes];
+    return [];
+  }
+  if (answer.source === "choice") return answer.selections.map((s) => s.optionIndex);
+  return [];
+}
+
 export function selectedRowIndex(
   flow: Pick<QuestionnaireFlow, "getAnswer">,
   question: NormalizedQuestion | undefined,
@@ -123,15 +161,14 @@ export function selectedRowIndex(
   const rows = interactiveRows(question);
   const answer = flow.getAnswer(question.id);
   if (!answer) {
+    const defaultIdx = isStructuredQuestion(question) ? question.defaultIndexes[0] : undefined;
+    if (defaultIdx !== undefined) return defaultIdx;
     const recommended = primaryRecommendationIndex(question);
     return recommended ?? 0;
   }
   switch (answer.source) {
-    case "option":
-    case "yesno":
-      return answer.optionIndex;
-    case "options":
-      return answer.optionIndexes[0] ?? 0;
+    case "choice":
+      return answer.selections[0]?.optionIndex ?? 0;
     case "other":
       return rows.findIndex((row) => row.kind === "other");
     case "discuss":

package/{ui-rich.ts → src/ui/ui-rich.ts}

@@ -1,14 +1,19 @@
-// Rich questionnaire UI built on `ctx.ui.custom()`. Supports explicit choice,
-// multichoice, notes, other, discuss, preview, and review flows. Returns a
+// Rich questionnaire UI built on `ctx.ui.custom()`. Supports explicit choice
+// (single and multi-select), notes, other, discuss, preview, and review flows. Returns a
 // QuestionnaireOutcome whose terminal state is owned by the shared flow.
 
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import { type Component, Editor, type EditorTheme, type TUI } from "@mariozechner/pi-tui";
-import { QuestionnaireFlow } from "./flow.ts";
-import type { NormalizedQuestion, QuestionnaireOutcome } from "./types.ts";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type Component, Editor, type EditorTheme, type TUI } from "@earendil-works/pi-tui";
+import { QuestionnaireFlow } from "../flow.ts";
+import { renderOverlay } from "../render/ui-rich-render.ts";
+import type { NormalizedQuestionnaire, QuestionnaireOutcome } from "../types.ts";
 import { handleOverlayInput, onEditorSubmit } from "./ui-rich-handlers.ts";
-import { renderOverlay } from "./ui-rich-render.ts";
-import { initialSubMode, type OverlayState, selectedRowIndex } from "./ui-rich-state.ts";
+import {
+  initialSubMode,
+  type OverlayState,
+  selectedRowIndex,
+  textDefaultOrAnswer,
+} from "./ui-rich-state.ts";
 
 export interface RichCustomOptions {
   overlay?: boolean;
@@ -33,10 +38,10 @@ export interface RunRichOptions {
 }
 
 export async function runRichQuestionnaire(
-  questions: NormalizedQuestion[],
+  questionnaire: NormalizedQuestionnaire,
   opts: RunRichOptions,
 ): Promise<QuestionnaireOutcome | "unsupported"> {
-  const flow = new QuestionnaireFlow(questions);
+  const flow = new QuestionnaireFlow(questionnaire.questions, questionnaire.allowSkip);
   // Short-circuit before opening the overlay if we were already aborted.
   // Otherwise signal.addEventListener("abort", …) would never fire and the
   // overlay would stay open until the user dismissed it manually.
@@ -44,6 +49,10 @@ export async function runRichQuestionnaire(
     flow.abort();
     return flow.outcome();
   }
+  // pi-tui's declarative keybinding system is not used here — the overlay
+  // implements its own dynamic input handling because footer hints change
+  // per mode and question type (e.g. Space toggle in multi-select vs Enter
+  // confirm in choice).
   const promise = opts.ui.custom<QuestionnaireOutcome>((tui, theme, _kb, done) =>
     buildOverlay({ tui, theme, flow, signal: opts.signal, done }),
   );
@@ -70,8 +79,13 @@ function buildOverlay(args: BuildOverlayArgs): Component {
     noteTarget: undefined,
     cachedLines: undefined,
     cachedWidth: undefined,
+    maxHeight: 0,
   };
   const editor = new Editor(tui, makeEditorTheme(theme));
+  const initialQuestion = flow.currentQuestion;
+  if (initialQuestion?.type === "text") {
+    editor.setText(textDefaultOrAnswer(flow, initialQuestion));
+  }
   const refresh = () => {
     state.cachedLines = undefined;
     tui.requestRender();
@@ -94,8 +108,19 @@ function buildOverlay(args: BuildOverlayArgs): Component {
       if (state.cachedWidth !== width) {
         state.cachedLines = undefined;
         state.cachedWidth = width;
+        state.maxHeight = 0;
+      }
+      if (!state.cachedLines) {
+        state.cachedLines = renderOverlay({ width, theme, flow, state, editor });
+        // Stabilize height — prevent shrinkage that triggers pi-tui's
+        // viewport tracking bug with differential rendering.
+        if (state.cachedLines.length > state.maxHeight) {
+          state.maxHeight = state.cachedLines.length;
+        }
+        while (state.cachedLines.length < state.maxHeight) {
+          state.cachedLines.push("");
+        }
       }
-      if (!state.cachedLines) state.cachedLines = renderOverlay(width, theme, flow, state, editor);
       return state.cachedLines;
     },
     invalidate: () => {