Skip to content

Tidy comments in BoxProvisioning.PostgreSql (slice 3) - #4592

Merged
iancooper merged 5 commits into
masterfrom
tidy-comments-postgresql
Oct 12, 2026
Merged

iancooper merged 5 commits into
masterfrom
tidy-comments-postgresql

Conversation

@iancooper

Copy link
Copy Markdown
Member

Slice 3 of the comment tidy over PR #4039's merge (/refactor:tidy-comments 83e0e5e47^1..83e0e5e47 src/Paramore.Brighter.BoxProvisioning.PostgreSql), applying the decisions from slices 1 and 2 (#4590, #4591). Structural only — no behaviour or public/protected signature changes.

Commits

  1. docs: records rationale that lived only in comments
    • ADR 0057 §3 race table: the PostgreSQL history-table CREATE runs inside a savepoint, because Postgres aborts the transaction on the duplicate error even when it is caught (25P02).
    • ADR 0060 errata: the D5 seed runs on every PerSchema provision (the table-level gate made the second box type to flip skip its seed), and a legacy-history read failure throws ConfigurationException, filtered to permission-denied codes only. Applies to MSSQL and PostgreSQL.
  2. refactor: tidy comments — removes narration, history and PR/spec/reviewer references; trims long XML remarks; converts /// on private members to //; LockResourceFor gets <inheritdoc/> + <remarks>; fixes <param> docs that cited a non-existent "ADR 0057 §A.1".
  3. refactor: extract methods — HistoryTableExistsAsync (detection helper); ValidatedHistorySchema (removes a duplicated resolve-and-validate) and CreateHistoryTableAsync (runner); ReleaseLockAfterFailedBeginAsync and LogLockNotHeld (unit of work, removes a duplicated warning); the "42501" literal becomes PostgresErrorCodes.InsufficientPrivilege.

Verification

  • dotnet build of the project: 0 warnings, 0 errors.
  • Paramore.Brighter.BoxProvisioning.Tests: 111/111 passed (unedited).
  • Paramore.Brighter.PostgresSQL.Tests --filter FullyQualifiedName~BoxProvisioning against a Postgres container: 88/88 passed (unedited).

🤖 Generated with Claude Code

https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7

iancooper and others added 3 commits October 12, 2026 14:17
… rationale in ADRs 0057 and 0060

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7
@iancooper
iancooper merged commit 53a238e into master Oct 12, 2026
32 of 33 checks passed
@iancooper
iancooper deleted the tidy-comments-postgresql branch October 12, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant