[plan] Upgrade and enhance google/jsonschema-go integration

[github-actions]

Overview

This tracking issue covers the upgrade and enhancement of the google/jsonschema-go integration based on the Go Fan report from discussion #6818.

Source: Discussion #6818

Background

The google/jsonschema-go v0.4.0 was released yesterday (December 17, 2025) with important new features and critical bug fixes. The library is currently used minimally in gh-aw for MCP schema generation but has excellent potential for improvement.

Key Benefits of v0.4.0

• PropertyOrder feature: Deterministic property ordering (perfect for gh-aw's workflow YAML needs)
• Critical bug fixes: Nullable types for slices and non-native pointers
• Full Draft-07 support: Better compatibility with legacy systems
• JSON marshal consistency: Fixed marshaling bugs

Planned Tasks

This work is broken into focused, independent sub-issues:

1. Upgrade to v0.4.0 - Update dependency to latest version (URGENT)
2. Simplify GenerateOutputSchema - Use more idiomatic For[T]() pattern
3. Add schema validation test - Ensure generated schemas validate real output
4. Add comprehensive documentation - Document schema generation rules and MCP requirements
5. Add module summary spec - Create persistent documentation from Go Fan report

Priority

HIGH - v0.4.0 contains critical bug fixes and the PropertyOrder feature aligns perfectly with gh-aw's deterministic requirements.

Risk Assessment

VERY LOW - Minimal usage in codebase makes upgrade extremely safe with no breaking changes from v0.3.0.

AI generated by Plan Command for discussion #6818

[github-actions]

🎉 Automatically closed by Sub-Issue Closer

All sub-issues have been completed. This parent issue is now closed automatically.

Sub-issues status: 5/5 closed (100%)

• ✅ [plan] Upgrade google/jsonschema-go to v0.4.0 #6831: Upgrade google/jsonschema-go to v0.4.0
• ✅ [plan] Simplify GenerateOutputSchema to use idiomatic For[T]() pattern #6832: Simplify GenerateOutputSchema to use idiomatic ForT pattern
• ✅ [plan] Add schema validation test for round-trip testing #6833: Add schema validation test for round-trip testing
• ✅ [plan] Add comprehensive documentation to GenerateOutputSchema #6834: Add comprehensive documentation to GenerateOutputSchema
• ✅ [plan] Create module summary spec for google/jsonschema-go #6835: Create module summary spec for google/jsonschema-go

Ahoy! This treasure was crafted by 🏴‍☠️ Sub-Issue Closer