[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