Skip to content

test(arch): namespace cycle-freedom guard + baseline of the two live cycles (gh-#445) - #446

Merged
genwave-radio merged 2 commits into
mainfrom
test/gh-445-namespace-cycle-guard
Aug 9, 2026
Merged

test(arch): namespace cycle-freedom guard + baseline of the two live cycles (gh-#445)#446
genwave-radio merged 2 commits into
mainfrom
test/gh-445-namespace-cycle-guard

Conversation

@genwave-radio

Copy link
Copy Markdown
Collaborator

Dean's question — is cyclic-dependency coverage part of the arch rules? — answered: it wasn't, and the new guard immediately found two live cycles (details + fix sketches on #445).

What ships

  • Gh445_NamespaceCycleFreedom: ArchUnitNET slice rule per project (first namespace segment below the root), BeFreeOfCycles, evaluated via the suite's hand-rolled-assert house pattern (core package only — no new dependency).
  • Baseline, shrink-to-fit: Core Events -> Abstractions and Host Api -> Stats are named/dated rows; a NEW cycle anywhere fails with the full cycle text, and fixing a baselined cycle also fails — with a 🎉 — until its row is deleted. Debt can only shrink.
  • Deliberately not an L7 LawId: law adoption = CONTRIBUTING law-table row + parity updates = a /design ruling, recorded on arch: two namespace cycles found by the new cycle-freedom guard — Core Events↔Abstractions, Host Api↔Stats #445 for when the slate is clean.

Verification

Architecture suite 95/95 green (was 87; +8 theories). Pre-baseline the rule failed exactly 2/8 projects with the two real cycles — that red run is what populated the baseline.

…ycles (gh-#445)

Slices every project by first namespace segment, requires cycle freedom.
Two pre-existing tangles (Core Events<->Abstractions, Host Api<->Stats)
ship as a named, dated, shrink-to-fit baseline: a fixed cycle turns its
row stale-red until deleted. Deliberately not a LawId — promotion to L7
(CONTRIBUTING row + parity) is gh-#445's recorded /design step.
@genwave-radio
genwave-radio merged commit 0fa4b4b into main Aug 9, 2026
11 checks passed
@genwave-radio
genwave-radio deleted the test/gh-445-namespace-cycle-guard branch August 9, 2026 21:28
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 9, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant