@xenonbyte/da-vinci-workflow 0.2.1 → 0.2.2

package/tui/index.js

@@ -0,0 +1,727 @@
+const path = require("path");
+const readline = require("readline");
+const { spawnSync } = require("child_process");
+const {
+  COMMANDS,
+  STAGES,
+  buildCommandArgs,
+  buildDisplayCommand,
+  getCommandParameterItems,
+  getCommandById,
+  getDefaultLanguage,
+  getStageById,
+  hasPlaceholders,
+  normalizeLanguage,
+  resolveLocalizedText,
+  tokenizeCommandLine
+} = require("./catalog");
+
+const DA_VINCI_BIN = path.resolve(__dirname, "..", "bin", "da-vinci.js");
+
+const HELP_TEXT = {
+  en: [
+    "Da Vinci TUI",
+    "",
+    "Usage:",
+    "  da-vinci tui [--project <path>] [--change <id>] [--lang en|zh] [--strict] [--json] [--continue-on-error]",
+    "  da-vinci-tui [--project <path>] [--change <id>] [--lang en|zh] [--strict] [--json] [--continue-on-error]",
+    "",
+    "Keyboard:",
+    "  Up/Down or j/k   move selection",
+    "  Enter or r       run selected command",
+    "  m                edit the preview command before running",
+    "  h                show parameters for the selected command",
+    "  p                set project path context",
+    "  c                set change id context",
+    "  l                toggle UI language",
+    "  s                toggle --strict for supported commands",
+    "  J                toggle --json for supported commands",
+    "  e                toggle --continue-on-error for supported commands",
+    "  ?                toggle help overlay",
+    "  q                quit",
+    "",
+    "Notes:",
+    "  - specialized commands keep placeholders such as <pen-path>; press m to edit them before execution",
+    "  - when the TUI starts inside a project root, --project is omitted because CLI commands already fall back to cwd"
+  ].join("\n"),
+  zh: [
+    "Da Vinci TUI",
+    "",
+    "用法：",
+    "  da-vinci tui [--project <path>] [--change <id>] [--lang en|zh] [--strict] [--json] [--continue-on-error]",
+    "  da-vinci-tui [--project <path>] [--change <id>] [--lang en|zh] [--strict] [--json] [--continue-on-error]",
+    "",
+    "键位：",
+    "  上/下 或 j/k     移动选中项",
+    "  Enter 或 r       执行当前命令",
+    "  m                先编辑预览命令，再执行",
+    "  h                查看当前命令参数",
+    "  p                设置项目路径上下文",
+    "  c                设置 change id 上下文",
+    "  l                切换中英文界面",
+    "  s                为支持的命令切换 --strict",
+    "  J                为支持的命令切换 --json",
+    "  e                为支持的命令切换 --continue-on-error",
+    "  ?                打开或关闭帮助层",
+    "  q                退出",
+    "",
+    "说明：",
+    "  - 特殊命令会保留 <pen-path> 这类占位符，执行前按 m 编辑即可",
+    "  - 当 TUI 在项目根目录启动时，CLI 已默认使用 cwd，所以不会额外拼接 --project"
+  ].join("\n")
+};
+
+function formatTuiHelp(lang) {
+  const normalized = normalizeLanguage(lang || getDefaultLanguage());
+  return HELP_TEXT[normalized];
+}
+
+function formatCommandParameterHelp(command, lang, width) {
+  const items = getCommandParameterItems(command);
+  const lines = [];
+  const normalized = normalizeLanguage(lang || getDefaultLanguage());
+  lines.push(normalized === "zh" ? "命令参数 (h):" : "Command Parameters (h):");
+
+  if (items.length === 0) {
+    lines.push(
+      normalized === "zh"
+        ? "这条命令在 TUI 里没有额外可调参数，直接按预览命令执行即可。"
+        : "This command has no extra adjustable parameters in the TUI. Run it exactly as previewed."
+    );
+    return lines;
+  }
+
+  for (const item of items) {
+    const signature = [item.flag, item.value].filter(Boolean).join(" ");
+    const requirementLabel = item.required
+      ? normalized === "zh"
+        ? "必填"
+        : "required"
+      : normalized === "zh"
+        ? "可选"
+        : "optional";
+    const body = `${signature} [${requirementLabel}]: ${resolveLocalizedText(item.description, normalized)}`;
+    const wrapped = wrapText(body, Math.max(16, width - 4));
+    if (wrapped.length === 0) {
+      continue;
+    }
+    lines.push(`- ${wrapped[0]}`);
+    for (const line of wrapped.slice(1)) {
+      lines.push(`  ${line}`);
+    }
+  }
+
+  if (items.some((item) => item.required)) {
+    lines.push(
+      normalized === "zh"
+        ? "提示: 标记为必填的参数通常需要先按 m 编辑命令并补全占位符。"
+        : "Hint: parameters marked required usually need you to press m and replace placeholders before running."
+    );
+  }
+  return lines;
+}
+
+function clearScreen() {
+  process.stdout.write("\x1b[2J\x1b[H");
+}
+
+function wrapText(text, width) {
+  const source = String(text || "").trim();
+  if (!source) {
+    return [];
+  }
+  if (width <= 8) {
+    return [source];
+  }
+  const words = source.split(/\s+/);
+  const lines = [];
+  let current = "";
+  for (const word of words) {
+    const candidate = current ? `${current} ${word}` : word;
+    if (candidate.length <= width) {
+      current = candidate;
+      continue;
+    }
+    if (current) {
+      lines.push(current);
+      current = word;
+      continue;
+    }
+    lines.push(word.slice(0, width));
+    current = word.slice(width);
+  }
+  if (current) {
+    lines.push(current);
+  }
+  return lines;
+}
+
+function truncate(text, width) {
+  const source = String(text || "");
+  if (source.length <= width) {
+    return source;
+  }
+  if (width <= 1) {
+    return source.slice(0, width);
+  }
+  return `${source.slice(0, Math.max(0, width - 1))}…`;
+}
+
+function buildCatalogRows(lang) {
+  const rows = [];
+  for (const stage of STAGES) {
+    rows.push({
+      type: "stage",
+      id: stage.id,
+      label: resolveLocalizedText(stage.title, lang)
+    });
+    for (const command of COMMANDS.filter((item) => item.stageId === stage.id)) {
+      rows.push({
+        type: "command",
+        id: command.id,
+        label: resolveLocalizedText(command.title, lang),
+        command
+      });
+    }
+  }
+  return rows;
+}
+
+function countCommandIndex(rows, rowIndex) {
+  let count = -1;
+  for (let index = 0; index <= rowIndex; index += 1) {
+    if (rows[index] && rows[index].type === "command") {
+      count += 1;
+    }
+  }
+  return count;
+}
+
+function getRowIndexForCommand(rows, commandIndex) {
+  let seen = -1;
+  for (let index = 0; index < rows.length; index += 1) {
+    if (rows[index].type === "command") {
+      seen += 1;
+      if (seen === commandIndex) {
+        return index;
+      }
+    }
+  }
+  return 0;
+}
+
+function getVisibleRows(rows, selectedRowIndex, limit) {
+  if (rows.length <= limit) {
+    return {
+      start: 0,
+      items: rows
+    };
+  }
+  const commandWindowStart = Math.max(0, selectedRowIndex - Math.floor(limit / 2));
+  const start = Math.min(commandWindowStart, Math.max(0, rows.length - limit));
+  return {
+    start,
+    items: rows.slice(start, start + limit)
+  };
+}
+
+function buildPreviewCommand(state) {
+  const command = getCommandById(state.selectedCommandId);
+  return {
+    command,
+    args: buildCommandArgs(command, state),
+    display: buildDisplayCommand(command, state)
+  };
+}
+
+function normalizeEditedCommand(input) {
+  const tokens = tokenizeCommandLine(input);
+  if (tokens.length === 0) {
+    return [];
+  }
+  if (tokens[0] === "da-vinci") {
+    return tokens.slice(1);
+  }
+  return tokens;
+}
+
+function parseEditedCommandInput(input) {
+  try {
+    return {
+      args: normalizeEditedCommand(input),
+      error: null
+    };
+  } catch (error) {
+    return {
+      args: null,
+      error
+    };
+  }
+}
+
+function getExecutionCwd(projectPath) {
+  return path.resolve(projectPath || process.cwd());
+}
+
+function teardownInput(input, onKeypress) {
+  if (!input) {
+    return;
+  }
+  if (typeof input.off === "function" && onKeypress) {
+    input.off("keypress", onKeypress);
+  }
+  if (input.isTTY && typeof input.setRawMode === "function") {
+    input.setRawMode(false);
+  }
+  if (typeof input.pause === "function") {
+    input.pause();
+  }
+}
+
+function getKeyAction(str, key = {}) {
+  if (key.ctrl && key.name === "c") {
+    return "quit";
+  }
+  if (key.name === "q") {
+    return "quit";
+  }
+  if (key.name === "up" || (key.name === "k" && key.shift !== true)) {
+    return "move_up";
+  }
+  if (key.name === "down" || (key.name === "j" && key.shift !== true)) {
+    return "move_down";
+  }
+  if (key.name === "l") {
+    return "toggle_lang";
+  }
+  if (key.name === "h") {
+    return "toggle_command_help";
+  }
+  if (key.name === "s") {
+    return "toggle_strict";
+  }
+  if ((key.name === "j" && key.shift === true) || str === "J") {
+    return "toggle_json";
+  }
+  if (key.name === "e") {
+    return "toggle_continue_on_error";
+  }
+  if (key.name === "p") {
+    return "set_project";
+  }
+  if (key.name === "c") {
+    return "set_change";
+  }
+  if (key.name === "m") {
+    return "edit_and_run";
+  }
+  if (key.name === "return" || key.name === "r") {
+    return "run";
+  }
+  if (str === "?") {
+    return "toggle_help";
+  }
+  return null;
+}
+
+function waitForAnyKey() {
+  return new Promise((resolve) => {
+    const handler = () => {
+      process.stdin.off("keypress", handler);
+      resolve();
+    };
+    process.stdin.on("keypress", handler);
+  });
+}
+
+async function promptInput(state, label, currentValue, options = {}) {
+  state.rawModeEnabled = false;
+  if (process.stdin.isTTY) {
+    process.stdin.setRawMode(false);
+  }
+  process.stdin.pause();
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const promptLabel = currentValue
+    ? `${label} [${currentValue}]: `
+    : `${label}: `;
+  const answer = await new Promise((resolve) => {
+    rl.question(promptLabel, (value) => resolve(value));
+  });
+  rl.close();
+  process.stdin.resume();
+  if (process.stdin.isTTY) {
+    process.stdin.setRawMode(true);
+  }
+  state.rawModeEnabled = true;
+  const normalized = String(answer || "").trim();
+  if (!normalized && options.allowBlank) {
+    return "";
+  }
+  return normalized || String(currentValue || "").trim();
+}
+
+function renderState(state) {
+  clearScreen();
+  const lang = normalizeLanguage(state.lang);
+  const width = process.stdout.columns || 100;
+  const rows = buildCatalogRows(lang);
+  const selectedRowIndex = getRowIndexForCommand(
+    rows,
+    COMMANDS.findIndex((command) => command.id === state.selectedCommandId)
+  );
+  const listHeight = Math.max(10, Math.min(16, (process.stdout.rows || 40) - 20));
+  const visible = getVisibleRows(rows, selectedRowIndex, listHeight);
+  const preview = buildPreviewCommand(state);
+  const stage = getStageById(preview.command.stageId);
+  const selectedNumber = COMMANDS.findIndex((command) => command.id === preview.command.id) + 1;
+  const lines = [];
+
+  lines.push(lang === "zh" ? "Da Vinci TUI 终端导航" : "Da Vinci TUI");
+  lines.push(
+    lang === "zh"
+      ? `语言: ${lang === "zh" ? "中文" : "English"} (l) | 项目: ${state.projectPath || process.cwd()} (p) | Change: ${
+          state.changeId || "auto"
+        } (c)`
+      : `Language: ${lang === "zh" ? "Chinese" : "English"} (l) | Project: ${
+          state.projectPath || process.cwd()
+        } (p) | Change: ${state.changeId || "auto"} (c)`
+  );
+  lines.push(
+    lang === "zh"
+      ? `开关: strict=${state.strict ? "on" : "off"} (s) | json=${state.jsonOutput ? "on" : "off"} (J) | continue-on-error=${
+          state.continueOnError ? "on" : "off"
+        } (e)`
+      : `Flags: strict=${state.strict ? "on" : "off"} (s) | json=${state.jsonOutput ? "on" : "off"} (J) | continue-on-error=${
+          state.continueOnError ? "on" : "off"
+        } (e)`
+  );
+  lines.push(
+    lang === "zh"
+      ? "操作: ↑↓/j/k 移动 | Enter/r 执行 | h 参数 | m 编辑命令 | ? 帮助 | q 退出"
+      : "Keys: Up/Down/j/k move | Enter/r run | h params | m edit command | ? help | q quit"
+  );
+  lines.push("");
+  lines.push(lang === "zh" ? "命令目录" : "Command Catalog");
+  for (let index = 0; index < visible.items.length; index += 1) {
+    const row = visible.items[index];
+    const absoluteIndex = visible.start + index;
+    if (row.type === "stage") {
+      lines.push(`  [${row.label}]`);
+      continue;
+    }
+    const selected = absoluteIndex === selectedRowIndex;
+    const prefix = selected ? ">" : " ";
+    const title = truncate(row.label, Math.max(16, width - 8));
+    lines.push(` ${prefix} ${title}`);
+  }
+  lines.push("");
+  lines.push(
+    lang === "zh"
+      ? `当前命令 (${selectedNumber}/${COMMANDS.length}): ${resolveLocalizedText(preview.command.title, lang)}`
+      : `Selected (${selectedNumber}/${COMMANDS.length}): ${resolveLocalizedText(preview.command.title, lang)}`
+  );
+  lines.push(
+    lang === "zh"
+      ? `阶段: ${resolveLocalizedText(stage.title, lang)}`
+      : `Phase: ${resolveLocalizedText(stage.title, lang)}`
+  );
+  for (const line of wrapText(resolveLocalizedText(preview.command.summary, lang), width - 2)) {
+    lines.push(line);
+  }
+  lines.push("");
+  for (const line of wrapText(resolveLocalizedText(preview.command.details, lang), width - 2)) {
+    lines.push(line);
+  }
+  lines.push("");
+  lines.push(lang === "zh" ? "预览命令:" : "Preview:");
+  for (const line of wrapText(preview.display, width - 2)) {
+    lines.push(line);
+  }
+  if (hasPlaceholders(preview.args)) {
+    lines.push(
+      lang === "zh"
+        ? "提示: 当前命令包含占位符，按 m 编辑后再执行。"
+        : "Hint: this command still contains placeholders; press m to edit before running."
+    );
+  }
+  if (!state.commandHelpVisible) {
+    lines.push(
+      lang === "zh"
+        ? "提示: 按 h 查看当前命令支持的参数。"
+        : "Hint: press h to inspect parameters for the selected command."
+    );
+  }
+  if (state.lastStatus) {
+    lines.push("");
+    lines.push(
+      lang === "zh"
+        ? `最近结果: ${state.lastStatus}`
+        : `Last result: ${state.lastStatus}`
+    );
+  }
+  if (state.helpVisible) {
+    lines.push("");
+    lines.push("-".repeat(Math.max(20, Math.min(width - 2, 48))));
+    for (const line of formatTuiHelp(lang).split("\n")) {
+      lines.push(line);
+    }
+  }
+  if (state.commandHelpVisible) {
+    lines.push("");
+    lines.push("-".repeat(Math.max(20, Math.min(width - 2, 48))));
+    for (const line of formatCommandParameterHelp(preview.command, lang, width).flat()) {
+      lines.push(line);
+    }
+  }
+
+  process.stdout.write(`${lines.join("\n")}\n`);
+}
+
+async function runPreview(state, options = {}) {
+  const lang = normalizeLanguage(state.lang);
+  const preview = buildPreviewCommand(state);
+  let args = preview.args;
+
+  if (options.forceEdit || hasPlaceholders(args)) {
+    renderState(state);
+    const edited = await promptInput(
+      state,
+      lang === "zh" ? "编辑命令" : "Edit command",
+      preview.display
+    );
+    if (!edited) {
+      return;
+    }
+    const parsed = parseEditedCommandInput(edited);
+    if (parsed.error) {
+      clearScreen();
+      process.stdout.write(
+        `${lang === "zh" ? "命令编辑失败" : "Command edit failed"}\n\n${parsed.error.message || String(parsed.error)}\n\n`
+      );
+      process.stdout.write(
+        `${lang === "zh" ? "按任意键返回 TUI。" : "Press any key to return to the TUI."}\n`
+      );
+      state.lastStatus = `${lang === "zh" ? "命令编辑失败" : "Command edit failed"}: ${
+        parsed.error.message || String(parsed.error)
+      }`;
+      await waitForAnyKey();
+      return;
+    }
+    args = parsed.args;
+    if (args.length === 0) {
+      return;
+    }
+  }
+
+  clearScreen();
+  process.stdout.write(
+    `${lang === "zh" ? "正在执行" : "Running"}: ${["da-vinci", ...args].join(" ")}\n\n`
+  );
+  const result = spawnSync(process.execPath, [DA_VINCI_BIN, ...args], {
+    cwd: getExecutionCwd(state.projectPath),
+    encoding: "utf8",
+    maxBuffer: 16 * 1024 * 1024
+  });
+  if (result.error) {
+    process.stdout.write(
+      `${lang === "zh" ? "执行失败" : "Execution failed"}: ${result.error.message || String(result.error)}\n\n`
+    );
+    process.stdout.write(
+      `${lang === "zh" ? "按任意键返回 TUI。" : "Press any key to return to the TUI."}\n`
+    );
+    state.lastStatus = `${["da-vinci", ...args].join(" ")} -> error`;
+    await waitForAnyKey();
+    return;
+  }
+  const stdout = String(result.stdout || "");
+  const stderr = String(result.stderr || "");
+  const combined = [stdout.trim(), stderr.trim()].filter(Boolean).join("\n\n");
+  process.stdout.write(`${combined || (lang === "zh" ? "没有输出。" : "No output.")}\n\n`);
+  process.stdout.write(
+    `${lang === "zh" ? "退出码" : "Exit code"}: ${result.status == null ? "null" : result.status}\n`
+  );
+  process.stdout.write(
+    `${lang === "zh" ? "按任意键返回 TUI。" : "Press any key to return to the TUI."}\n`
+  );
+  state.lastStatus = `${["da-vinci", ...args].join(" ")} -> ${result.status == null ? "null" : result.status}`;
+  await waitForAnyKey();
+}
+
+async function launchTui(options = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error("`da-vinci tui` requires an interactive terminal. Use `--help` for usage.");
+  }
+
+  const initialProject = String(options.projectPath || process.cwd()).trim() || process.cwd();
+  const initialChange = String(options.changeId || "").trim();
+  const state = {
+    lang: normalizeLanguage(options.lang || getDefaultLanguage()),
+    projectPath: initialProject,
+    changeId: initialChange,
+    strict: options.strict === true,
+    jsonOutput: options.jsonOutput === true,
+    continueOnError: options.continueOnError === true,
+    selectedCommandId: COMMANDS[0].id,
+    helpVisible: false,
+    commandHelpVisible: false,
+    lastStatus: "",
+    rawModeEnabled: true,
+    busy: false
+  };
+
+  readline.emitKeypressEvents(process.stdin);
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+
+  let closed = false;
+  return await new Promise((resolve) => {
+    const close = () => {
+      if (closed) {
+        return;
+      }
+      closed = true;
+      teardownInput(process.stdin, onKeypress);
+      clearScreen();
+      resolve();
+    };
+
+    const moveSelection = (delta) => {
+      const currentIndex = COMMANDS.findIndex((command) => command.id === state.selectedCommandId);
+      const nextIndex = (currentIndex + delta + COMMANDS.length) % COMMANDS.length;
+      state.selectedCommandId = COMMANDS[nextIndex].id;
+    };
+
+    const onKeypress = async (str, key = {}) => {
+      if (closed) {
+        return;
+      }
+      if (state.busy) {
+        return;
+      }
+      const action = getKeyAction(str, key);
+      if (!action) {
+        return;
+      }
+      if (action === "quit") {
+        close();
+        return;
+      }
+      if (action === "move_up") {
+        moveSelection(-1);
+        renderState(state);
+        return;
+      }
+      if (action === "move_down") {
+        moveSelection(1);
+        renderState(state);
+        return;
+      }
+      if (action === "toggle_lang") {
+        state.lang = state.lang === "zh" ? "en" : "zh";
+        renderState(state);
+        return;
+      }
+      if (action === "toggle_command_help") {
+        state.commandHelpVisible = !state.commandHelpVisible;
+        renderState(state);
+        return;
+      }
+      if (action === "toggle_strict") {
+        state.strict = !state.strict;
+        renderState(state);
+        return;
+      }
+      if (action === "toggle_json") {
+        state.jsonOutput = !state.jsonOutput;
+        renderState(state);
+        return;
+      }
+      if (action === "toggle_continue_on_error") {
+        state.continueOnError = !state.continueOnError;
+        renderState(state);
+        return;
+      }
+      if (action === "set_project") {
+        state.busy = true;
+        try {
+          const value = await promptInput(
+            state,
+            state.lang === "zh" ? "项目路径" : "Project path",
+            state.projectPath
+          );
+          state.projectPath = value || process.cwd();
+        } finally {
+          state.busy = false;
+        }
+        renderState(state);
+        return;
+      }
+      if (action === "set_change") {
+        state.busy = true;
+        try {
+          const value = await promptInput(
+            state,
+            state.lang === "zh" ? "Change ID（留空自动推断）" : "Change id (leave blank for auto)",
+            state.changeId,
+            { allowBlank: true }
+          );
+          state.changeId = value;
+        } finally {
+          state.busy = false;
+        }
+        renderState(state);
+        return;
+      }
+      if (action === "edit_and_run") {
+        state.busy = true;
+        try {
+          await runPreview(state, { forceEdit: true });
+        } finally {
+          state.busy = false;
+        }
+        renderState(state);
+        return;
+      }
+      if (action === "run") {
+        state.busy = true;
+        try {
+          await runPreview(state, { forceEdit: false });
+        } finally {
+          state.busy = false;
+        }
+        renderState(state);
+        return;
+      }
+      if (action === "toggle_help") {
+        state.helpVisible = !state.helpVisible;
+        renderState(state);
+      }
+    };
+
+    process.stdin.on("keypress", onKeypress);
+    renderState(state);
+  });
+}
+
+module.exports = {
+  COMMANDS,
+  STAGES,
+  buildCommandArgs,
+  buildDisplayCommand,
+  formatCommandParameterHelp,
+  formatTuiHelp,
+  getExecutionCwd,
+  getCommandParameterItems,
+  getCommandById,
+  getDefaultLanguage,
+  getKeyAction,
+  launchTui,
+  normalizeEditedCommand,
+  parseEditedCommandInput,
+  resolveLocalizedText,
+  teardownInput,
+  tokenizeCommandLine
+};