fix(validator): change format_version type from str to int

[cmworkato]

Summary

This PR fixes several validation bugs discovered during CLI testing.

Fixes

1. RecipeValidator format_version type mismatch

The Workato export package API returns format_version as an integer (2), not a string. This caused false validation errors for all exported recipes.

Error:
❌ Recipe validation failed Message: Recipe parsing failed: format_version should be string not int Type: syntax_invalid

Root Cause: The RecipeLine Pydantic model defined format_version as str | None, but the API returns an integer.

Fix: Changed the type from str | None to int | None to match the actual API response.

2. api-collections list ValidationError

The API returns project_id as an integer or null, but the model expected a string.

Error:
ValidationError: 1 validation error for ApiCollection project_id: Input should be a valid string

Fix: Made project_id optional and added a validator to coerce int to string.

3. api-clients list ValidationError

The API can return null for api_policies and api_collections, but the model required non-null lists.

Error:
ValidationError: 1 validation error for ApiClient api_policies: Input should be a valid list

Fix: Made api_policies and api_collections optional with default=None.

4. connections pick-lists command path error

The path to picklist-data.json was incorrect (cli/data instead of cli/resources/data).

Error:
Picklist data not found. Run 'python scripts/parse_picklist_docs.py' to generate it.

Fix: Corrected the path to cli/resources/data.

Testing

• Added unit test test_recipe_line_accepts_format_version_as_int
• Updated test_helpers.py to use correct data path
• Verified against 17 recipes exported from Workato - all now validate without errors
• All existing tests pass

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
__init__.py	68	4	94%	10–11, 69–70
cli
__init__.py	52	3	94%	49, 51, 60
containers.py	27	0	100%
cli/commands
__init__.py	0	0	100%
api_clients.py	292	9	96%	27, 302, 448–449, 483, 493, 585, 616, 624
api_collections.py	257	3	98%	28, 183, 347
assets.py	47	2	95%	57–58
connections.py	526	5	99%	596, 598, 604, 642, 995
data_tables.py	165	5	96%	31, 253, 267, 321–322
guide.py	166	1	99%	106
init.py	108	0	100%
profiles.py	351	28	92%	353, 370, 372–373, 376, 378, 381–384, 386–387, 389, 460–461, 541–542, 544–545, 547–548, 552, 556–557, 567–569, 622
properties.py	97	1	98%	21
pull.py	172	2	98%	193–194
workspace.py	39	2	94%	61, 71
cli/commands/connectors
__init__.py	0	0	100%
command.py	103	2	98%	131, 180
connector_manager.py	203	4	98%	176, 292, 300–301
cli/commands/projects
__init__.py	0	0	100%
command.py	272	10	96%	359–362, 373, 439–441, 491, 495
project_manager.py	166	7	95%	48, 66, 263–264, 276, 317, 325
cli/commands/push
__init__.py	0	0	100%
command.py	133	4	96%	109, 112, 230, 308
cli/commands/recipes
__init__.py	0	0	100%
command.py	427	9	97%	117, 133–134, 272–275, 403, 709
validator.py	706	20	97%	174, 883, 1136, 1223, 1246, 1279, 1281–1282, 1359–1361, 1457–1458, 1517–1518, 1707–1708, 1736–1738
cli/utils
__init__.py	4	0	100%
exception_handler.py	345	33	90%	134–135, 140–141, 143–144, 174–175, 181, 184–185, 270, 300, 333–337, 371, 398, 425, 482, 517, 576, 578–579, 584–585, 587–591
gitignore.py	14	0	100%
ignore_patterns.py	23	0	100%
spinner.py	43	0	100%
token_input.py	45	17	62%	70, 98, 100, 102–104, 107, 124, 127–128, 132–133, 136, 139–140, 142, 144
version_checker.py	135	6	95%	24, 26, 33–34, 72, 102
cli/utils/config
__init__.py	5	0	100%
manager.py	537	33	93%	130, 141, 152, 160–162, 165, 168, 180, 230–231, 404, 422, 426, 429–432, 448, 469, 483, 496, 538, 640–641, 680, 894, 1037–1038, 1052–1053, 1109, 1168
models.py	33	0	100%
profiles.py	334	15	95%	99, 195–196, 199, 234–236, 261–263, 522, 530, 541–542, 546
workspace.py	68	0	100%
TOTAL	5963	225	96%

[github-actions]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

[github-actions]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

[oalami]

@cmworkato linter is throwing an error

[github-actions]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.