Skip to content

grasp: storage inventory separates current dependencies from retained bookkeeping - #18

Merged
FelineStateMachine merged 3 commits into
mainfrom
feat/grasp-storage-inventory
Sep 4, 2026
Merged

FelineStateMachine merged 3 commits into
mainfrom
feat/grasp-storage-inventory

Conversation

@FelineStateMachine

@FelineStateMachine FelineStateMachine commented Sep 4, 2026 •

Copy link
Copy Markdown
Owner

Motivation

The growing-tag benchmark retains about 2.15 MB, but that number does not distinguish current-format dependencies, superseded metadata and conservative quota reservations.

Change

The isolated checkpoint fixture now compares 260 transactions with one fixed ref against 260 growing refs. A read-only helper reconciles every paginated R2 key and size against the quota ledger, traverses current dependencies, verifies all historical receipt lookups and checks that the root remains unchanged.

The growing fixture contains 2,147,926 physical/reserved bytes: 144,084 current-format bytes and 2,003,842 superseded metadata bytes. The fixed-ref fixture contains 512,431 bytes, with 136,809 current-format bytes. Both have zero reservation slack. An untouched fixture uses zero Git-object bytes; its first commit uses 631 bytes. These are workload measurements, not a platform floor or permission to delete objects while readers or publishers remain active.

Fuel and cost documentation explains the categories. Runtime behavior, rates, receipt retention and production storage remain unchanged. Retained bookkeeping continues to count toward the tenant's existing file allowance; this change adds no production operations or wakes. README and landing copy remain accurate and already link the expanded fuel/cost documentation.

Stacks on #17; #16 and #17 retain their existing heads.

Testing Completed

  • Typecheck passes for each commit.
  • All 196 unit/object tests pass locally, including three checkpoint integration tests with local R2, ambiguous-write reservation and quota checks.
  • CI exposed a pre-existing expiry-test race; the test now checks no publication directly and allows alarm cleanup to remove an expired event.
  • The backend task independently validates cold reads and every historical retry using separate copies containing only current-format dependencies. It confirms the same interpretation with different fixture byte totals.
  • No production deployment, migration or deletion.

Responsible AI disclosure

Codex authored the test and documentation changes, coordinated the backend comparison, and reviewed the storage interpretation with a second agent. Measurements and checks are reproducible from the documented npm command.

Base automatically changed from feat/grasp-promotion to main September 4, 2026 22:42
@FelineStateMachine
FelineStateMachine merged commit 863614a into main Sep 4, 2026
1 check passed
@FelineStateMachine
FelineStateMachine deleted the feat/grasp-storage-inventory branch September 4, 2026 22:42
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