Objective
Add the missing $comment field to stdio_mcp_tool definition in included_file_schema.json to match the documentation in main_workflow_schema.json.
Context
The main schema includes 780 bytes of validation constraint documentation in the stdio_mcp_tool.$comment field that explains:
- Mutual exclusion between
command and container
- Requirement for either
command or container
- Dependency of
network on container
- Type constraints for stdio/local modes
This documentation is missing from the included schema, creating inconsistent developer experience.
Approach
- Open
pkg/parser/schemas/main_workflow_schema.json
- Copy the
$comment field from $defs.stdio_mcp_tool
- Open
pkg/parser/schemas/included_file_schema.json
- Add the same
$comment field to $defs.stdio_mcp_tool
- Verify JSON formatting is valid
Files to Modify
pkg/parser/schemas/included_file_schema.json - Add $comment to stdio_mcp_tool
Acceptance Criteria
AI generated by Plan Command for discussion #8801
Objective
Add the missing
$commentfield tostdio_mcp_tooldefinition inincluded_file_schema.jsonto match the documentation inmain_workflow_schema.json.Context
The main schema includes 780 bytes of validation constraint documentation in the
stdio_mcp_tool.$commentfield that explains:commandandcontainercommandorcontainernetworkoncontainerThis documentation is missing from the included schema, creating inconsistent developer experience.
Approach
pkg/parser/schemas/main_workflow_schema.json$commentfield from$defs.stdio_mcp_toolpkg/parser/schemas/included_file_schema.json$commentfield to$defs.stdio_mcp_toolFiles to Modify
pkg/parser/schemas/included_file_schema.json- Add $comment to stdio_mcp_toolAcceptance Criteria
$commentfield exists in included_file_schema.json stdio_mcp_tool definitionRelated to [plan] Fix schema consistency issues found in analysis #8804