deslop/shadowed-directory

Flag two directories that look like a forked/copied tree (e.g. src/ vs deno/lib/) sharing many duplicated same-named files.

  • Category: Architecture
  • Severity: warn
  • Source: deslop-js
  • Framework: global
  • Enabled when: react-doctor deadCode analysis enabled (default true); whole-project scan only — skipped in --diff/--staged modes
  • Documentation: https://github.com/millionco/deslop-js

Validation prompt

Use this to decide whether a fired diagnostic is real or a false positive.

Fires as a ShadowedDirectoryPair when deslop collapses at least three two-file duplicate-block clusters that all live in the same directory pair (directoryA, directoryB) and have matching file basenames, reporting directoryA, directoryB, the sorted list of sharedFiles, and totalDuplicatedLines — its own doc comment frames this as the directories having drifted (e.g. src/ vs deno/lib/, a fork, or a copy-pasted route tree). False positive: the two trees are deliberately separate platform or runtime variants (ios/ vs android/, web/ vs native/, node/ vs deno/) or pinned versioned snapshots (v1/ vs v2/, a frozen vendored copy) where the overlap is intentional and the trees must evolve independently — suppress there.

Fix prompt

Use this once validation confirms the diagnostic is real.

Reconcile the two trees instead of maintaining parallel copies: keep one directory as the source of truth, hoist the shared same-named files (the reported sharedFiles) into a single shared module, and have the second directory re-export or import from it, deleting the duplicated bodies (totalDuplicatedLines of them) so a change no longer has to be applied in both places. If the trees genuinely must differ, factor only the common core into a shared package and keep just the per-tree deltas. See https://github.com/millionco/deslop-js