[iancooper]

Summary

Spec 018 phase 5, S3: Darker, and Understanding Brighter (ten pages). This changes the published site, so it needs your sign-off.

• The ten pages now hold 144 C# blocks: 114 BUILT, 19 FAILED, 11 SKIPPED. At the start, 8 were BUILT. Three fences were split; five lists of query names were retagged text. The 19 that stay FAILED are all same-page (they name types that another block on their page declares) and each is listed. Seven scaffold units are new.
• API defects repaired (ledger 52–59):
  • A V9 handler factory shown as current.
  • Dead-letter parameters on Subscription<T> (only RmqSubscription takes them).
  • ConfigurationCommandType.StopChannel (it's CM_STOPCHANNEL, sent with Post).
  • IQueryHandler implemented with two of its five members.
  • Swashbuckle in a Darker setup.
  • The message pump's private calls misquoted.
• D21, your R8 ruling: a fourth skip reason, "a line quoted from Brighter's source, calling a private member or reading the pump's own state". It's allowed only where the block cites the file and line it quotes, and that line matches the tag. HowServiceActivatorWorks.md sphinx-ify "Usage Documentation" #1–Adds documentation for Feature Switches. Fix for #272 and fix for other non-raised issue. #6 carry it; all eight cited lines match 10.8.0.
• Running the blocks overturned five claims (ledger 60–64), each repaired:
  • 60: QueryPipeline.md said a [FallbackPolicy] handler without FallbackAsync fails. It returns null, with no exception.
  • 61: pitfall 3's ✅ Good block failed at startup. AddPolicies requires Darker's two default policies, and the registry held only the custom one.
  • 62: HowServiceActivatorWorks.md said the Command Processor takes its options from AddBrighter. With AddConsumers alone, AddConsumers' options configure both. With AddBrighter first, handlers must be registered on AddBrighter's builder: registered on AddConsumers' builder, they are never found. No page shows that shape.
  • 63: ImplementAQueryHandler.md's manual registration used Activator.CreateInstance on a handler that takes a repository, which throws MissingMethodException.
  • 64: a domain exception named UnauthorizedAccessException hid the BCL's.
• Probes: spec/018-compile_residual/probe/s3/darker-pipeline (Darker 4.1.1, 22 rows) and probe/s3/dispatcher-instrumentation (Brighter 10.8.0, 4 cases). Each runs against the released packages, with its case and its control (tasks.md § Behaviour (5.4), Second pass (5.5)).

Gates

Gate	Result
blockcheck --report	992 blocks: 642 BUILT, 323 FAILED, 27 SKIPPED — 0 findings, exit 0. 553 assemblies on each pin, 67 units, 0 violations
pagelint	0 errors / 271 warnings (was 346); --changed strict, 0 errors; --plant 5 / 5
symbolcheck	0 — 24 entries, 14 silenced
linkcheck · shape · redirects · --verify · versioncheck · optioncheck	unmoved: 168 / 0 · 161 · 77 · 161 = 161 · 0 of 18 · 0 / 59 / 529

pagelint, units and assemblies are inside the bands task 5.1 predicted. Corpus, BUILT, FAILED and SKIPPED are outside them, and one account covers all four: five unpredicted retags, 19 same-page stays rather than 3–8, and ten new skips rather than 0–3, six of them under D21. Making fragments whole on one running example per page moved blocks from page-type to same-page (tasks.md § Phase 5 closed).

For you

1. Sign-off: this changes the published site, on S3's ten pages: CQRSWithBrighterAndDarker.md, DarkerBasicConfiguration.md, EFCoreQueryIntegration.md, HowConfiguringTheCommandProcessorWorks.md, HowServiceActivatorWorks.md, ImplementAQueryHandler.md, QueriesAndQueryObjects.md, QueryPatterns.md, QueryPipeline.md and ReactorAndProactor.md. No page outside S3 changed.

   May I merge?

2. After the merge, may I delete the head ref spec/018-phase5?

🤖 Generated with Claude Code

https://claude.ai/code/session_01LjnH2pJ98aMabu1MyTpRxy