[BUG] exec --output-schema validates schema but doesn't show what schema is expected

[xyz080125]

Project

cortex

Description

The flag accepts JSON schema file but doesn't explain expected schema format

Error Message

Debug Logs

System Information

$ bounty info
Bounty Challenge v0.1.0
OS: Linux 6.8.0-87-generic (Ubuntu 24.04.3 LTS)
CPU: Intel Core i7
RAM: 16 GB
Cortex Version: 0.1.1

Screenshots

No response

Steps to Reproduce

1. Run cortex exec --help

Expected Behavior

Should explain or link to JSON schema documentation

Actual Behavior

Just says 'JSON schema file for structured output'

Additional Context

No response

[echobt]

Thank you for reporting this issue! We've confirmed the problem and submitted a fix.

The help text for the --output-schema flag was indeed too vague. We've improved it to clearly explain what format is expected and provided an example of a valid schema structure. It now also includes a link to the official JSON Schema documentation.

The fix is now under review: CortexLM/cortex-cli#63

Once the fix is merged, it will be available in the next release. Thanks for helping us improve the documentation!