Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/book/src/architecture/change-feed.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,7 @@ Both return one page:
"valid_from": "2026-04-03", "valid_to": null
}
],
"since": 42,
"next_tx": 43,
"watermark_tx": 43,
"watermark_timestamp": "2026-04-03",
Expand All @@ -88,7 +89,12 @@ Both return one page:
```

Pass `next_tx` back as the cursor (`--from` / `since`). On an empty page it
stays put, so polling is a fixpoint, not a rewind. `Ref` values resolve to
stays put, so polling is a fixpoint, not a rewind. `since` echoes the cursor
the page answers: the page holds every transaction in scope in
`(since, next_tx]`. A follower whose own cursor is below `since` has missed
the transactions between them and must resume from its cursor rather than
apply the page. The chunked `begin` and `commit` frames carry the same
`since`. `Ref` values resolve to
`{"ref": "<iri>"}` so a consumer can tell an edge from a string that happens
to look like one. Bytes arrive as `{"bytes_len": n, "base64": "..."}` — the
whole body, so a replica built from the feed holds the same value.
Expand Down
2 changes: 1 addition & 1 deletion docs/knowledge/repository-knowledge.json
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@
"source": "src/lib.rs",
"subject": "http://aegis.gastown.local/ontology/code/quipu/src%2Flib.rs",
"summary": "The Rust library exposes the embedded graph engine used by native clients and repository integrations.",
"source_sha256": "824b93dc8e56c4199a7ded61398ea444524ed106bf8bc9dec5e58ef879bb0784",
"source_sha256": "827def19e784624513b3c4e0d67ae936e31fefb12bf67f464e9239ec3a3fee53",
"properties": {
"interfaceKind": "library",
"publicName": "quipu"
Expand Down
Loading
Loading