Skip to content

Tidy comments in MSSQL box-provisioning provisioning and detection tests (slice 14) - #4651

Open
iancooper wants to merge 4 commits into
masterfrom
tidy-comments-tests-mssql-provisioning
Open

iancooper wants to merge 4 commits into
masterfrom
tidy-comments-tests-mssql-provisioning

Conversation

@iancooper

Copy link
Copy Markdown
Member

Slice 14 of the comment tidy over PR #4039's merge (/refactor:tidy-comments 83e0e5e47^1..83e0e5e47): the provisioning and detection half of tests/Paramore.Brighter.MSSQL.Tests/BoxProvisioning, which includes Drift/, Legacy/ and TestDoubles/. That is the 35 files the merge added, six of them under the names spec 0031 later gave them. Files added after the merge are out of scope.

Commits

  • docs:
    • ADR 0057 §3 now records three points:
      • the fresh-install DDL, the ALTERs and detection all target [{schema}].[{table}];
      • operators create the box schema; the runner does not;
      • MSSQL's history-table existence check filters on schema_id.
    • ADR 0057 §3 also corrects where chain contiguity is enforced: at MigrateAsync entry, not at runner construction.
    • ADR 0058 §A.3 says why validators substitute the default schema for a null.
  • refactor: tidy comments changes comment lines only:
    • Class narratives become short summaries that cite ADR sections, and AAA markers lose their prose.
    • Comments between assertions, stale version notes, and spec/PR/Item/Phase/reviewer references are removed.
    • The XML docs on internal Drift, Legacy and TestDoubles helpers become // lines.
    • Legacy seeder provenance SHAs are kept.
    • Wrong "ADR 0057 §A.1" references now point at ADR 0058 §A.1.
  • refactor: extract methods to express intent:
    • Comment-labelled blocks in the inbox provisioner tests become private helpers.
    • The mid-chain test's commented column literals become constants.
    • The non-monotonic test's commented index list becomes a named static.
    • The vk test's hard-coded 8 becomes ExpectedMigrationVersions.OutboxLatest.

No behaviour changes; tests are otherwise unedited.

Verification

  • Paramore.Brighter.MSSQL.Tests --filter BoxProvisioning (net10.0): 94/94 before editing, after each pass, and after merging master.
  • Paramore.Brighter.BoxProvisioning.Tests: 119/119 on net9.0 and net10.0.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7

iancooper and others added 4 commits October 25, 2026 12:54
…alidator null substitution

ADR 0057 §3 now says the fresh-install DDL, ALTERs and detection target
[{schema}].[{table}], that operators create the box schema, and why MSSQL's
history-table check filters on schema_id; it also corrects where chain
contiguity is enforced (MigrateAsync entry). ADR 0058 §A.3 says why
validators substitute the default schema for null.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7
…tection tests

Class narratives become short summaries citing ADR 0057 §1-§5a and ADR 0058
§A.1/Guards; AAA markers lose their prose; comments between assertions,
stale version notes and spec/PR/Item/Phase/reviewer references are removed.
XML docs on internal Drift, Legacy and TestDoubles helpers become one or
two // lines; Legacy seeder provenance SHAs are kept. Wrong "ADR 0057 §A.1"
references now point at ADR 0058 §A.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7
… provisioning tests

Comment-labelled arrange and assert blocks in the inbox provisioner tests
become private helpers (CreateTextModeInbox, CreatePreMigrationInboxTable,
GetInboxTableCountInDbo, GetHistoryRowCountAtInboxLatest); the mid-chain
test's commented column literals become V3Column..V7Column constants; the
non-monotonic test's commented index list becomes a named static; the vk
test's hard-coded 8 becomes ExpectedMigrationVersions.OutboxLatest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HsKD52dnGHFLSEr93VZyR7

This branch has not been deployed

No deployments
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