opencode-miniterm 1.0.4 → 1.0.6

package/test/README.md

@@ -0,0 +1,164 @@
+# Tmux Readline Tests
+
+This directory contains tmux-based integration tests for the readline functionality of opencode-miniterm.
+
+## Overview
+
+The `tmux-readline.test.ts` script uses tmux to simulate real terminal interactions with the application, testing:
+
+- **Input Editing**: Character insertion, backspace, delete key
+- **Cursor Navigation**: Left/right arrow keys, word boundaries (Meta+left/right)
+- **History Navigation**: Up/down arrow through command history
+- **Tab Completion**: Slash commands (`/`) and file references (`@`)
+- **Smart Features**: Double-space to period conversion
+- **Escape Key**: Clearing input and canceling requests
+
+## Running the Tests
+
+```bash
+# Run all tmux readline tests
+bun run test:tmux
+
+# Or run directly
+bun test/tmux-readline.test.ts
+```
+
+## How It Works
+
+The test script:
+
+1. **Sets up a tmux session** - Creates a detached tmux session for testing
+2. **Starts the application** - Launches opencode-miniterm in the tmux session
+3. **Sends keystrokes** - Simulates user input using `tmux send-keys`
+4. **Captures output** - Uses `tmux capture-pane` to read terminal state
+5. **Verifies behavior** - Checks that the output matches expected results
+6. **Cleans up** - Kills the tmux session after tests complete
+
+## Test Cases
+
+### Input Editing
+
+- **Character insertion**: Typing "hello" should insert characters correctly
+- **Backspace**: Deleting characters before the cursor
+- **Delete key**: Deleting character at the cursor position
+
+### Cursor Navigation
+
+- **Left arrow**: Moving cursor left one character
+- **Right arrow**: Moving cursor right one character
+- **Meta+Left**: Jumping to previous word boundary
+- **Meta+Right**: Jumping to next word boundary
+
+### History Navigation
+
+- **Up arrow**: Navigating backward through command history
+- **Down arrow**: Navigating forward through command history
+
+### Tab Completion
+
+- **Slash commands**: Tab after `/` shows available commands
+- **File references**: Tab after `@` completes file paths
+
+### Smart Features
+
+- **Double space**: Two spaces within 500ms converts to period + space
+
+### Escape Key
+
+- **Clear input**: Escape clears the current input buffer
+
+## Requirements
+
+- **tmux**: Must be installed on your system (`brew install tmux` on macOS)
+- **Bun**: Must have bun installed to run the tests
+- **opencode-miniterm**: Must be able to run the application
+
+## Troubleshooting
+
+### Tests fail with "Expected prompt to contain X"
+
+The test might be running too fast. Increase `WAIT_MS` at the top of the test file.
+
+### Tests hang or timeout
+
+The application might be stuck in a command menu. Press `Escape` or `C-c` in the tmux session to recover.
+
+### tmux session already exists
+
+The script automatically kills existing test sessions. If you see errors, manually run:
+
+```bash
+tmux kill-session -t opencode-test
+```
+
+### Tests don't start
+
+Ensure tmux is installed and working:
+
+```bash
+tmux -V
+tmux new-session -d -s test
+tmux kill-session -t test
+```
+
+## Adding New Tests
+
+To add a new test:
+
+1. Create an async test function that:
+   - Clears input with `await clearInput()`
+   - Sends keystrokes with `await sendKeys("key")`
+   - Waits for processing with `await sleep(ms)`
+   - Captures output with `await capturePane()`
+   - Asserts behavior with `assertPromptContains()` or `assertContains()`
+   - Throws errors with descriptive messages
+
+2. Register the test in `runAllTests()`:
+   ```typescript
+   await runTest("Your test name", testYourFunction);
+   ```
+
+### Example Test
+
+```typescript
+async function testYourFeature(): Promise<void> {
+	await clearInput();
+	await sendKeys("test");
+	await sendKeys("Enter");
+	await sleep(1000);
+
+	const output = await capturePane();
+	if (!assertContains(output, "expected text")) {
+		throw new Error(`Expected output to contain 'expected text'`);
+	}
+}
+```
+
+## Command Menu Tests
+
+For examples of testing the interactive command menus (agents, models, sessions), see `tmux-menu-examples.ts`. This file demonstrates:
+
+- How to enter command menus (`/agents`, `/models`, `/sessions`)
+- How to navigate menu options (Up, Down)
+- How to filter/search within menus
+- How to select items (Enter)
+- How to cancel menus (Escape)
+- How to verify the results
+
+## Key Constants
+
+- `TMUX_SESSION`: "opencode-test" - The tmux session name
+- `TMUX_WINDOW`: "readline-test" - The tmux window name
+- `WAIT_MS`: 100 - Default wait time between keystrokes
+- `APP_PATH`: Path to the application entry point
+
+## Helper Functions
+
+- `setupTmux()` / `teardownTmux()`: Create/destroy test environment
+- `startApp()` / `stopApp()`: Start/stop the application
+- `sendKeys(keys)`: Send keystrokes to tmux (e.g., "C-c", "Enter", "M-Left")
+- `capturePane()`: Get current terminal output
+- `clearInput()`: Clear the current input line
+- `assertContains(output, expected)`: Check if output contains text
+- `assertPromptContains(text, expected)`: Check if prompt contains text
+- `stripAnsi(text)`: Remove ANSI escape codes from text

package/test/render.test.ts

@@ -193,7 +193,6 @@ describe("render", () => {
 			render(state);
 
 			const output = stripANSI(write.mock.calls.map((c) => c[0]).join("")).replaceAll("  ", "");
-			console.log(output);
 			expect(output).toContain("foo\nbar\n\n💭 ok");
 			expect(output).toContain("stuff\n\nbaz");
 		});

package/test/tmux-menu-examples.ts

@@ -0,0 +1,119 @@
+// Example: How to add command menu tests
+// This file contains examples for testing the interactive command menus
+import { $ } from "bun";
+
+const TMUX_SESSION = "opencode-test-menu";
+
+async function testAgentMenu(): Promise<void> {
+	console.log("Testing agent menu navigation");
+
+	// Start with /agents command
+	await $`tmux send-keys -t ${TMUX_SESSION} "/agents" Enter`;
+	await sleep(500);
+
+	// Send some filter text
+	await $`tmux send-keys -t ${TMUX_SESSION} "code"`;
+	await sleep(100);
+
+	// Navigate up
+	await $`tmux send-keys -t ${TMUX_SESSION} Up`;
+	await sleep(100);
+
+	// Navigate down
+	await $`tmux send-keys -t ${TMUX_SESSION} Down`;
+	await sleep(100);
+
+	// Clear filter
+	await $`tmux send-keys -t ${TMUX_SESSION} C-u`;
+	await sleep(100);
+
+	// Cancel with escape
+	await $`tmux send-keys -t ${TMUX_SESSION} Escape`;
+	await sleep(100);
+
+	// Verify we're back at prompt
+	const output = await capturePane();
+	if (!assertPromptContains(output, "#")) {
+		throw new Error("Should be back at prompt");
+	}
+}
+
+async function testModelMenu(): Promise<void> {
+	console.log("Testing model menu navigation");
+
+	await $`tmux send-keys -t ${TMUX_SESSION} "/models" Enter`;
+	await sleep(500);
+
+	// Navigate through options
+	await $`tmux send-keys -t ${TMUX_SESSION} Down`;
+	await sleep(100);
+	await $`tmux send-keys -t ${TMUX_SESSION} Down`;
+	await sleep(100);
+
+	// Select a model
+	await $`tmux send-keys -t ${TMUX_SESSION} Enter`;
+	await sleep(200);
+
+	// Verify selection worked
+	const output = await capturePane();
+	if (!assertContains(output, "Model changed")) {
+		throw new Error("Model should be changed");
+	}
+}
+
+async function testSessionMenu(): Promise<void> {
+	console.log("Testing session menu navigation");
+
+	await $`tmux send-keys -t ${TMUX_SESSION} "/sessions" Enter`;
+	await sleep(500);
+
+	// Test pagination
+	await $`tmux send-keys -t ${TMUX_SESSION} Down`;
+	await sleep(100);
+	await $`tmux send-keys -t ${TMUX_SESSION} Down`;
+	await sleep(100);
+
+	// Select a session
+	await $`tmux send-keys -t ${TMUX_SESSION} Enter`;
+	await sleep(200);
+
+	// Verify we're using the selected session
+	const output = await capturePane();
+	if (!assertContains(output, "Session loaded")) {
+		throw new Error("Session should be loaded");
+	}
+}
+
+// Note: These are example tests that would need to be integrated
+// into the main tmux-readline.test.ts file. They demonstrate:
+// 1. How to enter command menus (/agents, /models, /sessions)
+// 2. How to navigate menu options (Up, Down)
+// 3. How to filter/search within menus
+// 4. How to select items (Enter)
+// 5. How to cancel menus (Escape)
+// 6. How to verify the results
+
+function sleep(ms: number): Promise<void> {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function capturePane(): Promise<string> {
+	const result = await $`tmux capture-pane -t ${TMUX_SESSION} -p`.quiet();
+	return result.stdout.toString();
+}
+
+function assertPromptContains(text: string, expected: string): boolean {
+	const lines = text.split("\n");
+	for (const line of lines) {
+		if (line.includes("#")) {
+			return line.includes(expected);
+		}
+	}
+	return false;
+}
+
+function assertContains(output: string, expected: string): boolean {
+	return output.includes(expected);
+}
+
+export {};