Skip to content

docs: Update contributor docs for core bundling in v4.0.0#153

Open
promptless[bot] wants to merge 2 commits intomainfrom
promptless/core-bundling-docs
Open

docs: Update contributor docs for core bundling in v4.0.0#153
promptless[bot] wants to merge 2 commits intomainfrom
promptless/core-bundling-docs

Conversation

@promptless
Copy link
Contributor

@promptless promptless bot commented Feb 12, 2026

Open this suggestion in Promptless to view citations and reasoning process

Updates the contributor repository documentation to reflect the v4.0.0 architectural change where doc-detective-core is now bundled directly into the main doc-detective package. The doc-detective.md page now notes the bundled core and TypeScript/ESM codebase, while doc-detective-core.md includes a deprecation notice explaining the package is no longer published separately.

Trigger Events

doc-detective/doc-detective PR #170: Bundle `core`, refactor to be ESM in Typescript

Promptless Research (1 GitHub PR)

Agent Response

I've completed my review of PR #170 and created a documentation suggestion.

Summary

PR #170 introduces a significant architectural change in v4.0.0 where doc-detective-core is now bundled directly into the main doc-detective package, along with a migration to ESM and TypeScript.

Documentation Changes

I created a suggestion that updates the contributor repository documentation:

Files updated:

  1. docs/contribute/repos/doc-detective.md - Updated to note that:

    • Core testing logic is now bundled directly (as of v4.0.0)
    • The codebase is written in TypeScript with ESM/CJS support
    • Removed the old dependency reference to doc-detective-core
  2. docs/contribute/repos/doc-detective-core.md - Added a deprecation notice explaining that core functionality is now bundled into the main package and is no longer published as a separate NPM package.

What I Did Not Change

  • Installation docs - The user-facing installation commands (npm i -g doc-detective, npx doc-detective) remain unchanged, so no updates were needed there.
  • End-user documentation - The usage patterns from an end-user perspective haven't changed, so no other doc updates were required.

The suggestion is ready for your review when the PR is ready to merge.


Tip: See how your feedback shapes Promptless in Agent Knowledge Base 🧠

This repo depends on
- [`doc-detective-core`](doc-detective-core) for the primary testing logic.
- [`doc-detective-common`](doc-detective-common) for JSON schema definitions, schema validation logic, and path resolution logic. No newline at end of file
As of v4.0.0, `doc-detective` bundles the core testing logic directly (previously provided by the separate `doc-detective-core` package). The codebase is written in TypeScript and supports both ESM and CommonJS module systems.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Based on package.json changes showing version bump to 4.0.0-beta.0, removal of doc-detective-core dependency, addition of "type": "module", and new exports config supporting both ESM and CJS.
View source

:::note

This repo depends on [`doc-detective-common`](doc-detective-common) for JSON schema definitions, schema validation logic, and path resolution logic. No newline at end of file
As of v4.0.0, core functionality is bundled into the main [`doc-detective`](doc-detective) package. `doc-detective-core` is no longer published as a separate NPM package.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Based on package.json removal of doc-detective-core dependency and addition of src/core/ directory containing the bundled core functionality.
View source

@promptless
Copy link
Contributor Author

promptless bot commented Feb 24, 2026

I've added new changes to address this GitHub PR in commit 9e762c8

- [`doc-detective-common`](doc-detective-common) for JSON schema definitions, schema validation logic, and path resolution logic. No newline at end of file
As of v4.0.0, `doc-detective` bundles the core testing logic directly (previously provided by the separate `doc-detective-core` package). The codebase is written in TypeScript and supports both ESM and CommonJS module systems.

This repo depends on [`doc-detective-common`](doc-detective-common) for JSON schema definitions, schema validation logic, and path resolution logic. No newline at end of file
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Removed "path resolution logic" from dependency list because PR #157 removed resolvePaths from public exports in src/index.ts—the function and its source files (src/resolvePaths.js, src/resolvePaths.ts) were deleted.
View source

@promptless promptless bot marked this pull request as ready for review February 24, 2026 19:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants