Skip to content

docs: explain read completeness contract - #3

Merged
marcomc merged 1 commit into
release/0.3.0from
docs/read-completeness
Sep 13, 2026
Merged

marcomc merged 1 commit into
release/0.3.0from
docs/read-completeness

Conversation

@marcomc

@marcomc marcomc commented Sep 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add a library-neutral guide for the read-completeness contract.
  • Link the guide from the README and add its table of contents.
  • Explain complete, partial, error, and unloaded results; scoped reads; safe diagnostics; coherent observation; and snapshot ownership.

Dependency

This documentation describes the public read API introduced by #2. Keep this PR as a draft until that dependency is merged into release/0.3.0; it is intentionally suitable for inclusion with a later, narrower implementation PR.

Validation

  • uv run ruff check .
  • uv run ruff format --check .
  • markdownlint --config /Users/mmassari/.markdownlint.json README.md docs/read-completeness.md
  • git diff --check

@marcomc
marcomc force-pushed the docs/read-completeness branch from 8a47abb to a11ea43 Compare September 13, 2026 13:09
@marcomc
marcomc marked this pull request as ready for review September 13, 2026 13:09
@marcomc
marcomc merged commit 9f5b957 into release/0.3.0 Sep 13, 2026
2 checks passed
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 13, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
🔒 Security Review ✅ Completed 2026-09-13T13:11:59.353844Z a11ea43 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@marcomc
marcomc deleted the docs/read-completeness branch September 26, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant