Phase 1: Extract browser-compatible test detection to Common, move resolution to Core

[Copilot]

Consolidating resolver functionality into Common and Core to simplify architecture. Common becomes browser-compatible; resolver will be deprecated.

Changes

Common: Browser-Compatible Test Detection

• New detectTests.ts: Extracted pure parsing logic (parseContent) from resolver
  • No fs/path/os dependencies - works on string content
  • Helpers: parseXmlAttributes, parseObject, replaceNumericVariables
• Browser-compatible crypto: Shimmed randomUUID with Web Crypto API + Node.js fallbacks
• Exports updated: Added detectTests() (temporary: kept files.ts and resolvePaths.ts for backwards compatibility)

// New browser-compatible API
import { detectTests } from 'doc-detective-common';

const tests = await detectTests({
  content: markdownString,
  filePath: 'docs/test.md',
  fileType: { extensions: ['md'], markup: [...] }
});

Core: Test Resolution Logic

• New resolveTests.js: Complete resolution pipeline from resolver
  • resolveDetectedTests, resolveSpec, resolveTest, resolveContext
  • Context/platform/browser matrix resolution
  • OpenAPI document fetching
• Exports: Added resolveTests() to public API

Status

✅ Common: 441/441 tests passing
⚠️ Still depends on resolver (breaking change deferred to Phase 2)

Next Steps

1. Port file I/O layer (qualifyFiles, parseTests) to Core
2. Remove files.ts/resolvePaths.ts from Common exports
3. Update Core to stop importing from resolver
4. Update VSCode extension to use new APIs

Original prompt

We're going to make substantial updates to the common, resolver, and core libraries. Overall goal: Achieve a simpler architecture to ease development and contributions.

Method: Consolidate down to two primary repos:
Common (doc-detective/common): Browser-compatible library for most intrinsic primitives
Doc Detective (doc-detective/doc-detective): Everything else, including CLI, runner, etc.

As part of this process, multiple some repos will be turned down:

• Resolver

Phase 1
Goal: Achieve a browser-compatible Common library.

Tasks:

• Common moves all browser-incompatible functionality (like node imports) into Core and CLI
• Common pulls in test detection logic in from Resolver
• Core pulls test resolution logic in from Resolver
• Common exposes three exports total
  • schemas object
  • validate() function
  • detectTests() function
• Core exposes current exports plus
  • resolveTests() function
• Update VSCode extension to use new Common exports

The user has attached the following file paths as relevant context:

• .github\copilot-instructions.md

Created from VS Code.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.