Initial Commit

This commit is contained in:
2026-05-27 23:29:53 +01:00
commit fbc70f96e6
10000 changed files with 1102152 additions and 0 deletions

View File

@@ -0,0 +1,21 @@
# Spec: @suaveplan/readline
## Purpose
Terminal I/O primitive: async line reader, interactive readline interface, and byte scanner engine. Depends only on `@suaveplan/error`, `@suaveplan/types`, `@opentelemetry/api`, `zod`.
## ADDED Requirements
### readLines
- `readLines(stream: NodeJS.ReadableStream, signal?: AbortSignal): AsyncGenerator<string>`
- Yields each newline-delimited UTF-8 line
- Terminates cleanly on AbortSignal or stream close
### createInterface
- `createInterface(opts: { input, output?, signal? }): ReadlineInterface`
- Returns `{ question(prompt): Promise<string>, close(): void }`
- OTel span per `question()` call
- AbortSignal aborts pending question
### ByteScanner
- Internal engine for buffered byte-level scanning