saeeol 1.3.1 → 1.4.1

package/test/smoke/smoke-tui.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+// smoke-tui.mjs — SAEEOL TUI 스모크 테스트
+// PTY 환경에서 TUI를 실행하고, 런타임 에러가 있으면 캡처
+import { spawn } from "node:child_process"
+import { writeFileSync, mkdirSync, existsSync } from "node:fs"
+import { join } from "node:path"
+
+const TIMEOUT_MS = 8000
+const OUTDIR = join(import.meta.dirname, "..", "..", ".kilo")
+const STDERR_FILE = join(OUTDIR, "tui-smoke-stderr.log")
+const STDOUT_FILE = join(OUTDIR, "tui-smoke-stdout.log")
+
+if (!existsSync(OUTDIR)) mkdirSync(OUTDIR, { recursive: true })
+
+const args = process.argv.slice(2)
+const binPath = args[0] || join(import.meta.dirname, "..", "..", "bin", "saeeol.cjs")
+const command = args[1] || "tui"
+
+console.log(`[smoke] Running: node ${binPath} ${command}`)
+console.log(`[smoke] Timeout: ${TIMEOUT_MS}ms`)
+
+const child = spawn("node", [binPath, command], {
+  cwd: join(import.meta.dirname, "..", ".."),
+  env: { ...process.env, FORCE_COLOR: "0", TERM: "dumb", CI: "true" },
+  stdio: ["pipe", "pipe", "pipe"],
+})
+
+let stdout = ""
+let stderr = ""
+let killed = false
+
+child.stdout.on("data", (d) => { stdout += d })
+child.stderr.on("data", (d) => { stderr += d })
+
+const timer = setTimeout(() => {
+  killed = true
+  child.kill("SIGTERM")
+  // SIGTERM 후 2초 대기 후 SIGKILL
+  setTimeout(() => {
+    if (!child.killed) child.kill("SIGKILL")
+  }, 2000)
+}, TIMEOUT_MS)
+
+const exitCode = await new Promise((resolve) => {
+  child.on("exit", (code) => {
+    clearTimeout(timer)
+    resolve(code ?? -1)
+  })
+})
+
+writeFileSync(STDERR_FILE, stderr)
+writeFileSync(STDOUT_FILE, stdout)
+
+// 결과 분석
+const errors = stderr.split("\n").filter((l) =>
+  /error|Error|ERROR|panic|PANIC|unhandled|Unhandled|REJECTION|rejection/i.test(l)
+    && !/warn|info|debug/i.test(l.split(":")[0] || "")
+)
+
+const result = {
+  exitCode,
+  killed,
+  timeout: TIMEOUT_MS,
+  stderrLines: stderr.split("\n").length,
+  stdoutLines: stdout.split("\n").length,
+  errorCount: errors.length,
+  errors: errors.slice(0, 20),
+  files: { stderr: STDERR_FILE, stdout: STDOUT_FILE },
+}
+
+console.log("\n[smoke] Result:")
+console.log(JSON.stringify(result, null, 2))
+
+if (errors.length > 0) {
+  console.error(`\n[smoke] FAIL: ${errors.length} runtime error(s) detected`)
+  process.exit(1)
+} else if (!killed && exitCode !== 0) {
+  console.error(`\n[smoke] FAIL: TUI exited with code ${exitCode}`)
+  process.exit(1)
+} else {
+  console.log("\n[smoke] PASS: TUI ran without runtime errors")
+  process.exit(0)
+}

package/test/smoke/tui-walkthrough-driver.ts

@@ -0,0 +1,232 @@
+/**
+ * tui-walkthrough-driver.ts — 공유 TUI PTY 드라이버
+ *
+ * 모든 walkthrough 테스트가 사용하는 공통 유틸리티.
+ * bun-pty 기반 TUI 제어 + 에러 감지.
+ */
+
+import { spawn as PtySpawn, type IPty } from "bun-pty"
+import path from "path"
+
+const BIN = path.resolve(import.meta.dir, "../../bin/saeeol.cjs")
+
+// ── ANSI 제거 ──
+
+export function stripAnsi(s: string): string {
+	return s
+		.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "")
+		.replace(/\x1b\].*?\x07/g, "")
+		.replace(/\x1b\[.*?m/g, "")
+		.replace(/[\x00-\x09\x0b\x0c\x0e-\x1f]/g, "")
+}
+
+// ── Known issues — 해결되면 배열에서 제거 ──
+
+const KNOWN_ISSUES = [
+	/export named 'jsx' not found in module.*@opentui\/solid\/jsx-runtime/i,
+	/e=Export named 'jsx' not found.*exception/i,
+]
+
+export function hasError(plain: string): string[] {
+	return plain
+		.split("\n")
+		.filter((l) => {
+			const t = l.trim()
+			if (!t) return false
+			if (KNOWN_ISSUES.some((re) => re.test(t))) return false
+			return (
+				/unhandled|TypeError|ReferenceError|SyntaxError|Cannot find module|Error:/i.test(t) ||
+				/exception/i.test(t) ||
+				/\be=\b.*not found/i.test(t) ||
+				/crashed|fatal|panic/i.test(t)
+			)
+		})
+}
+
+// ── PTY 키 시퀀스 ──
+
+export const Key = {
+	// 제어 문자
+	ctrl: (ch: string) => {
+		const code = ch.charCodeAt(0) - 96
+		return String.fromCharCode(code < 0 ? code + 64 : code)
+	},
+	esc: "\x1b",
+	enter: "\r",
+	tab: "\t",
+	backspace: "\x7f",
+	delete: "\x1b[3~",
+	// 화살표
+	up: "\x1b[A",
+	down: "\x1b[B",
+	right: "\x1b[C",
+	left: "\x1b[D",
+	// 기능키
+	f1: "\x1bOP",
+	f2: "\x1bOQ",
+	f3: "\x1bOR",
+	f4: "\x1bOS",
+	// 네비게이션
+	home: "\x1b[H",
+	end: "\x1b[F",
+	pageUp: "\x1b[5~",
+	pageDown: "\x1b[6~",
+	// 수정자 조합
+	ctrlUp: "\x1b[1;5A",
+	ctrlDown: "\x1b[1;5B",
+	ctrlRight: "\x1b[1;5C",
+	ctrlLeft: "\x1b[1;5D",
+	shiftUp: "\x1b[1;2A",
+	shiftDown: "\x1b[1;2B",
+	shiftRight: "\x1b[1;2C",
+	shiftLeft: "\x1b[1;2D",
+	shiftTab: "\x1b[Z",
+	altA: "\x1ba",
+	altE: "\x1be",
+	altF: "\x1bf",
+	altB: "\x1bb",
+	altD: "\x1bd",
+	// ctrl+조합
+	ctrlA: "\x01",
+	ctrlB: "\x02",
+	ctrlC: "\x03",
+	ctrlD: "\x04",
+	ctrlE: "\x05",
+	ctrlF: "\x06",
+	ctrlG: "\x07",
+	ctrlK: "\x0b",
+	ctrlN: "\x0e",
+	ctrlP: "\x10",
+	ctrlR: "\x12",
+	ctrlT: "\x14",
+	ctrlU: "\x15",
+	ctrlV: "\x16",
+	ctrlW: "\x17",
+	ctrlX: "\x18", // leader
+	ctrlZ: "\x1a",
+	// ctrl+shift
+	ctrlShiftA: "\x1b[1;6A", // 실제로는 다를 수 있음 — 터미널에 따라 다름
+	ctrlShiftD: "\x1b[1;6D",
+	ctrlShiftE: "\x1b[1;6E",
+	ctrlPageUp: "\x1b[5;5~",
+	ctrlPageDown: "\x1b[6;5~",
+	shiftF2: "\x1b[1;2Q",
+}
+
+// ── TUI 드라이버 ──
+
+export class TuiDriver {
+	pty: IPty
+	output = ""
+	snapshots: Array<{ name: string; raw: string; plain: string }> = []
+	private exited = false
+
+	constructor(cwd: string, env?: Record<string, string>) {
+		this.pty = PtySpawn("node", [BIN, "tui"], {
+			name: "xterm-256color",
+			cols: 120,
+			rows: 30,
+			cwd,
+			env: {
+				...process.env,
+				TERM: "xterm-256color",
+				FORCE_COLOR: "1",
+				SAEEOL_LLM_PROVIDER: "custom",
+				SAEEOL_LLM_BASE_URL: "http://localhost:1",
+				SAEEOL_LLM_API_KEY: "test",
+				SAEEOL_LLM_MODEL: "test",
+				...env,
+			},
+		})
+		this.pty.onData((data) => {
+			this.output += data
+		})
+		this.pty.onExit(() => {
+			this.exited = true
+		})
+	}
+
+	write(s: string) {
+		this.pty.write(s)
+	}
+
+	async wait(ms: number) {
+		await Bun.sleep(ms)
+	}
+
+	snapshot(name: string) {
+		const raw = this.output
+		const plain = stripAnsi(this.output)
+		this.snapshots.push({ name, raw, plain })
+		return { raw, plain }
+	}
+
+	errors(): string[] {
+		return hasError(stripAnsi(this.output))
+	}
+
+	/** 마지막 스냅샷 이후 새로 발생한 에러만 */
+	newErrors(): string[] {
+		const prev = this.snapshots.length >= 2
+			? stripAnsi(this.snapshots[this.snapshots.length - 2].raw)
+			: ""
+		const curr = stripAnsi(this.output)
+		if (!prev) return hasError(curr)
+		// prev에 없던 에러 라인만
+		const prevSet = new Set(prev.split("\n").map((l) => l.trim()))
+		return hasError(curr).filter((l) => !prevSet.has(l.trim()))
+	}
+
+	async kill() {
+		try {
+			this.pty.kill()
+		} catch {}
+	}
+
+	get isExited() {
+		return this.exited
+	}
+
+	/** 특정 텍스트가 화면에 나타날 때까지 대기 */
+	async waitFor(text: string, timeoutMs = 10000): Promise<boolean> {
+		const start = Date.now()
+		while (Date.now() - start < timeoutMs) {
+			if (stripAnsi(this.output).includes(text)) return true
+			await Bun.sleep(200)
+		}
+		return false
+	}
+
+	/** leader 키 (ctrl+x) + 후속 키 */
+	async leader(key: string, delay = 100) {
+		this.write(Key.ctrlX)
+		await this.wait(delay)
+		this.write(key)
+	}
+
+	/** 에스케이프로 다이얼로그 닫기 */
+	async dismiss(delay = 500) {
+		this.write(Key.esc)
+		await this.wait(delay)
+	}
+
+	/** 슬래시 명령어 실행 */
+	async slash(cmd: string, delay = 500) {
+		this.write(`/${cmd}`)
+		await this.wait(delay)
+		this.write(Key.enter)
+		await this.wait(1500)
+	}
+
+	/** 스냅샷 리포트 저장 */
+	async saveReport(filename: string) {
+		const reportPath = path.join(import.meta.dir, filename)
+		const report = this.snapshots
+			.map(
+				(s) =>
+					`=== ${s.name} (${s.raw.length} bytes) ===\n${s.plain.slice(-500)}`,
+			)
+			.join("\n\n")
+		await Bun.write(reportPath, report)
+	}
+}

package/test/smoke/tui-walkthrough-input.test.ts

@@ -0,0 +1,286 @@
+/**
+ * tui-walkthrough-input.test.ts — 입력 편집 키바인드 전체 검증
+ *
+ * 프롬프트 textarea의 모든 편집 단축키를 한 번씩 누름:
+ * - 커서 이동: left, right, up, down, home, end
+ * - ctrl+커서: ctrl+a (line home), ctrl+e (line end), ctrl+b (left), ctrl+f (right)
+ * - 단어 이동: alt+f, alt+b, ctrl+left, ctrl+right
+ * - 선택: shift+방향키, ctrl+shift+a/e
+ * - 삭제: backspace, delete, ctrl+k, ctrl+u, ctrl+w, ctrl+d
+ * - 단어 삭제: alt+d, ctrl+backspace
+ * - 클리어: ctrl+c
+ * - 입력: 일반 텍스트, enter, newline(shift+enter)
+ * - undo/redo: ctrl+-, ctrl+z (win32), ctrl+.
+ */
+
+import { describe, expect, test, beforeAll, afterAll } from "bun:test"
+import { tmpdir, disposeAllInstances } from "../fixture/fixture"
+import * as Log from "@saeeol/core/util/log"
+import { Flag } from "@saeeol/core/flag/flag"
+import { TuiDriver, Key } from "./tui-walkthrough-driver"
+
+void Log.init({ print: false })
+
+describe("TUI walkthrough: input editing", () => {
+	let driver: TuiDriver
+	let tmp: Awaited<ReturnType<typeof tmpdir>>
+
+	beforeAll(async () => {
+		tmp = await tmpdir({ git: true, config: {} })
+		Flag.SAEEOL_EXPERIMENTAL_HTTPAPI = false
+		driver = new TuiDriver(tmp.path)
+		await driver.wait(6000)
+	})
+
+	afterAll(async () => {
+		await driver.saveReport(".tui-input-report.txt")
+		await driver.kill()
+		await disposeAllInstances()
+		Flag.SAEEOL_EXPERIMENTAL_HTTPAPI = true
+	})
+
+	// ── 기본 입력 ──
+
+	test("typing: regular text input", async () => {
+		driver.write("hello world this is a test")
+		await driver.wait(500)
+		driver.snapshot("input-typed")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 커서 이동 ──
+
+	test("cursor: left/right arrow", async () => {
+		driver.write(Key.left)
+		await driver.wait(100)
+		driver.write(Key.left)
+		await driver.wait(100)
+		driver.write(Key.right)
+		await driver.wait(100)
+		driver.snapshot("input-cursor-lr")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("cursor: up/down arrow", async () => {
+		driver.write(Key.up)
+		await driver.wait(100)
+		driver.write(Key.down)
+		await driver.wait(100)
+		driver.snapshot("input-cursor-ud")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("cursor: home/end", async () => {
+		driver.write(Key.home)
+		await driver.wait(100)
+		driver.write(Key.end)
+		await driver.wait(100)
+		driver.snapshot("input-cursor-home-end")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("cursor: ctrl+a (line home)", async () => {
+		driver.write(Key.ctrlA)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-a")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("cursor: ctrl+e (line end)", async () => {
+		driver.write(Key.ctrlE)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-e")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("cursor: ctrl+b (left)", async () => {
+		driver.write(Key.ctrlB)
+		await driver.wait(100)
+		driver.write(Key.ctrlB)
+		await driver.wait(100)
+		driver.snapshot("input-ctrl-b")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("cursor: ctrl+f (right)", async () => {
+		driver.write(Key.ctrlF)
+		await driver.wait(100)
+		driver.write(Key.ctrlF)
+		await driver.wait(100)
+		driver.snapshot("input-ctrl-f")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 단어 이동 ──
+
+	test("word: alt+f (forward)", async () => {
+		driver.write(Key.altF)
+		await driver.wait(200)
+		driver.snapshot("input-alt-f")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("word: alt+b (backward)", async () => {
+		driver.write(Key.altB)
+		await driver.wait(200)
+		driver.snapshot("input-alt-b")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("word: ctrl+left", async () => {
+		driver.write(Key.ctrlLeft)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-left")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("word: ctrl+right", async () => {
+		driver.write(Key.ctrlRight)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-right")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 선택 ──
+
+	test("select: shift+left/right", async () => {
+		driver.write(Key.shiftLeft)
+		await driver.wait(100)
+		driver.write(Key.shiftLeft)
+		await driver.wait(100)
+		driver.write(Key.shiftRight)
+		await driver.wait(100)
+		driver.snapshot("input-select-lr")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("select: shift+up/down", async () => {
+		driver.write(Key.shiftUp)
+		await driver.wait(100)
+		driver.write(Key.shiftDown)
+		await driver.wait(100)
+		driver.snapshot("input-select-ud")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("select: alt+a (visual line home)", async () => {
+		driver.write(Key.altA)
+		await driver.wait(200)
+		driver.snapshot("input-alt-a")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("select: alt+e (visual line end)", async () => {
+		driver.write(Key.altE)
+		await driver.wait(200)
+		driver.snapshot("input-alt-e")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 삭제 ──
+
+	test("delete: backspace", async () => {
+		driver.write(Key.backspace)
+		await driver.wait(200)
+		driver.snapshot("input-backspace")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("delete: delete key", async () => {
+		driver.write(Key.delete)
+		await driver.wait(200)
+		driver.snapshot("input-delete")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("delete: ctrl+k (to line end)", async () => {
+		driver.write(Key.ctrlK)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-k")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("delete: ctrl+u (to line start)", async () => {
+		driver.write(Key.ctrlU)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-u")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("delete: ctrl+w (word backward)", async () => {
+		// 텍스트 다시 입력
+		driver.write("another test phrase")
+		await driver.wait(200)
+		driver.write(Key.ctrlW)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-w")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("delete: ctrl+d (char delete)", async () => {
+		driver.write(Key.ctrlD)
+		await driver.wait(200)
+		driver.snapshot("input-ctrl-d")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("delete: alt+d (word forward)", async () => {
+		driver.write("word1 word2 word3")
+		await driver.wait(200)
+		driver.write(Key.altD)
+		await driver.wait(200)
+		driver.snapshot("input-alt-d")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 클리어 / 언두 ──
+
+	test("clear: ctrl+c clears input", async () => {
+		driver.write("should be cleared")
+		await driver.wait(200)
+		driver.write(Key.ctrlC)
+		await driver.wait(300)
+		driver.snapshot("input-clear-ctrl-c")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("undo: ctrl+-", async () => {
+		driver.write("typed text")
+		await driver.wait(200)
+		// ctrl+- 는 터미널에서 \x1f
+		driver.write("\x1f")
+		await driver.wait(300)
+		driver.snapshot("input-undo-ctrl-minus")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	test("redo: ctrl+.", async () => {
+		driver.write(Key.ctrlV) // ctrl+. — 재할당 불가하므로 대략적
+		await driver.wait(200)
+		driver.snapshot("input-redo")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 새 텍스트 입력 후 엔터 ──
+
+	test("submit: enter key (does not crash)", async () => {
+		driver.write(Key.ctrlC) // 클리어
+		await driver.wait(200)
+		driver.write("test message")
+		await driver.wait(200)
+		// 엔터 — 실제 전송은 안 됨 (LLM 서버 죽음), 크래시만 안 하면 됨
+		driver.write(Key.enter)
+		await driver.wait(1000)
+		driver.snapshot("input-submit")
+		expect(driver.errors()).toHaveLength(0)
+	})
+
+	// ── 정리 ──
+
+	test("cleanup: clear and verify", async () => {
+		driver.write(Key.ctrlC)
+		await driver.wait(300)
+		driver.snapshot("input-cleanup")
+		expect(driver.errors()).toHaveLength(0)
+	})
+})