feat: add autohooks plugin to sort JSON keys in test ref files

[benflexcompute]

Summary

• Adds a new autohooks pre-commit plugin (flow360/_autohooks/sort_json.py) that automatically sorts keys in staged tests/**/*.json files
• Registers the plugin in pyproject.toml alongside existing black, isort, and pylint hooks
• Updates README with pre-commit hooks setup instructions

Usage

After cloning / pulling this branch, activate the pre-commit hooks once:

poetry run autohooks activate

From now on, every git commit will automatically:

1. Format code with black
2. Sort imports with isort
3. Lint with pylint
4. Sort keys in tests/**/*.json reference files

The hooks only process staged files, so they are fast. If you don't activate, CI will still catch issues.

Test plan

• Verified plugin runs during git commit via autohooks
• Confirmed unsorted JSON keys are automatically fixed before commit
• Existing black/isort/pylint hooks continue to work

🤖 Generated with Claude Code

---

Note

Low Risk
Low risk: changes are limited to developer tooling/docs and only mutate staged tests/**/*.json files during commits, with no runtime or production code impact.

Overview
Adds a new autohooks pre-commit plugin (flow360/_autohooks/sort_json.py) that reuses tools/sort_ref_json.py to sort keys in staged tests/**/*.json files, stashing unstaged changes and re-staging updated files for clean diffs.

Registers the plugin in pyproject.toml alongside black/isort/pylint, and updates the README with hook activation instructions plus a manual check in step to run the JSON sorter.

^{Written by Cursor Bugbot for commit cd0bf49. This will update automatically on new commits. Configure here.}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9702424334

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}