shx-helper/TODO.md

TODO

high value

• surface Zipline error bodies on failed uploads

  • HTTP failures now preserve the response body and print a parsed server message when available.

• validate the response shape before printing success output

  • successful responses are now rejected unless they include a non-empty .files array.

• add a --no-env / --env-file <path> flag

  • auto-loading /root/.openclaw/.env is handy here, but it makes the helper less portable and harder to use in CI or on another machine.
  • explicit env loading would keep the default convenience while making behavior predictable.

reliability / test gaps

• add tests for the unhappy paths that matter most

  • covered: missing file, missing token, missing jq in normal mode, server-side upload failure, and malformed success payloads.

• add a mock assertion that the upload request is formed correctly

  • the smoke tests now assert the auth header, upload endpoint, and multipart file=@... field.