agent-trellis 0.6.3 → 0.8.0

package/dist/lib/terminalPicker.js

@@ -1,193 +1,83 @@
 /**
- * Minimal, dependency-free arrow-key/checkbox terminal picker
- * (trellis-onboard-interactive-picker design.md D1) — the interaction
- * surface `trellis onboard`'s two prompts need (at most four rows, no
- * search, no pagination) doesn't need a full prompt library; this
- * hand-rolls just enough raw-mode key handling and ANSI rendering for
- * that bounded case, matching the project's existing narrow-dependency
- * precedent (src/lib/envVarNames.ts, src/lib/secretEnv.ts).
+ * Styled interactive prompts used by `trellis onboard`.
  *
- * `input`/`output` are injectable (never a CLI flag) purely so tests can
- * drive the real key-parsing/render loop against a plain stream instead
- * of a real TTY — same seam pattern (`homeDir`, etc.) used everywhere
- * else in this project.
+ * The onboarding orchestration depends on semantic values (an index or a set
+ * of indices), not on a particular terminal renderer. Clack owns raw-mode
+ * handling, color, wrapping, cursor cleanup, and cancellation; the injected
+ * streams keep the prompt loop testable without a real terminal.
  */
+import { CANCEL_SYMBOL, autocompleteMultiselect, isCancel, multiselect, select } from "@clack/prompts";
 function defaultStreams() {
-    return { input: process.stdin, output: process.stdout };
+    return { input: process.stdin, output: process.stderr };
 }
 /**
- * True only when both streams are real, raw-mode-capable terminals — the
- * exact gate deciding picker vs. the pre-existing numbered-typing prompt
- * (design.md D2). A stream lacking `setRawMode` (piped input, some
- * minimal TTYs) always falls back, never hangs or guesses.
+ * Clack is only started for a real interactive terminal. Piped input keeps
+ * the existing numbered fallback in onboard instead of hanging in raw mode.
  */
 export function canUseInteractivePicker(streams = defaultStreams()) {
     const input = streams.input;
     const output = streams.output;
     return Boolean(input.isTTY && output.isTTY && typeof input.setRawMode === "function");
 }
-/** Wrapping index navigation — pure, exported for direct unit testing. */
+/** Wrapping index navigation retained as a small public utility for callers/tests. */
 export function nextIndex(current, delta, length) {
     return ((current + delta) % length + length) % length;
 }
-/** Pure single-index toggle — exported for direct unit testing. */
+/** Pure single-index toggle retained for callers/tests. */
 export function toggled(checked, index) {
     const next = [...checked];
     next[index] = !next[index];
     return next;
 }
-const ESC = "\u001b";
-const CTRL_C = "\u0003";
-const HIDE_CURSOR = `${ESC}[?25l`;
-const SHOW_CURSOR = `${ESC}[?25h`;
-/** Parses one raw input chunk into a single logical key — arrow escape
- * sequences, j/k, space, enter, or Ctrl+C. Anything else is ignored. */
-function parseKey(chunk) {
-    if (chunk === CTRL_C)
-        return "cancel";
-    if (chunk === "\r" || chunk === "\n")
-        return "confirm";
-    if (chunk === " ")
-        return "toggle";
-    if (chunk === `${ESC}[A` || chunk === "k")
-        return "up";
-    if (chunk === `${ESC}[B` || chunk === "j")
-        return "down";
-    return null;
-}
-function withRawMode(streams, body) {
-    const input = streams.input;
-    const output = streams.output;
-    const canSetRawMode = typeof input.setRawMode === "function";
-    if (canSetRawMode)
-        input.setRawMode(true);
-    input.resume();
-    input.setEncoding("utf-8");
-    output.write(HIDE_CURSOR);
-    const restore = () => {
-        output.write(SHOW_CURSOR);
-        if (canSetRawMode)
-            input.setRawMode(false);
-        input.pause();
-    };
-    // Second-layer safety net (design.md D6): a thrown error the caller's
-    // own try/finally doesn't get a chance to run for (process killed
-    // externally) must still not leave the terminal in raw mode/cursor
-    // hidden.
-    process.once("exit", restore);
-    return body().finally(() => {
-        restore();
-        process.removeListener("exit", restore);
-    });
-}
-function moveCursorUp(output, lines) {
-    if (lines > 0)
-        output.write(`${ESC}[${lines}A`);
-}
-function clearLines(output, lines) {
-    for (let i = 0; i < lines; i++) {
-        output.write(`${ESC}[2K`);
-        if (i < lines - 1)
-            output.write(`${ESC}[1B`);
-    }
-    moveCursorUp(output, lines - 1);
-}
-function renderRows(output, rows, previousRowCount) {
-    if (previousRowCount > 0) {
-        clearLines(output, previousRowCount);
-    }
-    for (const row of rows) {
-        output.write(`${row}\n`);
-    }
-}
-function highlightRow(text, isHighlighted) {
-    return isHighlighted ? `> ${ESC}[7m${text}${ESC}[0m` : `  ${text}`;
+function wasCancelled(value) {
+    return value === CANCEL_SYMBOL || isCancel(value);
 }
 /**
- * Single-select: Up/Down/j/k moves the highlight, Enter confirms. Resolves
- * the confirmed index, or `null` on Ctrl+C cancel. Caller (onboard.ts)
- * must have already confirmed `canUseInteractivePicker()` — this function
- * does not re-check, and assumes `streams.input` genuinely supports raw
- * mode.
+ * Single-select prompt. The returned number is the original item index, so
+ * callers do not depend on display labels or prompt-library values.
  */
-export async function runSingleSelectPicker(items, streams = defaultStreams()) {
-    const { input, output } = streams;
-    return withRawMode(streams, () => {
-        return new Promise((resolve) => {
-            let highlighted = 0;
-            let rowCount = 0;
-            const draw = () => {
-                const rows = items.map((label, i) => highlightRow(label, i === highlighted));
-                renderRows(output, rows, rowCount);
-                rowCount = rows.length;
-            };
-            draw();
-            const onData = (chunk) => {
-                const key = parseKey(chunk.toString("utf-8"));
-                if (key === "up") {
-                    highlighted = nextIndex(highlighted, -1, items.length);
-                    draw();
-                }
-                else if (key === "down") {
-                    highlighted = nextIndex(highlighted, 1, items.length);
-                    draw();
-                }
-                else if (key === "confirm") {
-                    input.removeListener("data", onData);
-                    resolve(highlighted);
-                }
-                else if (key === "cancel") {
-                    input.removeListener("data", onData);
-                    resolve(null);
-                }
-            };
-            input.on("data", onData);
-        });
+export async function runSingleSelectPicker(items, streams = defaultStreams(), message = "请选择一个迁移来源") {
+    const result = await select({
+        message,
+        options: items.map((item, value) => ({
+            label: typeof item === "string" ? item : item.label,
+            value,
+            ...(typeof item === "string" || item.disabled === undefined ? {} : { disabled: item.disabled }),
+        })),
+        input: streams.input,
+        output: streams.output,
+        showInstructions: true,
     });
+    return wasCancelled(result) ? null : result;
 }
 /**
- * Multi-select (checkbox): Up/Down/j/k moves the highlight, Space toggles
- * the current row, Enter confirms. Resolves the checked indices at
- * confirm time, or `null` on Ctrl+C cancel. Same precondition as
- * `runSingleSelectPicker`.
+ * Checkbox prompt. The returned indices preserve the existing onboard
+ * contract, while Clack handles checked state, wrapping, colors, and cleanup.
  */
-export async function runMultiSelectPicker(items, initiallyChecked, streams = defaultStreams()) {
-    const { input, output } = streams;
-    return withRawMode(streams, () => {
-        return new Promise((resolve) => {
-            let highlighted = 0;
-            let checked = [...initiallyChecked];
-            let rowCount = 0;
-            const draw = () => {
-                const rows = items.map((label, i) => highlightRow(`[${checked[i] ? "x" : " "}] ${label}`, i === highlighted));
-                renderRows(output, rows, rowCount);
-                rowCount = rows.length;
-            };
-            draw();
-            const onData = (chunk) => {
-                const key = parseKey(chunk.toString("utf-8"));
-                if (key === "up") {
-                    highlighted = nextIndex(highlighted, -1, items.length);
-                    draw();
-                }
-                else if (key === "down") {
-                    highlighted = nextIndex(highlighted, 1, items.length);
-                    draw();
-                }
-                else if (key === "toggle") {
-                    checked = toggled(checked, highlighted);
-                    draw();
-                }
-                else if (key === "confirm") {
-                    input.removeListener("data", onData);
-                    resolve(checked.flatMap((isChecked, i) => (isChecked ? [i] : [])));
-                }
-                else if (key === "cancel") {
-                    input.removeListener("data", onData);
-                    resolve(null);
-                }
-            };
-            input.on("data", onData);
-        });
+export async function runMultiSelectPicker(items, initiallyChecked, streams = defaultStreams(), message = "请选择要启用的项目") {
+    const result = await multiselect({
+        message,
+        options: items.map((label, value) => ({ label, value })),
+        initialValues: items.flatMap((_, index) => (initiallyChecked[index] ? [index] : [])),
+        input: streams.input,
+        output: streams.output,
+        required: false,
+        showInstructions: true,
+    });
+    return wasCancelled(result) ? null : [...result].sort((left, right) => left - right);
+}
+/** Searchable multiselect for large skill/MCP inventories. It returns the
+ * selected labels as stable names, preserving the semantic adapter contract
+ * while avoiding a wall of dozens of rows in the onboarding terminal. */
+export async function runSearchMultiSelectPicker(items, streams = defaultStreams(), message = "选择要迁移的项目") {
+    const result = await autocompleteMultiselect({
+        message,
+        placeholder: "输入关键词筛选",
+        options: items.map((value) => ({ label: value, value })),
+        initialValues: [...items],
+        input: streams.input,
+        output: streams.output,
+        required: false,
     });
+    return wasCancelled(result) ? null : result;
 }