suaveplan/openspec/archive/2026-04-20-enterprise-readline/proposal.md

OpenSpec Change: enterprise-readline

Change ID: enterprise-readline
Date: 2026-04-20
Status: Shipped
Spec: docs/superpowers/specs/2026-04-20-readline-cli-design.md

Summary

Introduces @suaveplan/readline as a new universal/platform package providing terminal I/O primitives: AsyncGenerator line reader (readLines), interactive prompt interface (createInterface), and byte scanner engine. This package satisfies @suaveplan/cli's prompt module dependency on a universal readline abstraction instead of node:readline directly.

ADDED Requirements

• readLines(stream, signal?) — async generator yielding UTF-8 lines
• createInterface({ input, output?, signal? }) — interactive readline interface with question() and close()
• ByteScanner — low-level byte scanner engine
• OTel spans on createInterface operations
• AbortSignal support throughout
• 100% istanbul coverage