chore: address Copilot review round 2 on #2200

- clients/web/tsconfig.{app,node,test}.json: repoint the pino, hono,
  hono/streaming, @hono/node-server, atomically, chokidar and @napi-rs/keyring
  path mappings from ./node_modules to ../../node_modules. The stale mappings
  were not failing the build — an unresolvable paths entry falls back to
  ordinary walk-up resolution, which finds the root copy — but chokidar is the
  case where the fallback never runs: Vite's transitive copy still sits under
  clients/web, so tsc was type-checking against the client's copy while Vitest
  and the shipped bundle both resolved the root's. Same version today, silent
  skew tomorrow. Both path prefixes now carry a comment saying which ownership
  each one asserts.
- local-dev skill: the consolidation rationale no longer groups commander, open
  and @hono/node-server (client-imported) with the core/ set, no longer claims
  #2195 moved undici (it was already root-only), and no longer implies every
  root-declared package has an alias.

npm run local:gate passes with clients/web/node_modules/.tmp cleared, so the
tsc results are from a cold build rather than an incremental cache.

Signed-off-by: cliffhall <cliff@futurescale.com>
This commit is contained in:
cliffhall 2026-08-31 20:11:21 -04:00
commit 2a64c6716b
4 changed files with 58 additions and 26 deletions

View file

@ -98,11 +98,23 @@ transitive v1 `@modelcontextprotocol/sdk` (1.29.0 / 1.30.0) in the tree at once
`server.deps.inline` workaround in `vitest.shared.mts` exists for.
The same reasoning extends to anything reached only through root-owned code that
has no manifest of its own (`test-servers/src`, `core/`) — hence the repo-root
alias for those in `vitest.shared.mts`. That used to be `express` and `yaml`
alone; #2195 made it the general case, moving `ajv`, `atomically`, `chokidar`,
`commander`, `hono`, `@hono/node-server`, `@napi-rs/keyring`, `open`, `pino`,
`react`, `undici` and `zod` to the root as well.
has no manifest of its own (`test-servers/src`, `core/`). #2195 made that the
general case: `ajv`, `atomically`, `chokidar`, `hono`, `@napi-rs/keyring`,
`pino`, `react` and `zod` moved to the root, joining `proper-lockfile` and
`undici`, which were already there.
Keep two distinctions straight, because AGENTS.md's rules split on them:
- **Root-declared is not the same as `core/`-imported.** `commander`, `open` and
`@hono/node-server` are root `dependencies` too, but they are reached only
from client code. Only the `core/` set has to appear in *all three* bundler
`external` lists.
- **Root-declared is not the same as aliased.** The `vitest.shared.mts` pins and
the `clients/web/tsconfig.*.json` `paths` cover the packages whose resolution
is genuinely ambiguous — a transitive copy sits in the client install, or the
importer is `core/`, which has no manifest to resolve from. A package that
resolves unambiguously by walk-up (`ajv`, `commander`, `open`, `undici`,
`zod`) is deliberately absent from both.
The point of deleting the client-side copies rather than merely keeping them in
step is that **a package installs only into an install root that declares it**.

View file

@ -30,6 +30,16 @@
* imports type-check; Vite's `dedupe` handles the runtime resolution —
* see vite.config.ts.
*
* Two prefixes, and the difference is ownership rather than style. A
* `./node_modules/...` mapping names a package this client declares — the
* `@types/*` packages, `vitest`, `yaml`. A `../../node_modules/...` one
* names a package declared only in the root manifest (#2195), which is
* every runtime dependency `core/` imports. Those must be spelled out:
* `chokidar` in particular is still present under `clients/web` as a
* transitive copy of Vite's, so a `./node_modules` mapping resolves the
* client's copy at compile time while Vitest and the shipped bundle both
* resolve the root's. Same version today, and a silent skew tomorrow.
*
* Paths are relative to this config file (no `baseUrl` — deprecated in
* TypeScript 6 / removed in 7).
*/
@ -38,15 +48,15 @@
"react": ["./node_modules/@types/react"],
"react-dom": ["./node_modules/@types/react-dom"],
"react/jsx-runtime": ["./node_modules/@types/react/jsx-runtime"],
"pino": ["./node_modules/pino"],
"hono": ["./node_modules/hono"],
"pino": ["../../node_modules/pino"],
"hono": ["../../node_modules/hono"],
"hono/streaming": [
"./node_modules/hono/dist/types/helper/streaming/index"
"../../node_modules/hono/dist/types/helper/streaming/index"
],
"@hono/node-server": ["./node_modules/@hono/node-server"],
"atomically": ["./node_modules/atomically"],
"chokidar": ["./node_modules/chokidar"],
"@napi-rs/keyring": ["./node_modules/@napi-rs/keyring"],
"@hono/node-server": ["../../node_modules/@hono/node-server"],
"atomically": ["../../node_modules/atomically"],
"chokidar": ["../../node_modules/chokidar"],
"@napi-rs/keyring": ["../../node_modules/@napi-rs/keyring"],
"react-syntax-highlighter/dist/esm/prism-light": [
"./src/types/react-syntax-highlighter-prism-light"
],

View file

@ -32,20 +32,30 @@
* tsc follows those transitive imports while type-checking vite.config.ts,
* so this tsconfig needs the same alias tsconfig.app.json has.
*
* Two prefixes, and the difference is ownership rather than style. A
* `./node_modules/...` mapping names a package this client declares — the
* `@types/*` packages, `vitest`, `yaml`. A `../../node_modules/...` one
* names a package declared only in the root manifest (#2195), which is
* every runtime dependency `core/` imports. Those must be spelled out:
* `chokidar` in particular is still present under `clients/web` as a
* transitive copy of Vite's, so a `./node_modules` mapping resolves the
* client's copy at compile time while Vitest and the shipped bundle both
* resolve the root's. Same version today, and a silent skew tomorrow.
*
* Paths are relative to this config file (no `baseUrl` — deprecated in
* TypeScript 6 / removed in 7).
*/
"paths": {
"@inspector/core/*": ["../../core/*"],
"pino": ["./node_modules/pino"],
"hono": ["./node_modules/hono"],
"pino": ["../../node_modules/pino"],
"hono": ["../../node_modules/hono"],
"hono/streaming": [
"./node_modules/hono/dist/types/helper/streaming/index"
"../../node_modules/hono/dist/types/helper/streaming/index"
],
"@hono/node-server": ["./node_modules/@hono/node-server"],
"atomically": ["./node_modules/atomically"],
"chokidar": ["./node_modules/chokidar"],
"@napi-rs/keyring": ["./node_modules/@napi-rs/keyring"]
"@hono/node-server": ["../../node_modules/@hono/node-server"],
"atomically": ["../../node_modules/atomically"],
"chokidar": ["../../node_modules/chokidar"],
"@napi-rs/keyring": ["../../node_modules/@napi-rs/keyring"]
}
},
"include": ["vite.config.ts", "tsup.runner.config.ts", "server/**/*.ts"]

View file

@ -10,17 +10,17 @@
"react-dom": ["./node_modules/@types/react-dom"],
"react/jsx-runtime": ["./node_modules/@types/react/jsx-runtime"],
"vitest": ["./node_modules/vitest"],
"pino": ["./node_modules/pino"],
"hono": ["./node_modules/hono"],
"pino": ["../../node_modules/pino"],
"hono": ["../../node_modules/hono"],
"hono/streaming": [
"./node_modules/hono/dist/types/helper/streaming/index"
"../../node_modules/hono/dist/types/helper/streaming/index"
],
"@hono/node-server": ["./node_modules/@hono/node-server"],
"atomically": ["./node_modules/atomically"],
"chokidar": ["./node_modules/chokidar"],
"@hono/node-server": ["../../node_modules/@hono/node-server"],
"atomically": ["../../node_modules/atomically"],
"chokidar": ["../../node_modules/chokidar"],
"express": ["./node_modules/@types/express"],
"yaml": ["./node_modules/yaml"],
"@napi-rs/keyring": ["./node_modules/@napi-rs/keyring"],
"@napi-rs/keyring": ["../../node_modules/@napi-rs/keyring"],
"react-syntax-highlighter/dist/esm/prism-light": [
"./src/types/react-syntax-highlighter-prism-light"
],