march-cli 0.1.21 → 0.1.22

package/src/cli/input/keybindings.mjs

@@ -1,96 +1,96 @@
-import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
-
-export const DEFAULT_KEYBINDINGS = Object.freeze({
-  abort: "Esc",
-  interrupt: "Ctrl+C",
-  toggleMode: "Tab",
-  cycleThinking: "Shift+Tab",
-  thinkingSelector: "Ctrl+T",
-  modelSelector: "Ctrl+L",
-  externalEditor: "Ctrl+G",
-  toggleToolOutput: "Ctrl+O",
-  toggleShellDrawer: "Alt+S",
-  nextShell: "Alt+N",
-  shellScrollUp: "Alt+K",
-  shellScrollDown: "Alt+J",
-  outputScrollUp: "PageUp",
-  outputScrollDown: "PageDown",
-  pasteImage: "Alt+V",
-});
-
-export const KEYBINDING_ACTIONS = Object.freeze({
-  abort: "Abort current turn; cancel retry wait",
-  interrupt: "Abort current turn; press twice to exit when idle",
-  toggleMode: "Toggle Do/Discuss mode",
-  cycleThinking: "Open thinking selector",
-  thinkingSelector: "Open thinking selector",
-  modelSelector: "Open model selector",
-  externalEditor: "Open external editor ($VISUAL or $EDITOR)",
-  toggleToolOutput: "Toggle tool output collapsed/expanded",
-  toggleShellDrawer: "Toggle right-side shell pane",
-  nextShell: "Select next shell in pane",
-  shellScrollUp: "Scroll shell pane up",
-  shellScrollDown: "Scroll shell pane down",
-  outputScrollUp: "Scroll output buffer up",
-  outputScrollDown: "Scroll output buffer down",
-  pasteImage: "Paste clipboard image as attachment",
-});
-
-export function loadKeybindings(cwd) {
-  return loadKeybindingsFromPath(resolve(cwd, ".march", "keybindings.json"));
-}
-
-export function loadKeybindingsFromPath(path) {
-  if (!existsSync(path)) {
-    return { keybindings: { ...DEFAULT_KEYBINDINGS }, diagnostics: [] };
-  }
-  try {
-    const parsed = JSON.parse(readFileSync(path, "utf8"));
-    return normalizeKeybindings(parsed, path);
-  } catch (err) {
-    return {
-      keybindings: { ...DEFAULT_KEYBINDINGS },
-      diagnostics: [{ type: "warning", message: `Failed to load keybindings.json: ${err.message}`, path }],
-    };
-  }
-}
-
-export function normalizeKeybindings(parsed, path = "keybindings.json") {
-  const diagnostics = [];
-  const keybindings = { ...DEFAULT_KEYBINDINGS };
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    return {
-      keybindings,
-      diagnostics: [{ type: "warning", message: "keybindings.json must be an object", path }],
-    };
-  }
-
-  for (const [action, key] of Object.entries(parsed)) {
-    if (!Object.hasOwn(KEYBINDING_ACTIONS, action)) {
-      diagnostics.push({ type: "warning", message: `Unknown keybinding action: ${action}`, path });
-      continue;
-    }
-    if (!isSupportedKey(key)) {
-      diagnostics.push({ type: "warning", message: `Unsupported keybinding for ${action}: ${String(key)}`, path });
-      continue;
-    }
-    keybindings[action] = key;
-  }
-
-  return { keybindings, diagnostics };
-}
-
-export function formatKeybindingLines(keybindings = DEFAULT_KEYBINDINGS) {
-  return Object.entries(KEYBINDING_ACTIONS).map(([action, description]) =>
-    `  ${padKey(keybindings[action] ?? DEFAULT_KEYBINDINGS[action])} ${description}`
-  );
-}
-
-function isSupportedKey(key) {
-  return typeof key === "string" && /^(Esc|Tab|Shift\+Tab|Ctrl\+[A-Z]|Alt\+[A-Z]|PageUp|PageDown)$/.test(key);
-}
-
-function padKey(key) {
-  return key.padEnd(10, " ");
-}
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+export const DEFAULT_KEYBINDINGS = Object.freeze({
+  abort: "Esc",
+  interrupt: "Ctrl+C",
+  toggleMode: "Tab",
+  cycleThinking: "Shift+Tab",
+  thinkingSelector: "Ctrl+T",
+  modelSelector: "Ctrl+L",
+  externalEditor: "Ctrl+G",
+  toggleToolOutput: "Ctrl+O",
+  toggleShellDrawer: "Alt+S",
+  nextShell: "Alt+N",
+  shellScrollUp: "Alt+K",
+  shellScrollDown: "Alt+J",
+  outputScrollUp: "PageUp",
+  outputScrollDown: "PageDown",
+  pasteImage: "Alt+V",
+});
+
+export const KEYBINDING_ACTIONS = Object.freeze({
+  abort: "Abort current turn; cancel retry wait",
+  interrupt: "Abort current turn; press twice to exit when idle",
+  toggleMode: "Toggle Do/Discuss mode",
+  cycleThinking: "Open thinking selector",
+  thinkingSelector: "Open thinking selector",
+  modelSelector: "Open model selector",
+  externalEditor: "Open external editor ($VISUAL or $EDITOR)",
+  toggleToolOutput: "Toggle tool output collapsed/expanded",
+  toggleShellDrawer: "Toggle right-side shell pane",
+  nextShell: "Select next shell in pane",
+  shellScrollUp: "Scroll shell pane up",
+  shellScrollDown: "Scroll shell pane down",
+  outputScrollUp: "Scroll output buffer up",
+  outputScrollDown: "Scroll output buffer down",
+  pasteImage: "Paste clipboard image as attachment",
+});
+
+export function loadKeybindings(cwd) {
+  return loadKeybindingsFromPath(resolve(cwd, ".march", "keybindings.json"));
+}
+
+export function loadKeybindingsFromPath(path) {
+  if (!existsSync(path)) {
+    return { keybindings: { ...DEFAULT_KEYBINDINGS }, diagnostics: [] };
+  }
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    return normalizeKeybindings(parsed, path);
+  } catch (err) {
+    return {
+      keybindings: { ...DEFAULT_KEYBINDINGS },
+      diagnostics: [{ type: "warning", message: `Failed to load keybindings.json: ${err.message}`, path }],
+    };
+  }
+}
+
+export function normalizeKeybindings(parsed, path = "keybindings.json") {
+  const diagnostics = [];
+  const keybindings = { ...DEFAULT_KEYBINDINGS };
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return {
+      keybindings,
+      diagnostics: [{ type: "warning", message: "keybindings.json must be an object", path }],
+    };
+  }
+
+  for (const [action, key] of Object.entries(parsed)) {
+    if (!Object.hasOwn(KEYBINDING_ACTIONS, action)) {
+      diagnostics.push({ type: "warning", message: `Unknown keybinding action: ${action}`, path });
+      continue;
+    }
+    if (!isSupportedKey(key)) {
+      diagnostics.push({ type: "warning", message: `Unsupported keybinding for ${action}: ${String(key)}`, path });
+      continue;
+    }
+    keybindings[action] = key;
+  }
+
+  return { keybindings, diagnostics };
+}
+
+export function formatKeybindingLines(keybindings = DEFAULT_KEYBINDINGS) {
+  return Object.entries(KEYBINDING_ACTIONS).map(([action, description]) =>
+    `  ${padKey(keybindings[action] ?? DEFAULT_KEYBINDINGS[action])} ${description}`
+  );
+}
+
+function isSupportedKey(key) {
+  return typeof key === "string" && /^(Esc|Tab|Shift\+Tab|Ctrl\+[A-Z]|Alt\+[A-Z]|PageUp|PageDown)$/.test(key);
+}
+
+function padKey(key) {
+  return key.padEnd(10, " ");
+}

package/src/cli/input/mode-state.mjs

@@ -1,43 +1,43 @@
-export const MODES = Object.freeze({
-  DO: "do",
-  DISCUSS: "discuss",
-});
-
-export function createModeState({ initial = MODES.DO } = {}) {
-  let mode = normalizeMode(initial);
-  return {
-    get: () => mode,
-    toggle() {
-      mode = mode === MODES.DO ? MODES.DISCUSS : MODES.DO;
-      return mode;
-    },
-    set(nextMode) {
-      mode = normalizeMode(nextMode);
-      return mode;
-    },
-  };
-}
-
-export function appendModeReminder(prompt, mode = MODES.DO) {
-  return `${prompt}\n\n${formatModeReminder(mode)}`;
-}
-
-export function formatModeLabel(mode = MODES.DO) {
-  return normalizeMode(mode) === MODES.DISCUSS ? "Discuss" : "Do";
-}
-
-export function formatModeReminder(mode = MODES.DO) {
-  if (normalizeMode(mode) === MODES.DISCUSS) {
-    return "<mode>\n" +
-      "You are in discuss mode. Do not edit files, write files, apply patches, commit, or run commands that modify system state. " +
-      "You may inspect, analyze, ask clarifying questions, and propose a plan.\n" +
-      "</mode>";
-  }
-  return "<mode>\n" +
-    "You are in do mode. You may implement changes when the user asks for execution, following normal permissions and project rules.\n" +
-    "</mode>";
-}
-
-function normalizeMode(mode) {
-  return mode === MODES.DISCUSS ? MODES.DISCUSS : MODES.DO;
-}
+export const MODES = Object.freeze({
+  DO: "do",
+  DISCUSS: "discuss",
+});
+
+export function createModeState({ initial = MODES.DO } = {}) {
+  let mode = normalizeMode(initial);
+  return {
+    get: () => mode,
+    toggle() {
+      mode = mode === MODES.DO ? MODES.DISCUSS : MODES.DO;
+      return mode;
+    },
+    set(nextMode) {
+      mode = normalizeMode(nextMode);
+      return mode;
+    },
+  };
+}
+
+export function appendModeReminder(prompt, mode = MODES.DO) {
+  return `${prompt}\n\n${formatModeReminder(mode)}`;
+}
+
+export function formatModeLabel(mode = MODES.DO) {
+  return normalizeMode(mode) === MODES.DISCUSS ? "Discuss" : "Do";
+}
+
+export function formatModeReminder(mode = MODES.DO) {
+  if (normalizeMode(mode) === MODES.DISCUSS) {
+    return "<mode>\n" +
+      "You are in discuss mode. Do not edit files, write files, apply patches, commit, or run commands that modify system state. " +
+      "You may inspect, analyze, ask clarifying questions, and propose a plan.\n" +
+      "</mode>";
+  }
+  return "<mode>\n" +
+    "You are in do mode. You may implement changes when the user asks for execution, following normal permissions and project rules.\n" +
+    "</mode>";
+}
+
+function normalizeMode(mode) {
+  return mode === MODES.DISCUSS ? MODES.DISCUSS : MODES.DO;
+}

package/src/cli/input/prompt-templates.mjs

@@ -1,84 +1,84 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { basename, extname, join, resolve } from "node:path";
-
-const TEMPLATE_EXTENSIONS = new Set([".md", ".txt"]);
-const TEMPLATE_NAME_RE = /^[A-Za-z][A-Za-z0-9_-]*$/;
-
-export function loadPromptTemplates(cwd) {
-  return loadPromptTemplatesFromDir(resolve(cwd, ".march", "templates"));
-}
-
-export function loadPromptTemplatesFromDir(dir) {
-  if (!existsSync(dir)) return { templates: [], diagnostics: [] };
-
-  const templates = [];
-  const diagnostics = [];
-  for (const entry of safeReadDir(dir, diagnostics)) {
-    if (!entry.isFile()) continue;
-    const ext = extname(entry.name);
-    if (!TEMPLATE_EXTENSIONS.has(ext)) continue;
-    const name = basename(entry.name, ext);
-    const path = join(dir, entry.name);
-    if (!TEMPLATE_NAME_RE.test(name)) {
-      diagnostics.push({ type: "warning", message: `Skipped invalid template name: ${entry.name}`, path });
-      continue;
-    }
-    try {
-      templates.push({ name, path, body: readFileSync(path, "utf8") });
-    } catch (err) {
-      diagnostics.push({ type: "warning", message: `Failed to read template ${entry.name}: ${err.message}`, path });
-    }
-  }
-  templates.sort((a, b) => a.name.localeCompare(b.name));
-  return { templates, diagnostics };
-}
-
-export function expandPromptTemplate(input, templates = []) {
-  const match = input.match(/^\/([A-Za-z][A-Za-z0-9_-]*)(?:\s+([\s\S]*))?$/);
-  if (!match) return { type: "none" };
-  const template = templates.find((item) => item.name === match[1]);
-  if (!template) return { type: "none" };
-  const rawArgs = (match[2] || "").trim();
-  return {
-    type: "template",
-    name: template.name,
-    prompt: renderPromptTemplate(template.body, rawArgs),
-  };
-}
-
-export function renderPromptTemplate(body, rawArgs = "") {
-  const args = splitTemplateArgs(rawArgs);
-  return body.replace(/\{\{\s*(args|input|\d+)\s*\}\}/g, (_match, token) => {
-    if (token === "args" || token === "input") return rawArgs;
-    return args[Number(token) - 1] ?? "";
-  }).trim();
-}
-
-export function formatPromptTemplateLines(templates = [], diagnostics = []) {
-  const lines = ["Prompt templates:"];
-  if (templates.length === 0) {
-    lines.push("  (none)");
-  } else {
-    for (const template of templates) lines.push(`  /${template.name}`);
-  }
-  if (diagnostics.length > 0) {
-    lines.push("Template diagnostics:");
-    for (const diagnostic of diagnostics) {
-      lines.push(`  - ${diagnostic.type ?? "warning"}: ${diagnostic.message}`);
-    }
-  }
-  return lines;
-}
-
-function safeReadDir(dir, diagnostics) {
-  try {
-    return readdirSync(dir, { withFileTypes: true });
-  } catch (err) {
-    diagnostics.push({ type: "warning", message: `Failed to read templates directory: ${err.message}`, path: dir });
-    return [];
-  }
-}
-
-function splitTemplateArgs(rawArgs) {
-  return rawArgs ? rawArgs.split(/\s+/).filter(Boolean) : [];
-}
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { basename, extname, join, resolve } from "node:path";
+
+const TEMPLATE_EXTENSIONS = new Set([".md", ".txt"]);
+const TEMPLATE_NAME_RE = /^[A-Za-z][A-Za-z0-9_-]*$/;
+
+export function loadPromptTemplates(cwd) {
+  return loadPromptTemplatesFromDir(resolve(cwd, ".march", "templates"));
+}
+
+export function loadPromptTemplatesFromDir(dir) {
+  if (!existsSync(dir)) return { templates: [], diagnostics: [] };
+
+  const templates = [];
+  const diagnostics = [];
+  for (const entry of safeReadDir(dir, diagnostics)) {
+    if (!entry.isFile()) continue;
+    const ext = extname(entry.name);
+    if (!TEMPLATE_EXTENSIONS.has(ext)) continue;
+    const name = basename(entry.name, ext);
+    const path = join(dir, entry.name);
+    if (!TEMPLATE_NAME_RE.test(name)) {
+      diagnostics.push({ type: "warning", message: `Skipped invalid template name: ${entry.name}`, path });
+      continue;
+    }
+    try {
+      templates.push({ name, path, body: readFileSync(path, "utf8") });
+    } catch (err) {
+      diagnostics.push({ type: "warning", message: `Failed to read template ${entry.name}: ${err.message}`, path });
+    }
+  }
+  templates.sort((a, b) => a.name.localeCompare(b.name));
+  return { templates, diagnostics };
+}
+
+export function expandPromptTemplate(input, templates = []) {
+  const match = input.match(/^\/([A-Za-z][A-Za-z0-9_-]*)(?:\s+([\s\S]*))?$/);
+  if (!match) return { type: "none" };
+  const template = templates.find((item) => item.name === match[1]);
+  if (!template) return { type: "none" };
+  const rawArgs = (match[2] || "").trim();
+  return {
+    type: "template",
+    name: template.name,
+    prompt: renderPromptTemplate(template.body, rawArgs),
+  };
+}
+
+export function renderPromptTemplate(body, rawArgs = "") {
+  const args = splitTemplateArgs(rawArgs);
+  return body.replace(/\{\{\s*(args|input|\d+)\s*\}\}/g, (_match, token) => {
+    if (token === "args" || token === "input") return rawArgs;
+    return args[Number(token) - 1] ?? "";
+  }).trim();
+}
+
+export function formatPromptTemplateLines(templates = [], diagnostics = []) {
+  const lines = ["Prompt templates:"];
+  if (templates.length === 0) {
+    lines.push("  (none)");
+  } else {
+    for (const template of templates) lines.push(`  /${template.name}`);
+  }
+  if (diagnostics.length > 0) {
+    lines.push("Template diagnostics:");
+    for (const diagnostic of diagnostics) {
+      lines.push(`  - ${diagnostic.type ?? "warning"}: ${diagnostic.message}`);
+    }
+  }
+  return lines;
+}
+
+function safeReadDir(dir, diagnostics) {
+  try {
+    return readdirSync(dir, { withFileTypes: true });
+  } catch (err) {
+    diagnostics.push({ type: "warning", message: `Failed to read templates directory: ${err.message}`, path: dir });
+    return [];
+  }
+}
+
+function splitTemplateArgs(rawArgs) {
+  return rawArgs ? rawArgs.split(/\s+/).filter(Boolean) : [];
+}

package/src/cli/input/select-with-keyboard.mjs

@@ -1,87 +1,87 @@
-import { createInterface } from "node:readline";
-
-export async function selectWithKeyboard({ input = process.stdin, output = process.stdout, message, items }) {
-  if (!items.length) return null;
-  if (!input.isTTY || !output.isTTY || typeof input.setRawMode !== "function") {
-    output.write(`${message}:\n`);
-    for (let i = 0; i < items.length; i++) output.write(`  ${i + 1}. ${items[i].label}\n`);
-    const answer = await readLine({ input, output, prompt: `Select (1-${items.length}): ` });
-    const index = Number.parseInt(String(answer).trim(), 10) - 1;
-    return items[index]?.value ?? null;
-  }
-
-  let selected = 0;
-  let renderedLines = 0;
-  const maxViewport = Math.max(4, (output.rows || 24) - 2);
-  let viewportStart = 0;
-
-  const viewportEnd = () => Math.min(viewportStart + maxViewport, items.length);
-
-  const adjustViewport = () => {
-    if (selected < viewportStart) viewportStart = selected;
-    else if (selected >= viewportStart + maxViewport) viewportStart = selected - maxViewport + 1;
-  };
-
-  const render = () => {
-    if (renderedLines > 0) output.write(`\x1b[${renderedLines}F`);
-    const lines = formatSelectionList({ message, items, selected, viewportStart, viewportEnd: viewportEnd(), done: false });
-    for (const line of lines) output.write(`\x1b[2K\r${line}\n`);
-    renderedLines = lines.length;
-  };
-  return new Promise((resolve) => {
-    let finished = false;
-    const onData = (chunk) => {
-      const keys = chunk.toString("utf8").match(/\u001b\[[AB]|\r|\n|\u0003|\u001b/g) ?? [];
-      for (const key of keys) {
-        if (finished) return;
-        if (key === "\u0003" || key === "\u001b") finish(null);
-        else if (key === "\r" || key === "\n") finish(items[selected].value);
-        else if (key === "\u001b[A") { selected = (selected - 1 + items.length) % items.length; adjustViewport(); render(); }
-        else if (key === "\u001b[B") { selected = (selected + 1) % items.length; adjustViewport(); render(); }
-      }
-    };
-    const finish = (value) => {
-      finished = true;
-      input.off("data", onData);
-      input.setRawMode(false);
-      input.pause();
-      if (renderedLines > 0) {
-        output.write(`\x1b[${renderedLines}F`);
-        // clear all previously rendered lines
-        for (let i = 0; i < renderedLines; i++) output.write("\x1b[2K\r\n");
-        output.write(`\x1b[${renderedLines}F`);
-      }
-      // final render shows just the selected item
-      const lines = formatSelectionList({ message, items, selected, viewportStart: 0, viewportEnd: items.length, done: value != null });
-      output.write(`\x1b[2K\r${lines[0]}\n`);
-      output.write(`\x1b[2K\r  ${items[selected].label}\n`);
-      resolve(value);
-    };
-    input.setRawMode(true);
-    input.resume();
-    input.on("data", onData);
-    adjustViewport();
-    render();
-  });
-}
-
-export function formatSelectionList({ message, items, selected, viewportStart = 0, viewportEnd = items.length, done = false }) {
-  const hint = done ? "selected" : "↑/↓, Enter";
-  const lines = [`${message} (${hint})`];
-  if (viewportStart > 0) lines.push("  …");
-  for (let i = viewportStart; i < viewportEnd; i++) {
-    const marker = i === selected ? "›" : " ";
-    const label = `${marker} ${items[i].label}`;
-    lines.push(i === selected ? `\x1b[7m${label}\x1b[0m` : label);
-  }
-  if (viewportEnd < items.length) lines.push("  …");
-  return lines;
-}
-
-function readLine({ input = process.stdin, output = process.stdout, prompt }) {
-  const rl = createInterface({ input, output });
-  return new Promise((resolve) => rl.question(prompt, (answer) => {
-    rl.close();
-    resolve(answer);
-  }));
+import { createInterface } from "node:readline";
+
+export async function selectWithKeyboard({ input = process.stdin, output = process.stdout, message, items }) {
+  if (!items.length) return null;
+  if (!input.isTTY || !output.isTTY || typeof input.setRawMode !== "function") {
+    output.write(`${message}:\n`);
+    for (let i = 0; i < items.length; i++) output.write(`  ${i + 1}. ${items[i].label}\n`);
+    const answer = await readLine({ input, output, prompt: `Select (1-${items.length}): ` });
+    const index = Number.parseInt(String(answer).trim(), 10) - 1;
+    return items[index]?.value ?? null;
+  }
+
+  let selected = 0;
+  let renderedLines = 0;
+  const maxViewport = Math.max(4, (output.rows || 24) - 2);
+  let viewportStart = 0;
+
+  const viewportEnd = () => Math.min(viewportStart + maxViewport, items.length);
+
+  const adjustViewport = () => {
+    if (selected < viewportStart) viewportStart = selected;
+    else if (selected >= viewportStart + maxViewport) viewportStart = selected - maxViewport + 1;
+  };
+
+  const render = () => {
+    if (renderedLines > 0) output.write(`\x1b[${renderedLines}F`);
+    const lines = formatSelectionList({ message, items, selected, viewportStart, viewportEnd: viewportEnd(), done: false });
+    for (const line of lines) output.write(`\x1b[2K\r${line}\n`);
+    renderedLines = lines.length;
+  };
+  return new Promise((resolve) => {
+    let finished = false;
+    const onData = (chunk) => {
+      const keys = chunk.toString("utf8").match(/\u001b\[[AB]|\r|\n|\u0003|\u001b/g) ?? [];
+      for (const key of keys) {
+        if (finished) return;
+        if (key === "\u0003" || key === "\u001b") finish(null);
+        else if (key === "\r" || key === "\n") finish(items[selected].value);
+        else if (key === "\u001b[A") { selected = (selected - 1 + items.length) % items.length; adjustViewport(); render(); }
+        else if (key === "\u001b[B") { selected = (selected + 1) % items.length; adjustViewport(); render(); }
+      }
+    };
+    const finish = (value) => {
+      finished = true;
+      input.off("data", onData);
+      input.setRawMode(false);
+      input.pause();
+      if (renderedLines > 0) {
+        output.write(`\x1b[${renderedLines}F`);
+        // clear all previously rendered lines
+        for (let i = 0; i < renderedLines; i++) output.write("\x1b[2K\r\n");
+        output.write(`\x1b[${renderedLines}F`);
+      }
+      // final render shows just the selected item
+      const lines = formatSelectionList({ message, items, selected, viewportStart: 0, viewportEnd: items.length, done: value != null });
+      output.write(`\x1b[2K\r${lines[0]}\n`);
+      output.write(`\x1b[2K\r  ${items[selected].label}\n`);
+      resolve(value);
+    };
+    input.setRawMode(true);
+    input.resume();
+    input.on("data", onData);
+    adjustViewport();
+    render();
+  });
+}
+
+export function formatSelectionList({ message, items, selected, viewportStart = 0, viewportEnd = items.length, done = false }) {
+  const hint = done ? "selected" : "↑/↓, Enter";
+  const lines = [`${message} (${hint})`];
+  if (viewportStart > 0) lines.push("  …");
+  for (let i = viewportStart; i < viewportEnd; i++) {
+    const marker = i === selected ? "›" : " ";
+    const label = `${marker} ${items[i].label}`;
+    lines.push(i === selected ? `\x1b[7m${label}\x1b[0m` : label);
+  }
+  if (viewportEnd < items.length) lines.push("  …");
+  return lines;
+}
+
+function readLine({ input = process.stdin, output = process.stdout, prompt }) {
+  const rl = createInterface({ input, output });
+  return new Promise((resolve) => rl.question(prompt, (answer) => {
+    rl.close();
+    resolve(answer);
+  }));
 }