Batch large document metadata chunk sync

[Chad Palmer (chadpalmer)]

Summary

• Adds resumable batching for document metadata search chunk synchronization so large uploaded documents do not require one long metadata-save request.
• Updates the personal workspace Save Metadata flow to continue short JSON PATCH requests until chunk sync is complete.
• Removes duplicate tag search chunk propagation while preserving blob metadata tag updates.

Why

Saving tags or other metadata for large XML/large document uploads could time out while synchronizing every search chunk. The browser then tried to parse the timeout HTML response as JSON, surfacing an invalid JSON error even though the underlying issue was the long-running metadata update.

Changes

• update_document() now supports chunk_sync_limit, chunk_sync_offset, and chunk_sync_fields, returning progress when search chunk metadata sync needs continuation.
• The personal document metadata PATCH route now applies metadata updates once, returns chunk-sync continuation state, validates continuation offsets, and returns a stable JSON error on failure.
• workspace-documents.js now retries/continues the metadata PATCH flow until chunk sync completes.
• Added fix documentation and release notes for v0.261.051.
• Added a focused functional regression test for batch-and-resume chunk sync.

Validation

• git diff --check upstream/Development...HEAD
• python -m py_compile application/single_app/config.py application/single_app/functions_documents.py application/single_app/route_backend_documents.py functional_tests/test_document_metadata_chunk_sync_batching.py
• python functional_tests/test_document_metadata_chunk_sync_batching.py
• node --check application/single_app/static/js/workspace/workspace-documents.js
• python scripts/check_swagger_routes.py application/single_app/route_backend_documents.py
• python functional_tests/route_tests/test_route_blueprint_policy_inventory.py
• python functional_tests/route_tests/test_route_unauthenticated_policy_contract.py
• python functional_tests/route_tests/test_route_policy_test_coverage.py
• python scripts/check_xss_sinks.py --base-sha upstream/Development --head-sha HEAD application/single_app/functions_documents.py application/single_app/route_backend_documents.py application/single_app/static/js/workspace/workspace-documents.js
• python scripts/check_broken_access_control.py --base-sha upstream/Development --head-sha HEAD application/single_app/functions_documents.py application/single_app/route_backend_documents.py
• python functional_tests/test_docs_site_quality.py

Notes

• Local browser UI tests were not run because the app/authenticated browser state was not started during validation.
• Recommended manual smoke test: upload or select a large processed document, add/select a tag such as bills, click Save Metadata, and confirm the dialog completes without an invalid JSON error.

[Chad Palmer (chadpalmer)]

Paul Lizer (@paullizer) Bionic711 This PR fixes an issue where a user adding a metadata tag to a large document causes a invalid json error due to an html error page being sent back that is caused by a long request timing out during the metadata update process.

[Paul Lizer (paullizer)]

Great! Thanks for sharing, I didnt know this was a bug. I will investigate improving the underlying code to better support large files.