@zhushanwen/pi-ask-user 0.0.1

package/src/__tests__/question-view.test.ts

@@ -0,0 +1,357 @@
+// src/__tests__/question-view.test.ts
+import { describe, expect, it } from "vitest";
+
+import { getSplitPaneWidths, renderQuestionView } from "../question-view";
+import { createQuestionState, type Question, type QuestionState, type ThemeLike } from "../types";
+
+const stubTheme: ThemeLike = {
+	fg: (_t: string, s: string) => s,
+	bg: (_t: string, s: string) => s,
+	bold: (s: string) => s,
+};
+
+const singleQ: Question = {
+	question: "Which database?",
+	options: [
+		{ label: "Postgres", description: "Battle-tested" },
+		{ label: "SQLite", description: "Embedded" },
+	],
+};
+
+const makeState = (over: Partial<QuestionState> = {}): QuestionState => ({
+	...createQuestionState(),
+	...over,
+});
+
+// Helper: join all lines for substring search
+const text = (lines: string[]): string => lines.join("\n");
+
+// ── Q-1 ~ Q-6: 基础渲染 ──────────────────────────────────
+describe("renderQuestionView — basics", () => {
+	it("Q-1: renders question text", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		expect(text(lines)).toContain("Which database?");
+	});
+
+	it("Q-2: renders all options + Other", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		const t = text(lines);
+		expect(t).toContain("Postgres");
+		expect(t).toContain("SQLite");
+		expect(t).toContain("Other");
+	});
+
+	it("Q-3: renders cursor > on first option", () => {
+		const lines = renderQuestionView(singleQ, makeState({ cursorIndex: 0 }), stubTheme, 60, true, "");
+		const t = text(lines);
+		expect(t).toContain(">");
+		expect(t).toContain("Postgres");
+	});
+
+	it("Q-4: renders single-select check on confirmed selection", () => {
+		const lines = renderQuestionView(singleQ, makeState({ selectedIndex: 1 }), stubTheme, 60, true, "");
+		expect(text(lines)).toContain("✓");
+		expect(text(lines)).toContain("SQLite");
+	});
+
+	it("Q-5: renders multi-select checkboxes", () => {
+		const multiQ: Question = {
+			question: "Which features?",
+			options: [{ label: "Auth" }, { label: "Search" }],
+			multiSelect: true,
+		};
+		const lines = renderQuestionView(
+			multiQ,
+			makeState({ selectedIndices: new Set([0]) }),
+			stubTheme,
+			60,
+			true,
+			"",
+		);
+		const t = text(lines);
+		expect(t).toContain("[✓]");
+		expect(t).toContain("[ ]");
+	});
+
+	it("Q-6: renders descriptions in muted", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		expect(text(lines)).toContain("Battle-tested");
+	});
+});
+
+// ── Q-7 ~ Q-14: 分屏 ────────────────────────────────────
+describe("renderQuestionView — split pane", () => {
+	it("Q-7: getSplitPaneWidths returns null on narrow terminal", () => {
+		expect(getSplitPaneWidths(60)).toBeNull();
+	});
+
+	it("Q-8: getSplitPaneWidths returns widths on wide terminal", () => {
+		const result = getSplitPaneWidths(100);
+		expect(result).not.toBeNull();
+		expect(result!.left).toBeGreaterThan(0);
+		expect(result!.right).toBeGreaterThan(0);
+	});
+
+	it("Q-12: getSplitPaneWidths null at boundary width=83", () => {
+		expect(getSplitPaneWidths(83)).toBeNull();
+	});
+
+	it("Q-13: getSplitPaneWidths non-null at boundary width=84", () => {
+		expect(getSplitPaneWidths(84)).not.toBeNull();
+	});
+
+	it("Q-9: split-pane left column hides descriptions", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 100, true, "");
+		const t = text(lines);
+		// In split mode, descriptions appear only in the right pane preview of the focused item.
+		// The focused item (cursorIndex=0=Postgres) shows "Battle-tested" in the right pane,
+		// but SQLite's "Embedded" should NOT appear (no single-column description blocks).
+		expect(t).toContain("Postgres");
+		expect(t).toContain("Battle-tested");
+		// SQLite label still present in left column, but its description "Embedded" not shown
+		// (only the focused option's description is previewed)
+		expect(t).toContain("SQLite");
+	});
+
+	it("Q-10: split-pane right pane shows focused option detail", () => {
+		const lines = renderQuestionView(singleQ, makeState({ cursorIndex: 1 }), stubTheme, 100, true, "");
+		const t = text(lines);
+		// Focused on SQLite → right pane should show SQLite's description
+		expect(t).toContain("Embedded");
+	});
+
+	it("Q-11: split-pane right pane on Other shows custom-answer hint", () => {
+		// cursorIndex = last option (Other) = 2
+		const lines = renderQuestionView(singleQ, makeState({ cursorIndex: 2 }), stubTheme, 100, true, "");
+		const t = text(lines);
+		expect(t).toContain("custom");
+	});
+
+	it("Q-14: single-column mode shows indented descriptions", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		// Both descriptions shown inline (single-column mode)
+		const t = text(lines);
+		expect(t).toContain("Battle-tested");
+		expect(t).toContain("Embedded");
+	});
+});
+
+// ── Q-15 ~ Q-17: Other 编辑器模式 ───────────────────────
+describe("renderQuestionView — Other editor mode", () => {
+	it("Q-15: freeform mode renders Other row in-place with draft + cursor", () => {
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ mode: "freeform", cursorIndex: 2 }),
+			stubTheme,
+			60,
+			true,
+			"my draft",
+		);
+		const t = text(lines);
+		// Other 行原地变 [ ] <input>█（freeform 模式不依赖 buildEditorBlock 独立编辑块）
+		expect(t).toContain("my draft");
+		expect(t).toContain("█");
+		// 不再独立 "Your answer" 提示行
+		expect(t).not.toContain("Your answer");
+	});
+
+	it("Q-16: Other with saved free-text shows checkmark + preview", () => {
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ cursorIndex: 2, freeTextValue: "saved text" }),
+			stubTheme,
+			60,
+			true,
+			"",
+		);
+		const t = text(lines);
+		expect(t).toContain("✓");
+		expect(t).toContain("saved text");
+	});
+
+	it("Q-17: Other row focused shows Enter hint (Tab now navigates tabs)", () => {
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ cursorIndex: 2 }),
+			stubTheme,
+			60,
+			true,
+			"",
+		);
+		// help 行：Other 焦点时显示 "Enter open editor"
+		expect(text(lines)).toContain("Enter open editor");
+	});
+
+	// ── Q-28 ~ Q-31: Other 多行换行（输入态 + 已保存预览） ──
+	it("Q-28: freeform 长输入超过屏宽时软换行，完整内容不丢失", () => {
+		const width = 30;
+		// lead = "> [ ] " (单选 box="  ") = 6 列 → avail = 24
+		const long = "x".repeat(60);
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ mode: "freeform", cursorIndex: 2 }),
+			stubTheme,
+			width,
+			true,
+			long,
+		);
+		const t = text(lines);
+		// 60 字符按 avail=24 换行 → 至少 3 行，且全部 60 个 x 都在输出里（不截断）
+		const xCount = t.split("").filter((c) => c === "x").length;
+		expect(xCount).toBe(60);
+		expect(lines.some((l) => l.includes("x"))).toBe(true);
+		// 光标仍在末尾出现
+		expect(t).toContain("█");
+		// 每个含 x 的行都不超过总宽 width（stubTheme 无 ANSI，长度=可见宽）
+		for (const l of lines) {
+			if (l.includes("x")) expect(l.length).toBeLessThanOrEqual(width);
+		}
+	});
+
+	it("Q-29: freeform 输入超 5 行时截断到 5 行并加省略号", () => {
+		const width = 30;
+		// avail=24，200 字符 → 9 行，超过 5 行上限
+		const huge = "y".repeat(200);
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ mode: "freeform", cursorIndex: 2 }),
+			stubTheme,
+			width,
+			true,
+			huge,
+		);
+		// 统计含 'y' 的行数 = input 渲染行数（应被截到 5 行）
+		const yLines = lines.filter((l) => l.includes("y"));
+		expect(yLines.length).toBe(5);
+		// 最后一行带省略号（表示还有更多，光标已被省略号取代）
+		expect(yLines[yLines.length - 1]).toContain("…");
+	});
+
+	it("Q-30: 已保存 freeText 预览超屏宽时多行换行展示", () => {
+		const width = 40;
+		// 预览 lead="     "(5 列) → avail=35；预览文本带引号
+		const long = "z".repeat(80);
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ cursorIndex: 2, freeTextValue: long }),
+			stubTheme,
+			width,
+			true,
+			"",
+		);
+		const t = text(lines);
+		// 80 个 z 全部展示（不再单行截断丢失）
+		const zCount = t.split("").filter((c) => c === "z").length;
+		expect(zCount).toBe(80);
+		// 预览首行带引号开头
+		expect(lines.some((l) => l.includes('"'))).toBe(true);
+	});
+
+	it("Q-31: 已保存 freeText 预览超 5 行时截断并加省略号", () => {
+		const width = 30;
+		// 预览 avail = 30-5 = 25，300 字符 → >5 行
+		const huge = "w".repeat(300);
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ cursorIndex: 2, freeTextValue: huge }),
+			stubTheme,
+			width,
+			true,
+			"",
+		);
+		const wLines = lines.filter((l) => l.includes("w"));
+		expect(wLines.length).toBe(5);
+		expect(wLines[wLines.length - 1]).toContain("…");
+	});
+});
+
+// ── Q-18 ~ Q-19: 评论模式 ───────────────────────────────
+describe("renderQuestionView — comment mode", () => {
+	it("Q-18: comment mode renders editor with note text", () => {
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ mode: "comment", selectedIndex: 0 }),
+			stubTheme,
+			60,
+			true,
+			"my note",
+		);
+		const t = text(lines);
+		expect(t.toLowerCase()).toContain("comment");
+		expect(t).toContain("my note");
+	});
+
+	it("Q-19: comment prompt includes (optional)", () => {
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ mode: "comment", selectedIndex: 0 }),
+			stubTheme,
+			60,
+			true,
+			"",
+		);
+		expect(text(lines)).toContain("(optional)");
+	});
+});
+
+// ── Q-20 ~ Q-23: 帮助行 ─────────────────────────────────
+describe("renderQuestionView — help line", () => {
+	it("Q-20: single-select help shows 'Enter select'", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		expect(text(lines)).toContain("Enter select");
+	});
+
+	it("Q-21: multi-select help shows 'Space toggle'", () => {
+		const multiQ: Question = {
+			question: "Pick",
+			options: [{ label: "A" }, { label: "B" }],
+			multiSelect: true,
+		};
+		const lines = renderQuestionView(multiQ, makeState(), stubTheme, 60, true, "");
+		expect(text(lines)).toContain("Space toggle");
+	});
+
+	it("Q-22: single question omits tab-switch hint", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		expect(text(lines)).not.toContain("switch tabs");
+	});
+
+	it("Q-23: multi question includes tab-switch hint", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, false, "");
+		expect(text(lines)).toContain("switch tabs");
+	});
+});
+
+// ── Q-24 ~ Q-25: 上下文 ─────────────────────────────────
+describe("renderQuestionView — context", () => {
+	it("Q-24: renders context when present", () => {
+		const q: Question = { ...singleQ, context: "Background info here" };
+		const lines = renderQuestionView(q, makeState(), stubTheme, 60, true, "");
+		expect(text(lines)).toContain("Background info here");
+	});
+
+	it("Q-25: no context field → no extra context text", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 60, true, "");
+		// No "context" label text in output (only question/options/help)
+		expect(text(lines)).toContain("Which database?");
+	});
+});
+
+// ── Q-26 ~ Q-27: 边界 ───────────────────────────────────
+describe("renderQuestionView — edge cases", () => {
+	it("Q-26: very narrow terminal width=20 does not crash", () => {
+		const lines = renderQuestionView(singleQ, makeState(), stubTheme, 20, true, "");
+		expect(lines.length).toBeGreaterThan(0);
+	});
+
+	it("Q-27: long option label gets truncated", () => {
+		const q: Question = {
+			question: "Q",
+			options: [{ label: "A".repeat(80), description: "desc" }, { label: "B" }],
+		};
+		const lines = renderQuestionView(q, makeState(), stubTheme, 40, true, "");
+		// Should not contain the full 80-char label on a 40-col terminal
+		const t = text(lines);
+		expect(t).not.toContain("A".repeat(80));
+	});
+});

package/src/__tests__/submit-view.test.ts

@@ -0,0 +1,192 @@
+// src/__tests__/submit-view.test.ts
+import { describe, expect, it } from "vitest";
+
+import { buildResult, getAnswerText, renderSubmitView } from "../submit-view";
+import { createQuestionState, type Question, type QuestionState, type ThemeLike } from "../types";
+
+const stubTheme: ThemeLike = {
+	fg: (_t: string, s: string) => s,
+	bg: (_t: string, s: string) => s,
+	bold: (s: string) => s,
+};
+
+const q1: Question = {
+	question: "Which DB?",
+	header: "Database",
+	options: [{ label: "Postgres" }, { label: "SQLite" }],
+};
+
+const makeState = (over: Partial<QuestionState> = {}): QuestionState => ({
+	...createQuestionState(),
+	...over,
+});
+
+// ── S-1 ~ S-4: renderSubmitView ──────────────────────────
+describe("renderSubmitView", () => {
+	it("S-1: shows 'Ready to submit' when all confirmed", () => {
+		const states = [makeState({ confirmed: true, selectedIndex: 0 })];
+		const lines = renderSubmitView([q1], states, stubTheme, 60);
+		expect(lines.some((l) => l.includes("Ready to submit"))).toBe(true);
+		expect(lines.some((l) => l.includes("All questions answered"))).toBe(true);
+	});
+
+	it("S-2: shows 'Unanswered' when not all confirmed", () => {
+		const states = [makeState({ confirmed: false })];
+		const lines = renderSubmitView([q1], states, stubTheme, 60);
+		expect(lines.some((l) => l.includes("Unanswered"))).toBe(true);
+		expect(lines.some((l) => l.includes("Database"))).toBe(true);
+	});
+
+	it("S-13: shows 'Still needed: <headers>' line when not all confirmed", () => {
+		// S-13 锁定未全确认时渲染的 'Still needed: <missing headers>' 行
+		const questions: Question[] = [
+			{ question: "Q1", header: "First", options: [{ label: "A" }, { label: "B" }] },
+			{ question: "Q2", header: "Second", options: [{ label: "X" }, { label: "Y" }] },
+		];
+		// Q1 已答，Q2 未答 → Still needed 应列出 Second
+		const states = [
+			makeState({ confirmed: true, selectedIndex: 0 }),
+			makeState({ confirmed: false }),
+		];
+		const lines = renderSubmitView(questions, states, stubTheme, 60);
+		const t = lines.join("\n");
+		expect(t).toContain("Still needed");
+		expect(t).toContain("Second");
+		expect(t).not.toContain("Still needed: First"); // First 已答，不谈入
+	});
+
+	it("S-3: lists answered header: answer", () => {
+		const states = [makeState({ confirmed: true, selectedIndex: 0 })];
+		const lines = renderSubmitView([q1], states, stubTheme, 60);
+		expect(lines.some((l) => l.includes("Database") && l.includes("Postgres"))).toBe(true);
+	});
+
+	it("S-4: shows dash for unanswered", () => {
+		const states = [makeState({ confirmed: false })];
+		const lines = renderSubmitView([q1], states, stubTheme, 60);
+		expect(lines.some((l) => l.includes("Database") && l.includes("—"))).toBe(true);
+	});
+
+	// S-13: 提示行已上移至组件级按钮栏（renderButtonBar）
+	it("S-13: submit view does not render its own submit/cancel hints (moved to button bar)", () => {
+		const states = [makeState({ confirmed: true, selectedIndex: 0 })];
+		const lines = renderSubmitView([q1], states, stubTheme, 60);
+		const t = lines.join("\n");
+		// 旧的内联提示不再由 submit-view 渲染（由 component.renderButtonBar 负责）
+		expect(t).not.toContain("switch tabs");
+		expect(t).not.toContain("Press Enter to submit");
+	});
+});
+
+// ── S-5 ~ S-10: getAnswerText ────────────────────────────
+describe("getAnswerText", () => {
+	it("S-5: single-select returns label", () => {
+		const s = makeState({ confirmed: true, selectedIndex: 0 });
+		expect(getAnswerText(q1, s)).toBe("Postgres");
+	});
+
+	it("S-6: multi-select returns labels joined in index order", () => {
+		const multiQ: Question = {
+			question: "Features",
+			multiSelect: true,
+			options: [{ label: "A" }, { label: "B" }, { label: "C" }],
+		};
+		const s = makeState({ confirmed: true, selectedIndices: new Set([0, 1]) });
+		expect(getAnswerText(multiQ, s)).toBe("A, B");
+	});
+
+	it("S-7: multi-select out-of-order toggle still sorts by index", () => {
+		const multiQ: Question = {
+			question: "Features",
+			multiSelect: true,
+			options: [{ label: "A" }, { label: "B" }, { label: "C" }],
+		};
+		// toggle order: 1, then 0, then 2 → Set may iterate 1,0,2 but output should be A, B, C
+		const s = makeState({ confirmed: true, selectedIndices: new Set([1, 0, 2]) });
+		expect(getAnswerText(multiQ, s)).toBe("A, B, C");
+	});
+
+	it("S-7b: multi-select out-of-range indices are filtered out (defensive branch)", () => {
+		// 锁定 getAnswerText 的防御性 .filter：selectedIndices 含越界 index（超出 options 范围）
+		// 时，q.options[idx]?.label 为 undefined，被过滤掉，不污染答案。
+		const multiQ: Question = {
+			question: "Features",
+			multiSelect: true,
+			options: [{ label: "A" }, { label: "B" }],
+		};
+		// index 5 越界（只有 2 个选项），应被过滤；只保留 A
+		const s = makeState({ confirmed: true, selectedIndices: new Set([0, 5]) });
+		expect(getAnswerText(multiQ, s)).toBe("A");
+	});
+
+	it("S-8: Other free-text appended", () => {
+		const s = makeState({ confirmed: true, selectedIndex: null, freeTextValue: "custom" });
+		expect(getAnswerText(q1, s)).toBe("custom");
+	});
+
+	it("S-9: comment appended with separator", () => {
+		const s = makeState({ confirmed: true, selectedIndex: 0, commentValue: "fast" });
+		expect(getAnswerText(q1, s)).toBe("Postgres — fast");
+	});
+
+	it("S-10: unconfirmed returns null", () => {
+		const s = makeState({ confirmed: false });
+		expect(getAnswerText(q1, s)).toBeNull();
+	});
+
+	it("S-11: confirmed but empty (no selection, no freeText, empty multi) returns null", () => {
+		// S-11 锁定防御分支：confirmed=true 但无任何答案内容时 getAnswerText 返回 null
+		// 场景：单选 selectedIndex=null + freeTextValue=null
+		const sEmptySingle = makeState({ confirmed: true, selectedIndex: null, freeTextValue: null });
+		expect(getAnswerText(q1, sEmptySingle)).toBeNull();
+		// 场景：多选 selectedIndices 空集合
+		const multiQ: Question = {
+			question: "Features",
+			multiSelect: true,
+			options: [{ label: "A" }, { label: "B" }],
+		};
+		const sEmptyMulti = makeState({ confirmed: true, selectedIndices: new Set<number>() });
+		expect(getAnswerText(multiQ, sEmptyMulti)).toBeNull();
+	});
+
+	it("S-9b: multi-select + comment combined", () => {
+		const multiQ: Question = {
+			question: "Features",
+			multiSelect: true,
+			allowComment: true,
+			options: [{ label: "A" }, { label: "B" }],
+		};
+		const s = makeState({
+			confirmed: true,
+			selectedIndices: new Set([0, 1]),
+			commentValue: "nice",
+		});
+		expect(getAnswerText(multiQ, s)).toBe("A, B — nice");
+	});
+});
+
+// ── S-11 ~ S-12: buildResult ─────────────────────────────
+describe("buildResult", () => {
+	it("S-11: builds answers for all confirmed questions", () => {
+		const questions = [q1];
+		const states = [makeState({ confirmed: true, selectedIndex: 1 })];
+		const result = buildResult(questions, states);
+		expect(result.cancelled).toBe(false);
+		expect(result.answers["Which DB?"]).toBe("SQLite");
+		expect(result.questions).toBe(questions);
+	});
+
+	it("S-12: omits unconfirmed questions from answers", () => {
+		const questions: Question[] = [
+			{ question: "Q1", header: "H1", options: [{ label: "A" }, { label: "B" }] },
+			{ question: "Q2", header: "H2", options: [{ label: "X" }, { label: "Y" }] },
+		];
+		const states = [
+			makeState({ confirmed: true, selectedIndex: 0 }),
+			makeState({ confirmed: false }),
+		];
+		const result = buildResult(questions, states);
+		expect(result.answers["Q1"]).toBe("A");
+		expect(result.answers["Q2"]).toBeUndefined();
+	});
+});

package/src/__tests__/types.test.ts

@@ -0,0 +1,71 @@
+// src/__tests__/types.test.ts
+import { describe, expect, it } from "vitest";
+
+import {
+	createQuestionState,
+	InputSchema,
+	OTHER_LABEL,
+	QuestionSchema,
+	SPLIT_PANE_MIN_WIDTH,
+} from "../types";
+
+describe("types", () => {
+	it("InputSchema accepts valid single question", () => {
+		const valid = {
+			questions: [
+				{
+					question: "Which DB?",
+					options: [{ label: "Postgres" }, { label: "SQLite" }],
+				},
+			],
+		};
+		expect(InputSchema).toBeDefined();
+		// Schema is a typebox object; verify it has the questions property structure
+		expect((InputSchema as { properties: Record<string, unknown> }).properties.questions).toBeDefined();
+		expect(valid.questions).toHaveLength(1);
+	});
+
+	it("OTHER_LABEL constant is the free-text option label", () => {
+		expect(OTHER_LABEL).toBe("Other");
+	});
+
+	it("SPLIT_PANE_MIN_WIDTH is 84", () => {
+		expect(SPLIT_PANE_MIN_WIDTH).toBe(84);
+	});
+
+	it("createQuestionState returns initial state with mode 'options'", () => {
+		const s = createQuestionState();
+		expect(s.cursorIndex).toBe(0);
+		expect(s.selectedIndex).toBeNull();
+		expect(s.selectedIndices).toBeInstanceOf(Set);
+		expect(s.confirmed).toBe(false);
+		expect(s.freeTextValue).toBeNull();
+		expect(s.commentValue).toBeNull();
+		expect(s.mode).toBe("options");
+	});
+
+	// T-5: 每次调用返回独立的 Set 实例
+	it("createQuestionState returns independent Set each call", () => {
+		const s1 = createQuestionState();
+		const s2 = createQuestionState();
+		s1.selectedIndices.add(0);
+		expect(s2.selectedIndices.has(0)).toBe(false);
+		expect(s1.selectedIndices).not.toBe(s2.selectedIndices);
+	});
+
+	// T-6: QuestionSchema options 数量约束
+	it("QuestionSchema enforces options minItems=2, maxItems=4", () => {
+		const opts = (QuestionSchema as { properties: { options: { minItems: number; maxItems: number } } })
+			.properties.options;
+		expect(opts.minItems).toBe(2);
+		expect(opts.maxItems).toBe(4);
+	});
+
+	// T-7: InputSchema questions 数量约束
+	it("InputSchema enforces questions minItems=1, maxItems=4", () => {
+		const qs = (InputSchema as { properties: { questions: { minItems: number; maxItems: number } } })
+			.properties.questions;
+		expect(qs.minItems).toBe(1);
+		expect(qs.maxItems).toBe(4);
+	});
+});