#207 - Fix JsonStreamReaderTask / JsonStreamWriterTask

[njoubert-cleverage]

Description

Fixes #207.

JsonStreamFile has two problems:

1. Reader, scalar line: when a JSON Lines file contains a line that decodes to a scalar (42, "foo", true…), JsonStreamReaderTask crashes with a PHP TypeError coming from the ?array return type, without a useful message nor line number.
2. Writer, missing directory: JsonStreamWriterTask fails when the parent directory of file_path does not exist, while CsvWriterTask creates it (see CsvFile).

This PR:

• JsonStreamFile::readLine() checks the decoded value and throws an explicit \UnexpectedValueException naming the line number, the file path and the type found. The signature is unchanged and null lines are still skipped.
• JsonStreamFile::__construct() creates the parent directory recursively, as CsvFile does, for non-read modes only (standard streams are skipped). JsonStreamWriterTask (and the --output option of cleverage:process:execute with the json-stream format) then work with a path whose directory does not exist yet.
• Update the reference documentation, add unit tests.

The new regression tests fail on main and pass with this fix. PHPUnit, PHPStan, PHP-CS-Fixer and Rector pass.

Requirements

• Documentation updates
  • Reference
  • Cookbooks
  • Changelog
• Unit tests

Breaking changes

None. A scalar line now throws an \UnexpectedValueException instead of a \TypeError.

🤖 Generated with Claude Code