@xynogen/pix-core 0.2.4 → 0.3.0

package/src/tool/ask/rpc.ts

@@ -1,84 +0,0 @@
-import type { Params } from "./schema.js";
-import { SENTINEL_FREEFORM } from "./schema.js";
-import type { QuestionAnswer, QuestionnaireResult } from "./types.js";
-
-// ── RPC / non-TUI fallback ─────────────────────────────────────────────
-// Used when ctx.hasUI is false (headless / JSON / print mode).
-
-export async function rpcFallback(
-	ui: { select: Function; input: Function },
-	params: Params,
-): Promise<QuestionnaireResult> {
-	const answers: QuestionAnswer[] = [];
-	let cancelled = false;
-
-	for (let i = 0; i < params.questions.length; i++) {
-		const q = params.questions[i]!;
-		const header = q.header;
-
-		if (q.multiSelect) {
-			const lines = q.options.map(
-				(o, idx) => `${idx + 1}. ${o.label} — ${o.description}`,
-			);
-			const raw = await ui.input(
-				`${header}: ${q.question}\n\n${lines.join("\n")}\n\nEnter numbers separated by commas:`,
-				"e.g. 1,3",
-			);
-			if (raw == null) {
-				cancelled = true;
-				break;
-			}
-			const indices = String(raw)
-				.split(",")
-				.map((s) => Number(s.trim()))
-				.filter((n) => n >= 1 && n <= q.options.length);
-			const selected = indices.map((n) => q.options[n - 1]?.label);
-			if (selected.length > 0) {
-				answers.push({
-					questionIndex: i,
-					question: q.question,
-					kind: "multi",
-					answer: null,
-					selected,
-				});
-			} else {
-				cancelled = true;
-				break;
-			}
-		} else {
-			const items = q.options.map((o) => `${o.label} — ${o.description}`);
-			items.push(SENTINEL_FREEFORM);
-			const chosen = await ui.select(`${header}: ${q.question}`, items);
-			if (chosen == null) {
-				cancelled = true;
-				break;
-			}
-			if (chosen === SENTINEL_FREEFORM) {
-				const text = await ui.input(q.question, "Type your answer...");
-				if (text == null) {
-					cancelled = true;
-					break;
-				}
-				answers.push({
-					questionIndex: i,
-					question: q.question,
-					kind: "custom",
-					answer: String(text),
-				});
-			} else {
-				const opt = q.options.find(
-					(o) =>
-						chosen === o.label || `${o.label} — ${o.description}` === chosen,
-				)!;
-				answers.push({
-					questionIndex: i,
-					question: q.question,
-					kind: "option",
-					answer: opt?.label ?? String(chosen),
-				});
-			}
-		}
-	}
-
-	return { answers, cancelled };
-}

package/src/tool/ask/schema.ts

@@ -1,69 +0,0 @@
-import { type Static, Type } from "typebox";
-
-// ── Constants ──────────────────────────────────────────────────────────
-
-export const MAX_QUESTIONS = 4;
-export const MIN_OPTIONS = 2;
-export const MAX_OPTIONS = 4;
-export const MAX_HEADER_LENGTH = 16;
-export const MAX_LABEL_LENGTH = 60;
-
-export const SENTINEL_FREEFORM = "Type something.";
-export const SENTINEL_CHAT = "Chat about this";
-export const SENTINEL_NEXT = "Next";
-
-export const SPLIT_PANE_MIN_WIDTH = 84;
-export const SEPARATOR = " │ ";
-
-// ── Schemas ────────────────────────────────────────────────────────────
-
-export const OptionSchema = Type.Object({
-	label: Type.String({
-		maxLength: MAX_LABEL_LENGTH,
-		description: `MAX ${MAX_LABEL_LENGTH} CHARACTERS. Display text for this option. Concise (1-5 words).`,
-	}),
-	description: Type.String({
-		description: "Explanation of what this option means or trade-offs.",
-	}),
-	preview: Type.Optional(
-		Type.String({
-			description:
-				"Optional markdown preview for side-by-side layout (single-select only).",
-		}),
-	),
-});
-
-export const QuestionSchema = Type.Object({
-	question: Type.String({
-		description: "Clear, specific question ending with ?",
-	}),
-	header: Type.String({
-		maxLength: MAX_HEADER_LENGTH,
-		description: `MAX ${MAX_HEADER_LENGTH} CHARS — short chip/tag. E.g. "Auth method", "Approach".`,
-	}),
-	options: Type.Array(OptionSchema, {
-		minItems: MIN_OPTIONS,
-		maxItems: MAX_OPTIONS,
-		description:
-			"2-4 options. 'Type something.' and 'Chat about this' are auto-appended.",
-	}),
-	multiSelect: Type.Optional(
-		Type.Boolean({
-			default: false,
-			description:
-				"Allow multiple selections. Suppresses 'Type something.' row.",
-		}),
-	),
-});
-
-export const QuestionsSchema = Type.Array(QuestionSchema, {
-	minItems: 1,
-	maxItems: MAX_QUESTIONS,
-	description: "1-4 questions",
-});
-
-export const ParamsSchema = Type.Object({ questions: QuestionsSchema });
-
-export type OptionData = Static<typeof OptionSchema>;
-export type QuestionData = Static<typeof QuestionSchema>;
-export type Params = Static<typeof ParamsSchema>;

package/src/tool/ask/single-select-layout.test.ts

@@ -1,124 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { renderSingleSelectRows } from "./single-select-layout";
-
-describe("renderSingleSelectRows", () => {
-	test("wraps long option titles instead of truncating them away", () => {
-		const rows = renderSingleSelectRows({
-			options: [
-				{
-					title:
-						"I want help with a coding or implementation task that involves changing, creating, reviewing, refactoring, or understanding code in a project",
-				},
-			],
-			selectedIndex: 0,
-			width: 40,
-			allowFreeform: false,
-		});
-
-		expect(rows.length).toBeGreaterThan(1);
-		expect(rows.map((r) => r.line).join(" ")).toContain("implementation task");
-		expect(rows.map((r) => r.line).join(" ")).toContain("understanding code");
-	});
-
-	test("wraps long descriptions under their option instead of clipping them", () => {
-		const rows = renderSingleSelectRows({
-			options: [
-				{
-					title: "Planning help",
-					description:
-						"Choose this if you are still deciding what to do, want a plan first, need architecture guidance, or want to evaluate alternatives before touching code.",
-				},
-			],
-			selectedIndex: 0,
-			width: 44,
-			allowFreeform: false,
-		});
-
-		const rendered = rows
-			.map((r) => r.line)
-			.join(" ")
-			.replace(/\s+/g, " ")
-			.trim();
-		expect(rendered).toContain("want a plan first");
-		expect(rendered).toContain("before touching code");
-		expect(rows.length).toBeGreaterThan(2);
-	});
-
-	test("caps the rendered rows and keeps the selected option visible when content is taller than the viewport", () => {
-		const rows = renderSingleSelectRows({
-			options: [
-				{
-					title:
-						"I want help with a coding or implementation task that involves changing, creating, reviewing, refactoring, or understanding code in a project",
-					description:
-						"Choose this if your main goal is to build something, fix code, understand existing code, add a feature, improve architecture, write tests, or get help with development work.",
-				},
-				{
-					title:
-						"I want help troubleshooting, debugging, diagnosing, reproducing, isolating, or explaining a bug, failure, regression, flaky test, unexpected behavior, runtime error, build issue, deployment problem, configuration mistake, performance bottleneck, or environment-specific issue",
-					description:
-						"Choose this if something is broken, inconsistent, failing, slow, confusing, or behaving differently than expected and you want systematic help narrowing it down.",
-				},
-			],
-			selectedIndex: 1,
-			width: 44,
-			allowFreeform: false,
-			maxRows: 6,
-		});
-
-		expect(rows.length).toBeLessThanOrEqual(6);
-		expect(
-			rows
-				.map((r) => r.line)
-				.join(" ")
-				.replace(/\s+/g, " "),
-		).toContain("troubleshooting");
-	});
-
-	test("does not duplicate a short word after wrapping an exact-width long word", () => {
-		const rows = renderSingleSelectRows({
-			options: [
-				{
-					title: "Alpha",
-					description: "hi aaaaaaaaaaaaaaaa",
-				},
-			],
-			selectedIndex: 0,
-			width: 12,
-			allowFreeform: false,
-		});
-
-		expect(
-			rows.map((r) => r.line).filter((line) => line.trim() === "hi"),
-		).toHaveLength(1);
-		expect(
-			rows.map((r) => r.line).filter((line) => line.trim() === "aaaaaaaa"),
-		).toHaveLength(2);
-	});
-
-	test("marks selected item rows as selected in annotated output", () => {
-		const rows = renderSingleSelectRows({
-			options: [
-				{ title: "Alpha" },
-				{
-					title:
-						"Beta with a very long title that should wrap to multiple lines when rendered",
-				},
-				{ title: "Gamma" },
-			],
-			selectedIndex: 1,
-			width: 30,
-			allowFreeform: false,
-		});
-
-		const selectedRows = rows.filter((r) => r.selected);
-		const nonSelectedRows = rows.filter((r) => !r.selected);
-
-		expect(selectedRows.length).toBeGreaterThan(1);
-		for (const row of selectedRows) {
-			expect(row.line).not.toContain("Alpha");
-			expect(row.line).not.toContain("Gamma");
-		}
-		expect(nonSelectedRows.length).toBeGreaterThan(0);
-	});
-});

package/src/tool/ask/single-select-layout.ts

@@ -1,237 +0,0 @@
-export interface QuestionOption {
-	title: string;
-	description?: string;
-}
-
-export interface AnnotatedRow {
-	line: string;
-	selected: boolean;
-}
-
-export interface RenderSingleSelectRowsParams {
-	options: QuestionOption[];
-	selectedIndex: number;
-	width: number;
-	allowFreeform: boolean;
-	allowComment?: boolean;
-	commentEnabled?: boolean;
-	maxRows?: number;
-	hideDescriptions?: boolean;
-}
-
-function wrapText(text: string, width: number): string[] {
-	const normalized = text.replace(/\s+/g, " ").trim();
-	if (!normalized) return [""];
-	if (width <= 1) return normalized.split("");
-
-	const words = normalized.split(" ");
-	const lines: string[] = [];
-	let current = "";
-
-	for (const word of words) {
-		if (!current) {
-			if (word.length <= width) {
-				current = word;
-			} else {
-				for (let i = 0; i < word.length; i += width) {
-					lines.push(word.slice(i, i + width));
-				}
-			}
-			continue;
-		}
-
-		const candidate = `${current} ${word}`;
-		if (candidate.length <= width) {
-			current = candidate;
-			continue;
-		}
-
-		lines.push(current);
-		if (word.length <= width) {
-			current = word;
-		} else {
-			current = "";
-			for (let i = 0; i < word.length; i += width) {
-				const chunk = word.slice(i, i + width);
-				if (chunk.length === width || i + width < word.length)
-					lines.push(chunk);
-				else current = chunk;
-			}
-		}
-	}
-
-	if (current) lines.push(current);
-	return lines;
-}
-
-function padLine(prefix: string, content: string): string {
-	return `${prefix}${content}`.trimEnd();
-}
-
-interface ItemBlock {
-	itemIndex: number;
-	lines: string[];
-}
-
-type ListItem =
-	| { type: "option"; option: QuestionOption }
-	| { type: "comment-toggle"; option: QuestionOption }
-	| { type: "freeform"; option: QuestionOption };
-
-function buildItemBlocks(
-	options: QuestionOption[],
-	width: number,
-	allowFreeform: boolean,
-	allowComment: boolean,
-	commentEnabled: boolean,
-	selectedIndex: number,
-	hideDescriptions = false,
-): ItemBlock[] {
-	const normalizedWidth = Math.max(12, width);
-	const freeformLabel = "Type something. — Enter a custom response";
-	const commentToggleLabel = `${commentEnabled ? "[✓]" : "[ ]"} Add extra context after selection`;
-	const allItems: ListItem[] = options.map((option) => ({
-		type: "option",
-		option,
-	}));
-	if (allowComment) {
-		allItems.push({
-			type: "comment-toggle",
-			option: { title: commentToggleLabel },
-		});
-	}
-	if (allowFreeform) {
-		allItems.push({ type: "freeform", option: { title: freeformLabel } });
-	}
-
-	return allItems.map((item, itemIndex) => {
-		const pointer = itemIndex === selectedIndex ? "→" : " ";
-		const lines: string[] = [];
-
-		if (item.type === "comment-toggle" || item.type === "freeform") {
-			const prefix = `${pointer}   `;
-			const wrapped = wrapText(
-				item.option.title,
-				Math.max(8, normalizedWidth - prefix.length),
-			);
-			wrapped.forEach((line, lineIndex) => {
-				lines.push(
-					padLine(lineIndex === 0 ? prefix : " ".repeat(prefix.length), line),
-				);
-			});
-			return { itemIndex, lines };
-		}
-
-		const numberPrefix = `${pointer} ${itemIndex + 1}. `;
-		const continuationPrefix = " ".repeat(numberPrefix.length);
-		const titleLines = wrapText(
-			item.option.title,
-			Math.max(8, normalizedWidth - numberPrefix.length),
-		);
-		titleLines.forEach((line, lineIndex) => {
-			lines.push(
-				padLine(lineIndex === 0 ? numberPrefix : continuationPrefix, line),
-			);
-		});
-
-		if (item.option.description && !hideDescriptions) {
-			const descriptionPrefix = "      ";
-			const descriptionLines = wrapText(
-				item.option.description,
-				Math.max(8, normalizedWidth - descriptionPrefix.length),
-			);
-			descriptionLines.forEach((line) => {
-				lines.push(padLine(descriptionPrefix, line));
-			});
-		}
-
-		return { itemIndex, lines };
-	});
-}
-
-function flatten(blocks: ItemBlock[], selectedIndex: number): AnnotatedRow[] {
-	return blocks.flatMap((block) =>
-		block.lines.map((line) => ({
-			line,
-			selected: block.itemIndex === selectedIndex,
-		})),
-	);
-}
-
-export function renderSingleSelectRows({
-	options,
-	selectedIndex,
-	width,
-	allowFreeform,
-	allowComment = false,
-	commentEnabled = false,
-	maxRows,
-	hideDescriptions,
-}: RenderSingleSelectRowsParams): AnnotatedRow[] {
-	const itemCount =
-		options.length + (allowComment ? 1 : 0) + (allowFreeform ? 1 : 0);
-	const blocks = buildItemBlocks(
-		options,
-		width,
-		allowFreeform,
-		allowComment,
-		commentEnabled,
-		selectedIndex,
-		hideDescriptions,
-	);
-	const allRows = flatten(blocks, selectedIndex);
-
-	if (
-		!Number.isFinite(maxRows) ||
-		!maxRows ||
-		maxRows <= 0 ||
-		allRows.length <= maxRows
-	) {
-		return allRows;
-	}
-
-	const safeMaxRows = Math.max(1, Math.floor(maxRows));
-	const selectedBlock = blocks[selectedIndex] ?? blocks[0];
-	if (!selectedBlock) return [];
-
-	const indicator = `  (${selectedIndex + 1}/${itemCount})`;
-	const availableRows = safeMaxRows > 1 ? safeMaxRows - 1 : 1;
-
-	if (selectedBlock.lines.length >= availableRows) {
-		const visible = selectedBlock.lines.slice(0, availableRows).map((line) => ({
-			line,
-			selected: true,
-		}));
-		if (safeMaxRows > 1) visible.push({ line: indicator, selected: false });
-		return visible.slice(0, safeMaxRows);
-	}
-
-	let start = selectedIndex;
-	let end = selectedIndex + 1;
-	let usedRows = selectedBlock.lines.length;
-
-	while (true) {
-		const nextCanFit =
-			end < blocks.length &&
-			usedRows + blocks[end]?.lines.length <= availableRows;
-		if (nextCanFit) {
-			usedRows += blocks[end]?.lines.length;
-			end += 1;
-			continue;
-		}
-
-		const prevCanFit =
-			start > 0 && usedRows + blocks[start - 1]?.lines.length <= availableRows;
-		if (prevCanFit) {
-			start -= 1;
-			usedRows += blocks[start]?.lines.length;
-			continue;
-		}
-
-		break;
-	}
-
-	const visible = flatten(blocks.slice(start, end), selectedIndex);
-	visible.push({ line: indicator, selected: false });
-	return visible.slice(0, safeMaxRows);
-}

package/src/tool/ask/types.ts

@@ -1,17 +0,0 @@
-// ── Answer & result types ──────────────────────────────────────────────
-
-export type AnswerKind = "option" | "custom" | "chat" | "multi";
-
-export interface QuestionAnswer {
-	questionIndex: number;
-	question: string;
-	kind: AnswerKind;
-	answer: string | null;
-	selected?: string[];
-	preview?: string;
-}
-
-export interface QuestionnaireResult {
-	answers: QuestionAnswer[];
-	cancelled: boolean;
-}