fix(context): skip test/example-style directories only at the repo root

[JayOfTheKeyboard]

The problem

Same shape as #125, one level up. IGNORED_DIRS in packages/context/src/git.ts is matched at every depth whatever the scan root. In a whole-repo scan that is the point: test/, examples/ and internal/ hold code, fixtures and notes. Inside a docs_path folder the same names are ordinary sections, and 135 of the 140 definitions set docs_path.

As with #125, the build reports success, so the only symptom is a query that comes back empty.

Measured

Every git definition in registry/, checked against its repository's tree with the GitHub trees API (default branch, so versioned definitions are approximate). Documentation files under docs_path that sit inside a directory in IGNORED_DIRS:

definition	dropped	what it is
docker	100 under build/, 10 dev/, 7 plans/, 6 examples/	content/manuals/build/ is the whole Docker Build manual (Bake, BuildKit, builders, cache, CI, exporters)
antd	84 under spec/	the design specification pages (half are zh-CN)
wrangler	49 under examples/	the Workers examples section
kysely	40 under examples/	40 of the 67 pages in site/docs
bun	32 under test/	docs/guides/test/, the test-runner guides
vue	1 under examples/ (+27 code fragments, see below)	src/examples/index.md
expo	10 build/, 6 examples/, 1 internal/	EAS Build docs and workflow examples
formik	11 under examples/
pydantic	8 under examples/
prisma	5 under dev/	prisma dev CLI reference
better-auth	5 under examples/
vitest	2, payload 1, valibot 1, elysia 1

Confirmed on real clones by building readLocalDocsFiles before and after: kysely 27 → 67 files, bun 303 → 335, matching the tree count exactly.

Whole-repo scans are unchanged. jsdom (319 files under test/), sql.js, turndown and ioredis keep dropping what they drop today, which is the case the rule was written for.

The change

IGNORED_DIRS is split in two:

• Always skipped, wherever the scan starts: tooling and generated output that never holds authored docs. node_modules, dist, out, .next, .nuxt, fixtures, __tests__, __test__, __fixtures__, __mocks__.
• Skipped only when atRepoRoot (the flag from fix(context): only skip repo-meta filenames at the scan root #125): names that are also ordinary section names. test, tests, spec, specs, internal, dev, plans, .plans, build, examples, benchmarks, benchmark.

fixtures stays in the always set on evidence: remix has docs/shared/prerender/bench/fixtures/*.html, which really are fixtures. build moves to the root-only set on evidence: docker's build/ is the biggest single loss.

One registry edit comes with it. vue's src/examples/src/ holds 27 playground code fragments (App/template.html and the like) that the directory rule had been hiding by accident. registry/npm/vue.yaml now sets exclude_paths: ["examples/src/**"], so they stay out and examples/index.md comes in.

Tests

Three, written before the change and each mutation-checked:

• skips test and example directories when scanning a repo root: fails if the root-only set is disabled.
• keeps doc sections named like non-doc directories inside a docs folder: fails if the atRepoRoot guard is removed (this is the one that was red on main).
• still skips tooling directories inside a docs folder: fails if the always set is disabled.

230/230 in context, 93/93 in registry, tsc clean, biome ci --error-on-warnings clean in the package.

Worth knowing

• expo gains one page that is arguably a test page: docs/pages/internal/test-markdown-pipeline.mdx. I left the definition alone; one exclude_paths line if you'd rather not have it.
• Packages will grow on the next rebuild for the definitions above. docker's is the big one.
• This doesn't cover a whole-repo scan where examples/ really is documentation, like a corpus assembled by hand. That is a judgement call about code repos in general, and docs_path is the right lever there, so I haven't touched it.

[changeset-bot]

🦋 Changeset detected

Latest commit: 2d50434

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@neuledge/context	Patch
@neuledge/registry	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[moshest]

Thanks, the fix itself checks out. I reviewed 03cc697 merged onto current main (which now includes #126). Lint, build and tests pass (context 230, registry 103). Removing the atRepoRoot guard turns your docs-folder test red, and forcing the guard to false turns the repo-root test red. Your numbers hold up: kysely goes from 78 to 116 sections and bun from 1172 to 1319. With examples/src/** excluded, vue gains only examples/index.md. The changeset is right.

Two definitions now pull in files that aren't docs, the same problem you handled for vue:

• registry/npm/@angular/core.yaml: at 22.2.0, adev/src/content/examples/ adds 212 files, almost all component .html templates that the guides embed. Please add exclude_paths: ["examples/**"] under its source.
• registry/npm/@docusaurus/core.yaml: at 3.10.2, website/_dogfooding/ adds 66 test pages. Please add exclude_paths: ["_dogfooding/**"].

I screened all 137 git definitions and found nothing else beyond the small gains you already listed. antd's docs/spec pages are real design docs, so keeping them is right. Once those two lines are in, I'll merge.

---

Generated by Claude Code

[JayOfTheKeyboard]

Thanks for screening the whole registry. Added both in 2d50434: exclude_paths: ["examples/**"] for @angular/core and exclude_paths: ["_dogfooding/**"] for @docusaurus/core, each with a one-line comment saying why, as in vue.yaml. Lint, build and tests pass.