@garygentry/feature-forge 0.2.13 → 0.3.0

package/adapters/pi/extensions/ask-user-question/locales/ru.json

@@ -0,0 +1,27 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. TUI symbols (↑/↓, ⚠) and key names (Enter, Esc, Tab, Space, n) are universal CLI conventions and stay untranslated.",
+
+  "sentinel.other": "Введите что-нибудь.",
+  "sentinel.next": "Далее",
+
+  "submit.label": "Отправить ответы",
+  "submit.cancel": "Отмена",
+
+  "hint.enter": "Enter — выбрать",
+  "hint.navigate": "↑/↓ — навигация",
+  "hint.toggle": "Space — переключить",
+  "hint.notes": "n — добавить заметки",
+  "hint.tab": "Tab — следующий вопрос",
+  "hint.cancel": "Esc — отменить",
+
+  "review.heading": "Проверьте свои ответы",
+  "review.ready": "Готовы отправить ответы?",
+  "review.incomplete": "⚠ Ответьте на оставшиеся вопросы перед отправкой:",
+
+  "preview.no_preview": "Предпросмотр недоступен",
+  "preview.notes_affordance": "Заметки: нажмите n, чтобы добавить заметки",
+  "notes.header": "Заметки:",
+
+  "rpc.multi_instructions": "Введите номера всех подходящих вариантов через запятую (например, \"1,3\") или введите свой ответ текстом.",
+  "rpc.custom_answer_title": "Введите свой ответ:"
+}

package/adapters/pi/extensions/ask-user-question/locales/uk.json

@@ -0,0 +1,27 @@
+{
+  "_meta.notes": "Auto-translated draft. Native-speaker review welcome via PR. TUI symbols (↑/↓, ⚠) and key names (Enter, Esc, Tab, Space, n) are universal CLI conventions and stay untranslated.",
+
+  "sentinel.other": "Введіть щось.",
+  "sentinel.next": "Далі",
+
+  "submit.label": "Надіслати відповіді",
+  "submit.cancel": "Скасувати",
+
+  "hint.enter": "Enter — обрати",
+  "hint.navigate": "↑/↓ — навігація",
+  "hint.toggle": "Space — перемкнути",
+  "hint.notes": "n — додати нотатки",
+  "hint.tab": "Tab — наступне питання",
+  "hint.cancel": "Esc — скасувати",
+
+  "review.heading": "Перегляньте свої відповіді",
+  "review.ready": "Готові надіслати відповіді?",
+  "review.incomplete": "⚠ Дайте відповіді на решту питань перед надсиланням:",
+
+  "preview.no_preview": "Попередній перегляд недоступний",
+  "preview.notes_affordance": "Нотатки: натисніть n, щоб додати нотатки",
+  "notes.header": "Нотатки:",
+
+  "rpc.multi_instructions": "Введіть номери всіх відповідних варіантів через кому (наприклад, \"1,3\") або введіть власну відповідь текстом.",
+  "rpc.custom_answer_title": "Введіть свою відповідь:"
+}

package/adapters/pi/extensions/ask-user-question/locales/zh.json

@@ -0,0 +1,29 @@
+{
+  "_meta.notes": "中文翻译。欢迎中文母语者通过 PR 审校。TUI 符号（↑/↓、⚠）为通用 CLI 约定，保持原文不译。Enter、Space 采用中文惯用说法（回车、空格）；Esc、Tab、Ctrl、n 等保留原文。",
+
+  "sentinel.other": "输入内容",
+  "sentinel.next": "下一个",
+
+  "submit.label": "提交答案",
+  "submit.cancel": "取消",
+
+  "hint.enter": "回车选择",
+  "hint.navigate": "↑/↓ 导航",
+  "hint.toggle": "空格切换",
+  "hint.notes": "按 n 添加备注",
+  "hint.tab": "Tab 切换问题",
+  "hint.collapse": "Ctrl+] 折叠",
+  "hint.expand_line": "Ctrl+] 展开 · Esc 取消",
+  "hint.cancel": "Esc 取消",
+
+  "review.heading": "检查你的答案",
+  "review.ready": "准备提交答案了吗？",
+  "review.incomplete": "⚠ 提交前请先回答以下问题：",
+
+  "preview.no_preview": "暂无预览",
+  "preview.notes_affordance": "备注：按 n 添加",
+  "notes.header": "备注：",
+
+  "rpc.multi_instructions": "输入所有适用选项的编号，用逗号分隔（例如 \"1,3\"），或直接输入自定义回答。",
+  "rpc.custom_answer_title": "输入你的回答："
+}

package/adapters/pi/extensions/ask-user-question/reconcile.ts

@@ -0,0 +1,49 @@
+// GENERATED — DO NOT EDIT. Source: adapter-src/pi/extensions/ask-user-question/reconcile.ts
+// Regenerate with: python3 scripts/build-adapters.py
+/**
+ * reconcile — mid-session lifecycle reconciliation for ask_user_question.
+ *
+ * Strips or re-adds the tool to the active set so it is invisible to the LLM
+ * in non-interactive runs (no UI) and present in interactive ones. Mirrors the
+ * advisor's reconcileAdvisorTool / registerAdvisorBeforeAgentStart pattern
+ * (packages/rpiv-advisor/advisor/handlers.ts), simplified: ask_user_question's
+ * only gating signal is ctx.hasUI (no model or executor blocklist), so it
+ * reads the flag directly and omits the notify.
+ *
+ * RPC hosts (ctx.mode === "rpc": VSCode pendant, Zed, Paseo) are deliberately
+ * NOT stripped: since PR #100 the tool renders there via the select/input
+ * dialog walker (rpc-fallback.ts), so hasUI is the honest signal again. The
+ * brief period where RPC was stripped (872ef1c) predates that fallback.
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { ASK_USER_QUESTION_TOOL_NAME } from "./ask-user-question.js";
+
+/**
+ * Strip-or-restore `ask_user_question` to match `ctx.hasUI`. Reads the active
+ * tool list itself. Idempotent: when the tool is already in the right state it
+ * leaves the active set (and sibling tools) untouched.
+ */
+export function reconcileAskUserQuestionTool(pi: ExtensionAPI, ctx: ExtensionContext): void {
+	const active = pi.getActiveTools();
+	const hasTool = active.includes(ASK_USER_QUESTION_TOOL_NAME);
+	// !hasUI → strip so the tool never reaches the LLM's tool list in
+	// non-interactive runs; hasUI → restore. The in-handler guards in
+	// ask-user-question.ts (!hasUI, and the custom()-undefined → dialog-walker /
+	// no_custom_ui backstop) remain as one-turn backstops if a future Pi change
+	// reorders the tool-list snapshot ahead of before_agent_start, or a host
+	// reports hasUI without any usable rendering primitive.
+	if (!ctx.hasUI && hasTool) {
+		pi.setActiveTools(active.filter((n) => n !== ASK_USER_QUESTION_TOOL_NAME));
+	} else if (ctx.hasUI && !hasTool) {
+		pi.setActiveTools([...active, ASK_USER_QUESTION_TOOL_NAME]);
+	}
+}
+
+/**
+ * Attach the reconciler to `before_agent_start` so the active set is fixed up
+ * before each turn's tool-list snapshot is read. Safe to call once at load.
+ */
+export function registerAskUserQuestionReconciler(pi: ExtensionAPI): void {
+	pi.on("before_agent_start", (_event, ctx) => reconcileAskUserQuestionTool(pi, ctx));
+}

package/adapters/pi/extensions/ask-user-question/rpc-fallback.ts

@@ -0,0 +1,168 @@
+// GENERATED — DO NOT EDIT. Source: adapter-src/pi/extensions/ask-user-question/rpc-fallback.ts
+// Regenerate with: python3 scripts/build-adapters.py
+/**
+ * RPC / dialog-primitive fallback for `ask_user_question`.
+ *
+ * The canonical TUI path (`ctx.ui.custom()`) renders a tabbed overlay that
+ * needs a real terminal. RPC-mode hosts (the VSCode pendant, ACP clients such
+ * as Zed or Paseo) report `hasUI: true` because pi's dialog sub-protocol
+ * (`extension_ui_request`/`extension_ui_response`) works, but `ui.custom()`
+ * resolves `undefined` without rendering anything (issue #78). `ui.select()`
+ * and `ui.input()` ARE functional there — the host renders them natively — so
+ * this module walks the questions sequentially with those primitives and
+ * returns the same `QuestionnaireResult` shapes the TUI produces, feeding the
+ * shared `buildQuestionnaireResponse` envelope.
+ *
+ * Parity trade-offs vs the TUI, inherent to the select/input API surface: no
+ * side-by-side preview pane (previews are folded into the prompt title), no
+ * tabbed multi-question review (one dialog per question), and multi-select is
+ * a free-text numbers input instead of checkbox rows. The "Type something."
+ * escape is preserved on both variants — multi-select treats any non-index
+ * input as a typed custom answer — matching
+ * `ROW_INTENT_META.other.autoAppendOnMultiSelect`.
+ */
+
+import { displayLabel, t } from "./state/i18n-bridge.js";
+import type { QuestionAnswer, QuestionData, QuestionnaireResult, QuestionParams } from "./tool/types.js";
+
+/**
+ * Canonical-English fallbacks; resolved through `t()` at dialog time so the
+ * live locale applies (top-level `const x = t(...)` would bake load-time
+ * English in — see i18n-bridge.ts). The sentinel row label comes from
+ * `displayLabel("other")` — same source as the TUI row.
+ */
+const MULTI_SELECT_INSTRUCTIONS =
+	'Enter the numbers of all that apply, comma-separated (e.g. "1,3"), or type a custom answer as plain text.';
+const CUSTOM_ANSWER_TITLE = "Type your answer:";
+const MULTI_SELECT_PLACEHOLDER = "1,3";
+
+/** Longest preview slice folded into a select title before truncation. */
+const MAX_PREVIEW_CHARS = 600;
+
+/**
+ * The dialog-primitive slice of `ExtensionUIContext` this walker needs.
+ * Structural on purpose: the pinned pi 0.74 peer types predate `ctx.mode`,
+ * and jiti transpiles without type-checking — `hasDialogUI` is the runtime
+ * gate that makes the shape trustworthy.
+ */
+export type DialogUI = {
+	select: (title: string, options: string[]) => Promise<string | undefined>;
+	input: (title: string, placeholder?: string) => Promise<string | undefined>;
+};
+
+/** True when the host implements the select/input dialog primitives. */
+export function hasDialogUI(ui: unknown): ui is DialogUI {
+	const u = ui as Partial<Record<"select" | "input", unknown>> | null | undefined;
+	return typeof u?.select === "function" && typeof u?.input === "function";
+}
+
+type Option = QuestionData["options"][number];
+
+function formatOptionLine(option: Option, index: number): string {
+	return `${index + 1}. ${option.label} — ${option.description}`;
+}
+
+/**
+ * Parse a user-entered (or select-returned) "N…" token to a 0-based option
+ * index. `parseInt` reads the leading digits of "2. B — b" as 2; NaN and
+ * out-of-range fail the bounds check and return null.
+ */
+function parseIndex(token: string, count: number): number | null {
+	const i = Number.parseInt(token, 10) - 1;
+	return i >= 0 && i < count ? i : null;
+}
+
+/** Previews folded into the select title — RPC has no side-by-side pane. */
+function buildPreviewBlock(question: QuestionData): string {
+	const blocks = question.options.flatMap((o, i) =>
+		o.preview && o.preview.length > 0
+			? [`--- ${i + 1}. ${o.label} preview ---\n${o.preview.slice(0, MAX_PREVIEW_CHARS)}`]
+			: [],
+	);
+	return blocks.length > 0 ? `\n\n${blocks.join("\n\n")}` : "";
+}
+
+/**
+ * Walk the questionnaire one native dialog at a time. Dismissing any dialog
+ * (the primitive resolves `undefined`) cancels the whole questionnaire —
+ * mirroring Esc in the TUI — and the shared envelope emits DECLINE. A
+ * `QuestionAnswer` is produced per question otherwise, so the envelope is
+ * identical to the TUI path's.
+ */
+export async function runRpcQuestionnaire(ui: DialogUI, params: QuestionParams): Promise<QuestionnaireResult> {
+	const answers: QuestionAnswer[] = [];
+	for (let qi = 0; qi < params.questions.length; qi++) {
+		const q = params.questions[qi];
+		const header = q.header ? `[${q.header}] ` : "";
+		const answer = q.multiSelect ? await askMultiSelect(ui, q, qi, header) : await askSingleSelect(ui, q, qi, header);
+		if (answer === undefined) return { answers, cancelled: true };
+		answers.push(answer);
+	}
+	return { answers, cancelled: false };
+}
+
+/** `undefined` means the user dismissed the dialog (cancel the questionnaire). */
+async function askSingleSelect(
+	ui: DialogUI,
+	q: QuestionData,
+	questionIndex: number,
+	header: string,
+): Promise<QuestionAnswer | undefined> {
+	const options = q.options.map(formatOptionLine);
+	options.push(`${q.options.length + 1}. ${displayLabel("other")}`);
+	const chosen = await ui.select(`${header}${q.question}${buildPreviewBlock(q)}`, options);
+	if (chosen == null) return undefined;
+	const idx = parseIndex(chosen, options.length);
+	// A host returning something outside the offered list is indistinguishable
+	// from a dismissal — treat it as one rather than fabricate an answer.
+	if (idx == null) return undefined;
+	if (idx < q.options.length) {
+		const o = q.options[idx];
+		return {
+			questionIndex,
+			question: q.question,
+			kind: "option",
+			answer: o.label,
+			preview: o.preview && o.preview.length > 0 ? o.preview : undefined,
+		};
+	}
+	// "Type something." sentinel → free-text follow-up.
+	const typed = await ui.input(`${header}${q.question}\n\n${t("rpc.custom_answer_title", CUSTOM_ANSWER_TITLE)}`, "");
+	if (typed == null) return undefined;
+	return { questionIndex, question: q.question, kind: "custom", answer: typed };
+}
+
+/** `undefined` means the user dismissed the dialog (cancel the questionnaire). */
+async function askMultiSelect(
+	ui: DialogUI,
+	q: QuestionData,
+	questionIndex: number,
+	header: string,
+): Promise<QuestionAnswer | undefined> {
+	const list = q.options.map(formatOptionLine).join("\n");
+	const value = await ui.input(
+		`${header}${q.question}\n\n${list}\n\n${t("rpc.multi_instructions", MULTI_SELECT_INSTRUCTIONS)}`,
+		MULTI_SELECT_PLACEHOLDER,
+	);
+	if (value == null) return undefined;
+	const trimmed = value.trim();
+	if (trimmed.length === 0) {
+		// Deliberate empty commit — same as pressing "Next" with nothing toggled.
+		return { questionIndex, question: q.question, kind: "multi", answer: null, selected: [] };
+	}
+	const tokens = trimmed.split(/[,\s]+/).filter((tok) => tok.length > 0);
+	const indices = tokens.map((tok) => (/^\d+\.?$/.test(tok) ? parseIndex(tok, q.options.length) : null));
+	if (indices.every((i): i is number => i != null)) {
+		const selected: string[] = [];
+		for (const i of indices) {
+			const label = q.options[i].label;
+			if (!selected.includes(label)) selected.push(label);
+		}
+		return { questionIndex, question: q.question, kind: "multi", answer: null, selected };
+	}
+	// Any non-index token (words, or an out-of-range number like "13" for three
+	// options) means the user typed an answer, not a selection. Preserve it
+	// verbatim as a custom answer instead of silently dropping their input —
+	// this is also the multi-select "Type something." escape.
+	return { questionIndex, question: q.question, kind: "custom", answer: trimmed };
+}

package/adapters/pi/extensions/ask-user-question/state/build-questionnaire.ts

@@ -0,0 +1,302 @@
+// GENERATED — DO NOT EDIT. Source: adapter-src/pi/extensions/ask-user-question/state/build-questionnaire.ts
+// Regenerate with: python3 scripts/build-adapters.py
+import { getMarkdownTheme, type Theme } from "@earendil-works/pi-coding-agent";
+import { Input } from "@earendil-works/pi-tui";
+import type { QuestionData } from "../tool/types.js";
+import {
+	type BoundGlobalBinding,
+	type BoundPerTabBinding,
+	globalBinding,
+	perTabBinding,
+} from "../view/component-binding.js";
+import { MultiSelectView } from "../view/components/multi-select-view.js";
+import { OptionListView } from "../view/components/option-list-view.js";
+import { PreviewBlockRenderer } from "../view/components/preview/preview-block-renderer.js";
+import { crossTabLeftWidthWithDonation } from "../view/components/preview/preview-layout-decider.js";
+import type { PreviewPaneProps } from "../view/components/preview/preview-pane.js";
+import { PreviewPane } from "../view/components/preview/preview-pane.js";
+import { SubmitPicker } from "../view/components/submit-picker.js";
+import { TabBar } from "../view/components/tab-bar.js";
+import type { WrappingSelectItem, WrappingSelectTheme } from "../view/components/wrapping-select.js";
+import { DialogView } from "../view/dialog-builder.js";
+import { QuestionnairePropsAdapter } from "../view/props-adapter.js";
+import type { StatefulView } from "../view/stateful-view.js";
+import type { TabBodyHeights, TabComponents } from "../view/tab-components.js";
+import type { PerTabSelector } from "./selectors/contract.js";
+import { selectActivePreviewPaneIndex } from "./selectors/derivations.js";
+import {
+	selectDialogProps,
+	selectMultiSelectProps,
+	selectOptionListProps,
+	selectPreviewPaneProps,
+	selectSubmitPickerProps,
+	selectTabBarProps,
+} from "./selectors/projections.js";
+import type { QuestionnaireState } from "./state.js";
+
+export interface QuestionnaireBuildConfig {
+	tui: { terminal: { columns: number; rows: number }; requestRender(): void };
+	theme: Theme;
+	questions: readonly QuestionData[];
+	itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;
+	isMulti: boolean;
+	initialState: QuestionnaireState;
+	getCurrentTab: () => number;
+}
+
+export interface QuestionnaireBuilt {
+	adapter: QuestionnairePropsAdapter;
+	notesInput: Input;
+	inlineInput: Input;
+	render: (width: number) => string[];
+	invalidate: () => void;
+}
+
+interface HeightComputers {
+	global: (width: number) => number;
+	current: (width: number) => number;
+}
+
+function previewBodyHeights(pane: PreviewPane): (width: number) => TabBodyHeights {
+	return (width) => ({
+		current: pane.naturalHeight(width),
+		max: pane.maxNaturalHeight(width),
+	});
+}
+
+function multiSelectBodyHeights(view: MultiSelectView): (width: number) => TabBodyHeights {
+	return (width) => {
+		const h = view.naturalHeight(width);
+		return { current: h, max: h };
+	};
+}
+
+const isActiveTab: PerTabSelector<boolean> = (s, ctx) =>
+	ctx.i === selectActivePreviewPaneIndex(s.currentTab, ctx.totalQuestions);
+
+/**
+ * Pure factory: assembles every TUI component, the props adapter, and a
+ * lifecycle handle. Session-state dependencies arrive via `getCurrentTab` and
+ * the `inputBuffer` cell. Initial paint is delegated to
+ * `adapter.apply(initialState)` (called by the session at construction-end);
+ * no selector is invoked here.
+ */
+export function buildQuestionnaire(config: QuestionnaireBuildConfig): QuestionnaireBuilt {
+	return new QuestionnaireBuilder(config).build();
+}
+
+/**
+ * Programming-by-intention assembly: each private method names one
+ * construction step from `build()`. Read top-down; the class is build-only and
+ * discarded once the handle is returned.
+ */
+class QuestionnaireBuilder {
+	private readonly tui: QuestionnaireBuildConfig["tui"];
+	private readonly theme: Theme;
+	private readonly questions: readonly QuestionData[];
+	private readonly itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;
+	private readonly isMulti: boolean;
+	private readonly initialState: QuestionnaireState;
+	private readonly getCurrentTab: () => number;
+
+	private readonly selectTheme: WrappingSelectTheme;
+	private readonly markdownTheme = getMarkdownTheme();
+	private readonly notesInput = new Input();
+	private readonly inlineInput = new Input();
+	private readonly getTerminalWidth = () => this.tui.terminal.columns;
+	private readonly getTerminalRows = () => this.tui.terminal.rows;
+
+	constructor(config: QuestionnaireBuildConfig) {
+		this.tui = config.tui;
+		this.theme = config.theme;
+		this.questions = config.questions;
+		this.itemsByTab = config.itemsByTab;
+		this.isMulti = config.isMulti;
+		this.initialState = config.initialState;
+		this.getCurrentTab = config.getCurrentTab;
+
+		this.selectTheme = this.makeSelectTheme();
+	}
+
+	build(): QuestionnaireBuilt {
+		const tabs = this.buildTabComponents();
+		this.injectGlobalLeftWidth(tabs);
+		const submitPicker = this.buildSubmitPicker();
+		const tabBar = this.buildTabBar();
+		const heights = this.buildHeightComputers(tabs);
+		const dialog = this.buildDialog(tabs, submitPicker, tabBar, heights);
+		const globalBindings = this.buildGlobalBindings(dialog, submitPicker, tabBar);
+		const perTabBindings = this.buildPerTabBindings();
+		const adapter = this.buildAdapter(tabs, globalBindings, perTabBindings);
+		return this.handle(adapter, dialog);
+	}
+
+	private makeSelectTheme(): WrappingSelectTheme {
+		const t = this.theme;
+		return {
+			selectedText: (s) => t.fg("accent", t.bold(s)),
+			description: (s) => t.fg("muted", s),
+			scrollInfo: (s) => t.fg("dim", s),
+		};
+	}
+
+	private buildTabComponents(): ReadonlyArray<TabComponents> {
+		return this.questions.map((q, i) => this.buildTabFor(q, i));
+	}
+
+	private buildTabFor(question: QuestionData, index: number): TabComponents {
+		const optionList = new OptionListView({
+			items: this.itemsByTab[index] ?? [],
+			theme: this.selectTheme,
+		});
+		const previewBlock = new PreviewBlockRenderer({
+			question,
+			theme: this.theme,
+			markdownTheme: this.markdownTheme,
+		});
+		const preview = new PreviewPane({
+			question,
+			getTerminalWidth: this.getTerminalWidth,
+			optionListView: optionList,
+			previewBlock,
+		});
+		const multiSelect = question.multiSelect ? new MultiSelectView(this.theme, question) : undefined;
+		const bodyHeights = this.buildBodyHeights(question, preview, multiSelect);
+		return { optionList, preview, multiSelect, bodyHeights };
+	}
+
+	private buildBodyHeights(
+		question: QuestionData,
+		preview: PreviewPane,
+		multiSelect: MultiSelectView | undefined,
+	): (width: number) => TabBodyHeights {
+		return question.multiSelect ? multiSelectBodyHeights(multiSelect!) : previewBodyHeights(preview);
+	}
+
+	/**
+	 * Compute cross-tab max adaptive left width and inject into each PreviewPane.
+	 * Mirrors buildHeightComputers pattern — iterates all tabs, takes max.
+	 * Called after buildTabComponents, before buildDialog (so setGlobalLeftWidth
+	 * is set before any rendering occurs).
+	 */
+	private injectGlobalLeftWidth(tabs: ReadonlyArray<TabComponents>): void {
+		const questions = this.questions;
+		const itemsByTab = this.itemsByTab;
+		const tabsDescriptor = questions.map((q) => ({ multiSelect: q.multiSelect }));
+		const globalLeftWidth = (paneWidth: number): number =>
+			crossTabLeftWidthWithDonation(tabsDescriptor, itemsByTab, questions, paneWidth);
+		for (const tab of tabs) {
+			tab.preview.setGlobalLeftWidth(globalLeftWidth);
+		}
+	}
+
+	private buildSubmitPicker(): SubmitPicker | undefined {
+		return this.isMulti ? new SubmitPicker(this.theme) : undefined;
+	}
+
+	private buildTabBar(): TabBar | undefined {
+		return this.isMulti ? new TabBar(this.theme) : undefined;
+	}
+
+	private buildHeightComputers(tabs: ReadonlyArray<TabComponents>): HeightComputers {
+		const global = (width: number): number => {
+			let max = 0;
+			for (const tab of tabs) {
+				const h = tab.bodyHeights(width).max;
+				if (h > max) max = h;
+			}
+			return Math.max(1, max);
+		};
+		const current = (width: number): number => {
+			const idx = Math.min(this.getCurrentTab(), tabs.length - 1);
+			return Math.max(0, tabs[idx]?.bodyHeights(width).current ?? 0);
+		};
+		return { global, current };
+	}
+
+	private pickInitialActivePreview(tabs: ReadonlyArray<TabComponents>): StatefulView<PreviewPaneProps> {
+		const idx = selectActivePreviewPaneIndex(this.initialState.currentTab, this.questions.length);
+		return tabs[idx]?.preview ?? tabs[0]!.preview;
+	}
+
+	private buildDialog(
+		tabs: ReadonlyArray<TabComponents>,
+		submitPicker: SubmitPicker | undefined,
+		tabBar: TabBar | undefined,
+		heights: HeightComputers,
+	): DialogView {
+		return new DialogView(
+			{
+				theme: this.theme,
+				questions: this.questions,
+				tabBar,
+				notesInput: this.notesInput,
+				isMulti: this.isMulti,
+				tabsByIndex: tabs,
+				submitPicker,
+				getBodyHeight: heights.global,
+				getCurrentBodyHeight: heights.current,
+				getTerminalRows: this.getTerminalRows,
+			},
+			{ state: this.initialState, activePreviewPane: this.pickInitialActivePreview(tabs) },
+		);
+	}
+
+	private buildGlobalBindings(
+		dialog: DialogView,
+		submitPicker: SubmitPicker | undefined,
+		tabBar: TabBar | undefined,
+	): ReadonlyArray<BoundGlobalBinding> {
+		return [
+			globalBinding({ component: dialog, select: selectDialogProps }),
+			...(submitPicker ? [globalBinding({ component: submitPicker, select: selectSubmitPickerProps })] : []),
+			...(tabBar ? [globalBinding({ component: tabBar, select: selectTabBarProps })] : []),
+		];
+	}
+
+	private buildPerTabBindings(): ReadonlyArray<BoundPerTabBinding> {
+		return [
+			perTabBinding({
+				resolve: (tab) => tab.optionList,
+				predicate: isActiveTab,
+				select: selectOptionListProps,
+			}),
+			perTabBinding({
+				resolve: (tab) => tab.preview,
+				predicate: isActiveTab,
+				select: selectPreviewPaneProps,
+			}),
+			perTabBinding({
+				resolve: (tab) => tab.multiSelect,
+				select: selectMultiSelectProps,
+			}),
+		];
+	}
+
+	private buildAdapter(
+		tabs: ReadonlyArray<TabComponents>,
+		globalBindings: ReadonlyArray<BoundGlobalBinding>,
+		perTabBindings: ReadonlyArray<BoundPerTabBinding>,
+	): QuestionnairePropsAdapter {
+		return new QuestionnairePropsAdapter({
+			tui: this.tui,
+			questions: this.questions,
+			itemsByTab: this.itemsByTab,
+			tabsByIndex: tabs,
+			inlineInput: this.inlineInput,
+			globalBindings,
+			perTabBindings,
+			extraInvalidatables: [this.notesInput],
+		});
+	}
+
+	private handle(adapter: QuestionnairePropsAdapter, dialog: DialogView): QuestionnaireBuilt {
+		return {
+			adapter,
+			notesInput: this.notesInput,
+			inlineInput: this.inlineInput,
+			render: (w) => dialog.render(w),
+			invalidate: () => adapter.invalidate(),
+		};
+	}
+}

package/adapters/pi/extensions/ask-user-question/state/i18n-bridge.ts

@@ -0,0 +1,53 @@
+// GENERATED — DO NOT EDIT. Source: adapter-src/pi/extensions/ask-user-question/state/i18n-bridge.ts
+// Regenerate with: python3 scripts/build-adapters.py
+/**
+ * i18n bridge for rpiv-ask-user-question — single thin import surface so every
+ * call site routes through one place. Backed by `@juicesharp/rpiv-i18n`'s SDK
+ * when available; degrades to canonical-English fallbacks when not.
+ *
+ * - `t(key, fallback)` is `scope("@juicesharp/rpiv-ask-user-question")` if the
+ *   SDK is installed (live `/languages` updates propagate). If the SDK is
+ *   missing (standalone install without rpiv-i18n), `t` is an identity
+ *   passthrough that returns the inline English fallback at every call site,
+ *   so the extension stays online with English UI.
+ * - `displayLabel(kind)` resolves a sentinel kind to its locale-aware label,
+ *   with the canonical English `ROW_INTENT_META[kind].label` as fallback so
+ *   nothing renders blank if the namespace isn't registered.
+ *
+ * Strings are registered ONCE at extension load (see ../index.ts). Call sites
+ * MUST use this module at render time — never bake the result into a top-level
+ * `const X = displayLabel(...)`.
+ *
+ * Reserved-label validation stays English-locked: `RESERVED_LABEL_SET` checks
+ * the canonical `ROW_INTENT_META[kind].label`, never `displayLabel(kind)`.
+ */
+
+import { ROW_INTENT_META, type SentinelKind } from "./row-intent.js";
+
+export const I18N_NAMESPACE = "@juicesharp/rpiv-ask-user-question";
+
+type ScopeFn = (key: string, fallback: string) => string;
+type I18nSDK = { scope: (namespace: string) => ScopeFn };
+
+// Prefer the live SDK if installed: closures it returns track the active
+// locale, so /languages picker propagates to our render call sites. If the
+// SDK isn't installed (standalone install of this extension without
+// rpiv-i18n), the dynamic import fails, every t(key, fallback) returns the
+// canonical English literal, and the extension stays online.
+//
+// Top-level await is required so a synchronous `t(...)` call from any
+// downstream module sees the resolved scope; ESM module loading awaits this
+// before evaluating any importer.
+let scopeImpl: ScopeFn;
+try {
+	const sdk = (await import("@juicesharp/rpiv-i18n")) as I18nSDK;
+	scopeImpl = sdk.scope(I18N_NAMESPACE);
+} catch {
+	scopeImpl = (_key, fallback) => fallback;
+}
+
+export const t: ScopeFn = scopeImpl;
+
+export function displayLabel(kind: SentinelKind): string {
+	return t(`sentinel.${kind}`, ROW_INTENT_META[kind].label);
+}