---
title: "Verify interrupted sync resumes at the correct cursor"
description: "Test a sandbox connector paused between source pages, checking that resumption imports every record exactly once and preserves the committed checkpoint."
canonical_url: "https://vostride.com/agent-library/integrations-sync/cursor-pagination-checkpoint.md"
md_url: "https://vostride.com/agent-library/integrations-sync/cursor-pagination-checkpoint.md"
content_kind: "recipe"
topic: "integrations-sync"
---

# Verify interrupted sync resumes at the correct cursor

Test a sandbox connector paused between source pages, checking that resumption imports every record exactly once and preserves the committed checkpoint.

## Risk

A cursor advanced before data commit can lose a page; a cursor saved too late can replay it. Exact source identifier coverage and preserved destination mappings are stronger evidence than a final synchronized count.

## Fixtures

- An owned sandbox source with three pages of synthetic records and a stable independently captured identifier manifest.
- An external worker fixture that interrupts the connector after the second page commit but before the next fetch, recording the checkpoint boundary.
- A read-only checkpoint and destination mapping oracle with product-documented resume behavior.

## Steps

1. Start the sandbox sync and verify the external fixture reaches the prepared second-page interruption checkpoint.
2. Inspect the visible sync status and verify it indicates interruption or retryable incompletion rather than a completed full import.
3. Resume through the documented product control and verify the sync reaches a terminal successful state for the same source scope.
4. Compare all destination mappings with the independent three-page manifest and verify each source identifier appears once, existing mappings remain stable, and the checkpoint reaches the final page.

## Expected results

- Resumption covers every source record across the interrupted boundary.
- Previously committed records retain their destination identities without duplicate rows.
- The final checkpoint corresponds to a fully committed complete source traversal.

## False-pass traps

- A total count can hide one duplicated record replacing one missing record.
- Interrupting before the first page does not exercise persistence at an intermediate cursor boundary.

## Cleanup

- Remove the sandbox imported dataset and reset the external worker interruption and checkpoint fixtures.

## Use with agent-qa

Adapt this test design to your application's acceptance criteria and configured target using the [recipe execution guide](/agent-library/software-factory/turn-a-recipe-into-an-agent-qa-test.md). External fixture setup and non-UI checks require your own supported hooks or test tooling. Validate the authored test, execute it, and inspect the completed evidence; this recipe is not a recorded test result.

## References

- [agent-qa first test](/docs/agent-qa/guides/first-test.md)
- [agent-qa hooks](/docs/agent-qa/guides/hooks.md)
- [agent-qa test](/docs/agent-qa/configuration/test.md)

- [Integration and synchronization QA recipes](/agent-library/integrations-sync.md)
- [Software factory QA library](/agent-library.md)