[leemour]

Task

Remove the size caps that exist only because files were read whole, label the two channels of a stereo recording with the real people, and rewrite the README limits and the overview's "What it does not do yet" so a reader sees first what works.

Why

• Master.csv over 512 MB was refused, because it was read into memory whole.
• A one-hour 48 kHz stereo WAV (about 690 MB) was refused by the 256 MB recording cap, although cli-core accepts an hour of audio.
• Stereo transcripts said Channel 1 / Channel 2, which nobody can act on.
• The owner could not understand the Limits lines: they read as weaknesses ("CEL, AMI and ARI are not read", "mono … no speakers") when they describe what is supported.

What

• Master.csv streamed (src/cdr/csv.ts, src/cdr/reader.ts, src/files.ts): FileAccess.stream; the CSV parser keeps its state across pieces (quote, doubled quote, CRLF, quoted newline), UTF-8 decoded with stream: true, and rows older than the sync are dropped by their start time before the full row is read. Stream errors name no path (WC-SECR-6). Over SFTP, cli-core's client reads only whole files, so stream yields one read capped at 512 MB (src/sftp-files.ts).
• Recordings (src/transcribe-calls.ts): what ffmpeg decodes (WAV, GSM, M4A, SLN) up to 2 GiB − 1 byte; MP3/Ogg/FLAC stay at 256 MB, since the bundled decoders decode the whole file before cli-core checks the hour. The local read no longer copies the buffer.
• recordings_channels (caller,employee | employee,caller), validated in src/config.ts: stereo lines name the caller (name + number) and the employee (extension + name) from the stored call; without it, Channel N. Not declared with a default: absence means something no value says (WC-CMD-30). Meeting metadata gains client.
• Docs (WC-DOC-8): README Limits, docs/index.md (H1 # Asterisk, new "What it does not do yet"), docs/installation.md (Desktop's Countries of your phone lines field, sizes, channel labels), docs/configuration.md, docs/roadmap.md.
• Changelog fragment changes/feat-limits-and-plain-docs.md (Added, Fixed; WC-DOC-15).

Testing

• pnpm lint, pnpm typecheck, pnpm test (152 passed, one worker), pnpm docs:check, generate:check, contracts:check, lint:commands, audit:commands, test:matrix:check, security:no-leak, version:check, package:check.
• New tests: the parser gives the same rows for every split of a tricky text; a generated 4 MB Master.csv (more than one 1 MB read piece, Cyrillic names, CRLF inside a field) keeps only new rows; a missing file names no path; stereo labels with and without the setting; a bad value is refused; per-format recording caps.
• Built CLI with throwaway HOME/XDG and DBUS_SESSION_BUS_ADDRESS=disabled:: a generated 629 MB Master.csv synced with a 458 MB peak RSS (old code refused it). A generated one-hour 48 kHz stereo WAV (690 MB) through cli-core's decodeChannels peaked at 1.43 GB RSS.

🤖 Generated with Claude Code