Conversation
| // Validate the envelope structure | ||
| if (parsed.schema_version !== 1) { | ||
| throw new Error('Unsupported schema_version'); | ||
| } |
There was a problem hiding this comment.
Cleanup: the new "Contract fixtures and validator" section is a near-verbatim duplicate of the paragraph already present ~25 lines above it in the same file (both describe CI validating fixtures against packaged schemas via a Python validator and a Node.js reader). Consider merging to avoid having to update the same claim in two places.
| is unavailable or fails. | ||
|
|
||
| ## Optional output-format dependencies | ||
|
|
There was a problem hiding this comment.
Doc accuracy: this table says a missing PyYAML surfaces a raw ImportError: No module named 'yaml', but the code never lets that propagate — require_yaml() (lib/python/base_cli/_dependencies.py) catches ImportError and re-raises a RuntimeError with an actionable install hint, which the caller wraps into OutputFormatError. A user grepping logs for the documented string won't find it, and the doc omits the actual (more useful) message the CLI produces.
Summary
This PR addresses two documentation issues:
Changes
docs/output-contracts.mdyamlandrich.docs/json-contracts.mdJSON.parse.Notes
Both changes are documentation-only and follow the acceptance criteria defined in their respective issues.