Skip to content

[codex] Add bounded manual Inventory block groups - #15

Draft
SadPossum wants to merge 1 commit into
devfrom
codex/inventory-block-group-convergence
Draft

[codex] Add bounded manual Inventory block groups#15
SadPossum wants to merge 1 commit into
devfrom
codex/inventory-block-group-convergence

Conversation

@SadPossum

@SadPossum SadPossum commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • promote manual block groups to first-class, versioned Inventory aggregates with property-safe membership
  • add bounded preview/confirmation with a hard 500-member atomic limit and truthful 501+ refusal
  • add atomic immutable-definition replacement, partial/full release, exact replay and lost-response recovery
  • add property-local date handling, selection epochs, repeatable-read previews and contention-safe retry mapping
  • expose bounded group/member reads and mutation recovery across Public API, Admin API and actual Admin CLI execution
  • add least-privilege permission/role metadata, actor evidence, no-store behavior, tenant export/destruction and privacy catalogue coverage
  • add a single PostgreSQL convergence migration with legacy backfill, provider integrity triggers, upgrade locks and downgrade refusal

Scale and operations

The synchronous path never silently activates a broad target in batches. A target of 500 members commits parent, children, availability fences, receipt and outbox facts in one transaction; 501 returns TooLarge without effects. Group and member history use opaque keyset cursors. Replacement creates a linked successor atomically, so sellable capacity is not exposed between release and recreate.

This is intentionally an Inventory-owned product protocol. GMA receives only the generic rollback-reset hygiene required to clear a scoped EF unit of work after transactional failure.

Verification

Definitive final-candidate evidence at 7eeed9c60479e6dacf74f5bd1160462b28a3f18a:

  • warning-as-error solution build: 0 warnings / 0 errors
  • full non-Docker solution: 5,266/5,266 across 42 TRX files
  • migration drift: 21/21 contexts clean
  • solution sync, source-package, repository security/release and diff gates: green
  • Inventory unit suite: 239/239
  • real PostgreSQL migration/protocol matrix: 13/13
  • real PostgreSQL concurrency, replacement, authorization, Admin API and real Admin CLI matrix: 7/7
  • EF pending-model check: clean
  • independent final audit: P0=0, P1=0, P2=0
  • candidate clean and 1 ahead / 0 behind frozen origin/dev

Dependencies and known external gates

No migration, deployment, or production rollout has been performed.

Introduce first-class, previewable, confirmable and recoverable block groups with atomic replacement, property-safe membership, bounded fan-out and complete API/Admin/CLI, privacy and tenant-lifecycle support.\n\nDepends on GMA Framework PR #24 for scoped rollback reset.
@SadPossum
SadPossum force-pushed the codex/inventory-block-group-convergence branch from 8990ddb to 7eeed9c Compare August 13, 2026 17:59
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