Document extract.codes strategy, min/max_length, sort_order, disallow…

[mborodii-prog]

Summary

• Documents all extract.codes parameters added in PR Update extract codes with new parameters #744 (min_length, max_length, strategy, sort_order, disallowed_patterns, include_multi_part_tokens)
  plus the previously undocumented extract_raw, none of which had any docstring coverage in wrangles/extract.py::codes().
• Clarifies the strategy parameter: per backend behavior, balanced and strict currently apply identical filtering (balanced_or_greater = {'balanced',
  'strict'}); only lenient differs by skipping that filter. Default is balanced.

Why

Issue #795 reported that strategy was added to the schema but never fully explained — the docs implied three distinct aggressiveness tiers when the
backend only distinguishes two behaviors. This was verified against the reference implementation (model.py) and reflected accurately in both docstrings.

Changes

• wrangles/extract.py — added full :param:/:return: documentation to codes().
• wrangles/recipe_wrangles/extract.py — updated the strategy schema description with the balanced/strict clarification and default; added the missing
  extract_raw schema property.

Allow extract.codes tests to pass against both current service behavior and PR #21 behavior
Accept old and new invalid sort_order service error messages

[ebhills]

Queue triage (2026-07-27)

• Disposition: Ready for review
• Delivery owner: @mborodii-prog
• Primary reviewer: @thomasstvr
• Next action: Review the documentation against actual extract.codes behavior and the service-compatible tests.

Please keep the branch current and put the decision in GitHub. This is one of the five active review slots.

[mborodii-prog]

@thomasstvr @ebhills documentation is up to date with main branch https://github.com/wrangleworks/Wrangles-Extract-Codes/tree/main