Repository navigation
Conversation
Compacted capsules separate proof pages with Git payloads. Copy proof-only sections into one footer-bound region and share a bounded page/block cache to remove per-edit network round trips. Keep visibility reconciliation and dictionary limits intact. Advance the unshipped run footer to version 5; audited published release objects do not contain this capsule format. Logical replay and historical byte growth remain separate required work.
This was referenced Oct 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Opening a current catalog issued one header read and one change-page read per logical visibility edit, even after compaction put the history in one physical run. In the isolated canonical-session fixture, 2 / 8 / 32 edits took 8 / 20 / 68 provider read attempts. This change takes 5 / 5 / 5 while preserving reconciliation and the distinct-object proof limit.
Compacted runs copy their visibility sections into one contiguous proof-only region. The footer commits its span and digest; complete inspection also checks each copy against the original capsule. Logical controls share one cache for authenticated decoded pages and 64 KiB opaque proof blocks, bounded to 8 MiB / 256 entries per run. Page hashes remain mandatory, and cold/warm admission charges full blocks before I/O. Four asynchronous fetch lanes coalesce neighboring page misses while warm hits remain independent. Leaf runs retain their original coordinates. Existing expected-old, inherited closure, removal, ordering and catalog precedence rules are unchanged.
Stacked on #598. Run footer version 5 rejects retired unshipped versions 1–4. A fresh audit of six published tag objects and 19 known local tag objects found no current capsule format; the differing published/local v1.2.4 objects were both checked without replacing the local tag. Released v1 storage is unaffected. The corruption harness now targets version 5 and explicitly rejects version 4.
Validation on commit
9e5c081b351(all guarded source bytes unchanged):make installand both qualification binaries completed. The first CLI variant reports the base SHA because its build began before the commit; source fingerprints bind the compiled inputs to this change. Stable-head identity checks for all final release artifacts remain required.Evidence map: current file-index opening enters shared catalog capture; Git and catalog consumers both load authenticated run controls through
load_capsule_run_git_control.CapsuleRunowns format/compaction,CapsuleVisibilityReaderowns rooted proof lookup, and the existing metadata page cache owns bounded read coalescing. Full maintenance readers still verify original capsule sections and the copied pool. Captured-visibility tests exercise closure membership separately from physical presence. The source-bound before-change regression establishes the transport problem on #598’s head; it is not a measured current-main latency claim.Is this the best fix? Co-location addresses the measured request amplification at the existing compaction and page-cache boundaries without skipping proof checks or reading across Git payloads. It adds one copy of compacted visibility metadata; Git payloads are not duplicated by this change. The additional implementation owns the wire region, shared eviction/admission and concurrent block reads; tests cover re-signed routing, substituted evidence, prefetched-page tampering and resource bounds.
This is a partial performance step, not the completed opening redesign: logical control replay, differing addition-set enumeration and increasing historical bytes/runs remain required work. Hosted S3 latency, broader lifecycle gates, fuller Git blame and the final six-case 10 GiB matrix also remain open. The #598 matrix’s first fresh push failed a readback digest check; a later diagnostic retry succeeded with 161 exact wire-body comparisons. That retry does not turn the failed matrix into a pass.
The user-owned advisor plan and both excluded large-file audit reports are absent from this diff. No inventory, baseline, assertion or lint policy is relaxed.