feat: make doc-kit friendly for newcomers

[avivkeller]

I'm adding:

• serve (Build + Serve + Watch)
• bootstrap (Detect things like package name, docs path, and create a project)
• install (Install a generator package based on it's name, e.g. doc-kit install web)

Hopefully then new consumers can just doc-kit bootstrap && doc-kit serve to get their projects up-and-running. wdyt?

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Error		Aug 4, 2026 3:28am

[cursor]

PR Summary

Medium Risk
New CLI runs package managers and a local HTTP server; config extends changes merge order and defaults, which can alter output for projects that relied on implicit Node.js settings without the preset.

Overview
Adds bootstrap, install, and serve so new projects can set up config, generator packages, and a live-reloading preview without extra tooling. serve includes a static file server (path traversal guards, port fallback) and debounced rebuilds on input changes; install picks the lockfile’s package manager and resolves built-in generators to npm packages.

Configuration now supports extends presets (merged under the config file; later presets win). Built-in defaults are project-neutral (project from package.json, empty changelog, optional repository/baseURL). Node.js branding and nodejs.org URL layouts move to @node-core/doc-kit/config, which beta/e2e configs and docs reference.

The html generator defaults to generic titles, {baseURL}{path}.html, and a plain ProjectName logo; GitHub nav and “Edit this page” only appear when repository and editURL are set. llms-txt / sitemap templates and defaults are similarly generic. CI/e2e/Playwright use the Node preset config and doc-kit serve --static instead of npx serve.

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

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 4623686. Configure here.}

[cursor]

Force writes ignored config file

Medium Severity

--force always writes doc-kit.config.mjs instead of replacing the file findExistingConfig found. Cosmiconfig prefers .doc-kitrc* and doc-kit.config.js over .mjs, so the new file can be ignored and the old config keeps winning.

Additional Locations (2)

• packages/core/bin/commands/bootstrap.mjs#L73-L81
• packages/core/src/utils/bootstrap.mjs#L14-L64

 

^{Reviewed by Cursor Bugbot for commit 4623686. Configure here.}

[btea]

It appears that this part of the modification is redundant with #984.