feat(config): auto-detect doc-kit.config.mjs in the working directory

[AysajanE]

Problem

doc-kit generate only loads configuration when --config-file is passed explicitly — loadConfigFile returns {} otherwise. As raised in #897, most config-driven tools also detect a conventional config file automatically, so a valid doc-kit.config.mjs sitting in the project root is silently ignored today. That is an easy footgun for anyone who assumes the file is picked up.

Change

• In createRunConfiguration, when no --config-file is provided, auto-detect a doc-kit.config.mjs in the current working directory and load it through the existing loader. An explicit --config-file still takes precedence, and when no file is present the configuration falls back to empty — unchanged behavior. No new dependency; a tight happy path, as the issue suggests.
• Add unit tests covering auto-detection, explicit-path precedence, and the no-file fallback.

Checks (Node 22)

• node --test --experimental-test-module-mocks src/utils/configuration/__tests__/index.test.mjs — 17 passing, including the new cases.

Fixes #897

---

Disclosure: this change was prepared with AI assistance and reviewed by me before submitting.
I ran the check(s) above in a network-isolated container and published a signed, re-runnable
record of that run, verifiable via GitHub artifact attestation:
https://northset-oss.github.io/verification-pilot/. Contributor self-run, not a maintainer verification.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	Jul 12, 2026 10:23pm

[cursor]

PR Summary

Low Risk
Small, localized change to config resolution with clear precedence rules and unit tests; no auth or data-handling impact.

Overview
doc-kit generate now picks up a root doc-kit.config.mjs without --config-file. When no config path is passed, createRunConfiguration checks join(process.cwd(), 'doc-kit.config.mjs') with existsSync and loads it through the existing loadConfigFile path; an explicit --config-file still wins, and missing files keep the prior empty-config behavior.

Tests mock existsSync to cover auto-detection, explicit-path precedence (no existence check), and the no-file fallback. A patch changeset documents the behavior.

^{Reviewed by Cursor Bugbot for commit a0bdd2d. Bugbot is set up for automated code reviews on this repo. Configure here.}

[avivkeller]

What about:
.config.js
.config.cjs
.config.json?

[AugustinMauroy]

their aren't supported by the code.
IMO we should also support ts, cts, mts as types strippable code

[AugustinMauroy]

the logic here is wrong you should do something like this:

resolve configuration file:

  if --config option is provided:
    use the provided file
  else:
    search for a configuration file named:
      doc-kit.config.js
      doc-kit.config.cjs
      doc-kit.config.mjs
      doc-kit.config.ts
      doc-kit.config.cts
      doc-kit.config.mts

    use the first file that exists (following a defined priority)

  pass the resolved path to loadConfigFile()

[AysajanE]

Thanks — understood. I will replace the single .mjs probe with explicit --config-file precedence followed by discovery across the six names you listed, and add coverage for every extension plus the multiple-files case. Before I update the branch, should the order in your example (.js, .cjs, .mjs, .ts, .cts, .mts) also be the precedence when more than one exists? I will leave .json out unless you want it included.

[AugustinMauroy]

adding blocker since feature isn't correctly covered.

thanks @AysajanE for you effort here