You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
What — the public docs integration tests still depend on the repo's REAL on-disk guides in several places; make the whole file consumer-independent (controlled fixtures only).
Why — #4014 fixed the precedence describe block, but the same failure class remains elsewhere in modules/public/tests/public.docs.integration.tests.js. Concrete instance: GET /api/public/docs/:slug.md returns raw markdown for a known slug asserts the framework quickstart's placeholder content (<YOUR_API_KEY>). A consumer shipping its own guide at the quickstart slug now deterministically WINS that slug (by design, #4011) — the test then receives the consumer's markdown and fails, in a test environment that has no docs.excludeModules mitigation. Any assertion pinned to which real guide wins a globally-shared slug is a consumer-dependence bug by construction.
Every test that reads real guide content or counts real guides moves to a controlled fixture set (config.files.guides fully replaced in the relevant describe blocks, restored after — the fix(public): make slug-collision precedence fixture self-contained #4014 pattern), or asserts shape/status only (200, markdown content-type) where content is irrelevant.
The :slug.md raw-markdown test: fixture guide with a unique slug + assert ITS content.
Zero source changes. The suite must pass identically on the bare stack AND in any consumer repo regardless of what guides the consumer ships.
What — the public docs integration tests still depend on the repo's REAL on-disk guides in several places; make the whole file consumer-independent (controlled fixtures only).
Why — #4014 fixed the precedence describe block, but the same failure class remains elsewhere in
modules/public/tests/public.docs.integration.tests.js. Concrete instance:GET /api/public/docs/:slug.md returns raw markdown for a known slugasserts the framework quickstart's placeholder content (<YOUR_API_KEY>). A consumer shipping its own guide at thequickstartslug now deterministically WINS that slug (by design, #4011) — the test then receives the consumer's markdown and fails, in a test environment that has nodocs.excludeModulesmitigation. Any assertion pinned to which real guide wins a globally-shared slug is a consumer-dependence bug by construction.Scope —
modules/public/tests/public.docs.integration.tests.js, whole-file sweep:config.files.guidesfully replaced in the relevant describe blocks, restored after — the fix(public): make slug-collision precedence fixture self-contained #4014 pattern), or asserts shape/status only (200, markdown content-type) where content is irrelevant.:slug.mdraw-markdown test: fixture guide with a unique slug + assert ITS content.Scope: validated 2026-08-04