Document conditional HTTP polling pause

Changed

 CHANGELOG.md        | 2 +-
 docs/shared-http.md | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

Diff

CHANGELOG.mdmodified

@@ -11,7 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

- Use a separate HTTP index connection for reads, keeping uncommitted census/write rows private. Concurrent reads can finish before an in-flight write and see its previous committed state. Reads still have per-query SQLite consistency and atomic Markdown files, without a global multi-file snapshot. The 15-second outside-edit census is unchanged.

- Reduce JSON response encoding CPU with sigil-json's native string escaping. Require sigil-json 0.16.2 and sigil-mcp 0.18.4. HTTP tool replies remain JSON-RPC JSON documents and use chunked responses; stdio is unchanged.

- Skip unused snippets in note-list searches while retaining default search-index snippets, ranking and filters. Locate existing full-text rows by indexed literal name for updates, falling back to the previous scan for tokenless/missing names or lookup failure. Keep the existing schema and transactions.

−14

- Allow socket polling between HTTP tool execution and response encoding with a one-millisecond cooperative pause; individual CPU-bound phases remain cooperative.

+14

- HTTP tools taking over ten milliseconds allow socket polling before response encoding with a one-millisecond cooperative pause; fast tools can reply immediately, and individual CPU-bound phases remain cooperative.

## [0.3.3] - 2026-10-24

docs/shared-http.mdmodified

@@ -29,8 +29,9 @@ for another process's store lock leaves independent reads free to complete.

CPU-bound calls still share one thread; they are not preempted. Mutating tool

handlers are serialized through their index flush, including inbox reads that

may backfill ids. Other read tools do not enter that writer queue.

−32

The transport allows socket polling between tool execution and JSON encoding

−33

with a one-millisecond cooperative pause. Either phase can still delay peers

+32

Tools taking over ten milliseconds allow socket polling before JSON encoding

+33

with a one-millisecond cooperative pause; faster tools can reply immediately.

+34

Either phase can still delay peers

while it uses the thread. Note listings skip unused full-text snippets, and

updates locate existing full-text rows through their indexed names.