feat(cli): NDJSON stdin protocol, list subcommands, modularize run.ts

[cte]

Summary

• NDJSON stdin protocol: Overhaul stdin prompt stream from raw text lines to a structured command protocol (start, message, cancel, ping, shutdown) with requestId correlation, ack/done/error lifecycle events, and queue telemetry
• List subcommands: Add list commands, list modes, and list models for programmatic discovery of available resources (JSON and text output formats)
• Modularize run.ts: Extract ~500 lines of stdin stream logic into stdin-stream.ts, reducing run.ts from 917 to ~330 lines. Extract shared isRecord type guard into lib/utils/guards.ts
• JsonEventEmitter enhancements: Add emitControl() and emitQueue() methods, requestIdProvider for automatic correlation, and schema/protocol/capabilities metadata for init events

Files changed

File	Change
src/commands/cli/stdin-stream.ts	New — NDJSON parsing, queue helpers, stream orchestrator
src/commands/cli/list.ts	New — list subcommands with generic requestFromExtension<T> helper
src/lib/utils/guards.ts	New — shared isRecord type guard
src/commands/cli/run.ts	Shrink — replaced inline stdin logic with runStdinStreamMode() call
src/agent/json-event-emitter.ts	Enhanced — control/queue event emission, requestId injection
src/types/json-events.ts	Extended — control/queue event types, new fields
src/commands/cli/index.ts	Export list module
src/index.ts	Register list subcommands with Commander
scripts/test-stdin-stream.ts	Updated to use NDJSON commands

Tests added

• parse-stdin-command.test.ts — 19 tests for NDJSON command parsing (valid commands, error cases)
• json-event-emitter-control.test.ts — 8 tests for control event emission and requestId injection
• list.test.ts — 6 tests for parseFormat utility
• guards.test.ts — 5 tests for isRecord type guard

Test plan

• pnpm lint passes (0 warnings)
• pnpm check-types passes
• pnpm test passes (438 tests, 0 failures)
• Manual testing with scripts/test-stdin-stream.ts against a running provider

🤖 Generated with Claude Code

Start a new Roo Code Cloud session on this branch