Skip to content

grasp: owners inspect retained Git storage under shared admission - #20

Merged
FelineStateMachine merged 9 commits into
mainfrom
feat/grasp-inventory-admission
Sep 4, 2026
Merged

FelineStateMachine merged 9 commits into
mainfrom
feat/grasp-inventory-admission

Conversation

@FelineStateMachine

@FelineStateMachine FelineStateMachine commented Sep 4, 2026 •

Copy link
Copy Markdown
Owner

Motivation

Quota reservations alone cannot explain how much Git storage belongs to the current root versus retained metadata. The coordination proof in #19 also showed that an alarm could await Git storage while an unrelated event changed repository authority.

Change

  • Git requests, controls, events, alarms, lease/adoption and teardown share one live admission owner. Nested work retains its owner; unrelated mutations receive a retry response. Management refusals are JSON. Body parsing and signature verification precede ownership, so a slow unauthenticated body does not hold admission.
  • The owner-only gitstorage(repositoryOwnerHex, identifier) method reports physical, current-root, unreferenced and unknown objects by class, alongside reservations and operation counts. It accepts no arbitrary prefix or caller-supplied limits.
  • The immutable ntig 0.3.0 package and source are preserved with checksums. The scan supports both repository formats, permits only GET/list, caps reads at 16 MiB and 10,000 GETs, and returns no partial report on failure. A 60-second instance cooldown resets on eviction/restart.
  • Documentation, README and landing copy describe the feature, its limits and Tangled's filesystem Git architecture as prior art. Connect includes GitWorkshop with Open and Copy relay URL actions only while Git hosting is available.

The 260-transaction fixtures reproduce the earlier physical/current totals: 2,147,926/144,084 bytes for growing refs and 512,431/136,809 for fixed refs. Each scan uses 349 GETs and one LIST, about $0.00013 in R2 request units before allowances/rounding, excluding execution and SQL. Counts are diagnostics, not billing meters. There is no new billing rate or separate inventory fee; existing activity and storage accounting still applies. No storage reclamation, root migration, collection or deployment occurs. Retained bytes remain on the existing storage meter; format-1 transaction limits remain unchanged.

The admission owner is local to a live instance. It does not establish crash recovery or collection safety across R2 clients.

Testing Completed

  • Full host suite: 212 tests passed.
  • Stock Git conformance passed with GRASP explicitly enabled: clone, accepted-state push, incremental fetch and partial clone.
  • Format-1/2 owner authorization, read-only scans, cooldown, limit/provider failures, paused-read admission and incomplete management-body tests passed. GitWorkshop visibility passed disabled/enabled/disabled smoke checks.
  • The initial CI exposed a recovery-fixture alarm race; injected failure and retry now share a single fixture owner with the original assertions intact.
  • The runtime report matches the independent 260-transaction inventory fixtures; their focused suite passed after adding the comparison.
  • Typecheck and generated-file checks passed for every logical commit. Final documentation and exposure review completed.
  • Independent source rebuild on Node 26/npm 11 matches the supplied package's decompressed tar exactly. Backend validation reports 184 passing tests and its type/build/package checks.

Responsible AI disclosure

Implementation, tests, documentation and review were assisted by Codex, including parallel code and cost reviews.

@FelineStateMachine
FelineStateMachine force-pushed the feat/grasp-inventory-admission branch from 2e07936 to 379866f Compare September 4, 2026 23:13
Base automatically changed from feat/grasp-coordination-proof to main September 4, 2026 23:21
@FelineStateMachine
FelineStateMachine merged commit 2cce794 into main Sep 4, 2026
1 check passed
@FelineStateMachine
FelineStateMachine deleted the feat/grasp-inventory-admission branch September 4, 2026 23:21
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