[tae898]

What does this PR do?

Item 2 of #306: a read-your-writes test for vector search, on both wheels. tests/test_vector_read_your_writes.py starts with 300 vectors and an index, then makes 200 committed inserts, each followed by a search for the vector just written. Test one does it in the writing task, with 4 tasks writing at once. Test two has one task write and 3 reader tasks search for each id after the writer announces it on a queue (after the commit returned). Every call runs through asyncio.to_thread, as the concurrency page says, so an insert and the next search of one task can run on different threads. The 200 inserts cross the rebuild threshold of 100 pending changes, so the searches meet the delta buffer first and the rebuilt graph later. ef_search covers the corpus, so a miss would mean the write was not seen. The test uses no Java object and runs on arcadedb and arcadedb-jvm.

The vectors page now says what an agent may rely on: a search finds every vector whose transaction committed before it started, from the same task or another one, also while the graph rebuilds. The concurrency page gets the asyncio anchor that sentence links to.

This is not the asyncio facade. That part of the issue waits for a decision on its names and on cancellation, see my comment on #306.

Related issues

Refs #306 (item 2 only, so no closing keyword).

Docs

how-to/vectors.adoc ("Agents that write as they go") and how-to/concurrency.adoc (the asyncio anchor).

Checklist

• A regression test fails on the old code and passes on the new: this is a test that pins existing behavior, so it passes on main. It would fail if a committed vector were missed by the next search.
• The test suite that the change can affect passes: CI runs it on both wheels.
• uvx pre-commit run --files <changed files> passes (black reformatted the test, now committed).

🤖 Generated with Claude Code

[tae898]

The red "Test arcadedb" legs are not from this PR: only test_import_database_csv_documents_with_quoted_parallel_setting and test_import_database_csv_graph_vertices_and_edges_with_quoted_parallel fail, because arcadedb#11367 was fixed upstream and the two tests still expect the refusal. I filed it as #376 and will not merge this PR while the legs are red.