diff --git a/CHANGELOG.md b/CHANGELOG.md index 8430101..dcd892e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Changed +- Clarified output-line arrays and valid omission or empty arrays when no stdout or stderr was captured, on final results and previous attempts. + - Documented legacy `id` removal in 1.0.0 and version-based migration while retaining current acceptance and optional `testId`. - Clarified durable attachment references, optional producer-local paths and producer-defined digest metadata. diff --git a/schema/ctrf.schema.json b/schema/ctrf.schema.json index 8cfc232..fc0e392 100644 --- a/schema/ctrf.schema.json +++ b/schema/ctrf.schema.json @@ -316,14 +316,14 @@ "type": "string" }, "stdout": { - "description": "Standard output lines from this attempt", + "description": "Standard output from this attempt, one string per output line", "type": "array", "items": { "type": "string" } }, "stderr": { - "description": "Standard error lines from this attempt", + "description": "Standard error from this attempt, one string per output line", "type": "array", "items": { "type": "string" @@ -383,14 +383,14 @@ "type": "boolean" }, "stdout": { - "description": "Standard output lines from test execution", + "description": "Standard output, one string per output line", "type": "array", "items": { "type": "string" } }, "stderr": { - "description": "Standard error lines from test execution", + "description": "Standard error, one string per output line", "type": "array", "items": { "type": "string" diff --git a/spec/ctrf.md b/spec/ctrf.md index efbd719..7ed4c74 100644 --- a/spec/ctrf.md +++ b/spec/ctrf.md @@ -1154,8 +1154,9 @@ If present, it MUST be a boolean. Lines of standard output generated during test execution. **Requirements:** -`stdout` is OPTIONAL. -If present, it MUST be an array of strings. +`stdout` is OPTIONAL. +If present, it MUST be an array of strings, with one entry per output line. +If no output was captured, producers MAY omit `stdout` or emit an empty array. ### 9.24. `stderr` @@ -1163,8 +1164,9 @@ If present, it MUST be an array of strings. Lines of standard error output generated during test execution. **Requirements:** -`stderr` is OPTIONAL. -If present, it MUST be an array of strings. +`stderr` is OPTIONAL. +If present, it MUST be an array of strings, with one entry per output line. +If no output was captured, producers MAY omit `stderr` or emit an empty array. ### 9.25. `threadId` @@ -1540,8 +1542,9 @@ If present, it MUST be a string. A list of standard output lines captured during the attempt. **Requirements:** -`stdout` is OPTIONAL. -If present, it MUST be an array of strings. +`stdout` is OPTIONAL. +If present, it MUST be an array of strings, with one entry per output line. +If no output was captured, producers MAY omit `stdout` or emit an empty array. ### 11.10. `stderr` @@ -1549,8 +1552,9 @@ If present, it MUST be an array of strings. A list of standard error lines captured during the attempt. **Requirements:** -`stderr` is OPTIONAL. -If present, it MUST be an array of strings. +`stderr` is OPTIONAL. +If present, it MUST be an array of strings, with one entry per output line. +If no output was captured, producers MAY omit `stderr` or emit an empty array. ### 11.11. `start` @@ -2432,14 +2436,14 @@ to this specification. "type": "string" }, "stdout": { - "description": "Standard output lines from this attempt", + "description": "Standard output from this attempt, one string per output line", "type": "array", "items": { "type": "string" } }, "stderr": { - "description": "Standard error lines from this attempt", + "description": "Standard error from this attempt, one string per output line", "type": "array", "items": { "type": "string" @@ -2499,14 +2503,14 @@ to this specification. "type": "boolean" }, "stdout": { - "description": "Standard output lines from test execution", + "description": "Standard output, one string per output line", "type": "array", "items": { "type": "string" } }, "stderr": { - "description": "Standard error lines from test execution", + "description": "Standard error, one string per output line", "type": "array", "items": { "type": "string"